GHUnit is a test framework for Mac OS X and iOS. It can be used standalone or with other testing frameworks like SenTestingKit or GTM.
- Run tests, breakpoint and interact directly with the XCode Debugger.
- Run from the command line or via a Makefile.
- Run tests in parallel.
- Allow testing of UI components.
- Capture and display test metrics.
- Search and filter tests by keywords.
- View logging by test case.
- Show stack traces and useful debugging information.
- Include as a framework in your projects
- Determine whether views have changed (UI verification)
- Quickly approve and record view changes
- View image diff to see where views have changed
Install the GHUnit gem
$ gem install ghunit
Install the Tests target
This will edit your ProjectName.xcodeproj file and create a Tests target, scheme, and a sample test file.
$ ghunit install -n ProjectName
Add the Tests target to your Podfile
Create a new file named
Podfile in the directory that contains the your
.xcodeproj file, or edit it if it already exists.
# Podfile platform :ios, '6.0' target :Tests do pod 'GHUnit', '~> 0.5.9' end
Install your project's pods. CocoaPods will then download and configure the required libraries for your project:
$ pod install
You should use the
.xcworkspace file to work on your project:
$ open ProjectName.xcworkspace
Install Command Line
$ ghunit install_cli -n ProjectName
Install ios-sim using homebrew:
$ brew install ios-sim
Now you can run tests from the command line:
$ ghunit run -n ProjectName
Add a test
To generate a test in your test target with name SampleTest:
$ ghunit add -n ProjectName -f SampleTest
Install (From Source)
cd Project-iOS && make
GHUnitIOS.framework to your project
cd Project-MacOSX && make
GHUnit.framework to your project
- How to install, create and run tests
- Online documentation
- Google Group (Deprecated - Use Github Issues instead)