Air update descriptor file

The previous location of the application storage directory, if it changed after an update. The application storage directory location changes after an upgrade with a certificate migration. If there is no certificate migration, the application storage directory does not change when the user updates the application.

If a new version of an AIR application uses a new signing certificate, the local storage directory of the application changes when the user installs the new version. Use this property to transfer data from the old application storage directory to the new application storage directory File. The previous version of the application.

Returns the previous version of the application before the upgrade set only if isfirstRun is true ; otherwise it is set to null.

The content of the update descriptor file downloaded from the update URL. This property is non-null only the updater object dispatches an updateStatus event. The location of the update descriptor file. Any location valid for a URLRequest path is accepted. This is the only mandatory setting required by the updater. You can set the update URL either via this property or via the configuration file.

When the value is set using both methods, the updater uses the value set using this property. Whether there was a postponed update, even if it failed to install true ; false otherwise. The updater sets this property during a call to the initialize method.

Use the wasPendingUpdate and isFirstRun properties to check if an update failed to install in which case wasPendingUpdate is set to true and isFirstRun is set to false. Cancels the update process. Calling this method cancels any pending downloads, deleting any incomplete downloaded files, and restarts the periodic check timer.

Asynchronously downloads and interprets the update descriptor file. Call this method only if the checkForUpdate event was cancelled. Starts the update process. Calling this method does not stop the periodic timer; however, the method detects that an update process is running and will skip the current iteration. Asynchronously downloads the update file. This method needs to be called only if the StatusUpdateEvent. Initializes the updater. Calling this method does the following: It initializes the update framework, silently and synchronously installing any pending updates.

You should call this method during application startup, since it may restart the application. If something went wrong with a prior update, it clears the update file and version information from the storage area. If the periodic timer delay has expired, it starts the update process; otherwise it starts the periodic timer.

Starts the update process using a local AIR file. This function is useful for an application that has the customUpdateUI element set to true in the application descriptor file.

Installs the update file. Calling it in any other state will do nothing. Dispatched just before installing the update, after the installUpdate method was called. Sometimes, it is useful to prevent the installation of the update at this time, because the user could lose all current work when the runtime exits the application to install the update. Calling this event's preventDefault method postpones the installation until the next restart.

If you call the preventDefault method, no additional update process can be started during this application session via a call to the installUpdate method or because of the periodic check. The default behavior for ApplicationUpdater library is to download the update descriptor file. You can call the preventDefault method to cancel this behavior. Dispatched before the update process begins, just before the updater tries to download the update descriptor file. The updater can dispatch this event as a result of directly calling the checkNow method or because the periodic check timer expired.

Dispatched when the download of the update file is complete. Usually this event is used to display a message asking if the user wants to proceed with the installation of the update. The default behavior for the the ApplicationUpdater library is to automatically call the installUpdate method.

Dispatched if there is an error while connecting or downloading the update file. When this event is dispatched the periodic timer is automatically restarted if the delay is greater than 0. 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. Dispatched after a call to the downloadUpdate method and the connection to the server is established. When using ApplicationUpdater library, you may want the event handler for this event to display a progress bar to report the download progress to the user.

Dispatched when an error occurred either during initialization or during the update process if something unexpected happens. Dispatched when an error occurs validating the file passed as the airFile parameter in a call to the installFromAIRFile method. Dispatched after the updater successfully validates the file in the call to the installFromAIRFile method. Property Value available Indicates if if there is a different version available than one of the current application true ; false otherwise same version.

Dispatched if an error occurs while trying to download or parse the update descriptor file. When the updater dispatches this event, the periodic timer is automatically restarted if the delay setting is greater than 0. The application should consider hiding any error dialog boxes when the updater dispatches a new checkForUpdate event. RPM or Debian. Window managers. Flash Player. Seamless badge installation from the web requires Flash Player Libraries required AIR 2.

Supported languages. Version information. What's new in AIR 2. Update AIR 2. New features for mobile applications. GPU rendering changes for iOS.

Multitasking support for iOS. Microphone for iOS. Read from camera roll for iOS. CameraUI for iOS. Camera for iOS. StageWebView for iOS. When user tap inside the StageWebView , the focusIn event is dispatched. When user touches outside the StageWebView the focusOut event is dispatched.

LocationChangeEvent event for redirect: On iOS, locationChanging and locationChange events are dispatched for every redirect Note: On the first loaded page, only locationChange is dispatched On Android, a locationChanging event is dispatched for every redirect. Capture bitmap of StageWebView. Programmatic control of soft keyboard. Disable automatic panning and resizing behavior on the display of a soft keyboard.

USB device debugging for Android. It is now possible to debug an application running on an Android device via a USB cable. Text field interaction mode on Android. Alternate Android market URLs. Other new features. Owned NativeWindow for desktop. Native Menu event refinement for desktop. Image decoding policy. LoaderContext parent and parameters. Linux vector printing. New -version option added to ADT. Native mouse cursors. Changes in AIR 2. Screen orientation changes in 2.

Other Fixes. The following additional fixes have been included in AIR Android 2. Ghosting and green artifact issue now fixed on Android 2. Tips and tricks. Adobe AIR forums. Adobe Community Help. It's an AIR application that provides the following features: Access up-to-date definitive reference content online and offline Find the most relevant content contributed by experts from the Adobe community, on and off Adobe.

Adobe AIR documentation. Installer logs for AIR application and runtime installation. Security improvements. Known issues. There is a known issue for iOS to use embedded font which is not supported in this version of the packager. Please use device font as a workaround. This is known limitation and it will need to be resolved in future version. This is caused by Mac Please do not create dynamic menu contents for sub-context menu on Mac OS It's known behavior that calling NativeApplication.

However you can only capture video from one camera at a time. This is a known iOS limitation on sound channels. To make sure the isHistoryBackEnabled has the correct value, read it on the Event. Increase the vm memory size by adding the following command line option to ADT: "-Xmx" or higher recommended as minimum.

Compile on Mac OSX. This happens if the StageWebView is positioned at the edge of the stage. Hide Inherited Public Methods. Show Inherited Methods. Registers an event listener object with an EventDispatcher object so that the listener receives notification of an event.

Checks whether the EventDispatcher object has any listeners registered for a specific type of event. Indicates whether an object has a specified property defined.

Indicates whether an instance of the Object class is in the prototype chain of the object specified as the parameter. Indicates whether the specified property exists and is enumerable. Sets the availability of a dynamic property for loop operations. Returns the string representation of this object, formatted according to locale-specific conventions. Checks whether an event listener is registered with this EventDispatcher object or any of its ancestors for the specified event type.

Hide Inherited Events. Show Inherited Events. Property Detail. The default value is 0. See also wasPendingUpdate. See also isFirstRun. Events updateStatus : StatusUpdateEvent — The updater has successfully downloaded and interpreted the update descriptor file.

This method can result in the updater object dispatching the following event: Events checkForUpdate : UpdateEvent — Dispatched just before the update process begins. Events downloadStart — Dispatched after the connection to the server is established. It checks if there is a postponed update and installs it. Events initialized : UpdateEvent — The initialization is complete. Events beforeInstall : UpdateEvent — Dispatched just before installing the update.

Sometimes it is useful to prevent the installation of the update at this time, because the user could lose all current work when the runtime exits the application to install the update. Event Object Type: air. UpdateEvent property UpdateEvent. The UpdateEvent. This event has the following properties: Property Value bubbles false cancelable false ; there is no default behavior to cancel. The DownloadErrorEvent. The subErrorID property may contain additional information. The subErrorID property may provide more information.

The subErrorID property may contain the invalid status code. Event Object Type: flash. ErrorEvent property ErrorEvent. Defines the value of the type property of an error event object. The StatusUpdateErrorEvent. The StatusUpdateEvent.

This event has the following properties: Property Value available Indicates if if there is a different version available than one of the current application true ; false otherwise same version.

ProgressEvent property ProgressEvent. Defines the value of the type property of a progress event object. This event has the following properties: Property Value bubbles false bytesLoaded The number of items or bytes loaded at the time the listener processes the event. This event has the following properties: Property Value available Set 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.

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. The languages are listed in the same order as in the update descriptor. Language Reference only. ApplicationUpdater EventDispatcher Object.

ApplicationUpdater The constructor function. Dispatched after the initialization is complete. Occurs during validating the downloaded update file.

IO error while saving data to disk.