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 and watches for changes in your code. Once a change is detected, it synchronizes the change with all selected devices and restarts/refreshes the application.
WARNING: You can run this command only on macOS systems. To view the complete help for this command, run
$ tns help run ios
IMPORTANT: Before building for iOS device, verify that you have configured a valid pair of certificate and provisioning profile on your macOS system. For more information, see the Code Signing and Maintain Signing Assets sections from the Apple Developer documentation.
To enable Hot Module Replacement (HMR) in Angular projects, follow the steps outlined in this wiki: https://github.com/NativeScript/nativescript-angular/wiki/HMR.
|Run on all connected devices||
|Run on a selected connected device. Will start simulator with specified
|Start an emulator and run the app inside it||
|Start an emulator with specified device name and sdk||
|Start an emulator with specified device identifier and sdk||
--device- Specifies a connected device/simulator to start and run the app.
<Device ID>is the index or
Device Identifierof the target device as listed by the
$ tns device ios --available-devicescommand.
--emulator- If set, runs the app in all available and configured ios simulators. It will start a simulator if none are already running.
--sdk- Specifies the target simulator's sdk.
--justlaunch- If set, does not print the application output in the console.
--clean- If set, forces the complete rebuild of the native application.
--no-watch- If set, changes in your code will not be reflected during the execution of this command.
--release- If set, produces a release build. Otherwise, produces a debug build.
--bundle- Specifies that the
webpackbundler will be used to bundle the application.
--hmr- (Beta) Enables the hot module replacement (HMR) feature. HMR depends on
webpackand adding the
--hmrflag to the command will automatically enable the
--bundleoption as well. The HMR feature is currently in Beta. For more information about the current development state and any known issues, please check the relevant GitHub issue: https://github.com/NativeScript/NativeScript/issues/6398.
--env.*- Specifies additional flags that the bundler may process. May be passed multiple times.
--env.aot- creates Ahead-Of-Time build (Angular only).
--env.snapshot- creates Snapshot (only for release builds on Mac OS & for Android).
--env.uglify- provides basic obfuscation and smaller app size.
--env.report- creates a Webpack report inside a
reportfolder in the root folder.
--env.sourceMap- creates inline source maps (useful for debbuging bundled app).
--env.hiddenSourceMap- creates sources maps in the root folder (useful for Crashlytics usage with bundled app in release).
--syncAllFiles- Watches all production dependencies inside node_modules for changes. Triggers project rebuild if necessary!
Note: Hot Module Replacement (HMR) is currently in Beta. For more information about the current development state and any known issues, please check the relevant GitHub issue: https://github.com/NativeScript/NativeScript/issues/6398.
Before running the iOS Simulator, verify that your system meets the following requirements.
- You have installed a version of Xcode which is 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 macOS systems.
- You cannot use
|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.|
|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.|