Versionado

Capgo utiliza versionado semántico (semver) para plugins, CLI y los productos que lanzamos; la misma práctica que recomendamos para tus propios app bundles.

Esta página explica cómo se relacionan esas versiones, qué se mantiene compatible entre majors y cómo fijar majors antiguos de Capacitor con etiquetas LTS.

Reglas rápidas

Producto	Versionado major	Notas de compatibilidad
Plugins de Capgo	Sigue la versión correspondiente Capacitor mayor	Plugin mayor 8 apunta a Capacitor 8, 7 apunta a Capacitor 7, etc.
Capgo CLI	Independiente	No sincronices CLI mayor con plugins o Capacitor. Usa siempre la última CLI
Console de Capgo	Independiente	Ciclo de release propio; compatible con versiones de plugins de updater soportadas

Usa siempre la última CLI

Ejecuta CLI con @latest (por ejemplo npx @capgo/cli@latest ...). El major de CLI debe necesitas debe coincidir con la versión major de tu plugin o de Capacitor. La última versión de CLI funciona con cualquier versión de plugin updater compatible.

Los plugins siguen las versiones Capacitor majors

Cada major de plugin de Capgo sigue el major de Capacitor para el que fue construido:

• @capgo/capacitor-updater@8 → Capacitor 8
• @capgo/capacitor-updater@7 → Capacitor 7
• y el mismo patrón para otros plugins de Capgo

Cuando Capacitor lanza un nuevo major, Capgo lanza un major de plugin correspondiente. Es entonces cuando podemos cambiar opciones por defecto si un nuevo valor predeterminado es la mejor opción a largo plazo para esa generación de Capacitor.

Estabilidad de API entre versiones major

Las APIs de los plugins se mantienen estables entre versiones mayores, a menos que un cambio sea incompatible por diseño para todos (por ejemplo, un requisito de la plataforma Capacitor que obligue al mismo cambio incompatible en todos los consumidores). Normalmente deberías poder pasar entre versiones mayores de los plugins de Capgo al actualizar Capacitor sin reescribir tu integración.

Los valores predeterminados podrían cambiar en una nueva versión mayor. Revisa las notas de la versión y las guías de migración (ver actualizaciones del updater y las guías en Migrations de la barra lateral del updater) cuando hagas el bump.

CLI y Console usan sus propias versiones

El Capgo CLI y el Capgo Console lo hacen necesitas comparte versiones mayor con plugins o Capacitor.

• No necesitas necesitas CLI mayor 8 porque usas Capacitor 8 o updater 8.
• Instala o invoca siempre el última CLI.
• La última versión de CLI y Console siguen siendo compatibles con cualquier @capgo/capacitor-updater (y updater relacionado) mayor.

No se recomienda fijar una versión antigua de CLI. Prefiere:

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

Tags LTS para versiones major anteriores de plugins

Si te quedas en una versión mayor antigua de Capacitor, instala la versión mayor de Capgo correspondiente con un dist-tag LTS en lugar de copiar un lockfile desactualizado para siempre.

# 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

Fuera del updater, las versiones LTS de versiones mayores de plugins anteriores se publican bajo demanda.

Backports del Updater vs otros plugins

Paquete	Backports de versiones mayores anteriores
@capgo/capacitor-updater	Backports mensuales espejados para v7 / v6 / v5 (lts-v7, lts-v6, lts-v5). lts-v4 sigue disponible para Capacitor 4, pero no sigue ese ritmo mensual
Otros plugins de Capgo	Bajo demanda

Mismas funciones, números de versión espejados

Las líneas LTS espejan el minor y patch de la última línea actual cuando existe un backport.

Si la última versión es 8.3.4, la línea LTS de Capacitor 7 se publica como 7.3.4 con el el mismo conjunto de funciones y correcciones de errores, adaptado a esa versión mayor de Capacitor.

Instala con el tag cuando quieras la “última versión para esta major de Capacitor”:

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

LTS es un backport de la última versión

Tras una nueva major de plugin, un lanzamiento lts-v7 (o lts-v6, …) el release es un backport de latest para que el mismo trabajo se ejecute en la major anterior de Capacitor.

Como sigue el canal latest, el API público de la línea LTS puede cambiar cuando hay cambios recientes — aunque el número mayor se mantenga en 7. Trata LTS como el “comportamiento actual de Capgo en un Capacitor antiguo”, no como un API legacy congelado para siempre.

Qué significa esto para tu app

1. Actualiza los plugins Capgo cuando actualices versiones mayores de Capacitor.
2. Ejecuta siempre @capgo/cli@latest — No es necesaria una sincronización mayor de CLI con Capacitor/plugins.
3. ¿Sigues en Capacitor 7 (o anterior)? Usa @lts-v7 (o el tag correspondiente), no un 7.x antiguo de hace meses.
4. Versiona tus propios bundles de live-update con semver de la misma forma en que Capgo versiona sus paquetes. Ver versionado de bundles y canales y segmentación por versión.

Docs relacionadas

• Añadir una app — comandos de instalación y etiquetas LTS para el actualizador
• Resumen de CLI — cómo ejecutar comandos de Capgo CLI
• Compatibilidad nativa — cuándo un cambio requiere un binario de tienda vs un bundle OTA
• De V7 a V8 — ejemplo de una actualización mayor de un plugin alineado con Capacitor