Übersicht

Verwenden Sie die Live-Updates-Funktion von Capgo zum Update der JavaScript-Bundles Ihrer App in Echtzeit. Drücken Sie JS-Updates direkt an Ihre Benutzer weiter, ohne durch den App-Store-Review-Prozess zu gehen, um Bugs sofort zu beheben und neue Funktionen zu liefern.

Verwenden Sie immer die neueste CLI

Laufen Sie immer Capgo CLI mit @latest (zum Beispiel) npx @capgo/cli@latestDie CLI folgt ihrer eigenen Versionsnummerierung und tut. not Um Ihre Plugin-Major-Version oder die Capacitor-Major-Version zu entsprechen. Die neueste CLI-Version bleibt mit jeder unterstützten Updater-Plugin-Version kompatibel. Siehe Capgo Versionsverwaltung.

Note

Live Updates are limited to JavaScript bundle changes. If you need to update native code, such as adding or removing a plugin or changing native project configuration, you’ll need to submit a new native binary build to the app stores.

Wie Live Updates funktionieren

Capgo’s Live Update-System hat zwei wichtige Komponenten:

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, Stagingund Dev.

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

Getting Started

Um Live Updates zu verwenden, folgen Sie diesen Schritten:

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

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

3. Erstellen 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 die Aktualisierung 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 die Live-Updates bereitstellen Weitere Details finden Sie im Leitfaden

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 granulare Kontrolle darüber, wann Builds erstellt und bereitgestellt werden, was Ihnen ermöglicht, Capgo in Ihren bestehenden Enterprise-Workflows zu integrieren.

Was ist das Capgo CLI für?

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
• Einfügen Sie Ihre eigenen Prozesse, wie z.B. code-Signierung, QA-Testung oder Managergenehmigungen, zwischen den Build- und Deploy-Schritten.
• Capgo in Ihren bestehenden DevOps-Werkzeugen 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.

To log in and securely store your API key, run:

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.

Hauptunterschiede zu anderen CLI-Tools

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

• Capgo verwendet ein einzelnes CLI für beide Entwicklung und CI/CD-Anwendungsfällen, da Capgo sich ausschließlich auf die live update-Funktionalität konzentriert.

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

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

Nächste Schritte

Channels

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 zu einer vorherigen JS-Bundle-Version zurückrollen, wenn ein Update Probleme verursacht.

Aktualisierungsverhalten

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

Schnelle Updates

Lernen Sie, wie Sie schnelle Updates einsetzen, um den Update-Prozess zu beschleunigen.

Weiter von der Übersicht

Wenn Sie Capgo verwenden Overview um das Dashboard und die 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 für die Implementierungsdetails in Devices, und Bundles für die Implementierungsdetails in Bundles.