使用 Bazelisk 安装 / 更新 Bazel

报告问题 查看源代码 每夜 build · 8.0 7.4 . 7.3 · 7.2 · 7.1 · 7.0 · 6.5

安装 Bazel

在 Ubuntu、Windows 和 macOS 上安装 Bazel 时,建议使用 Bazelisk。它会自动下载并安装适当版本的 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 问题中添加评论。

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