咱們的手機軟件天天都要經營,常常須要更新,好比程序的Bug,好的功能,好的潔面... ... 這就須要咱們的用戶打開web app時候自動更新客戶端程序,而不是再去應用程序商店重新下載。今天的筆記就是完成這項工做。html
服務器很簡單,只存放一個json文檔,這個文檔你能夠用服務器端語言生成,也能夠直接創建一個.json文件就可了,數據格式以下。[{"VisonID":"1.0.0","downURI":"http://yuanziyu.com/down/yzsc.apk"}]
VisonID表示web APP版本號,downURI表示安裝文件urlhtml5
爲了提升用戶使用感覺,首先提示進行更新檢查。
var showLoading = plus.nativeUI.showWaiting("檢查更新...");
獲取當前web APP版本號:plus.runtime.getProperty(plus.runtime.appid, function(inf) {inf.version}。其中inf.version表示web APP版本號。
版本版本筆記若是,服務器端版本號高於客戶端版本號,對web APP 進行更新,版本號等於或小於不進行更新。web
//版本比較o表示客戶端版本號,n表示服務器端版本號。 function checkvison(o, n) { var tempo = o.split('.'); var tempn = n.split('.'); if ((tempo[0] * 100 + tempo[1] * 10 + tempo[2] * 1) < (tempn[0] * 100 + tempn[1] * 10 + tempn[2] * 1)) { return true; } else { return false; } }
經過mui.ajax獲取服務器端JSON文件。其中參數 Date.parse( new Date())是獲取時間戳,防止服務器端緩存,目地主要是爲了調試用,若是正式發佈能夠刪除,由於咱們跟新速度沒有那麼快。mui.ajax方法介紹:ajax
mui.ajax(url,{//url表示服務地址 data:{},表示向服務器提交的數據 dataType:'json',//服務器返回json格式數據 type:'post',//HTTP請求類型 async: false,//表示是否異步 timeout:10000,//超時時間設置爲10秒; success:function(json){ }, error:function(xhr,type,errorThrown){ //異常處理; mui.alert('網絡延時,請從新加載!', '系統提示'); } });
咱們更新文件或者是APP咱們必須先從網絡下載文件,而後更新APP軟件。下載網絡文件咱們主要用到的是這個方法html5+中Downloader對象。Downloader對象是模塊管理文件下載,用於從網絡下載各類文件,可支持跨域訪問操做。咱們主要用到如下幾個方法
1.createDownload方法,表示新建下載任務。
Download plus.downloader.createDownload( url, option, completedCB );
說明:表示請求下載管理建立新的下載任務,建立成功則返回Download對象,用於管理下載任務的各類狀態。
參數:url (DOMString) 可選 要下載文件的url地址,僅支持網絡資源地址。必須是http或https協議;option (DownloadOption) 可選 可經過此參數設置自定義任務屬性,自定義屬性值僅支持字符串類型;completedCB (DownloadCompletedCallback) 可選 下載任務完成後的回調。
2.start 表示開始下載任務
void download.start();
說明:
開始下載任務,若是任務已經處於開始狀態則無任何響應。 一般在建立任務或暫停任務後從新開始。
3.Downloader中的DownloadStateChangedCallback回調,表示下載任務完成時的回調
vaoid onCompleted( Download download, Number status ) {
// Download file complete code
}
說明:下載任務完成時的回調函數,在下載任務完成時調用。 下載任務失敗也將觸發此回調。
參數:download (Download) 可選 下載任務對象,這裏面咱們常常用到的一個屬性filename,DOMString,只讀屬性,下載任務在本地保存的文件路徑,在DownloadCompleteCallback事件和DownloadStateChangedCallback事件觸發時更新。還有不少其它屬性我就不記錄了,用到的時候在翻手冊吧。status (Number) 可選 Http傳輸協議狀態碼,若是未獲取傳輸狀態則其值則爲0,以下載成功其值一般爲200
4.Downloader中的DownloadStateChangedCallback回調,表示下載任務狀態變化回調,咱們主要用於顯示下載進度。
void onStateChanged( Download download, status ) {
// Download state changed code.
}
說明:下載任務狀態變化回調。
參數:同DownloadStateChangedCallback。json
Ok,咱們用到的主要對象和方法基本介紹完了,而後咱們看一下完整代碼:
跨域
function UpdateVison() { var showLoading = plus.nativeUI.showWaiting("檢查更新..."); // 獲取本地應用資源版本號 plus.runtime.getProperty(plus.runtime.appid, function(inf) { mui.ajax('http://123.58.4.202:8010/vison.json?r='+ Date.parse( new Date()), { data: {}, //dataType:'json',//服務器返回json格式數據 type: 'get', //HTTP請求類型 timeout: 10000, //超時時間設置爲10秒; headers: { 'Content-Type': 'application/json' }, success: function(jsondata) { var data2 = JSON.parse(jsondata); if (checkvison(inf.version, data2[0].VisonID)) { wgtUrl = data2[0].downURI; var downToaknew = plus.downloader.createDownload(wgtUrl, { filename: "_doc/update/" }, function(d, status) { //alert(d) if (status == 200) { installApp(d.filename); } else { showLoading.setTitle("下載失敗") } }); downToaknew.start(); // 開啓下載的任務 var prg = 0; downToaknew.addEventListener("statechanged", function(task, status) { //給下載任務設置一個監聽 並根據狀態 作操做 switch (task.state) { case 1: showLoading.setTitle("正在下載"); break; case 2: showLoading.setTitle("已鏈接到服務器"); break; case 3: prg = parseInt(parseFloat(task.downloadedSize) / parseFloat(task.totalSize) * 100); if (prg % 1 == 0) { // 讓百分比 10% 增加,若是這裏不這麼處理 出現 堆棧內存溢出的問題,有知道緣由的大神指導一下哈 showLoading.setTitle("已下載" + prg + "%"); } } }); } else{ plus.nativeUI.closeWaiting(); } }, error: function(xhr, type, errorThrown) { //異常處理; console.log(type); } }); }); } function checkvison(o, n) { var tempo = o.split('.'); var tempn = n.split('.'); if ((tempo[0] * 100 + tempo[1] * 10 + tempo[2] * 1) < (tempn[0] * 100 + tempn[1] * 10 + tempn[2] * 1)) { return true; } else { return false; } } function installApp(path) { plus.nativeUI.showWaiting("安裝文件..."); plus.runtime.install(path, { force: false }, function() { plus.nativeUI.closeWaiting(); console.log("安裝文件成功!"); plus.nativeUI.alert("應用資源更新完成!", function() { plus.runtime.restart(); }); }, function(e) { plus.nativeUI.closeWaiting(); console.log("安裝文件失敗[" + e.code + "]:" + e.message); plus.nativeUI.alert("安裝文件失敗[" + e.code + "]:" + e.message); }); }
好了,咱們的Web APP自動更新代碼就大功告成了,留做備用。緩存