ios-sim
launch iOS apps into the iOS Simulator from the command line (Xcode 6.0+)
Last updated 3 years ago by shazron .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install ios-sim -g
SYNC missed versions from official npm registry.

NPM Build status Build Status

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.

Current Tags

  • 8.0.1                                ...           latest (2 months ago)
  • 6.1.3                                ...           maintenance (a year ago)
  • 9.0.0-dev.4                                ...           next (3 months ago)

39 Versions

  • 8.0.1                                ...           2 months ago
  • 9.0.0-dev.4                                ...           3 months ago
  • 9.0.0-dev.3                                ...           3 months ago
  • 9.0.0-dev.2                                ...           3 months ago
  • 9.0.0-dev.1                                ...           3 months ago
  • 9.0.0-dev.0                                ...           3 months ago
  • 8.0.0                                ...           4 months ago
  • 6.1.3                                ...           a year ago
  • 7.0.0                                ...           a year ago
  • 6.1.2                                ...           2 years ago
  • 6.1.1                                ...           2 years ago
  • 6.0.0                                ...           2 years ago
  • 5.1.0                                ...           2 years ago
  • 5.0.13                                ...           3 years ago
  • 5.0.12                                ...           3 years ago
  • 5.0.11                                ...           3 years ago
  • 5.0.10                                ...           3 years ago
  • 5.0.9                                ...           3 years ago
  • 5.0.8                                ...           3 years ago
  • 5.0.7                                ...           3 years ago
  • 5.0.6                                ...           3 years ago
  • 5.0.5                                ...           3 years ago
  • 5.0.4                                ...           4 years ago
  • 5.0.3                                ...           4 years ago
  • 5.0.2                                ...           4 years ago
  • 5.0.1                                ...           4 years ago
  • 5.0.0                                ...           4 years ago
  • 3.2.0                                ...           4 years ago
  • 4.1.1                                ...           4 years ago
  • 4.1.0                                ...           4 years ago
  • 3.1.1                                ...           5 years ago
  • 3.1.0                                ...           5 years ago
  • 3.0.0                                ...           5 years ago
  • 2.0.1                                ...           5 years ago
  • 2.0.0                                ...           5 years ago
  • 1.9.0                                ...           5 years ago
  • 1.8.2                                ...           6 years ago
  • 1.8.1                                ...           6 years ago
  • 1.8.0                                ...           6 years ago

Copyright 2014 - 2016 © taobao.org |