如何使用 XCTest UI 测试区分 iOS 13 中的标题和静态文本

Question

使用最新版本的 Xcode 11 在 iOS 13 上运行，我找不到区分 XCTest UI 测试中的标题和静态文本的方法。

如果我使用 Xcode 11 但在 iOS 12 上运行，我仍然可以通过使用 XCTest 过滤 .other 元素类型来找到具有 .header 特征的视图，但在 iOS 13 视图上使用 .header 特征现在只是由带有 XCTest 的 .staticText 元素类型标识，即使您没有在应用程序中设置 .staticText 可访问性特征。

这给我们带来了一个问题，因为我们使用它来确保我们记得在视图上正确设置标题特征以实现可访问性，以及能够确保我们正在查看正确的屏幕测试。

诚然，只能通过.other 找到标题并不好，但至少它是一种将标题与常规文本区分开来的方法。

这里有一些示例代码来解释：

// ViewController.swift

headerLabel.isAccessibilityElement = true // headerLabel is just a UILabel IBOutlet
headerLabel.accessibilityTraits = [.header]
headerLabel.text = "My Header"

// ViewControllerTests.swift

XCTAssertTrue(XCUIApplication().otherElements["My Header"].firstMatch.waitForExistence(timeout: 30)) // This fails on iOS 13 but works on iOS 12 :(
XCTAssertTrue(XCUIApplication().staticTexts["My Header"].firstMatch.waitForExistence(timeout: 30)) // This fails on iOS 12 but works on iOS 13...

如果你在 Xcode 中 po XCUIApplication() 可以看到，在 iOS 13 上，标题现在只是一个 staticText 与其他所有标签相同。

我尝试过组合不同的accessibilityTraits（因为您可以拥有多个），例如：

headerLabel.accessibilityTraits = [.header, .staticText]

但这无济于事。

Answer 1

好的，经过几天的调查，我们找到了解决方法。不幸的是，它使用了一个私有 API，但我们并不担心，因为它是用于测试的，并且比我们迄今为止尝试过的任何其他解决方法都要好。

使用私有 API，可以找出 XCUIElement 所代表的视图的底层 UIAccessibilityTraits：

var underlyingAccessibilityTraits: UIAccessibilityTraits {
    guard let rawValue = value(forKey: "traits") as? UInt64 else { return [] }
    return UIAccessibilityTraits(rawValue: rawValue)
}

现在我们有了特征，我们可以像任何其他OptionSet一样查询它们：

element.underlyingAccessibilityTraits.contains(.header)

我们可以使用它来构建我们自己的查询，而不是使用XCUIElementQuery：

let allElementsMatchingID = XCUIApplication().descendants(matching: .any).matching(.any, identifier: id) // id is an optional string as an ID, like when using `XCUIApplication().otherElements[id]`
let allHeaders = allElementsMatchingID.allElementsBoundByAccessibilityElement.filter { $0.underlyingAccessibilityTraits.contains(.header) }
let element = allHeaders[index] // index is an int, like when using `element(boundBy: 0`

这样做的一个缺点（除了必须使用私有 API）是，与常规的 XCUIElementQuerys 不同，如果索引超出范围，这将崩溃，但如果您总是期望元素存在，那就是没什么大不了的。

Answer 2

您可以在标题的accessibilityIdentifier 中添加前缀，以将其与静态文本区分开来，例如：

myHeader.accessibilityIdentifier = "Header" + title

只使用与之前相同的静态文本

myLabel.accessibilityIdentifier = title