面向 Adobe AIR 开发人员的发行说明

发行日期：2009 年 12 月 8 日

入门

欢迎阅读 AIR 1.5.3 的发行说明。本文档包含系统要求、安装说明、已知问题以及有关使用 AIR 1.5.3 运行时的其它信息。有关详细信息，请参阅 Adobe AIR 1.5.3 发行说明。请使用 Adobe AIR 反馈表来报告功能请求、错误以及对发行说明的改进。

面向 Adobe AIR 开发人员的发行说明

入门
系统要求
AIR 1.5.3 中的更改
证书重续
版本信息
修正的错误
已知问题
安装 Adobe AIR
安装 AIR 应用程序
Adobe AIR SDK

系统要求

有关 Adobe AIR 的当前系统要求，请访问：http://www.adobe.com/cn/products/air/systemreqs/。

AIR 1.5.3 中的更改

证书重续

在 AIR 1.5.3 之前的版本中，AIR 安全应用程序更新使用重续的证书进行签名，方法是通过比较新旧证书中计算得出的发布者 ID。由于发布者 ID 定义上的缺陷，许多客户发现此机制与其重续的证书不兼容。现在不推荐使用此方法，而推荐使用迁移签名。

如果您已经拥有 AIR 应用程序，则应按照以下步骤执行此转换：

确定应用程序当前的发布者 ID。在已安装的应用程序中，可在 META-INF/AIR/publisherid 文件中找到。
在描述符中添加 <publisherID></publisherID> 元素，然后将发布者 ID 复制到该元素中。
将应用程序的命名空间更新为 1.5.3。

如果要创建新的 AIR 应用程序，则不应使用 <publisherID> 设置。

如果使用与以前版本相同 (即，非重续）的证书来发布应用程序的更新，则无需执行其它操作。如果您使用重续的证书更新应用程序，必须使用旧证书来申请另一个迁移签名，方法如下所示：

首先，使用新证书为应用程序签名
使用旧证书申请迁移签名

在到期日期之后的六个月内均可使用旧证书申请迁移签名。有关迁移签名的详细信息，请参阅 Adobe AIR 文档中的更改证书。

最后，请注意：

此行为的更改仅对于使用 1.5.3 （或更高版本的命名空间）的应用程序有效。AIR 1.5.3 会继续将以前的发布者 ID 计算方法用于指定较早版本命名空间的应用程序。

更新命名空间版本将使新的 API 和行为在您的应用程序中可见。例如，如果应用程序之前使用的是 1.1 命名空间，则更新到 1.5.3 后将使所有新的 AIR 1.5 API 和行为在应用程序中可见。这些更改几乎不会影响应用程序的兼容性，但我们建议您验证更新了命名空间的应用程序的行为。

版本信息

WebKit 版本

AIR 1.5.3 包含 WebKit 版本 34190。

最新的 Flash Player 插件

AIR 1.5.3 包含 Flash Player 插件的更新版本 (10.0.42.34)，在显示 HTML 中嵌入的 SWF 内容时将使用该插件。有关详细信息，请参阅 http://www.adobe.com/support/documentation/cn/flashplayer/releasenotes.html。

修正的错误

错误编号	错误标题
2411661	当中间证书过期后，将无法使用重续证书为应用程序签名（通过删除发布者 ID 进行修复）
2464587	AIR 应用程序安装程序在使用 Phenom 处理器的 Linux 系统上会崩溃
2421099	当启用 Mac Snow Leopard 选项以将窗口最小化，隐藏在停靠栏中应用程序图标后面时，最大化的应用程序不能取消该窗口的最小化
2471920	HTMLLoader：在 HTMLLoader 中使用 Shift 键时，无法正常传输键盘码
2474555	在 Linux 中，即使将默认浏览器设置为其它应用程序，AIR 应用程序仍会在 Firefox 中打开链接

已知问题

如果 Flex Builder 3 中包含旧的资源文件，Mac 上的 AIR 应用程序可能会崩溃
目前存在一个问题，如果您不删除仍然包含在 Flex Builder 中的三个旧资源文件，可能会导致 Mac 上的 AIR 应用程序崩溃。若要删除这些文件，请执行以下操作：
1. 在 Mac Finder 中，找到“Adobe Flex Builder 3”应用程序文件夹并浏览到“/sdks/3.2.0/runtimes/air/mac/Adobe AIR.framework/Versions/1.0/Resources”。
2. 删除下列文件：MainMenu.nib、AuthDialog.nib 和 FlashPromptDialog.nib。
Windows 上的 Sidecar 安装
从可移动驱动器或 CD/DVD 上执行 AIR 运行时的捆绑安装时，如果已安装了以前版本的 AIR 运行时并且捆绑的 AIR 运行时安装程序没有位于可移动介质的根位置，则会出现问题。为避免此问题，请确保 Sidecar 安装程序文件已部署在可移动介质的根位置。
HTML 透明叠加
当前的 WebKit 版本不能正常显示可能与 Google 地图关联的透明叠加（GPolyline 不透明度失效）。作为一种解决方法，请将 HTMLoader 对象的 userAgent 属性更改为除“AppleWebKit”之外的其它值。这样一来，Google 地图上的客户端检测代码才会切换为呈现叠加的最终的后备操作，也就是服务器呈现。
加密的本地存储
有关 Linux 上的加密本地存储问题的疑难解答，请阅读 http://kb2.adobe.com/cps/492/cpsid_49267.html*。

安装 Adobe AIR

请参阅 AIR 1.5.1 发行说明或 http://go.adobe.com/kb/ts_kb403150_zh-cn*。

注意：尽管官方不支持 64 位 Linux，但是通过在该版本上安装 32 位依赖项，可以使它正常工作。请参阅此处：http://kb2.adobe.com/cps/408/kb408084.html*

安装 AIR 应用程序

请阅读 AIR 1.5.1 发行说明： http://www.adobe.com/support/documentation/cn/air/1_5_1/releasenotes_developers.html#install_air。

对于加载 badge.swf 文件的 HTML 嵌入标记，请不要设置 wmode 属性；请保留其默认设置（“window”）。其它 wmode 设置会导致不能在某些系统上进行安装。请阅读此处的相关说明：http://help.adobe.com/zh_CN/AIR/1.5/devappsflash/WS5b3ccc516d4fbf351e63e3d118666ade46-7e15.html#WS5b3ccc516d4fbf351e63e3d118666ade46-7c88

Adobe AIR SDK

有关如何叠加 AIR SDK 以使其能配合 Flex SDK 使用的信息，请阅读以下技术说明：How to Overlay the AIR SDK for Use With the Flex SDK*（如何通过叠加使 AIR SDK 能配合 Flex SDK 使用）。