title: React Native 打包APK
tags: [Android, React Native]
categories: React Native
description:
React Native 打包APK
生成一個簽名密鑰
你可以用keytool命令生成一個私有密鑰。在Windows上keytool命令放在JDK的bin目錄中(比如C:\Program Files\Java\jdkx.x.x_x\bin),你可能需要在命令行中先進(jìn)入那個目錄才能執(zhí)行此命令。
keytool -genkey -v -keystore my-release-key.keystore -alias my-key-alias -keyalg RSA -keysize 2048 -validity 10000
這條命令會要求你輸入密鑰庫(keystore)和對應(yīng)密鑰的密碼,然后設(shè)置一些發(fā)行相關(guān)的信息。最后它會生成一個叫做my-release-key.keystore的密鑰庫文件。
在運(yùn)行上面這條語句之后,密鑰庫里應(yīng)該已經(jīng)生成了一個單獨(dú)的密鑰,有效期為10000天。--alias參數(shù)后面的別名是你將來為應(yīng)用簽名時所需要用到的,所以記得記錄這個別名。
注意: 請記得妥善地保管好你的密鑰庫文件,不要上傳到版本庫或者其它的地方。
設(shè)置gradle變量
- 把my-release-key.keystore文件放到你工程中的android/app文件夾下。
- 編輯~/.gradle/gradle.properties(沒有這個文件你就創(chuàng)建一個),添加如下的代碼(注意把其中的****替換為相應(yīng)密碼)
注意: ~表示用戶目錄,比如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變量,我們在后面的步驟中可以用來給應(yīng)用簽名。
關(guān)于密鑰庫的注意事項(xiàng):
一旦你在Play Store發(fā)布了你的應(yīng)用,如果想修改簽名,就必須用一個不同的包名來重新發(fā)布你的應(yīng)用(這樣也會丟失所有的下載數(shù)和評分)。所以請務(wù)必備份好你的密鑰庫和密碼。
提示:如果你不想以明文方式保存密碼,同時你使用的是macOS系統(tǒng),那么你也可以把密碼保存到鑰匙串(Keychain)中。這樣一來你就可以省略掉上面配置中的后兩行(即MYAPP_RELEASE_STORE_PASSWORD和MYAPP_RELEASE_KEY_PASSWORD)。
添加簽名到項(xiàng)目的gradle配置文件
編輯你項(xiàng)目目錄下的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
}
}
}
...
生成發(fā)行APK包
只需在終端中運(yùn)行以下命令:
cd android && ./gradlew assembleRelease
注意: cd android表示進(jìn)入android目錄(如果你已經(jīng)在android目錄中了那就不用輸入了)。./gradlew assembleRelease在macOS和Linux系統(tǒng)中表示執(zhí)行當(dāng)前目錄下的名為gradlew的腳本文件,運(yùn)行參數(shù)為assembleRelease,注意這個./不可省略;而在windows命令行下則需要去掉./。
Gradle的assembleRelease參數(shù)會把所有用到的JavaScript代碼都打包到一起,然后內(nèi)置到APK包中。如果你想調(diào)整下這個行為(比如js代碼以及靜態(tài)資源打包的默認(rèn)文件名或是目錄結(jié)構(gòu)等),可以看看android/app/build.gradle文件,然后琢磨下應(yīng)該怎么修改以滿足你的需求。
生成的APK文件位于android/app/build/outputs/apk/app-release.apk,它已經(jīng)可以用來發(fā)布了。
測試應(yīng)用的發(fā)行版本
在把發(fā)行版本提交到Play Store之前,你應(yīng)該做一次最終測試。輸入以下命令可以在設(shè)備上安裝發(fā)行版本:
cd android && ./gradlew installRelease
注意installRelease參數(shù)只能在你完成了上面的簽名配置之后才可以使用。 你現(xiàn)在可以關(guān)掉運(yùn)行中的packager了,因?yàn)槟闼械拇a和框架依賴已經(jīng)都被打包到apk包中,可以離線運(yùn)行了。
啟用Proguard代碼混淆來縮小APK文件的大小(可選)
Proguard是一個Java字節(jié)碼混淆壓縮工具,它可以移除掉React Native Java(和它的依賴庫中)中沒有被使用到的部分,最終有效的減少APK的大小。
重要:啟用Proguard之后,你必須再次全面地測試你的應(yīng)用。Proguard有時候需要為你引入的每個原生庫做一些額外的配置。參見app/proguard-rules.pro文件。
要啟用Proguard,設(shè)置minifyEnabled選項(xiàng)為true:
/**
* 在release發(fā)行版中啟用Proguard來減小 to shrink the Java bytecode in release builds.
*/
def enableProguardInReleaseBuilds = true