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