org.gradle.tooling
Interface BuildLauncher

public interface BuildLauncher

A BuildLauncher allows you to configure and execute a Gradle build.

You use a BuildLauncher as follows:

• Create an instance of BuildLauncher by calling ProjectConnection.newBuild().
• Configure the launcher as appropriate.
• Call either run() or run(ResultHandler) to execute the build.
• Optionally, you can reuse the launcher to launcher additional builds.

Instances of BuildLauncher are not thread-safe.

forTasks

BuildLauncher forTasks(String... tasks)

Sets the tasks to be executed.

Parameters:

tasks - The paths of the tasks to be executed. Relative paths are evaluated relative to the project for which this launcher was created.

Returns:

this

forTasks

BuildLauncher forTasks(Task... tasks)

Sets the tasks to be executed. Note that the supplied tasks do not necessarily belong to the project which this launcher was created for.

Parameters:

tasks - The tasks to be executed.

Returns:

this

forTasks

BuildLauncher forTasks(Iterable<? extends Task> tasks)

Sets the tasks to be executed. Note that the supplied tasks do not necessarily belong to the project which this launcher was created for.

Parameters:

tasks - The tasks to be executed.

Returns:

this

setStandardOutput

BuildLauncher setStandardOutput(OutputStream outputStream)

Sets the OutputStream that should receive standard output logging from this build. The default is to discard the output.

Parameters:

outputStream - The output stream.

Returns:

this

setStandardError

BuildLauncher setStandardError(OutputStream outputStream)

Sets the OutputStream that should receive standard error logging from this build. The default is to discard the output.

Parameters:

outputStream - The output stream.

Returns:

this

addProgressListener

BuildLauncher addProgressListener(ProgressListener listener)

Adds a progress listener which will receive progress events as the build executes.

Parameters:

listener - The listener

Returns:

this

run

void run()
         throws GradleConnectionException

Execute the build, blocking until it is complete.

Throws:

UnsupportedVersionException - When the target Gradle version does not support the features required for this build.

BuildException - On some failure executing the Gradle build.

GradleConnectionException - On some other failure using the connection.

IllegalStateException - When the connection has been closed or is closing.

run

void run(ResultHandler<? super Void> handler)
         throws IllegalStateException

Launchers the build. This method returns immediately, and the result is later passed to the given handler.

Parameters:

handler - The handler to supply the result to.

Throws:

IllegalStateException - When the connection has been closed or is closing.