Déployer un Live Update

Utilisez la fonctionnalité Live Updates de Capgo pour mettre à jour l’interface et la logique métier de votre application à distance, en temps réel. Envoyez des mises à jour de bundles JS directement à vos utilisateurs sans passer par les stores pour corriger instantanément les bugs et livrer de nouvelles fonctionnalités.

Astuce

Capgo envoie le dossier de build web généré. Les modifications du HTML, du CSS, du JavaScript, des assets et des packages en pur JavaScript peuvent passer en OTA une fois bundlées. Les modifications de capacitor.config.tsla configuration des plugins natifs, des packages natifs ou des fichiers de projet iOS/Android nécessitent une release native.

Ce guide suppose que vous avez terminé l' Quickstart Capgo et que vous avez déjà :

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

2. Configured your app ID and update channel in capacitor.config.ts

3. Ajouté dans votre code le CapacitorUpdater.notifyAppReady() méthode

Si vous n'avez pas encore effectué ces étapes, revenez en arrière et terminez d'abord le quickstart.

Ajouter une app Ajoutez une application à votre compte Capgo, puis installez le plugin dans votre application

Envoyer un bundle

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

1. Compilez vos assets web :

   npm run build

2. Envoyez le bundle vers Capgo :

   Console

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

   Actions Github

   .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

   Cela enverra une nouvelle version du bundle vers le canal indiqué dans la commande.

Dépannage des uploads

Si votre upload échoue, vérifiez à nouveau :

• Votre ID d'application dans capacitor.config.ts correspond à votre application dans le dashboard Capgo
• Vous exécutez la commande d'upload depuis la racine de votre projet Capacitor
• Vos assets web sont compilés et à jour

Si le problème persiste, rendez-vous dans la Troubleshooting section.

Recevoir une mise à jour sur un appareil

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

1. Synchronisez votre application avec l'appareil :

   npx cap sync ios

2. Ouvrez un autre terminal et lancez la commande suivante pour vérifier le statut de la mise à jour :

   npx @capgo/cli@latest app debug

3. Lancez votre application en local :

   npx cap run ios

   Ou ouvrez le projet iOS/Android dans Xcode/Android Studio et lancez-l’en natif.

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

5. Les logs mettront quelques secondes à s'actualiser pour afficher le statut de la mise à jour.

6. Fermez et rouvrez l'application. Vous devriez voir votre live update prendre effet !

Reportez-vous à la Quickstart Capgo pour plus de détails sur le test des live updates.

Étapes suivantes

Félicitations pour votre premier déploiement de live update avec Capgo ! 🎉

Pour en savoir plus, consultez le reste de la documentation Live Updates de Capgo. Voici quelques sujets clés à explorer ensuite :

• Cibler les mises à jour avec les canaux
• Personnaliser les mises à jour
• Rollbacks Live Update

Continuer à partir de Déployer un Live Update

Si vous utilisez Déployer un Live Update pour planifier l'automatisation CI/CD, et le connecter avec CI/CD Capgo pour le workflow produit dans le CI/CD de Capgo, Capgo Native Build pour le workflow produit dans les Native Builds de Capgo, Intégrations Capgo pour le workflow produit dans les intégrations de Capgo, Intégration CI/CD pour le détail d'implémentation dans l'intégration CI/CD, et Intégration GitHub Actions pour les détails d'implémentation de l'intégration GitHub Actions.