Quick SwiftObjective-C测试框架入门教程

前言

测试，这个词在开发中经常被提起，但却常常被忽视！（多少项目最后都是"没时间写测试"）Swift和Objective-C开发者们有福了，今天我要介绍一个让测试变得简单又有趣的框架 - Quick。

作为一个BDD（行为驱动开发）风格的测试框架，Quick让我们可以用更接近自然语言的方式编写测试。配合它的好搭档Nimble，简直就是iOS/macOS开发者的测试利器！

什么是Quick？

Quick是一个为Swift和Objective-C设计的行为驱动开发测试框架，它的灵感来源于Ruby的RSpec、JavaScript的Jasmine以及Objective-C的Kiwi。它允许开发者用一种更加描述性和结构化的方式来编写测试。

与传统的XCTest相比，Quick提供了一种层次分明的测试结构，使测试代码更易读、更易维护。（相信我，当你几个月后回来看自己写的测试代码时，你会感谢这种清晰的结构！）

为什么选择Quick？

在讲解如何使用Quick之前，我们先来看看为什么要选择它：

1. 描述性更强 - 测试读起来更像是规范文档
2. 结构化 - 使用嵌套的describe和context块组织测试
3. 简洁明了 - 与Nimble搭配使用，断言语法更直观
4. 跨语言支持 - 同时支持Swift和Objective-C
5. 活跃的社区 - 持续更新和改进

安装Quick

Quick的安装非常简单，有多种方式可以选择：

使用CocoaPods

# Podfile
target 'MyApp' douse_frameworks!target 'MyAppTests' doinherit! :search_pathspod 'Quick'pod 'Nimble' # Quick的好搭档end
end

然后执行:

pod install

使用Swift Package Manager

在Xcode中，选择File > Swift Packages > Add Package Dependency，然后输入Quick的GitHub仓库URL：https://github.com/Quick/Quick.git

同样，也别忘了添加Nimble：https://github.com/Quick/Nimble.git

使用Carthage

# Cartfile.private
github "Quick/Quick"
github "Quick/Nimble"

然后执行:

carthage update

Quick基本用法

好了，安装完成后，让我们开始使用Quick编写测试！

基本测试结构

Quick测试的基本结构包括：

• describe - 描述一个测试对象或测试场景
• context - 描述特定条件下的测试
• it - 描述单个测试期望
• beforeEach/afterEach - 在每个测试前/后执行的代码

下面是一个简单的例子：

import Quick
import Nimble
@testable import MyAppclass PersonTests: QuickSpec {override func spec() {describe("Person") {var person: Person!beforeEach {person = Person(name: "Alice", age: 25)}it("has the correct name") {expect(person.name).to(equal("Alice"))}it("has the correct age") {expect(person.age).to(equal(25))}context("when the birthday is celebrated") {beforeEach {person.celebrateBirthday()}it("increments the age by 1") {expect(person.age).to(equal(26))}}}}
}

看起来是不是很清晰？每个测试都描述了一个行为，而且代码结构反映了测试的逻辑层次。

使用Nimble进行断言

Quick通常与Nimble一起使用，Nimble提供了直观的断言语法。不再是XCTest中的XCTAssertEqual(a, b)，而是更加自然的expect(a).to(equal(b))。

基本断言

// 相等性
expect(1 + 1).to(equal(2))
expect("hello").to(equal("hello"))// 真假判断
expect(true).to(beTrue())
expect(false).to(beFalse())// nil检查
expect(nil).to(beNil())
expect(person).notTo(beNil())// 集合检查
expect([1, 2, 3]).to(contain(2))
expect([1, 2, 3]).to(haveCount(3))// 近似相等（浮点数）
expect(3.01).to(beCloseTo(3, within: 0.1))// 错误处理
expect { try riskyOperation() }.to(throwError())

异步测试

Nimble对异步测试的支持也非常友好：

// 等待异步操作完成
waitUntil { done inasyncOperation {// 异步操作完成后调用done()done()}
}// 或者使用toEventually
expect(asyncValue).toEventually(equal(expectedValue), timeout: .seconds(5))

高级特性

共享上下文

当多个测试用例需要相同的设置时，可以使用共享上下文：

// 定义共享上下文
sharedExamples("a collection with items") { (sharedExampleContext: @escaping SharedExampleContext) init("has at least one item") {let collection = sharedExampleContext()["collection"] as! [String]expect(collection).notTo(beEmpty())}
}// 使用共享上下文
describe("Array") {itBehavesLike("a collection with items") { ["collection": ["item"]] }
}describe("Set") {itBehavesLike("a collection with items") { ["collection": Set(["item"])] }
}

焦点和排除

在调试过程中，你可能只想运行某些特定的测试：

// 只运行这个测试
fit("is the only test that runs") {expect(true).to(beTrue())
}// 只运行这个组的测试
fdescribe("focused group") {// ...
}// 跳过这个测试
xit("is skipped") {expect(true).to(beTrue())
}// 跳过这个组的测试
xdescribe("skipped group") {// ...
}

实际项目示例

让我们通过一个更加实际的例子来巩固对Quick的理解。假设我们有一个简单的购物车类：

class ShoppingCart {var items: [Item] = []func add(item: Item) {items.append(item)}func remove(item: Item) {if let index = items.firstIndex(where: { $0.id == item.id }) {items.remove(at: index)}}var totalPrice: Double {return items.reduce(0) { $0 + $1.price }}func checkout() -> Bool {// 假设这里会调用支付APIlet success = items.count > 0if success {items = []}return success}
}struct Item: Equatable {let id: Stringlet name: Stringlet price: Doublestatic func ==(lhs: Item, rhs: Item) -> Bool {return lhs.id == rhs.id}
}

现在，让我们用Quick和Nimble来测试这个购物车：

class ShoppingCartSpec: QuickSpec {override func spec() {describe("ShoppingCart") {var cart: ShoppingCart!var item1, item2: Item!beforeEach {cart = ShoppingCart()item1 = Item(id: "1", name: "iPhone", price: 999.0)item2 = Item(id: "2", name: "iPad", price: 799.0)}context("when empty") {it("has zero items") {expect(cart.items.count).to(equal(0))}it("has zero total price") {expect(cart.totalPrice).to(equal(0.0))}it("cannot checkout") {expect(cart.checkout()).to(beFalse())}}context("when adding items") {beforeEach {cart.add(item: item1)}it("increases the item count") {expect(cart.items.count).to(equal(1))}it("includes the added item") {expect(cart.items).to(contain(item1))}it("updates the total price") {expect(cart.totalPrice).to(equal(999.0))}context("and then adding another item") {beforeEach {cart.add(item: item2)}it("increases the item count again") {expect(cart.items.count).to(equal(2))}it("includes both items") {expect(cart.items).to(contain(item1))expect(cart.items).to(contain(item2))}it("updates the total price correctly") {expect(cart.totalPrice).to(equal(1798.0))}}}context("when removing items") {beforeEach {cart.add(item: item1)cart.add(item: item2)cart.remove(item: item1)}it("decreases the item count") {expect(cart.items.count).to(equal(1))}it("removes the specified item") {expect(cart.items).notTo(contain(item1))expect(cart.items).to(contain(item2))}it("updates the total price") {expect(cart.totalPrice).to(equal(799.0))}}context("when checking out") {beforeEach {cart.add(item: item1)cart.add(item: item2)}it("returns success") {expect(cart.checkout()).to(beTrue())}it("empties the cart") {_ = cart.checkout()expect(cart.items).to(beEmpty())}}}}
}

这个测试用例覆盖了购物车的所有主要功能，而且组织得井井有条。即使几个月后再回来看，你也能一目了然地理解每个测试的目的。

与Objective-C一起使用

Quick不仅支持Swift，也支持Objective-C。下面是一个简单的Objective-C示例：

#import <Quick/Quick.h>
#import <Nimble/Nimble.h>
#import "Person.h"QuickSpecBegin(PersonSpec)describe(@"Person", ^{__block Person *person;beforeEach(^{person = [[Person alloc] initWithName:@"Bob" age:30];});it(@"has the correct name", ^{expect(person.name).to(equal(@"Bob"));});it(@"has the correct age", ^{expect(@(person.age)).to(equal(@30));});context(@"when the birthday is celebrated", ^{beforeEach(^{[person celebrateBirthday];});it(@"increments the age by 1", ^{expect(@(person.age)).to(equal(@31));});});
});QuickSpecEnd

测试驱动开发与Quick

Quick非常适合测试驱动开发（TDD）的工作流。TDD的基本步骤是：

1. 写一个失败的测试
2. 实现最小代码使测试通过
3. 重构代码保持测试通过

使用Quick，你可以先用自然语言描述期望的行为，然后实现代码来满足这些期望。

注意事项和最佳实践

1. 测试结构 - 使用合适的嵌套层次，避免过深的嵌套导致测试难以理解

2. 避免状态泄漏 - 确保每个测试后都清理状态，不要让一个测试影响另一个测试

3. 测试命名 - 使描述性语句尽可能清晰，它们实际上是你代码的文档

4. 不要过度测试 - 专注于测试公共API和关键业务逻辑，而不是每一个私有方法

5. 保持测试简单 - 每个测试应该只测试一个行为或概念

结语

Quick和Nimble使iOS/macOS开发中的测试变得更加愉快和高效。它们提供了一种表达性强、易于理解的方式来编写测试，帮助你构建更可靠的应用程序。

测试不应该是事后的想法，而应该是开发过程的核心部分！有了Quick和Nimble，你再也没有理由推迟编写测试了。（真的，现在就开始写测试吧！）

希望这篇教程能帮助你开始使用Quick进行测试。记住，好的测试不仅能捕获错误，还能作为代码的活文档，帮助新团队成员理解代码的意图和行为。

祝你测试愉快！

参考资源

• Quick GitHub仓库
• Nimble GitHub仓库
• Quick文档