FFi

MacOS 12.0

CMake:: cmake version 3.21.2

Make: GNU Make 3.81

Dart: Dart SDK version: 2.15.0÷÷

FFI （Foreign Function Interface）表示 外部功能接口，类似 JAVA 的 JNI。项目升级到 Flutter 2.0 之后，我们就可以使用 dart:ffi 库来调用 C 语言编写的代码。 　

在 Flutter 2.0 中的 Dart 2.12 已发布，其中包含健全的空安全和 Dart FFI 的稳定版, 并且提供了一套类型绑定生成工具 ffigen，可以自动生成 Dart Wrapper 加快开发效率。

如何将用 C/C++ 编写的代码带入到 Flutter 应用中

关于Dart语言FFI使用 ，大概步骤

1. 导入ffi包
2. 为被调用的c函数创建Dart Native签名
3. 为被调用c函数创建Dart函数
4. 加载动态库
5. 查找c函数，并将c函数指针映射dart函数对象
6. 调用函数

解决的问题

1. 可以同步调用C API，不像Flutter Channel一开始就是异步
2. 调用C语言更快，不像之前需要通过Native中转（或者改Flutter引擎代码）

方式

Flutter->原生JNI->C

Flutter->FFI->C

原始FFI

将已有的 c/cpp 通过交叉编译各个平台，windows的dll，unix系统的so库，然后通过DynamicLibrary的open函数去打开这个库，来获得其中函数的动态链接。随即按套路编写dart调用ffi的代码即可。

ffgen

每个平台都有一些已经有的so库，如果我们的 c/cpp 语言实现的都是一些所有unix设备或者windows设备底层自带so、dll中的函数，我们不妨将里面每一个函数都转换成dart端可以对应调用的函数，也就是生成一个dart可用的 ".h" 头，当然这个扩展名还是 ".dart" 。

这样一来，我们无需再为了 windows、macos、linux、android、ios 这5个平台分别交叉编译一份动态库，我们只需要写一份通用的dart代码即可。

Mac电脑确保安装llvm

添加依赖pubspec.yaml

添加c文件 ios/Runner/native.cpp ios/Runner/native.h

使用ffigen生成dart代码 - 终端执行

Dart Use

常用属性与方法介绍

Dart与C语言，Dart FFI提供了很多方法

import 'package:ffi'

DynamicLibrary.open

它可以加载动态链接库

DynamicLibrary.process

它可以用于在iOS及MacOS中加载应用程序已经自动加载好的动态链接库，也可以解析静态链接到应用的二进制文件符号。需要注意的是，它不能用于windows平台

DynamicLibrary.executable

它可用于加载静态链接库

NativeType

NativeType是在Dart中表示C语言中的数据结构

Pointer

它是C语言中指针在Dart中的映射

DynamicLibrary->lookup()

它用于在DynamicLibrary中查找到对应的符号并返回其内存地址。

Pointer.fromAddress(int ptr)

根据内存地址获取C对象指针

Pointer.fromFunction

根据一个Dart函数，创建一个Native函数指针，一般用于将Dart函数传给C，使C有调用Dart函数的能力

Pointer->address()

获取指针的内存地址

asFunction

将Native指针对象，转换为Dart函数

sizeOf

返回具体类型的内存占用

例

malloc.allocate()

开辟一块大小byteCount的空间

例

malloc.free

释放内存

Dart FFI与C基础数据类型映射表

Dart Call C

如何找到 C++ 中的库

通过 DynamicLibrary.open() dlopen 加载动态链接库，并返回句柄。

ffigen

ffigen库来根据C/C++头文件自动生成dart 函数

注意

ffigen只能自动生成C风格的头文件，如果你的头文件中包含了C++风格代码如class，需要使用#ifdef __cplusplus #endif包裹起来

参考

用到的工具库

• ffi
• ffigen: https://pub.dev/packages/ffigen

文档

https://dart.cn/guides/libraries/c-interop

https://api.dart.cn/stable/2.15.1/dart-ffi/dart-ffi-library.html

• Blog https://juejin.cn/user/465848661186141

FFi

MacOS 12.0

CMake:: cmake version 3.21.2

Make: GNU Make 3.81

Dart: Dart SDK version: 2.15.0÷÷

FFI （Foreign Function Interface）表示 外部功能接口，类似 JAVA 的 JNI。项目升级到 Flutter 2.0 之后，我们就可以使用 dart:ffi 库来调用 C 语言编写的代码。 　

在 Flutter 2.0 中的 Dart 2.12 已发布，其中包含健全的空安全和 Dart FFI 的稳定版, 并且提供了一套类型绑定生成工具 ffigen，可以自动生成 Dart Wrapper 加快开发效率。

如何将用 C/C++ 编写的代码带入到 Flutter 应用中

关于Dart语言FFI使用 ，大概步骤

1. 导入ffi包
2. 为被调用的c函数创建Dart Native签名
3. 为被调用c函数创建Dart函数
4. 加载动态库
5. 查找c函数，并将c函数指针映射dart函数对象
6. 调用函数

解决的问题

1. 可以同步调用C API，不像Flutter Channel一开始就是异步
2. 调用C语言更快，不像之前需要通过Native中转（或者改Flutter引擎代码）

方式

Flutter->原生JNI->C

Flutter->FFI->C

原始FFI

将已有的 c/cpp 通过交叉编译各个平台，windows的dll，unix系统的so库，然后通过DynamicLibrary的open函数去打开这个库，来获得其中函数的动态链接。随即按套路编写dart调用ffi的代码即可。

ffgen

每个平台都有一些已经有的so库，如果我们的 c/cpp 语言实现的都是一些所有unix设备或者windows设备底层自带so、dll中的函数，我们不妨将里面每一个函数都转换成dart端可以对应调用的函数，也就是生成一个dart可用的 ".h" 头，当然这个扩展名还是 ".dart" 。

这样一来，我们无需再为了 windows、macos、linux、android、ios 这5个平台分别交叉编译一份动态库，我们只需要写一份通用的dart代码即可。

Mac电脑确保安装llvm

添加依赖pubspec.yaml

添加c文件 ios/Runner/native.cpp ios/Runner/native.h

使用ffigen生成dart代码 - 终端执行

Dart Use

常用属性与方法介绍

Dart与C语言，Dart FFI提供了很多方法

import 'package:ffi'

DynamicLibrary.open

它可以加载动态链接库

DynamicLibrary.process

它可以用于在iOS及MacOS中加载应用程序已经自动加载好的动态链接库，也可以解析静态链接到应用的二进制文件符号。需要注意的是，它不能用于windows平台

DynamicLibrary.executable

它可用于加载静态链接库

NativeType

NativeType是在Dart中表示C语言中的数据结构

Pointer

它是C语言中指针在Dart中的映射

DynamicLibrary->lookup()

它用于在DynamicLibrary中查找到对应的符号并返回其内存地址。

Pointer.fromAddress(int ptr)

根据内存地址获取C对象指针

Pointer.fromFunction

根据一个Dart函数，创建一个Native函数指针，一般用于将Dart函数传给C，使C有调用Dart函数的能力

Pointer->address()

获取指针的内存地址

asFunction

将Native指针对象，转换为Dart函数

sizeOf

返回具体类型的内存占用

例

malloc.allocate()

开辟一块大小byteCount的空间

例

malloc.free

释放内存

Dart FFI与C基础数据类型映射表

Dart Call C

如何找到 C++ 中的库

通过 DynamicLibrary.open() dlopen 加载动态链接库，并返回句柄。

ffigen

ffigen库来根据C/C++头文件自动生成dart 函数

注意

ffigen只能自动生成C风格的头文件，如果你的头文件中包含了C++风格代码如class，需要使用#ifdef __cplusplus #endif包裹起来

参考

用到的工具库

• ffi
• ffigen: https://pub.dev/packages/ffigen

文档

https://dart.cn/guides/libraries/c-interop

https://api.dart.cn/stable/2.15.1/dart-ffi/dart-ffi-library.html

• Blog https://juejin.cn/user/465848661186141