Aperçu

Utilisez la fonctionnalité Live Updates de Capgo pour mettre à jour les bundles JavaScript de votre application à distance et en temps réel. Poussez des mises à jour JS directement à vos utilisateurs sur iOS, Android et Electron sans passer par les cycles de validation des stores pour corriger des bugs et livrer de nouvelles fonctionnalités plus rapidement. Pour la présentation du produit et la FAQ, consultez les live updates Capacitor sur capgo.app.

Remarque

Les Live Updates sont limitées aux modifications de bundles JavaScript. Si vous devez mettre à jour la partie native de code, par exemple en ajoutant ou supprimant un plugin ou en modifiant la configuration du projet natif, vous devrez soumettre un nouveau build binaire via le processus de distribution habituel des plateformes.

Modèle d'assets publics

Les bundles non chiffrés envoyés sur Capgo doivent être considérés comme des assets de diffusion publics. Les canaux déterminent quels appareils se voient proposer une mise à jour, mais la confidentialité d'un canal ne rend pas le bundle sous-jacent confidentiel. Le chiffrement ajoute une protection lors du stockage et du transit et empêche des tiers de produire des mises à jour chiffrées valides, mais il ne rend pas les assets web livrés impossibles à inspecter, car l'application contient la clé publique nécessaire au déchiffrement. Voir chiffrement de bout en bout pour le modèle de menaces exact.

Fonctionnement des live updates

Le système Live Update de Capgo comprend deux composants clés :

1. Le SDK Capgo, que vous installez dans votre app. Le SDK recherche les mises à jour disponibles et les télécharge en arrière-plan.

2. Les canaux, qui vous permettent de cibler les mises à jour vers des groupes d'utilisateurs spécifiques. Vous pouvez utiliser les canaux pour gérer différents flux de release, tels que Production, Staging, et Dev.

Lorsque vous envoyez un nouveau bundle JS vers Capgo et que vous l'associez à un canal, le SDK Capgo des apps configurées pour ce canal détecte la mise à jour et la télécharge. Au prochain redémarrage de l'app, le nouveau bundle sera chargé.

Pourquoi les logs Capgo sont essentiels (angle marketing)

• Analyse instantanée de chaque déploiement progressif: Les chronologies par appareil affichent les vérifications, téléchargements, installations, blocages de politique et rollbacks, pour savoir exactement ce qu'il s'est passé — fini les suppositions ou les débats du type « ça marche sur mon téléphone ».
• Réponse aux incidents plus rapide: Des codes d'alerte (ex: rate limits, échecs de checksum, oublis de notifyAppReady) apparaissent avant que les utilisateurs ne saturent le support, vous permettant de déployer un correctif ou un rollback en quelques minutes.
• Preuve de la politique de canal: Les logs vérifient que les garde-fous (blocage des versions majeures, désactivation des émulateurs/builds de dev, limites de plateforme) protègent activement la production.
• Protection du revenu et de la réputation: Identifiez quand les mises à jour stagnent sur des réseaux instables ou atteignent les limites de votre plan, afin d'intervenir avant que les conversions, les sessions ou les avis ne chutent.
• Source unique de véritéLes équipes Produit, QA et Support partagent le même flux de logs cloud : plus besoin de fouiller dans Xcode/Android Studio ou de solliciter les ingénieurs pour obtenir les logs natifs.

Prise en main

Pour commencer à utiliser Live Update, suivez ces étapes :

1. Complétez le Quickstart Capgo pour configurer votre app dans Capgo et installer le Capgo SDK.

2. Dans votre app code, appelez CapacitorUpdater.notifyAppReady() une fois l'initialisation de votre app terminée. Cela indique au Capgo SDK que votre app est prête à recevoir les mises à jour.

3. Générez votre bundle JS et envoyez-le sur Capgo :

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

4. Ouvrez votre app et attendez le téléchargement de la mise à jour. Vous pouvez vérifier le statut avec :

   npx @capgo/cli@latest app debug

5. Une fois la mise à jour téléchargée, fermez et rouvrez votre app pour charger le nouveau bundle.

Consultez le Déployer les Live Updates guide pour plus de détails.

Étapes suivantes

Pour utiliser votre propre nom d'hôte pour les requêtes de mise à jour, suivez le guide de configuration du domaine personnalisé.

Types de mise à jour

Référence de tous les types de mises à jour OTA : timing d'application, conditions de délai, blocage de version et livraison.

Canaux

Apprenez à utiliser les canaux pour gérer plusieurs canaux de release et cibler les mises à jour sur des utilisateurs spécifiques.

Déploiements progressifs

Déployez un bundle candidat à une cohorte spécifique, surveillez-le, puis validez-l’ou effectuez un rollback.

Rollbacks

Découvrez comment revenir à une version précédente du bundle JS si une mise à jour pose problème.

Comportement de mise à jour

Personnalisez la manière et le moment où les mises à jour sont téléchargées et appliquées dans votre app.

Workflow natif + OTA

Canaux dev/prod avec --fail-on-incompatible, et comment effectuer un upload lorsque le code natif change intentionnellement.

Tester les Native Builds

Vérifiez un binaire natif sans qu'un live update téléchargé ne masque ses assets web intégrés.

Mises à jour rapides

Apprenez à utiliser les mises à jour rapides pour accélérer le processus de mise à jour.

Continuer depuis l'aperçu

Si vous utilisez Aperçu pour planifier la validation et la distribution sur le store, connectez-l’à @capgo/capacitor-in-app-review pour le détail d'implémentation dans @capgo/capacitor-in-app-review, Utiliser @capgo/capacitor-in-app-review pour la capacité native dans Utiliser @capgo/capacitor-in-app-review, @capgo/capacitor-native-market pour les détails d'implémentation dans @capgo/capacitor-native-market, Utiliser @capgo/capacitor-native-market pour la capacité native dans Using @capgo/capacitor-native-market, et Capacitor OTA Updates : guide d'approbation App Store pour le contexte pratique dans Capacitor OTA Updates : guide d'approbation App Store.