微信小程序新版本更新强制提示

前端

2023-10-18 18:26:22

在微信小程序的开发过程中，新版本的发布通常不会立即生效。用户需要主动删除小程序并重新进入才能获取最新的版本。这可能会导致紧急修复或更新无法及时传达到用户手中。因此，本文将探讨如何在微信小程序发布新版本后强制提示用户更新。

用户更新机制

微信小程序的更新机制分为以下两种：

主动更新： 用户在小程序内点击“更新”按钮或重新进入小程序时触发更新。
被动更新： 微信后台定期检查小程序的版本，当检测到新版本时，会强制用户更新。

被动更新的频率通常较低，一般为几天或几周。因此，无法满足紧急更新的需求。

强制更新实现方案

为了强制用户更新小程序，需要使用微信提供的强制更新 API wx.setUpdateManager()。此 API 可以设置小程序的更新提示类型，包括：

update： 当小程序有新版本时，提示用户更新。
check： 只有当用户点击小程序内的“更新”按钮时，才提示更新。
none： 不提示更新。

通过将更新提示类型设置为 update，即可强制用户在小程序内看到更新提示。

代码实现

// 在小程序初始化时调用
wx.setUpdateManager({
  update: true,
  onCheckForUpdate: function (res) {
    if (res.hasUpdate) {
      // 有新版本，强制更新
      wx.showModal({
        title: '发现新版本',
        content: '已为您找到新版本，请立即更新以获取最新功能和修复',
        confirmText: '立即更新',
        success: function (res) {
          if (res.confirm) {
            wx.navigateTo({
              url: '/pages/update/update',
            });
          }
        }
      });
    }
  },
  onUpdateReady: function () {
    // 新版本已下载完成，提示用户重启
    wx.showModal({
      title: '更新完成',
      content: '新版本已下载完成，请重启小程序以生效',
      confirmText: '立即重启',
      success: function (res) {
        if (res.confirm) {
          // 重启小程序
          wx.reLaunch({
            url: '/pages/index/index',
          });
        }
      }
    });
  },
});