__CAPGO_KEEP_0__
Copiez un prompt de configuration avec les étapes d'installation et le guide Markdown complet pour ce plugin.
Utilisez la fonctionnalité d'actualisations 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.
Ce guide suppose que vous avez terminé le Capgo Quickstart et que vous avez déjà :
-
Installé le
@capgo/capacitor-updaterSDK dans votre application Capacitor -
Configuré votre ID d'application et votre canal d'actualisation dans
capacitor.config.ts -
Ajouté dans votre code
CapacitorUpdater.notifyAppReady()méthode
Si vous n'avez pas encore effectué ces étapes, veuillez retourner et les compléter en premier.
Téléchargement d'un Bundle
Section intitulée “Téléchargement d'un Bundle”Avec le Capgo SDK installé et configuré, vous êtes prêt à télécharger votre premier bundle de mise à jour en direct :
-
Construire vos actifs web :
Fenêtre de terminal npm run build -
Télécharger le bundle vers Capgo:
Fenêtre de terminal npx @capgo/cli@latest bundle upload --channel=production.github/flux/travaux/deployer_et_construire.yml name: Build source code and send to Capgoconcurrency:group: ${{ github.workflow }}-${{ github.ref }}cancel-in-progress: trueon:push:branches:- mainjobs:deploy_to_capgo:runs-on: ubuntu-lateststeps:- name: Checkoutuses: actions/checkout@v6- uses: actions/setup-node@v6with:node-version: '24'- name: Install dependenciesrun: npm install- name: Buildrun: npm run build- name: Deploy to Capgorun: npx @capgo/cli@latest bundle upload -a ${{ secrets.CAPGO_TOKEN }} --channel ${{ env.CHANNEL }}env:CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}.gitlab-ci.yml stages:- buildbuild:stage: buildimage: node:18cache:- key:files:- package-lock.jsonpaths:- .node_modules/script:- npm install- npm run build- npx @capgo/cli@latest bundle upload -a $CAPGO_TOKEN --channel $CAPGO_CHANNELartifacts:paths:- node_modules/- dist/only:- masterCela téléchargera une nouvelle version du bundle dans le canal spécifié dans la commande.
Résolution des problèmes d'envoi
Section intitulée « Résolution des problèmes d'envoi »Si votre envoi a échoué, vérifiez à nouveau :
- Votre ID d'application dans
capacitor.config.tscorrespond à votre application dans l'interface de bord de Capgo - Vous exécutez la commande d'upload depuis la racine de votre projet Capacitor
- Vos actifs web sont construits et à jour
Si vous rencontrez toujours des difficultés, rendez-vous dans la section « 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 »
Une fois votre bundle téléchargé, vous pouvez tester la mise à jour en temps réel sur un appareil :Synchronisez votre application sur l'appareil :
-
Fenêtre de terminal
Si vous rencontrez toujours des difficultés, rendez-vous dans la section « Résolution des problèmes ». npx cap sync ios -
Ouvrez une autre fenêtre de terminal et exécutez la commande suivante pour vérifier l'état de mise à jour :
Fenêtre de terminal npx @capgo/cli@latest app debug -
Exécutez votre application localement :
Fenêtre de terminal npx cap run iosOu ouvrez le projet iOS/Android dans Xcode/Android Studio et faites une exécution native.
-
Gardez l'application ouverte pendant environ 30 secondes pour permettre le téléchargement de la mise à jour en arrière-plan.
-
Les journaux mettront quelques secondes pour s'actualiser et afficher l'état de mise à jour.
-
Fermez et rouvrez l'application. Vous devriez voir votre mise à jour en temps réel appliquée !
Référez-vous à la documentation de Capgo pour plus d'informations. Capgo Démarrage rapide pour plus de détails sur la mise à jour en direct en cours.
Étapes suivantes
Section intitulée “É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 :
- Ciblage des mises à jour avec les canaux
- Personnalisation du comportement de mise à jour
- Rétrogradations de mise à jour en direct
Continuez à partir de Déployer une mise à jour en direct
Section intitulée “Continuez à partir de Mise à jour en direct”Si vous utilisez Mise à jour en direct 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 le détail d'implémentation dans Intégration CI/CD, Intégration d'Actions de GitHub pour les détails d'implémentation dans l'intégration d'actions de GitHub