# UpdateManager ### UpdateManager UpdateManager 對象，用來管理更新，可通過 [wx.getUpdateManager](/read/wechat-game-api/327.md) 接口獲取實例。 #### 方法 ##### UpdateManager.applyUpdate() 當小程序新版本下載完成后（即收到 `onUpdateReady` 回調），強制小程序重啟并使用新版本 ##### UpdateManager.onCheckForUpdate(function callback) 監聽向微信后臺請求檢查更新結果事件。微信在小程序冷啟動時自動檢查更新，不需由開發者主動觸發。 ##### UpdateManager.onUpdateReady(function callback) 監聽小程序有版本更新事件。客戶端主動觸發下載（無需開發者觸發），下載成功后回調 ##### UpdateManager.onUpdateFailed(function callback) 監聽小程序更新失敗事件。小程序有新版本，客戶端主動觸發下載（無需開發者觸發），下載失敗（可能是網絡原因等）后回調 #### 示例代碼 ``` <pre class="prettyprint"><ol class="linenums"><li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="kwd">const</span><span class="pln"> updateManager </span><span class="pun">=</span><span class="pln"> wx</span><span class="pun">.</span><span class="pln">getUpdateManager</span><span class="pun">()</span></code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"></code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln">updateManager</span><span class="pun">.</span><span class="pln">onCheckForUpdate</span><span class="pun">(</span><span class="hljs-params"><span class="kwd">function</span></span><span class="pln"> </span><span class="pun">(</span><span class="hljs-params"><span class="pln">res</span></span><span class="pun">)</span><span class="pln"> </span><span class="pun">{</span></code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> </span><span class="com">// 請求完新版本信息的回調</span></code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> console</span><span class="pun">.</span><span class="pln">log</span><span class="pun">(</span><span class="pln">res</span><span class="pun">.</span><span class="pln">hasUpdate</span><span class="pun">)</span></code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pun">})</span></code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"></code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln">updateManager</span><span class="pun">.</span><span class="pln">onUpdateReady</span><span class="pun">(</span><span class="hljs-params"><span class="kwd">function</span></span><span class="pln"> </span><span class="pun">(</span><span class="hljs-params"></span><span class="pun">)</span><span class="pln"> </span><span class="pun">{</span></code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> wx</span><span class="pun">.</span><span class="pln">showModal</span><span class="pun">({</span></code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> title</span><span class="pun">:</span><span class="pln"> </span><span class="str">'更新提示'</span><span class="pun">,</span></code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> content</span><span class="pun">:</span><span class="pln"> </span><span class="str">'新版本已經準備好，是否重啟應用？'</span><span class="pun">,</span></code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> success</span><span class="pun">:</span><span class="pln"> </span><span class="hljs-params"><span class="kwd">function</span></span><span class="pln"> </span><span class="pun">(</span><span class="hljs-params"><span class="pln">res</span></span><span class="pun">)</span><span class="pln"> </span><span class="pun">{</span></code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> </span><span class="kwd">if</span><span class="pln"> </span><span class="pun">(</span><span class="pln">res</span><span class="pun">.</span><span class="pln">confirm</span><span class="pun">)</span><span class="pln"> </span><span class="pun">{</span></code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> </span><span class="com">// 新的版本已經下載好，調用 applyUpdate 應用新版本并重啟</span></code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> updateManager</span><span class="pun">.</span><span class="pln">applyUpdate</span><span class="pun">()</span></code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> </span><span class="pun">}</span></code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> </span><span class="pun">}</span></code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> </span><span class="pun">})</span></code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pun">})</span></code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"></code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln">updateManager</span><span class="pun">.</span><span class="pln">onUpdateFailed</span><span class="pun">(</span><span class="hljs-params"><span class="kwd">function</span></span><span class="pln"> </span><span class="pun">(</span><span class="hljs-params"></span><span class="pun">)</span><span class="pln"> </span><span class="pun">{</span></code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> </span><span class="com">// 新版本下載失敗</span></code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pun">})</span></code></li> </ol> ``` #### Tips - 微信開發者工具上可以通過「編譯模式」下的「下次編譯模擬更新」開關來調試 - 小程序開發版/體驗版沒有「版本」概念，所以無法在開發版/體驗版上測試更版本更新情況 > 原文: <https://developers.weixin.qq.com/minigame/dev/api/update/UpdateManager.html>