XCTSkip 你的测试

获取重要的测试结果——跳过无关紧要的测试结果。了解如何用 XCTSkip 有条件地避免在运行时进行测试。我们将带你了解如何返回此新测试结果，并更好地记录测试包中除了合格和不合格之外的测试。要想充分利用本节内容，建议先熟悉 XCTest 和单元/ UI 测试。观看 “在 Xcode 中测试”以获取入门知识。了解 XCTSkip 之后，请进一步了解在测试方面的改进：观看“使用 XCTIssue对测试不合格进行分类”，“处理 UI 测试中的中断和警报”，“更快地获得测试结果”和“使用 XCTest 消除动画故障”。要想了解如何改进测试套件，请查看“编写不合格测试”。

资源

- 高清视频
- 标清视频

相关视频

WWDC22

为 Xcode Cloud 创建快速而可靠的测试

WWDC20

WWDC19

在 Xcode 中进行测试

（你好 WWDC 2020）你好欢迎参加 WWDC （XCTSkip 你的测试）你好我叫 Wil 我从事 Xcode 的测试和自动化工作在本次讲座中我们将学习 XCTSkip 一个根据运行时条件管理测试执行的新 API 一些测试特别是集成测试有无法轻易模拟的要求或依赖关系例如 app可能有无法用 iPhone 测试的 iPad 特定功能在其它情况下测试可能会使用在运行旧版本 OS 的设备中不可用的 API 或者测试可能需要定期离线进行维护的服务器所有这些都是只能在运行时确定的条件的例子要处理环境不满足测试要求的情况需要一个使测试执行有条件的方法否则测试编写者就剩下一个选择提前返回并通过测试或报告失败

这两种方式都有缺点通过测试表明代码能正常工作但实际上它未经过验证但测试失败会提出一个不存在的问题并可能会消耗分流资源

幸运的是当有需要有条件执行的测试时你现在可以使用 XCTSkip 该 API 在 Xcode 11.4 中引入可生成一个新的测试结果测试可以通过或失败或者使用 XCTSkip 用显式“跳过”结果进行标记

Xcode 用这个图标来突出显示被跳过的测试使你能更清楚地了解你的测试套件验证了什么让我们在实践中更好地了解它的工作方式我这里有一个小项目叫“花园游戏” 我一直在和我 3 岁的女儿一起进行该项目 “花园游戏”帮助我们追踪后院的所有植物、玩具和家具我们最近决定增加对指针交互的支持因为我们喜欢这个功能而且主要是在 iPad 上使用该 app

尽管只有三岁我女儿完全接受测试驱动的开发所以当然我们会为这个新功能添加一些单元测试现在你可以在屏幕上看到其中一个测试碰巧这个测试有两个条件在这两个条件下执行它是没有意义的首先由于指针交互是在 iOS 13.4 中引入的我们不能在旧版本的 OS 上运行这个测试因此我会添加一个将 XCTSkip 用于较旧的 iOS 版本的可用性保护

其次该 app 仅在 ipad 上允许指针交互如果我们在其它类型的设备上运行我们不需要执行这个测试我会用“XCTSkipIf”来处理这种情况首先让我们用目的地来运行这个测试在那里它可以正常执行我会使用运行 iOS 14 的 iPad （构建成功）

（测试成功）你可以看到它正如我们所期望的那样运行和通过现在让我们在较老的设备上运行这个运行 iOS 13 的 iPhone

这次我要用我最喜欢的键盘快捷键 “controloptioncommandG”来运行测试它只是重复之前的测试动作

（已跳过测试 - 指针交互）这次我们可以看到绿色的“通过”图标被灰色的“跳过”图标所替代并且源代码编辑器中的注释显示跳过测试的位置和原因

让我们看看在 Xcode 中用户界面得出跳过结果的其它地方首先是 Test Navigator

在这里我们可以看到在测试旁显示的跳过此外你可以使用导航器底部的该按钮过滤显示列表以便仅显示跳过的测试

现在让我们来看看测试报告

以下是用跳过运行的结果

当我展开测试详细信息时我们会看到跳过发生的文件和行以及跳过的原因当我将鼠标悬停在这上面时或许你注意到了行尾的两个按钮第一个是“跳转”按钮它转至跳过发生的位置和源我会返回以便我们能探讨第二个按钮

在 Xcode 12 中新增的“助手”按钮会打开辅助编辑器显示跳过的参考源位置这使我们能同时查看测试报告和源代码最后让我们看看跳过如何在持续集成中出现

这里有在三个不同设备上运行测试的 CI 系统的结果我要使用“已跳过”过滤器这样我们就可以仅仅专注于这个测试当我展开测试时我们会看到运行测试的每个设备的结果第一台 iPad 为通过其它设备为跳过展开设备结果显示了每个跳过的位置和原因使所有这些信息触手可及就是这样我们看到了在各种条件下在测试中使用 XCTSkip 有多容易以及 Xcode 如何突出显示了跳过的测试与正常通过或失败的测试之间的差异现在让我们仔细看看 API

正如你在演示中看到的有几种不同的方法来使用 XCTSkip 有两个抛出函数 XCTSkipIf 和 XCTSkipUnless 两个函数使用相同的参数在表达式为真时 XCTSkipIf 跳过在表达式为假时 XCTSkipUnless 跳过

这里的例子展示了在 iPad 以外的任何设备上运行时测试可能如何跳过

测试也可以直接抛出 XCTSkip 结构体这与保护结合使用很方便如 iOS 13.4 的可用性检查所示

总结一下一些测试特别是集成测试可能在某些条件下无法执行你可以用 XCTSkip 以最准确地模拟测试运行结果的方式来响应这些条件这继而确保了更清晰的总体结果尤其是在测试套件在持续集成系统中执行时感谢观看

5:45 - Use XCTSkipUnless to bypass a test on devices other than iPad

func testExample() throws {

    /// Example usage: skip test if device is not an iPad
    try XCTSkipUnless(UIDevice.current.userInterfaceIdiom == .pad, 
              "Pointer interaction tests are for iPad only")

    // test...
}

5:58 - Use guard+XCTSkip to bypass a test on an older OS version

func testExample() throws {

    /// Example usage: skip test if OS version is older than iOS 13.4
    guard #available(iOS 13.4, *) else {
        throw XCTSkip("Pointer interaction tests can only run on iOS 13.4+")

    // test...
}