Deploy a Live Update

Nutzen Sie Capgo’s Live-Updates-Funktion, um die Benutzeroberfläche und die Geschäftslogik Ihres Apps ferngesteuert und in Echtzeit zu aktualisieren. Pushen Sie JS-Bundle-Updates direkt an Ihre Benutzer weiter, ohne durch den App Store zu gehen, um Fehler sofort zu beheben und neue Funktionen bereitzustellen.

Tip

Capgo lädt das generierte Web-Build-Ordner hoch. HTML, CSS, JavaScript, Assets und reinen-JavaScript-Paketänderungen können OTA erfolgen, sobald sie dort gebündelt sind. Änderungen an capacitor.config.ts, native Plugin-Konfiguration, native Paketen oder iOS/Android-Projektdateien erfordern eine native App-Veröffentlichung.

Diese Anleitung geht davon aus, dass Sie das Capgo Quickstart und haben Sie bereits:

1. Installieren Sie das @capgo/capacitor-updater SDK in Ihrem Capacitor-Anwendungsprojekt

2. Konfigurieren Sie Ihren App-Id und Update-Kanal in capacitor.config.ts

3. Hinzufügen Sie in Ihrem code das CapacitorUpdater.notifyAppReady() Methode

Wenn Sie diese Schritte noch nicht durchgeführt haben, gehen Sie bitte zurück und beenden Sie das Schnellstart-Programm zuerst.

Hinzufügen Sie eine App Fügen Sie eine App zu Ihrem Capgo-Konto hinzu und installieren Sie das Plugin in Ihrer App

Ein Hochladen eines Bundles

Mit dem installierten und konfigurierten Capgo SDK sind Sie bereit, Ihr erstes Live-Update-Bundle hochzuladen:

1. Deine Web-Assets erstellen:

   npm run build

2. Lade das Bundle auf Capgo hoch:

   Konsole

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

   Github-Aktionen

   .github/workflows/build_and_deploy.yml

   name: Build source code and send to Capgo
   
   concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true
   
   on:
   push:
     branches:
       - main
   
   jobs:
   deploy_to_capgo:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
         uses: actions/checkout@v6
       - uses: actions/setup-node@v6
         with:
           node-version: '24'
       - name: Install dependencies
         run: npm install
       - name: Build
         run: npm run build
       - name: Deploy to Capgo
         run: npx @capgo/cli@latest bundle upload -a ${{ secrets.CAPGO_TOKEN }} --channel ${{ env.CHANNEL }}
         env:
           CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}

   Gitlab

   .gitlab-ci.yml

   stages:
     - build
   
   build:
     stage: build
     image: node:18
     cache:
       - key:
           files:
             - package-lock.json
         paths:
           - .node_modules/
     script:
       - npm install
       - npm run build
       - npx @capgo/cli@latest bundle upload -a $CAPGO_TOKEN --channel $CAPGO_CHANNEL
     artifacts:
       paths:
         - node_modules/
         - dist/
     only:
       - master

   Dies wird eine neue Bundle-Version auf den im Befehl angegebenen Kanal hochladen.

Fehlerbehebungen bei der Hochladung

Wenn Ihre Hochladung fehlschlägt, überprüfen Sie bitte:

• Ihre App-ID in capacitor.config.ts stimmt mit Ihrer App im Capgo-Dashboard überein
• Sie führen den Upload-Befehl vom Root-Ordner Ihres Capacitor-Projekts aus
• Ihre Web-Assets sind gebaut und auf dem neuesten Stand

Wenn Sie weiterhin Schwierigkeiten haben, gehen Sie zur Fehlerbehebung Abschnitt.

Ein Gerät auf Updates empfängt

Sobald Ihr Bundle hochgeladen ist, können Sie die lebendige Aktualisierung auf einem Gerät testen:

1. Synchronisieren Sie Ihre App mit dem Gerät:

   npx cap sync ios

2. Öffnen Sie ein anderes Terminal und führen Sie den folgenden Befehl aus, um den Update-Status zu überprüfen:

   npx @capgo/cli@latest app debug

3. Führen Sie Ihre App lokal aus:

   npx cap run ios

   Öffnen Sie das iOS/Android-Projekt in Xcode/Android Studio und führen Sie eine native Laufzeit durch.

4. Das Update herunterzuladen, lassen Sie das Programm etwa 30 Sekunden geöffnet.

5. Die Protokolle werden einige Sekunden brauchen, um zu aktualisieren und den Update-Status anzuzeigen.

6. Schließen und das Programm neu öffnen. Sie sollten Ihren Live-Update angewendet sehen!

Zurückgehen Sie zu dem Capgo Schnellstart zur mehr Details zu Testen Live-Updates.

Zukünftige Schritte

Herzlichen Glückwunsch, Sie haben Ihren ersten Live-Update mit Capgo erfolgreich implementiert! 🎉

Um mehr zu erfahren, überprüfen Sie die restlichen Dokumentation von Capgo Live-Updates. Einige wichtige Themen, die Sie als Nächstes überprüfen sollten:

• Zielgruppenaktualisierungen mit Kanälen
• Anpassen der Aktualisierungsverhaltensweise
• Live-Aktualisierungs-Wiederherstellungen

Bleiben Sie bei der Implementierung einer Live-Aktualisierung

Wenn Sie Eine Live-Aktualisierung bereitstellen um die CI/CD-Automatisierung zu planen, verbinden Sie sie mit Capgo CI/CD für den Produktworkflow in Capgo CI/CD, Capgo Native Builds für den Produktworkflow in Capgo Native Builds Capgo Integrations für den Produktworkflow in Capgo Integrations CI/CD-Integration für die Implementierungsdetails in CI/CD-Integration und GitHub Actions-Integration für die Implementierungsdetails in GitHub Actions-Integration.