air.update.eventsStatusUpdateEvent An updater object dispatches a StatusUpdateEvent object after the updater successfully downloads and interprets the update descriptor file.air.update.events:UpdateEvent An updater object dispatches a StatusUpdateEvent object after the updater successfully downloads and interprets the update descriptor file.

The default behavior is to start downloading the update if the available property of the StatusUpdateEvent object is set to true. The default behavior can be prevented only when using the ApplicationUpdater class.

updateStatusair.update.events:StatusUpdateEvent:UPDATE_STATUSair.update.events:StatusUpdateEventStatusUpdateEvent The constructor function.typeString The type of the event. Event listeners can access this information through the inherited type property. There is only one type of error event: ErrorEvent.ERROR. bubblesBooleanfalseDetermines whether the Event object bubbles. Event listeners can access this information through the inherited bubbles property. cancelableBooleanfalseDetermines whether the Event object can be canceled. Event listeners can access this information through the inherited cancelable property. availableBooleanfalseText to be displayed as an error message. Event listeners can access this information through the text property. versionStringA reference number to associate with the specific error. detailsArraynullthe version string of the update. versionLabelStringan array containing the description of update. The elements of the array alternate between local codes and a localized version of the description. The constructor function. Do not call this function. The update framework calls it to create the event object. clone Creates a copy of the object and sets the value of each property to match that of the original.flash.events:Event Creates a copy of the object and sets the value of each property to match that of the original. toString Returns a string that contains all the properties of the object.String Returns a string that contains all the properties of the object. UPDATE_STATUS The StatusUpdateEvent.UPDATE_STATUS constant defines the value of the type property of the event object for a updateStatus event.updateStatusString The StatusUpdateEvent.UPDATE_STATUS constant defines the value of the type property of the event object for a updateStatus event.

This event has the following properties:

PropertyValueavailableSet to true if the update descriptor file specifies a version that is different than that of the current application; false otherwise (the version is the same).versionThe string representing the new available version.detailsAn array defining the details string for each of the supported languages. If there is no localized description, this is defined as an array in which the first element is an empty string ("") and the second element is the details string. When there are localized descriptions, each element in the array is an array itself with two elements. The first element is the locale code, and the second is the description. For example, the following array has sub-arrays for two languages (U.S. English and French): ["en-US", "Hello World"], ["fr", "Bonjour monde"]. The languages are listed in the same order as in the update descriptor. The text for the details property is specified in the update descriptor file.versionLabel(AIR 2.5+) The version label from the application descriptor of the update. The version label should be displayed to users instead of version. If no version label is specified, this property is an empty string. available Indicates if an update is available.falseBoolean Indicates if an update is available. This property is true if the update descriptor file specifies a version that is different than that of the current application; it is false otherwise (the version is the same). details An array defining the details string for each of the supported languages.unknownArray An array defining the details string for each of the supported languages. If there is no localized description, this is defined as an array in which the first element is an empty string ("") and the second element is the details string. When there are localized descriptions, each element in the array is an array itself with two elements. The first element is the locale code, and the second is the description. For example, the following array has sub-arrays for two languages (U.S. English and French): ["en-US", "Hello World"], ["fr", "Bonjour monde"]. The languages are listed in the same order as in the update descriptor. versionLabel The version label string of the update.String The version label string of the update. version The version string of the update.String The version string of the update.

In AIR 2.5 and later, the version string is specified in the versionNumber element of the application descriptor file. In earlier versions of AIR, the version string is specified in the version element.

StatusUpdateErrorEvent A StatusUpdateErrorEvent is dispatched when a call to the checkForUpdate() method of an ApplicationUpdater object encounters an error while downloading or parsing the update descriptor file.flash.events:ErrorEvent A StatusUpdateErrorEvent is dispatched when a call to the checkForUpdate() method of an ApplicationUpdater object encounters an error while downloading or parsing the update descriptor file. updateErrorair.update.events:StatusUpdateErrorEvent:UPDATE_ERRORair.update.events:StatusUpdateErrorEventStatusUpdateErrorEvent The constructor function.typeString The type of the event. Event listeners can access this information through the inherited type property. There is only one type of error event: ErrorEvent.ERROR. bubblesBooleanfalseDetermines whether the Event object bubbles. Event listeners can access this information through the inherited bubbles property. cancelableBooleanfalseDetermines whether the Event object can be canceled. Event listeners can access this information through the inherited cancelable property. textStringText to be displayed as an error message. Event listeners can access this information through the text property. idint0A reference number to associate with the specific error. subErrorIDint0Provides details about the error event, in addition to the errorID. The constructor function. Do not call this function. The update framework calls it to create the event object. clone Creates a copy of the object and sets the value of each property to match that of the original.flash.events:Event Creates a copy of the object and sets the value of each property to match that of the original. toString Returns a string that contains all the properties of the object.String Returns a string that contains all the properties of the object. UPDATE_ERROR The StatusUpdateErrorEvent.UPDATE_ERROR constant defines the value of the type property of the event object for a statusUpdateError event.updateErrorString The StatusUpdateErrorEvent.UPDATE_ERROR constant defines the value of the type property of the event object for a statusUpdateError event. subErrorID Provides information in addition to the errorId property.0int Provides information in addition to the errorId property. DownloadErrorEvent A DownloadErrorEvent object is dispatched by an ApplicationUpdater or ApplicationUpdaterUI object when an error happens while downloading the update file.flash.events:ErrorEvent A DownloadErrorEvent object is dispatched by an ApplicationUpdater or ApplicationUpdaterUI object when an error happens while downloading the update file. downloadErrorair.update.events:DownloadErrorEvent:DOWNLOAD_ERRORair.update.events:DownloadErrorEventDownloadErrorEvent The constructor function.typeString The type of the event. Event listeners can access this information through the inherited type property. There is only one type of error event: ErrorEvent.ERROR. bubblesBooleanfalseDetermines whether the Event object bubbles. Event listeners can access this information through the inherited bubbles property. cancelableBooleanfalseDetermines whether the Event object can be canceled. Event listeners can access this information through the inherited cancelable property. textStringText to be displayed as an error message. Event listeners can access this information through the text property. idint0A reference number to associate with the specific error. subErrorIDint0Provides details about the error event, in addition to the errorID. The constructor function. Do not call this function. The update framework calls it to create the event object. clone Creates a copy of the object and sets the value of each property to match that of the original.flash.events:Event Creates a copy of the object and sets the value of each property to match that of the original. toString Returns a string that contains all the properties of the object.String Returns a string that contains all the properties of the object. DOWNLOAD_ERROR The DownloadErrorEvent.DOWNLOAD_ERROR constant defines the value of the type property of the event object for a downloadError event.downloadErrorString The DownloadErrorEvent.DOWNLOAD_ERROR constant defines the value of the type property of the event object for a downloadError event.

The errorID property of a DownloadErrorEvent object is an integer defining error information (see the following table). An additional subErrorID property may contain more error information.

errorID Error codeDescription16800Occurs during validating the downloaded update file. The subErrorID property may contain additional information.16801Invalid Adobe AIR file (missing application.xml).16802Invalid Adobe AIR file (missing MIME type).16803Invalid Adobe AIR file (format).16804Invalid Adobe AIR file (invalid flags).16805Invalid Adobe AIR file (unknown compression).16806Invalid Adobe AIR file (invalid filename).16807Invalid Adobe AIR file (corrupt).16808Configuration file does not exist.16809The updateURL property is not set.16810Reserved.16811Invalid configuration file (unknown configuration version).16812Invalid configuration file (URL missing).16813Invalid configuration file (delay format).16814Invalid configuration file (invalid defaultUI values).16815Invalid update descriptor (unknown descriptor version).16816Invalid update descriptor (missing update version).16817Invalid update descriptor (invalid description).16818IO error while saving data to disk. The subErrorID property may provide more information.16819Security error while downloading. The subErrorID property may provide more information.16820Invalid HTTP status code. The subErrorID property may contain the invalid status code.16821Reserved.16822I/O error while downloading. The subErrorID property may provide more information.16823End-of-file error while saving data to disk. The subErrorID property may provide more information.16824Invalid update descriptor. The subErrorID property may provide more information.16825The update file contains an application with a different application ID.16826The update file does not contain a newer version of the application.16827The version contained in the update file does not match the version from the update descriptor.16828Cannot update application, usually because the application is running in the AIR Debug Launcher (ADL).16829Missing update file at install time. subErrorID Provides information in addition to the errorId property.0int Provides information in addition to the errorId property. StatusFileUpdateEvent Dispatched after the updater successfully validates the file in the call to the installFromAIRFile() method.air.update.events:UpdateEvent Dispatched after the updater successfully validates the file in the call to the installFromAIRFile() method.

The default behavior is to install the update if the available of the available property of the StatusFileUpdateEvent object is set to true. The default behavior can be prevented only when using the ApplicationUpdater class.

fileUpdateStatusair.update.events:StatusFileUpdateEvent:FILE_UPDATE_STATUSair.update.events:StatusFileUpdateEventStatusFileUpdateEvent The constructor function.typeString The type of the event. Event listeners can access this information through the inherited type property. There is only one type of error event: ErrorEvent.ERROR. bubblesBooleanfalseDetermines whether the Event object bubbles. Event listeners can access this information through the inherited bubbles property. cancelableBooleanfalseDetermines whether the Event object can be canceled. Event listeners can access this information through the inherited cancelable property. availableBooleanfalseText to be displayed as an error message. Event listeners can access this information through the text property. versionStringA reference number to associate with the specific error. pathString The constructor function. Do not call this function. The update framework calls it to create the event object. clone Creates a copy of the object and sets the value of each property to match that of the original.flash.events:Event Creates a copy of the object and sets the value of each property to match that of the original. toString Returns a string that contains all the properties of the object.String Returns a string that contains all the properties of the object. FILE_UPDATE_STATUS The StatusUpdateEvent.UPDATE_STATUS constant defines the value of the type property of the event object for a updateStatus event.fileUpdateStatusString The StatusUpdateEvent.UPDATE_STATUS constant defines the value of the type property of the event object for a updateStatus event.

This event has the following properties:

PropertyValueavailableIndicates if if there is a different version available than one of the current application (true); false otherwise (same version).pathThe nativePath property of the update File object specified by the airFile parameter in a call to the installFromAIRFile() method.versionIndicates the version of the new update.

available Indicates if if there is a different version available than one of the current application (true); false otherwise (same version).falseBoolean Indicates if if there is a different version available than one of the current application (true); false otherwise (same version). path The nativePath property of the update File object specified by the airFile parameter in a call to the installFromAIRFile() method.nullString The nativePath property of the update File object specified by the airFile parameter in a call to the installFromAIRFile() method. versionLabel The version label string of the update.String The version label string of the update. version The version string of the update.String The version string of the update.

StatusFileUpdateErrorEvent A StatusUpdateFileErrorEvent is dispatched when a call to the checkForUpdate() method of a ApplicationUpdater object encounters an error while downloading or parsing the update descriptor file.flash.events:ErrorEvent A StatusUpdateFileErrorEvent is dispatched when a call to the checkForUpdate() method of a ApplicationUpdater object encounters an error while downloading or parsing the update descriptor file. fileUpdateErrorair.update.events:StatusFileUpdateErrorEvent:FILE_UPDATE_ERRORair.update.events:StatusFileUpdateErrorEventStatusFileUpdateErrorEvent The constructor function.typeString The type of the event. Event listeners can access this information through the inherited type property. There is only one type of error event: ErrorEvent.ERROR. bubblesBooleanfalseDetermines whether the Event object bubbles. Event listeners can access this information through the inherited bubbles property. cancelableBooleanfalseDetermines whether the Event object can be canceled. Event listeners can access this information through the inherited cancelable property. textStringText to be displayed as an error message. Event listeners can access this information through the text property. idint0A reference number to associate with the specific error. The constructor function. Do not call this function. The update framework calls it to create the event object. clone Creates a copy of the object and sets the value of each property to match that of the original.flash.events:Event Creates a copy of the object and sets the value of each property to match that of the original. toString Returns a string that contains all the properties of the object.String Returns a string that contains all the properties of the object. FILE_UPDATE_ERROR The StatusUpdateErrorEvent.UPDATE_ERROR constant defines the value of the type property of the event object for a statusUpdateError event.fileUpdateErrorString The StatusUpdateErrorEvent.UPDATE_ERROR constant defines the value of the type property of the event object for a statusUpdateError event. UpdateEvent A UpdateEvent is dispatched by a ApplicationUpdater object during the update process.flash.events:Event A UpdateEvent is dispatched by a ApplicationUpdater object during the update process. beforeInstallair.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 The constructor function.typeString The type of the event. Event listeners can access this information through the inherited type property. There is only one type of error event: ErrorEvent.ERROR. bubblesBooleanfalseDetermines whether the Event object bubbles. Event listeners can access this information through the inherited bubbles property. cancelableBooleanfalseDetermines whether the Event object can be canceled. Event listeners can access this information through the inherited cancelable property. The constructor function. Do not call this function. The update framework calls it to create the event object. clone Creates a copy of the object and sets the value of each property to match that of the original.flash.events:Event Creates a copy of the object and sets the value of each property to match that of the original. toString Returns a string that contains all the properties of the object.String Returns a string that contains all the properties of the object. BEFORE_INSTALL The UpdateEvent.BEFORE_INSTALL constant defines the value of the type property of the event object for a beforeInstall event.beforeInstallString The UpdateEvent.BEFORE_INSTALL constant defines the value of the type property of the event object for a beforeInstall event.

This event has the following properties:

PropertyValuebubblesfalsecancelablefalse; there is no default behavior to cancel.currentTargetThe object that is actively processing the Event object with an event listener.targetThe updater object. CHECK_FOR_UPDATE The UpdateEvent.CHECK_FOR_UPDATE constant defines the value of the type property of the event object for a checkForUpdate event.checkForUpdateString The UpdateEvent.CHECK_FOR_UPDATE constant defines the value of the type property of the event object for a checkForUpdate event.

This event has the following properties:

PropertyValuebubblesfalsecancelablefalse; there is no default behavior to cancel.currentTargetThe object that is actively processing the Event object with an event listener.targetThe updater object. DOWNLOAD_COMPLETE The UpdateEvent.DOWNLOAD_COMPLETE constant defines the value of the type property of the event object for a downloadComplete event.downloadCompleteString The UpdateEvent.DOWNLOAD_COMPLETE constant defines the value of the type property of the event object for a downloadComplete event.

This event has the following properties:

PropertyValuebubblesfalsecancelablefalse; there is no default behavior to cancel.currentTargetThe object that is actively processing the Event object with an event listener.targetThe updater object. DOWNLOAD_START The UpdateEvent.DOWNLOAD_START constant defines the value of the type property of the event object for a downloadStart event.downloadStartString The UpdateEvent.DOWNLOAD_START constant defines the value of the type property of the event object for a downloadStart event.

This event has the following properties:

PropertyValuebubblesfalsecancelablefalse; there is no default behavior to cancel.currentTargetThe object that is actively processing the Event object with an event listener.targetThe updater object. INITIALIZED The UpdateEvent.INITIALIZED constant defines the value of the type property of the event object for a initialized event.initializedString The UpdateEvent.INITIALIZED constant defines the value of the type property of the event object for a initialized event.

This event has the following properties:

PropertyValuebubblesfalsecancelablefalse; there is no default behavior to cancel.currentTargetThe object that is actively processing the Event object with an event listener.targetThe updater object.