DCloud_App_Array
DCloud_App_Array
  • 发布:2015-10-30 13:12
  • 更新:2023-08-07 16:53
  • 阅读:127835

整包(apk/ipa)升级

分类:HTML5+

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

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

  • 整包升级:适用于大版本更新,runtime发生变化时(模块、配置、版本等变化)必须使用此更新方法
  • 应用资源升级:适用于小版本更新 。runtime不变,前端页面整体压缩包更新
  • 应用资源差量升级:适用于小版本更新 。runtime不变,前端页面仅需要更新的部分更新。

本文重点描述5+应用整包升级,逻辑其实是非常简单,主要有三个步骤:

  1. 查询是否有新版本更新
  2. 下载新版本
  3. 安装新版本

而在实际应用的升级过程中则需要处理很多细节问题,下面就按照这个流程来简单说明在5+App中实现应用升级的逻辑。

查询是否有新版本更新

这个操作其实非常简单,就是客户端与升级服务器的一次交互操作,比较升级服务器上发布的最新客户端版本是否高于当前客户端版本号(5+ API中可以通过plus.runtime.version获取当前apk/ipa的版本号,注意打包方生效)?是的话则需要升级,否则无需升级。
从逻辑上来考虑有两种判断模式:

  1. 客户端判断是否有升级
    客户端从服务器获取最新的版本号,本地js判断是否需要升级。
  2. 服务器判断是否有升级
    客户端提交版本到服务器,有服务器判断返回是否需要升级。
    前者的优点是否服务器压力小,静态返回最新客户端版本即可,后者的优点则升级控制会更灵活,可以根据其它条件动态控制部分用户先升级(灰度发布)等。有条件的情况推荐采用第二种方式进行判断。

可以使用Javascript中的标准XHR请求,如果存在跨域问题则使用5+ API的XMLHttpRequest

下载新版本##

如果判断到需要更新版本,则需要从服务器下载新版本,通常升级服务器应该返回下载新版本的地址(或者从固定的地址获取)。
有两种下载方法,一种调用Downloader API下载,示例如下:

var url=""; // 下载文件地址  
var dtask = plus.downloader.createDownload( url, {}, function ( d, status ) {  
    if ( status == 200 ) { // 下载成功  
        var path = d.filename;  
        console.log(d.filename);  
    } else {//下载失败  
        alert( "Download failed: " + status );   
    }    
});  
dtask.start(); 

安装新版本

下载原生安装包apk后,可调用plus.runtime.install方法安装,示例如下:

    plus.runtime.install(path);  // 安装下载的apk文件

注意
iOS平台的ipa无法安装,此时需要跳转到appstore,提示用户自动点击升级更新,跳转到appstore的方法为打开应用的appstore地址,示例如下:

var url='itms-apps://itunes.apple.com/cn/app/hello-h5+/id682211190?l=zh&mt=8';// HelloH5应用在appstore的地址  
plus.runtime.openURL(url);

此处url是以"itms-apps://"开头,后面跟appstore上应用地址。

示例
在Hello H5+和Hello mui示例里,有2种不同的检查更新处理方式。
Hello H5+里的update.js比较复杂,在js里执行下载apk并安装的逻辑。
Hello mui里的update.js比较简单,弹出新包下载地址到浏览器,由浏览器执行下载逻辑。
如何选择看自己的要求。

27 关注 分享
wduser ffffffffff seniafamily Nick丶丶 老醒 木头很努力 Trust 4***@qq.com MRS z***@163.com 1***@qq.com 雪之梦技术驿站 实践活动结束 周建伟 1***@qq.com q***@163.com ali 启程588 5***@qq.com 1***@qq.com 7***@qq.com 7***@qq.com jzq84229 x***@163.com M社長 8***@qq.com eppen2

要回复文章请先登录注册

水泥钉

水泥钉

使用plus.runtime.install安装整包apk时 返回null
2023-08-07 16:53
2***@qq.com

2***@qq.com

之前都可以
2023-01-13 12:57
特斯拉的韭菜

特斯拉的韭菜

回复 k***@163.com :
iOS 工程下,有个<HBuilder debug="true" syncDebug="true" version="*">, 里面的 syncDebug 改成 false
2022-10-11 16:03
优租花

优租花

整包升级WGT/WGTU错误,用plus.downloader.createDownload(this.app.download_url, {filename: '_doc/download/' + new Date().getTime() + '.apk'}, (d, status){}),必须改filename,默认下载是.bin格式会报错
2022-05-11 15:34
DCloud_App_Array

DCloud_App_Array (作者)

回复 k***@163.com :
应用manifest.json中的新版本号必须大于就的版本号
2021-03-15 19:32
k***@163.com

k***@163.com

请问一下,整包更新时,安装时版本确实是最新的,但是安装完之后打开,还是未安装前的app版本及内容,请问有人知道是怎么回事吗?
2021-03-15 15:41
MonikaChen

MonikaChen

“两种下载方法,一种调用Downloader API下载”
另一种呢?
2021-02-28 18:22
6***@qq.com

6***@qq.com

plus.runtime.install 现在还能用吗,每次都报错400
2020-11-20 11:33
1***@qq.com

1***@qq.com

Hello H5+ 这个示例,也是通过调用浏览器进行下载APP进行升级啊,和Hello mui 没啥子区别,APP现在不能通过调用 plus.runtime.install 进行整包升级了吗?
2020-09-09 15:16
HealerLZH

HealerLZH

回复 冷月i :
一样的效果
2020-06-17 16:29