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

如何安裝OpenHarmony HAR

引用三方HAR，包括從倉庫進(jìn)行安裝和從本地庫模塊中進(jìn)行安裝兩種方式。

引用倉庫安裝的HAR：

引用ohpm倉中的HAR，首先需要設(shè)置三方HAR的倉庫信息，DevEco Studio默認(rèn)倉庫地址是[ohpm]，如果您想設(shè)置自定義倉庫，請?jiān)贒evEco Studio的Terminal窗口執(zhí)行如下命令進(jìn)行設(shè)置（執(zhí)行命令前，請確保將DevEco Studio中ohpm安裝地址配置在“環(huán)境變量-系統(tǒng)變量-PATH”中）：

ohpm config set registry=your_registry1,your_registry2

說明：ohpm支持多個倉庫地址，采用英文逗號分隔。 然后通過如下兩種方式設(shè)置三方包依賴信息：

• 方式一：在Terminal窗口中，執(zhí)行如下命令安裝三方包，DevEco Studio會自動在工程的oh-package.json5中自動添加三方包依賴。

ohpm install @ohos/lottie

• 方式二：在工程的oh-package.json5中設(shè)置三方包依賴，配置示例如下：

"dependencies": { "@ohos/lottie": "^2.0.0"}

依賴設(shè)置完成后，需要執(zhí)行ohpm install命令安裝依賴包，依賴包會存儲在工程的oh_modules目錄下。

ohpm install

引用本地庫模塊的文件和資源：

• 方式一：在Terminal窗口中，執(zhí)行如下命令進(jìn)行安裝，并會在oh-package5.json中自動添加依賴。

ohpm install ../library

• 方式二：在工程的oh-package.json5中設(shè)置三方包依賴，配置示例如下：

"dependencies": {
   "@ohos/library": "file:../library"
}

依賴設(shè)置完成后，需要執(zhí)行ohpm install命令安裝依賴包，依賴包會存儲在工程的oh_modules目錄下。

ohpm install

在引用OpenHarmony HAR時，請注意以下事項(xiàng)：

• 當(dāng)前只支持在模塊和工程下的oh-package.json5文件中聲明dependencies依賴，才會被當(dāng)做OpenHarmony依賴使用，并在編譯構(gòu)建過程中進(jìn)行相應(yīng)的處理。
• 引用的模塊的compileSdkVersion不能低于其依賴的OpenHarmony ohpm三方包（可在oh_modules目錄下，找到引用的ohpm包的src > main > module.json5 中查看）。

引用OpenHarmony HAR hml頁面

在JS工程范式中，組件功能由hml承載，開發(fā)者可以在JS工程的hml頁面通過標(biāo)簽來引入OpenHarmony HAR中的共享hml頁面，示例如下：

< element name="comp" src="http://wenjunhu.com/images/chaijie_default.png" >< /element >

其中，@ohos/library為OpenHarmony HAR的包名，hml頁面的路徑為OpenHarmony HAR中的相對路徑。
隨后便可以通過設(shè)置的name來使用該element元素，以引用OpenHarmony HAR中的hml頁面，示例如下：

< element name="comp" src="http://wenjunhu.com/images/chaijie_default.png" >< /element >

< div class="container" >
   < comp >< /comp >
   < text class="title" >
      {{ $t('strings.hello') }} {{ title }}
   < /text >
< /div >

引用OpenHarmony HAR ArkTS頁面

ArkTS是TypeScript的擴(kuò)展，因此導(dǎo)出和引入的語法與TypeScript一致。在OpenHarmony ohpm模塊中，可以通過export導(dǎo)出ArkTS頁面，示例如下：

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

然后在其它模塊中通過import引入導(dǎo)出的ArkTS頁面，示例如下所示：

// entry/MainAbility/pages/index.ets

import { MainPage } from "@ohos/library"
@Entry
@Component
struct Index {
   @State message: string = 'Hello World' 
   build() { 
      Column() { 
         MainPage() 
         Row() { 
            Text(this.message)
            .fontSize(50)
            .fontWeight(FontWeight.Bold)
         }
         .width('100%')
      } 
      .height('10%') 
   }
}

引用OpenHarmony HAR內(nèi)ts/js方法ts/js方法的導(dǎo)出和引用，與ArkTS頁面的引用相同，即在OpenHarmony ohpm模塊中，可以通過export導(dǎo)出ts/js方法，示例如下所示：

// library/index.js
export function func() {
   return "[ohpm] func1";
}

然后在其它的ts/js頁面中，通過import引入導(dǎo)出的ts/js方法，示例如下所示：

// entry/src/main/js/MainAbility/pages/index/index.js
import {func} from "@ohos/library"
export default {
   data: {
      title: ""
   },
   onInit() {
      this.title = func();
   }
}

引用OpenHarmony HAR內(nèi)資源支持在OpenHarmony ohpm模塊和依賴OpenHarmony ohpm的模塊中引用OpenHarmony ohpm模塊內(nèi)的資源。例如在OpenHarmony ohpm模塊的scr/main/resources里添加字符串資源（在string.json中定義，name：hello_ohpm）和圖片資源（icon_ohpm.png）。然后在Entry模塊中引用該字符串資源和圖片資源的示例如下： 當(dāng)前暫不支持類Web范式引用i18n文件中的國際化資源。

// entry/src/main/ets/MainAbility/pages/index.ets
@Entry
@Component
struct Index {
   @State message: string = 'Hello World'
   build() {
      Column() {
         Row() {
            Text($r("app.string.hello_ohpm")) // 字符串資源
              .fontSize(40)
              .fontWeight(FontWeight.Bold)
         }
         .width('50%')
         Image($r("app.media.icon_ohpm")) // 圖片資源
      }
      .height('100%')
   }
}

在編譯構(gòu)建HAP中，DevEco Studio會從HAP模塊及依賴的模塊中收集資源文件，如果不同模塊的相同限定詞目錄下的資源文件出現(xiàn)重名沖突時，DevEco Studio會按照以下優(yōu)先級進(jìn)行覆蓋（優(yōu)先級由高到低）：

• AppScope（僅API 9的Stage模型支持）
• HAP包自身模塊
• 依賴的OpenHarmonyHarmony ohpm模塊

審核編輯 黃宇