El SDK de Android incluye un emulador de dispositivos Android (es decir, un dispositivo virtual que se ejecuta en una computadora). Android Emulator permite desarrollar y probar apps para Android sin usar un dispositivo físico.
En esta página, se describen las funciones de la línea de comandos que se pueden usar con Android Emulator. Si deseas obtener información para usar la IU de Android Emulator, consulta Cómo ejecutar apps en Android Emulator.
Cómo iniciar el emulador
Usa el comando emulator
para iniciar el emulador, como alternativa a ejecutar el proyecto o iniciarlo mediante el Administrador de AVD.
Esta es la sintaxis de la línea de comandos básica para iniciar un dispositivo virtual desde un mensaje de terminal:
emulator -avd avd_name [ {-option [value]} … ]
O bien:
emulator @avd_name [ {-option [value]} … ]
Por ejemplo, si inicias el emulador desde Android Studio en una Mac, la línea de comandos predeterminada será similar a la siguiente:
/Users/janedoe/Library/Android/sdk/emulator/emulator -avd Pixel8_API_34 -netdelay none -netspeed full -qt-hide-window -grpc-use-token -idle-grpc-timeout
Ten en cuenta que los argumentos -qt-hide-window -grpc-use-token -idle-grpc-timeout
solo se usan para ejecutar la ventana del emulador en Android Studio. Si deseas ejecutar el emulador en su propia ventana, no debes usar esos parámetros adicionales.
Puedes especificar opciones de arranque cuando inicias el emulador, pero no después.
Para obtener una lista de nombres de AVD, ingresa el siguiente comando:
emulator -list-avds
Usa esta opción para mostrar una lista de nombres de AVD del directorio principal de Android.
Puedes anular el directorio principal predeterminado configurando la variable de entorno ANDROID_SDK_HOME
, que especifica la raíz del directorio específico del usuario donde se almacena todo el contenido de AVD y los parámetros de configuración.
Puedes configurar la variable de entorno en la ventana de terminal antes de iniciar un dispositivo virtual o a través de la configuración del usuario en el sistema operativo. Por ejemplo, en el archivo .bashrc
en Linux.
Para detener Android Emulator, cierra la ventana del emulador.
Cómo instalar una app
Además de usar Android Studio o la IU del emulador para instalar una app, puedes hacerlo en un dispositivo virtual con la utilidad adb
.
Si deseas usar adb
para instalar, ejecutar y probar tu app, sigue estos pasos generales:
- Compila y empaqueta la app en un APK según se describe en Cómo compilar y ejecutar una app.
- Inicia el emulador desde la línea de comandos según se describe en la sección anterior. Si es necesario, usa las opciones de arranque.
- Instala la app con
adb
. - Ejecuta y prueba la app en el emulador.
Mientras se esté ejecutando el emulador, también puedes usar la Consola del emulador para ejecutar comandos según sea necesario.
Si deseas desinstalar una app, hazlo tal como lo harías en un dispositivo Android.
El dispositivo virtual conserva la app y sus datos de estado de un reinicio a otro en una partición de disco de datos del usuario (userdata-qemu.img
). Para borrar esos datos, inicia el emulador con la opción -wipe-data
o borra los datos en el Administrador de AVD. Para obtener más información sobre la partición de datos del usuario y otro almacenamiento, consulta la siguiente sección.
Nota: La utilidad adb
ve el dispositivo virtual como un dispositivo físico real. Por ese motivo, es posible que debas usar la marca -d
con algunos comandos habituales de adb
, como install
. -d
permite especificar cuál de varios dispositivos conectados se usará como destino de un comando. Si no especificas -d
, el emulador tendrá como objetivo el primer dispositivo de la lista.
Descripción de los archivos y directorios predeterminados
El emulador usa archivos asociados; los del sistema de AVD y los directorios de datos son los más importantes. Es útil comprender la estructura y los archivos del directorio del emulador cuando se especifican opciones de la línea de comandos, aunque, por lo general, no es necesario modificar los directorios ni los archivos predeterminados.
Android Emulator usa el hipervisor (QEMU).
Directorio del sistema de AVD
El directorio del sistema contiene las imágenes del sistema Android que usa el emulador para simular el sistema operativo. Tiene archivos de solo lectura y específicos de la plataforma compartidos por todos los AVD del mismo tipo, incluidos el nivel de API, la arquitectura de CPU y la variante de Android. Las ubicaciones predeterminadas son las siguientes:
- macOS y Linux:
~/Library/Android/sdk/system-images/android-apiLevel/variant/arch/
- Windows:
C:\Users\user\Library\Android\sdk\system-images\android-apiLevel\variant\arch\
donde:
apiLevel
es un nivel de API numérico o una letra para las versiones preliminares. Por ejemplo,android-V
indica el rol de Android Vista previa de VanillaIceCream. En el lanzamiento, pasó a ser el nivel de API 35, designado porandroid-35
variant
es un nombre que corresponde a funciones específicas implementadas por la imagen del sistema, comogoogle_apis
oandroid-wear
.arch
es la arquitectura de CPU de destino (por ejemplo,x86
).
Usa la opción -sysdir
a fin de especificar un directorio del sistema diferente para el AVD.
El emulador lee los siguientes archivos del directorio del sistema.
Archivo | Descripción | Opción para especificar un archivo diferente |
---|---|---|
kernel-qemu o kernel-ranchu
|
Es la imagen del kernel binario para el AVD. kernel-ranchu se basa en el
Emulador de QEMU
|
-kernel
|
ramdisk.img
|
Es la imagen de la partición de inicio. Este es un subconjunto de system.img que el kernel carga inicialmente antes de montar la imagen del sistema. Por lo general, contiene solo algunos objetos binarios y secuencias de comandos de inicialización.
|
-ramdisk
|
system.img
|
Es la versión inicial de solo lectura de la imagen del sistema. En especial, la partición que contiene las bibliotecas del sistema y los datos correspondientes al nivel de API y la variante. | -system
|
userdata.img
|
Es la versión inicial de la partición de datos, que se muestra como data/ en el sistema emulado y contiene todos los datos que se pueden escribir para el AVD. El emulador usa este archivo cuando creas un nuevo AVD o usas la opción ‑wipe-data . Si deseas obtener más información, consulta la descripción del archivo userdata-qemu.img en la siguiente sección.
|
-initdata
-init-data
|
Directorio de datos de AVD
El directorio de datos de AVD, también denominado directorio de contenido, es específico de una sola instancia de AVD y contiene todos los datos que se pueden modificar para el AVD.
La ubicación predeterminada es la siguiente, donde name
es el nombre del AVD:
- macOS y Linux:
~/.android/avd/name.avd/
- Windows 10 y versiones posteriores
C:\Users\user\.android\name.avd\
Usa la opción -datadir
para especificar un directorio de datos de AVD diferente.
En la siguiente tabla, se muestran los archivos más importantes contenidos en este directorio.
Archivo | Descripción | Opción para especificar un archivo diferente |
---|---|---|
userdata-qemu.img
|
Es el contenido de la partición de datos, que aparece como
Cada instancia de dispositivo virtual utiliza una imagen de datos de usuario que permite la escritura para almacenar datos específicos del usuario y la sesión. Por ejemplo, usa la imagen para almacenar datos, configuraciones, bases de datos y archivos de aplicaciones instaladas de un usuario único. Cada usuario tiene un directorio |
-data
|
cache.img
|
Es la imagen de la partición de caché, que aparece como cache/ en el sistema emulado. Está vacío la primera vez que creas un AVD o usas la opción -wipe-data . Almacena archivos de descarga temporales y el administrador de descargas y, a veces, el sistema los propaga. Por ejemplo, el navegador lo usa para almacenar en caché las páginas web y las imágenes descargadas mientras se ejecuta el emulador. Cuando se apaga el dispositivo virtual, se borra el archivo. Puedes conservar el archivo con la opción -cache .
|
-cache
|
sdcard.img
|
Opcional: Es una imagen de partición de tarjeta SD que permite simular una tarjeta SD en un dispositivo virtual. Puedes crear un archivo de imagen de tarjeta SD en el Administrador de AVD o con la herramienta
Cuando defines un AVD en el Administrador de AVD, puedes elegir usar un archivo de tarjeta SD o uno creado con la herramienta
Puedes explorar archivos en una tarjeta SD simulada, así como enviar archivos a la tarjeta, copiarlos o quitarlos; todo con la IU del emulador o la utilidad
Para copiar archivos a la tarjeta SD antes de cargarla, monta el archivo de imagen como un dispositivo de uso indefinido y, luego, copia los archivos. También puedes usar una utilidad, como el paquete El emulador trata el archivo como un conjunto de bytes, por lo que el formato de la tarjeta SD no tiene importancia.
La opción |
-sdcard
|
Cómo ver los directorios y archivos que usa el emulador
Puedes descubrir dónde se encuentran los archivos de dos maneras:
- Usa la opción
-verbose
o-debug init
cuando inicies el emulador desde la línea de comandos. Observa el resultado. - Usa el comando
emulator
-help-option
para mostrar un directorio predeterminado. Por ejemplo:emulator -help-datadir
Use '-datadir <dir>' to specify a directory where writable image files will be searched. On this system, the default directory is: /Users/me/.android See '-help-disk-images' for more information about disk image files.
Opciones de inicio de la línea de comandos
En esta sección, se muestran las opciones que puedes proporcionar en la línea de comandos cuando inicias el emulador.
Nota: Android Emulator está en desarrollo continuo para que sea más confiable. Si quieres reportar errores o ver el estado de los problemas informados sobre las opciones de la línea de comandos, consulta la Herramienta de seguimiento de errores de Android.
Opciones de uso general
En la siguiente tabla, se muestran las opciones de inicio de la línea de comandos que posiblemente uses con mayor frecuencia:
Opción de la línea de comandos | Descripción |
---|---|
Quick Boot | |
-no-snapshot-load
|
Realiza un inicio en frío y guarda el estado del emulador al salir. |
-no-snapshot-save
|
Realiza un inicio rápido, si es posible, pero no guarda el estado del emulador al salir. |
-no-snapshot
|
Inhabilita la función Quick Boot por completo y no carga ni guarda el estado del emulador. |
Hardware del dispositivo | |
-camera-back mode -camera-front mode
|
Configura el modo de emulación para una cámara frontal o posterior. Esto anula cualquier configuración de cámara en el AVD.
Por ejemplo: emulator @Pixel8_API_34 -camera-back webcam0 |
-webcam-list
|
Enumera las cámaras web de tu computadora de desarrollo que están disponibles para emulación. Por ejemplo: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' En el ejemplo, la primera instancia de A partir de la versión 25.2.4 de las herramientas del SDK, el nombre del AVD es obligatorio. |
Imágenes de disco y memoria | |
-memory size
|
Especifica el tamaño físico de la RAM, de 1,536 a 8,192 MB. Por ejemplo: emulator @Pixel8_API_34 -memory 2048 Este valor anula la configuración del AVD. |
-sdcard filepath
|
Especifica el nombre de archivo y la ruta de acceso a un archivo de imagen de partición de una tarjeta SD. Por ejemplo:
emulator @Pixel8_API_34 -sdcard C:/sd/sdcard.img Si no se encuentra el archivo, se iniciará el emulador, pero sin una tarjeta SD. El comando mostrará la advertencia No SD Card Image, que indica que no hay una imagen de tarjeta SD.
Si no especificas esta opción, el valor predeterminado será |
-wipe-data
|
Borra los datos del usuario y los copia del archivo de datos inicial. Esta opción borra los datos del dispositivo virtual y lo devuelve al mismo estado que cuando se definió por primera vez. Se quitan todas las apps instaladas y los ajustes de configuración. Por ejemplo:
emulator @Pixel8_API_34 -wipe-data
De forma predeterminada, el archivo de datos del usuario es |
Depuración | |
-debug tags
|
Habilita o inhabilita la visualización de mensajes de depuración para una o más etiquetas.
Separa varias etiquetas con un espacio, una coma o una columna. Por ejemplo:
$ emulator @Pixel8_API_34 -debug init,metrics Para inhabilitar una etiqueta, coloca un guion (-) antes de ella. Por ejemplo, en la siguiente opción, se muestran todos los mensajes de depuración, excepto los relacionados con sockets y métricas de red:
Para ver una lista de etiquetas y descripciones, usa la opción
emulator -help-debug-tags
Puedes definir las etiquetas de depuración predeterminadas en la variable de entorno
ANDROID_VERBOSE=socket,gles Es equivalente a usar:
o
|
-debug-tag -debug-no-tag
|
Habilita un tipo de mensaje de depuración específico. Usa el formulario no para inhabilitar un tipo de mensaje de depuración. Por ejemplo:
emulator @Pixel8_API_34 -debug-all -debug-no-metrics Para ver una lista de etiquetas, usa el comando |
-logcat logtags
|
Habilita la visualización de mensajes de Logcat para una o más etiquetas y los escribe en la ventana de terminal. Por ejemplo, el siguiente comando habilita los mensajes de error de todos los componentes:
emulator @Pixel8_API_34 -logcat *:e
En el siguiente ejemplo, se muestran los mensajes de componentes de GSM a nivel de registro informativo:
emulator @Pixel8_API_34 -logcat '*:s GSM:i'
Si no proporcionas la opción Si deseas obtener más información sobre Logcat y |
-show-kernel
|
Muestra los mensajes de depuración del kernel en la ventana de terminal. Por ejemplo:
emulator @Pixel8_API_34 -show-kernel Esta opción puede usarse para comprobar que el proceso de inicio funcione correctamente. |
-verbose
|
Muestra los mensajes de inicialización del emulador en la ventana de terminal. Por ejemplo:
emulator @Pixel8_API_34 -verbose Muestra qué archivos y configuraciones están seleccionados cuando se inicia un dispositivo virtual definido en un AVD. Esta opción es lo mismo que especificar |
Red | |
-dns-server servers
|
Usa los servidores DNS especificados. servers es una lista separada por comas de hasta cuatro nombres de servidor DNS o direcciones IP. Por ejemplo:
emulator @Pixel8_API_34 -dns-server 192.0.2.0,
De manera predeterminada, el emulador intenta detectar los servidores DNS que estás usando y configura alias especiales en la red de firewall emulada para permitir que el sistema Android se conecte directamente a ellos. Usa la opción |
-http-proxy proxy
|
Establece todas las conexiones de TCP mediante un proxy HTTP/HTTPS especificado. Si el emulador debe acceder a Internet mediante un servidor proxy, puedes usar esta opción o la variable de entorno http_proxy para configurar el redireccionamiento adecuado. Por ejemplo:
emulator @Pixel8_API_34 -http-proxy myserver:1981
Se puede omitir el prefijo
Si no se proporciona esta opción, el emulador buscará la variable de entorno |
-netdelay delay
|
Establece la emulación de latencia de red en uno de los siguientes valores de
Por ejemplo: emulator @Pixel8_API_34 -netdelay gsm
El emulador admite la limitación de la red y latencias de conexión más altas.
Puedes definirlo mediante la configuración de la máscara o con las opciones |
-netfast
|
Inhabilita la limitación de la red. Por ejemplo:
emulator @Pixel8_API_34 -netfast
Esta opción es igual a especificar |
-netspeed speed
|
Establece la emulación de la velocidad de red. Especifica las velocidades máximas de carga y descarga de red con uno de los siguientes valores de
Por ejemplo: emulator @Pixel8_API_34 -netspeed edge
El emulador admite la limitación de la red y latencias de conexión más altas.
Puedes definirlo mediante la configuración de la máscara o con las opciones |
-port port
|
Configura el número de puerto TCP que se usa para la consola y adb . Por ejemplo:
emulator @Pixel8_API_34 -port 5556
El valor predeterminado es 5554 para la primera instancia de dispositivo virtual que se ejecuta en la computadora. Un dispositivo virtual normalmente ocupa un par de puertos adyacentes: un puerto de consola y un puerto
Las asignaciones de puertos suelen ser las mismas que para especificar La opción
Ten en cuenta que si el valor de |
-ports
|
Configura los puertos TCP que se usan para la consola y adb . Por ejemplo:
emulator @Pixel8_API_34 -ports 5556,5559
El rango de puertos válidos es de 5554 a 5682, lo que permite 64 dispositivos virtuales simultáneos. La opción
Recomendamos utilizar la opción
Si deseas obtener más información para configurar los puertos de consola y |
-tcpdump filepath
|
Captura paquetes de red y los almacena en un archivo. Por ejemplo:
emulator @Pixel8_API_34 -tcpdump /path/dumpfile.cap Usa esta opción para comenzar a capturar todos los paquetes de red que se envían a través de la LAN Ethernet virtual del emulador. Luego, puedes usar una herramienta, como Wireshark, para analizar el tráfico. Ten en cuenta que esta opción captura todos los paquetes de Ethernet y no se limita a las conexiones TCP. |
Sistema | |
-accel mode
|
Configura la aceleración de VM del emulador. Por ejemplo:
emulator @Pixel8_API_34 -accel auto La emulación acelerada funciona para imágenes de sistema x86 y x86_64. En Linux, se basa en KVM. En Windows y Mac, se basa en una CPU Intel y un controlador HAXM de Intel. Esta opción se omite si no se está emulando un dispositivo x86 o x86_64. Los valores válidos para
Si deseas obtener más información, consulta Cómo configurar la aceleración de hardware para Android Emulator. |
-accel-check
|
Comprueba si está instalado un hipervisor requerido para la aceleración de VM del emulador (HAXM o KVM). Por ejemplo:
emulator -accel-check Si deseas obtener más información, consulta Cómo verificar si hay un hipervisor instalado. |
-engine engine
|
Especifica el motor del emulador:
Por ejemplo:
emulator @Pixel8_API_34 -engine auto La detección automática debe seleccionar el valor que proporciona el mejor rendimiento cuando se emula un AVD determinado. Debes usar la opción |
-gpu mode
|
Selecciona el modo de emulación de GPU. Por ejemplo:
emulator @Pixel8_API_34 -gpu swiftshader_indirect Si deseas obtener más información, consulta Cómo configurar la aceleración de gráficos. |
-no-accel
|
Inhabilita la aceleración de VM cuando se usa una imagen de sistema x86 o x86_64. Es útil solo para depuración y es lo mismo que especificar -accel
off . Por ejemplo:
emulator @Pixel8_API_34 -no-accel Si deseas obtener más información, consulta Cómo configurar la aceleración de hardware para Android Emulator. |
-nojni
-no-jni
|
Inhabilita las comprobaciones de interfaz nativa de Java (JNI) en el entorno de ejecución de Android Dalvik o ART. Por ejemplo:
emulator @Pixel8_API_34 -nojni Cuando inicias un dispositivo virtual, las comprobaciones de JNI extendidas están habilitadas de forma predeterminada. Para obtener más información, consulta Sugerencias de JNI. |
-selinux {disabled|permissive}
|
Configura el módulo de seguridad Security-Enhanced Linux (SELinux) en el modo disabled o permissive en un sistema operativo Linux. Por ejemplo:
me-linux$ emulator @Pixel8_API_34 -selinux permissive
De forma predeterminada, SELinux está en modo |
-timezone timezone
|
Establece la zona horaria del dispositivo virtual en emulator @Pixel8_API_34 -timezone Europe/Paris
De forma predeterminada, el emulador usa la zona horaria de la computadora de desarrollo. Usa esta opción para especificar otra zona horaria, o si la detección automática no funciona correctamente. El valor
La zona horaria especificada debe estar en la base de datos de zoneinfo. |
-version
|
Muestra el número de versión del emulador. Por ejemplo:
emulator @Pixel8_API_34 -version O bien:
emulator -version |
IU | |
-no-boot-anim
|
Inhabilita la animación de inicio durante el inicio del emulador para un inicio más rápido.
Por ejemplo:
emulator @Pixel8_API_34 -no-boot-anim En computadoras más lentas, esta opción puede acelerar en gran medida la secuencia de inicio. |
-screen mode
|
Establece el modo de pantalla táctil emulada. Por ejemplo:
emulator @Pixel8_API_34 -screen no-touch
|
Opciones avanzadas
Las opciones de inicio de la línea de comandos de la siguiente tabla están disponibles, pero el desarrollador promedio de apps, en general, no las usa.
En las descripciones, el directorio de trabajo es el directorio actual del terminal donde se ingresan los comandos. Si deseas obtener información sobre el directorio del sistema y el directorio de datos de AVD, y sobre los archivos almacenados en ellos, consulta la sección sobre directorios y archivos predeterminados.
Algunas de estas opciones son adecuadas para desarrolladores de apps externas, y algunas las usan principalmente los desarrolladores de plataformas. Los desarrolladores de apps crean apps para Android y las ejecutan en AVD específicos. Los desarrolladores de plataformas trabajan en el sistema Android y lo ejecutan dentro del emulador sin AVD creados previamente.
Opción avanzada | Descripción breve |
---|---|
-bootchart timeout
|
Habilita el diagrama de inicio, con un tiempo de espera en segundos. Algunas imágenes del sistema Android tienen un sistema de iniciación modificado que integra la instalación de gráficos de inicio. Puedes pasar un tiempo de espera de gráfico de inicio al sistema con esta opción. Si el sistema de inicialización no tiene un gráfico de inicio activado, la opción no hace nada. Esta opción es principalmente útil para desarrolladores de plataforma, no para los de apps externas. Por ejemplo: emulator @Pixel8_API_34 -bootchart 120 |
-cache filepath
|
Especifica un archivo de imagen de partición de caché. Proporciona un nombre de archivo, una ruta absoluta o una ruta relativa al directorio de datos, para configurar un archivo de caché persistente. Si no existe el archivo, el emulador lo crea en un archivo vacío. Por ejemplo: emulator @Pixel8_API_34 -cache ~/.android/avd/Pixel8_API_34.avd/cache_persistent.img Si no usas esta opción, el valor predeterminado será un archivo temporal llamado |
-cache-size size
|
Configura el tamaño de la partición de la caché en MB. Por ejemplo: emulator @Pixel8_API_34 -cache-size 1000 Si no especificas esta opción, el valor predeterminado será 66 MB. Por lo general, la mayoría de los desarrolladores de apps no precisan esta opción, a menos que necesiten descargar archivos muy grandes que pesen más que la caché predeterminada. Si deseas obtener más información acerca del almacenamiento de archivos en caché, consulta el directorio de datos de AVD. |
-data filepath
|
Configura el archivo de imagen de partición de datos del usuario. Proporciona un nombre de archivo y una ruta de acceso absoluta o una ruta relativa al directorio de trabajo para configurar un archivo de datos de usuario persistente. Si no existe el archivo, el emulador crea una imagen del archivo Por ejemplo: emulator @Pixel8_API_34 -data ~/.android/avd/Pixel8_API_34.avd/userdata-test.img Si no usas esta opción, el valor predeterminado será un archivo llamado |
-datadir dir
|
Especifica un directorio de datos con una ruta de acceso absoluta. Para obtener más información, consulta el directorio de datos de AVD. Por ejemplo: emulator @Pixel8_API_34 -datadir ~/.android/avd/Pixel8_API_34.avd/mytest |
-force-32bit
|
Usa el emulador de 32 bits en plataformas de 64 bits. De manera ocasional, esta opción es útil para pruebas o depuraciones. Por ejemplo, se produjo un error por el que el emulador a veces no se ejecutaba en Windows de 64 bits, aunque sí lo hacía en la versión de 32 bits. Con esta opción, fue posible llevar a cabo comparaciones para depurar el problema. Por ejemplo: emulator @Pixel8_API_34 -force-32bit |
-help-disk-images
|
Permite obtener ayuda sobre las imágenes de disco. Esta opción proporciona información relevante para los desarrolladores de apps y plataformas. Por ejemplo: emulator -help-disk-images |
-help-char-devices
|
Obtiene ayuda sobre las especificaciones de emulator -help-char-devices |
-help-sdk-images
|
Permite obtener ayuda sobre imágenes en el disco relevantes para desarrolladores de apps. Esta opción obtiene información sobre la ubicación de los archivos de imagen para un AVD creado con las herramientas del SDK. Por ejemplo: emulator -help-sdk-images |
-help-build-images
|
Permite obtener ayuda sobre imágenes en el disco relevantes para desarrolladores de plataformas. Por ejemplo: emulator -help-build-images |
-initdata filepath -init-data
filepath
|
Especifica la versión inicial de la partición de datos. Después de borrar los datos del usuario, el emulador copia el contenido del archivo especificado en los datos del usuario (de forma predeterminada, el archivo Por ejemplo: emulator @Pixel8_API_34 -initdata ~/Library/Android/sdk/system-images/android-34/ google_apis/x86_64/userdata-test.img Si no especificas una ruta de acceso, se coloca el archivo en el directorio del sistema. Para obtener más información, consulta el directorio del sistema de AVD. |
-kernel filepath
|
Usa un kernel emulado específico. Si no especificas una ruta de acceso, el emulador buscará en el directorio del sistema. Usa la opción‑show‑kernel para ver los mensajes de depuración del kernel.
Por ejemplo: emulator @Pixel8_API_34 -kernel ~/Library/Android/sdk/system-images/android-34/ google_apis/x86_64/kernel-test.img -show-kernel Si no especificas esta opción, el valor predeterminado será |
-noaudio
-no-audio
|
Inhabilita la compatibilidad de audio para este dispositivo virtual. Algunas computadoras Linux y Windows tienen controladores de audio con fallas que causan diferentes síntomas (por ejemplo, evitan que se inicie el emulador). En este caso, usa esta opción para solucionar el problema. También puedes utilizar la variable de entorno Por ejemplo: emulator @Pixel8_API_34 -noaudio |
-nocache
-no-cache
|
Inicia el emulador sin una partición de caché. Si no usas esta opción, el valor predeterminado será un archivo temporal llamado Por ejemplo: emulator @Pixel8_API_34 -nocache |
-no-snapshot
|
Inhibe las operaciones de carga y guardado automático, lo que hace que el emulador ejecute una secuencia de inicio completa y pierda el estado cuando se cierra. Anula la opción Por ejemplo: emulator @Pixel8_API_34 -no-snapshot |
-no-snapshot-load
|
Evita que el emulador cargue el estado de AVD desde el almacenamiento de instantáneas. Realiza un inicio completo. Por ejemplo: emulator @Pixel8_API_34 -no-snapshot-load |
-no-snapshot-save
|
Evita que el emulador guarde el estado de AVD en el almacenamiento de instantáneas en la salida. Esto significa que se perderán todos los cambios. Por ejemplo: emulator @Pixel8_API_34 -no-snapshot-save |
-no-snapshot-update-time
|
No intentes corregir la hora del reloj de AVD de inmediato luego de restaurar la instantánea. Esta opción puede ser útil durante las pruebas, ya que evita un salto repentino en el tiempo. Sin embargo, las actualizaciones de hora aún se envían al AVD aproximadamente cada 15 segundos. Por ejemplo: emulator @Pixel8_API_34 -no-snapshot-update-time |
-no-snapstorage
|
Inicia el emulador sin montar un archivo para almacenar o cargar instantáneas de estado. Esto fuerza un reinicio completo e inhabilita la funcionalidad de instantáneas de estado. Esta opción anula las opciones Por ejemplo: emulator @Pixel8_API_34 -no-snapstorage |
-no-window
|
Inhabilita la visualización de la ventana de gráficos en el emulador. Esta opción es útil cuando se ejecuta el emulador en servidores que no tienen visualización. Puedes acceder al emulador a través de emulator @Pixel8_API_34 -no-window |
-partition-size size
|
Especifica el tamaño de la partición de datos en MB. Por ejemplo: emulator @Pixel8_API_34 -partition-size 1024 |
-prop name=value
|
Configura una propiedad del sistema Android en el emulador cuando se inicia.
emulator @Pixel8_API_34 -prop qemu.name=value -prop qemu.abc=xyz |
-qemu args
|
Transmite argumentos al software del emulador de QEMU. Cuando uses esta opción, asegúrate de que sea la última opción especificada, ya que todas las opciones posteriores se interpretan como opciones específicas de QEMU. Esta opción es muy avanzada y solo la deben usar los desarrolladores que están muy familiarizados con la emulación de QEMU y Android. |
-qemu -h
|
Muestra la ayuda de emulator -qemu -h |
-ramdisk filepath
|
Especifica una imagen de arranque de ramdisk. Especifica el nombre de archivo y una ruta de acceso absoluta o una ruta relativa al directorio de trabajo. Por ejemplo: emulator @Pixel8_API_34 -ramdisk ~/Library/Android/sdk/system-images/android-34/ google_apis/x86_64/ramdisk-test.img Si no usas esta opción, el valor predeterminado será el archivo |
-report-console socket
|
Informa el puerto de la consola a un tercero remoto antes de iniciar la emulación. Puede ser útil para una secuencia de comandos de prueba automatizada.
Si deseas obtener más información, usa la opción |
-shell
|
Crea una consola de shell raíz en el terminal actual. Entre las diferencias que tiene esta opción con el comando
Por ejemplo: emulator @Pixel8_API_34 -shell |
-snapshot name
|
Especifica el nombre de una instantánea dentro de un archivo de almacenamiento de instantáneas para las operaciones de inicio y guardado automáticas. En lugar de ejecutar una secuencia de inicio completa, el emulador puede reanudar la ejecución desde una instantánea de estado anterior, que generalmente es mucho más rápida. Cuando proporcionas esta opción, el emulador carga la instantánea de ese nombre desde la imagen de la instantánea y la guarda de nuevo con el mismo nombre al salir. Si no usas esta opción, el valor predeterminado es una secuencia de inicio completa. Si no existe la instantánea especificada, el emulador lleva a cabo una secuencia de inicio completa y realiza una operación de guardado. Consulta la opción emulator @Pixel8_API_34 -snapshot snapshot2 Recuerda que, durante el proceso de carga de una instantánea, se reemplaza todo el contenido del sistema, los datos del usuario y las imágenes de la tarjeta SD por el contenido que tenían cuando se tomó la instantánea. A menos que guardes esta información en una instantánea diferente, se perderán todos los cambios posteriores a esa fecha. También puedes crear una instantánea desde la consola del emulador con el comando |
-snapshot-list
|
Muestra una lista de instantáneas disponibles. Muestra una tabla de instantáneas que se almacenan en el archivo de almacenamiento de instantáneas con el que se inició el emulador y luego se cierra. Si también especificas Por ejemplo: emulator @Pixel8_API_34 -snapshot-list -snapstorage ~/.android/avd/Pixel8_API_34.avd/snapshots-test.img Puedes usar los valores de las columnas ID y TAG en la salida como argumentos para la opción |
-snapstorage filepath
|
Especifica un archivo de repositorio que contenga todas las instantáneas de estado. Todas las instantáneas tomadas durante la ejecución se guardan en este archivo. Solo se pueden restablecer las instantáneas de este archivo durante la ejecución del emulador. Por ejemplo: emulator @Pixel8_API_34 -snapstorage ~/.android/avd/Pixel8_API_34.avd/snapshots-test.img Si no especificas esta opción, el valor predeterminado será |
-sysdir dir
|
Especifica un directorio del sistema con una ruta de acceso absoluta. Para obtener más información, consulta el directorio del sistema de AVD. Por ejemplo: emulator @Pixel8_API_34 -sysdir ~/Library/Android/sdk/system-images/android-34/ google_apis/x86_64/test |
-system filepath
|
Especifica un archivo de sistema inicial. Especifica el nombre de archivo y una ruta de acceso absoluta o una ruta relativa al directorio de trabajo. Por ejemplo: emulator @Pixel8_API_34 -system ~/Library/Android/sdk/system-images/android-34/ google_apis/x86_64/system-test.img Si no usas esta opción, el valor predeterminado será el archivo |
-use-system-libs
|
En Linux, usa el sistema Por ejemplo: me-linux$ emulator @Pixel8_API_34 -use-system-libs |
-writable-system
|
Usa esta opción para tener una imagen de sistema grabable durante la sesión de emulación. Para ello, haz lo siguiente:
El uso de esta marca crea una copia temporal de la imagen del sistema que puede ser muy grande, de hasta cientos de MB, pero se destruirá cuando se cierre el emulador. |
Opciones obsoletas
Las siguientes opciones de la línea de comandos son obsoletas:
-audio-in
-audio-out
-charmap
-code-profile
-cpu-delay
-dpi-device
-dynamic_skin
-enable-kvm
-gps
-image
-keyset
-help-keys
-help-keyset-file
-nand-limits
-noskin
-no-skin
-onion
-onion-alpha
-onion-rotation
-radio
-ranchu
-raw-keys
-scale
-shared-net-id
-shell-serial
-skin
-skindir
-trace
-useaudio
Cómo obtener ayuda sobre las opciones de la línea de comandos
En esta sección, se describe cómo obtener ayuda sobre las opciones de la línea de comandos. Proporciona información más detallada sobre las opciones de línea de comandos del emulador que son de uso general y están disponibles cuando inicias el emulador.
Cómo visualizar todas las opciones del emulador
Para mostrar una lista de todas las opciones del emulador, incluida una descripción breve, ingresa el siguiente comando:
emulator -help
Cómo obtener ayuda detallada para una opción específica
A fin de mostrar la ayuda para una opción de inicio específica, ingresa el siguiente comando:
emulator -help-option
Por ejemplo:
emulator -help-netspeed
Esta ayuda es más detallada que la descripción proporcionada por la opción -help
.
Cómo obtener ayuda detallada para todas las opciones
A fin de obtener ayuda detallada para todas las opciones del emulador, ingresa el siguiente comando:
emulator -help-all
Cómo visualizar variables de entorno del emulador
Para obtener una lista de las variables de entorno del emulador, ingresa el siguiente comando:
emulator -help-environment
Puedes configurar variables de entorno en la ventana de terminal antes de iniciar un dispositivo virtual, o puedes hacerlo mediante los ajustes del usuario en el sistema operativo; por ejemplo, en el archivo .bashrc
de Linux.
Cómo visualizar etiquetas de depuración
A fin de imprimir una lista de etiquetas para las opciones de -debug
, ingresa el siguiente comando:
emulator -help-debug-tags
Las opciones de -debug
permiten habilitar o inhabilitar los mensajes de depuración de los componentes específicos del emulador, según se especifica en las etiquetas.