更新配置文件为 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。