Sauter au contenu principal
Tutoriel

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

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

Crédits de l'article

Martin Donadieu

Auteur

Valeria

Relecteur

Jordan

Éditeur

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

Qu'est-ce que l'Capacitor-metteur à jour ?

L'Capacitor-metteur à jour, une technologie qui aide à la livraison d'actualisations et d'améliorations d'applications aux utilisateurs finaux instantanément.

C'est particulièrement utile si vous souhaitez effectuer des corrections de bogues critiques et les livrer instantanément sans passer par les revues de l'App Store.

Vous pouvez y voir une agilité de chargement côté « web » qui permet des mises à jour dès leur disponibilité.

De plus, il propose des révisions si la mise à jour nouvelle fait tomber l'application.

Comment ça marche ?

L'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 mise à jour nouvelle est disponible pour le bundle. Et bien sûr, il est livré avec des configurations incroyables qui peuvent vous aider à affiner l'expérience de l'utilisateur.

Je utilise l'Capgo dans tous mes projets que je construis. Cela me permet de consacrer moins de temps au processus de revue de l'App Store.

Vous pouvez en savoir plus sur cela ici.

Comprendre la versionnement sémantique avec Capgo

Capgo utilise le 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.

Le versionnement sémantique suit le format MAJOR.MINOR.PATCH:

  • MAJOR: Modifications de rupture nécessitant une mise à jour native de l'appareil
  • MINORNouveautés compatibles avec les versions précédentes
  • PATCHCorrections de bogues compatibles à rebours

Par exemple, si votre application est à la version 1.0.0 et vous souhaitez mettre à jour vers 1.0.1 (un patch), Capgo appliquera automatiquement cette mise à jour. Cependant, si vous souhaitez mettre à jour à partir de 1.0.0 vers 2.0.0 Cette mise à jour nécessite une sortie native de l'App Store car elle implique des modifications importantes.

Les paramètres de la chaîne de Capgo permettent de configurer les types d'actualisations qui sont appliquées automatiquement :

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

Vous pouvez tester comment fonctionnent différentes combinaisons de versions avec la logique d'Capgo mise à jour à l'aide de notre Outil de test SemverCe 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 bien, il y a quelques choses que nous devons garder à l'esprit. seulement fonctionnent avec des paquets web. You may think that this isn’t really a big limitation because, in Capacitor JS, we write almost all code in JS CSS and HTML. While this may be true, there still are native modules that we install to our app. If a module changes your android or iOS directories, you can’t use OTA to update your app. That’s because these directories’ contents are used to compile Native binaries, which OTA can’t update. Even native app cannot update this part.

Mais vous pouvez configurer votre CI/CD pour gérer cette partie, j'ai créé un tutoriel pour vous montrer comment le faire. ici pour iOS.

Auto Capgo Configuration

C'est l'heure de s'inscrire et d'obtenir votre clé API pour télécharger votre première version ! Commencez par 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 : Auto Capgo Configuration ; il est temps de s'inscrire et d'obtenir votre Capgo clé 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 instructions de CLI

Exécutez la commande suivante directement dans le répertoire racine de votre application Capacitor.

npx @capgo/cli@latest init Pour installer Capgo dans votre application Capacitor, 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 de Capgo

Installez le plugin

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

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

Et ajoutez ensuite à votre application ce code pour avertir le plugin natif que le bundle JS 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.

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

Connectez-vous à votre compte Capgo CLOUD.

Tout d'abord, utilisez l' all apikey présente dans votre compte pour vous connecter avec le CLI :

npx @capgo/cli@latest login YOU_KEY

Ajoutez votre première application

Commencez par créer une application dans le Capgo Cloud avec le CLI.

npx @capgo/cli@latest app add

Cette commande utilisera toutes les variables définies dans le fichier de configuration Capacitor pour créer l'application.

Envoyez votre première version

Exécutez la commande pour construire votre code et l'envoyer à Capgo avec : npx @capgo/cli@latest bundle upload

Par défaut, le nom de version sera celui de votre package.json fichier.

Vérifiez dans Capgo si la build est présente.

Vous pouvez même le tester avec mon application sandbox mobile.

Fixez le canal par défaut

Après avoir envoyé votre application à Capgo, vous devez configurer votre canal default to let apps receive updates from Capgo.

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

Recevez un Live Update sur un appareil

Pour que votre application reçoive un live update de Deploy, vous devrez exécuter l'application sur un appareil ou un émulateur. La façon la plus simple de procéder est de lancer votre application locale dans un émulateur ou un appareil connecté à votre ordinateur en utilisant la commande suivante.

npx cap run [ios | android]

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

Congrats! 🎉 You have successfully deployed your first Live Update. This is just the start of what you can do with Live Updates. To learn more, view the complete Mises à jour en direct.

Si vous avez besoin d'arrêter de recevoir les mises à jour locales, exécutez cette commande npx @capgo/cli@latest channel set

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

Si vous utilisez Mettez à jour vos applications Capacitor de manière fluide à l'aide du Capacitor-updater. pour planifier la migration et les opérations d'entreprise, connectez-l’à Capgo Entreprise pour le flux de travail du produit dans Capgo Enterprise, Alternatives de plugins Ionic Enterprise pour le flux de travail du produit dans les alternatives Ionic Enterprise Plugin Alternatives Capgo pour le flux de travail du produit dans Capgo Alternatives, Consulting 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 temps réel pour les applications Capacitor

Quand un bug de la couche web est en direct, expédiez la correction par l'Capgo au lieu d'attendre des jours pour l'approbation de la boutique d'applications. Les utilisateurs reçoivent la mise à jour en arrière-plan tandis que les modifications natives restent dans la voie de revue normale.

Support humain de Martin

Démarrer maintenant

Dernières actualités de notre Blog

Capgo vous donne les meilleures informations dont vous avez besoin pour créer une application mobile vraiment professionnelle.