Cómo habilitar la aceleración de hardware con emuladores de Android (Hyper-V y AEHD)

Con Visual Studio, puede probar y depurar fácilmente la aplicación .NET MAUI para Android en emuladores para situaciones en las que un dispositivo Android no está disponible. Sin embargo, si la aceleración de hardware no está disponible o habilitada, el emulador se ejecutará muy lentamente. Para mejorar significativamente el rendimiento del emulador, habilite la aceleración de hardware y use imágenes de dispositivo virtual adecuadas para la arquitectura del procesador. Para obtener más información, consulte Configuración de la aceleración de hardware para Android Emulator en developer.android.com.

El emulador proporciona funcionalidades de red versátiles que se pueden usar para diferentes propósitos, incluida la conexión a un emulador que se ejecuta en un equipo Mac desde dentro de una máquina virtual (VM) Windows. Para obtener más información, consulte Conectar a un emulador de Android en un equipo Mac desde dentro de una máquina virtual Windows.

Aceleración de emuladores de Android en Windows

Las tecnologías de virtualización siguientes están disponibles para la aceleración de Android Emulator:

  • La plataforma de hipervisor de Windows (WHPX). Hyper-V es una característica de virtualización de Windows que permite ejecutar sistemas de equipos virtualizados en un equipo host físico.
  • Controlador de hipervisor de Android Emulator (AEHD).

Nota:

El Administrador de ejecución acelerada por hardware de Intel (HAXM) está en desuso del emulador 33.x.x.x y se ha reemplazado por AEHD en procesadores Intel. Para obtener información sobre el uso de HAXM en el emulador 32.x.x.x y versiones inferiores, consulte Configuración de la aceleración de máquinas virtuales con Intel HAXM en Windows en developer.android.com.

Para obtener la mejor experiencia en Windows, se recomienda usar WHPX para acelerar el emulador de Android. Si WHPX no está disponible en el equipo, se puede usar AEHD. Android Emulator usa automáticamente la aceleración de hardware si se cumplen los criterios siguientes:

  • La aceleración de hardware está disponible y habilitada en el equipo de desarrollo.
  • El emulador ejecuta una imagen del sistema creada para un dispositivo virtual basado en x86-64 o x86.

Importante

Un emulador acelerado de máquina virtual (VM) se puede ejecutar dentro de otra máquina virtual, incluido Microsoft Dev Box, siempre que la virtualización anidada esté habilitada en la máquina virtual.

Para obtener información sobre cómo iniciar y depurar con Android Emulator, vea Depuración en Android Emulator.

Aceleración con Hyper-V

Antes de habilitar Hyper-V, lea la sección siguiente para comprobar que su equipo es compatible con Hyper-V.

Comprobación de la compatibilidad con Hyper-V

Hyper-V se ejecuta en Windows Hypervisor Platform. Para usar Android Emulator con Hyper-V, el equipo debe cumplir los siguientes criterios para admitir Windows Hypervisor Platform:

  • El hardware del equipo debe cumplir los siguientes requisitos:

    • Una CPU AMD Ryzen o Intel de 64 bits con SLAT (Traducción de direcciones de segundo nivel).
    • Compatibilidad de CPU con la extensión del modo monitor de la máquina virtual (VT-c en CPU de Intel).
    • 4 GB de memoria, como mínimo.
  • En el BIOS del equipo, deben habilitarse los siguientes elementos:

    • Tecnología de virtualización (puede tener otra etiqueta según el fabricante de la placa base).
    • Prevención de ejecución de datos forzada mediante hardware.
  • El equipo debe ejecutar las versiones Enterprise, Pro o Education de Windows 11 o Windows 10 versión 1909 o posterior.

Para comprobar que el hardware y el software del equipo es compatible con Hyper-V, abra un símbolo del sistema y escriba el comando siguiente:

systeminfo

Si todos los requisitos de Hyper-V enumerados tienen un valor de , el equipo es compatible con Hyper-V. Por ejemplo:

Example of systeminfo output when checking Hyper-V support for .NET MAUI.

Si el resultado de Hyper-V indica que un hipervisor se está ejecutando actualmente, Hyper-V ya está habilitado.

Importante

Si Windows se ejecuta dentro de una máquina virtual, la virtualización anidada debe estar habilitada en el hipervisor de host.

Habilitación de la aceleración de Hyper-V en Windows

Si el equipo cumple los criterios mencionados anteriormente, siga estos pasos para la aceleración de Android Emulator con Hyper-V:

  1. Escriba características de windows en el cuadro de búsqueda de Windows y seleccione Activar o desactivar las características de Windows en los resultados de búsqueda. En el cuadro de diálogo Características de Windows, habilite Hyper-V y Windows Hypervisor Platform:

    Enabling Hyper-V and Windows Hypervisor Platform for .NET MAUI.

    Después de realizar estos cambios, reinicie el equipo.

    Importante

    En la actualización de octubre de 2018 de Windows 10 (RS5) y versiones posteriores, solo tiene que habilitar Hyper-V, ya que Windows Hypervisor Platform (WHPX) se usará automáticamente.

  2. Asegúrese de que el dispositivo virtual que creó en android Administrador de dispositivos es una imagen del sistema basada en x86-64 o x86. Si usa una imagen del sistema basada en Arm, el dispositivo virtual no se acelerará y se ejecutará lentamente.

Una vez habilitado Hyper-V, podrá ejecutar el emulador de Android acelerado.

Aceleración con AEHD

Si el equipo no admite Hyper-V, debe usar AEHD para acelerar android emulator. Antes de poder instalar y usar AEHD, lea la sección siguiente para comprobar que el equipo admite AEHD.

Comprobación de la compatibilidad con AEHD

El equipo debe cumplir los siguientes criterios para admitir AEHD:

  • Un procesador Intel o AMD con extensión de virtualización, que debe estar habilitado en el BIOS.
  • Windows 11, Windows 10, Windows 8 o Windows 7 de 64 bits.
  • Hyper-V debe desactivarse.

Nota:

Varias características de Windows habilitan Hyper-V implícitamente. Para obtener más información, consulte Comprobación doble al deshabilitar Hyper-V en developer.android.com.

Habilitación de la aceleración de AEHD en Windows

Si el equipo cumple los criterios anteriores, siga estos pasos para acelerar android emulator con AEHD:

  1. En Visual Studio, seleccione el elemento de menú Herramientas >> Android SDK Manager... .

  2. En la ventana SDK y herramientas de Android, seleccione la pestaña Herramientas .

  3. En la pestaña Herramientas, expanda Extras, marque la casilla del elemento Controlador de hipervisor (instalador) de Android Emulator y, a continuación, seleccione el botón Aplicar cambios :

    Installing AEHD through the Android SDK manager in Visual Studio.

    Nota:

    Como alternativa, AEHD se puede descargar e instalar desde GitHub. Después de desempaquetar el paquete de controladores, ejecute silent_install.bat en una línea de comandos con privilegios de administrador.

  4. Asegúrese de que el dispositivo virtual que creó en android Administrador de dispositivos es una imagen del sistema basada en x86-64 o x86. Si usa una imagen del sistema basada en Arm, el dispositivo virtual no se acelerará y se ejecutará lentamente.

Después de la instalación, confirme que el controlador funciona correctamente con el siguiente comando:

sc query aehd

Después de instalar y ejecutar AEHD, podrá ejecutar el emulador de Android acelerado.

Solución de problemas

Para obtener ayuda con la solución de problemas de aceleración de hardware, consulte la guía de solución de problemas de Android Emulator.