设置文件(settings.gradle(.kts)
)是每个 Gradle 项目的入口点。

设置文件的主要目的是定义项目结构,通常是将子项目添加到你的构建中。因此,在
-
单项目构建中,设置文件是可选的。
-
多项目构建中,设置文件是强制的,并声明所有子项目。
设置脚本
设置文件是一个脚本。它要么是使用 Groovy 编写的 settings.gradle
文件,要么是使用 Kotlin 编写的 settings.gradle.kts
文件。
Groovy DSL 和 Kotlin DSL 是 Gradle 脚本唯一支持的语言。
设置文件通常位于项目的根目录中,因为它定义了构建的结构,例如包含哪些项目。如果没有设置文件,Gradle 默认将构建视为单项目构建。
让我们看一个示例并进行分解
settings.gradle.kts
rootProject.name = "root-project" (1)
include("sub-project-a") (2)
include("sub-project-b")
include("sub-project-c")
1 | 定义项目名称。 |
2 | 添加子项目。 |
settings.gradle
rootProject.name = 'root-project' (1)
include('sub-project-a') (2)
include('sub-project-b')
include('sub-project-c')
1 | 定义项目名称。 |
2 | 添加子项目。 |
1. 定义项目名称
设置文件定义了你的项目名称
rootProject.name = "root-project"
每个构建只有一个根项目。