生成目标

以下的生成目标是为 Xamarin.Android 项目定义的。

生成

在项目和所有依赖项中生成源代码。

此目标不会创建 Android 包(.apk 文件)。 若要创建 Android 包,请使用 SignAndroidPackage 目标,或在进行生成时将 `$(AndroidBuildApplicationPackage) 属性设置为 True:

msbuild /p:AndroidBuildApplicationPackage=True App.sln

BuildAndStartAotProfiling

使用嵌入的 AOT 探查器生成应用,将探查器 TCP 端口设置为 $(AndroidAotProfilerPort),并启动默认活动。

默认的 TCP 端口为 9999

在 Xamarin.Android 10.2 中新增。

Clean

删除由生成过程生成的所有文件。

FinishAotProfiling

必须在 BuildAndStartAotProfiling 目标之后调用。

通过 TCP 端口 从设备或模拟器收集 AOT 探查器数据,$(AndroidAotProfilerPort) 并将其写入 $(AndroidAotCustomProfilePath)

端口和自定义配置文件的默认值分别为 9999custom.aprof

要将其他选项传递到 aprofutil,请在以下位置设置它们 $(AProfUtilExtraOptions) 属性。

这等效于:

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

在 Xamarin.Android 10.2 中新增。

GetAndroidDependencies

创建 @(AndroidDependency) 项组,该组由 InstallAndroidDependencies 目标用于确定要安装的 Android SDK 包。

安装

创建 Android 包、进行签名,并将其安装到默认设备或虚拟设备中。

$(AdbTarget) 属性指定 Android 包可能要安装到或从中删除的 Android 目标设备。

# 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

调用 GetAndroidDependencies 目标,然后安装 @(AndroidDependency) 项组中指定的 Android SDK 包。

$(AndroidManifestType) MSBuild 属性控制哪些 Visual Studio SDK Manager 存储库用于包名称和包版本检测,以及要下载的 URL。

SignAndroidPackage

创建 Android 包 (.apk) 文件并进行签名。

用于 /p:Configuration=Release,生成自包含的“发行”包。

StartAndroidActivity

在设备或正在运行的模拟器上启动默认活动。

若要启动其他活动,请将 $(AndroidLaunchActivity) 属性设置为活动名称。

这等效于:

adb shell am start @PACKAGE_NAME@/$(AndroidLaunchActivity)

在 Xamarin.Android 10.2 中新增。

StopAndroidPackage

在设备或正在运行的模拟器上完全停止应用程序包。

这等效于:

adb shell am force-stop @PACKAGE_NAME@

在 Xamarin.Android 10.2 中新增。

卸载

从默认设备或虚拟设备中卸载 Android 包。

$(AdbTarget) 属性指定 Android 包可能要安装到或从中删除的 Android 目标设备。

UpdateAndroidResources

更新 Resource.designer.cs 文件。

将新的资源添加到项目中时,这个目标通常由 IDE 调用。