Emulador do Android

O emulador Android, que é produzido pelo Google, simula dispositivos Android em seu computador para que você possa testar seus aplicativos em uma variedade de dispositivos e níveis de API Android, sem precisar ter cada dispositivo físico. Ao implantar e testar seu aplicativo no emulador, você seleciona um dispositivo virtual pré-configurado ou personalizado, conhecido como um Dispositivo Virtual Android (AVD) que simula um dispositivo Android físico, como um telefone Pixel. Como alternativa, você pode implantar seu aplicativo em um dispositivo físico. Para obter mais informações sobre como implantar seu aplicativo em um dispositivo físico, consulte Configurar o dispositivo Android para depuração.

O emulador do Android é instalado pelo Visual Studio, e um AVD é criado quando você compila seu primeiro aplicativo .NET Multi-platform App UI (.NET MAUI) para Android. Para mais informações, consulte Criar seu primeiro aplicativo.

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 sua arquitetura de processador. Para obter mais informações, consulte Como habilitar a aceleração de hardware com emuladores Android.

Dispositivos Android físicos são emulados por AVDs, que especificam as características de versão e hardware do Android do dispositivo simulado. Para testar um aplicativo, crie AVDs que modelam cada dispositivo em que seu aplicativo foi projetado para ser executado. Cada AVD é executado como um dispositivo independente com seu próprio armazenamento para dados de usuário e dados de cartão SD. O emulador armazena os dados do usuário e os dados do cartão SD em uma pasta específica do AVD. Quando você inicia o emulador, ele carrega os dados do usuário e os dados do cartão SD da pasta AVD. Para obter informações sobre como gerenciar dispositivos virtuais, consulte Gerenciamento de dispositivos virtuais com o Gerenciador de Dispositivos Android. Para obter informações sobre como editar a configuração de um dispositivo virtual, consulte Editando as propriedades do dispositivo virtual Android.

Depois de criar um AVD, você poderá iniciar o emulador e depurar um aplicativo nele. Para obter mais informações, confira Depurar no emulador do Android. Depois que um aplicativo é instalado em um AVD, você pode executá-lo no dispositivo como executaria qualquer aplicativo em um dispositivo.

Além disso, o emulador fornece recursos de rede versáteis que podem ser usados para diferentes finalidades, incluindo a conexão a um emulador em execução em um Mac de dentro de uma VM (máquina virtual) 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.

Para obter informações sobre como diagnosticar problemas do emulador, consulte a solução de problemas do emulador do Android.

Usar o emulador

Quando o emulador android estiver em execução, use o ponteiro do mouse do computador para imitar o dedo na tela sensível ao toque, selecione itens de menu e campos de entrada e clique em botões e controles. Você pode digitar o emulador usando o teclado do computador ou usando o teclado na tela que aparece no emulador.

Ações comuns podem ser executadas no emulador por meio de seu painel no lado direito:

Ação	Ícone	Descrição
Fechar		Feche o emulador.
Minimizar		Minimize a janela do emulador.
Energia		Clique para ativar/desativar a tela. Clique e segure para ativar/desativar o dispositivo.
Aumentar o volume		Aumente o volume.
Diminuir volume		Diminua o volume.
Girar para a esquerda		Gire a tela 90 graus para a esquerda.
Girar para a direita		Gire a tela 90 graus para a direita.
Tire uma captura de tela		Clique para tirar uma captura de tela do dispositivo.
Insira o modo de zoom		Clique para alterar o cursor para o ícone de zoom. Clique novamente para sair do modo de zoom.
Voltar		Retorne à tela anterior ou feche um menu de opções, caixa de diálogo, teclado na tela ou painel de notificações.
Casa		Volte para a tela inicial.
Visão geral (aplicativos recentes)		Clique para abrir uma lista de aplicativos com os quais você trabalhou recentemente. Para abrir um aplicativo, toque em sua miniatura.
Mais		Clique para obter mais recursos e configurações.

Os gestos a seguir podem ser simulados no emulador:

Gesto	Descrição
Toque	Pressione e solte o botão principal do mouse.
Tocar duas vezes	Clique duas vezes e solte o botão principal do mouse.
Arrastar	Pressione e segure o botão principal do mouse, mova o item e solte.
Tocar e segurar	Pressione o botão principal do mouse, segure e solte.
Pinçar	Pressione a tecla Ctrl no Windows ou a tecla Command no macOS para exibir uma interface multi-touch para gestos de pinça. O mouse atua como o primeiro dedo, que pode ser movido arrastando o cursor. O segundo dedo está em frente ao ponto de âncora. Pressionar o botão esquerdo do mouse simula tocar em ambos os pontos e liberar simula a remoção de ambos os pontos.
Passar o dedo	Pressione e segure o botão principal do mouse, deslize o dedo e solte.
Deslizar o dedo verticalmente	Abra um menu vertical na tela e use a roda de rolagem do mouse para rolar pelos itens de menu.

Cenários avançados do emulador

Talvez você queira testar seu aplicativo em um dispositivo virtual usando mais do que apenas gestos básicos de toque. Por exemplo, talvez você queira simular diferentes condições de rede. A tabela a seguir lista onde encontrar mais informações sobre cenários avançados do android emulador:

Cenários	Mais informações
Usar a câmera	Suporte à câmera no developer.android.com
Instalar e adicionar arquivos	Instalar e adicionar arquivos no developer.android.com
Usar Wi-Fi	Wi-Fi em developer.android.com
Utilizar controles estendidos	Controles estendidos, configurações e ajuda no developer.android.com
Usar instantâneos	Instantâneos em developer.android.com
Usar o emulador da linha de comando	Inicie o emulador na linha de comando no developer.android.com
Enviar comandos de console	Enviar comandos de console do emulador no developer.android.com
Configurar a rede	Configurar a rede do Android Emulator no developer.android.com
Configurar a aceleração de hardware	Configurar a aceleração de hardware para o Android Emulator no developer.android.com
Ferramentas do emulador do Android	Comparação das ferramentas do Android Emulator no developer.android.com

Limitações

O Android Emulator não inclui hardware virtual para o seguinte:

• Bluetooth
• NFC
• Inserir/ejetar cartão SD
• Fones de ouvido anexados ao dispositivo
• USB