s_新手程序员

构建与分发

固定运行时、代码产物、签名与验收。

更新于 · 4 分钟阅读

fia build 生成应用,build --dmg 生成并验收本地镜像。fia release 使用 Developer ID 签名、公证并检查 Gatekeeper;正式发布需要明确授权与 Apple 配置。

固定运行时包含 Swift Host、CLI 客户端与 Bun 1.4.4;代码产物包含后台、页面和资源。用户数据写 context.app.dataDirectory。原生能力、权限或内置运行时变化需要完整安装包。

CloudKit 按构建模式指定 entitlements、profile 和容器白名单。模拟器和普通 ad-hoc 包不能代替签名真机验收。框架归档必须完成独立安装、应用构建和运行检查,报告使用摘要记录实际内容。

固定运行时与候选产物

Fn 0.8.2 使用共仓 FIA 的固定公开运行时构建;该接口尚未包含在独立公开 npm 0.18.0 中。fia release --runtime-base <锁文件> --with-update 先验证公开基线安装包的摘要、签名、公证和更新清单,复用原生 Host、Bun、固定 CLI/preload 与资源;只构建一次代码,生成完整 DMG 和内容相同的签名更新包。

版本/build 和普通代码变化不改变兼容身份;权限、原生输入或固定资源变化必须建立新基线,验证失败不能自动回退重编。新安装包重新签名后的完整性摘要与运行时兼容身份分别校验。

应用发布方应对这份候选执行实际旧版在线更新、重启和失败回退验收,再发布同一份产物。先上传不可变文件并验证,再公开 Release,最后切换更新清单。新包启动和完整 DMG 替换验证不能代替在线更新;代码回退不回滚业务数据。

共仓 FIA 的原生更新反馈与活动版本 About 已随 Fn 0.8.3 提供,独立 npm 0.18.0 尚未包含。手动检查立即显示状态,已是最新或失败时给出结果;后台自动检查保持安静。应用内代码更新后的 About 使用活动代码版本,安装包版本信息保持原签名内容。原生界面变更必须先发布完整安装包并登记新固定基线,后续普通代码候选再复用该基线。

Fn 0.8.5/build 21 已通过签名候选、真实旧版完整安装路径及正式公开产物验证,安装入口见 Fn 安装指南。本版状态栏「显示桌面」置顶及菜单分组涉及真实 Swift Host 源码变化,不是纯 TypeScript 更新或重编漂移;须以完整安装包替换 0.8.4 及更早版本,保留现有业务、配置和数据。旧固定运行时不能承载该原生变化,不能用旧基线的代码更新代替完整安装。0.8.5 新固定基线已从正式公开包核对签名、公证、固定文件与权限后登记,原生输入检查及两份独立空缓存、不同目录的代码复用验证通过;后续普通候选恢复 code 策略,并继续执行各自的升级验收。基线登记、代码复用和旧版完整安装分别验证,不能仅凭正式 DMG 已公开推断完成;独立 npm 0.18.0 的公开状态不变。

共仓分发工具在冒烟确认应用与受管进程组退出后卸载私有只读 DMG。若系统暂时报 Resource busy,会有界重试,再仅对该挂载点强制卸载;持续失败仍阻断发布并保留此前可用产物。这属于构建工具修复,不改变用户安装流程或运行时身份,独立 npm 0.18.0 不包含该实现。