移动端APP应用版本升级更新方案:整包更新及资源在线升级(热更新)
App端的升級(jí),又分為整包更新和資源熱更新兩種:
1、整包更新,即常規(guī)的整個(gè)App安裝包重新下載安裝。
2、資源熱更新,即App不重新安裝,里面的js等前端代碼進(jìn)行更新。
一、整包更新方案
1、IOS更新
一般iOS Appstore的安裝包,無法直接更新。App啟動(dòng)后檢查有新版本,只能跳轉(zhuǎn)到Appstore,然后用戶在Appstore的詳情頁點(diǎn)擊更新按鈕。
2、Android更新
而Android App,可以直接下載新的apk,只要包名和證書不變,就可以覆蓋安裝。
注意:
(1)App的升級(jí)檢測代碼必須使用條件編譯,否則在非App環(huán)境由于不存在plus相關(guān)API,將會(huì)報(bào)錯(cuò)。
(2)升級(jí)地址URL,如果是自行托管的App,就提供自己的包地址。如果是打開應(yīng)用市場,那URL如下:
if (plus.os.name=="Android") {
appurl = "market://details?id=io.dcloud.hellouniapp";
//這個(gè)是通用應(yīng)用市場,如果想指定某個(gè)應(yīng)用商店,需要單獨(dú)查這個(gè)應(yīng)用商店的包名或scheme及參數(shù)
} else {
appurl = "itms-apps://itunes.apple.com/cn/app/hello-uni-app/id1417078253";
}
(3)版本檢測需要打包app,真機(jī)運(yùn)行基座無法測試。因?yàn)檎鏅C(jī)運(yùn)行的plus.runtime.version是固定值。
關(guān)于升級(jí),比較省事的就是跳轉(zhuǎn)到瀏覽器下載apk包,下載完成之后安裝。另外可以在應(yīng)用內(nèi)下載,下載完成之后調(diào)用plus.runtime.install安裝。具體代碼如下:
// 在index.vue 中的onload方法里面或者app.vue中的onLaunch中添加如下部分:
update() {
var _this = this;
uni.request({
url: `${this.$store.state.apiBaseUrl}/users/versions`, //請(qǐng)求接口
method: 'POST',
success: result => {
if (result.data.code == 1) {
plus.runtime.getProperty(plus.runtime.appid, function(inf) {
if(inf.version != result.data.data.versions){
uni.showModal({
title: "發(fā)現(xiàn)新版本",
content: "確認(rèn)下載更新",
success: (res) => {
if (res.confirm == true) {//當(dāng)用戶確定更新,執(zhí)行更新
_this.doUpData();
}
}
})
}
});
}
},
})
},
doUpData() {
uni.showLoading({
title: '更新中……'
})
uni.downloadFile({//執(zhí)行下載
url: '***', //下載地址
success: downloadResult => {//下載成功
uni.hideLoading();
if (downloadResult.statusCode == 200) {
uni.showModal({
title: '',
content: '更新成功,確定現(xiàn)在重啟嗎?',
confirmText: '重啟',
confirmColor: '#EE8F57',
success: function(res) {
if (res.confirm == true) {
plus.runtime.install(//安裝
downloadResult.tempFilePath, {
force: true
},
function(res) {
utils.showToast('更新成功,重啟中');
plus.runtime.restart();
}
);
}
}
});
}
}
});
}
二、資源在線升級(jí)(熱更新)
HBuilderX 1.6.5 起,uni-app 支持生成 App 資源升級(jí)包。
1、生成 App 資源升級(jí)包
(1)修改版本號(hào):
首先,更新 manifest.json 中的版本號(hào)。比如之前是 1.0.0,那么新版本應(yīng)該是 1.0.1 或 1.1.0 這樣。
(2)發(fā)行:
然后,在 HBuilderX 中生成wgt的升級(jí)包(wgt):菜單->發(fā)行->原生App-制作移動(dòng)App資源升級(jí)包
生成結(jié)束會(huì)在控制臺(tái)告知升級(jí)包的輸出位置。
2、安裝資源升級(jí)包
應(yīng)用的升級(jí)需要服務(wù)端與客戶端配合完成,下面以本地測試過程中的操作舉例說明:
(1)存放資源
將 %appid%.wgt 文件存放在服務(wù)器的 static 目錄下,如即 http://www.example.com/static/UNI832D722.wgt。
(2)服務(wù)端接口
約定檢測升級(jí)的接口,如地址為:http://www.example.com/update/
(3)傳入?yún)?shù)
| 參數(shù)名 | 類型 | 默認(rèn)值 | 說明 |
|---|---|---|---|
| name | String | '' | 客戶端讀取到的應(yīng)用名稱,定義這個(gè)參數(shù)可以方便多個(gè)應(yīng)用復(fù)用接口。 |
| version | String | '' | 客戶端讀取到的版本號(hào)信息 |
(4)返回參數(shù)
| 參數(shù)名 | 類型 | 默認(rèn)值 | 說明 |
|---|---|---|---|
| update | Boolean | false | 是否有更新 |
| wgtUrl | String | '' | wgt 包的下載地址,用于 wgt 方式更新。 |
| pkgUrl | String | '' | apk/ipa 包的下載地址或 AppStore 地址,用于整包升級(jí)的方式。 |
(5)代碼示例
下面是一個(gè)簡單的服務(wù)端判定的示例,僅做參考,實(shí)際開發(fā)中根據(jù)自身業(yè)務(wù)需求處理。
var express = require('express');
var router = express.Router();
var db = require('./db');
// TODO 查詢配置文件或者數(shù)據(jù)庫信息來確認(rèn)是否有更新
function checkUpdate(params, callback) {
db.query('一段SQL', function(error, result) {
// 這里簡單判定下,不相等就是有更新。
var currentVersions = params.appVersion.split('.');
var resultVersions = result.appVersion.split('.');
if (currentVersions[0] < resultVersions[0]) {
// 說明有大版本更新
callback({
update: true,
wgtUrl: '',
pkgUrl: result.pkgUrl
})
} else {
// 其它情況均認(rèn)為是小版本更新
callback({
update: true,
wgtUrl: result.wgtUrl,
pkgUrl: ''
})
}
});
}
router.get('/update/', function(req, res) {
var appName = req.query.name;
var appVersion = req.query.version;
checkUpdate({
appName: appName,
appVersion: appVersion
}, function(error, result) {
if (error) {
throw error;
}
res.json(result);
});
});
注意事項(xiàng)
以上約定,僅做參考。
服務(wù)端的具體判定邏輯,請(qǐng)根據(jù)自身的業(yè)務(wù)邏輯靈活處理。
應(yīng)用中的路徑盡量不要包含特殊符號(hào)
3、客戶端檢測升級(jí)
在 App.vue 的 onLaunch 中檢測升級(jí),代碼如下:
// #ifdef APP-PLUS
plus.runtime.getProperty(plus.runtime.appid, function(widgetInfo) {
uni.request({
url: 'http://www.example.com/update/',
data: {
version: widgetInfo.version,
name: widgetInfo.name
},
success: (result) => {
var data = result.data;
if (data.update && data.wgtUrl) {
uni.downloadFile({
url: data.wgtUrl,
success: (downloadResult) => {
if (downloadResult.statusCode === 200) {
plus.runtime.install(downloadResult.tempFilePath, {
force: false
}, function() {
console.log('install success...');
plus.runtime.restart();
}, function(e) {
console.error('install fail...');
});
}
}
});
}
}
});
});
// #endif
4、不支持的情況
(1)SDK 部分有調(diào)整,比如新增了 Maps 模塊等,不可通過此方式升級(jí),必須通過整包的方式升級(jí)。
(2)原生插件的增改,同樣不能使用此方式。
(3)對(duì)于老的非自定義組件編譯模式,這種模式已經(jīng)被淘汰下線。但以防萬一也需要說明下,老的非自定義組件編譯模式,如果之前工程沒有 nvue 文件,但更新中新增了 nvue 文件,不能使用此方式。因?yàn)榉亲远x組件編譯模式如果沒有nvue文件是不會(huì)打包weex引擎進(jìn)去的,原生引擎無法動(dòng)態(tài)添加。自定義組件模式默認(rèn)就含著weex引擎,不管工程下有沒有nvue文件。
5、注意事項(xiàng)
(1)條件編譯,僅在 App 平臺(tái)執(zhí)行此升級(jí)邏輯。
(2)appid 以及版本信息等,在 HBuilderX 真機(jī)運(yùn)行開發(fā)期間,均為 HBuilder 這個(gè)應(yīng)用的信息,因此需要打包自定義基座或正式包測試升級(jí)功能。
(3)plus.runtime.version 或者 uni.getSystemInfo() 讀取到的是 apk/ipa 包的版本號(hào),而非 manifest.json 資源中的版本信息,所以這里用 plus.runtime.getProperty() 來獲取相關(guān)信息。
(4)安裝 wgt 資源包成功后,必須執(zhí)行 plus.runtime.restart(),否則新的內(nèi)容并不會(huì)生效。
(5)如果App的原生引擎不升級(jí),只升級(jí)wgt包時(shí)需要注意測試wgt資源和原生基座的兼容性。平臺(tái)默認(rèn)會(huì)對(duì)不匹配的版本進(jìn)行提醒,如果自測沒問題,可以在manifest中配置忽略提示,詳見https://ask.dcloud.net.cn/article/35627
6、關(guān)于熱更新是否影響應(yīng)用上架
應(yīng)用市場為了防止開發(fā)者不經(jīng)市場審核許可,給用戶提供違法內(nèi)容,對(duì)熱更新大多持排斥態(tài)度。
但實(shí)際上熱更新使用非常普遍,不管是原生開發(fā)中還是跨平臺(tái)開發(fā)。
Apple曾經(jīng)禁止過jspatch,但沒有打擊其他的熱更新方案,包括cordovar、react native、DCloud。封殺jspatch其實(shí)是因?yàn)閖spatch有嚴(yán)重安全漏洞,可以被黑客利用,造成三方黑客可篡改其他App的數(shù)據(jù)。
使用熱更新需要注意:
上架審核期間不要彈出熱更新提示
熱更新內(nèi)容使用https下載,避免被三方網(wǎng)絡(luò)劫持
不要更新違法內(nèi)容、不要通過熱更新破壞應(yīng)用市場的利益,比如iOS的虛擬支付要老老實(shí)實(shí)給Apple分錢
如果你的應(yīng)用沒有犯這些錯(cuò)誤,應(yīng)用市場是不會(huì)管的。
總結(jié)
以上是生活随笔為你收集整理的移动端APP应用版本升级更新方案:整包更新及资源在线升级(热更新)的全部內(nèi)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: MySQL中的explain怎么用
- 下一篇: PostCSS是什么