在 Windows 上安裝 Bazel

回報問題 查看原始碼 夜間 7.4 ，直接在 Google Cloud 控制台實際操作。 7.3 · 7.2 · 7.1 · 7.0 · 6.5

本頁面說明在 Windows 上安裝 Bazel 的規定和步驟。 另包括疑難排解和其他 Bazel 安裝方式，例如： 製作出「巧克力」或「潛水」

安裝 Bazel

本節說明必要條件、環境設定和詳細說明 步驟。

檢查系統

建議：64 位元 Windows 10，版本 1703 (創作者更新) 以上版本

如要查看 Windows 版本，請按照下列步驟操作：

  • 按一下「開始」按鈕。
  • 在搜尋框中輸入「winver」，然後按下 Enter 鍵。
  • 畫面上會顯示「關於 Windows」方塊，其中包含 Windows 版本資訊。

其他支援：

  • 64 位元 Windows 7 以上版本

  • 64 位元 Windows Server 2008 R2 以上版本

安裝必要條件

下載 Bazel

建議：使用 Bazelisk

或者，您也可以採取下列做法：

設定環境

如要將 Bazel 預設為可透過指令提示或 PowerShell 輕鬆存取，您可以將 Bazel 二進位檔重新命名為 bazel.exe，然後將其新增至預設路徑。

set PATH=%PATH%;path to the Bazel binary

您也可以將系統 PATH 環境變數變更為永久狀態。請參閱這篇文章，瞭解如何設定環境變數。

完成

「成功：您已安裝 Bazel。」

如要檢查安裝是否正確，請嘗試執行下列指令：

bazel version

接著，你可以查看以下更多提示和指南：

安裝編譯器和程式語言執行階段

根據您要建構的語言而定，您需要：

  • MSYS2 x86_64

    MSYS2 是 Windows 專用的軟體發行版和建構平台。其中包含 Bash 和通用 Unix 工具 (例如 grep、tar、git)。

    您需要 MSYS2 來建構、測試或執行依附於 Bash 的目標。通常是 genrule、sh_binary、sh_test，但可能還有其他規則 (例如 Starlark 規則)。Bazel 會顯示 如果建構目標需要 Bash，但 Bazel 找不到該目標，就會發生錯誤。

  • 常見的 MSYS2 套件

    您可能需要這些工具來建構及執行依附於 Bash 的目標。MSYS2 預設不會安裝這些工具，因此您必須手動安裝。如果專案仰賴 PATH 中的 Bash 工具，就必須執行這個步驟，例如 TensorFlow。

    開啟 MSYS2 終端機並執行下列指令：

    pacman -S zip unzip patch diffutils git

    選用：如果您想透過 CMD 或 Powershell 使用 Bazel，但仍然可以使用 要使用 Bash 工具，請務必將 訊息張貼時間：MSYS2_INSTALL_PATH/usr/bin，分享對象： PATH 環境變數。

  • 2019 年 Visual Studio 建構工具

    您需要這項工具才能在 Windows 上建構 C++ 程式碼。

    也支援：

    • 搭載 Visual C++ 和 Windows 10 SDK 的 Visual Studio 2015 (或更新版本)

    • Visual C++ Build Tools 2015 (或更新版本) 和 Windows 10 SDK

  • Windows x64 適用的 Java SE Development Kit 11 (JDK)

    您需要這個工具才能在 Windows 上建構 Java 程式碼。

    也支援 Java 8、9 和 10

  • Windows x86-64 版 Python 3.6

    您需要使用這組憑證，才能在 Windows 上建構 Python 程式碼。

    也支援：Windows x86-64 的 Python 2.7 以上版本

疑難排解

Bazel 找不到 Bash 或 bash.exe

可能的原因：

  • 您已將 MSYS2 安裝在預設安裝路徑下

  • 您安裝的是 MSYS2 i686，而非 MSYS2 x86_64

  • 您安裝了 MSYS，而不是 MSYS2

解決方法：

確認您已安裝 MSYS2 x86_64。

如果還是無法解決問題，請採取下列做法：

  1. 前往 [開始] 功能表 >。

  2. 找出「編輯帳戶的環境變數」設定

  3. 查看頂端的清單 (「<username> 的使用者變數」)，然後按一下下方的「新增...」按鈕。

  4. 在「變數名稱」中輸入 BAZEL_SH

  5. 按一下 [瀏覽檔案...]。

  6. 前往 MSYS2 目錄，然後前往該目錄下方的 usr\bin。

    例如，這可能是系統中的 C:\msys64\usr\bin。

  7. 選取 bash.exe 或 bash 檔案，然後按一下「確定」

  8. 「變數值」欄位現在包含 bash.exe 的路徑。按一下「確定」關閉視窗。

  9. 。

    如果您現在開啟新的 cmd.exe 或 PowerShell 終端機並執行 Bazel，它會找到 Bash。

Bazel 找不到 Visual Studio 或 Visual C++

可能原因：

  • 您安裝了多個版本的 Visual Studio

  • 您安裝並移除多個 Visual Studio 版本

  • 您安裝了多個版本的 Windows SDK

  • 您安裝的 Visual Studio 並非位於預設安裝路徑下

解決方法：

  1. 前往 [開始] 功能表 >。

  2. 找出「編輯帳戶的環境變數」設定

  3. 查看頂端的清單 (「<使用者名稱> 的使用者變數」)，然後按一下 [新增...]。 按鈕。

  4. 在「變數名稱」中輸入 BAZEL_VC

  5. 按一下 [瀏覽目錄...]。

  6. 前往 Visual Studio 的 VC 目錄。

    例如，這可能是 C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC 。

  7. 選取 VC 資料夾，然後按一下「OK」

  8. 「變數值」欄位現在包含 VC 的路徑。按一下 [確定] 關閉視窗。

  9. 。

    如果您開啟新的 cmd.exe 或 PowerShell 終端機，現在執行 Bazel，便會找到 Visual C++。

安裝 Bazel 的其他方式

使用巧克力

  1. 安裝 Chocolatey 套件管理工具

  2. 安裝 Bazel 套件：

    choco install bazel

    這個指令會安裝最新可用的 Bazel 版本，以及相關的依附元件，例如 MSYS2 殼層。這項動作不會安裝 Visual C++ 不過，

請參閱巧克力安裝及維護保養 指南 巧克力糖套裝行程的資訊

使用 Scoop

  1. 使用下列 PowerShell 指令安裝 Scoop 套件管理工具：

    iex (new-object net.webclient).downloadstring('https://get.scoop.sh')

  2. 安裝 Bazel 套件：

    scoop install bazel

如要進一步瞭解 Scoop 套件，請參閱 Scoop 安裝和套件維護指南。

從原始碼開始建構

如要從頭開始建構 Bazel 而非安裝，請參閱「從來源編譯」一文。