Résumé de la migration
- Capgo est un service qui aide les équipes de développement à envoyer des applications live vers des applications déployées.
- Capacitor les applications JS écrites en jQuery Mobile, Framework 7, Sencha, KendoUI, Ionic ou même votre propre solution personnalisée peuvent être migrées. Une application Ionic existante n'est pas requise..
- Colt fournit des services équivalents pour App Center Build (construire des applications Android/iOS). Pour les services Test, Diagnostics et Analytics.
Note
Si votre application utilise toujours Cordova, il est nécessaire de migrer vers Capacitor avant de migrer vers Capgo.
Construit par l'équipe Ionic en tant que successeur spirituel à Cordova, Capacitor permet au développement de se rapprocher des outils et capacités natives avec l'objectif de fournir une expérience utilisateur et une performance encore meilleures.
Malheureusement, le processus de migration n'est pas compliqué et la plupart des plugins Cordova sont compatibles avec Capacitor dans le sens inverse. Démarrez la migration ici.
À propos de Capgo
Capgo gère l'actualisation 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 compliqué de livraison d'applications à Capgo.
Capgo remplit les lacunes entre la livraison web et mobile.
Prérequis de Capgo
Comme App Center, Capgo GitHub prend en charge les applications hébergées dans les dépôts Git sur Azure DevOps, Bitbucket, GitHub, et GitLab.
Installez Capgo CLI
note
Vous devez avoir Node et NPM installés sur votre ordinateur avant de poursuivre. Utilisez toujours le version actuelle LTS Capgo n'accepte pas les versions plus anciennes.
Créer package.json et Capacitor des fichiers de configuration
note
Avant de commencer, je vous recommande de faire les modifications sur une branche Git fraîche.
Depuis Capgo a été créé pour automatiser les applications capacitor, elle nécessite un fichier que votre application peut ne pas avoir. Tout d'abord, créez un capacitor.config.json fichier. La manière la plus facile de le créer est de lancer dans le répertoire racine de votre application :
npm install @capacitor/coreEnsuite, initialisez Capacitor à l'aide du questionnaire CLI :
npx cap initLe questionnaire CLI vous posera quelques questions, en commençant par le nom de votre application, et l'ID de package que vous souhaitez utiliser pour votre application.
Enfin, commitez les nouveaux fichiers dans votre projet :
git add .git commit -m "added package json and capacitor config" && git pushMigrer le Code
Maintenant que vous avez les nouveaux fichiers requis Capgo en place, vous pouvez vous concentrer sur l'application elle-même. Capgo s'attend à ce que l'application entièrement construite soit à l'intérieur d'un répertoire nommé dist.
Si votre application construite code n'est pas dans un dist répertoire, modifiez cette valeur dans le fichier de configuration Capacitor.
Voici ce que la structure de répertoire de l'application devrait ressembler à :
Capgo Configuration
With votre application prête pour l'intégration, il est temps de vous inscrire et d'obtenir votre clé __CAPGO_KEEP_0__ pour télécharger votre première version ! Commencez par l'inscription à un compte Capgo Une fois que vous êtes connecté à API, naviguez vers la page Compte puis cliquez sur la clé __CAPGO_KEEP_1__ , puis cliquez sur la touche ‘écrire’ pour copier dans votre presse-papier. Installez le Capgo __CAPGO_KEEP_1__.
Once you’re logged into Capgo, navigate to the Account page then click on API key, then click on the ‘write’ key to copy it to your clipboard.
Install the Capgo SDK
Et ajoutez ensuite à votre application ce Capacitor en remplacement de CodePush :
npm i @capgo/capacitor-updater && npx cap sync
To install the plugin into your Capacitor app.
And then add to your app this code as replacement of CodePush one:
import { CapacitorUpdater } from '@capgo/capacitor-updater'
CapacitorUpdater.notifyAppReady()La fonctionnalité de mise à jour en direct fonctionne en utilisant la clé __CAPGO_KEEP_1__ installée
La fonctionnalité de mise à jour en direct fonctionne en utilisant la clé installée
The Live Update feature works by using the installed __CAPGO_KEEP_1__ key Capgo SDK dans votre application native pour écouter un canal de déploiement spécifique. Lorsqu'une mise à jour Web est affectée à un canal de destination, cette mise à jour sera déployée sur les appareils utilisateurs exécutant des binaires configurés pour écouter le canal de destination spécifié.
Se connecter à Capgo CLOUD
Tout d'abord, utilisez le all clé d'API présente dans votre compte pour vous connecter avec le CLI:
npx @capgo/cli@latest login YOURKEYAjoutez votre première application
Commencez par créer l'application dans Capgo Cloud avec la 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 premier bundle
Exécutez la commande pour construire votre code et l'envoyez à Capgo avec :
npx @capgo/cli@latest bundle upload --channel productionPar défaut, le nom de version sera le même que celui dans votre package.json fichier.
Vérifier l'entrée Capgo si la construction est présente.
Vous pouvez même le tester avec mon application sandbox mobile Définir le canal par défaut.
Après avoir envoyé votre application à __CAPGO_KEEP_0__, vous devez faire de 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 defaultAjoutez cette configuration à votre fichier JavaScript principal.
Ensuite, faites une
import { CapacitorUpdater } from '@capgo/capacitor-updater'
CapacitorUpdater.notifyAppReady()configuration npm run build && npx cap copy To mettre à jour votre application.
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 façon la plus simple de faire cela est simplement d'utiliser la commande suivante pour lancer votre application locale dans un émulateur ou un appareil connecté à votre ordinateur.
npx cap run [ios | android]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.
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. Supprimer les dépendances d'App Center.
Maintenant que nous avons intégré les services de __CAPGO_KEEP_0__, vous devriez supprimer toute référence à App Center. En plus d'être une bonne pratique de supprimer les services inutilisés __CAPGO_KEEP_1__, supprimer les __CAPGO_KEEP_2__ devrait réduire la taille de vos applications.
Now that we’ve integrated Capgo’s services, you should remove any references to App Center. Besides being a best practice to remove unused code/services, removing the SDK should reduce the size of your apps.
Ensuite, ouvrez
cordova plugin remove cordova-plugin-appcenter-analytics cordova-plugin-appcenter-crashes cordova-plugin-code-pushet supprimez les valeurs suivantes. Elles ressembleront à : config.xml __CAPGO_KEEP_0__ preference __CAPGO_KEEP_1__
<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 les services d'App Center Analytics dans votre application, supprimez les éléments suivants : preferences éléments : APPCENTER_ANALYTICS_ENABLE_IN_JS et APPCENTER_CRASHES_ALWAYS_SEND.
Supprimez les éléments suivants : <access /> éléments :
<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 tag dans le index.html fichier (https://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 toute référence à code aux services d'App Center, comme codePush.sync();.
Étapes suivantes
Vous avez migré d'App Center vers Capgo, en utilisant les mises à jour en direct. C'est juste le début de ce que vous pouvez utiliser Capgo pour. Explorez le reste des fonctionnalités de la plateforme, qui incluent le canal (environnements multiples) et la prise en charge. Intégration Cloud CLI, utilisez Capgo dans votre plateforme CI/CD de choix (comme l'action GitHub de GitHub, GitLab, Jenkins, et plus encore).
Envoi automatique de mise à jour d'application
Si votre code est hébergé sur GitHub, vous pouvez configurer automatiquement la construction et la mise en production en quelques étapes supplémentaires, grâce aux actions GitHub.
J'ai écrit un deuxième article pour vous permettre de le faire.
Crédits
Je vous remercie beaucoup de Ionic, cet article repose sur cet article reécrit avec chat-gpt-3 et adapté.
Continuez de Migrer depuis App Center vers Capgo
Si vous utilisez Migrer depuis App Center vers Capgo pour planifier la migration et les opérations d'entreprise, connectez-le avec Capgo Entreprise pour le flux de travail du produit dans Capgo Entreprise, Alternatives d'extension d'entreprise d'Ionic pour le flux de travail du produit dans Alternatives d'extension d'entreprise d'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.
