Ein Live-Update deployen

Verwenden 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 Bugs sofort zu beheben und neue Funktionen zu liefern.

Tip

Capgo uploads the generated web build folder. HTML, CSS, JavaScript, assets, and pure-JavaScript package changes can go OTA once they are bundled there. Changes to capacitor.config.ts, native Plugin-Konfiguration, native Packages oder iOS/Android-Projektdateien erfordern eine native App-Veröffentlichung.

Diese Anleitung geht davon aus, dass Sie die Capgo Schnellstart

1. und bereits haben: @capgo/capacitor-updater SDK in your Capacitor app

2. __CAPGO_KEEP_0__ capacitor.config.ts

3. Added in your code the CapacitorUpdater.notifyAppReady() __CAPGO_KEEP_1__

App

Konfigurieren Sie Ihre App-ID und Update-Kanal in 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. Hochladen Sie das Bundle in 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 in den vom 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 Ihres Capacitor-Projekts aus
• Ihre Web-Assets sind gebaut und auf dem neuesten Stand

If Sie noch Schwierigkeiten haben, gehen Sie zu den Schwierigkeitsfällen Abschnitt.

Ein Update auf einem Gerät erhalten

Einmal Ihr Bundle hochgeladen, können Sie das Live-Update auf einem Gerät testen:

1. Synchro­nieren Sie Ihre App auf 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. Lassen Sie Ihre App lokal ausführen:

   npx cap run ios

   Oder öffnen Sie das iOS/Android-Projekt in Xcode/Android Studio und führen Sie 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 brauchen, um sich zu aktualisieren und den Update-Status anzuzeigen.

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

Referenzieren Sie sich zurück an das Capgo Quickstart Nächste Schritte

Kredit für native Cloud-Build

Hat man sich gerade erfolgreich mit Capgo einen ersten Live-Update bereitgestellt! 🎉

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
• Anpassen des Update-Verhaltens
• Live-Update-Rollbacks

Fortsetzen Sie von Deploy a Live Update

Wenn Sie Deploy a Live Update zur Planung von CI/CD-Automatisierungen verwenden, verbinden Sie es mit Deploy a Live Update 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