Migrer une application web à l'aide de Cordova vers Capacitor: Guide étape par étape
Ce guide vous aidera à migrer votre application web de Cordova vers Capacitor, ce qui facilitera la lecture et la compréhension. Nous couvrirons toutes les sections et proposerons une approche étape par étape.
Introduction à Cordova et Capacitor
Cordova et Capacitor sont tous deux des outils qui permettent aux développeurs web de créer des applications natives pour diverses plateformes à l'aide de HTML, CSS et JavaScript. Bien qu'ils partagent des similitudes, il existe des différences clés dans leur approche de la gestion de projet native, de la gestion de plugin et de la gestion de CLI/version.
Stratégie de migration
Migrer de Cordova vers Capacitor peut être fait progressivement ou en tant que remplacement complet, en fonction de la complexité de votre application. Capacitor est compatible avec Cordova, ce qui vous permet de passer vos applications web existantes à Capacitor dès que vous êtes prêt.
Pour aider à la migration, envisagez d'utiliser le Extension Ionic VS Code et de faire l'inventaire de vos plugins Cordova existants. Vous pouvez continuer à utiliser les plugins Cordova si nécessaire, ou les remplacer par des équivalents Capacitor.
Guide de Migration Étape par Étape
Suivez ces étapes pour migrer votre application web de Cordova vers Capacitor
-
Travaillez dans une branche code séparée: Il est recommandé de travailler dans une branche code séparée lors de l'application de ces modifications.
-
Initialisez votre application avec Capacitor: Ouvrez votre projet dans le terminal et suivez les guides pour l'ajout de Capacitor à une application web ou l'ajout de Capacitor à une application Ionic. Utilisez les informations de votre fichier Cordova
config.xmlpour le nom de l'application et l'ID de Bundle. -
Construisez votre application web: Créez votre projet web au moins une fois avant d'ajouter n'importe quelles plateformes natives. Cela s'assure que le dossier est correctement configuré dans le fichier de configuration __CAPGO_KEEP_0__.
wwwfolder is properly configured in the Capacitor configuration file. -
: Exécutezet
npx cap add iospour ajouter les plateformes iOS et Android. Ces dernières créeront des dossiers de projet natives séparés à la racine de votre projet.npx cap add androidGénérez des icônes et des écrans de splash -
: Si vous disposez d'images d'icônes et d'écrans de splash existantes, utilisez l'outil pour les générer et les copier dans les projets natives.Auditez et migrez les plugins Cordova existants
cordova-res: Vérifiez vos plugins Cordova existants et remplacez-les par des équivalents __CAPGO_KEEP_0__ si possible. Supprimez tout plugin inutile. -
Supprimez le plugin Cordova: Review your existing Cordova plugins and replace them with Capacitor equivalents if possible. Remove any unnecessary plugins.
-
targetLanguage: Après avoir remplacé ou supprimé un plugin Cordova, désinstallez le plugin et exécutez
npx cap syncpour supprimer le plugin code du projet natif. -
Appliquer des permissions supplémentaires: Cartographie entre
plugin.xmlet les paramètres requis sur iOS et Android pour appliquer les permissions nécessaires. -
Configurer les préférences: Ajoutez manuellement des préférences de
config.xmlau fichier de configuration Capacitor. -
Gérer les configurations spécifiques aux plateformes: Configurez les éléments de
config.xmlpour chaque plateforme (iOS et Android) si nécessaire. -
Changer le schéma pour servir le contenu: Si nécessaire, modifiez le schéma utilisé pour servir le contenu dans votre application pour éviter toute perte de données.
-
Testez et supprimez Cordova: Testez votre application migrée pour vous assurer que toutes les modifications ont été appliquées correctement. Une fois satisfait, vous pouvez supprimer Cordova de votre projet ou le conserver si vous prévoyez continuer à utiliser les plugins Cordova.
Félicitations ! Vous avez réussi à migrer votre application web de Cordova vers Capacitor. Pour en savoir plus sur l'utilisation des plugins Cordova dans un projet Capacitor ou le flux de développement Capacitor, visitez la documentation officielle de Capacitor.
Mises à jour en temps réel avec notre service Capgo
On se félicite de proposer Capgo, notre solution qui permet des mises à jour en temps réel pour vos applications Capacitor, vous permettant de livrer des mises à jour hors-ligne (OTA) à un prix équitable. Cette fonctionnalité est particulièrement utile pour faire des corrections rapides, déployer de nouvelles fonctionnalités et vous assurer que vos utilisateurs disposent toujours de la dernière version de votre application sans attendre l'approbation des magasins d'applications.
Comment notre service Capgo fonctionne
Capgo est un service basé sur le cloud qui vous permet de déployer des mises à jour en temps réel pour vos applications Capacitor. Il se compose d'un tableau de bord web et d'une application native SDK que vous pouvez intégrer dans votre application. Le SDK vérifie les mises à jour au démarrage ou à des intervalles spécifiques et les télécharge en arrière-plan. Lorsqu'une mise à jour est disponible, l'application SDK sollicitera l'utilisateur pour l'installer. Si l'utilisateur accepte, la mise à jour sera installée et appliquée immédiatement.
Avantages des mises à jour en temps réel Capgo
- Actualisations rapides : Deployez des mises à jour instantanément sans attendre l'approbation des magasins d'applications.
- Réduire la dépendance de l'Apple Store : Surcharger les restrictions et les limitations de l'app store.
- Améliorer l'expérience utilisateur : Tenir les utilisateurs engagés avec les dernières fonctionnalités et les correctifs de bogues sans leur faire manuellement mettre à jour l'application.
Comment mettre en œuvre les mises à jour en temps réel Capgo
Pour mettre en œuvre les mises à jour en temps réel Capgo dans votre projet Capacitor, suivez ces étapes :
- Inscrivez-vous à un compte Capgo.
- Installer le Capgo SDK dans votre projet.
- Configurer votre application pour vérifier les mises à jour au démarrage ou à des intervalles spécifiques.
- Déployer les mises à jour de votre application à l'aide de la console de gestion Capgo.
Conclusion
Nous espérons que ce guide vous a aidé à migrer votre application web à partir de Cordova vers Capacitor. Si vous avez des questions ou avez besoin d'aide pour le processus de migration, n'hésitez pas à nous contacter sur notre serveur de Discord. Rédigé par