cc_common

C++ 컴파일, 연결, 명령줄 생성을 위한 유틸리티입니다.

회원

action_is_enabled

bool cc_common.action_is_enabled(feature_configuration, action_name)

기능 구성에서 지정된 action_config가 사용 설정된 경우 true를 반환합니다.

매개변수

매개변수 설명
feature_configuration required
쿼리할 기능 구성입니다.
action_name 필수
action_config의 이름입니다.

CcToolchainInfo

Provider cc_common.CcToolchainInfo

사용 중인 C++ 도구 모음에 관한 정보가 포함된 제공자를 검색하는 데 사용되는 키

compile

tuple cc_common.compile(actions, feature_configuration, cc_toolchain, srcs=[], public_hdrs=[], private_hdrs=[], includes=[], quote_includes=[], system_includes=[], framework_includes=[], defines=[], local_defines=[], include_prefix='', strip_include_prefix='', user_compile_flags=[], compilation_contexts=[], name, disallow_pic_outputs=False, disallow_nopic_outputs=False, additional_inputs=[], grep_includes=None)

C++ 컴파일에 사용해야 합니다. (CompilationContext, CcCompilationOutputs) 튜플을 반환합니다.

매개변수

매개변수 설명
actions required
actions 객체.
feature_configuration required
feature_configuration to be queried.
cc_toolchain required
CcToolchainInfo 제공자를 사용해야 합니다.
srcs 기본값 = []
컴파일할 소스 파일 목록입니다.
public_hdrs default = []
src 컴파일에 필요한 헤더 목록이며 종속 규칙에 의해 전이적으로 포함될 수 있습니다.
private_hdrs default = []
src 컴파일에 필요한 헤더 목록이며 종속 규칙에 포함되지 않습니다.
includes default = []
각괄호와 따옴표로 모두 참조된 헤더 파일의 검색 경로입니다. 일반적으로 -I과 함께 전달됩니다. 종속 항목에 전이적으로 전파됩니다.
quote_includes 기본값 = []
따옴표로 참조된 헤더 파일의 검색 경로입니다(예: #include "foo/bar/header.h"). exec 루트에 상대적이거나 절대적일 수 있습니다. 일반적으로 -iquote와 함께 전달됩니다. 종속 항목에 전이적으로 전파됩니다.
system_includes 기본값 = []
각괄호로 참조된 헤더 파일의 검색 경로입니다(예: #include <foo/bar/header.h>). exec 루트에 상대적이거나 절대적일 수 있습니다. 일반적으로 -isystem과 함께 전달됩니다. 종속 항목에 전이적으로 전파됩니다.
framework_includes default = []
Apple 프레임워크의 헤더 파일 검색 경로입니다. exec 루트에 상대적이거나 절대적일 수 있습니다. 일반적으로 -F와 함께 전달됩니다. 종속 항목에 전이적으로 전파됩니다.
defines default = []
이 타겟을 컴파일하는 데 필요한 정의 집합입니다. 각 정의는 문자열입니다. 종속 항목에 전이적으로 전파됩니다.
local_defines default = []
이 타겟을 컴파일하는 데 필요한 정의 집합입니다. 각 정의는 문자열입니다. 종속 항목에 전이적으로 전파되지 않습니다.
include_prefix default = ''
이 규칙의 헤더 경로에 추가할 접두사입니다. 이 속성을 설정하면 이 규칙의 hdrs 속성의 헤더에 액세스할 수 있으며, 이 속성의 값이 저장소 상대 경로 앞에 추가됩니다. 이 접두사가 추가되기 전에 strip_include_prefix 속성의 접두사가 삭제됩니다.
strip_include_prefix 기본값 = ''
이 규칙의 헤더 경로에서 제거할 접두사입니다. 이 속성을 설정하면 이 규칙의 hdrs 속성의 헤더에 이 접두사가 잘린 경로에서 액세스할 수 있습니다. 상대 경로인 경우 패키지 상대 경로로 간주됩니다. 절대 경로인 경우 저장소 상대 경로로 이해됩니다. include_prefix 속성의 접두사는 이 접두사가 제거된 후에 추가됩니다.
user_compile_flags default = []
추가 컴파일 옵션 목록입니다.
compilation_contexts default = []
컴파일에 사용되는 종속 항목의 헤더입니다.
name 필수
이 메서드로 생성된 작업의 출력 아티팩트 이름을 지정하는 데 사용됩니다. `main_output` 인수도 참고하세요.
disallow_pic_outputs default = False
PIC 출력을 생성해야 하는지 여부입니다.
disallow_nopic_outputs default = False
NOPIC 출력을 생성해야 하는지 여부입니다.
additional_inputs 기본값 = []
src 컴파일에 필요한 추가 파일 목록
grep_includes File; or None; default = None

configure_features

FeatureConfiguration cc_common.configure_features(ctx=None, cc_toolchain, language=None, requested_features=[], unsupported_features=[])

feature_configuration 인스턴스를 만듭니다. cpp 구성 프래그먼트가 필요합니다.

매개변수

매개변수 설명
ctx ctx; or None; 기본값 = None
규칙 컨텍스트입니다.
cc_toolchain required
기능을 구성하는 cc_toolchain
language string; or None; default = None
구성할 언어: c++ 또는 objc (기본값 c++)
requested_features default = []
사용 설정할 기능 목록입니다.
unsupported_features default = []
현재 규칙에서 지원되지 않는 기능 목록입니다.

create_cc_toolchain_config_info

CcToolchainConfigInfo cc_common.create_cc_toolchain_config_info(ctx, features=[], action_configs=[], artifact_name_patterns=[], cxx_builtin_include_directories=[], toolchain_identifier, host_system_name=None, target_system_name, target_cpu, target_libc, compiler, abi_version=None, abi_libc_version=None, tool_paths=[], make_variables=[], builtin_sysroot=None, cc_target_os=None)

CcToolchainConfigInfo 제공자를 만듭니다.

매개변수

매개변수 설명
ctx 필수
규칙 컨텍스트입니다.
features default = []

하나의 기능에 관한 모든 플래그 사양을 포함합니다.

인수:

name: 지형지물의 이름입니다. 도구 모음에 'feature' 섹션을 추가하고 BUILD 파일에 해당 문자열을 기능으로 추가하여 Bazel을 변경하지 않고도 기능을 도입할 수 있습니다.

사용 설정됨: 'true'인 경우 규칙 유형에서 이 기능을 지원되지 않음으로 명시적으로 표시하지 않는 한 이 기능이 사용 설정됩니다.

flag_sets: FlagSet 목록 - 지정된 기능이 사용 설정된 경우 지정된 작업에 대해 플래그 세트가 적용됩니다.

env_sets: EnvSet 목록 - 지정된 기능이 사용 설정된 경우 env 세트가 지정된 작업에 적용됩니다.

requires: 이 기능이 도구 모음에서 지원되는 시점을 정의하는 기능 집합 목록입니다. 이 기능은 기능 세트 중 하나가 완전히 적용되는 경우, 즉 기능 세트의 모든 기능이 사용 설정된 경우에 지원됩니다. 'requires'가 생략되면 이 기능은 다른 기능이 사용 설정되었는지와 관계없이 지원됩니다. 예를 들어 사용 설정된 빌드 모드 (opt / fastbuild / dbg)에 따라 플래그를 필터링하는 데 사용합니다.

의미: 이 기능이 사용 설정될 때 자동으로 사용 설정되는 기능 또는 작업 구성의 문자열 목록입니다. 암시된 기능 또는 작업 구성을 사용 설정할 수 없는 경우 이 기능도 자동으로 사용 설정되지 않습니다.

provides: 이 기능과 충돌하는 이름 목록입니다.

다음과 같은 경우 기능을 사용 설정할 수 없습니다.
- 'provides'에 사용 설정하려는 다른 기능 또는 작업 구성의 이름이 포함되어 있습니다.
- 'provides'에 사용 설정하려는 다른 기능 또는 작업 구성의 'provides'와 동일한 값이 포함되어 있습니다. 호환되지 않는 기능이 실수로 동시에 활성화되어 진단하기 어려운 컴파일러 오류가 발생하지 않도록 하려면 이 기능을 사용하세요.
action_configs default = []

작업 구성은 Bazel 작업에 해당하며 활성화된 기능을 기반으로 도구를 선택할 수 있습니다. 작업 구성 활성화는 기능과 동일한 시맨틱스에 의해 발생합니다. 기능은 다른 기능과 동일한 방식으로 작업 구성을 '요구'하거나 '암시'할 수 있습니다.

인수:

action_name: 이 구성이 적용되는 Bazel 작업의 이름입니다(예: 'c-compile' 또는 'c-module-compile').

사용 설정됨: 'true'인 경우 규칙 유형에서 명시적으로 지원되지 않도록 표시하지 않는 한 이 작업이 사용 설정됩니다.

도구: 작업에 적용되는 도구는 기능 구성과 일치하는 기능 세트가 있는 첫 번째 도구입니다. 제공된 기능 구성과 일치하는 도구가 없으면 오류가 발생합니다. 따라서 빈 기능 세트가 포함된 기본 도구를 제공하는 것이 좋습니다.

flag_sets: 지정된 작업 구성이 사용 설정된 경우 플래그 세트가 해당 작업에 적용됩니다.

implies: 이 작업 구성이 사용 설정될 때 자동으로 사용 설정되는 기능 또는 작업 구성 목록입니다. 암시된 기능 또는 작업 구성을 사용 설정할 수 없는 경우 이 작업 구성도 자동으로 사용 설정되지 않습니다.
artifact_name_patterns default = []

작업에 대한 입력 또는 출력 아티팩트의 특정 카테고리 아티팩트의 이름입니다.

인수:

category_name: 이 선택사항이 적용되는 아티팩트의 카테고리입니다. 이 필드는 Bazel에 정의된 카테고리 목록과 비교됩니다. 카테고리 예로는 'linked_output' 또는 이 선택의 아티팩트가 있습니다. 확장 프로그램과 함께 대상 이름을 기반으로 아티팩트 이름을 만드는 데 사용됩니다.

extension: 이 선택의 아티팩트를 만드는 확장 프로그램입니다. 접두사와 함께 대상 이름을 기반으로 아티팩트 이름을 만드는 데 사용됩니다.
cxx_builtin_include_directories default = []

C++ 컴파일을 위한 내장 포함 디렉터리입니다. 이는 컴파일러에서 사용하는 정확한 경로여야 하며 일반적으로 실행 루트에 상대적입니다.

컴파일러에서 사용하는 경로는 'gcc -E -xc++ - -v'를 사용하여 확인할 수 있습니다.

현재 C 컴파일에도 C++ 경로를 사용합니다. C++ 헤더 파일과 C 헤더 파일 간에 이름 충돌이 없는 한 안전합니다.

상대 경로는 구성 파일 디렉터리를 기준으로 확인됩니다.

컴파일러에 --sysroot 지원이 있는 경우 이러한 경로는 포함 경로 대신 %sysroot% 를 사용해야 하며, 올바른 대체를 실행하는 데 필요한 정보를 blaze에 제공하기 위해 sysroot 속성을 지정해야 합니다.
toolchain_identifier 필수

크로스툴 출시 내 툴체인의 고유 식별자입니다. 경로에서 디렉터리 이름으로 사용할 수 있어야 합니다.

[a-zA-Z_][\.\- \w]* 정규식과 일치해야 합니다.
host_system_name string; or None; 기본값 = None
무시됩니다.
target_system_name 필수
GNU 시스템 이름입니다.
target_cpu 필수
대상 아키텍처 문자열입니다.
target_libc 필수
libc 버전 문자열입니다 (예: 'glibc-2.2.2').
compiler 필수
컴파일러 버전 문자열입니다 (예: 'gcc-4.1.1').
abi_version string; or None; default = None
사용 중인 abi로, gcc 버전입니다. 예: 'gcc-3.4'
abi_libc_version string; or None; default = None
사용 중인 abi에서 사용하는 glibc 버전입니다.
tool_paths default = []

도구 위치

인수:

name: 도구의 이름입니다.

path: 도구의 위치입니다. 절대 경로 (비밀 유지 툴체인의 경우) 또는 cc_toolchain 패키지를 기준으로 한 상대 경로일 수 있습니다.
make_variables default = []
규칙에 액세스할 수 있는 make 변수입니다.
builtin_sysroot string; or None; default = None
내장 sysroot입니다. 이 속성이 없으면 Bazel은 --grte_top 옵션을 통해 다른 sysroot를 사용하는 것을 허용하지 않습니다.
cc_target_os string; or None; default = None
내부용 전용입니다. 사용하지 마세요.

create_compilation_context

CompilationContext cc_common.create_compilation_context(headers=unbound, system_includes=unbound, includes=unbound, quote_includes=unbound, framework_includes=unbound, defines=unbound, local_defines=unbound)

CompilationContext를 만듭니다.

매개변수

매개변수 설명
headers 기본값 = unbound
이 타겟을 컴파일하는 데 필요한 헤더 집합
system_includes 기본값 = unbound
괄호로 참조된 헤더 파일의 검색 경로 집합입니다(예: #include <foo/bar/header.h>). exec 루트에 상대적이거나 절대적일 수 있습니다. 일반적으로 -isystem과 함께 전달됨
includes 기본값 = unbound
각괄호와 따옴표로 모두 참조된 헤더 파일의 검색 경로 집합입니다. 일반적으로 -I와 함께 전달됩니다.
quote_includes 기본값 = unbound
따옴표로 참조된 헤더 파일의 검색 경로 집합입니다(예: #include "foo/bar/header.h"). exec 루트에 상대적이거나 절대적일 수 있습니다. 일반적으로 -iquote와 함께 전달됩니다.
framework_includes 기본값 = unbound
헤더 파일의 프레임워크 검색 경로 집합입니다 (Apple 플랫폼만 해당).
defines 기본값 = unbound
이 타겟을 컴파일하는 데 필요한 정의 집합입니다. 각 정의는 문자열입니다. 종속 항목에 전이적으로 전파됩니다.
local_defines 기본값 = unbound
이 타겟을 컴파일하는 데 필요한 정의 집합입니다. 각 정의는 문자열입니다. 종속 항목에 전이적으로 전파되지 않습니다.

create_compilation_outputs

CcCompilationOutputs cc_common.create_compilation_outputs(objects=None, pic_objects=None)

컴파일 출력 객체를 만듭니다.

매개변수

매개변수 설명
objects depset; or None; 기본값 = None
객체 파일 목록입니다.
pic_objects depset; or None; default = None
pic 객체 파일 목록입니다.

create_compile_variables

Variables cc_common.create_compile_variables(cc_toolchain, feature_configuration, source_file=None, output_file=None, user_compile_flags=None, include_directories=None, quote_include_directories=None, system_include_directories=None, framework_include_directories=None, preprocessor_defines=None, thinlto_index=None, thinlto_input_bitcode_file=None, thinlto_output_object_file=None, use_pic=False, add_legacy_cxx_options=False, variables_extension=unbound)

컴파일 작업에 사용되는 변수를 반환합니다.

매개변수

매개변수 설명
cc_toolchain required
빌드 변수를 만들 cc_toolchain
feature_configuration required
쿼리할 기능 구성입니다.
source_file default = None
선택사항인 컴파일 소스 파일입니다. cc_common.get_memory_inefficient_command_line에서 생성된 명령줄의 끝에 source_file을 추가하는 대신 여기에 전달하는 것이 좋습니다. 그러면 툴체인 작성자가 컴파일러 플래그를 올바르게 지정하고 배치할 수 있기 때문입니다.
output_file 기본값 = None
컴파일의 선택적 출력 파일입니다. cc_common.get_memory_inefficient_command_line에서 생성된 명령줄의 끝에 output_file을 추가하는 대신 여기에 전달하는 것이 좋습니다. 그러면 툴체인 작성자가 컴파일러 플래그를 적절하게 지정하고 배치할 수 있기 때문입니다.
user_compile_flags sequence of strings; or None; default = None
추가 컴파일 플래그 (copts) 목록입니다.
include_directories depset; or None; 기본값 = None
포함 디렉터리의 Depset입니다.
quote_include_directories depset; or None; 기본값 = None
따옴표 포함 디렉터리의 Depset입니다.
system_include_directories depset; or None; default = None
시스템 포함 디렉터리의 Depset입니다.
framework_include_directories depset; or None; default = None
프레임워크 포함 디렉터리의 Depset입니다.
preprocessor_defines depset; or None; default = None
전처리기 정의의 Depset입니다.
thinlto_index string; or None; 기본값 = None
LTO 색인 파일 경로입니다.
thinlto_input_bitcode_file string; or None; default = None
LTO 백엔드에 입력되는 비트코드 파일입니다.
thinlto_output_object_file string; or None; default = None
LTO 백엔드에서 출력하는 객체 파일입니다.
use_pic 기본값 = False
true이면 컴파일 시 위치 독립 코드가 생성됩니다.
add_legacy_cxx_options 기본값 = False
사용되지 않습니다.
variables_extension dict; 기본값 = unbound
컴파일 작업에서 사용하는 추가 변수의 사전입니다. 

LibraryToLink cc_common.create_library_to_link(actions, feature_configuration=None, cc_toolchain=None, static_library=None, pic_static_library=None, dynamic_library=None, interface_library=None, pic_objects=unbound, objects=unbound, alwayslink=False, dynamic_library_symlink_path='', interface_library_symlink_path='')

LibraryToLink를 만듭니다.

매개변수

매개변수 설명
actions required
actions 객체.
feature_configuration 기본값 = None
feature_configuration를 쿼리합니다.
cc_toolchain 기본값 = None
CcToolchainInfo 제공업체를 사용합니다.
static_library File; or None; default = None
링크할 정적 라이브러리의 File입니다.
pic_static_library File; or None; 기본값 = None
링크할 pic 정적 라이브러리의 File입니다.
dynamic_library File; or None; default = None
링크할 동적 라이브러리의 File입니다. 항상 런타임에 사용되며 interface_library가 전달되지 않은 경우 연결에 사용됩니다.
interface_library File; or None; 기본값 = None
링크할 인터페이스 라이브러리의 File입니다.
pic_objects sequence of Files; 기본값 = unbound
실험용, 사용하지 마세요.
objects sequence of Files; 기본값 = unbound
실험용, 사용하지 마세요.
기본값 = False
--whole_archive 블록에서 정적 라이브러리/객체를 연결할지 여부입니다.
string; default = ''
solib 디렉터리의 동적 라이브러리 링크의 기본 경로를 재정의합니다. 기본값을 사용하려면 빈 문자열을 사용합니다.
default = ''
solib 디렉터리의 인터페이스 라이브러리 링크의 기본 경로를 재정의합니다. 기본값을 사용하려면 빈 문자열을 사용합니다. 

Variables cc_common.create_link_variables(cc_toolchain, feature_configuration, library_search_directories=None, runtime_library_search_directories=None, user_link_flags=None, output_file=None, param_file=None, def_file=None, is_using_linker=True, is_linking_dynamic_library=False, must_keep_debug=True, use_test_only_flags=False, is_static_linking_mode=True)

작업 연결에 사용되는 링크 변수를 반환합니다.

매개변수

매개변수 설명
required
빌드 변수를 만들 cc_toolchain
required
쿼리할 기능 구성입니다.
None; or depset; default = None
링커가 연결 시 라이브러리를 찾을 디렉터리의 Depset입니다.
None; or depset; default = None
로더가 런타임에 라이브러리를 찾을 디렉터리의 Depset입니다.
None; or sequence; 기본값 = None
추가 링크 플래그 (linkopts) 목록입니다.
기본값 = None
선택적 출력 파일 경로입니다.
기본값 = None
선택적 매개변수 파일 경로입니다.
기본값 = None
선택적 .def 파일 경로입니다.
기본값 = True
링커를 사용하는 경우 True이고 보관 파일 생성 도구를 사용하는 경우 False입니다. 호출자는 이를 사용된 작업 이름과 동기화할 책임이 있습니다 (실행 파일 또는 동적 라이브러리 연결의 경우 is_using_linker = True, 정적 라이브러리 보관의 경우 is_using_linker = False).
기본값 = False
동적 라이브러리를 만들 때는 True이고 실행 파일 또는 정적 라이브러리인 경우에는 False입니다. 호출자는 이를 사용된 작업 이름과 동기화할 책임이 있습니다. 이 필드는 b/65151735가 수정되면 삭제됩니다.
기본값 = True
True로 설정하면 bazel은 'strip_debug_symbols' 변수를 노출합니다. 이 변수는 일반적으로 링커를 사용하여 출력 파일에서 디버그 기호를 제거하는 데 사용됩니다.
기본값 = False
true로 설정하면 'is_cc_test' 변수가 설정됩니다.
기본값 = True
사용되지 않습니다.

create_linker_input

LinkerInput cc_common.create_linker_input(owner, libraries=None, user_link_flags=None, additional_inputs=None)

LinkerInput를 만듭니다.

매개변수

매개변수 설명
owner 필수
이 입력에 사용된 모든 파일을 생성한 타겟의 라벨입니다.
libraries None; or depset; default = None
LibraryToLink 목록입니다.
None; or depset of strings; or sequence of strings; default = None
사용자 링크 플래그가 문자열로 전달됩니다. [String], [[String]] 또는 depset(String)을 허용합니다. 후자는 호환성 목적으로만 유지되므로 권장하지 않으며, depset은 평면화됩니다. 평면화되지 않은 depsets()를 통해 user_link_flags를 전파하려면 끝까지 평면화되지 않도록 LinkerInput으로 래핑합니다.
additional_inputs None; or depset; default = None
연결 작업에 대한 추가 입력입니다(예: 연결 스크립트).

create_linking_context

LinkingContext cc_common.create_linking_context(linker_inputs=None, libraries_to_link=None, user_link_flags=None, additional_inputs=None)

LinkingContext를 만듭니다.

매개변수

매개변수 설명
linker_inputs None; or depset; default = None
LinkerInput의 Depset입니다.
None; or sequence; default = None
지원 중단됨. 이 매개변수는 지원 중단되었으며 곧 삭제됩니다. 이 방법을 사용하지 마세요. --+incompatible_require_linker_input_cc_api를 사용하면 사용 중지됩니다. 이 플래그를 사용하여 코드가 예정된 삭제와 호환되는지 확인합니다.
LibraryToLink 목록입니다.
None; or sequence; default = None
지원 중단됨. 이 매개변수는 지원 중단되었으며 곧 삭제됩니다. 이 방법을 사용하지 마세요. --+incompatible_require_linker_input_cc_api를 사용하면 사용 중지됩니다. 이 플래그를 사용하여 코드가 예정된 삭제와 호환되는지 확인합니다.
문자열로 전달된 사용자 링크 플래그 목록입니다.
additional_inputs None; or sequence; default = None
지원 중단됨. 이 매개변수는 지원 중단되었으며 곧 삭제됩니다. 이 방법을 사용하지 마세요. --+incompatible_require_linker_input_cc_api를 사용하면 사용 중지됩니다. 이 플래그를 사용하여 코드가 예정된 삭제와 호환되는지 확인합니다.
연결 작업에 대한 추가 입력입니다(예: 연결 스크립트).

create_linking_context_from_compilation_outputs

tuple cc_common.create_linking_context_from_compilation_outputs(actions, feature_configuration, cc_toolchain, compilation_outputs, user_link_flags=[], linking_contexts=[], name, language='c++', alwayslink=False, additional_inputs=[], disallow_static_libraries=False, disallow_dynamic_library=False, grep_includes=None)

나중에 실행 파일 또는 동적 라이브러리를 만들기 위해 전이 연결을 실행하는 최상위 규칙에 의해 연결되도록 정보를 다운스트림으로 전파할 수 있는 라이브러리 규칙을 만드는 데 사용해야 합니다. (CcLinkingContext, CcLinkingOutputs) 튜플을 반환합니다.

매개변수

매개변수 설명
actions required
actions 객체.
feature_configuration required
feature_configuration to be queried.
cc_toolchain required
CcToolchainInfo 제공자를 사용해야 합니다.
compilation_outputs required
연결할 객체 파일이 포함된 컴파일 출력입니다.
default = []
연결 옵션의 추가 목록입니다.
linking_contexts default = []
종속 항목의 라이브러리입니다. 이러한 라이브러리는 바이너리 또는 라이브러리와 관계없이 link() 호출의 출력 아티팩트에 연결됩니다.
name 필수
이 메서드로 생성된 작업의 출력 아티팩트 이름을 지정하는 데 사용됩니다.
language default = 'c++'
현재 C++만 지원됩니다. 이 매개변수를 사용하지 마세요.
기본값 = False
이 라이브러리를 항상 연결해야 하는지 여부입니다.
additional_inputs default = []
연결 작업에 대한 추가 입력입니다(예: 연결 스크립트).
disallow_static_libraries default = False
정적 라이브러리를 만들어야 하는지 여부입니다.
disallow_dynamic_library default = False
동적 라이브러리를 만들어야 하는지 여부입니다.
grep_includes File; or None; default = None

do_not_use_tools_cpp_compiler_present

None cc_common.do_not_use_tools_cpp_compiler_present

이 필드는 사용하지 마세요. 이 필드의 유일한 목적은 config_setting.values{'compiler')에서 config_settings.flag_values{'@bazel_tools//tools/cpp:compiler'}로 이전하는 데 도움이 되는 것입니다.

get_environment_variables

dict cc_common.get_environment_variables(feature_configuration, action_name, variables)

지정된 작업에 설정할 환경 변수를 반환합니다.

매개변수

매개변수 설명
feature_configuration required
쿼리할 기능 구성입니다.
action_name 필수
액션의 이름입니다. @bazel_tools//tools/build_defs/cc:action_names.bzl (https://github.com/bazelbuild/bazel/blob/master/tools/build_defs/cc/action_names.bzl)의 이름 중 하나여야 합니다.
variables required
템플릿 확장에 사용할 빌드 변수입니다.

get_execution_requirements

sequence cc_common.get_execution_requirements(feature_configuration, action_name)

지정된 작업의 실행 요구사항을 반환합니다.

매개변수

매개변수 설명
feature_configuration required
쿼리할 기능 구성입니다.
action_name 필수
액션의 이름입니다. @bazel_tools//tools/build_defs/cc:action_names.bzl (https://github.com/bazelbuild/bazel/blob/master/tools/build_defs/cc/action_names.bzl)의 이름 중 하나여야 합니다.

get_memory_inefficient_command_line

sequence cc_common.get_memory_inefficient_command_line(feature_configuration, action_name, variables)

지정된 변수를 사용하여 지정된 작업의 평면화된 명령줄 플래그를 반환합니다. 중첩된 집합을 평면화하며, 가급적 사용하지 않거나 적어도 분석보다 오래 지속되어서는 안 됩니다. Args를 반환하는 메모리 효율적인 함수에 관한 작업이 진행 중입니다.

매개변수

매개변수 설명
feature_configuration required
쿼리할 기능 구성입니다.
action_name 필수
액션의 이름입니다. @bazel_tools//tools/build_defs/cc:action_names.bzl (https://github.com/bazelbuild/bazel/blob/master/tools/build_defs/cc/action_names.bzl)의 이름 중 하나여야 합니다.
variables 필수
템플릿 확장에 사용할 빌드 변수입니다.

get_tool_for_action

string cc_common.get_tool_for_action(feature_configuration, action_name)

지정된 작업의 도구 경로를 반환합니다.

매개변수

매개변수 설명
feature_configuration required
쿼리할 기능 구성입니다.
action_name 필수
액션의 이름입니다. @bazel_tools//tools/build_defs/cc:action_names.bzl (https://github.com/bazelbuild/bazel/blob/master/tools/build_defs/cc/action_names.bzl)의 이름 중 하나여야 합니다.

is_enabled

bool cc_common.is_enabled(feature_configuration, feature_name)

지정된 기능이 기능 구성에서 사용 설정된 경우 true를 반환합니다.

매개변수

매개변수 설명
feature_configuration required
쿼리할 기능 구성입니다.
feature_name 필수
기능의 이름입니다. 

CcLinkingOutputs cc_common.link(actions, feature_configuration, cc_toolchain, compilation_outputs=None, user_link_flags=[], linking_contexts=[], name, language='c++', output_type='executable', link_deps_statically=True, stamp=0, additional_inputs=[], grep_includes=None, additional_outputs=unbound)

C++ 전이 연결에 사용해야 합니다.

매개변수

매개변수 설명
actions required
actions 객체.
feature_configuration required
feature_configuration to be queried.
cc_toolchain required
CcToolchainInfo 제공자를 사용해야 합니다.
compilation_outputs CcCompilationOutputs; or None; default = None
연결할 객체 파일이 포함된 컴파일 출력입니다.
default = []
추가 링커 옵션 목록입니다.
linking_contexts default = []
이 규칙에 의해 생성된 연결 컨텍스트에 연결할 종속 항목의 연결 컨텍스트입니다.
name 필수
이 메서드로 생성된 작업의 출력 아티팩트 이름을 지정하는 데 사용됩니다.
language default = 'c++'
현재 C++만 지원됩니다. 이 매개변수를 사용하지 마세요.
output_type default = 'executable'
'executable' 또는 'dynamic_library'일 수 있습니다.
기본값 = True
종속 항목을 정적 방식으로 연결하려면 true, 동적 방식으로 연결하려면 false입니다.
stamp 기본값 = 0
output_type이 'executable'인 경우 연결된 실행 파일에 빌드 정보를 포함할지 여부입니다. 1이면 빌드 정보가 항상 포함됩니다. 0인 경우 (기본 빌드 정보는 항상 제외됨) -1인 경우 기본 동작을 사용하며, 이는 --[no]stamp 플래그로 재정의할 수 있습니다. 테스트 규칙의 실행 파일 출력을 생성할 때는 이 값을 설정 해제하거나 0으로 설정해야 합니다.
additional_inputs sequence; or depset; default = []
연결 작업에 대한 추가 입력입니다(예: 연결 스크립트).
grep_includes File; or None; default = None
additional_outputs sequence; default = unbound
연결 작업의 추가 출력입니다(예: 맵 파일).

merge_cc_infos

CcInfo cc_common.merge_cc_infos(direct_cc_infos=[], cc_infos=[])

여러 개의 CcInfo를 하나로 병합합니다.

매개변수

매개변수 설명
direct_cc_infos default = []
병합할 CcInfo 목록입니다. 반환된 제공업체의 직접 필드에서 헤더를 내보냅니다.
cc_infos 기본값 = []
병합할 CcInfo 목록입니다. 이 목록의 헤더는 반환된 제공업체의 직접 필드에 의해 내보내지 않습니다.

merge_compilation_contexts

CompilationContext cc_common.merge_compilation_contexts(compilation_contexts=[])

여러 개의 CompilationContexts를 하나로 병합합니다.

매개변수

매개변수 설명
compilation_contexts default = []
병합할 CompilationContexts 목록입니다. 각 컨텍스트의 헤더는 반환된 제공업체의 직접 필드에 의해 내보내집니다.

merge_compilation_outputs

CcCompilationOutputs cc_common.merge_compilation_outputs(compilation_outputs=[])

컴파일 출력을 병합합니다.

매개변수

매개변수 설명
compilation_outputs default = []