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),你可能需要在命令行中先進入那個目錄才能執行此命令。
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參數后面的別名是你將來為應用簽名時所需要用到的,所以記得記錄這個別名。
注意: 請記得妥善地保管好你的密鑰庫文件,不要上傳到版本庫或者其它的地方。
設置gradle變量
- 把my-release-key.keystore文件放到你工程中的android/app文件夾下。
- 編輯~/.gradle/gradle.properties(沒有這個文件你就創建一個),添加如下的代碼(注意把其中的****替換為相應密碼)
注意: ~表示用戶目錄,比如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
}
}
}
...
生成發行APK包
只需在終端中運行以下命令:
cd android && ./gradlew assembleRelease
注意: cd android表示進入android目錄(如果你已經在android目錄中了那就不用輸入了)。./gradlew assembleRelease在macOS和Linux系統中表示執行當前目錄下的名為gradlew的腳本文件,運行參數為assembleRelease,注意這個./不可省略;而在windows命令行下則需要去掉./。
Gradle的assembleRelease參數會把所有用到的JavaScript代碼都打包到一起,然后內置到APK包中。如果你想調整下這個行為(比如js代碼以及靜態資源打包的默認文件名或是目錄結構等),可以看看android/app/build.gradle文件,然后琢磨下應該怎么修改以滿足你的需求。
生成的APK文件位于android/app/build/outputs/apk/app-release.apk,它已經可以用來發布了。
測試應用的發行版本
在把發行版本提交到Play Store之前,你應該做一次最終測試。輸入以下命令可以在設備上安裝發行版本:
cd android && ./gradlew installRelease
注意installRelease參數只能在你完成了上面的簽名配置之后才可以使用。 你現在可以關掉運行中的packager了,因為你所有的代碼和框架依賴已經都被打包到apk包中,可以離線運行了。
啟用Proguard代碼混淆來縮小APK文件的大小(可選)
Proguard是一個Java字節碼混淆壓縮工具,它可以移除掉React Native Java(和它的依賴庫中)中沒有被使用到的部分,最終有效的減少APK的大小。
重要:啟用Proguard之后,你必須再次全面地測試你的應用。Proguard有時候需要為你引入的每個原生庫做一些額外的配置。參見app/proguard-rules.pro文件。
要啟用Proguard,設置minifyEnabled選項為true:
/**
* 在release發行版中啟用Proguard來減小 to shrink the Java bytecode in release builds.
*/
def enableProguardInReleaseBuilds = true