Zum Inhalt springen

Übersicht

Nutzen Sie Capgos Live-Updates-Funktion, um die JavaScript-Bundles Ihrer App aus der Ferne in Echtzeit zu aktualisieren. Senden Sie JS-Updates direkt an Ihre Nutzer, ohne den App-Store-Überprüfungsprozess zu durchlaufen, um sofort Fehler zu beheben und neue Funktionen bereitzustellen.

Wie Live-Updates funktionieren

Das Live-Update-System von Capgo hat zwei Schlüsselkomponenten:

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

  2. Kanäle, mit denen Sie Updates für bestimmte Benutzergruppen bereitstellen können. Sie können Kanäle verwenden, um verschiedene Release-Tracks wie Production, Staging und Dev zu verwalten.

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

Erste Schritte

Folgen Sie diesen Schritten, um mit Live-Updates zu beginnen:

  1. Schließen Sie den Capgo Quickstart ab, um Ihre App in Capgo einzurichten und das Capgo SDK zu installieren.

  2. Rufen Sie in Ihrem App-Code CapacitorUpdaternotifyAppReady() auf, nachdem Ihre App initialisiert wurde. Dies teilt dem Capgo SDK mit, dass Ihre App bereit ist, Updates zu empfangen.

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

    Terminal-Fenster
    npm run build
    npx @capgo/cli@latest upload --channel=Production
  4. Öffnen Sie Ihre App und warten Sie, bis das Update heruntergeladen ist. Sie können den Status überprüfen mit:

    Terminal-Fenster
    npx @capgo/cli@latest app debug
  5. Sobald das Update heruntergeladen ist, schließen und öffnen Sie Ihre App erneut, um das neue Bundle zu laden.

Weitere Details finden Sie im Leitfaden für Live-Updates-Bereitstellung.

Die Capgo CLI

Die Capgo CLI ist ein leistungsstarkes Tool, das Entwicklern ermöglicht, mit Capgos Diensten aus ihren eigenen CI/CD-Pipelines zu interagieren. Mit der CLI haben Sie detaillierte Kontrolle darüber, wann Builds erstellt und bereitgestellt werden, sodass Sie Capgo in Ihre bestehenden Enterprise-Workflows integrieren können.

Wofür ist die Capgo CLI gedacht?

Die 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 der CLI in Ihren CI/CD-Pipelines können Sie:

  • Genau festlegen, wann Updates erstellt und bereitgestellt werden sollen, anstatt sich auf Capgos integrierte Automatisierung zu verlassen
  • Eigene Prozesse wie Code-Signierung, QA-Tests oder Manager-Genehmigungen zwischen den Build- und Bereitstellungsschritten einfügen
  • Capgo in Ihre bestehenden DevOps-Tools und -Workflows integrieren

Authentifizierung

Um die Capgo CLI zu nutzen, müssen Sie sich mit Ihrem API-Schlüssel authentifizieren. Sie können einen API-Schlüssel in Ihren Capgo-Kontoeinstellungen generieren.

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

Terminal-Fenster
npx @capgo/cli@latest login [API_KEY]

Dieser Befehl wird dann für zukünftige Verwendungen gespeichert. Nach der Anmeldung müssen Sie Ihren API-Schlüssel nicht bei jedem Befehl erneut angeben.

Wichtige Unterschiede zu anderen CLI-Tools

Wenn Sie mit anderen Live-Update-CLI-Tools vertraut sind, gibt es einige wichtige Besonderheiten der Capgo CLI zu beachten:

  • Capgo verwendet eine einzige CLI sowohl für Entwicklungs- als auch für CI/CD-Anwendungsfälle, da Capgo sich ausschließlich auf Live-Update-Funktionen konzentriert

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

  • Die Capgo CLI ist speziell für den Live-Update-Workflow konzipiert und enthält möglicherweise nicht alle Funktionen oder Befehle, die in allgemeineren CLI-Tools zu finden sind

Nächste Schritte