jni 0.15.2

jni: ^0.15.2 copied to clipboard

Breaking Change: Separated primitive arrays from object arrays. Previously, a primitive array like an array of bytes was typed JArray<jbyte>. Now JArray<T> only accepts JObjects as types and primitive arrays like arrays of bytes have their own types such as JByteArray.

This enables all arrays to implement Iterable which makes it possible to use them in a for-loop or use methods such as map on them.

Added nullable type classes for all Java objects.

Fixed a problem where interfaces implemented in Dart would crash when calling the default object methods: equals, hashCode, and toString.

Breaking Change (#981):

• JObject.reference now returns a JReference instead of Pointer<Void>.

• .fromRef constructors are now called .fromReference and they take a JReference instead of Pointer<Void>.

• JObject reflective field retrieving and method calling methods are removed. Use JClass API instead.

• The following Jni.accessors methods have been removed:

  • getClassOf
  • getMethodIDOf
  • getStaticMethodIDOf
  • getFieldIDOf
  • getStaticFieldIDOf
  • newObjectWithArgs
  • callMethodWithArgs
  • callStaticMethodWithArgs

  Instead use the JClass API.

• Jni.findJClass is replaced with JClass.forName(String name)

• JClass has been refactored. Instead of directly calling methods, getting and setting fields, use JClass.instanceMethodId, JClass.staticMethodId, JClass.constructorId, JClass.instanceFieldId, and JClass.staticFieldId to first get access to the member.

• Renamed JObject.getClass() to JObject.jClass.

• Removed Jni.deleteAllRefs.

Breaking Change (#548): Converted various Exceptions into Errors:

• UseAfterReleaseException -> UseAfterReleaseError
• DoubleReleaseException -> DoubleReleaseError
• SpawnException -> JniError (It's now a sealed class)
• JNullException -> JNullError
• InvalidCallTypeException -> InvalidCallTypeError
• HelperNotFoundException -> HelperNotFoundError
• JvmExistsException -> JniVmExistsError
• NoJvmInstanceException -> NoJvmInstanceError

Breaking Change: Removed InvalidJStringException.

Breaking Change: JType is now sealed.

Breaking Change: Primitive types and their type classes are now final.

Breaking Change: JArray.filled now uses the generated type class of the fill object and not its Java runtime type.

JObjects now check the types using instanceof in debug mode when using castTo.

Breaking Change: Jni.initDLApi() is removed.

Added the ability to share JObjects across isolates.

// This now works.
final foo = 'foo'.toJString();
Isolate.run(() {
  // `foo` is usable from another isolate.
  print(foo);
});