HarmonyOS 6商城开发学习:AGC应用状态机与发布工作流实战——从草稿到上架、驳回修复与下架的完整操盘手册

如果你团队里负责过**"发版本到华为应用市场"**,大概率听过这种对话:

PM:审核被驳回了,你赶紧改一下,改完直接点重新提交就行了吧?

:......不能直接"改",现在状态是"正在审核/已上架",AGC不让编辑。得走对流程,不然容易搞出"包号没升、素材还是旧的、审核又打回"的死循环。

很多人对 **AGC(AppGallery Connect)里的"应用状态"**​ 的直觉是:"不就是个标签嘛,草稿/审核中/已上架。"

但实际上它是一个有明确约束的状态机 ------哪些状态能编辑、哪些只能升版本、哪些需要走审核、哪些点了就得等人工------全都有规矩。规则不清楚,发布就容易乱;规则清楚了,你的"提审→驳回→修复→再提审"反而不焦虑。

下面把官方那套状态分类翻译成一张工程师视角的 cheat sheet,并给出一套可执行的发布/修复/下架 SOP。


一、先建立直觉:AGC 的"状态"管的是什么

AGC 的应用状态本质上覆盖两块:

  1. 应用信息(Listing / 应用信息):应用名、简介、截图、宣传图、隐私政策链接、分类等"展示侧"内容

  2. 版本信息(Version / APK(或HAP/HSP打包产物)相关):包、权限声明、上架时间策略、发行范围等"交付侧"内容

状态机要管的正是:当前这套"信息+包"处于什么阶段,能不能改、改了要不要重新过审

一句话:"准备提交"=草稿,你可以随便改;"正在审核/已上架"=锁住,想改只能走版本迭代或(特定路径下的)上架时间微调。


二、状态机全景:9个状态一张表看完

下面这张表把文档里列出的状态,整理成你每天真正关心的三列:"能不能编辑"、"点了什么触发"、"常见坑"

状态 你最关心的含义 能不能改应用信息/版本信息 关键操作(你能点的) 最容易踩的坑
**准备提交(草稿)**​ 刚创建应用 or 上个版本下架后可再编辑的"草稿态" ✅ 可编辑 填写/修改信息 → 提交审核 很多人把"准备提交"当长期仓库:包放了半年不升版本号,一提审就被问"这版本你到底测没测"
正在审核 已提交、等审核结论 ❌ 不能编辑(锁住) 撤销审核(审核中可撤销,改完再提) 点了"提交审核"才想起"哦我忘了改一句话"------只能撤销,别硬发另一个包覆盖
待修改 审核驳回 ✅ 可编辑(但本质仍是"这个版本号需要重新提") 按驳回意见修改 → 重新提交审核 关键:别只改文案就重提,包号/版本号/权限/隐私链接要同步对齐,否则二次驳回概率很高
待上架 审核过了,但设置了"定时上架"或还没到上架时间 应用信息/版本信息 ❌ 不能改;但上架时间可编辑 ,也可手动发布 ​ / 撤销上架 提前手动发布 / 调整上架时间 / 撤销上架(无需人工审核) "撤销上架"很多人不敢点,但它就是让你把"定时发布"收回来重新整理,不丢人
已上架 线上用户在用 ❌ 不能直接编辑(锁住) 继续发新版本(升级版本)或走下架相关操作 最经典的误解:"我只改个截图/简介,为啥不让保存?"------因为已上架=审核通过的快照,要改就新版本或走允许的Listing路径
已撤销上架("待上架"里点了撤销的结果) 你把"即将上架"的计划撤掉了 ✅ 可编辑 重新走提审/发布流程 状态名容易误导新人:它不是"被惩罚",而是"你主动收回定时上架"
下架处理中 已上架 → 申请下架(下架要审核) 等待审核期间 撤销下架申请(反悔) 别在下架处理中等着"立刻生效"------它要过流程;想快就提前规划上架时间策略
被开发者下架 你申请的下架审核通过 ✅ 可编辑(整理完再上架) 编辑后重新提交上架 很多团队下架后就放着不管;正确做法是:下架只是止损,下个版本要在草稿/新版本里准备好再上
被下架(平台发起) 市场侧发现违规等问题 通常 ❌ 或受限制 走申诉/整改,按通知处理 这是红线状态:别用"再发一个版本"硬冲,先弄清整改要求

引用一句文档原话的要点:审核中和已上架的应用信息和版本信息无法编辑;如果需要编辑可以通过升级版本或更新应用信息的方式更新。


三、按"你会遇到的真实操作场景"逐个拆

场景1:新建应用,从0到第一次提审

你现在的操作链路应该是:

  1. AGC 创建应用(得到 App ID / 包名)

  2. 填应用信息(名称/分类/简介/截图/隐私政策链接等)------这一步你处于 准备提交(草稿),随便改都没事

  3. 上传包(HAP/APP等),配版本信息、上架时间策略

  4. 提交审核 ​ → 状态变成 正在审核

⚠️ 常见翻车点:

  • 版本号/versionCode 没升:上次失败草稿里遗留的旧包直接提,审核一跑就发现"你怎么拿老包来提"

  • 隐私链接与包内行为不一致 :比如包里请求了定位/存储,但隐私页没写清楚用途/没写退路(被驳回后会进 待修改


场景2:审核被驳回 → 进"待修改",怎么改才不二次打脸

驳回后进 待修改 ,文档明确写了:"待修改状态的应用可以编辑,但是不能删除" ,你要按审核意见改完再 重新提交审核

但实操上建议你别只改"审核意见里点名那一行",按这个顺序走:

  1. 先读驳回原因的分类:是合规文字问题、截图问题、权限声明问题,还是功能不可用/支付/隐私问题?

  2. 做"配套修改"

    • 如果驳回点是"隐私协议内容/链接不规范" → 不光改 AGC 的链接,还要确认包里任何隐私入口/文案一致(参考上一篇我们聊过的:隐私链接变更往往要升版)

    • 如果驳回点是"截图/宣传图不符合规范" → 替换素材后,确认分辨率/比例/不含手机状态栏等

  3. 升版本号(versionCode/versionName):即便你觉得"我就改了文字",也建议升一个 patch 位------这会让审核员和你的发布记录都更清晰

  4. 同一份 CHANGELOG / 备注写上:驳回原因 + 你做了什么整改(审核备注栏别空着)

  5. 重新提交审核

核心原则:"待修改"不是让你"原地修补",而是让你带着一个新姿态重新敲门。


场景3:审核通过但你设了"定时上架"→ 停在"待上架"

审核通过后没立刻上架,状态就是 待上架

你能做的两件事最重要:

  • 手动发布:不等时间,直接点上架(如果你们准备好了)

  • 撤销上架 :发现"完了我这版还有个问题来不及修"→ 点 撤销上架 ,它不需要人工审核,撤销后你回到可编辑态去整理(文档也明确写了:撤销上架操作不需要人工审核

但注意:待上架状态下"应用信息和版本信息不能编辑",只能编辑上架时间或手动发布------所以"撤销上架"往往是更安全的选择,而不是硬等。


场景4:线上已上架,但发现文案/素材/隐私链接不对

一旦 已上架 ,文档说得很直白:无法编辑 ;要改就得走 升级版本​ 或"更新应用信息"的那套路径(不同字段走不同入口)。

落到团队动作上就是:

  • 如果是必须立刻止损 的问题:先考虑 申请下架 (进入 下架处理中 ,审核通过后变 被开发者下架

  • 同时开一个新版本分支:versionCode+1,把整改内容做进去

  • 重新提审时,备注写清楚:"下架止损原因 + 新版本整改点"

别做的事:不要在已上架状态试图用"覆盖素材/改链接但不升版"的侥幸心理------AGC 的锁就是防这个的。


场景5:申请下架 → 下架处理中 → 被开发者下架

你从已上架点"申请下架",状态变 下架处理中 ,期间还能 撤销下架申请

审核通过后变 被开发者下架,这时应用可编辑,整理完可重新上架。

这里最容易被忽略的点是:

  • 下架不是删除 :文档也强调 **"应用状态无法删除"**​

  • 所以别把"我下架了就可以随便把东西清掉"当结论------下架更多是"发行状态变化",不是抹除记录


四、团队级发布SOP:让状态机不为你制造惊喜

把 AGC 状态机纳入团队纪律,只需要一张 发布前检查单(Release Gate),每次提审前过一遍:

Release Gate(推荐最小集)

检查项 为什么
versionCode/ versionName是否严格递增 防"提了旧包/同名包"
包内权限声明 <uses-permission>与隐私页描述是否匹配 第一大驳回源
AGC 隐私政策链接 与 应用内打开的隐私URL 是否一致 第二大驳回源(且容易"看着对其实不对")
截图/宣传图是否来自同一套产物(别混旧稿) 审核会比对"你声明的设备类型/截图场景"
上架时间策略是否故意(立即 or 定时) 避免"我以为立即,结果是定时"
审核备注是否写清:本次范围 + 已知风险 帮审核员,也帮你自己

提审备注模板(照抄可用)

复制代码
【版本】1.2.3(1023)
【范围】修复XX权限描述不明确问题 / 替换XX截图 / 更新隐私政策链接至 v2
【风险】无已知用户数据变更 / 新增权限已在前置公告说明
【测试结论】XX设备通过冒烟,核心路径10分钟验证通过

五、总结

AGC 的应用状态不是"标签装饰",而是一个发布流程的锁机制

  • 准备提交:你随便改的草稿期 → 用完就提审,别长期囤

  • 正在审核:锁住 → 要改就撤销审核

  • 待修改:驳回修复期 → 改完升版号/对齐隐私/写备注再重提

  • 待上架:审核过但还没见用户 → 你可手动发、调时间、或撤销上架收回

  • 已上架:线上快照,不能直接编辑 → 改东西走新版本/正确入口

  • 下架处理中 / 被开发者下架:下架是流程,不是删除;整理好再上

  • 被下架(平台):红线,先整改再谈发版

把它当状态机理解,你就不再会觉得 AGC "这也不让改那也不让点"是废话------它其实是帮你避免:"线上跑的版本"和"你以为改完的版本"不一致

**HarmonyOS 6 应用发布成熟度 = 版本号纪律 + 隐私/权限一致性 + 一个敢写审核备注的工程师。**​ 状态机只是把这三件事强制执行出来而已。