Vue d'ensemble

Utilisez la fonctionnalité d'actualisations en direct 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.

Toujours utilisez la dernière version de CLI

Toujours exécutez Capgo CLI avec @latest (par exemple npx @capgo/cli@latest) Le CLI suit sa propre stratégie de versionnement et ne ne need to match your plugin major or Capacitor major. The latest CLI stays compatible with any supported updater plugin version. See nécessite pas de correspondre à la version majeure de votre plugin ou à la version majeure de Capgo. La dernière version de __CAPGO_KEEP_1__ reste compatible avec toute version de plugin de mise à jour prise en charge. Consultez.

Note

Mises à jour en temps réel sont limitées aux modifications du bundle JavaScript. Si vous avez besoin d'actualiser nativement code, comme ajouter ou supprimer un plugin ou modifier la configuration de projet native, 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 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 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 un nouveau bundle JS vers Capgo et l'affectez à un canal, le Capgo SDK dans les applications configurées pour ce canal détectera la mise à jour et la téléchargera. La prochaine fois que l'application redémarre, le nouveau bundle sera chargé.

Prise en main

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

1. Terminez le Capgo Quickstart pour configurer votre application dans 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 soit téléchargée. Vous pouvez vérifier l'état avec :

   npx @capgo/cli@latest app debug

5. Lorsque la mise à jour est téléchargée, fermez et rouvrez votre application pour charger le nouveau bundle.

Voir le Déploiement des mises à jour en temps réel guide pour plus de détails.

La Capgo CLI

La 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 la CLI, vous avez un contrôle granulaire sur la production et le déploiement des builds, vous permettant d'intégrer Capgo dans vos workflows d'entreprise existants.

Qu'est-ce que la Capgo CLI est-elle pour?

La Capgo CLI est conçue pour les développeurs et les équipes qui ont besoin de plus de contrôl’et de flexibilité dans leurs workflows de mise à jour en temps réel. En utilisant la CLI dans vos pipelines CI/CD, vous pouvez:

• Décider exactement quand construire et déployer des mises à jour, plutôt que de se 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égrer Capgo dans vos outils et workflows 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é.

Differences 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 se concentre uniquement sur le jeu de fonctionnalités de mise à jour en temps réel.

• Le Capgo CLI n'exige pas d'étape d'installation séparée. Il est intégré avec le @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 mise à jour en direct, il peut donc ne pas inclure certaines fonctionnalités ou commandes trouvées dans des outils plus généralistes CLI.

Étapes suivantes

Channels

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

Rollbacks

Découvrez comment revenir à une version précédente du bundle JS si une mise à jour entraîne 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.

Continuez de là depuis l'aperçu

Si vous utilisez l'aperçu pour planifier le tableau de bord et les opérations API , connectez-l’à 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 les détails d'implémentation dans les appareils, et Les ensembles pour les détails d'implémentation dans les ensembles.