本頁面說明如何從原始碼安裝 Bazel,並提供常見問題的疑難排解提示。
如要從原始碼建構 Bazel,您可以執行下列其中一項操作:
使用現有的 Bazel 二進位檔建構應用程式
您不必使用現有的 Bazel 二進位檔進行建構,這種做法稱為「啟動程序」。
使用 Bazel 建構 Bazel
摘要
請前往 GitHub 發布頁面或 Bazelisk 取得最新的 Bazel 版本。
從 GitHub 下載 Bazel 的來源,然後擷取到其他位置。或者,您也可以從 https://github.com/bazelbuild/bazel 複製原始碼樹狀結構
安裝與啟動程序相同的必要條件 (請參閱類似 Unix 系統或 Windows 使用者)
使用 Bazel 建構 Bazel 的開發建構作業:
bazel build //src:bazel-dev
(在 Windows 上則為bazel build //src:bazel-dev.exe
)產生的二進位檔為
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
如果是其他情況:
將內容擷取到其他位置。
例如在主目錄下建立
bazel-src
目錄,然後擷取該目錄。
步驟 3:安裝必備條件
安裝與開機載入相同的必要條件 (如下所示):JDK、C++ 編譯器、MSYS2 (如果您在 Windows 上進行建構) 等。
步驟 4a:在 Ubuntu Linux、macOS 和其他類似 Unix 的系統上建構 Bazel
如需 Windows 適用的操作說明,請參閱「在 Windows 上建構 Bazel」。
目標:執行 Bazel 以建構自訂的 Bazel 二進位檔 (bazel-bin/src/bazel-dev
)。
操作說明:
啟動 Bash 終端機
將
cd
儲存至您擷取 (或複製) Bazel 來源的目錄。舉例來說,如果您在主目錄中擷取了來源,請執行:
cd ~/bazel-src
從來源建構 Bazel:
bazel build //src:bazel-dev
您也可以執行
bazel build //src:bazel --compilation_mode=opt
來產生較小的二進位檔,但建構速度較慢。輸出內容會是
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
)。
操作說明:
啟動命令提示字元 (開始功能表 > 執行 > 「cmd.exe」)
將
cd
儲存至您擷取 (或複製) Bazel 來源的目錄。舉例來說,如果您在主目錄中擷取了來源,請執行:
cd %USERPROFILE%\bazel-src
從來源建構 Bazel:
bazel build //src:bazel-dev.exe
您也可以執行
bazel build //src:bazel.exe --compilation_mode=opt
來產生較小的二進位檔,但建構速度較慢。輸出內容會是
bazel-bin\src\bazel-dev.exe
(或bazel-bin\src\bazel.exe
)。
步驟 5:安裝建構的二進位檔
實際上,沒有可安裝的東西。
上一個步驟的輸出內容是獨立的 Bazel 二進位檔。您可以將其複製到任何目錄並立即使用。(如果該目錄位於您的 PATH 中,您便可在任何地方執行「bazel」)。
從頭開始建構 Bazel (啟動程序)
您也可以從頭開始建構 Bazel,不必使用現有的 Bazel 二進位檔。
步驟 1:下載 Bazel 的來源 (發布封存檔)
(所有平台都必須進行相同的步驟)。
從 GitHub 下載
bazel-<version>-dist.zip
,例如bazel-0.28.1-dist.zip
。注意:
- 這裡有「單一架構獨立」發行封存檔。沒有特定架構或 OS 專屬的發行封存檔。
- 這些來源與 GitHub 原始碼結構不同。您必須使用發布封存檔來啟動 Bazel。無法使用從 GitHub 複製的來源樹狀結構。(發布封存檔包含系統產生的來源檔案,這些檔案是開機所需的檔案,而且不屬於一般 Git 來源樹狀結構)。
將發布封存檔解壓縮到磁碟上的任一處。
您應驗證 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
開啟殼層或終端機視窗。
cd
至您解壓縮發行封存檔的目錄。執行編譯指令碼:
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. 安裝必備條件
適用於 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
開啟 MSYS2 殼層。
設定下列環境變數:
BAZEL_VS
或BAZEL_VC
(兩者「不」相同):請設為 Visual Studio 目錄 (BAZEL_VS) 或 Visual C++ 目錄 (BAZEL_VC) 的路徑。只要設定其中一項即可。BAZEL_SH
:MSYS2bash.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"
cd
至您解壓縮發行封存檔的目錄。執行編譯指令碼:
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。