jni-sys

What's Changed

• Update to syn 2.0 by @rukai in #36
• Update Readme by @atouchet in #39
• Use SPDX license format by @atouchet in #40
• Add GetStringUTFLengthAsLong by @r3bb1t in #42
• Bump rust-version to 1.76 for trybuild dev dependency by @rib in #44
• Fix jni_env_union test by @rib in #45
• Systest build fix for darwin/linux by @rib in #46
• Add JNI_VERSION_24 by @rib in #47
• Release jni-sys-macros 0.4.1 by @rib in #48
• Release 0.4.1 by @rib in #37

New Contributors

• @rukai made their first contribution in #36
• @atouchet made their first contribution in #39
• @r3bb1t made their first contribution in #42

Full Changelog: v0.4.0...v0.4.1

Added

• Added JNI_VERSION_24 constant (#47)
• Added GetStringUTFLengthAsLong to JNINativeInterface (#42)

Changed

• Bumped syn crate dependency to 2 (for jni-sys-macros) (#36)

It's alive! 😃

It's been about 6 years since the last release and although that's generally been OK, since the JNI API doesn't change that frequently, there have been a number of paper cuts adding up that this release hopefully helps to address.

Thanks to @sfackler for transferring the repo to the https://github.com/jni-rs Github organisation where we can hopefully keep the flame alive.

The most notable changes are that jboolean is now an alias for bool and that JNINativeInterface_ is now a union that namespaces the functions based on the JNI version when each function was added to the spec. Please see below for more details.

Added

• Added JNI_VERSION_9, JNI_VERSION_10, JNI_VERSION_19, JNI_VERSION_20 and JNI_VERSION_21 constants
• Added GetModule() to JNINativeInterface (#22)
• IsVirtualThread() to JNINativeInterface (#32)
• Implemented Debug trait for all types (#31)
• Added support for no_std environments (#12)

Changed

• jboolean is now an alias for bool instead of u8 (#23)

• The JNIInvokeInterface_ and JNINativeInterface_ structs were turned into unions that namespace functions by version (#28):

  This makes it much clearer what version of JNI you require to access any function safely.

  So instead of a struct like:

  struct JNINativeInterface_ {
      pub reserved0: *mut c_void,
      ..
      pub GetVersion: unsafe extern "system" fn(env: *mut JNIEnv) -> jint,
      ..
      pub NewLocalRef: unsafe extern "system" fn(env: *mut JNIEnv, ref_: jobject) -> jobject,
  }

  there is now a union like:

  union JNINativeInterface_ {
      v1_1: JNINativeInterface__1_1,
      v1_2: JNINativeInterface__1_2,
      reserved: JNINativeInterface__reserved,
  }

  And you can access GetVersion like: env.v1_1.GetVersion and access NewLocalRef like: env.v1_2.NewLocalRef.

  Each version struct includes all functions for that version and lower, so it's also possible to access GetVersion like env.v1_2.GetVersion.

• Function pointers are no longer wrapped in an Option<> (#25)

New Contributors

• @marschall made their first contribution in #9
• @CertainLach made their first contribution in #12
• @morristai made their first contribution in #15

Full Changelog: v0.3.0...v0.4.0

Added

• Added JNI_VERSION_9, JNI_VERSION_10, JNI_VERSION_19, JNI_VERSION_20 and JNI_VERSION_21 constants
• Added GetModule() to JNINativeInterface (#22)
• IsVirtualThread() to JNINativeInterface (#32)
• Implemented Debug trait for all types (#31)
• Added support for no_std environments (#12)

Changed

• jboolean is now an alias for bool instead of u8 (#23)

• The JNIInvokeInterface_ and JNINativeInterface_ structs were turned into unions that namespace functions by version (#28):

  This makes it much clearer what version of JNI you require to access any function safely.

  So instead of a struct like:

  struct JNINativeInterface_ {
      pub reserved0: *mut c_void,
      ..
      pub GetVersion: unsafe extern "system" fn(env: *mut JNIEnv) -> jint,
      ..
      pub NewLocalRef: unsafe extern "system" fn(env: *mut JNIEnv, ref_: jobject) -> jobject,
  }
  

  there is now a union like:

  union JNINativeInterface_ {
      v1_1: JNINativeInterface__1_1,
      v1_2: JNINativeInterface__1_2,
      reserved: JNINativeInterface__reserved,
  }
  

  And you can access GetVersion like: env.v1_1.GetVersion and access NewLocalRef like: env.v1_2.NewLocalRef.

  Each version struct includes all functions for that version and lower, so it's also possible to access GetVersion like env.v1_2.GetVersion.

• Function pointers are no longer wrapped in an Option<> (#25)

This release applies the semver trick to re-export compatible types from jni-sys 0.4 (namely jobject) to make it easier for jobject references to be passed around between APIs depending on different versions of jni-sys

The MSRV was bumped to 1.77

What's Changed

Added

• GetModule was added to JNINativeInterface (#22)
• JNI_VERSION_{9,10,19,20,21,24} version definitions were added

Changed

• Compatible types are now re-exported from jni-sys 0.4 to make it easier for jobject references
  to be passed around between APIs depending on different versions of jni-sys

Full Changelog: v0.3.0...v0.3.1

• jvalue is now properly a union.
• Default impls have been removed from structs.

Changed

• Changed jvalue into a union

• Make jvalue's field public again to fix back compat break.

• Add JNI_GetDefaultJavaVMInitArgs and JNI_GetCreatedJavaVMs.

• Fix calling convention on 32 bit Windows.

• Add JNI_CreateJavaVM

• Fix regression in FatalError signature