HarmonyOS7 应用发布：签名打包与上架全流程配置

文章目录前言第一步准备签名证书第二步在 build-profile.json5 配置签名代码实现第三步打包Build App核心代码第四步上架应用市场发布检查清单常见误区小白必踩完整可运行示例签名配置完整示例写在最后前言代码写完了怎么变成用户能装的 app这中间有签名 → 打包 → 上架三步。新手最容易在签名这步卡住——“为啥我打包报错说证书不对”这篇文章把发布全流程走一遍重点讲清签名证书怎么配、打包要注意什么、上架要准备啥。照着做你能把 app 从代码变成可安装的包。第一步准备签名证书HarmonyOS app 必须签名才能安装/上架。签名分两类类型用途获取调试证书本地真机调试DevEco 自动生成| 发布证书 | 上架应用市场 | 华为开发者联盟申请 |发布证书在华为开发者联盟后台申请下载.p12证书和.p7bProfile文件。第二步在 build-profile.json5 配置签名把证书信息写进工程配置代码实现{ app: { signingConfigs: [{ name: release, type: release, material: { certpath: release.p12, // 证书文件 storePassword: ******, // keystore 密码 keyAlias: release, // 密钥别名 keyPassword: ******, // 密钥密码 profile: release.p7b, // 发布 Profile signAlg: SHA256withECDSA } }], products: [{ name: default, signingConfig: release }] } }certpath/profile指向你申请的证书文件。密码等敏感信息别提交到公开仓库。signingConfig绑定到 product打包时用这个配置签名。第三步打包Build App在 DevEco 里Build → Build App(s)/Hap(s) → 选 release。或者用命令行核心代码hvigorw assembleApp--modemodule-pproductdefault打包成功会生成.app或.hap文件这就是可安装的包。注意debug 包只能装到你自己授权的设备release 包才能上架。打包前确认module.json5里的versionName/versionCode已更新每次上架版本号要递增。第四步上架应用市场登录华为开发者联盟进入应用市场控制台。创建应用填名称、分类、简介、截图、隐私政策链接。上传打包好的 app 包。提交审核等待通常 1~3 个工作日。审核过正式上架。审核常见被拒原因权限理由写不清、隐私政策缺失、功能与描述不符、敏感权限滥用。提前把module.json5的requestPermissions理由写清楚能省很多往返。发布检查清单签名证书正确配置releaseversionCode 比上一版大所有权限都写了合理 reason隐私政策链接有效图标、启动图齐全debug 日志已清理常见误区小白必踩误区说明签名路径/密码错证书文件、keystore 密码、profile 不匹配打包直接报错。versionCode不递增每次上架版本号必须比上一版大否则传不上去。权限reason写不清审核常见被拒原因就是理由含糊提前写清楚。留 debug 日志上线前清理调试日志别泄露信息。下面这段代码可以直接复制到 DevEco Studio 里运行。建议你边读边敲改一改文末「动手改一改」里的参数亲眼看看效果。完整可运行示例签名配置在build-profile.json5配置签名才能打出可安装的包。完整示例// build-profile.json5节选 signingConfigs { app: { signingConfigs: [ { name: release, type: HarmonyOS, material: { certpath: release.p7b, storePassword: ******, keyAlias: release, keyPassword: ******, profile: release.p7b, signAlg: SHA256withECDSA, storeFile: release.p12 } } ] } }你会看到什么配好签名后Build Build Hap(s)/APP(s)能产出带签名的安装包未配置签名则只能跑 debug无法上架。动手改一改在 DevEco 里用「自动生成签名」一键生成material再回填到文件。区分debug/release两套signingConfigs。用命令行hvigorw assembleApp --mode release打 release 包。写在最后发布就三步配签名 → 打 release 包 → 上架审核。卡顿基本都在签名配置证书路径对不对、密码对不对、Profile 是否匹配包名。建议第一次发布前先用 debug 证书在真机跑通再换 release 证书打包。把上面的检查清单存好每次发版对着勾一遍基本一次过审。