GHUnit: Unit Testing Objective-C for the iPhone

GHUnit is a test framework for Objective-C that runs on Mac OS X 10.5 and above and iPhone 3.x and above. It can be used standalone or with other testing frameworks like SenTestingKit or GTM.

These notes are for XCode 3.2.5. You can assume these steps are fragile and you need to follow them to the letter.

Setting Up the Environment

1. Start XCode and create a new project by selecting New Project under the File menu,
   
2. In the New Project popup, in the left column, select Application under iPhone OS. In the upper right panel, select Window-Based Application,
   
3. Select your device type. Chose iPhone for this example.
4. Provide a name and a location. For this example, I will use the name Calculator and the directory will be the /Users/Nearsoft/Desktop.
5. Now run your application. Use -r or from the pull-down menu Build > Build and Run.
   
6. As a result you should see the simulator, like this,
   
7. Now, quit the simulator and switch back to XCode.

Adding GHUnit Framework to Our Project.

8. Download the last version of GHUnit Framework (as of this writing, it is 0.4.27) from here.
   
9. Unzip the ZIP file in the same directory where you saved your project. This will create the directory GHUnitIOS.framework.
10. Add a new target to your project. Control-click (right-click) on Targets and select Add - New Target.
    
11. In the left column select iOS - Cocoa Touch and Application. Give it a descriptive name. For this example, I will use UnitTests.
    
12. We need to add a few Frameworks to our new Target. Right-click on our target, select then Add and then choose Existing Frameworks. Lets add these three,
    1. CoreGraphics.framework
    2. Foundation.framework
    3. UIKit.framework
    
13. To add the GHUnitIOS.framework, you need click on the “Add Other…” button and choose the GHUnitIOS.framework directory which just unzipped in step 9, above.
14. If you've done this right so far, you will see something like this,
    

Add a few linker flags to our project

15. Choose the UnitTests target, control-click on it and choose Get info.
16. Tab and look for Other Linker Flags and double-click on that option.
    
17. Add the following,
    1. -ObjC
    2. Add: -all_load
    3. Close that dialog.
18. Once you add the flags you will see something like the image bellow,
    
19. Look for the UnitTests-Info.plist in the Groups & Files column, and edit the option Main nib file base name.  Then, delete this value (i.e., by clearing the field) and save it.
    

Add the GHUnitIOSTestMain.m

20. Download GHUnitIOSTestMain. You can download it form here.
    
21. Create a new Group in our project. I will call it UnitTests.
22. Inside UnitTests Group add the GHUnitIOSTestMain.m,
    1. Right click on UnitTests Group, select Add – Existing Files…
    2. Look for the file just download and double-click on it.
    3. Checkmark Copy items into destination group's folder (if needed), and then click the Add button.
    
    
23. Once you do that, Build and Run the UnitTests target.

NOTE: if you have a compilation error in the line #import <GHUnitIOS/GHUnit.h> change it for #import <GHUnit/GHUnit.h>

24. If you see this image, you've done well.
    

Create a Test

24. Under the UnitTest Group, right click select Add - New File, an Objective-C class (under iOS – Cocoa Touch Class).
25. Name it FirstTest.m. For Unit Test files, we do not need create a header file. So uncheck the option Also create "…".h. Verify that UnitTeststarget is selected.
26. Then click Finish
    
27. Enter this code in the FirstTest.m file,
    //
//  FirstTest.m
//  Calculator
//
//  Created by Jesus Guerra on 3/9/11.
//  Copyright 2011 Nearsoft. All rights reserved.
//
#import
@interface FirstTest : GHTestCase {
    NSString *stringValue;
}
@end

@implementation FirstTest

-(void)setUp {
    stringValue= @"Hello World";
}

-(void)tearDown {
    stringValue= nil;
}

-(void)testCompareTwoStrings {
    GHAssertEquals(@"", stringValue, @"The value is not the same than '%@'", stringValue);
}
@end

28. You will then have something like this,
    
29. After that, Build and Run UnitTest target.
30. When the simulator shows up, tap on Run. The test will fail, so just go back to your code and change the assertion in the method testCompareTwoStrings,
    GHAssertEquals(@"Hello World", someVariableToInitialize, @"The value is not the same as '%@'", someVariableToInitialize);
    

And Finally …

Congratulations, we did it!

Reprinted from ：http://www.nearsoft.com/blog/printblog.html?index_php?view=article&id=305&tmpl=component&print=1