成员
- action_is_enabled
- CcToolchainInfo
- 编译compile
- configure_features
- create_cc_toolchain_config_info
- create_compilation_context
- create_compilation_outputs
- create_compile_variables
- create_library_to_link
- create_link_variables
- create_linker_input
- create_linking_context
- create_linking_context_from_compilation_outputs
- do_not_use_tools_cpp_compiler_present
- get_environment_variables
- get_execution_requirements
- get_memory_inefficient_command_line
- get_tool_for_action
- is_enabled
- 链接
- merge_compilation_contexts
- merge_compilation_outputs
action_is_enabled
bool cc_common.action_is_enabled(feature_configuration, action_name)如果在功能配置中启用指定的 action_config,则返回 True。
参数
参数 | 说明 |
---|---|
feature_configuration
|
必需 要查询的功能配置。 |
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=[])应该用于 C++ 编译。返回 (
CompilationContext
, CcCompilationOutputs
) 的元组。
参数
参数 | 说明 |
---|---|
actions
|
必需actions 对象。
|
feature_configuration
|
必需feature_configuration 才能查询。
|
cc_toolchain
|
必需CcToolchainInfo 提供方。
|
srcs
|
默认值为 [] 要编译的源文件列表。 |
public_hdrs
|
默认值为 [] 编译 src 所需的标头列表,可以由相关规则传递以传递。 |
private_hdrs
|
默认值为 [] 编译 src 所需的标头列表,并且依赖规则不包含的标头。 |
includes
|
sequence; 或 depset;默认值为 [] 由尖括号和引号引用的头文件的搜索路径。通常通过 -I 传递。以传递方式传播到依赖项。 |
quote_includes
|
默认值为 [] 引号引用的头文件的搜索路径,例如 #include "foo/bar/header.h"。它们可以是相对于 exec 根目录,也可以是绝对路径。通常与 -iquote 一起传递。以传递方式传播到依赖项。 |
system_includes
|
默认值为 [] 由尖括号引用的头文件的搜索路径,例如 #include <foo/bar/header.h>。它们可以相对于 exec 根目录,也可以是绝对路径。通常通过 -isystem 传递。以传递方式传播到依赖项。 |
framework_includes
|
默认值为 [] Apple 框架中头文件的搜索路径。它们可以是相对于 exec 根目录,也可以是绝对路径。通常通过 -F 传递。以传递方式传播到依赖项。 |
defines
|
默认值为 [] 编译此目标所需的一组定义。每个定义都是一个字符串。以传递方式传播到依赖项。 |
local_defines
|
默认值为 [] 编译此目标所需的一组定义。每个定义都是一个字符串。不会以传递方式传播到从属项。 |
include_prefix
|
默认值为 '' 要添加到此规则标头路径中的前缀。设置后,此规则的 hdrs 属性中的标头将可通过此属性访问,即附加到相应代码库相对路径的值。在添加此前缀之前,移除 trip_include_prefix 属性中的前缀。 |
strip_include_prefix
|
默认值为 '' 要从此规则的标头路径中移除的前缀。设置后,此规则的 hdrs 属性中的标头可通过其路径(此前缀被截断)访问。如果是相对路径,系统会将其视为相对软件包。如果该路径是绝对路径,则会被理解为代码库相对路径。系统会在删除此前缀后添加 include_prefix 属性中的前缀。 |
user_compile_flags
|
默认值为 [] 其他编译选项列表。 |
compilation_contexts
|
默认值为 [] 来自用于编译的依赖项的头文件。 |
name
|
必需 此属性用于为此方法创建的操作的输出工件命名。另请参阅“main_output”参数。 |
disallow_pic_outputs
|
默认值为 False 是否应创建 PIC 输出。 |
disallow_nopic_outputs
|
默认值为 False 是否应创建 NOPIC 输出。 |
additional_inputs
|
默认值为 [] 编译 src 所需的其他文件的列表 |
configure_features
FeatureConfiguration cc_common.configure_features(ctx=None, cc_toolchain, language=None, requested_features=[], unsupported_features=[])创建 feature_configuration 实例。需要 cpp 配置 fragment。
参数
参数 | 说明 |
---|---|
ctx
|
ctx;或 None ;默认值为 None 规则上下文。 |
cc_toolchain
|
必需 我们为其配置功能的 cc_toolchain。 |
language
|
string;或 None ;默认值为 None 要配置的语言:c++ 或 objc(默认 c++) |
requested_features
|
默认值为 [] 要启用的功能的列表。 |
unsupported_features
|
默认值为 [] 当前规则不支持的功能列表。 |
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)创建
CcToolchainConfigInfo
提供程序
参数
参数 | 说明 |
---|---|
ctx
|
必需 规则上下文。 |
features
|
默认值为 [] 包含一项功能的所有标志规范。 参数:
- provides 包含我们要启用的其他功能或操作配置的名称。- provides 包含的值与我们要启用的其他功能或操作配置中的“提供”的值相同。这样做是为了确保不兼容的功能不会被意外激活,从而导致难以诊断编译器错误。
|
action_configs
|
默认值为 [] 操作配置与 Bazel 操作相对应,可让您根据已启用的功能选择工具。操作配置激活的语义与功能相同:功能可以像其他功能一样使用或“暗示”操作配置。 参数:
|
artifact_name_patterns
|
默认值为 [] 操作的指定类别输入或输出工件的工件名称。 参数:
|
cxx_builtin_include_directories
|
默认值为 [] 用于 C++ 编译的内置 include 目录。这些路径应该与编译器所用的路径完全一致,并且通常相对于 exec 根目录。 编译器使用的路径可通过“gcc -E -xc++ - -v”确定。 我们目前也将 C++ 路径用于 C 编译,只要 C++ 和 C 头文件之间没有名称冲突,这就是安全的。 相对路径是相对于配置文件目录进行解析的。 如果编译器支持 --sysroot,则这些路径应使用 %sysroot% 而非包含路径,并且指定 sysroot 属性,以便为 blaze 提供执行正确替换所需的信息。 |
toolchain_identifier
|
必需 交叉工具版本中工具链的唯一标识符。必须能够将其用作路径中的目录名称。 它必须匹配以下正则表达式:[a-zA-Z_][\.\- \w]* |
host_system_name
|
string;或 None ;默认值为 None 已忽略。 |
target_system_name
|
必需 GNU 系统名称。 |
target_cpu
|
必需 目标架构字符串。 |
target_libc
|
required libc 版本字符串(例如“glibc-2.2.2”)。如果字符串为“macosx”,则假定平台为 MacOS。否则,Linux |
compiler
|
必需 编译器字符串(例如“gcc”)。当前工具链的编译器会作为标记值提供给 `@bazel_tools//tools/cpp:compiler (compiler_flag)`。需要编译器专用标志的目标可以在 select() 语句中使用 https://github.com/bazelbuild/rules_cc/blob/main/cc/compiler/BUILD 中的 config_settings,如果现有设置不足以满足需求,也可以创建自定义 config_setting。 |
abi_version
|
string;或 None ;默认值为 None 使用的 abi 是 gcc 版本。E.g.: “gcc-3.4” |
abi_libc_version
|
string; 或 None ;默认值为 None 我们正在使用的 abi 使用的 glibc 版本。 |
tool_paths
|
默认值为 [] 工具位置。 参数:
|
make_variables
|
默认值为 [] 可供规则访问的 make 变量。 |
builtin_sysroot
|
string;或 None ;默认值为 None 内置 sysroot。如果此属性不存在,则 Bazel 不允许使用其他 sysroot,即通过 --grte_top 选项。 |
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;或 None ;默认为 None 对象文件列表。 |
pic_objects
|
depset;或 None ;默认值为 None 图片对象文件列表。 |
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
|
必需 我们要为其创建 build 变量的 cc_toolchain。 |
feature_configuration
|
必需 要查询的功能配置。 |
source_file
|
默认值为 None 编译的可选源文件。请在此处传递 source_file,而不是将其附加到通过 cc_common.get_memory_inefficiency_command_line 生成的命令行的末尾,因为工具链作者可以借助它来正确指定和定位编译器标志。 |
output_file
|
默认值为 None 编译的可选输出文件。请在此处传递 output_file,而不是将其附加到通过 cc_common.get_memory_ineffective_command_line 生成的命令行的末尾。这样一来,工具链作者便可正确指定和定位编译器标志。 |
user_compile_flags
|
string 类型的序列;或 None ;默认为 None 其他编译标记 (copt) 的列表。 |
include_directories
|
depset; 或 None ;默认为 None 包含目录的依赖项。 |
quote_include_directories
|
depset; 或 None ;默认为 None quote 包含目录的依赖项。 |
system_include_directories
|
depset; 或 None ;默认值为 None 系统 include 目录的依赖项。 |
framework_include_directories
|
depset; 或 None ;默认值为 None 框架包含目录的依赖项。 |
preprocessor_defines
|
depset; 或 None ;默认值为 None 预处理器定义的 Depset。 |
thinlto_index
|
string;或 None ;默认值为 None 。LTO 索引文件路径。 |
thinlto_input_bitcode_file
|
string;或 None ;默认为 None 输入到 LTO 后端的位码文件。 |
thinlto_output_object_file
|
string;或 None ;默认为 None LTO 后端输出的对象文件。 |
use_pic
|
默认值为 False 如果设置为 true,编译将生成位置无关代码。 |
add_legacy_cxx_options
|
默认值为 False Unused。 |
variables_extension
|
dict;默认值为 unbound 编译操作使用的其他变量的字典。 |
create_library_to_link
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
|
必需actions 对象。
|
feature_configuration
|
要查询的值为 None feature_configuration 。 |
cc_toolchain
|
默认为 None 要使用的 CcToolchainInfo 提供程序。 |
static_library
|
File;或 None ;默认为要链接的静态库的 None File 。
|
pic_static_library
|
File;或 None ;默认为要链接的图片静态库的 None File 。
|
dynamic_library
|
File;或 None ;默认为要链接的动态库的 None File 。始终用于运行时,如果未传递 interface_library ,则用于链接。
|
interface_library
|
File;或 None ;默认为要关联的接口库的 None File 。
|
pic_objects
|
File 的 Sequence;默认值为 unbound 实验性,请勿使用 |
objects
|
File 的 Sequence;默认值为 unbound 实验性,请勿使用 |
alwayslink
|
默认值为 False 是否关联 --whole_archive 块中的静态库/对象。 |
dynamic_library_symlink_path
|
string;默认值为 '' 替换 solib 目录中动态库链接的默认路径。空字符串以使用默认值。 |
interface_library_symlink_path
|
默认值为 '' 替换 solib 目录中的接口库链接的默认路径。空字符串以使用默认值。 |
create_link_variables
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, is_using_linker=True, is_linking_dynamic_library=False, must_keep_debug=True, use_test_only_flags=False, is_static_linking_mode=True)返回用于链接操作的链接变量。
参数
参数 | 说明 |
---|---|
cc_toolchain
|
必需 我们要为其创建 build 变量的 cc_toolchain。 |
feature_configuration
|
必需 要查询的功能配置。 |
library_search_directories
|
None 或 depset;默认值为 None 链接器会在链接时查找库的目录的表示目录。 |
runtime_library_search_directories
|
None 或 depset;默认值为 None 加载程序将在运行时查找库的目录的依赖项。 |
user_link_flags
|
None ;或 sequence;默认值为 None 其他链接标记 (linkopts) 的列表。 |
output_file
|
默认值为 None 可选的输出文件路径。 |
param_file
|
默认值为 None 可选参数文件路径。 |
is_using_linker
|
默认值为 True 使用链接器时为 true,归档程序为 false。调用方负责确保此 ID 与使用的操作名称保持同步(对于链接可执行文件或动态库,is_using_linker = True,对于归档静态库,is_using_linker = False)。 |
is_linking_dynamic_library
|
默认值为 False 创建动态库时为 true,如果是可执行文件或静态库,则为 false。调用方负责确保此 ID 与所用的操作名称保持同步。b/65151735 一经修复,此字段将被移除。 |
must_keep_debug
|
默认值为 True 如果设置为 False,bazel 将公开“strip_debug_symbols”变量,该变量通常用于使用链接器从输出文件中删除调试符号。 |
use_test_only_flags
|
默认值为 False 如果此政策设为 true,系统将会设置“is_cc_test”变量。 |
is_static_linking_mode
|
默认值为 True Unused。 |
create_linker_input
LinkerInput cc_common.create_linker_input(owner, libraries=None, user_link_flags=None, additional_inputs=None)创建
LinkerInput
。
参数
参数 | 说明 |
---|---|
owner
|
必需 生成此输入中使用的所有文件的目标标签。 |
libraries
|
None 或 depset;默认值为 None LibraryToLink 的列表。 |
user_link_flags
|
None ;或 string 的 depset;或 string 的 序列;默认值为 None 作为字符串传递的用户链接标志。接受 [String]、[[String]] 或 depset(String)。不建议采用后一种方式,因为它只是为了实现兼容性而保留,并且该扩展是扁平化的。如果您想通过未展平的 depsets() 传播 user_link_flags,请将它们封装在 LinkerInput 中,以免它们一直扁平化到最后。 |
additional_inputs
|
None 或 depset;默认值为 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 或 depset;默认值为 None Depset 为 LinkerInput 。 |
libraries_to_link
|
None ;或 sequence;默认为 None 已弃用。此参数已被弃用,很快就会被移除。请不要依赖它。已通过 --+incompatible_require_linker_input_cc_api 停用。使用此标记验证您的代码是否适用于即将移除的代码。LibraryToLink 的列表。
|
user_link_flags
|
None ;或 sequence;默认为 None 已弃用。此参数已被弃用,很快就会被移除。请不要依赖它。已通过 --+incompatible_require_linker_input_cc_api 停用。使用此标记验证您的代码是否适用于即将移除的代码。以字符串形式传递的用户链接标志列表。 |
additional_inputs
|
None ;或 sequence;默认为 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)应该用于创建能够向下游传播信息的库规则,以便之后通过执行传递链接以创建可执行文件或动态库的顶级规则进行链接。返回 (
CcLinkingContext
, CcLinkingOutputs
) 的元组。
参数
参数 | 说明 |
---|---|
actions
|
必需actions 对象。
|
feature_configuration
|
必需feature_configuration 才能查询。
|
cc_toolchain
|
必需CcToolchainInfo 提供方。
|
compilation_outputs
|
必需 包含要链接的目标文件的编译输出。 |
user_link_flags
|
默认值为 [] 其他关联选项列表。 |
linking_contexts
|
默认为 [] 来自依赖项的库。这些库将链接到 link() 调用的输出工件(无论是二进制文件还是库)。 |
name
|
必需 此属性用于为此方法创建的操作的输出工件命名。 |
language
|
默认值为 'c++' 目前仅支持 C++。请勿使用此参数。 |
alwayslink
|
默认值为 False 是否应始终关联此库。 |
additional_inputs
|
默认值为 [] 对于关联操作的其他输入,例如链接脚本。 |
disallow_static_libraries
|
默认值为 False 是否应创建静态库。 |
disallow_dynamic_library
|
默认值为 False 是否应创建动态库。 |
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
|
必需 要查询的功能配置。 |
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
|
必需 要用于模板扩展的 build 变量。 |
get_execution_requirements
sequence cc_common.get_execution_requirements(feature_configuration, action_name)返回指定操作的执行要求。
参数
参数 | 说明 |
---|---|
feature_configuration
|
必需 要查询的功能配置。 |
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
|
必需 要查询的功能配置。 |
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
|
必需 要用于模板扩展的 build 变量。 |
get_tool_for_action
string cc_common.get_tool_for_action(feature_configuration, action_name)返回指定操作的工具路径。
参数
参数 | 说明 |
---|---|
feature_configuration
|
必需 要查询的功能配置。 |
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
|
必需 要查询的功能配置。 |
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=[], additional_outputs=unbound)应该用于 C++ 传递链接。
参数
参数 | 说明 |
---|---|
actions
|
必需actions 对象。
|
feature_configuration
|
必需feature_configuration 才能查询。
|
cc_toolchain
|
必需CcToolchainInfo 提供方。
|
compilation_outputs
|
CcCompilationOutputs;或 None ;默认值为 None 包含要链接的目标文件的编译输出。 |
user_link_flags
|
默认值为 [] 其他链接器选项列表。 |
linking_contexts
|
默认值为 [] 要关联到此规则生成的关联上下文的关联上下文。 |
name
|
必需 此属性用于为此方法创建的操作的输出工件命名。 |
language
|
默认值为 'c++' 目前仅支持 C++。请勿使用此参数。 |
output_type
|
默认值为 'executable' 可以是“executable”或“dynamic_library”。 |
link_deps_statically
|
默认值为 True True 表示静态关联依赖项,False 表示动态关联依赖项。 |
stamp
|
默认值为 0 如果 output_type 为“executable”,是否要将 build 信息包含在关联的可执行文件中。如果为 1,则始终包含 build 信息。如果为 0(始终排除默认 build 信息。如果为 -1,则使用默认行为,该行为可能会被 --[no]stamp 标记替换。为测试规则生成可执行输出时,此值应未设置(或设置为 0)。 |
additional_inputs
|
sequence 或 depset;默认值为 [] 表示链接操作的其他输入,例如链接脚本。 |
additional_outputs
|
sequence;默认值为 unbound 表示链接操作的其他输出,例如映射文件。 |
merge_compilation_contexts
CompilationContext cc_common.merge_compilation_contexts(compilation_contexts=[])将多个
CompilationContexts
合并为一个。
参数
参数 | 说明 |
---|---|
compilation_contexts
|
默认值为 [] 要合并的 CompilationContexts 的列表。每个上下文的标头都将由返回的提供程序中的直接字段导出。 |
merge_compilation_outputs
CcCompilationOutputs cc_common.merge_compilation_outputs(compilation_outputs=[])合并编译输出。
参数
参数 | 说明 |
---|---|
compilation_outputs
|
默认值为 [] |