API DOC

Settings
声明一个用来实例化并配置参与到构建中的Project实例体系的配置对象.
Settings实例和Settings.gradle 文件一对一对应 ..
在一个构建中组装一个项目,构建需要创建一个Settings 实例并执行配置文件脚本并配置代理对象 …

Assembling a Multi-Project Build

Settings 对象的目的之一是允许你声明能够包含在构建中的projects ..对象 …
你也能够增加项目到构建中,通过Settings.include(java.lang.String[]))方法 ..
一般来说，它总是包含在构建的根项目中 …
当Settings对象创建时自动的增加,这个根项目的名称默认是包含了配置文件的目录名称，根项目的项目目录默认是包含了settings文件的目录 ..
当一个项目是”include”到构建中,会创建一个ProjectDescriptor,你能够使用这个描述符去改变这个项目的各种各样的属性 ..

Using Settings in a Settings File

动态属性

除了这个接口的属性,Settings对象制造了一些可选的只读属性可以运用到settings 脚本中 …
这些包括来自以下资源的属性

定义在gradle.properties 文件(位于构建的settings目录中的)属性
定义位于用户的.gradle目录中的gradle.properties文件中的属性
通过命令行 -P选项提供的属性 ..
Properties
| Property | Description | | —- | —- | | buildCache | 构建缓存配置 | | extensions | 扩展的容器 | | Gradle | 当前构建的Gradle 实例 | | pluginManager | 插件管理器 - 一个插件感知对象 | | plugins | 已经应用到这个对象的插件的容器 … | | rootDir | 构建的根目录,根项目的项目目录 … | | rootProject | 构建的根项目 | | settings | 配置对象 | | settingsDir | 构建的配置目录,这个配置目录是包含了settings文件的目录 .. | | startParameter | 用来执行此Gradle 实例的参数集合 .. |

Methods

Method	Description
apply(closure))	增加一个插件或者多个插件或者脚本
apply(options))	应用一个插件或者脚本,使用给定提供为Map的options(如果插件已经注册不做任何事情)
apply(action))	应用零个或者多个插件 / 脚本
buildCache(action))	配置构建缓存
findProject(projectDir))	返回给定项目目录的项目
findProject(path))	返回给定目录的项目
include(projectPaths))	增加给定项目到构建中,应用列表中的每一个路径处理为项目的路径增加到构件中,注意这些路径不是文件路径,相反指定在项目体系中的新项目的未知,例如, 这个提供的路径必须使用”:” 字符串作为分隔符而不是(‘/‘)…
includeBuild(rootProject))	包括一个特定路径上的构建到组合构建中 …
includeBuild)(rootProject, configuration)	包括特定路径上的构建到组合构建中,并提供特定的配置
includeFlat(projectNames))	增加给定的项目到构建中,提供列表中的每一个名字将作为项目的名称进行处理增加到构建中 …
project)(projectDir)	返回给定项目目录的项目
project(path))	返回给定路径的项目

Script blocks

no Script blocks ..

Property details

点击官网描述

Settings

Table of Contents