在 XML 配置文件中定义更新设置

更新配置文件为 XML 文件。它可能包含以下元素:

  • updateURL — 字符串。表示更新描述符在远程服务器上的位置。允许使用任何有效的 URLRequest 位置。您必须定义 updateURL 属性,可以通过配置文件也可以通过脚本进行定义(请参阅 定义更新描述符文件并将 AIR 文件添加到 Web 服务器 )。只有在首先定义此属性后才能使用 updater(在调用 updater 对象的 initialize() 方法之前,在 初始化更新框架 中进行了说明)。

  • delay — 一个数字。表示以天为单位表示用于检查更新的时间间隔(允许使用 0.25 等数值)。值 0(这是默认值)指定该 updater 不执行自动定期检查。

ApplicationUpdaterUI 的配置文件除了包含 updateURL delay 元素之外,还可包含以下元素:

  • defaultUI dialog 元素的列表。每个 dialog 元素都具有与用户界面中的对话框对应的 name 属性。每个 dialog 元素都具有定义该对话框是否可见的 visible 属性。默认值为 true name 属性的可能值如下所示:

    • "checkForUpdate" — 与“检查更新”、“没有更新”和“更新错误”对话框相对应

    • "downloadUpdate" — 与“下载更新”对话框相对应

    • "downloadProgress" — 与“下载进度”和“下载错误”对话框相对应

    • "installUpdate" — 与“安装更新”对话框相对应

    • "fileUpdate" — 与“文件更新”、“文件没有更新”和“文件错误”对话框相对应

  • "unexpectedError" — 与“意外错误”对话框相对应

    在设置为 false 时,对应的对话框不作为更新过程的一部分进行显示。

下面是 ApplicationUpdater 框架的配置文件的一个示例:

<?xml version="1.0" encoding="utf-8"?> 
<configuration xmlns="http://ns.adobe.com/air/framework/update/configuration/1.0"> 
      <url>http://example.com/updates/update.xml</url> 
      <delay>1</delay> 
</configuration>

下面是 ApplicationUpdaterUI 框架的配置文件的一个示例,其中包括 defaultUI 元素的定义:

<?xml version="1.0" encoding="utf-8"?> 
<configuration xmlns="http://ns.adobe.com/air/framework/update/configuration/1.0"> 
      <url>http://example.com/updates/update.xml</url> 
      <delay>1</delay> 
      <defaultUI> 
         <dialog name="checkForUpdate" visible="false" /> 
         <dialog name="downloadUpdate" visible="false" /> 
         <dialog name="downloadProgress" visible="false" /> 
      </defaultUI> 
</configuration>

configurationFile 属性指定为该文件的位置:

ActionScript 示例:

appUpdater.configurationFile = new File("app:/cfg/updateConfig.xml");
JavaScript 示例:
appUpdater.configurationFile = new air.File("app:/cfg/updateConfig.xml");

更新框架的模板目录包括一个示例配置文件 config-template.xml。