org.gradle.api.initialization

インタフェース Settings

すべてのスーパーインタフェース:

PluginAware

public interface Settings
extends PluginAware

Declares the configuration required to instantiate and configure the hierarchy of Project instances which are to participate in a build.

There is a one-to-one correspondence between a Settings instance and a "settings.gradle" settings file. Before Gradle assembles the projects for a build, it creates a Settings instance and executes the settings file against it.

Assembling a Multi-Project Build

One of the purposes of the Settings object is to allow you to declare the projects which are to be included in the build. You add projects to the build using the include(String[]) method. There is always a root project included in a build. It is added automatically when the Settings object is created. The root project's name defaults to the name of the directory containing the settings file. The root project's project directory defaults to the directory containing the settings file.

When a project is included in the build, a ProjectDescriptor is created. You can use this descriptor to change the default values for several properties of the project.

Using Settings in a Settings File

Dynamic Properties

In addition to the properties of this interface, the Settings object makes some additional read-only properties available to the settings script. This includes properties from the following sources:

• Defined in the "gradle.properties" file located in the settings directory of the build.
• Defined the "gradle.properties" file located in the user's .gradle directory.
• Provided on the command-line using the -P option.

フィールドの概要

フィールド

修飾子とタイプ	フィールドと説明
static String	DEFAULT_SETTINGS_FILE The default name for the settings file.

メソッドの概要

修飾子とタイプ	メソッドと説明
ProjectDescriptor	findProject(File projectDir) Returns the project with the given project directory.
ProjectDescriptor	findProject(String path) Returns the project with the given path.
Gradle	getGradle() Returns the Gradle instance for the current build.
File	getRootDir() Returns the root directory of the build.
ProjectDescriptor	getRootProject() Returns the root project of the build.
Settings	getSettings() Returns this settings object.
File	getSettingsDir() Returns the settings directory of the build.
StartParameter	getStartParameter() Returns the set of parameters used to invoke this instance of Gradle.
void	include(String[] projectPaths) Adds the given projects to the build.
void	includeFlat(String[] projectNames) Adds the given projects to the build.
ProjectDescriptor	project(File projectDir) Returns the project with the given project directory.
ProjectDescriptor	project(String path) Returns the project with the given path.

インタフェースから継承されたメソッド org.gradle.api.plugins.PluginAware

apply, apply, getPlugins

フィールドの詳細

DEFAULT_SETTINGS_FILE

static final String DEFAULT_SETTINGS_FILE

The default name for the settings file.

関連項目:

定数フィールド値

メソッドの詳細

include

void include(String[] projectPaths)

Adds the given projects to the build. Each path in the supplied list is treated as the path of a project to add to the build. Note that these path are not file paths, but instead specify the location of the new project in the project hierarchy. As such, the supplied paths must use the ':' character as separator.

The last element of the supplied path is used as the project name. The supplied path is converted to a project directory relative to the root project directory.

As an example, the path a:b adds a project with path :a:b, name b and project directory $rootDir/a/b.

パラメータ:

projectPaths - the projects to add.

includeFlat

void includeFlat(String[] projectNames)

Adds the given projects to the build. Each name in the supplied list is treated as the name of a project to add to the build.

The supplied name is converted to a project directory relative to the parent directory of the root project directory.

As an example, the name a add a project with path :a, name a and project directory $rootDir/../a.

パラメータ:

projectNames - the projects to add.

getSettings

Settings getSettings()

Returns this settings object.

戻り値:

This settings object. Never returns null.

getSettingsDir

File getSettingsDir()

Returns the settings directory of the build. The settings directory is the directory containing the settings file.

戻り値:

The settings directory. Never returns null.

getRootDir

File getRootDir()

Returns the root directory of the build. The root directory is the project directory of the root project.

戻り値:

The root directory. Never returns null.

getRootProject

ProjectDescriptor getRootProject()

Returns the root project of the build.

戻り値:

The root project. Never returns null.

project

ProjectDescriptor project(String path)
                   throws UnknownProjectException

Returns the project with the given path.

パラメータ:

path - The path.

戻り値:

The project with the given path. Never returns null.

例外:

UnknownProjectException - If no project with the given path exists.

findProject

ProjectDescriptor findProject(String path)

Returns the project with the given path.

パラメータ:

path - The path

戻り値:

The project with the given path. Returns null if no such project exists.

project

ProjectDescriptor project(File projectDir)
                   throws UnknownProjectException

Returns the project with the given project directory.

パラメータ:

projectDir - The project directory.

戻り値:

The project with the given project directory. Never returns null.

例外:

UnknownProjectException - If no project with the given path exists.

findProject

ProjectDescriptor findProject(File projectDir)

Returns the project with the given project directory.

パラメータ:

projectDir - The project directory.

戻り値:

The project with the given project directory. Returns null if no such project exists.

getStartParameter

StartParameter getStartParameter()

Returns the set of parameters used to invoke this instance of Gradle.

戻り値:

The parameters. Never returns null.

getGradle

Gradle getGradle()

Returns the Gradle instance for the current build.

戻り値:

The Gradle instance. Never returns null.