声明实例化和配置要参与构建的Project实例的层次结构所需的配置。 Settings实例与settings.gradle设置文件之间存在一对一的对应关系。在Gradle组装构建项目之前,它会创建一个Settings实例并对其执行设置文件。
组装多项目构建
Settings对象的一个目的是允许您声明要包含在构建中的项目。您可以使用Settings.include(java.lang.String [])方法将项目添加到构建中。构建中始终包含根项目,创建Settings对象时会自动添加它。根项目的名称默认为包含设置文件的目录的名称。根项目的项目目录默认为包含设置文件的目录。当项目包含在构建中时,将创建ProjectDescriptor。您可以使用此描述符更改项目的多个属性的默认值。
Dynamic Properties
除了此接口的属性之外,Settings对象还为设置脚本提供了一些其他只读属性。这包括以下来源的属性:
- 定义在位于构建的settings目录中的gradle.properties文件中。
- 定义位于用户的.gradle目录中的gradle.properties文件。
- 使用-P选项在命令行中提供。