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 au fil des majeures, et comment fixer les anciens Capacitor majeurs avec des étiquettes LTS.

Règles rapides

Produit	Numérotation majeure	Notes de compatibilité
Plugins Capgo	Suivez la correspondance Capacitor numérotation 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 la numérotation majeure CLI 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 à celui 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 Capgo plugin 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 le moment où nous pouvons changer les options par défaut s'il existe un nouveau choix par défaut qui est la meilleure option à 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'un changement ne soit cassé 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 être en mesure de passer d'une majeure de plugin Capgo à une autre en fonction de l'upgrade de Capacitor sans devoir 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'upgrader et les guides sous Migrations dans le côté mises à jour du panneau)

CLI and Console use their own versions

The Capgo CLI and Capgo Console do Le __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ et __CAPGO_KEEP_2__ Console ne partage pas les versions majeures avec les plugins ou Capacitor.

• Vous n'avez pas besoin de __CAPGO_KEEP_0__ majeur car vous êtes sur __CAPGO_KEEP_0__ 8 ou mises à jour need CLI major 8 because you are on Capacitor 8 or updater 8.
• latest latest CLI.
• Les dernières versions de CLI et Console restent compatibles avec toute version prise en charge. @capgo/capacitor-updater Les mises à jour majeures (et l'actualisateur associé) restent compatibles.

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	Mirages mensuels de backports à v7 / v6 / v5 (lts-v7, lts-v6, lts-v5). lts-v4 est disponible pour Capacitor 4 mais n'est pas sur ce calendrier mensuel
Autres Capgo plugins	Context : Page/zone : Page de produit/taux d'entreprise. Rôle : Copie de site. 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êmes fonctionnalités, numéros de version réfléchis » : Les lignes LTS reflètent les numéros mineurs et de patch de la ligne actuelle la plus récente lorsqu'il existe un backport.

If the latest release is 8.3.4, le Capacitor 7 LTS est publié avec 7.3.4 avec le même ensemble de fonctionnalités et les correctifs de bogues , adapté à cette __CAPGO_KEEP_0__ majeure.Installez avec la balise lorsque vous souhaitez « le dernier 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

Titre de la section « Le LTS est une mise à niveau de la dernière version »

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

Parce que la version la plus récente est suivie, la ligne LTS peut voir son API public changer même si le numéro majeur reste inchangé. Quand la version la plus récente change — même si le numéro majeur reste inchangé. 7Traitez la 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 lors de la mise à niveau des majeures Capacitor.
2. Toujours exécutez @capgo/cli@latest une 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 Depuis 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 contexte: Page/zone : Site de marketing Capgo. Rôle : Étiquette de navigation ou élément UI court. Vu dans : page trust.astro. Clé de message `et` (Et)..

la ciblage de version

• Titre de section « Documents connexes » — commandes d'installation et balises LTS pour le metteur à jour
• CLI vue d'ensemble — 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