uni-app如何實現增量更新功能
都知道,很多APP都有增量更新功能,Uni APP也是在今年初,推出了增量更新功能,今天我們就來學習一波。 當然,很多應用市場為了防止開發者不經市場稽核許可,給使用者提供違法內容,對增量更新大多持排斥態度,特別是apple。所以擁有增量更新的app,需要注意以下幾點:
1、上架稽核期間不要彈出增量更新提示
2、增量更新內容使用https下載,避免被三方網路劫持
3、不要更新違法內容、不要通過增量更新破壞應用市場的利益,比如iOS的虛擬支付要給Apple抽傭等
通過本章節你能學到那些?
1、如何實現增量更新功能 2、Uni-App 如何製作增量更新升級包 3、Uni-App 增量更新功能需要注意些什麼 4、Uni-App 部分相關api學習
話不多說,直接上乾貨!
如何實現增量更新功能
這裡不是針對Uni-App開發,所有的增量更新都應如此(但程式碼以Uni-App為例)。
1、app端,先呼叫服務端介面,判斷是否需要更新
2、需要更新,直接下載更新升級包
3、安裝升級包,app重啟即可完成升級
ok,我們以Uni-App為例,看看程式碼具體實現
客戶端實現 在 根目錄 App.vue 的 onLaunch 中檢測升級,程式碼如下:
// #ifdef APP-PLUS plus.runtime.getProperty(plus.runtime.appid,function(widgetInfo) { uni.request({ url: 'http://www.javanx.cn/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) { // 這裡的錯誤很重要,最好能記錄的伺服器日誌中,方便除錯或以後維護瞭解更新錯誤情況,及時解決 // 如何更新到伺服器? // 呼叫一個介面,將e返回咯 console.error('install fail...'); }); } } }); } } }); }); // #endif
程式碼解析: 1、#ifdef APP-PLUS 判斷是app端,才檢測是否需要更新
2、plus.runtime.getProperty 獲取指定APPID對應的應用資訊
plus.runtime.getProperty( plus.runtime.appid,function ( wgtinfo ) { //appid屬性 var wgtStr = "appid:"+wgtinfo.appid; //version屬性 wgtStr += "<br/>version:"+wgtinfo.version; //name屬性 wgtStr += "<br/>name:"+wgtinfo.name; //description屬性 wgtStr += "<br/>description:"+wgtinfo.description; //author屬性 wgtStr += "<br/>author:"+wgtinfo.author; //email屬性 wgtStr += "<br/>email:"+wgtinfo.email; //features 屬性 wgtStr += "<br/>features:"+wgtinfo.features; console.log( wgtStr ); } );
3、uni.request呼叫服務端介面,傳入當前版本,服務端返回update是否需要更新,需要更新時返回wgtUrl更新升級包路徑。
4、uni.downloadFile 下載檔案資源到本地,客戶端直接發起一個 HTTP GET 請求,返回檔案的本地臨時路徑tempFilePath。如何我們需要監聽下載進度,可以這樣:
var downloadTask = uni.downloadFile({ url: 'https://www.javanx.cn/file/uni-app.rar',complete: ()=> {} }); downloadTask.onProgressUpdate(function(res)=>{ console.log('下載進度' + res.progress); console.log('已經下載的資料長度' + res.totalBytesWritten); console.log('預期需要下載的資料總長度' + res.totalBytesExpectedToWrite); })
downloadTask 物件的還提供了一下方法: (1)、abort 中斷下載任務
(2)、onHeadersReceived` 監聽 HTTP Response Header 事件,會比請求完成事件更早,僅微信小程式平臺支援
(3)、offProgressUpdate 取消監聽下載進度變化事件,僅微信小程式平臺支援
(4)、offHeadersReceived 取消監聽 HTTP Response Header 事件,僅微信小程式平臺支援
5、plus.runtime.install(filePath,options,installSuccessCB,installErrorCB)。 支援以下型別安裝包:
(1)、應用資源安裝包(wgt),副檔名為'.wgt';
(2)、應用資源差量升級包(wgtu),副檔名為'.wgtu';
(3)、系統程式安裝包(apk),要求使用當前平臺支援的安裝包格式。 注意:僅支援本地地址,呼叫此方法前需把安裝包從網路地址或其他位置放置到執行時環境可以訪問的本地目錄。
服務端實現 以nodejs為例:
var express = require('express'); var router = express.Router(); var db = require('./db'); // TODO 查詢配置檔案或者資料庫資訊來確認是否有更新 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 // apk,ipa包可下載地址 }) } else if (currentVersions[currentVersions.length-1] < resultVersions[resultVersions.length-1]) { // 認為是小版本更新 callback({ update: true,wgtUrl: result.wgtUrl,// wgt包可下載地址 pkgUrl: '' }) } else { // 其它情況均不更新 callback({ update: false }) } }); } router.get('/update/',function(req,res) { var appName = req.query.name; var appVersion = req.query.version; checkUpdate({ appName: appName,appVersion: appVersion },result) { if (error) { throw error; } res.json(result); }); });
ok,有了以上的功能,我們就用HBuilderx製作升級包.wgt,放到伺服器上,共升級使用。
Uni-App 如何製作增量更新升級包
1、更新 manifest.json 中的版本號。如果上一個版本的版本號是1.0.0,這裡打升級包的時候就可以是1.0.1,反正要不前面的大,大家也可看到服務端介面實現了,就是通過版本號來判斷的。
2、選單->發行->原生App-製作移動App資源升級包
3、等待控制檯生成升級包的輸出位置
4、將升級包上傳到伺服器,介面實現並返回:wgtUrl=剛剛打的升級包
這樣,我們的app就擁有了,增量更新功能。每次如果是小量更新,就可以通過wgt包,來實現增量更新。
下面來看看,Uni App增量更新時,需要注意哪些問題?
Uni-App 增量更新功能需要注意些什麼
1、SDK 部分有調整,比如新增了 Maps 模組等,不可通過此方式升級,必須通過整包的方式升級。
2、如果是老的非自定義元件編譯模式,之前沒有 nvue 檔案,但更新中新增了 nvue 檔案,不能使用此方式。因為非自定義元件編譯模式如果沒有 nvue 檔案是不會打包weex引擎進去的,原生引擎無法動態新增。自定義元件模式預設就含著weex引擎,不管工程下有沒有nvue檔案。
3、原生外掛的增改,同樣不能使用此方式。
4、#ifdef APP-PLUS 條件編譯,僅在 App 平臺執行此升級邏輯。
5、appid 以及版本資訊等,在 HBuilderX 真機執行開發期間,均為 HBuilder 這個應用的資訊,因此需要打包自定義基座或正式包測試升級功能。
6、plus.runtime.version 或者 uni.getSystemInfo() 讀取到的是 apk/ipa 包的版本號,而非 manifest.json 資源中的版本資訊,所以這裡用 plus.runtime.getProperty() 來獲取相關資訊。
7、安裝 wgt 資源包成功後,必須執行 plus.runtime.restart(),否則新的內容並不會生效。
8、如果App的原生引擎不升級,只升級wgt包時需要注意測試wgt資源和原生基座的相容性。平臺預設會對不匹配的版本進行提醒,如果自測沒問題,可以在manifest中配置忽略提示
總結
今天你學到了什麼?Uni-App 增量更新你學會了嗎?
以上就是本文的全部內容,希望對大家的學習有所幫助,也希望大家多多支援我們。