浏览 Bazel 的庞大命令行标志列表可能很有挑战性。本页重点介绍您需要了解的最重要的标志。
实用的常规选项
以下标志应在命令行中明确设置。
标志 | 说明 |
---|---|
|
您可以将 .bazelrc 文件中的标志整理为配置,例如用于调试或发布 build 的标志。您可以使用 --config=<group> 选择其他配置组。
|
|
Bazel 应尽可能尝试继续执行构建和测试。默认情况下,Bazel 会立即失败。 |
|
使用远程执行或缓存(磁盘和远程)时,您可以向 Bazel 发出信号,指明您想下载所有(中间)构建工件,如下所示:
--remote_download_outputs=all |
|
向二进制文件添加 build 信息(用户、时间戳)。 |
发现构建和测试问题
以下标志可帮助您更好地了解 Bazel 构建或测试错误。
标志 | 说明 |
---|---|
|
显示通过用户定义、机器定义或项目定义的 .bazelrc 文件隐式设置的标志。 |
|
默认情况下,Bazel 会尝试防止日志垃圾,并且只会针对命令行上请求的软件包和子软件包输出编译器警告和 Starlark 调试输出。如需停用所有过滤功能,请设置 --auto_output_filter=none 。
|
|
让您深入了解沙盒化错误。如需详细了解 Bazel 为何默认对 build 进行沙盒化处理以及哪些内容会被沙盒化处理,请参阅我们的沙盒化文档。 |
|
显示 Bazel 在构建期间运行的每个命令的完整列表,无论构建是成功还是失败 |
启动
标志 | 说明 |
---|---|
|
您可以在 .bazelrc 文件中指定默认 Bazel 选项。如果存在多个 .bazelrc 文件,您可以通过添加 --bazelrc=<path to
the .bazelrc file> 来选择要使用的 .bazelrc 文件。
|
|
限制 Bazel 服务器使用的 RAM 量。
例如,以下命令会将 Bazel 堆大小限制为 3GB:
--host_jvm_args=-Xmx3g |
|
控制 Bazel 的输出树。Bazel 不会在源代码树本身中存储构建输出(包括日志)。而是使用一个单独的输出树来实现此目的。 |
Bazel 测试
以下标志与 Bazel 测试相关
标志 | 说明 |
---|---|
|
会导致 Java 测试在执行前等待调试程序连接。 |
|
运行测试的次数。例如,如需运行测试 N 次,请添加 --runs_per_test=N 。这对于调试不稳定的测试和查看修复程序是否会导致测试始终通过非常有用。
|
|
指定输出模式。默认情况下,Bazel 会在本地日志文件中捕获测试输出。迭代失败的测试时,您通常需要使用 --test_output=streamed 实时查看测试输出。
|
Bazel run
以下标志与 Bazel 运行相关。
标志 | 说明 |
---|---|
|
更改了调用可执行文件的方式。例如,--run_under="strace -c" 通常用于调试。
|
用户专用 bazelrc 选项
以下标志与用户专用 .bazelrc 选项相关。
标志 | 说明 |
---|---|
|
指向 Bazel 可以读取和写入操作和操作输出的目录的路径。如果目录不存在,系统将会创建目录。
您可以通过向命令中添加 --disk_cache=<path> ,在多个分支或工作区之间共享构建工件,并加快 Bazel 构建速度。
|
|
要运行的并发作业数。 通常,只有在使用远程执行时才需要执行此操作,在这种情况下,远程 build 集群执行的作业数量会超过您本地的核心数量。 |
|
限制本地运行的操作所消耗的 CPU 或 RAM 用量。 |
|
允许沙盒在此路径下创建沙盒目录。默认情况下,Bazel 会在沙盒中执行本地操作,这会给构建带来一些开销。 |
项目专用 bazelrc 选项
以下标志与项目专用 .bazelrc 选项相关。
标志 | 说明 |
---|---|
|
如果任何测试失败,最多可重试指定次数。这对于持续集成特别有用。需要多次尝试才能通过的测试会在测试摘要中标记为不稳定。 |
|
缓存端点的 URI。设置远程缓存是加快 Bazel 构建速度的绝佳方式。它可以与本地磁盘缓存结合使用。 |
|
强制下载路径与此模式匹配的远程 build 输出,无论 --remote_download_outputs 设置如何。您可以通过重复使用此标志来指定多个模式。
|
|
远程执行端点的 HOST 或 HOST:PORT 。如果您使用的是远程执行服务,请传递此参数。您通常需要添加 --remote_instance_name=<name> 。
|
|
要在远程执行 API 中作为 instance_name 传递的值。
|
|
如果指定,系统会为 Bazel 生成的每条消息添加时间戳,以指明消息显示的时间。这对于 CI 系统非常有用,可让您快速了解哪个步骤花了多长时间。 |
|
即使使用远程执行,在本地运行某些构建操作可能更快。这取决于 build 集群的容量、网络速度和网络延迟等因素。 |