Files

4.7 KiB
Raw Permalink Blame History

Linux 打包

在 Linux 主机执行 bash scripts/build-linux-packages.sh,默认打包 Avalonia、Agent、控制中心/中继。支持本机 x86_64 和 aarch64,不做跨架构伪装。需要 bash、python3、dpkg-deb、tar、.NET 8 SDK;先构建 Rust 和 Go 后端。

bash scripts/build.sh
bash scripts/build-linux-packages.sh
# 只打包无界面 Agent
bash scripts/build-linux-packages.sh agent

输出 bin/installers/linux/ 中的 .deb 与 SHA256SUMS。Deb 安装路径 /opt/ttstd/ads-*,桌面端添加应用菜单,命令入口 /usr/bin/ads-*。通过 sudo apt install ./包名.deb 安装并解析依赖,同名包覆盖升级,通过 sudo apt remove ads-avalonia 等卸载。不会自动注册或启动 Agent 服务;用 adsctl 初始化并显式安装 systemd 服务,详见 agent-management.md。私有配置不放入包中,卸载不删除用户数据。

可用 ADS_LINUX_BIN 指定 ads-agent/ads-client/adsctl 所在目录,ADS_SERVER_BIN 指定服务端产物目录,ADS_AVALONIA_BUNDLE 指定已构建的原生 Avalonia 目录并跳过 publish。包会检查 ELF 格式及机器架构,拒绝 Windows EXE 和私有配置。Linux 虚拟 USB 已有原生 CLI 实机验证,需另部署 ads-usb 和系统 usbip/vhci_hcd,见 linux-usb.md;Avalonia 桌面开关已接入,Flutter Linux 尚未接入 USB 界面,网络 ADB 和独立投屏已支持。

Flutter 已加入 Linux GTK 原生宿主。bash scripts/build-linux-packages.sh flutter 可原生构建并生成 deb;ADS_FLUTTER_BUNDLE=/path/to/linux/bundle 可使用预先构建的同版本 Linux bundle。设置 ADS_SCRCPY_BUNDLE 可携带已校验的 Linux adb/scrcpy 完整发行目录,程序及插件会检查 ELF 架构,运行库仍由 apt 解析。Linux 使用独立投屏窗口,Windows 内嵌投屏及 USB 驱动界面不在 Linux 提供。详见 flutter_manager/README.md。

本次已生成并检查 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。

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)。

Flutter 0.2.5 amd64

已在 Ubuntu 24.04 原生编译并验证 GTK 窗口和插件启动,Linux/Windows 各 35 项 Flutter 测试通过。ads-flutter_0.2.5_amd64.deb 自带 ADB、scrcpy 5.0.1、Rust 四个 CLI、Flutter 引擎和插件,安装时由 apt 解析 GTK/AppIndicator 等系统运行库,运行不需要 Flutter SDK。通过 sudo apt install ./ads-flutter_0.2.5_amd64.deb 安装,菜单或 ads-flutter 启动。

Linux 配置和日志使用 XDG config/state 目录;关闭窗口时退出并释放本客户端连接。Linux 投屏采用独立 scrcpy 窗口;Windows 专属内嵌和 USB 驱动 UI 不在此版本 Linux 桌面提供。arm64 构建入口保留,但本次仅交付并验证 amd64。

使用正式 Flutter 包进行隔离测试时,测试宿主需满足 deb 声明的最低 glibc 版本;force-depends 仅跳过临时根空 dpkg 数据库中的依赖登记,不能绕过执行时的 ABI 要求。