【开源三方库】Aki：一行代码极简体验JS&C++跨语言交互 精华

#include <aki/jsbind.h>

// C++业务逻辑
std::string GetName(std::string key)
{
    std::string result = ...... // 获取数据的业务逻辑

    return result; // 返回字符串类型
}

// Aki JSBind语法糖
JSBIND_ADDON(task_runner);
JSBIND_GLOBAL() {
    JSBIND_FUNCTION(GetName, "getNameSync"); // 绑定同步方法
    JSBIND_PFUNCTION(GetName, "getNameAsync"); // 绑定异步方法
}
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.

import libtask_runner from 'libtask_runner.so';

const name = libstorage.getNameSync('name');// 调用同步方法
console.log('name is ' + name);

// 调用异步方法
libstorage.getNameAsync('name').then(date => {
    console.log('name is ' + data);
}).catch(error => {
    console.log('error: ' + error);
});
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.

#include <aki/jsbind.h>

// C++逻辑
struct Person {
    // 构造函数，用于JS侧 new 对象
    Person(std::string name) : name(name) {}

    // 静态函数
    static Person GetAllPerson(); // 支持类对象作为参数

    // 成员函数
    int SayHello();

    std::string name;
};

// Aki JSBind语法糖
JSBIND_ADDON(person);
JSBIND_CLASS(Person) {
    JSBIND_CONSTRUCTOR<std::string>(); // 绑定构造函数
    JSBIND_METHOD(GetAllPerson); // 绑定类静态函数
    JSBIND_METHOD(SayHello); // 绑定类成员函数
    JSBIND_PROPERTY(name); // 绑定类成员属性
}
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.

import libperson from 'libperson.so';

let person = new libperson.Person("aki"); // 调用构造函数
console.log('person name: ' + person.name); // 访问类属性
let greeting = person.SayHello(); // 调用类成员函数
let persons = libperson.Person.GetAllPerson(); // 调用类静态函数
1.
2.
3.
4.
5.
6.

#include <aki/jsbind.h>

// C++逻辑
void SafetyCallback(std::function<void (std::string)> callback) {
    std::thread t([callback = std::move(callback)] () {
        callback("aki"); // 线程安全，直接调用
    });
    t.detach();
}

// Aki JSBind语法糖
JSBIND_ADDON(sub_thread);
JSBIND_GLOBAL() {
    JSBIND_FUNCTION(SafetyCallback);
}
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.

import libsub_thread from 'libsub_thread.so';
// 入参为JS方法回调
libsub_thread.SafetyCallback((data) => {
  console.error('test result = ' + data); // test result = aki
})
1.
2.
3.
4.
5.

import libAddon from 'libaddon.so'

function createTable(table: string) {
    rdbStore.executeSql()... // OHOS 关系型数据库逻辑
}

libAddon.JSBind.bindFunction('createTable', createTable); // 绑定JS函数
1.
2.
3.
4.
5.
6.
7.

#include <aki/jsbind.h>

// C++逻辑
bool DoSomethingFromNative() {
    if (auto createTable = aki::JSBind::GetJSFunction("createTable")) {
        createTable->Invoke<void>("MYSTORE"); // 入参类型 string
    }
1.
2.
3.
4.
5.
6.
7.

cd entry
ohpm install @ohos/aki
1.
2.

...
set(AKI_ROOT_PATH ${CMAKE_CURRENT_SOURCE_DIR}/../../../oh_modules/@ohos/aki) # 设置AKI根路径
set(CMAKE_MODULE_PATH ${AKI_ROOT_PATH})
find_package(Aki REQUIRED)
...
target_link_libraries(${YOUR_TARGET} PUBLIC Aki::libjsbind) # 链接二进制依赖
...
1.
2.
3.
4.
5.
6.
7.

cd entry/src/main/cpp
git clone https://gitee.com/openharmony-sig/aki.git
1.
2.

...
add_subdirectory(aki)
target_link_libraries(entry PUBLIC aki_jsbind) // entry 为编译目标
...
1.
2.
3.
4.