​

一、核心概念

1. 密钥（.p12文件）包含非对称加密的公钥和私钥对，用于数字签名与验证。通过DevEco Studio生成，需设置密钥库密码（8位以上，含大小写字母+数字/符号）。
2. 证书请求文件（.csr文件）包含公钥、开发者信息（组织名称/单位等），用于向华为申请数字证书。
3. 数字证书（.cer文件）由AppGallery Connect颁发，验证应用身份。
4. Profile文件（.p7b文件）包含包名、证书权限、设备调试列表（Release版设备列表为空）。发布Profile仅用于上架，调试Profile用于开发阶段。

二、完整发布流程

步骤1：生成密钥和证书请求文件

1. 路径：DevEco Studio → Build → Generate Key and CSR新建密钥库：设置.p12文件路径、密码（需二次确认）。填写密钥信息：别名（Alias）、密码（与密钥库一致）。生成CSR：指定证书请求文件存储路径。注：已有密钥可跳过生成，直接创建CSR。

步骤2：申请发布证书和Profile文件

1. 在AppGallery Connect操作：创建应用/元服务：普通应用：选择"否"；元服务：必须选择"是"。申请发布证书：上传.csr文件 → 下载.cer证书。申请发布Profile：绑定应用包名 → 下载.p7b文件。

步骤3：配置工程签名信息

1. 路径：File → Project Structure → Project → Signing Configs → default关闭自动签名：取消勾选 "Automatically generate signature"。手动配置：参数说明Store File选择.p12密钥库文件Store Password输入密钥库密码Key Alias密钥别名Key Password密钥密码（同Store Password）Profile File选择.p7b发布ProfileCertpath File选择.cer发布证书签名算法：固定为 SHA256withECDSA。

步骤4：编译构建.app文件（Release包）

1. 前提检查：删除工程中无需打包的HAP/HSP模块（避免冗余）。确保构建模式为 Release（默认执行Build APP(s)时自动启用）。
2. 操作：Build → Build Hap(s)/APP(s) → Build APP(s)输出路径：工程目录/build/outputs/default/ → 获取带签名的.app文件。

步骤5：上传软件包至AppGallery Connect

1. 路径：Build → Upload Product登录华为开发者账号：首次需完成DevEco Studio授权。选择发布类型：测试发布：Generate app package... for test正式全网发布：Generate app package... for test and publish高级选项：上传符号表：勾选 "Upload your app's symbols"（便于崩溃分析）。包名/版本号校验：需与AppGallery Connect中注册信息一致。

步骤6：发布到应用市场

• 上传完成后进入AppGallery Connect：查看云测试报告 → 处理合规问题。

三、关键注意事项

1. 签名文件用途区分：发布证书/Profile → 仅用于上架，不可调试。调试需使用调试证书（流程不同）。
2. 必更新证书指纹的场景：若应用集成以下华为能力，必须在AppGallery Connect更新为发布证书指纹：Account Kit, Game Service Kit, Health Kit, IAP Kit, Map Kit, Payment Kit, Wallet Kit.
3. 元服务特殊要求：创建应用时明确勾选"是元服务"，否则影响Profile申请。
4. 密码安全：密钥库密码、密钥别名需妥善保存，后续更新应用需复用相同密钥。
5. 包类型强制要求：上架应用必须是Release类型，Debug包无法提交审核。

流程图核心节点

此流程确保应用完整性，防止篡改，是HarmonyOS应用上架的强制安全要求。建议开发者严格遵循，避免因签名问题导致审核失败。​