鸿蒙Next中如何导出napi常量

在鸿蒙Next开发中，我想通过napi接口导出一些常量供JS层调用，但不太清楚具体实现方法。比如如何定义常量并确保它们能被正确绑定到模块对象上？是否需要特殊的宏或注册函数？求一个完整的示例代码说明导出流程。

2 回复

在鸿蒙Next中导出napi常量，可以通过以下步骤实现：

  1. 在模块初始化函数中定义常量属性
static napi_value Init(napi_env env, napi_value exports) {
    napi_value constant_value;
    
    // 创建常量值
    napi_create_int32(env, 100, &constant_value);
    
    // 将常量挂载到exports对象
    napi_set_named_property(env, exports, "MY_CONSTANT", constant_value);
    
    return exports;
}
  1. 使用宏注册模块
EXTERN_C_START
static napi_module myModule = {
    .nm_version = 1,
    .nm_flags = 0,
    .nm_filename = nullptr,
    .nm_register_func = Init,
    .nm_modname = "mymodule",
    .nm_priv = nullptr,
};
EXTERN_C_END
  1. 在JS侧使用
import mymodule from 'libmymodule.so';
console.log(mymodule.MY_CONSTANT); // 输出100

注意：常量应该在模块初始化时创建，确保线程安全。对于字符串常量可以使用napi_create_string_utf8，布尔值使用napi_get_boolean等对应API。

更多关于鸿蒙Next中如何导出napi常量的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


在鸿蒙Next中，可以通过NAPI（Native API）模块导出常量给JavaScript层使用。以下是具体步骤和代码示例：

步骤说明

  1. 定义模块导出函数：在模块初始化时注册常量。
  2. 创建常量属性：使用 napi_create_int32、napi_create_string_utf8 等函数创建常量值。
  3. 设置模块导出：通过 napi_define_properties 将常量绑定到导出对象。

代码示例

#include <hilog/log.h>
#include <napi/native_api.h>

// 定义常量值
static napi_value Init(napi_env env, napi_value exports) {
    napi_status status;
    napi_value constantValue;

    // 示例1：导出整型常量
    status = napi_create_int32(env, 100, &constantValue);
    if (status != napi_ok) {
        napi_throw_error(env, nullptr, "Failed to create integer constant");
        return nullptr;
    }
    status = napi_set_named_property(env, exports, "MY_CONSTANT_INT", constantValue);
    if (status != napi_ok) return nullptr;

    // 示例2：导出字符串常量
    napi_value stringConstant;
    status = napi_create_string_utf8(env, "Hello Harmony", NAPI_AUTO_LENGTH, &stringConstant);
    if (status != napi_ok) return nullptr;
    status = napi_set_named_property(env, exports, "MY_CONSTANT_STRING", stringConstant);

    return exports;
}

// 模块声明
EXTERN_C_START
static napi_module myModule = {
    .nm_version = 1,
    .nm_flags = 0,
    .nm_filename = nullptr,
    .nm_register_func = Init,
    .nm_modname = "myModule",
    .nm_priv = nullptr,
};
EXTERN_C_END

// 模块初始化
extern "C" __attribute__((constructor)) void RegisterModule() {
    napi_module_register(&myModule);
}

使用说明

  • JavaScript层调用：
    import myModule from 'libmyModule.so'; // 根据实际路径调整
console.log(myModule.MY_CONSTANT_INT);    // 输出: 100
console.log(myModule.MY_CONSTANT_STRING); // 输出: "Hello Harmony"

注意事项

  1. 确保NAPI头文件路径正确引入。
  2. 模块名称（nm_modname）需与JavaScript导入名一致。
  3. 常量导出需在模块初始化函数（如Init）中完成。

通过以上方法，即可在鸿蒙Next中通过NAPI导出常量供ArkTS/JavaScript使用。

回到顶部