Versionnage

Copiez un prompt de configuration incluant les étapes d'installation et le guide markdown complet pour ce plugin.

Capgo utilise un versionnage sémantique (semver) pour les plugins, le CLI et les produits que nous livrons — la même pratique que nous recommandons pour vos propres bundles d'application.

Cette page explique comment ces versions sont liées entre elles, ce qui reste compatible entre les versions majeures, et comment épingler d'anciennes versions majeures de Capacitor avec des tags LTS.

Règles rapides

Produit	Versioning majeur	Notes de compatibilité
Plugins Capgo	Respecter la correspondance Capacitor majeure	Major du plugin `8` cible Capacitor 8, `7` cible Capacitor 7, et ainsi de suite
Capgo CLI	Indépendant	Ne synchronisez pas le major de CLI avec les plugins ou Capacitor. Utilisez toujours la dernière version de CLI
Console Capgo	Indépendant	Cadence de release propre ; compatible avec les versions prises en charge du plugin updater

Les plugins suivent Capacitor versions majeures

Every Capgo plugin major tracks the Capacitor major it is built for:

@capgo/capacitor-updater@8 → Capacitor 8
@capgo/capacitor-updater@7 → Capacitor 7
et le même schéma pour les autres plugins Capgo

When Capacitor ships a new major, Capgo ships a matching plugin major. That is when we may change options par défaut si une nouvelle valeur par défaut est le meilleur choix à long terme pour cette génération Capacitor.

Stabilité de API entre les versions majeures

Les API des plugins restent stables entre les versions majeures, sauf si une modification est cassée par conception pour tout le monde (par exemple, une exigence de la plateforme Capacitor qui impose la même rupture à tous les utilisateurs). Vous devriez généralement pouvoir passer d'une version majeure à l'autre des plugins Capgo lors de la mise à niveau de Capacitor sans réécrire votre intégration.

Defaults may still change on a new major. Review release notes and migration guides (see mises à jour de l’updater et les guides sous Migrations dans la barre latérale de l’updater) lors d’une montée de version.

CLI et la Console utilisent leurs propres versions

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

Vous avez pas nécessite CLI major 8 car vous êtes sur Capacitor 8 ou updater 8.
Installez ou invoquez toujours le Dernière CLI.
Les dernières versions de CLI et de la Console restent compatibles avec toute @capgo/capacitor-updater (et l'updater associé) major.

Évitez de figer une ancienne version de CLI. Préférez :

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

LTS tags for previous plugin majors

Si vous restez sur une ancienne version majeure de Capacitor, installez la version majeure correspondante du plugin Capgo avec un dist-tag LTS, plutôt que de copier indéfiniment un lockfile obsolète.

# 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

En dehors de l'updater, les releases LTS des anciennes versions majeures du plugin sont publiées à la demande.

Backports de l'Updater vs autres plugins

Package	Backports des versions majeures précédentes
`@capgo/capacitor-updater`	Backports mensuels miroirs vers `v7` / `v6` / `v5` (`lts-v7`, `lts-v6`, `lts-v5`). `lts-v4` reste disponible pour Capacitor 4, mais ne suit pas ce rythme mensuel
Autres plugins Capgo	À la demande

Mêmes fonctionnalités, numéros de version identiques

Les lignes LTS reflètent la version mineure et les correctifs de la dernière ligne actuelle lorsqu’un backport existe.

Si la release la plus récente est 8.3.4, la ligne Capacitor 7 LTS est publiée en tant que 7.3.4 avec le même ensemble de fonctionnalités et correctifs, adapté à cette version majeure Capacitor.

Installez avec le tag quand vous voulez « latest pour cette majeure de Capacitor » :

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

La LTS est un backport de la dernière version

After a new plugin major ships, an lts-v7 (ou lts-v6, …) release est un backport de latest pour que le même code s'exécute sur la majeure Capacitor précédente.

Comme elle suit latest, la version publique API de la ligne LTS peut changer lors des derniers changements — même si le numéro majeur reste sur 7. Considérez la LTS comme « le comportement actuel de Capgo sur une ancienne Capacitor », et non comme une API figée à jamais.

Ce que cela signifie pour votre application

Upgrade Capgo plugins when you upgrade Capacitor majors.
Toujours exécuter @capgo/cli@latest — la synchronisation majeure de CLI avec Capacitor/plugins est inutile.
Stay on Capacitor 7 (or older)? Use @lts-v7 (ou le tag correspondant), et non un ancien 7.x de plusieurs mois.
Versionnez vos propres bundles de live update avec semver de la même manière que Capgo versionne ses packages. Voir versioning des bundles et canaux et ciblage de version.

Ajouter une app — commandes d’installation et tags LTS pour l’updater
Aperçu de CLI — comment exécuter les commandes Capgo CLI
Compatibilité native — quand une modification nécessite un binaire store plutôt qu’un bundle OTA
De V7 à V8 — exemple de mise à jour majeure d’un plugin alignée sur Capacitor