C / C++ 規則

回報問題 查看來源

Nightly · 8.4 · 8.3 · 8.2 · 8.1 · 8.0 · 7.6

規則

• cc_binary
• cc_import
• cc_library
• cc_proto_library
• cc_shared_library
• cc_static_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 中列出的標頭，或 deps 引數中列出任何規則的 hdrs。 所有 #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 「Always link」程式庫：.lo、.pic.lo 共用程式庫 (有版本或無版本)：.so, .so.version 物件檔案：.o、.pic.o 以及產生這些檔案的任何規則。 根據 gcc 慣例，不同的副檔名代表不同的程式設計語言。
additional_linker_inputs	標籤清單；預設值為 [] 將這些檔案傳送至 C++ 連接器指令。 舉例來說，這裡可以提供已編譯的 Windows .res 檔案，以便嵌入二進位目標。
copts	字串清單；預設值為 [] 將這些選項新增至 C++ 編譯指令。 須遵守「製作變數」替代和 Bourne Shell 權杖化。 這個屬性中的每個字串都會依指定順序新增至 COPTS，然後編譯二進位目標。這些標記只會對編譯這個目標生效，不會影響其依附元件，因此請小心其他位置包含的標頭檔。所有路徑都應以工作區為基準，而非以目前的套件為基準。 如果套件宣告了功能 no_copts_tokenization，Bourne Shell 權杖化只會套用至由單一「Make」變數組成的字串。
defines	字串清單；預設值為 [] 要新增至編譯行的定義清單。 須遵守「Make」變數替換和 Bourne Shell 權杖化。 每個字串都必須包含單一 Bourne Shell 符記，並以 -D 為前置字元，然後新增至這個目標的編譯指令列，以及每個依附於這個目標的規則。請務必謹慎操作，因為這可能會造成深遠影響。如有疑問，請改為在 local_defines 中新增定義值。
includes	字串清單；預設值為 [] 要新增至編譯行的 include 目錄清單。 須視「建立變數」替代項目而定。 每個字串都會加上 -isystem 前置字元，並新增至 COPTS。 與 COPTS 不同，這些標記會新增至這項規則和所有依附於這項規則的規則。(注意：不是規則所依據的規則！)請務必謹慎操作，因為這可能會造成深遠影響。如有疑問，請在 COPTS 中加入「-I」旗標。 標頭必須新增至 srcs 或 hdrs，否則在編譯作業受到沙箱限制時 (預設)，標頭將無法供相依規則使用。
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++ 連接器指令。 須遵守「Make」變數替換、 Bourne Shell 權杖化和 標籤擴展。 這個屬性中的每個字串都會新增至 LINKOPTS，然後連結二進位目標。 如果清單中的元素不是以 $ 或 - 開頭，系統會將其視為 deps 中目標的標籤。該目標產生的檔案清單會附加至連結器選項。如果標籤無效或未在 deps 中宣告，系統就會回報錯誤。
linkshared	布林值；無法設定；預設值為 False 建立共用程式庫。 如要啟用這項屬性，請在規則中加入 linkshared=True。這項功能預設為關閉。 這個標記表示連結作業會使用 -shared 標記至 gcc，且產生的共用程式庫適合載入 Java 程式等。不過，基於建構目的，系統絕不會將其連結至依附的二進位檔，因為以 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's，而不是 .so's。部分系統程式庫可能仍會動態連結，沒有靜態程式庫的程式庫也是如此。因此產生的可執行檔仍會動態連結，因此大多是靜態。 連結可執行檔的方式有三種： STATIC (使用 fully_static_link 功能)，所有項目都會靜態連結；例如「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 即可啟用這個模式。 如果用於 cc_library() 規則，linkstatic 屬性的意義會有所不同。如果是 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	字串；預設值為 "" 從 C++ 編譯指令中移除相符的選項。 須代入「Make」變數。 這項屬性的值會解讀為規則運算式。凡是符合這項規則運算式的現有 COPTS (包括規則 copts 屬性中明確指定的值)，都會從 COPTS 中移除，以便編譯這項規則。這個屬性應該很少會用到。
stamp	整數；預設值為 -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. 連結至靜態或共用程式庫
在 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++ 預先編譯程式庫的二進位檔，都會連結到靜態程式庫中封存的所有物件檔案，即使部分檔案不含二進位檔參照的符號也一樣。如果二進位檔中的程式碼未明確呼叫您的程式碼，例如您的程式碼註冊接收某項服務提供的某些回呼，這就很有用。 如果 alwayslink 無法在 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)

檢查是否包含標頭

建構作業中使用的所有標頭檔案都必須在 hdrs 或 srcs 的 cc_* 規則中宣告。這項限制會強制執行。

如果是 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 檔案的編譯作業可能會遞移地包含 hdrs 或 srcs 中任何 cc_library 的標頭檔案，而這些檔案位於遞移 deps 封閉中。在這種情況下，編譯器可能會在編譯 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	標籤清單；預設值為 [] 要連結至二進位目標的其他程式庫清單。 這些可以是 cc_library 或 objc_library 目標。
srcs	標籤清單；預設值為 [] 系統會處理 C 和 C++ 檔案清單，以建立目標。 這些是 C/C++ 來源和標頭檔案，可能是非產生 (一般來源程式碼) 或產生。 系統會編譯所有 .cc、.c 和 .cpp 檔案。這些可能是產生的檔案：如果具名檔案位於其他規則的 outs 中，這項規則會自動依附於該其他規則。 系統不會編譯 .h 檔案，但這項規則中的來源可以納入該檔案。.cc 和 .h 檔案可以直接包含這些 srcs 中列出的標頭，或 deps 引數中列出任何規則的 hdrs。 所有 #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 「Always link」程式庫：.lo、.pic.lo 共用程式庫 (有版本或無版本)：.so, .so.version 物件檔案：.o、.pic.o 以及產生這些檔案的任何規則。 根據 gcc 慣例，不同的副檔名代表不同的程式設計語言。
hdrs	標籤清單；預設值為 [] 這個程式庫發布的標頭檔案清單，可由依附規則中的來源直接納入。 這是宣告標頭檔案的強烈建議位置，這些檔案會說明程式庫的介面。來源可透過這項規則或依附規則，納入這些標頭。不應由這個程式庫的用戶端納入的標頭，應列在 srcs 屬性中，即使這些標頭是由已發布的標頭納入也一樣。如需更詳細的說明，請參閱「檢查是否包含標頭」。
additional_compiler_inputs	標籤清單；預設值為 [] 您可能想傳遞至編譯器指令列的任何其他檔案，例如清除器忽略清單。然後，您可以使用 $(location) 函式，在 copts 中使用這裡指定的檔案。
additional_linker_inputs	標籤清單；預設值為 [] 將這些檔案傳送至 C++ 連接器指令。 舉例來說，這裡可以提供已編譯的 Windows .res 檔案，以便嵌入二進位目標。
alwayslink	布林值；預設值為 False 如果是 1，任何 (直接或間接) 依附於這個 C++ 程式庫的二進位檔，都會連結 srcs 中列出的所有檔案的物件檔案，即使有些檔案不含二進位檔參照的符號也一樣。如果二進位檔中的程式碼未明確呼叫您的程式碼，例如您的程式碼註冊接收某項服務提供的某些回呼，這就很有用。 如果 alwayslink 無法在 Windows 上的 VS 2017 運作，這是已知問題，請將 VS 2017 升級至最新版本。
copts	字串清單；預設值為 [] 將這些選項新增至 C++ 編譯指令。 須遵守「製作變數」替代和 Bourne Shell 權杖化。 這個屬性中的每個字串都會依指定順序新增至 COPTS，然後編譯二進位目標。這些標記只會對編譯這個目標生效，不會影響其依附元件，因此請小心其他位置包含的標頭檔。所有路徑都應以工作區為基準，而非以目前的套件為基準。 如果套件宣告了功能 no_copts_tokenization，Bourne Shell 權杖化只會套用至由單一「Make」變數組成的字串。
defines	字串清單；預設值為 [] 要新增至編譯行的定義清單。 須遵守「Make」變數替換和 Bourne Shell 權杖化。 每個字串都必須包含單一 Bourne Shell 符記，並以 -D 為前置字元，然後新增至這個目標的編譯指令列，以及每個依附於這個目標的規則。請務必謹慎操作，因為這可能會造成深遠影響。如有疑問，請改為在 local_defines 中新增定義值。
implementation_deps	標籤清單；預設值為 [] 程式庫目標依附的其他程式庫清單。與 deps 不同，這些程式庫 (以及所有遞移依附元件) 的標頭和包含路徑僅用於編譯這個程式庫，而非依附於這個程式庫的程式庫。使用 implementation_deps 指定的程式庫仍會連結至依附於這個程式庫的二進位目標。 目前使用範圍僅限於 cc_libraries，並受 --experimental_cc_implementation_deps 標記保護。
include_prefix	字串；預設值為 "" 要新增至這項規則標頭路徑的前置字串。 設定後，即可在規則的 hdrs 屬性中存取標頭，方法是將此屬性的值加到標頭的存放區相對路徑前面。 系統會先移除 strip_include_prefix 屬性中的前置字串，再新增這個前置字串。
includes	字串清單；預設值為 [] 要新增至編譯行的 include 目錄清單。 須視「建立變數」替代項目而定。 每個字串都會加上 -isystem 前置字元，並新增至 COPTS。 與 COPTS 不同，這些標記會新增至這項規則和所有依附於這項規則的規則。(注意：不是規則所依據的規則！)請務必謹慎操作，因為這可能會造成深遠影響。如有疑問，請在 COPTS 中加入「-I」旗標。 標頭必須新增至 srcs 或 hdrs，否則在編譯作業受到沙箱限制時 (預設)，標頭將無法供相依規則使用。
linkopts	字串清單；預設值為 [] 將這些標記新增至 C++ 連接器指令。 須遵守「Make」變數替換、 Bourne Shell 權杖化和 標籤擴展。 這個屬性中的每個字串都會新增至 LINKOPTS，然後連結二進位目標。 如果清單中的元素不是以 $ 或 - 開頭，系統會將其視為 deps 中目標的標籤。該目標產生的檔案清單會附加至連結器選項。如果標籤無效或未在 deps 中宣告，系統就會回報錯誤。
linkstamp	標籤；預設值為 None 同時將指定的 C++ 來源檔案編譯並連結至最終二進位檔。這是將時間戳記資訊導入二進位檔的必要手法；如果以一般方式將來源檔案編譯為物件檔案，時間戳記就會不正確。連結時間戳記編譯作業可能不包含任何特定編譯器標記組合，因此不應依附任何特定標頭、編譯器選項或其他建構變數。這個選項應該只會在 base 套件中用到。
linkstatic	布林值；預設值為 False 如果是 cc_binary 和 cc_test，請以靜態模式連結二進位檔。如為 cc_library.linkstatic，請參閱下文。 這項選項預設為 cc_binary 開啟，其餘則為關閉。 如果啟用這個選項，且這是二進位檔或測試，這個選項會告知建構工具盡可能連結使用者程式庫的 .a's，而不是 .so's。部分系統程式庫可能仍會動態連結，沒有靜態程式庫的程式庫也是如此。因此產生的可執行檔仍會動態連結，因此大多是靜態。 連結可執行檔的方式有三種： STATIC (使用 fully_static_link 功能)，所有項目都會靜態連結；例如「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 即可啟用這個模式。 如果用於 cc_library() 規則，linkstatic 屬性的意義會有所不同。如果是 C++ 程式庫，linkstatic=True 表示只允許靜態連結，因此不會產生 .so。linkstatic=False 不會阻止建立靜態程式庫。這個屬性是用來控制動態程式庫的建立作業。 如果是 linkstatic=False，建構工具會在 *.runfiles 區域中，為所依附的共用程式庫建立符號連結。
local_defines	字串清單；預設值為 [] 要新增至編譯行的定義清單。 須遵守「Make」變數替換和 Bourne Shell 權杖化。 每個字串都必須由單一 Bourne Shell 符記組成，並以 -D 為前置字元，然後加入這個目標的編譯指令列，但不會加入其依附元件。
nocopts	字串；預設值為 "" 從 C++ 編譯指令中移除相符的選項。 須代入「Make」變數。 這項屬性的值會解讀為規則運算式。凡是符合這項規則運算式的現有 COPTS (包括規則 copts 屬性中明確指定的值)，都會從 COPTS 中移除，以便編譯這項規則。這個屬性應該很少會用到。
strip_include_prefix	字串；預設值為 "" 要從這項規則的標頭路徑中移除的前置字串。 設定後，即可在路徑存取這項規則的 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，後者是遞移依附元件。因為 dynamic_dep bar_shared 已動態提供 bar，因此不會連結。

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，就需要在 baz 中加入 tags = ["LINKABLE_MORE_THAN_ONCE"]。

由於 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	標籤清單；預設值為 [] 在完整封存後，會無條件靜態連結至共用程式庫的頂層程式庫。 只要這些直接依附元件的任何遞移程式庫依附元件尚未由 cc_shared_library 連結至 dynamic_deps，就會連結至這個共用程式庫。 在分析期間，規則實作會將 deps 中列出的任何目標視為由共用程式庫匯出，以便在多個 cc_shared_libraries 匯出相同目標時提供錯誤。規則實作不會負責通知連結器共用物件應匯出哪些符號。使用者應透過連結器指令碼或原始碼中的可見度宣告，處理這項問題。 如果將同一個程式庫靜態連結至多個 cc_shared_library，實作作業也會觸發錯誤。如要避免這種情況，請將 "LINKABLE_MORE_THAN_ONCE" 新增至 cc_library.tags，或將 `cc_library` 列為其中一個共用程式庫的匯出項目，這樣就能將一個程式庫設為另一個程式庫的 dynamic_dep。
additional_linker_inputs	標籤清單；預設值為 [] 您可能想傳遞給連結器的任何其他檔案，例如連結器指令碼。 您必須個別傳遞連結器所需的任何連結器標記，連結器才能識別這個檔案。您可以使用 user_link_flags 屬性執行這項操作。
dynamic_deps	標籤清單；預設值為 [] 這些是目前目標依附的其他 cc_shared_library。 cc_shared_library 實作會使用 dynamic_deps 清單 (遞移性，也就是目前目標的 dynamic_deps) 決定遞移性 deps 中的哪些 cc_libraries 不應連結，因為這些 cc_libraries 已由其他 cc_shared_library 提供。dynamic_deps
exports_filter	字串清單；預設值為 [] 這個屬性包含一份目標清單，其中列出目前共用程式庫宣稱要匯出的目標。 任何目標 deps 都會匯出至共用程式庫。這項屬性應列出共用程式庫匯出的所有目標，但這些目標是 deps 的遞移依附元件。 請注意，這項屬性實際上不會將依附元件邊緣新增至這些目標，依附元件邊緣應改由 deps 建立。這項屬性中的項目只是字串。請注意，在這個屬性中放置目標時，系統會將此視為共用程式庫會匯出該目標符號的聲明。cc_shared_library 邏輯實際上不會處理要匯出哪些符號給連結器。 允許的語法如下： //foo:__package__，以說明 foo/BUILD 中的任何目標 //foo:__subpackages__，以納入 foo/BUILD 中的任何目標，或 foo/ 底下的任何其他套件，例如 foo/bar/BUILD
shared_lib_name	字串；預設值為 "" 根據預設，cc_shared_library 會根據目標名稱和平台，為共用程式庫輸出檔案命名。包括副檔名，有時也包含前置字元。 有時您可能不想要使用預設名稱，例如為 Python 載入 C++ 共用程式庫時，通常不希望使用預設的 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 是目標平台時，才應使用這項屬性。 連結共用程式庫時，可用於 匯出符號。

cc_static_library

查看規則來源

cc_static_library(name, deps, tags)

從目標清單及其轉換式依附元件產生靜態程式庫。

產生的靜態程式庫包含 deps 中列出的目標物件檔案，以及這些檔案的遞移依附元件，並優先使用 PIC 物件。

輸出群組

linkdeps

文字檔，內含 deps 中列出目標的遞移依附元件標籤，這些依附元件未將任何物件檔案提供給靜態程式庫，但至少提供一個靜態、動態或介面程式庫。產生的靜態程式庫可能需要這些程式庫在連結時可用。

linkopts

文字檔，內含 deps 中列出目標的所有遞移依附元件的使用者提供 linkopts。

重複符號

根據預設，cc_static_library 規則會檢查產生的靜態程式庫是否含有重複符號。如果發生這種情況，建構作業會失敗，並顯示錯誤訊息，列出重複的符號和包含這些符號的物件檔案。

您可以透過設定 features = ["-symbol_check"] 停用每個目標或套件的這項檢查，也可以透過 --features=-symbol_check 全域停用。

symbol_check 的工具鍊支援

Bazel 隨附的自動設定 C++ 工具鍊支援所有平台上的 symbol_check 功能。自訂工具鍊可透過下列兩種方式之一，新增對該項目的支援：

• 實作 ACTION_NAMES.validate_static_library 動作，並透過 symbol_check 功能啟用該動作。系統會使用兩個引數叫用動作中設定的工具：要檢查重複符號的靜態程式庫，以及檢查通過時必須建立的檔案路徑。
• symbol_check 功能會新增封存器旗標，導致建立靜態程式庫的動作因符號重複而失敗。

引數

屬性
name	名稱：必填 這個目標的專屬名稱。
deps	標籤清單；預設值為 [] 要合併為靜態程式庫的目標清單，包括所有遞移依附元件。 不提供任何物件檔案的依附元件不會納入靜態程式庫，但其標籤會收集在 linkdeps 輸出群組提供的檔案中。

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	字串；預設值為 "" FDO 設定檔的絕對路徑。FDO 檔案的副檔名只能是 .afdo。
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	字串；預設值為 "" 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 中列出的標頭，或 deps 引數中列出任何規則的 hdrs。 所有 #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 「Always link」程式庫：.lo、.pic.lo 共用程式庫 (有版本或無版本)：.so, .so.version 物件檔案：.o、.pic.o 以及產生這些檔案的任何規則。 根據 gcc 慣例，不同的副檔名代表不同的程式設計語言。
additional_linker_inputs	標籤清單；預設值為 [] 將這些檔案傳送至 C++ 連接器指令。 舉例來說，這裡可以提供已編譯的 Windows .res 檔案，以便嵌入二進位目標。
copts	字串清單；預設值為 [] 將這些選項新增至 C++ 編譯指令。 須遵守「製作變數」替代和 Bourne Shell 權杖化。 這個屬性中的每個字串都會依指定順序新增至 COPTS，然後編譯二進位目標。這些標記只會對編譯這個目標生效，不會影響其依附元件，因此請小心其他位置包含的標頭檔。所有路徑都應以工作區為基準，而非以目前的套件為基準。 如果套件宣告了功能 no_copts_tokenization，Bourne Shell 權杖化只會套用至由單一「Make」變數組成的字串。
defines	字串清單；預設值為 [] 要新增至編譯行的定義清單。 須遵守「Make」變數替換和 Bourne Shell 權杖化。 每個字串都必須包含單一 Bourne Shell 符記，並以 -D 為前置字元，然後新增至這個目標的編譯指令列，以及每個依附於這個目標的規則。請務必謹慎操作，因為這可能會造成深遠影響。如有疑問，請改為在 local_defines 中新增定義值。
includes	字串清單；預設值為 [] 要新增至編譯行的 include 目錄清單。 須視「建立變數」替代項目而定。 每個字串都會加上 -isystem 前置字元，並新增至 COPTS。 與 COPTS 不同，這些標記會新增至這項規則和所有依附於這項規則的規則。(注意：不是規則所依據的規則！)請務必謹慎操作，因為這可能會造成深遠影響。如有疑問，請在 COPTS 中加入「-I」旗標。 標頭必須新增至 srcs 或 hdrs，否則在編譯作業受到沙箱限制時 (預設)，標頭將無法供相依規則使用。
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++ 連接器指令。 須遵守「Make」變數替換、 Bourne Shell 權杖化和 標籤擴展。 這個屬性中的每個字串都會新增至 LINKOPTS，然後連結二進位目標。 如果清單中的元素不是以 $ 或 - 開頭，系統會將其視為 deps 中目標的標籤。該目標產生的檔案清單會附加至連結器選項。如果標籤無效或未在 deps 中宣告，系統就會回報錯誤。
linkstatic	布林值；預設值為 False 如果是 cc_binary 和 cc_test，請以靜態模式連結二進位檔。如為 cc_library.linkstatic，請參閱下文。 這項選項預設為 cc_binary 開啟，其餘則為關閉。 如果啟用這個選項，且這是二進位檔或測試，這個選項會告知建構工具盡可能連結使用者程式庫的 .a's，而不是 .so's。部分系統程式庫可能仍會動態連結，沒有靜態程式庫的程式庫也是如此。因此產生的可執行檔仍會動態連結，因此大多是靜態。 連結可執行檔的方式有三種： STATIC (使用 fully_static_link 功能)，所有項目都會靜態連結；例如「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 即可啟用這個模式。 如果用於 cc_library() 規則，linkstatic 屬性的意義會有所不同。如果是 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	字串；預設值為 "" 從 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 結尾的其他屬性。這些屬性最常見於 filegroups，會將所有必要檔案 globbing。
• 為 C++ 動作產生正確的命令列。這項操作透過 CcToolchainConfigInfo 提供者完成 (詳情請見下文)。

使用 toolchain_config 屬性設定 C++ 工具鍊。 如需詳細的 C++ 工具鍊設定和工具鍊選取說明文件，請參閱 這個頁面 。

使用 tags = ["manual"]，避免在叫用 bazel build //... 時不必要地建構及設定工具鍊

引數

屬性
name	名稱：必填 這個目標的專屬名稱。
all_files	標籤 (必填) 所有 cc_toolchain 構件的集合。這些構件會新增為所有 rules_cc 相關動作的輸入內容 (但使用下列屬性中更精確構件集的動作除外)。Bazel 假設 all_files 是所有其他提供構件屬性的超集 (例如，linkstamp 編譯需要編譯和連結檔案，因此會採用 all_files)。 這是 cc_toolchain.files 包含的內容，所有使用 C++ 工具鍊的 Starlark 規則都會用到。
ar_files	標籤；預設值為 None 收集封存動作所需的所有 cc_toolchain 構件。
as_files	標籤；預設值為 None 組裝動作所需的所有 cc_toolchain 構件集合。
compiler_files	標籤 (必填) Collection of all cc_toolchain artifacts required for compile actions.
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 可為執行平台將所有檔案輸入內容建構至 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 支援使用參數檔案進行連結動作，請設為 True。
toolchain_config	標籤 (必填) 提供 cc_toolchain_config_info 的規則標籤。
toolchain_identifier	字串；不可設定；預設值為 "" 用來將這個 cc_toolchain 與對應的 crosstool_config.toolchain 相符的 ID。 在問題 #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++ 工具鍊。
• 根據傳遞至 Bazel 的 --cpu 和 --compiler 選項選取其中一個工具鍊。

如需詳細的 C++ 工具鍊設定和工具鍊選取說明文件，請參閱 這個頁面 。

引數

屬性
name	名稱：必填 這個目標的專屬名稱。
toolchains	將字串對應至標籤的字典；不可設定；必要 從「<cpu>」或「<cpu>|<compiler>」字串到 cc_toolchain 標籤的對應。如果只將 --cpu 傳遞至 Bazel，系統會使用「<cpu&gt」；如果將 --cpu 和 --compiler 傳遞至 Bazel，系統會使用「<cpu>|<compiler&gt」。範例： cc_toolchain_suite( name = "toolchain", toolchains = { "piii|gcc": ":my_cc_toolchain_for_piii_using_gcc", "piii": ":my_cc_toolchain_for_piii_using_default_compiler", }, )