准备工作：理顺Adobe AIR环境三要素

配置Adobe AIR环境，准备工作必须做扎实。

运行时、SDK和环境变量这三样东西，缺一不可。

如果没理顺，哪怕最简单的Hello World也跑不起来——adt命令报错、adl无法启动，都是常见问题。

所以，先明确一点：必须在系统里安装好Adobe AIR运行时，并配置好AIR SDK的环境变量，否则后面的工作无从谈起。

第一步：安装并验证Adobe AIR运行时

1.1 下载与安装

先搞定运行时本身。打开浏览器，访问Adobe的官方下载页面。系统会自动识别你的操作系统，点击【Download Now】即可。

• Windows用户：双击安装包，勾选许可协议，保持默认路径，一路“下一步”。
• macOS用户：要格外注意。双击DMG文件，把Adobe AIR图标拖进“应用程序”文件夹。然后右键该应用，选择“显示简介”。在打开的窗口里勾选“仍要打开”——这一步是为了绕过macOS的Gatekeeper安全机制。如果漏掉，系统会直接阻拦安装进程，后续任何命令都救不回来。完成之后启动安装向导，按提示操作。
• Linux用户：执行对应安装命令。
  Debian/Ubuntu系统：sudo dpkg -i AdobeAIR.deb
  RHEL/CentOS系统：sudo rpm -i AdobeAIR.rpm
  如果遇到依赖缺失，补装libgtk2.0-0 libnss3这两个包即可解决。

1.2 验证运行时

安装完成后，打开终端或命令提示符，输入adt -version。如果看到类似AIR 3.9.0.1200的版本号返回，说明运行时已就位。

如果系统提示“命令未找到”，那多半是SDK路径还没配好——这正是下一步要处理的问题。

第二步：下载并配置AIR SDK

2.1 下载SDK

从Adobe的存档页面下载最新稳定版（如AIR SDK 3.9）。解压到一个固定的本地路径，例如：

• Windows：C:sdkairsdk
• macOS/Linux：~/dev/airsdk

这个路径后续会反复用到。

2.2 配置方式（推荐第一种）

方式一：设置环境变量（适合长期开发）

• Windows：右键“此电脑” → “属性” → “高级系统设置” → “环境变量”。在系统变量里新建AIR_SDK_HOME，值设为SDK解压路径。然后编辑Path变量，追加%AIR_SDK_HOME%bin。
• macOS/Linux：在~/.zshrc或~/.bash_profile末尾添加两行：export AIR_SDK_HOME="/path/to/airsdk" 和 export PATH="$AIR_SDK_HOME/bin:$PATH"。保存后执行source ~/.zshrc使配置生效。

方式二：临时路径（适合单次调试）

不设环境变量，直接在运行命令时手动指定SDK路径。但这种方式容易出错——路径一旦写错，adt会静默失败，且不报具体原因，排查起来相当头疼。所以，如果不是临时尝鲜，建议用第一种方式。

第三步：验证开发环境是否可用

3.1 创建测试项目

环境配置好后，跑一个简单项目验证才算踏实。

先创建一个测试目录，比如HelloAIR。在里面新建两个文件：HelloAIR-app.xml和HelloAIR.html。

3.2 编写描述符文件

用文本编辑器打开HelloAIR-app.xml，确保根元素包含正确的命名空间。例如：。

注意：命名空间的版本号必须与你安装的AIR SDK主版本一致，否则adl会直接拒绝加载。

3.3 运行测试

在终端进入HelloAIR目录，执行adl HelloAIR-app.xml。

• 成功：看到一个窗口弹出并显示HTML内容，说明整个环境链（运行时、SDK、描述符、路径）全部打通。
• 报错“Runtime not found”：运行时没装对或版本不匹配。
• 报错“Invalid application descriptor”：大概率XML命名空间写错了，或者格式有误。

对症下药，逐一排查即可。

《夸克》非常好用的免费AI浏览器

下载APP查看