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'

同样是key-value的形式,key建议使用@ohos/开头,后面名称自定义,value为file:后面跟上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%')
  }
}

Logo

为开发者提供学习成长、分享交流、生态实践、资源工具等服务,帮助开发者快速成长。

更多推荐