HarmonyOS鸿蒙Next中App每次都要通过编译器给测试人员打包
HarmonyOS鸿蒙Next中App每次都要通过编译器给测试人员打包 蒲公英啥时候支持鸿蒙应用安装包
仅支持hap,而不是app,
您好,蒲公英是三方平台,app包支持情况请您咨询三方平台客服。
目前蒲公英平台仅支持HAP的,暂不支持APP的,需要等后期平台进行适配后才能使用
将项目打包成hap包
蒲公英内测分发平台目前已全面支持鸿蒙 App(.hap 文件) 的上传、验证与分发
- 编译HAP包
- DevEco Studio菜单栏选择“Build > Build Hap(s)/APP(s) > Build Hap(s)”。
- 等待编译构建。构建完成,在各模块的“build > default > outputs > default”目录下,获取到XXX-signed.hap文件。
蒲公英内测分发
第一步:上传已签名的.hap 文件
- 前提:本地用华为 DevEco-Studio 等工具完成签名,生成 “XXXX-signed.hap” 文件(不可用未签名包)
- 关键要求:签名所用的.p12 证书需与后续上传至蒲公英的.p12 完全一致
第二步:填写 App 信息(可选)
- 可填内容:应用名称(平台自动解析版本号)、更新日志、应用截图、内测说明
- 作用:提升分发页面专业性,便于测试人员识别
第三步:上传.p12 文件并设密码
- 证书来源:华为 AppGallery Connect 的 “证书、APP ID 和 Profile” 页面下载
- 用途:用于平台对 manifest.json5 文件签名(华为验证机制要求,确保设备识别可信来源)
- 注意:需输入正确密码,平台会提示密码错误
第四步:获取分发链接与安装
- 平台生成:下载链接 + 二维码,支持分享至微信 / 邮件 / 钉钉
- 安装限制:仅支持纯血 HarmonyOS NEXT 系统设备,推荐用华为自带浏览器打开下载
四、常见问题答疑(Q&A)
- Q1:.hap 上传后安装失败? 排查方向:①确认用 “xxx-signed.hap”(非未签名包);②.p12 证书与签名.hap 的证书一致;③.p12 密码正确;④Profile 类型为 “内部调试” 且包含测试设备 UDID;⑤根据华为错误码目录进一步查询
- Q2:分发链接支持多人下载吗? 支持,且平台提供安装统计、设备识别功能
- Q3:平台会修改.hap 文件吗? 不会,仅对 manifest.json5 文件进行签名处理
- Q4:支持 API 上传吗? 支持,首个鸿蒙 App 上传后需额外调用 API 上传.p12 文件
- Q5:支持上传 hsp 文件吗? 支持,需先上传 hap 文件,再在 “应用管理” 中找到 hsp 上传入口
为什么不是直接打一个内测版的 .app文件,这样省得再上传hsp文件,
这个就得看他们后续支不支持app的了,目前蒲公英是只支持HAP的,
蒲公英分发平台已经支持上传HAP内部测试安装包。
官网介绍:https://www.pgyer.com/doc/view/harmonyos
HAP、HAR、HSP三者的功能和使用场景总结对比如下:
| Module类型 | 包类型 | 说明 |
|---|---|---|
| Ability | HAP | 应用的功能模块,可以独立安装和运行。 |
| Static Library | HAR | 静态共享包,编译态复用。 - 支持应用内共享,也可以作为二方库(SDK)、三方库(SDK)发布后供其他应用使用。 - 作为二方库(SDK),发布到OHPM私仓,供公司内部其他应用使用。 - 作为三方库(SDK),发布到OHPM中心仓,供其他应用使用。 - 多包(HAP/HSP)同时引用相同的HAR时,会造成多包间代码和资源的重复拷贝,从而导致应用包增大。 - 注意:编译HAR时,建议开启混淆能力,保护代码资产。 |
| Shared Library | HSP | 动态共享包,运行时复用。 - 当多包(HAP/HSP)同时依赖同一个共享包时,使用HSP替代HAR,可以避免HAR造成的多包间代码和资源的重复拷贝,从而减小应用包大小。 |
注意:内部测试仅支持编译HAP和应用内HSP包。
详见开发文档:https://developer.huawei.com/consumer/cn/doc/app/agc-help-internal-test-build-app-0000002295372093
在HarmonyOS Next中,应用测试分发可通过Huawei AppGallery Connect的开放式测试功能实现。开发者上传应用版本至AGC后,可生成公开或限定的下载链接与二维码,测试人员无需编译即可直接安装。此方式适用于应用在真机上的测试验证。
目前,蒲公英等主流第三方分发平台尚未正式支持HarmonyOS Next应用的.hap安装包分发。
对于测试分发,现阶段最高效的方式是使用华为开发者联盟提供的 AppGallery Connect(AGC) 中的“应用分发”服务。该服务专为HarmonyOS应用设计,可实现:
- 免编译上传:开发者直接将编译生成的.hap或.app文件上传至AGC。
- 便捷分发:生成下载链接或二维码,测试人员可直接在支持HarmonyOS Next的设备上安装测试。
- 版本管理:清晰管理测试版本、发布说明和测试设备列表。
这避免了每次都需要开发者本地打包分发的繁琐流程,实现了云端分发和闭环测试管理。建议优先使用此官方渠道进行HarmonyOS Next应用的测试分发。


