Versionamento

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

Capgo utilizza versionamento semantico (semver) per i plugin, CLI e i prodotti che rilasciamo — la stessa pratica che consigliamo per i vostri bundle app.

Questa pagina spiega come queste versioni sono correlate, cosa rimane compatibile tra le major e come bloccare vecchie major di Capacitor con i tag LTS.

Regole rapide

Prodotto	Versioning delle Major	Note sulla compatibilità
Plugin Capgo	Segui il corrispondente Capacitor maggiore	Plugin major `8` supporta Capacitor 8, `7` supporta Capacitor 7, e così via
Capgo CLI	Indipendente	Non sincronizzare la major di CLI con i plugin o Capacitor. Usa sempre l'ultima versione di CLI.
Console Capgo	Indipendente	Ciclo di rilascio proprio; compatibile con le versioni dei plugin updater supportate

I plugin seguono le major di Capacitor

Ogni major del plugin Capgo segue la major di Capacitor per cui è stata creata:

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

Quando Capacitor rilascia una nuova major, Capgo rilascia una major del plugin corrispondente. È in quel momento che potremmo cambiare opzioni di default se un nuovo default sia la scelta migliore a lungo termine per quella generazione di Capacitor.

stabilità di API tra le major

Le API dei plugin rimangono stabili tra le versioni major, a meno che un cambiamento non sia interruzione intenzionale per tutti (ad esempio un requisito della piattaforma Capacitor che impone lo stesso breaking change a tutti gli utenti). In genere dovresti essere in grado di passare tra le versioni major dei plugin Capgo aggiornando Capacitor senza dover riscrivere l'integrazione.

I default potrebbero comunque cambiare con una nuova major. Controlla le release notes e le guide alla migrazione (vedi aggiornamenti dell'updater e le guide sotto Migrations nella sidebar dell'updater) quando effettui il bump.

CLI e Console usano le proprie versioni

La Capgo CLI e la Capgo Console fanno hai condividi le versioni major con i plugin o Capacitor.

Non hai serve CLI major 8 perché usi Capacitor 8 o l'updater 8.
Installa o invoca sempre il più recente CLI.
L'ultima versione di CLI e la Console rimangono compatibili con qualsiasi @capgo/capacitor-updater (e l'updater correlato) major.

Sconsigliamo di bloccare una vecchia versione di CLI. Preferisci:

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

Tag LTS per le major precedenti dei plugin

Se resti su una major più vecchia di Capacitor, installa la major corrispondente del plugin Capgo con un dist-tag LTS, invece di copiare all'infinito un lockfile obsoleto.

# 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

Al di fuori dell'updater, le release LTS delle major precedenti dei plugin vengono pubblicate on demand.

Backport dell'updater vs altri plugin

Pacchetto	Backport delle major precedenti
`@capgo/capacitor-updater`	Backport mensili speculari per `v7` / `v6` / `v5` (`lts-v7`, `lts-v6`, `lts-v5`). `lts-v4` rimane disponibile per Capacitor 4 ma non segue quella cadenza mensile
Altri plugin Capgo	Su richiesta

Stesse feature, versioni speculari

Le linee LTS specchiano minor e patch dell'ultima versione corrente quando esiste un backport.

Se l'ultimo rilascio è 8.3.4, la linea Capacitor 7 LTS viene pubblicata come 7.3.4 con il stesso set di feature e bug fix, adattato a quella Capacitor major.

Installa con il tag quando vuoi l'ultima versione per questa Capacitor major:

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

LTS è un backport dell'ultima versione

After a new plugin major ships, an lts-v7 (o lts-v6release, …) è un backport dell'ultima versione così lo stesso codice gira sulla precedente Capacitor major.

Poiché segue l'ultima versione, la API pubblica della linea LTS potrebbe cambiare quando arrivano le ultime modifiche — anche se il numero major rimane lo stesso 7. Considera LTS come il "comportamento Capgo attuale su una Capacitor precedente", non come un API legacy bloccato per sempre.

Cosa significa per la tua app

Aggiorna i plugin Capgo quando aggiorni le major di Capacitor.
Esegui sempre @capgo/cli@latest — una sincronizzazione major CLI con Capacitor/plugin non è necessaria.
Rimani su Capacitor 7 (o versioni precedenti)? Usa @lts-v7 (o il tag corrispondente), non un vecchio 7.x from months ago.
Gestisci il versionamento dei tuoi bundle live-update con semver the same way Capgo versions its packages. See versionamento bundle e canali e targeting delle versioni.

Aggiungi un'app — comandi di installazione e tag LTS per l'updater
Panoramica CLI — come eseguire i comandi Capgo CLI
Compatibilità nativa — quando serve un binario store vs un bundle OTA
Da V7 a V8 — esempio di un major upgrade di un plugin allineato a Capacitor