框架简介

XCTest
为Xcode项目创建并运行单元测试、性能测试和UI测试。

Overview（概述）

使用XCTest框架为您的Xcode项目编写单元测试，从而与Xcode的测试工作流无缝集成。

测试断言在代码执行期间满足了某些条件，如果这些条件不满足，则记录测试失败(使用可选消息)。测试还可以测量代码块的性能，以检查性能回归，并且可以与应用程序的UI交互，以验证用户交互流。

Topics

Test Cases and Test Methods

测试方法是一种小型的、自包含的方法，用于测试代码的特定部分。测试用例是一组相关的测试方法。
定义测试用例和测试方法
向测试目标添加测试用例和测试方法，以确认代码的行为符合预期。

XCTestCase

用于定义测试用例、测试方法和性能测试的主要类。

XCTest

用于创建、管理和执行测试的抽象基类。

Customizing Test Setup and Teardown

setUp

提供了在测试用例开始之前定制初始状态的机会

+ (void)setUp;
//setUp类方法对测试用例只调用一次，然后调用第一个测试方法。重写此方法以定制测试用例中所有测试的初始状态。

提供在调用测试用例中的每个测试方法之前重置状态的机会。

- (void)setUp;
//setUp实例方法在每次测试开始之前调用一次。重写此方法以重置每个测试方法的状态。

tearDown

提供在测试用例结束后执行清理的机会

+ (void)tearDown;
//在最终的测试方法完成之后，对测试用例只调用一次tearDown类方法。重写此方法以在所有测试方法结束后执行任何清理。

- (void)tearDown;
// 每次测试完成后，都会调用tearDown实例方法。重写此方法以执行每个测试的清除。

Handling Test Case Failure

@property BOOL continueAfterFailure;
//布尔值，指示测试方法在发生故障后是否应继续运行
//默认值是YES。在测试方法中将此属性设置为NO，以便在出现故障时立即结束该方法的执行。在测试失败后，套件中的其他测试方法仍然可以执行。

Measuring Performance

测量性能

measureBlock:

- (void)measureBlock:(void (^)(void))block;
//从测试方法内部调用此方法，以度量代码块的性能。默认情况下，该方法测量代码块执行所需的秒数。重写defaultPerformanceMetrics以更改由此方法测量的默认指标。
//此方法自动启动和停止性能度量。使用measureMetrics: automaticallystartmeasurement:forBlock:如果您需要更多地控制性能测量的开始和结束时间

度量代码块的性能，可以选择延迟度量的起始点

- (void)measureMetrics:(NSArray<XCTPerformanceMetric> *)metrics automaticallyStartMeasuring:(BOOL)automaticallyStartMeasuring forBlock:(void (^)(void))block;
metrics
要度量的性能指标数组。每个度量将跨对块的调用进行度量。传递XCTPerformanceMetric_WallClockTime来测量执行代码块所花费的秒数。automaticallyStartMeasuring
如果没有，则在块内调用startmeasurement之前不会进行测量从测试方法内部调用此方法，以度量代码块的性能。与measureBlock:方法相比，该方法对性能度量提供了更细粒度的控制，当您需要定制度量在块中开始和结束的点，或者希望度量块的多个度量标准时，应该使用该方法。性能测量必须在块内精确地启动和停止一次。结果:如果automaticallystartmeasurement是YES，并且startmeasurement在块内被调用，测试将失败。如果automaticallystartmeasurement为NO，那么startmeasurement必须调用一次，而且只能在块的末尾调用一次，否则测试将失败。如果在测试过程中多次停止测量，测试将失败。

- (void)startMeasuring;
// 通过measureMetrics: automaticallystartmeasurement:forBlock:方法调用此方法来开始度量指标的度量。在被测量的块中调用此方法之后，测量将立即开始。//您必须调用measureMetrics: automaticallystartmeasurement:forBlock:带有automaticallystartmeasurement值NO来设置startmeasurement的自定义起始点。

- (void)stopMeasuring;
//通过measureMetrics: automaticallystartmeasurement:forBlock:方法调用此方法来结束度量的度量。在被测量的块中调用此方法之后，测量将立即结束。
//你必须调用measureMetrics: automaticallystartmeasurement:forBlock:带有automaticallystartmeasurement值NO来设置一个自定义终止测量终点。

defaultPerformanceMetrics

@property(class, readonly, copy) NSArray<XCTPerformanceMetric> *defaultPerformanceMetrics;
//确定在调用measureBlock:时度量的性能指标。

XCTPerformanceMetric

typedef NSString *XCTPerformanceMetric; 
//一种性能指标，以秒为单位记录执行代码块所花费的时间。

Creating Asynchronous Test Expectations

XCTestExpectation

@interface XCTestExpectation : NSObject

- (void)fulfill;
在已经完成的期望上或在传递期望的测试用例已经完成时调用此方法是错误的

- (XCTestExpectation *)expectationForPredicate:(NSPredicate *)predicate evaluatedWithObject:(id)object handler:(XCPredicateExpectationHandler)handler;
//为了更好地控制基于预测的期望，可以使用xctnspredicateexpectations而不是这个方便的方法。

XCTest

用于创建、管理和执行测试的抽象基类。

@interface XCTest : NSObject
//XCTest类提供了XCTestCase和XCTestSuite用于创建、管理和执行测试的共享功能。在大多数情况下，当在项目中定义测试时，应该直接子类化XCTestCase。

@property(readonly, copy) NSString *name;//The name of the test.@property(readonly) NSUInteger testCaseCount;//The number of test cases in this test.
@property(readonly) XCTestRun *testRun;//执行测试的XCTestRun对象。
//一个testRunClass的实例，如果测试还没有运行，则为nil。
@property(readonly) Class testRunClass;//运行测试时要实例化的XCTestRun子类，用于保存测试结果。

Running Tests

执行特定的测试

- (void)performTest:(XCTestRun *)run;
- (void)runTest;//创建由testRunClass指定的类的实例，并将其作为参数传递给performTest:方法。

- (BOOL)setUpWithError:(NSError * _Nullable *)error;
- (BOOL)tearDownWithError:(NSError * _Nullable *)error;