Übersicht

Verwenden Sie Capgo’s Live-Updates-Funktion, um die JavaScript-Bundles Ihrer App in Echtzeit remote zu aktualisieren. Senden Sie JS-Updates direkt an Ihre Benutzer, ohne dass sie durch die App-Store-Bewertungsprozess gehen müssen, um Fehler sofort zu beheben und neue Funktionen bereitzustellen.

Hinweis

Live-Updates sind nur auf Änderungen an den JavaScript-Bundles beschränkt. Wenn Sie native code-Änderungen benötigen, wie z.B. die Hinzufügung oder Entfernung eines Plugins oder die Änderung der native Projekt-Konfiguration, müssen Sie ein neues natives Binärbaupaket an die App-Stores übermitteln.

Wie Live-Updates funktionieren

Capgo’s Live Update-System hat zwei Schlüsselelemente:

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

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

Wenn Sie ein neues JS-Bundle auf Capgo hochladen und es einem Kanal zuweisen, werden die Capgo SDK in Apps, die für diesen Kanal konfiguriert sind, das Update erkennen und herunterladen. Die nächste Zeit, wenn die App neu gestartet wird, wird das neue Bundle geladen.

Einstieg

Um Live Updates zu verwenden, folgen Sie bitte diesen Schritten:

1. Führen Sie das Capgo Quickstart aus, um Ihre App in Capgo einzurichten und das Capgo SDK zu installieren.

2. In Ihrer App code rufen Sie CapacitorUpdater.notifyAppReady() nachdem sich Ihre App initialisiert hat. Dies teilt der 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: überprüfen.

   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 Hinweis: für weitere Details.

Die Capgo CLI

Das Capgo CLI ist ein leistungsstarker Werkzeug, das Entwicklern ermöglicht, mit Capgo’s Diensten aus 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 Ihren bestehenden Enterprise-Workflows zu integrieren.

Wozu dient das Capgo CLI?

Das 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 Capgo’s eingebaute Automatisierung zu verlassen
• Ihre eigenen Prozesse, wie code-Signierung, QA-Testung oder Manager-Approbation, zwischen den Build- und Deploy-Schritten einfügen
• Capgo in Ihren bestehenden DevOps-Tooling und -Workflows integrieren

Authentifizierung

Um das Capgo CLI verwenden zu können, 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 Ihre API-Schlüssel nicht mehr mit jeder Anweisung nach dem Anmelden bereitstellen.

Schlüsselunterschiede zu anderen CLI-Tools

Wenn Sie mit anderen live aktualisierenden CLI-Tools vertraut sind, gibt es ein paar wichtige Dinge zu beachten, die Capgo’s CLI bietet:

• Capgo verwendet ein einziges CLI für beide Entwicklung- und CI/CD-Anwendungsfälle, da Capgo sich ausschließlich auf das Live-Update-Funktionsumfang konzentriert.

• Das Capgo-CLI erfordert keine separate Installationsschritte. Es ist mit dem @capgo/cli Paket verbunden und kann direkt mit dem npx.

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

Weitere 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-Verzeichnis zurückkehren können, wenn ein Update Probleme verursacht.

Update-Verhalten

Konfigurieren Sie, wie und wann Updates heruntergeladen und in Ihrer App angewendet werden.

Schnelle Updates

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