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

Nimble 从字面上看是 敏捷,灵活 的意思。Nimble 是一个库,一个 断言库。这个库一般用于单元测试。Xcode 6 为我们集成了 XCTest 单元测试库。在正式介绍 Nimble 之前,我们有必要先介绍一下 XCTest。我们在使用 Xcode 新建项目的时候会发现它为我们创建了两个 Target,一个是我们项目的 Target 还有一个就是测试 Target

Swift 中使用Nimble 库进行单元测试_第1张图片

我们看到了 Xcode 为我们自动生成的 Target,我们按下 Command + U 即可运行测试项目,并且在 Xcode 的左边会显示测试结果:

Swift 中使用Nimble 库进行单元测试_第2张图片

让我们看看测试项目中的代码, 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 开头的两个方法 testExampletestPerformanceExample 是具体的测试用例方法。我们看到 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 来运行测试,这次我们的测试没有通过,因为断言失败了:

Swift 中使用Nimble 库进行单元测试_第3张图片

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

既然 XCTest 已经提供了像 XCAssert 这样的断言方法,我们为什么还需要用 Nimble 呢? 简单来说,XCTest 虽然提供了一系列的断言方法,但并不全面,比如它无法判断字符串包含关系,集合对象是否包含一个子集,以及测试异步方法的返回值。

Nimble 解决了这个问题,它弥补了 XCTest 的上述缺陷。并且还更加和 BDD(一种叫做行为驱动开发的测试模式) 贴合。

下面我们来看看如何用 Nimble 来表达上面的断言逻辑。

  • 首先我们将 Nimble 库添加到项目中,并将 .xcodeproj 文件放到项目结构中:

Swift 中使用Nimble 库进行单元测试_第4张图片

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

Swift 中使用Nimble 库进行单元测试_第5张图片

然后我们再修改 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 运行单元测试,断言依然会失败:

Swift 中使用Nimble 库进行单元测试_第6张图片

而这次给出的错误消息,是 Nimble 自动生成的(其实绝大多数情况下,自动生成的错误消息就足够用了)。

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

Swift 中使用Nimble 库进行单元测试_第7张图片

我们现在对 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

你可能感兴趣的:(swift)