Übersicht

Verwenden Sie Capgo’s Live Updates-Funktion, um die JavaScript-Bundles Ihrer App fernübertragen und in Echtzeit zu aktualisieren. Drücken Sie JS-Updates direkt an Ihre Benutzer weiter, ohne dass sie durch den App-Store-Review-Prozess gehen müssen, um Fehler sofort zu beheben und neue Funktionen bereitzustellen.

Anmerkung

Live Updates sind auf Änderungen an 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ärpaket an die App-Stores übermitteln.

Wie Live Updates funktionieren

Capgo’s Live-Update-System besteht aus zwei Schlüsselfunktionen:

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 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 bei 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. Die nächste App-Neustartladung lädt das neue Bundle.

Anfangen

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

1. Erledigen Sie das Capgo Schnellstart um Ihre App bei Capgo einzurichten und die Capgo SDK zu installieren.

2. In Ihrer App code ruft man CapacitorUpdater.notifyAppReady() nachdem Ihre App fertig initialisiert wurde. Dies teilt der Capgo SDK mit, dass Ihre App bereit ist, Updates zu empfangen.

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

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

4. Öffnen Sie Ihre App und warten Sie auf das Update. Sie können den Status mit:

   npx @capgo/cli@latest app debug

5. Schließen Sie die Anwendung und öffnen Sie sie erneut, nachdem die Aktualisierung heruntergeladen wurde, um die neue Bundle zu laden.

Siehe auch das Lebendliche Updates bereitstellen Weitere Details finden Sie im Leitfaden.

Die Capgo CLI

Die Capgo CLI ist ein leistungsstarker Werkzeug, das Entwicklern ermöglicht, mit Capgo’s Diensten aus ihren eigenen CI/CD-Pipelines zu interagieren. Mit der 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.

Was ist die Capgo CLI für?

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

• Beschließen, wann Updates erstellt und bereitgestellt werden sollen, anstatt sich auf die automatisierte Funktionen von Capgo zu verlassen
• Einfügen Sie Ihre eigenen Prozesse, wie z.B. code-Signierung, QA-Testung oder Genehmigungen durch den Manager, zwischen den Aufbau- und Bereitstellungsschritten.
• Integrieren Sie Capgo in Ihre bestehenden DevOps-Tooling und -Workflows.

Authentifizierung

Um die 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 Folgendes aus:

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.

Hauptunterschiede 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 eine einzige CLI für beide Entwicklung und CI/CD-Anwendungsfälle, da Capgo sich ausschließlich auf die Live-Update-Funktionalität konzentriert.

• Die Capgo CLI erfordert keine separate Installationsschritt. Sie ist mit dem Paket verbunden und kann direkt mit dem @capgo/cli __CAPGO_KEEP_0__’s __CAPGO_KEEP_1__ ist speziell für den Live-Update-Workflow konzipiert, sodass sie möglicherweise nicht alle Funktionen oder Befehle enthält, die in allgemeinverwendeten __CAPGO_KEEP_2__-Tools gefunden werden. npx.

• Capgo’s CLI is designed specifically for the live update workflow, so it may not include some features or commands found in more general-purpose CLI tools.

Abschnitt mit dem Titel „Nächste Schritte“

Erfahren Sie, wie Sie Kanäle verwenden, 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, wenn ein Update Probleme verursacht.

Update-Verhalten

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

__CAPGO_KEEP_0__

Schnelle Updates

Erhalten Sie Informationen, wie Sie schnelle Updates nutzen können, um den Update-Prozess zu beschleunigen.