基础库 或更高版本; 且 支付宝客户端 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 方法去注册的监听也会被触发。