Vue d'ensemble

Copiez un prompt de configuration avec les étapes d'installation et le guide markdown complet pour ce plugin.

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 instantanément les bogues et livrer de nouvelles fonctionnalités.

Toujours exécutez Capgo avec CLI @latest (par exemple npx @capgo/cli@latest). Le CLI suit sa propre versionnage et n'a pas besoin de correspondre à la version majeure de votre plugin ou à la version majeure de CLI. La dernière version de __CAPGO_KEEP_1__ reste compatible avec toute version prise en charge du plugin d'actualisation. Consultez la versionnage de CLI Remarque need to match your plugin major or Capacitor major. The latest CLI stays compatible with any supported updater plugin version. See Les actualisations en temps réel sont limitées aux modifications des bundles JavaScript. Si vous avez besoin d'actualiser un Capgo natif, comme ajouter ou supprimer un plugin ou modifier la configuration du projet natif, vous devrez soumettre une nouvelle build de fichier binaire natif aux magasins d'applications..

How Live Updates Work

Le système de mise à jour en temps réel 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.
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, telles que Production, Staginget Dev.

Lorsque vous téléchargez un nouveau bundle JS vers Capgo et que vous l'assignez à 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, le nouveau bundle sera chargé.

Getting Started

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

Terminez le Capgo Quickstart pour configurer votre application dans Capgo et installer le Capgo SDK.
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.
Construirez votre bundle JS et le téléchargez sur Capgo:
fenêtre de terminal
```
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 :
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.

Voir la Déploiement de mises à jour en temps réel 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 la mise en ligne des builds, vous permettant d'intégrer Capgo dans vos workflows d'entreprise existants.

Qu'est-ce que le Capgo CLI est utilisé 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 des 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é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é.

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.
Le Capgo CLI n'exige pas d'é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 temps réel, il peut donc ne pas inclure certaines fonctionnalités ou commandes trouvées dans les outils CLI plus généralistes.

É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 vers le haut

Découvrez comment remonter à 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 depuis l'aperçu

Si vous utilisez Vue d'ensemble pour planifier le tableau de bord et les opérations API, connectez-le avec Vue d'ensemble API pour les détails d'implémentation dans Vue d'ensemble API, Introduction pour les détails d'implémentation dans Introduction, Clés API pour les détails d'implémentation dans Clés API, Appareils pour les détails d'implémentation dans Appareils, et Bundles pour les détails d'implémentation dans les Bundles.