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용 Java SE 개발 키트 11 (JDK)

    Windows에서 Java 코드를 빌드할 때 필요합니다.

    또한 자바 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. 상단의 목록 ('<사용자 이름>의 사용자 변수')을 확인하고 아래에 있는 '새로 만들기...' 버튼을 클릭합니다.

  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. 상단의 목록 ('<사용자 이름>의 사용자 변수')을 확인하고 아래에 있는 '새로 만들기...' 버튼을 클릭합니다.

  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++는 설치되지 않습니다.

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

Scoop 사용

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

    iex (new-object net.webclient).downloadstring('https://get.scoop.sh')
    
  2. Bazel 패키지를 설치합니다.

    scoop install bazel
    

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

소스에서 빌드

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