| Usage | Synopsis |
|---|---|
| Run on all connected devices | $ tns run ios [--release] [--justlaunch] |
| Run on a selected connected device | $ tns run ios [--device <Device ID>] [--release] [--justlaunch] |
| Start an emulator and run the app inside it | $ tns run ios --emulator [<Emulator Options>] [--release] |
Runs your project on a connected iOS device or in the iOS Simulator, if configured. This is shorthand for prepare, build, and deploy. While your app is running, prints the output from the application in the console.
<% if(isConsole && (isWindows || isLinux)) { %>WARNING: You can run this command only on OS X systems. To view the complete help for this command, run $ tns help run ios<% } %>
<% if((isConsole && isMacOS) || isHtml) { %>
<% if(isHtml) { %>> <% } %>IMPORTANT: Before building for iOS device, verify that you have configured a valid pair of certificate and provisioning profile on your OS X system. <% if(isHtml) { %>For more information, see Obtaining Signing Identities and Downloading Provisioning Profiles.<% } %>
--watch- If set, when you save changes to the project, changes are automatically synchronized to the connected device.--device- Specifies a connected device on which to run the app.--emulator- If set, runs the app in a native emulator for the target platform, if configured. When set, you can also set any other valid combination of emulator options as listed by$ tns help emulate ios. You cannot use--deviceand--emulatorsimultaneously.--release- If set, produces a release build. Otherwise, produces a debug build.--justlaunch- If set, does not print the application output in the console.
<Device ID>is the index or name of the target device as listed by$ tns device ios<Emulator Options>is any valid combination of options as listed by$ tns help emulate ios<% } %> <% 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 run iosonly on OS X systems. - You cannot use
--deviceand--emulatorsimultaneously.
| Command | Description |
|---|---|
| appstore | Lists applications registered in iTunes Connect. |
| appstore upload | Uploads project to iTunes Connect. |
| 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 ios | Builds the specified project and runs it in the native iOS Simulator. |
| 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 | Runs your project on a connected device or in the native emulator for the selected platform. |
| test init | Configures your project for unit testing with a selected framework. |
| test android | Runs the tests in your project on Android devices or native emulators. |
| test ios | Runs the tests in your project on iOS devices or the iOS Simulator. |
| <% } %> |