AIR 應用程式描述器元素

內容

true 或 false (預設值)

範例

<allowBrowserInvocation>true</allowBrowserInvocation>

內容

定義 Android 特定屬性的元素，這些元素將新增至 Android 應用程式資訊清單。

範例

<android> 
    <manifestAdditions> 
        ... 
    </manifestAdditions> 
</android>

特質

minimumPatchLevel — 此應用程式所需的 AIR 執行階段最低修補程式層級。

xmlns — XML 命令空間特質會決定應用程式所需的 AIR 執行階段版本。

這個命名空間會隨著 AIR 的每一個主要發行版本變更 (但是發行次要修補程式時則不會)。命名空間的最後一個區段 (例如「3.0」) 表示應用程式所需的執行階段版本。

主要 AIR 版本的 xmlns值為：

xmlns="http://ns.adobe.com/air/application/1.0" 
xmlns="http://ns.adobe.com/air/application/1.1" 
xmlns="http://ns.adobe.com/air/application/1.5" 
xmlns="http://ns.adobe.com/air/application/1.5.2" 
xmlns="http://ns.adobe.com/air/application/1.5.3" 
xmlns="http://ns.adobe.com/air/application/2.0" 
xmlns="http://ns.adobe.com/air/application/2.5" 
xmlns="http://ns.adobe.com/air/application/2.6" 
xmlns="http://ns.adobe.com/air/application/2.7" 
xmlns="http://ns.adobe.com/air/application/3.0" 
xmlns="http://ns.adobe.com/air/application/3.1" 
xmlns="http://ns.adobe.com/air/application/3.2" 
xmlns="http://ns.adobe.com/air/application/3,3" 
xmlns="http://ns.adobe.com/air/application/3.4" 
xmlns="http://ns.adobe.com/air/application/3.5" 
xmlns="http://ns.adobe.com/air/application/3.6" 
xmlns="http://ns.adobe.com/air/application/3.7"

對於 SWF 類型的應用程式，指定在應用程式描述器中的 AIR 執行階段版本會決定可載入為應用程式初始內容的 SWF 最高版本。指定 AIR 1.0 或 AIR 1.1 的應用程式只能使用 SWF9 (Flash Player 9) 檔當作初始內容，即使使用 AIR 2 執行階段執行，也是如此。指定 AIR 1.5 (或更新版本) 的應用程式可以使用 SWF9 或 SWF10 (Flash Player 10) 檔案當作初始內容。

SWF 版本會決定可使用的 AIR 和 Flash Player API 版本。如果 SWF9 檔用來當做 AIR 1.5 應用程式的初始內容，則該應用程式只能存取 AIR 1.1 和 Flash Player 9 API。另外，在現有 AIR 2.0 或 Flash Player 10.1 中 的 API 行為變更將不會生效 (對 API 所做的與安全性相關的重要變更則不受此原則的限制，而且可追溯套用到執行階段目前或未來的修補程式)。

對於 HTML 類型的應用程式，應用程式描述器中指定的執行階段版本會決定應用程式可用的 AIR 和 Flash Player API 的版本。HTML、CSS 和 JavaScript 的行為永遠會由所安裝 AIR 執行階段中使用的 Webkit 版本來決定，而不會由應用程式描述器決定。

當 AIR 應用程式載入 SWF 內容時，可供內容使用的 AIR 和 Flash Player API 版本會根據內容的載入方法而定。有效版本有時候是由應用程式描述器命名空間決定，有時候是由正在載入之內容的版本決定，有時候則是由已經載入之內容的版本決定。下表顯示如何根據載入方法決定 API 版本：

當載入的 SWF 檔案版本與載入內容的版本不同時，可能會遇到兩個問題：

• 透過舊版 SWF 載入新版 SWF — 載入內容中將無法解析新版 AIR 和 Flash Player 所新增 API 的參照

• 透過新版 SWF 載入舊版 SWF — 新版 AIR 和 Flash Player 中變更的 API 可能會出現載入內容無法預期的行為。

內容

應用程式元素包含定義 AIR 應用程式屬性的子元素。

範例

<?xml version="1.0" encoding="utf-8" ?> 
<application xmlns="http://ns.adobe.com/air/application/3.0"> 
    <id>HelloWorld</id> 
    <version>2.0</version> 
    <filename>Hello World</filename> 
    <name>Example Co. AIR Hello World</name> 
     <description> 
        <text xml:lang="en">This is an example.</text> 
        <text xml:lang="fr">C'est un exemple.</text> 
        <text xml:lang="es">Esto es un ejemplo.</text> 
    </description> 
    <copyright>Copyright (c) 2010 Example Co.</copyright> 
    <initialWindow> 
        <title>Hello World</title> 
        <content> 
            HelloWorld.swf 
        </content> 
        <systemChrome>none</systemChrome> 
        <transparent>true</transparent> 
        <visible>true</visible> 
        <minSize>320 240</minSize> 
    </initialWindow>  
    <installFolder>Example Co/Hello World</installFolder> 
    <programMenuFolder>Example Co</programMenuFolder> 
    <icon> 
        <image16x16>icons/smallIcon.png</image16x16> 
        <image32x32>icons/mediumIcon.png</image32x32> 
        <image48x48>icons/bigIcon.png</image48x48> 
        <image128x128>icons/biggestIcon.png</image128x128>  
    </icon> 
    <customUpdateUI>true</customUpdateUI> 
    <allowBrowserInvocation>false</allowBrowserInvocation> 
    <fileTypes> 
        <fileType> 
            <name>adobe.VideoFile</name> 
            <extension>avf</extension> 
            <description>Adobe Video File</description> 
            <contentType>application/vnd.adobe.video-file</contentType> 
            <icon> 
                <image16x16>icons/avfIcon_16.png</image16x16> 
                <image32x32>icons/avfIcon_32.png</image32x32> 
                <image48x48>icons/avfIcon_48.png</image48x48> 
                <image128x128>icons/avfIcon_128.png</image128x128> 
            </icon> 
        </fileType> 
    </fileTypes> 
</application>

內容

portrait、landscape 或 any

範例

<aspectRatio>landscape</aspectRatio>

內容

true 或 false (預設值)

範例

<autoOrients>true</autoOrients>

內容

下列其中一個值：

• 16 位元

• 32 位元

範例

<android> 
    <colorDepth>16bit</colorDepth> 
    <manifestAdditions>...</manifestAdditions> 
</android>

內容

下列其中一個值：

• true

• False

範例

<android> 
    <containsVideo>true</containsVideo> 
    <manifestAdditions>...</manifestAdditions> 
</android>

內容

相對於應用程式目錄的 URL。由於 content 元素的值會視為 URL，所以根據 RFC 1738 中定義的規則，必須將內容檔案名稱中的字元以 URL 編碼方式加以處理。例如，空格字元就必須編碼為 %20 。

範例

<content>TravelPlanner.swf</content>

內容

MIME 類型與子類型。如需有關 MIME 類型的詳細資訊，請參閱 RFC2045 。

範例

<contentType>text/plain</contentType>

內容

包含應用程式版權資訊的字串。

範例

<copyright>© 2010, Examples, Inc.All rights reserved.</copyright>

內容

true 或 false (預設值)

範例

<customUpdateUI>true</customUpdateUI>

內容

true 或 false (預設值)

範例

<depthAndStencil>true</depthAndStencil>

內容

在 AIR 1.0 應用程式描述器結構中，只允許為該名稱 (而非多個 text 元素) 定義一個簡單文字節點。

在 AIR 1.1 (或更新版本) 中，您可以在 description 元素內指定多個語言。如 RFC4646 (http://www.ietf.org/rfc/rfc4646.txt) 中所定義，每一個 text 元素的 xml:lang 特質都可以指定一個語言代碼。

範例

具有簡單文字節點的說明：

<description>This is a sample AIR application.</description> 

以英文、法文和西班牙文當地語系化的文字元素說明 (適用於 AIR 1.1 及更新的版本)：

<description> 
    <text xml:lang="en">This is an example.</text> 
    <text xml:lang="fr">C'est un exemple.</text> 
    <text xml:lang="es">Esto es un ejemplo.</text> 
</description> 

內容

說明檔案內容的字串。

範例

<description>PNG image</description>

內容

embedFonts 元素可包含任何數目的字體元素。

範例

<embedFonts> 
   <font> 
      <fontPath>ttf/space age.ttf</fontPath>
      <fontName>space age</fontName> 
   </font>
   <font> 
      <fontPath>ttf/xminus.ttf</fontPath>
      <fontName>xminus</fontName> 
   </font>
</embedFonts>

內容

包含子元素，這些子元素會指定索引鍵值配對，做為應用程式的 Entitlements.plist 設定。Entitlements 元素的內容應該包括在 CDATA 區塊中。如需詳細資訊，請參閱 iOS Developer Library 中的 權益索引鍵參考 。

範例

<iphone> 
... 
   <Entitlements> 
      <![CDATA[ 
         <key>aps-environment</key> 
         <string>development</string> 
      ]]> 
   </Entitlements> 
</iphone>

內容

識別副檔名字元的字串 (不包含點 “.”)。

範例

<extension>png</extension>

內容

ActionScript 擴充功能 ID 的識別字串。

範例

<extensionID>com.example.extendedFeature</extensionID>

內容

extensionID 子元素，包含擴充功能描述器檔案中的 ActionScript 擴充功能 ID。

範例

<extensions> 
    <extensionID>extension.first</extensionID> 
    <extensionID>extension.next</extensionID> 
    <extensionID>extension.last</extensionID> 
</extensions>

內容

文字檔的名稱，檔案內含要遠端裝載、以行分隔的 SWF 清單。

特質：

無。

範例

iOS：

<iPhone> 
    <externalSwfs>FileContainingListofSWFs.txt</externalSwfs> 
</iPhone>

內容

filename 屬性可以包含下列字元以外的任何 Unicode (UTF-8) 字元，各種檔案系統都會禁止將下列字元當做檔名使用：

filename 的值不能以半形的點 (.) 做為結尾。

範例

<filename>MyApplication</filename>

內容

說明檔案類型的元素。

範例

<fileType> 
    <name>foo.example</name> 
    <extension>foo</extension> 
    <description>Example file type</description> 
    <contentType>text/plain</contentType> 
    <icon> 
        <image16x16>icons/fooIcon16.png</image16x16> 
        <image48x48>icons/fooIcon48.png</imge48x48> 
    <icon> 
</fileType>

內容

fileTypes 元素可包含任何數目的 fileType 元素。

範例

<fileTypes> 
    <fileType> 
        <name>adobe.VideoFile</name> 
        <extension>avf</extension> 
        <description>Adobe Video File</description> 
        <contentType>application/vnd.adobe.video-file</contentType> 
        <icon> 
            <image16x16>icons/AIRApp_16.png</image16x16>       
            <image32x32>icons/AIRApp_32.png</image32x32>       
            <image48x48>icons/AIRApp_48.png</image48x48>      
            <image128x128>icons/AIRApp_128.png</image128x128> 
        </icon> 
    </fileType> 
</fileTypes>

內容

指定自訂字體名稱及其路徑的元素。

範例

<font> 
   <fontPath>ttf/space age.ttf</fontPath>
   <fontName>space age</fontName> 
</font>

內容

要在 StageText.fontFamily 中指定的自訂字體名稱

範例

<fontName>space age</fontName> 

內容

自訂字體檔案的路徑 (以來源為基準)。

範例

<fontPath>ttf/space age.ttf</fontPath> 

內容

以空格分隔的裝置機型名稱清單。

特質：

無。

範例

iOS：

... 
<renderMode>GPU</renderMode> 
... 
<iPhone> 
... 
   <forceCPURenderModeForDevices>iPad1,1 iPhone1,1 iPhone1,2 iPod1,1 
   </forceCPURenderModeForDevices> 
</iPhone>

內容

true 或 false (預設值)

範例

<fullscreen>true</fullscreen>

內容

最大值為 4095 的正整數。

範例

<height>4095</height>

內容

每個所需圖示大小的 imageNxN 元素。

範例

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

內容

ID 值只能由下列字元組成：

• 0–9

• a–z

• A–Z

• . (點)

• - (連字符號)

這個值必須介於 1 到 212 個字元之間。這是必要元素。

範例

<id>org.example.application</id>

內容

圖示的檔案路徑可以包含下列字元以外的任何 Unicode (UTF-8) 字元，多種檔案系統都禁止在檔案名稱中使用下列字元：

範例

<image32x32>icons/icon32.png</image32x32>

內容

包含子元素，這些子元素會指定索引鍵值配對，做為應用程式的 Info.plist 設定：InfoAdditions 元素的內容應該包括在 CDATA 區塊中。

如需有關索引鍵值配對以及如何以 XML表示它們的詳細資訊，請參閱「Apple iPhone 參考元件庫」中的 資訊屬性清單索引鍵參考 。

範例

<InfoAdditions> 
    <![CDATA[ 
        <key>UIStatusBarStyle</key> 
        <string>UIStatusBarStyleBlackOpaque</string> 
        <key>UIRequiresPersistentWiFi</key> 
        <string>NO</string> 
    ]]> 
</InfoAdditions>

內容

定義應用程式外觀與行為的子元素。

範例

<initialWindow> 
    <title>Hello World</title> 
    <content> 
        HelloWorld.swf 
    </content> 
    <depthAndStencil>true</depthAndStencil> 
    <systemChrome>none</systemChrome> 
    <transparent>true</transparent> 
    <visible>true</visible> 
    <maxSize>1024 800</maxSize> 
    <minSize>320 240</minSize> 
    <maximizable>false</maximizable> 
    <minimizable>false</minimizable> 
    <resizable>true</resizable> 
    <x>20</x> 
    <y>20</y> 
    <height>600</height> 
    <width>800</width> 
    <aspectRatio>landscape</aspectRatio> 
    <autoOrients>true</autoOrients> 
    <fullScreen>false</fullScreen> 
    <renderMode>direct</renderMode> 
</initialWindow>

內容

除了各種檔案系統都禁止當做資料夾名稱使用的字元以外， installFolder 屬性可以包含任何 Unicode (UTF-8) 字元 (如需例外字元清單，請參閱 filename 屬性)。

如果您希望指定巢狀子目錄，可以使用正斜線 (/) 字元做為目錄分隔符號字元。

範例

<installFolder>utilities/toolA</installFolder>

內容

技術上而言，manifest 元素不是 AIR 應用程式描述器結構的一部分。它是 Android 資訊清單 XML 文件的根元素。任何在 manifest 元素中放置的內容必須遵循 AndroidManifest.xml 結構。當您使用 AIR 工具產生 APK 檔案時，會將 manifest 元素中的資訊複製到應用程式產生的 AndroidManifest.xml 對應部分。

如果您指定的 Android 資訊清單值只在比 AIR 直接支援版本更新的 SDK 版本中提供，則在封裝應用程式時，您必須將 ‑platformsdk 旗標設定為 ADT。請將旗標設定為檔案系統路徑，該路徑指向支援所要新增之值的 Android SDK 版本。

manifest 元素本身必須包括在 AIR 應用程式描述器的 CDATA 區塊中。

範例

<![CDATA[      
    <manifest android:sharedUserID="1001"> 
        <uses-permission android:name="android.permission.CAMERA"/> 
        <uses-feature android:required="false" android:name="android.hardware.camera"/> 
        <application     android:allowClearUserData="true" 
                    android:enabled="true" 
                    android:persistent="true"/> 
    </manifest> 
]]>

內容

在 manifestAdditions 元素中的資訊會新增至 AndroidManifest XML 文件中。

AIR 會在產生的 Android 資訊清單文件中設定數個資訊清單項目，以確保應用程式與執行階段功能可正常運作。您無法覆寫下列設定：

您無法設定 manifest 元素的下列特質：

• package

• android:versionCode

• android:versionName

您無法設定主要 activity 元素的下列特質：

• android:label

• android:icon

您無法設定 application 元素的下列特質：

• android:theme

• android:name

• android:label

• android:windowSoftInputMode

• android:configChanges

• android:screenOrientation

• android:launchMode

範例

<manifestAdditions> 
    <![CDATA[      
        <manifest android:installLocation="preferExternal"> 
            <uses-permission android:name="android.permission.INTERNET"/> 
            <application     android:allowClearUserData="true" 
                        android:enabled="true" 
                        android:persistent="true"/> 
        </manifest> 
    ]]> 
</manifestAdditions>

內容

true (預設值) 或 false

範例

<maximizable>false</maximizable>

內容

代表寬度與高度上限的兩個整數，以空格分隔。

範例

<maxSize>1024 360</maxSize>

內容

true (預設值) 或 false

範例

<minimizable>false</minimizable>

內容

代表寬度與高度下限的兩個整數，以空格分隔。請注意，作業系統實行的大小下限優先於應用程式描述器中設定的值。

範例

<minSize>120 60</minSize>

內容

如果您指定單一文字節點 (而非多個 <text> 元素)，則不論系統語言為何，AIR 應用程式安裝程式都會使用這個名稱。

在 AIR 1.0 應用程式描述器結構中，只允許為該名稱 (而非多個 text 元素) 定義一個簡單文字節點。在 AIR 1.1 (或更新版本) 中，您可以在 name 元素內指定多個語言。

如 RFC4646 (http://www.ietf.org/rfc/rfc4646.txt) 中所定義，每一個 text 元素的 xml:lang 特質都可以指定一個語言代碼。

AIR 應用程式安裝程式會使用最符合使用者作業系統之使用者介面語言的名稱。例如，假設正在執行一項安裝作業，其中應用程式描述器檔案的 name 元素包含代表 en (英文) 地區的值。如果作業系統將 en (英文) 識別為使用者介面語言，那麼 AIR 應用程式安裝程式就會使用這個 en 名稱。此外，如果系統使用者介面語言為 en-US (美式英文)，安裝程式也會使用這個 en 名稱。但是，如果使用者介面語言為 en-US，而且應用程式描述器檔案定義了 en-US 和 en-GB 這兩個名稱，那麼 AIR 應用程式安裝程式就會使用 en-US 這個值。如果應用程式定義的名稱都不符合系統使用者介面語言，AIR 應用程式安裝程式就會使用在應用程式描述器檔案中定義的第一個 name 值。

name 元素只會定義在 AIR 應用程式安裝程式中使用的應用程式標題。AIR 應用程式的安裝程式支援下列語言：繁體中文、簡體中文、捷克文、荷蘭文、英文、法文、德文、義大利文、日文、韓文、波蘭文、巴西葡萄牙文、俄文、西班牙文、瑞典文和土耳其文。AIR 應用程式安裝程式會根據系統使用者介面語言選取所顯示的語言 (針對應用程式標題和說明以外的文字而言)。這個語言選取項目與應用程式描述器檔案中的設定無關。

針對已安裝且正在執行中的應用程式， name 元素「不會」定義可供其使用的地區。如需有關開發多國語言應用程式的詳細資訊，請參閱 當地語系化 AIR 應用程式 。

範例

下列範例會使用簡單文字節點定義名稱：

<name>Test Application</name> 

下列範例 (適用於 AIR 1.1 及更新的版本) 使用 <text> 元素節點指定三種語言 (英文、法文和西班牙文) 的名稱：

<name> 
    <text xml:lang="en">Hello AIR</text> 
    <text xml:lang="fr">Bonjour AIR</text> 
    <text xml:lang="es">Hola AIR</text> 
</name> 

內容

表示檔案類型名稱的字串。

範例

<name>adobe.VideoFile</name>

內容

除了各種檔案系統都禁止當做資料夾名稱使用的字元以外，用於 programMenuFolder 值的字串可以包含任何 Unicode (UTF-8) 字元 (如需例外字元清單，請參閱 filename 元素)。請「勿」使用正斜線 (/) 字元做為這個值的最後一個字元。

範例

<programMenuFolder>Example Company/Sample Application</programMenuFolder>

內容

發行者 ID 字串。

範例

<publisherID>B146A943FBD637B68C334022D304CEA226D129B4.1</publisherID>

內容

下列其中一個值：

• auto (預設值) — 目前會退回 CPU 模式。

• cpu — 未使用硬體加速。

• direct — CPU 出現顯示視覺調整，位圖複製使用 GPU。在 AIR 3+ 提供。

  備註： 若要在行動平台上使用 AIR 來利用 Flash 內容的 GPU 加速，Adobe 建議您使用 renderMode="direct" (即 Stage3D)，而不要使用 renderMode="gpu"。Adobe 正式支援並建議使用下列 Stage3D 架構：Starling (2D) 和 Away3D (3D)。如需有關 Stage3D 和 Starling/Away3D 的詳細資訊，請參閱 http://gaming.adobe.com/getstarted/ 。

• gpu — 使用硬體加速 (若有的話)。

  重要事項： 請勿為 Flex 應用程式使用 GPU 顯示模式。

範例

<renderMode>direct</renderMode>

內容

standard (預設值) 或 high。

特質：

excludeDevices — 以空格分隔之 iOS 機型名稱或機型名稱前置詞的清單。這允許開發人員可讓一些裝置使用高解析度，其他則使用標準解析度。只有 iOS 才可以使用這個特質 ( requestedDisplayResolution 元素位於 iPhone 元素的巢狀結構內)。 excludeDevices 特質可以在 AIR 3.6 及更新版本中取得。

若這個特質中指定了任何裝置的機型名稱，則 requestedDisplayResolution 值與指定的值相反。換句話說，如果 requestedDisplayResolution 值為「高」，則排除的裝置會使用標準解析度。如果 requestedDisplayResolution 值為「標準」，則排除的裝置會使用高解析度。

值為 iOS 裝置機型名稱或機型名稱前置詞。例如，值 iPad3,1 特別表示 Wi-Fi 第 3 代 iPad (而不是 GSM 或 CDMA 第 3 代 iPad)。或者，值 iPad3 表示任何第 3 代 iPad。iOS 機型名稱的非官方清單可以在 iPhone wiki 機型頁 取得。

範例

桌上型：

<initialWindow> 
    <requestedDisplayResolution>high</requestedDisplayResolution> 
</initialWindow>

iOS：

<iPhone> 
    <requestedDisplayResolution excludeDevices="iPad3 iPad4">high</requestedDisplayResolution> 
</iPhone>

內容

true (預設值) 或 false

範例

<resizable>false</resizable>

內容

none 或 pan。預設值為 pan。

範例

<softKeyboardBehavior>none</softKeyboardBehavior>

內容

以空格分隔的支援語言清單。有效的語言值為 AIR 執行階段支援之語言的 ISO 639‑1 值： en 、 de 、 es 、 fr 、 it 、 ja 、 ko 、 pt 、 ru 、 cs 、 nl 、 pl 、 sv 、 tr 、 zh 、 da 、 nb 、 iw 。

封裝程式會因為 <supportedLanguages> 元素的空白值而產生錯誤。

範例

<supportedLanguages>en ja fr es</supportedLanguages>

內容

您可以在 supportedProfiles 元素中包含下列任一值：

supportedProfiles 是選擇性屬性。若您未在應用程式描述器檔案中包含這個元素時，可以針對任何描述檔編譯和部署應用程式。

若要指定多重描述檔，請以空格字元分隔每一個描述檔。例如，下列設定指定應用程式只能用於 desktop 和 extended 描述檔中。

<supportedProfiles>desktop extendedDesktop</supportedProfiles>

範例

<supportedProfiles>desktop mobileDevice</supportedProfiles>

內容

下列其中一個值：

• none — 不提供系統顏色。應用程式 (或是 Flex 等應用程式架構) 必須負責顯示視窗顏色。

• standard (預設值) — 由作業系統提供系統顏色。

範例

<systemChrome>standard</systemChrome>

內容

指定地區設定的 xml:lang 特質以及當地語系化文字的字串。

範例

<text xml:lang="fr">Bonjour AIR</text>

內容

包含視窗標題的字串。

範例

<title>Example Window Title</title>

內容

true 或 false (預設值)

範例

<transparent>true</transparent>

內容

包含應用程式版本的字串。

範例

<version>0.1 Alpha</version>

內容

包含公開顯示的版本文字字串。

範例

<versionLabel>0.9 Beta</versionlabel>

內容

版本號碼可包含多達三個以句號分隔的整數序列。每個整數必須是 0 到 999 之間的數字 (含)。

範例

<versionNumber>1.0.657</versionNumber> 
 
<versionNumber>10</versionNumber> 
 
<versionNumber>0.01</versionNumber>

內容

true 或 false (預設值)

範例

<visible>true</visible>

內容

最大值為 4095 的正整數。

範例

<width>1024</width>

內容

整數值。

範例

<x>120</x>

內容

整數值。

範例

<y>250</y>