文档开发者中心
我的
|

Core File Kit

伙伴SDK

鸿蒙如何使用libtool加载动态库

已解决

今天编译了一天, 一个第三库, 也集成到鸿蒙里面了。 

现在问题卡在, 他这个库是使用libtool 来打开几个 .so 库。  我的问题 这些 .so 放在哪个目录。 

native 侧怎么读取这个路径。 因为我要把这个路径传给他, 保证他能读到这些动态库。 

今天试了还没调通, 

点赞
收藏
1
回复
9
分享
举报
浏览258 发布于2025-08-17 16:55广东
全部评论
最多点赞
最新发布
最早发布
|
采纳答复

【解决方案】

官方文档1:ArkTS侧与Native侧分别如何动态加载SO库

1
7楼回复于2025-08-18 02:59 来自广东
  • 我的世界
    终于加载到了, 他其实路径是固定的 /libs/arm64/ 把 .so 都放到这个路径下了。 非常感谢
    2025-08-18 04:20 来自广东

楼主在集成第三方动态库时,要注意沙箱路径管理和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)
展开全部
9楼回复于2025-08-18 10:02 来自河北
收起
自动换行
深色代码主题
复制
//动态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

8楼回复于2025-08-18 09:50 来自安徽

1.  将 libmodbus.so 文件放置在工程模块的 src/main/cpp/libs 目录下,并按 ABI 类型分类存放

收起
自动换行
深色代码主题
复制
src/main/cpp/libs/

├── arm64-v8a

│   └── libmodbus.so

└── x86_64

    └── libmodbus.so

2.  在模块的 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 后缀

这个可能适合你,这是技术支持回复我的,捂脸,我的还不太行 。。。

展开全部
1
5楼回复于2025-08-18 01:24 来自广东
  • 我的世界
    nativeLibraryPath 都没有这个属性
    2025-08-18 02:21 来自广东

【背景知识】
参考官网Native侧引用三方so库的文档。

【解决方案】

Native工程引用已经适配HarmonyOS的so库

  • 开发步骤。
    1. 将三方库生成的so文件拷贝到应用工程目录。
      为便于管理三方库,在应用工程的cpp目录新建一个thirdparty目录,将生成的so文件以及头文件拷贝到该目录下。
      如果该三方库二进制文件为so文件,还需要将so文件拷贝到工程目录的entry/libs/${OHOS_ARCH}/目录下。
    2. 配置对应链接。
      配置链接只需要在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)
    3. 配置头文件路径。
      配置链接只需要在cpp目录的CMakeLists.txt文件中添加对应target_include_directories:

      cmake复制

      target_include_directories(entry PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/thirdparty/xxx/${OHOS_ARCH}/include)
    4. 工程关键部分结构。
      假设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
  • 注意事项。
    1. 应用在引用动态库的时候是通过soname来查找的,所以我们需要将名字为soname的库文件拷贝到:

      entry/libs/${OHOS_ARCH}/目录下。

      soname查看方法:llvm-readelf -d libxxx.so。

    2. 要正确的拷贝so文件。
      正确拷贝so文件后so文件大小应该与原库实体文件大小一致,so文件大小也可以通过llvm-readelf -d libxxx.so查询。

展开全部
2
4楼回复于2025-08-18 01:18 来自广东
  • 我的世界
    我不是要集成它, 是要 dlopen 动态加载, 因为我集成了一个第三库,他需要去动态加载一些 .so 。 现在问题是,我不知道鸿蒙上如何去获取到这个绝对路径 ,也想熟悉一下鸿蒙的目录结构,但是发现很难,
    2025-08-18 02:53 来自广东
  • 澜沧回复我的世界
    楼主你好,已在最新的楼层答复
    2025-08-18 03:00 来自广东
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要提问题

了解社区公约,与您携手共创和谐专业的开发者社区。