Como habilitar a aceleração de hardware com emuladores Android (Hyper-V & AEHD)

Com o Visual Studio, você pode facilmente testar e depurar seu aplicativo .NET MAUI para Android em emuladores para situações em que um dispositivo Android não está disponível. No entanto, se a aceleração de hardware não estiver disponível ou habilitada, o emulador será executado muito lentamente. Você pode melhorar significativamente o desempenho do emulador habilitando a aceleração de hardware e usando imagens de dispositivo virtual apropriadas para a arquitetura do processador. Para obter mais informações, consulte Configurar a aceleração de hardware para o emulador Android no developer.android.com.

O emulador fornece recursos de rede versáteis que podem ser usados para diferentes finalidades, incluindo a conexão com um emulador em execução em um Mac de dentro de uma máquina virtual (VM) do Windows. Para obter mais informações, consulte Conectar-se a um emulador Android em um Mac de dentro de uma máquina virtual do Windows.

Acelere emuladores Android no Windows

As tecnologias de virtualização a seguir estão disponíveis para acelerar o Android Emulator:

• A plataforma de hipervisor do Windows (WHPX). O Hyper-V é um recurso de virtualização do Windows que possibilita a execução de sistemas de computador virtualizados em um computador host físico.
• O driver de hipervisor do emulador Android (AEHD).

Observação

O Intel Hardware Accelerated Execution Manager (HAXM) foi preterido do emulador 33.x.x.x e foi substituído pelo AEHD nos processadores Intel. Para obter informações sobre como usar o HAXM no emulador 32.x.x.x e inferior, consulte Configurar a aceleração de VM usando o Intel HAXM no Windows no developer.android.com .

Para obter a melhor experiência no Windows, é recomendável usar o WHPX para acelerar o emulador Android. Se o WHPX não estiver disponível no computador, o AEHD poderá ser usado. O emulador Android usa automaticamente a aceleração de hardware se os seguintes critérios forem atendidos:

• A aceleração de hardware está disponível e habilitada em seu computador de desenvolvimento.
• O emulador está executando uma imagem do sistema criada para um dispositivo virtual baseado em x86-64 ou x86.

Importante

Um emulador acelerado de máquina virtual (VM) pode ser executado dentro de outra VM, incluindo o Microsoft Dev Box, desde que a virtualização aninhada esteja habilitada na VM.

Para obter informações sobre lançamento e depuração com o Android Emulator, confira Depurando no Android Emulator.

Acelere com o Hyper-V

Antes de habilitar o Hyper-V, leia a seção a seguir para verificar se seu computador tem suporte para ele.

Verificar o suporte para Hyper-V

O Hyper-V é executado na Plataforma de Hipervisor do Windows. Para usar o Android Emulator com o Hyper-V, o computador precisa atender aos seguintes critérios para dar suporte à Plataforma de Hipervisor do Windows:

• O hardware do computador deve atender aos seguintes requisitos:

  • Uma CPU Intel ou AMD Ryzen de 64 bits com SLAT (Conversão de Endereços de Segundo Nível).
  • Suporte da CPU para a Extensão do Modo de Monitor de VM (VT-c em CPUs Intel).
  • Mínimo de 4 GB de memória.

• Na BIOS do computador, os itens a seguir devem estar habilitados:

  • Tecnologia de virtualização (pode ter um rótulo diferente dependendo do fabricante da placa-mãe).
  • Prevenção de Execução de Dados Baseada em Hardware.

• Seu computador deve estar executando as versões Enterprise, Pro ou Education do Windows 11 ou Windows 10 Versão 1909 ou posterior.

Para verificar se o hardware e o software do computador são compatíveis com Hyper-V, abra um prompt de comando e digite o seguinte comando:

systeminfo

Se todos os requisitos listados do Hyper-V tiverem um valor de Sim, o computador poderá dar suporte a Hyper-V. Por exemplo:

Se o resultado do Hyper-V indicar que um hipervisor está em execução no momento, o Hyper-V já está habilitado.

Importante

Se o Windows estiver sendo executado dentro de uma máquina virtual, a virtualização aninhada deverá ser habilitada no hipervisor do host.

Habilitar a aceleração do Hyper-V no Windows

Se o computador atender aos critérios acima, use as seguintes etapas para acelerar o Android Emulator com o Hyper-V:

1. Insira recursos do windows na caixa de pesquisa do Windows e selecione Ativar ou desativar recursos do Windows nos resultados da pesquisa. Na caixa de diálogo Recursos do Windows, habilite Hyper-V e Plataforma de Hipervisor do Windows:

   

   Depois de fazer essas alterações, reinicie o computador.

   Importante

   Na atualização de outubro de 2018 do Windows 10 (RS5) e posteriores, será necessário habilitar somente o Hyper-V, já que ele usará o WHPX (Plataforma de Hipervisor do Windows) automaticamente.

2. Certifique-se de que o dispositivo virtual que criou no Gestor de dispositivos Android é uma imagem de sistema baseada em x86-64 ou x86. Se você usar uma imagem de sistema baseada em Arm, o dispositivo virtual não será acelerado e será executado lentamente.

Depois que o Hyper-V estiver habilitado, você poderá executar o emulador acelerado do Android.

Acelere com AEHD

Se o seu computador não suportar Hyper-V, você deve usar AEHD para acelerar o emulador Android. Antes de instalar e usar o AEHD, leia a seção a seguir para verificar se o computador oferece suporte a AEHD.

Verificar o suporte para AEHD

Seu computador deve atender aos seguintes critérios para oferecer suporte a AEHD:

• Um processador Intel ou AMD com extensão de virtualização, que deve ser ativado em seu BIOS.
• Windows 11, Windows 10, Windows 8 ou Windows 7 de 64 bits.
• O Hyper-V deve ser desativado.

Observação

Vários recursos do Windows habilitam o Hyper-V implicitamente. Para obter mais informações, consulte Verificação dupla ao desabilitar o Hyper-V no developer.android.com.

Habilitar a aceleração AEHD no Windows

Se o seu computador atender aos critérios acima, use as seguintes etapas para acelerar o emulador Android com AEHD:

1. No Visual Studio, selecione o item de menu Ferramentas > Android Android > SDK Manager...

2. Na janela SDKs e Ferramentas do Android, selecione a guia Ferramentas.

3. Na guia Ferramentas, expanda Extras, marque a caixa de seleção do item Driver do hipervisor do emulador Android (instalador) e selecione o botão Aplicar alterações:

   

   Observação

   Como alternativa, o AEHD pode ser baixado e instalado do GitHub. Depois de descompactar o pacote de driver, execute silent_install.bat em uma linha de comando com privilégios de administrador.

4. Certifique-se de que o dispositivo virtual que criou no Gestor de dispositivos Android é uma imagem de sistema baseada em x86-64 ou x86. Se você usar uma imagem de sistema baseada em Arm, o dispositivo virtual não será acelerado e será executado lentamente.

Após a instalação, confirme se o driver está funcionando corretamente usando o seguinte comando:

sc query aehd

Depois que o AEHD estiver instalado e em execução, você poderá executar seu emulador Android acelerado.

Solucionar problemas

Para obter ajuda para solucionar problemas de aceleração de hardware, confira o guia de solução de problemas do Android Emulator.