Versionamento

Copia un prompt di configurazione con le istruzioni di installazione e la guida markdown completa per questo plugin.

Capgo utilizza la versione semantica (semver) per plugin, il CLI, e i prodotti che inviamo — la stessa pratica che consigliamo per le proprie bundle dell'app.

Questa pagina spiega come quelle versioni si relazionano tra loro, cosa rimane compatibile tra le maggiori, e come bloccare versioni più vecchie di Capacitor con tag LTS.

Regole veloci

Prodotto	Versioning principale	Note di compatibilità
Capgo plugin	Segui il matching Capacitor versione maggiore	Plugin maggiore `8` Si applica a Capacitor 8, `7` Si applica a Capacitor 7, e così via
Capgo CLI	Indipendente	Non sincronizzare il CLI maggiore con i plugin o Capacitor. Utilizzare sempre la versione più recente del CLI.
Console di Capgo	Indipendente	Ciclo di rilascio autonomo; compatibile con le versioni del plugin di aggiornamento supportate

Plugins seguono Capacitor versioni maggiori

Ogni plugin di Capgo segue la versione maggiore di Capacitor per cui è stato costruito:

@capgo/capacitor-updater@8 → Capacitor 8
@capgo/capacitor-updater@7 → Capacitor 7
e lo stesso schema per altri plugin Capgo

When Capacitor ships a new major, Capgo ships a matching plugin major. That is when we may change le impostazioni predefinite se una nuova impostazione è una scelta migliore a lungo termine per quella versione di Capacitor.

la stabilità di API tra le versioni maggiori

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.

Defaults possono ancora cambiare in una nuova versione maggiore. Verifica i note di rilascio e le guide di migrazione (vedi) gli aggiornamenti dell'aggiornatore e le guide sotto Migrations nella barra laterale dell'aggiornatore) quando aumenti la versione.

CLI e Console utilizzano le proprie versioni

La Capgo CLI e Capgo Console non not È necessario Capacitor una versione maggiore

Fai not hanno bisogno di CLI maggiore 8 poiché sei su Capacitor 8 o aggiornatore 8.
È necessario __CAPGO_KEEP_0__ una versione maggiore latest CLI.
Il CLI più recente e la Console rimangono compatibili con qualsiasi versione supportata @capgo/capacitor-updater (e l'aggiornatore correlato) principale.

È sconsigliato bloccare una versione vecchia di CLI. Preferisci:

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

Etichette LTS per plugin maggiori precedenti

Quando rimani su una versione più vecchia di Capacitor, installa il plugin maggior corrispondente Capgo con un'etichetta di dist-tag LTS al posto di copiare un file di blocco obsoleto per sempre.

# 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

Fuori dall'aggiornatore, le rilasciate LTS delle versioni precedenti dei plugin vengono pubblicate su richiesta.

Updater backports vs altri plugin

Pacchetto	Backport precedente-maggiore
`@capgo/capacitor-updater`	Backport mensili riflessi su `v7` / `v6` / `v5` (`lts-v7`, `lts-v6`, `lts-v5`). `lts-v4` rimane disponibile per Capacitor 4 ma non è su quel calendario mensile
Altri Capgo plugin	A richiesta

Stesse funzionalità, numeri di versione speculari

Sezione intitolata “Stesse funzionalità, versioni numerate riflesse”

Se la versione più recente è 8.3.4la Capacitor 7 LTS linea è pubblicata come 7.3.4 con il adattata per quella __CAPGO_KEEP_0__ maggiore., adattato per quel Capacitor major.

Installa con il tag quando desideri “l'ultima versione per questo Capacitor maggiore”.

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

Sottosezione intitolata “LTS è una backport dell'ultima”

After a new plugin major ships, an lts-v7 (or lts-v6release è un backport dell'ultima versione quindi lo stesso lavoro funziona sul precedente Capacitor major.

Poiché segue l'ultima versione, la linea LTS del pubblico API può cambiare quando l'ultima versione cambia — anche se il numero maggiore rimane sul 7. Trattate la LTS come “il comportamento corrente Capgo su un vecchio Capacitor,” non come un legato API legacy per sempre.

Cosa significa per il tuo app

Aggiorna Capgo plugin quando aggiorni Capacitor majors.
Esegui sempre @capgo/cli@latest — CLI major sincronizza con Capacitor/plugin è inutile.
Resta su Capacitor 7 (o vecchio)? Utilizza @lts-v7 o (o il tag corrispondente), non un vecchio casuale 7.x da alcuni mesi fa
Versiona i tuoi bundle di aggiornamento in tempo reale con semver lo stesso modo in cui Capgo versiona i suoi pacchetti. Vedi la versione dei pacchetti e dei canali e la versione mirata.

Aggiungi un'app – comandi di installazione e tag LTS per l'aggiornatore
Panoramica di CLI --- come eseguire Capgo CLI comandi
Compatibilità nativa — quando una modifica richiede un binario di magazzino vs un bundle OTA
Dal V7 al V8 — esempio di un plugin di aggiornamento maggiore allineato con Capacitor