Übersicht

Verwenden Sie Capgo’s Live-Updates-Funktion, um die JavaScript-Bundles Ihrer App ferngesteuert und in Echtzeit zu aktualisieren. Drücken Sie JS-Updates direkt an Ihre Benutzer weiter, ohne durch den App-Store-Überprüfungsprozess zu gehen, um Fehler sofort zu beheben und neue Funktionen zu liefern.

Benutzen Sie immer die neueste CLI

Führen Sie immer Capgo CLI mit @latest zum Beispiel npx @capgo/cli@latest). The CLI follows its own versioning and does Die __CAPGO_KEEP_0__ folgt ihrer eigenen Versionsierung und benötigt nicht need to match your plugin major or Capacitor major. The latest CLI stays compatible with any supported updater plugin version. See Anpassung an Ihr Plugin-Major oder Capgo-Major. Die neueste __CAPGO_KEEP_1__ bleibt mit jeder unterstützten Updater-Plugin-Version kompatibel. Siehe.

Anmerkung

Live Updates werden nur auf Änderungen an JavaScript-Bundles beschränkt. Wenn Sie native code aktualisieren müssen, wie z.B. einen Plugin hinzufügen oder entfernen oder die native Projekt-Konfiguration ändern, müssen Sie ein neues natives Binärpaket an die App-Stores übermitteln.

Wie Live Updates funktionieren

Das Live-Update-System von Capgo besteht aus zwei Schlüsselfunktionen:

1. Der Capgo SDK, der in Ihrer App installiert wird. Der SDK überprüft auf verfügbare Updates und lädt sie im Hintergrund herunter.

2. Kanäle, mit denen Sie Updates an bestimmte Benutzergruppen senden können. Sie können Kanäle verwenden, um verschiedene Release-Tracks zu verwalten, wie z.B. Production, Stagingund Dev.

Wenn Sie ein neues JS-Bundle auf Capgo hochladen und es einem Kanal zuweisen, wird das Capgo SDK in Apps, die für diesen Kanal konfiguriert sind, das Update erkennen und herunterladen. Beim nächsten Neustart der App wird das neue Bundle geladen.

Anfangen

Um mit Live Updates zu beginnen, folgen Sie diesen Schritten:

1. Erstellen Sie das Capgo Quickstart um Ihre App in Capgo einzurichten und das Capgo SDK zu installieren.

2. In Ihrer App code, rufen Sie CapacitorUpdater.notifyAppReady() auf, nachdem Ihre App fertig initialisiert wurde. Dies teilt dem Capgo SDK mit, dass Ihre App bereit ist, Updates zu empfangen.

3. Bauen Sie Ihr JS-Bundle und laden Sie es auf Capgo hoch:

   npm run build
   npx @capgo/cli@latest bundle upload --channel=production

4. Öffnen Sie Ihre App und warten Sie, bis das Update heruntergeladen ist. Sie können den Status mit:

   npx @capgo/cli@latest app debug

5. Schließen Sie Ihre App und öffnen Sie sie erneut, um das neue Bundle zu laden.

Siehe das Live-Updates bereitstellen Weitere Details finden Sie in der Anleitung.

Der Capgo CLI

Der Capgo CLI ist ein leistungsstarker Werkzeug, das Entwicklern ermöglicht, Dienste von Capgo in ihren eigenen CI/CD-Pipelines zu interagieren. Mit dem CLI haben Sie eine fein abgestimmte Kontrolle darüber, wann Builds erstellt und bereitgestellt werden, was Ihnen ermöglicht, Capgo in Ihre bestehenden Enterprise-Workflows zu integrieren.

Was ist der Capgo CLI für?

Der Capgo CLI ist für Entwickler und Teams konzipiert, die mehr Kontrolle und Flexibilität in ihren Live-Update-Workflows benötigen. Durch die Verwendung des CLI in Ihren CI/CD-Pipelines können Sie:

• Entscheiden, wann Updates erstellt und bereitgestellt werden sollen, anstatt sich auf die automatischen Funktionen von Capgo zu verlassen
• Ihre eigenen Prozesse, wie z.B. code-Signierung, QA-Tests oder Manager- genehmigungen, zwischen den Build- und Deploy-Schritten einfügen
• Capgo in Ihre bestehenden DevOps-Werkzeuge und -Workflows integrieren

Authentifizierung

Um den Capgo CLI zu verwenden, müssen Sie sich mit Ihrem API-Schlüssel authentifizieren. Sie können einen API-Schlüssel in Ihren Capgo-Konto-Einstellungen erstellen.

Um sich anzumelden und Ihren API-Schlüssel sicher zu speichern, führen Sie:

npx @capgo/cli@latest login [API_KEY]

Diese Anweisung wird dann für zukünftige Verwendung gespeichert. Sie müssen Ihren API-Schlüssel nicht mehr mit jedem Befehl nach der Anmeldung bereitstellen.

Schlüsselunterschiede zu anderen CLI-Tools

Wenn Sie mit anderen live-updatenfähigen CLI-Tools vertraut sind, gibt es ein paar wichtige Dinge zu beachten, die sich von Capgo’s CLI unterscheiden:

• Capgo verwendet einen einzigen CLI für beide Entwicklung- und CI/CD-Anwendungsfälle, da Capgo sich ausschließlich auf das live-updatenfähige Feature-Set konzentriert.

• Capgo-CLI erfordert keine separate Installationsschritte. Es ist mit dem @capgo/cli Paket und kann direkt ausgeführt werden, indem npx.

• Capgo’s CLI ist speziell für den Workflow der Live-Update-Verarbeitung konzipiert, sodass es möglicherweise nicht alle Funktionen oder Befehle enthält, die in allgemeinverwendeten CLI-Tools gefunden werden können.

Nächste Schritte

Kanäle

Erfahren Sie, wie Sie Kanäle verwenden können, um verschiedene Release-Tracks zu verwalten und Updates auf bestimmte Benutzer zuzielten.

Rückgänge

Entdecken Sie, wie Sie auf ein vorheriges JS-Bundle-Version zurückkehren können, wenn ein Update Probleme verursacht.

Aktualisierungsverhalten

Konfigurieren Sie, wie und wann Updates heruntergeladen und auf Ihrem App angewendet werden.

Schnelle Updates

Erfahren Sie, wie Sie schnelle Updates verwenden können, um den Update-Prozess zu beschleunigen.

Von Übersicht weitermachen

Wenn Sie Übersicht benutzen, um das Dashboard und API-Operationen zu planen, verbinden Sie es mit API-Übersicht zur Implementierungsdetail in API-Übersicht, Einführung zur Implementierungsdetail in Einführung, API-Schlüssel zur Implementierungsdetail in API-Schlüssel, Geräte für die Implementierungsdetails in Geräten und Bündel für die Implementierungsdetails in Bündeln.