咨询在Microsoft AppCenter运行UI脚本的API（含Xamarin场景及调用问题）

针对Xamarin项目在AppCenter测试云中运行UI脚本，核心API主要分为创建测试运行、跟踪状态和获取报告三类，我帮你梳理并解决你遇到的问题：

核心API说明 #

• 创建并启动测试运行：这是触发UI脚本执行的关键接口，使用POST请求：

  POST https://api.mobile.azure.com/v0.1/apps/{owner_name}/{app_name}/test_runs
  

  请求体需要包含设备集ID、应用包URL、Xamarin.UITest测试包URL、测试框架类型（指定为xamarin.UITest）等信息，同时请求头必须携带有效的API令牌（格式：Authorization: Bearer {your_api_token}）。

• 获取测试运行状态：用来跟踪测试执行进度，使用GET请求：

  GET https://api.mobile.azure.com/v0.1/apps/{owner_name}/{app_name}/test_runs/{test_run_id}
  

  响应里的status字段会显示当前测试状态（比如running、completed、failed）。

• 获取测试报告：就是你尝试调用的接口，正确调用的前提要注意细节：

  GET https://api.mobile.azure.com/v0.1/apps/{owner_name}/{app_name}/test_runs/{test_run_id}/report
  

你调用报告接口失败的常见排查点 #

我推测你遇到问题大概率是以下几个环节没处理好：

• 认证权限不足：你的API令牌必须拥有test_runs_read权限，去AppCenter用户设置页面生成令牌时，一定要勾选测试相关的权限选项。
• 路径参数错误：确认owner_name是你的AppCenter用户名/组织名，app_name是应用的slug（不是显示的友好名称，可在应用设置页面找到），test_run_id是有效的测试运行ID（注意是字符串格式，别误用数值）。
• 测试运行未完成：如果测试还处于running状态，报告还未生成，必须等测试状态变为completed或failed后再调用这个接口。

另外补充：Xamarin项目的UI测试脚本需要先打包成独立的测试包，调用创建测试运行的API时，要把测试包的可访问URL填入请求体的test_package_url字段中。

内容的提问来源于stack exchange，提问作者TheDeveloper