使用 Bazelisk 安裝 / 更新 Bazel

回報問題 查看原始碼 Nightly · 8.0 7.4 . 7.3 · 7.2 · 7.1 · 7.0 · 6.5

安裝 Bazel

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

詳情請參閱官方 README

更新 Bazel

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

使用 Bazelisk 管理 Bazel 版本

Bazelisk 可協助您管理 Bazel 版本。

Bazelisk 可以:

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

建議的遷移程序

在任何 LTS 版本的微幅更新中,任何專案都可以為下一個版本做好準備,而不會破壞與目前版本的相容性。不過,主要 LTS 版本之間可能會有回溯不相容的變更。

請按照下列程序,從一個主要版本遷移至另一個主要版本:

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

遷移完成後,您可以繼續建構專案,不必擔心回溯相容性,直到下一個主要版本為止。