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

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

程序描述文件的根元素为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元素是可选的。