Files
AndroidDeviceStreaming/desktop

ADS 桌面客户端

C# / .NET 8 + Avalonia 11 + CommunityToolkit.Mvvm,Windows、Linux、macOS 共用代码。本次在 Windows 构建与启动验证。

启动

在 desktop 目录运行:

dotnet run --project Ads.Desktop -c Release

或运行 desktop/Ads.Desktop/bin/Release/net8.0/Ads.Desktop.exe。

  1. 在“连接配置”填写中继 WSS 根地址和 客户端令牌(不是 agent 令牌)。默认 wss://ads.ttstd.com;服务器域名与 TLS 必须已部署完成。
  2. 设置 ads-client、ADB、scrcpy 的可执行文件路径。开发目录自动查找根目录 bin/ads-client.exe;ADB 和 scrcpy 默认使用 PATH。仓库 adb/、scrcpy/ 是源码目录,不能作为可执行文件使用。
  3. 刷新设备,选择空闲设备并连接。状态每 3 秒从本机 ADB 检查;未取得租约时显示等待状态,详细错误见日志。
  4. 手机允许调试后,点击“打开手机控制”。scrcpy 使用独立窗口,支持鼠标、键盘操作;可设置分辨率、帧率、音频与只读模式。强制 --force-adb-forward,避免反向连接无法穿过中继。
  5. 关闭窗口默认进入托盘,右键托盘可重新打开或退出。取消托盘选项后关闭窗口会退出。退出会停止本应用启动的 scrcpy、ads-client,并只断开所用 ADB 端点。

请从 scrcpy 官方发行包安装程序及配套 server、DLL 等文件,不要只复制 scrcpy.exe。首次调试必须在手机端授权。

边界

UI 使用 /v1/devices 的 Bearer 认证接口并管理现有 Rust ads-client 子进程,不承担 ADB 数据转发,也未新增本机 HTTP 管理 API。一次管理一个远程连接;断线重连由 ads-client 负责。完全退出 UI 后不保留后台守护进程。连接配置修改在下次连接生效。

令牌仅保存在内存,通过 ADS_CLIENT_TOKEN 子进程环境变量传递,可在启动 UI 前设置该环境变量。配置保存在系统 LocalApplicationData 下 TTSTD/ADS/settings.json,不包含令牌。日志最多保留 1000 条,可导出到同目录;不自动落盘。

托盘需要桌面环境支持;Linux 桌面可能需要 AppIndicator。未在 Linux/macOS 或真实手机上验收此 UI。真实投屏仍需远程 agent 在线、手机 TCP ADB 已开启且本机密钥获得手机授权。

发布

dotnet publish Ads.Desktop -c Release -r win-x64 --self-contained true -o ../bin/desktop-win-x64

将对应平台的 ads-client 放到 PATH,或在设置指定绝对路径,同时安装 ADB 与 scrcpy。