Présentation

Use Capgo’s Live Updates feature to update the JavaScript bundles of your app remotely, in real-time. Push JS updates directly to your users without going through the app store review process to instantly fix bugs and ship new features.

Utilisez toujours la dernière version de CLI

Exécutez toujours Capgo CLI avec @latest (par exemple npx @capgo/cli@latest) Le CLI suit sa propre stratégie de versionnement et ne pas Il faut que votre plugin majeure ou la majeure de Capacitor correspondent. La dernière CLI reste compatible avec toute version de plugin de mise à jour prise en charge. Voir Capgo gestion de version.

Note

Live Updates are limited to JavaScript bundle changes. If you need to update native code, such as adding or removing a plugin or changing native project configuration, you’ll need to submit a new native binary build to the app stores.

Comment Fonctionnent les Mises à Jour en Ligne

Le système de Capgo Live Update 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 d'utilisateurs spécifiques. Vous pouvez utiliser les canaux pour gérer différentes pistes de version. Production, Staging, et 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é.

Getting Started

Pour activer les mises à jour en temps réel, suivez ces étapes.

1. Terminez le Capgo Démarrage rapide pour configurer votre application dans Capgo et installer le Capgo SDK.

2. Dans votre application code, appelez CapacitorUpdater.notifyAppReady() Après l'initialisation de votre application. 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 l'update 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 la Déploiement de Mises à Jour en Ligne La page __CAPGO_KEEP_0__ __CAPGO_KEEP_1__

La section intitulée « La Capgo CLI »

The Capgo CLI is a powerful tool that allows developers to interact with Capgo’s services from their own CI/CD pipelines. With the CLI, you have granular control over when builds are produced and deployed, enabling you to integrate Capgo into your existing enterprise workflows.

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ôl’et de flexibilité dans leurs workflows de live update. En utilisant le CLI dans leurs pipelines CI/CD, ils peuvent :

• Déterminer exactement quand construire et déployer des mises à jour, plutôt que de se fier à l'automatisation intégrée de Capgo
• Insérez vos propres processus, comme la signature code, les tests de QA ou les approbations des gestionnaires, entre les étapes de construction et de déploiement.
• Intégrer Capgo dans leurs 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 sécurisément 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 avoir connecté.

Différences clés avec d'autres outils CLI

Si vous êtes familiarisé avec d'autres outils live update 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 live update.

• Le 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 is designed specifically for the live update workflow, so it may not include some features or commands found in more general-purpose CLI tools.

Étapes suivantes

Channels

Apprenez à 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

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

Continuez de la page d'accueil

Si vous utilisez Rollbacks planifier votre tableau de bord et les opérations API, connectez-l’avec API Présentation pour les détails d'implémentation dans API Présentation 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 Appareils, et Paquets pour les détails d'implémentation dans Paquets