Mettre en ligne un 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.

Conseil

Capgo télécharge le dossier de build web généré. Les modifications de HTML, CSS, JavaScript, de ressources et de packages pure-JavaScript peuvent être envoyées OTA une fois qu'elles sont bundlées là. Les modifications des capacitor.config.tsconfigurations de plugin natif, des packages natifs, ou des fichiers de projet iOS/Android nécessitent une mise à jour de l'application native.

Cette guide suppose que vous avez terminé le Capgo Démarrage rapide et que vous avez déjà :

1. Installé le @capgo/capacitor-updater SDK dans votre Capacitor application

2. Configuré votre ID d'application et votre canal d'actualisation en capacitor.config.ts

3. Ajouté dans votre code CapacitorUpdater.notifyAppReady() method

Si vous n'avez pas encore effectué ces étapes, veuillez retourner et terminer le quickstart en premier.

la méthode Ajoutez une application à votre compte Capgo et installez le plugiciel dans votre application

Télécharger un Bundle

Avec le Capgo SDK installé et configuré, vous êtes prêt à charger votre premier live update bundle :

1. Construire vos actifs web :

   npm run build

2. Charger le bundle dans Capgo :

   Console

   npx @capgo/cli@latest bundle upload --channel=production

   Github Actions

   /github/flux de travail/build_et_déployer.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

   Cela téléchargera une nouvelle version du bundle dans le canal spécifié dans la commande.

Résoudre les problèmes d'envoi

Si votre envoi a échoué, vérifiez doublement :

• Votre ID d'application dans capacitor.config.ts matches your app in the Capgo dashboard
• Vous exécutez la commande d'envoi depuis la racine de votre projet Capacitor
• Vos actifs web sont construits et à jour

Si vous continuez à rencontrer des problèmes, allez à la Troubleshooting section.

Réception d'une mise à jour sur un appareil

Une fois votre bundle est chargé, vous pouvez tester le live update sur un appareil :

1. Synchronez votre application sur l'appareil :

   npx cap sync ios

2. Ouvrez une autre fenêtre de terminal et exécutez la commande suivante pour vérifier l'état de mise à jour :

   npx @capgo/cli@latest app debug

3. Exécutez votre application localement :

   npx cap run ios

   Ouvrez le projet iOS/Android dans Xcode/Android Studio et effectuez une exécution native.

4. Gardez l'application ouverte pendant environ 30 secondes pour permettre le téléchargement de la mise à jour en arrière-plan.

5. Les journaux mettront quelques secondes à s'actualiser et à afficher l'état de la mise à jour.

6. Fermez et rouvrez l'application. Vous devriez voir votre live update appliqué !

Référez-vous à la Capgo Démarrage rapide Pour plus d'informations sur les mises à jour en temps réel.

Étapes suivantes

Félicitations pour avoir déployé votre première live update avec Capgo !

Pour en savoir plus, passez en revue le reste de la Capgo documentation des mises à jour Live. Certaines des sujets clés à vérifier ensuite :

• Cibler les mises à jour avec les canaux
• Personnaliser le comportement des mises à jour
• Live Update Retour en arrière

Continuez depuis Déployer un Live Update

Si vous utilisez Déployer un Live Update pour planifier l'automatisation CI/CD, connectez-l’avec Capgo CI/CD pour le flux de travail du produit dans Capgo CI/CD, Capgo Builds natifs pour le flux de travail du produit dans Capgo Builds natifs, Capgo Intégrations pour le flux de travail du produit dans Capgo Intégrations, Intégration CI/CD pour les détails d'implémentation dans Intégration CI/CD, et GitHub Intégration d'actions pour les détails d'implémentation dans GitHub Intégration d'actions.