Downloading by version

The DSL extension offers a download method to configure a JavaLanguageVersion. The plugin infers the matching Jextract version from that defined Java version. It downloads and installs Jextract from the official release page for the current build platform.

Use Java toolchain (highly recommended)

By convention, the plugin tries to get the Java version from the configured Java toolchain. This is by far the most convenient and reliable method for most projects.

modern JDK

Your target JVM should be of version 19 or above.

Kotlin

build.gradle.kts

java {
    toolchain {
        languageVersion = JavaLanguageVersion.of(24)
    }
}

Groovy

build.gradle

java {
    toolchain {
        languageVersion = JavaLanguageVersion.of 24
    }
}

Note

This will choose Jextract 22, because this is still the latest release.

Use another version

Setting an explicit version in the DSL will override the convention, and the Java toolchain will be ignored. This might make sense if no Java plugin is used in the build, or if the version should diverge from the target JVM.

Compatibility

Please ensure that Jextract and the JVM target of your code are compatible. The major version of Jextract shouldn’t be higher than that of the target JVM version.

Kotlin

build.gradle.kts

jextract.download(JavaLanguageVersion.of(21))

Groovy

build.gradle

jextract.download(JavaLanguageVersion.of(21))