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.

This page explains how those versions relate to each other, what stays compatible across majors, and how to pin older Capacitor majors with LTS tags.

Reglas rápidas

Producto	Versión principal	Notas de compatibilidad
Plugins de Capgo	Seguir el ajuste Capacitor mayor	Mayor de plugin 8 Objetivos Capacitor 8 7 Objetivos Capacitor 7, y así sucesivamente
Capgo CLI	Independiente	No sincronice CLI mayor con plugins o Capacitor. Utilice siempre la última CLI
Consola de Capgo	Independiente	Ciclo de lanzamiento propio; compatible con versiones de plugins de actualización admitidas

Utilice siempre la última CLI

Ejecute la CLI con @latest por ejemplo npx @capgo/cli@latest ...La CLI mayor no not Deben coincidir con la versión mayor de su plugin o Capacitor mayor. La última CLI funciona con cualquier versión del plugin de actualización admitida.

Plugins siguen Capacitor versiones mayores

Cada plugin mayor de Capgo sigue el mayor de Capacitor para el que se compila.

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

Cuando Capacitor envíe una nueva versión mayor, Capgo enviará una versión mayor compatible. opciones predeterminadas si una nueva opción predeterminada es la mejor elección a largo plazo para esa generación de Capacitor.

estabilidad de API entre versiones

Las API de los plugins permanecen estables entre versiones a menos que un cambio esté roto por diseño para todos (por ejemplo, una Capacitor plataforma que fuerce el mismo cambio en todos los consumidores). Deberías poder moverte entre versiones mayores de Capgo plugin mientras 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 las guías de migración (ver actualizaciones de actualizador 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

El Capgo CLI y Capgo Console hacen not porque está en Capacitor 8 o actualizador

• Haces not necesita CLI mayor 8 porque estás en Capacitor 8 o actualizador 8.
• Siempre instale o invoque el latest CLI.
• La última CLI y Consola permanecen compatibles con cualquier versión admitida @capgo/capacitor-updater (y el actualizador relacionado) mayor.

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

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

Etiquetas LTS para versiones antiguas de plugins

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 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 actualizador, se publican versiones LTS de los mayores de plugins anteriores en demanda.

LTS tags for previous plugin majors

Paquete	Anteriores versiones principales
@capgo/capacitor-updater	Miradas mensuales reflejadas 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 Capgo plugins	context

Mismas características, números de versión reflejados

Sección titulada “Las mismas características, números de versión reflejados”

Si la última versión disponible 8.3.4La línea Capacitor 7 LTS se publica como 7.3.4 con la el mismo conjunto de características y correcciones de errores, adaptado a ese Capacitor mayor.

Instale con la etiqueta cuando desee “último para este Capacitor mayor”:

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

LTS es una actualización de última versión

Después de que un nuevo plugin mayor se envía, un lts-v7 (o lts-v6La versión …) de lanzamiento es una actualización a la versión más reciente entonces el mismo trabajo funciona en el Capacitor anterior.

Porque sigue a la última, la línea LTS del API puede cambiar cuando cambian las últimas — incluso si el número mayor se queda en 7Trate a LTS como "comportamiento actual Capgo en una versión Capacitor más antigua," no como un legado API congelado para siempre.

¿Qué significa esto para tu aplicación

1. Actualiza los plugins Capgo cuando actualices las versiones principales Capacitor.
2. Siempre ejecuta @capgo/cli@latest — CLI major sync with Capacitor/plugins is unnecessary.
3. Manténgase en Capacitor 7 (o anterior)? Utilice @lts-v7 (o o el etiquetado correspondiente), no un antiguo al azar 7.x hace varios meses
4. Versióna tus propios paquetes de actualización en vivo con semver de la misma manera que Capgo versiona sus paquetes. Consulta versión de paquetes y canales y versión dirigida.

Documentación relacionada

• Add an app — comandos de instalación y etiquetas LTS para el actualizador
• Resumen de CLI --- cómo ejecutar Capgo CLI comandos
• Compatibilidad nativa --- cuando un cambio requiere un binario de almacenamiento vs un paquete OTA
• De V7 a V8 — ejemplo de una actualización de plugin mayormente alineada con Capacitor