产线端 · ART

部署到产线

交付给工位的东西只有两样：项目文件，和能读它的 ART。下面是把它们放到一起的几种方式。

先打包

ath package build --output ./dist/station     # 自包含部署目录：art 可执行文件 + 项目文件
ath package verify ./dist/station            # 校验部署目录里的文件
ath publish --output ./my-product.art        # 打成单个 .art 发布包

交付物	内容	适合
部署目录	art 可执行文件与项目文件放在一起，校验过哈希。	固定工位、目录式安装。
`.art` 发布包	把 ART 运行所需的项目文件打成一个包。	整包复制、版本留档、临时工位。
项目目录	原始项目文件，可直接用 ATH 打开继续改。	工程人员在调试机上使用。

工位怎么找到项目

ART 按下面的顺序找项目，任选一种即可：

在 ART 里配置一次项目目录，之后由本机配置记住（默认方式）。
命令行指定：art run --project-dir ./my-product。
用发布包：art run --bundle ./my-product.art，包会解压到系统临时目录后作为项目目录使用。
随可执行文件放置：把项目文件放在 art 可执行文件所在目录（或 macOS 的 Contents/Resources/project），启动时自动识别。

多工位

每个工位各配置一次，项目内容完全一致；工位之间不共享状态。
同一批产品应当用同一份项目：把项目目录或发布包统一分发，避免工位之间版本不一致。
页脚的版本号可以直接确认工位上的 ART 版本，见工位配置与启动。

换版与回滚

发布前

ath validate
ath version create --name "产线首版"
ath version validate
ath version release

发现需要回收

ath version retire --version <ID>     # 标记为已退役
ath version restore --version <ID>    # 恢复成新的候选，不修改历史

快照是不可变的：回滚不会改写历史，而是产生一份新的候选，可以再校验、再发布。旧版本退役后仍留在项目里，方便事后比对。

交付前检查

ath validate 通过，且 ath package verify 对部署目录校验通过。
在至少一台上机真机跑过一遍，并确认 PASS 与 FAIL 两种结果都出现过。
工位机上的 ART 版本与项目记录一致；换版时先退出旧界面再替换文件。
把这一版的项目目录、快照与交付物一起归档，出问题时有据可查。