概述
HAR（Harmony Archive）是OpenHarmony靜態共享包。可以包含js/ts代碼、c++庫、資源和配置文件。通過HAR，可以實現多個模塊或者多個工程共享ArkUI組件、資源等相關代碼。HAR不同于HAP，不能獨立安裝運行在設備上，只能作為應用模塊的依賴項被引用。
如何安裝依賴har
三方庫的地址配置
要想引用三方倉中的har，首先需要設置三方HAR的倉庫信息。鴻蒙默認的倉庫地址是
[https://repo.harmonyos.com/ohpm/](https://repo.harmonyos.com/ohpm/)
如果想設置其他的倉庫地址，可以通過以下命令設置：
ohpm config set registry=your_registry1,your_registry2
或者打開.ohpmrc文件自己配置，文件位置：~/.ohpm/.ohpmrc
里面內容：
registry=https://repo.harmonyos.com/ohpm/
strict_ssl=true
publish_registry=https://repo.harmonyos.com/ohpm/
log_level=info
fetch_timeout=60000
publish_id=17KSZKU1PZ
key_path=/Users/xxx/.ssh/id_ohpm
依賴三方庫中的har
在命令行中執行install命令
ohpm install @ohos/lottie
執行完上面命令后DevEco Studio會自動在oh-package.json5下面加上lottie的依賴信息
"dependencies": {
"@ohos/lottie": "^2.0.9"
},
使用這種方式要注意執行命令的目錄，會添加到當前目錄下的oh-package.json5中。
自己在oh-package.json5中添加依賴信息
"dependencies": {
"@ohos/lottie": "^2.0.9"
},
執行執行如下命令
ohpm install
推薦使用這種方式，自主可控
安裝好的依賴庫存放在oh_modules目錄下：
[圖片上傳失敗...(image-80a7e4-1713431947434)]
依賴自定義的Library
在命令行中依賴
創建module library,之后在terminal中切到Entry項目中添加依賴
ohpm install ../library
在工程項目下的oh-package.json5中直接依賴
"dependencies": {
"@ohos/library": "file:../library"
}
之后執行ohpm install命令
如何把自定義的Library給他人使用
方式一：直接把har文件發送給對方
使用者在entry目錄下新建lib目錄，把har文件放到該目錄下
[圖片上傳失敗...(image-83d39e-1713431947434)]
在oh-package.json5中添加依賴
"dependencies": {
"@ohos/log_fishing": "file:./lib/logfishing.har"
}
sync之后就可以正常使用了
方式二：把自定義的Library上傳到三方倉或自定義倉庫中
上傳到三方倉庫請看上篇文章，自定義倉庫如何搭建會在后續文章更新。具體使用方式和依賴三方倉中的資源庫一樣
如何使用har中提供內容
使用har中的ArkTS頁面
在Library中，通過export導出ArkTs頁面，示例如下：
// library/src/main/ets/components/mainpage/MainPage.ets
@Component
export struct MainPage {
@State message: string = 'HAR MainPage';
build() {
Column() {
Row() {
Text(this.message)
.fontSize(32)
.fontWeight(FontWeight.Bold)
}
.margin({ top: '32px' })
.height(56)
.width('624px')
Flex({ justifyContent: FlexAlign.Center, alignItems: ItemAlign.Center, alignContent: FlexAlign.Center }) {
Column() {
Image($r('app.media.pic_empty')).width('33%')
Text($r('app.string.empty'))
.fontSize(14)
.fontColor($r('app.color.text_color'))
}
}.width('100%')
.height('90%')
}
.width('100%')
.height('100%')
.backgroundColor($r('app.color.page_background'))
}
}
Har對外暴露接口：
// library/Index.ets
export { MainPage } from './src/main/ets/components/mainpage/MainPage';
使用har中的arkTs頁面
// entry/src/main/ets/pages/IndexSec.ets
import { MainPage } from 'library';
@Entry
@Component
struct IndexSec {
build() {
Row() {
// 引用HAR的ArkUI組件
MainPage()
}
.height('100%')
}
}
使用har中的方法
通過export導出方法
// library/src/main/ts/test.ts
export function func() {
return 'har func';
}
export function func2() {
return 'har func2';
}
har對外暴露的接口，在Index.ets導出文件中聲明如下所示：
// library/Index.ets
export { func } from './src/main/ts/test';
export { func2 } from './src/main/ts/test';
使用har中的方法
// entry/src/main/ets/pages/Index.ets
import { Log } from 'library';
import { func } from 'library';
@Entry
@Component
struct Index {
@State message: string = 'Hello World';
build() {
Column() {
Text(this.message)
.fontFamily('HarmonyHeiTi')
.fontWeight(FontWeight.Bold)
.fontSize(32)
.fontWeight(700)
.fontColor($r('app.color.text_color'))
.textAlign(TextAlign.Start)
.margin({ top: '32px' })
.width('624px')
Button($r('app.string.button'))
.id('button')
.height(48)
.width('624px')
.margin({ top: '4%' })
.type(ButtonType.Capsule)
.fontFamily('HarmonyHeiTi')
.borderRadius($r('sys.float.ohos_id_corner_radius_button'))
.backgroundColor($r('app.color.button_background'))
.fontColor($r('sys.color.ohos_id_color_foreground_contrary'))
.fontSize($r('sys.float.ohos_id_text_size_button1'))
.onClick(() => {
// 引用HAR的類和方法
Log.info('har msg');
this.message = 'func return: ' + func();
})
}
.width('100%')
.backgroundColor($r('app.color.page_background'))
.height('100%')
}
}
使用har中native方法
導出native方法
// library/src/main/ets/utils/nativeTest.ts
import native from 'liblibrary.so';
export function nativeAdd(a: number, b: number): number {
let result: number = native.add(a, b);
return result;
}
這里實際上是用Ts包了一層，導出的還是ts方法
使用har中的資源
library打包時會把資源一同打包的har中。在編譯構建HAP時，DevEco Studio會從HAP模塊及依賴的模塊中收集資源文件，如果不同模塊下的資源文件出現重名沖突時，DevEco Studio會按照以下優先級進行覆蓋（優先級由高到低）：
- AppScope（僅API9的Stage模型支持）。
- HAP包自身模塊。
- 依賴的HAR模塊，如果依賴的多個HAR之間有資源沖突，會按照工程oh-package.json5中dependencies下的依賴順序進行覆蓋，依賴順序在前的優先級較高。
例如下方示例中dayjs和lottie中包含同名文件時，會優先使用dayjs中的資源。
// oh-package.json5
{
"dependencies": {
"dayjs": "^1.10.4",
"lottie": "^2.0.0"
}
}
引用har中的資源
// entry/src/main/ets/pages/Index.ets
@Entry
@Component
struct Index {
@State message: string = 'Hello World';
build() {
Column() {
// 引用HAR的字符串資源
Text($r('app.string.hello_har'))
.id('stringHar')
.fontFamily('HarmonyHeiTi')
.fontColor($r('app.color.text_color'))
.fontSize(24)
.fontWeight(500)
.margin({ top: '40%' })
List() {
ListItem() {
// 引用HAR的圖片資源
Image($r('app.media.icon_har'))
.id('iconHar')
.borderRadius('48px')
}
.margin({ top: '5%' })
.width('312px')
}
.alignListItem(ListItemAlign.Center)
}
.width('100%')
.backgroundColor($r('app.color.page_background'))
.height('100%')
}
}
