今天编译了一天, 一个第三库, 也集成到鸿蒙里面了。
现在问题卡在, 他这个库是使用libtool 来打开几个 .so 库。 我的问题 这些 .so 放在哪个目录。
native 侧怎么读取这个路径。 因为我要把这个路径传给他, 保证他能读到这些动态库。
今天试了还没调通,
我的世界Core File Kit
伙伴SDK
鸿蒙如何使用libtool加载动态库
澜沧【解决方案】
我的世界终于加载到了, 他其实路径是固定的 /libs/arm64/ 把 .so 都放到这个路径下了。 非常感谢1
2025-08-18 04:20 来自广东
哈莫尼OS楼主在集成第三方动态库时,要注意沙箱路径管理和Native侧加载机制。
1 动态库存饭
一版是将.so文件放置于工程目录的entry/libs/${OHOS_ARCH}/路径下,这个目录结构需与CMakeLists.txt配置的路径匹配。
在ArkTS侧通过bundleCodeDir获取沙箱路径比如:
// ArkTS侧获取路径
let projectPath = this.getUIContext().getHostContext()!.bundleCodeDir;
let soLibPath = `${projectPath}/libs/${abiPath}/libnativeSub.so`;这个路径需通过Native接口传递至C++层。
2 Native侧动态库加载
Native侧通过napi_get_value_string_utf8获取ArkTS传递的沙箱路径,使用dlopen加载动态库。要引入dlfcn.h头文件,并处理路径内存分配与释放。
// Native侧
char *path = new char[length + 1];
napi_get_value_string_utf8(env, args, path, length + 1, &length);
void *handle = dlopen(path, RTLD_LAZY);
Sub sub_func = (Sub)dlsym(handle, "sub");
dlclose(handle); // 使用后必须关闭在CMakeLists.txt中声明动态库链接路径,确保编译时正确关联动态库
target_link_libraries(entry PUBLIC
${NATIVERENDER_ROOT_PATH}/../../../libs/${OHOS_ARCH}/libnativeAdd.so)
Yanyan
//动态import方式
//适用于加载符合鸿蒙N-API规范的动态库(如HAR模块或专用.so文件)
// 异步加载动态库并调用函数
async function loadDynamicLib() {
const lib = await import('libexample.so'); // 动态导入
const result = lib.add(3, 5); // 调用库函数
console.log(`Result: ${result}`);
}//loadNativeModule同步加载
//适用于系统库或应用内Native模块,需在主线程执行
const nativeModule = loadNativeModule("@system.app");
nativeModule.showToast({ message: "Loaded successfully" });参考地址
https://developer.huawei.com/consumer/cn/doc/harmonyos-faqs/faqs-ndk-4
平淡1. 将 libmodbus.so 文件放置在工程模块的 src/main/cpp/libs 目录下,并按 ABI 类型分类存放
src/main/cpp/libs/
├── arm64-v8a
│ └── libmodbus.so
└── x86_64
└── libmodbus.so2. 在模块的 build-profile.json5 中声明 Native 库路径与支持的 ABI
{
"buildOption": {
"externalNativeOptions": {
"abiFilters": ["arm64-v8a", "x86_64"],
"cppFlags": "",
"path": "src/main/cpp/CMakeLists.txt"
}
}
}3. 在 module.json5 文件中添加动态库声明
{
"module": {
"nativeLibraryPath": ["src/main/cpp/libs"]
}
}4. 在 ArkTS 或 C++ 代码中调用 System.loadLibrary 加载库
// ArkTS 文件
import native from '@kit.ArkTS';
native.loadLibrary('modbus'); // 这里省略 'lib' 前缀和 .so 后缀这个可能适合你,这是技术支持回复我的,捂脸,我的还不太行 。。。
我的世界nativeLibraryPath 都没有这个属性2025-08-18 02:21 来自广东
澜沧【背景知识】
参考官网Native侧引用三方so库的文档。
【解决方案】
Native工程引用已经适配HarmonyOS的so库
- 开发步骤。
- 将三方库生成的so文件拷贝到应用工程目录。
为便于管理三方库,在应用工程的cpp目录新建一个thirdparty目录,将生成的so文件以及头文件拷贝到该目录下。
如果该三方库二进制文件为so文件,还需要将so文件拷贝到工程目录的entry/libs/${OHOS_ARCH}/目录下。 - 配置对应链接。
配置链接只需要在cpp目录的CMakeLists.txt文件中添加对应target_link_libraries即可,动态库和静态库只需要填写一个:cmake复制
# 配置静态库 target_link_libraries(entry PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/xxx/${OHOS_ARCH}/lib/libxxx.a) # 配置动态库 target_link_libraries(entry PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/xxx/${OHOS_ARCH}/lib/libxxx.so) - 配置头文件路径。
配置链接只需要在cpp目录的CMakeLists.txt文件中添加对应target_include_directories:cmake复制
target_include_directories(entry PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/xxx/${OHOS_ARCH}/include) - 工程关键部分结构。
假设xxx代表的是三方库名称,xxx文件夹下包含了arm64架构生成的二进制文件,架构目录下包含了该库的头文件(include)以及二进制文件(lib)。txt复制
└─entry ├─libs │ └─arm64-v8a │ └─libxxx.so └─src └─main ├─cpp │ ├─thirdparty │ │ └─xxx │ │ └─arm64-v8a │ │ ├─include │ │ └─lib │ └─types │ └─libentry │ ├─index.d.ts │ └─oh-package.json5 └─ets └─pages └─Index.ets
- 将三方库生成的so文件拷贝到应用工程目录。
- 注意事项。
-
应用在引用动态库的时候是通过soname来查找的,所以我们需要将名字为soname的库文件拷贝到:
entry/libs/${OHOS_ARCH}/目录下。
soname查看方法:llvm-readelf -d libxxx.so。
-
要正确的拷贝so文件。
正确拷贝so文件后so文件大小应该与原库实体文件大小一致,so文件大小也可以通过llvm-readelf -d libxxx.so查询。
-
我的世界我不是要集成它, 是要 dlopen 动态加载, 因为我集成了一个第三库,他需要去动态加载一些 .so 。 现在问题是,我不知道鸿蒙上如何去获取到这个绝对路径 ,也想熟悉一下鸿蒙的目录结构,但是发现很难,2025-08-18 02:53 来自广东
澜沧回复我的世界楼主你好,已在最新的楼层答复2025-08-18 03:00 来自广东
- 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
- 如您发布的内容为转载内容,请注明内容来源。
我要提问题
HarmonyOS await import (“libentry.so”) 加载本地文件file的so文件,这么加载之后,就可以在native使用dlopen、dlsym加载本地文件so的函数吗?(API12+)
HarmonyOS 上拉加载库(API12+)
HarmonyOS 动态库链接和加载形式 (API12+)
HarmonyOS Image加载出现白块(API12+)
HarmonyOS 使用dlopen无法动态加载so? (API12+)
HarmonyOS await import (“libentry.so”) 加载本地so文件之后,就可以在native使用dlopen加载so的函数吗? (API12+)
HarmonyOS Native代码中通过include方式使用so库(API12+)
HarmonyOS 使用dlopen加载沙箱路径so文件报错 "check ns accessible failed"(API12+)




































苏公安网备 32011402010933号