AIR中文帮助第九章设置应用程序属性_应用程序属性的定义-CSDN博客

应用程序描述文件的结构

应用程序描述文件application.xml，包含了整个程序的属性，如名称，版本，版权等等。任何文件名都可作为程序描述文件，Flex Builder当创建工程时会自动创建描述文件。当打包程序时无论使用Flex Builder还是ADT，都会把描述文件重命名为application.xml。

这里是一个描述文件的例子：

<?xml version="1.0" encoding="utf-8" ?> <application appId="com.adobe.air.examples.HelloWorld" version="2.0" xmlns="http://ns.adobe.com/air/application/1.0.M4"> <name>AIR Hello World</name> <description> This is the Hello World sample file from the Adobe AIR documentation. </description> <title>HelloWorld -- AIR Example</title> <copyright>Copyright © 2006</copyright> <rootContent systemChrome="none" transparent="true" visible="true" width="640" height="480"> HelloWorld-debug.swf </rootContent> <installFolder>Adobe/Examples</installFolder> <icon> <image16x16>icons/smallIcon.png</image16x16> <image32x32>icons/mediumIcon.jpg</image32x32> <image48x48>icons/bigIcon.gif</image48x48> <image128x128>icons/biggestIcon.png</image128x128> </icon> <handleUpdates/> <fileTypes> <fileType> <name>adobe.VideoFile</name> <extension>avf</extension> <description>Adobe Video File</description> <contentType>application/vnd.adobe.video-file</contentType> </fileType> </fileTypes> </application>

定义应用程序描述文件的属性

程序描述文件的根元素为application字段，其包含几个属性：

appID ： 程序唯一标识符，该属性可由下列字符组成：

0-9

a-z

A-Z

. (点)

- (横杆)

该值必须包含17到255个字符。

version ：设定程序的版本信息

xmlns ：AIR名称空间，每个版本的AIR其名称空间都会不同。

定义程序名称，标题，描述，版权和安装目录

name ：应用程序名称，必须定义

<name>TestApp</name>

在Windows中，这个值会显示在程序的标题栏中

title (可选) ：在AIR程序安装器中显示

<title>TestApp from Adobe Systems Inc.</title>

description (可选) AIR程序安装时显示

<description>An MP3 player.</description>

copyright (可选) AIR程序的版权信息

installFolder (可选) 默认安装目录的子目录

<installFolder>Acme</installFolder>

在Windows中，默认安装子目录为Program Files目录，在Mac OS中，为/Applications 目录。例如安装目录属性为"Acme"和程序名称为"ExampleApp"，则程序将被安装在C:/Program Files/Acme/Example 。

使用反斜杠(/) 作为目录分隔符：

<installFolder>Acme/Power Tools</installFolder>

installFolder属性可以包含任意Unicode (UTF-8) 字符，除了下面的：

代码
Character                                  Hex Code

various                                      0x00 - x1F

*                                                x2A

"                                                x22

:                                                x3A

>                                              x3C

<                                              x3E

?                                              x3F

/                                              x5C

|                                                x7C

定义rootContent元素

Application.xml也指明了rootContent文件，因为这个文件是第一个被程序载入的。无论是SWF还是HTML文件。

rootContent元素值是一个URL，相对于application.xml文件所在路径，例如下面的rootContent 元素中AIRTunes.swf 文件和application.xml文件在同一个目录：

代码 <rootContent systemChrome="none" transparent="true" visible="true" height="400" width="600"> AIRTunes.swf </rootContent>

rootContent元素的属性值主要设定将被创建的窗口的属性。

systemChrome ：如果设置为standard，窗口继承操作系统窗口样式，程序没有透明，如果设置为false，则窗口不继承操作系统窗口样式。当使用Flex WindowedApplication组件时，该组件将应用自己的窗口样式。

transparent ：设置为true，则窗口支持Alpha混合，窗口被创建后transprent 属性将不可更改，透明的窗口需要更多内存且渲染速度慢。

重要提示：当systemChrome="none"时你只能设置transparent="true"。

visible ：设置为false，使窗口创建后被隐藏。

你可以需要在主窗口创建时先隐藏，等设置好位置和大小后，再通过stage.window.visible 属性设置为true.再显示主窗口。

height, width ：主窗口的高度和宽度。

指定图标文件

Icon属性指定一个或多个可使用的图标文件，该属性是可选的，即使没有指定，操作系统会显示默认图标。

图标路径是相对与程序的根目录，PNG, GIF, 和JPEG 格式都支持

<icon> <image16x16>icons/smallIcon.png</image16x16> <image32x32>icons/mediumIcon.jpg</image32x32> <image48x48>icons/bigIcon.gif</image48x48> <image128x128>icons/biggestIcon.png</image128x128> </icon>

注意：图标不会自动被添加到AIR包中。

Signaling the inclusion of an update interface

一般情况，AIR 的安装和升级都是使用默认的安装对话框，但是，你可以定义自己的方法使用AIR Updater API来更新程序，要想这样，必须把handleUpdates 元素添加到描述文件中：

注册文件类型

fileTypes属性指定那些类型将被注册：

<fileTypes> <fileType> <name>adobe.VideoFile</name> <extension>avf</extension> <description>Adobe Video File</description> <contentType>application/vnd.adobe.video-file</contentType> </fileType> </fileTypes>

Adobe AIR新增功能

这一节给AIR新增的功能做一个概览。

新的运行时类
运行时类的新功能
新的监控伺服类

新的运行时类（runtime classes）

下面都是Adobe AIR新增的运行时类，这些功能不能用于浏览器中运行的SWF：

Clipboard flash.desktop ClipboardFormats flash.desktop CompressionAlgorithm flash.utils ClipboardTransferMode flash.desktop DockIcon flash.display DragActions flash.desktop DragManager flash.desktop DragOptions flash.desktop DRMAuthenticateEvent flash.events DRMStatusEvent flash.events EncryptedLocalStore flash.filesystem File flash.filesystem FileListEvent flash.events FileMode flash.filesystem FileStream flash.filesystem HTMLControl flash.html HTMLHistoryItem flash.html HTMLHost flash.html HTMLPDFCapability flash.html HTMLUncaughtJavaScriptExceptionEvent flash.html HTMLWindowCreateOptions flash.html Icon flash.desktop InteractiveIcon flash.display InvokeEvent flash.events JavaScriptFunction flash.html JavaScriptObject flash.html NativeDragEvent flash.events NativeMenu flash.display NativeMenuItem flash.display NativeWindow flash.display NativeWindowBoundsEvent flash.events NativeWindowDisplayState flash.display NativeWindowDisplayStateEvent flash.events NativeWindowErrorEvent flash.events NativeWindowIcon flash.display NativeWindowInitOptions flash.display NativeWindowResize flash.display NativeWindowSystemChrome flash.display NativeWindowType flash.display NotificationType flash.display OutputProgressEvent flash.events Screen flash.display Shell flash.system SQLCollationType flash.data SQLColumnNameStyle flash.data SQLColumnSchema flash.data SQLConnection flash.data SQLError flash.errors SQLErrorCode flash.errors SQLErrorEvent flash.events SQLErrorOperation flash.errors SQLEvent flash.events SQLIndexSchema flash.data SQLResult flash.data SQLSchema flash.data SQLSchemaResult flash.data SQLStatement flash.data SQLTableSchema flash.data SQLTransactionLockType flash.data SQLTriggerSchema flash.data SQLUpdateEvent flash.events SQLViewSchema flash.data SystemTrayIcon flash.display Updater flash.system URLRequestDefaults flash.net XMLSignatureValidator flash.utils TransferableTransferMode flash.desktop URLRequestDefaults flash.net Updater flash.system

大多数类只能在AIR程序安全沙箱中可用，不过下面的这些类也可以用在其他沙箱之上：

Door
URLRequest.

运行时类新增功能

下面的类能用在浏览器上，但是AIR下提供了额外的属性和方法：

HTTPStatusEvent HTTP_RESPONSE_STATUS responseURL responseHeaders URLRequest followRedirects manageCookies shouldAuthenticate shouldCacheResponse userAgent userCache setLoginCredentials() URLStream httpResponseStatus event Stage nativeWindow Security APPLICATION

大多数这些属性和方法都在AIR程序安全沙漏中使用，不过URLRequest 类也可以用在其他安全沙箱中。

ByteArray.compress() 和ByteArray.uncompress()方法包含一个新的算法参数，允许你选择压缩或zlib 压缩。

新的Flex组件

下面的Flex组件在AIR程序开发时可用：

FileEvent FileSystemComboBox FileSystemDataGrid FileSystemEnumerationMode FileSystemHistoryButton FileSystemList FileSystemSizeDisplayMode FileSystemTree HTML WindowedApplication

监控伺服类

Air.net包包含一些网络监测类，该包也只能在Adobe AIR中使用，需要引入ServiceMonitor.swc文件。

该包包含下列类：