版本版本控制

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

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)。大约每 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 文档

更新版本

  • 如需详细了解如何更新 Bazel 版本,请参阅更新 Bazel
  • 如需详细了解如何为新版 Bazel 贡献更新,请参阅为 Bazel 贡献