在Flutter项目使用FFI调用Golang项目全记录

文章目录

前言

目前有一个项目涉及到html的解析, js执行等. 由于dart的库并不是很完善, 于是打算使用golang来实现这部分功能, 然而在过程中遇到了许多坑, 特此记录过程

0x01 go代码编写

这里使用go的otto做一个javascript解析器, 项目代码如下:

package main

/*
struct JsResult {
   char* result;
   int len;
   int err;
};
*/
import "C"
import (
   "github.com/robertkrimen/otto"
)

func main() {
}

type JsResult C.struct_JsResult

//export RunJs
func RunJs(input *C.char) JsResult {
   res := C.GoString(input) // *C.char -> string

   vm := otto.New()
   result, err := vm.Run(res)
   if err != nil {
      errMsg := err.Error()
      return JsResult{
         result: (*C.char)(C.CString(errMsg)),
         err:    1,
         len:    C.int(len(errMsg)),
      }
   }

   str := result.String()
   return JsResult{
      result: (*C.char)(C.CString(str)), // string -> *C.char
      err:    0,
      len:    C.int(len(str)),
   }
}

注意事项:

  • package main不能改动, 必须为main
  • 由于go有gc, 所以函数的返回值必须为c语言结构, 否则会报错
  • import "C"和上面的C语言代码中间不能有空行
  • //export RunJs//export中间不能有空格(虽然不少编程规范推荐有空格)

0x02 编译go代码

  1. 安装NDK, 这里我使用Android Studio的SDK Manager进行安装

在Flutter项目使用FFI调用Golang项目全记录

  1. 使用下面脚本, 进行构建(build.cmd)
set ANDROID_NDK_HOME=G:\SDK\AndroidSDK\ndk\24.0.7956693

set GOARCH=arm
set GOOS=android
set CGO_ENABLED=1
set CC=%ANDROID_NDK_HOME%\toolchains\llvm\prebuilt\windows-x86_64\bin\armv7a-linux-androideabi21-clang
go build -ldflags "-w -s" -buildmode=c-shared -o ./bin/armeabi-v7a/libgo.so ./main.go
echo Build armeabi-v7a finish

set GOARCH=arm64
set GOOS=android
set CGO_ENABLED=1
set CC=%ANDROID_NDK_HOME%\toolchains\llvm\prebuilt\windows-x86_64\bin\aarch64-linux-android21-clang
go build -ldflags "-w -s" -buildmode=c-shared -o ./bin/armeabi-v8a/libgo.so ./main.go
echo Build armeabi-v8a finish

set GOARCH=amd64
set GOOS=android
set CGO_ENABLED=1
set CC=%ANDROID_NDK_HOME%\toolchains\llvm\prebuilt\windows-x86_64\bin\x86_64-linux-android24-clang
go build -ldflags "-w -s" -buildmode=c-shared -o ./bin/x86_64/libgo.so ./main.go
echo Build x86_64 finish


set GOARCH=386
set GOOS=android
set CGO_ENABLED=1
set CC=%ANDROID_NDK_HOME%\toolchains\llvm\prebuilt\windows-x86_64\bin\i686-linux-android24-clang
go build -ldflags "-w -s" -buildmode=c-shared -o ./bin/x86/libgo.so ./main.go
echo Build x86 finish

其中ANDROID_NDK_HOME替换为NDK安装目录, 这四段程序分别生成armeabi-v7a(老安卓设备),armeabi-v8a(新安卓设备), x86_64(不常见), x86(模拟器常见). 其他设备请自行查阅go编译选项修改GOARCHGOOS

此时会生成bin文件夹, 里面有4个平台的依赖库, 请按照需求自行删减

在Flutter项目使用FFI调用Golang项目全记录

0x03 导入so文件

将4个文件夹复制到android的libs目录中(如果没有则新建一个), .h文件可以删除

在Flutter项目使用FFI调用Golang项目全记录

修改build.gradle文件, 在sourceSets中添加main.jniLibs.srcDirs = ['libs']后build即可

在Flutter项目使用FFI调用Golang项目全记录

0x03 FFI绑定

这里推荐使用 ffigen , 记得安装lvvm, 具体请参照文档

将刚才build出来的libgo.h复制到任意目录下(我这里是ffi), 参照ffigen的文档进行配置, 我的配置如下

随后将会生成如图libgo.h.dart

在Flutter项目使用FFI调用Golang项目全记录
在Flutter项目使用FFI调用Golang项目全记录

随后编写dart -> c 与 c -> dart逻辑进行绑定

import 'libgo.h.dart';
import 'package:ffi/ffi.dart' as ffi;
import 'dart:ffi';

class FFi {
  FFi._();

  final _native = NativeLibrary(DynamicLibrary.open('libgo.so'));

  static final FFi _instant = FFi._();

  factory FFi() => _instant;

  String runJs(String input) {
    final raw = input.codeUnits;
    final buffer = ffi.malloc.allocate<Int8>(raw.length + 1);
    buffer.asTypedList(raw.length + 1)
      ..setAll(0, raw)
      ..[raw.length] = 0;

    final result = _native.RunJs(buffer);
    ffi.malloc.free(buffer);

    final message = String.fromCharCodes(result.result.asTypedList(result.len));
    if (result.err != 0) throw Exception(message);
    return message;
  }
}

简单写个界面测试下, 测试通过收工

在Flutter项目使用FFI调用Golang项目全记录

在Flutter项目使用FFI调用Golang项目全记录

上一篇:execjs执行js编码错误的解决方法(UnicodeDecodeError: ‘gbk‘ codec can‘t decode byte 0xad in position 20: illegal )


下一篇:python:使用python分析大日志文件思路及过程