概述
强大的 iOS 端到端 UI 测试框架。
目前它被 Avito 使用,在那里我们有 700+ 端到端 UI 测试,其中大约 90% 是绿色的,并帮助我们已经减少了 2 年的手动测试。我们在 PR 中运行大约 25%,并且我们正在努力将 100% 的测试都运行在 pull request 上,部分是通过从黑盒端到端测试转向灰盒测试。我们在 3 个平台上运行这些测试,大约需要 40 分钟(测试的总时长是 30+ 小时),因为我们使用的是 Emcee,这是一个在多台机器上运行测试的测试运行器(请注意,Mixbox 不需要 Emcee)。我们也正在编写灰盒测试(其中我们会模拟类、网络等一切),但我们才刚刚开始。
如果您想在自己的公司中使用它,请向我们提交问题。我们正在努力使其能被社区使用,尽管这并不是我们的主要目标。
特性
-
操作和检查(很明显)
-
像素级可见性检查
-
所有内容都有轮询
-
完全自动滚动
-
黑盒测试和灰盒测试!
- 黑盒测试在单独的应用程序中运行,并且能够启动应用程序。您可以借助此类测试测试更多应用程序功能。您可以使用模拟,但将需要您编写更多代码(使用启动参数或实现进程间通信)。
- 灰盒测试在应用程序内部运行(类似 EarlGrey),但测试与黑盒测试具有 运行时兼容性,因此您可以将测试模型、页面对象、测试辅助工具等共享。因为测试在同一个进程内执行,您可以轻松地模拟任何事物。如果您不使用模拟,则无法启动并运行应用程序以进行测试。
大多数的代码在灰盒测试和白盒测试之间共享,因为大多数功能都是这样的。这两种方式都有自己的优势。使用这两种方法可以获得良好的测试金字塔。
-
页面对象
- 可以包含任意代码的函数
- 页面对象元素可以嵌套元素(但是,这需要一些不太美观的模板代码)
- 一切(操作/检查)都是完全可扩展的。如果你实现了自定义操作或检查,它将自动适用于黑白盒测试(参见
SwipeAction
,所有内置操作都是真正的扩展)。
-
CollectionsView中的每个单元格在测试中都是可见的(包括屏幕外的单元格)
-
可定制应用程序和测试之间的进程间通信
-
测试中可见的视图的自定义值
-
网络模拟(通过 NSURLSessionProtocol)
-
设置权限(相机/地理位置/通知等)
-
推送通知的模拟(局限性:只能在活动应用内部!)
-
从测试中打开URL
-
地理位置模拟
-
硬件键盘(定义了很少的键盘代码,但是可以轻松实现)
-
无需分支仓库即可自定义
-
Swift & Objective-C
-
经过测试
- 3种设备配置上的176个黑盒UI测试
- 3种设备配置上的155个灰盒UI测试
- 4种设备配置上的100个单元测试
- SwiftLint + 自定义linter
- 每次将Mixbox作为一个请求拉取时,都会执行所有测试,通常1个PR等同于1个提交。
- 使用5个版本的Xcode(10.0、10.1、10.2.1、10.3、11.0)测试了两个演示。
-
可配置的报告(例如:
Tests
项目与具有Web UI的开源报告系统Allure集成;在Avito,我们使用内部解决方案进行报告;您可以编写自己的实现)
开发中/尚未开源
- 页面对象的代码生成
- 获取应用程序中的所有断言失败
- 与Springboard一起工作的外观
- 在发布性和测试构建之间切换可访问性值
安装
使用Mixbox有两种方法。
第一个在演示中进行了描述,它过于简化,基本上你只需要使用 pod SomePod
。
第二种是我们用在Avito上的,看起来像这样:测试(如Podfile所示)。
文档还不够充分,所以您可以使用简单的链接Mixbox方法(演示),但使用测试中的代码示例。
支持的iOS/Xcode/Swift版本
- Xcode 11
- Swift 5
- iOS 10.3、iOS 11.4、iOS 12.1,中间版本可能工作或不工作,所提及的版本已在CI上测试
- Cocoapods 1.8.4
- Mac OS 10.14.6
不再支持Xcode 9/10及更旧版本。如果您计划在不同的环境下使用此项目并遇到问题,请告诉我们。
已知问题
- 在iOS 11.2上崩溃(在iOS 11.3、iOS 11.4上运行正常)
- 在物理设备上设置权限不起作用(可能其他也不起作用,我们没有在物理设备上测试;基本功能是可行的)
- 没有测试设备旋转,我认为我们对此有问题
- 没有测试iPad
- 在报告中出现俄语(即将修复)
示例
有关真实示例,请参阅Tests
项目。它是最新的开源示例,但缺乏现实感(不展示如何为真实应用编写测试)。
展示基本功能的测试示例
func test() {
// Setting permissions
permissions.camera.set(.allowed)
permissions.photos.set(.notDetermined)
// Functions are useful in page objects and allows
// reusing code, for example, for transitions between states of the app
pageObjects.initial
.authorize(user: testUser)
.goToCvScreen()
// Aliases for simple assertions (you can add your own):
pageObjects.simpleCv.view.assertIsDisplayed()
pageObjects.simpleCv.title.assertHasText("My CV")
// Fully customizable assertions
pageObjects.simpleCv.addressField.assertMatches { element in
element.text != addressFieldInitialText && element.text.isNotEmpty
}
// Network stubbing.
networking.stubbing
.stub(urlPattern: ".*?example.com/api/cv")
.thenReturn(file: "cv.json")
// There is also a monitoring feature, including recording+replaying feature that
// allows to record all network and replay in later, so your tests will not require internet.
// Actions
pageObjects.simpleCV.occupationField.setText("iOS developer")
pageObjects.simpleCV.createCVButton.tap()
}
声明页面对象
public final class MapScreen:
BasePageObjectWithDefaultInitializer,
ScreenWithNavigationBar // protocol extensions are very useful for sharing code
{
// Basic locator
public var mapView: ViewElement {
return element("Map view") { element in
element.id == "GoogleMapView"
}
}
// You can use complex checks
// Note that you can create your own matchers like `element.isFooBar()`
public func pin(coordinates: Coordinates, deltaInMeters: Double = 10) -> ViewElement {
return element("Pin with coordinates \(coordinates)") { element in
element.id == "pin" && element
.customValues["coordinates", Coordinates.self]
.isClose(to: coordinates, deltaInMeters: deltaInMeters)
}
}
}
声明自定义页面对象元素
public final class RatingStarsElement:
BaseElementWithDefaultInitializer,
ElementWithUi
{
public func assertRatingEqualsTo(
_ number: Int,
file: StaticString = #file,
line: UInt = #line)
{
assertMatches(file: file, line: line) { element in
element.customValues["rating"] == number
}
}
}
复制粘贴的代码
此库包含从其他库复制粘贴的一些代码。有时是单个文件,有时是因为我们需要在源代码中构建条件编译,以防止在发布版中链接代码。
- EarlGrey(每个使用
EarlGrey
的源文件都包含EarlGrey
子串)。许可证在此(Apache)。这是一个可见性检查器,设置辅助功能等。《原始仓库: https://github.com/google/EarlGrey - AnyCodable。添加了
#if
子句。《原始仓库: https://github.com/Flight-School/AnyCodable - SBTUITestTunnel。3.0.6版本之后的WebView存在一个bug,然后几年后在构建它时遇到了不稳定的情况。修复方法非常原始——复制粘贴所有内容以避免问题。我们本可以深入了解,但计划未来使用原生的IPC解决方案,所以我们没有进一步追究。原始仓库: https://github.com/Subito-it/SBTUITestTunnel
- CocoaImageHashing。由于向后兼容性问题(ameingast/cocoaimagehashing#13),我们不能合并修改,因此我们使用了复制粘贴的代码。 原始仓库: https://github.com/ameingast/cocoaimagehashing
用于测试
- https://github.com/akveo/eva-icons:测试图像相似性代码的各种图标(MIT许可证)。