探秘鸿蒙 HarmonyOS NEXT：如何发布一个 HarmonyOS 应用

嘿，同学们！你是不是已经完成了自己的 HarmonyOS 应用或元服务开发，准备上架到应用市场？但面对各种「证书啊、Profile文件啊、签名啊」是不是有点懵？别急，今天我带大家学习一下完整的HarmonyOS 应用发布流程。

发布流程一览

开发者完成HarmonyOS应用/元服务开发后，需要将应用/元服务打包成App Pack（.app文件），用于上架到AppGallery Connect。发布应用/元服务的流程如下图所示：

其次，你得明白一件事：你的应用想要发布，必须先通过签名校验。这就是为了保证你的软件完整、可信。那怎么做呢？需要准备以下几个关键文件：

• .p12 文件（密钥库）
• .csr 文件（证书请求）
• .cer 文件（发布证书）
• .p7b 文件（Profile文件）

这些文件缺一不可。

第一步：生成密钥和证书请求

你得先在 DevEco Studio 里，走一遍「Build > Generate Key and CSR」这个流程：

• 先创建一个密钥库（就是 .p12 文件），这个里面放的是公钥和私钥。
• 然后生成 .csr 文件，这个会拿去向华为申请数字证书。

注意啦：

• 密码必须够复杂，要包含大小写+数字或符号，至少8位。
• 有密钥库就不用重新创建了，直接跳过生成。

第二步：去 AppGallery Connect 申请证书和 Profile

有了 .csr 文件，就可以去 AppGallery Connect 上：

1. 创建一个 HarmonyOS 应用或元服务。
2. 提交 .csr 文件，申请 .cer 和 .p7b 文件。
3. 下载回本地备用。

注意：

• 如果你是发布元服务，记得在创建的时候选择“是否元服务”为“是”。

第三步：配置签名信息

在 DevEco Studio 中，把刚刚拿到的文件全部配置进去：

• Store File：选择 .p12 文件
• Store Password：就是你设置的密钥库密码
• Key Alias：创建密钥时设置的别名
• Key Password：和密钥库密码一致
• Sign Alg：固定用 SHA256withECDSA
• Profile File：就是 .p7b 文件
• Certpath File：就是 .cer 文件

这个配置路径是：
👉 File > Project Structure > Project > Signing Configs > default

别忘了取消勾选“Automatically generate signature”。

第四步：打包 .app 文件

签名配置好了，现在就可以打包你的 APP 了：

1. 记住只能打包 Release 模式的 APP 才能上架。
2. 在菜单点 Build > Build Hap(s)/APP(s) > Build APP(s)
3. 构建完成后，带签名的 .app 文件会在 build/outputs/default 目录下生成。

⚠️ 小提示：如果工程中有不需要打包的模块，记得手动删掉！

第五步：上传到 AppGallery Connect

从 DevEco Studio 的 Build > Upload Product 菜单，就可以上传你的 APP 到华为平台了！

• 首次需要登录华为开发者账号。

• 有两个上传选项：

  • 上传用于测试（测试用的）
  • 上传用于发布（真正上架市场的）

如果需要，还可以上传符号表（调试和崩溃分析用的）。

📌 注意：上传的软件包必须是 Release 签名的！

第六步：更新签名指纹（如果用到了某些服务）

如果你用到了华为的一些开放能力（比如账号服务、支付、地图等），在发布前还要在 AGC 平台上更新签名指纹（用的是发布证书的指纹，不是调试证书）。

第七步：正式发布到应用市场！

一切准备好之后，就可以去华为的应用市场，把你的 .app 文件提交上架啦。具体操作可以参考《上架 HarmonyOS 应用》的官方指南。

总结一下

整个过程其实就这几个关键步骤：

1. 在 DevEco Studio 生成密钥和 CSR 文件；
2. 在 AGC 平台申请证书和 Profile；
3. 回 DevEco Studio 配置签名；
4. 打包成 .app；
5. 上传到 AppGallery Connect；
6. （可选）更新签名指纹；
7. 提交审核，上架应用市场！

这个流程虽然步骤多，但操作逻辑其实很清晰。只要你跟着 DevEco Studio 和 AGC 的流程走，一步一步按提示操作，就能顺利发布属于自己的 HarmonyOS 应用啦！