Testing with Xcode文档（中文版）：简介和快速开始

本文翻译自苹果开发者中心：Testing with Xcode

关于Xcode测试
Xcode为你提供了丰富的软件测试功能。测试可增强工程的稳定性，减少bug，从而加快产品的分发和销售。一个测试良好的应用可提升用户的满意度。测试也可以帮你加快应用的开发，进一步说可让你少浪费精力和时间，并且可帮助协调多人开发。

概览
在本文档中，你将会学习如何使用Xcode 5的测试功能。XCTest替代OCUnit成为Xcode 5中新的测试框架。XCTest兼容iOS 7、OS X v10.8以及v10.9。
1.快速开始：Xcode 5使用测试导航面板（test navigator）来简化测试设置和运行，从而改进和自动化测试项目配置。
2.Xcode Server和Continuous Integration：Xcode测试可以使用bots进行配置，从而使设备自动连接到运行OS X Server的Mac上。
3.现代化：Xcode 5包含现代化的辅助工具可方便地把使用OCUnit测试的项目转为使用XCTest测试。

前提
你应该熟悉应用设计和编程概念。

推荐阅读
你可以查看“Testing Apps and Frameworks”示例代码熟悉各种各样的方法案例和使用异常，以鉴定并报告错误的API用法。
还可以查看WWDC 2013上的Xcode测试性能：Testing in Xcode 5 (409)

快速开始
本章由CocoaChina翻译小组成员 dada（github地址）翻译
原文：Testing with Xcode：Quick Start

本文的目的在于让测试成为你软件开发的重要组成部分，并使测试更方便并易于使用。

Test Navigator 测试导航栏
测试时我们会频繁使用Xcode5的测试导航栏。

测试导航是Xcode工作区的一部分，被设计用来方便的创建、管理、运行和审核测试功能。点击导航的选择栏，在问题导航和调试导航栏的中间那个就是测试导航。当你的工程定义了一组测试功能，你会在导航栏看到如下图所示：



上面的测试导航展示了一个样板工程中的测试包、类和方法的分级表。这个工程是一个计算器应用。计算器引擎实现为一个框架包。你可以 SampleCalcTests 测试包的分级的顶部看到应用中的测试代码。

注意: Xcode的目标生成产品。Xcode的测试目标生成测试包并展示在测试导航栏中。

如果你的测试使用存储数据文件、图片，和其他的类型，则可以把它们添加到测试包中，并使用 NSBundle 的API在运行时访问。和测试类一同使用 +[NSBundle bundleForClass:] 来保证测试类从包中取得正确的数据。更多的信息可见NSBundle Class Reference.

Xcode schemes 控制那些编译的内容。Schemes也可以控制可用的测试方法来执行测试操作。你可以在测试导航面板列表中通过Control+单击项目来启动或关闭测试包、类和方法，或者从快捷菜单中启用或者关闭测试，也可以在scheme中启用或者关闭测试。
此视图中的激活的测试包是 SampleCalcTests 。 SampleCalcTests 包括了一个测试类，总共有9个测试方法。 当你按住表中任何一个项目的箭头，运行按钮

会展示右边的项目名。这是比较快捷的方式运行包里所有的测试或者任何独立的测试。测试返回通过或失败结果给Xcode。当测试被执行，标识会更新从而向你展示结果，绿色的对勾标记是通过，红色的X为失败。在下面的测试导航面板中，两个测试被判定为失败。



点击列表中的任意测试类或测试方法都会在源码编辑器中打开测试类。测试类和方法标记在源码编辑器的侧栏中，和标记放在一起，和在测试导航面板中的工作方式相同。测试失败在源码编辑器中相关的断言处展示结果字符串。

测试导航面板底部是添加按钮 (+) ，还有一个过滤控制器。你可以缩小范围，比如只在活跃的scheme中测试或者只测试失败的测试，也可以通过名称筛选测试。

更多测试导航详细信息可见Test Navigator Help。

给你的应用添加测试
在Xcode5中创建新的应用和框架/库类会预配置一个测试目标。当你打开新工程，在测试导航面板上可以看到一个测试包、一个测试类和一个测试方法的模板。但是如果打开一个比较老的版本的Xcode的工程就不会有测试目标了。下面的工作流程展示了一个假定没有集成测试目标的工程。

创建测试目标
打开测试目标，点击左下角的（+）按钮，从菜单中选择New Test Target。



根据你的设置偏好和需求，在新目标助手中编辑Product Name和其他参数。



点击完成按钮来添加目标，测试导航面板中包含了模板测试类和一个测试方法。



运行测试并查看结果
现在你已经把测试加到了工程中，你会想要运行这些测试来做一些有用的事。但首先要在测试导航面板中把鼠标悬停在 SampleCalcTests 测试类上并点击运行按钮来运行所有的测试方法，在测试导航面板中抛出了一个错误来。点击 testExample 方法可以看到下面图中的测试结果、源代码和高亮的错误情况:



测试失败的原因是测试的模板类包含了一个默认的测试方法 XCTFail() ，一个强制判为失败的断言。

编辑测试代码然后继续运行
因为这是一个计算器应用的样板工程，你可能要在最开始的时候检查它是否能正确执行加法。因为测试编译到app项目里面，不管多复杂，你都可以按照你的需求添加所有的上下文和其他所需信息来执行测试。

插入下方的#import和实例变量声明到 SampleCalcTests.m 文件中
#import // // 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

给测试方法一个描述性名称，比如 testAddition ，然后添加到implementation资源中。
- (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."); }
现在，点击运行按钮运行 testAddition 方法。



注意：测试导航的列表的改变，反应了 testExample 已经被替换为 testAddition 。

这里仍有错误，看下面的代码，第一部分成功，第二部分有问题。仔细观察，错误很明显:字符引用"11"多了1。改为“10”就能测试成功了。



相同的通用代码使用 setUp() 和 tearDown()方法
Xcode运行测试方法一次测试所有测试包中的测试类。在这个小例子里只有一个测试方法被实现了，这里需要访问三个计算器应用对象变量的功能。如果在该类中写了4个或5个测试方法，你会发现你在每一次测试方法获得应用的对象状态中，重复了相同的代码。XCTest框架为测试类提供了实例方法 setUp 和 tearDown ,你可以用它在每个测试方法运行之前或者之后运行通用代码的调用。

setUp和tearDown很简单。在 testAddition 资源里 Mac_Calc_Tests.m ，在第四行用// obtain the app variable for test access 开头，并将它们粘贴到模板提供的默认的 setUp 实例方法中。
- (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; }
现在使用少的重复代码添加第二个测试方法： testMultiplication 以及其他。




总结
当你看完这篇简短的快速开始，会发现向工程添加测试很简单。这里有几个要注意的地方:
1.Xcode配置好了大部分基本的测试设置。当你添加一个测试目标，Xcode会为项目创建测试包文件，添加测试包到测试导航面板，为工程添加XCTest框架，并且为测试类和方法提供模板。
2.测试导航面板可以很方便的定位和编辑测试方法。你可以使用导航面板里的指示按钮快速运行测试，或在测试类实现打开时直接在资源编辑器中运行。当测试失败，测试导航面板中的标识跟源码编辑器中错误的地方相对应。
3.单个测试方法可以包括多个断言，导致单个通过或失败结果。这个方法可让你根据项目需要创建简单或者非常复杂的测试。
4. setUp 和 tearDown 实例方法为你提供了一种途径来把相同的代码用在很多个测试方法中，从而获得更高的一致性，并简化调试。

下一篇：Testing with Xcode文档（中文版）：测试基础