Tuist 项目中 Xcode 16 并行测试配置的演进

在 Xcode 16 中，苹果引入了一个重要的测试并行化新特性，这对 Tuist 项目的配置方式产生了直接影响。本文将深入解析这一变化的技术背景、影响范围以及最佳实践方案。

背景与问题分析

Xcode 16 对测试并行化机制进行了重要调整，新增了"Parallelization"选项，提供了三种配置状态：

1. 完全禁用并行测试
2. 启用并行测试（如果可能）
3. 仅限 Swift Testing 框架使用并行测试

在 Tuist 之前的版本中，parallelizable 选项的实现方式存在问题 - 它实际上将配置设置为"仅限 Swift Testing"，这与开发者的预期行为不符。这种不一致性可能导致测试执行策略与项目实际需求产生偏差。

技术实现解析

通过分析 Xcode 项目文件(.xctestplan)的实际结构，我们发现不同配置状态在文件中的表现方式：

• 禁用并行测试：明确设置 "parallelizable" : false
• 启用并行测试：明确设置 "parallelizable" : true
• 仅限 Swift Testing：不设置该字段（保持默认）

在 Tuist 的实现层面，关键修改点位于 XcodeProj 模块中处理测试引用的代码逻辑。原始实现将 parallelizable 字段默认设为 nil，这实际上对应了 Xcode 中的"仅限 Swift Testing"选项。

解决方案设计

针对这一问题，技术团队制定了清晰的改进方案：

1. 引入新的 swiftTestingOnly 测试选项，专门用于仅限 Swift Testing 的场景
2. 修正现有 parallelizable 选项的行为，使其正确映射到"启用并行测试（如果可能）"的配置
3. 在底层实现中，将布尔类型的 parallelizable 升级为枚举类型，以准确表达三种可能的状态

配置实践指南

在实际项目中使用时，开发者可以通过以下方式配置测试并行化选项：

options: .options(
    automaticSchemesOptions: .enabled(
        targetSchemesGrouping: .notGrouped,
        codeCoverageEnabled: true,
        testingOptions: [.parallelizable] // 或 .swiftTestingOnly
    )
)

对于需要精细控制测试行为的项目，建议：

• 混合使用 XCTest 和 Swift Testing 的项目选择 .parallelizable
• 纯 Swift Testing 项目考虑使用 .swiftTestingOnly
• 需要完全禁用并行测试的场景明确设置 parallelizable: false

版本兼容性考虑

这一变更主要影响 Xcode 16 及更高版本的项目。对于仍需支持旧版 Xcode 的项目，Tuist 会保持向后兼容性，但建议开发者尽快迁移到新的配置方式以获得最佳的测试执行性能。

通过这次改进，Tuist 提供了更精确的测试并行化控制能力，使开发者能够更好地利用 Xcode 16 的测试性能优化特性，同时保持配置的清晰性和一致性。