arkffi 概述 - ArkFFI

arkffi 让你从 ArkTS 直接调用 .so 共享库中的 C 函数 —— 无需手写 NAPI 绑定。

快速开始

安装、配置，在几分钟内调用你的第一个 C 函数。

API 参考

dlopen、FFIType、CString、CFunction、JSCallback 完整参考。

指南

混合类型、函数指针、回调的深入指南。

概述

arkffi 提供三个抽象层：

层级	说明
原始 NAPI 桥接	`load`、`close`、`callMixed`、`callBySig`、`callString`、`readCString`、`getSymbolPtr`、`callPtr`
`dlopen` 封装	声明式 `dlopen()`，支持字典式函数定义和类型化符号
CFunction / JSCallback	函数指针包装和 ArkTS 回调支持

特性

从 .so 库调用任意导出的 C 函数
支持 int32、int64、double、float、bool、pointer、cstring
混合参数类型（int + double + string 一次调用）
通过 CFunction 支持函数指针
通过 JSCallback 支持 ArkTS 回调，可设置 threadsafe
通过 CString 读取 C 字符串
TypeScript 泛型支持 IDE 代码补全

快速开始

import { dlopen, FFIType, CString } from 'arkffi';

const lib = dlopen('libffi_target.so', {
  add:        { args: [FFIType.double, FFIType.double], returns: FFIType.double },
  getVersion: { args: [],                                returns: FFIType.int64 },
});

lib.symbols.add(2.0, 3.0);
new CString(lib.symbols.getVersion()).toString();

lib.close();

架构

ArkTS / TypeScript        dlopen / CFunction / JSCallback / CString
      │                              │
      ▼                              ▼ (NAPI)
liblibrary.so ──dlopen/dlsym/dlclose──► libffi_target.so (或任意 .so)

安装

ohpm install arkffi