Versioning

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 i plugin, il CLI, e i prodotti che forniamo — la stessa pratica che consigliamo per i propri pacchetti 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 dei Capacitor con le etichette LTS.

Regole veloci

Prodotti	Versionamento maggiore	Note sulla compatibilità
Capgo plugin	Segui il matching Capacitor versione maggiore	Versione maggiore del plugin `8` Obiettivi Capacitor 8, `7` Obiettivi 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	Propria sequenza di rilascio; compatibile con le versioni del plugin di aggiornamento supportate

deve corrispondere alla versione maggiore del tuo plugin o alla versione maggiore di Capacitor. La versione più recente di __CAPGO_KEEP_1__ funziona con qualsiasi versione del plugin di aggiornamento supportata

Ogni plugin Capgo di versione maggiore segue la versione maggiore 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 maggiore corrispondente. È in questo momento che possiamo modificare le impostazioni predefinite se una nuova impostazione predefinita è una scelta migliore a lungo termine per quella versione Capacitor

la stabilità di API tra le versioni

Gli API dei plugin rimangono stabili tra le versioni a meno che un cambiamento non sia rotto per tutti (ad esempio una richiesta di piattaforma Capacitor che costringe lo stesso break per tutti gli utenti). In genere dovresti poter passare tra le versioni maggiori dei plugin Capgo mentre aggiorni Capacitor senza dover ri scrivere l'integrazione.

Le impostazioni predefinite possono ancora cambiare con una nuova versione maggiore. Recati alle note di rilascio e ai guide di migrazione (vedi aggiornamento di sistema e le guide sotto Migrazioni nella barra laterale dell'aggiornamento) quando aumenti.

CLI e Console utilizzano le proprie versioni

Il Capgo CLI e Capgo Console non condividono le versioni maggiori con i plugin o __CAPGO_KEEP_0__. Non hai bisogno di Capacitor versioni maggiori

perché sei su __CAPGO_KEEP_0__ 8 o aggiornamento Installa sempre o invoca sempre la need CLI major 8 because you are on Capacitor 8 or updater 8.
aggiornamento aggiornamento CLI.
L'ultima CLI e Console rimangono compatibili con qualsiasi versione supportata @capgo/capacitor-updater aggiornamento (e relativo aggiornatore) maggiore.

È sconsigliato bloccare una vecchia CLI versione. Preferisci:

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

Etichette LTS per plugin maggiori precedenti

Quando rimani su una versione maggiore più vecchia di Capacitor, installa il plugin maggiore Capgo 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 delle versioni maggiori precedenti dei plugin sono pubblicate On richiesta.

Updater backports vs altri plugin

Pacchetto	Backport di versioni precedenti maggiori
`@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 segue quel calendario mensile
Altri plugin Capgo	Contesto: Pagina/area: Pagina prodotti/prezzi aziendale. Ruolo: Copia del sito web. Visualizzato in: pagina enterprise.astro. Preservare i termini del prodotto/marca e i termini del developer esattamente. Chiave del messaggio `enterprise_130_plugins` (Plugin aziendali 130).

On demand

Sottosezione intitolata “Stesse funzionalità, versioni numerate riflesse”

If il rilascio più recente è 8.3.4, il Capacitor 7 LTS viene pubblicato con 7.3.4 lo stesso set di funzionalità e correzioni di bug , adattato a quel __CAPGO_KEEP_0__ maggiore.Installa con l'etichetta quando desideri “l'ultimo 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

Sezione intitolata “LTS è un backport dell'ultimo”

(o lts-v7 LTS è un backport dell'ultimo lts-v6rilascio …) è una backport dell'ultima quindi lo stesso lavoro funziona sul precedente Capacitor major.

Poiché segue l'ultima, la linea LTS del pubblico API può cambiare quando l'ultima cambia — anche se il numero maggiore rimane su 7. Trattate la LTS come “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.
Sempre esegui @capgo/cli@latest — CLI major sincronizza con Capacitor/plugin è inutile.
Resta su Capacitor 7 (o versioni precedenti)? Utilizza @lts-v7 (o il tag corrispondente), non una vecchia versione casuale 7.x datata da mesi.
Versiona i propri pacchetti di aggiornamento live 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
CLI panoramica — come eseguire comandi Capgo CLI
Compatibilità nativa context: Pagina/Area: Pagina prodotto di aggiornamento in tempo reale. Ruolo: Etichetta UI breve o elemento di navigazione. Visualizzato in: pagina live-update.astro. Chiave messaggio `live_update_v2_comp_compat_l` (Live Update V2 Comp Compat L).
— quando un cambiamento richiede un binario di magazzino rispetto a un bundle OTA — example of a Capacitor-aligned plugin major upgrade