從來源編譯 Bazel

回報問題 查看來源

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

如要從來源建構 Bazel，請執行下列任一操作：

• 使用現有的 Bazel 二進位檔建構

• 不使用稱為「啟動程序」的現有 Bazel 二進位檔進行建構。

使用 Bazel 建構 Bazel

摘要

1. 您可以前往 GitHub 版本頁面或使用 Bazelisk 取得最新的 Bazel 版本。

2. 從 GitHub 下載 Bazel 的來源，並將資料解壓縮到任一處。您也可以前往 https://github.com/bazelbuild/bazel 以 Git 複製原始碼

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。(您也可以從暫存區建構 (啟動))。

疑難排解：

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

  • 也許您的 Bazel 二進位檔目錄不在 PATH 上。

    這並不是一大問題。相對地，您必須輸入完整路徑，而不是輸入 bazel。

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

    這並不是一大問題。您可以重新命名二進位檔，或者輸入二進位檔名稱，不要輸入 bazel。

  • 有可能二進位檔無法執行 (在 Unix 上)。

    您必須執行 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、unzip

• 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 2017 建構工具。

• JDK.必須提供版本 11。

• Python。系統支援版本 2 和 3，只要安裝其中一個即可。您需要 Windows 原生版本 (可從 https://www.python.org 下載)。透過 MSYS2 以 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 Subsystem，就會找到該檔案。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。