C / C++ 規則

回報問題 查看來源 夜間 7.4 ，直接在 Google Cloud 控制台實際操作。 7.3 · 7.2 · 7.1 · 7.0 · 6.5

規則

• 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	標籤清單；預設為 [] 要連結至二進位目標的其他程式庫清單。 可以是 cc_library 或 objc_library 目標。
srcs	標籤清單；預設為 [] 系統在建立目標時所處理的 C 和 C++ 檔案清單。這些是 C/C++ 來源檔案和標頭檔案，可以是非產生的 (一般來源檔案) 程式碼) 或由系統產生 所有 .cc、.c 和 .cpp 檔案都會編譯。如果檔案名稱位於 其他規則的 outs 會自動採用另一項規則 .h 檔案不會經過編譯，但可在 依據來源納入這項規則中的來源。.cc 和 .h 檔案中可以直接加入 這些srcs或 hdrs 列出的任何規則 deps 引數。 總共 #included 個檔案必須在以下示例中提及： 這項規則的 srcs 屬性，或 參照 cc_library() 的 hdrs 屬性。 如果標頭與程式庫相關 列在該程式庫的 hdrs 屬性中，其餘 與這項規則的來源相關聯的標頭 srcs。請參閱「標頭納入檢查」 以取得更詳盡的說明 如果規則名稱位於 srcs 中，則此規則會自動依附該規則。如果命名規則的 outs 為 C 或 C++ 這些來源檔案都會編譯成這項規則 如果是程式庫檔案，請選擇相應的連結 允許的 srcs 檔案類型： C 和 C++ 來源檔案：.c、.cc、.cpp、 .cxx、.c++、.C C 和 C++ 標頭檔案：.h、.hh、.hpp、 .hxx、.inc、.inl、.H 使用 C 預先處理器組合：.S 封存檔：.a、.pic.a 「一律連結」程式庫：.lo、.pic.lo 共用資料庫 (版本化或反版本)：.so、 .so.version 物件檔案：.o，.pic.o ...以及產生這些檔案的任何規則。 根據 gcc 慣例，不同的擴充功能代表不同的程式設計語言。
additional_linker_inputs	標籤清單；預設為 [] 將這些檔案傳送至 C++ 連接器指令。 例如，您可以在此提供已編譯的 Windows .res 檔案，以便嵌入二進位目標。
copts	字串清單；預設為 [] 將這些選項新增至 C++ 編譯指令。 取決於「化變數」替代和 Bourne 殼層權杖化。 此屬性中的每個字串都會按照指定順序新增至 COPTS， 來編譯二進位目標標記只會在編譯這個目標時生效，不會 因此，請謹慎處理包含在其他地方的標頭檔案。所有路徑 是相對於工作區，而不是目前的套件。 如果套件已宣告功能 no_copts_tokenization，Bourne 殼層權杖化功能僅適用於字串 其中包含一個「廠牌」變數。
defines	字串清單；預設值為 [] 要新增至編譯行中的定義清單。取決於 「廠牌」替代和 Bourne 殼層權杖化。 每個字串都必須包含單一 Bourne 殼層符記，並在開頭加上 -D，然後新增至這個目標的編譯指令行，以及依附於該目標的每個規則。請務必小心，因為這可能有 影響深遠的影響如有疑問，請改為將定義值新增至 local_defines。
includes	字串清單；預設值為 [] 要新增至編譯行中的包含目錄清單。 適用於 "Make 變數" 替換。 每個字串前面都會加上 -isystem，並新增至 COPTS。 與 COPTS 不同，這些標記會新增至此規則和依附於此規則的所有規則。(注意：而不是仰賴的規則！)成為 因為這樣可能帶來相當深遠的影響如有疑問，請改為在 COPTS 中加入「-I」標記。 標頭必須新增至 srcs 或 Hdr，否則就無法使用 預設規則。
link_extra_lib	標籤；預設為 "@bazel_tools//tools/cpp:link_extra_lib" 控管額外程式庫的連結作業。 根據預設，C++ 二進位檔會與 //tools/cpp:link_extra_lib 連結， 視標籤標記 //tools/cpp:link_extra_libs 而定。 如果沒有設定此標記，這個程式庫預設會空白。設定標籤標記 可連結選用的依附元件，例如惡意符號、攔截器的覆寫值 使用共用程式庫函式或特殊的執行階段程式庫 (如果是 Malloc 替換項目， 建議採用 malloc 或 --custom_malloc)。將此屬性設定為 None 會停用這個行為。
linkopts	字串清單；預設為 [] 將這些標記新增至 C++ 連結器指令。取決於 「廠牌」替代變數， Bourne 殼層權杖化和 展開標籤。 這個屬性中的每個字串都會在連結二進位目標之前新增至 LINKOPTS。 這份清單中每個開頭不是 $ 或 - 的元素 假設為 deps 中目標的標籤。 該目標產生的檔案清單會附加至連結器 只要設定成「自動重新啟動」 和「在主機維護期間」選項即可如果標籤無效或 未在 deps 中宣告。
linkshared	布林值；不可設定；預設為 False 建立共用資料庫。 如要啟用這項屬性，請在規則中加入 linkshared=True。這個選項預設為關閉。 這個標記的存在表示連結會將 -shared 標記連結至 gcc，而產生的共用程式庫則適合載入至 Java 程式等。不過，基於建構目的，這個 API 永遠不會連結至 相依二進位檔，因為原定方法為透過 cc_binary 規則只有其他程式手動載入，因此 不應視為替代 cc_library 規則。為提高擴充性，建議您完全避免採用此方法， 讓 java_library 依附於 cc_library 規則 。 如果同時指定 linkopts=['-static'] 和 linkshared=True， 即可獲得一個完全獨立的單元如果您同時指定 linkstatic=True 和 linkshared=True，您會得到一個幾乎自給自足的單一單位。
linkstatic	布林值，預設值為 True 適用於 cc_binary 和 cc_test：連結靜態的二進位檔 模式。如為 cc_library.linkstatic：請參閱下方說明。 這個選項預設為 cc_binary，其餘則為關閉。 如果已啟用，且這是二進位檔或測試，這個選項會指示建構工具盡可能連結 .a 而非 .so 的使用者程式庫。部分系統程式庫可能仍然會以動態方式連結， 我們沒有靜態資料庫因此產生的可執行檔仍會以動態方式連結，因此只有「大部分」是靜態的。 實際上有三種不同的方式可以連結可執行檔： 使用 fully_static_link 功能的 STATIC，其中所有項目都會以靜態方式連結，例如「gcc -static foo.o libbar.a libbaz.a -lm」。 如要啟用這個模式，請在 features 屬性中指定 fully_static_link。 STATIC：以靜態方式連結所有使用者程式庫 (如果是 可用的版本)，但系統程式庫 (不包括 C/C++ 執行階段程式庫) 會透過動態連結的方式連結 (例如「gcc foo.o libfoo.a libbaz.a -lm」。 透過指定 linkstatic=True 即可啟用這個模式。 動態版本：所有程式庫皆以動態方式連結 (如果動態版本是 可用)，例如：「gcc foo.o libfoo.so libbaz.so -lm」。 透過指定 linkstatic=False 即可啟用這個模式。 如果 linkstatic 屬性用於 cc_library() 規則，其意義就會有所不同。如果是 C++ 程式庫，linkstatic=True 表示只有 系統允許使用靜態連結，因此不會產生 .so。linkstatic=False 包含 但無法防止建立靜態資料庫這個屬性是用來控制 動態程式庫建立程序 如果值為 linkstatic=False，建構工具會建立符號連結，指向 依賴 *.runfiles 區域的共用程式庫
local_defines	字串清單；預設為 [] 要新增至編譯行的定義清單。 取決於 「廠牌」替代和 Bourne 殼層權杖化。 每個字串都必須包含一個 Bourne shell 符記，並在開頭加上 -D，然後加入這個目標的編譯指令行，但不加入其依附項目。
malloc	標籤；預設為 "@bazel_tools//tools/cpp:malloc" 覆寫對 malloc 的預設依附元件。 根據預設，C++ 二進位檔會連結至 //tools/cpp:malloc，這是空白程式庫，因此二進位檔會使用 libc malloc。這個標籤必須參照 cc_library。如果編譯作業是針對非 C++ 規則，這個選項就不會生效。如果發生下列情形，系統會忽略這個屬性的值： 已指定 linkshared=True。
nocopts	String;預設值為 "" 移除 C++ 編譯指令中的相符選項。 取決於 「廠牌」變數替代。 系統會將此屬性的值解讀為規則運算式。為了編譯此規則，系統會從 COPTS 中移除任何符合此規則運算式的先前 COPTS (包括規則 copts 屬性中明確指定的值)。這個屬性應該很少需要用。
stamp	Integer;預設值為 -1 是否將建構資訊編碼至二進位檔。可能的值包括： stamp = 1：一律將建構資訊刻印到二進位檔中，即使是在 --nostamp 版本中也是如此。請避免使用這項設定，因為這可能會導致二進位檔和任何依賴二進位檔的後續動作無法進行遠端快取。 stamp = 0：一律使用常數值取代建構資訊。這個 也提供良好的建構結果快取功能 stamp = -1：版本資訊的嵌入方式由 --[no]stamp 標記控制。 除非依附元件變更，否則系統不會重新建構經過標記的二進位檔。
win_def_file	標籤；預設為 None 要傳遞至連接器的 Windows DEF 檔案。 只有在 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. AI 必須採行 隱私保護設計原則連結至靜態或共用程式庫
在 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	布林值，預設值為 False 如果為 1，則任何直接或間接依賴此 C++ 預先編譯程式庫的二進位檔，都會連結靜態資料庫中封存的所有物件檔案，即使其中有些檔案不含二進位檔參照的符號也一樣。如果程式碼中的程式碼未明確呼叫，這個方法就很實用 二進位檔案 (舉例來說，如果您的程式碼註冊以取得某些回呼) 這項工具可讓您存取 該基礎架構的各項服務 如果始終連結無法在 Windows 上與 VS 2017 搭配運作，這是因為 已知問題 請將 VS 2017 升級至最新版本。
interface_library	標籤；預設為 None 用於連結共用程式庫的單一介面程式庫。 允許的檔案類型： .ifso, .tbd, .lib, .so 或 .dylib
shared_library	標籤；預設為 None 單一預編譯共用程式庫。Bazel 會確保在執行階段，依附元件可供依附元件所需的二進位檔使用。 允許的檔案類型：.so、.dll 或 .dylib
static_library	標籤；預設為 None 單一預先編譯的靜態資料庫。 允許的檔案類型：.a、.pic.a 或 .lib
system_provided	布林值；預設值為 False 如果為 1，表示系統會提供執行階段所需的共用資料庫。在這種情況下，應指定 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 指令列旗標或 features 參數的 package 函式。Bazel 提供的工具鏈僅支援在 Unix 和 macOS 上使用 clang 這項功能。

引數

屬性
name	名稱；必選 此目標的專屬名稱。
deps	標籤清單；預設為 [] 要連結至二進位目標的其他程式庫清單。 這些可以是 cc_library 或 objc_library 目標。
srcs	標籤清單；預設為 [] 要處理以建立目標的 C 和 C++ 檔案清單。 這些是 C/C++ 來源和標頭檔案，可能是未產生的 (一般來源程式碼) 或已產生的。 所有 .cc、.c 和 .cpp 檔案都會編譯。如果檔案名稱位於 其他規則的 outs 會自動採用另一項規則 .h 檔案不會經過編譯，但可在 依據來源納入這項規則中的來源。.cc 和 .h 檔案中可以直接加入 這些srcs或 hdrs 列出的任何規則 deps 引數。 所有已 #include 的檔案都必須在這個規則的 srcs 屬性中提及，或是在參照的 cc_library() 的 hdrs 屬性中提及。如果標頭與程式庫相關 列在該程式庫的 hdrs 屬性中，其餘 與這項規則的來源相關聯的標頭 srcs。請參閱「標頭納入檢查」 以取得更詳盡的說明 如果規則名稱位於 srcs， 這項規則會自動依循該規則 如果命名規則的 outs 是 C 或 C++ 來源檔案，則會編譯至此規則；如果是程式庫檔案，則會連結進來。 允許的 srcs 檔案類型： C 和 C++ 來源檔案：.c、.cc、.cpp、 .cxx、.c++、.C C 和 C++ 標頭檔案：.h、.hh、.hpp、 .hxx、.inc、.inl、.H 使用 C 預先處理器組合：.S 封存檔：.a、.pic.a 「一律連結」程式庫：.lo、.pic.lo 共用資料庫 (版本化或反版本)：.so、 .so.version 物件檔案：.o，.pic.o 以及產生這些檔案的任何規則。不同的擴充功能代表 改成 gcc 慣例
hdrs	標籤清單；預設為 [] 此程式庫發布的標頭檔案清單，可由依附規則中的來源直接納入。 這是宣告描述程式庫介面的標頭檔案的首選位置。這些標頭會開放供此規則或相關規則中的來源加入。即使已在發布的標頭中納入，如果這個程式庫的用戶端不應納入標頭，則應改為在 srcs 屬性中列出標頭。詳情請參閱「標頭包含項目檢查」一文。
additional_compiler_inputs	標籤清單；預設為 [] 您可能想傳遞至編譯器指令列的任何其他檔案，例如清理器的忽略清單。您可以在 copts 中使用此處指定的檔案，並搭配 $(location) 函式。
additional_linker_inputs	標籤清單；預設為 [] 將這些檔案傳遞至 C++ 連結器指令。 舉例來說，可以在這裡提供已編譯的 Windows .res 檔案，以便嵌入 做為二進位目標
alwayslink	布林值；預設值為 False 如果為 1，則任何直接或間接依賴此 C++ 程式庫的二進位檔，都會連結 srcs 中列出的所有檔案物件檔案，即使其中有些檔案不含二進位檔參照的符號也一樣。如果二進位檔中的程式碼並未明確呼叫您的程式碼 (例如，如果您的程式碼註冊接收某些服務提供的回呼)，這項功能就很實用。 如果 alwayslink 無法在 Windows 上與 VS 2017 搭配運作，可能是因為已知問題，請將 VS 2017 升級至最新版本。
copts	字串清單；預設值為 [] 將這些選項新增至 C++ 編譯指令。 取決於「化變數」替代和 Bourne 殼層權杖化。 此屬性中的每個字串都會按照指定順序新增至 COPTS， 來編譯二進位目標標記只會影響此目標的編譯作業，而非其依附元件，因此請留意其他地方是否包含標頭檔案。所有路徑都應以工作區為基準，而非以目前套件為基準。 如果套件宣告功能 no_copts_tokenization，Bourne shell 符記化只會套用至由單一「Make」變數組成的字串。
defines	字串清單；預設為 [] 要新增至編譯行中的定義清單。取決於 「廠牌」替代和 Bourne 殼層權杖化。 每個字串都必須包含單一 Bourne 殼層符記，並在開頭加上 -D，然後新增至此目標的編譯指令行，以及依附於此目標的每個規則。請務必小心，因為這可能有 影響深遠的影響如有疑問，請將定義值加進 local_defines。
implementation_deps	標籤清單；預設為 [] 該程式庫鎖定的其他程式庫清單。取消喜歡 deps，標頭和包含這些程式庫的路徑 (及其全部路徑) 遞移依附元件) 只會用於這個程式庫的編譯作業，不適用於 依靠它使用 implementation_deps 指定的程式庫，仍會連結至依附此程式庫的二進位目標。 目前僅限使用 cc_libraries，並受到標記的保護 --experimental_cc_implementation_deps。
include_prefix	String;預設值為 "" 要新增至這項規則標頭路徑的前置字串。 設定後，即可存取這項規則 hdrs 屬性中的標頭 at 是這個屬性的值，在其存放區相關路徑前面。 系統會先移除 strip_include_prefix 屬性中的前置字串，再新增這個前置字串。
includes	字串清單；預設為 [] 要新增至編譯行的包含 URI 清單。 適用於 "Make 變數" 替換。 每個字串前面都會加上 -isystem，並新增至 COPTS。 與最佳化不同，系統會在這項規則中新增這些標記 並提供相關的所有規則(注意：不是依附的規則！)成為 因為這樣可能帶來相當深遠的影響如有疑問，請改為在 COPTS 中加入「-I」標記。 標頭必須加入 srcs 或 hdrs，否則在編譯處於沙箱狀態 (預設) 時，依附的規則就無法使用標頭。
linkopts	字串清單；預設為 [] 將這些標記新增至 C++ 連結器指令。取決於 「廠牌」替代變數， Bourne 殼層權杖化和 展開標籤。 這個屬性中的每個字串都會在連結二進位目標之前新增至 LINKOPTS。 清單中每個元素的開頭不是 $ 或 -，則會假設為 deps 中目標的標籤。該目標產生的檔案清單會附加至連結器選項。如果標籤無效或 未在 deps 中宣告。
linkstamp	標籤；預設為 None 同時編譯指定的 C++ 來源檔案，並連結至最終版本 二進位檔案。您必須使用這種技巧，才能將時間戳記資訊加入二進位檔；如果我們以一般方式將來源檔案編譯為物件檔案，時間戳記就會不正確。連結取樣編譯不得包含任何特定一組 編譯器旗標，因此不應仰賴任何特定 標頭、編譯器選項或其他建構變數。 只有在 base 套件。
linkstatic	布林值；預設值為 False 適用於 cc_binary 和 cc_test：連結靜態的二進位檔 模式。cc_library.linkstatic：請參閱下方說明。 這個選項預設為 cc_binary，其餘則為關閉。 如果已啟用，且這是二進位檔或測試，這個選項會指示建構工具盡可能連結 .a 而非 .so 的使用者程式庫。部分系統程式庫可能仍然會以動態方式連結， 我們沒有靜態資料庫因此產生的可執行檔仍會以動態方式連結，因此只有「大部分」是靜態的。 連結執行檔的方法有三種： 使用 fully_static_link 功能的 STATIC，其中所有項目都會以靜態方式連結，例如「gcc -static foo.o libbar.a libbaz.a -lm」。 如要啟用這個模式，請在 features 屬性中指定 fully_static_link。 STATIC：以靜態方式連結所有使用者程式庫 (如果是 可用的版本)，但系統程式庫 (不包括 C/C++ 執行階段程式庫) 會透過動態連結的方式連結 (例如「gcc foo.o libfoo.a libbaz.a -lm」。 透過指定 linkstatic=True 即可啟用這個模式。 DYNAMIC，所有程式庫都會動態連結 (如果有動態版本)，例如「gcc foo.o libfoo.so libbaz.so -lm」。 如要啟用這個模式，請指定 linkstatic=False。 linkstatic 屬性如果用於 cc_library() 規則。 對於 C++ 程式庫，linkstatic=True 表示只允許靜態連結，因此不會產生 .so。linkstatic=False 不會阻止建立靜態資料庫。這個屬性用於控制動態程式庫的建立作業。 如果值為 linkstatic=False，建構工具會建立符號連結，指向 依賴 *.runfiles 區域的共用程式庫
local_defines	字串清單；預設為 [] 要新增至編譯行中的定義清單。取決於 「廠牌」替代和 Bourne 殼層權杖化。 每個字串都必須包含單一 Bourne 殼層符記 加在 -D 的前面，並新增至這個目標的編譯指令列。 而非依附關係
nocopts	String;預設值為 "" 從 C++ 編譯指令中移除相符的選項。取決於 「廠牌」變數替代。 系統會將此屬性的值解讀為規則運算式。符合這個規則運算式的任何現有 COPTS (包括規則的 copts 屬性中明確指定的值) 會從 COPTS：用於編譯這項規則。 這個屬性應該很少需要用。
strip_include_prefix	String;預設值為 "" 要從這項規則的標頭路徑去除的前置字元， 設定後，即可存取這項規則 hdrs 屬性中的標頭 遭到截斷的前置字元 如果是相對路徑，則會採用套件相關路徑。如果是絕對值 可理解為存放區相關路徑 緊接在 include_prefix 屬性中的前置字元後，再加上 移除。
textual_hdrs	標籤清單；預設為 [] 此程式庫發布的標頭檔案清單，可由依附規則中的來源以文字形式納入。 這是宣告無法自行編譯的標頭檔案的位置； 也就是說，這些物件必須一律 在其他來源檔案以文字形式納入 再也不是件繁重乏味的工作
win_def_file	標籤；預設為 None 要傳遞至連接器的 Windows DEF 檔案。 只有在 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	標籤清單；預設為 [] 要產生 C++ 程式碼的 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 目標。因此不在 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	標籤清單；預設為 [] 以靜態方式連結至共用資料庫的頂層程式庫 進行封存 這些直接依附元件的所有遞移程式庫依附元件都會連結至這個共用項目 只要 cc_shared_library 尚未連結這些程式庫 位置：dynamic_deps。 在分析期間，規則實作會將 deps 中列出的任何目標視為由共用程式庫匯出，以便在多個 cc_shared_libraries 匯出相同目標時顯示錯誤。規則執行 並不負責向連結器說明應由 共用物件使用者應透過連結器指令碼或來源程式碼中的可見度宣告來處理這個問題。 當相同的程式庫靜態連結至多個 cc_shared_library 時，實作也會觸發錯誤。若要避免這種情況，方法是新增 向「cc_library.tags」傳送"LINKABLE_MORE_THAN_ONCE"或列出清單 `cc_library` 做為其中一個共用程式庫的匯出檔案， 另一版本的 dynamic_dep。
additional_linker_inputs	標籤清單；預設為 [] 您可能要傳遞給連結器的任何其他檔案，例如連結器指令碼。 您必須個別傳遞連結器需要的任何連結器標記，才能讓連結器瞭解這個檔案。方法是透過 user_link_flags 屬性。
dynamic_deps	標籤清單；預設為 [] 這些是目前目標依附的其他 cc_shared_library 依附元件。 cc_shared_library 實作會使用 dynamic_deps (轉移之餘，即 dynamic_deps 目前目標的dynamic_deps)，決定哪些cc_libraries 請勿連結遞移的 deps，因為已提供相關服務 由其他 cc_shared_library 產生。
exports_filter	字串清單；預設為 [] 這項屬性含有目前聲稱要匯出的目標目標清單 共用媒體庫 任何目標 deps 都已知是共用程式庫匯出的。這項屬性應用於列出共用資料庫匯出的所有目標 而是 deps 的遞移依附元件 請注意，此屬性並不會在這些目標中新增依附元件邊緣， 依附元件邊緣應由 deps 建立。這個項目中的項目 屬性只是字串。請注意，將目標放在這個屬性中，就表示共用程式庫會從該目標匯出符號。cc_shared_library 邏輯實際上並未處理告知連結器應匯出哪些符號。 可使用的語法如下： 將 //foo:__package__ 納入 foo/BUILD 中的所有目標 //foo:__subpackages__ 可用於處理 foo/BUILD 中的任何目標，或 foo/ 以下的任何其他套件，例如 foo/bar/BUILD
shared_lib_name	String;預設值為 "" 根據預設，cc_shared_library 會根據以下條件使用共用程式庫輸出檔案的名稱： 目標名稱和平台包括擴充功能，有時也會包含前置字串。有時候，您可能不想使用預設名稱，例如載入 C++ 共用程式庫時 對於 Python 而言，預設的 lib* 前置字串通常不需要，因此您可以使用這個 屬性選擇自訂名稱。
user_link_flags	字串清單；預設值為 [] 您可能要傳遞給連結器的任何額外旗標。舉例來說 連結器知道透過 additional_linker_inputs 傳遞的連結器指令碼，您可以使用 包括： 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	標籤；預設為 None 要傳遞至連結器的 Windows DEF 檔案。 只有在 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	標籤；預設為 None 提示設定檔的標籤。提示檔案的副檔名為 .afdo 該標籤也可以指向 fdo_absolute_path_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	String;預設值為 "" FDO 設定檔的絕對路徑。FDO 檔案可以有下列其中一個副檔名：.profraw (用於未編入索引的 LLVM 設定檔)、.profdata (用於編入索引的 LLVM 設定檔)、.zip (用於儲存 LLVM profraw 設定檔) 或 .afdo (用於 AutoFDO 設定檔)。
profile	標籤；預設為 None FDO 設定檔或產生該設定檔的規則的標籤。FDO 檔案可使用下列其中一個副檔名：.profraw 用於未編入索引的 LLVM 設定檔、.profdata 用於已編入索引的 LLVM 設定檔、.zip 用於儲存 LLVM profraw 設定檔、.afdo 用於 AutoFDO 設定檔、.xfdo 用於 XBinary 設定檔。標籤也可以指向 fdo_absolute_path_profile 規則。
proto_profile	標籤；預設為 None protobuf 設定檔的標籤。

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	String;預設值為 "" MEMPROF 設定檔的絕對路徑。這個檔案只能包含 .profdata 或 .zip 副檔名 (ZIP 檔案必須包含 memprof.profdata 檔案)。
profile	標籤；預設為 None MEMPROF 設定檔的標籤。設定檔應具有 .profdata 副檔名 (針對已編入索引/符號化的 memprof 設定檔)，或 .zip 副檔名 (針對內含 memprof.profdata 檔案的 ZIP 檔案)。該標籤也可以指向 fdo_absolute_path_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	標籤；預設為 None 傳送至連結動作的設定檔標籤。這個檔案有 .txt 副檔名。

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	標籤清單；預設為 [] 要連結至二進位目標的其他程式庫清單。 這些可以是 cc_library 或 objc_library 目標。
srcs	標籤清單；預設為 [] 要處理以建立目標的 C 和 C++ 檔案清單。 這些是 C/C++ 來源檔案和標頭檔案，可以是非產生的 (一般來源檔案) 程式碼) 或由系統產生 所有 .cc、.c 和 .cpp 檔案都會編譯。如果檔案名稱位於 其他規則的 outs 會自動採用另一項規則 .h 檔案不會經過編譯，但可在 依據來源納入這項規則中的來源。.cc 和 .h 檔案中可以直接加入 這些srcs或 hdrs 列出的任何規則 deps 引數。 所有已 #include 的檔案都必須在這個規則的 srcs 屬性中提及，或是在參照的 cc_library() 的 hdrs 屬性中提及。建議的樣式是將與程式庫相關聯的標頭列在該程式庫的 hdrs 屬性中，並將與此規則來源相關聯的任何其他標頭列在 srcs 中。詳情請參閱「標頭包含檢查」一文。 如果規則名稱位於 srcs， 這項規則會自動依循該規則 如果命名規則的 outs 為 C 或 C++ 這些來源檔案都會編譯成這項規則 如果是程式庫檔案，請選擇相應的連結 允許的 srcs 檔案類型： C 和 C++ 來源檔案：.c、.cc、.cpp、 .cxx、.c++、.C C 和 C++ 標頭檔案：.h、.hh、.hpp、 .hxx、.inc、.inl、.H 使用 C 預先處理器組合：.S 封存檔：.a、.pic.a 「一律連結」程式庫：.lo、.pic.lo 共用資料庫 (版本化或反版本)：.so、 .so.version 物件檔案：.o，.pic.o ...以及產生這些檔案的任何規則。 根據 gcc 慣例，不同的擴充功能代表不同的程式設計語言。
additional_linker_inputs	標籤清單；預設為 [] 將這些檔案傳遞至 C++ 連結器指令。 例如，您可以在此提供已編譯的 Windows .res 檔案，以便嵌入二進位目標。
copts	字串清單；預設為 [] 將這些選項新增至 C++ 編譯指令。取決於「化變數」替代和 Bourne 殼層權杖化。 此屬性中的每個字串都會按照指定順序新增至 COPTS， 來編譯二進位目標標記只會影響此目標的編譯作業，而非其依附元件，因此請留意其他地方是否包含標頭檔案。所有路徑都應以工作區為依據，而非目前的套件。 如果套件已宣告功能 no_copts_tokenization，Bourne 殼層權杖化功能僅適用於字串 其中包含一個「廠牌」變數。
defines	字串清單；預設為 [] 要新增至編譯行中的定義清單。取決於 「廠牌」替代和 Bourne 殼層權杖化。 每個字串都必須包含單一 Bourne 殼層符記，並在開頭加上 -D，然後新增至此目標的編譯指令行，以及依附於此目標的每個規則。請務必小心，因為這可能有 影響深遠的影響如有疑問，請將定義值加進 local_defines。
includes	字串清單；預設為 [] 要新增至編譯行的包含 URI 清單。 適用於 "Make 變數" 替換。 每個字串都會加上 -isystem，並新增至 COPTS。與 COPTS 不同，這些標記會新增至此規則和依附於此規則的所有規則。(注意：而不是仰賴的規則！)請務必謹慎操作，因為這可能會造成廣泛的影響。有疑慮就加上 「-我」標記為 COPTS。 標頭必須新增至 srcs 或 Hdr，否則就無法使用 預設規則。
link_extra_lib	標籤；預設為 "@bazel_tools//tools/cpp:link_extra_lib" 控管額外程式庫的連結作業。 根據預設，C++ 二進位檔會與 //tools/cpp:link_extra_lib 連結， 視標籤標記 //tools/cpp:link_extra_libs 而定。 如果沒有設定此標記，這個程式庫預設會空白。設定標籤標記 可連結選用的依附元件，例如惡意符號、攔截器的覆寫值 使用共用程式庫函式或特殊的執行階段程式庫 (如果是 Malloc 替換項目， 建議採用 malloc 或 --custom_malloc)。將此屬性設定為 None 會停用這個行為。
linkopts	字串清單；預設為 [] 將這些標記新增至 C++ 連接器指令。 取決於 「廠牌」替代變數， Bourne 殼層權杖化和 展開標籤。 這個屬性中的每個字串都會在連結二進位目標之前新增至 LINKOPTS。 這個清單中，凡是開頭不是 $ 或 - 的元素，都會視為 deps 中目標的標籤。 該目標產生的檔案清單會附加至連結器 只要設定成「自動重新啟動」 和「在主機維護期間」選項即可如果標籤無效或 未在 deps 中宣告。
linkstatic	布林值，預設為 False 針對 cc_binary 和 cc_test：在靜態模式中連結二進位檔。cc_library.linkstatic：請參閱下方說明。 這個選項預設為 cc_binary，其餘則為關閉。 如果已啟用，且這是二進位檔或測試，這個選項會指示建構工具盡可能連結 .a 而非 .so 的使用者程式庫。部分系統程式庫可能仍然會以動態方式連結， 我們沒有靜態資料庫因此產生的可執行檔仍會以動態方式連結，因此只有「大部分」是靜態的。 連結執行檔的方法有三種： 使用 fully_static_link 功能的 STATIC，其中所有項目都會以靜態方式連結，例如「gcc -static foo.o libbar.a libbaz.a -lm」。 如要啟用這個模式，請在 features 屬性中指定 fully_static_link。 STATIC：以靜態方式連結所有使用者程式庫 (如果是 可用的版本)，但系統程式庫 (不包括 C/C++ 執行階段程式庫) 會透過動態連結的方式連結 (例如「gcc foo.o libfoo.a libbaz.a -lm」。 透過指定 linkstatic=True 即可啟用這個模式。 DYNAMIC，所有程式庫都會動態連結 (如果有動態版本)，例如「gcc foo.o libfoo.so libbaz.so -lm」。 如要啟用這個模式，請指定 linkstatic=False。 linkstatic 屬性如果用於 cc_library() 規則。 如果是 C++ 程式庫，linkstatic=True 表示只有 系統允許使用靜態連結，因此不會產生 .so。linkstatic=False 包含 但無法防止建立靜態資料庫這個屬性用於控制動態程式庫的建立作業。 如果值為 linkstatic=False，建構工具會建立符號連結，指向 依賴 *.runfiles 區域的共用程式庫
local_defines	字串清單；預設為 [] 要新增至編譯行的定義清單。 適用於「Make」變數替換和 Bourne shell 符記化。每個字串都必須包含一個 Bourne shell 符記，並在開頭加上 -D，然後加入這個目標的編譯指令行，但不加入其依附項目。
malloc	標籤；預設為 "@bazel_tools//tools/cpp:malloc" 覆寫對 malloc 的預設依附元件。 根據預設，C++ 二進位檔會連結至 //tools/cpp:malloc，這是空白程式庫，因此二進位檔會使用 libc malloc。這個標籤必須參照 cc_library。如果編譯作業是針對非 C++ 規則，這個選項就不會生效。如果發生下列情形，系統會忽略這個屬性的值： 已指定 linkshared=True。
nocopts	String;預設值為 "" 移除 C++ 編譯指令中的相符選項。 適用於 "Make" 變數替換。 系統會將此屬性的值解讀為規則運算式。符合這個規則運算式的任何現有 COPTS (包括規則的 copts 屬性中明確指定的值) 會從 COPTS：用於編譯這項規則。 這個屬性應該很少需要用。
stamp	整數；預設值為 0 是否將建構資訊編碼至二進位檔。可能的值包括： stamp = 1：一律將建構資訊刻印到二進位檔案中，即使是在 --nostamp 版本中也是如此。請避免使用這項設定，因為這可能會導致二進位檔和任何依賴二進位檔的後續動作無法進行遠端快取。 stamp = 0：一律以常數值取代建構資訊。這個 也提供良好的建構結果快取功能 stamp = -1：建構資訊的嵌入功能是由 --[no]stamp 標記。 除非其依附元件變更，否則系統「不會」重新建構加上時間戳記的二進位檔。
win_def_file	標籤；預設為 None 要傳遞至連接器的 Windows DEF 檔案。 只有在 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)。 這就是 cc_toolchain.files 的內容，所有使用 C++ 工具鏈的 Starlark 規則都會使用這項內容。
ar_files	標籤；預設為 None 收集封存動作所需的所有 cc_toolchain 構件。
as_files	標籤；預設為 None 組合動作所需的所有 cc_toolchain 構件。
compiler_files	標籤；必選 編譯動作所需的所有 cc_toolchain 構件。
compiler_files_without_includes	標籤；預設為 None 如果出現編譯動作所需的 cc_toolchain 構件， 支援輸入探索 (目前只支援 Google)。
coverage_files	標籤；預設為 None 收集涵蓋率動作所需的所有 cc_toolchain 構件。如果未指定，系統會使用 all_files。
dwp_files	標籤；必填 收集 dwp 動作所需的所有 cc_toolchain 構件。
dynamic_runtime_lib	標籤；預設為 None C++ 執行階段程式庫的動態程式庫構件 (例如 libstdc++.so)。 這將用於「static_link_cpp_runtimes」功能已啟用，而我們要連結 動態依附元件
exec_transition_for_inputs	布林值；預設值為 True 設為 True 即可將 exec 平台的所有檔案輸入內容建構至 cc_toolchain。 而不完成轉換 (即預設為目標平台)。
libc_top	標籤；預設為 None 一系列 libc 構件，會作為編譯/連結動作的輸入內容。
linker_files	標籤；必填 收集連結動作所需的所有 cc_toolchain 構件。
module_map	標籤；預設為 None 模組對應成果物，用於模組化建構。
objcopy_files	標籤；必選 收集 objcopy 動作所需的所有 cc_toolchain 構件。
static_runtime_lib	標籤；預設為 None C++ 執行階段程式庫的靜態資料庫構件 (例如 libstdc++.a)。 這將用於「static_link_cpp_runtimes」功能已啟用，而我們要連結 靜態依附元件
strip_files	標籤；必填 包含移除操作所需的所有 cc_toolchain 構件。
supports_header_parsing	布林值，預設值為 False 如果 cc_toolchain 支援標頭剖析動作，請將此值設為 True。
supports_param_files	布林值；預設值為 True 如果 cc_toolchain 支援使用 param 檔案連結動作，請將此值設為 True。
toolchain_config	標籤；必填 提供 cc_toolchain_config_info 的規則標籤。
toolchain_identifier	String;不可設定；預設為 "" 用來比對此 cc_toolchain 與 crosstool_config.toolchain. 直到問題 #5380 已修正 建議您使用這個方法將 cc_toolchain 與 CROSSTOOL.toolchain。這項屬性將會替換為 toolchain_config (#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++ 工具鍊。
• 根據 --cpu 和 --compiler 選項選擇一個工具鍊 並傳遞至 Bazel

另請參閱 第 頁 查看詳細的 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", }, )