更多交流学习，欢迎加入开源鸿蒙 PC 社区：

在 PC 社区网站申请新建项目：

目录

. 什么是 HNP？老实说，

定义

HNP是 OpenHarmony 程序的原生包格式。用于打包原生程序和库，可以把它类比为 Windows 的 MSI、Linux 的 DEB/RPM——是鸿蒙环境中分发原生应用和库的标准化容器。

主要价值

HNP 不是必须的——理解它的定位

A common misconception is that every third‑party library or CLI tool must be packaged as an HNP. The truth is:

个人开发调试 ❌ 直接拷贝已签名二进制到鸿蒙 PC 即可运行

通过 vcpkg 移植 ❌ vcpkg 工作流中不涉及 HNP

通过 lycium 移植 ✅ 框架自动调用 hnpcli 打包为 HNP 并集成到 HAP

集成到 HAP 应用分发 ✅ 只有 HNP 包才能被程序管理

通过应用行业市场分发 ✅ 必须有 HNP 才能上架 App Store 进行分发

You can think of it as a “nice‑to‑have” standardization layer—binaries can run without it,but with an HNP y become first‑class citizens of HarmonyOS package manager.

. HNP 包的本质与格式

本质就是一个 ZIP 压缩包

An .hnp file is just a ZIP archive. Its internal layout follows a conventional convention:

xxx.hnp
├── bin/
│ └── pngquant # 可执行文件
├── lib/
│ └── libpng.so* # 共享库
├── hnp.json # 元数据配置文件
└── ... # 其他资源

You can verify its type with file command:

$ file app.hnp
app.hnp: Zip archive data。at least v2.0 to extract,compression method=deflate

公有 HNP 与私有 HNP 区别

The system automatically creates soft links for binaries under /data/service/hnp/bin.,which is part of default PATH.

. hnp.json 配置文件详解

The hnp.json**` file resides at root of package and defines identity,version,and installation rules.

最小配置示例

{
"type"这方面，"hnp-config","name": "tree","version": "1.0.0","install": {}
}

官方标准示例

{
"type"的观点是，"hnp-config","name": "hnpsample","version": "1.0.0","install": {
"links":
}
}