Describable
public interface JavaToolchainSpec extends Describable
A toolchain is a JRE/JDK used by the tasks of a build. Tasks may require one or more of the tools (javac, java, or javadoc) of a toolchain. Depending on the needs of a build, only toolchains matching specific characteristics can be used to run a build or a specific task of a build.
Even though specification properties can be configured independently, the configuration must follow certain rules in order to form a specification.
A JavaToolchainSpec
is considered valid in two cases:
language version
has been set, optionally followed by setting any other property.
In other words, if a vendor or an implementation are specified, they must be accompanied by the language version. An empty specification in most cases corresponds to the toolchain that runs the current build.
Usage of invalid instances of JavaToolchainSpec
is deprecated and will be removed in the future versions of Gradle.
Modifier and Type | Method | Description |
---|---|---|
Property<JvmImplementation> |
getImplementation() |
The virtual machine implementation of the toolchain.
|
Property<JavaLanguageVersion> |
getLanguageVersion() |
The exact version of the Java language that the toolchain is required to support.
|
Property<JvmVendorSpec> |
getVendor() |
The vendor of the toolchain.
|
getDisplayName
Property<JavaLanguageVersion> getLanguageVersion()
Property<JvmVendorSpec> getVendor()
By default, toolchains from any vendor are eligible.
Note that the vendor can only be configured if the language version
is configured as well.
Property<JvmImplementation> getImplementation()
By default, any implementation (hotspot, j9, ...) is eligible.
Note that the implementation can only be configured if the language version
is configured as well.