BUILD
ファイルは、シンプルで宣言型になっています。これらは通常、一連のターゲット宣言で構成されます。コードベースと BUILD
ファイルの規模が大きくなるにつれて、次のような重複に気づくはずです。
cc_library(
name = "foo",
copts = ["-DVERSION=5"],
srcs = ["foo.cc"],
)
cc_library(
name = "bar",
copts = ["-DVERSION=5"],
srcs = ["bar.cc"],
deps = [":foo"],
)
通常、BUILD
ファイルのコードの重複は問題ありません。これにより、ファイルが読みやすくなります。各宣言は、コンテキストなしで読み取って理解できます。これは、人間だけでなく、外部ツールにとっても重要です。たとえば、BUILD
ファイルを読み取って更新し、不足している依存関係を追加できるツールです。コードのリファクタリングとコードの再利用により、このような自動変更を防ぐことができます。
値を共有すると便利な場合(値の同期を維持する必要がある場合など)は、変数を導入できます。
COPTS = ["-DVERSION=5"]
cc_library(
name = "foo",
copts = COPTS,
srcs = ["foo.cc"],
)
cc_library(
name = "bar",
copts = COPTS,
srcs = ["bar.cc"],
deps = [":foo"],
)
複数の宣言で値 COPTS
が使用されるようになりました。慣例として、グローバル定数の名前には大文字を使用します。
複数の BUILD ファイル間で変数を共有する
複数の BUILD
ファイルで値を共有する必要がある場合は、その値を .bzl
ファイルに配置する必要があります。.bzl
ファイルには、BUILD
ファイルで使用できる定義(変数と関数)が含まれています。
path/to/variables.bzl
に次のように記述します。
COPTS = ["-DVERSION=5"]
次に、変数にアクセスできるように BUILD
ファイルを更新します。
load("//path/to:variables.bzl", "COPTS")
cc_library(
name = "foo",
copts = COPTS,
srcs = ["foo.cc"],
)
cc_library(
name = "bar",
copts = COPTS,
srcs = ["bar.cc"],
deps = [":foo"],
)