Flutter 主要使用 Dart 语言，也就是说我们只要掌握了 Dart 语言调用 C/C++ 的方法，就知道了如何在 Flutter 中调用 C/C++ 编写的功能了。

\n

Dart 的移动端、命令行和服务端应用所运行的 Dart 原生平台，均可以使用 dart:ffi 库调用原生的 C 语言 API，用于读、写、分配和销毁原生内存。 FFI（Foreign Function Interface）指的是外部函数接口。

\n

一、dart:ffi

\n

用于与 C 编程语言互操作的外部函数接口。

\n

1.1 Class

\n

Abi 应用程序二进制接口 (ABI)。

\n

AbiSpecificInteger 所有 Abi-specific 整数类型的 supertype（超类型）。

\n

AbiSpecificIntegerMapping 映射 AbiSpecificInteger 的 subtype（子类型）。

\n

Allocator 管理 native 堆上的内存。

\n

NativeType NativeType 的子类型表示 C 中的 native 类型。

\n

Array<T extends NativeType> 固定大小的数组 T。

\n

Dart_CObject 不透明，不暴露其成员。

\n

DartRepresentationOf 表示与 NativeType 对应的 Dart 类型。

\n

DefaultAsset 指定当前库的默认 asset ID 的注解。

\n

DynamicLibrary 动态加载的 native 库。

\n

Finalizable 标记不应过早销毁对象的接口。

\n

Handle 代表 Dart_Handle 来自 C 的 dart_api.h。

\n

Native<T> 将外部声明绑定到其 native 实现的注解。

\n

NativeApi 用于从 Dart 代码或通过 C 代码（使用 dart_api_dl.h）访问 Dart VM API。

\n

NativeCallable<T extends Function> 一个 native 可调用对象，用于监听对 native 函数的调用。

\n

NativeFinalizer 可以附着到 Dart 对象的 native finalizer。

\n

NativeFunction<T extends Function> 表示 C 中的函数类型。

\n

Opaque Opaque 的 subtype 表示 C 中的不透明类型。

\n

Packed 用于在 Struct subtype 上指定注解，以表明其成员需要进行打包。

\n

Pointer<T extends NativeType> 表示指向 native C 内存的指针，无法扩展。

\n

SizedNativeType 具有已知大小的 NativeType 。

\n

Struct 所有 FFI 结构体类型的 supertype。

\n

Union 所有 FFI 联合体类型的 supertype。

\n

VarArgs<T extends Record> C 中传递的可变参数的类型。

\n

Bool 表示 C 中的 native 布尔值。

\n

Char 表示 C 中的 native char 型。

\n

Double 表示 C 中的 native 64 位双精度浮点数。

\n

Float 表示 C 中的 native 32 位单精度浮点数。

\n

Int 表示 C 中的 native int 型。

\n

Int8 表示 C 中的 native 有符号 8 位整数。

\n

Int16 表示 C 中的 native 有符号 16 位整数。

\n

Int32 表示 C 中的 native 有符号 32 位整数。

\n

Int64 表示 C 中的 native 有符号 64 位整数。

\n

Uint8 表示 C 中的 native 无符号 8 位整数。

\n

Uint16 表示 C 中的 native 无符号 16 位整数。

\n

Uint32 表示 C 中的 native 无符号 32 位整数。

\n

Uint64 表示 C 中的 native 无符号 64 位整数。

\n

UintPtr 表示 C 中的 native uintptr_t 型（指针）。

\n

IntPtr 表示 C 中的 native intptr_t 型（指针）。

\n

Long 表示 C 中的 native long int 型，又称 long 类型。

\n

LongLong 表示 C 中的 native long long 类型。

\n

Short 表示 C 中的 native short 型。

\n

SignedChar 表示 C 中的 native signed char 型。

\n

Size 表示 C 中的 native size_t 型。

\n

Void 表示 C 中的 native void 类型。

\n

WChar 表示 C 中的 native wchar_t 类型。

\n

UnsignedChar 表示 C 中的 native unsigned char 类型。

\n

UnsignedShort 表示 C 中的 native unsigned short 类型。

\n

UnsignedInt 表示 C 中的 native unsigned int 类型。

\n

UnsignedLong 表示 C 中的 native unsigned long int 类型，又称 unsigned long 类型。

\n

UnsignedLongLong 表示 C 中的 native unsigned long long 类型。

\n

1.2 Extension

\n

AbiSpecificIntegerArray on Array<T> 对 AbiSpecificInteger 数组（Array）的索引方法进行边界检查。

\n

AbiSpecificIntegerPointer on Pointer<T> 针对类型参数 AbiSpecificInteger 的指针（Pointer）扩展。

\n

AllocatorAlloc on Allocator 扩展 Allocator 以提供 NativeType 的分配。

\n

ArrayAddress on Array<T> 为 Array<T> 添加通过 address property 获取底层数据的内存地址的扩展。

\n

ArrayArray on Array<Array<T>> 对数组（Array）的数组（Array）进行索引方法的边界检查。

\n

BoolAddress on bool 为 bool 添加通过 address property 获取底层数据的内存地址的扩展。

\n

BoolArray on Array<Bool> Bool 数组（Array）的边界检查索引方法。

\n

BoolPointer on Pointer<Bool> 针对类型参数 Bool 的指针（Pointer）扩展。

\n

DoubleAddress on double 为 double 添加通过 address property 获取底层数据的内存地址的扩展。

\n

DoubleArray on Array<Double> Double 数组（Array）的边界检查索引方法。

\n

DoublePointer on Pointer<Double> 针对类型参数 Double 的指针（Pointer）扩展。

\n

DynamicLibraryExtension on DynamicLibrary 不能动态调用的方法。

\n

Float32ListAddress on Float32List 为 Float32List 添加通过 address property 获取底层数据的内存地址的扩展。

\n

Float64ListAddress on Float64List 为 Float64List 添加通过 address property 获取底层数据的内存地址的扩展。

\n

Int8ListAddress on Int8List 为 Int8List 添加通过 address property 获取底层数据的内存地址的扩展。

\n

Int16ListAddress on Int16List 为 Int16List 添加通过 address property 获取底层数据的内存地址的扩展。

\n

Int32ListAddress on Int32List 为 Int32List 添加通过 address property 获取底层数据的内存地址的扩展。

\n

Int64ListAddress on Int64List 为 Int64List 添加通过 address property 获取底层数据的内存地址的扩展。

\n

FloatArray on Array<Float> Float 数组（Array）的边界检查索引方法。

\n

FloatPointer on Pointer<Float> 针对类型参数 Float 的指针（Pointer）扩展。

\n

Int8Array on Array<Int8> Int8 数组（Array）的边界检查索引方法。

\n

Int16Array on Array<Int16> Int16 数组（Array）的边界检查索引方法。

\n

Int32Array on Array<Int32> Int32 数组（Array）的边界检查索引方法。

\n

Int32Array on Array<Int64> Int64 数组（Array）的边界检查索引方法。

\n

IntAddress on int 为 int 添加通过 address property 获取底层数据的内存地址的扩展。

\n

Int8Pointer on Pointer<Int8> 针对类型参数 Int8 的指针（Pointer）扩展。

\n

Int16Pointer on Pointer<Int16> 针对类型参数 Int16 的指针（Pointer）扩展。

\n

Int32Pointer on Pointer<Int32> 针对类型参数 Int32 的指针（Pointer）扩展。

\n

Int64Pointer on Pointer<Int64> 针对类型参数 Int64 的指针（Pointer）扩展。

\n

NativeFunctionPointer on Pointer<NativeFunction<NF>> 针对类型参数 NativeFunction 的指针（Pointer）扩展。

\n

NativePort on SendPort Dart_Port 从 SendPort 检索 native 的扩展。

\n

PointerArray on Array<Pointer<T>> Pointer 数组（Array）的边界检查索引方法。

\n

PointerPointer on Pointer<Pointer<T>> 针对类型参数 Pointer 的指针（Pointer）扩展。

\n

Uint8Array on Array Uint8 数组（Array）的边界检查索引方法。

\n

Uint16Array on Array Uint16 数组（Array）的边界检查索引方法。

\n

Uint32Array on Array Uint32 数组（Array）的边界检查索引方法。

\n

Uint64Array on Array Uint64 数组（Array）的边界检查索引方法。

\n

Uint8Pointer on Pointer 针对类型参数 Int8 的指针（Pointer）扩展。

\n

Uint16Pointer on Pointer 针对类型参数 Int16 的指针（Pointer）扩展。

\n

Uint32Pointer on Pointer 针对类型参数 Int32 的指针（Pointer）扩展。

\n

Uint64Pointer on Pointer 针对类型参数 Int64 的指针（Pointer）扩展。

\n

Uint8ListAddress on Uint8List 为 Uint8List 添加通过 address property 获取底层数据的内存地址的扩展。

\n

Uint16ListAddress on Uint16List 为 Uint16List 添加通过 address property 获取底层数据的内存地址的扩展。

\n

Uint32ListAddress on Uint32List 为 Uint32List 添加通过 address property 获取底层数据的内存地址的扩展。

\n

Uint64ListAddress on Uint64List 为 Uint64List 添加通过 address property 获取底层数据的内存地址的扩展。

\n

StructAddress on T 为 T(T extends Struct) 添加通过 address property 获取底层数据的内存地址的扩展。

\n

StructArray on Array<T> Struct 数组（Array）的边界检查索引方法。

\n

StructPointer on Pointer<T> 针对类型参数 Struct 的指针（Pointer）扩展。

\n

UnionAddress on T T(T extends Union) 添加通过 address property 获取底层数据的内存地址的扩展。

\n

UnionArray on Array Union 联合体（Array）的边界检查索引方法。

\n

UnionPointer on Pointer 针对类型参数 Union 的指针（Pointer）扩展。

\n

1.3 Property

\n

nullptr → Pointer 表示指向 C 语言 native 内存中对应于“NULL”的指针，例如地址为 0 的指针。

\n

1.4 Function

\n

sizeOf() → int 由 native 类型 T 占用的字节数。

\n

1.5 Typedef

\n

Dart_NativeMessageHandler = Void Function(Int64, Pointer<Dart_CObject>) Dart 和 native 之间通信的一个关键组件，主要用于处理 Dart 和 native 之间的消息传递。\nNativeFinalizerFunction = NativeFunction<Void Function(Pointer token)> NativeFinalizer 的 native 函数类型。

\n

二、常见用法

\n

接下来先通过一个 Hello World 开始学习 FFI 如何使用，接下来会继续介绍函数入参中使用指针、函数返回值返回指针、结构体和回调函数四种使用场景。

\n

2.1 Hello World

\n

导入 dart:ffi

\n