2026年跨国团队 XCTest 分片与多区域物理 Mac：构建产物该「单区产出」还是「分片就近执行」？Artifact 跨境成本与 Runner 路由阈值决策矩阵（可复制参数 + FAQ）

2. 痛点拆解

1. 制品同步吃掉并行收益：已在 A 区编好包，B/C 区只跑测试，但若跨境拉取 .xcarchive 或大块 .xcresult 的 P95 超过并行测试节省的时间，分片反而更慢。
2. 重复编译与缓存不一致：各区各自 build，Derived Data 与 Swift 模块缓存可能不一致，导致「只在某一区复现」的 flaky，排障成本高。
3. 合规与密钥边界：签名与证书若只能驻留单一法域，则「就近全链路 build」可能不可行，必须单区签名 + 向外同步可测试的最小产物集。

3. 决策矩阵一：构建产物「单区产出」还是「分片就近执行」？

默认建议：需要统一崩溃符号与发布二进制对齐时优先单区产出；若制品同步在流水线中占比连续高于约 22%（见矩阵二），再评估同区缓存代理或缩小同步集合（仅 .app + 必要 dSYM 切片）。

4. 决策矩阵二：Artifact 跨境成本（何时值得改架构？）

阈值用于排优先级，不是绝对真理；请以你方 SLA 与账单为准做季度复盘。

5. 决策矩阵三：Runner 路由与 XCTest 分片

6. 可复制参数块（xcodebuild + 环境变量）

并行测试（示例：单台 Runner 四分片 worker，按你机器核数改）：

xcodebuild test \
  -scheme "YourApp" \
  -destination 'platform=iOS Simulator,name=iPhone 16' \
  -parallel-testing-enabled YES \
  -parallel-testing-worker-count 4 \
  -resultBundlePath "$CI_RESULT_BUNDLE/Shard-${CI_NODE_INDEX}.xcresult" \
  -only-testing:YourAppUITests/LoginTests

分片仅跑子集（另一 Job）：

xcodebuild test \
  -only-testing:YourAppUITests/CheckoutFlowTests \
  -skip-testing:YourAppUITests/HeavyGraphicsTests

可粘贴环境变量（按策略选用）：

export CI_DERIVED_DATA_PATH="$HOME/Library/Developer/Xcode/DerivedData/ci-$GIT_SHA"
export XCODE_XCCONFIG_FILE="$PWD/CiArtifactsOnly.xcconfig"
# 可选：减轻调试符号体积 ONLY_ACTIVE_ARCH=YES（仅限允许的 Configuration）
# export ONLY_ACTIVE_ARCH=YES

7. 七步落地 Runbook

1. 在 CI 中分别打点：构建耗时、制品上传、跨境下载、xcodebuild test 纯执行四段。
2. 计算两周滚动：制品传输耗时 / Job 总耗时，对照矩阵二。
3. 若单区产出：把产物规范为 build_id 不可变路径，分片 Job 只读该路径。
4. 若就近 build：锁定 Xcode 版本、Swift Package resolve 结果、Ruby/CocoaPods 锁文件，写入同一 Docker/镜像或文档化。
5. 为每区域 Runner 池配置 独立队列，避免跨区 NFS 争用。
6. 将 -parallel-testing-worker-count 与机器核数、Simulator 数量联动，留出 I/O 余量。
7. 每季复盘：若红灯条件触发，在「加缓存带宽」与「改分片策略」之间做一次性 A/B（各跑 30 次流水线取 P95）。

8. 可引用数字与检查项（便于写进内部 RFC）

• 22% / 8%：制品传输占 Job 比重的「优化触发」与「可忽略」经验阈值（矩阵二）。
• 9 min / 4 min：单次跨境 P95 传输时长的红/绿分界（可按区域调整）。
• 0.75× 物理核：并行测试 worker 上限的粗算起点（矩阵三与 FAQ）。
• 检查项：是否记录 build_id、dSYM 是否与二进制同源、分片是否写独立 xcresult 路径避免覆盖。

9. FAQ（与页内结构化数据一致）

下列问答与 FAQPage JSON-LD 同步，便于检索与摘录。