HAR(Harmony Archive)是靜態(tài)共享包，可以包含代碼、C++庫、資源和配置文件。通過HAR可以實(shí)現(xiàn)多個(gè)模塊或多個(gè)工程共享ArkUI組件、資源等相關(guān)代碼。HAR不同于HAP，不能獨(dú)立安裝運(yùn)行在設(shè)備上，只能作為應(yīng)用模塊的依賴項(xiàng)被引用。

創(chuàng)建HAR模塊

通過DevEco Studio創(chuàng)建一個(gè)HAR模塊，詳見創(chuàng)建庫模塊。HAR模塊默認(rèn)不開啟混淆能力，開啟混淆能力，需要把HAR模塊的build-profile.json5文件中的artifactType字段設(shè)置為obfuscation，配置如下所示：

{
  "apiType": "stageMode",
  "buildOption": {
      "artifactType": "obfuscation"
  }
}

artifactType字段有以下兩種取值，默認(rèn)缺省為original。

original：不混淆。

obfuscation：混淆，目前僅支持uglify混淆。

需要對(duì)代碼資產(chǎn)進(jìn)行保護(hù)時(shí)，建議開啟混淆能力，混淆能力開啟后，DevEco Studio在構(gòu)建HAR時(shí)，會(huì)對(duì)代碼進(jìn)行編譯、混淆及壓縮處理，保護(hù)代碼資產(chǎn)。

注意：artifactType字段設(shè)置為obfuscation時(shí)，apiType字段必須設(shè)置為stageMode，因?yàn)镾tage模型才支持混淆。

HAR開發(fā)注意事項(xiàng)

HAR不支持在配置文件中聲明abilities、extensionAbilities組件。

HAR不支持在配置文件中聲明pages頁面。

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

FA模型與Stage模型的HAR不支持相互引用。

Stage模型的HAR，不能引用AppScope內(nèi)的內(nèi)容。在編譯構(gòu)建時(shí)APPScope中的內(nèi)容不會(huì)打包到HAR中，導(dǎo)致HAR資源引用失敗。

導(dǎo)出HAR的ArkUI組件、接口、資源

index.ets文件是HAR導(dǎo)出聲明文件的入口，HAR需要導(dǎo)出的接口，統(tǒng)一在index.ets文件中導(dǎo)出。index.ets文件是DevEco Studio默認(rèn)自動(dòng)生成的，用戶也可以自定義，在模塊的oh-package.json5文件中的main字段配置入口聲明文件，配置如下所示：

{
  "main": "index.ets"
}

 導(dǎo)出ArkUI組件

ArkUI組件的導(dǎo)出方式與ts的導(dǎo)出方式一致，通過export導(dǎo)出ArkUI組件，示例如下：

// library/src/main/ets/components/MainPage/MainPage.ets
@Component
export struct MainPage {
  @State message: string = 'Hello World'
  build() {
    Row() {
      Column() {
        Text(this.message)
          .fontSize(50)
          .fontWeight(FontWeight.Bold)
      }
      .width('100%')
    }
    .height('100%')
  }
}

 HAR對(duì)外暴露的接口，在index.ets導(dǎo)出文件中聲明如下所示：

// library/index.ets
export { MainPage } from './src/main/ets/components/MainPage/MainPage'

導(dǎo)出ts類和方法

通過export導(dǎo)出ts類和方法，支持導(dǎo)出多個(gè)ts類和方法，示例如下所示：

// library/src/main/ts/test.ets
export class Log {
    static info(msg) {
        console.info(msg);
    }
}

export function func() {
  return "har func";
}

export function func2() {
  return "har func2";
}

 HAR對(duì)外暴露的接口，在index.ets導(dǎo)出文件中聲明如下所示：

// library/index.ets
export { Log } from './src/main/ts/test'
export { func } from './src/main/ts/test'
export { func2 } from './src/main/ts/test'

資源

HAR模塊編譯打包時(shí)會(huì)把資源打包到HAR中。在編譯構(gòu)建HAP時(shí)，DevEco Studio會(huì)從HAP模塊及依賴的模塊中收集資源文件，如果不同模塊下的資源文件出現(xiàn)重名沖突時(shí)，DevEco Studio會(huì)按照以下優(yōu)先級(jí)進(jìn)行覆蓋(優(yōu)先級(jí)由高到低)：

AppScope(僅API9的Stage模型支持)。

HAP包自身模塊。

依賴的HAR模塊，如果依賴的多個(gè)HAR之間有資源沖突，會(huì)按照依賴順序進(jìn)行覆蓋(依賴順序在前的優(yōu)先級(jí)較高)。

引用HAR的ArkUI組件、接口、資源

引用HAR前，需要先配置對(duì)HAR的依賴，配置方式可參考引用HAR文件和資源。

引用HAR的ArkUI組件

HAR的依賴配置成功后，可以引用HAR的ArkUI組件。ArkUI組件的導(dǎo)入方式與ts的導(dǎo)入方式一致，通過import引入HAR導(dǎo)出的ArkUI組件，示例如下所示：

// entry/src/main/ets/pages/index.ets
import { MainPage } from "@ohos/library"

@Entry
@Component
struct Index {
  @State message: string = 'Hello World'
  build() {
    Row() {
      // 引用HAR的ArkUI組件
      MainPage()
      Column() {
        Text(this.message)
          .fontSize(50)
          .fontWeight(FontWeight.Bold)
      }
      .width('100%')
    }
    .height('100%')
  }
}

引用HAR的類和方法

通過import引用HAR導(dǎo)出的ts類和方法，示例如下所示：

// entry/src/main/ets/pages/index.ets
import { Log } from "@ohos/library"
import { func } from "@ohos/library"

@Entry
@Component
struct Index {
  build() {
    Row() {
      Column() {
        Button('Button')
          .onClick(()=>{
            // 引用HAR的類和方法
            Log.info("har msg");
            func();
        })
      }
      .width('100%')
    }
    .height('100%')
  }
}

引用HAR的資源

通過$r引用HAR中的資源，例如在HAR模塊的src/main/resources里添加字符串資源(在string.json中定義，name：hello_har)和圖片資源(icon_har.png)，然后在Entry模塊中引用該字符串和圖片資源的示例如下所示：

// entry/src/main/ets/pages/index.ets
@Entry
@Component
struct Index {
  build() {
    Row() {
      Column() {
        // 引用HAR的字符串資源
        Text($r("app.string.hello_har"))
          .fontSize(50)
          .fontWeight(FontWeight.Bold)
        // 引用HAR的圖片資源
        Image($r("app.media.icon_har"))
      }
      .width('100%')
    }
    .height('100%')
  }
}