Adobe Air 1.5 User guide

Brand: Adobe

Model: Air 1.5

Type: User guide

ADOBE

AIR

™

1.5

Administrator’s Guide

Legal notices

Adobe® AIR™ 1.5 Administrator’s Guide

If this guide is distributed with software that includes an end user agreement, this guide, as well as the software described in it, is furnished under license and

may be used or copied only in accordance with the terms of such license. Except as permitted by any such license, no part of this guide may be reproduced, stored

in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, recording, or otherwise, without the prior written permission of Adobe

Systems Incorporated. Please note that the content in this guide is protected under copyright law even if it is not distributed with software that includes an end

user license agreement.

The content of this guide is furnished for informational use only, is subject to change without notice, and should not be construed as a commitment by Adobe

Systems Incorporated. Adobe Systems Incorporated assumes no responsibility or liability for any errors or inaccuracies that may appear in the informational

content contained in this guide.

Please remember that existing artwork or images that you may want to include in your project may be protected under copyright law. The unauthorized

incorporation of such material into your new work could be a violation of the rights of the copyright owner. Please be sure to obtain any permission required

from the copyright owner.

Any references to company names in sample templates are for demonstration purposes only and are not intended to refer to any actual organization.

Adobe, the Adobe logo, ActionScript, and Flash are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States and/or other

countries.

Mac is a trademark of Apple Inc., registered in the United States and other countries. Windows is either a registered trademark or a trademark of Microsoft

Corporation in the United States and/or other countries. All other trademarks are the property of their respective owners.

This work is licensed under the Creative Commons Attribution Non-Commercial 3.0 License. To view a copy of this license, visit

http://creativecommons.org/licenses/by-nc/3.0/us/

This product includes software developed by the Apache Software Foundation (http://www.apache.org/).

MPEG Layer-3 audio compression technology licensed by Fraunhofer IIS and Thomson Multimedia (http://www.mp3licensing.com).

Portions of this product contain code licensed from Nellymoser (www.nellymoser.com).

http://www.on2.com.

This product includes software developed by the OpenSymphony Group (http://www.opensymphony.com/

This product contains either BSAFE and/or TIPEM software by RSA Security, Inc.

Sorenson Spark™ video compression and decompression technology licensed from Sorenson Media, Inc.

This product includes software developed by the IronSmith Project (http://www.ironsmith.org/).

Adobe Systems Incorporated, 345 Park Avenue, San Jose, CA 95110-2704, USA.

Notice to U.S. Government End Users. The Software and Documentation are “Commercial Items,” as that term is defined at 48 C.F.R. §2.101, consisting of

“Commercial Computer Software” and “Commercial Computer Software Documentation,” as such terms are used in 48 C.F.R. §12.212 or 48 C.F.R. §227.7202,

as applicable. Consistent with 48 C.F.R. §12.212 or 48 C.F.R. §§227.7202-1 through 227.7202-4, as applicable, the Commercial Computer Software and

Commercial Computer Software Documentation are being licensed to U.S. Government end users (a) only as Commercial Items and (b) with only those rights

as are granted to all other end users pursuant to the terms and conditions herein. Unpublished-rights reserved under the copyright laws of the United States.

Adobe Systems Incorporated, 345 Park Avenue, San Jose, CA 95110-2704, USA. For U.S. Government End Users, Adobe agrees to comply with all applicable

equal opportunity laws including, if appropriate, the provisions of Executive Order 11246, as amended, Section 402 of the Vietnam Era Veterans Readjustment

Assistance Act of 1974 (38 USC 4212), and Section 503 of the Rehabilitation Act of 1973, as amended, and the regulations at 41 CFR Parts 60-1 through 60-60,

60-250, and 60-741. The affirmative action clause and regulations contained in the preceding sentence shall be incorporated by reference.

iii

Contents

Adobe AIR 1.5 Administrator’s Guide

The AIR environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Adobe AIR installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Adobe AIR configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

Additional resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Adobe AIR 1.5 Administrator’s Guide

Adobe® AIR™ is a cross-operating system runtime. With AIR installed on a computer, users can install and run AIR

applications.

This document is intended for IT administrators that want to install and configure Adobe AIR on network computers.

AIR applications support native desktop application features, including clipboard and drag-and-drop support, local

file I/O, and system notification. Operating system restrictions that apply to native applications, such as user-specific

privileges, equally apply to AIR applications. For more information on security, see the Adobe AIR Security white

paper (

http://www.adobe.com/go/learn_air_security_wp_en).

The AIR environment

Adobe AIR must be installed for a user to install and run AIR applications.

Each AIR application runs in a separate process.

AIR applications are written using tools and languages used in web development, including HTML, Ajax, Flex, and

Flash. Adobe AIR enables developers to use these to deploy rich Internet applications that run on the desktop.

AIR runtime files and locations

Adobe AIR is installed to the following locations:

• On Microsoft® Windows® —In the Program Files\Common Files\Adobe AIR directory.

• On Mac® OS® —In the /Library/Frameworks/Adobe AIR.framework directory. (Also installed are the Adobe AIR

Application Installer.app and Adobe AIR Uninstaller.app files, both added to the /Applications/Utilties/ directory.)

• On Linux—In the /opt directory. AIR is installed as either rpm or dpkg packages, with package names: adobeairv.n

and adobecerts. Installation requires a running X server. AIR registers the mime type:

application/vnd.adobe.air-application-installer-package+zip.

Adobe AIR is a runtime in which AIR applications run. It also includes the AIR application installer, used to install

AIR applications.

The Adobe AIR directory can contain multiple versions of Adobe AIR, as required by installed AIR applications.

For information on installing and removing Adobe AIR, see “Adobe AIR installation” on page 2.

Data formats used

AIR applications are deployed as AIR files (files with the .air filename extension). An AIR file is an installer file for a

specific AIR application.

When the user launches an AIR file (for example, by double-clicking the AIR file), the runtime opens the AIR

application installer, which provides a graphical user interface for installing the application. The application installer

displays the identity of the application’s developer (based on the developer’s certificate), if known.

ADOBE AIR 1.5 ADMINISTRATOR’S GUIDE

Adobe AIR 1.5 Administrator’s Guide

The installed AIR application is added to a subdirectory of the standard application directory (for example, a

subdirectory of C:\Program Files on Windows and /Applications on Mac OS). The installed application directory

includes the following:

• A native executable file, which opens the application in Adobe AIR.

• HTML and SWF files used by the application. (Each AIR application is built using at least one HTML or SWF file).

HTML and SWF files developed for Adobe AIR may contain APIs specific to AIR, which do not work in web

browsers.

• Other resources, such as images, style sheets, and other media, used by the application.

AIR applications can access the local file system, and they can write files (of any type) to directories for which the user

has write privilege.

Each AIR application is signed, and an installed application cannot run if any files in the installed application directory

do not match the application’s signature.

Network protocols used

Adobe AIR applications can use the following network protocols:

• HTTP

• HTTPS

• RTMP (Real Time Messaging Protocol)—a proprietary protocol used with Flash Media Server to stream audio and

video over the web. The default connection port is 1935.

• RTMPT—RTMP tunneling via HTTP. The default connection port is 80.

• RTMPS—RTMP tunneling via HTTPS. The default connection port is 443. (For more information about using the

RTMP protocols, see “HTTP Tunneling Protocols” at

www.macromedia.com/cfusion/knowledgebase/index.cfm?id=tn_16631.)

• TCP/IP—Transmission Control Protocol/Internet Protocol

• FTP—File Transfer Protocol

• SMB—Server Message Block. SMB is a message format used by DOS and Windows to share files, directories, and

devices. AIR applications can access files from remote SMB shares.

• SSL—Secure Sockets Layer

Adobe AIR installation

Users with administrative rights for a computer can download and install Adobe AIR, which is available at

http://get.adobe.com/air.

Adobe AIR 1.5 is supported on:

• Microsoft Windows

• Mac OS X

• Linux

The user needs to have administrative privileges to install the runtime.

Complete system requirements are listed at http://www.adobe.com/products/air/systemreqs.

ADOBE AIR 1.5 ADMINISTRATOR’S GUIDE

Adobe AIR 1.5 Administrator’s Guide

Removing AIR

Once you have installed the runtime, you can remove it using the following procedures.

On a Windows computer:

1 In the Windows Start menu, select Settings > Control Panel.

2 Select the Add or Remove Programs control panel.

3 Select “Adobe AIR” to remove the runtime.

4 Click the Change/Remove button.

On a Mac computer:

• Double-click the Adobe AIR Uninstaller, which is located in the /Applications/Utilities folder.

The user needs to have administrative privileges to remove the runtime.

On Linux, do one of the following:

• Select the “Adobe AIR Uninstaller” command from the Applications menu.

• Run the AIR installer binary with the -uninstall option.

• Remove the AIR packages (adobeairv.n and adobecerts) with your package manager.

Updating AIR

If an AIR application requires an updated version of Adobe AIR (the runtime), the new runtime version is installed

when the AIR application is installed. To update the runtime, a user must have administrative privileges for the

computer.

Adobe AIR redistribution

Adobe provides the runtime for distributing Adobe AIR on individual systems, on an intranet, or in an enterprise

environment. For more information, see the following:

• http://www.adobe.com/products/air/runtime_distribution1.html

• http://www.adobe.com/products/air/runtime_distribution_faq.html

Installing, updating, and removing AIR applications

AIR applications are deployed as AIR files. See “Data formats used” on page 1.

Users can install updates in two ways:

• Download the AIR file for the application (or copy it in some other way) and run it (for example, by double-clicking

it). Adobe AIR must already be installed.

• In a web page (in a browser), click a seamless install link for the application. Adobe AIR lets developers install

applications via a link (or other user interface element) in a SWF file embedded in a web page. If Adobe AIR is not

already installed, it is installed, with the user’s approval as the application is installed.

In either case, if a different version of the application is already installed, the AIR application installer asks the user if

they want to update to the new version. If an updated version of Adobe AIR is required, the updated version is

automatically installed.

By default, each AIR application is installed in a unique subdirectory of the system-wide programs directory (such as

c:\Program Files\MyAIRApp on Windows and /Applications/MyAIRApp on Mac OS.)

ADOBE AIR 1.5 ADMINISTRATOR’S GUIDE

Adobe AIR 1.5 Administrator’s Guide

On Mac OS, to install or update an AIR application, the user needs to have adequate system privileges to install to the

application directory (and administrative privileges if the application needs to update the runtime). On Windows, a

user needs to have administrative privileges.

Once an AIR application is installed, it can update itself (if the developer has added code to do so).

IT administrators can install Adobe AIR and AIR applications silently using standard desktop deployment tools. (See

the next section,

“Enterprise deployment” on page 4.)

IT administrators can prevent AIR application installation and Adobe AIR updates. (See “Adobe AIR configuration”

on page 4.)

Adobe AIR currently does not support GPO or MSI for Adobe AIR or application installation.

Enterprise deployment

IT administrators can install Adobe AIR and AIR applications silently using standard desktop deployment tools. IT

administrators can deploy the following:

• Silently install Adobe AIR using tools such as Microsoft SMS, IBM Tivoli, or any deployment tool that allows silent

installations that use a bootstrapper

• Silently install the AIR application using the same tools used to deploy the runtime

IT admins are able to control the following as part of deployment:

• Suppress the display of the Adobe AIR end-user license agreement

Only IT administrators can suppress the Adobe AIR end-user license agreement display and only after accepting

the terms and conditions on the organization's behalf.

• Specify the application installation location

• Specify whether the application's program menu or shortcut appears on end-users desktop

Organizations need to obtain redistribution agreement from Adobe. For more information, see:

• http://www.adobe.com/products/air/runtime_distribution1.html

• http://www.adobe.com/products/air/runtime_distribution_faq.html

IT administrators in conjunction with the AIR configuration parameter can further tune the runtime.

Adobe AIR configuration

Administrators can apply the following configuration settings for Adobe AIR running on Windows:

• Preventing installation of AIR applications

• Preventing installation of untrusted AIR applications

• Disabling automatic updates of Adobe AIR updates

These settings are intended for use only within a closed environment, such as an enterprise where an IT administrator

controls the end-users systems. These settings cannot be used as part of a native installer for distribution in an open

environment.

On both Windows and Mac OS, there are administrative settings for SWF content loaded into Adobe AIR from

external sources (outside the application).

ADOBE AIR 1.5 ADMINISTRATOR’S GUIDE

Adobe AIR 1.5 Administrator’s Guide

Preventing installation of AIR applications

On Windows, add a DWORD value named AppInstallDisabled to the

HKey_Local_Machine\Software\Policies\Adobe\AIR registry key, and set the value to 1.

On Linux, modify the AppInstallDisabled setting in the globalRuntime.conf configuration file in /etc/opt/Adobe\

AIR/. For example, set AppInstallDisabled=1 to prevent installation of AIR applications.

If no setting is present or if the value is set to 0, installation of AIR applications is allowed. However, users still need

system privileges to install to the application’s destination directory. Also, if system policy prohibits installation via

Windows Installer (MSI), that policy is also respected by AIR.

Even if installation of AIR applications is allowed, the following restrictions are observed:

• On Mac OS and Linux, to install or update an application, the user needs to have adequate system privileges to

install to the application directory (and administrative privileges if the application needs to update Adobe AIR).

• On Windows, a user needs to have administrative privileges.

Preventing installation of untrusted AIR applications

On Windows, add a DWORD value named UntrustedAppInstallDisabled to the

HKey_Local_Machine\Software\Policies\Adobe\AIR registry key, and set the value to 1.

On Linux, modify the UntrustedAppInstallDisabled setting in the globalRuntime.conf configuration file in

/etc/opt/Adobe\ AIR/. For example, set UntrustedAppInstallDisabled=1 to prevent installation of untrusted AIR

applications.

If no setting is present or if the value is set to 0, installation of untrusted AIR applications is allowed. However, users

still need system privileges to install to the application’s destination directory.

An AIR application is trusted when it has been signed with a certificate that is trusted, or which chains to a certificate

that is trusted on the installation computer. For more information, see “Code signing” in the Adobe AIR Security white

paper (

http://www.adobe.com/go/learn_air_security_wp_en).

Preventing automatic updates to Adobe AIR

On Windows, add a DWORD value named UpdateDisabled to the

HKey_Local_Machine\Software\Policies\Adobe\AIR registry key, and set the value to 1.

On Linux, modify the UpdateDisabled setting in the globalRuntime.conf configuration file in /etc/opt/Adobe\ AIR/.

For example, set UpdateDisabled=1 to prevent automatic updates of Adobe AIR.

If no setting is present or if the value is set to 0, automatic updates of the runtime are allowed (when required by an

AIR application) or when an update becomes available via the background update mechanism. However, users still

need system privileges to install to the application’s destination directory.

Even if automatic updates are not prevented through this setting, the user needs to have administrative privileges for

automatic updates of the runtime to proceed.

Settings for SWF content loaded externally

AIR applications can load SWF content and HTML content loaded from outside the application (for example, from a

web URL or from a directory). Content loaded from outside the application observes the same security rules as content

loaded in a web browser. For example, such content cannot call AIR APIs that provide access to the local file system.

ADOBE AIR 1.5 ADMINISTRATOR’S GUIDE

Adobe AIR 1.5 Administrator’s Guide

Flash Player configuration files apply to SWF content loaded from outside the applications. For information on these

settings, see the Adobe Flash Player Administration Guide

(

http://www.adobe.com/devnet/flashplayer/articles/flash_player_admin_guide.html).

Group Policy Objects (GPO)

Adobe AIR currently does not support Group Policy Objects (GPOs). To be notified when this option becomes

available send email to [email protected].

Additional resources

For more information on Adobe AIR, see the AIR Developer Connection: http://www.adobe.com/devnet/air.

Adobe Air 1.5 User guide

Adobe Air 1.5 User guide

Related papers

Other documents