CEF项目中Windows平台下文档画中画窗口任务栏图标问题分析

问题背景

在CEF(Chromium Embedded Framework)项目中，当启用Chrome运行时并打开文档画中画(PiP)窗口时，Windows任务栏会显示一个与主应用程序窗口不同的图标，且这些窗口不会被分组在一起。这与Chrome浏览器的行为不一致，后者会通过Windows API将这些窗口图标进行分组。

技术原理分析

Windows任务栏分组机制

Windows操作系统提供了应用程序窗口分组功能，主要通过设置应用程序用户模型ID(AppUserModelID)来实现。当多个窗口共享相同的AppUserModelID时，Windows任务栏会自动将它们分组在一起。

CEF中的实现差异

在CEF中，主窗口和画中画窗口使用了不同的窗口创建方式：

1. 主窗口使用DesktopWindowTreeHostWin和DesktopNativeWidgetAura
2. 画中画窗口使用BrowserDesktopWindowTreeHostWin和DesktopBrowserFrameAura

关键区别在于BrowserDesktopWindowTreeHostWin类中会调用BrowserWindowPropertyManager来设置窗口属性，包括AppUserModelID等任务栏相关属性。

解决方案探讨

开发团队考虑了两种解决方案：

方案一：不调用SetAppDetailsForWindow

对于视图托管的窗口不调用SetAppDetailsForWindow函数，这样会使用默认的任务栏行为（按应用程序分组）。这种方案实现简单，但会导致画中画窗口和开发者工具弹出窗口使用默认分组行为。

方案二：为所有窗口创建BrowserWindowPropertyManager

为所有视图托管的窗口创建BrowserWindowPropertyManager，这样可以将Chrome的任务栏分组行为应用到所有窗口。但这种方案会使应用图标配置更加复杂（例如在任务栏中使用Chromium图标）。

最终决策

经过权衡，开发团队选择了方案一，主要基于以下考虑：

1. 使用简单，不需要额外配置
2. 保持了与大多数Windows应用程序一致的行为
3. 避免了复杂的图标管理问题

遗留问题

即使采用了方案一，仍然存在一个次要问题：当从画中画窗口选择"检查"时，打开的开发者工具窗口会出现在新的任务栏组中。这是因为在这种情况下，打开者是画中画窗口本身。开发团队认为这种级别的打开者复杂性不值得特别处理。

结论

CEF项目通过选择不调用SetAppDetailsForWindow函数，解决了Windows平台下文档画中画窗口任务栏图标不一致的问题，同时保持了良好的用户体验和简单的实现方式。这一决策体现了在功能完整性和实现复杂性之间的合理权衡。