概述

鴻蒙中有兩種共享包，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在A(yíng)PP包中的形態(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需要的組件和類(lèi)（包括native類(lèi)），這個(gè)文件名字隨便起，但是文件一定要放在該HSP的根目錄下（基于DevEco Studio4.0.3.700）。

在main指定的Index.ets中：

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

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

它的module.json5中：

{
  "module": {
    "name": "my_shared_library",
    "type": "shared",
    "description": "$string:shared_desc",
    "deviceTypes": [
      "phone",
      "tablet",
      "2in1"
    ],
    //標(biāo)識(shí)當(dāng)前Module是否在用戶(hù)主動(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的組件和類(lèi)。

它的module.json5中：

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

type是har。

依賴(lài)和導(dǎo)入

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

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

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

截屏2023-12-28 15.09.41.png

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

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

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

可以看到，這里可以導(dǎo)入部分，也可以導(dǎo)入所有export的組件和類(lèi)。注意看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í)通常使用命名路由來(lái)完成。

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)入方式的話(huà)：

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

則MyHsp組件必須保證在組件樹(shù)中使用了，如果沒(méi)使用的話(huà)進(jìn)行路由跳轉(zhuǎn)則會(huì)失敗。當(dāng)然上面的導(dǎo)航需要依賴(lài)好共享包之后才能跳轉(zhuǎn)，在IDE的測(cè)試時(shí)需要在該處配置好依賴(lài)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)航來(lái)說(shuō)，這種方式有些畫(huà)蛇添足，因?yàn)樗枰嘁徊绞謩?dòng)導(dǎo)入的過(guò)程，不如直接使用路由表跳轉(zhuǎn)來(lái)的簡(jiǎn)單、整潔。