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 inviamo — la stessa pratica che consigliamo per le tue proprie raccolte di app.

Questa pagina spiega come quelle 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 rapide

Prodotti	Versionamento principale	Note di compatibilità
Scarica gli estensioni Capgo	Segui il matching Versionamento principale Capacitor	Versionamento plugin `8` Obiettivi Capacitor 8, `7` Obiettivi Capacitor 7, e così via
Capgo CLI	Indipendente	Non sincronizzare il versionamento principale CLI con le estensioni o Capacitor. Utilizza sempre la versione più recente CLI
Capgo Console	Indipendente	Ciclo di rilascio autonomo; compatibile con le versioni del plugin di aggiornamento supportate

I plugin seguono le versioni maggiori di Capacitor

Ogni plugin Capgo di livello maggiore segue il livello 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 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 ricompilare la tua integrazione.

Le impostazioni predefinite possono ancora cambiare con una nuova versione maggiore. Recati alle note di rilascio e ai guide di migrazione (vedi l'aggiornamento dell'aggiornatore 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 versioni maggiori

perché sei su __CAPGO_KEEP_0__ 8 o aggiornamento. Installa sempre o invoca la versione need CLI major 8 because you are on Capacitor 8 or updater 8.
più recente più recente 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 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 maggiori dei plugin 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 è su quel calendario mensile
Altri plugin Capgo	Contesto: Pagina/area: Pagina prodotti/prezzi aziendale. Ruolo: Testo 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` (Enterprise 130 Plugins).

On demand

Sottosezione intitolata “Stesse funzionalità, versioni numerate riflesse”

If il rilascio più recente è 8.3.4, il Capacitor linea LTS viene pubblicata con 7.3.4 con lo stesso set di funzionalità e correzioni di bug , adattata a quella __CAPGO_KEEP_0__ versione maggiore.Installa con l'etichetta quando desideri “l'ultimo per questa Capacitor versione 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 LTS is a backport of latest 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 legato API 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 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 prodotti di aggiornamento in tempo reale. Ruolo: Etichetta breve di elemento UI 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