Aggiorna il comportamento

When rilasci 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 loro aspettare per il download o riavviare l'app in mezzo a 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 completato lo scarico, Capgo attende che l'utente chiuda l'app in background.

4. When l'utente riporta l'app in primo piano, saranno in esecuzione la versione aggiornata.

Questo flusso assicura che gli utenti siano sempre in esecuzione la versione più aggiornata del tuo app, senza mai essere interrotti da promemoria di aggiornamento o costretti ad aspettare per i download.

Tip

Capgo controlla le nuove versioni ogni volta che l'app si sposta in primo piano e su un timer ripetuto mentre l'app rimane aperta. periodCheckDelay controlla quell'intervallo (predefinito 10 minuti).

Perché Questo Approccio?

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

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

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

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

Il principale svantaggio è che se un utente mette in background e riporta velocemente l'app, potrebbe perdere lo stato non salvato dal momento in cui l'aggiornamento è stato applicato tra quelle azioni.

Per mitigare questo, raccomandiamo:

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

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

• Considerare la personalizzazione del comportamento di aggiornamento per flussi sensibili (vedere di seguito).

Personalizzare l'applicazione degli aggiornamenti

In alcuni casi, potresti voler avere più controllo sul momento esatto in cui viene applicato l'aggiornamento. Ad esempio, potresti voler assicurarti che l'utente completi un flusso in corso prima di aggiornare, o coordinare l'aggiornamento dell'applicazione con un cambiamento server-side.

Capgo fornisce una setDelay funzione che ti consente di specificare le condizioni che devono essere soddisfatte prima dell'installazione dell'aggiornamento:

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 dell'aggiornamento fino a dopo il 1 giugno 2023 E l'applicazione è stata backgroundata per almeno 60 secondi.

Il ritardo disponibile per le condizioni è:

• date: Attendere fino a una data/ora specifica per applicare l'aggiornamento.
• background: Attendere un minimo di durata dopo che l'applicazione è stata backgroundata per applicare l'aggiornamento.
• nativeVersion: Aspettare per una versione binaria nativa minima essere installata prima di applicare l'aggiornamento.
• kill: Aspettare fino all'evento di uccisione dell'app successiva per applicare l'aggiornamento.

È possibile miscelare queste condizioni per controllare con precisione quando viene installato l'aggiornamento.

Danger

Nota che la kill condizione attualmente attiva l'aggiornamento dopo l'evento di uccisione iniziale, non l'evento di background come le altre condizioni. Questa incoerenza verrà risolta in una versione futura.

Applicare Aggiornamenti Subito

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

Consigliato: Utilizzare Aggiornamenti Delta (Manifesto) con Instant Apply

Quando si utilizza un modalità di applicazione istantanea, noi fortemente raccomandiamo di abilitare Aggiornamenti Delta (manifesto) per ridurre i tempi di download e migliorare l'esperienza utente. Gli aggiornamenti Delta (manifesto) scaricano solo i file modificati al posto dell'intero pacchetto, il che è particolarmente importante quando gli aggiornamenti vengono applicati immediatamente mentre gli utenti stanno utilizzando attivamente il tuo app.

Perché ciò è importante per le modalità di applicazione istantanea:

• Aggiornamenti più veloci: Scarichi più piccoli significano che gli aggiornamenti si completano rapidamente, riducendo il tempo che gli utenti vedono schermate di caricamento
• Miglior esperienza mobile: Gli utenti su reti cellulari o connessioni più lente non dovranno affrontare tempi di attesa lunghi
• Utilizzo di banda ridotto: Solo i file modificati vengono scaricati, risparmiando dati sia per te che per i tuoi utenti

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

Per abilitare gli aggiornamenti Delta (manifesto), basta utilizzare la --delta flag quando si caricano i bundle:

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

Scopri di più in Aggiornamenti della documentazione Delta (manifest).

autoUpdate è impostato nel tuo capacitor.config.ts file, non nel JavaScript code. Supporta questi valori:

• false o 'off': Disabilita le verifiche automatiche degli aggiornamenti
• true o 'atBackground' (predefinito): Verifica e scarica automaticamente ogni volta che si effettua una verifica in primo piano, quindi applica l'aggiornamento la prossima volta che l'app si sposta in background
• 'atInstall': Applica immediatamente solo dopo un installazione fresca o un aggiornamento dell'applicazione nativa; altrimenti utilizza "atBackground" comportamento
• 'onLaunch': Applica immediatamente solo quando l'app viene riportata in primo piano da uno stato ucciso (avvio freddo). Dopo la prima verifica, ricadere nel "atBackground" comportamento
• 'always': Controlla ogni transizione in primo piano e applica immediatamente quando è disponibile un aggiornamento
• 'onlyDownload': Controlla e scarica automaticamente, emiti updateAvailable, e non impostare mai il prossimo bundle o applicare un aggiornamento automaticamente

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 when using instant apply with autoSplashscreen
    },
  },
};

export default config;

Nota

Importante: i modi di applicazione istantanea applicano gli aggiornamenti solo quando il plugin effettivamente controlla 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 che intervallo (default 10 minuti).

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

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

Attenzione

Quando si utilizza un modo di applicazione istantanea con autoSplashscreen, è necessario impostare launchAutoHide: false nella configurazione dello schermo di benvenuto (come mostrato sopra) per impedire allo schermo di benvenuto di nascondersi automaticamente. Ciò assicura di avere il pieno controllo sul momento in cui lo schermo di benvenuto viene nascosto dopo la conclusione del processo di aggiornamento.

Scaricamento Automatico Senza Applicazione

Se desideri che Capgo controlli e scarichi gli aggiornamenti automaticamente, ma non li applichi mai automaticamente, utilizza autoUpdate: 'onlyDownload':

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

In questo modo, il plugin emette updateAvailable dopo l'acquisizione di un bundle. L'applicazione può quindi decidere quando chiamare CapacitorUpdater.set() o mostrare il proprio prompt di aggiornamento.

Gestione automatica dello schermo di caricamento

Per rendere più facili da utilizzare le modalità di applicazione istantanea, Capgo fornisce un autoSplashscreen opzione che gestisce automaticamente la nascita dello schermo di caricamento per conto tuo (disponibile dalla versione 7.6.0):

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 caricamento quando viene applicato un aggiornamento
• Il plugin nasconde automaticamente lo schermo di caricamento quando non è necessario alcun aggiornamento
• Non è necessario ascoltare manualmente per appReady eventi o chiamata SplashScreen.hide()

Gestione dello schermo di benvenuto manuale

e gestirlo da solo: autoSplashscreen Copia negli appunti

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

CapacitorUpdater.addListener('appReady', () => {
  // Hide splash screen
  SplashScreen.hide();
});

CapacitorUpdater.notifyAppReady();

l'evento si attiva una volta che l'app ha completato l'inizializzazione e l'applicazione di eventuali aggiornamenti in sospeso. Questo è il punto in cui è sicuro mostrare l'interfaccia utente dell'app, poiché assicura che l'utente veda la versione più recente. appReady Inoltre, oltre alla gestione dell'

evento, raccomandiamo di impostare l' appReady opzione di configurazione su keepUrlPathAfterReload quando si utilizza un modello di applicazione istantanea. Ciò preserva la cartella URL corrente quando l'app viene riavviata a causa di un aggiornamento, aiutando a mantenere la posizione dell'utente nell'app e riducendo la disorientamento. true __CAPGO_KEEP_0__

If non gestisci l'evento e impostare appReady quando si utilizza un modalità di applicazione istantanea, l'utente potrebbe vedere una versione obsoleta dell'app, essere riportato alla route iniziale o vedere un lampo mentre l'aggiornamento viene applicato. keepUrlPathAfterReload Utilizzare una modalità di applicazione istantanea può essere utile per fornire correzioni critiche di bug o patch di sicurezza, ma comporta alcuni compromessi:

L'utente potrebbe vedere un lampo o uno stato di caricamento brevi se non gestisci correttamente lo schermo di benvenuto (in modo automatico o manuale).

• Se l'aggiornamento modifica lo stato dell'app o l'interfaccia utente, l'utente potrebbe vedere un cambiamento disorientante in mezzo a una sessione. autoSplashscreen Il posizionamento dell'utente nell'app potrebbe essere perso se __CAPGO_KEEP_0__ non è impostato, potenzialmente disorientandoli. appReady Dovrai gestire con cura la salvaguardia e il ripristino dello stato per garantire una transizione liscia.
• Se abiliti l'applicazione istantanea, raccomandiamo:
• __CAPGO_KEEP_1__ keepUrlPathAfterReload __CAPGO_KEEP_2__
• __CAPGO_KEEP_3__

__CAPGO_KEEP_4__

• Usando autoSplashscreen: true per la configurazione più semplice, o gestendo manualmente il appReady se hai bisogno di logica personalizzata.
• Impostare keepUrlPathAfterReload per preservare la posizione dell'utente nell'app. true Salvare e ripristinare lo stato dell'app quando necessario per evitare di perdere il 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 molti casi, il comportamento di aggiornamento predefinito fornisce il miglior equilibrio tra la consegna di aggiornamenti rapidi e la minimizzazione della dislocazione. Ma per le app con esigenze specifiche, __CAPGO_KEEP_0__ fornisce la flessibilità di personalizzare quando e come gli aggiornamenti vengono applicati.

In most cases, the default update behavior provides the best balance of delivering updates quickly and minimizing disruption. But for apps with specific needs, Capgo provides the flexibility to customize when and how updates are applied.

Sezione intitolata “Continua da Aggiornamento del comportamento”

Capgo Aggiorna il comportamento per pianificare la consegna di aggiornamenti in tempo reale, connettilo con Capgo Aggiornamenti in Tempo Reale 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 Avvio Guidato per i dettagli di implementazione in Avvio Guidato.