鸿蒙应用从开发完成到最终上架至华为应用市场，需经历一套严谨的签名、打包与审核流程。此流程的核心在于构建一个由密钥、数字证书和Profile文件构成的信任链，以确保应用的完整性、真实性与合规性。本文将详细拆解这一流程，涵盖从本地密钥生成到AGC（AppGallery Connect）后台配置的完整链路，并附上关键操作步骤与规范解读。
1. 核心流程总览
HarmonyOS应用上架的整体操作流程遵循一个清晰的线性路径，可概括为“本地准备 → 云端申请 → 本地签名 → 云端上架”。具体而言，开发者首先需在集成开发环境（IDE）中生成密钥与证书请求文件；随后，在AGC平台申请对应的发布证书与Profile文件；接着，将获取的签名文件配置回IDE工程，完成应用的编译与签名打包；最后，将签名后的应用包提交至AGC进行应用信息配置与上架审核。此流程环环相扣，任一环节的缺失或错误都将导致后续步骤无法进行。
2. 密钥与证书请求文件生成
签名流程的起点是在DevEco Studio中生成密钥（Key）和证书请求文件（CSR）。密钥以.p12格式的密钥库文件存储，内含用于非对称加密的公私钥对，是应用签名的根基。证书请求文件（.csr）则包含了公钥及开发者的组织信息，用于向权威机构（此处为AGC）申请数字证书。
操作步骤如下：
- 在DevEco Studio菜单栏选择
Build > Generate Key and CSR。 - 若本地无现有密钥，点击“New”创建新密钥库。需设置存储路径、文件名及密码。密码要求包含大写字母、小写字母、数字和特殊符号中的至少两种，且长度不少于8位。
- 填写密钥别名（Alias）、有效期（Validity，建议≥25年）及证书基本信息（如组织、地区等）。
- 指定CSR文件的存储路径与文件名，完成创建。
成功执行后，将在指定目录获得.p12密钥库文件与.csr证书请求文件，为后续证书申请做好准备。
3. 云端证书与Profile申请
获取CSR文件后，需登录AGC平台完成发布证书与Profile文件的申请。
3.1 申请发布证书
发布证书（.cer文件）由AGC颁发，用于验证发布者身份与保障代码完整性。申请前需确保开发者账号已完成实名认证。每个账号限申请一个发布证书。
- 登录AGC，进入“用户与访问 > 证书管理”。
- 点击“新增证书”，填写证书名称，选择“发布证书”类型，并上传此前生成的
.csr文件。 - 提交申请后，在证书管理页面下载生成的
.cer证书文件至本地。
3.2 申请发布Profile
Profile文件（.p7b文件）将应用包名、证书信息、权限列表等绑定在一起，是应用包的必要组成部分。申请前提是已在AGC创建对应的HarmonyOS应用项目。
- 在AGC中进入对应项目的“HarmonyOS应用 > HAP Provision Profile管理”。
- 点击“添加”，配置Profile名称，类型选择“发布”，并关联上一步申请的发布证书。
- 根据应用需求配置“申请权限”。若应用使用了ACL（访问控制列表）方式申请的高阶权限，需额外邮件申请开通配置项；否则，在“受限权限（HarmonyOS API9以下）”中配置。此处申请的权限必须与项目代码中声明的权限完全一致。
- 提交并下载生成的
.p7bProfile文件。
特别注意：针对API 9及以上版本的应用，AGC会签发新版本Profile。若应用包中使用了旧版Profile，将无法上架，需重新下载并打包。
4. 工程签名配置与应用打包
获取所有签名文件后，需在DevEco Studio中完成工程签名配置，并进行最终的应用打包。
4.1 配置签名信息
在IDE中关联本地签名文件与云端颁发的凭证。
- 打开
File > Project Structure，进入Project > Signing Configs。 - 取消勾选“Automatically generate signature”，手动配置以下信息：
- Store file: 选择本地
.p12密钥库文件。 - Store password: 输入创建密钥库时设置的密码。
- Key alias: 输入创建密钥时设置的别名。
- Key password: 输入密钥密码（通常与Store password一致）。
- Sign alg: 固定为
SHA256withECDSA。 - Profile file: 选择下载的
.p7bProfile文件。 - Certpath file: 选择下载的
.cer证书文件。
- Store file: 选择本地
4.2 编译打包应用
在打包前，必须确保应用包符合华为的软件包规范，主要约束如下表所示：
| 规范项 | 具体要求与说明 |
|---|---|
| APP包大小 | 总体不超过4GB。 |
| HAP包大小 | 根据设备类型有不同上限：手机/平板≤4GB，智能手表/大屏≤2GB，路由器≤200MB，运动手表≤20MB。多设备HAP包大小受限于所支持设备类型中的最小上限。 |
| HAP包类型 | 必须全部为非免安装类型（FA模型installationFree为false，Stage模型bundleType为app）。 |
| APP包名 | 格式为以点分隔的字符串（至少三段），每段仅允许英文字母、数字、下划线，总长度7-128字符，且不能包含harmony、ohos等保留字作为独立段。 |
确认规范符合后，通过菜单Build > Build Hap(s)/APP(s) > Build APP(s)执行编译。打包完成后，应用包默认生成于工程目录的build/outputs/default/下（API 4-7工程路径略有不同）。
5. 应用上架配置
最后一步是将打包好的应用提交至AGC上架。
- 登录AGC，进入“我的应用”，在HarmonyOS页签中找到目标应用。
- 在“应用信息”中，需首先完成“华为智慧分发平台合作协议”的签署（仅账号持有者或法务角色可操作）。
- 于“基本信息”区域配置应用支持的设备类型。此处可调整分发设备，但需注意：应用升级时仅支持新增设备类型，不可删除已上架应用原有的设备类型。
- 完成应用信息（如描述、截图、分类等）的全面配置后，即可提交应用包，进入官方的审核流程，静待上架。
通过以上五个核心步骤，开发者便能系统性地完成HarmonyOS应用的签名、打包与上架全流程，确保应用安全、合规地交付至最终用户。
参考来源
- 鸿蒙5：HarmonyOS应用开发-项目打包申请证书和上架
