為 Bazel 做出貢獻

協助 Bazel 專案和生態系統有很多種,

提供意見

使用 Bazel 時,可能會發現可以改善的地方。您可以在發生下列情況時回報問題

  • Bazel 當機,或您遇到的錯誤,只能使用 bazel clean 解決
  • 說明文件內容不完整或不清楚。您也可以使用頁面右上角的「建立問題」連結,在目前瀏覽的網頁回報問題。
  • 錯誤訊息有待改進。

參與社群

您可以透過下列方式與 Bazel 社群互動:

提供代碼

Bazel 是大型專案,而且要變更 Bazel 原始碼並不容易。

您可以透過下列方式貢獻 Bazel 生態系統:

  • 提出提取要求,協助規則維護人員。
  • 建立新規則及開放其資源配置。
  • 提供給 Bazel 相關工具,例如遷移工具。
  • 改善 Bazel 與其他 IDE 和工具的整合作業。

進行變更前,請先建立 GitHub 問題或傳送電子郵件至 bazel-dev@

最實用的貢獻會修正錯誤或新增功能 (而不是在樣式、重構或「清除」變更)。變更內容應包括測試和說明文件,並留意回溯相容性和可攜性,以及對記憶體用量和效能的影響。

如要瞭解如何提交變更,請參閱修補接受程序

Bazel 的程式碼說明

Bazel 有龐大的程式碼集,其程式碼集位於多個位置。詳情請參閱程式碼集指南

Bazel 的組織方式如下:

  • 用戶端程式碼位於 src/main/cpp,並提供指令列介面。
  • 通訊協定緩衝區位於 src/main/protobuf
  • 伺服器程式碼位於 src/main/javasrc/test/java
    • 核心程式碼,主要由 SkyFrame 和部分公用程式組成。
    • 內建規則位於 com.google.devtools.build.lib.rulescom.google.devtools.build.lib.bazel.rules 中。建議您先參閱編寫規則的挑戰
  • Java 原生介面位於 src/main/native 中。
  • 如要瞭解支援語言的各種工具,請參閱編譯 Bazel 一節。

搜尋 Bazel 的原始碼

如要快速搜尋 Bazel 的原始碼,請使用 Bazel Code Search。您可以瀏覽 Bazel 的存放區、分支版本和檔案。此外,您還可以查看記錄、差異和錯誤資訊。詳情請參閱 Bazel 程式碼搜尋使用手冊