Files
AndroidDeviceStreaming/docs/linux-packaging.md
T

1.9 KiB

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、便携 .tar.gz 与 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 模拟尚未支持。

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。