| Usage | Synopsis |
|---|---|
| General | $ tns emulate ios [--path <Directory>] [--device <Device Name>] [--available-devices] [--release] [--timeout] |
Builds the specified project and runs it in the native iOS Simulator.
<% if(isConsole && (isLinux || isWindows)) { %>WARNING: You can run this command only on OS X systems. To view the complete help for this command, run $ tns help emulate ios<% } %>
<% if((isConsole && isMacOS) || isHtml) { %>### Options
--available-devices- Lists all available device type identifiers for the current Xcode.--release- If set, produces a release build. Otherwise, produces a debug build.--path- Specifies the directory that contains the project. If not specified, the project is searched for in the current directory and all directories above it.--device- Specifies the name of the iOS Simulator device on which you want to run your app. To list the available iOS Simulator devices, run$ tns emulate ios --available-devices--timeout- Sets the number of seconds that the NativeScript CLI will wait for the iOS Simulator to start before quitting the operation and releasing the console. The value must be a positive integer. If not set, the default timeout is 90 seconds.
<Device Name>is the name of the iOS Simulator device on which you want to run your app as listed by$ tns emulate ios --available-devices<% } %>
<% if(isHtml) { %>
Before running the iOS Simulator, verify that you have met the following requirements.
- You have installed Xcode. The version of Xcode must be compatible with the ios-sim-portable npm package on which the NativeScript CLI depends. For more information, visit https://www.npmjs.org/package/ios-sim-portable.
- You can run
$ tns emulate iosonly on OS X systems.
| Command | Description |
|---|---|
| build android | Builds the project for Android and produces an APK that you can manually deploy on device or in the native emulator. |
| build ios | Builds the project for iOS and produces an APP or IPA that you can manually deploy in the iOS Simulator or on device, respectively. |
| build | Builds the project for the selected target platform and produces an application package that you can manually deploy on device or in the native emulator. |
| debug android | Debugs your project on a connected Android device or in a native emulator. |
| debug ios | Debugs your project on a connected iOS device or in a native emulator. |
| debug | Debugs your project on a connected device or in a native emulator. |
| deploy | Builds and deploys the project to a connected physical or virtual device. |
| emulate android | Builds the specified project and runs it in a native Android emulator. |
| emulate | You must run the emulate command with a related command. |
| livesync | Synchronizes the latest changes in your project to devices. |
| livesync ios | Synchronizes the latest changes in your project to iOS devices or the iOS Simulator. |
| livesync android | Synchronizes the latest changes in your project to Android devices. |
| run android | Runs your project on a connected Android device or in a native Android emulator, if configured. |
| run ios | Runs your project on a connected iOS device or in the iOS Simulator, if configured. |
| run | Runs your project on a connected device or in the native emulator for the selected platform. |
| <% } %> |