Adobe AIR User Manual
构建
ADOBE®
AIR®
应用程序
法律声明
法律声明
有关法律声明，请参阅 http://help.adobe.com/zh_CN/legalnotices/index.html。
上次更新 2011/10/13
目录
第 1 章 : 关于 Adobe AIR
第 2 章 : Adobe AIR 安装
安装
Adobe AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
删除 Adobe AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
安装和运行 AIR 范例应用程序 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Adobe AIR
第 3 章 : 使用 AIR API
特定于 AIR 的 ActionScript 3.0 类 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
具有特定于 AIR 功能的 Flash Player 类 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
特定于 AIR 的 Flex 组件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
第 4 章 : 适用于 AIR 开发的 Adobe Flash Platform 工具
安装
安装 Flex SDK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
设置外部 SDK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
更新 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
AIR SDK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
iii
第 5 章 : 创建第一个 AIR 应用程序
在
Flash Builder 中创建第一个桌面 Flex AIR 应用程序 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
使用 Flash Professional 创建第一个桌面 AIR 应用程序 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
在 Flash Professional 中创建您的第一个 AIR for Android 应用程序 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
创建第一个用于 iOS 的 AIR 应用程序 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
使用 Dreamweaver 创建第一个基于 HTML 的 AIR 应用程序 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
使用 AIR SDK 创建第一个基于 HTML 的 AIR 应用程序 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
使用 Flex SDK 创建第一个桌面 AIR 应用程序 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
使用 Flex SDK 创建您的第一个 AIR for Android 应用程序 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
第 6 章 : 开发针对桌面的 AIR 应用程序
开发桌面
AIR 应用程序的工作流程 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
设置桌面应用程序属性 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
调试桌面 AIR 应用程序 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
对桌面 AIR 安装文件进行打包 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
对桌面本机安装程序进行打包 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
为桌面计算机打包捕获运行时捆绑 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
针对桌面计算机分发 AIR 包 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
第 7 章 : 开发针对移动设备的 AIR 应用程序
设置开发环境
移动应用程序设计注意事项 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
创建移动设备 AIR 应用程序的工作流程 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
上次更新 2011/10/13
构建 ADOBE AIR 应用程序
目录
设置移动应用程序属性 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
打包移动 AIR 应用程序 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
调试移动 AIR 应用程序 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
在移动设备上安装 AIR 和 AIR 应用程序 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
更新移动 AIR 应用程序 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
第 8 章 : 开发针对电视设备的 AIR 应用程序
设备功能
用于电视的 AIR 应用程序设计注意事项 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
开发用于电视的 AIR 应用程序的工作流程 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
针对 TV 应用程序属性设置 AIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
对用于电视的 AIR 应用程序进行打包 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
调试用于电视的 AIR 应用程序 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
第 9 章 : 使用 Adobe AIR 的本机扩展
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
AIR 本机扩展 (ANE) 文件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
本机扩展与 NativeProcess ActionScript 类 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
本机扩展与 ActionScript 类库 （SWC 文件） . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
支持的设备 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
支持的设备配置文件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
使用本机扩展的任务列表 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
在应用程序描述符文件中声明扩展 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
在应用程序库路径中包含 ANE 文件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
打包使用本机扩展的应用程序 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
iv
第 10 章 : ActionScript 编译器
关于
Flex SDK 中的 AIR 命令行工具 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
编译器安装 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
为 AIR 编译 MXML 和 ActionScript 源文件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
编译 AIR 组件或代码库 (Flex) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
第 11 章 : AIR Debug Launcher (ADL)
用法 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
ADL
ADL
示例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
ADL
退出和错误代码 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
第 12 章 : AIR Developer Tool (ADT)
命令 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
ADT
ADT
选项组合 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
ADT
错误消息 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
ADT
环境变量 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
上次更新 2011/10/13
构建 ADOBE AIR 应用程序
目录
第 13 章 : 对 AIR 应用程序进行签名
对
AIR 文件进行数字签名 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
使用 ADT 创建未签名的 AIR 中间文件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
使用 ADT 对 AIR 中间文件进行签名 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
对 AIR 应用程序的更新版本进行签名 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
使用 ADT 创建自签名证书 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
第 14 章 : AIR 应用程序描述符文件
应用程序描述符更改
应用程序描述符文件结构 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
AIR
应用程序描述符元素 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
第 15 章 : 设备配置文件
限制应用程序描述符文件中的目标配置文件
不同配置文件的功能 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
第 16 章 : AIR.SWF 浏览器内 API
自定义无缝安装 badge.swf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
使用 badge.swf 文件安装 AIR 应用程序 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
加载 air.swf 文件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
检查是否已安装运行时 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
从网页检查是否已安装 AIR 应用程序 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
从浏览器安装 AIR 应用程序 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
从浏览器启动安装的 AIR 应用程序 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
v
第 17 章 : 更新 AIR 应用程序
关于更新应用程序
提供自定义应用程序更新用户界面 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
将 AIR 文件下载到用户的计算机 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
检查应用程序是否为首次运行 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
使用更新框架 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
第 18 章 : 查看源代码
加载、配置和打开
Source Viewer
第 19 章 : 使用 AIR HTML 内部检查器进行调试
关于
AIR 内部检查器 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
加载 AIR 内部检查器代码 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
在控制台选项卡中检查对象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
配置 AIR 内部检查器 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
AIR
内部检查器界面 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
对非应用程序沙箱中的内容使用 AIR 内部检查器 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
Source Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214
用户界面 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
上次更新 2011/10/13
构建 ADOBE AIR 应用程序
目录
第 20 章 : 本地化 AIR 应用程序
本地化
AIR 应用程序安装程序中的应用程序名称和说明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
使用 AIR HTML 本地化框架本地化 HTML 内容 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229
第 21 章 : 路径环境变量
Bash shell 在 Linux 和 Mac OS 上设置路径 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
使用
在 Windows 上设置路径 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
vi
上次更新 2011/10/13
第 1 章 : 关于 Adobe AIR
Adobe® AIR® 是一个跨操作系统的多屏幕运行时，通过它可以利用您的 Web 开发技能来构建丰富 Internet 应用程序 (RIA)，
并将其部署到桌面和移动设备上。可以使用
电视和移动
在 Adobe AIR 开发人员中心 (http://www.adobe.com/cn/devnet/air/) 上可以找到有关 Adobe AIR 入门和使用的详细信
息。
通过
AIR 应用程序。桌面 AIR 应用程序也可以使用 HTML、 JavaScript® 和 Ajax （基于 HTML）进行构建。
AIR，您可以在熟悉的环境中工作，可以利用您认为最方便的工具和方法。由于它支持 Flash、 Flex、 HTML、
JavaScript 和 Ajax，您可以创造满足您需要的可能的最佳体验。
例如：可以使用以下技术之一或其某一组合开发应用程序：
• Flash/Flex/ActionScript
• HTML/JavaScript/CSS/Ajax
用户与 AIR 应用程序交互的方式和他们与本机应用程序交互的方式相同。在用户计算机或设备上安装此运行时之后，即可像任
何其他桌面应用程序一样安装和运行 AIR 应用程序。（在 iOS 上，未单独安装 AIR 运行时；每个 iOS AIR 应用程序都是独立
应用程序。）
Adobe® Flex 和 Adobe® Flash® （基于 SWF）通过 ActionScript 3.0 构建桌面、
1
此运行时通过在不同桌面间确保一致的功能和交互来提供用于部署应用程序的一致性跨操作系统平台和框架，从而消除跨浏览
器测试。不是针对特定操作系统进行开发，而是以此运行时为目标，它具有以下优点：
• 针对 AIR 开发的应用程序可以在多个操作系统上运行，同时不需要进行额外的工作。此运行时确保在由 AIR 支持的所有操
作系统上进行一致并可预知的呈现和交互。
• 利用现有的 Web 技术和设计模式可以更快地构建应用程序。无需学习传统的桌面开发技术或复杂的本机代码，您即可将基
于 Web 的应用程序扩展到桌面。
• 与使用诸如 C 和 C++ 之类的较低级别的语言相比，使用此运行时可以更轻松地开发应用程序。无需管理特定于每个操作系
统的复杂的低级别
当针对 AIR 开发应用程序时，可以利用一组丰富的框架和 API：
API。
• 由此运行时提供的特定于 AIR 的 API 和 AIR 框架
• SWF 文件中使用的 ActionScript API 和 Flex 框架 （以及其他基于 ActionScript 的库和框架）
• HTML、 CSS 和 JavaScript
• 大多数 Ajax 框架
• Adobe AIR 的本机扩展，其提供 ActionScript API，该 API 提供对采用本机代码编程的特定于平台的功能的访问。本机
扩展还会提供对旧本机代码以及提供更高性能的本机代码的访问。
AIR 在很大程度上改变了应用程序的创建、部署和使用方式。您获得了更富有创造性的控制能力，并可以将您的基于 Flash、
Flex、 HTML 和 Ajax 的应用程序扩展到桌面、移动设备和电视。
有关每个新 AIR 更新中所包含内容的信息，请参阅 Adobe AIR 发行说明
(http://www.adobe.com/go/learn_air_relnotes_cn)
。
上次更新 2011/10/13
第 2 章 : Adobe AIR 安装
利用 Adobe® AIR® 运行时，可以运行 AIR 应用程序。您可以通过以下方式安装运行时：
• 单独安装运行时 （不同时安装 AIR 应用程序）
• 首次通过网页安装 “ 标志 ” 安装 AIR 应用程序 （同时提示安装运行时）
• 创建安装应用程序和运行时的自定义安装程序。必须获得 Adobe 的批准才能以此方式分发 AIR 运行时。您可通过 Adobe
运行时许可页面请求批准。请注意， Adobe 不提供用于捆绑此类安装程序的工具。但是，有许多第三方安装程序工具包可
用。
• 安装将 AIR 捆绑为捕获运行时的 AIR 应用程序。只有捆绑应用程序才使用捕获运行时。该运行时不用于运行其他 AIR 应
用程序。捆绑运行时在 Android、 Mac 和 Windows 上是可选的。在 iOS 上，所有应用程序都包含捆绑的运行时。
• 设置 AIR 开发环境，如 AIR SDK、Adobe® Flash® Builder™ 或 Adobe Flex® SDK（包含 AIR 命令行开发工具）。SDK
中包含的运行时仅用于调试应用程序，不可用于运行已安装的 AIR 应用程序。
Adobe AIR：系统要求 (http://www.adobe.com/cn/products/air/systemreqs/) 详细介绍了安装 AIR 和运行 AIR 应用程序
的系统要求。
2
运行时安装程序和
考这些日志以帮助确定任何安装问题的原因。请参阅安装日志。
AIR 应用程序安装程序在安装、更新或删除 AIR 应用程序或者 AIR 运行时本身时，将创建日志文件。可参
安装 Adobe AIR
要安装或更新运行时，用户必须对计算机具有管理权限。
在 Windows 计算机上安装运行时
1 从 http://get.adobe.com/cn/air 下载运行时安装文件。
2 双击运行时安装文件。
3 在安装窗口中，按照提示完成安装。
在 Mac 计算机上安装运行时
1 从 http://get.adobe.com/cn/air 下载运行时安装文件。
2 双击运行时安装文件。
3 在安装窗口中，按照提示完成安装。
4 如果安装程序显示 “ 身份验证 ”(Authenticate) 窗口，请输入 Mac OS 用户名和密码。
在 Linux 计算机上安装运行时
注： 此时， Linux 上不支持 AIR 2.7 和更高版本。对 Linux 部署的 AIR 应用程序应该继续使用 AIR 2.6 SDK。
使用二进制安装程序：
1 安装二进制文件可在 http://kb2.adobe.com/cps/853/cpsid_85304.html 上找到并下载。
2 设置文件权限以便可执行安装应用程序。在命令行中您可以使用以下代码设置文件权限：
chmod +x AdobeAIRInstaller.bin
某些 Linux 版本允许您在通过上下文菜单打开的 “ 属性 ” 对话框上设置文件权限。
上次更新 2011/10/13
构建 ADOBE AIR 应用程序
Adobe AIR 安装
3 从命令行中或通过双击运行时安装文件运行安装程序。
4 在安装窗口中，按照提示完成安装。
Adobe AIR
安装。当前，
使用软件包安装程序：
以本机软件包形式进行安装。即，在基于 rpm 发行版中以 rpm 的形式安装，在 Debian 发行版中以 deb 的形式
AIR 不支持任何其他软件包格式。
1 AIR 包文件可在 http://kb2.adobe.com/cps/853/cpsid_85304.html 上找到并下载。根据您的系统支持的软件包格式，
下载
rpm 或 Debian 软件包。
2 如果需要，双击 AIR 包文件以安装此软件包。
您也可以通过命令行安装：
a 在 Debian 系统中：
sudo dpkg -i <path to the package>/adobeair-2.0.0.xxxxx.deb
b 在基于 rpm 的系统中：
sudo rpm -i <path to the package>/adobeair-2.0.0-xxxxx.i386.rpm
或者，如果您更新现有版本 （AIR 1.5.3 或更高版本）：
sudo rpm -U <path to the package>/adobeair-2.0.0-xxxxx.i386.rpm
3
要安装 AIR 2 和 AIR 应用程序，您必须对计算机具有管理员权限。
Adobe AIR 将安装到以下位置：/opt/Adobe AIR/Versions/1.0
AIR
注册 mime 类型 “application/vnd.adobe.air-application-installer-package+zip”，这表示 .air 文件属于此 mime 类
型，因此在
在 Android 设备上安装运行时
您可以通过 Android Market 安装 AIR 运行时的最新发布版。
您可以通过网页上的链接或使用
；不能同时安装发布版和开发版。
有关详细信息，请参阅
在 iOS 设备上安装运行时
必要的
件。
更多帮助主题
第 60 页的 “AIR for iOS”
AIR 运行时中注册。
ADT -installRuntime 命令来安装 AIR 运行时的开发版。一次只能安装一个版本的 AIR 运行时
第 133 页的 “ADT installRuntime 命令 ”。
AIR 运行时代码与针对 iPhone、 iTouch 和 iPad 设备创建的每个应用程序捆绑在一起。您不必安装单独的运行时组
删除 Adobe AIR
安装运行时之后，可以通过以下步骤将其删除。
在 Windows 计算机上删除运行时
1 在 Windows 的 “ 开始 ” 菜单中，选择 “ 设置 ”>“ 控制面板 ”。
2 打开 “ 程序 ”、 “ 程序和功能 ” 或 “ 添加或删除程序 ” 控制面板 （取决于您运行的 Windows 版本）。
上次更新 2011/10/13
构建 ADOBE AIR 应用程序
Adobe AIR 安装
3 选择 “Adobe AIR” 以删除运行时。
4 单击 “ 更改 / 删除 ” 按钮。
在 Mac 计算机上删除运行时
• 双击 “Adobe AIR Uninstaller”，其位于 /Applications/Utilities 文件夹中。
在 Linux 计算机上删除运行时
请执行下列操作之一：
• 从 “ 应用程序 ” 菜单中选择 “Adobe AIR Uninstaller” 命令。
• 运行 AIR 安装程序二进制文件，并加入 -uninstall 选项
• 用包管理器删除 AIR 包（adobeair 和 adobecerts）。
Android 设备删除运行时
从
1 在设备上打开 “ 设置 ” 应用程序。
2 点击 “ 应用程序 ”>“ 管理应用程序 ” 下的 Adobe AIR 条目。
3 点击 “ 卸载 ” 按钮。
您还可以使用
ADT -uninstallRuntime 命令。有关详细信息，请参阅 第 134 页的 “ADT uninstallRuntime 命令 ”。
4
删除捆绑的运行时
要删除捕获捆绑的运行时，必须删除其随之一起安装的应用程序。请注意，捕获运行时仅用于运行安装应用程序。
安装和运行 AIR 范例应用程序
要安装或更新 AIR 应用程序，用户必须对计算机具有管理权限。
某些范例应用程序用于展示 AIR 功能。您可以按照以下说明访问和安装范例应用程序：
1 下载并运行 AIR 范例应用程序。编译后的应用程序及源代码都可用。
2 若要下载并运行范例应用程序，请单击范例应用程序的 “Install Now” 按钮。系统会提示您安装并运行该应用程序。
3 如果您选择下载范例应用程序并稍后运行，请选择下载链接。您可以随时通过以下方式运行 AIR 应用程序：
• 在 Windows 中，双击桌面上的应用程序图标或从 Windows 的 “ 开始 ” 菜单中选择该应用程序。
• 在 Mac OS 中，双击应用程序图标，默认情况下该应用程序安装在用户目录的 Applications 文件夹中 （例如，在
Macintosh HD/Users/JoeUser/Applications/
注： 检查 AIR 发行说明以查看是否有这些说明的更新，发行说明位于以下位置：
中）。
http://www.adobe.com/go/learn_air_relnotes_cn。
Adobe AIR 更新
Adobe 定期使用新功能或小问题修补程序更新 Adobe AIR。使用自动通知和更新功能，Adobe 可以在提供了 Adobe AIR 的
更新版本时自动通知用户。
对
Adobe AIR 的更新可确保 Adobe AIR 正常工作，并且通常包含对安全性的重要更改。Adobe 建议用户，只要提供了新版
本的 Adobe AIR，就更新到这个最新版本 （特别是在涉及安全性更新时）。
上次更新 2011/10/13
构建 ADOBE AIR 应用程序
Adobe AIR 安装
默认情况下，当启动 AIR 应用程序时，运行时检查更新是否可用。至少每两周执行一次更新检查。如果更新可用， AIR 在后
台下载更新。
5
通过使用
tions/SettingsManager/SettingsManager.air
AIR SettingsManager 应用程序，用户可以禁用自动更新功能。 http://airdownload.adobe.com/air/applica-
上提供了可供下载的 AIR SettingsManager 应用程序。
Adobe AIR 的正常安装过程包括连接到 http://airinstall.adobe.com 以发送有关安装环境的基本信息，例如操作系统版本和
语言。仅在每次安装完成后发出此信息且 Adobe 可通过此信息确认安装是否成功。未收集或传输任何个人可识别的信息。
更新捕获运行时
如果使用捕获运行时捆绑分发应用程序，则捕获运行时不会自动更新。为了用户的安全，当发布相关安全更改时，必须监控
发布的更新，并使用新的运行时版本更新应用程序。
Adobe
上次更新 2011/10/13
第 3 章 : 使用 AIR API
Adobe® AIR® 包括不适用于 Adobe® Flash® Player 中运行的 SWF 内容的功能。
6
ActionScript 3.0
开发人员
Adobe AIR API 相关内容在下列两书中进行了介绍：
• ActionScript 3.0 开发人员指南
• 用于 Adobe Flash Platform 的 ActionScript 3.0 参考
HTML 开发人员
在构建基于
访问 AIR API 类），有关此类 API 的相关内容在下列两书中进行了介绍：
HTML 的 AIR 应用程序时，可用于 JavaScript 中的 API 通过 AIRAliases.js 文件获得（请参阅通过 JavaScript
• Adobe AIR HTML 开发人员指南
• 针对 HTML 开发人员的 Adobe AIR API 参考
特定于 AIR 的 ActionScript 3.0 类
下表列出了特定于 Adobe AIR 的运行时类，它们不可用于在浏览器中的 Adobe® Flash® Player 中运行的 SWF 内容。
HTML 开发人员
通过 AIRAliases.js 文件获得、可用于 JavaScript 的类在针对 HTML 开发人员的 Adobe AIR API 参考中列出。
类
ActionScript 3.0 包 AIR 版本中添加了以下内容
ARecord flash.net.dns 2.0
AAAARecord flash.net.dns 2.0
ApplicationUpdater air.update 1.5
ApplicationUpdaterUI air.update 1.5
AudioPlaybackMode flash.media 3.0
AutoCapitalize flash.text 3.0
BrowserInvokeEvent flash.events 1.0
CameraPosition flash.media 3.0
CameraRoll flash.media 2.0
CameraRollBrowseOptions flash.media 3.0
CameraUI flash.media 2.5
CertificateStatus flash.security 2.0
CompressionAlgorithm flash.utils 1.0
上次更新 2011/10/13
构建 ADOBE AIR 应用程序
使用 AIR API
7
类
ActionScript 3.0 包 AIR 版本中添加了以下内容
DatagramSocket flash.net 2.0
DatagramSocketDataEvent flash.events 2.0
DNSResolver flash.net.dns 2.0
DNSResolverEvent flash.events 2.0
DockIcon flash.desktop 1.0
DownloadErrorEvent air.update.events 1.5
DRMAuthenticateEvent flash.events 1.0
DRMDeviceGroup flash.net.drm 3.0
DRMDeviceGroupErrorEvent flash.net.drm 3.0
DRMDeviceGroupEvent flash.net.drm 3.0
DRMManagerError flash.errors 1.5
EncryptedLocalStore flash.data 1.0
ExtensionContext flash.external 2.5
File flash.filesystem 1.0
FileListEvent flash.events 1.0
FileMode flash.filesystem 1.0
FileStream flash.filesystem 1.0
FocusDirection flash.display 1.0
GameInput flash.ui 3.0
GameInputControl flash.ui 3.0
GameInputControlType flash.ui 3.0
GameInputDevice flash.ui 3.0
GameInputEvent flash.ui 3.0
GameInputFinger flash.ui 3.0
GameInputHand flash.ui 3.0
Geolocation flash.sensors 2.0
GeolocationEvent flash.events 2.0
HTMLHistoryItem flash.html 1.0
HTMLHost flash.html 1.0
HTMLLoader flash.html 1.0
HTMLPDFCapability flash.html 1.0
HTMLSWFCapabiltiy flash.html 2.0
HTMLUncaughtScriptExceptionEvent flash.events 1.0
HTMLWindowCreateOptions flash.html 1.0
上次更新 2011/10/13
构建 ADOBE AIR 应用程序
使用 AIR API
8
类
ActionScript 3.0 包 AIR 版本中添加了以下内容
Icon flash.desktop 1.0
IFilePromise flash.desktop 2.0
ImageDecodingPolicy flash.system 2.6
InteractiveIcon flash.desktop 1.0
InterfaceAddress flash.net 2.0
InvokeEvent flash.events 1.0
InvokeEventReason flash.desktop 1.5.1
IPVersion flash.net 2.0
IURIDereferencer flash.security 1.0
LocationChangeEvent flash.events 2.5
MediaEvent flash.events 2.5
MediaPromise flash.media 2.5
MediaType flash.media 2.5
MXRecord flash.net.dns 2.0
NativeApplication flash.desktop 1.0
NativeDragActions flash.desktop 1.0
NativeDragEvent flash.events 1.0
NativeDragManager flash.desktop 1.0
NativeDragOptions flash.desktop 1.0
NativeMenu flash.display 1.0
NativeMenuItem flash.display 1.0
NativeProcess flash.desktop 2.0
NativeProcessExitEvent flash.events 2.0
NativeProcessStartupInfo flash.desktop 2.0
NativeWindow flash.display 1.0
NativeWindowBoundsEvent flash.events 1.0
NativeWindowDisplayState flash.display 1.0
NativeWindowDisplayStateEvent flash.events 1.0
NativeWindowInitOptions flash.display 1.0
NativeWindowRenderMode flash.display 3.0
NativeWindowResize flash.display 1.0
NativeWindowSystemChrome flash.display 1.0
NativeWindowType flash.display 1.0
NetworkInfo flash.net 2.0
上次更新 2011/10/13
构建 ADOBE AIR 应用程序
使用 AIR API
9
类
ActionScript 3.0 包 AIR 版本中添加了以下内容
NetworkInterface flash.net 2.0
NotificationType flash.desktop 1.0
OutputProgressEvent flash.events 1.0
PaperSize flash.printing 2.0
PrintMethod flash.printing 2.0
PrintUIOptions flash.printing 2.0
PTRRecord flash.net.dns 2.0
ReferencesValidationSetting flash.security 1.0
ResourceRecord flash.net.dns 2.0
RevocationCheckSettings flash.security 1.0
Screen flash.display 1.0
ScreenMouseEvent flash.events 1.0
SecureSocket flash.net 2.0
SecureSocketMonitor air.net 2.0
ServerSocket flash.net 2.0
ServerSocketConnectEvent flash.events 2.0
ServiceMonitor air.net 1.0
SignatureStatus flash.security 1.0
SignerTrustSettings flash.security 1.0
SocketMonitor air.net 1.0
SoftKeyboardType flash.text 3.0
SQLCollationType flash.data 1.0
SQLColumnNameStyle flash.data 1.0
SQLColumnSchema flash.data 1.0
SQLConnection flash.data 1.0
SQLError flash.errors 1.0
SQLErrorEvent flash.events 1.0
SQLErrorOperation flash.errors 1.0
SQLEvent flash.events 1.0
SQLIndexSchema flash.data 1.0
SQLMode flash.data 1.0
SQLResult flash.data 1.0
SQLSchema flash.data 1.0
SQLSchemaResult flash.data 1.0
上次更新 2011/10/13
构建 ADOBE AIR 应用程序
使用 AIR API
10
类
SQLStatement flash.data 1.0
SQLTableSchema flash.data 1.0
SQLTransactionLockType flash.data 1.0
SQLTriggerSchema flash.data 1.0
SQLUpdateEvent flash.events 1.0
SQLViewSchema flash.data 1.0
SRVRecord flash.net.dns 2.0
StageAspectRatio flash.display 2.0
StageOrientation flash.display 2.0
StageOrientationEvent flash.events 2.0
StageText flash.text 3.0
StageTextInitOptions flash.text 3.0
StageWebView flash.media 2.5
StatusFileUpdateErrorEvent air.update.events 1.5
StatusFileUpdateEvent air.update.events 1.5
StatusUpdateErrorEvent air.update.events 1.5
ActionScript 3.0 包 AIR 版本中添加了以下内容
StatusUpdateEvent air.update.events 1.5
StorageVolume flash.filesystem 2.0
StorageVolumeChangeEvent flash.events 2.0
StorageVolumeInfo flash.filesystem 2.0
SystemIdleMode flash.desktop 2.0
SystemTrayIcon flash.desktop 1.0
TouchEventIntent flash.events 3.0
UpdateEvent air.update.events 1.5
Updater flash.desktop 1.0
URLFilePromise air.desktop 2.0
URLMonitor air.net 1.0
URLRequestDefaults flash.net 1.0
XMLSignatureValidator flash.security 1.0
具有特定于 AIR 功能的 Flash Player 类
以下类可用于在浏览器中运行的 SWF 内容，但 AIR 提供了附加的属性或方法：
上次更新 2011/10/13
构建 ADOBE AIR 应用程序
使用 AIR API
11
包 类 属性、方法或事件
AIR 版本中添加了以下内
容
flash.desktop Clipboard supportsFilePromise 2.0
ClipboardFormats BITMAP_FORMAT 1.0
FILE_LIST_FORMAT 1.0
FILE_PROMISE_LIST_FORMAT 2.0
URL_FORMAT 1.0
flash.display LoaderInfo
childSandboxBridge 1.0
parentSandboxBridge 1.0
Stage assignFocus() 1.0
autoOrients 2.0
deviceOrientation 2.0
nativeWindow 1.0
orientation 2.0
orientationChange
orientationChanging
事件 2.0
事件 2.0
setAspectRatio 2.0
setOrientation 2.0
softKeyboardRect 2.6
supportedOrientations 2.6
supportsOrientationChange 2.0
NativeWindow owner 2.6
listOwnedWindows 2.6
NativeWindowInitOptions owner 2.6
上次更新 2011/10/13
构建 ADOBE AIR 应用程序
使用 AIR API
12
包 类 属性、方法或事件
AIR 版本中添加了以下内
容
flash.events Event CLOSING 1.0
DISPLAYING 1.0
PREPARING 2.6
EXITING 1.0
HTML_BOUNDS_CHANGE 1.0
HTML_DOM_INITIALIZE 1.0
HTML_RENDER 1.0
LOCATION_CHANGE 1.0
NETWORK_CHANGE 1.0
STANDARD_ERROR_CLOSE 2.0
STANDARD_INPUT_CLOSE 2.0
STANDARD_OUTPUT_CLOSE 2.0
USER_IDLE 1.0
USER_PRESENT 1.0
HTTPStatusEvent
HTTP_RESPONSE_STATUS 1.0
KeyboardEvent
responseHeaders 1.0
responseURL 1.0
commandKey 1.0
controlKey 1.0
上次更新 2011/10/13
构建 ADOBE AIR 应用程序
使用 AIR API
13
包 类 属性、方法或事件
AIR 版本中添加了以下内
容
flash.net FileReference extension 1.0
httpResponseStatus 事件 1.0
uploadUnencoded() 1.0
NetStream
drmAuthenticate 事件 1.0
onDRMContentData 事件 1.5
preloadEmbeddedData() 1.5
resetDRMVouchers() 1.0
setDRMAuthenticationCredentials() 1.0
URLRequest authenticate 1.0
cacheResponse 1.0
followRedirects 1.0
idleTimeout 2.0
manageCookies 1.0
useCache 1.0
userAgent 1.0
URLStream
httpResponseStatus event 1.0
上次更新 2011/10/13
构建 ADOBE AIR 应用程序
使用 AIR API
14
包 类 属性、方法或事件
flash.printing PrintJob active 2.0
copies 2.0
firstPage 2.0
isColor 2.0
jobName 2.0
lastPage 2.0
maxPixelsPerInch 2.0
paperArea 2.0
printableArea 2.0
printer 2.0
printers 2.0
selectPaperSize() 2.0
showPageSetupDialog() 2.0
start2() 2.0
supportsPageSetupDialog 2.0
AIR 版本中添加了以下内
容
terminate() 2.0
PrintJobOptions
flash.system Capabilities
LoaderContext
Security
flash.ui KeyLocation D_PAD 2.5
pixelsPerInch 2.0
printMethod 2.0
languages 1.1
allowLoadBytesCodeExecution 1.0
APPLICATION 1.0
以上多数新增属性和方法都只对 AIR 应用程序安全沙箱中的内容可用。但 URLRequest 类中的新增成员对于其他沙箱中运行
的内容也可用。
ByteArray.compress() 和 ByteArray.uncompress() 方法都包含一个新的 algorithm 参数，供您在 deflate 和 zlib 压缩之间选择。
此参数仅对
AIR 中运行的内容可用。
特定于 AIR 的 Flex 组件
开发 Adobe AIR 内容时可以使用以下 Adobe® Flex™ MX 组件：
• FileEvent
• FileSystemComboBox
• FileSystemDataGrid
• FileSystemEnumerationMode
上次更新 2011/10/13
构建 ADOBE AIR 应用程序
使用 AIR API
• FileSystemHistoryButton
• FileSystemList
• FileSystemSizeDisplayMode
• FileSystemTree
• FlexNativeMenu
• HTML
• Window
• WindowedApplication
• WindowedSystemManager
另外， Flex 4 包括下列 spark AIR 组件：
• Window
• WindowedApplication
有关 AIR Flex 组件的详细信息，请参阅使用 Flex AIR 组件。
15
上次更新 2011/10/13
第 4 章 : 适用于 AIR 开发的 Adobe Flash
16
Platform
您可以使用下列 Adobe Flash Platform 开发工具开发 AIR 应用程序。
对于
ActionScript 3.0 （Flash 和 Flex）开发人员：
• Adobe Flash Professional （请参阅为 AIR 发布）
• Adobe Flex 3.x 和 4.x SDK （请参阅第 17 页的 “ 安装 Flex SDK” 和第 125 页的 “AIR Developer Tool (ADT)”）
• Adobe Flash Builder （请参阅使用 Flash Builder 开发 AIR 应用程序）
对于 HTML 和 Ajax 开发人员：
• Adobe AIR SDK （请参阅第 16 页的 “ 安装 AIR SDK” 和第 125 页的 “AIR Developer Tool (ADT)”）
• Adobe Dreamweaver CS3、 CS4、 CS5 （请参阅 Dreamweaver 的 AIR 扩展）
工具
安装 AIR SDK
Adobe AIR SDK 中包含以下命令行工具，可用于启动和打包应用程序：
AIR Debug Launcher (ADL) 允许您在不进行安装的情况下运行 AIR 应用程序。请参阅 第 121 页的 “AIR Debug Launcher
。
(ADL)”
AIR Development Tool (ADT) 将 AIR 应用程序打包为可分发的安装包。请参阅第 125 页的 “AIR Developer Tool
(ADT)”
。
AIR
命令行工具要求必须在计算机上安装 Java。可以使用 JRE 或 JDK （1.5 或更高版本）中的 Java 虚拟机。可以在
/http://java.sun.com/
要运行 ADT 工具，至少需要 2GB 的计算机内存。
注： 最终用户运行 AIR 应用程序时不需要 Java。
有关使用
”。
AIR SDK 构建 AIR 应用程序的简介，请参阅第 30 页的 “ 使用 AIR SDK 创建第一个基于 HTML 的 AIR 应用程序
上找到 Java JRE 和 Java JDK。
下载并安装 AIR SDK
可以按照以下说明下载并安装 AIR SDK：
在
Windows 中安装 AIR SDK
• 下载 AIR SDK 安装文件。
• AIR SDK 按标准归档文件进行分发。若要安装 AIR，请将 SDK 的内容提取到计算机上的一个文件夹 （例如：
C:\Program Files\Adobe\AIRSDK 或 C:\AIRSDK）中。
• ADL 和 ADT 工具包含在 AIR SDK 的 bin 文件夹中；请将此文件夹的路径添加到 PATH 环境变量中。
在 Mac OS X 中安装 AIR SDK
• 下载 AIR SDK 安装文件。
上次更新 2011/10/13
构建 ADOBE AIR 应用程序
适用于 AIR 开发的 Adobe Flash Platform 工具
• AIR SDK 按标准归档文件进行分发。若要安装 AIR，请将 SDK 的内容提取到计算机上的一个文件夹 （例如：
/Users/<userName>/Applications/AIRSDK）中。
• ADL 和 ADT 工具包含在 AIR SDK 的 bin 文件夹中；请将此文件夹的路径添加到 PATH 环境变量中。
在 Linux 中安装 AIR SDK
• 此 SDK 是以 tbz2 格式提供的。
• 要安装此 SDK，请创建一个要在其中解压缩此 SDK 的文件夹，然后使用以下命令：tar -jxvf <path to AIR-SDK.tbz2>
有关使用 AIR SDK 工具快速入门的信息，请参阅 “ 使用命令行工具创建 AIR 应用程序 ”。
AIR SDK 中的内容
下表介绍了 AIR SDK 中所包含文件的用途：
SDK 文件夹 文件 / 工具描述
bin 使用 AIR Debug Launcher (ADL)，可以在不先打包和安装 AIR 应用程序的情况下运行
它。有关使用此工具的信息，请参阅
AIR Developer Tool (ADT) 会将应用程序打包为 AIR 文件以便分发。有关使用此工具的
信息，请参阅第
125 页的 “AIR Developer Tool (ADT)”。
第 121 页的 “AIR Debug Launcher (ADL)”。
17
frameworks libs
include include 目录包含用于编写本机扩展的 C 语言标头文件。
install install 目录包含 Android 设备的 Windows USB 启动程序。（这些驱动程序由 Google 提
lib 包含 AIR SDK 工具的支持代码。
runtimes 适用于桌面和适用于移动设备的 AIR 运行时。
samples 此文件夹包含示例应用程序描述符文件、无缝安装功能示例 (badge.swf) 以及默认的 AIR
templates descriptor-template.xml - 应用程序描述符文件的模板，每个 AIR 应用程序都需要该模
目录包含可在 AIR 应用程序中使用的代码库。
目录包含用于编译的 SWF 和 SWC 库的代码。
projects
供，包含在
桌面运行时由
适用于 Android 的 AIR 运行时 （APK 包）可安装在 Android 设备或模拟器上，用于开
发和测试。设备和模拟器使用单独的
Android
应用程序图标。
板。有关应用程序描述符文件的详细描述，请参阅第
”。
在此文件夹中，还可找到
Android SDK 中。）
ADL 用以在打包或安装 AIR 应用程序之前启动此类应用程序。
APK 包。（从 Android Market 可以获取适用于
的公共 AIR 运行时。）
154 页的 “AIR 应用程序描述符文件
AIR 每个发行版的应用程序描述符 XML 结构的架构文件。
安装 Flex SDK
要使用 Adobe® Flex™ 开发 Adobe® AIR® 应用程序，可以选择下列方式：
• 您可以下载并安装 Adobe® Flash® Builder™，其中提供了创建 Adobe AIR 项目以及测试、调试和打包 AIR 应用程序的集
成工具。请参阅第 19 页的 “ 在 Flash Builder 中创建第一个桌面 Flex AIR 应用程序 ”。
• 您可以下载 Adobe® Flex™ SDK 并使用您最喜爱的文本编辑器和命令行工具开发 Flex AIR 应用程序。
上次更新 2011/10/13
构建 ADOBE AIR 应用程序
适用于 AIR 开发的 Adobe Flash Platform 工具
有关使用 Flex SDK 构建 AIR 应用程序的简介，请参阅第 33 页的 “ 使用 Flex SDK 创建第一个桌面 AIR 应用程序 ”。
安装 Flex SDK
使用命令行工具生成 AIR 应用程序要求计算机上必须已安装 Java。可以使用 JRE 或 JDK （1.5 或更高版本）中的 Java 虚拟
机。
http://java.sun.com/ 上提供了 Java JRE 和 JDK。
注： 最终用户运行 AIR 应用程序时不需要 Java。
Flex SDK 提供了相关的 AIR API 和命令行工具，可用于对 AIR 应用程序进行打包、编译和调试。
1 如果尚未下载 Flex SDK，请从以下网址下载：http://opensource.adobe.com/wiki/display/flexsdk/Downloads。
2 将 SDK 的内容放到一个文件夹 （例如 Flex SDK）中。
3 复制 AIR SDK 的内容并覆盖 Flex SDK 中的文件。
注： 在 Mac 计算机上，确保您复制或替换的是 SDK 文件夹中的个别文件，而不是整个目录。默认情况下，将 Mac 上的某
个目录复制到同名目录上，会删除目标目录中的现有文件，而不会合并两个目录的内容。可在终端窗口中使用 ditto 命令来
AIR SDK 合并到 Flex SDK 中：ditto air_sdk_folder flex_sdk_folder
将
4 命令行 AIR 实用程序位于 bin 文件夹中。
18
设置外部 SDK
为 Android 和 iOS 开发应用程序要求您从平台制造商处下载供给文件、 SDK 或其他开发工具。
有关下载和安装 Android SDK 的信息，请参阅 Android 开发人员：安装 SDK。从 AIR 2.6 开始，不需要下载 Android
SDK
。 AIR SDK 现已包含安装和启动 APK 包所需的基本组件。不过，对于各种开发任务 （包括创建和运行软件仿真器以及
获取设备屏幕截图）来说， Android SDK 仍然非常有用。
iOS 开发不需要外部 SDK。但是，需要专用证书和供给配置文件。有关更多信息，请参阅从 Apple 获取开发人员文件。
上次更新 2011/10/13
第 5 章 : 创建第一个 AIR 应用程序
在 Flash Builder 中创建第一个桌面 Flex AIR 应用程序
为了通过实际操作较快地说明 Adobe® AIR® 的工作原理，请按照以下说明使用 Adobe® Flash® Builder 创建并打包一个简单的
基于 SWF 文件的 AIR“Hello World” 应用程序。
如果尚未执行这些操作，请下载并安装 Flash Builder。此外，还需要下载并安装最新版本的 Adobe AIR，位于此处：
www.adobe.com/go/air_cn。
创建 AIR 项目
Flash Builder 包括用于开发和打包 AIR 应用程序的工具。
19
通过定义一个新项目来开始在
项目的方式相同。
1 打开 Flash Builder。
2 依次选择 “ 文件 ”>“ 新建 ”>“Flex 项目 ”。
3 输入项目名称，例如 AIRHelloWorld。
4 在 Flex 中， AIR 应用程序被视为一种应用程序类型。有两种类型可供您选择：
• 在 Adobe® Flash® Player 中运行的 Web 应用程序
• 在 Adobe AIR 中运行的桌面应用程序
选择 Desktop 作为应用程序类型。
5 单击 “ 完成 ” 以创建此项目。
Flash Builder 和 Flex Builder 中创建 AIR 应用程序，其方式与创建其他基于 Flex 的应用程序
AIR 项目最初由两个文件组成：主 MXML 文件和应用程序 XML 文件 （称为应用程序描述符文件）。后一个文件用于指定应
用程序的属性。
有关详细信息，请参阅使用 Flash Builder 开发 AIR 应用程序。
编写 AIR 应用程序代码
若要编写 “Hello World” 应用程序代码，请编辑在编辑器中打开的应用程序 MXML 文件 (AIRHelloWorld.mxml)。（如果
该文件尚未打开，请使用
桌面上的 Flex AIR 应用程序内含在 MXML WindowedApplication 标签内。MXML WindowedApplication 标签用于创
建一个简单窗口，此窗口包括诸如标题栏和关闭按钮之类的基本窗口控件。
Project Navigator 打开该文件。）
1 对 WindowedApplication 组件添加 title 属性，并为此属性赋予值 "Hello World"：
<?xml version="1.0" encoding="utf-8"?>
<s:WindowedApplication xmlns:fx="http://ns.adobe.com/mxml/2009"
xmlns:s="library://ns.adobe.com/flex/spark"
xmlns:mx="library://ns.adobe.com/flex/mx"
title="Hello World">
</s:WindowedApplication>
2 对此应用程序添加 Label 组件 （将其置于 WindowedApplication 标签内），将 Label 组件的 text 属性设置为 "Hello
AIR"
，并设置布局限制以使其保持居中，如下所示：
上次更新 2011/10/13
构建 ADOBE AIR 应用程序
创建第一个 AIR 应用程序
<?xml version="1.0" encoding="utf-8"?>
<s:WindowedApplication xmlns:fx="http://ns.adobe.com/mxml/2009"
xmlns:s="library://ns.adobe.com/flex/spark"
xmlns:mx="library://ns.adobe.com/flex/mx"
title="Hello World">
<s:Label text="Hello AIR" horizontalCenter="0" verticalCenter="0"/>
</s:WindowedApplication>
3 在刚输入的 Label 组件标签之前，紧跟 WindowedApplication 开始标签添加以下样式块。
<fx:Style>
@namespace s "library://ns.adobe.com/flex/spark";
s|WindowedApplication
{
skinClass:ClassReference("spark.skins.spark.SparkChromeWindowedApplicationSkin");
background-color:#999999;
background-alpha:"0.7";
}
</fx:Style>
这些样式设置将应用于整个应用程序，用稍稍透明的灰色呈现窗口。
现在，应用程序代码类似于如下内容：
<?xml version="1.0" encoding="utf-8"?>
<s:WindowedApplication xmlns:fx="http://ns.adobe.com/mxml/2009"
xmlns:s="library://ns.adobe.com/flex/spark"
xmlns:mx="library://ns.adobe.com/flex/mx"
title="Hello World">
<fx:Style>
@namespace s "library://ns.adobe.com/flex/spark";
s|WindowedApplication
{
skinClass:ClassReference("spark.skins.spark.SparkChromeWindowedApplicationSkin");
background-color:#999999;
background-alpha:"0.7";
}
</fx:Style>
<s:Label text="Hello AIR" horizontalCenter="0" verticalCenter="0"/>
</s:WindowedApplication>
20
接下来，您要更改应用程序描述符中的一些设置，以允许应用程序变得透明：
1 在 Flex Navigator 窗格中，在项目的源目录中找到该应用程序的描述符文件。如果项目名为 AIRHelloWorld，则该文件
应该名为 AIRHelloWorld-app.xml。
2 双击该应用程序描述符文件，以便在 Flash Builder 中进行编辑。
3 在 XML 代码中，找到 systemChrome 和 transparent 属性 （属于 initialWindow 属性）的注释行。删除注释。（删除 "<!--"
和 "-->" 注释分隔符。）
4 将 systemChrome 属性的文本值设为 none，如下所示：
<systemChrome>none</systemChrome>
5 将 transparent 属性的文本值设为 true，如下所示：
<transparent>true</transparent>
6 保存该文件。
上次更新 2011/10/13
构建 ADOBE AIR 应用程序
创建第一个 AIR 应用程序
测试 AIR 应用程序
若要测试编写完的应用程序代码，请在调试模式下运行它。
1 单击主工具栏上的 “ 调试 ” 按钮 。
也可以选择 “ 运行 ”>“ 调试 ” >“AIRHelloWorld 命令 ”。
生成的
AIR 应用程序应如下例所示：
21
2 通过使用 Label 控件的 horizontalCenter 和 verticalCenter 属性，文本位于窗口的中心位置。移动窗口或调整窗口大小，像
对任何其他桌面应用程序所做的那样。
注： 如果此应用程序不编译，请修正输入代码时无意间造成的语法错误或拼写错误。错误和警告显示在 Flash Builder 的 “ 问题
” 视图中。
打包 AIR 应用程序、为应用程序签名和运行应用程序
现在已准备好将 “Hello World” 应用程序打包为 AIR 文件以进行分发。 AIR 文件是一个包含应用程序文件的归档文件，这里
的应用程序文件为项目 bin 文件夹中包含的所有文件。在此简单示例中，这些文件为 SWF 和应用程序 XML 文件。将此 AIR
包分发给用户，用户随后使用此包安装此应用程序。此过程中的一个必需步骤是对包进行数字签名。
1 确保应用程序没有编译错误并按预期运行。
2 选择 “ 项目 ”>“ 导出发行版 ”。
3 查看 AIRHelloWorld 项目和 AIRHelloWorld.mxml 应用程序是否已列出。
4 选择 “ 导出为签名的 AIR 包 ” 选项。然后单击 “ 下一步 ”。
5 如果有现成的数字证书，请单击 “ 浏览 ” 找到并选中它。
6 如果必须创建新的自签名数字证书，请选择 “ 创建 ”。
7 输入所需信息，然后单击 “ 确定 ”。
8 单击 “ 完成 ” 以生成名为 AIRHelloWorld.air 的 AIR 包。
现在，既可以从
和运行该应用程序。
Flash Builder 的 Project Navigator 中安装和运行该应用程序，也可以通过双击该 AIR 文件从文件系统安装
上次更新 2011/10/13
构建 ADOBE AIR 应用程序
创建第一个 AIR 应用程序
使用 Flash Professional 创建第一个桌面 AIR 应用程序
为了通过实际操作快速演示 Adobe® AIR® 的工作原理，请遵循本主题中的说明使用 Adobe® Flash® Professional 创建并打包
一个简单的 “Hello World”AIR 应用程序。
如果尚未执行这些操作，请下载并安装 Adobe AIR，其位置为：www.adobe.com/go/air_cn。
在 Flash 中创建 Hello World 应用程序
在 Flash 中创建 Adobe AIR 应用程序与创建任何其他 FLA 文件非常相似。以下步骤将指导您完成使用 Flash Professional 创
建简单的 Hello World 应用程序的过程。
创建
Hello World 应用程序
1 启动 Flash。
2 在 “ 欢迎 ” 屏幕上，单击 “AIR” 以创建具有 Adobe AIR 发布设置的空 FLA 文件。
3 在 “ 工具 ” 面板中选择 “ 文本 ” 工具并在舞台的中央创建静态文本字段（默认值）。将其宽度设置为足以包含 15-20 个字符。
4 在该文本字段中输入文本 “Hello World”。
5 保存该文件，为其指定一个名称 （例如， HelloAIR）。
22
测试应用程序
1 按 Ctrl + Enter 或选择 “ 控制 ”->“ 测试影片 ”->“ 测试 ” 以在 Adobe AIR 中测试应用程序。
2 若要使用 “ 调试影片 ” 功能，请首先向该应用程序添加 ActionScript 代码。可以通过添加类似以下的 trace 语句来快速尝试
该操作：
trace("Running AIR application using Debug Movie");
3 按 Ctrl + Shift + Enter 或选择 “ 调试 ”->“ 调试影片 ”->“ 调试 ” 以对该应用程序运行 “ 调试影片 ”。
Hello World 应用程序的外观如下图所示：
上次更新 2011/10/13
构建 ADOBE AIR 应用程序
创建第一个 AIR 应用程序
打包应用程序
1 选择 “ 文件 ”>“ 发布 ”。
2 使用现有数字证书对 Adobe AIR 包签名或按照下列步骤创建自签名证书：
a 单击 “ 证书 ” 字段旁边的 “ 新建 ” 按钮。
b 填写 “ 发布者名称 ”、 “ 部门 ”、 “ 组织名称 ”、 “ 电子邮件 ”、 “ 国家 / 地区 ”、 “ 密码 ” 和 “ 确认密码 ” 条目。
c 指定证书的类型。“ 证书类型 ” 选项是指安全级别：1024-RSA 使用 1024 位密钥（不太安全），2048-RSA 使用 2048
位密钥 （较为安全）。
d 通过填写 “ 另存为 ” 条目或单击 “ 浏览 ...” 按钮浏览到文件夹位置，将信息保存到证书文件中。（例如，
C:/Temp/mycert.pfx）。完成后，请单击 “ 确定 ”。
e Flash 将返回到 “ 数字签名 ” 对话框。您创建的自签名证书的路径和文件名均显示在 “ 证书” 文本框中。如果未显示，请输
入路径和文件名或者单击 “ 浏览 ” 按钮找到并选择它。
f 在“ 数字签名 ”对话框的 “密码 ”文本字段中输入步骤 b 中所指定的同一个密码。有关对 Adobe AIR 应用程序进行签名的
更多信息，请参阅第 143 页的 “ 对 AIR 文件进行数字签名 ”。
3 若要创建应用程序和安装程序文件，请单击 “ 发布 ” 按钮。（在 Flash CS4 和 CS5 中，请单击 “ 确定 ” 按钮。）在创建 AIR 文
件之前，必须执行 “ 测试影片 ” 或 “ 调试影片 ” 来创建 SWF 文件和 application.xml 文件。
4 若要安装应用程序，请双击保存该应用程序的同一个文件夹中的 AIR 文件 (application.air)。
5 在 “ 应用程序安装 ” 对话框中，单击 “ 安装 ” 按钮。
6 检查 “ 安装首选参数 ” 和 “ 位置 ” 设置，确保选中了 “ 安装后启动应用程序 ” 复选框。然后单击 “ 继续 ”。
7 在出现 “ 安装已完成 ” 消息时，单击 “ 完成 ”。
23
在 Flash Professional 中创建您的第一个 AIR for Android 应用程序
若要开发 AIR for Android 应用程序，必须从 Adobe Labs 下载 Flash Professional CS5 for Android 扩展。
同时还必须从
创建项目
1 打开 Flash Professional CS5
2 创建新的 AIR for Android 项目。
Flash Professional 主屏幕包括一个用于创建 AIR for Android 应用程序的链接。您也可以选择 “ 文件 ”>“ 新建 ”，然后
选择
3 将文档另存为 HelloWorld.fla
编写代码
由于此教程并不是关于编写代码的，因此只要使用 “ 文本 ” 工具在舞台上写入 “Hello, World!” 即可。
设置应用程序属性
1 选择 “ 文件 ”>“AIR Android 设置 ”。
2 在 “ 常规 ” 选项卡中，设置下列内容：
• 输出文件：HelloWorld.apk
Android 网站下载并安装 Android SDK，如 Android 开发人员：安装 SDK 中所述。
“AIR for Android” 模板。
上次更新 2011/10/13
构建 ADOBE AIR 应用程序
创建第一个 AIR 应用程序
• 应用程序名称：HelloWorld
• 应用程序 ID：HelloWorld
• 版本号：0.0.1
• 高宽比：纵向
3 在 “ 部署 ” 选项卡上，设置下列内容：
• 证书：指向有效的 AIR 代码签名证书。可以单击 “ 创建 ” 按钮以创建新的证书。（通过 Android Marketplace 部署的
Android
应用程序必须具有有效期至少到 2033 年的证书。在 “ 密码 ” 字段中输入证书密码。
• Android 部署类型：调试
• 发布后：同时选择这两个选项
• 在 Android SDK 的工具子目录中输入到 ADB 工具的路径。
4 单击 “ 确定 ” 关闭 “Android 设置 ” 对话框。
应用程序在此开发阶段不需要图标或权限。大多数
能。您仅应设置应用程序真正需要的那些权限，因为如果您的应用程序要求的权限太多，用户可能会拒绝该应用程序。
AIR for Android 应用程序都需要具有一定的权限才能访问受保护的功
5 保存该文件。
在 Android 设备上安装应用程序并对其进行打包
1 确保在您的设备上已启用 USB 调试。您可以在 “ 应用程序 ”>“ 开发 ” 下的 Settings 应用程序中打开 USB 调试。
2 使用 USB 电缆将您的设备连接到计算机上。
3 如果您尚未安装 AIR 运行时，请通过转到 Android Market 并下载 Adobe AIR 进行安装。（也可以使用 第 133 页的
“ADT installRuntime 命令 ” 本地安装 AIR。 AIR SDK 中包括在 Android 设备和仿真器上使用的 Android 包。）
4 选择 “ 文件 ”>“ 发布 ”。
Flash Professional 会创建 APK 文件，在连接的 Android 设备上安装应用程序，并启动该应用程序。
24
创建第一个用于 iOS 的 AIR 应用程序
AIR 2.6 或更高版本， iOS 4.2 或更高版本
只需使用 Adobe 工具即可编写和生成 iOS 应用程序并测试 iOS 应用程序的基本功能。但是，若要在设备上安装 iOS 应用程序
并分发该应用程序，您必须加入
Provisioning Portal
之用。这些项目和文件包括：
，通过该网站，可以从 Apple 获得在设备上安装应用程序所需的以下项目和文件，以供测试和后续分发
• 开发和分发证书
• 应用程序 ID
• 开发和分发供给文件
创建应用程序内容
创建一个显示文本 “Hello world!” 的 SWF 文件可以使用 Flash Professional、Flash Builder 或其他 IDE 来执行此任务。此
示例只使用了文本编辑器和
1 在适当的位置创建一个目录，用于存储您的应用程序文件。创建一个名为 HelloWorld.as 的文件，然后使用您喜欢的代码
编辑器编辑该文件。
Apple iOS 开发人员计划（这是一项免费服务）。加入 iOS 开发人员计划之后，可以访问 iOS
Flex SDK 中附带的命令行 SWF 编译器。
上次更新 2011/10/13
Loading...