平台和工具鍊規則

有這組規則，可讓您針對要建構的特定硬體平台建立模型，並指定編譯這些平台程式碼所需的特定工具。使用者應熟悉這裡所述的概念。

規則

• constraint_setting
• constraint_value
• platform
• 工具鏈
• toolschain_type

constraint_setting

constraint_setting(name, default_constraint_value, deprecation, distribs, features, licenses, tags, testonly, visibility)

這項規則是用來導入新的限制類型，這類限制可以由平台指定值。舉例來說，您可以定義名為「glibc_version」的 constraint_setting，用來代表平台可安裝不同版本的 glibc 程式庫。詳情請參閱「平台」頁面。

每個 constraint_setting 都有一組可擴充的相關 constraint_value。這類變數通常在同一個套件中定義，但有時其他套件會為現有設定導入新的值。舉例來說，您可以使用自訂值擴充預先定義的設定 @platforms//cpu:cpu，藉此定義鎖定不明 CPU 架構的平台。

引數

constraint_value

constraint_value(name, constraint_setting, deprecation, distribs, features, licenses, tags, testonly, visibility)

範例

以下為預先定義的 constraint_value 建立新的可能值，代表 CPU 架構。

constraint_value(
    name = "mips",
    constraint_setting = "@platforms//cpu:cpu",
)

引數

平台

platform(name, constraint_values, deprecation, distribs, exec_properties, features, licenses, parents, remote_execution_properties, tags, testonly, visibility)

這項規則會定義新的平台，這是已命名的限制選項集合 (例如 CPU 架構或編譯器版本)，用來說明可執行建構作業的環境。詳情請參閱平台頁面。

範例

這個平台定義了在 ARM 上執行 Linux 的任何環境。

platform(
    name = "linux_arm",
    constraint_values = [
        "@platforms//os:linux",
        "@platforms//cpu:arm",
    ],
)

平台繼承

平台可以使用 parents 屬性，指定要從哪個平台繼承限制值。雖然 parents 屬性採用清單，但目前僅支援一個值，而且指定多個父項是錯誤。

在平台中檢查限制條件設定的值時，系統會先檢查直接設定的值 (透過 constraint_values 屬性)，然後檢查父項的限制條件值。這會繼續遞迴上層的父項平台。如此一來，在平台上直接設定的任何值都會覆寫父項設定的值。

平台會繼承父項平台的 exec_properties 屬性。系統會將父項和子項平台 exec_properties 中的字典項目合併。如果父項和子項的 exec_properties 中都出現相同的鍵，系統會使用子項的值。如果子平台將空白字串指定為值，系統會取消設定對應的屬性。

平台也可以從父項平台繼承 (已淘汰) 的 remote_execution_properties 屬性。注意：新程式碼應改用 exec_properties。下方所述的邏輯會維持與舊版行為相容，但日後將會移除。有父項平台時，設定 remote_execution_platform 的邏輯如下所示：

1. 如未在子平台上設定 remote_execution_property，系統會使用父項的 remote_execution_properties。
2. 如果在子項平台設定 remote_execution_property，且包含常值字串 {PARENT_REMOTE_EXECUTION_PROPERTIES}，則該巨集會替換為父項 remote_execution_property 屬性的內容。
3. 如果 remote_execution_property 是在子平台上設定，且不含巨集，則會使用子項的 remote_execution_property 而不會變更。

由於 remote_execution_properties 已淘汰，並將逐步淘汰，因此不允許在同一個繼承鏈結中混用 remote_execution_properties 和 exec_properties。偏好使用 exec_properties 而非已淘汰的 remote_execution_properties。

範例：限制值

platform(
    name = "parent",
    constraint_values = [
        "@platforms//os:linux",
        "@platforms//cpu:arm",
    ],
)
platform(
    name = "child_a",
    parents = [":parent"],
    constraint_values = [
        "@platforms//cpu:x86_64",
    ],
)
platform(
    name = "child_b",
    parents = [":parent"],
)

在這個範例中，子平台具有下列屬性：

• child_a 具有限制值 @platforms//os:linux (沿用自父項) 和 @platforms//cpu:x86_64 (直接在平台中設定)。
• child_b 會繼承父項的所有限制值，且不會設定任何自身的限制值。

執行屬性範例

platform(
    name = "parent",
    exec_properties = {
      "k1": "v1",
      "k2": "v2",
    },
)
platform(
    name = "child_a",
    parents = [":parent"],
)
platform(
    name = "child_b",
    parents = [":parent"],
    exec_properties = {
      "k1": "child"
    }
)
platform(
    name = "child_c",
    parents = [":parent"],
    exec_properties = {
      "k1": ""
    }
)
platform(
    name = "child_d",
    parents = [":parent"],
    exec_properties = {
      "k3": "v3"
    }
)

在這個範例中，子平台具有下列屬性：

• child_a 會繼承父項的「exec_properties」，而不會自行設定。
• child_b 會繼承父項的 exec_properties，並覆寫 k1 的值。其 exec_properties 會是： { "k1": "child", "k2": "v2" }。
• child_c 會繼承父項的 exec_properties，並取消設定 k1。exec_properties 應為 { "k2": "v2" }。
• child_d 會繼承父項的 exec_properties，並新增屬性。exec_properties 應為 { "k1": "v1", "k2": "v2", "k3": "v3" }。

引數

工具鏈

toolchain(name, deprecation, distribs, exec_compatible_with, features, licenses, tags, target_compatible_with, target_settings, testonly, toolchain, toolchain_type, visibility)

這項規則會宣告特定工具鍊的類型和限制，以便在工具鍊解析期間選取。詳情請參閱「工具鏈」頁面。

引數

toolchain_type

toolchain_type(name, compatible_with, deprecation, features, restricted_to, tags, target_compatible_with, testonly, visibility)

此規則定義了新型的工具鍊，一個簡單的目標代表的一種工具類別，為不同平台提供相同角色。

詳情請參閱工具鍊頁面。

範例

這會定義自訂規則的工具鍊類型，

toolchain_type(
    name = "bar_toolchain_type",
)

這可用於 bzl 檔案。

bar_binary = rule(
    implementation = _bar_binary_impl,
    attrs = {
        "srcs": attr.label_list(allow_files = True),
        ...
        # No `_compiler` attribute anymore.
    },
    toolchains = ["//bar_tools:toolchain_type"]
)

引數