开发者社区
社区提问意见反馈
开发者钉组织
扫描二维码
加入支付宝开发者钉组织
基础 api
基础
应用级事件
界面
跳转
多媒体
缓存
文件
位置
网络
设备
worker
数据安全
分享
收藏
自定义通用菜单
更新管理
updatemanager
web-view组件控制
升级支付宝最新版本
隐私信息授权
小程序广告
开放能力 api
开发 > api > 基础 api > 更新管理 > updatemanager > updatemanager 概览
评论
收藏
我的文档
设置

基础库  或更高版本; 且 支付宝客户端 10.1.32 或更高版本; 若版本较低,建议采取 兼容处理

主体: 企业支付宝小程序个人支付宝小程序

updatemanager 对象,用来管理更新,可通过 my.getupdatemanager api 获取实例。

使用场景

小程序上架迭代版本时,出于小程序 更新机制 的限制,用户可能无法及时更新到最新版本。updatemanager 赋予开发者更加及时主动控制版本更新的能力。

方法

名称 类型 功能说明
updatemanager.applyupdate function

用于小程序新版本下载完成(即收到 onupdateready 回调)后提示用户重启小程序以使用新版本。

updatemanager.oncheckforupdate function

监听向支付宝后台请求检查更新结果事件。

updatemanager.onupdateready function

监听小程序有版本更新事件。

updatemanager.onupdatefailed function

监听小程序更新失败事件。

完整的监听小程序更新代码
app({
  onlaunch(options) {
    const updatemanager = my.getupdatemanager();
    updatemanager.oncheckforupdate(function (res) {
      // 检查更新结果
      console.log(res.hasupdate);
    });
    updatemanager.onupdateready(function () {
      my.confirm({
        title: '更新提示',
        content: '新版本已经准备好,是否重启应用?',
        success: function (res) {
          if (res.confirm) {
            // 新版本已经下载好,调用 applyupdate 应用新版本并重启
            updatemanager.applyupdate();
          }
        },
      });
    });
    updatemanager.onupdatefailed(function () {
      // 新版本下载失败
    });
  }
})
  • tip
    更新管理系列 api 注册太晚可能会导致监听不到小程序下载新版本,因此请在 app.onlaunch 等较早执行的生命周期里执行。
  • tip

    在小程序的生命周期中,版本更新的 update 事件只会触发一次。

    只要 update 事件被触发过,后续使用 updatemanager 的 oncheckforupdate 方法去注册的监听也会被触发。

内容没有解决您的问题?您还可以前往 或 寻求帮助
凯发k8官方网娱乐官方 copyright © 2022 支付宝(杭州)信息技术有限公司  | icp证浙b2-20160559
该文档对你是否有帮助?
当前页面目录
网站地图