71 lines
4.4 KiB
Markdown
71 lines
4.4 KiB
Markdown
# ADS Flutter 管理中心(Windows)
|
||
|
||
独立 Flutter 工程,复用现有控制中心 API 与 ads-client 子进程,不修改原有 Avalonia、Rust 或 Go 实现。
|
||
|
||
## 运行
|
||
|
||
需要 Flutter 3.50 / Dart 3.14 与 Visual Studio C++ 桌面开发工具。
|
||
|
||
在本目录执行:
|
||
|
||
```powershell
|
||
flutter pub get
|
||
flutter run -d windows
|
||
# 或构建发布版
|
||
flutter build windows --release
|
||
.\build\windows\x64\runner\Release\ads_manager.exe
|
||
```
|
||
|
||
## 功能与使用
|
||
|
||
- 设备工作台:显示网关在线设备和租约占用,搜索设备,同时连接多台设备,自动分配回环端口,断开与复制地址。
|
||
- 中继节点:显示控制中心 /v2/nodes 的健康与通道使用情况;旧服务器无该接口时为空。
|
||
- 本机 ADB:启动本地 ADB Server、读取 devices -l,包括本机 USB 及网络设备。
|
||
- 投屏:ADB 就绪后以独立 scrcpy 窗口运行,使用 --force-adb-forward。当前默认最大边长 1920、60 FPS、关闭音频。
|
||
- 托盘:关闭主窗口后保留连接,托盘打开窗口、断开全部、退出。完全退出会停止本应用启动的进程并断开所属 ADB 地址。
|
||
- 配置:保存非敏感设置、导入 client.env、检查三个可执行程序;凭据不写入设置,子进程通过环境变量接收令牌。
|
||
- 自动每 12 秒同步控制中心,每 3 秒检查 ADB 状态,连接重试由 ads-client 负责。
|
||
|
||
开发环境自动向上查找仓库,使用 bin/ads-client.exe、bin/tools/scrcpy/ 中的工具与 config/private/client.env。发行时请在应用旁放置 ads-client.exe、tools/scrcpy/ 完整发行目录,或在配置页填写绝对路径,并导入自己的凭据文件。配置在 %LOCALAPPDATA%/TTSTD/ADS-Flutter/settings.json,与原客户端分开。
|
||
|
||
服务地址支持 /ads 路径前缀和可选直连源站地址,HTTPS 仍按原域名校验证书。令牌仅使用 client 角色。Agent 管理使用独立 admin.env 管理角色,支持多 Agent/多手机、配置、日志及受监督重启;本机使用 adsctl 私有 IPC。用户账号和角色编辑不在此版本范围。USB 模拟未在本工程接入。
|
||
|
||
## 目录
|
||
|
||
| 目录 | 用途 | 语言/格式 |
|
||
| --- | --- | --- |
|
||
| lib/ | 应用入口及分层业务源码 | Dart |
|
||
| lib/data/ | 配置、HTTP API、工具发现、ADB 与子进程生命周期 | Dart |
|
||
| lib/ui/ | ChangeNotifier 状态与管理界面 | Dart |
|
||
| assets/ | 托盘图标资源 | ICO,无业务源码 |
|
||
| windows/ | Flutter Windows 原生宿主与插件注册 | C++、CMake、资源文件;部分自动生成 |
|
||
| test/ | 凭据、URL 与不同窗口宽度的界面验证 | Dart |
|
||
| build/ | Flutter 生成的 Windows 发行与缓存(忽略) | 构建产物,无业务源码 |
|
||
| .dart_tool/ | Dart/Flutter 生成缓存(忽略) | JSON 等,无业务源码 |
|
||
|
||
## 检查
|
||
|
||
```powershell
|
||
flutter analyze
|
||
flutter test
|
||
```
|
||
|
||
托盘使用 [tray_manager](https://pub.dev/packages/tray_manager/versions/0.5.1),窗口生命周期使用 [window_manager](https://pub.dev/packages/window_manager/versions/0.5.1),版本通过 pubspec.lock 固定。
|
||
|
||
本目录提供启动脚本(PowerShell):首次执行 .\start-windows.ps1 -Build,后续执行 .\start-windows.ps1。
|
||
|
||
可选真实服务验证(仅连接空闲设备,不接管占用设备):
|
||
|
||
```powershell
|
||
dart run test/live_smoke.dart
|
||
dart run test/live_smoke.dart --connect --screen
|
||
```
|
||
|
||
2026-11-12:已验证真实设备/节点 API、本机 ADB 列表;真实远端设备当时被占用,因此跳过远端连接与投屏验收。原生 UI 自动化工具初始化失败,托盘点击行为仍需人工验收。
|
||
|
||
## Agent 管理
|
||
|
||
导航“Agent 管理”可选择多台被控电脑,添加/移除/启停手机,修改配置、跟随日志和重启。也可管理本机 Agent,初始化并安装无界面开机任务。发行包旁放置 adsctl.exe 和 ads-agent.exe;两者与 Avalonia 共用同一配置和后台,不应重复启动。详见 [Agent 管理](../docs/agent-management.md)。
|
||
|
||
`lib/data/agent_models.dart` 使用 Freezed 生成不可变快照(生成文件一并提交);`agent_service.dart` 封装 HTTP/本机 CLI,`agent_repository.dart` 解析数据,`lib/ui/agent_model.dart` 持有页面状态。模型变化后运行 `dart run build_runner build`。`test/agent_test.dart` 验证选择范围、日志脱敏、响应竞争和布局;`agent_live_smoke.dart` 仅面向显式提供的隔离测试 Agent。
|