/SBTUITestTunnel

Enable network mocks and more in UI Tests

Primary LanguageObjective-COtherNOASSERTION

SBTUITestTunnel

CI

Version License Platform Swift Package Manager

Overview

Apple introduced a new UI Testing feature starting from Xcode 7 that is, quoting Will Turner on stage at the WWDC, a huge expansion of the testing technology in the developer tools. The framework is easy to use and the integration with the IDE is great however there is a major problem with the way tests are launched. Testing code runs as a separate process which prevents to directly share data with the app under test making it hard to do things like dynamically inject data or stub network calls.

SBTUITestTunnel extends UI testing functionality allowing to dynamically:

  • stub network calls
  • download/upload files from/to the app's sandbox
  • monitor network calls
  • rewrite network calls
  • block cookies
  • interact with NSUserDefaults
  • define custom blocks of codes executed in the application target
  • fine grain fast-scrolling in table/collection/scroll views
  • CLLocationManager stubbing
  • UNUserNotificationCenter stubbing

The library supports concurrent parallel testing, so multiple Simulators can be used at once.

The library consists of two separated components which communicate with each other, one to be instantiate in the application's target and the other in the testing target.

Should I use this?

SBTUITestTunnel is intended to extend Apple's XCTest framework, not to replace it. It all boils down to a single subclass of XCUIApplication which comes with the additional features listed above, so it is very easy to integrate with your existing testing code.

Documentation

  • Installation: Describes how to install the library
  • Setup: Describes how to integrate the library in your code
  • Usage: Describes how to use the library
  • Example: Describes how to setup and use the example app

Additional resources?

We made additional resources available to improve the UI Testing experience:

  • Mendoza: parallelize UI tests over multiple physical machines
  • Cachi: parse Xcode's 11 .xcresult bundles
  • SBTUITestTunnelHost: access the mac host from your test target

Thanks

Kudos to the developers of the following pods which we use in SBTUITestTunnel:

Contributions

Contributions are welcome! If you have a bug to report, feel free to help out by opening a new issue or sending a pull request.

Authors

Tomas Camin (@tomascamin)

License

SBTUITestTunnel is available under the Apache License, Version 2.0. See the LICENSE file for more info.