使用 Bazelisk 安装 / 更新 Bazel

安装 Bazel

Bazelisk 是在 Ubuntu、Windows 和 macOS 上安装 Bazel 的 推荐方式。它会自动下载并安装相应版本的 Bazel。如果您需要根据当前工作目录在不同版本的 Bazel 之间切换,或者始终将 Bazel 更新到最新版本,请使用 Bazelisk。

如需了解详情,请参阅 官方自述文件

更新 Bazel

Bazel 具有向后兼容性政策 (如果您 是某个不兼容 更改的作者,请参阅推出不兼容更改的指南)。该页面总结了有关如何测试和迁移包含即将推出的不兼容更改的项目,以及如何向不兼容更改的作者提供反馈的最佳实践。

使用 Bazelisk 管理 Bazel 版本

Bazelisk 可帮助您管理 Bazel 版本。

Bazelisk 可以:

  • 将 Bazel 自动更新到最新的 LTS 或滚动发布版本。
  • 使用 .bazelversion 文件中指定的 Bazel 版本构建项目。将该文件签入版本控制系统,以确保 build 的可重现性。
  • 帮助迁移项目以适应不兼容的更改(见上文)
  • 轻松试用候选版本

推荐的迁移流程

在对任何 LTS 版本进行次要更新时,任何项目都可以为下一个版本做好准备,而不会破坏与当前版本的兼容性。不过,主要 LTS 版本之间可能会存在向后不兼容的更改。

请按照以下流程从一个主要版本迁移到另一个主要版本:

  1. 阅读版本说明,获取有关如何迁移到下一个版本的建议。
  2. 主要的不兼容更改应具有关联的 --incompatible_* 标志和相应的 GitHub 问题:
    • 关联的 GitHub 问题中提供了迁移指南。
    • 对于某些不兼容的更改迁移,可以使用工具。例如,buildifier
    • 通过评论关联的 GitHub 问题来报告迁移问题。

迁移后,您可以继续构建项目,而无需担心向后兼容性,直到下一个主要版本发布。