Tipi di Aggiornamento

Capgo supporta diversi tipi di aggiornamenti in tempo reale (OTA). Questa pagina elenca e spiega tutti di loro in modo che possiate scegliere la combinazione giusta per il vostro 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 l'intervallo (impostazione predefinita 10 minuti).

Tipo	Descrizione	Utilizzo
contexto: Pagina/area: Pagina di marketing delle soluzioni Capgo. Ruolo: Etichetta breve o elemento di navigazione. Visualizzato in: pagina soluzioni/cordova-to-capacitor-ai.astro. Chiave del messaggio `solutions_cordova_to_capacitor_ai_table_utilizzo` (Solutions Cordova To Capacitor Ai Table Utilizzo). atBackground	autoUpdate: "Controlla e scarica su ogni controllo in primo piano, applica quando l'app si sposta in background"	La maggior parte degli app; minima interruzione
autoUpdate: atInstall	Applica immediatamente solo dopo un'installazione fresca o un aggiornamento dell'applicazione nativa; altrimenti utilizza atBackground	Nuovi utenti ricevono l'ultima versione; gli utenti esistenti utilizzano l'applicazione in background
autoUpdate: onLaunch	Applica immediatamente solo al riavvio (killed → foreground); quindi ricade su atBackground	Equilibrio tra freschezza e stabilità della sessione
autoUpdate: always	Controlla ogni transizione in primo piano e applica immediatamente ogni volta che è disponibile un aggiornamento	Ricambi critici, app con stato semplice
autoUpdate: onlyDownload	Controlla e scarica automaticamente, emetti updateAvailablee mai mai applicare automaticamente	Applicazioni 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 ulteriori dettagli e gestione dello schermo di benvenuto, vedere Comportamento dell'aggiornamento.

Condizioni di ritardo

Condizioni che devono essere soddisfatte prima del Un aggiornamento viene installato. Utilizza setMultiDelay per combinare questi (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 è in background	Evita di applicare durante scambi veloci di app
Versione nativa	Richiedi una versione minima di binario nativo	Blocca gli aggiornamenti per il binario nativo incompatibile code
kill	Attendi 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.

Blocco di versione (Politica del canale)

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

Sistema	Blocchi	Consente	Utilizzo
Contesto	nessuna	Nessuna	Qualsiasi versione del pacchetto di destinazione
aggiornamento maggiore	Maggiore di 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 i cambiamenti di rotta 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	Tenere gli 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 le modifiche ai suffissi 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 il cui min_update_version è uguale o inferiore a version_build	Le regole di compatibilità personalizzate per bundle

Queste verifiche confrontano la bundle di destinazione con la baseline nativa inviata come version_build, non la bundle scaricata e installata attualmente 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 Target di 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	Tutti gli aggiornamenti; 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), abilitare Aggiornamenti delta context: Pagina/area: Pagina prodotti/prezzi aziendale. Ruolo: Etichetta UI breve o elemento di navigazione. Visualizzato in: pagina enterprise.astro. Chiave messaggio `enterprise_delta_updates` (Aggiornamenti Delta Aziendale).

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	Bundle completo, Delta (manifesto)

Relazionato

• Comportamento dell'aggiornamento – Configura il timing di applicazione e i ritardi
• Target di Versione — Routing per canale di versione
• Delta (manifesto) Aggiornamenti — Abilita download parziale
• Canali — 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 workflow del prodotto in Capgo Live Updates 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