Versión
Copia un prompt de configuración con los pasos de instalación y la guía de markdown completa para este plugin.
Capgo utiliza la versión semántica (semver) para plugins, el CLI, y los productos que enviamos — la misma práctica que recomendamos para sus propios paquetes de aplicaciones.
Esta página explica cómo se relacionan entre sí esas versiones, qué permanece compatible a lo largo de las versiones principales, y cómo pinchar versiones mayores de Capacitor con etiquetas LTS.
Reglas rápidas
Título de la sección “Reglas rápidas”| Producto | Versión de versión principal | Notas de compatibilidad |
|---|---|---|
| Capgo plugins | Siga el matching Capacitor mayor | Versión mayor del plugin 8 Los objetivos son Capacitor 8, 7 Los objetivos son Capacitor 7, y así sucesivamente |
| Capgo CLI | Independiente | No sincronice CLI mayor con plugins o Capacitor. Utilice siempre la versión más reciente de CLI |
| Capgo Consola | Independiente | Ciclo de lanzamiento propio; compatible con versiones del plugin de actualización admitidas |
Los plugins siguen las versiones mayores de Capacitor
Sección titulada “Los plugins siguen las versiones mayores de Capacitor”Cada versión mayor de plugin de Capgo sigue la versión mayor de Capacitor para la que se construyó:
@capgo/capacitor-updater@8→ Capacitor 8@capgo/capacitor-updater@7→ Capacitor 7- y el mismo patrón para otros plugins Capgo
Cuando Capacitor envía un nuevo mayor, Capgo envía un plugin con el mismo mayor. Eso es cuando podemos cambiar opciones predeterminadas si un nuevo valor predeterminado es la mejor elección a largo plazo para esa generación de Capacitor.
estabilidad de API entre versiones
Título de la sección “estabilidad de API entre versiones”Las API de los plugins permanecen estables entre versiones a menos que un cambio se rompa por diseño para todos (por ejemplo, una Capacitor plataforma que fuerza el mismo rompimiento en todos los consumidores). Deberías poder moverte entre los plugins de Capgo como actualizas Capacitor sin tener que reescribir tu integración.
Las opciones predeterminadas pueden cambiar en una nueva versión. Revisa las notas de lanzamiento y los guías de migración (ver actualizador actualiza y las guías bajo Migraciones en el panel lateral del actualizador) cuando subas de versión.
CLI y la Consola utilizan sus propias versiones
Sección titulada “CLI y Consola utilizan sus propias versiones”El Capgo CLI y Capgo Console no comparten versiones principales con complementos o Capgo. No necesita __CAPGO_KEEP_0__ principales porque está en __CAPGO_KEEP_0__ 8 o actualizador. Siempre instale o invoque el Capacitor más reciente.
- La última __CAPGO_KEEP_0__ y Consola permanecen compatibles con cualquier versión soportada. La última __CAPGO_KEEP_0__ y Consola permanecen compatibles con cualquier versión soportada. La última CLI y Consola permanecen compatibles con cualquier versión soportada.
8La última Capacitor y Consola permanecen compatibles con cualquier versión soportada.8. - La última __CAPGO_KEEP_0__ y Consola permanecen compatibles con cualquier versión soportada. La última __CAPGO_KEEP_0__ y Consola permanecen compatibles con cualquier versión soportada. La última CLI y Consola permanecen compatibles con cualquier versión soportada.
- La última CLI y Consola permanecen compatibles con cualquier versión soportada.
@capgo/capacitor-updatery (y el actualizador relacionado) mayor.
Se desaconseja pinchar una versión antigua de CLI. Prefiere:
npx @capgo/cli@latest bundle upload --channel=productionEtiquetas LTS para mayores de plugin anteriores
Cuando se queda en un mayor __CAPGO_KEEP_0__ más antiguo, instale el mayor de plugin __CAPGO_KEEP_1__ que corresponde con una etiqueta de dist-tag LTS en lugar de copiar un archivo de bloqueo obsoleto para siempre.When you stay on an older Capacitor major, install the matching Capgo plugin major with an LTS dist-tag instead of copying an outdated lockfile forever.
# Latest Capgo updater for Capacitor 7npm i @capgo/capacitor-updater@lts-v7
# Same pattern for other majorsnpm i @capgo/capacitor-updater@lts-v6npm i @capgo/capacitor-updater@lts-v5npm i @capgo/capacitor-updater@lts-v4a pedido Actualizaciones del actualizador vs otros plugins.
LTS tags for previous plugin majors
Sección titulada “Updater backports vs otros plugins”| Paquete | Backports de versiones anteriores mayores |
|---|---|
@capgo/capacitor-updater | Backports mensuales reflejados a v7 / v6 / v5 (lts-v7, lts-v6, lts-v5). lts-v4 se mantiene disponible para Capacitor 4 pero no sigue ese calendario mensual |
| Otros plugins Capgo | A demanda |
Las mismas características, números de versión reflejados
Sección titulada “Las mismas características, números de versión reflejados”Las líneas LTS reflejan la versión menor y de parche de la línea más reciente cuando existe un backport.
Si la última versión es 8.3.4, la línea LTS Capacitor 7 se publica como 7.3.4 con la misma función y correcciones de errores , adaptado a ese __CAPGO_KEEP_0__ mayor.Instale con la etiqueta cuando desee “último para este Capacitor mayor”:
Install with the tag when you want “latest for this Capacitor major”:
npm i @capgo/capacitor-updater@lts-v7 # resolves to the current 7.x LTS, e.g. 7.3.4Título de la sección “ELTS es una copia de seguridad de lo último”
Después de que un nuevo plugin mayor se envíe, un(o lts-v7 , …) lanzamiento es una lts-v6copia de seguridad de lo último copia de seguridad de lo último Así, el mismo trabajo se ejecuta en el Capacitor anterior.
Porque sigue a la última, la línea LTS de API pública. puede cambiar cuando cambia la última — incluso si el número mayor permanece en 7. Treat LTS as “current Capgo behavior on an older Capacitor,” not as a frozen legacy API forever.
y no como un legado congelado de __CAPGO_KEEP_2__ para siempre.
¿Qué significa esto para tu aplicación?- Upgrade Capgo plugins when you upgrade Capacitor majors.
- Actualiza los __CAPGO_KEEP_0__ plugins cuando actualices los __CAPGO_KEEP_1__ majors.
@capgo/cli@latest— CLI major sync with Capacitor/plugins is unnecessary. - — el sincronización de Capacitor mayor con __CAPGO_KEEP_1__/plugins no es necesaria.
@lts-v7Mantén __CAPGO_KEEP_0__ 7 (o más antiguo)? Utiliza el __CAPGO_KEEP_0__ más reciente o la etiqueta correspondiente, no una versión antigua aleatoria.7.xHace meses. - Versión de sus propios bundles de actualización en vivo con semver de la misma manera que Capgo versiona sus paquetes. Consulte versión de bundles y canales y objetivos de versión.
Documentación relacionada
Sección titulada “Documentación relacionada”- Agregar una aplicación — comandos de instalación y etiquetas LTS para el actualizador
- CLI overview — cómo ejecutar Capgo CLI comandos
- Compatibilidad nativa — cuando un cambio requiere un binario de almacenamiento vs una paquete OTA
- De V7 a V8 — ejemplo de una actualización de plugin de nivel mayor Capacitor-alineado