Capacitor 应用提交 Apple App…

当需要为 Capacitor 应用做 Apple 审核预检、或收到 Apple 拒审后要按指南逐项排查项目时使用。

适用场景

解决思路

1. 先确认任务范围属于 Apple 审核面向的工作（元数据、权限、隐私清单、登录、订阅、最小功能等），而不是单纯的截图、发布配置或上传机制；若主要是后者，应与 capacitor-app-store 技能配合使用。
2. 确定应用类型并加载对应检查清单：始终读取 references/guidelines/by-app-type/all_apps.md；再按应用类型追加 subscription_iap.md（订阅/IAP）、social_ugc.md（UGC/审核）、kids.md（儿童类）、health_fitness.md（健康健身医疗）、games.md（游戏）、ai_apps.md（AI/LLM）、crypto_finance.md（加密/金融）、vpn.md（VPN/网络）、macos.md（同时提交 macOS 时）；当拒审引用具体条款时用 references/guidelines/README.md 查完整索引。
3. 检查 Capacitor 与 iOS 项目状态：查看 package.json 中的 Capacitor、认证、分析、订阅及 SDK 依赖；查看 capacitor.config.* 中的应用标识、应用名、Web 资源配置与热更新设置；查看 ios/App/App/Info.plist 或项目对应的 Info.plist；查看所有 *.entitlements 文件；查看 PrivacyInfo.xcprivacy（若存在）；查看 fastlane/metadata 或其他本地元数据目录（若存在）。
4. 重点排查 Capacitor 特有的 Apple 审核风险：需要时缺少 Sign in with Apple 的第三方社交登录；纯 WebView 应用可能触发 4.2 最小功能问题；第三方 SDK 可能涉及 Required Reason API 声明或隐私披露；Xcode 中启用了但实际功能无法解释的原生能力；Capgo、Appflow 等热更新流程需要清晰的审核备注与合规边界；相机、相册、麦克风、定位、通知、Face ID、追踪、本地网络访问等缺少或含糊的用途说明字符串。
5. 按规则文件执行审查：以 references/rules/metadata/*.md、references/rules/subscription/*.md、references/rules/privacy/*.md、references/rules/design/*.md、references/rules/entitlements/*.md 为准，并映射到 Capacitor 应用——元数据规则对照 App Store 文案、截图、预览视频与审核备注；隐私规则对照 Info.plist、隐私清单、SDK 使用与数据收集流程；设计规则对照应用导航、原生价值、登录流程与审核可访问性；权限规则对照 iOS 项目中启用的能力。
6. 若 App Store 元数据未保存在本地且可用 asc，则执行 `asc metadata pull --output-dir ./metadata` 拉取；否则审查本地元数据来源，并明确说明哪些内容未能验证。
7. 按固定格式输出 Capacitor 预检报告：包含 Rejections Found（每条列出 [GUIDELINE X.X.X]、问题摘要、证据所在文件或元数据位置、对本 Capacitor 应用的影响、具体修复方案）、Warnings、Passed、Missing Inputs 四部分；按严重程度排序，每条修复要具体可执行。
8. 在相关时起草审核备注，覆盖：演示账号或测试凭据、隐藏或不明显的功能、硬件依赖、订阅测试流程、AI 审核或内容控制、热更新行为及审核后可变更的代码、特殊权限或网络行为的理由。
9. 错误处理：本地无元数据且未配置 asc 时，继续做代码与项目审查，并明确标注元数据检查为部分完成；应用基本是薄 Web 包装时，直接点出 4.2 风险而非埋在警告里；存在社交登录时，先确认 4.8 是否要求 Sign in with Apple 再判断认证流程是否审核安全；第三方 SDK 暗示使用 Required Reason API 时，先检查 PrivacyInfo.xcprivacy 再假设隐私合规；用户询问如何修复具体拒审时，优先处理被引用的条款，再扩展到相邻风险。

适用边界 · 注意事项

• 不适用于 Google Play 审核。
• 不适用于仅做通用商店发布（截图、发布配置、上传机制）的场景。
• 不适用于非 Apple 的移动运行时。