前言
- 什么是熱更新?熱更新就是動態(tài)下發(fā)代碼，它可以使開發(fā)者在不發(fā)布新版本的情況下，修復(fù) BUG 和發(fā)布功能.用戶毫無感知，還可以繞過某些應(yīng)用商店的長時間審核
- ionic實現(xiàn)熱更新的插件有好幾個,本文以微軟公司提供的熱更新插件(cordova-plugin-code-push)為例.
- 大公司提供的服務(wù)坑少,我在集成的過程中很順利,只是集成步驟比較多,各位只要認(rèn)真閱讀文檔都可以成功
- 蘋果App允許使用熱更新Apple's developer agreement, 為了不影響用戶體驗，規(guī)定必須使用靜默更新。 Google Play不能使用靜默更新，必須彈框告知用戶App有更新。中國的android市場必須采用靜默更新（如果彈框提示，App會被“請上傳最新版本的二進(jìn)制應(yīng)用包”原因駁回）。
- 還有另外一個熱更新的插件，但是已經(jīng)在2018.09.30宣布不再維護(hù)了，可以了解下(cordova-hot-code-push)
環(huán)境準(zhǔn)備
- 全局安裝 code-push-cli
npm install -g code-push-cli
注:code-push-cli是連接熱更新服務(wù)端的工具,我們把要更新的代碼上傳至服務(wù)端,客戶端(我們的app)安裝cordova-plugin-code-push插件來從服務(wù)端下載代碼.
登錄code-push服務(wù)端
- 使用code-push login命令會打開瀏覽器窗口讓我們登錄code-push服務(wù)端
-
我這里用github帳號登錄,你也可以使用其他帳號,登錄成功會返回一個權(quán)限token
4108891-9ac1998fa50993ea.png
-
復(fù)制token粘帖到命令行工具中,回車則會登錄成功
2019-01-07_09-41-01.png
使用code-push-cli在服務(wù)端創(chuàng)建應(yīng)用
- 使用命令code-push app add <appName> <os> <platform>創(chuàng)建應(yīng)用;前面說過我們要部署代碼到熱更新服務(wù)端;<appName>建議以app名稱加"_android"或"_ios"后綴,以防忘記
- 如下圖,給app在服務(wù)端分別創(chuàng)建了android和ios的cordova應(yīng)用.默認(rèn)為每個應(yīng)用生成兩種部署類型("Production"和"Staging"),我們就用這兩種類型分別代表生產(chǎn)環(huán)境和開發(fā)環(huán)境,請記下你生成的這四個key值,key是用來連接客戶端和服務(wù)端的
code-push app add test_ios ios cordova
code-push app add test_android android cordova
注:也可以在web端查看/管理app,傳送門
App環(huán)境準(zhǔn)備
- 進(jìn)入app目錄,安裝熱更新插件及插件依賴
cordova plugin add cordova-plugin-code-push
查看是否安裝白名單插件cordova plugin list,如果沒有安裝請安裝ionic cordova plugin add cordova-plugin-whitelist
在config.xml添加如下配置允許與CodePush服務(wù)器通信
<access origin="*" />
或者
<access origin="https://codepush.azurewebsites.net" />
<access origin="https://codepush.blob.core.windows.net" />
<access origin="https://codepushupdates.azureedge.net" />
App代碼準(zhǔn)備
- 在 config.xml 添加 deploymentkey，key和平臺是對應(yīng)的。
<platform name="android">
<preference name="CodePushDeploymentKey" value="YOUR-ANDROID-DEPLOYMENT-KEY" />
</platform>
<platform name="ios">
<preference name="CodePushDeploymentKey" value="YOUR-IOS-DEPLOYMENT-KEY" />
</platform>
- 添加后重新 build 項目。
cordova build
- 在app啟動的時候調(diào)用code-push同步方法
window.document.addEventListener('deviceready', function () {
console.log('deviceready')
window.codePush.sync(syncStatus, null, downloadProgress);
function syncStatus(status) {
switch (status) {
case SyncStatus.DOWNLOADING_PACKAGE:
// Show "downloading" modal
break;
case SyncStatus.INSTALLING_UPDATE:
// Hide "downloading" modal
break;
}
}
function downloadProgress(downloadProgress) {
if (downloadProgress) {
// Update "downloading" modal with current download %
console.log("Downloading " + downloadProgress.receivedBytes + " of " + downloadProgress.totalBytes);
}
}
})
發(fā)布更新
- 進(jìn)入項目的根目錄下，使用 code-push release-cordova <appName> <platform> 發(fā)布應(yīng)用
code-push release-cordova test_ios ios -m --description "ios code push"
code-push release-cordova test_android android -m --description "android code push"
注：每次向App Store提交新的版本時，也應(yīng)該基于該提交版本同時向code-push-server發(fā)布一個初始版本。(因為后面每次向code-push-server發(fā)布版本時，code-puse-server都會和初始版本比較，生成補(bǔ)丁版本)
- 使用命令code-push deployment list <appName>查看發(fā)布狀態(tài)
code-push常用命令
//給app在熱更新服務(wù)器上創(chuàng)建應(yīng)用
code-push app add <appName> <os> <platform>
//刪除應(yīng)用
code-push app rm <appName>
//查看熱更新服務(wù)器上有哪些應(yīng)用
code-push app list
//發(fā)布應(yīng)用
code-push release-cordova <appName> <platform> [options]
Options參數(shù):
--deploymentName, -d ..指定部署的類型.默認(rèn)"Staging",可以選擇"Production"或其他 自定義類型
--description, --des ..添加描述
--mandatory, -m .......指定此版本是否為強(qiáng)制更新版本
例1:發(fā)布更新
code-push release-cordova ionic2_tabs_android android --des ""
例2:部署"Production"狀態(tài)的更新,即生產(chǎn)環(huán)境的熱更新部署使用這句命令
code-push release-cordova ionic2_tabs_android android -d "Production" --des ""
注意:一般生產(chǎn)環(huán)境的app是壓縮過的,所以在發(fā)布正式環(huán)境熱更新之前,先執(zhí)行"ionic build --prod"壓縮代碼
例3:部署ios應(yīng)用的更新
code-push release-cordova ionic2_tabs_ios ios --des ""
例4:添加-m參數(shù)強(qiáng)制更新,code-push插件從服務(wù)端下載完代碼,會立即自動重啟app
code-push release-cordova ionic2_tabs_android android -m --des ""
//查看部署狀態(tài)
code-push deployment list <appName>
例1:
code-push deployment list ionic2_tabs_android
例2:查看部署狀態(tài)及key值,忘記key就這樣找
code-push deployment list ionic2_tabs_android -k
//清空部署記錄
code-push deployment clear <appName> <deploymentName>
如:清空Staging狀態(tài)的部署記錄
code-push deployment clear ionic2_tabs_android Staging
//添加部署狀態(tài),默認(rèn)只有"Staging"和"Production"兩中狀態(tài)
code-push deployment add <appName> [deploymentName]
//刪除自定義的部署狀態(tài)
code-push deployment rm <appName> <deploymentName>
