一般的な定義

問題を報告 ソースを表示 ナイトリー · 7.4 . 7.3 · 7.2 · 7.1 · 7.0 · 6.5

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

目次

• Bourne シェルのトークン化
• ラベルの拡張
• ほとんどのビルドルールで定義される一般的な属性
• すべてのビルドルールに共通する属性
• すべてのテストルールに共通する属性（*_test）
• すべてのバイナリルールに共通の属性（*_binary）
• 構成可能な属性
• 暗黙的な出力ターゲット

Bourne シェルのトークン化

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

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

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

ラベルの拡張

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

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

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

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

属性	説明
data	ラベルのリスト。デフォルトは [] です。 実行時にこのルールで必要なファイル。ファイルまたはルールのターゲットを一覧表示できます。通常、任意のターゲットを許可します。 data 属性のターゲットのデフォルトの出力とランファイルは、このターゲットによって出力される、またはこのターゲットにランタイム依存関係がある実行可能ファイルの *.runfiles 領域に表示されます。これには、このターゲットの srcs の実行時に使用されるデータファイルやバイナリが含まれる場合があります。データファイルへの依存方法と使用方法の詳細については、データ依存関係セクションをご覧ください。 新しいルールで、実行時に他の入力を使用する可能性のある入力を処理する場合は、data 属性を定義する必要があります。ルールの実装関数は、data 属性の出力とランファイル、およびソースコードまたはランタイム依存関係を提供する依存関係属性のランファイルからターゲットのランファイルを入力する必要があります。
deps	ラベルのリスト。デフォルトは [] です。 このターゲットの依存関係。通常は、ルール ターゲットのみをリストします。（一部のルールでは、ファイルを deps に直接リストすることを許可していますが、可能であれば避けてください）。 通常、言語固有のルールでは、特定のプロバイダのターゲットのみが表示されます。 ターゲットが deps を使用して別のターゲットに依存する意味の正確なセマンティクスは、ルールの種類に固有です。ルール固有のドキュメントで詳細を確認してください。ソースコードを処理するルールの場合、deps は通常、srcs のコードで使用されるコード依存関係を指定します。 ほとんどの場合、deps 依存関係は、1 つのモジュールが同じプログラミング言語で記述され、別々にコンパイルされた別のモジュールで定義されたシンボルを使用できるようにするために使用されます。多くの場合、言語間の依存関係も許容されます。たとえば、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 キーワードを使用すると、アクションまたはテストが（ローカルまたはリモートで）キャッシュに保存されることはありません。注: このタグの目的では、ディスク キャッシュはローカル キャッシュと見なされ、HTTP キャッシュと gRPC キャッシュはリモート キャッシュと見なされます。Skyframe や永続アクション キャッシュなどの他のキャッシュには影響しません。 no-remote-cache キーワードを使用すると、アクションまたはテストはリモートでキャッシュに保存されなくなります（ただし、ローカルにキャッシュに保存される場合や、リモートで実行される場合もあります）。注: このタグの目的では、ディスク キャッシュはローカル キャッシュと見なされ、HTTP キャッシュと gRPC キャッシュはリモート キャッシュと見なされます。Skyframe や永続アクション キャッシュなどの他のキャッシュには影響しません。ローカル ディスク キャッシュとリモート キャッシュの組み合わせ（結合キャッシュ）を使用する場合、それはリモート キャッシュとして扱われ、--incompatible_remote_results_ignore_disk が設定されていない限り完全に無効になります。この場合、ローカル コンポーネントが使用されます。 no-remote-exec キーワードを使用すると、アクションまたはテストがリモートで実行されることはありません（ただし、リモートでキャッシュに保存される場合があります）。 no-remote キーワードは、アクションやテストがリモートで実行されたり、リモートでキャッシュに保存されたりしないようにします。これは、no-remote-cache と no-remote-exec の両方を使用する場合と同じです。 no-remote-cache-upload キーワードは、spawn のリモート キャッシュの一部のアップロードを無効にします。リモート実行が無効になることはありません。 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 ... から除外し、適切に構成されたプレ送信または継続的なテスト実行に含める場合があります。 external キーワードを使用すると、（--cache_test_results 値に関係なく）テストが強制的に無条件で実行されます。 テスト対象に適用されるタグの規則については、テスト エンサイクロペディアのタグの規則をご覧ください。
target_compatible_with	ラベルのリスト。デフォルトは [] です。 このターゲットが互換性があると見なされるために、ターゲット プラットフォームに存在する必要がある constraint_value のリスト。これは、ルールタイプですでに設定されている制約に加えて適用されます。ターゲット プラットフォームがリストされている制約をすべて満たしていない場合、ターゲットは互換性がないと見なされます。ターゲット パターンが展開されると（例: //...、:all）、互換性のないターゲットはビルドとテストでスキップされます。コマンドラインで明示的に指定すると、互換性のないターゲットにより Bazel でエラーが印刷され、ビルドまたはテストが失敗します。 互換性のないターゲットに間接的に依存するターゲット自体は、互換性がないものと見なされます。また、ビルドとテストでもスキップされます。 リストが空（デフォルト）の場合、ターゲットがすべてのプラットフォームと互換性があることを示します。 Workspace Rules 以外のすべてのルールがこの属性をサポートしています。一部のルールでは、この属性は効果がありません。たとえば、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:toolchain_type @bazel_tools//tools/jdk:current_java_runtime これは、プラットフォーム依存の構成のルール実装で使用されるツールチェーン解決のコンセプトとは異なります。この属性を使用して、ターゲットが使用する特定の cc_toolchain または java_toolchain を特定することはできません。
visibility	ラベルのリスト。構成不可。指定されている場合はパッケージの default_visibility、指定されていない場合は "//visibility:private" がデフォルトです。 ターゲットの visibility 属性は、そのターゲットを他のパッケージで使用できるかどうかを制御します。可視性については、ドキュメントをご覧ください。

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

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

属性	説明
args	文字列のリスト。$(location) と 「変数を作成」の置換、Bourne シェルのトークン化の対象。デフォルトは [] bazel test で実行されたときに Bazel がターゲットに渡すコマンドライン引数。 これらの引数は、bazel test コマンドラインで指定された --test_arg 値の前に渡されます。
env	文字列のディクショナリ。値は $(location) と 「変数を作成」の置換の対象となります。デフォルトは {} です。 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 属性でオーバーライドできます。タイムアウトは、個々のテストごとではなく、ビルド ターゲット内のすべてのテストに適用されます。テストがローカルで実行される場合、size はスケジューリング目的でさらに使用されます。Bazel は --local_{ram,cpu}_resources を尊重し、多くの負荷の高いテストを同時に実行してローカルマシンを圧倒しないようにします。 テストサイズは、次のデフォルトのタイムアウトと想定されるピーク時のローカル リソース使用量に対応しています。 サイズ RAM（MB） CPU（CPU コア数） デフォルトのタイムアウト 小 20 1 短い（1 分） 中 100 1 中程度（5 分） 大 300 1 長い（15 分） 膨大な 800 1 永続（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) と 「変数を作成」の置換、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 を使用して調べたりできるものです。これはターゲット Namespace です。各ファイル ターゲットはディスク上の 1 つの実際のファイル（「ファイル システム Namespace」）に対応します。各ルール ターゲットは、ディスク上の 0 個、1 個以上の実際のファイルに対応できます。ディスク上に、対応するターゲットがないファイルが存在する場合があります。たとえば、C++ コンパイル中に生成された .o オブジェクト ファイルは、BUILD ファイル内またはコマンドラインから参照できません。このように、ビルドツールは、その機能の実行方法に関する特定の実装の詳細を隠す場合があります。詳しくは、BUILD コンセプト リファレンスをご覧ください。