Versioning

Copia un prompt di configurazione con i passaggi 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 attraverso i majors, e come bloccare versioni più vecchie di Capacitor con tag LTS.

Regole rapide

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 cadenza di rilascio; compatibile con le versioni del plugin di aggiornamento supportate

Il plugin segue le versioni maggiori di Capacitor

Ogni plugin Capgo di livello maggiore segue il livello maggiore Capacitor per cui è 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 quel momento che possiamo modificare le impostazioni predefinite se una nuova impostazione predefinita è una scelta migliore a lungo termine per quella generazione di Capacitor.

la 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 per tutti (ad esempio una richiesta di piattaforma Capacitor che costringe lo stesso break su tutti i consumatori). In genere dovresti poter passare tra i plugin maggiori Capgo mentre aggiorni Capacitor senza dover ri scrivere l'integrazione.

Le impostazioni predefinite possono ancora cambiare con una nuova versione maggiore. Recensisci le note di rilascio e le guide di migrazione (vedi l'aggiornamento delle versioni Ecco le guide sotto Migrazioni nella barra laterale dell'aggiornamento) quando aumenti il numero di versione.

Ecco 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 di una versione maggiore

perché sei su __CAPGO_KEEP_0__ 8 o aggiornamento. Installa sempre o invoca sempre la versione più recente. need CLI major 8 because you are on Capacitor 8 or updater 8.
Installa sempre la versione più recente. Invoca sempre la versione più recente. CLI.
L'ultima CLI e Console rimane compatibile con qualsiasi versione supportata @capgo/capacitor-updater (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 più vecchia di Capacitor, installa il plugin maggiore Capgo con un'etichetta dist-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 di plugin maggiori precedenti vengono 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 quella cadenza mensile
Altri plugin Capgo	context: Pagina/Area: Pagina prodotti/prezzi aziendale. Ruolo: Copia del sito web. Visualizzato in: pagina enterprise.astro. Preservare esattamente i termini del prodotto/marca e i termini del developer. Chiave di messaggio `enterprise_130_plugins` (Enterprise 130 Plugins).

On demand

Sottosezione intitolata “Stesse funzionalità, versioni numeriche riflesse”

If il rilascio più recente è 8.3.4, il Capacitor 7 LTS linea viene pubblicata con 7.3.4 con lo stesso set di funzionalità e correzioni di bug , adattata a quella __CAPGO_KEEP_0__ maggiore.Installa con l'etichetta quando desideri “l'ultimo per questa 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 è una backport dell'ultimo”

(o lts-v7 Install with the tag when you want “latest for this __CAPGO_KEEP_0__ major”: lts-v6rilascio …) è una una versione aggiornata della versione più recente quindi lo stesso lavoro funziona sulla versione precedente Capacitor maggiore.

Poiché segue la versione più recente, la linea LTS del pubblico API può cambiare quando la versione più recente cambia — anche se il numero maggiore rimane su 7. Trattate la LTS come il comportamento ‘attuale Capgo su un vecchio Capacitor’, non come un legato legato API per sempre.

Cosa significa per il tuo app

Aggiorna Capgo plugin quando aggiorni Capacitor maggiori.
Esegui sempre @capgo/cli@latest — sincronizza CLI maggiore 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 versioning 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 Capgo CLI comandi
Compatibilità nativa context: Pagina/Area: Pagina prodotti di aggiornamento in tempo reale. Ruolo: Etichetta o elemento di navigazione breve. 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