Vue d'ensemble

Utilisez la fonction d'actualisation 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.

Note

Les mises à jour en temps réel sont limitées aux changements de bundles JavaScript. Si vous avez besoin d'actualiser le code natif, comme ajouter ou supprimer un plugin ou modifier la configuration du 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 d'actualisation en temps réel de Capgo comporte deux composants clés :

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

2. Les canaux, qui vous permettent de cibler les mises à jour sur des groupes spécifiques d'utilisateurs. Vous pouvez utiliser les canaux pour gérer différentes pistes de version, telles que la version de développement, la version de test et la version de production. Production, StagingLorsque vous téléchargez un nouveau bundle JS dans __CAPGO_KEEP_0__ et que vous l'affectez à un canal, le __CAPGO_KEEP_1__ __CAPGO_KEEP_2__ 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, le nouveau bundle sera chargé. Dev.

When you upload a new JS bundle to Capgo and assign it to a channel, the Capgo SDK in apps configured for that channel will detect the update and download it. The next time the app restarts, the new bundle will be loaded.

__CAPGO_KEEP_0__

Pour 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ée, fermez et rouvrez votre application pour charger le nouveau bundle.

Voir le Guide de déploiement des 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 la production et le déploiement des builds, vous permettant d'intégrer Capgo dans vos flux de travail d'entreprise existants.

Qu'est-ce que le Capgo CLI est 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 flux 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érez vos propres processus, comme la code signature, les tests de qualité ou les approbations du gestionnaire, entre les étapes de construction et de déploiement
• Intégrez la Capgo à vos outils et flux de travail DevOps existants

Authentification

Pour utiliser la 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 la Capgo’s CLI:

• Capgo utilise une seule CLI pour les cas d'utilisation de développement et CI/CD, car Capgo se concentre uniquement sur l'ensemble de fonctionnalités de mise à jour en direct.

• Le Capgo CLI n'exige pas d'étape d'installation séparée. Il est embarqué dans le paquet et peut être exécuté directement à l'aide de @capgo/cli __CAPGO_KEEP_0__’s __CAPGO_KEEP_1__ 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 __CAPGO_KEEP_2__ plus généralistes. npx.

• Capgo’s CLI is designed specifically for the live update workflow, so it may not include some features or commands found in more general-purpose CLI tools.

Section intitulée “Étapes suivantes”

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.

__CAPGO_KEEP_0__ utilise une seule __CAPGO_KEEP_1__ pour les cas d'utilisation de développement et CI/CD, car __CAPGO_KEEP_2__ se concentre uniquement sur l'ensemble de fonctionnalités de mise à jour en direct.

Mises à Jour Rapides

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

Continuez depuis l'Aperçu

Si vous utilisez Aperçu pour planifier le tableau de bord et les opérations API, connectez-le avec 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 les API clés, Appareils pour les détails d'implémentation dans les Appareils, et Paquets pour les détails d'implémentation dans les Paquets.