規則
- 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
|
標籤清單;預設為 系統會編譯所有 系統不會編譯 所有 如果規則名稱位於
允許的
以及產生這些檔案的任何規則。根據 gcc 慣例,不同的擴充功能代表不同的程式設計語言。 |
additional_linker_inputs
|
標籤清單;預設為 舉例來說,您可以在這裡提供已編譯的 Windows .res 檔案,以嵌入二進位檔目標。 |
copts
|
字串清單;預設為
在編譯二進位目標之前,這個屬性中的每個字串都會依照指定順序新增至
如果套件宣告了「功能」 |
defines
|
字串清單;預設值為 -D ,並新增至編譯指令列,以及所有依附於該目標的規則。請務必謹慎操作,因為這可能會造成廣泛的影響。如有疑問,請改為在 local_defines 中新增定義值。
|
includes
|
字串清單;預設值為
取決於「Make 變數」替代。每個字串前面都會加上 標頭必須加入 srcs 或 hdrs,否則在編譯處於沙箱狀態 (預設) 時,依附的規則就無法使用標頭。 |
link_extra_lib
|
標籤;預設值為
根據預設,C++ 二進位檔會連結至 |
linkopts
|
字串清單;預設值為 LINKOPTS 。
這個清單中,凡是開頭不是 |
linkshared
|
布林值;nonconfigurable;預設值為 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
檔案,以及 cc_*
規則的 hdrs
和 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
,而 bar.h
可包含 baz.h
,baz.h
則可包含 baz-impl.h
。理論上,.cc
檔案的編譯方式可能會在遞移 deps
關閉期間的任何 cc_library
的 hdrs
或 srcs
中,間接納入任何標頭檔案。在這種情況下,編譯器在編譯 foo.cc
時可能會讀取 baz.h
和 baz-impl.h
,但 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
|
字串清單;預設為
此屬性中的每個字串都會按照指定順序新增至
如果套件宣告功能 |
defines
|
字串清單;預設值為 -D ,然後新增至此目標的編譯指令行,以及依附於此目標的每個規則。請務必謹慎操作,因為這可能會造成廣泛的影響。如有疑問,請改為將定義值新增至 local_defines 。 |
implementation_deps
|
標籤清單;預設為 deps 不同,這些程式庫的標頭和包含路徑 (及其所有遞移依附元件) 只會用於這個程式庫的編譯作業,不會用於依附該程式庫的程式庫。使用 implementation_deps 指定的程式庫,仍會連結至依附此程式庫的二進位目標。目前僅限於 cc_libraries 使用,並由標記 |
include_prefix
|
字串;預設為 設定後,您可以在該規則的 系統會先移除 |
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 規則清單。 |
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
是由 foo_shared
匯出。系統不會假設 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
目標。因此,它不屬於 cc_shared_library
的 deps
。如果這個預先編譯的動態程式庫是 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
|
字串;預設值為 |
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 設定檔。範例:
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
|
標籤清單;預設值為 系統會編譯所有 系統不會編譯 所有已 如果規則名稱位於
允許的
以及產生這些檔案的任何規則。根據 gcc 慣例,不同的擴充功能代表不同的程式設計語言。 |
additional_linker_inputs
|
標籤清單;預設為 舉例來說,您可以在這裡提供已編譯的 Windows .res 檔案,以嵌入二進位檔目標。 |
copts
|
字串清單;預設為
在編譯二進位目標之前,這個屬性中的每個字串都會依照指定順序新增至
如果套件宣告功能 |
defines
|
字串清單;預設為 -D ,然後新增至此目標的編譯指令行,以及依附於此目標的每個規則。請務必謹慎操作,因為這可能會造成廣泛的影響。如有疑問,請改為將定義值新增至 local_defines 。 |
includes
|
字串清單;預設為
適用於 "Make 變數" 替換。
每個字串都會在開頭加上 標頭必須加入 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
|
整數,預設值為
除非其依附元件變更,否則系統「不會」重新建構加上時間戳記的二進位檔。 |
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 是所有其他提供構件屬性的集合 (例如,連結標記編譯作業需要編譯和連結檔案,因此會使用 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
|
字串;不可設定;預設值為
直到問題 #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
|
從「<cpu>」或「<cpu>|<compiler>」字串對應至 cc_toolchain 標籤。如果只有 --cpu 傳遞至 Bazel,系統會使用「<cpu>"」,如果 --cpu 和 --compiler 都傳遞至 Bazel,則會使用「<cpu>|<compiler>"。範例:
cc_toolchain_suite( name = "toolchain", toolchains = { "piii|gcc": ":my_cc_toolchain_for_piii_using_gcc", "piii": ":my_cc_toolchain_for_piii_using_default_compiler", }, ) |