이 페이지에서는 다양한 수준에서 C++ 규칙과 통합하는 방법을 설명합니다.
C++ 도구 모음 액세스
플랫폼 및 도구 모음으로 C++ 규칙을 지속적으로 이전하므로 도구 모음이 사용 중지되고 사용 설정될 때도 모두 작동하는 @bazel_tools//tools/cpp:toolchain_utils.bzl의 도우미 함수를 사용해야 합니다. 규칙의 C++ 도구 모음을 사용하려면 _cc_toolchain
라는 Label
속성을 추가하고 @bazel_tools//tools/cpp:current_cc_toolchain
(현재 선택된 C++ 도구 모음을 가리키는 cc_toolchain_alias
규칙의 인스턴스)를 가리킵니다.
그런 다음 규칙 구현에서 find_cpp_toolchain(ctx)
를 사용하여 CcToolchainInfo
를 가져옵니다.
완전히 작동하는 예는 rules_cc 예에서 확인할 수 있습니다.
C++ 도구 모음을 사용하여 명령줄 및 환경 변수 생성
일반적으로 C++ 도구 모음과 통합하여 명령줄 플래그를 C++ 규칙과 동일하게 사용하되 C++ 작업을 직접 사용하지 않습니다. 작업을 직접 작성할 때는 C++ 도구 모음과 일관되게 작동해야 하기 때문입니다. 예를 들어 C++ 명령줄 플래그를 백그라운드에서 C++ 컴파일러를 호출하는 도구에 전달하면 됩니다.
C++ 규칙은 기능 구성을 기반으로 명령줄을 구성하는 특별한 방법을 사용합니다. 명령줄을 구성하려면 다음이 필요합니다.
features
및action_configs
-CcToolchainConfigInfo
에서 가져오며CcToolchainInfo
에 캡슐화됩니다.FeatureConfiguration
- cc_common.configure_features에서 반환- cc 도구 모음 구성 변수 - cc_common.create_compile_variables 또는 cc_common.create_link_variables에서 반환됩니다.
compiler_executable과 같은 도구별 getter는 여전히 있습니다.
도구별 getter가 결국 삭제되므로 이보다 get_tool_for_action
를 사용하는 것이 좋습니다.
완전히 작동하는 예는 rules_cc 예에서 확인할 수 있습니다.
C++ 규칙 또는 C++ 규칙에 종속된 Starlark 규칙 구현
대부분의 C++ 규칙은 CompilationContext
및 LinkingContext
를 포함하는 제공업체인 CcInfo
를 제공합니다.
이를 통해 연결할 모든 전이 헤더 또는 라이브러리와 같은 정보에 액세스할 수 있습니다. CcInfo
및 CcToolchainInfo
커스텀 Starlark 규칙은 필요한 모든 정보를 가져올 수 있어야 합니다.
커스텀 Starlark 규칙에서 CcInfo
을 제공하면 이 규칙이 C++ 규칙에도 종속될 수 있다는 신호를 보냅니다. 하지만 주의해서 사용해야 합니다. 그래프를 통해 CcInfo
를 이를 사용하는 바이너리 규칙으로만 전파해야 하는 경우 CcInfo
을 다른 제공자에 래핑합니다. 예를 들어 java_library
규칙이 네이티브 종속 항목을 java_binary
에 전파하려는 경우 CcInfo
를 직접 제공하면 안 됩니다 (java_library
에 따라 cc_binary
는 적절하지 않음). 예를 들어 JavaCcInfo
로 래핑해야 합니다.
완전히 작동하는 예는 rules_cc 예에서 확인할 수 있습니다.
C++ 규칙의 로직 및 작업 재사용
아직 안정적이지 않습니다. 이 섹션은 API가 안정화되면 업데이트됩니다. #4570을 팔로우하여 최신 정보를 확인하세요.