Skip to content

Static JNI Feature (Part 1) #4

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
wants to merge 32 commits into from
Closed

Conversation

sgammon
Copy link
Member

@sgammon sgammon commented Jun 10, 2024

Testing CI against new static JNI logic. Joining #1 after testing and cleanup.

sgammon and others added 28 commits June 8, 2024 19:33
Adds a JAR publication at `jna-graalvm.jar`, with accompanying
build infrastructure, which provides support for JNA within the
context of the Substrate Virtual Machine (SVM).

GraalVM Native Image targets use SVM instead of JVM at runtime.
JNA's current strategy of unpacking libraries at runtime works
under SVM, but is suboptimal; the binary is native, so it can
simply include JNA object code for the current platform directly.

To accomplish this, several GraalVM "feature" implementations are
provided in this new publication. By default, regular JNA access
is enabled through the `JavaNativeAccess` feature; this class
enables reflection and runtime JNI configurations for downstream
projects which use JNA.

Another feature, `SubstrateStaticJNA`, is experimental because it
relies on unstable GraalVM APIs, but instead of loading JNA at
runtime from a dynamic library, it builds JNA into the final
native image with a static object.

These features are enabled through a resource within `META-INF`,
called `native-image.properties`, which is picked up by the native
image compiler at build time. The new artifact only needs to be
present for GraalVM native targets at build time; otherwise, the
classes and libraries in `jna-graalvm.jar` are inert.

Includes tested support for:
- macOS aarch64
- Linux amd64

Signed-off-by: Sam Gammon <[email protected]>
Signed-off-by: GitHub <[email protected]>
Adds a subtype reachability handler for `com.sun.jna.Library`, so that
user types which extend `Library` are automatically registered as
runtime-capable proxy types

Signed-off-by: GitHub <[email protected]>
@sgammon sgammon self-assigned this Jun 10, 2024
@sgammon sgammon added 🛑 blocked Waiting on other work / PRs ✋ embargoed Waiting for further action enhancement New feature or request labels Jun 10, 2024
@sgammon sgammon force-pushed the unstable branch 2 times, most recently from d79c217 to 2489b8b Compare June 10, 2024 05:02
@sgammon sgammon closed this Jun 13, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
🛑 blocked Waiting on other work / PRs ✋ embargoed Waiting for further action enhancement New feature or request
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants