Trust
Trust
  • 发布:2019-03-07 13:51
  • 更新:2 天前
  • 阅读:17404

uni-app 资源在线升级/热更新

分类:uni-app

注:本文为前端代码资源热更新。如果是整包升级,另见文档https://ask.dcloud.net.cn/article/34972

HBuilderX 1.6.5 起,uni-app 支持生成 App 资源升级包。

生成 App 资源升级包

修改版本号

首先,更新 manifest.json 中的版本号。
比如之前是 1.0.0,那么新版本应该是 1.0.1 或 1.1.0 这样。

发行

然后,在 HBuilderX 中生成升级包(wgt)。
菜单->发行->原生App-制作移动App资源升级包

生成结束会在控制台告知升级包的输出位置。

安装资源升级包

应用的升级需要服务端与客户端配合完成,下面以本地测试过程中的操作举例说明:

存放资源

将 %appid%.wgt 文件存放在服务器的 static 目录下,即 http://www.example.com/static/UNI832D722.wgt。

服务端接口

约定检测升级的接口,地址为:http://www.example.com/update/

传入参数

参数名 类型 默认值 说明
name String '' 客户端读取到的应用名称,定义这个参数可以方便多个应用复用接口。
version String '' 客户端读取到的版本号信息

返回参数

参数名 类型 默认值 说明
update Boolean false 是否有更新
wgtUrl String '' wgt 包的下载地址,用于 wgt 方式更新。
pkgUrl String '' apk/ipa 包的下载地址或 AppStore 地址,用于整包升级的方式。

代码示例

下面是一个简单的服务端判定的示例,仅做参考,实际开发中根据自身业务需求处理。

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  
            })  
        } else {  
            // 其它情况均认为是小版本更新  
            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);  
    });  
});  

注意事项

  • 以上约定,仅做参考。
  • 服务端的具体判定逻辑,请根据自身的业务逻辑灵活处理。

客户端检测升级

在 App.vue 的 onLaunch 中检测升级,代码如下:

// #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  

不支持的情况

  • SDK 部分有调整,比如新增了 Maps 模块等,不可通过此方式升级,必须通过整包的方式升级。
  • 如果是老的非自定义组件编译模式,之前没有 nvue 文件,但更新中新增了 nvue 文件,不能使用此方式。因为非自定义组件编译模式如果没有nvue文件是不会打包weex引擎进去的,原生引擎无法动态添加。自定义组件模式默认就含着weex引擎,不管工程下有没有nvue文件。
  • 原生插件的增改,同样不能使用此方式。

注意事项

  • 条件编译,仅在 App 平台执行此升级逻辑。
  • appid 以及版本信息等,在 HBuilderX 真机运行开发期间,均为 HBuilder 这个应用的信息,因此需要打包自定义基座或正式包测试升级功能。
  • plus.runtime.version 或者 uni.getSystemInfo() 读取到的是 apk/ipa 包的版本号,而非 manifest.json 资源中的版本信息,所以这里用 plus.runtime.getProperty() 来获取相关信息。
  • 安装 wgt 资源包成功后,必须执行 plus.runtime.restart(),否则新的内容并不会生效。
  • 如果App的原生引擎不升级,只升级wgt包时需要注意测试wgt资源和原生基座的兼容性。平台默认会对不匹配的版本进行提醒,如果自测没问题,可以在manifest中配置忽略提示,详见https://ask.dcloud.net.cn/article/35627
  • www.example.com 是一个仅用做示例说明的地址,实际应用中应该是真实的 IP 或有效域名,请勿直接复制粘贴使用。

关于热更新是否影响应用上架

应用市场为了防止开发者不经市场审核许可,给用户提供违法内容,对热更新大多持排斥态度。

但实际上热更新使用非常普遍,不管是原生开发中还是跨平台开发。

Apple曾经禁止过jspatch,但没有打击其他的热更新方案,包括cordovar、react native、DCloud。封杀jspatch其实是因为jspatch有严重安全漏洞,可以被黑客利用,造成三方黑客可篡改其他App的数据。

使用热更新需要注意:

  • 上架审核期间不要弹出热更新提示
  • 热更新内容使用https下载,避免被三方网络劫持
  • 不要更新违法内容、不要通过热更新破坏应用市场的利益,比如iOS的虚拟支付要老老实实给Apple分钱

如果你的应用没有犯这些错误,应用市场是不会管的。

13 关注 分享
DCloud_UNI_HT 阿落 银少 774813571@qq.com 蓝色的红黄绿 1531460503@qq.com sharper 小明子 lobtao 1067998193@qq.com wangyungang2000@163.com QMNY lihu2651@163.com

要回复文章请先登录注册

744138356@qq.com

744138356@qq.com

为何我下载那个包的时候,跳转到了浏览器去??
2 天前
1052036428@qq.com

1052036428@qq.com

这里还不是很明白,我更新一个app,难道大版本的整包更新跟小版本的wgt更新都是在服务器下载资源包再本地安装吗?
2019-08-14 10:38
TONY文

TONY文

官方很厉害
2019-08-13 15:33
乔布斯

乔布斯

回复 AozakiS:
不会,目前更新是用更改文件夹名的方式,要么全部成功要么全部失败,不会出现这个问题
2019-08-11 21:07
zhangjian_0419@sina.com

zhangjian_0419@sina.com

回复 1623450071@qq.com:
你也是更新后资源中的getProperty获取到的versionCode没有改变吗?
2019-08-05 14:36
zhangjian_0419@sina.com

zhangjian_0419@sina.com

iOS wgt包资源热更新后再使用getProperty方法获取到的versionCode小版本号未更新 还是老版本的versionCode 请问是什么原因??
2019-08-05 14:35
1623450071@qq.com

1623450071@qq.com

为什么我测试好几次了,我的版本号都没变啊
2019-08-03 11:57
1249485588@qq.com

1249485588@qq.com

if (currentVersions[0] < resultVersions[0]) {
// 说明有大版本更新
callback({
update: true,
wgtUrl: '',
pkgUrl: result.pkgUrl
})
} else {
// 其它情况均认为是小版本更新
callback({
update: true,
wgtUrl: result.wgtUrl,
pkgUrl: ''
})
}
这一部分不会死循环吗?
2019-06-06 18:00
luhansen2008@126.com

luhansen2008@126.com

下载是成功了。但是如何安装啊。tempFilePath是后台提供的嘛,应该怎么做
2019-05-22 18:27
380624367@qq.com

380624367@qq.com

回复 1947521516@qq.com:
哥们你这是没用过服务器 上传过文件 图片么
2019-05-17 17:54
广州博育科技

广州博育科技

为啥热更新后app的版本号没变?
2019-05-13 17:43
1011093617@qq.com

1011093617@qq.com

应用宝的安装包加固好像会影响热更新,官方可以测试一下给个回复吗
2019-05-11 20:01
1947521516@qq.com

1947521516@qq.com

请问一下,哪位知道怎么做吗,能教教?
2019-05-05 11:47
1947521516@qq.com

1947521516@qq.com

怎么将 %appid%.wgt 文件存放在服务器的 static 目录下
2019-05-05 11:33
1947521516@qq.com

1947521516@qq.com

怎么将 *.wgt 文件存放在服务器的 static 目录下??
2019-05-05 10:43
AozakiS

AozakiS

请问下假如已经下载好wgt包,并且plus.runtime.install途中发生异常而导致install失败后(比如install途中kill了App进程),会不会出现部分文件是新的,部分是旧的呢?有做failed后文件回滚吗?
2019-03-27 17:09
yangchenpeng@qq.com

yangchenpeng@qq.com

恭喜恭喜,等了好久这个功能,需求墙都贡献了好几十票
2019-03-18 18:26
熊海

熊海

ios离线打包,更新成功以后,重启还是关闭了程序再进入,都是上一个版本。用xcode下载数据,看到libray下面的文件又是成功了的,是最新的。甚至连temp里都是最新的。但是启动程序就是不得行。
我还参照了:https://ask.dcloud.net.cn/article/948
这个文章里那样设置代码,也是根本没用处。谁能告诉我下到底哪里出问题了?
2019-03-17 13:46
爱是西瓜

爱是西瓜

热烈庆祝,至少是一大进步,解决了有误问题~ 后面慢慢优化就是了~
2019-03-15 21:41
熊海

熊海

IOS更新,偶尔会成功,大部分时候是失败。
2019-03-15 18:07
小张没有名字

小张没有名字

6666
2019-03-15 13:59
Trust

Trust (作者)

回复 银少:
架构与普通 5+App 有差异,初始化只会在应用启动的时候进行。
因此,替换应用资源之后,必须重启。
2019-03-15 10:42
银少

银少

目前的热更用处不大,如果能生成差量资源升级包就好多了,而且热更之后如果不用重启的话,体验会好很多
2019-03-15 10:40
小明子

小明子

nice,终于出来了
2019-03-14 18:26
617404917@qq.com

617404917@qq.com

dddd
2019-03-14 18:03
18718500103@163.com

18718500103@163.com

按照方法做了,也生成了资源包,也确实发现有下载资源包文件呢,但是最后发现出现安装失败呢,怎么回事你们能安装吗
2019-03-14 17:46
28456049@qq.com

28456049@qq.com

牛逼
2019-03-14 15:23
小曾

小曾

这个功能终于出来了,很赞.
2019-03-14 15:15
银少

银少

期待期待,快出来吧,等N久了
2019-03-14 11:53
1606726660@qq.com

1606726660@qq.com

回复 DCloud_heavensoft:
明天?还是今天
2019-03-14 09:45
1606726660@qq.com

1606726660@qq.com

回复 DCloud_heavensoft:
既然1.6.5都支持了 那hbx 什么时候更新呢
2019-03-14 09:45
shenxianyan

shenxianyan

回复 DCloud_heavensoft:
苹果审核有机审和人工审核,不知道机审能不能过。
2019-03-12 21:39
uniapp学习

uniapp学习

https://www.uniapp.club/ uniapp学习交流
2019-03-12 10:42
shenxianyan

shenxianyan

回复 DCloud_heavensoft:
明白 谢谢
2019-03-11 19:42
DCloud_heavensoft

DCloud_heavensoft

回复 shenxianyan:
提交审核时,app上不要提示更新。如果你不是很大的公司,不做违法的事情,苹果一般不管。
2019-03-11 19:36
吕地瓜

吕地瓜

给力
2019-03-11 19:14
uniapp学习

uniapp学习

厉害啦
2019-03-11 08:48
1606726660@qq.com

1606726660@qq.com

不用升级hbx 也可以 直接使用原来的方式 只是说在hbx中 资源升级包为 不可选中。但是我们依然可以使用发行成本地资源包的方式的到编译后的文件 ,然后在压缩zip改为wgt。 接着就install就ok了,之前一直在求升级包方式 因为hbx在远古不支持 还特意发了一贴 结果自己钻研发现是可以的 http://ask.dcloud.net.cn/question/66512
2019-03-10 21:47
shenxianyan

shenxianyan

请问苹果app能审核通过吗
2019-03-09 23:58
377313813@qq.com

377313813@qq.com

千呼万唤啊 终于来了
2019-03-09 22:44
露珠

露珠

厉害
2019-03-09 22:40
zjttfs@qq.com

zjttfs@qq.com

放大招?
2019-03-07 15:34