Déployer et exécuter votre application générée à l'aide de Visual Studio Tools for Apache Cordova

Article
06/10/2015

Cet article fait référence à Visual Studio Tools pour Apache Cordova, qui correspond à la version préliminaire du logiciel. Les fonctionnalités décrites sont dans l'aperçu et sont sujettes à modification. Vous pouvez télécharger l'aperçu à partir du Centre de téléchargement Microsoft.

Les articles de cette section fournissent des informations détaillées sur le déploiement de votre application générée avec Visual Studio Tools for Apache Cordova pour des appareils Android, iOS, Windows et Windows Phone. Les informations fournies ici expliquent comment exécuter votre application sur différents simulateurs, émulateurs et appareils.

Afficher la liste des plateformes de solution

Quand vous voulez exécuter votre application Cordova à partir de Visual Studio, vous devez d'abord sélectionner votre plateforme cible. La première fois que vous essayez d'effectuer cette opération après avoirinstallé l'extension de Visual Studio, il peut être nécessaire de rendre visible la liste des plateformes de solution.

Pour sélectionner votre plateforme cible

Dans Visual Studio, choisissez une plateforme dans la liste Plateformes Solution. Dans l'exemple suivant, Android est sélectionné.

Si la liste Plateformes Solution n'est pas visible, cliquez sur Plateformes Solution dans la liste Boutons Ajouter/Supprimer pour l'afficher.

Pour toutes les autres étapes nécessaires pour exécuter votre application, consultez les rubriques spécifiques à chaque plateforme pour Android, iOS, Windows et Windows Phone.

Fonctionnement du processus de génération Cordova dans Visual Studio

L'interface de ligne de commande (CLI) Cordova exécute la plupart des tâches pour Visual Studio quand vous générez et exécutez une application Cordova. Pour faciliter le processus d'installation et de gestion des plug-ins de code natif Cordova, l'interface CLI utilise un autre outil en ligne de commande appelé « plugman ». L'interface CLI nécessite une structure de dossiers spécifique, illustrée ici. Cette structure de dossiers n'est pas actuellement reproduite par Visual Studio.

Structure de projet Cordova dans Visual Studio

Pour exploiter l'interface CLI à partir de la structure de projet Visual Studio, Visual Studio utilise un préprocesseur CLI appelée « vs-mda », qui est un package Node.js (npm). La première fois que vous générez et exécutez un projet généré à l'aide de Visual Studio Tools for Apache Cordova, vs-mda installe Cordova, l'émulateur Ripple et les autres dépendances requises. La fonction de vs-mda est d'accepter une build, de prétraiter le projet Visual Studio, d'exécuter la commande spécifiée du système de génération de l'interface Cordova et d'exécuter (ou émuler) l'application.

Processus de génération Cordova dans Visual Studio

Lors de la génération, Visual Studio copie le projet de l'interface CLI Cordova dans le dossier bld et injecte ses propres hooks personnalisés dans le projet pour activer les fonctionnalités que l'interface CLI ne prend pas en charge. Dans les versions à venir, vs-mda activera des fonctionnalités IDE plus avancées et une structure de projet plus flexible.

Visual Studio automatise le processus d'ajout de plateformes (via la commande cordova platform add), ainsi que l'installation et la désinstallation des plug-ins Cordova (à l'aide de la commande cordova plugin add) en fonction des sélections de l'utilisateur dans Visual Studio. Visual Studio utilise l'interface CLI pour générer pour la plateforme demandée en fonction de la configuration sélectionnée (par exemple, cordova build android debug).

Les projets de plateforme natifs de l'interface CLI et le projet d'interface CLI Cordova lui-même n'étant pas destinés à l'édition, n'ajoutez pas ces projets à votre contrôle de code source. Ils sont mis à jour et modifiés par le processus de génération. Cependant, vous pouvez choisir d'utiliser les projets de plateforme natifs générés pour obtenir une copie exportée du projet.

Voici quelques détails sur le processus de génération et de déploiement en fonction des plateformes.

Android

L'interface CLI prend en charge la génération et l'exécution d'applications Android sous Windows. Pour exécuter l'application sur l'émulateur Android, Visual Studio exécute la commande cordova emulate android de l'interface CLI. Cette commande déploie l'application sur un émulateur déjà en cours d'exécution ou, si aucun n'est disponible, démarre le dernier émulateur créé. Pour exécuter l'application sur un appareil Android connecté, Visual Studio exécute la commande cordova run android de l'interface CLI. Pour configurer votre appareil ou émulateur Android, consultez Exécuter votre application Apache Cordova sur Android.

iOS

Comme il n'est pas possible de générer une application iOS sous Windows, vous devez recourir à un agent distant (vs-mda-remote) pour générer et exécuter votre application sur un ordinateur Mac distant (il peut aussi s'exécuter en local si vous utilisez Visual Studio dans Parallels sur un Mac). Pour générer pour iOS, vs-mda prépare le projet de l'interface CLI exactement de la même façon que pour n'importe quelle autre plateforme, sauf que pour iOS, le contenu est ensuite transféré sur le Mac via vs-mda-remote. L'agent distant décompresse le contenu, ajoute la plateforme iOS (cordova platform add ios), compile l'application iOS (cordova build ios), puis retransfère le package obtenu (IPA) vers l'ordinateur hôte Windows. Pour configurer vs-mda-remote et héberger Visual Studio pour la build iOS, consultez Installer les outils de génération pour iOS.

Pour exécuter des applications sur iOS, Visual Studio génère l'application à l'aide de vs-mda-remote, puis utilise ios-sim pour démarrer le simulateur sur l'ordinateur Mac distant. Si vous effectuez l'exécution sur un appareil iOS relié à votre Mac, vs-mda-remote démarre l'application directement (HomeBrew doit être installé). Si vous exécutez l'application sur un appareil iOS relié à Windows, Visual Studio génère puis ajoute l'application à iTunes pour vous permettre de la déployer sur votre appareil à partir de Windows.

Windows 8 et Windows Phone

Quand il s'agit de générer pour Windows 8, Cordova génère une application Windows Runtime (APPX) pour Windows 8. Dans le cas d'une génération pour Windows Phone 8, il génère une application WebView (XAP) Silverlight. Ces applications sont lancées de la même façon qu'un projet Windows 8 ou Windows Phone 8 natif dans Visual Studio. Pour plus d’informations, consultez Exécuter votre application Apache Cordova sur Windows et Exécuter votre application Apache Cordova sur Windows Phone.

Émulateur Apache Ripple

Pour accélérer autant que possible le processus de génération Ripple, l'opération de génération du code de plug-in nécessaire est assurée par l'interface CLI, mais dans le cas contraire, Visual Studio fournit directement le contenu web (au lieu de fournir le contenu à partir du projet natif généré). Au moment d'exécuter l'application, l'émulateur Ripple est initialisé et Chrome démarre en accédant à une URL Ripple (par exemple, https://localhost:4400/index.html?enableripple=cordova-3.0.0-Nexus7 pour la tablette Nexus7). Tous les paramètres de Chrome sont stockés localement dans votre instance Visual Studio pour éviter de perturber votre navigation. Pour plus d'informations, consultez Exécuter votre application Apache Cordova sur l'émulateur Apache Ripple.