BazelCon 2024 登録の受け付けを開始しました。

このページは Cloud Translation API によって翻訳されました。

C / C++ ルール

ルール

<ph type="x-smartling-placeholder"></ph> cc_binary
<ph type="x-smartling-placeholder"></ph> cc_import
<ph type="x-smartling-placeholder"></ph> cc_library
<ph type="x-smartling-placeholder"></ph> cc_proto_library
<ph type="x-smartling-placeholder"></ph> fdo_prefetch_hints
<ph type="x-smartling-placeholder"></ph> fdo_profile
<ph type="x-smartling-placeholder"></ph> propeller_optimize
<ph type="x-smartling-placeholder"></ph> cc_test
<ph type="x-smartling-placeholder"></ph> cc_toolchain
<ph type="x-smartling-placeholder"></ph> cc_toolchain_suite

cc_binary

cc_binary(name, deps, srcs, data, additional_linker_inputs, args, compatible_with, copts, defines, deprecation, distribs, env, exec_compatible_with, exec_properties, features, includes, licenses, linkopts, linkshared, linkstatic, local_defines, malloc, nocopts, output_licenses, restricted_to, stamp, tags, target_compatible_with, testonly, toolchains, visibility, win_def_file)

暗黙的な出力ターゲット

name.stripped（明示的にリクエストされた場合にのみビルドされる）: ストリップバイナリのバージョンを指定します。バイナリに対して strip -g が実行され、デバッグが削除されます。使用できます。コマンドラインで追加のストリップオプションを指定するには、 --stripopt=-foo。この出力は、明示的にリクエストされた場合にのみビルドされます。
name.dwp（明示的にリクエストされた場合にのみビルド）: Fission が有効になっている（デバッグ）リモートにデプロイされたバイナリのデバッグに適した情報パッケージファイルです。それ以外: 空のファイルです。

引数

属性
`name`	`Name; required` このターゲットの一意の名前。
`deps`	`List of labels; optional` バイナリターゲットにリンクする他のライブラリのリスト。 `cc_library` または `objc_library` のいずれかです。できます。
`srcs`	`List of labels; optional` ターゲットを作成するために処理される C および C++ ファイルのリスト。これらは C/C++ ソースファイルとヘッダーファイルであり、未生成（通常のソース）生成されます。 `.cc`、`.c`、`.cpp` のすべてのファイルの処理ありません。これらは生成されたファイルである可能性があります。他のルール（このルール）の `outs` 自動的にその別のルールに依存することになります。 `.h` ファイルはコンパイルされませんが、このルールのソース別の追加。`.cc` と `.h` ファイルには、これらの `srcs`、またはリストされているいずれかのルールの `hdrs` `deps` 引数。 `#include`d ファイルはすべて、このルールの `srcs` 属性、または参照される `cc_library()` の `hdrs` 属性。推奨されるスタイルは、ライブラリに関連付けられているヘッダーをそのライブラリの `hdrs` 属性にリストされている他のリストと、ヘッダーのリストに、このルールのソースに関連付けられた `srcs`。「ヘッダーの包含チェック」をご覧くださいをご覧ください。ルールの名前が `srcs` にある場合は、このルールは自動的にそのルールに依存します。指定されたルールの `outs` が C または C++ の場合このルールにコンパイルされます。ライブラリファイルの場合はリンクされます。許可される `srcs` ファイル形式: C / C++ ソースファイル: `.c`、`.cc`、`.cpp` `.cxx`、`.c++`、`.C` C および C++ ヘッダーファイル: `.h`、`.hh`、`.hpp` `.hxx`、`.inc`、`.inl`、`.H` C プリプロセッサを使用するアセンブラ: `.S` アーカイブ: `.a`、`.pic.a` [常にリンクする]ライブラリ: `.lo`、`.pic.lo` バージョニングされているか、バージョニングされていない共有ライブラリ: `.so`、 `.so.version` オブジェクトファイル: `.o`、`.pic.o` ...およびそれらのファイルを生成するルール。拡張子はそれぞれ、異なるプログラミング言語を表します。 gcc の規則に従います。
`additional_linker_inputs`	`List of labels; optional` これらのファイルを C++ リンカーコマンドに渡します。たとえば、コンパイル済みの Windows .res ファイルをここで提供して、バイナリターゲットです
`copts`	`List of strings; optional` これらのオプションを C++ コンパイルコマンドに追加します。「変数を作成」による置換を適用し、 Bourne シェルのトークン化。この属性の各文字列は、指定された順序で `COPTS` より前に追加されます。バイナリターゲットをコンパイルします。フラグは、このターゲットのコンパイルに対してのみ有効で、他の場所に含まれているヘッダーファイルに注意してください。すべてのパスは現在のパッケージではなくワークスペースを基準とします。パッケージで feature が宣言されているかどうか `no_copts_tokenization`。Bourne シェルのトークン化は文字列にのみ適用されます。 1 つの「Make」コンポーネントを変数です。
`defines`	`List of strings; optional` コンパイル行に追加する定義のリスト。「メーカー」が条件変数の置換と Bourne シェルのトークン化。各文字列は 1 つの Bourne シェルトークンで構成されている必要があります。先頭に `-D` が付き、このターゲットのコンパイルコマンドラインに追加されます。関連するすべてのルールにも影響します。ただし、このケースでは影響を及ぼす可能性があります。判断に迷った場合は、 `local_defines` をご利用ください。
`includes`	`List of strings; optional` コンパイル行に追加するインクルードディレクトリのリスト。「変数を作成」による置換が適用されます。各文字列の先頭に `-isystem` が付加され、`COPTS` に追加されます。 COPTS とは異なり、以下のフラグはこのルールに追加されます。依存するすべてのルールについて学習しました。（注: コンテナが依存するルールではありません）。行動広範囲に影響が及ぶ可能性があるため、細心の注意を払ってください。判断に迷う場合は、「-I」COPTS に渡します。ヘッダーは srcs または hdrs に追加する必要があります。追加しないと、依存先コンパイルがサンドボックス化される際のルールを定義します（デフォルト）。
`linkopts`	`List of strings; optional` これらのフラグを C++ リンカーコマンドに追加します。「メーカー」が条件変数の置換、 <ph type="x-smartling-placeholder"></ph> Bourne Shell のトークン化とラベルの展開。この属性の各文字列は、前に `LINKOPTS` に追加されます。バイナリターゲットをリンクしますこのリストで、`$` または `-` で始まらない各要素は次のとおりです。 `deps` 内のターゲットのラベルとみなされます。「そのターゲットによって生成されたファイルのリストをリンカーに付加する。。ラベルが無効な場合、またはラベルが無効な場合は、エラーが報告されます。 `deps` で宣言されていません。
`linkshared`	`Boolean; optional; nonconfigurable; default is False` 共有ライブラリを作成する。この属性を有効にするには、ルールに `linkshared=True` を含めます。デフォルトオフになっています。このフラグが存在する場合は、`-shared` フラグを使用してリンクが行われます。 `gcc` に指定でき、生成される共有ライブラリは Java プログラムの例ですただし、ビルドの目的で依存関係にあるバイナリファイルが作成されます。つまり、 cc_binary ルールは他のプログラムによって手動で読み込まれるため、 cc_library の代わりとは見なされません。適用できます。スケーラビリティを確保するため、このアプローチを完全には回避し、単純に `java_library` を `cc_library` ルールに依存させるしてください。 `linkopts=['-static']` と `linkshared=True` の両方を指定すると、完全に自己完結型のユニットが得られます両方を指定すると、 `linkstatic=True` と `linkshared=True` の場合、ほとんどの場合、自己完結型のユニットです
`linkstatic`	`Boolean; optional; default is True` `cc_binary` および `cc_test`: 静的でバイナリをリンクするモードです。`cc_library.linkstatic` については、以下をご覧ください。デフォルトでは、このオプションは `cc_binary` ではオンになり、それ以外はオフになります。有効にした場合、バイナリまたはテストの場合、このオプションによりリンクするようビルドツールに指示します可能な限り、ユーザーライブラリの `.so` ではなく `.a` を使用してください。一部のシステムライブラリは、動的にリンクされる場合があります。静的ライブラリはありませんしたがって、生成される実行可能ファイルは依然としてリンクされているため、ほとんど静的のみ。実行可能ファイルをリンクする方法は 3 つあります。すべてが静的にリンクされる full_static_link 機能を持つ STATIC。例:「`gcc -static foo.o libbar.a libbaz.a -lm`」。このモードを有効にするには、`fully_static_link` を `features` 属性。 STATIC: すべてのユーザーライブラリが静的にリンクされます（静的システムライブラリ（C/C++ ランタイムライブラリを除く）動的リンク（例:「`gcc foo.o libfoo.a libbaz.a -lm`」。このモードを有効にするには、`linkstatic=True` を指定します。 DYNAMIC: すべてのライブラリが動的にリンクされる（動的なバージョンが例:「`gcc foo.o libfoo.so libbaz.so -lm`」。このモードを有効にするには、`linkstatic=False` を指定します。 `linkstatic` 属性は、 `cc_library()` ルール。 C++ ライブラリの場合、`linkstatic=True` は静的リンクが許可されているため、`.so` は生成されません。linkstatic=False は静的ライブラリの作成が妨げられることはありません。この属性は、Pod を動的ライブラリの作成 `linkstatic=False` の場合、ビルドツールは次のシンボリックリンクを作成します。依存する共有ライブラリ（`*.runfiles` 領域）
`local_defines`	`List of strings; optional` コンパイル行に追加する定義のリスト。「メーカー」が条件変数の置換と Bourne シェルのトークン化。各文字列は 1 つの Bourne シェルトークンで構成されている必要があります。先頭に `-D` が付き、このターゲットのコンパイルコマンドラインに追加されます。その依存先への影響はありません。
`malloc`	`Label; optional; default is @bazel_tools//tools/cpp:malloc` Maloc のデフォルトの依存関係をオーバーライドします。デフォルトでは、C++ バイナリは `//tools/cpp:malloc` に対してリンクされます。これは空のライブラリであるため、バイナリで libc markoc が使用されることになります。このラベルは `cc_library` を参照している必要があります。コンパイルが C++ 以外の言語の場合適用されても効果はありません。次の場合、この属性の値は無視されます。 `linkshared=True` が指定されている。
`nocopts`	`String; optional` C++ コンパイルコマンドからマッチタイプを削除します。「メーカー」が条件あります。この属性の値は、正規表現として解釈されます。この正規表現に一致する既存の `COPTS` （ルールの copts 属性に明示的に指定した値を含む）は、 `COPTS`。このルールをコンパイルします。この属性が必要になることはほとんどありません。
`stamp`	`Integer; optional; default is -1` ビルド情報をバイナリにエンコードするかどうか。可能な値: <ph type="x-smartling-placeholder"> </ph> `stamp = 1`: ビルド情報を常にバイナリにスタンプします。これは、 `--nostamp` ビルド。この設定しないでください。この設定を行うと、インスタンスのリモートキャッシュが強制終了されるバイナリとそれに依存するダウンストリームアクションが含まれます。 `stamp = 0`: ビルド情報を常に定数値に置き換えます。この適切なビルド結果キャッシュを提供します。 `stamp = -1`: ビルド情報の埋め込みは、 `--[no]stamp` フラグ。スタンプされたバイナリは、依存関係が変更されない限り再ビルドされません。
`win_def_file`	`Label; optional` リンカーに渡される Windows DEF ファイル。この属性は、ターゲットプラットフォームが Windows の場合にのみ使用してください。用途: シンボルをエクスポートする。

cc_import

cc_import(name, data, hdrs, alwayslink, compatible_with, deprecation, distribs, features, interface_library, licenses, restricted_to, shared_library, static_library, system_provided, tags, target_compatible_with, testonly, visibility)

cc_import ルールを使用すると、プリコンパイル済みの C/C++ ライブラリをインポートできます。

一般的なユースケースは次のとおりです。
1.静的ライブラリをリンクする

cc_import(
  name = "mylib",
  hdrs = ["mylib.h"],
  static_library = "libmylib.a",
  # If alwayslink is turned on,
  # libmylib.a will be forcely linked into any binary that depends on it.
  # alwayslink = 1,
)

2.共有ライブラリのリンク（Unix）

cc_import(
  name = "mylib",
  hdrs = ["mylib.h"],
  shared_library = "libmylib.so",
)

3.共有ライブラリとインターフェースライブラリのリンク（Windows）

cc_import(
  name = "mylib",
  hdrs = ["mylib.h"],
  # mylib.lib is a import library for mylib.dll which will be passed to linker
  interface_library = "mylib.lib",
  # mylib.dll will be available for runtime
  shared_library = "mylib.dll",
)

4.共有ライブラリを system_provided=True とリンクする（Windows）

cc_import(
  name = "mylib",
  hdrs = ["mylib.h"],
  # mylib.lib is an import library for mylib.dll which will be passed to linker
  interface_library = "mylib.lib",
  # mylib.dll is provided by system environment, for example it can be found in PATH.
  # This indicates that Bazel is not responsible for making mylib.dll available.
  system_provided = 1,
)

5.静的ライブラリまたは共有ライブラリ
へのリンク Unix の場合:

cc_import(
  name = "mylib",
  hdrs = ["mylib.h"],
  static_library = "libmylib.a",
  shared_library = "libmylib.so",
)

# first will link to libmylib.a
cc_binary(
  name = "first",
  srcs = ["first.cc"],
  deps = [":mylib"],
  linkstatic = 1, # default value
)

# second will link to libmylib.so
cc_binary(
  name = "second",
  srcs = ["second.cc"],
  deps = [":mylib"],
  linkstatic = 0,
)

Windows の場合:

cc_import(
  name = "mylib",
  hdrs = ["mylib.h"],
  static_library = "libmylib.lib", # A normal static library
  interface_library = "mylib.lib", # An import library for mylib.dll
  shared_library = "mylib.dll",
)

# first will link to libmylib.lib
cc_binary(
  name = "first",
  srcs = ["first.cc"],
  deps = [":mylib"],
  linkstatic = 1, # default value
)

# second will link to mylib.dll through mylib.lib
cc_binary(
  name = "second",
  srcs = ["second.cc"],
  deps = [":mylib"],
  linkstatic = 0,
)

引数

属性
`name`	`Name; required` このターゲットの一意の名前。
`hdrs`	`List of labels; optional` によってパブリッシュされたヘッダーファイルのリストこのプリコンパイルされたライブラリは、依存するルールのソースによって直接インクルードされます。
`alwayslink`	`Boolean; optional; default is False` 1 の場合、この C++ に（直接的または間接的に）依存するバイナリプリコンパイルされたライブラリは、静的ライブラリにアーカイブされているすべてのオブジェクトファイルにリンクします。バイナリで参照されるシンボルが含まれていなくてもかまいません。これは、Python のコードでコードを明示的に呼び出していない場合にバイナリを受け取るコード（たとえば、コールバックを受け取るためにコードが登録されている場合）提供します。 Windows 上の VS 2017 で alwayslink が動作しない場合は、既知の問題 VS 2017 を最新バージョンにアップグレードしてください。
`interface_library`	`Label; optional` 共有ライブラリをリンクする単一のインターフェースライブラリ。許可されるファイル形式: `.ifso`, `.tbd`, `.lib`, `.so` または `.dylib`
`shared_library`	`Label; optional` プリコンパイルされた単一の共有ライブラリ。Bazel は、アプリケーションで使用可能な依存するバイナリを作成します。許可されるファイル形式: `.so`, `.dll` または `.dylib`
`static_library`	`Label; optional` プリコンパイルされた単一の静的ライブラリ。許可されるファイル形式: `.a`, `.pic.a` または `.lib`
`system_provided`	`Boolean; optional; default is False` 1 の場合、実行時に必要な共有ライブラリがシステムによって提供されることを示します。インこの場合は、`interface_library` を指定し、 `shared_library` は空にする必要があります。

cc_library

cc_library(name, deps, srcs, data, hdrs, additional_compiler_inputs, alwayslink, compatible_with, copts, defines, deprecation, distribs, exec_compatible_with, exec_properties, features, implementation_deps, include_prefix, includes, licenses, linkopts, linkstamp, linkstatic, local_defines, nocopts, restricted_to, strip_include_prefix, tags, target_compatible_with, testonly, textual_hdrs, toolchains, visibility, win_def_file)

ヘッダー包含チェック

ビルドで使用するすべてのヘッダーファイルは、hdrs または cc_* 個中 srcs 個のルール。これは強制適用です。

cc_library ルールの場合、hdrs のヘッダーは、次の公開インターフェースで構成されます。含まれており、hdrs のファイルと、ライブラリ自体の srcs と hdrs のファイルとライブラリを deps にリストする cc_* 個のルールのうち srcs 個。 srcs のヘッダーは、hdrs のファイルから直接インクルードする必要がありますライブラリ自体の srcs。ヘッダーをモジュール内に配置するかどうかを hdrs または srcs の場合、このライブラリのコンシューマが必要かどうかを尋ねる必要があります直接含めることができますどちらの場合も、どちらの場合も、プログラミング言語での public と private の公開設定。

cc_binary ルールと cc_test ルールにはエクスポートインターフェースがないため、 hdrs 属性もありません。バイナリまたはテストに属するすべてのヘッダー srcs にリストされる必要があります。

これらのルールについて、次の例で説明します。

cc_binary(
    name = "foo",
    srcs = [
        "foo.cc",
        "foo.h",
    ],
    deps = [":bar"],
)

cc_library(
    name = "bar",
    srcs = [
        "bar.cc",
        "bar-impl.h",
    ],
    hdrs = ["bar.h"],
    deps = [":baz"],
)

cc_library(
    name = "baz",
    srcs = [
        "baz.cc",
        "baz-impl.h",
    ],
    hdrs = ["baz.h"],
)

この例で許可される直接登録は、以下の表に記載されています。たとえば foo.cc に foo.h と bar.h を直接含めることができますが、 baz.h ではありません。

ファイルをインクルードしています	許可される掲載情報
foo.h	bar.h
foo.cc	foo.h、bar.h
bar.h	bar-impl.h baz.h
bar-impl.h	bar.h baz.h
bar.cc	bar.h bar-impl.h baz.h
baz.h	baz-impl.h
baz-impl.h	baz.h
baz.cc	baz.h baz-impl.h

包含チェックルールは、追加できます上記の例では、foo.cc を使用して以下を実行できます。 bar.h（baz.h を含む）が含まれます。 baz-impl.h を含めることができます。厳密に言えば、 .cc ファイルのコンパイルには、任意のヘッダーが推移的に含まれる場合があります。ファイル内の hdrs または srcs に推移的 deps クロージャ内の cc_library。インこの場合、コンパイラは baz.h と baz-impl.h を読み取れます。 foo.cc のコンパイル時（foo.cc はコンパイル時） #include "baz.h" を含む。そのためには、許可します。baz を deps に追加する必要があります /foo。

残念ながら、Bazel は現在、直接的と推移的を区別できません。含まれていないため、ファイルに不正に直接含めることが可能です。たとえば上記の例で直接 foo.cc をしても、Bazel はエラーになりません baz.h を含む。foo のため、これは違法です。 baz には直接依存しません。現在、エラーは生成されていません。ただし、今後このようなエラーチェックが追加される可能性があります。

引数

属性
`name`	`Name; required` このターゲットの一意の名前。
`deps`	`List of labels; optional` バイナリターゲットにリンクする他のライブラリのリスト。 `cc_library` または `objc_library` のいずれかです。できます。
`srcs`	`List of labels; optional` ターゲットを作成するために処理される C および C++ ファイルのリスト。これらは C/C++ ソースファイルとヘッダーファイルであり、未生成（通常のソース）生成されます。 `.cc`、`.c`、`.cpp` のすべてのファイルの処理ありません。これらは生成されたファイルである可能性があります。他のルール（このルール）の `outs` 自動的にその別のルールに依存することになります。 `.h` ファイルはコンパイルされませんが、このルールのソース別の追加。`.cc` と `.h` ファイルには、これらの `srcs`、またはリストされているいずれかのルールの `hdrs` `deps` 引数。 `#include`d ファイルはすべて、このルールの `srcs` 属性、または参照される `cc_library()` の `hdrs` 属性。推奨されるスタイルは、ライブラリに関連付けられているヘッダーをそのライブラリの `hdrs` 属性にリストされている他のリストと、ヘッダーのリストに、このルールのソースに関連付けられた `srcs`。「ヘッダーの包含チェック」をご覧くださいをご覧ください。ルールの名前が `srcs` にある場合は、このルールは自動的にそのルールに依存します。指定されたルールの `outs` が C または C++ の場合このルールにコンパイルされます。ライブラリファイルの場合はリンクされます。許可される `srcs` ファイル形式: C / C++ ソースファイル: `.c`、`.cc`、`.cpp` `.cxx`、`.c++`、`.C` C および C++ ヘッダーファイル: `.h`、`.hh`、`.hpp` `.hxx`、`.inc`、`.inl`、`.H` C プリプロセッサを使用するアセンブラ: `.S` アーカイブ: `.a`、`.pic.a` [常にリンクする]ライブラリ: `.lo`、`.pic.lo` バージョニングされているか、バージョニングされていない共有ライブラリ: `.so`、 `.so.version` オブジェクトファイル: `.o`、`.pic.o` ...およびそれらのファイルを生成するルール。拡張子はそれぞれ、異なるプログラミング言語を表します。 gcc の規則に従います。
`hdrs`	`List of labels; optional` によってパブリッシュされたヘッダーファイルのリストこのライブラリは、依存するルールのソースによって直接インクルードされます。メタデータを格納するヘッダーファイルを宣言するには、この行をライブラリのインターフェースを記述します。これらのヘッダーはまたは依存するルールのソースごとに含めることができます。このライブラリのクライアントによってインクルードされないヘッダーは、 `srcs` 属性にリストされている（この属性がデフォルトである場合でも）含まれることがあります。詳しくは、ヘッダーの確認しています」というメッセージが表示されます。
`additional_compiler_inputs`	`List of labels; optional` コンパイラのコマンドラインに渡すその他のファイル（sanitizer など）除外することもできます。ここで指定したファイルは、gcloud の $(location) 関数を使用します。
`alwayslink`	`Boolean; optional; default is False` 1 の場合、この C++ に（直接的または間接的に）依存するバイナリリストにあるファイルのすべてのオブジェクトファイルを `srcs`。バイナリで参照されるシンボルが含まれていないものもあります。これは、Python のコードでコードを明示的に呼び出していない場合にバイナリを受け取るコード（たとえば、コールバックを受け取るためにコードが登録されている場合）提供します。 Windows 上の VS 2017 で alwayslink が動作しない場合は、既知の問題 VS 2017 を最新バージョンにアップグレードしてください。
`copts`	`List of strings; optional` これらのオプションを C++ コンパイルコマンドに追加します。「変数を作成」による置換を適用し、 Bourne シェルのトークン化。この属性の各文字列は、指定された順序で `COPTS` より前に追加されます。バイナリターゲットをコンパイルします。フラグは、このターゲットのコンパイルに対してのみ有効で、他の場所に含まれているヘッダーファイルに注意してください。すべてのパスは現在のパッケージではなくワークスペースを基準とします。パッケージで feature が宣言されているかどうか `no_copts_tokenization`。Bourne シェルのトークン化は文字列にのみ適用されます。 1 つの「Make」コンポーネントを変数です。
`defines`	`List of strings; optional` コンパイル行に追加する定義のリスト。「メーカー」が条件変数の置換と Bourne シェルのトークン化。各文字列は 1 つの Bourne シェルトークンで構成されている必要があります。先頭に `-D` が付き、このターゲットのコンパイルコマンドラインに追加されます。関連するすべてのルールにも影響します。ただし、このケースでは影響を及ぼす可能性があります。判断に迷った場合は、 `local_defines` をご利用ください。
`implementation_deps`	`List of labels; optional` ライブラリターゲットが依存する他のライブラリのリスト。他社との違い `deps`: これらのライブラリのヘッダーとインクルードパス（および推移的依存関係）は、このライブラリのコンパイルにのみ使用され、依存します。`implementation_deps` で指定されたライブラリは引き続き以下でリンクされますバイナリターゲットを作成します。現時点では、使用は cc_libraries に限定され、フラグによって保護される `--experimental_cc_implementation_deps`。
`include_prefix`	`String; optional` このルールのヘッダーのパスに追加する接頭辞。設定すると、このルールの `hdrs` 属性のヘッダーにアクセスできるようになります。 at は、リポジトリ相対パスの先頭に付加されたこの属性の値です。 `strip_include_prefix` 属性の接頭辞は、これより前に削除されます。接頭辞が追加されます。
`includes`	`List of strings; optional` コンパイル行に追加するインクルードディレクトリのリスト。「変数を作成」による置換が適用されます。各文字列の先頭に `-isystem` が付加され、`COPTS` に追加されます。 COPTS とは異なり、以下のフラグはこのルールに追加されます。依存するすべてのルールについて学習しました。（注: コンテナが依存するルールではありません）。行動広範囲に影響が及ぶ可能性があるため、細心の注意を払ってください。判断に迷う場合は、「-I」COPTS に渡します。ヘッダーは srcs または hdrs に追加する必要があります。追加しないと、依存先コンパイルがサンドボックス化される際のルールを定義します（デフォルト）。
`linkopts`	`List of strings; optional` これらのフラグを C++ リンカーコマンドに追加します。「メーカー」が条件変数の置換、 <ph type="x-smartling-placeholder"></ph> Bourne Shell のトークン化とラベルの展開。この属性の各文字列は、前に `LINKOPTS` に追加されます。バイナリターゲットをリンクしますこのリストで、`$` または `-` で始まらない各要素は次のとおりです。 `deps` 内のターゲットのラベルとみなされます。「そのターゲットによって生成されたファイルのリストをリンカーに付加する。。ラベルが無効な場合、またはラベルが無効な場合は、エラーが報告されます。 `deps` で宣言されていません。
`linkstamp`	`Label; optional` 同時に、指定された C++ ソースファイルをコンパイルして、バイナリです。これはタイムスタンプを導入するために必要です情報をバイナリに変換する。ソースコードをコンパイルしてタイムスタンプが不正確になります。リンクスタンプのコンパイルには、特定の動作しているので、特定のリソースに依存関係がヘッダー、コンパイラオプション、またはその他のビルド変数。このオプションが必要なのは、 `base` パッケージ。
`linkstatic`	`Boolean; optional; default is False` `cc_binary` および `cc_test`: 静的でバイナリをリンクするモードです。`cc_library.linkstatic` については、以下をご覧ください。デフォルトでは、このオプションは `cc_binary` ではオンになり、それ以外はオフになります。有効にした場合、バイナリまたはテストの場合、このオプションによりリンクするようビルドツールに指示します可能な限り、ユーザーライブラリの `.so` ではなく `.a` を使用してください。一部のシステムライブラリは、動的にリンクされる場合があります。静的ライブラリはありませんしたがって、生成される実行可能ファイルは依然としてリンクされているため、ほとんど静的のみ。実行可能ファイルをリンクする方法は 3 つあります。すべてが静的にリンクされる full_static_link 機能を持つ STATIC。例:「`gcc -static foo.o libbar.a libbaz.a -lm`」。このモードを有効にするには、`fully_static_link` を `features` 属性。 STATIC: すべてのユーザーライブラリが静的にリンクされます（静的システムライブラリ（C/C++ ランタイムライブラリを除く）動的リンク（例:「`gcc foo.o libfoo.a libbaz.a -lm`」。このモードを有効にするには、`linkstatic=True` を指定します。 DYNAMIC: すべてのライブラリが動的にリンクされる（動的なバージョンが例:「`gcc foo.o libfoo.so libbaz.so -lm`」。このモードを有効にするには、`linkstatic=False` を指定します。 `linkstatic` 属性は、 `cc_library()` ルール。 C++ ライブラリの場合、`linkstatic=True` は静的リンクが許可されているため、`.so` は生成されません。linkstatic=False は静的ライブラリの作成が妨げられることはありません。この属性は、Pod を動的ライブラリの作成 `linkstatic=False` の場合、ビルドツールは次のシンボリックリンクを作成します。依存する共有ライブラリ（`*.runfiles` 領域）
`local_defines`	`List of strings; optional` コンパイル行に追加する定義のリスト。「メーカー」が条件変数の置換と Bourne シェルのトークン化。各文字列は 1 つの Bourne シェルトークンで構成されている必要があります。先頭に `-D` が付き、このターゲットのコンパイルコマンドラインに追加されます。その依存先への影響はありません。
`nocopts`	`String; optional` C++ コンパイルコマンドからマッチタイプを削除します。「メーカー」が条件あります。この属性の値は、正規表現として解釈されます。この正規表現に一致する既存の `COPTS` （ルールの copts 属性に明示的に指定した値を含む）は、 `COPTS`。このルールをコンパイルします。この属性が必要になることはほとんどありません。
`strip_include_prefix`	`String; optional` このルールのヘッダーのパスから削除する接頭辞。設定すると、このルールの `hdrs` 属性のヘッダーにアクセスできるようになります。プレフィックスを切り捨てます相対パスの場合は、パッケージ相対パスと見なされます。絶対的なものである場合はリポジトリ相対パスと認識されます。 `include_prefix` 属性の接頭辞は、この接頭辞の後に追加されます。削除されます。
`textual_hdrs`	`List of labels; optional` によってパブリッシュされたヘッダーファイルのリストこのライブラリは、依存するルールのソースによってテキストとして組み込まれます。ここは、単独でコンパイルできないヘッダーファイルを宣言する場所です。つまり、他のソースファイルで常にテキスト形式でインクルードして、できます。
`win_def_file`	`Label; optional` リンカーに渡される Windows DEF ファイル。この属性は、ターゲットプラットフォームが Windows の場合にのみ使用してください。用途: シンボルをエクスポートする。

cc_proto_library

cc_proto_library(name, deps, data, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, features, licenses, restricted_to, tags, target_compatible_with, testonly, visibility)

cc_proto_library は、.proto ファイルから C++ コードを生成します。

deps は proto_library ルールを指す必要があります。

例:

cc_library(
    name = "lib",
    deps = [":foo_cc_proto"],
)

cc_proto_library(
    name = "foo_cc_proto",
    deps = [":foo_proto"],
)

proto_library(
    name = "foo_proto",
)

引数

属性

name

Name; required

このターゲットの一意の名前。

deps

List of labels; optional

proto_library のリスト必要があります。

fdo_prefetch_hints

fdo_prefetch_hints(name, compatible_with, deprecation, distribs, features, licenses, profile, restricted_to, tags, target_compatible_with, testonly, visibility)

ワークスペースまたは指定した場所にある FDO プリフェッチヒントプロファイルを表します。指定します。例:

fdo_prefetch_hints(
    name = "hints",
    profile = "//path/to/hints:profile.afdo",
)

fdo_profile(
  name = "hints_abs",
  absolute_path_profile = "/absolute/path/profile.afdo",
)

引数

属性

name

Name; required

このターゲットの一意の名前。

profile

Label; optional

ヒントのプロファイルのラベル。ヒントファイルの拡張子は .afdo ですラベルは、fdo_absolute_path_profile ルールを指すこともできます。

fdo_profile

fdo_profile(name, absolute_path_profile, compatible_with, deprecation, distribs, features, licenses, profile, proto_profile, restricted_to, tags, target_compatible_with, testonly, visibility)

ワークスペース内または指定された絶対パスにある FDO プロファイルを表します。例:

fdo_profile(
    name = "fdo",
    profile = "//path/to/fdo:profile.zip",
)

fdo_profile(
  name = "fdo_abs",
  absolute_path_profile = "/absolute/path/profile.zip",
)

引数

属性
`name`	`Name; required` このターゲットの一意の名前。
`absolute_path_profile`	`String; optional` FDO プロファイルの絶対パス。FDO ファイルの拡張子は次のいずれかになります。インデックス付けされていない LLVM プロファイルの場合は .profraw、インデックス付き LLVM プロファイルの場合は .profdata、.zip LLVM profraw プロファイル、または AutoFDO プロファイル用の .afdo を保持します。
`profile`	`Label; optional` FDO プロファイルまたはプロファイルを生成するルールのラベル。FDO ファイルには、拡張子が .profraw（インデックスなし LLVM プロファイルの場合）、.profdata（インデックス付き LLVM プロファイルの場合） LLVM profraw プロファイルを含む.zip、AutoFDO プロファイル用の.afdo、.xfdo XBinary プロファイル。ラベルは、fdo_absolute_path_profile ルールを指すこともできます。
`proto_profile`	`Label; optional` protobuf プロファイルのラベル。

propeller_optimize

propeller_optimize(name, compatible_with, deprecation, distribs, features, ld_profile, licenses, restricted_to, tags, target_compatible_with, testonly, visibility)

ワークスペース内の Propeller 最適化プロファイルを表します。例:

propeller_optimize(
    name = "layout",
    cc_profile = "//path:cc_profile.txt",
    ld_profile = "//path:ld_profile.txt"
)

propeller_optimize(
    name = "layout_absolute",
    absolute_cc_profile = "/absolute/cc_profile.txt",
    absolute_ld_profile = "/absolute/ld_profile.txt"
)

引数

属性

name

Name; required

このターゲットの一意の名前。

ld_profile

Label; optional

リンクアクションに渡されるプロフィールのラベル。このファイルの内容作成します。

cc_test

cc_test(name, deps, srcs, data, additional_linker_inputs, args, compatible_with, copts, defines, deprecation, distribs, env, env_inherit, exec_compatible_with, exec_properties, features, flaky, includes, licenses, linkopts, linkstatic, local, local_defines, malloc, nocopts, restricted_to, shard_count, size, stamp, tags, target_compatible_with, testonly, timeout, toolchains, visibility, win_def_file)

引数

属性
`name`	`Name; required` このターゲットの一意の名前。
`deps`	`List of labels; optional` バイナリターゲットにリンクする他のライブラリのリスト。 `cc_library` または `objc_library` のいずれかです。できます。
`srcs`	`List of labels; optional` ターゲットを作成するために処理される C および C++ ファイルのリスト。これらは C/C++ ソースファイルとヘッダーファイルであり、未生成（通常のソース）生成されます。 `.cc`、`.c`、`.cpp` のすべてのファイルの処理ありません。これらは生成されたファイルである可能性があります。他のルール（このルール）の `outs` 自動的にその別のルールに依存することになります。 `.h` ファイルはコンパイルされませんが、このルールのソース別の追加。`.cc` と `.h` ファイルには、これらの `srcs`、またはリストされているいずれかのルールの `hdrs` `deps` 引数。 `#include`d ファイルはすべて、このルールの `srcs` 属性、または参照される `cc_library()` の `hdrs` 属性。推奨されるスタイルは、ライブラリに関連付けられているヘッダーをそのライブラリの `hdrs` 属性にリストされている他のリストと、ヘッダーのリストに、このルールのソースに関連付けられた `srcs`。「ヘッダーの包含チェック」をご覧くださいをご覧ください。ルールの名前が `srcs` にある場合は、このルールは自動的にそのルールに依存します。指定されたルールの `outs` が C または C++ の場合このルールにコンパイルされます。ライブラリファイルの場合はリンクされます。許可される `srcs` ファイル形式: C / C++ ソースファイル: `.c`、`.cc`、`.cpp` `.cxx`、`.c++`、`.C` C および C++ ヘッダーファイル: `.h`、`.hh`、`.hpp` `.hxx`、`.inc`、`.inl`、`.H` C プリプロセッサを使用するアセンブラ: `.S` アーカイブ: `.a`、`.pic.a` [常にリンクする]ライブラリ: `.lo`、`.pic.lo` バージョニングされているか、バージョニングされていない共有ライブラリ: `.so`、 `.so.version` オブジェクトファイル: `.o`、`.pic.o` ...およびそれらのファイルを生成するルール。拡張子はそれぞれ、異なるプログラミング言語を表します。 gcc の規則に従います。
`additional_linker_inputs`	`List of labels; optional` これらのファイルを C++ リンカーコマンドに渡します。たとえば、コンパイル済みの Windows .res ファイルをここで提供して、バイナリターゲットです
`copts`	`List of strings; optional` これらのオプションを C++ コンパイルコマンドに追加します。「変数を作成」による置換を適用し、 Bourne シェルのトークン化。この属性の各文字列は、指定された順序で `COPTS` より前に追加されます。バイナリターゲットをコンパイルします。フラグは、このターゲットのコンパイルに対してのみ有効で、他の場所に含まれているヘッダーファイルに注意してください。すべてのパスは現在のパッケージではなくワークスペースを基準とします。パッケージで feature が宣言されているかどうか `no_copts_tokenization`。Bourne シェルのトークン化は文字列にのみ適用されます。 1 つの「Make」コンポーネントを変数です。
`defines`	`List of strings; optional` コンパイル行に追加する定義のリスト。「メーカー」が条件変数の置換と Bourne シェルのトークン化。各文字列は 1 つの Bourne シェルトークンで構成されている必要があります。先頭に `-D` が付き、このターゲットのコンパイルコマンドラインに追加されます。関連するすべてのルールにも影響します。ただし、このケースでは影響を及ぼす可能性があります。判断に迷った場合は、 `local_defines` をご利用ください。
`includes`	`List of strings; optional` コンパイル行に追加するインクルードディレクトリのリスト。「変数を作成」による置換が適用されます。各文字列の先頭に `-isystem` が付加され、`COPTS` に追加されます。 COPTS とは異なり、以下のフラグはこのルールに追加されます。依存するすべてのルールについて学習しました。（注: コンテナが依存するルールではありません）。行動広範囲に影響が及ぶ可能性があるため、細心の注意を払ってください。判断に迷う場合は、「-I」COPTS に渡します。ヘッダーは srcs または hdrs に追加する必要があります。追加しないと、依存先コンパイルがサンドボックス化される際のルールを定義します（デフォルト）。
`linkopts`	`List of strings; optional` これらのフラグを C++ リンカーコマンドに追加します。「メーカー」が条件変数の置換、 <ph type="x-smartling-placeholder"></ph> Bourne Shell のトークン化とラベルの展開。この属性の各文字列は、前に `LINKOPTS` に追加されます。バイナリターゲットをリンクしますこのリストで、`$` または `-` で始まらない各要素は次のとおりです。 `deps` 内のターゲットのラベルとみなされます。「そのターゲットによって生成されたファイルのリストをリンカーに付加する。。ラベルが無効な場合、またはラベルが無効な場合は、エラーが報告されます。 `deps` で宣言されていません。
`linkstatic`	`Boolean; optional; default is False` `cc_binary` および `cc_test`: 静的でバイナリをリンクするモードです。`cc_library.linkstatic` については、以下をご覧ください。デフォルトでは、このオプションは `cc_binary` ではオンになり、それ以外はオフになります。有効にした場合、バイナリまたはテストの場合、このオプションによりリンクするようビルドツールに指示します可能な限り、ユーザーライブラリの `.so` ではなく `.a` を使用してください。一部のシステムライブラリは、動的にリンクされる場合があります。静的ライブラリはありませんしたがって、生成される実行可能ファイルは依然としてリンクされているため、ほとんど静的のみ。実行可能ファイルをリンクする方法は 3 つあります。すべてが静的にリンクされる full_static_link 機能を持つ STATIC。例:「`gcc -static foo.o libbar.a libbaz.a -lm`」。このモードを有効にするには、`fully_static_link` を `features` 属性。 STATIC: すべてのユーザーライブラリが静的にリンクされます（静的システムライブラリ（C/C++ ランタイムライブラリを除く）動的リンク（例:「`gcc foo.o libfoo.a libbaz.a -lm`」。このモードを有効にするには、`linkstatic=True` を指定します。 DYNAMIC: すべてのライブラリが動的にリンクされる（動的なバージョンが例:「`gcc foo.o libfoo.so libbaz.so -lm`」。このモードを有効にするには、`linkstatic=False` を指定します。 `linkstatic` 属性は、 `cc_library()` ルール。 C++ ライブラリの場合、`linkstatic=True` は静的リンクが許可されているため、`.so` は生成されません。linkstatic=False は静的ライブラリの作成が妨げられることはありません。この属性は、Pod を動的ライブラリの作成 `linkstatic=False` の場合、ビルドツールは次のシンボリックリンクを作成します。依存する共有ライブラリ（`*.runfiles` 領域）
`local_defines`	`List of strings; optional` コンパイル行に追加する定義のリスト。「メーカー」が条件変数の置換と Bourne シェルのトークン化。各文字列は 1 つの Bourne シェルトークンで構成されている必要があります。先頭に `-D` が付き、このターゲットのコンパイルコマンドラインに追加されます。その依存先への影響はありません。
`malloc`	`Label; optional; default is @bazel_tools//tools/cpp:malloc` Maloc のデフォルトの依存関係をオーバーライドします。デフォルトでは、C++ バイナリは `//tools/cpp:malloc` に対してリンクされます。これは空のライブラリであるため、バイナリで libc markoc が使用されることになります。このラベルは `cc_library` を参照している必要があります。コンパイルが C++ 以外の言語の場合適用されても効果はありません。次の場合、この属性の値は無視されます。 `linkshared=True` が指定されている。
`nocopts`	`String; optional` C++ コンパイルコマンドからマッチタイプを削除します。「メーカー」が条件あります。この属性の値は、正規表現として解釈されます。この正規表現に一致する既存の `COPTS` （ルールの copts 属性に明示的に指定した値を含む）は、 `COPTS`。このルールをコンパイルします。この属性が必要になることはほとんどありません。
`stamp`	`Integer; optional; default is 0` ビルド情報をバイナリにエンコードするかどうか。可能な値: <ph type="x-smartling-placeholder"> </ph> `stamp = 1`: ビルド情報を常にバイナリにスタンプします。これは、 `--nostamp` ビルド。この設定しないでください。この設定を行うと、インスタンスのリモートキャッシュが強制終了されるバイナリとそれに依存するダウンストリームアクションが含まれます。 `stamp = 0`: ビルド情報を常に定数値に置き換えます。この適切なビルド結果キャッシュを提供します。 `stamp = -1`: ビルド情報の埋め込みは、 `--[no]stamp` フラグ。スタンプされたバイナリは、依存関係が変更されない限り再ビルドされません。
`win_def_file`	`Label; optional` リンカーに渡される Windows DEF ファイル。この属性は、ターゲットプラットフォームが Windows の場合にのみ使用してください。用途: シンボルをエクスポートする。

cc_toolchain

cc_toolchain(name, all_files, ar_files, as_files, compatible_with, compiler, compiler_files, compiler_files_without_includes, coverage_files, cpu, deprecation, distribs, dwp_files, dynamic_runtime_lib, exec_transition_for_inputs, features, libc_top, licenses, linker_files, module_map, objcopy_files, restricted_to, static_runtime_lib, strip_files, supports_header_parsing, supports_param_files, tags, target_compatible_with, testonly, toolchain_config, toolchain_identifier, visibility)

C++ ツールチェーンを表します。

このルールにより、以下の処理が行われます。

C++ アクションの実行に必要なすべてのアーティファクトを収集します。これは、 all_files、compiler_files、 linker_files、または _files で終わるその他の属性）。これらは必要なファイルをすべてグルーピングするファイル・グループの割合が一般的です。
C++ アクションの正しいコマンドラインの生成。これには、 CcToolchainConfigInfo プロバイダ（詳しくは下記を参照）。

toolchain_config 属性を使用して C++ ツールチェーンを構成します。関連情報 <ph type="x-smartling-placeholder"></ph> ページを参照してください。

ツールチェーンがビルドおよび構成されないようにするには、tags = ["manual"] を使用します。 bazel build //... の呼び出し時に不必要に

引数

属性
`name`	`Name; required` このターゲットの一意の名前。
`all_files`	`Label; required` すべての cc_ツールチェーンアーティファクトの収集。これらのアーティファクトは、すべてのリソースに入力として追加され、 rules_cc 関連のアクション（より正確な一連のルールを使用するアクションを除く）アーティファクト）が表示されます。Bazel は、`all_files` がスーパーセットであると想定します。他のすべてのアーティファクト提供属性（例: リンクスタンプのコンパイルには、リンクファイルを指定するため、`all_files` が必要です）。 `cc_toolchain.files` に含まれるもので、すべての Starlark で使用されます。 C++ ツールチェーンを使用したルール。
`ar_files`	`Label; optional` アーカイブアクションに必要なすべての cc_ツールチェーンアーティファクトの収集。
`as_files`	`Label; optional` アセンブリアクションに必要なすべての cc_ツールチェーンアーティファクトの収集。
`compiler`	`String; optional; nonconfigurable` 非推奨です。代わりに `toolchain_identifier` 属性を使用してください。ヌープになる以降 <ph type="x-smartling-placeholder"></ph> Starlark への CROSSTOOL の移行。削除予定: #7075。設定すると、crosstool_config.ツールチェーンでの選択に使用されます。完了までに --cpu Bazel オプションよりも優先されます。
`compiler_files`	`Label; required` コンパイルアクションに必要なすべての cc_ツールチェーンアーティファクトの収集。
`compiler_files_without_includes`	`Label; optional` 次の場合にコンパイルアクションに必要なすべての cc_ツールチェーンアーティファクトの収集入力検出がサポートされています（現在は Google のみ）。
`coverage_files`	`Label; optional` カバレッジアクションに必要なすべての cc_ツールチェーンアーティファクトの収集。指定しない場合、 all_files が使用されているからです。
`cpu`	`String; optional; nonconfigurable` 非推奨です。代わりにツールチェーン_identifier 属性を使用してください。これは、 Starlark への CROSSTOOL の移行。削除予定: #7075。設定すると、crosstool_config.ツールチェーンでの選択に使用されます。完了までに --cpu Bazel オプションよりも優先されます。
`dwp_files`	`Label; required` dwp アクションに必要なすべての cc_ツールチェーンアーティファクトの収集。
`dynamic_runtime_lib`	`Label; optional` C++ ランタイムライブラリの動的ライブラリアーティファクト（libstdc++.so など）。これは、「static_link_cpp_runtimes」の実行時に使用されます。機能が有効になっており、動的に行うことができます。
`exec_transition_for_inputs`	`Boolean; optional; default is True` True に設定すると、exec プラットフォーム用の cc_ツールチェーンへのすべてのファイル入力がビルドされます。（デフォルトではターゲットプラットフォーム）。
`libc_top`	`Label; optional` コンパイル/リンクアクションへの入力として渡される libc のアーティファクトのコレクション。
`linker_files`	`Label; required` アクションのリンクに必要なすべての cc_ツールチェーンアーティファクトの収集。
`module_map`	`Label; optional` モジュラービルドに使用されるモジュールマップアーティファクト。
`objcopy_files`	`Label; required` objcopy アクションに必要なすべての cc_ツールチェーンアーティファクトの収集。
`static_runtime_lib`	`Label; optional` C++ ランタイムライブラリの静的ライブラリアーティファクト（libstdc++.a など）。これは、「static_link_cpp_runtimes」の実行時に使用されます。機能が有効になっており、静的に行うことができます。
`strip_files`	`Label; required` 削除アクションに必要なすべての cc_ツールチェーンアーティファクトの収集。
`supports_header_parsing`	`Boolean; optional; default is False` cc_ツールチェーンがヘッダー解析アクションをサポートしている場合は、True に設定します。
`supports_param_files`	`Boolean; optional; default is True` cc_ツールチェーンがアクションのリンクにパラメータファイルの使用をサポートしている場合は、True に設定します。
`toolchain_config`	`Label; required` `cc_toolchain_config_info` を指定するルールのラベル。
`toolchain_identifier`	`String; optional; nonconfigurable` この cc_ツールチェーンと対応する対応する ID を照合する crosstool_config.toolchain. 問題 #5380 が修正されるまでこれは、`cc_toolchain` を `CROSSTOOL.toolchain`。これは `toolchain_config` に置き換えられます。属性（#5380）に追加します。

cc_toolchain_suite

cc_toolchain_suite(name, compatible_with, deprecation, distribs, features, licenses, restricted_to, tags, target_compatible_with, testonly, toolchains, visibility)

C++ ツールチェーンのコレクションを表します。

このルールにより、以下の処理が行われます。

関連するすべての C++ ツールチェーンを収集する。
--cpu オプションと --compiler オプションに応じて 1 つのツールチェーンを選択する Bazel に渡されます。

関連情報 <ph type="x-smartling-placeholder"></ph> ページを参照してください。

引数

属性

name

Name; required

このターゲットの一意の名前。

toolchains

Dictionary mapping strings to labels; required; nonconfigurable

「<cpu>」からのマップまたは "<cpu>|<compiler>"文字列を cc_toolchain ラベル。「<cpu>」--cpu のみの場合にのみ使用されます Bazel に渡され、「<cpu>|<compiler>」が使用されるのは --cpu と --compiler は Bazel に渡されます。例:

          cc_toolchain_suite(
            name = "toolchain",
            toolchains = {
              "piii|gcc": ":my_cc_toolchain_for_piii_using_gcc",
              "piii": ":my_cc_toolchain_for_piii_using_default_compiler",
            },
          )