Build native Flutter Linux manager and deb release 0.2.5

This commit is contained in:
tongtong committed 2026-11-13 19:28:09 +08:00
1 parent 3c6c4a0e90
commit 03e729a60b
35 files changed
+757 -69

No files matched your search

+25 -4
View File
@@ -1,4 +1,4 @@
# ADS Flutter 管理中心(Windows)
# ADS Flutter 管理中心(Windows / Linux)
独立 Flutter 工程,复用现有控制中心 API 与 ads-client 子进程,不修改原有 Avalonia、Rust 或 Go 实现。
@@ -22,7 +22,7 @@ flutter build windows --release
- 中继节点:显示控制中心 /v2/nodes 的健康与通道使用情况;旧服务器无该接口时为空。
- 本机 ADB:启动本地 ADB Server、读取 devices -l,包括本机 USB 及网络设备。
- 投屏:Windows 下点击“内嵌投屏”,将官方 scrcpy 窗口嵌入管理端,鼠标键盘直接控制;返回设备页后隐藏画面,点击“查看投屏”恢复。可停止投屏而保留设备连接。使用 --force-adb-forward,最大边长 1920、60 FPS、关闭音频。
- 托盘:关闭主窗口后保留连接,托盘打开窗口、断开全部、退出。完全退出会停止本应用启动的进程并断开所属 ADB 地址。
- 托盘:Windows 关闭主窗口后保留连接;Linux 关闭主窗口时正常退出。托盘可打开窗口、断开全部、退出。完全退出会停止本应用启动的进程并断开所属 ADB 地址。
- 配置:保存非敏感设置、导入 client.env、检查三个可执行程序;凭据不写入设置,子进程通过环境变量接收令牌。
- 自动每 12 秒同步控制中心,每 3 秒检查 ADB 状态,连接重试由 ads-client 负责。
@@ -37,10 +37,13 @@ flutter build windows --release
| lib/ | 应用入口及分层业务源码 | Dart |
| lib/data/ | 配置、HTTP API、工具发现、ADB 与子进程生命周期 | Dart |
| lib/ui/ | ChangeNotifier 状态与管理界面 | Dart |
| assets/ | 托盘图标资源 | ICO,无业务源码 |
| assets/ | 托盘图标资源 | ICO、PNG,无业务源码 |
| windows/ | Flutter Windows 原生宿主、scrcpy 子窗口承载与插件注册 | C++、CMake、资源文件;部分自动生成 |
| linux/ | Flutter Linux GTK 原生宿主及构建入口 | C++、CMake |
| linux/runner/ | GTK 应用、窗口与 Dart 入口参数传递 | C++、CMake |
| linux/flutter/ | Flutter SDK 桥接、生成的插件注册和临时缓存;ephemeral/ 为自动生成产物 | C++、CMake;部分自动生成,无手写业务逻辑 |
| test/ | 凭据、URL 与不同窗口宽度的界面验证 | Dart |
| build/ | Flutter 生成的 Windows 发行与缓存(忽略) | 构建产物,无业务源码 |
| build/ | Flutter 生成的 Windows/Linux 发行与缓存(忽略) | 构建产物,无业务源码 |
| .dart_tool/ | Dart/Flutter 生成缓存(忽略) | JSON 等,无业务源码 |
## 检查
@@ -139,3 +142,21 @@ USB ADB 连续 3 轮监控缺失(约 9 秒)、USB 后端退出或 scrcpy 以
Windows 宿主、Flutter C++ 包装库和源码插件统一使用静态 MSVC CRT,保留 Flutter 引擎及插件 DLL。安装打包使用 `scripts/check-windows-crt.py`(Python 标准库 PE 导入及延迟导入检查),只附带实际需要的 MSVC 运行库及其传递依赖,缺失则拒绝发布;Rust 工具仍需的运行库不会被误删。
工具位置由 `lib/data/tool_paths.dart`(Dart)统一解析:识别 TTSTD/TongTongStudio 旧安装路径,优先使用当前应用附带工具;有效自定义工具保持不变,失效路径可回退当前安装或 PATH。启动和每次连接时迁移并保存 client/adb/scrcpy 路径;缺少工具先提示重新安装或选择文件,尚未分配连接端口。用户配置与凭据位置不随安装目录变化。
## Linux 原生构建与 deb
需要 Linux Flutter 3.50 / Dart 3.14、clang、cmake、ninja、pkg-config、GTK 3 开发库和 libayatana-appindicator3-dev。Windows bundle 不能转换为 Linux 应用,必须在 Linux 原生编译。
```sh
bash scripts/build-flutter-linux.sh
# 一次新发布,自动递增补丁版本、构建 Rust 工具和 Flutter 并打 deb
bash scripts/build-linux-packages.sh flutter
```
上面的脚本从仓库根目录运行。可设置 `FLUTTER_BIN` 指定 SDK,`ADS_SCRCPY_BUNDLE` 指定已校验的原生 Linux scrcpy 完整目录(包含 adb、scrcpy、scrcpy-server 和 LICENSE);脚本检查 ELF 架构。当前 amd64 发行包自带 scrcpy 5.0.1/ADB 工具,避免系统旧 scrcpy 不支持 `--no-audio`。若不提供工具 bundle,deb 依赖系统 adb 和 scrcpy >=2.0。
Linux 配置位于 `${XDG_CONFIG_HOME:-$HOME/.config}/ads-flutter/settings.json`,日志位于 `${XDG_STATE_HOME:-$HOME/.local/state}/ads-flutter/logs/`,按天滚动。Windows 继续使用现有 LOCALAPPDATA 位置。凭据通过界面导入,不包含在发布包中。
Linux 使用独立 scrcpy 窗口,网络 ADB、多设备和 Agent 管理复用现有后端;Windows 专属内嵌投屏和 USB 驱动入口在 Linux 禁用,Linux USB 可使用独立 ads-usb CLI。安装 deb 后自动提供 /usr/bin 的四个 CLI 链接及应用菜单,支持共存和卸载回退。
`ads-flutter --package-check` 可在有桌面会话的 Linux 中验证原生窗口与插件:使用临时日志,跳过真实配置、凭据和设备初始化,随后自行退出。CLI 本身可在无 GUI 的机器运行。