librime项目中的API兼容性变更解析

背景介绍

librime作为Rime输入法引擎的核心组件，近期在API设计上做出了重要调整。这一变更直接影响了Weasel（小狼毫）输入法在Windows平台上的兼容性表现。

API版本演进

librime的API经历了两个主要版本阶段：

1. 0.9 API：早期版本采用的接口规范，已存在多年
2. 1.0 API：早在11年前就已引入的更现代化的接口设计

关键变更内容

最新nightly构建版本中，开发团队对0.9 API进行了重大调整：

• 将所有0.9 API迁移至rime_api_deprecated命名空间
• 这一变更导致基于0.9 API的客户端无法与新版本兼容
• 使用1.0 API的客户端不受此变更影响

影响范围

具体表现为：

• Weasel 0.14.3版本（基于0.9 API）能与librime 1.11.2及之前版本正常工作
• 但无法与最新的nightly构建版本兼容
• 这是开发团队有意为之的技术决策，旨在逐步淘汰旧API

技术建议

对于开发者而言：

1. 新项目应直接采用1.0 API进行开发
2. 现有项目应尽快迁移至1.0 API
3. 如需继续使用0.9 API，需停留在librime 1.11.2或更早版本

对于终端用户：

1. 使用稳定版而非nightly构建可避免兼容性问题
2. 等待输入法前端更新至支持1.0 API的版本

未来展望

这一变更标志着librime项目正在逐步淘汰历史遗留代码，拥抱更现代化的架构设计。虽然短期内会造成一些兼容性问题，但从长远看有利于项目的可持续发展。