docs: add Linux desktop launcher and runtime deployment notes
This commit is contained in:
1 parent
de6ecae54f
commit
316292bdfb
3 files changed
+10
-1
No files matched your search
@@ -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。私有配置不放入包中,卸载不删除用户数据。
|
输出 `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 已可用。
|
Flutter 当前仓库没有 Linux 原生宿主,不能直接从 Windows bundle 生成 Linux 应用。打包入口 `ADS_FLUTTER_BUNDLE=/path/to/linux/bundle bash scripts/build-linux-packages.sh flutter` 仅用于后续完成 Linux 宿主与工具路径适配后的原生产物,当前不宣称 Flutter Linux 已可用。
|
||||||
|
|
||||||
|
|||||||
@@ -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 索引,没有改写该源。
|
已验证原生 `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 配置示例;安装前按实际账号和路径修改,并拒绝覆盖不属于本项目的同名服务。
|
重挂载测试也已通过:核对来源后仅 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 挂载验收。
|
||||||
@@ -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" "$@"
|
||||||
Reference in new issue
Block a user