osu-framework 2025.129.0版本技术解析

项目简介

osu-framework是一个开源的跨平台游戏开发框架，主要用于构建节奏游戏和交互式应用程序。作为osu!游戏的核心框架，它提供了丰富的UI组件、输入处理、音频管理等功能，支持Windows、macOS、Linux、iOS和Android等多个平台。

版本亮点

2025.129.0版本主要聚焦于输入系统优化、跨平台兼容性改进以及性能提升，特别是在移动设备和触控输入方面做了多项改进。

输入系统改进

移动设备输入优化

1. iOS平台默认禁用相对模式：在iOS设备上，默认禁用了"相对模式"输入，这有助于改善触控操作的精确度和响应性。相对模式通常用于需要连续跟踪输入位置的场景，如绘图应用，但在节奏游戏中禁用可能更符合用户预期。

2. 文本输入自动大写禁用：框架现在默认禁用了文本框的自动大写功能，特别是在游戏场景中，用户名、密码等输入字段不再会自动将首字母大写，提供了更符合游戏场景的输入体验。

3. iPadOS文件展示修复：修复了在iPadOS上文件展示功能失效的问题，增强了文件选择和导入功能的可靠性。

输入类型细化

1. 新增字母数字代码输入类型：为需要输入验证码、序列号等场景提供了专门的输入类型支持，可以更好地适配移动设备的虚拟键盘布局。

2. 十进制数字输入类型：新增了对十进制数字输入的支持，适用于需要输入分数、金额等场景，优化了数字输入体验。

3. 鼠标与数位笔区分：现在可以区分鼠标和数位笔的输入，为绘图和精确操作提供了更好的支持。

Windows平台改进

1. 异步鼠标输入：在Windows平台上实现了鼠标输入的异步处理，减少了输入延迟，提高了响应速度。

2. Windows Ink支持：通过更新SDL3库，重新启用了对Windows Ink数位笔输入的支持，为专业绘图板用户提供了更好的压感和倾斜支持。

性能优化

1. 减少SearchContainer内存分配：移除了SearchContainer.cs中的一个char[]分配，减少了内存分配和垃圾回收压力，提高了搜索功能的性能。

2. 日志系统修复：修复了游戏测试场景中SetupLogging未被调用的问题，确保了日志系统的可靠性。

API变更

1. DrawableExtensions方法公开化：将IsRootedAt方法从internal改为public，扩展了开发者在处理Drawable对象时的灵活性。

跨平台构建

1. Android构建环境调整：将Windows构建镜像回滚到2019版本，解决了Android构建过程中的兼容性问题。

总结

2025.129.0版本的osu-framework在输入系统方面做了大量改进，特别是对移动设备和专业输入设备的支持更加完善。性能优化和API调整也为开发者提供了更好的开发体验。这些改进使得基于该框架开发的游戏和应用能够在各种设备和输入方式下提供更流畅、更精确的用户体验。