Utilisation avancée de l'émulateur

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Vous pouvez être amené à tester votre application sur un appareil virtuel en utilisant bien plus que les gestes et les mouvements de base de l'écran tactile, par exemple si vous souhaitez simuler différentes zones géographiques ou conditions de réseau. Cette page présente les fonctionnalités avancées de l'émulateur et les différentes façons de le lancer avec Android Studio.

Les autres pages de cette section présentent des utilisations encore plus avancées de l'émulateur, qui nécessitent de recourir au terminal. Voici les cas d'utilisation dont il est question :

Pour la plupart des développeurs d'applications, les fonctionnalités de navigation de base de l'émulateur et les fonctionnalités présentées sur cette page devraient répondre à vos besoins en termes de tests. Pour une comparaison côte à côte de ce que vous pouvez faire avec l'émulateur en fonction de votre interaction avec lui, consultez le comparatif des fonctionnalités de l'émulateur.

Captures d'écran

Pour effectuer une capture d'écran de l'appareil virtuel, cliquez sur le bouton Take screenshot (Effectuer une capture d'écran) Icône Capture d'écran.

Dans la boîte de dialogue Screen Capture (Capture d'écran) qui s'affiche, vous pouvez modifier l'image capturée, la copier ou créer une autre capture d'écran. Une fois que vous êtes satisfait de l'image, cliquez sur Save (Enregistrer). L'émulateur crée un fichier PNG nommé Screenshot_yyyymmdd-hhmmss.png en utilisant l'année, le mois, le jour, l'heure, la minute et la seconde de la capture. Vous pouvez en modifier le nom si vous le souhaitez et choisir l'emplacement d'enregistrement du fichier.

Vous pouvez également effectuer des captures d'écran à partir de la ligne de commande à l'aide de l'une des commandes suivantes :

  • screenrecord screenshot [destination-directory]
  • adb emu screenrecord screenshot [destination-directory]

Enregistrement de l'écran

Vous pouvez enregistrer des vidéos et des fichiers audio à partir de l'Android Emulator et le sauvegarder dans un fichier WebM ou GIF animé.

Les commandes d'enregistrement d'écran se trouvent dans l'onglet Record and Playback (Enregistrement et lecture) de la fenêtre Extended Controls (Commandes avancées).

Conseil : Pour ouvrir les commandes d'enregistrement d'écran, appuyez sur Ctrl+Maj+R (Cmd+Maj+R sous macOS).

Pour commencer l'enregistrement de l'écran, cliquez sur le bouton Start recording (Démarrer l'enregistrement) dans l'onglet Record and Playback (Enregistrement et lecture). Pour arrêter l'enregistrement, cliquez sur Stop recording (Arrêter l'enregistrement).

Les commandes permettant de lire et sauvegarder la vidéo enregistrée se trouvent en bas de l'onglet Enregistrement et lecture. Pour enregistrer la vidéo, sélectionnez WebM ou GIF dans le menu situé en bas de l'onglet, puis cliquez sur Enregistrer.

Vous pouvez également enregistrer et sauvegarder un enregistrement d'écran à partir de l'émulateur à l'aide de la commande suivante dans la ligne de commande :

adb emu screenrecord start --time-limit 10 [path to save video]/sample_video.webm

Compatibilité avec les appareils photo

L'émulateur prend en charge les fonctionnalités de base de l'appareil photo de votre appareil virtuel pour les versions antérieures d'Android. Android 11 et versions ultérieures sont compatibles avec les fonctionnalités supplémentaires suivantes de l'appareil photo Android Emulator :

  • Capture RAW
  • Retraitement YUV
  • Appareils de niveau 3
  • Compatibilité avec les appareils photo logiques
  • Émulation de l'orientation du capteur à l'aide des données du gestionnaire de capteurs
  • Application de la stabilisation de la vidéo en réduisant la fréquence des handshakes
  • Application de l'amélioration des bordures en supprimant l'upscaling effectué normalement dans le pipeline YUV
  • Caméras simultanées

Caméra de scène virtuelle et ARCore

Vous pouvez utiliser la caméra de scène virtuelle dans un environnement virtuel pour tester des applications de réalité augmentée (RA) créées avec ARCore.

Pour plus d'informations sur l'utilisation de la caméra de scène virtuelle dans l'émulateur, consultez Exécuter des applications de RA dans Android Emulator.

Lorsque vous utilisez l'émulateur avec une application d'appareil photo, vous pouvez importer une image au format PNG ou JPEG pour l'utiliser dans une scène virtuelle. Pour choisir une image à utiliser dans une scène virtuelle, ouvrez Extended controls (Commandes avancées), sélectionnez l'onglet Camera > Virtual scene images (Appareil photo > Images de la scène virtuelle), puis cliquez surAdd image (Ajouter une image). Cette fonctionnalité peut être utilisée pour importer des images personnalisées telles que des codes QR à utiliser avec n'importe quelle application basée sur l'appareil photo. Pour en savoir plus, consultez la page Ajouter des images augmentées à la scène.

Tester des actions de RA courantes à l'aide de macros

Vous pouvez réduire considérablement le temps nécessaire pour tester les actions de RA courantes à l'aide des macros prédéfinies de l'émulateur. Par exemple, vous pouvez utiliser une macro pour rétablir l'état par défaut de tous les capteurs de l'appareil.

Avant d'utiliser des macros, suivez les étapes de la section Exécuter des applications de RA dans Android Emulator afin de configurer la caméra de scène virtuelle pour votre application, exécutez votre application sur l'émulateur et mettez à jour ARCore. Pour utiliser des macros d'émulateur, procédez comme suit :

  1. Une fois l'émulateur exécuté et votre application connectée à ARCore, cliquez sur More (Plus) dans le panneau de l'émulateur.
  2. Sélectionnez Record and Playback > Macro Playback (Enregistrement et lecture > Lecture des macros).
  3. Choisissez une macro à utiliser, puis cliquez sur Lire.

    Pendant la lecture, vous pouvez interrompre une macro en cliquant sur Arrêter.

Lancer l'émulateur dans une fenêtre distincte

Android Emulator s'exécute dans Android Studio par défaut. Vous pouvez ainsi utiliser efficacement l'espace de l'écran, naviguer rapidement entre l'émulateur et la fenêtre de l'éditeur à l'aide des touches de raccourci, et organiser le workflow de votre IDE et de votre émulateur dans une même fenêtre d'application.

Cependant, certaines fonctionnalités de l'émulateur ne sont disponibles que lorsque vous l'exécutez dans une fenêtre distincte. Pour lancer l'émulateur dans une fenêtre distincte, accédez à File > Settings > Tools > Emulator (Fichier > Paramètres > Outils > Émulateur) ou à Android Studio > Preferences > Tools > Emulator (Android Studio > Préférences > Outils > Émulateur) sous macOS. Ensuite, désélectionnez Launch in a tool window (Lancer dans une fenêtre d'outil).

Commandes avancées, paramètres et aide

Utilisez les commandes avancées pour envoyer des données, modifier les propriétés de l'appareil, contrôler les applications et plus encore. 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
Position

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 la position 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 contols (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 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 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.
É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 déroulant 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 Apply changes (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
  • Excellent

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.
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.
  • When to send crash reports (Quand envoyer les rapports d'erreur) : sélectionnez Always (Toujours), Never (Jamais) ou Ask (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.

Lancer l'émulateur sans lancer d'application

Vous aurez parfois besoin de lancer l'émulateur sans exécuter d'application, par exemple si vous souhaitez simplement voir comment deux appareils d'émulateur interagissent entre eux lorsqu'ils sont associés via le Bluetooth. Pour lancer l'émulateur sans lancer d'application, procédez comme suit :

  1. Ouvrez le Gestionnaire d'appareils.
  2. Double-cliquez sur un AVD ou sélectionnez-en un, puis cliquez sur Run (Exécuter) . L'émulateur Android se charge.

Pendant l'exécution de l'émulateur, vous pouvez exécuter des projets Android Studio et choisir l'émulateur comme appareil cible. Vous pouvez également installer un ou plusieurs APK sur l'émulateur (comme décrit dans la section suivante), puis les exécuter.

Installer et ajouter des fichiers

Si vous souhaitez utiliser une application qui n'est pas disponible sur le Google Play Store dans l'émulateur, vous pouvez installer manuellement le fichier APK. Pour installer un fichier APK sur l'appareil d'émulation, faites glisser le fichier approprié vers l'écran de l'émulateur. Une boîte de dialogue du programme d'installation APK s'affiche. Une fois l'installation terminée, vous pouvez voir l'application dans votre liste d'applications.

Pour ajouter un fichier à l'appareil émulé, faites-le glisser sur l'écran de l'émulateur. Le fichier est placé dans le répertoire /sdcard/Download/. Vous pouvez afficher le fichier depuis Android Studio à l'aide de l'explorateur de fichiers de l'appareil ou en le recherchant à partir des applications Downloads (Téléchargements) ou Files (Fichiers), selon la version de l'appareil.

Instantanés

Un instantané est l'image stockée d'un AVD. Il conserve l'intégralité de l'état de l'appareil au moment où il a été enregistré, y compris les paramètres du système d'exploitation, l'état de l'application et les données utilisateur. Pour revenir à l'état enregistré du système, vous pouvez charger un instantané quand vous le souhaitez. Vous économisez ainsi le temps d'attendre que le système d'exploitation et les applications de l'appareil virtuel redémarre, et vous gagnez le temps de restauration de votre application dans l'état où vous souhaitez reprendre les tests. Lancer un appareil virtuel en chargeant un instantané revient à activer un appareil physique à partir d'un état de mise en veille, plutôt qu'à le démarrer après avoir été éteint.

Pour chaque AVD, vous pouvez avoir un instantané Quick Boot et un nombre illimité d'instantanés généraux.

Le moyen le plus simple d'exploiter les instantanés est d'utiliser les instantanés Quick Boot. Par défaut, chaque AVD est configuré pour enregistrer automatiquement un instantané Quick Boot en cas de sortie et de chargement à partir d'un instantané Quick Boot au démarrage.

La première fois qu'un AVD démarre, il doit effectuer un démarrage à froid, tout comme lorsqu'un appareil est allumé. Si Quick Boot est activé, tous les démarrages suivants sont chargés à partir de l'instantané spécifié, et le système est restauré à l'état enregistré dans cet instantané.

Les instantanés sont valides pour l'image système, la configuration de l'AVD et les fonctionnalités de l'émulateur avec lesquelles ils sont enregistrés. Si vous apportez une modification à ces paramètres, tous les instantanés de l'AVD concerné ne sont plus valides. Toute mise à jour des paramètres d'Android Emulator, de l'image système ou de l'AVD réinitialise l'état enregistré. Par conséquent, la prochaine fois que vous démarrerez l'AVD, il devra effectuer un démarrage à froid.

La plupart des commandes permettant d'enregistrer, de charger et de gérer les instantanés se trouvent dans les onglets Snapshots (Instantanés) et Settings (Paramètres) du volet Snapshots (Instantanés). Si vous exécutez l'émulateur dans une fenêtre d'outil d'Android Studio, le bouton du volet Snapshots (Instantanés) se trouve dans la barre d'outils de l'émulateur. Si vous exécutez l'émulateur dans une fenêtre distincte en dehors d'Android Studio, le volet Snapshots (Instantanés) se trouve dans la fenêtre Extended controls (Commandes avancées).

Vous pouvez également contrôler les options de Quick Boot lorsque vous démarrez l'émulateur à partir de la ligne de commande.

Enregistrer les instantanés Quick Boot

Vous pouvez spécifier si l'émulateur doit enregistrer automatiquement un instantané à sa fermeture. Pour ce faire, procédez comme suit :

  1. Ouvrez les paramètres des instantanés. Si l'émulateur est intégré à Android Studio, cliquez sur Instantanés dans la barre d'outils. Si l'émulateur se trouve dans une fenêtre distincte, ouvrez la fenêtre Commandes avancées.
  2. Dans la catégorie de commandes Instantanés, accédez à l'onglet Settings (Paramètres).
  3. Dans le menu Auto-save current state to Quickboot (Enregistrer automatiquement l'état actuel sur Quickboot), sélectionnez l'une des options suivantes :

    • Yes (Oui) : enregistre toujours un instantané de l'AVD lorsque vous fermez l'émulateur. Ce paramètre est la valeur par défaut

    • No (Non) : n'enregistre aucun instantané de l'AVD lorsque vous fermez l'émulateur.

Votre sélection ne s'applique qu'à l'AVD actuellement ouvert. Vous ne pouvez pas enregistrer d'instantanés lorsque l'ADB est hors connexion (par exemple, pendant son démarrage).

Enregistrer des instantanés généraux

Si vous ne pouvez avoir qu'un seul instantané Quick Boot pour chaque AVD, vous pouvez avoir plusieurs instantanés généraux pour chaque AVD.

Pour enregistrer un instantané général, ouvrez le volet Snapshots (Instantanés) et cliquez sur le bouton Take snapshot (Créer un instantané) en bas à droite.

Pour modifier le nom et la description de l'instantané sélectionné, cliquez sur le bouton de modification en bas du volet.

Supprimer un instantané

Pour supprimer manuellement un instantané, ouvrez le volet Snapshots (Instantanés), sélectionnez l'instantané, puis cliquez sur le bouton de suppression en bas du volet.

Vous pouvez également indiquer si vous souhaitez que l'émulateur supprime automatiquement les instantanés lorsqu'ils ne sont plus valides, par exemple lorsque les paramètres AVD ou la version de l'émulateur changent. Par défaut, l'émulateur vous demande si vous souhaitez qu'il supprime les instantanés non valides. Vous pouvez modifier ce paramètre via le menu Delete invalid snapshots (Supprimer les instantanés non valides) dans l'onglet Settings (Paramètres) du volet Snapshots (Instantanés).

Charger un instantané

Pour charger un instantané, ouvrez le volet Snapshots (Instantanés), sélectionnez la catégorie Snapshots (Instantanés), choisissez un instantané, puis cliquez sur le bouton de chargement en bas du volet.

Dans Android Studio 3.2 et versions ultérieures, chaque configuration d'appareil inclut une commande d'option de démarrage dans les paramètres avancés de la boîte de dialogue Virtual Device Configuration (Configuration des appareils virtuels). Vous pouvez utiliser cette commande pour spécifier l'instantané à charger au démarrage de cet AVD.

Désactiver Quick Boot

Si vous souhaitez désactiver Quick Boot afin que votre AVD effectue toujours un démarrage à froid, procédez comme suit :

  1. Sélectionnez Outils > Gestionnaire d'appareils, puis cliquez sur Modifier cet AVD.
  2. Cliquez sur Afficher les paramètres avancés, puis faites défiler la page jusqu'à Performances émulées.
  3. Sélectionnez Démarrage à froid.

Démarrer à froid une fois

Au lieu de désactiver complètement Quick Boot, vous pouvez effectuer un seul démarrage à froid en cliquant sur Cold Boot Now (Démarrage à froid immédiat) dans le menu déroulant de l'AVD dans le Gestionnaire d'appareils.

Conditions requises pour les instantanés et résolution des problèmes

  • Les instantanés ne fonctionnent pas avec Android 4.0.4 (niveau d'API 15) ou version antérieure.
  • Les instantanés ne fonctionnent pas avec les images système ARM pour Android 8.0 (niveau d'API 26).
  • Si l'émulateur ne réussit pas à démarrer à partir d'un instantané, sélectionnez Cold Boot Now (Démarrage à froid immédiat) pour l'AVD dans le Gestionnaire d'appareils, puis envoyez un rapport de bug.
  • Les instantanés ne sont pas fiables lorsque le rendu logiciel est activé. Si les instantanés ne fonctionnent pas, cliquez sur Edit this AVD (Modifier cet AVD) dans le Gestionnaire d'appareils, puis remplacez l'option Graphics (Images) par Hardware (Matériel) ou Automatic (Automatique).
  • Le chargement ou l'enregistrement d'un instantané nécessite beaucoup de mémoire. Si vous ne disposez pas de suffisamment de RAM disponible au début d'une opération de chargement ou d'enregistrement, le système d'exploitation peut transmettre le contenu de la RAM au disque dur, ce qui peut ralentir considérablement l'opération. Si le chargement ou l'enregistrement des instantanés est très lent, vous pouvez peut-être accélérer ces opérations en libérant de la RAM. La fermeture des applications non essentielles pour votre travail est un bon moyen de libérer de la RAM.

Wi-Fi

Lorsque vous utilisez un AVD avec un niveau d'API 25 ou supérieur, l'émulateur fournit un point d'accès Wi-Fi simulé ("AndroidWifi"), et Android s'y connecte automatiquement.

Pour désactiver le Wi-Fi dans l'émulateur, exécutez-le avec le paramètre de ligne de commande -feature -Wifi.

Limites

Android Emulator n'inclut pas de matériel virtuel pour les éléments suivants :

  • Bluetooth
  • NFC
  • Insertion/éjection de la carte SD
  • Casque audio connecté à l'appareil
  • USB

L'émulateur de montre pour Wear OS ne propose pas le bouton Aperçu (applications récentes), le pavé directionnel ni le lecteur d'empreinte digitale.