Running individual XCTest (UI, Unit) test cases for iOS apps from the command line

ios unit-testing xctest xcode-ui-testing
Apophenia Overload picture Apophenia Overload · Feb 3, 2016 · Viewed 18k times · Source

Is it possible to run individual test cases, or individual test suites, from an iOS app test target, instead of all the test cases, from a command line interface?

You can run tests from command line with xcodebuild, out of the box. When you do so, you run all of the test cases contained in the test target you've selected.

You can also do so with scan from Fastlane, though I believe you're restricted to running all of the tests of the build scheme you select (as above), so it's not different from xcodebuild.

You can run specific tests with xctool from Facebook, but it doesn't use xcodebuild, and is restricted to running on simulators only, not actual iOS test devices.

I found a reference to running the xctest command line utility directly, but it seems to be an undocumented feature and targets DerivedData. This is complicated by the fact that UI Tests, have their *xctest files in a separate XCTRunner bundle.

Answer

emoleumassi picture emoleumassi · Jun 22, 2016

It is now possible with Xcode 8 using the -only-testing parameter with xcodebuild:

xcodebuild test -workspace <path>
                -scheme <name>
                -destination <specifier>
                -only-testing:TestBundle/TestSuite/TestCase

Check this video: https://developer.apple.com/videos/play/wwdc2016/409/

enter image description here

Related questions

Xcode Unit Testing with Cocoapods

I've been banging my head against a wall with this for the last few days but despite multiple Google/SO/Github searches I can't find a resolution to the issues I'm having! All I'm trying to do is create some …

Read More
When do app sources need to be included in test targets?

In a new project I have this simple test #import <XCTest/XCTest.h> #import "ViewController.h" @interface ViewControllerTests : XCTestCase @end @implementation ViewControllerTests - (void)testExample { // Using a class that is not in the test target. ViewController * viewController = [[ViewController …

Read More
Xcode 6 Editor doesn't recognize unit tests

I have a problem that the Xcode IDE 6 doesn't detect my swift unit test cases correctly. When I run the unit tests, all tests were executed. But in the IDE while editing the unit tests aren't recognized. I have to …

Read More