AIR的配置文件详解

<?xml version="1.0" encoding="utf-8" standalone="no"?>
<application xmlns="http://ns.adobe.com/air/application/1.5.3">
<!-- Adobe AIR Application Descriptor File Template.
	Adobe AIR应用程序描述符文件模板。

	Specifies parameters for identifying, installing, and launching AIR applications.
	指定参数识别、安装和启动AIR应用程序。

	xmlns - The Adobe AIR namespace: http://ns.adobe.com/air/application/1.5.3
	xmlns——Adobe AIR名称空间:http://ns.adobe.com/air/application/1.5.3
			The last segment of the namespace specifies the version
			最后一段的名称空间指定版本 
			of the AIR runtime required for this application to run.
			AIR的运行时需要的应用程序运行。
			
	minimumPatchLevel - The minimum patch level of the AIR runtime required to run the application. Optional.
	minimumPatchLevel——运行程序需要的最低 AIR runtime 版本号. 可选.
-->


	<!-- The application identifier string, unique to this application. Required. -->
	<id>AIRTest</id><!-- 软件ID，当安装时系统将会检测同一ID软件版本，版本高的即做更新操作 -->

	<!-- Used as the filename for the application. Required. 
		 程序的文件名称，必须-->
	<filename>AIRTest</filename><!-- 安装界面中 Application: -->

	<!-- The name that is displayed in the AIR application installer. 
	     May have multiple values for each language. See samples or xsd schema file. Optional.
	     显示在AIR安装过程中的程序名称，必须 -->

	<name>AIRTest</name><!-- 桌面快捷方程式及窗口和系统控制面板添加程序中名称 -->  

	<!-- An application version designator (such as "v1", "2.5", or "Alpha 1"). Required.
		程序版本 (比如 "v1", "2.5", 或 "Alpha 1"). 必须 -->
	<version>v1</version><!-- 软件版本 --> 

	<!-- Description, displayed in the AIR application installer.
	     May have multiple values for each language. See samples or xsd schema file. Optional.
	     描述，显示于AIR的安装过程中，可选 -->
	<!-- <description></description> --><!-- 安装第二个界面中的 description -->

	<!-- Copyright information. Optional
		 版权信息，可选 -->
	<!-- <copyright></copyright> -->

	<!-- Publisher ID. Used if you're updating an application created prior to 1.5.3
	 	 发行商 ID:
从 AIR 1.5.3 开始，将弃用发行商 ID。新应用程序（最初使用 AIR 1.5.3 或更高版本发布）不需要也不应指定发行商 ID。 

当更新使用 AIR 的早期版本发布的应用程序时，您必须在应用程序描述符文件中指定原始发行商 ID。否则，会将应用程序的安装版本和更新版本视为不同的应用程序。如果您使用其他 ID 或省略 publisherID 标签，用户必须在安装新版本之前卸载早期版本。 

要确定原始发行商 ID，请在安装原始应用程序的 META-INF/AIR 子目录中查找 publisherid 文件。此文件中的字符串就是发行商 ID。要手动指定发行商 ID，应用程序描述符必须在应用程序描述符文件的命名空间声明中指定 AIR 1.5.3 运行时（或更高版本）。

对于在 AIR 1.5.3 之前发布的应用程序（在应用程序描述符命名空间中指定 AIR 的早期版本时，则是使用 AIR 1.5.3 SDK 发布的应用程序），将根据签名证书计算发行商 ID。将此 ID 与应用程序 ID 一起使用来确定应用程序的标识。发行商 ID（如果存在）用于以下用途：

■验证 AIR 文件是一个更新而不是要安装的新应用程序

■作为加密本地存储加密密钥的一部分

■作为应用程序存储目录路径的一部分

■作为本地连接的连接字符串的一部分

■作为用于使用 AIR 浏览器内 API 来调用应用程序的标识字符串的一部分

■作为 OSID（在创建自定义安装/卸载程序时使用）的一部分

在 AIR 1.5.3 之前，如果您使用新的或续签的证书对包含迁移签名的应用程序更新进行签名，则可以更改应用程序的发行商 ID。当发行商 ID 改变时，所有依赖该 ID 的 AIR 功能的行为也会改变。例如，将无法访问现有加密本地存储中的数据，所有创建到应用程序的本地连接的 Flash 或 AIR 实例必须使用连接字符串中的新 ID。 

在 AIR 1.5.3 或更高版本中，发行商 ID 不是基于签名证书的，而且只能在应用程序描述符中包含 publisherID 标签的情况下指定。如果为更新 AIR 包指定的发行商 ID 与其当前的发行商 ID 不匹配，则无法更新应用程序。

	 	 -->
	<!-- <publisherID></publisherID> -->

	<!-- Settings for the application's initial window. Required.
		 程序运行窗口设置，必须 -->
	<initialWindow>
		<!-- The main SWF or HTML file of the application. Required.
			应用程序的主文件，SWF或HTML格式的，必须 -->
		<!-- Note: In Flash Builder, the SWF reference is set automatically.
			 注意: 在Flash Builder中, 这个参数是自动设置的 -->
		<content>[此值将由 Flash Builder 在输出 app.xml 中覆盖]</content>
		
		<!-- The title of the main window. Optional.
			 主窗口的标题，可选 -->
		<!-- <title></title> --><!-- 窗体标题，当此处为注释状态时取 name标签中内容 -->

		<!-- The type of system chrome to use (either "standard" or "none"). Optional. Default standard. 
			 使用系统主题的类型 (使用 "standard" 或 "none"). 可选. 默认是 standard-->
		<!-- <systemChrome></systemChrome> --><!-- standard为标准窗体,none 为圆滑窗体 -->

		<!-- Whether the window is transparent. Only applicable when systemChrome is none. Optional. Default false. 
			 指示窗口是否是透明的. 只有当过systemChrome设置为false的时候才起作用. 可选. 默认是false-->
		<!-- <transparent></transparent> --><!-- 背景是否透明 -->

		<!-- Whether the window is initially visible. Optional. Default false.
			 指示窗口是否自动显示. 可选. 默认是false. -->
		<!-- <visible></visible> --><!-- 窗体初始化的时候是否可见 -->

		<!-- Whether the user can minimize the window. Optional. Default true.
			 指示用户是否可以最小化窗口. 可选. 默认是true -->
		<!-- <minimizable></minimizable> --><!-- 是否允许最小化 -->

		<!-- Whether the user can maximize the window. Optional. Default true.
			 指示用户是否可以更改窗口大小. 可选. 默认是true -->
		<!-- <maximizable></maximizable> --><!-- 是否允许最大化 -->

		<!-- Whether the user can resize the window. Optional. Default true. 
			  指示用户是否可以更改窗口大小. 可选. 默认是true-->
		<!-- <resizable></resizable> --><!-- 是否允许缩放窗体 -->

		<!-- The window's initial width. Optional. 
			 窗口初始宽度，可选-->
		<!-- <width></width> --><!-- 窗体宽 -->

		<!-- The window's initial height. Optional.
			 窗口初始高度，可选 -->
		<!-- <height></height> --><!-- 窗体高 -->

		<!-- The window's initial x position. Optional.
			 窗口初始X轴坐标，可选  -->
		<!-- <x></x> --><!-- 窗体X位置坐标 -->

		<!-- The window's initial y position. Optional.
			 窗口初始Y轴坐标，可选 -->
		<!-- <y></y> --><!-- 窗体Y位置坐标 -->

		<!-- The window's minimum size, specified as a width/height pair, such as "400 200". Optional.
			 窗口的最小尺寸, 请按照宽度/高度的格式编写, 比如"400 200". 可选  -->
		<!-- <minSize></minSize> --><!-- 窗体最小化值 -->

		<!-- The window's initial maximum size, specified as a width/height pair, such as "1600 1200". Optional.
			 窗口的最大尺寸, 请按照宽度/高度的格式编写, 比如"1600 1200". 可选 -->
		<!-- <maxSize></maxSize> --><!-- 窗体最大化值 -->
	</initialWindow>

	<!-- The subpath of the standard default installation location to use. Optional.
		 标准的程序文件安装路径设置. 可选 -->
	<!-- <installFolder></installFolder> --><!-- 默认安装路径 C:\Program Files\AIRInstrallField\AIR -->

	<!-- The subpath of the Programs menu to use. (Ignored on operating systems without a Programs menu.) Optional. 
		 操作系统程序/菜单中的路径设置. 可选-->
	<!-- <programMenuFolder></programMenuFolder> --><!-- 开始/程序 快捷方程式所在文件夹 -->

	<!-- The icon the system uses for the application. For at least one resolution,
		 specify the path to a PNG file included in the AIR package. Optional.
		 程序的图标设置. 可以自定义路径到AIR安装包中的PNG格式图片的位置. 可选 -->
		 <!-- 图标的大小必须和标签中标写的尺寸一致 -->	
	<!-- <icon>
		<image16x16></image16x16><!-- 系统菜单中及系统控制面板添加程序中的图标 -->
		<image32x32></image32x32><!-- 桌面图标，窗口图标 -->
		<image48x48></image48x48><!-- 安装目录EXE文件图标 -->
		<image128x128></image128x128>
	</icon> -->

	<!-- Whether the application handles the update when a user double-clicks an update version
	of the AIR file (true), or the default AIR application installer handles the update (false).
	Optional. Default false.
	用户手动更新 (true), 或由默认的 AIR 应用处理更新 (false).可选，默认是false  -->
	<!-- <customUpdateUI></customUpdateUI> --><!-- 是否为同一版本的时候双击直接更新 -->
	
	<!-- Whether the application can be launched when the user clicks a link in a web browser.
	Optional. Default false.
		 是否允许用户通过点击浏览器中的链接来启动程序，可选，默认是false  -->
	<!-- <allowBrowserInvocation></allowBrowserInvocation> -->

	<!-- Listing of file types for which the application can register. Optional. 
		  程序可注册的文件类型. 可选-->
	<!-- <fileTypes> -->

		<!-- Defines one file type. Optional.
			 定义文件类型. 可选. -->
		<!-- <fileType> -->

			<!-- The name that the system displays for the registered file type. Required.
				 在系统中显示的文件类型名称. 必须. -->
			<!-- <name></name> -->

			<!-- The extension to register. Required.
				 要注册的扩展名. 必须 -->
			<!-- <extension></extension> -->
			
			<!-- The description of the file type. Optional.
				文件类型的描述. 可选 -->
			<!-- <description></description> -->
			
			<!-- The MIME content type.
				 MIME 类型. 可选 -->
			<!-- <contentType></contentType> -->
			
			<!-- The icon to display for the file type. Optional.
				 这个文件类型的图标显示. 可选. -->
			<!-- <icon>
				<image16x16></image16x16>
				<image32x32></image32x32>
				<image48x48></image48x48>
				<image128x128></image128x128>
			</icon> -->
			
		<!-- </fileType> -->
	<!-- </fileTypes> -->

</application>