Criar e gerenciar dispositivos virtuais

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 Android 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, aparência 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, 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 Próxima.

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.

Selecione a imagem do sistema de um nível de API específico e clique em Next.

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 estar conectado à Internet.

O nível de 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.

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.

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 em um AVD e selecione Duplicate.

Ou clique em Menu e selecione Duplicate.

A página Verify Configuration é exibida.

Clique em Change ou Previous se precisar fazer alterações nas páginas System Image e Select Hardware.
Faça suas alterações e clique em Finish.

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, altere 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.

Ou então, clique com o botão direito no perfil de hardware e selecione Clone.

Na página Configure Hardware Profile, altere as propriedades do perfil de hardware conforme necessário.

Clique em Finish.

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 faça suas alterações.
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 Menu e 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: Phone/Tablet Wear OS Android TV Dispositivo Chrome OS Android Automotive
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: None: nenhum controle de hardware. A navegação é realizada pelo software D-pad: compatível com o botão direcional Trackball Wheel 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: Portrait: a orientação é mais alta do que larga. Landscape: a orientação é mais larga do que alta. 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: Back-Facing Camera: a lente está na direção oposta ao usuário. Front-Facing Camera: a lente está na direção do usuário. 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.
Default Skin	Selecione uma opção 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: Portrait: a orientação é mais alta do que larga. Landscape: a orientação é mais larga do que alta. 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: Front: a lente está na direção oposta ao usuário. Back: a lente está na direção do usuário. 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: 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 HSDPA: High-Speed Downlink Packet Access LTE: Long-Term Evolution Full (default): transfira dados com a velocidade máxima permitida pelo computador
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: Hardware: use a placa de vídeo do computador para renderizar mais rapidamente. Software: emule os elementos gráficos no software, o que será útil se você tiver problemas para renderizar na placa de vídeo. Auto: deixe que o emulador decida a melhor opção de acordo com sua placa de vídeo.
Emulated Performance: Boot option (Advanced)	Cold boot: inicie o dispositivo a cada vez, ligando-o a partir do estado de dispositivo desligado. Quick boot: inicie o dispositivo carregando o estado a partir de um instantâneo salvo. Para saber mais detalhes, consulte Executar o emulador com Quick Boot.
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 opção 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, como hw.keyboard e hw.lcd.density.
Coloque os arquivos na pasta de aparências e selecione o arquivo como aparência personalizada.

Para ver informações mais detalhadas sobre como criar aparências de emulador, consulte Especificação de arquivos de aparência para o Android Emulator no código-fonte das ferramentas.