docs: docs about Android App Bundle #1423
Conversation
|
|
||
| For each of the architectures that you specify in your `webpack.config.js`, the plugin will produce a `snapshot.blob` file inside `assets/snapshots/${target_arch}/snapshot.blob`. Those files are **not** subject to Android App Bundle and you will find a corresponding `blob` for each architecture in the resulting .apks. This will increase the size of the resulting .apks. | ||
|
|
||
| If you want to take advantage of Android App Bundle you will need to instruct the `nativescript-dev-webpack` plugin to produce a `.so` snapshot. For this purpose you will need to have the Android NDK installed on your system. It is strongly recommended that the same version of the NDK is used to produce the snapshot file as the one used to compile the {N} runtime itself. Currently we use NDK r16b. |
There was a problem hiding this comment.
Maybe we need to state that snapshots cannot be generated on windows
Co-Authored-By: KristianDD <[email protected]>
Co-Authored-By: KristianDD <[email protected]>
| @@ -36,6 +36,8 @@ However if you want to improve the performance of your application with the `nat | |||
|
|
|||
| The default file format that the `nativescript-dev-webpack` plugin produce when you execute `tns build android --bundle --env.uglify --env.snapshot` is a `.blob` file. | |||
|
|
|||
| > Note: The snapshot generation feature is limited to macOS and Linux platforms due to inability to build `mksnapshot` tool running on Windows. Currently, the --env.snapshot flag is ignored on Windows. | |||
There was a problem hiding this comment.
(...) due to inability to build the mksnapshot tool when running on Windows. (...)
| --- | ||
|
|
||
| # Android App Bundle | ||
| Android App Bundle is a new publishing format which makes it easier to reduce the size of application download from Google Play Store, without uploading multiple `.apk` files. |
There was a problem hiding this comment.
I would recommend going for something more descriptive here. For example, the Android developer docs have a lot of information on this subject https://developer.android.com/guide/app-bundle/. You can use something like this:
"An Android App Bundle is a new publishing format that contains all the compiled code and resources of your app, but leaves the actual APK generation and signing to Google Play. The store then uses the app bundle to generate and serve optimized APKs based on the device configuration of the specific user. In general, the benefit of using Android App Bundles is that you no longer have to build, sign, and manage multiple APKs to support different devices, and users get smaller, more optimized downloads. For more information about the Android App Bundle, see the About Android App Bundles article in the official Android Developer documentation"
Alternatively, you can add only the last sentence, so that people who would like to learn more can go there and read the article :)
| Android App Bundle is a new publishing format which makes it easier to reduce the size of application download from Google Play Store, without uploading multiple `.apk` files. | ||
|
|
||
| ## Available configurations | ||
| By default 'arm64-v8a' CPU architecture is excluded from the build of NativeScript application. The following configuration will enable it, but there is a chance that on older devices with this architecture this might affect the startup times. |
There was a problem hiding this comment.
Missing comma after By default:
By default, the arm-v8a CPU architecture is (...)
| ``` | ||
|
|
||
| ## Additional optimizations | ||
| If you want to improve the performance of your application with the `nativescript-dev-webpack` plugin you might want to make some additional changes. |
There was a problem hiding this comment.
If I understand this sentence correctly, you should use need to or should instead of might want to. And a comma is missing before you:
(...) application with the nativescript-dev-webpack plugin, you might want to should make some additional changes. (...)
|
|
||
| The default file format that the `nativescript-dev-webpack` plugin produces when you execute `tns build android --bundle --env.uglify --env.snapshot --aab` is a `.blob` file. | ||
|
|
||
| > Note: The snapshot generation feature is limited to macOS and Linux platforms due to inability to build `mksnapshot` tool running on Windows. Currently, the --env.snapshot flag is ignored on Windows. |
There was a problem hiding this comment.
(...) due to inability to build the mksnapshot tool when running on Windows. (...)
|
|
||
| For each of the architectures that you specify in your `webpack.config.js`, the plugin will produce a `snapshot.blob` file inside `assets/snapshots/${target_arch}/snapshot.blob`. Those files are **not** subject to Android App Bundle and you will find a corresponding `blob` for each architecture in the resulting `.apks`. This will increase the size of the resulting `.apks`. | ||
|
|
||
| If you want to take advantage of Android App Bundle you will need to instruct the `nativescript-dev-webpack` plugin to produce a `.so` snapshot. For this purpose you will need to have the Android NDK installed on your system. It is strongly recommended that the same version of the NDK is used to produce the snapshot file as the one used to compile the {N} runtime itself. Currently we use NDK r16b. |
There was a problem hiding this comment.
Missing comma before you:
(...) For this purpose, you will need to instruct (...)
|
This thread has been automatically locked since there has not been any recent activity after it was closed. Please open a new issue for related bugs. |
PR Checklist
What is the current state of the documentation article?
There is no documentation about Android App Bundle
What is the new state of the documentation article?
There is an article about Android App Bundle
Describes NativeScript/nativescript-cli#4068