本頁說明在 Windows 上安裝 Bazel 的規定與步驟。還包括疑難排解和其他安裝 Bazel 的方式,例如使用 Chocolatey 或 Scoop。
安裝 Bazel
本節說明在 Windows 上安裝的必要步驟、環境設定,以及安裝期間的詳細步驟。
檢查系統
建議:64 位元 Windows 10,1703 版 (創作者更新) 或以上版本
如何查看 Windows 版本:
- 按一下「開始」按鈕。
- 在搜尋框中輸入「
winver
」,然後按下 Enter 鍵。 - 畫面上應該會顯示「關於 Windows」方塊,其中顯示您的 Windows 版本資訊。
安裝必要條件
下載 Bazel
建議使用:使用 Bazelisk
您也可以採取以下做法:
- 從 GitHub 下載 Bazel 二進位檔 (
bazel-version-windows-x86_64.exe
)。 - 從 Chocolatey 安裝 Bazel
- 從 Scoop 安裝 Bazel
- 從原始碼建構 Bazel
設定環境
如要讓系統預設透過指令提示或 PowerShell 輕鬆存取 Bazel,您可以將 Bazel 二進位檔重新命名為 bazel.exe
,並將其新增至預設路徑。
set PATH=%PATH%;path to the Bazel binary
您也可以將系統 PATH
環境變數變更為永久性。瞭解如何設定環境變數。
完成
「成功:您已安裝 Bazel。」
如要檢查安裝是否正確,請嘗試執行以下程式碼:
bazel version
接下來,可參閱更多提示與指引:
安裝編譯器和語言執行階段
視您想建構的語言而定,您需要:
-
MSYS2 是 Windows 專用的軟體發行版本與建構平台。其中包含 Bash 和常見的 Unix 工具 (例如
grep
、tar
、git
)。您需要 MSYS2 才能建立、測試或執行依附 Bash 的目標。通常為
genrule
、sh_binary
和sh_test
,但可能會有更多 (例如 Starlark 規則)。如果建構目標需要 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
環境變數。-
你需要在 Windows 電腦上建立 C++ 程式碼。
也支援:
- Visual C++ Build Tools 2017 (或更新版本) 和 Windows 10 SDK
Windows x64 適用的 Java SE Development Kit 11 (JDK)
你需要在 Windows 電腦上建立 Java 程式碼。
同時支援:Java 8、9 和 10
-
您需要在 Windows 電腦上建立 Python 程式碼。
同時支援:Python 2.7 或更新版本 (Windows x86-64)
疑難排解
Bazel 找不到 Bash 或 bash.exe
可能原因:
您安裝的 MSYS2 不在預設安裝路徑底下
您安裝的是 MSYS2 i686,而不是 MSYS2 x86_64
已安裝 MSYS,而不是 MSYS2
解決方法:
請確認您已安裝 MSYS2 x86_64。
如果問題仍無法解決,請執行下列操作:
依序前往 [開始] 功能表 > [設定]。
找到「編輯帳戶的環境變數」設定
查看頂端的清單 (「<使用者名稱> 的使用者變數」),然後按一下下方的「新增...」按鈕。
在「變數名稱」中輸入
BAZEL_SH
。按一下「瀏覽檔案...」。
前往 MSYS2 目錄,然後移至該目錄下方的
usr\bin
。舉例來說,它可能是系統中的
C:\msys64\usr\bin
。選取
bash.exe
或bash
檔案,然後按一下「OK」。「變數值」欄位現在含有前往
bash.exe
的路徑。按一下 [確定] 關閉視窗。您完成了!
如果你開啟新的 cmd.exe 或 PowerShell 終端機,然後立即執行 Bazel,找到的 Bash 就會達成目標。
Bazel 找不到 Visual Studio 或 Visual C++
可能原因:
假設您安裝了多個版本的 Visual Studio
您安裝及移除了各種版本的 Visual Studio
您安裝多種版本的 Windows SDK
您安裝 Visual Studio 時不是預設安裝路徑
解決方法:
依序前往 [開始] 功能表 > [設定]。
找到「編輯帳戶的環境變數」設定
查看頂端的清單 (「<使用者名稱> 的使用者變數」),然後按一下下方的「新增...」按鈕。
在「變數名稱」中輸入
BAZEL_VC
。按一下「瀏覽目錄...」
前往 Visual Studio 的
VC
目錄。例如,可能是系統中的
C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC
。選取
VC
資料夾,然後按一下「OK」「變數值」欄位現在含有前往
VC
的路徑。按一下 [確定] 關閉視窗。您完成了!
如果你開啟新的 cmd.exe 或 PowerShell 終端機,然後立即執行 Bazel,找到的元件就會找到 Visual C++。
其他安裝 Bazel 的方式
使用巧克力
安裝 Chocolatey 套件管理員
安裝 Bazel 套件:
choco install bazel
這個指令會安裝最新可用的 Bazel 版本及其依附元件,例如 MSYS2 殼層。但無法安裝 Visual C++。
如要進一步瞭解 Chocolatey 套件,請參閱 Chocolatey 安裝及套件維護指南。
使用 Scoop
使用下列 PowerShell 指令安裝 Scoop 套件管理員:
iex (new-object net.webclient).downloadstring('https://get.scoop.sh')
安裝 Bazel 套件:
scoop install bazel
如要進一步瞭解 Scoop 套件,請參閱 Scoop 安裝及套件維護指南。
從原始碼開始建構
如果您要從頭開始建構 Bazel,而非安裝,請參閱「從原始碼編譯」。