使用 package:jnigen 的 Java 互操作

在 Android、Windows、macOS 和 Linux 上运行在 Dart Native 平台 上的 Dart 移动、命令行和服务器应用可以使用 package:jni 和 package:jnigen 调用 Java 和 Kotlin API。

package:jni 允许 Dart 代码通过 JNI 与 Java 交互。但是，这样做会涉及大量样板代码，因此您可以使用 package:jnigen 自动为给定的 Java API 生成 Dart 绑定。

您可以将 Kotlin 编译为 Java 字节码，从而允许 package:jnigen 也为 Kotlin 生成绑定。

本指南将引导您完成 一个示例，该示例使用 package:jnigen 为一个简单的类生成绑定。

• JDK
• Maven

首先，将 package:jni 作为依赖项添加，并将 package:jnigen 作为 开发依赖项 添加。

$ dart pub add jni dev:jnigen

接下来，创建一个名为 jnigen.yaml 的顶级文件。此文件包含生成绑定的配置。

output:
  dart:
    path: lib/example.dart
    structure: single_file

source_path:
  - 'java/'
classes:
  - 'dev.dart.Example'

path 指定生成 dart 绑定的路径。

source_path 指定您要为其生成绑定的 Java 源文件的路径，而 classes 指定 Java 类。

java/dev/dart/Example.java 包含一个非常简单的类，它具有一个名为 sum 的公共静态方法

package dev.dart;

public class Example {
  public static int sum(int a, int b) {
    return a + b;
  }
}

要生成 Dart 绑定，请运行 jnigen 并使用 --config 选项指定配置文件

$ dart run jnigen --config jnigen.yaml

在此示例中，这将生成 lib/example.dart，就像您在 jnigen.yaml 中指定的那样。

此文件包含一个名为 Example 的类，该类具有一个名为 sum 的静态方法，就像 Java 文件一样。

现在您已准备好加载并与生成的库进行交互。示例应用 bin/sum.dart 获取两个数字作为参数并打印它们的和。使用 Example.sum 方法与 Java 完全相同。

// a and b are integer arguments
print(Example.sum(a, b));

在运行示例之前，您必须为 jni 构建动态库。Java 源代码也必须进行编译。为此，请运行

$ dart run jni:setup
$ javac java/dev/dart/Example.java

现在您可以运行示例了

$ dart run jnigen_example:sum 17 25

输出结果为 42！

以下是一些使用 package:jnigen 的更全面的示例

除非另有说明，否则本网站上的文档反映了 Dart 3.5.3。页面上次更新于 2024-05-22。 查看源代码 或 报告问题。