用途:把 Capacitor 应用从“本机可运行”推进到“双商店上线”,减少上传与审核失败。适用于准备 App Store Connect 或 Google Play Console 的首次发布或更新、上传处理失败(ITMS 错误、Play 版本/target API 错误)、需要截图尺寸、图标要求、商店字段、隐私表单或分阶段发布选项,以及查询当前商店要求的 Xcode/SDK 或 target API 级别。不适用于按 App Review Guidelines 审查应用或回答拒审、编写 CI 流水线、Capgo 云端构建/签名、以及审核通过后的 Web 热更新。
主要能力:先读取项目快照确认 Capacitor 包与版本、iOS 场景生命周期文件(SceneDelegate.swift)、variables.gradle 的 SDK 值及隐私清单是否存在;协助选择发布路径(手动 Xcode Organizer + Play Console、CLI/CI、Capgo Cloud Build);处理版本与构建号递增(iOS 的 MARKETING_VERSION/CFBundleShortVersionString 与 CURRENT_PROJECT_VERSION/CFBundleVersion,Android 的 versionName 与 versionCode,versionCode 上限 2100000000);执行 npm run build && npx cap sync;参考 iOS、Android 提交及素材元数据三类文档;提供分阶段发布建议并对常见错误给出修复方向(如 ITMS-4238 增加构建号、ITMS-90062/90186 提高营销版本、ITMS-90725 用所需 Xcode 构建、ITMS-91053/91061 隐私清单、ITMS-90683 用途字符串、Play 版本号已用、target API 错误、调试签名或密钥错误、生产轨道不可用需完成 12 名测试者 14 天封闭测试等)。
必要用法:命令与文件字段保持原样,如 npm run build、npx cap sync、./gradlew bundleRelease;iOS 构建号改 Xcode 构建设置而非 Info.plist 字面值;提交前建议运行 capacitor-apple-review-preflight。要求日期可能变化,临近截止时应以 Apple 与 Google 官方要求页为准。
限制:资料未提供具体价格、安装方式或效果保证;部分商店要求有明确生效日期,实际执行前需核实。