Swift 中使用Nimble 库进行单元测试

Nimble 从字面上看是

敏捷，灵活

的意思。Nimble 是一个库，一个

断言库

。这个库一般用于单元测试。Xcode 6 为我们集成了

XCTest

单元测试库。在正式介绍 Nimble 之前，我们有必要先介绍一下

XCTest

。我们在使用 Xcode 新建项目的时候会发现它为我们创建了两个

Target

，一个是我们项目的

Target

还有一个就是测试

Target

。



我们看到了 Xcode 为我们自动生成的

Target

，我们按下 Command + U 即可运行测试项目，并且在 Xcode 的左边会显示测试结果：



让我们看看测试项目中的代码,

MyTestTests.swift

：

import UIKit
import XCTest

class MyTestTests: XCTestCase {

override func setUp() {
super.setUp()
// Put setup code here. This method is called before the invocation of each test method in the class.
}

override func tearDown() {
// Put teardown code here. This method is called after the invocation of each test method in the class.
super.tearDown()
}

func testExample() {
// This is an example of a functional test case.
XCTAssert(true, "Pass")
}

func testPerformanceExample() {
// This is an example of a performance test case.
self.measureBlock() {
// Put the code you want to measure the time of here.
}
}

}

这是测试项目中唯一的一个类，它继承自

XCTestCase

，并且里面实现了四个方法。其中以 test 开头的两个方法

testExample

和

testPerformanceExample

是具体的测试用例方法。我们看到

testExample

方法里面调用了一个

XCTAssert(true, "Pass")

方法。这个方法叫做断言方法，也是单元测试的核心。对于

XCAssert

方法，只有第一个参数为

true

的时候，测试用例才会通过。比如我们把这个方法改成这样：

func testExample() {
// This is an example of a functional test case.
var i = 1;
XCTAssert(i == 0, "variable i shoule be zero.")
}

我们在断言中判断变量 i 应该等于0，但我们实际给 i 赋值为 1。这时候我们再按 Command + U 来运行测试，这次我们的测试没有通过，因为断言失败了：



我们看到，

Xcode

将

XCAssert

的第二个参数用作错误提示显示了出来。这个例子说明了断言在单元测试中的作用。

既然

XCTest

已经提供了像 

XCAssert

这样的断言方法，我们为什么还需要用

Nimble

呢？ 简单来说，

XCTest

虽然提供了一系列的断言方法，但并不全面，比如它无法判断字符串包含关系，集合对象是否包含一个子集，以及测试异步方法的返回值。

Nimble

解决了这个问题，它弥补了

XCTest

的上述缺陷。并且还更加和 BDD(一种叫做行为驱动开发的测试模式) 贴合。

下面我们来看看如何用

Nimble

来表达上面的断言逻辑。

首先我们将

Nimble

库添加到项目中，并将

.xcodeproj

文件放到项目结构中：



然后我们把 Nimble-iOS 作为测试 Target 的依赖库添加进来：



然后我们再修改

testExample

方法：

func testExample() {

var i = 1;
expect(i).to(equal(0))

}

我们看到，我们将断言方式改为

expect(i).to(equal(0))

。顺便说句题外话~，这样感觉是不是更加符合自然语言的逻辑，更贴近人性呢？

XCTAssert(i == 0, "variable i shoule be zero.")

给人的感觉只是一个函数调用，而

expect(i).to(equal(0))

就仿佛是在说一句话一样，翻译成中文就是：“期望变量 i 等于 0 ”。

我们继续主题，按下 Command + U 运行单元测试，断言依然会失败：



而这次给出的错误消息，是

Nimble

自动生成的(其实绝大多数情况下，自动生成的错误消息就足够用了)。

好了，我们现在可以修正一下代码，让断言通过了：



我们现在对

Nimble

有了一个初步的认识了。而

Nimble

能为我们提供的，远不止这些。下面我们来继续了解。

对于 Swift， Nimble 也提供了操作符重载的支持，比如我们上面判断相等的方法，也可以写成这样：

expect(i) == 0

类似的，我们还可以进行比较操作：

expect(i).to(equal(0))
expect(i) == 0

expect(i).to(beGreaterThan(-2))
expect(i) > -2

expect(i).to(beGreaterThanOrEqualTo(0))
expect(i) >= 0

expect(i).to(beLessThan(2))
expect(i) < 2

expect(i).to(beLessThanOrEqualTo(1))
expect(i) <= 1

我们看到，每一个比较方法，在 Swift 中都提供了操作符重载，非常方便。

我们还可以对异步方法进行测试：

var collection:Array<String> = []

dispatch_async(dispatch_get_main_queue()) {

collection.append("first")
collection.append("second")

}

expect(collection).toEventually(contain("first","second"))

还可以使用

waitUntil

方法来阻塞当前线程，直到某些操作执行完成：

waitUntil { done in

NSThread.sleepForTimeInterval(0.5)
done()

}

你还可以用 Nimble 来判断两个实例的引用是否相同:

expect(actual).to(beIdenticalTo(expected))
expect(actual) === expected

Nimble，还提供了一系列方法供我们使用，更加详细的内容大家可以残开 Nimble 的 Github 主页： https://github.com/Quick/Nimble