如何配置Xcode Cloud CI/CD，使其依据单元测试结果判定构建成败

以下是逐步配置方案，确保Xcode Cloud执行单元测试并将测试结果作为构建成功的判定依据：

1. 确认本地项目的测试目标配置 #

打开Xcode，定位到你的单元测试目标（通常命名为[项目名]Tests），检查核心配置：

• Build Settings：确保Bundle Identifier格式正确（如主应用为com.yourapp，测试目标应为com.yourapp.Tests），且Deployment Target与主应用目标完全一致，避免因版本不兼容导致测试跳过。
• Build Phases：在Compile Sources中确认所有测试文件已被正确添加，无遗漏。

2. 配置Xcode Cloud工作流程的Build阶段 #

进入Xcode的Report Navigator，选择你的Xcode Cloud构建计划，点击Edit Workflow：

• 在Build标签下，勾选Run Tests选项，并在下方的Test Targets列表中，明确选中需要执行的单元测试目标（务必不要漏选）。
• 在Test Devices中选择与测试目标Deployment Target匹配的模拟器/设备（如iPhone 15, iOS 17），确保测试环境兼容。

3. 启用测试失败触发构建失败的规则 #

在构建计划的Test标签页：

• 确认Enable Testing已开启，且选中了正确的测试目标。
• 确保Fail build if tests fail选项处于勾选状态（这是核心开关，默认应为勾选，但可能被误修改）。
• 若使用测试过滤规则，避免设置排除所有测试的条件，确保目标测试用例能被执行。

4. 检查自定义构建脚本（如有） #

如果你的项目使用了ci_post_clone.sh或其他自定义构建脚本：

• 避免在xcodebuild test命令后添加|| true这类强制返回成功的后缀，这会导致Xcode Cloud忽略测试失败的结果。
• 保持xcodebuild命令的原生返回逻辑，示例：

  xcodebuild test -workspace YourProject.xcworkspace -scheme YourScheme -destination 'platform=iOS Simulator,name=iPhone 15'
  

  当测试失败时，xcodebuild会返回非0状态码，Xcode Cloud会自动标记构建失败。

5. 验证构建结果 #

提交代码触发新的Xcode Cloud构建，完成后查看Build Details的Tests标签：

• 确认测试用例被正常执行，能看到每个测试的状态（成功/失败）。
• 若测试失败，构建状态应自动变为Failed，且日志中会显示具体的测试失败信息。

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