Rückgänge

While Capgo’s live updates ermöglichen Ihnen, Verbesserungen und Fixes schnell an Ihre Benutzer zu liefern, gibt es Situationen, in denen Sie auf eine vorherige Version Ihrer App zurückkehren müssen. Vielleicht wurde durch eine neue Aktualisierung ein unerwarteter kritischer Fehler eingeführt, oder vielleicht möchten Sie 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 Rollover-Schutz

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

Wie funktioniert der Automatische Rollover?

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
• Die Kernfunktionen Ihrer App funktionieren
• Die Aktualisierung ist sicher zu behalten

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

1. Ermitteln Sie, dass die Aktualisierung fehlschlug, um ordnungsgemäß zu initialisieren
2. Automatisch auf die vorherige funktionierende Bundle zurückkehren
3. Die fehlerhafte Aktualisierung als fehlgeschlagen kennzeichnen, um sie zu verhindern, dass sie erneut angewendet wird

Tip

Stellen Sie sicher, dass Sie in Ihrer Anwendung die __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()

Copy to clipboard

Konfiguration der Zeitüberschreitung

Sie können festlegen, wie lange Capgo auf die Ausführung wartet, notifyAppReady() durch die Einstellung der appReadyTimeout in Ihrer Capacitor-Konfiguration:

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

Die appReadyTimeout Gewährleistung ist in Millisekunden angegeben. Die Standardzeitüberschreitung beträgt typischerweise 10 Sekunden, aber Sie können diese Anpassen, basierend auf den Anforderungen Ihrer App zur Initialisierung. Wenn Ihre App aufgrund komplexer Initialisierungsprozesse länger lädt, sollten Sie diesen Wert erhöhen.

Zurücksetzen auf eine vorherige Bundle

Jedes Mal, wenn Sie eine neue Version hochladen und einer Kanal zuweisen, speichert Capgo eine Historie dieser Versionen. Wenn Sie eine bestimmte Aktualisierung rückgängig machen müssen, können Sie eine dieser vorherigen Versionen auswählen, um sie wieder auf den Kanal zu deployen.

The primäre Methode zur Rückkehr ist über die Rückgängigmachungs-Oberfläche, die sich im 4. Tab (Geschichte) 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 Geschichte zurückzukehren:

1. Anmelden Sie sich im Capgo Dashboard.

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

3. Klicken Sie auf den Namen des Kanals, den Sie zurücksetzen möchten.

4. Gehen Sie zum 4. Tab (Geschichte) im Kanal-Bildschirm.

5. Finden Sie den Build, den Sie zurücksetzen möchten, in der Build-Geschichte.

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

7. Bestätigen Sie, dass Sie auf diesen Build zurückkehren möchten.

Alternative Methode: Verwendung des Crown-Icons

Als zweite Möglichkeit können Sie auch direkt von der ersten Registerkarte zurückrollen, indem Sie auf das Krönchen-Symbol neben jedem Build in der Build-Geschichte 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 Krönchen-Symbol 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- etc.) 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

Wenn Sie Updates auf einem Kanal vorübergehend anhalten möchten, während Sie ein Problem untersuchen, können Sie den Kanal von seinem aktuellen Build trennen.

Um einen Kanal zu entkoppeln:

1. Navigieren Sie zum Kanal im Capgo Dashboard.

2. Klicken Sie auf das Schaltfeld „Entkoppeln“ neben der aktuellen Version.

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

Einmal entkoppelt, wird ein Kanal keine neuen Updates verteilen. Geräte, die auf diesen Kanal konfiguriert sind, bleiben auf ihrer aktuellen Version, bis der Kanal wieder mit einer Version verbunden ist.

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

Zurücksetzen auf die integrierte Bundle

In schweren Fällen möchten Sie möglicherweise alle Geräte auf einem Kanal wieder auf die Webversion zurücksetzen, die ursprünglich mit Ihrem native Binärdatei verpackt wurde. Dies wird als „integrierte Bundle“ bezeichnet.

Um die integrierte Bundle auf einem Kanal zu zwingen:

1. Navigieren Sie zum Kanal im Capgo Dashboard.

2. Klicken Sie auf das Schaltfeld „Integrierte 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ückschaltmöglichkeit 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 sorgfältig abgewogen 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 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:

• Die Überwachung von Crashberichten und Benutzerfeedback sofort nach der Veröffentlichung eines Updates
• Die Verwendung von Phasenrollouts oder einem gestaffelten Kanalsystem, um Updates auf einem kleineren Gruppe zu testen, bevor sie weit verbreitet werden
• Ein klares Entscheidungsverfahren für die Zeit, wann man sich auf einen Rollback, das Entkoppeln oder die Zwangsbereitstellung der integrierten Bundle zurückziehen soll, und wer dazu die Autorität hat
• Benachrichtigung der Benutzer über das Problem und die Lösung, falls angemessen

Durch die Combination von sorgfältiger Überwachung mit der Fähigkeit, problematische Updates schnell zu verwalten, können Sie eine kontinuierlich verbesserte App-Erfahrung liefern, während Sie die Störungen für Ihre Benutzer minimieren

Weitermachen von Rollbacks

Wenn Sie " Rollbacks " verwenden, um ein Rollback und eine Versionskontrolle zu planen, verbinden Sie es mit " Version Targeting" für die Implementierungsdetails in Version Targeting, " Update Behavior" für die Implementierungsdetails in Update Behavior Paket für die Implementierungsdetails im Paket, 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.