准备 Xamarin.Android 应用

重要

Visual Studio App Center 计划于 2025 年 3 月 31 日停用。 虽然可以继续使用 Visual Studio App Center,直到它完全停用,但你可以考虑迁移到几个建议的替代方法。

详细了解支持时间线和替代方案。

本指南提供有关准备 Xamarin.UITests 以上传到 App Center 测试的说明。 选择要开始的平台。

重要

在 Windows 上运行 Xamarin.UITest 需要使用 Android SDK 的路径设置ANDROID_HOME环境变量

准备 Xamarin.Android 应用和 Xamarin.UITests 以提交到 App Center for Test:

  1. 确保应用通过将此代码片段<uses-permission android:name="android.permission.INTERNET" />插入标记外部 AndroidManifest.xml 来<application>请求INTERNET权限。
  2. 禁用 “使用共享 Mono 运行时”。 共享 Mono 运行时将阻止 Xamarin.UITests 在 App Center for Test 中运行,CLI 将引发错误“不支持 Mono 共享运行时”。

Visual studio for Mac

禁用 “使用共享 Mono 运行时”。 共享 Mono 运行时将阻止 Xamarin.UITests 在 App Center for Test 中运行。

在“Visual Studio for Mac”中,打开“生成 > Android 生成”,然后选择“项目选项”。 在“ 常规 ”选项卡上,查找“ 打包和部署 ”,并取消选中“ 使用共享 Mono 运行时 ”复选框。

删除使用共享运行时 (macOS)

Visual Studio (Windows)

禁用 “使用共享 Mono 运行时”。 共享 Mono 运行时将阻止 Xamarin.UITests 在 App Center for Test 中运行,并且可能会在上传过程中引发 Mono dependency error

在 Visual Studio 2019 中,打开项目属性,然后选择“ Android 选项” 选项卡。在第一部分中,查找 “打包属性”,然后取消选中“ 使用共享运行时” 复选框。

删除使用共享运行时 (Windows)

生成上传命令

准备好测试套件后,可以 设置测试运行 以上传和运行测试。 此过程将生成一个原型命令行,如下所示:

appcenter test run uitest --app "MyOrg/MyApp" --devices "MyOrg/MyDeviceSet" --app-path pathToFile.apk --test-series "main" --locale "en_US" --build-dir pathToUITestBuildDir

命令行需要进行一些修改:

  1. 必须为 & --build-dir参数--app-path提供路径。
  2. 如果 CLI 无法自动找到所使用的 UITest 包, 则可能需要 指定它: --uitest-tools-dir /Users/{your username}/.nuget/packages/xamarin.uitest/{UITest version}/tools