版本版本控制

报告问题 查看源代码

Bazel 4.0 及更高版本为两种发布轨道提供支持:长期支持 (LTS) 版本和滚动版本。本页面介绍了 Bazel 中的版本控制、版本类型以及这些版本对 Bazel 用户和贡献者的好处。

了解 Bazel 上的版本控制

Bazel 使用 major.minor.patch 语义版本控制方案。

  • 主要版本包含与上一版本不向后兼容的功能。
  • 次要版本包含新的向后兼容功能。
  • 补丁版本包含次要更改和 bug 修复。

以版本 3.5.1 为例,每种类型的新版本将产生以下版本号:

  • 主要:4.0
  • 次要:3.6
  • 补丁:3.5.2

Bazel 的发布周期

Bazel 会持续发布滚动版本。每个主要版本都是一个 LTS 版本。您可以选择遵循发布频率 - 从一个 LTS 版本更新到下一个 LTS 版本,或者随每个次要版本进行更新。

此图显示了滚动版本和 LTS 版本,以及每个版本的预期支持。

路线图

图 1. 滚动版本和 LTS 版本。

发布分支

每个主要版本在发布时都会成为一个单独的开发分支。您可以接收该分支上严重 bug 的修复,而无需事先更新到 Bazel 版本。主要版本分支上的其他功能将成为次要版本,而分支上的最高版本则是受支持的版本。

每个 Bazel 版本都对应着一系列推荐规则版本,这些版本可以协同工作,并且每个分支内都有严格的向后兼容性。

LTS 版本

LTS 版本是主要版本(例如 4.0),在其发布后获得支持 3 年。主要版本大约每 9 个月发布一次。

对版本分支进行持续开发会产生次要版本。

您可以选择将项目固定到某个主要版本,并自行更新到较新版本。这样,您就有时间预览即将发生的更改并提前进行调整。

滚动版本

滚动版本会定期从 Bazel 的主分支中删除。 此发布节奏涉及持续交付下一个主要 Bazel 版本的预览版,这些预览版与 Google 的内部 Blaze 版本同步。

请注意,新的滚动版本可能包含与先前版本不兼容的重大更改。

滚动版本在 Bazel CI 的 Bazel 测试套件和 Google 的内部测试套件上进行测试。可以使用不兼容的标志来减轻迁移到新功能的负担,但默认行为可能会因任何滚动版本而发生变化。(您也可以使用滚动版本来预览下一个 LTS 版本。例如,5.0.0-pre.20210604.6 基于于 2021 年 6 月 4 日剪切的候选版本,代表向 5.0 LTS 版本的一个里程碑。)

您可以从 GitHub 下载最新的滚动版本。或者,您可以将 Bazelisk v1.9.0(或更高版本)设置为使用特定版本名称或“滚动”标识符,该标识符使用最新的滚动版本。如需了解详情,请参阅 Bazelisk 文档

更新版本