必须先安装adobe air运行时并配置air sdk环境变量，否则adt/adl命令无法运行；需按系统正确安装运行时，设置air_sdk_home和path，验证adt -version及adl启动成功。
想用Adobe AIR开发桌面或移动应用，必须先配置好运行环境和开发工具链，否则连最基础的Hello World都跑不起来；缺少AIR SDK、未设置环境变量、或混淆了调试运行时与生产运行时，都会导致adt命令报错或adl无法启动。
安装并验证Adobe AIR运行时
打开浏览器，访问Adobe官方唯一可信下载地址：https://www.php.cn/link/f9a276b5a11d88646650ab067bea8bc5 → 页面自动识别系统后点击【Download Now】→ Windows用户双击AdobeAIRInstaller.exe，勾选“我接受许可协议”，全程保持默认路径安装。
macOS用户需双击AdobeAIR.dmg → 将Adobe AIR图标拖入“应用程序”文件夹 → 右键该应用→“显示简介”→勾选“仍要打开”（绕过Gatekeeper）→启动安装向导完成安装。这一步若跳过“仍要打开”，系统会直接阻止安装进程，【无法通过后续任何命令修复】。
Linux用户执行：sudo dpkg -i AdobeAIR.deb（Debian/Ubuntu）或sudo rpm -i AdobeAIR.rpm（RHEL/CentOS），依赖缺失时补装libgtk2.0-0 libnss3即可。
安装完成后，在终端或命令提示符中输入adt -version，若返回类似AIR 3.9.0.1200的版本号，说明运行时已就位；若提示“命令未找到”，说明尚未配置SDK路径——这是下一步要解决的问题。
下载并配置AIR SDK
从Adobe官方存档页下载AIR SDK（推荐使用2026年最新稳定版，如AIR SDK 3.9），解压到本地固定路径，例如C:\sdk\airsdk（Windows）或~/dev/airsdk（macOS/Linux）。
方法一：环境变量方式（推荐长期开发使用）
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 -package -target apk-android -platformsdk /path/to/android/sdk ...。这种方式容易漏填、拼错路径，【一旦路径错误，adt会静默失败且不报具体原因】。
验证开发环境是否可用
第一步：创建测试项目目录，例如HelloAIR，并在其中新建两个必需文件：HelloAIR-app.xml和HelloAIR.html。
第二步：用文本编辑器打开HelloAIR-app.xml，确保根元素包含正确命名空间，例如：<application xmlns="http://ns.adobe.com/air/application/3.9"></application>。命名空间版本必须与你安装的AIR SDK主版本一致，否则adl将拒绝加载。
第三步：在终端进入HelloAIR目录，执行：adl HelloAIR-app.xml。如果窗口成功弹出并显示HTML内容，说明整个环境链（运行时+SDK+描述符+路径）全部打通；若报错Runtime not found，说明运行时未安装或版本不匹配；若报错Invalid application descriptor，大概率是XML命名空间写错或格式有误。
