规则
- cc_binary
- cc_import
- cc_library
- cc_proto_library
- cc_shared_library
- fdo_prefetch_hints
- fdo_profile
- memprof_profile
- propeller_optimize
- cc_test
- cc_toolchain
- cc_toolchain_suite
cc_binary
查看规则源代码cc_binary(name, deps, srcs, data, additional_linker_inputs, args, compatible_with, copts, defines, deprecation, distribs, env, exec_compatible_with, exec_properties, features, includes, licenses, link_extra_lib, linkopts, linkshared, linkstatic, local_defines, malloc, nocopts, output_licenses, restricted_to, stamp, tags, target_compatible_with, testonly, toolchains, visibility, win_def_file)
隐式输出目标
name.stripped
(仅在明确请求时构建):剥离 二进制文件版本。系统会在二进制文件上运行strip -g
以移除调试符号。您可以在命令行中使用--stripopt=-foo
提供其他剥离选项。只有在明确请求时,系统才会构建此输出。name.dwp
(仅在明确请求时构建):如果启用了 Fission:适用于调试远程部署的二进制文件的调试信息软件包文件。否则:空文件。
参数
属性 | |
---|---|
name |
名称;必需 此目标的唯一名称。 |
deps
|
标签列表;默认值为 这些值可以是 |
srcs
|
标签列表;默认值为 系统会编译所有
所有 如果某个规则的名称在
允许的
...以及生成这些文件的任何规则。 不同的扩展表示不同的编程语言, 。 |
additional_linker_inputs
|
标签列表;默认值为 例如,您可以在此处提供已编译的 Windows .res 文件,以便将其嵌入到二进制目标中。 |
copts
|
字符串列表;默认值为
在编译二进制目标之前,此属性中的每个字符串都会按给定顺序添加到
如果该软件包声明了 feature,
|
defines
|
字符串列表;默认值为 -D ,并添加到编译命令行中,
以及依赖于该规则的每条规则请务必小心,
产生深远的影响。如果不确定,请改为向 local_defines 添加定义值。
|
includes
|
字符串列表;默认值为
需遵循“Make 变量”替换规则。
每个字符串都带有 必须将头文件添加到 srcs 或 hdrs,否则在编译沙盒化(默认)时,依赖项规则将无法使用这些头文件。 |
link_extra_lib
|
标签;默认值为
默认情况下,C++ 二进制文件会与 |
linkopts
|
字符串列表;默认值为 LINKOPTS 。
此列表中将出现每个不以 |
linkshared
|
创建一个共享库。
如需启用此属性,请在规则中添加 linkshared=True 。默认情况下
此选项处于停用状态
此标志的存在表示
如果您同时指定 |
linkstatic
|
布尔值;默认值为 cc_binary 和 cc_test :在静态模式下关联二进制文件。对于 cc_library.linkstatic :请参阅下文。
默认情况下,系统会为
如果已启用,并且是二进制文件或测试文件,此选项将指示构建工具加入
尽可能为用户库使用 实际上,有三种不同的方式可以关联可执行文件:
如果将
如果为 |
local_defines
|
字符串列表;默认值为 -D ,并添加到此目标的编译命令行,但不会添加到其依赖项。
|
malloc
|
标签;默认值为
默认情况下,C++ 二进制文件会与 |
nocopts
|
字符串;默认值为 COPTS
(包括规则的 copts 属性中明确指定的值)将从
COPTS ,以便编译此规则。
您应该很少需要此属性。
|
stamp
|
整数;默认为
除非其依赖项发生变化,否则带时间戳的二进制文件不会被重新构建。 |
win_def_file
|
标签;默认值为 仅当 Windows 是目标平台时,才应使用此属性。 它可用于 导出符号。 |
cc_import
查看规则来源cc_import(name, deps, data, hdrs, alwayslink, compatible_with, deprecation, distribs, features, interface_library, licenses, restricted_to, shared_library, static_library, system_provided, tags, target_compatible_with, testonly, visibility)
cc_import
规则允许用户导入预编译的 C/C++ 库。
以下是典型的用例:
1.关联静态库
cc_import( name = "mylib", hdrs = ["mylib.h"], static_library = "libmylib.a", # If alwayslink is turned on, # libmylib.a will be forcely linked into any binary that depends on it. # alwayslink = 1, )2.关联共享库 (Unix)
cc_import( name = "mylib", hdrs = ["mylib.h"], shared_library = "libmylib.so", )3. 将共享库与接口库相关联 (Windows)
cc_import( name = "mylib", hdrs = ["mylib.h"], # mylib.lib is an import library for mylib.dll which will be passed to linker interface_library = "mylib.lib", # mylib.dll will be available for runtime shared_library = "mylib.dll", )4.将共享库与
system_provided=True
关联 (Windows)
cc_import( name = "mylib", hdrs = ["mylib.h"], # mylib.lib is an import library for mylib.dll which will be passed to linker interface_library = "mylib.lib", # mylib.dll is provided by system environment, for example it can be found in PATH. # This indicates that Bazel is not responsible for making mylib.dll available. system_provided = 1, )5.链接到静态或共享库
在 Unix 上:
cc_import( name = "mylib", hdrs = ["mylib.h"], static_library = "libmylib.a", shared_library = "libmylib.so", ) # first will link to libmylib.a cc_binary( name = "first", srcs = ["first.cc"], deps = [":mylib"], linkstatic = 1, # default value ) # second will link to libmylib.so cc_binary( name = "second", srcs = ["second.cc"], deps = [":mylib"], linkstatic = 0, )在 Windows 上:
cc_import( name = "mylib", hdrs = ["mylib.h"], static_library = "libmylib.lib", # A normal static library interface_library = "mylib.lib", # An import library for mylib.dll shared_library = "mylib.dll", ) # first will link to libmylib.lib cc_binary( name = "first", srcs = ["first.cc"], deps = [":mylib"], linkstatic = 1, # default value ) # second will link to mylib.dll through mylib.lib cc_binary( name = "second", srcs = ["second.cc"], deps = [":mylib"], linkstatic = 0, )
cc_import
支持 include 属性。例如:
cc_import( name = "curl_lib", hdrs = glob(["vendor/curl/include/curl/*.h"]), includes = [ "vendor/curl/include" ], shared_library = "vendor/curl/lib/.libs/libcurl.dylib", )
参数
属性 | |
---|---|
name |
姓名;必需 此目标的唯一名称。 |
deps
|
标签列表;默认值为 deps 的一般评论
大多数构建规则。
|
hdrs
|
标签列表;默认值为 |
alwayslink
|
布尔值;默认值为 如果 alwayslink 不适用于 Windows 上的 VS 2017,则是因为存在已知问题,请将 VS 2017 升级到最新版本。 |
interface_library
|
标签;默认值为 允许的文件类型: |
shared_library
|
标签;默认值为 允许的文件类型:
|
static_library
|
标签;默认值为 允许的文件类型: |
system_provided
|
布尔值;默认值为 interface_library ,
“shared_library ”应该为空。
|
cc_library
查看规则源代码cc_library(name, deps, srcs, data, hdrs, additional_compiler_inputs, additional_linker_inputs, alwayslink, compatible_with, copts, defines, deprecation, distribs, exec_compatible_with, exec_properties, features, implementation_deps, include_prefix, includes, licenses, linkopts, linkstamp, linkstatic, local_defines, nocopts, restricted_to, strip_include_prefix, tags, target_compatible_with, testonly, textual_hdrs, toolchains, visibility, win_def_file)
标头包含性检查
构建过程中使用的所有头文件都必须在 cc_*
规则的 hdrs
或 srcs
中声明。强制执行。
对于 cc_library
规则,hdrs
中的标头包含
库,并且可以直接包含在 hdrs
和
库本身的 srcs
,以及 hdrs
和
cc_*
规则中的 srcs
项会在其 deps
中列出该库。
srcs
中的头文件只能直接从库本身的 hdrs
和 srcs
中的文件中包含。在决定将头文件放入 hdrs
还是 srcs
时,您应考虑是否希望此库的使用方能够直接包含该头文件。这与在编程语言中选择 public
和 private
可见性大致相同。
cc_binary
和 cc_test
规则没有导出的接口,因此它们
也不具有 hdrs
属性。属于二进制文件或测试文件的所有头文件
srcs
中应直接列出。
下面的示例说明了这些规则。
cc_binary( name = "foo", srcs = [ "foo.cc", "foo.h", ], deps = [":bar"], ) cc_library( name = "bar", srcs = [ "bar.cc", "bar-impl.h", ], hdrs = ["bar.h"], deps = [":baz"], ) cc_library( name = "baz", srcs = [ "baz.cc", "baz-impl.h", ], hdrs = ["baz.h"], )
下表列出了此示例中允许的直接包含内容。例如,foo.cc
可以直接包含 foo.h
和 bar.h
,但不能包含 baz.h
。
包含文件 | 允许的包含项 |
---|---|
foo.h | bar.h |
foo.cc | foo.h bar.h |
bar.h | bar-impl.h,baz.h |
bar-impl.h | bar.h baz.h |
bar.cc | bar.h bar-impl.h baz.h |
baz.h | baz-impl.h |
baz-impl.h | baz.h |
baz.cc | baz.h baz-impl.h |
包含检查规则仅适用于直接
包含。在上面的示例中,foo.cc
可以
包括bar.h
,其中可能包括baz.h
,
允许 turn 包含 baz-impl.h
。从技术上讲
编译 .cc
文件可能会以传递方式包含任何头文件
文件放在 hdrs
或 srcs
传递 deps
闭包中的任何 cc_library
。在
在这种情况下,编译器可能会读取 baz.h
和 baz-impl.h
编译 foo.cc
时,但 foo.cc
不得
包含“#include "baz.h"
”。为此,必须将 baz
添加到 foo
的 deps
。
Bazel 依赖于工具链支持来强制执行包含检查规则。
工具链必须支持 layering_check
功能,并且必须明确请求该功能,例如通过 --features=layering_check
命令行标志或 package
函数的 features
参数。Bazel 提供的工具链仅在 Unix 和 macOS 上支持通过 clang 使用此功能。
参数
属性 | |
---|---|
name |
姓名;必需 此目标的唯一名称。 |
deps
|
标签列表;默认值为 这些值可以是 |
srcs
|
标签列表;默认值为 系统会编译所有
所有 如果某个规则的名称在
允许的
...以及生成这些文件的任何规则。 不同的扩展名表示不同的编程语言,具体取决于 gcc 惯例。 |
hdrs
|
标签列表;默认值为 这是声明
描述该库的接口这些标头将可供此规则或依赖规则中的来源包含。
此库的客户端不应包含的标头应
在 |
additional_compiler_inputs
|
标签列表;默认值为 |
additional_linker_inputs
|
标签列表;默认值为 例如,您可以在此处提供经过编译的 Windows .res 文件, 二进制目标。 |
alwayslink
|
布尔值;默认值为 srcs ,即使其中一些不包含二进制文件引用的符号也是如此。
如果
二进制文件。例如,如果您的代码注册以接收一些回调
提供的数据
如果 alwayslink 无法用于 Windows 上的 VS 2017,原因在于 已知问题, 请将 VS 2017 升级到最新版本。 |
copts
|
字符串列表;默认值为
在编译二进制目标之前,此属性中的每个字符串都会按给定顺序添加到
如果该软件包声明了 feature,
|
defines
|
字符串列表;默认值为 -D ,并添加到编译命令行中,
以及依赖于该规则的每条规则请务必谨慎,因为这可能会产生深远影响。如有疑问,请将定义值添加到
local_defines 。
|
implementation_deps
|
标签列表;默认值为 deps ,这些库(及其所有库)的头文件和 include 路径
传递依赖项)仅用于编译此库,而不会用于
一切都依赖于它使用 implementation_deps 指定的库仍会在依赖于此库的二进制目标中关联。
目前,此功能仅限于 cc_libraries,并由标志 |
include_prefix
|
String;默认值为 设置后,此规则的 先移除 |
includes
|
字符串列表;默认值为
需遵循“Make 变量”替换规则。
每个字符串都以 标头必须添加到 srcs 或 hdrs 中,否则它们将无法供从属使用 使用沙盒(默认)编译时应遵循的规则。 |
linkopts
|
字符串列表;默认值为 LINKOPTS 。
此列表中不以 |
linkstamp
|
标签;默认值为 base 软件包。
|
linkstatic
|
布尔值;默认值为 cc_binary 和
cc_test :以静态方式关联二进制文件
模式。对于 cc_library.linkstatic :请参阅下文。
默认情况下,系统会为
如果已启用,并且是二进制文件或测试文件,此选项将指示构建工具加入
尽可能为用户库使用 关联可执行文件其实有三种不同的方法:
如果为 |
local_defines
|
字符串列表;默认值为 -D ,并添加到此目标的编译命令行,但不会添加到其依赖项。
|
nocopts
|
字符串;默认值为 COPTS 中移除与此正则表达式匹配的任何现有 COPTS (包括在规则的 copts 属性中明确指定的值)。
您应该很少需要此属性。
|
strip_include_prefix
|
字符串;默认值为 设置后,此规则的 如果是相对路径,则会被当作软件包相对路径。如果是绝对路径,则会被视为相对于代码库的路径。
|
textual_hdrs
|
标签列表;默认值为 这是用于声明无法自行编译的头文件的位置; 也就是说,它们始终需要由其他源文件以文本形式包含,才能构建有效的 代码。 |
win_def_file
|
标签;默认值为 仅当 Windows 是目标平台时,才应使用此属性。 它可用于在关联共享库时导出符号。 |
cc_proto_library
查看规则来源cc_proto_library(name, deps, data, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, features, licenses, restricted_to, tags, target_compatible_with, testonly, visibility)
cc_proto_library
会根据 .proto
文件生成 C++ 代码。
deps
必须指向 proto_library
规则。
示例:
cc_library( name = "lib", deps = [":foo_cc_proto"], ) cc_proto_library( name = "foo_cc_proto", deps = [":foo_proto"], ) proto_library( name = "foo_proto", )
参数
属性 | |
---|---|
name |
名称;必需 此目标的唯一名称。 |
deps
|
标签列表;默认值为 proto_library 的列表
为其生成 C++ 代码的规则。
|
cc_shared_library
查看规则源代码cc_shared_library(name, deps, additional_linker_inputs, dynamic_deps, exports_filter, shared_lib_name, tags, user_link_flags, win_def_file)
它会生成一个共享库。
示例
cc_shared_library( name = "foo_shared", deps = [ ":foo", ], dynamic_deps = [ ":bar_shared", ], additional_linker_inputs = [ ":foo.lds", ], user_link_flags = [ "-Wl,--version-script=$(location :foo.lds)", ], ) cc_library( name = "foo", srcs = ["foo.cc"], hdrs = ["foo.h"], deps = [ ":bar", ":baz", ], ) cc_shared_library( name = "bar_shared", shared_lib_name = "bar.so", deps = [":bar"], ) cc_library( name = "bar", srcs = ["bar.cc"], hdrs = ["bar.h"], ) cc_library( name = "baz", srcs = ["baz.cc"], hdrs = ["baz.h"], )
在此示例中,foo_shared
将 foo
和 baz
静态链接起来,后者是传递依赖项。它不会关联 bar
,因为 dynamic_dep
bar_shared
已动态提供该实例。
foo_shared
使用链接器脚本 *.lds 文件来控制
的所有文件。cc_shared_library
规则逻辑不会控制要导出的符号,它只会使用假定要导出的符号,以便在分析阶段如果两个共享库导出相同的目标时,报告错误。
系统会假定 cc_shared_library
的每个直接依赖项都已导出。因此,在分析期间,Bazel 会假定 foo_shared
正在导出 foo
。baz
不会假定会被导出
上传者:foo_shared
。与exports_filter
匹配的每个目标
导出的数据也会被视为导出。
示例中的每个 cc_library
最多只能出现在一个
cc_shared_library
。如果我们还想将 baz
关联到 bar_shared
,则需要将 tags = ["LINKABLE_MORE_THAN_ONCE"]
添加到 baz
。
由于 shared_lib_name
属性,bar_shared
生成的文件将命名为 bar.so
,而不是在 Linux 上默认的名称 libbar.so
。
错误
Two shared libraries in dependencies export the same symbols.
每当您创建一个具有两个不同 cc_shared_library
依赖项的目标时,就会发生这种情况,而这两个依赖项会导出相同的目标。要解决此问题,您需要阻止在某个 cc_shared_library
依赖项中导出库。
Two shared libraries in dependencies link the same library statically
每当您创建包含两个参数的新 cc_shared_library
时,就会发生这种情况。
以静态方式链接同一目标的不同 cc_shared_library
依赖项。
与导出错误类似。
解决此问题的一种方法是停止将库链接到某个
cc_shared_library
依赖项。同时,仍将它与
需要导出库,确保未关联库的库
符号。另一种方法是提取导出目标的第三方库。第三种方法是使用 LINKABLE_MORE_THAN_ONCE
标记罪魁祸首 cc_library
但很少会进行这种修复,您一定要确保
cc_library
确实可以放心地关联多次。
'//foo:foo' is already linked statically in '//bar:bar' but not exported`
这意味着,您的 deps
的传递闭包中的库是可访问的
而无需通过某个 cc_shared_library
依赖项,但已
已与dynamic_deps
中的其他cc_shared_library
相关联,并且未
已导出。
解决方法是将其从 cc_shared_library
依赖项中导出或拉取
第三个 cc_shared_library
,用于导出该数据。
Do not place libraries which only contain a precompiled dynamic library in deps.
如果您有预编译的动态库,则不需要,也不可能
静态关联到您当前的 cc_shared_library
目标
。因此,它不属于deps
cc_shared_library
。如果此预编译动态库是某个 cc_libraries
的依赖项,则 cc_library
需要直接依赖于它。
Trying to export a library already exported by a different shared library
如果您在当前规则中声明要导出某个动态依赖项已导出的目标,就会看到此错误。
要解决此问题,请从 deps
中移除目标,仅依赖于动态依赖项中的目标,或者确保 exports_filter
不会捕获此目标。
参数
属性 | |
---|---|
name |
名称;必需 此目标的唯一名称。 |
deps
|
标签列表;默认值为
只要这些直接依赖项的任何传递库依赖项尚未由
在分析过程中,规则实施会考虑
每当以静态方式链接到同一库时,此实现也会触发错误
转换为多个 |
additional_linker_inputs
|
标签列表;默认值为 user_link_flags 属性执行此操作。
|
dynamic_deps
|
标签列表;默认值为 cc_shared_library 依赖项。
|
exports_filter
|
字符串列表;默认值为
任何目标
请注意,此属性实际上并没有为这些目标添加依赖关系,
应改为由 允许使用以下语法:
|
shared_lib_name
|
String;默认值为 |
user_link_flags
|
字符串列表;默认值为 cc_shared_library( name = "foo_shared", additional_linker_inputs = select({ "//src/conditions:linux": [ ":foo.lds", ":additional_script.txt", ], "//conditions:default": []}), user_link_flags = select({ "//src/conditions:linux": [ "-Wl,-rpath,kittens", "-Wl,--version-script=$(location :foo.lds)", "-Wl,--script=$(location :additional_script.txt)", ], "//conditions:default": []}), ... ) |
win_def_file
|
标签;默认值为 仅当 Windows 是目标平台时,才应使用此属性。 它可用于在关联共享库时导出符号。 |
fdo_prefetch_hints
查看规则源代码fdo_prefetch_hints(name, compatible_with, deprecation, distribs, features, licenses, profile, restricted_to, tags, target_compatible_with, testonly, visibility)
表示位于工作区或指定绝对路径中的 FDO 预提取提示配置文件。示例:
fdo_prefetch_hints( name = "hints", profile = "//path/to/hints:profile.afdo", ) fdo_profile( name = "hints_abs", absolute_path_profile = "/absolute/path/profile.afdo", )
参数
属性 | |
---|---|
name |
名称;必需 此目标的唯一名称。 |
profile
|
标签;默认值为 |
fdo_profile
查看规则源代码fdo_profile(name, absolute_path_profile, compatible_with, deprecation, distribs, features, licenses, profile, proto_profile, restricted_to, tags, target_compatible_with, testonly, visibility)
表示工作区中或指定绝对路径中的 FDO 配置文件。 示例:
fdo_profile( name = "fdo", profile = "//path/to/fdo:profile.zip", ) fdo_profile( name = "fdo_abs", absolute_path_profile = "/absolute/path/profile.zip", )
参数
属性 | |
---|---|
name |
姓名;必需 此目标的唯一名称。 |
absolute_path_profile
|
字符串;默认值为 |
profile
|
标签;默认值为 |
proto_profile
|
标签;默认值为 |
memprof_profile
查看规则来源memprof_profile(name, absolute_path_profile, compatible_with, deprecation, distribs, features, licenses, profile, restricted_to, tags, target_compatible_with, testonly, visibility)
表示工作区中或指定 绝对路径。 示例:
memprof_profile( name = "memprof", profile = "//path/to/memprof:profile.afdo", ) memprof_profile( name = "memprof_abs", absolute_path_profile = "/absolute/path/profile.afdo", )
参数
属性 | |
---|---|
name |
名称;必需 此目标的唯一名称。 |
absolute_path_profile
|
字符串;默认值为 |
profile
|
标签;默认值为 |
propeller_optimize
查看规则来源propeller_optimize(name, compatible_with, deprecation, distribs, features, ld_profile, licenses, restricted_to, tags, target_compatible_with, testonly, visibility)
表示工作区中的 Propeller 优化配置文件。 示例:
propeller_optimize( name = "layout", cc_profile = "//path:cc_profile.txt", ld_profile = "//path:ld_profile.txt" ) propeller_optimize( name = "layout_absolute", absolute_cc_profile = "/absolute/cc_profile.txt", absolute_ld_profile = "/absolute/ld_profile.txt" )
参数
属性 | |
---|---|
name |
名称;必需 此目标的唯一名称。 |
ld_profile
|
标签;默认值为 |
cc_test
查看规则源代码cc_test(name, deps, srcs, data, additional_linker_inputs, args, compatible_with, copts, defines, deprecation, distribs, env, env_inherit, exec_compatible_with, exec_properties, features, flaky, includes, licenses, link_extra_lib, linkopts, linkstatic, local, local_defines, malloc, nocopts, restricted_to, shard_count, size, stamp, tags, target_compatible_with, testonly, timeout, toolchains, visibility, win_def_file)
参数
属性 | |
---|---|
name |
名称;必需 此目标的唯一名称。 |
deps
|
标签列表;默认值为 这些值可以是 |
srcs
|
标签列表;默认值为 系统会编译所有
所有 如果某个规则的名称在
允许的
...以及生成这些文件的任何规则。 不同的扩展表示 。 |
additional_linker_inputs
|
标签列表;默认值为 例如,您可以在此处提供已编译的 Windows .res 文件,以便将其嵌入到二进制目标中。 |
copts
|
字符串列表;默认值为
在编译二进制目标之前,此属性中的每个字符串都会按给定顺序添加到
如果软件包声明了功能 |
defines
|
字符串列表;默认值为 -D ,并添加到编译命令行中,
以及依赖于该规则的每条规则请务必小心,
产生深远的影响。如果不确定,请改为向 local_defines 添加定义值。
|
includes
|
字符串列表;默认值为
需遵循替换 "Make variable" 的规定。
每个字符串都以 必须将标头添加到 srcs 或 hdrs 中,否则它们将无法供从属使用 使用沙盒(默认)编译时应遵循的规则。 |
link_extra_lib
|
标签;默认值为
默认情况下,C++ 二进制文件会与 |
linkopts
|
字符串列表;默认值为 LINKOPTS 。
此列表中将出现每个不以 |
linkstatic
|
布尔值;默认值为 cc_binary 和 cc_test :在静态模式下关联二进制文件。对于 cc_library.linkstatic :请参阅下文。
默认情况下,系统会为
如果已启用,并且是二进制文件或测试文件,此选项将指示构建工具加入
尽可能为用户库使用 实际上,有三种不同的方式可以关联可执行文件:
如果将
如果为 |
local_defines
|
字符串列表;默认值为 -D ,并添加到此目标的编译命令行,但不会添加到其依赖项。
|
malloc
|
标签;默认值为
默认情况下,C++ 二进制文件会与 |
nocopts
|
字符串;默认值为 COPTS
(包括规则的 copts 属性中明确指定的值)将从
COPTS ,以便编译此规则。
您很少需要使用此属性。
|
stamp
|
Integer;默认值为
除非其依赖项发生变化,否则带时间戳的二进制文件不会被重新构建。 |
win_def_file
|
标签;默认值为 仅当 Windows 是目标平台时,才应使用此属性。 它可用于 导出符号。 |
cc_toolchain
查看规则来源cc_toolchain(name, all_files, ar_files, as_files, compatible_with, compiler_files, compiler_files_without_includes, coverage_files, deprecation, distribs, dwp_files, dynamic_runtime_lib, exec_transition_for_inputs, features, libc_top, licenses, linker_files, module_map, objcopy_files, restricted_to, static_runtime_lib, strip_files, supports_header_parsing, supports_param_files, tags, target_compatible_with, testonly, toolchain_config, toolchain_identifier, visibility)
表示 C++ 工具链。
此规则负责:
-
收集运行 C++ 操作所需的所有工件。这可以通过
all_files
、compiler_files
、linker_files
或以_files
结尾的其他属性来实现。这些属性通常是用于将所有必需文件全局匹配的文件组。 -
为 C++ 操作生成正确的命令行。这通过使用
CcToolchainConfigInfo
提供方来完成(详见下文)。
使用 toolchain_config
属性配置 C++ 工具链。
如需查看详细的 C++ 工具链配置和工具链选择文档,请参阅此页面。
使用 tags = ["manual"]
以防止构建和配置工具链
在调用 bazel build //...
时不必要的
参数
属性 | |
---|---|
name |
名称;必需 此目标的唯一名称。 |
all_files
|
标签;必需 所有 cc_toolchain 工件集合。这些工件将作为输入添加到所有 rules_cc 相关操作(使用以下属性中的更精确工件集的操作除外)。Bazel 假定all_files 是一个超集
所有其他提供工件的属性(例如,Linktamp 编译需要同时编译
和链接文件,因此需要 all_files )。
|
ar_files
|
标签;默认值为 归档操作所需的所有 cc_toolchain 工件集合。 |
as_files
|
标签;默认值为 汇编操作所需的所有 cc_toolchain 工件的集合。 |
compiler_files
|
标签;必需 编译操作所需的所有 cc_toolchain 工件集合。 |
compiler_files_without_includes
|
标签;默认值为 |
coverage_files
|
标签;默认值为 |
dwp_files
|
标签;必需 dwp 操作所需的所有 cc_toolchain 工件的集合。 |
dynamic_runtime_lib
|
标签;默认值为 在启用“static_link_cpp_runtimes”功能并动态关联依赖项时,系统会使用此参数。 |
exec_transition_for_inputs
|
布尔值;默认值为 |
libc_top
|
标签;默认值为 |
linker_files
|
标签;必需 关联操作所需的所有 cc_toolchain 工件的集合。 |
module_map
|
标签;默认值为 |
objcopy_files
|
标签;必需 包含 objcopy 操作所需的所有 cc_toolchain 工件集合。 |
static_runtime_lib
|
标签;默认值为 启用“static_link_cpp_runtimes”功能并静态关联依赖项时,系统会使用此参数。 |
strip_files
|
标签;必需 删除操作所需的全部 cc_toolchain 工件的集合。 |
supports_header_parsing
|
布尔值;默认值为 |
supports_param_files
|
布尔值;默认值为 |
toolchain_config
|
标签;必需 提供cc_toolchain_config_info 的规则的标签。
|
toolchain_identifier
|
用于将此 cc_toolchain 与相应的 crosstool_config.toolchain 进行匹配的标识符。
在问题 #5380 得到解决之前,建议通过这种方式将 |
cc_toolchain_suite
查看规则来源cc_toolchain_suite(name, compatible_with, deprecation, distribs, features, licenses, restricted_to, tags, target_compatible_with, testonly, toolchains, visibility)
表示 C++ 工具链的集合。
此规则负责:
- 收集所有相关的 C++ 工具链。
-
根据传递给 Bazel 的
--cpu
和--compiler
选项选择一个工具链。
另请参阅此内容 页 ,获取详细的 C++ 工具链配置和工具链选择文档。
参数
属性 | |
---|---|
name |
名称;必需 此目标的唯一名称。 |
toolchains
|
将字符串映射到 labels 的字典;不可配置;必需 将“<cpu>”或“<cpu>|<compiler>”字符串映射到cc_toolchain 标签的映射。“<cpu>”只有 --cpu 时使用
会传递到 Bazel,并且“<cpu>|<compiler>”指定的两个条件
--cpu 和 --compiler 会传递给 Bazel。示例:
cc_toolchain_suite( name = "toolchain", toolchains = { "piii|gcc": ":my_cc_toolchain_for_piii_using_gcc", "piii": ":my_cc_toolchain_for_piii_using_default_compiler", }, ) |