构建扫描 (Build Scan)
构建扫描是一个强大的诊断工具,它可以生成一份包含构建过程所有细节的交互式报告。
1. 为什么使用构建扫描?
- 可视化分析: 清楚地看到哪些任务运行了,哪些被跳过了。
- 依赖图谱: 查看所有传递依赖及其下载耗时。
- 错误堆栈: 提供比命令行更清晰的错误追踪。
- 性能对比: 帮助你排查为什么这次构建比上次慢。
2. 如何生成扫描报告
只需在任何 Gradle 命令后面加上 --scan 参数:
bash
./gradlew assembleDebug --scan流程:
- 构建结束后,Gradle 会询问你是否同意服务协议。
- 输入
yes并回车。 - Gradle 会上传构建元数据并返回一个 URL。
- 在浏览器中打开该 URL 即可查看报告。
3. 核心功能区
- Timeline: 每一秒钟 Gradle 都在做什么。
- Infrastructure: 编译使用的 CPU、内存和 Java 版本。
- Performance: 增量构建的有效性分析。
隐私提醒
构建扫描会将构建元数据上传到 Gradle 官方服务器。在公司内部项目中使用前,请确认是否符合安全政策。