用途:该技能为仍以 Storyboard 为主的遗留代码提供互操作与维护指导,适用于在 Xcode Interface Builder 中创建或修改 Storyboard 场景、配置 Auto Layout、设计 segue 导航、设置尺寸类与 trait 变体、审查 Storyboard XML 差异与解决合并冲突。不用于新功能开发。\n\n主要能力:包含 45 条规则,分 8 类并按影响优先级排序,含前缀便于检索。\n- Storyboard 架构(关键,arch-):拆分巨型 Storyboard、使用 Storyboard References 跨模块导航、每个 Storyboard 只放一个用户流程、显式设置初始视图控制器、避免硬编码标识符、场景命名、抽取可复用 XIB。\n- Auto Layout(关键,layout-):避免固定宽高、用 Leading/Trailing、约束到安全区、设置内容抱紧与压缩阻力、约束到最近邻居、用布局边距而非常量偏移、不等式约束、不同优先级。\n- 导航与 segue(高,nav-):用 prepare(for:sender:) 传数据、使用 unwind segue、避免混用 segue 与程序化导航、用 Show/Show Detail、用 shouldPerformSegue 校验、用容器视图嵌入子控制器。\n- 自适应与尺寸类(高,adapt-):用 Vary for Traits 按尺寸类配置、trait 变体调整字体与间距、全设备测试、大屏用可读内容参考线、支持 Dynamic Type。\n- 视图层级与 Stack View(中高,view-):优先 Stack View、嵌套不超过两层、依赖固有内容尺寸、自定义视图用占位固有尺寸、启用 Clip to Bounds、正确设置 UIImageView 内容模式。\n- 无障碍与 VoiceOver(中,ally-):设置无障碍标签与 traits、分组元素、为 UI 测试设置标识符、动态内容更新标签。\n- 版本控制与协作(中,vcs-):场景分配给个人、以源码方式审查差异、Git 文件锁定、配置 .gitattributes 使用 union 合并。\n- 调试与检查(中低,debug-):调试视图层级、hasAmbiguousLayout 检测约束、为约束设置标识符、移除失效 outlet。\n\n架构约定:假设诊所模块化 MVVM-C 架构——功能模块只导入 Domain 与 DesignSystem(不导入 Data 或同级功能);App target 为汇聚点,持有 DependencyContainer、具体协调器与 Route Shell 接线;Domain 保持纯 Swift,定义模型及 repository、*Coordinating、ErrorRouting、AppError 契约;Data 负责 SwiftData/网络/同步/重试/后台 I/O 并实现 Domain 协议;读写默认 stale-while-revalidate 读与乐观排队写;ViewModel 直接调用 repository 协议。\n\n使用方式:查阅各 reference 文件获取详细说明与代码示例;references/_sections.md 为分类定义与顺序,assets/templates/_template.md 为新规则模板,metadata.json 为版本与引用信息。\n\n限制:仅适用于遗留 Storyboard 维护与迁移,不适用于新 SwiftUI 功能开发;本资料未提供安装命令、收费方式与具体平台支持信息。
ios-storyboard
通用与其它
更新于 10-16 03:46