js微信小程序-版本更新管理器wx.getUpdateManager()、UpdateManager

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: '当前微信版本过低，无法使用该功能，请升级到最新微信版本后重试。'
      })
    }
  }
})
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50

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