# iOS 与 HarmonyOS 应用商店监测

租户平台的 Update 服务可以监测 App Store Connect 和华为 AppGallery Connect
中的正式应用版本。当前能力是只读监测，不会代替开发者上传 IPA/HAP、提交审核、
立即发布或撤回审核。

## 能监测什么

- 当前已上架版本
- 等待审核和审核中版本
- 审核通过、等待开发者发布的版本
- 审核拒绝版本
- 中国大陆地区是否实际可下载
- 官方后台直接提交、并非通过 Xuqm 创建的外部版本

“审核通过”不代表“已上架”。只有中国大陆用户已经能够从对应应用商店下载时，
租户平台才会显示“已上架”。

## 配置监测

1. 进入目标应用的 **Update 服务 > 应用商店监测**。
2. 选择 Apple App Store 或 HarmonyOS 应用市场。
3. 填写 Bundle ID/包名和商店链接。
4. 新增只读监测凭据。
5. 保存后点击 **立即同步** 验证连接和读取权限。

凭据保存成功后不会再次显示原文。更换凭据时直接提交一份新凭据即可。

## 通知

应用商店通知默认关闭。可以按应用选择：

- 邮件
- 签名 Webhook

没有启用通知时，平台仍会同步商店状态并保留事件历史。Update 服务不依赖 IM。

## 配置已上架版本为更新

从商店发现的版本不会自动成为客户端更新。确认版本已经在中国大陆上架后：

1. 在商店版本记录中点击 **创建 Xuqm 更新草稿**。
2. 平台创建一条“跳转应用商店”类型的更新草稿。
3. 配置更新说明、是否强制更新、灰度范围和发布时间。
4. 人工确认发布。

同一个商店版本只能关联一条有效更新记录。审核中、待发布、部分地区可用或状态
未知的版本不能创建客户端更新。

## 常见状态

| 状态 | 说明 |
| --- | --- |
| 等待审核 | 已准备提交或等待官方开始审核 |
| 审核中 | 官方正在审核 |
| 审核拒绝 | 需要开发者在官方后台处理 |
| 审核通过待发布 | 已通过，但尚未向用户发布 |
| 商店处理中 | 已进入分发处理，暂未确认可下载 |
| 已上架 | 中国大陆地区已经实际可下载 |
| 同步失败 | 本次无法读取官方状态，历史已验证状态不会被覆盖 |

## 当前边界

iOS/HarmonyOS 的构建上传、自动提审和审核后立即/定时发布正在进行正式设计，
当前页面不会显示无法执行的操作。Android 应用商店发布能力按 Android 文档执行。