title: React Native 打包APK
tags: [Android, React Native]
categories: React Native
description:
React Native 打包APK
生成一個(gè)簽名密鑰
你可以用keytool命令生成一個(gè)私有密鑰片排。在Windows上keytool命令放在JDK的bin目錄中(比如C:\Program Files\Java\jdkx.x.x_x\bin)纺座,你可能需要在命令行中先進(jìn)入那個(gè)目錄才能執(zhí)行此命令。
keytool -genkey -v -keystore my-release-key.keystore -alias my-key-alias -keyalg RSA -keysize 2048 -validity 10000
這條命令會(huì)要求你輸入密鑰庫(kù)(keystore)和對(duì)應(yīng)密鑰的密碼艳悔,然后設(shè)置一些發(fā)行相關(guān)的信息。最后它會(huì)生成一個(gè)叫做my-release-key.keystore的密鑰庫(kù)文件讥电。
在運(yùn)行上面這條語(yǔ)句之后登夫,密鑰庫(kù)里應(yīng)該已經(jīng)生成了一個(gè)單獨(dú)的密鑰,有效期為10000天允趟。--alias參數(shù)后面的別名是你將來(lái)為應(yīng)用簽名時(shí)所需要用到的,所以記得記錄這個(gè)別名鸦致。
注意: 請(qǐng)記得妥善地保管好你的密鑰庫(kù)文件潮剪,不要上傳到版本庫(kù)或者其它的地方。
設(shè)置gradle變量
- 把my-release-key.keystore文件放到你工程中的android/app文件夾下分唾。
- 編輯~/.gradle/gradle.properties(沒(méi)有這個(gè)文件你就創(chuàng)建一個(gè))抗碰,添加如下的代碼(注意把其中的****替換為相應(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=*****
上面的這些會(huì)作為全局的gradle變量,我們?cè)诤竺娴牟襟E中可以用來(lái)給應(yīng)用簽名折砸。
關(guān)于密鑰庫(kù)的注意事項(xiàng):
一旦你在Play Store發(fā)布了你的應(yīng)用看疗,如果想修改簽名,就必須用一個(gè)不同的包名來(lái)重新發(fā)布你的應(yīng)用(這樣也會(huì)丟失所有的下載數(shù)和評(píng)分)睦授。所以請(qǐng)務(wù)必備份好你的密鑰庫(kù)和密碼两芳。
提示:如果你不想以明文方式保存密碼,同時(shí)你使用的是macOS系統(tǒng)去枷,那么你也可以把密碼保存到鑰匙串(Keychain)中怖辆。這樣一來(lái)你就可以省略掉上面配置中的后兩行(即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逗余,注意這個(gè)./不可省略特咆;而在windows命令行下則需要去掉./。
Gradle的assembleRelease參數(shù)會(huì)把所有用到的JavaScript代碼都打包到一起猎荠,然后內(nèi)置到APK包中坚弱。如果你想調(diào)整下這個(gè)行為(比如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)可以用來(lái)發(fā)布了输虱。
測(cè)試應(yīng)用的發(fā)行版本
在把發(fā)行版本提交到Play Store之前些楣,你應(yīng)該做一次最終測(cè)試。輸入以下命令可以在設(shè)備上安裝發(fā)行版本:
cd android && ./gradlew installRelease
注意installRelease參數(shù)只能在你完成了上面的簽名配置之后才可以使用。 你現(xiàn)在可以關(guān)掉運(yùn)行中的packager了愁茁,因?yàn)槟闼械拇a和框架依賴已經(jīng)都被打包到apk包中蚕钦,可以離線運(yùn)行了。
啟用Proguard代碼混淆來(lái)縮小APK文件的大卸旌堋(可選)
Proguard是一個(gè)Java字節(jié)碼混淆壓縮工具嘶居,它可以移除掉React Native Java(和它的依賴庫(kù)中)中沒(méi)有被使用到的部分,最終有效的減少APK的大小促煮。
重要:?jiǎn)⒂肞roguard之后邮屁,你必須再次全面地測(cè)試你的應(yīng)用。Proguard有時(shí)候需要為你引入的每個(gè)原生庫(kù)做一些額外的配置菠齿。參見(jiàn)app/proguard-rules.pro文件佑吝。
要啟用Proguard,設(shè)置minifyEnabled選項(xiàng)為true:
/**
* 在release發(fā)行版中啟用Proguard來(lái)減小 to shrink the Java bytecode in release builds.
*/
def enableProguardInReleaseBuilds = true