生成目标
以下的生成目标是为 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)
。
端口和自定义配置文件的默认值分别为 9999
和 custom.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 调用。