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.
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:
- 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.
- Verifique se o SDK do Android está instalado seguindo estas instruções do Visual Studio.
- 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):
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
.
- Inicie o instalador do SurfaceDuoEmulator_ [versão] _windows.exe e siga o assistente de instalação para instalar o emulador.
- 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.
- 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.
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 paraOpen file location
.Abra o arquivo
run.bat
em um editor de texto.Verifique
DEFAULT_ANDROID_SDK_LOCATION_WIN
ouDEFAULT_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:
- Desenvolvedores de Kotlin e Java podem adicionar o SDK do Surface Duo a seus projetos para acessar controles de tela dupla e auxiliares.
- Os desenvolvedores do Xamarin poderão adicionar NuGets de SDK do Surface Duo aos próprios projetos e seguir estas instruções para usar o emulador com o Visual Studio.
- Os desenvolvedores React Native poderão adicionar estes módulos.
- Os desenvolvedores do Unity poderão começar com um projeto de exemplo.
- Os desenvolvedores do Flutter deverão começar com estes exemplos.
- Os desenvolvedores da Web poderão usar o Edge no emulador ou criar e testar usando ferramentas para desenvolvedores de área de trabalho.