iPhone Simulator 
----------------
 
The iPhone Simulator is a simple command line utility for 
launching an iphone application in the simulator. This allows
for nice things like automated testing of unit tests, etc without
having to open XCode.

You can run the application by first building your application in
xcode using the xcodebuild command from the command line.  You can
then run it in the simulator using the following as an example:

./iphonesim launch ~/tmp/yourproject/build/Debug.simulator/yourproject.app

You need to point to either Debug.simulator or Release.simulator based 
on which build type you built with.


USAGE
-----

iphonesim <command> <options>

Commands:
  showsdks
  launch <application path>
Options:
  -sdkVersion <sdk version>
  -family <family>
  -uuid <uuid>
  -stderr <stderr redirection>
  -stdout <stdout redirection>
  -debug <YES|NO>
  -gdbcommands <gdb commands file>


Examples
--------
Use with gdb and gdb commands:
$ ./iphonesim launch XXX.app -debug YES -sdkVersion "3.0" -gdbcommands gdbscripts/opengl-state-tracer.txt









----
Main launcher code written by:

  Jeff Haynie
  jhaynie@appcelerator.com
    

  Author: Landon Fuller <landonf@plausiblelabs.com>
  Copyright (c) 2008 Plausible Labs Cooperative, Inc.
  All rights reserved.
          
  Permission is hereby granted, free of charge, to any person
  obtaining a copy of this software and associated documentation
  files (the "Software"), to deal in the Software without
  restriction, including without limitation the rights to use,
  copy, modify, merge, publish, distribute, sublicense, and/or sell
  copies of the Software, and to permit persons to whom the
  Software is furnished to do so, subject to the following
  conditions:

  The above copyright notice and this permission notice shall be
  included in all copies or substantial portions of the Software.
  
  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
  EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
  OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
  NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
  HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
  WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
  FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
  OTHER DEALINGS IN THE SOFTWARE.
  

  Modifications made by Appcelerator, Inc. relicensed under
  the same license as above.

  Modifications made by Maxime Biais relicensed under the same license
  as above.