Comportamento di aggiornamento

Quando rilasci un aggiornamento della tua app Capgo, probabilmente vuoi che i tuoi utenti lo ricevano il prima possibile. Ma non vuoi nemmeno interrompere la loro esperienza costringendoli ad attendere un download o riavviare l’app nel mezzo di una sessione.

Il comportamento di aggiornamento di Capgo è progettato per trovare un equilibrio tra la distribuzione rapida degli aggiornamenti e la minimizzazione delle interruzioni per i tuoi utenti.

Flusso di Aggiornamento Predefinito

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

1. All’avvio dell’app, il plugin Capgo verifica se è disponibile un nuovo aggiornamento

2. Se viene trovato un aggiornamento, viene scaricato in background mentre l’utente continua a utilizzare la versione corrente dell’app

3. Una volta completato il download, Capgo attende che l’utente metta l’app in background o la chiuda completamente

4. Quando l’utente avvia nuovamente l’app, utilizzerà la versione aggiornata

Questo flusso garantisce che gli utenti utilizzino sempre l’ultima versione della tua app, senza mai essere interrotti da prompt di aggiornamento o costretti ad attendere i download.

Suggerimento

Capgo controlla anche gli aggiornamenti quando l’app riprende dal background, quindi gli utenti riceveranno gli aggiornamenti anche se non chiudono completamente l’app

Perché Questo Approccio?

L’applicazione degli aggiornamenti in background o alla chiusura ha diversi vantaggi chiave per l’esperienza utente:

• Gli utenti non vengono interrotti da prompt di aggiornamento o costretti ad attendere i download durante una sessione

• Gli aggiornamenti vengono applicati senza problemi tra le sessioni, quindi l’esperienza di avvio dell’app è sempre nuova

• Puoi distribuire aggiornamenti frequentemente senza preoccuparti di interrompere gli utenti attivi

Lo svantaggio principale è che se un utente mette in background e riprende rapidamente la tua app, potrebbe perdere qualsiasi stato non salvato poiché l’aggiornamento è stato applicato tra queste azioni.

Per mitigare questo, raccomandiamo di:

• Salvare lo stato frequentemente e ripristinarlo correttamente quando l’app riprende

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

• Considerare la personalizzazione del comportamento di aggiornamento per i flussi sensibili (vedi sotto)

Personalizzazione dell’Applicazione degli Aggiornamenti

In alcuni casi, potresti volere più controllo su quando viene applicato un aggiornamento. Ad esempio, potresti voler assicurarti che un utente completi un flusso in corso prima dell’aggiornamento, o coordinare un aggiornamento dell’app con una modifica lato server.

Capgo fornisce una funzione setDelay che ti permette 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',
    },
  ],
});

Questo esempio ritarderebbe l’installazione di un aggiornamento fino a dopo il 1° giugno 2023 E l’app è stata in background per almeno 60 secondi.

Le condizioni di ritardo disponibili sono:

• date: Attendi fino a dopo una data/ora specifica per applicare l’aggiornamento
• background: Attendi una durata minima dopo che l’app è stata messa in background per applicare l’aggiornamento
• nativeVersion: Attendi che sia installata una versione binaria nativa con una versione minima prima di applicare l’aggiornamento
• kill: Attendi fino al prossimo evento di chiusura dell’app per applicare l’aggiornamento

Puoi combinare queste condizioni per controllare precisamente quando viene installato un aggiornamento.

Pericolo

Nota che la condizione kill attualmente attiva l’aggiornamento dopo il primo evento di chiusura, non il prossimo evento di background come le altre condizioni. Questa inconsistenza sarà corretta in una versione futura

Applicazione Immediata degli Aggiornamenti

Per aggiornamenti critici o app con stato molto semplice, potresti voler applicare un aggiornamento non appena viene scaricato, senza attendere un evento di background o chiusura. Capgo supporta questo tramite l’opzione di configurazione directUpdate.

directUpdate viene impostato nel tuo file capacitor.config.ts, non nel codice JavaScript:

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

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: true,
      directUpdate: true,
    },
  },
  keepUrlPathAfterReload: true,
};

export default config;

Con directUpdate abilitato, Capgo applicherà immediatamente un aggiornamento non appena il download è completato, anche se l’utente sta attivamente utilizzando l’app.

Nota che poiché directUpdate è una configurazione nativa, richiede alcune gestioni aggiuntive nel tuo codice JavaScript.

Quando usi directUpdate, devi ascoltare l’evento appReady e nascondere la schermata di splash della tua app in risposta:

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

CapacitorUpdater.addListener('appReady', () => {
  // Nascondi la schermata di splash
  SplashScreen.hide();
});

CapacitorUpdater.notifyAppReady();

L’evento appReady si attiva una volta che l’app ha finito di inizializzare e applicare eventuali aggiornamenti in sospeso. Questo è il momento in cui è sicuro mostrare l’interfaccia utente della tua app, poiché assicura che l’utente vedrà l’ultima versione.

Oltre a gestire l’evento appReady, raccomandiamo di impostare l’opzione di configurazione keepUrlPathAfterReload su true quando si usa directUpdate. Questo preserva il percorso URL corrente quando l’app viene ricaricata a causa di un aggiornamento, aiutando a mantenere la posizione dell’utente nell’app e riducendo il disorientamento.

Se non gestisci l’evento appReady e non imposti keepUrlPathAfterReload quando usi directUpdate, l’utente potrebbe vedere brevemente una versione obsoleta dell’app, essere riportato al percorso iniziale, o vedere uno sfarfallio mentre l’aggiornamento viene applicato.

L’uso di directUpdate può essere utile per distribuire correzioni di bug critici o patch di sicurezza, ma comporta alcuni compromessi:

• L’utente potrebbe vedere un breve sfarfallio o stato di caricamento mentre l’aggiornamento viene applicato se non gestisci correttamente l’evento appReady
• Se l’aggiornamento modifica lo stato dell’app o l’interfaccia utente, l’utente potrebbe vedere un cambiamento dirompente nel mezzo di una sessione
• La posizione dell’utente nell’app potrebbe essere persa se keepUrlPathAfterReload non è impostato, potenzialmente disorientandolo
• Dovrai gestire attentamente il salvataggio e il ripristino dello stato per garantire una transizione fluida

Se abiliti directUpdate, raccomandiamo di:

• Gestire l’evento appReady per controllare quando viene mostrata l’interfaccia utente della tua app
• Impostare keepUrlPathAfterReload su true per preservare la posizione dell’utente nell’app
• Salvare e ripristinare lo stato dell’app secondo necessità per evitare di perdere i progressi dell’utente
• Testare accuratamente il comportamento di aggiornamento della tua app per assicurarti che non ci siano transizioni brusche, stati persi o cambiamenti di posizione disorientanti

Nella maggior parte dei casi, il comportamento di aggiornamento predefinito fornisce il miglior equilibrio tra la distribuzione rapida degli aggiornamenti e la minimizzazione delle interruzioni. Ma per app con esigenze specifiche, Capgo fornisce la flessibilità di personalizzare quando e come vengono applicati gli aggiornamenti.