HarmonyOS 应用上架 AGC 审核全流程

开发完成只是第一步，上架审核才是面对用户的最后一关。NetLab 经历了 1.0.1 和 1.0.2 两次审核，本文分享从签名打包到提审到通过的全流程，以及华为审核反馈的应对经验。

一、Release 签名配置

上架必须用 Release 签名包，debug 签名包无法提审。

1. 生成密钥：DevEco Studio → Build → Generate Key And CSR → 创建 .jks 密钥库
2. 配置签名：build-profile.json5 中 signingConfigs 添加 Release 配置

   "signingConfigs": [{
     "name": "release",
     "type": "HarmonyOS",
     "material": {
       "certPath": "xxx.cer",
       "storePassword": "xxx",
       "keyAlias": "xxx",
       "keyPassword": "xxx",
       "profilePath": "xxx.p7b",
       "signAlg": "SHA256withECDSA",
       "storeFile": "xxx.jks"
     }
   }]

3. AGC 申请证书：AGC → 用户与访问 → 证书管理 → 创建 .cer 和 .p7b Profile

二、构建打包

# DevEco Studio 菜单方式
Build → Build Hap(s)/APP(s) → Build Hap(s)
# 生成 .hap 文件在 entry/build/default/outputs/default/

# 或命令行
hvigorw assembleHap --mode module -p product=default  # debug
hvigorw assembleHap --mode module -p product=release  # release

# 打包 .app（多 HAP 合并，上架用）
Build → Build Hap(s)/APP(s) → Build APP(s)
# 生成 .app 文件在 build/outputs/release/

上架提交的是 .app 包（非 .hap），包含所有 HAP 模块。

三、AGC 提审

1. 上传包：AGC → 分发 → 应用市场 → 版本管理 → 上传 .app
2. 自检：AGC 自动检查包合规性（权限、隐私、API 兼容性等），显示"已达标"才能继续
3. 填写版本信息：
   • 版本特性描述（更新了什么，展示给用户）
   • 版本说明（技术细节，审核员看）
   • 截图上传（至少4张，建议含手机+平板）
4. 提交审核：点击提交，状态变为"审核中"

四、审核流程与周期

阶段	耗时	说明
自检	几分钟	AGC 自动检查包合规性
预审	1-2工作日	人工初审，检查基本合规
正式审核	1-3工作日	人工详审，测试功能
上架	审核通过后	自动上架，用户可下载

NetLab 1.0.1 首次审核约2工作日通过；1.0.2（含深色模式+属性面板优化）预审当天通过，进入正式审核。

五、审核反馈应对

华为审核质量较高，会提出改进建议（非强制驳回，但建议修改）。NetLab 1.0.2 收到的建议：

5.1 深色模式适配

审核建议：应用未适配深色模式，建议适配以提升用户体验。

应对：用资源限定目录分离 light/dark 颜色，颜色引用 $r('app.color.xxx')，系统自动切换。详见下篇《深色模式适配实践》。

5.2 属性面板交互

审核建议：属性面板弹出遮挡右侧设备，建议优化交互。

应对：属性面板改为默认隐藏，仅点击设备+点击属性按钮时才弹出，避免遮挡画布。

六、常见审核问题

1. 隐私政策缺失：必须提供可访问的隐私政策URL，内容需说明收集哪些数据
2. 权限滥用：申请的权限需在隐私政策中说明用途，无用权限会被驳回
3. 崩溃/ANR：审核员会实测功能，崩溃必驳回。提审前充分自测
4. 截图与实际不符：截图需反映真实界面，过度PS会被驳回
5. API 版本兼容：调用的 API 需在声明的 minAPIVersion 范围内

七、小结

• 上架流程：签名配置 → 构建 .app → AGC 上传 → 自检 → 提审 → 上架
• Release 签名是前提，build-profile.json5 配置要完整
• 审核周期通常 2-3 工作日，预审+正式审核两阶段
• 审核反馈认真对待，改进后重新提审通常快速通过