Toga项目在macOS Sonoma上的NSMenu兼容性问题分析

问题背景

Toga是一个Python原生GUI工具包，最近在macOS Sonoma系统上出现了两个关键测试用例的稳定性问题。具体表现为test_selection_change和test_actions测试用例在执行过程中会意外触发窗口全屏操作，而非预期的菜单项选择行为。

现象描述

当测试脚本尝试通过编程方式点击选择控件(Selection)或详细列表(DetailedList)中的菜单项时，菜单会在点击瞬间意外消失，导致鼠标事件"穿透"到窗口的全屏按钮上。通过屏幕录制分析发现，全屏按钮的点击发生在菜单项尚未完全消失的视觉过渡期间。

技术分析

经过深入调查，发现这一问题与macOS 14(Sonoma)对NSMenu实现的变更有关。关键点包括：

1. 行为变化：在Sonoma系统中，NSMenu对编程生成的鼠标点击事件的处理方式发生了变化，不再像之前版本那样可靠地触发菜单项选择。

2. 事件穿透：当菜单因上述原因未能正确处理点击事件时，事件会传递到下层窗口元素，恰好命中了窗口控制按钮区域。

3. 测试稳定性：这一问题在Sonoma系统上100%可复现，而在较早版本的macOS上仅表现为偶发问题。

解决方案

针对这一问题，Toga项目采取了以下改进措施：

1. 事件处理增强：修改了测试用例中的事件触发逻辑，确保与新版NSMenu的行为兼容。

2. 布局调整：增加了控件周围的间距，避免测试操作区域与窗口控制按钮重叠。

3. 超时机制：为菜单操作添加了合理的超时处理，防止测试无限期等待不会发生的事件。

经验总结

这一案例展示了跨平台GUI开发中常见的兼容性挑战，特别是当底层系统组件行为发生变化时。对于开源项目维护者而言，这类问题提醒我们：

1. 需要密切关注各平台官方文档的变更说明
2. 自动化测试应包含对交互时序的严格验证
3. 测试用例设计需考虑不同系统版本的行为差异

通过这一问题的解决，Toga项目在macOS Sonoma上的稳定性和可靠性得到了提升，为后续的功能开发和用户体验优化奠定了更坚实的基础。