在进行版本迭代时一般是局部更新,所以热更新就是新的需求,HBuilderX 1.6.5 起,uni-app 支持生成 App 资源升级包。
完成新需求,需要热更新时,具体步骤如下:
1:热更新程序代码:
在App.vue文件中的onLaunch中编码
onLaunch() {
let _this = this;
// #ifdef APP-PLUS
/** 锁定屏幕方向 */
plus.screen.lockOrientation('portrait-primary');
console.log("onLaunch111")
/** 检测升级 */
// 取得版本号
plus.runtime.getProperty(plus.runtime.appid, function(info) {
console.log("当前应用版本:" + info.version + "---" + plus.runtime.version);
_this.$com.ajax("update", {
"appid": plus.runtime.appid,
"version": plus.runtime.version
}, "POST", false,function(ret) {
console.log("【appid】", plus.runtime.appid)
console.log("【version】", plus.runtime.version)
console.log("版本升级接口回调", ret)
if (ret.status) {
// 下载wgt文件
var wgtUrl = "https://xxxxx.cn/update/1.0.1.wgt"; //下载文件地址(也可以从后台获取)
plus.nativeUI.showWaiting("正在更新中,请稍后..");
plus.downloader.createDownload(wgtUrl, {
filename: "_doc/update/"
}, function(d, status) {
if (status == 200) {
let path =d.filename
// 安装wgt包 更新应用资源
plus.nativeUI.showWaiting("正在更新中,请稍后...");
plus.runtime.install(d.filename, {
force: true
}, function() {
plus.nativeUI.closeWaiting();
console.log("新版本文件成功!");
plus.nativeUI.alert("软件应用更新完成!", function() {
plus.runtime.restart(); //必须执行 plus.runtime.restart(),否则新的内容并不会生
});
}, function(e) {
console.log(e)
plus.nativeUI.closeWaiting();
console.log("更新失败[" + e.code + "]:" + e.message);
plus.nativeUI.alert("更新失败[" + e.code + "]:" + e.message);
});
} else {
console.log("下载wgt失败!");
plus.nativeUI.alert("下载wgt失败!");
}
plus.nativeUI.closeWaiting();
}).start();
}
})
})
// #endif
},
2:更新 manifest.json 中的版本号(比如之前是 1.0.0,那么新版本应该是 1.0.1 或 1.1.0,小版本更新一般为1.0.1,大版本的话1.1.0)
3:发行,在 HBuilderX 中生成升级包(wgt),菜单->发行->原生App-制作移动App资源升级包 ,输出wgt文件地址后,将文件放在服务器上就可以了。重新启动APP后配合后端测试验证。
< PPSS 后续请注意!! >
不支持的情况
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
关于热更新是否影响应用上架
应用市场为了防止开发者不经市场审核许可,给用户提供违法内容,对热更新大多持排斥态度。
但实际上热更新使用非常普遍,不管是原生开发中还是跨平台开发。
Apple曾经禁止过jspatch,但没有打击其他的热更新方案,包括cordovar、react native、DCloud。封杀jspatch其实是因为jspatch有严重安全漏洞,可以被黑客利用,造成三方黑客可篡改其他App的数据。
使用热更新需要注意:
上架审核期间不要弹出热更新提示
热更新内容使用https下载,避免被三方网络劫持
不要更新违法内容、不要通过热更新破坏应用市场的利益,比如iOS的虚拟支付要老老实实给Apple分钱
如果你的应用没有犯这些错误,应用市场是不会管的。