Bereitstellung eines Live Update

Use Capgo’s Live Updates feature to update the UI and business logic of your app remotely, in real-time. Push JS bundle updates directly to your users without going through the app store to instantly fix bugs and ship new features.

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.tsEine native App-Veröffentlichung ist erforderlich, wenn native Plugin-Konfigurationen, native Pakete oder iOS/Android-Projektdateien verwendet werden.

Diese Anleitung geht davon aus, dass Sie das Capgo Schnellstart und haben Sie bereits:

1. abgeschlossen haben und bereits: @capgo/capacitor-updater SDK in Ihrem Capacitor-App

2. Konfiguriert haben Sie Ihre App-ID und den Updatekanal capacitor.config.ts

3. Added in Ihrem code CapacitorUpdater.notifyAppReady() method

Wenn Sie diese Schritte noch nicht durchgeführt haben, gehen Sie bitte zurück und beenden Sie das Quickstart zuerst.

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

Ein Bundle hochladen

Mit dem Capgo-SDK installiert und konfiguriert, sind Sie bereit, Ihr erstes live update-Bundle hochzuladen:

1. Bauen Sie Ihre Web-Assets:

   npm run build

2. Hochladen Sie das Bundle auf 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.

Uploads bei Problemen

Überprüfen Sie, wenn Ihr Upload fehlschlägt:

• Die ID Ihres Apps in capacitor.config.ts passt auf Ihre App in der Capgo-Oberfläche
• Sie führen den Upload-Befehl von der Wurzel Ihres Capacitor-Projekts aus
• Deine Web-Assets sind gebaut und auf dem neuesten Stand

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

Ein Gerät aktualisieren

Nachdem Ihr Bundle hochgeladen wurde, können Sie das live update auf einem Gerät testen:

1. Deine App synchronisieren mit dem Gerät:

   npx cap sync ios

2. Öffnen Sie ein anderes 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 Ihr App lokal aus:

   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 Update-Download im Hintergrund zu ermöglichen.

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

6. Schließen Sie die App und öffnen Sie sie erneut. Sie sollten Ihre live update sehen!

Beziehen Sie sich zurück auf die Capgo-Anleitung für weitere Details zu Live-Updates.

Nächste Schritte

Congrats on deploying your first live update with Capgo! 🎉

Um mehr zu erfahren, überprüfen Sie den Rest der Capgo Live-Updates-Dokumentation. Some key topics to check out next:

• Zielgruppen für Updates mit Kanälen
• Anpassen des Update-Verhaltens
• Live Update Rolloverungen

Fortsetzen Sie von Deploy ein Live Update

Wenn Sie Capgo verwenden ein Live Update bereitstellen um die CI/CD-Automatisierung zu planen, verbinden Sie es mit Capgo CI/CD für den Produktworkflow in Capgo CI/CD, Capgo nativee Native Builds für den Produktworkflow in Capgo Native Builds, Capgo Integrations für den Produktworkflow in Capgo Integrations, CI/CD-Integration für die Implementierungsdetails in CI/CD-Integration, und GitHub Aktionen-Integration Für die Implementierungsdetails in GitHub Actions Integration.