Files

47 lines
4.7 KiB
Markdown
Raw Permalink 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 尚未接入 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`。
```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)。
## 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 要求。