Overview

Utilisez la fonctionnalité Live Updates de Capgo pour mettre à jour les bundles JavaScript de votre application à distance, en temps réel. Envoyez les mises à jour JS directement à vos utilisateurs sans passer par le processus d’examen de l’App Store pour corriger instantanément les bugs et proposer de nouvelles fonctionnalités.

Comment fonctionnent les mises à jour en direct

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

Le Capgo SDK, que vous installez dans votre application. Le SDK vérifie les mises à jour disponibles et les télécharge en arrière-plan.
Canaux, qui vous permettent de cibler les mises à jour sur des groupes spécifiques d’utilisateurs. Vous pouvez utiliser des canaux pour gérer différentes pistes de publication, telles que Production, Staging et Dev.

Lorsque vous téléchargez un nouveau bundle JS sur Capgo et l’attribuez à un canal, le Capgo SDK dans les applications configurées pour ce canal détectera la mise à jour et la téléchargera. Au prochain redémarrage de l’application, le nouveau bundle sera chargé.

Pour commencer

Pour commencer à utiliser les mises à jour en direct, procédez comme suit :

Complétez le Capgo Quickstart pour configurer votre application dans Capgo et installez Capgo SDK.
Dans le code de votre application, 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.

Créez votre bundle JS et téléchargez-le sur Capgo :

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

Ouvrez votre application et attendez que la mise à jour soit téléchargée. Vous pouvez vérifier l’état avec :
Terminal window
```
npx @capgo/cli@latest app debug
```
Une fois la mise à jour téléchargée, fermez et rouvrez votre application pour charger le nouveau bundle.

Consultez le guide Déploiement des mises à jour en direct 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 à partir de leurs propres pipelines CI/CD. Avec le CLI, vous disposez d’un contrôle granulaire sur le moment où les builds sont produites et déployées, ce qui vous permet d’intégrer Capgo dans les flux de travail de votre entreprise existants.

A 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ôle et de flexibilité dans leurs flux de travail de mise à jour en direct. En utilisant le CLI dans vos pipelines CI/CD, vous pouvez :

Décidez exactement quand créer et déployer les mises à jour, plutôt que de vous fier à l’automatisation intégrée de Capgo
Insérez vos propres processus, tels que la signature de code, les tests d’assurance qualité ou les approbations des responsables, entre les étapes de création et de déploiement.
Intégrez Capgo dans vos outils et flux de travail DevOps existants

Authentification

Pour utiliser le Capgo CLI, vous devrez vous authentifier avec votre clé API. Vous pouvez générer une clé API dans les paramètres de votre compte Capgo.Pour vous connecter et stocker en toute sécurité votre clé API, exécutez :

npx @capgo/cli@latest login [API_KEY]

Cette commande sera ensuite enregistrée pour une utilisation ultérieure. Vous n’aurez pas besoin de fournir votre clé API avec chaque commande après vous être connecté.

Différences clés par rapport aux autres outils CLI

Si vous êtes familier avec d’autres outils de mise à jour en direct CLI, il y a quelques éléments clés à noter à propos du CLI de Capgo :

Capgo utilise un seul CLI pour les cas d’utilisation de développement et de CI/CD, car Capgo se concentre uniquement sur l’ensemble des fonctionnalités de mise à jour en direct.
Le Capgo CLI ne nécessite pas d’étape d’installation distincte. Il est fourni avec le package @capgo/cli et peut être exécuté directement à l’aide de npx.
Le CLI de Capgo est conçu spécifiquement pour le flux de travail de mise à jour en direct, il peut donc ne pas inclure certaines fonctionnalités ou commandes trouvées dans les outils CLI plus généraux.

Prochaines étapes

Channels

Découvrez comment utiliser les canaux pour gérer différentes pistes de publication 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 provoque des problèmes.

Comportement de mise à jour

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

Mises à jour rapides

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