HarmonyOS鸿蒙Next中已经封装好的napi库，在普通的工程中如何调用呢？

HarmonyOS鸿蒙Next中已经封装好的napi库，在普通的工程中如何调用呢？

"name": "libentry"  
"types": "./index.d.ts"  
"version": “1.0.0”  
"napi": {  
  "name": "libentry"  
  "files":[  
    "./libs/arm64-v8a/libsefbaseapi.so"  
    "./libs/arm64-v8a/libentry.so"  
  ]  
}

伙伴这样写，在import时提示找不到libentry.so

3 回复

【背景知识】

参考官网ArkTS侧引用三方so库的文档，通过配置模块动态依赖即可在工程中引用已经适配HarmonyOS的so库。

【解决方案】

将so库和对应的Native侧接口文件加入到工程中，在工程中配置so库对应的模块动态依赖，在ArkTS侧通过import引入依赖接口调用so库。但是需要注意该方案只能引用适配HarmonyOS的so库，因此在编译生成so库时需要实现功能函数并向Napi注册其Native侧接口，提供对应的Native侧接口文件index.d.ts和配置文件oh-package.json5。

开发步骤

  1. 将已经适配HarmonyOS的so库文件置于entry/libs对应的架构目录下。
  2. 在src/main/cpp/types下新建目录并将接口文件index.d.ts、配置文件oh-package.json5移动到该目录下。
  3. 在模块级oh-package.json5中声明so库根目录路径。
// entry/oh-package.json5

{
  // ...
  "dependencies":
  {
    // ... // 声明的依赖名称应与引用的so库名称一致
    "libxxx.so": "file:./src/main/cpp/types/libxxx"
  }
}
  1. 在ArkTS侧使用import引用oh-package.json5中声明的依赖并进行结果验证。
//entry/src/main/ets/pages/Index.ets 
import testNAPI from 'libxxx.so'; // 直接使用已经适配Native的so库进行乘法运算 
let result = testNAPI.func();
// 注意事项 在引用过程中除了将已经适配HarmonyOS的libxxx.so库文件置于entry/libs对应的架构目录下外，还需要将编译三方so库时配套产生的libc++_shared.so库文件置于该目录下。

更多关于HarmonyOS鸿蒙Next中已经封装好的napi库，在普通的工程中如何调用呢？的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


在HarmonyOS鸿蒙Next中，已封装的napi库可以通过在工程中引入相应的头文件和库文件来调用。首先，确保工程配置中包含napi库的路径。然后，在代码中使用#include指令引入napi头文件，并在编译时链接napi库。调用时，直接使用napi提供的API函数即可。具体调用方式需参考napi库的文档，确保函数参数和返回值类型正确。

在HarmonyOS Next中调用已封装的napi库时，需要注意以下几点：

  1. 确保工程配置正确：
  • 在模块级build.gradle中正确声明so库路径：
sourceSets {
    main {
        jniLibs.srcDirs = ['libs']
    }
}
  1. 检查库文件放置位置：
  • 确认.so文件已放在正确目录：src/main/libs/arm64-v8a/下
  1. 类型声明问题：
  • 确保index.d.ts文件正确定义了模块接口
  • 检查package.json中types路径是否正确指向声明文件
  1. 导入方式：
  • 使用正确的ES模块导入语法：
import * as libentry from 'libentry'
  1. 常见问题排查：
  • 检查设备架构是否匹配(arm64-v8a)
  • 确认.so文件已打包到最终APK中
  • 检查NDK版本兼容性

如果仍有问题，请提供更详细的错误日志以便进一步分析。

回到顶部