C++ と Bazel

<ph type="x-smartling-placeholder"></ph> 問題を報告するソースを表示夜間 · 7.3 · 7.2 · 7.1 · 7.0 · 6.5

このページには、C++ プロジェクトで Bazel を使用する場合に役立つリソースが記載されています。リンク先チュートリアル、ビルドルールなど、C++ のビルドに固有の情報が紹介しました。

Bazel の使用

次のリソースは、C++ プロジェクトで Bazel を使用する際に役立ちます。

Bazel の一般的なベストプラクティスに加えて、以下があります。 C++ プロジェクトに固有のベストプラクティスを紹介します。

BUILD ファイルを作成する際は、以下のガイドラインに従ってください。

各 BUILD ファイルには 1 つの cc_library を含める必要があります。ディレクトリ内のコンパイル単位ごとに、ルールターゲットを指定します。
C++ ライブラリは可能な限り細かくインクリメンタリティを最大化してビルドを並列化できます
srcs にソースファイルが 1 つしかない場合は、ライブラリにその C++ ファイルの名前。このライブラリには、一致する C++ ファイルを含める必要があります。ヘッダーファイル、ライブラリの直接依存関係などです。例:
```
cc_library(
    name = "mylib",
    srcs = ["mylib.cc"],
    hdrs = ["mylib.h"],
    deps = [":lower-level-lib"]
)
```
ファイル内の cc_library ターゲットごとに 1 つの cc_test ルールターゲットを使用します。キャンペーンにターゲット [library-name]_test とソースファイル [library-name]_test.cc。たとえば、上記の mylib ライブラリターゲットのテストターゲットは、次のようになります。次のようになります。
```
cc_test(
    name = "mylib_test",
    srcs = ["mylib_test.cc"],
    deps = [":mylib"]
)
```

インクルードパスについては、次のガイドラインに従ってください。

すべてのインクルードパスは、ワークスペースディレクトリからの相対パスにします。
システム以外のヘッダーには引用符で囲まれたインクルード（#include "foo/bar/baz.h"）を使用。山かっこ（#include <foo/bar/baz.h>）。
.（カレントディレクトリ）や .. などの UNIX ディレクトリショートカットを使用しない（親ディレクトリ）のように構成されます。
以前のコードまたは third_party コードに、プレフィックスを必要とする外部リポジトリなど、プロジェクトリポジトリ。 include_prefix と strip_include_prefix cc_library ルールターゲットの引数。

次のオプションの機能 C++ プロジェクトの健全性を向上させることができます。これらを有効にするには、 --features コマンドラインフラグまたは features repo, package ルールまたは cc_* ルール:

parse_headers 機能により、C++ コンパイラを使用して解析が行われます。ビルドされたターゲット内のすべてのヘッダーファイルとその依存関係（コンパイルは対象外）使用する際は、 --process_headers_in_dependencies 設定されます。これにより、ヘッダーのみのライブラリの問題を検出し、ヘッダーは自己完結型であり、その順序に関係なく含まれます。
layering_check 機能により、ターゲットにはヘッダーのみが含まれるようになります。メリットが得られます。デフォルトのツールチェーンはこれをサポートしています。（clang をコンパイラとして使用）