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é
Capgo plugins	Compatibilité Capacitor major	__CAPGO_KEEP_0__ majeur `8` targets Capacitor 8, `7` Cibles Capacitor 8,
Capgo CLI	__CAPGO_KEEP_0__ __CAPGO_KEEP_1__	Indépendant(e)s : ne pas synchroniser CLI majeur avec les plugins ou Capacitor . Utilisez toujours la dernière version de CLI
Capgo Console	Indépendant	Cadrage de publication propre; compatible avec les versions du plugin de mise à jour prises en charge

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

Chaque Capgo plugin majeure suit le Capacitor majeure pour lequel il est construit :

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

When Capacitor ships a new major, Capgo ships a matching plugin major. That is when we may change Lorsque __CAPGO_KEEP_0__ publie une nouvelle majeure, __CAPGO_KEEP_1__ publie un plugin majeur correspondant. C'est alors que nous pouvons changer if a new default is the better long-term choice for that Capacitor generation.

si une nouvelle option par défaut est la meilleure choix à long terme pour cette génération de API.

Plugin APIs stay stable between majors unless a change is broken by design for everyone (for example a Capacitor platform requirement that forces the same break on all consumers). You should usually be able to move between Capgo plugin majors as you upgrade Capacitor without rewriting your integration.

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 __CAPGO_KEEP_0__ qui force la même rupture pour tous les consommateurs). Vous devriez généralement être en mesure de passer d'un plugin majeur __CAPGO_KEEP_1__ à un autre en fonction de l'upgrade de __CAPGO_KEEP_2__ 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'upgrader) et les guides sous Migrations dans le côté de mise à jour) lorsque vous faites une mise à jour.

CLI et Console utilisent leurs propres versions

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

car 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.
__CAPGO_KEEP_0__ __CAPGO_KEEP_1__ 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

__CAPGO_KEEP_1__ 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` 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 : Copie du site Web. Vu dans : page enterprise.astro. Conservez les termes de produit/marque et les termes de développeur exacts. Clé de message `enterprise_130_plugins` (Plugins d'entreprise 130).

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 correction de la ligne la plus récente existante lorsqu'un backport existe.

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

Section intitulée « LTS est un backport de la dernière »

(ou lts-v7 LTS est un backport de la dernière lts-v6… version de sortie est une une mise à niveau de la dernière ainsi le même travail fonctionne sur le précédent Capacitor major.

Parce que cela suit la dernière, la ligne LTS de l’API peut changer lorsque la dernière change — même si le numéro majeur reste sur 7. Traitez la LTS comme le « comportement actuel de la Capgo sur un ancien Capacitor », et non comme un héritage légendaire API éternel.

Qu'est-ce que cela signifie pour votre application

Mettez à jour les Capgo plugins lorsque vous mettez à jour les Capacitor majors.
Toujours exécutez @capgo/cli@latest — le synchronisation de CLI major avec Capacitor/plugins est inutile.
Restez sur Capacitor 7 (ou une version antérieure) ? Utilisez @lts-v7 (ou le tag correspondant), pas un ancien aléatoire 7.x il y a des mois
Gérez les versions de vos propres bundles de mise à jour en temps réel avec semver the same way Capgo versions its packages. See Gestion de versions et de canaux pour les bundles et ciblage de version.

Ajouter 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` (Mise à jour en direct V2 Comp Compat L).
— quand une modification nécessite un fichier binaire de magasin plutôt qu'un paquet OTA — example of a Capacitor-aligned plugin major upgrade