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. Envoyez des mises à jour de bundle JavaScript directement à vos utilisateurs sans passer par l'app store pour corriger les bogues et livrer de nouvelles fonctionnalités.

Conseil

Le dossier de build web généré est téléchargé par Capgo. 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à. capacitor.config.ts native plugin configuration, native packages, ou fichiers de projet iOS/Android nécessitent une mise en production d'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 in your Capacitor app

2. __CAPGO_KEEP_1__ capacitor.config.ts

3. Added in your code the CapacitorUpdater.notifyAppReady() Ajouté dans votre

__CAPGO_KEEP_0__ la

méthode Add an app to your Capgo account, and install the plugin in your app

Chargement d'un Bundle

Avec le Capgo SDK installé et configuré, vous êtes prêt à charger votre premier bundle de mise à jour en direct :

1. Construire vos actifs web :

   npm run build

2. Charger le bundle vers 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 }}

   __CAPGO_KEEP_0__ Actions

   .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ésolution des problèmes d'envoi

Si votre envoi 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'envoi depuis la racine de votre projet Capacitor
• Votre contenu web est construit et à jour

Si vous rencontrez toujours des difficultés, rendez-vous sur la Résolution des problèmes section.

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

Une fois votre bundle téléchargé, vous pouvez tester la mise à jour en direct sur un appareil :

1. Synchronisez 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 la 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 effectuez une exécution native.

4. Maintenez 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 mise à jour live appliquée !

Rendez-vous à la section intitulée «  Capgo Quickstart pour plus de détails sur la mise à jour live.

Étapes suivantes

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

Pour en savoir plus, passez en revue le reste de la Capgo documentation sur les mises à jour live. Certains sujets clés à vérifier ensuite :

• Cibler les mises à jour avec les canaux
• Personnaliser le comportement des mises à jour
• Annuler les mises à jour live

Continuez depuis Déployer une mise à jour live

Déployer une mise à jour live pour planifier l'automatisation CI/CD, connectez-l’avec Section intitulée “Continuez depuis Déployer une mise à jour live” Capgo Intégration CI/CD pour le flux de travail du produit dans Capgo Intégration CI/CD, Capgo Déploiement natif pour le flux de travail du produit dans Capgo Déploiement natif, 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.