Adobe AIR 51.1 SDK
README FILE


======What's included in the SDK======

The AIR SDK includes this Readme.txt file and the AIR SDK license.pdf file, which contains the 
Warranty Disclaimer and License Agreement for the Adobe AIR SDK. The AIR SDK also includes 
the following directories:


BIN


 - adl (adl.exe on Windows) - The AIR Debug Launcher (ADL) allows you to test an AIR application without having to package and install it.

 - adt (adt.bat on Windows) - The AIR Developer Tool (ADT) packages your application as an .air file for distribution.  

FRAMEWORKS

 - A libs directory that contains the following AIR frameworks:

    - AIRAliases.js - Provides "alias" definitions that allow you to access the AIR runtime classes from Javascript.

    - airglobal.swc - Provides the core AIR API used when compiling SWF content.

    - AIRIntrospector.js - Assists in AIR application development, allowing you to inspect JavaScript properties, view the HTML DOM, and view source files at run time.  

    - AIRLocalizer.js - Assists in developing localized (multi-language) versions of in HTML-based AIR applications.

    - AIRMenuBuilder.js - Assists in creating menus in HTML-based AIR applications.

    - AIRSourceViewer.js - Lets users view source files in an AIR application. 

    - applicationupdater.swc - Provides Flex-based AIR applications with a framework for assisting in managing application updates.

    - applicationupdater.swf - Provides HTML-based applications with a framework for assisting in managing application updates.

    - applicationupdater_ui.swc - Provides Flex-based AIR applications with a framework for assisting in managing application updates. This version of the framework provides a default user interface.

    - applicationupdater_ui.swf - Provides HTML-based applications with a framework for assisting in managing application updates. This version of the framework provides a default user interface.

    - servicemonitor.swc - Provides Flex-based AIR applications with an event-based means of responding to changes in network connectivity to a specified host.

    - servicemonitor.swf - Provides HTML-based AIR applications with an event-based means of responding to changes in network connectivity to a specified host. 

    - aircore.swc - Provides Flex-based AIR applications various additional API, including service monitoring.

    - aircore.swf - Provides HTML-based AIR applications various additional API, including service monitoring.

 - A PROJECTS directory, which includes source files for the AIR application update framework, for the service monitor framework, and for Android application licensing.

LIB

 - adt.jar - The ADT executable file, which is called by the adt file (or adt.bat on Windows). 

RUNTIMES

 - The AIR runtime - The runtime is used by ADL to launch your AIR applications before they have been packaged or installed. 

SAMPLES

 - descriptor-sample.xml - A sample application descriptor file.

 - badge - A directory containing sample files for the AIR seamless install feature, which lets you distribute an AIR application directly from a web page.

 - icons - A directory containing the default AIR application icons. 

TEMPLATES/AIR

 - Descriptor.1.1.xsd - An XML Schema Definition file for the AIR 1.1 application descriptor file. 

 - Descriptor.1.5.xsd - An XML Schema Definition file for the AIR 1.5 application descriptor file. 

 - Descriptor.1.5.1.xsd - An XML Schema Definition file for the AIR 1.5.1 application descriptor file. 

 - Descriptor.1.5.2.xsd - An XML Schema Definition file for the AIR 1.5.2 application descriptor file. 

 - Descriptor.1.5.3.xsd - An XML Schema Definition file for the AIR 1.5.3 application descriptor file. 

 - Descriptor.2.0.xsd - An XML Schema Definition file for the AIR 2.0 application descriptor file. 

 - Descriptor.2.5.xsd - An XML Schema Definition file for the AIR 2.5 application descriptor file. 

 - Descriptor.2.6.xsd - An XML Schema Definition file for the AIR 2.6 application descriptor file. 

 - Descriptor.2.7.xsd - An XML Schema Definition file for the AIR 2.7 application descriptor file. 

 - Descriptor.3.0.xsd - An XML Schema Definition file for the AIR 3.0 application descriptor file. 

 - Descriptor.3.1.xsd - An XML Schema Definition file for the AIR 3.1 application descriptor file. 
 
 - Descriptor.3.2.xsd - An XML Schema Definition file for the AIR 3.2 application descriptor file. 
 
 - Descriptor.3.3.xsd - An XML Schema Definition file for the AIR 3.3 application descriptor file. 

 - Descriptor.3.4.xsd - An XML Schema Definition file for the AIR 3.4 application descriptor file. 

 - Descriptor.3.5.xsd - An XML Schema Definition file for the AIR 3.5 application descriptor file. 
 
 - Descriptor.3.6.xsd - An XML Schema Definition file for the AIR 3.6 application descriptor file. 

 - Descriptor.3.7.xsd - An XML Schema Definition file for the AIR 3.7 application descriptor file. 

 - Descriptor.3.8.xsd - An XML Schema Definition file for the AIR 3.8 application descriptor file.
 
 - Descriptor.3.9.xsd - An XML Schema Definition file for the AIR 3.9 application descriptor file.

 - Descriptor.4.0.xsd - An XML Schema Definition file for the AIR 4.0 application descriptor file.

 - Descriptor.13.0.xsd - An XML Schema Definition file for the AIR 13.0 application descriptor file.

 - Descriptor.14.0.xsd - An XML Schema Definition file for the AIR 14.0 application descriptor file.

 - Descriptor.15.0.xsd - An XML Schema Definition file for the AIR 15.0 application descriptor file.

 - Descriptor.16.0.xsd - An XML Schema Definition file for the AIR 16.0 application descriptor file.

 - Descriptor.17.0.xsd - An XML Schema Definition file for the AIR 17.0 application descriptor file.

 - Descriptor.18.0.xsd - An XML Schema Definition file for the AIR 18.0 application descriptor file.

 - Descriptor.19.0.xsd - An XML Schema Definition file for the AIR 19.0 application descriptor file.

 - Descriptor.20.0.xsd - An XML Schema Definition file for the AIR 20.0 application descriptor file.

 - Descriptor.21.0.xsd - An XML Schema Definition file for the AIR 21.0 application descriptor file.

 - Descriptor.22.0.xsd - An XML Schema Definition file for the AIR 22.0 application descriptor file.

 - Descriptor.23.0.xsd - An XML Schema Definition file for the AIR 23.0 application descriptor file.

 - Descriptor.24.0.xsd - An XML Schema Definition file for the AIR 24.0 application descriptor file.

 - Descriptor.25.0.xsd - An XML Schema Definition file for the AIR 25.0 application descriptor file.

 - Descriptor.26.0.xsd - An XML Schema Definition file for the AIR 26.0 application descriptor file.

 - Descriptor.27.0.xsd - An XML Schema Definition file for the AIR 27.0 application descriptor file.

 - Descriptor.28.0.xsd - An XML Schema Definition file for the AIR 28.0 application descriptor file.

 - Descriptor.29.0.xsd - An XML Schema Definition file for the AIR 29.0 application descriptor file.

 - Descriptor.30.0.xsd - An XML Schema Definition file for the AIR 30.0 application descriptor file.

 - Descriptor.31.0.xsd - An XML Schema Definition file for the AIR 31.0 application descriptor file.

 - Descriptor.32.0.xsd - An XML Schema Definition file for the AIR 32.0 application descriptor file.

 - Descriptor.33.1.xsd - An XML Schema Definition file for the AIR 33.1 application descriptor file.

 - Descriptor.50.0.xsd - An XML Schema Definition file for the AIR 50.0 application descriptor file.

 - Descriptor.50.1.xsd - An XML Schema Definition file for the AIR 50.1 application descriptor file.

 - Descriptor.50.2.xsd - An XML Schema Definition file for the AIR 50.2 application descriptor file.

 - Descriptor.51.0.xsd - An XML Schema Definition file for the AIR 51.0 application descriptor file.

 - Descriptor.51.1.xsd - An XML Schema Definition file for the AIR 51.1 application descriptor file.

 - descriptor-template.xml - A template of the application descriptor file, which is required for each AIR application. 


TEMPLATES/EXTENSIONS

 - Descriptor.2.5.xsd - An XML Schema Definition file for the AIR 2.5 extension descriptor file. 

 - Descriptor.3.1.xsd - An XML Schema Definition file for the AIR 3.1 extension descriptor file. 

 - Descriptor.3.2.xsd - An XML Schema Definition file for the AIR 3.2 extension descriptor file. 

 - Descriptor.3.3.xsd - An XML Schema Definition file for the AIR 3.3 extension descriptor file. 

 - Descriptor.3.4.xsd - An XML Schema Definition file for the AIR 3.4 extension descriptor file. 

 - Descriptor.3.5.xsd - An XML Schema Definition file for the AIR 3.5 extension descriptor file. 
 
 - Descriptor.3.6.xsd - An XML Schema Definition file for the AIR 3.6 extension descriptor file. 

 - Descriptor.3.7.xsd - An XML Schema Definition file for the AIR 3.7 extension descriptor file. 

 - Descriptor.3.8.xsd - An XML Schema Definition file for the AIR 3.8 extension descriptor file. 
 
 - Descriptor.3.9.xsd - An XML Schema Definition file for the AIR 3.9 extension descriptor file. 

 - Descriptor.4.0.xsd - An XML Schema Definition file for the AIR 4.0 extension descriptor file. 

 - Descriptor.13.0.xsd - An XML Schema Definition file for the AIR 13.0 extension descriptor file. 

 - Descriptor.14.0.xsd - An XML Schema Definition file for the AIR 14.0 extension descriptor file. 

 - Descriptor.15.0.xsd - An XML Schema Definition file for the AIR 15.0 extension descriptor file. 

 - Descriptor.16.0.xsd - An XML Schema Definition file for the AIR 16.0 extension descriptor file. 

 - Descriptor.17.0.xsd - An XML Schema Definition file for the AIR 17.0 extension descriptor file. 

 - Descriptor.18.0.xsd - An XML Schema Definition file for the AIR 18.0 extension descriptor file. 

 - Descriptor.19.0.xsd - An XML Schema Definition file for the AIR 19.0 extension descriptor file. 

 - Descriptor.20.0.xsd - An XML Schema Definition file for the AIR 20.0 extension descriptor file. 

 - Descriptor.21.0.xsd - An XML Schema Definition file for the AIR 21.0 extension descriptor file. 

 - Descriptor.22.0.xsd - An XML Schema Definition file for the AIR 22.0 extension descriptor file. 

 - Descriptor.23.0.xsd - An XML Schema Definition file for the AIR 23.0 extension descriptor file. 

 - Descriptor.24.0.xsd - An XML Schema Definition file for the AIR 24.0 extension descriptor file. 

 - Descriptor.25.0.xsd - An XML Schema Definition file for the AIR 25.0 extension descriptor file. 

 - Descriptor.26.0.xsd - An XML Schema Definition file for the AIR 26.0 extension descriptor file. 

 - Descriptor.27.0.xsd - An XML Schema Definition file for the AIR 27.0 extension descriptor file. 

 - Descriptor.28.0.xsd - An XML Schema Definition file for the AIR 28.0 extension descriptor file. 

 - Descriptor.29.0.xsd - An XML Schema Definition file for the AIR 29.0 extension descriptor file. 

 - Descriptor.30.0.xsd - An XML Schema Definition file for the AIR 30.0 extension descriptor file. 

 - Descriptor.31.0.xsd - An XML Schema Definition file for the AIR 31.0 extension descriptor file. 

 - Descriptor.32.0.xsd - An XML Schema Definition file for the AIR 32.0 extension descriptor file. 

 - Descriptor.33.0.xsd - An XML Schema Definition file for the AIR 33.1 extension descriptor file. 

 - Descriptor.50.0.xsd - An XML Schema Definition file for the AIR 50.0 extension descriptor file.

 - Descriptor.50.1.xsd - An XML Schema Definition file for the AIR 50.1 extension descriptor file.

 - Descriptor.50.2.xsd - An XML Schema Definition file for the AIR 50.2 extension descriptor file.

 - Descriptor.51.0.xsd - An XML Schema Definition file for the AIR 51.0 extension descriptor file.

 - Descriptor.51.1.xsd - An XML Schema Definition file for the AIR 51.1 extension descriptor file.

 - extension-descriptor-template.xml -  A template of the extension descriptor file, which is required for each AIR extension.


TEMPLATES/EXTENSIONS/iOS

 - Descriptor.3.1.xsd - An XML Schema Definition file for the AIR 3.1 iOS platform descriptor file.

 - Descriptor.3.2.xsd - An XML Schema Definition file for the AIR 3.2 iOS platform descriptor file.
 
 - Descriptor.3.3.xsd - An XML Schema Definition file for the AIR 3.3 iOS platform descriptor file.
 
 - Descriptor.3.4.xsd - An XML Schema Definition file for the AIR 3.4 iOS platform descriptor file.

 - Descriptor.3.5.xsd - An XML Schema Definition file for the AIR 3.5 iOS platform descriptor file.
 
 - Descriptor.3.6.xsd - An XML Schema Definition file for the AIR 3.6 iOS platform descriptor file.

 - Descriptor.3.7.xsd - An XML Schema Definition file for the AIR 3.7 iOS platform descriptor file. 

 - Descriptor.3.8.xsd - An XML Schema Definition file for the AIR 3.8 iOS platform descriptor file. 
 
 - Descriptor.3.9.xsd - An XML Schema Definition file for the AIR 3.9 iOS platform descriptor file. 

 - Descriptor.4.0.xsd - An XML Schema Definition file for the AIR 4.0 iOS platform descriptor file. 

 - Descriptor.13.0.xsd - An XML Schema Definition file for the AIR 13.0 iOS platform descriptor file. 

 - Descriptor.14.0.xsd - An XML Schema Definition file for the AIR 14.0 iOS platform descriptor file. 

 - Descriptor.15.0.xsd - An XML Schema Definition file for the AIR 15.0 iOS platform descriptor file. 

 - Descriptor.16.0.xsd - An XML Schema Definition file for the AIR 16.0 iOS platform descriptor file. 

 - Descriptor.17.0.xsd - An XML Schema Definition file for the AIR 17.0 iOS platform descriptor file. 

 - Descriptor.18.0.xsd - An XML Schema Definition file for the AIR 18.0 iOS platform descriptor file. 

 - Descriptor.19.0.xsd - An XML Schema Definition file for the AIR 19.0 iOS platform descriptor file. 

 - Descriptor.20.0.xsd - An XML Schema Definition file for the AIR 20.0 iOS platform descriptor file. 

 - Descriptor.21.0.xsd - An XML Schema Definition file for the AIR 21.0 iOS platform descriptor file. 

 - Descriptor.22.0.xsd - An XML Schema Definition file for the AIR 22.0 iOS platform descriptor file. 

 - Descriptor.23.0.xsd - An XML Schema Definition file for the AIR 23.0 iOS platform descriptor file. 

 - Descriptor.24.0.xsd - An XML Schema Definition file for the AIR 24.0 iOS platform descriptor file. 

 - Descriptor.25.0.xsd - An XML Schema Definition file for the AIR 25.0 iOS platform descriptor file. 

 - Descriptor.26.0.xsd - An XML Schema Definition file for the AIR 26.0 iOS platform descriptor file. 

 - Descriptor.27.0.xsd - An XML Schema Definition file for the AIR 27.0 iOS platform descriptor file. 

 - Descriptor.28.0.xsd - An XML Schema Definition file for the AIR 28.0 iOS platform descriptor file. 

 - Descriptor.29.0.xsd - An XML Schema Definition file for the AIR 29.0 iOS platform descriptor file. 

 - Descriptor.30.0.xsd - An XML Schema Definition file for the AIR 30.0 iOS platform descriptor file. 

 - Descriptor.31.0.xsd - An XML Schema Definition file for the AIR 31.0 iOS platform descriptor file. 

 - Descriptor.32.0.xsd - An XML Schema Definition file for the AIR 32.0 iOS platform descriptor file. 

 - Descriptor.33.1.xsd - An XML Schema Definition file for the AIR 33.1 iOS platform descriptor file. 

 - Descriptor.50.0.xsd - An XML Schema Definition file for the AIR 50.0 iOS platform descriptor file. 

 - Descriptor.50.1.xsd - An XML Schema Definition file for the AIR 50.1 iOS platform descriptor file. 

 - Descriptor.50.2.xsd - An XML Schema Definition file for the AIR 50.2 iOS platform descriptor file. 

 - Descriptor.51.0.xsd - An XML Schema Definition file for the AIR 51.0 iOS platform descriptor file. 

 - Descriptor.51.1.xsd - An XML Schema Definition file for the AIR 51.1 iOS platform descriptor file. 

 - platform-descriptor-template.xml - A template of the iOS platform descriptor file, for iOS platform specific options.


TEMPLATES/EXTENSIONS/ANDROID

 - Descriptor.3.1.xsd - An XML Schema Definition file for the AIR 3.1 Android platform descriptor file.

 - Descriptor.3.2.xsd - An XML Schema Definition file for the AIR 3.2 Android platform descriptor file.
 
 - Descriptor.3.3.xsd - An XML Schema Definition file for the AIR 3.3 Android platform descriptor file.
 
 - Descriptor.3.4.xsd - An XML Schema Definition file for the AIR 3.4 Android platform descriptor file.

 - Descriptor.3.5.xsd - An XML Schema Definition file for the AIR 3.5 Android platform descriptor file.
 
 - Descriptor.3.6.xsd - An XML Schema Definition file for the AIR 3.6 Android platform descriptor file.

 - Descriptor.3.7.xsd - An XML Schema Definition file for the AIR 3.7 Android platform descriptor file. 

 - Descriptor.3.8.xsd - An XML Schema Definition file for the AIR 3.8 Android platform descriptor file. 
 
 - Descriptor.3.9.xsd - An XML Schema Definition file for the AIR 3.9 Android platform descriptor file. 

 - Descriptor.4.0.xsd - An XML Schema Definition file for the AIR 4.0 Android platform descriptor file. 

 - Descriptor.13.0.xsd - An XML Schema Definition file for the AIR 13.0 Android platform descriptor file. 

 - Descriptor.14.0.xsd - An XML Schema Definition file for the AIR 14.0 Android platform descriptor file. 

 - Descriptor.15.0.xsd - An XML Schema Definition file for the AIR 15.0 Android platform descriptor file. 

 - Descriptor.16.0.xsd - An XML Schema Definition file for the AIR 16.0 Android platform descriptor file. 

 - Descriptor.17.0.xsd - An XML Schema Definition file for the AIR 17.0 Android platform descriptor file. 

 - Descriptor.18.0.xsd - An XML Schema Definition file for the AIR 18.0 Android platform descriptor file. 

 - Descriptor.19.0.xsd - An XML Schema Definition file for the AIR 19.0 Android platform descriptor file. 

 - Descriptor.20.0.xsd - An XML Schema Definition file for the AIR 20.0 Android platform descriptor file. 

 - Descriptor.21.0.xsd - An XML Schema Definition file for the AIR 21.0 Android platform descriptor file. 

 - Descriptor.22.0.xsd - An XML Schema Definition file for the AIR 22.0 Android platform descriptor file. 

 - Descriptor.23.0.xsd - An XML Schema Definition file for the AIR 23.0 Android platform descriptor file. 

 - Descriptor.24.0.xsd - An XML Schema Definition file for the AIR 24.0 Android platform descriptor file. 

 - Descriptor.25.0.xsd - An XML Schema Definition file for the AIR 25.0 Android platform descriptor file. 

 - Descriptor.26.0.xsd - An XML Schema Definition file for the AIR 26.0 Android platform descriptor file. 

 - Descriptor.27.0.xsd - An XML Schema Definition file for the AIR 27.0 Android platform descriptor file. 

 - Descriptor.28.0.xsd - An XML Schema Definition file for the AIR 28.0 Android platform descriptor file. 

 - Descriptor.29.0.xsd - An XML Schema Definition file for the AIR 29.0 Android platform descriptor file. 

 - Descriptor.30.0.xsd - An XML Schema Definition file for the AIR 30.0 Android platform descriptor file. 

 - Descriptor.31.0.xsd - An XML Schema Definition file for the AIR 31.0 Android platform descriptor file. 

 - Descriptor.32.0.xsd - An XML Schema Definition file for the AIR 32.0 Android platform descriptor file. 

 - Descriptor.33.1.xsd - An XML Schema Definition file for the AIR 33.1 Android platform descriptor file. 

 - Descriptor.50.0.xsd - An XML Schema Definition file for the AIR 50.0 Android platform descriptor file. 

 - Descriptor.50.1.xsd - An XML Schema Definition file for the AIR 50.1 Android platform descriptor file. 

 - Descriptor.50.2.xsd - An XML Schema Definition file for the AIR 50.2 Android platform descriptor file. 

 - Descriptor.51.0.xsd - An XML Schema Definition file for the AIR 51.0 Android platform descriptor file. 

 - Descriptor.51.1.xsd - An XML Schema Definition file for the AIR 51.1 Android platform descriptor file. 


======iOS Target Support======

If you have downloaded a version of the AIR SDK that supports packaging iOS targets, additional files will be included. The following files and folders in the AIR SDK contain the tools that enable you to compile AIR applications into .ipa files for iOS devices.

LIB
 - AOT - Directory containing the files necessary for the AOT (Ahead of Time) Compiler used by ADT


======Getting Started with the AIR SDK======

1) Build your source files using the editor of your choice. Arrange them as you would on a web server, in a single folder with relative references.

2) If you are using the AIR APIs in JavaScript, include a <script> reference to the AIRAliases.js file. AIR APIs are only available to your application content (not to content loaded from remote sources). Also, there are limitations on calling the eval() function and similar APIs in AIR application content. For details, see the AIR SDK documentation (listed below).

3) Use ADL to test your application with the debugger.

4) Use ADT to build an application installer that can be distributed to other people.

5) If you're distributing your AIR application from a web page, refer to the topic "Distributing and installing using the seamless install feature" in "Developing Adobe AIR Applications with HTML and Ajax". 

More information about all of these steps is available in the "Developing Adobe AIR Applications with HTML and Ajax". See the next section for the locations of the AIR documentation.

If you want to build Flex-based AIR applications, download the Flex SDK: http://www.adobe.com/go/flex_sdk/


======AIR SDK Documentation======

The following Adobe AIR HTML developer documentation is available in the LiveDocs (online) format: 

 - Developing Adobe AIR Applications with HTML and Ajax -- http://www.adobe.com/go/learn_air_html
 - Adobe AIR Quick Starts for HTML -- http://www.adobe.com/go/learn_air_html_qs
 - Adobe AIR Language Reference for HTML Developers -- http://www.adobe.com/go/learn_air_html_jslr 


===Downloading Adobe AIR HTML documentation===

The Adobe AIR HTML documentation set (a ZIP file) is available for download here:

  http://www.adobe.com/go/learn_air_html_docs

