下载并解释更新描述符文件

在更新过程开始之前 ApplicationUpdater 对象调度 checkForUpdate 事件，紧接着 updater 就会尝试下载更新描述符文件。如果取消 checkForUpdate 事件的默认行为，则 updater 将不下载更新描述符文件。可以调用 checkForUpdate() 方法恢复更新过程： 

appUpdater.checkForUpdate();

调用 checkForUpdate() 方法会导致 updater 异步下载和解释更新描述符文件。作为调用 checkForUpdate() 方法的结果，updater 对象可以调度以下事件：

  • StatusUpdateEvent.UPDATE_STATUS — updater 已成功下载并解释更新描述符文件时调度此事件。此事件具有以下属性：

    • available — 一个布尔值。如果存在不同于当前应用程序的可用版本，则设置为 true ；否则（版本相同），设置为 false 。

    • version — 一个字符串。更新文件的应用程序描述符文件的版本

    • details — 一个数组。如果没有本地化版本的描述，则此数组会返回一个空字符串 ( "" ) 作为第一个元素，而将描述作为第二个元素。

      如果存在多个版本的描述（位于更新描述符文件中），则该数组包含多个子数组。每个数组包含两个元素：第一个元素为语言代码（例如 "en" ），第二个元素为该语言的相应描述（一个字符串）。请参阅 定义更新描述符文件并将 AIR 文件添加到 Web 服务器 。

  • StatusUpdateErrorEvent.UPDATE_ERROR — 存在错误，而且 updater 无法下载或解释更新描述符文件时调度此事件。