Ani 项目在 macOS 上的窗口布局问题解析

在 Ani 4.0.0 版本中，macOS 平台上的 COMPACT 播放页出现了一个窗口布局问题。具体表现为顶部缺少 title bar insets，导致界面元素与系统窗口标题栏重叠。

问题现象

当用户在 macOS 系统（特别是 M 系列芯片设备）上使用 COMPACT 模式的播放页时，界面顶部没有为系统标题栏预留足够的空间。这会导致播放控制按钮或其他UI元素与系统标题栏重叠，影响用户体验和操作便利性。

相比之下，EXPANDED 模式的播放页布局表现正常，播放器区域有正确的 padding，右侧侧边栏也没有类似问题。

技术分析

这个问题属于典型的窗口 insets 处理不当。在 macOS 系统上，应用窗口需要考虑以下几个方面的 insets：

1. 标题栏区域（title bar）
2. 窗口边框
3. 可能的全屏控制按钮区域

特别是在使用 COMPACT 模式时，由于界面空间更为紧凑，正确处理这些 insets 尤为重要。从截图可以看出，EXPANDED 模式正确处理了这些 insets，而 COMPACT 模式则出现了遗漏。

解决方案

在 Ani 4.7.0 版本中，这个问题得到了修复。修复方案可能包括：

1. 统一 macOS 平台上的窗口 insets 处理逻辑
2. 为 COMPACT 模式显式添加 title bar 的 insets 计算
3. 确保不同显示模式下 insets 的一致性

最佳实践建议

对于跨平台桌面应用开发，处理窗口 insets 时应注意：

1. 针对不同操作系统实现特定的 insets 计算
2. 考虑不同显示模式下的布局需求
3. 在 UI 设计中预留足够的系统控件空间
4. 进行多平台、多模式的全面测试

这个问题提醒我们，在开发跨平台应用时，必须充分考虑各平台特有的UI特性和系统要求，才能提供一致且良好的用户体验。