This is a Gradle plugin for integrating Project Panama's jextract tool in the build process. There is also a full demo project showcasing the gradle-jextract plugin.

:bulb:   Example

Since the plugin is available on Gradle's Plugin Portal it can be applied within the build script's plugins block.

plugins {
  id "io.github.krakowski.jextract" version "0.5.0"
}

Applying the plugin adds the jextract task which can be configured by the build script.

jextract {

    header("${project.projectDir}/src/main/c/stdio.h") {
        // The library name
        libraries = [ 'stdc++' ]

        // The package under which all source files will be generated
        targetPackage = 'org.unix'

        // The generated class name
        className = 'Linux'
    }
}

If the Gradle Java Plugin or Application plugin is applied, the gradle-jextract plugin configures them and uses the configured toolchain for its task, which can be set as follows.

java {
    toolchain {
        languageVersion.set(JavaLanguageVersion.of(22))
    }
}

If your JDK is not installed in one of the default locations, Gradle can be instructed to search in a custom location. To enable this feature the org.gradle.java.installations.paths property has to be set within your global gradle.properties file usually located inside ${HOME}/.gradle.

org.gradle.java.installations.paths=/custom/path/jdk22

The plugin will first try to find jextract inside PATH and then fall back to ${JAVA_HOME}/bin.

:triangular_ruler:   Configuration Options

The jextract task exposes the following configuration options.

:green_book:   Notes

¹ libraries option can use simple library name "stdc++" or full path to the shared libraries. Full path need to be prefixed with ":" character. For example ":/usr/lib/libstdc++.so" doc

:wrench:   Requirements

• OpenJDK 22
• Project Jextract

:scroll:   License

This project is licensed under the GNU GPLv3 License - see the LICENSE file for details.