Übersicht

Nutzen 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 durch den App-Store-Überprüfungsprozess zu gehen, um Bugs sofort zu beheben und neue Funktionen zu liefern.

Benutzen Sie immer die neueste CLI

Führen Sie immer Capgo CLI aus @latest zum Beispiel npx @capgo/cli@latest). Die CLI folgt ihrer eigenen Versionsnummerierung und braucht nicht sich an Ihre Plugin-Major- oder Capacitor-Major-Version anpassen. Die neueste CLI bleibt mit jeder unterstützten Updater-Plugin-Version kompatibel. Siehe Capgo Versionsnummerierung.

Hinweis

Live Updates sind nur auf Änderungen an JavaScript-Bundles beschränkt. Wenn Sie native code aktualisieren müssen, wie zum Beispiel ein Plugin hinzufügen oder entfernen oder die native Projekt-Konfiguration ändern, müssen Sie ein neues natives Binär-Update an die App-Stores übermitteln.

How Live Updates Work

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

1. Die Capgo SDK, die Sie in Ihrer App installieren. Die 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.

Getting Started

Um mit Live Updates zu beginnen, folgen Sie diesen Schritten:

1. Abschließen Sie das Capgo Quickstart Ihre App in Capgo zu konfigurieren und das Capgo SDK zu installieren.

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

3. Ihren JS-Bundle erstellen und hochladen Sie es auf Capgo:

   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:

   npx @capgo/cli@latest app debug

5. Sobald das Update heruntergeladen ist, schließen Sie Ihre App und öffnen Sie sie erneut, um das neue Bundle zu laden.

Siehe das Lebendige Updates bereitstellen Leitfaden für weitere Details.

Das Capgo CLI

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

Worfür ist 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 die automatischen Funktionen von Capgo zu verlassen
• Ihre eigenen Prozesse, wie z.B. code-Signierung, QA-Tests oder Manager-Approbationen, zwischen den Build- und Deploy-Schritten einsetzen
• Capgo in Ihre bestehenden DevOps-Werkzeuge und -Workflows integrieren

Authentifizierung

Um das 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.

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 einzelnes CLI für beide Entwicklung- und CI/CD-Anwendungsfälle, da Capgo sich ausschließlich auf das live aktualisierende Feature-Set konzentriert.

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

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

Weiterführende 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ängig-Machen

Entdecken Sie, wie Sie auf ein vorheriges JS-Bundle-Update 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.

Weiter von der Übersicht

If Sie __CAPGO_KEEP_0__ verwenden, Übersicht um das Dashboard und API-Operationen zu planen, verbinden Sie es mit API-Übersicht zur Implementierungsdetail in API-Übersicht, Einführung zur Implementierungsdetail in Einführung, API-Schlüssel zur Implementierungsdetail in API-Schlüssel, Geräte zur Implementierungsdetail in Geräte, und Pakete für die Implementierungsdetails in Bundles.