目录

napi_load_module_with_info使用限制和注意事项

问题现象

napi_load_module_with_info支持开发者在C++侧加载工程内模块及文件,该接口在使用时有哪些使用限制和注意事项?

解决方案

  • 加载本地工程模块内文件时,要求path以moduleName开头。
  • 因为应用间的hsp包也可以通过napi_load_module_with_info接口加载,所以module_info参数中必须指定bundleName和moduleName。
  • 编译构建后,HAR模块被打包到各个模块之中,其入口模块仍然是HAP模块。所以在调用HAR模块时,path的模块名称要填HAP模块中oh-package.json5中定义的依赖HAR的名称,而不是HAR模块的实际名称。
  • 如果在HAP/HSP中直接或间接使用了三方包,该三方包中使用napi_load_module_with_info接口加载其他模块A,则需要在HAP/HSP中也添加A的依赖。
  • 在加载非模块内文件时,需要对调用模块的build-profile.json5进行配置:
    buildOption->arkOptions->runtimeOnly->packages->oh-package.json5文件中dependencies配置的依赖名。
  • 在napi_create_ark_runtime接口创建的运行时环境中使用时,若希望加载的模块不被系统回收,可以通过napi_create_reference方法将模块存储起来。
  • 在ohosTest中使用时,需要将加载路径改为“entry/src/ohosTest/ets/test/Ability.test”,module_info中的模块名改成entry_test。

总结

与napi_load_module仅支持在主线程使用相比,napi_load_module_with_info不仅支持在主线程中使用,也可以在新创建的ArkTS基础运行时环境中使用。

napi_load_module_with_info支持加载hap/hsp/har/native模块等多种场景,具体使用可以参考使用示例。

在实现模块加载时,推荐优先使用napi_load_module_with_info接口。