使用 Bazelisk 安装 / 更新 Bazel

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。
报告问题 查看源代码

安装 Bazel

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

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

正在更新 Bazel

Bazel 制定了向后兼容政策(如果您是作者,请参阅关于发布不兼容更改的指南)。本页总结了有关在即将发生的不兼容更改中测试和迁移项目的最佳做法,以及如何向不兼容的更改作者提供反馈。

使用 Bazelisk 管理 Bazel 版本

Bazelisk 可帮助您管理 Bazel 版本。

Bazelisk 可以:

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

推荐的迁移过程

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

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

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

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