Pular al contenido

Versión

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.

ProductoVersión de versión principalNotas de compatibilidad
Capgo pluginsSiga el matching Capacitor mayorVersión mayor del plugin 8 Los objetivos son Capacitor 8, 7 Los objetivos son Capacitor 7, y así sucesivamente
Capgo CLIIndependienteNo sincronice CLI mayor con plugins o Capacitor. Utilice siempre la versión más reciente de CLI
Capgo ConsolaIndependienteCiclo 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.

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. 8 La ú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-updater y (y el actualizador relacionado) mayor.

Se desaconseja pinchar una versión antigua de CLI. Prefiere:

ventana de terminal
npx @capgo/cli@latest bundle upload --channel=production

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.

Copiar a portapapeles
# Latest Capgo updater for Capacitor 7
npm i @capgo/capacitor-updater@lts-v7
# Same pattern for other majors
npm i @capgo/capacitor-updater@lts-v6
npm i @capgo/capacitor-updater@lts-v5
npm i @capgo/capacitor-updater@lts-v4

a pedido Actualizaciones del actualizador vs otros plugins.

PaqueteBackports de versiones anteriores mayores
@capgo/capacitor-updaterBackports 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 CapgoA 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”:

Copiar a portapapeles
npm i @capgo/capacitor-updater@lts-v7 # resolves to the current 7.x LTS, e.g. 7.3.4

Tí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?
  1. Upgrade Capgo plugins when you upgrade Capacitor majors.
  2. Actualiza los __CAPGO_KEEP_0__ plugins cuando actualices los __CAPGO_KEEP_1__ majors. @capgo/cli@latest — CLI major sync with Capacitor/plugins is unnecessary.
  3. — el sincronización de Capacitor mayor con __CAPGO_KEEP_1__/plugins no es necesaria. @lts-v7 Manté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.x Hace meses.
  4. 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.
  • 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