用途:为构建 iOS 17+/macOS 14+ 的 SwiftUI 应用提供开发指导,适用于编写 SwiftUI 视图、管理状态和搭建 Apple 平台界面。
主要能力:按工作流给出建议——先评估目标平台(iOS、macOS、visionOS、watchOS)、最低系统版本与复杂度;再选择架构,简单视图用 @State,复杂功能用 MVVM 配合 @Observable 宏,共享数据用 @Environment;随后应用状态管理、遵循 HIG 原则并做性能优化。
状态管理要点:@State 用于本地值类型与 @Observable 对象,@Binding 用于与父级双向绑定,@Environment 用于全局共享数据,@Observable 用于 iOS 17+ 的现代可观察对象。
HIG 与无障碍:触控目标最小 44×44 点,正文最小 17pt 并支持 Dynamic Type,使用语义颜色(.primary、.secondary),为交互元素添加 .accessibilityLabel 与 .accessibilityHint。
性能建议:抽取可复用子视图,列表使用 LazyVStack/LazyHStack,避免在 body 中做重计算,保持状态最小且局部化。
示例覆盖:带开关的设置页、带导航的列表、异步数据加载(含加载中、错误与下拉刷新)。
限制与注意:不要对引用类型使用 @State,不要在视图中用 @ObservedObject 创建对象,不要硬编码颜色与尺寸,不要忽略 44×44pt 触控目标与无障碍标签。资料另提及 iOS 18+ 特性(浮动标签栏、.presentationSizing(.form)、缩放导航转场、控制中心小组件、@Entry 宏、网格渐变)及 reference/ 目录下的 state-management.md 与 hig-checklist.md。具体安装命令与收费信息暂未提供。