#HarmonyOS NEXT体验官# 鸿蒙NDK开发入门 原创 精华

typedef enum {
    napi_ok,
    napi_invalid_arg,
    napi_object_expected,
    napi_string_expected,
    napi_name_expected,
    napi_function_expected,
    napi_number_expected,
    napi_boolean_expected,
    napi_array_expected,
    napi_generic_failure,
    napi_pending_exception,
    napi_cancelled,
    napi_escape_called_twice,
    napi_handle_scope_mismatch,
    napi_callback_scope_mismatch,
    napi_queue_full,
    napi_closing,
    napi_bigint_expected,
    napi_date_expected,
    napi_arraybuffer_expected,
    napi_detachable_arraybuffer_expected,
    napi_would_deadlock, /* unused */
    napi_no_external_buffers_allowed,
    napi_cannot_run_js
} napi_status;
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.

# the minimum version of CMake.
cmake_minimum_required(VERSION 3.4.1)
project(MyApplication) 

# 定义一个变量，并赋值为当前模块cpp目录
# ${CMAKE_CURRENT_SOURCE_DIR}指的就是CMakeLists.txt所在路径
set(NATIVERENDER_ROOT_PATH ${CMAKE_CURRENT_SOURCE_DIR})

# 添加头文件.h目录，包括cpp，cpp/include，告诉cmake去这里找到代码引入的头文件
include_directories(${NATIVERENDER_ROOT_PATH}
                    ${NATIVERENDER_ROOT_PATH}/include)

# 声明一个产物libentry.so，SHARED表示产物为动态库，napi_init.cpp为产物的源代码
add_library(entry SHARED napi_init.cpp)

# 声明产物entry链接时需要的三方库libace_napi.z.so
# 这里直接写三方库的名称是因为它是在ndk中，已在链接寻址路径中，无需额外声明
target_link_libraries(entry PUBLIC libace_napi.z.so)
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.

import testNapi from 'libentry.so';
1.

// 准备模块加载相关信息，将上述Init函数与本模块名等信息记录下来。
static napi_module demoModule = {
    .nm_version = 1,
    .nm_flags = 0,
    .nm_filename = nullptr,
    .nm_register_func = Init,
    .nm_modname = "entry",
    .nm_priv = nullptr,
    .reserved = {0},
};

// 加载so时，该函数会自动被调用，将上述demoModule模块注册到系统中。
extern "C" __attribute__((constructor)) void RegisterDemoModule() { 
    napi_module_register(&demoModule);
 }
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.

EXTERN_C_START
// 模块初始化
static napi_value Init(napi_env env, napi_value exports)
{
    // ArkTS接口与C++接口的绑定和映射，
    napi_property_descriptor desc[] = {
        // ArkTS的add函数绑定C/C++的Add函数
        { "add", nullptr, Add, nullptr, nullptr, nullptr, napi_default, nullptr }
    };
    // 在exports对象上挂载CallNative/NativeCallArkTS两个Native方法
    napi_define_properties(env, exports, sizeof(desc) / sizeof(desc[0]), desc);
    return exports;
}
EXTERN_C_END
// 模块基本信息
static napi_module demoModule = {
    .nm_version = 1,
    .nm_flags = 0,
    .nm_filename = nullptr,
    .nm_register_func = Init,
    .nm_modname = "entry",
    .nm_priv = ((void*)0),
    .reserved = { 0 },
};
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.

export const add: (a: number, b: number) => number;
export const sub: (a: number, b: number) => number;
1.
2.

static napi_value Init(napi_env env, napi_value exports)
{
    // ArkTS接口与C++接口的绑定和映射，
    napi_property_descriptor desc[] = {
        // ArkTS的add函数绑定C/C++的Add函数
        { "add", nullptr, Add, nullptr, nullptr, nullptr, napi_default, nullptr }
        // ArkTS的sub函数绑定C/C++的Sub函数
        { "sub", nullptr, Sub, nullptr, nullptr, nullptr, napi_default, nullptr }
    };
    // 在exports对象上挂载CallNative/NativeCallArkTS两个Native方法
    napi_define_properties(env, exports, sizeof(desc) / sizeof(desc[0]), desc);
    return exports;
}
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.

static napi_value Add(napi_env env, napi_callback_info info)
{
    // 声明参数的个数，由于ArkTS会传递过来两个参数，参数的个数就为2
    size_t argc = 2;
    // 声明参数数组
    napi_value args[2] = {nullptr};
    // 将ArkTS传入的参数并依次放入参数数组中
    napi_get_cb_info(env, info, &argc, args , nullptr, nullptr);
    // 依次获取参数
    // 获取ArkTS传入的第一个参数
    double value0;
    napi_get_value_double(env, args[0], &value0);
    // 获取ArkTS传入的第二个参数
    double value1;
    napi_get_value_double(env, args[1], &value1);
    // 需要给ArkTS回传参数，定义napi_value
    napi_value sum;
    // 获取到ArkTS传入的两个参数后，将两个参数相加，相加结果赋值给napi_value
    napi_create_double(env, value0 + value1, &sum);
    // 返回napi_value给ArkTS
    return sum;
}
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.