2025-11-06 04:32:27 admin 世界杯哥伦比亚

微信小程序发布新版本自动更新-避坑指南

微信小程序发布新的版本后,没有及时更新,甚至出现测试版本上线的情况。需要我们手动配置自动更新,调用下wx.getUpdateManager(),执行顺序要放在onLaunch触发里

UpdateManager

UpdateManager 对象,用来管理更新,可通过 wx.getUpdateManager 接口获取实例。

方法

UpdateManager.applyUpdate()

强制小程序重启并使用新版本。在小程序新版本下载完成后(即收到 onUpdateReady 回调)调用。

UpdateManager.onCheckForUpdate(function listener)

监听向微信后台请求检查更新结果事件。微信在小程序每次启动(包括热启动)时自动检查更新,不需由开发者主动触发。

UpdateManager.onUpdateReady(function listener)

监听小程序有版本更新事件。客户端主动触发下载(无需开发者触发),下载成功后回调

UpdateManager.onUpdateFailed(function listener)

监听小程序更新失败事件。小程序有新版本,客户端主动触发下载(无需开发者触发),下载失败(可能是网络原因等)后回调

onLaunch(() => {

console.log('App Launch')

const updateManager = wx.getUpdateManager()

updateManager.onCheckForUpdate(function (res) {

// 请求完新版本信息的回调

console.log('检查更新', res)

})

updateManager.onUpdateReady(function () {

wx.showModal({

title: '更新提示',

content: '新版本已经准备好,是否重启应用?',

success: function (res) {

if (res.confirm) {

// 新的版本已经下载好,调用 applyUpdate 应用新版本并重启

updateManager.applyUpdate()

}

},

})

})

updateManager.onUpdateFailed(function () {

// 新版本下载失败

console.log('更新失败')

})

})