C / C++ 規則

Nightly · 8.4 · 8.3 · 8.2 · 8.1 · 8.0 · 7.7

規則

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，否則在編譯受到沙箱限制時 (預設)，標頭將無法供相依規則使用。

標籤；預設值為 "@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 即可啟用這個模式。
  • DYNAMIC：所有程式庫都會動態連結 (如有動態版本)，例如「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

標籤清單；預設值為 []

這個預先編譯的程式庫發布的標頭檔案清單，可由依附規則中的來源直接納入。

布林值；預設值為 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.hbar.h
foo.ccfoo.h bar.h
bar.hbar-impl.h baz.h
bar-impl.hbar.h baz.h
bar.ccbar.h bar-impl.h baz.h
baz.hbaz-impl.h
baz-impl.hbaz.h
baz.ccbaz.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 檔案，以便嵌入二進位目標。

布林值；預設值為 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 即可啟用這個模式。
  • DYNAMIC：所有程式庫都會動態連結 (如有動態版本)，例如「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_shared 正在匯出 foo。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 依附元件中停止匯出程式庫。

當您使用兩個不同的 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* 前置字串，這時您可以使用這個屬性選擇自訂名稱。

字串清單；預設值為 []

您可能想傳遞至連結器的任何其他旗標。舉例來說，如要讓連結器瞭解透過 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 檔案可使用下列其中一個副檔名： 未編列索引的 LLVM 設定檔為 .profraw、已編列索引的 LLVM 設定檔為 .profdata、包含 LLVM profraw 設定檔的 .zip，或是 AutoFDO 設定檔為 .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，否則在編譯受到沙箱限制時 (預設)，標頭將無法供相依規則使用。

標籤；預設值為 "@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 即可啟用這個模式。
  • DYNAMIC：所有程式庫都會動態連結 (如有動態版本)，例如「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",
            },
          )