Rollbacks

Mentre le Capgo live updates ti consentono di fornire velocemente miglioramenti e correzioni ai tuoi utenti, potrebbero esserci situazioni in cui hai bisogno di tornare a una versione precedente del tuo app. Forse un aggiornamento introdotto un problema critico imprevisto, o forse vuoi ripristinare un cambiamento specifico mentre lavori su una soluzione.

Capgo fornisce diverse opzioni per gestire le costruzioni di un canale e controllare la versione del tuo app che gli utenti ricevono, compresi sia le opzioni di rollback manuale che i meccanismi di sicurezza automatici.

Protezione automatica del rollback

Capgo includes a built-in safety mechanism to protect your users from broken updates. If a JavaScript error occurs before the notifyAppReady() __CAPGO_KEEP_0__ include un meccanismo di sicurezza integrato per proteggere i tuoi utenti dai aggiornamenti rotti. Se si verifica un errore JavaScript prima che il metodo sia chiamato, il plugin si attiverà automaticamente per tornare alla versione precedente funzionante.

How Automatic Rollback Works

When a new update is downloaded and applied, Capgo expects your app to call notifyAppReady() entro un tempo configurabile per confermare che l'aggiornamento è stato caricato con successo. Questo metodo segnala che:

• Il bundle JavaScript è stato caricato senza errori critici
• La funzionalità di base dell'app è funzionante
• L'aggiornamento è sicuro da mantenere

Se notifyAppReady() is not called due to a JavaScript crash or critical error, Capgo will:

1. Rileverà che l'aggiornamento non si è inizializzato correttamente
2. Ritornerà automaticamente al bundle precedente funzionante
3. Segnalerà l'aggiornamento problematico come fallito per prevenirne l'applicazione nuovamente

Consiglio

Assicurati di chiamare notifyAppReady() inizializzazione dell'applicazione code dopo che i componenti principali sono stati caricati con successo. Ciò assicura che la protezione automatica del rollback funzioni come previsto.

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

// Call this after your app has successfully initialized
await CapacitorUpdater.notifyAppReady()

Questa protezione automatica aiuta a garantire che anche se accidentalmente pubblichi un aggiornamento rotto, gli utenti non rimarranno bloccati con un'applicazione non funzionante.

Configurazione del Timeout

Puoi configurare quanto tempo Capgo attende per notifyAppReady() essere chiamato impostando il appReadyTimeout in configurazione Capacitor:

{
  "plugins": {
    "CapacitorUpdater": {
      "appReadyTimeout": 10000
    }
  }
}

La appReadyTimeout Il valore è specificato in millisecondi. Il timeout predefinito è tipicamente di 10 secondi, ma puoi regolare questo valore in base alle esigenze di inizializzazione dell'app. Se l'app richiede più tempo per caricarsi a causa di processi di inizializzazione complessi, potresti voler aumentare questo valore.

Ritornare a una versione precedente del pacchetto

Every time you upload a new build and assign it to a channel, Capgo keeps a history of those builds. If you need to revert a specific update, you can select one of these previous builds to redeploy to the channel.

The primary way to roll back is through the rollback interface, which is located in the 4th tab (History) when viewing a channel in the Capgo Dashboard. This tab provides a comprehensive view of all available builds for the channel, allowing you to easily select and revert to any previous version.

Per eseguire il rollback utilizzando la scheda Storia:

1. Accedi al Capgo Dashboard.

2. Naviga nella sezione “Canali”.

3. Clicca sul nome del canale che desideri annullare.

4. Vai alla quarta scheda (Storia) nella vista del canale.

5. Trovare la versione che desideri ripristinare nella cronologia delle versioni.

6. Seleziona quella versione per renderla la versione attiva per il canale.

7. Conferma di voler ripristinare a questa versione.

Metodo Alternativo: Utilizzo dell'Icona della Corona

Come seconda opzione, puoi anche ripristinare direttamente dalla prima scheda cliccando sull'icona della corona accanto a qualsiasi versione nella cronologia delle versioni del canale:

1. Nella prima scheda della vista del canale, trova la versione che desideri ripristinare.
2. Clicca sull'icona della corona accanto a quella versione per renderla la versione attiva per il canale.
3. Conferma di voler ripristinare a questa versione.

Nota

La rimozione di una versione precedente ha effetto solo sul canale selezionato. Se hai più canali (ad esempio Produzione, Staging, ecc.), dovrai ripetere il processo di rimozione per ogni canale interessato.

Dopo la rimozione, i dispositivi configurati per ascoltare il canale aggiornato riceveranno la versione precedente la prossima volta che controllano gli aggiornamenti. La versione rimossa sarà trattata come un nuovo aggiornamento, quindi si applicano le condizioni e il flusso di aggiornamento normali.

Accelerare un Rollback Critico con Notifiche

Ripuntare un canale normalmente ha effetto la prossima volta che un dispositivo controlla gli aggiornamenti. Capgo Le notifiche possono inviare una notifica di controllo degli aggiornamenti silenziosa a un'app supportata mentre è in background. Con l'integrazione dell'aggiornatore abilitata, l'app può controllare, scaricare e installare il rollback secondo il suo configurato modo di aggiornamento.

Questo è un percorso di accelerazione, non un comando di flotta forzato. La consegna rimane a best-effort e dipende dalla programmazione di background del sistema operativo, dalla disponibilità della rete e dallo stato del dispositivo. Non può aggiornare un'app offline o forzata, quindi non può promettere un tempo fissato per raggiungere ogni dispositivo.

Per configurare questo percorso, segui Notifiche: Abilita Controlli di Aggiornamento Silenziosi.

Disconnettere un Canale

Se desideri interrompere temporaneamente gli aggiornamenti su un canale mentre investighi un problema, puoi disconnettere il canale dalla sua versione corrente.

To disconnettere un canale:

1. Naviga al canale nella Capgo Dashboard.

2. Clicca sul pulsante “Disconnetti” accanto alla versione corrente.

3. Conferma di voler disconnettere il canale.

Una volta disconnesso un canale, non distribuirà più aggiornamenti. Gli dispositivi configurati su quel canale rimarranno sulla versione corrente fino a quando il canale non sarà collegato a una versione nuovamente.

Questo è utile se hai identificato un problema con un aggiornamento ma non sei ancora sicuro di quale versione desideri tornare indietro. Disconnettere il canale ti dà tempo per investigare senza distribuire aggiornamenti ulteriori.

Per forzare il Bundle Integrato

In situazioni più gravi, potresti voler tornare a tutti i dispositivi di un canale alla versione web che era originariamente confezionata con il tuo binario nativo. Ciò è noto come il “bundle integrato”.

Per forzare il bundle integrato su un canale:

1. Naviga al canale nella Capgo Dashboard.

2. Clicca sul pulsante “Bundle Integrato”.

3. Conferma di voler forzare il bundle integrato.

Quando si forza il bundle integrato, tutti i dispositivi configurati su quel canale ritornano alla versione web originale del pacchetto durante il loro prossimo controllo di aggiornamento. Ciò avviene indipendentemente dalla versione attuale.

Questa è un'opzione di rollback più aggressiva rispetto al ritorno a una versione precedente specifica, poiché elimina tutti gli aggiornamenti live rilasciati dalla pubblicazione dell'app negli store di app.

Avvertenza

Sii cauto quando si forza il bundle integrato, poiché ciò influenzerà tutti i dispositivi del canale. Assicurati di aver considerato l'impatto e di avere un piano per procedere prima di intraprendere questa azione.

Monitoraggio e Risposta a Problemi

Per catturare le problematiche velocemente e minimizzare l'impatto degli aggiornamenti problematici, è importante avere un piano per monitorare le proprie rilasci e rispondere ai problemi.

Alcune strategie includono:

Per un rollout che è ancora limitato a un cohort, utilizza Eseguire un rollout progressivo per bloccare l'esposizione o cancellare il bersaglio prima di cambiare il bundle stabile per tutto il canale.

• Monitorare i rapporti di crash e le informazioni dei utenti subito dopo la rilascio di un aggiornamento.
• Utilizzare rilasci fasiati o un sistema di canali stadiati per testare gli aggiornamenti su un gruppo più piccolo prima di una diffusione ampia.
• Avendo un processo di decisione chiaro per quando riportare indietro, disconnettere o forzare il bundle incorporato, e chi ha l'autorità di farlo.
• Comunicare agli utenti sull'issue e sulla risoluzione, se appropriato.

Combiniando il monitoraggio attento con la capacità di gestire rapidamente gli aggiornamenti problematici, puoi fornire un'esperienza di app continuamente migliorata mentre minimizzi le interruzioni per i tuoi utenti.

Continua da Rollbacks.

Se stai utilizzando Rollbacks per pianificare il riportare indietro e il controllo delle versioni, collegalo con Targetizzazione della versione per i dettagli di implementazione nella Versione Targeting Comportamento dell'aggiornamento per i dettagli di implementazione nel Comportamento dell'aggiornamento pacchetto per i dettagli di implementazione nel pacchetto Capgo Aggiornamenti in Tempo Reale for the product workflow in Capgo Live Updates, and per il flusso di lavoro del prodotto in Capacitor Aggiornamenti in Tempo Reale, e Strategie di rollback per Capacitor Aggiornamenti in Tempo Reale