adobe air 是一个跨平台运行时，支持用 html/js/css 或 actionscript 开发桌面及移动应用，可离线运行、访问本地文件和系统通知；需配置 air sdk、编写 app.xml 和 html 文件，用 adl 调试、adt 打包并签名后生成可安装的 .air 文件。
想用Web技术（HTML/JS/CSS或ActionScript）快速打包一个能在Windows、macOS甚至Android上直接运行的桌面应用，Adobe AIR就是那条最短路径——它不依赖浏览器，安装后即为原生应用图标，还能读写本地文件、调用系统通知、离线运行。
准备开发环境
先确认操作系统已满足最低要求：Windows 10/11、macOS 12+ 或 Ubuntu 20.04 LTS。AIR SDK 是核心工具链，必须下载并解压到固定路径，比如 【C:\air】（Windows）或 【/usr/local/air】（macOS/Linux）。
打开终端或命令提示符，执行以下命令验证是否配置成功：
adl --version
若返回类似“Adobe AIR Debug Launcher 50.2”字样，说明SDK已就绪。若报“command not found”，请检查环境变量中是否已添加 $AIR_HOME/bin 到 PATH。
创建第一个HTML版HelloWorld项目
新建一个名为 HelloWorld 的空文件夹，这是你的项目根目录。
在该目录下创建两个必需文件：HelloWorld-app.xml（描述符）和 HelloWorld.html（主页面）。缺一不可，否则ADL无法启动。
编辑 HelloWorld-app.xml，确保根元素带正确命名空间：
在 <initialwindow></initialwindow> 内必须指定 <content>HelloWorld.html</content>，且路径要与实际文件名完全一致——大小写敏感，多一个空格都会导致白屏。
将AIR SDK中 frameworks/AIRAliases.js 复制进项目目录。这一步不能跳过，否则JavaScript里调用 runtime.air.File 等API会报未定义错误。
运行与调试
方法一：使用ADL启动调试
在项目根目录下执行：
adl HelloWorld-app.xml
窗口弹出即表示成功。此时修改 HelloWorld.html 中的内容，保存后刷新页面即可实时查看效果——ADL支持热重载，但不支持自动监听XML变更。
方法二：用VS Code配合AS3-MXML扩展
安装插件后，在项目根目录右键选择“Run AIR Application”，它会自动调用ADL并捕获控制台输出。若看到 trace("App launched") 日志但界面无响应，请检查 <visible></visible> 是否设为 true。
注意：ADL仅用于开发调试，生成正式安装包必须用ADT，且需数字签名——未签名的.air包在macOS上默认被系统拦截，双击无反应。
打包成可安装的.air文件
第一步：生成自签名证书
执行命令：
adt -certificate -cn SelfSigned -ou Dev -o "MyOrg" -c CN adt -storetype PKCS12 -keystore self.p12 2048-RSA password123
第二步：用ADT打包
adt -package -storetype PKCS12 -keystore self.p12 -storepass password123 HelloWorld.air HelloWorld-app.xml HelloWorld.html AIRAliases.js
第三步：验证签名完整性
adt -inspect HelloWorld.air
输出中必须包含“Signature verified: true”，否则安装时会被系统拒绝。
生成的 HelloWorld.air 文件可双击安装，Windows用户会看到标准安装向导，macOS用户需右键→“打开”绕过Gatekeeper警告。
