HomeDocs
跳到主要内容

UpdateManager

简介

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

方法

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

UpdateManager.onCheckForUpdate(function listener)
监听向后台请求检查更新结果事件。在小程序每次启动(包括热启动)时自动检查更新,不需由开发者主动触发。

UpdateManager.onUpdateReady(function listener)
监听小程序有版本更新事件。客户端主动触发下载(无需开发者触发),下载成功后回调

UpdateManager.onUpdateFailed(function listener) 监听小程序更新失败事件。小程序有新版本,客户端主动触发下载(无需开发者触发),下载失败(可能是网络原因等)后回调

UpdateManager.forceUpdateAppInfo()
主动发起 AppInfo 请求,获取到更新结果信息

UpdateManager.downloadNew() 主动发起下载小程序最新包。在主动发起 AppInfo 请求后使用有效,即 UpdateManager.forceUpdateAppInfo()

示例代码

const updateManager = dlt.getUpdateManager();

// 1. 自动化更新流程
updateManager.onCheckForUpdate(function (res) {
// 请求完新版本信息的回调
console.log(res.hasUpdate);
});

updateManager.onUpdateReady(function () {
dlt.showModal({
title: '更新提示',
content: '新版本已经准备好,是否重启应用?',
success: function (res) {
if (res.confirm) {
// 新的版本已经下载好,调用 applyUpdate 应用新版本并重启
updateManager.applyUpdate();
}
},
});
});

updateManager.onUpdateFailed(function () {
// 新版本下载失败
});

// 2. 主动发起更新流程
updateManager.forceUpdateAppInfo({
success: (res) => {
// 检查是否有新版本更新
if (res.hasUpdate) {
// 主动发起下载最新小程序包
updateManager.downloadNew({
success: (res) => {
if (res.hasReady) {
dlt.showModal({
title: '更新提示',
content: '新版本已经准备好,是否重启应用?',
success: function (res) {
if (res.confirm) {
// 新的版本已经下载好,调用 applyUpdate 应用新版本并重启
updateManager.applyUpdate();
}
},
});
}
},
fail: (res) => {},
complete: (res) => {},
});
}
},
fail: (res) => {},
complete: (res) => {},
});
Privacy agreementDeveloper agreementcontact us: developer_service.mi@transsion.com © 2024 MiniApp. All Rights Reserved.