设置 delay 和 updateURL 属性值的配置文件所在的位置。针对确定更新过程中应用程序是否显示不同的确认对话框，它也具有相应设置。如果此属性指向不存在的文件，则调用 initialize() 方法将引发错误。

下面是一个示例配置文件：

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

不必加载配置文件，可以使用 ActionScript JavaScript 代码设置 ApplicationUpdaterUI 对象的以下属性：delay、isCheckForUpdateVisible、isDownloadProgressVisible、isDownloadUpdateVisible、isFileUpdateVisible、isInstallUpdateVisible 和 updateURL 属性。

另请参见

应用程序的当前版本。在调用 initialize() 方法的过程中设置此属性。将其设置为应用程序描述符文件中的版本。

定期检查新更新的间隔天数。

值为 0（默认值）时表示计时器未处于活动状态，因此不进行任何定期检查。可以通过此属性或通过配置文件设置延迟。使用这两种方法设置此值后，将使用以此属性设置的值。

默认值为 0.

另请参见

使“检查更新”、“没有更新”和“更新错误”对话框可见。设置为 true 时，updater 显示这些对话框作为更新过程的一部分。在更新配置文件中也可以设置此属性。使用此属性设置的值优先于更新配置文件中的设置。

使“下载更新”对话框可见。设置为 true 时，updater 显示此对话框作为更新过程的一部分。在更新配置文件中也可以设置此属性。使用此属性设置的值优先于更新配置文件中的设置。

使“下载更新”对话框可见。设置为 true 时，updater 显示这些对话框作为更新过程的一部分。在更新配置文件中也可以设置此属性。使用此属性设置的值优先于更新配置文件中的设置。

使“文件更新”、“文件没有更新”和“文件错误”对话框可见。设置为 true 时，updater 显示这些对话框作为更新过程的一部分。在更新配置文件中也可以设置此属性。使用此属性设置的值优先于更新配置文件中的设置。

这是否为成功更新之后的第一次运行，如果是，则为 (true)，否则为 (false)。updater 在调用 initialize() 方法的过程中设置此值。如果需要将数据从一个版本迁移到另一个版本，则开发人员应该核实 isFirstRun 已设置为 true。

另请参见

使“安装更新”对话框可见。设置为 true 时，updater 显示此对话框作为更新过程的一部分。在更新配置文件中也可以设置此属性。使用此属性设置的值优先于更新配置文件中的设置。

updater 执行版本比较所应该使用的函数。默认情况下，更新框架进行版本比较，以检测远程站点的版本是否比所安装应用程序的版本新。但是，有时默认的比较并不符合开发人员的版本控制方案。设置此属性可提供进行比较的新函数。

默认的比较函数接受类似 x.y.z 的版本，其中 x、y 和 z 可以包含字母和数字。默认的比较函数能够识别一些特殊情况。如果测试函数在版本字符串中找到 "alpha"、"beta" 或 "rc"，则顺序为 alpha < beta < rc。

使“意外错误”对话框可见。设置为 true 时，Application Updater 显示此对话框作为更新过程的一部分。在更新配置文件中也可以设置此属性。使用此属性设置的值优先于更新配置文件中的设置。

一个布尔型属性，更新正在运行时为 true，否则为 false。

定义用户界面所使用的语言环境链的数组。一般只有 JavaScript (HTML) 开发人员使用此属性。

Flex 开发人员可以使用 ResourceManager 处理语言环境链。

默认情况下，在基于 HTML 的应用程序中，在 Capabilities.languages 数组中的那些语言与用户界面支持的十种语言之间对语言进行排序。如果未找到匹配项，则用户界面使用英语。

下面的 JavaScript 示例使用 AIR SDK 中所含的 AIR HTML 本地化框架。它根据语言列表对语言进行排序，然后将英语设置为默认的备用语言：

appUpdater.addResources("ro_RO", {titleCheck: "Titlu", msgCheck: "Mesaj", btnCheck: "Buton"});
  appUpdater.addResources("hu", {titleCheck: "C?m", msgCheck: "?zenet"}); 
  var languages = ["ro", "hu"];
  languages = languages.concat(air.Capabilities.languages);
  var sortedLanguages = air.Localizer.sortLanguagesByPreference(languages, air.Capabilities.language, "en-US");  
  sortedLanguages.push("en-US");
  appUpdater.localeChain = sortedLanguages;

另请参见

应用程序存储目录的原有位置（如果更新之后该目录发生过更改）。进行含证书迁移的升级之后，应用程序存储目录位置将发生更改。如果不进行证书迁移，则用户更新应用程序时，应用程序存储目录不会发生更改。且将此属性设置为 null。在调用 initialize() 方法的过程中设置此属性。

如果开发人员用 ADT 打包 AIR 文件时使用 -migrate 选项，则该开发人员可以用新的证书为 AIR 应用程序的新版本签名。如果 AIR 应用程序的新版本使用新的签名证书，则用户安装新版本时，应用程序的本地存储目录将发生更改。使用此属性将数据从旧的应用程序存储目录转移到新的应用程序存储目录 (File.applicationStorageDirectory)。有关详细信息，请参阅《Adobe AIR 开发人员指南》中“使用命令行工具创建 AIR 应用程序”一章的“为 AIR 文件签名以更改应用程序证书”。

应用程序的原有版本。在调用 initialize() 方法的过程中设置此属性。返回升级之前应用程序的原有版本（仅当 isfirstRun 为 true 时设置）；否则将其设置为 null。

从更新 URL 下载的更新描述符文件的内容。只有在 updater 对象调度 updateStatus 事件之后，此属性才为非 null。

更新描述符文件的位置。可以接受对 URLRequest 路径有效的任何位置。这是 updater 所需的唯一一个必要设置。可以通过此属性或通过配置文件来设置更新 URL。使用这两种方法设置此值后，updater 将使用以此属性设置的值。

另请参见

是否有被推迟的更新（即使其未能安装），如果有，则为 (true)；否则为 false。updater 在调用 initialize() 方法的过程中设置此属性。使用 wasPendingUpdate 和 isFirstRun 属性检查更新是否未能安装（这种情况下 wasPendingUpdate 设置为 true，且 isFirstRun 设置为 false）。

另请参见

构造函数。

为指定语言动态添加新的资源束。JavaScript 开发人员使用此方法为应用程序 updater UI 显示的对话框动态添加新语言。（Flex 开发人员可以直接将新语言添加到“ApplicationUpdaterDialogs”资源束中。）

参数

另请参见

取消更新过程。调用此方法将取消所有未处理的下载，删除所有不完整的下载文件，以及重新启动定期检查计时器。

除状态机处于“uninitialized”或“initializing”状态之外的任何时候都可以取消更新过程。在“uninitialized”或“initializing”状态下调用此方法时，它不会执行任何操作。

启动更新过程。调用此方法不会使定期检查计时器停止；但是，此方法可以检测出更新过程正在运行中，并将跳过当前遍历。

只有当前状态为“Ready”时此方法才会执行。

此方法可能导致 updater 对象调度以下事件：

初始化 updater。调用此方法可执行以下操作：

1. 它将初始化更新框架，以静默方式同步安装所有未处理的更新。由于此方法可能会重新启动应用程序，因此在应用程序启动过程中应该调用此方法。

2. 它检查是否有被推迟的更新，如果有将安装该更新。

3. 如果前一次更新有错误，则它将从存储区域中清除更新文件和版本信息。

4. 如果定期检查计时器延迟已到期，则它将启动更新过程；否则它将启动定期检查计时器。但是，在使用 AIR Debug Launcher (ADL) 应用程序测试某个应用程序时，尝试更新应用程序会导致 IllegalOperationError 异常。

使用本地 AIR 文件启动更新过程。

如果正在运行更新过程，则调用此方法不起作用（如果状态不是 "Downloaded"）。

对于在应用程序描述符文件中将 customUpdateUI 元素设置为 true 的应用程序，此函数很有用。

参数

调用 installUpdate() 方法之后，恰好在安装更新之前将调度此事件。某些情况下，最好在此时阻止更新的安装，这是因为运行时退出应用程序以安装更新时，用户可能会丢失所有当前工作。

调用此事件的 preventDefault() 方法可将安装推迟到下一次重新启动。如果调用 preventDefault() 方法，则在此应用程序会话过程中不能再启动其它更新过程（通过调用 installUpdate() 方法或因定期检查）。

此事件具有以下属性：

升级过程开始之前，恰好在 updater 尝试下载更新描述符文件之前将调度此事件。updater 调度此事件的原因可以是直接调用 checkNow() 方法或定期检查计时器到期。

此事件具有以下属性：

更新文件下载完毕时将调度此事件。

此事件具有以下属性：

如果在连接或下载更新文件时出错，将调度此事件。HTTP 状态无效（如“404 - 找不到文件”）时，也会调度此事件。

调度此事件时，定期检查计时器将自动重新启动（如果延迟大于 0）。

DownloadErrorEvent 对象的 errorID 属性是一个整数，用于定义错误信息（请参阅下表）。此外，还具有另一个属性 subErrorID，该属性可能包含更多错误信息。

调用 downloadUpdate() 方法并建立到服务器的连接之后将调度此事件。使用 ApplicationUpdater 库时，可能希望此事件的事件处理函数显示进度栏，从而向用户报告下载进度。

此事件具有以下属性：

初始化过程中或更新过程中出错时（如果发生某种意外情况），将调度此事件。

此事件具有以下属性：

验证调用 installFromAIRFile() 方法过程中作为 airFile 参数传递的文件时，若出错，将调度此事件。

updater 对调用 installFromAIRFile() 方法过程中的文件验证成功后，将调度此事件。

此事件具有以下属性：

初始化完成之后，将调度此事件。

此事件具有以下只读属性：

• isFirstRun（布尔型）如果这是成功更新之后的第一次运行，则为 true，否则为 false。

• previousVersion（字符串）应用程序在升级之前的原有版本（仅在 isfirstRun 为 true 时设置）。

• currentVersion（字符串）当前安装版本的应用程序描述符文件中的版本。

此事件具有以下属性：

初始化完成之后，将调度此事件。

此事件具有以下属性：

如果尝试下载或分析更新描述符文件时出错，将调度此事件。

updater 调度此事件时，定期检查计时器将自动重新启动（如果延迟设置大于 0）。updater 调度新的 checkForUpdate 事件时，应用程序应考虑隐藏所有错误对话框。

updater 成功下载并解释更新描述符文件之后，将调度此事件。

此事件具有以下属性：