Files
pangolin/client/lib/system_tray.dart
T
wangjia e10f214dee
ci-pangolin / Lint — shellcheck (push) Has been cancelled
ci-pangolin / OpenAPI Sync Check (push) Has been cancelled
ci-pangolin / Redline Scan — 脱敏 (UI 文案) (push) Has been cancelled
ci-pangolin / Flutter — analyze + test (push) Has been cancelled
feat(client): 系统托盘常驻 + 关闭窗口隐藏到托盘(桌面端)
- system_tray.dart:TrayService 用 tray_manager + window_manager。setPreventClose
  拦截关闭 → 隐藏到托盘(常驻保持隧道);托盘图标点击/「显示主界面」重新显示,
  「退出」真正退出。
- main() 改 async:桌面端 runApp 前 init 托盘;移动端/web 跳过(isDesktop 守卫)。
- 托盘图标复用 app_icon_32.png → assets/tray_icon.png。
- 新依赖:tray_manager / window_manager。

flutter analyze 0 error;114 tests passed。托盘为运行时/原生功能,需 release .app 验证。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-19 06:31:40 +08:00

67 lines
2.3 KiB
Dart

// system_tray.dart — 桌面端系统托盘 + 关闭即最小化到托盘。
//
// macOS/Windows/Linux:关闭主窗口不退出,而是隐藏到托盘;托盘图标点击/菜单
// 可重新显示或真正退出。移动端/web 不涉及。
import 'dart:io';
import 'package:flutter/foundation.dart';
import 'package:tray_manager/tray_manager.dart';
import 'package:window_manager/window_manager.dart';
bool get isDesktop =>
!kIsWeb && (Platform.isMacOS || Platform.isWindows || Platform.isLinux);
class TrayService with TrayListener, WindowListener {
TrayService._();
static final TrayService instance = TrayService._();
/// 在 runApp 前调用(仅桌面端)。设置窗口拦截关闭 + 托盘图标与菜单。
Future<void> init() async {
await windowManager.ensureInitialized();
// 关闭窗口转为隐藏到托盘(见 onWindowClose)。
await windowManager.setPreventClose(true);
windowManager.addListener(this);
trayManager.addListener(this);
await trayManager.setIcon('assets/tray_icon.png');
await trayManager.setToolTip('穿山甲 Pangolin');
await trayManager.setContextMenu(Menu(items: [
MenuItem(key: 'show', label: '显示主界面'),
MenuItem.separator(),
MenuItem(key: 'quit', label: '退出'),
]));
}
Future<void> _show() async {
await windowManager.show();
await windowManager.focus();
}
// ── 托盘事件 ──────────────────────────────────────────────────
@override
void onTrayIconMouseDown() => _show();
@override
void onTrayIconRightMouseDown() => trayManager.popUpContextMenu();
@override
void onTrayMenuItemClick(MenuItem menuItem) {
switch (menuItem.key) {
case 'show':
_show();
case 'quit':
windowManager.setPreventClose(false);
windowManager.destroy();
}
}
// ── 窗口事件 ──────────────────────────────────────────────────
@override
void onWindowClose() async {
// 点关闭 → 隐藏到托盘而非退出(常驻保持隧道)。
if (await windowManager.isPreventClose()) {
await windowManager.hide();
}
}
}