tns run

Description

Runs your project on all connected devices or in native emulators for the selected platform.The command will work with all currently running Android devices and emulators. The command will prepare, build and deploy the app when necessary. By default listens for changes in your code, synchronizes those changes and refreshes all selected devices.

When running this command without passing --release flag, the HMR (Hot Module Replacement) is enabled by default. In case you want to disable HMR, you can pass --no-hmr flag. When --release is passed, CLI disables HMR.

How file changes are handled

With HMR (Hot Module Replacement):

• Changes in .js, .ts, .less, .sass and other file types that are accepted will cause a refresh of the application.
• Changes in App_Resources will cause a rebuild of the application.
• Changes in any package.json file inside the project will cause a rebuild of the application.
• Changes in node_modules/somePlugin if accepted will cause a refresh of the application.
• Changes in node_modules/somePlugin/platforms will cause a rebuild of the application.
• Changes in node_modules/somePlugin/package.json file will cause a rebuild of the application.
• Changes that are not accepted and HMR fails will cause a restart of the native application.

With no HMR:

• Changes in .js, .ts, .less, .sass and other file types will cause a restart of the native application.
• Changes in App_Resources will cause a rebuild of the application.
• Changes in any package.json file inside the project will cause a rebuild of the application.
• Changes in node_modules/somePlugin will cause a restart of the native application.
• Changes in node_modules/somePlugin/platforms will cause a rebuild of the application.
• Changes in node_modules/somePlugin/package.json file will cause a rebuild of the application.

Commands

Options

• --justlaunch - If set, does not print the application output in the console.
• --release - If set, produces a release build by running webpack in production mode and native build in release mode. Otherwise, produces a debug build.
• --device - Specifies a connected device/emulator to start and run the app. <Device ID> is the index or Device Identifier of the target device as listed by the $ tns device <Platform> --available-devices command.
• --no-hmr - Disables Hot Module Replacement (HMR). In this case, when a change in the code is applied, CLI will transfer the modified files and restart the application.
• --env.* - Specifies additional flags that the bundler may process. Can be passed multiple times. Supported additional flags:
  • --env.aot - creates Ahead-Of-Time build (Angular only).
  • --env.snapshot- creates a V8 Snapshot decreasing the app start time (only for release builds for Android).
  • --env.compileSnapshot- compiles the static assets produced by --env.snapshot into .so files allowing the native build to split them per architecture. This will reduce the app size when using the --aab option.
  • --env.uglify - provides basic obfuscation and smaller app size.
  • --env.report - creates a Webpack report inside a report folder in the root folder.
  • --env.sourceMap - creates inline source maps.
  • --env.hiddenSourceMap - creates sources maps in the root folder (useful for Crashlytics usage with bundled app in release).
• --aab - Specifies that the command will produce and deploy an Android App Bundle.
• --force - If set, skips the application compatibility checks and forces npm i to ensure all dependencies are installed. Otherwise, the command will check the application compatibility with the current CLI version and could fail requiring tns migrate.

Arguments

<Platform> is the target mobile platform for which you want to run your project. You can set the following target platforms:

• android - Run your project on all Android devices and emulators.
• ios - Run your project on all iOS devices and simulators.

Command Limitations

• The command will work with all connected devices and running emulators on macOS. On Windows and Linux the command will work with Android devices only.
• In case a platform is not specified and there's no running devices and emulators, the command will fail.

Related Commands