Files
AndroidDeviceStreaming/docs/linux-packaging.md
T

3.6 KiB
Raw 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 尚未接入。

Flutter 当前仓库没有 Linux 原生宿主,不能直接从 Windows bundle 生成 Linux 应用。打包入口 ADS_FLUTTER_BUNDLE=/path/to/linux/bundle bash scripts/build-linux-packages.sh flutter 仅用于后续完成 Linux 宿主与工具路径适配后的原生产物,当前不宣称 Flutter Linux 已可用。

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