React Native打包APK

React Native打包APK

用于个人以后参考：

• 生成一个签名密钥
• 设置gradle变量
• 添加签名到项目的gradle配置文件
• 启用Proguard代码混淆来缩小APK文件的大小（可选）
• 生成发行APK包
• 参考资料

---

生成一个签名密钥

你可以用keytool命令生成一个私有密钥。在Windows上keytool命令放在JDK的bin目录中（比如C:\Program Files\Java\jdkx.x.x_x\bin），你可能需要在命令行中先进入那个目录才能执行此命令。

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

这条命令会要求你输入密钥库（keystore）和对应密钥的密码，然后设置一些发行相关的信息。最后它会生成一个叫做my-release-key.keystore的密钥库文件。

在运行上面这条语句之后，密钥库里应该已经生成了一个单独的密钥，有效期为10000天。–alias参数后面的别名是你将来为应用签名时所需要用到的，所以记得记录这个别名。

注意：请记得妥善地保管好你的密钥库文件，不要上传到版本库或者其它的地方。

---

Markdown及扩展

1. 把my-release-key.keystore文件放到你工程中的android/app文件夹下。
2. 编辑~/.gradle/gradle.properties（没有这个文件你就创建一个），添加如下的代码（注意把其中的**替换为相应密码）
3. 编辑android/gradle.properties，同步骤[2]一样

注意：~表示用户目录，比如windows上可能是C:\Users\用户名，而mac上可能是/Users/用户

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

这些会作为全局的gradle变量，我们在后面的步骤中可以用来给应用签名。

关于密钥库的注意事项:

一旦你在Play Store发布了你的应用，如果想修改签名，就必须用一个不同的包名来重新发布你的应用（这样也会丢失所有的下载数和评分）。所以请务必备份好你的密钥库和密码。

提示：如果你不想以明文方式保存密码，同时你使用的是macOS系统，那么你也可以把密码保存到钥匙串（Keychain）中。这样一来你就可以省略掉上面配置中的后两行（即MYAPP_RELEASE_STORE_PASSWORD和MYAPP_RELEASE_KEY_PASSWORD）。

---

添加签名到项目的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
        }
    }
}

---

启用Proguard代码混淆来缩小APK文件的大小（可选）

Proguard是一个Java字节码混淆压缩工具，它可以移除掉React Native Java (和它的依赖库中)中没有被使用到的部分，最终有效的减少APK的大小。
重要：每次启用Proguard之后，必须再次全面地测试你的应用。Proguard有时候需要为你引入的每个原生库做一些额外的配置。参见app/proguard-rules.pro文件。

在android/app/build.gradle文件中（第4步的文件），找到enableProguardInReleaseBuilds

def enableProguardInReleaseBuilds = false

然后修改成：

def enableProguardInReleaseBuilds = true

要启用Proguard，设置minifyEnabled选项为true：

buildTypes {
　　release {
　　　　minifyEnabled true
　　　　...
　　}
}

---

生成发行APK包

只需在终端中运行以下命令：

$ cd android && ./gradlew assembleRelease

如果上面命令不可行，则运行下面这条命令：

$ cd android && gradlew assembleRelease

译注：cd android表示进入android目录（如果你已经在android目录中了那就不用输入了）。./gradlew assembleRelease在macOS、Linux或是windows的PowerShell环境中表示执行当前目录下的名为gradlew的脚本文件，且其运行参数为assembleRelease，注意这个./不可省略；而在windows的传统CMD命令行下则需要去掉./。

Gradle的assembleRelease参数会把所有用到的JavaScript代码都打包到一起，然后内置到APK包中。如果你想调整下这个行为（比如js代码以及静态资源打包的默认文件名或是目录结构等），可以看看android/app/build.gradle文件，然后琢磨下应该怎么修改以满足你的需求。

生成的APK文件位于android/app/build/outputs/apk/app-release.apk，它已经可以用来发布了。

---

参考资料

1. http://reactnative.cn/docs/0.46/signed-apk-android.html
2. https://github.com/reactnativecn/react-native.cn/blob/stable/docs/docs/0.46/signed-apk-android.md
3. http://www.jianshu.com/p/32a99c273be1
4. http://www.cnblogs.com/fancyallen/p/5715632.html

---