概述

鴻蒙中有兩種共享包灌灾，HAR（Harmony Archive）靜態(tài)共享包和HSP（Harmony Shared Package）動(dòng)態(tài)共享包庶灿。

HAR與HSP都是為了實(shí)現(xiàn)代碼和資源的共享铝量，都可以包含代碼、C++庫(kù)茅信、資源和配置文件魂莫，最大的不同之處在于：HAR中的代碼和資源跟隨使用方編譯淮菠，如果有多個(gè)使用方，它們的編譯產(chǎn)物中會(huì)存在多份相同拷貝存淫；而HSP中的代碼和資源可以獨(dú)立編譯耘斩，運(yùn)行時(shí)在一個(gè)進(jìn)程中代碼也只會(huì)存在一份。

HAR和HSP在APP包中的形態(tài)示意圖

HSP

使用IDE的SharedLibrary模板創(chuàng)建后桅咆，結(jié)構(gòu)如下：

HSP目錄結(jié)構(gòu)

在其中的oh-package.json5中：

{
  "license": "Apache-2.0",
  "devDependencies": {},
  "author": "",
  "name": "my_shared_library",
  "description": "Please describe the basic information.",
  "main": "Index.ets",
  "version": "1.0.0",
  "dependencies": {}
}

有一個(gè)main屬性括授，在這個(gè)屬性指定的文件中export需要的組件和類（包括native類），這個(gè)文件名字隨便起岩饼，但是文件一定要放在該HSP的根目錄下（基于DevEco Studio4.0.3.700）荚虚。

在main指定的Index.ets中：

export { MyHsp } from './src/main/ets/pages/Index'

這里export了一個(gè)組件，其中MyHsp是組件名籍茧。這樣一來版述，使用方就可以import它來使用了。

它的module.json5中：

{
  "module": {
    "name": "my_shared_library",
    "type": "shared",
    "description": "$string:shared_desc",
    "deviceTypes": [
      "phone",
      "tablet",
      "2in1"
    ],
    //標(biāo)識(shí)當(dāng)前Module是否在用戶主動(dòng)安裝的時(shí)候安裝寞冯，表示該Module對(duì)應(yīng)的HAP是否跟隨應(yīng)用一起安裝渴析。- true：主動(dòng)安裝時(shí)安裝。- false：主動(dòng)安裝時(shí)不安裝吮龄。
    "deliveryWithInstall": true,
    "pages": "$profile:main_pages"
  }
}

注意這里的type是shared俭茧。

HAR

使用IDE的StaticLibrary模板創(chuàng)建后，結(jié)構(gòu)如下：

截屏2023-12-28 16.50.17.png

和HSP一樣螟蝙，它的oh-package.json5中的main屬性指定export文件恢恼，在其中配置需要export的組件和類。

它的module.json5中：

{
  "module": {
    "name": "har2",
    "type": "har",
    "deviceTypes": [
      "default",
      "tablet",
      "2in1"
    ]
  }
}

type是har胰默。

依賴和導(dǎo)入

使用HSP和HAR也很簡(jiǎn)單场斑，在使用方module下（一般是entry）的oh-package.json5中：

{
  "license": "",
  //這個(gè)是用于開發(fā)過程中使用的依賴工具漓踢，不會(huì)打包到HAP中
  "devDependencies": {},
  "author": "",
  "name": "entry",
  "description": "Please describe the basic information.",
  "main": "",
  "version": "1.0.0",
  "dependencies": {
    //本地依賴的key可以是自定義，最終會(huì)在oh_modules下生成
    "my-shared-library": "file:../my_shared_library",
    "har1": "file:../har1",
    "har2": "file:../har2"
  }
}

在dependencies屬性下添加依賴項(xiàng)漏隐，前面的key可以自定義喧半，value指定對(duì)應(yīng)共享包module的相對(duì)路徑，然后根據(jù)IDE的提示進(jìn)行ohpm的安裝青责，比如上面的依賴項(xiàng)定義好挺据，build后會(huì)在使用方module下的oh_modules目錄下生成對(duì)應(yīng)的依賴目錄：

截屏2023-12-28 15.09.41.png

注意，key會(huì)作為依賴項(xiàng)的最終導(dǎo)入名脖隶，下面我們來看導(dǎo)入扁耐。

import {MyHsp} from 'my-shared-library'
//如果都導(dǎo)入的話
import('my-shared-library')

//導(dǎo)入har
import {Har1Page} from 'har1'

可以看到，這里可以導(dǎo)入部分产阱，也可以導(dǎo)入所有export的組件和類婉称。注意看from后面的信息，這個(gè)就是前面dependencies中指定的key值构蹬，他們是一一對(duì)應(yīng)的王暗。（測(cè)試的時(shí)候需要用真機(jī)或者模擬器，previewer暫不支持共享包調(diào)用效果）

命名路由

對(duì)應(yīng)module內(nèi)的路由導(dǎo)航庄敛，我們通常使用profile指定的路由表進(jìn)行俗壹，但是在module之間的路由導(dǎo)航時(shí)通常使用命名路由來完成。

router.pushNamedRoute({ name: 'MyHSP' }, (err) => {
  if (err) {
    console.error(`pushNamedRoute failed, code is ${err.code}, message is ${err.message}`);
    return;
  }
  console.info('pushNamedRoute success');
})

比如在一個(gè)HSP中的Entry組件的@Entry屬性上定義一個(gè)路由名字：

@Entry({ routeName: 'MyHSP' })
@Component
export struct MyHsp {
  ...
}

然后在跳轉(zhuǎn)處導(dǎo)入：

import('my-shared-library')

還有一種方式藻烤，即如果使用如下的導(dǎo)入方式的話：

import {MyHsp} from 'my-shared-library'

則MyHsp組件必須保證在組件樹中使用了绷雏，如果沒使用的話進(jìn)行路由跳轉(zhuǎn)則會(huì)失敗。當(dāng)然上面的導(dǎo)航需要依賴好共享包之后才能跳轉(zhuǎn)隐绵，在IDE的測(cè)試時(shí)需要在該處配置好依賴module之众，否則會(huì)報(bào)錯(cuò)：

截屏2023-12-28 15.23.38.png

截屏2023-12-28 15.24.53.png

其實(shí)，命名路由還可以進(jìn)行同一module內(nèi)的路由跳轉(zhuǎn)：

import('./Demo1')

比如這里的Demo1文件存在于調(diào)用方同一目錄下時(shí)的引入方式依许。但是對(duì)于同一module內(nèi)的導(dǎo)航來說棺禾，這種方式有些畫蛇添足，因?yàn)樗枰嘁徊绞謩?dòng)導(dǎo)入的過程峭跳，不如直接使用路由表跳轉(zhuǎn)來的簡(jiǎn)單膘婶、整潔。