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 元素中指定多种语言。每个文本元素的 xml:lang 属性用于指定语言代码，有关具体定义，请参阅 RFC4646 (http://www.ietf.org/rfc/rfc4646.txt)。

示例

使用简单文本节点的说明：

<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 开发人员库中的 权限密钥参考 。

示例

<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 的相应部分。

如果您指定仅在比 AIR 直接支持的版本更新的 SDK 版本中可用的 Android 清单值，则打包应用程序时必须将 ‑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 元素中指定多种语言。

每个文本元素的 xml:lang 属性用于指定语言代码，有关具体定义，请参阅 RFC4646 (http://www.ietf.org/rfc/rfc4646.txt)。

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 值为 high ，则未指定的设备使用标准分辨率。如果 requestedDisplayResolution 值为 standard ，则未指定的设备使用高分辨率。

这些值是 iOS 设备型号名称或型号名称前缀。例如，值 iPad3,1 特指 Wi-Fi 第三代 iPad（而非 GSM 或 CDMA 第三代 iPad），而值 iPad3 则指任何第三代 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 属性是可选的。当应用程序描述符文件中不包括此元素时，应用程序可以针对任何配置文件进行编译和部署。

要指定多个配置文件，请使用空格字符将配置文件彼此隔开。例如，以下设置指定此应用程序仅适用于桌面配置文件和扩展配置文件：

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