鸿蒙HarmonyOS 5.0开辟：应用步伐包-HAR

 往期鸿蒙全套实战文章必看：（文中附带鸿蒙全栈学习资料）

• 鸿蒙开辟核心知识点，看这篇文章就够了
  
• 最新版！鸿蒙HarmonyOS Next应用开辟实战学习路线
  
• 鸿蒙HarmonyOS NEXT开辟技术最全学习路线指南
  
• 鸿蒙应用开辟实战项目，看这一篇文章就够了（部分项目附源码）
  

---

HAR

HAR（Harmony Archive）是静态共享包，可以包罗代码、C++库、资源和配置文件。通过HAR可以实现多个模块或多个工程共享ArkUI组件、资源等相干代码。
使用场景

• 支持应用内共享，也可以发布后供其他应用使用。
  
• 作为二方库，发布到OHPM私仓，供公司内部其他应用使用。
  
• 作为三方库，发布到OHPM中央仓，供其他应用使用。
  
• 多包（HAP/HSP）引用相同的HAR时，会造成多包间代码和资源的重复拷贝，从而导致应用包膨大。
  

约束限定

• HAR不支持在装备上单独安装/运行，只能作为应用模块的依赖项被引用。
  
• HAR不支持在配置文件中声明UIAbility组件与ExtensionAbility组件。
  
• HAR不支持在配置文件中声明pages页面，但是可以包罗pages页面，并通过命名路由的方式举行跳转。
  
• HAR不支持引用AppScope目录中的资源。在编译构建时，AppScope中的内容不会打包到HAR中，因此会导致HAR资源引用失败。
  
• HAR可以依赖其他HAR，但不支持循环依赖，也不支持依赖传递。
  

创建

通过DevEco Studio创建一个HAR模块。
开辟

介绍如何导出HAR的ArkUI组件、接口、资源，供其他应用或当前应用的其他模块引用。
Index.ets文件是HAR导作声明文件的入口，HAR必要导出的接口，统一在Index.ets文件中导出。Index.ets文件是DevEco Studio默认自动生成的，用户也可以自定义，在模块的oh-package.json5文件中的main字段配置入口声明文件，配置如下所示：

1. {
2.   "main": "Index.ets"
3. }

复制代码

导出ArkUI组件

ArkUI组件的导出方式与ts的导出方式一致，通过export导出ArkUI组件，示例如下：

1. // library/src/main/ets/components/mainpage/MainPage.ets
2. @Component
3. export struct MainPage {
4.   @State message: string = 'HAR MainPage';
6.   build() {
7.     Column() {
8.       Row() {
9.         Text(this.message)
10.           .fontSize(32)
11.           .fontWeight(FontWeight.Bold)
12.       }
13.       .margin({ top: '32px' })
14.       .height(56)
15.       .width('624px')
17.       Flex({ justifyContent: FlexAlign.Center, alignItems: ItemAlign.Center, alignContent: FlexAlign.Center }) {
18.         Column() {
19.           Image($r('app.media.pic_empty')).width('33%')
20.           Text($r('app.string.empty'))
21.             .fontSize(14)
22.             .fontColor($r('app.color.text_color'))
23.         }
24.       }.width('100%')
25.       .height('90%')
26.     }
27.     .width('100%')
28.     .height('100%')
29.     .backgroundColor($r('app.color.page_background'))
30.   }
31. }

复制代码

HAR对外袒露的接口，在Index.ets导出文件中声明如下所示：

1. // library/Index.ets
2. export { MainPage } from './src/main/ets/components/mainpage/MainPage';

复制代码

导出ts类和方法

通过export导出ts类和方法，支持导出多个ts类和方法，示例如下所示：

1. // library/src/main/ts/test.ets
2. export class Log {
3.     static info(msg: string) {
4.         console.info(msg);
5.     }
6. }
8. export function func() {
9.   return 'har func';
10. }
12. export function func2() {
13.   return 'har func2';
14. }

复制代码

HAR对外袒露的接口，在Index.ets导出文件中声明如下所示：

1. // library/Index.ets
2. export { Log } from './src/main/ts/test';
3. export { func } from './src/main/ts/test';
4. export { func2 } from './src/main/ts/test';

复制代码

导出native方法

在HAR中也可以包罗C++编写的so。对于so中的native方法，HAR通过以下方式导出，以导出liblibrary.so的加法接口add为例：

1. // library/src/main/ets/utils/nativeTest.ets
2. import native from 'liblibrary.so';
4. export function nativeAdd(a: number, b: number): number {
5.   let result: number = native.add(a, b);
6.   return result;
7. }

复制代码

HAR对外袒露的接口，在Index.ets导出文件中声明如下所示：

1. // library/Index.ets
2. export { nativeAdd } from './src/main/ets/utils/nativeTest';

复制代码

导出资源

在编译构建HAP时，DevEco Studio会从HAP模块及依赖的模块中收集资源文件，如果不同模块下的资源文件出现重名冲突时，DevEco Studio会按照以下优先级举行覆盖（优先级由高到低）：

• AppScope（仅API9的Stage模子支持）。
  
• HAP包自身模块。
  
• 依赖的HAR模块，如果依赖的多个HAR之间有资源冲突，会按照工程oh-package.json5中dependencies下的依赖次序举行覆盖，依赖次序在前的优先级较高。例如下方示例中dayjs和lottie中包罗同名文件时，会优先使用dayjs中的资源。       说明：
      如果在AppScope/HAP模块/HAR模块的国际化目录中配置了资源，在相同的国际化限定词下，归并的优先级也遵照上述规则。同时，国际化限定词中配置的优先级高于在base中的配置。如：在AppScope的base中配置了资源字段，在HAR模块的en_US中配置了同样的资源字段，则在en_US的使用场景中，会更优先使用HAR模块中配置的资源字段。
  

1. // oh-package.json5
2. {
3.   "dependencies": {
4.     "dayjs": "^1.10.4",
5.     "lottie": "^2.0.0"
6.   }
7. }

复制代码

使用

介绍如何配置HAR依赖，并引用HAR的ArkUI组件、接口、资源。
引用HAR前，必要先配置对HAR的依赖。
引用HAR的ArkUI组件

HAR的依赖配置成功后，可以引用HAR的ArkUI组件。ArkUI组件的导入方式与ts的导入方式一致，通过import引入HAR导出的ArkUI组件，示例如下所示：

1. // entry/src/main/ets/pages/IndexSec.ets
2. import { MainPage } from 'library';
4. @Entry
5. @Component
6. struct IndexSec {
7.   build() {
8.     Row() {
9.       // 引用HAR的ArkUI组件
10.       MainPage()
11.     }
12.     .height('100%')
13.   }
14. }

复制代码

引用HAR的ts类和方法

通过import引用HAR导出的ts类和方法，示例如下所示：

1. // entry/src/main/ets/pages/Index.ets
2. import { Log } from 'library';
3. import { func } from 'library';
5. @Entry
6. @Component
7. struct Index {
8.   @State message: string = 'Hello World';
10.   build() {
11.     Column() {
12.       Text(this.message)
13.         .fontFamily('HarmonyHeiTi')
14.         .fontWeight(FontWeight.Bold)
15.         .fontSize(32)
16.         .fontWeight(700)
17.         .fontColor($r('app.color.text_color'))
18.         .textAlign(TextAlign.Start)
19.         .margin({ top: '32px' })
20.         .width('624px')
22.       //引用HAR的ts类和方法
23.       Button($r('app.string.button'))
24.         .id('button')
25.         .height(48)
26.         .width('624px')
27.         .margin({ top: '4%' })
28.         .type(ButtonType.Capsule)
29.         .fontFamily('HarmonyHeiTi')
30.         .borderRadius($r('sys.float.ohos_id_corner_radius_button'))
31.         .backgroundColor($r('app.color.button_background'))
32.         .fontColor($r('sys.color.ohos_id_color_foreground_contrary'))
33.         .fontSize($r('sys.float.ohos_id_text_size_button1'))
34.         .onClick(() => {
35.           // 引用HAR的类和方法
36.           Log.info('har msg');
37.           this.message = 'func return: ' + func();
38.         })
39.     }
40.     .width('100%')
41.     .backgroundColor($r('app.color.page_background'))
42.     .height('100%')
43.   }
44. }

复制代码

引用HAR的native方法

通过import引用HAR导出的native方法，示例如下所示：

1. // entry/src/main/ets/pages/Index.ets
2. import { nativeAdd } from 'library';
4. @Entry
5. @Component
6. struct Index {
7.   @State message: string = 'Hello World';
9.   build() {
10.     Column() {
11.       Text(this.message)
12.         .fontFamily('HarmonyHeiTi')
13.         .fontWeight(FontWeight.Bold)
14.         .fontSize(32)
15.         .fontWeight(700)
16.         .fontColor($r('app.color.text_color'))
17.         .textAlign(TextAlign.Start)
18.         .margin({ top: '32px' })
19.         .width('624px')
21.       //引用HAR的native方法
22.       Button($r('app.string.native_add'))
23.         .id('nativeAdd')
24.         .height(48)
25.         .width('624px')
26.         .margin({ top: '4%', bottom: '6%' })
27.         .type(ButtonType.Capsule)
28.         .fontFamily('HarmonyHeiTi')
29.         .borderRadius($r('sys.float.ohos_id_corner_radius_button'))
30.         .backgroundColor($r('app.color.button_background'))
31.         .fontColor($r('sys.color.ohos_id_color_foreground_contrary'))
32.         .fontSize($r('sys.float.ohos_id_text_size_button1'))
33.         .onClick(() => {
34.           this.message = 'result: ' + nativeAdd(1, 2);
35.         })
36.     }
37.     .width('100%')
38.     .backgroundColor($r('app.color.page_background'))
39.     .height('100%')
40.   }
41. }

复制代码

引用HAR的资源

通过$r引用HAR中的资源，例如在HAR模块的src/main/resources里添加字符串资源（在string.json中定义，name：hello_har）和图片资源（icon_har.png），然后在Entry模块中引用该字符串和图片资源的示例如下所示：

1. // entry/src/main/ets/pages/Index.ets
2. @Entry
3. @Component
4. struct Index {
5.   @State message: string = 'Hello World';
7.   build() {
8.     Column() {
9.       // 引用HAR的字符串资源
10.       Text($r('app.string.hello_har'))
11.         .id('stringHar')
12.         .fontFamily('HarmonyHeiTi')
13.         .fontColor($r('app.color.text_color'))
14.         .fontSize(24)
15.         .fontWeight(500)
16.         .margin({ top: '40%' })
18.       List() {
19.         ListItem() {
20.           // 引用HAR的图片资源
21.           Image($r('app.media.icon_har'))
22.             .id('iconHar')
23.             .borderRadius('48px')
24.         }
25.         .margin({ top: '5%' })
26.         .width('312px')
27.       }
28.       .alignListItem(ListItemAlign.Center)
29.     }
30.     .width('100%')
31.     .backgroundColor($r('app.color.page_background'))
32.     .height('100%')
33.   }
34. }

复制代码

编译

HAR可以作为二方库和三方库提供给其他应用使用，如果必要对代码资产举行保护时，建议开启混淆本领。
混淆本领开启后，DevEco Studio在构建HAR时，会对代码举行编译、混淆及压缩处理，保护代码资产。
   说明：
  编译HAR时，如果没有开启混淆本领，编译后的产物是源码文件。
  仅Stage模子的ArkTS工程支持混淆。
  HAR开启混淆后资源ID为-1，ResourceManager等通过ID获取资源的API不再生效。
  HAR模块原先默认开启混淆本领，会对API 10及以上的HAR模块，且编译模块为release时，自动举行简单的代码混淆；从DevEco Studio 5.0.3.600开始，新建工程默认关闭代码混淆功能，可以在HAR模块的build-profile.json5文件中的ruleOptions字段下的enable举行开启混淆，配置如下所示：

1. {
2.   "apiType": "stageMode",
3.   "buildOption": {
4.   },
5.   "buildOptionSet": [
6.     {
7.       "name": "release",
8.       "arkOptions": {
9.         "obfuscation": {
10.           "ruleOptions": {
11.             "enable": true,
12.             "files": [
13.               "./obfuscation-rules.txt"
14.             ]
15.           },
16.           "consumerFiles": [
17.             "./consumer-rules.txt"
18.           ]
19.         }
20.       }
21.     },
22.   ],
23.   "targets": [
24.     {
25.       "name": "default"
26.     }
27.   ]
28. }

复制代码

编译生成TS文件

   说明：
  在HAR中使用Sendable时，开启该配置。
  使用限定
在依赖TS HAR时，禁止引用TS HAR中的ArkUI组件。
HAR模块中arkts文件编译后，默认产物为js文件，想要将产物修改为ts文件，可以在HAR模块下的module.json5文件中将"metadata"字段下的"name"设置为“UseTsHar”，配置如下所示：

1. {
2.   "module": {
3.     "name": "TsClosedHar",
4.     "type": "har",
5.     "deviceTypes": [
6.       "default",
7.       "tablet",
8.       "2in1"
9.     ],
10.     "metadata": [
11.       {
12.         "name": "UseTsHar",
13.         "value": "true"
14.       }
15.     ]
16.   }
17. }

复制代码

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。