使用 Bazelisk 安裝 / 更新 Bazel

回報問題 查看來源

安裝 Bazel

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

詳情請參閱官方的 README 檔案。

更新 Bazel

Bazel 制定了回溯相容性政策 (如果您是相關變更的編寫者，請參閱推出不相容的變更指南)。本頁面摘要說明測試及遷移專案的最佳做法，瞭解即將發布的不相容異動，以及如何向不相容的變更作者提供意見回饋。

使用 Bazelisk 管理 Bazel 版本

Bazelisk 可協助您管理 Bazel 版本。

Bazelisk 可以：

• 將 Bazel 自動更新至最新 LTS 或滾動式版本。
• 使用 .bazelversion 檔案中指定的 Bazel 版本建構專案。請在版本管控系統中檢查該檔案，確保建構的可重現性。
• 協助遷移專案找出不相容的變更 (請參閱上文)
• 輕鬆試用發布候選項目

建議的遷移程序

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

請按照以下程序從一個主要版本遷移至其他版本：

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

遷移完成後，您可以繼續建構專案，無須擔心下一個主要版本能回溯相容。