用途:实现已获开发者明确批准的 Xcode 构建优化改动,并用基准测试验证改进效果。只应用有明确批准的改动,每次只做一项逻辑修复,便于审查和回退;应用后重新基准测试,并如实报告改动了什么、涉及哪些文件、测得的差值。若某项改动无改进或造成回退,立即标记。
输入:位于 .build-benchmark/optimization-plan.md 且已勾选批准项的优化计划,或开发者明确描述的修复指令。基于计划工作时只实现被勾选的条目。
修复类别:构建设置(如 Debug 下 DEBUG_INFORMATION_FORMAT=dwarf、SWIFT_COMPILATION_MODE=singlefile,启用 COMPILATION_CACHE_ENABLE_CACHING、EAGER_LINKING,对齐跨 target 设置);脚本阶段(声明输入输出、加配置守卫如 [[ "$CONFIGURATION" != "Release" ]] && exit 0、使用 .xcfilelist);源码编译修复(显式类型标注、拆分长链式表达式、标记 final、收紧访问控制、拆分 SwiftUI body 等);SPM 重构(调整模块层次、拆分超大模块、固定依赖版本)。
使用方式:先读取批准计划或指令,定位确切文件与位置,应用改动,用快速 xcodebuild 构建确认无编译错误;全部应用后用与原始基线相同的输入重新基准测试,可通过 python3 scripts/benchmark_builds.py --project App.xcodeproj --scheme MyApp --configuration Debug --destination "platform=iOS Simulator,name=iPhone 16" --output-dir .build-benchmark 执行。
限制与注意:部分设置属于 Apple 推荐的现代默认值(如 COMPILATION_CACHE_ENABLE_CACHING、EAGER_LINKING、SWIFT_USE_INTEGRATED_DRIVER、Debug 下 dwarf、singlefile、ONLY_ACTIVE_ARCH),应保留,不因单次基准结果建议回退;非最佳实践的推测性改动若各构建类型均回退才建议回退。范围外问题可转交 xcode-project-analyzer、xcode-compilation-analyzer 或 spm-build-analysis。具体基准数值与项目结构相关,暂未提供。