iOS单元测试:Specta + Expecta + OCMock + OHHTTPStubs + KIF

原文地址:iOS单元测试:Specta + Expecta + OCMock + OHHTTPStubs + KIF

框架选择

参考这篇选型文章,http://zixun.github.io/blog/2015/04/11/iosdan-yuan-ce-shi-xi-lie-dan-yuan-ce-shi-kuang-jia-xuan-xing/,虽然结论不一定完全适用,但是关于框架对比的地方还是值得阅读的,基于这篇文章,排除Kiwi框架之后,决定参考一些项目的源代码,了解他们使用的测试方面的框架。

首先,参考https://github.com/artsy/eigen开源项目,其内部整体结构非常完整,开发流程也非常专业,至少比我知道的大多数国内团队都要专业:

eigen: Specta + OCMock + Expecta + OHHTTPStubs + FBSnapshotTestCase + "Expecta+Snapshots" + "XCTest+OHHTTPStubSuiteCleanUp”。

其次,参考公司内部别的项目使用情况,发现使用以下框架来做测试方面的事情: Specta + Expecta + OCMock + OHTTPStubs + KIF(UI Test)

so,我决定选择 Specta (BDD框架) + Expecta(断言框架) + OCMock(mock框架) + OHHTTPStubs(http stub框架) + KIF(UI Test) 做测试框架来学习。

XCTest简介

由于我决定不直接使用XCTest作为测试框架,但是又由于Specta是基于XCTest进行封装的,所以对XCTest做一个基础的了解还是有必要的。

参考:

1.https://developer.apple.com/library/ios/documentation/DeveloperTools/Conceptual/testing_with_xcode

2.http://www.objc.io/issues/15-testing/xctest/,翻译:http://objccn.io/issue-15-2/

3.http://zixun.github.io/blog/2015/04/16/iosdan-yuan-ce-shi-xi-lie-dan-yuan-ce-shi-bian-ma-gui-fan/

BDD框架 — Specta

1. 简介

目前主流的BDD框架,这些BDD框架在语法层面几乎是相同的,主要的区别在于他们的可配置能力和绑定的组件。下面三个OC BDD框架相对于官方框架XCTest都具有更好的可读性,另外现在已经有了比较流行的swift BDD框架: https://github.com/railsware/Sleipnirhttps://github.com/Quick/Quick

https://github.com/specta/specta

https://github.com/kiwi-bdd/Kiwi

https://github.com/pivotal/cedar

关于specta与kiwi框架的对比,参考:http://appleprogramming.com/blog/2014/01/18/tdd-with-specta-and-expecta/,这篇文章的结论是specta相对于kiwi有更加优雅的语法,对于我这种刚开始使用的新手,果断采用specta这种各种完胜的框架。Specta框架具有一下特点:

An OC RSpec-like BDD DSL

Quick and easy set up

Build on top of XCTest

Excellent Xcode integration

2. Specta BDD DSL语法简介

可以参考https://github.com/specta/specta官网和https://github.com/artsy/eigen项目中的test case代码来学习语法

1) SpecBegin 声明了一个测试类,SpecEnd 结束了类声明

2) describe (context) 块声明了一组实例

3) it (example/specify) 是一个单一的例子

4) beforeAll 是一个运行于所有同级块之前的块,只运行一次。afterAll 与beforeAll相反,是在所有同级块之后运行的块,只运行一次。

5) beforeEach/afterEach,在每个同级块运行的时候,都会运行一次,而beforeAll/afterAll只会运行一次

6) it/waitUntil/done(),异步调用,注意完成异步操作之后,必须调用done()函数,如下:

it(@"should do some stuff asynchronously", ^{

waitUntil(^(DoneCallback done) {

// Async example blocks need to invoke done() callback.

done();

});

});

7) sharedExamplesFor 和 itShouldBehaveLike结合在一起,可以实现在不同的spec之间共享同一套test case,参考:http://artandlogic.com/2014/02/specta-shared-behavior/;sharedExamplesFor 设置多个spec之间共享的test case,第一个参数作为标识符。通过itShouldBehaveLike来运行spec中test case,第一个参数传入sharedExamplesFor设置时使用的标识符。注意,在describe局部使用sharedExamplesFor定义shared examples,可以在它作用域内覆盖全局的shared examples。

8) pending,只打印一条log信息,不做测试。这个语句会给出一条警告,可以作为一开始集中书写行为描述时还未实现的测试的提示。

断言框架 — Expecta

用法可以参考开源项目:https://github.com/artsy/eigen,从中找到对应的代码学习是最好的方式。如果需要找到更多更全面的用法,可以去项目官方网站:https://github.com/specta/expecta。截取一段eigen上面代码,基本上就可以了解Expecta框架的基本用法了,如下图中 expect(mapView.nextZoomScale).to.equal(mapView.annotationZoomScaleThreshold)

mock框架 —OCMock

了解OCMock 2.x中的详细features,可以参考:http://ocmock.org/features/;了解OCMock 3.x的详细API,可以参考:http://ocmock.org/reference/

什么是mock,refer: http://hackazach.net/code/2014/03/03/effective-testing-with-ocmock/

In a modern Object Oriented system, the component under test will likely have several object dependencies. Instead of instantiating dependencies as concrete classes, we use mocks. Mocks are ‘fake’ objects with pre-defined behavior to stand-in for concrete objects during testing. The component under test does not know the difference! With mocks, a component can be tested with confidence that it behaves as designed within a larger system. 

OCMock框架的用法也比较简单,由于我个人时间比较紧张,只能抽出一两天的时间学习测试部分的知识,就不多说了,下面几篇文章都说的比较清楚,可以参考:http://zixun.github.io/blog/2015/04/16/iosdan-yuan-ce-shi-xi-lie-yi-ocmockchang-jian-shi-yong-fang-shi/,学习2.x和3.x的API的基本使用。另外可以参考开源项目https://github.com/artsy/eigen,学习其中的OCMock API的使用,框架使用比较简单,看看就懂了,不需要多说。

eigen的一个test

case,注意在执行完毕的时候,需要调用stopMocking。OCMockObject是基于runtime方法转发实现的,mock一个对象,就是对这个对象的方法进行转发的过程,执行完毕需要调用stopMocking,否则会影响其他test

case的执行。下面可以看出一个OCMock基本过程:获得OCMockObject -> stub方法 -> 设置expect

->

verify校验执行结果 -> 调用stopMocking


下面有一个mock一个alert view show的过程


参考:

http://ocmock.org/reference/

http://ocmock.org/features/

http://ocmock.org/introduction/

http://www.archive.alexvollmer.com/posts/2010/06/28/making-fun-of-things-with-ocmock/

http://hackazach.net/code/2014/03/03/effective-testing-with-ocmock/,翻译:http://zixun.github.io/blog/2015/04/16/iosdan-yuan-ce-shi-xi-lie-yi-ocmockchang-jian-shi-yong-fang-shi/

http://engineering.aweber.com/improving-ios-unit-tests-with-ocmock/

OHHTTPStubs

官方:https://github.com/AliSoftware/OHHTTPStubs。这个框架是基于NSURLProtocol实现的,之前正好看过这部分的只是,整理来说,这个框架的源代码并不复杂,但实现还是比较巧妙的。详细的介绍和使用,在github上面介绍的非常清楚,框架本身使用也比较简单:

[OHHTTPStubsstubRequestsPassingTest:^BOOL(NSURLRequest*request) {

return[request.URL.hostisEqualToString:@"mywebservice.com"];

}withStubResponse:^OHHTTPStubsResponse*(NSURLRequest*request) {

// Stub it with our "wsresponse.json" stub file (which is in same bundle as self)

NSString* fixture =OHPathForFile(@"wsresponse.json", self.class);

return[OHHTTPStubsResponseresponseWithFileAtPath:fixture

statusCode:200headers:@{@"Content-Type":@"application/json"}];

}];

这个框架的主要使用方法就是上面这个示例,用法很明显易用。结合unit

test使用的时候,需要使用网络请求的时候,可以在it或者beforeAll或者beforeEach的时候进行stub

request,即上面这段代码的行为。但是不要忘记的是,需要在tear down的时候,即specta的afterAll的时候,记得调用

[OHHTTPStubs removeAllStubs] 。

注意,这里只是使用NSURLProtocol来stub

request,不会影响被测试的请求接口的测试,请求是异步的话,可以使用Specta的it/waitUntil/done()流程对请求进行测试,如果使用XCTest的话,OHTTPStubs给出了一个wiki解决,使用XCTestExpectation来搞定,我觉得挺有意思:

- (void)testFoo

{

NSURLRequest* request = ...

XCTestExpectation* responseArrived = [selfexpectationWithDescription:@"response of async request has arrived"];

__blockNSData* receivedData =nil;

[NSURLConnectionsendAsynchronousRequest:request

queue:[NSOperationQueuemainQueue]

completionHandler:^(NSURLResponse* response,NSData* data,NSError* error)

{

receivedData = data;

[responseArrivedfulfill];

}

];

[selfwaitForExpectationsWithTimeout:timeouthandler:^{

// By the time we reach this code, the while loop has exited

// so the response has arrived or the test has timed out

XCTAssertNotNil(receivedData,@"Received data should not be nil");

}];

}

由于NSURLProtocol的局限性,OHHTTPStubs没法用来测试background sessions和模拟数据上传。

F.I.R.S.T 原则

优秀测试实践原则,https://pragprog.com/magazines/2012-01/unit-tests-are-first

Fast — 测试应该能够被经常执行

Isolated — 测试本身不能依赖于外部因素或其他测试的结果

Repeatable — 每次运行测试都应该产生相同的结果

Self-verifying — 测试应该依赖于断言,不需要人为干预

Timely — 测试应该和生产代码一同书写

如何将测试结果收益最大化:不要将测试和实现细节耦合在一起。

不要测试私有方法

不要Stub私有方法

不要Stub外部库

正确地Stub依赖

不要测试构造函数

参考资料

http://www.objc.io/issues/15-testing/,(翻译:http://objccn.io/issue-15/)

https://github.com/artsy/eigen,非常专业的APP的开源代码,http://objccn.io/issue-22-2/

: RAC + 单元测试

http://www.jianshu.com/p/73f9d719cee4

http://nshipster.com/unit-testing/

http://onevcat.com/2014/02/ios-test-with-kiwi/

http://onevcat.com/2014/05/kiwi-mock-stub-test/

https://github.com/dblock/fui,find unused objective-c imports

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,723评论 6 481
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,485评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 152,998评论 0 344
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,323评论 1 279
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,355评论 5 374
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,079评论 1 285
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,389评论 3 400
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,019评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,519评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,971评论 2 325
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,100评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,738评论 4 324
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,293评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,289评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,517评论 1 262
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,547评论 2 354
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,834评论 2 345

推荐阅读更多精彩内容