共享变量

报告问题 查看源代码 每夜版 · 8.4 · 8.3 · 8.2 · 8.1 · 8.0 · 7.6

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"],
)