Versionnement

Copiez ce prompt de configuration avec les étapes d'installation et la guide markdown complet pour ce plugin.

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	Mise à jour majeure	Notes de compatibilité
Capgo plugins	Suivez la correspondance Capacitor majeur	__CAPGO_KEEP_0__ majeur `8` targets Capacitor 8, `7` Ciblez Capacitor 8, et ainsi de suite
Capgo CLI	Independent	Do not sync CLI major with plugins or Capacitor. Always use the latest CLI
Capgo Console	Indépendant	Propre rythme de publication; compatible avec les versions du plugin de mise à jour prises en charge

Plugins suivent les majeures Capacitor

Tout 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 les autres plugins Capgo

Quand Capacitor démarre une nouvelle version majeure, Capgo démarre une version majeure correspondante. C'est alors que nous pouvons changer les options par défaut si une nouvelle option par défaut est la meilleure choix à 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 pouvoir passer d'une version majeure de plugin Capgo à une autre en mettant à jour Capacitor sans devoir réécrire votre intégration.

Defaults may still change on a new major. Review release notes and migration guides (see mise à jour majeure and the guides under Migrations in the updater sidebar) when you bump.

CLI et Console utilisent leurs propres versions

Le Capgo CLI et Capgo Console ne partagent pas les versions majeures avec les plugins ou Capacitor.

Vous faites partagent besoin de CLI majeur 8 Installez toujours ou invoquez le Capacitor le plus récent 8.
Toujours installez ou invoquez le latest CLI.
Les dernières CLI et Console restent compatibles avec toute version prise en charge @capgo/capacitor-updater (majeure et son correcteur associé)

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

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

Balises LTS pour les majors précédents des plugins

Lorsque vous restez sur une version majeure plus ancienne de Capacitor, installez le plugin major correspondant Capgo avec une balise de dist-tag LTS au lieu de copier un fichier de verrouillage obsolète à jamais.

# 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

Les versions LTS des majors précédents des plugins sont publiées en dehors de l'actualiseur. sur 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

Mêmes fonctionnalités, numéros de version reflétés

Les lignes LTS reflètent les numéros mineur et de correction de la dernière ligne actuelle lorsqu'une mise à niveau existe.

Section intitulée “Mêmes fonctionnalités, numéros de version réfléchis” » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » » 8.3.4les Capacitor 7 LTS, la ligne est publiée comme 7.3.4 avec le même ensemble de fonctionnalités et les correctifs de bogues, adapté à ce Capacitor majeur.

Installez avec l'étiquette lorsque vous souhaitez « le dernier pour ce Capacitor majeur » :

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

LTS est une mise à niveau de la version la plus récente

Après la mise à jour majeure d'un plugin, un lts-v7 (or lts-v6La …) version est une backport de la dernière version de sorte que le même travail fonctionne sur le précédent Capacitor major.

Parce qu'il suit la dernière version, la ligne LTS publique API peut changer lorsque la dernière version change — même si le numéro majeur reste sur __CAPGO_KEEP_0__ 7Traitez le LTS comme le « comportement actuel Capgo sur un ancien Capacitor », et non comme un héritage figé API à vie.

Ce que cela signifie pour votre application

Mettez à jour les Capgo plugins lorsque vous mettez à jour les Capacitor majeurs.
Toujours exécuter @capgo/cli@latest — la synchronisation de CLI major avec Capacitor/plugins n'est pas nécessaire.
Restez sur Capacitor 7 (ou plus ancien)? Utilisez @lts-v7 (ou la balise correspondante), pas une ancienne au hasard 7.x il y a des mois
Gérez vos propres mises à jour live avec semver la même façon que Capgo versionne ses packages. Consultez la versionnement des bundles et des canaux et la ciblage de version.

Add an app — commandes d'installation et balises LTS pour le metteur à jour
Présentation de CLI — Comment exécuter les commandes Capgo CLI
Compatibilité native — when a change needs a store binary vs an OTA bundle
De V7 à V8 — exemple d'un plugin majeur mis à jour aligné sur un Capacitor