Tipi di aggiornamento

Capgo supporta diversi tipi di aggiornamenti over-the-air (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.

Tipo	Descrizione	Utilizzo
autoUpdate: atBackground	Scarica in background, applica quando l'utente chiude o uccide l'app	La maggior parte degli app; minimo disturbo
autoUpdate: 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
autoUpdate: onLaunch	Applica immediatamente all'installazione, aggiornamento dell'app store o dopo l'uccisione dell'app	Equilibrio tra freschezza e stabilità della sessione
autoUpdate: always	Applica immediatamente ogni volta che viene scaricata un'aggiornamento (incluso al ripristino)	Risposte critiche, app con stato semplice
autoUpdate: onlyDownload	Scarica automaticamente e emetta updateAvailablema non applica mai o imposta il prossimo pacchetto 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'
  }
}

Suggerimento

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

Condizioni di ritardo

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

Condizione	Descrizione	Esempio
data	Attendi fino a una data/ora specifica	Coordina con la versione server-side
background	Attendi un minimo di durata (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	Blocca gli aggiornamenti su nativi incompatibili code
kill	Attendi fino al prossimo evento di uccisione dell'app	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 uccisione, non il prossimo sfondo come gli altri. Questo verrà risolto in una futura versione.

Blocco Versione (Politica del Canale)

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

Strategia	Blocca	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 i cambiamenti di rotta da raggiungere le native vecchie
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 del maggiore
patch	Qualsiasi cambiamento eccetto patch bump	Solo 0.0.311 → 0.0.314	Aggiornamenti molto rigorosi; solo patch
metadata	Aggiornamenti senza min_update_version	Aggiornamenti con metadata di compatibilità esplicita	Regole di compatibilità personalizzate per bundle

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

Attenzione

patch e richiede una configurazione accurata. Vedi metadata __CAPGO_KEEP_0__ comandi CLI commands Versione di destinazione per i dettagli. Tipi di consegna

Sezione intitolata “Tipi di consegna”

bundle viene trasferito al dispositivo. Tipo

Delivery Types	Descrizione	Quando utilizzare
Pacco completo	Tutto il pacchetto JS viene scaricato	Prima dell'installazione, grandi modifiche o quando non è disponibile il delta
Delta (manifesto)	Sono scaricati solo i file modificati	La maggior parte degli aggiornamenti; più veloce e amichevole per la banda

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

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

Consiglio

When si utilizzano modalità di applicazione istantanea (atInstall, onLaunch, o always), abilita Aggiornamenti Delta per minimizzare il tempo di download e migliorare l'esperienza utente.

Riferimento rapido

Categoria	Tipi
Tempistica di applicazione	off, atBackground, atInstall, onLaunch, always, onlyDownload
Condizioni di ritardo	date, background, nativeVersion, kill
Blocco versione	none, major, minor, patch, metadata
Consegna	Pacco completo, Delta (manifesto)

Relazionato

• Aggiornamento del comportamento — Configura il timing e le ritardate dell'applicazione
• Target di versione — Routing delle versioni basato sui canali
• Aggiornamenti del manifesto Delta — Abilita download parziali
• Canali — Configurazione e precedenza dei canali

Continua da Tipi di Aggiornamento

Se stai utilizzando Tipi di Aggiornamento per pianificare la consegna di aggiornamenti in tempo reale, connettilo con Capgo Aggiornamenti in Tempo Reale per il flusso di lavoro del prodotto in Capgo Aggiornamenti in Tempo Reale, Panoramica per i dettagli di implementazione in Panoramica, Caratteristiche per i dettagli di implementazione in Caratteristiche Comportamento di Aggiornamento per i dettagli di implementazione in Update Behavior, e Iniziare per i dettagli di implementazione in Iniziare.