Es posible que debas probar tu app en un dispositivo virtual y usar más que solo gestos básicos de la pantalla táctil y movimientos del teléfono. Por ejemplo, es posible que quieras simular diferentes ubicaciones o condiciones de red. En esta página, se describen las funciones avanzadas del emulador y las diferentes maneras de iniciarlo con Android Studio.
En las otras páginas de esta sección, se abordan formas aún más avanzadas de usar el emulador, que requieren que uses la terminal. Estos son casos de uso más especializados:
- Si no usas Android Studio, puedes iniciar el emulador desde la línea de comandos.
- Para probar funciones, incluida la validación de huellas digitales, o cambiar el estado de la batería de tu dispositivo virtual, puedes enviar comandos de la consola del emulador.
- Si deseas tener dos instancias del emulador que puedan comunicarse entre sí o configurar otras arquitecturas de red complejas, puedes configurar redes en el emulador.
Para la mayoría de los desarrolladores de apps, las funciones de navegación básicas del emulador y las funciones descritas en esta página deberían ser suficientes para hacer pruebas. Para obtener una comparación de lo que puedes hacer con el emulador según cómo interactúes con él, consulta Comparación de funciones del emulador.
Capturas de pantalla
Para tomar una captura de pantalla del dispositivo virtual, haz clic en el botón Take screenshot .
En el cuadro de diálogo Screen Capture que aparece, puedes volver a capturar, editar y copiar la imagen capturada. Una vez que estés conforme con la imagen, haz clic en Save. El emulador crea un archivo PNG con el nombre Screenshot_yyyymmdd-hhmmss.png
con la información de año, mes, día, hora, minuto y segundo de la captura. Si lo prefieres, puedes cambiar el nombre y elegir dónde guardar el archivo.
También puedes tomar capturas de pantalla desde la línea de comandos usando cualquiera de los siguientes:
screenrecord screenshot [destination-directory]
adb emu screenrecord screenshot [destination-directory]
Grabación de pantalla
Desde Android Emulator, puedes grabar video y audio, así como guardar la grabación en un archivo WebM o GIF animado.
Los controles de grabación de pantalla se encuentran en la pestaña Record and Playback de la ventana Extended Controls.
Sugerencia: Para abrir los controles de grabación de pantalla, presiona Ctrl + Mayúsculas + R. (Cmd + Mayúsculas + R en macOS).
Para comenzar la grabación de pantalla, haz clic en el botón Start recording en la pestaña Record and Playback. Si quieres detener la grabación, haz clic en Stop recording.
Los controles para reproducir y guardar el video grabado se encuentran en la parte inferior de la pestaña Record and Playback. Para guardar el video, selecciona WebM o GIF en el menú de la parte inferior de la pestaña y haz clic en Save.
También puedes grabar y guardar una grabación de pantalla desde el emulador si usas el siguiente comando en la línea de comandos:
adb emu screenrecord start --time-limit 10 [path to save video]/sample_video.webm
Compatibilidad con la cámara
El emulador admite el uso de la función de cámara básica en tu dispositivo virtual para versiones de Android anteriores. Android 11 y las versiones posteriores admiten las siguientes capacidades adicionales de cámara de Android Emulator:
- Captura de RAW
- Reprocesamiento de YUV
- Dispositivos de nivel 3
- Compatibilidad con cámara lógica
- Emulación de la orientación del sensor mediante datos del administrador de sensores
- Aplicación de estabilización de video mediante la reducción de la frecuencia del protocolo de enlace
- Aplicación de mejora de bordes mediante la eliminación del escalamiento en la canalización de YUV
- Cámaras simultáneas
Cámara de escena virtual y ARCore
Puedes usar la cámara de escena virtual en un entorno virtual para probar apps de realidad aumentada (RA) creadas con ARCore.
Para obtener información sobre el uso de la cámara de escena virtual en el emulador, consulta Cómo ejecutar apps de RA en Android Emulator.
Cuando uses el emulador con una app de cámara, podrás importar una imagen en formato PNG o JPEG para usar dentro de una escena virtual. Si quieres elegir una imagen para usar en una escena virtual, abre la ventana Extended controls, selecciona la pestaña Camera > Virtual Scene Images y haz clic en Add Image. Esta función también sirve para importar imágenes personalizadas, como códigos QR, que se pueden usar con cualquier app basada en cámara. Para obtener más información, consulta Cómo agregar imágenes aumentadas a la escena.
Cómo probar acciones comunes de RA con macros
Es posible reducir en gran medida el tiempo que se tarda en probar las acciones comunes de RA usando macros preestablecidas en el emulador. Por ejemplo, puedes usar una macro para restablecer el estado predeterminado de todos los sensores del dispositivo.
Antes de usar macros, sigue los pasos indicados en Cómo ejecutar apps de RA en Android Emulator para configurar la cámara de escena virtual para tu app, ejecutarla en el emulador y actualizar ARCore. Luego, sigue estos pasos para usar las macros del emulador:
- Con el emulador en ejecución y tu app conectada a ARCore, haz clic en More
en el panel del emulador.
- Selecciona Record and Playback > Macro Playback.
Elige una macro que deseas usar y, luego, haz clic en Play.
Durante la reproducción, puedes interrumpir una macro haciendo clic en Stop.
Cómo iniciar el emulador en otra ventana
Android Emulator se ejecuta directamente en Android Studio de forma predeterminada. De esta manera, podrás usar el espacio de pantalla de manera eficiente, navegar rápidamente entre el emulador y la ventana del editor con teclas de acceso rápido y organizar el flujo de trabajo del IDE y del emulador en una sola ventana de la aplicación.
Sin embargo, algunas funciones del emulador solo están disponibles cuando lo ejecutas en una ventana independiente. Para iniciar el emulador en una ventana independiente, ve a File > Settings > Tools > Emulator (Android Studio > Preferences > Tools > Emulator en macOS) y anula la selección de Launch in a tool window.
Controles extendidos, configuración y ayuda
Usa los controles extendidos para enviar datos, cambiar las propiedades del dispositivo, controlar apps y mucho más. Para abrir la ventana Extended controls, haz clic en More en el panel del emulador. Ten en cuenta que algunas de estas opciones de control extendido solo están disponibles cuando ejecutas el emulador en una ventana separada fuera de Android Studio.
Puedes usar combinaciones de teclas para realizar muchas de estas tareas. Si quieres ver una lista completa de las combinaciones de teclas en el emulador, presiona F1 (Cmd+/ en macOS) para abrir el panel Help.
Tabla 1: Detalle de los controles extendidos
Función | Descripción |
---|---|
Location |
El emulador te permite simular la información de "Mi ubicación", es decir, dónde se encuentra el dispositivo emulado. Por ejemplo, si haces clic en Mi ubicación Los controles para la información de ubicación del dispositivo se organizan en dos pestañas: Single points y Routes. Single points En la pestaña Single points, puedes usar la vista web de Google Maps para buscar lugares de interés, al igual que cuando utilizas Google Maps en un teléfono o en un navegador. Cuando buscas una ubicación en el mapa (o haces clic en ella), puedes seleccionar Save point cerca de la parte inferior del mapa para guardar la ubicación. Todas tus ubicaciones guardadas aparecen en el lado derecho de la ventana Extended controls. Si deseas establecer la ubicación del emulador en la ubicación que seleccionaste en el mapa, haz clic en el botón Set location que se encuentra cerca de la parte inferior derecha de la ventana Extended controls. Rutas Al igual que la pestaña Single points, la pestaña Routes proporciona una vista web de Google Maps que puedes usar para crear una ruta entre dos o más ubicaciones. Para crear y guardar una ruta, sigue estos pasos:
Para simular el emulador siguiendo la ruta que guardaste, selecciona la ruta en la lista de Saved routes y haz clic en Play route, cerca de la parte inferior derecha de la ventana Extended controls. Para detener la simulación, haz clic en Stop route. Si quieres simular de forma continua el emulador siguiendo la ruta especificada, habilita el botón que se encuentra junto a Repeat playback. Para cambiar la velocidad con la que el emulador sigue la ruta especificada, selecciona una opción del menú Playback speed. Cómo importar datos de GPX y KML Para utilizar los datos geográficos a partir de un formato de intercambio de GPS (GPX) o de un archivo de lenguaje de marcación de punto clave (KML), haz lo siguiente:
La velocidad predeterminada es el valor Delay (Speed 1X). Puedes duplicar la velocidad (Speed 2X), triplicarla (Speed 3X), etcétera. |
Pantallas |
El emulador te permite implementar tu app en varias pantallas, que admiten dimensiones personalizables y pueden ayudarte a probar apps compatibles con multiventana y multipantalla. Mientras se ejecuta un dispositivo virtual, puedes agregar hasta dos pantallas adicionales de la siguiente manera:
|
Cellular | El emulador te permite simular diferentes condiciones de red. Puedes aproximar la velocidad para diferentes protocolos de red o especificar Full, con la que podrás transferir los datos tan rápido como lo permita la computadora. Especificar un protocolo de red siempre es un proceso más lento que el de la opción Full. Además, puedes especificar el estado de la red de datos y voz; por ejemplo, el roaming. La configuración predeterminada se establece en el AVD. Selecciona un tipo de red en Network type:
Selecciona una intensidad de la señal en Signal strength:
Selecciona un estado de voz en Voice status, un estado de datos en Data status o ambos:
|
Battery | Puedes simular las propiedades de la batería de un dispositivo para ver el rendimiento de la app en diferentes condiciones. Para seleccionar un nivel de carga en Charge level, usa el control deslizante. Selecciona un valor de conexión del cargador en Charger connection:
Selecciona un valor de estado de la batería en Battery health:
Selecciona un valor de estado de la batería en Battery status:
|
Cámara | Puedes cargar imágenes en la escena simulada cuando abres la cámara del emulador. Para obtener más información, consulta Cómo agregar imágenes aumentadas a la escena en la documentación de ARCore. |
Teléfono | El emulador te permite simular llamadas telefónicas y mensajes de texto entrantes. Para iniciar una llamada al emulador, haz lo siguiente:
Para enviar un mensaje de texto al emulador:
|
Directional Pad | Si el AVD tiene habilitado el mando de dirección en el perfil de hardware, puedes usar los controles de este mando con el emulador. Sin embargo, no todos los dispositivos admiten el mando de dirección (por ejemplo, los relojes Android). Los botones simulan las siguientes acciones: ![]() |
Micrófono | Cuando se activa Virtual microphone uses host audio input, el emulador recibe entradas de audio del micrófono del host. De lo contrario, el emulador no recibirá ninguna entrada de audio. En este momento, no están implementadas las opciones Virtual headset plug inserted, Virtual headset has microphone y Voice Assist. |
Huella digital | Con este control, se pueden simular 10 escaneos de huellas digitales diferentes. Puedes usarlo para probar la integración de huellas digitales en tu app. Esta función está inhabilitada para Android 5.1 (nivel de API 22) y versiones anteriores, y Wear OS. Para simular un escaneo de huella digital en el dispositivo virtual:
|
Virtual sensors > Device Pose |
Este control te permite probar tu app en caso de que cambie la posición o la orientación (o ambas) del dispositivo. Por ejemplo, puedes simular gestos como inclinación y rotación. El acelerómetro no realiza un seguimiento de la posición absoluta del dispositivo; solo detecta cuándo se produce un cambio. El control simula la forma en que responderían el acelerómetro y el magnetómetro si movieras o rotaras un dispositivo real. Debes habilitar el sensor acelerómetro en tu AVD para usar este control. El control informa eventos El control también informa eventos Para rotar el dispositivo sobre los ejes "x", "y" y "z", selecciona Rotate y realiza una de las siguientes acciones:
Consulta Cómo calcular la orientación del dispositivo para obtener más información sobre cómo se calculan los valores de Yaw, Pitch y Roll. Para mover el dispositivo de forma horizontal (x) o vertical (y), selecciona Move y realiza una de las siguientes acciones:
Para colocar el dispositivo a 0, 90, 180 o 270 grados, haz lo siguiente:
A medida que ajustes el dispositivo, también cambiarán los valores en los campos Resulting values. A estos valores puede acceder una app. Para obtener más información sobre estos sensores, consulta Información general de sensores, Sensores de movimiento y Sensores de posición. |
Virtual sensors > Additional sensors | El emulador puede simular varios sensores de posición y entorno, y te permite ajustar los siguientes sensores para poder probarlos con tu app:
Para obtener más información sobre estos sensores, consulta Información general de sensores, Sensores de posición y Sensores ambientales. |
Informe de errores | Si tienes problemas con el emulador, puedes preparar y enviar un informe de errores. El emulador recopila automáticamente capturas de pantalla, registros y otros datos para el informe de errores. |
Grabación y reproducción | Consulta Grabación de pantalla. |
Google Play | Cuando la imagen del sistema del AVD incluye la app de Play Store, esta muestra la información de la versión de Servicios de Google Play. |
Settings > General |
|
Settings > Proxy | De forma predeterminada, el emulador usa la configuración de proxy HTTP de Android Studio. Esta pantalla te permite definir de forma manual una configuración de proxy HTTP para el emulador. Para obtener más información, consulta Cómo usar el emulador con un proxy. |
Settings > Advanced |
|
Help > Keyboard Shortcuts | En este panel, se incluye una lista completa de combinaciones de teclas para usar en el emulador. Si quieres abrir el panel mientras trabajas en el emulador, presiona F1 (Cmd+/ en macOS). Para que funcionen las combinaciones de teclas, la opción Send keyboard shortcuts del panel de configuración General debe estar definida como Emulator controls (default). |
Help > Emulator Help | Si quieres consultar la documentación en línea del emulador, haz clic en Documentation. Para enviar un error relacionado con el emulador, haz clic en Send feedback. Para obtener más información, descubre cómo informar errores del emulador. |
Help > About | Consulta el puerto de El número de serie del emulador es emulator-adb_port. Puedes especificarlo, por ejemplo, como opción de línea de comandos |
Cómo iniciar el emulador sin iniciar una app
En ocasiones, es posible que necesites iniciar el emulador sin ejecutar una app, por ejemplo, si solo quieres ver cómo dos dispositivos emuladores interactúan entre sí cuando se vinculan por Bluetooth. Para iniciar el emulador sin iniciar una app, sigue estos pasos:
- Abre el Administrador de dispositivos.
- Haz doble clic en un AVD o selecciona un AVD y, luego, haz clic en Run
. Se cargará Android Emulator.
Mientras esté activo el emulador, podrás ejecutar proyectos de Android Studio y elegir el emulador como dispositivo de destino. También puedes instalar uno o más APKs en el emulador, como se describe en la siguiente sección, y luego ejecutarlos.
Cómo instalar y agregar archivos
Si quieres usar una app que no está disponible en Google Play Store en el emulador, puedes instalar el archivo APK manualmente. Para instalar un archivo APK en el dispositivo emulado, arrastra un archivo hasta la pantalla del emulador. Aparecerá el diálogo de APK Installer. Cuando finalice la instalación, verás la app en la lista correspondiente.
Si quieres agregar un archivo al dispositivo emulado, arrastra el archivo hasta la pantalla del emulador.
Se colocará en el directorio /sdcard/Download/
y podrás verlo en Android Studio con el explorador de archivos de dispositivos, o bien buscarlo desde el dispositivo con las apps Descargas o Archivos, según la versión.
Instantáneas
Una instantánea es una imagen almacenada de un AVD (Android Virtual Device) que conserva todo el estado del dispositivo en el momento en que se guardó, lo que incluye la configuración del SO, el estado de la app y los datos del usuario. Puedes cargar una instantánea para restablecer el estado guardado del sistema. Esto te permitirá ahorrar tiempo de espera mientras se reinicien el sistema operativo y las apps en el dispositivo virtual, y te evitará el esfuerzo de restablecer el estado de la app en el que desees reanudar las pruebas. Iniciar un dispositivo virtual con la carga de una instantánea es muy parecido a activar un dispositivo físico tras una suspensión, a diferencia de iniciarlo después de que estuvo apagado.
Para cada AVD, puedes tener una instantánea de Quick Boot, o inicio rápido, y cualquier cantidad de instantáneas generales.
La forma más sencilla de aprovechar las instantáneas es usar las de Quick Boot: de forma predeterminada, cada AVD está configurado para guardar automáticamente una instantánea de Quick Boot al salir y para cargar una instantánea de Quick Boot durante el inicio.
La primera vez que se inicia un AVD, debe realizar un inicio en frío, al igual que cuando se enciende un dispositivo. Si está habilitada la función Quick Boot, se cargarán todos los inicios posteriores desde la instantánea especificada y se restaurará el estado guardado del sistema en esa instantánea.
Las instantáneas son válidas para la imagen del sistema, la configuración de AVD y las funciones del emulador con las que se guardan. Cuando realices un cambio en cualquiera de estas áreas, dejarán de ser válidas todas las instantáneas del AVD afectado. Cualquier actualización de Android Emulator, la imagen del sistema o la configuración del AVD restablecerá el estado guardado del AVD. Por lo tanto, la próxima vez que inicies el AVD, deberás realizar un inicio en frío.
La mayoría de los controles para guardar, cargar y administrar instantáneas se encuentran en las pestañas Snapshots y Settings del panel Snapshots. Si ejecutas el emulador en una ventana de herramientas en Android Studio, aparecerá el botón Snapshots en la barra de herramientas del emulador. Si ejecutas el emulador en una ventana independiente fuera de Android Studio, el panel Snapshots se encuentra en la ventana Extended controls.
También puedes controlar las opciones de la función Quick Boot cuando inicias el emulador desde la línea de comandos.
Cómo guardar instantáneas de Quick Boot
Puedes especificar si el emulador debe guardar automáticamente una instantánea cuando la cierras. Para controlar este comportamiento, haz lo siguiente:
- Abre la configuración de las instantáneas. Si el emulador está incorporado en Android Studio, haz clic en Snapshots en la barra de herramientas. Si el emulador se encuentra en una ventana independiente, abre la ventana Extended controls.
- En la categoría de controles Snapshots, navega a la pestaña Settings.
Usa el menú Auto-save current state to Quickboot para seleccionar una de las siguientes opciones:
Yes: Siempre guarda una instantánea de AVD cuando cierras el emulador. Es el valor predeterminado.
No: No guarda una instantánea AVD cuando cierras el emulador.
Tu elección se aplica solo al AVD actualmente abierto. No puedes guardar instantáneas si el ADB no tiene conexión (por ejemplo, cuando se está iniciando el AVD).
Cómo guardar instantáneas generales
Si bien solo puedes tener una instantánea de Quick Boot para cada AVD, sí puedes guardar varias instantáneas generales.
Para guardar una instantánea general, abre el panel Snapshots y haz clic en el botón Take snapshot, ubicado en la esquina inferior derecha.
Si quieres editar el nombre y la descripción de la instantánea seleccionada, haz clic en el botón de edición , en la parte inferior de la ventana.
Cómo borrar una instantánea
Para borrar una instantánea de forma manual, abre el panel Snapshots, selecciona la instantánea y haz clic en el botón de borrado en la parte inferior del panel.
También puedes especificar si deseas que el emulador borre automáticamente las instantáneas cuando no sean válidas, por ejemplo, si cambian la configuración de AVD o del emulador. De forma predeterminada, el emulador te preguntará si quieres borrar las instantáneas no válidas. Puedes cambiar esta configuración con el menú Delete invalid snapshots, en la pestaña Settings del panel Snapshots.
Cómo cargar una instantánea
Para cargar una instantánea en cualquier momento, abre el panel Snapshots del emulador, selecciona la categoría Snapshots, elige una instantánea y haz clic en el botón de carga ubicado en la parte inferior del panel.
En Android Studio 3.2 y versiones posteriores, cada configuración del dispositivo incluye el control Boot option en el diálogo Virtual Device Configuration de las opciones avanzadas. Puedes usar el control para especificar qué instantánea cargar al iniciar ese AVD.
Cómo inhabilitar Quick Boot
Si deseas desactivar Quick Boot para que tu AVD siempre realice un inicio en frío, sigue estos pasos:
- Selecciona Tools > Device Manager y haz clic en Edit this AVD
.
- Haz clic en Show Advanced Settings y desplázate hacia abajo hasta Emulated Performance.
- Selecciona Cold boot.
Cómo realizar un inicio en frío una sola vez
En lugar de inhabilitar Quick Boot por completo, puedes realizar un solo inicio en frío haciendo clic en Cold Boot Now en el menú del AVD, en Device Manager.
Requisitos y solución de problemas de instantáneas
- Las instantáneas no funcionan con Android 4.0.4 (nivel de API 15) ni versiones anteriores.
- Las instantáneas no funcionan con imágenes de sistema ARM para Android 8.0 (nivel de API 26).
- Si no se inicia el emulador desde una instantánea, selecciona Cold Boot Now para el AVD en el Administrador de dispositivos y envía un informe de errores.
- Las instantáneas no son confiables cuando está habilitado el procesamiento de software. Si no funcionan las instantáneas, haz clic en Edit this AVD
en el Administrador de dispositivos y cambia la configuración de Graphics a Hardware o Automatic.
- Cargar o guardar una instantánea es una operación que requiere mucha memoria. Si no tienes suficiente memoria RAM libre cuando comienza una operación de carga o guardado, el sistema operativo podría pasar el contenido de la memoria RAM al disco duro, lo que puede ralentizar en gran medida la operación. Si notas que las operaciones de carga o guardado de instantáneas son muy lentas, puedes liberar memoria RAM para acelerarlas. Cerrar aplicaciones que no son esenciales para tu trabajo es una buena forma de liberar espacio en la memoria RAM.
Wi-Fi
Cuando se usa un AVD con un nivel de API 25 o posterior, el emulador proporciona un punto de acceso Wi-Fi simulado ("AndroidWifi"), y Android se conecta automáticamente a él.
Para inhabilitar Wi-Fi en el emulador, ejecútalo con el parámetro de línea de comandos -feature -Wifi
.
Limitaciones
Android Emulator no incluye hardware virtual para lo siguiente:
- Bluetooth
- NFC
- Inserción/expulsión de tarjetas SD
- Auriculares conectados a dispositivos
- USB
El emulador de reloj para Wear OS no incluye el botón Recientes (Apps recientes), el pad direccional ni el sensor de huellas dactilares.