Project

API Documentation:Project

This interface is the main API you use to interact with Gradle from your build file. From a Project, you have programmatic access to all of Gradle's features. このインターフェースは、ビルドファイル内でGradleとやりとりする際、メインで使用するAPIです。Projectから、Gradleの全ての機能にプログラム的にアクセスできます。

Lifecycleライフサイクル

There is a one-to-one relationship between a Project and a build.gradle file. During build initialisation, Gradle assembles a Project object for each project which is to participate in the build, as follows: Projectbuild.gradleファイルは、1対1の関係性を持ちます。 ビルドの初期化の際に、Gradleは各プロジェクトのビルドに参加しているProject オブジェクトに、以下に示すような組み付けを行います。

  • Create a Settings instance for the build. ビルド用に、Settingsインスタンスを作成します。
  • Evaluate the settings.gradle script, if present, against the Settings object to configure it.構成するSettingsオブジェクトに対して、settings.gradleが存在するならば、評価します。
  • Use the configured Settings object to create the hierarchy of Project instances.Projectインスタンスの階層の作成に、構成したSettingsオブジェクトを使用します。
  • Finally, evaluate each Project by executing its build.gradle file, if present, against the project. The project are evaluated in breadth-wise order, such that a project is evaluated before its child projects. This order can be overridden by calling Project.evaluationDependsOnChildren() or by adding an explicit evaluation dependency using Project.evaluationDependsOn(). 最後に、プロジェクトに対して存在するならば、build.gradleファイルを実行し各Projectを評価します。 プロジェクトは、子プロジェクトより前に評価されるプロジェクトの様に、横方向の順序で評価されます。 This order can be overridden by calling Project.evaluationDependsOnChildren() or by adding an explicit evaluation dependency using Project.evaluationDependsOn().この順序はProject.evaluationDependsOnChildren()の呼び出しか、Project.evaluationDependsOn()を使用した明示的な評価依存関係の追加によって上書きできます。

Tasksタスク

A project is essentially a collection of Task objects. Each task performs some basic piece of work, such as compiling classes, or running unit tests, or zipping up a WAR file. You add tasks to a project using one of the create() methods on TaskContainer, such as TaskContainer.create(). You can locate existing tasks using one of the lookup methods on TaskContainer, such as TaskCollection.getByName(). プロジェクトは効果的なTaskオブジェクトのコレクションです。 それぞれのタスクは、クラスのコンパイルや、ユニットテストの実行、WARファイルの圧縮などのような、作業の基本的な一片として動作します。 あなたはTaskContainer.create()のようなTaskContainer上のcreate()メソッドの1つを使用し、タスクをプロジェクトに追加します。 あなたはTaskCollection.getByName()のようなTaskContainer上のルックアップメソッドの1つを使用し、存在するタスクを配置できます。

Dependencies依存性

A project generally has a number of dependencies it needs in order to do its work. Also, a project generally produces a number of artifacts, which other projects can use. Those dependencies are grouped in configurations, and can be retrieved and uploaded from repositories. You use the ConfigurationContainer returned by Project.getConfigurations() method to manage the configurations. The DependencyHandler returned by Project.getDependencies() method to manage the dependencies. The ArtifactHandler returned by Project.getArtifacts() method to manage the artifacts. The RepositoryHandler returned by Project.getRepositories() method to manage the repositories. 一般的なプロジェクトはその動作をするために必要ないくつもの依存性を持っています。さらに、一般的なプロジェクトは他のプロジェクトが使用できるようないくつもの成果物を生成します。 それらの依存性は構成内でグループ化され、リポジトリから回収され、アップロードされる事ができます。 あなたは構成を管理するProject.getConfigurations()メソッドから返されたConfigurationContainerや、依存性を管理するProject.getDependencies()メソッドから返されたDependencyHandlerや、成果物を管理するProject.getArtifacts()メソッドから返されたArtifactHandlerや、リポジトリを管理するProject.getRepositories()メソッドから返されたRepositoryHandlerを使います。

Multi-project Buildsマルチプロジェクトビルド

Projects are arranged into a hierarchy of projects. A project has a name, and a fully qualified path which uniquely identifies it in the hierarchy. プロジェクトはプロジェクトの階層の中に配置されます。プロジェクトは名前やプロジェクト階層内において一意に識別できる絶対パスを持ちます。

Plugins

Plugins can be used to modularise and reuse project configuration. Plugins can be applied using the Project.apply() method, or by using the PluginDependenciesSpec.

Propertiesプロパティ

Gradle executes the project's build file against the Project instance to configure the project. Any property or method which your script uses is delegated through to the associated Project object. This means, that you can use any of the methods and properties on the Project interface directly in your script. Gradleはプロジェクトを構成するProjectインスタンスに対してプロジェクトのビルドファイルを実行します。 あなたのスクリプトが使用するようないくつかのプロパティやメソッドは、組織されたProjectオブジェクトを通して委譲されます。 この意味は、あなたのスクリプトの中でダイレクトにProjectインターフェイスのいくつかのメソッドやプロパティをあなたは使用できるという事です。

For example: 例:

defaultTasks('some-task')  // Delegates to Project.defaultTasks()
reportsDir = file('reports') // Delegates to Project.file() and the Java Plugin

You can also access the Project instance using the project property. This can make the script clearer in some cases. For example, you could use project.name rather than name to access the project's name. あなたはProjectプロパティを使用してProjectインスタンスにアクセスできます。これによっていくつかのケースで冴えたスクリプトを作ることができます。 例えば、あなたはプロジェクトの名前を参照するのにnameを使用するのではなく、project.nameを使うことができました。

A project has 5 property 'scopes', which it searches for properties. You can access these properties by name in your build file, or by calling the project's Project.property() method. The scopes are: プロジェクトはプロパティを探す5つの「プロパティスコープ」を持っています。あなたはあなたのビルドファイルの中で名前で、もしくはプロジェクトのProject.property()メソッドの呼び出しでそれらのプロパティにアクセスできます。 そのスコープとは:

  • The Project object itself. This scope includes any property getters and setters declared by the Project implementation class. For example, Project.getRootProject() is accessible as the rootProject property. The properties of this scope are readable or writable depending on the presence of the corresponding getter or setter method.Projectオブジェクト自身。このスコープはProjectをimplemantしたクラスが宣言したいくつかのプロパティのgetter、setterメソッドを含みます。 例えばProject.getRootProject()rootProjectプロパティにアクセス可能です。 このスコープのプロパティは一致したgetter、setterメソッドの存在に依存したままで読み書き可能です。
  • The extra properties of the project. Each project maintains a map of extra properties, which can contain any arbitrary name -> value pair. Once defined, the properties of this scope are readable and writable. See extra properties for more details. プロジェクトのextraプロパティ。各自のプロジェクトは任意の名前 -> 値のペアを含むことができる追加されたプロパティのマップを維持します。 このスコープのプロパティは読み書き可能です。
  • The extensions added to the project by the plugins. Each extension is available as a read-only property with the same name as the extension.
  • The convention properties added to the project by the plugins. A plugin can add properties and methods to a project through the project's Convention object. The properties of this scope may be readable or writable, depending on the convention objects.conventionプロパティはプロジェクトに付属の各Pluginによってプロジェクトに追加しました。PluginConventionオブジェクトを通じてプロジェクトにプロパティやメソッドを追加できます。 このスコープのプロパティは参加しているオブジェクトに依存していて、おそらく読み書き可能です。
  • The tasks of the project. A task is accessible by using its name as a property name. The properties of this scope are read-only. For example, a task called compile is accessible as the compile property. プロジェクトのタスク。タスクはそのプロパティの名前を使ってアクセスできます。このスコープのプロパティは読み取り専用です。 例えば、タスクが呼び出したcompilecompileプロパティでアクセスできます。
  • The extra properties and convention properties inherited from the project's parent, recursively up to the root project. The properties of this scope are read-only. プロジェクトの親プロジェクトの拡張プロパティや通常のプロパティはrootプロジェクトに向かって繰り返し用いられます。 このスコープのプロジェクトは読み取り専用です。

When reading a property, the project searches the above scopes in order, and returns the value from the first scope it finds the property in. If not found, an exception is thrown. See Project.property() for more details. プロパティを読み込んだ際、プロジェクトは順に上のスコープを探し、発見したプロパティの最初のスコープからの値を返します。見つからない場合は例外がスローされます。 詳しい詳細はProject.property()をご覧ください。

When writing a property, the project searches the above scopes in order, and sets the property in the first scope it finds the property in. If not found, an exception is thrown. See Project.setProperty() for more details. プロパティ書き込み時は、プロジェクトは順に上のスコープを探し、プロパティを発見する最初のスコープの中でプロパティをセットします。 もし見つからなければ、例外がスローされます。 詳しい詳細はProject.setProperty()をご覧ください。

Extra Propertiesエクストラプロパティ

All extra properties must be defined through the "ext" namespace. Once an extra property has been defined, it is available directly on the owning object (in the below case the Project, Task, and sub-projects respectively) and can be read and updated. Only the initial declaration that needs to be done via the namespace. 全てのエクストラプロパティは"ext"ネームスペースを通して定義されなければなりません。一度エクストラプロパティが定義された場合、それらは専有オブジェクト(下記のプロジェクト、タスク、サブプロジェクト各々)のケー ス上で可能にし、読み込みや編集ができます。 それは名前空間経由で実行される際に必要な初めの宣言にだけです。

project.ext.prop1 = "foo"
task doStuff {
    ext.prop2 = "bar"
}
subprojects { ext.${prop3} = false }

Reading extra properties is done through the "ext" or through the owning object. "ext"を通じてもしくは専有オブジェクトを追加し、エクストラプロパティの読み込みは行われました。

ext.isSnapshot = version.endsWith("-SNAPSHOT")
if (isSnapshot) {
    // do snapshot stuff
}

Dynamic Methodsダイナミックメソッド

A project has 5 method 'scopes', which it searches for methods: プロジェクトはメソッドを探す5つの「メソッドスコープ」を持っています。

  • The Project object itself.Projectオブジェクト自身。
  • The build file. The project searches for a matching method declared in the build file. ビルドファイル。プロジェクトはビルドファイルの中で宣言された適合するメソッドを探します。
  • The extensions added to the project by the plugins. Each extension is available as a method which takes a closure or Action as a parameter.
  • The convention methods added to the project by the plugins. A plugin can add properties and method to a project through the project's Convention object.conventionメソッドがプロジェクトに適応したプラグインによってプロジェクトに追加しました。 プラグインはプロジェクトのConventionオブジェクトを通してプロジェクトにプロパティやメソッドを追加できます。
  • The tasks of the project. A method is added for each task, using the name of the task as the method name and taking a single closure or Action parameter. The method calls the Task.configure() method for the associated task with the provided closure. For example, if the project has a task called compile, then a method is added with the following signature: void compile(Closure configureClosure). プロジェクトのタスク。メソッドはメソッド名のタスクや単一のクロージャーないしはActionパラメーターから取得した名前を使用してそれぞれのタスクに追加されました。 メソッドの呼び出しは提供されたクロージャに付帯の構成されたタスクのTask.configure()メソッドを呼びます。 例えば、もしプロジェクトがcompileと呼ばれるタスクを持っていて、その時メソッドは後述のような記述が追加されています。void compile(ClosureconfigureClosure)
  • The methods of the parent project, recursively up to the root project. 親プロジェクトのメソッド。ルートプロジェクトに向かって再帰的になります。

Properties

PropertyDescription
allprojects

The set containing this project and its subprojects.

ant

The AntBuilder for this project. You can use this in your build file to execute ant tasks. See example below.

artifacts

Returns a handler for assigning artifacts produced by the project to configurations.

buildDir

Returns the build directory of this project. The build directory is the directory which all artifacts are generated into. The default value for the build directory is projectDir/build このプロジェクトのビルドディレクトリを返します。ビルドディレクトリは全ての生成物の生成先ディレクトリです。 ビルドディレクトリのデフォルト値はprojectDir/buildです。

buildFile

Returns the build file Gradle will evaluate against this project object. The default is build.gradle. If an embedded script is provided the build file will be null. Gradleがプロジェクトオブジェクトに対して評価するビルドファイルを返します。 もし埋め込むスクリプトに空っぽのビルドファイルを提供された時、デフォルトはbuild.gradleです。

buildscript

The build script handler for this project. You can use this handler to query details about the build script for this project, and manage the classpath used to compile and execute the project's build script.

childProjects

The direct children of this project.

configurations

The configurations of this project.

convention

The Convention for this project.

defaultTasks

The names of the default tasks of this project. These are used when no tasks names are provided when starting the build.

dependencies

The dependency handler of this project. The returned dependency handler instance can be used for adding new dependencies. For accessing already declared dependencies, the configurations can be used.

description

Returns the description of this project. このプロジェクトの記述を返します。

extensions

Allows adding DSL extensions to the project. Useful for plugin authors.

gradle

The Gradle invocation which this project belongs to.

group

Returns the group of this project. Gradle always uses the toString() value of the group. The group defaults to the path with dots a separators. このプロジェクトのグループを返します。GradleはグループのtoString()の値をいつも使います。 グループはパスをドットで区切るのが標準です。

logger

The logger for this project. You can use this in your build file to write log messages.

logging

The LoggingManager which can be used to control the logging level and standard output/error capture for this project's build script. By default, System.out is redirected to the Gradle logging system at the QUIET log level, and System.err is redirected at the ERROR log level.

name

Returns the name of this project. The project's name is not necessarily unique within a project hierarchy. You should use the Project.getPath() method for a unique identifier for the project. このプロジェクトの名前を返します。プロジェクトの階層の範囲内でプロジェクトの名前はユニークである必要はありません。 あなたはプロジェクトのユニークな識別子のためにProject.getPath()メソッドを使うべきです。

parent

Returns the parent project of this project, if any. もし存在するなら、このプロジェクトの親プロジェクトを返します。

path

The path of this project. The path is the fully qualified name of the project.

plugins

The plugins container for this project. The returned container can be used to manage the plugins which are used by this project.

project

Returns this project. This method is useful in build files to explicitly access project properties and methods. For example, using project.name can express your intent better than using name. This method also allows you to access project properties from a scope where the property may be hidden, such as, for example, from a method or closure.

projectDir

The directory containing the project build file.

properties

The properties of this project. See here for details of the properties which are available for a project.

repositories

Returns a handler to create repositories which are used for retrieving dependencies and uploading artifacts produced by the project.

resources

Provides access to resource-specific utility methods, for example factory methods that create various resources.

rootDir

Returns the root directory of this project. The root directory is the project directory of the root project. このプロジェクトのルートディレクトリを返します。ルートディレクトリはルートプロジェクトのプロジェクトディレクトリです。

rootProject

Returns the root project for the hierarchy that this project belongs to. In the case of a single-project build, this method returns this project. このプロジェクトが所属するルートプロジェクトを階層に沿って返します。シングルプロジェクトのビルドの場合は、このメソッドはそのプロジェクト自身を返します。

state

The evaluation state of this project. You can use this to access information about the evaluation of this project, such as whether it has failed.

status

The status of this project. Gradle always uses the toString() value of the status. The status defaults to release.

subprojects

The set containing the subprojects of this project.

tasks

The tasks of this project.

version

Returns the version of this project. Gradle always uses the toString() value of the version. The version defaults to unspecified. このプロジェクトのバージョンを返します。GradleはバージョンのtoString()の値をいつも使います。 バージョンのデフォルトはunspecifiedです。

Properties added by the LanguageBasePlugin plugin

PropertyDescription
binaries

The BinaryContainer added by the LanguageBasePlugin plugin.

projectComponents

The ComponentSpecContainer added by the LanguageBasePlugin plugin.

sources

The ProjectSourceSet added by the LanguageBasePlugin plugin.

Properties added by the announce plugin

PropertyDescription
announce

The AnnouncePluginExtension added by the announce plugin.

Properties added by the application plugin

PropertyDescription
applicationDefaultJvmArgs

Array of string arguments to pass to the JVM when running the application

applicationDistribution

The specification of the contents of the distribution.

applicationName

The name of the application.

mainClassName

The fully qualified name of the application's main class.

Properties added by the checkstyle plugin

PropertyDescription
checkstyle

The CheckstyleExtension added by the checkstyle plugin.

Properties added by the codenarc plugin

PropertyDescription
codenarc

The CodeNarcExtension added by the codenarc plugin.

Properties added by the distribution plugin

PropertyDescription
distributions

The DistributionContainer added by the distribution plugin.

Properties added by the ear plugin

PropertyDescription
appDirName

The name of the application directory, relative to the project directory. Default is "src/main/application".

deploymentDescriptor

A custom deployment descriptor configuration. Default is an "application.xml" with sensible defaults.

libDirName

The name of the library directory in the EAR file. Default is "lib".

Properties added by the eclipse plugin

PropertyDescription
eclipse

The EclipseModel added by the eclipse plugin.

Properties added by the findbugs plugin

PropertyDescription
findbugs

The FindBugsExtension added by the findbugs plugin.

Properties added by the idea plugin

PropertyDescription
idea

The IdeaModel added by the idea plugin.

Properties added by the jacoco plugin

PropertyDescription
jacoco

The JacocoPluginExtension added by the jacoco plugin.

Properties added by the java plugin

PropertyDescription
archivesBaseName

The base name to use for archive files.

distsDir

The directory to generate TAR and ZIP archives into.

distsDirName

The name for the distributions directory. This in interpreted relative to the project' build directory.

docsDir

Returns a file pointing to the root directory supposed to be used for all docs.

docsDirName

The name of the docs directory. Can be a name or a path relative to the build dir.

libsDir

The directory to generate JAR and WAR archives into.

libsDirName

The name for the libs directory. This in interpreted relative to the project' build directory.

reporting

The ReportingExtension added by the java plugin.

sourceCompatibility

The source compatibility used for compiling Java sources.

sourceSets

The source sets container.

targetCompatibility

The target compatibility used for compiling Java sources.

testReportDir

Returns a file pointing to the root directory to be used for reports.

testReportDirName

The name of the test reports directory. Can be a name or a path relative to the build dir.

testResultsDir

Returns a file pointing to the root directory of the test results.

testResultsDirName

The name of the test results directory. Can be a name or a path relative to the build dir.

Properties added by the jdepend plugin

PropertyDescription
jdepend

The JDependExtension added by the jdepend plugin.

Properties added by the jetty plugin

PropertyDescription
httpPort

The TCP port for Jetty to listen on for incoming HTTP requests.

stopKey

The key to use to stop Jetty.

stopPort

The TCP port for Jetty to listen on for stop requests.

Properties added by the jvm-component plugin

PropertyDescription
jvm

The JvmComponentExtension added by the jvm-component plugin.

Properties added by the maven plugin

PropertyDescription
conf2ScopeMappings

The set of rules for how to map Gradle dependencies to Maven scopes.

mavenPomDir

The directory to generate Maven POMs into.

Properties added by the pmd plugin

PropertyDescription
pmd

The PmdExtension added by the pmd plugin.

Properties added by the project-report plugin

PropertyDescription
projectReportDir

The directory to generate the project reports into.

projectReportDirName

The name of the directory to generate the project reports into, relative to the project's reports dir.

Properties added by the publishing plugin

PropertyDescription
publishing

The PublishingExtension added by the publishing plugin.

Properties added by the signing plugin

PropertyDescription
signing

The SigningExtension added by the signing plugin.

Properties added by the sonar-runner plugin

PropertyDescription
sonarRunner

The SonarRunnerRootExtension added by the sonar-runner plugin.

Properties added by the visual-studio plugin

PropertyDescription
visualStudio

The VisualStudioExtension added by the visual-studio plugin.

Properties added by the war plugin

PropertyDescription
webAppDir

The web application directory.

webAppDirName

The name of the web application directory, relative to the project directory.

Methods

MethodDescription
absoluteProjectPath(path)

Converts a name to an absolute project path, resolving names relative to this project.

afterEvaluate(closure)

Adds a closure to be called immediately after this project has been evaluated. The project is passed to the closure as a parameter. Such a listener gets notified when the build file belonging to this project has been executed. A parent project may for example add such a listener to its child project. Such a listener can further configure those child projects based on the state of the child projects after their build files have been run.

afterEvaluate(action)

Adds an action to execute immediately after this project is evaluated.

allprojects(action)

Configures this project and each of its sub-projects.

apply(closure)

Configures this project using plugins or scripts. The given closure is used to configure an ObjectConfigurationAction which is then used to configure this project.

apply(options)

Configures this project using plugins or scripts. The following options are available:

beforeEvaluate(closure)

Adds a closure to be called immediately before this project is evaluated. The project is passed to the closure as a parameter.

beforeEvaluate(action)

Adds an action to execute immediately before this project is evaluated.

configure(objects, configureClosure)

Configures a collection of objects via a closure. This is equivalent to calling Project.configure() for each of the given objects.

configure(objects, configureAction)

Configures a collection of objects via an action.

configure(object, configureClosure)

Configures an object via a closure, with the closure's delegate set to the supplied object. This way you don't have to specify the context of a configuration statement multiple times.

container(type)

Creates a container for managing named objects of the specified type. The specified type must have a public constructor which takes the name as a String parameter.

container(type, factoryClosure)

Creates a container for managing named objects of the specified type. The given closure is used to create object instances. The name of the instance to be created is passed as a parameter to the closure.

container(type, factory)

Creates a container for managing named objects of the specified type. The given factory is used to create object instances.

copy(closure)

Copies the specified files. The given closure is used to configure a CopySpec, which is then used to copy the files. Example:

copySpec(closure)

Creates a CopySpec which can later be used to copy files or create an archive. The given closure is used to configure the CopySpec before it is returned by this method.

delete(paths)

Deletes files and directories.

evaluationDependsOn(path)

Declares that this project has an evaluation dependency on the project with the given path.

exec(closure)

Executes an external command. The closure configures a ExecSpec.

exec(action)

Executes an external command.

file(path)

Resolves a file path relative to the project directory of this project. This method converts the supplied path based on its type:

file(path, validation)

Resolves a file path relative to the project directory of this project and validates it using the given scheme. See PathValidation for the list of possible validations.

fileTree(baseDir)

Creates a new ConfigurableFileTree using the given base directory. The given baseDir path is evaluated as per Project.file().

fileTree(baseDir, configureClosure)

Creates a new ConfigurableFileTree using the given base directory. The given baseDir path is evaluated as per Project.file(). The closure will be used to configure the new file tree. The file tree is passed to the closure as its delegate. Example:

fileTree(args)

Creates a new ConfigurableFileTree using the provided map of arguments. The map will be applied as properties on the new file tree. Example:

files(paths, configureClosure)

Creates a new ConfigurableFileCollection using the given paths. The paths are evaluated as per Project.files(). The file collection is configured using the given closure. The file collection is passed to the closure as its delegate. Example:

files(paths)

Returns a ConfigurableFileCollection containing the given files. You can pass any of the following types to this method:

findProject(path)

Locates a project by path. If the path is relative, it is interpreted relative to this project.

getAllTasks(recursive)

Returns a map of the tasks contained in this project, and optionally its subprojects.

getTasksByName(name, recursive)

Returns the set of tasks with the given name contained in this project, and optionally its subprojects.

hasProperty(propertyName)

Determines if this project has the given property. See here for details of the properties which are available for a project.

javaexec(closure)

Executes a Java main class. The closure configures a JavaExecSpec.

javaexec(action)

Executes an external Java process.

mkdir(path)

Creates a directory and returns a file pointing to it.

project(path)

Locates a project by path. If the path is relative, it is interpreted relative to this project.

project(path, configureClosure)

Locates a project by path and configures it using the given closure. If the path is relative, it is interpreted relative to this project. The target project is passed to the closure as the closure's delegate.

property(propertyName)

Returns the value of the given property. This method locates a property as follows:

relativePath(path)

Returns the relative path from the project directory to the given path. The given path object is (logically) resolved as described for Project.file(), from which a relative path is calculated.

relativeProjectPath(path)

Converts a name to a project path relative to this project.

setProperty(name, value)

Sets a property of this project. This method searches for a property with the given name in the following locations, and sets the property on the first location where it finds the property.

subprojects(action)

Configures the sub-projects of this project

tarTree(tarPath)

Creates a new FileTree which contains the contents of the given TAR file. The given tarPath path can be:

task(name)

Creates a Task with the given name and adds it to this project. Calling this method is equivalent to calling Project.task() with an empty options map.

task(name, configureClosure)

Creates a Task with the given name and adds it to this project. Before the task is returned, the given closure is executed to configure the task.

task(args, name)

Creates a Task with the given name and adds it to this project. A map of creation options can be passed to this method to control how the task is created. The following options are available:

task(args, name, configureClosure)

Creates a Task with the given name and adds it to this project. Before the task is returned, the given closure is executed to configure the task. A map of creation options can be passed to this method to control how the task is created. See Project.task() for the available options.

uri(path)

Resolves a file path to a URI, relative to the project directory of this project. Evaluates the provided path object as described for Project.file(), with the exception that any URI scheme is supported, not just 'file:' URIs.

zipTree(zipPath)

Creates a new FileTree which contains the contents of the given ZIP file. The given zipPath path is evaluated as per Project.file(). You can combine this method with the Project.copy() method to unzip a ZIP file.

Methods added by the ear plugin

MethodDescription
appDirName(appDirName)

Allows changing the application directory. Default is "src/main/application".

libDirName(libDirName)

Allows changing the library directory in the EAR file. Default is "lib".

Methods added by the java plugin

MethodDescription
manifest()

Creates a new instance of a Manifest.

manifest(closure)

Creates and configures a new instance of a Manifest. The given closure configures the new manifest instance before it is returned.

Methods added by the maven plugin

MethodDescription
pom()

Creates a new MavenPom.

pom(configureClosure)

Creates and configures a new MavenPom. The given closure is executed to configure the new POM instance.

Methods added by the osgi plugin

MethodDescription
osgiManifest()

Creates a new instance of OsgiManifest. The returned object is preconfigured with:

osgiManifest(closure)

Creates and configures a new instance of an OsgiManifest . The closure configures the new manifest instance before it is returned.

Script blocks

BlockDescription
allprojects

Configures this project and each of its sub-projects.

ant

Executes the given closure against the AntBuilder for this project. You can use this in your build file to execute ant tasks. The AntBuild is passed to the closure as the closure's delegate. See example in javadoc for Project.getAnt()

artifacts

Configures the published artifacts for this project.

buildscript

Configures the build script classpath for this project.

configurations

Configures the dependency configurations for this project.

dependencies

Configures the dependencies for this project.

repositories

Configures the repositories for this project.

subprojects

Configures the sub-projects of this project.

Script blocks added by the LanguageBasePlugin plugin

BlockDescription
binaries

Configures the BinaryContainer added by the LanguageBasePlugin plugin.

projectComponents

Configures the ComponentSpecContainer added by the LanguageBasePlugin plugin.

sources

Configures the ProjectSourceSet added by the LanguageBasePlugin plugin.

Script blocks added by the announce plugin

BlockDescription
announce

Configures the AnnouncePluginExtension added by the announce plugin.

Script blocks added by the checkstyle plugin

BlockDescription
checkstyle

Configures the CheckstyleExtension added by the checkstyle plugin.

Script blocks added by the codenarc plugin

BlockDescription
codenarc

Configures the CodeNarcExtension added by the codenarc plugin.

Script blocks added by the distribution plugin

BlockDescription
distributions

Configures the DistributionContainer added by the distribution plugin.

Script blocks added by the ear plugin

BlockDescription
deploymentDescriptor

Configures the deployment descriptor for this EAR archive.

Script blocks added by the eclipse plugin

BlockDescription
eclipse

Configures the EclipseModel added by the eclipse plugin.

Script blocks added by the findbugs plugin

BlockDescription
findbugs

Configures the FindBugsExtension added by the findbugs plugin.

Script blocks added by the idea plugin

BlockDescription
idea

Configures the IdeaModel added by the idea plugin.

Script blocks added by the jacoco plugin

BlockDescription
jacoco

Configures the JacocoPluginExtension added by the jacoco plugin.

Script blocks added by the java plugin

BlockDescription
reporting

Configures the ReportingExtension added by the java plugin.

sourceSets

Configures the source sets of this project.

Script blocks added by the jdepend plugin

BlockDescription
jdepend

Configures the JDependExtension added by the jdepend plugin.

Script blocks added by the jvm-component plugin

BlockDescription
jvm

Configures the JvmComponentExtension added by the jvm-component plugin.

Script blocks added by the pmd plugin

BlockDescription
pmd

Configures the PmdExtension added by the pmd plugin.

Script blocks added by the publishing plugin

BlockDescription
publishing

Configures the PublishingExtension added by the publishing plugin.

Script blocks added by the signing plugin

BlockDescription
signing

Configures the SigningExtension added by the signing plugin.

Script blocks added by the sonar-runner plugin

BlockDescription
sonarRunner

Configures the SonarRunnerRootExtension added by the sonar-runner plugin.

Script blocks added by the visual-studio plugin

BlockDescription
visualStudio

Configures the VisualStudioExtension added by the visual-studio plugin.

Property details

Set<Project> allprojects (read-only)

The set containing this project and its subprojects.

AntBuilder ant (read-only)

The AntBuilder for this project. You can use this in your build file to execute ant tasks. See example below.

task printChecksum {
  doLast {
    ant {
      //using ant checksum task to store the file checksum in the checksumOut ant property
      checksum(property: 'checksumOut', file: 'someFile.txt')

      //we can refer to the ant property created by checksum task:
      println "The checksum is: " + checksumOut
    }

    //we can refer to the ant property later as well:
    println "I just love to print checksums: " + ant.checksumOut
  }
}

Consider following example of ant target:

<target name='printChecksum'>
  <checksum property='checksumOut'>
    <fileset dir='.'>
      <include name='agile.txt'/>
    </fileset>
  </checksum>
  <echo>The checksum is: ${checksumOut}</echo>
</target>

Here's how it would look like in gradle. Observe how the ant XML is represented in groovy by the ant builder

task printChecksum {
  doLast {
    ant {
      checksum(property: 'checksumOut') {
        fileset(dir: '.') {
          include name: 'agile1.txt'
        }
      }
    }
    logger.lifecycle("The checksum is $ant.checksumOut")
  }
}

ArtifactHandler artifacts (read-only)

Returns a handler for assigning artifacts produced by the project to configurations.

Examples:

See docs for ArtifactHandler

File buildDir

Returns the build directory of this project. The build directory is the directory which all artifacts are generated into. The default value for the build directory is projectDir/build このプロジェクトのビルドディレクトリを返します。ビルドディレクトリは全ての生成物の生成先ディレクトリです。 ビルドディレクトリのデフォルト値はprojectDir/buildです。

File buildFile (read-only)

Returns the build file Gradle will evaluate against this project object. The default is build.gradle. If an embedded script is provided the build file will be null. Gradleがプロジェクトオブジェクトに対して評価するビルドファイルを返します。 もし埋め込むスクリプトに空っぽのビルドファイルを提供された時、デフォルトはbuild.gradleです。

ScriptHandler buildscript (read-only)

The build script handler for this project. You can use this handler to query details about the build script for this project, and manage the classpath used to compile and execute the project's build script.

Map<String, Project> childProjects (read-only)

The direct children of this project.

ConfigurationContainer configurations (read-only)

The configurations of this project.

Examples:

See docs for ConfigurationContainer

Convention convention (read-only)

The Convention for this project.

You can access this property in your build file using convention. You can also can also access the properties and methods of the convention object as if they were properties and methods of this project. See here for more details

List<String> defaultTasks

The names of the default tasks of this project. These are used when no tasks names are provided when starting the build.

DependencyHandler dependencies (read-only)

The dependency handler of this project. The returned dependency handler instance can be used for adding new dependencies. For accessing already declared dependencies, the configurations can be used.

Examples:

See docs for DependencyHandler

String description

Returns the description of this project. このプロジェクトの記述を返します。

ExtensionContainer extensions (read-only)

Allows adding DSL extensions to the project. Useful for plugin authors.

Gradle gradle (read-only)

The Gradle invocation which this project belongs to.

Object group

Returns the group of this project. Gradle always uses the toString() value of the group. The group defaults to the path with dots a separators. このプロジェクトのグループを返します。GradleはグループのtoString()の値をいつも使います。 グループはパスをドットで区切るのが標準です。

Logger logger (read-only)

The logger for this project. You can use this in your build file to write log messages.

LoggingManager logging (read-only)

The LoggingManager which can be used to control the logging level and standard output/error capture for this project's build script. By default, System.out is redirected to the Gradle logging system at the QUIET log level, and System.err is redirected at the ERROR log level.

String name (read-only)

Returns the name of this project. The project's name is not necessarily unique within a project hierarchy. You should use the Project.getPath() method for a unique identifier for the project. このプロジェクトの名前を返します。プロジェクトの階層の範囲内でプロジェクトの名前はユニークである必要はありません。 あなたはプロジェクトのユニークな識別子のためにProject.getPath()メソッドを使うべきです。

Project parent (read-only)

Returns the parent project of this project, if any. もし存在するなら、このプロジェクトの親プロジェクトを返します。

String path (read-only)

The path of this project. The path is the fully qualified name of the project.

PluginContainer plugins (read-only)

The plugins container for this project. The returned container can be used to manage the plugins which are used by this project.

Project project (read-only)

Returns this project. This method is useful in build files to explicitly access project properties and methods. For example, using project.name can express your intent better than using name. This method also allows you to access project properties from a scope where the property may be hidden, such as, for example, from a method or closure.

File projectDir (read-only)

The directory containing the project build file.

Map<String, ?> properties (read-only)

The properties of this project. See here for details of the properties which are available for a project.

RepositoryHandler repositories (read-only)

Returns a handler to create repositories which are used for retrieving dependencies and uploading artifacts produced by the project.

ResourceHandler resources (read-only)

Provides access to resource-specific utility methods, for example factory methods that create various resources.

File rootDir (read-only)

Returns the root directory of this project. The root directory is the project directory of the root project. このプロジェクトのルートディレクトリを返します。ルートディレクトリはルートプロジェクトのプロジェクトディレクトリです。

Project rootProject (read-only)

Returns the root project for the hierarchy that this project belongs to. In the case of a single-project build, this method returns this project. このプロジェクトが所属するルートプロジェクトを階層に沿って返します。シングルプロジェクトのビルドの場合は、このメソッドはそのプロジェクト自身を返します。

ProjectState state (read-only)

The evaluation state of this project. You can use this to access information about the evaluation of this project, such as whether it has failed.

Object status

The status of this project. Gradle always uses the toString() value of the status. The status defaults to release.

The status of the project is only relevant, if you upload libraries together with a module descriptor. The status specified here, will be part of this module descriptor.

Set<Project> subprojects (read-only)

The set containing the subprojects of this project.

TaskContainer tasks (read-only)

The tasks of this project.

Object version

Returns the version of this project. Gradle always uses the toString() value of the version. The version defaults to unspecified. このプロジェクトのバージョンを返します。GradleはバージョンのtoString()の値をいつも使います。 バージョンのデフォルトはunspecifiedです。

BinaryContainer binaries (read-only)

The BinaryContainer added by the LanguageBasePlugin plugin.

ComponentSpecContainer projectComponents (read-only)

The ComponentSpecContainer added by the LanguageBasePlugin plugin.

ProjectSourceSet sources (read-only)

The ProjectSourceSet added by the LanguageBasePlugin plugin.

AnnouncePluginExtension announce (read-only)

The AnnouncePluginExtension added by the announce plugin.

Iterable<String> applicationDefaultJvmArgs

Array of string arguments to pass to the JVM when running the application

CopySpec applicationDistribution

The specification of the contents of the distribution.

Use this CopySpec to include extra files/resource in the application distribution.

apply plugin: 'application'

applicationDistribution.from("some/dir") {
  include "*.txt"
}

Note that the application plugin pre configures this spec to; include the contents of "src/dist", copy the application start scripts into the "bin" directory, and copy the built jar and its dependencies into the "lib" directory.

String applicationName

The name of the application.

String mainClassName

The fully qualified name of the application's main class.

CheckstyleExtension checkstyle (read-only)

The CheckstyleExtension added by the checkstyle plugin.

CodeNarcExtension codenarc (read-only)

The CodeNarcExtension added by the codenarc plugin.

DistributionContainer distributions (read-only)

The DistributionContainer added by the distribution plugin.

String appDirName

The name of the application directory, relative to the project directory. Default is "src/main/application".

DeploymentDescriptor deploymentDescriptor

A custom deployment descriptor configuration. Default is an "application.xml" with sensible defaults.

String libDirName

The name of the library directory in the EAR file. Default is "lib".

EclipseModel eclipse (read-only)

The EclipseModel added by the eclipse plugin.

FindBugsExtension findbugs (read-only)

The FindBugsExtension added by the findbugs plugin.

IdeaModel idea (read-only)

The IdeaModel added by the idea plugin.

JacocoPluginExtension jacoco (read-only)

The JacocoPluginExtension added by the jacoco plugin.

String archivesBaseName

The base name to use for archive files.

File distsDir (read-only)

The directory to generate TAR and ZIP archives into.

String distsDirName

The name for the distributions directory. This in interpreted relative to the project' build directory.

File docsDir (read-only)

Returns a file pointing to the root directory supposed to be used for all docs.

String docsDirName

The name of the docs directory. Can be a name or a path relative to the build dir.

File libsDir (read-only)

The directory to generate JAR and WAR archives into.

String libsDirName

The name for the libs directory. This in interpreted relative to the project' build directory.

ReportingExtension reporting (read-only)

The ReportingExtension added by the java plugin.

JavaVersion sourceCompatibility

The source compatibility used for compiling Java sources.

SourceSetContainer sourceSets (read-only)

The source sets container.

JavaVersion targetCompatibility

The target compatibility used for compiling Java sources.

File testReportDir (read-only)

Returns a file pointing to the root directory to be used for reports.

String testReportDirName

The name of the test reports directory. Can be a name or a path relative to the build dir.

File testResultsDir (read-only)

Returns a file pointing to the root directory of the test results.

String testResultsDirName

The name of the test results directory. Can be a name or a path relative to the build dir.

JDependExtension jdepend (read-only)

The JDependExtension added by the jdepend plugin.

Integer httpPort

The TCP port for Jetty to listen on for incoming HTTP requests.

String stopKey

The key to use to stop Jetty.

Integer stopPort

The TCP port for Jetty to listen on for stop requests.

JvmComponentExtension jvm (read-only)

The JvmComponentExtension added by the jvm-component plugin.

Conf2ScopeMappingContainer conf2ScopeMappings

The set of rules for how to map Gradle dependencies to Maven scopes.

File mavenPomDir

The directory to generate Maven POMs into.

PmdExtension pmd (read-only)

The PmdExtension added by the pmd plugin.

File projectReportDir (read-only)

The directory to generate the project reports into.

String projectReportDirName

The name of the directory to generate the project reports into, relative to the project's reports dir.

PublishingExtension publishing (read-only)

The PublishingExtension added by the publishing plugin.

SigningExtension signing (read-only)

The SigningExtension added by the signing plugin.

SonarRunnerRootExtension sonarRunner (read-only)

The SonarRunnerRootExtension added by the sonar-runner plugin.

VisualStudioExtension visualStudio (read-only)

The VisualStudioExtension added by the visual-studio plugin.

File webAppDir (read-only)

The web application directory.

String webAppDirName

The name of the web application directory, relative to the project directory.

Method details

String absoluteProjectPath(String path)

Converts a name to an absolute project path, resolving names relative to this project.

void afterEvaluate(Closure closure)

Adds a closure to be called immediately after this project has been evaluated. The project is passed to the closure as a parameter. Such a listener gets notified when the build file belonging to this project has been executed. A parent project may for example add such a listener to its child project. Such a listener can further configure those child projects based on the state of the child projects after their build files have been run.

void afterEvaluate(Action<? super Project> action)

Adds an action to execute immediately after this project is evaluated.

void allprojects(Action<? super Project> action)

Configures this project and each of its sub-projects.

This method executes the given Action against this project and each of its sub-projects.

void apply(Closure closure)

Configures this project using plugins or scripts. The given closure is used to configure an ObjectConfigurationAction which is then used to configure this project.

void apply(Map<String, ?> options)

Configures this project using plugins or scripts. The following options are available:

  • from: A script to apply to the project. Accepts any path supported by Project.uri().
  • plugin: The id or implementation class of the plugin to apply to the project.
  • to: The target delegate object or objects. Use this to configure objects other than the project.

For more detail, see ObjectConfigurationAction.

void beforeEvaluate(Closure closure)

Adds a closure to be called immediately before this project is evaluated. The project is passed to the closure as a parameter.

void beforeEvaluate(Action<? super Project> action)

Adds an action to execute immediately before this project is evaluated.

Iterable<?> configure(Iterable<?> objects, Closure configureClosure)

Configures a collection of objects via a closure. This is equivalent to calling Project.configure() for each of the given objects.

Iterable<T> configure(Iterable<T> objects, Action<? super T> configureAction)

Configures a collection of objects via an action.

Object configure(Object object, Closure configureClosure)

Configures an object via a closure, with the closure's delegate set to the supplied object. This way you don't have to specify the context of a configuration statement multiple times.

Instead of:

MyType myType = new MyType()
myType.doThis()
myType.doThat()

you can do:

MyType myType = configure(new MyType()) {
    doThis()
    doThat()
}

The object being configured is also passed to the closure as a parameter, so you can access it explicitly if required:

configure(someObj) { obj -> obj.doThis() }

NamedDomainObjectContainer<T> container(Class<T> type)

Creates a container for managing named objects of the specified type. The specified type must have a public constructor which takes the name as a String parameter.

All objects MUST expose their name as a bean property named "name". The name must be constant for the life of the object.

NamedDomainObjectContainer<T> container(Class<T> type, Closure factoryClosure)

Creates a container for managing named objects of the specified type. The given closure is used to create object instances. The name of the instance to be created is passed as a parameter to the closure.

All objects MUST expose their name as a bean property named "name". The name must be constant for the life of the object.

Creates a container for managing named objects of the specified type. The given factory is used to create object instances.

All objects MUST expose their name as a bean property named "name". The name must be constant for the life of the object.

WorkResult copy(Closure closure)

Copies the specified files. The given closure is used to configure a CopySpec, which is then used to copy the files. Example:

copy {
   from configurations.runtime
   into 'build/deploy/lib'
}

Note that CopySpecs can be nested:

copy {
   into 'build/webroot'
   exclude '**/.svn/**'
   from('src/main/webapp') {
      include '**/*.jsp'
      filter(ReplaceTokens, tokens:[copyright:'2009', version:'2.3.1'])
   }
   from('src/main/js') {
      include '**/*.js'
   }
}

CopySpec copySpec(Closure closure)

Creates a CopySpec which can later be used to copy files or create an archive. The given closure is used to configure the CopySpec before it is returned by this method.

def baseSpec = copySpec {
   from "source"
   include "**/*.java"
}

task copy(type: Copy) {
   into "target"
   with baseSpec
}

boolean delete(Object... paths)

Deletes files and directories.

Project evaluationDependsOn(String path)

Declares that this project has an evaluation dependency on the project with the given path.

ExecResult exec(Closure closure)

Executes an external command. The closure configures a ExecSpec.

ExecResult exec(Action<? super ExecSpec> action)

Executes an external command.

The given action configures a ExecSpec, which is used to launch the process. This method blocks until the process terminates, with its result being returned.

File file(Object path)

Resolves a file path relative to the project directory of this project. This method converts the supplied path based on its type:

  • A CharSequence, including String or GString. Interpreted relative to the project directory. A string that starts with file: is treated as a file URL.
  • A File. If the file is an absolute file, it is returned as is. Otherwise, the file's path is interpreted relative to the project directory.
  • A URI or URL. The URL's path is interpreted as the file path. Currently, only file: URLs are supported.
  • A Closure. The closure's return value is resolved recursively.
  • A Callable. The callable's return value is resolved recursively.

File file(Object path, PathValidation validation)

Resolves a file path relative to the project directory of this project and validates it using the given scheme. See PathValidation for the list of possible validations.

ConfigurableFileTree fileTree(Object baseDir)

Creates a new ConfigurableFileTree using the given base directory. The given baseDir path is evaluated as per Project.file().

The returned file tree is lazy, so that it scans for files only when the contents of the file tree are queried. The file tree is also live, so that it scans for files each time the contents of the file tree are queried.

def myTree = fileTree("src")
myTree.include "**/*.java"
myTree.builtBy "someTask"

task copy(type: Copy) {
   from myTree
}

ConfigurableFileTree fileTree(Object baseDir, Closure configureClosure)

Creates a new ConfigurableFileTree using the given base directory. The given baseDir path is evaluated as per Project.file(). The closure will be used to configure the new file tree. The file tree is passed to the closure as its delegate. Example:

def myTree = fileTree('src') {
   exclude '**/.data/**'
   builtBy 'someTask'
}

task copy(type: Copy) {
   from myTree
}

The returned file tree is lazy, so that it scans for files only when the contents of the file tree are queried. The file tree is also live, so that it scans for files each time the contents of the file tree are queried.

ConfigurableFileTree fileTree(Map<String, ?> args)

Creates a new ConfigurableFileTree using the provided map of arguments. The map will be applied as properties on the new file tree. Example:

def myTree = fileTree(dir:'src', excludes:['**/ignore/**', '**/.data/**'])

task copy(type: Copy) {
    from myTree
}

The returned file tree is lazy, so that it scans for files only when the contents of the file tree are queried. The file tree is also live, so that it scans for files each time the contents of the file tree are queried.

ConfigurableFileCollection files(Object paths, Closure configureClosure)

Creates a new ConfigurableFileCollection using the given paths. The paths are evaluated as per Project.files(). The file collection is configured using the given closure. The file collection is passed to the closure as its delegate. Example:

files "$buildDir/classes" {
    builtBy 'compile'
}

The returned file collection is lazy, so that the paths are evaluated only when the contents of the file collection are queried. The file collection is also live, so that it evaluates the above each time the contents of the collection is queried.

Returns a ConfigurableFileCollection containing the given files. You can pass any of the following types to this method:

  • A CharSequence, including String or GString. Interpreted relative to the project directory, as per Project.file(). A string that starts with file: is treated as a file URL.
  • A File. Interpreted relative to the project directory, as per Project.file().
  • A URI or URL. The URL's path is interpreted as a file path. Currently, only file: URLs are supported.
  • A Collection, Iterable, or an array. May contain any of the types listed here. The elements of the collection are recursively converted to files.
  • A FileCollection. The contents of the collection are included in the returned collection.
  • A Callable. The call() method may return any of the types listed here. The return value of the call() method is recursively converted to files. A null return value is treated as an empty collection.
  • A Closure. May return any of the types listed here. The return value of the closure is recursively converted to files. A null return value is treated as an empty collection.
  • A Task. Converted to the task's output files.
  • A TaskOutputs. Converted to the output files the related task.
  • An Object. Its toString() value is treated the same way as a String, as per Project.file(). This has been deprecated and will be removed in the next version of Gradle.

The returned file collection is lazy, so that the paths are evaluated only when the contents of the file collection are queried. The file collection is also live, so that it evaluates the above each time the contents of the collection is queried.

The returned file collection maintains the iteration order of the supplied paths.

Project findProject(String path)

Locates a project by path. If the path is relative, it is interpreted relative to this project.

Map<Project, Set<Task>> getAllTasks(boolean recursive)

Returns a map of the tasks contained in this project, and optionally its subprojects.

Set<Task> getTasksByName(String name, boolean recursive)

Returns the set of tasks with the given name contained in this project, and optionally its subprojects.

boolean hasProperty(String propertyName)

Determines if this project has the given property. See here for details of the properties which are available for a project.

ExecResult javaexec(Closure closure)

Executes a Java main class. The closure configures a JavaExecSpec.

ExecResult javaexec(Action<? super JavaExecSpec> action)

Executes an external Java process.

The given action configures a JavaExecSpec, which is used to launch the process. This method blocks until the process terminates, with its result being returned.

File mkdir(Object path)

Creates a directory and returns a file pointing to it.

Project project(String path)

Locates a project by path. If the path is relative, it is interpreted relative to this project.

Project project(String path, Closure configureClosure)

Locates a project by path and configures it using the given closure. If the path is relative, it is interpreted relative to this project. The target project is passed to the closure as the closure's delegate.

Object property(String propertyName)

Returns the value of the given property. This method locates a property as follows:

  1. If this project object has a property with the given name, return the value of the property.
  2. If this project has an extension with the given name, return the extension.
  3. If this project's convention object has a property with the given name, return the value of the property.
  4. If this project has an extra property with the given name, return the value of the property.
  5. If this project has a task with the given name, return the task.
  6. Search up through this project's ancestor projects for a convention property or extra property with the given name.
  7. If not found, a MissingPropertyException is thrown.

String relativePath(Object path)

Returns the relative path from the project directory to the given path. The given path object is (logically) resolved as described for Project.file(), from which a relative path is calculated.

String relativeProjectPath(String path)

Converts a name to a project path relative to this project.

void setProperty(String name, Object value)

Sets a property of this project. This method searches for a property with the given name in the following locations, and sets the property on the first location where it finds the property.

  1. The project object itself. For example, the rootDir project property.
  2. The project's Convention object. For example, the srcRootName java plugin property.
  3. The project's extra properties.

If the property is not found, a MissingPropertyException is thrown.

void subprojects(Action<? super Project> action)

Configures the sub-projects of this project

This method executes the given Action against the sub-projects of this project.

FileTree tarTree(Object tarPath)

Creates a new FileTree which contains the contents of the given TAR file. The given tarPath path can be:

The returned file tree is lazy, so that it scans for files only when the contents of the file tree are queried. The file tree is also live, so that it scans for files each time the contents of the file tree are queried.

Unless custom implementation of resources is passed, the tar tree attempts to guess the compression based on the file extension.

You can combine this method with the Project.copy() method to untar a TAR file:

task untar(type: Copy) {
  from tarTree('someCompressedTar.gzip')

  //tar tree attempts to guess the compression based on the file extension
  //however if you must specify the compression explicitly you can:
  from tarTree(resources.gzip('someTar.ext'))

  //in case you work with unconventionally compressed tars
  //you can provide your own implementation of a ReadableResource:
  //from tarTree(yourOwnResource as ReadableResource)

  into 'dest'
}

Task task(String name)

Creates a Task with the given name and adds it to this project. Calling this method is equivalent to calling Project.task() with an empty options map.

After the task is added to the project, it is made available as a property of the project, so that you can reference the task by name in your build file. See here for more details

If a task with the given name already exists in this project, an exception is thrown.

Task task(String name, Closure configureClosure)

Creates a Task with the given name and adds it to this project. Before the task is returned, the given closure is executed to configure the task.

After the task is added to the project, it is made available as a property of the project, so that you can reference the task by name in your build file. See here for more details

Task task(Map<String, ?> args, String name)

Creates a Task with the given name and adds it to this project. A map of creation options can be passed to this method to control how the task is created. The following options are available:

OptionDescriptionDefault Value
typeThe class of the task to create.DefaultTask
overwriteReplace an existing task?false
dependsOnA task name or set of task names which this task depends on[]
actionA closure or Action to add to the task.null
descriptionA description of the task. null
groupA task group which this task belongs to. null

After the task is added to the project, it is made available as a property of the project, so that you can reference the task by name in your build file. See here for more details

If a task with the given name already exists in this project and the override option is not set to true, an exception is thrown.

Task task(Map<String, ?> args, String name, Closure configureClosure)

Creates a Task with the given name and adds it to this project. Before the task is returned, the given closure is executed to configure the task. A map of creation options can be passed to this method to control how the task is created. See Project.task() for the available options.

After the task is added to the project, it is made available as a property of the project, so that you can reference the task by name in your build file. See here for more details

If a task with the given name already exists in this project and the override option is not set to true, an exception is thrown.

URI uri(Object path)

Resolves a file path to a URI, relative to the project directory of this project. Evaluates the provided path object as described for Project.file(), with the exception that any URI scheme is supported, not just 'file:' URIs.

FileTree zipTree(Object zipPath)

Creates a new FileTree which contains the contents of the given ZIP file. The given zipPath path is evaluated as per Project.file(). You can combine this method with the Project.copy() method to unzip a ZIP file.

The returned file tree is lazy, so that it scans for files only when the contents of the file tree are queried. The file tree is also live, so that it scans for files each time the contents of the file tree are queried.

void appDirName(String appDirName)

Allows changing the application directory. Default is "src/main/application".

void libDirName(String libDirName)

Allows changing the library directory in the EAR file. Default is "lib".

Manifest manifest()

Creates a new instance of a Manifest.

Manifest manifest(Closure closure)

Creates and configures a new instance of a Manifest. The given closure configures the new manifest instance before it is returned.

MavenPom pom()

Creates a new MavenPom.

MavenPom pom(Closure configureClosure)

Creates and configures a new MavenPom. The given closure is executed to configure the new POM instance.

OsgiManifest osgiManifest()

Creates a new instance of OsgiManifest. The returned object is preconfigured with:

version: project.version
name: project.archivesBaseName
symbolicName: project.group + "." + project.archivesBaseName (see below for exceptions to this rule)

The symbolic name is usually the group + "." + archivesBaseName, with the following exceptions

  • if group has only one section (no dots) and archivesBaseName is not null then the first package name with classes is returned. eg. commons-logging:commons-logging -> org.apache.commons.logging
  • if archivesBaseName is equal to last section of group then group is returned. eg. org.gradle:gradle -> org.gradle
  • if archivesBaseName starts with last section of group that portion is removed. eg. org.gradle:gradle-core -> org.gradle.core

OsgiManifest osgiManifest(Closure closure)

Creates and configures a new instance of an OsgiManifest . The closure configures the new manifest instance before it is returned.

Script block details

allprojects { }

Configures this project and each of its sub-projects.

This method executes the given closure against this project and its sub-projects. The target Project is passed to the closure as the closure's delegate.

Delegates to:
Each Project in allprojects

ant { }

Executes the given closure against the AntBuilder for this project. You can use this in your build file to execute ant tasks. The AntBuild is passed to the closure as the closure's delegate. See example in javadoc for Project.getAnt()

Delegates to:
AntBuilder from ant

artifacts { }

Configures the published artifacts for this project.

This method executes the given closure against the ArtifactHandler for this project. The ArtifactHandler is passed to the closure as the closure's delegate.

Example:

configurations {
  //declaring new configuration that will be used to associate with artifacts
  schema
}

task schemaJar(type: Jar) {
  //some imaginary task that creates a jar artifact with the schema
}

//associating the task that produces the artifact with the configuration
artifacts {
  //configuration name and the task:
  schema schemaJar
}
Delegates to:
ArtifactHandler from artifacts

buildscript { }

Configures the build script classpath for this project.

The given closure is executed against this project's ScriptHandler. The ScriptHandler is passed to the closure as the closure's delegate.

Delegates to:
ScriptHandler from buildscript

configurations { }

Configures the dependency configurations for this project.

This method executes the given closure against the ConfigurationContainer for this project. The ConfigurationContainer is passed to the closure as the closure's delegate.

Examples:

See docs for ConfigurationContainer

dependencies { }

Configures the dependencies for this project.

This method executes the given closure against the DependencyHandler for this project. The DependencyHandler is passed to the closure as the closure's delegate.

Examples:

See docs for DependencyHandler

repositories { }

Configures the repositories for this project.

This method executes the given closure against the RepositoryHandler for this project. The RepositoryHandler is passed to the closure as the closure's delegate.

subprojects { }

Configures the sub-projects of this project.

This method executes the given closure against each of the sub-projects of this project. The target Project is passed to the closure as the closure's delegate.

Delegates to:
Each Project in subprojects

binaries { }

Configures the BinaryContainer added by the LanguageBasePlugin plugin.

Delegates to:
BinaryContainer from binaries

projectComponents { }

Configures the ComponentSpecContainer added by the LanguageBasePlugin plugin.

sources { }

Configures the ProjectSourceSet added by the LanguageBasePlugin plugin.

Delegates to:
ProjectSourceSet from sources

announce { }

Configures the AnnouncePluginExtension added by the announce plugin.

checkstyle { }

Configures the CheckstyleExtension added by the checkstyle plugin.

codenarc { }

Configures the CodeNarcExtension added by the codenarc plugin.

Delegates to:
CodeNarcExtension from codenarc

distributions { }

Configures the DistributionContainer added by the distribution plugin.

deploymentDescriptor { }

Configures the deployment descriptor for this EAR archive.

The given closure is executed to configure the deployment descriptor. The DeploymentDescriptor is passed to the closure as its delegate.

eclipse { }

Configures the EclipseModel added by the eclipse plugin.

Delegates to:
EclipseModel from eclipse

findbugs { }

Configures the FindBugsExtension added by the findbugs plugin.

Delegates to:
FindBugsExtension from findbugs

idea { }

Configures the IdeaModel added by the idea plugin.

Delegates to:
IdeaModel from idea

jacoco { }

Configures the JacocoPluginExtension added by the jacoco plugin.

Delegates to:
JacocoPluginExtension from jacoco

reporting { }

Configures the ReportingExtension added by the java plugin.

Delegates to:
ReportingExtension from reporting

sourceSets { }

Configures the source sets of this project.

The given closure is executed to configure the SourceSetContainer. The SourceSetContainer is passed to the closure as its delegate.

See the example below how SourceSet 'main' is accessed and how the SourceDirectorySet 'java' is configured to exclude some package from compilation.

apply plugin: 'java'

sourceSets {
  main {
    java {
      exclude 'some/unwanted/package/**'
    }
  }
}
Delegates to:
SourceSetContainer from sourceSets

jdepend { }

Configures the JDependExtension added by the jdepend plugin.

Delegates to:
JDependExtension from jdepend

jvm { }

Configures the JvmComponentExtension added by the jvm-component plugin.

Delegates to:
JvmComponentExtension from jvm

pmd { }

Configures the PmdExtension added by the pmd plugin.

Delegates to:
PmdExtension from pmd

publishing { }

Configures the PublishingExtension added by the publishing plugin.

signing { }

Configures the SigningExtension added by the signing plugin.

Delegates to:
SigningExtension from signing

sonarRunner { }

Configures the SonarRunnerRootExtension added by the sonar-runner plugin.

visualStudio { }

Configures the VisualStudioExtension added by the visual-studio plugin.