Aperçu

Utilisez la fonctionnalité Live Updates de Capgo pour mettre à jour les bundles JavaScript de votre application à distance, en temps réel. Envoyez des mises à jour JS directement à vos utilisateurs sans passer par la révision des stores pour corriger instantanément les bugs et livrer de nouvelles fonctionnalités.

Utilisez toujours la dernière version de CLI

Exécutez toujours Capgo CLI avec @latest (par exemple npx @capgo/cli@latest). Le versionnement de CLI est indépendant et n'a pas doit correspondre à la version majeure de votre plugin ou de Capacitor. La dernière version de CLI reste compatible avec toutes les versions de plugins updater supportées. Voir le versionnement de Capgo.

Note

Les Live Updates sont limitées aux changements du bundle JavaScript. Si vous devez mettre à jour le code natif, comme ajouter ou supprimer un plugin ou modifier la configuration native du projet, vous devrez soumettre un nouveau build natif aux stores.

Fonctionnement des live updates

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

1. Le SDK de 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 l'assignez à un canal, le Capgo SDK de Capgo dans les apps configurées pour ce canal détectera la mise à jour et la téléchargera. Au prochain redémarrage de l'app, le nouveau bundle sera chargé.

Premiers pas

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

1. Complétez l' 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 application terminée. Cela indique au Capgo SDK que votre application est prête à recevoir des mises à jour.

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

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

4. Ouvrez votre application 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 application pour charger le nouveau bundle.

Consultez le Déployer des live updates guide pour plus de détails.

Le Capgo CLI

Le Capgo CLI est un outil puissant qui permet aux développeurs d'interagir avec les services de Capgo depuis leurs propres pipelines CI/CD. Avec le CLI, vous contrôlez précisément quand les builds sont produits et déployés, ce qui vous permet d'intégrer Capgo à vos workflows d'entreprise existants.

À quoi sert le Capgo CLI ?

Le Capgo CLI est conçu pour les développeurs et les équipes qui ont besoin de plus de contrôl’et de flexibilité dans leurs workflows live update. En utilisant le CLI dans vos pipelines CI/CD, vous pouvez :

• Décider exactement quand compiler et déployer vos mises à jour, plutôt que de dépendre de l'automatisation intégrée de Capgo
• Insérer vos propres processus, comme la signature code, les tests QA ou les validations de vos managers, entre les étapes de build et de déploiement
• Intégrer Capgo à vos outils et workflows DevOps existants

Authentification

Pour utiliser le Capgo CLI, vous devez vous authentifier avec votre clé API. Vous pouvez générer une clé API dans les paramètres de votre compte Capgo.

To log in and securely store your API key, run:

npx @capgo/cli@latest login [API_KEY]

Cette commande sera ensuite sauvegardée pour une utilisation ultérieure. Vous n'aurez plus besoin de fournir votre clé API à chaque commande après vous être connecté.

Différences clés avec les autres outils CLI

Si vous connaissez d'autres outils CLI live update, voici quelques points importants à noter concernant le CLI de Capgo :

• Capgo utilise un seul CLI pour le développement et les cas d'usage CI/CD, car Capgo se concentre uniquement sur l'ensemble des fonctionnalités live update.

• Le CLI Capgo ne nécessite pas d'étape d'installation séparée. Il est inclus dans le @capgo/cli package et peut être exécuté directement via npx.

• Le CLI de Capgo est conçu spécifiquement pour le workflow live update, il peut donc ne pas inclure certaines fonctionnalités ou commandes présentes dans des outils CLI plus généralistes.

Étapes suivantes

Canaux

Apprenez à utiliser les canaux pour gérer différents flux de release et cibler les mises à jour vers des utilisateurs spécifiques.

Rollbacks

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

Comportement de mise à jour

Customize how and when updates are downloaded and applied in your app.

Mises à jour rapides

Apprenez à utiliser les fast updates pour accélérer le processus de mise à jour.

Continuer depuis la vue d'ensemble

Si vous utilisez Aperçu pour planifier les opérations du dashboard et de API, connectez-l’à Aperçu de API pour les détails d'implémentation dans l'aperçu de API, Introduction pour les détails d'implémentation dans l'Introduction, Clés API pour les détails d'implémentation dans les clés API, Appareils pour les détails d'implémentation dans Devices, et Bundles pour les détails d'implémentation dans Bundles.