Live Update bereitstellen

Nutzen Sie die Live-Updates-Funktion von Capgo, um die Benutzeroberfläche und Geschäftslogik Ihrer App aus der Ferne in Echtzeit zu aktualisieren. Übertragen Sie JS-Bundle-Updates direkt an Ihre Nutzer, ohne den App Store zu durchlaufen, um sofort Fehler zu beheben und neue Funktionen bereitzustellen.

Diese Anleitung setzt voraus, dass Sie den Capgo Quickstart abgeschlossen haben und bereits:

1. Das @capgo/capacitor-updater SDK in Ihrer Capacitor-App installiert haben

2. Ihre App-ID und den Update-Kanal in capacitor.config.ts konfiguriert haben

3. Die CapacitorUpdater.notifyAppReady() Methode in Ihren Code eingefügt haben

Wenn Sie diese Schritte noch nicht ausgeführt haben, gehen Sie bitte zurück und schließen Sie zuerst den Quickstart ab

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

Bundle hochladen

Mit dem installierten und konfigurierten Capgo SDK können Sie Ihr erstes Live-Update-Bundle hochladen:

1. Web-Assets erstellen:

   npm run build

2. Bundle zu Capgo hochladen:

   Console

   npx @capgo/cli@latest upload --channel=Production

   Github Actions

   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@v4
       - uses: actions/setup-node@v4
         with:
           node-version: 18
       - name: Install dependencies
         run: npm install
       - name: Build
         run: npm run build
       - name: Deploy to Capgo
         run: bunx @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 lädt eine neue Bundle-Version in den im Befehl angegebenen Kanal hoch

Fehlerbehebung beim Hochladen

Wenn das Hochladen fehlschlägt, überprüfen Sie:

• Ihre App-ID in capacitor.config.ts stimmt mit Ihrer App im Capgo-Dashboard überein
• Sie führen den Upload-Befehl vom Root-Verzeichnis Ihres Capacitor-Projekts aus
• Ihre Web-Assets sind erstellt und aktuell

Wenn Sie immer noch Probleme haben, gehen Sie zum Abschnitt Fehlerbehebung

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 weiteres 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

   Oder öffnen Sie das iOS/Android-Projekt in Xcode/Android Studio und führen Sie einen nativen Start durch

4. Lassen Sie die App etwa 30 Sekunden geöffnet, damit das Update im Hintergrund heruntergeladen werden kann

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

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

Schauen Sie im Capgo Quickstart nach, um weitere Details zum Testen von Live-Updates zu erhalten

Nächste Schritte

Herzlichen Glückwunsch zum Bereitstellen Ihres ersten Live-Updates mit Capgo! 🎉

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

• Updates mit Kanälen zielgerichtet einsetzen
• Update-Verhalten anpassen
• Live-Update-Rollbacks