Tipi di aggiornamento

Capgo supporta diversi tipi di aggiornamenti over-the-air (OTA). Questa pagina elenca e spiega tutti di essi in modo che possiate scegliere la combinazione giusta per il vostro app.

Applica il timing

Controlli quando un aggiornamento viene applicato dopo che è stato scaricato.

Tipo	Descrizione	Utilizzo
Default	Scarica in background, applica quando l'utente chiude il background o uccide l'app	La maggior parte degli app; minima interruzione
directUpdate: atInstall	Applica immediatamente solo all'installazione fresca o aggiornamento dell'app store	Nuovi utenti ricevono la versione più recente; gli utenti esistenti utilizzano il flusso predefinito
directUpdate: onLaunch	Applica immediatamente all'installazione, aggiornamento dell'app store o dopo che l'app è stata uccisa	Equilibrio tra freschezza e stabilità della sessione
directUpdate: always	Applica immediatamente ogni volta che viene scaricata un'aggiornamento (compreso al ripristino)	Risoluzione critica, app con stato semplice

Configura in capacitor.config.ts:

plugins: {
  CapacitorUpdater: {
    directUpdate: false, // default
    // or: 'atInstall' | 'onLaunch' | 'always'
  }
}

Suggerimento

Per dettagli completi e gestione dello schermo di benvenuto, vedi Comportamento dell'aggiornamento.

Condizioni di ritardo

Le condizioni che devono essere soddisfatte prima di un aggiornamento venga installato. Utilizza setMultiDelay per combinare le condizioni (tutte le condizioni devono essere soddisfatte).

Condizione	Descrizione	Esempio
data	Attendere fino a dopo una data/ora specifica	Coordina con la rilascio server-side
background	Attendere un minimo di durata (ms) dopo che l'app è stata backgroundata	Evita di applicare durante scambi di app veloci
versione nativa	Richiedi una versione minima di binario nativo	Blocca gli aggiornamenti su nativi incompatibili code
Uccidi	Attendere l'evento di uccisione dell'applicazione successivo	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 l'evento di uccisione iniziale, non l'evento di background come gli altri. Questo verrà risolto in una futura versione.

Blocco versione (Politica del canale)

Controlla quali aggiornamenti semver un canale consegnerà automaticamente. Impostato tramite --disable-auto-update su canali.

Strategia	Blocchi	Consente	Caso d'uso
nessuno	Niente	Tutte le aggiornamenti	Predefinito; aggiornamento auto completo
maggiore	0.0.0 → 1.0.0	Lo stesso maggiore (ad esempio 1.x → 1.y)	Prevenire cambiamenti di rottura che raggiungono vecchie native
minore	0.0.0 → 1.1.0, 1.1.0 → 1.2.0	Lo stesso minore (ad esempio 1.2.x → 1.2.y)	Controllo più stretto all'interno di una versione maggiore
patch	Qualsiasi cambiamento eccetto il bump di patch	Solo 0.0.311 → 0.0.314	Molto rigidi; aggiornamenti solo di patch
metadati	Aggiornamenti senza min_update_version	Aggiornamenti con metadati di compatibilità espliciti	Regole di compatibilità personalizzate per bundle

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

Attenzione

patch e metadata richiede una configurazione accurata. Vedi CLI comandi e Target di versione per i dettagli.

Tipi di consegna

How the bundle is transferred to the dispositivo. Tipo Descrizione

Quando utilizzare	Tutto il bundle	Tutto il bundle JS viene scaricato
Prima installazione, grandi modifiche o quando il delta non è disponibile	Delta (manifesto)	Solo i file modificati vengono scaricati
Aggiornamenti più frequenti; più veloce e amichevole con la banda	__CAPGO_KEEP_0__	__CAPGO_KEEP_0__

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

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

Suggerimento

Quando si utilizza directUpdate, abilita Aggiornamenti Delta per ridurre il tempo di download e migliorare l'esperienza utente.

Riferimento rapido

Categoria	Tipi
Applica il timing	Predefinito, atInstall, onLaunch, always
Condizioni di ritardo	date, background, nativeVersion, kill
Blocco versione	none, major, minor, patch, metadata
Consegna	Pacco completo, Delta (manifesto)

Relazionato

• Comportamento di aggiornamento — Configura l'applicazione del timing e dei ritardi
• Target di versione — Routing delle versioni basato sui canali
• Aggiornamenti (manifesto) Delta — Abilita download parziale
• Canali — Configurazione e precedenza dei canali