SuperAPI AI 工具集

ios-clean-architecture

编程与开发

查看项目

更新于 10-16 07:12

技能介绍

iOS Clean Architecture 是一个面向 iOS/Swift 开发的技能,遵循 Essential Developer 方法论,用于指导构建模块化、可测试的应用程序。其核心是整洁架构与面向协议设计,通过明确的分层和协议边界,让业务逻辑与 UI 框架解耦。

用途 该技能用于在开发 iOS/Swift 应用时提供架构约束和实现指引,帮助开发者按整洁架构组织代码,使功能模块可独立测试、可替换、可组合。它适用于从零开始新功能,也适用于对现有代码进行现代化改造。

主要能力 技能定义了一套代理行为契约,要求:功能模块零 UIKit/SwiftUI 导入,仅依赖 Foundation;领域模型、用例、presenter 和 API/缓存逻辑不依赖 UI 框架;在每层转换处定义协议边界(如 FeedStore、HTTPClient、ResourceView、FeedCache);领域模型为值类型(struct、Hashable、Sendable);展示逻辑与框架无关,presenter 输出视图模型(struct);所有依赖装配在 Composition Root 完成;测试驱动设计,每个用例一个测试类,按行为命名,使用 makeSUT() 工厂;使用 SPM 多目标包分离模块;优先使用 async/await 而非闭包/Combine;新测试使用 Swift Testing(@Test、#expect);共享可变状态标记 @MainActor。

架构分层 技能将架构分为 Feature(领域模型与抽象用例协议,仅 Foundation)、API(端点枚举、静态映射器、HTTPClient 协议)、Cache(存储协议、本地模型、用例编排器、缓存策略对象)、Presentation(通用 LoadResourcePresenter、视图模型 struct、本地化错误字符串)、UI(UIKit 或 SwiftUI 视图层,遵循 presenter 视图协议)、Composition(组合器静态工厂、适配器、代理,仅应用目标)。

关键模式 技能列出多种可复用模式,包括 LoadResourcePresenter<Resource, View>(通用加载/错误/成功状态机)、WeakRefVirtualProxy<T>(打破 presenter 到 view 的循环引用)、Specification Pattern(协议驱动的共享测试规格)、Composition Root/Service(集中依赖创建与装配)、UI Composer(按功能连接 presenter→adapter→view)、LoadResourcePresentationAdapter(通用异步加载器,桥接用例与 presenter,支持取消)、FeedViewAdapter(将领域模型映射为 CellController 数组,组合递归 loadMore)、Paginated<Item>(递归分页,可选 loadMore 闭包)、Static Mapper(纯函数数据转换)、Cache Policy(缓存验证业务规则封装)、Local Model(与领域解耦的缓存层表示)、Scheduler 协议(抽象存储执行上下文)、CellController(类型擦除的 cell 组合)。

使用方式 技能提供功能实现决策树:定义领域模型 → 需要远程数据则添加端点枚举与静态映射器 → 需要持久化则添加存储协议、本地模型与缓存策略 → 需要展示则添加 LoadResourcePresenter 与视图模型 → 选择 UIKit 或 SwiftUI 构建视图层并遵循 ResourceView 协议 → 在 Composition Root 中通过组合器、适配器、代理完成装配。技能还包含现代化说明:使用 SPM 多目标包替代 xcframework;新测试套件使用 Swift Testing;HTTPClient 返回 async throws;SwiftUI 组合中用 @Observable 视图模型替代 WeakRefVirtualProxy,用 ForEach + @ViewBuilder 替代 CellController 类型擦除,通过 .environment() 注入依赖。

适用场景 适用于需要长期维护、高可测试性、模块化分离的 iOS/Swift 项目,尤其是采用整洁架构、面向协议设计、SPM 多模块、Swift Testing 和 async/await 的团队。也适用于将现有 UIKit 或 SwiftUI 代码向整洁架构迁移的场景。

限制 技能本身是架构指导,不提供具体业务实现;部分模式(如 WeakRefVirtualProxy、CellController)主要针对 UIKit,SwiftUI 场景有替代方案;技能依赖 Essential Developer 方法论,可能不适用于所有团队或项目规模;具体代码示例需参考其引用的文档文件(architecture-layers.md、composition-and-adapters.md、testing-strategy.md、feature-implementation-workflow.md、spm-project-structure.md)。