剑湖一阵雨HarmonyOS 6
HarmonyOS6.0是否支持独立下载HAP进行安装
除了应用市场外,是否支持独立下载HAP进行安装。
类似Android手机上,A手机可以通过华为分享一个APK文件到B手机,B手机打开分享过来的APK文件进行安装。
或者A手机从网盘上下载一个APK文件,在手机上打开该APK文件触发安装。
华夏
鸿蒙 HarmonyOS App 如何内测分发
随着鸿蒙系统(HarmonyOS)生态的快速发展,越来越多的开发者开始构建纯血鸿蒙应用(HarmonyOS Native)。为支持开发者高效完成内测流程,蒲公英内测分发平台现已全面支持鸿蒙 App(.hap 文件)的上传、验证与分发,帮助测试人员便捷下载安装体验。
一、鸿蒙 HarmonyOS App 简介
HarmonyOS 是华为推出的新一代多设备操作系统,支持手机、平板、可穿戴等多种终端。开发者通过 ArkTS 编程语言构建的原生鸿蒙应用,以 .hap 为打包格式,并采用鸿蒙官方提供的证书机制进行签名和验证。
.hap是鸿蒙系统的可安装应用包(类似 Android 的.apk);- 每个
.hap必须经过签名,才能在 HarmonyOS 设备上安装; - 签名使用的证书为
.p12格式,需来自华为开发者账号。
签名分为三部分:
- 对 hap 本体签名(用户在本地完成,蒲公英不参与);
- 对 p7b 文件签名(即 Profile 文件) (用户在本地或华为 AppGallery Connect 完成,蒲公英不参与)
- 对 manifest.json5 文件签名(用户需将 p12 文件上传到蒲公英平台后,蒲公英平台完成此步骤);
注意:以上三部分签名需要完全一致才可正确安装 App
二、在蒲公英平台分发鸿蒙 App 的操作流程
第一步:上传已签名的 .hap 文件
用户需在本地使用开发者证书完成 .hap 文件的签名。上传至蒲公英的平台版本必须为已签名版本。
上传前请确保:
.hap文件已使用签名工具签名,如华为官方开发工具 DevEco-Studio,具体方法请见 华为官方文档:编译打包应用,正确签名后,工具一般会生成名称为 XXXX-signed.hap 的文件;- 对
.hap签名所用的.p12证书与即将上传至蒲公英平台的.p12文件完全一致; - 目前支持鸿蒙的
.hap文件。
第二步:填写 App 信息(可选)
便于测试人员识别应用,可选择填写以下信息:
- 应用名称、版本号(蒲公英会自动解析并显示)
- 更新日志
- 应用截图
- 内测说明
这些信息将在分发页面中显示,提升专业度与可读性。
第三步:上传 .p12 文件并设置其密码(用于 manifest.json5 签名)
在鸿蒙内测流程中,蒲公英平台会自动生成内测分发所需的manifest.json5文件,且需对 manifest.json5 文件进行签名,以生成有效的安装元数据。因此,开发者(您)需向蒲公英平台提供与 .hap 同源的 .p12 证书及其密码:
.p12证书您可以在华为开发者平台的 AppGallery Connect 中的 “证书、APP ID和Profile” 中进行下载;- 此证书必须与您在第一步中上传的
.hap文件本身签名使用的证书一致,否则会导致安装失败; - 蒲公英不会对
.hap本体进行签名,仅用于manifest.json5文件签名。
为什么需要 .p12?
这是华为规定的验证机制之一。用户侧的 HarmonyOS 设备会校验 manifest.json5 文件签名,确保来源可信。详见:华为官方文档
第四步:获取分发链接,下载安装
完成上传后,蒲公英会自动生成一个可供下载的链接和二维码:
- 可通过链接或扫码进行下载;
- 支持分享到微信、邮件、钉钉等方式;
- 仅支持在 纯血 HarmonyOS NEXT 系统设备中通过浏览器下载安装。
目前 .hap 文件的安装行为受到系统安全策略限制,推荐使用华为自带浏览器打开下载页面。
三、常见问题答疑
Q1:上传 .hap 后安装失败,提示无法安装“XXXXXX”?
出现此问题,通常与签名或配置不当有关。请逐项检查以下内容:
签名相关检查
.hap必须为已签名的包,不能为未签名的包。例如,对于entry模块 DevEco Studio 会在/entry/build/default/outputs/default目录下生成xxx-signed.hap和xxx-unsigned.hap的包,此时您应该使用xxx-signed.hap这个包;- 签名
.hap文件时使用的.p12文件,必须和您在前述步骤中上传到蒲公英平台的.p12文件为同一个; - 在蒲公英平台上传
.p12文件后,是否输入了正确的密码。目前,如果您输入了不正确的密码,蒲公英平台会进行提示; .p12必须为 发布证书,不能使用调试证书。查看如何申请发布证书
Profile (.p7b) 检查
- 签名
.hap文件时所用的 Profile 类型必须为 内部调试 类型。目前,如果您上传了安装包后,如果安装包中的 Profile 文件类型如果不是 内部调试 类型时,蒲公英平台的控制台中会显示 Profile 错误。具体请查看文档 申请内部调试类型 Profile - Profile 必须包含当前测试设备的 UDID。点击查看 UDID 获取方法
进一步排查
如果以上均无误,建议根据安装失败时出现的 错误码,前往 华为错误码目录 进行查询,以获得更具体的排查建议。
Q2:一个链接支持多人下载安装吗?
支持。下载链接可分享给多个测试用户,平台支持安装统计、设备识别等功能。
Q3:平台是否对 .hap 文件做修改?
不会。蒲公英平台不会修改 .hap 文件本体,仅用于对 manifest 文件进行签名处理,确保安装成功。
Q4:是否支持 API 上传?
支持。蒲公英提供了 API 用于上传 App 文件,另外,对于鸿蒙 App 来说,首个 App 上传完成后,还需调用 API 上传 p12 文件。具体可见 API 文档
Q5:是否支持上传 hsp 文件?
支持。您需要先上传 hap 文件,之后在 应用管理 中可以找到上传 hsp 文件的入口。
Yanyan
所有 HAP 文件必须使用华为开发者账号生成的证书完成签名,且签名需包含三个关键部分(HAP 本体、Profile 文件、manifest.json5),才能通过系统安全验证。
-
-
蒲公英等内测平台支持 HAP 分发,但要求:
-
分发链接需通过华为浏览器打开下载
-
设备必须为纯血 HarmonyOS 系统(未开启兼容模式)
-
需提前上传匹配的 .p12 证书文件
-
-
-
文件传输安装:
-
支持通过华为分享传输 HAP 文件,但接收方设备需满足:
-
开启「未知来源应用安装」权限(设置 > 应用管理 > 特殊访问权限)
-
安装包需包含完整的三重签名
-
系统版本需为 HarmonyOS 5.0 以上
-
-
Fpark
简单的尘埃
CAPTAIN 1275
极致- 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
- 如您发布的内容为转载内容,请注明内容来源。
我要提问题
HarmonyOS 企业内网用户下载了.hap安装包后,有手动安装方案吗? (API12+)
HarmonyOS App的包如何通过手机扫码的方式直接下载安装 (API12+)
HarmonyOS inhouse应用下载安装提示报错 (API12+)
HarmonyOS 多应用下载时,网络资源分配问题(API12+)
HarmonyOS 有没有api安装本地hap包(API12+)
HarmonyOS hap 是否可以像 apk 一样在不同设备上进行安装,方便 QA 测试 (API12+)
HarmonyOS 手机应用如何做到HAP独立进程?(API12+)
HarmonyOS 如何通过手机打开网页下载用于测试的安装包,来自动安装应用? (API12+)




































苏公安网备 32011402010933号