Adobe AIR是快速打包跨平台桌面应用的最短路径,支持Windows、macOS和Android,无需浏览器依赖,可读写本地文件、调用系统通知并离线运行。

想用HTML、CSS和JavaScript快速打包一个能在Windows、macOS甚至Android上直接运行的桌面应用,Adobe AIR就是那条最短路径——它不依赖浏览器,安装后即为原生应用图标,还能读写本地文件、调用系统通知、离线运行。
准备开发环境
先确认操作系统已满足最低要求:Windows 10/11、macOS 12+ 或 Ubuntu 20.04 LTS。
下载并解压 Adobe 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;Windows 用户需手动设置 AIR_HOME 系统变量指向 SDK 根目录。
创建第一个HTML版HelloWorld项目
新建一个名为 HelloWorld 的空文件夹,作为项目根目录。
在该目录下必须创建两个文件:HelloWorld-app.xml(应用描述符)和 HelloWorld.html(主页面)。缺一不可,否则 ADL 启动时直接报错退出。
编辑 HelloWorld-app.xml,确保 <initialWindow> 内包含且仅包含:<content>HelloWorld.html</content>——路径必须与实际文件名完全一致,大小写敏感,末尾不能有多余空格。
从 AIR SDK 的 frameworks/AIRAliases.js 复制到项目根目录。这一步不能跳过,否则 JavaScript 中调用 runtime.air.File 等 API 会报未定义错误。
运行与调试
方法一:使用 ADL 启动调试
在项目根目录下执行:adl HelloWorld-app.xml。窗口弹出即表示成功。
通过跨平台桥接执行 ExtendScript (ES3) 脚本,自动化 Photoshop、Illustrator、InDesign、Premiere Pro 和 After Effects。
此时修改 HelloWorld.html 内容并保存,ADL 会自动刷新页面——但仅限 HTML/CSS/JS 变更;若修改了 app.xml,必须手动重启 ADL 才生效。
方法二:用 VS Code 配合 AS3-MXML 插件
安装插件后,在项目根目录右键选择“Run AIR Application”,它会自动调用 ADL 并捕获控制台输出。
若看到 trace("App launched") 日志但界面无响应,请检查 <visible> 是否设为 true,默认值是 false。
打包成可安装的 .air 文件
第一步:生成自签名证书
执行命令:adt -certificate -validityPeriod 3650 -storetype pkcs12 -keystore mycert.pfx 2048-RSA "CN=MyApp, O=MyOrg, C=CN" mypassword
第二步:用 ADT 打包
执行命令:adt -package -storetype pkcs12 -keystore mycert.pfx -storepass mypassword HelloWorld.air HelloWorld-app.xml HelloWorld.html AIRAliases.js
注意:macOS 上未签名的 .air 包默认被系统拦截,双击无反应;必须用上述命令完成数字签名才可安装。
第三步:验证打包结果
双击生成的 HelloWorld.air 文件,系统弹出安装向导即表示成功。

















