DCloud_UNI_CHB
DCloud_UNI_CHB
  • 发布:2019-03-07 13:51
  • 更新:2023-12-04 09:10
  • 阅读:221414

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

分类:uni-app

官方已发布APP升级中心,支持原生APP整包升级和wgt资源包升级。详见https://uniapp.dcloud.io/uniCloud/upgrade-center

======如下是官方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/__UNI__832D722.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分钱

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

63 关注 分享
DCloud_UNI_HT 阿落 银少 7***@qq.com 蓝色的红黄绿 1***@qq.com sharper 小明子 lobtao 1***@qq.com w***@163.com QMNY XTiger wenju Ccb a***@qq.com 1***@qq.com 被嫉妒的猫 飞翔32993 w***@163.com mylove 1***@qq.com 2***@qq.com l***@126.com 9***@qq.com 曾瞎掰 1***@qq.com Da_xiong 7***@qq.com 2***@qq.com kevin_xy 啊灿 8***@qq.com 2***@qq.com 1***@qq.com q***@qiyundata.com 乖乖神 l***@qq.com 1***@qq.com 1***@qq.com 古月娜 晓春 超级无敌暴龙兽 1***@qq.com 河马哥0522 2***@qq.com 小白UNI 1***@qq.com 786395613 ReyZhang

要回复文章请先登录注册

赵永强

赵永强

回复 惠创达 :
可以参考我的插件,这个问题可以解决 https://ext.dcloud.net.cn/plugin?id=7286
2023-12-04 09:10
惠创达

惠创达

如果我线上放的下载版本是1.0的版本,但是我一直使用wgt包进行热更新,热更新的版本都到了1.8版本,那客户首次下载app是1.0的版本,进入到了app提示了升级到1.8版本,能全量更新到1.8之前的所有内容吗? 求解
2023-11-29 15:26
ryan啊

ryan啊

回复 ryan啊 :
解决了,哈哈哈,unisdk中的demo,checkUniMPResource方法里面的ifelse别注释掉,这个判断有用
2023-10-10 16:57
ryan啊

ryan啊

回复 i***@gmail.com :
一样的问题,安卓没问题,iOS有问题
2023-10-10 14:40
星星不怕黑

星星不怕黑

回复 simon187 :
plus.runtime.restart() 这个其实不是重启,只是重新加载了,就是热重启,不是真正的重启
2023-09-21 11:37
河兮

河兮

热更新的项目 忘记密码了 云数据库中有嘛?
2023-09-15 10:41
3***@qq.com

3***@qq.com

我在想,可以做一个弹窗,唤起手机浏览器,让浏览器去打开这个APK链接,实现下载。这样可行吗?? 因为我发现在华为手机里的应用下载apk的安装包,然后安装时,会提示恶意应用 禁止安装。
2023-09-02 16:51
s***@sina.com

s***@sina.com

用uni.downloadFile下载的wgt临时文件没有.wgt扩展名,怎么解决
2023-08-11 18:01
水泥钉

水泥钉

能不能精细哈 plus.runtime.install 错误的返回 不要动不动只返回null 能不能返回一些具体的信息!!!开发者才好排查问题! 安装包不完整也只返回null
2023-08-07 19:52
水泥钉

水泥钉

回复 赵永强 :
谢谢 实际操作了哈 确实是 只不过有些商城通不过
2023-08-07 19:48