이 페이지에서는 Windows에 Bazel을 설치하기 위한 요구사항과 단계를 설명합니다. 또한 Chocolatey 또는 Scoop을 사용하는 등 Bazel을 설치하는 문제 해결 및 기타 방법도 포함되어 있습니다.
Bazel 설치
이 섹션에서는 Windows에 설치하는 동안의 기본 요건, 환경 설정, 자세한 단계를 다룹니다.
시스템 확인
권장: 64비트 Windows 10, 버전 1703 (Creators Update) 이상
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
)가 포함됩니다.Bash에 종속된 타겟을 빌드하거나 테스트하거나 실행하려면 MSYS2가 필요합니다. 일반적으로
genrule
,sh_binary
,sh_test
이지만 더 있을 수도 있습니다 (예: Starlark 규칙). 빌드 대상에 Bash가 필요하지만 Bazel에서 이를 찾을 수 없는 경우 Bazel에 오류가 표시됩니다. 일반적인 MSYS2 패키지
Bash에 종속된 타겟을 빌드하고 실행하는 데 필요할 수 있습니다. MSYS2는 기본적으로 이러한 도구를 설치하지 않으므로 수동으로 설치해야 합니다.
PATH
의 Bash 도구를 사용하는 프로젝트 (예: TensorFlow)에는 이 단계가 필요합니다.MSYS2 터미널을 열고 다음 명령어를 실행합니다.
pacman -S zip unzip patch diffutils git
선택사항: CMD 또는 Powershell에서 Bazel을 사용하면서도 Bash 도구를 사용하려면
PATH
환경 변수에MSYS2_INSTALL_PATH/usr/bin
을 추가해야 합니다.-
Windows에서 C++ 코드를 빌드하려면 이 도구가 필요합니다.
지원되는 항목:
- Visual C++ Build Tools 2017 이상 및 Windows 10 SDK
Windows x64용 Java SE 개발 키트 11 (JDK)
Windows에서 Java 코드를 빌드하는 데 필요합니다.
Java 8, 9, 10도 지원됩니다.
-
Windows에서 Python 코드를 빌드하는 데 필요합니다.
Windows x86-64용 Python 2.7 이상도 지원됩니다.
문제 해결
Bazel에서 Bash 또는 bash.exe를 찾지 못함
가능한 이유:
기본 설치 경로가 아닌 다른 경로에 MSYS2를 설치한 경우
MSYS2 x86_64 대신 MSYS2 i686을 설치한 경우
MSYS2 대신 MSYS를 설치한 경우
해결 방법:
MSYS2 x86_64를 설치했는지 확인합니다.
그래도 문제가 해결되지 않으면 다음 단계를 따르세요.
시작 메뉴 > 설정으로 이동합니다.
'계정의 환경 변수 수정' 설정을 찾습니다.
상단의 목록 ('<username>의 사용자 변수')을 확인하고 아래의 '새로 만들기...' 버튼을 클릭합니다.
'변수 이름'에
BAZEL_SH
를 입력합니다.'파일 찾아보기'를 클릭합니다.
MSYS2 디렉터리로 이동한 후 그 아래에 있는
usr\bin
로 이동합니다.예를 들어 시스템에서
C:\msys64\usr\bin
일 수 있습니다.bash.exe
또는bash
파일을 선택하고 확인을 클릭합니다.이제 '변수 값' 필드에
bash.exe
경로가 표시됩니다. 확인을 클릭하여 창을 닫습니다.완료되었습니다.
이제 새 cmd.exe 또는 PowerShell 터미널을 열고 Bazel을 실행하면 Bash가 표시됩니다.
Bazel에서 Visual Studio 또는 Visual C++를 찾지 못함
가능한 이유:
Visual Studio의 여러 버전을 설치한 경우
다양한 버전의 Visual Studio를 설치하고 삭제한 경우
여러 버전의 Windows SDK를 설치한 경우
Visual Studio를 기본 설치 경로가 아닌 다른 경로에 설치한 경우
해결 방법:
시작 메뉴 > 설정으로 이동합니다.
'계정의 환경 변수 수정' 설정을 찾습니다.
상단의 목록 ('<username>의 사용자 변수')을 확인하고 아래의 '새로 만들기...' 버튼을 클릭합니다.
'변수 이름'에
BAZEL_VC
를 입력합니다.'디렉터리 찾아보기...'를 클릭합니다.
Visual Studio의
VC
디렉터리로 이동합니다.예를 들어 시스템에서
C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC
일 수 있습니다.VC
폴더를 선택하고 확인을 클릭합니다.이제 '변수 값' 필드에
VC
경로가 표시됩니다. 확인을 클릭하여 창을 닫습니다.완료되었습니다.
새 cmd.exe 또는 PowerShell 터미널을 열고 지금 Bazel을 실행하면 Visual C++이 표시됩니다.
Bazel을 설치하는 다른 방법
Chocolatey 사용
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을 빌드하려면 소스에서 컴파일을 참고하세요.