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

如何安裝OpenHarmony HAR

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

引用倉庫安裝的HAR：

引用ohpm倉中的HAR，首先需要設置三方HAR的倉庫信息，DevEco Studio默認倉庫地址是[ohpm]，如果您想設置自定義倉庫，請在DevEco Studio的Terminal窗口執行如下命令進行設置（執行命令前，請確保將DevEco Studio中ohpm安裝地址配置在“環境變量-系統變量-PATH”中）：

ohpm config set registry=your_registry1,your_registry2

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

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

ohpm install @ohos/lottie

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

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

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

ohpm install

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

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

ohpm install ../library

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

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

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

ohpm install

在引用OpenHarmony HAR時，請注意以下事項：

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

引用OpenHarmony HAR hml頁面

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

< element name="comp" src="http://www.qldv.cn/images/chaijie_default.png" >< /element >

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

< element name="comp" src="http://www.qldv.cn/images/chaijie_default.png" >< /element >

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

引用OpenHarmony HAR ArkTS頁面

ArkTS是TypeScript的擴展，因此導出和引入的語法與TypeScript一致。在OpenHarmony ohpm模塊中，可以通過export導出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引入導出的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內ts/js方法ts/js方法的導出和引用，與ArkTS頁面的引用相同，即在OpenHarmony ohpm模塊中，可以通過export導出ts/js方法，示例如下所示：

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

然后在其它的ts/js頁面中，通過import引入導出的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內資源支持在OpenHarmony ohpm模塊和依賴OpenHarmony ohpm的模塊中引用OpenHarmony ohpm模塊內的資源。例如在OpenHarmony ohpm模塊的scr/main/resources里添加字符串資源（在string.json中定義，name：hello_ohpm）和圖片資源（icon_ohpm.png）。然后在Entry模塊中引用該字符串資源和圖片資源的示例如下： 當前暫不支持類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%')
   }
}

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

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

審核編輯 黃宇