Go Flutter ffi使用详解

Flutter ffi（Foreign Function Interface）是一组用于在Flutter和其他平台/库/语言之间进行交互的API。Flutter ffi API允许Flutter应用程序访问和调用其他平台上运行的本机库中的功能，例如C, C++, Rust等语言编写的库。

Flutter ffi提供了许多函数和类，其中最常用的是dart:ffi库。以下是Flutter ffi的一些基本概念：

1. Dart指针（Dart Pointer）

Dart指针是一种特殊的对象，它保存了另一个对象的内存地址。Dart指针类（Pointer）是一个抽象类，它有两个子类：NativePointer和VoidPointer。NativePointer是非常常用的指针类型，它用于表示指向本地内存中的对象的指针。而VoidPointer是一个通用的指针类型，它可以指向任何类型的对象。

2. 本地函数指针（Native Function Pointer）

本地函数指针（Native Function Pointer）是一个指向本地函数的指针。它用于描述函数的签名，包括参数和返回类型。Flutter ffi API提供了NativeFunction和NativeFunctionType类来处理本地函数指针。

3. 动态库操作（Dynamic Library Operations）

Flutter ffi允许从动态库（.dll、.so等）中加载函数并调用这些函数。Flutter ffi API提供了DynamicLibrary类来处理动态库操作。

4. 小端和大端字节序（Little-endian and Big-endian Byte Orders）

在Flutter ffi中，小端字节序是指在内存中存储数据时，其最低有效字节（LSB）存储在最低的内存地址处，而最高有效字节（MSB）存储在最高的内存地址处。大端字节序则相反，最高有效字节（MSB）存储在最低的内存地址处，最低有效字节（LSB）存储在最高的内存地址处。

有了这些基本概念，我们可以使用Flutter ffi来调用其他语言编写的库，例如C, C++, Rust等。具体请看下面的代码示例：

1. 在Flutter中加载动态库

import 'dart:ffi'; // 导入ffi库
import 'dart:io'; // 导入io库

DynamicLibrary dylib = Platform.isAndroid ? DynamicLibrary.open("libmy_c_lib.so") : DynamicLibrary.process();

注意：Android平台需要传入动态库的文件名，其他平台则可以直接使用process()方法。

2. 定义本地函数指针

typedef my_c_func_type = Int32 Function(Pointer<Utf8>);
typedef MyCFuncType = int Function(Pointer<Utf8>);

该代码段定义了一个名为my_c_func_type的本地函数指针类型，并定义了一个名为MyCFuncType的类型别名，它表示了my_c_func_type的实际类型（即一个函数类型，该函数接受一个指向Utf8类型对象的指针作为参数，并返回一个Int32类型的值）。

3. 加载本地函数

// 加载名为my_c_func的本地函数
final MyCFunc = dylib.lookup<NativeFunction<my_c_func_type>>("my_c_func").asFunction<MyCFuncType>();

该代码段使用DynamicLibrary类的lookup方法从动态库中查找名为my_c_func的函数，并将其转换为本地函数指针类型MyCFuncType。

4. 调用本地函数

final Utf8 str = Utf8.toUtf8('hello world');
final result = MyCFunc(str);

该代码段定义了一个Utf8类型的对象，并将一个字符串转换为Utf8格式。然后，将指向str的指针作为参数传递给MyCFunc函数，并接受其返回值。

这就是Flutter ffi的基本使用方法。当您需要与其他语言编写的库交互时，Flutter ffi是一个非常有用的工具。