手把手教你发布鸿蒙手机 App

本文以 HarmonyOS NEXT（纯血鸿蒙）应用为例，完整梳理从零到上架华为应用市场（AppGallery）的全流程。适用于个人开发者和企业开发者。

一、整体流程概览

发布一款鸿蒙手机 App，核心流程可以拆成 6 个阶段：

① 账号准备 → ② 创建应用 → ③ 生成签名证书 → ④ 编译构建 → ⑤ 填写上架信息 → ⑥ 提交审核并发布

下面逐步展开。

二、阶段一：账号准备

2.1 注册华为开发者账号

1. 打开 华为开发者联盟，点击右上角「注册」。
2. 使用手机号或邮箱完成账号注册。

2.2 完成实名认证

鸿蒙应用上架必须通过实名认证，分为两种：

操作路径：登录开发者联盟 → 右上角「管理中心」→「实名认证」→ 按提示上传材料。

⚠️ 企业认证通常需要 1～3 个工作日审核，建议提前办理。个人认证一般即时通过。

2.3 开通 AppGallery Connect

实名认证通过后，进入 AppGallery Connect（AGC） 控制台，这是后续创建应用、管理证书、提交上架的核心平台。

三、阶段二：创建应用

3.1 在 AGC 创建项目

1. 进入 AGC 控制台 →「我的项目」→「创建项目」。
2. 填写项目名称（如 MyHarmonyApp），选择默认数据处理位置（建议选「中国」）。

3.2 在项目中添加应用

1. 进入刚创建的项目 →「常规」→「添加应用」。

2. 填写应用信息：

   • 应用名称：用户可见的名称，如「我的鸿蒙应用」
   • 应用包名（Bundle Name）：格式 com.example.myapp，需全局唯一，且与代码中一致
   • 应用类型：选择「应用（HarmonyOS）」
   • 设备类型：勾选「手机（Phone）」
   • 应用分类：如「工具」「游戏」等

3. 创建成功后，你会得到一组关键信息：

   • APP ID（应用的唯一标识）
   • APP Secret
   • CP ID（开发者标识）

💡 重要：代码工程里的 bundleName 必须与这里填写的包名完全一致，否则签名和上架都会失败。

四、阶段三：生成签名证书

鸿蒙应用必须签名后才能安装和上架。签名体系包含三个文件：

.p12 密钥库文件（含私钥）  +  .cer 证书文件  +  .p7b Profile 文件

4.1 生成密钥库（.p12）和 CSR 文件

方式一：DevEco Studio 图形界面（推荐）

1. 打开 DevEco Studio → 菜单栏 Build → Generate Key And CSR。
2. 在 Key store path 处选择一个保存路径，如 E:\keys\myapp.p12。
3. 填写以下信息：
   • Key store password：密钥库密码，务必牢记
   • Key alias：密钥别名，如 myapp_key
   • Key password：密钥密码
   • Validity：有效期（年），建议填 25
   • Certificate：依次填入 First/Last Name、Organization、City、State、Country Code（中国填 CN）
4. 点击 Next，选择 CSR path 保存路径，如 E:\keys\myapp.csr。
5. 点击 Finish，生成 .p12 和 .csr 两个文件。

方式二：命令行（keytool）

keytool -genkeypair -alias myapp_key -keyalg RSA -keysize 2048 -validity 9125 -keystore myapp.p12 -storetype PKCS12

随后生成 CSR：

keytool -certreq -alias myapp_key -keystore myapp.p12 -file myapp.csr -storetype PKCS12

4.2 在 AGC 创建证书（.cer）

1. 进入 AGC 控制台 →「用户与访问」→「证书管理」→「新增证书」。
2. 填写证书名称（如 myapp_release_cer）。
3. 上传刚才生成的 .csr 文件。
4. 提交后下载得到 .cer 证书文件。

4.3 在 AGC 创建 Profile（.p7b）

1. 进入 AGC →「HarmonyOS 应用」→「HAP Provision Profile 管理」→「新增 Profile」。
2. 填写信息：
   • Profile Name：如 myapp_release_profile
   • 证书：选择上一步创建的证书
   • 类型：选择「发布（Release）」
3. 提交后下载得到 .p7b 文件。

💡 调试证书：开发调试阶段还需要一套 Debug 类型的证书和 Profile，流程类似，类型选「调试（Debug）」即可。DevEco Studio 可自动生成调试证书，发布证书则必须手动创建。

五、阶段四：编译构建

5.1 在 DevEco Studio 配置签名

1. 打开工程 → 菜单栏 File → Project Structure → Project → Signing Configs。
2. 勾选 Automatically generate signature（仅用于 Debug），或手动配置 Release：
   • Store File：选择 .p12 文件
   • Store Password：密钥库密码
   • Key Alias：密钥别名
   • Key Password：密钥密码
   • Sign Alg：SHA256withECDSA（HarmonyOS 推荐算法）
   • Profile File：选择 .p7b 文件
   • Certpath File：选择 .cer 文件
3. 点击 OK 保存。

5.2 构建发布包

1. 菜单栏 Build → Build Hap(s)/APP(s) → Build Hap(s)/APP(s) for Previewer（调试）或直接构建 Release。
2. 构建产物位于工程目录下：

entry/build/default/outputs/default/
├── entry-default-signed.hap      # 单 HAP 包（调试安装用）
└── entry-default-unsigned.hap

features/.../build/.../outputs/

3. 若要生成可上架的 .app 包（App 包，含多 HAP 模块）：
   • 菜单栏 Build → Build Hap(s)/APP(s) → Build APP(s) for Release
   • 产物路径：build/outputs/default/xxx-signed.app

📌 HAP 与 APP 的区别：

• HAP：单个模块的安装包，可直接 hdc install 安装到设备调试。
• APP：多 HAP 打包后的上架包格式，提交到 AppGallery 时使用。

5.3 命令行构建（可选）

hvigorw assembleApp --mode module -p product=default -p buildMode=release --no-daemon

六、阶段五：填写上架信息

回到 AGC 控制台 →「HarmonyOS 应用」→ 选择你的应用 →「准备提交」。

6.1 应用基础信息

6.2 截图与预览素材

• 手机截图：至少 3 张，建议 5 张，分辨率 1080×2400 或同比例，PNG/JPG。
• 介绍视频（可选）：MP4，不超过 100MB，时长 ≤ 5 分钟。

6.3 隐私与合规

1. 隐私政策 URL：必须提供可访问的隐私政策网页链接。
2. 用户协议 URL：可选但建议提供。
3. 权限使用说明：如果应用申请了敏感权限（如位置、相机、麦克风），需逐项说明用途。

⚠️ 隐私合规是审核被拒的高频原因。务必确保：

1. 隐私政策中涵盖所有收集的数据类型；
2. 首次启动时弹出隐私弹窗，用户同意后才运行；
3. 不强制索权、不超范围收集。

6.4 内容分级与版权

• 内容分级：按 IARC 问卷填写，系统自动生成分级。
• 软件著作权：部分分类要求提供软著证书（企业开发者常见）。
• 资质文件：金融、医疗、新闻等特殊分类需提供行业资质。

七、阶段六：提交审核并发布

7.1 上传软件包

1. 进入「软件版本管理」→「新建版本」。
2. 填写版本号（与代码 versionCode 一致）和版本名称（用户可见，如 1.0.0）。
3. 上传 .app 包（或 .hap 包）。
4. 选择目标 API 版本（如 HarmonyOS NEXT 5.0.0）。

7.2 提交审核

1. 确认所有信息填写完整。
2. 点击「提交审核」。
3. 审核状态流转：

提交 → 审核中 → 审核通过 / 审核驳回

• 审核时长：通常 1～3 个工作日。
• 审核结果：会通过站内信和注册邮箱通知。

7.3 审核通过后发布

1. 审核通过后，进入「软件版本管理」。
2. 选择已通过的版本 → 点击「发布」。
3. 可选择：
   • 全量发布：立即对所有用户开放。
   • 灰度发布：按比例逐步开放（如先 10%，再 50%，最后 100%），降低风险。

7.4 审核被拒怎么办？

常见驳回原因及处理：

修改后重新提交审核即可，无需新建版本。

八、附录：完整流程检查清单

发布前逐项核对，能大幅降低审核失败率：

• [ ] 华为开发者账号已完成实名认证
• [ ] AGC 中已创建项目和应用，包名与代码一致
• [ ] 已生成 .p12、.cer、.p7b 三件套并配置到工程
• [ ] Release 构建成功，无编译错误
• [ ] 真机安装测试通过，核心功能正常
• [ ] 应用图标 1024×1024、截图 1080×2400 已准备
• [ ] 隐私政策 URL 可访问，内容覆盖所有数据收集
• [ ] 敏感权限已逐项填写使用说明
• [ ] 版本号、版本名称已正确填写
• [ ] 软著/资质文件（如需）已上传

九、常用链接汇总

写在最后

鸿蒙应用发布流程整体与 Android（Google Play）思路相近，但有几个关键差异点需要特别注意：

1. 签名体系独立：鸿蒙使用自己的证书体系，不能复用 Android 的 keystore。
2. Profile 机制：类似 iOS 的 Provisioning Profile，必须为每个应用生成。
3. 纯血鸿蒙：HarmonyOS NEXT 不兼容 Android APK，必须使用 ArkTS/ArkUI 原生开发。
4. 隐私合规严格：审核对权限和数据收集的把控比 Play Store 更严，建议提前对照规范自查。

按本文流程走一遍，第一次上架通常 1～2 天内即可完成审核。祝上架顺利！