TechNote

How to Overlay the AIR SDK for Use With the Flex SDK

The instructions below call out specific versions of the Flex and AIR SDKs, 3.2.0 and 1.5, but the instructions are general. You can overlay any version of the AIR SDK on any version of the Flex SDK. If the Flex SDK is newer than the AIR SDK, it may rely on AIR functionality that isn't present, resulting in compile-time or runtime errors.

Exit Flex Builder, if you are running it.
(Optional) Back up the Flex SDK by copying the entire directory. In Flex Builder, for example, copy the directory located at:
- Windows: c:\Program Files\Adobe\Flex Builder 3\sdks\3.2.0
- Mac OS: /Applications/Adobe Flex Builder 3/sdks/3.2.0
Download the appropriate AIR SDK file for your operating system and save it to the root directory of the Flex SDK.
- Windows: AIR15_win_sdk_XXXXXX.zip
- Mac OS: AIR15_mac_sdk_XXXXXX.tbz2
Extract the contents of the AIR SDK archive and overwrite the existing SDK files.
- Windows: Right-click on the ZIP file and select "Extract All" or use the decompression tool of your choice.
- Mac OS: In Terminal, cd to the root directory of the Flex SDK and run this command:
  - ```
  tar jxvf AIR15_mac_sdk_XXXXXX.tbz2
  
  		
  
  	
```
- If you have trouble overwriting files due to file permissions, try this command:
  - ```
  sudo tar jxvf AIR15_mac_sdk_XXXXXX.tbz2
  
  		
  
  	
```

-----------------

IMPORTANT NOTE FOR MAC USERS: Currently there is an issue that may cause your AIR application to crash on the Mac if you do not remove three older resources files that are still included in Flex Builder. To remove these files:

1. In the Mac Finder, locate your "Adobe Flex Builder 3" applications folder and navigate to "/sdks/3.2.0/runtimes/air/mac/Adobe AIR.framework/Versions/1.0/Resources".

2. Remove the following files: MainMenu.nib, AuthDialog.nib, and FlashPromptDialog.nib.

-----------------

Note for Flex Builder users: Older versions of Flex Builder initialize new AIR projects to output SWF9. To use APIs available in AIR 1.5 and later, target SWF10 by modifying the project's .actionScriptProperties file to specify htmlPlayerVersion="10.0.0" in the compiler tag.