Overview

Utilisez la fonctionnalité d'actualisations en temps réel 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 revue de l'App Store pour corriger les bogues et livrer de nouvelles fonctionnalités instantanément.

Note

Mises à jour en temps réel sont limitées aux modifications du bundle JavaScript. Si vous avez besoin d'actualiser natively code, comme l'ajout ou la suppression d'un plugin ou la modification de la configuration de projet natif, vous devrez soumettre une nouvelle build binaire native aux magasins d'applications.

Comment fonctionnent les Mises à jour en temps réel

Le système de mise à jour en temps réel de Capgo comporte deux composants clés :

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

2. Les canaux, qui vous permettent de cibler les mises à jour vers des groupes spécifiques d'utilisateurs. Vous pouvez utiliser les canaux pour gérer différentes pistes de version, comme Production, StagingEt Dev.

Lorsque vous téléchargez une nouvelle bundle JS vers Capgo et que vous l'affectez à un canal, le Capgo SDK dans les applications configurées pour ce canal détecte la mise à jour et la télécharge. La prochaine fois que l'application redémarre, la nouvelle bundle sera chargée.

Prise en main

Pour commencer à utiliser les mises à jour en temps réel, suivez ces étapes :

1. Completez le Capgo Quickstart pour configurer votre application sur Capgo et installer le Capgo SDK.

2. Dans votre application code, appelez CapacitorUpdater.notifyAppReady() après que votre application ait terminé de s'initialiser. Cela informe le Capgo SDK que votre application est prête à recevoir des mises à jour.

3. Construirez votre bundle JS et le téléchargez sur Capgo:

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

4. Ouvrez votre application et attendez que la mise à jour se télécharge. Vous pouvez vérifier l'état avec :

   npx @capgo/cli@latest app debug

5. Une fois l'update téléchargé, fermez et rouvrez votre application pour charger le nouveau bundle.

Voir le Déployer les Mises à Jour en Direct guide pour plus de détails.

Le Capgo CLI

Le Capgo CLI est un outil puissant qui permet aux développeurs de communiquer avec les services de Capgo à partir de leurs propres pipelines CI/CD. Avec le CLI, vous avez un contrôle granulaire sur quand les builds sont produits et déployés, vous permettant d'intégrer Capgo dans vos workflows d'entreprise existants.

Qu'est-ce que le Capgo CLI pour?

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 workflows de mise à jour en direct. En utilisant le CLI dans vos pipelines CI/CD, vous pouvez:

• Déterminer 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, la vérification qualité, ou les approbations des gestionnaires, entre les étapes de construction 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 vos paramètres de compte Capgo.

Pour vous connecter et stocker de manière sécurisée votre clé API, exécutez :

npx @capgo/cli@latest login [API_KEY]

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

Différences clés par rapport à d'autres outils CLI

Si vous êtes familiarisé avec d'autres outils de mise à jour en temps réel CLI, il y a quelques choses importantes à noter sur Capgo’s CLI:

• Capgo utilise une seule clé CLI pour les cas d'utilisation de développement et CI/CD, car Capgo est axé uniquement sur le jeu de fonctionnalités de mise à jour en temps réel.

• The Capgo CLI n'a pas besoin d'une étape d'installation séparée. Il est intégré au @capgo/cli package et peut être exécuté directement à l'aide de npx.

• Capgo’s CLI 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 des outils CLI plus généraux.

Étapes suivantes

Canaux

Découvrez comment utiliser les canaux pour gérer différentes pistes de version et cibler les mises à jour vers des utilisateurs spécifiques.

Remontées

Découvrez comment remonter à une version précédente du bundle JS si une mise à jour cause 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

Apprenez à utiliser les mises à jour rapides pour accélérer le processus d'actualisation.

Continuez depuis l'aperçu

Si vous utilisez Aperçu pour planifier le tableau de bord et les opérations API, connectez-le à API Aperçu pour les détails d'implémentation dans API Aperçu, Introduction pour les détails d'implémentation dans Introduction, API Clés pour les détails d'implémentation dans API Clés, Appareils pour le détail d'implémentation dans Appareils, et Paquets pour le détail d'implémentation dans Paquets.