定义应用程序描述文件的属性
程序描述文件的根元素为application字段,其包含几个属性:
<application appId="com.adobe.air.HelloWorld" version="1.0"
xmlns="http://ns.adobe.com/air/application/1.0.M4">
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程序的版权信息
<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元素是可选的。