Criar e gerenciar dispositivos virtuais

Um Android Virtual Device (AVD) é uma configuração que define as características de um smartphone ou tablet Android ou de um dispositivo Wear OS ou Android TV que você quer simular no Android Emulator. O AVD Manager é uma interface que você pode lançar do Android Studio para ajudar a criar e gerenciar AVDs.

Para abrir o AVD Manager, execute uma das seguintes ações:

• Selecione Tools > AVD Manager.
• Clique em AVD Manager na barra de ferramentas.

Sobre os AVDs

Um AVD contém um perfil de hardware, uma imagem de sistema, uma área de armazenamento, uma aparência e outras propriedades.

Recomendamos que você crie um AVD para cada imagem do sistema que possa ser compatível com o aplicativo, de acordo com a configuração <uses-sdk> no 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 a necessidade.

Observe que somente alguns perfis de hardware estão indicados para incluir o Play Store. Isso indica que esses perfis são totalmente compatíveis com CTS e podem usar imagens do sistema que incluem o aplicativo Play Store.

Imagens do sistema

Uma imagem do sistema identificada com as Google APIs inclui acesso aos serviços do Google Play . Uma imagem do sistema identificada com a logotipo do Google Play na coluna Play Store inclui o aplicativo da Google Play Store e o acesso aos serviços do Google Play, como uma guia do Google Play na caixa de diálogo de Extended controls que fornece um botão para a atualização dos serviços do Google Play no dispositivo.

Para garantir a segurança do aplicativo e uma experiência consistente nos dispositivos físicos, as imagens do sistema da Google Play Store são assinadas com uma chave de versão, o que significa que você não pode obter privilégios elevados (raiz) com elas . Se você precisar de privilégios elevados (raiz) para auxiliar na solução de problemas do seu aplicativo, use as imagens do sistema do Android Open Source Project (AOSP) que não contenham aplicativos ou serviços Google.

Área de armazenamento

O AVD tem uma área de armazenamento dedicada no seu computador de desenvolvimento. Ele armazena dados de usuários de dispositivos, como aplicativos 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 a aparência de um dispositivo. O AVD Manager fornece algumas aparências predefinidas. Também é possível definir suas próprias aparências ou usar aparências de terceiros.

AVD e recursos do aplicativo

Verifique se a definição do AVD inclui os recursos de dispositivo necessários para o aplicativo. Consulte Propriedades de um perfil de hardware e Propriedades de um AVD para obter listas de recursos que podem ser definidos nos AVDs.

Criar um AVD

Dica: se você quiser lançar o aplicativo em um emulador, é melhor executar o aplicativo no Android Studio e, na caixa de diálogo Select Deployment Target exibida, clicar em Create New Virtual Device.

Para criar um novo AVD:

1. Abra o AVD Manager clicando em Tools > AVD Manager.
2. Clique em Create Virtual Device na parte inferior da caixa de diálogo do AVD Manager.

   A página Select Hardware é exibida.

   

   Observe que somente alguns perfis de hardware estão indicados para incluir o Play Store. Isso indica que esses perfis são totalmente compatíveis com CTS e podem usar imagens de sistema que incluem o aplicativo Play Store.

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

Se não vir o perfil de hardware desejado, você poderá criar ou importar um.

A página System Image é exibida.


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

A guia Recommended lista as imagens de sistema recomendadas. As demais guias incluem uma lista mais completa. O painel direito descreve a imagem de sistema selecionada. As imagens x86 são as que executam mais rápido no emulador.

Se você vir Download ao lado da imagem do sistema, será necessário clicar nela para fazer o seu download. Para isso, é preciso estar conectado à Internet.

O nível de API do dispositivo de destino é importante, pois seu aplicativo não poderá ser executado em uma imagem de sistema com um nível de API inferior ao exigido pelo aplicativo, como especificado no atributo minSdkVersion do arquivo de manifesto do aplicativo. Para obter mais informações sobre o relacionamento entre o nível da API de sistema e minSdkVersion, consulte Controlar as versões dos seus aplicativos.

Se o aplicativo declarar um elemento <uses-library> no arquivo de manifesto, ele precisará de uma imagem de sistema que contenha essa biblioteca externa. Se quiser executar o aplicativo 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 das Google APIs contém a biblioteca do Google Maps.

A página Verify Configuration é exibida.


5. Altere 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:

1. Na página Your Virtual Devices do AVD Manager, clique com o botão direito do mouse em um AVD e selecione Duplicate.

Você também pode clicar em Menu e selecionar Duplicate.

A página Verify Configuration é exibida.

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

O AVD é exibido na página Your Virtual Devices.

Criar um perfil de hardware

O AVD Manager fornece perfis de hardware predefinidos para dispositivos comuns para que você possa adicioná-los facilmente às suas definições de AVD. Se precisar definir um dispositivo diferente, você 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:

1. Na página Select Hardware, clique em New Hardware Profile.
2. Na página Configure Hardware Profile, altere as propriedades do perfil de hardware conforme a necessidade.
3. Clique em Finish.

Seu novo perfil de hardware aparece na página Select Hardware. Opcionalmente, você pode criar um AVD que usa 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:

1. Na página Select Hardware, selecione o perfil de hardware e clique em Clone Device.

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

2. Na página Configure Hardware Profile, altere as propriedades do perfil de hardware conforme a necessidade.
3. Clique em Finish.

Seu novo perfil de hardware aparece na página Select Hardware. Opcionalmente, você pode criar um AVD que usa 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 executar as seguintes operações em um AVD existente:

• Para editar um AVD, clique em Edit this AVD e faça as alterações.
• Para excluir um AVD, clique com o botão direito em um AVD 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 selecionar Show on Disk.
• Para visualizar os detalhes de configuração de um AVD que você pode incluir em qualquer relatório do bug para a equipe do Android Studio, clique com o botão direito do mouse em um AVD e selecione View Details. Ou clique em Menu e selecionar View Details.

Editar perfis de hardware existentes

Na página Select Hardware, você pode executar as seguintes operações em um perfil de hardware existente:

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

Você não pode 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 executar 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 do mouse em um AVD e selecione Stop. Ou clique em Menu e selecionar Stop.
• Para limpar os dados de um emulador e retorná-lo ao seu estado inicial, clique com o botão direito do mouse em um AVD e selecione Wipe Data. Ou clique em Menu e selecionar 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 do mouse e selecione Export. Especifique o local onde você deseja armazenar o arquivo XML que contém a definição.

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 o emulador está em execução substituem ambas.

Os perfis de hardware predefinidos incluídos com o AVD Manager não são editáveis. No entanto, você pode copiá-los e editar as cópias.

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ê deseja 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 o emulador está em execução substitui ambas.

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 sua própria definição de aparência personalizada e aplicá-la ao seu 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 o plano de fundo, as teclas e os botões

Para criar e usar uma aparência personalizada:

1. Crie um novo diretório onde você salvará seus arquivos de configuração da aparência.
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 ativos de imagem para botões específicos. Por 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 os arquivos bitmap das imagens do dispositivo no mesmo diretório.
4. Defina configurações específicas de hardware adicionais em um arquivo hardware.ini para as configurações de dispositivo como hw.keyboard e hw.lcd.density.
5. Coloque os arquivos na pasta de aparências e selecione o arquivo como uma aparência personalizada.

Para obter 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.