小程序更新机制
在访问小程序时,微信会将小程序代码包缓存到本地。
开发者在发布了新的小程序版本以后,微信客户端会检查本地缓存的小程序有没有新版本,并进行小程序代码包的更新。
小程序的更新机制有两种:启动时同步更新 和 启动时异步更新
启动时同步更新:微信运行时,会定期检查最近使用的小程序是否有更新。如果有更新,下次小程序启动时会同步进行更新,更新到最新版本后再打开小程序。如果 用户长时间未使用小程序时,会强制同步检查版本更新
启动时异步更新:在启动前没有发现更新,小程序每次 冷启动 时,都会异步检查是否有更新版本。如果发现有新版本,将会异步下载新版本的代码包,将新版本的小程序在下一次冷启动进行使用,当前访问使用的依然是本地的旧版本代码
在启动时异步更新的情况下,如果开发者希望立刻进行版本更新,可以使用 wx.getUpdateManager API 进行处理。在有新版本时提示用户重启小程序更新新版本。
【代码实现】在App()方法中实现,也就是app.js中的onLaunch生命周期中实现以下逻辑,具体指方法【autoUpdate】
// app.js
App({
onShow(options) {
},
onLaunch(options) {
//更新方法
this.autoUpdate()
//获取 存储app的appId
wx.setStorageSync('appid', wx.getAccountInfoSync().miniProgram.appId)
//获取屏幕尺寸
this.getTabSize()
//获取小程序启动时的参数。与 App.onLaunch 的回调参数一致。
const launchOptions = wx.getLaunchOptionsSync()
//获取启动时的参数,做业务逻辑
const extraData = launchOptions.referrerInfo.extraData
if (extraData && extraData.wxAuthStores) {
let item = wx.getStorageSync('_storeitem')
if (!item) item = {}
item.wxAuthStores = extraData.wxAuthStores
wx.setStorageSync('_storeitem', item)
}
if (options.referrerInfo && options.referrerInfo.extraData) {
let extraData = options.referrerInfo.extraData;
let keys = Object.keys(extraData)
if (keys.length > 0) {
wx.setStorageSync('_autologin', true)
}
}
},
// 获取屏幕尺寸
getTabSize() {
let _this = this
wx.getSystemInfo({
success(res) {
_this.globalData.version = res.version
_this.globalData.statusBarHeight = res.statusBarHeight || 20
_this.globalData.navHeight = 44
// 根据 屏幕高度 进行判断
if (res.safeArea.top > 30) {
_this.globalData.isFullSucreen = true
_this.globalData.safeBottom = 'padding-bottom: 62rpx'
} else {
_this.globalData.safeBottom = ''
}
}
})
},
//更新方法
autoUpdate: function () {
var self = this
// 获取小程序更新机制兼容
if (wx.canIUse('getUpdateManager')) {
const updateManager = wx.getUpdateManager()
//1. 检查小程序是否有新版本发布
updateManager.onCheckForUpdate(function (res) {
// 请求完新版本信息的回调
if (res.hasUpdate) {
//检测到新版本,需要更新,给出提示
wx.showModal({
title: '更新提示',
content: '检测到新版本,是否下载新版本并重启小程序?',
success: function (res) {
if (res.confirm) {
//2. 用户确定下载更新小程序,小程序下载及更新静默进行
self.downLoadAndUpdate(updateManager)
} else if (res.cancel) {
//用户点击取消按钮的处理,如果需要强制更新,则给出二次弹窗,如果不需要,则这里的代码都可以删掉了
wx.showModal({
title: '温馨提示~',
content: '本次版本更新涉及到新的功能添加,旧版本无法正常访问的哦~',
showCancel: false, //隐藏取消按钮
confirmText: "确定更新", //只保留确定更新按钮
success: function (res) {
if (res.confirm) {
//下载新版本,并重新应用
self.downLoadAndUpdate(updateManager)
}
}
})
}
}
})
}
})
} else {
// 如果希望用户在最新版本的客户端上体验您的小程序,可以这样子提示
wx.showModal({
title: '提示',
content: '当前微信版本过低,无法使用该功能,请升级到最新微信版本后重试。'
})
}
},
/**
* 下载小程序新版本并重启应用
*/
downLoadAndUpdate: function (updateManager) {
var self = this
wx.showLoading();
//静默下载更新小程序新版本
updateManager.onUpdateReady(function () {
wx.hideLoading()
//新的版本已经下载好,调用 applyUpdate 应用新版本并重启
updateManager.applyUpdate()
})
updateManager.onUpdateFailed(function () {
wx.hideLoading()
// 新的版本下载失败
wx.showModal({
title: '已经有新版本了哟~',
content: '新版本已经上线啦~,请您删除当前小程序,重新搜索打开哟~',
})
})
},
//全局变量,所有页面可以使用,
globalData: {
userInfo: null,
login: false
}
})