js微信小程序-版本更新管理器wx.getUpdateManager()、UpdateManager
1、wx.getUpdateManager()官方文档
版本更新管理器wx.getUpdateManager()官方文档
wx.getUpdateManager()
获取全局唯一的版本更新管理器,用于管理小程序更新。关于小程序的更新机制,可以查看运行机制文档。
更新管理器对象UpdateManager的方法
UpdateManager 对象,用来管理更新,可通过 wx.getUpdateManager 接口获取实例。
方法
UpdateManager.onCheckForUpdate(function callback)
监听向微信后台请求检查更新结果事件。微信在小程序冷启动时自动检查更新,不需由开发者主动触发。
UpdateManager.applyUpdate()
强制小程序重启(小程序无重启的概念,但官方文档依然使用了重启的字眼)并使用新版本。在小程序新版本下载完成后(即收到 onUpdateReady 回调)调用。
UpdateManager.onUpdateReady(function callback)
监听小程序有版本更新事件。客户端主动触发下载(无需开发者触发),下载成功后回调
UpdateManager.onUpdateFailed(function callback)
监听小程序更新失败事件。小程序有新版本,客户端主动触发下载(无需开发者触发),下载失败(可能是网络原因等)后回调
<!--pages/test/test.wxml-->
<text>pages/test/test.wxml</text>
<view class="container">
<button bindtap='getLocation'>稍后模拟更新测试</button>
</view>
// pages/test/test.js
//获取应用实例
const app = getApp()
Page({
data: {
},
onLoad: function (options) {
//使用更新对象之前判断是否可用
if (wx.canIUse('getUpdateManager')){
const updateManager = wx.getUpdateManager()
updateManager.onCheckForUpdate(function (res) {
// 请求完新版本信息的回调
console.log(res.hasUpdate)//res.hasUpdate返回boolean类型
if (res.hasUpdate) {
updateManager.onUpdateReady(function () {
wx.showModal({
title: '更新提示',
content: '新版本已经准备好,是否重启当前应用?',
success(res) {
if (res.confirm) {
// 新的版本已经下载好,调用applyUpdate应用新版本并重启
updateManager.applyUpdate()
}
}
})
})
// 新版本下载失败时执行
updateManager.onUpdateFailed(function () {
wx.showModal({
title: '发现新版本',
content: '请删除当前小程序,重新搜索打开...',
})
})
}
})
}else{
//如果小程序需要在最新的微信版本体验,如下提示
wx.showModal({
title: '更新提示',
content: '当前微信版本过低,无法使用该功能,请升级到最新微信版本后重试。'
})
}
}
})
Tips
微信开发者工具上可以通过「编译模式」下的「下次编译模拟更新」开关来调试
小程序开发版/体验版没有「版本」概念,所以无法在开发版/体验版上测试更版本更新情况
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系:hwhale#tublm.com(使用前将#替换为@)