鸿蒙HamonyOS应用上架手动签名与发布 原创

本节以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）