Live Update deployen

Nutze die Live Updates von Capgo, um die UI und die Business-Logik deiner App remote und in Echtzeit zu aktualisieren. Pushe JS-Bundle-Updates direkt an deine Nutzer, ohne Umweg über den App Store, um Bugs sofort zu fixen und neue Features auszuliefern.

Tipp

Capgo lädt den generierten Web-Build-Ordner hoch. HTML, CSS, JavaScript, Assets und reine JavaScript-Package-Änderungen können per OTA gehen, sobald sie dort gebündelt sind. Änderungen an capacitor.config.ts... native Plugin-Konfigurationen, native Packages oder iOS/Android-Projektdateien erfordern ein Native Build.

Dieser Guide setzt voraus, dass du den Capgo Quickstart ab, und haben bereits:

1. Installation des @capgo/capacitor-updater SDK in deiner Capacitor App

2. App-ID und Update-Channel konfiguriert in capacitor.config.ts

3. In deinem code hinzugefügt: CapacitorUpdater.notifyAppReady() Methode

Falls du diese Schritte noch nicht erledigt hast, geh bitte zurück und schließe zuerst den Quickstart ab.

App hinzufügen Füge deinem Capgo Account eine App hinzu und installiere das Plugin in deiner App

Bundle hochladen

Nachdem du Capgo SDK installiert und konfiguriert hast, kannst du dein erstes live update Bundle hochladen:

1. Web-Assets builden:

   npm run build

2. Bundle zu Capgo hochladen:

   Konsole

   npx @capgo/cli@latest bundle 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@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

   Dadurch wird eine neue Bundle-Version in den im Befehl angegebenen Channel hochgeladen.

Upload-Probleme beheben

Falls dein Upload fehlschlägt, prüfe Folgendes:

• Ob deine App-ID in capacitor.config.ts mit deiner App im Capgo Dashboard übereinstimmt
• Ob du den Upload-Befehl im Root deines Capacitor Projekts ausführst
• Ob deine Web-Assets gebaut und aktuell sind

Wenn du weiterhin Probleme hast, gehe zum Fehlerbehebung Abschnitt.

Ein Update auf einem Gerät empfangen

Sobald dein Bundle hochgeladen ist, kannst du live update auf einem Gerät testen:

1. Synchronisiere deine App mit dem Gerät:

   npx cap sync ios

2. Öffne ein weiteres Terminal und führe diesen Befehl aus, um den Update-Status zu prüfen:

   npx @capgo/cli@latest app debug

3. Starte deine App lokal:

   npx cap run ios

   Oder öffne das iOS/Android-Projekt in Xcode/Android Studio und starte es nativ.

4. Lass die App etwa 30 Sekunden offen, damit das Update im Hintergrund heruntergeladen werden kann.

5. Die Logs brauchen ein paar Sekunden, bis sie aktualisiert sind und den Update-Status anzeigen.

6. Schließe und öffne die App erneut. Du solltest sehen, dass dein live update angewendet wurde!

Siehe dazu die Capgo Quickstart ab, für weitere Details zum Testen von Live Updates.

Nächste Schritte

Glückwunsch, du hast dein erstes live update mit Capgo deployed! 🎉

Um mehr zu erfahren, lies den Rest der Capgo Live Updates Dokumentation. Some key topics to check out next:

• Updates mit Channels steuern
• Update-Verhalten anpassen
• Live Update Rollbacks

Weiter geht's mit Deploy a Live Update

Wenn du es nutzt Live Update deployen um CI/CD-Automatisierung zu planen, verbinde es mit Capgo CI/CD für den Produkt-Workflow in Capgo CI/CD, Capgo Native Builds optimieren für den Produkt-Workflow in Capgo Native Builds, Capgo Integrationen für den Produkt-Workflow in Capgo Integrations, CI/CD-Integration für die Implementierungsdetails in der CI/CD-Integration und GitHub Actions-Integration für die Implementierungsdetails in der GitHub Actions-Integration.