UpdateManager

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


方法列表

updateManager.onCheckForUpdate(callback)

监听向小程序服务请求检查更新结果事件。该方法会在小程序冷启动时自动检查更新。

该方法的唯一参数callback是一个function类型的回调方法,该回调方法会有一个object类型的实参,具体包括的属性如下:

属性类型说明
hasUpdateboolean是否需要更新

updateManager.onUpdateReady(callback)

当前小程序存在更新包,且更新包异步下载成功后的回调。

该方法的唯一参数callback是一个function类型的回调方法,该回调方法无实参。

updateManager.onUpdateFailed(callback)

当前小程序存在更新包,但更新包异步下载失败时的回调。

该方法的唯一参数callback是一个function类型的回调方法,该回调方法无实参。

updateManager.applyUpdate()

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


代码示例

const updateManager = tt.getUpdateManager();

updateManager.onCheckForUpdate(function(res) {
  // 请求完新版本信息的回调
  console.log("onCheckForUpdate", res.hasUpdate);
  if (res.hasUpdate) {
    tt.showToast({
      title: "即将有更新请留意"
    });
  }
});

updateManager.onUpdateReady(() => {
  tt.showModal({
    title: "更新提示",
    content: "新版本已经准备好,是否立即使用?",
    success: function(res) {
      if (res.confirm) {
        // 调用 applyUpdate 应用新版本并重启
        updateManager.applyUpdate();
      } else {
        tt.showToast({
          icon: "none",
          title: "小程序下一次「冷启动」时会使用新版本"
        });
      }
    }
  });
});

updateManager.onUpdateFailed(() => {
  tt.showToast({
    title: "更新失败,下次启动继续..."
  });
});
点击纠错