先说几个核心判断：想把HTML、CSS和JavaScript打包成能在Windows、macOS甚至Android上直接运行的桌面应用，Adobe AIR确实是目前最直接的一条路。它不需要浏览器托底，安装完成后就是原生应用图标。读写本地文件、调用系统通知、离线运行——这些能力都是原生集成，不用额外折腾。

准备开发环境

先确认操作系统：Windows 10/11、macOS 12+ 或者 Ubuntu 20.04 LTS 都可以。

从官网下载 Adobe AIR SDK，解压后放到一个固定路径。Windows 下建议放在 C:air，macOS/Linux 下可以是 /usr/local/air。关键点：路径中不能有中文或空格，否则后续所有命令都会卡在这一步。

打开终端或命令提示符，敲一行：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 时，确保 里面的内容是这样的：HelloWorld.html。路径必须与实际文件名完全一致，大小写敏感，末尾不能有多余空格——这地方踩过坑的人都知道，一个空格就能让你琢磨半天。

从 AIR SDK 的 frameworks/AIRAliases.js 复制一份到项目根目录。这一步不能跳过，否则后面在JavaScript里调用 runtime.air.File 之类的 API 时，会直接报未定义错误。

运行与调试

调试有两种方式：

• 方法一：用 ADL 启动调试
  在项目根目录下执行 adl HelloWorld-app.xml，窗口弹出就算是成功了。这时候如果修改 HelloWorld.html 的内容并保存，ADL 会自动刷新页面——不过这个自动刷新只对 HTML/CSS/JS 的修改有效；如果你改了 app.xml，那就得手动重启 ADL 才能生效。
• 方法二：用 VS Code 配合 AS3-MXML 插件
  安装插件后，在项目根目录右键选择“Run AIR Application”，它会自动调用 ADL 并捕获控制台输出。如果看到 trace("App launched") 日志，但界面就是不显示，去检查一下 是不是设为 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 文件，如果系统弹出安装向导，就说明打包成功，可以交付了。

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

下载APP查看