Register shared Linux CLI links with deb lifecycle management for 0.2.4

This commit is contained in:
tongtong committed 2026-11-13 17:09:53 +08:00
1 parent dc8edf0df6
commit 3c6c4a0e90
11 files changed
+242 -19

No files matched your search

+18
View File
@@ -18,3 +18,21 @@ Flutter 当前仓库没有 Linux 原生宿主,不能直接从 Windows bundle
本次已生成并检查 amd64 三类包的元数据与归档,Agent 包解压后的 adsctl 可执行;Avalonia 使用 Windows .NET SDK 发布原生 linux-x64 产物。Linux 桌面图形会话启动、实际 apt 安装/卸载与 arm64 尚未实机验证。校验文件需在输出目录执行 `sha256sum -c SHA256SUMS`。
新发布自动递增补丁版本。跨平台同次发布或失败重试使用 `ADS_REUSE_VERSION=1`,并确保外部产物已按当前版本重建。Linux 只生成 deb 安装包与校验文件。
## 安装后的命令入口
从 0.2.4 起,桌面 deb 安装时自动注册 `/usr/bin/adsctl`、`ads-agent`、`ads-client`、`ads-usb`。命令通过 `/etc/alternatives` 链接到当前提供包的 `/opt/ttstd/ads-*/`,不需要改 PATH。无界面 Agent 包注册它提供的 `adsctl` 和 `ads-agent`。
```sh
sudo apt install ./ads-avalonia_0.2.4_amd64.deb
adsctl --help
ads-agent --help
ads-client --help
ads-usb --help
```
多个包可以共存:默认优先级为独立 Agent 80、Avalonia 60、Flutter 50;手动选择可用 `sudo update-alternatives --config adsctl`,重新安装保留手动选择。卸载只撤销该包提供的链接,自动回退其他仍安装的提供者;最后一个提供者移除后清理链接。既有同名普通文件不强制覆盖。
`deploy/deb-cli-links.sh`(Shell)生成 deb 的 postinst/prerm/postrm 脚本;文件触发器处理旧版 Agent 直接拥有 `/usr/bin/adsctl`、`ads-agent` 时的升级与卸载。不会自动初始化、启动或重启 Agent,不删除用户配置或凭据。
维护脚本回归:Linux 中以 root 执行 `python3 tests/deb_cli_test.py`。测试在临时 dpkg 根目录安装、升级、移除测试包,守卫拒绝没有 `--root` 的 alternatives 调用,不改宿主 `/usr/bin`。设置 `ADS_DEB_PACKAGE_DIR` 为正式包目录,可额外验证实际 deb 及 CLI 版本(仅隔离测试允许忽略运行库依赖;正常安装请使用 apt)。