Swift/XCTest 测试技能

针对 Swift 6 macOS/iOS 应用程序的专家级 XCTest 模式。专为 SwiftData、EventKit、SwiftUI 和严格并发而设计。

使用时机

在以下情况下使用此技能：

• - 为 Swift 6 应用程序编写 XCTest
• 使用内存容器测试 SwiftData 模型
• 测试 Swift 6 参与者和 @MainActor 隔离
• 测试 EventKit 集成
• 测试 SwiftUI 视图和 @Observable ViewModel
• 为 macOS 应用编写性能测试

核心原则

1. SwiftData 测试模式

swift
import SwiftData
import XCTest

@MainActor
final class ModelTests: XCTestCase {
var container: ModelContainer!
var context: ModelContext!

override func setUp() async throws {
try await super.setUp()
// 使用内存配置进行隔离测试
let config = ModelConfiguration(isStoredInMemoryOnly: true)
container = try ModelContainer(for: YourModel.self, configurations: config)
context = container.mainContext
}

override func tearDown() async throws {
container = nil
context = nil
try await super.tearDown()
}
}

2. Swift 6 参与者测试

swift
@MainActor
final class ServiceTests: XCTestCase {
var service: YourActor!

override func setUp() async throws {
try await super.setUp()
service = YourActor()
}

func testActorMethod() async throws {
// 参与者隔离测试与异步操作自然配合
let result = try await service.method()
XCTAssertEqual(result, expected)
}
}

3. 给定-当-则模式

swift
func testFeature() async throws {
// 给定：设置初始状态
let task = service.createTask(title: 测试)

// 当：执行操作
task.complete()

// 则：验证结果
XCTAssertTrue(task.isCompleted)
}

4. 测试组织

swift
@MainActor
final class FeatureTests: XCTestCase {
// MARK: - 属性
// 测试依赖

// MARK: - 设置与清理
// setUp/tearDown 方法

// MARK: - 单元测试
// 隔离测试

// MARK: - 集成测试
// 跨组件测试

// MARK: - 边界情况
// 边界和错误条件

// MARK: - 性能测试
// 性能基准测试
}

测试指南

SwiftData 模型

• - 始终使用 ModelConfiguration(isStoredInMemoryOnly: true)
• 使用 @MainActor 标记测试类
• 在变更后使用 try context.save()
• 使用 FetchDescriptor 和 #Predicate 验证状态

参与者与并发

• - 与参与者交互的测试类应为 @MainActor
• 对所有参与者方法使用 await
• 在适当情况下使用 nonisolated 测试隔离边界

SwiftData 服务

• - 使用内存模式：YourService(inMemory: true)
• 测试获取、创建、更新、删除操作
• 使用谓词验证 FetchDescriptor 查询

EventKit 模拟

• - 模拟 EKEventStore 进行隔离测试
• 测试权限处理场景
• 验证 EKReminder 到模型的映射

SwiftUI 视图

• - 使用 @Testable import 访问内部类型
• 测试 @Observable ViewModel 行为
• 测试状态转换和副作用

最佳实践

1. 1. 隔离性：每个测试应独立运行
2. 异步安全：对所有异步操作使用 async/await
3. MainActor：使用 @MainActor 标记 SwiftData 测试
4. 性能：对关键路径使用 measure 代码块
5. 可读性：使用给定-当-则注释
6. 组织性：使用 // MARK: 部分对测试进行分组

性能测试

swift
func testPerformance() async throws {
measure {
// 需要测量的代码
_ = service.process(data: largeDataSet)
}
}

常见测试模式

批量查询测试

XCTAssertEqual(results.count, 100)
XCTAssertLessThan(duration, 0.5, 批量查询应快速完成)
}

谓词测试