鸿蒙 HAP 打包成功却装不上真机?从 SignHap 被跳过说起
【摘要】 鸿蒙工程 BUILD SUCCESSFUL 却装不上真机?很可能是 SignHap 被跳过、产物未签名。本文讲清 hvigor 打包与签名的分工、签名三件套(密钥库/证书/Profile)、build-profile.json5 的写法,以及三条实战建议。
现象
云端把鸿蒙工程编完,日志最后一行是 BUILD SUCCESSFUL,产物也生成了,但装到真机上提示签名校验失败。回头翻日志才发现中间有一行很容易被忽略的告警:
WARN: Will skip sign 'hos_hap'. No signingConfigs profile is configured in current project. If needed, configure the signingConfigs in build-profile.json5.Finished :entry:default@SignHap... after 2 ms
意思是:编译、打包都成功了,但 SignHap 这个任务什么都没做,产物是未签名的 HAP。
为什么构建成功不等于能装
hvigor 的打包流程里,PackageHap 负责把编译产物打成 HAP,SignHap 才负责签名。当前项目的 signingConfigs 是空数组时,SignHap 会直接跳过并给出上面那条 WARN,所以任务显示 Finished(它确实执行完了,只是没干活)。
未签名的 HAP 只能看作“编译产物验证”,装真机、上架应用市场都必须签名。
签名到底需要哪几样东西
- 密钥库文件
.p12:HarmonyOS 用 ECC 密钥对,本地生成后导出密钥库; - 调试/发布证书
.cer:用 CSR 在 AppGallery Connect 申请; - Profile
.p7b:绑定应用包名与证书,调试期还要登记设备 UDID; - 以及 keyAlias、密钥库口令这几个配置项。
然后写进 build-profile.json5 的 app.signingConfigs,并且在 products 里引用:
"signingConfigs": [ { "name": "default", "type": "HarmonyOS", "material": { "certpath": "./sign/default.cer", "profile": "./sign/default.p7b", "storeFile": "./sign/default.p12", "storePassword": "******", "keyAlias": "debugKey", "keyPassword": "******" } }]
三个实践建议
1. 口令不要进仓库。把 sign/ 目录和口令放进 CI 的密钥管理,用构建时注入或临时替换配置文件,仓库里只留一个 .gitignore 掉的模板。
2. 调试证书要登记 UDID。换设备或新买云手机,必须把设备 UDID 加进 Profile 重新下载,否则安装仍然失败,报错看起来像签名不对。
3. 判断签名是否成功,看两处。日志里 SignHap 后面是否真正产出了签名的 hap;以及产物文件名是否带 unsigned。带 unsigned 就是没签。
小结
BUILD SUCCESSFUL只代表编译与打包通过,不代表可安装;Will skip sign这条 WARN 就是“未签名”的明确信号,别被后面的 Finished 劝过去;- 签名 = 密钥库 + 证书 + Profile 三件套,并在 build-profile.json5 里正确引用。
【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱:
cloudbbs@huaweicloud.com
- 点赞
- 收藏
- 关注作者
评论(0)