Partager via

Cibles de génération

  • Article

Les cibles de build suivantes sont définies dans .NET pour les projets Android.

Build

Génère le code source dans un projet et toutes les dépendances.

Cette cible ne crée pas de package Android (.apk fichier). Pour créer un package Android, utilisez la cible SignAndroidPackage ou définissez la propriété '$(AndroidBuildApplicationPackage) sur True lors de la génération :

msbuild /p:AndroidBuildApplicationPackage=True App.sln

BuildAndStartAotProfiling

Génère l’application avec un profileur AOT incorporé, définit le port $(AndroidAotProfilerPort)TCP du profileur sur et démarre l’activité par défaut.

Le port TCP par défaut est 9999.

Ajouté dans Xamarin.Android 10.2.

Clean

Supprime tous les fichiers générés par le processus de génération.

FinishAotProfiling

Doit être appelé après la cible BuildAndStartAotProfiling .

Collecte les données du profileur AOT à partir de l’appareil ou de l’émulateur via le port TCP $(AndroidAotProfilerPort) et les écrit dans $(AndroidAotCustomProfilePath).

Les valeurs par défaut pour le port et le profil personnalisé sont 9999 et custom.aprof.

Pour passer des options supplémentaires à aprofutil, définissez-les dans le Propriété $(AProfUtilExtraOptions).

Ceci équivaut à :

aprofutil $(AProfUtilExtraOptions) -s -v -f -p $(AndroidAotProfilerPort) -o "$(AndroidAotCustomProfilePath)"

Ajouté dans Xamarin.Android 10.2.

GetAndroidDependencies

Crée le @(AndroidDependency) groupe d’éléments, qui est utilisé par la InstallAndroidDependencies cible pour déterminer les packages Android SDK à installer.

Installer

Crée, signe et installe le package Android sur l’appareil ou l’appareil virtuel par défaut.

La $(AdbTarget) propriété spécifie l’appareil cible Android sur lequel le package Android peut être installé ou supprimé.

# Install package onto emulator via -e
# Use `/Library/Frameworks/Mono.framework/Commands/msbuild` on OS X
MSBuild /t:Install ProjectName.csproj /p:AdbTarget=-e

InstallAndroidDependencies

Appelle la GetAndroidDependencies cible, puis installe les packages android SDK spécifiés dans le groupe d’éléments @(AndroidDependency) .

dotnet build -t:InstallAndroidDependencies -f net8.0-android "-p:AndroidSdkDirectory=<path to sdk>" "-p:JavaSdkDirectory=<path to java sdk>"

La -f net8.0-android cible est requise, car cette cible est une cible spécifique à .NET pour Android. Si vous omettez cet argument, vous obtenez l’erreur suivante :

error MSB4057: The target "InstallAndroidDependencies" does not exist in the project.

Les AndroidSdkDirectory propriétés et JavaSdkDirectory les propriétés sont requises, car nous devons savoir où installer les composants requis. Ces répertoires peuvent être vides ou existants. Les composants du Kit de développement logiciel (SDK) sont installés sur une installation existante du kit sdk.

La $(AndroidManifestType) propriété MSBuild contrôle le référentiel du Gestionnaire du kit de développement logiciel (SDK) Visual Studio utilisé pour la détection des versions du package et les URL à télécharger.

RunWithLogging

Exécute l’application avec une journalisation supplémentaire activée. Utile lors de la création de rapports ou de l’examen d’un problème avec l’application ou le runtime. En cas de réussite, les messages imprimés à l’écran affichent l’emplacement du fichier logcat avec les messages consignés.

Propriétés qui affectent le fonctionnement de la cible :

  • /p:RunLogVerbose=true permet une journalisation encore plus détaillée à partir de MonoVM
  • /p:RunLogDelayInMS=X où X doit être remplacé par le temps en millisecondes à attendre avant d’écrire la sortie du journal dans le fichier. La valeur par défaut est 1000.

SignAndroidPackage

Crée et signe le fichier de package Android (.apk).

À utiliser avec /p:Configuration=Release pour générer des packages « Release » autonomes.

StartAndroidActivity

Démarre l’activité par défaut sur l’appareil ou l’émulateur en cours d’exécution.

Pour démarrer une autre activité, définissez la $(AndroidLaunchActivity) propriété au nom de l’activité.

Ceci équivaut à :

adb shell am start -S -n @PACKAGE_NAME@/$(AndroidLaunchActivity)

Ajouté dans Xamarin.Android 10.2.

StopAndroidPackage

Arrête complètement le package d’application sur l’appareil ou l’émulateur en cours d’exécution.

Ceci équivaut à :

adb shell am force-stop @PACKAGE_NAME@

Ajouté dans Xamarin.Android 10.2.

Désinstaller

Désinstalle le package Android à partir de l’appareil ou de l’appareil virtuel par défaut.

La $(AdbTarget) propriété spécifie l’appareil cible Android sur lequel le package Android peut être installé ou supprimé.

UpdateAndroidResources

Met à jour le fichier Resource.designer.cs.

Cette cible est généralement appelée par l’IDE quand de nouvelles ressources sont ajoutées au projet.