Aller au contenu principal
Migration

Migrer d'App Center vers Capgo

Dans ce guide, nous détaillons la migration complète vers Capgo Live Updates, une alternative à Microsoft CodePush.

Migration d’App Center vers Capgo Capgo illustration du blog

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 :

Structure de l'app

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.

Live updates pour les apps Capacitor

Lorsqu'un bug de la couche web est en ligne, déployez le correctif via Capgo au lieu d'attendre des jours l'approbation des stores. Les utilisateurs reçoivent la mise à jour en arrière-plan, tandis que les changements natifs suivent le circuit de validation habituel.

Les derniers articles du blog

Capgo vous offre les meilleures informations pour créer une application mobile vraiment professionnelle.