HarmonyOS Next开发学习手册——Node-API接口进行模块加载

最新推荐文章于 2025-06-13 15:27:08 发布

原创

最新推荐文章于 2025-06-13 15:27:08 发布 · 523 阅读

7 ·

CC 4.0 BY-SA版权

文章标签：

#harmonyos #学习 #华为 #组件化开发 #ArkTS #Node-API #模块化

Node-API中的napi_load_module_with_info接口的功能是进行模块的加载，当模块加载出来之后，可以使用函数napi_get_property获取模块导出的变量，也可以使用napi_get_named_property获取模块导出的函数，该函数可以在新创建的ArkTs基础运行时环境中使用

函数说明

napi_status napi_load_module_with_info(napi_env env,
                                       const char* path,
                                       const char* module_info,
                                       napi_value* result);

参数	说明
env	当前的虚拟机环境
path	加载的文件路径或者模块名
module_info	bundleName/moduleName的路径拼接
result	加载的模块

注：

bundleName表示AppScope/app.json5中配置的工程名
moduleName指的是待加载模块所在的HAP下module.json5中配置的名字
napi_load_module 只局限于在主线程中进行模块加载

napi_load_module_with_info支持的场景

场景	详细分类	说明
本地工程模块	HAP加载模块内文件路径	要求路径以moduleName开头
本地工程模块	HAP加载HAR模块名	-
远程包	HAP加载远程HAR模块名	-
远程包	HAP加载ohpm包名	-
API	HAP加载@ohos.或 @system.	-
模块Native库	HAP加载libNativeLibrary.so	-

注：

加载一个模块名，实际的行为是加载该模块的入口文件，一般为index.ets/ts。
如果在HAR中加载另外一个HAR，需要确保module_info的配置正确，尤其注意moduleName应为HAP的moduleName

使用示例

HAP加载模块内文件路径

当加载文件中的模块时，如以下ArkTS代码：

//./src/main/ets/Test.ets
let value = 123;
function test() {
  console.log("Hello HarmonyOS");
}
export {value, test};

1.需要在工程的build-profile.json5文件中进行以下配置

{
    "buildOption" : {
        "arkOptions" : {
            "runtimeOnly" : {
                "sources": [
                    "./src/main/ets/Test.ets"
                ]
            }
        }
    }
}

2.使用napi_load_module_with_info加载Test文件，调用函数test以及获取变量value

static napi_value loadModule(napi_env env, napi_callback_info info) {
    napi_value result;
    //1. 使用napi_load_module_with_info加载Test文件中的模块
    napi_status status = napi_load_module_with_info(env, "entry/src/main/ets/Test", "com.example.application/entry", &result);

    napi_value testFn;
    //2. 使用napi_get_named_property获取test函数
    napi_get_named_property(env, result, "test", &testFn);
    //3. 使用napi_call_function调用函数test
    napi_call_function(env, result, tes