api / org.gradle.tooling / BuildLauncher / run

run

abstract fun run(): Unit

Executes the build, blocking until it is complete.

Exceptions

UnsupportedVersionException - When the target Gradle version does not support build execution.

org.gradle.tooling.exceptions.UnsupportedOperationConfigurationException - When the target Gradle version does not support some requested configuration option such as #withArguments(String...).

org.gradle.tooling.exceptions.UnsupportedBuildArgumentException - When there is a problem with build arguments provided by #withArguments(String...).

BuildException - On some failure executing the Gradle build.

BuildCancelledException - When the operation was cancelled before it completed successfully.

GradleConnectionException - On some other failure using the connection.

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

Since
1.0-milestone-3

abstract fun run(handler: ResultHandler<in Void>): Unit

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

If the operation fails, the handler's ResultHandler#onFailure(GradleConnectionException) method is called with the appropriate exception. See #run() for a description of the various exceptions that the operation may fail with.

Parameters

handler - The handler to supply the result to.

Exceptions

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

Since
1.0-milestone-3