当前可获取的版本
核对日期：2026-10-09。
| 产物 | 获取方式 | 范围 |
|---|---|---|
| FIA npm 0.18.0 | npm | 新增原生标题栏置顶；包含默认浏览器界面、隔离预览、应用子命令和 DMG 分发 |
| 麻辣烫固定 FIA 0.18.0 | 框架归档 | 源码 85206f6f5322，与公开 npm 0.18.0 和 Actions artifact 逐字节一致 |
| 麻辣烫应用 | 下载与安装说明 | 0.4.0 / Build 4 正式 DMG，macOS 14+ / Apple Silicon |
框架归档 .tgz 是开发依赖，不是双击安装的应用。FIA 4 的“4”也不是 npm 版本号。
本机构建
bun run check
bun run buildfia build 生成本机 .app，包含固定的原生宿主、Bun、CLI 与业务资源。普通使用者不需要另装运行时。本机构建不等于已通过 Developer ID 签名和公证的公开发行包。
公开应用分发
FIA 0.17.0 的 fia build --dmg 创建本机测试镜像；fia release 对应用和 DMG 签名、公证，并检查镜像内应用，输出 DMG、SHA-256 与报告。配置 signing.releaseIdentity 与 signing.notarizationProfile 后执行项目中的 bun run release。签名身份为 Developer ID Application；证书、公证凭据由发布者准备，不进入仓库。
历史 npm 0.16.1 的 fia release 输出 ZIP；当前 0.18.0 教程保留上述 DMG 行为。已有应用升级至新原生宿主须通过完整安装包交付。
签名代码更新
FIA 支持前后端代码一起更新。先生成 Ed25519 密钥，把公钥和更新源放入应用配置，私钥由发布环境保管。
bunx fia update keygen --output /secure/path/my-app-keys
FIA_UPDATE_PRIVATE_KEY_FILE=/secure/path/my-app-keys/update-private.pem bunx fia release --update每次提高 app.version 和 app.build。将 dist/updates/releases/<build>/ 上传到对应 HTTPS 地址，最后发布 latest.json。CLI 生成产物，不自动上传。
更新边界
- 下载后由用户确认生效；活动调用、脚本或
beforeUpdate报忙会推迟切换。 - 启动或观察失败回退代码；用户数据不会一起回退，数据迁移需兼容旧代码。
- 原生宿主、Bun、系统权限或其他运行时配置变化，需要完整安装包。
- 应用业务依赖需能打包为 JS/TS、静态资源或 WASM；不能把额外原生可执行文件当成普通代码热更新。
安装入门从 快速开始 继续；生产行为以所用包内框架契约为准。