鸿蒙Next开发中napi和c++的标准格式是什么

在鸿蒙Next开发中，使用NAPI和C++接口时，官方推荐的标准格式是什么？比如函数声明、参数传递和回调处理是否有特定的规范要求？能否提供一个完整的代码示例说明如何正确编写这两种接口的交互代码？

2 回复

鸿蒙Next的NAPI开发，标准格式像相亲：先napi_export自我介绍，再用napi_create_function牵手，最后napi_define_properties绑定关系。C++部分记得用extern "C"避免名字吵架，返回值用napi_value当翻译官。记住：NAPI是鸿蒙的官方红娘，别自己乱牵线！

更多关于鸿蒙Next开发中napi和c++的标准格式是什么的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


在鸿蒙Next开发中，NAPI（Native API）用于实现ArkTS/JS与C++之间的交互，以下是标准格式和示例：

1. C++模块定义标准格式

#include "napi/native_api.h"

// 示例：导出加法函数
static napi_value Add(napi_env env, napi_callback_info info) {
    size_t argc = 2;
    napi_value args[2];
    napi_get_cb_info(env, info, &argc, args, nullptr, nullptr);

    // 参数类型校验
    napi_valuetype valuetype0;
    napi_typeof(env, args[0], &valuetype0);
    napi_valuetype valuetype1;
    napi_typeof(env, args[1], &valuetype1);
    if (valuetype0 != napi_number || valuetype1 != napi_number) {
        napi_throw_type_error(env, nullptr, "Wrong arguments");
        return nullptr;
    }

    // 获取参数值
    double value0;
    double value1;
    napi_get_value_double(env, args[0], &value0);
    napi_get_value_double(env, args[1], &value1);

    // 计算结果
    napi_value sum;
    napi_create_double(env, value0 + value1, &sum);
    return sum;
}

// 模块导出声明
EXTERN_C_START
static napi_value Init(napi_env env, napi_value exports) {
    napi_property_descriptor desc[] = {
        { "add", nullptr, Add, nullptr, nullptr, nullptr, napi_default, nullptr }
    };
    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 = "demo",
    .nm_priv = nullptr,
};

extern "C" __attribute__((constructor)) void RegisterDemoModule() {
    napi_module_register(&demoModule);
}

2. ArkTS调用侧标准格式

// 加载Native模块
import demo from 'libdemo.so';

// 调用C++函数
let result = demo.add(1.5, 2.3); // 返回3.8

3. 关键规范说明

  • 头文件：必须包含 napi/native_api.h
  • 函数签名：napi_value FuncName(napi_env env, napi_callback_info info)
  • 参数解析：使用 napi_get_cb_info 获取参数
  • 类型转换：通过 napi_get_value_xxx 和 napi_create_xxx 系列函数
  • 模块注册：使用 napi_module 结构体和 napi_module_register
  • 错误处理：通过 napi_throw_xxx 抛出异常

4. CMakeLists.txt配置示例

# 添加NAPI依赖
target_link_libraries(your_module PUBLIC libnapi.so)

# 设置编译标准
set(CMAKE_CXX_STANDARD 17)

注意事项

  1. 所有NAPI调用需返回 napi_value（void函数返回nullptr）
  2. 使用 EXTERN_C_START/END 确保C++符号正确导出
  3. 资源管理需手动调用 napi_create_reference/napi_delete_reference

遵循此格式可确保NAPI模块在鸿蒙Next系统正常加载和运行。

回到顶部