cordova-plugin-uiwebview-engine
Version:
Cordova UIWebView Engine Plugin
99 lines (66 loc) • 4.17 kB
Markdown
[](https://nodei.co/npm/ios-sim/)
[](https://ci.appveyor.com/project/shazron/ios-sim-bn5fo)
[](https://travis-ci.org/ios-control/ios-sim)
ios-sim
=======
Supports Node 6 and greater, and Xcode 9.4 and greater -- since version 8.x.
The `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.
Features
--------
* Choose the device family to simulate, i.e. iPhone or iPad. Run using `showdevicetypes` option to see available device types, and pass it in as the `devicetypeid` parameter.
See the `--help` option for more info.
Usage
-----
```
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
```
Installation
------------
Choose one of the following installation methods.
### Node JS
Install using Node.js (6 or greater):
$ npm install ios-sim -g
### Zip
Download a zip file:
$ curl -L https://github.com/phonegap/ios-sim/archive/master.zip -o ios-sim.zip
$ unzip ios-sim.zip
### Git
Download using git clone:
$ git clone git://github.com/phonegap/ios-sim.git
Troubleshooting
---------------
Be sure to enable Developer Mode on your machine:
$ DevToolsSecurity -enable
Ensure that multiple instances of `launchd_sim` are not running:
$ killall launchd_sim
License
-------
This project is available under the MIT license. See [`LICENSE`](./LICENSE).