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 impatto
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, salva l'aggiornamento o dopo la chiusura dell'app	Equilibrio tra freschezza e stabilità della sessione
autoUpdate: always	Applica immediatamente ogni volta che viene scaricato un aggiornamento (incluso al ripristino)	Risoluzione critica, app con stato semplice
autoUpdate: onlyDownload	Scarica automaticamente e emetti 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'
  }
}

Tip

Per ulteriori dettagli e gestione dello schermo di benvenuto, vedi Aggiornamento del comportamento.

Condizioni di ritardo

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

Condizione	Descrizione	Esempio
data	Attendere fino a una data specifica/ora	Coordina con la versione server-side
background	Attendere 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	Attendere fino all'evento di uccisione dell'app successiva	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

La kill La condizione attiva dopo il primo evento di uccisione, non il prossimo evento di background come gli altri. Ciò verrà risolto in una versione futura.

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	Qualsiasi versione del bundle di destinazione	Predefinito; aggiornamento auto completo
maggiore	Maggiore di maggiore version_build, ad esempio 1.2.3 -> 2.0.0	esempio 1.2.3 -> 1.9.0 o 1.2.3 -> 1.2.4	Prevent breaking changes from raggiungere vecchie native code
minore	Different major or minore di version_build, ad esempio 1.2.3 -> 1.3.0	Lo stesso major e minore, ad esempio 1.2.3 -> 1.2.4	Mantieni gli aggiornamenti all'interno di una linea minore nativa
patch	Qualsiasi numero di major, minore o patch, ad esempio 1.0.0 -> 1.0.1	Solo le modifiche 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 in movimento
metadata	Assente min_update_version, o version_build al di sotto di esso	Pacchetto di destinazione il cui min_update_version è inferiore o uguale a version_build	Regole di compatibilità personalizzate per pacchetto

Queste verifiche confrontano il pacchetto di destinazione con la baseline nativa inviata come version_build, non il pacchetto 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 Target di Versione per i dettagli.

Tipi di consegna

Come il bundle viene trasferito al dispositivo.

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

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

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

Consiglio

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

Riferimento rapido

Categoria	Tipi
Modalità 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)

Relativo

• Comportamento dell'aggiornamento — Configura l'applicazione del timing e dei ritardi
• Targeting della versione — Routing della versione basato sul canale
• Aggiornamenti Delta (manifesto) — Abilita download parziale
• Canali — Configurazione e priorità dei canali

Continua da Tipi di Aggiornamento

Se stai utilizzando Tipi di Aggiornamento per pianificare la consegna degli 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 Features, Aggiorna il comportamento per i dettagli di implementazione in Aggiorna il comportamento, e Inizia a utilizzare per i dettagli di implementazione in Inizia a utilizzare.