.NET installeren voor Android-afhankelijkheden

Als u .NET voor Android-toepassingen wilt bouwen, moet u de Android SDK en de Java SDK installeren.

Gebruik het doel InstallAndroidDependencies

De eenvoudigste manier om de vereiste afhankelijkheden voor uw Android-toepassing te installeren, is om de InstallAndroidDependencies MSBuild-doel.

Dit doel onderzoekt uw toepassingsproject en installeert de exacte onderdelen die nodig zijn. Als u uw project bijwerkt om een nieuwe Android-API te bereiken, moet u dit doel opnieuw uitvoeren om ervoor te zorgen dat u de vereiste onderdelen krijgt.

Als u bijvoorbeeld uw project bijwerkt naar de doel-API 34 van API 32, hebt u alleen API 32 geïnstalleerd. Als u het InstallAndroidDependencies doel uitvoert, wordt API 34 voor u geïnstalleerd.

Als u de Android SDK helemaal niet hebt geïnstalleerd, kan dit doel ook de installatie van de SDK op een schone machine afhandelen. U kunt het doel van de installatie wijzigen door de AndroidSdkDirectory eigenschap MSBuild in te stellen. Ook wordt de Java SDK geïnstalleerd als de JavaSdkDirectory MSBuild-eigenschap is opgegeven.

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

Hier volgen alle argumenten die door het doel worden gebruikt bij het installeren van de afhankelijkheden:

• -p:AndroidSdkDirectory="<PATH>" installeert of werkt Android-onderdelen bij op het opgegeven pad.
  Opmerking: U moet een absoluut pad gebruiken; Unix-ontwikkelaars mogen tilde (~) niet gebruiken, omdat deze niet wordt uitgevouwen wanneer ze binnen een opdrachtregelargument worden gebruikt.

• -p:JavaSdkDirectory="<PATH>" installeert Java op het opgegeven pad.
  Opmerking: U moet een absoluut pad gebruiken; Unix-ontwikkelaars mogen tilde (~) niet gebruiken, omdat deze niet wordt uitgevouwen wanneer ze binnen een opdrachtregelargument worden gebruikt.

• -p:AcceptAndroidSDKLicenses=True accepteert de benodigde Android-licenties voor ontwikkeling.

Opmerking

Om de ontwikkeling gemakkelijker te maken, vermijdt u het gebruik van paden die spaties of niet-ASCII-tekens bevatten.

Microsoft JDK handmatig installeren

Als u .NET voor Android-toepassingen of -bibliotheken wilt bouwen, moet er een versie van de Java Development Kit zijn geïnstalleerd. We raden u aan de Microsoft Open JDK te gebruiken. Dit is getest op onze .NET voor Android-builds:

1. Download Microsoft OpenJDK 11.

De Android SDK handmatig installeren

Opmerking

In Windows moet u eerst JDK installeren.

Mogelijk hebt u het nodig om de Android SDK handmatig te installeren:

1. Ga naar Android Studio downloaden.
   Scrol omlaag naar de sectie "Alleen opdrachtregelprogramma's" en download het zip-bestand voor uw besturingssysteem.

2. Maak ergens op de harde schijf een android-sdk map. Om uw leven gemakkelijker te maken, maakt u het aan bij de hoofdlocatie van de schijf. Bijvoorbeeld c:\android-sdk.

3. Pak de bestanden uit het zip-bestand uit in deze map. U moet eindigen met een mapstructuur zoals android-sdk\cmdline-tools

4. Open een terminal of opdrachtprompt.

5. Navigeer naar de android-sdk\cmdline-tools\bin map in de map die u hebt gemaakt.

6. Voer de sdkmanager opdracht uit om de gewenste onderdelen te installeren.

7. Stel de $ANDROID_HOME omgevingsvariabele in voor uw Android SDK-pad:

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

Als u bijvoorbeeld de nieuwste platform- en platformhulpprogramma's wilt installeren, gebruikt u:

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

Houd er rekening mee dat dubbele aanhalingstekens vrijelijk moeten worden gebruikt om de puntkomma ;te plaatsen, die deel uitmaakt van de onderdeelnamen.

U wordt gevraagd om de licentie te accepteren, waarna de Android SDK wordt geïnstalleerd.

U kunt sdkmanager gebruiken om extra onderdelen te installeren. U kunt het --list argument gebruiken om een lijst met alle beschikbare onderdelen op te halen. Vervolgens kunt u de lijst bekijken en de gewenste aanvullende onderdelen vinden.

sdkmanager --list

De volgende onderdeeltypen zijn handig om te weten:

• platforms;android-XX: Installeert het platform android-XX in de SDK. Vervang XX door het API-niveau van het gekozen platform. Installeer bijvoorbeeld platforms;android-30 Android API 30, terwijl platforms;android-21 Android API 21 wordt geïnstalleerd.

• system-images;android-XX;default;x86_64: Installeert een emulatorafbeelding voor het specifieke API-niveau. De x86_64 kan worden verwisseld voor verschillende ABI's, zoals x86, arm64-v8aen x86_64. Deze weerspiegelen de ABI van de image die wordt geïnstalleerd. Dit kan handig zijn als u problemen hebt met specifieke ABI's.

Het is ook raadzaam om de ANDROID_HOME omgevingsvariabele in te stellen, omdat u hiermee bepaalde hulpprogramma's vanaf de opdrachtregel kunt gebruiken.

2. Afhankelijk van uw platform voert u het juiste installatieprogramma uit.

3. Het is ook raadzaam om de JAVA_HOME omgevingsvariabele in te stellen. Hiermee kunt u de JDK gebruiken vanaf de opdrachtprompt of terminal.