使用 Bazelisk 安裝 / 更新 Bazel

回報問題open_in_new 查看來源open_in_new Nightly · 8.4 · 8.3 · 8.2 · 8.1 · 8.0 · 7.6

安裝 Bazel

建議使用 Bazelisk 在 Ubuntu、Windows 和 macOS 上安裝 Bazel。系統會自動下載並安裝適當的 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 問題中留言。

遷移完成後，您就能繼續建構專案，不必擔心回溯相容性問題，直到下一個主要版本發布為止。