__CAPGO_KEEP_0__

Brauchen 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 die App-Store-Vertriebskanäle 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.ts, native Plugin-Konfiguration, native Paketen oder iOS/Android-Projektdateien erfordern eine native App-Veröffentlichung.

Diese Anleitung geht davon aus, dass Sie die Capgo Quickstart abgeschlossen haben und bereits:

1. __CAPGO_KEEP_0__ in Ihrem __CAPGO_KEEP_1__-App installiert haben @capgo/capacitor-updater have already installed the SDK in your Capacitor app

2. Konfiguriert Ihr 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.

Hinzufügen einer 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. Laden Sie 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.

Fehlerbehebungen bei der Hochladung

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 zur Fehlerbehebung 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. Synchronisiere deine App mit dem Gerät:

   npx cap sync ios

2. Öffne ein anderes Terminal und führe den folgenden Befehl aus, um den Update-Status zu überprüfen:

   npx @capgo/cli@latest app debug

3. Führe deine App lokal aus:

   npx cap run ios

   Oder öffne das iOS/Android-Projekt in Xcode/Android Studio und führe eine native Ausführung durch.

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

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

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

Zurückgehen zu dem Capgo Schnellstart 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 die restlichen Capgo Live-Updates-Dokumentation. Einige wichtige Themen, die Sie als Nächstes überprüfen sollten:

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

Weitermachen von Live Update Deploy

Wenn Sie " Live Update Deploy um die CI/CD-Automatisierung zu planen, 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 Aktionen-Integration für die Implementierungsdetails in GitHub Aktionen-Integration.