Deploy ein Live Update

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 Fehler sofort zu beheben und neue Funktionen bereitzustellen.

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 Packages oder iOS/Android-Projektdateien verwendet werden.

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

1. Installiert wurden @capgo/capacitor-updater SDK in Ihrem Capacitor-Anwendung

2. Konfiguriert Ihre App-ID und Update-Kanal in capacitor.config.ts

3. Hinzugefügt in Ihrem code die CapacitorUpdater.notifyAppReady() Methode

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

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

Hochladen eines Bundles

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

1. Bauen Sie Ihre Web-Assets:

   npm run build

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

   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:

• Deine App-ID in capacitor.config.ts stimmt mit deiner App im Capgo-Dashboard überein
• Du läufst den Upload-Befehl von der Wurzel deines Capacitor-Projekts aus
• Deine Web-Assets sind gebaut und auf dem neuesten Stand

Wenn du weiterhin Schwierigkeiten hast, gehe zur Fehlerbehebung section.

Ein Update auf einem Gerät empfangen

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. Führen Sie Ihre 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 offen, um den Download des Updates im Hintergrund zu ermöglichen.

5. Die Protokolle werden in wenigen Sekunden aktualisiert und zeigen den Aktualisierungsstatus an.

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

Referieren Sie sich zurück an das Capgo Schnellstart für weitere Details zu der Überprüfung von Live-Updates.

Nächste Schritte

Congrats on deploying your first live update with Capgo! 🎉

Um mehr zu erfahren, überprüfen Sie den Rest dieser Capgo Live-Update-Dokumentation__CAPGO_KEEP_0__ Live-Updates-Dokumentation

• Zielgruppeneinstellungen für Updates
• Anpassen der Update-Behavior
• Live Update Rollover

Fortsetzen von Deploy ein Live Update

Wenn Sie __CAPGO_KEEP_0__ verwenden Deploy ein Live Update 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 zur Produktworkflow in Capgo Integrations, CI/CD-Integration zur Implementierungsdetail in CI/CD-Integration, und GitHub Aktionen-Integration zur Implementierungsdetail in GitHub Aktionen-Integration.