CEF项目中的MacOS窗口最小化与隐藏状态支持

在CEF（Chromium Embedded Framework）项目中，MacOS平台上的窗口管理一直是一个值得深入探讨的技术话题。最近，关于如何正确处理MacOS窗口的两种最小化状态——隐藏（hidden）和停靠（docked）——成为了开发社区关注的焦点。

MacOS窗口状态概述

MacOS系统提供了两种不同的窗口最小化方式：

1. 停靠最小化：相当于调用[window miniaturize]方法，表现为点击窗口左上角的黄色"最小化"按钮后，窗口缩略图会显示在Dock栏中。

2. 隐藏最小化：相当于调用[window orderOut:nil]或[NSRunningApplication.currentApplication hide]方法，窗口会完全隐藏而不在Dock栏显示缩略图。

现有实现的问题

当前CEF实现仅支持初始显示状态为停靠最小化（通过GetInitialShowState接口）。当开发者需要实现隐藏最小化时，通常会在应用启动时调用CefWindow::Hide()或直接使用[NSRunningApplication.currentApplication hide]，但这带来了几个问题：

• 窗口可能不会按预期启动为最小化状态
• 窗口内容可能渲染不正确
• 使用Cmd+Tab切换窗口时行为异常
• 在Dock栏出现多余的缩略图

技术实现方案

核心修改点

1. 在ui::WindowShowState枚举中添加SHOW_STATE_HIDDEN值
2. 修改Widget::Init方法以支持新的显示状态
3. 确保WindowVisibilityState::kHideWindow被正确调用

Chromium底层机制

Chromium通过NativeWidgetNSWindowBridge::SetVisibilityState实现窗口的显示/隐藏行为。对于初始隐藏状态，需要确保：

• 在Widget::Init中正确处理SHOW_STATE_HIDDEN
• 调用Widget::Hide方法而非直接操作NSWindow
• 确保VisualProperties中的窗口状态能正确传递给渲染进程

实际应用中的挑战

测试发现，在应用启动时调用CefWindow::Hide()比直接使用[NSRunningApplication.currentApplication hide]更可靠，特别是在以下方面：

• 不会产生多余的Dock缩略图
• 窗口渲染更稳定
• Cmd+Tab切换行为更符合预期

最佳实践是在applicationWillFinishLaunching而非applicationDidFinishLaunching中调用隐藏方法，以确保时序正确性。

开发者建议

对于需要在CEF应用中实现初始隐藏窗口的开发者，建议：

1. 重写GetInitialShowState返回CEF_SHOW_STATE_MINIMIZED
2. 在applicationWillFinishLaunching中调用CefWindow::Hide()
3. 实现applicationShouldHandleReopen来处理Dock图标点击事件

这种方案在测试中表现稳定，避免了直接使用系统API带来的副作用，同时保持了良好的用户体验。

未来改进方向

虽然当前方案可以工作，但从架构角度看，CEF应该原生支持CEF_SHOW_STATE_HIDDEN状态，这将：

• 提供更清晰的API语义
• 减少平台相关代码
• 提高行为一致性
• 简化开发者实现

这需要Chromium底层对ui::SHOW_STATE_HIDDEN的完整支持，是未来值得考虑的功能增强。