如何通过Jenkins执行AppCenter命令运行Xamarin Test Cloud测试？

我帮你梳理几个大概率会导致这个问题的原因，以及对应的解决办法，你可以逐个排查：

1. Jenkins环境未安装或配置AppCenter CLI #

本地能正常运行是因为你的机器已经装了AppCenter CLI，但Jenkins的运行环境（比如它使用的系统账户）可能没安装这个工具。

• 先在Jenkins的Batch步骤开头加一行测试命令：appcenter --version，如果控制台输出“'appcenter' 不是内部或外部命令...”，就说明没安装。
• 解决办法：在Batch步骤里先执行安装命令，推荐用npm安装（前提是Jenkins环境有Node.js）：

  npm install -g appcenter-cli
  

  或者用Chocolatey安装（如果Jenkins环境配置了Chocolatey）：

  choco install appcenter-cli -y
  

2. 路径参数未正确设置 #

你命令里的*appPath*和*debugFolderPath*是占位符，在Jenkins里要换成绝对路径，而且要注意路径含空格时加引号：

• 不要用本地的相对路径，改用Jenkins工作区的环境变量%WORKSPACE%来拼接路径，比如：

  --app-path "%WORKSPACE%\bin\Debug\YourApp.ipa"
  --build-dir "%WORKSPACE%\YourUITestProject\bin\Debug"
  

• 确保这些路径对应的文件和文件夹确实存在，Jenkins构建时有没有先完成App和UITest项目的编译？如果UITest没编译，build-dir里会缺少测试程序集，直接报错。

3. Jenkins运行账户权限&AppCenter登录问题 #

本地你可能已经登录了AppCenter，但Jenkins的运行账户是独立的，没有登录状态；另外，Jenkins账户可能没有访问应用文件路径的权限：

• 权限问题：检查Jenkins服务的运行账户（可以在服务管理器里查看），确保它能读写appPath和debugFolderPath对应的文件夹。
• 登录问题：在Batch步骤里先执行登录命令，用AppCenter的API Token（不要用明文密码，把Token存在Jenkins的凭证里，用环境变量调用）：

  appcenter login --token %APPCENTER_API_TOKEN%
  

  API Token可以在AppCenter的账户设置→API Tokens里生成。

4. 命令参数格式错误 #

检查几个容易出错的参数：

• --app参数要写完整的App标识，格式是{OwnerName}/{AppName}，比如"MyCompany/MyAndroidApp"，确保引号是英文半角的。
• --devices的设备ID228faeda要确认是有效的，有没有在AppCenter里配置正确？
• 避免命令里出现中文符号（比如中文引号、中文空格），全部用英文符号。

示例完整的Jenkins Batch命令 #

:: 先安装AppCenter CLI（如果未安装）
npm install -g appcenter-cli

:: 用API Token登录AppCenter
appcenter login --token %APPCENTER_API_TOKEN%

:: 执行UITest命令
appcenter test run uitest --app "YourOwnerName/YourAppName" --devices 228faeda --app-path "%WORKSPACE%\output\app-release.apk" --test-series "master" --locale "en_US" --build-dir "%WORKSPACE%\YourUITestProject\bin\Debug"

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