設定Adobe Air應用程式屬性

除了所有建立 AIR（Adobe Integrated Runtime ）應用程式的需要的資源檔案以外，Adobe AIR應用程式還需要一個應用程式描述檔案，一個用來定義Adobe AIR應用程式基本屬性的XML檔案。

如果你使用Flex Builder 3，這個應用程式描述檔案檔案，在你建立一個新的AIR項目時，被自動的生成。如果你使用Flex 的 AIR SDKs來開發Adobe AIR 應用程式，你需要自己手動建立這個檔案。

Adobe AIR程式描述檔案application.xml，包含的Adobe AIR程式的全部屬性，如AIR程式的名字，版本，版權資訊，等等之類的。Adobe AIR程式描述檔案能使用任何檔案名字。當建立一個新的項目時，Flex Builder 自動建立一個描述檔案。當你打包輸出Adobe AIR應用程式時，不論是用Flex Builder 還是 ADT，都會被重命名為application.xml，并且放在AIR包的一個特定目錄下。

下面是一個Adobe AIR程式描述檔案的例子：

在Adobe AIR程式描述檔案根部，包含有一個Adobe AIR程式的下列幾個屬性：

appID 一個Adobe AIR應用程式唯一的辨別符。這個屬性值限定在下列字元範圍之内：

0-9

a-z

A-Z

. (dot)

- (hyphen)

這個值必須包含17到255個字元。

這個appId The 字元串典型的使用一個點分隔符層級，用一個反轉的DNS域名位址，一個JAVA包或類名，或者一個OS X通用的類型辨別。這個類似DNS的形态不是強制的，不會在這個名字和域名之間建立任何聯系。

version 指定的版本資訊（他和Adobe AIR運作時的虛拟機版本沒有關系）。這個版本串是Adobe AIR應用程式設計者定義的。Adobe AIR虛拟機不會通過任何途徑解釋這個版本串。是以版本”3.0″并不假定是比目前的”2.0.”或例如：“1.0″, “.4″, “0.5“, “4.9″, “1.3.4a” 版本更高

xmlns 是AIR 的名字空間，你必須用預設的XML名字空間定義，這個名字空間将随着Adobe AIR的每個發行版本而改變。

name 的名字。必須定義在這個元素裡。

在windos系統裡，它顯示在應用程式的标題條和windows的開始菜單裡。在MAC OS裡，當Adobe AIR應用程式運作時它顯示在菜單條裡。

title (可選項)顯示在Adobe AIR應用程式安裝描述裡。

description (可選項) 顯示在Adobe AIR應用程式安裝描述裡。

copyright (可選項) Adobe AIR應用程式的版權資訊。

installFolder (可選項) 确定預設安裝目錄的子目錄。

在Windows系統裡某人的安裝子目錄是Program Files 目錄。在Mac OS系統裡，它是./Applications 目錄。例如：installFolder屬性是設為“Acme”并且Adobe AIR應用程式名字是“ExampleApp”，那麼這個Adobe AIR應用程式在wodows系統裡将被安裝在C:\Program Files\Acme\Example，而在Mac OS裡将被安裝在./Applications/Acme/Example.app

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

installFolder屬性可以包含任何Unicode (UTF-8) 字元，除了下列的字元以外，這些字元是被任何檔案系統所禁止使用的。

Character

Hex Code

various

0×00 - x1F

*

x2A

“

x22

:

x3A

>

x3C

<

x3E

?

x3F

\

x5C

|

x7C

installFolder 的屬性是可選的。如果你沒有指定這個屬性，這個Adobe AIR應用程式将被安裝在基于name 屬性的預設安裝子目錄。

application.xml檔案也訓示了rootContent檔案。這個檔案是第一個被Adobe AIR應用程式載入執行的。它可能是一個SWF檔案或一個HTML檔案。

這個為rootContent 指定的值是一個相對于application.xml檔案根的URL。例如，在下列rootContent 的屬性裡，AIRTunes.swf 檔案（在和application.xml 檔案相同的目錄下）被定義為Adobe AIR應用程式的根檔案。

rootContent元素設定被載入執行的根内容的視窗之内的特性。

systemChrome 如果你設定這個特性為standard，将顯示系統chrome（這個詞不知如何翻譯，應該是視窗基本的風格樣式），如果你設定為none，系統chrome不會被顯示。當使用Flex WindowedApplication 元件，這個元件将應用自定的chrome。

transparent 如果想應用程式視窗支援aplha混合（透明效果）設定它為 “true”.當一個視窗被建立後，這個transprent屬性不能再被改變。一個具有透明屬性的視窗将顯示比較慢，并且需要更多的額外的記憶體。

重要提示: 當systemChrome=”none”時隻能設定transparent=”true” 。

visible 如果你想主視窗第一次建立時被隐藏，設定這個值為“false”。預設值是“true”。

height, width 應用程式的視窗的高和寬。如果不設定這個特性，視窗的大小将由根的SWF檔案決定設定，或者HTML情況，被作業系統設定。如果你設定visible特性為“false”，你能加入代碼去調整視窗的寬和高的屬性(在設定visible屬性為true之前) 。

icon 屬性指定一個或更多的被Adobe AIR應用程式檔案使用的icon圖示檔案。包括一個圖示icon是可選的。如果你沒有指定一個icon屬性，作業系統将顯示預設的圖示。

這個指定的路徑是相對于Adobe AIR應用程式的根目錄。支援PNG, GIF, 和JPEG的檔案格式。你能指定下列所有的icon圖示大小。

如果指定了一個圖檔，它必須是指定的大小。如果所有的大小沒有提供，最接近的将被縮放到适合的大小，供作業系統提供給使用者顯示。

主意：圖示檔案不是自動被加入Adobe AIR程式包裡的。當Adobe AIR應用程式被打包時，這個icon圖示檔案必須被包含在目前本地相對路徑下。

通常的，Adobe AIR安裝和更新應用程式使用預設的安裝對話框。然而你也能使用AIR Updater API為更新一個Adobe AIR應用程式，定義你自己的更新機制。去指定你的應用程式自己管理更新處理句柄，你必須包括handleUpdates元素在Adobe AIR應用程式描述檔案裡：

當你的Adobe AIR應用程式的安裝版本，在應用程式描述檔案裡，包括handleUpdates元素，并且使用者輕按兩下啟動一個新的版本（appID屬性必須比對，即保證是同一個Adobe AIR應用程式）的AIR檔案，AIR運作時打開這個應用程式被安裝的版本，而不是預設的AIR應用程式安裝器。你的程式邏輯上能夠決定如何去處理更新操作。

注意：handleUpdates 機制僅僅當應用程式已經安裝并且使用者輕按兩下AIR檔案時才起作用。

（翻譯比較别扭參看原文）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.

檔案類型屬性讓你指定一些檔案類型給AIR應用程式注冊，示例如下：

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

fileTypes元素是可選項。如果采用，你能指定一些數量的檔案類型注冊。

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

name 和 extension 屬性是每一個fileType 定義必須被包括的。注意extension是不包括字首的。description屬性是可選項。如果指定，作業系統可以用這個屬性值的内容去描述這個檔案類型。contentType也是可選項。

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.

當一個檔案類型被一個AIR應用程式注冊，無論何時一個使用者打開這個類型的檔案，這個程式将被調用。如果應用程式已經運作了，AIR将發送一個調用事件給這個運作的執行個體。否則AIR将首先啟動這個應用程式。在這兩個案例中，檔案名和位置能從通過應用程式Shell對象發送的InvokeEvent對象中被找到。

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.

    本文轉自 OldHawk  部落格園部落格，原文連結：http://www.cnblogs.com/taobataoma/archive/2008/03/04/1090046.html，如需轉載請自行聯系原作者