Ein Live-Update bereitstellen

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

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.tsErfordern Sie eine native App-Veröffentlichung, wenn Sie native Plugin-Konfigurationen, native Pakete oder iOS-/Android-Projektdateien verwenden.

Diese Anleitung setzt voraus, dass Sie die Capgo Schnellstart und bereits haben:

1. Installiert haben Sie das @capgo/capacitor-updater SDK in your Capacitor app

2. __CAPGO_KEEP_1__-App capacitor.config.ts

3. Added in your code the CapacitorUpdater.notifyAppReady() __CAPGO_KEEP_0__ hinzugefügt haben Sie die

__CAPGO_KEEP_0__-Methode

Wenn Sie diese Schritte noch nicht durchgeführt haben, gehen Sie bitte zurück und beenden Sie den Schnellstart zuerst. Add an app to your Capgo account, and install the plugin in your app

Ein Bundle hochladen

Mit der Capgo SDK installiert und konfiguriert, bist du bereit, dein erstes Live-Update-Bundle hochzuladen:

1. Bau deine Web-Assets:

   npm run build

2. Hochlade 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.

Fehlerbehebung bei Uploads

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

• Ihre App-ID in capacitor.config.ts entspricht Ihrer App im Capgo-Dashboard
• Sie führen den Upload-Befehl vom Root-Verzeichnis Ihres Capacitor-Projekts aus
• Ihre Web-Assets sind auf dem neuesten Stand und wurden erfolgreich erstellt

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

Ein Update auf einem Gerät erhalten

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. Deine App lokal ausführen:

   npx cap run ios

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

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

5. Die Protokolle werden einige Sekunden benötigen, um aktualisiert und den Update-Status anzuzeigen.

6. Schließe die App und öffne sie erneut. Du solltest dein Live-Update angewendet sehen!

Zurückgehen zu der Capgo Schnellstartanleitung Für weitere Details zu Testen von Live-Updates siehe die

Zukünftige Schritte

Congrats on deploying your first live update with Capgo! 🎉

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

• Zielgruppen für Updates mit Kanälen
• Anpassung der Updateverhalten
• Live-Update-Rollbacks

Fortsetzen Sie von Deploy ein Live-Update

Wenn Sie Deploy ein Live-Update zum Planen von CI/CD-Automatisierung verwenden, verbinden Sie es mit Deploy ein Live-Update Um CI/CD-Automatisierung zu planen, verbinden Sie es mit Capgo CI/CD zur Produktworkflow in Capgo CI/CD Capgo Native Builds zur Produktworkflow in Capgo Native Builds Capgo Integrations zur Produktworkflow in Capgo Integrations CI/CD-Integration zur Implementierungsdetail in CI/CD-Integration und GitHub Actions-Integration zur Implementierungsdetail in GitHub Actions-Integration