android-gradle-build-performance

Android Gradle 构建性能

适用场景

• 在请求涉及以下内容时使用此技能：Android Gradle 构建性能、Android 构建配置缓存、Android 中的 KSP 与 kapt。
• 主要目标：通过构建扫描、缓存检查和瓶颈审计，诊断并提升 Android 和 Gradle 构建性能。
• 当问题涉及构建速度、任务变动、缓存未命中或 CI 耗时，而不是构建逻辑结构时，使用此技能。
• 需要测量步骤或常见 Gradle 性能问题时，阅读 references/patterns.md。
• 需要了解示例项目的审计优先入口时，阅读 references/scenarios.md。
• 范围扩大时，移交给以下技能：
• android-gradle-build-logic
• android-ci-cd-release-playstore

工作流

1. 确定问题涉及本地开发者反馈时间、CI 构建时长，还是两者都有。
2. 每次只测量一条构建路径，再使用 --profile、--scan、配置缓存诊断或捆绑的审计脚本，然后再提出修复建议。
3. 检查 gradle.properties、插件接入方式、依赖声明、任务注册方式和模块约定，排查常见的性能问题。
4. 每次应用一项高置信度优化，然后比较优化前后的表现，不要叠加多项改动。
5. 确定性能瓶颈后，将结构性 Gradle 重构或发布流水线变更移交处理。

注意事项

• 如果真正的瓶颈是单一缓存、插件或依赖模式，不要建议大范围重写。
• 将测量与推测分开；明确指出哪些是观察所得，哪些是推断。
• 工具链支持时，优先使用 KSP、配置缓存和延迟任务配置。
• 除非有明确理由，否则应将动态依赖版本、变更模块和急切创建任务视为性能退化。
• 建议在组织范围内推广之前，先确保 CI 指导方案已在示例项目中得到可复现验证。

反模式

• 不检查兼容性或失败情况，就启用所有 Gradle 标志。
• 未测量任务热点，就将构建缓慢归咎于 AGP 升级。
• 一次性将构建逻辑架构建议与构建耗时诊断混在一起。
• 使用会导致反复进行依赖解析的动态依赖版本。

审查重点

• 配置耗时、执行耗时、依赖解析耗时与测试总耗时。
• 配置缓存兼容性和延迟任务注册。
• KSP 与 kapt，以及注解处理器热点。
• 远程/本地缓存的价值、动态依赖和 CI 特有的瓶颈。

示例

顺利流程

• 场景：审计 Compose 示例项目中与构建缓存、配置缓存、KSP 和急切创建任务相关的问题。
• 命令：python3 skills/android-gradle-build-performance/scripts/audit_build_performance.py examples/orbittasks-compose --json

边缘情况

• 场景：在选择 CI 构建优化方案之前，对比 XML 和 Compose 示例项目的构建设置。
• 命令：bash skills/android-gradle-build-performance/scripts/run_examples.sh

故障恢复

• 场景：启用性能标志后重新检查项目，确保在推广之前发现性能退化。
• 命令：python3 skills/android-gradle-build-performance/scripts/audit_build_performance.py examples/orbittasks-xml

完成清单

• 瓶颈已关联到具体阶段、标志、插件或依赖模式。
• 提出的优化可衡量且可撤销。
• 建议的修复方案与当前 Android 和 Gradle 工具链兼容。
• 结构性 Gradle 工作已与性能调优分开移交。

Official References

• https://docs.gradle.org/current/userguide/performance.html
• https://docs.gradle.org/current/userguide/configuration_cache.html
• https://docs.gradle.org/current/userguide/task_configuration_avoidance.html
• https://developer.android.com/build/optimize-your-build
• https://developer.android.com/build/ksp