Gradle 提供多种方法来检查您的构建
-
使用构建扫描分析
-
本地分析报告
-
低级分析
什么是构建扫描?
构建扫描 是运行构建时发生的事件的持久、可共享记录。构建扫描提供了有关您构建的见解,您可以使用这些见解来识别和修复性能瓶颈。
在 Gradle 4.3 及更高版本中,您可以使用 --scan
命令行选项创建构建扫描
$ gradle build --scan
对于较旧的 Gradle 版本,构建扫描插件用户手册 说明了如何启用构建扫描。
在构建结束时,Gradle 会显示一个 URL,您可以在其中找到您的构建扫描
BUILD SUCCESSFUL in 2s 4 actionable tasks: 4 executed Publishing build scan... https://gradle.com/s/e6ircx2wjbf7e
本节说明如何使用构建扫描分析您的构建。
使用构建扫描分析
性能页面可以帮助您使用构建扫描分析构建。要访问该页面,请单击左侧导航菜单中的“性能”,或在构建扫描主页上点击“探索性能”链接
性能页面显示完成构建的不同阶段所需的时间。此页面显示了以下操作所需的时间
-
启动
-
配置构建的项目
-
解析依赖项
-
执行任务
您还可以获取有关环境属性的详细信息,例如是否使用了守护进程。
在上面的构建扫描中,配置耗时超过 13 秒。单击“配置”选项卡将此阶段分解为组成部分,从而暴露缓慢的原因。
在这里,您可以看到应用于项目的脚本和插件,按应用时间从长到短排序。最慢的插件和脚本应用是优化的良好候选者。例如,脚本 script-b.gradle
应用了一次,但耗时 3 秒。展开该行以查看构建在何处应用了此脚本。
script-b.gradle
应用于构建您可以看到子项目 :app1
从其 build.gradle
文件内部应用了该脚本一次。
性能报告
如果您不想使用构建扫描,可以在根项目的 build/reports/profile
目录中生成 HTML 报告。要生成此报告,请使用 --profile
命令行选项
$ gradle --profile <tasks>
每个性能报告在其名称中都有一个时间戳,以避免覆盖现有报告。
该报告显示了运行构建所花费时间的细分。但是,此细分不像构建扫描那样详细。以下性能报告显示了可用的不同类别
低级性能分析
有时,即使您的构建脚本正确执行了所有操作,您的构建也可能很慢。这通常归结为插件和自定义任务中的效率低下或资源受限。使用 Gradle Profiler 查找这些类型的瓶颈。使用 Gradle Profiler,您可以定义诸如“在进行 ABI 更改后运行 'assemble'”之类的场景,并运行您的构建几次以收集性能分析数据。使用 Profiler 生成构建扫描。或者将其与 JProfiler 和 YourKit 等方法性能分析器结合使用。这些性能分析器可以帮助您找到自定义插件中效率低下的算法。如果您发现 Gradle 本身中的某些内容会减慢您的构建速度,请随时将性能分析器快照发送到 [email protected]。
性能类别
构建扫描和本地性能报告都将构建执行分解为相同的类别。以下部分解释了这些类别。
启动
这反映了 Gradle 的初始化时间,主要包括:
-
JVM 初始化和类加载
-
如果您使用的是包装器,则下载 Gradle 分发版
-
如果尚未运行合适的守护进程,则启动守护进程
-
执行 Gradle 初始化脚本
即使构建执行的启动时间很长,后续运行通常也会看到启动时间大幅下降。持续缓慢的构建启动时间通常是您的初始化脚本中存在问题的结果。仔细检查您在那里执行的工作是否必要且高效。
设置和 buildSrc
启动后,Gradle 会初始化您的项目。通常,Gradle 只处理您的设置文件。如果您在 buildSrc
目录中具有自定义构建逻辑,Gradle 也会处理该逻辑。在构建 buildSrc
一次后,Gradle 会认为它是最新的。最新的检查比逻辑处理要快得多。如果您的 buildSrc
阶段花费的时间过长,请考虑将其分解为一个单独的项目。然后,您可以将该项目的 JAR 工件添加为依赖项。
设置文件很少包含具有大量 I/O 或计算的代码。如果您发现 Gradle 处理设置文件需要很长时间,请使用更传统的分析方法,例如 Gradle 分析器,来确定原因。
加载项目
加载项目通常不需要花费大量时间,您也无法控制它。这里花费的时间基本上是构建中项目数量的函数。