HarmonyOS 鸿蒙Next中如何给软件签名

下面按“DevEco Studio 给 HarmonyOS 应用做 Release 签名 → 生成可上架包 → AGC 提交上架”把完整流程讲清楚（含常见坑）。

一、先搞清楚：Debug 签名 vs Release 签名

• Debug 签名：本地开发调试用，DevEco 一般自动处理，不能用于正式上架。
• Release 签名：正式发布/上架用，需要与你在 AppGallery Connect（AGC） 上的应用身份一致，确保包体来源可信、可升级。

上架必须是 Release 包 + Release 签名。

二、上架前置条件（不满足会卡住）

1. 有华为开发者账号，并完成实名认证/企业认证（按你账号类型）。
2. 在 AGC 创建项目，并在项目下 创建应用（HarmonyOS 应用/元服务）。
3. 准备好应用基础信息：应用名、包名（bundleName）、图标、隐私政策等（后面提交审核要用）。

三、签名的两种方式：自动签名（推荐） vs 手动签名

方式 A：自动签名（推荐，新手最省心）

核心思想：DevEco 直接对接 AGC 的签名配置，你不用自己管理一堆证书文件。

步骤：

1. 打开 DevEco Studio → 打开你的工程
2. 找到 签名配置入口（一般在：
   • File / Project Structure / Signing Configurations 或者构建配置界面里的 Signing）
3. 选择 Automatic signing（自动签名）
4. 登录你的华为账号 / 绑定 AGC 项目（按提示选择你在 AGC 创建的应用）
5. 选择要用于发布的签名（通常是 Release）并保存
6. 执行 Build → Build Hap(s) / Build App Pack（Release）（名称随版本略有差异）

优点：

• 证书/签名文件不容易配错
• 适合团队协作、后续升级发布更稳

方式 B：手动签名（你自己管理证书）

适合：公司有严格证书管理、CI/CD 自建签名流程。

通常需要你准备/配置这些东西（名称可能随版本略有不同）：

• 私钥库（p12/jks 等，含私钥）
• 证书链（cer/p7b 等）
• Profile/签名描述文件（与应用绑定）

步骤（大体思路）：

1. 在 AGC 创建应用后，进入项目相关的 证书/签名 配置页面（按 AGC 指引生成/下载对应文件）
2. 在 DevEco 的 Signing Configurations 中选择 Manual signing
3. 填入/选择：
   • KeyStore 路径与密码
   • Key alias 与密码
   • 证书/profile 文件路径
4. Build Release 包并验证安装升级

关键提醒：

• 私钥丢了=以后无法用同一签名发布升级包（用户无法从旧版本升级到新版本，只能换包名重发，代价很大）。
• 私钥不要上传到公共仓库。

四、如何生成“可上架”的发布包

一般你需要生成 Release 构建产物（例如 HAP / App Pack 等，具体取决于你应用形态与 DevEco 版本）：

1. DevEco 切换到 Release 构建（或选择 Release 变体）
2. 执行 Build（菜单里通常有：Build Hap(s)、Build App Pack、Generate Release…）
3. 构建输出目录会生成可提交的包体文件（你用于上传 AGC）

如果构建时提示签名不完整/证书不匹配，先回到第三步检查 signing config。

五、AGC 上架（提交审核）大流程

1. 登录 AppGallery Connect
2. 进入 我的项目 → 选择你的应用
3. 进入“发布/上架”相关入口（不同版本界面略有不同）
4. 按步骤填写/上传：
   • 应用基础信息（名称、简介、截图、分类、版本号等）
   • 隐私政策、权限说明（尤其涉及定位、相机、存储等）
   • 上传你刚才生成的 Release 包
5. 保存并 提交审核
6. 审核通过后发布生效（可选择灰度/全量等策略，视 AGC 能力）

六、常见坑（提前避雷）

1. 签名变了导致无法升级：第一次上架的签名要长期稳定保存。
2. bundleName 不一致：AGC 上创建应用的包名要和工程配置一致，否则签名/上传时会报不匹配。
3. 版本号/版本名不规范：上架时版本号必须递增。
4. 权限与隐私说明不全：常见驳回原因之一。
5. 用 Debug 包上传：会直接不通过或提示签名不对。