swift - iOS系统自带单元测试学习笔记

背景

开发iOS版IM客户端的过程中，经常需要测试SDK的里面的业务逻辑，比如协议头是否正确，需要和服务器通信调试一下。这个时候如果写一个页面，通过按钮点击的方式调用，显得比较多余。所以就想到了swift中如何使用单元测试，特此记录。

macos：10.15.3
xcode：11.3.1
最近更新时间：2020-03-16

步骤

创建单元测试项目

直接默认，finish即可。

创建单元测试文件

在新创建的单元测试项目中，右击。


输入测试的文件名+Tests后，直接下一步下一步即可

写测试代码

首先引入要测试的模块（项目名）：

@testable import CoffeeChat // @testable 可访问 internal 属性方法

写测试方法（类似Main函数入口）：

// 格式为 test+名字，否则无法运行，如下
func testConnect(){
    let client = CIMClient()
    client.connect(ip: "10.0.106.117", port:8000)
    sleep(3)
}

完整代码如下：

//
//  CIMClientTests.swift
//  CoffchatTests
//
//  Created by xuyingchun on 2020/3/16.
//  Copyright © 2020 Xuyingchun Inc. All rights reserved.
//

import XCTest

@testable import Coffchat

class CIMClientTests: XCTestCase {
    func testConnect(){
        let client = CIMClient()
        client.connect(ip: "10.0.106.117", port:8000)
        
        sleep(3)
    }
}

执行测试

直接点击要测试函数行号位置的“运行”图标即可。

当然，也可以通过以下方式：
快捷键 command + u

tips
单元测试可以分模块来，也可以分小功能来，你开心就好了

这是用到系统自带的单元测试，网上也有其他的方案

测试结果和列表：

删除单元测试项目

1. 删除单元测试文件夹，比如"CoffchatTests"
2. 删除target，具体如下（如果只删除文件夹，不删除target会报错）
   1. 点击项目名
   2. 点击“左侧展开”
   3. 在要删除的target上右击删除
      

备注

单元测试常用方法

XCTAssert(expression, format...)当expression求值为TRUE时通过

其他方法参考

XCTFail(format…) 生成一个失败的测试；
XCTAssertNil(a1, format...)为空判断，a1为空时通过，反之不通过；
XCTAssertNotNil(a1, format…)不为空判断，a1不为空时通过，反之不通过；
XCTAssert(expression, format...)当expression求值为TRUE时通过；
XCTAssertTrue(expression, format...)当expression求值为TRUE时通过；
XCTAssertFalse(expression, format...)当expression求值为False时通过；
XCTAssertEqualObjects(a1, a2, format...)判断相等，[a1 isEqual:a2]值为TRUE时通过，其中一个不为空时，不通过；
XCTAssertNotEqualObjects(a1, a2, format...)判断不等，[a1 isEqual:a2]值为False时通过；
XCTAssertEqual(a1, a2, format...)判断相等（当a1和a2是 C语言标量、结构体或联合体时使用, 判断的是变量的地址，如果地址相同则返回TRUE，否则返回NO）；
XCTAssertNotEqual(a1, a2, format...)判断不等（当a1和a2是 C语言标量、结构体或联合体时使用）；
XCTAssertEqualWithAccuracy(a1, a2, accuracy, format...)判断相等，（double或float类型）提供一个误差范围，当在误差范围（+/-accuracy）以内相等时通过测试；
XCTAssertNotEqualWithAccuracy(a1, a2, accuracy, format...) 判断不等，（double或float类型）提供一个误差范围，当在误差范围以内不等时通过测试；
XCTAssertThrows(expression, format...)异常测试，当expression发生异常时通过；反之不通过；（很变态） XCTAssertThrowsSpecific(expression, specificException, format...) 异常测试，当expression发生specificException异常时通过；反之发生其他异常或不发生异常均不通过；
XCTAssertThrowsSpecificNamed(expression, specificException, exception_name, format...)异常测试，当expression发生具体异常、具体异常名称的异常时通过测试，反之不通过；
XCTAssertNoThrow(expression, format…)异常测试，当expression没有发生异常时通过测试；
XCTAssertNoThrowSpecific(expression, specificException, format...)异常测试，当expression没有发生具体异常、具体异常名称的异常时通过测试，反之不通过；
XCTAssertNoThrowSpecificNamed(expression, specificException, exception_name, format...)异常测试，当expression没有发生具体异常、具体异常名称的异常时通过测试，反之不通过

参考：https://www.jianshu.com/p/be32739d8aae