Versionnement

Copiez un prompt de configuration avec les étapes d'installation et le guide Markdown complet pour ce plug-in.

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 de Capgo	Suivez la correspondance Numérotation majeure de Capacitor	Numérotation majeure de plugin `8` Cibles Capacitor 8, `7` Cibles Capacitor 7, et ainsi de suite
Capgo CLI	Indépendant	N'actualisez pas la numérotation majeure de CLI avec les plugins ou Capacitor. Utilisez toujours la dernière version de CLI
Capgo Console	Indépendant	Propre rythme de publication; compatible avec les versions du plugin de mise à jour prises en charge

correspondre au numéro majeur de votre plugin ou au numéro majeur de Capacitor. La dernière version de __CAPGO_KEEP_1__ fonctionne avec toute version du plugin de mise à jour prise en charge.

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 le moment où nous pouvons changer les options par défaut s'il existe un nouveau choix par défaut qui est préférable à 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 force le même break sur tous les consommateurs). Vous devriez généralement pouvoir 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 des upgrader 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 la need CLI major 8 because you are on Capacitor 8 or updater 8.
because you are on __CAPGO_KEEP_0__ 8 or updater You do CLI.
Les dernières versions de CLI et Console restent compatibles avec toute version prise en charge. @capgo/capacitor-updater Mise à jour majeure (et mise à jour de l'updater) 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” à la 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` se maintient 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).

à la 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 7 ligne LTS est publiée avec 7.3.4 les mêmes fonctionnalités et corrections de bogues , adaptées à cette __CAPGO_KEEP_0__ majeure.Installez avec la balise lorsque vous voulez « 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-v6La …) 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 qu'elle suit la dernière, la ligne LTS de la version publique API peut changer lorsque la dernière version change — même si le numéro majeur reste sur 7. Considérez 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

Mettez à jour les plugins Capgo lorsque vous mettez à jour les majors Capacitor.
Toujours exécutez @capgo/cli@latest — la synchronisation de la version majeure CLI avec les plugins Capacitor n'est pas nécessaire.
Restez sur Capacitor 7 (ou plus ancien)? Utilisez @lts-v7 (ou la balise correspondante), pas une ancienne version aléatoire 7.x de mois.
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 ciblage de version.

Ajoutez une application — commandes d'installation et balises LTS pour le metteur à jour
CLI vue d'ensemble — comment exécuter les commandes Capgo CLI
Compatibilité native — quand une modification nécessite un fichier binaire de magasin plutôt qu'un paquet OTA
De V7 à V8 — exemple d'une mise à niveau majeure d'un plugin alignée sur Capacitor