Buildziele
Die folgenden Buildziele sind für Xamarin.Android-Projekte definiert:
Erstellen
Hiermit werden der Quellcode und alle Abhängigkeiten in einem Projekt erstellt.
Dieses Ziel erstellt kein Android-Paket (.apk
-Datei).
Verwenden Sie zum Erstellen eines Android-Pakets das Ziel SignAndroidPackage, oder legen Sie die Eigenschaft $(AndroidBuildApplicationPackage) beim Erstellen auf TRUE fest:
msbuild /p:AndroidBuildApplicationPackage=True App.sln
BuildAndStartAotProfiling
Erstellt die App mit einem eingebetteten AOT-Profiler, legt den TCP-Port des Profilers auf fest $(AndroidAotProfilerPort)
und startet die Standardaktivität.
Der standardmäßige TCP-Port ist 9999
.
Ab Xamarin.Android 10.2 verfügbar.
Clean
Hiermit werden alle vom Buildprozess generierten Dateien entfernt.
FinishAotProfiling
Dieses Ziel muss nach dem Ziel BuildAndStartAotProfiling aufgerufen werden.
Es sammelt AOT-Profilerdaten über den TCP-Port vom Gerät oder Emulator$(AndroidAotProfilerPort)
und schreibt sie in $(AndroidAotCustomProfilePath)
.
Die Standardwerte für Port und benutzerdefiniertes Profil sind 9999
und custom.aprof
.
Legen Sie zusätzliche Optionen in der Eigenschaft fest, um diese an aprofutil
zu übergeben.$(AProfUtilExtraOptions)
-Eigenschaft.
Das entspricht:
aprofutil $(AProfUtilExtraOptions) -s -v -f -p $(AndroidAotProfilerPort) -o "$(AndroidAotCustomProfilePath)"
Ab Xamarin.Android 10.2 verfügbar.
GetAndroidDependencies
Erstellt die @(AndroidDependency)
Elementgruppe, die vom InstallAndroidDependencies
Ziel verwendet wird, um zu bestimmen, welche Android SDK-Pakete installiert werden sollen.
Installieren
Hiermit wird das Android-Paket auf dem Standardgerät oder virtuellen Gerät erstellt, signiert und installiert.
Die $(AdbTarget)
-Eigenschaft gibt das Android-Zielgerät an, auf dem das Android-Paket installiert oder entfernt werden soll.
# 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
Ruft das GetAndroidDependencies
Ziel auf und installiert dann die android SDK-Pakete, die in der @(AndroidDependency)
Elementgruppe angegeben sind.
Die $(AndroidManifestType)
MSBuild-Eigenschaft steuert, welches Visual Studio SDK Manager-Repository für die Paketnamen- und Paketversionserkennung verwendet wird und welche URLs heruntergeladen werden sollen.
SignAndroidPackage
Hiermit wird die Android-Paketdatei (.apk
) erstellt und signiert.
Verwenden Sie diese Option mit /p:Configuration=Release
, um eigenständige „Releasepakete“ zu generieren.
StartAndroidActivity
Dieses Ziel startet die Standardaktivität auf dem Gerät oder dem verwendeten Emulator.
Legen Sie zum Starten einer anderen Aktivität für die Eigenschaft $(AndroidLaunchActivity)
-Eigenschaft für den Aktivitätsnamen.
Das entspricht:
adb shell am start @PACKAGE_NAME@/$(AndroidLaunchActivity)
Ab Xamarin.Android 10.2 verfügbar.
StopAndroidPackage
Dieses Ziel beendet das Anwendungspaket auf dem Gerät oder dem verwendeten Emulator vollständig.
Das entspricht:
adb shell am force-stop @PACKAGE_NAME@
Ab Xamarin.Android 10.2 verfügbar.
Deinstallieren
Dieses Ziel deinstalliert das Android-Paket vom Standardgerät oder virtuellen Gerät.
Die $(AdbTarget)
-Eigenschaft gibt das Android-Zielgerät an, auf dem das Android-Paket installiert oder entfernt werden soll.
UpdateAndroidResources
Es wird ein Update für die Datei Resource.designer.cs
ausgeführt.
Dieses Ziel wird normalerweise von der IDE aufgerufen, wenn dem Projekt neue Ressourcen hinzugefügt werden.