@akylas/nativescript-cli 8.7.2

package/docs/man_pages/project/configuration/resources/resources-generate-icons.md

@@ -0,0 +1,39 @@
+<% if (isJekyll) { %>---
+title: ns resources generate icons
+position: 11
+---<% } %>
+
+# ns resources generate icons
+
+### Description
+
+Generates all icons for Android and iOS platforms and places the generated images in the correct directories under `App_Resources/<platform>` directory.
+
+### Commands
+
+Usage | Synopsis
+------|-------
+`$ ns resources generate icons <Path to image>` | Generate all icons for Android and iOS based on the specified image.
+
+### Options
+
+* `--background` Sets the background color of the icon. When no color is specified, a default value of `transparent` is used. `<Color>` is a valid color and can be represented with string, like `white`, `black`, `blue`, or with HEX representation, for example `#FFFFFF`, `#000000`, `#0000FF`. NOTE: As the `#` is special symbol in some terminals, make sure to place the value in quotes, for example `$ ns resources generate icons ../myImage.png --background "#FF00FF"`.
+
+### Arguments
+
+* `<Path to image>` is a valid path to an image that will be used to generate all icons.
+
+<% if(isHtml) { %>
+
+### Related Commands
+
+Command | Description
+----------|----------
+[install](../install.html) | Installs all platforms and dependencies described in the `package.json` file in the current directory.
+[platform add](../platform-add.html) | Configures the current project to target the selected platform.
+[platform remove](../platform-remove.html) | Removes the selected platform from the platforms that the project currently targets.
+[platform](../platform.html) | Lists all platforms that the project currently targets.
+[prepare](../prepare.html) | Copies common and relevant platform-specific content from the app directory to the subdirectory for the selected target platform in the platforms directory.
+[resources update](resources-update.md) | Updates the `App_Resources/Android` internal folder structure to conform to that of an Android Studio project.
+[resources generate splashes](resources-generate-splashes.md) | Generates splashscreens for Android and iOS.
+<% } %>

package/docs/man_pages/project/configuration/resources/resources-generate-splashes.md

@@ -0,0 +1,39 @@
+<% if (isJekyll) { %>---
+title: ns resources generate splashes
+position: 12
+---<% } %>
+
+# ns resources generate splashes
+
+### Description
+
+Generates all splashscreens for Android and iOS platforms and places the generated images in the correct directories under `App_Resources/<platform>` directory.
+
+### Commands
+
+Usage | Synopsis
+------|-------
+`$ ns resources generate splashes <Path to image> [--background <Color>]` | Generate all splashscreens for Android and iOS based on the specified image.
+
+### Options
+
+* `--background` Sets the background color of the splashscreen. When no color is specified, a default value of `white` is used. `<Color>` is a valid color and can be represented with string, like `white`, `black`, `blue`, or with HEX representation, for example `#FFFFFF`, `#000000`, `#0000FF`. NOTE: As the `#` is special symbol in some terminals, make sure to place the value in quotes, for example `$ ns resources generate splashes ../myImage.png --background "#FF00FF"`.
+
+### Arguments
+
+* `<Path to image>` is a valid path to an image that will be used to generate all splashscreens. 
+
+<% if(isHtml) { %>
+
+### Related Commands
+
+Command | Description
+----------|----------
+[install](../install.html) | Installs all platforms and dependencies described in the `package.json` file in the current directory.
+[platform add](../platform-add.html) | Configures the current project to target the selected platform.
+[platform remove](../platform-remove.html) | Removes the selected platform from the platforms that the project currently targets.
+[platform](../platform.html) | Lists all platforms that the project currently targets.
+[prepare](../prepare.html) | Copies common and relevant platform-specific content from the app directory to the subdirectory for the selected target platform in the platforms directory.
+[resources update](resources-update.md) | Updates the `App_Resources/Android` internal folder structure to conform to that of an Android Studio project.
+[resources generate icons](resources-generate-icons.md) | Generates icons for Android and iOS.
+<% } %>

package/docs/man_pages/project/configuration/resources/resources-update.md

@@ -0,0 +1,35 @@
+<% if (isJekyll) { %>---
+title: ns resources update
+position: 10
+---<% } %>
+
+# ns resources update
+
+### Description
+
+Updates the App_Resources/<platform>'s internal folder structure to conform to that of an Android Studio project. Android resource files and directories will be located at the following paths:
+- `drawable-*`, `values`, `raw`, etc. can be found at  `App_Resources/Android/src/main/res`
+- `AndroidManifest.xml` can be found at `App_Resources/Android/src/main/AndroidManifest.xml`
+- Java source files can be dropped in at `App_Resources/Android/src/main/java` after creating the proper package subdirectory structure
+- Additional arbitrary assets can be dropped in at `App_Resources/Android/src/main/assets`
+
+### Commands
+
+Usage | Synopsis
+------|-------
+`$ ns resources update` | Defaults to executing `$ ns resources update android`. Updates the App_Resources/Android's folder structure.
+`$ ns resources update android` | Updates the App_Resources/Android's folder structure.
+
+### Command Limitations
+
+* The command works only for the directory structure under `App_Resources/Android`. Running `$ ns resources-update ios` will have no effect.
+
+### Related Commands
+
+Command | Description
+----------|----------
+[install](install.html) | Installs all platforms and dependencies described in the `package.json` file in the current directory.
+[platform add](platform-add.html) | Configures the current project to target the selected platform.
+[platform remove](platform-remove.html) | Removes the selected platform from the platforms that the project currently targets.
+[platform](platform.html) | Lists all platforms that the project currently targets.
+[prepare](prepare.html) | Copies common and relevant platform-specific content from the app directory to the subdirectory for the selected target platform in the platforms directory.

package/docs/man_pages/project/configuration/resources/resources.md

@@ -0,0 +1,14 @@
+<% if (isJekyll) { %>---
+title: ns resources
+position: 9
+---<% } %>
+
+# ns resources
+
+### Available commands
+
+Command | Description
+------|-------
+resources update | Updates the App_Resources/<platform>'s internal folder structure to conform to that of an Android Studio project.
+resources generate splashes | Generates all splashscreens for Android and iOS platforms and places the generated images in the correct directories under App_Resources/<platform> directory.
+resources generate icons | Generates all icons for Android and iOS platforms and places the generated images in the correct directories under App_Resources/<platform> directory.

package/docs/man_pages/project/creation/create.md

@@ -0,0 +1,64 @@
+<% if (isJekyll) { %>---
+title: ns create
+position: 1
+---<% } %>
+
+# ns create
+
+### Description
+
+Interactively creates a new NativeScript app based on a predefined template.
+
+### Commands
+
+Template | Synopsis
+---------|---------
+JavaScript based | `$ ns create [<App Name>] [--js] [--path <Directory>] [--appid <App ID>]`
+TypeScript based | `$ ns create [<App Name>] --ts [--path <Directory>] [--appid <App ID>]`
+Angular based | `$ ns create [<App Name>] --ng [--path <Directory>] [--appid <App ID>]`
+Vue.js based | `$ ns create [<App Name>] --vue [--path <Directory>] [--appid <App ID>]`
+Custom template | `$ ns create [<App Name>] [--path <Directory>] [--appid <App ID>] --template <Template>`
+
+### Options
+
+* `--path` - Specifies the directory where you want to create the project, if different from the current directory. `<Directory>` is the absolute path to an empty directory in which you want to create the project.
+* `--appid` - Sets the application identifier of your project. `<App ID>` is the value of the application identifier and it must meet the specific requirements of each platform that you want to target. If not specified, the application identifier is set to `org.nativescript.<App name>`.<% if(isConsole) { %> For more information about the `<App ID>` requirements, run `$ ns help create`.<% } %><% if(isHtml) { %> The application identifier must be a domain name in reverse. For projects that target Android, you can use uppercase or lowercase letters, numbers, and underscores in the strings of the reversed domain name, separated by a dot. Strings must be separated by a dot and must start with a letter. For example: `com.nativescript.My_Andro1d_App`. For projects that target iOS, you can use uppercase or lowercase letters, numbers, and hyphens in the strings of the reversed domain name. Strings must be separated by a dot. For example: `com.nativescript.My-i0s-App`.
+* `--template` - Specifies a valid npm package which you want to use as a base to create your project. If `--template` is not set, the NativeScript CLI will ask you to pick one from a predefined list afterwards.<% if(isHtml) { %> If one or more application assets are missing from the `App_Resources` directory in the package, the CLI adds them using the assets available in the default hello-world template.<% } %> `<Template>` can be the name of a package in the npm registry, a local path or a GitHub URL to a directory, or a `.tar.gz` archive containing a `package.json` file. The contents of the package will be copied to the `app` directory of your project.<% } %>
+* `--js`, `--javascript` - Sets the template for your project to the JavaScript template.
+* `--ts`, `--tsc`, `--typescript` - Sets the template for your project to the TypeScript template.
+* `--ng`, `--angular` - Sets the template for your project to the Angular template.
+* `--vue`, `--vuejs` - Sets the template for your project to the Vue.js template.
+
+### Arguments
+
+`<App Name>` is the name of project and must meet the requirements of each platform that you want to target. If not specified in the initial command, the NativeScript CLI will ask you for it afterwards.<% if(isConsole) { %> For more information about the `<App Name>` requirements, run `$ ns help create`.<% } %><% if(isHtml) { %> For projects that target Android, you can use uppercase or lowercase letters, numbers, and underscores. The name must start with a letter. For projects that target iOS, you can use uppercase or lowercase letters, numbers, and hyphens.
+<% } %>
+
+<% if(isHtml) { %>
+
+### Application Templates
+
+Below you can see a list of the recommended NativeScript starting templates and the commands you should use to generate them.
+
+Template | Command
+---------|----------
+`JavaScript - Hello World`, `--js`, `--javascript` | ns create --template @nativescript/template-hello-world
+`JavaScript - SideDrawer` | ns create --template @nativescript/template-drawer-navigation
+`JavaScript - Tabs` | ns create --template @nativescript/template-tab-navigation
+`TypeScript - Hello World`, `--ts`, `--tsc`, `--typescript` | ns create --template @nativescript/template-hello-world-ts
+`TypeScript - SideDrawer` | ns create --template @nativescript/template-drawer-navigation-ts
+`TypeScript - Tabs` | ns create --template @nativescript/template-tab-navigation-ts
+`Angular - Hello World`, `--ng`, `--angular` | ns create --template @nativescript/template-hello-world-ng
+`Angular - SideDrawer` | ns create --template @nativescript/template-drawer-navigation-ng
+`Angular - Tabs` | ns create --template @nativescript/template-tab-navigation-ng
+`React - Hello World`, `--react`, `--reactjs` | ns create --template @nativescript/template-blank-react
+`Vue.js - Blank`, `--vue`, `--vuejs` | ns create --template @nativescript/template-blank-vue
+`Vue.js - SideDrawer`, | ns create --template @nativescript/template-drawer-navigation-vue
+`Vue.js - Tabs` | ns create --template @nativescript/template-tab-navigation-vue
+
+### Related Commands
+
+Command | Description
+----------|----------
+[install](/lib-management/install.html) | Installs all platforms and dependencies described in the `package.json` file in the current directory.
+<% } %>

package/docs/man_pages/project/testing/build-android.md

@@ -0,0 +1,62 @@
+<% if (isJekyll) { %>---
+title: ns build android
+position: 1
+---<% } %>
+
+# ns build android
+
+### Description
+
+Builds the project for Android and produces an APK that you can manually deploy on an Android device or Android emulator.
+
+### Commands
+
+Usage | Synopsis
+---|---
+General | `$ ns build android [--compileSdk <API Level>] [--key-store-path <File Path> --key-store-password <Password> --key-store-alias <Name> --key-store-alias-password <Password>] [--release] [--static-bindings] [--copy-to <File Path>] [--env.*]] [--aab]`
+
+### Options
+
+* `--compileSdk` - Sets the Android SDK that will be used to build the project. `<API Level>` is a valid Android API level. For example: 28, 29. The minimum supported SDK is 28. <% if(isHtml) { %> For a complete list of the Android API levels and their corresponding Android versions, click [here](http://developer.android.com/guide/topics/manifest/uses-sdk-element.html#platform).<% } %>
+* `--clean` - If set, forces the complete rebuild of the native application.
+* `--release` - If set, produces a release build. Otherwise, produces a debug build. When set, you must also specify the `--key-store-*` options.
+* `--key-store-path` - Specifies the file path to the keystore file (P12) which you want to use to code sign your APK. You can use the `--key-store-*` options along with `--release` to produce a signed release build. You need to specify all `--key-store-*` options.
+* `--key-store-password` - Provides the password for the keystore file specified with `--key-store-path`. You can use the `--key-store-*` options along with `--release` to produce a signed release build. You need to specify all `--key-store-*` options.
+* `--key-store-alias` - Provides the alias for the keystore file specified with `--key-store-path`. You can use the `--key-store-*` options along with `--release` to produce a signed release build. You need to specify all `--key-store-*` options.
+* `--key-store-alias-password` - Provides the password for the alias specified with `--key-store-alias-password`. You can use the `--key-store-*` options along with `--release` to produce a signed release build. You need to specify all `--key-store-*` options.
+* `--copy-to` - Specifies the file path where the built `.apk` will be copied. If it points to a non-existent directory path, it will be created. If the specified value is existing directory, the original file name will be used.
+* `--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](https://docs.nativescript.org/performance-optimizations/bundling-with-webpack#v8-heap-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 build will produce an Android App Bundle(`.aab`) file.
+* `--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 `ns migrate`.
+* `--path <Directory>` - Specifies the directory that contains the project. If not set, the project is searched for in the current directory and all directories above it.
+
+<% if(isHtml) { %>
+
+### Command Limitations
+
+* When the `--release` flag is set, you must also specify all `--key-store-*` options.
+
+### Related Commands
+
+Command | Description
+----------|----------
+[build ios](build-ios.html) | 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](build.html) | 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](debug-android.html) | Debugs your project on a connected Android device or in a native emulator.
+[debug ios](debug-ios.html) | Debugs your project on a connected iOS device or in a native emulator.
+[debug](debug.html) | Debugs your project on a connected device or in a native emulator.
+[deploy](deploy.html) | Builds and deploys the project to a connected physical or virtual device.
+[run android](run-android.html) | Runs your project on a connected Android device or in a native Android emulator, if configured.
+[run ios](run-ios.html) | Runs your project on a connected iOS device or in the iOS Simulator, if configured.
+[run](run.html) | Runs your project on a connected device or in the native emulator for the selected platform.
+[test init](test-init.html) | Configures your project for unit testing with a selected framework.
+[test android](test-android.html) | Runs the tests in your project on Android devices or native emulators.
+[test ios](test-ios.html) | Runs the tests in your project on iOS devices or the iOS Simulator.
+<% } %>

package/docs/man_pages/project/testing/build-ios.md

@@ -0,0 +1,65 @@
+<% if (isJekyll) { %>---
+title: ns build ios
+position: 2
+---<% } %>
+
+# ns build ios
+
+### Description
+
+Builds the project for iOS and produces an `APP` or `IPA` that you can manually deploy in the iOS Simulator or on a device.
+
+<% if(isConsole && (isWindows || isLinux)) { %>WARNING: You can run this command only on macOS systems. To view the complete help for this command, run `$ ns help build 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 macOS system. <% if(isHtml) { %>For more information, see the [Code Signing](https://developer.apple.com/support/code-signing/) and [Maintain Signing Assets](https://help.apple.com/xcode/mac/current/#/dev3a05256b8) sections from the Apple Developer documentation.<% } %>
+
+### Commands
+
+Usage | Synopsis
+---|---
+General | `$ ns build ios [--for-device] [--release] [--copy-to <File Path>] [--provision [<UUID/name>]] [--env.*]]`
+
+### Options
+
+* `--release` - If set, produces a release build. Otherwise, produces a debug build.
+* `--for-device` - If set, produces an application package that you can deploy on device. Otherwise, produces a build that you can run only in the native iOS Simulator.
+* `--i-cloud-container-environment` - If set, adds the passed `iCloudContainerEnvironment` when exporting an application package with the `--for-device` option.
+* `--copy-to` - Specifies the file path where the built `.ipa` will be copied. If it points to a non-existent directory path, it will be created. If the specified value is existing directory, the original file name will be used.
+* `--team-id` - If used without parameter, lists all team names and ids. If used with team name or id, it will switch to automatic signing mode and configure the .xcodeproj file of your app. In this case .xcconfig should not contain any provisioning/team id flags. This team id will be further used for codesigning the app. For Xcode 9.0+, xcodebuild will be allowed to update and modify automatically managed provisioning profiles.
+* `--provision` - If used without parameter, lists all eligible provisioning profiles. If used with UUID or name of your provisioning profile, it will switch to manual signing mode and configure the .xcodeproj file of your app. In this case xcconfig should not contain any provisioning/team id flags. This provisioning profile will be further used for codesigning the app.
+* `--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.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).
+* `--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 `ns migrate`.
+* `--path <Directory>` - Specifies the directory that contains the project. If not set, the project is searched for in the current directory and all directories above it.
+
+<% } %>
+
+<% if(isHtml) { %>
+
+### Command Limitations
+
+* You can run the `$ ns build ios` command only on macOS systems.
+
+### Related Commands
+
+Command | Description
+----------|----------
+[appstore](../../publishing/appstore.html) | Lists applications registered in iTunes Connect.
+[appstore upload](../../publishing/appstore-upload.html) | Uploads project to iTunes Connect.
+[build android](build-android.html) | Builds the project for Android and produces an APK that you can manually deploy on device or in the native emulator.
+[build](build.html) | 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](debug-android.html) | Debugs your project on a connected Android device or in a native emulator.
+[debug ios](debug-ios.html) | Debugs your project on a connected iOS device or in a native emulator.
+[debug](debug.html) | Debugs your project on a connected device or in a native emulator.
+[deploy](deploy.html) | Builds and deploys the project to a connected physical or virtual device.
+[run android](run-android.html) | Runs your project on a connected Android device or in a native Android emulator, if configured.
+[run ios](run-ios.html) | Runs your project on a connected iOS device or in the iOS Simulator, if configured.
+[run](run.html) | Runs your project on a connected device or in the native emulator for the selected platform.
+[test init](test-init.html) | Configures your project for unit testing with a selected framework.
+[test android](test-android.html) | Runs the tests in your project on Android devices or native emulators.
+[test ios](test-ios.html) | Runs the tests in your project on iOS devices or the iOS Simulator.
+<% } %>

package/docs/man_pages/project/testing/build.md

@@ -0,0 +1,66 @@
+<% if (isJekyll) { %>---
+title: ns build
+position: 3
+---<% } %>
+
+# ns build
+
+### Description
+
+Builds the project for Android <% if(isMacOS) { %>or iOS <% } %>and produces an application package that you can manually deploy on a device or native emulator. <% if(isMacOS) { %>You must specify the target platform for which you want to build your project.<% } %>
+
+When running this command the HMR (Hot Module Replacement) is not enabled by default. In case you want to enable HMR, you can pass `--hmr` flag.
+
+<% if(isHtml) { %>
+> NOTE: When passing `--release` CLI will disable HMR.
+<% } %>
+
+### Commands
+
+Usage | Synopsis
+---|---
+<% if((isConsole && isMacOS) || isHtml) { %>General | `$ ns build <Platform>`<% } %><% if(isConsole && (isLinux || isWindows)) { %>General | `$ ns build android`<% } %>
+
+<% if((isConsole && isMacOS) || isHtml) { %>### Arguments
+`<Platform>` is the target mobile platform for which you want to build your project. You can set the following target platforms.
+* `android` - Build the project for Android and produces an `APK` that you can manually deploy on a device or in the native emulator.
+* `ios` - Build the project for iOS and produces an `APP` or `IPA` that you can manually deploy in the iOS Simulator or on a device.<% } %>
+
+### 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 `$ ns device <Platform> --available-devices` command.
+* `--hmr` - Enables the hot module replacement (HMR) feature.
+* `--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](https://docs.nativescript.org/performance-optimizations/bundling-with-webpack#v8-heap-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 `ns migrate`.
+
+<% if(isHtml) { %>
+
+### Related Commands
+
+Command | Description
+----------|----------
+[appstore](../../publishing/appstore.html) | Lists applications registered in iTunes Connect.
+[appstore upload](../../publishing/appstore-upload.html) | Uploads project to iTunes Connect.
+[build android](build-android.html) | Builds the project for Android and produces an APK that you can manually deploy on device or in the native emulator.
+[build ios](build-ios.html) | Builds the project for iOS and produces an APP or IPA that you can manually deploy in the iOS Simulator or on device, respectively.
+[debug android](debug-android.html) | Debugs your project on a connected Android device or in a native emulator.
+[debug ios](debug-ios.html) | Debugs your project on a connected iOS device or in a native emulator.
+[debug](debug.html) | Debugs your project on a connected device or in a native emulator.
+[deploy](deploy.html) | Builds and deploys the project to a connected physical or virtual device.
+[run android](run-android.html) | Runs your project on a connected Android device or in a native Android emulator, if configured.
+[run ios](run-ios.html) | Runs your project on a connected iOS device or in the iOS Simulator, if configured.
+[run](run.html) | Runs your project on a connected device or in the native emulator for the selected platform.
+[test init](test-init.html) | Configures your project for unit testing with a selected framework.
+[test android](test-android.html) | Runs the tests in your project on Android devices or native emulators.
+[test ios](test-ios.html) | Runs the tests in your project on iOS devices or the iOS Simulator.
+<% } %>

package/docs/man_pages/project/testing/debug-android.md

@@ -0,0 +1,64 @@
+<% if (isJekyll) { %>---
+title: ns debug android
+position: 4
+---<% } %>
+
+# ns debug android
+
+### Description 
+
+Initiates a debugging session for your project on a connected Android device or Android emulator. When necessary, the command will prepare, build, deploy and launch the app before starting the debug session. While debugging, the output from the application is printed in the console and any changes made to your code are synchronizes with the deployed app.
+
+### Commands
+
+Usage | Synopsis
+---|---
+Deploy on device/emulator, run the app and generate a Chrome DevTools link for debugging | `$ ns debug android [--device <Device ID>] [--timeout <timeout>] [--aab]`
+Deploy on device/emulator, run the app and stop at the first code statement | `$ ns debug android --debug-brk [--device <Device ID>] [--timeout <timeout>] [--aab]`
+Deploy in the native emulator, run the app and stop at the first code statement | `$ ns debug android --debug-brk --emulator [--timeout <timeout>] [--aab]`
+Attach the debug tools to a running app on device/emulator | `$ ns debug android --start [--device <Device ID>] [--timeout <timeout>] [--aab]`
+Attach the debug tools to a running app in the native emulator | `$ ns debug android --start --emulator [--timeout <timeout>] [--aab]`
+
+### Options
+
+* `--device` - Specifies a connected device/emulator on which to debug the app. `<Device ID>` is the device identifier or name of the target device as listed by the `$ ns device android` command.
+* `--emulator` - Specifies that you want to debug the app in the native Android emulator.
+* `--debug-brk` - Prepares, builds and deploys the application package on a device/emulator, generates a link for Chrome Developer Tools and stops at the first code statement.
+* `--start` - Attaches the debug tools to a deployed and running app.
+* `--timeout` - Sets the number of seconds that the NativeScript CLI will wait for the emulator/device to boot. If not set, the default timeout is 90 seconds.
+* `--no-watch` - If set, changes in your code will not be reflected during the execution of this command.
+* `--clean` - If set, forces the complete rebuild of the native application.
+* `--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](https://docs.nativescript.org/performance-optimizations/bundling-with-webpack#v8-heap-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 `ns migrate`.
+
+<% if(isHtml) { %>
+
+### Command Limitations
+
+* You must have Google Chrome installed on your machine.
+
+### Related Commands
+
+Command | Description
+----------|----------
+[build](build.html) | 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.
+[build android](build-android.html) | Builds the project for Android and produces an APK that you can manually deploy on device or in the native emulator.
+[debug](debug.html) | Debugs your project on a connected device or in a native emulator.
+[debug ios](debug-ios.html) | Debugs your project on a connected iOS device or in a native emulator.
+[deploy](deploy.html) | Builds and deploys the project to a connected physical or virtual device.
+[device](../../device/device.html) | Lists all connected devices/emulators.
+[device android](../../device/device-android.html) | Lists all connected devices/emulators for android.
+[run](run.html) | Runs your project on a connected device or in the native emulator for the selected platform.
+[run android](run-android.html) | Runs your project on a connected Android device or in a native Android emulator, if configured.
+[test init](test-init.html) | Configures your project for unit testing with a selected framework.
+[test android](test-android.html) | Runs the tests in your project on Android devices or native emulators.
+<% } %>

package/docs/man_pages/project/testing/debug-ios.md

@@ -0,0 +1,65 @@
+<% if (isJekyll) { %>---
+title: ns debug ios
+position: 5
+---<% } %>
+
+# ns debug ios
+
+### Description
+
+Initiates a debugging session for your project on a connected iOS device or in the iOS simulator. When necessary, the command will prepare, build, deploy and launch the app before starting the debug session. While debugging, the output from the application is printed in the console and any changes made to your code are synchronizes with the deployed app. <% if(isHtml) { %>Any debugging traffic is forwarded to port 8080 (or the next available one) from the device to the local machine.<% } %>
+
+<% if(isConsole && (isWindows || isLinux)) { %>WARNING: You can run this command only on macOS systems. To view the complete help for this command, run `$ ns help debug 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 macOS system. <% if(isHtml) { %>For more information, see the [Code Signing](https://developer.apple.com/support/code-signing/) and [Maintain Signing Assets](https://help.apple.com/xcode/mac/current/#/dev3a05256b8) sections from the Apple Developer documentation.<% } %>
+
+### Commands
+
+Usage | Synopsis
+---|---
+Deploy on device/emulator, run the app, attach a debugger and generate a Chrome DevTools link for debugging | `$ ns debug ios`
+Deploy on device/simulator, run the app and stop at the first code statement | `$ ns debug ios --debug-brk [--device <Device ID>] [--no-client]`
+Deploy in the iOS simulator, run the app and stop at the first code statement | `$ ns debug ios --debug-brk --emulator [--no-client]`
+Attach the debug tools to a running app on specified device or simulator| `$ ns debug ios --start [--device <Device ID>] [--no-client]`
+Attach the debug tools to a running app in the iOS simulator | `$ ns debug ios --start --emulator [--no-client]`
+
+### Options
+
+* `--device` - Specifies a connected device or iOS simulator on which to run the app. `<Device ID>` is the device identifier of the target device as listed by the `$ ns device ios` command.
+* `--emulator` - Indicates that you want to debug your app in the iOS simulator.
+* `--debug-brk` - Prepares, builds and deploys the application package on a device or in a simulator, runs the app, launches the developer tools of your Safari browser and stops at the first code statement.
+* `--start` - Attaches the debug tools to a deployed and running app and launches the developer tools of your Safari browser.
+* `--no-client` - If set, the NativeScript CLI attaches the debug tools but does not launch the developer tools in Safari. Could be used on already started Safari Web Inspector.
+* `--timeout` - Sets the number of seconds that NativeScript CLI will wait to find the inspector socket port from device's logs. If not set, the default timeout is 10 seconds.
+* `--no-watch` - If set, changes in your code will not be reflected during the execution of this command.
+* `--clean` - If set, forces the complete rebuild of the native application.
+* `--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.
+* `--chrome` - Deprecated - default behavior uses '--chrome' implicitly. Allows debugging in Chrome Developer Tools. If set, Safari Web Inspector is not started and debugging is attached to Chrome Developer Tools.
+* `--inspector` - If set, the developer tools in the Safari Web Inspector are used for debugging the application.
+* `--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 `ns migrate`.
+
+<% } %>
+<% if(isHtml) { %>
+
+### Command Limitations
+
+* You can run `$ ns debug ios` only on macOS systems.
+* You must have Google Chrome installed on your machine.
+* If you want to debug in the iOS simulator, you must have the latest versions of Xcode installed on your machine.
+
+### Related Commands
+
+Command | Description
+----------|----------
+[build](build.html) | 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.
+[build ios](build-ios.html) | Builds the project for iOS and produces an APP or IPA that you can manually deploy in the iOS simulator or on device, respectively.
+[debug](debug.html) | Debugs your project on a connected device or in a native emulator.
+[debug android](debug-android.html) | Debugs your project on a connected Android device or in a native emulator.
+[deploy](deploy.html) | Builds and deploys the project to a connected physical or virtual device.
+[device](../../device/device.html) | Lists all connected devices/emulators.
+[device ios](../../device/device-ios.html) | Lists all connected devices/simulators for iOS.
+[run](run.html) | Runs your project on a connected device or in the native emulator for the selected platform.
+[run ios](run-ios.html) | Runs your project on a connected iOS device or in the iOS simulator, if configured.
+[test init](test-init.html) | Configures your project for unit testing with a selected framework.
+[test ios](test-ios.html) | Runs the tests in your project on iOS devices or the iOS simulator.
+<% } %>

package/docs/man_pages/project/testing/debug.md

@@ -0,0 +1,67 @@
+<% if (isJekyll) { %>---
+title: ns debug
+position: 6
+---<% } %>
+
+# ns debug
+
+### Description
+
+Initiates a debugging session for your project on a connected device or native emulator. <% if(isMacOS) { %>You must specify the target platform on which you want to debug.<% } %> When necessary, the command will prepare, build, deploy and launch the app before starting the debug session. While debugging, the output from the application is printed in the console and any changes made to your code are synchronized on all connected devices or running emulators.
+
+<% if(isHtml) { %>
+#### 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.
+
+When running this command with `--debug-brk` any file change will cause a restart of the native application (HMR is disabled). Changes in `App_Resources` and `node_modules/somePlugin/platforms` will cause a rebuild of the application.
+<% } %>
+
+### Commands
+
+Usage | Synopsis
+---|---
+<% if((isConsole && isMacOS) || isHtml) { %>General | `$ ns debug <Platform>`<% } %><% if(isConsole && (isLinux || isWindows)) { %>General | `$ ns debug android`<% } %>
+
+<% if((isConsole && isMacOS) || isHtml) { %>### Arguments
+`<Platform>` is the target mobile platform for which you want to debug your project. You can set the following target platforms:
+* `android` - Start a debugging session for your project on a connected Android device or Android emulator.
+* `ios` - Start a debugging session for your project on a connected iOS device or in the native iOS simulator.<% } %>
+
+<% if(isHtml) { %>
+
+### Command Limitations
+
+* You can run `$ ns debug ios` only on macOS systems.
+
+### Related Commands
+
+Command | Description
+----------|----------
+[build android](build-android.html) | Builds the project for Android and produces an APK that you can manually deploy on device or in the native emulator.
+[build ios](build-ios.html) | 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](build.html) | 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](debug-android.html) | Debugs your project on a connected Android device or in a native emulator.
+[debug ios](debug-ios.html) | Debugs your project on a connected iOS device or in a native emulator.
+[deploy](deploy.html) | Builds and deploys the project to a connected physical or virtual device.
+[run android](run-android.html) | Runs your project on a connected Android device or in a native Android emulator, if configured.
+[run ios](run-ios.html) | Runs your project on a connected iOS device or in the iOS Simulator, if configured.
+[run](run.html) | Runs your project on a connected device or in the native emulator for the selected platform.
+[test init](test-init.html) | Configures your project for unit testing with a selected framework.
+[test android](test-android.html) | Runs the tests in your project on Android devices or native emulators.
+[test ios](test-ios.html) | Runs the tests in your project on iOS devices or the iOS Simulator.
+<% } %>