Live Update deployen

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

Tipp

Capgo lädt den generierten Web-Build-Ordner hoch. HTML, CSS, JavaScript, Assets und reine JavaScript-Package-Änderungen können via OTA verteilt werden, sobald sie dort gebündelt wurden. Änderungen an capacitor.config.tsder nativen Plugin-Konfiguration, nativen Packages oder iOS/Android-Projektdateien erfordern ein neues Native Build.

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

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

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

3. In deinem code wurde die CapacitorUpdater.notifyAppReady() Methode

Falls du diese Schritte noch nicht erledigt hast, gehe 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 Capgo SDK installiert und konfiguriert ist, kannst du dein erstes live update Bundle hochladen:

1. Web-Assets builden:

   npm run build

2. Lade das Bundle bei 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

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

Fehlerbehebung beim Upload

Falls der 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 aus dem Root deines Capacitor Projekts ausführst
• Ob deine Web-Assets gebaut und aktuell sind

Falls 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. Lasse die App etwa 30 Sekunden offen, damit das Update im Hintergrund heruntergeladen werden kann.

5. Es dauert ein paar Sekunden, bis die Logs aktualisiert sind und den Update-Status anzeigen.

6. Schließe und öffne die App neu. Dein live update sollte nun angewendet sein!

Siehe dazu den Capgo Quickstart für weitere Details zum Testen von Live Updates.

Nächste Schritte

Glückwunsch zum Deployment deines ersten live update mit Capgo! 🎉

Um mehr zu erfahren, lies dir den Rest der Capgo Live Updates DokumentationHier sind einige weitere wichtige Themen:

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

Weiter mit Deploy eines Live Update

Wenn Sie ... verwenden 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 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.