本节以Birlower应用上架为例,记录完整的鸿蒙HamonyOS应用上架手动签名与发布流程。
上架手动签名
HarmonyOS应用/元服务通过数字证书(.cer文件)和Profile文件(.p7b文件)来保证应用/元服务的完整性。在申请数字证书和Profile文件前,首先需要通过DevEco Studio来生成密钥(存储在格式为.p12的密钥库文件中)和证书请求文件(.csr文件)。然后,申请调试数字证书和调试Profile文件。最后,将密钥(.p12)文件、数字证书(.cer)文件和Profile(.p7b)文件配置到工程中。
基本概念
密钥:格式为.p12,包含非对称加密中使用的公钥和私钥,存储在密钥库文件中,公钥和私钥对用于数字签名和验证。
证书请求文件:格式为.csr,全称为Certificate Signing Request,包含密钥对中的公钥和公共名称、组织名称、组织单位等信息,用于向AppGallery Connect申请数字证书。
数字证书:格式为.cer,由华为AppGallery Connect颁发。
Profile文件:格式为.p7b,包含HarmonyOS应用/元服务的包名、数字证书信息、描述应用/元服务允许申请的证书权限列表,以及允许应用/元服务调试的设备列表(如果应用/元服务类型为Release类型,则设备列表为空)等内容,每个应用/元服务包中均必须包含一个Profile文件。
1. 生成密钥文件
在DevEco Studio中生成密钥文件
设置存储路径:比如本例D:\dev\harmonyos\keystore\birlower_20250916.p12
输入密码
设置别名:比如本例birlower_20250916
2.生成证书请求文件
基于上一步的密钥文件,生成证书请求文件
设置存储路径:比如本例D:\dev\harmonyos\keystore\birlower_20250916.csr
3. 新增数字证书
登录AppGallery Connect,点击左侧导航栏的“数字证书”,点击“新增数字证书”。
填写证书信息,并上传上一步生成的证书请求文件。
证书名称:比如本例birlower_20250916
`
证书类型:发布证书
下载数字证书文件到指定目录待用。
4. 添加Profile
点击“Profile”,添加Profile。
Profile名称:birlower_20250916
类型:发布
选择证书:选择上一步新增的数字证书
下载Profile文件到指定目录待用。
5. 手动配置签名信息
在DevEco Studio中配置密钥(.p12)文件、申请的调试证书(.cer)文件和调试Profile(.p7b)文件。
在File > Project Structure > Project > Signing Configs窗口中,取消勾选“Automatically generate signature”,然后配置工程的签名信息。
Store file:选择第1步生成的密钥库文件,文件后缀为.p12,该文件为生成密钥和证书请求文件中生成的.p12文件。
Store password:输入第1步的密钥库密码,该密码与生成密钥和证书请求文件中填写的密钥库密码保持一致。
Key alias:输入第1步的密钥的别名信息,与生成密钥和证书请求文件中填写的别名保持一致。
Key password:输入第1步的密钥的密码,与生成密钥和证书请求文件中填写的Store Password保持一致。
Sign alg:签名算法,固定为SHA256withECDSA。
Profile file:选择第4步生成的申请调试证书和调试Profile文件中生成的Profile文件,文件后缀为.p7b。
Certpath file:选择第3步生成的申请调试证书和调试Profile文件中生成的数字证书文件,文件后缀为.cer。
构建软件包
打包APP时,DevEco Studio会将工程目录下的所有HAP/HSP模块打包到APP中,因此,如果工程目录中存在不需要打包到APP的HAP/HSP模块,请手动删除后再进行编译构建生成APP。
单击Build > Build Hap(s)/APP(s) > Build APP(s),等待编译构建完成已签名的应用包。
当未指定构建模式时,构建APP包,默认Release模式;构建HAP/HSP/HAR包,默认Debug模式。
即Build APP(s)时,默认构建的APP包为Release类型,符合上架要求,开发者无需进行另外设置。
编译构建完成后,可以在工程目录build > outputs > default下,获取带签名的应用包,例如“Birlower-default-signed.app”
上传软件包
AGC 软件包管理,选择测试和正式上架,上述上一步的软件包“Birlower-default-signed.app”
分发
AGC 版本信息,软件版本选择上一步的软件版本。
软件包加密:加密
应用介绍:一款识别鸟和花的APP。
An APP for identifying birds and flowers.
应用一句话简介(小编推荐):一款识别鸟和花的APP
应用截图和视频:上传截图。需上传 3~5 张。最低尺寸(请确保宽高比9:16):720*1280px;格式:PNG、 JPG、 JPEG (均在 5 MB 以内),以及 WEBP (200 KB 以内)。
内容分级:3+
隐私声明:使用隐私声明托管。新建协议“Birlower隐私声明”
参考引用
- 《跟老卫学HarmonyOS开发》开源免费教程, https://github.com/waylau/harmonyos-tutorial
- 《跟老卫学AI大模型开发》开源免费教程, https://github.com/waylau/ai-large-model-tutorial/
- 《跟老卫学仓颉编程语言开发》开源免费教程, https://github.com/waylau/cangjie-programming-language-tutorial
- 《鸿蒙HarmonyOS手机应用开发实战》(清华大学出版社)
- 《鸿蒙HarmonyOS应用开发入门》(清华大学出版社)
- “鸿蒙零基础快速实战-仿抖音App开发(ArkTS版)”(https://coding.imooc.com/class/843.html)
- 《鸿蒙HarmonyOS应用开发从入门到精通(第2版)》(北京大学出版社)
- 《鸿蒙之光HarmonyOS NEXT原生应用开发入门》(清华大学出版社)
- “HarmonyOS NEXT+AI大模型打造智能助手APP(仓颉版)”(https://coding.imooc.com/class/927.html)