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 pacchetti delle vostre app.

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

Regole rapide

Prodotti	Versionamento maggiore	Note di compatibilità
Capgo plugins	Segui il matching Capacitor major	Versionamento plugin `8` targets Capacitor 8, `7` targets Capacitor 7, and so on
Capgo CLI	Indipendente	Do not sync CLI major with plugins or Capacitor. Always use the latest CLI
Capgo Console	Indipendente	Propria sequenza 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 è la 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 comunque cambiare con una nuova versione maggiore. Recensisci le note di rilascio e le guide di migrazione (vedi l'aggiornamento delle versioni e le guide sotto Migrations nella barra laterale dell'aggiornamento) quando aumenti il numero di versione.

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 versione maggiore

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.
Always install or invoke the latest 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 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 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	context: 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` (Enterprise 130 Plugins).

On demand

Sottosezione intitolata “Stesse funzionalità, versioni numerate riflesse”

If il rilascio più recente è 8.3.4, il Capacitor 7 linea LTS 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 “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 è un backport dell'ultimo”

(o lts-v7 LTS is a backport of latest 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'antica Capacitor e non come un legato legato API per sempre.

Cosa significa per la tua app

Aggiorna i plugin Capgo quando aggiorni i maggiori Capacitor.
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 versione dei pacchetti e i 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 prodotto di aggiornamento in tempo reale. Ruolo: Etichetta breve 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