Supports Node 6 and greater, and Xcode 9.4 and greater -- since version 8.x.
ios-sim tool is a command-line utility that launches an iOS application on the iOS Simulator. This allows for niceties such as automated testing without having to open Xcode.
showdevicetypesoption to see available device types, and pass it in as the
--help option for more info.
Usage: ios-sim <command> <options> [--args ...] Commands: showsdks List the available iOS SDK versions showdevicetypes List the available device types launch <application path> Launch the application at the specified path on the iOS Simulator start Launch iOS Simulator without an app install <application path> Install the application at the specified path on the iOS Simulator without launching the app Options: --version Print the version of ios-sim --help Show this help text --exit Exit after startup --log <log file path> The path where log of the app running in the Simulator will be redirected to --devicetypeid <device type> The id of the device type that should be simulated (Xcode6+). Use 'showdevicetypes' to list devices. e.g "com.apple.CoreSimulator.SimDeviceType.Resizable-iPhone6, 8.0" Removed in version 4.x: --stdout <stdout file path> The path where stdout of the simulator will be redirected to (defaults to stdout of ios-sim) --stderr <stderr file path> The path where stderr of the simulator will be redirected to (defaults to stderr of ios-sim) --sdk <sdkversion> The iOS SDK version to run the application on (defaults to the latest) --family <device family> The device type that should be simulated (defaults to `iphone') --retina Start a retina device --tall In combination with --retina flag, start the tall version of the retina device (e.g. iPhone 5 (4-inch)) --64bit In combination with --retina flag and the --tall flag, start the 64bit version of the tall retina device (e.g. iPhone 5S (4-inch 64bit)) Unimplemented in this version: --verbose Set the output level to verbose --timeout <seconds> The timeout time to wait for a response from the Simulator. Default value: 30 seconds --args <...> All following arguments will be passed on to the application --env <environment file path> A plist file containing environment key-value pairs that should be set --setenv NAME=VALUE Set an environment variable
Choose one of the following installation methods.
Install using Node.js (6 or greater):
$ npm install ios-sim -g
Download a zip file:
$ curl -L https://github.com/phonegap/ios-sim/archive/master.zip -o ios-sim.zip $ unzip ios-sim.zip
Download using git clone:
$ git clone git://github.com/phonegap/ios-sim.git
Be sure to enable Developer Mode on your machine:
$ DevToolsSecurity -enable
Ensure that multiple instances of
launchd_sim are not running:
$ killall launchd_sim
This project is available under the MIT license. See