Fyne项目在MacOS系统托盘工具提示显示问题解析

问题背景

在MacOS 14.7.1系统环境下，使用Fyne框架开发的应用程序在系统托盘区域设置工具提示时，发现了一个显示异常问题。当应用程序窗口处于全屏模式时，系统托盘图标上的工具提示无法正常显示，而在普通窗口模式下则能正常显示。

问题现象分析

开发者通过测试发现，当应用程序运行在桌面窗口模式下时，调用systray.SetTooltip("tooltip")方法设置的工具提示能够正常显示。然而，当切换到全屏应用模式（如最大化窗口或进入全屏空间）后，同样的工具提示却无法显示。

值得注意的是，这个问题并非所有MacOS应用程序都会出现。例如JetBrains Toolbox等第三方应用在全屏模式下仍能正常显示工具提示，而Dropbox、Docker等应用则与Fyne应用表现一致。

技术深入探究

通过进一步测试发现，问题根源在于Fyne框架内部处理系统托盘事件循环的方式差异：

1. 当使用systray.Run()启动的系统托盘（使用nativeLoop）时，会出现全屏模式下工具提示不显示的问题
2. 而使用systray.RunWithExternalLoop()启动的系统托盘则能正常在全屏模式下显示工具提示

这表明Fyne框架在MacOS平台下对系统托盘工具提示的处理存在两种不同的实现路径，且这两种路径在全屏模式下的表现不一致。

解决方案

Fyne开发团队在v2.6.0版本中修复了这个问题。修复方案是正确使用了MacOS的全屏模式API，确保在全屏状态下也能正常显示系统托盘工具提示。该修复目前已在开发分支中实现，并将在正式版发布时提供给所有用户。

开发者建议

对于遇到类似问题的开发者，建议：

1. 升级到Fyne v2.6.0或更高版本
2. 如果暂时无法升级，可以考虑使用systray.RunWithExternalLoop()作为临时解决方案
3. 在开发跨平台应用时，特别注意MacOS特有的全屏模式行为差异

这个问题也提醒我们，在开发跨平台应用时，需要特别注意不同操作系统对UI元素显示行为的特殊处理，特别是全屏模式等特殊场景下的表现差异。