VSTS CI环境中Fastlane构建任务无法执行问题排查

我来帮你一步步排查和解决这个问题，毕竟在CI环境里跑fastlane踩坑太常见了😂：

1. 先确认构建代理的环境是否达标 #

VSTS的构建代理机器必须先把基础环境搭好，不然fastlane根本跑不起来：

• 先在脚本开头加几行验证命令，输出到日志里看：

  echo "Checking Xcode path: $(xcode-select -p)"
  echo "Fastlane version: $(fastlane --version)"
  echo "Ruby version: $(ruby --version)"
  

  确保Xcode路径正确、fastlane和Ruby版本和你本地一致，版本不兼容很容易出问题。
• 别忘了接受Xcode的许可协议，不然构建会直接卡住，执行：

  sudo xcodebuild -license accept
  

  注意要给代理机器的运行用户配置好sudo免密权限，不然会卡在输入密码的步骤。

2. 证书与Provisioning Profile是重灾区 #

iOS构建最容易栽在证书上，VSTS里要这么处理：

• 别直接在命令里硬编码证书名称，建议用VSTS自带的Install Apple Certificate和Install Apple Provisioning Profile任务：把你的开发者证书（.p12）和对应的Provisioning Profile上传到VSTS的安全文件库，然后在fastlane任务前添加这两个任务，自动安装证书和profile。
• 如果你坚持用命令里的--codesigning_identity，一定要确认这个证书的全称和代理机器上安装的完全一致，包括空格和特殊字符，而且对应的Provisioning Profile里包含这个证书的UUID，bundle ID也和项目匹配。

3. 你的fastlane gym参数大概率写错了！ #

看你贴的命令，有几个明显的参数错误，这绝对会导致构建失败：

• -q "Debug"：gym根本没有-q这个参数！指定构建配置（Debug/Release）应该用--configuration Debug（注意-c是clean的简写，你原来的-c true是开启clean构建，这部分是对的）。
• -j "development"：-j是指定并行构建的jobs数量，不是scheme！指定scheme应该用--scheme development（简写-s）。
• -z false：这个是include_symbols的简写，如果你不需要符号表可以去掉，或者写成--include_symbols false更清晰。

修正后的命令应该是这样的（参数全用完整名称更不容易错）：

fastlane gym \
  --project "app.xcodeproj" \
  --output_name "app.ipa" \
  --clean \
  --configuration "Debug" \
  --scheme "development" \
  --codesigning_identity "iPhone Developer: Firstname Lastname" \
  --export_method development \
  --verbose

如果还是不确定参数，直接在代理机器上跑fastlane gym --help看完整的参数列表。

4. 路径与依赖问题别忽略 #

• 确认脚本的工作目录正确：在执行fastlane前加pwd和ls命令，看看app.xcodeproj是不是在当前目录下，VSTS拉取代码后默认工作目录是仓库根目录，别搞错路径。
• 如果项目用了CocoaPods，一定要在fastlane命令前加pod install，不然项目会缺少依赖，Xcode编译直接失败。

5. 看详细日志找精准错误 #

你的命令加了--verbose，一定要去VSTS构建任务的完整日志里找具体的错误信息：

• 如果日志里有unrecognized option，那就是参数错了；
• 如果有No signing certificate found，就是证书没装对；
• 如果有Xcode编译错误，那就是项目本身的问题，和fastlane无关，先在本地验证能不能编译通过。

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