작업공간, 패키지, 대상

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

Bazel은 작업공간이라는 디렉터리 트리로 구성된 소스 코드로 소프트웨어를 빌드합니다. 작업공간의 소스 파일은 패키지의 중첩된 계층 구조로 구성되며, 각 패키지는 관련 소스 파일 세트와 하나의 BUILD 파일을 포함하는 디렉터리입니다. BUILD 파일은 소스에서 빌드할 수 있는 소프트웨어 출력을 지정합니다.

작업공간

작업공간은 빌드할 소프트웨어의 소스 파일이 포함된 파일 시스템의 디렉터리 트리입니다. 각 작업공간에는 WORKSPACE라는 텍스트 파일이 비어 있습니다. 이 파일은 비어 있거나 출력을 빌드하는 데 필요한 외부 종속 항목에 대한 참조를 포함할 수 있습니다.

WORKSPACE라는 파일이 포함된 디렉터리는 작업공간의 루트로 간주됩니다. 따라서 Bazel은 WORKSPACE 파일이 포함된 하위 디렉터리에 있는 작업공간의 디렉터리 트리를 무시합니다. 다른 작업공간을 형성하기 때문입니다.

또한 Bazel은 WORKSPACE.bazel 파일을 WORKSPACE 파일의 별칭으로 지원합니다. 두 파일이 모두 있으면 WORKSPACE.bazel이 사용됩니다.

저장소

코드는 저장소로 구성됩니다. WORKSPACE 파일이 포함된 디렉터리는 기본 저장소의 루트(@라고도 함)입니다. 기타(외부) 저장소는 WORKSPACE 파일에 작업공간 규칙을 사용하여 정의됩니다.

Bazel과 함께 제공되는 작업공간 규칙은 백과사전 빌드작업공간 규칙 섹션 및 삽입된 Starlark 저장소 규칙 문서에 설명되어 있습니다.

외부 저장소는 저장소이므로 WORKSPACE 파일도 포함되는 경우가 많습니다. 그러나 Bazel은 이러한 추가 WORKSPACE 파일을 무시합니다. 특히 전이 종속된 저장소는 자동으로 추가되지 않습니다.

패키지

저장소에 있는 코드 조직의 기본 단위는 패키지입니다. 패키지는 관련 파일의 모음이며 출력 아티팩트를 생성하는 데 사용할 수 있는 방법을 지정합니다.

패키지는 BUILD(또는 BUILD.bazel) 파일을 포함하는 디렉터리로 정의됩니다. 패키지는 디렉터리에 있는 모든 파일과 그 아래에 있는 모든 하위 디렉터리를 포함합니다. 단, BUILD 파일을 포함하는 디렉터리는 제외됩니다. 이 정의에서는 파일이나 디렉터리가 두 개의 다른 패키지에 속할 수 없습니다.

예를 들어 다음 디렉터리 트리에는 my/app 패키지와 하위 패키지 my/app/tests가 있습니다. my/app/data는 패키지가 아니라 my/app 패키지에 속하는 디렉터리입니다.

src/my/app/BUILD
src/my/app/app.cc
src/my/app/data/input.txt
src/my/app/tests/BUILD
src/my/app/tests/test.cc

대상

패키지는 패키지의 BUILD 파일에 정의된 대상의 컨테이너입니다. 대부분의 대상은 파일규칙이라는 두 가지 주요 종류 중 하나입니다.

파일은 두 가지로 더 구분됩니다. 소스 파일은 일반적으로 사용자의 노력으로 작성되며 저장소에 체크인됩니다. 생성된 파일(파생된 파일 또는 출력 파일이라고도 함)은 체크인되지 않지만 소스 파일에서 생성됩니다.

두 번째 유형의 대상은 규칙을 사용하여 선언됩니다. 각 규칙 인스턴스는 입력 집합과 출력 파일 집합 간의 관계를 지정합니다. 규칙에 대한 입력은 소스 파일일 수도 있지만 다른 규칙의 출력일 수도 있습니다.

규칙에 대한 입력이 소스 파일인지 아니면 생성된 파일인지는 대부분의 경우 중요하지 않습니다. 중요한 것은 파일의 내용만 중요합니다. 이러한 사실 덕분에 복잡한 소스 파일을 규칙으로 생성된 파일로 대체할 수 있습니다. 예를 들어 고도로 구조화된 파일을 수동으로 유지해야 하는 부담이 너무 커지고 누군가가 이를 파생하기 위해 프로그램을 작성합니다. 해당 파일의 소비자는 변경할 필요가 없습니다. 반대로 생성된 파일은 로컬 변경사항만 있는 소스 파일로 쉽게 대체할 수 있습니다.

규칙에 대한 입력에는 다른 규칙도 포함될 수 있습니다. 이러한 관계의 정확한 의미는 매우 복잡하고 언어 또는 규칙에 종속되는 경우가 많지만 직관적으로 간단합니다. C++ 라이브러리 규칙 A에는 입력을 위한 다른 C++ 라이브러리 규칙 B가 있을 수 있습니다. 이 종속 항목의 영향은 컴파일 중에 B의 헤더 파일을 A에 사용하고 B의 기호는 연결 중에 A에 사용할 수 있으며 B의 런타임 데이터는 실행 중에 A에 사용할 수 있다는 점입니다.

어떤 규칙도 변하지 않는 점은 규칙에 의해 생성된 파일이 항상 규칙 자체와 동일한 패키지에 속하게 된다는 점입니다. 파일을 다른 패키지로 생성할 수 없기 때문입니다. 규칙의 입력이 다른 패키지에서 발생하는 경우는 드뭅니다.

패키지 그룹은 특정 규칙의 접근성을 제한하는 것이 목적인 패키지 집합입니다. 패키지 그룹은 package_group 함수로 정의됩니다. 패키지에는 포함된 패키지 목록, 이름, 포함된 기타 패키지 그룹이라는 세 가지 속성이 있습니다. 이를 참조하는 유일한 방법은 규칙의 visibility 속성 또는 package 함수의 default_visibility 속성에서만 파일을 생성하거나 사용하지 않습니다. 자세한 내용은 package_group 문서를 참조하세요.

라벨