C++ 및 Bazel

Nightly · 9.0 · 8.6 · 8.5 · 8.4 · 8.3 · 8.2 · 7.7

이 페이지에는 C++ 프로젝트에서 Bazel을 사용하는 데 도움이 되는 리소스가 포함되어 있습니다. Bazel을 사용하여 C++ 프로젝트를 빌드하는 데 필요한 튜토리얼, 빌드 규칙, 기타 정보로 연결됩니다.

Bazel 작업

다음 리소스는 C++ 프로젝트에서 Bazel을 사용하는 데 도움이 됩니다.

권장사항

일반적인 Bazel 권장사항 외에도 C++ 프로젝트에만 적용되는 권장사항은 다음과 같습니다.

BUILD 파일

BUILD 파일을 만들 때는 다음 가이드라인을 따르세요.

  • 각 BUILD 파일에는 디렉터리의 컴파일 단위당 하나의 cc_library 규칙 대상이 포함되어야 합니다.

  • 증분성을 극대화하고 빌드를 병렬화하려면 C++ 라이브러리를 최대한 세분화해야 합니다.

  • srcs에 단일 소스 파일이 있는 경우 라이브러리 이름을 C++ 파일의 이름과 동일하게 지정합니다. 이 라이브러리에는 C++ 파일, 일치하는 헤더 파일, 라이브러리의 직접 종속 항목이 포함되어야 합니다. 예를 들면 다음과 같습니다.

    cc_library(
    name = "mylib",
    srcs = ["mylib.cc"],
    hdrs = ["mylib.h"],
    deps = [":lower-level-lib"]
)

  • 파일의 cc_library 대상당 하나의 cc_test 규칙 대상을 사용합니다. 대상 이름을 [library-name]_test로 지정하고 소스 파일 이름을 [library-name]_test.cc로 지정합니다. 예를 들어 위에 표시된 mylib 라이브러리 대상의 테스트 대상은 다음과 같습니다. 

    cc_test(
    name = "mylib_test",
    srcs = ["mylib_test.cc"],
    deps = [":mylib"]
)

경로 포함

경로 포함에 관한 다음 가이드라인을 따르세요.

  • 모든 포함 경로를 작업공간 디렉터리를 기준으로 지정합니다.

  • 시스템 헤더가 아닌 헤더에는 꺾쇠괄호 (#include <foo/bar/baz.h>)가 아닌 따옴표로 묶은 포함 (#include "foo/bar/baz.h")를 사용합니다.

  • UNIX 디렉터리 바로가기(예: .(현재 디렉터리) 또는 .. (상위 디렉터리))를 사용하지 마세요.

  • 프로젝트 저장소 외부를 가리키는 포함이 필요한 기존 코드 또는 third_party 코드(예: 접두어가 필요한 외부 저장소 포함)의 경우 cc_library 규칙 대상에서 include_prefix 및 strip_include_prefix 인수를 사용합니다.

툴체인 기능

다음 선택적 기능 을 사용하면 C++ 프로젝트의 위생을 개선할 수 있습니다. 이러한 기능은 --features 명령줄 플래그 또는 features 속성을 사용하여 사용 설정할 수 있습니다. repo, package 또는 cc_* 규칙:

  • parse_headers 기능을 사용하면 C++ 컴파일러가 빌드된 대상과 종속 항목의 모든 헤더 파일을 컴파일하지 않고 파싱합니다. --process_headers_in_dependencies 플래그를 사용할 때 이렇게 하면 헤더 전용 라이브러리의 문제를 파악하고 헤더가 자체 포함되어 있으며 포함되는 순서와 무관하도록 할 수 있습니다.
  • layering_check 기능은 대상이 직접 종속 항목에서 제공하는 헤더만 포함하도록 적용합니다. 기본 툴체인은 컴파일러로 clang를 사용하여 Linux에서 이 기능을 지원합니다.