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 版本是指发布后支持期为 3 年的主要版本(例如 4.0)。 我们大约每九个月发布一个主要版本。
在发布分支上持续开发会产生次要版本。
您可以选择将项目固定到某个主要版本,并在自己方便的时间更新到较新版本。这样一来,您就可以提前预览即将发生的更改并适应这些更改。
滚动发布
滚动发布版本会定期从 Bazel 的主分支中切出。 此发布节奏涉及持续交付下一个主要 Bazel 版本的预览版,这些预览版与 Google 的内部 Blaze 版本同步。
请注意,新的滚动发布版本可能包含与之前版本不兼容的重大更改。
滚动发布版本会在 Bazel CI 上的 Bazel 测试套件和 Google 的内部测试套件上进行测试。不兼容的标志可用于减轻迁移到新功能的负担,但默认行为可能会随任何滚动发布而发生变化。(您还可以使用滚动发布版本来预览下一个 LTS 版本。例如,5.0.0-pre.20210604.6
基于 2021-06-04 的候选版本,代表着向 5.0 LTS 版本迈进的一个里程碑。)
您可以从 GitHub 下载最新的滚动发布版本。 或者,您也可以设置 Bazelisk v1.9.0(或更高版本)以使用特定版本名称或“滚动”标识符,后者使用最新的滚动版本。如需了解详情,请参阅 Bazelisk 文档。
更新版本
- 如需详细了解如何更新 Bazel 版本,请参阅更新 Bazel。
- 如需详细了解如何为新版 Bazel 贡献更新,请参阅为 Bazel 贡献内容。