UpdateManager

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

方法

UpdateManager.applyUpdate()

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

UpdateManager.onCheckForUpdate(function callback)

监听向微信后台请求检查更新结果事件。微信在小程序冷启动时自动检查更新，不需由开发者主动触发。

UpdateManager.onUpdateReady(function callback)

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

UpdateManager.onUpdateFailed(function callback)

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

示例代码

  1. const updateManager = wx.getUpdateManager()
  3. updateManager.onCheckForUpdate(function (res) {
  4.   // 请求完新版本信息的回调
  5.   console.log(res.hasUpdate)
  6. })
  8. updateManager.onUpdateReady(function () {
  9.   wx.showModal({
  10.     title: '更新提示',
  11.     content: '新版本已经准备好，是否重启应用？',
  12.     success: function (res) {
  13.       if (res.confirm) {
  14.         // 新的版本已经下载好，调用 applyUpdate 应用新版本并重启
  15.         updateManager.applyUpdate()
  16.       }
  17.     }
  18.   })
  19. })
  21. updateManager.onUpdateFailed(function () {
  22.   // 新版本下载失败
  23. })

Tips

  • 微信开发者工具上可以通过「编译模式」下的「下次编译模拟更新」开关来调试
  • 小程序开发版/体验版没有「版本」概念，所以无法在开发版/体验版上测试更版本更新情况