调用 Jetpack API

Flutter 应用在 Android 上运行时，始终可以第一时间使用 Android 发布的最新 API，无论何时。本页概述了调用 Android 特定 API 的可用方法。

在大多数情况下，您可以使用插件（如下一节所示）来调用原生 API，而无需自己编写任何自定义样板或粘合代码。

无论 Flutter 应用在哪里运行，使用插件通常是访问原生 API 的最简单方法。要使用插件，请访问 pub.dev 并搜索您需要的主题。大多数原生功能，包括访问 GPS、相机或计步器等常用硬件，都由强大的插件支持。

有关将插件添加到 Flutter 应用的完整指南，请参阅 使用插件文档。

并非所有原生功能都受插件支持，尤其是在其发布后立即。在任何您所需的原生功能未被 pub.dev 上的插件涵盖的情况下，请继续阅读以下部分。

并非所有场景和 API 都受现有解决方案支持；但幸运的是，您始终可以添加所需的任何支持。以下部分介绍了从 Dart 调用原生代码的两种不同方法。

调用原生 API 最直接、最高效的方法是通过 FFI 直接调用 API。这会将您的 Dart 可执行文件链接到编译时指定的任何原生代码，允许您通过少量粘合代码从 UI 线程直接调用它。在大多数情况下，ffigen 或 jnigen 有助于编写此粘合代码。

有关从 Flutter 应用直接调用原生代码的完整指南，请参阅 FFI 文档。

在未来几个月内，Dart 团队希望通过直接支持使用 FFI 方法调用原生 API 来简化此过程，但无需开发人员编写任何粘合代码。

MethodChannel 是 Flutter 应用调用任意原生代码的另一种方法。与上一步骤中描述的 FFI 解决方案不同，MethodChannel 始终是异步的，这对于您而言可能重要也可能不重要，具体取决于您的用例。与 FFI 和对原生代码的直接调用一样，使用 MethodChannel 需要少量粘合代码将您的 Dart 对象转换为原生对象，然后再转换回来。在大多数情况下，pkg:pigeon 有助于编写此粘合代码。

有关将 MethodChannel 添加到 Flutter 应用的完整指南，请参阅 MethodChannel 文档。

除非另有说明，否则本网站上的文档反映了 Flutter 的最新稳定版本。页面上次更新于 2024-11-08。 查看源代码 或 报告问题。