ルール
- cc_binary
- cc_import
- cc_library
- cc_proto_library
- cc_shared_library
- cc_static_library
- cc_test
- cc_toolchain
- cc_toolchain_suite
- fdo_prefetch_hints
- fdo_profile
- memprof_profile
- propeller_optimize
cc_binary
ルールのソースを表示cc_binary(name, deps, srcs, data, additional_linker_inputs, args, compatible_with, copts, defines, deprecation, distribs, dynamic_deps, env, exec_compatible_with, exec_properties, features, hdrs_check, includes, licenses, link_extra_lib, linkopts, linkshared, linkstatic, local_defines, malloc, module_interfaces, nocopts, output_licenses, reexport_deps, restricted_to, stamp, tags, target_compatible_with, testonly, toolchains, visibility, win_def_file)
実行可能なバイナリを生成します。
ターゲットの
name
は、ターゲットの名前と同じにする必要があります。
ソースファイル(拡張子を除く)。
たとえば、エントリ ポイントが main.cc
にある場合、名前は
main
にします。
暗黙的な出力ターゲット
name.stripped
(明示的にリクエストされた場合にのみビルドされる): ストリップ バイナリのバージョンを指定します。バイナリに対してstrip -g
が実行され、デバッグが削除されます。 使用できます。コマンドラインで追加のストリップ オプションを指定するには、--stripopt=-foo
。name.dwp
(明示的にリクエストされた場合にのみビルド): Fission が有効になっている(デバッグ) リモートにデプロイされたバイナリのデバッグに適した情報パッケージ ファイルです。それ以外: 空のファイルです。
引数
属性 | |
---|---|
name |
名前:必須 このターゲットの一意の名前。 |
deps
|
ラベルのリスト。デフォルトは
|
srcs
|
ラベルのリスト。デフォルトは
純粋なアセンブラ ファイル(.s、.asm)は前処理されず、通常は 渡されます。前処理されたアセンブリ ファイル(.S)は、前処理されて通常、 コンパイルする方法を紹介します。
許可される
およびそれらのファイルを生成するルール( |
data
|
ラベルのリスト。デフォルトは data に関する一般的なコメントを見る
で定義される一般的な属性は
ほとんどのビルドルールに適用されます。
C++ コードでは、次のようにしてこれらのデータファイルにアクセスできます。
|
additional_linker_inputs
|
ラベルのリスト。デフォルトは たとえば、コンパイル済みの Windows .res ファイルをここで提供して、 バイナリターゲットです |
copts
|
文字列のリスト。デフォルトは
この属性の各文字列は、指定された順序で
パッケージで feature が宣言されているかどうか
|
defines
|
文字列のリスト。デフォルトは -D が付き、このターゲットのコンパイル コマンドラインに追加されます。
関連するすべてのルールにも影響します。ただし、このケースでは
影響を及ぼす可能性があります。判断に迷った場合は、
local_defines をご利用ください。
|
dynamic_deps
|
ラベルのリスト。デフォルトは cc_shared_library 依存関係です。
|
hdrs_check
|
String;デフォルトは |
includes
|
文字列のリスト。デフォルトは -isystem path_to_package/include_entry 。
これは、kubectl の「get」コマンドや
Google の #include 文の記述形式に準拠していない。
COPTS とは異なり、以下のフラグはこのルールに追加されます。
依存するすべてのルールについて学習しました。(注: コンテナが依存するルールではありません)。行動
広範囲に影響が及ぶ可能性があるため、細心の注意を払ってください。判断に迷う場合は、
「-I」COPTS に渡します。
追加された |
link_extra_lib
|
ラベル:デフォルトは
デフォルトでは、C++ バイナリは |
linkopts
|
文字列のリスト。デフォルトは LINKOPTS に追加されます。
バイナリターゲットをリンクします
このリストで、 |
linkshared
|
ブール値デフォルトは linkshared=True を含めます。デフォルト
オフになっています。
このフラグが存在する場合は、
|
linkstatic
|
ブール値デフォルトは cc_binary および
cc_test : 静的でバイナリをリンクする
モードです。cc_library.link_static については、以下をご覧ください。
デフォルトでは、このオプションは
有効にした場合、バイナリまたはテストの場合、このオプションによりリンクするようビルドツールに指示します
可能な限り、ユーザー ライブラリの 実行可能ファイルをリンクする方法は 3 つあります。
本番環境では、 |
local_defines
|
文字列のリスト。デフォルトは -D が付き、このターゲットのコンパイル コマンドラインに追加されます。
その依存先への影響はありません。
|
malloc
|
ラベル:デフォルトは
デフォルトでは、C++ バイナリは |
module_interfaces
|
ラベルのリスト。デフォルトは C++ Standard にモジュール インターフェースのファイル拡張子に関する制限がない
使用はフラグによって保護される
|
nocopts
|
String;デフォルトは COPTS
(ルールの copts 属性に明示的に指定された値を含む)
このルールをコンパイルするために、COPTS から削除されます。
この属性は不要、または使用しないでください。
third_party の外部。値は前処理されず、
「メーカー名」以外の名前を使用します。
|
reexport_deps
|
ラベルのリスト。デフォルトは |
stamp
|
整数デフォルトは
スタンプされたバイナリは、依存関係が変更されない限り再ビルドされません。 |
win_def_file
|
ラベル:デフォルトは この属性は、ターゲット プラットフォームが Windows の場合にのみ使用してください。 用途: シンボルをエクスポートする。 |
cc_import
ルールのソースを表示cc_import(name, deps, data, hdrs, alwayslink, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, features, includes, interface_library, linkopts, objects, pic_objects, pic_static_library, restricted_to, shared_library, static_library, system_provided, tags, target_compatible_with, testonly, toolchains, 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.共有ライブラリとインターフェース ライブラリのリンク
Unix の場合:
cc_import(
name = "mylib",
hdrs = ["mylib.h"],
# libmylib.ifso is an interface library for libmylib.so which will be passed to linker
interface_library = "libmylib.ifso",
# libmylib.so will be available for runtime
shared_library = "libmylib.so",
)
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 will be available for runtime
shared_library = "mylib.dll",
)
4.共有ライブラリを system_provided=True
とリンクする
Unix の場合:
cc_import(
name = "mylib",
hdrs = ["mylib.h"],
interface_library = "libmylib.ifso", # Or we can also use libmylib.so as its own interface library
# libmylib.so is provided by system environment, for example it can be found in LD_LIBRARY_PATH.
# This indicates that Bazel is not responsible for making libmylib.so available.
system_provided = 1,
)
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",
)
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",
)
残りは Unix と Windows で同じです。
# first will link to libmylib.a (or libmylib.lib)
cc_binary(
name = "first",
srcs = ["first.cc"],
deps = [":mylib"],
linkstatic = 1, # default value
)
# second will link to libmylib.so (or libmylib.lib)
cc_binary(
name = "second",
srcs = ["second.cc"],
deps = [":mylib"],
linkstatic = 0,
)
cc_import
は include 属性をサポートしています。次に例を示します。
cc_import(
name = "curl_lib",
hdrs = glob(["vendor/curl/include/curl/*.h"]),
includes = ["vendor/curl/include"],
shared_library = "vendor/curl/lib/.libs/libcurl.dylib",
)
引数
属性 | |
---|---|
name |
名前:必須 このターゲットの一意の名前。 |
deps
|
ラベルのリスト。デフォルトは deps に関する一般的なコメントを見る
で定義される一般的な属性は
ほとんどのビルドルールに適用されます。
|
hdrs
|
ラベルのリスト。デフォルトは |
alwayslink
|
ブール値デフォルトは Windows 上の VS 2017 で alwayslink が動作しない場合は、 既知の問題 VS 2017 を最新バージョンにアップグレードしてください。 |
includes
|
文字列のリスト。デフォルトは -isystem path_to_package/include_entry 。
これは、kubectl の「get」コマンドや
Google の #include 文の記述形式に準拠していない。
COPTS とは異なり、以下のフラグはこのルールに追加されます。
依存するすべてのルールについて学習しました。(注: コンテナが依存するルールではありません)。行動
広範囲に影響が及ぶ可能性があるため、細心の注意を払ってください。判断に迷う場合は、
「-I」COPTS に渡します。
デフォルトの |
interface_library
|
ラベル:デフォルトは 許可されるファイル形式:
|
linkopts
|
文字列のリスト。デフォルトは LINKOPTS に追加されます。
バイナリターゲットをリンクします
このリストで、 |
objects
|
ラベルのリスト。デフォルトは |
pic_objects
|
ラベルのリスト。デフォルトは |
pic_static_library
|
ラベル:デフォルトは |
shared_library
|
ラベル:デフォルトは 許可されるファイル形式:
|
static_library
|
ラベル:デフォルトは 許可されるファイル形式:
|
system_provided
|
ブール値デフォルトは interface_library を指定し、
shared_library は空にする必要があります。
|
cc_library
ルールのソースを表示cc_library(name, deps, srcs, data, hdrs, additional_compiler_inputs, additional_linker_inputs, alwayslink, compatible_with, copts, defines, deprecation, distribs, exec_compatible_with, exec_properties, features, hdrs_check, implementation_deps, include_prefix, includes, licenses, linkopts, linkstamp, linkstatic, local_defines, module_interfaces, restricted_to, strip_include_prefix, tags, target_compatible_with, testonly, textual_hdrs, toolchains, visibility, win_def_file)
C++ でコンパイルされたライブラリには cc_library()
を使用します。
結果は、.so
、.lo
、
または .a
を使用します。
静的リンクを使用して
cc_library
(依存ライブラリ ルールの出力)
.a
ファイルです。「
alwayslink=True
の場合は、.lo
ファイルを取得します。
実際の出力ファイル名は libfoo.so
です。
共有ライブラリ。ここで foo はルールの名前です。「
.lo
と .a
で終わる他の種類のライブラリ
できます。特定の共有ライブラリ名が必要な場合は、
たとえば Python モジュールを定義するには、genrule を使用してライブラリを
名前を変更します。
ヘッダー包含チェック
ビルドで使用するすべてのヘッダー ファイルは、
cc_*
個のルールの hdrs
または srcs
。
これは強制適用です。
cc_library
ルールの場合、hdrs
のヘッダーは、
ライブラリのパブリック インターフェースから提供され、
ライブラリの hdrs
と srcs
のファイルから
および hdrs
と srcs
のファイルから
ライブラリを deps
にリストする cc_*
個のルール。
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 は、ツールチェーンのサポートに依存して包含チェックルールを適用します。
layering_check
機能がツールチェーンでサポートされている必要がある
たとえば
--features=layering_check
コマンドライン フラグまたは
次のメソッドの features
パラメータ:
package
関数。ツールチェーン
この機能は、Unix および macOS の clang でのみこの機能をサポートしています。
例
alwayslink
フラグを使用して、リンカーを強制的にリンクさせます。
メインバイナリコードは参照していませんが、
cc_library(
name = "ast_inspector_lib",
srcs = ["ast_inspector_lib.cc"],
hdrs = ["ast_inspector_lib.h"],
visibility = ["//visibility:public"],
deps = ["//third_party/llvm/llvm/tools/clang:frontend"],
# alwayslink as we want to be able to call things in this library at
# debug time, even if they aren't used anywhere in the code.
alwayslink = 1,
)
次の例は
third_party/python2_4_3/BUILD
。
コードの一部では、dl
ライブラリを使用して(
別の動的ライブラリなど)が
ルールで -ldl
リンク オプションを指定し、
dl
ライブラリ:
cc_library(
name = "python2_4_3",
linkopts = [
"-ldl",
"-lutil",
],
deps = ["//third_party/expat"],
)
次の例は、third_party/kde/BUILD
から取得されます。
ビルド済みの .so
ファイルはデポに保持されています。
ヘッダー ファイルは include
という名前のサブディレクトリにあります。
cc_library(
name = "kde",
srcs = [
"lib/libDCOP.so",
"lib/libkdesu.so",
"lib/libkhtml.so",
"lib/libkparts.so",
...more .so files...,
],
includes = ["include"],
deps = ["//third_party/X11"],
)
次の例は、third_party/gles/BUILD
から取得されます。
サードパーティのコードに defines
と
linkopts
。
cc_library(
name = "gles",
srcs = [
"GLES/egl.h",
"GLES/gl.h",
"ddx.c",
"egl.c",
],
defines = [
"USE_FLOAT",
"__GL_FLOAT",
"__GL_COMMON",
],
linkopts = ["-ldl"], # uses dlopen(), dl library
deps = [
"es",
"//third_party/X11",
],
)
引数
属性 | |
---|---|
name |
名前:必須 このターゲットの一意の名前。 |
deps
|
ラベルのリスト。デフォルトは
C++ ライブラリ ルールの名前にする必要があります。
このルールのライブラリをリンクするバイナリをビルドすると、
「deps」はこのライブラリのすべてのクライアントが含まれているわけではありません。
ここにあります。ランタイム データの依存関係は プリコンパイル済みのサードパーティ ライブラリでリンクするには、その名前を
このライブラリにリンクせずに何かに依存するには、そのライブラリを
|
srcs
|
ラベルのリスト。デフォルトは
純粋なアセンブラ ファイル(.s、.asm)は前処理されず、通常は 渡されます。前処理されたアセンブリ ファイル(.S)は、前処理されて通常、 コンパイルする方法を紹介します。
許可される
およびそれらのファイルを生成するルール( |
data
|
ラベルのリスト。デフォルトは data に関する一般的なコメントを見る
で定義される一般的な属性は
ほとんどのビルドルールに適用されます。
C++ コードでは、次のようにしてこれらのデータファイルにアクセスできます。
|
hdrs
|
ラベルのリスト。デフォルトは メタデータを格納するヘッダー ファイルを宣言するには、この行を
ライブラリのインターフェースを記述します。これらのヘッダーは
または依存するルールのソースごとに含めることができます。
このライブラリのクライアントによってインクルードされないヘッダーは、
許可される |
additional_compiler_inputs
|
ラベルのリスト。デフォルトは |
additional_linker_inputs
|
ラベルのリスト。デフォルトは たとえば、コンパイル済みの Windows .res ファイルをここで提供して、 バイナリターゲットです |
alwayslink
|
ブール値デフォルトは srcs 。バイナリで参照されるシンボルが含まれていないものもあります。
これは、Python のコードでコードを明示的に呼び出していない場合に
バイナリを受け取るコード(たとえば、コールバックを受け取るためにコードが登録されている場合)
提供します。
Windows 上の VS 2017 で alwayslink が動作しない場合は、 既知の問題 VS 2017 を最新バージョンにアップグレードしてください。 |
copts
|
文字列のリスト。デフォルトは
この属性の各文字列は、指定された順序で
パッケージで feature が宣言されているかどうか
|
defines
|
文字列のリスト。デフォルトは -D が付き、このターゲットのコンパイル コマンドラインに追加されます。
関連するすべてのルールにも影響します。ただし、このケースでは
影響を及ぼす可能性があります。判断に迷った場合は、
local_defines をご利用ください。
|
hdrs_check
|
String;デフォルトは |
implementation_deps
|
ラベルのリスト。デフォルトは deps : これらのライブラリのヘッダーとインクルード パス(および
推移的依存関係)は、このライブラリのコンパイルにのみ使用され、
依存します。implementation_deps で指定されたライブラリは引き続き以下でリンクされます
バイナリ ターゲットを作成します。
現時点では、使用は cc_libraries に限定され、フラグによって保護される
|
include_prefix
|
String;デフォルトは 設定すると、このルールの
この属性は |
includes
|
文字列のリスト。デフォルトは -isystem path_to_package/include_entry 。
これは、kubectl の「get」コマンドや
Google の #include 文の記述形式に準拠していない。
COPTS とは異なり、以下のフラグはこのルールに追加されます。
依存するすべてのルールについて学習しました。(注: コンテナが依存するルールではありません)。行動
広範囲に影響が及ぶ可能性があるため、細心の注意を払ってください。判断に迷う場合は、
「-I」COPTS に渡します。
追加された |
linkopts
|
文字列のリスト。デフォルトは cc_binary.linkopts をご覧ください。
linkopts 属性は、
deps を介して、このライブラリに直接的または間接的に依存する
属性(または同様に扱われる他の属性:
malloc
cc_binary の属性です)。依存関係
linkopt は依存 linkopts より優先されます(依存関係 linkopts)。
コマンドラインの後半で指定する必要があります)。で指定される linkopt
--linkopt
優先されます。
なお、 また、「-Wl,-soname」はまたは「-Xlinker -soname」 オプションはサポートされていません。また、この属性には決して指定しないでください。 |
linkstamp
|
ラベル:デフォルトは base パッケージ。
|
linkstatic
|
ブール値デフォルトは cc_binary および
cc_test : 静的でバイナリをリンクする
モードです。cc_library.link_static については、以下をご覧ください。
デフォルトでは、このオプションは
有効にした場合、バイナリまたはテストの場合、このオプションによりリンクするようビルドツールに指示します
可能な限り、ユーザー ライブラリの 実行可能ファイルをリンクする方法は 3 つあります。
本番環境では、 |
local_defines
|
文字列のリスト。デフォルトは -D が付き、このターゲットのコンパイル コマンドラインに追加されます。
その依存先への影響はありません。
|
module_interfaces
|
ラベルのリスト。デフォルトは C++ Standard にモジュール インターフェースのファイル拡張子に関する制限がない
使用はフラグによって保護される
|
strip_include_prefix
|
String;デフォルトは 設定すると、このルールの 相対パスの場合は、パッケージ相対パスと見なされます。絶対的なものである場合は リポジトリ相対パスと認識されます。
この属性は |
textual_hdrs
|
ラベルのリスト。デフォルトは ここは、単独でコンパイルできないヘッダー ファイルを宣言する場所です。 つまり、他のソースファイルで常にテキスト形式でインクルードして、 できます。 |
win_def_file
|
ラベル:デフォルトは この属性は、ターゲット プラットフォームが Windows の場合にのみ使用してください。 用途: シンボルをエクスポートする。 |
cc_proto_library
ルールのソースを表示cc_proto_library(name, deps, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, features, restricted_to, tags, target_compatible_with, testonly, toolchains, 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 |
名前:必須 このターゲットの一意の名前。 |
deps
|
ラベルのリスト。デフォルトは proto_library のリスト
必要があります。
|
cc_shared_library
ルールのソースを表示cc_shared_library(name, deps, additional_linker_inputs, compatible_with, deprecation, distribs, dynamic_deps, exec_compatible_with, exec_properties, experimental_disable_topo_sort_do_not_use_remove_before_7_0, exports_filter, features, restricted_to, roots, shared_lib_name, static_deps, tags, target_compatible_with, testonly, toolchains, user_link_flags, visibility, win_def_file)
共有ライブラリを生成します。
例
cc_shared_library( name = "foo_shared", deps = [ ":foo", ], dynamic_deps = [ ":bar_shared", ], additional_linker_inputs = [ ":foo.lds", ], user_link_flags = [ "-Wl,--version-script=$(location :foo.lds)", ], ) cc_library( name = "foo", srcs = ["foo.cc"], hdrs = ["foo.h"], deps = [ ":bar", ":baz", ], ) cc_shared_library( name = "bar_shared", shared_lib_name = "bar.so", deps = [":bar"], ) cc_library( name = "bar", srcs = ["bar.cc"], hdrs = ["bar.h"], ) cc_library( name = "baz", srcs = ["baz.cc"], hdrs = ["baz.h"], )
例では、foo_shared
が foo
を静的にリンクしています。
baz
があり、後者は推移的依存関係です。いいえ
リンク bar
は、
dynamic_dep
得点 bar_shared
ウィケット。
foo_shared
はリンカー スクリプトの *.lds ファイルを使用して、
シンボルをエクスポートする必要があります。cc_shared_library
ルールのロジックでは、
エクスポートされるシンボルを制御せず、
2 つの共有ライブラリがエクスポートされると、分析フェーズでエラーが発生します。
同じターゲットです
cc_shared_library
の直接的な依存関係はすべて次のように想定されます。
エクスポートされます。そのため、Bazel は、分析中に foo
が実行中であると想定します。
foo_shared
によってエクスポートされました。baz
のエクスポートは想定されていません
作成者: foo_shared
。exports_filter
によって一致したすべてのターゲット
エクスポートされることが想定されています。
この例のすべての cc_library
は、最大で 1 つの場所に含まれます。
cc_shared_library
。baz
を次のリンクにもリンクする場合、
bar_shared
を追加する必要があります
tags = ["LINKABLE_MORE_THAN_ONCE"]
から baz
に変更。
shared_lib_name
属性により、ファイルによって
bar_shared
の名前は bar.so
になります。
これは、Linux ではデフォルトで libbar.so
という名前になります。
エラー
Two shared libraries in dependencies export the same symbols.
これは、異なる 2 つの VM でターゲットを作成するときに
同じターゲットをエクスポートする cc_shared_library
依存関係。この問題を解決するには
いずれかでライブラリのエクスポートを停止する必要があります。
cc_shared_library
依存関係。
Two shared libraries in dependencies link the same library statically
これは、新しい cc_shared_library
を 2 つの
同じターゲットを静的にリンクする、異なる cc_shared_library
依存関係。
エクスポートのエラーに似ています。
これを解決する方法の一つは、ライブラリを
cc_shared_library
依存関係。同時に、リンクしているサーバーは
ライブラリをエクスポートして、リンクされていないライブラリが参照できるようにする必要がある
あります。もう 1 つの方法は、ターゲットをエクスポートする 3 つ目のライブラリを抽出することです。
3 つ目の方法は、犯人の cc_library
に LINKABLE_MORE_THAN_ONCE
をタグ付けすることです。
ただし、この修正はまれであるため、
cc_library
は複数回リンクしても問題ありません。
'//foo:foo' is already linked statically in '//bar:bar' but not exported`
これは、deps
の推移的クロージャ内のライブラリにアクセスできることを意味します
依存関係が存在せず、すでに cc_shared_library
依存関係を
dynamic_deps
の別の cc_shared_library
にリンクされており、
エクスポートされます。
この問題を解決するには、cc_shared_library
依存関係からエクスポートするか、pull します。
それをエクスポートする 3 つ目の cc_shared_library
。
Do not place libraries which only contain a precompiled dynamic library in deps.
プリコンパイルされた動的ライブラリがある場合、その必要はありません。また、実行できません。
現在の cc_shared_library
ターゲットに静的にリンクされる
表示されます。したがって、これは次の deps
には属しません。
cc_shared_library
。このプリコンパイルされた動的ライブラリが
cc_libraries
の場合、cc_library
はそれに依存する必要があります。
直接渡されます。
Trying to export a library already exported by a different shared library
このエラーは、現在のルールで すでにエクスポートされているターゲット リソースが含まれます。
この問題を解決するには、deps
からターゲットを削除し、ダイナミック アカウントからターゲットを使用します。
exports_filter
がこのターゲットをキャッチしないようにする必要があります。
引数
属性 | |
---|---|
name |
名前:必須 このターゲットの一意の名前。 |
deps
|
ラベルのリスト。デフォルトは
これらの直接依存関係の推移的ライブラリ依存関係は、この共有ライブラリにリンクされます。
ただし、
分析の際、ルールの実装では、
次の場合にエラーが発生するため、共有ライブラリによってエクスポートされているものとして
また、同じライブラリが静的にリンクされている場合は、実装によってエラーがトリガーされます。
複数の |
additional_linker_inputs
|
ラベルのリスト。デフォルトは user_link_flags 属性で指定できます。
|
dynamic_deps
|
ラベルのリスト。デフォルトは cc_shared_library 依存関係です。
|
experimental_disable_topo_sort_do_not_use_remove_before_7_0
|
ブール値デフォルトは |
exports_filter
|
文字列のリスト。デフォルトは
ターゲット
この属性は、実際にはこれらのターゲットに依存関係のエッジを追加するものではなく、
代わりに 使用できる構文は次のとおりです。
|
roots
|
ラベルのリスト。デフォルトは |
shared_lib_name
|
String;デフォルトは |
static_deps
|
文字列のリスト。デフォルトは |
user_link_flags
|
文字列のリスト。デフォルトは
|
win_def_file
|
ラベル:デフォルトは この属性は、ターゲット プラットフォームが Windows の場合にのみ使用してください。 用途: シンボルをエクスポートする。 |
cc_static_library
ルールのソースを表示cc_static_library(name, deps, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, features, restricted_to, tags, target_compatible_with, testonly, toolchains, visibility)ターゲットとそれらの推移的依存関係のリストから静的ライブラリを生成します。
生成される静的ライブラリには、リストに示されたターゲットのオブジェクト ファイルが含まれます。
deps
とその推移的依存関係(優先されるもの)
PIC
オブジェクト。
出力グループ
linkdeps
リストにあるターゲットの推移的依存関係のラベルを含むテキスト ファイル
deps
: 静的ライブラリにオブジェクト ファイルを提供しなかったが、提供する
静的ライブラリ、動的ライブラリ、またはインターフェース ライブラリを少なくとも 1 つ提供する。生成される静的ライブラリ
リンク時にこれらのライブラリが利用可能であることが求められる場合があります。
linkopts
ユーザーが指定したすべての推移的 linkopts
を含むテキスト ファイル
deps
にリストされているターゲットの依存関係。
記号が重複しています
デフォルトでは、cc_static_library
ルールは生成された静的
ライブラリに重複するシンボルが含まれていない。存在する場合、ビルドはエラーで失敗します。
というメッセージが返されます。
このチェックは、ターゲットごと、またはパッケージごとに無効にできます。
features = ["-symbol_check"]
またはグローバルに以下を使用:
--features=-symbol_check
。
symbol_check
のツールチェーン サポート
Bazel に付属の自動構成 C++ ツールチェーンは、
すべてのプラットフォーム上の symbol_check
機能。カスタム ツールチェーンでは、
次の 2 つの方法があります。
ACTION_NAMES.validate_static_library
アクションの実装とsymbol_check
機能を使用して有効にします。アクションで使用するツールセットは、 2 つの引数で呼び出されます。1 つは重複シンボルをチェックする静的ライブラリ、 チェックに合格した場合に作成する必要のあるファイルのパスです。symbol_check
機能にアーカイバ フラグが追加され、 静的ライブラリを作成するアクションは、シンボルが重複している場合に失敗します。
引数
属性 | |
---|---|
name |
名前:必須 このターゲットの一意の名前。 |
deps
|
ラベルのリスト。デフォルトは オブジェクト ファイルを提供しない依存関係は、
ただし、そのラベルは
|
cc_test
ルールのソースを表示cc_test(name, deps, srcs, data, additional_linker_inputs, args, compatible_with, copts, defines, deprecation, distribs, dynamic_deps, env, env_inherit, exec_compatible_with, exec_properties, features, flaky, hdrs_check, includes, licenses, link_extra_lib, linkopts, linkshared, linkstatic, local, local_defines, malloc, module_interfaces, nocopts, reexport_deps, restricted_to, shard_count, size, stamp, tags, target_compatible_with, testonly, timeout, toolchains, visibility, win_def_file)
cc_test()
ルールはテストをコンパイルします。ここでテスト
いくつかのテストコードのバイナリラッパーです。
デフォルトでは、C++ テストは動的にリンクされます。
単体テストを静的にリンクするには、
linkstatic=True
。
テストが必要な理由をコメントすると
linkstatic
、これはおそらく明らかではありません。
暗黙的な出力ターゲット
name.stripped
(明示的にリクエストされた場合にのみビルドされる): ストリップ バイナリのバージョンを指定します。バイナリに対してstrip -g
が実行され、デバッグが削除されます。 使用できます。コマンドラインで追加のストリップ オプションを指定するには、--stripopt=-foo
。name.dwp
(明示的にリクエストされた場合にのみビルド): Fission が有効になっている(デバッグ) リモートにデプロイされたバイナリのデバッグに適した情報パッケージ ファイルです。それ以外: 空のファイルです。
cc_binary() の引数をご覧ください。ただし、
テストでは stamp
引数はデフォルトで 0 に設定され、
cc_test
に余分な が含まれている
すべてのテストルールに共通する属性(*_test)。
引数
属性 | |
---|---|
name |
名前:必須 このターゲットの一意の名前。 |
deps
|
ラベルのリスト。デフォルトは
|
srcs
|
ラベルのリスト。デフォルトは
純粋なアセンブラ ファイル(.s、.asm)は前処理されず、通常は 渡されます。前処理されたアセンブリ ファイル(.S)は、前処理されて通常、 コンパイルする方法を紹介します。
許可される
およびそれらのファイルを生成するルール( |
data
|
ラベルのリスト。デフォルトは data に関する一般的なコメントを見る
で定義される一般的な属性は
ほとんどのビルドルールに適用されます。
C++ コードでは、次のようにしてこれらのデータファイルにアクセスできます。
|
additional_linker_inputs
|
ラベルのリスト。デフォルトは たとえば、コンパイル済みの Windows .res ファイルをここで提供して、 バイナリターゲットです |
copts
|
文字列のリスト。デフォルトは
この属性の各文字列は、指定された順序で
パッケージで feature が宣言されているかどうか
|
defines
|
文字列のリスト。デフォルトは -D が付き、このターゲットのコンパイル コマンドラインに追加されます。
関連するすべてのルールにも影響します。ただし、このケースでは
影響を及ぼす可能性があります。判断に迷った場合は、
local_defines をご利用ください。
|
dynamic_deps
|
ラベルのリスト。デフォルトは cc_shared_library 依存関係です。
|
hdrs_check
|
String;デフォルトは |
includes
|
文字列のリスト。デフォルトは -isystem path_to_package/include_entry 。
これは、kubectl の「get」コマンドや
Google の #include 文の記述形式に準拠していない。
COPTS とは異なり、以下のフラグはこのルールに追加されます。
依存するすべてのルールについて学習しました。(注: コンテナが依存するルールではありません)。行動
広範囲に影響が及ぶ可能性があるため、細心の注意を払ってください。判断に迷う場合は、
「-I」COPTS に渡します。
追加された |
link_extra_lib
|
ラベル:デフォルトは
デフォルトでは、C++ バイナリは |
linkopts
|
文字列のリスト。デフォルトは LINKOPTS に追加されます。
バイナリターゲットをリンクします
このリストで、 |
linkshared
|
ブール値デフォルトは linkshared=True を含めます。デフォルト
オフになっています。
このフラグが存在する場合は、
|
linkstatic
|
ブール値デフォルトは cc_binary および
cc_test : 静的でバイナリをリンクする
モードです。cc_library.link_static については、以下をご覧ください。
デフォルトでは、このオプションは
有効にした場合、バイナリまたはテストの場合、このオプションによりリンクするようビルドツールに指示します
可能な限り、ユーザー ライブラリの 実行可能ファイルをリンクする方法は 3 つあります。
本番環境では、 |
local_defines
|
文字列のリスト。デフォルトは -D が付き、このターゲットのコンパイル コマンドラインに追加されます。
その依存先への影響はありません。
|
malloc
|
ラベル:デフォルトは
デフォルトでは、C++ バイナリは |
module_interfaces
|
ラベルのリスト。デフォルトは C++ Standard にモジュール インターフェースのファイル拡張子に関する制限がない
使用はフラグによって保護される
|
nocopts
|
String;デフォルトは COPTS
(ルールの copts 属性に明示的に指定された値を含む)
このルールをコンパイルするために、COPTS から削除されます。
この属性は不要、または使用しないでください。
third_party の外部。値は前処理されず、
「メーカー名」以外の名前を使用します。
|
reexport_deps
|
ラベルのリスト。デフォルトは |
stamp
|
整数デフォルトは
スタンプされたバイナリは、依存関係が変更されない限り再ビルドされません。 |
win_def_file
|
ラベル:デフォルトは この属性は、ターゲット プラットフォームが Windows の場合にのみ使用してください。 用途: シンボルをエクスポートする。 |
cc_toolchain
ルールのソースを表示cc_toolchain(name, all_files, ar_files, as_files, compatible_with, compiler_files, compiler_files_without_includes, coverage_files, deprecation, distribs, dwp_files, dynamic_runtime_lib, exec_compatible_with, exec_properties, exec_transition_for_inputs, features, libc_top, licenses, linker_files, module_map, objcopy_files, output_licenses, restricted_to, static_runtime_lib, strip_files, supports_header_parsing, supports_param_files, tags, target_compatible_with, testonly, toolchain_config, toolchain_identifier, toolchains, visibility)
C++ ツールチェーンを表します。
このルールにより、以下の処理が行われます。
-
C++ アクションの実行に必要なすべてのアーティファクトを収集します。これは、
all_files
、compiler_files
、linker_files
、または_files
で終わるその他の属性)。これらは 必要なファイルをすべてグルーピングするファイル・グループの割合が一般的です。 -
C++ アクションの正しいコマンドラインの生成。これには、
CcToolchainConfigInfo
プロバイダ(詳しくは下記を参照)。
toolchain_config
属性を使用して C++ ツールチェーンを構成します。
関連情報
ページ
を参照してください。
ツールチェーンがビルドおよび構成されないようにするには、tags = ["manual"]
を使用します。
bazel build //...
の呼び出し時に不必要に
引数
属性 | |
---|---|
name |
名前:必須 このターゲットの一意の名前。 |
all_files
|
ラベル:必須 すべての cc_ツールチェーン アーティファクトの収集。これらのアーティファクトは、すべてのリソースに入力として追加され、 rules_cc 関連のアクション(より正確な一連のルールを使用するアクションを除く) アーティファクト)が表示されます。Bazel は、all_files がスーパーセットであると想定します。
他のすべてのアーティファクト提供属性(例: リンクスタンプのコンパイルには、
リンクファイルを指定するため、all_files が必要です)。
|
ar_files
|
ラベル:デフォルトは |
as_files
|
ラベル:デフォルトは |
compiler_files
|
ラベル:必須 コンパイル アクションに必要なすべての cc_ツールチェーン アーティファクトの収集。 |
compiler_files_without_includes
|
ラベル:デフォルトは |
coverage_files
|
ラベル:デフォルトは |
dwp_files
|
ラベル:必須 dwp アクションに必要なすべての cc_ツールチェーン アーティファクトの収集。 |
dynamic_runtime_lib
|
ラベル:デフォルトは これは、「static_link_cpp_runtimes」の実行時に使用されます。機能が有効になっており、 動的に行うことができます。 |
exec_transition_for_inputs
|
ブール値デフォルトは |
libc_top
|
ラベル:デフォルトは |
linker_files
|
ラベル:必須 アクションのリンクに必要なすべての cc_ツールチェーン アーティファクトの収集。 |
module_map
|
ラベル:デフォルトは |
objcopy_files
|
ラベル:必須 objcopy アクションに必要なすべての cc_ツールチェーン アーティファクトの収集。 |
output_licenses
|
文字列のリスト。デフォルトは |
static_runtime_lib
|
ラベル:デフォルトは これは、「static_link_cpp_runtimes」の実行時に使用されます。機能が有効になっており、 静的に行うことができます。 |
strip_files
|
ラベル:必須 削除アクションに必要なすべての cc_ツールチェーン アーティファクトの収集。 |
supports_header_parsing
|
ブール値デフォルトは |
supports_param_files
|
ブール値デフォルトは |
toolchain_config
|
ラベル:必須 cc_toolchain_config_info を指定するルールのラベル。
|
toolchain_identifier
|
String;デフォルトは
問題 #5380 が修正されるまで
これは、 |
cc_toolchain_suite
ルールのソースを表示cc_toolchain_suite(name, compatible_with, deprecation, distribs, features, licenses, restricted_to, tags, target_compatible_with, testonly, toolchains, visibility)
非推奨: このルールは何も行われず、削除されます。
引数
属性 | |
---|---|
name |
名前:必須 このターゲットの一意の名前。 |
fdo_prefetch_hints
ルールのソースを表示fdo_prefetch_hints(name, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, features, profile, restricted_to, tags, target_compatible_with, testonly, toolchains, visibility)
ワークスペースのどちらかにある FDO プリフェッチヒントのプロファイルを表します。 例:
fdo_prefetch_hints(
name = "hints",
profile = "//path/to/hints:profile.afdo",
)
引数
属性 | |
---|---|
name |
名前:必須 このターゲットの一意の名前。 |
profile
|
ラベル:必須 ヒントのプロファイルのラベル。ヒントファイルの拡張子は .afdo です ラベルは、fdo_absolute_path_profile ルールを指すこともできます。 |
fdo_profile
ルールのソースを表示fdo_profile(name, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, features, memprof_profile, profile, proto_profile, restricted_to, tags, target_compatible_with, testonly, toolchains, visibility)
ワークスペース内にある FDO プロファイルを表します。 例:
fdo_profile(
name = "fdo",
profile = "//path/to/fdo:profile.zip",
)
引数
属性 | |
---|---|
name |
名前:必須 このターゲットの一意の名前。 |
memprof_profile
|
ラベル:デフォルトは |
profile
|
ラベル:必須 FDO プロファイルまたはプロファイルを生成するルールのラベル。FDO ファイルには、 拡張子が .profraw(インデックスなし LLVM プロファイルの場合)、.profdata(インデックス付き LLVM プロファイルの場合) LLVM profraw プロファイルを含む.zip、AutoFDO プロファイル用の.afdo、.xfdo XBinary プロファイル。ラベルは、fdo_absolute_path_profile ルールを指すこともできます。 |
proto_profile
|
ラベル:デフォルトは |
memprof_profile
ルールのソースを表示memprof_profile(name, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, features, profile, restricted_to, tags, target_compatible_with, testonly, toolchains, visibility)
ワークスペース内にある MEMPROF プロファイルを表します。 例:
memprof_profile(
name = "memprof",
profile = "//path/to/memprof:profile.afdo",
)
引数
属性 | |
---|---|
name |
名前:必須 このターゲットの一意の名前。 |
profile
|
ラベル:必須 MEMPROF プロファイルのラベル。プロファイルには以下が必要です。 拡張子が .profdata である(インデックス付き/シンボル化された memprof の場合) または、memprof .profdata を含む zip ファイルの.zip 拡張子が必要です。 表示されます。 ラベルは、fdo_absolute_path_profile ルールを指すこともできます。 |
propeller_optimize
ルールのソースを表示propeller_optimize(name, cc_profile, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, features, ld_profile, restricted_to, tags, target_compatible_with, testonly, toolchains, visibility)
ワークスペース内の Propeller 最適化プロファイルを表します。 例:
propeller_optimize(
name = "layout",
cc_profile = "//path:cc_profile.txt",
ld_profile = "//path:ld_profile.txt"
)
引数
属性 | |
---|---|
name |
名前:必須 このターゲットの一意の名前。 |
cc_profile
|
ラベル:必須 さまざまなコンパイル アクションに渡されるプロファイルのラベル。このファイルの内容 作成します。 |
ld_profile
|
ラベル:必須 リンク アクションに渡されるプロフィールのラベル。このファイルの内容 作成します。 |