이 페이지에서는 매크로 및 규칙을 사용하여 BUILD 언어를 확장하는 방법을 설명합니다.
Bazel 확장 프로그램은 .bzl으로 끝나는 파일입니다. load 문을 사용하여 확장 프로그램에서 기호를 가져옵니다.
고급 개념을 알아보기 전에
BUILD및.bzl파일 모두에서 사용되는 Starlark 언어에 대해 알아보세요.두
BUILD파일 간에 변수를 공유하는 방법을 알아보세요.
매크로 및 규칙
매크로는 규칙을 인스턴스화하는 함수입니다. BUILD 파일이 너무 반복적이거나 너무 복잡할 때 유용합니다. 일부 코드를 재사용할 수 있기 때문입니다. 이 함수는 BUILD 파일을 읽는 즉시 평가됩니다. BUILD 파일을 평가한 후 Bazel은 매크로에 대한 정보를 거의 가지고 있지 않습니다. 매크로가 genrule를 생성하면 Bazel은 개발자가 genrule을 작성한 것처럼 작동합니다. 따라서 bazel query는 생성된 genrule만 나열합니다.
규칙은 매크로보다 훨씬 효과적입니다. Bazel 내부에 액세스할 수 있으며 현재 상황을 완전히 제어할 수 있습니다. 예를 들어 다른 규칙에 정보를 전달할 수 있습니다.
간단한 로직을 재사용하려면 매크로로 시작하세요. 매크로가 복잡해지면 대개 이를 규칙으로 만드는 것이 좋습니다. 새로운 언어 지원은 일반적으로 규칙으로 이루어집니다. 규칙은 고급 사용자를 위한 것이며 대부분의 사용자는 작성할 필요가 전혀 없습니다. 기존 규칙만 로드하고 호출합니다.
평가 모델
빌드는 세 단계로 구성됩니다.
로드 단계. 먼저 빌드에 필요한 모든 확장 프로그램과 모든
BUILD파일을 로드하고 평가합니다.BUILD파일의 실행은 규칙을 인스턴스화할 뿐입니다 (규칙이 호출될 때마다 그래프에 추가됨). 이 단계에서 매크로를 평가합니다.분석 단계. 규칙의 코드가 실행되고 (
implementation함수) 작업이 인스턴스화됩니다. 작업은 'hello.c에서 gcc 실행 및 hello.o 가져오기'와 같은 입력 집합에서 출력 집합을 생성하는 방법을 설명합니다. 실제 명령어를 실행하기 전에 생성될 파일을 명시적으로 나열해야 합니다. 즉, 분석 단계에서는 로드 단계에서 생성된 그래프를 사용하여 작업 그래프를 생성합니다.실행 단계. 하나 이상의 출력이 필요한 경우 작업이 실행됩니다. 파일이 누락되거나 명령어가 출력을 하나도 생성하지 못하면 빌드가 실패합니다. 이 단계에서 테스트도 실행됩니다.
Bazel은 동시 로드를 사용하여 .bzl 파일과 BUILD 파일을 읽고 파싱하고 평가합니다. 파일은 빌드당 최대 한 번 판독되며, 평가 결과는 캐시되어 재사용됩니다. 파일은 모든 종속 항목(load() 문)이 확인된 후에만 평가됩니다. 의도적으로 .bzl 파일을 로드하면 눈에 띄는 부작용이 없고 값과 함수만 정의됩니다.
Bazel은 영리하게 노력합니다. 종속 항목 분석을 사용하여 로드해야 하는 파일과 분석해야 하는 규칙, 실행해야 하는 작업을 파악합니다. 예를 들어 규칙에서 현재 빌드에 필요 없는 작업을 생성한다면 이러한 작업이 실행되지 않습니다.
광고 확장 만들기
일부 코드를 재사용하려면 첫 번째 매크로를 만듭니다. 그런 다음 매크로에 대해 알아보고 매크로를 사용하여 '커스텀 동사'를 만드세요.
규칙 가이드를 따라 규칙을 시작하세요. 규칙 개념에 대해 자세히 알아보세요.
아래의 두 링크는 광고 확장을 직접 작성할 때 매우 유용합니다. 사용자가 접근 가능한 범위를 유지하세요.
더 알아보기
매크로 및 규칙 외에도 속성 및 저장소 규칙을 작성하는 것이 좋습니다.
Buildifier를 일관성 있게 사용하여 코드의 형식을 지정하고 린트합니다.
.bzl스타일 가이드를 따르세요.코드를 테스트합니다.
사용자를 지원하기 위한 문서를 생성합니다.
코드 성능을 최적화합니다.
확장 프로그램을 다른 사용자에게 배포합니다.