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 Automotive OS que você queira simular no Android Emulator. O Gerenciador de dispositivos é uma ferramenta que pode ser iniciada no Android Studio para criar e gerenciar AVDs.

Para abrir o novo Gerenciador de dispositivos, siga um destes procedimentos:

• Na tela de boas-vindas do Android Studio, selecione More Actions > Virtual Device Manager.

• Depois de abrir um projeto, selecione View > Tool Windows > Device Manager na barra de menus principal, clique em + e em Create Virtual Device.

Depois de criar os dispositivos, você poderá ver uma lista de todos eles no painel do gerenciador de dispositivos.

Se você quiser usar dispositivos virtuais para executar testes instrumentados automatizados de maneira escalonável e autogerenciada, recomendamos o uso de dispositivos gerenciados pelo Gradle.

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 a que seu app possa oferecer suporte, 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 Gerenciador de dispositivos inclui alguns perfis de hardware carregados previamente, como no caso de dispositivos Pixel. É possível definir e personalizar esses perfis conforme necessário.

Uma definição de dispositivo identificada com o logotipo do Google Play na coluna Play Store inclui o app Google Play Store e o acesso ao Google Play Services, além da guia Google Play na caixa de diálogo Extended controls, que oferece um botão para atualização do Google Play Services no dispositivo.

Dispositivos com esse logotipo e um tipo de dispositivo "Smartphone" também oferecem compliance com o CTS e podem usar imagens do sistema que incluam o app da Play Store.

Imagens do sistema

Uma imagem do sistema identificada como Google APIs inclui acesso ao Google Play Services.

A guia Recommended lista as imagens do sistema recomendadas. As demais guias incluem uma lista mais completa. O painel direito descreve a imagem do sistema selecionada.

O ícone de download exibido ao lado de uma imagem do sistema indica que essa imagem não está instalada na máquina de desenvolvimento em uso. Clique nele para fazer o download. É necessário estar conectado à Internet.

O nível da API do dispositivo de destino é importante, porque o app não é executado em uma imagem do sistema que tenha um nível de API menor que o exigido, conforme especificado no atributo minSdk no arquivo de manifesto do app. Para mais informações sobre a relação entre o nível da API do sistema e o minSdk, consulte Controlar versões do app.

Se o app declara um elemento <uses-library> no arquivo de manifesto, isso indica que ele precisa de uma imagem do sistema que inclua essa biblioteca externa. Para executar o app em um emulador, crie um AVD que inclua a biblioteca necessária. Para isso, talvez você tenha que usar um componente de complemento para a plataforma do AVD. Por exemplo, o complemento de APIs do Google contém a biblioteca Google Maps.

Para garantir a segurança do app e uma experiência consistente em dispositivos físicos, as imagens do sistema que incluem a Google Play Store 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. Em seguida, use os comandos adb root e adb unroot para alternar entre privilégios normais e elevados:

  % adb shell
  emu64a:/ $
  emu64a:/ $ exit
  % adb root
  restarting adbd as root
  % adb shell
  emu64a:/ #
  emu64a:/ # exit
  % adb unroot
  restarting adbd as non root
  % adb shell
  emu64a:/ $
  emu64a:/ $ exit
  %
  

Á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, por exemplo, apps instalados e configurações, além de um cartão SD emulado. Se necessário, você pode usar o Gerenciador de dispositivos para excluir dados do usuário de forma permanente, de modo que o dispositivo fique como novo.

Skin

Uma aparência de emulador especifica o visual de um dispositivo. O Gerenciador de dispositivos oferece algumas skins predefinidas. Também é possível definir skins próprias ou usar aquelas 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 as seções Propriedades de um perfil de hardware e Propriedades de um AVD para encontrar listas de recursos que podem ser definidos nos AVDs.

Criar um AVD

Para criar um novo AVD, faça o seguinte:

1. Abra o Gerenciador de dispositivos.
2. Clique em Create Device.

   A janela Select Hardware vai aparecer.

   

   Apenas alguns perfis de hardware incluem a Play Store. Eles precisam estar em total compliance com o CTS e podem usar imagens do sistema que incluem o app da Play Store.

3. Selecione um perfil de hardware e clique em Next.

   Se o perfil de hardware que você quer usar não estiver disponível, é possível criar ou importar um, conforme descrito em outras seções desta página.

   A janela System Image é exibida.

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

A janela Verify Configuration é exibida.


5. Mude as propriedades do AVD conforme necessário e, em seguida, clique em Finish.

   Clique em Show Advanced Settings para mostrar mais configurações, por exemplo, a skin.

O novo AVD é exibido na guia Virtual do Gerenciador de dispositivos e no menu do dispositivo de destino.

Para criar um AVD usando uma cópia:

1. Na guia Virtual do Gerenciador de dispositivos, clique em Menu e selecione Duplicate.

   A janela Verify Configuration é exibida.

2. Clique em Previous se precisar fazer mudanças nas janelas System Image ou Select Hardware.
3. Faça as mudanças necessárias e, em seguida, clique em Finish.

   O AVD aparece na guia Virtual do Gerenciador de dispositivos.

Criar um perfil de hardware

O Gerenciador de dispositivos oferece perfis de hardware predefinidos para dispositivos comuns. Assim, eles podem ser adicionados facilmente às definições do seu AVD. Caso precise definir outro dispositivo, é possível criar um novo perfil de hardware.

Você pode definir um novo perfil de hardware do início ou copiar um 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:

1. Na janela Select Hardware, clique em New Hardware Profile.

2. Na janela Configure Hardware Profile, mude as propriedades do perfil de hardware conforme necessário.

   
3. Clique em Finish.

   O novo perfil de hardware é exibido na janela Select Hardware. Você pode criar um AVD que use o perfil de hardware, clicando em Next, ou clicar em Cancel para voltar à guia Virtual ou ao menu do dispositivo de destino.

Para criar um perfil de hardware usando uma cópia como ponto de partida:

1. Na janela Select Hardware, selecione um perfil e clique em Clone Device. Se preferir, clique com o botão direito do mouse em um perfil de hardware e selecione Clone.

2. Na janela Configure Hardware Profile, mude as propriedades do perfil de hardware conforme necessário.
3. Clique em Finish.

O novo perfil de hardware é exibido na janela Select Hardware. Você pode criar um AVD que use o perfil de hardware, clicando em Next, ou clicar em Cancel para voltar à guia Virtual ou ao menu do dispositivo de destino.

Editar AVDs já existentes

Você pode executar as seguintes operações em um AVD na guia Virtual do Gerenciador de dispositivos:

• Para editar um AVD, clique em Edit this AVD e faça as modificações.
• Para excluir um AVD, clique em Menu e selecione Delete.
• Para mostrar o AVD INI associado e os arquivos IMG no disco, clique em Menu e selecione Show on Disk.
• Para conferir as informações de configuração de um AVD que podem ser incluídas em relatórios de bugs para a equipe do Android Studio, clique em Menu e selecione View Details.

Editar perfis de hardware já existentes

Não é possível editar ou excluir os perfis de hardware carregados previamente, mas você pode realizar as seguintes operações em outros perfis na janela Select Hardware:

• Para editar um perfil de hardware, selecione-o e clique em Edit Device. Se preferir, clique com o botão direito do mouse em um perfil de hardware e selecione Edit. Em seguida, faça as modificações.
• Para excluir um perfil de hardware, clique nele com o botão direito e selecione Delete.

Executar e parar um emulador e limpar os dados

Na guia Virtual, é possível executar as seguintes operações em um emulador:

• Para executar um emulador que usa um AVD, clique em Launch .
• Para interromper a execução do emulador, clique em Menu e selecione Stop.
• Para limpar os dados de um emulador, clique em Menu e selecione Wipe Data.

Importar e exportar perfis de hardware

Na janela Select Hardware, é possível importar e exportar perfis de hardware da seguinte maneira:

• Para importar um perfil de hardware, clique em Import Hardware Profiles e, no seu computador, selecione o arquivo XML que contém a definição.
• 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 deve ser armazenado.

Propriedades de um AVD

A configuração do AVD especifica a interação entre o computador de desenvolvimento e o emulador, bem como as propriedades que você pretende substituir no perfil de hardware. É possível especificar as propriedades a seguir para as configurações do AVD, na página Verify Configuration. Uma propriedade identificada como (Avançada) só é exibida quando você clica em Show Advanced Settings.

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 as duas.

Tabela 1. Propriedades de configuração de um AVD

Propriedades de um perfil de hardware

Você pode especificar as propriedades a seguir para perfis de hardware na janela 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 as duas.

Os perfis de hardware predefinidos do Gerenciador de dispositivos não são editáveis. No entanto, você pode copiá-los e editar as cópias.

Algumas propriedades estão desativadas em alguns tipos de dispositivos. Por exemplo, a propriedade "Round" só está disponível em dispositivos Wear OS.

Tabela 2. Propriedades de configuração de um perfil de hardware

Criar uma aparência do 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 skin disponíveis nas configurações do AVD não atendem aos seus requisitos, você pode criar uma definição de skin personalizada e a aplicar ao AVD.

Cada aparência de emulador contém:

• Um arquivo hardware.ini
• Arquivos de layout para as orientações e configurações físicas com suporte
• Arquivos de imagem para elementos de exibição, como plano de fundo, teclas e botões

Para criar e usar uma skin personalizada:

1. Crie um diretório em que você possa salvar os arquivos de configuração da skin.
2. 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
               }
           }
       }
       ...
   }
   

3. Adicione arquivos bitmap das imagens do dispositivo ao mesmo diretório.
4. Determine outras configurações do dispositivo específicas de hardware em um arquivo INI para as configurações do dispositivo, por exemplo, hw.keyboard e hw.lcd.density.
5. Coloque os arquivos na pasta de skins e selecione o arquivo como uma skin personalizada.

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