air.update.eventsStatusUpdateEvent 在更新程序成功下载并解释更新描述符文件之后,Updater 对象将调度 StatusUpdateEvent 对象。air.update.events:UpdateEvent 在更新程序成功下载并解释更新描述符文件之后,Updater 对象将调度 StatusUpdateEvent 对象。

如果将 StatusUpdateEvent 对象的 available 属性设置为 true,则默认行为是开始下载更新。只有在使用 ApplicationUpdater 类时才能阻止默认行为。

air.update.ApplicationUpdaterair.update.ApplicationUpdaterUIupdateStatusair.update.events:StatusUpdateEvent:UPDATE_STATUSair.update.events:StatusUpdateEventStatusUpdateEvent 构造函数。typeString 事件的类型。事件侦听器可以通过继承的 type 属性访问此信息。只有一种类型的 error 事件:ErrorEvent.ERRORbubblesBooleanfalse确定 Event 对象是否冒泡。事件侦听器可以通过继承的 bubbles 属性访问此信息。 cancelableBooleanfalse确定是否可以取消 Event 对象。事件侦听器可以通过继承的 cancelable 属性访问此信息。 availableBooleanfalse要显示为错误消息的文本。事件侦听器可以通过 text 属性访问此信息。 versionString要与特定错误关联的引用数字。 detailsArraynull更新的版本字符串。 versionLabelString包含更新说明的数组。数组的元素在本地代码和说明的本地化版本之间交替。 构造函数。请勿调用此函数。更新框架调用此函数是为了创建事件对象。 clone 创建对象的副本,并将每个属性的值设置为与原始属性值相匹配。flash.events:Event 创建对象的副本,并将每个属性的值设置为与原始属性值相匹配。 toString 返回一个字符串,其中包含对象的所有属性。String 返回一个字符串,其中包含对象的所有属性。 UPDATE_STATUS StatusUpdateEvent.UPDATE_STATUS 常量为 updateStatus 事件定义事件对象的 type 属性的值。updateStatusString StatusUpdateEvent.UPDATE_STATUS 常量为 updateStatus 事件定义事件对象的 type 属性的值。

此事件具有以下属性:

属性available如果更新描述符文件指定的版本与当前应用程序的版本不同,则设置为 true;否则(版本相同)为 falseversion表示新的可用版本的字符串。details为每种受支持的语言定义 details 字符串的数组。如果没有本地化的说明,则将此属性定义为其中第一个元素为空字符串 ("")、第二个元素为 details 字符串的数组。有本地化的说明时,数组中的每个元素都是含有两个元素的数组自身。第一个元素是语言环境代码,第二个元素是说明。例如,以下数组有两种语言(美国英语和法语)的子数组:["en-US", "Hello World"], ["fr", "Bonjour monde"]。列出语言的顺序与更新描述符中的顺序相同。详细信息属性的文本在更新描述符文件中指定。versionLabel(AIR 2.5+) 来自更新的应用程序描述符的版本标签。应该对用户显示版本标签而不是版本。如果没有指定版本标签,则此属性是空字符串。
available 表示更新是否可用。falseBoolean 表示更新是否可用。如果更新描述符文件指定的版本与当前应用程序的版本不同,则将此属性设置为 true;否则(版本相同)为 falsedetails 一个数组,定义每种所支持语言的详细信息字符串。unknownArray 为每种受支持的语言定义 details 字符串的数组。如果没有本地化的说明,则将此属性定义为其中第一个元素为空字符串 ("")、第二个元素为 details 字符串的数组。有本地化的说明时,数组中的每个元素都是含有两个元素的数组自身。第一个元素是语言环境代码,第二个元素是说明。例如,以下数组有两种语言(美国英语和法语)的子数组:["en-US", "Hello World"], ["fr", "Bonjour monde"]。列出语言的顺序与更新描述符中的顺序相同。 versionLabel 更新的版本标签字符串。String 更新的版本标签字符串。 version 更新的版本字符串。String 更新的版本字符串。

在 AIR 2.5 和更高版本中,版本字符串在应用程序描述符文件的 versionNumber 元素中指定。在 AIR 早期版本中,版本字符串在 version 元素中指定。

StatusUpdateErrorEvent 调用 ApplicationUpdater 对象的 checkForUpdate() 方法时在下载或分析更新描述符文件的过程中如果遇到错误,将调度 StatusUpdateErrorEvent。flash.events:ErrorEvent 调用 ApplicationUpdater 对象的 checkForUpdate() 方法时在下载或分析更新描述符文件的过程中如果遇到错误,将调度 StatusUpdateErrorEvent。 air.update.ApplicationUpdaterair.update.ApplicationUpdaterUIupdateErrorair.update.events:StatusUpdateErrorEvent:UPDATE_ERRORair.update.events:StatusUpdateErrorEventStatusUpdateErrorEvent 构造函数。typeString 事件的类型。事件侦听器可以通过继承的 type 属性访问此信息。只有一种类型的 error 事件:ErrorEvent.ERRORbubblesBooleanfalse确定 Event 对象是否冒泡。事件侦听器可以通过继承的 bubbles 属性访问此信息。 cancelableBooleanfalse确定是否可以取消 Event 对象。事件侦听器可以通过继承的 cancelable 属性访问此信息。 textString要显示为错误消息的文本。事件侦听器可以通过 text 属性访问此信息。 idint0要与特定错误关联的引用数字。 subErrorIDint0errorID 之外,还提供有关错误事件的详细信息。 构造函数。请勿调用此函数。更新框架调用此函数是为了创建事件对象。 clone 创建对象的副本,并将每个属性的值设置为与原始属性值相匹配。flash.events:Event 创建对象的副本,并将每个属性的值设置为与原始属性值相匹配。 toString 返回一个字符串,其中包含对象的所有属性。String 返回一个字符串,其中包含对象的所有属性。 UPDATE_ERROR StatusUpdateErrorEvent.UPDATE_ERROR 常量为 statusUpdateError 事件定义事件对象的 type 属性的值。updateErrorString StatusUpdateErrorEvent.UPDATE_ERROR 常量为 statusUpdateError 事件定义事件对象的 type 属性的值。 subErrorID 提供 errorId 属性之外的信息。0int 提供 errorId 属性之外的信息。 DownloadErrorEvent 如果下载更新文件时出错,ApplicationUpdater 或 ApplicationUpdaterUI 对象将调度 DownloadErrorEvent 对象。flash.events:ErrorEvent 如果下载更新文件时出错,ApplicationUpdater 或 ApplicationUpdaterUI 对象将调度 DownloadErrorEvent 对象。 air.update.ApplicationUpdaterair.update.ApplicationUpdaterUIdownloadErrorair.update.events:DownloadErrorEvent:DOWNLOAD_ERRORair.update.events:DownloadErrorEventDownloadErrorEvent 构造函数。typeString 事件的类型。事件侦听器可以通过继承的 type 属性访问此信息。只有一种类型的 error 事件:ErrorEvent.ERRORbubblesBooleanfalse确定 Event 对象是否冒泡。事件侦听器可以通过继承的 bubbles 属性访问此信息。 cancelableBooleanfalse确定是否可以取消 Event 对象。事件侦听器可以通过继承的 cancelable 属性访问此信息。 textString要显示为错误消息的文本。事件侦听器可以通过 text 属性访问此信息。 idint0要与特定错误关联的引用数字。 subErrorIDint0errorID 之外,还提供有关错误事件的详细信息。 构造函数。请勿调用此函数。更新框架调用此函数是为了创建事件对象。 clone 创建对象的副本,并将每个属性的值设置为与原始属性值相匹配。flash.events:Event 创建对象的副本,并将每个属性的值设置为与原始属性值相匹配。 toString 返回一个字符串,其中包含对象的所有属性。String 返回一个字符串,其中包含对象的所有属性。 DOWNLOAD_ERROR DownloadErrorEvent.DOWNLOAD_ERROR 常量为 downloadError 事件定义事件对象的 type 属性的值。downloadErrorString DownloadErrorEvent.DOWNLOAD_ERROR 常量为 downloadError 事件定义事件对象的 type 属性的值。

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

errorID 错误代码说明16800验证已下载的更新文件时出错。subErrorID 属性可能包含其他信息。16801Adobe AIR 文件无效(缺少 application.xml)。16802Adobe AIR 文件无效(缺少 MIME 类型)。16803Adobe AIR 文件无效(格式)。16804Adobe AIR 文件无效(标志无效)。16805Adobe AIR 文件无效(压缩方式未知)。16806Adobe AIR 文件无效(文件名无效)。16807Adobe AIR 文件无效(已损坏)。16808配置文件不存在。16809未设置 updateURL 属性。16810保留。16811配置文件无效(配置版本未知)。16812配置文件无效(缺少 URL)。16813配置文件无效(延迟格式)。16814配置文件无效(defaultUI 值无效)。16815更新描述符无效(描述符版本未知)。16816更新描述符无效(缺少更新版本)。16817更新描述符无效(说明无效)。16818向磁盘保存数据时发生 I/O 错误。subErrorID 属性可能会提供更多信息。16819下载时发生安全错误。subErrorID 属性可能会提供更多信息。16820HTTP 状态代码无效。subErrorID 属性可能包含无效的状态代码。16821保留。16822下载时发生 I/O 错误。subErrorID 属性可能会提供更多信息。16823向磁盘保存数据时文件尾出错。subErrorID 属性可能会提供更多信息。16824更新描述符无效。subErrorID 属性可能会提供更多信息。16825更新文件包含应用程序 ID 不同的应用程序。16826更新文件不包含应用程序的更新版本。16827更新文件中包含的版本与更新描述符中的版本不匹配。16828无法更新应用程序,通常是因为应用程序正在 AIR Debug Launcher (ADL) 中运行。16829安装时缺少更新文件。
subErrorID 提供 errorId 属性之外的信息。0int 提供 errorId 属性之外的信息。
StatusFileUpdateEvent updater 成功验证调用 installFromAIRFile() 方法过程中的文件之后将调度此事件。air.update.events:UpdateEvent updater 成功验证调用 installFromAIRFile() 方法过程中的文件之后将调度此事件。

如果将 StatusFileUpdateEvent 对象的 available 属性设置为 true,则默认行为是安装更新。只有在使用 ApplicationUpdater 类时才能阻止默认行为。

air.update.ApplicationUpdaterair.update.ApplicationUpdaterUIfileUpdateStatusair.update.events:StatusFileUpdateEvent:FILE_UPDATE_STATUSair.update.events:StatusFileUpdateEventStatusFileUpdateEvent 构造函数。typeString 事件的类型。事件侦听器可以通过继承的 type 属性访问此信息。只有一种类型的 error 事件:ErrorEvent.ERRORbubblesBooleanfalse确定 Event 对象是否冒泡。事件侦听器可以通过继承的 bubbles 属性访问此信息。 cancelableBooleanfalse确定是否可以取消 Event 对象。事件侦听器可以通过继承的 cancelable 属性访问此信息。 availableBooleanfalse要显示为错误消息的文本。事件侦听器可以通过 text 属性访问此信息。 versionString要与特定错误关联的引用数字。 pathString 构造函数。请勿调用此函数。更新框架调用此函数是为了创建事件对象。 clone 创建对象的副本,并将每个属性的值设置为与原始属性值相匹配。flash.events:Event 创建对象的副本,并将每个属性的值设置为与原始属性值相匹配。 toString 返回一个字符串,其中包含对象的所有属性。String 返回一个字符串,其中包含对象的所有属性。 FILE_UPDATE_STATUS StatusUpdateEvent.UPDATE_STATUS 常量为 updateStatus 事件定义事件对象的 type 属性的值。fileUpdateStatusString StatusUpdateEvent.UPDATE_STATUS 常量为 updateStatus 事件定义事件对象的 type 属性的值。

此事件具有以下属性:

属性available表示除当前应用程序的版本之外是否还有可用的版本,有则为 true;否则(版本相同)为 falsepath调用 installFromAIRFile() 方法的过程中由 airFile 参数指定的更新 File 对象的 nativePath 属性。version表示新的更新的版本。

available 表示除当前应用程序的版本之外是否还有可用的版本,有则为 true;否则(版本相同)为 false。falseBoolean 表示除当前应用程序的版本之外是否还有可用的版本,有则为 true;否则(版本相同)为 falsepath 调用 installFromAIRFile() 方法的过程中由 airFile 参数指定的更新 File 对象的 nativePath 属性。nullString 调用 installFromAIRFile() 方法的过程中由 airFile 参数指定的更新 File 对象的 nativePath 属性。 versionLabel 更新的版本标签字符串。String 更新的版本标签字符串。 version 更新的版本字符串。String 更新的版本字符串。

在 AIR 2.5 和更高版本中,版本字符串在应用程序描述符文件的 versionNumber 元素中指定。在 AIR 早期版本中,版本字符串在 version 元素中指定。

StatusFileUpdateErrorEvent 调用 ApplicationUpdater 对象的 checkForUpdate() 方法时在下载或分析更新描述符文件的过程中如果遇到错误,将调度 StatusUpdateFileErrorEvent。flash.events:ErrorEvent 调用 ApplicationUpdater 对象的 checkForUpdate() 方法时在下载或分析更新描述符文件的过程中如果遇到错误,将调度 StatusUpdateFileErrorEvent。 air.update.ApplicationUpdaterair.update.ApplicationUpdaterUIfileUpdateErrorair.update.events:StatusFileUpdateErrorEvent:FILE_UPDATE_ERRORair.update.events:StatusFileUpdateErrorEventStatusFileUpdateErrorEvent 构造函数。typeString 事件的类型。事件侦听器可以通过继承的 type 属性访问此信息。只有一种类型的 error 事件:ErrorEvent.ERRORbubblesBooleanfalse确定 Event 对象是否冒泡。事件侦听器可以通过继承的 bubbles 属性访问此信息。 cancelableBooleanfalse确定是否可以取消 Event 对象。事件侦听器可以通过继承的 cancelable 属性访问此信息。 textString要显示为错误消息的文本。事件侦听器可以通过 text 属性访问此信息。 idint0要与特定错误关联的引用数字。 构造函数。请勿调用此函数。更新框架调用此函数是为了创建事件对象。 clone 创建对象的副本,并将每个属性的值设置为与原始属性值相匹配。flash.events:Event 创建对象的副本,并将每个属性的值设置为与原始属性值相匹配。 toString 返回一个字符串,其中包含对象的所有属性。String 返回一个字符串,其中包含对象的所有属性。 FILE_UPDATE_ERROR StatusUpdateErrorEvent.UPDATE_ERROR 常量为 statusUpdateError 事件定义事件对象的 type 属性的值。fileUpdateErrorString StatusUpdateErrorEvent.UPDATE_ERROR 常量为 statusUpdateError 事件定义事件对象的 type 属性的值。 UpdateEvent 在更新过程中,ApplicationUpdater 对象将调度 UpdateEvent。flash.events:Event 在更新过程中,ApplicationUpdater 对象将调度 UpdateEvent。 air.update.ApplicationUpdaterair.update.ApplicationUpdaterUIbeforeInstallair.update.events:UpdateEvent:BEFORE_INSTALLair.update.events:UpdateEventcheckForUpdateair.update.events:UpdateEvent:CHECK_FOR_UPDATEair.update.events:UpdateEventdownloadCompleteair.update.events:UpdateEvent:DOWNLOAD_COMPLETEair.update.events:UpdateEventdownloadStartair.update.events:UpdateEvent:DOWNLOAD_STARTair.update.events:UpdateEventinitializedair.update.events:UpdateEvent:INITIALIZEDair.update.events:UpdateEventUpdateEvent 构造函数。typeString 事件的类型。事件侦听器可以通过继承的 type 属性访问此信息。只有一种类型的 error 事件:ErrorEvent.ERRORbubblesBooleanfalse确定 Event 对象是否冒泡。事件侦听器可以通过继承的 bubbles 属性访问此信息。 cancelableBooleanfalse确定是否可以取消 Event 对象。事件侦听器可以通过继承的 cancelable 属性访问此信息。 构造函数。请勿调用此函数。更新框架调用此函数是为了创建事件对象。 clone 创建对象的副本,并将每个属性的值设置为与原始属性值相匹配。flash.events:Event 创建对象的副本,并将每个属性的值设置为与原始属性值相匹配。 toString 返回一个字符串,其中包含对象的所有属性。String 返回一个字符串,其中包含对象的所有属性。 BEFORE_INSTALL UpdateEvent.BEFORE_INSTALL 常量为 beforeInstall 事件定义事件对象的 type 属性的值。beforeInstallString UpdateEvent.BEFORE_INSTALL 常量为 beforeInstall 事件定义事件对象的 type 属性的值。

此事件具有以下属性:

属性bubblesfalsecancelablefalse;没有要取消的默认行为。currentTarget当前正在使用某个事件侦听器处理 Event 对象的对象。targetupdater 对象。
CHECK_FOR_UPDATE UpdateEvent.CHECK_FOR_UPDATE 常量为 checkForUpdate 事件定义事件对象的 type 属性的值。checkForUpdateString UpdateEvent.CHECK_FOR_UPDATE 常量为 checkForUpdate 事件定义事件对象的 type 属性的值。

此事件具有以下属性:

属性bubblesfalsecancelablefalse;没有要取消的默认行为。currentTarget当前正在使用某个事件侦听器处理 Event 对象的对象。targetupdater 对象。
DOWNLOAD_COMPLETE UpdateEvent.DOWNLOAD_COMPLETE 常量为 downloadComplete 事件定义事件对象的 type 属性的值。downloadCompleteString UpdateEvent.DOWNLOAD_COMPLETE 常量为 downloadComplete 事件定义事件对象的 type 属性的值。

此事件具有以下属性:

属性bubblesfalsecancelablefalse;没有要取消的默认行为。currentTarget当前正在使用某个事件侦听器处理 Event 对象的对象。targetupdater 对象。
DOWNLOAD_START UpdateEvent.DOWNLOAD_START 常量为 downloadStart 事件定义事件对象的 type 属性的值。downloadStartString UpdateEvent.DOWNLOAD_START 常量为 downloadStart 事件定义事件对象的 type 属性的值。

此事件具有以下属性:

属性bubblesfalsecancelablefalse;没有要取消的默认行为。currentTarget当前正在使用某个事件侦听器处理 Event 对象的对象。targetupdater 对象。
INITIALIZED UpdateEvent.INITIALIZED 常量为 initialized 事件定义事件对象的 type 属性的值。initializedString UpdateEvent.INITIALIZED 常量为 initialized 事件定义事件对象的 type 属性的值。

此事件具有以下属性:

属性bubblesfalsecancelablefalse;没有要取消的默认行为。currentTarget当前正在使用某个事件侦听器处理 Event 对象的对象。targetupdater 对象。