第九章. 设置应用程序属性
应用程序描述文件的结构
应用程序描述文件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字段，其包含几个属性：
<application appId="com.adobe.air.HelloWorld" version="1.0"
xmlns="http://ns.adobe.com/air/application/1.0.M4">
appID ：
程序唯一标识符，该属性可由下列字符组成：
该值必须包含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程序的版权信息
<copyright>Copyright ? 2006 [YourCompany, Inc.]</copyright>
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 元素添加到描述文件中：
<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>
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文件。
该包包含下列类：
ServiceMonitor
SocketMonitor
URLMonitor
