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

 

定义应用程序描述文件的属性
程序描述文件的根元素为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元素是可选的。