Résumé de la migration
- Capgo is a service that helps development teams send live app to deployed apps.
- Les applications JS Capacitor écrites en jQuery Mobile, Framework 7, Sencha, KendoUI, Ionic ou même avec votre propre solution sur mesure peuvent être migrées. Une application Ionic existante n’est pas requise..
- Colt propose des services équivalents à App Center Build (compilation d’applications Android/iOS). Pour les services Test, Diagnostics et Analytics.
Remarque
Si votre application utilise encore Cordova, il est nécessaire de migrer vers Capacitor d’abord avant de migrer vers Capgo.
Développé par l’équipe Ionic comme successeur spirituel de Cordova, Capacitor permet au développement de se rapprocher des outils et capacités natifs, avec pour objectif d’offrir une expérience utilisateur et des performances encore meilleures.
Heureusement, le processus de migration est simple et la majorité des plugins Cordova sont rétrocompatibles avec Capacitor. Commencez la migration ici.
À propos de Capgo
Capgo gère la mise à jour des applications au fil du temps. Les équipes de développement peuvent se concentrer entièrement sur les fonctionnalités uniques de leur application et externaliser le processus complexe de livraison d’applications à Capgo.
Capgo comble le fossé entre la livraison web et le mobile.
Prérequis Capgo
Comme App Center, Capgo prend en charge les apps hébergées dans des dépôts Git sur Azure DevOps, Bitbucket, GitHub et GitLab.
Installer Capgo CLI
note
Node et NPM doivent être installés sur votre ordinateur avant de commencer. Utilisez toujours la version LTS actuelle Capgo ne supporte pas les anciennes versions.
Créer package.json et les fichiers de config Capacitor
note
Avant de commencer, je vous recommande d’effectuer vos modifications sur une branche Git vierge.
Depuis Capgo a été créé pour automatiser les applications capacitor. Il nécessite un fichier que votre application ne possède peut-être pas. Créez d’abord un capacitor.config.json fichier. La façon la plus simple de le créer est d’exécuter à la racine de votre application :
npm install @capacitor/core
Ensuite, initialisez Capacitor à l’aide du questionnaire CLI :
npx cap init
Le CLI vous posera quelques questions, en commençant par le nom de votre application et l’identifiant de package que vous souhaitez utiliser.
Enfin, committez les nouveaux fichiers dans votre projet :
git add .git commit -m "added package json and capacitor config" && git push
Migrer le Code
Maintenant que vous avez les nouveaux Capgo les fichiers en place, vous pouvez maintenant vous concentrer sur l'application elle-même. Capgo attend que l'intégralité de l'application compilée se trouve dans un répertoire nommé dist.
Si votre build code n'est pas dans un dist répertoire, modifiez cette valeur dans le fichier de config Capacitor.
Voici à quoi devrait ressembler la structure du répertoire de l'application :

Configuration Capgo
Votre application étant prête pour l' Capgo intégration, il est temps de vous inscrire et de récupérer votre clé API pour envoyer votre première version ! Commencez par créer un compte Capgo.
Une fois connecté à Capgo, accédez à la page Compte, cliquez sur la clé API, puis sur la clé « write » pour la copier dans votre presse-papiers.
Installer le SDK Capgo
Depuis un terminal, à la racine du dossier de votre application Capacitor, exécutez la commande suivante :
npm i @capgo/capacitor-updater && npx cap sync
Pour installer le plugin dans votre application Capacitor.
Ajoutez ensuite ce code à votre application, en remplacement de celui de CodePush :
import { CapacitorUpdater } from '@capgo/capacitor-updater'
CapacitorUpdater.notifyAppReady()
Cela indiquera au plugin natif que l'installation a réussi.
Déployer des live updates (alternative à CodePush)
La fonctionnalité Live Update fonctionne en utilisant l’application installée Capgo SDK dans votre application native pour écouter une destination de canal de déploiement spécifique. Lorsqu’un build Web est assigné à une destination de canal, cette mise à jour est déployée sur les appareils des utilisateurs dont les binaires sont configurés pour écouter la destination de canal spécifiée.
Connectez-vous à Capgo Cloud
Tout d'abord, utilisez la all clé API présente dans votre compte pour vous connecter avec le CLI :
npx @capgo/cli@latest login YOURKEY
Ajouter votre première app
Commençons par créer l’application dans Capgo Cloud à l’aide de CLI.
npx @capgo/cli@latest app add
Cette commande utilisera toutes les variables définies dans le fichier de config Capacitor pour créer l'app.
Envoyez votre premier bundle
Lancez la commande pour compiler votre code et l'envoyer sur Capgo avec :
npx @capgo/cli@latest bundle upload --channel production
Par défaut, le nom de la version sera celui de votre package.json fichier.
Vérifiez dans Capgo si le build est présent.
Vous pouvez même le tester avec mon app mobile sandbox.
Définir le canal par défaut
Une fois que vous avez envoyé votre application à Capgo, vous devez définir votre canal default to let apps receive updates from Capgo.
npx @capgo/cli@latest channel set production -s default
Configurer l'app pour valider les mises à jour
Ajoutez cette config à votre fichier JavaScript principal.
import { CapacitorUpdater } from '@capgo/capacitor-updater'
CapacitorUpdater.notifyAppReady()
Puis exécutez un npm run build && npx cap copy pour mettre à jour votre application.
Recevoir un Live Update sur un appareil
Pour que votre application reçoive un live update depuis Deploy, vous devrez lancer l'app sur un appareil ou un émulateur. Le plus simple est d'utiliser la commande suivante pour lancer votre app en local sur un émulateur ou un appareil connecté à votre ordinateur.
npx cap run [ios | android]
Ouvrez l'app, passez-l’en arrière-plan puis rouvrez-la ; vous devriez voir dans les logs que l'app a effectué la mise à jour.
Félicitations ! 🎉 Vous avez déployé avec succès votre premier Live Update. Ce n’est que le début de ce que vous pouvez faire avec Live Updates. Pour en savoir plus, consultez la documentation complète Live Updates.
Supprimer les dépendances App Center
Maintenant que les services de Capgo sont intégrés, vous devez supprimer toutes les références à App Center. Outre le fait qu’il est recommandé de supprimer les code/services inutilisés, la suppression des SDK devrait réduire la taille de vos applications.
Ouvrez d’abord un terminal, puis désinstallez les plugins App Center :
cordova plugin remove cordova-plugin-appcenter-analytics cordova-plugin-appcenter-crashes cordova-plugin-code-push
Ensuite, ouvrez config.xml et supprimez les éléments suivants preference valeurs. Elles ressembleront à ceci :
<preference name="APP_SECRET" value="0000-0000-0000-0000-000000000000" /><preference name="CodePushDeploymentKey" value="YOUR-ANDROID-DEPLOYMENT-KEY" /><preference name="CodePushPublicKey" value="YOUR-PUBLIC-KEY" />
Si vous utilisiez App Center Analytics dans votre application, supprimez les éléments preferences suivants : APPCENTER_ANALYTICS_ENABLE_IN_JS et APPCENTER_CRASHES_ALWAYS_SEND.
Supprimez les éléments <access /> suivants :
<access origin="https://codepush.appcenter.ms" /><access origin="https://codepush.blob.core.windows.net" /><access origin="https://codepushupdates.azureedge.net" />
Supprimez la référence à CodePush dans la CSP meta dans la balise index.html du fichierhttps://codepush.appcenter.ms):
<meta http-equiv="Content-Security-Policy" content="default-src https://codepush.appcenter.ms 'self' data: gap: https://ssl.gstatic.com 'unsafe-eval'; style-src 'self' 'unsafe-inline'; media-src *" />
Enfin, dans votre application, supprimez toutes les références code aux services App Center, telles que codePush.sync();.
Étapes suivantes
Vous avez migré d'App Center vers Capgo, en utilisant les Live Updates. Ce n'est que le début de ce que vous pouvez faire avec Capgo. Explorez le reste du service, qui inclut les canaux (plusieurs environnements) et les overrides. Intégrez le Cloud CLI en utilisant Capgo dans votre plateforme CI/CD de choix (comme GitHub Action, GitLab, Jenkins, etc.).
Envoi automatique de la mise à jour de l’app
Si votre code est hébergé sur GitHub, vous pouvez configurer le build et la release automatiques en quelques étapes supplémentaires, grâce aux actions GitHub.
J’ai rédigé un second article pour vous permettre de le faire.
Crédits
Un grand merci à Ionic, cet article s'appuie sur cet article réécrit avec chat-gpt-3 et adapté.
Continuer avec « Migrer d'App Center vers Capgo »
Si vous utilisez Migrer d'App Center vers Capgo pour planifier la migration et les opérations d'entreprise, connectez-l’à Capgo Entreprise pour le workflow produit dans Capgo Enterprise, Alternatives aux plugins Ionic Enterprise pour le workflow produit dans les alternatives aux plugins Ionic Enterprise, Alternatives Capgo pour le workflow produit dans les alternatives Capgo, Conseil Capgo pour le workflow produit dans Capgo Consulting, et Support Premium Capgo pour le workflow produit dans Capgo Premium Support.