Rollbacks

Mentre le aggiornamenti in tempo reale di Capgo consentono di fornire velocemente miglioramenti e correzioni ai tuoi utenti, potrebbero esserci situazioni in cui hai bisogno di tornare a una versione precedente dell'app. Forse un nuovo aggiornamento ha introdotto un problema critico imprevisto, o forse vuoi annullare una specifica modifica mentre lavori su una soluzione.

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

Protezione dal Rollback Automatico

Capgo include un meccanismo di sicurezza integrato per proteggere i tuoi utenti dalle 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. notifyAppReady() Come Funziona la Protezione dal Rollback Automatico

Sottosezione intitolata “Come Funziona la Protezione dal Rollback Automatico”

When a new update is downloaded and applied, Capgo expects your app to call notifyAppReady() La bundle JavaScript è stata caricata senza errori critici

• The JavaScript bundle loaded without critical errors
• La funzionalità di base dell'app è in funzione
• L'aggiornamento è sicuro da mantenere

Se notifyAppReady() non viene chiamato a causa di un crash o un errore critico di JavaScript, Capgo farà:

1. Rileverà che l'aggiornamento non si è avviato correttamente
2. Ritornerà automaticamente al bundle precedente funzionante
3. Segnerà l'aggiornamento problematico come fallito per evitare che venga applicato nuovamente

Consiglio

Assicurati di chiamare notifyAppReady() inizializzare code nel tuo app dopo che i componenti di base 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, i tuoi utenti non si ritrovino con un'app non funzionante.

Configurazione del Timeout

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

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

Il appReadyTimeout valore è specificato in millisecondi. Il timeout predefinito è tipicamente di 10 secondi, ma puoi regolarlo 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.

Ritorno a una versione precedente del pacchetto

Ogni volta che pubblichi un nuovo build e lo assegni a un canale, Capgo mantiene una storia di quei build. Se hai bisogno di ripristinare un aggiornamento specifico, puoi selezionare uno di questi build precedenti per ripubblicarlo sul canale.

La principale via per l'annullamento è attraverso l'interfaccia di annullamento, che si trova nella 4^ scheda (Storia) quando si visualizza un canale nel Capgo Dashboard. Questa scheda fornisce una visione completa di tutte le versioni disponibili per il canale, consentendo di selezionare e ripristinare facilmente qualsiasi versione precedente.

Per annullare utilizzando la scheda Storia:

1. Accedi al Capgo Dashboard.

2. Naviga alla sezione "Canali".

3. Clicca sul nome del canale che desideri annullare.

4. Vai alla 4^ scheda (Storia) nella visualizzazione del canale.

5. Cerca 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 annullare a questa versione.

Metodo Alternativo: Utilizzo dell'icona della Corona

Come seconda opzione, puoi anche tornare indietro direttamente dalla prima scheda cliccando sull'icona della corona accanto a qualsiasi build nella cronologia dei build del canale:

1. Nella prima scheda della vista del canale, trova il build che desideri ripristinare.
2. Clicca sull'icona della corona accanto a quel build per renderlo il build attivo per il canale.
3. Conferma di voler tornare a questo build.

Nota

Il ripristino di un build precedente influenza solo il canale selezionato. Se hai più canali (ad esempio Produzione, Staging, ecc.), dovrai ripetere il processo di rollback per ogni canale interessato.

Dopo aver ripristinato, i dispositivi configurati per ascoltare il canale aggiornato riceveranno il build precedente la prossima volta che controllano gli aggiornamenti. Il build ripristinato sarà trattato come un nuovo aggiornamento, quindi si applicano le condizioni e il flusso di aggiornamento usuali.

Disconnettere un canale

If desideri interrompere temporaneamente gli aggiornamenti su un canale mentre esegui un'indagine su un problema, puoi sbloccare il canale dal suo build corrente.

To sbloccare un canale:

1. Naviga al canale nella Capgo Dashboard.

2. Clicca sul pulsante “Sblocca” accanto al build corrente.

3. Conferma che desideri sbloccare il canale.

Una volta sbloccato un canale, non distribuirà più aggiornamenti. Gli dispositivi configurati per quel canale rimarranno sul loro build corrente fino a quando il canale non sarà collegato a un build nuovamente.

Questo è utile se hai identificato un problema con un aggiornamento ma non sei ancora sicuro di quale build desideri tornare indietro. Sbloccando il canale hai il tempo di eseguire un'indagine senza inviare aggiornamenti ulteriori.

Forzare il Pacchetto Integrato

In situazioni più gravi, potresti voler tornare a tutti i dispositivi su un canale al build web che era originariamente confezionato con il binario nativo del tuo'app. Questo è noto come il “pacchetto integrato”.

Per forzare il pacchetto integrato su un canale:

1. Naviga al canale nella Capgo Dashboard.

2. Click the “Pacchetto Integrato” button.

3. Conferma di voler forzare il pacchetto integrato.

Quando si forza il pacchetto integrato, tutti i dispositivi configurati su quel canale torneranno al pacchetto web originale di build sul loro prossimo controllo di aggiornamento. Ciò avviene indipendentemente da cosa stanno utilizzando al momento.

Si tratta di un'opzione di rollback più aggressiva rispetto a tornare a un precedente build specifico, poiché elimina tutte le aggiornamenti live rilasciati dal momento in cui l'app è stata pubblicata negli store di app.

Attenzione

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

Monitoraggio e Risposta ai Problemi

È importante avere un piano per monitorare le tue rilasci e rispondere ai problemi per catturare le problematiche velocemente e minimizzare l'impatto degli aggiornamenti problematici.

Alcune strategie includono:

• Monitorare i rapporti di crash e le informazioni di feedback degli utenti immediatamente dopo il rilascio di un aggiornamento
• Utilizzando i rulli di fase o un sistema di canale a fasi per testare gli aggiornamenti su un gruppo più piccolo prima della diffusione generale
• Ha un processo decisionale chiaro per quando ricorrere al rollback, disconnettere o forzare il pacchetto integrato, e chi ha l'autorità di farlo
• Comunicare agli utenti sull'errore e sulla risoluzione, se appropriato

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

Continua da Rollbacks

Se stai utilizzando Rollbacks per pianificare il rollback e il controllo delle versioni, connettilo con Version Targeting per i dettagli di implementazione in Version Targeting, Comportamento degli Aggiornamenti per i dettagli di implementazione in Update Behavior, pacchetto per i dettagli di implementazione in pacchetto, Capgo Aggiornamenti in Tempo Reale per il flusso di lavoro del prodotto in Capgo Aggiornamenti in Tempo Reale, e Strategie di Annullamento per Capacitor Aggiornamenti in Tempo Reale per il contesto pratico in Strategie di Annullamento per Capacitor Aggiornamenti in Tempo Reale.