SuperAPI AI 工具集

flutter-interoperating-with-native-apis

编程与开发

查看项目

更新于 10-15 21:43

技能介绍

用途:在 Flutter 中集成平台特定代码,访问 Dart 不具备的设备特性,或复用已有原生实现。

主要能力:

  1. FFI:用 dart:ffi 直接绑定原生 C/C++ API,适合高性能原生代码或复用 C/C++ 库。自 Flutter 3.38 起推荐用 package_ffi 模板(flutter create --template=package_ffi <package_name>),通过 build.dart 钩子编译,无需 CMake、build.gradle、podspec;需要 Flutter Plugin API 或 Play Services 时用 plugin_ffi 模板。C++ 符号需加 extern "C" 与可见性属性,Apple 平台动态库文件名在各架构与 SDK 间须一致,绑定用 package:ffigen 生成并在 ffigen.yaml 配置。
  2. Platform Channel 与 Pigeon:用异步消息传递连接 Dart 与 Kotlin/Java、Swift/Objective-C、C++。复杂或高频 API 优先用 package:pigeon 生成类型安全通道,在独立 Dart 文件用 @HostApi() 定义协议。通道方法须在主线程调用;后台线程需用 makeBackgroundTaskQueue();后台 Isolate 需 BackgroundIsolateBinaryMessenger.ensureInitialized(rootIsolateToken)。
  3. Platform View:把原生 UI 嵌入 Flutter 组件树。Android 可选 Hybrid Composition(PlatformViewLink + AndroidViewSurface,保真与无障碍更好但可能降低渲染性能)或 Texture Layer(AndroidView,性能优先但快速滚动可能掉帧、SurfaceView 有问题);iOS 仅用 Hybrid Composition,实现 FlutterPlatformViewFactory 与 FlutterPlatformView,Dart 侧用 UiKitView,且 ShaderMask 与 ColorFiltered 无法作用于 iOS Platform View。
  4. Web 与 Wasm:用 flutter build web --wasm 编译;多线程需服务器返回 Cross-Origin-Embedder-Policy: credentialless(或 require-corp)与 Cross-Origin-Opener-Policy: same-origin。iOS 浏览器因 WebKit 限制暂不支持 WasmGC,Flutter 会自动回退到 JavaScript。新 Web 代码应使用 package:web 与 dart:js_interop,不要用 dart:html、dart:js、package:js;嵌入 HTML 用 HtmlElementView.fromTagName。

使用方式:按官方工作流执行,如 FFI 集成、Pigeon 类型安全通道、嵌入原生 Platform View,并运行 validator、测试与跨平台编译验证。

限制:iOS Platform View 不支持 ShaderMask 与 ColorFiltered;WasmGC 在 iOS 浏览器不可用;Texture Layer 快速滚动可能掉帧。具体收费、价格与平台支持细节资料未提供。