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 Ícone 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.
  4. Se não vir o perfil de hardware desejado, você poderá criar ou importar um.

    A página System Image é exibida.

  5. Selecione a imagem de sistema de um nível de API específico e clique em Next.
  6. 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.

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

  8. 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.
  2. Você também pode clicar em Menu e selecionar Duplicate.

    A página Verify Configuration é exibida.

  3. Clique em Change ou Previous se precisar fazer alterações nas páginas System Image e Select Hardware.
  4. Faça as alterações e clique em Finish.
  5. 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.
  4. 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.
  2. Ou clique com o botão direito no perfil de hardware e selecione Clone.

  3. Na página Configure Hardware Profile, altere as propriedades do perfil de hardware conforme a necessidade.
  4. Clique em Finish.
  5. 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.

Propriedade do 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 do perfil de hardware.
Device Type Selecione uma das seguintes opções:
  • Phone/Tablet
  • Wear OS
  • Android TV
Screen Size O tamanho físico da tela, em polegadas, medido na diagonal. Se a tela for maior do que a tela do seu computador, ela será reduzida 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 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 seu dispositivo tiver um teclado de hardware. Desmarque-a se não tiver. 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 - Suporte ao botão direcional.
  • Trackball
  • Wheel

Essas opções se destinam aos controles de hardware do dispositivo em si. No entanto, os eventos enviados ao dispositivo por um controlador externo são os mesmos.

Supported Device States

Selecione uma ou ambas as opções:

  • Portrait - Orientação mais alta do que larga.
  • Landscape - Orientação mais larga do que alta.

Se você selecionar ambas as opções, poderá alternar entre as orientações no emulador. Você deve 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 fornecida 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 sua orientação.
Sensors: Gyroscope Selecione se o dispositivo tiver um hardware que detecte rotação ou giro. Combinado a um acelerômetro, esse recurso pode oferecer uma detecção mais estável da orientação e oferecer suporte a um sistema de orientação de seis eixos.
Sensors: GPS Selecione se o dispositivo tiver um hardware que oferece suporte a um sistema de navegação baseado em um Sistema de Posicionamento Global (GPS) por satélite.
Sensors: Proximity Sensor Selecione se o dispositivo tiver um hardware que detecte se ele está próximo ao seu rosto durante uma chamada para desativar entradas da tela.
Default Skin Selecione uma aparência 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 sua visualização completa. Consulte Criar uma aparência de emulador para obter mais informações.

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.

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 do arquivo do AVD é derivado do código e você pode usá-lo para fazer referência ao AVD pela linha de comando.
Hardware Profile Clique em Change para selecionar um perfil de hardware diferente na página Select Hardware.
System Image Clique em Change para selecionar uma imagem de sistema diferente na página System Image. É necessário ter uma conexão ativa com a Internet para fazer o download de uma nova imagem.
Startup Orientation

Selecione uma opção para a orientação inicial do emulador:

  • Portrait - Orientação mais alta do que larga.
  • Landscape - 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 o perfil do hardware oferecer suporte às orientações de retrato e paisagem.

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 gráficos no software, o que será útil se você estiver com problemas para renderizar na placa gráfica.
  • Automatic - 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 seu estado de um instantâneo salvo. Para obter detalhes, consulte Executar o emulador com Quick Boot.
Emulated Performance: Multi-Core CPU (Advanced) Selecione o número de núcleos de processador no seu computador que quiser usar para o emulador. 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 substituí-lo, se necessário, para agilizar a operação do emulador, por exemplo. Aumentar o tamanho usa mais recursos no seu 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 pilha da VM. Esse valor é definido pelo fabricante do hardware, mas você pode substituí-lo, se necessário. Digite um tamanho de pilha e selecione a unidade B (byte), KB (kilobyte), MB (megabyte), GB (gigabyte) ou TB (terabyte). Para saber mais sobre as VMs do 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 substituí-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 da memória removível para armazenar dados no 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 obter 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 que imita a aparência de um dispositivo real.
Custom Skin Definition (Advanced) Selecione uma aparência que controla 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 sua visualização completa. Consulte Criar uma aparência de emulador para obter mais informações.
Keyboard: Enable Keyboard Input (Advanced) Selecione essa opção se quiser usar seu teclado de hardware para interagir com o emulador. A opção é desativada para 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 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.