From 316292bdfb5c27c68ed203fc1aecd3b6145d5140 Mon Sep 17 00:00:00 2001 From: tongtongstudio Date: Fri, 13 Nov 2026 10:11:07 +0800 Subject: [PATCH] docs: add Linux desktop launcher and runtime deployment notes --- docs/linux-packaging.md | 2 +- docs/linux-usb.md | 2 ++ scripts/start-desktop-linux.sh | 7 +++++++ 3 files changed, 10 insertions(+), 1 deletion(-) create mode 100644 scripts/start-desktop-linux.sh diff --git a/docs/linux-packaging.md b/docs/linux-packaging.md index 88d9f85..dafdb2e 100644 --- a/docs/linux-packaging.md +++ b/docs/linux-packaging.md @@ -11,7 +11,7 @@ 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 已有原生 CLI 实机验证,需另部署 ads-usb 和系统 usbip/vhci_hcd,见 linux-usb.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 已可用。 diff --git a/docs/linux-usb.md b/docs/linux-usb.md index 1bc7abf..92d6df8 100644 --- a/docs/linux-usb.md +++ b/docs/linux-usb.md @@ -47,3 +47,5 @@ sudo systemctl start ads-linux-usb-monitor 已验证原生 `usb:3-1` 枚举、普通 TT 的 adb -d、远程 shell、8 MiB push 的 SHA-256 完整性。目标机原有三个模拟器保持运行。Avalonia 桌面已接入 Linux USB 开关,通过 pkexec 请求系统挂载授权;Flutter Linux 宿主仍未接入。CLI/systemd 路径仍可使用;MTP、fastboot 和整机 USB 透传不在范围内。目标机既有第三方 APT 源存在 404,部署使用已更新的 Ubuntu 索引,没有改写该源。 重挂载测试也已通过:核对来源后仅 detach 本次虚拟端口,监控自动重新导入,adb 重新恢复 device。仓库 deploy/ 下附 export、upstream 和 monitor 三份 systemd 配置示例;安装前按实际账号和路径修改,并拒绝覆盖不属于本项目的同名服务。 + +2026-11-13 桌面接入更新:.224 已部署自包含 Avalonia 至指定工程,官方 scrcpy 5.0.1 归档校验后安装于发行目录 tools/scrcpy。固定 USB 验证服务已停用,避免与桌面按需创建的同序列号设备冲突;通过桌面连接时再申请 pkexec 授权。当前 .NET runtime 不缺,源码构建缺少 global.json 指定的 8.0.428 SDK。GUI 进程启动已验证,尚未通过桌面授权对话框完成整条 USB 挂载验收。 diff --git a/scripts/start-desktop-linux.sh b/scripts/start-desktop-linux.sh new file mode 100644 index 0000000..e0847f3 --- /dev/null +++ b/scripts/start-desktop-linux.sh @@ -0,0 +1,7 @@ +#!/usr/bin/env bash +set -euo pipefail +root=$(cd -- "$(dirname -- "$0")/.." && pwd) +app="$root/bin/desktop-linux-x64/Ads.Desktop" +[[ -x "$app" ]] || { echo 'Build or deploy bin/desktop-linux-x64 first' >&2; exit 1; } +cd "$root" +exec "$app" "$@"