Migration depuis le Centre d'applications vers Capgo

Résumé de la migration

Capgo est un service qui aide les équipes de développement à envoyer des mises à jour live vers des applications déployées.
Capacitor permet la migration d'applications JS écrites en jQuery Mobile, Framework 7, Sencha, KendoUI, Ionic ou même votre propre solution personnalisée. Une application Ionic existante n'est pas requise..
Colt propose 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 __CAPGO_KEEP_0__ avant de migrer vers Capacitor. Construit par l'équipe Ionic en tant que successeur spirituel à Cordova, Capgo permet le développement de se rapprocher des outils et capacités natives avec l'objectif de fournir une meilleure expérience utilisateur et une meilleure performance.

Heureusement, le processus de migration est facile et la plupart des plugins Cordova sont compatibles avec Capacitor.

Fortunately, the migration process is easy and the majority of Cordova plugins are backward compatible with Capacitor. À propos de __CAPGO_KEEP_0__.

Capgo, gère l'actualisation des applications au fil du temps. Les équipes de développement peuvent se concentrer complètement sur les fonctionnalités uniques de leur application et externaliser le processus compliqué de livraison d'application à __CAPGO_KEEP_1__.

Capgo, handles updating apps over time. Development teams can focus completely on the unique features of their app and outsource the complicated app delivery process to Capgo.

Capgo fills in the gaps between web delivery and mobile.

Capgo Prérequis

Comme App Center, Capgo supporte les applications hébergées dans des 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 la version LTS actuelle. __CAPGO_KEEP_0__ ne pas utiliser des versions plus anciennes. Capgo do not older versions.

et configurer les fichiers __CAPGO_KEEP_0__ `package.json` and Capacitor config files

__CAPGO_KEEP_0__

Avant de commencer, je vous recommande de faire des modifications sur une branche Git fraîche.

Depuis Capgo a été créé pour automatiser les applications capacitor, il 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/core

Ensuite, initialisez Capacitor à l'aide du questionnaire CLI :

npx cap init

Le 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 push

Migrer le Code

Maintenant que vous avez les nouveaux fichiers requis __CAPGO_KEEP_0__ en place, vous pouvez vous concentrer sur l'application elle-même. Capgo __CAPGO_KEEP_1__ Capgo attend que l'application entière soit à l'intérieur d'un dossier nommé dist.

Si votre application code construite n'est pas dans un dossier dist directory, modifiez cette valeur dans le fichier de configuration de Capacitor.

Voici ce que devrait ressembler la structure de votre dossier d'application :

Structure de l'application

Configuration de Capgo

avec votre application prête à l'intégration avec __CAPGO_KEEP_0__, il est temps de vous inscrire et d'obtenir votre clé __CAPGO_KEEP_0__ pour télécharger votre première version ! Commencez par s'inscrire à 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 la clé dans votre presse-papier. signing up for a Capgo account.

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.

Installez le Capgo SDK

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

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

Et ajoutez ensuite à votre application ce code en remplacement de CodePush :

import { CapacitorUpdater } from '@capgo/capacitor-updater'

CapacitorUpdater.notifyAppReady()

Cela indiquera au plugin natif que l'installation a réussi.

Déploiement des Mises à Jour en Ligne (Alternative à CodePush)

La fonctionnalité de Mise à Jour en Ligne fonctionne en utilisant les __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ installés Capgo SDK Connectez-vous à votre compte __CAPGO_KEEP_0__ CLOUD

apikey de votre compte. all __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ présent dans votre compte pour vous connecter avec le CLI:

npx @capgo/cli@latest login YOURKEY

Ajoutez votre première application

Commencez par créer l'application dans 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.

Téléchargez votre première archive

Exécutez la commande pour construire votre code et l'envoyer à 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 la construction est présente.

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

Fixer 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

Configurer l'application pour valider les mises à jour

Ajoutez cette configuration à votre fichier JavaScript principal.

import { CapacitorUpdater } from '@capgo/capacitor-updater'

CapacitorUpdater.notifyAppReady()

Ensuite, faites un npm run build && npx cap copy pour mettre à jour votre application.

Recevoir une mise à jour en direct sur un appareil

Pour que votre application reçoive une mise à jour en direct à partir 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 à l'aide de la commande suivante.

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 le contenu complet Mises à jour en temps réel docs.

Supprimer les dépendances d'App Center

Maintenant que nous avons intégré les services de Capgo, vous devriez supprimer toute référence à App Center. En plus d'être une bonne pratique de supprimer les services inutilisés code/, supprimer SDK devrait réduire la taille de vos applications.

Tout d'abord, ouvrez une invite de commandes puis désinstallez les plugins d'App Center :

    cordova plugin remove cordova-plugin-appcenter-analytics cordova-plugin-appcenter-crashes cordova-plugin-code-push

Ensuite, ouvrez config.xml et supprimez les valeurs suivantes. Elles ressembleront à : preference Si vous utilisiez les Analytics d'App Center dans votre application, supprimez les éléments suivants :

    <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" />

et preferences Supprimez les éléments suivants : APPCENTER_ANALYTICS_ENABLE_IN_JS et APPCENTER_CRASHES_ALWAYS_SEND.

Supprimez les éléments suivants : <access /> Supprimez les éléments 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 le 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 de App Center, comme codePush.sync();.

Étapes suivantes

Vous avez migré d'App Center à 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 services, 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, etc.)

Envoyer automatiquement une mise à jour d'application

Si votre code est hébergé sur GitHub, vous pouvez configurer la mise à jour automatique et la livraison 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 IonicCe texte est basé sur ce texte réécrit avec chat-gpt-3 et adapté.

Migrer depuis App Center vers Capgo