BazelCon 2022는 11월 16~17일에 뉴욕과 온라인에서 개최됩니다.
지금 등록하기

빌드 파일

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

이전 섹션에서는 패키지, 타겟 및 라벨, 빌드 종속 항목 그래프를 추상적으로 설명했습니다. 이 섹션에서는 패키지를 정의하는 데 사용되는 구체적인 구문을 설명합니다.

정의에 따라 모든 패키지에는 짧은 프로그램인 BUILD 파일이 포함됩니다. BUILD 파일은 명령형 언어인 Starlark를 사용하여 평가됩니다.

이러한 문은 순차적인 문 목록으로 해석됩니다.

일반적으로 순서는 중요합니다. 예를 들어 변수는 사용되기 전에 정의되어야 합니다. 하지만 대부분의 BUILD 파일은 빌드 규칙의 선언으로만 구성되며 이러한 문의 상대적 순서는 중요하지 않습니다. 중요한 것은 어떤 규칙이 선언되었는지, 그리고 패키지 평가가 완료될 때까지 어떤 값이 무엇인지를 선언하는 것입니다.

빌드 규칙 함수(예: cc_library)가 실행되면 그래프에 새 타겟이 생성됩니다. 이 타겟은 나중에 라벨을 사용하여 참조할 수 있습니다.

간단한 BUILD 파일에서 동작을 변경하지 않고 규칙 선언을 자유롭게 재정렬할 수 있습니다.

코드와 데이터가 명확하게 분리되도록 BUILD 파일에는 함수 정의, for 문 또는 if 문을 포함할 수 없습니다. 단, 목록 이해 및 if 표현식은 허용됩니다. 에서 확인할 수 있습니다. 대신 함수를 .bzl 파일에서 선언할 수 있습니다. 또한 *args**kwargs 인수는 BUILD 파일에서 허용되지 않습니다. 대신 모든 인수를 명시적으로 나열합니다.

결정적으로 Starlark의 프로그램은 임의의 I/O를 수행할 수 없습니다. 이 불변성을 통해 알려진 파일 세트에만 종속되므로 BUILD 파일의 해석을 밀폐할 수 있습니다. 이는 빌드 재현 가능하게 하는 데 필수적입니다. 자세한 내용은 밀폐를 참조하세요.

BUILD 파일은 ASCII 문자만 사용하여 작성해야 하지만, 기술적으로는 Latin-1 문자 집합을 사용하여 해석됩니다.

BUILD 파일은 기본 코드의 종속 항목이 변경될 때마다 업데이트해야 하므로 일반적으로 팀의 여러 사용자가 유지합니다. BUILD 파일 작성자는 각 빌드 대상의 역할, 공개적 용도인지 여부와 관계없이 패키지 자체의 역할을 자유롭게 문서화해야 합니다.

확장 프로그램 로드

Bazel 확장 프로그램은 .bzl으로 끝나는 파일입니다. load 문을 사용하여 확장 프로그램에서 기호를 가져옵니다.

load("//foo/bar:file.bzl", "some_library")

이 코드는 foo/bar/file.bzl 파일을 로드하고 환경에 some_library 기호를 추가합니다. 이 클래스는 새 규칙, 함수, 상수(예: 문자열 또는 목록)를 로드하는 데 사용할 수 있습니다. load 호출에 추가 인수를 사용하여 여러 기호를 가져올 수 있습니다. 인수는 문자열 리터럴(변수 없음)이어야 하고 load 문이 함수 본문에 있을 수 없는 최상위 수준에 표시되어야 합니다.

load의 첫 번째 인수는 .bzl 파일을 식별하는 라벨입니다. 상대적 라벨인 경우에는 현재 bzl 파일이 포함된 패키지 (디렉터리 아님)와 관련하여 확인됩니다. load 문의 상대 라벨은 선행 :를 사용해야 합니다.

load도 별칭을 지원하므로 가져온 기호에 다른 이름을 할당할 수 있습니다.

load("//foo/bar:file.bzl", library_alias = "some_library")

하나의 load 문 내에 여러 개의 별칭을 정의할 수 있습니다. 또한 인수 목록에는 별칭과 정규 기호 이름이 모두 포함될 수 있습니다. 다음 예는 완벽하게 합법적입니다 (따옴표를 사용하는 경우에 유의).

load(":my_rules.bzl", "some_rule", nice_alias = "some_other_rule")

.bzl 파일에서 _로 시작하는 기호는 내보내지지 않으며 다른 파일에서 로드할 수 없습니다. 공개 상태는 아직 로드에 영향을 미치지 않습니다. .bzl 파일을 표시하기 위해 exports_files을 사용할 필요는 없습니다.

빌드 규칙 유형

대부분의 빌드 규칙은 언어별로 그룹화되어 제공됩니다. 예를 들어 cc_binary, cc_librarycc_test는 각각 C++ 바이너리, 라이브러리, 테스트의 빌드 규칙입니다. 다른 언어에서는 동일한 이름 지정 체계를 사용하며 다른 프리픽스는 자바용입니다(예: java_*). 이러한 함수 중 일부는 빌드 백과사전에 문서화되어 있지만, 누구나 새 규칙을 만들 수 있습니다.

  • *_binary 규칙은 지정된 언어로 실행 가능한 프로그램을 빌드합니다. 빌드 후 실행 파일은 규칙 라벨의 상응하는 이름에 있는 빌드 도구의 바이너리 출력 트리에 상주하므로 //my:program는 예를 들어 $(BINDIR)/my/program에 표시됩니다.

    일부 언어에서는 이러한 규칙이 규칙에 속한 data 속성에 언급된 모든 파일 또는 종속 항목의 전이 종료 규칙을 포함하는 runfiles 디렉터리를 생성합니다. 이 파일 모음은 프로덕션에 쉽게 배포할 수 있도록 한곳에 수집됩니다.

  • *_test 규칙은 자동 테스트에 사용되는 *_binary 규칙의 전문화입니다. 테스트는 성공 시 0을 반환하는 프로그램입니다.

    바이너리와 마찬가지로 테스트에는 runfiles 트리도 있으며 그 아래에 있는 파일은 런타임 시 테스트를 합법적으로 열 수 있는 유일한 파일입니다. 예를 들어 프로그램 cc_test(name='x', data=['//foo:bar'])는 실행 중에 $TEST_SRCDIR/workspace/foo/bar를 열고 읽을 수 있습니다. 각 프로그래밍 언어에는 $TEST_SRCDIR 값에 액세스하기 위한 자체 유틸리티 함수가 있지만 모두 환경 변수를 직접 사용하는 것과 동일합니다. 규칙을 관찰하지 않으면 원격 테스트 호스트에서 테스트가 실행될 때 테스트가 실패합니다.

  • *_library 규칙은 특정 프로그래밍 언어로 별도로 컴파일된 모듈을 지정합니다. 라이브러리는 다른 라이브러리에 종속될 수 있으며 바이너리 및 테스트는 예상되는 별도의 컴파일 동작과 함께 라이브러리에 종속될 수 있습니다.

라벨 종속 항목