Übersicht

Nutze die Live-Updates-Funktion von Capgo, um die JavaScript-Bundles deiner App remote in Echtzeit zu aktualisieren. Push JS-Updates direkt an deine Nutzer, ohne den App-Store-Review-Prozess durchlaufen zu müssen, um Bugs sofort zu beheben und neue Features auszuliefern.

Verwenden Sie immer die neueste Version von CLI

Führe Capgo CLI immer mit aus @latest sein (zum Beispiel npx @capgo/cli@latest). Das CLI folgt seiner eigenen Versionierung und muss es nicht nicht mit der Major-Version deines Plugins oder der Capacitor übereinstimmen. Die 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 native code aktualisieren musst, z. B. um ein Plugin hinzuzufügen oder zu entfernen oder die native Projekt-Konfiguration zu ändern, musst du einen neuen nativen Binary-Build bei den App-Stores einreichen.

So funktionieren Live Updates

Das Live Update-System von Capgo hat zwei zentrale Komponenten:

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

2. Channels, mit denen du Updates gezielt an bestimmte Nutzergruppen ausspielen kannst. Du kannst Channels nutzen, um verschiedene Release-Tracks zu verwalten, z. B. Production, Staging, und Dev.

Wenn du ein neues JS-Bundle zu Capgo hochlädst und es 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 Neustart der App wird das neue Bundle geladen.

Erste Schritte

Um Live Updates zu nutzen, 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 die Initialisierung abgeschlossen hat. Dies teilt dem Capgo SDK mit, dass deine App bereit ist, Updates zu empfangen.

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 auf den Download des Updates. Den Status kannst du so prüfen:

   npx @capgo/cli@latest app debug

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

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

Die Capgo CLI

Das Capgo CLI ist ein leistungsstarkes Tool, mit dem Entwickler direkt aus ihren eigenen CI/CD-Pipelines heraus auf die Services von Capgo zugreifen können. Mit dem CLI haben Sie die feingranulare Kontrolle darüber, wann Builds erstellt und deployed werden, sodass Sie Capgo in Ihre bestehenden Enterprise-Workflows integrieren können.

Wofür ist das Capgo CLI gedacht?

Das Capgo CLI ist für Entwickler und Teams gedacht, die mehr Kontrolle und Flexibilität in ihren live update-Workflows brauchen. Mit dem CLI in Ihren CI/CD-Pipelines können Sie:

• Genau festlegen, wann Updates gebaut und deployed werden, statt 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.

Zum Anmelden und sicheren Speichern Ihres API-Schlüssels ausführen:

npx @capgo/cli@latest login [API_KEY]

Dieser Befehl wird dann für die zukünftige Nutzung gespeichert. Nach dem Login müssen Sie Ihren API-Key nicht mehr bei jedem Befehl angeben.

Wesentliche Unterschiede zu anderen CLI Tools

Wenn Sie mit anderen live update CLI-Tools vertraut sind, sollten Sie bei den CLI von Capgo ein paar wichtige Punkte beachten:

• Capgo verwendet ein einzelnes CLI sowohl für die Entwicklung als auch für CI/CD-Szenarien, da Capgo sich ausschließlich auf den live update-Funktionsumfang konzentriert.

• Das Capgo CLI erfordert keinen separaten Installationsschritt. Es ist im @capgo/cli Paket enthalten und kann direkt ausgeführt werden mit npx.

• Das CLI von Capgo ist speziell für den live update-Workflow konzipiert und enthält daher möglicherweise nicht alle Funktionen oder Befehle, die in allgemeineren CLI-Tools zu finden sind.

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ückrollst, 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 mit Fast Updates den Update-Prozess beschleunigst.

Weiter geht's ab der Übersicht

Wenn du es nutzt Übersicht um Dashboard- und API-Operationen zu planen, verbinde es mit API Übersicht für Details zur Implementierung im API Overview, Einführung für die Implementierungsdetails in der Einleitung, API Schlüssel für die Implementierungsdetails in API Keys, Geräte für die Implementierungsdetails in Devices und Bundles für die Implementierungsdetails in Bundles.