Ein Live-Update bereitstellen

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

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

1. Die @capgo/capacitor-updater SDK in your Capacitor app

2. in Ihrem capacitor.config.ts

3. Added in your code the CapacitorUpdater.notifyAppReady() installiert haben

Ihre App-ID und Update-Kanal konfiguriert haben in

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

Ein Bundle hochladen

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

1. Bauen Sie Ihre Web-Ressourcen:

   npm run build

2. Hochladen Sie das Bundle bei Capgo:

   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 Uploads

Wenn Ihr Upload fehlschlägt, überprüfen Sie bitte:

• Ihre App-ID in capacitor.config.ts passt zu Ihrer App im Capgo-Dashboard
• Sie führen den Upload-Befehl aus der Projektroot Ihres Capacitor-Projekts aus
• Ihre Web-Assets sind gebaut und auf dem neuesten Stand

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

Ein Update auf einem Gerät empfangen

Sobald Ihr Bundle hochgeladen ist, können Sie das Live-Update 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. Ihr App lokal ausführen:

   npx cap run ios

   Oder öffnen Sie das iOS/Android-Projekt in Xcode/Android Studio und führen eine native Ausführung durch.

4. Halten Sie die App etwa 30 Sekunden geöffnet, um den Download des Updates im Hintergrund zu ermöglichen.

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

6. Schließen und die App neu öffnen. Sie sollten Ihr Live-Update angewendet sehen!

Zurückverweisen Sie sich auf das Capgo Quickstart für weitere Details zu Testen von Live-Updates.

Weitere Schritte

Herzlichen Glückwunsch zum erfolgreichen Bereitstellen deiner ersten Live-Update mit Capgo! 🎉

Um mehr zu erfahren, überprüfe den Rest der Capgo Live-Updates-DokumentationEinige wichtige Themen, die du als Nächstes überprüfen solltest:

• Zielgruppen-Updates mit Kanälen
• Anpassen des Update-Verhaltens
• Live-Update-Rollbacks