從來源編譯 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 二進位檔本身並未命名為 bazel (在 Unixes 上) 或 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. 安裝必要條件

  • Bash

  • zip、解壓縮

  • C++ 建構工具鍊

  • JDK.。必須提供版本 11。

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

例如,在 Ubuntu Linux 上,您可以使用以下指令安裝這些需求:

sudo apt-get install build-essential openjdk-11-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 Studio 2015 以上版本安裝 Visual C++ 編譯器,或安裝最新的 Visual Studio for Visual Studio 2017

  • JDK.。必須提供版本 11。

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

2.2. 在 Windows 上啟動 Bazel

  1. 開啟 MSYS2 殼層。

  2. 設定下列環境變數:

    • BAZEL_VSBAZEL_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/jdk1.8.0_112"
    

    或 (使用 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/jdk1.8.0_112"
    
  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。