使用 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 作为 dev 依赖项。

$ 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.7.1 版本。页面上次更新于 2024-05-22。 查看源代码 或 报告问题。