除了所有創(chuàng)建?AIR（Adobe Integrated Runtime ）應(yīng)用程序的需要的資源文件以外，Adobe AIR應(yīng)用程序還需要一個(gè)應(yīng)用程序描述文件，一個(gè)用來定義Adobe AIR應(yīng)用程序基本屬性的XML文件。

如果你使用Flex Builder 3，這個(gè)應(yīng)用程序描述文件文件，在你建立一個(gè)新的AIR項(xiàng)目時(shí)，被自動(dòng)的生成。如果你使用Flex?的 AIR SDKs來開發(fā)Adobe AIR 應(yīng)用程序，你需要自己手動(dòng)建立這個(gè)文件。

Adobe AIR應(yīng)用程序描述文件結(jié)構(gòu)

Adobe AIR程序描述文件application.xml，包含的Adobe AIR程序的全部屬性，如AIR程序的名字，版本，版權(quán)信息，等等之類的。Adobe AIR程序描述文件能使用任何文件名字。當(dāng)建立一個(gè)新的項(xiàng)目時(shí)，Flex Builder 自動(dòng)建立一個(gè)描述文件。當(dāng)你打包輸出Adobe AIR應(yīng)用程序時(shí)，不論是用Flex Builder?還是 ADT，都會(huì)被重命名為application.xml，并且放在AIR包的一個(gè)特定目錄下。

下面是一個(gè)Adobe AIR程序描述文件的例子：

<?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>

在程序描述文件中定義Adobe Air程序?qū)傩?/h3>

在Adobe AIR程序描述文件根部，包含有一個(gè)Adobe AIR程序的下列幾個(gè)屬性：

<application appId="com.adobe.air.HelloWorld" version="1.0"
xmlns="http://ns.adobe.com/air/application/1.0.M4">

appID?一個(gè)Adobe AIR應(yīng)用程序唯一的標(biāo)識(shí)符。這個(gè)屬性值限定在下列字符范圍之內(nèi)：

• 0-9
• a-z
• A-Z
• . (dot)
• - (hyphen)

這個(gè)值必須包含17到255個(gè)字符。

這個(gè)appId?The?字符串典型的使用一個(gè)點(diǎn)分隔符層級(jí)，用一個(gè)反轉(zhuǎn)的DNS域名地址，一個(gè)JAVA包或類名，或者一個(gè)OS X通用的類型標(biāo)識(shí)。這個(gè)類似DNS的形態(tài)不是強(qiáng)制的，不會(huì)在這個(gè)名字和域名之間建立任何聯(lián)系。

version?指定的版本信息（他和Adobe AIR運(yùn)行時(shí)的虛擬機(jī)版本沒有關(guān)系）。這個(gè)版本串是Adobe AIR應(yīng)用程序設(shè)計(jì)者定義的。Adobe AIR虛擬機(jī)不會(huì)通過任何途徑解釋這個(gè)版本串。因此版本”3.0″并不假定是比當(dāng)前的”2.0.”或例如：“1.0″, “.4″, “0.5“,?“4.9″,?“1.3.4a”?版本更高

xmlns?是AIR 的名字空間，你必須用默認(rèn)的XML名字空間定義，這個(gè)名字空間將隨著Adobe AIR的每個(gè)發(fā)行版本而改變。

定義Adobe AIR應(yīng)用程序的名字，標(biāo)題，描述，版權(quán)，和安裝目錄

name?的名字。必須定義在這個(gè)元素里。

<name>TestApp</name>

在windos系統(tǒng)里，它顯示在應(yīng)用程序的標(biāo)題條和windows的開始菜單里。在MAC OS里，當(dāng)Adobe AIR應(yīng)用程序運(yùn)行時(shí)它顯示在菜單條里。

title?(可選項(xiàng))顯示在Adobe AIR應(yīng)用程序安裝描述里。

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

description?(可選項(xiàng)) 顯示在Adobe AIR應(yīng)用程序安裝描述里。

<description>An MP3 player.</description>

copyright?(可選項(xiàng))?Adobe AIR應(yīng)用程序的版權(quán)信息。

<copyright>Copyright ? 2006 [YourCompany, Inc.]</copyright>

installFolder?(可選項(xiàng)) 確定默認(rèn)安裝目錄的子目錄。

<installFolder>Acme</installFolder>

在Windows系統(tǒng)里某人的安裝子目錄是Program Files 目錄。在Mac OS系統(tǒng)里，它是./Applications 目錄。例如：installFolder屬性是設(shè)為“Acme”并且Adobe AIR應(yīng)用程序名字是“ExampleApp”，那么這個(gè)Adobe AIR應(yīng)用程序在wodows系統(tǒng)里將被安裝在C:\Program Files\Acme\Example，而在Mac OS里將被安裝在./Applications/Acme/Example.app

如果你想指定嵌套的子目錄，可以使用”/”字符作為目錄分隔符，類似下面那樣：

<installFolder>Acme/Power Tools</installFolder>

installFolder屬性可以包含任何Unicode (UTF-8) 字符，除了下列的字符以外，這些字符是被任何文件系統(tǒng)所禁止使用的。

Character	Hex Code
various	0×00 - x1F
*	x2A
“	x22
:	x3A
>	x3C
<	x3E
?	x3F
\	x5C
|	x7C

installFolder?的屬性是可選的。如果你沒有指定這個(gè)屬性，這個(gè)Adobe AIR應(yīng)用程序?qū)⒈话惭b在基于name?屬性的默認(rèn)安裝子目錄。

定義Adobe AIR應(yīng)用程序的?rootContent元素

application.xml文件也指示了rootContent文件。這個(gè)文件是第一個(gè)被Adobe AIR應(yīng)用程序載入執(zhí)行的。它可能是一個(gè)SWF文件或一個(gè)HTML文件。

這個(gè)為rootContent?指定的值是一個(gè)相對(duì)于application.xml文件根的URL。例如，在下列rootContent?的屬性里，AIRTunes.swf 文件（在和application.xml 文件相同的目錄下）被定義為Adobe AIR應(yīng)用程序的根文件。

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

rootContent元素設(shè)置被載入執(zhí)行的根內(nèi)容的窗口之內(nèi)的特性。

systemChrome?如果你設(shè)置這個(gè)特性為standard，將顯示系統(tǒng)chrome（這個(gè)詞不知如何翻譯，應(yīng)該是窗口基本的風(fēng)格樣式），如果你設(shè)置為none，系統(tǒng)chrome不會(huì)被顯示。當(dāng)使用Flex WindowedApplication 組件，這個(gè)組件將應(yīng)用自定的chrome。

transparent?如果想應(yīng)用程序窗口支持aplha混合（透明效果）設(shè)置它為 “true”.當(dāng)一個(gè)窗口被創(chuàng)建后，這個(gè)transprent屬性不能再被改變。一個(gè)具有透明屬性的窗口將顯示比較慢，并且需要更多的額外的內(nèi)存。

重要提示: 當(dāng)systemChrome=”none”時(shí)只能設(shè)置transparent=”true”?。

visible?如果你想主窗口第一次建立時(shí)被隱藏，設(shè)置這個(gè)值為“false”。默認(rèn)值是“true”。

你可以在你的Adobe AIR程序代碼中讓主窗口初始化時(shí)隱藏，然后設(shè)置它的位置和大小。然后你可以通過設(shè)置stage.window.visible?（主窗口的）屬性為true，來顯示它。跟多詳細(xì)說明請(qǐng)看Working with windows.

height, width?應(yīng)用程序的窗口的高和寬。如果不設(shè)置這個(gè)特性，窗口的大小將由根的SWF文件決定設(shè)置，或者HTML情況，被操作系統(tǒng)設(shè)置。如果你設(shè)置visible特性為“false”，你能加入代碼去調(diào)整窗口的寬和高的屬性(在設(shè)置visible屬性為true之前) 。

指定Adobe AIR程序的icon圖標(biāo)文件

icon?屬性指定一個(gè)或更多的被Adobe AIR應(yīng)用程序文件使用的icon圖標(biāo)文件。包括一個(gè)圖標(biāo)icon是可選的。如果你沒有指定一個(gè)icon屬性，操作系統(tǒng)將顯示默認(rèn)的圖標(biāo)。

這個(gè)指定的路徑是相對(duì)于Adobe AIR應(yīng)用程序的根目錄。支持PNG, GIF, 和JPEG的文件格式。你能指定下列所有的icon圖標(biāo)大小。

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

如果指定了一個(gè)圖片，它必須是指定的大小。如果所有的大小沒有提供，最接近的將被縮放到適合的大小，供操作系統(tǒng)提供給用戶顯示。

主意：圖標(biāo)文件不是自動(dòng)被加入Adobe AIR程序包里的。當(dāng)Adobe AIR應(yīng)用程序被打包時(shí)，這個(gè)icon圖標(biāo)文件必須被包含在當(dāng)前本地相對(duì)路徑下。

一個(gè)包含更新界面的信號(hào)（翻譯比較怪異Signaling the inclusion of an update interface）

通常的，Adobe AIR安裝和更新應(yīng)用程序使用默認(rèn)的安裝對(duì)話框。然而你也能使用AIR Updater API為更新一個(gè)Adobe AIR應(yīng)用程序，定義你自己的更新機(jī)制。去指定你的應(yīng)用程序自己管理更新處理句柄，你必須包括handleUpdates元素在Adobe AIR應(yīng)用程序描述文件里：

<handleUpdates/>

當(dāng)你的Adobe AIR應(yīng)用程序的安裝版本，在應(yīng)用程序描述文件里，包括handleUpdates元素，并且用戶雙擊啟動(dòng)一個(gè)新的版本（appID屬性必須匹配，即保證是同一個(gè)Adobe AIR應(yīng)用程序）的AIR文件，AIR運(yùn)行時(shí)打開這個(gè)應(yīng)用程序被安裝的版本，而不是默認(rèn)的AIR應(yīng)用程序安裝器。你的程序邏輯上能夠決定如何去處理更新操作。

注意：handleUpdates?機(jī)制僅僅當(dāng)應(yīng)用程序已經(jīng)安裝并且用戶雙擊AIR文件時(shí)才起作用。

（翻譯比較別扭參看原文）When the installed version of your application includes the?handleUpdates?element in the application descriptor file and the user then double-clicks on the AIR file for a new version (the appID attributes must match), the runtime opens the installed version of the application, rather than the default AIR application installer. Your application logic can then determine how to proceed with the update operation.

Note: The?handleUpdates?mechanism only works when the application is already installed and the user double-clicks the AIR file.

更多信息,看?Updating applications programatically.

注冊(cè)文件類型（Registering file types）

文件類型屬性讓你指定一些文件類型給AIR應(yīng)用程序注冊(cè)，示例如下：

The fileTypes property lets you specify any file types to be registered for the AIR application, as in this example:

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

fileTypes元素是可選項(xiàng)。如果采用，你能指定一些數(shù)量的文件類型注冊(cè)。

The?fileTypes?element is optional. If present, you can specify any number of file type registrations.

name?和?extension?屬性是每一個(gè)fileType?定義必須被包括的。注意extension是不包括前綴的。description屬性是可選項(xiàng)。如果指定，操作系統(tǒng)可以用這個(gè)屬性值的內(nèi)容去描述這個(gè)文件類型。contentType也是可選項(xiàng)。

The?name?and?extension?properties are required for each?fileType?definition that you include. Note that the extension is specified without the preceding period. The?description?property is optional. If specified, the operating system may use the value of the?description?property to describe the file type. The?contentType?property is also optional.

當(dāng)一個(gè)文件類型被一個(gè)AIR應(yīng)用程序注冊(cè)，無論何時(shí)一個(gè)用戶打開這個(gè)類型的文件，這個(gè)程序?qū)⒈徽{(diào)用。如果應(yīng)用程序已經(jīng)運(yùn)行了，AIR將發(fā)送一個(gè)調(diào)用事件給這個(gè)運(yùn)行的實(shí)例。否則AIR將首先啟動(dòng)這個(gè)應(yīng)用程序。在這兩個(gè)案例中，文件名和位置能從通過應(yīng)用程序Shell對(duì)象發(fā)送的InvokeEvent對(duì)象中被找到。

When a file type is registered with an AIR application, the application will be invoked whenever a user opens a file of that type. If the application is already running, AIR will dispatch the invoke event to the running instance. Otherwise, AIR will launch the application first. In both cases, the file name and location can be retrieved from the InvokeEvent object dispatched by the application Shell object.

? ? 本文轉(zhuǎn)自 OldHawk ?博客園博客，原文鏈接：http://www.cnblogs.com/taobataoma/archive/2008/03/04/1090046.html，如需轉(zhuǎn)載請(qǐng)自行聯(lián)系原作者

總結(jié)

以上是生活随笔為你收集整理的设置Adobe Air应用程序属性的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。