Files
AndroidDeviceStreaming/docs/linux-packaging.md
T

39 lines
3.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Linux 打包
在 Linux 主机执行 `bash scripts/build-linux-packages.sh`,默认打包 Avalonia、Agent、控制中心/中继。支持本机 x86_64 和 aarch64,不做跨架构伪装。需要 bash、python3、dpkg-deb、tar、.NET 8 SDK;先构建 Rust 和 Go 后端。
```sh
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`。
```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)。