Ein Live-Update bereitstellen

Verwenden Sie Capgo’s Live-Updates-Funktion, um die Benutzeroberfläche und die Geschäftslogik Ihres Apps in Echtzeit fernübertragen zu können. Pushen Sie JS-Bundle-Updates direkt an Ihre Benutzer weiter, ohne durch den App Store zu gehen, um Fehler sofort zu beheben und neue Funktionen bereitzustellen.

Tipp

Capgo lädt das generierte Web-Build-Ordner hoch. Änderungen an HTML, CSS, JavaScript, Assets und reinen JavaScript-Paketen können OTA erfolgen, sobald sie dort gebündelt sind. Änderungen an capacitor.config.ts, der native Plugin-Konfiguration, native Paketen oder iOS/Android-Projektdateien erfordern jedoch eine native App-Veröffentlichung.

Diese Anleitung geht davon aus, dass Sie die erforderlichen Schritte bereits abgeschlossen haben. Capgo Schnellstart und haben Sie bereits:

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

2. Die Konfiguration Ihres App-IDs und des Update-Kanals in capacitor.config.ts

3. code in Ihrer code hinzugefügt CapacitorUpdater.notifyAppReady() Methode

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

Eine App hinzufügen Eine App zu Ihrem Capgo-Konto hinzufügen und das Plugin in Ihrer App installieren

Ein Bundle hochladen

Mit der Capgo SDK installiert und konfiguriert, bist du bereit, deine erste Live-Update-Bundle hochzuladen:

1. Erstelle deine 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.

Fehlerbehebung bei Uploads

Wenn Ihr Upload fehlschlägt, überprüfen Sie bitte:

• Ihr 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

Wenn Sie weiterhin Schwierigkeiten haben, gehen Sie zu dem Fehlerbehebung bei Uploads Abschnitt.

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 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 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 Laufzeit durch.

4. Halten Sie die App etwa 30 Sekunden geöffnet, um dem Update im Hintergrund zu ermöglichen.

5. Die Protokolle werden einige Sekunden dauern, um die Update-Status zu aktualisieren.

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

Zurückbezogen auf das Capgo Quickstart für weitere Details zu Testen von Live-Updates.

Nächste Schritte

Herzlichen Glückwunsch zum Bereitstellen Ihres ersten Live-Updates mit Capgo! 🎉

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:

• Updates mit Kanälen anpassen
• Aktualisierungsverhalten anpassen
• Rückgänge bei Live-Updates

Weitermachen von Deploy a Live Update

Wenn Sie Deploy a Live Update zur Planung der CI/CD-Automatisierung verwenden, verbinden Sie es mit Capgo CI/CD für den Produktworkflow in Capgo CI/CD, Capgo 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 Actions-Integration für die Implementierungsdetails in GitHub Actions-Integration