DCloud_App_Array
DCloud_App_Array
  • 发布:2015-03-15 23:28
  • 更新:2024-11-14 23:06
  • 阅读:371410

App资源在线升级更新

分类:HTML5+

官方已发布APP升级中心,支持原生APP整包升级和wgt资源包升级。详见

注意:uni-app的热更新另见文档https://ask.dcloud.net.cn/article/35667

5+应用可使用以下方式进行升级

本文重点介绍5+应用资源独立升级,相对整包升级有以下优势:

  1. 无需重新提交应用市场审核更新,降低更新周期;
  2. 无需用户手动点击操作安装更新,优化用户体验;
  3. App资源相对整包体积更小,升级速度更快。

生成移动App资源升级包

  • 在HBuilder中编辑好新的移动App资源后,更新manifest.json的版本号
    原来版本是1.0,新版本修改为2.0:

  • 在HBuilder中生成升级包文件(wgt)
    菜单“发行” -> “制作移动App资源升级包”:

    在以下界面中通过“浏览”按钮选择保存路径,点击“确定”保存wgt文件:

  • 生成wgt后提交到手机可访问的网络地址
    App资源升级包下载地址:
    http://www.dcloud.io/docs/a/update/H5EF3C469.wgt
    为了模拟正常的升级检测流程,添加以下检测升级地址(返回最新版本号):
    http://demo.dcloud.net.cn/test/update/check.php

应用中检测更新资源

检测服务器上是否有新版本

  • 获取当前应用的版本号

    var wgtVer=null;  
    function plusReady(){  
    // ......  
    // 获取本地应用资源版本号  
    plus.runtime.getProperty(plus.runtime.appid,function(inf){  
        wgtVer=inf.version;  
        console.log("当前应用版本:"+wgtVer);  
    });  
    }  
    if(window.plus){  
    plusReady();  
    }else{  
    document.addEventListener('plusready',plusReady,false);  
    }
  • 发起ajax请求检测是否有新版本

    // 检测更新  
    var checkUrl="http://demo.dcloud.net.cn/test/update/check.php";  
    function checkUpdate(){  
    plus.nativeUI.showWaiting("检测更新...");  
    var xhr=new XMLHttpRequest();  
    xhr.onreadystatechange=function(){  
        switch(xhr.readyState){  
            case 4:  
            plus.nativeUI.closeWaiting();  
            if(xhr.status==200){  
                console.log("检测更新成功:"+xhr.responseText);  
                var newVer=xhr.responseText;  
                if(wgtVer&&newVer&&(wgtVer!=newVer)){  
                    downWgt();  // 下载升级包  
                }else{  
                    plus.nativeUI.alert("无新版本可更新!");  
                }  
            }else{  
                console.log("检测更新失败!");  
                plus.nativeUI.alert("检测更新失败!");  
            }  
            break;  
            default:  
            break;  
        }  
    }  
    xhr.open('GET',checkUrl);  
    xhr.send();  
    }

更新应用资源

  • 从服务器下载应用资源包(wgt文件)

    // 下载wgt文件  
    var wgtUrl="http://demo.dcloud.net.cn/test/update/H5EF3C469.wgt";  
    function downWgt(){  
    plus.nativeUI.showWaiting("下载wgt文件...");  
    plus.downloader.createDownload( wgtUrl, {filename:"_doc/update/"}, function(d,status){  
        if ( status == 200 ) {   
            console.log("下载wgt成功:"+d.filename);  
            installWgt(d.filename); // 安装wgt包  
        } else {  
            console.log("下载wgt失败!");  
            plus.nativeUI.alert("下载wgt失败!");  
        }  
        plus.nativeUI.closeWaiting();  
    }).start();  
    }
  • 更新应用资源包(wgt文件)

    // 更新应用资源  
    function installWgt(path){  
    plus.nativeUI.showWaiting("安装wgt文件...");  
    plus.runtime.install(path,{},function(){  
        plus.nativeUI.closeWaiting();  
        console.log("安装wgt文件成功!");  
        plus.nativeUI.alert("应用资源更新完成!",function(){  
            plus.runtime.restart();  
        });  
    },function(e){  
        plus.nativeUI.closeWaiting();  
        console.log("安装wgt文件失败["+e.code+"]:"+e.message);  
        plus.nativeUI.alert("安装wgt文件失败["+e.code+"]:"+e.message);  
    });  
    }

    wgt更新原生层是通过文件夹重命名方式实现,要么全部更新成功,要么更新失败,不会出现仅部分文件更新的情况

其它可改进的思路

  • 检测更新更好的模式应该是客户端提交本地应用资源版本号到升级服务器,由升级服务器判断是否可更新并且返回App升级资源包下载地址,避免在客户端写资源下载地址;
  • 更新时可以在后台静默下载,下次启动是直接更新,避免更新时打断用户操作。
  • 差量升级更新App资源,参考App资源在线差量升级更新

附件testUpdate.zip为测试移动App包

App store应用更新说明
应用资源更新肯定是违反apple政策的,但目前看起来,如果你不是很大的公司,apple不会理睬你。如果你是大公司,建议不要做整体更新,每次更新几个页面,也不要提示更新后需要重启,这样会安全点。

79 关注 分享
向着太阳 hilongjw andywang qinerg 逍涯 Mr丶Leo Julien Mars_Zhong Liosixer testemule syz 冰青虫 小米粒 dglhz Back Met magengshun haha2021a Amber0376 ffffffffff 淮风皖韵 c***@126.com 4***@qq.com ROBOT10086 Lanman_Group 1***@qq.com 老醒 Trust Jose w***@163.com 3***@qq.com 兔子x jtshushu 3***@qq.com 1***@qq.com 漠 dxTOP 来小新 m***@msn.cn 马振丹 j***@163.com y***@163.com m***@sina.com JSail MR不靠谱 飘过大山 1***@qq.com Viccy 段长发 断想

要回复文章请先登录注册

t***@163.com

t***@163.com

wgt更新之后部分图片和图标无法显示,请问大神们怎么处理
2024-11-14 23:06
simon187

simon187

回复 xfxTab :
我也遇到一样的问题,wgt包更新成功后执行plus.runtime.restart()方法后重启会卡在app的启动页就不动了,除非把app的进程杀了再次启动就没问题了
2023-08-03 14:55
1***@163.com

1***@163.com

回复 8***@qq.com :
应该不是的,我发现已经更新过wgt版本的app无法再次热更新更高wgt版本,例如,我原app安装包版本是 1.7.6,我上传了一个wgt热更新版本,版本为1.7.8, app 下载完成后重启应用,这个时候我再上传一个wgt热更新版本 1.7.9(选择的强制更新上线发行),这个时候app 无论如何重启都不会提示我有新的版本需要更新。

必须重新安装原来的整包版本1.7.6 才能更新到 1.7.9,无法从一个wgt版本更新到另外一个更高版本的wgt版本,不知道是bug还是就是这么设定的。
2023-07-04 08:41
xfxTab

xfxTab

wgt热更新后 自动重启 会白屏
2023-03-20 08:50
DCloud_App_Array

DCloud_App_Array (作者)

回复 wengxia :
这应该是升级服务器请求没有获取更新数据吧。
2023-03-13 11:26
wengxia

wengxia

请问整包升级时,前台检测更新弹窗进度条一直为0导致更新失败是什么问题?
2023-02-02 15:00
liaol

liaol

回复 DCloud_App_Array :
请问,能否通过命令行执行wgt资源生成?问题描述在另外一个问题里面:https://ask.dcloud.net.cn/question/132130
2021-10-09 18:29
8***@qq.com

8***@qq.com

通过资源在线升级更新,那第一次上架打包的是app整包,后面就不用打包整包,都是用wgt包升级,如果是这样,那服务器上要用两个包地址,一个是安装包(整包)地址,一个是wgt包地址,是这样吗?
2021-07-19 09:18
EthanQuick

EthanQuick

更新后能用,如果强退或者断电导致非正常关闭App,下次启动就会卡启动页面、白屏
2021-06-23 20:49
素履之往独远行

素履之往独远行

plus.runtime.install函数自定义基座包IOS包正常执行,IOS正式包热更新没有任何反应是什么原因?
2021-04-18 19:56