swift-composable-architecture

Swift Composable Architecture 项目介绍

Swift Composable Architecture（简称 TCA）是一个用于构建应用程序的库，它强调一致性和易于理解，以组合、测试和使用便利性为核心设计目标。TCA 适用于 SwiftUI、UIKit 以及其他苹果平台，包括 iOS、macOS、visionOS、tvOS 和 watchOS。

什么是 Swift Composable Architecture？

Composable Architecture 提供了一些核心工具，能用于构建各种目的和复杂程度的应用程序。这个库通过以下几种方式协助开发者解决应用开发中常见的问题：

• 状态管理
  管理应用程序的状态并在多个屏幕之间共享，使一个屏幕上的变化可以立即被另一个屏幕观察到。

• 组合
  如何将大型功能分解为更小的组件，这些组件可以被提取到独立的模块中，方便地整合回到整体功能中。

• 副作用
  让应用程序的某些部分最可测且易于理解地与外部世界进行通信。

• 测试
  为架构中的特性编写测试，编写集成测试来测试由多个部分组成的特性，以及编写端到端测试以理清副作用如何影响应用。这让开发者可以确保业务逻辑按预期运行。

• 使用便利性
  以简单的 API 实现所有功能，尽量减少概念和活动部件的数量。

基本使用方法

使用 Composable Architecture 构建功能模块时，需要定义以下类型和值来建模你的领域：

• 状态（State）：描述特性逻辑和 UI 渲染所需的数据。
• 动作（Action）：描述特性中可能发生的所有动作，如用户操作、通知、事件源等。
• Reducer：描述在给定动作时如何从当前状态进化到下一状态。处理器还负责返回要执行的副作用（可以通过 Effect 值返回，例如 API 请求）。
• 存储（Store）：驱动特性的运行时环境，接收所有用户动作以运行处理器和副作用，并观察状态变化以更新 UI。

例如，一个显示数字以及 "+" 和 "−" 按钮的 UI 示例。可以通过 TCA 实现让这些按钮和某个 API 请求进行互动，展示与数字相关的有趣信息。

测试

为了测试，可以使用 TestStore。它与 Store 类似，但还提供额外功能，允许你对功能如何随着动作发送而演变进行断言。例如，可以模拟用户流，验证状态的变化是否符合预期。

通过将依赖注入改进，库的许多特性（如副作用）可以轻松进行测试。这涉及在真实环境中传递真实依赖，但在测试中使用模拟依赖，从而以可控的方式测试功能。

示例和社区

本仓库提供了大量示例，展示如何使用 Composable Architecture 解决常见和复杂的问题。用户可以探索这些示例以获取更多高级使用方式和实践。

对于想要讨论 Composable Architecture 或有使用问题的用户，可以在 GitHub 的讨论区和 Slack 社区与其他用户交流。

安装

可以通过 Xcode 的包管理器将 ComposableArchitecture 添加到项目中。

希望贡献库的用户也可以通过提交 PR 来加入更多的社区支持库。

许可证

Swift Composable Architecture 根据 MIT 许可证发布。

通过这些功能，Swift Composable Architecture 为应用状态管理、功能组合、侧重质量的测试以及简单的 API 带来了全新的方法，是一个值得关注和使用的架构工具。