Déployer un Live Update

Utilisez la fonctionnalité Live Update de Capgo pour mettre à jour l'interface et la logique métier de votre application à distance et 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 déployer de nouvelles fonctionnalités.

Astuce

Capgo effectue l'upload du dossier de build web généré. Les changements HTML, CSS, JavaScript, les assets et les packages en pur JavaScript peuvent être déployés en OTA une fois bundlés. Les modifications de capacitor.config.tsla configuration des plugins natifs, des packages natifs ou des fichiers de projet iOS/Android nécessitent une nouvelle 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. Configurez l'ID de votre app et le canal de mise à jour dans 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.

Add an 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 spécifié dans la commande.

Dépannage des uploads

Si votre upload échoue, vérifiez bien :

• Votre app ID 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 vous rencontrez toujours des problèmes, rendez-vous sur le 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 app sur 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 app localement :

   npx cap run ios

   Ou ouvrez le projet iOS/Android dans Xcode/Android Studio pour un run natif.

4. Laissez l'app 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 appliqué !

Reportez-vous au Capgo Guide de démarrage rapide pour plus de détails sur le test des live updates.

Étapes suivantes

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

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

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

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.