Gerenciando dispositivos virtuais com o Android Device Manager

Este artigo explica como usar o Android Device Manager para criar e configurar AVDs (Dispositivos Virtuais Android) que emulam dispositivos físicos Android. É possível usar esses dispositivos virtuais para executar e testar aplicativos, sem a necessidade de um dispositivo físico.

Depois de ter verificado se a aceleração de hardware está habilitada (conforme descrito em Aceleração de hardware para o desempenho do emulador), a próxima etapa é usar o Android Device Manager (também conhecido como o Xamarin Android Device Manager) para criar dispositivos virtuais que você pode usar para testar e depurar o aplicativo.

Android Device Manager no Windows

Este artigo explica como usar o Android Device Manager para criar, duplicar, personalizar e iniciar dispositivos virtuais Android.

Screenshot of the Android Device Manager in the Devices tab

O Android Device Manager é usado para criar e configurar AVDs (Dispositivos Virtuais Android) que são executados no Android Emulator. Cada AVD é uma configuração de emulador que simula um dispositivo Android físico. Assim, é possível executar e testar aplicativos em uma variedade de configurações que simulam diferentes dispositivos Android físicos.

Requisitos

Para usar o Android Device Manager, os seguintes serão necessários:

  • Visual Studio 2019 Community, Professional ou Enterprise.

  • OU o Visual Studio 2017 versão 15.8 ou posterior é necessário. As edições Community, Professional e Enterprise do Visual Studio são compatíveis.

  • Ferramentas do Visual Studio para Xamarin versão 4.9 ou posterior.

  • O SDK do Android precisa ser instalado (confira Configurando o SDK do Android para Xamarin.Android). Instale o SDK do Android em seu local padrão se ele ainda não estiver instalado: C:\Arquivos de Programas (x86)\Android\android-sdk.

  • Os pacotes a seguir precisam ser instalados (por meio do Gerenciador do SDK do Android):

    • Android SDK Tools versão 26.1.1 ou posterior
    • Ferramentas da Plataforma SDK do Android 27.0.1 ou posterior
    • Ferramentas de Build do SDK do Android 27.0.3 ou posterior
    • Android Emulator 27.2.7 ou posterior.

    Esses pacotes devem ser exibidos com o status Instalado, conforme mostrado na captura de tela a seguir:

    Installing Android SDK Tools

Inicializar o Gerenciador de Dispositivos

Inicie o Android Gerenciador de Dispositivos no menu Ferramentas clicando em Ferramentas > Android > Android Gerenciador de Dispositivos:

Launching the Device manager from the Tools menu

Se a caixa de diálogo de erro a seguir for exibida na inicialização, confira a seção Solução de Problemas para obter instruções de soluções alternativas:

Android SDK instance error dialog

Tela principal

Quando o Gerenciador de Dispositivos Android é iniciado pela primeira vez, uma tela exibe todos os dispositivos virtuais configurados no momento. Para cada dispositivo virtual, o Nome, o Sistema Operacional (versão do Android), o Processador, o tamanho da Memória e a Resolução de tela são exibidos:

List of installed devices and their parameters

Ao selecionar um dispositivo na lista, o botão Iniciar é exibido no lado direito. É possível clicar no botão Iniciar para inicializar o emulador com este dispositivo virtual:

Start button for a device image

Depois da inicialização do emulador com o dispositivo virtual selecionado, o botão Iniciar se transforma em um botão Parar, que pode ser utilizado para interromper o emulador:

Stop button for the running device

Novo dispositivo

Para criar um novo dispositivo, clique no botão Novo (na área superior direita da tela):

New button for creating a new device

Ao clicar em Novo, a tela Novo Dispositivo é iniciada:

New Device screen of the Device Manager

Para configurar um novo dispositivo na tela Novo Dispositivo, siga estas etapas:

  1. Nomeie o novo dispositivo. No exemplo a seguir, o nome do novo dispositivo é Pixel_API_27:

    Naming the new device

  2. Selecione um dispositivo físico a ser emulado clicando no menu suspenso Dispositivo Base:

    Selecting the physical device to emulate

  3. Selecione um tipo de processador para este dispositivo virtual clicando no menu suspenso Processador. Selecionar x86 fornecerá o melhor desempenho porque permite que o emulador tirar proveito da aceleração de hardware. A opção x86_64 também utiliza a aceleração de hardware, mas é executado um pouco mais lentamente do que a x86 (normalmente, a opção x86_64 é usada para testar aplicativos de 64 bits):

    Selecting the processor type

  4. Selecione a versão do Android (nível da API) clicando no menu suspenso SO. Por exemplo, selecione Oreo 8.1 – API 27 para criar um dispositivo virtual para o nível da API 27:

    Selecting the Android version

    Se você selecionar um nível de API de Android que ainda não foi instalado, o Gerenciador de Dispositivos exibirá uma nova mensagem de download na parte inferior da tela– ele baixará e instalará os arquivos necessários à medida que criar o novo dispositivo virtual:

    A new device image will be downloaded

  5. Se você quiser incluir APIs do Google Play Services em seu dispositivo virtual, habilite a opção APIs do Google. Para incluir o aplicativo do Google Play Store, habilite a opção Google Play Store:

    Selecting Google Play Services and Google Play Store

    Observe que as imagens do Google Play Store estão disponíveis apenas para alguns tipos de dispositivos básicos, como Pixel, Pixel 2, Nexus 5 e Nexus 5X.

  6. Edite todas as propriedades que você precisa modificar. Para alterar as propriedades, consulte Edição de propriedades do Dispositivo Virtual Android.

  7. Adicione todas as propriedades adicionais que precisem ser definidas explicitamente. A tela Novo Dispositivo mostra apenas as propriedades modificadas maior frequência, mas é possível clicar no menu suspenso Adicionar Propriedade (na parte inferior) para adicionar outras propriedades:

    Add Property pull-down menu

    Você também pode definir uma propriedade personalizada selecionando Custom... na parte superior da lista de propriedades.

  8. Clique no botão Criar (canto inferior direito) para criar o novo dispositivo:

    Create button

  9. A tela Aceitação da Licença pode ser exibida. Clique em Aceitar se você concordar com os termos da licença:

    License Acceptance screen

  10. O Android Device Manager adiciona o novo dispositivo à lista de dispositivos virtuais instalados, mostrando um indicador de progresso Criando durante a criação do dispositivo:

    Creation progress Indicator

  11. Quando o processo de criação é concluído, o novo dispositivo é mostrado na lista de dispositivos virtuais instalados com um botão Iniciar, pronto para ser inicializado:

    Newly-created device ready to launch

Editar Dispositivo

Para editar um dispositivo virtual existente, selecione-o e clique no botão Editar (localizado no canto superior direito da tela):

Edit button for modifying a device

Clicar em Editar inicializa o Editor de Dispositivo do dispositivo virtual selecionado:

Device Editor screen

A tela Editor de Dispositivos lista as propriedades do dispositivo virtual na coluna Propriedade, com os valores correspondentes de cada propriedade na coluna Valor. Ao selecionar uma propriedade, uma descrição detalhada é exibida à direita.

Para alterar uma propriedade, edite seu valor na coluna Valor. Por exemplo, na captura de tela a seguir, a propriedade hw.lcd.density é alterada de 480 para 240:

Device Editing example

Depois de fazer as alterações de configuração necessárias, clique no botão Salvar. Para obter mais informações sobre como alterar propriedades do dispositivo virtual, consulte Edição de propriedades do Dispositivo Virtual Android.

Opções adicionais

Opções adicionais para trabalhar com dispositivos estão disponíveis no menu pull-down Opções Adicionais (...) no canto superior direito:

Location of additional options menu

O menu de opções adicionais contém os seguintes itens:

  • Duplicar e editar – duplica o dispositivo selecionado no momento e o abre na tela Novo Dispositivo com um nome exclusivo diferente. Por exemplo, selecionar Pixel_API_27 e clicar em Duplicar e Editar acrescenta um contador ao nome:

    Duplicate and Edit screen

  • Revelação no Explorer – abre uma janela Windows Explorer na pasta que contém os arquivos do dispositivo virtual. Por exemplo, selecionar Pixel_API_27 e clicar em Revelar no Explorer abre uma janela como o exemplo a seguir:

    Results of clicking Reveal in Explorer

  • Redefinição de fábrica – redefine o dispositivo selecionado para suas configurações padrão, apagando as alterações de usuário feitas no estado interno do dispositivo durante a execução (isso também apaga o instantâneo de Inicialização Rápida atual, se houver). Essa alteração não altera as modificações feitas no dispositivo virtual durante a criação e a edição. Uma caixa de diálogo será exibida com o lembrete de que essa redefinição não pode ser desfeita. Clique em Redefinição de Fábrica para confirmar a redefinição:

    Factory Reset dialog

  • Excluir – exclui permanentemente o dispositivo virtual selecionado. Uma caixa de diálogo será exibida com o lembrete de que a ação de excluir um dispositivo não pode ser desfeita. Clique em Excluir se tiver certeza de que deseja excluir o dispositivo.

    Delete device dialog

Observação

Se você estiver usando um Mac com um chip apple, como o M1, precisará instalar o Android Emulator para visualização M1 de GitHub.

Android Device Manager no macOS

Este artigo explica como usar o Android Device Manager para criar, duplicar, personalizar e iniciar dispositivos virtuais Android.

Screenshot of the Android Device Manager in the Devices tab

O Android Device Manager é usado para criar e configurar AVDs (Dispositivos Virtuais Android) que são executados no Android Emulator. Cada AVD é uma configuração de emulador que simula um dispositivo Android físico. Assim, é possível executar e testar aplicativos em uma variedade de configurações que simulam diferentes dispositivos Android físicos.

Requisitos

Para usar o Android Device Manager, os seguintes serão necessários:

  • Visual Studio para Mac 7.6 ou posterior.

  • O SDK do Android precisa ser instalado (confira Configurando o SDK do Android para Xamarin.Android).

  • Os pacotes a seguir precisam ser instalados (por meio do Gerenciador do SDK do Android):

    • SDK Tools versão 26.1.1 ou posterior
    • Ferramentas da Plataforma SDK do Android 28.0.1 ou posterior
    • Ferramentas de Build do SDK do Android 26.0.3 ou posterior

    Esses pacotes devem ser exibidos com o status Instalado, conforme mostrado na captura de tela a seguir:

    Installing Android SDK Tools

Inicializar o Gerenciador de Dispositivos

Inicie o Android Gerenciador de Dispositivos clicando em Ferramentas > Gerenciador de Dispositivos:

Launching the Device manager from the Tools menu

Se a caixa de diálogo de erro a seguir for exibida na inicialização, confira a seção Solução de Problemas para obter instruções de soluções alternativas:

Screenshot shows the Android SDK instance error dialog box for troubleshooting information.

Tela principal

Quando o Gerenciador de Dispositivos Android é iniciado pela primeira vez, uma tela exibe todos os dispositivos virtuais configurados no momento. Para cada dispositivo virtual, o Nome, o Sistema Operacional (versão do Android), o Processador, o tamanho da Memória e a Resolução de tela são exibidos:

List of installed devices and their parameters

Ao selecionar um dispositivo na lista, o botão Executar é exibido no lado direito. É possível clicar no botão Executar para inicializar o emulador com este dispositivo virtual:

Play button for a device image

Depois da inicialização do emulador com o dispositivo virtual selecionado, o botão Reproduzir se transforma em um botão Parar, que pode ser utilizado para interromper o emulador:

Stop button for the running device

Quando parar o emulador, você poderá ver um prompt perguntando se deseja salvar o estado atual para a próxima Inicialização Rápida:

Save current state for Quick Boot dialog

Salvar o estado atual fará com que o emulador seja inicializado com mais rapidez quando este dispositivo virtual for iniciado novamente. Para obter mais informações sobre a Inicialização Rápida, confira Inicialização Rápida.

Novo dispositivo

Para criar um novo dispositivo, clique no botão Novo Dispositivo (na área superior esquerda da tela):

New button for creating a new device

Clicar em Novo inicia a tela Novo Dispositivo:

New Device screen of the Device Manager

Para configurar um novo dispositivo na tela Novo Dispositivo, siga estas etapas:

  1. Nomeie o novo dispositivo. No exemplo a seguir, o nome do novo dispositivo é Pixel_API_27:

    Naming the new device

  2. Selecione um dispositivo físico a ser emulado clicando no menu suspenso Dispositivo Base:

    Selecting the physical device to emulate

  3. Selecione um tipo de processador para este dispositivo virtual clicando no menu suspenso Processador. Selecionar x86 fornecerá o melhor desempenho porque permite que o emulador tirar proveito da aceleração de hardware. A opção x86_64 também utiliza a aceleração de hardware, mas é executado um pouco mais lentamente do que a x86 (normalmente, a opção x86_64 é usada para testar aplicativos de 64 bits):

    Selecting the processor type

  4. Selecione a versão do Android (nível da API) clicando no menu suspenso SO. Por exemplo, selecione Oreo 8.1 – API 27 para criar um dispositivo virtual para o nível da API 27:

    Selecting the Android version

    Se você selecionar um Android nível de API que ainda não foi instalado, o Gerenciador de Dispositivos exibirá uma nova mensagem do dispositivo será baixada na parte inferior da tela– ele baixará e instalará os arquivos necessários ao criar o novo dispositivo virtual:

    A new device image will be downloaded

  5. Se você quiser incluir APIs do Google Play Services em seu dispositivo virtual, habilite a opção APIs do Google. Para incluir o aplicativo do Google Play Store, habilite a opção Google Play Store:

    Selecting Google Play Services and Google Play Store

    Observe que as imagens do Google Play Store estão disponíveis apenas para alguns tipos de dispositivos básicos, como Pixel, Pixel 2, Nexus 5 e Nexus 5X.

  6. Edite todas as propriedades que você precisa modificar. Para alterar as propriedades, consulte Edição de propriedades do Dispositivo Virtual Android.

  7. Adicione todas as propriedades adicionais que precisem ser definidas explicitamente. A tela Novo Dispositivo mostra apenas as propriedades modificadas maior frequência, mas é possível clicar no menu suspenso Adicionar Propriedade (na parte inferior) para adicionar outras propriedades:

    Add Property pull-down menu

    Você também pode definir uma propriedade personalizada clicando em Personalizado... na parte superior da lista de propriedades.

  8. Clique no botão Criar (canto inferior direito) para criar o novo dispositivo:

    Create button

  9. O Android Device Manager adiciona o novo dispositivo à lista de dispositivos virtuais instalados, mostrando um indicador de progresso Criando durante a criação do dispositivo:

    Creation progress indicator

  10. Quando o processo de criação é concluído, o novo dispositivo é mostrado na lista de dispositivos virtuais instalados com um botão Iniciar, pronto para ser inicializado:

    Newly-created device ready to launch

Editar Dispositivo

Para editar um dispositivo virtual existente, clique no menu suspenso Opções Adicionais (ícone de engrenagem) e selecione Editar:

Edit menu selection for modifying a new device

Clicar em Editar inicializa o Editor de Dispositivo do dispositivo virtual selecionado:

Device Editor screen

A tela Editor de Dispositivos lista as propriedades do dispositivo virtual na coluna Propriedade, com os valores correspondentes de cada propriedade na coluna Valor. Ao selecionar uma propriedade, uma descrição detalhada é exibida à direita.

Para alterar uma propriedade, edite seu valor na coluna Valor. Por exemplo, na captura de tela a seguir, a propriedade hw.lcd.density é alterada de 480 para 240:

Device Editing example

Depois de fazer as alterações de configuração necessárias, clique no botão Salvar. Para obter mais informações sobre como alterar propriedades do dispositivo virtual, consulte Edição de propriedades do Dispositivo Virtual Android.

Opções adicionais

As opções adicionais para trabalhar com os dispositivos estão disponíveis no menu suspenso localizado à esquerda do botão Reproduzir:

Location of additional options menu

O menu de opções adicionais contém os seguintes itens:

  • Editar – abre o dispositivo atualmente selecionado no editor do dispositivo, conforme descrito anteriormente.

  • Duplicar e Editar – duplica o dispositivo selecionado no momento e o abre na tela Novo Dispositivo com um nome exclusivo diferente. Por exemplo, selecionar Pixel 2 API 28 e clicar em Duplicar e Editar acrescenta um contador ao nome:

    Duplicate and Edit screen

  • Revelação no Finder – Abre uma janela macOS Finder na pasta que contém os arquivos do dispositivo virtual. Por exemplo, selecionar Pixel 2 API 28 e clicar em Revelar no Finder abre uma janela como a do exemplo a seguir:

    Results of clicking Reveal in Finder

  • Redefinição de fábrica – redefine o dispositivo selecionado para suas configurações padrão, apagando quaisquer alterações de usuário feitas no estado interno do dispositivo durante a execução (isso também apaga o instantâneo de Inicialização Rápida atual, se houver). Essa alteração não altera as modificações feitas no dispositivo virtual durante a criação e a edição. Uma caixa de diálogo será exibida com o lembrete de que essa redefinição não pode ser desfeita. Clique em Redefinição de Fábrica para confirmar a redefinição.

    Factory reset dialog

  • Excluir – exclui permanentemente o dispositivo virtual selecionado. Uma caixa de diálogo será exibida com o lembrete de que a ação de excluir um dispositivo não pode ser desfeita. Clique em Excluir se tiver certeza de que deseja excluir o dispositivo.

    Delete device dialog


Solução de problemas

As seções a seguir explicam como diagnosticar e solucionar problemas que podem ocorrer durante o uso do Android Device Manager para configurar dispositivos virtuais.

SDK do Android em local não padrão

Normalmente, o SDK do Android está instalado neste local:

C:\Arquivos de Programas (x86)\Android\android-sdk

Se o SDK não estiver instalado nesse local, você poderá ver este erro ao iniciar o Android Device Manager:

Android SDK instance error

Para contornar esse problema, execute as etapas a seguir:

  1. Na área de trabalho Windows, navegue até C:\Users\username\AppData\Roaming\XamarinDeviceManager:

    Android Device Manager log file location

  2. Clique duas vezes para abrir um dos arquivos de log e localize o Caminho do arquivo de configuração. Por exemplo:

    Config file path in log file

  3. Navegue até esse local e clique duas vezes em user.config para abri-lo.

  4. Em user.config, localize o elemento <UserSettings> e adicione um atributo AndroidSdkPath a ele. Defina esse atributo no caminho em que o SDK do Android está instalado no computador e salve o arquivo. Por exemplo, <UserSettings> seria semelhante ao seguinte se o SDK do Android fosse instalado em C:\Programs\Android\SDK:

    <UserSettings SdkLibLastWriteTimeUtcTicks="636409365200000000" AndroidSdkPath="C:ProgramsAndroidSDK" />
    

Depois de fazer essa alteração em user.config, você poderá iniciar o Android Device Manager.

Versão incorreta do Android SDK Tools

Se a versão 26.1.1 ou posterior das Android SDK Tools não estiverem instaladas, este erro será exibido na inicialização:

Screenshot shows the Android SDK instance error dialog box.

Se essa caixa de diálogo de erro for exibida, clique em Abrir Gerenciador de SDK para abrir o Gerenciador do SDK do Android. No Gerenciador do SDK do Android, clique na guia Ferramentas e instale os seguintes pacotes:

  • Android SDK Tools 26.1.1 ou posterior
  • Ferramentas da Plataforma SDK do Android 27.0.1 ou posterior
  • Ferramentas de Build do SDK do Android 27.0.3 ou posterior

O Snapshot desabilita o WiFi no Android Oreo

Se você configurou um AVD para o Android Oreo com acesso Wi-Fi simulado, reiniciar o AVD após um instantâneo pode fazer com esse acesso seja desabilitado.

Para solucionar esse problema:

  1. Selecione o AVD no Android Device Manager.

  2. No menu de opções adicionais, clique em Revelar no Explorer.

  3. Navegue até instantâneos > default_boot.

  4. Exclua o arquivo snapshot.pb:

    Location of the snapshot.pb file

  5. Reinicie o AVD.

Depois que essas alterações forem feitas, o AVD será reiniciado em um estado que permita que o Wi-Fi funcione novamente.

Gerando um relatório de bugs

Se encontrar um problema com o Android Device Manager que não pode ser resolvido usando as dicas de solução de problemas acima, envie um relatório de bugs clicando com o botão direito do mouse na barra de título e selecionando Gerar Relatório de Bugs:

Location of menu item for filing a bug report

Resumo

Este guia apresentou o Android Device Manager disponível nas Ferramentas do Visual Studio para Xamarin e no Visual Studio para Mac. Os recursos essenciais foram explicados, como iniciar e parar o Android Emulator, selecionar um AVD (Dispositivo Virtual Android) para execução, criar novos dispositivos virtuais e como editar um dispositivo virtual. Foi explicado como editar propriedades de hardware de perfil para personalização adicional e fornecidas dicas de solução de problemas comuns.

Encontre mais vídeos sobre o Xamarin no Channel 9 e no YouTube.