Partager via


Installer les dépendances .NET pour Android

Pour générer des applications .NET pour Android, vous devez installer le Kit de développement logiciel (SDK) Android et le Kit de développement logiciel (SDK) Java.

Utilisation de la cible « InstallAndroidDependencies »

Le moyen le plus simple d’installer les dépendances requises pour votre application Android consiste à exécuter le InstallAndroidDependencies Cible MSBuild.

Cette cible examine votre projet d’application et installe les composants exacts nécessaires. Si vous mettez à jour votre projet pour cibler une nouvelle API Android, vous devez réexécuter cette cible pour vous assurer que vous obtenez les composants requis.

Par exemple, si vous mettez à niveau votre projet vers l’API 34 cible à partir de l’API 32, vous n’avez installé que l’API 32. L’exécution de la cible installe l’API InstallAndroidDependencies 34 pour vous.

Si vous n’avez pas du tout installé le Kit de développement logiciel (SDK) Android, cette cible peut également gérer l’installation du Kit de développement logiciel (SDK) sur un ordinateur propre. Vous pouvez modifier la destination de l’installation en définissant la AndroidSdkDirectory propriété MSBuild. Il installe également le Kit de développement logiciel (SDK) Java si la JavaSdkDirectory propriété MSBuild est fournie.

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

Voici tous les arguments que la cible utilisera lors de l’installation des dépendances :

  • -p:AndroidSdkDirectory="<PATH>" installe ou met à jour les dépendances Android sur le chemin spécifié.
    Remarque : Vous devez utiliser un chemin absolu ; Les développeurs Unix ne doivent pas utiliser tilde (~), car ils ne sont pas développés lorsqu’ils sont utilisés dans un argument de ligne de commande.

  • -p:JavaSdkDirectory="<PATH>" installe Java sur le chemin spécifié.
    Remarque : Vous devez utiliser un chemin absolu ; Les développeurs Unix ne doivent pas utiliser tilde (~), car ils ne sont pas développés lorsqu’ils sont utilisés dans un argument de ligne de commande.

  • -p:AcceptAndroidSDKLicenses=True accepte les licences Android nécessaires pour le développement.

Remarque

Pour faciliter le développement, essayez d’éviter d’utiliser des chemins contenant des espaces ou des caractères non ASCII.

Installer manuellement le Kit de développement logiciel (SDK) Android

Vous pouvez trouver nécessaire d’installer le Kit de développement logiciel (SDK) Android manuellement :

  1. Accédez au téléchargement d’Android Studio.
    Faites défiler jusqu’à la section « Outils en ligne de commande uniquement » et téléchargez le fichier zip de votre système d’exploitation.

  2. Créez un android-sdk répertoire quelque part sur votre disque dur. Pour faciliter la vie, créez-la près de la racine du lecteur. Par exemple, c:\android-sdk.

  3. Extrayez les fichiers du fichier zip dans ce répertoire. Vous devez vous retrouver avec une structure de dossiers comme android-sdk\cmdline-tools

  4. Ouvrez un terminal ou une invite de commandes.

  5. Accédez au android-sdk\cmdline-tools\bin répertoire dans le répertoire que vous avez créé.

  6. Exécutez la sdkmanager commande pour installer les composants souhaités.

Par exemple, pour installer les derniers outils de plateforme et de plateforme, utilisez :

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

Notez que les guillemets doubles doivent être utilisés de manière libérale pour placer le point-virgule ;, qui fait partie des noms de composants.

Vous serez invité à accepter la licence, après quoi le Kit de développement logiciel (SDK) Android sera installé.

Vous pouvez utiliser sdkmanager pour installer des composants supplémentaires. Vous pouvez utiliser l’argument --list pour obtenir la liste de tous les composants disponibles. Vous pouvez ensuite consulter la liste et rechercher les composants supplémentaires souhaités.

sdkmanager --list

Les types de composants suivants sont utiles à connaître :

  • platforms;android-XX: installe la plateforme android-XX dans le kit sdk. Remplacez XX par le niveau d’API de votre plateforme choisie. Par exempleplatforms;android-30, l’API Android 30 installe l’API Android 21.platforms;android-21

  • system-images;android-XX;default;x86_64: installe une image d’émulateur pour le niveau d’API spécifique. Il x86_64 peut être échangé pour différentes API telles que x86, arm64-v8aet x86_64. Celles-ci reflètent l’ABI de l’image en cours d’installation. Cela peut être utile si vous rencontrez des problèmes sur des ABI spécifiques.

Il est également recommandé de définir la ANDROID_HOME variable d’environnement, car cela vous permet d’utiliser certains outils à partir de la ligne de commande.

Installer manuellement Microsoft JDK

Pour générer .NET pour les applications ou bibliothèques Android, vous devez disposer d’une version du Kit de développement Java installée. Nous vous recommandons d’utiliser le JDK Microsoft Open, qui a été testé sur nos builds .NET pour Android :

  1. Téléchargez Microsoft OpenJDK 11.

  2. Selon votre plateforme, exécutez le programme d’installation approprié.

  3. Il est également recommandé de définir la variable d’environnement JAVA_HOME . Cela vous permettra d’utiliser le JDK à partir de l’invite de commandes ou du terminal.