Depurar no Android Emulator

O Android Emulator, instalado como parte da carga de trabalho de desenvolvimento de interface do usuário do aplicativo .NET multiplataforma , pode ser executado em várias configurações para simular diferentes dispositivos Android. Cada uma dessas configurações é criada como um dispositivo virtual. Neste artigo, você aprenderá a iniciar o emulador do Visual Studio e executar seu aplicativo em um dispositivo virtual. Para obter mais informações sobre como criar e configurar um dispositivo virtual, consulte Como gerenciar dispositivos virtuais com o Android Gerenciador de Dispositivos.

Iniciando o Emulador

Próximo à parte superior do Visual Studio, há o menu suspenso Configurações de Solução que pode ser usado para selecionar o modo Depuração ou Versão . Escolher a opção Depuração faz com que o depurador seja anexado ao processo do aplicativo em execução no emulador depois que o aplicativo é iniciado. Escolher o modo Versão desabilita o depurador. Quando estiver no modo de versão, você precisará contar com o registro em log do aplicativo para depuração.

Depois de escolher um dispositivo virtual no menu suspenso do dispositivo Depurar Destino , selecione o modo Depurar ou Liberar e, em seguida, selecione o botão Reproduzir para executar o aplicativo:

Depurar e liberar modos no Visual Studio junto com o botão Reproduzir.


Depois que o emulador é iniciado, o Visual Studio implanta o aplicativo no dispositivo virtual. Veja abaixo um exemplo de captura de tela do Android Emulator. Neste exemplo, o emulador está executando o aplicativo de modelo .NET MAUI.

Aplicativo .NET MAUI padrão em execução em um emulador Android.

Quando terminar de depurar e executar seu aplicativo, você poderá deixar o emulador em execução. Na primeira vez que um aplicativo .NET MAUI é executado no emulador, o runtime compartilhado do .NET MAUI para o nível de API de destino é instalado, seguido pelo aplicativo. A instalação do runtime pode levar alguns instantes para ser instalada. Se você deixar o emulador em execução, as sessões de depuração posteriores começarão mais rapidamente, pois o runtime já está presente no dispositivo. Se o dispositivo for reiniciado, o runtime será reimplantado no dispositivo.

Inicialização rápida

O Android Emulator inclui um recurso chamado Inicialização Rápida que está habilitado por padrão. Esse recurso é configurado pelas configurações do emulador de cada dispositivo. Com esse recurso habilitado, um instantâneo do dispositivo virtual é salvo quando o emulador é fechado. O instantâneo será restaurado rapidamente na próxima vez que o dispositivo for iniciado.

Na primeira vez que um dispositivo virtual é iniciado, uma inicialização fria do dispositivo virtual ocorre sem uma melhoria de velocidade porque um instantâneo ainda não foi criado:

Captura de tela de Inicialização Fria.

Quando você sai do emulador, a Inicialização Rápida salva o estado do emulador em um instantâneo:

Salvando o estado no desligamento.

Na próxima vez que o dispositivo virtual for iniciado, ele será carregado muito mais rápido porque o emulador simplesmente restaura o estado no qual você fechou o emulador.

Carregando o estado na reinicialização.

Solução de problemas

Para obter dicas e soluções alternativas para problemas comuns do emulador, consulte Solução de problemas do Android Emulator.

Para obter mais informações sobre como usar o Android Emulator, consulte os seguintes artigos do Desenvolvedor android: