Aperçu

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

Comment fonctionnent les Live Updates

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

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

Lorsque vous téléchargez un nouveau bundle JS sur Capgo et l’assignez à un canal, le SDK Capgo 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é.

Démarrage

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

Complétez le Démarrage rapide Capgo pour configurer votre application dans Capgo et installer le SDK Capgo.
Dans votre code d’application, appelez CapacitorUpdater.notifyAppReady() après l’initialisation de votre application. Cela indique au SDK Capgo que votre application est prête à recevoir des mises à jour.
Construisez votre bundle JS et téléchargez-le sur Capgo :
Fenêtre de terminal
```
npm run build
npx @capgo/cli@latest upload --channel=Production
```
Ouvrez votre application et attendez que la mise à jour se télécharge. Vous pouvez vérifier le statut avec :
Fenêtre de terminal
```
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 Live Updates pour plus de détails.

Le CLI Capgo

Le CLI Capgo 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 avez un contrôle précis sur le moment où les builds sont produits et déployés, vous permettant d’intégrer Capgo dans vos workflows d’entreprise existants.

À quoi sert le CLI Capgo ?

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

Décider exactement quand construire et déployer les mises à jour, plutôt que de vous fier à l’automatisation intégrée de Capgo
Insérer vos propres processus, comme la signature de code, les tests QA ou les approbations des gestionnaires, entre les étapes de build et de déploiement
Intégrer Capgo dans vos outils et workflows DevOps existants

Authentification

Pour utiliser le CLI Capgo, 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 alors sauvegardée pour une utilisation future. Vous n’aurez pas besoin de fournir votre clé API à chaque commande après vous être connecté.

Différences clés avec les autres outils CLI

Si vous êtes familier avec d’autres outils CLI de mise à jour en direct, il y a quelques points clés à noter concernant le 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 CLI Capgo ne nécessite pas d’étape d’installation séparée. Il est intégré au package @capgo/cli et peut être exécuté directement en utilisant npx
Le CLI de Capgo est conçu spécifiquement pour le workflow de mise à jour en direct, il peut donc ne pas inclure certaines fonctionnalités ou commandes présentes dans des outils CLI plus généralistes

Prochaines étapes

Canaux

Apprenez à utiliser les canaux pour gérer différentes versions et cibler les mises à jour vers des utilisateurs spécifiques

Retours en arrière

Découvrez comment revenir à une version précédente du bundle JS si une mise à jour cause des problèmes

Comportement des mises à jour

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

Mises à jour rapides

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