SuperAPI AI 工具集

ios-navigation

通用与其它

查看项目

更新于 10-16 03:46

技能介绍

用途:为采用诊所模块化 MVVM-C 架构的 SwiftUI 应用提供有主见的导航规范,覆盖协调器与路由壳(route shell)的接线、功能模块隔离,以及稳定的 push、sheet 与深链流程。适用时机包括设计 NavigationStack 或 NavigationSplitView 层级、选择 push/sheet/fullScreenCover、实现英雄动画与手势驱动退场、构建多步骤流程、使用 @Observable 共享导航状态、添加深链与状态恢复、以及保证 VoiceOver 与减少动态效果支持。

主要约束(iOS 26 / Swift 6.2):每个导航视图使用 @Equatable 宏,禁用 AnyView;使用 @Observable,禁用 ObservableObject 与 @Published;App 目标层的协调器持有 NavigationPath,路由壳负责 .navigationDestination 映射;模态状态由协调器持有,禁止内联 @State 布尔值控制 sheet;Domain 层定义协调器协议,具体协调器不进入功能模块。

架构契约:功能模块只导入 Domain 与 DesignSystem;App 目标是汇聚点,持有 DependencyContainer、具体协调器与 Route Shell 接线;Domain 保持纯 Swift,定义模型及仓库、*Coordinating、ErrorRouting、AppError 契约;Data 负责 SwiftData、网络、同步、重试与后台 I/O;读写默认采用 stale-while-revalidate 与乐观排队写入;ViewModel 直接调用仓库协议,无默认用例层。

规则按优先级分为八类:导航架构(arch-)、导航反模式(anti-)、转场与动画(anim-)、模态呈现(modal-)、流程编排(flow-)、导航性能(perf-)、导航无障碍(ally-)、状态与恢复(state-),各含具体规则。详细说明与代码示例需阅读 references/_sections.md、assets/templates/_template.md 与 metadata.json 等参考文件。安装方式、具体命令与价格暂未提供。