swift-protocol-di-testing

Topics in the source

• 基于协议的 Swift 依赖注入测试
• 何时激活
• 核心模式
• 1. 定义小型、专注的协议
• 2. 创建默认（生产）实现
• 3. 创建用于测试的模拟实现
• 4. 使用默认参数注入依赖项
• 5. 使用 Swift Testing 编写测试

通过将外部依赖（文件系统、网络、iCloud）抽象为小型、专注的协议，使 Swift 代码可测试的模式。支持无需 I/O 的确定性测试。 编写访问文件系统、网络或外部 API 的 Swift 代码时 需要在未触发真实故障的情况下测试错误处理路径时 构建需要在不同环境（应用、测试、SwiftUI 预览）中工作的模块时 设计支持 Swift 并发（actor、Sendable）的可测试架构时 每个协议仅处理一个外部关注点。 生产代码使用默认值；测试注入模拟对象。 单一职责：每个协议应处理一个关注点——不要创建包含许多方法的“上帝协议” Sendable 一致性：当协议跨 actor 边界使用时需要 默认参数：让生产代码默认使用真实实现；只有测试需要指定模拟对象 错误模拟：设计具有可配置错误属性的模拟对象以测试故障路径 仅模拟边界：模拟外部依赖（文件系统、网络、API），而非内部类型 创建覆盖所有外部访问的单个大型协议 模拟没有外部依赖的内部类型 使用 #if DEBUG 条件语句代替适当的依赖注入 与 actor 一起使用时忘记 Sendable 一致性 过度设计：如果一个类型没有外部依赖，则不需要协议 任何触及文件系统、网络或外部 API 的 Swift 代码 测试在真实环境中难以触发的错误处理路径时 构建需要在应用、测试和 SwiftUI 预览上下文中工作的模块时 需要使用可测试架构的、采用 Swift 并发（actor、结构化并发）的应用