title: UpdateManager.applyUpdate header: develop nav: api

sidebar: UpdateManager-applyUpdate

解释： 当新版本下载完成，调用该方法会强制当前小程序应用上新版本并重启

方法参数

无

示例

在开发者工具中预览效果

扫码体验

sidebar: UpdateManager-applyUpdate - 图1 请使用百度APP扫码

代码示例

  • 在 swan 文件中

    1. <view class="card-area">
    2.   <view class="top-description border-bottom">applyUpdate</view>
    3.   <button type="primary" bindtap="updateTap">button</button>   
    4. </view>

  • 在 js 文件中

    1. Page({
    2.   updateTap() {
    3.       const updateManager = swan.getUpdateManager();
    4.       updateManager.onCheckForUpdate(function (res) {
    5.           // 请求完新版本信息的回调
    6.           console.log("res", res.hasUpdate);
    7.           if(!res.hasUpdate){
    8.               swan.showModal({
    9.                   title: '更新提示',
    10.                   content: '无可用更新版本',
    11.               });
    12.           }
    13.       });
    15.       updateManager.onUpdateReady(function (res) {  
    16.           swan.showModal({
    17.               title: '更新提示',
    18.               content: '新版本已经准备好，是否重启应用？',
    19.               success(res) {
    20.                   if (res.confirm) {
    21.                       // 新的版本已经下载好，调用 applyUpdate 应用新版本并重启
    22.                       try {
    23.                           updateManager.applyUpdate();
    24.                       }
    25.                       catch(e) {
    26.                           swan.showToast({
    27.                               title: '更新提示',
    28.                               content: '应用新版本失败'
    29.                           });
    30.                       }
    31.                   }
    32.               }
    33.           });
    34.       });
    35.   }
    36. });

Bug & Tip

  • 检查更新操作由宿主APP在小程序冷启动时自动触发，不需由开发者主动触发，开发者只需监听检查结果即可。
  • onUpdateReady(callback) 回调结果说明：当宿主APP检查到小程序有新版本，会主动触发下载操作（无需开发者触发），当下载完成后，会通过 onUpdateReady 告知开发者。
  • onUpdateFailed(callback) 回调结果说明：当宿主APP检查到小程序有新版本，会主动触发下载操作（无需开发者触发），如果下载失败（可能是网络原因等），会通过 onUpdateFailed 告知开发者。
  • 当小程序新版本下载完成时（即收到 onUpdateReady 回调），可以通过此接口强制重启小程序并应用最新版本。
  • 当新版本未下载完成时，调用此接口将返回undefined；当新版本下载完成时，若接口调用失败，会抛出一个标准的Error对象。