1# 同步方式动态加载native模块 2 3loadNativeModule接口的功能是同步方式动态加载native模块。它的主要目的是在需要某个native模块时才进行加载,从而避免在应用启动时加载不必要的模块。但是使用该接口时会产生加载so耗时,需要开发者自行评估是否会对功能产生影响。 4 5## 函数说明 6 7```js 8loadNativeModule(moduleName: string): Object; 9``` 10 11| 参数 | 说明 | 12| :------------- | :----------------------------- | 13| moduleName | 加载的模块名 | 14 15> **说明** 16> moduleName指的是待加载模块所在的HAP下module.json5中配置的名字。 17> 18> loadNativeModule只局限于在UI主线程中进行模块加载。 19> 20> 该接口功能不论是加载常量字符串还是变量表达式入参,都需要配置依赖。 21 22## loadNativeModule支持的场景 23 24| 场景 | 示例 | 25| :------------- | :----------------------------- | 26| 系统库模块 | 加载@ohos.或@system. | 27| 应用内native模块 | 加载libNativeLibrary.so | 28 29## 使用示例 30 31- **HAP加载系统库模块** 32 33```js 34let hilog: ESObject = loadNativeModule("@ohos.hilog"); 35hilog.info(0, "testTag", "loadNativeModule ohos.hilog success"); 36``` 37 38- **HAP加载Native库** 39 40libentry.so的index.d.ts文件如下 41 42```javascript 43//index.d.ts 44export const add: (a: number, b: number) => number; 45``` 46 471.在加载本地so库时,首先需要在oh-package.json5文件中配置dependencies项 48 49```json 50{ 51 "dependencies": { 52 "libentry.so": "file:../src/main/cpp/types/libentry" 53 } 54} 55``` 56 572.其次,还需要在build-profile.json5中进行配置 58 59```json 60{ 61 "buildOption" : { 62 "arkOptions" : { 63 "runtimeOnly" : { 64 "packages": [ 65 "libentry.so" 66 ] 67 } 68 } 69 } 70} 71``` 72 733.用loadNativeModule加载libentry.so,调用函数add 74 75```js 76let module: ESObject = loadNativeModule("libentry.so"); 77let sum: number = module.add(1, 2); 78``` 79