Wiederherstellungen

Während Capgos Live-Updates es 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 zurücksetzen, während Sie an einer Lösung arbeiten.

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 Rollover-Schutzfunktion

Capgo beinhaltet eine eingebaute Sicherheitsmechanismen, um Ihre Benutzer vor beschädigten Updates zu schützen. Wenn ein JavaScript-Fehler vor der Aufrufung des notifyAppReady() Methode auftritt, wird das Plugin automatisch auf die vorherige funktionierende Version zurückgerollt.

Wie die Automatische Rollover-Funktion funktioniert

Wenn ein neuer Update heruntergeladen und angewendet wird, erwartet Capgo, dass Ihre App innerhalb eines konfigurierbaren Zeitrahmens aufruft, um zu bestätigen, dass das Update erfolgreich geladen wurde. Diese Methode signalisiert, dass: notifyAppReady() Das JavaScript-Bundle wurde ohne kritische Fehler geladen

• Die Kernfunktion Ihrer App funktioniert
• Das Update ist sicher zu behalten
• Wenn

Wenn ein Fehler auftritt notifyAppReady() wird nicht aufgerufen, weil ein JavaScript-Crash oder ein kritischer Fehler aufgetreten ist, Capgo wird:

1. Ermitteln Sie, dass die Aktualisierung nicht ordnungsgemäß initialisiert wurde
2. Automatisch auf den vorherigen funktionierenden Bundle zurückkehren
3. Die fehlerhafte Aktualisierung als fehlgeschlagen markieren, um sicherzustellen, dass sie nicht erneut angewendet wird

Tip

Stellen Sie sicher, dass Sie in der Initialisierung Ihres Apps __CAPGO_KEEP_0__ nach dem erfolgreichen Laden Ihrer Kernkomponenten aufrufen. Dies stellt sicher, dass die automatische Rollover-Schutzfunktion wie vorgesehen funktioniert. notifyAppReady() in your app’s initialization code after your core components have loaded successfully. This ensures the automatic rollback protection works as intended.

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

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

Einstellung der Zeitüberschreitung

Abschnitt mit der Überschrift „Einstellung der Zeitüberschreitung“

You können festlegen, wie lange Capgo auf eine Antwort wartet, notifyAppReady() indem Sie die appReadyTimeout im Capacitor-Konfigurationseintrag setzen:

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

Die appReadyTimeout Wert ist in Millisekunden angegeben. Der Standard-Zeitlimit beträgt typischerweise 10 Sekunden, aber Sie können dies anhand der Anforderungen Ihrer App anpassen. Wenn Ihre App aufgrund komplexer Initialisierungsprozesse länger lädt, sollten Sie diesen Wert erhöhen.

Zurückrollen auf eine vorherige Bundle

Jedes Mal, wenn Sie ein neues Build hochladen und einem Kanal zuweisen, speichert Capgo eine Historie dieser Builds. Wenn Sie eine bestimmte Aktualisierung zurücksetzen müssen, können Sie eine dieser vorherigen Builds auswählen, um ihn erneut auf den Kanal zu deployen.

Der Hauptweg, um zurückzurollen, ist die Zurückrollen-Schnittstelle, die sich im 4. Tab (Historie) befindet, wenn Sie einen Kanal im Capgo-Dashboard ansehen. Dieser Tab bietet einen umfassenden Überblick über alle verfügbaren Builds für den Kanal, sodass Sie leicht eine vorherige Version auswählen und zurückrollen können.

Zurückrollen mithilfe der Historie-Tabelle:

1. Anmelden zum Capgo Dashboard.

2. Navigieren Sie zur "Kanäle"-Sektion.

3. Klicken Sie auf den Namen des Kanals, den Sie rückgängig machen möchten.

4. Gehen Sie in der Kanalansicht zum 4. Tab (Historie).

5. Finden Sie das Build, das Sie zurücksetzen möchten, in der Build-Historie.

6. Wählen Sie dieses Build aus, um es zum aktiven Build für den Kanal zu machen.

7. Bestätigen Sie, dass Sie zu diesem Build zurücksetzen möchten.

Alternative Methode: Verwendung des Crown-Icons

Als zweite Möglichkeit können Sie auch direkt von der ersten Tab-Seite aus rückgängig machen, indem Sie das Crown-Icon neben jedem Build in der Build-Historie des Kanals klicken:

1. In der ersten Tab-Seite der Kanalansicht finden Sie das Build, das Sie zurücksetzen möchten.
2. Klicken Sie auf das Krönchen-Icon neben dieser Build, um sie zur aktiven Build für den Kanal zu machen.
3. Bestätigen Sie, dass Sie zu dieser Build zurückrollen möchten.

Hinweis

Die Rückrufung auf eine vorherige Build wirkt sich nur auf den ausgewählten Kanal aus. Wenn Sie mehrere Kanäle (z.B. Produktions-, Staging- etc.) haben, müssen Sie den Rückrufprozess für jeden betroffenen Kanal wiederholen.

Nach dem Rückruf erhalten Geräte, die auf den aktualisierten Kanal eingestellt sind, die vorherige Build die nächste Zeit, wenn sie nach einer Aktualisierung suchen. Die zurückgerollte Build wird als neue Aktualisierung behandelt, daher gelten die üblichen Aktualisierungsabläufe und -bedingungen.

Kanal entkoppeln

Wenn Sie eine vorübergehende Einstellung der Aktualisierungen auf einem Kanal während der Untersuchung eines Problems wünschen, können Sie den Kanal von seiner aktuellen Build entkoppeln.

Um einen Kanal zu entkoppeln:

1. Navigieren Sie zum Kanal im Capgo-Dashboard.

2. Klicken Sie auf den Button „Unlink“ neben der aktuellen Build.

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

Ein Kanal, der entkoppelt wurde, verteilt keine neuen Updates mehr. Geräte, die auf diesen Kanal konfiguriert sind, bleiben auf ihrer aktuellen Build, bis der Kanal wieder mit einer Build verbunden ist.

Dies ist nützlich, wenn Sie ein Problem mit einem Update identifiziert haben, aber noch nicht sicher sind, auf welche Build Sie zurückrollen möchten. Das Entkoppeln des Kanals gibt Ihnen Zeit, zu untersuchen, ohne weitere Updates zu verteilen.

Zurücksetzen des Built-In-Bundles

In schweren Fällen möchten Sie möglicherweise alle Geräte auf einem Kanal wieder auf die ursprünglich mit Ihrem native Binärdatei verpackte Web-Build zurücksetzen. Dies wird als „Built-In-Bundle“ bezeichnet.

Um auf einem Kanal das Built-In-Bundle zwingen zu lassen:

1. Navigieren Sie zum Kanal im Capgo-Dashboard.

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

3. Bestätigen Sie, dass Sie das Built-In-Bundle zwingen möchten.

Wenn Sie das Built-In-Bundle zwingen, werden alle auf diesem Kanal konfigurierten Geräte auf die ursprünglich verpackte Web-Build zurückkehren, sobald sie auf die nächste Update-Überprüfung treffen. Dies geschieht unabhängig davon, auf welcher Build sie sich gerade befinden.

Dies ist eine aggressivere Rollover-Option als das Zurücksetzen auf eine bestimmte vorherige Version, da sie alle live veröffentlichten Updates seit der letzten Veröffentlichung der App in den App-Stores abwirft.

Vorsicht

Seien Sie vorsichtig, wenn Sie die integrierte Bundle zwingen, da dies alle Geräte auf dem Kanal beeinflusst. Stellen Sie sicher, dass Sie die Auswirkungen bedacht haben und einen Plan haben, um voranzukommen, bevor Sie diese Maßnahme ergreifen.

Überwachung und Reaktion auf Probleme

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

Einige Strategien umfassen:

• Die Überwachung von Crashberichten und Benutzerfeedback sofort nach der Veröffentlichung einer Aktualisierung
• Die Verwendung von Phasen-Rollouts oder eines stufenweisen Kanal-Systems, um Aktualisierungen auf einer kleineren Gruppe zu testen, bevor sie weit verbreitet werden
• Die Festlegung eines klaren Entscheidungsprozesses für die Entscheidung, zurückzurollen, zu entkoppeln oder die integrierte Bundle zu zwingen, und wer die Autorität dazu hat
• Die Kommunikation mit den Benutzern über das Problem und die Lösung, wenn dies angebracht ist

Indem Sie sorgfältige Überwachung mit der Fähigkeit kombinieren, problematische Updates schnell zu verwalten, können Sie eine kontinuierlich verbesserte App-Erfahrung bereitstellen, während Sie Störungen für Ihre Benutzer minimieren.

__CAPGO_KEEP_0__

Abschnitt mit dem Titel „Weitermachen von Rollbacks“ Wenn Sie " Rollbacks" zur Planung von Rollbacks und Versionskontrolle verwenden, verbinden Sie es mit Version Targeting für die Implementierungsdetails in Version Targeting, Update Behavior für die Implementierungsdetails in Update Behavior, bundle Capgo Live Updates für den Produktworkflow in Capgo Live Updates und Rückgängigmachungsstrategien für Capacitor Live Updates für den praktischen Kontext in Rückgängigmachungsstrategien für Capacitor Live Updates.