iOS_单元测试二之UITests

UI测试基于三个新类的实现：

• XCUIApplication：代表整个应用程序，可以用来启动、结束进程，或者传入一些启动参数。常用来查询UI上的元素
• XCUIElementQuery：代表一系列可查询的UI元素
• XCUIElement：代表具体的UI的元素

---

建一个UITests类：

那些setUp和tearDown方法这里就不一一赘述了，上一篇文章有介绍过。
我们来看看不一样的：

// 应用程序对象
let app: XCUIApplication = XCUIApplication()
override func setUpWithError() throws {
    // 在UI测试中，当出现故障时，最好立即停止
    continueAfterFailure = false
    // UI测试必须启动它们测试的应用程序。在设置中这样做将确保每个测试方法都会发生这种情况
    self.app.launch()
}

一、XCUIApplication

XCUIApplication应用程序的代理：

1、初始化和基本使用

// 创建应用程序的代理
let app = XCUIApplication()
// 创建指定bundleId的应用程序的代理
let app2 = XCUIApplication(bundleIdentifier: "xxxx")

// 同步启动应用程序，如果已有应用程序实例在运行了，则会被终止，以确保启动实例处于干净的状态
app.launch()
// 激活应用程序，如果之前没有启动则启动；如果之前启动过，则启动参数和环境变量将再次提供给新的启动
// (不同于launch，如果已有实例在运行，不会终止现有实例)
app.activate()
// 终止正在运行的应用程序实例
app.terminate()

2、properties：

// 程序的启动参数
let launchArguments: [String] = app.launchArguments
// 程序的启动环境
let launchEnvironment: [String : String] = app.launchEnvironment
// 程序的状态
// unknown、notRunning、runningBackgroundSuspended、runningBackground、runningForeground
let state = app.state

3、functions：

// wait
// 等待程序变为特定状态，n秒后放弃
// 这是一个同步方法，有以下3种情况：
// 1、程序当前处于特定状态：立即返回true
// 2、超时之前程序转为特定状态：返回true
// 3、超时后：返回false
let result = app.wait(for: .runningForeground, timeout: 3)

// resetAuthorizationStatus
// 重置受保护资源的授权状态，以便下次访问该资源时系统将显示授权提示。
// 如果此时app正在运行，重置时app可能会被终止
// XCUIProtectedResource 枚举：
// contacts、calendar、reminders、photos、microphone、camera、mediaLibrary、homeKit、bluetooth、keyboardNetwork、location、health
app.resetAuthorizationStatus(for: .camera)

4、XCUIElementTypeQueryProvider协议

XCUIElementTypeQueryProvider：

// XCUIElementQuery 一般都是从 XCUIApplication 中取的
self.app.windows
self.app.tabs
self.app.tabBars
self.app.navigationBars
self.app.tables
self.app.cells
self.app.staticTexts
self.app.buttons
self.app.images
self.app.scrollViews
self.app.collectionViews
self.app.webViews
self.app.sliders
self.app.textFields
self.app.textViews
self.app.switches
self.app.keyboards
// 等等

二、XCUIDevice

XCUIDevice可以模拟iOS设备的物理按钮、设备方向和Siri交互的代理

let device = XCUIDevice.shared
// UIDeviceOrientation 枚举：
// unknown: 未知
// portrait: 设备垂直方向，Home键在下方
// portraitUpsideDown: 设备垂直方向，Home键在上方
// landscapeLeft: 设备水平方向，Home键在右侧
// landscapeRight: 设备水平方向，Home键在左侧
// faceUp: 面向设备平面，面朝上
// faceDown: 面向设备平面，面朝下
let orientation: UIDeviceOrientation = device.orientation

// siri 服务
let siriService = device.siriService
// 如果Siri用户界面当前未处于活动状态，则显示该用户界面，并接受一个字符串，然后将其作为语音进行处理。
siriService.activate(voiceRecognitionText: "xxxx")

// 按home键
device.press(XCUIDevice.Button.home) // home键
#if targetEnvironment(simulator)
#else
// 音量加/减键 在simulator上不可用
device.press(XCUIDevice.Button.volumeUp) // 音量加
device.press(XCUIDevice.Button.volumeDown) // 音量减
#endif

三、XCUIElement

XCUIElement在应用程序中的UI元素

let element: XCUIElement = self.app.cells.staticTexts["UnitTests"]
// 断言该Element存在
XCTAssert(element.exists)
// 等待出现，n秒后放弃（同app.wait）
let result = element.waitForExistence(timeout: 3)
// 是否可以为元素计算生命点以合成事件?
element.isHittable

1、XCUIElementAttributes

XCUIElementAttributes

element.identifier
element.frame
element.value
element.title
element.label
element.elementType // 这个枚举有很多
element.isEnabled
element.isSelected
// SizeClass: unspecified、compact、regular
element.horizontalSizeClass
element.verticalSizeClass
element.placeholderValue
// 等等

2、手势：

// 手势：
element.tap() // 点击
element.doubleTap() // 双击
element.press(forDuration: 3) // 长按
element.press(forDuration: 3, thenDragTo: cell2) // 长按后拖拽
element.twoFingerTap() // 双指点击
element.tap(withNumberOfTaps: 3, numberOfTouches: 3) // 3指，3击
// 滑动手势：
element.swipeUp()
element.swipeDown()
element.swipeLeft()
element.swipeRight()
// 用两次触碰发出捏的手势
// scale：捏手势的比例。使用0到1之间的比例“收缩关闭”或缩小，使用大于1的比例“收缩打开”或放大
// velocity: 每秒尺度因子中的收缩速度
element.pinch(withScale: 0.5, velocity: 0.5)

// 通过两次触摸发送旋转手势
// rotation: 旋转弧度
// velocity: 旋转姿态的速度（弧度/秒）
element.rotate(5, withVelocity: 0.5)

查找：

// 返回与指定类型匹配的元素的所有子代的查询
let cellButtons: XCUIElementQuery = element.descendants(matching: .button)
// 返回与指定类型匹配的元素的直接子元素的查询
let cellButtons2: XCUIElementQuery = element.children(matching: .button)

3、snapshot

snapshot

do {
    let snapshot: XCUIElementSnapshot = try element.snapshot()
    let childerns: [XCUIElementSnapshot] = snapshot.children
    for childern: XCUIElementSnapshot in childerns {
        print("snapshot: \(childern.dictionaryRepresentation)")
    }
    print("snapshot success: \(snapshot)")
} catch {
    print("snapshot error: \(error)")
}

4、XCUICoordinate

XCUICoordinate屏幕上相对于某个UI元素的位置

// 创建并返回一个新的坐标，该坐标将通过将偏移量乘以元素帧的大小添加到元素帧的原点来计算其屏幕点
let coordinate: XCUICoordinate = element.coordinate(withNormalizedOffset: CGVector(dx: 100, dy: 100))

// 屏幕上坐标位置的动态计算值
let point: CGPoint = coordinate.screenPoint
// 创建一个新坐标，该坐标与原始坐标的绝对偏移以点为单位
let coordinate2: XCUICoordinate = coordinate.withOffset(CGVector(dx: 50, dy: 50))

coordinate.tap() // 点击
coordinate.doubleTap() // 双击
coordinate.press(forDuration: 3) // 长按
coordinate.press(forDuration: 3, thenDragTo: coordinate2) // 长按后拖拽

还有一些只能在macOS上使用的，这里就不赘述了~

---

UI测试的正确性的一般模式如下：

• 使用XCUIElementQuery查找XCUIElement。
• 合成事件并将其发送到XCUIElement。
• 使用一个断言将XCUIElement的状态与预期的参考状态进行比较。

---

简单举例：

1、业务代码：

// 订阅按钮的 accessibilityIdentifier
let gSubscribeButtonAccessibilityIdentifier = "MOTestsViewController_subscribeButton"
class MOTestsViewController: UIViewController {
    var subscribeButton: UIButton = {
        let btn = UIButton(type: .custom)
        btn.backgroundColor = .gray
        btn.setTitle("订阅", for: .normal)
        btn.setTitle("已订阅", for: .selected)
        btn.addTarget(self, action: #selector(clickSubscribeButton), for: .touchUpInside)
        // 为按钮设置accessibilityIdentifier
        btn.accessibilityIdentifier = gSubscribeButtonAccessibilityIdentifier
        return btn
    }()
    
    override func viewDidLoad() {
        super.viewDidLoad()
        self.view.addSubview(self.subscribeButton)
    }
    
    override func viewDidLayoutSubviews() {
        super.viewDidLayoutSubviews()
        self.subscribeButton.frame = CGRect(x: 10.0, y: 100.0, width: 100.0, height: 50.0)
    }
	// 按钮点击后切换状态
    @objc func clickSubscribeButton(sender: UIButton) {
        sender.isSelected = !sender.isSelected
    }
}

2、测试代码：

func testSubscribeButtonTapAction() throws {
    // 点击Cell进入 单元测试VC
    let tables: XCUIElementQuery = self.app.tables // tableViews
    let cells: XCUIElementQuery = tables.cells // cells
    let cell: XCUIElement = cells.staticTexts["UnitTests"] // UnitTests cell
    cell.tap() // 点击cell
    
    // 获取订阅按钮（因为这个按钮的title会变，所以用title获取会出错）
    // 因此需要为按钮设置accessibilityIdentifier
    // 然后根据accessibilityIdentifier获取订阅按钮
    let button: XCUIElement = self.app.buttons[gSubscribeButtonAccessibilityIdentifier]
    
    XCTAssertFalse(button.isSelected) // 断言按钮未选择状态
    button.tap() // 点击按钮
    XCTAssertTrue(button.isSelected) // 断言按钮已选择状态
}

---

• accessibilityIdentifier管理

整个APP中的每个控件都需要一个唯一的accessibilityIdentifier（或者至少是同一个ElementType的accessibilityIdentifier不能相同），这个需要制定规范统一管理。我们目前采取的方案是用控件所在类的类名+控件变量名作为accessibilityIdentifier。

---

github Demo地址

参考：

User Interface Testing

iOS UI Testing 指北
iOS UI Tests 实现方案分析