プラットフォームとツールチェーンのルール

このルールセットは、ユーザーが利用する特定のハードウェア プラットフォームを そのプラットフォームのコードをコンパイルするために必要な特定のツールを指定します。 ユーザーは、こちらで説明されているコンセプトを理解している必要があります。

ルール

• <ph type="x-smartling-placeholder"></ph> constraint_setting
• <ph type="x-smartling-placeholder"></ph> constraint_value
• <ph type="x-smartling-placeholder"></ph> プラットフォーム
• <ph type="x-smartling-placeholder"></ph> ツールチェーン
• <ph type="x-smartling-placeholder"></ph> toolchain_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, flags, licenses, parents, remote_execution_properties, required_settings, tags, testonly, visibility)

このルールでは、新しいプラットフォーム（制約の選択肢の名前付きコレクション）を定義します。 （CPU アーキテクチャやコンパイラ バージョンなど）で環境を記述し、 ビルドのどの部分を実行するかを指定できます 詳しくは、プラットフォーム ページをご覧ください。

例

これにより、ARM で Linux を実行する環境を記述するプラットフォームが定義されます。

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

プラットフォーム フラグ

プラットフォームは flags 属性を使用して、追加するフラグのリストを指定できます。 ターゲット プラットフォームとして使用される場合（つまり、 --platforms フラグ）を指定します。

プラットフォームから設定されたフラグは実質的に最も優先順位が高く、それ以前に コマンドライン、RC ファイル、または遷移からそのフラグの値を指定します。

例

platform(
    name = "foo",
    flags = [
        "--dynamic_mode=fully",
        "--//bool_flag",
        "--no//package:other_bool_flag",
    ],
)

foo という名前のプラットフォームを定義します。これがターゲット プラットフォームの場合（ ユーザーが --platforms//:foo を指定しました。遷移によって //command_line_option:platforms フラグを ["//:foo"] に設定するか、 //:foo が実行プラットフォームとして使用されていた場合）は、特定のフラグが できます。

プラットフォームと繰り返し可能なフラグ

一部のフラグ（--features など）は、繰り返されるときに値を蓄積します。 --copt。config.string(repeatable = True) として作成された Starlark フラグ。 これらのフラグは、プラットフォームからのフラグの設定に対応していません。代わりに、以前のすべてのフラグが 値が削除され、プラットフォームから取得した値で上書きされます。

たとえば、次のプラットフォームの場合、build --platforms=//:repeat_demo --features feature_a --features feature_b の呼び出しは、最終的に --feature フラグが ["feature_c", "feature_d"] の場合、機能を削除します。 コマンドラインで設定します。

platform(
    name = "repeat_demo",
    flags = [
        "--features=feature_c",
        "--features=feature_d",
    ],
)

このため、flags 属性で繰り返し可能なフラグを使用することはおすすめしません。

プラットフォームの継承

プラットフォームは、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"]
)

引数