Rollbacks

Während Capgo-Live-Updates Ihnen ermöglichen, Verbesserungen und Fixes schnell an Ihre Benutzer zu liefern, gibt es Situationen, in denen Sie auf eine vorherige Version Ihres Apps zurückkehren müssen. Vielleicht wurde durch eine neue Aktualisierung ein unerwarteter kritischer Fehler eingeführt, oder Sie möchten eine bestimmte Änderung während Sie an einer Lösung arbeiten, zurücksetzen.

Capgo bietet mehrere Möglichkeiten, die Builds eines Kanals zu verwalten und die Version Ihrer App zu steuern, die Benutzer erhalten, einschließlich manueller Rollover-Optionen und automatischer Sicherheitsmechanismen.

Automatische Rückschalterschutz

Capgo enthält eine integrierte Sicherheitsmechanismus, um Ihre Benutzer vor beschädigten Updates zu schützen. Wenn ein JavaScript-Fehler vor dem Aufruf der notifyAppReady() Methode auftritt, wird der Plugin automatisch auf die vorherige funktionierende Version zurückgerollt.

Automatische Rückschaltung

Wenn eine neue Aktualisierung heruntergeladen und angewendet wird, erwartet Capgo, dass Ihre App innerhalb eines konfigurierbaren Zeitraums die notifyAppReady() Methode aufruft, um anzugeben, dass die Aktualisierung erfolgreich geladen wurde. Diese Methode signalisiert, dass:

• Die JavaScript-Bundle wurden ohne kritische Fehler geladen
• Ihre Anwendungsfunktionen laufen wie erwartet
• Die Aktualisierung ist sicher zu behalten

Wenn notifyAppReady() wird nicht aufgerufen, weil JavaScript abstürzt oder ein kritischer Fehler auftritt, wird Capgo wie folgt handeln:

1. Ermitteln, dass die Aktualisierung nicht korrekt initialisiert wurde
2. Automatisch auf die vorherige funktionierende Bundle zurückkehren
3. Die fehlerhafte Aktualisierung als fehlgeschlagen markieren, um sie zu verhindern, dass sie erneut angewendet wird

Tip

Stellen Sie sicher, dass Sie notifyAppReady() in der Initialisierung Ihrer Anwendung code nach dem erfolgreichen Laden Ihrer Kernkomponenten aufrufen. Dies sichert die automatische Rückkehrschutzfunktion

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

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

This automatic protection helps ensure that even if you accidentally push a broken update, your users won’t be stuck with a non-functional app.

Konfiguration der Timeout-Einstellung

Sie können festlegen, wie lange Capgo wartet, notifyAppReady() um von __CAPGO_KEEP_0__ aufgerufen zu werden, indem Sie die appReadyTimeout im Capacitor-Konfiguration einstellen:

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

Die appReadyTimeout Wert wird in Millisekunden angegeben. Der Standardzeitraum beträgt typischerweise 10 Sekunden, aber Sie können diesen an Ihre Anwendungsinitialisierungsanforderungen anpassen. Wenn Ihre Anwendung aufgrund komplexer Initialisierungsprozesse länger lädt, sollten Sie diesen Wert erhöhen.

Rückgängig machen auf eine vorherige Bundle

Jedes Mal, wenn Sie eine neue Version hochladen und einer Kanal zuweisen, hält Capgo eine Historie dieser Versionen. Wenn Sie eine bestimmte Aktualisierung zurücksetzen müssen, können Sie eine dieser vorherigen Versionen auswählen, um sie wieder in den Kanal zu deployen.

Der Hauptweg zum Zurücksetzen ist über die Zurücksetzungs-Oberfläche, die sich im 4. Tab (Historie) befindet, wenn man einen Kanal im Capgo Dashboard betrachtet. Dieser Tab bietet einen umfassenden Überblick über alle verfügbaren Builds für den Kanal, sodass man leicht auswählen und auf jede vorherige Version zurückkehren kann.

Um mit der Historie-Taste zurückzusetzen:

1. Anmelden zum Capgo Dashboard.

2. Zur "Kanäle"-Sektion navigieren.

3. Den Namen des Kanals anklicken, den man zurücksetzen möchte.

4. Zum 4. Tab (Historie) im Kanal-Ansicht wechseln.

5. Den Build finden, den man zurücksetzen möchte, in der Build-Historie.

6. Den Build auswählen, um ihn zum aktiven Build für den Kanal zu machen.

7. Bestätigen, dass man auf diesen Build zurücksetzen möchte.

Ersatzmethode: Mit dem Crown-Icon

Als zweite Möglichkeit können Sie auch direkt von der ersten Registerkarte zurückrollen, indem Sie das Krone-Icon neben jedem Build in der Build-Historie des Kanals klicken:

1. In der ersten Registerkarte der Kanalansicht finden Sie den Build, den Sie zurücksetzen möchten.
2. Klicken Sie auf das Krone-Icon neben diesem Build, um ihn zum aktiven Build für den Kanal zu machen.
3. Bestätigen Sie, dass Sie zu diesem Build zurückrollen möchten.

Hinweis

Die Rückkehr zu einem vorherigen Build wirkt sich nur auf den ausgewählten Kanal aus. Wenn Sie mehrere Kanäle (z.B. Produktions-, Staging-Kanäle usw.) haben, müssen Sie den Rücksetzprozess für jeden betroffenen Kanal wiederholen.

Nachdem Sie zurückgerollt sind, erhalten Geräte, die auf den aktualisierten Kanal eingestellt sind, das vorherige Build-Update beim nächsten Mal, wenn sie nach einem Update suchen. Das zurückgerollte Build-Update wird als neues Update behandelt, daher gelten die üblichen Update-Fluss- und -Bedingungen.

Kanal trennen

If Sie die Aktualisierungen auf einem Kanal vorübergehend aussetzen möchten, während Sie ein Problem untersuchen, können Sie den Kanal von seinem aktuellen Build trennen.

Um einen Kanal zu trennen:

1. Navigieren Sie zum Kanal im Capgo Dashboard.

2. Klicken Sie auf den „Trennen“-Button neben dem aktuellen Build.

3. Bestätigen Sie, dass Sie den Kanal trennen möchten.

Einmal getrennt, wird ein Kanal keine neuen Updates verteilen. Geräte, die auf diesen Kanal konfiguriert sind, bleiben auf ihrem aktuellen Build, bis der Kanal wieder mit einem Build verbunden ist.

Dies ist nützlich, wenn Sie ein Problem mit einer Aktualisierung identifiziert haben, aber noch nicht sicher sind, welchen Build Sie zurückrollen möchten. Das Trennen des Kanals gibt Ihnen Zeit zum Untersuchen, ohne weitere Updates zu verteilen.

Zurücksetzen des integrierten Bundles

In schwereren Situationen möchten Sie möglicherweise alle Geräte auf einem Kanal wieder auf die Web-Ausführung zurücksetzen, die ursprünglich mit Ihrem native Binärdatei verpackt wurde. Dies wird als „integrierter Bundle“ bezeichnet.

Um den integrierten Bundle auf einem Kanal zu zwingen:

1. Navigieren Sie zum Kanal im Capgo Dashboard.

2. Klicken Sie auf den Button „Built-in Bundle“.

3. Bestätigen Sie, dass Sie die integrierte Bundle zwingen möchten.

Wenn Sie die integrierte Bundle zwingen, werden alle auf diesem Kanal konfigurierten Geräte bei ihrem nächsten Update-Check wieder auf die ursprüngliche verpackte Web-Anwendung zurückkehren. Dies geschieht unabhängig davon, auf welchem Build sie sich derzeit befinden.

Dies ist eine aggressivere Rückerstattungsoption als das Zurückkehren auf einen bestimmten vorherigen Build, da alle live veröffentlichten Updates seit der letzten Veröffentlichung der App in den App-Stores verworfen werden.

Vorsicht

Seien Sie vorsichtig, wenn Sie die integrierte Bundle zwingen, da dies alle auf dem Kanal befindlichen Geräte beeinflusst. Stellen Sie sicher, dass Sie die Auswirkungen bedacht haben und einen Plan haben, um voranzukommen, bevor Sie diese Aktion durchführen.

Überwachung und Reaktion auf Probleme

Um Probleme schnell zu erkennen und den Einfluss von problematischen Updates zu minimieren, ist es wichtig, einen Plan für die Überwachung Ihrer Releases und die Reaktion auf Probleme zu haben.

Einige Strategien umfassen:

• Überwachung von Crashberichten und Benutzerfeedback sofort nach der Veröffentlichung eines Updates
• Mit phasigen Rollouts oder einem schrittweisen Kanal-System Updates auf einer kleineren Gruppe testen, bevor sie weit verbreitet werden
• Ein klares Entscheidungsverfahren für die Zeit haben, wenn man zurückrollen, entkoppeln oder die integrierte Bundle zwingen soll, und wer dazu die Autorität hat
• Benutzer über das Problem und die Lösung, wenn angemessen, informieren

Indem man sorgfältige Überwachung mit der Fähigkeit kombiniert, schnell auf Probleme bei Updates reagieren zu können, kann man eine ständig verbesserte App-Erfahrung liefern, während man die Störungen für die Benutzer minimiert

Fortsetzen von Rollbacks

Wenn Sie Rollbacks verwenden Rollbacks um das Zurückrollen und die Versionskontrolle zu planen, verbinden Sie es mit Versionziel Versionziel um die Implementierungsdetails in Versionziel zu erhalten, verbinden Sie es mit der Updateverhalten für die Implementierungsdetails in Update Behavior, Bündel für die Implementierungsdetails in Bündel, Capgo Live Updates für den Produktworkflow in Capgo Live Updates, und Rücksetzstrategien für Capacitor Live Updates für den praktischen Kontext in Rücksetzstrategien für Capacitor Live Updates.