设置文件是每个 Gradle 项目的入口点。

gradle basic 3

设置文件的主要目的是将子项目添加到你的构建中。

Gradle 支持单项目和多项目构建。

  • 对于单项目构建，设置文件是可选的。

  • 对于多项目构建，设置文件是必需的，并且声明所有子项目。

设置脚本

设置文件是一个脚本。它要么是 Groovy 编写的 settings.gradle 文件，要么是 Kotlin 中的 settings.gradle.kts 文件。

Groovy DSL 和 Kotlin DSL 是 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"

每个构建只有一个根项目。

2. 添加子项目

设置文件通过包含子项目（如果有的话）来定义项目的结构

include("app")
include("business-logic")
include("data-model")

查阅 编写设置文件 页面以了解更多信息。

下一步： 了解构建脚本 >>