简介

Android要求所有应用都有一个数字签名才会被允许安装在用户手机上，所以在把应用发布到类似Google Play store这样的应用市场之前，你需要先生成一个签名的APK包。Android开发者官网上的如何给你的应用签名文档描述了签名的细节。本指南旨在提供一个简化的签名和打包APK的操作步骤，不会涉及太多理论。

生成一个签名密钥

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

  1. $ 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参数后面的别名是你将来为应用签名时所需要用到的，所以记得记录这个别名。

  1. 查看keystore参数信息：keytool -list -v -keystore my-release-key.keystore

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

设置gradle变量

  1. 把my-release-key.keystore文件放到你工程中的android/app文件夹下。
  2. 编辑用户目下的~/.gradle/gradle.properties或者是RN项目中下的android/gradle.properties文件，添加如下的代码（注意把其中的****替换为相应密码）

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

  1. MYAPP_RELEASE_STORE_FILE=my-release-key.keystore
  2. MYAPP_RELEASE_KEY_ALIAS=my-key-alias
  3. MYAPP_RELEASE_STORE_PASSWORD=*****
  4. MYAPP_RELEASE_KEY_PASSWORD=*****

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

关于密钥库的注意事项:

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

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

添加签名到项目的gradle配置文件

编辑你项目目录下的android/app/build.gradle，添加如下的签名配置：

  1. ...
  2. android {
  3.     ...
  4.     defaultConfig { ... }
  5.     signingConfigs {
  6.         release {
  7.             storeFile file(MYAPP_RELEASE_STORE_FILE)
  8.             storePassword MYAPP_RELEASE_STORE_PASSWORD
  9.             keyAlias MYAPP_RELEASE_KEY_ALIAS
  10.             keyPassword MYAPP_RELEASE_KEY_PASSWORD
  11.         }
  12.     }
  13.     buildTypes {
  14.         release {
  15.             ...
  16.             signingConfig signingConfigs.release
  17.         }
  18.     }
  19. }
  20. ...

生成发行APK包

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

  1. $ 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，它已经可以用来发布了。

测试应用的发行版本

在把发行版本提交到Play Store之前，你应该做一次最终测试。输入以下命令可以在设备上安装发行版本：

  1. $ cd android && ./gradlew installRelease

注意installRelease参数只能在你完成了上面的签名配置之后才可以使用。你现在可以关掉运行中的packager了，因为你所有的代码和框架依赖已经都被打包到apk包中，可以离线运行了。

在debug和release版本间来回切换安装时可能会报错签名不匹配，此时需要先卸载前一个版本再尝试安装。

针对设备不同的CPU架构生成APK以减小APK文件的大小

默认情况下，生成的APK会同时包含针对于x86和ARMv7aCPU架构的原生代码。 这样可以让我们更方便的向其他人分享这个APK，因为它几乎可以运行在所有的Android设备上。 但是，这有一个缺点，首先是APK文件更大，其次任何设备上都会有一些未使用的代码。

你可以在android/app/build.gradle:修改如下代码来打包生成针对不同CPU架构的APK

  1. - def enableSeparateBuildPerCPUArchitecture = false
  2. + def enableSeparateBuildPerCPUArchitecture = true

你可以把这上面打包生成的两个APK都上传到支持对用户设备CPU架构定位的应用程序商店，例如Google Play和Amazon AppStore，用户将自动获得相应的APK。如果您想上传到其他市场，例如APKFiles（不支持一个应用有多个APK文件），可以修改下面的代码，来生成适用不同CPU架构的通用APK。

  1. - universalApk false  
  2. + universalApk true  // 设置为true的时候会再生成一个通用APK

启用Proguard来减小APK文件的大小（可选）

Proguard是一个减小APK的大小的工具，它通过移除掉React Native Java字节码文件（和它的依赖库中）中没有被使用到的部分，最终有效的减少APK的大小。

重要：启用Proguard之后，你必须再次全面地测试你的应用。Proguard有时候需要为你引入的每个原生库做一些额外的配置。参见app/proguard-rules.pro文件。

在android/app/build.gradle文件中修改如下代码来启用Proguard

  1. - def enableProguardInReleaseBuilds = false 
  2. + def enableProguardInReleaseBuilds = true

启动Proguard后需清空缓存，否则可能会报错：

  1. cd android && ./gradlew.bat clean