일반적인 정의

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

이 섹션에서는 여러 함수 또는 빌드 규칙에 공통적인 다양한 용어와 개념을 정의합니다.

콘텐츠

본 셸 토큰화

일부 규칙의 특정 문자열 속성은 Bourne 셸의 토큰화 규칙에 따라 여러 단어로 분할됩니다. 따옴표로 묶이지 않은 공백은 별도의 단어를 구분하며 작은따옴표와 큰따옴표 문자 및 백슬래시는 토큰화를 방지합니다.

이 토큰화가 적용되는 속성은 이 문서의 정의에 따라 다음과 같이 명시적으로 표시됩니다.

변수 확장 및 본 셸 토큰화가 적용되는 속성은 일반적으로 컴파일러 및 기타 도구에 임의의 옵션을 전달하는 데 사용됩니다. 이러한 속성의 예로는 cc_library.coptsjava_library.javacopts가 있습니다. 이러한 대체 항목을 함께 사용하면 단일 문자열 변수를 구성별 옵션 단어 목록으로 확장할 수 있습니다.

라벨 확장

극히 일부 규칙의 일부 문자열 속성에는 라벨 확장이 적용됩니다. 문자열에 유효한 문자열이 하위 문자열(예: //mypkg:target)로 포함되어 있고 이 라벨이 현재 규칙의 선언된 전제 조건인 경우 타겟 //mypkg:target으로 표현되는 파일의 경로 이름으로 확장됩니다.

속성의 예로는 genrule.cmdcc_binary.linkopts가 있습니다. 상대적 라벨 확장 여부, 여러 파일로 확장되는 라벨의 취급 방식 등 문제에 따라 세부정보는 크게 달라질 수 있습니다. 구체적인 내용은 규칙 속성 문서를 참조하세요.

대부분의 빌드 규칙에서 정의한 일반적인 속성

이 섹션에서는 여러 빌드 규칙에 의해 정의되는 속성을 설명합니다. 전부는 아닙니다.

속성 설명
data

List of labels ; optional

런타임 시 이 규칙에 필요한 파일입니다. 파일 또는 규칙 타겟을 나열할 수 있습니다. 일반적으로 모든 대상이 허용됩니다.

data 속성에 있는 타겟의 기본 출력 및 실행 파일은 이 타겟에 의해 출력되거나 런타임 종속 항목이 있는 실행 파일의 *.runfiles 영역에 표시되어야 합니다. 여기에는 이 타겟의 srcs가 실행될 때 사용되는 데이터 파일 또는 바이너리가 포함될 수 있습니다. 데이터 파일을 사용 및 사용하는 방법에 대한 자세한 내용은 데이터 종속 항목 섹션을 참조하세요.

새 규칙은 런타임에 다른 입력을 사용할 수 있는 입력을 처리하는 경우 data 속성을 정의해야 합니다. 또한 규칙 구현 함수는 data 속성의 출력 및 실행 파일에서 대상 실행 파일을 실행하며 소스 코드나 런타임 종속 항목을 제공하는 종속 항목 속성에서 실행 파일도 채워야 합니다.

deps

List of labels ; optional

이 타겟의 종속 항목입니다. 일반적으로 규칙 타겟만 나열해야 합니다. 일부 규칙에서는 deps에 파일을 직접 나열할 수 있지만 가능한 한 피해야 합니다.

언어별 규칙은 일반적으로 나열된 대상을 특정 제공업체가 있는 대상으로 제한합니다.

대상이 deps를 사용하여 다른 타겟에 종속된다는 것의 정확한 의미 체계는 규칙 종류에 따라 다르며 규칙별 문서에서 자세히 설명합니다. 소스 코드를 처리하는 규칙의 경우 deps는 일반적으로 srcs의 코드에서 사용하는 코드 종속 항목을 지정합니다.

대부분의 경우 deps 종속 항목은 한 모듈이 동일한 프로그래밍 언어로 작성되고 별도로 컴파일된 다른 모듈에 정의된 기호를 사용하도록 허용하는 데 사용됩니다. 여러 언어 종속 항목도 허용됩니다. 예를 들어 java_library 대상은 cc_library 대상의 C++ 코드에 종속될 수 있습니다. 후자의 경우 deps 속성에 나열하세요. 자세한 내용은 종속 항목의 정의를 참조하세요.

licenses

List of strings; optional; nonconfigurable

이 특정 타겟에 사용할 라이선스 유형 문자열 목록입니다. 지원 중단된 라이선싱 API의 일부이며 Bazel이 더 이상 사용하지 않습니다. 사용하지 마세요.

srcs

List of labels ; optional

이 규칙으로 처리되거나 포함된 파일입니다. 일반적으로 파일을 직접 나열하지만 filegroup 또는 genrule과 같은 규칙 대상을 나열하여 기본 출력을 포함할 수 있습니다.

언어별 규칙을 사용하려면 나열된 파일에 특정 파일 확장자가 있어야 하는 경우가 많습니다.

모든 빌드 규칙에 공통으로 적용되는 속성

이 섹션에서는 모든 빌드 규칙에 암시적으로 추가되는 속성을 설명합니다.

속성 설명
compatible_with

List of labels ; optional; nonconfigurable

기본적으로 지원되는 환경 외에 이 대상을 빌드할 수 있는 환경의 목록입니다.

이는 Bazel의 제약 조건 시스템의 일부로서, 사용자가 서로 종속될 수 있는 타겟과 허용되지 않는 타겟을 선언할 수 있게 해 줍니다. 예를 들어 외부에서 배포 가능한 바이너리는 회사 보안 비밀 코드가 있는 라이브러리에 종속되면 안 됩니다. 자세한 내용은 ConstraintSemantics를 참고하세요.

deprecation

String; optional; nonconfigurable

이 대상과 관련된 설명 경고 메시지입니다. 일반적으로 대상이 지원 중단되었거나 다른 규칙으로 대체되었거나 패키지에 비공개이거나 어떤 이유로 유해한 것으로 간주될 수 있음을 사용자에게 알리는 데 사용됩니다. 웹페이지, 버그 번호, 이전 CL 등의 참조를 포함하여 메시지를 피하는 데 필요한 변경사항을 쉽게 파악할 수 있도록 하는 것이 좋습니다. 대체 중단으로 사용할 수 있는 새 대상이 있는 경우 기존 대상의 모든 사용자를 이전하는 것이 좋습니다.

이 속성은 항목이 빌드되는 방식에 영향을 미치지 않지만 빌드 도구의 진단 출력에 영향을 미칠 수 있습니다. 빌드 도구는 deprecation 속성이 있는 규칙이 다른 패키지의 타겟에 종속되면 경고를 표시합니다.

패키지 내부 종속 항목은 이 경고에서 제외되므로, 예를 들어 지원 중단된 규칙의 테스트를 빌드해도 경고가 발생하지 않습니다.

지원 중단된 대상이 지원 중단된 다른 대상에 종속되는 경우 경고 메시지가 표시되지 않습니다.

사용자가 사용을 중단하면 대상을 삭제할 수 있습니다.

distribs

List of strings; optional; nonconfigurable

이 특정 대상에 사용할 배포 방법 문자열의 목록입니다. 지원 중단된 라이선싱 API의 일부이며 Bazel이 더 이상 사용하지 않습니다. 사용하지 마세요.

exec_compatible_with

List of labels ; optional; nonconfigurable

이 타겟의 실행 플랫폼에 있어야 하는 constraint_values 목록입니다. 이는 규칙 유형에 의해 이미 설정된 제약 조건 외에 추가로 적용됩니다. 제약조건은 사용 가능한 실행 플랫폼 목록을 제한하는 데 사용됩니다. 자세한 내용은 도구 모음 해상도 설명을 참고하세요.

exec_properties

Dictionary of strings; optional

이 타겟에 대해 선택된 플랫폼의 exec_properties에 추가될 문자열 사전입니다. 플랫폼 규칙의 exec_properties을 참고하세요.

키가 플랫폼 및 대상 수준 속성에 모두 있는 경우 값은 대상에서 가져옵니다.

features

List of feature strings; optional

기능은 타겟에서 사용 설정 또는 사용 중지할 수 있는 문자열 태그입니다. 특성의 의미는 규칙 자체에 따라 달라집니다.

features 속성은 패키지 수준 features 속성과 결합됩니다. 예를 들어 패키지 수준에서 ['>' 특성을 사용 설정하고 대상의 features 속성에 [&a];, [c];을 포함하면 규칙에 사용 설정된 특성은 'b' 및 'quot;'입니다. 예 보기

restricted_to

List of labels ; optional; nonconfigurable

기본적으로 지원되는 환경 대신 이 대상을 빌드할 수 있는 환경 목록

Bazel 제약조건 시스템의 일부입니다. 자세한 내용은 compatible_with를 참고하세요.

tags

List of strings; optional; nonconfigurable

태그는 모든 규칙에 사용할 수 있습니다. 테스트 및 test_suite 규칙의 태그는 테스트를 분류하는 데 유용합니다. 비테스트 타겟의 태그genruleStarlark 작업의 샌드박스 실행을 제어하고 인간 및 외부 도구에 의한 파싱에 사용됩니다.

Bazel이 테스트 또는 genrule 대상의 tags 속성 또는 Starlark 작업의 execution_requirements 키에 있는 다음 키워드를 발견하면 샌드박스 코드의 동작을 수정합니다.

  • no-sandbox 키워드로 인해 작업 또는 테스트가 샌드박스화되지 않습니다. 여전히 캐시되거나 원격으로 실행될 수 있습니다. no-cache 또는 no-remote을 사용하여 둘 중 하나 또는 둘 다를 방지합니다.
  • no-cache 키워드로 인해 작업 또는 테스트가 캐시되지 않음 (원격 또는 로컬)
  • no-remote-cache 키워드를 사용하면 작업이나 테스트가 원격으로 캐시되지 않습니다. 그러나 로컬에서 캐시될 수 있으며 원격으로 실행될 수도 있습니다. 참고: 이 태그에서는 디스크 캐시가 로컬 캐시로 간주되는 반면 http 및 gRPC 캐시는 원격으로 간주됩니다. 결합된 캐시가 지정되면 (즉, 로컬 및 원격 구성요소가 있는 캐시) --incompatible_remote_results_ignore_disk가 설정된 경우가 아니면 로컬 캐시가 원격 캐시로 취급되고 완전히 사용 중지됩니다. 이 경우 로컬 구성요소가 사용됩니다.
  • no-remote-exec 키워드를 사용하면 작업이나 테스트가 원격으로 실행되지 않지만 원격으로 캐시될 수 있습니다.
  • no-remote 키워드를 사용하면 작업 또는 테스트가 원격으로 실행되거나 원격으로 캐시되지 않습니다. no-remote-cacheno-remote-exec을 모두 사용하는 것과 같습니다.
  • no-remote-cache-upload 키워드는 생성한 원격 원격 업로드 부분을 사용 중지합니다. 원격 실행이 중지되지는 않습니다.
  • local 키워드를 사용하면 작업 또는 테스트가 원격으로 캐시되거나 원격으로 실행되거나 샌드박스 내부에서 실행되지 않습니다. genrule 및 test의 경우 규칙을 local = True 속성으로 표시하면 효과가 동일합니다.
  • requires-network 키워드를 사용하면 샌드박스 내부에서 외부 네트워크에 액세스할 수 있습니다. 이 태그는 샌드박스가 사용 설정된 경우에만 효과가 있습니다.
  • block-network 키워드는 샌드박스 내부에서 외부 네트워크에 대한 액세스를 차단합니다. 이 경우 localhost와의 통신만 허용됩니다. 이 태그는 샌드박스가 사용 설정된 경우에만 효과가 있습니다.
  • requires-fakeroot는 테스트 또는 작업을 uid 및 0 0 (즉, 루트 사용자)으로 실행합니다. Linux에서만 지원됩니다. 이 태그는 --sandbox_fake_username 명령줄 옵션보다 우선 적용됩니다.

테스트의 태그는 일반적으로 디버그 및 출시 프로세스에서 테스트의 역할에 주석을 다는 데 사용됩니다. 일반적으로 태그는 런타임 주석 기능이 없는 C++ 및 Python 테스트에 가장 유용합니다. 태그 및 크기 요소를 사용하면 코드베이스 체크인 정책을 기반으로 테스트 모음을 유연하게 구성할 수 있습니다.

Bazel이 테스트 규칙의 tags 속성에서 다음 키워드를 발견하면 테스트 실행 동작을 수정합니다.

  • exclusive는 테스트가 '배타적' 모드에서 강제 실행되도록 하여 다른 테스트가 동시에 실행되지 않도록 합니다. 이러한 테스트는 모든 빌드 활동 및 비배타적 테스트가 완료된 후 순차적으로 실행됩니다. Bazel은 원격 머신에서 어떤 항목이 실행되는지 제어할 수 없기 때문에 이러한 테스트에서는 원격 실행이 사용 중지됩니다.
  • exclusive-if-local는 로컬에서 실행되는 경우 테스트를 '배타적' 모드에서 강제 실행하지만, 원격에서 실행할 경우 테스트를 동시에 실행합니다.
  • manual 키워드는 build, test, coverage 명령어에서 빌드/실행할 최상위 타겟 집합을 계산할 때 테스트를 명시적으로 나열하지 않는 대상 패턴 와일드 카드(..., :*, :all 등) 및 test_suite 규칙의 확장에서 대상을 제외합니다. query 명령어를 비롯한 다른 컨텍스트에서는 타겟 와일드 카드 또는 테스트 모음 확장에 영향을 미치지 않습니다. manual는 지속적으로 빌드/테스트 시스템에서 타겟을 자동으로 빌드/실행해서는 안 된다는 것을 의미하지 않습니다. 예를 들어 특정 Bazel 플래그가 필요하지만 올바르게 구성된 사전 제출 또는 연속 테스트 실행에는 여전히 포함되어 있기 때문에 bazel test ...에서 대상을 제외하는 것이 바람직할 수 있습니다.
  • external 키워드는 --cache_test_results 값과 관계없이 테스트가 무조건 실행되도록 강제합니다.
테스트 대상에 연결된 태그에 관한 자세한 규칙은 테스트 백과사전의 태그 규칙을 참고하세요.
target_compatible_with

List of labels ; optional

이 타겟이 호환되는 것으로 간주되려면 타겟 플랫폼에 있어야 하는 constraint_value 목록입니다. 이는 규칙 유형에 의해 이미 설정된 제약 조건 외에 추가로 적용됩니다. 타겟 플랫폼이 나열된 제약 조건을 모두 충족하지 않으면 타겟은 호환되지 않는 것으로 간주됩니다. 대상 패턴이 확장되면 빌드 및 테스트를 위해 호환되지 않는 대상을 건너뜁니다(예: //..., :all). 명령줄에 명시적으로 지정된 경우, 호환되지 않는 대상으로 인해 Bazel이 오류를 출력하고 빌드 또는 테스트 실패를 일으킵니다.

호환되지 않는 타겟에 전이적으로 종속되는 타겟은 호환되지 않는 것으로 간주됩니다. 빌드 및 테스트에서도 건너뜁니다.

빈 목록 (기본값)은 대상이 모든 플랫폼과 호환됨을 나타냅니다.

작업공간 규칙을 제외한 모든 규칙은 이 속성을 지원합니다. 일부 규칙의 경우 이 속성이 적용되지 않습니다. 예를 들어 cc_toolchaintarget_compatible_with를 지정하면 유용하지 않습니다.

호환되지 않는 타겟 건너뛰기에 관한 자세한 내용은 플랫폼 페이지를 참고하세요.

testonly

Boolean; optional; default False except for test and test suite targets; nonconfigurable

참인 경우 테스트 전용 타겟 (예: 테스트)만 이 타겟에 의존할 수 있습니다.

따라서 testonly가 아닌 규칙은 testonly인 규칙에 종속될 수 없습니다.

테스트 (*_test 규칙) 및 테스트 모음 (test_suite 규칙)은 기본적으로 testonly입니다.

이 속성은 프로덕션에 출시되는 바이너리에 타겟이 포함되어서는 안 된다는 것을 의미합니다.

테스트 전용은 런타임이 아닌 빌드 시간에 시행되고 종속 항목 트리를 통해 바이러스로 전파되므로 신중하게 적용되어야 합니다. 예를 들어 단위 테스트에 유용한 스텁 및 페이크는 프로덕션에 출시할 동일한 바이너리를 포함하는 통합 테스트에도 유용할 수 있으므로 테스트 전용으로 표시하면 안 됩니다. 반대로, 연결하는 것이 위험한 위험은 무조건 정상적인 동작을 재정의하므로 규칙을 테스트 전용으로 표시해야 합니다.

toolchains

List of labels ; optional; nonconfigurable

이 대상이 변수 만들기에서 액세스할 수 있는 대상 집합입니다. 이러한 대상은 TemplateVariableInfo를 제공하는 규칙의 인스턴스이거나 Bazel에 내장된 도구 모음 유형에 대한 특수 대상입니다. 예를 들면 다음과 같습니다.

  • @bazel_tools//tools/cpp:current_cc_toolchain
  • @bazel_tools//tools/jdk:current_java_runtime

이는 플랫폼 종속 항목 구성을 위한 규칙 구현에서 사용되는 도구 모음 해상도와는 다릅니다. 이 속성을 사용하여 대상이 사용할 특정 cc_toolchain 또는 java_toolchain를 결정할 수 없습니다.

visibility

List of labels ; optional; default default_visibility from package if specified, or //visibility:private otherwise; nonconfigurable

대상의 visibility 속성은 다른 패키지에서 대상을 사용할 수 있는지 여부를 제어합니다. 공개 상태 문서를 참고하세요.

모든 테스트 규칙에 공통으로 적용되는 속성 (*_test)

이 섹션에서는 모든 테스트 규칙에 공통으로 적용되는 속성을 설명합니다.

속성 설명
args

List of strings; optional; subject to $(location) and "Make variable" substitution, and Bourne shell tokenization

Bazel이 bazel test을 사용하여 실행될 때 대상으로 전달하는 명령줄 인수입니다.

이러한 인수는 bazel test 명령줄에 지정된 --test_arg 값 앞에 전달됩니다.

env

Dictionary of strings; optional; values are subject to $(location) and "Make variable" substitution

bazel test로 테스트를 실행할 때 설정할 추가 환경 변수를 지정합니다.

이 속성은 cc_test, py_test, sh_test와 같은 네이티브 규칙에만 적용됩니다. Starlark에서 정의한 테스트 규칙에는 적용되지 않습니다. 자체 Starlark 규칙의 경우 "env" 속성을 추가하고 이 속성을 사용하여 TestEnvironment 제공업체를 채울 수 있습니다.

env_inherit

List of strings; optional

bazel test로 테스트를 실행할 때 외부 환경에서 상속할 추가 환경 변수를 지정합니다.

이 속성은 cc_test, py_test, sh_test와 같은 네이티브 규칙에만 적용됩니다. Starlark에서 정의한 테스트 규칙에는 적용되지 않습니다.

size

String "enormous", "large" "medium" or "small", default is "medium"; optional; nonconfigurable

테스트 대상(실행 시간/리소스)을 지정합니다.

단위 테스트는 '소형', 통합 테스트', '대형', '대형' 또는 '대규모'로 간주됩니다. Bazel은 크기를 사용하여 기본 시간 제한을 결정하며 이는 timeout 속성을 사용하여 재정의할 수 있습니다. 시간 제한은 각 개별 테스트가 아니라 BUILD 타겟의 모든 테스트에 적용됩니다. 테스트가 로컬에서 실행될 때 size는 일정 예약 목적으로 추가로 사용됩니다. Bazel은 --local_{ram,cpu}_resources를 존중하고 동시에 많은 테스트를 실행하여 로컬 머신에 과부하를 주지 않습니다.

테스트 크기는 다음과 같은 기본 제한 시간과 최대 로컬 리소스 사용량으로 간주됩니다.

크기 RAM (MB) CPU (CPU 코어) 기본 제한 시간
small 20 1 단시간 (1분)
중간 100 1 보통 (5분)
대형 300 1 장시간 (15분)
거대한 800 1 영원한 (60분)

환경 변수 TEST_SIZE 는 테스트를 생성할 때 이 속성 값으로 설정됩니다.

timeout

String "short", "moderate", "long", "eternal" (with the default derived from the test's size attribute); nonconfigurable

반환하기 전에 테스트가 실행될 것으로 예상되는 시간입니다.

테스트의 크기 속성은 리소스 추정을 제어하지만 테스트의 제한 시간은 독립적으로 설정될 수 있습니다. 별도로 지정되지 않은 경우 제한 시간은 테스트 크기를 기반으로 합니다. 테스트 제한 시간은 --test_timeout 플래그로 재정의될 수 있습니다(예: 속도가 느리다고 알려진 특정 조건에서 실행). 테스트 제한 시간 값은 다음 기간에 해당합니다.

제한 시간 값 기간
short 1분
보통 5분
long 15분
영원한 60분

위에 해당하지 않는 시간의 경우 --test_timeout bazel 플래그를 사용하여 테스트 제한 시간을 재정의할 수 있습니다. 예를 들어 속도가 느린 것으로 알려진 조건에서 수동으로 실행하는 경우가 있습니다. --test_timeout 값은 초 단위입니다. 예를 들어 --test_timeout=120는 테스트 제한 시간을 2분으로 설정합니다.

테스트를 생성할 때 TEST_TIMEOUT 환경 변수가 테스트 제한 시간 (초)으로 설정됩니다.

flaky

Boolean; optional; default False; nonconfigurable

불안정으로 테스트됩니다.

설정된 경우 테스트를 최대 세 번 실행하여 매번 실패하는 경우에만 실패로 표시합니다. 기본적으로 이 속성은 False로 설정되며 테스트가 한 번만 실행됩니다. 이 속성의 사용은 일반적으로 권장되지 않습니다. 어설션이 유지되는 경우 테스트를 안정적으로 통과해야 합니다.

shard_count

Non-negative integer less than or equal to 50; optional

테스트를 실행하는 데 사용할 병렬 샤드 수를 지정합니다.

이 값은 테스트를 실행할 병렬 샤드 수를 결정하는 데 사용되는 휴리스틱을 재정의합니다. 일부 테스트 규칙의 경우 처음에 샤딩을 사용 설정하려면 이 매개변수가 필요할 수 있습니다. --test_sharding_strategy도 참조하세요.

테스트 샤딩을 사용 설정하면 테스트를 생성할 때 TEST_TOTAL_SHARDS 환경 변수가 이 값으로 설정됩니다.

샤딩하려면 테스트 실행기가 테스트 샤딩 프로토콜을 지원해야 합니다. 그렇지 않은 경우 모든 샤드에서 모든 테스트를 실행할 가능성이 큽니다.

샤딩에 관한 자세한 내용은 테스트 백과사전의 테스트 샤딩을 참고하세요.

local

Boolean; default False; nonconfigurable

샌드박스 없이 테스트를 강제로 실행합니다.

True로 설정하면 'local'을 태그(tags=["local"])로 제공하는 것과 같습니다.

모든 바이너리 규칙에 공통적인 속성 (*_binary)

이 섹션에서는 모든 바이너리 규칙에 공통적인 속성을 설명합니다.

속성 설명
args

List of strings; optional; subject to $(location) and "Make variable" substitution, and Bourne shell tokenization; nonconfigurable

Bazel이 run 명령어에 의해 또는 테스트로 실행될 때 대상에 전달할 명령줄 인수입니다. 이러한 인수는 bazel run 또는 bazel test 명령줄에 지정된 인수 전에 전달됩니다.

참고: Bazel 외부에서 대상을 실행할 때는 인수가 전달되지 않습니다 (예: bazel-bin/에서 바이너리를 수동으로 실행).

env

Dictionary of strings; optional; values are subject to $(location) and "Make variable" substitution

bazel run로 대상을 실행할 때 설정할 추가 환경 변수를 지정합니다.

이 속성은 cc_binary, py_binary, sh_binary와 같은 네이티브 규칙에만 적용됩니다. Starlark 정의 실행 규칙에는 적용되지 않습니다.

참고: Bazel 외부에서 대상을 실행하는 경우 (예: bazel-bin/에서 바이너리를 수동으로 실행) 환경 변수가 설정되지 않습니다.

output_licenses

List of strings; optional

이 바이너리가 생성하는 출력 파일의 라이선스입니다. 지원 중단된 라이선싱 API의 일부이며 Bazel이 더 이상 사용하지 않습니다. 사용하지 마세요.

구성 가능한 속성

대부분의 속성은 '구성 가능'합니다. 즉, 대상이 다른 방식으로 빌드될 때 값이 변경될 수 있습니다. 특히 구성 가능한 속성은 Bazel 명령줄로 전달되는 플래그 또는 대상을 요청하는 다운스트림 종속 항목에 따라 다를 수 있습니다. 예를 들어 이 정보는 여러 플랫폼 또는 컴파일 모드의 타겟을 맞춤설정하는 데 사용될 수 있습니다.

다음 예에서는 다양한 타겟 아키텍처에 대해 서로 다른 소스를 선언합니다. bazel build :multiplatform_lib --cpu x86를 실행하면 x86_impl.cc를 사용하여 타겟이 빌드되고 --cpu arm를 바꾸면 arm_impl.cc가 사용됩니다.

cc_library(
    name = "multiplatform_lib",
    srcs = select({
        ":x86_mode": ["x86_impl.cc"],
        ":arm_mode": ["arm_impl.cc"]
    })
)
config_setting(
    name = "x86_mode",
    values = { "cpu": "x86" }
)
config_setting(
    name = "arm_mode",
    values = { "cpu": "arm" }
)

select() 함수는 타겟의 구성이 충족하는 config_setting 또는 constraint_value 기준에 따라 구성 가능한 속성의 다양한 값 중에서 선택합니다.

Bazel은 매크로를 처리한 후 및 처리 규칙 전 (기술적으로 로드 단계와 분석 단계 사이)에 구성 가능한 속성을 평가합니다. select() 평가 전의 처리는 select()가 어떤 브랜치를 선택하는지 알 수 없습니다. 예를 들어, 매크로는 선택된 브랜치에 따라 동작을 변경할 수 없으며 bazel query은 타겟의 구성 가능한 종속 항목에 관해 보수적인 추측만 할 수 있습니다. 규칙 및 매크로와 함께 select()을 사용하는 방법에 관한 자세한 내용은 이 FAQ를 참고하세요.

문서에 nonconfigurable로 표시된 속성은 이 기능을 사용할 수 없습니다. Bazel이 select()을 확인하는 방법을 결정하려면 먼저 이 값을 내부적으로 알아야 하기 때문에 대개 속성을 구성할 수 없습니다.

자세한 내용은 구성 가능한 빌드 속성을 참조하세요.

암시적 출력 타겟

C++의 암시적 출력은 지원 중단되었습니다. 가능한 경우 다른 언어로 사용하지 마세요. 아직 지원 중단 경로가 없지만 결국에는 지원 중단될 예정입니다.

BUILD 파일에서 빌드 규칙을 정의하면 패키지에서 이름이 지정된 새 규칙 대상을 명시적으로 선언합니다. 또한 많은 빌드 규칙 함수에는 콘텐츠와 그 의미가 규칙별로 있는 출력 파일 타겟 하나 이상이 암시적으로 포함됩니다. 예를 들어 java_binary(name='foo', ...) 규칙을 명시적으로 선언하면 출력 파일 대상 foo_deploy.jar를 동일한 패키지의 구성원으로 암시적으로 선언하게 됩니다. 이 특정 대상은 배포에 적합한 독립 실행형 자바 보관 파일입니다.

암시적 출력 대상은 전역 대상 그래프의 최고 구성원입니다. 다른 타겟과 마찬가지로 최상위 빌드 명령어에 지정되거나 다른 빌드 타겟의 전제 조건이 필요한 경우 필요에 따라 빌드됩니다. 이는 BUILD 파일에서 종속 항목으로 참조될 수 있으며 bazel query와 같은 분석 도구의 출력에서 관찰될 수 있습니다.

빌드 문서의 각 규칙 유형에는 해당 유형의 규칙을 선언한 암시적 출력의 이름과 콘텐츠를 자세히 설명하는 특수한 섹션이 규칙 문서에 포함되어 있습니다.

빌드 시스템에서 사용하는 두 네임스페이스의 중요하지만 미묘한 차이는 라벨이 규칙 또는 파일일 수 있는 타겟을 식별하고, 파일 타겟은 소스 (또는 입력) 파일 타겟과 파생 (또는 출력) 파일 타겟으로 나눌 수 있습니다. BUILD 파일에서 언급하거나 명령줄에서 빌드하거나 bazel query을 사용하여 검사할 수 있는 항목은 대상 네임스페이스입니다. 각 파일 대상은 디스크에 있는 실제 파일 한 개("파일 시스템 네임스페이스')에 상응합니다. 각 규칙 대상은 디스크에 있는 0개 이상 실제 파일에 대응할 수 있습니다. 디스크에 해당되는 대상이 없는 파일이 있을 수 있습니다. 예를 들어 C++ 컴파일 중에 생성된 .o 객체 파일은 BUILD 파일 내에서 또는 명령줄에서 참조될 수 없습니다. 이러한 방식으로 빌드 도구는 작업 수행 방식에 관한 특정 구현 세부정보를 숨길 수 있습니다. 자세한 내용은 빌드 개념 참조에서 자세히 설명합니다.