Partager via

Exécuter votre application Apache Cordova sur Android

  • Article

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.

Il existe de nombreuses options pour exécuter vos applications générées à l'aide de Visual Studio Tools for Apache Cordova sur Android. À partir de Visual Studio, vous pouvez exécuter et déboguer des applications Android sur les appareils et émulateurs suivants :

  • Émulateur Apache Ripple (présenté dans un article distinct)

  • Émulateur Android

  • Émulateur Genymotion

  • Appareil Android

Configurer un émulateur à hautes performances

Si vous avez un PC avec un processeur Intel, vous pouvez améliorer les performances des émulateurs Android et Genymotion. Pour configurer un émulateur à hautes performances :

  1. Désactivez Hyper-V. Vous pouvez faire cela à partir du Panneau de configuration ou d'une ligne de commande, comme décrit dans les procédures suivantes.

    Avertissement

    La désactivation d'Hyper-V vous empêchera d'utiliser l'émulateur Windows Phone.Vous pouvez néanmoins encore déployer sur un appareil Windows Phone si Hyper-V est désactivé.

  2. (Émulateur Android uniquement) Installez le pilote Intel HAXM (Hardware Accelerated Execution Manager) à hautes performances, s'il n'est pas déjà installé. (Plus d'informations sur le pilote HAXM)

  3. Configurez l'émulateur Android pour utiliser l'accélération matérielle.

Pour désactiver Hyper-V dans le Panneau de configuration

  1. Dans le Panneau de configuration, choisissez Programmes et fonctionnalités, puis choisissez Activer ou désactiver des fonctionnalités Windows.

  2. Décochez la case pour Hyper-V.

    Désactivation d'Hyper-V

  3. Redémarrez votre PC.

    Vous pouvez maintenant installer le pilote HAXM.

Vous pouvez également configurer Windows à l'aide de la ligne de commande pour qu'il démarre avec Hyper-V automatiquement activé ou désactivé.

Pour désactiver Hyper-V à l'aide de la ligne de commande

  1. Ouvrez une invite de commandes avec élévation de privilèges (avec des informations d'identification d'administration) et tapez :

    bcdedit /set hypervisorlaunchtype off

    Avertissement

    Les commandes bcdedit peuvent empêcher votre système de démarrer si elles ne sont pas exécutées correctement. Soyez prudent lors de l'utilisation de ces commandes.

    Si vous ajoutez cette commande à un script de shell, utilisez ceci à la place :

    bcdedit /set hypervisorlaunchtype off
shutdown /r

  2. Redémarrez votre PC.

    Si vous voulez réactiver Hyper-V ultérieurement, utilisez la commande suivante, puis redémarrez votre PC :

    bcdedit /set hypervisorlaunchtype auto

Si vous utilisez l'émulateur Genymotion, vous pouvez ignorer cette procédure. Pour plus d'informations, voir Émulateur Genymotion.

Pour installer le pilote HAXM à hautes performances (émulateur Android uniquement)

  1. Après la désactivation d'Hyper-V et le redémarrage, ouvrez le Gestionnaire de Kit de développement logiciel (SDK) Android. Pour faire cela à partir d'une ligne de commande, accédez à l'emplacement du Kit de développement logiciel (SDK) et tapez android.

    Sur Windows, le Kit de développement logiciel (SDK) Android Manager.exe est installé dans l'emplacement suivant : C:\Program Files (x86)\Android\android-sdk.

  2. Dans le Gestionnaire de Kit de développement logiciel (SDK) Android, recherchez l'accélérateur d'émulateur Intel x86 (HAXM Installer) sous Extras. Si la colonne d'état indique qu'il n'est pas installé, cochez sa case, puis choisissez Installer des packages.

    Installation du pilote HAXM

  3. Installez le pilote en accédant à chemin-sdk\extras\intel\Hardware_Accelerated_Execution_Manager et en exécutant intelhaxm.exe.

    Conseil

    Si la partie « intel » du chemin d'accès n'est pas présente, c'est que le pilote n'a pas été installé.

    Vous pouvez maintenant configurer un émulateur pour qu'il utilise le pilote. Quand vous créez ou que vous modifiez un émulateur, vous devez utiliser un processeur Intel et sélectionner l'option Utiliser le GPU de l'hôte. Pour plus d'informations, consultez la section suivante.

Émulateur Android

Avant d'exécuter votre application sur l'émulateur Android dans Visual Studio, utilisez le Gestionnaire AVD (Android Virtual Device) pour créer une configuration d'émulateur, puis lancez l'émulateur depuis le Gestionnaire AVD. Les étapes suivantes montrent comment procéder. Pour plus d'informations, consultez la documentation du Gestionnaire AVD.

Pour créer une instance de l'émulateur

  1. Ouvrez le Gestionnaire AVD. Pour faire cela à partir d'une ligne de commande, accédez à l'emplacement du Kit de développement logiciel (SDK) et tapez android avd.

    Sur Windows, le Gestionnaire AVD Manager.exe est installé dans l'emplacement suivant : C:\Program Files (x86)\Android\android-sdk.

  2. Dans le Gestionnaire AVD, choisissez Nouveau.

  3. Configurez les propriétés du nouvel émulateur.

    Les propriétés requises sont AVD Name, Device, Target, CPU/ABI et Skin. Target représente une version installée de la version d'Android SDK (jeu d'API). Définissez cette propriété à API Level 19.

    Création d'un émulateur Android

  4. Si vous avez installé le pilote HAXM à hautes performances dans la section précédente et que vous avez choisi un processeur Intel, cochez la case Utiliser le GPU de l'hôte dans Options d'émulation.

    Important

    Pour utiliser l'émulateur à hautes performances, vous devez également choisir un processeur Intel dans la section CPU/ABI de la boîte de dialogue AVD.

  5. Choisissez OK pour fermer la boîte de dialogue de configuration, puis choisissez à nouveau OK dans la boîte de dialogue qui affiche tous les paramètres de l'émulateur.

  6. Dans le Gestionnaire AVD, sélectionnez le nouvel émulateur, puis choisissez Démarrer.

Pour exécuter l'application sur l'émulateur

  1. Après avoir ouvert votre application dans Visual Studio, choisissez Android dans la liste Plateformes Solution. Si cette option n'est pas répertoriée, choisissez Plateformes Solution dans la liste Ajouter/supprimer des boutons.

  2. Dans la liste des appareils, choisissez Émulateur Android.

    Déploiement sur l'émulateur Android

  3. Appuyez sur F5 pour démarrer l'application, ou sur Maj+F5 pour démarrer l'application sans débogage.

    Android 4.4 est requis pour attacher le débogueur. Sinon, l'application s'exécutera sans débogage.

    Conseil

    • Si vous obtenez une erreur indiquant que vous devez installer une nouvelle version du Kit de développement logiciel (SDK) Android, utilisez le Gestionnaire de SDK Android pour l'installer.Sur Windows, le Kit de développement logiciel (SDK) Manager.exe est installé dans C:\Program Files (x86)\Android\android-sdk.

    • Visual Studio déploie l'application sur l'émulateur Android qui est en cours d'exécution.Si aucun émulateur n'est en cours d'exécution, Visual Studio démarre le dernier l'émulateur qui a été créé avec le Gestionnaire AVD, puis déploie l'application.

    • Si vous voulez déboguer votre application avec les versions d'Android 4.1.2 à 4.3, consultez les informations sur le plug-in jsHybugger dans l'article Déboguer votre application générée à l'aide de Visual Studio Tools for Apache Cordova.

Émulateur Genymotion

L'émulateur Genymotion est une alternative bien connue à l'émulateur Android qui est inclus avec le SDK Android. Voici quelques conseils pour se familiariser avec l'émulateur :

  • Si vous avez des difficultés à démarrer l'émulateur à partir d'une connexion à distance, essayez de le démarrer localement, puis reconnectez-vous à distance si nécessaire. L'émulateur requiert OpenGL pour l'affichage. Ceci peut entraîner un conflit lors du démarrage de l'émulateur.

  • Vous avez besoin d'une carte vidéo et de pilotes de carte vidéo prenant en charge OpenGL. Vous êtes susceptible de recevoir des messages qui vous l'indiquent. (Si vous vous connectez à distance à votre PC, vous êtes également susceptible de voir ce message. Réessayez après vous être connecté localement.)

  • Vous êtes susceptible de recevoir un message vous demandant de vérifier votre configuration réseau VirtualBox quand vous tentez de démarrer l'émulateur. Suivez le lien et les instructions pour modifier ou supprimer la carte réseau hôte uniquement (« Host-only Network Adapter ») de VirtualBox. (VirtualBox est inclus avec l'installation de l'émulateur.)

  • Pour l'émulation à hautes performances avec Genymotion, désactivez Hyper-V avant de démarrer l'émulateur, comme décrit précédemment dans Configurer un émulateur à hautes performances.

Les outils de développement Android voient Genymotion sous la forme d'un appareil physique. Quand vous utilisez Visual Studio pour exécuter l'application, vous indiquez à Visual Studio de déployer sur un appareil Android.

Pour exécuter votre application sur l'émulateur Genymotion

  1. Démarrez l'émulateur Genymotion.

  2. Après avoir ouvert votre application dans Visual Studio, choisissez Android dans la liste Plateformes Solution. Si cette option n'est pas répertoriée, choisissez Plateformes Solution dans la liste Ajouter/supprimer des boutons.

  3. Dans la liste des appareils, choisissez Appareil.

    Déploiement sur un appareil Android

  4. Appuyez sur F5 pour démarrer l'application, ou sur Maj+F5 pour démarrer l'application sans débogage.

Appareils Android

Avant de pouvoir utiliser Visual Studio pour exécuter votre application sur un appareil Android connecté, vous devez installer le pilote requis :

Vous devez également vous assurer que votre appareil est en mode développeur. Pour des instructions, consultez « Enabling On-device Developer Options » et « Setting up a Device for Development » dans la page Using Hardware Devices sur le site web Android.

Pour déployer une configuration Release ou Distribution de votre application, vous devez d'abord signer votre application. Pour plus d'informations, consultez Créer un package pour votre application générée à l'aide de Visual Studio Tools for Apache Cordova.

Pour exécuter votre application sur un appareil Android

  1. Assurez-vous que vous avez installé le pilote OEM ou USB Google requis.

  2. Assurez-vous que votre appareil Android est en mode développeur (voir Using Hardware Devices sur le site web Android).

  3. Après avoir ouvert votre application dans Visual Studio, choisissez Android dans la liste Plateformes Solution. Si cette option n'est pas répertoriée, choisissez Plateformes Solution dans la liste Ajouter/supprimer des boutons.

  4. Dans la liste des appareils, choisissez Appareil.

    Déploiement sur un appareil Android

  5. Appuyez sur F5 pour démarrer l'application, ou sur Maj+F5 pour démarrer l'application sans débogage.

  6. Lorsque vous y êtes invité, choisissez Autoriser le débogage USB.

Voir aussi

Concepts

Installer Visual Studio Tools for Apache Cordova

Déboguer votre application générée à l'aide de Visual Studio Tools for Apache Cordova

Créer un package pour votre application générée à l'aide de Visual Studio Tools for Apache Cordova

Autres ressources

FAQ