Files
AndroidDeviceStreaming/desktop/README.md
T

38 lines
2.5 KiB
Markdown
Raw 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.
# ADS 桌面客户端
C# / .NET 8 + Avalonia 11 + CommunityToolkit.Mvvm,Windows、Linux、macOS 共用代码。本次在 Windows 构建与启动验证。
## 启动
在 `desktop` 目录运行:
```powershell
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 已开启且本机密钥获得手机授权。
## 发布
```powershell
dotnet publish Ads.Desktop -c Release -r win-x64 --self-contained true -o ../bin/desktop-win-x64
```
将对应平台的 ads-client 放到 PATH,或在设置指定绝对路径,同时安装 ADB 与 scrcpy。