用途:把现有 React Native/Expo(含 Expo)应用中的一个已明确批准的功能切片,移植到声明的 SwiftUI 目标目录与模块,保持既有 parity 契约,不进行通用的 JSX 到 Swift 翻译。
安全前置条件:开始前需要明确批准的功能切片及当前 parity 契约、明确的目标目录与目标模块、已批准的后端契约与许可/来源决定,以及更改命名文件或在目标目录内创建文件的授权。若源范围、目标模块、后端契约、许可、parity 期望或文件归属不清晰,必须停止且不做编辑。“移植整个应用”之类宽泛请求不等于批准多个切片。
写入边界:只能在声明目标目录或明确批准的一次性验证目录内写入源码、测试、夹具、缓存与生成产物;不得写入 React Native 源、插件包、仓库根、同级模块、主目录或无关路径,不得覆盖无关 Swift 文件。可用时先运行 scripts/native-port.mjs 的 authorize-write 防护,拒绝即为停止条件。不得安装 Xcode、XcodeGen、模拟器运行时或接受 Apple 许可;不得复制源码、资产、凭证或客户数据。
实现方式:每个已批准契约行为映射为小型 Swift 实现单元;验证、状态转换、解析、确定性序列化与业务规则放入不导入 SwiftUI/UIKit 的纯 Swift 类型或模块;SwiftUI 视图保持轻量,平台桥接隔离在边缘;保持已批准的后端请求/响应、认证、缓存、持久化、错误与离线行为;为领域不变量添加确定性检查与合成夹具(固定时钟、种子随机、稳定 ID、显式本地化/时区输入),并添加契约要求的无障碍语义与稳定标识符。
验证与报告:运行最小的确定性检查;若缺少 Xcode/模拟器/XCUITest 前置条件,应报告被阻塞的网关,不得安装或声称通过。完成报告列出变更文件(相对目标目录)、已实现/适配/推迟/被阻塞的契约行为、纯 Swift 领域边界与适配器、确定性检查结果、平台网关状态及剩余风险;无证据时不得声称切片已完成。