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)开发学习手册》给大家进行参考学习:
一、入门必看
1.应用开发导读(ArkTS)
2.......
二、HarmonyOS 概念
1.系统定义
2.技术架构
3.技术特性
4.系统安全
5...
三、如何快速入门?《鸿蒙4.0源码开发架构分析pdf》
1.基本概念
2.构建第一个ArkTS应用
3.构建第一个JS应用
4.......
四、开发基础知识
1.应用基础知识
2.配置文件
3.应用数据管理
4.应用安全管理
5.应用隐私保护
6.三方应用调用管控机制
7.资源分类与访问
8.学习ArkTS语言
9.......
五、基于ArkTS 开发
1.Ability开发
2.UI开发
3.公共事件与通知
4.窗口管理
5.媒体
6.安全
7.网络与链接
8.电话服务
9.数据管理
10.后台任务(Background Task)管理
11.设备管理
12.设备使用信息统计
13.DFX
14.国际化开发
15.折叠屏系列
16.......
更多了解更多鸿蒙开发的相关知识可以参考:《一小时快速认识HarmonyOS》