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 controlli che intervallano (intervallo predefinito 10 minuti).

Tipo	Descrizione	Utilizzo
aggiornamentoAutomatico: atBackground	Controlla e scarica ad ogni controllo in primo piano, applica quando l'app si sposta in background	La maggior parte degli app; minima interruzione
__CAPGO_KEEP_0__ atInstall	Applica immediatamente solo dopo un'installazione fresca o un aggiornamento dell'applicazione nativa; altrimenti utilizza atBackground	Gli utenti nuovi ricevono la versione più recente; gli utenti esistenti utilizzano l'applicazione di sfondo
__CAPGO_KEEP_0__ onLaunch	Applica immediatamente solo al riavvio (killed → foreground); quindi ricade su atBackground	Equilibrio tra freschezza e stabilità della sessione
__CAPGO_KEEP_0__ always	Controlla ogni volta che si passa alla transizione in primo piano e applica immediatamente ogni volta che è disponibile un aggiornamento	Risoluzione critica, app con stato semplice
__CAPGO_KEEP_0__ onlyDownload	Controlla e scarica automaticamente, emiti updateAvailablee mai mai applicare automaticamente	Applicazioni che mostrano il proprio avviso 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 ulteriori dettagli e gestione dello schermo di benvenuto, vedi Comportamento dell'aggiornamento.

Condizioni di ritardo

Le condizioni che devono essere soddisfatte prima del un aggiornamento viene installato. Utilizza setMultiDelay per combinare tutti (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 messa in background	Evita di applicare durante i cambiamenti di app veloci
versione nativa	Richiedi una versione minima del binario nativo	Blocca gli aggiornamenti per il binario nativo incompatibile code
Uccidi	Aspetta 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' },
  ],
});

Pezzo giallo

La kill La condizione attiva dopo l'evento di uccisione iniziale, non l'evento di background successivo. Questo verrà risolto in una versione futura.

Blockaggio di versione (Politica del canale)

Regola quali aggiornamenti semver un canale auto-distribuirà. Impostato tramite --disable-auto-update su canali.

Tattica	Blocchi	Consente	Utilizzo
Area di applicazione: Pagina di marketing delle soluzioni Capgo. Ruolo: Etichetta breve UI o elemento di navigazione. Visualizzato in: pagina soluzioni/cordova-to-capacitor-ai.astro. Chiave messaggio `solutions_cordova_to_capacitor_ai_table_use_case` (Solutions Cordova To Capacitor Ai Table Use Case).	nessuna	Niente	Qualsiasi versione di bundle di destinazione
maggiore	Maggiore superiore rispetto a version_build, ad esempio 1.2.3 -> 2.0.0	Lo stesso maggiore, ad esempio 1.2.3 -> 1.9.0 o 1.2.3 -> 1.2.4	Prevenire le modifiche di rottura da raggiungere le 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	Tenere aggiornamenti all'interno di una linea minore nativa
patch	Qualsiasi cambiamento di numero maggiore, minore o di 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	o
metadata	Manca min_update_version, o version_build al di sotto di esso	La bundle di destinazione di cui min_update_version è inferiore o uguale a version_build	Regole di compatibilità personalizzate per bundle

Queste verifiche confrontano la bundle di destinazione con la baseline nativa inviata come version_build, non la bundle installata scaricata inviata come version_name.

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

Attenzione

patch e metadata e CLI commands __CAPGO_KEEP_0__ comandi e Scegliere la versione

Tipi di consegna

Come il bundle viene trasferito al dispositivo.

Tipo	Descrizione	Quando utilizzare
Bundle completo	Tutto il bundle JS viene scaricato	Prima installazione, grandi modifiche o quando non è disponibile il delta
context: Pagina/Area: Capgo Builder / prodotto di costruzione nativa cloud. Ruolo: Etichetta di navigazione breve o elemento UI. Chiave di messaggio `native_build_builder_credit_first` (Primo credito del costruttore di build nativa).	Solo i file modificati vengono scaricati	Aggiornamenti più comuni; più veloci e amichevoli con la banda

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

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

Suggerimento

Quando si utilizzano modalità di applicazione istantanea (atInstall, onLaunch, o always), abilita Aggiornamenti Delta Aggiornamenti Delta

per ridurre il tempo di download e migliorare l'esperienza utente.

Categoria	Tipi
Applica il timing	off, atBackground, atInstall, onLaunch, always, onlyDownload
Condizioni di ritardo	date, background, nativeVersion, kill
Blocco versione	none, major, minor, patch, metadata
Distribuzione	context: Pagina/area: Pagina prodotti/prezzi aziendale. Ruolo: Etichetta di interfaccia utente. Chiave messaggio `enterprise_delivery_label` (Etichetta di distribuzione aziendale).

Pacco completo, Delta (manifesto)

• Sezione intitolata “Relazionato” Comportamento dell'aggiornamento
• Targeta di Versione – Routing per canale di versione
• Aggiornamenti (manifesto) – Abilita download parziale
• Canaletti – Configurazione e precedenza dei canali

Continua con gli Tipi di Aggiornamento

Se stai utilizzando Tipi di Aggiornamento per pianificare la consegna degli aggiornamenti in tempo reale, connettilo con Aggiornamenti in Tempo Reale Capgo 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 dell'Aggiornamento per i dettagli di implementazione in Comportamento dell'Aggiornamento, e Iniziare per i dettagli di implementazione in Iniziare