Cómo configurar la aceleración de hardware para Android Emulator

El emulador funciona mejor si puede usar el hardware de la máquina, como la CPU, la GPU y el módem, en lugar de ejecutarse como software puro. La capacidad de usar el hardware de la máquina para mejorar el rendimiento se denomina aceleración de hardware.

El emulador puede usar la aceleración de hardware para mejorar la experiencia de dos maneras principales:

• Aceleración de gráficos para una mejor renderización de la pantalla
• Aceleración de máquina virtual (VM) para mejorar la velocidad de ejecución

La aceleración de hardware está habilitada de forma predeterminada en la mayoría de las máquinas. Si no está habilitada en la tuya, en esta página se describe cómo configurar la aceleración de gráficos y de máquina virtual (VM) para obtener un mayor rendimiento del emulador.

Cómo configurar la aceleración de gráficos

Los dispositivos Android usan OpenGL para sistemas integrados (OpenGL ES o GLES) y las APIs de Vulkan para renderizar gráficos en la pantalla. La aceleración de gráficos permite usar el hardware de tu computadora (por lo general, la GPU) para acelerar el procesamiento. Si bien se recomienda la aceleración de hardware para mejorar el rendimiento, es posible que debas usar el modo de software si tu computadora no es compatible debido a la compatibilidad con el controlador de gráficos o la falta de requisitos de imagen del sistema.

Cuando creas un dispositivo virtual de Android (AVD) en el Administrador de AVD, puedes especificar si el emulador usa la renderización de hardware o software. En el modo automático, el emulador decide si usar aceleración de gráficos de hardware o software en función de tu computadora. También puedes anular la configuración si inicias el emulador desde la línea de comandos.

Cómo configurar la aceleración de gráficos en el Administrador de AVD

Si quieres configurar la aceleración de gráficos para un AVD, sigue estos pasos:

1. Abre el Administrador de dispositivos.
2. Crea un AVD nuevo o edita uno existente.
3. En la ventana Configuration, busca la sección Emulated Performance en la pestaña Additional Settings.
4. Selecciona un valor para la opción Aceleración de gráficos.
5. Haz clic en Finish.

Cómo configurar la aceleración de gráficos desde la línea de comandos

Para especificar un tipo de aceleración de gráficos al ejecutar un AVD desde la línea de comandos, incluye la opción -gpu, como se muestra en el siguiente ejemplo:

emulator -avd avd_name -gpu mode [{-option [value]} ... ]

Se puede establecer una de las siguientes opciones para el valor de mode:

• auto: Permite que el emulador elija entre aceleración de gráficos de hardware o software según el AVD, la configuración de la computadora y las métricas de calidad.
• host: Usa la GPU de tu computadora para acelerar el hardware. Por lo general, esta opción proporciona la calidad de gráficos y el rendimiento más altos para el emulador y puede habilitar MoltenVK en macOS para la renderización acelerada de Vulkan. Sin embargo, si tienes problemas con la emulación de gráficos, es posible que debas cambiar a la renderización de software.
• swiftshader_indirect: Usa una variante compatible con Quick Boot de SwiftShader para renderizar gráficos mediante la aceleración de software. Esta opción es una buena alternativa al modo host si tu computadora no puede usar la aceleración de hardware.

Nota: Si habilitas una opción de aceleración de gráficos que tu computadora no admite, es probable que veas imágenes incorrectas durante la emulación.

Las siguientes opciones de mode dejaron de estar disponibles:

• swiftshader: Obsoleta en la versión 27.0.2. Se usa swiftshader_indirect en su lugar.
• angle: Obsoleta en la versión 27.0.2. Usa swiftshader_indirect en su lugar.
• mesa: Obsoleta en la versión 25.3. Usa swiftshader_indirect en su lugar.
• guest: Obsoleto para el nivel de API 28 y versiones posteriores. Se usa swiftshader_indirect en su lugar.
• angle_indirect: Obsoleta en la versión 34.2.14. Se usa swiftshader_indirect en su lugar.

Cómo configurar la aceleración de VM

La aceleración de VM utiliza el procesador de la computadora para mejorar significativamente la velocidad de ejecución del emulador. Una herramienta llamada hipervisor administra esta interacción utilizando las extensiones de virtualización que brinda el procesador de la computadora. En esta sección, se describen los requisitos para usar la aceleración de VM y cómo configurar esta función en cada sistema operativo.

Requisitos generales

Para usar la aceleración de VM con el emulador, tu computadora debe cumplir con los requisitos generales descritos en esta sección y con otros específicos de tu sistema operativo.

Requisitos del entorno de desarrollo

Para usar la aceleración de VM, el entorno de desarrollo debe cumplir con los siguientes requisitos:

• Herramientas del SDK: Versión mínima, 17; versión recomendada, 26.1.1 o posterior

• AVD: En la siguiente tabla, se describe la versión obligatoria de Android.

  Arquitectura de la CPU	Requisito de imagen del sistema
  X86_64	Imágenes del sistema de x86 o x86_64 para Android 2.3.3 (nivel de API 10) y versiones posteriores
  ARM64	Imágenes del sistema de arm64-v8a para Android 5.0 (nivel de API 21) y versiones posteriores

  Advertencia: Los AVDs que no cumplen con los requisitos, como las imágenes del sistema basadas en ARM o MIPS en CPUs Intel o AMD, no pueden usar la aceleración de VM que se describe en esta página.

Requisitos de extensión de virtualización

Además de los requisitos del entorno de desarrollo, el procesador de la computadora debe admitir extensiones de virtualización. Los procesadores compatibles son los siguientes:

• Procesadores Intel con tecnología de virtualización Intel (VT-x, vmx), como Intel Core iX e Intel Core Ultra
• Procesadores AMD con AMD-V (SVM), como procesadores AMD Ryzen
• Apple Silicon

Requisitos adicionales para procesadores Intel y AMD:

Se requiere la traducción de direcciones de segundo nivel (Intel EPT o AMD RVI) para procesadores Intel y AMD. La mayoría de los procesadores Intel y AMD modernos admiten la traducción de direcciones de segundo nivel. Es posible que solo los procesadores Intel o AMD de primera generación que ofrecen extensiones de virtualización no tengan traducciones de páginas de segundo nivel.

Si no sabes con certeza si tu procesador admite las extensiones requeridas, consulta las especificaciones en el sitio del fabricante. Si tu procesador no admite estas extensiones, no podrás usar la aceleración de VM.

Nota: En plataformas para PC, por lo general, las extensiones de virtualización se habilitan a través del BIOS y se pueden desactivar de forma predeterminada. Consulta la documentación del proveedor del sistema para obtener información sobre cómo habilitar las extensiones de virtualización.

Restricciones

La aceleración de VM tiene las siguientes restricciones:

• No puedes ejecutar un emulador acelerado por VM dentro de otra VM, como una alojada por VirtualBox, VMWare o Docker. Debes ejecutar un emulador acelerado por VM directamente en tu computadora host.
• Según tu sistema operativo y tu hipervisor, quizás no puedas ejecutar software que use otra tecnología de virtualización al mismo tiempo que ejecutas un emulador acelerado por VM. Algunos ejemplos de este tipo de software incluyen, entre otros, las soluciones de máquinas virtuales, algunos programas antivirus y algunas soluciones antitrampas. La situación se observa mayormente en Windows con Hyper-V desactivado. La mayor parte de ese software puede coexistir con el emulador de Android sin ningún problema. Sin embargo, cuando se producen conflictos, se recomienda no ejecutar el emulador acelerado por VM al mismo tiempo con ese software.

Acerca de los hipervisores

La aceleración de VM requiere un hipervisor, una herramienta que usa extensiones de virtualización proporcionadas por el procesador de la computadora.

Sin un hipervisor y una aceleración de VM, el emulador debe traducir el código máquina desde la VM bloque por bloque para adaptarse a la arquitectura de la computadora host, un proceso que puede ser bastante lento. Con un hipervisor, la VM y la arquitectura de la computadora host coinciden, por lo que el emulador puede ejecutar código de manera directa en el procesador host con el hipervisor. Esta mejora aumenta considerablemente la velocidad y el rendimiento del emulador.

Debes elegir el hipervisor que mejor se adapte a tus necesidades según el sistema operativo y la configuración de la computadora. Para obtener más información, consulta las siguientes secciones:

• Cómo configurar la aceleración de VM en Windows
• Cómo configurar la aceleración de VM en macOS
• Cómo configurar la aceleración de VM en Linux

Cómo comprobar si hay un hipervisor instalado

Puedes usar la opción de línea de comandos -accel-check del emulador para comprobar si hay un hipervisor instalado actualmente en la computadora.

En los siguientes ejemplos, se muestra cómo usar la opción accel-check del emulador. En cada ejemplo, Sdk representa la ubicación del SDK de Android:

Windows:

c:\Users\janedoe\AppData\Local\Android> Sdk\emulator\emulator -accel-check
accel:
0
WHPX(10.0.22631) is installed and usable.
accel

Hay varias opciones de hipervisor en Windows. Lo que ves puede ser diferente al ejemplo. Por ejemplo, es posible que veas una de las siguientes palabras clave en el mensaje: AEHD, GVM (nombre anterior de AEHD).

macOS:

janedoe-macbookpro:Android janedoe$ ./Sdk/emulator/emulator -accel-check
accel:
0
Hypervisor.Framework OS X Version 13.2
accel

Linux:

janedoe:~/Android$ ./Sdk/emulator/emulator -accel-check
accel:
0
KVM (version 12) is installed and usable.

Cómo configurar la aceleración de VM en Windows

En Windows, la aceleración de VM puede usar uno de estos dos hipervisores:

• Windows Hypervisor Platform (WHPX)
• El controlador de hipervisor de Android Emulator (AEHD)

La plataforma del hipervisor de Windows usa el hipervisor Hyper-V proporcionado por Windows y ofrece la mejor compatibilidad con inestabilidad reducida. Si es posible, debes usar WHPX.

Si tu sistema no es compatible con WHPX o si tienes otras inquietudes sobre su uso, puedes usar el controlador del hipervisor de Android Emulator.

Cómo configurar la aceleración de VM utilizando Windows Hypervisor Plaftorm

Para que puedas habilitar WHPX, tu computadora debe cumplir con los siguientes requisitos:

• Procesadores Intel: Compatibilidad con las funciones de Tecnología de virtualización (VT-x), Tablas de páginas extendidas (EPT) y de Invitado sin restricciones (UG). La opción VT-x debe estar habilitada en la configuración del BIOS de la computadora.
• Procesadores AMD: Se recomienda el procesador AMD Ryzen (la virtualización o la SVM deben estar habilitadas en la configuración del BIOS de la computadora).
• Android Studio 3.2 Beta 1 o versiones posteriores.
• Android Emulator versión 27.3.8 o posteriores.
• Windows 10 o versiones posteriores.

Para instalar WHPX en Windows, sigue estos pasos:

1. En el escritorio de Windows, haz clic en el ícono de Windows para abrir el menú Inicio.

2. En la barra de búsqueda, escribe Activar o desactivar las funciones de Windows.

   Debería aparecer el panel de control Activar o desactivar las funciones de Windows, que debería estar seleccionado.

3. Presiona la tecla Intro o haz clic en Activar o desactivar las funciones de Windows para iniciar el panel de control.

4. Marca la casilla junto a Plataforma del hipervisor de Windows.

   

5. Haz clic en OK.

6. Una vez que la instalación haya finalizado, reinicia la computadora.

Cómo configurar la aceleración de VM utilizando el controlador de hipervisor de Android Emulator (AEHD) en Windows

Antes de que puedas instalar y usar el controlador de hipervisor de Android Emulator, tu computadora debe cumplir con los siguientes requisitos:

• Procesadores Intel o AMD con extensión de virtualización

• Windows 11 o Windows 10 de 64 bits (las versiones de 32 bits no son compatibles)

  Los usuarios de Windows 8.1, Windows 8 y Windows 7 pueden seguir usando AEHD 1.7 o versiones anteriores. Sin embargo, no se brindará asistencia para tales situaciones.

• Las funciones que también usan el hipervisor Hyper-V de Windows deben estar inhabilitadas en el diálogo Características de Windows.

  Algunos componentes de Windows también activan y usan el hipervisor Hyper-V de Windows, incluso cuando la plataforma del hipervisor de Windows no está seleccionada en el diálogo Características de Windows. Estas incluyen funciones de seguridad como Hyper-V, aislamiento de núcleos y otras. Ten en cuenta que la función Hyper-V NO es la misma que la del hipervisor Hyper-V. Si necesitas estas funciones, usa WHPX en su lugar.

En los procesadores AMD, el controlador de hipervisor de Android Emulator se puede instalar a través de SDK Manager en Android Studio 4.0 Canary 5 o versiones posteriores.

En los procesadores Intel, el controlador de hipervisor de Android Emulator se puede instalar a través de SDK Manager en Android Studio Flamingo o versiones posteriores.

Para instalar desde SDK Manager, sigue estos pasos:

1. Selecciona Tools > SDK Manager.
2. Haz clic en la pestaña SDK Tools y selecciona Android Emulator hypervisor driver.
3. Haz clic en OK para descargar y, luego, instalar el controlador de hipervisor de Android Emulator.

4. Después de la instalación, confirma que el controlador funcione correctamente con el siguiente comando de línea de comandos:

   AEHD 2.1 y versiones posteriores

   sc query aehd
   

   Un mensaje de estado incluye la siguiente información:

   SERVICE_NAME: aehd
          ...
          STATE              : 4  RUNNING
          ...
   

   El siguiente mensaje de error significa que la extensión de virtualización no está habilitada en el BIOS o que Hyper-V no está inhabilitado:

   SERVICE_NAME: aehd
          ...
          STATE              : 1  STOPPED
          WIN32_EXIT_CODE    : 4294967201 (0xffffffa1)
          ...
   

   AEHD 2.0 y versiones anteriores

   sc query gvm
   

   Un mensaje de estado incluye la siguiente información:

   SERVICE_NAME: gvm
          ...
          STATE              : 4  RUNNING
          ...
   

   El siguiente mensaje de error significa que la extensión de virtualización no está habilitada en el BIOS o que Hyper-V no está inhabilitado:

   SERVICE_NAME: gvm
          ...
          STATE              : 1  STOPPED
          WIN32_EXIT_CODE    : 4294967201 (0xffffffa1)
          ...
   

El controlador de hipervisor de Android Emulator también se puede descargar y, luego, instalar desde GitHub. Después de descomprimir el paquete del controlador, ejecuta silent_install.bat en una línea de comandos con privilegios de administrador.

Desinstala el controlador de hipervisor de Android Emulator con los siguientes comandos en una línea de comandos con privilegios de administrador:

AEHD 2.1 y versiones posteriores

   sc stop aehd
   sc delete aehd

AEHD 2.0 y versiones anteriores

   sc stop gvm
   sc delete gvm

Nota: Cierra los emuladores de x86 antes de desinstalar el controlador de hipervisor de Android Emulator para AMD.

Cómo configurar la aceleración de VM en macOS

En macOS, Android Emulator usa el Hypervisor.Framework integrado, que requiere macOS v10.10 (Yosemite) y versiones posteriores. Sin embargo, es posible que Android Studio requiera una versión posterior para macOS. En esos casos, sigue los requisitos del sistema de Android Studio.

Nota: No se recomienda instalar ni usar Intel HAXM en macOS. El emulador ya no es compatible con Intel HAXM en macOS.

Cómo configurar la aceleración de VM en Linux

Los sistemas basados en Linux admiten la aceleración de VM mediante el paquete de software KVM. Sigue las instrucciones para instalar KVM en tu sistema Linux y, luego, verifica que KVM esté habilitado. Para sistemas Ubuntu, consulta Instalación de KVM en Ubuntu.

Requisitos

Para ejecutar KVM, se requieren permisos del usuario específicos. Asegúrate de tener los permisos suficientes que se especifican en las instrucciones de instalación de KVM.

Además, si quieres usar la aceleración de VM en Linux, tu computadora debe cumplir con estos requisitos:

• Para procesadores Intel, compatibilidad con la tecnología de virtualización (VT-x), las características de Intel EM64T (Intel 64) y la funcionalidad Execute Disable (XD) Bit habilitada
• Para procesadores AMD: Compatibilidad con AMD Virtualization (AMD-V)

Cómo comprobar si KVM está instalado en Linux

Puedes usar la opción de línea de comandos -accel-check del emulador para comprobar si KVM está instalado. Como alternativa, puedes instalar el paquete cpu-checker que contiene el comando kvm-ok.

En el siguiente ejemplo, se muestra cómo usar el comando kvm-ok:

1. Instala el paquete cpu-checker:

   sudo apt-get install cpu-checker
   egrep -c '(vmx|svm)' /proc/cpuinfo
   

   Si el resultado es 1 o mayor, se admite la virtualización. Si el resultado es 0, significa que tu CPU no admite la virtualización de hardware.

2. Ejecuta el comando kvm-ok:

   sudo kvm-ok
   

   Resultado esperado:

   INFO: /dev/kvm exists
   KVM acceleration can be used
   

   Si recibes el siguiente error, significa que aún puedes ejecutar máquinas virtuales. Sin embargo, la máquina virtual es más lenta sin las extensiones de KVM.

   INFO: Your CPU does not support KVM extensions
   KVM acceleration can NOT be used
   

Cómo instalar KVM en Linux

Usa el siguiente comando para instalar KVM:

Cosmic (18.10) o versiones posteriores:

sudo apt-get install qemu-kvm libvirt-daemon-system libvirt-clients bridge-utils

Lucid (10.04) o versiones posteriores:

sudo apt-get install qemu-kvm libvirt-bin ubuntu-vm-builder bridge-utils

Karmic (9.10) o versiones anteriores:

sudo aptitude install kvm libvirt-bin ubuntu-vm-builder bridge-utils

Guía para la desinstalación de Intel HAXM

A partir del emulador 33.x.x.x, HAXM dejó de estar disponible, ya que Intel descontinuó el desarrollo de HAXM. El controlador de hipervisor de Android Emulator (AEHD) reemplaza a Intel HAXM en los procesadores Intel.

Se recomienda quitar por completo Intel HAXM de tu sistema Windows, a menos que tengas otro software instalado que dependa de HAXM y decidas conservar Intel HAXM y administrarlo por tu cuenta.

Para desinstalar Intel HAXM, sigue estos pasos:

Comprueba si Intel HAXM está instalado

Nota: No confíes en el estado del paquete de Intel HAXM desde SDK Manager. Es posible que SDK Manager no verifique la existencia de Intel HAXM.

Para determinar si Intel HAXM está instalado en tu sistema Windows, abre una consola de comandos de Windows y ejecuta el siguiente comando:

   sc query intelhaxm

Si Intel HAXM está instalado y en ejecución, deberías ver el siguiente mensaje en el resultado del comando.

Si Intel HAXM está instalado, pero inhabilitado, deberías ver el siguiente mensaje en el resultado del comando.

En ambos casos, independientemente de si Intel HAXM está en ejecución o inhabilitado, se instala. Debes ir al siguiente paso para continuar con la desinstalación de Intel HAXM.

Si Intel HAXM no está instalado, deberías ver el siguiente mensaje.

Desinstala Intel HAXM usando SDK Manager de Android Studio

Abre SDK Manager desde Android Studio, ve a la pestaña "SDK Tools" y, luego, navega a la línea "Intel x86 Emulator Accelerator (HAXM instalador) - obsoleto". Debería verse como en la siguiente captura de pantalla.

Desmarca la casilla de verificación como se muestra en la siguiente captura de pantalla.

Haz clic en el botón "Apply" y debería aparecer el siguiente diálogo.

Cuando se desinstale correctamente Intel HAXM, deberías ver lo siguiente. Se completó la desinstalación y puedes detenerla aquí.

En caso de errores, continúa con el siguiente paso.

Desinstala Intel HAXM usando la "configuración" de Windows.

Abre la "Configuración" de Windows y navega hasta "Aplicaciones > Aplicaciones instaladas".

Busca la entrada "Intel Hardware Accelerated Execution Manager" y haz clic en "Desinstalar", como se muestra en la siguiente captura de pantalla.

El desinstalador Intel HAXM debería ejecutarse e informar el resultado. Si la desinstalación se realiza correctamente, consulta Borra el paquete del instalador de Intel HAXM. De lo contrario, continúa con el siguiente paso.

Cómo desinstalar aplicaciones con la línea de comandos

Nota: Este es un proceso manual mediante la ejecución de los comandos que requieren el privilegio de administrador. Abre una consola de comandos de Windows como administrador y ejecuta los siguientes comandos.

1. Ejecuta "sc stop intelhaxm" para detener el servicio Intel HAXM. Deberías ver el siguiente resultado.

2. Ejecuta "sc delete intelhaxm" para borrar el servicio Intel HAXM. Deberías ver el siguiente resultado.

3. Ve a Borrar paquete del instalador de Intel HAXM.

Borra el paquete del instalador de Intel HAXM.

Este paso solo es necesario cuando se desinstala Intel HAXM mediante la "configuración" o la línea de comandos de Windows. Sin este paso, es posible que SDK Manager de Android Studio continúe mostrando Intel HAXM como "Instalado".

El paquete del instalador se encuentra en <Your Android SDK folder>\extras\intel. De forma predeterminada, el SDK de Android se instalará en "C:\Users\<Your Windows User ID >\AppData\Local\Android\Sdk". Consulta un ejemplo de la siguiente captura de pantalla.