這個快速入門的目的是告訴你可以在開發(fā)項目中加入測試梅垄,使測試更加簡單方便党晋。
介紹測試導航(test navigator)
當進行測試時统翩,你會經(jīng)常使用到Xcode的測試導航(test navigator)娇豫。
測試導航(test navigator)是workspace的一部分锣杂,使創(chuàng)建脂倦、管理、運行和評估測試更加加單元莫。通過點擊導航選擇欄中的圖標進入測試赖阻,該圖標在問題導航和調(diào)試導航之間。當項目中有一系列定義的測試踱蠢,你會看到如下圖所示的導航視圖火欧。
上面展示的測試導航(test navigator)包含示例項目測試包(test bundle)、類和方法茎截。這個項目是一個計算器app的示例苇侵。計算引擎作為一個框架。你可以在SampleCalcTests測試的頂層看到用于測試應(yīng)用的代碼稼虎。
注意:Xcode 測試目標(target)生成的測試包(test bundle)顯示在測試導航(test navigator)處衅檀。
如果測試使用asset數(shù)據(jù)文件、圖像霎俩,可以將它們添加到測試包(test bundle)中哀军,運行時使用NSBundle API訪問。使用測試類+[NSBundle bundleForClass:]的確保獲得正確bundle來檢索asset打却。更多信息杉适,參見NSBundle類引用(NSBundle Class Reference)。
Xcode中的scheme控制built的內(nèi)容柳击。scheme還控制哪個可用的測試方法執(zhí)行測試操作猿推。可以單擊測試導航(test navigator)列表中的項目,啟用或禁用測試包(test bundle)蹬叭、類和方法藕咏。從快捷菜單中選擇啟用或禁用,從而啟動或禁用scheme中的項目秽五。
在這個視圖的的測試包(test bundle)是SampleCalcTests孽查。SampleCalcTests包括一個測試類,這個測試類包含九個測試方法坦喘。當將指示放在列表中的任何像時盲再,該項目名稱的右側(cè)顯示為運行按鈕()。這種方法可以快速的運行bundle中的所有測試瓣铣,類中的所有測試或其他單獨的測試答朋。測試返回通過或失敗的結(jié)果到Xcode。測試被執(zhí)行棠笑,這些指標會更新告知你結(jié)果梦碗,綠色的復選表示通過,紅色的x表示失敗蓖救。如測試導航(test navigator)所示叉弦,兩個測試斷言失敗。
在源編輯器打開測試類藻糖,點擊展開列表中的任何測試類或測試方法。在源代碼編輯器中測試類和測試方法同樣被標記库车,這與測試導航(test navigator)中的方法相同巨柒。測試失敗時,在源代碼編輯器中顯示相關(guān)斷言的結(jié)果字符串柠衍。
在測試導航(test navigator)的底部有添加按鈕(+)和過濾控制洋满。可以將視圖縮小到只有scheme或失敗的測試珍坊,你也可以通過名稱篩選牺勾。
有關(guān)測試導航(test navigator)操作的詳細信息,參見測試導航(test navigator)幫助(測試導航(test navigator) Help)阵漏。
添加測試到app
Xcode5或更高版本中創(chuàng)建的新app驻民,框架和library項目預(yù)先配置了測試目標(target)。當你開始使用一個新項目履怯,打開測試導航(test navigator)回还,你可以看到測試包(test bundle),測試類和測試方法模板叹洲。但你可能在較早版本的Xcode中打開一個已經(jīng)存在的項目柠硕,還沒有定義測試目標(target)。這里展示了一個已經(jīng)存在运提、并沒有加入測試的項目添加測試的流程蝗柔。
創(chuàng)建測試目標(target)
當打開測試導航(test navigator)闻葵,單擊左下角添加按鈕(+),從菜單中選擇新的單元測試目標(target)癣丧。
在下一個對話框中選擇OS X或iOS單元測試包(test bundle)并單擊下一步槽畔。在出現(xiàn)的新目標(target)設(shè)置助理,編輯產(chǎn)品名稱和其他你需要的參數(shù)坎缭。
單擊完成竟痰,添加目標(target),它包含一個模板測試類和兩個測試方法模板掏呼,測試導航(test navigator)圖坏快。
運行測試并查看結(jié)果
現(xiàn)在,你已經(jīng)往項目中添加測試憎夷,你希望開發(fā)測試做一些有用的事情莽鸿。首先,將指示放在測試導航(test navigator)中的SampleCalcTests測試類拾给,點擊運行按鈕運行該類中的所有方法祥得。在函數(shù)名旁邊的源代碼編輯器中有綠色勾標記結(jié)果。
模版單元和性能測試都是空的蒋得,這表明成功级及,沒有失敗的斷言。注意34行measureBlock:方法旁邊的灰色鉆石圖標额衙。點擊鉆石圖標顯示性能結(jié)果面板饮焦。
這個面板允許你設(shè)置性能基準線,并允許你編輯基準線和最大標準差參數(shù)窍侧。這些功能在之后討論县踢。
編輯測試并再次運行
因為示例項目是計算器app,你希望檢查它是否正確執(zhí)行加法伟件、減法、乘法和除法運算斧账,以及測試計算器的其他計算功能谴返。因為測試是建立在應(yīng)用項目上,你可以添加所有上下文或其他需要的信息進行測試咧织。創(chuàng)建測試其實就是往單元測試實現(xiàn)問價中添加方法亏镰。
例如,往SampleCalcTests.m文件中插入如下的 #import和實例變量聲明拯爽。
<pre><code>
\#import <XCTest/XCTest.h>
//
// Import the application specific header files
\#import "CalcViewController.h"
\#import "CalcAppDelegate.h"
@interface CalcTests : XCTestCase {
// add instance variables to the CalcTests class
@private
NSApplication *app;
CalcAppDelegate *appDelegate;
CalcViewController *calcViewController;
NSView *calcView;
}
@end
</pre></code>
然后給測試方法一個描述性名稱索抓,例如testAddition,并為該方法添加實現(xiàn)源代碼。
<pre><code>
-(void) testAddition
{
// obtain the app variables for test access
app = [NSApplication sharedApplication];
calcViewController = (CalcViewController*)[[NSApplication sharedApplication]
delegate];
calcView = calcViewController.view;
// perform two addition tests
[calcViewController press:[calcView viewWithTag: 6]]; // 6
[calcViewController press:[calcView viewWithTag:13]]; // +
[calcViewController press:[calcView viewWithTag: 2]]; // 2
[calcViewController press:[calcView viewWithTag:12]]; // =
XCTAssertEqualObjects([calcViewController.displayField stringValue], @"8", @"Part
1 failed.");
[calcViewController press:[calcView viewWithTag:13]]; // +
[calcViewController press:[calcView viewWithTag: 2]]; // 2
[calcViewController press:[calcView viewWithTag:12]]; // =
XCTAssertEqualObjects([calcViewController.displayField stringValue], @"10",
@"Part 2 failed.");
}
</pre></code>
注意逼肯,在測試導航(test navigator)中的列表改變耸黑,反映示例測試方法,即testExample變?yōu)閠estAddition篮幢。
現(xiàn)在使用測試導航(test navigator)中的運行按鈕(或源代碼編輯器中的指示)來運行testAddition方法大刊。
正如你看到的,一個斷言失敗了三椿,在測試導航(test navigator)和源代碼編輯器中高亮顯示缺菌。查看源代碼,Part 1成功搜锰,Part 2出現(xiàn)問題伴郁。仔細檢查,錯誤是顯而易見的:在76行蛋叼,應(yīng)該是 [calcView viewWithTag:12]焊傅,而不是[calcView viewWithTag:11]。糾正這個錯誤狈涮,測試成功狐胎。
使用setUp()和 tearDown()方法
Xcode可以一次運行測試包(test bundle)中所有測試類中的測試方法。在這個小例子中歌馍,在測試類中只實現(xiàn)了一個測試方法握巢,它需要訪問計算器app中三個變量對象。如果你在同一個類中寫了四個或五個測試方法松却,你會發(fā)現(xiàn)在每個測試方法中都有相同的代碼镜粤,訪問app對象狀態(tài)。XCTest 框架提供了測試類的實例方法玻褪,setUp和tearDown,分別在運行普通代碼前調(diào)用公荧,在每個測試方法運行后調(diào)用带射。
setUp和tearDown的使用很簡單。在Mac_Calc_Tests.m文件中的testAddition循狰,剪切從// obtain the app variable for test access 開始的四行代碼窟社,并將其粘貼到模版中默認setUp實例方法中。
<pre><code>
-(void)setUp
{
[super setUp];
// Put setup code here. This method is called before the invocation of each test
method in the class.
// obtain the app variables for test access
app = [NSApplication sharedApplication];
calcViewController = (CalcViewController*)[[NSApplication sharedApplication]
delegate];
calcView = calcViewController.view;
}
</pre></code>
現(xiàn)在添加更多測試方法testSubtraction
及其他方法绪钥,這樣可以使用最少重復代碼灿里。
總結(jié)
正如你看到的快速入門,往項目中添加測試非常簡單程腹。這里有一些需要注意的:
Xcode設(shè)置最基本的測試配置匣吊。當你往項目中添加一個新的測試目標(target),Xcode自動將其添加到相關(guān)產(chǎn)品目標(target)的scheme中。該目標(target)中會添加只有一個測試方法的初始測試類色鸳,可以在測試導航(test navigator)中看到社痛。
測試導航(test navigator)讓你輕松定位和編輯測試方法。想要立即運行測試命雀,可以使用測試導航(test navigator)中的指示按鈕或者當測試類的實現(xiàn)是公開的蒜哀,直接從源代碼編輯器處運行。當測試失敗吏砂,測試導航(test navigator)中的指示與源代碼編輯器中的失敗標記相匹配撵儿。
一個測試方法可以包含多個斷言,只有一個結(jié)果通過或失敗狐血。這種方法使你可以根據(jù)項目需求淀歇,創(chuàng)建簡單或者非常復雜的測試。
setup和tearDown實例方法提供一種方法氛雪,使許多測試方法中使用的普通代碼保持一致性房匆,同時易于調(diào)試。