A tool for running prebuilt iOS tests on iOS real device and simulator.
You can download the ios_test_runner.par binary in release
or build the ios_test_runner.par binary by bazel:
$ git clone https://github.com/google/xctestrunner.git
$ cd xctestrunner
$ bazel build xctestrunner:ios_test_runner.par
$ ls bazel-bin/xctestrunner/ios_test_runner.par
xcodebuild
command line tool or bazel.In overview, there are two sub-commands in the runner binary.
test
: Run test directly on connecting iOS real device or existing iOS
simulator.simulator_test
: Run test on a new created simulator, which will be deleted
after test finishes.See more details by running ios_test_runner.par -h
in terminal.
Disclaimer: This is not an official Google product.
XCTestRunner uses Apple native tool xcodebuild
, simctl
to control iOS
Simulator and launch tests on iOS devices.
For testing, XCTestRunner injects app under test and test bundle file into a
dummy project. Then the dummy project can be used xcodebuild test
to run
XCTest (not for XCUITest), or xcodebuild build-for-testing
to generate
xctestrun file for further testing.
For iOS 7 real device testing, the latest supported Xcode version is 7.2.1. For iOS 7 simulator testing, latest supported Xcode version is 7.2.1 and latest supported MacOS version is Yosemite (10.10.x).