Executar apps no Android Emulator

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

O Android Emulator simula dispositivos Android no seu computador. Assim, você pode testar seu aplicativo em diversos dispositivos e níveis da API do Android, sem precisar ter todos os dispositivos físicos. O emulador oferece estas vantagens:

  • Flexibilidade: além de simular vários dispositivos e níveis de API do Android, o emulador vem com configurações predefinidas para vários smartphones e tablets Android, além do Wear OS e dispositivos Android TV.

  • Alta fidelidade: o emulador oferece quase todos os recursos de um dispositivo Android real. É possível simular o recebimento de chamadas telefônicas e mensagens de texto, especificar o local do dispositivo, simular diferentes velocidades de rede, simular rotação e outros sensores de hardware, acessar a Google Play Store e muito mais.

  • Velocidade: testar o app no emulador é, de certa forma, mais rápido e mais fácil do que em um dispositivo físico. Por exemplo, você pode transferir dados mais rapidamente ao emulador do que a um dispositivo conectado via USB.

Na maioria dos casos, o emulador é a melhor opção para as necessidades de teste. Esta página aborda as principais funcionalidades do emulador e como começar a usá-lo.

Como alternativa, é possível implantar o app em um dispositivo físico. Para saber mais, consulte Executar apps em um dispositivo de hardware.

Começar a usar o emulador

O Android Emulator permite testar virtualmente o app em vários dispositivos diferentes. O emulador vem com o Android Studio por padrão, então você não precisa o instalar manualmente. O fluxo de trabalho básico com o emulador é o seguinte:

  1. Verifique se você atende aos requisitos do sistema.
  2. Crie um Dispositivo virtual Android (AVD).
  3. Execute o aplicativo no emulador.
  4. Navegue pelo emulador.

Nesta página, você verá as etapas para configurar e explorar seu ambiente de teste virtual em mais detalhes. Se o app já estiver em execução no emulador e você estiver pronto para usar recursos mais avançados, consulte Uso avançado do emulador.

Se você tiver problemas com o emulador, consulte Resolver problemas do emulador. Dependendo das suas necessidades e recursos, pode valer a pena analisar os requisitos do sistema e configurações técnicas, ou pode ser melhor usar um dispositivo físico.

Requisitos do sistema para emulador

Para ter a melhor experiência, use o emulador do Android Studio em um computador com as seguintes especificações:

  • 16 GB de RAM
  • Sistema operacional Windows, macOS, Linux ou Chrome OS de 64 bits
  • 16 GB de espaço em disco

Se você não tem essas especificações, o emulador ainda pode ser executado, mas provavelmente a performance não vai ser ideal. Nesse caso, considere testar em um dispositivo físico em vez de seguir as orientações em Executar apps em um dispositivo de hardware.

Criar um Dispositivo virtual Android

Cada instância do Android Emulator usa um Dispositivo virtual Android (AVD) para especificar a versão do Android e as características de hardware do dispositivo simulado. Para testar seu app de forma eficaz, crie um AVD que modele cada dispositivo em que você espera que o app seja executado. Para criar um AVD, consulte Criar e gerenciar dispositivos virtuais.

Cada AVD funciona como um dispositivo independente, com o próprio armazenamento privado para dados do usuário, cartão SD e assim por diante. Por padrão, o emulador armazena os dados do usuário e do cartão SD, bem como o cache, em um diretório específico para esse AVD. Ao ser iniciado, o emulador carrega os dados do usuário e do cartão SD a partir do diretório do AVD.

Executar o aplicativo no emulador

Depois de criar um Dispositivo virtual Android (AVD), inicie o Android Emulator e execute um app no projeto:

  1. Na barra de ferramentas, selecione o AVD em que você quer executar o app no menu suspenso do dispositivo de destino.

  2. Clique em Executar. O emulador pode levar cerca de um minuto para ser iniciado pela primeira vez, mas as inicializações subsequentes vão usar um snapshot e serão iniciadas mais rapidamente. Se você tiver problemas nesse ponto, consulte Resolver problemas do emulador.

Depois que o app está instalado no AVD, você pode executá-lo no dispositivo como faria com qualquer app em um dispositivo. Sempre que quiser implantar novas mudanças, clique em Executar ou em Aplicar mudanças novamente.

Assistente de pareamento do Wear OS

Caso queira testar o app com dispositivos Wear OS, o assistente de pareamento do Wear OS mostra as etapas para parear emuladores usando smartphones físicos ou virtuais diretamente no Android Studio. Para saber mais, consulte Usar o assistente de pareamento do emulador do Wear OS.

Quando o emulador está em execução, você pode usar o mouse do computador para imitar o dedo na tela touchscreen e usar o painel do emulador para executar ações comuns.

Use o cursor do mouse para imitar o movimento do dedo na tela, selecione itens de menu e campos de entrada e clique em botões e controles. Use o teclado do computador para digitar caracteres e inserir atalhos do emulador.

Tabela 1. Gestos para navegar no emulador.

Recurso Descrição
Deslizar o dedo na tela Aponte para a tela, pressione o botão principal do mouse e mantenha-o pressionado, deslize o cursor pela tela e solte.
Arrastar um item Aponte para um item na tela, pressione o botão principal do mouse e mantenha-o pressionado, mova o item e solte.
Tocar
(dar um toque)
Aponte para a tela, pressione o botão principal do mouse e solte. Por exemplo, você pode clicar em um campo de texto para começar a digitar nele, selecionar um app ou pressionar um botão.
Tocar duas vezes Aponte para a tela, pressione o botão principal do mouse rapidamente duas vezes e solte.
Tocar e manter pressionado Aponte para um item na tela, pressione o botão principal do mouse, mantenha pressionado e solte. Por exemplo, você pode abrir opções para um item.
Tipo Você pode digitar no emulador usando o teclado do computador ou um teclado pop-up na tela do emulador. Por exemplo, você pode digitar em um campo de texto depois de selecioná-lo.
Fazer gesto de pinça unindo e afastando os dedos
Ao pressionar "Control" (Command no Mac), uma interface multitoque de gestos de pinça é exibida. O mouse funciona como o primeiro dedo, e o ponto de fixação é o segundo dedo. Arraste o cursor para mover o primeiro ponto.
Clicar com o botão esquerdo do mouse funciona como tocar em ambos os pontos, e soltar o botão funciona como levantar os dedos.
Deslizar verticalmente Abra um menu vertical na tela e use a roda de rolagem (botão de rolagem do mouse) para percorrer os itens do menu até ver o que você procura. Clique no item de menu para selecioná-lo.

Realizar ações comuns usando o painel do emulador

Para executar ações comuns com o emulador, use a barra de ferramentas do emulador (se você estiver executando o emulador no Android Studio) ou o painel à direita (se estiver executando o emulador em uma janela fora do Android Studio). A Tabela 2 descreve as ações comuns do emulador e os botões associados.

Você pode usar atalhos de teclado para realizar várias ações comuns no emulador. Para ver uma lista completa de atalhos no emulador, pressione F1 (no Mac, Command + /) e veja o painel "Help" na janela Extended controls.

Tabela 2. Ações comuns no emulador.

Recurso Descrição
Fechar
Ícone "Fechar"
Fecha o emulador.
Minimizar
Ícone "Minimizar"
Minimiza a janela do emulador.
Redimensionar Redimensiona o emulador da mesma forma que faria com qualquer outra janela do sistema operacional. O emulador mantém uma proporção adequada para o dispositivo.
Liga/desliga
Ícone "Liga/desliga"
Clique para ligar ou desligar a tela.
Clique e mantenha pressionado para ligar ou desligar o dispositivo.
Aumentar volume
Ícone "Aumentar volume"
Clique para ver um controle deslizante e aumentar o volume. Clique novamente para aumentar mais o volume ou use o controle deslizante para mudar o volume.
Diminuir volume
Ícone "Diminuir volume"
Clique para ver um controle deslizante e diminuir o volume. Clique novamente para diminuir mais o volume ou use o controle deslizante para mudar o volume.
Girar para a esquerda
Ícone "Girar para a esquerda"
Gira o dispositivo 90 graus no sentido anti-horário.
Girar para a direita
Ícone "Girar para a direita"
Gira o dispositivo 90 graus no sentido horário.
Fazer captura de tela
Ícone "Fazer captura de tela"
Clique para capturar a tela do dispositivo. Para saber mais detalhes, consulte Capturas de tela.
Entrar no modo de zoom
Ícone "Entrar no modo de zoom"

Clique para que o cursor mude para o ícone de zoom. Para sair do modo de zoom, clique no botão novamente.

Aumentar e diminuir o zoom no modo de zoom:

  • Clique com o botão esquerdo do mouse para aumentar o zoom em 25%, até no máximo cerca de duas vezes a resolução da tela do dispositivo virtual.
  • Clique com o botão direito do mouse para diminuir o zoom.
  • Clique com o botão esquerdo do mouse e arraste para selecionar uma área retangular na qual aumentar o zoom.
  • Clique com o botão direito do mouse e arraste a caixa de seleção para voltar ao zoom padrão.

Para movimentar no modo de zoom, mantenha "Control" ("Command", no Mac) pressionado ao mesmo tempo que as teclas de seta no teclado.

Para tocar na tela do dispositivo no modo de zoom, clique com a tecla Control pressionada (no Mac, clique com a tecla Command pressionada).

Voltar
Ícone "Voltar"
Volta para a tela anterior ou fecha uma caixa de diálogo, o menu de opções, o Painel de notificações ou o teclado na tela.
Início
Ícone "Início"
Volta para a tela inicial.
Visão geral
Ícone "Visão geral"
(Apps recentes)
Toque para abrir uma lista de imagens de miniaturas dos apps usados recentemente. Para abrir um app, toque nele. Para remover uma miniatura da lista, deslize-a para a esquerda ou para a direita. Esse botão não é compatível com o Wear OS.
Dobrar
Ícone "Dobrar"
Em dispositivos dobráveis, dobra o dispositivo para exibir a menor configuração de tela.
Desdobrar
Ícone "Desdobrar"
Em dispositivos dobráveis, desdobre o dispositivo para mostrar a maior configuração de tela.
Botão 1
Ícone de botão 1
Em dispositivos Wear, pressione o botão 1. Disponível apenas em dispositivos Wear que executam o nível 28 da API ou mais recente.
Botão 2
Ícone de botão 2
Em dispositivos Wear, pressione o botão 2. Disponível apenas em dispositivos Wear que executam o nível 30 da API ou mais recente.
Palma
Ícone do botão da palma da mão
Para dispositivos Wear, pressione a palma na tela do dispositivo. Isso muda o dispositivo para o modo ambiente. Disponível apenas em dispositivos Wear com o nível 28 da API ou mais recente.
Inclinação
Ícone do botão de inclinação
Em dispositivos Wear, incline o dispositivo. Assim, você sai do modo ambiente. Disponível somente em dispositivos Wear com o nível 28 da API ou mais recente.
Menu Pressione Control + M (no Mac, Command + M) para simular o botão de menu.
Mais
Ícone "Mais"
Clique para acessar outros recursos e configurações, descritos na próxima tabela.

Atualizar o emulador

Para instalar o Android Emulator, selecione o componente Android Emulator na guia SDK Tools do SDK Manager. Para ver instruções, consulte Atualizar ferramentas com o SDK Manager.