從來源編譯 Bazel

回報問題 查看原始碼

本頁面說明如何從原始碼安裝 Bazel，並提供常見問題的疑難排解提示。

如要從原始碼建構 Bazel，您可以執行下列其中一項操作：

使用 Bazel 建構 Bazel

摘要

  1. 請前往 GitHub 發布頁面或 Bazelisk 取得最新的 Bazel 版本。

  2. 從 GitHub 下載 Bazel 的來源，然後擷取到其他位置。或者，您也可以從 https://github.com/bazelbuild/bazel 複製原始碼樹狀結構

  3. 安裝與啟動程序相同的必要條件 (請參閱類似 Unix 系統或 Windows 使用者)

  4. 使用 Bazel 建構 Bazel 的開發建構作業：bazel build //src:bazel-dev (在 Windows 上則為 bazel build //src:bazel-dev.exe)

  5. 產生的二進位檔為 bazel-bin/src/bazel-dev (或在 Windows 上為 bazel-bin\src\bazel-dev.exe)。您可以將此草稿複製到任意位置，並立即使用，不必進一步安裝。

詳細指示如下。

步驟 1：取得最新版本的 Bazel

目標：安裝或下載 Bazel 的發布版本。請務必在終端機中輸入 bazel 來執行該指令。

原因：如要從 GitHub 來源樹狀結構建構 Bazel，您需要已預先存在的 Bazel 二進位檔。您可以從套件管理員進行安裝，也可以從 GitHub 下載。請參閱安裝 Bazel。(您也可以透過快速啟動 (Bootstrap) 建構)。

疑難排解：

  • 如果無法在終端機中輸入 bazel 來執行 Bazel：

    • 可能是因為 Bazel 二進位檔的目錄不在 PATH 中。

      這不是什麼大問題。您需改為輸入完整路徑，而非輸入 bazel。

    • 也許 Bazel 二進位檔本身在 Unixes 上並非稱為 bazel (在 Windows 上) 或 bazel.exe (在 Windows 上)。

      這不是什麼大問題。您可以重新命名二進位檔，或是輸入二進位檔的名稱，而不是 bazel。

    • 可能原因為無法在 Unixes 上執行二進位檔。

      您必須執行 chmod +x /path/to/bazel，才能將二進位檔設為可執行檔。

步驟 2：從 GitHub 下載 Bazel 的來源

如果您熟悉 Git，只要 git clone https://github.com/bazelbuild/bazel

如果是其他情況：

  1. 下載以 ZIP 檔案格式下載的最新來源。

  2. 將內容擷取到其他位置。

    例如在主目錄下建立 bazel-src 目錄，然後擷取該目錄。

步驟 3：安裝必備條件

安裝與開機載入相同的必要條件 (如下所示)：JDK、C++ 編譯器、MSYS2 (如果您在 Windows 上進行建構) 等。

步驟 4a：在 Ubuntu Linux、macOS 和其他類似 Unix 的系統上建構 Bazel

如需 Windows 適用的操作說明，請參閱「在 Windows 上建構 Bazel」。

目標：執行 Bazel 以建構自訂的 Bazel 二進位檔 (bazel-bin/src/bazel-dev)。

操作說明：

  1. 啟動 Bash 終端機

  2. 將 cd 儲存至您擷取 (或複製) Bazel 來源的目錄。

    舉例來說，如果您在主目錄中擷取了來源，請執行：

    cd ~/bazel-src

  3. 從來源建構 Bazel：

    bazel build //src:bazel-dev

    您也可以執行 bazel build //src:bazel --compilation_mode=opt 來產生較小的二進位檔，但建構速度較慢。

  4. 輸出內容會是 bazel-bin/src/bazel-dev (或 bazel-bin/src/bazel)。

步驟 4b：在 Windows 中建構 Bazel

如需 Unix 類似系統的操作說明，請參閱 Ubuntu Linux、macOS 和其他類似 Unix 系統的系統。

目標：執行 Bazel 以建構自訂的 Bazel 二進位檔 (bazel-bin\src\bazel-dev.exe)。

操作說明：

  1. 啟動命令提示字元 (開始功能表 > 執行 > 「cmd.exe」)

  2. 將 cd 儲存至您擷取 (或複製) Bazel 來源的目錄。

    舉例來說，如果您在主目錄中擷取了來源，請執行：

    cd %USERPROFILE%\bazel-src

  3. 從來源建構 Bazel：

    bazel build //src:bazel-dev.exe

    您也可以執行 bazel build //src:bazel.exe --compilation_mode=opt 來產生較小的二進位檔，但建構速度較慢。

  4. 輸出內容會是 bazel-bin\src\bazel-dev.exe (或 bazel-bin\src\bazel.exe)。

步驟 5：安裝建構的二進位檔

實際上，沒有可安裝的東西。

上一個步驟的輸出內容是獨立的 Bazel 二進位檔。您可以將其複製到任何目錄並立即使用。(如果該目錄位於您的 PATH 中，您便可在任何地方執行「bazel」)。

從頭開始建構 Bazel (啟動程序)

您也可以從頭開始建構 Bazel，不必使用現有的 Bazel 二進位檔。

步驟 1：下載 Bazel 的來源 (發布封存檔)

(所有平台都必須進行相同的步驟)。

  1. 從 GitHub 下載 bazel-<version>-dist.zip，例如 bazel-0.28.1-dist.zip。

    注意：

    • 這裡有「單一架構獨立」發行封存檔。沒有特定架構或 OS 專屬的發行封存檔。
    • 這些來源與 GitHub 原始碼結構不同。您必須使用發布封存檔來啟動 Bazel。無法使用從 GitHub 複製的來源樹狀結構。(發布封存檔包含系統產生的來源檔案，這些檔案是開機所需的檔案，而且不屬於一般 Git 來源樹狀結構)。

  2. 將發布封存檔解壓縮到磁碟上的任一處。

    您應驗證 Bazel 的發布金鑰 3D5919B448457EE0 產生的簽名。

步驟 2a：在 Ubuntu Linux、macOS 和其他類似 Unix 系統的系統上啟動 Bazel

如需 Windows 適用的操作說明，請參閱「在 Windows 上啟動 Bazel」。

2.1. 安裝必備條件

  • 巴士

  • zip、unzip

  • C++ 建構工具鍊

  • JDK.必須使用版本 21。

  • Python。系統支援版本 2 和 3，安裝其中一個版本就夠了。

以 Ubuntu Linux 為例，您可以使用下列指令安裝這些需求：

sudo apt-get install build-essential openjdk-21-jdk python zip unzip

2.2. 在 Unix 上啟動 Bazel

  1. 開啟殼層或終端機視窗。

  2. cd 至您解壓縮發行封存檔的目錄。

  3. 執行編譯指令碼：env EXTRA_BAZEL_ARGS="--tool_java_runtime_version=local_jdk" bash ./compile.sh。

編譯後的輸出內容會放在 output/bazel 中。這是獨立的 Bazel 二進位檔，沒有嵌入的 JDK。你可以複製到任何地方或直接使用為方便起見，請將這個二進位檔複製到 PATH 上的目錄 (例如 Linux 上的 /usr/local/bin)。

如要以可重現的方式建構 bazel 二進位檔，請同時在「執行編譯指令碼」步驟中設定 SOURCE_DATE_EPOCH。

步驟 2b：在 Windows 上啟動 Bazel

如需 Unix 類似系統的操作說明，請參閱「在 Ubuntu Linux、macOS 和其他類似 Unix 系統上啟動 Bazel」一文。

2.1. 安裝必備條件

  • MSYS2 殼層

  • 適用於 ZIP 和解壓縮的 MSYS2 套件。在 MSYS2 殼層中執行下列指令：

    pacman -S zip unzip patch

  • Visual C++ 編譯器。將 Visual C++ 編譯器安裝為 Visual Studio 2015 以上版本，或安裝最新的 Visual Studio 2017 建構工具。

  • JDK.必須使用版本 21。

  • Python。系統支援版本 2 和 3，安裝其中一個版本就夠了。您需要使用 Windows 原生版本 (可從 https://www.python.org 下載)。您將無法使用在 MSYS2 中透過精靈安裝的版本。

2.2. 在 Windows 上啟動 Bazel

  1. 開啟 MSYS2 殼層。

  2. 設定下列環境變數：

    • BAZEL_VS 或 BAZEL_VC (兩者「不」相同)：請設為 Visual Studio 目錄 (BAZEL_VS) 或 Visual C++ 目錄 (BAZEL_VC) 的路徑。只要設定其中一項即可。

    • BAZEL_SH：MSYS2 bash.exe 的路徑。請參閱以下範例中的指令。

      請勿設為「C:\Windows\System32\bash.exe」。(若您已安裝適用於 Linux 的 Windows 子系統，這個檔案將會有此檔案)。Bazel 不支援這個版本的 bash.exe。

    • PATH：新增 Python 目錄。

    • JAVA_HOME：設為 JDK 目錄。

    範例 (使用 BAZEL_VS)：

    export BAZEL_VS="C:/Program Files (x86)/Microsoft Visual Studio/2017/BuildTools"
export BAZEL_SH="$(cygpath -m $(realpath $(which bash)))"
export PATH="/c/python27:$PATH"
export JAVA_HOME="C:/Program Files/Java/jdk-21"

    或 (使用 BAZEL_VC)：

    export BAZEL_VC="C:/Program Files (x86)/Microsoft Visual Studio/2017/BuildTools/VC"
export BAZEL_SH="$(cygpath -m $(realpath $(which bash)))"
export PATH="/c/python27:$PATH"
export JAVA_HOME="C:/Program Files/Java/jdk-21"

  3. cd 至您解壓縮發行封存檔的目錄。

  4. 執行編譯指令碼：env EXTRA_BAZEL_ARGS="--tool_java_runtime_version=local_jdk" ./compile.sh

編譯後的輸出內容會放在 output/bazel.exe 中。這是獨立的 Bazel 二進位檔，沒有嵌入的 JDK。你可以複製到任何地方或直接使用為了方便起見，請將這個二進位檔複製到 PATH 上的目錄。

如要以可重現的方式建構 bazel.exe 二進位檔，請同時在「執行編譯指令碼」步驟中設定 SOURCE_DATE_EPOCH。

您不需要從 MSYS2 殼層執行 Bazel。您可以透過命令提示字元 (cmd.exe) 或 PowerShell 執行 Bazel。