Skip to content


Subversion checkout URL

You can clone with
Download ZIP
GUI for managing Unit Tests in XCode
Objective-C Perl



This is a Cocoa application to help make running unit tests in Xcode a bit easier. It provides a means of selecting which unit tests will run as well as a visual pass/fail indication. I plan to add some features like "rerun only failing tests", etc.


XcodeUnitTestGUI utilizes distributed notifications to be updated with the current pass/fail state of unit tests. In order to enable these notifications, you need to link your unit test target with the supplied XcodeUnitTestGUIHelper.framework.

Aside from that, just launch the app and it should query Xcode every so often. If the currently active project has a unit test, those test should get loaded into the app. You can then select what you'd like to run, and hit 'Run'. Sometimes no tests will show up. This is the case when the unit test bundle is not currently built. In this case you should either choose 'Run' from XcodeUnitTestGUI which will initiate a build in Xcode. Alternatively, you can just build the unit test bundle in Xcode before running XcodeUnitTestGUI.

Please log any issues or feature ideas on the github Issues page.

How are unit tests discovered?

A unit test shows up if the active project has a built target which is a bundle with an extension of octest. If this is found, that bundle is loaded and queried to find classes deriving from SenTestCase with methods starting with "test". All such methods should show up.

Basic Usage

To use the program follow this sequence of events:

  • Launch Xcode (if it's not already running)
  • Navigate to the Xcode project with a unit test bundle and build it
  • Launch XcodeUnitTestGUI
  • At this point your suites/tests should be visible in the tool and you can select tests and run them from the tool
Something went wrong with that request. Please try again.