Versioning

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

Questa pagina spiega come queste versioni si relazionano tra loro, cosa rimane compatibile tra le versioni maggiori, e come bloccare le versioni maggiori precedenti di Capacitor con tag LTS.

Regole veloci

Prodotto	Versione maggiore	Nota di compatibilità
Capgo plugin	Segui la versione corrispondente Capacitor versione maggiore	Versione maggiore del plugin 8 target Capacitor 8, 7 target Capacitor 7, e così via
Capgo CLI	Indipendente	Non sincronizzare CLI versione maggiore con i plugin o Capacitor. Utilizza sempre la versione più recente di CLI
Capgo Console	Indipendente	Cadenza di rilascio propria; compatibile con le versioni del plugin di aggiornamento supportate

Usa sempre la versione più recente di CLI

Esegui il comando CLI con @latest ad esempio npx @capgo/cli@latest ...). La versione maggiore di CLI non deve corrispondere alla versione maggiore del tuo plugin o alla versione maggiore di Capacitor. La versione più recente di CLI funziona con qualsiasi versione del plugin di aggiornamento supportata.

I plugin seguono le versioni maggiori di Capacitor

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

Quando Capacitor rilascia una nuova versione maggiore, Capgo rilascia un plugin con versione maggiore corrispondente. È in quel momento che possiamo cambiare opzioni predefinite se una nuova opzione predefinita è la scelta migliore a lungo termine per quella generazione di Capacitor.

stabilità di API tra le versioni maggiori

Gli API dei plugin rimangono stabili tra le versioni maggiori a meno che un cambiamento non sia rotto di progetto per tutti (ad esempio una richiesta di piattaforma Capacitor che costringe lo stesso break per tutti i consumatori). Dovresti poter solitamente spostarti tra le versioni maggiori dei plugin Capgo mentre aggiorni Capacitor senza dover ricompilare la tua integrazione.

Le opzioni predefinite possono ancora cambiare con una nuova versione maggiore. Esegui una revisione delle note di rilascio e delle guide di migrazione (vedi l'aggiornamento aggiorna e le guide sotto Migrazioni nella barra laterale dell'aggiornamento) quando aumenti la versione.

CLI e Console utilizzano le proprie versioni

Capgo CLI e Capgo Console non condividono le versioni principali con i plugin o Capgo. Non è necessario __CAPGO_KEEP_0__ per le versioni principali, poiché si è su __CAPGO_KEEP_0__ 8 o aggiornatore. Installa sempre la versione più recente di Capacitor.

• La versione più recente di __CAPGO_KEEP_0__ e Console rimane compatibile con qualsiasi versione supportata La versione più recente di __CAPGO_KEEP_0__ e Console rimane compatibile con qualsiasi versione supportata. Non è necessario CLI per le versioni principali, poiché si è su CLI 8 o aggiornatore. 8 Capacitor __CAPGO_KEEP_1__ e __CAPGO_KEEP_2__ Console non condividono le versioni principali con i plugin o Capacitor. 8.
• Sezione intitolata “__CAPGO_KEEP_0__ e Console utilizzano le proprie versioni” __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ e __CAPGO_KEEP_2__ Console non condividono le versioni principali con i plugin o __CAPGO_KEEP_0__. Installa sempre la versione più recente di CLI.
• Non è necessario CLI per le versioni principali, poiché si è su CLI 8 o aggiornatore. @capgo/capacitor-updater e (e relativo aggiornatore) maggiore.

È 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 un maggiore Capacitor più vecchio, installa il maggiore Capgo del plugin corrispondente con un'etichetta di distribuzione 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 dei plugin maggiori precedenti vengono pubblicate su richiesta.

Aggiornamenti backport vs altri plugin

Pacchetto	Backport della versione precedente maggiore
@capgo/capacitor-updater	Backport mensili riflessi a 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	A richiesta

Le stesse funzionalità, versioni numerate riflesse

Le linee LTS riflettono la versione minore e di patch corrente della linea più recente quando esiste un backport.

Se la versione più recente è 8.3.4, il Capacitor 7 linea LTS viene pubblicata come 7.3.4 With lo stesso set di funzionalità e correzioni di bug , adattato per quel __CAPGO_KEEP_0__ maggiore.Installa con l'etichetta quando desideri “più recente per questo Capacitor maggiore”:

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

Sottosezione intitolata “LTS è una backport della versione più recente”

(o lts-v7 , …) rilascio è una lts-v6backport della versione più recente Install with the tag when you want “latest for this __CAPGO_KEEP_0__ major”: So il lavoro stesso funziona sul precedente Capacitor maggiore.

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

Cosa significa per il tuo app

1. Aggiorna Capgo plugin quando si aggiorna Capacitor maggiore.
2. Esegui sempre @capgo/cli@latest — CLI maggiore sincronizza con Capacitor/plugin è inutile.
3. Resta su Capacitor 7 (o vecchio)? Utilizza @lts-v7 (o la corrispondente etichetta), non un vecchio casuale 7.x da alcuni mesi fa.
4. Versiona i propri bundle di aggiornamento in tempo reale con semver lo stesso modo in cui Capgo gestisce le sue librerie. Vedi la versioning dei bundle e dei canali e la versione di destinazione.

Documentazione correlata

• Aggiungi un'app — comandi di installazione e tag LTS per l'aggiornatore
• CLI overview — come eseguire Capgo CLI comandi
• Compatibilità nativa — quando un cambiamento richiede un file binario di archiviazione vs un pacchetto OTA
• Da V7 a V8 — esempio di un aggiornamento del plugin con numero di versione allineato a Capacitor