実行グループを使用すると、1 つのターゲット内で複数の実行プラットフォームを使用できます。 各実行グループには独自のツールチェーン依存関係がある。 独自のツールチェーンの解決を実行する。
背景
実行グループを使用すると、ルール作成者がアクションのセットを定義できます。定義の際に 実行プラットフォームが異なる場合があります複数の実行プラットフォームを使用すると iOS アプリをリモート コードでコンパイルするなど、 リンクとコード署名をローカルの Mac ワーカーで実行します。
また、アクション グループを定義できると、アクションの実行を アクションを指定するプロキシとして使用できます。記憶に残る表現は、必ずしも 1 つのアクションのみを参照できます。これは特に 特定のメモリに追加のリソースを割り当て、負荷の高いアクションを処理する たとえば、C++ ビルドでのリンクなど、必要性の低いタスクに過剰な割り当てを行わずに済みます。
実行グループの定義
ルールの作成中、ルール作成者はルールの定義時に
申告
実行グループのセットですルールの作成者は、実行グループごとに
その実行グループの実行プラットフォームを選択するために必要なすべてのもの、
つまり、exec_compatible_with
を介した制約と、
toolchain
。
# foo.bzl
my_rule = rule(
_impl,
exec_groups = {
“link”: exec_group(
exec_compatible_with = [ "@platforms//os:linux" ]
toolchains = ["//foo:toolchain_type"],
),
“test”: exec_group(
toolchains = ["//foo_tools:toolchain_type"],
),
},
attrs = {
"_compiler": attr.label(cfg = config.exec("link"))
},
)
上記のコード スニペットでは、ツールの依存関係も指定できます。
実行グループの移行を
cfg
属性 param と
config
説明します。このモジュールは、単一の文字列を受け取る exec
関数を公開します。
パラメータ。これは、依存関係が存在する実行グループの名前です。
構築しました。
ネイティブ ルールと同様に、Starlark には test
実行グループがデフォルトで存在します。
テストルールです。
実行グループへのアクセス
ルールの実装では、特定のデバイスでのアクションの実行を
実行プラットフォームを定義しますこれを行うには、exec_group
アクション生成メソッドのパラメータ。具体的には ctx.actions.run
と
ctx.actions.run_shell
。
# foo.bzl
def _impl(ctx):
ctx.actions.run(
inputs = [ctx.attr._some_tool, ctx.srcs[0]]
exec_group = "compile",
# ...
)
ルール作成者は、解決済みツールチェーンにもアクセスできます。 実行グループのロールを ターゲットの解決済みツールチェーンにアクセスできます。
# foo.bzl
def _impl(ctx):
foo_info = ctx.exec_groups["link"].toolchains["//foo:toolchain_type"].fooinfo
ctx.actions.run(
inputs = [foo_info, ctx.srcs[0]]
exec_group = "link",
# ...
)
実行グループを使用して実行プロパティを設定する
実行グループは
exec_properties
属性で、ターゲット書き込みで特定のルールを
実行マシンに渡されるプロパティの文字列辞書。対象
たとえば、ターゲットにメモリなどのプロパティを設定し、
メモリ割り当てが多いアクションの場合は、exec_properties
を作成します。
次のような実行グループ拡張キーでエントリを置き換えます。
# BUILD
my_rule(
name = 'my_target',
exec_properties = {
'mem': '12g',
'link.mem': '16g'
}
…
)
exec_group = "link"
を含むすべてのアクションに exec プロパティが表示される
{"mem": "16g"}
として辞書型に変換できます。ご覧のとおり、実行グループレベルの
設定はターゲット単位の設定より優先されます。
ネイティブ ルールの実行グループ
ネイティブ ルールで定義されたアクションには、次の実行グループを使用できます。
test
: テストランナーのアクション。cpp_link
: C++ リンク アクション。
実行グループとプラットフォーム実行プロパティ
次のように、任意の実行グループに対して exec_properties
を定義できます。
プラットフォーム ターゲット(ターゲットに直接設定される exec_properties
とは異なり、
不明な実行グループのプロパティは拒否されます)。その後、ターゲットは
デフォルトの実行グループに影響する実行プラットフォームの exec_properties
その他の関連する実行グループが含まれます。
たとえば、C++ テストを実行するためにリソースが必要であり、 ただし、コンパイルとリンクには必要ありません。これは次のようにモデル化できます 次のようになります。
constraint_setting(name = "resource")
constraint_value(name = "has_resource", constraint_setting = ":resource")
platform(
name = "platform_with_resource",
constraint_values = [":has_resource"],
exec_properties = {
"test.resource": "...",
},
)
cc_test(
name = "my_test",
srcs = ["my_test.cc"],
exec_compatible_with = [":has_resource"],
)
ターゲットに直接定義された exec_properties
は、ターゲットに直接定義されたものよりも優先されます。
実行プラットフォームから継承されます。