用途:为基于 clinic 模块化 MVVM-C 架构的 iOS 26 / Swift 6.2 项目提供 Xcode 工程配置与工具链实践参考,涉及工程配置、SwiftData 容器接线、测试、调试、性能分析与分发。
架构前提:Feature 模块仅可导入 Domain 与 DesignSystem;App target 作为汇聚点,持有 DependencyContainer、具体 coordinator 与 Route Shell 接线;Domain 保持纯 Swift,定义模型及 repository、*Coordinating、ErrorRouting、AppError 契约;Data 负责 SwiftData、网络、同步、重试与后台 I/O 并实现 Domain 协议;读写默认采用 stale-while-revalidate 读与乐观队列写;ViewModel 直接调用 repository 协议,不设默认的 use-case/interactor 层。
规则分类(按优先级):1) SwiftData 与持久化(关键,data-):@Model 定义模型、@Query 取数、model container 配置、模型关系、CRUD;2) 工程与平台(高,platform-):AppStorage 偏好设置、ScenePhase 生命周期、widget 与 Live Activity 集成、系统特性原生集成;3) 测试(高,test-):Swift Testing 框架、预览示例数据、#Preview 宏快速迭代;4) 调试与性能(中高,debug-、perf-):断点调试、控制台输出、Instruments 分析 SwiftUI;5) 分发(中,dist-):TestFlight 分发、应用图标设计;6) 专用平台(中,ml-、spatial-):Natural Language ML 集成、visionOS 空间计算。
使用方式:按需阅读各参考文件获取详细说明与代码示例,包括 references/_sections.md(类别定义与排序)与 assets/templates/_template.md(新增规则模板)。
适用场景:设置含 AppStorage、ScenePhase 或 widget 的 Xcode 工程,实现 SwiftData 模型与查询,使用 Swift Testing 编写测试,断点与控制台调试,Instruments 性能分析,TestFlight 分发,以及为 visionOS 构建或集成 ML 功能。
限制:全部指引以该 clinic 模块化 MVVM-C 架构为假设前提,不适用于其他架构;具体代码示例需查阅各参考文件,其他环境与版本适配暂未提供。