ADS Flutter 管理中心(Windows)
独立 Flutter 工程,复用现有控制中心 API 与 ads-client 子进程,不修改原有 Avalonia、Rust 或 Go 实现。
运行
需要 Flutter 3.50 / Dart 3.14 与 Visual Studio C++ 桌面开发工具。
在本目录执行:
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 角色。现有 API 不包含用户增删、角色编辑或远端服务重启,因此本版提供设备/节点状态管理与本地连接操作,不提供这些服务端写操作。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 等,无业务源码 |
检查
flutter analyze
flutter test
托盘使用 tray_manager,窗口生命周期使用 window_manager,版本通过 pubspec.lock 固定。
本目录提供启动脚本(PowerShell):首次执行 .\start-windows.ps1 -Build,后续执行 .\start-windows.ps1。
可选真实服务验证(仅连接空闲设备,不接管占用设备):
dart run test/live_smoke.dart
dart run test/live_smoke.dart --connect --screen
2026-11-12:已验证真实设备/节点 API、本机 ADB 列表;真实远端设备当时被占用,因此跳过远端连接与投屏验收。原生 UI 自动化工具初始化失败,托盘点击行为仍需人工验收。