用途:为构建 SwiftUI 视图与组件提供最佳实践与示例驱动的指导,覆盖导航层级、自定义视图修饰符和响应式布局等主题。
主要能力:提供两条上手路径。已有项目可按功能或屏幕与主要交互模型(列表、详情、编辑器、设置、标签页)定位,用 rg "TabView(" 等搜索仓库中的相近示例并阅读最接近的 SwiftUI 视图,随后套用本地约定:优先 SwiftUI 原生状态,尽量把状态保持在局部,共享依赖用 environment 注入。新项目脚手架则从 references/app-wiring.md 开始,串联 TabView + NavigationStack + sheets,并基于提供的骨架添加最小 AppTab 与 RouterPath,再按首个所需 UI 选择组件参考,随新屏幕扩展路由与 sheet 枚举。
使用方式与规范:使用现代状态工具(@State、@Binding、@Observable、@Environment),避免不必要的视图模型;若部署目标包含 iOS 16 或更低且无法使用 iOS 17 引入的 Observation API,则回退到 ObservableObject 搭配 @StateObject(根持有)、@ObservedObject(注入观察),仅真正全局共享状态用 @EnvironmentObject。优先组合、保持视图小而聚焦;异步用 async/await 配合 .task 与显式 loading/error 状态;为 .task 的重启、取消与防抖可参考 references/async-state.md。状态所有权需按场景选最窄工具(局部 @State、子改父 @Binding、iOS 17+ 根级 @Observable、共享服务 @Environment 等),先确定所有权位置再选包装器。
参考资源与反模式:交叉引用包含 navigationstack、sheets、deeplinks、app-wiring、async-state、previews、performance 等文档;组件参考以 references/components-index.md 为入口。反模式包括:巨型视图混合布局、业务逻辑、网络、路由与格式化;用多个布尔标志表达互斥的 sheet/alert/导航目标;在 body 驱动的代码路径中直接调用实时服务;用 AnyView 规避类型不匹配;无明确所有权理由就把共享依赖默认设为 @EnvironmentObject 或全局路由。
限制:资料未提供该集合的收费、授权、平台支持范围或安装命令等细节,暂未提供。