iOS单元测试入门

0x01

本文主要是讲 XCTest 测试框架的使用

我们知道在程序的开发中,单元测试是相当的重要,废话不多说,直接动手吧。

  1. 我们在创建 Xcode 项目的时候全部勾选的话默认会创建 XCTestDemoTests XCTestDemoUITests 这 2 个模块。现在主要讲解 XCTestDemoTests的使用。其中的模板代码如下:
// 每次测试前调用,可以在测试之前创建在test case方法中需要用到的一些对象等
// Put setup code here. This method is called before the invocation of each test method in the class.
- (void)setUp {
}
// 每次测试结束时调用tearDown方法
// Put teardown code here. This method is called after the invocation of each test method in the class.
- (void)tearDown {
}
// 单元测试方法的例子
// 我们可以自定义添加  - (void)testxxxx{} 方法,- (void)testxxx 类似的方法在启动测试的时候都会自动跑。
// This is an example of a functional test case.
// Use XCTAssert and related functions to verify your tests produce the correct results.
- (void)testExample {
}
// 性能测试方法,通过测试block中方法执行的时间,比对设定的标准值和偏差觉得是否可以通过测试
- (void)testPerformanceExample {
    // This is an example of a performance test case.
    [self measureBlock:^{
        // Put the code you want to measure the time of here.
    }];
}
  1. XCTAssert 的使用,在单元测试中,我们通常使用 XCTAssert 相关的方法,方法有如下:
    // 通用断言,为 true 就通过测试
    XCTAssert(false);
    
    // 为 true 就通过测试
    XCTAssertTrue(false);
    
    // 为 false 就通过测试
    XCTAssertFalse(true);
    
    // 相等就通过测试
    XCTAssertEqual(1, 2);
    // 不相等就通过测试
    XCTAssertNotEqual(0, 0);
    
    // 相差的值在精确度范围内就通过测试
    XCTAssertEqualWithAccuracy(10, 12, 1);
    // 相差的值不在精确度范围内就通过测试
    XCTAssertNotEqualWithAccuracy(10, 12, 1);
    
    // 为 nil 就通过测试
    XCTAssertNil(nil);
    // 不为 nil 就通过测试
    XCTAssertNotNil(nil);
    
    // 直接不通过测试,可以自己判断是否加 XCTFail();
    XCTFail();
  1. 我们可以使用 ❀ + U 来启动全部单元测试 ❀ + 6 切换到测试模块 这个和 Xcode 的版本有关 或者使用下图的方法来启动测试:

  1. 如何写测试用例呢?

比如我们在开发框架的时候,一般会写一些测试用例。下面我们就模拟写一个简单的框架,同时我们写一些测试用例。如:我们要写一个获取 URL 中的参数的方法。

代码如下:

#import <Foundation/Foundation.h>
NS_ASSUME_NONNULL_BEGIN
@interface NSString (BMURLParams)
@property (nonatomic, copy, readonly) NSDictionary *bm_URLParams; ///< URLParams
@end
NS_ASSUME_NONNULL_END
#import "NSString+BMURLParams.h"
@implementation NSString (BMURLParams)
- (NSDictionary *)bm_URLParams {
    NSRange range = [self rangeOfString:@"?"];
    if (range.location == NSNotFound) {
        return nil;
    }
    NSString *propertys = [self substringFromIndex:(range.location+1)];
    NSMutableDictionary *tempDic = @{}.mutableCopy;
    [[propertys componentsSeparatedByString:@"&"] enumerateObjectsUsingBlock:^(NSString * _Nonnull obj, NSUInteger idx, BOOL * _Nonnull stop) {
        NSArray *dicArray = [obj componentsSeparatedByString:@"="];
        if (dicArray.count > 1) {
            tempDic[dicArray[0]] = dicArray[1];
        }
    }];
    return tempDic;
}
@end
  1. 我们在 XCTestDemoTests 文件中,实现导入 #import "NSString+BMURLParams.h" 同时加上如下的方法:
- (void)test_URLParams {
    XCTAssert(@"https://www.baidu.com/s".bm_URLParams == nil);
     XCTAssert([(@"https://www.baidu.com/s?name=jck".bm_URLParams)
                isEqualToDictionary:(@{@"name" : @"jck"})]);
    XCTAssert([(@"https://www.baidu.com/s?name=jack&type=1".bm_URLParams)
                isEqualToDictionary:(@{@"name" : @"jack",
                                       @"type" : @"1"})]);
    XCTAssert([(@"https://www.baidu.com/s?name=jack&type=1&user=80222".bm_URLParams)
                isEqualToDictionary:(@{@"name" : @"jack",
                                       @"type" : @"1",
                                       @"user" : @"80222"})]);
}
  1. 跑一下测试用例,发现如下的效果

说明我们的用例全部通过了,当然这里的用例比较少,我们可以加上各种可能的情况。现在我们把获取参数的代码故意写错为如下的代码:

#import "NSString+BMURLParams.h"
@implementation NSString (BMURLParams)
- (NSDictionary *)bm_URLParams {
    NSRange range = [self rangeOfString:@"?"];
    if (range.location == NSNotFound) {
        return nil;
    }
    NSString *propertys = [self substringFromIndex:(range.location+1)];
    NSMutableDictionary *tempDic = @{}.mutableCopy;
    [[propertys componentsSeparatedByString:@"&"] enumerateObjectsUsingBlock:^(NSString * _Nonnull obj, NSUInteger idx, BOOL * _Nonnull stop) {
        NSArray *dicArray = [obj componentsSeparatedByString:@"="];
        if (dicArray.count > 1) {
            tempDic[dicArray[1]] = dicArray[0];
        }
    }];
    return tempDic;
}
@end

在跑一下单元测试就会有如下的效果:

性能测试

现在我们模拟测试网络接口的返回速度是否复合我们的预期,实现我们创建应该发送网络请求的类 BMRequestManager, 代码如下:

@interface BMRequestManager : NSObject
+ (void)getDataWithSuccBlock:(dispatch_block_t)block;
@end
@implementation BMRequestManager
+ (void)getDataWithSuccBlock:(dispatch_block_t)block {
    dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(6.0 * NSEC_PER_SEC)), dispatch_get_main_queue(), ^{
        !block ? : block();
    });
}
@end
  • 我们编写测试用例代码:
- (void)testExampleRequest {
    
    // 1、创建 XCTestExpectation
    XCTestExpectation *exp = [self expectationWithDescription:@"这个请求太慢了"];
    // 2、具体的网络请求
    [BMRequestManager getDataWithSuccBlock:^{
        // 收到数据了
        // 发送 fulfill 消息
        [exp fulfill];
    }];
    // 3、定义预期需要在 xxx 时间内获取到数据
    NSTimeInterval time = 15;
    //4、如果超过 xxx 时间就报错
    [self waitForExpectationsWithTimeout:time handler:^(NSError * _Nullable error) {
        if (error) {
            NSLog(@"Timeout Error: %@", error);
        }
    }];
}

由于我们上面设置的预期时间是 15 秒,但我们实际我们 6 秒就获取到了数据,使用我们在跑用例的时候用如下效果:

如果我们设置的预期时间是 5 秒,代码如下:

- (void)testExampleRequest {
    
    // 1、创建 XCTestExpectation
    XCTestExpectation *exp = [self expectationWithDescription:@"这个请求太慢了"];
    // 2、具体的网络请求
    [BMRequestManager getDataWithSuccBlock:^{
        // 收到数据了
        // 发送 fulfill 消息
        [exp fulfill];
    }];
    // 3、定义预期需要在 xxx 时间内获取到数据
    NSTimeInterval time = 5.0;
    //4、如果超过 xxx 时间就报错
    [self waitForExpectationsWithTimeout:time handler:^(NSError * _Nullable error) {
        if (error) {
            NSLog(@"Timeout Error: %@", error);
        }
    }];
}
  • 跑用例的时候有如下效果:

说明用例不通过。

  • 当然我们也可以测试其他的一些代码的执行时间和预期时间来比较,看代码是否通过预期时间。

demo

参考

https://juejin.im/post/5e000cd4f265da33d21e82b7

「点点赞赏,手留余香」

    还没有人赞赏,快来当第一个赞赏的人吧!
0 条回复 A 作者 M 管理员
    所有的伟大,都源于一个勇敢的开始!
欢迎您,新朋友,感谢参与互动!欢迎您 {{author}},您在本站有{{commentsCount}}条评论