Adobe AIR 1.5.

2 SDK
README FILE

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

The AIR SDK includes this Readme.txt file and the SDK license.pdf file, which co
ntains the
Warranty Disclaimer and License Agreement for the Adobe AIR SDK. The AIR SDK als
o 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 applica
tion 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 ru
n time.
- AIRLocalizer.js - Assists in developing localized (multi-language) version
s of in HTML-based AIR applications.
- AIRMenuBuilder.js - Assists in creating menus in HTML-based AIR applicatio
ns.
- AIRSourceViewer.js - Lets users view source files in an AIR application.
- applicationupdater.swc - Provides Flex-based AIR applications with a frame
work 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 fr
amework for assisting in managing application updates. This version of the frame
work provides a default user interface.
- applicationupdater_ui.swf - Provides HTML-based applications with a framew
ork 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-ba
sed means of responding to changes in network connectivity to a specified host.
- servicemonitor.swf - Provides HTML-based AIR applications with an event-ba
sed means of responding to changes in network connectivity to a specified host.
 - A PROJECTS directory, which includes source files for the AIR application upd
ate framework and for the service monitor framework.
LIB
- adt.jar - The ADT executable file, which is called by the adt file (or adt.ba
t 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 feat
ure, which lets you distribute an AIR application directly from a web page.
- icons - A directory containing the default AIR application icons.
TEMPLATES
- Descriptor.1.1.xsd - An XML Schema Definition file for the AIR 1.1 applicatio
n descriptor file.
- Descriptor.1.5.xsd - An XML Schema Definition file for the AIR 1.5 applicatio
n descriptor file.
- Descriptor.1.5.1.xsd - An XML Schema Definition file for the AIR 1.5.1 applic
ation descriptor file.
- Descriptor.1.5.2.xsd - An XML Schema Definition file for the AIR 1.5.2 applic
ation descriptor file.
- descriptor-template.xml - A template of the application descriptor file, whic
h is required for each AIR application.

======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 call
ing 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 pe
ople.
5) If you're distributing your AIR application from a web page, refer to the top
ic "Distributing and installing using the seamless install feature" in "Developi
ng 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/products/flex/sdk/

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

The following Adobe AIR HTML developer documentation is available in the LiveDoc
s (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/l
earn_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

===Adobe AIR SDK License in other languages===

The Adobe AIR SDK License is also available for review on the following Adobe we
b sites.
English:
http://www.adobe.com/products/eulas/
French:
http://www.adobe.com/fr/products/eulas/
German:
http://www.adobe.com/de/products/eulas/
Italian:
http://www.adobe.com/it/products/eulas/
Spanish:
http://www.adobe.com/es/products/eulas/
Brazilian Portuguese:
http://www.adobe.com/br/products/eulas/
Japanese:
http://www.adobe.com/jp/products/eulas/
Chinese:
http://www.adobe.com/cn/products/eulas/
Korean:
http://www.adobe.com/kr/products/eulas/
Russian:
http://www.adobe.com/ru/products/eulas/