鸿蒙 HarmonyOS App 如何内测分发

随着鸿蒙系统（HarmonyOS）生态的快速发展，越来越多的开发者开始构建纯血鸿蒙应用（HarmonyOS Native）。为支持开发者高效完成内测流程，蒲公英内测分发平台现已全面支持鸿蒙 App（.hap 文件）的上传、验证与分发，帮助测试人员便捷下载安装体验。

一、鸿蒙 HarmonyOS App 简介

HarmonyOS 是华为推出的新一代多设备操作系统，支持手机、平板、可穿戴等多种终端。开发者通过 ArkTS 编程语言构建的原生鸿蒙应用，以 .hap 为打包格式，并采用鸿蒙官方提供的证书机制进行签名和验证。

.hap 是鸿蒙系统的可安装应用包（类似 Android 的 .apk）；
每个 .hap 必须经过签名，才能在 HarmonyOS 设备上安装；
签名使用的证书为 .p12 格式，需来自华为开发者账号。

签名分为两部分：

对 hap 本体签名（用户在本地完成，蒲公英不参与）；
对 manifest.json5 文件签名（蒲公英平台完成此步骤）；

二、在蒲公英平台分发鸿蒙 App 的操作流程

第一步：上传已签名的 `.hap` 文件

用户需在本地使用开发者证书完成 .hap 文件的签名。上传至蒲公英的平台版本必须为已签名版本。

上传前请确保：

.hap 文件已使用签名工具签名，如华为官方开发工具 DevEco-Studio，具体方法请见华为官方文档：编译打包应用，正确签名后，工具一般会生成名称为 XXXX-signed.hap 的文件；
对 .hap 签名所用的 .p12 证书与即将上传至蒲公英平台的 .p12 文件完全一致；
目前支持鸿蒙的 .hap 文件，暂不支持 .hsp 格式文件。

准备上传

第二步：填写 App 信息（可选）

便于测试人员识别应用，可选择填写以下信息：

应用名称、版本号（蒲公英会自动解析并显示）
更新日志
应用截图
内测说明

这些信息将在分发页面中显示，提升专业度与可读性。

填写App信息

第三步：上传 `.p12` 文件并设置其密码（用于 manifest.json5 签名）

在鸿蒙内测流程中，蒲公英平台会自动生成内测分发所需的manifest.json5文件，且需对 manifest.json5 文件进行签名，以生成有效的安装元数据。因此，开发者（您）需向蒲公英平台提供与 .hap 同源的 .p12 证书及其密码：

.p12 证书您可以在华为开发者平台的 AppGallery Connect 中的 “证书、APP ID和Profile” 中进行下载；
此证书必须与您在第一步中上传的 .hap 文件本身签名使用的证书一致，否则会导致安装失败；
蒲公英不会对 .hap 本体进行签名，仅用于 manifest.json5 文件签名。

上传p12证书

为什么需要 `.p12`？

这是华为规定的验证机制之一。用户侧的 HarmonyOS 设备会校验 manifest.json5 文件签名，确保来源可信。详见：华为官方文档

第四步：获取分发链接，下载安装

完成上传后，蒲公英会自动生成一个可供下载的链接和二维码：

可通过链接或扫码进行下载；
支持分享到微信、邮件、钉钉等方式；
仅支持在 纯血 HarmonyOS NEXT 系统设备中通过浏览器下载安装。

目前 .hap 文件的安装行为受到系统安全策略限制，推荐使用华为自带浏览器打开下载页面。

三、常见问题答疑

Q1：上传 `.hap` 后安装失败，提示签名错误？

请检查以下几点：

.hap 是否已使用本地证书正确签名；
上传至蒲公英的 .p12 是否与签名 .hap 使用的证书一致；
.p12 密码是否正确。

Q2：一个链接支持多人下载安装吗？

支持。下载链接可分享给多个测试用户，平台支持安装统计、设备识别等功能。

Q3：平台是否对 `.hap` 文件做修改？

不会。蒲公英平台不会修改 .hap 文件本体，仅用于对 manifest 文件进行签名处理，确保安装成功。

Q4：设备的 UDID 是否已经添加到 Profile (.p7b) 文件？

类似 iOS 的 Adhoc 分发机制，鸿蒙的 .hap 文件在内测分发时，也需要提前将需要设备（如手机、Pad）的 UDID 添加到 Profile (.p7b) 文件中，否则无法正常安装。

Q5：是否支持 API 上传？

支持。蒲公英提供了 API 用于上传 App 文件，另外，对于鸿蒙 App 来说，首个 App 上传完成后，还需调用 API 上传 p12 文件。具体可见 API 文档

四、更多参考

如需了解鸿蒙官方对内测分发的完整说明，请参考：华为官方文档：HarmonyOS 应用内测分发指南

如在操作过程中有任何疑问，欢迎随时联系蒲公英平台客服或技术支持团队。

Doc index

Problems encountered, contact us →