UpdateManager.applyUpdate
收藏
我的收藏

基础库 1.9.0 开始支持本方法,这是一个异步方法。

当小程序新版本下载完成(即收到 onUpdateReady 回调)时,调用该方法会强制应用新版本并重启。

前提条件
业务背景
使用限制
注意事项
支持沙盒
相关教程

语法

UpdateManager.applyUpdate(options)

参数说明

options 为 object 类型,属性如下:

属性名类型默认值必填说明最低支持版本
successfunction
接口调用成功的回调函数
1.9.0
failfunction
接口调用失败的回调函数
1.9.0
completefunction
接口调用结束的回调函数(调用成功、失败都会执行)
1.9.0

回调成功

object 类型,属性如下:

属性名类型说明最低支持版本
errMsgstring
"UpdateManager.applyUpdate:ok"
1.9.0

回调失败

object 类型,属性如下:

属性名类型说明最低支持版本
errMsgstring
"UpdateManager.applyUpdate:fail" + 详细错误信息
1.9.0

扫码体验

请使用字节宿主APP扫码

代码示例

开发者工具中预览

Page({ onLoad() { const updateManager = tt.getUpdateManager(); updateManager.onUpdateReady((res) => { tt.showModal({ title: "更新提示", content: "新版本已经准备好,是否重启小程序?", success: (res) => { if (res.confirm) { // 新的版本已经下载好,调用 applyUpdate 应用新版本并重启 updateManager.applyUpdate(); } }, }); }); }, });