harmony 鸿蒙同步方式动态加载native模块

  • 2025-06-12
  • 浏览 (7)

同步方式动态加载native模块

loadNativeModule接口的功能是同步方式动态加载native模块。它的主要目的是在需要某个native模块时才进行加载,从而避免在应用启动时加载不必要的模块。但是使用该接口时会产生加载so耗时,需要开发者自行评估是否会对功能产生影响。

函数说明

loadNativeModule(moduleName: string): Object;
参数 说明
moduleName 加载的模块名。

说明 loadNativeModule加载的模块名指的是依赖方oh-package.json5文件的dependencies中的名字。

loadNativeModule只能在UI主线程中加载模块。

该接口功能在加载常量字符串或变量表达式作为参数时,都需要配置依赖。

loadNativeModule支持的场景

场景 示例
系统库模块 加载@ohos.或@system.
应用内native模块 加载libNativeLibrary.so

使用示例

  • HAP加载系统库模块
let hilog: ESObject = loadNativeModule("@ohos.hilog");
hilog.info(0, "testTag", "loadNativeModule ohos.hilog success");
  • HAP加载Native库

libentry.so的index.d.ts文件如下:

//index.d.ts
export const add: (a: number, b: number) => number;

1.在加载本地so库时,需在oh-package.json5文件中配置dependencies项。

{
    "dependencies": {
        "libentry.so": "file:../src/main/cpp/types/libentry"
    }
}

2.在build-profile.json5中进行配置。

{
    "buildOption" : {
        "arkOptions" : {
            "runtimeOnly" : {
                "packages": [
                    "libentry.so"
                ]
            }
        }
    }
}

3.使用loadNativeModule加载libentry.so,并调用函数add。

let module: ESObject = loadNativeModule("libentry.so");
let sum: number = module.add(1, 2);

你可能感兴趣的鸿蒙文章

harmony 鸿蒙ArkTS(方舟编程语言)

harmony 鸿蒙在build-profile.json5中配置arkOptions

harmony 鸿蒙异步锁

harmony 鸿蒙方舟字节码文件格式

harmony 鸿蒙方舟字节码函数命名规则

harmony 鸿蒙方舟字节码基本原理

harmony 鸿蒙方舟字节码概述

harmony 鸿蒙共享容器

harmony 鸿蒙异步等待

harmony 鸿蒙ArkTS跨语言交互

0  赞