参数名 | 含义说明 |
|---|---|
path | 要加载的文件路径/模块名。如:“entry/src/main/ets/Test”。 |
module_info | app.json5中配置的工程名/待加载模块所在的HAP下module.json5中配置的模块名的路径拼接,如:“com.example.application/entry”。 |
返回值名 | 含义说明 | 异常处理方法 |
|---|---|---|
napi_invalid_arg | env/result为nullptr。 | 检查传入的参数,确保参数值准确不为空。 |
napi_generic_failure | 模块加载失败。 | 检查文件路径/模块信息是否准确,确保目标路径下文件存在。 |
napi_pending_exception | 调用接口前有未捕获的ArkTS异常。 | 可以参考官方文档中清除异常接口napi_get_and_clear_last_exception和调用前检查异常接口napi_is_exception_pending来定位异常发生的位置。 |
buildOption->arkOptions->runtimeOnly->packages->oh-package.json5文件中dependencies配置的依赖名。
与napi_load_module仅支持在主线程使用相比,napi_load_module_with_info不仅支持在主线程中使用,也可以在新创建的ArkTS基础运行时环境中使用。
napi_load_module_with_info支持加载hap/hsp/har/native模块等多种场景,具体使用可以参考使用示例。
在实现模块加载时,推荐优先使用napi_load_module_with_info接口。