Permalink
Browse files

Documentation about ABI split in Android Release

Summary:
It leads to a reduction of 5-7MB for an app, which is a considerable saving when it comes to emerging markets. Also, I had written a [comment](#5037 (comment)) on an issue which seems to have helped at least 26 people.
Closes #16197

Differential Revision: D5978945

Pulled By: TheSavior

fbshipit-source-id: 391a992e2d8e62e59fb20e5d5f8e5f59c00b6295
  • Loading branch information...
SuhairZain authored and facebook-github-bot committed Oct 4, 2017
1 parent 0c234c9 commit d0260b4f35f74a77d7f0d80d1e1b03233b92e978
Showing with 17 additions and 0 deletions.
  1. +17 −0 docs/SignedAPKAndroid.md
View
@@ -97,6 +97,23 @@ Note that `--variant=release` is only available if you've set up signing as desc
You can kill any running packager instances, all your framework and JavaScript code is bundled in the APK's assets.
### Split APKs by ABI to reduce file size
By default, the generated APK has the native code for both x86 and ARMv7a CPU architectures. This makes it easier to share APKs that run on almost all Android devices. However, this has the downside that there will be some unused native code on any device, leading to unnecessarily bigger APKs.
You can create an APK for each CPU by changing the following line in android/app/build.gradle:
``` diff
- def enableSeparateBuildPerCPUArchitecture = false
+ def enableSeparateBuildPerCPUArchitecture = true
```
Upload both these files to markets which support device targetting, such as [Google Play](https://developer.android.com/google/play/publishing/multiple-apks.html) and [Amazon AppStore](https://developer.amazon.com/docs/app-submission/getting-started-with-device-targeting.html) and the users will automatically get the appropriate APK. If you want to upload to other markets such as [APKFiles](https://www.apkfiles.com/), which do not support multiple APKs for a single app, change the following line as well to create the default universal APK with binaries for both CPUs.
``` diff
- universalApk false // If true, also generate a universal APK
+ universalApk true // If true, also generate a universal APK
```
### Enabling Proguard to reduce the size of the APK (optional)
Proguard is a tool that can slightly reduce the size of the APK. It does this by stripping parts of the React Native Java bytecode (and its dependencies) that your app is not using.

0 comments on commit d0260b4

Please sign in to comment.