Register shared Linux CLI links with deb lifecycle management for 0.2.4
This commit is contained in:
1 parent
dc8edf0df6
commit
3c6c4a0e90
11 files changed
+242
-19
No files matched your search
@@ -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)。
|
||||
@@ -84,3 +84,10 @@ Port cleanup follow-up:
|
||||
- 锁定 Semi.Avalonia 11.3.7.3,与当前 Avalonia 11.3.8 兼容。设备、Agent 管理、设置、日志及 Agent 托盘统一使用 Semi 资源;新增 WorkbenchStyles.axaml,替换硬编码深色配色,使用左侧导航和明暗主题开关。
|
||||
- 27 项 Avalonia 测试通过,包含中文及 emoji stdout/stderr、流式日志和中文 JSON 输入。离屏渲染四个页面的浅色/深色和 980×700 最小窗口共 10 张 PNG 并检查截图;实际 Windows 发布包 PACKAGE_CHECK_OK,PE 运行库检查通过。
|
||||
- Windows 安装器为 0.2.3;Linux 发布同版本 Avalonia/Agent deb。历史乱码日志不改写;安装新版本并重启后,新日志按 UTF-8 正常显示。尚未在本轮执行干净虚拟机完整安装/卸载和 Linux GUI 实机回归。
|
||||
|
||||
### 0.2.4:Linux deb 公共 CLI 入口
|
||||
|
||||
- Avalonia 桌面包通过 postinst 注册 `/usr/bin/adsctl`、`ads-agent`、`ads-client`、`ads-usb`,由 update-alternatives 链接至 `/opt/ttstd/ads-avalonia/`;Agent 包为其自带的两个 CLI 注册独立提供者。无直接重复拥有的公共命令文件。
|
||||
- 优先级为 Agent 80、Avalonia 60、Flutter 50;保留手动 alternatives 选择及既有同名普通文件。prerm/postrm 撤销当前包,剩余包自动回退,最后一个提供者移除后清理公共及 alternatives 链接。
|
||||
- 文件触发器处理 0.2.3 旧 Agent 包直接拥有两个 /usr/bin 命令的过渡:升级或移除旧包后,剩余桌面提供者重新注册。不会自动启动/重启 Agent 或删除用户配置。
|
||||
- 6 项隔离 dpkg 生命周期测试通过,覆盖共存、重装、手动选择、桌面切换、旧 Agent 升级/移除、普通文件保护和正式 0.2.4 deb。真实包安装后四个原生工具的 --version 均为 0.2.4,移除 Agent 后均回退桌面路径。测试使用临时根和 alternatives 守卫,不修改宿主 /usr/bin;GUI 依赖在临时根用 force-depends 跳过,真实系统仍应使用 apt 正常解析依赖。
|
||||
Reference in new issue
Block a user