1. Home
2. Support
3. Documentation
4. AIR Documentation

Release notes for Adobe AIR developers

Release date: 7/30/09

Getting Started

Welcome to the release notes for AIR 1.5.2. This document contains system requirements, installation instructions, known issues, and other information about using the AIR 1.5.2 runtime. Please refer to the Adobe AIR 1.5.1 release notes for additional information. Please use the Adobe AIR feedback form to report feature requests, bugs or improvements to the release notes.

• System requirements
• New features in AIR 1.5.2
• API changes
• Version information
• Fixed bugs
• Known issues
• Installing Adobe AIR
• Install AIR applications
• Tips and tricks
• Adobe AIR SDK

System requirements

For current Adobe AIR system requirements, please visit http://www.adobe.com/products/air/systemreqs/.

New features in AIR 1.5.2

Adobe AIR 1.5.2 is an update to the Adobe AIR runtime and SDK. This update includes improved reliability, compatibility, and security. It is recommended for all AIR users. AIR applications developed for previous versions of AIR do not need to be updated to work with this update.

The AIR application installer panel that displays the publisher identity has been simplified when an application is signed with a chained certificate.

API changes

• Before AIR 1.5.2, pressing the ESC key in full-screen or full-screen interactive mode would exit full-screen mode, and there was no way to prevent it. With AIR 1.5.2, when using the full-screen interactive mode an application using the 1.5.2 namespace can capture the keyDown event and call the preventDefault() method of the event. This change only affects the full-screen interactive mode; the full-screen mode is not affected.
• Before AIR 1.5.2, SWF content embedded in and HTML container in a transparent window could not be displayed. With AIR 1.5.2, SWF content can be displayed with certain wmode settings.
• The network timeout is now 60 minutes on Windows and Mac OS.
• In addition, new APIs have been added. Update your application descriptor file to the 1.5.2 namespace in order to access the new AIR 1.5.2 APIs and behavior. To update the namespace, change the xmlns attribute to:
  xmlns="http://ns.adobe.com/air/application/1.5.2"
• Capabilities.supports32BitProcesses and Capabilities.supports64BitProcesses - These properties indicate whether the system supports 64-bit or 32-bit processes.
  • LocalConnection.isPerUser - This property indicates whether LocalConnection objects are scoped to the current user (true) or are globally accessible to all users on the computer (false). This property only affects content running on Mac OS; other platforms ignore this parameter. For example, local connections on Windows and Linux are always per-user. In previous versions, all LocalConnection objects on Mac OS had a global scope. For security reasons, always set this property to true, unless you need to preserve compatibility with previous versions. In future releases, this property is likely to have a default value of true.
  • System.disposeXML(xml:XML) - This static method makes an XML object immediately available for garbage collection. This method removes parent and child connections between all the nodes for the specified XML object. This method takes one parameter: the XML object to be made available for garbage collection. Use this method to ensure the efficient disposal of memory associated with XML objects.

Version information

WebKit Version

AIR 1.5.2 includes WebKit version 34190.

Latest Flash Player plug-in

AIR 1.5.2 includes an updated version of the Flash Player plug-in (10.0.32), which is used when displaying SWF content embedded in HTML. For more information, see http://www.adobe.com/support/documentation/en/flashplayer/releasenotes.html.

Fixed bugs

Known issues

Sidecar installation on Windows

When a bundled installation of the AIR runtime is performed from a removable drive or CD/DVD, you may run into an issue if the previous version of the AIR runtime is already installed  and the bundled AIR runtime installer is not located at the root of the removable media. To avoid this issue, please make sure the sidecar installer file is deployed at the root of the removal media.

Custom Root Certificate on Mac OS 10.5.7

If a user manually installs a custom Certificate Authority (CA) on Mac OS 10.5.7 and then tries to install an AIR file signed with a certificate issued by the CA, the installer dialog box might not display the publisher name and the certificate is not verified. This OS-specific issue affects all AIR versions. Apple's knowledge base has an article discussing a similar issue at http://support.apple.com/kb/TS2747 . If a user uses the command line method described in this article to install the CA, then the certificate is verified and the publisher name is displayed.
sudo security add-trusted-cert -d -k /Library/Keychains/System.keychain /path/to/ca.crt

HTML transparent overlays

The current WebKit version does not correctly display transparent overlays that may be associated with Google Maps (GPolyline opacity fails). As a workaround, please change the userAgent property of the HTMLoader object to a value other than "AppleWebKit." By doing so, the client detection code from Google Maps switches to the last fallback for rendering overlays (server rendering).

Encrypted local store

For troubleshooting of encrypted local store issues on Linux, please read http://kb2.adobe.com/cps/492/cpsid_49267.html.

Installing Adobe AIR

Please read AIR 1.5.1 release notes or http://go.adobe.com/kb/ts_kb403150_en-us.

Linux

• Though 64-bit Linux is not supported officially, by installing 32-bit dependencies on it, it can be made to work. Please read here: http://kb2.adobe.com/cps/408/kb408084.html

Install AIR applications

Please read AIR 1.5.1 release notes.

• For the HTML embed tag that loads the badge.swf file, do not set the wmode attribute; leave it set to the default setting ("window"). Other wmode settings will prevent installation on some systems. Read related note here : http://help.adobe.com/en_US/AIR/1.5/devappsflash/WS5b3ccc516d4fbf351e63e3d118666ade46-7e15.html#WS5b3ccc516d4fbf351e63e3d118666ade46-7c88

Tips and tricks

Linux

• Download the binary installer and give execution permissions to it before installing. You can do this in one of two ways:
  • Right-click the downloaded installer file icon, select Properties, and then set execution permissions.
  • Open a terminal and type chmod +x to give it execution permissions.
• After giving execution permissions to installer. If double click on it (to launch it), gives an error (e.g: on Ubuntu 904). Remove .bin from "AdobeAIRInstaller.bin" file name, and double click again, to launch it.
• Generating installation error logs:
  • Read here how user can generate runtime installation failure logs, which can help us in narrowing down the issue: http://kb2.adobe.com/cps/403/kb403123.html
• Adobe AIR and AIR applications are installed as native applications, so you can use package managers to uninstall them, as in either of the following
  • sudo rpm -e
  • sudo dpkg -P
• You can also install AIR applications using the command /usr/bin/AdobeAIRInstaller.bin . Currently, relative paths do not work.
• If after installing Adobe AIR, double-clicking an .air file does not launch the AIR application installer, you might have to log out and log back in. (This happens on some older distributions.)
• To clean up the machine and try a fresh installation, you may need to remove the .adobe and .macromedia folder in the home directory for both root and the current user. Also remove the .appdata folder in the home directory.
• To generate logs for Adobe AIR runtime installation, create the empty file .airinstall.log (touch .airinstall.log) in user home directory. Please post this file when reporting issues in the forum.
• To generate logs for AIR application installation, create the empty file .airappinstall.log (touch .airappinstall.log) in the user's home directory. Please post this file while reporting issues in the forum.

Adobe AIR SDK

For overlaying AIR SDK for use with Flex SDK, please read AIR 1.5.1 release notes.

Linux

• Minimum required version of Sun Java/JRE is 1.5.