用途:在 iOS 移植后,针对一个明确声明的目标执行有边界的只读预检,输出基于证据的就绪报告。它不是 App Store 批准,不能替代归档验证、App Store Connect 元数据、TestFlight、法务审查或人工 App Review。
必要范围:需明确目标目录/模块、bundle target 或 scheme(若存在)、已批准的 parity 契约、后端/数据采集契约以及许可/来源记录。若目标、后端契约、许可或发布预期含糊,应停止。
安全约束:不编辑元数据、entitlements、隐私清单、资产、源码、签名、配置文件或 App Store Connect 记录;不归档、上传、提交、公证、创建凭据、安装工具、下载运行时或接受 Apple 许可;不索取或暴露证书、配置文件、令牌、客户数据、私有 URL 或生产凭据。仅检查声明的目标与已批准的支持文件,可选日志须放在明确批准的一次性目录。
预检内容:bundle 标识符、版本/构建值、部署目标、支持设备、方向与必需能力;Info.plist 用途说明、隐私清单声明、跟踪/数据采集声明与后端数据流一致性;entitlements、后台模式、网络/ATS 选择、权限、深链、通知及账号/删除行为;应用图标、启动处理、资产来源、字体、第三方 SDK 清单、依赖许可与署名;无障碍证据(标签、特征、焦点顺序、Dynamic Type、对比度、减弱动态效果、辅助技术可达性);发布配置、调试标志、日志、测试钩子、崩溃路径、本地化、面向用户的错误/空/离线状态;可用的确定性检查及现有构建、模拟器或 XCUITest 证据。规则可能变化时查阅当前 Apple 文档,并将推断标注为推断。
工具用法:可用时使用内置 scripts/native-port.mjs audit guardrail 做有界静态检查,其 preflightOnly: true 与 guaranteedApproval: false 视为不变量,不能替代人工发布评审。
报告格式:返回检查范围与证据;PASS、WARN、FAIL、BLOCKED 或 NEEDS HUMAN 的发现表及最小下一步;隐私、权限、无障碍、许可、后端契约摘要;已证实的平台门禁与不可用门禁;供人工决策的发布负责人清单;明确结论:preflight ready、preflight blocked 或 not ready。仅当无本地失败且必需门禁未被阻塞时用 preflight ready,并仍说明不保证 App Store 批准。