UpdateManager
基础库 2.6.0 开始支持,低版本需做兼容处理
UpdateManager 对象,用来管理更新,可通过 bl.getUpdateManager 接口获取实例。
方法
UpdateManager.applyUpdate()
强制小游戏重启并使用新版本。在小游戏新版本下载完成后(即收到 onUpdateReady
回调)调用。
UpdateManager.onCheckForUpdate(function callback)
监听向后台请求检查更新结果事件。在小游戏冷启动时自动检查更新,不需由开发者主动触发。
UpdateManager.onUpdateReady(function callback)
监听小游戏有版本更新事件。客户端主动触发下载(无需开发者触发),下载成功后回调
UpdateManager.onUpdateFailed(function callback)
监听小游戏更新失败事件。小游戏有新版本,客户端主动触发下载(无需开发者触发),下载失败(可能是网络原因等)后回调
示例代码
const updateManager = bl.getUpdateManager();
updateManager.onCheckForUpdate(function(res) {
// 请求完新版本信息的回调
console.log(res.hasUpdate);
});
updateManager.onUpdateReady(function() {
bl.showModal({
title: "更新提示",
content: "新版本已经准备好,是否重启应用?",
success: function(res) {
if (res.confirm) {
// 新的版本已经下载好,调用 applyUpdate 应用新版本并重启
updateManager.applyUpdate();
}
}
});
});
updateManager.onUpdateFailed(function() {
// 新版本下载失败
});
Tips
小游戏开发版/体验版没有「版本」概念,所以无法在开发版/体验版上测试更版本更新情况