Um Dispositivo virtual Android (AVD, na sigla em inglês) é uma configuração que define as características de um smartphone ou tablet Android, Wear OS, Android TV ou um dispositivo Automotive OS que você queira simular no Android Emulator. O AVD Manager é uma interface que pode ser iniciada no Android Studio para ajudar a criar e gerenciar AVDs.
Para abrir o AVD Manager, siga um destes procedimentos:
- Selecione Tools > AVD Manager.
- Clique em AVD Manager
na barra de ferramentas.
Sobre AVDs
Os AVDs contêm perfil de hardware, imagem do sistema, área de armazenamento, skin e outras propriedades.
Recomendamos que você crie um AVD para cada imagem do sistema que possa ser
compatível com o app, de acordo com a configuração
<uses-sdk>
do seu manifesto.
Perfil de hardware
O perfil de hardware define as características de fábrica de um dispositivo. O AVD Manager é pré-carregado com alguns perfis de hardware, como dispositivos Pixel, e você pode definir e personalizar os perfis de hardware conforme necessário.
Apenas alguns perfis de hardware são indicados para incluir a Play Store. Isso indica que esses perfis estão em total conformidade com o CTS e podem usar imagens do sistema que incluem o app Play Store.
Imagens do sistema
Uma imagem do sistema identificada como APIs do Google inclui acesso ao Google Play Services. Uma imagem do sistema identificada com o logotipo do Google Play na coluna Play Store inclui o app Google Play Store, bem como acesso ao Google Play Services. Isso inclui a guia Google Play na caixa de diálogo Controles estendidos, que oferece um botão para a atualização do Google Play Services no dispositivo.
Para garantir a segurança do app e uma experiência consistente nos dispositivos físicos, as imagens do sistema com a Google Play Store inclusa são assinadas com uma chave de versão, o que significa que não é possível receber privilégios elevados (raiz) com elas. Se você precisar de privilégios elevados (raiz) para auxiliar na solução de problemas do app, use as imagens do sistema do Android Open Source Project (AOSP) que não contêm apps ou serviços do Google.
Área de armazenamento
O AVD tem uma área de armazenamento dedicada na sua máquina de desenvolvimento. Ele armazena dados de usuários de dispositivos, como apps instalados e configurações, além de um cartão SD emulado. Se necessário, você pode usar o AVD Manager para excluir permanentemente os dados do usuário, de modo que o dispositivo fique com os mesmos dados de um dispositivo novo.
Aparência
Uma aparência de emulador especifica o visual de um dispositivo. O AVD Manager oferece algumas aparências predefinidas. Também é possível definir suas próprias aparências ou usar as disponibilizadas por terceiros.
AVD e recursos do app
Verifique se a definição do AVD inclui os recursos de dispositivo necessários para o app. Consulte Propriedades de um perfil de hardware e Propriedades de um AVD para ver listas de recursos que podem ser definidos nos AVDs.
Criar um AVD
Dica: se você quiser iniciar o app em um emulador, execute o app no Android Studio e depois, na caixa de diálogo Select Deployment Target exibida, clique em Create New Virtual Device.
Para criar um novo AVD:
- Abra o AVD Manager clicando em Tools > AVD Manager.
- Clique em Create Virtual Device na
parte inferior da caixa de diálogo do AVD Manager.
A página Select Hardware é exibida.
Apenas alguns perfis de hardware são indicados para incluir a Play Store. Isso indica que esses perfis estão em total conformidade com o CTS e podem usar imagens do sistema que incluem o app Play Store.
- Selecione um perfil de hardware e clique em Next.
- Selecione a imagem do sistema de um nível de API específico e clique em Next.
- Mude as propriedades do AVD conforme necessário
e clique em Finish.
Clique em Show Advanced Settings para mostrar mais configurações, como a aparência.
Se o perfil de hardware que você quer usar não estiver disponível, você poderá criar ou importar um.
A página System Image é exibida.

A guia Recommended lista as imagens do sistema recomendadas. As demais guias incluem uma lista mais completa. O painel à direita descreve a imagem do sistema selecionada. As imagens x86 são executadas com mais rapidez no emulador.
Se você vir a opção Download ao lado da imagem do sistema, clique nela para fazer o download da imagem. Para isso, é preciso ter uma conexão de Internet.
O nível da API do dispositivo de destino é importante, porque seu app
não poderá ser executado
em uma imagem do sistema com um nível de API menor do que o exigido
pelo app, conforme especificado
no atributo
minSdkVersion
do arquivo de manifesto. Para ver mais
informações sobre a relação entre o nível de API do sistema e
minSdkVersion
, consulte Controlar versões do app.
Se o app declarar um elemento
<uses-library>
no arquivo de manifesto, ele precisará de uma imagem do sistema em que essa biblioteca
externa esteja presente. Se você quiser executar o app em um emulador, crie um AVD que
inclua a biblioteca necessária. Para isso, pode ser preciso usar um componente de complemento para a
plataforma do AVD. Por exemplo, o complemento de APIs do Google contém a biblioteca do Google Maps.
A página Verify Configuration é exibida.

O novo AVD é exibido na página Your Virtual Devices ou na caixa de diálogo Select Deployment Target.
Para criar um AVD de uma cópia:
- Na página Your Virtual Devices do AVD Manager, clique com o botão direito do mouse em um AVD e selecione Duplicate.
- Clique em Change ou Previous se precisar fazer mudanças nas páginas System Image e Select Hardware.
- Faça suas alterações e clique em Finish.
Ou clique em Menu
e selecione Duplicate.
A página Verify Configuration é exibida.
O AVD é exibido na página Your Virtual Devices.
Criar um perfil de hardware
O AVD Manager oferece perfis de hardware predefinidos para dispositivos comuns. Assim, você pode adicioná-los facilmente às definições do seu AVD. Se você precisar definir outro dispositivo, poderá criar um novo perfil de hardware. Você pode definir um novo perfil de hardware do início ou copiar um perfil de hardware como ponto de partida. Os perfis de hardware pré-carregados não são editáveis.
Para criar um novo perfil de hardware desde o início:
- Na página Select Hardware, clique em New Hardware Profile.
- Na página Configure Hardware Profile, mude as propriedades do perfil de hardware conforme necessário.
- Clique em Finish.
Seu novo perfil de hardware é exibido na página Select Hardware. Também é possível criar um AVD que use o perfil de hardware clicando em Next. Ou clique em Cancel para voltar à página Your Virtual Devices ou à caixa de diálogo Select Deployment Target.
Para criar um perfil de hardware de uma cópia:
- Na página Select Hardware, selecione o perfil de hardware e clique em Clone Device.
- Na página Configure Hardware Profile, mude as propriedades do perfil de hardware conforme necessário.
- Clique em Finish.
Ou então, clique com o botão direito do mouse no perfil de hardware e selecione Clone.
Seu novo perfil de hardware é exibido na página Select Hardware. Também é possível criar um AVD que use o perfil de hardware clicando em Next. Ou clique em Cancel para voltar à página Your Virtual Devices ou à caixa de diálogo Select Deployment Target.
Editar AVDs existentes
Na página Your Virtual Devices, você pode realizar as seguintes operações em um AVD existente:
- Para editar um AVD, clique em Edit this AVD
e aplique suas mudanças.
- Para excluir um AVD, clique com o botão direito nele e selecione
Delete. Ou clique em Menu
e selecione Delete.
- Para mostrar o AVD
.ini
e os arquivos.img
associados no disco, clique com o botão direito do mouse em um AVD e selecione Show on Disk. Ou clique em Menue selecione Show on Disk.
- Para ver os detalhes de configuração de um AVD que você pode
incluir em qualquer relatório de bugs para a equipe do Android Studio, clique com o botão direito no AVD e
selecione View Details. Ou então, clique em Menu
e selecione View Details.
Editar perfis de hardware existentes
Na página Select Hardware, você pode realizar as seguintes operações em um perfil de hardware existente:
- Para editar um perfil de hardware, selecione-o e clique em Edit Device. Ou então, clique com o botão direito no perfil de hardware e selecione Edit. Em seguida, faça suas alterações.
- Para excluir um perfil de hardware, clique nele com o botão direito e selecione Delete.
Não é possível editar nem excluir os perfis de hardware predefinidos.
Executar e parar um emulador e limpar os dados
Na página Your Virtual Devices, você pode realizar as seguintes operações em um emulador:
- Para executar um emulador que use um AVD, clique duas vezes no AVD. Ou clique em Launch
.
- Para interromper a execução de um emulador, clique com o botão direito em um AVD e selecione
Stop. Ou clique em Menu
e selecione Stop.
- Para limpar os dados de um emulador e retorná-lo ao mesmo
estado da primeira definição, clique com o botão direito em um AVD e selecione
Wipe Data. Ou clique em Menu
e selecione Wipe Data.
Importar e exportar perfis de hardware
Na página Select Hardware, você pode importar e exportar perfis de hardware:
- Para importar um perfil de hardware, clique em Import Hardware Profiles e selecione o arquivo XML que contém a definição no seu computador.
- Para exportar um perfil de hardware, clique nele com o botão direito e selecione Export. Especifique o local onde o arquivo XML que contém a definição será armazenado.
Propriedades de um perfil de hardware
Você pode especificar as seguintes propriedades de perfis de hardware na página Configure Hardware Profile. As propriedades de configuração de um AVD substituem as propriedades de um perfil de hardware, e as propriedades do emulador definidas enquanto ele está em execução substituem ambas.
Os perfis de hardware predefinidos inclusos no AVD Manager não são editáveis. No entanto, você pode copiá-los e editar as cópias.
Propriedades de um perfil de hardware | Descrição |
---|---|
Device Name | Nome do perfil de hardware. O nome pode conter letras maiúsculas e minúsculas, números de 0 a 9, pontos (.), sublinhados (_), parênteses ( () ) e espaços. O nome do arquivo que armazena o perfil de hardware é derivado do nome desse mesmo perfil. |
Device Type | Selecione uma das seguintes opções:
|
Screen Size | O tamanho físico da tela, em polegadas, medido na diagonal. Se esse tamanho for maior que a tela do computador, ele será reduzido durante a inicialização. |
Screen Resolution | Digite uma largura e uma altura em pixels para especificar o total de pixels na tela simulada. |
Round | Selecione essa opção se o dispositivo tiver uma tela redonda, como é o caso de alguns dispositivos Wear OS. |
Memory: RAM | Digite o tamanho da RAM do dispositivo e selecione a unidade B (byte), KB (kilobyte), MB (megabyte), GB (gigabyte) ou TB (terabyte). |
Input: Has Hardware Buttons (Back/Home/Menu) | Marque essa opção se seu dispositivo tiver botões de navegação de hardware. Desmarque-a se esses botões forem implementados apenas no software. Se você selecionar essa opção, os botões não aparecerão na tela. Você pode usar o painel lateral do emulador para “pressionar” os botões em qualquer um dos casos. |
Input: Has Hardware Keyboard | Marque essa opção se o dispositivo tiver um teclado de hardware. Desmarque-a caso contrário. Se você selecionar essa opção, o teclado não aparecerá na tela. Você pode usar o teclado do computador para enviar pressionamentos de tecla ao emulador em qualquer um dos casos. |
Navigation Style | Selecione uma das seguintes opções:
Essas opções destinam-se aos controles de hardware do dispositivo em si. No entanto, os eventos enviados para o dispositivo por um controlador externo são os mesmos. |
Supported Device States | Selecione uma ou ambas as opções:
Se você selecionar ambas as opções, poderá alternar entre as orientações no emulador. É preciso selecionar pelo menos uma opção para continuar. |
Cameras | Para ativar a câmera, selecione uma ou ambas as opções:
Posteriormente, você poderá usar uma webcam ou foto disponibilizada pelo emulador para simular o registro de uma foto com a câmera. |
Sensors: Accelerometer | Selecione se o dispositivo tiver um hardware que o ajude a determinar a própria orientação. |
Sensors: Gyroscope | Selecione se o dispositivo tiver um hardware que detecte rotação ou giro. Combinado ao acelerômetro, esse recurso pode oferecer uma detecção mais estável da orientação e se tornar compatível com um sistema de orientação de seis eixos. |
Sensors: GPS | Selecione se o dispositivo tiver um hardware compatível com a navegação baseada em satélite do Sistema de Posicionamento Global (GPS). |
Sensors: Proximity Sensor | Selecione se o dispositivo tiver um hardware que detecte se ele está próximo ao seu rosto durante uma chamada telefônica para desativar entradas da tela. |
Skin padrão | Selecione uma skin que controle a aparência do dispositivo quando ele é exibido no emulador. Lembre-se de que especificar uma tela muito grande para a resolução pode fazer com que a tela seja cortada, impedindo a visualização completa. Para ver mais informações, consulte Criar uma aparência de emulador. |
Propriedades de um AVD
Você pode especificar as seguintes propriedades para as configurações do AVD na página Verify Configuration. A configuração do AVD especifica a interação entre o computador de desenvolvimento e o emulador, além das propriedades que você queira substituir no perfil de hardware.
As propriedades da configuração do AVD substituem as propriedades do perfil de hardware. As propriedades do emulador definidas enquanto ele está em execução substituem ambas.
Propriedade do AVD | Descrição |
---|---|
AVD Name | Nome do AVD. O nome pode conter letras maiúsculas e minúsculas, números de 0 a 9, pontos (.), sublinhados (_), parênteses ( () ), traços (-) e espaços. O nome do arquivo que armazena as configurações do AVD é derivado do nome do AVD. |
AVD ID (Advanced) | O nome de arquivo do AVD é derivado do código, e você pode usar esse código para fazer referência ao AVD pela linha de comando. |
Hardware Profile | Clique em Change para selecionar outro perfil de hardware na página Select Hardware. |
System Image | Clique em Change para selecionar outra imagem do sistema na página System Image. É necessário ter uma conexão de Internet ativa para fazer o download de uma nova imagem. |
Startup Orientation | Selecione uma opção para a orientação inicial do emulador:
Uma opção só será ativada se estiver selecionada no perfil de hardware. Ao executar o AVD no emulador, você poderá alterar a orientação se ambas as opções forem compatíveis com o perfil de hardware. |
Camera (Advanced) | Para ativar uma câmera, selecione uma ou ambas as opções:
A configuração Emulated produz uma imagem gerada por software, e a configuração Webcam usa a webcam do computador de desenvolvimento para tirar uma foto. Essa opção só será disponibilizada se for selecionada no perfil de hardware. Ela não está disponível para dispositivos Wear OS e Android TV. |
Network: Speed (Advanced) | Selecione um protocolo de rede para determinar a velocidade da transferência de dados:
|
Network: Latency (Advanced) | Selecione um protocolo de rede para definir quanto tempo (atraso) é necessário para que o protocolo transfira um pacote de dados de um ponto a outro. |
Emulated Performance: Graphics | Selecione como gráficos são renderizados no emulador:
|
Emulated Performance: Boot option (Advanced) |
|
Emulated Performance: Multi-Core CPU (Advanced) | Selecione o número de núcleos de processador que você quer usar para o emulador no computador. O uso de mais núcleos de processador agiliza o emulador. |
Memory and Storage: RAM | A quantidade de RAM no dispositivo. Esse valor é definido pelo fabricante do hardware, mas você pode modificá-lo, se necessário, para agilizar a operação do emulador. O aumento do tamanho consome mais recursos no computador. Digite um tamanho de RAM e selecione a unidade B (byte), KB (kilobyte), MB (megabyte), GB (gigabyte) ou TB (terabyte). |
Memory and Storage: VM Heap | O tamanho de heap da VM. Esse valor é definido pelo fabricante do hardware, mas você pode modificá-lo, se necessário. Digite um tamanho de heap e selecione a unidade B (byte), KB (kilobyte), MB (megabyte), GB (gigabyte) ou TB (terabyte). Para ver mais informações sobre VMs Android, consulte Gerenciamento de memória para diferentes máquinas virtuais. |
Memory and Storage: Internal Storage | A quantidade de espaço disponível na memória não removível do dispositivo. Esse valor é definido pelo fabricante do hardware, mas você pode modificá-lo, se necessário. Digite um tamanho e selecione a unidade B (byte), KB (kilobyte), MB (megabyte), GB (gigabyte) ou TB (terabyte). |
Memory and Storage: SD Card | A quantidade de espaço disponível para armazenar dados na memória removível do dispositivo. Para usar um cartão SD virtual gerenciado pelo Android Studio, selecione Studio-managed, digite um tamanho e selecione a unidade B (byte), KB (kilobyte), MB (megabyte), GB (gigabyte) ou TB (terabyte). É recomendável um mínimo de 100 MB para usar a câmera. Para gerenciar o espaço em um arquivo, selecione External file e clique em ... para especificar o arquivo e o local. Para mais informações, consulte mksdcard e Diretório de dados do AVD. |
Device Frame: Enable Device Frame | Selecione para ativar um quadro em volta da janela do emulador, imitando a aparência de um dispositivo real. |
Custom Skin Definition (Advanced) | Selecione uma skin que controle a aparência do dispositivo quando ele é exibido no emulador. Lembre-se de que especificar uma tela muito grande para a aparência pode fazer com que a tela seja cortada, impedindo a visualização completa. Para ver mais informações, consulte Criar uma aparência de emulador. |
Keyboard: Enable Keyboard Input (Advanced) | Selecione essa opção se quiser usar o teclado do hardware para interagir com o emulador. A opção é desativada para dispositivos Wear OS e Android TV. |
Criar uma aparência de emulador
Uma aparência de emulador do Android é um conjunto de arquivos que definem os elementos visuais e de controle da tela de um emulador. Se as definições de aparência disponíveis nas configurações do AVD não atenderem aos seus requisitos, você poderá criar a própria definição de aparência personalizada e aplicá-la ao AVD.
Cada aparência de emulador contém:
- Um arquivo
hardware.ini
- Arquivos de layout para as orientações (paisagem, retrato) e configurações físicas compatíveis
- Arquivos de imagem para elementos de exibição, como plano de fundo, teclas e botões
Para criar e usar uma aparência personalizada:
- Crie um novo diretório para salvar seus arquivos de configuração da aparência.
- Defina a aparência visual em um arquivo de texto com o nome
layout
. Esse arquivo define muitas características da aparência, como o tamanho e os recursos de imagem para botões específicos. Exemplo:parts { device { display { width 320 height 480 x 0 y 0 } }
portrait { background { image background_port.png } buttons { power { image button_vertical.png x 1229 y 616 } } } ...
}
- Adicione os arquivos bitmap das imagens do dispositivo no mesmo diretório.
- Especifique outras configurações de dispositivo específicas de hardware em um arquivo
hardware.ini
para as configurações do dispositivo, comohw.keyboard
ehw.lcd.density
. - Coloque os arquivos na pasta de skin e selecione o arquivo como uma skin personalizada.
Para ver informações mais detalhadas sobre como criar aparências de emulador, consulte Especificação de arquivos de skin para o Android Emulator no código-fonte das ferramentas.