Tipi di Aggiornamento

Capgo supporta diversi tipi di aggiornamenti in tempo reale (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 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 di UI o elemento di navigazione. Visto in: pagina soluzioni/cordova-to-capacitor-ai.astro. Chiave del messaggio `solutions_cordova_to_capacitor_ai_table_use_case` (Solutions Cordova To Capacitor Ai Table Use Case). 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 la versione più recente; gli utenti esistenti utilizzano l'aggiornamento 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 quando è disponibile un aggiornamento	Risolvere le criticità, 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 dettagli completi e gestione dello schermo di benvenuto, vedi Comportamento dell'aggiornamento.

Condizioni di ritardo

Condizioni che devono essere soddisfatte prima del rilascio di un nuovo aggiornamento, si deve prima discutere e creare un issue sul progetto, prima di iniziare a lavorare su di esso, come descritto nella sezione ‘Create An Issue And Discuss Before Working On A New Feature’ del nostro sito web di marketing. | Si deve prima discutere e creare un issue sul progetto, prima di iniziare a lavorare su di esso, come descritto nella sezione ‘Mention Issue Before Working’ del nostro sito web di marketing. Un aggiornamento viene installato. Utilizza setMultiDelay per combinare tutti (tutti i requisiti devono essere soddisfatti).

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 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 del primo, 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.

Tattica	Blocchi	Consente	Utilizzo
Contesto: Pagina/area: Pagina di marketing delle soluzioni Capgo. Ruolo: Etichetta breve UI o elemento di navigazione. Visualizzato in: pagina solutions/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 del pacchetto 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 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 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	Assente 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	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 Richiede una configurazione accurata. Vedi __CAPGO_KEEP_0__ comandi e

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
contexto: Pagina/area: Capgo Builder / prodotto di costruzione nativa cloud. Ruolo: Etichetta di navigazione o elemento UI breve. Chiave di messaggio `native_build_builder_credit_first` (Primo credito del costruttore di build nativo).	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 per ridurre il tempo di download e migliorare l'esperienza utente.

Riferimento rapido

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
• Target di Versione – Routing della versione basato sul canale
• 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