一般的な定義

問題を報告 ソースを表示 Nightly · 7.4 . 7.3 · 7.2 · 7.1 · 7.0 · 6.5

このセクションでは、多くの関数やビルドルールに共通するさまざまな用語とコンセプトを定義します。

目次

Bourne シェルのトークン化

一部のルールの文字列属性は、Bourne シェルのトークン化ルールに従って複数の単語に分割されます。引用符で囲まれていないスペースは個々の単語を区切り、一重引用符と二重引用符とバックスラッシュはトークン化を防ぐために使用されます。

このトークン化の対象となる属性は、このドキュメントの定義で明示的に示されています。

「Make」変数の展開と Bourne シェルのトークン化の対象となる属性は、通常、コンパイラやその他のツールに任意のオプションを渡すために使用されます。このような属性の例としては、cc_library.copts と java_library.javacopts があります。これらの置換を使用すると、単一の文字列変数を構成固有のオプションワードのリストに展開できます。

ラベルの展開

ごく一部のルールの文字列属性は、ラベル展開の対象となります。これらの文字列に //mypkg:target などの有効なラベルが部分文字列として含まれ、そのラベルが現在のルールの宣言された前提条件である場合、そのラベルは、ターゲット //mypkg:target で表されるファイルのパス名に展開されます。

属性の例には、genrule.cmd と cc_binary.linkopts があります。相対ラベルが展開されているかどうか、複数のファイルに展開されるラベルの処理方法などの問題によって、各ケースで詳細が大きく異なる場合があります。詳細については、ルール属性のドキュメントをご覧ください。

ほとんどのビルドルールで定義される一般的な属性

このセクションでは、多くのビルドルールで定義される属性について説明します（ただし、すべてではありません）。

属性 説明
data

ラベルのリスト。デフォルトは [] です。

このルールが実行時に必要とするファイル。ファイルまたはルールのターゲットをリストできます。通常、任意のターゲットを許可します。

data 属性のターゲットのデフォルトの出力とランファイルは、このターゲットによって出力される、またはこのターゲットにランタイム依存関係がある実行可能ファイルの *.runfiles 領域に表示されます。これには、このターゲットの srcs の実行時に使用されるデータファイルやバイナリが含まれる可能性があります。データファイルに依存して使用する方法については、データの依存関係のセクションをご覧ください。

新しいルールで、実行時に他の入力を使用する可能性がある入力を処理する場合は、data 属性を定義する必要があります。ルールの実装関数は、data 属性の出力とランファイル、およびソースコードまたはランタイム依存関係を提供する依存関係属性のランファイルからターゲットのランファイルを入力する必要があります。
deps

ラベルのリスト。デフォルトは [] です。

このターゲットの依存関係。通常は、ルールのターゲットのみを含めます。（一部のルールではファイルを deps に直接リストすることが認められていますが、可能な限りこれは避けてください）。

通常、言語固有のルールでは、特定のプロバイダのターゲットのみが表示されます。

ターゲットが deps を使用して別のターゲットに依存する意味の正確なセマンティクスは、ルールの種類に固有です。ルール固有のドキュメントで詳細を確認してください。ソースコードを処理するルールの場合、deps は通常、srcs のコードで使用されるコード依存関係を指定します。

ほとんどの場合、deps 依存関係は、同じプログラミング言語で記述され、個別にコンパイルされた別のモジュールで定義されたシンボルを、あるモジュールが使用できるようにするために使用されます。多くの場合、言語間の依存関係も許容されます。たとえば、java_library ターゲットは、cc_library ターゲットの C++ コードに依存する可能性があります。その場合、後者は deps 属性で指定します。詳細については、依存関係の定義をご覧ください。
licenses

文字列のリスト。構成不可。デフォルトは ["none"] です。

この特定のターゲットに使用するライセンス タイプの文字列のリスト。これは、Bazel で使用されなくなった非推奨のライセンス API の一部です。使用しないでください。
srcs

ラベルのリスト。デフォルトは [] です。

このルールによって処理または追加されたファイル。通常はファイルを直接一覧表示しますが、デフォルト出力を含めるようにルール ターゲット（filegroup や genrule など）を一覧表示することもできます。

言語固有のルールでは、リスト内のファイルに特定のファイル拡張子が必要になることがよくあります。

すべてのビルドルールに共通する属性

このセクションでは、すべてのビルドルールに暗黙的に追加される属性について説明します。

属性 説明
compatible_with

ラベルのリスト。構成不可。デフォルトは [] です。

デフォルトでサポートされている環境に加えて、このターゲットをビルドできる環境のリスト。

これは Bazel の制約システムの一部であり、ユーザーは相互に依存できるターゲットとできないターゲットを宣言できます。たとえば、外部にデプロイ可能なバイナリは、会社の秘密コードを含むライブラリに依存しないでください。詳細については、ConstraintSemantics をご覧ください。
deprecation

文字列、設定不可、デフォルトは None

このターゲットに関連付けられた説明的な警告メッセージ。通常、これは、ターゲットが廃止された、別のルールに置き換えられた、パッケージ専用である、またはなんらかの理由で有害とみなされる可能性があることをユーザーに通知するために使用されます。メッセージが表示されないようにするために必要な変更を簡単に見つけられるように、参照情報（ウェブページ、バグ番号、移行 CL の例など）を含めることをおすすめします。ドロップイン リプレイスメントとして使用できる新しいターゲットがある場合は、古いターゲットのすべてのユーザーを移行することをおすすめします。

この属性はビルド方法には影響しませんが、ビルドツールの診断出力に影響する可能性があります。deprecation 属性を持つルールが別のパッケージ内のターゲットに依存している場合、ビルドツールは警告を発行します。

パッケージ内の依存関係は、この警告の対象外です。たとえば、非推奨のルールのテストビルドで警告が発生することはありません。

非推奨のターゲットが別の非推奨のターゲットに依存している場合、警告メッセージは発行されません。

ユーザーが使用を停止したら、ターゲットを削除できます。
distribs

文字列のリスト。構成不可。デフォルトは [] です。

この特定のターゲットに使用される分散方法文字列のリスト。 これは、Bazel で使用されなくなった非推奨のライセンス API の一部です。これは使用しないでください。
exec_compatible_with

ラベルのリスト。構成不可。デフォルトは [] です。

このターゲットの実行プラットフォームに存在する必要がある constraint_values のリスト。これは、ルールタイプですでに設定されている制約に加えて適用されます。制約は、使用可能な実行プラットフォームのリストを制限するために使用されます。詳細については、ツールチェーンの解決の説明をご覧ください。
exec_properties

文字列の辞書。デフォルトは {} です。

このターゲット用に選択したプラットフォームの exec_properties に追加される文字列の辞書。platform ルールの exec_properties をご覧ください。

キーがプラットフォーム レベルとターゲット レベルのプロパティの両方に存在する場合、値はターゲットから取得されます。
features

特徴文字列のリスト。デフォルトは [] です。

特徴とは、ターゲットで有効または無効にできる文字列タグです。特徴の意味はルール自体によって異なります。

この features 属性は、パッケージ レベルの features 属性と組み合わせて使用します。たとえば、機能 ["a", "b"] がパッケージ レベルで有効になっていて、ターゲットの features 属性に ["-a", "c"] が含まれている場合、ルールで有効になる機能は「b」と「c」になります。 例をご覧ください。

restricted_to

ラベルのリスト。構成不可。デフォルトは []。

デフォルトでサポートされている環境ではなく、このターゲットを構築できる環境のリスト。

これは Bazel の制約システムの一部です。詳しくは、compatible_with をご覧ください。
tags

文字列のリスト。構成不可。デフォルトは [] です。

タグは任意のルールで使用できます。テストと test_suite ルールのタグは、テストを分類するのに役立ちます。テスト以外のターゲットのタグは、genrule と Starlark アクションのサンドボックス化された実行の制御や、人間や外部ツールによる解析に使用されます。

Bazel は、テストターゲットまたは genrule ターゲットの tags 属性、または Starlark アクションの execution_requirements のキーで次のキーワードが見つかった場合、サンドボックス コードの動作を変更します。

  • no-sandbox キーワードを使用すると、アクションまたはテストがサンドボックス化されることはありません。キャッシュに保存したりリモートで実行したりすることはできます。no-cache または no-remote を使用して、キャッシュに保存またはリモートで実行する処理のいずれかまたは両方を防ぎます。
  • no-cache キーワードでは、アクションまたはテストが（リモートまたはローカルに）キャッシュに保存されない
  • no-remote-cache キーワードを使用すると、アクションまたはテストはリモートでキャッシュに保存されなくなります（ただし、ローカルにキャッシュに保存される場合や、リモートで実行される場合もあります）。注: このタグでは、ディスク キャッシュはローカル キャッシュと見なされ、http キャッシュと gRPC キャッシュはリモート キャッシュと見なされます。ローカル ディスク キャッシュとリモート キャッシュを組み合わせて使用する場合は、リモート キャッシュとして処理され、--incompatible_remote_results_ignore_disk が設定されていなければローカル コンポーネントが使用される場合を除き、完全に無効になります。
  • no-remote-exec キーワードを使用すると、アクションまたはテストがリモートで実行されることはありません（ただし、リモートでキャッシュに保存される場合があります）。
  • no-remote キーワードを使用すると、アクションやテストがリモートで実行されたり、リモートでキャッシュに保存されたりするのを防ぐことができます。これは、no-remote-cache と no-remote-exec の両方を使用する場合と同じです。
  • no-remote-cache-upload キーワードは、スポーンのリモート キャッシュのアップロード部分を無効にします。リモート実行が無効になることはありません。
  • local キーワードを使用すると、アクションまたはテストがリモートでキャッシュに保存されたり、リモートで実行されたり、サンドボックス内で実行されたりすることはありません。genrule とテストの場合、local = True 属性でルールをマークしても同じ効果があります。
  • requires-network キーワードを使用すると、サンドボックス内から外部ネットワークにアクセスできます。このタグは、サンドボックス化が有効になっている場合にのみ効果があります。
  • block-network キーワードは、サンドボックス内から外部ネットワークへのアクセスをブロックします。この場合、localhost との通信のみが許可されます。このタグは、サンドボックスが有効な場合にのみ効果があります。
  • requires-fakeroot は、uid と gid 0（root ユーザー）としてテストまたはアクションを実行します。これは Linux でのみサポートされています。このタグは、--sandbox_fake_username コマンドライン オプションよりも優先されます。

テストのタグは、通常、デバッグ プロセスとリリース プロセスにおけるテストの役割にアノテーションを付けるために使用されます。通常、タグは、ランタイム アノテーション機能がない C++ テストと Python テストに最も役立ちます。タグとサイズ要素を使用すると、コードベースのチェックイン ポリシーに基づいてテストスイートを柔軟に作成できます。

Bazel は、テストルールの tags 属性で次のキーワードが見つかった場合、テスト実行の動作を変更します。

  • exclusive を使用すると、テストが「排他的」モードで強制的に実行され、他のテストが同時に実行されなくなります。このようなテストは、すべてのビルド アクティビティと排他的でないテストが完了した後に、連続して実行されます。Bazel はリモートマシンで実行されているものを制御できないため、このようなテストではリモート実行は無効になっています。
  • exclusive-if-local は、テストがローカルで実行される場合は強制的に「排他的」モードで実行しますが、リモートで実行される場合はテストを並行して実行します。
  • manual キーワードは、build、test、coverage コマンドに対してビルド/実行するトップレベル ターゲット セットを計算する際に、テストを明示的にリストしない、ターゲット パターンのワイルドカード（...、:*、:all など）と test_suite ルールの拡張から対象のターゲットを除外します。これは、query コマンドなど、他のコンテキストでのターゲット ワイルドカードやテストスイートの拡張には影響しません。なお、manual は、継続的なビルド/テストシステムによって自動的にターゲットのビルド/実行が行われないことを意味するものではありません。たとえば、特定の Bazel フラグを必要とするため bazel test ... からターゲットを除外し、適切に構成された presubmit または継続的なテスト実行にそのターゲットを含めることができます。
  • external キーワードを指定すると、（--cache_test_results 値に関係なく）テストが無条件に実行されます。
テスト対象に適用されるタグの規則については、テスト エンサイクロペディアのタグの規則をご覧ください。
target_compatible_with

ラベルのリスト。デフォルトは [] です。

このターゲットに互換性があるとみなされるには、ターゲット プラットフォームに存在する必要がある constraint_value のリスト。これは、ルールタイプによってすでに設定されている制約に加えて適用されます。ターゲット プラットフォームがリストされている制約をすべて満たしていない場合、ターゲットは互換性がないと見なされます。ターゲット パターンが展開されると（例: //...、:all）、互換性のないターゲットはビルドとテストでスキップされます。コマンドラインで明示的に指定すると、互換性のないターゲットにより Bazel でエラーが印刷され、ビルドまたはテストが失敗します。

互換性のないターゲットに間接的に依存するターゲット自体は、互換性がないものと見なされます。ビルドとテストでもスキップされます。

空のリスト（デフォルト）は、ターゲットがすべてのプラットフォームと互換性があることを示します。

Workspace ルール以外のすべてのルールでこの属性がサポートされます。一部のルールでは、この属性は機能しません。たとえば、cc_toolchain に target_compatible_with を指定しても意味がありません。

互換性のないターゲットのスキップの詳細については、プラットフォーム ページをご覧ください。
testonly

ブール値、設定不可。デフォルトは False（テストスイートとテストスイート ターゲットを除く）

True の場合、このターゲットに依存できるのは、testonly ターゲット（テストなど）のみです。

同様に、testonly でないルールは、testonly であるルールに依存できません。

テスト（*_test ルール）とテストスイート（test_suite ルール）はデフォルトで testonly です。

この属性は、本番環境にリリースされるバイナリにターゲットが含まれていてはならないことを意味します。

testonly は実行時ではなくビルド時に適用され、依存関係ツリーを通じて拡散されるため、これは慎重に適用する必要があります。たとえば、単体テストに役立つスタブとフェイクは、本番環境にリリースされるのと同じバイナリを含む統合テストにも役立つため、testonly とマークしないでください。逆に、リンクすることさえ危険なルール（通常の動作を無条件にオーバーライドするためなど）は、必ず testonly とマークする必要があります。
toolchains

ラベルのリスト。構成不可。デフォルトは []。

このターゲットにアクセスを許可する Make 変数を持つターゲットのセット。これらのターゲットは、TemplateVariableInfo を提供するルールのインスタンスか、Bazel に組み込まれたツールチェーン タイプの特別なターゲットです。以下に例を示します。

  • @bazel_tools//tools/cpp:current_cc_toolchain
  • @bazel_tools//tools/jdk:current_java_runtime

これは、プラットフォーム依存の構成のルール実装で使用されるツールチェーン解決のコンセプトとは異なります。この属性を使用して、ターゲットが使用する特定の cc_toolchain または java_toolchain を特定することはできません。
visibility

ラベルのリスト。構成不可。指定されている場合はパッケージの default_visibility、指定されていない場合は "//visibility:private" がデフォルトです。

ターゲットの visibility 属性は、そのターゲットを他のパッケージで使用できるかどうかを制御します。公開設定のドキュメントをご覧ください。

すべてのテストルールに共通する属性（*_test）

このセクションでは、すべてのテストルールに共通する属性について説明します。

属性 説明
args

文字列のリスト。$(location) と Make variable の置換、Bourne シェルのトークン化の対象となります。デフォルトは [] です

Bazel が bazel test で実行されたときにターゲットに渡すコマンドライン引数。

これらの引数は、bazel test コマンドラインで指定された --test_arg 値の前に渡されます。
env

文字列の辞書。値は $(location) と Make variable 置換の対象になります。デフォルトは [] です。

bazel test によってテストが実行されるときに設定する追加の環境変数を指定します。

この属性は、cc_test、py_test、sh_test などのネイティブ ルールにのみ適用されます。Starlark で定義されたテストルールには適用されません。独自の Starlark ルールの場合は、「env」属性を追加して、TestEnvironment プロバイダに入力できます。
env_inherit

文字列のリスト。デフォルトは [] です。

bazel test によってテストが実行されるときに、外部環境から継承する追加の環境変数を指定します。

この属性は、cc_test、py_test、sh_test などのネイティブ ルールにのみ適用されます。Starlark で定義されたテストルールには適用されません。
size

文字列 "enormous"、"large"、"medium"、または "small"。構成不可。デフォルトは "medium" です。

テスト対象の「負荷」: 実行に必要な時間とリソースの量を指定します。

単体テストは「小規模」、インテグレーション テストは「中規模」、エンドツーエンド テストは「大規模」または「非常に大規模」と見なされます。Bazel はこのサイズを使用してデフォルトのタイムアウトを決定します。これは timeout 属性でオーバーライドできます。タイムアウトは、個々のテストではなく、BUILD ターゲットのすべてのテストに適用されます。テストがローカルで実行される場合、size はスケジューリング目的でさらに使用されます。Bazel は --local_{ram,cpu}_resources を尊重し、多くの負荷の高いテストを同時に実行してローカルマシンを圧倒しないようにします。

テストサイズは、次のデフォルトのタイムアウトと、想定されるピーク時のローカル リソース使用量に対応しています。

サイズ RAM（MB） CPU（CPU コア数） デフォルトのタイムアウト
小 20 1 短い（1 分）
中 100 1 中程度（5 分）
大 300 1 長い（15 分）
巨大 800 1 eternal（60 分）

テストの生成時に、環境変数 TEST_SIZE がこの属性の値に設定されます。
timeout

文字列 "short"、"moderate"、"long"、または "eternal"。構成不可。デフォルトは、テストの size 属性から派生します。

結果を返すまでの想定テスト実行時間。

テストのサイズ属性はリソースの見積もりを制御しますが、テストのタイムアウトは個別に設定できます。明示的に指定しない場合、タイムアウトはテストサイズに基づきます。テストのタイムアウトは、--test_timeout フラグでオーバーライドできます。たとえば、遅いことがわかっている特定の条件下で実行する場合などです。テスト タイムアウト値は次の時間に対応しています。

タイムアウト値 期間
short 1 分
中 5 分
long 15 分
永遠 60 分

上記以外の時間では、テストのタイムアウトを --test_timeout bazel フラグでオーバーライドできます。たとえば、遅いことが判明している条件で手動で実行する場合などです。--test_timeout の値は秒単位です。たとえば、--test_timeout=120 はテストのタイムアウトを 2 分に設定します。

環境変数 TEST_TIMEOUT は、テストの生成時にテストのタイムアウト（秒単位）に設定されます。
flaky

ブール値、構成不可、デフォルトは False です

テストを不安定なものとしてマークします。

設定されている場合、テストは最大 3 回実行され、毎回失敗した場合にのみ不合格としてマークされます。デフォルトでは、この属性は False に設定されており、テストは 1 回だけ実行されます。なお、この属性の使用は、通常はおすすめしません。アサーションが維持されていれば、テストは確実に合格する必要があります。
shard_count

50 以下の正の整数。デフォルトは -1

テストの実行に使用する並列シャードの数を指定します。

設定すると、この値は、テストを実行する並列シャードの数を決定するために使用されるヒューリスティックをオーバーライドします。一部のテストルールでは、シャーディングを有効にするためにこのパラメータが必要になる場合があります。--test_sharding_strategy もご覧ください。

テスト シャーディングが有効になっている場合、テストのスポーン時に環境変数 TEST_TOTAL_SHARDS がこの値に設定されます。

シャーディングを行うには、テストランナーがテスト シャーディング プロトコルをサポートしている必要があります。そうしないと、すべてのシャードですべてのテストが実行される可能性が高くなりますが、これは望ましい動作ではありません。

シャーディングの詳細については、テスト エンサイクロペディアのテスト シャーディングをご覧ください。
local

ブール値、構成不可、デフォルトは False です

テストをサンドボックス化せずにローカルで強制的に実行します。

この値を True に設定することは、タグ（tags=["local"]）として「local」を指定することと同様です。

すべてのバイナリルールに共通する属性（*_binary）

このセクションでは、すべてのバイナリルールに共通する属性について説明します。

属性 説明
args

文字列のリスト。$(location) と "Make variable" の置換、Bourne シェルのトークン化の対象となります。設定不可。デフォルトは [] です。

run コマンドで、またはテストとして実行されたときに、Bazel がターゲットに渡すコマンドライン引数。これらの引数は、bazel run または bazel test コマンドラインで指定された引数の前に渡されます。

注: Bazel の外部でターゲットを実行する場合（bazel-bin/ でバイナリを手動で実行するなど）、引数は渡されません。

env

文字列の辞書。値は $(location) と 「変数を作成」の置換の対象となります。デフォルトは {} です。

ターゲットが bazel run によって実行されるときに設定する追加の環境変数を指定します。

この属性は、cc_binary、py_binary、sh_binary などのネイティブ ルールにのみ適用されます。Starlark で定義された実行可能ルールには適用されません。

注: Bazel の外部でターゲットを実行する場合（bazel-bin/ でバイナリを手動で実行する場合など）は、環境変数は設定されません。
output_licenses

文字列のリスト。デフォルトは [] です。

このバイナリが生成する出力ファイルのライセンス。これは、Bazel で使用されなくなった非推奨のライセンス API の一部です。これは使用しないでください。

構成可能な属性

ほとんどの属性は「構成可能」です。つまり、ターゲットがさまざまな方法でビルドされると、値が変更される可能性があります。具体的には、構成可能な属性は、Bazel コマンドラインに渡されるフラグや、ターゲットをリクエストしているダウンストリームの依存関係によって異なります。たとえば、これを使用して、複数のプラットフォームやコンパイル モードのターゲットをカスタマイズできます。

次の例では、ターゲット アーキテクチャごとに異なるソースを宣言します。bazel build :multiplatform_lib --cpu x86 を実行すると、x86_impl.cc を使用してターゲットがビルドされ、--cpu arm に置き換えると arm_impl.cc が使用されます。

cc_library(
    name = "multiplatform_lib",
    srcs = select({
        ":x86_mode": ["x86_impl.cc"],
        ":arm_mode": ["arm_impl.cc"]
    })
)
config_setting(
    name = "x86_mode",
    values = { "cpu": "x86" }
)
config_setting(
    name = "arm_mode",
    values = { "cpu": "arm" }
)

select() 関数は、ターゲットの構成がどの config_setting 条件または constraint_value 基準を満たしているかに基づいて、構成可能な属性のさまざまな代替値の中から選択します。

Bazel は、マクロの処理の後、ルールを処理する前に（厳密には、 読み込みフェーズと分析フェーズの間）構成可能な属性を評価します。select() 評価前の処理では、select() が選択するブランチを認識できません。たとえば、マクロは、選択されたブランチに基づいて動作を変更することはできません。また、bazel query は、ターゲットの構成可能な依存関係について控えめに推測することしかできません。ルールとマクロで select() を使用する方法については、よくある質問をご覧ください。

ドキュメントで nonconfigurable とマークされている属性は、この機能を使用できません。通常、属性は構成できません。これは、Bazel が select() の解決方法を決定する前に、内部でその値を知る必要があるためです。

詳細については、 構成可能なビルド属性をご覧ください。

暗黙的な出力ターゲット

C++ の暗黙的な出力は非推奨になりました。可能であれば、他の言語で使用しないでください。まだ非推奨化の予定はありませんが、最終的には非推奨となります。

BUILD ファイルでビルドルールを定義すると、パッケージに名前付きの新しいルール ターゲットを明示的に宣言します。多くのビルドルール関数は、1 つ以上の出力ファイル ターゲットを暗黙的に含みます。その内容と意味はルール固有です。たとえば、java_binary(name='foo', ...) ルールを明示的に宣言すると、出力ファイル ターゲット foo_deploy.jar を同じパッケージのメンバーとして暗黙的に宣言します。（このターゲットは、デプロイに適した自己完結型の Java アーカイブです）。

暗黙的な出力ターゲットは、グローバル ターゲット グラフの第一級メンバーです。他のターゲットと同様に、トップレベルのビルドコマンドで指定されているか、他のビルド ターゲットの前提条件として必要な場合に、オンデマンドでビルドされます。これらは、BUILD ファイルで依存関係として参照でき、bazel query などの分析ツールの出力で確認できます。

ビルドルールの種類ごとに、ルールのドキュメントに、その種類のルールの宣言に伴う暗黙的な出力の名前と内容を詳しく記載した特別なセクションがあります。

ビルドシステムで使用される 2 つの名前空間には、重要な違いがあります。ラベルはターゲットを識別します。ターゲットはルールまたはファイルのいずれかです。ファイル ターゲットは、ソース（または入力）ファイル ターゲットと派生（または出力）ファイル ターゲットに分けることができます。これらは、BUILD ファイルで指定することも、コマンドラインからビルドすることもできます。また、bazel query を使用して調べることもできます。これがターゲット名前空間です。各ファイル ターゲットは、ディスク上の 1 つの実際のファイル（「ファイル システムの名前空間」）に対応しています。各ルール ターゲットは、ディスク上の 0 個または 1 つ以上の実際のファイルに対応しています。対応するターゲットがないファイルがディスク上に存在する場合があります。たとえば、C++ コンパイル中に生成された .o オブジェクト ファイルは、BUILD ファイル内またはコマンドラインから参照できません。このように、ビルドツールは、その機能の実行方法に関する特定の実装の詳細を隠す場合があります。詳しくは、BUILD コンセプト リファレンスをご覧ください。