clean-architecture-swiftui

项目简介

clean-architecture-swiftui 是一个展示如何在 SwiftUI 应用中实现清晰架构的示例项目。本项目使用了 SwiftUI 和 Combine 框架，通过调用 restcountries.com 的 REST API 来显示国家列表及其详细信息。这个项目不仅适合初学者学习使用 SwiftUI 和架构模式，也为构建大规模的生产应用提供了模板。

主要功能

原生 SwiftUI + Combine 实现：项目完全基于 SwiftUI 和 Combine 构建，简化了代码设计。
解耦展示、业务逻辑和数据访问层：每一层各司其职，避免相互依赖。
全面的测试覆盖，包括 UI 测试：使用 ViewInspector 进行完整的用户界面测试。
类似 Redux 的中心化 AppState：作为应用状态的唯一真相来源。
使用 CoreData 的数据持久化。
本地 SwiftUI 依赖注入。
程序化导航：支持深度链接的推送通知。
基于泛型的简易但灵活的网络层。
系统事件处理：如 didBecomeActive、willResignActive。
符合 SOLID、DRY、KISS、YAGNI 原则。
设计具有可扩展性：可作为构建大型生产应用的参考。

架构概览

展示层

展示层由 SwiftUI 视图组成，专注于状态呈现而无业务逻辑。用户操作（如点击按钮）或视图生命周期事件（如 onAppear）会触发副作用，并将请求发送至 Interactors。所有的状态和业务逻辑层（AppState + Interactors）通过 @Environment 本地注入到视图层次结构中。

业务逻辑层

业务逻辑层由 Interactors 表示。Interactors 接收任务请求，例如从外部来源获取数据或进行计算，但从不直接返回数据。相反，它们将结果转发给 AppState 或 Binding。当数据仅用于一个本地视图且不属于 AppState 时，Binding 是很好的选择。之前版本没有持久层，所有加载的数据都存储在 AppState。引入持久层后，可以选择将数据库内容加载到 AppState，或通过 Binding 按需从 Interactors 提供数据。

数据访问层

数据访问层由 Repositories 表示。Repositories 提供异步 API（通过 Combine 的 Publisher）在后端或本地数据库中进行 CRUD 操作。它们不包含业务逻辑，也不修改 AppState。Repositories 仅可被 Interactors 访问和使用。

整个项目展示了如何在 iOS 生态系统中利用清晰架构模式，通过分离关注点提升代码的可维护性和可扩展性，是构建高质量应用的优秀示例。