Uniapp 之小程序版本更新检查——uni.getUpdateManager()

在开发小程序的时候，版本更新在所难免。所以，我们希望每次打开的小程序的时候，都可以进行版本检测。如果有新版本，那么，就更新，并且让用户能够重启，并应用新版本。

实现

开门见山，uni-app官方网站给了我们实现方法。以下是代码示例。

const updateManager = uni.getUpdateManager();

updateManager.onCheckForUpdate(function (res) {
  // 请求完新版本信息的回调
  console.log(res.hasUpdate);
});

updateManager.onUpdateReady(function (res) {
  uni.showModal({
    title: '更新提示',
    content: '新版本已经准备好，是否重启应用？',
    success(res) {
      if (res.confirm) {
        // 新的版本已经下载好，调用 applyUpdate 应用新版本并重启
        updateManager.applyUpdate();
      }
    }
  });

});

updateManager.onUpdateFailed(function (res) {
  // 新的版本下载失败
});

根据实例，我把代码封装在一个方法里。

 然后，根据场景，每次打开小程序 = 当小程序启动，或者小程序从后台进入前台 = 生命周期 onShow 。所以，在App.vue 的onShow函数下添加方法。当然，如果对更新要求不那么实时，也可以选在在onLaunch生命周期下执行。后文会详述其区别。

uni.getUpdateManger()说明

官方给的示例代码中中用到了uni.getUpdateManger() 是什么鬼？

这个API返回的是全局唯一的版本更新管理器对象： updateManage ， 用于管理小程序更新。

平台差异

APP	H5	微信小程序	支付宝小程序	百度小程序	字节跳动小程序	QQ小程序
×	×	√	√	√	√	√

updateManager对象的方法列表

方法	参数	说明
onCheckForUpdate	callback	当向小程序后台请求完新版本信息，会进行回调
onUpdateReady	callback	当新版本下载完成，会进行回调
onUpdateFailed	callback	当新版本下载失败，会进行回调
applyUpdate		当新版本下载完成，调用该方法会强制当前小程序应用上新版本并重启

onCheckForUpdate(callback) 回调结果说明

属性	类型	说明
hasUpdate	Boolean	是否有新的版本

知识点

知识点1

当用户离开小程序时，小程序并没有直接销毁，而是进入了后台，当用户再次进入小程序时，又会从后台进入前台。

只有当小程序进入后台一定时间后者系统资源占用过高，才会被真正的销毁。

知识点2

小程序启动分为“热启动”和“冷启动”。

• 热启动指的是小程序打开后，在一段时间内（目前：5分钟）再次被打卡，此时将后台小程序切换到前台。对应方法onShow。
• 冷启动指的是小程序首次打开或销毁后再次被打卡，对应函数onLaunch。

知识点3

• 冷启动时，如果发现有新版本，将会异步下载新版本的代码包，并同时用客户端本地的包进行启动，即新版本的小程序需要等下一次冷启动才会应用上。
• 如果希望冷启动后马上使用最新版本，在App 的onLaunch生命周期中，调用用版本资源管理器uni.getUpdateManger()方法。
• 同理，希望每次打开小程序，都检测更新，就使用onShow。

这样看来，用代码小程序中更新的方法不是必须的，就看你对版本更新的时效要求了。

知识点4

OnLaunch时间触发在Onshow之前。

知识点5

在开发版和体验版无法检查版本更新。需要在开发者工具里，编译时选择“模拟更新编译”。

打开方法。1)点击菜单栏的添加编译模式。2.勾选下次编译时模拟更新。

参考网址

https://uniapp.dcloud.io/api/other/update?id=getupdatemanager

https://www.jianshu.com/p/ff711136544a