FoneMonkey: The Download

Tonight I am releasing FoneMonkey into the wild. Without further ado, here it is:

FoneMonkey.zip

The iPhone does not yet allow installation of user-defined frameworks, so FoneMonkey is disbributed as a static library along with the image files and nibs required by the FoneMonkey user interface. FoneMonkey.zip contians libFoneMonkey.a as well as a bunch of png and xib files.

The zip file does not include the FoneMonkey source code, which we'll be releasing when we officially launch the FoneMonkey open source project in mid-January, 2010 (ie, just a few weeks from now!). At that time we'll be going live with a community forum as well. Until then, please post questions or comments to this blog.

To get started using FoneMonkey, download the zip file and extract the FoneMonkey distribution folder. Then follow the instructions below.

Happy testing! We look forward to your feedback!

Testing an iPhone application with FoneMonkey

In order to test an iPhone application with FoneMonkey, you must first link FoneMonkey with your application as shown in the 2-minute video below. Step-by-step textual instructions are also provided here.

You might need to view the video in a new window.

1. Open your application's project in xcode.
2. Duplicate your application's build target by right-clicking on it and selecting Duplicate from the menu. A new target will be created called YourApp copy.
   
3. Rename YourApp copy to something like YourAppTest.
   
4. Add the downloaded FoneMonkey folder to your project by right-clicking on the project and selecting Add > Existing Files... from the menu. Navigate to the FoneMonkey folder, select it, and click the Add button.
   
5. When the dialog box appears, select the Recursively create groups for any added folders option.
6. In the Add to Targets box, deselect YourApp and select YourAppTest.
7. Click Add.
8. Right-click on the YourAppTest build target and select Get Info from the menu.
9. On the General tab, delete libFoneMonkey.a from the Linked Libraries. You will need to add CoreGraphics.framework and QuartzCore.framework to the Linked Libraries list they aren't already there.
10. On the Build tab, scroll down to the Linking section and click on the Other Linker Flags setting. When the dialog box appears, enter:
    
    -ObjC -lFoneMonkey -LFoneMonkey/lib -all_load
    
    
11. Dismiss the project Info window.
12. Right-click on YourAppTest build target and select Clean from the menu.
13. Right-click on YourAppTest build target again and select Build and Debug from the menu.
14. Your application should start in the simulator. Immediately after it displays, the FoneMonkey console should drop down over it.
15. See this post for more info about recording and playing back tests with FoneMonkey.