【鸿蒙南向】移植案例与原理 - HPM包描述文件bundle.json

---

📚往期笔录记录🔖：

🔖鸿蒙（HarmonyOS）北向开发知识点记录~
🔖鸿蒙（OpenHarmony）南向开发保姆级知识点汇总~
🔖鸿蒙应用开发与鸿蒙系统开发哪个更有前景？
🔖嵌入式开发适不适合做鸿蒙南向开发？看完这篇你就了解了~
🔖对于大前端开发来说，转鸿蒙开发究竟是福还是祸？
🔖鸿蒙岗位需求突增！移动端、PC端、IoT到底该怎么选？
🔖记录一场鸿蒙开发岗位面试经历~
🔖持续更新中……

---

发现各个子系统、组件、三方库目录下都添加了bundle.json，了解下该文件的用途、用法并快速记录下。

1、HPM Bundle的基本概念

Bundle是OpenHarmony中一个用来表示分发单元的术语，等同于包，一个Bundle中通常包含以下内容：

• 被分发的二进制文件（二进制类型）
• 被分发的源代码文件（源代码/代码片段类型）
• 编译脚本（发行版类型需要）
• 自身的说明文件
  • bundle.json：元数据声明（名称，版本，依赖等）
  • LICENSE：许可协议文本
  • README.md：自述文件
  • CHANGELOG.md：变更日志（可选）

一个Bundle被发布到HPM服务器（ https://hpm.harmonyos.com ）后，另外一些开发者就可以通过hpm包管理器下载安装使用 。一个Bundle在命名空间内拥有唯一的名称（命名格式为：@scope/name），可以进行独立的版本演进。

一个bundle包通常具有如下代码组织结构:

demo
├── headers            # 头文件（样例）
│   └── main.h
└── src                # 源代码（样例）
│    └─ main.c
├── bundle.json        # 元数据声明文件
└── LICENSE            # 许可协议文本
└── Makefile           # 编译描述文件（样例）
└── README.md          # Bundle的自述文件