Tipi di aggiornamento

Capgo supporta diversi tipi di aggiornamenti in tempo reale (OTA). Questa pagina elenca e spiega tutti di loro, in modo che tu possa scegliere la combinazione giusta per la tua app.

Applica il timing

Controlli quando Un aggiornamento viene applicato dopo essere stato scaricato. Il plugin controlla gli aggiornamenti quando l'app si sposta in primo piano e su un timer ripetuto mentre l'app rimane aperta. periodCheckDelay Controlla questo intervallo (impostazione predefinita 10 minuti).

Tipo	Descrizione	Utilizzo
autoUpdate: atBackground	Controlla e scarica su ogni controllo in primo piano, applica quando l'app si sposta in background	La maggior parte degli app; minimo disturbo
autoUpdate: atInstall	Applica immediatamente solo dopo un installazione fresca o aggiornamento di un'app nativa; altrimenti utilizza atBackground	New users get latest; existing users use background apply
autoUpdate: onLaunch	Applica immediatamente solo all'avvio freddo (killed → foreground); quindi ricadere su atBackground	Equilibrio tra freschezza e stabilità della sessione
autoUpdate: always	Controlla ogni volta che si passa a un'altra applicazione e applica immediatamente l'aggiornamento disponibile	Risolvere i problemi critici, app con stato semplice
autoUpdate: onlyDownload	Verifica e scarica automaticamente, emette updateAvailableE mai applicare automaticamente	App che mostrano la propria finestra di aggiornamento o controllano esattamente quando chiamare set()

Configura in capacitor.config.ts:

plugins: {
  CapacitorUpdater: {
    autoUpdate: 'atBackground', // default; true is still accepted
    // or: 'off' | 'atInstall' | 'onLaunch' | 'always' | 'onlyDownload'
  }
}

Tipi

Per ulteriori informazioni e gestione dello schermo di benvenuto, vedi Comportamento dell'aggiornamento.

Condizioni di ritardo

Le condizioni che devono essere soddisfatte prima context: prima di lavorare su una nuova funzionalità. setMultiDelay per combinare (tutte le condizioni devono essere soddisfatte).

Condizione	Descrizione	Esempio
Data	Aspettare fino a una data/ora specifica	Coordina con la versione del server
background	Aspetta un minimo di tempo (ms) dopo che l'app è stata messa in background	Evita di applicare durante scambi di app veloci
nativeVersion	Richiedi una versione minima del binario nativo	Block updates on incompatible native code
kill	Wait until the next app kill event	Applica solo al riavvio completo

import { CapacitorUpdater } from '@capgo/capacitor-updater';

await CapacitorUpdater.setMultiDelay({
  delayConditions: [
    { kind: 'date', value: '2023-06-01T00:00:00.000Z' },
    { kind: 'background', value: '60000' },
  ],
});

Pericolo

Il kill La condizione attiva dopo il primo evento di eliminazione, non l'evento di background come gli altri. Questo verrà risolto in una versione futura.

Blocco di versione (Politica del canale)

Controlla quali aggiornamenti semver Un canale auto-distribuirà. Impostato tramite --disable-auto-update su canali.

Strategia	Blocchi	Consente	Utilizzo
nessuna	Niente	Qualsiasi versione del pacchetto di destinazione	Predefinito; aggiornamento auto completo
maggiore	Aggiornamento maggiore di version_buildper esempio 1.2.3 -> 2.0.0	Con lo stesso numero maggiore, ad esempio 1.2.3 -> 1.9.0 o 1.2.3 -> 1.2.4	Prevenire cambiamenti di rottura da raggiungere vecchie native code
minore	Diverso maggiore o minore di version_build, ad esempio 1.2.3 -> 1.3.0	Lo stesso maggiore e minore, ad esempio 1.2.3 -> 1.2.4	Keep updates inside one native minor line
patch	Qualsiasi cambiamento di numero maggiore, minore o patch, ad esempio 1.0.0 -> 1.0.1	Solo cambiamenti di suffisso mentre MAJOR.MINOR.PATCH rimane identico, ad esempio 1.0.0-beta.1 -> 1.0.0-beta.2 o 1.0.0+build.1 -> 1.0.0+build.2	Modalità più rigorosa: nessuna versione del core aggiornata
metadata	Mancato min_update_version, o version_build Sotto di esso	Bundle di destinazione min_update_version Regole di compatibilità personalizzate per bundle version_build	Regole di compatibilità personalizzate per bundle

, non il bundle scaricato e installato correntemente inviato come version_build, non il bundle attualmente installato scaricato inviato come version_name.

npx @capgo/cli channel set production --disable-auto-update major

Attenzione

patch e metadata richiede una configurazione accurata. Vedi CLI comandi e Tipi di Aggiornamento Sezione intitolata “Tipi di Aggiornamento”

Tipi di distribuzione

al dispositivo. Tipi di Consegna aggiornamento sul dispositivo.

Tipo	Descrizione	Quando utilizzare
Pacco completo	Tutto il pacchetto JS viene scaricato	Prima installazione, grandi modifiche o quando non è disponibile il delta
Delta	Vengono scaricati solo i file modificati	Aggiornamenti standard; più veloci e risparmiatori di banda

# Full bundle (default)
npx @capgo/cli bundle upload --channel production

# Delta updates
npx @capgo/cli bundle upload --channel production --delta

Tip

Quando si utilizza i modi di applicazione istantanea (atInstall, onLaunch, o always), abilita Aggiornamenti Delta to minimize download time and improve UX.

Riferimento rapido

Category	Categoria
Applica il timing	off, atBackground, atInstall, onLaunch, always, onlyDownload
Condizioni di ritardo	date, background, nativeVersion, kill
Aggiornamento di versione	none, major, minor, patch, metadata
Consegna	Consegna completa, Delta

Relativo

• Comportamento dell'aggiornamento — Configura il momento di applicazione e le ritardi
• Target di versione — Routing per canale di versione
• — Scarica solo i file modificati — Scarica solo i file modificati
• Channels — Configurazione e priorità del canale

Continua da Tipi di Aggiornamento

Se stai utilizzando Tipi di Aggiornamento per pianificare la live update consegna, connettilo con Capgo Aggiornamenti in Tempo Reale for the product workflow in Capgo Live Updates, Overview per i dettagli di implementazione nella panoramica Features per i dettagli di implementazione nei Features, Comportamento dell'aggiornamento per il dettaglio di implementazione in Comportamento dell'aggiornamento, e Getting Started per il dettaglio di implementazione in Iniziare.