HarmonyOS工程har的打包与引用

HAR（Harmony Archive）是静态共享包，可以包含代码、C++库、资源和配置文件。通过HAR可以实现多个模块或多个工程共享ArkUI组件、资源等相关代码。HAR不同于HAP，不能独立安装运行在设备上，只能作为应用模块的依赖项被引用。

打包har

！工程为Stage模型

在工程中创建HAR模块，New Module选择Static Library

在该Module的build-profile.json5中添加"artifactType": "obfuscation"开启代码混淆

 在该模块中编写业务代码

……

需要在har外部调用的ArkUI组件、TS类、方法，使用 export 修饰（不要添加default）。

方法可以作为类的成员导出，也可以单独导出。

Module根目录下的index.ets是HAR导出声明文件的入口，HAR需要导出的接口，统一在index.ets文件中导出。

注意事项

1.HAR不支持在配置文件中声明abilities、extensionAbilities组件。

2.HAR不支持在配置文件中声明pages页面。

3.HAR不支持在build-profile.json5文件的buildOption中配置worker。

4.FA模型与Stage模型的HAR不支持相互引用。

5.Stage模型的HAR，不能引用AppScope内的内容。在编译构建时APPScope中的内容不会打包到HAR中，导致HAR资源引用失败。

构建

编写完成后再工具栏中选择Build->Make Module ‘Module名称’（比如我的Module是vpn）

 构建完成后在build目录下就可以获取到har包

引用har

把har放到想要使用的工程的任意目录下，习惯放在Module的libs目录

然后在Module的oh-package.json5文件中引用该har

"@ohos/vpn": 'file:./libs/vpn.har'

修改完成点击Sync Now，依赖包会存储在工程的oh_modules目录下

注意：覆盖修改har之后需要删除oh_module目录重新生成，否则可能不更新

在代码中使用该har

import { Add } from '@ohos/vpn'
import { func2 } from '@ohos/vpn'
import { MainPage } from '@ohos/vpn'import promptAction from '@ohos.promptAction'@Entry
@Component
struct Index {@State message: string = 'Hello World'build() {Row() {MainPage()//引用har的ArkUI组件Column() {Text(this.message).fontSize(50).fontWeight(FontWeight.Bold).onClick(() => {const a = new Add()//引用har的TS类const b = a.add(1, 3)const c = func2()  //引用har的方法promptAction.showToast({ message: c + '' })})}.width('100%')}.height('100%')}
}