坚果大叔 坚果大叔
  • 首页
  • 闲言碎语
  • 技术
  • 生活
  • 记录
  • 朋友
  • 热点新闻
  • 常用代码
  • 工具箱
  • 关于
首页 › 技术 › 微信小程序发布新版本,如何提示强制更新!

微信小程序发布新版本,如何提示强制更新!

坚果大叔
2021-05-20 20:03:00技术阅读 4,045

前提

小程序在更新版本后,如果没有主动删除小程序再进入,那么小程序还是用的旧版本代码,无法更新最新版本。这样如果有紧急问题修复上线,用户却不能第一时间强制更新。

解决办法

官方提供了 UpdateManager 更新管理器对象,用来检测是否有新的版本发布。

UpdateManager 对象提供以下四种方法:

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

UpdateManager.onCheckForUpdate(function callback)
监听向微信后台请求检查更新结果事件。微信在小程序冷启动时自动检查更新,不需由开发者主动触发。

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

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

官方示例代码:

const updateManager = wx.getUpdateManager()

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

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

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

官方提供的demo中,只有最基本的更新提示,并未做异常处理。而且官方也说了这个功能从基础库 1.9.90 开始支持,低版本需做兼容处理。

另外,如果当前版本更新有重大调整,一定需要用户更新,有两种情况:

第一种方法是可以在用户点击取消的回调中给出提示,并重新进入版本提示流程。

第二种方法就是去除取消按钮,只有确定按钮。强制用户必须升级,才能继续使用。

改进后代码如下:

/**
 * 检测当前的小程序
 * 是否是最新版本,是否需要下载、更新
 */
function checkUpdateVersion() {
  //判断微信版本是否 兼容小程序更新机制API的使用
  if (wx.canIUse('getUpdateManager')) {
    const updateManager = wx.getUpdateManager();
    //检测版本更新
    updateManager.onCheckForUpdate(function (res) {
      if (res.hasUpdate) {
        updateManager.onUpdateReady(function () {
          wx.showModal({
            title: '温馨提示',
            content: '检测到新版本,是否重启小程序?',
            showCancel: false,
            success: function (res) {
              if (res.confirm) {
                // 新的版本已经下载好,调用 applyUpdate 应用新版本并重启
                updateManager.applyUpdate()
              }
            }
          })
        })
        updateManager.onUpdateFailed(function () {
          // 新版本下载失败
          wx.showModal({
            title: '已有新版本',
            content: '请您删除小程序,重新搜索进入',
          })
        })
      }
    })
  } else {
    wx.showModal({
      title: '溫馨提示',
      content: '当前微信版本过低,无法使用该功能,请升级到最新微信版本后重试。'
    })
  }
}

module.exports = {
  checkUpdateVersion
}

在 app.js 的 onLaunch 方法中增加引入检查方法

// 版本自动更新代码
 check.checkUpdateVersion()

如何测试?

注意:

微信开发者工具上可以通过「编译模式」下的「下次编译模拟更新」开关来调试

小程序开发版/体验版没有「版本」概念,所以无法在开发版/体验版上测试更版本更新情况

微信小程序发布新版本,如何提示强制更新!-坚果大叔

小程序
赞赏 赞(3)
本文系作者 @坚果大叔 原创发布在 坚果大叔。未经许可,禁止转载。
周末,去太湖。
上一篇
超简单!两步实现Wordpress评论微信通知~
下一篇
在小程序中查看

评论已关闭

搜你想看的
聚合文章
PC微信多开和防撤回~
Vue3 Ref获取节点返回顺序不一致。
Mac 如何安装mongoDB
已经六月了,今年又过去了一半。
闲言碎语
Memos
Nuxt3中piana持久化处理!
2025-06-22 18:45:45
435 0 1
npm install 出现 Error:EISDIR:illegal operation on a directory 的错误提示!
2025-03-31 19:02:11
948 0 0
iphone 利用 Scriptable 添加网上国网电费小组件
2025-01-06 20:40:20
7,405 2
在博客中加上memos记录展示。
2024-12-25 23:41:27
3,735 3
3
  • 3
博主

一位佛系的前端开发者,略通摄影,乐于尝试新事物,热衷于美食。

友链
故事胶片
公众号
坚果大叔 执行上下文 卖坚果的怪叔叔 Dacking
Copyright © 2017-2025 坚果大叔

开往-友链接力

萌ICP备20230818号

苏ICP备18048410号-3
  • 首页
  • 闲言碎语
  • 技术
  • 生活
  • 记录
  • 朋友
  • 热点新闻
  • 常用代码
  • 工具箱
  • 关于
# CSS # # JavaScript # # vue # # 微信 # # 生活 #
坚果大叔
321
文章
134
评论
374
喜欢