Commandes avancées, paramètres et aide

Utilisez les commandes avancées d'Android Emulator pour envoyer des données, modifier les propriétés de l'appareil, contrôler des applications, etc. Pour ouvrir la fenêtre Extended controls (Commandes avancées), cliquez sur More (Plus) Icône des commandes avancées de l'émulateur dans le panneau de l'émulateur. Notez que certaines de ces options de commandes avancées ne sont disponibles que lorsque vous exécutez l'émulateur dans une fenêtre distincte en dehors d'Android Studio.

Vous pouvez utiliser des raccourcis clavier pour bon nombre de ces tâches. Pour obtenir la liste complète des raccourcis de l'émulateur, appuyez sur F1 (Commande  + / sur macOS) pour ouvrir le volet d'aide.

Tableau 1. Détails des commandes avancées

Fonctionnalité Description
Écrans

L'émulateur vous permet désormais de déployer votre application sur plusieurs écrans qui acceptent des dimensions personnalisables, et peuvent vous aider à tester des applications compatibles avec le mode multifenêtre et le mode multi-écran. Pendant qu'un appareil virtuel est en cours d'exécution, vous pouvez ajouter jusqu'à deux écrans supplémentaires comme suit :

  1. Pour ajouter un écran, cliquez sur Add secondary display (Ajouter un écran secondaire).
  2. Dans le menu figurant sous Secondary displays (Écrans secondaires), effectuez l'une des opérations suivantes :
    1. Sélectionnez l'un des formats prédéfinis.
    2. Sélectionnez custom (personnalisé), puis définissez les valeurs height (hauteur), width (largeur) et dpi de votre écran personnalisé.
  3. (Facultatif) Cliquez sur Add secondary display (Ajouter un écran secondaire) pour en ajouter un troisième.
  4. Cliquez sur Appliquer les modifications pour ajouter les écrans spécifiés à l'appareil virtuel en cours d'exécution.
Connexion cellulaire

L'émulateur vous permet de simuler différentes conditions de réseau. Vous pouvez estimer la vitesse du réseau pour différents protocoles ou spécifier la valeur Full, qui transfère les données aussi rapidement que votre ordinateur le permet. La spécification d'un protocole réseau est toujours plus lente que Full. Vous pouvez également spécifier l'état du réseau vocal et de données, en itinérance par exemple. Les valeurs par défaut sont définies dans l'AVD.

Sélectionnez un Type de réseau.

  • GSM : Global System for Mobile Communications (système mondial de communication mobile)
  • HSCSD : High-Speed Circuit Switched Data (données à commutation de circuits à haut débit)
  • GPRS : Generic Packet Radio Service (service de radio par paquet générique)
  • EDGE : Enhanced Data rates for GSM Evolution (débits de données améliorés pour une évolution du GSM)
  • UMTS : Universal Mobile Telecommunications System (système universel de télécommunications mobiles)
  • HSPDA : High-Speed Downlink Packet Access (accès haut débit par paquets en liaison descendante)
  • LTE : Long-Term Evolution (évolution à long terme)
  • Full (par défaut) : utilise le réseau fourni par votre ordinateur

Sélectionnez l'intensité du signal :

  • Aucun
  • Médiocre
  • Modéré (par défaut)
  • Bon
  • Excellente

Sélectionnez l'État de la voix, l'État des données ou les deux :

  • Accueil (par défaut)
  • Itinérance
  • Recherche
  • Refusé (appels d'urgence uniquement)
  • Non enregistré (désactivé)
Batterie

Vous pouvez simuler les propriétés de la batterie d'un appareil pour voir les performances de votre application dans différentes conditions. Pour sélectionner un niveau de charge, utilisez le curseur.

Sélectionnez une valeur pour la Connexion au chargeur :

  • Aucune
  • Chargeur secteur

Sélectionnez une valeur pour laSanté de la batterie :

  • Bonne (par défaut)
  • Échec
  • Vide
  • Voltage dépassé
  • Surchauffe
  • Inconnue

Sélectionnez une valeur pour l'État de la batterie :

  • Inconnu
  • En charge (par défaut)
  • Baisse du niveau de charge
  • Ne charge pas
  • Pleine
Appareil photo Vous pouvez charger des images dans la scène simulée lorsque vous ouvrez l'appareil photo de l'émulateur. Pour en savoir plus, consultez la section Ajouter des images augmentées à la scène dans la documentation ARCore.
Lieu

L'émulateur vous permet de simuler les informations liées à la fonction "ma position", qui indique l'emplacement de l'appareil émulé. Par exemple, si vous cliquez sur My Location (Ma position) Icône Ma position dans Google Maps, puis que vous envoyez une position, celle-ci s'affichera sur la carte.

Les contrôles de la localisation de l'appareil sont organisés dans deux onglets : Single points (Points uniques) et Routes (Itinéraires).

Points uniques

Dans l'onglet Single points (Points uniques), vous pouvez utiliser la WebView de Google Maps pour rechercher des points d'intérêt, comme lorsque vous utilisez Google Maps sur un téléphone ou dans un navigateur. Lorsque vous recherchez ou cliquez sur un emplacement de la carte, vous pouvez l'enregistrer en sélectionnant Save point (Enregistrer le point) au bas de la carte. Tous vos lieux enregistrés sont indiqués à droite de la fenêtre Extended controls (Commandes avancées).

Pour définir l'emplacement de l'émulateur sur l'emplacement que vous avez sélectionné sur la carte, cliquez sur le bouton Set location (Définir l'emplacement) en bas à droite de la fenêtre Extended controls (Commandes avancées).

Itinéraires

Semblable à l'onglet Points uniques, l'onglet Itinéraires fournit une WebView de Google Maps que vous pouvez utiliser pour créer un itinéraire entre deux lieux ou plus. Pour créer et enregistrer un itinéraire, procédez comme suit :

  1. Dans la vue plan, utilisez le champ de texte pour rechercher la première destination de votre itinéraire.
  2. Sélectionnez le lieu souhaité dans les résultats de recherche.
  3. Sélectionnez le bouton Navigate (Itinéraire) .
  4. Sélectionnez le point de départ de votre itinéraire sur la carte.
  5. (Facultatif) Cliquez sur Ajouter une destination pour ajouter d'autres étapes à votre itinéraire.
  6. Enregistrez votre itinéraire en cliquant sur Save route (Enregistrer l'itinéraire) dans la vue plan.
  7. Attribuez un nom à l'itinéraire, puis cliquez sur Save (Enregistrer).

Pour simuler l'émulateur selon l'itinéraire que vous avez enregistré, sélectionnez l'itinéraire dans la liste Itinéraires enregistrés, puis cliquez sur Lire l'itinéraire en bas à droite de la fenêtre Commandes avancées. Pour arrêter la simulation, cliquez sur Arrêter l'itinéraire.

Pour simuler en continu l'émulateur selon l'itinéraire spécifié, activez le bouton bascule situé à côté de Repeat playback (Répéter la lecture). Pour modifier la vitesse à laquelle l'émulateur suit l'itinéraire spécifié, sélectionnez une option dans le menu déroulant Playback speed (Vitesse de lecture).

Importer des données GPX et KML

Pour utiliser des données géographiques à partir d'un fichier au format d'échange GPS (GPX) ou Keyhole Markup Language (KML), procédez comme suit :

  1. Cliquez sur Charger GPX/KML.
  2. Dans la boîte de dialogue qui s'affiche, sélectionnez un fichier sur votre ordinateur, puis cliquez sur Open (Ouvrir).
  3. (Facultatif) Sélectionnez une Vitesse.
  4. La valeur par défaut est Délai (Vitesse x1). Vous pouvez augmenter par deux la vitesse (Speed 2X), par trois (Speed 3X), et ainsi de suite.

  5. Cliquez sur Run (Exécuter) Icône Exécuter.
Téléphone

L'émulateur vous permet de simuler des appels téléphoniques et des SMS.

Pour appeler l'émulateur :

  1. Sélectionnez ou saisissez un numéro de téléphone dans le champ Expéditeur.
  2. Cliquez sur Call Device (Appeler l'appareil).
  3. Vous pouvez également cliquer sur Hold Call (Mettre l'appel en attente) si nécessaire.
  4. Pour mettre fin à l'appel, cliquez sur End Call (Raccrocher).

Pour envoyer un SMS à l'émulateur :

  1. Sélectionnez ou saisissez un numéro de téléphone dans le champ Expéditeur.
  2. Saisissez un message dans le champ Message SMS.
  3. Cliquez sur Envoyer un message.
Pavé directionnel

Si le pavé directionnel est activé dans le profil matériel de l'AVD, vous pouvez utiliser les commandes du pavé directionnel avec l'émulateur. Cependant, tous les appareils, tels que les montres Android, ne sont pas compatibles avec le pavé directionnel. Ces boutons simulent les actions suivantes :

Commandes du pavé directionnel
Micro Lorsque le micro virtuel utilise l'entrée audio de l'hôte, l'émulateur reçoit l'entrée audio de la part du micro hôte. Sinon, l'émulateur ne reçoit aucune entrée audio. Les options Prise du casque virtuel insérée, Casque virtuel avec micro et Assistance vocale ne sont actuellement pas implémentées.
Empreinte digitale

Cette commande peut simuler 10 analyses d'empreinte digitale différentes. Vous pouvez l'utiliser pour tester l'intégration des empreintes digitales dans votre application. Cette fonctionnalité est désactivée pour Android 5.1 (niveau d'API 22) et versions antérieures, ainsi que pour Wear OS.

Pour simuler une analyse d'empreinte digitale sur l'appareil virtuel :

  1. Préparez une application prête à recevoir une empreinte digitale.
  2. Sélectionnez une valeur pour Empreinte digitale.
  3. Cliquez sur Capteur tactile.
Capteurs virtuels > Posture de l'appareil

Cette commande vous permet de tester votre application par rapport aux changements de posture et/ou d'orientation de l'appareil. Par exemple, vous pouvez simuler des gestes tels que l'inclinaison et la rotation. L'accéléromètre ne suit pas la position absolue de l'appareil mais détecte seulement si un changement est en cours. Cette commande simule la réaction des capteurs de l'accéléromètre et du magnétomètre lorsque vous déplacez ou faites pivoter un appareil réel.

Vous devez activer le capteur de l'accéléromètre dans votre AVD pour utiliser cette commande.

La commande signale des évènements TYPE_ACCELEROMETER sur les axes x, y et z. Ces valeurs incluent la gravité. Par exemple, si l'appareil se trouve dans l'espace intersidéral, l'accélération est nulle (toutes les valeurs x, y et z sont nulles). Lorsque l'appareil est sur Terre et qu'il est posé sur une table, l'accélération est de 0, 0 et 9,8 en raison de la gravité.

La commande signale également les événements TYPE_MAGNETIC_FIELD, qui mesurent le champ magnétique ambiant sur les axes x, y et z en microteslas (μT).

Pour faire pivoter l'appareil autour des axes x, y et z, sélectionnez Rotate (Faire pivoter), puis effectuez l'une des opérations suivantes :

  • Ajustez les curseurs de Lacet, de tangage et de roulis, puis observez la position dans le volet supérieur.
  • Déplacez la représentation de l'appareil dans le volet supérieur et observez le changement des valeurs de lacet, de tangage, de roulis et la valeur des accéléromètres obtenus.

Consultez la section Calculer l'orientation de l'appareil pour en savoir plus sur le calcul du lacet, du tangage et du roulis.

Pour déplacer l'appareil horizontalement (x) ou verticalement (y), sélectionnez Move (Déplacer) et effectuez l'une des opérations suivantes :

  • Ajustez les curseurs X et Y et observez la position dans le volet supérieur.
  • Déplacez la représentation de l'appareil dans le volet supérieur, et observez les changements de valeurs du curseur X et Y et de l'accéléromètre.

Pour positionner l'appareil à 0, 90, 180 ou 270 degrés, procédez comme suit :

  • Dans la zone Device rotation (Rotation de l'appareil), sélectionnez un bouton pour modifier la rotation.

À mesure que vous ajustez l'appareil, les champs Valeurs générées changent en conséquence. Il s'agit des valeurs auxquelles une application peut accéder.

Pour en savoir plus sur ces capteurs, consultez les pages Présentation des capteurs, Capteurs de mouvement et Capteurs de position.

Capteurs virtuels > Capteurs supplémentaires

L'émulateur peut simuler divers capteurs de position et d'environnement. Il vous permet d'ajuster les capteurs suivants afin de les tester avec votre application :

  • Ambient temperature (Température ambiante) : ce capteur d'environnement mesure la température de l'air ambiant.
  • Magnetic field (Champ magnétique) : ce capteur de position mesure le champ magnétique ambiant sur les axes X, Y et Z, respectivement. Les valeurs sont exprimées en microteslas (μT).
  • Proximity (Proximité) : ce capteur de position mesure la distance par rapport à un objet. Il peut, par exemple, signaler à un téléphone qu'un visage est proche de lui pour passer un appel. Pour pouvoir utiliser cette commande, vous devez activer le capteur de proximité dans votre AVD.
  • Lumière : ce capteur d'environnement mesure l'éclairage. Les valeurs sont exprimées en Lux.
  • Pression : ce capteur d'environnement mesure la pression de l'air ambiant. Les valeurs sont exprimées en millibar (hPa).
  • Relative Humidity (Humidité relative) : ce capteur d'environnement mesure l'humidité relative ambiante.

Pour en savoir plus sur ces capteurs, consultez les sections Présentation des capteurs, Capteurs de position et Capteurs d'environnement.

Rapport de bug Si vous rencontrez des problèmes avec l'émulateur, vous pouvez préparer et envoyer un rapport de bug. L'émulateur collecte automatiquement les captures d'écran, les journaux et d'autres données pour le rapport de bug.
Enregistrement et lecture Consultez la section Enregistrement de l'écran.
Google Play Lorsque l'image système de l'AVD inclut l'application Play Store, les informations sur la version des services Google Play s'affichent.
Settings > General (Paramètres > Général)
  • Emulator window theme (Thème de la fenêtre de l'émulateur) : sélectionnez Light (Clair) ou Dark (Sombre).
  • Send keyboard shortcuts to (Envoyer des raccourcis clavier à) : par défaut, certaines combinaisons de touches déclenchent des raccourcis de contrôle de l'émulateur. Si vous développez une application qui inclut des raccourcis clavier, tels qu'un raccourci vers les appareils dotés d'un clavier Bluetooth, vous pouvez modifier ce paramètre pour envoyer toutes les saisies au clavier appareil virtuel, y compris une saisie qui constituerait un raccourci dans l'émulateur.
  • Screenshot save location (Emplacement d'enregistrement de la capture d'écran) : cliquez sur l'icône de dossier pour spécifier un emplacement et enregistrer les captures d'écran de l'écran de l'émulateur.
  • Use detected ADB location (Utiliser l'emplacement ADB détecté) : si vous exécutez l'émulateur à partir d'Android Studio, vous devez sélectionner ce paramètre (par défaut). Si vous exécutez l'émulateur en dehors d'Android Studio et que vous souhaitez qu'il utilise un exécutable adb spécifique, désélectionnez cette option et spécifiez l'emplacement de SDK Tools. Si ce paramètre est incorrect, certaines fonctionnalités, telles que la capture d'écran et l'installation d'une application par glisser-déposer, ne fonctionneront pas.
  • Quand envoyer les rapports d'erreur: sélectionnez Toujours, Jamais ou Demander.
  • Afficher le frame de fenêtre autour de l'appareil : par défaut, les émulateurs contenant des fichiers d'habillage d'appareil sont affichés sans frame de fenêtre.
Settings > Proxy (Paramètres > Proxy)

Par défaut, l'émulateur utilise les paramètres de proxy HTTP d'Android Studio. Cet écran vous permet de définir manuellement une configuration de proxy HTTP pour l'émulateur. Pour en savoir plus, consultez la section Utiliser l'émulateur avec un proxy.

Settings > Advanced (Paramètres > Paramètres avancés)
  • OpenGL ES renderer (Moteur de rendu OpenGL ES) : sélectionnez le type d'accélération graphique. (Cela équivaut à l'option de ligne de commande -gpu.)
    • Autodetect based on host (Détection automatique basée sur l'hôte) : laissez l'émulateur choisir l'accélération graphique matérielle ou logicielle en fonction de la configuration de votre ordinateur. Il vérifie si votre pilote de GPU correspond à une liste de pilotes de GPU défectueux. Si c'est le cas, l'émulateur désactive l'émulation matérielle des graphismes et utilise à la place le processeur.
    • ANGLE : (Windows uniquement.) Utilisez ANGLE Direct3D pour effectuer un rendu des graphismes dans des logiciels.
    • SwiftShader : utilisez SwiftShader pour effectuer un rendu des graphismes dans des logiciels.
    • OpenGL natif sur ordinateur : utilisez le GPU sur votre ordinateur hôte. Cette option est généralement la plus rapide. Toutefois, certains pilotes ne parviennent pas à afficher correctement les éléments graphiques d'OpenGL. Ce n'est donc pas systématiquement l'option la plus fiable.
  • Niveau d'API OpenGL ES : sélectionnez la version maximale d'OpenGL ES à utiliser dans l'émulateur.
    • Sélection automatique : laisse l'émulateur choisir la version d'OpenGL ES en fonction de l'hôte et de la compatibilité avec les invités.
    • Nombre maximal de moteurs de rendu (jusqu'à OpenGL ES 3.1) : essaye d'utiliser la version maximale d'OpenGL ES.
    • Compatibilité (OpenGL ES 1.1/2.0) : utilise la version d'OpenGL ES compatible avec la plupart des environnements.
Aide > Raccourcis clavier

Ce volet fournit la liste complète des raccourcis clavier de l'émulateur. Pour ouvrir ce volet lorsque vous travaillez dans l'émulateur, appuyez sur F1 (Commande + / sur macOS).

Pour que les raccourcis fonctionnent, l'option Send keyboard shortcuts (Envoyer des raccourcis clavier) du volet des paramètres General (Général) doit être définie sur Emulator controls (default) (Commandes de l'émulateur (valeur par défaut)).

Aide > Aide de l'émulateur

Pour accéder à la documentation en ligne de l'émulateur, cliquez sur Documentation.

Pour signaler un bug lié à l'émulateur, cliquez sur Send feedback (Envoyer des commentaires). Pour en savoir plus, découvrez comment signaler des bugs dans l'émulateur.

Help > About (Aide > À propos)

Vérifiez le port adb utilisé par l'émulateur, ainsi que les numéros de version d'Android et de l'émulateur. Comparez la dernière version de l'émulateur disponible avec votre version pour déterminer si vous disposez de la dernière version du logiciel.

Le numéro de série de l'émulateur est emulator-adb_port, que vous pouvez spécifier, par exemple, en tant qu'option de ligne de commande adb.