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.soindex.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