Allez directement au contenu principal
Tutoriel

Mettez à jour vos applications Capacitor de manière fluide à l'aide de l'Capacitor-updater

Bonjour à la communauté Capacitor Ionic, aujourd'hui je vais vous aider à configurer l'Capacitor-updater dans votre application. Ainsi, vous pourrez effectuer des mises à jour sans heurts.

Martin Donadieu

Martin Donadieu

Responsable de contenu

Mettez à jour vos applications Capacitor de manière fluide à l'aide de l'Capacitor-updater

What is Capacitor-mise-à-jour?

Capacitor-mise-à-jour, une technologie qui aide à la livraison d'actualisations et d'améliorations de l'application aux utilisateurs finaux instantanément.

C'est particulièrement génial si vous voulez faire des corrections de bogues critiques et les livrer instantanément sans passer par les revues de l'App Store.

Vous pouvez y penser comme l'agilité « web-like » de la mise à jour côté par côté dès qu'elles sont disponibles.

De plus, elle fournit des retours en arrière si la mise à jour nouvelle fait tomber l'application.

Comment ça marche?

Capgo garde votre bundle JavaScript de l'application synchronisé avec le serveur Capgo, et chaque fois que l'utilisateur ouvre l'application, il vérifie avec le serveur Capgo si une nouvelle mise à jour est disponible pour le bundle. Et bien sûr, elle vient avec des configurations incroyables qui peuvent vous aider à affiner l'expérience de l'utilisateur.

J'utilise Capgo dans tous mes projets que je construis. Cela me permet de mettre moins de temps dans le processus de revue de l'App Store.

Vous pouvez en savoir plus sur cela ici.

Comprendre la versionnement sémantique avec Capgo

Capgo utilise la versionnement sémantique (semver) pour déterminer quand et comment les mises à jour devraient être appliquées à votre application. Cela garantit que vos utilisateurs ne reçoivent que des mises à jour compatibles et empêche les modifications de rupture d'être déployées automatiquement.

La versionnement semantique suit le format MAJOR.MINOR.PATCH:

  • MAJOR: Les modifications importantes qui nécessitent une mise à jour de l'application native dans les magasins d'applications
  • MINOR: Les nouvelles fonctionnalités qui sont compatibles en arrière-plan
  • PATCH: Les corrections de bogues qui sont compatibles en arrière-plan

Par exemple, si votre application est à la version 1.0.0 et que vous souhaitez mettre à jour vers 1.0.1 (une mise à jour de patch), Capgo appliquera automatiquement cette mise à jour. Cependant, si vous souhaitez mettre à jour de 1.0.0 à 2.0.0 (une version majeure), cela nécessiterait une mise à jour de l'application native dans les magasins d'applications, car cela indique des modifications importantes.

Capgo’s paramètres de canal vous permettent de configurer les types d’actualisations qui sont appliquées automatiquement :

  • Stratégie majeure: Permet toutes les mises à jour (utiliser avec prudence)
  • Stratégie mineure: Permet les mises à jour mineures et de révision uniquement
  • Stratégie de révision: Ne permet que les mises à jour de révision
  • Stratégie de métadonnées: Exige que les exigences de version minimale soient remplies

Vous pouvez tester comment différentes combinaisons de versions fonctionnent avec Capgo’s logique d’actualisation à l’aide de notre Outil de testeur Semver. Cet outil vous aide à comprendre exactement quand les mises à jour seront appliquées en fonction de votre configuration de canal.

Y a-t-il des limitations?

Comme cela peut paraître séduisant, il y a quelques choses que nous devons garder à l'esprit. La première chose est que les mises à jour OTA ne fonctionnent qu'avec des bundles web. Vous pensez peut-être que cela ne constitue pas vraiment une grande limitation car, dans Capacitor JS, nous écrivons presque tous les code en JS CSS et HTML. Même si cela peut être vrai, il y a encore des modules natifs que nous installons dans notre application. Si un module modifie vos répertoires Android ou iOS, vous ne pouvez pas utiliser OTA pour mettre à jour votre application. C'est parce que les contenus de ces répertoires sont utilisés pour compiler des binaires natifs, ce que OTA ne peut pas mettre à jour. Même l'application native ne peut pas mettre à jour cette partie.

Mais vous pouvez configurer votre CI/CD pour gérer cette partie, j'ai créé un tutoriel sur la façon de le faire ici pour IOS.

Configuration automatique de Capgo

Il est temps de s'inscrire et d'obtenir votre clé API pour télécharger votre première version ! Commencez par s'inscrire à un compte Capgo.

Une fois que vous êtes connecté à Capgo, Vous aurez une page de démarrage

Page de démarrage

Suivez les étapes de la page de démarrage pour ajouter votre première application.

Suivez les CLI recommandations

À partir d'une ligne de commande, directement dans le répertoire racine de votre Capacitor application, exécutez :

npx @capgo/cli@latest init Pour installer le Capgo dans votre Capacitor application, le CLI vous guidera tout au long du processus de configuration de votre application avec Capgo.

Si vous souhaitez le faire manuellement, vous pouvez suivre les étapes ci-dessous.

Configuration manuelle du Capgo

Installer le plugin

Vous devriez finir par obtenir ce code ajouté à votre application :

npm i @capgo/capacitor-updater && npx cap sync Pour installer le plugin dans votre Capacitor application.

Et ajoutez ensuite à votre application ce code pour avertir le plugin natif que le bundle JavaScript est en bon état (si vous ne le faites pas, le plugin natif reverra à la version précédente) :

import { CapacitorUpdater } from '@capgo/capacitor-updater'

CapacitorUpdater.notifyAppReady()

Cela informera le plugin natif que l'installation a réussi.

Effectuez ensuite un npm run build && npx cap copy pour mettre à jour votre application.

Se connecter à Capgo CLOUD

Tout d'abord, utilisez l'apikey all present dans votre compte pour vous connecter avec le __CAPGO_KEEP_0__: present in your account to log in with the CLI:

npx @capgo/cli@latest login YOU_KEY

Commencez par créer une application dans le Cloud __CAPGO_KEEP_0__ avec le __CAPGO_KEEP_1__:

Let’s get started by first creating an app in Capgo Cloud with the CLI.

npx @capgo/cli@latest app add

This command will use all variables defined in the Capacitor config file to create the app.

Exécutez la commande pour construire votre __CAPGO_KEEP_0__ et l'envoyer à __CAPGO_KEEP_1__ avec :

Run the command to build your code and send it to Capgo with: npx @capgo/cli@latest bundle upload

fichier. package.json Vérifiez

Vérifiez votre Capgo si la construction est présente.

Vous pouvez même le tester avec mon application de sandbox mobile Faire le canal par défaut.

Après avoir envoyé votre application à __CAPGO_KEEP_0__, vous devez faire votre canal

pour permettre aux applications de recevoir des mises à jour de Capgo. default to let apps receive updates from Capgo.

npx @capgo/cli@latest channel set production -s default

Pour que votre application reçoive une mise à jour en direct de Deploy, vous devrez exécuter l'application sur un appareil ou un émulateur. La façon la plus simple de faire cela est simplement de lancer votre application locale dans un émulateur ou un appareil connecté à votre ordinateur en utilisant la commande suivante.

Ouvrez l'application, mettez-la en arrière-plan et ouvrez-la à nouveau, vous devriez voir dans les journaux que l'application a effectué la mise à jour.

npx cap run [ios | android]

Félicitations ! Vous avez réussi à déployer votre première mise à jour en direct. C'est juste le début de ce que vous pouvez faire avec les mises à jour en direct. Pour en savoir plus, consultez les documents complets sur les mises à jour en direct

Live Updates docs __CAPGO_KEEP_0__.

If vous devez arrêter de recevoir les mises à jour locales, exécutez cette commande npx @capgo/cli@latest channel set

Continuez à mettre à jour vos applications Capacitor de manière fluide à l'aide du Capacitor-moteur de mise à jour

Si vous utilisez Mettez à jour vos applications Capacitor de manière fluide à l'aide du Capacitor-moteur de mise à jour pour planifier la migration et les opérations d'entreprise, connectez-le à Capgo Entreprise pour le flux de travail du produit dans Capgo Entreprise, Alternatives de plugin d'entreprise Ionic pour le flux de travail du produit dans Alternatives de plugin d'entreprise Ionic, Alternatives de Capgo pour le flux de travail du produit dans Alternatives de Capgo, Consulting de Capgo pour le flux de travail du produit dans Capgo Consulting, et Capgo Support Premium pour le flux de travail du produit dans Capgo Support Premium.

Mises à jour en direct pour les applications Capacitor

Lorsqu'un bug de la couche web est en direct, expédiez la correction à travers Capgo au lieu d'attendre des jours pour l'approbation de l'app store. Les utilisateurs reçoivent la mise à jour en arrière-plan tandis que les modifications natives restent dans le chemin de revue normal.

Commencez maintenant

Dernières actualités de notre blog

Capgo vous offre les meilleures informations nécessaires pour créer une application mobile véritablement professionnelle.