Versionnement

Capgo utilise la versionnement semantique (semver) pour les plugins, le CLI, et les produits que nous expédions — la même pratique que nous recommandons pour vos propres ensembles d'applications.

Cette page explique comment ces versions se rapportent les unes aux autres, ce qui reste compatible en fonction des majeures, et comment fixer les anciens Capacitor majeurs avec des étiquettes LTS.

Règles rapides

Produit	Numérotation majeure	Notes de compatibilité
Capgo plugins	Suivez les correspondances Capacitor majeure	Numérotation majeure du plugin 8 Cibles Capacitor 8, 7 Cibles Capacitor 7, et ainsi de suite
Capgo CLI	Indépendant	N'actualisez pas CLI majeure avec les plugins ou Capacitor. Utilisez toujours la dernière CLI
Capgo Console	Indépendant	Cadrage de publication propre; compatible avec les versions du plugin de mise à jour prises en charge

Utilisez toujours la dernière version de CLI

Exécutez le CLI avec @latest Par exemple npx @capgo/cli@latest ...Le numéro majeur de CLI ne doit pas nécessairement correspondre au numéro majeur de votre plugin ou au numéro majeur de __CAPGO_KEEP_0__. La dernière version de __CAPGO_KEEP_1__ fonctionne avec toute version du plugin de mise à jour prise en charge. need to match your plugin major or Capacitor major. The latest CLI works with any supported updater plugin version.

Section intitulée “Les plugins suivent les numéros majeurs de Capacitor”

Chaque plugin Capgo majeure suit la majeure Capacitor pour laquelle il est construit :

• @capgo/capacitor-updater@8 → Capacitor 8
• @capgo/capacitor-updater@7 → Capacitor 7
• et le même modèle pour d'autres plugins Capgo

Lorsque Capacitor démarre une nouvelle majeure, Capgo démarre un plugin majeur correspondant. C'est alors que nous pouvons changer les options par défaut s'il existe un nouveau choix par défaut qui est meilleur à long terme pour cette génération de Capacitor.

la stabilité de API entre les majeures

Les API des plugins restent stables entre les majeures, à moins qu'une modification ne soit cassée par conception pour tout le monde (par exemple, une exigence de plateforme Capacitor qui oblige le même break pour tous les consommateurs). Vous devriez généralement pouvoir passer d'une majeure de plugin Capgo à une autre en fonction de l'amélioration de Capacitor sans réécrire votre intégration.

Les options par défaut peuvent toujours changer lors d'une nouvelle majeure. Vérifiez les notes de version et les guides de migration (voir les mises à jour de l'améliorateur et les guides sous Migrations dans le côté de mise à jour) lorsque vous augmentez.

CLI et Console utilisent leurs propres versions

Le Capgo CLI et Capgo Console ne partagent pas les versions majeures avec les plugins ou __CAPGO_KEEP_0__. Vous n'avez pas besoin de Capacitor majeur

• puisque vous êtes sur __CAPGO_KEEP_0__ 8 ou mise à jour Installez toujours ou invoquez le need CLI major 8 because you are on Capacitor 8 or updater 8.
• because you CLI.
• La dernière CLI et Console restent compatibles avec toute version prise en charge. @capgo/capacitor-updater Mise à jour majeure (et mise à jour de mise à jour) majeure.

Il est déconseillé de fixer une ancienne version de CLI. Préférez :

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

Balises LTS pour les majors précédents des 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

Section intitulée “Balises LTS pour les majors précédents des plugins” On demande.

Updater backports vs autres plugins

Package	Backports de version majeure précédente
@capgo/capacitor-updater	Backports mensuels réfléchis vers v7 / v6 / v5 (lts-v7, lts-v6, lts-v5). lts-v4 reste disponible pour Capacitor 4 mais n'est pas sur ce calendrier mensuel
Autres Capgo plugins	Context : Page/zone : Page de produit/prix d'entreprise. Rôle : Phrase de copie du site web. Vu dans : page enterprise.astro. Conservez les termes de produit/marque et les termes de développeur exactement. Clé de message `enterprise_130_plugins` (Enterprise 130 Plugins).

On demande

Section intitulée « Même fonctionnalités, numéros de version réfléchis »

Si la dernière version est 8.3.4, la Capacitor ligne LTS est publiée avec 7.3.4 les mêmes fonctionnalités et corrections de bogues , adaptée à cette __CAPGO_KEEP_0__ majeure.Installez avec la balise lorsque vous souhaitez « la dernière pour cette Capacitor majeure » :

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.4

Sous-titre « LTS est un backport de la dernière »

(ou lts-v7 protectedTokens lts-v6…) version est une une mise à jour de la dernière ainsi le même travail fonctionne sur la version précédente Capacitor majeure.

Parce que la version LTS suit la dernière, la ligne publique API peut changer lorsque la dernière version change — même si le numéro majeur reste sur 7. Considérez la version LTS comme le « comportement actuel Capgo sur une version plus ancienne Capacitor », et non comme une version legacy figée pour toujours API.

Ce que cela signifie pour votre application

1. Mettez à jour les plugins Capgo lorsque vous mettez à jour les majors Capacitor.
2. Toujours exécutez @capgo/cli@latest — la synchronisation de la version majeure CLI avec les plugins Capacitor n'est pas nécessaire.
3. Restez sur Capacitor 7 (ou une version plus ancienne) ? Utilisez @lts-v7 (ou la balise correspondante), pas une ancienne version aléatoire. 7.x Cette version remonte à des mois.
4. Versionnez vos propres bundles de mise à jour en direct avec semver de la même manière que Capgo versionne ses packages. Consultez la versionnement des bundles et les canaux et la ciblage de version.

Documents connexes

• Ajoutez une application — commandes d'installation et balises LTS pour le metteur à jour
• CLI aperçu — comment exécuter les commandes Capgo CLI
• Compatibilité native context : Page/zone : Page de produit de mise à jour en direct. Rôle : Étiquette de navigation ou élément UI court. Vu dans : page live-update.astro. Clé de message `live_update_v2_comp_compat_l` (Live Update V2 Comp Compat L).
• — quand une modification nécessite un fichier binaire de magasin plutôt qu'un bundle OTA — example of a Capacitor-aligned plugin major upgrade