基于 Swift 协议的依赖注入（Testing）

基于 Swift 协议的依赖注入（Testing）

通过将外部依赖（文件系统、网络、iCloud）抽象到精简且功能集中的协议（Protocols）后面，使 Swift 代码变得可测试。这种模式支持无需实际 I/O 即可进行确定性测试（Deterministic Tests）。

何时激活

• 编写访问文件系统、网络或外部 API 的 Swift 代码时
• 需要在不触发实际故障的情况下测试错误处理路径时
• 构建需要在不同环境（App、测试、SwiftUI 预览）下运行的模块时
• 使用 Swift 并发（Concurrency，如 Actor、Sendable）设计可测试架构时

核心模式

1. 定义精简且功能集中的协议

每个协议应仅处理一个特定的外部关注点。

// 文件系统访问
public protocol FileSystemProviding: Sendable {
    func containerURL(for purpose: Purpose) -> URL?
}

// 文件读写操作
public protocol FileAccessorProviding: Sendable {
    func read(from url: URL) throws -> Data
    func write(_ data: Data, to url: URL) throws
    func fileExists(at url: URL) -> Bool
}

// 书签存储（例如：用于沙盒应用）
public protocol BookmarkStorageProviding: Sendable {
    func saveBookmark(_ data: Data, for key: String) throws
    func loadBookmark(for key: String) throws -> Data?
}

2. 创建默认（生产环境）实现