目录
打包wgt包:菜单->发行->原生App-制作移动App资源升级包
需求:
工作中遇到一个需求,app上架各个市场后,用户 需要版本更新检验,下载最新的版本
版本更新有两种更新模式:
- 资源在线升级/热更新(即App并重新安装,里面的js等前端代码进行更新。)
- 整包升级/整体更新(即常规的整个App安装包重新下载安装)
实现:
前提:
每次升级之前,不管是热更新还是整体更新,都需要去更新 manifest.json 中的版本号。
(比如之前是 1.0.0,那么新版本应该是 1.0.1 或 1.1.0 这样。)
热更新:
打包wgt包:菜单->发行->原生App-制作移动App资源升级包
代码逻辑:
uni.downloadFile({
url: 后端返的wgt的下载地址,
success: (downloadResult) => {
if (downloadResult.statusCode === 200) {
plus.runtime.install(downloadResult.tempFilePath, {
force: false //true表示强制安装,不进行版本号的校验;false则需要版本号校验,如果将要安装应用的版本号不高于现有应用的版本号则终止安装,并返回安装失败。 仅安装wgt和wgtu时生效,默认值 false。
}, function() {
console.log('install success...');
plus.runtime.restart(); //下载安装成功之后需要restart重启app
}, function(e) {
console.error('install fail...');
});
}
}
});
整体更新:
const platform = uni.getSystemInfoSync().platform //手机平台
uni.showModal({
title: '版本升级',
content: info.msg,
showCancel: false,
success: function (res) {
if (res.confirm) {
if(platform == 'android'){
// 跳转安卓应用市场
let appurl = "market://details?id=安卓包的包名" //这个是通用应用市场,如果想指定某个应用商店,需要单独查这个应用商店的包名或scheme及参数
plus.runtime.openURL(appurl)
}else if(platform == 'ios'){
const appleId = 对应的ios包的Appleid(不是appid)
plus.runtime.launchApplication({
action: `itms-apps://itunes.apple.com/cn/app/id${appleId}`,
})
}
}
}
})
实际项目开发:
把热更新和整体更新代码逻辑融合在一起的,通过请求服务端返回的状态来控制是什么更新模式
- 在请求头传输当前的版本version
注意:获取version有两种方式,
plus.runtime.version 或者 uni.getSystemInfo() 读取到的是 apk/ipa 包的版本号,而非 manifest.json 资源中的版本信息,所以这里用 plus.runtime.getProperty() 来获取相关信息( plus.runtime.getProperty()获取信息是异步的所以注意执行顺序)。
let appVersion = '';
let appVersion2 = '';
// #ifdef APP-PLUS
plus.runtime.getProperty(plus.runtime.appid, (appInfo) => {
// 获取版本名称
appVersion = appInfo.version; //这个是异步的
console.log(appInfo.version);
// 获取版本号
console.log(appInfo.versionCode);
// 获取当前应用id
console.log(appInfo.appid);
console.log(plus.runtime.version)
});
appVersion2 = plus.runtime.version //这个是同步的
把获取到的版本号放在请求头中,这样就能检测到是否需要版本更新
在App.vue中onLaunch生命周期里调用检测版本更新方法。
unpdate(){
Api.apiverifyVersion().then(res=>{
if (info.code === 1007) {
if(info.data.type === 1){
console.log(" info.data", info.data)
uni.downloadFile({
url: info.data.wgtUrl,
success: (downloadResult) => {
if (downloadResult.statusCode === 200) {
console.log("downloadResult.tempFilePath",downloadResult.tempFilePath)
plus.runtime.install(downloadResult.tempFilePath, {
force: false //true表示强制安装,不进行版本号的校验;false则需要版本号校验,如果将要安装应用的版本号不高于现有应用的版本号则终止安装,并返回安装失败。 仅安装wgt和wgtu时生效,默认值 false。
}, function() {
console.log('install success...');
plus.runtime.restart();
}, function(e) {
console.error('install fail...');
});
}
}
});
}else if(info.data.type === 0){
const exists = uni.getStorageSync('version_expired') || false ;//作用防止modal弹窗多次弹出
const platform = uni.getSystemInfoSync().platform //手机平台
if(!exists){
uni.setStorageSync('version_expired', true)
uni.showModal({
title: '版本升级',
content: info.msg,
showCancel: false,
success: function (res) {
uni.setStorageSync('version_expired', false)
if (res.confirm) {
if(platform == 'android'){
// 跳转安卓应用市场
let appurl = "market://details?id=对应包id" //这个是通用应用市场,如果想指定某个应用商店,需要单独查这个应用商店的包名或scheme及参数
plus.runtime.openURL(appurl)
}else if(platform == 'ios'){
const appleId = 对应包的appleid
plus.runtime.launchApplication({
action: `itms-apps://itunes.apple.com/cn/app/id${appleId}`,
})
}
}
}
})
}
}
}
})
}
参考借鉴文档: