Emulador 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 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 no dispositivo físico, consulte Configurar o dispositivo Android para depuração.

O emulador Android é instalado pelo Visual Studio, e um AVD criado, quando você cria seu primeiro aplicativo .NET Multi-platform App UI (.NET MAUI) para Android. Para obter 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 a arquitetura do processador. Para obter mais informações, consulte Como habilitar a aceleração de hardware com emuladores Android.

Os dispositivos Android físicos são emulados por AVDs, que especificam a versão do Android e as características de hardware do dispositivo simulado. Para testar um aplicativo, crie AVDs que modelem 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 do usuário e dados do cartão SD. O emulador armazena os dados do usuário e os dados do cartão SD em uma pasta específica para o 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 Gerenciando dispositivos virtuais com o Gerenciador de dispositivos Android. Para obter informações sobre como editar a configuração de um dispositivo virtual, consulte Editando propriedades de dispositivo virtual Android.

Depois de criar um AVD, você pode iniciar o emulador e depurar um aplicativo nele. Para obter mais informações, consulte Depurar no emulador do Android. Depois que um aplicativo é instalado em um AVD, você pode executá-lo a partir do dispositivo como faria com 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 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.

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

Usar o emulador

Quando o emulador Android está em execução, você usa o ponteiro do mouse do computador para imitar o dedo na tela sensível ao toque, selecionar itens de menu e campos de entrada e clicar 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 realizadas no emulador através de seu painel no lado direito:

Ação	Ícone	Descrição
Fechar		Feche o emulador.
Minimizar		Minimize a janela do emulador.
Energia		Clique para ligar/desligar a tela. Clique e segure para ligar/desligar o dispositivo.
Aumento de volume		Increase the volume.
Redução de 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.
Tirar captura de tela		Clique para tirar uma captura de tela do dispositivo.
Entrar no modo de zoom		Clique para alterar o cursor para o ícone de zoom. Clique novamente para sair do modo de zoom.
Voltar		Volte para a tela anterior ou feche um menu de opções, uma caixa de diálogo, um teclado na tela ou um painel de notificações.
Página Inicial		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 mais recursos e configurações.

Os seguintes gestos podem ser simulados no emulador:

Gesto	Descrição
Toque	Pressione e solte o botão principal do mouse.
Toque duplo	Clique duas vezes e solte o botão principal do mouse.
Arrastar	Mantenha pressionado o botão principal do mouse, mova o item e solte.
Toque e segure	Pressione o botão principal do mouse, segure e solte.
Fixar	Pressione a tecla CTRL no Windows ou a tecla Command no macOS para exibir uma interface multitoque de gesto 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 ancoragem. 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	Mantenha pressionado o botão principal do mouse, passe o dedo e solte.
Deslizamento vertical	Abra um menu vertical na tela e use a roda de rolagem do mouse para percorrer os itens de menu.

Cenários avançados de emulador

Talvez você queira testar seu aplicativo em um dispositivo virtual usando mais do que apenas gestos de toque básicos. 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 de emulador do Android:

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

Limitações

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

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