共享包概述(HAR)

• OpenHarmony提供了兩種共享包凛澎，HAR（Harmony Archive）
  靜態(tài)共享包罩润，和HSP（Harmony Shared Package）動(dòng)態(tài)共享包检吆。

• HAR與HSP都是為了實(shí)現(xiàn)代碼和資源的共享，都可以包含代碼浴井、C++庫(kù)、資源和配置文件

• HAR與HSP最大的不同之處在于:

  • HAR中的代碼和資源跟隨使用方編譯矿瘦，如果有多個(gè)使用方掐暮，它們的編譯產(chǎn)物中會(huì)存在多份相同拷貝蝎抽；
  • 而HSP中的代碼和資源可以獨(dú)立編譯，運(yùn)行時(shí)在一個(gè)進(jìn)程中代碼也只會(huì)存在一份路克。

1. HSP旨在解決HAR存在的幾個(gè)問(wèn)題：

• 多個(gè)HAP引用相同的HAR樟结，導(dǎo)致的APP包大小膨脹問(wèn)題。
• 多個(gè)HAP引用相同的HAR精算，HAR中的一些狀態(tài)變量無(wú)法共享的問(wèn)題瓢宦。

2. HSP的一些約束：

• HSP及其使用方都必須是Stage模型。
• HSP及其使用方都必須使用esmodule編譯模式殖妇。
• HSP不支持在配置文件中聲明abilities刁笙、extensionAbilities標(biāo)簽。

HSP按照使用場(chǎng)景可以分為應(yīng)用內(nèi)HSP和應(yīng)用間HSP谦趣，應(yīng)用間HSP暫不支持疲吸。

HAR

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

一、創(chuàng)建HAR模塊

1. HAR模塊默認(rèn)不開(kāi)啟混淆能力秦陋，開(kāi)啟混淆能力蔓彩，需要把HAR模塊的build-profile.json5文件中的artifactType字段設(shè)置為obfuscation，詳見(jiàn)創(chuàng)建庫(kù)模塊
   配置如下所示：

 {
    "apiType": "stageMode",
    "buildOption": {
       "artifactType": "obfuscation" // 開(kāi)啟混淆
       // "artifactType": "original" // 不開(kāi)啟混淆
  }}

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

2. HAR開(kāi)發(fā)注意事項(xiàng)

   • HAR不支持在配置文件中聲明abilities顺又、extensionAbilities組件更卒。
   • HAR不支持在配置文件中聲明pages頁(yè)面。
   • 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組件姿骏、接口、資源

1. 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組件

1. ArkUI組件的導(dǎo)出方式與ts的導(dǎo)出方式一致去团，通過(guò)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%')
  }
}

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

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

四土陪、導(dǎo)出ts類和方法

1. 通過(guò)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";
}

2. 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)入方式一致欠拾，通過(guò)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的類和方法

• 通過(guò)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的資源

• 通過(guò)$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%')
  }
}