diff --git a/docs/man_pages/project/testing/build-android.md b/docs/man_pages/project/testing/build-android.md index ad054ea51f..5b9660298f 100644 --- a/docs/man_pages/project/testing/build-android.md +++ b/docs/man_pages/project/testing/build-android.md @@ -25,12 +25,13 @@ General | `$ tns build android [--compileSdk ] [--key-store-path ] [- * `--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. May be passed multiple times. Supported additional flags: +* `--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 [Snapshot](https://docs.nativescript.org/performance-optimizations/bundling-with-webpack#v8-heap-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 `report` folder in the root folder. - * `--env.sourceMap` - creates inline source maps (useful for debbuging bundled app). + * `--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 `tns migrate`. diff --git a/docs/man_pages/project/testing/build.md b/docs/man_pages/project/testing/build.md index eada1e13b0..c383453994 100644 --- a/docs/man_pages/project/testing/build.md +++ b/docs/man_pages/project/testing/build.md @@ -32,13 +32,15 @@ Usage | Synopsis * `--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. `` is the index or `Device Identifier` of the target device as listed by the `$ tns device --available-devices` command. * `--hmr` - Enables the hot module replacement (HMR) feature. -* `--env.*` - Specifies additional flags that the bundler may process. May be passed multiple times. Supported additional flags: +* `--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 [Snapshot](https://docs.nativescript.org/performance-optimizations/bundling-with-webpack#v8-heap-snapshot) (only for release builds on Mac OS & for Android). + * `--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 (useful for debbuging bundled app). + * `--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`. <% if(isHtml) { %> diff --git a/docs/man_pages/project/testing/debug-android.md b/docs/man_pages/project/testing/debug-android.md index 5aeae09a3d..74e87a451b 100644 --- a/docs/man_pages/project/testing/debug-android.md +++ b/docs/man_pages/project/testing/debug-android.md @@ -13,11 +13,11 @@ Initiates a debugging session for your project on a connected Android device or Usage | Synopsis ---|--- -Deploy on device/emulator, run the app and generate a Chrome DevTools link for debugging | `$ tns debug android` -Deploy on device/emulator, run the app and stop at the first code statement | `$ tns debug android --debug-brk [--device ] [--timeout ]` -Deploy in the native emulator, run the app and stop at the first code statement | `$ tns debug android --debug-brk --emulator [--timeout ]` -Attach the debug tools to a running app on device/emulator | `$ tns debug android --start [--device ] [--timeout ]` -Attach the debug tools to a running app in the native emulator | `$ tns debug android --start --emulator [--timeout ]` +Deploy on device/emulator, run the app and generate a Chrome DevTools link for debugging | `$ tns debug android [--device ] [--timeout ] [--aab]` +Deploy on device/emulator, run the app and stop at the first code statement | `$ tns debug android --debug-brk [--device ] [--timeout ] [--aab]` +Deploy in the native emulator, run the app and stop at the first code statement | `$ tns debug android --debug-brk --emulator [--timeout ] [--aab]` +Attach the debug tools to a running app on device/emulator | `$ tns debug android --start [--device ] [--timeout ] [--aab]` +Attach the debug tools to a running app in the native emulator | `$ tns debug android --start --emulator [--timeout ] [--aab]` ### Options @@ -29,6 +29,15 @@ Attach the debug tools to a running app in the native emulator | `$ tns debug an * `--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 `tns migrate`. <% if(isHtml) { %> diff --git a/docs/man_pages/project/testing/deploy.md b/docs/man_pages/project/testing/deploy.md index 127727e56e..477dc89e56 100644 --- a/docs/man_pages/project/testing/deploy.md +++ b/docs/man_pages/project/testing/deploy.md @@ -16,7 +16,7 @@ Prepares, builds and deploys the project to a connected device or native emulato Usage | Synopsis ---|--- -Deploy on Android | `$ tns deploy android [--device ] [--key-store-path --key-store-password --key-store-alias --key-store-alias-password ] [--release]` +Deploy on Android | `$ tns deploy android [--device ] [--key-store-path --key-store-password --key-store-alias --key-store-alias-password ] [--release] [--aab]` <% if(isMacOS) { %>Deploy on iOS | `$ tns deploy ios [--device ] [--release]`<% } %> ### Options for iOS @@ -33,6 +33,16 @@ Deploy on Android | `$ tns deploy android [--device ] [--key-store-pa * `--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. +* `--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 `tns migrate`. <% if(isHtml) { %> diff --git a/docs/man_pages/project/testing/run-android.md b/docs/man_pages/project/testing/run-android.md index 7572159672..d2fcf975f2 100644 --- a/docs/man_pages/project/testing/run-android.md +++ b/docs/man_pages/project/testing/run-android.md @@ -17,9 +17,9 @@ When running this command without passing `--release` flag, the HMR (Hot Module Usage | Synopsis ---|--- -Run on all connected devices and running emulators | `$ tns run android [--key-store-path --key-store-password --key-store-alias --key-store-alias-password ] [--release] [--justlaunch] [--env.*]]` -Run on a selected connected device or running emulator. Will start emulator with specified `Device Identifier`, if not already running. | `$ tns run android --device [--key-store-path --key-store-password --key-store-alias --key-store-alias-password ] [--release] [--justlaunch] [--env.*]]` -Start a default emulator if none are running, or run application on all connected emulators. | `$ tns run android --emulator [--key-store-path --key-store-password --key-store-alias --key-store-alias-password ] [--release] [--justlaunch] [--env.*]]` +Run on all connected devices and running emulators | `$ tns run android [--key-store-path --key-store-password --key-store-alias --key-store-alias-password ] [--release] [--justlaunch] [--env.*]] [--aab]` +Run on a selected connected device or running emulator. Will start emulator with specified `Device Identifier`, if not already running. | `$ tns run android --device [--key-store-path --key-store-password --key-store-alias --key-store-alias-password ] [--release] [--justlaunch] [--env.*]] [--aab]` +Start a default emulator if none are running, or run application on all connected emulators. | `$ tns run android --emulator [--key-store-path --key-store-password --key-store-alias --key-store-alias-password ] [--release] [--justlaunch] [--env.*]] [--aab]` ### Options @@ -34,13 +34,15 @@ Start a default emulator if none are running, or run application on all connecte * `--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. * `--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. May be passed multiple times. +* `--env.*` - Specifies additional flags that the bundler may process. Can be passed multiple times. * `--env.aot` - creates Ahead-Of-Time build (Angular only). - * `--env.snapshot`- creates [Snapshot](https://docs.nativescript.org/performance-optimizations/bundling-with-webpack#v8-heap-snapshot) (only for release builds on Mac OS & for Android). + * `--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 (useful for debbuging bundled app). + * `--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`. <% if(isHtml) { %> diff --git a/docs/man_pages/project/testing/run-ios.md b/docs/man_pages/project/testing/run-ios.md index 343c0e7395..b1ac6bc916 100644 --- a/docs/man_pages/project/testing/run-ios.md +++ b/docs/man_pages/project/testing/run-ios.md @@ -37,12 +37,11 @@ Start an emulator with specified device identifier and sdk | `$ tns run ios [--d * `--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 by running webpack in production mode and native build in release mode. Otherwise, produces a debug build. * `--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. May be passed multiple times. +* `--env.*` - Specifies additional flags that the bundler may process. Can be passed multiple times. * `--env.aot` - creates Ahead-Of-Time build (Angular only). - * `--env.snapshot`- creates [Snapshot](https://docs.nativescript.org/performance-optimizations/bundling-with-webpack#v8-heap-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 `report` folder in the root folder. - * `--env.sourceMap` - creates inline source maps (useful for debbuging bundled app). + * `--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 `tns migrate`. diff --git a/docs/man_pages/project/testing/run.md b/docs/man_pages/project/testing/run.md index 87e87ea5eb..cc3b5ee173 100644 --- a/docs/man_pages/project/testing/run.md +++ b/docs/man_pages/project/testing/run.md @@ -45,13 +45,15 @@ Run on a selected connected device or running emulator. Will start emulator with * `--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. `` is the index or `Device Identifier` of the target device as listed by the `$ tns device --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. May be passed multiple times. Supported additional flags: +* `--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 [Snapshot](https://docs.nativescript.org/performance-optimizations/bundling-with-webpack#v8-heap-snapshot) (only for release builds on Mac OS & for Android). + * `--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 (useful for debbuging bundled app). + * `--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`. diff --git a/docs/man_pages/project/testing/test-android.md b/docs/man_pages/project/testing/test-android.md index 2c5e984959..482676f942 100644 --- a/docs/man_pages/project/testing/test-android.md +++ b/docs/man_pages/project/testing/test-android.md @@ -13,14 +13,20 @@ Runs the tests in your project on connected Android devices and Android emulator Usage | Synopsis ------|------- -Run tests on all connected devices | `$ tns test android [--watch] [--debug-brk]` -Run tests on a selected device | `$ tns test android --device [--watch] [--debug-brk]` +Run tests on all connected devices | `$ tns test android [--watch] [--debug-brk] [--aab]` +Run tests on a selected device | `$ tns test android --device [--watch] [--debug-brk] [--aab]` ### Options * `--watch` - If set, when you save changes to the project, changes are automatically synchronized to the connected device and tests are re-run. * `--device` - Specifies the serial number or the index of the connected device on which to run the tests. To list all connected devices, grouped by platform, run `$ tns device`. `` is the device index or identifier as listed by the `$ tns device` command. * `--debug-brk` - Runs the tests under the debugger. The debugger will break just before your tests are executed, so you have a chance to place breakpoints. +* `--env.*` - Specifies additional flags that the bundler may process. Can be passed multiple times. Supported additional flags: + * `--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`. <% if(isHtml) { %>