requireNapi 一直返回 undefined,nativeLibraryPath 显示 libs/arm64,但 HAP 实际打包到了 arm64-v8a
大佬们好,我在做 NAPI 模块开发,需要在 ArkTS 侧加载一个 C++ 编写的 so 库。
我的配置是这样的:module.json5 里设置了 nativeLibraryPath: "libs/arm64",compressNativeLibs=false,libIsolation=false。HAP 打包完之后,我用 zip 工具解压看了一下,so 文件实际被打包到了 libs/arm64-v8a/ 目录下。
然后在 ArkTS 侧调用 requireNapi('xxx'),始终返回 undefined。NAPI 模块里注册的构造函数日志完全没有出现。
我尝试过:
-
在
oh-package.json5里配置nativeModule,指定name和library; -
C++ 侧
napi_module.nm_modname也设置成了对应的模块名; -
ArkTS 侧试了各种传入参数组合:模块名、带
lib前缀的 so 文件名、'entry'等各种写法。
但都不管用。
更诡异的是,我想把 abiFilters 改成 arm64 来匹配 nativeLibraryPath 的路径,结果 hvigor 直接报错说不支持,allowedValues 里只有 'arm64-v8a'、'armeabi-v7a'、'x86_64' 这三个选项。
想请教几个问题:
-
HarmonyOS NEXT 的
nativeLibraryPath显示libs/arm64是正常的吗? 如果系统只认arm64-v8a这个 ABI 名称,那module.json5里配置libs/arm64是不是根本就不会被正确解析? -
requireNapi查找 so 库的逻辑到底是什么? 是严格按照nativeLibraryPath配置的路径去找,还是会根据设备的 ABI 自动做路径映射?如果会映射,那映射规则是什么? -
有没有官方推荐的 Native 模块注册方式或配置项,可以强制让
requireNapi正确找到 so 库? 是在module.json5、app.json5还是oh-package.json5里配置? -
我注意到
bm dump命令看到的nativeLibraryPath和 HAP 实际打包路径不一致,这是不是说明问题出在构建阶段,hvigor 打包时没有把nativeLibraryPath的配置正确传递到最终的 HAP manifest 里? -
MUSL-LDSO 的依赖错误日志也没有出现,所以应该不是 so 库本身有缺失依赖的问题。如果路径配置都对,还有什么原因会导致
requireNapi返回 undefined?
这个问题卡了我好几天了,网上关于 NAPI 模块加载的帖子也不多,大部分都是讲怎么注册的,很少有讲这种路径不匹配导致加载失败的坑。希望有经验的大佬指点一下,谢谢!
- 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
- 如您发布的内容为转载内容,请注明内容来源。
我要提问题











































苏公安网备 32011402010933号