HPM Part介绍

本章节将介绍OpenHarmony中的HPM Part相关概念,开发者可熟悉以下内容帮助进行HPM Part开发。

Part介绍

Part分类

Part是一个用于表示OpenHarmony分发单元的术语。大致分为两大类:

  • 部件级Part:用于描述模块、部件级别的Part,强调可复用性,分发的内容可以是源代码或二进制文件,通常部件级Part和一个代码仓对应,是代码仓的发布件。

  • 发行版级Part:用于描述某一款操作系统发行版的Part,是由一组依赖的Part清单及如何编译构建该发行版的脚本构成,发行版中包含了一个完整操作系统的各类部件(如驱动、内核、框架、应用),编译后生成的镜像可以用于设备的烧录。

Part构成

一个Part中包含包说明和包内容两部分:

包说明文件包含内容如下:

表1 包说明文件

文件名 含义 是否必须
bundle.json 元数据声明文件 必须
README.md 自述文件 必须
LICENSE 许可协议文本文件 必须
CHANGEME.md 变更日志文件 非必须

包内容文件可以是以下任意内容:

  • 被分发的部件的二进制文件

  • 被分发的部件源代码文件

  • 编译脚本文件

    图1 部件Part和发行版Part的关系

    zh-cn_image_0000001195369804

HPM介绍

HPM是连接消费方和提供方的一个开放的协作平台,全称是OpenHarmony Package Manager(即包管理器),Part是HPM管理的对象。

通过构建统一的中央仓作为分发渠道,以Part作为载体,提供方发布Part,消费方下载使用Part,实现平台上的供需双方共赢。

  • 提供方声明Part的属性,将内容发布到平台上。

  • 消费方通过声明对Part指定版本的依赖,获取到所需的资源。

通过HPM完成提供方和消费方的需求匹配。

图2 HPM功能介绍

zh-cn_image_0000001240409717

HPM主要分为两部分:

  • 客户端的命令行工具:hpm-cli(发布在@ohos/hpm-cli

    hpm-cli是一个跨平台包管理器命令行工具,包含一系列的命令(创建、编译、安装、打包、运行、发布等),开发者使用这些命令完成HPM Part的生命周期管理。

  • 服务器端的资源仓库:DevEco Marketplace

    DevEco Marketplace提供了Part的注册、存储和分类检索等功能,每一个Part都有一个页面显示它的自述文件、依赖关系、历史版本、变更记录、许可协议、下载量、源码仓库地址等信息,开发者可以向资源仓库中发布Part,参与OpenHarmony生态的建设。