下载更新 AIR 文件

updater 成功下载并解释更新描述符文件之后,ApplicationUpdater 对象将调度 updateStatus 事件。默认行为是开始下载更新文件(如果可用)。如果取消默认行为,则可以调用 downloadUpdate() 方法恢复更新过程:

appUpdater.downloadUpdate();

调用此方法会导致 updater 异步下载 AIR 文件的更新版本。

downloadUpdate() 方法可以调度以下事件:

  • UpdateEvent.DOWNLOAD_START — 建立到服务器的连接时调度此事件。在使用 ApplicationUpdaterUI 库时,此事件将显示带有进度栏的对话框以对下载进度进行跟踪。

  • ProgressEvent.PROGRESS — 根据文件下载进度定期调度此事件。

  • DownloadErrorEvent.DOWNLOAD_ERROR — 如果在连接或下载更新文件时出现错误,则调度此事件。HTTP 状态无效时也会调度此事件(例如“404 - File not found”(404 - 找不到文件))。此事件具有 errorID 属性,该属性为定义其他错误信息的整数。此外,还具有另一个属性 subErrorID ,该属性可能包含更多错误信息。

  • UpdateEvent.DOWNLOAD_COMPLETE — updater 已成功下载并解释更新描述符文件时调度此事件。如果不取消此事件,则 ApplicationUpdater 版本会继续安装更新版本。在 ApplicationUpdaterUI 版本中,向用户显示为其提供选项的对话框以继续操作。