Übersicht

Nutze die Live Updates von Capgo, um die JavaScript-Bundles deiner App remote und in Echtzeit zu aktualisieren. Pushe JS-Updates direkt an deine Nutzer, ohne den App Store Review-Prozess abzuwarten, um Bugs sofort zu fixen und neue Features auszurollen.

Nutze immer die neueste CLI Version

Führe Capgo CLI immer mit @latest (zum Beispiel npx @capgo/cli@latest). Das CLI folgt einer eigenen Versionierung und muss nicht nicht mit der Major-Version deines Plugins oder Capacitor übereinstimmen. Das neueste CLI bleibt mit jeder unterstützten Updater-Plugin-Version kompatibel. Siehe Capgo Versionierung.

Hinweis

Live Updates sind auf Änderungen am JavaScript-Bundle beschränkt. Wenn du natives code aktualisieren musst, etwa durch das Hinzufügen oder Entfernen eines Plugins oder das Ändern der nativen Projektkonfiguration, musst du einen neuen nativen Binary Build in die App Stores einreichen.

So funktionieren Live Updates

Das Live Update System von Capgo besteht aus zwei Kernkomponenten:

1. Das Capgo SDK, das du in deiner App installierst. Der SDK prüft im Hintergrund auf verfügbare Updates und lädt diese herunter.

2. Channels ermöglichen es dir, Updates gezielt an bestimmte Nutzergruppen auszuliefern. Du kannst Channels nutzen, um verschiedene Release-Tracks zu verwalten, wie zum Beispiel Production, Staging, und Dev.

Sobald du ein neues JS-Bundle zu Capgo hochlädst und einem Channel zuweist, erkennt das Capgo SDK in Apps, die für diesen Channel konfiguriert sind, das Update und lädt es herunter. Beim nächsten App-Neustart wird das neue Bundle geladen.

Erste Schritte

Um mit Live Updates zu beginnen, folge diesen Schritten:

1. Schließe den Capgo Quickstart ab um deine App in Capgo einzurichten und das Capgo SDK zu installieren.

2. Rufe in deiner App code CapacitorUpdater.notifyAppReady() auf, nachdem deine App vollständig initialisiert wurde. Dies teilt dem Capgo SDK mit, dass deine App bereit für Updates ist.

3. Erstelle dein JS-Bundle und lade es zu Capgo hoch:

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

4. Öffne deine App und warte, bis das Update heruntergeladen wurde. Den Status kannst du hier prüfen:

   npx @capgo/cli@latest app debug

5. Sobald das Update heruntergeladen ist, schließe und öffne deine App neu, um das neue Bundle zu laden.

Siehe den Live Updates Deployment Guide für weitere Details.

Das Capgo CLI

Das Capgo CLI ist ein leistungsstarkes Tool, mit dem Entwickler direkt aus ihren CI/CD-Pipelines auf die Services von Capgo zugreifen können. Mit dem CLI hast du die volle Kontrolle darüber, wann Builds erstellt und deployed werden, sodass du Capgo nahtlos in deine bestehenden Enterprise-Workflows integrieren kannst.

Wofür ist das Capgo CLI gedacht?

Das Capgo CLI wurde für Entwickler und Teams entwickelt, die mehr Kontrolle und Flexibilität in ihren live update Workflows benötigen. Durch die Nutzung des CLI in Ihren CI/CD-Pipelines können Sie:

• Genau festlegen, wann Updates gebaut und deployed werden, anstatt sich auf die integrierte Automatisierung von Capgo zu verlassen
• Füge zwischen den Build- und Deploy-Schritten eigene Prozesse ein, wie z. B. code Signing, QA-Tests oder Freigaben durch Manager.
• Capgo in Ihre bestehenden DevOps-Tools und Workflows integrieren

Authentifizierung

Um das Capgo CLI zu nutzen, müssen Sie sich mit Ihrem API Key authentifizieren. Einen API Key können Sie in Ihren Capgo Account-Einstellungen generieren.

To log in and securely store your API key, run:

npx @capgo/cli@latest login [API_KEY]

Dieser Befehl wird für die zukünftige Nutzung gespeichert. Nach dem Login musst du deinen API Key nicht mehr bei jedem Befehl angeben.

Wesentliche Unterschiede zu anderen CLI Tools

Wenn du andere live update CLI Tools kennst, gibt es ein paar wichtige Punkte zum CLI von Capgo zu beachten:

• Capgo nutzt ein einziges CLI sowohl für die Entwicklung als auch für CI/CD, da Capgo sich rein auf das live update Feature-Set konzentriert.

• Das Capgo CLI erfordert keinen separaten Installationsschritt. Es ist im @capgo/cli Package enthalten und kann direkt über npx.

• Das CLI von Capgo ist speziell für den live update Workflow konzipiert und enthält daher eventuell nicht alle Features oder Commands allgemeiner CLI Tools.

Nächste Schritte

Kanäle

Erfahre, wie du Channels nutzt, um verschiedene Release-Tracks zu verwalten und Updates gezielt an bestimmte Nutzer auszurollen.

Rollbacks

Erfahre, wie du zu einer vorherigen JS-Bundle-Version zurückkehrst, falls ein Update Probleme verursacht.

Update-Verhalten

Lege fest, wie und wann Updates in deiner App heruntergeladen und angewendet werden.

Schnelle Updates

Erfahre, wie du Fast Updates nutzt, um den Update-Prozess zu beschleunigen.

Weiter geht's ab der Übersicht

Wenn Sie ... verwenden Übersicht Um Dashboard- und API-Operationen zu planen, verbinde es mit API Übersicht für Details zur Implementierung in der Übersicht zu API, Einführung für das Implementierungsdetail in der Einleitung, API Keys für die Implementierungsdetails in API Keys, Geräte für die Implementierungsdetails unter Devices und Bundles für die Implementierungsdetails in Bundles.