React Native for Android 发布独立的安装包

Posted 2022-12-14 YongHui_Luo

翻译地址 ：
https://facebook.github.io/react-native/docs/signed-apk-android.html#content

官方发布的生成签名APK的方法，出于对React Native的热爱，对此篇内容进行了翻译，在翻译的过程中会添加一些自己的理解，生成签名APK是使用React Native开发线上应用，必不可少的步骤。

如果你想发布自己的应该到各种市场或渠道，你需要生成一个被签名的release APK，在android Developers 文档中Signing Your Application 这个主题有详细的描述。这个主题中涉及到了一小部分的签名应用的内容，同时罗列了需要打包javascript bundle的步骤。

生成一个签名秘钥

使用keytool生成一个私有的签名秘钥

$ keytool -genkey -v -keystore my-release-key.keystore -alias my-key-alias -keyalg RSA -keysize 2048 -validity 10000

命令会提示你给keystore和key设置密码，并提供专有名称字段的Key。最后会生成名字为my-release-key.keystore的keystore。

生成的keystore包含一个单独的key，有效期是10000天。要注意记住这个别名，稍后会使用这个别名来签名你的app。

切记：保持你的秘钥文件私有，不要提交到版本控制里。

设置全局gradle参数

1. 把 my-release-key.keystore 文件复制到你项目的 android/app目录下。
2. 编辑 ~/.gradle/gradle.properties文件，添加下面代码（使用秘钥密码 keystore password，别名 alias，key password替换** 部分）

MYAPP_RELEASE_STORE_FILE=my-release-key.keystore
MYAPP_RELEASE_KEY_ALIAS=my-key-alias
MYAPP_RELEASE_STORE_PASSWORD=*****
MYAPP_RELEASE_KEY_PASSWORD=*****

这些都是我们在签名时即将用到的全局变量。

切记： 一旦你在应用商店发布了应用，如果你想更改签名秘钥的话，就需要更改包名重新发布应用，这将会失去所有的下载量和点击率。所有备份好你的秘钥并且不要忘记密码。

在app目录下的的gradle配置中添加签名配置

编辑项目文件夹下 android/app/build.gradle文件，增加签名配置。

...
android 
    ...
    defaultConfig  ... 
    signingConfigs 
        release 
            storeFile file(MYAPP_RELEASE_STORE_FILE)
            storePassword MYAPP_RELEASE_STORE_PASSWORD
            keyAlias MYAPP_RELEASE_KEY_ALIAS
            keyPassword MYAPP_RELEASE_KEY_PASSWORD
        
    
    buildTypes 
        release 
            ...
            signingConfig signingConfigs.release
        
    

...

生成release Apk
在终端上运行下面的命令

$ cd android && ./gradlew assembleRelease

Gradle的 assembleRelease 能够将运行你的app所需要的所有JavaScript绑定到Apk中，如果你想改变JavaScript或者drawable资源被捆绑的方式，你可以查看 android/app/build.gradle 文件，了解如何改变以及如何体现这些改变。

注： gradlew命令在使用时，必须添加./，否则有可能遇到command not found: gradlew问题，因为gradlew不属于全局命令，添加./表示当前目录。

打包好的Apk在 android/app/build/outputs/apk/app-release.apk目录下。

测试生成的Apk安装包
在向应用商店发布项目之前，要确定测试通过。使用下面的命令将生成的apk安装到设备上。

$ cd android && ./gradlew installRelease

切记： installRelease 命令只有在你按上面描述的签名步骤，签名之后才可用。否则安装失败。

使用混淆减小Apk的大小（可选）
混淆是一个能够直接减小安装包大小的工具。他能够剔除那些在你的app中没有使用到的Java字节码。
重点 ： 如果你已经使用了混淆，确保他通过测试，混淆经常需要为你正在使用的library做特殊的配置，参照 app/proguard-rules.pro。

设置能够混淆，编辑 android/app/build.gradle:

/**
 * Run Proguard to shrink the Java bytecode in release builds.
 */
def enableProguardInReleaseBuilds = true

个人在生成可发布Apk的总结

1） 没有找到~/.gradle/gradle.properties 目录下的 gradle.properties文件，另外签名秘钥的设置只在一个地方使用，并不需要设置全局变量。所以我的代码如下：

android 
    compileSdkVersion 23
    buildToolsVersion "23.0.1"

    signingConfigs
           release 
             storeFile file('tiny-release-key.keystore')
             storePassword '201604'
             keyAlias 'tiny-key-alias'
             keyPassword '2016-2020'

           
    
    ...
 

2) 打包成功会解压包目录为

在assets文件夹下有 index.android.bundle 文件，这里就是我的项目需要的所有Js代码。