Allez directement au contenu principal
Guide

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

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

Martin Donadieu

Martin Donadieu

Spécialiste du contenu

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

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

L'Capacitor-metteur à jour, une technologie qui aide à la livraison d'actualisations et d'améliorations des 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 comme une agilité « web-like » de la mise à jour des applications par side-loading dès qu'elles sont disponibles.

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

Comment ça marche ?

Capgo garde votre paquet 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 paquet. Et bien sûr, il est livré avec des tonnes de configurations incroyables qui peuvent vous aider à affiner l'expérience de votre utilisateur.

Je utilise 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 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 changements de rupture d'être déployés automatiquement.

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

  • MAJOR: Changements de rupture nécessitant une mise à jour native de l'appareil
  • MINOR: Nouvelles fonctionnalités compatibles en arrière-plan
  • PATCH: Corrections de bogues compatibles en arrière-plan

Par exemple, si votre application est à la version 1.0.0 et vous souhaitez mettre à jour vers 1.0.1 (Capgo), Capgo appliquera automatiquement cette mise à jour. Cependant, si vous souhaitez mettre à jour de 1.0.0 à 2.0.0 context : Page/zone : Page de produit de mises à jour en direct. Rôle : Étiquette de navigation ou élément de l'interface utilisateur court. Clé de message `live_update_dynamic_label_to` (Étiquette de mise à jour en direct dynamique vers)

(Capgo), cela nécessiterait une mise à jour native de l'application store, car cela implique des changements brisants.

  • __CAPGO_KEEP_0__ permet de configurer les paramètres de canal pour déterminer les types de mises à jour qui sont appliquées automatiquement :Stratégie majeure
  • : Permet toutes les mises à jour (utilisez avec prudence): Permet les mises à jour mineures et de patch uniquement
  • Stratégie de mise à jour 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 différentes combinaisons de versions fonctionnent avec la logique d'actualisation de Capgo en utilisant notre outil de testeur Semver Outil de testeur Semver. Ce 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, il y a quelques choses que nous devons garder à l'esprit. La première chose est que les mises à jour OTA ne fonctionnent que avec des bundles web Seulement fonctionnent avec des bundles 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 vous 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 instructions de CLI

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

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 Capgo

Installez le plugin

Vous devriez finir avec 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 indiquera au 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 clé d'API 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 Capgo Cloud avec le CLI.

npx @capgo/cli@latest app add

Cette commande utilise 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'envoyez à 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_KEEP_0__ Capgo Vous pouvez même le tester avec mon

application de sandbox mobile Envoyez une mise à jour.

Configure le canal par défaut

Après avoir envoyé votre application à Capgo, vous devez configurer votre canal default pour permettre aux applications de recevoir des mises à jour à partir de Capgo.

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

Recevez une mise à jour en direct sur un appareil

Pour que votre application reçoive une mise à jour en direct depuis Deploy, vous devrez exécuter l'application sur un appareil ou un émulateur. La méthode la plus simple consiste à utiliser la commande suivante pour lancer votre application locale sur un émulateur ou un appareil connecté à votre ordinateur.

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.

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 la documentation complète sur les mises à jour en direct. Si vous avez besoin d'arrêter de recevoir les mises à jour locales, exécutez cette commande.

Continuez à mettre à jour vos applications __CAPGO_KEEP_0__ de manière fluide à l'aide de l'__CAPGO_KEEP_1__-updater npx @capgo/cli@latest channel set

Keep going from Update your Capacitor apps seamlessly using Capacitor-updater

Mettez à jour vos applications __CAPGO_KEEP_0__ de manière fluide à l'aide de l'__CAPGO_KEEP_1__-updater Update your Capacitor apps seamlessly using 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 Entreprise, Alternatives de plugin d'entreprise Ionic Pour le flux de travail du produit dans Alternatives de plugin d'entreprise Ionic, Capgo Alternatives Pour le flux de travail du produit dans Capgo Alternatives, Capgo Conseil Pour le flux de travail du produit dans Capgo Conseil, et Capgo Support Premium Pour le flux de travail du produit dans Capgo Support Premium.

Mises à jour en direct pour les applications Capacitor

When a web-layer bug is live, ship the fix through Capgo instead of waiting days for app store approval. Users get the update in the background while native changes stay in the normal review path.

Lorsqu'un bug de la couche web est en direct, expédiez la correction par __CAPGO_KEEP_0__ au lieu de 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 le chemin de revue normal.

Contexte : Page/zone : Site de marketing Capgo. Rôle : Description de soutien ou de métadescription. Vu dans : composant GetStarted.astro. Préservez les termes de produit/marque et les termes de développeur exactement. Clé de message `instant_updates_for_capacitor_apps_description` (Mises à jour instantanées pour les applications Capacitor Description).

Support humain de Martin

Capgo gives you the best insights you need to create a truly professional mobile app.