Instalar o .NET para dependências do Android

Para criar o .NET para aplicativos Android, você precisa instalar o SDK do Android e o SDK do Java.

Usando o destino "InstallAndroidDependencies"

A maneira mais fácil de instalar as dependências necessárias para seu aplicativo Android é executar o InstallAndroidDependencies Destino do MSBuild.

Este alvo examinará seu projeto de aplicação e instalará os componentes exatos necessários. Se você atualizar seu projeto para ter como destino uma nova API do Android, precisará executar esse destino novamente para garantir que você obtenha os componentes necessários.

Por exemplo, se você estiver atualizando seu projeto para a API de destino 34 da API 32, você terá apenas a API 32 instalada. A execução do alvo InstallAndroidDependencies instalará a API 34 para você.

Se você não tiver o SDK do Android instalado, esse destino também poderá lidar com a instalação do SDK em um computador limpo. Você pode alterar o destino da instalação definindo a AndroidSdkDirectory propriedade MSBuild. Ele também instalará o SDK do Java caso a JavaSdkDirectory propriedade MSBuild seja fornecida.

dotnet build -t:InstallAndroidDependencies -f net8.0-android -p:AndroidSdkDirectory=c:\work\android-sdk -p:JavaSdkDirectory=c:\work\jdk -p:AcceptAndroidSdkLicenses=True

Aqui estão todos os argumentos que o destino usará ao instalar as dependências:

• -p:AndroidSdkDirectory="<PATH>" instala ou atualiza as dependências do Android para o caminho especificado.
  Observação: você deve usar um caminho absoluto. Os desenvolvedores do Unix não devem usar tilde (~), pois ele não é expandido quando usado em um argumento de linha de comando.

• -p:JavaSdkDirectory="<PATH>" instala o Java no caminho especificado.
  Observação: você deve usar um caminho absoluto; os desenvolvedores Unix não devem usar tilde (~), pois ele não é expandido quando utilizado dentro de um argumento de linha de comando.

• -p:AcceptAndroidSDKLicenses=True aceita as licenças necessárias do Android para desenvolvimento.

Instalar o Microsoft JDK manualmente

Para criar aplicativos ou bibliotecas do .NET para Android, você precisa ter uma versão do Java Development Kit instalada. Recomendamos que você use o Microsoft Open JDK, que foi testado em nossos builds do .NET para Android:

1. Baixe o Microsoft OpenJDK 11.

Instalar o SDK do Android manualmente

Você pode achar necessário instalar o SDK do Android manualmente:

1. Acesse o download do Android Studio.
   Role para baixo até a seção "Somente Ferramentas de Linha de Comando" e baixe o arquivo zip do sistema operacional.

2. Crie um android-sdk diretório em algum lugar no disco rígido. Para facilitar sua vida, crie o arquivo perto da raiz da unidade de disco. Por exemplo, c:\android-sdk.

3. Extraia os arquivos do arquivo zip para este diretório. Você deve acabar com uma estrutura de pastas como android-sdk\cmdline-tools

4. Abra um terminal ou prompt de comando.

5. Navegue até o android-sdk\cmdline-tools\bin diretório dentro do diretório que você criou.

6. Execute o sdkmanager comando para instalar os componentes desejados.

7. Defina a variável de ambiente $ANDROID_HOME para o seu caminho do SDK do Android:

$env:ANDROID_HOME = "C:\android-sdk"

Por exemplo, para instalar a plataforma e as ferramentas de plataforma mais recentes, use:

sdkmanager "platforms;android-34" "platform-tools" "build-tools;34.0.0" "emulator" "system-images;android-34;default;x86_64" "cmdline-tools;11.0" --sdk_root=c:\android-sdk

Observe que as aspas duplas devem ser usadas liberalmente para colocar o ponto-e-vírgula ;, que faz parte dos nomes dos componentes.

Você será solicitado a aceitar a licença, após a qual o SDK do Android será instalado.

Você pode usar sdkmanager para instalar componentes adicionais. Você pode usar o --list argumento para obter uma lista de todos os componentes disponíveis. Em seguida, você pode analisar a lista e encontrar os componentes adicionais desejados.

sdkmanager --list

Os seguintes tipos de componente são úteis para saber:

• platforms;android-XX: instala a plataforma android-XX no sdk. Substitua XX pelo Nível de API da plataforma escolhida. Por exemplo platforms;android-30 , instalará a API 30 do Android, enquanto platforms;android-21 instalará a API 21 do Android.

• system-images;android-XX;default;x86_64: instala uma imagem do emulador para o nível de API específico. O x86_64 pode ser trocado por ABIs diferentes, como x86, arm64-v8ae x86_64. Isso reflete a ABI da imagem que está sendo instalada. Isso pode ser útil se você tiver problemas em ABIs específicas.

Também é uma boa prática definir a ANDROID_HOME variável de ambiente, pois isso permite que você use determinadas ferramentas da linha de comando.

2. Dependendo da plataforma, execute o instalador apropriado.

3. Também é uma boa prática definir a variável de JAVA_HOME ambiente. Isso permitirá que você use o JDK no Prompt de Comando ou Terminal.