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.
Features
- 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 (iOS)
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
Note: If you don't have a Tests target in your project, you will get an error: "[!] Unable to find a target named Tests". If you named your test target something different, such as "ProjectTests" then the Podfile target line should look like: target :ProjectTests do
instead.
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)
iOS
cd Project-iOS && make
Add the GHUnitIOS.framework
to your project
OS X
cd Project-MacOSX && make
Add the GHUnit.framework
to your project
Documentation
- How to install, create and run tests
- Online documentation
- Google Group (Deprecated - Use Github Issues instead)