Déployer une mise à jour en direct

Utilisez la fonctionnalité d'actualisation en temps réel de Capgo pour mettre à jour l'interface utilisateur et la logique métier de votre application à distance, en temps réel. Mettez à jour directement le bundle JS de vos utilisateurs sans passer par l'app store pour corriger les bogues et livrer de nouvelles fonctionnalités.

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.ts, configurations de plugins natives, packages natives ou fichiers de projet iOS/Android nécessitent une mise à jour de l'application native.

Cette guide suppose que vous avez terminé le Capgo Quickstart et que vous avez déjà :

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

2. Configurez votre ID d'application et votre canal d'actualisation dans capacitor.config.ts

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

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

Ajouter une application Ajoutez une application à votre compte Capgo et installez le plugin dans votre application

Téléchargement d'un Bundle

Avec le Capgo SDK installé et configuré, vous êtes prêt à télécharger votre premier bundle d'actualisation en direct :

1. Construirez vos actifs web :

   npm run build

2. Charger le bundle vers Capgo:

   Console

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

   Github Actions

   .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 chargera une nouvelle version du bundle dans le canal spécifié dans la commande.

Résolution des problèmes d'envoi

Si votre upload a échoué, vérifiez :

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

Si vous continuez à rencontrer des problèmes, rendez-vous dans la section de résolution des problèmes. Réception d'une mise à jour sur un appareil

Section intitulée « Réception d'une mise à jour sur un appareil »

Si vous rencontrez des difficultés, consultez la section de résolution des problèmes.

1. Synchronisez votre application sur le périphérique :

   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

   Ou ouvrez le projet iOS/Android dans Xcode/Android Studio et faites une exécution native.

4. Tenez 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 afficheront l'état de mise à jour.

6. Fermez et rouvrez l'application. Vous devriez voir votre mise à jour en direct appliquée !

Rappelez-vous la Capgo Quickstart pour plus de détails sur la mise à l'essai des mises à jour en direct.

Étapes suivantes

Félicitations pour avoir déployé votre première mise à jour en direct avec Capgo ! 🎉

Pour en savoir plus, passez en revue le reste de la Capgo documentation sur les mises à jour en direct. Certaines thématiques clés à vérifier ensuite :

• Cibler les mises à jour avec les canaux
• Personnaliser le comportement de mise à jour
• Mise à jour en temps réel avec annulation

Continuez à partir de Mise à jour en temps réel

Si vous utilisez Mise à jour en temps réel pour planifier l'automatisation CI/CD, connectez-le 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 l'intégration CI/CD, et GitHub Intégration d'actions pour les détails d'implémentation dans GitHub Intégration d'actions.