Baixar e instalar o Android Emulator do Surface Duo

A imagem do emulador do Surface Duo (para usar com o Android Emulator) pode ser usada para desenvolver e testar seus aplicativos com tamanhos de tela diferentes para Surface Duo e Surface Duo 2.

Configurar o ambiente de desenvolvimento do Surface Duo

Você precisa ter seu ambiente de desenvolvimento de Android configurado e atualizado antes de instalar o SDK do Surface Duo. Se você não tiver o Android Studio instalado, baixe a versão mais recente e as ferramentas de linha de comando em developer.android.com. Inclua o emulador para Android do Google que você instala usando o gerenciador de SDK no menu Ferramentas do Android Studio. Em novas instalações, as opções padrão o farão automaticamente.

Pré-requisitos do emulador do Surface Duo

  • Para obter a funcionalidade completa do emulador do Surface Duo, instale o Android Emulator versão 31.3.12 ou mais recente (ou se você usar o canal canário, versão 32.1.5 ou mais recente).

  • Use o Gerenciador de SDK para garantir que todas as ferramentas de desenvolvimento necessárias (ferramentas de Build do SDK do Android, ferramentas de plataforma do SDK do Android e Android Emulator) estejam atualizadas.

    Gerenciador de SDK

Atualização das variáveis de ambiente

Se você alterou o local de instalação do SDK do Android do padrão, atualize as variáveis de ambiente com base em como suas ferramentas de SDK do Android são definidas, especialmente ANDROID_SDK_ROOT, se você usa o Android Studio.

Aceleração de hardware

A virtualização de hardware está disponível para o emulador do Surface Duo. Siga as diretrizes descritas em aceleração do emulador nos documentos do Android Studio para configurar o seu sistema.

Microsoft Visual Studio para Xamarin e .NET MAUI

O Visual Studio instala sua própria versão do SDK e do emulador do Android. Siga estas etapas para configurar seu ambiente de desenvolvimento e use o Visual Studio para gerenciar as configurações do SDK do Android:

  1. Obtenha a versão mais recente do Visual Studio e verifique se as cargas de trabalho maui do Xamarin ou do .NET estão instaladas.
  2. Verifique se o SDK do Android está instalado seguindo estas instruções do Visual Studio.
  3. Confira o Guia de aceleração de hardware para obter o melhor desempenho do emulador.

Observação

O gerenciamento do SDK do Android do Visual Studio usa como padrão versões específicas e testadas do SDK e das ferramentas do Android. Isso pode impedir que você atualize para a versão mais recente do Android Emulator ou outras ferramentas assim que elas estiverem disponíveis. Leia o guia do emulador específico do Xamarin para obter detalhes sobre como atualizar para a versão mais recente.

Ubuntu/Debian

  • Atenda aos pré-requisitos de instalação.
  • O pacote de software KVM é necessário. Conclua as etapas em Configurar aceleração de VM no Linux para instalar o KVM.
    • Depois de instalar o KVM, verifique se o usuário atual (conectado) foi adicionado ao grupo do KVM.

      $ groups
      <current user> sudo plugdev kvm libvirt
      
    • Se o usuário atual não estiver no grupo do KVM, execute o seguinte comando para adicioná-lo:

      sudo usermod -a -G kvm <current user>
      
    • Reinicialize o computador.

Apple Mac

São necessárias apenas as instruções de instalação do Android Studio com as configurações padrão. Certifique-se de executar atualizações para o SDK mais recente se você já tiver o Android Studio instalado.

Há dois instaladores separados do Emulador do Surface Duo para Mac : um para Macs baseados em Intel mais antigos e um instalador separado para Macs mais recentes baseados no Apple Silicon com M1 ou M2. Certifique-se de escolher o instalador correto para o computador – Macs mais antigos devem usar o instalador com x86_64 no nome do arquivo, Os Macs do Apple Silicon devem usar o instalador com arm64 no nome do arquivo.

Baixar e instalar a imagem do emulador do Surface Duo

Baixe a imagem do emulador do Surface Duo no Centro de Download da Microsoft. Os arquivos são nomeados SurfaceDuoEmulator_ [API do Android] _ [versão] _ [plataforma]. Há variantes do emulador do Android 10, Android 11 e Android 12L Surface Duo. Selecione uma combinação de nível de API e plataforma nas opções do Centro de Download reproduzidas na imagem abaixo (realçando o novo suporte da Apple Silicon para macOS):

Emulador baixa opções de arquitetura e sistema operacional, incluindo Android 10, 11 e 12L no Windows, macOS e Linux

Baixe o emulador do Surface Duo no Centro de Download da Microsoft.

Retorne para esta página após baixar o arquivo.

Instale e execute o SDK e o emulador

Importante

Não instale a nova versão do AVD (além de março de 2022) no diretório existente da versão antiga no emulador (antes de março de 2022) ou substitua entre diferentes versões do Android, como o emulador do Android 11 sobre a versão do Android 10.

Dica

Os scripts run.bat e run.sh nunca devem ser executados diretamente. Eles são chamados indiretamente de outros scripts específicos do dispositivo. Em vez disso, use run_SurfaceDuo/run_SurfaceDuo2.bat e run_SurfaceDuo/run_SurfaceDuo2.sh.

  1. Inicie o instalador do SurfaceDuoEmulator_ [versão] _windows.exe e siga o assistente de instalação para instalar o emulador.
  2. Depois de concluir a instalação do SDK, você encontrará dois novos ícones de aplicativo na área de trabalho e no menu Iniciar. Você pode iniciar o emulador do Surface Duo ou emulador do Surface Duo 2 com os ícones do aplicativo ou com os links do menu Iniciar.
  3. Se você alterou o local de instalação do SDK do Android do padrão, não se esqueça de atualizar suas variáveis de ambiente ou atualizar o ponteiro do SDK do seu Android.

Atualize o ponteiro para seu SDK do Android

Importante

Se você nunca alterou o local de instalação do SDK do Android ou atualizou as suas variáveis de ambiente, pule para Introdução ao emulador do Surface Duo.

Se você instalou o SDK do Android Studio em um local não padrão, será necessário atualizar as variáveis de ambiente relevantes ou atualizar o script de execução para apontar para o local de instalação correto. Caso contrário, o emulador não será executado quando você clicar no atalho ou executar o script.

  1. Localize o local de instalação do Emulador do Surface Duo. O local padrão é %USERPROFILE%\SurfaceDuoEmulator. Você pode clicar com o botão direito do mouse no ícone do aplicativo na área de trabalho para Open file location.

  2. Abra o arquivo run.bat em um editor de texto.

  3. Verifique DEFAULT_ANDROID_SDK_LOCATION_WIN ou DEFAULT_ANDROID_SDK_LOCATION_WIN_VS. Se você usa Visual Studio dentro do arquivo de script, o valor de caminho a seguir corresponde ao local de instalação do seu SDK do Android.

    rem ##### ENSURE THE ANDROID SDK LOCATION BELOW IS CORRECT ####### 
    set "DEFAULT_ANDROID_SDK_LOCATION_WIN=%LOCALAPPDATA%\Android\Sdk" 
    set "DEFAULT_ANDROID_SDK_LOCATION_WIN_VS=C:\Program Files (x86)\Android\android-sdk" 
    

Próximas etapas

Leia a introdução ao emulador do Surface Duo e comece a criar e testar aplicativos com as ferramentas de desenvolvimento de sua preferência: