按需配置会尝试仅为请求的任务配置相关项目,即它只评估参与构建的项目的构建脚本文件。通过这种方式,可以减少大型多项目构建的配置时间。
按需配置功能是孵化中的,因此只有某些构建才能保证正常工作。该功能对于解耦的多项目构建效果良好。
在按需配置模式下,项目配置如下:
-
根项目始终被配置。
-
在构建执行目录中的项目也会被配置,但仅当 Gradle 在没有任何任务的情况下执行时。
这样,当项目按需配置时,默认任务也能正常运行。 -
标准项目依赖项受支持,并且会配置相关项目。
如果项目 A 编译依赖于项目 B,那么构建 A 会导致两个项目都被配置。 -
通过任务路径声明的任务依赖项受支持,并导致相关项目被配置。
示例:someTask.dependsOn(":some-other-project:someOtherTask")
-
从命令行(或工具 API)通过任务路径请求的任务会导致相关项目被配置。
例如,构建project-a:project-b:someTask
会导致project-b
被配置。