用途:降低 App Store 审核提交失败率并监控审核状态。当前就绪校验命令为 asc validate,不得使用已移除的 submit-preflight 与 submit-create 快捷方式。
前提:已配置认证并解析出 app/version/build ID;构建处理已完成,或使用带 --wait 的高层流程;元数据、应用信息、截图、审核详情、内容权利、加密、定价与可用性应已完整。
主要能力与用法:
- 校验构建:asc builds info --build-id "BUILD_ID",确认 processingState 为 VALID。
- 就绪校验:asc validate --app "APP_ID" --version "1.2.3" --platform IOS --output table;需警告即失败时加 --strict;已有版本 ID 时用 --version-id。
- 加密合规:asc encryption declarations list/create/assign-builds;仅豁免传输加密时可用 asc encryption declarations exempt-declare --plist "./Info.plist"。
- 内容权利:asc apps content-rights view/edit。
- 版本元数据与本地化:asc versions view、asc localizations list,以及 asc metadata pull/validate/push(push 可先 --dry-run)。
- 应用信息本地化与隐私政策:asc apps info list、asc localizations list --type app-info,订阅或 IAP 应用需设置隐私政策 URL。
- 截图:asc screenshots list/sizes/validate。
- 数字商品:asc validate iap、asc validate subscriptions(可 --output json --pretty)。
- App Privacy:公共 API 无法完全验证发布状态,可用实验性 web 会话流程 asc web privacy pull/plan/apply/publish,或手动在 App Store Connect 确认。
提交:已准备版本用 asc review submit(先 --dry-run 再 --confirm);上传并提交用 asc publish appstore --submit --confirm,可加 --wait;多审核项用 asc review submissions-create/items-add/submissions-submit;非续期 IAP 的 web-only 缺口可用实验性 asc web review iaps attach。
监控与取消:asc status、asc submit status、asc review submissions-list --paginate;取消用 asc submit cancel 或 asc review submissions-cancel。
限制:App Privacy 发布状态无法通过公共 API 完全验证;部分命令使用非官方 Apple web 会话端点,应在交接中记录;macOS 提交流程相同但使用 --platform MAC_OS。