C++ 및 Bazel

문제 신고 소스 보기

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

Bazel을 사용한 작업

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

권장사항

아래는 일반적인 Bazel 권장사항 외에 C++ 프로젝트와 관련된 권장사항입니다.

BUILD 파일

BUILD 파일을 만들 때 아래 가이드라인을 따르세요.

  • BUILD 파일에는 디렉터리의 컴파일 단위당 cc_library 규칙 타겟이 1개 포함되어야 합니다.

  • 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_prefixstrip_include_prefix 인수를 사용합니다.