Files
AndroidDeviceStreaming/flutter_manager/README.md
T

3.5 KiB
Raw Blame History

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 自动化工具初始化失败,托盘点击行为仍需人工验收。