Usar o emulador do Surface Duo com Visual Studio

Importante

Este artigo descreve funcionalidades e diretrizes que estão em versão prévia pública e podem ser modificadas substancialmente antes de passarem para a disponibilidade geral. A Microsoft não faz nenhuma garantia, expressa ou implícita, com relação às informações fornecidas aqui.

Para criar aplicativos Android com o Xamarin em C# usando Visual Studio, configurar essas ferramentas e, em seguida, siga as instruções nesta página:

Instalar a versão prévia do emulador

Obter o instalador do Centro de Download da Microsoft:

Escolha o .zip para Windows ou o .dmg para macOS.

Quando o download for concluído, execute o instalador.

O instalador coloca ícones no menu Iniciar, dentro de uma pasta SurfaceDuoEmulator. Use o ícone rotulado surface Duo Emulator para Visual Studio abrir o emulador antes de tentar implantar dentro Visual Studio.

Executar o emulador

Visual Studio iniciará automaticamente o emulador do Surface Duo, portanto, você deve abri-lo manualmente antes de tentar implantar ou depurar seu aplicativo Xamarin.

Siga estas instruções para iniciar o emulador, após o qual ele aparecerá como uma opção de implantação no Visual Studio:

Depois de concluir a Instalação do SDK, você pode iniciar o Emulator Surface Duo para Visual Studio por meio do link do menu Iniciar.

menu Iniciar entrada para o emulador do Surface Duo

Na pasta de instalação, há um arquivo em lotesrun_vs.bat que você pode executar diretamente. Também há um arquivo run_vs_clean.bat que iniciará o emulador em um estado novo (em vez de continuar uma sessão anterior).

Se o emulador não for iniciado, talvez seja necessário atualizar o ponteiro para sua instalação do SDK do Android.

Observação

A pasta de instalação contém scripts de início chamados executare run_vs. Os scripts de executar são destinados a desenvolvedores que usam Android Studio e os scripts run_vs são para Visual Studio usuários. As diferenças são a SDK do Android local e a porta usada para o emulador.

Se o emulador estiver em execução, mas não aparecer como uma opção de implantação no Visual Studio, feche o emulador e inicie-o de novo, confirmando que você está usando o script com vs no nome.

Depurando o aplicativo Xamarin Android

Abra o projeto no Visual Studio, compile-o, selecione <build> (Android 10.0 - API 29) (na lista de Dispositivos em Execução) e implante.

A depuração (pontos de interrupção, passo a passo, etc.) funcionará como de costume.

Solução de problemas

O emulador do Surface Duo não aparece na lista Visual Studio dispositivos

A versão atual do emulador do Surface Duo não pode ser iniciada pelo Visual Studio. Primeiro, inicie o emulador manualmente. Após a execução, ele deverá aparecer na lista para implantação e depuração:

  • Windows - abra Iniciar o Surface Duo Emulator e escolha Surface Duo Emulator para Visual Studio.
  • Mac – comece na linha de comando usando (o "VS" no nome do script indica que ele sh ./run_vs.sh se destina a Visual Studio para Mac).

Atualize o ponteiro para seu SDK do Android

Se você alterou o local padrão de instalação do SDK do Android, será necessário atualizar o script run_vs 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.
  2. Abra a pasta artifacts dentro da pasta de instalação.
  3. Faça uma cópia de backup de run_vs.bat. Você pode copiá-lo para algo como run_vs_original.bat.
  4. Abra o arquivo run_vs.bat em um editor de texto.
  5. Verifique se o valor do caminho ANDROID_SDK_LOCATION próximo à parte superior do arquivo está correto.
rem ##### ENSURE THE SDK LOCATION BELOW IS CORRECT: #######
set ANDROID_SDK_LOCATION=C:\Program Files (x86)\Android\android-sdk