Flutter托盘工具应用点击外部自动隐藏实现方法咨询

核心逻辑 #

托盘类应用通常是轻量悬浮窗口，要实现点击外部自动隐藏，核心是监听窗口失去焦点的事件，触发窗口隐藏操作。以下是经过验证的实现步骤：

1. 基于window_manager的焦点监听实现 #

即便你用过这个库，可能没用到焦点事件的监听能力。添加如下逻辑：

import 'package:window_manager/window_manager.dart';

void _setupWindowFocusListener() {
  windowManager.addListener(_windowFocusListener);
}

void _windowFocusListener(WindowEvent event) {
  if (event == WindowEvent.blur) {
    // 窗口失去焦点，执行隐藏
    windowManager.hide();
  }
}

// 在页面初始化时绑定监听
@override
void initState() {
  super.initState();
  _setupWindowFocusListener();
}

// 页面销毁时移除监听，避免内存泄漏
@override
void dispose() {
  windowManager.removeListener(_windowFocusListener);
  super.dispose();
}

2. 解决托盘图标点击的冲突问题 #

如果点击托盘图标显示窗口后，立刻触发blur事件导致窗口秒关，需要添加状态标记过滤：

bool _isTriggeredByTray = false;

// 托盘图标点击回调函数
void _onTrayTap() async {
  _isTriggeredByTray = true;
  await windowManager.show();
  // 延迟重置标记，防止误判
  Future.delayed(const Duration(milliseconds: 600), () {
    _isTriggeredByTray = false;
  });
}

// 修改焦点监听逻辑
void _windowFocusListener(WindowEvent event) {
  if (event == WindowEvent.blur && !_isTriggeredByTray) {
    windowManager.hide();
  }
}

3. 跨平台适配配置 #

• Windows：初始化窗口时设置必要属性，确保窗口能正常监听焦点：

await windowManager.setAlwaysOnTop(true);
await windowManager.setSkipTaskbar(true); // 隐藏任务栏图标，符合托盘应用特性

• macOS：调整窗口激活策略，避免抢占系统焦点：

await windowManager.setActivationPolicy(WindowActivationPolicy.accessory);
await windowManager.setHasShadow(false); // 可选，根据UI需求调整

4. 基于bitsdojo_window的替代实现 #

如果window_manager不符合预期，试试bitsdojo_window的窗口模糊事件监听：

import 'package:bitsdojo_window/bitsdojo_window.dart';

@override
void initState() {
  super.initState();
  doWhenWindowReady(() {
    appWindow.onWindowBlur.listen((_) {
      appWindow.hide();
    });
  });
}

内容的提问来源于stack exchange，提问作者Sushma Shrestha