configuration

此对象包含有关 build 运行环境的信息。如需详细了解配置的一般概念,请参阅规则页面

成员

coverage_enabled

bool configuration.coverage_enabled

一个布尔值,用于指明是否为此运行启用了代码覆盖率。请注意,此值不会计算是否应检测特定规则以收集代码覆盖率数据。如需了解相关信息,请参阅 ctx.coverage_instrumented 函数。

default_shell_env

dict configuration.default_shell_env

一个字典,表示静态本地 shell 环境。它将变量映射到其值(字符串)。

host_path_separator

string configuration.host_path_separator

返回 PATH 环境变量的分隔符,在 Unix 上为“:”。

short_id

string configuration.short_id

一个简短的标识符,用于标识 config 和 query 子命令可识别的此配置。

使用此标识符可以区分同一目标的不同配置,以便用户和工具使用,例如在 IDE 使用的方面。请注意以下事项:

  • 该值可能因 Bazel 版本(包括补丁版本)而异。
  • 该值会对每个 标志的值进行编码,包括与当前目标无关的标志,因此可能会更频繁地使缓存失效。

    test_env

    dict configuration.test_env

    一个字典,其中包含用户指定的测试环境变量及其值,由 --test_env 选项设置。请勿使用!这不是完整的环境!