Skip to content

Most visited

Recently visited

navigation

Executar aplicativos no Android Emulator

O Android Emulator simula um dispositivo e exibe-o no seu computador de desenvolvimento. Com ele, você pode criar protótipos, desenvolver e testar aplicativos do Android sem usar um dispositivo de hardware. O emulador é compatível com celulares e tablets Android, com o Android Wear e com dispositivos Android TV. Ele vem com tipos de dispositivo predefinidos para que você comece rapidamente e, além disso, também é possível criar suas próprias definições de dispositivo e aparências para o emulador.

O Android Emulator é uma ferramenta rápida, eficaz e repleta de recursos. Ele pode transferir informações com mais rapidez do que um dispositivo de hardware conectado, o que agiliza o processo de desenvolvimento. O recurso de vários núcleos permite que o emulador aproveite os processadores de vários núcleos do seu computador de desenvolvimento para melhorar ainda mais o desempenho do emulador.

Sobre o Android Emulator

Você pode iniciar um aplicativo no emulador executando seu projeto ou arrastar um arquivo de APK para o emulador para instalá-lo. Assim como ocorre com um dispositivo de hardware, depois que você instala um aplicativo em um dispositivo virtual, ele permanece lá até ser desinstalado ou substituído. Se necessário, você pode testar como vários aplicativos, como o seu próprio ou os aplicativos do sistema, interagem entre si.

Recursos para testar seus aplicativos

Você interage com o emulador da mesma forma que faria com um dispositivo de hardware, mas usando o mouse e o teclado, além dos botões e controles do emulador. O emulador é compatível com botões e touchscreens de hardware virtual, incluindo operações com dois dedos, pads direcionais, trackballs, rodas e diversos sensores. É possível redimensionar dinamicamente a janela do emulador conforme a necessidade, aumentar e reduzir o zoom, alterar a orientação e até registrar uma captura de tela.

Quando seu aplicativo é executado no emulador, ele pode usar os serviços da plataforma Android para chamar outros aplicativos, acessar a rede, reproduzir áudio e vídeo, aceitar entradas de áudio, armazenar e recuperar dados, notificar o usuário e renderizar transições gráficas e temas. O emulador tem controles que permitem que você envie com facilidade chamadas telefônicas e mensagens de texto recebidas, especifique a localização do dispositivo, simule verificações de impressão digital, especifique a velocidade e o status da rede e simule propriedades da bateria. O emulador também pode simular um cartão SD e o armazenamento interno de dados; você pode arrastar um arquivo, como um arquivo de gráfico ou de dados, até o emulador para armazená-lo.

Assista ao vídeo a seguir para obter um panorama rápido de alguns dos recursos do emulador.

Configurações do Android Virtual Device

O emulador usa uma configuração do Android Virtual Device (AVD) para determinar a aparência, a funcionalidade e a imagem do sistema de um dispositivo simulado. AVDs permitem que você defina certos aspectos de hardware dos seus dispositivos emulados e crie muitas configurações para testar diferentes permutações de plataformas e hardware Android.

Cada AVD funciona como um dispositivo independente, com o próprio armazenamento privado para dados do usuário, cartão AD e assim por diante. Quando você inicia um emulador com uma configuração de AVD, ele automaticamente carrega os dados do usuário e os dados do cartão SD do diretório do AVD. Por padrão, o emulador armazena nos dados do usuário, os dados do cartão SD e o cache no diretório do AVD.

Para criar e gerenciar AVDs, use o AVD Manager.

Imagens do sistema

O Android Emulator executa uma pilha completa do sistema Android, até o nível do kernel, que inclui um conjunto de aplicativos pré-instalados (como o discador) que podem ser acessados dos seus aplicativos. Você pode escolher qual versão do sistema Android deseja executar no emulador ao criar os AVDs.

As imagens do sistema Android disponíveis no AVD Manager contêm códigos para o kernel Android Linux, as bibliotecas nativas, a VM e os diversos pacotes do Android (como a estrutura Android e os aplicativos pré-instalados).

Dependências e pré-requisitos

A versão do Android Emulator descrita desta página exige:

O que não tem suporte

O Android Emulator tem suporte para a maioria dos recursos de um dispositivo, mas não inclui hardware virtual para:

O emulador de relógio para Android Wear não tem suporte para o botão Overview (Recent Apps), o pad direcional e o sensor de impressão digital.

Embora a maioria dos usuários finais de celulares e tablets tendam a usar níveis de API mais antigos, usuários do Android Wear e da Android TV tendem a usar as versões mais recentes. O uso de versões recentes pode oferecer uma experiência melhor com o emulador.

Executar um aplicativo no Android Emulator

Você pode executar um aplicativo de um projeto do Android Studio. Também é possível executar um aplicativo já instalado no emulador da mesma forma como você executaria qualquer aplicativo em um dispositivo.

Para iniciar o emulador e executar um aplicativo no seu projeto:

  1. Abra um projeto do Android Studio e clique em Run .
  2. A caixa de diálogo Select Deployment Target é exibida.

    Caixa de diálogo Select Deployment Target
  3. Se receber um erro ou uma mensagem de aviso na parte superior da caixa de diálogo, clique no link para corrigir o problema ou obter mais informações.
  4. O aviso No USB devices or running emulators detected significa que você não tem emuladores em execução ou que nenhum dispositivo de hardware conectado ao seu computador foi detectado. Se não tiver dispositivos de hardware conectados ao seu computador ou emuladores em execução, ignore essa mensagem.

    Alguns erros devem ser corrigidos antes de continuar, como certos erros do Hardware Accelerated Execution Manager (Intel® HAXM).

  5. Na caixa de diálogo Select Deployment Target, selecione uma definição de emulador existente e clique em OK.

    Se não vir uma definição que queira usar, clique em Create New Emulator para iniciar o AVD Manager. Depois de definir um novo AVD, na caixa de diálogo Select Deployment Target, clique em OK.

    Se quiser usar essa definição de emulador como padrão para seu projeto, selecione Use same selection for future launches.

    O emulador é iniciado e exibe seu aplicativo.

  6. Teste seu aplicativo no emulador.
  7. Você pode usar os recursos descritos nas seguintes seções:

  8. Para fechar o emulador, clique em Close Ícone Fechar.
  9. O dispositivo do emulador armazena o aplicativo instalado para que você possa executá-lo novamente, se necessário. Você deve desinstalar um aplicativo para removê-lo. Se executar o projeto novamente no mesmo emulador, ele substituirá o aplicativo pela versão nova.

Iniciar o Android Emulator sem executar um aplicativo

Para iniciar o emulador:

  1. Abra o AVD Manager.
  2. Clique duas vezes em um AVD ou em Run .
  3. O Android Emulator é exibido.

    Enquanto o emulador estiver em execução, você poderá executar projetos do Android Studio e escolher o emulador como dispositivo de destino. Também é possível arrastar um ou mais APKs para o emulador para instalá-los e executá-los.

Use o ponteiro do mouse do computador 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.

Recurso Descrição
Deslizar o dedo na tela Aponte para a tela, pressione e segure o botão principal do mouse, deslize o cursor pela tela e solte.
Arrastar um item Aponte para um item na tela, pressione e segure o botão principal do mouse, mova o item e solte.
Tocar
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 aplicativo ou pressionar um botão.
Tocar duas vezes Aponte para a tela, pressione o botão principal do mouse duas vezes rapidamente e solte.
Tocar e segurar Aponte para um item na tela, pressione o botão principal do mouse, segure e solte. Por exemplo, você pode abrir opções para um item.
Digitar Você pode digitar no emulador usando o teclado do computador ou um teclado exibido na tela do emulador. Por exemplo, você pode digitar em um campo de texto após selecioná-lo.
Abrir e fechar gesto de pinça
Pressionar as teclas Ctrl ou Command (⌘) exibe uma interface multitoque de gesto de pinça. O mouse funciona como o primeiro dedo e o ponto de âncora é 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.

Executar tarefas básicas no emulador

O painel à direita do emulador permite que você execute várias tarefas. Também é possível arrastar arquivos para o emulador para instalar aplicativos e fazer o download de arquivos.

Recurso Descrição Atalho de teclado
Fechar
Ícone Fechar
Fecha o emulador.
Minimizar
Ícone Minimizar
Minimiza a janela do emulador.
Redimensionar Redimensione o emulador da mesma forma que faria com qualquer outra janela do sistema operacional. O emulador mantém a taxa de proporção apropriada para seu dispositivo. ⌘↑ e ⌘↓
Ligar/desligar
Ícone Ligar/desligar
Clique para ligar ou desligar a tela.
Clique e segure para ligar ou desligar o dispositivo.
Ctrl+P
⌘P
Aumentar o volume
Ícone Aumentar o volume
Clique para visualizar um controle deslizante e aumentar o volume. Clique novamente para aumentar mais o volume ou use o controle deslizante para alterar o volume.
Ctrl+=
⌘=
Diminuir o volume
Ícone Diminuir o volume
Clique para visualizar um controle deslizante e diminuir o volume. Clique novamente para diminuir mais o volume ou use o controle deslizante para alterar o volume.
Ctrl+-
⌘-
Girar à esquerda
Ícone Girar à esquerda
Gira o celular 90 graus no sentido anti-horário.
Ctrl+Esquerda
⌘←
Girar à direita
Ícone Girar à direita
Gira o celular 90 graus no sentido horário.
Ctrl+Direita
⌘←
Capturar tela
Ícone Capturar tela
Clique para capturar a tela do dispositivo. A imagem é salva por padrão na área de trabalho do computador. Para alterar esse local, selecione > Settings. O emulador cria um arquivo com o nome Screenshot_yyyymmdd-hhmmss.png usando o ano, o mês, o dia, a hora, o minuto e o segundo da captura, por exemplo, Screenshot_20160219-145848.png.
Ctrl+S
⌘S
Entrar no modo de zoom
Ícone Entrar no modo de zoom

Clique para que o cursor mude para o ícone 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 em forma de caixa 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.
  • Pressione a tecla Ctrl e clique para tocar a tela no modo de zoom.

Clique em Enter Zoom Mode novamente para voltar ao tamanho normal da tela.

Ctrl+Z
⌘Z
No modo de zoom:
Ctrl+Para cima
Ctrl+Para baixo
Ctrl+Shift+Para cima
Ctrl+Shift+Para baixo
Ctrl+Shift+Esquerda
Ctrl+Shift+Direita
⌘↑ e ⌘↓
⇧⌘↑ e ⇧⌘↓
⇧⌘↑ e ⇧⌘↓
Voltar
Ícone Voltar
Volta para a tela anterior ou fecha uma caixa de diálogo, um menu de opções, o Painel de notificações ou o teclado virtual.
Ctrl+Backspace
⌘←
Início
Ícone Início
Volta para a tela inicial. Pressione e segure para abrir o item específico do seu nível de API.
Ctrl+H
⌘⇧H
Visão geral
Ícone Visão geral
(Aplicativos recentes)
Toque para abrir uma lista de imagens de miniaturas de aplicativos com os quais você trabalhou recentemente. Toque em um aplicativo para abri-lo. Para remover uma miniatura da lista, deslize-a para a esquerda ou para a direita. Não há suporte para esse botão no Android Wear.
Ctrl+O
⌘O
Menu Digite o atalho de teclado para simular o botão Menu, por exemplo, para abrir o menu do aplicativo selecionado.
Ctrl+M
⌘M
Mais
Ícone Mais
Clique para acessar outros recursos e configurações, descritos na próxima tabela.
Instalar um APK Arraste um arquivo de APK para a tela do emulador. Uma caixa de diálogo do APK Installer é exibida. Quando a instalação é concluída, você pode visualizar o aplicativo na sua lista de aplicativos. O aplicativo não foi instalado se for exibida uma caixa de diálogo com a mensagem “APK failed to install”.
Adicionar um arquivo Arraste qualquer arquivo para a tela do emulador. Ele é colocado no diretório /sdcard/Download. Navegue até o arquivo usando o método para o nível da API. Por exemplo, para a API 22, este é o caminho de navegação: Settings > Device: Storage & USB > Internal Storage > Explore (Virtual SD Card).
Ativar/desativar modo de trackball F6

Trabalhar com os controles estendidos, as configurações e a ajuda

Os controles estendidos permitem que você envie dados, altere as propriedades do dispositivo, controle aplicativos e muito mais. Para acessar os controles, selecione no painel do emulador e selecione a opção desejada no painel esquerdo da caixa de diálogo Extended Controls.

Recurso Descrição Atalhos de teclado
Localização

O emulador permite que você simule informações de localização, ou seja, onde seu dispositivo emulado se encontra no momento. Por exemplo, se você clicar em My Location Ícone My Location no Google Maps e enviar uma localização, o mapa a mostrará.

Para enviar uma localização de GPS:

  1. Selecione Decimal ou Sexagesimal.
  2. Especifique a localização.
  3. No modo decimal, insira um valor para Latitude no intervalo de -90,0 a +90,0 graus e um valor para Longitude no intervalo de -180,0 a +180,0 graus.

    No modo sexagesimal, insira um valor de três partes para Latitude no intervalo de -90 a +90 graus, 0 a 59 minutos e 0,0 a 60,0 segundos. Insira um valor de três partes para Longitude no intervalo de -180 a +180 graus, 0 a 59 minutos e 0,0 a 60,0 segundos.

    Para a latitude, “-” indica sul e “+” indica norte; para a longitude, “-” indica oeste e “+” indica leste. O “+” é opcional.

    Há também a opção de especificar um valor para Altitude no intervalo de -1.000,0 a +10.000,0 metros.

  4. Clique em Send.

Para usar dados geográficos de um arquivo GPS Exchange Format (GPX) ou Keyhole Markup Language (KML):

  1. Clique em Load GPX/KML.
  2. Na caixa de diálogo do arquivo, selecione um arquivo no seu computador e clique em Open.
  3. Opcionalmente, selecione um valor de Speed.
  4. A velocidade assume como padrão o valor Delay (Speed 1X). Você pode aumentar a velocidade em duas vezes (Speed 2X), três vezes (Speed 3X) e assim por diante.

  5. Clique em Run .
Ctrl+Shift+L
⇧⌘L
Celular

O emulador permite que você simule diversas condições de rede. Você pode aproximar a velocidade de rede de diferentes protocolos de rede ou especificar Full, que transfere os dados na velocidade máxima permitida pelo computador. Especificar um protocolo de rede é sempre mais lento do que a opção Full. Também é possível especificar o status de rede de dados e voz, como roaming. Os valores padrão são definidos no AVD.

Selecione uma opção para Network type:

  • GSM - Global System for Mobile Communications
  • HSCSD - High-Speed Circuit-Switched Data
  • GPRS - Generic Packet Radio Service
  • EDGE - Enhanced Data rates for GSM Evolution
  • UMTS - Universal Mobile Telecommunications System
  • HSPDA - High-Speed Downlink Packet Access
  • Full (default)

Selecione uma opção para Voice status, Data status ou ambos:

  • Home (default)
  • Roaming
  • Searching
  • Denied (emergency calls only)
  • Unregistered (off)
Ctrl+Shift+C
⇧⌘C
Bateria

Você pode simular as propriedades da bateria de um dispositivo para ver como é o desempenho do seu aplicativo em diferentes condições. Para selecionar um valor para Charge level, use o controle deslizante.

Selecione um valor para Charger connection:

  • None
  • AC charger

Selecione um valor para Battery health:

  • Good (default)
  • Failed
  • Dead
  • Overvoltage
  • Overheated
  • Unknown

Selecione um valor para Battery status:

  • Unknown
  • Charging (default)
  • Discharging
  • Not charging
  • Full
Ctrl+Shift+B
⇧⌘B
Telefone

O emulador permite que você simule chamadas telefônicas e mensagens de texto recebidas. Observe que o fluxo de informações é unidirecional, do controle ao emulador. Por exemplo, o controle não altera seu status se o emulador desconectar a chamada; é necessário desligar a chamada no controle.

Para iniciar uma chamada para o emulador:

  1. Selecione ou digite um número de telefone no campo From.
  2. Clique em Call Device.
  3. Opcionalmente, clique em Hold Call para colocar a chamada em espera.
  4. Para encerrar a chamada, clique em End Call.

Para enviar uma mensagem de texto para o emulador:

  1. Selecione ou digite um número de telefone no campo From.
  2. Digite uma mensagem no campo SMS message.
  3. Clique em Send Message.
Ctrl+Shift+P
⇧⌘P
Pad direcional

Se o AVD tiver o pad direcional ativado no perfil de hardware, você poderá usar os controles de pad direcional com o emulador. No entanto, nem todos os dispositivos oferecem suporte ao pad direcional, como um relógio Android. Os botões simulam as seguintes ações:

Controle do pad direcional
Ctrl+Shift+D
⇧⌘D
Impressão digital

Esse controle pode simular até 10 verificações de impressões digitais diferentes. Você pode usá-lo para testar a integração de impressões digitais no seu aplicativo. Esse recurso não é compatível com o Android Wear.

Para simular uma verificação de impressão digital no dispositivo virtual:

  1. Prepare um aplicativo para receber uma impressão digital.
  2. Selecione um valor para Fingerprint.
  3. Clique em Touch Sensor.
Ctrl+Shift+F
⇧⌘F
Configurações

Você pode especificar as seguintes configurações:

  • Emulator window theme - Selecione Light ou Dark.
  • Send keyboard shortcuts to - Por padrão, algumas combinações de teclas acionarão atalhos de controle do emulador. Se você estiver desenvolvendo um aplicativo que inclua atalhos de teclado, como um aplicativo direcionado a dispositivos com teclados Bluetooth, poderá alterar essa configuração para enviar todas as teclas pressionadas no teclado para o dispositivo virtual, incluindo atalhos no emulador.
  • Screenshot save location - Clique no ícone de pasta para salvar capturas da tela do emulador.
  • Use detected ADB location - Se você estiver executando o emulador do Android Studio, selecione essa opção (o padrão). Se você executar o emulador de fora do Android Studio e quiser que ele use um ADB executável específico, desmarque essa opção e especifique o local do SDK Tools. Se essa configuração estiver incorreta, recursos como a instalação de aplicativos e a cópia de arquivos com arrastar e soltar e a captura de telas não funcionarão.
  • When to send crash reports - Selecione Always, Never ou Ask.
Ctrl+Shift+S
⇧⌘S
Help > Keyboard Shortcuts

Veja os atalhos de teclado aceitos pelo emulador. Para que os atalhos funcionem, você precisa:

  • Selecionar Settings > Send keyboard shortcuts to > Emulator controls (default).
F1
⌘/
Help > Emulator Help

Para acessar a documentação on-line do emulador, clique em Documentation.

Para registrar um erro no emulador, clique em File a Bug.

Para fazer sugestões, clique em Send Feedback.

Todos esses links exigem uma conexão com a Internet e um navegador.

F1
⌘/
Help > About

Veja qual porta do ADB é usada pelo emulador, além dos números de versão do Android e do emulador. Compare a versão mais recente disponível do emulador com a sua para determinar se você tem o software mais recente instalado.

O número de série do emulador é emulator-adb_port, que você pode especificar como uma opção de linha de comando do ADB, por exemplo.

F1
⌘/
This site uses cookies to store your preferences for site-specific language and display options.

Get the latest Android developer news and tips that will help you find success on Google Play.

* Required Fields

Hooray!

Follow Google Developers on WeChat

Browse this site in ?

You requested a page in , but your language preference for this site is .

Would you like to change your language preference and browse this site in ? If you want to change your language preference later, use the language menu at the bottom of each page.

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a short survey?
Help us improve the Android developer experience.
(Sep 2017 survey)