Mozc项目迁移至Bazel 8.0的技术实践

背景介绍

Mozc作为Google开发的日语输入法引擎，其构建系统基于Bazel。随着Bazel 8.0即将发布，项目团队开始着手准备从Bazel 7.4.x到8.0.x的迁移工作。本文将详细介绍这一技术迁移过程中的关键点和实践经验。

迁移准备工作

在正式迁移前，团队制定了详细的工作计划：

1. 版本锁定策略：在迁移初期，先将Bazel版本锁定在7.4.x，确保现有构建系统的稳定性。对于使用Bazelisk的GitHub Actions工作流，通过设置USE_BAZEL_VERSION环境变量来指定版本。

2. 依赖模块兼容性检查：全面检查所有依赖的Bazel模块是否兼容Bazel 8.0，必要时更新模块版本。

3. 自定义构建规则适配：确保Mozc项目自身的构建规则能够适配Bazel 8.0的新特性。

关键迁移步骤

1. 构建系统升级

团队首先更新了构建系统的核心组件，包括rules_apple等关键模块。在测试过程中发现，rules_apple 3.16.1版本能够很好地支持Linux平台下的服务器、GUI工具以及fcitx5输入法框架的构建。

2. 代码变更适配

迁移过程中需要对代码进行多处调整，包括但不限于：

• 构建文件(.bzl)的语法更新
• 依赖声明方式的调整
• 测试框架的适配

3. 持续集成系统改造

团队对GitHub Actions工作流进行了改造，确保CI/CD管道能够同时支持新旧版本的Bazel，为平滑过渡创造条件。

技术挑战与解决方案

在迁移过程中，团队遇到了几个主要挑战：

1. 向后兼容性问题：通过创建临时分支进行测试，确保所有功能在Bazel 8.0下正常工作后才合并到主分支。

2. 依赖冲突：仔细分析依赖树，逐步更新各模块版本，避免引入不兼容的变更。

3. 构建性能优化：利用Bazel 8.0的新特性对构建过程进行优化，减少构建时间。

迁移后的验证

完成迁移后，团队进行了全面的验证：

• 各平台构建测试(Windows/Linux/macOS)
• 功能完整性测试
• 性能基准测试
• 稳定性测试

经验总结

通过这次迁移，团队积累了宝贵的经验：

1. 渐进式迁移：采用锁定旧版本、逐步验证的方式大大降低了风险。
2. 自动化测试：完善的CI系统是确保迁移成功的关键。
3. 社区协作：积极与Bazel社区沟通，及时获取最新信息和支持。

未来展望

随着Bazel 8.0的正式发布，Mozc项目将完全转向新版本，并计划逐步淘汰对Bazel 7.x的支持。团队将持续关注Bazel生态的发展，及时采用新特性来优化输入法引擎的构建过程。