Building Adobe AIR Applications

300 Pages·2017·5.74 MB·English

by  Adobe Systems Incorporated

® ®
Building ADOBE AIR Applications
Legal notices
Legal notices
For legal notices, see http://help.adobe.com/en_US/legalnotices/index.html.
Last updated 5/16/2017
iii
Contents
Chapter 1: About Adobe AIR
Chapter 2: Adobe AIR installation
Installing Ad obe AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Removing Ad obe AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Installing and running the AIR sample applica tions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Adobe AIR updat es . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Chapter 3: Working with the AIR APIs
AIR-specific ActionScri pt 3.0 classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Flash Player classes with AIR-specific functionalit y . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
AIR-specific Flex componen ts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Chapter 4: Adobe Flash Platform tools for AIR development
I nstalling the AIR SDK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Setting up the Fle x SDK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Setting up extern al SDKs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Chapter 5: Creating your first AIR application
Creating your first desktop Flex AIR application in F lash Builder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Creating your first desktop AIR application using Flash Prof essional . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Create your first AIR application for Android in Flash Prof essional . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Creating your first AIR application f or iOS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Create your first HTML-based AIR application with Dreamweav er . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Creating your first HTML-based AIR applica tion with the AIR SDK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Creating your first desktop AIR application with the Fle x SDK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Creating your first AIR application for Android with the Fle x SDK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Chapter 6: Developing AIR applications for the desktop
Workflow for developing a desktop AIR applica tion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Setting desktop application propert ies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Debugging a desktop AIR applica tion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Packaging a desktop AIR installa tion file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Packaging a desktop native installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Packaging a captive runtime bundle for desktop comput ers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Distributing AIR packages for desktop comput ers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Chapter 7: Developing AIR applications for mobile devices
Setting up your development environmen t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Mobile application design considera tions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Workflow for creating AIR applications for . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .mobile devic es 66
Setting mobile application propert ies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Packaging a mobile AIR applica tion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Debugging a mobile AIR applicat ion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Last updated 5/16/2017
BUILDING ADOBE AIR APPLICATIONS iv
Contents
Installing AIR and AIR applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .on mobile devic es 104
Updating mobile AIR applicat ions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Use push notifica tions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Chapter 8: Developing AIR applications for television devices
AIR capabilities for TVs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
AIR for TV application design considera tions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
Workflow for developing an AIR for TV applica tion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
AIR for TV application descriptor propert ies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
Packaging an AIR for TV applica tion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
Debugging AIR for TV applicat ions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
Chapter 9: Using native extensions for Adobe AIR
AIR Native Extension ( ANE) files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
Native extensions versus the NativeProcess ActionScr ipt class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
Native extensions versus ActionScript class librar ies (SWC files) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
Supported device s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
Supported device pr ofiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
Task list for using a native ext ension . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
Declaring the extension in your application descript or file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
Including the ANE file in your application’s library pa th . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
Packaging an application that uses native ext ensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
Chapter 10: ActionScript compilers
About the AIR command-line tools in the Fle x SDK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
Co mpiler setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
Compiling MXML and ActionScript source files f or AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
Compiling an AIR component or code library (Fle x) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
Chapter 11: AIR Debug Launcher (ADL)
A DL usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
A DL Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
ADL exit and error co des . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
Chapter 12: AIR Developer Tool (ADT)
ADT c ommands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
AD T option sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
ADT err or messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
ADT environment var iables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
Chapter 13: Signing AIR applications
Digitally sig ning an AIR file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
Creating an unsigned AIR intermediate file with AD T . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
Signing an AIR intermediate file with AD T . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
Signing an updated version of an AIR applica tion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
Creating a self-signed certificate with AD T . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
Last updated 5/16/2017
BUILDING ADOBE AIR APPLICATIONS v
Contents
Chapter 14: AIR application descriptor files
Application descripto r changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
The application descriptor file structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
AIR application descriptor element s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
Chapter 15: Device profiles
Restricting target profiles in the application descripto r file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
Capabilities of different pr ofiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
Chapter 16: AIR.SWF in-browser API
Customizing the seamless install badge .swf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
Using the badge.swf file to install an AIR applica tion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
Loading the air .swf file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
Checking if the runt ime is installed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
Checking from a web page if an AIR applica tion is installed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
Installing an AIR application from the brows er . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
Launching an installed AIR application from the brow ser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
Chapter 17: Updating AIR applications
About updating applicat ions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
Presenting a custom application update user interfac e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
Downloading an AIR file to the user’s comput er . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
Checking to see if an application is running f or the first time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
Using the update framewor k . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255
Chapter 18: Viewing Source Code
Loading, configuring, and opening the Source View er . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
Source Viewer user interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
Chapter 19: Debugging with the AIR HTML Introspector
About the AIR Introspect or . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
Loading the AIR Introspector c ode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
Inspecting an object in the Co nsole tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272
Configuring the AIR Introspect or . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274
AIR Introspector interfac e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274
Using the AIR Introspector with content in a non-application sandbo x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280
Chapter 20: Localizing AIR applications
Localizing the application name and description in the AIR applicat ion installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282
Localizing HTML content with the AIR HTML localization framewor k . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283
Chapter 21: Path environment variables
Setting the PATH on Linux and M ac OS using the Bash shell . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
Setting the Path on Window s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294
Last updated 5/16/2017
1
Chapter 1: About Adobe AIR
Adobe® AIR® is a multi-operating system, multi-screen runtime that allows you to leverage your web development
skills to build and deploy rich Internet applications (RIAs) to the desktop and mobile devices. Desktop, television, and
mobile AIR applications can be built with ActionScript 3.0 using Adobe® Flex and Adobe® Flash® (SWF based).
Desktop AIR applications can also be built with HTML, JavaScript®, and Ajax (HTML based).
You can find more information about getting started with and using Adobe AIR at the Adobe AIR Developer
Connection (http://www.adobe.com/devnet/air/).
AIR enables you to work in familiar environments, to leverage the tools and approaches you find most comfortable.
By supporting Flash, Flex, HTML, JavaScript, and Ajax, you can build the best possible experience that meets your
needs.
For example, applications can be developed using one or a combination of the following technologies:
(cid:129) Flash / Flex / ActionScript
(cid:129) HTML / JavaScript / CSS / Ajax
Users interact with AIR applications in the same way that they interact with native applications. The runtime is
installed once on the user's computer or device, and then AIR applications are installed and run just like any other
desktop application. (On iOS, a separate AIR runtime is not installed; each iOS AIR app is a stand-alone application.)
The runtime provides a consistent cross-operating system platform and framework for deploying applications and
therefore eliminates cross-browser testing by ensuring consistent functionality and interactions across desktops.
Instead of developing for a specific operating system, you target the runtime, which has the following benefits:
(cid:129) Applications developed for AIR run across multiple operating systems without any additional work by you. The
runtime ensures consistent and predictable presentation and interactions across all the operating systems
supported by AIR.
(cid:129) Applications can be built faster by enabling you to leverage existing web technologies and design patterns. You can
extend web-based applications to the desktop without learning traditional desktop development technologies or
the complexity of native code.
(cid:129) Application development is easier than using lower-level languages such as C and C++. You do not need to manage
the complex, low-level APIs specific to each operating system.
When developing applications for AIR, you can leverage a rich set of frameworks and APIs:
(cid:129) APIs specific to AIR provided by the runtime and the AIR framework
(cid:129) ActionScript APIs used in SWF files and Flex framework (as well as other ActionScript based libraries and
frameworks)
(cid:129) HTML, CSS, and JavaScript
(cid:129) Most Ajax frameworks
(cid:129) Native extensions for Adobe AIR, which provide ActionScript APIs that provide you access to platform-specific
functionality programmed in native code. Native extensions can also provide access to legacy native code, and
native code that provides higher performance.
Last updated 5/16/2017
BUILDING ADOBE AIR APPLICATIONS 2
About Adobe AIR
AIR dramatically changes how applications can be created, deployed, and experienced. You gain more creative control
and can extend your Flash, Flex, HTML, and Ajax-based applications to the desktop, mobile devices, and televisions.
For information about what is included in each new AIR update, see the Adobe AIR Release Notes
(http://www.adobe.com/go/learn_air_relnotes_en).
Last updated 5/16/2017
3
Chapter 2: Adobe AIR installation
The Adobe® AIR® runtime allows you to run AIR applications. You can install the runtime in the following ways:
(cid:129) By installing the runtime separately (without also installing an AIR application)
(cid:129) By installing an AIR application for the first time through a web page installation “badge” (you are prompted to
also install the runtime)
(cid:129) By creating a custom installer that installs both your application and the runtime. You must get approval from
Adobe to distribute the AIR runtime in this fashion. You can request approval on the Adobe runtime licensing
page. Note that Adobe does not provide tools for building such an installer. Many third-party installer toolkits are
available, however.
(cid:129) By installing an AIR application that bundles AIR as a captive runtime. A captive runtime is used only by the
bundling application. It is not used to run other AIR applications. Bundling the runtime is an option on Mac and
Windows. On iOS, all applications include a bundled runtime. As of AIR 3.7, all Android applications include a
bundled runtime by default (although you have the option of using a separate runtime).
(cid:129) By setting up an AIR development environment such as the AIR SDK, Adobe® Flash® Builder™ , or the Adobe Flex®
SDK (which includes the AIR command line development tools). The runtime included in the SDK is only used
when debugging applications — it is not used to run installed AIR applications.
The system requirements for installing AIR and running AIR applications are detailed here: Adobe AIR: System
requirements (http://www.adobe.com/products/air/systemreqs/).
Both the runtime installer and the AIR application installer create log files when they install, update, or remove AIR
applications or the AIR runtime itself. You can consult these logs to help determine the cause of any installation
problems. See Installation logs.
Installing Adobe AIR
To install or update the runtime, a user must have administrative privileges for the computer.
Install the runtime on a Windows computer
1 Download the runtime installation file from http://get.adobe.com/air.
2 Double-click the runtime installation file.
3 In the installation window, follow the prompts to complete the installation.
Install the runtime on a Mac computer
1 Download the runtime installation file from http://get.adobe.com/air.
2 Double-click runtime installation file.
3 In the installation window, follow the prompts to complete the installation.
4 If the Installer displays an Authenticate window, enter your Mac OS user name and password.
Install the runtime on a Linux computer
Note: At this time, AIR 2.7 and later are not supported on Linux. AIR applications deployed to Linux should continue to
use the AIR 2.6 SDK.
Last updated 5/16/2017
BUILDING ADOBE AIR APPLICATIONS 4
Adobe AIR installation
Using the binary installer:
1 Locate the installation binary file from http://kb2.adobe.com/cps/853/cpsid_85304.html and download.
2 Set the file permissions so that the installer application can be executed. From a command line, you can set the file
permissions with:
chmod +x AdobeAIRInstaller.bin
Some versions of Linux allow you to set the file permissions on the Properties dialog opened through a context menu.
3 Run the installer from the command line or by double-clicking the runtime installation file.
4 In the installation window, follow the prompts to complete the installation.
Adobe AIR is installed as a native package. In other words, as rpm on an rpm based distribution and deb on a Debian
distribution. Currently AIR does not support any other package format.
Using the package installers:
1 Locate the AIR package file from http://kb2.adobe.com/cps/853/cpsid_85304.html. Download the rpm or Debian
package, depending on which package format your system supports.
2 If needed, double-click AIR package file to install the package.
You can also install from the command line:
a On a Debian system:
sudo dpkg -i <path to the package>/adobeair-2.0.0.xxxxx.deb
b On an rpm-based system:
sudo rpm -i <path to the package>/adobeair-2.0.0-xxxxx.i386.rpm
Or, if you are updating an existing version (AIR 1.5.3 or later):
sudo rpm -U <path to the package>/adobeair-2.0.0-xxxxx.i386.rpm
Installing AIR 2 and AIR applications requires you to have administrator privileges on your computer.
Adobe AIR is installed to the following location: /opt/Adobe AIR/Versions/1.0
AIR registers the mime-type "application/vnd.adobe.air-application-installer-package+zip", which means that .air files
are of this mime-type and are therefore registered with the AIR runtime.
Install the runtime on an Android device
You can install the latest release of the AIR runtime from the Android Market.
You can install development versions of the AIR runtime from a link on a web page or by using the ADT -
installRuntime command. Only one version of the AIR runtime can be installed at a time; you cannot have both a
release and a development version installed.
See “ADT installRuntime command” on page 169 for more information.
Install the runtime on an iOS device
The necessary AIR runtime code is bundled with each application created for iPhone, iTouch, and iPad devices. You
do not install a separate runtime component.
More Help topics
“AIR for iOS” on page 67
Last updated 5/16/2017
BUILDING ADOBE AIR APPLICATIONS 5
Adobe AIR installation
Removing Adobe AIR
Once you have installed the runtime, you can remove it using the following procedures.
Remove the runtime on a Windows computer
1 In the Windows Start menu, select Settings > Control Panel.
2 Open the Programs, Programs and Features, or Add or Remove Programs control panel (depending on which
version of Windows you are running).
3 Select “Adobe AIR” to remove the runtime.
4 Click the Change/Remove button.
Remove the runtime on a Mac computer
(cid:129) Double-click the “Adobe AIR Uninstaller”, which is located in the /Applications/Utilities folder.
Remove the runtime on a Linux computer
Do one of the following:
(cid:129) Select the “Adobe AIR Uninstaller” command from the Applications menu.
(cid:129) Run the AIR installer binary with the -uninstall option
(cid:129) Remove the AIR packages (adobeair and adobecerts) with your package manager.
Remove the runtime from an Android device
1 Open the Settings app on the device.
2 Tap the Adobe AIR entry under Applications > Manage Applications.
3 Tap the Uninstall button.
You can also use the ADT -uninstallRuntime command. See “ADT uninstallRuntime command” on pag e170 for
more information.
Remove a bundled runtime
To remove a captive bundled runtime, you must remove the application it is installed with. Note that captive runtimes
are only used to run the installing application.
Installing and running the AIR sample applications
To install or update an AIR application, a user must have administrative privileges for the computer.
Some sample applications are available that demonstrate AIR features. You can access and install them using the
following instructions:
1 Download and run the AIR sample applications. The compiled applications as well as the source code are available.
2 To download and run a sample application, click the sample application Install Now button. You are prompted to
install and run the application.
Last updated 5/16/2017