Skip to content

构建扫描 (Build Scan)

源:Gradle 构建扫描

构建扫描是一个强大的诊断工具,它可以生成一份包含构建过程所有细节的交互式报告。

1. 为什么使用构建扫描?

  • 可视化分析: 清楚地看到哪些任务运行了,哪些被跳过了。
  • 依赖图谱: 查看所有传递依赖及其下载耗时。
  • 错误堆栈: 提供比命令行更清晰的错误追踪。
  • 性能对比: 帮助你排查为什么这次构建比上次慢。

2. 如何生成扫描报告

只需在任何 Gradle 命令后面加上 --scan 参数:

bash
./gradlew assembleDebug --scan

流程:

  1. 构建结束后,Gradle 会询问你是否同意服务协议。
  2. 输入 yes 并回车。
  3. Gradle 会上传构建元数据并返回一个 URL。
  4. 在浏览器中打开该 URL 即可查看报告。

3. 核心功能区

  • Timeline: 每一秒钟 Gradle 都在做什么。
  • Infrastructure: 编译使用的 CPU、内存和 Java 版本。
  • Performance: 增量构建的有效性分析。

隐私提醒

构建扫描会将构建元数据上传到 Gradle 官方服务器。在公司内部项目中使用前,请确认是否符合安全政策。