用途:帮助排查和优化 Android/Gradle 构建性能,适用于构建变慢、调查性能回归、分析 Gradle Build Scan、区分配置与执行瓶颈、优化 CI/CD 构建时间、启用配置缓存、减少重复编译及调试 kapt/KSP 注解处理。
主要能力:提供诊断流程,先用 clean 与增量构建建立基线,再用 ./gradlew assembleDebug --scan 生成构建扫描,或用 ./gradlew assembleDebug --profile 生成报告,判断瓶颈位于初始化、配置或执行阶段;并列出多类优化项,如启用配置缓存、构建缓存、并行执行、调整 JVM 堆、使用非传递 R 类、将 kapt 迁移到 KSP、固定依赖版本、优化仓库顺序、使用 includeBuild、启用增量注解处理、避免配置期 I/O、采用懒加载任务配置,以及远程缓存与 Develocity 等 CI/CD 手段。
使用方式:在 gradle.properties 中按需开启 org.gradle.configuration-cache、org.gradle.caching、org.gradle.parallel、org.gradle.jvmargs 等;运行 --scan 或 --profile 查看报告;每次只应用一项优化并对比基线,最后用构建扫描验证。
适用场景与限制:适合 Android/Gradle 项目的本地或 CI 构建提速与性能分析。文档未提供具体版本兼容范围之外的信息,实际效果需按项目测量确认,缺失事实暂未提供。