Apollo application descriptor介紹

application descriptor檔案(application.xml)，倘若我們從字面上來看，其實就代表著用來描述此應用程式的相關資訊，像是：發行者的名稱、版本編號、版權等等…，我們可以指定任何的檔案名稱給它，只不過他被包裝成AIR檔之後，仍然會被強制地更改名稱為application.xml，接下來我們就直接來看helloworld的application descriptor，如：

application.xml

<?xml version="1.0" encoding="UTF-8"?>
<application xmlns="http://ns.adobe.com/apollo/application/1.0.M3" appId="MyHelloWorld" version="1.0">
    <properties>
        <name>MyHelloWorld</name>
        <publisher>Shen</publisher>
        <description>My first Apollo application.</description>
        <copyright>© 2007</copyright>
    </properties>
    <rootContent systemChrome="standard" transparent="false" visible="false">helloworld.swf</rootContent>
    <icon>
        <image16x16>icons/ApolloApp_16.png</image16x16>
        <image32x32>icons/ApolloApp_32.png</image32x32>
        <image48x48>icons/ApolloApp_48.png</image48x48>
        <image128x128>icons/ApolloApp_128.png</image128x128> 
    </icon>
</application>

application identifier (appID)屬性

範例：appId="MyHelloWorld"

application identifier 是一個「唯一的辨識器」，尤其是當您已安裝一個Apollo Application之後，若是想重新安裝或更新，便會根據此application identifier來搜尋先前已安裝過的Apollo Application。

此屬性的字串必須被限制下列幾種字元

[0-9][a-z][A-Z][.][-]

且根據Apollo Document說明，此字串必須介於17至255個字元，你可以使用反相的DNS名稱，類似Java Package或OSX Universal Type Identifier，不過這並不是強制規定。

範例：tw.idv.ring.apollo.HelloWorld

version屬性

你可以用此屬性來指定此應用程式的版本編號，格式以"主版本.次版本"的形式呈現，例如："1.0" or "3.2" and so on.

應用程式的相關資訊 - 包含發行者、用途描述、版權

name:此屬性用來定義應用程式的名稱，此名稱也會顯示在視窗的標題上。

publisher, description and copyright 三個屬性值都將在安裝Apollo Application時，呈現給使用者知道。

定義 rootContent 元素(element) - 指定程式的進入點

此元素用來指定你的Apollo Application啟動程式為一個SWF或HTML，這裡我們指定的是helloworld.swf，也就是和application.xml相對路徑下的helloworld.swf。

此元素並包含四類屬性，它們分別為 systemChrome、transparent、visible和height(width)

systemChrome屬性

此屬性可以包含兩種屬性值，它們分別為：

standard - 呈現應用程式的外觀(邊框、標題、縮小、放大和離開)，並且不包含透明值

none - 不呈現應用程式的外觀

transparent屬性

如果你想要應用程式視窗支援alpha blending，您必須設為true。

(開啟此模式將需要更多的記憶體，並可能會造成視窗繪製變慢，而且此模式僅支援以SWF-based的應用程式，systemChrome屬性值必須為none)

visible屬性(預設值為true)

如果你想隱藏視窗的話，你可以設此屬性為false，類似常駐程式的味道!

(在絕大多數以HTML-based應用程式的情況之下，此屬性值不應該被設為false)

height和width屬性(預設值取決於SWF檔或由作業系統決定)

此屬性可用來指定應用程式的視窗大小。

定義 icon (預設值由作業系統決定)

此icon所支援的影像檔包含GIF、PNG和JPEG格式，它會顯示在視窗的左上角，或是桌面上的應用程式圖示等。