C / C++ ルール

ルール

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 引数。

#included ファイルはすべて、 このルールの 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_librarycc_library ルールに依存させる してください。

linkopts=['-static']linkshared=True の両方を指定すると、 完全に自己完結型のユニットが得られます両方を指定すると、 linkstatic=Truelinkshared=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_linkfeatures 属性。
  • 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

によってパブリッシュされたヘッダー ファイルのリスト このプリコンパイルされたライブラリは、依存するルールのソースによって直接インクルードされます。

Boolean; optional; default is False

1 の場合、この C++ に(直接的または間接的に)依存するバイナリ プリコンパイルされたライブラリは、静的ライブラリにアーカイブされているすべてのオブジェクト ファイルにリンクします。 バイナリで参照されるシンボルが含まれていなくてもかまいません。 これは、Python や SDK のコードで明示的に呼び出していない場合に バイナリを受け取るコード(たとえば、コールバックを受け取るためにコードが登録されている場合) 提供します。

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, 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 の場合、このライブラリのコンシューマが必要かどうかを尋ねる必要があります 直接含めることができますどちらの場合も、どちらの場合も、 プログラミング言語での publicprivate の公開設定。

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.ccfoo.hbar.h を直接含めることができますが、 baz.h ではありません。

ファイルを追加しています許可される掲載情報
foo.hbar.h
foo.ccfoo.h、bar.h
bar.hbar-impl.h baz.h
bar-impl.hbar.h baz.h
bar.ccbar.h bar-impl.h baz.h
baz.hbaz-impl.h
baz-impl.hbaz.h
baz.ccbaz.h baz-impl.h

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

#included ファイルはすべて、 このルールの 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 属性にリストされている(この属性がデフォルトである場合でも) 含まれることがあります。詳しくは、ヘッダーの 確認しています」というメッセージが表示されます。

Boolean; optional; default is False

1 の場合、この C++ に(直接的または間接的に)依存するバイナリ リストにあるファイルのすべてのオブジェクト ファイルを srcs。バイナリで参照されるシンボルが含まれていないものもあります。 これは、Java 内のコードで明示的に呼び出していない場合に バイナリを受け取るコード(たとえば、コールバックを受け取るためにコードが登録されている場合) 提供します。

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_linkfeatures 属性。
  • 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++ コードを生成します。

depsproto_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 引数。

#included ファイルはすべて、 このルールの 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_linkfeatures 属性。
  • 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_filescompiler_fileslinker_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_toolchainCROSSTOOL.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",
            },
          )