OpenHarmony—开发及引用静态共享包（API 9）

HAR(Harmony Archive）是静态共享包，可以包含代码、C++库、资源和配置文件。通过HAR可以实现多个模块或多个工程共享ArkUI组件、资源等相关代码。HAR不同于HAP，不能独立安装运行在设备上，只能作为应用模块的依赖项被引用。

接下来，将简单介绍库模块的工程结构，如下图所示：在这里插入图片描述
相关字段的描述如下，其余字段与Entry或Feature模块相关字段相同

libs：用于存放.so文件。
src > main > cpp > types：用于存放C++ API描述文件，子目录按照so维度进行划分。
src > main > cpp > types > liblibrary >index.d.ts：描述C++接口的方法名、入参、返回参数等信息。
src > main > cpp > types > liblibrary >oh-package.json5：描述so三方包声明文件入口和so包名信息。
src > main > cpp > CMakeLists.txt：CMake配置文件，提供CMake构建脚本。
src > main > cpp > hello.cpp：共享包C++代码源文件。
index.ets：共享包导出声明的入口。

本文将介绍如何创建库模块、如何编译共享包、如何引用共享包资源，以及如何发布共享包。

创建库模块

1.鼠标移到工程目录顶部，单击右键，选择New > Module，在工程中添加模块。

2.在Choose Your Ability Template界面中，选择Static Library，并单击Next。在这里插入图片描述
3.在Configure New Module界面中，设置新添加的模块信息，设置完成后，单击Finish完成创建。

Module name：新增模块的名称。
Language：开发语言。
Device type：支持的设备类型。
Enable native：是否创建一个用于调用C++代码的模块。

创建完成后，会在工程目录中生成库模块及相关文件。

编译库模块

开发完库模块后，选中模块名，然后通过DevEco Studio菜单栏的Build > Make Module ${libraryName}进行编译构建，生成HAR。HAR可用于工程其它模块的引用，或将HAR上传至ohpm仓库，供其他开发者下载使用。在这里插入图片描述
编译构建的HAR可在模块下的build目录下获取，包格式为*.har。
在编译构建HAR时，请注意以下事项：

在编译构建HAR的过程中，不会将模块中的C++代码直接打包进.har文件中，而是将C++代码编译成动态依赖库.so文件放置在.har文件中的libs目录下。
在编译构建HAR的过程中，会生成资源文件ResourceTable.txt，以便编辑器可以对HAR中的资源文件进行联想。因此，如果不使用DevEco
Studio对HAR进行构建，则DevEco Studio的编辑器会无法联想HAR中的资源。

发布HAR

发布打包的HAR，可供其他开发者安装和引用。接下来将介绍如何发布共享包。

1.在库模块中（与src文件夹同一级目录下），添加如下文件：新建README.md文件：在README.md文件中必须包含包的介绍和引用方式，还可以根据包的内容添加更详细介绍。新建CHANGELOG.md文件：填写HAR的版本更新记录。添加LICENSE文件：LICENSE许可文件。

2.重新编译库模块，生成*.har文件。

3.利用工具ssh-keygen生成公、私钥，可执行以下命令：

ssh-keygen -m PEM -t RSA -b 4096 -f your_key_path

NOTE
OHPM包管理器只支持加密密钥认证，请在生成公私钥时输入密码。

4.登录OpenHarmony三方库中心仓官网，单击主页右上角的个人中心，新增OHPM公钥，将公钥文件（your_publicKey.pub）的内容粘贴到公钥输入框中。

5.打开命令行工具，执行如下命令设置私钥路径。

ohpm config set key_path your_key_path

6.登录OpenHarmony三方库中心仓，单击主页右上角的个人中心，复制发布码，获取发布码并配置到 .ohpmrc 文件中，可执行如下命令：

ohpm config set publish_id your_publish_id

7.执行如下命令发布HAR，<HAR路径>需指定为.har文件的具体路径。

ohpm publish <HAR路径>

引用HAR文件和资源

引用三方HAR，包括从仓库进行安装、从本地文件夹和本地压缩包中进行安装三种方式。

引用ohpm仓中的HAR，首先需要设置三方HAR的仓库信息。DevEcoStudio默认仓库地址为OpenHarmony三方库中心仓，如果您需要设置自定义仓库，请DevEcoStudio的Terminal窗口执行如下命令（执行命令前，请确保将DevEcoStudio中ohpm安装bin目录配置在“环境变量-系统变量-PATH”中，第一次配置环境变量后，需重启DevEco Studio）：

ohpm config set registry your_registry1,your_registry2

说明：ohpm支持多个仓库地址，采用英文逗号分隔。

然后通过如下两种方式设置三方包依赖信息：

方式一：在Terminal窗口中，执行如下命令安装三方包，DevEcoStudio会自动在工程的oh-package.json5中自动添加三方包依赖。

ohpm install @ohos/lottie

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

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

依赖设置完成后，需要执行ohpm install命令安装依赖包，依赖包会存储在工程的oh_modules目录下。

ohpm install

引用本地文件夹，有如下两种方式：

方式一：在Terminal窗口中，执行如下命令进行安装，并会在oh-package.json5中自动添加依赖。

ohpm install ../folder

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

"dependencies": {
  "folder": "file:../folder"
}

依赖设置完成后，需要执行ohpm install命令安装依赖包，依赖包会存储在工程的oh_modules目录下。

ohpm install

引用本地HAR包，有如下两种方式：

方式一：在Terminal窗口中，执行如下命令进行安装，并会在oh-package.json5中自动添加依赖。

ohpm install ./package.har

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

"dependencies": {
  "package": "file:./package.har"
}

依赖设置完成后，需要执行ohpm install命令安装依赖包，依赖包会存储在工程的oh_modules目录下。

ohpm install

另外，在安装或卸载共享包时，可在工程的oh-package.json5文件中增加钩子设置，以管理install、uninstall命令的生命周期，配置示例如下：

"hooks": {
    "preInstall": "echo 00 preInstall", // install命令执行之前
    "postInstall": "echo 00 postInstall", // install命令执行之后
    "preUninstall": "echo 00 preUninstall", // uninstall命令执行之前
    "postUninstall": "echo 00 postUninstall"  // uninstall命令执行之后
  }

注意：目前只支持执行当前工程的oh-package.json5文件中hooks，不支持执行依赖中hooks。

在引用共享包时，请注意以下事项：

当前只支持在模块和工程下的oh-package.json5文件中声明dependencies依赖，才会被当做依赖使用，并在编译构建过程中进行相应的处理。

要想成为一名合格的鸿蒙高级开发工程师，以上知识点是必须要掌握的，除此之外，还需要掌握一些鸿蒙应用开发相关的一些技术

为了节省大家一些查找的时间，这边联合几位行业大佬，为大家准备了一份《鸿蒙全栈技术实战项目驱动式教学》的学习导图，从入门到进阶再到南北向开发实战的一整套完整体系，想要学习了解更多鸿蒙开发的相关知识可以借鉴：《鸿蒙HarmonyOS分布式项目实战》
在这里插入图片描述
除了上面整理的思维导图以外，这里还特别整理的一份《鸿蒙 (Harmony OS)开发学习手册》给大家进行参考学习：