Comportamento di Aggiornamento

When you rilasciare un aggiornamento per il tuo Capgo app, probabilmente desideri che i tuoi utenti ricevano quell'aggiornamento il prima possibile. Ma non vuoi anche interrompere la loro esperienza facendo aspettare per il download o riavviare l'app nel mezzo di una sessione.

Capgo's comportamento di aggiornamento è progettato per trovare un equilibrio tra la consegna degli aggiornamenti velocemente e la minimizzazione della interruzione per i tuoi utenti.

Flusso di Aggiornamento Predefinito

Di default, ecco come Capgo gestisce gli aggiornamenti dell'app:

1. When l'app si sposta in primo piano, il plugin Capgo controlla per vedere se è disponibile un nuovo aggiornamento. Mentre l'app rimane aperta, controlla nuovamente ogni volta che scade il timer ripetuto controllato da periodCheckDelay (10 minuti di default).

2. Se è stato trovato un aggiornamento, viene scaricato in background mentre l'utente continua ad utilizzare la versione corrente dell'app.

3. Una volta completata la download, Capgo attende che l'utente metta l'app in background.

4. Quando l'utente riporta l'app in primo piano, eseguirà la versione aggiornata.

Questo flusso garantisce che gli utenti stiano sempre eseguendo la versione più aggiornata dell'app, senza mai essere interrotti da richieste di aggiornamento o costretti a attendere i download.

Consiglio

Capgo controlla gli aggiornamenti ogni volta che l'app si sposta in primo piano e su un timer ripetuto mentre l'app rimane aperta. periodCheckDelay controlla l'intervallo (impostazione predefinita 10 minuti).

Perché Questo Approccio?

L'applicazione degli aggiornamenti su un evento di background o di chiusura ha alcuni benefici chiave per l'esperienza utente:

• Gli utenti non sono interrotti da richieste di aggiornamento o costretti a attendere i download in mezzo a una sessione.

• Gli aggiornamenti vengono applicati in modo trasparente tra le sessioni, quindi l'esperienza di avvio dell'app è sempre fresca.

• Potete distribuire aggiornamenti frequenti senza preoccuparvi di interrompere gli utenti attivi.

Il principale svantaggio è che se un utente mette in background e ripristina velocemente la vostra app, potrebbe perdere lo stato non salvato poiché l'aggiornamento è stato applicato tra quelle azioni.

Per mitigare questo, raccomandiamo:

• Salvare lo stato frequentemente e ripristinarlo con grazia quando l'app riprende.

• Evitare aggiornamenti molto frequenti che modificano parti grandi dello stato dell'app.

• Considerare la personalizzazione del comportamento dell'aggiornamento per flussi sensibili (vedi di seguito).

Personalizzare Quando gli Aggiornamenti Vengono Applicati

In alcuni casi, potreste volere più controllo sulla precisione esatta quando un aggiornamento viene applicato. Ad esempio, potreste voler assicurarvi che un utente completi un flusso in corso prima di aggiornare, o coordinare un aggiornamento dell'app con un cambiamento server-side.

Capgo fornisce una setDelay funzione che vi consente di specificare le condizioni che devono essere soddisfatte prima che un aggiornamento venga installato:

import { CapacitorUpdater } from '@capgo/capacitor-updater';

await CapacitorUpdater.setMultiDelay({
  delayConditions: [
    {
      kind: 'date',
      value: '2023-06-01T00:00:00.000Z',
    },
    {
      kind: 'background',
      value: '60000',
    },
  ],
});

Esempio: questo aggiornamento verrà installato solo dopo il 1 giugno 2023 E l'applicazione sarà stata messa in background per almeno 60 secondi.

Il condizionale disponibili sono:

• date: Attendere fino a una data/ora specifica per applicare l'aggiornamento.
• background: Attendere un minimo di durata dopo che l'applicazione è stata messa in background per applicare l'aggiornamento.
• nativeVersion: Attendere l'installazione di un binario nativo con una versione minima prima di applicare l'aggiornamento.
• kill: Attendere fino all'evento di uccisione dell'applicazione successivo per applicare l'aggiornamento.

È possibile combinare e miscelare questi condizionali per controllare con precisione quando viene installato l'aggiornamento.

Pericolo

Nota che il kill condizionale attualmente attiva l'aggiornamento dopo l'evento di uccisione iniziale, non l'evento di background successivo come gli altri condizionali. Questa incongruenza verrà risolta in una versione futura.

Applicare Aggiornamenti Subito

Per gli aggiornamenti critici o le app con uno stato molto semplice, potresti voler applicare un aggiornamento non appena è stato scaricato, senza attendere un evento di background o di chiusura. Capgo supporta questo tramite la autoUpdate politica nella tua Capacitor config.

Richiesto per l'applicazione istantanea: --delta, autoSplashscreen e SplashScreen

"atInstall", "onLaunch", e "always" applica l'aggiornamento mentre l'utente è in attesa. Utilizza Aggiornamenti Delta (manifesto) così che solo i file modificati vengono scaricati. L'upload di un file zip completo rallenta l'esperienza dell'utente.

Questi modi richiedono @capacitor/splash-screen e autoSplashscreen: true con SplashScreen.launchAutoHide: false. Senza il plugin splash, l'utente può vedere un lampo o un'interfaccia utente obsoleta mentre l'aggiornamento si applica.

Quando autoUpdate è impostato "atInstall", "onLaunch", o "always" nel tuo capacitor.config, il CLI lo rileva. In ambienti non interattivi invia automaticamente gli aggiornamenti Delta (manifesto), e in ambienti interattivi ti chiede di confermare prima di caricare. Il configurazione legacy è ancora rilevata. Utilizza directUpdate per forzare l'upload di un bundle completo. --no-delta Finestra del terminale

npx @capgo/cli@latest bundle upload --delta

autoUpdate file, non nel JavaScript __CAPGO_KEEP_0__. Supporta questi valori: capacitor.config.ts file, not in JavaScript code. It supports these values:

• false o 'off': Disabilita le verifiche automatiche degli aggiornamenti
• true o 'atBackground' : Aggiorna automaticamente e scarica ogni volta che l'app è in primo piano
• 'atInstall': Aggiorna immediatamente solo dopo un'installazione fresca o un aggiornamento dell'applicazione nativa; altrimenti utilizza "atBackground" comportamento
• 'onLaunch': Aggiorna immediatamente solo quando l'app viene riportata in primo piano da uno stato ucciso (avvio freddo). Dopo la prima verifica, ricade su "atBackground" comportamento
• 'always': Verifica ogni volta che l'app passa in primo piano e applica immediatamente quando è disponibile un aggiornamento
• 'onlyDownload': Verifica e scarica automaticamente, emette updateAvailable, e non impostare mai il prossimo pacchetto o applicare un aggiornamento automaticamente

Testa una costruzione nativa senza aggiornamenti in tempo reale

Vedi Testa le costruzioni native senza aggiornamenti in tempo reale per le salvaguardie di configurazione nativa-versione, politica di canale e CI.

import { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: 'always', // or 'atInstall' for updates only on app install/update
      autoSplashscreen: true,
      keepUrlPathAfterReload: true,
    },
    SplashScreen: {
      launchAutoHide: false, // Required for instant apply with autoSplashscreen
    },
  },
};

export default config;

Nota

Importante: i modi di applicazione istantanea applicano gli aggiornamenti solo quando il plugin controlla effettivamente per loro. Di default, le verifiche vengono eseguite quando l'app si sposta in primo piano e su un timer ripetitore mentre l'app rimane aperta. periodCheckDelay controlla quell'intervallo (di default 10 minuti).

Con autoUpdate: 'always', Capgo controlla ogni transizione in primo piano e applica immediatamente un aggiornamento non appena la download si completa durante quel controllo, anche se l'utente sta utilizzando attivamente l'app. Le verifiche periodiche sono controllate da periodCheckDelay possono attivare lo stesso comportamento di applicazione immediata mentre l'applicazione rimane aperta.

Nota che poiché autoUpdate è una configurazione nativa, i modi di applicazione istantanea richiedono alcune ulteriori gestione nel tuo JavaScript code.

Preavviso

I modi di applicazione istantanea richiedono @capacitor/splash-screen e autoSplashscreen: truecontext: Pagina/Area: Sito web di marketing Capgo. Ruolo: Etichetta breve o elemento di navigazione. Visto in: pagina trust.astro. Chiave messaggio `e` (E). launchAutoHide: false . Impostare

in la configurazione SplashScreen (come mostrato sopra) affinché lo schermo di benvenuto rimanga visibile fino a quando l'aggiornamento non si conclude.

If you want Capgo to check and download updates automatically but never apply them automatically, use autoUpdate: 'onlyDownload':

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: 'onlyDownload',
    },
  },
};

In questo modo, il plugin emette updateAvailable dopo che è stato scaricato un bundle. La tua app può quindi decidere quando chiamare CapacitorUpdater.set() o mostrare il proprio avviso di aggiornamento.

Gestione automatica dello schermo di benvenuto

Modalità di applicazione istantanea ("atInstall", "onLaunch", "always") richiedono autoSplashscreen e @capacitor/splash-screen disponibile dalla versione 7.6.0. Installa il plugin, quindi mantieni visibile lo schermo di benvenuto fino a quando Capgo lo nasconde:

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: 'always', // or 'atInstall'
      autoSplashscreen: true, // Automatically hide splashscreen
      keepUrlPathAfterReload: true,
    },
    SplashScreen: {
      launchAutoHide: false,
    },
  },
};

Quando autoSplashscreen è abilitato:

• Il plugin nasconde automaticamente lo schermo di benvenuto quando viene applicata un'aggiornamento
• Il plugin nasconde automaticamente lo schermo di benvenuto quando non è necessario un aggiornamento
• Non è necessario ascoltare manualmente per appReady o chiamare SplashScreen.hide()

Lavoro extra dopo lo schermo si nasconde

Conserva autoSplashscreen: true. Se hai bisogno di logica extra dopo che l'aggiornamento è pronto, ascolta anche appReady e non saltare il plugin dello schermo o autoSplashscreen per questo:

import { CapacitorUpdater } from '@capgo/capacitor-updater';

CapacitorUpdater.addListener('appReady', () => {
  // Update is applied. autoSplashscreen already hid the splash.
});

CapacitorUpdater.notifyAppReady();

La appReady l'evento si attiva una volta che l'app ha completato l'inizializzazione e l'applicazione di eventuali aggiornamenti in sospeso.

Impostare keepUrlPathAfterReload a true context":"Page/area: Pagina prodotto live updates. Ruolo: Etichetta breve UI o elemento di navigazione. Chiave di messaggio `live_update_dynamic_label_to` (Etichetta dinamica di aggiornamento live)."

quando si utilizza un modello di applicazione istantanea. Ciò preserva la cartella URL corrente quando l'app viene riavviata a causa di un aggiornamento.

• Utilizzare un modello di applicazione istantanea può essere utile per fornire correzioni di bug critici o patch di sicurezza, ma ciò comporta alcuni compromessi: @capacitor/splash-screen Lo utente potrebbe vedere un breve scintillio o stato di caricamento mentre l'aggiornamento viene applicato se autoSplashscreen è mancante o
• non è abilitato.
• Se l'aggiornamento modifica lo stato dell'app o l'interfaccia utente, lo utente potrebbe vedere un cambiamento disorientante in mezzo a una sessione. keepUrlPathAfterReload L'utente potrebbe perdere la posizione nell'app se
• Deve gestire con cura il salvataggio e il ripristino dello stato per garantire una transizione fluida.

Se abiliti l'applicazione istantanea, consigliamo:

• Caricare con npx @capgo/cli@latest bundle upload --delta così che il download non rallenti l'esperienza utente.
• Installare @capacitor/splash-screen e impostare autoSplashscreen: true con launchAutoHide: false.
• Impostare keepUrlPathAfterReload a true per preservare la posizione dell'utente nell'app.
• Salvare e ripristinare lo stato dell'app quando necessario per evitare la perdita del progresso dell'utente.
• Testare approfonditamente il comportamento dell'aggiornamento dell'app per assicurarsi che non ci siano transizioni brusche, stato perso o cambiamenti di posizione disorientanti.

In la maggior parte dei casi, il comportamento di aggiornamento predefinito fornisce il miglior equilibrio tra la consegna degli aggiornamenti in modo rapido e la minimizzazione della interruzione. Ma per le app con esigenze specifiche, Capgo fornisce la flessibilità per personalizzare quando e come gli aggiornamenti vengono applicati.

Continua da Aggiornamento del comportamento

Aggiornamento del comportamento per pianificare la consegna degli aggiornamenti in tempo reale, connettilo con __CAPGO_KEEP_0__ Aggiornamenti in tempo reale Capgo Live Updates 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, Tipi di aggiornamento per i dettagli di implementazione in Tipi di aggiornamento, e Iniziare per i dettagli di implementazione in Iniziare.