Make Variables

mapfile SRCS <<< "$$(sed -e 's/ /\\n/g' <<'genrule_srcs_expansion'
$(SRC)
genrule_srcs_expansion
)
을 작성한 후 후속 명령어 줄에서 "$$\{SRCS[@]}"를 
대신 $(SRCS) 사용합니다. 더 강력한 옵션은 대신 Starlark 규칙을 작성하는 것입니다.



사전 정의된 소스/출력 경로 변수

  사전 정의된 변수 execpath, execpaths,
  rootpath, rootpaths, location, 및
  locations는 라벨 매개변수 (예: $(execpath
  //foo:bar))를 사용하고 해당 라벨로 표시된 파일 경로를 대체합니다.



  소스 파일의 경우 이는 작업공간 루트를 기준으로 하는 경로입니다.
  규칙의 출력인 파일의 경우 이는 파일의 출력 경로
 입니다(아래의 출력 파일 설명 참고).



  사전 정의된 경로 변수의 예를 참고하세요.


  

    

      execpath:  Bazel이 빌드 작업을 실행하는 

      execroot
    아래의 경로를 나타냅니다.
    
    

      위의 예에서 Bazel은 작업공간 루트의 bazel-myproject 심볼릭 링크로 연결된 디렉터리에서 모든 빌드 작업을 실행합니다. 소스 파일 empty.source는 bazel-myproject/testapp/empty.source 경로에 연결됩니다. 따라서 실행 경로 (루트 아래의 하위 경로)는 testapp/empty.source입니다. 이는 빌드 작업에서 파일을 찾는 데 사용할 수 있는 경로입니다.
    
    

      출력 파일은 비슷하게 스테이징되지만 하위 경로
      bazel-out/cpu-compilation_mode/bin(또는 도구의 출력인 경우
      bazel-out/cpu-opt-exec-hash/bin)으로도 시작됩니다. 위의 예에서
      //testapp:app은(는) 
      show_app_output's tools 속성에 표시되므로 도구입니다.
      따라서 출력 파일 app은 
      bazel-myproject/bazel-out/cpu-opt-exec-hash/bin/testapp/app에 작성됩니다.
      따라서 실행 경로는 
      bazel-out/cpu-opt-exec-hash/bin/testapp/app입니다. 이 추가 접두어
를 사용하면 결과가 서로 겹치지 않고 동일한 빌드에서 예를 들어 두 개의 서로 다른 CPU에 대해 동일한 타겟을 빌드할 수 있습니다.
    
    

      이 변수에 전달된 라벨은 정확히 하나의 파일을 나타내야 합니다. 소스 파일을 나타내는 라벨의 경우 이는 자동으로 true입니다. 규칙을 나타내는 라벨의 경우 규칙은 정확히 하나의 출력을 생성해야 합니다. false이거나 라벨의 형식이 잘못된 경우 빌드가 오류와 함께 실패합니다.
    
  

  

    

      rootpath: 빌드된 바이너리가 런타임에 기본 저장소에 해당하는 runfiles 디렉터리의 하위 디렉터리를 기준으로 종속 항목을 찾는 데 사용할 수 있는 경로를 나타냅니다.
      참고: 이는 
      --enable_runfiles가 사용 설정된 경우에만 작동하며, Windows에서는 기본적으로 사용 설정되지 않습니다. 교차 플랫폼 지원을 위해 대신 rlocationpath를 사용하세요.
    

      이는 execpath와 비슷하지만 위에 설명된 구성 접두어를 삭제합니다. 위의 예에서 이는
      empty.source와 app 모두 순수한 작업공간 상대
      경로(testapp/empty.source 및 testapp/app)를 사용한다는 의미입니다.
    
    

      외부 저장소
      repo에 있는 파일의 rootpath는 ../repo/로 시작하고 그 뒤에 저장소 상대 경로가 옵니다.
    
    

      이는 execpath와 동일한 "하나의 출력만" 요구사항을 갖습니다.
    
  

  

    

      rlocationpath: 빌드된 바이너리가 runfiles 디렉터리 (사용 가능한 경우) 또는 runfiles 매니페스트를 사용하여 런타임에 종속 항목을 찾기 위해 runfiles 라이브러리의 
      Rlocation 함수에 전달할 수 있는 경로입니다.
    
    

      이는 rootpath와 비슷하지만 구성 접두어를 포함하지 않는다는 점에서 항상 저장소 이름으로 시작한다는 점에서 다릅니다. 위의 예에서 이는 
      empty.source와 app이 다음
 경로를 생성한다는 의미입니다. myproject/testapp/empty.source 및 
      myproject/testapp/app.
    
    

      외부 저장소
      repo에 있는 파일의 rlocationpath는 repo/로 시작하고 그 뒤에 저장소 상대 경로가 옵니다.
    
    

      이 경로를 바이너리에 전달하고
 runfiles 라이브러리를 사용하여 파일 시스템 경로로 확인하는 것이 런타임에 종속 항목을 찾는 기본 접근 방식입니다. rootpath와 비교했을 때 모든 플랫폼에서 작동하고 runfiles 디렉터리를 사용할 수 없는 경우에도 작동한다는 장점이 있습니다.
    
    

      이는 execpath와 동일한 "하나의 출력만" 요구사항을 갖습니다.
    
  

  

    location: 확장되는 속성에 따라 execpath 또는
 rootpath의 동의어입니다. 이는
 레거시 사전 Starlark 동작이며 특정 규칙에 대해 어떤 작업을 하는지 정말로 알고 있지 않는 한 권장되지 않습니다. 자세한 내용은 #2475
를 참고하세요.
  



  execpaths, rootpaths, rlocationpaths,
  및 locations는 각각 execpath,
  rootpath, rlocationpath, 및location,
 의 복수형 변형입니다. 여러 출력을 생성하는 라벨을 지원하며, 이 경우
 각 출력은 공백으로 구분되어 나열됩니다. 출력이 없는 규칙과 형식이 잘못된
 라벨은 빌드 오류를 생성합니다.



  참조된 모든 라벨은 사용하는 타겟의 srcs,
  출력 파일 또는 deps에 표시되어야 합니다. 그렇지 않으면 빌드가 실패합니다. C++ 타겟은
 data의 라벨도 참조할 수 있습니다.



  라벨은 정규 형식일 필요가 없습니다. foo, :foo
 및 //somepkg:foo는 모두 괜찮습니다.


맞춤 변수


  맞춤 "Make" 변수는 
 "Make 변수" 대체 대상"으로 표시된 모든 속성에서 참조할 수 있지만 이러한 변수를 정의하는 다른 타겟에 종속된 타겟에서만 참조할 수 있습니다.



  Bazel 코어에 변수를 포함할 만한 정말 좋은
 이유가 없다면 모든 변수는 맞춤 변수여야 합니다. 이렇게 하면 Bazel이 변수를 제공하기 위해
 잠재적으로 비용이 많이 드는 종속 항목을 로드할 필요가 없으며, 변수를 사용하는 타겟은
 신경 쓰지 않을 수 있습니다.


C++ 도구 모음 변수

  다음은 C++ 도구 모음 규칙에 정의되어 있으며 
을 설정하는 모든 규칙에서 사용할 수 있습니다. toolchains =
  ["@bazel_tools//tools/cpp:toolchain_type"]
 java_binary와 같은 일부 규칙은 규칙 정의에 C++ 도구 모음을 암시적으로
 포함합니다. 이러한 변수를
 자동으로 상속합니다.



  기본 제공 C++ 규칙은 "컴파일러를 실행
하는 것보다 훨씬 정교합니다. 여러 플랫폼에서 빠른 테스트를 실행하는 동시에 *SAN, ThinLTO,
 모듈 포함/제외, 신중하게 최적화된 바이너리와 같은 다양한 컴파일 모드를 지원하기 위해 기본 제공 규칙은 잠재적으로 여러 내부적으로 생성된 작업 각각에 올바른 입력, 출력, 명령어 줄 플래그가 설정되도록 많은 노력을 기울입니다.



  이러한 변수는 드물게 언어 전문가가 사용하는 대체 메커니즘입니다. 이러한 변수를 사용하고 싶다면 먼저 Bazel 개발팀에 문의하세요.



  
ABI: C++ ABI 버전입니다. 

  
 AR: crosstool의 "ar" 명령어입니다. 
  
 C_COMPILER: C/C++ 컴파일러 식별자입니다(예: llvm).
  
  

    
CC: C 및 C++ 컴파일러 명령어입니다.
    

      CC와 함께 항상 CC_FLAGS를 사용하는 것이 좋습니다. 이렇게 하지 않으면 위험을 감수해야 합니다.
    
  
  
CC_FLAGS: genrule에서 사용할 수 있는 C/C++
 컴파일러의 최소 플래그 집합입니다. 특히 
 올바른 아키텍처를 선택하는 플래그가 포함되어 있습니다. CC 여러 
 아키텍처를 지원하는 경우
  


  
 DUMPBIN: Microsoft Visual Studio의 Microsoft COFF 바이너리 파일 덤퍼 (dumpbin.exe)입니다. 

  
 NM: crosstool의 "nm" 명령어입니다. 
  
 OBJCOPY: C/C++
 컴파일러와 동일한 제품군의 objcopy 명령어입니다. 

  
 STRIP: C/C++
 컴파일러와 동일한 제품군의 strip 명령어입니다.


Java 도구 모음 변수


  다음은 Java 도구 모음 규칙에 정의되어 있으며 
 toolchains =
["@rules_java//toolchains:current_java_runtime"]을 설정하는 모든 규칙에서 사용할 수 있습니다 (또는
 "@rules_java//toolchains:current_host_java_runtime"
 호스트 도구 모음과 동일한 경우).



  JDK의 대부분의 도구는 직접 사용해서는 안 됩니다. 기본 제공 Java
 규칙은 인터페이스 Jar, 헤더 인터페이스
 Jar, 고도로 최적화된 Jar 패키징 및 병합 구현과 같이 업스트림 도구가 표현할 수 있는 것보다 훨씬 정교한 Java 컴파일 및 패키징
 접근 방식을 사용합니다.



  이러한 변수는 드물게 언어 전문가가 사용하는 대체 메커니즘입니다. 이러한 변수를 사용하고 싶다면 먼저 Bazel 개발팀에 문의하세요.



  
 JAVA: 'java' 명령어 (Java 가상
 머신)입니다. 가능한 경우 이 명령어를 사용하지 말고 대신 java_binary 규칙
을 사용하세요. 상대 경로일 수 있습니다. `java`를 호출하기 전에 디렉터리를 변경해야 하는 경우 변경하기 전에 작업 디렉터리를 캡처해야 합니다.java
  

  
JAVABASE: Java 유틸리티가 포함된 기본 디렉터리입니다. 상대 경로일 수 있습니다. 'bin'
 하위 디렉터리가 있습니다.
  


Starlark 정의 변수


  규칙 및 도구 모음 작성자는 
 완전히 맞춤 변수를 정의할 수 있습니다. 
 TemplateVariableInfo
 제공자를 반환하여 
 속성을 통해 이러한 변수에 종속된 모든 규칙은 값을 읽을 수 있습니다.toolchains



  Starlark 정의 변수의 예를 참고하세요.