移动端APP应⽤版本升级更新⽅案:整包更新及资源在线升级
(热更新)
App端的升级,⼜分为整包更新和资源热更新两种:
1、整包更新,即常规的整个App安装包重新下载安装。
2、资源热更新,即App不重新安装,⾥⾯的js等前端代码进⾏更新。
⼀、整包更新⽅案
1、IOS更新
⼀般iOS Appstore的安装包,⽆法直接更新。App启动后检查有新版本,只能跳转到Appstore,然后⽤户在Appstore的详情页点击更新按钮。
2、Android更新
⽽Android App,可以直接下载新的apk,只要包名和证书不变,就可以覆盖安装。
注意:
(1)App的升级检测代码必须使⽤条件编译,否则在⾮App环境由于不存在plus相关API,将会报错。
(2)升级地址URL,如果是⾃⾏托管的App,就提供⾃⼰的包地址。如果是打开应⽤市场,那URL如下:
if (plus.os.name=="Android") {
appurl = "market://details?id=io.dcloud.hellouniapp";
//这个是通⽤应⽤市场,如果想指定某个应⽤商店,需要单独查这个应⽤商店的包名或scheme及参数
} else {
appurl = "itms-apps://itunes.apple/cn/app/hello-uni-app/id1417078253";
}
(3)版本检测需要打包app,真机运⾏基座⽆法测试。因为真机运⾏的plus.runtime.version是固定值。
关于升级,⽐较省事的就是跳转到浏览器下载apk包,下载完成之后安装。另外可以在应⽤内下载,下载完成之后调
⽤plus.runtime.install安装。具体代码如下:
// 在index.vue 中的onload⽅法⾥⾯或者app.vue中的onLaunch中添加如下部分:
update() {
var _this = this;
url: `${this.$store.state.apiBaseUrl}/users/versions`, //请求接⼝
method: 'POST',
success: result => {
if (de == 1) {
Property(plus.runtime.appid, function(inf) {
if(inf.version != result.data.data.versions){
uni.showModal({
title: "发现新版本",
content: "确认下载更新",
success: (res) => {
if (firm == true) {//当⽤户确定更新,执⾏更新
_this.doUpData();
}
}
})
}
});
}
},
})
react router 方法},
doUpData() {
uni.showLoading({
title: '更新中……'
})
uni.downloadFile({//执⾏下载
url: '***', //下载地址
success: downloadResult => {//下载成功
uni.hideLoading();
if (downloadResult.statusCode == 200) {
uni.showModal({
title: '',
content: '更新成功,确定现在重启吗?',
confirmText: '重启',
confirmColor: '#EE8F57',
success: function(res) {
if (firm == true) {
plus.runtime.install(//安装
force: true
},
function(res) {
utils.showToast('更新成功,重启中');
start();
}
);
}
}
});
}
}
});
}
⼆、资源在线升级(热更新)
HBuilderX 1.6.5 起,uni-app ⽀持⽣成 App 资源升级包。
1、⽣成 App 资源升级包
(1)修改版本号:
⾸先,更新 manifest.json 中的版本号。⽐如之前是 1.0.0,那么新版本应该是 1.0.1 或 1.1.0 这样。
(2)发⾏:
然后,在 HBuilderX 中⽣成wgt的升级包(wgt):菜单->发⾏->原⽣App-制作移动App资源升级包
⽣成结束会在控制台告知升级包的输出位置。
2、安装资源升级包
应⽤的升级需要服务端与客户端配合完成,下⾯以本地测试过程中的操作举例说明:
(1)存放资源
将 %appid%.wgt ⽂件存放在服务器的 static ⽬录下,如即 ample/static/UNI832D722.wgt。(2)服务端接⼝
约定检测升级的接⼝,如地址为:ample/update/
(3)传⼊参数
参数名类型默认值说明
name String''客户端读取到的应⽤名称,定义这个参数可以⽅便多个应⽤复⽤接⼝。
version String''客户端读取到的版本号信息
(4)返回参数
参数名类型默认值说明
update Boolean false是否有更新
wgtUrl String''wgt 包的下载地址,⽤于 wgt ⽅式更新。
pkgUrl String''apk/ipa 包的下载地址或 AppStore 地址,⽤于整包升级的⽅式。
(5)代码⽰例
下⾯是⼀个简单的服务端判定的⽰例,仅做参考,实际开发中根据⾃⾝业务需求处理。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: ''
})
}
});
}
<('/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);
});
});
注意事项
以上约定,仅做参考。
服务端的具体判定逻辑,请根据⾃⾝的业务逻辑灵活处理。
应⽤中的路径尽量不要包含特殊符号
3、客户端检测升级
在 App.vue 的 onLaunch 中检测升级,代码如下:
// #ifdef APP-PLUS
Property(plus.runtime.appid, function(widgetInfo) {
url: 'ample/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.pFilePath, {
force: false
}, function() {
console.log('');
start();
}, function(e) {
<('');
});
}
}
});
}
}
});
});
// #endif
4、不⽀持的情况
(1)SDK 部分有调整,⽐如新增了 Maps 模块等,不可通过此⽅式升级,必须通过整包的⽅式升级。
(2)原⽣插件的增改,同样不能使⽤此⽅式。
(3)对于⽼的⾮⾃定义组件编译模式,这种模式已经被淘汰下线。但以防万⼀也需要说明下,⽼的⾮⾃定义组件编译模式,如果之前⼯程没有 nvue ⽂件,但更新中新增了 nvue ⽂件,不能使⽤此⽅式。因为⾮⾃定义组件编译模式如果没有nvue⽂件是不会打包weex引擎进去的,原⽣引擎⽆法动态添加。⾃定义组件模式默认就含着weex引擎,不管⼯程下有没有nvue⽂件。
5、注意事项
(1)条件编译,仅在 App 平台执⾏此升级逻辑。
(2)appid 以及版本信息等,在 HBuilderX 真机运⾏开发期间,均为 HBuilder 这个应⽤的信息,因此需要打包⾃定义基座或正式包测试升级功能。
(3)plus.runtime.version 或者 SystemInfo() 读取到的是 apk/ipa 包的版本号,⽽⾮ manifest.json 资源中的版本信息,所以这⾥⽤Property() 来获取相关信息。
(4)安装 wgt 资源包成功后,必须执⾏ start(),否则新的内容并不会⽣效。
(5)如果App的原⽣引擎不升级,只升级wgt包时需要注意测试wgt资源和原⽣基座的兼容性。平台默认会对不匹配的版本进⾏提醒,如果⾃测没问题,可以在manifest中配置忽略提⽰,详见
6、关于热更新是否影响应⽤上架
应⽤市场为了防⽌开发者不经市场审核许可,给⽤户提供违法内容,对热更新⼤多持排斥态度。
但实际上热更新使⽤⾮常普遍,不管是原⽣开发中还是跨平台开发。
Apple曾经禁⽌过jspatch,但没有打击其他的热更新⽅案,包括cordovar、react native、DCloud。封杀jspatch其实是因为jspatch有严重安全漏洞,可以被⿊客利⽤,造成三⽅⿊客可篡改其他App的数据。
使⽤热更新需要注意:
上架审核期间不要弹出热更新提⽰
热更新内容使⽤https下载,避免被三⽅⽹络劫持
不要更新违法内容、不要通过热更新破坏应⽤市场的利益,⽐如iOS的虚拟⽀付要⽼⽼实实给Apple分钱
如果你的应⽤没有犯这些错误,应⽤市场是不会管的。
版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。
发表评论