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 le processus de validation 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 CLI suit son propre versioning 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 Capgo.

Remarque

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

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é.

Prise en main

Pour commencer à utiliser les live updates, suivez ces étapes :

1. Terminez la Quickstart Capgo pour configurer votre application dans Capgo et installer le SDK Capgo.

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

3. Compilez votre bundle JS et envoyez-l’à 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 l’état avec :

   npx @capgo/cli@latest app debug

5. Une fois la mise à jour téléchargée, fermez puis 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. Grâce au CLI, vous avez un contrôle fin sur le moment où 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 les mises à jour, plutôt que de vous fier à l’automatisation intégrée de Capgo
• Insérez vos propres processus, comme la signature code, les tests QA ou les approbations de 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 enregistré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 live update CLI, 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 plusieurs canaux de release et cibler les mises à jour sur 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

Personnalisez comment et quand les mises à jour sont téléchargées et appliquées dans votre app.

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 les opérations du dashboard et de API, connectez-l’avec Aperçu de API pour les détails d'implémentation dans « Vue d'ensemble de API », Introduction pour les détails d'implémentation dans l'introduction, Clés API pour les détails d'implémentation dans API Keys, Appareils pour les détails d'implémentation dans Devices, et Les bundles pour les détails d'implémentation dans Bundles.