使用 Bazelisk 安裝 / 更新 Bazel

回報問題 查看來源

安裝 Bazel

如要在 Ubuntu、Windows 和 macOS 上安裝 Bazel,建議使用 Bazelisk。系統會自動下載並安裝合適的 Bazel 版本。如果您需要根據目前的工作目錄切換不同版本的 Bazel,或要一律將 Bazel 更新至最新版本,請使用 Bazelisk。

詳情請參閱官方 README

更新 Bazel

Bazel 有回溯相容性政策 (如果您是相關變更的作者,請參閱推出不相容變更的指南)。該頁面概述瞭如何測試和遷移專案的最佳做法,其中有即將進行的不相容的變更,並說明如何向不相容的變更作者提供意見回饋。

使用 Bazelisk 管理 Bazel 版本

Bazelisk 可協助您管理 Bazel 版本。

Bazelisk 可以:

  • 將 Bazel 自動更新至最新的 LTS 或滾動版本。
  • 使用 .bazelversion 檔案中指定的 Bazel 版本建構專案。將該檔案簽入版本管控系統,確保可重現建構作業。
  • 協助遷移專案,以便找出不相容的變更 (請參閱上文)
  • 輕鬆試用候選功能

建議的遷移程序

在任何 LTS 版本的次要更新中,任何專案都準備好因應下一個版本,而不會破壞目前版本的相容性。但主要 LTS 版本之間可能有回溯不相容的變更。

請按照這個流程在主要版本之間遷移:

  1. 請參閱版本資訊,瞭解如何遷移至下一個版本。
  2. 重大不相容的變更應有相關聯的 --incompatible_* 旗標和對應的 GitHub 問題:
    • 如需遷移指南,請參閱相關的 GitHub 問題。
    • 部分不相容的變更遷移工具可以使用這項工具。例如「buildifier」
    • 對相關聯的 GitHub 問題留言,回報遷移問題。

在遷移之後,您可以繼續建構專案,不必擔心到下一個主要版本具有回溯相容性。