SuperAPI AI 工具集

xcode-build-benchmark

编程与开发

查看项目

更新于 10-15 17:22

技能介绍

用途:在尝试优化构建时间之前,为 Xcode 项目建立可重复的构建基线,避免凭感觉推荐改动。核心原则是先测量再提优化建议,clean 与增量构建分开采集,全程保持命令、destination、configuration、scheme 和预热规则一致,工件写入带时间戳的 .build-benchmark/,测量过程中不修改项目文件。

需要确认或推断的输入包括:workspace 或 project 路径、scheme、configuration、destination、是否需要模拟器或真机数据、是否使用自定义 DerivedData 路径。若 clean 与增量构建都慢,默认两者都测。

默认流程:统一构建命令并记录所有影响缓存或模块复用的 flag;必要时先跑一次预热构建确认命令成功;跑 3 次 clean 构建;若检测到 COMPILATION_CACHE_ENABLE_CACHING = YES,再跑 3 次带缓存的 clean 构建(脚本会先构建一次预热缓存,再在每次测量前删除 DerivedData 但保留编译缓存),可用 --no-cached-clean 跳过;跑 3 次零改动构建,用于衡量固定开销下限;可选地通过 --touch-file 触碰代表性源文件后跑 3 次增量构建。结果与汇总保存到 .build-benchmark/,报告应给出中位数与波动,而不仅是单次最快值。

推荐命令:python3 scripts/benchmark_builds.py --workspace App.xcworkspace --scheme MyApp --configuration Debug --destination "platform=iOS Simulator,name=iPhone 16" --output-dir .build-benchmark。若无法使用该脚本,可运行等价的 xcodebuild 命令并加 -showBuildTimingSummary,保留原始输出。

输出需包含:clean 构建的中位数/最小/最大值;启用编译缓存时的 cached clean 数据;零改动构建数据;使用 --touch-file 时的增量构建数据;耗时最大的 timing-summary 类别;可能影响对比的环境信息;以及已保存工件的路径。结果噪声大时应说明并建议在更稳定条件下重跑。

限制与注意事项:若用户只要求基准测试,测量后即停止;如需优化指导,可将工件交给 xcode-compilation-analyzer、xcode-project-analyzer、spm-build-analysis 或 xcode-build-orchestrator 等专项技能。在 git worktree 中运行且存在引用被 gitignore 目录(如 Snapshots)的 SPM exclude 路径时,xcodebuild -resolvePackageDependencies 会崩溃,需先创建这些缺失目录。参考文件包括 references/benchmarking-workflow.md、references/benchmark-artifacts.md 和 schemas/build-benchmark.schema.json。其余细节暂未提供。