安装 Bazel
建议使用 Bazelisk 在 Ubuntu、Windows 和 macOS 上安装 Bazel。它会自动下载并安装相应版本的 Bazel。如果您需要根据当前工作目录在不同版本的 Bazel 之间切换,或者需要始终将 Bazel 更新到最新版本,请使用 Bazelisk。
如需了解详情,请参阅官方 README。
更新 Bazel
Bazel 具有向后兼容性政策(如果您是 Bazel 的作者,请参阅有关发布不兼容更改的指南)。本页面总结了有关如何测试和迁移具有即将生效的不兼容更改的项目,以及如何向不兼容的变更作者提供反馈的最佳实践。
使用 Bazelisk 管理 Bazel 版本
Bazelisk 可帮助您管理 Bazel 版本。
Bazelisk 可以:
- 自动将 Bazel 更新到最新的 LTS 或滚动版本。
- 使用 .bazelversion 文件中指定的 Bazel 版本构建项目。将该文件签入版本控制,确保 build 的可再现性。
- 帮助迁移您的项目以执行不兼容的更改(参见上文)
- 轻松尝试候选版本
推荐的迁移流程
在任何 LTS 版本的次要更新中,任何项目都可以为下一个版本做好准备,而不会破坏与当前版本的兼容性。不过,主要 LTS 版本之间可能存在向后不兼容的更改。
请按照以下步骤从一个主要版本迁移到另一个主要版本:
- 阅读版本说明,获取有关如何迁移到下一个版本的建议。
- 不兼容的重大更改应具有关联的
--incompatible_*
标志以及相应的 GitHub 问题:- 相关 GitHub 问题中提供了迁移指南。
- 工具可用于迁移一些不兼容的变更。例如 buildifier。
- 通过评论关联的 GitHub 问题来报告迁移问题。
迁移后,您可以继续构建项目,而不必担心向后兼容性,直到下一个主要版本发布。