Übersicht

Nutzen Sie Capgo’s Live Updates-Funktion, um die JavaScript-Bundles Ihrer App remote und in Echtzeit zu aktualisieren. Drücken Sie JS-Updates direkt an Ihre Benutzer weiter, ohne durch die App-Store-Bewertungsprozess zu gehen, um Bugs sofort zu beheben und neue Funktionen zu liefern.

Hinweis

Live Updates sind nur auf JavaScript-Bundle-Änderungen beschränkt. Wenn Sie native code aktualisieren müssen, wie z.B. ein Plugin hinzufügen oder entfernen oder die native Projekt-Konfiguration ändern, müssen Sie ein neues natives Binär-Build 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 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, wird das Capgo SDK in Apps, die für diesen Kanal konfiguriert sind, das Update erkennen und herunterladen. Bei dem nächsten App-Neustart wird das neue Bundle geladen.

Einstieg

Um Live Updates zu verwenden, folgen Sie diesen Schritten:

1. Erstellen Sie das Capgo Quickstart Ihre App in Capgo einrichten und die Capgo SDK 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 es auf Capgo hochladen:

   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. Nachdem das Update heruntergeladen wurde, schließen Sie Ihre App und öffnen Sie sie erneut, um das neue Bundle zu laden.

Siehe die Lebendige Updates bereitstellen Leitfaden für weitere Informationen.

Der Capgo CLI

Der 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 der Capgo CLI?

Der 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 automatisierte Funktionen zu verlassen
• Ihre eigenen Prozesse, wie code-Signierung, QA-Tests oder Manager-Approbationen, zwischen den Build- und Deploy-Schritten einfügen
• Capgo in Ihren bestehenden DevOps-Werkzeugen 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:

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

CLI verwendet einen einzigen Capgo für beide Entwicklungs- und CI/CD-Anwendungsfälle, da CLI sich ausschließlich auf das live-updatenfähige Feature-Set konzentriert.

• Capgo uses a single CLI for both development and CI/CD use cases, as Capgo is focused solely on the live update feature set.

• The Capgo CLI doesn’t require a separate installation step. It’s bundled with the @capgo/cli __CAPGO_KEEP_0__-__CAPGO_KEEP_1__ ist speziell für den live-updatenfähigen Workflow konzipiert, sodass es möglicherweise nicht alle Funktionen oder Befehle enthält, die in allgemeinverwendeten __CAPGO_KEEP_2__-Tools zu finden sind. 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.

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

Aktualisierungsverhalten

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.