微信小程序API getUpdateManager

2018-03-23 14:52 更新

wx.getUpdateManager()


基礎(chǔ)庫 1.9.90 開始支持,低版本需做兼容處理

獲取全局唯一的版本更新管理器,用于管理小程序更新。

關(guān)于小程序的更新機制,可以查看 運行機制 文檔。

updateManager


updateManager 對象的方法列表:

方法 參數(shù) 說明
onCheckForUpdate callback 當向微信后臺請求完新版本信息,會進行回調(diào)
onUpdateReady callback 當新版本下載完成,會進行回調(diào)
onUpdateFailed callback 當新版本下載失敗,會進行回調(diào)
applyUpdate 當新版本下載完成,調(diào)用該方法會強制當前小程序應(yīng)用上新版本并重啟

onCheckForUpdate(callback) 回調(diào)結(jié)果說明:

屬性 類型 說明
hasUpdate Boolean 是否有新的版本

注: 檢查更新操作由微信在小程序冷啟動時自動觸發(fā),不需由開發(fā)者主動觸發(fā),開發(fā)者只需監(jiān)聽檢查結(jié)果即可。

onUpdateReady(callback) 回調(diào)結(jié)果說明:

當微信檢查到小程序有新版本,會主動觸發(fā)下載操作(無需開發(fā)者觸發(fā)),當下載完成后,會通過 onUpdateReady 告知開發(fā)者。

onUpdateFailed(callback) 回調(diào)結(jié)果說明:

當微信檢查到小程序有新版本,會主動觸發(fā)下載操作(無需開發(fā)者觸發(fā)),如果下載失?。赡苁蔷W(wǎng)絡(luò)原因等),會通過 onUpdateFailed 告知開發(fā)者。

applyUpdate() 說明:

當小程序新版本已經(jīng)下載時(即收到 onUpdateReady 回調(diào)),可以通過這個方法強制重啟小程序并應(yīng)用上最新版本。

示例代碼:

const updateManager = wx.getUpdateManager()

updateManager.onCheckForUpdate(function (res) {
  // 請求完新版本信息的回調(diào)
  console.log(res.hasUpdate)
})

updateManager.onUpdateReady(function () {
  // 新的版本已經(jīng)下載好,調(diào)用 applyUpdate 應(yīng)用新版本并重啟
  updateManager.applyUpdate()
})

updateManager.onUpdateFailed(function () {
  // 新的版本下載失敗
})
以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號