ios-xcode

iOS Xcode 与工具最佳实践

关于 Xcode 项目配置、SwiftData 持久化、测试、调试、性能分析和应用分发的综合指南。包含 6 个类别中的 19 条规则。

诊所架构规范（iOS 26 / Swift 6.2）

本技能中的所有指导均基于诊所模块化 MVVM-C 架构：

• 功能模块仅导入 Domain + DesignSystem（绝不导入 Data，也不导入同级功能模块）
• App 目标是汇合点，拥有 DependencyContainer、具体协调器和 Route Shell 连接配置
• Domain 保持纯 Swift，并定义模型以及 repository、*Coordinating、ErrorRouting 和 AppError 契约
• Data 负责 SwiftData/网络/同步/重试/后台 I/O，并实现 Domain 协议
• 读写流程默认采用过期即重新验证读取和乐观排队写入
• ViewModel 直接调用 repository 协议（不设默认的 use-case/interactor 层）

适用场景

在以下情况下，请参考这些指南：

• 使用 AppStorage、ScenePhase 或小组件配置 Xcode 项目
• 实现 SwiftData 模型、查询和 CRUD 操作
• 使用 Swift Testing 框架编写测试
• 使用断点和控制台输出进行调试
• 使用 Instruments 分析性能
• 通过 TestFlight 分发应用
• 为 visionOS 构建应用或集成 ML 功能

按优先级划分的规则类别

优先级	类别	影响	前缀
1	SwiftData 与持久化	严重	data-
2	项目与平台	高	platform-
3	测试	高	test-
4	调试与性能分析	中高	debug-、perf-
5	分发	中	dist-
6	专业平台	中	ml-、spatial-

快速参考

1. 项目与平台（高）

• platform-app-storage - 使用 AppStorage 存储用户偏好设置
• platform-scene-phase - 使用 ScenePhase 响应应用生命周期
• platform-widget-integration - 为小组件和 Live Activity 集成进行设计
• platform-system-features - 以原生方式集成系统功能

2. SwiftData 与持久化（严重）

• data-model-macro - 使用 @Model 宏定义模型
• data-query-for-fetching - 使用 @Query 获取数据
• data-model-container - 配置模型容器
• data-relationships - 定义模型关系
• data-crud-operations - 实现 CRUD 操作

3. 测试（高）

• test-swift-testing - 使用 Swift Testing 框架
• test-preview-sample-data - 创建预览示例数据
• test-preview-macro - 使用 #Preview 宏快速迭代

4. 调试与性能分析（中高）

• debug-breakpoints - 使用断点进行调试
• debug-console-output - 使用控制台输出进行调试
• perf-instruments-profiling - 使用 Instruments 分析 SwiftUI 性能

5. 分发（中）

• dist-testflight - 通过 TestFlight 分发
• dist-app-icons - 设计用于分发的应用图标

6. 专业平台（中）

• ml-natural-language - 集成 Natural Language ML
• spatial-visionos-windows - 为 visionOS 空间计算构建应用

使用方法

请阅读各个参考文件，了解详细说明和代码示例：

• 章节定义 - 类别结构和影响级别
• 规则模板 - 添加新规则的模板

参考文件

文件	描述
references/_sections.md	类别定义和排序
assets/templates/_template.md	新规则模板