Windows에 Bazel 설치

문제 신고 소스 보기

이 페이지에서는 Windows에 Bazel을 설치하기 위한 요구사항과 단계를 설명합니다. 또한 문제 해결 및 Bazel 설치 방법(예: Chocolatey 또는 Scoop)도 포함됩니다.

Bazel 설치

이 섹션에서는 기본 요건, 환경 설정, Windows 설치 중 세부 단계를 다룹니다.

시스템 확인하기

권장: 64비트 Windows 10, 버전 1703 (크리에이터 업데이트) 이상

Windows 버전을 확인하려면 다음 단계를 따르세요.

  • 시작 버튼을 클릭합니다.
  • 검색창에 winver를 입력하고 Enter 키를 누릅니다.
  • Windows 버전 정보가 포함된 Windows 정보 상자가 표시됩니다.

기본 요건 설치하기

Bazel 다운로드

권장: Bazelisk 사용

또는 다음과 같이 할 수 있습니다.

환경 설정

기본적으로 명령어 프롬프트 또는 PowerShell에서 Bazel에 쉽게 액세스할 수 있도록 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)가 포함되어 있습니다.

    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를 추가해야 합니다.

  • Visual Studio 2019용 빌드 도구

    Windows에서 C++ 코드를 빌드하는 데 필요합니다.

    추가로 지원되는 항목:

    • Visual C++ Build Tools 2017 이상 및 Windows 10 SDK

  • Windows x64용 자바 SE 개발 키트 11 (JDK)

    Windows에서 자바 코드를 빌드하는 데 필요합니다.

    지원: 자바 8, 9, 10

  • Windows x86-64용 Python 3.6

    Windows에서 Python 코드를 빌드하는 데 필요합니다.

    지원: Windows x86-64용 Python 2.7 이상

문제 해결

Bazel이 Bash 또는 bash.exe를 찾지 못합니다.

가능한 이유:

  • MSYS2를 기본 설치 경로에 설치하지 않은 경우

  • MSYS2 x86_64 대신 MSYS2 i686 설치

  • MSYS2 대신 MSYS를 설치했습니다.

솔루션:

MSYS2 x86_64를 설치했는지 확인합니다.

그래도 문제가 해결되지 않으면 다음 단계를 따르세요.

  1. 시작 메뉴 > 설정으로 이동합니다.

  2. '계정의 환경 변수 수정' 설정을 찾습니다.

  3. 상단의 목록('<username>의 사용자 변수')을 찾아 그 아래의 '새로 만들기...' 버튼을 클릭합니다.

  4. '변수 이름'에 BAZEL_SH을 입력합니다.

  5. '파일 찾아보기...'를 클릭합니다.

  6. MSYS2 디렉터리로 이동한 다음 아래의 usr\bin로 이동합니다.

    예를 들어 시스템의 C:\msys64\usr\bin일 수 있습니다.

  7. bash.exe 또는 bash 파일을 선택하고 'OK'를 클릭합니다.

  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. 상단의 목록('<username>의 사용자 변수')을 찾아 그 아래의 '새로 만들기...' 버튼을 클릭합니다.

  4. '변수 이름'에 BAZEL_VC을 입력합니다.

  5. '디렉터리 찾아보기...'를 클릭합니다.

  6. Visual Studio의 VC 디렉터리로 이동합니다.

    예를 들어 시스템의 C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC일 수 있습니다.

  7. VC 폴더를 선택하고 확인을 클릭합니다.

  8. 이제 '변수 값' 필드에 VC 경로가 포함됩니다. 확인을 클릭하여 창을 닫습니다.

  9. 완료되었습니다.

    새 cmd.exe 또는 PowerShell 터미널을 열고 Bazel을 지금 실행하면 Visual C++가 표시됩니다.

Bazel을 설치하는 다른 방법

초콜릿 사용하기

  1. Chocolatey 패키지 관리자 설치

  2. Bazel 패키지를 설치합니다.

    choco install bazel

    이 명령어는 Bazel의 최신 버전 및 종속 항목(예: MSYS2 셸)을 설치합니다. 그러나 Visual C++는 설치되지 않습니다.

Chocolatey 패키지에 대한 자세한 내용은 초콜릿 설치 및 패키지 유지관리 가이드를 참고하세요.

스쿠프 사용하기

  1. 다음 PowerShell 명령어를 사용하여 Scoop 패키지 관리자를 설치합니다.

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

  2. Bazel 패키지를 설치합니다.

    scoop install bazel

Scoop 패키지에 관한 자세한 내용은 Scoop 설치 및 패키지 유지보수 가이드를 참고하세요.

소스에서 빌드

Bazel을 설치하는 대신 처음부터 빌드하려면 소스에서 컴파일을 참조하세요.