Zum Inhalt springen

Rollbacks

Während du mit den Live Updates von Capgo Verbesserungen und Fixes schnell an deine Nutzer ausliefern kannst, gibt es Situationen, in denen du zu einer früheren Version deiner App zurückrollen musst. Vielleicht hat ein neues Update einen unerwarteten kritischen Fehler verursacht, oder du möchtest eine bestimmte Änderung rückgängig machen, während du an einem Fix arbeitest.

Kurz gesagt: Um ein fehlerhaftes Capacitor live update mit Capgo zurückzurollen, stellen Sie den Channel im Capgo-Dashboard oder über die Capgo CLI wieder auf das vorherige Bundle zurück. Geräte übernehmen es beim nächsten Update-Check, und der Updater rollt auch automatisch zurück, wenn ein neues Bundle nicht aufgerufen wird notifyAppReady() innerhalb des konfigurierten appReadyTimeout.

Capgo bietet mehrere Möglichkeiten, die Builds eines Channels zu verwalten und die Version deiner App zu steuern, die Nutzer erhalten – inklusive manueller Rollback-Optionen und automatischer Sicherheitsmechanismen.

Capgo enthält einen integrierten Sicherheitsmechanismus, um deine Nutzer vor fehlerhaften Updates zu schützen. Tritt ein JavaScript-Fehler auf, bevor die notifyAppReady() Methode aufgerufen wird, rollt das Plugin automatisch auf die letzte funktionierende Version zurück.

Sobald ein neues Update heruntergeladen und angewendet wurde, erwartet Capgo, dass deine App notifyAppReady() innerhalb eines konfigurierbaren Zeitfensters aufruft, um zu bestätigen, dass das Update erfolgreich geladen wurde. Diese Methode signalisiert, dass:

  • Das JavaScript-Bundle ohne kritische Fehler geladen wurde
  • Die Kernfunktionen deiner App laufen
  • Das Update ist sicher

Wenn notifyAppReady() aufgrund eines JavaScript-Crashs oder kritischen Fehlers nicht aufgerufen wird, wird Capgo:

  1. Erkennen, dass das Update nicht korrekt initialisiert wurde
  2. Automatisch zum vorherigen funktionierenden Bundle zurückkehren
  3. Das fehlerhafte Update als fehlgeschlagen markieren, damit es nicht erneut angewendet wird
import { CapacitorUpdater } from '@capgo/capacitor-updater'
// Call this after your app has successfully initialized
await CapacitorUpdater.notifyAppReady()

Dieser automatische Schutz hilft sicherzustellen, dass Ihre Nutzer nicht mit einer nicht funktionsfähigen App festsitzen, selbst wenn Sie versehentlich ein fehlerhaftes Update pushen.

Sie können konfigurieren, wie lange Capgo wartet, notifyAppReady() aufgerufen zu werden, indem Sie appReadyTimeout in Ihrer Capacitor-Konfiguration setzen:

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

Der appReadyTimeout Der Wert wird in Millisekunden angegeben. Der Standard-Timeout liegt in der Regel bei 10 Sekunden, Sie können ihn aber an die Initialisierungsanforderungen Ihrer App anpassen. Wenn Ihre App aufgrund komplexer Initialisierungsprozesse länger zum Laden braucht, sollten Sie diesen Wert erhöhen.

Jedes Mal, wenn Sie einen neuen Build hochladen und einem Channel zuweisen, führt Capgo eine Historie dieser Builds. Wenn Sie ein bestimmtes Update zurücksetzen müssen, können Sie einen dieser vorherigen Builds auswählen und erneut auf dem Channel deployen.

Rollback-Oberfläche

Der primäre Weg für einen Rollback ist die Rollback-Oberfläche im 4. Tab (History), wenn du einen Channel im Capgo Dashboard betrachtest. Dieser Tab bietet eine vollständige Übersicht aller verfügbaren Builds für den Channel, sodass du einfach eine vorherige Version auswählen und wiederherstellen kannst.

So rollen Sie über den Tab History zurück:

  1. Logge dich im Capgo Dashboard ein.

  2. Navigiere zum Bereich „Channels“.

  3. Klicken Sie auf den Namen des Channels, den Sie zurückrollen möchten.

  4. Gehe in der Channel-Ansicht zum 4. Tab (History).

  5. Suche in der Build-Historie den Build, zu dem du zurückkehren möchtest.

  6. Wähle diesen Build aus, um ihn zum aktiven Build für den Channel zu machen.

  7. Bestätige, dass du zu diesem Build zurückrollen möchtest.

Als zweite Möglichkeit können Sie auch direkt im ersten Tab zurückrollen, indem Sie auf das Kronen-Symbol neben einem beliebigen Build in der Build-Historie des Channels klicken:

  1. Finden Sie im ersten Tab der Channel-Ansicht den Build, auf den Sie zurückrollen möchten.
  2. Klicken Sie auf das Kronen-Symbol neben diesem Build, um ihn zum aktiven Build für den Channel zu machen. Channel-Verwaltungsoptionen
  3. Bestätige, dass du zu diesem Build zurückrollen möchtest.

Nach einem Rollback erhalten Geräte, die auf den aktualisierten Channel hören, beim nächsten Update-Check den vorherigen Build. Der Rollback-Build wird wie ein neues Update behandelt, daher gelten der übliche Update-Flow und die üblichen Bedingungen.

Das Umleiten eines Channels wird normalerweise beim nächsten Update-Check eines Geräts wirksam. Capgo Notifications können eine Silent Update-Check-Benachrichtigung an eine unterstützte App senden, während diese im Hintergrund läuft. Wenn die Updater-Integration aktiviert ist, kann die App das Rollback gemäß ihrem konfigurierten Update-Modus prüfen, herunterladen und installieren.

Dies ist ein Beschleunigungspfad, kein erzwungener Fleet-Befehl. Die Zustellung erfolgt nach dem Best-Effort-Prinzip und hängt vom Hintergrund-Scheduling des Betriebssystems, der Netzwerkverfügbarkeit und dem Gerätestatus ab. Eine App, die offline ist oder erzwungen beendet wurde, kann nicht aktualisiert werden; eine feste Zeit für alle Geräte lässt sich daher nicht garantieren.

Um diesen Pfad einzurichten, folge Notifications: Silent Update Checks aktivieren.

Wenn du Updates auf einem Channel vorübergehend stoppen möchtest, um ein Problem zu untersuchen, kannst du den Channel von seinem aktuellen Build entkoppeln.

So entkoppelst du einen Channel:

  1. Navigiere zum Channel im Capgo Dashboard.

  2. Klicke auf die Schaltfläche „Unlink“ neben dem aktuellen Build.

  3. Bestätige, dass du den Channel unlinken möchtest.

Sobald ein Channel unlinked ist, verteilt er keine neuen Updates mehr. Geräte, die auf diesen Channel konfiguriert sind, bleiben auf ihrem aktuellen Build, bis der Channel wieder mit einem Build verknüpft wird.

Das ist nützlich, wenn du ein Problem mit einem Update festgestellt hast, aber noch nicht sicher bist, auf welchen Build du zurückrollen möchtest. Das Unlinken des Channels gibt dir Zeit zur Untersuchung, ohne weitere Updates auszuliefern.

In schwerwiegenderen Situationen möchtest du möglicherweise alle Geräte eines Channels auf den Web-Build zurücksetzen, der ursprünglich mit dem nativen Binary deiner App verpackt wurde. Dies wird als „Built-in Bundle“ bezeichnet.

Um das Built-in Bundle auf einem Channel zu erzwingen:

  1. Navigiere zum Channel im Capgo Dashboard.

  2. Klicke auf die Schaltfläche „Built-in Bundle“.

  3. Bestätigen Sie, dass Sie das eingebaute Bundle erzwingen möchten.

Wenn Sie das eingebaute Bundle erzwingen, kehren alle Geräte, die für diesen Channel konfiguriert sind, bei der nächsten Update-Prüfung zum ursprünglichen paketierten Web-Build zurück. Dies geschieht unabhängig davon, welchen Build sie aktuell verwenden.

Dies ist eine aggressivere Rollback-Option als das Zurücksetzen auf einen bestimmten vorherigen Build, da alle Live Updates verworfen werden, die seit der letzten Veröffentlichung der App in den App-Stores freigegeben wurden.

Um Probleme schnell zu erkennen und die Auswirkungen fehlerhafter Updates zu minimieren, ist ein Plan für das Monitoring deiner Releases und die Reaktion auf Probleme entscheidend.

Einige Strategien sind:

Für einen Rollout, der noch auf eine Cohort beschränkt ist, nutze Progressive Rollouts um die Ausspielung zu pausieren oder das Target zu leeren, bevor du das stabile Bundle für den gesamten Channel änderst.

  • Überwachung von Crash-Reports und User-Feedback unmittelbar nach dem Release eines Updates
  • Nutzung von Phased Rollouts oder einem Staged-Channel-System, um Updates vor dem breiten Release an einer kleineren Gruppe zu testen
  • Ein klarer Entscheidungsprozess, wann ein Rollback oder Unlink erfolgt oder das integrierte Bundle erzwungen wird und wer dafür die Befugnis hat
  • Kommunikation des Problems und der Lösung an die Nutzer, sofern angemessen

Durch sorgfältiges Monitoring und die Möglichkeit, problematische Updates schnell in den Griff zu bekommen, können Sie eine sich ständig verbessernde App-Erfahrung bieten und gleichzeitig Unterbrechungen für Ihre Nutzer minimieren.

Wenn du es nutzt Rollbacks um Rollbacks und die Versionskontrolle zu planen, verbinde es mit Version-Targeting für die Implementierungsdetails in Version Targeting, Update-Verhalten für die Implementierungsdetails im Update-Verhalten, Bundle für die Implementierungsdetails im Bundle, Capgo Live Updates für den Produkt-Workflow in Capgo Live Updates, und Rollback-Strategien für Capacitor Live Updates für den praktischen Kontext in Rollback-Strategien für Capacitor Live Updates.