Lancer l'émulateur à partir de la ligne de commande

Contenu de la partition de données, qui apparaît sous la forme data/ dans le système émulé. Lorsque vous créez un AVD ou que vous utilisez l'option -wipe-data pour rétablir la configuration d'usine de l'AVD, l'émulateur copie le fichier userdata.img dans le répertoire système pour créer ce fichier.

Chaque instance d'appareil virtuel stocke les données spécifiques à l'utilisateur et à la session à l'aide d'une image de données utilisateur accessible en écriture. Par exemple, elle utilise l'image pour stocker les données des applications installées, les paramètres, les bases de données et les fichiers d'un utilisateur unique. Chaque utilisateur possède un répertoire ANDROID_SDK_HOME différent qui stocke les répertoires de données des AVD créés par cet utilisateur. Chaque AVD possède un seul fichier userdata-qemu.img.

(Facultatif) Image de la partition de carte SD vous permettant de simuler une carte SD sur un appareil virtuel. Vous pouvez créer un fichier image de carte SD dans AVD Manager ou à l'aide de l'outil mksdcard. Le fichier est stocké sur votre ordinateur de développement et doit être chargé au démarrage.

Lorsque vous définissez un AVD dans AVD Manager, vous pouvez choisir d'utiliser un fichier de carte SD géré automatiquement ou un fichier que vous avez créé avec l'outil mksdcard. Vous pouvez afficher le fichier sdcard.img associé à un AVD dans AVD Manager. L'option -sdcard remplace le fichier de carte SD spécifié dans l'AVD. Notez que cette option de carte SD ne fonctionne pas sur Mac avec Apple Silicon.

Vous pouvez parcourir, copier et supprimer les fichiers d'une carte SD simulée, ainsi que lui envoyer des fichiers, à l'aide de l'interface utilisateur de l'émulateur ou de l'utilitaire adb lorsque l'appareil virtuel est en cours d'exécution. Vous ne pouvez pas supprimer une carte SD simulée d'un appareil virtuel en cours d'exécution.

Pour copier des fichiers sur la carte SD avant de la charger, installez le fichier image en tant qu'appareil en boucle, puis copier les fichiers. Vous pouvez également recourir à un utilitaire tel que le package mtools pour copier les fichiers directement dans l'image.

L'émulateur traitera le fichier comme un pool d'octets. Le format de la carte SD n'est donc pas important.

L'option -wipe-data n'affecte pas ce fichier. Si vous souhaitez effacer le fichier, supprimez-le, puis recréez-le à l'aide d'AVD Manager ou de l'outil mksdcard. Si vous modifiez la taille du fichier, celui-ci est également supprimé et un autre est créé.

mode peut correspondre aux valeurs suivantes :

• emulated : l'émulateur simule une caméra dans le logiciel.
• webcamn : l'émulateur utilise une webcam connectée à votre ordinateur de développement, spécifiée par un numéro. Pour obtenir la liste des webcams, utilisez l'option -webcam-list. Exemple : webcam0.
• none : désactive la caméra sur l'appareil virtuel.

Exemple :

emulator @Pixel8_API_34 -camera-back webcam0

emulator @Pixel8_API_34 -webcam-list
        List of web cameras connected to the computer:
        Camera 'webcam0' is connected to device 'webcam0'
        on channel 0 using pixel format 'UYVY'

Dans cet exemple, le premier webcam0 est le nom que vous utilisez sur la ligne de commande. Le deuxième webcam0 est le nom utilisé par le système d'exploitation sur l'ordinateur de développement. Le second nom varie en fonction du système d'exploitation.

À compter de la version 25.2.4 de SDK Tools, vous devez indiquer le nom de l'AVD.

Spécifie la taille de la RAM physique, comprise entre 1 536 et 8 192 Mo. Exemple :

emulator @Pixel8_API_34 -memory 2048

Cette valeur remplace le paramètre de l'AVD.

emulator @Pixel8_API_34 -sdcard C:/sd/sdcard.img

Si le fichier est introuvable, l'émulateur se lance quand même, mais sans carte SD. La commande renvoie un avertissement No SD Card Image (Aucune image de carte SD).

Si vous ne spécifiez pas cette option, la valeur par défaut est sdcard.img dans le répertoire de données, sauf indication contraire de l'AVD. Pour en savoir plus sur les cartes SD émulées, consultez la section Répertoire de données AVD.

emulator @Pixel8_API_34 -wipe-data

Par défaut, le fichier de données utilisateur est userdata-qemu.img, et le fichier de données initial est userdata.img. Tous deux se trouvent dans le répertoire de données. L'option -wipe-data n'affecte pas le fichier sdcard.img. Pour en savoir plus sur les données utilisateur, consultez la section Comprendre les répertoires et les fichiers par défaut.

$ emulator @Pixel8_API_34 -debug init,metrics

Pour désactiver une balise, placez un tiret (-) devant celui-ci. Par exemple, l'option suivante affiche tous les messages de débogage, à l'exception de ceux liés aux sockets et aux métriques réseau :

-debug all,-socket,-metrics

Pour obtenir la liste des balises et des descriptions, utilisez l'option -help-debug-tags. Exemple :

emulator -help-debug-tags

Vous pouvez définir les balises de débogage par défaut dans la variable d'environnement ANDROID_VERBOSE. Définissez les balises que vous souhaitez utiliser dans une liste d'éléments séparés par une virgule. Voici un exemple illustrant comment spécifier les balises socket et gles :

ANDROID_VERBOSE=socket,gles

Cela revient à utiliser :

-debug-socket -debug-gles

ou

-debug socket,gles

emulator @Pixel8_API_34 -debug-all -debug-no-metrics

Pour obtenir la liste des balises, utilisez la commande emulator -help-debug-tags.

emulator @Pixel8_API_34 -logcat *:e

logtags utilise le même format que la commande adb logcat logtags. Saisissez adb logcat -help pour en savoir plus. Il s'agit d'une liste de filtres de journaux séparés par un espace ou une virgule, au format componentName:logLevel. componentName est un astérisque générique (*) ou un nom de composant, tel qu'ActivityManager, SystemServer, InputManager ou WindowManager.

logLevel est l'une des valeurs suivantes :

• v - Journalisation détaillée
• d - Débogage
• i - Informations
• w - Niveau de journalisation d'avertissement
• e - Erreur
• s - Silencieux

L'exemple suivant affiche les messages des composants GSM au niveau du journal d'informations :

emulator @Pixel8_API_34 -logcat '*:s GSM:i'

Si vous ne fournissez pas l'option -logcat sur la ligne de commande, l'émulateur recherche la variable d'environnement ANDROID_LOG_TAGS. Si ANDROID_LOG_TAGS est défini avec une valeur logtags valide et n'est pas vide, l'émulateur utilise sa valeur pour activer la sortie Logcat par défaut dans le terminal. Vous pouvez également rediriger les mêmes messages de journal ou d'autres vers le terminal via adb.

Pour en savoir plus sur Logcat et adb, consultez les sections Outil de ligne de commande Logcat, Afficher et écrire des journaux avec Logcat, Log et Émettre des commandes adb.

emulator @Pixel8_API_34 -show-kernel

Cette option permet de vérifier que le processus de démarrage fonctionne correctement.

emulator @Pixel8_API_34 -verbose

Cette option affiche les fichiers et paramètres sélectionnés lors du démarrage d'un appareil virtuel défini dans un AVD. Elle revient à spécifier -debug-init.

emulator @Pixel8_API_34 -dns-server 192.0.2.0,
192.0.2.255

Par défaut, l'émulateur tente de détecter les serveurs DNS que vous utilisez et configure des alias spéciaux sur le réseau de pare-feu émulé pour permettre au système Android de se connecter directement aux serveurs. Utilisez l'option -dns-server pour spécifier une autre liste de serveurs DNS.

emulator @Pixel8_API_34 -http-proxy myserver:1981

proxy peut être l'une des valeurs suivantes :

http://server:port
http://username:password@server:port

Le préfixe http:// peut être omis.

Si cette option n'est pas fournie, l'émulateur recherche la variable d'environnement http_proxy et utilise automatiquement toute valeur correspondant au format proxy. Pour en savoir plus, consultez la section Utiliser l'émulateur avec un proxy.

Définit l'émulation de la latence réseau sur l'une des valeurs delay suivantes, en millisecondes :

• gsm : GSM/CSD (minimum 150, maximum 550).
• hscsd : HSCSD (minimum 80, maximum 400).
• gprs : GPRS (minimum 35, maximum 200).
• edge : EDGE/EGPRS (minimum 80, maximum 400).
• umts : UMTS/3G (minimum 35, maximum 200).
• hsdpa : HSDPA (minimum 0, maximum 0).
• lte : LTE (minimum 0, maximum 0).
• evdo : EvDo (minimum 0, maximum 0).
• none : aucune latence, valeur par défaut (minimum 0, maximum 0).
• num : spécifie la latence exacte.
• min:max : spécifie les latences minimale et maximale individuelles.

Exemple :

emulator @Pixel8_API_34 -netdelay gsm

L'émulateur est compatible avec la limitation de bande passante réseau ainsi que les latences de connexion plus élevées. Vous pouvez la définir via la configuration de l'apparence ou avec les options ‑netspeed et -netdelay.

emulator @Pixel8_API_34 -netfast

Cette option revient à spécifier -netspeed full -netdelay none. Ce sont les valeurs par défaut pour ces options.

Définit l'émulation du débit réseau. Spécifie les vitesses maximales de chargement et de téléchargement sur le réseau avec l'une des valeurs speed suivantes, en kbit/s :

• gsm : GSM/CSD (montant : 14,4 ; descendant : 14,4).
• hscsd : HSCSD (montant : 14,4 ; descendant : 57,6).
• gprs : GPRS (montant : 28,8 ; descendant : 57,6).
• edge : EDGE/EGPRS (montant : 473,6 ; descendant : 473,6).
• umts : UMTS/3G (montant : 384,0 ; descendant : 384,0).
• hsdpa : HSDPA (montant : 5 760,0 ; descendant : 13 980,0).
• lte : LTE (montant : 58 000 ; descendant : 173 000).
• evdo : EvDo (montant : 75 000 ; descendant : 280 000).
• full : pas de limite, valeur par défaut (montant : 0,0 ; descendant : 0,0).
• num : spécifie les vitesses de chargement et de téléchargement.
• up:down   spécifie les vitesses ascendantes et descendantes individuelles.

Exemple :

emulator @Pixel8_API_34 -netspeed edge

L'émulateur est compatible avec la limitation de bande passante réseau ainsi que les latences de connexion plus élevées. Vous pouvez la définir via la configuration de l'apparence ou avec les options ‑netspeed et -netdelay.

emulator @Pixel8_API_34 -port 5556

La valeur par défaut est 5554 pour la première instance d'appareil virtuel exécutée sur votre machine. Un appareil virtuel occupe généralement une paire de ports adjacents : un port de console et un port adb. La console du premier appareil virtuel exécuté sur une machine spécifique utilise le port de console 5554 et le port adb 5555. Les instances suivantes utilisent des numéros de port qui augmentent de deux (par exemple 5556/5557, 5558/5559, et ainsi de suite). La plage est comprise entre 5554 et 5682. 64 appareils virtuels peuvent donc s'exécuter simultanément.

Les attributions de ports sont souvent identiques à celles spécifiées par -ports port,{port + 1}. {port + 1} doit être libre et est réservé à adb. Si l'un des ports de la console ou adb est déjà utilisé, l'émulateur ne se lance pas.

L'option ‑port indique les ports et le numéro de série utilisés par l'appareil virtuel, et vous avertit en cas de problème avec les valeurs que vous avez fournies. Dans l'UI de l'émulateur, vous pouvez voir le numéro de port de la console dans le titre de la fenêtre, et vous pouvez afficher le numéro de port adb en sélectionnant Help > About (Aide > À propos).

Notez que si la valeur port n'est pas paire et qu'elle se situe entre 5554 et 5584, l'appareil virtuel démarrera, mais ne sera pas visible lorsque vous utiliserez la commande adb devices si adb server démarre après l'émulateur. C'est pourquoi nous vous recommandons d'utiliser un numéro de port de console pair.

emulator @Pixel8_API_34 -ports 5556,5559

La plage de ports valides est comprise entre 5554 et 5682. 64 appareils virtuels peuvent donc s'exécuter simultanément. L'option -ports indique les ports et le numéro de série utilisés par l'instance d'émulateur, et vous avertit en cas de problème avec les valeurs que vous avez fournies.

Dans la mesure du possible, nous vous recommandons d'utiliser l'option -port à la place. L'option -ports est disponible pour les configurations réseau qui nécessitent des paramètres spéciaux.

Pour en savoir plus sur la configuration des ports de console et adb, reportez-vous à l'option -port.

emulator @Pixel8_API_34 -tcpdump /path/dumpfile.cap

Utilisez cette option pour commencer à capturer tous les paquets réseau envoyés via le LAN Ethernet virtuel de l'émulateur. Vous pouvez ensuite utiliser un outil comme Wireshark pour analyser le trafic.

Notez que cette option capture tous les paquets Ethernet et ne se limite pas aux connexions TCP.

emulator @Pixel8_API_34 -accel auto

L'émulation accélérée ne fonctionne que pour les images système x86 et x86_64. Sous Linux, elle repose sur KVM. Sous Windows et Mac, elle s'appuie sur un processeur Intel et un pilote Intel HAXM. Cette option est ignorée si vous n'émulez pas un appareil x86 ou x86_64.

Voici les valeurs valides pour mode :

• auto : détermine automatiquement si l'accélération est prise en charge et l'utilise dans la mesure du possible (par défaut).
• off : désactive complètement l'accélération, ce qui est principalement utile pour le débogage.
• on : force l'accélération. Si KVM ou HAXM n'est pas installé ou utilisable, l'émulateur ne se lance pas et affiche un message d'erreur.

Pour plus d'informations, consultez la section Configurer l'accélération matérielle pour Android Emulator.

emulator -accel-check

Pour en savoir plus, consultez la section Vérifier si un hyperviseur est installé.

Spécifie le moteur de l'émulateur :

• auto : sélectionne automatiquement un moteur (par défaut).
• classic : utilise l'ancien moteur QEMU 1 (obsolète).
• qemu2 : utilise le nouveau moteur QEMU 2.

Exemple :

emulator @Pixel8_API_34 -engine auto

La détection automatique doit choisir la valeur qui offre les meilleures performances lors de l'émulation d'un AVD particulier. Vous ne devez utiliser l'option -engine qu'à des fins de débogage et de comparaison.

emulator @Pixel8_API_34 -gpu swiftshader_indirect

Pour en savoir plus, consultez la section Configurer l'accélération graphique.

emulator @Pixel8_API_34 -no-accel

Pour plus d'informations, consultez la section Configurer l'accélération matérielle pour Android Emulator.

emulator @Pixel8_API_34 -nojni

Lorsque vous démarrez un appareil virtuel, les vérifications JNI étendues sont activées par défaut. Pour en savoir plus, consultez la section Conseils sur JNI.

me-linux$ emulator @Pixel8_API_34 -selinux permissive

Par défaut, SELinux est en mode enforcing, ce qui signifie que les règles de sécurité sont appliquées. Le mode permissive charge les règles SELinux, mais ne les applique pas. Il consigne simplement les cas de non-respect des règles. Le mode disabled désactive la compatibilité du noyau pour SELinux.

Définit le fuseau horaire de l'appareil virtuel sur timezone au lieu du fuseau horaire de l'hôte. Exemple :

emulator @Pixel8_API_34 -timezone Europe/Paris

Par défaut, l'émulateur utilise le fuseau horaire de votre ordinateur de développement. Utilisez cette option pour spécifier un autre fuseau horaire ou si la détection automatique ne fonctionne pas correctement. La valeur timezone doit être au format zoneinfo, c'est-à-dire area/location ou area/subarea/location. Exemple :

• America/Los_Angeles
• Europe/Paris
• America/Argentina/Buenos_Aires

Le fuseau horaire spécifié doit figurer dans la base de données zoneinfo.

emulator @Pixel8_API_34 -version

Ou

emulator -version

emulator @Pixel8_API_34 -no-boot-anim

Sur les ordinateurs plus lents, cette option permet d'augmenter considérablement la vitesse de démarrage.

emulator @Pixel8_API_34 -screen no-touch

mode peut correspondre aux valeurs suivantes :

• touch : émule un écran tactile (par défaut).
• multi-touch : émule un écran tactile multipoint.
• no-touch : désactive l'émulation de l'écran tactile et de l'écran tactile multipoint.

Active le bootcharting, avec un délai avant expiration en secondes. Certaines images système Android disposent d'un système init modifié qui intègre une fonctionnalité de bootcharting. Cette option vous permet d'envoyer un délai avant expiration du bootcharting au système. Si le bootcharting n'est pas activé sur votre système init, l'option n'a aucun effet. Cette option est surtout utile pour les développeurs de plates-formes, et non pour les développeurs d'applications externes.

Exemple :

emulator @Pixel8_API_34 -bootchart 120

Spécifie un fichier image de partition du cache. Indique un nom de fichier et un chemin d'accès absolu ou relatif au répertoire de données pour configurer un fichier de cache persistant. Si le fichier n'existe pas, l'émulateur le crée en tant que fichier vide.

Exemple :

emulator @Pixel8_API_34 -cache
   ~/.android/avd/Pixel8_API_34.avd/cache_persistent.img

Si vous n'utilisez pas cette option, la valeur par défaut est un fichier temporaire nommé cache.img. Pour en savoir plus, consultez la section Répertoire de données AVD.

Définit la taille de la partition du cache en Mo.

Exemple :

emulator @Pixel8_API_34 -cache-size 1000

Si vous ne spécifiez pas cette option, la valeur par défaut est de 66 Mo. Normalement, la plupart des développeurs d'applications n'ont pas besoin de cette option, sauf s'ils doivent télécharger des fichiers très volumineux, dont la taille est supérieure à celle du cache par défaut. Pour en savoir plus sur le fichier de cache, consultez la section Répertoire de données AVD.

Définit le fichier image de partition des données utilisateur. Fournit un nom de fichier et un chemin absolu ou un chemin relatif au répertoire de travail pour configurer un fichier de données utilisateur persistant. Si le fichier n'existe pas, l'émulateur crée une image à partir du fichier userdata.img par défaut, la stocke dans le nom de fichier que vous avez spécifié et y conserve les données utilisateur à l'arrêt.

Exemple :

emulator @Pixel8_API_34 -data
   ~/.android/avd/Pixel8_API_34.avd/userdata-test.img

Si vous n'utilisez pas cette option, le fichier par défaut est userdata-qemu.img. Pour en savoir plus sur le fichier de données utilisateur, consultez la section Répertoire de données AVD.

Spécifie un répertoire de données à l'aide d'un chemin absolu. Pour en savoir plus, consultez la section Répertoire de données AVD.

Exemple :

emulator @Pixel8_API_34 -datadir
   ~/.android/avd/Pixel8_API_34.avd/mytest

Utilise l'émulateur 32 bits sur les plates-formes 64 bits. Cette option est parfois utile pour les tests ou le débogage. Par exemple, l'émulateur ne s'exécutait pas toujours sous Windows 64 bits, mais s'exécutait sous la version 32 bits. Cette option a permis d'effectuer des comparaisons pour résoudre le problème. Exemple :

emulator @Pixel8_API_34 -force-32bit

Permet d'obtenir de l'aide sur les images disque. Cette option fournit des informations pertinentes pour les développeurs d'applications et de plates-formes. Exemple :

emulator -help-disk-images

Permet d'obtenir de l'aide concernant les spécifications device de caractères. Un paramètre device est requis par certaines options de l'émulateur. Exemple :

emulator -help-char-devices

Permet d'obtenir de l'aide sur les images disque pertinentes pour les développeurs d'applications. Cette option permet d'obtenir des informations sur l'emplacement des fichiers image d'un AVD créé à l'aide de SDK Tools. Exemple :

emulator -help-sdk-images

Permet d'obtenir de l'aide sur les images disque pertinentes pour les développeurs de plates-formes. Exemple :

emulator -help-build-images

Spécifie la version initiale de la partition de données. Après avoir effacé les données utilisateur, l'émulateur copie le contenu du fichier spécifié vers les données utilisateur (par défaut, le fichier userdata-qemu.img) au lieu d'utiliser le fichier userdata.img par défaut en tant que version initiale. Indique le nom du fichier, ainsi qu'un chemin absolu ou relatif au répertoire de travail.

Exemple :

emulator @Pixel8_API_34 -initdata
   ~/Library/Android/sdk/system-images/android-34/
   google_apis/x86_64/userdata-test.img

Si vous ne spécifiez pas de chemin, le fichier est placé dans le répertoire système. Pour en savoir plus, consultez la section Répertoire système AVD.

Utilise un noyau émulé spécifique. Si vous ne spécifiez pas de chemin, l'émulateur le recherche dans le répertoire système.

Exemple :

emulator @Pixel8_API_34 -kernel
   ~/Library/Android/sdk/system-images/android-34/
   google_apis/x86_64/kernel-test.img -show-kernel

Si vous ne spécifiez pas cette option, la valeur par défaut est kernel-ranchu. Pour en savoir plus, consultez la section Répertoire système AVD.

Désactive la compatibilité audio pour cet appareil virtuel. Certains ordinateurs Linux et Windows possèdent des pilotes audio défectueux qui provoquent différents symptômes, par exemple qui empêchent le lancement de l'émulateur. Dans ce cas, utilisez cette option pour résoudre le problème. Vous pouvez également utiliser la variable d'environnement QEMU_AUDIO_DRV pour modifier le backend audio.

Exemple :

emulator @Pixel8_API_34 -noaudio

Lance l'émulateur sans partition du cache. Si vous n'utilisez pas cette option, la valeur par défaut est un fichier temporaire nommé cache.img. Cette option est réservée aux développeurs de plates-formes. Pour en savoir plus, consultez la section Répertoire de données AVD.

Exemple :

emulator @Pixel8_API_34 -nocache

Empêche les opérations de chargement et d'enregistrement automatiques, ce qui oblige l'émulateur à exécuter une séquence de démarrage complète et à perdre son état lorsqu'il est fermé. Cette option remplace l'option -snapshot.

Exemple :

emulator @Pixel8_API_34 -no-snapshot

Empêche l'émulateur de charger l'état de l'AVD à partir du stockage d'instantanés. Effectue un démarrage complet.

Exemple :

emulator @Pixel8_API_34 -no-snapshot-load

Empêche l'émulateur d'enregistrer l'état de l'AVD dans le stockage d'instantanés à la fermeture, ce qui signifie que toutes les modifications seront perdues.

Exemple :

emulator @Pixel8_API_34 -no-snapshot-save

N'essaie pas de corriger l'heure de l'horloge de l'AVD immédiatement après la restauration de l'instantané. Cette option peut être utile lors des tests, car elle évite un saut dans le temps soudain. Les mises à jour de l'heure sont tout de même envoyées à l'AVD toutes les 15 secondes environ.

Exemple :

emulator @Pixel8_API_34 -no-snapshot-update-time

Lance l'émulateur sans installer de fichier pour stocker ou charger des instantanés d'état, ce qui force le démarrage complet et désactive la fonctionnalité d'instantanés d'état. Cette option ignore les options -snapstorage et -snapshot.

Exemple :

emulator @Pixel8_API_34 -no-snapstorage

Désactive l'affichage de la fenêtre graphique sur l'émulateur. Cette option est utile lors de l'exécution de l'émulateur sur des serveurs sans écran. Vous pouvez accéder à l'émulateur via adb ou la console. Exemple :

emulator @Pixel8_API_34 -no-window

Spécifiez la taille de la partition de données système en Mo. Exemple :

emulator @Pixel8_API_34 -partition-size 1024

Définit une propriété système Android dans l'émulateur au démarrage. name doit être un nom de propriété portant le libellé qemu_prop de 32 caractères maximum, sans espaces, et value doit être une chaîne de 92 caractères au maximum. Pour voir un exemple, consultez le fichier property_contexts. Vous pouvez spécifier plusieurs options ‑prop sur une même ligne de commande. Cette option peut être utile pour le débogage. Exemple :

emulator @Pixel8_API_34 -prop qemu.name=value -prop qemu.abc=xyz

Affiche l'aide de -qemu. Exemple :

emulator -qemu -h

Spécifie une image de démarrage ramdisk. Indique le nom du fichier, ainsi qu'un chemin absolu ou relatif au répertoire de travail.

Exemple :

emulator @Pixel8_API_34 -ramdisk
   ~/Library/Android/sdk/system-images/android-34/
   google_apis/x86_64/ramdisk-test.img

Si vous n'utilisez pas cette option, la valeur par défaut est le fichier ramdisk.img dans le répertoire système. Pour en savoir plus, consultez la section Répertoire système AVD.

Indique le port de console à un tiers distant avant de lancer l'émulation. Cette option peut être utile pour un script de test automatisé. socket doit utiliser l'un des formats suivants :

• tcp:port[,server][,max=seconds][,ipv6]
• unix:port[,server][,max=seconds][,ipv6]

Pour en savoir plus, utilisez l'option -help-report-console comme décrit dans cette section.

Crée une console d'interface système racine sur le terminal actuel. Cette option diffère de la commande adb shell à différents égards :

• Elle crée une interface système racine qui vous permet de modifier de nombreuses parties du système.
• Elle fonctionne même si le adb daemon dans le système émulé est défaillant.
• Appuyez sur les touches Ctrl+C (ou Cmd+C sous macOS) pour arrêter l'émulateur au lieu de l'interface système.

Exemple :

emulator @Pixel8_API_34 -shell

Spécifie le nom d'un instantané dans un fichier de stockage d'instantanés pour les opérations de démarrage et d'enregistrement automatiques.

Plutôt que d'exécuter une séquence de démarrage complète, l'émulateur peut reprendre l'exécution à partir d'un instantané d'état précédent, ce qui est généralement beaucoup plus rapide. Lorsque vous utilisez cette option, l'émulateur charge l'instantané de ce nom à partir de l'image d'instantané et l'enregistre sous le même nom à la fermeture.

Si vous n'utilisez pas cette option, une séquence de démarrage complète est effectuée par défaut. Si l'instantané spécifié n'existe pas, l'émulateur effectue une séquence de démarrage complète et une opération d'enregistrement.

Reportez-vous à l'option -snapstorage pour savoir comment spécifier un fichier de stockage d'instantanés et le fichier par défaut.

emulator @Pixel8_API_34 -snapshot snapshot2

N'oubliez pas que lors du chargement d'un instantané, tout le contenu du système, les données utilisateur et les images de carte SD sont écrasés par le contenu qu'ils détenaient au moment de la création de l'instantané. Si vous n'enregistrez pas ces informations dans un autre instantané, toutes les modifications apportées depuis seront perdues.

Vous pouvez également créer un instantané à partir de la console de l'émulateur à l'aide de la commande avd snapshot save name. Pour plus d'informations, consultez la section Envoyer des commandes à la console de l'émulateur.

Affiche la liste des instantanés disponibles. Cette commande affiche un tableau des instantanés stockés dans le fichier de stockage d'instantanés avec lequel l'émulateur a été démarré, puis se ferme. Si vous spécifiez également -snapstorage file, cette commande affiche un tableau des instantanés stockés dans le fichier.

Exemple :

emulator @Pixel8_API_34 -snapshot-list -snapstorage
   ~/.android/avd/Pixel8_API_34.avd/snapshots-test.img

Vous pouvez utiliser les valeurs des colonnes ID et TAG dans la sortie en tant qu'arguments pour l'option -snapshot.

Spécifie un fichier de dépôt contenant tous les instantanés d'état. Tous les instantanés réalisés lors de l'exécution seront enregistrés dans ce fichier. Seuls les instantanés de ce fichier peuvent être restaurés pendant l'exécution de l'émulateur.

Exemple :

emulator @Pixel8_API_34 -snapstorage
   ~/.android/avd/Pixel8_API_34.avd/snapshots-test.img

Si vous ne spécifiez pas cette option, la valeur par défaut est snapshots.img dans le répertoire de données. Si le fichier spécifié n'existe pas, l'émulateur se lance, mais ne permet pas d'enregistrer ni de charger des instantanés d'état.

Spécifie un répertoire système à l'aide d'un chemin absolu. Pour en savoir plus, consultez la section Répertoire système AVD. Exemple :

emulator @Pixel8_API_34 -sysdir
   ~/Library/Android/sdk/system-images/android-34/
   google_apis/x86_64/test

Spécifie un fichier système initial. Indique le nom du fichier, ainsi qu'un chemin absolu ou relatif au répertoire de travail.

Exemple :

emulator @Pixel8_API_34 -system
   ~/Library/Android/sdk/system-images/android-34/
   google_apis/x86_64/system-test.img

Si vous n'utilisez pas cette option, la valeur par défaut est le fichier system.img dans le répertoire système. Pour en savoir plus, consultez la section Répertoire système AVD.

Utilise le système libstdc++ au lieu de la version fournie avec le système d'émulateur (sous Linux). N'utilisez cette option que si l'émulateur ne démarre pas normalement, bien qu'elle ne fonctionne pas toujours. Vous pouvez également définir la variable d'environnement ANDROID_EMULATOR_USE_SYSTEM_LIBS sur 1.

Exemple :

me-linux$ emulator @Pixel8_API_34 -use-system-libs

Utilisez cette option pour obtenir une image système accessible en écriture au cours de votre session d'émulation. Pour ce faire :

1. Démarrez un appareil virtuel avec l'option -writable-system.
2. Saisissez la commande adb remount à partir d'un terminal de commande pour indiquer à l'émulateur de réinstaller system/ en lecture/écriture. Par défaut, il est installé en lecture seule.

L'utilisation de cet indicateur crée une copie temporaire de l'image système qui peut être très volumineuse (plusieurs centaines de Mo), mais qui sera détruite à la fermeture de l'émulateur.