命令行参考文档

bazel [<startup options>] <command> [<args>]
bazel [<startup options>] <command> [<args>] -- [<target patterns>]
如需了解目标模式语法,请参阅用户指南

选项语法

选项可通过不同的方式传递给 Bazel。需要值的选项可以使用等号或空格进行传递:

--<option>=<value>
--<option> <value>
某些选项只有单个字符的短格式;在这种情况下,在传递短格式时,必须使用一个短划线和一个空格。
-<short_form> <value>

您可以按如下方式启用布尔值选项:

--<option>
--<option>=[true|yes|1]
;停用布尔值选项:
--no<option>
--<option>=[false|no|0]

三态选项通常默认设置为自动,并且可按如下方式强制启用:

--<option>=[true|yes|1]
或按如下方式强制停用:
--no<option>
--<option>=[false|no|0]

命令

analyze-profile 分析 build 配置数据。
aquery 分析给定的目标并查询操作图。
build 构建指定的目标。
canonicalize-flags 对 bazel 选项列表进行规范化。
clean 移除输出文件,还可以选择停止服务器。
coverage 为指定的测试目标生成代码覆盖率报告。
cquery 加载、分析和查询采用相应配置的指定目标。
dump 转储 bazel 服务器进程的内部状态。
fetch 获取目标先决条件的外部代码库。
help 输出关于命令或索引的帮助。
info 显示有关 Bazel 服务器的运行时信息。
license 输出此软件的许可。
mobile-install 定位到移动设备。
mod 查询 Bzlmod 外部依赖关系图
print_action 输出用于编译文件的命令行参数。
query 执行依赖关系图查询。
run 运行指定的目标。
shutdown 停止 bazel 服务器。
sync 同步工作区文件中指定的所有代码库
test 构建并运行指定的测试目标。
version 输出 bazel 的版本信息。

启动选项

出现在命令之前并由客户端解析的选项:
--[no]autodetect_server_javabase 默认值:“true”
传递 --noautodetect_server_javabase 后,Bazel 不会回退到本地 JDK 来运行 bazel 服务器,而是退出。
标记:affects_outputsloses_incremental_state
--[no]batch 默认值:“false”
设置后,Bazel 将作为没有服务器的客户端进程运行,而不是在标准客户端/服务器模式下运行。此 API 已被弃用,并将被移除。如果您希望避免服务器延迟,请明确关闭服务器。
标记:loses_incremental_statebazel_internal_configurationdeprecated
--[no]batch_cpu_scheduling 默认值:“false”
仅适用于 Linux;对 Blaze 使用“批量”CPU 调度。此政策适用于非交互式但不想降低其友好值的工作负载。请参阅“man 2 sched_setscheduler”。如果为 false,Bazel 不会执行系统调用。
标记: host_machine_resource_optimizations
--bazelrc=<path> 默认值:请参阅说明
包含 Bazel 选项默认值的用户 .bazelrc 文件的位置。/dev/null 表示将忽略所有后面的 `--bazelrc`,这对于停用用户 rc 文件搜索非常有用(例如在发布 build 中)。 您还可以多次指定此选项。 例如,使用 `--bazelrc=x.rc --bazelrc=y.rc --bazelrc=/dev/null --bazelrc=z.rc` 时, 1) 会读取 x.rc 和 y.rc。 2) z.rc 因先前的 /dev/null 而被忽略。 如果未指定,Bazel 会使用在以下两个位置找到的第一个 .bazelrc 文件:工作区目录,然后是用户的主目录。 注意:命令行选项将始终取代 bazelrc 中的任何选项。
标记: changes_inputs
--[no]block_for_lock 默认值:“true”
传递 --noblock_for_lock 时,Bazel 不会等待正在运行的命令执行完毕,而是立即退出。
标记: eagerness_to_exit
--[no]client_debug 默认值:“false”
如果为 true,将来自客户端的调试信息记录到 stderr。更改此选项不会导致服务器重启。
标记:affects_outputsbazel_monitoring
--connect_timeout_secs=<an integer> 默认值:“30”
客户端每次尝试连接到服务器时等待的时间
标记: bazel_internal_configuration
--[no]expand_configs_in_place 默认值:“true”
将 --config 标志的展开方式更改为就地完成,而不是在普通 rc 选项和命令行指定选项之间进行固定点扩展。
标记:no_opdeprecated
--failure_detail_out=<path> 默认值:请参阅说明
如果设置了此字段,则会指定一个位置,以便在服务器遇到故障且无法像往常一样通过 gRPC 报告时写入 failed_detail protobuf 消息。否则,该位置将为 ${OUTPUT_BASE}/failure_detail.rawproto。
标记:affects_outputsloses_incremental_state
--[no]home_rc 默认值:“true”
是否在 $HOME/.bazelrc 中查找主 bazelrc 文件
标记:changes_inputs
--[no]idle_server_tasks 默认值:“true”
在服务器空闲时运行 System.gc()
标记:loses_incremental_statehost_machine_resource_optimizations
--[no]ignore_all_rc_files 默认值:“false”
停用所有 rc 文件,而不考虑其他 rc 修改标志的值,即使这些标志出现在启动选项列表中靠后的位置也是如此。
标记: changes_inputs
--io_nice_level={-1,0,1,2,3,4,5,6,7} 默认值:“-1”
仅适用于 Linux;使用 sys_ioprio_set 系统调用可以尽最大努力实现 IO 调度,将级别设置为 0-7。0 是优先级最高,7 是优先级最低。预期调度程序可能最多只遵循优先级 4。如果设置为负值,则 Bazel 不会执行系统调用。
标记: host_machine_resource_optimizations
--local_startup_timeout_secs=<an integer> 默认值:“120”
客户端等待连接到服务器的最长时间
标记: bazel_internal_configuration
--macos_qos_class=<a string> 默认值:“default”
设置在 macOS 上运行时 bazel 服务器的 QoS 服务等级。此标志对所有其他平台没有任何影响,但受支持,以确保可以在各平台之间共享 rc 文件,而无需更改。可能的值包括:用户交互、用户启动、默认、实用程序和背景。
标记: host_machine_resource_optimizations
--max_idle_secs=<integer> 默认值:“10800”
构建服务器在关闭之前等待空闲的秒数。零表示服务器永远不会关闭。此字段仅在服务器启动时读取,更改此选项不会导致服务器重启。
标记:eagerness_to_exitloses_incremental_state
--output_base=<path> 默认值:请参阅说明
如果设置此参数,则指定将所有构建输出写入到的输出位置。否则,位置将为 ${OUTPUT_ROOT}/_blaze_${USER}/${MD5_OF_WORKSPACE_ROOT}。注意:如果您为此值指定的下一次 Bazel 调用不同选项,很可能会启动一个新的额外 Bazel 服务器。Bazel 只会为每个指定的输出库启动一台服务器。通常,每个工作区有一个输出基准。但是,如果使用此选项,您可以为每个工作区有多个输出基准,从而可在同一机器上同时针对同一客户端运行多个构建。如需了解如何关停 Bazel 服务器,请参阅“bazel 帮助关停”。
标记:affects_outputsloses_incremental_state
--output_user_root=<path> 默认值:请参阅说明
特定于用户的目录,所有 build 输出都将写入到该目录下;默认情况下,这是 $USER 函数,但如果指定一个常量,协作者就可以共享 build 输出。
标记:affects_outputsloses_incremental_state
--[no]preemptible 默认值:“false”
如果为 true,那么当启动另一个命令时,该命令可能会被抢占。
标记: eagerness_to_exit
--server_jvm_out=<path> 默认值:请参阅说明
写入服务器 JVM 输出的位置。如果未设置,则默认为 output_base 中的某个位置。
标记:affects_outputsloses_incremental_state
--[no]shutdown_on_low_sys_mem 默认值:“false”
如果已设置 max_idle_secs 且构建服务器已闲置一段时间,请在系统可用 RAM 不足时关闭服务器。仅限 Linux。
标记:eagerness_to_exitloses_incremental_state
--[no]system_rc 默认值:“true”
是否查找系统级 bazelrc。
标记: changes_inputs
--[no]unlimit_coredumps 默认值:“false”
将软核心转储限制提高到硬性限制,以便在常见情况下使服务器(包括 JVM)和客户端的核心转储能够正常运行。将此标志保留在您的 bazelrc 中一次,然后就此忽略,这样,在实际遇到触发这些标志的条件时,就能获得核心转储文件。
标记: bazel_internal_configuration
--[no]watchfs 默认值:“false”
如果为 true,则 bazel 会尝试使用操作系统的文件监控服务进行本地更改,而不是扫描每个文件是否存在更改。
标记: deprecated
如果为 true,系统会在 Windows 上创建实际的符号链接,而不会复制文件。需要启用 Windows 开发者模式且 Windows 10 版本 1703 或更高版本。
标记: bazel_internal_configuration
--[no]workspace_rc 默认值:“true”
是否在 $workspace/.bazelrc 中查找 Workspace bazelrc 文件
标记:changes_inputs
其他选项,未以其他方式分类:
已累计 --host_jvm_args=<jvm_arg> 次多次使用
传递给用于执行 Blaze 的 JVM 的标志。
--host_jvm_debug
添加一些额外 JVM 启动标志的便捷选项,这些标志会导致 JVM 在启动期间一直处于等待状态,直到您从兼容 JDWP 的调试程序(如 Eclipse)连接到端口 5005。
扩展为:
  --host_jvm_args=-Xdebug
  --host_jvm_args=-Xrunjdwp:transport=dt_socket,server=y,address=5005
--host_jvm_profile=<profiler_name> 默认值:“”
添加一些特定于性能分析器/调试程序的 JVM 启动标志的便捷选项。Bazel 具有一个已知值列表,这些值会映射到硬编码的 JVM 启动标志,并且可能会通过一些硬编码路径搜索某些文件。
--server_javabase=<jvm path> 默认值:“”
用于执行 Bazel 本身的 JVM 的路径。

所有命令通用的选项

用于控制构建执行的选项:
--experimental_oom_more_eagerly_threshold=<an integer> 默认值:“100”
如果将此标志设置为小于 100 的值,则 Bazel 会在两次完整的 GC 之后仍被占用超过这个百分比的(旧代)堆,导致 OOM。
标记: host_machine_resource_optimizations
--experimental_ui_max_stdouterr_bytes=<an integer in (-1)-1073741819 range> 默认值:“1048576”
将输出到控制台的 stdout / stderr 文件的大小上限。-1 表示无限制。
标记: execution
用于配置用于执行操作的工具链的选项:
--[no]incompatible_enable_proto_toolchain_resolution 默认值:“false”
如果为 true,proto lang 规则会定义来自 rules_proto、rules_java 和 rules_cc 代码库的工具链。
标记:loading_and_analysisincompatible_change
可让用户配置预期输出,从而影响预期输出值而非其存在的选项:
已累计 --repo_env=<a 'name=value' assignment with an optional value part> 次多次使用
指定仅适用于代码库规则的其他环境变量。请注意,代码库规则仍会查看完整环境,但这样一来,就可以通过选项将配置信息传递给代码库,而不会使操作图失效。
标记: action_command_lines
影响 Bazel 强制执行有效 build 输入的严格程度的选项(规则定义、标志组合等):
--[no]check_bzl_visibility 默认值:“true”
如果停用此设置,.bzl 加载可见性错误将降级为警告。
标记: build_file_semantics
此选项会影响 Starlark 语言或 build 文件、.bzl 文件或 WORKSPACE 文件可访问的 build API 的语义。
--[no]enable_bzlmod 默认值:“false”
如果为 true,则启用 Bzlmod 依赖项管理系统,该系统的优先级高于 WORKSPACE。如需了解详情,请参阅 https://bazel.build/docs/bzlmod。
标记: loading_and_analysis
--[no]experimental_action_resource_set 默认值:“true”
如果设置为 true,则 ctx.actions.run() 和 placeholder.actions.run_shell() 会接受 resource_set 参数在本地执行。否则,默认为 250 MB 的内存和 1 个 CPU。
标记:executionbuild_file_semanticsexperimental
--[no]experimental_allow_tags_propagation 默认值:“false”
如果设置为 true,则标记会从目标传播到相应操作的执行要求;否则,标记不会传播。如需了解详情,请参阅 https://github.com/bazelbuild/bazel/issues/8830。
标记:build_file_semanticsexperimental
--[no]experimental_analysis_test_call 默认值:“true”
如果设置为 true,则 analytics_test 原生调用可用。
标记:loading_and_analysisbuild_file_semanticsexperimental
--[no]experimental_bzl_visibility 默认值:“true”
如果启用,则会添加一个“visibility()”函数,.bzl 文件可能会在顶级评估期间调用该函数来设置其可见性,以便用于 load() 语句。
标记:loading_and_analysisexperimental
--[no]experimental_cc_shared_library 默认值:“false”
如果设置为 true,则规则 cc_shared_library 所需的规则属性和 Starlark API 方法将可用
标记:build_file_semanticsloading_and_analysisexperimental
--[no]experimental_disable_external_package 默认值:“false”
如果设为 true,自动生成的 //外部软件包将不再可用。Bazel 仍然无法解析文件“external/BUILD”,但从未命名的软件包访问 external/ 的 glob 将可以正常运行。
标记:loading_and_analysisloses_incremental_stateexperimental
--[no]experimental_enable_android_migration_apis 默认值:“false”
如果设置为 true,则启用支持 Android Starlark 迁移所需的 API。
标记: build_file_semantics
--[no]experimental_get_fixed_configured_action_env 默认值:“false”
启用后,action.env 还将返回通过功能配置指定的固定环境变量。
标记:loading_and_analysisexperimental
--[no]experimental_google_legacy_api 默认值:“false”
如果设置为 true,则公开一些与 Google 旧版代码相关的 Starlark build API 实验性部分。
标记:loading_and_analysisexperimental
--[no]experimental_isolated_extension_usages 默认值:“false”
如果为 true,则在 <a href="https://bazel.build/rules/lib/globals/module#use_extension"><code>use_extension</code></a> 函数中启用<code>isolate</code> 参数。
标记: loading_and_analysis
--[no]experimental_lazy_template_expansion 默认值:“true”
如果设置为 true,则 ctx.actions.expand_template() 会接受 TemplateDict 参数来延迟评估替换值。
标记:executionbuild_file_semanticsexperimental
--[no]experimental_platforms_api 默认值:“false”
如果设置为 true,则会启用多个与平台相关的 Starlark API,对调试很有用。
标记:loading_and_analysisexperimental
--[no]experimental_repo_remote_exec 默认值:“false”
如果设置为 true,repo_rule 会获得一些远程执行功能。
标记:build_file_semanticsloading_and_analysisexperimental
--[no]experimental_sibling_repository_layout 默认值:“false”
如果设置为 true,则非主仓库将作为指向执行根目录中主仓库的符号链接进行植入。也就是说,所有代码库都是 $output_base/execution_root 目录的直接子级。这样做的负面影响是,将 $output_base/execution_root/__main__/external 释放出来,用于真正的顶级“外部”目录。
标记:action_command_linesbazel_internal_configurationloading_and_analysisloses_incremental_stateexperimental
--[no]incompatible_always_check_depset_elements 默认值:“true”
检查所有构造函数中添加到 depset 的元素的有效性。元素必须是不可变的,但以往 depset(direct=...) 构造函数忘记进行检查。在 depset 元素中使用元组,而不是列表。如需了解详情,请参阅 https://github.com/bazelbuild/bazel/issues/10313。
标记:build_file_semanticsincompatible_change
为 true 时,Bazel 不再从 links_context.credentials_to_link 中返回列表,而是会返回一个 depset。
标记:loading_and_analysisincompatible_change
--[no]incompatible_disable_objc_library_transition 默认值:“false”
停用 objc_library 的自定义转场效果,改为从顶级目标继承
标记:build_file_semanticsincompatible_change
--[no]incompatible_disable_starlark_host_transitions 默认值:“false”
如果设置为 true,则规则属性无法设置 'cfg = "host"'。规则应改为设置“cfg = "exec"”。
标记:loading_and_analysisincompatible_change
--[no]incompatible_disable_target_provider_fields 默认值:“false”
如果设置为 true,请停用通过字段语法访问“目标”对象上提供程序的功能。请改用提供程序键语法。例如,不要使用“ctx.attr.dep.my_info”从规则实现函数内访问“my_info”,而应使用“ctx.attr.dep[MyInfo]”。如需了解详情,请参阅 https://github.com/bazelbuild/bazel/issues/9014。
标记:build_file_semanticsincompatible_change
--[no]incompatible_disallow_empty_glob 默认值:“false”
如果设置为 true,则 glob() 的“allow_empty”参数的默认值为 False。
标记:build_file_semanticsincompatible_change
--[no]incompatible_disallow_legacy_javainfo 默认值:“true”
已废弃。无操作。
标记:build_file_semanticsincompatible_change
--[no]incompatible_disallow_struct_provider_syntax 默认值:“false”
如果设置为 true,规则实现函数可能不会返回结构体。它们必须改为返回提供程序实例列表。
标记:build_file_semanticsincompatible_change
--[no]incompatible_enable_deprecated_label_apis 默认值:“true”
启用后,可以使用某些已废弃的 API(native.repo_name、Label.workspace_name、Label.relative)。
标记: loading_and_analysis
--[no]incompatible_existing_rules_immutable_view 默认值:“true”
如果设置为 true,native.existing_rule 和 native.existing_rules 会返回轻量级不可变视图对象,而不是可变字典。
标记:build_file_semanticsloading_and_analysisincompatible_change
--[no]incompatible_fail_on_unknown_attributes 默认值:“false”
启用后,将未知属性设为“无”的目标将失败。
标记:loading_and_analysisincompatible_change
--[no]incompatible_fix_package_group_reporoot_syntax 默认值:“true”
在 package_group 的 `packages` 属性中,更改了值“//...”的含义以引用当前代码库中的所有软件包,而不是任何代码库中的所有软件包。您可以使用特殊值“public”代替“//...”来获取旧行为。此标志要求同时启用 --incompatible_package_group_has_public_syntax。
标记:build_file_semanticsincompatible_change
--[no]incompatible_java_common_parameters 默认值:“true”
如果设置为 true,则 pack_sources 中的 output_jar 和 host_javabase 参数以及编译中的 host_javabase 都将被移除。
标记:build_file_semanticsincompatible_change
--[no]incompatible_merge_fixed_and_default_shell_env 默认值:“false”
启用后,通过同时指定“env”和“use_default_shell_env = True”的 ctx.actions.run 和 ctx.actions.run_shell 注册的操作将使用从默认 shell 环境获取的环境,具体方法是替换为传入“env”的值。在这种情况下,如果停用“env”,系统会完全忽略“env”的值。
标记:loading_and_analysisincompatible_change
--[no]incompatible_new_actions_api 默认值:“true”
如果设置为 true,则用于创建操作的 API 仅适用于 `ctx.actions`,而不适用于 `ctx`。
标记:build_file_semanticsincompatible_change
--[no]incompatible_no_attr_license 默认值:“true”
如果设置为 true,则会停用函数“attr.license”。
标记:build_file_semanticsincompatible_change
--[no]incompatible_no_implicit_file_export 默认值:“false”
如果设置此参数,除非明确导出,否则(使用的)源文件将是软件包私有文件。请参阅 https://github.com/bazelbuild/proposals/blob/master/designs/2019-10-24-file-visibility.md
标记:build_file_semanticsincompatible_change
--[no]incompatible_no_rule_outputs_param 默认值:“false”
如果设置为 true,则停用 Starlark 函数的“rule()”的“outputs”参数。
标记:build_file_semanticsincompatible_change
--[no]incompatible_package_group_has_public_syntax 默认值:“true”
在 package_group 的“packages”属性中,允许写入“public”或“private”以分别引用所有软件包或无软件包。
标记:build_file_semanticsincompatible_change
--[no]incompatible_require_linker_input_cc_api 默认值:“true”
如果设置为 true,则规则 create_linking_context 将需要 linker_inputs,而不是 libraries_to_link。之前,linker_context 的旧 getter 也将停用,届时仅 linker_inputs 将可用。
标记:build_file_semanticsloading_and_analysisincompatible_change
--[no]incompatible_run_shell_command_string 默认值:“true”
如果设置为 true, actions.run_shell 的命令参数将仅接受字符串
标记:build_file_semanticsincompatible_change
--[no]incompatible_stop_exporting_language_modules 默认值:“false”
启用后,某些特定语言的模块(例如 `cc_common`)将不会在用户 .bzl 文件中使用,只能从其各自的规则代码库中调用。
标记:loading_and_analysisincompatible_change
--[no]incompatible_struct_has_no_methods 默认值:“false”
停用结构体的 to_json 和 to_proto 方法,这些方法会污染结构体字段命名空间。请改用 json.encode 或 json.encode_unsubscribe(对于 JSON)或 proto.encode_text(对于 textproto)。
标记:build_file_semanticsincompatible_change
--[no]incompatible_top_level_aspects_require_providers 默认值:“false”
如果设置为 true,则顶级切面将遵循其必需的提供程序,并且仅在其规则所通告的提供程序满足该切面的必需提供程序的顶级目标上运行。
标记:loading_and_analysisincompatible_change
--[no]incompatible_unambiguous_label_stringification 默认值:“true”
如果为 true,Bazel 会将 @//foo:bar 标签字符串化为 @//foo:bar,而不是 //foo:bar。这只会影响 str()、% 运算符等的行为;repr() 的行为保持不变。如需了解详情,请参阅 https://github.com/bazelbuild/bazel/issues/15916。
标记:loading_and_analysisincompatible_change
--[no]incompatible_use_cc_configure_from_rules_cc 默认值:“false”
如果为 true,Bazel 将不再允许使用 @bazel_tools 中的 cc_configure。如需了解详情和迁移说明,请参阅 https://github.com/bazelbuild/bazel/issues/10134。
标记:loading_and_analysisincompatible_change
--[no]incompatible_visibility_private_attributes_at_definition 默认值:“true”
如果设置为 true,系统会根据规则定义检查专用规则属性的可见性;如果未显示,则回退到使用规则。
标记:build_file_semanticsincompatible_change
--max_computation_steps=<a long integer> 默认值:“0”
build 文件可以执行的 Starlark 计算步骤数上限(零表示无限制)。
标记: build_file_semantics
--nested_set_depth_limit=<an integer> 默认值:“3500”
depset(也称为 NestedSet)内部图的最大深度,超过该值时,depset() 构造函数将失败。
标记: loading_and_analysis
触发构建时优化的选项:
--[no]incompatible_do_not_split_linking_cmdline 默认值:“true”
为 true 时,Bazel 不再修改用于建立链接的命令行标志,也不会选择性地决定哪些标志应转到参数文件,哪些标志不会。如需了解详情,请参阅 https://github.com/bazelbuild/bazel/issues/7670。
标记:loading_and_analysisincompatible_change
--[no]keep_state_after_build 默认值:“true”
如果为 false,Blaze 将在构建完成后舍弃此 build 的内存中状态。后续构建不会有任何与此次构建有关的增量。
标记: loses_incremental_state
--skyframe_high_water_mark_threshold=<an integer> 默认值:“85”
用于对 Bazel 内部 Skyframe 引擎进行高级配置的标志。如果 Bazel 检测到其保留的堆百分比用量不低于此阈值,则会丢弃不必要的临时 Skyframe 状态。当 GC 抖动 (i) 由此临时状态的内存使用导致且 (ii) 需要比在需要时重构状态的成本更高时,对此进行微调可以降低 GC 抖动对实际用时的影响。
标记: host_machine_resource_optimizations
--[no]track_incremental_state 默认值:“true”
如果为 false,则 Blaze 不会保留数据(允许在增量 build 中失效和重新评估)以节省此 build 的内存。此后,后续构建不会有任何增量。通常情况下,将此项设为 false 时,您需要指定 --batch。
标记: loses_incremental_state
影响日志记录的详细程度、格式或位置的选项:
--[no]announce_rc 默认值:“false”
是否通告 RC 选项。
标记: affects_outputs
--[no]attempt_to_print_relative_paths 默认值:“false”
输出消息的位置部分时,请尝试使用相对于工作区目录或 --package_path 指定的某个目录的路径。
标记: terminal_output
--bes_backend=<a string> 默认值:“”
以 [SCHEME://]HOST[:PORT] 的形式指定构建事件服务 (BES) 后端端点。默认为禁用 BES 上传。支持的方案包括 grpc 和 grpcs(已启用 TLS 的 grpc)。如果未提供方案,Bazel 会假定使用 grpcs。
标记: affects_outputs
--[no]bes_check_preceding_lifecycle_events 默认值:“false”
在 PublishBuildToolEventStreamRequest 上设置 check_preceding_lifecycle_events_present 字段,以告知 BES 检查之前是否收到过与当前工具事件匹配的 InvocationEnforcementStarted 和 BuildEnqueued 事件。
标记: affects_outputs
已累计 --bes_header=<a 'name=value' assignment> 次多次使用
以 NAME=VALUE 格式指定将包含在 BES 请求中的标头。可以通过多次指定标志来传递多个标头。如果名称相同的多个值,系统会将其转换为以英文逗号分隔的列表。
标记: affects_outputs
--bes_instance_name=<a string> 默认值:请参阅说明
指定 BES 将在其中保存上传的 BEP 的实例名称。默认值为 null。
标记: affects_outputs
已累计 --bes_keywords=<comma-separated list of options> 次多次使用
指定要添加为 BES 发布的一组默认关键字的通知关键字列表(“command_name=<command_name>”“protocol_name=BEP”)。默认值为无。
标记: affects_outputs
--[no]bes_lifecycle_events 默认值:“true”
指定是否发布 BES 生命周期事件。(默认为“true”)。
标记: affects_outputs
--bes_oom_finish_upload_timeout=<An immutable length of time.> 默认值:“10m”
指定在 OOM 期间,bazel 应该等待 BES/BEP 上传完成多长时间。此标记可确保在 JVM 严重进行 GC 抖动且无法在任何用户线程上取得进展时终止。
标记: bazel_monitoring
--bes_outerr_buffer_size=<an integer> 默认值:“10240”
指定在将 stdout 或 stderr 报告为进度事件之前要在 BEP 中缓冲的最大大小。即使写入的最大数量超过指定值且不超过 --bes_outerr_chunk_size,系统仍会在单个事件中报告单个写入。
标记: affects_outputs
--bes_outerr_chunk_size=<an integer> 默认值:“1048576”
指定要在单条消息中发送到 BEP 的 stdout 或 stderr 大小上限。
标记: affects_outputs
--bes_proxy=<a string> 默认值:请参阅说明
通过代理连接到构建事件服务。目前,此标志只能用于配置 Unix 网域套接字 (unix:/path/to/socket)。
--bes_results_url=<a string> 默认值:“”
指定基本网址,用户可以在其中查看流式传输到 BES 后端的信息。Bazel 会将调用 ID 附加的网址输出到终端。
标记: terminal_output
--bes_timeout=<An immutable length of time.> 默认值:“0s”
指定在构建和测试完成后 bazel 应该等待 BES/BEP 上传完成多长时间。有效的超时值是一个自然数后跟一个单位:天 (d)、小时 (h)、分钟 (m)、秒 (s) 和毫秒 (ms)。默认值为“0”,表示没有超时。
标记: affects_outputs
--build_event_binary_file=<a string> 默认值:“”
如果不为空,则将构建事件协议的 varint 分隔的二进制表示法写入该文件。此选项隐含 --bes_upload_mode=wait_for_upload_complete。
标记: affects_outputs
--[no]build_event_binary_file_path_conversion 默认值:“true”
尽可能将 build 事件协议的二进制文件表示形式中的路径转换为更全局有效的 URI;如果停用,将始终使用 file:// URI 架构
标记:affects_outputs
--build_event_json_file=<a string> 默认值:“”
如果不为空,请将 build 事件协议的 JSON 序列化写入该文件。
标记: affects_outputs
--[no]build_event_json_file_path_conversion 默认值:“true”
尽可能将 build 事件协议的 JSON 文件表示形式中的路径转换为更全局有效的 URI;如果停用,将始终使用 file:// URI 架构
标记: affects_outputs
--build_event_max_named_set_of_file_entries=<an integer> 默认值:“-1”
单个 name_set_of_files 事件的最大条目数;小于 2 的值会被忽略,并且不执行事件拆分。此属性旨在限制构建事件协议中的最大事件大小,不过它不会直接控制事件大小。事件总大小是集合结构、文件和 URI 长度的函数,而事件总大小可能取决于哈希函数。
标记: affects_outputs
--[no]build_event_publish_all_actions 默认值:“false”
是否应发布所有操作。
标记: affects_outputs
--build_event_text_file=<a string> 默认值:“”
如果为非空,请将构建事件协议的文本表示形式写入该文件
标记:affects_outputs
--[no]build_event_text_file_path_conversion 默认值:“true”
尽可能将 build 事件协议的文本文件表示形式中的路径转换为更全局有效的 URI;如果停用,将始终使用 file:// URI 架构
标记: affects_outputs
--[no]experimental_announce_profile_path 默认值:“false”
启用后,系统会将 JSON 配置文件路径添加到日志中。
标记:affects_outputsbazel_monitoring
--[no]experimental_bep_target_summary 默认值:“false”
是否发布 TargetSummary 事件。
--[no]experimental_build_event_expand_filesets 默认值:“false”
如果为 true,则会在显示输出文件时展开 BEP 中的文件集。
标记: affects_outputs
如果为 true,则在显示输出文件时完全解析 BEP 中的相对 Fileset 符号链接。需要 --experimental_build_event_expand_filesets。
标记: affects_outputs
--experimental_build_event_upload_max_retries=<an integer> 默认值:“4”
Bazel 应重新尝试上传构建事件的次数上限。
标记: bazel_internal_configuration
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.> 默认值:“1s”
BEP 上传失败时指数退避算法重试的初始延迟时间下限。(指数:1.6)
标记:bazel_internal_configuration
--experimental_build_event_upload_strategy=<a string> 默认值:请参阅说明
选择如何上传构建事件协议中引用的工件。
标记: affects_outputs
已累计 --experimental_profile_additional_tasks=<phase, action, action_check, action_lock, action_release, action_update, action_complete, bzlmod, info, create_package, remote_execution, local_execution, scanner, local_parse, upload_time, process_time, remote_queue, remote_setup, fetch, vfs_stat, vfs_dir, vfs_readlink, vfs_md5, vfs_xattr, vfs_delete, vfs_open, vfs_read, vfs_write, vfs_glob, vfs_vmfs_stat, vfs_vmfs_dir, vfs_vmfs_read, wait, thread_name, thread_sort_index, skyframe_eval, skyfunction, critical_path, critical_path_component, handle_gc_notification, action_counts, local_cpu_usage, system_cpu_usage, local_memory_usage, system_memory_usage, system_network_up_usage, system_network_down_usage, workers_memory_usage, system_load_average, starlark_parser, starlark_user_fn, starlark_builtin_fn, starlark_user_compiled_fn, starlark_repository_fn, action_fs_staging, remote_cache_check, remote_download, remote_network, filesystem_traversal, worker_execution, worker_setup, worker_borrow, worker_working, worker_copying_outputs, credential_helper or unknown> 次多次使用
指定要包含在配置文件中的其他配置文件任务。
标记:affects_outputsbazel_monitoring
--[no]experimental_profile_include_primary_output 默认值:“false”
在操作事件中包含额外的“out”属性,该操作事件包含操作的主要输出的执行路径。
标记:affects_outputsbazel_monitoring
--[no]experimental_profile_include_target_label 默认值:“false”
在操作事件的 JSON 个人资料数据中包含目标标签。
标记:affects_outputsbazel_monitoring
--[no]experimental_stream_log_file_uploads 默认值:“false”
将日志文件上传内容直接流式传输到远程存储空间,而不是将其写入磁盘。
标记: affects_outputs
--experimental_workspace_rules_log_file=<a path> 默认值:请参阅说明
将某些工作区规则事件作为带分隔符的 WorkspaceEvent proto 记录到此文件中。
--[no]generate_json_trace_profile 默认值:“auto”
启用后,Bazel 会分析构建,并将 JSON 格式的配置文件写入输出库的文件中。加载到 chrome://tracing 中即可查看个人资料。默认情况下,Bazel 会为所有类似 build 的命令和查询编写配置文件。
标记:affects_outputsbazel_monitoring
--[no]heap_dump_on_oom 默认值:“false”
在抛出 OOM 时,是否手动输出堆转储(包括由于 --experimental_oom_more_eagerly_threshold 导致的 OOM)。转储将写入 <output_base>/<invocation_id>.heapdump.hprof。此选项实际取代了 -XX:+HeapDumpOnOutOfMemoryError,后者无效,因为系统捕获了 OOM 并将其重定向到 Runtime#halt。
标记: bazel_monitoring
--[no]legacy_important_outputs 默认值:“true”
使用此方法可禁止在 TargetComplete 事件中生成旧版 important_outputs 字段。Bazel 到 ResultStore 集成需要包含 important_outputs。
标记: affects_outputs
--logging=<0 <= an integer <= 6> 默认值:“3”
日志记录级别。
标记: affects_outputs
--memory_profile=<a path> 默认值:请参阅说明
如果已设置,则会在阶段结束时将内存使用情况数据写入指定的文件,并在构建结束时将稳定堆写入主日志。
标记:affects_outputsbazel_monitoring
--memory_profile_stable_heap_parameters=<integers, separated by a comma expected in pairs> 默认值:“1,0”
调整内存配置文件在构建结束时对稳定堆的计算。应是偶数个整数,并以英文逗号分隔。在每一对中,第一个整数代表要执行的 GC 数量。每一对中的第二个整数表示两次 GC 之间等待的秒数。例如:2、4、4、0 将执行 2 个 GC 暂停 4 秒,然后是 4 个 GC 暂停 0 秒
标记: bazel_monitoring
--profile=<a path> 默认值:请参阅说明
如果已设置,则对 Bazel 进行性能分析并将数据写入指定的文件。使用 bazel analyze-profile 来分析配置文件。
标记:affects_outputsbazel_monitoring
--[no]slim_profile 默认值:“true”
如果 JSON 配置文件过大,则可以通过合并事件来缩减 JSON 配置文件的大小。
标记:affects_outputsbazel_monitoring
--starlark_cpu_profile=<a string> 默认值:“”
将有关所有 Starlark 线程 CPU 使用情况的 pprof 配置文件写入指定的文件。
标记: bazel_monitoring
--tool_tag=<a string> 默认值:“”
此 Bazel 调用归因于的工具名称。
标记:affects_outputsbazel_monitoring
已累计 --ui_event_filters=<Convert list of comma separated event kind to list of filters> 次多次使用
用于指定要在界面中显示的事件。您可以使用前导 +/- 在默认事件中添加或移除事件,或者使用直接分配完全覆盖默认事件集。受支持的事件类型集包括 INFO、DEBUG、ERROR 等。
标记:terminal_output
其他选项,未以其他方式分类:
已累计 --build_metadata=<a 'name=value' assignment> 次多次使用
要在 build 事件中提供的自定义键值对字符串对。
标记: terminal_output
--color=<yes, no or auto> 默认值:“auto”
使用终端控件为输出着色。
已累计 --config=<a string> 次多次使用
从 rc 文件中选择其他配置部分;对于每个 <command>,它还会从 <command>:<config> 中提取选项(如果存在此类部分);如果任何 .rc 文件中都不存在此部分,则 Blaze 会失败并报错。等效的配置部分和标志组合位于 tools/*.blazerc 配置文件中。
已累计 --credential_helper=<Path to a credential helper. It may be absolute, relative to the PATH environment variable, or %workspace%-relative. The path be optionally prefixed by a scope followed by an '='. The scope is a domain name, optionally with a single leading '*' wildcard component. A helper applies to URIs matching its scope, with more specific scopes preferred. If a helper has no scope, it applies to every URI.> 次多次使用
配置凭据帮助程序,用于检索代码库提取、远程缓存和执行以及构建事件服务的授权凭据。 帮助程序提供的凭据优先于 --google_default_credentials、--google_credentials、.netrc 文件或存储库 _ A 下载 和 库 _ . 下载和提取 的 auth 参数提供的凭据。 可以多次指定此参数以设置多个帮助程序。 如需了解详情,请参阅 https://github.com/bazelbuild/proposals/blob/main/designs/2022-06-07-bazel-credential-helpers.md。
--credential_helper_cache_duration=<An immutable length of time.> 默认值:“30m”
凭据帮助程序提供的凭据的缓存时长。 使用其他值调用将调整先前存在的条目的有效期;传递零可清除缓存。无论此标志为何,干净命令始终会清除缓存。
--credential_helper_timeout=<An immutable length of time.> 默认值:“10s”
配置凭据帮助程序的超时时间。 凭据帮助程序未能在此超时时间内响应将使调用失败。
--curses=<yes, no or auto> 默认值:“auto”
使用终端光标控件可最大限度减少滚动输出。
--[no]enable_platform_specific_config 默认值:“false”
如果为 true,Bazel 会从 bazelrc 文件中获取特定于主机操作系统的配置行。例如,如果主机操作系统是 Linux,并且您运行的是 bazel build,则 Bazel 会选取以 build:linux 开头的行。支持的操作系统标识符包括 linux、macos、windows、freebsd 和 openbsd。启用此标志等同于在 Linux 中使用 --config=linux,在 Windows 中使用 --config=windows,等等。
--[no]experimental_skymeld_ui 默认值:“false”
当两者同时运行时,显示分析阶段和执行阶段的进度。
标记: terminal_output
--[no]experimental_windows_watchfs 默认值:“false”
如果为 true,则会启用对 --watchfs 的实验性 Windows 支持。否则,在 Windows 上,--watchfsis 是一个非操作。请务必同时启用 --watchfs。
--google_auth_scopes=<comma-separated list of options> 默认值:“https://www.googleapis.com/auth/cloud-platform”
以逗号分隔的 Google Cloud 身份验证范围列表。
--google_credentials=<a string> 默认值:请参阅说明
指定从中获取身份验证凭据的文件。如需了解详情,请参阅 https://cloud.google.com/docs/authentication。
--[no]google_default_credentials 默认值:“false”
是否使用“Google 应用默认凭据”进行身份验证。如需了解详情,请参阅 https://cloud.google.com/docs/authentication。默认处于停用状态。
--grpc_keepalive_time=<An immutable length of time.> 默认值:请参阅说明
为传出 gRPC 连接配置 keep-alive ping。如果已设置,则 Bazel 会在连接上无读取操作这么长时间后发送 ping,但前提是至少有一个待处理的 gRPC 调用。时间被视为第二粒度;设置小于 1 秒的值是错误的。默认情况下, keep-alive ping 处于停用状态。在启用此设置前,请与服务所有者协调。例如,如需为此标志设置 30 秒的值,应按如下方式设置:--grpc_keepalive_time=30s
--grpc_keepalive_timeout=<An immutable length of time.> 默认值:“20s”
为传出 gRPC 连接配置 keep-alive 超时。如果通过 --grpc_keepalive_time 启用 keep-alive ping,则如果 Bazel 在这段时间后未收到 ping 回复,则会超时连接。时间被视为第二粒度;设置小于 1 秒的值是错误的。如果 keep-alive ping 处于停用状态,则忽略此设置。
如果设置为 true,“ctx.actions.symlink”将禁止通过符号链接将文件关联至某个目录。
标记:loading_and_analysisincompatible_change
--[no]incompatible_remove_rule_name_parameter 默认值:“true”
如果设置为 true,则无法使用“name”参数调用“rule”。
标记:loading_and_analysisincompatible_change
--[no]progress_in_terminal_title 默认值:“false”
在终端标题中显示命令进度。这有助于了解 bazel 在有多个终端标签页时执行的操作。
--[no]show_progress 默认值:“true”
在构建期间显示进度消息。
--show_progress_rate_limit=<a double> 默认值:“0.2”
输出中进度消息之间的最小秒数。
--[no]show_timestamps 默认值:“false”
在消息中包含时间戳
--tls_certificate=<a string> 默认值:请参阅说明
指定受信任 TLS 证书(用于对服务器证书进行签名)的路径。
--tls_client_certificate=<a string> 默认值:请参阅说明
指定要使用的 TLS 客户端证书;您还需要提供客户端密钥以启用客户端身份验证。
--tls_client_key=<a string> 默认值:请参阅说明
指定要使用的 TLS 客户端密钥;您还需要提供客户端证书以启用客户端身份验证。
--ui_actions_shown=<an integer> 默认值:“8”
详细进度条中显示的并发操作数量;每项操作都显示在单独的一行上。进度条始终显示至少一个 1,所有小于 1 的数字都会映射到 1。
标记: terminal_output
--[no]watchfs 默认值:“false”
在 Linux/macOS 上:如果为 true,bazel 会尝试使用操作系统的文件监控服务进行本地更改,而不是扫描每个文件以查看是否有更改。在 Windows 上:此标志目前是一个非操作,但可以与 --experimental_windows_watchfs 一起启用。在任何操作系统上:如果您的工作区位于网络文件系统上,并且文件是在远程机器上修改的,则此行为未定义。

Analyze-profile 选项

出现在命令之前并由客户端解析的选项:
已累计 --distdir=<a path> 次多次使用
在访问网络以下载归档文件之前,可在其他位置搜索归档文件。
标记: bazel_internal_configuration
如果已设置,代码库缓存将在缓存命中时对文件进行硬链接,而不是复制。这是为了节省磁盘空间。
标记: bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id 默认值:“false”
如果为 true,请使用从代码库下载网址派生的字符串作为 canonical_id(如果未指定)。这会导致网址发生变化,进而重新下载,即使缓存中包含具有相同哈希值的下载内容。这可用于验证网址更改不会导致损坏的代码库被缓存遮盖。
标记:loading_and_analysisexperimental
--[no]experimental_repository_disable_download 默认值:“false”
如果设置此参数,则不允许下载外部代码库。
标记: experimental
--experimental_repository_downloader_retries=<an integer> 默认值:“0”
重新尝试下载错误的最大尝试次数。如果设置为 0,系统会停用重试。
标记: experimental
--experimental_scale_timeouts=<a double> 默认值:“1.0”
按此系数扩缩 Starlark 代码库规则中的所有超时时间。通过这种方式,可以在不更改源代码的情况下使外部代码库在速度低于规则作者的机器上运行。
标记:bazel_internal_configurationexperimental
--http_timeout_scaling=<a double> 默认值:“1.0”
按指定系数调整与 HTTP 下载相关的所有超时
标记: bazel_internal_configuration
--repository_cache=<a path> 默认值:请参阅说明
指定在提取外部代码库期间获取的已下载值的缓存位置。使用空字符串作为参数会请求停用缓存。
标记: bazel_internal_configuration
会影响 Bazel 强制执行有效 build 输入的严格程度的选项(规则定义、标志组合等):
--experimental_repository_hash_file=<a string> 默认值:“”
如果非空,请指定一个包含解析值的文件,应针对该值验证代码库目录哈希值
标记:affects_outputsexperimental
已累计 --experimental_verify_repository_rules=<a string> 次多次使用
如果要验证输出目录的哈希值的代码库规则列表,则要通过 --experimental_repo_hash_file 指定文件。
标记:affects_outputsexperimental
此选项会影响 Starlark 语言或 build 文件、.bzl 文件或 WORKSPACE 文件可访问的 build API 的语义。
--[no]experimental_allow_top_level_aspects_parameters 默认值:“true”
空操作
标记:no_opdeprecatedexperimental
与 Bzlmod 输出和语义相关的选项:
已累计 --allow_yanked_versions=<a string> 次多次使用
以 `<module1>@<version1>,<module2>@<version2>` 的形式指定模块版本,即使这些版本在来源的注册表中被声明了(如果它们不是来自 NonRegistryOverride),也会显示在已解析的依赖关系图中。否则,拉取版本将导致解析失败。您还可以使用 `BZLMOD_ALLOW_YANKED_VERSIONS` 环境变量定义允许的拖动版本。您可以使用关键字“all”停用此检查(不推荐)。
标记: loading_and_analysis
--check_bazel_compatibility=<error, warning or off> 默认值:“error”
检查 Bazel 模块的 Bazel 版本兼容性。有效值包括:“error”表示处理失败,“off”表示停用检查,“warning”表示检测到不匹配的情况时会显示警告。
标记: loading_and_analysis
--check_direct_dependencies=<off, warning or error> 默认值:“警告”
检查根模块中声明的直接“bazel_dep”依赖项是否与已解析的依赖关系图中的版本相同。有效值为 `off` 表示停用检查,`warning` 表示在检测到不匹配的情况时输出警告,或者是 `error`(用于将问题升级为解析失败)。
标记: loading_and_analysis
--[no]ignore_dev_dependency 默认值:“false”
如果为 true,Bazel 会忽略根模块的 MODULE.bazel 中声明为“dev_dependency”的“bazel_dep”和“use_extension”。请注意,无论此标志的值为何,只要不是根模块,MODULE.bazel 中就会始终忽略这些开发者依赖项。
标记: loading_and_analysis
--lockfile_mode=<off, update or error> 默认值:“off”
指定如何以及是否使用锁定文件。有效值包括:“update”表示使用 lockfile 并在发生变更时更新它;“error”表示使用 lockfile,但如果该文件不是最新状态,则会抛出错误;或者“off”表示既不从锁定文件读取数据,也不会向锁定文件写入数据。
标记: loading_and_analysis
已累计 --override_module=<an equals-separated mapping of module name to path> 次多次使用
替换采用 <模块名称>=<path> 形式的本地路径的模块。如果指定路径是绝对路径,系统将按原样使用该路径。如果指定路径是相对路径,则该路径相对于当前工作目录。如果指定路径以“%workspace%”开头,则该路径相对于工作区根目录,即“bazel info workspace”的输出
已累计 --registry=<a string> 次多次使用
指定用于查找 Bazel 模块依赖项的注册表。顺序很重要:系统会先在之前的注册表中查找模块,只有在之前的注册表中缺失模块时,才会回退到靠后的注册表。
标记: changes_inputs
影响日志记录的详细程度、格式或位置的选项:
--dump=<text or raw> [-d] 默认值:请参阅说明
以人类可读的“文本”格式或适合脚本的“原始”格式输出完整的配置文件数据转储。
标记: affects_outputs
--[no]experimental_record_metrics_for_all_mnemonics 默认值:“false”
默认情况下,操作类型的数量不得超过 20 种已执行操作数量最多的助记符。设置此选项会写入所有助记符的统计信息。
用于指定或更改不属于其他类别的 Bazel 命令的通用输入的选项:
--experimental_resolved_file_instead_of_workspace=<a string> 默认值:“”
如果为非空,则读取指定的已解析文件而不是 WORKSPACE 文件
标记: changes_inputs
远程缓存和执行选项:
--experimental_downloader_config=<a string> 默认值:请参阅说明
指定要用于配置远程下载程序的文件。此文件由几行组成,每个行都以指令(“allow”“block”或“rewrite”)开头,后跟主机名(分别用于“allow”和“block”)或两种格式,一种用于匹配,另一种用作替代网址,反向引用从“$1”开始。在这种情况下,系统可能会返回多个“rewrite”指令,供同一个网址提供,在这种情况下,系统会返回多个网址。
其他未分类的选项:
已累计 --override_repository=<an equals-separated mapping of repository name to path> 次多次使用
使用格式为 <repo name>=<path> 的本地路径替换代码库。如果指定路径是绝对路径,系统将按原样使用该路径。如果指定路径是相对路径,则该路径是相对于当前工作目录而言的。如果指定路径以“%workspace%”开头,则该路径相对于工作区根目录,即“bazel info workspace”的输出

Aquery 选项

build 继承所有选项。

出现在命令之前并由客户端解析的选项:
已累计 --distdir=<a path> 次多次使用
在访问网络以下载归档文件之前,可在其他位置搜索归档文件。
标记: bazel_internal_configuration
如果已设置,代码库缓存将在缓存命中时对文件进行硬链接,而不是复制。这是为了节省磁盘空间。
标记: bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id 默认值:“false”
如果为 true,请使用从代码库下载网址派生的字符串作为 canonical_id(如果未指定)。这会导致网址发生变化,进而重新下载,即使缓存中包含具有相同哈希值的下载内容。这可用于验证网址更改不会导致损坏的代码库被缓存遮盖。
标记:loading_and_analysisexperimental
--[no]experimental_repository_disable_download 默认值:“false”
如果设置此参数,则不允许下载外部代码库。
标记: experimental
--experimental_repository_downloader_retries=<an integer> 默认值:“0”
重新尝试下载错误的最大尝试次数。如果设置为 0,系统会停用重试。
标记: experimental
--experimental_scale_timeouts=<a double> 默认值:“1.0”
按此系数扩缩 Starlark 代码库规则中的所有超时时间。通过这种方式,可以在不更改源代码的情况下使外部代码库在速度低于规则作者的机器上运行。
标记:bazel_internal_configurationexperimental
--http_timeout_scaling=<a double> 默认值:“1.0”
按指定系数调整与 HTTP 下载相关的所有超时
标记: bazel_internal_configuration
--repository_cache=<a path> 默认值:请参阅说明
指定在提取外部代码库期间获取的已下载值的缓存位置。使用空字符串作为参数会请求停用缓存。
标记: bazel_internal_configuration
会影响 Bazel 强制执行有效 build 输入的严格程度的选项(规则定义、标志组合等):
--experimental_repository_hash_file=<a string> 默认值:“”
如果非空,请指定一个包含解析值的文件,应针对该值验证代码库目录哈希值
标记:affects_outputsexperimental
已累计 --experimental_verify_repository_rules=<a string> 次多次使用
如果要验证输出目录的哈希值的代码库规则列表,则要通过 --experimental_repo_hash_file 指定文件。
标记:affects_outputsexperimental
此选项会影响 Starlark 语言或 build 文件、.bzl 文件或 WORKSPACE 文件可访问的 build API 的语义。
--[no]experimental_allow_top_level_aspects_parameters 默认值:“true”
空操作
标记:no_opdeprecatedexperimental
与查询输出和语义相关的选项:
--aspect_deps=<off, conservative or precise> 默认值:“conservative”
当输出格式为 {xml,proto,record} 之一时,如何解析切面依赖项。“off”表示不解析任何切面依赖项,“保守”(默认值)表示添加所有已声明的切面依赖关系,而不管它们是否被赋予直接依赖关系的规则类为直接依赖关系,“precise”表示仅添加在直接依赖关系规则类下可能处于活动状态的那些切面。请注意,精确模式需要加载其他软件包来评估单个目标,因此该模式比其他模式慢。另请注意,即使是精确模式也不是完全精确的:是否要计算某个切面的决策是在分析阶段决定的,而不是在“bazel 查询”期间运行。
标记: build_file_semantics
--[no]consistent_labels 默认值:“false”
启用后,每个查询命令都会发出标签,就像通过应用于 <code>Label</code> 实例的 Starlark <code>str</code> 函数发出一样。这对于需要匹配不同查询命令的输出和/或由规则发出的标签生成的工具非常有用。如果未启用,输出格式设置工具可以自由发出明显的仓库名称(相对于主仓库),以使输出更具可读性。
标记: terminal_output
--[no]deduplicate_depsets 默认值:“true”
删除最终 proto/textproto/json 输出中 dep_set_of_files 的重复非叶子项。此操作不会删除未共享直接父级的重复数据集。这不会影响操作的最终有效输入工件列表。
标记: terminal_output
--[no]graph:factored 默认值:“true”
如果为 true,则该图将发出“因式分解”处理,即拓扑相等的节点将合并在一起,其标签将串联起来。此选项仅适用于 --output=graph。
标记: terminal_output
--graph:node_limit=<an integer> 默认值:“512”
输出中图表节点的标签字符串的最大长度。较长的标签将被截断;-1 表示不会被截断。此选项仅适用于 --output=graph。
标记: terminal_output
--[no]implicit_deps 默认值:“true”
启用后,隐式依赖项将包含在执行查询的依赖关系图中。隐式依赖项是指未在 BUILD 文件中明确指定但由 bazel 添加的依赖项。对于 cquery,此选项用于控制过滤已解析的工具链。
标记: build_file_semantics
--[no]include_artifacts 默认值:“true”
在输出中包含操作输入和输出的名称(可能较大)。
标记: terminal_output
--[no]include_aspects 默认值:“true”
aquery、cquery:是否在输出中包含切面生成的操作。query: no-op(始终遵循切面)。
标记: terminal_output
--[no]include_commandline 默认值:“true”
在输出中包含操作命令行的内容(可能很大)。
标记: terminal_output
--[no]include_file_write_contents 默认值:“false”
包含 FileWrite 和 SourceSymlinkManifest 操作(可能很大)的文件内容。
标记: terminal_output
--[no]include_param_files 默认值:“false”
添加命令中使用的参数文件的内容(可能很大)。注意:启用此标志将会自动启用 --include_commandline 标志。
标记: terminal_output
--[no]incompatible_display_source_file_location 默认值:“true”
默认情况下为 true,显示源文件的目标。如果为 true,则显示位置输出中源文件第 1 行的位置。此标志仅用于迁移目的。
标记:terminal_outputincompatible_change
--[no]incompatible_package_group_includes_double_slash 默认值:“true”
如果启用此选项,则输出 package_group 的 `packages` 属性时,前导 `//` 将不会省略。
标记:terminal_outputincompatible_change
--[no]infer_universe_scope 默认值:“false”
如果您设置此参数,并且未设置 --universe_scope,则系统会将“--universe_scope”值推断为查询表达式中唯一目标模式的列表。请注意,针对使用 Universe 范围函数(例如 `allrdeps`)的查询表达式推断出的 --universe_scope 值可能不是您想要的值,因此除非您知道自己正在执行的操作,否则不应使用此选项。如需了解详情和示例,请参阅 https://bazel.build/reference/query#sky-query。如果设置了 --universe_scope,则会忽略此选项的值。注意:此选项仅适用于“query”(即不适用于“cquery”)。
标记:loading_and_analysis
--[no]line_terminator_null 默认值:“false”
每种格式是否以 \0(而非换行符)结束。
标记: terminal_output
--[no]nodep_deps 默认值:“true”
如果启用,则“nodep”属性中的依赖项将包含在执行查询的依赖关系图中。“nodep”属性的一个常见示例是“visibility”。运行并解析“info build-language”的输出,即可了解 build 语言中的所有“nodep”属性。
标记: build_file_semantics
--output=<a string> 默认值:“text”
应以哪种格式输出查询结果。允许的查询值包括:text、textproto、proto、jsonproto。
标记: terminal_output
--[no]proto:default_values 默认值:“true”
如果为 true,则会包含 BUILD 文件中未明确指定值的属性;否则,会忽略这些属性。此选项适用于 --output=proto
标记:terminal_output
--[no]proto:definition_stack 默认值:“false”
填充 Definition_stack proto 字段,在定义规则的类时,为每个规则实例记录 Starlark 调用堆栈。
标记: terminal_output
--[no]proto:flatten_selects 默认值:“true”
启用后,通过 select() 创建的可配置属性将展平。对于列表类型,扁平化表示形式是一个列表,包含选定映射的每个值一次。标量类型会展平为 null。
标记: build_file_semantics
--[no]proto:include_synthetic_attribute_hash 默认值:“false”
是否计算和填充 $internal_attr_hash 属性。
标记: terminal_output
--[no]proto:instantiation_stack 默认值:“false”
填充每条规则的实例化调用堆栈。请注意,这需要有堆栈存在
标记:terminal_output
--[no]proto:locations 默认值:“true”
是否在 proto 输出中输出位置信息。
标记: terminal_output
--proto:output_rule_attrs=<comma-separated list of options> 默认值:“all”
要包含在输出中的属性列表(以英文逗号分隔)。默认值为所有属性。设置为空字符串,不输出任何属性。此选项适用于 --output=proto。
标记: terminal_output
--[no]proto:rule_inputs_and_outputs 默认值:“true”
是否填充 rules_input 和 rules_output 字段。
标记: terminal_output
--query_file=<a string> 默认值:“”
如果设置此参数,查询将从此处指定的文件中(而不是在命令行中)读取查询。在此处指定文件以及通过命令行查询是错误的。
标记: changes_inputs
--[no]relative_locations 默认值:“false”
如果为 true,则 BUILD 文件在 xml 和 proto 输出中的位置将是相对的。默认情况下,位置输出是绝对路径,在不同机器中不一致。您可以将此选项设置为 true,以便在不同机器上获得一致的结果。
标记: terminal_output
--[no]skyframe_state 默认值:“false”
从 Skyframe 中转储当前的操作图,而无需执行额外的分析。注意:目前不支持使用 --skyframe_state 指定目标。此标志仅适用于 --output=proto 或 --output=textproto。
标记: terminal_output
--[no]tool_deps 默认值:“true”
查询:如果停用,对“主机配置”或“执行”目标的依赖关系将不会包含在执行查询的依赖关系图中。“主机配置”依赖项边缘(例如从任何“proto_library”规则到协议编译器的依赖项边缘)通常指向在构建期间执行的工具,而不是同一“目标”程序的一部分。 Cquery:如果停用,则会从发现此已配置目标的顶级目标中过滤掉所有跨主机或执行转换的已配置目标。这意味着,如果顶级目标位于目标配置中,则将仅返回同样位于目标配置中的已配置目标。如果顶级目标位于主机配置中,则系统将仅返回主机配置的目标。此选项不会排除已解析的工具链。
标记: build_file_semantics
--universe_scope=<comma-separated list of options> 默认值:“”
一组以英文逗号分隔的目标模式(加法和减法)。此查询可以在由指定目标的传递闭合定义的宇宙中执行。此选项用于 query 和 cquery 命令。 对于 cquery,此选项的输入是构建所有答案的目标,因此此选项可能会影响配置和转换。如果未指定此选项,系统会假定顶级目标是通过查询表达式解析的目标。注意:对于 cquery,如果无法使用顶级选项构建从查询表达式解析的目标,则不指定此选项可能会导致构建中断。
标记: loading_and_analysis
与 Bzlmod 输出和语义相关的选项:
已累计 --allow_yanked_versions=<a string> 次多次使用
以 `<module1>@<version1>,<module2>@<version2>` 的形式指定模块版本,即使这些版本在来源的注册表中被声明了(如果它们不是来自 NonRegistryOverride),也会显示在已解析的依赖关系图中。否则,拉取版本将导致解析失败。您还可以使用 `BZLMOD_ALLOW_YANKED_VERSIONS` 环境变量定义允许的拖动版本。您可以使用关键字“all”停用此检查(不推荐)。
标记: loading_and_analysis
--check_bazel_compatibility=<error, warning or off> 默认值:“error”
检查 Bazel 模块的 Bazel 版本兼容性。有效值包括:“error”表示处理失败,“off”表示停用检查,“warning”表示检测到不匹配的情况时会显示警告。
标记: loading_and_analysis
--check_direct_dependencies=<off, warning or error> 默认值:“警告”
检查根模块中声明的直接“bazel_dep”依赖项是否与已解析的依赖关系图中的版本相同。有效值为 `off` 表示停用检查,`warning` 表示在检测到不匹配的情况时输出警告,或者是 `error`(用于将问题升级为解析失败)。
标记: loading_and_analysis
--[no]ignore_dev_dependency 默认值:“false”
如果为 true,Bazel 会忽略根模块的 MODULE.bazel 中声明为“dev_dependency”的“bazel_dep”和“use_extension”。请注意,无论此标志的值为何,只要不是根模块,MODULE.bazel 中就会始终忽略这些开发者依赖项。
标记: loading_and_analysis
--lockfile_mode=<off, update or error> 默认值:“off”
指定如何以及是否使用锁定文件。有效值包括:“update”表示使用 lockfile 并在发生变更时更新它;“error”表示使用 lockfile,但如果该文件不是最新状态,则会抛出错误;或者“off”表示既不从锁定文件读取数据,也不会向锁定文件写入数据。
标记: loading_and_analysis
已累计 --override_module=<an equals-separated mapping of module name to path> 次多次使用
替换采用 <模块名称>=<path> 形式的本地路径的模块。如果指定路径是绝对路径,系统将按原样使用该路径。如果指定路径是相对路径,则该路径相对于当前工作目录。如果指定路径以“%workspace%”开头,则该路径相对于工作区根目录,即“bazel info workspace”的输出
已累计 --registry=<a string> 次多次使用
指定用于查找 Bazel 模块依赖项的注册表。顺序很重要:系统会先在之前的注册表中查找模块,只有在之前的注册表中缺失模块时,才会回退到靠后的注册表。
标记: changes_inputs
影响日志记录的详细程度、格式或位置的选项:
--[no]experimental_record_metrics_for_all_mnemonics 默认值:“false”
默认情况下,操作类型的数量不得超过 20 种已执行操作数量最多的助记符。设置此选项会写入所有助记符的统计信息。
用于指定或更改不属于其他类别的 Bazel 命令的通用输入的选项:
--experimental_resolved_file_instead_of_workspace=<a string> 默认值:“”
如果为非空,则读取指定的已解析文件而不是 WORKSPACE 文件
标记: changes_inputs
远程缓存和执行选项:
--experimental_downloader_config=<a string> 默认值:请参阅说明
指定要用于配置远程下载程序的文件。此文件由几行组成,每个行都以指令(“allow”“block”或“rewrite”)开头,后跟主机名(分别用于“allow”和“block”)或两种格式,一种用于匹配,另一种用作替代网址,反向引用从“$1”开始。在这种情况下,系统可能会返回多个“rewrite”指令,供同一个网址提供,在这种情况下,系统会返回多个网址。
其他未分类的选项:
已累计 --override_repository=<an equals-separated mapping of repository name to path> 次多次使用
使用格式为 <repo name>=<path> 的本地路径替换代码库。如果指定路径是绝对路径,系统将按原样使用该路径。如果指定路径是相对路径,则该路径是相对于当前工作目录而言的。如果指定路径以“%workspace%”开头,则该路径相对于工作区根目录,即“bazel info workspace”的输出
用于控制构建执行的选项:
是否通过直接文件系统调用来创建符号链接树
标记:loading_and_analysisexecutionexperimental
--[no]experimental_remotable_source_manifests 默认值:“false”
是否将源清单操作设为远程
标记:loading_and_analysisexecutionexperimental
--[no]experimental_split_coverage_postprocessing 默认值:“false”
如果为 true,Bazel 会运行覆盖率后处理,以便在新生成中进行测试。
标记: execution
--[no]experimental_strict_fileset_output 默认值:“false”
如果启用此选项,文件集会将所有输出工件视为常规文件。它们不会遍历目录,也不会对符号链接敏感。
标记: execution
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...> 默认值:“”
根据操作助记符在操作的执行信息中添加或移除键。仅适用于支持执行信息的操作。许多常用操作都支持执行信息,例如 Genrule、CppCompile、Javac、StarlarkAction、TestRunner。在指定多个值时,顺序很重要,因为多个正则表达式可能适用于同一助记符。 语法:“regex=[+-]key,regex=[+-]key,...”。 示例: “.*=+x,.*=-y,.*=+z”会在所有操作的执行信息中添加“x”和“z”,并从中移除“y”。“Genrule=+如果需要-x”会将“require-x”添加到所有 Genrule 操作的执行信息中。'(?!Genrule).*=- requires-x' 从所有非 Genrule 操作的执行信息中移除“need-x”。
标记:executionaffects_outputsloading_and_analysis
--persistent_android_dex_desugar
使用 worker 启用永久性 Android dex 和脱糖操作。
会展开为:
  --internal_persistent_android_dex_desugar
  --strategy=Desugar=worker
  --strategy=DexBuilder=worker

标记:host_machine_resource_optimizationsexecution
--persistent_android_resource_processor
使用 worker 启用永久性 Android 资源处理器。
展开为:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
--strategy=Aapt2Optimize=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=workerhost_machine_resource_optimizationsexecution
--persistent_multiplex_android_dex_desugar
使用 worker 启用永久性多路复用 Android dex 和脱糖操作。
扩展为:
  --persistent_android_dex_desugar
  --internal_persistent_multiplex_android_dex_desugar

标记:host_machine_resource_optimizationsexecution
--persistent_multiplex_android_resource_processor
使用工作器启用永久性多路复用 Android 资源处理器。
展开为:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workershost_machine_resource_optimizationsexecution
--persistent_multiplex_android_tools
启用持久性和多路复用 Android 工具(dex 处理、脱糖和资源处理)。
展开为:
  --internal_persistent_multiplex_busybox_tools
  --persistent_multiplex_android_resource_processor
  --persistent_multiplex_android_dex_desugar

标记:host_machine_resource_optimizationsexecution
用于配置用于执行操作的工具链的选项:
--android_compiler=<a string> 默认值:请参阅说明
Android 目标编译器。
标记:affects_outputsloading_and_analysisloses_incremental_state
--android_crosstool_top=<a build target label> 默认值:“//external:android/crosstool”
用于 Android build 的 C++ 编译器的位置。
标记:affects_outputschanges_inputsloading_and_analysisloses_incremental_state
--android_grte_top=<a label> 默认值:请参阅说明
Android 目标 grte_top。
标记:changes_inputsloading_and_analysisloses_incremental_state
--android_manifest_merger=<legacy, android or force_android> 默认值:“android”
选择要用于 android_binary 规则的清单合并程序。用于帮助从旧版合并程序过渡到 Android 清单合并程序的标志。
标记:affects_outputsloading_and_analysisloses_incremental_state
--android_platforms=<a build target label> 默认值:“”
设置 android_binary 目标使用的平台。如果指定了多个平台,则二进制文件是一个胖 APK,其中包含每个指定目标平台的原生二进制文件。
标记:changes_inputsloading_and_analysisloses_incremental_state
--android_sdk=<a build target label> 默认值:“@bazel_tools//tools/android:sdk”
指定用于构建 Android 应用的 Android SDK/平台。
标记:changes_inputsloading_and_analysisloses_incremental_state
--apple_compiler=<a string> 默认值:请参阅说明
Apple 目标编译器。用于选择工具链的变体(例如 xcode-beta)。
标记:affects_outputsloading_and_analysisloses_incremental_state
--apple_crosstool_top=<a build target label> 默认值:“@bazel_tools//tools/cpp:toolchain”
要在 Apple 和 Objc 规则中使用的交叉工具软件包的标签及其依赖项。
标记:loses_incremental_statechanges_inputs
--apple_grte_top=<a build target label> 默认值:请参阅说明
Apple 目标 grte_top。
标记:changes_inputsloading_and_analysisloses_incremental_state
--cc_output_directory_tag=<a string> 默认值:“”
指定要添加到配置目录的后缀。
标记:affects_outputsexplicit_in_output_path
--compiler=<a string> 默认值:请参阅说明
用于编译目标的 C++ 编译器。
标记:loading_and_analysisexecution
--coverage_output_generator=<a build target label> 默认值:“@bazel_tools//tools/test:lcov_merger”
用于对原始覆盖率报告进行后处理的二进制文件的位置。目前,此值必须是包含单个文件(二进制文件)的文件组。默认值为“//tools/test:lcov_merger”。
标记:changes_inputsaffects_outputsloading_and_analysis
--coverage_report_generator=<a build target label> 默认值:“@bazel_tools//tools/test:coverage_report_generator”
用于生成覆盖率报告的二进制文件的位置。目前,此值必须是包含单个文件(二进制文件)的文件组。默认值为“//tools/test:coverage_report_generator”。
标记:changes_inputsaffects_outputsloading_and_analysis
--coverage_support=<a build target label> 默认值:“@bazel_tools//tools/test:coverage_support”
每个收集代码覆盖率的测试操作输入到的地方都需要支持文件的位置。默认值为“//tools/test:coverage_support”。
标记:changes_inputsaffects_outputsloading_and_analysis
--crosstool_top=<a build target label> 默认值:“@bazel_tools//tools/cpp:toolchain”
用于编译 C++ 代码的 crosstool 软件包标签。
标记:loading_and_analysischanges_inputsaffects_outputs
--custom_malloc=<a build target label> 默认值:请参阅说明
指定自定义 malloc 实现。此设置会覆盖构建规则中的 malloc 属性。
标记:changes_inputsaffects_outputs
已累计 --experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment> 次多次使用
以英文逗号分隔的正则表达式列表,每个表达式可以选择带有 -(否定表达式)前缀,并将 (=) 赋值给一系列以英文逗号分隔的约束值目标。如果目标没有与负表达式匹配,且至少有一个正表达式,则系统将执行其工具链解析,就像其已将约束值声明为执行约束条件一样。示例://demo,-test=@platforms//cpus:x86_64 会将“x86_64”添加到 //demo 下的任何目标(名称中包含“test”的目标除外)。
标记: loading_and_analysis
--[no]experimental_enable_objc_cc_deps 默认值:“true”
允许 objc_* 规则依赖于 cc_library,并使得针对 --ios_multi_cpu 中的任何值,在构建任何 objc 依赖项时将 --cpu 设置为“ios_<--ios_cpu>”。
标记:loading_and_analysisincompatible_change
--[no]experimental_include_xcode_execution_requirements 默认值:“false”
如果已设置,则向每项 Xcode 操作添加“require-xcode:{version}”的执行要求。如果 Xcode 版本带有带连字符的标签,请同时添加“required-xcode-label:{version_label}”执行要求。
标记:loses_incremental_stateloading_and_analysisexecution
--[no]experimental_prefer_mutual_xcode 默认值:“true”
如果为 true,请使用可在本地和远程访问的最新 Xcode。如果为 false,或者没有相互可用的版本,请使用通过 xcode-select 选择的本地 Xcode 版本。
标记: loses_incremental_state
已累计 --extra_execution_platforms=<comma-separated list of options> 次多次使用
可用作执行操作的执行平台的平台。平台可以按确切目标指定,也可以指定为目标模式。系统会先考虑这些平台,然后再考虑由 register_execution_platforms() 在 WORKSPACE 文件中声明的平台。
标记:execution
已累计 --extra_toolchains=<comma-separated list of options> 次多次使用
在工具链解析期间要考虑的工具链规则。工具链可以按确切目标指定,也可以指定为目标模式。系统会先考虑这些工具链,然后再考虑由 register_toolchains() 在 WORKSPACE 文件中声明的那些工具链。
标记:affects_outputschanges_inputsloading_and_analysis
--grte_top=<a label> 默认值:请参阅说明
已签入的 libc 库的标签。默认值由交叉工具工具链选择,您几乎永远不需要替换它。
标记:action_command_linesaffects_outputs
--host_compiler=<a string> 默认值:请参阅说明
用于主机编译的 C++ 编译器。如果未设置 --host_crosstool_top,则忽略该标志。
标记:loading_and_analysisexecution
--host_crosstool_top=<a build target label> 默认值:请参阅说明
默认情况下,--crosstool_top 和 --compiler 选项也会用于主机配置。如果提供此标志,Bazel 会针对给定 crosstool_top 使用默认 libc 和编译器。
标记:loading_and_analysischanges_inputsaffects_outputs
--host_grte_top=<a label> 默认值:请参阅说明
如果指定,此设置会覆盖主机配置的 libc 顶级目录 (--grte_top)。
标记:action_command_linesaffects_outputs
--host_platform=<a build target label> 默认值:“”
描述主机系统的平台规则标签。
标记:affects_outputschanges_inputsloading_and_analysis
--[no]incompatible_disable_expand_if_all_available_in_flag_set 默认值:“true”
如果为 true,Bazel 将不允许在 flag_sets 中指定 expand_if_all_available(如需了解迁移说明,请参阅 https://github.com/bazelbuild/bazel/issues/7008)。
标记:loading_and_analysisincompatible_change
--[no]incompatible_dont_enable_host_nonhost_crosstool_features 默认值:“true”
如果为 true,Bazel 不会在 C++ 工具链中启用“host”和“nonhost”功能(如需了解详情,请参阅 https://github.com/bazelbuild/bazel/issues/7407)。
标记:loading_and_analysisincompatible_change
--[no]incompatible_enable_android_toolchain_resolution 默认值:“false”
使用工具链解析选择 Android SDK for Android 规则(Starlark 和原生)
标记:loading_and_analysisincompatible_change
--[no]incompatible_enable_apple_toolchain_resolution 默认值:“false”
使用工具链解析选择 Apple SDK for Apple 规则(Starlark 和原生)
标记:loading_and_analysisincompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone 默认值:“true”
如果为 true,Bazel 不会将 C++ 链接操作命令行重复用于 lto 索引命令行(如需了解详情,请参阅 https://github.com/bazelbuild/bazel/issues/6791)。
标记:loading_and_analysisincompatible_change
--[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain 默认值:“true”
如果为 true,则设置 cc_toolchain.cpu 和 cc_toolchain.compiler 属性后,Bazel 会发出错误提示(有关迁移说明,请参阅 https://github.com/bazelbuild/bazel/issues/7075)。
标记:loading_and_analysisincompatible_change
--[no]incompatible_remove_legacy_whole_archive 默认值:“true”
如果为 true,则默认情况下,Bazel 不会将库依赖项链接到整个归档(如需了解迁移说明,请参阅 https://github.com/bazelbuild/bazel/issues/7362)。
标记:loading_and_analysisincompatible_change
--[no]incompatible_require_ctx_in_configure_features 默认值:“true”
如果为 true,则 Bazel 将需要在 cc_common.configure_features 中请求“时长”参数(如需了解详情,请参阅 https://github.com/bazelbuild/bazel/issues/7793)。
标记:loading_and_analysisincompatible_change
--[no]interface_shared_objects 默认值:“true”
如果工具链支持,请使用接口共享对象。目前,所有 ELF 工具链都支持此设置。
标记:loading_and_analysisaffects_outputsaffects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> 默认值:请参阅说明
指定用于构建 iOS 应用的 iOS SDK 版本。如果未指定,则使用“xcode_version”中的默认 iOS SDK 版本。
标记: loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> 默认值:请参阅说明
指定用于构建 macOS 应用的 macOS SDK 版本。如果未指定,则使用“xcode_version”中的默认 macOS SDK 版本。
标记: loses_incremental_state
--minimum_os_version=<a string> 默认值:请参阅说明
编译的目标最低操作系统版本。
标记:loading_and_analysisaffects_outputs
--platform_mappings=<a relative path> 默认值:“”
映射文件的位置,用于说明在未设置平台时应使用哪个平台,或在平台已存在时要设置哪些标志。必须相对于主工作区根目录。默认为“platform_mappings”(位于工作区根目录正下方的文件)。
标记:affects_outputschanges_inputsloading_and_analysis
--platforms=<a build target label> 默认值:“”
用于描述当前命令的目标平台的平台规则标签。
标记:affects_outputschanges_inputsloading_and_analysis
--python2_path=<a string> 默认值:请参阅说明
已废弃,空操作。已被“--incompatible_use_python_toolchains”停用。
标记:no_opdeprecated
--python3_path=<a string> 默认值:请参阅说明
已废弃,空操作。已被“--incompatible_use_python_toolchains”停用。
标记:no_opdeprecated
--python_path=<a string> 默认值:请参阅说明
为在目标平台上运行 Python 目标而调用的 Python 解释器的绝对路径。已弃用;已由 --incompatible_use_python_toolchains 停用。
标记:loading_and_analysisaffects_outputs
--python_top=<a build target label> 默认值:请参阅说明
py_runtime 的标签,表示为在目标平台上运行 Python 目标而调用的 Python 解释器。已弃用;已由 --incompatible_use_python_toolchains 停用。
标记:loading_and_analysisaffects_outputs
--target_platform_fallback=<a build target label> 默认值:“@local_config_platform//:host”
未设置目标平台且没有与当前标志集匹配的平台映射时应使用的平台规则标签。
标记:affects_outputschanges_inputsloading_and_analysis
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> 默认值:请参阅说明
指定用于构建 tvOS 应用的 tvOS SDK 版本。如果未指定,则使用“xcode_version”中的默认 tvOS SDK 版本。
标记: loses_incremental_state
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> 默认值:请参阅说明
指定用于构建 watchOS 应用的 watchOS SDK 版本。如果未指定,则使用“xcode_version”中的默认 watchOS SDK 版本。
标记: loses_incremental_state
--xcode_version=<a string> 默认值:请参阅说明
如果指定,则将给定版本的 Xcode 用于相关构建操作。如果未指定,则使用 Xcode 的执行程序默认版本。
标记: loses_incremental_state
--xcode_version_config=<a build target label> 默认值:“@bazel_tools//tools/cpp:host_xcodes”
xcode_config 规则的标签,用于在 build 配置中选择 Xcode 版本。
标记:loses_incremental_stateloading_and_analysis
用于控制命令输出的选项:
--[no]apple_enable_auto_dsym_dbg 默认值:“false”
是否强制启用为 dbg build 生成调试符号 (.dSYM) 文件的功能。
标记:affects_outputsaction_command_lines
--[no]apple_generate_dsym 默认值:“false”
是否生成调试符号 (.dSYM) 文件。
标记:affects_outputsaction_command_lines
如果为 true,则为所有目标构建 runfiles 符号链接林。如果为 false,请尽可能只写入清单。
标记: affects_outputs
--[no]build_runfile_manifests 默认值:“true”
如果为 true,则为所有目标编写 runfile 清单。如果为 false,请忽略它们。如果值为 false,本地测试将无法运行。
标记: affects_outputs
--[no]build_test_dwp 默认值:“false”
启用后,在以静态方式构建 C++ 测试时以及在 Fission 处打开时,系统也会自动构建测试二进制文件的 .dwp 文件。
标记:loading_and_analysisaffects_outputs
--cc_proto_library_header_suffixes=<comma-separated list of options> 默认值:“.pb.h”
设置 cc_proto_library 创建的头文件的前缀。
标记:affects_outputsloading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated list of options> 默认值:“.pb.cc”
设置 cc_proto_library 创建的源文件的前缀。
标记:affects_outputsloading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info 默认值:“false”
针对 proto_library 中的备用 Java API 版本运行额外操作。
标记:affects_outputsloading_and_analysisexperimental
--[no]experimental_proto_extra_actions 默认值:“false”
针对 proto_library 中的备用 Java API 版本运行额外操作。
标记:affects_outputsloading_and_analysisexperimental
--[no]experimental_save_feature_state 默认值:“false”
将启用和已请求功能的状态保存为编译的输出。
标记:affects_outputsexperimental
--fission=<a set of compilation modes> 默认值:“no”
指定哪些编译模式对 C++ 编译和链接使用断点。可以是 {'fastbuild', 'dbg', 'opt'} 的任意组合,也可以是特殊值:'yes'(用于启用所有模式)和 'no'(用于停用所有模式)。
标记:loading_and_analysisaction_command_linesaffects_outputs
--[no]incompatible_always_include_files_in_data 默认值:“true”
如果为 true,原生规则会将数据依赖项的 <code>DefaultInfo.files</code> 添加到其 runfile 中,这与 Starlark 规则的建议行为一致 (https://bazel.build/extending/rules#runfiles_features_to_avoid)。
标记:affects_outputsincompatible_change
--[no]legacy_external_runfiles 默认值:“true”
如果为 true,则为 .runfiles/wsname/external/repo(以及 .runfiles/repo)下的外部代码库构建 runfiles 符号链接林。
标记: affects_outputs
--[no]objc_generate_linkmap 默认值:“false”
指定是否生成链接映射文件。
标记: affects_outputs
--[no]save_temps 默认值:“false”
如果设置此参数,系统会保存 gcc 的临时输出。其中包括 .s 文件(编译器代码)、.i 文件(经过预处理的 C)和 .ii 文件(经过预处理的 C++)。
标记: affects_outputs
可让用户配置预期输出的选项,以影响预期输出的值,而非影响其存在性:
已累计 --action_env=<a 'name=value' assignment with an optional value part> 次多次使用
指定可用于具有目标配置的操作的一组环境变量。变量可以按名称指定(在这种情况下,值将从调用环境中获取),也可以通过 name=value 对(其值独立于调用环境设置)指定。此选项可以多次使用;对于同一变量提供的选项,系统会汇总最后胜出的选项。
标记: action_command_lines
--android_cpu=<a string> 默认值:“armeabi-v7a”
Android 目标 CPU。
标记:affects_outputsloading_and_analysisloses_incremental_state
--[no]android_databinding_use_androidx 默认值:“false”
生成与 AndroidX 兼容的数据绑定文件。这仅适用于数据绑定 v2。
标记:affects_outputsloading_and_analysisloses_incremental_stateexperimental
--[no]android_databinding_use_v3_4_args 默认值:“false”
使用带有 3.4.0 参数的 Android 数据绑定 v2
标记:affects_outputsloading_and_analysisloses_incremental_stateexperimental
--android_dynamic_mode=<off, default or fully> 默认值:“off”
确定当 cc_binary 未明确创建共享库时,是否要动态关联 Android 规则的 C++ 依赖项。“default”表示 bazel 将选择是否动态链接。“full”表示将动态地链接所有库。“off”表示所有库都将在基本静态模式下链接。
标记:affects_outputsloading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency> 默认值:“按字母顺序排列”
设置传递给 Android 二进制文件的清单合并程序的清单的顺序。ALPHABETIAL 表示清单按相对于 execroot 的路径进行排序。ALPHABETIVE_BY_CONFIGURATION 表示清单按相对于输出目录中配置目录的路径进行排序。DEPENDENCY 表示清单排序,每个库的清单排在其依赖项的清单之前。
标记:action_command_linesexecution
--[no]android_resource_shrinking 默认值:“false”
为使用 ProGuard 的 android_binary APK 启用资源缩减。
标记:affects_outputsloading_and_analysis
已累计 --apple_bitcode=<'mode' or 'platform=mode', where 'mode' is none, embedded_markers or embedded, and 'platform' is ios, visionos, watchos, tvos, macos or catalyst> 次多次使用
为针对设备架构的编译步骤指定 Apple 位码模式。值的格式为“[platform=]mode”,其中平台(必须为“ios”“macos”“tvos”或“watchos”)是可选的。如果提供位码模式,则专门针对该平台应用位码模式;如果省略,则将应用于所有平台。模式必须为“none”“embedded_markers”或“embedded”。此选项可能会提供多次。
标记: loses_incremental_state
--[no]build_python_zip 默认值:“auto”
构建 Python 可执行 zip 文件;在 Windows 上,在其他平台上关闭
标记: affects_outputs
已累计 --catalyst_cpus=<comma-separated list of options> 次多次使用
要为其构建 Apple Catalyst 二进制文件的架构列表(以英文逗号分隔)。
标记:loses_incremental_stateloading_and_analysis
--[no]collect_code_coverage 默认值:“false”
如果指定,Bazel 将对代码进行插桩处理(尽可能使用离线插桩),并在测试期间收集覆盖率信息。只有与“Instrumentation_filter”匹配的目标会受到影响。通常,不应直接指定此选项,应改用“bazelCoverage”命令。
标记: affects_outputs
--compilation_mode=<fastbuild, dbg or opt> [-c] 默认值:“fastbuild”
指定将在其中构建二进制文件的模式。值:“fastbuild”、“dbg”、“opt”。
标记:affects_outputsaction_command_linesexplicit_in_output_path
已累计 --conlyopt=<a string> 次多次使用
编译 C 源文件时要传递给 gcc 的附加选项。
标记:action_command_linesaffects_outputs
已累计 --copt=<a string> 次多次使用
可传递给 gcc 的其他选项。
标记:action_command_linesaffects_outputs
--cpu=<a string> 默认值:“”
目标 CPU。
标记:changes_inputsaffects_outputsexplicit_in_output_path
--cs_fdo_absolute_path=<a string> 默认值:请参阅说明
使用 CSFDO 配置文件信息优化编译。指定包含配置文件(原始或编入索引的 LLVM 配置文件)的 ZIP 文件的绝对路径名称。
标记: affects_outputs
--cs_fdo_instrument=<a string> 默认值:请参阅说明
使用上下文敏感 FDO 插桩生成二进制文件。使用 Clang/LLVM 编译器,它也接受在运行时转储原始配置文件所在的目录名称。
标记: affects_outputs
--cs_fdo_profile=<a build target label> 默认值:请参阅说明
cs_fdo_profile,表示要用于优化的上下文相关配置文件。
标记: affects_outputs
已累计 --cxxopt=<a string> 次多次使用
编译 C++ 源文件时要传递给 gcc 的附加选项。
标记:action_command_linesaffects_outputs
已累计 --define=<a 'name=value' assignment> 次多次使用
每个 --define 选项均可为 build 变量指定一个赋值。
标记:changes_inputsaffects_outputs
--dynamic_mode=<off, default or fully> 默认值:“default”
确定是否要动态链接 C++ 二进制文件。“default”表示 Bazel 将选择是否动态链接。“full”表示将动态地链接所有库。“off”表示所有库都将在基本静态模式下链接。
标记:loading_and_analysisaffects_outputs
--[no]enable_fdo_profile_absolute_path 默认值:“true”
如果设置此参数,使用 fdo_absolute_profile_path 会引发错误。
标记: affects_outputs
--[no]enable_runfiles 默认值:“auto”
启用 runfiles 符号链接树;默认情况下,此设置在 Windows 和其他平台上处于关闭状态。
标记: affects_outputs
已累计 --experimental_action_listener=<a build target label> 次多次使用
废弃了,取而代之的是切面。使用 action_listener 将 extra_action 附加到现有构建操作。
标记:executionexperimental
--[no]experimental_android_compress_java_resources 默认值:“false”
压缩 APK 中的 Java 资源
标记:affects_outputsloading_and_analysisexperimental
--[no]experimental_android_databinding_v2 默认值:“false”
使用 Android 数据绑定 v2
标记:affects_outputsloading_and_analysisloses_incremental_stateexperimental
--[no]experimental_android_resource_shrinking 默认值:“false”
为使用 ProGuard 的 android_binary APK 启用资源缩减。
标记:affects_outputsloading_and_analysis
--[no]experimental_android_rewrite_dexes_with_rex 默认值:“false”
使用 rex 工具重写 dex 文件
标记:affects_outputsloading_and_analysisloses_incremental_stateexperimental
--[no]experimental_collect_code_coverage_for_generated_files 默认值:“false”
如果指定,Bazel 还将为生成的文件生成收集覆盖率信息。
标记: affects_outputs
--experimental_objc_fastbuild_options=<comma-separated list of options> 默认值:“-O0,-DDEBUG=1”
使用这些字符串作为 objc quickbuild 编译器选项。
标记: action_command_lines
--[no]experimental_omitfp 默认值:“false”
如果为 true,则使用 libunwind 进行堆栈展开,并使用 -fomit-frame-pointer 和 -faSYNC-unwind-tables 进行编译。
标记:action_command_linesaffects_outputsexperimental
--[no]experimental_platform_in_output_dir 默认值:“false”
如果为 true,则输出目录名称中使用目标平台(而非 CPU)。
标记:affects_outputsexperimental
--[no]experimental_use_llvm_covmap 默认值:“false”
如果指定,则启用 collect_code_coverage 时,Bazel 将生成 llvm-cov 覆盖范围地图信息,而不是 gcov。
标记:changes_inputsaffects_outputsloading_and_analysisexperimental
--fat_apk_cpu=<comma-separated list of options> 默认值:“armeabi-v7a”
设置此选项会启用胖 APK,其中包含适用于所有指定目标架构的原生二进制文件,例如--fat_apk_cpu=x86,armeabi-v7a. 如果指定此标志,对于 android_binary 规则的依赖项,系统会忽略 --android_cpu。
标记:affects_outputsloading_and_analysisloses_incremental_state
--[no]fat_apk_hwasan 默认值:“false”
是否创建 HWASAN 分块。
标记:affects_outputsloading_and_analysisloses_incremental_state
--fdo_instrument=<a string> 默认值:请参阅说明
使用 FDO 插桩生成二进制文件。使用 Clang/LLVM 编译器,它也接受在运行时转储原始配置文件所在的目录名称。
标记: affects_outputs
--fdo_optimize=<a string> 默认值:请参阅说明
使用 FDO 配置文件信息优化编译。指定包含 .gcda 文件树的 zip 文件的名称、包含自动配置文件的 afdo 文件或 LLVM 配置文件的名称。此标志还接受指定为标签的文件(例如 `//foo/bar:file.afdo` - 您可能需要向相应的软件包添加 `exports_files` 指令)以及指向 `fdo_profile` 目标的标签。此标志将由“fdo_profile”规则取代。
标记: affects_outputs
--fdo_prefetch_hints=<a build target label> 默认值:请参阅说明
使用缓存预提取提示。
标记: affects_outputs
--fdo_profile=<a build target label> 默认值:请参阅说明
fdo_profile,表示要用于优化的配置文件。
标记: affects_outputs
已累计 --features=<a string> 次多次使用
对于目标配置中构建的目标,系统会默认启用或停用指定功能。指定 -<feature> 将停用该功能。负面特征始终会覆盖正特征。另请参阅 --host_features
标记:changes_inputsaffects_outputs
--[no]force_pic 默认值:“false”
启用后,所有 C++ 编译都会生成位置无关代码(“-fPIC”),链接首选 PIC 预构建库而非非 PIC 库,而链接会生成位置独立的可执行文件(“-pie”)。
标记:loading_and_analysisaffects_outputs
已累计 --host_action_env=<a 'name=value' assignment with an optional value part> 次多次使用
指定可用于具有主机或执行配置的操作的一组环境变量。变量可以按名称指定(在这种情况下,值将从调用环境中获取),也可以通过 name=value 对(其值独立于调用环境设置)指定。此选项可以多次使用;对于同一变量提供的选项,系统会汇总最后胜出的选项。
标记: action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt> 默认值:“opt”
指定构建期间要使用的工具的模式。值:“fastbuild”、“dbg”、“opt”。
标记:affects_outputsaction_command_lines
已累计 --host_conlyopt=<a string> 次多次使用
为主机工具编译 C 源文件时传递给 gcc 的附加选项。
标记:action_command_linesaffects_outputs
已累计 --host_copt=<a string> 次多次使用
传递给主机工具的 gcc 的其他选项。
标记:action_command_linesaffects_outputs
--host_cpu=<a string> 默认值:“”
主机 CPU。
标记:changes_inputsaffects_outputs
已累计 --host_cxxopt=<a string> 次多次使用
传递给主机工具的 gcc 的其他选项。
标记:action_command_linesaffects_outputs
已累计 --host_features=<a string> 次多次使用
对于 exec 配置中构建的目标,系统会默认启用或停用给定功能。指定 -<feature> 将停用该功能。负特征始终会覆盖正特征。
标记:changes_inputsaffects_outputs
--host_force_python=<PY2 or PY3> 默认值:请参阅说明
覆盖主机配置的 Python 版本。可以是“PY2”或“PY3”。
标记:loading_and_analysisaffects_outputs
已累计 --host_linkopt=<a string> 次多次使用
在关联主机工具时传递给 gcc 的附加选项。
标记:action_command_linesaffects_outputs
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> 默认值:请参阅说明
主机目标的最低兼容 macOS 版本。如果未指定,则使用“macos_sdk_version”。
标记: loses_incremental_state
已累计 --host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options> 次多次使用
在主机或 exec 配置中编译某些文件时,可选择性地传递给 C/C++ 编译器的其他选项。可以多次传递此选项。语法:regex_filter@option_1,option_2,...,option_n。其中,regex_filter 代表包含和排除正则表达式模式的列表(另请参阅 --instrumentation_filter)。 option_1 到 option_n 代表任意命令行选项。如果选项中包含英文逗号,则必须使用反斜杠将其括起来。选项可以包含 @。只有第一个 @ 用于拆分字符串。示例:--host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 向 //foo/(bar.cc 除外)中所有 cc 文件的 gcc 命令行添加 -O0 命令行选项。
标记:action_command_linesaffects_outputs
已累计 --host_swiftcopt=<a string> 次多次使用
为主机工具传递给 swiftc 的其他选项。
标记:action_command_linesaffects_outputs
--[no]incompatible_avoid_conflict_dlls 默认值:“true”
启用后,Windows 上的 cc_library 生成的所有 C++ 动态链接库 (DLL) 都将重命名为 name_{hash}.dll,其中哈希值根据 RepositoryName 和 DLL 的软件包路径计算。如果您有一个软件包依赖于多个同名的 cc_library(例如 //foo/bar1:utils 和 //foo/bar2:utils),则此选项非常有用。
标记:loading_and_analysisaffects_outputsincompatible_change
--[no]incompatible_merge_genfiles_directory 默认值:“true”
如果为 true,genfiles 目录会折叠到 bin 目录中。
标记:affects_outputsincompatible_change
--[no]incompatible_use_host_features 默认值:“false”
如果为 true,则仅对目标配置使用 --features,针对 exec 配置使用 --host_features。
标记:changes_inputsaffects_outputsincompatible_change
--[no]incompatible_use_platforms_repo_for_constraints 默认值:“true”
如果为 true,系统会移除 @bazel_tools 中的限制条件设置。
标记:affects_outputsincompatible_change
--[no]instrument_test_targets 默认值:“false”
启用覆盖率后,指定是否考虑对测试规则进行插桩测试。设置后,将对 --instrumentation_filter 包含的测试规则进行插桩处理。否则,测试规则始终会从覆盖范围插桩中排除。
标记: affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths> 默认值:“-/javatests[/:],-/test/java[/:]”
启用覆盖率后,系统只会对名称中包含指定基于正则表达式的过滤器的规则进行插桩处理。前缀为“-”的规则将被排除。请注意,除非启用了 --instrument_test_targets,否则只能对非测试规则进行插桩处理。
标记: affects_outputs
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> 默认值:请参阅说明
目标模拟器和设备的最低兼容 iOS 版本。如果未指定,则使用“ios_sdk_version”。
标记: loses_incremental_state
已累计 --ios_multi_cpus=<comma-separated list of options> 次多次使用
用于构建 ios_application 的架构列表(以英文逗号分隔)。从而生成一个包含所有指定架构的通用二进制文件。
标记:loses_incremental_stateloading_and_analysis
--[no]legacy_whole_archive 默认值:“true”
已废弃,已被 --incompatible_remove_legacy_whole_archive 取代(如需了解详情,请参阅 https://github.com/bazelbuild/bazel/issues/7362)。开启此设置后,请为 linkopts 中包含 linkshared=True 且 linkstatic=True 或“-static”的 cc_binary 规则使用 --whole-archive。这仅用于向后兼容。更好的替代方案是根据需要使用 alwayslink=1。
标记:action_command_linesaffects_outputsdeprecated
已累计 --linkopt=<a string> 次多次使用
在链接时传递给 gcc 的附加选项。
标记:action_command_linesaffects_outputs
已累计 --ltobackendopt=<a string> 次多次使用
用于传递给 LTO 后端步骤的附加选项(在 --features=thin_lto 下)。
标记:action_command_linesaffects_outputs
已累计 --ltoindexopt=<a string> 次多次使用
用于传递给 LTO 索引步骤的附加选项(在 --features=thin_lto 下)。
标记:action_command_linesaffects_outputs
已累计 --macos_cpus=<comma-separated list of options> 次多次使用
要为其构建 Apple macOS 二进制文件的架构列表(以英文逗号分隔)。
标记:loses_incremental_stateloading_and_analysis
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> 默认值:请参阅说明
目标的最低兼容 macOS 版本。如果未指定,则使用“macos_sdk_version”。
标记: loses_incremental_state
--[no]objc_debug_with_GLIBCXX 默认值:“false”
如果已设置此参数,并且编译模式设为“dbg”,则定义 GLIBCXX_DEBUG、GLIBCXX_DEBUG_PEDANTIC 和 GLIBCPP_CONCEPT_CHECKS。
标记: action_command_lines
--[no]objc_enable_binary_stripping 默认值:“false”
是否对链接的二进制文件执行符号和死代码删除。如果同时指定了此标志和 --compilation_mode=opt,系统会执行二进制文件剥离。
标记: action_command_lines
已累计 --objccopt=<a string> 次多次使用
编译 Objective-C/C++ 源文件时需要传递给 gcc 的其他选项。
标记: action_command_lines
已累计 --per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options> 次多次使用
在编译特定文件时,可选择性地传递给 gcc 的其他选项。可以多次传递此选项。语法:regex_filter@option_1,option_2,...,option_n。其中,regex_filter 代表包含和排除正则表达式模式的列表(另请参阅 --instrumentation_filter)。 option_1 到 option_n 代表任意命令行选项。如果选项中包含英文逗号,则必须使用反斜杠将其括起来。选项可以包含 @。只有第一个 @ 用于拆分字符串。示例:--per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 向 //foo/(bar.cc 除外)中所有 cc 文件的 gcc 命令行添加 -O0 命令行选项。
标记:action_command_linesaffects_outputs
已累计 --per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options> 次多次使用
在编译某些后端对象时,可选择性地传递到 LTO 后端(在 --features=thin_lto 下)的其他选项。可以多次传递此选项。语法:regex_filter@option_1,option_2,...,option_n。其中,regex_filter 代表包含和排除正则表达式模式的列表。 option_1 到 option_n 代表任意命令行选项。如果选项中包含英文逗号,则必须使用反斜杠将其括起来。选项可以包含 @。只有第一个 @ 用于拆分字符串。示例:--per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 向 //foo/(bar.o 除外)中所有 o 文件的 LTO 后端命令行添加 -O0 命令行选项。
标记:action_command_linesaffects_outputs
--platform_suffix=<a string> 默认值:请参阅说明
指定要添加到配置目录的后缀。
标记:loses_incremental_stateaffects_outputsloading_and_analysis
--propeller_optimize=<a build target label> 默认值:请参阅说明
使用螺旋桨配置文件信息优化构建目标。螺旋桨配置文件必须至少包含以下两个文件中的一个:cc 配置文件和 ld 配置文件。此标志接受必须引用螺旋桨配置文件输入文件的 build 标签。(此选项必须用作:--propeller_optimize=//a/b:propeller_profile
标记:action_command_linesaffects_outputs
--propeller_optimize_absolute_cc_profile=<a string> 默认值:请参阅说明
Propeller 优化 build 的 cc_profile 文件的绝对路径名称。
标记: affects_outputs
--propeller_optimize_absolute_ld_profile=<a string> 默认值:请参阅说明
Propeller 优化 build 的 ld_profile 文件的绝对路径名称。
标记: affects_outputs
--run_under=<a prefix in front of command> 默认值:请参阅说明
要在“test”和“run”命令的可执行文件前面插入的前缀。如果值为“foo -bar”,且执行命令行为“test_binary -baz”,则最终命令行为“foo -bar test_binary -baz”。这也可以是可执行目标的标签。部分示例包括:“valgrind”“strace”“strace -c”“valgrind --quiet --num-callers=20”“//package:target”“//package:target --options”。
标记: action_command_lines
--[no]share_native_deps 默认值:“true”
如果为 true,则包含相同功能的原生库将由不同的目标共享
标记:loading_and_analysisaffects_outputs
--[no]stamp 默认值:“false”
为二进制文件标记日期、用户名、主机名、工作区信息等。
标记: affects_outputs
--strip=<always, sometimes or never> 默认值:“有时”
指定是否删除二进制文件和共享库(使用“-Wl,--strip-debug”)。默认值“有时”表示,如果 f --compilation_mode=fastbuild,则执行剥离。
标记: affects_outputs
已累计 --stripopt=<a string> 次多次使用
生成“<name>.stripped”二进制文件时要传递的其他选项。
标记:action_command_linesaffects_outputs
已累计 --swiftcopt=<a string> 次多次使用
传递给 Swift 编译的更多选项。
标记: action_command_lines
已累计 --tvos_cpus=<comma-separated list of options> 次多次使用
要为其构建 Apple tvOS 二进制文件的架构列表(以英文逗号分隔)。
标记:loses_incremental_stateloading_and_analysis
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> 默认值:请参阅说明
目标模拟器和设备的最低兼容 tvOS 版本。如果未指定,则使用“tvos_sdk_version”。
标记: loses_incremental_state
已累计 --visionos_cpus=<comma-separated list of options> 次多次使用
要为其构建 Apple visionOS 二进制文件的架构列表(以英文逗号分隔)。
标记:loses_incremental_stateloading_and_analysis
已累计 --watchos_cpus=<comma-separated list of options> 次多次使用
要为其构建 Apple watchOS 二进制文件的架构列表(以英文逗号分隔)。
标记:loses_incremental_stateloading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> 默认值:请参阅说明
适用于目标模拟器和设备的最低兼容 watchOS 版本。如果未指定,则使用“watchos_sdk_version”。
标记: loses_incremental_state
--xbinary_fdo=<a build target label> 默认值:请参阅说明
使用 XbinaryFDO 配置文件信息优化编译。指定默认跨二进制配置文件的名称。当该选项与 --fdo_instrument/--fdo_optimize/--fdo_profile 一起使用时,这些选项将始终优先,就像从未指定 xbinary_fdo 一样。
标记: affects_outputs
影响 Bazel 强制执行有效 build 输入的严格程度的选项(规则定义、标志组合等):
--auto_cpu_environment_group=<a build target label> 默认值:“”
声明用于自动将 CPU 值映射到 target_environment 值的 environment_group。
标记:changes_inputsloading_and_analysisexperimental
--[no]check_licenses 默认值:“false”
检查依赖软件包施加的许可限制是否与正在构建的目标的分发模式冲突。默认情况下,系统不会选中许可。
标记: build_file_semantics
--[no]check_visibility 默认值:“true”
如果停用此设置,目标依赖项中的可见性错误会降级为警告。
标记: build_file_semantics
--[no]desugar_for_android 默认值:“true”
是否在 dex 处理之前对 Java 8 字节码进行脱糖。
标记:affects_outputsloading_and_analysisloses_incremental_state
--[no]desugar_java8_libs 默认值:“false”
是否在旧版设备应用中包含受支持的 Java 8 库。
标记:affects_outputsloading_and_analysisloses_incremental_stateexperimental
--[no]enforce_constraints 默认值:“true”
检查每个目标兼容的环境,如果任何目标的依赖项不支持相同环境,则报告错误
标记:build_file_semantics
--[no]experimental_allow_android_library_deps_without_srcs 默认值:“false”
用于帮助从允许转换为禁止使用依赖项的 srcs-less android_library 规则的标记。默认情况下,您需要清理仓库才能发布此仓库。
标记:eagerness_to_exitloading_and_analysis
--[no]experimental_check_desugar_deps 默认值:“true”
是否仔细检查 Android 二进制文件级别的脱糖是否正确。
标记:eagerness_to_exitloading_and_analysisexperimental
--experimental_import_deps_checking=<off, warning or error> 默认值:“OFF”
启用后,检查 aar_import 的依赖项是否完整。这种强制执行可能会破坏构建,或者只会导致警告。
标记: loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default> 默认值:“default”
如果为 true,则检查 Java 目标是否将所有直接使用的目标明确声明为依赖项。
标记:build_file_semanticseagerness_to_exit
--[no]incompatible_check_testonly_for_output_files 默认值:“false”
如果启用,则通过查找生成规则的 testonly 来仅检查 testonly(输出文件的必要目标)。这与可见性检查一致。
标记:build_file_semanticsincompatible_change
--[no]incompatible_disable_native_android_rules 默认值:“false”
启用后,系统会禁止直接使用原生 Android 规则。请使用 https://github.com/bazelbuild/rules_android 中的 Starlark Android 规则
标记:eagerness_to_exitincompatible_change
--[no]incompatible_disable_native_apple_binary_rule 默认值:“false”
无操作。保留在此处以确保向后兼容性。
标记:eagerness_to_exitincompatible_change
--[no]incompatible_force_strict_header_check_from_starlark 默认值:“true”
如果启用,请在 Starlark API 中设置严格的标头检查
标记:loading_and_analysischanges_inputsincompatible_change
--[no]incompatible_validate_top_level_header_inclusions 默认值:“true”
如果为 true,Bazel 还将验证是否包含顶级目录标头(如需了解详情,请参阅 https://github.com/bazelbuild/bazel/issues/10047)。
标记:loading_and_analysisincompatible_change
--[no]strict_filesets 默认值:“false”
如果启用此选项,跨越软件包边界的文件集会报告为错误。当 check_fileset_dependencies_recursively 停用时不起作用。
标记:build_file_semanticseagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default> 默认值:“error”
除非 OFF,否则检查 proto_library 目标是否明确将所有直接使用的目标声明为依赖项。
标记:build_file_semanticseagerness_to_exitincompatible_change
--strict_public_imports=<off, warn, error, strict or default> 默认值:“off”
除非 OFF,否则检查 proto_library 目标是否将“import public”中使用的所有目标明确声明为已导出。
标记:build_file_semanticseagerness_to_exitincompatible_change
--[no]strict_system_includes 默认值:“false”
如果为 true,则还需要声明通过系统包含路径 (-isystem) 找到的头文件。
标记:loading_and_analysiseagerness_to_exit
已累计 --target_environment=<a build target label> 次多次使用
声明此 build 的目标环境。必须是对“环境”规则的标签引用。如果指定,则所有顶级目标都必须与此环境兼容。
标记: changes_inputs
影响 build 的签名输出的选项:
--apk_signing_method=<v1, v2, v1_v2 or v4> 默认值:“v1_v2”
用于为 APK 签名的实现
标记:action_command_linesaffects_outputsloading_and_analysis
--[no]device_debug_entitlements 默认值:“true”
如果已设置且编译模式不是“opt”,objc 应用在签名时会包含调试权限。
标记: changes_inputs
--ios_signing_cert_name=<a string> 默认值:请参阅说明
用于 iOS 签名的证书名称。如果未设置,系统将回退到预配配置文件。可能是证书的钥匙串身份偏好设置或证书通用名称的(子字符串),详情请见代码签名的手册页面 (SIGNING IDENTITIES)。
标记:action_command_lines
此选项会影响 Starlark 语言或 build 文件、.bzl 文件或 WORKSPACE 文件可访问的 build API 的语义。
--[no]incompatible_disallow_legacy_py_provider 默认值:“true”
无操作性通知,很快就会被移除。
标记:loading_and_analysisincompatible_change
用于控制测试环境或测试运行程序的行为的选项:
--[no]allow_analysis_failures 默认值:“false”
如果为 true,则规则目标的分析失败会导致目标传播包含错误说明的 AnalysisFailureInfo 实例,而不会导致构建失败。
标记:loading_and_analysisexperimental
--analysis_testing_deps_limit=<an integer> 默认值:“2000”
通过包含 for_analysis_testing 配置转换的规则属性设置传递依赖项的数量上限。超过此限制将导致规则错误。
标记: loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure 默认值:“false”
如果 dex2oat 操作为 true,则会导致构建中断,而不会在测试运行时期间执行 dex2oat。
标记:loading_and_analysisexperimental
--[no]experimental_android_use_parallel_dex2oat 默认值:“false”
同时使用 dex2oat 可以加快 android_test 的运行速度。
标记:loading_and_analysishost_machine_resource_optimizationsexperimental
--[no]ios_memleaks 默认值:“false”
启用 ios_test 目标中的内存泄漏检查功能。
标记: action_command_lines
--ios_simulator_device=<a string> 默认值:请参阅说明
在模拟器中运行 iOS 应用(例如“iPhone 6”)时要模拟的设备。您可以在运行模拟器的机器上运行“xcrun simctl list devicetypes”来获取设备列表。
标记: test_runner
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> 默认值:请参阅说明
运行或测试时要在模拟器上运行的 iOS 版本。如果 ios_test 规则中指定了目标设备,系统会忽略此规则。
标记: test_runner
已累计 --runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once> 次多次使用
指定每项测试的运行次数。如果其中任何一项测试因任何原因失败,整个测试都将被视为失败。通常,指定的值只是一个整数。示例:--runs_per_test=3 会运行所有测试 3 次。替代语法:regex_filter@runs_per_test。其中,runs_per_test 代表整数值,而 regex_filter 代表包含和排除正则表达式模式的列表(另请参阅 --instrumentation_filter)。示例:--runs_per_test=//foo/.*,-//foo/bar/.*@3 运行 //foo/ 中的所有测试(foo/bar 下的测试除外)三次。可以多次传递此选项。最新传递且匹配的参数优先。如果没有匹配项,该测试将仅运行一次。
已累计 --test_env=<a 'name=value' assignment with an optional value part> 次多次使用
指定要注入到测试运行程序环境的其他环境变量。变量可以按名称指定(在这种情况下,其值将从 Bazel 客户端环境中读取),或者按名称=值对进行读取。可多次使用此选项来指定多个变量。仅供“bazel test”命令使用。
标记: test_runner
--test_timeout=<a single integer or comma-separated list of 4 integers> 默认值:“-1”
替换测试超时的默认测试超时值(以秒为单位)。如果指定了单个正整数值,则该值将覆盖所有类别。如果指定了 4 个以英文逗号分隔的整数,这些值会替换短、中、长和永恒(按此顺序)的超时设置。无论使用哪种方式,值 -1 都会指示 Blaze 对该类别使用其默认超时。
--tvos_simulator_device=<a string> 默认值:请参阅说明
在模拟器中运行 tvOS 应用时(例如“Apple TV 1080p”)时要模拟的设备。您可以在运行模拟器的机器上运行“xcrun simctl list devicetypes”来获取设备列表。
标记: test_runner
--tvos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> 默认值:请参阅说明
运行或测试时要在模拟器上运行的 tvOS 版本。
标记: test_runner
--watchos_simulator_device=<a string> 默认值:请参阅说明
在模拟器中运行 watchOS 应用时(例如“Apple Watch - 38mm”)时要模拟的设备。您可以在运行模拟器的机器上运行“xcrun simctl list devicetypes”来获取设备列表。
标记: test_runner
--watchos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> 默认值:请参阅说明
运行或测试时要在模拟器上运行的 watchOS 版本。
标记: test_runner
--[no]zip_undeclared_test_outputs 默认值:“true”
如果为 true,则未声明的测试输出将归档为一个 ZIP 文件。
标记: test_runner
与查询输出和语义相关的选项:
--aspect_deps=<off, conservative or precise> 默认值:“conservative”
当输出格式为 {xml,proto,record} 之一时,如何解析切面依赖项。“off”表示不解析任何切面依赖项,“保守”(默认值)表示添加所有已声明的切面依赖关系,而不管它们是否被赋予直接依赖关系的规则类为直接依赖关系,“precise”表示仅添加在直接依赖关系规则类下可能处于活动状态的那些切面。请注意,精确模式需要加载其他软件包来评估单个目标,因此该模式比其他模式慢。另请注意,即使是精确模式也不是完全精确的:是否要计算某个切面的决策是在分析阶段决定的,而不是在“bazel 查询”期间运行。
标记: build_file_semantics
--[no]consistent_labels 默认值:“false”
启用后,每个查询命令都会发出标签,就像通过应用于 <code>Label</code> 实例的 Starlark <code>str</code> 函数发出一样。这对于需要匹配不同查询命令的输出和/或由规则发出的标签生成的工具非常有用。如果未启用,输出格式设置工具可以自由发出明显的仓库名称(相对于主仓库),以使输出更具可读性。
标记: terminal_output
--[no]deduplicate_depsets 默认值:“true”
删除最终 proto/textproto/json 输出中 dep_set_of_files 的重复非叶子项。此操作不会删除未共享直接父级的重复数据集。这不会影响操作的最终有效输入工件列表。
标记: terminal_output
--[no]graph:factored 默认值:“true”
如果为 true,则该图将发出“因式分解”处理,即拓扑相等的节点将合并在一起,其标签将串联起来。此选项仅适用于 --output=graph。
标记: terminal_output
--graph:node_limit=<an integer> 默认值:“512”
输出中图表节点的标签字符串的最大长度。较长的标签将被截断;-1 表示不会被截断。此选项仅适用于 --output=graph。
标记: terminal_output
--[no]implicit_deps 默认值:“true”
启用后,隐式依赖项将包含在执行查询的依赖关系图中。隐式依赖项是指未在 BUILD 文件中明确指定但由 bazel 添加的依赖项。对于 cquery,此选项用于控制过滤已解析的工具链。
标记: build_file_semantics
--[no]include_artifacts 默认值:“true”
在输出中包含操作输入和输出的名称(可能较大)。
标记: terminal_output
--[no]include_aspects 默认值:“true”
aquery、cquery:是否在输出中包含切面生成的操作。query: no-op(始终遵循切面)。
标记: terminal_output
--[no]include_commandline 默认值:“true”
在输出中包含操作命令行的内容(可能很大)。
标记: terminal_output
--[no]include_file_write_contents 默认值:“false”
包含 FileWrite 和 SourceSymlinkManifest 操作(可能很大)的文件内容。
标记: terminal_output
--[no]include_param_files 默认值:“false”
添加命令中使用的参数文件的内容(可能很大)。注意:启用此标志将会自动启用 --include_commandline 标志。
标记: terminal_output
--[no]incompatible_display_source_file_location 默认值:“true”
默认情况下为 true,显示源文件的目标。如果为 true,则显示位置输出中源文件第 1 行的位置。此标志仅用于迁移目的。
标记:terminal_outputincompatible_change
--[no]incompatible_package_group_includes_double_slash 默认值:“true”
如果启用此选项,则输出 package_group 的 `packages` 属性时,前导 `//` 将不会省略。
标记:terminal_outputincompatible_change
--[no]infer_universe_scope 默认值:“false”
如果您设置此参数,并且未设置 --universe_scope,则系统会将“--universe_scope”值推断为查询表达式中唯一目标模式的列表。请注意,针对使用 Universe 范围函数(例如 `allrdeps`)的查询表达式推断出的 --universe_scope 值可能不是您想要的值,因此除非您知道自己正在执行的操作,否则不应使用此选项。如需了解详情和示例,请参阅 https://bazel.build/reference/query#sky-query。如果设置了 --universe_scope,则会忽略此选项的值。注意:此选项仅适用于“query”(即不适用于“cquery”)。
标记:loading_and_analysis
--[no]line_terminator_null 默认值:“false”
每种格式是否以 \0(而非换行符)结束。
标记: terminal_output
--[no]nodep_deps 默认值:“true”
如果启用,则“nodep”属性中的依赖项将包含在执行查询的依赖关系图中。“nodep”属性的一个常见示例是“visibility”。运行并解析“info build-language”的输出,即可了解 build 语言中的所有“nodep”属性。
标记: build_file_semantics
--output=<a string> 默认值:“text”
应以哪种格式输出查询结果。允许的查询值包括:text、textproto、proto、jsonproto。
标记: terminal_output
--[no]proto:default_values 默认值:“true”
如果为 true,则会包含 BUILD 文件中未明确指定值的属性;否则,会忽略这些属性。此选项适用于 --output=proto
标记:terminal_output
--[no]proto:definition_stack 默认值:“false”
填充 Definition_stack proto 字段,在定义规则的类时,为每个规则实例记录 Starlark 调用堆栈。
标记: terminal_output
--[no]proto:flatten_selects 默认值:“true”
启用后,通过 select() 创建的可配置属性将展平。对于列表类型,扁平化表示形式是一个列表,包含选定映射的每个值一次。标量类型会展平为 null。
标记: build_file_semantics
--[no]proto:include_synthetic_attribute_hash 默认值:“false”
是否计算和填充 $internal_attr_hash 属性。
标记: terminal_output
--[no]proto:instantiation_stack 默认值:“false”
填充每条规则的实例化调用堆栈。请注意,这需要有堆栈存在
标记:terminal_output
--[no]proto:locations 默认值:“true”
是否在 proto 输出中输出位置信息。
标记: terminal_output
--proto:output_rule_attrs=<comma-separated list of options> 默认值:“all”
要包含在输出中的属性列表(以英文逗号分隔)。默认值为所有属性。设置为空字符串,不输出任何属性。此选项适用于 --output=proto。
标记: terminal_output
--[no]proto:rule_inputs_and_outputs 默认值:“true”
是否填充 rules_input 和 rules_output 字段。
标记: terminal_output
--query_file=<a string> 默认值:“”
如果设置此参数,查询将从此处指定的文件中(而不是在命令行中)读取查询。在此处指定文件以及通过命令行查询是错误的。
标记: changes_inputs
--[no]relative_locations 默认值:“false”
如果为 true,则 BUILD 文件在 xml 和 proto 输出中的位置将是相对的。默认情况下,位置输出是绝对路径,在不同机器中不一致。您可以将此选项设置为 true,以便在不同机器上获得一致的结果。
标记: terminal_output
--[no]skyframe_state 默认值:“false”
从 Skyframe 中转储当前的操作图,而无需执行额外的分析。注意:目前不支持使用 --skyframe_state 指定目标。此标志仅适用于 --output=proto 或 --output=textproto。
标记: terminal_output
--[no]tool_deps 默认值:“true”
查询:如果停用,对“主机配置”或“执行”目标的依赖关系将不会包含在执行查询的依赖关系图中。“主机配置”依赖项边缘(例如从任何“proto_library”规则到协议编译器的依赖项边缘)通常指向在构建期间执行的工具,而不是同一“目标”程序的一部分。 Cquery:如果停用,则会从发现此已配置目标的顶级目标中过滤掉所有跨主机或执行转换的已配置目标。这意味着,如果顶级目标位于目标配置中,则将仅返回同样位于目标配置中的已配置目标。如果顶级目标位于主机配置中,则系统将仅返回主机配置的目标。此选项不会排除已解析的工具链。
标记: build_file_semantics
--universe_scope=<comma-separated list of options> 默认值:“”
一组以英文逗号分隔的目标模式(加法和减法)。此查询可以在由指定目标的传递闭合定义的宇宙中执行。此选项用于 query 和 cquery 命令。 对于 cquery,此选项的输入是构建所有答案的目标,因此此选项可能会影响配置和转换。如果未指定此选项,系统会假定顶级目标是通过查询表达式解析的目标。注意:对于 cquery,如果无法使用顶级选项构建从查询表达式解析的目标,则不指定此选项可能会导致构建中断。
标记: loading_and_analysis
触发构建时优化的选项:
--[no]collapse_duplicate_defines 默认值:“false”
启用后,系统会在 build 中尽早移除多余的 --定义。这样可以避免某些类型的等效 build 出现不必要的分析缓存丢失。
标记:loading_and_analysisloses_incremental_state
--[no]experimental_filter_library_jar_with_program_jar 默认值:“false”
过滤 ProGuard ProgramJar 以移除 LibraryJar 中也存在的所有类。
标记: action_command_lines
--[no]experimental_inmemory_dotd_files 默认值:“true”
启用后,C++ .d 文件将直接从远程 build 节点在内存中传递,而不是写入磁盘。
标记:loading_and_analysisexecutionaffects_outputsexperimental
--[no]experimental_inmemory_jdeps_files 默认值:“true”
启用后,通过 Java 编译生成的依赖项 (.jdeps) 文件将直接从远程构建节点在内存中传递,而不是写入磁盘。
标记:loading_and_analysisexecutionaffects_outputsexperimental
--[no]experimental_objc_include_scanning 默认值:“false”
是否针对目标 C/C++ 执行包含扫描。
标记:loading_and_analysisexecutionchanges_inputs
--[no]experimental_parse_headers_skipped_if_corresponding_srcs_found 默认值:“false”
启用后,如果在同一目标中发现具有相同基名的来源,parse_headers 功能不会创建单独的标头编译操作。
标记:loading_and_analysisaffects_outputs
--[no]experimental_retain_test_configuration_across_testonly 默认值:“false”
启用后,对于标记为 testonly=1 的规则,--trim_test_configuration 不会修剪测试配置。这是为了减少非测试规则依赖于 cc_test 规则时的操作冲突问题。如果 --trim_test_configuration 为 false,则无效。
标记:loading_and_analysisloses_incremental_state
--[no]experimental_starlark_cc_import 默认值:“false”
启用后,即可使用 Starlark 版本的 cc_import。
标记:loading_and_analysisexperimental
--[no]experimental_unsupported_and_brittle_include_scanning 默认值:“false”
是否通过解析输入文件中的 #include 行来缩小 C/C++ 编译的输入范围。这可以通过减小编译输入树的大小来提高性能和增量。不过,它也可能会中断构建,因为 include 扫描器无法完全实现 C 预处理器语义。特别是,它不理解动态 #include 指令,并且会忽略预处理器的条件逻辑。使用时需自行承担风险。已提交的与此标志相关的任何问题都将关闭。
标记:loading_and_analysisexecutionchanges_inputs
--[no]incremental_dexing 默认值:“true”
为每个 Jar 文件分别执行 dex 处理的大部分工作。
标记:affects_outputsloading_and_analysisloses_incremental_state
--[no]objc_use_dotd_pruning 默认值:“true”
如果设置了此字段,则 Clang 发出的 .d 文件将用于剪除传入 objc 编译项的输入集。
标记:changes_inputsloading_and_analysis
--[no]process_headers_in_dependencies 默认值:“false”
构建目标 //a:a 时,处理 //a:a 所依赖的所有目标中的标头(如果工具链启用了标头处理功能)。
标记: execution
--[no]trim_test_configuration 默认值:“true”
启用后,与测试相关的选项将在 build 顶层下方清除。当此标志处于启用状态时,无法将测试构建为非测试规则的依赖项,但对测试相关选项的更改不会导致系统重新分析非测试规则。
标记:loading_and_analysisloses_incremental_state
--[no]use_singlejar_apkbuilder 默认值:“true”
此选项已弃用。该功能现在是一种空操作,很快就会被移除。
标记: loading_and_analysis
影响日志记录的详细程度、格式或位置的选项:
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths> 默认值:“-.*”
在工具链解析期间输出调试信息。该标志采用一个正则表达式,系统会根据工具链类型和特定目标检查该正则表达式,以确定要调试哪个版本。您可以使用英文逗号分隔多个正则表达式,然后单独检查每个正则表达式。注意:此标志的输出非常复杂,可能仅供工具链解析方面的专家使用。
标记: terminal_output
用于指定或更改不属于其他类别的 Bazel 命令的通用输入的选项:
已累计 --flag_alias=<a 'name=value' flag alias> 次多次使用
为 Starlark 标志设置简写名称。它使用“<key>=<value>”形式的单个键值对作为参数。
标记: changes_inputs
--[no]incompatible_default_to_explicit_init_py 默认值:“false”
此标志会更改默认行为,以便系统不再在 Python 目标的 runfile 中自动创建 __init__.py 文件。确切地说,当 py_binary 或 py_test 目标将 legacy_create_init 设置为“auto”(默认值)时,当且仅当设置了此标记时,它才会被视为 false。请参阅 https://github.com/bazelbuild/bazel/issues/10076。
标记:affects_outputsincompatible_change
--[no]incompatible_py2_outputs_are_suffixed 默认值:“true”
如果为 true,则在 Python 2 配置中构建的目标将显示在包含后缀“-py2”的输出根目录下,而为 Python 3 构建的目标将显示在没有与 Python 相关后缀的根下。这意味着,“bazel-bin”便捷符号链接将指向 Python 3 目标,而不是 Python 2。如果启用此选项,还建议您启用“--incompatible_py3_is_default”。
标记:affects_outputsincompatible_change
--[no]incompatible_py3_is_default 默认值:“true”
如果为 true,则未设置其 `python_version`(或 `default_python_version`)属性的 `py_binary` 和 `py_test` 目标将默认为 PY3,而不是 PY2。如果设置了此标志,还建议您设置“--incompatible_py2_outputs_are_suffixed”。
标记:loading_and_analysisaffects_outputsincompatible_change
--[no]incompatible_use_python_toolchains 默认值:“true”
如果设置为 true,可执行原生 Python 规则将使用 Python 工具链指定的 Python 运行时,而不是由旧版标志(如 --python_top)指定的运行时。
标记:loading_and_analysisincompatible_change
--python_version=<PY2 or PY3> 默认值:请参阅说明
Python 主要版本模式,即“PY2”或“PY3”。请注意,这会被“py_binary”和“py_test”目标替换(即使它们未明确指定版本),因此通常没有太多理由提供此标志。
标记:loading_and_analysisaffects_outputsexplicit_in_output_path
其他选项,未以其他方式分类:
--[no]cache_test_results [-t] 默认值:“auto”
如果设置为“auto”,则仅当满足以下条件时,Bazel 才会重新运行测试:(1) Bazel 检测到测试或其依赖项中的更改;(2) 测试标记为外部;(3) 使用 --runs_per_test 请求了多次测试运行;或(4) 之前测试失败。如果设置为“yes”,Bazel 会缓存所有测试结果,但标记为外部的测试除外。如果设置为“no”,Bazel 不会缓存任何测试结果。
--[no]experimental_cancel_concurrent_tests 默认值:“false”
如果为 true,则 Blaze 将在第一次成功运行时取消同时运行测试。此参数必须与 --runs_per_test_detects_flakes 结合使用。
标记:affects_outputsloading_and_analysis
--[no]experimental_fetch_all_coverage_outputs 默认值:“false”
如果为 true,Bazel 会在覆盖率运行期间为每个测试提取整个覆盖率数据目录。
标记:affects_outputsloading_and_analysis
--[no]experimental_generate_llvm_lcov 默认值:“false”
如果为 true,对 Clang 的覆盖率将生成 LCOV 报告。
标记:affects_outputsloading_and_analysis
--[no]experimental_j2objc_header_map 默认值:“true”
是否在 J2ObjC 转译的同时生成 J2ObjC 头文件映射。
--[no]experimental_j2objc_shorter_header_path 默认值:“false”
是否使用较短的标头路径(使用“_ios”而不是“_j2objc”)生成。
标记: affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel> 默认值:“javabuilder”
为 Java 编译启用了缩减的类路径。
--[no]experimental_limit_android_lint_to_android_constrained_java 默认值:“false”
将 --experimental_run_android_lint_on_java_rules 限制为 Android 兼容库。
标记: affects_outputs
--[no]experimental_run_android_lint_on_java_rules 默认值:“false”
是否验证 java_* 源代码。
标记: affects_outputs
--[no]explicit_java_test_deps 默认值:“false”
在 java_test 中明确指定 JUnit 或 Hamcrest 的依赖项,而不是意外从 TestRunner 的依赖项中获取。目前仅适用于 bazel。
--host_java_launcher=<a build target label> 默认值:请参阅说明
在构建期间执行的工具使用的 Java 启动器。
已累计 --host_javacopt=<a string> 次多次使用
构建在构建期间执行的工具时传递给 javac 的其他选项。
已累计 --host_jvmopt=<a string> 次多次使用
构建在构建期间执行的工具时传递给 Java 虚拟机的其他选项。这些选项将添加到每个 java_binary 目标的虚拟机启动选项中。
--[no]incompatible_check_sharding_support 默认值:“false”
如果为 true,则 Bazel 会在测试运行程序未通过轻触 TEST_SHARD_STATUS_FILE 路径下的文件来表明它支持分片时,导致分片测试失败。如果为 false,不支持分片的测试运行程序会导致在每个分片中运行所有测试。
标记: incompatible_change
--[no]incompatible_exclusive_test_sandboxed 默认值:“false”
如果为 true,专用测试将使用沙盒策略运行。添加“local”标记以在本地强制运行独家测试
标记: incompatible_change
--[no]incompatible_strict_action_env 默认值:“false”
如果为 true,Bazel 会使用具有静态 PATH 值的环境,并且不会继承 LD_LIBRARY_PATH。如果您想从客户端继承特定环境变量,请使用 --action_env=ENV_VARIABLE;但请注意,如果使用了共享缓存,这样做可能会阻止用户进行跨用户缓存。
标记:loading_and_analysisincompatible_change
已累计 --j2objc_translation_flags=<comma-separated list of options> 次多次使用
可传递给 J2ObjC 工具的其他选项。
--java_debug
使 Java 测试的 Java 虚拟机在开始测试之前等待来自兼容 JDWP 的调试程序(例如 jdb)的连接。隐式为 -test_output=streamed。
扩展为:
  --test_arg=--wrapper_script_flag=--debug
  --test_output=streamed
  --test_strategy=exclusive
  --test_timeout=9999
  --nocache_test_results
--[no]java_deps 默认值:“true”
每个 Java 目标生成依赖项信息(目前为编译时类路径)。
--[no]java_header_compilation 默认值:“true”
直接从源代码编译 ijar。
--java_language_version=<a string> 默认值:“8”
Java 语言版本
--java_launcher=<a build target label> 默认值:请参阅说明
构建 Java 二进制文件时使用的 Java 启动器。如果此标志设置为空字符串,系统会使用 JDK 启动器。“launcher”属性会替换此标志。
--java_runtime_version=<a string> 默认值:“local_jdk”
Java 运行时版本
已累计 --javacopt=<a string> 次多次使用
需要传递给 javac 的其他选项。
已累计 --jvmopt=<a string> 次多次使用
用于传递给 Java 虚拟机的其他选项。这些选项将添加到每个 java_binary 目标的虚拟机启动选项中。
--legacy_main_dex_list_generator=<a build target label> 默认值:请参阅说明
指定一个二进制文件,用于生成编译旧版 MultiDex 时必须位于主 dex 中的类列表。
已累计 --plugin=<a build target label> 次多次使用
要在 build 中使用的插件。目前可与 java_plugin 配合使用。
--proguard_top=<a build target label> 默认值:请参阅说明
指定在构建 Java 二进制文件时要使用哪种 ProGuard 版本移除代码。
--proto_compiler=<a build target label> 默认值:“@bazel_tools//tools/proto:protoc”
proto 编译器的标签。
标记:affects_outputsloading_and_analysis
--proto_toolchain_for_cc=<a build target label> 默认值:“@bazel_tools//tools/proto:cc_toolchain"
proto_lang_toolchain() 的标签,用于描述如何编译 C++ proto。
标记:affects_outputsloading_and_analysis
--proto_toolchain_for_j2objc=<a build target label> 默认值:“@bazel_tools//tools/j2objc:j2objc_proto_toolchain"
proto_lang_toolchain() 的标签,用于描述如何编译 j2objc protos
标记:affects_outputsloading_and_analysis
--proto_toolchain_for_java=<a build target label> 默认值:“@bazel_tools//tools/proto:java_toolchain"
proto_lang_toolchain() 的标签,用于描述如何编译 Java proto
标记:affects_outputsloading_and_analysis
--proto_toolchain_for_javalite=<a build target label> 默认值:“@bazel_tools//tools/proto:javalite_toolchain"
proto_lang_toolchain() 的标签,用于描述如何编译 JavaLite proto
标记:affects_outputsloading_and_analysis
已累计 --protocopt=<a string> 次多次使用
需要传递给 protobuf 编译器的其他选项。
标记: affects_outputs
--[no]runs_per_test_detects_flakes 默认值:“false”
如果为 true,则至少有一个运行/尝试通过且至少有一次运行/尝试失败的任何分片都会获得 FLAKY 状态。
--shell_executable=<a path> 默认值:请参阅说明
供 Bazel 使用的 shell 可执行文件的绝对路径。如果未设置此属性,但 BAZEL_SH 环境变量是在首次 Bazel 调用(启动 Bazel 服务器)时设置的,则 Bazel 会使用此变量。如果二者都未设置,则 Bazel 会使用硬编码的默认路径,具体取决于其运行的操作系统(Windows:c:/tools/msys64/usr/bin/bash.exe、FreeBSD:/usr/local/bin/bash,其他所有平台:/bin/bash)。请注意,使用与 bash 不兼容的 shell 可能会导致生成的二进制文件构建失败或运行时失败。
标记: loading_and_analysis
已累计 --test_arg=<a string> 次多次使用
指定应传递给测试可执行文件的其他选项和实参。可以多次使用指定多个参数。如果执行多个测试,每个测试都将收到相同的参数。仅供“bazel test”命令使用。
--test_filter=<a string> 默认值:请参阅说明
指定要转发到测试框架的过滤器。用于限制测试的运行。请注意,这不会影响构建哪些目标。
--test_result_expiration=<an integer> 默认值:“-1”
此选项已弃用,无效。
--[no]test_runner_fail_fast 默认值:“false”
将失败快速选项转发给测试运行程序。测试运行程序应在第一次失败时停止执行。
--test_sharding_strategy=<explicit or disabled> 默认值:“露骨内容”
指定测试分片策略:“露骨内容”,以便仅在存在“hard_count”BUILD 属性时才使用分片。“disabled”表示从不使用测试分片。
--tool_java_language_version=<a string> 默认值:“8”
用于执行构建期间所需工具的 Java 语言版本
--tool_java_runtime_version=<a string> 默认值:“remotejdk_11”
用于在构建期间执行工具的 Java 运行时版本
--[no]use_ijars 默认值:“true”
启用后,此选项会导致 Java 编译使用接口 JAR。这样可以加快增量编译的速度,但错误消息可能会有所不同。

构建选项

出现在命令之前并由客户端解析的选项:
已累计 --distdir=<a path> 次多次使用
在访问网络以下载归档文件之前,可在其他位置搜索归档文件。
标记: bazel_internal_configuration
如果已设置,代码库缓存将在缓存命中时对文件进行硬链接,而不是复制。这是为了节省磁盘空间。
标记: bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id 默认值:“false”
如果为 true,请使用从代码库下载网址派生的字符串作为 canonical_id(如果未指定)。这会导致网址发生变化,进而重新下载,即使缓存中包含具有相同哈希值的下载内容。这可用于验证网址更改不会导致损坏的代码库被缓存遮盖。
标记:loading_and_analysisexperimental
--[no]experimental_repository_disable_download 默认值:“false”
如果设置此参数,则不允许下载外部代码库。
标记: experimental
--experimental_repository_downloader_retries=<an integer> 默认值:“0”
重新尝试下载错误的最大尝试次数。如果设置为 0,系统会停用重试。
标记: experimental
--experimental_scale_timeouts=<a double> 默认值:“1.0”
按此系数扩缩 Starlark 代码库规则中的所有超时时间。通过这种方式,可以在不更改源代码的情况下使外部代码库在速度低于规则作者的机器上运行。
标记:bazel_internal_configurationexperimental
--http_timeout_scaling=<a double> 默认值:“1.0”
按指定系数调整与 HTTP 下载相关的所有超时
标记: bazel_internal_configuration
--repository_cache=<a path> 默认值:请参阅说明
指定在提取外部代码库期间获取的已下载值的缓存位置。使用空字符串作为参数会请求停用缓存。
标记: bazel_internal_configuration
用于控制构建执行的选项:
--[no]check_up_to_date 默认值:“false”
不执行构建,只需检查它是否为最新版本。如果所有目标都是最新的,构建成功完成。如果需要执行任何步骤,则系统会报告错误,并且构建会失败。
标记: execution
--dynamic_local_execution_delay=<an integer> 默认值:“1000”
如果在构建期间至少一次的远程执行速度更快,本地执行应延迟多少毫秒?
标记:executionhost_machine_resource_optimizations
已累计 --dynamic_local_strategy=<a '[name=]value1[,..,valueN]' assignment> 次多次使用
为指定助记符按顺序使用的局部策略。传递“local”作为助记符会设置未指定助记符的默认值。使用 [mnemonic=]local_strategy[,local_strategy,...]
标记:executionhost_machine_resource_optimizations
已累计 --dynamic_remote_strategy=<a '[name=]value1[,..,valueN]' assignment> 次多次使用
用于给定助记符的远程策略。传递“remote”作为助记符时,系统会为未指定的助记符设置默认值。采用 [mnemonic=]remote_strategy[,remote_strategy,...]
标记:executionhost_machine_resource_optimizations
--experimental_docker_image=<a string> 默认值:“”
指定一个 Docker 映像名称(例如“ubuntu:latest”),该映像名称应在使用 Docker 策略时用于执行沙盒化操作,并且该操作本身在平台说明中的 remote_execution_properties 中还没有容器映像属性。此标志的值会逐字传递给“docker run”,因此它支持与 Docker 本身相同的语法和机制。
标记: execution
--[no]experimental_docker_use_customized_images 默认值:“true”
如果启用,则在使用 Docker 映像之前,会将当前用户的 uid 和 gid 注入 Docker 映像中。如果您的构建 / 测试依赖于用户在容器内拥有名称和主目录,则必须执行此操作。此设置默认处于开启状态,但如果自动图片自定义功能不适用于您的情况,或者您知道自己不需要它,则可以将其停用。
标记: execution
--[no]experimental_dynamic_exclude_tools 默认值:“true”
设置后,“针对工具”构建的目标不会动态执行。此类目标极不可能以增量方式构建,因此不值得在当地循环。
标记:executionhost_machine_resource_optimizations
--experimental_dynamic_local_load_factor=<a double> 默认值:“0”
控制为本地机器上加载的动态执行负载。此标志用于调整在动态执行中同时调度的操作数量。它取决于 Blaze 认为可用的 CPU 数量,可以使用 --local_cpu_resources 标志来控制。 如果此标志为 0,系统会立即在本地安排所有操作。如果大于 0,则本地调度的操作量受可用 CPU 数量的限制。如果 < 1,则在等待调度的操作数量较多时,使用负载系数来减少本地安排的操作数量。在干净 build 中,这会减少本地机器的负载,在干净 build 中,本地机器贡献不大。
标记:executionhost_machine_resource_optimizations
--experimental_dynamic_slow_remote_time=<An immutable length of time.> 默认值:“0”
如果大于 0,则动态运行操作必须仅在远程模式下运行的时间,然后才会优先执行其本地执行,以避免远程超时。这可能会隐藏远程执行系统上的一些问题。如未监控远程执行问题,请勿启用此功能。
标记:executionhost_machine_resource_optimizations
--[no]experimental_enable_docker_sandbox 默认值:“false”
启用基于 Docker 的沙盒。如果未安装 Docker,则此选项无效。
标记: execution
--experimental_persistent_javac
启用实验性永久性 Java 编译器。
扩展为:
  --strategy=Javac=worker
  --strategy=JavaIjar=local
  --strategy=JavaDeployJar=local
  --strategy=JavaSourceJar=local
  --strategy=Turbine=local

标记:executionhost_machine_resource_optimizations
--experimental_sandbox_async_tree_delete_idle_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5"> 默认值:“0”
如果为 0,则在操作完成后立即删除沙盒树(这会导致操作完成延迟)。如果大于零,则当构建运行时大小为 1,在服务器空闲时,在大小为 1 的异步线程池上执行删除这 3 个线程,并在服务器空闲时增长到此标志指定的大小。
标记:host_machine_resource_optimizationsexecution
--experimental_sandboxfs_path=<a string> 默认值:“sandboxfs”
当 --experimental_use_sandboxfs 为 true 时要使用的 sandboxfs 二进制文件的路径。如果是裸名称,请使用在 PATH 中找到的该名称的第一个二进制文件。
标记:host_machine_resource_optimizationsexecution
--[no]experimental_split_xml_generation 默认值:“true”
如果已设置此标志,并且测试操作不会生成 test.xml 文件,则 Bazel 会使用单独的操作来生成包含测试日志的虚拟 test.xml 文件。否则,Bazel 会在测试操作过程中生成 test.xml。
标记: execution
--experimental_total_worker_memory_limit_mb=<an integer, or "HOST_RAM", optionally followed by [-|*]<float>.> 默认值:“0”
如果此限制大于零,并且所有工作器的总内存用量超过此上限,则可能会终止空闲工作器。
标记:executionhost_machine_resource_optimizations
--[no]experimental_use_hermetic_linux_sandbox 默认值:“false”
如果设置为 true,则不装载 root,仅装载通过 sandbox_add_mount_pair 提供的内容。输入文件将硬链接到沙盒,而不是从沙盒通过符号链接连接到沙盒。如果操作输入文件与沙盒位于不同的文件系统上,则系统会复制输入文件。
标记: execution
--[no]experimental_use_sandboxfs 默认值:“false”
请使用 sandboxfs 来创建操作的 execroot 目录,而不是构建符号链接树。如果选择“yes”,则 --experimental_sandboxfs_path 提供的二进制文件必须有效,并且与支持的 sandboxfs 版本相对应。如果设为“auto”,则表示二进制文件可能缺失或不兼容。
标记:host_machine_resource_optimizationsexecution
--[no]experimental_use_windows_sandbox 默认值:“false”
使用 Windows 沙盒来运行操作。如果选择“yes”,则 --experimental_windows_sandbox_path 提供的二进制文件必须有效,并且与受支持的 sandboxfs 版本相对应。如果设为“auto”,则表示二进制文件可能缺失或不兼容。
--experimental_windows_sandbox_path=<a string> 默认值:“BazelSandbox.exe”
当 --experimental_use_windows_sandbox 为 true 时要使用的 Windows 沙盒二进制文件的路径。如果是裸名称,请使用在 PATH 中找到的该名称的第一个二进制文件。
--[no]experimental_worker_as_resource 默认值:“false”
启用后,工作器将作为资源从 ResourceManager 获取。
标记:executionhost_machine_resource_optimizations
--[no]experimental_worker_cancellation 默认值:“false”
启用后,Bazel 可能会向支持它们的工作器发送取消请求。
标记: execution
--[no]experimental_worker_multiplex 默认值:“true”
启用后,支持实验性多路复用功能的工作器将使用此功能。
标记:executionhost_machine_resource_optimizations
--[no]experimental_worker_multiplex_sandboxing 默认值:“false”
启用后,多路复用工作器将经过沙盒化,每个工作请求使用单独的沙盒目录。只有具有“supports-multiplex-sandboxing”执行要求的工作器会被沙盒化。
标记: execution
--[no]experimental_worker_strict_flagfiles 默认值:“false”
启用后,未遵循工作器规范的工作器操作参数将导致错误。工作器参数必须正好有一个 @flagfile 参数作为其参数列表的最后一个参数。
标记: execution
--genrule_strategy=<comma-separated list of options> 默认值:“”
指定如何执行 genrule。我们将逐步淘汰这一标志。请改用 --spawn_strategy=<value> 控制所有操作,或使用 --strategy=Genrule=<value> 仅控制 genrule。
标记: execution
已累计 --high_priority_workers=<a string> 次多次使用
要以高优先级运行的工作器的助记函数。当高优先级工作器运行时,所有其他工作器都会受到限制。
标记: execution
如果设为 true 且 --incompatible_remote_symlinks 也为 true,则操作输出中的符号链接可以悬挂。
标记:executionincompatible_change
如果设置为 true,则 Bazel 会在远程缓存/执行协议的操作输出中代表符号链接。否则,系统将追踪符号链接,并将其表示为文件或目录。如需了解详情,请参阅 #6631。
标记:executionincompatible_change
--[no]incompatible_sandbox_hermetic_tmp 默认值:“false”
如果设置为 true,则每个 Linux 沙盒都将专属的空目录装载为 /tmp,而不是与主机文件系统共享 /tmp。使用 --sandbox_add_mount_pair=/tmp,在所有沙盒中都能继续查看主机的 /tmp。
标记: execution
--[no]internal_spawn_scheduler 默认值:“false”
占位选项,以便我们在 Blaze 中判断是否启用了衍生调度程序。
标记:executionhost_machine_resource_optimizations
--jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5"> [-j] 默认值:“auto”
要运行的并发作业数量。接受整数或关键字(“auto”“HOST_CPUS”“HOST_RAM”),后面可选择性地后跟运算符 ([-|*]<float>),例如:"auto", "HOST_CPUS*.5"。值必须介于 1 到 5000 之间。高于 2500 的值可能会导致内存问题。“auto”根据主机资源计算合理的默认值。
标记:host_machine_resource_optimizationsexecution
--[no]keep_going [-k] 默认值:“false”
出错后,应尽可能多地继续操作。虽然无法分析失败的目标以及依赖于该目标的目标,但这些目标的其他先决条件可以。
标记: eagerness_to_exit
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5"> 默认值:“auto”
用于加载/分析阶段的并行线程数。可接受整数或关键字(“auto”“HOST_CPUS”“HOST_RAM”),后面可视需要后跟操作 ([-|*]<float>),例如:"auto", "HOST_CPUS*.5"。“auto”根据主机资源设置合理的默认值。不得小于 1。
标记: bazel_internal_configuration
--[no]reuse_sandbox_directories 默认值:“false”
如果设置为 true,则可以重复使用沙盒化非 worker 执行的目录,以避免不必要的设置开销。
标记:host_machine_resource_optimizationsexecution
--sandbox_base=<a string> 默认值:“”
让沙盒在此路径下创建其沙盒目录。在 tmpfs 上指定一个路径(如 /run/shm),以便在构建 / 测试包含许多输入文件时大幅提高性能。注意:tmpfs 上需要有足够的 RAM 和可用空间来存放运行操作生成的输出和中间文件。
标记:host_machine_resource_optimizationsexecution
--[no]sandbox_explicit_pseudoterminal 默认值:“false”
明确允许为沙盒化操作创建伪终端。某些 Linux 发行版要求在沙盒中将进程的组 ID 设置为“tty”,伪终端才能正常运行。如果这会导致问题,可以停用此标志,以便使用其他群组。
标记: execution
已累计 --sandbox_tmpfs_path=<an absolute path> 次多次使用
对于沙盒化操作,请在此绝对路径装载一个可写空目录(如果沙盒实现支持,否则请忽略)。
标记:host_machine_resource_optimizationsexecution
--spawn_strategy=<comma-separated list of options> 默认值:“”
指定默认如何执行生成操作。接受以逗号分隔的策略列表(优先级从高到低)。对于每项操作,Bazel 会选择能够执行操作的优先级最高的策略。默认值为“remote,worker,sandboxed,local”。如需了解详情,请参阅 https://blog.bazel.build/2019/06/19/list-strategy.html。
标记: execution
已累计 --strategy=<a '[name=]value1[,..,valueN]' assignment> 次多次使用
指定如何分发其他生成操作的编译。接受以逗号分隔的策略列表(优先级从高到低)。对于每项操作,Bazel 会选择能够执行操作的优先级最高的策略。默认值为“remote,worker,sandboxed,local”。此标志会覆盖 --spawn_strategy 设置的值(如果与助记 Genrule 搭配使用,则还包括 --genrule_strategy 设置的值)。如需了解详情,请参阅 https://blog.bazel.build/2019/06/19/list-strategy.html。
标记: execution
已累计 --strategy_regexp=<a '<RegexFilter>=value[,value]' assignment> 次多次使用
替换应使用哪种生成策略来执行说明与特定 regex_filter 匹配的生成操作。如需详细了解 regex_filter 匹配,请参阅 --per_file_copt。使用与说明匹配的第一个 regex_filter。此选项将替换用于指定策略的其他标志。示例:--strategy_regexp=//foo.*\.cc,-//foo/bar=local 表示如果操作的说明与 //foo.*.cc 而非 //foo/bar 匹配,则使用本地策略执行相应操作。示例:--strategy_regexp='Compiling.*/bar=local --strategy_regexp=Compiling=sandboxed 使用“local”策略运行“Compiling //foo/bar/baz”,但是颠倒顺序则会使用“sandboxed”运行
标记: execution
已累计 --worker_extra_flag=<a 'name=value' assignment> 次多次使用
除了 --persistent_worker 之外,将传递给工作器进程的额外命令标志,由助记符进行键控(例如,--worker_extra_flag=Javac=--debug。
标记:executionhost_machine_resource_optimizations
已累计 --worker_max_instances=<[name=]value, where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5"> 次多次使用
使用“工作器”策略时,可以启动多少个工作器进程实例(如永久性 Java 编译器)。可指定为 [name=value],以便为每个工作器的助记符提供不同的值。接受整数或关键字(“auto”“HOST_CPUS”“HOST_RAM”),后面可选择性地后跟运算符 ([-|*]<float>),例如:"auto", "HOST_CPUS*.5"。“auto”根据机器容量计算合理的默认值。“=value”为未指定的助记符设置了默认值。
标记:executionhost_machine_resource_optimizations
已累计 --worker_max_multiplex_instances=<[name=]value, where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5"> 次多次使用
如果您将“worker”策略与 --experimental_worker_multiplex 结合使用,一个多路复用工作器进程可能会并行接收多少个 WorkRequest。可指定为 [name=value],以便为每个工作器的助记符提供不同的值。接受整数或关键字(“auto”“HOST_CPUS”“HOST_RAM”),后面可选择性地后跟运算符 ([-|*]<float>),例如:"auto", "HOST_CPUS*.5"。“auto”根据机器容量计算合理的默认值。“=value”为未指定的助记符设置了默认值。
标记:executionhost_machine_resource_optimizations
--[no]worker_quit_after_build 默认值:“false”
如果启用此选项,所有工作器将在构建完成后退出。
标记:executionhost_machine_resource_optimizations
--[no]worker_sandboxing 默认值:“false”
启用后,工作器将在沙盒环境中执行。
标记: execution
--[no]worker_verbose 默认值:“false”
启用后,系统会在工作器启动、关停等时输出详细消息
用于配置用于执行操作的工具链的选项:
--[no]incompatible_disable_runtimes_filegroups 默认值:“false”
废弃了空操作。
标记:action_command_linesloading_and_analysisdeprecatedincompatible_change
--[no]incompatible_dont_emit_static_libgcc 默认值:“true”
废弃了空操作。
标记:action_command_linesloading_and_analysisdeprecatedincompatible_change
废弃了空操作。
标记:action_command_linesloading_and_analysisdeprecatedincompatible_change
用于控制命令输出的选项:
--[no]build 默认值:“true”
执行构建;这是常见行为。指定 --nobuild 会导致构建在执行构建操作之前停止,并且在软件包加载和分析阶段成功完成时返回零;此模式对于测试这些阶段非常有用。
标记:executionaffects_outputs
--[no]experimental_run_validations 默认值:“true”
请改用 --run_validations。
标记:executionaffects_outputs
--[no]experimental_use_validation_aspect 默认值:“false”
是否使用切面运行验证操作(用于与测试的并行性)。
标记:executionaffects_outputs
已累计 --output_groups=<comma-separated list of options> 次多次使用
以英文逗号分隔的输出组名称列表,每个输出组名称可以选择添加 + 或 - 作为前缀。以 + 为前缀的组会添加到默认的输出组集中,而以 - 为前缀的组则会从默认输出组中移除。如果至少一个组不带前缀,系统会省略默认的输出组。例如,--output_groups=+foo,+bar 会构建默认集、foo 和 bar 的并集,而 --output_groups=foo,bar 会替换默认集,以便仅构建 foo 和 bar。
标记:executionaffects_outputs
--[no]run_validations 默认值:“true”
是否在构建过程中运行验证操作。请参阅 https://bazel.build/rules/rules#validation_actions
标记:executionaffects_outputs
可让用户配置预期输出的选项,这些选项会影响预期输出的值,而不会影响其存在性:
已累计 --aspects=<comma-separated list of options> 次多次使用
要应用于顶级目标的切面列表,以英文逗号分隔。在列表中,如果切面 some_aspect 通过 required_aspect_providers 指定所需的切面提供程序,则 some_aspect 将在切面列表中先提到的每一个切面运行后运行,并且其中通告的提供程序满足 some_aspect 要求的切面提供程序。此外,some_aspect 将在 require 属性指定的所有必需切面后运行。some_aspect 随后将可以访问这些切面的提供程序的值。<bzl-file-label>%<aspect_name>,例如“//tools:my_def.bzl%my_aspect”,其中“my_aspect”是文件 tools/my_def.bzl 中的顶级值
--bep_maximum_open_remote_upload_files=<an integer> 默认值:“-1”
上传 BEP 工件期间允许打开的文件数量上限。
标记: affects_outputs
此标志用于控制便捷符号链接(构建后显示在工作区中的符号链接)的管理方式。可能的值:normal(默认值):将创建或删除每种便捷符号链接,具体取决于 build。干净:所有符号链接将被无条件删除。ignore:符号链接将保持独立。log_only:生成日志消息的方式与传递“normal”,但实际上不执行任何文件系统操作(对工具很有用)。请注意,只有名称由“--symlink_prefix”的当前值生成的符号链接才会受到影响;如果前缀发生变化,所有现有的符号链接都将保持不变。
标记: affects_outputs
此标志可控制我们是否将 build eventConvenienceSymlinksIdentified 发布到 BuildEventProtocol。如果值为 true,BuildEventProtocol 将包含一个条目以方便使用 SymlinksIdentified,从而列出在您的工作区中创建的所有便捷符号链接。如果为 false,BuildEventProtocol 中的 smoothSymlinksIdentified 条目将为空。
标记: affects_outputs
已累计 --experimental_multi_cpu=<comma-separated list of options> 次多次使用
已废弃。无操作。
标记:affects_outputsexperimental
--remote_download_minimal
不会将任何远程构建输出下载到本地机器。此标志是标志的快捷方式:--experimental_inmemory_jdeps_files、--experimental_inmemory_dotd_files、--experimental_action_cache_store_output_metadata 和 --remote_download_outputs=minimal。
扩展为:
  --nobuild_runfile_links
  --experimental_inmemory_jdeps_files
  --experimental_inmemory_dotd_files
  --experimental_action_cache_store_output_metadata
  --remote_download_outputs=minimal

标记: affects_outputs
--remote_download_outputs=<all, minimal or toplevel> 默认值:“all”
如果设置为“minimal”,系统不会将任何远程构建输出下载到本地机器,本地操作所需的输出除外。如果将此属性设置为 'toplevel',则其行为类似于'minimal',但也会将顶级目标的输出下载到本地计算机。如果网络带宽是瓶颈,那么这两种方案都可以显著缩短构建时间。
标记: affects_outputs
创建符号链接,而不是将远程构建输出下载到本地机器。您可以通过模板字符串形式指定符号链接的目标。此模板字符串可能包含 {hash} 和 {size_bytes},分别扩展为对象的哈希值和大小(以字节为单位)。例如,这些符号链接可能指向根据需要从 CAS 加载对象的 FUSE 文件系统。
标记: affects_outputs
--remote_download_toplevel
仅将顶级目标的远程输出下载到本地机器。此标志是标志的快捷方式:--experimental_inmemory_jdeps_files、--experimental_inmemory_dotd_files、--experimental_action_cache_store_output_metadata 和 --remote_download_outputs=toplevel。
会展开为:
  --experimental_inmemory_jdeps_files
  --experimental_inmemory_dotd_files
  --experimental_action_cache_store_output_metadata
  --remote_download_outputs=toplevel

标记: affects_outputs
在构建后创建的任何便捷符号链接前作为前缀的前缀。如果省略此参数,则默认值为构建工具的名称后跟连字符。如果传递“/”,则不会创建符号链接,也不会发出警告。警告:“/”的特殊功能即将弃用;请改用 --experimental_convenience_symlinks=ignore。
标记: affects_outputs
影响 Bazel 强制执行有效 build 输入的严格程度的选项(规则定义、标志组合等):
--[no]experimental_docker_privileged 默认值:“false”
启用后,Bazel 会在运行操作时将 --privileged 标志传递“docker run”。您的 build 可能需要这样做,但这也可能会导致封闭性降低。
标记: execution
--experimental_repository_hash_file=<a string> 默认值:“”
如果非空,请指定一个包含解析值的文件,应针对该值验证代码库目录哈希值
标记:affects_outputsexperimental
如果为 true,则会将指定为操作输入的符号链接的目标映射到沙盒中。此功能纯粹是为了解决存在漏洞的规则,这些规则无法自行执行,应在修复所有此类规则后移除。
标记:host_machine_resource_optimizationsexecution
已累计 --experimental_verify_repository_rules=<a string> 次多次使用
如果要验证输出目录的哈希值的代码库规则列表,则要通过 --experimental_repo_hash_file 指定文件。
标记:affects_outputsexperimental
--[no]incompatible_legacy_local_fallback 默认值:“true”
如果设置为 true,系统会启用从沙盒化策略到本地策略的旧版隐式回退。此标志最终将默认为 false,然后变为空操作。请改用 --strategy、--spawn_strategy 或 --dynamic_local_strategy 配置回退。
标记:executionincompatible_change
已累计 --sandbox_add_mount_pair=<a single path or a 'source:target' pair> 次多次使用
添加要在沙盒中装载的其他路径对。
标记: execution
已累计 --sandbox_block_path=<a string> 次多次使用
对于沙盒化操作,请禁止访问此路径。
标记: execution
--[no]sandbox_default_allow_network 默认值:“true”
默认允许操作访问网络;这可能并不适用于所有沙盒实现。
--[no]sandbox_fake_hostname 默认值:“false”
对于沙盒化操作,请将当前主机名更改为“localhost”。
标记: execution
--[no]sandbox_fake_username 默认值:“false”
如需执行沙盒化操作,请将当前用户名更改为“nobody”。
标记: execution
已累计 --sandbox_writable_path=<a string> 次多次使用
对于沙盒化操作,使现有目录可在沙盒中写入(如果沙盒实现支持,否则请忽略)。
标记: execution
此选项会影响 Starlark 语言或 build 文件、.bzl 文件或 WORKSPACE 文件可访问的 build API 的语义。
--[no]experimental_allow_top_level_aspects_parameters 默认值:“true”
无操作
标记:no_opdeprecatedexperimental
--[no]incompatible_config_setting_private_default_visibility 默认值:“false”
如果 incompatible_enforce_config_setting_visibility=false,则代表着空操作。否则,如果此标志为 false,则没有明确可见性属性的任何 config_setting 都是 //visibility:public。如果此标志为 true,config_setting 遵循与所有其他规则相同的可见性逻辑。请参阅 https://github.com/bazelbuild/bazel/issues/12933。
标记:loading_and_analysisincompatible_change
--[no]incompatible_enforce_config_setting_visibility 默认值:“true”
如果为 true,则强制执行 config_setting 公开范围限制。如果为 false,则每个 config_setting 对每个目标都可见。请参阅 https://github.com/bazelbuild/bazel/issues/12932。
标记:loading_and_analysisincompatible_change
用于控制测试环境或测试运行程序的行为的选项:
--[no]check_tests_up_to_date 默认值:“false”
请勿运行测试,只需检查它们是否为最新版本即可。如果所有测试结果均为最新,则表示测试成功完成。如果需要构建或执行任何测试,则系统会报告错误,并且测试会失败。此选项意味着 --check_up_to_date 行为。
标记: execution
已累计 --flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once> 次多次使用
如果测试失败,每个测试的重试次数不会超过指定次数。需要多次尝试通过的测试在测试摘要中会被标记为“FLAKY”。通常,指定的值只是一个整数或字符串“default”。如果是整数,则所有测试最多运行 N 次。如果为“default”,则对于常规测试,将仅执行一次测试尝试;对于被其规则(flaky=1 属性)明确标记为不稳定的测试,将执行三次测试。替代语法:regex_filter@flaky_test_attempts。其中 flaky_test_attempts 与上述示例相同,而 regex_filter 代表包含和排除正则表达式模式的列表(另请参阅 --runs_per_test)。示例:--flaky_test_attempts=//foo/.*,-//foo/bar/.*@3 将 //foo/ 中的所有测试除 foo/bar 下的测试之外的所有测试三次均不稳定。可以多次传递此选项。最新传递且匹配的参数优先。如果没有匹配项,则行为就像上面的“default”(默认)一样。
标记: execution
--local_test_jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5"> 默认值:“auto”
要同时运行的本地测试作业数量上限。接受整数或关键字(“auto”“HOST_CPUS”“HOST_RAM”),后面可选择性地后跟运算符 ([-|*]<float>),例如:"auto", "HOST_CPUS*.5"。0 表示本地资源将限制并发运行的本地测试作业数量。如果将此值设置为大于 --jobs 的值,则没有效果。
标记: execution
--[no]test_keep_going 默认值:“true”
停用后,任何未通过的测试都会导致整个 build 停止。默认情况下,系统会运行所有测试,即使某些测试没有通过也是如此。
标记: execution
--test_strategy=<a string> 默认值:“”
指定在运行测试时要使用的策略。
标记: execution
--test_tmpdir=<a path> 默认值:请参阅说明
指定供“bazel test”使用的基本临时目录。
与 Bzlmod 输出和语义相关的选项:
已累计 --allow_yanked_versions=<a string> 次多次使用
以 `<module1>@<version1>,<module2>@<version2>` 的形式指定模块版本,即使这些版本在来源的注册表中被声明了(如果它们不是来自 NonRegistryOverride),也会显示在已解析的依赖关系图中。否则,拉取版本将导致解析失败。您还可以使用 `BZLMOD_ALLOW_YANKED_VERSIONS` 环境变量定义允许的拖动版本。您可以使用关键字“all”停用此检查(不推荐)。
标记: loading_and_analysis
--check_bazel_compatibility=<error, warning or off> 默认值:“error”
检查 Bazel 模块的 Bazel 版本兼容性。有效值包括:“error”表示处理失败,“off”表示停用检查,“warning”表示检测到不匹配的情况时会显示警告。
标记: loading_and_analysis
--check_direct_dependencies=<off, warning or error> 默认值:“警告”
检查根模块中声明的直接“bazel_dep”依赖项是否与已解析的依赖关系图中的版本相同。有效值为 `off` 表示停用检查,`warning` 表示在检测到不匹配的情况时输出警告,或者是 `error`(用于将问题升级为解析失败)。
标记: loading_and_analysis
--[no]ignore_dev_dependency 默认值:“false”
如果为 true,Bazel 会忽略根模块的 MODULE.bazel 中声明为“dev_dependency”的“bazel_dep”和“use_extension”。请注意,无论此标志的值为何,只要不是根模块,MODULE.bazel 中就会始终忽略这些开发者依赖项。
标记: loading_and_analysis
--lockfile_mode=<off, update or error> 默认值:“off”
指定如何以及是否使用锁定文件。有效值包括:“update”表示使用 lockfile 并在发生变更时更新它;“error”表示使用 lockfile,但如果该文件不是最新状态,则会抛出错误;或者“off”表示既不从锁定文件读取数据,也不会向锁定文件写入数据。
标记: loading_and_analysis
已累计 --override_module=<an equals-separated mapping of module name to path> 次多次使用
替换采用 <模块名称>=<path> 形式的本地路径的模块。如果指定路径是绝对路径,系统将按原样使用该路径。如果指定路径是相对路径,则该路径相对于当前工作目录。如果指定路径以“%workspace%”开头,则该路径相对于工作区根目录,即“bazel info workspace”的输出
已累计 --registry=<a string> 次多次使用
指定用于查找 Bazel 模块依赖项的注册表。顺序很重要:系统会先在之前的注册表中查找模块,只有在之前的注册表中缺失模块时,才会回退到靠后的注册表。
标记: changes_inputs
影响日志记录的详细程度、格式或位置的选项:
--[no]announce 默认值:“false”
已废弃。无操作。
标记:affects_outputs
--[no]debug_spawn_scheduler 默认值:“false”
--[no]experimental_bep_target_summary 默认值:“false”
是否发布 TargetSummary 事件。
--[no]experimental_build_event_expand_filesets 默认值:“false”
如果为 true,则会在显示输出文件时展开 BEP 中的文件集。
标记: affects_outputs
如果为 true,则在显示输出文件时完全解析 BEP 中的相对 Fileset 符号链接。需要 --experimental_build_event_expand_filesets。
标记: affects_outputs
--experimental_build_event_upload_max_retries=<an integer> 默认值:“4”
Bazel 应重新尝试上传构建事件的次数上限。
标记: bazel_internal_configuration
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.> 默认值:“1s”
BEP 上传失败时指数退避算法重试的初始延迟时间下限。(指数:1.6)
标记:bazel_internal_configuration
--experimental_build_event_upload_strategy=<a string> 默认值:请参阅说明
选择如何上传构建事件协议中引用的工件。
标记: affects_outputs
--[no]experimental_collect_local_sandbox_action_metrics 默认值:“true”
启用后,系统会为使用沙盒的本地执行操作记录执行统计信息(例如用户和系统时间)
标记: execution
--[no]experimental_docker_verbose 默认值:“false”
启用后,Bazel 将输出有关 Docker 沙盒策略的更详细消息。
标记: execution
--[no]experimental_materialize_param_files_directly 默认值:“false”
如果要具体化参数文件,请通过直接写入磁盘来实现。
标记: execution
--[no]experimental_record_metrics_for_all_mnemonics 默认值:“false”
默认情况下,操作类型的数量不得超过 20 种已执行操作数量最多的助记符。设置此选项会写入所有助记符的统计信息。
--experimental_repository_resolved_file=<a string> 默认值:“”
如果为非空,则写入一个 Starlark 值,其中包含已执行的所有 Starlark 代码库规则的解析信息。
标记: affects_outputs
--[no]experimental_stream_log_file_uploads 默认值:“false”
将日志文件上传内容直接流式传输到远程存储空间,而不是将其写入磁盘。
标记: affects_outputs
--explain=<a path> 默认值:请参阅说明
使构建系统解释构建的每个已执行步骤。说明将写入指定的日志文件。
标记: affects_outputs
--[no]legacy_important_outputs 默认值:“true”
使用此方法可禁止在 TargetComplete 事件中生成旧版 important_outputs 字段。Bazel 到 ResultStore 集成需要包含 important_outputs。
标记: affects_outputs
--[no]materialize_param_files 默认值:“false”
即使在使用远程操作执行时,也会将中间参数文件写入输出树。在调试操作时很有用。这是 --subcommands 和 --verbose_failures 暗示的。
标记: execution
--max_config_changes_to_show=<an integer> 默认值:“3”
如果因构建选项的变化而舍弃分析缓存,则最多可显示指定数量的已更改选项名称。如果给定数字为 -1,系统将显示所有已更改的选项。
标记: terminal_output
--max_test_output_bytes=<an integer> 默认值:“-1”
指定当 --test_output 为“errors”或“all”时可以发出的每个测试日志的最大大小。有助于避免过于嘈杂的测试输出导致输出不堪重负。测试标头会计入日志大小。负值表示无限制。输出内容可以是全部或零。
标记:test_runnerterminal_outputexecution
--output_filter=<a valid Java regular expression> 默认值:请参阅说明
仅显示名称与提供的正则表达式匹配的规则的警告。
标记: affects_outputs
--progress_report_interval=<an integer in 0-3600 range> 默认值:“0”
报告仍在运行的作业之间间隔的秒数。默认值 0 表示将在 10 秒后输出第一份报告,然后在 30 秒后输出第一份报告,之后每分钟报告一次进度。启用 --curses 后,每秒报告一次进度。
标记: affects_outputs
--remote_print_execution_messages=<failure, success or all> 默认值:“failure”
选择何时输出远程执行消息。有效值为“failure”,表示仅在失败时输出,用“success”表示仅在成功时输出,值为“all”,表示始终输出。
标记: terminal_output
--[no]sandbox_debug 默认值:“false”
为沙盒功能启用调试功能。这包括两点:首先,沙盒根内容在构建后保持不变(如果使用 sandboxfs,则文件系统将保持装载状态);第二,在执行时输出额外的调试信息。这有助于 Bazel 或 Starlark 规则的开发者解决因缺少输入文件等而导致调试失败的问题。
标记: terminal_output
--show_result=<an integer> 默认值:“1”
显示构建结果。对于每个目标,请说明其是否已更新为最新版本;如果是,则显示已构建的输出文件列表。输出的文件是方便复制并粘贴到 shell 中的字符串。此选项需要一个整数参数,该参数是目标值的阈值,超过该值将不会输出结果信息。因此,零会导致抑制消息,而 MAX_INT 则会导致始终输出结果。默认值为 1。
标记: affects_outputs
--[no]subcommands [-s] 默认值:“false”
显示构建期间执行的子命令。相关标志:--execution_log_json_file、--execution_log_binary_file(用于以适合工具的格式将子命令记录到文件中)。
标记: terminal_output
--test_output=<summary, errors, all or streamed> 默认值:“summary”
指定所需的输出模式。有效值包括:“summary”用于仅输出测试状态摘要,“errors”用于输出失败测试的测试日志,“all”用于输出所有测试的日志,“streamed”用于实时输出所有测试的输出日志(这会强制在本地执行一个测试,无论 --test_strategy 值如何)。
标记:test_runnerterminal_outputexecution
--test_summary=<short, terse, detailed, none or testcase> 默认值:“short”
指定所需的测试摘要格式。有效值为“short”,用于仅输出关于已执行的测试的信息;“terse”用于仅输出关于运行失败的测试的信息;“detailed”用于输出有关失败的测试用例的详细信息;“testcase”用于输出关于测试用例分辨率的摘要;不输出有关失败测试用例的详细信息;“none”用于省略摘要。
标记: terminal_output
--[no]verbose_explanations 默认值:“false”
启用 --explain 时,可提高所发出说明的详细程度。如果未启用 --explain,则无效。
标记: affects_outputs
--[no]verbose_failures 默认值:“false”
如果某个命令失败,则输出完整的命令行。
标记: terminal_output
用于指定或更改不属于其他类别的 Bazel 命令的通用输入的选项:
已累计 --aspects_parameters=<a 'name=value' assignment> 次多次使用
指定命令行切面参数的值。每个参数值都是通过 <param_name>=<param_value> 指定的,例如“my_param=my_val”,其中“my_param”是 --aspects 列表中的某一方面的参数,或列表中的某一方面所需的参数。此选项可多次使用。但是,不允许为同一参数多次指定值。
标记: loading_and_analysis
--experimental_resolved_file_instead_of_workspace=<a string> 默认值:“”
如果为非空,则读取指定的已解析文件而不是 WORKSPACE 文件
标记: changes_inputs
--target_pattern_file=<a string> 默认值:“”
如果设置此参数,build 将从此处(而不是命令行)指定的文件中读取模式。在此处指定文件以及命令行模式是错误的。
标记: changes_inputs
远程缓存和执行选项:
--experimental_circuit_breaker_strategy=<failure> 默认值:请参阅说明
指定断路器要使用的策略。可用策略为“失败”。选项的值无效时,与未设置此选项的行为相同。
标记: execution
--experimental_downloader_config=<a string> 默认值:请参阅说明
指定要用于配置远程下载程序的文件。此文件由几行组成,每个行都以指令(“allow”“block”或“rewrite”)开头,后跟主机名(分别用于“allow”和“block”)或两种格式,一种用于匹配,另一种用作替代网址,反向引用从“$1”开始。在这种情况下,系统可能会返回多个“rewrite”指令,供同一个网址提供,在这种情况下,系统会返回多个网址。
--[no]experimental_guard_against_concurrent_changes 默认值:“false”
关闭此设置可禁止在将操作上传到远程缓存之前检查其输入文件的 ctime。在某些情况下,Linux 内核会延迟写入文件,从而导致误报。
--experimental_remote_build_event_upload=<all or minimal> 默认值:“all”
如果设置为“all”,BEP 引用的所有本地输出都将上传到远程缓存。如果设置为“minimal”,则 BEP 引用的本地输出不会上传到远程缓存,但对 BEP 使用者很重要的文件(例如测试日志和计时配置文件)除外。即使文件在远程缓存中缺失,也会始终使用 bytestream:// 架构。 默认值为“all”。
--[no]experimental_remote_cache_async 默认值:“false”
如果为 true,远程缓存 I/O 将在后台进行,而不是在生成过程中进行。
--[no]experimental_remote_cache_compression 默认值:“false”
启用后,使用 zstd 压缩/解压缩缓存 blob。
--experimental_remote_cache_eviction_retries=<an integer> 默认值:“0”
在构建遇到远程缓存逐出错误时重试的最大次数。非零值会将 --incompatible_remote_use_new_exit_code_for_lost_inputs 隐式设置为 true。系统会针对每次尝试生成一个新的调用 ID。如果您生成调用 ID 并使用 --invocation_id 将其提供给 Bazel,则不应使用此标志,请改为设置 标志 --incompatible_remote_use_new_exit_code_for_lost_inputs 并检查退出代码 39。
标记: execution
--experimental_remote_capture_corrupted_outputs=<a path> 默认值:请参阅说明
将捕获损坏输出的目录的路径。
--[no]experimental_remote_discard_merkle_trees 默认值:“false”
如果设置为 true,则会在调用 GetActionResult() 和 Execute() 期间舍弃输入根的 Merkle 树和关联输入映射的内存中副本。这样可以显著减少内存用量,但需要 Bazel 在远程缓存未命中和重试时重新计算这些副本。
--experimental_remote_downloader=<a string> 默认值:请参阅说明
要用作远程下载代理的 Remote Asset API 端点 URI。支持的架构包括 grpc、grpcs(已启用 TLS 的 grpc)和 unix(本地 UNIX 套接字)。如果未提供架构,Bazel 将默认使用 grpc。请参阅:https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto
--[no]experimental_remote_downloader_local_fallback 默认值:“false”
如果远程下载程序失败,是否回退到本地下载程序。
--[no]experimental_remote_execution_keepalive 默认值:“false”
是否对远程执行调用使用 keepalive。
--experimental_remote_failure_rate_threshold=<an integer in 0-100 range> 默认值:“10”
设置特定时间范围内允许的失败率(以百分比表示),超过此时限后就会停止调用远程缓存/执行器。默认情况下,值为 10。将此值设为 0 表示无限制。
标记: execution
--experimental_remote_failure_window_interval=<An immutable length of time.> 默认值:“60s”
计算远程请求失败率的时间间隔。如果值为 0 或负值,则计算失败时长的总执行时长。可以使用以下单位:天 (d)、小时 (h)、分钟 (m)、秒 (s) 和毫秒 (ms)。如果省略单位,则值将解读为秒。
标记: execution
--[no]experimental_remote_mark_tool_inputs 默认值:“false”
如果设置为 true,Bazel 会将输入标记为远程执行程序的工具输入。这可用于实现远程持久性工作器。
--[no]experimental_remote_merkle_tree_cache 默认值:“false”
如果设置为 true,系统会记住 Merkle 树计算,以提高远程缓存命中检查速度。缓存的内存足迹由 --experimental_remote_merkle_tree_cache_size 控制。
--experimental_remote_merkle_tree_cache_size=<a long integer> 默认值:“1000”
为了提高远程缓存命中检查速度而要记忆的 Merkle 树数量。虽然缓存会根据 Java 对软引用的处理自动删减,但如果设置得过高,可能会出现内存不足错误。如果设置为 0,则缓存大小不受限制。最佳值因项目规模而异。默认值为 1,000。
--[no]experimental_remote_require_cached 默认值:“false”
如果设置为 true,系统会强制缓存所有可以远程运行的操作,否则会导致构建失败。这对于排查非确定性问题非常有用,因为它可以检查本应缓存的操作是否实际缓存,而不会错误地将新结果注入缓存。
--[no]incompatible_remote_build_event_upload_respect_no_cache 默认值:“false”
如果设置为 true,则在无法远程缓存生成的操作时,BEP 引用的输出不会上传到远程缓存。
--[no]incompatible_remote_downloader_send_all_headers 默认值:“true”
是否将一个多值标头的所有值(而不只是第一个值)发送给远程下载程序。
标记: incompatible_change
--[no]incompatible_remote_output_paths_relative_to_input_root 默认值:“false”
如果设置为 true,则输出路径将相对于输入根目录(而不是工作目录)。
标记: incompatible_change
--[no]incompatible_remote_results_ignore_disk 默认值:“true”
如果设置为 true,--noremote_upload_local_results 和 --noremote_accept_cached 将不会应用于磁盘缓存。如果使用组合缓存: --noremote_upload_local_results 将导致结果被写入磁盘缓存,但不会上传到远程缓存。 --noremote_accept_cached 则会导致 Bazel 检查磁盘缓存中的结果,但不会检查远程缓存中的结果。 no-remote-exec 操作可能会命中磁盘缓存。 如需了解详情,请参阅 #8216。
标记: incompatible_change
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs 默认值:“false”
如果设置为 true,那么当远程缓存在构建期间逐出 blob 时,Bazel 将使用新的退出代码 39(而不是 34)。
标记: incompatible_change
--[no]remote_accept_cached 默认值:“true”
是否接受远程缓存的操作结果。
--remote_bytestream_uri_prefix=<a string> 默认值:请参阅说明
在写入构建事件流的 bytestream:// URI 中使用的主机名和实例名称。使用代理执行构建时可以设置此选项,这会导致 --remote_executor 和 --remote_instance_name 的值不再与远程执行服务的规范名称相对应。如果未设置,则默认为“${hostname}/${instance_name}”。
--remote_cache=<a string> 默认值:请参阅说明
缓存端点的 URI。支持的架构包括 http、https、grpc、grpcs(已启用 TLS 的 grpc)和 unix(本地 UNIX 套接字)。如果未提供架构,Bazel 将默认使用 grpc。指定 grpc://、http:// 或 unix: 架构以停用 TLS。请参阅 https://bazel.build/remote/caching
已累计 --remote_cache_header=<a 'name=value' assignment> 次多次使用
指定要包含在缓存请求中的标头:--remote_cache_header=Name=Value。可以通过多次指定标志来传递多个标头。如果名称相同的多个值,系统会将其转换为以英文逗号分隔的列表。
已累计 --remote_default_exec_properties=<a 'name=value' assignment> 次多次使用
如果执行平台尚未设置 exec_properties,请设置要用作远程执行平台的默认 exec 属性。
标记: affects_outputs
--remote_default_platform_properties=<a string> 默认值:“”
如果执行平台尚未设置 remote_execution_properties,请设置要为远程执行 API 设置的默认平台属性。如果主机平台被选作远程执行的执行平台,也将使用此值。
已累计 --remote_downloader_header=<a 'name=value' assignment> 次多次使用
指定将在远程下载程序请求中包含的标头:--remote_downloader_header=Name=Value。可以通过多次指定标志来传递多个标头。如果名称相同的多个值,系统会将其转换为以英文逗号分隔的列表。
已累计 --remote_exec_header=<a 'name=value' assignment> 次多次使用
指定要包含在执行请求的标头:--remote_exec_header=Name=Value。可以通过多次指定标志来传递多个标头。如果名称相同的多个值,系统会将其转换为以英文逗号分隔的列表。
--remote_execution_priority=<an integer> 默认值:“0”
要远程执行的操作的相对优先级。特定优先级值的语义取决于服务器。
--remote_executor=<a string> 默认值:请参阅说明
远程执行端点的 HOST 或 HOST:PORT。支持的架构包括 grpc、grpcs(已启用 TLS 的 grpc)和 unix(本地 UNIX 套接字)。如果未提供架构,Bazel 将默认使用 grpc。指定 grpc:// 或 unix: 架构以停用 TLS。
--remote_grpc_log=<a path> 默认值:请参阅说明
如果指定,则为记录 gRPC 调用相关详细信息的文件的路径。此日志由一系列序列化的 com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry protobufs 组成,每条消息都带有一个 varint 前缀,表示以下序列化 protobuf 消息的大小,由 LogEntry.writeDelimitedTo(OutputStream) 方法执行。
已累计 --remote_header=<a 'name=value' assignment> 次多次使用
指定要包含在请求中的标头:--remote_header=Name=Value。可以通过多次指定标志来传递多个标头。如果名称相同的多个值,系统会将其转换为以英文逗号分隔的列表。
--remote_instance_name=<a string> 默认值:“”
在远程执行 API 中作为 instance_name 传递的值。
--[no]remote_local_fallback 默认值:“false”
如果远程执行失败,是否回退到独立的本地执行策略。
--remote_local_fallback_strategy=<a string> 默认值:“local”
无操作,已废弃。如需了解详情,请参阅 https://github.com/bazelbuild/bazel/issues/7480。
--remote_max_connections=<an integer> 默认值:“100”
限制远程缓存/执行器的并发连接数上限。默认情况下,该值为 100。将此值设为 0 表示无限制。 对于 HTTP 远程缓存,一个 TCP 连接一次可以处理一个请求,因此 Bazel 可以最多构建 --remote_max_connections 并发请求。 对于 gRPC 远程缓存/执行器,一个 gRPC 通道通常可以处理 100 多个并发请求,因此 Bazel 可以大约发出“--remote_max_connections * 100”个并发请求。
标记: host_machine_resource_optimizations
--remote_proxy=<a string> 默认值:请参阅说明
通过代理连接到远程缓存。目前,此标志只能用于配置 Unix 网域套接字 (unix:/path/to/socket)。
--remote_result_cache_priority=<an integer> 默认值:“0”
要存储在远程缓存中的远程操作的相对优先级。特定优先级值的语义取决于服务器。
--remote_retries=<an integer> 默认值:“5”
重试暂时性错误的最大尝试次数。如果设置为 0,系统会停用重试。
--remote_retry_max_delay=<An immutable length of time.> 默认值:“5s”
远程重试尝试之间的最大退避延迟时间。您可以使用以下单位:天 (d)、小时 (h)、分钟 (m)、秒 (s) 和毫秒 (ms)。如果省略单位,则值将解读为秒。
--remote_timeout=<An immutable length of time.> 默认值:“60s”
等待远程执行和缓存调用的最长时间。对于 REST 缓存,这是指连接和读取超时。您可以使用以下单位:天 (d)、小时 (h)、分钟 (m)、秒 (s) 和毫秒 (ms)。如果省略单位,则值将解读为秒。
--[no]remote_upload_local_results 默认值:“true”
决定是否将本地执行的操作结果上传到远程缓存(如果远程缓存支持且用户已获得执行此操作的授权)。
--[no]remote_verify_downloads 默认值:“true”
如果设置为 true,Bazel 会计算所有远程下载的哈希总和,并舍弃远程缓存的值(如果这些值与预期值不匹配)。
其他未分类的选项:
--[no]allow_analysis_cache_discard 默认值:“true”
如果由于构建系统的更改而舍弃分析缓存,则将此选项设置为 false 将导致 bazel 退出,而不是继续进行构建。同时设置了“discard_analysis_cache”时,此选项无效。
标记: eagerness_to_exit
--auto_output_filter=<none, all, packages or subpackages> 默认值:“none”
如果未指定 --output_filter,则此选项的值会自动创建过滤器。允许的值包括“none”(不过滤 / 显示所有内容)、“all”(过滤所有内容 / 不显示任何内容)、“packages”(包括 Blaze 命令行中提及的软件包内的规则输出)和“子软件包”(如“软件包”,但也包含子软件包)。对于“packages”和“subpackages”,值 //java/foo 和 //javatests/foo using one package)'。
--[no]build_manual_tests 默认值:“false”
强制构建标记为“manual”的测试目标。“手动”测试不会处理。此选项会强制构建(但不执行)。
--build_tag_filters=<comma-separated list of options> 默认值:“”
指定以逗号分隔的标记列表。您可以选择在每个代码前面加上“-”,以指定排除的代码。系统只会构建包含至少一个包含标记且不包含任何已排除标记的目标。此选项不会影响使用“test”命令执行的测试集;它们受测试过滤选项(例如“--test_tag_filters”)的约束
--[no]build_tests_only 默认值:“false”
如果指定,则仅构建 *_test 和 test_suite 规则,并忽略命令行中指定的其他目标。默认情况下,系统将构建请求的所有内容。
--combined_report=<none or lcov> 默认值:“none”
指定所需的累计覆盖率报告类型。目前仅支持 LCOV。
--[no]compile_one_dependency 默认值:“false”
编译参数文件的单个依赖项。这对于 IDE 中的语法检查源文件非常有用,例如,通过重新构建依赖于源文件的单个目标,在编辑/构建/测试周期中尽早检测到错误。此参数会影响所有非 flag 参数的解释方式;它们不是构建目标,而是源文件名。对于每个源文件名,系统将构建一个依赖于该文件名的任意目标。
已累计 --credential_helper=<Path to a credential helper. It may be absolute, relative to the PATH environment variable, or %workspace%-relative. The path be optionally prefixed by a scope followed by an '='. The scope is a domain name, optionally with a single leading '*' wildcard component. A helper applies to URIs matching its scope, with more specific scopes preferred. If a helper has no scope, it applies to every URI.> 次多次使用
配置凭据帮助程序,用于检索代码库提取、远程缓存和执行以及构建事件服务的授权凭据。 帮助程序提供的凭据优先于 --google_default_credentials、--google_credentials、.netrc 文件或存储库 _ A 下载 和 库 _ . 下载和提取 的 auth 参数提供的凭据。 可以多次指定此参数以设置多个帮助程序。 如需了解详情,请参阅 https://github.com/bazelbuild/proposals/blob/main/designs/2022-06-07-bazel-credential-helpers.md。
--credential_helper_cache_duration=<An immutable length of time.> 默认值:“30m”
凭据帮助程序提供的凭据的缓存时长。 使用其他值调用将调整先前存在的条目的有效期;传递零可清除缓存。无论此标志为何,干净命令始终会清除缓存。
--credential_helper_timeout=<An immutable length of time.> 默认值:“10s”
配置凭据帮助程序的超时时间。 凭据帮助程序未能在此超时时间内响应将使调用失败。
--deleted_packages=<comma-separated list of package names> 默认值:“”
以逗号分隔的软件包名称列表,构建系统将其视为不存在的软件包名称,即使这些软件包在软件包路径上的某个位置可见。 当删除现有包“x”的子包“x/y”时,使用此选项。例如,在客户端中删除 x/y/BUILD 后,如果编译系统遇到标签“//x:y/z”(如果仍然由另一个 package_path 条目提供),则可能会收到错误消息。指定 --deleted_packages x/y 可避免此问题。
--[no]discard_analysis_cache 默认值:“false”
在分析阶段完成后立即舍弃分析缓存。将内存用量减少约 10%,但会减慢进一步增量构建的速度。
--disk_cache=<a path> 默认值:请参阅说明
一个目录的路径,Bazel 可以在该目录中读取和写入操作及操作输出。如果该目录不存在,系统将会创建该目录。
--embed_label=<a one-line string> 默认值:“”
在二进制文件中嵌入源代码控制修订版本或版本标签
--execution_log_binary_file=<a path> 默认值:请参阅说明
根据 src/main/protobuf/spawn.proto,将执行的生成项目作为分隔的 Spawn proto 记录到此文件中。该日志首先无序写入,然后在调用结束时按稳定顺序排序(可能是 CPU 和内存密集型)。相关标志:--execution_log_json_file(有序文本 JSON 格式)、--experimental_execution_log_file(无序二进制 protobuf 格式)、--subcommands(用于在终端输出中显示子命令)。
--execution_log_json_file=<a path> 默认值:请参阅说明
根据 src/main/protobuf/spawn.proto,将已执行的生成操作以 json 表示形式记录到此文件中,这些表示要分隔的 Spawn proto。该日志首先无序写入,然后在调用结束时按稳定顺序排序(可能是 CPU 和内存密集型)。相关标志:相关标志:--execution_log_binary_file(有序二进制 protobuf 格式)、--experimental_execution_log_file(无序二进制 protobuf 格式)、--subcommands(用于在终端输出中显示子命令)。
--[no]execution_log_sort 默认值:“true”
是否对执行日志进行排序。设置为 false 可提高内存性能,但代价是以不确定的顺序生成日志。
--[no]expand_test_suites 默认值:“true”
先将 test_suite 目标扩展为其组成部分测试,然后再进行分析。当此标志处于启用状态(默认设置)时,排除性目标模式将应用于属于该测试套件的测试,否则不会应用于属于该测试套件的测试。如果在命令行中应用顶级切面,则关闭此标记会很有用:这样它们就可以分析 test_suite 目标。
标记: loading_and_analysis
--experimental_execution_log_file=<a path> 默认值:请参阅说明
根据 src/main/protobuf/spawn.proto,将执行的生成项目作为分隔的 Spawn proto 记录到此文件中。该文件是按照“Spawns”执行顺序写入的。相关标志:--execution_log_binary_file(有序的二进制 protobuf 格式)、--execution_log_json_file(有序文本 json 格式)、--subcommands(用于在终端输出中显示子命令)。
--[no]experimental_execution_log_spawn_metrics 默认值:“false”
在已执行的生成项日志中包含生成指标。
--experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths> 默认值:“”
废弃了,取而代之的是切面。过滤要调度 extra_action 的一组目标。
--[no]experimental_extra_action_top_level_only 默认值:“false”
废弃了,取而代之的是切面。仅为顶级目标安排 extra_actions。
--[no]experimental_prioritize_local_actions 默认值:“true”
如果设置了此属性,那么只能在本地运行的操作有第一次获取资源的机会,动态运行的工作器有第二次机会,动态运行的独立操作最后才有机会。
标记: execution
--experimental_spawn_scheduler
通过在本地和远程并行运行操作,实现动态执行。Bazel 在本地和远程生成每个操作,并选择最先完成的操作。如果某个操作支持 worker,则本地操作将在永久性 worker 模式下运行。如需为单个操作助记符启用动态执行功能,请改用“--internal_spawn_scheduler”和“--strategy=<mnemonic>=dynamic”标志。
扩展为:
  --internal_spawn_scheduler
  --spawn_strategy=dynamic
--google_auth_scopes=<comma-separated list of options> 默认值:“https://www.googleapis.com/auth/cloud-platform”
以逗号分隔的 Google Cloud 身份验证范围列表。
--google_credentials=<a string> 默认值:请参阅说明
指定从中获取身份验证凭据的文件。如需了解详情,请参阅 https://cloud.google.com/docs/authentication。
--[no]google_default_credentials 默认值:“false”
是否使用“Google 应用默认凭据”进行身份验证。如需了解详情,请参阅 https://cloud.google.com/docs/authentication。默认处于停用状态。
--grpc_keepalive_time=<An immutable length of time.> 默认值:请参阅说明
为传出 gRPC 连接配置 keep-alive ping。如果已设置,则 Bazel 会在连接上无读取操作这么长时间后发送 ping,但前提是至少有一个待处理的 gRPC 调用。时间被视为第二粒度;设置小于 1 秒的值是错误的。默认情况下, keep-alive ping 处于停用状态。在启用此设置前,请与服务所有者协调。例如,如需为此标志设置 30 秒的值,应按如下方式设置:--grpc_keepalive_time=30s
--grpc_keepalive_timeout=<An immutable length of time.> 默认值:“20s”
为传出 gRPC 连接配置 keep-alive 超时。如果通过 --grpc_keepalive_time 启用 keep-alive ping,则如果 Bazel 在这段时间后未收到 ping 回复,则会超时连接。时间被视为第二粒度;设置小于 1 秒的值是错误的。如果 keep-alive ping 处于停用状态,则忽略此设置。
--[no]ignore_unsupported_sandboxing 默认值:“false”
此系统不支持沙盒化执行时,不输出警告。
--[no]incompatible_dont_use_javasourceinfoprovider 默认值:“false”
空操作
标记: incompatible_change
--local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.> 默认值:“HOST_CPUS”
明确设置可供 Bazel 用于在本地执行的构建操作的本地 CPU 核心总数。接受整数或“HOST_CPUS”,可以选择后跟 [-|*]<float>(例如HOST_CPUS*.5 表示使用一半可用的 CPU 核心。默认情况下(“HOST_CPUS”),Bazel 会查询系统配置以估算可用的 CPU 核心数量。
已累计 --local_extra_resources=<a named float, 'name=value'> 次多次使用
设置可供 Bazel 使用的额外资源的数量。接受字符串-浮点对。可以多次使用,以指定多种类型的额外资源。Bazel 将根据可用的额外资源和所需的额外资源限制并发运行的操作。测试可以使用“resources:<resoucename>:<amount>”格式的标记来声明它们所需的额外资源数量。无法使用此标志设置可用的 CPU、RAM 和资源。
--local_ram_resources=<an integer, or "HOST_RAM", optionally followed by [-|*]<float>.> 默认值:“HOST_RAM*.67”
明确设置可供 Bazel 用于在本地执行的构建操作的本地主机 RAM 总量(以 MB 为单位)。采用整数或“HOST_RAM”,可以选择后跟 [-|*]<float>(例如HOST_RAM*.5 将使用一半可用 RAM)。默认情况下(“HOST_RAM*.67”),Bazel 会查询系统配置以估算可用 RAM 容量,并会使用 67% 的 RAM 容量。
--local_termination_grace_seconds=<an integer> 默认值:“15”
从因超时终止本地进程到将其强制关闭之间等待的时间。
已累计 --override_repository=<an equals-separated mapping of repository name to path> 次多次使用
使用格式为 <repo name>=<path> 的本地路径替换代码库。如果指定路径是绝对路径,系统将按原样使用该路径。如果指定路径是相对路径,则该路径是相对于当前工作目录而言的。如果指定路径以“%workspace%”开头,则该路径相对于工作区根目录,即“bazel info workspace”的输出
--package_path=<colon-separated list of options> 默认值:“%workspace%”
以英文冒号分隔的列表,用于列出查找软件包的位置。以“%workspace%”开头的元素相对于封闭工作区。如果省略或为空,则默认值为“bazel info default-package-path”的输出。
--[no]show_loading_progress 默认值:“true”
启用后,Bazel 会显示“正在加载软件包:”消息。
--test_lang_filters=<comma-separated list of options> 默认值:“”
指定以英文逗号分隔的测试语言列表。您可以选择在每种语言前面加上“-”,以指定排除的语言。只能找到以指定语言编写的测试目标。每种语言使用的名称应与 *_test 规则中的语言前缀相同,例如“cc”、“java”、“py”等之一。此选项会影响 --build_tests_only 行为和测试命令。
--test_size_filters=<comma-separated list of values: small, medium, large or enormous> 默认值:“”
指定以英文逗号分隔的测试尺寸列表。可以选择在每个尺寸前面加上“-”,以指定排除的尺寸。只能发现这些测试目标至少包含一个已包含的尺寸,而不包含任何已排除的尺寸。此选项会影响 --build_tests_only 行为和测试命令。
--test_tag_filters=<comma-separated list of options> 默认值:“”
指定以英文逗号分隔的测试标记列表。您可以选择在每个代码前面加上“-”,以指定排除的代码。只能发现这些测试目标至少包含一个已包含的代码,且不包含任何已排除的代码。此选项会影响 --build_tests_only 行为和测试命令。
--test_timeout_filters=<comma-separated list of values: short, moderate, long or eternal> 默认值:“”
指定以逗号分隔的测试超时列表。可以选择在每个超时前面加上“-”,以指定排除的超时。系统只会发现这些测试目标至少包含 1 个已包含的超时,且不包含任何已排除的超时。此选项会影响 --build_tests_only 行为和测试命令。
--tls_certificate=<a string> 默认值:请参阅说明
指定受信任 TLS 证书(用于对服务器证书进行签名)的路径。
--tls_client_certificate=<a string> 默认值:请参阅说明
指定要使用的 TLS 客户端证书;您还需要提供客户端密钥以启用客户端身份验证。
--tls_client_key=<a string> 默认值:请参阅说明
指定要使用的 TLS 客户端密钥;您还需要提供客户端证书以启用客户端身份验证。
--workspace_status_command=<path> 默认值:“”
在构建开始时调用的命令,以键值对的形式提供工作区的状态信息。有关完整规范,请参阅用户手册。另请参阅 tools/buildstamp/get_workspace_status 查看示例。
用于控制构建执行的选项:
--[no]check_up_to_date 默认值:“false”
不执行构建,只需检查它是否为最新版本。如果所有目标都是最新的,构建成功完成。如果需要执行任何步骤,则系统会报告错误,并且构建会失败。
标记: execution
是否通过直接文件系统调用来创建符号链接树
标记:loading_and_analysisexecutionexperimental
--[no]experimental_remotable_source_manifests 默认值:“false”
是否将源清单操作设为远程
标记:loading_and_analysisexecutionexperimental
--[no]experimental_split_coverage_postprocessing 默认值:“false”
如果为 true,Bazel 会运行覆盖率后处理,以便在新生成中进行测试。
标记: execution
--[no]experimental_split_xml_generation 默认值:“true”
如果已设置此标志,并且测试操作不会生成 test.xml 文件,则 Bazel 会使用单独的操作来生成包含测试日志的虚拟 test.xml 文件。否则,Bazel 会在测试操作过程中生成 test.xml。
标记: execution
--[no]experimental_strict_fileset_output 默认值:“false”
如果启用此选项,文件集会将所有输出工件视为常规文件。它们不会遍历目录,也不会对符号链接敏感。
标记: execution
--genrule_strategy=<comma-separated list of options> 默认值:“”
指定如何执行 genrule。我们将逐步淘汰这一标志。请改用 --spawn_strategy=<value> 控制所有操作,或使用 --strategy=Genrule=<value> 仅控制 genrule。
标记: execution
--jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5"> [-j] 默认值:“auto”
要运行的并发作业数量。接受整数或关键字(“auto”“HOST_CPUS”“HOST_RAM”),后面可选择性地后跟运算符 ([-|*]<float>),例如:"auto", "HOST_CPUS*.5"。值必须介于 1 到 5000 之间。高于 2500 的值可能会导致内存问题。“auto”根据主机资源计算合理的默认值。
标记:host_machine_resource_optimizationsexecution
--[no]keep_going [-k] 默认值:“false”
出错后,应尽可能多地继续操作。虽然无法分析失败的目标以及依赖于该目标的目标,但这些目标的其他先决条件可以。
标记: eagerness_to_exit
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5"> 默认值:“auto”
用于加载/分析阶段的并行线程数。可接受整数或关键字(“auto”“HOST_CPUS”“HOST_RAM”),后面可视需要后跟操作 ([-|*]<float>),例如:"auto", "HOST_CPUS*.5"。“auto”根据主机资源设置合理的默认值。不得小于 1。
标记: bazel_internal_configuration
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...> 默认值:“”
根据操作助记符在操作的执行信息中添加或移除键。仅适用于支持执行信息的操作。许多常用操作都支持执行信息,例如 Genrule、CppCompile、Javac、StarlarkAction、TestRunner。在指定多个值时,顺序很重要,因为多个正则表达式可能适用于同一助记符。 语法:“regex=[+-]key,regex=[+-]key,...”。 示例: “.*=+x,.*=-y,.*=+z”会在所有操作的执行信息中添加“x”和“z”,并从中移除“y”。“Genrule=+如果需要-x”会将“require-x”添加到所有 Genrule 操作的执行信息中。'(?!Genrule).*=- requires-x' 从所有非 Genrule 操作的执行信息中移除“need-x”。
标记:executionaffects_outputsloading_and_analysis
--persistent_android_dex_desugar
使用 worker 启用永久性 Android dex 和脱糖操作。
会展开为:
  --internal_persistent_android_dex_desugar
  --strategy=Desugar=worker
  --strategy=DexBuilder=worker

标记:host_machine_resource_optimizationsexecution
--persistent_android_resource_processor
使用 worker 启用永久性 Android 资源处理器。
展开为:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
--strategy=Aapt2Optimize=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=workerhost_machine_resource_optimizationsexecution
--persistent_multiplex_android_dex_desugar
使用 worker 启用永久性多路复用 Android dex 和脱糖操作。
扩展为:
  --persistent_android_dex_desugar
  --internal_persistent_multiplex_android_dex_desugar

标记:host_machine_resource_optimizationsexecution
--persistent_multiplex_android_resource_processor
使用工作器启用永久性多路复用 Android 资源处理器。
展开为:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workershost_machine_resource_optimizationsexecution
--persistent_multiplex_android_tools
启用持久性和多路复用 Android 工具(dex 处理、脱糖和资源处理)。
会展开为:
  --internal_persistent_multiplex_busybox_tools
  --persistent_multiplex_android_resource_processor
  --persistent_multiplex_android_dex_desugar

标记:host_machine_resource_optimizationsexecution
--spawn_strategy=<comma-separated list of options> 默认值:“”
指定默认如何执行生成操作。接受以逗号分隔的策略列表(优先级从高到低)。对于每项操作,Bazel 会选择能够执行操作的优先级最高的策略。默认值为“remote,worker,sandboxed,local”。如需了解详情,请参阅 https://blog.bazel.build/2019/06/19/list-strategy.html。
标记: execution
已累计 --strategy=<a '[name=]value1[,..,valueN]' assignment> 次多次使用
指定如何分发其他生成操作的编译。接受以逗号分隔的策略列表(优先级从高到低)。对于每项操作,Bazel 会选择能够执行操作的优先级最高的策略。默认值为“remote,worker,sandboxed,local”。此标志会覆盖 --spawn_strategy 设置的值(如果与助记 Genrule 搭配使用,则还包括 --genrule_strategy 设置的值)。如需了解详情,请参阅 https://blog.bazel.build/2019/06/19/list-strategy.html。
标记: execution
已累计 --strategy_regexp=<a '<RegexFilter>=value[,value]' assignment> 次多次使用
替换应使用哪种生成策略来执行说明与特定 regex_filter 匹配的生成操作。如需详细了解 regex_filter 匹配,请参阅 --per_file_copt。使用与说明匹配的第一个 regex_filter。此选项将替换用于指定策略的其他标志。示例:--strategy_regexp=//foo.*\.cc,-//foo/bar=local 表示如果操作的说明与 //foo.*.cc 而非 //foo/bar 匹配,则使用本地策略执行相应操作。示例:--strategy_regexp='Compiling.*/bar=local --strategy_regexp=Compiling=sandboxed 使用“local”策略运行“Compiling //foo/bar/baz”,但是颠倒顺序则会使用“sandboxed”运行
标记: execution
用于配置用于执行操作的工具链的选项:
--android_compiler=<a string> 默认值:请参阅说明
Android 目标编译器。
标记:affects_outputsloading_and_analysisloses_incremental_state
--android_crosstool_top=<a build target label> 默认值:“//external:android/crosstool”
用于 Android build 的 C++ 编译器的位置。
标记:affects_outputschanges_inputsloading_and_analysisloses_incremental_state
--android_grte_top=<a label> 默认值:请参阅说明
Android 目标 grte_top。
标记:changes_inputsloading_and_analysisloses_incremental_state
--android_manifest_merger=<legacy, android or force_android> 默认值:“android”
选择要用于 android_binary 规则的清单合并程序。用于帮助从旧版合并程序过渡到 Android 清单合并程序的标志。
标记:affects_outputsloading_and_analysisloses_incremental_state
--android_platforms=<a build target label> 默认值:“”
设置 android_binary 目标使用的平台。如果指定了多个平台,则二进制文件是一个胖 APK,其中包含每个指定目标平台的原生二进制文件。
标记:changes_inputsloading_and_analysisloses_incremental_state
--android_sdk=<a build target label> 默认值:“@bazel_tools//tools/android:sdk”
指定用于构建 Android 应用的 Android SDK/平台。
标记:changes_inputsloading_and_analysisloses_incremental_state
--apple_compiler=<a string> 默认值:请参阅说明
Apple 目标编译器。用于选择工具链的变体(例如 xcode-beta)。
标记:affects_outputsloading_and_analysisloses_incremental_state
--apple_crosstool_top=<a build target label> 默认值:“@bazel_tools//tools/cpp:toolchain”
要在 Apple 和 Objc 规则中使用的交叉工具软件包的标签及其依赖项。
标记:loses_incremental_statechanges_inputs
--apple_grte_top=<a build target label> 默认值:请参阅说明
Apple 目标 grte_top。
标记:changes_inputsloading_and_analysisloses_incremental_state
--cc_output_directory_tag=<a string> 默认值:“”
指定要添加到配置目录的后缀。
标记:affects_outputsexplicit_in_output_path
--compiler=<a string> 默认值:请参阅说明
用于编译目标的 C++ 编译器。
标记:loading_and_analysisexecution
--coverage_output_generator=<a build target label> 默认值:“@bazel_tools//tools/test:lcov_merger”
用于对原始覆盖率报告进行后处理的二进制文件的位置。目前,此值必须是包含单个文件(二进制文件)的文件组。默认值为“//tools/test:lcov_merger”。
标记:changes_inputsaffects_outputsloading_and_analysis
--coverage_report_generator=<a build target label> 默认值:“@bazel_tools//tools/test:coverage_report_generator”
用于生成覆盖率报告的二进制文件的位置。目前,此值必须是包含单个文件(二进制文件)的文件组。默认值为“//tools/test:coverage_report_generator”。
标记:changes_inputsaffects_outputsloading_and_analysis
--coverage_support=<a build target label> 默认值:“@bazel_tools//tools/test:coverage_support”
每个收集代码覆盖率的测试操作输入到的地方都需要支持文件的位置。默认值为“//tools/test:coverage_support”。
标记:changes_inputsaffects_outputsloading_and_analysis
--crosstool_top=<a build target label> 默认值:“@bazel_tools//tools/cpp:toolchain”
用于编译 C++ 代码的 crosstool 软件包标签。
标记:loading_and_analysischanges_inputsaffects_outputs
--custom_malloc=<a build target label> 默认值:请参阅说明
指定自定义 malloc 实现。此设置会覆盖构建规则中的 malloc 属性。
标记:changes_inputsaffects_outputs
已累计 --experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment> 次多次使用
以英文逗号分隔的正则表达式列表,每个表达式可以选择带有 -(否定表达式)前缀,并将 (=) 赋值给一系列以英文逗号分隔的约束值目标。如果目标没有与负表达式匹配,且至少有一个正表达式,则系统将执行其工具链解析,就像其已将约束值声明为执行约束条件一样。示例://demo,-test=@platforms//cpus:x86_64 会将“x86_64”添加到 //demo 下的任何目标(名称中包含“test”的目标除外)。
标记: loading_and_analysis
--[no]experimental_enable_objc_cc_deps 默认值:“true”
允许 objc_* 规则依赖于 cc_library,并使得针对 --ios_multi_cpu 中的任何值,在构建任何 objc 依赖项时将 --cpu 设置为“ios_<--ios_cpu>”。
标记:loading_and_analysisincompatible_change
--[no]experimental_include_xcode_execution_requirements 默认值:“false”
如果已设置,则向每项 Xcode 操作添加“require-xcode:{version}”的执行要求。如果 Xcode 版本带有带连字符的标签,请同时添加“required-xcode-label:{version_label}”执行要求。
标记:loses_incremental_stateloading_and_analysisexecution
--[no]experimental_prefer_mutual_xcode 默认值:“true”
如果为 true,请使用可在本地和远程访问的最新 Xcode。如果为 false,或者没有相互可用的版本,请使用通过 xcode-select 选择的本地 Xcode 版本。
标记: loses_incremental_state
已累计 --extra_execution_platforms=<comma-separated list of options> 次多次使用
可用作执行操作的执行平台的平台。平台可以按确切目标指定,也可以指定为目标模式。系统会先考虑这些平台,然后再考虑由 register_execution_platforms() 在 WORKSPACE 文件中声明的平台。
标记:execution
已累计 --extra_toolchains=<comma-separated list of options> 次多次使用
在工具链解析期间要考虑的工具链规则。工具链可以按确切目标指定,也可以指定为目标模式。系统会先考虑这些工具链,然后再考虑由 register_toolchains() 在 WORKSPACE 文件中声明的那些工具链。
标记:affects_outputschanges_inputsloading_and_analysis
--grte_top=<a label> 默认值:请参阅说明
已签入的 libc 库的标签。默认值由交叉工具工具链选择,您几乎永远不需要替换它。
标记:action_command_linesaffects_outputs
--host_compiler=<a string> 默认值:请参阅说明
用于主机编译的 C++ 编译器。如果未设置 --host_crosstool_top,则忽略该标志。
标记:loading_and_analysisexecution
--host_crosstool_top=<a build target label> 默认值:请参阅说明
默认情况下,--crosstool_top 和 --compiler 选项也会用于主机配置。如果提供此标志,Bazel 会针对给定 crosstool_top 使用默认 libc 和编译器。
标记:loading_and_analysischanges_inputsaffects_outputs
--host_grte_top=<a label> 默认值:请参阅说明
如果指定,此设置会覆盖主机配置的 libc 顶级目录 (--grte_top)。
标记:action_command_linesaffects_outputs
--host_platform=<a build target label> 默认值:“”
描述主机系统的平台规则标签。
标记:affects_outputschanges_inputsloading_and_analysis
--[no]incompatible_disable_expand_if_all_available_in_flag_set 默认值:“true”
如果为 true,Bazel 将不允许在 flag_sets 中指定 expand_if_all_available(如需了解迁移说明,请参阅 https://github.com/bazelbuild/bazel/issues/7008)。
标记:loading_and_analysisincompatible_change
--[no]incompatible_dont_enable_host_nonhost_crosstool_features 默认值:“true”
如果为 true,Bazel 不会在 C++ 工具链中启用“host”和“nonhost”功能(如需了解详情,请参阅 https://github.com/bazelbuild/bazel/issues/7407)。
标记:loading_and_analysisincompatible_change
--[no]incompatible_enable_android_toolchain_resolution 默认值:“false”
使用工具链解析选择 Android SDK for Android 规则(Starlark 和原生)
标记:loading_and_analysisincompatible_change
--[no]incompatible_enable_apple_toolchain_resolution 默认值:“false”
使用工具链解析选择 Apple SDK for Apple 规则(Starlark 和原生)
标记:loading_and_analysisincompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone 默认值:“true”
如果为 true,Bazel 不会将 C++ 链接操作命令行重复用于 lto 索引命令行(如需了解详情,请参阅 https://github.com/bazelbuild/bazel/issues/6791)。
标记:loading_and_analysisincompatible_change
--[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain 默认值:“true”
如果为 true,则设置 cc_toolchain.cpu 和 cc_toolchain.compiler 属性后,Bazel 会发出错误提示(有关迁移说明,请参阅 https://github.com/bazelbuild/bazel/issues/7075)。
标记:loading_and_analysisincompatible_change
--[no]incompatible_remove_legacy_whole_archive 默认值:“true”
如果为 true,则默认情况下,Bazel 不会将库依赖项链接到整个归档(如需了解迁移说明,请参阅 https://github.com/bazelbuild/bazel/issues/7362)。
标记:loading_and_analysisincompatible_change
--[no]incompatible_require_ctx_in_configure_features 默认值:“true”
如果为 true,则 Bazel 将需要在 cc_common.configure_features 中请求“时长”参数(如需了解详情,请参阅 https://github.com/bazelbuild/bazel/issues/7793)。
标记:loading_and_analysisincompatible_change
--[no]interface_shared_objects 默认值:“true”
如果工具链支持,请使用接口共享对象。目前,所有 ELF 工具链都支持此设置。
标记:loading_and_analysisaffects_outputsaffects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> 默认值:请参阅说明
指定用于构建 iOS 应用的 iOS SDK 版本。如果未指定,则使用“xcode_version”中的默认 iOS SDK 版本。
标记: loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> 默认值:请参阅说明
指定用于构建 macOS 应用的 macOS SDK 版本。如果未指定,则使用“xcode_version”中的默认 macOS SDK 版本。
标记: loses_incremental_state
--minimum_os_version=<a string> 默认值:请参阅说明
编译的目标最低操作系统版本。
标记:loading_and_analysisaffects_outputs
--platform_mappings=<a relative path> 默认值:“”
映射文件的位置,用于说明在未设置平台时应使用哪个平台,或在平台已存在时要设置哪些标志。必须相对于主工作区根目录。默认为“platform_mappings”(位于工作区根目录正下方的文件)。
标记:affects_outputschanges_inputsloading_and_analysis
--platforms=<a build target label> 默认值:“”
用于描述当前命令的目标平台的平台规则标签。
标记:affects_outputschanges_inputsloading_and_analysis
--python2_path=<a string> 默认值:请参阅说明
已废弃,空操作。已被“--incompatible_use_python_toolchains”停用。
标记:no_opdeprecated
--python3_path=<a string> 默认值:请参阅说明
已废弃,空操作。已被“--incompatible_use_python_toolchains”停用。
标记:no_opdeprecated
--python_path=<a string> 默认值:请参阅说明
为在目标平台上运行 Python 目标而调用的 Python 解释器的绝对路径。已弃用;已由 --incompatible_use_python_toolchains 停用。
标记:loading_and_analysisaffects_outputs
--python_top=<a build target label> 默认值:请参阅说明
py_runtime 的标签,表示为在目标平台上运行 Python 目标而调用的 Python 解释器。已弃用;已由 --incompatible_use_python_toolchains 停用。
标记:loading_and_analysisaffects_outputs
--target_platform_fallback=<a build target label> 默认值:“@local_config_platform//:host”
未设置目标平台且没有与当前标志集匹配的平台映射时应使用的平台规则标签。
标记:affects_outputschanges_inputsloading_and_analysis
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> 默认值:请参阅说明
指定用于构建 tvOS 应用的 tvOS SDK 版本。如果未指定,则使用“xcode_version”中的默认 tvOS SDK 版本。
标记: loses_incremental_state
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> 默认值:请参阅说明
指定用于构建 watchOS 应用的 watchOS SDK 版本。如果未指定,则使用“xcode_version”中的默认 watchOS SDK 版本。
标记: loses_incremental_state
--xcode_version=<a string> 默认值:请参阅说明
如果指定,则将给定版本的 Xcode 用于相关构建操作。如果未指定,则使用 Xcode 的执行程序默认版本。
标记: loses_incremental_state
--xcode_version_config=<a build target label> 默认值:“@bazel_tools//tools/cpp:host_xcodes”
xcode_config 规则的标签,用于在 build 配置中选择 Xcode 版本。
标记:loses_incremental_stateloading_and_analysis
用于控制命令输出的选项:
--[no]apple_enable_auto_dsym_dbg 默认值:“false”
是否强制启用为 dbg build 生成调试符号 (.dSYM) 文件的功能。
标记:affects_outputsaction_command_lines
--[no]apple_generate_dsym 默认值:“false”
是否生成调试符号 (.dSYM) 文件。
标记:affects_outputsaction_command_lines
--[no]build 默认值:“true”
执行构建;这是常见行为。指定 --nobuild 会导致构建在执行构建操作之前停止,并且在软件包加载和分析阶段成功完成时返回零;此模式对于测试这些阶段非常有用。
标记:executionaffects_outputs
如果为 true,则为所有目标构建 runfiles 符号链接林。如果为 false,请尽可能只写入清单。
标记: affects_outputs
--[no]build_runfile_manifests 默认值:“true”
如果为 true,则为所有目标编写 runfile 清单。如果为 false,请忽略它们。如果值为 false,本地测试将无法运行。
标记: affects_outputs
--[no]build_test_dwp 默认值:“false”
启用后,在以静态方式构建 C++ 测试时以及在 Fission 处打开时,系统也会自动构建测试二进制文件的 .dwp 文件。
标记:loading_and_analysisaffects_outputs
--cc_proto_library_header_suffixes=<comma-separated list of options> 默认值:“.pb.h”
设置 cc_proto_library 创建的头文件的前缀。
标记:affects_outputsloading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated list of options> 默认值:“.pb.cc”
设置 cc_proto_library 创建的源文件的前缀。
标记:affects_outputsloading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info 默认值:“false”
针对 proto_library 中的备用 Java API 版本运行额外操作。
标记:affects_outputsloading_and_analysisexperimental
--[no]experimental_proto_extra_actions 默认值:“false”
针对 proto_library 中的备用 Java API 版本运行额外操作。
标记:affects_outputsloading_and_analysisexperimental
--[no]experimental_run_validations 默认值:“true”
请改用 --run_validations。
标记:executionaffects_outputs
--[no]experimental_save_feature_state 默认值:“false”
将启用和已请求功能的状态保存为编译的输出。
标记:affects_outputsexperimental
--[no]experimental_use_validation_aspect 默认值:“false”
是否使用切面运行验证操作(用于与测试的并行性)。
标记:executionaffects_outputs
--fission=<a set of compilation modes> 默认值:“no”
指定哪些编译模式对 C++ 编译和链接使用断点。可以是 {'fastbuild', 'dbg', 'opt'} 的任意组合,也可以是特殊值:'yes'(用于启用所有模式)和 'no'(用于停用所有模式)。
标记:loading_and_analysisaction_command_linesaffects_outputs
--[no]incompatible_always_include_files_in_data 默认值:“true”
如果为 true,原生规则会将数据依赖项的 <code>DefaultInfo.files</code> 添加到其 runfile 中,这与 Starlark 规则的建议行为一致 (https://bazel.build/extending/rules#runfiles_features_to_avoid)。
标记:affects_outputsincompatible_change
--[no]legacy_external_runfiles 默认值:“true”
如果为 true,则为 .runfiles/wsname/external/repo(以及 .runfiles/repo)下的外部代码库构建 runfiles 符号链接林。
标记: affects_outputs
--[no]objc_generate_linkmap 默认值:“false”
指定是否生成链接映射文件。
标记: affects_outputs
已累计 --output_groups=<comma-separated list of options> 次多次使用
以英文逗号分隔的输出组名称列表,每个输出组名称可以选择添加 + 或 - 作为前缀。以 + 为前缀的组会添加到默认的输出组集中,而以 - 为前缀的组则会从默认输出组中移除。如果至少一个组不带前缀,系统会省略默认的输出组。例如,--output_groups=+foo,+bar 会构建默认集、foo 和 bar 的并集,而 --output_groups=foo,bar 会替换默认集,以便仅构建 foo 和 bar。
标记:executionaffects_outputs
--[no]run_validations 默认值:“true”
是否在构建过程中运行验证操作。请参阅 https://bazel.build/rules/rules#validation_actions
标记:executionaffects_outputs
--[no]save_temps 默认值:“false”
如果设置此参数,系统会保存 gcc 的临时输出。其中包括 .s 文件(编译器代码)、.i 文件(经过预处理的 C)和 .ii 文件(经过预处理的 C++)。
标记: affects_outputs
可让用户配置预期输出的选项,以影响预期输出的值,而非影响其存在性:
已累计 --action_env=<a 'name=value' assignment with an optional value part> 次多次使用
指定可用于具有目标配置的操作的一组环境变量。变量可以按名称指定(在这种情况下,值将从调用环境中获取),也可以通过 name=value 对(其值独立于调用环境设置)指定。此选项可以多次使用;对于同一变量提供的选项,系统会汇总最后胜出的选项。
标记: action_command_lines
--android_cpu=<a string> 默认值:“armeabi-v7a”
Android 目标 CPU。
标记:affects_outputsloading_and_analysisloses_incremental_state
--[no]android_databinding_use_androidx 默认值:“false”
生成与 AndroidX 兼容的数据绑定文件。这仅适用于数据绑定 v2。
标记:affects_outputsloading_and_analysisloses_incremental_stateexperimental
--[no]android_databinding_use_v3_4_args 默认值:“false”
使用带有 3.4.0 参数的 Android 数据绑定 v2
标记:affects_outputsloading_and_analysisloses_incremental_stateexperimental
--android_dynamic_mode=<off, default or fully> 默认值:“off”
确定当 cc_binary 未明确创建共享库时,是否要动态关联 Android 规则的 C++ 依赖项。“default”表示 bazel 将选择是否动态链接。“full”表示将动态地链接所有库。“off”表示所有库都将在基本静态模式下链接。
标记:affects_outputsloading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency> 默认值:“按字母顺序排列”
设置传递给 Android 二进制文件的清单合并程序的清单的顺序。ALPHABETIAL 表示清单按相对于 execroot 的路径进行排序。ALPHABETIVE_BY_CONFIGURATION 表示清单按相对于输出目录中配置目录的路径进行排序。DEPENDENCY 表示清单排序,每个库的清单排在其依赖项的清单之前。
标记:action_command_linesexecution
--[no]android_resource_shrinking 默认值:“false”
为使用 ProGuard 的 android_binary APK 启用资源缩减。
标记:affects_outputsloading_and_analysis
已累计 --apple_bitcode=<'mode' or 'platform=mode', where 'mode' is none, embedded_markers or embedded, and 'platform' is ios, visionos, watchos, tvos, macos or catalyst> 次多次使用
为针对设备架构的编译步骤指定 Apple 位码模式。值的格式为“[platform=]mode”,其中平台(必须为“ios”“macos”“tvos”或“watchos”)是可选的。如果提供位码模式,则专门针对该平台应用位码模式;如果省略,则将应用于所有平台。模式必须为“none”“embedded_markers”或“embedded”。此选项可能会提供多次。
标记: loses_incremental_state
已累计 --aspects=<comma-separated list of options> 次多次使用
要应用于顶级目标的切面列表,以英文逗号分隔。在列表中,如果切面 some_aspect 通过 required_aspect_providers 指定所需的切面提供程序,则 some_aspect 将在切面列表中先提到的每一个切面运行后运行,并且其中通告的提供程序满足 some_aspect 要求的切面提供程序。此外,some_aspect 将在 require 属性指定的所有必需切面后运行。some_aspect 随后将可以访问这些切面的提供程序的值。<bzl-file-label>%<aspect_name>,例如“//tools:my_def.bzl%my_aspect”,其中“my_aspect”是文件 tools/my_def.bzl 中的顶级值
--[no]build_python_zip 默认值:“auto”
构建 Python 可执行 zip 文件;在 Windows 上,在其他平台上关闭
标记: affects_outputs
已累计 --catalyst_cpus=<comma-separated list of options> 次多次使用
要为其构建 Apple Catalyst 二进制文件的架构列表(以英文逗号分隔)。
标记:loses_incremental_stateloading_and_analysis
--[no]collect_code_coverage 默认值:“false”
如果指定,Bazel 将对代码进行插桩处理(尽可能使用离线插桩),并在测试期间收集覆盖率信息。只有与“Instrumentation_filter”匹配的目标会受到影响。通常,不应直接指定此选项,应改用“bazelCoverage”命令。
标记: affects_outputs
--compilation_mode=<fastbuild, dbg or opt> [-c] 默认值:“fastbuild”
指定将在其中构建二进制文件的模式。值:“fastbuild”、“dbg”、“opt”。
标记:affects_outputsaction_command_linesexplicit_in_output_path
已累计 --conlyopt=<a string> 次多次使用
编译 C 源文件时要传递给 gcc 的附加选项。
标记:action_command_linesaffects_outputs
已累计 --copt=<a string> 次多次使用
可传递给 gcc 的其他选项。
标记:action_command_linesaffects_outputs
--cpu=<a string> 默认值:“”
目标 CPU。
标记:changes_inputsaffects_outputsexplicit_in_output_path
--cs_fdo_absolute_path=<a string> 默认值:请参阅说明
使用 CSFDO 配置文件信息优化编译。指定包含配置文件(原始或编入索引的 LLVM 配置文件)的 ZIP 文件的绝对路径名称。
标记: affects_outputs
--cs_fdo_instrument=<a string> 默认值:请参阅说明
使用上下文敏感 FDO 插桩生成二进制文件。使用 Clang/LLVM 编译器,它也接受在运行时转储原始配置文件所在的目录名称。
标记: affects_outputs
--cs_fdo_profile=<a build target label> 默认值:请参阅说明
cs_fdo_profile,表示要用于优化的上下文相关配置文件。
标记: affects_outputs
已累计 --cxxopt=<a string> 次多次使用
编译 C++ 源文件时要传递给 gcc 的附加选项。
标记:action_command_linesaffects_outputs
已累计 --define=<a 'name=value' assignment> 次多次使用
每个 --define 选项均可为 build 变量指定一个赋值。
标记:changes_inputsaffects_outputs
--dynamic_mode=<off, default or fully> 默认值:“default”
确定是否要动态链接 C++ 二进制文件。“default”表示 Bazel 将选择是否动态链接。“full”表示将动态地链接所有库。“off”表示所有库都将在基本静态模式下链接。
标记:loading_and_analysisaffects_outputs
--[no]enable_fdo_profile_absolute_path 默认值:“true”
如果设置此参数,使用 fdo_absolute_profile_path 会引发错误。
标记: affects_outputs
--[no]enable_runfiles 默认值:“auto”
启用 runfiles 符号链接树;默认情况下,此设置在 Windows 和其他平台上处于关闭状态。
标记: affects_outputs
已累计 --experimental_action_listener=<a build target label> 次多次使用
废弃了,取而代之的是切面。使用 action_listener 将 extra_action 附加到现有构建操作。
标记:executionexperimental
--[no]experimental_android_compress_java_resources 默认值:“false”
压缩 APK 中的 Java 资源
标记:affects_outputsloading_and_analysisexperimental
--[no]experimental_android_databinding_v2 默认值:“false”
使用 Android 数据绑定 v2
标记:affects_outputsloading_and_analysisloses_incremental_stateexperimental
--[no]experimental_android_resource_shrinking 默认值:“false”
为使用 ProGuard 的 android_binary APK 启用资源缩减。
标记:affects_outputsloading_and_analysis
--[no]experimental_android_rewrite_dexes_with_rex 默认值:“false”
使用 rex 工具重写 dex 文件
标记:affects_outputsloading_and_analysisloses_incremental_stateexperimental
--[no]experimental_collect_code_coverage_for_generated_files 默认值:“false”
如果指定,Bazel 还将为生成的文件生成收集覆盖率信息。
标记: affects_outputs
此标志用于控制便捷符号链接(构建后显示在工作区中的符号链接)的管理方式。可能的值:normal(默认值):将创建或删除每种便捷符号链接,具体取决于 build。干净:所有符号链接将被无条件删除。ignore:符号链接将保持独立。log_only:生成日志消息的方式与传递“normal”,但实际上不执行任何文件系统操作(对工具很有用)。请注意,只有名称由“--symlink_prefix”的当前值生成的符号链接才会受到影响;如果前缀发生变化,所有现有的符号链接都将保持不变。
标记: affects_outputs
此标志可控制我们是否将 build eventConvenienceSymlinksIdentified 发布到 BuildEventProtocol。如果值为 true,BuildEventProtocol 将包含一个条目以方便使用 SymlinksIdentified,从而列出在您的工作区中创建的所有便捷符号链接。如果为 false,BuildEventProtocol 中的 smoothSymlinksIdentified 条目将为空。
标记: affects_outputs
已累计 --experimental_multi_cpu=<comma-separated list of options> 次多次使用
已废弃。无操作。
标记:affects_outputsexperimental
--experimental_objc_fastbuild_options=<comma-separated list of options> 默认值:“-O0,-DDEBUG=1”
使用这些字符串作为 objc quickbuild 编译器选项。
标记: action_command_lines
--[no]experimental_omitfp 默认值:“false”
如果为 true,则使用 libunwind 进行堆栈展开,并使用 -fomit-frame-pointer 和 -faSYNC-unwind-tables 进行编译。
标记:action_command_linesaffects_outputsexperimental
--[no]experimental_platform_in_output_dir 默认值:“false”
如果为 true,则输出目录名称中使用目标平台(而非 CPU)。
标记:affects_outputsexperimental
--[no]experimental_use_llvm_covmap 默认值:“false”
如果指定,则启用 collect_code_coverage 时,Bazel 将生成 llvm-cov 覆盖范围地图信息,而不是 gcov。
标记:changes_inputsaffects_outputsloading_and_analysisexperimental
--fat_apk_cpu=<comma-separated list of options> 默认值:“armeabi-v7a”
设置此选项会启用胖 APK,其中包含适用于所有指定目标架构的原生二进制文件,例如--fat_apk_cpu=x86,armeabi-v7a. 如果指定此标志,对于 android_binary 规则的依赖项,系统会忽略 --android_cpu。
标记:affects_outputsloading_and_analysisloses_incremental_state
--[no]fat_apk_hwasan 默认值:“false”
是否创建 HWASAN 分块。
标记:affects_outputsloading_and_analysisloses_incremental_state
--fdo_instrument=<a string> 默认值:请参阅说明
使用 FDO 插桩生成二进制文件。使用 Clang/LLVM 编译器,它也接受在运行时转储原始配置文件所在的目录名称。
标记: affects_outputs
--fdo_optimize=<a string> 默认值:请参阅说明
使用 FDO 配置文件信息优化编译。指定包含 .gcda 文件树的 zip 文件的名称、包含自动配置文件的 afdo 文件或 LLVM 配置文件的名称。此标志还接受指定为标签的文件(例如 `//foo/bar:file.afdo` - 您可能需要向相应的软件包添加 `exports_files` 指令)以及指向 `fdo_profile` 目标的标签。此标志将由“fdo_profile”规则取代。
标记: affects_outputs
--fdo_prefetch_hints=<a build target label> 默认值:请参阅说明
使用缓存预提取提示。
标记: affects_outputs
--fdo_profile=<a build target label> 默认值:请参阅说明
fdo_profile,表示要用于优化的配置文件。
标记: affects_outputs
已累计 --features=<a string> 次多次使用
对于目标配置中构建的目标,系统会默认启用或停用指定功能。指定 -<feature> 将停用该功能。负面特征始终会覆盖正特征。另请参阅 --host_features
标记:changes_inputsaffects_outputs
--[no]force_pic 默认值:“false”
启用后,所有 C++ 编译都会生成位置无关代码(“-fPIC”),链接首选 PIC 预构建库而非非 PIC 库,而链接会生成位置独立的可执行文件(“-pie”)。
标记:loading_and_analysisaffects_outputs
已累计 --host_action_env=<a 'name=value' assignment with an optional value part> 次多次使用
指定可用于具有主机或执行配置的操作的一组环境变量。变量可以按名称指定(在这种情况下,值将从调用环境中获取),也可以通过 name=value 对(其值独立于调用环境设置)指定。此选项可以多次使用;对于同一变量提供的选项,系统会汇总最后胜出的选项。
标记: action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt> 默认值:“opt”
指定构建期间要使用的工具的模式。值:“fastbuild”、“dbg”、“opt”。
标记:affects_outputsaction_command_lines
已累计 --host_conlyopt=<a string> 次多次使用
为主机工具编译 C 源文件时传递给 gcc 的附加选项。
标记:action_command_linesaffects_outputs
已累计 --host_copt=<a string> 次多次使用
传递给主机工具的 gcc 的其他选项。
标记:action_command_linesaffects_outputs
--host_cpu=<a string> 默认值:“”
主机 CPU。
标记:changes_inputsaffects_outputs
已累计 --host_cxxopt=<a string> 次多次使用
传递给主机工具的 gcc 的其他选项。
标记:action_command_linesaffects_outputs
已累计 --host_features=<a string> 次多次使用
对于 exec 配置中构建的目标,系统会默认启用或停用给定功能。指定 -<feature> 将停用该功能。负特征始终会覆盖正特征。
标记:changes_inputsaffects_outputs
--host_force_python=<PY2 or PY3> 默认值:请参阅说明
覆盖主机配置的 Python 版本。可以是“PY2”或“PY3”。
标记:loading_and_analysisaffects_outputs
已累计 --host_linkopt=<a string> 次多次使用
在关联主机工具时传递给 gcc 的附加选项。
标记:action_command_linesaffects_outputs
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> 默认值:请参阅说明
主机目标的最低兼容 macOS 版本。如果未指定,则使用“macos_sdk_version”。
标记: loses_incremental_state
已累计 --host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options> 次多次使用
在主机或 exec 配置中编译某些文件时,可选择性地传递给 C/C++ 编译器的其他选项。可以多次传递此选项。语法:regex_filter@option_1,option_2,...,option_n。其中,regex_filter 代表包含和排除正则表达式模式的列表(另请参阅 --instrumentation_filter)。 option_1 到 option_n 代表任意命令行选项。如果选项中包含英文逗号,则必须使用反斜杠将其括起来。选项可以包含 @。只有第一个 @ 用于拆分字符串。示例:--host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 向 //foo/(bar.cc 除外)中所有 cc 文件的 gcc 命令行添加 -O0 命令行选项。
标记:action_command_linesaffects_outputs
已累计 --host_swiftcopt=<a string> 次多次使用
为主机工具传递给 swiftc 的其他选项。
标记:action_command_linesaffects_outputs
--[no]incompatible_avoid_conflict_dlls 默认值:“true”
启用后,Windows 上的 cc_library 生成的所有 C++ 动态链接库 (DLL) 都将重命名为 name_{hash}.dll,其中哈希值根据 RepositoryName 和 DLL 的软件包路径计算。如果您有一个软件包依赖于多个同名的 cc_library(例如 //foo/bar1:utils 和 //foo/bar2:utils),则此选项非常有用。
标记:loading_and_analysisaffects_outputsincompatible_change
--[no]incompatible_merge_genfiles_directory 默认值:“true”
如果为 true,genfiles 目录会折叠到 bin 目录中。
标记:affects_outputsincompatible_change
--[no]incompatible_use_host_features 默认值:“false”
如果为 true,则仅对目标配置使用 --features,针对 exec 配置使用 --host_features。
标记:changes_inputsaffects_outputsincompatible_change
--[no]incompatible_use_platforms_repo_for_constraints 默认值:“true”
如果为 true,系统会移除 @bazel_tools 中的限制条件设置。
标记:affects_outputsincompatible_change
--[no]instrument_test_targets 默认值:“false”
启用覆盖率后,指定是否考虑对测试规则进行插桩测试。设置后,将对 --instrumentation_filter 包含的测试规则进行插桩处理。否则,测试规则始终会从覆盖范围插桩中排除。
标记: affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths> 默认值:“-/javatests[/:],-/test/java[/:]”
启用覆盖率后,系统只会对名称中包含指定基于正则表达式的过滤器的规则进行插桩处理。前缀为“-”的规则将被排除。请注意,除非启用了 --instrument_test_targets,否则只能对非测试规则进行插桩处理。
标记: affects_outputs
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> 默认值:请参阅说明
目标模拟器和设备的最低兼容 iOS 版本。如果未指定,则使用“ios_sdk_version”。
标记: loses_incremental_state
已累计 --ios_multi_cpus=<comma-separated list of options> 次多次使用
用于构建 ios_application 的架构列表(以英文逗号分隔)。从而生成一个包含所有指定架构的通用二进制文件。
标记:loses_incremental_stateloading_and_analysis
--[no]legacy_whole_archive 默认值:“true”
已废弃,已被 --incompatible_remove_legacy_whole_archive 取代(如需了解详情,请参阅 https://github.com/bazelbuild/bazel/issues/7362)。开启此设置后,请为 linkopts 中包含 linkshared=True 且 linkstatic=True 或“-static”的 cc_binary 规则使用 --whole-archive。这仅用于向后兼容。更好的替代方案是根据需要使用 alwayslink=1。
标记:action_command_linesaffects_outputsdeprecated
已累计 --linkopt=<a string> 次多次使用
在链接时传递给 gcc 的附加选项。
标记:action_command_linesaffects_outputs
已累计 --ltobackendopt=<a string> 次多次使用
用于传递给 LTO 后端步骤的附加选项(在 --features=thin_lto 下)。
标记:action_command_linesaffects_outputs
已累计 --ltoindexopt=<a string> 次多次使用
用于传递给 LTO 索引步骤的附加选项(在 --features=thin_lto 下)。
标记:action_command_linesaffects_outputs
已累计 --macos_cpus=<comma-separated list of options> 次多次使用
要为其构建 Apple macOS 二进制文件的架构列表(以英文逗号分隔)。
标记:loses_incremental_stateloading_and_analysis
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> 默认值:请参阅说明
目标的最低兼容 macOS 版本。如果未指定,则使用“macos_sdk_version”。
标记: loses_incremental_state
--[no]objc_debug_with_GLIBCXX 默认值:“false”
如果已设置此参数,并且编译模式设为“dbg”,则定义 GLIBCXX_DEBUG、GLIBCXX_DEBUG_PEDANTIC 和 GLIBCPP_CONCEPT_CHECKS。
标记: action_command_lines
--[no]objc_enable_binary_stripping 默认值:“false”
是否对链接的二进制文件执行符号和死代码删除。如果同时指定了此标志和 --compilation_mode=opt,系统会执行二进制文件剥离。
标记: action_command_lines
已累计 --objccopt=<a string> 次多次使用
编译 Objective-C/C++ 源文件时需要传递给 gcc 的其他选项。
标记: action_command_lines
已累计 --per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options> 次多次使用
在编译特定文件时,可选择性地传递给 gcc 的其他选项。可以多次传递此选项。语法:regex_filter@option_1,option_2,...,option_n。其中,regex_filter 代表包含和排除正则表达式模式的列表(另请参阅 --instrumentation_filter)。 option_1 到 option_n 代表任意命令行选项。如果选项中包含英文逗号,则必须使用反斜杠将其括起来。选项可以包含 @。只有第一个 @ 用于拆分字符串。示例:--per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 向 //foo/(bar.cc 除外)中所有 cc 文件的 gcc 命令行添加 -O0 命令行选项。
标记:action_command_linesaffects_outputs
已累计 --per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options> 次多次使用
在编译某些后端对象时,可选择性地传递到 LTO 后端(在 --features=thin_lto 下)的其他选项。可以多次传递此选项。语法:regex_filter@option_1,option_2,...,option_n。其中,regex_filter 代表包含和排除正则表达式模式的列表。 option_1 到 option_n 代表任意命令行选项。如果选项中包含英文逗号,则必须使用反斜杠将其括起来。选项可以包含 @。只有第一个 @ 用于拆分字符串。示例:--per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 向 //foo/(bar.o 除外)中所有 o 文件的 LTO 后端命令行添加 -O0 命令行选项。
标记:action_command_linesaffects_outputs
--platform_suffix=<a string> 默认值:请参阅说明
指定要添加到配置目录的后缀。
标记:loses_incremental_stateaffects_outputsloading_and_analysis
--propeller_optimize=<a build target label> 默认值:请参阅说明
使用螺旋桨配置文件信息优化构建目标。螺旋桨配置文件必须至少包含以下两个文件中的一个:cc 配置文件和 ld 配置文件。此标志接受必须引用螺旋桨配置文件输入文件的 build 标签。(此选项必须用作:--propeller_optimize=//a/b:propeller_profile
标记:action_command_linesaffects_outputs
--propeller_optimize_absolute_cc_profile=<a string> 默认值:请参阅说明
Propeller 优化 build 的 cc_profile 文件的绝对路径名称。
标记: affects_outputs
--propeller_optimize_absolute_ld_profile=<a string> 默认值:请参阅说明
Propeller 优化 build 的 ld_profile 文件的绝对路径名称。
标记: affects_outputs
--run_under=<a prefix in front of command> 默认值:请参阅说明
要在“test”和“run”命令的可执行文件前面插入的前缀。如果值为“foo -bar”,且执行命令行为“test_binary -baz”,则最终命令行为“foo -bar test_binary -baz”。这也可以是可执行目标的标签。部分示例包括:“valgrind”“strace”“strace -c”“valgrind --quiet --num-callers=20”“//package:target”“//package:target --options”。
标记: action_command_lines
--[no]share_native_deps 默认值:“true”
如果为 true,则包含相同功能的原生库将由不同的目标共享
标记:loading_and_analysisaffects_outputs
--[no]stamp 默认值:“false”
为二进制文件标记日期、用户名、主机名、工作区信息等。
标记: affects_outputs
--strip=<always, sometimes or never> 默认值:“有时”
指定是否删除二进制文件和共享库(使用“-Wl,--strip-debug”)。默认值“有时”表示,如果 f --compilation_mode=fastbuild,则执行剥离。
标记: affects_outputs
已累计 --stripopt=<a string> 次多次使用
生成“<name>.stripped”二进制文件时要传递的其他选项。
标记:action_command_linesaffects_outputs
已累计 --swiftcopt=<a string> 次多次使用
传递给 Swift 编译的更多选项。
标记: action_command_lines
在构建后创建的任何便捷符号链接前作为前缀的前缀。如果省略此参数,则默认值为构建工具的名称后跟连字符。如果传递“/”,则不会创建符号链接,也不会发出警告。警告:“/”的特殊功能即将弃用;请改用 --experimental_convenience_symlinks=ignore。
标记: affects_outputs
已累计 --tvos_cpus=<comma-separated list of options> 次多次使用
要为其构建 Apple tvOS 二进制文件的架构列表(以英文逗号分隔)。
标记:loses_incremental_stateloading_and_analysis
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> 默认值:请参阅说明
目标模拟器和设备的最低兼容 tvOS 版本。如果未指定,则使用“tvos_sdk_version”。
标记: loses_incremental_state
已累计 --visionos_cpus=<comma-separated list of options> 次多次使用
要为其构建 Apple visionOS 二进制文件的架构列表(以英文逗号分隔)。
标记:loses_incremental_stateloading_and_analysis
已累计 --watchos_cpus=<comma-separated list of options> 次多次使用
要为其构建 Apple watchOS 二进制文件的架构列表(以英文逗号分隔)。
标记:loses_incremental_stateloading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> 默认值:请参阅说明
适用于目标模拟器和设备的最低兼容 watchOS 版本。如果未指定,则使用“watchos_sdk_version”。
标记: loses_incremental_state
--xbinary_fdo=<a build target label> 默认值:请参阅说明
使用 XbinaryFDO 配置文件信息优化编译。指定默认跨二进制配置文件的名称。当该选项与 --fdo_instrument/--fdo_optimize/--fdo_profile 一起使用时,这些选项将始终优先,就像从未指定 xbinary_fdo 一样。
标记: affects_outputs
影响 Bazel 强制执行有效 build 输入的严格程度的选项(规则定义、标志组合等):
--auto_cpu_environment_group=<a build target label> 默认值:“”
声明用于自动将 CPU 值映射到 target_environment 值的 environment_group。
标记:changes_inputsloading_and_analysisexperimental
--[no]check_licenses 默认值:“false”
检查依赖软件包施加的许可限制是否与正在构建的目标的分发模式冲突。默认情况下,系统不会选中许可。
标记: build_file_semantics
--[no]check_visibility 默认值:“true”
如果停用此设置,目标依赖项中的可见性错误会降级为警告。
标记: build_file_semantics
--[no]desugar_for_android 默认值:“true”
是否在 dex 处理之前对 Java 8 字节码进行脱糖。
标记:affects_outputsloading_and_analysisloses_incremental_state
--[no]desugar_java8_libs 默认值:“false”
是否在旧版设备应用中包含受支持的 Java 8 库。
标记:affects_outputsloading_and_analysisloses_incremental_stateexperimental
--[no]enforce_constraints 默认值:“true”
检查每个目标兼容的环境,如果任何目标的依赖项不支持相同环境,则报告错误
标记:build_file_semantics
--[no]experimental_allow_android_library_deps_without_srcs 默认值:“false”
用于帮助从允许转换为禁止使用依赖项的 srcs-less android_library 规则的标记。默认情况下,您需要清理仓库才能发布此仓库。
标记:eagerness_to_exitloading_and_analysis
--[no]experimental_check_desugar_deps 默认值:“true”
是否仔细检查 Android 二进制文件级别的脱糖是否正确。
标记:eagerness_to_exitloading_and_analysisexperimental
--experimental_import_deps_checking=<off, warning or error> 默认值:“OFF”
启用后,检查 aar_import 的依赖项是否完整。这种强制执行可能会破坏构建,或者只会导致警告。
标记: loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default> 默认值:“default”
如果为 true,则检查 Java 目标是否将所有直接使用的目标明确声明为依赖项。
标记:build_file_semanticseagerness_to_exit
--[no]incompatible_check_testonly_for_output_files 默认值:“false”
如果启用,则通过查找生成规则的 testonly 来仅检查 testonly(输出文件的必要目标)。这与可见性检查一致。
标记:build_file_semanticsincompatible_change
--[no]incompatible_disable_native_android_rules 默认值:“false”
启用后,系统会禁止直接使用原生 Android 规则。请使用 https://github.com/bazelbuild/rules_android 中的 Starlark Android 规则
标记:eagerness_to_exitincompatible_change
--[no]incompatible_disable_native_apple_binary_rule 默认值:“false”
无操作。保留在此处以确保向后兼容性。
标记:eagerness_to_exitincompatible_change
--[no]incompatible_force_strict_header_check_from_starlark 默认值:“true”
如果启用,请在 Starlark API 中设置严格的标头检查
标记:loading_and_analysischanges_inputsincompatible_change
--[no]incompatible_validate_top_level_header_inclusions 默认值:“true”
如果为 true,Bazel 还将验证是否包含顶级目录标头(如需了解详情,请参阅 https://github.com/bazelbuild/bazel/issues/10047)。
标记:loading_and_analysisincompatible_change
--[no]strict_filesets 默认值:“false”
如果启用此选项,跨越软件包边界的文件集会报告为错误。当 check_fileset_dependencies_recursively 停用时不起作用。
标记:build_file_semanticseagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default> 默认值:“error”
除非 OFF,否则检查 proto_library 目标是否明确将所有直接使用的目标声明为依赖项。
标记:build_file_semanticseagerness_to_exitincompatible_change
--strict_public_imports=<off, warn, error, strict or default> 默认值:“off”
除非 OFF,否则检查 proto_library 目标是否将“import public”中使用的所有目标明确声明为已导出。
标记:build_file_semanticseagerness_to_exitincompatible_change
--[no]strict_system_includes 默认值:“false”
如果为 true,则还需要声明通过系统包含路径 (-isystem) 找到的头文件。
标记:loading_and_analysiseagerness_to_exit
已累计 --target_environment=<a build target label> 次多次使用
声明此 build 的目标环境。必须是对“环境”规则的标签引用。如果指定,则所有顶级目标都必须与此环境兼容。
标记: changes_inputs
影响 build 的签名输出的选项:
--apk_signing_method=<v1, v2, v1_v2 or v4> 默认值:“v1_v2”
用于为 APK 签名的实现
标记:action_command_linesaffects_outputsloading_and_analysis
--[no]device_debug_entitlements 默认值:“true”
如果已设置且编译模式不是“opt”,objc 应用在签名时会包含调试权限。
标记: changes_inputs
--ios_signing_cert_name=<a string> 默认值:请参阅说明
用于 iOS 签名的证书名称。如果未设置,系统将回退到预配配置文件。可能是证书的钥匙串身份偏好设置或证书通用名称的(子字符串),详情请见代码签名的手册页面 (SIGNING IDENTITIES)。
标记:action_command_lines
此选项会影响 Starlark 语言或 build 文件、.bzl 文件或 WORKSPACE 文件可访问的 build API 的语义。
--[no]incompatible_config_setting_private_default_visibility 默认值:“false”
如果 incompatible_enforce_config_setting_visibility=false,则代表着空操作。否则,如果此标志为 false,则没有明确可见性属性的任何 config_setting 都是 //visibility:public。如果此标志为 true,config_setting 遵循与所有其他规则相同的可见性逻辑。请参阅 https://github.com/bazelbuild/bazel/issues/12933。
标记:loading_and_analysisincompatible_change
--[no]incompatible_disallow_legacy_py_provider 默认值:“true”
无操作性通知,很快就会被移除。
标记:loading_and_analysisincompatible_change
--[no]incompatible_enforce_config_setting_visibility 默认值:“true”
如果为 true,则强制执行 config_setting 公开范围限制。如果为 false,则每个 config_setting 对每个目标都可见。请参阅 https://github.com/bazelbuild/bazel/issues/12932。
标记:loading_and_analysisincompatible_change
用于控制测试环境或测试运行程序的行为的选项:
--[no]allow_analysis_failures 默认值:“false”
如果为 true,则规则目标的分析失败会导致目标传播包含错误说明的 AnalysisFailureInfo 实例,而不会导致构建失败。
标记:loading_and_analysisexperimental
--analysis_testing_deps_limit=<an integer> 默认值:“2000”
通过包含 for_analysis_testing 配置转换的规则属性设置传递依赖项的数量上限。超过此限制将导致规则错误。
标记: loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure 默认值:“false”
如果 dex2oat 操作为 true,则会导致构建中断,而不会在测试运行时期间执行 dex2oat。
标记:loading_and_analysisexperimental
--[no]check_tests_up_to_date 默认值:“false”
请勿运行测试,只需检查它们是否为最新版本即可。如果所有测试结果均为最新,则表示测试成功完成。如果需要构建或执行任何测试,则系统会报告错误,并且测试会失败。此选项意味着 --check_up_to_date 行为。
标记: execution
--[no]experimental_android_use_parallel_dex2oat 默认值:“false”
同时使用 dex2oat 可以加快 android_test 的运行速度。
标记:loading_and_analysishost_machine_resource_optimizationsexperimental
已累计 --flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once> 次多次使用
如果测试失败,每个测试的重试次数不会超过指定次数。需要多次尝试通过的测试在测试摘要中会被标记为“FLAKY”。通常,指定的值只是一个整数或字符串“default”。如果是整数,则所有测试最多运行 N 次。如果为“default”,则对于常规测试,将仅执行一次测试尝试;对于被其规则(flaky=1 属性)明确标记为不稳定的测试,将执行三次测试。替代语法:regex_filter@flaky_test_attempts。其中 flaky_test_attempts 与上述示例相同,而 regex_filter 代表包含和排除正则表达式模式的列表(另请参阅 --runs_per_test)。示例:--flaky_test_attempts=//foo/.*,-//foo/bar/.*@3 将 //foo/ 中的所有测试除 foo/bar 下的测试之外的所有测试三次均不稳定。可以多次传递此选项。最新传递且匹配的参数优先。如果没有匹配项,则行为就像上面的“default”(默认)一样。
标记: execution
--[no]ios_memleaks 默认值:“false”
启用 ios_test 目标中的内存泄漏检查功能。
标记: action_command_lines
--ios_simulator_device=<a string> 默认值:请参阅说明
在模拟器中运行 iOS 应用(例如“iPhone 6”)时要模拟的设备。您可以在运行模拟器的机器上运行“xcrun simctl list devicetypes”来获取设备列表。
标记: test_runner
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> 默认值:请参阅说明
运行或测试时要在模拟器上运行的 iOS 版本。如果 ios_test 规则中指定了目标设备,系统会忽略此规则。
标记: test_runner
--local_test_jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5"> 默认值:“auto”
要同时运行的本地测试作业数量上限。接受整数或关键字(“auto”“HOST_CPUS”“HOST_RAM”),后面可选择性地后跟运算符 ([-|*]<float>),例如:"auto", "HOST_CPUS*.5"。0 表示本地资源将限制并发运行的本地测试作业数量。如果将此值设置为大于 --jobs 的值,则没有效果。
标记: execution
已累计 --runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once> 次多次使用
指定每项测试的运行次数。如果其中任何一项测试因任何原因失败,整个测试都将被视为失败。通常,指定的值只是一个整数。示例:--runs_per_test=3 会运行所有测试 3 次。替代语法:regex_filter@runs_per_test。其中,runs_per_test 代表整数值,而 regex_filter 代表包含和排除正则表达式模式的列表(另请参阅 --instrumentation_filter)。示例:--runs_per_test=//foo/.*,-//foo/bar/.*@3 运行 //foo/ 中的所有测试(foo/bar 下的测试除外)三次。可以多次传递此选项。最新传递且匹配的参数优先。如果没有匹配项,该测试将仅运行一次。
已累计 --test_env=<a 'name=value' assignment with an optional value part> 次多次使用
指定要注入到测试运行程序环境的其他环境变量。变量可以按名称指定(在这种情况下,其值将从 Bazel 客户端环境中读取),或者按名称=值对进行读取。可多次使用此选项来指定多个变量。仅供“bazel test”命令使用。
标记: test_runner
--[no]test_keep_going 默认值:“true”
停用后,任何未通过的测试都会导致整个 build 停止。默认情况下,系统会运行所有测试,即使某些测试没有通过也是如此。
标记: execution
--test_strategy=<a string> 默认值:“”
指定在运行测试时要使用的策略。
标记: execution
--test_timeout=<a single integer or comma-separated list of 4 integers> 默认值:“-1”
替换测试超时的默认测试超时值(以秒为单位)。如果指定了单个正整数值,则该值将覆盖所有类别。如果指定了 4 个以英文逗号分隔的整数,这些值会替换短、中、长和永恒(按此顺序)的超时设置。无论使用哪种方式,值 -1 都会指示 Blaze 对该类别使用其默认超时。
--test_tmpdir=<a path> 默认值:请参阅说明
指定供“bazel test”使用的基本临时目录。
--tvos_simulator_device=<a string> 默认值:请参阅说明
在模拟器中运行 tvOS 应用时(例如“Apple TV 1080p”)时要模拟的设备。您可以在运行模拟器的机器上运行“xcrun simctl list devicetypes”来获取设备列表。
标记: test_runner
--tvos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> 默认值:请参阅说明
运行或测试时要在模拟器上运行的 tvOS 版本。
标记: test_runner
--watchos_simulator_device=<a string> 默认值:请参阅说明
在模拟器中运行 watchOS 应用时(例如“Apple Watch - 38mm”)时要模拟的设备。您可以在运行模拟器的机器上运行“xcrun simctl list devicetypes”来获取设备列表。
标记: test_runner
--watchos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> 默认值:请参阅说明
运行或测试时要在模拟器上运行的 watchOS 版本。
标记: test_runner
--[no]zip_undeclared_test_outputs 默认值:“true”
如果为 true,则未声明的测试输出将归档为一个 ZIP 文件。
标记:test_runner
触发构建时优化的选项:
--[no]collapse_duplicate_defines 默认值:“false”
启用后,系统会在 build 中尽早移除多余的 --定义。这样可以避免某些类型的等效 build 出现不必要的分析缓存丢失。
标记:loading_and_analysisloses_incremental_state
--[no]experimental_filter_library_jar_with_program_jar 默认值:“false”
过滤 ProGuard ProgramJar 以移除 LibraryJar 中也存在的所有类。
标记: action_command_lines
--[no]experimental_inmemory_dotd_files 默认值:“true”
启用后,C++ .d 文件将直接从远程 build 节点在内存中传递,而不是写入磁盘。
标记:loading_and_analysisexecutionaffects_outputsexperimental
--[no]experimental_inmemory_jdeps_files 默认值:“true”
启用后,通过 Java 编译生成的依赖项 (.jdeps) 文件将直接从远程构建节点在内存中传递,而不是写入磁盘。
标记:loading_and_analysisexecutionaffects_outputsexperimental
--[no]experimental_objc_include_scanning 默认值:“false”
是否针对目标 C/C++ 执行包含扫描。
标记:loading_and_analysisexecutionchanges_inputs
--[no]experimental_parse_headers_skipped_if_corresponding_srcs_found 默认值:“false”
启用后,如果在同一目标中发现具有相同基名的来源,parse_headers 功能不会创建单独的标头编译操作。
标记:loading_and_analysisaffects_outputs
--[no]experimental_retain_test_configuration_across_testonly 默认值:“false”
启用后,对于标记为 testonly=1 的规则,--trim_test_configuration 不会修剪测试配置。这是为了减少非测试规则依赖于 cc_test 规则时的操作冲突问题。如果 --trim_test_configuration 为 false,则无效。
标记:loading_and_analysisloses_incremental_state
--[no]experimental_starlark_cc_import 默认值:“false”
启用后,即可使用 Starlark 版本的 cc_import。
标记:loading_and_analysisexperimental
--[no]experimental_unsupported_and_brittle_include_scanning 默认值:“false”
是否通过解析输入文件中的 #include 行来缩小 C/C++ 编译的输入范围。这可以通过减小编译输入树的大小来提高性能和增量。不过,它也可能会中断构建,因为 include 扫描器无法完全实现 C 预处理器语义。特别是,它不理解动态 #include 指令,并且会忽略预处理器的条件逻辑。使用时需自行承担风险。已提交的与此标志相关的任何问题都将关闭。
标记:loading_and_analysisexecutionchanges_inputs
--[no]incremental_dexing 默认值:“true”
为每个 Jar 文件分别执行 dex 处理的大部分工作。
标记:affects_outputsloading_and_analysisloses_incremental_state
--[no]objc_use_dotd_pruning 默认值:“true”
如果设置了此字段,则 Clang 发出的 .d 文件将用于剪除传入 objc 编译项的输入集。
标记:changes_inputsloading_and_analysis
--[no]process_headers_in_dependencies 默认值:“false”
构建目标 //a:a 时,处理 //a:a 所依赖的所有目标中的标头(如果工具链启用了标头处理功能)。
标记: execution
--[no]trim_test_configuration 默认值:“true”
启用后,与测试相关的选项将在 build 顶层下方清除。当此标志处于启用状态时,无法将测试构建为非测试规则的依赖项,但对测试相关选项的更改不会导致系统重新分析非测试规则。
标记:loading_and_analysisloses_incremental_state
--[no]use_singlejar_apkbuilder 默认值:“true”
此选项已弃用。该功能现在是一种空操作,很快就会被移除。
标记: loading_and_analysis
影响日志记录的详细程度、格式或位置的选项:
--[no]announce 默认值:“false”
已废弃。无操作。
标记:affects_outputs
--[no]experimental_bep_target_summary 默认值:“false”
是否发布 TargetSummary 事件。
--[no]experimental_build_event_expand_filesets 默认值:“false”
如果为 true,则会在显示输出文件时展开 BEP 中的文件集。
标记: affects_outputs
如果为 true,则在显示输出文件时完全解析 BEP 中的相对 Fileset 符号链接。需要 --experimental_build_event_expand_filesets。
标记: affects_outputs
--experimental_build_event_upload_max_retries=<an integer> 默认值:“4”
Bazel 应重新尝试上传构建事件的次数上限。
标记: bazel_internal_configuration
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.> 默认值:“1s”
BEP 上传失败时指数退避算法重试的初始延迟时间下限。(指数:1.6)
标记:bazel_internal_configuration
--experimental_build_event_upload_strategy=<a string> 默认值:请参阅说明
选择如何上传构建事件协议中引用的工件。
标记: affects_outputs
--[no]experimental_materialize_param_files_directly 默认值:“false”
如果要具体化参数文件,请通过直接写入磁盘来实现。
标记: execution
--[no]experimental_stream_log_file_uploads 默认值:“false”
将日志文件上传内容直接流式传输到远程存储空间,而不是将其写入磁盘。
标记: affects_outputs
--explain=<a path> 默认值:请参阅说明
使构建系统解释构建的每个已执行步骤。说明将写入指定的日志文件。
标记: affects_outputs
--[no]legacy_important_outputs 默认值:“true”
使用此方法可禁止在 TargetComplete 事件中生成旧版 important_outputs 字段。Bazel 到 ResultStore 集成需要包含 important_outputs。
标记: affects_outputs
--[no]materialize_param_files 默认值:“false”
即使在使用远程操作执行时,也会将中间参数文件写入输出树。在调试操作时很有用。这是 --subcommands 和 --verbose_failures 暗示的。
标记: execution
--max_config_changes_to_show=<an integer> 默认值:“3”
如果因构建选项的变化而舍弃分析缓存,则最多可显示指定数量的已更改选项名称。如果给定数字为 -1,系统将显示所有已更改的选项。
标记: terminal_output
--max_test_output_bytes=<an integer> 默认值:“-1”
指定当 --test_output 为“errors”或“all”时可以发出的每个测试日志的最大大小。有助于避免过于嘈杂的测试输出导致输出不堪重负。测试标头会计入日志大小。负值表示无限制。输出内容可以是全部或零。
标记:test_runnerterminal_outputexecution
--output_filter=<a valid Java regular expression> 默认值:请参阅说明
仅显示名称与提供的正则表达式匹配的规则的警告。
标记: affects_outputs
--progress_report_interval=<an integer in 0-3600 range> 默认值:“0”
报告仍在运行的作业之间间隔的秒数。默认值 0 表示将在 10 秒后输出第一份报告,然后在 30 秒后输出第一份报告,之后每分钟报告一次进度。启用 --curses 后,每秒报告一次进度。
标记: affects_outputs
--show_result=<an integer> 默认值:“1”
显示构建结果。对于每个目标,请说明其是否已更新为最新版本;如果是,则显示已构建的输出文件列表。输出的文件是方便复制并粘贴到 shell 中的字符串。此选项需要一个整数参数,该参数是目标值的阈值,超过该值将不会输出结果信息。因此,零会导致抑制消息,而 MAX_INT 则会导致始终输出结果。默认值为 1。
标记: affects_outputs
--[no]subcommands [-s] 默认值:“false”
显示构建期间执行的子命令。相关标志:--execution_log_json_file、--execution_log_binary_file(用于以适合工具的格式将子命令记录到文件中)。
标记: terminal_output
--test_output=<summary, errors, all or streamed> 默认值:“summary”
指定所需的输出模式。有效值包括:“summary”用于仅输出测试状态摘要,“errors”用于输出失败测试的测试日志,“all”用于输出所有测试的日志,“streamed”用于实时输出所有测试的输出日志(这会强制在本地执行一个测试,无论 --test_strategy 值如何)。
标记:test_runnerterminal_outputexecution
--test_summary=<short, terse, detailed, none or testcase> 默认值:“short”
指定所需的测试摘要格式。有效值为“short”,用于仅输出关于已执行的测试的信息;“terse”用于仅输出关于运行失败的测试的信息;“detailed”用于输出有关失败的测试用例的详细信息;“testcase”用于输出关于测试用例分辨率的摘要;不输出有关失败测试用例的详细信息;“none”用于省略摘要。
标记: terminal_output
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths> 默认值:“-.*”
在工具链解析期间输出调试信息。该标志采用一个正则表达式,系统会根据工具链类型和特定目标检查该正则表达式,以确定要调试哪个版本。您可以使用英文逗号分隔多个正则表达式,然后单独检查每个正则表达式。注意:此标志的输出非常复杂,可能仅供工具链解析方面的专家使用。
标记: terminal_output
--[no]verbose_explanations 默认值:“false”
启用 --explain 时,可提高所发出说明的详细程度。如果未启用 --explain,则无效。
标记: affects_outputs
--[no]verbose_failures 默认值:“false”
如果某个命令失败,则输出完整的命令行。
标记: terminal_output
用于指定或更改不属于其他类别的 Bazel 命令的通用输入的选项:
已累计 --aspects_parameters=<a 'name=value' assignment> 次多次使用
指定命令行切面参数的值。每个参数值都是通过 <param_name>=<param_value> 指定的,例如“my_param=my_val”,其中“my_param”是 --aspects 列表中的某一方面的参数,或列表中的某一方面所需的参数。此选项可多次使用。但是,不允许为同一参数多次指定值。
标记: loading_and_analysis
已累计 --flag_alias=<a 'name=value' flag alias> 次多次使用
为 Starlark 标志设置简写名称。它使用“<key>=<value>”形式的单个键值对作为参数。
标记: changes_inputs
--[no]incompatible_default_to_explicit_init_py 默认值:“false”
此标志会更改默认行为,以便系统不再在 Python 目标的 runfile 中自动创建 __init__.py 文件。确切地说,当 py_binary 或 py_test 目标将 legacy_create_init 设置为“auto”(默认值)时,当且仅当设置了此标记时,它才会被视为 false。请参阅 https://github.com/bazelbuild/bazel/issues/10076。
标记:affects_outputsincompatible_change
--[no]incompatible_py2_outputs_are_suffixed 默认值:“true”
如果为 true,则在 Python 2 配置中构建的目标将显示在包含后缀“-py2”的输出根目录下,而为 Python 3 构建的目标将显示在没有与 Python 相关后缀的根下。这意味着,“bazel-bin”便捷符号链接将指向 Python 3 目标,而不是 Python 2。如果启用此选项,还建议您启用“--incompatible_py3_is_default”。
标记:affects_outputsincompatible_change
--[no]incompatible_py3_is_default 默认值:“true”
如果为 true,则未设置其 `python_version`(或 `default_python_version`)属性的 `py_binary` 和 `py_test` 目标将默认为 PY3,而不是 PY2。如果设置了此标志,还建议您设置“--incompatible_py2_outputs_are_suffixed”。
标记:loading_and_analysisaffects_outputsincompatible_change
--[no]incompatible_use_python_toolchains 默认值:“true”
如果设置为 true,可执行原生 Python 规则将使用 Python 工具链指定的 Python 运行时,而不是由旧版标志(如 --python_top)指定的运行时。
标记:loading_and_analysisincompatible_change
--python_version=<PY2 or PY3> 默认值:请参阅说明
Python 主要版本模式,即“PY2”或“PY3”。请注意,这会被“py_binary”和“py_test”目标替换(即使它们未明确指定版本),因此通常没有太多理由提供此标志。
标记:loading_and_analysisaffects_outputsexplicit_in_output_path
--target_pattern_file=<a string> 默认值:“”
如果设置此参数,build 将从此处(而不是命令行)指定的文件中读取模式。在此处指定文件以及命令行模式是错误的。
标记: changes_inputs
远程缓存和执行选项:
--experimental_remote_cache_eviction_retries=<an integer> 默认值:“0”
在构建遇到远程缓存逐出错误时重试的最大次数。非零值会将 --incompatible_remote_use_new_exit_code_for_lost_inputs 隐式设置为 true。系统会针对每次尝试生成一个新的调用 ID。如果您生成调用 ID 并使用 --invocation_id 将其提供给 Bazel,则不应使用此标志,请改为设置 标志 --incompatible_remote_use_new_exit_code_for_lost_inputs 并检查退出代码 39。
标记: execution
其他选项,未以其他方式分类:
--[no]allow_analysis_cache_discard 默认值:“true”
如果由于构建系统的更改而舍弃分析缓存,则将此选项设置为 false 将导致 bazel 退出,而不是继续进行构建。同时设置了“discard_analysis_cache”时,此选项无效。
标记: eagerness_to_exit
--[no]build_manual_tests 默认值:“false”
强制构建标记为“manual”的测试目标。“手动”测试不会处理。此选项会强制构建(但不执行)。
--build_tag_filters=<comma-separated list of options> 默认值:“”
指定以逗号分隔的标记列表。您可以选择在每个代码前面加上“-”,以指定排除的代码。系统只会构建包含至少一个包含标记且不包含任何已排除标记的目标。此选项不会影响使用“test”命令执行的测试集;它们受测试过滤选项(例如“--test_tag_filters”)的约束
--[no]build_tests_only 默认值:“false”
如果指定,则仅构建 *_test 和 test_suite 规则,并忽略命令行中指定的其他目标。默认情况下,系统将构建请求的所有内容。
--[no]cache_test_results [-t] 默认值:“auto”
如果设置为“auto”,则仅当满足以下条件时,Bazel 才会重新运行测试:(1) Bazel 检测到测试或其依赖项中的更改;(2) 测试标记为外部;(3) 使用 --runs_per_test 请求了多次测试运行;或(4) 之前测试失败。如果设置为“yes”,Bazel 会缓存所有测试结果,但标记为外部的测试除外。如果设置为“no”,Bazel 不会缓存任何测试结果。
--[no]compile_one_dependency 默认值:“false”
编译参数文件的单个依赖项。这对于 IDE 中的语法检查源文件非常有用,例如,通过重新构建依赖于源文件的单个目标,在编辑/构建/测试周期中尽早检测到错误。此参数会影响所有非 flag 参数的解释方式;它们不是构建目标,而是源文件名。对于每个源文件名,系统将构建一个依赖于该文件名的任意目标。
--deleted_packages=<comma-separated list of package names> 默认值:“”
以逗号分隔的软件包名称列表,构建系统将其视为不存在的软件包名称,即使这些软件包在软件包路径上的某个位置可见。 当删除现有包“x”的子包“x/y”时,使用此选项。例如,在客户端中删除 x/y/BUILD 后,如果编译系统遇到标签“//x:y/z”(如果仍然由另一个 package_path 条目提供),则可能会收到错误消息。指定 --deleted_packages x/y 可避免此问题。
--[no]discard_analysis_cache 默认值:“false”
在分析阶段完成后立即舍弃分析缓存。将内存用量减少约 10%,但会减慢进一步增量构建的速度。
--execution_log_binary_file=<a path> 默认值:请参阅说明
根据 src/main/protobuf/spawn.proto,将执行的生成项目作为分隔的 Spawn proto 记录到此文件中。该日志首先无序写入,然后在调用结束时按稳定顺序排序(可能是 CPU 和内存密集型)。相关标志:--execution_log_json_file(有序文本 JSON 格式)、--experimental_execution_log_file(无序二进制 protobuf 格式)、--subcommands(用于在终端输出中显示子命令)。
--execution_log_json_file=<a path> 默认值:请参阅说明
根据 src/main/protobuf/spawn.proto,将已执行的生成操作以 json 表示形式记录到此文件中,这些表示要分隔的 Spawn proto。该日志首先无序写入,然后在调用结束时按稳定顺序排序(可能是 CPU 和内存密集型)。相关标志:相关标志:--execution_log_binary_file(有序二进制 protobuf 格式)、--experimental_execution_log_file(无序二进制 protobuf 格式)、--subcommands(用于在终端输出中显示子命令)。
--[no]execution_log_sort 默认值:“true”
是否对执行日志进行排序。设置为 false 可提高内存性能,但代价是以不确定的顺序生成日志。
--[no]expand_test_suites 默认值:“true”
先将 test_suite 目标扩展为其组成部分测试,然后再进行分析。当此标志处于启用状态(默认设置)时,排除性目标模式将应用于属于该测试套件的测试,否则不会应用于属于该测试套件的测试。如果在命令行中应用顶级切面,则关闭此标记会很有用:这样它们就可以分析 test_suite 目标。
标记: loading_and_analysis
--[no]experimental_cancel_concurrent_tests 默认值:“false”
如果为 true,则 Blaze 将在第一次成功运行时取消同时运行测试。此参数必须与 --runs_per_test_detects_flakes 结合使用。
标记:affects_outputsloading_and_analysis
--experimental_execution_log_file=<a path> 默认值:请参阅说明
根据 src/main/protobuf/spawn.proto,将执行的生成项目作为分隔的 Spawn proto 记录到此文件中。该文件是按照“Spawns”执行顺序写入的。相关标志:--execution_log_binary_file(有序的二进制 protobuf 格式)、--execution_log_json_file(有序文本 json 格式)、--subcommands(用于在终端输出中显示子命令)。
--[no]experimental_execution_log_spawn_metrics 默认值:“false”
在已执行的生成项日志中包含生成指标。
--experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths> 默认值:“”
废弃了,取而代之的是切面。过滤要调度 extra_action 的一组目标。
--[no]experimental_extra_action_top_level_only 默认值:“false”
废弃了,取而代之的是切面。仅为顶级目标安排 extra_actions。
--[no]experimental_fetch_all_coverage_outputs 默认值:“false”
如果为 true,Bazel 会在覆盖率运行期间为每个测试提取整个覆盖率数据目录。
标记:affects_outputsloading_and_analysis
--[no]experimental_generate_llvm_lcov 默认值:“false”
如果为 true,对 Clang 的覆盖率将生成 LCOV 报告。
标记:affects_outputsloading_and_analysis
--[no]experimental_j2objc_header_map 默认值:“true”
是否在 J2ObjC 转译的同时生成 J2ObjC 头文件映射。
--[no]experimental_j2objc_shorter_header_path 默认值:“false”
是否使用较短的标头路径(使用“_ios”而不是“_j2objc”)生成。
标记: affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel> 默认值:“javabuilder”
为 Java 编译启用了缩减的类路径。
--[no]experimental_limit_android_lint_to_android_constrained_java 默认值:“false”
将 --experimental_run_android_lint_on_java_rules 限制为 Android 兼容库。
标记: affects_outputs
--[no]experimental_prioritize_local_actions 默认值:“true”
如果设置了此属性,那么只能在本地运行的操作有第一次获取资源的机会,动态运行的工作器有第二次机会,动态运行的独立操作最后才有机会。
标记: execution
--[no]experimental_run_android_lint_on_java_rules 默认值:“false”
是否验证 java_* 源代码。
标记: affects_outputs
--[no]explicit_java_test_deps 默认值:“false”
在 java_test 中明确指定 JUnit 或 Hamcrest 的依赖项,而不是意外从 TestRunner 的依赖项中获取。目前仅适用于 bazel。
--host_java_launcher=<a build target label> 默认值:请参阅说明
在构建期间执行的工具使用的 Java 启动器。
已累计 --host_javacopt=<a string> 次多次使用
构建在构建期间执行的工具时传递给 javac 的其他选项。
已累计 --host_jvmopt=<a string> 次多次使用
构建在构建期间执行的工具时传递给 Java 虚拟机的其他选项。这些选项将添加到每个 java_binary 目标的虚拟机启动选项中。
--[no]incompatible_check_sharding_support 默认值:“false”
如果为 true,则 Bazel 会在测试运行程序未通过轻触 TEST_SHARD_STATUS_FILE 路径下的文件来表明它支持分片时,导致分片测试失败。如果为 false,不支持分片的测试运行程序会导致在每个分片中运行所有测试。
标记: incompatible_change
--[no]incompatible_exclusive_test_sandboxed 默认值:“false”
如果为 true,专用测试将使用沙盒策略运行。添加“local”标记以在本地强制运行独家测试
标记: incompatible_change
--[no]incompatible_strict_action_env 默认值:“false”
如果为 true,Bazel 会使用具有静态 PATH 值的环境,并且不会继承 LD_LIBRARY_PATH。如果您想从客户端继承特定环境变量,请使用 --action_env=ENV_VARIABLE;但请注意,如果使用了共享缓存,这样做可能会阻止用户进行跨用户缓存。
标记:loading_and_analysisincompatible_change
已累计 --j2objc_translation_flags=<comma-separated list of options> 次多次使用
可传递给 J2ObjC 工具的其他选项。
--java_debug
使 Java 测试的 Java 虚拟机在开始测试之前等待来自兼容 JDWP 的调试程序(例如 jdb)的连接。隐式为 -test_output=streamed。
扩展为:
  --test_arg=--wrapper_script_flag=--debug
  --test_output=streamed
  --test_strategy=exclusive
  --test_timeout=9999
  --nocache_test_results
--[no]java_deps 默认值:“true”
每个 Java 目标生成依赖项信息(目前为编译时类路径)。
--[no]java_header_compilation 默认值:“true”
直接从源代码编译 ijar。
--java_language_version=<a string> 默认值:“8”
Java 语言版本
--java_launcher=<a build target label> 默认值:请参阅说明
构建 Java 二进制文件时使用的 Java 启动器。如果此标志设置为空字符串,系统会使用 JDK 启动器。“launcher”属性会替换此标志。
--java_runtime_version=<a string> 默认值:“local_jdk”
Java 运行时版本
已累计 --javacopt=<a string> 次多次使用
需要传递给 javac 的其他选项。
已累计 --jvmopt=<a string> 次多次使用
用于传递给 Java 虚拟机的其他选项。这些选项将添加到每个 java_binary 目标的虚拟机启动选项中。
--legacy_main_dex_list_generator=<a build target label> 默认值:请参阅说明
指定一个二进制文件,用于生成编译旧版 MultiDex 时必须位于主 dex 中的类列表。
--local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.> 默认值:“HOST_CPUS”
明确设置可供 Bazel 用于在本地执行的构建操作的本地 CPU 核心总数。接受整数或“HOST_CPUS”,可以选择后跟 [-|*]<float>(例如HOST_CPUS*.5 表示使用一半可用的 CPU 核心。默认情况下(“HOST_CPUS”),Bazel 会查询系统配置以估算可用的 CPU 核心数量。
已累计 --local_extra_resources=<a named float, 'name=value'> 次多次使用
设置可供 Bazel 使用的额外资源的数量。接受字符串-浮点对。可以多次使用,以指定多种类型的额外资源。Bazel 将根据可用的额外资源和所需的额外资源限制并发运行的操作。测试可以使用“resources:<resoucename>:<amount>”格式的标记来声明它们所需的额外资源数量。无法使用此标志设置可用的 CPU、RAM 和资源。
--local_ram_resources=<an integer, or "HOST_RAM", optionally followed by [-|*]<float>.> 默认值:“HOST_RAM*.67”
明确设置可供 Bazel 用于在本地执行的构建操作的本地主机 RAM 总量(以 MB 为单位)。采用整数或“HOST_RAM”,可以选择后跟 [-|*]<float>(例如HOST_RAM*.5 将使用一半可用 RAM)。默认情况下(“HOST_RAM*.67”),Bazel 会查询系统配置以估算可用 RAM 容量,并会使用 67% 的 RAM 容量。
--local_termination_grace_seconds=<an integer> 默认值:“15”
从因超时终止本地进程到将其强制关闭之间等待的时间。
--package_path=<colon-separated list of options> 默认值:“%workspace%”
以英文冒号分隔的列表,用于列出查找软件包的位置。以“%workspace%”开头的元素相对于封闭工作区。如果省略或为空,则默认值为“bazel info default-package-path”的输出。
已累计 --plugin=<a build target label> 次多次使用
要在 build 中使用的插件。目前可与 java_plugin 配合使用。
--proguard_top=<a build target label> 默认值:请参阅说明
指定在构建 Java 二进制文件时要使用哪种 ProGuard 版本移除代码。
--proto_compiler=<a build target label> 默认值:“@bazel_tools//tools/proto:protoc”
proto 编译器的标签。
标记:affects_outputsloading_and_analysis
--proto_toolchain_for_cc=<a build target label> 默认值:“@bazel_tools//tools/proto:cc_toolchain"
proto_lang_toolchain() 的标签,用于描述如何编译 C++ proto。
标记:affects_outputsloading_and_analysis
--proto_toolchain_for_j2objc=<a build target label> 默认值:“@bazel_tools//tools/j2objc:j2objc_proto_toolchain"
proto_lang_toolchain() 的标签,用于描述如何编译 j2objc protos
标记:affects_outputsloading_and_analysis
--proto_toolchain_for_java=<a build target label> 默认值:“@bazel_tools//tools/proto:java_toolchain"
proto_lang_toolchain() 的标签,用于描述如何编译 Java proto
标记:affects_outputsloading_and_analysis
--proto_toolchain_for_javalite=<a build target label> 默认值:“@bazel_tools//tools/proto:javalite_toolchain"
proto_lang_toolchain() 的标签,用于描述如何编译 JavaLite proto
标记:affects_outputsloading_and_analysis
已累计 --protocopt=<a string> 次多次使用
需要传递给 protobuf 编译器的其他选项。
标记: affects_outputs
--[no]runs_per_test_detects_flakes 默认值:“false”
如果为 true,则至少有一个运行/尝试通过且至少有一次运行/尝试失败的任何分片都会获得 FLAKY 状态。
--shell_executable=<a path> 默认值:请参阅说明
供 Bazel 使用的 shell 可执行文件的绝对路径。如果未设置此属性,但 BAZEL_SH 环境变量是在首次 Bazel 调用(启动 Bazel 服务器)时设置的,则 Bazel 会使用此变量。如果二者都未设置,则 Bazel 会使用硬编码的默认路径,具体取决于其运行的操作系统(Windows:c:/tools/msys64/usr/bin/bash.exe、FreeBSD:/usr/local/bin/bash,其他所有平台:/bin/bash)。请注意,使用与 bash 不兼容的 shell 可能会导致生成的二进制文件构建失败或运行时失败。
标记: loading_and_analysis
--[no]show_loading_progress 默认值:“true”
启用后,Bazel 会显示“正在加载软件包:”消息。
已累计 --test_arg=<a string> 次多次使用
指定应传递给测试可执行文件的其他选项和实参。可以多次使用指定多个参数。如果执行多个测试,每个测试都将收到相同的参数。仅供“bazel test”命令使用。
--test_filter=<a string> 默认值:请参阅说明
指定要转发到测试框架的过滤器。用于限制测试的运行。请注意,这不会影响构建哪些目标。
--test_lang_filters=<comma-separated list of options> 默认值:“”
指定以英文逗号分隔的测试语言列表。您可以选择在每种语言前面加上“-”,以指定排除的语言。只能找到以指定语言编写的测试目标。每种语言使用的名称应与 *_test 规则中的语言前缀相同,例如“cc”、“java”、“py”等之一。此选项会影响 --build_tests_only 行为和测试命令。
--test_result_expiration=<an integer> 默认值:“-1”
此选项已弃用,无效。
--[no]test_runner_fail_fast 默认值:“false”
将失败快速选项转发给测试运行程序。测试运行程序应在第一次失败时停止执行。
--test_sharding_strategy=<explicit or disabled> 默认值:“露骨内容”
指定测试分片策略:“露骨内容”,以便仅在存在“hard_count”BUILD 属性时才使用分片。“disabled”表示从不使用测试分片。
--test_size_filters=<comma-separated list of values: small, medium, large or enormous> 默认值:“”
指定以英文逗号分隔的测试尺寸列表。可以选择在每个尺寸前面加上“-”,以指定排除的尺寸。只能发现这些测试目标至少包含一个已包含的尺寸,而不包含任何已排除的尺寸。此选项会影响 --build_tests_only 行为和测试命令。
--test_tag_filters=<comma-separated list of options> 默认值:“”
指定以英文逗号分隔的测试标记列表。您可以选择在每个代码前面加上“-”,以指定排除的代码。只能发现这些测试目标至少包含一个已包含的代码,且不包含任何已排除的代码。此选项会影响 --build_tests_only 行为和测试命令。
--test_timeout_filters=<comma-separated list of values: short, moderate, long or eternal> 默认值:“”
指定以逗号分隔的测试超时列表。可以选择在每个超时前面加上“-”,以指定排除的超时。系统只会发现这些测试目标至少包含 1 个已包含的超时,且不包含任何已排除的超时。此选项会影响 --build_tests_only 行为和测试命令。
--tool_java_language_version=<a string> 默认值:“8”
用于执行构建期间所需工具的 Java 语言版本
--tool_java_runtime_version=<a string> 默认值:“remotejdk_11”
用于在构建期间执行工具的 Java 运行时版本
--[no]use_ijars 默认值:“true”
启用后,此选项会导致 Java 编译使用接口 JAR。这样可以加快增量编译的速度,但错误消息可能会有所不同。

Canonicalize-flags 选项

build 继承所有选项。

出现在命令之前并由客户端解析的选项:
已累计 --distdir=<a path> 次多次使用
在访问网络以下载归档文件之前,可在其他位置搜索归档文件。
标记: bazel_internal_configuration
如果已设置,代码库缓存将在缓存命中时对文件进行硬链接,而不是复制。这是为了节省磁盘空间。
标记: bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id 默认值:“false”
如果为 true,请使用从代码库下载网址派生的字符串作为 canonical_id(如果未指定)。这会导致网址发生变化,进而重新下载,即使缓存中包含具有相同哈希值的下载内容。这可用于验证网址更改不会导致损坏的代码库被缓存遮盖。
标记:loading_and_analysisexperimental
--[no]experimental_repository_disable_download 默认值:“false”
如果设置此参数,则不允许下载外部代码库。
标记: experimental
--experimental_repository_downloader_retries=<an integer> 默认值:“0”
重新尝试下载错误的最大尝试次数。如果设置为 0,系统会停用重试。
标记: experimental
--experimental_scale_timeouts=<a double> 默认值:“1.0”
按此系数扩缩 Starlark 代码库规则中的所有超时时间。通过这种方式,可以在不更改源代码的情况下使外部代码库在速度低于规则作者的机器上运行。
标记:bazel_internal_configurationexperimental
--http_timeout_scaling=<a double> 默认值:“1.0”
按指定系数调整与 HTTP 下载相关的所有超时
标记: bazel_internal_configuration
--repository_cache=<a path> 默认值:请参阅说明
指定在提取外部代码库期间获取的已下载值的缓存位置。使用空字符串作为参数会请求停用缓存。
标记: bazel_internal_configuration
用于控制命令输出的选项:
--[no]canonicalize_policy 默认值:“false”
在展开和过滤后输出规范化政策。为了确保输出内容简洁明了,当此选项设置为 true 时,将不会显示规范化的命令参数。请注意,--for_command 指定的命令会影响已过滤的政策,如果未指定,则默认命令为“build”。
标记:affects_outputsterminal_output
--[no]show_warnings 默认值:“false”
将解析器警告输出为标准错误(例如,针对有冲突的标志选项)。
标记: affects_outputsterminal_output
影响 Bazel 强制执行有效 build 输入的严格程度的选项(规则定义、标志组合等):
--experimental_repository_hash_file=<a string> 默认值:“”
如果非空,请指定一个包含解析值的文件,应针对该值验证代码库目录哈希值
标记:affects_outputsexperimental
已累计 --experimental_verify_repository_rules=<a string> 次多次使用
如果要验证输出目录的哈希值的代码库规则列表,则要通过 --experimental_repo_hash_file 指定文件。
标记:affects_outputsexperimental
此选项会影响 Starlark 语言或 build 文件、.bzl 文件或 WORKSPACE 文件可访问的 build API 的语义。
--[no]experimental_allow_top_level_aspects_parameters 默认值:“true”
无操作
标记:no_opdeprecatedexperimental
--[no]incompatible_config_setting_private_default_visibility 默认值:“false”
如果 incompatible_enforce_config_setting_visibility=false,则代表着空操作。否则,如果此标志为 false,则没有明确可见性属性的任何 config_setting 都是 //visibility:public。如果此标志为 true,config_setting 遵循与所有其他规则相同的可见性逻辑。请参阅 https://github.com/bazelbuild/bazel/issues/12933。
标记:loading_and_analysisincompatible_change
--[no]incompatible_enforce_config_setting_visibility 默认值:“true”
如果为 true,则强制执行 config_setting 公开范围限制。如果为 false,则每个 config_setting 对每个目标都可见。请参阅 https://github.com/bazelbuild/bazel/issues/12932。
标记:loading_and_analysisincompatible_change
与 Bzlmod 输出和语义相关的选项:
已累计 --allow_yanked_versions=<a string> 次多次使用
以 `<module1>@<version1>,<module2>@<version2>` 的形式指定模块版本,即使这些版本在来源的注册表中被声明了(如果它们不是来自 NonRegistryOverride),也会显示在已解析的依赖关系图中。否则,拉取版本将导致解析失败。您还可以使用 `BZLMOD_ALLOW_YANKED_VERSIONS` 环境变量定义允许的拖动版本。您可以使用关键字“all”停用此检查(不推荐)。
标记: loading_and_analysis
--check_bazel_compatibility=<error, warning or off> 默认值:“error”
检查 Bazel 模块的 Bazel 版本兼容性。有效值包括:“error”表示处理失败,“off”表示停用检查,“warning”表示检测到不匹配的情况时会显示警告。
标记: loading_and_analysis
--check_direct_dependencies=<off, warning or error> 默认值:“警告”
检查根模块中声明的直接“bazel_dep”依赖项是否与已解析的依赖关系图中的版本相同。有效值为 `off` 表示停用检查,`warning` 表示在检测到不匹配的情况时输出警告,或者是 `error`(用于将问题升级为解析失败)。
标记: loading_and_analysis
--[no]ignore_dev_dependency 默认值:“false”
如果为 true,Bazel 会忽略根模块的 MODULE.bazel 中声明为“dev_dependency”的“bazel_dep”和“use_extension”。请注意,无论此标志的值为何,只要不是根模块,MODULE.bazel 中就会始终忽略这些开发者依赖项。
标记: loading_and_analysis
--lockfile_mode=<off, update or error> 默认值:“off”
指定如何以及是否使用锁定文件。有效值包括:“update”表示使用 lockfile 并在发生变更时更新它;“error”表示使用 lockfile,但如果该文件不是最新状态,则会抛出错误;或者“off”表示既不从锁定文件读取数据,也不会向锁定文件写入数据。
标记: loading_and_analysis
已累计 --override_module=<an equals-separated mapping of module name to path> 次多次使用
替换采用 <模块名称>=<path> 形式的本地路径的模块。如果指定路径是绝对路径,系统将按原样使用该路径。如果指定路径是相对路径,则该路径相对于当前工作目录。如果指定路径以“%workspace%”开头,则该路径相对于工作区根目录,即“bazel info workspace”的输出
已累计 --registry=<a string> 次多次使用
指定用于查找 Bazel 模块依赖项的注册表。顺序很重要:系统会先在之前的注册表中查找模块,只有在之前的注册表中缺失模块时,才会回退到靠后的注册表。
标记: changes_inputs
影响日志记录的详细程度、格式或位置的选项:
--[no]experimental_record_metrics_for_all_mnemonics 默认值:“false”
默认情况下,操作类型的数量不得超过 20 种已执行操作数量最多的助记符。设置此选项会写入所有助记符的统计信息。
用于指定或更改不属于其他类别的 Bazel 命令的通用输入的选项:
--experimental_resolved_file_instead_of_workspace=<a string> 默认值:“”
如果为非空,则读取指定的已解析文件而不是 WORKSPACE 文件
标记: changes_inputs
--for_command=<a string> 默认值:“build”
应对其选项进行规范化的命令。
标记:affects_outputsterminal_output
--invocation_policy=<a string> 默认值:“”
将调用政策应用于要规范化的选项。
标记:affects_outputsterminal_output
远程缓存和执行选项:
--experimental_downloader_config=<a string> 默认值:请参阅说明
指定要用于配置远程下载程序的文件。此文件由几行组成,每个行都以指令(“allow”“block”或“rewrite”)开头,后跟主机名(分别用于“allow”和“block”)或两种格式,一种用于匹配,另一种用作替代网址,反向引用从“$1”开始。在这种情况下,系统可能会返回多个“rewrite”指令,供同一个网址提供,在这种情况下,系统会返回多个网址。
其他未分类的选项:
--deleted_packages=<comma-separated list of package names> 默认值:“”
以逗号分隔的软件包名称列表,构建系统将其视为不存在的软件包名称,即使这些软件包在软件包路径上的某个位置可见。 当删除现有包“x”的子包“x/y”时,使用此选项。例如,在客户端中删除 x/y/BUILD 后,如果编译系统遇到标签“//x:y/z”(如果仍然由另一个 package_path 条目提供),则可能会收到错误消息。指定 --deleted_packages x/y 可避免此问题。
已累计 --override_repository=<an equals-separated mapping of repository name to path> 次多次使用
使用格式为 <repo name>=<path> 的本地路径替换代码库。如果指定路径是绝对路径,系统将按原样使用该路径。如果指定路径是相对路径,则该路径是相对于当前工作目录而言的。如果指定路径以“%workspace%”开头,则该路径相对于工作区根目录,即“bazel info workspace”的输出
--package_path=<colon-separated list of options> 默认值:“%workspace%”
以英文冒号分隔的列表,用于列出查找软件包的位置。以“%workspace%”开头的元素相对于封闭工作区。如果省略或为空,则默认值为“bazel info default-package-path”的输出。
--[no]show_loading_progress 默认值:“true”
启用后,Bazel 会显示“正在加载软件包:”消息。

清理选项

build 继承所有选项。

出现在命令之前并由客户端解析的选项:
已累计 --distdir=<a path> 次多次使用
在访问网络以下载归档文件之前,可在其他位置搜索归档文件。
标记: bazel_internal_configuration
如果已设置,代码库缓存将在缓存命中时对文件进行硬链接,而不是复制。这是为了节省磁盘空间。
标记: bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id 默认值:“false”
如果为 true,请使用从代码库下载网址派生的字符串作为 canonical_id(如果未指定)。这会导致网址发生变化,进而重新下载,即使缓存中包含具有相同哈希值的下载内容。这可用于验证网址更改不会导致损坏的代码库被缓存遮盖。
标记:loading_and_analysisexperimental
--[no]experimental_repository_disable_download 默认值:“false”
如果设置此参数,则不允许下载外部代码库。
标记: experimental
--experimental_repository_downloader_retries=<an integer> 默认值:“0”
重新尝试下载错误的最大尝试次数。如果设置为 0,系统会停用重试。
标记: experimental
--experimental_scale_timeouts=<a double> 默认值:“1.0”
按此系数扩缩 Starlark 代码库规则中的所有超时时间。通过这种方式,可以在不更改源代码的情况下使外部代码库在速度低于规则作者的机器上运行。
标记:bazel_internal_configurationexperimental
--http_timeout_scaling=<a double> 默认值:“1.0”
按指定系数调整与 HTTP 下载相关的所有超时
标记: bazel_internal_configuration
--repository_cache=<a path> 默认值:请参阅说明
指定在提取外部代码库期间获取的已下载值的缓存位置。使用空字符串作为参数会请求停用缓存。
标记: bazel_internal_configuration
用于控制命令输出的选项:
--[no]async 默认值:“false”
如果为 true,则输出清理是异步进行的。此命令完成后,您可以安全地在同一客户端中执行新命令,即使删除操作可能会在后台继续进行。
标记: host_machine_resource_optimizations
--[no]expunge 默认值:“false”
如果为 true,则清理操作会移除此 bazel 实例的整个工作树(包括 bazel 创建的所有临时文件和 build 输出文件),并停止正在运行的 bazel 服务器。
标记: host_machine_resource_optimizations
--expunge_async
如果指定,清理将异步移除此 bazel 实例的整个工作树(包括 bazel 创建的所有临时文件和 build 输出文件),并停止正在运行的 bazel 服务器。此命令完成后,您可以安全地在同一客户端中执行新命令,即使删除操作可能会在后台继续进行。
扩展为:
  --expunge
  --async

标记: host_machine_resource_optimizations
如果为 true,则工作区中所有前缀为 symlink_prefix 的符号链接都将被删除。如果没有此标志,系统只会清理具有预定义后缀的符号链接。
标记: affects_outputs
影响 Bazel 强制执行有效 build 输入的严格程度的选项(规则定义、标志组合等):
--experimental_repository_hash_file=<a string> 默认值:“”
如果非空,请指定一个包含解析值的文件,应针对该值验证代码库目录哈希值
标记:affects_outputsexperimental
已累计 --experimental_verify_repository_rules=<a string> 次多次使用
如果要验证输出目录的哈希值的代码库规则列表,则要通过 --experimental_repo_hash_file 指定文件。
标记:affects_outputsexperimental
此选项会影响 Starlark 语言或 build 文件、.bzl 文件或 WORKSPACE 文件可访问的 build API 的语义。
--[no]experimental_allow_top_level_aspects_parameters 默认值:“true”
空操作
标记:no_opdeprecatedexperimental
与 Bzlmod 输出和语义相关的选项:
已累计 --allow_yanked_versions=<a string> 次多次使用
以 `<module1>@<version1>,<module2>@<version2>` 的形式指定模块版本,即使这些版本在来源的注册表中被声明了(如果它们不是来自 NonRegistryOverride),也会显示在已解析的依赖关系图中。否则,拉取版本将导致解析失败。您还可以使用 `BZLMOD_ALLOW_YANKED_VERSIONS` 环境变量定义允许的拖动版本。您可以使用关键字“all”停用此检查(不推荐)。
标记: loading_and_analysis
--check_bazel_compatibility=<error, warning or off> 默认值:“error”
检查 Bazel 模块的 Bazel 版本兼容性。有效值包括:“error”表示处理失败,“off”表示停用检查,“warning”表示检测到不匹配的情况时会显示警告。
标记: loading_and_analysis
--check_direct_dependencies=<off, warning or error> 默认值:“警告”
检查根模块中声明的直接“bazel_dep”依赖项是否与已解析的依赖关系图中的版本相同。有效值为 `off` 表示停用检查,`warning` 表示在检测到不匹配的情况时输出警告,或者是 `error`(用于将问题升级为解析失败)。
标记: loading_and_analysis
--[no]ignore_dev_dependency 默认值:“false”
如果为 true,Bazel 会忽略根模块的 MODULE.bazel 中声明为“dev_dependency”的“bazel_dep”和“use_extension”。请注意,无论此标志的值为何,只要不是根模块,MODULE.bazel 中就会始终忽略这些开发者依赖项。
标记: loading_and_analysis
--lockfile_mode=<off, update or error> 默认值:“off”
指定如何以及是否使用锁定文件。有效值包括:“update”表示使用 lockfile 并在发生变更时更新它;“error”表示使用 lockfile,但如果该文件不是最新状态,则会抛出错误;或者“off”表示既不从锁定文件读取数据,也不会向锁定文件写入数据。
标记: loading_and_analysis
已累计 --override_module=<an equals-separated mapping of module name to path> 次多次使用
替换采用 <模块名称>=<path> 形式的本地路径的模块。如果指定路径是绝对路径,系统将按原样使用该路径。如果指定路径是相对路径,则该路径相对于当前工作目录。如果指定路径以“%workspace%”开头,则该路径相对于工作区根目录,即“bazel info workspace”的输出
已累计 --registry=<a string> 次多次使用
指定用于查找 Bazel 模块依赖项的注册表。顺序很重要:系统会先在之前的注册表中查找模块,只有在之前的注册表中缺失模块时,才会回退到靠后的注册表。
标记: changes_inputs
影响日志记录的详细程度、格式或位置的选项:
--[no]experimental_record_metrics_for_all_mnemonics 默认值:“false”
默认情况下,操作类型的数量不得超过 20 种已执行操作数量最多的助记符。设置此选项会写入所有助记符的统计信息。
用于指定或更改不属于其他类别的 Bazel 命令的通用输入的选项:
--experimental_resolved_file_instead_of_workspace=<a string> 默认值:“”
如果为非空,则读取指定的已解析文件而不是 WORKSPACE 文件
标记: changes_inputs
远程缓存和执行选项:
--experimental_downloader_config=<a string> 默认值:请参阅说明
指定要用于配置远程下载程序的文件。此文件由几行组成,每个行都以指令(“allow”“block”或“rewrite”)开头,后跟主机名(分别用于“allow”和“block”)或两种格式,一种用于匹配,另一种用作替代网址,反向引用从“$1”开始。在这种情况下,系统可能会返回多个“rewrite”指令,供同一个网址提供,在这种情况下,系统会返回多个网址。
其他未分类的选项:
已累计 --override_repository=<an equals-separated mapping of repository name to path> 次多次使用
使用格式为 <repo name>=<path> 的本地路径替换代码库。如果指定路径是绝对路径,系统将按原样使用该路径。如果指定路径是相对路径,则该路径是相对于当前工作目录而言的。如果指定路径以“%workspace%”开头,则该路径相对于工作区根目录,即“bazel info workspace”的输出

配置选项

保修选项

继承 test 的所有选项。

出现在命令之前并由客户端解析的选项:
已累计 --distdir=<a path> 次多次使用
在访问网络以下载归档文件之前,可在其他位置搜索归档文件。
标记: bazel_internal_configuration
如果已设置,代码库缓存将在缓存命中时对文件进行硬链接,而不是复制。这是为了节省磁盘空间。
标记: bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id 默认值:“false”
如果为 true,请使用从代码库下载网址派生的字符串作为 canonical_id(如果未指定)。这会导致网址发生变化,进而重新下载,即使缓存中包含具有相同哈希值的下载内容。这可用于验证网址更改不会导致损坏的代码库被缓存遮盖。
标记:loading_and_analysisexperimental
--[no]experimental_repository_disable_download 默认值:“false”
如果设置此参数,则不允许下载外部代码库。
标记: experimental
--experimental_repository_downloader_retries=<an integer> 默认值:“0”
重新尝试下载错误的最大尝试次数。如果设置为 0,系统会停用重试。
标记: experimental
--experimental_scale_timeouts=<a double> 默认值:“1.0”
按此系数扩缩 Starlark 代码库规则中的所有超时时间。通过这种方式,可以在不更改源代码的情况下使外部代码库在速度低于规则作者的机器上运行。
标记:bazel_internal_configurationexperimental
--http_timeout_scaling=<a double> 默认值:“1.0”
按指定系数调整与 HTTP 下载相关的所有超时
标记: bazel_internal_configuration
--repository_cache=<a path> 默认值:请参阅说明
指定在提取外部代码库期间获取的已下载值的缓存位置。使用空字符串作为参数会请求停用缓存。
标记: bazel_internal_configuration
会影响 Bazel 强制执行有效 build 输入的严格程度的选项(规则定义、标志组合等):
--experimental_repository_hash_file=<a string> 默认值:“”
如果非空,请指定一个包含解析值的文件,应针对该值验证代码库目录哈希值
标记:affects_outputsexperimental
已累计 --experimental_verify_repository_rules=<a string> 次多次使用
如果要验证输出目录的哈希值的代码库规则列表,则要通过 --experimental_repo_hash_file 指定文件。
标记:affects_outputsexperimental
此选项会影响 Starlark 语言或 build 文件、.bzl 文件或 WORKSPACE 文件可访问的 build API 的语义。
--[no]experimental_allow_top_level_aspects_parameters 默认值:“true”
空操作
标记:no_opdeprecatedexperimental
与 Bzlmod 输出和语义相关的选项:
已累计 --allow_yanked_versions=<a string> 次多次使用
以 `<module1>@<version1>,<module2>@<version2>` 的形式指定模块版本,即使这些版本在来源的注册表中被声明了(如果它们不是来自 NonRegistryOverride),也会显示在已解析的依赖关系图中。否则,拉取版本将导致解析失败。您还可以使用 `BZLMOD_ALLOW_YANKED_VERSIONS` 环境变量定义允许的拖动版本。您可以使用关键字“all”停用此检查(不推荐)。
标记: loading_and_analysis
--check_bazel_compatibility=<error, warning or off> 默认值:“error”
检查 Bazel 模块的 Bazel 版本兼容性。有效值包括:“error”表示处理失败,“off”表示停用检查,“warning”表示检测到不匹配的情况时会显示警告。
标记: loading_and_analysis
--check_direct_dependencies=<off, warning or error> 默认值:“警告”
检查根模块中声明的直接“bazel_dep”依赖项是否与已解析的依赖关系图中的版本相同。有效值为 `off` 表示停用检查,`warning` 表示在检测到不匹配的情况时输出警告,或者是 `error`(用于将问题升级为解析失败)。
标记: loading_and_analysis
--[no]ignore_dev_dependency 默认值:“false”
如果为 true,Bazel 会忽略根模块的 MODULE.bazel 中声明为“dev_dependency”的“bazel_dep”和“use_extension”。请注意,无论此标志的值为何,只要不是根模块,MODULE.bazel 中就会始终忽略这些开发者依赖项。
标记: loading_and_analysis
--lockfile_mode=<off, update or error> 默认值:“off”
指定如何以及是否使用锁定文件。有效值包括:“update”表示使用 lockfile 并在发生变更时更新它;“error”表示使用 lockfile,但如果该文件不是最新状态,则会抛出错误;或者“off”表示既不从锁定文件读取数据,也不会向锁定文件写入数据。
标记: loading_and_analysis
已累计 --override_module=<an equals-separated mapping of module name to path> 次多次使用
替换采用 <模块名称>=<path> 形式的本地路径的模块。如果指定路径是绝对路径,系统将按原样使用该路径。如果指定路径是相对路径,则该路径相对于当前工作目录。如果指定路径以“%workspace%”开头,则该路径相对于工作区根目录,即“bazel info workspace”的输出
已累计 --registry=<a string> 次多次使用
指定用于查找 Bazel 模块依赖项的注册表。顺序很重要:系统会先在之前的注册表中查找模块,只有在之前的注册表中缺失模块时,才会回退到靠后的注册表。
标记: changes_inputs
影响日志记录的详细程度、格式或位置的选项:
--[no]experimental_record_metrics_for_all_mnemonics 默认值:“false”
默认情况下,操作类型的数量不得超过 20 种已执行操作数量最多的助记符。设置此选项会写入所有助记符的统计信息。
用于指定或更改不属于其他类别的 Bazel 命令的通用输入的选项:
--experimental_resolved_file_instead_of_workspace=<a string> 默认值:“”
如果为非空,则读取指定的已解析文件而不是 WORKSPACE 文件
标记: changes_inputs
远程缓存和执行选项:
--experimental_downloader_config=<a string> 默认值:请参阅说明
指定要用于配置远程下载程序的文件。此文件由几行组成,每个行都以指令(“allow”“block”或“rewrite”)开头,后跟主机名(分别用于“allow”和“block”)或两种格式,一种用于匹配,另一种用作替代网址,反向引用从“$1”开始。在这种情况下,系统可能会返回多个“rewrite”指令,供同一个网址提供,在这种情况下,系统会返回多个网址。
其他未分类的选项:
已累计 --override_repository=<an equals-separated mapping of repository name to path> 次多次使用
使用格式为 <repo name>=<path> 的本地路径替换代码库。如果指定路径是绝对路径,系统将按原样使用该路径。如果指定路径是相对路径,则该路径是相对于当前工作目录而言的。如果指定路径以“%workspace%”开头,则该路径相对于工作区根目录,即“bazel info workspace”的输出

Cquery 选项

继承 test 的所有选项。

出现在命令之前并由客户端解析的选项:
已累计 --distdir=<a path> 次多次使用
在访问网络以下载归档文件之前,可在其他位置搜索归档文件。
标记: bazel_internal_configuration
如果已设置,代码库缓存将在缓存命中时对文件进行硬链接,而不是复制。这是为了节省磁盘空间。
标记: bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id 默认值:“false”
如果为 true,请使用从代码库下载网址派生的字符串作为 canonical_id(如果未指定)。这会导致网址发生变化,进而重新下载,即使缓存中包含具有相同哈希值的下载内容。这可用于验证网址更改不会导致损坏的代码库被缓存遮盖。
标记:loading_and_analysisexperimental
--[no]experimental_repository_disable_download 默认值:“false”
如果设置此参数,则不允许下载外部代码库。
标记: experimental
--experimental_repository_downloader_retries=<an integer> 默认值:“0”
重新尝试下载错误的最大尝试次数。如果设置为 0,系统会停用重试。
标记: experimental
--experimental_scale_timeouts=<a double> 默认值:“1.0”
按此系数扩缩 Starlark 代码库规则中的所有超时时间。通过这种方式,可以在不更改源代码的情况下使外部代码库在速度低于规则作者的机器上运行。
标记:bazel_internal_configurationexperimental
--http_timeout_scaling=<a double> 默认值:“1.0”
按指定系数调整与 HTTP 下载相关的所有超时
标记: bazel_internal_configuration
--repository_cache=<a path> 默认值:请参阅说明
指定在提取外部代码库期间获取的已下载值的缓存位置。使用空字符串作为参数会请求停用缓存。
标记: bazel_internal_configuration
会影响 Bazel 强制执行有效 build 输入的严格程度的选项(规则定义、标志组合等):
--experimental_repository_hash_file=<a string> 默认值:“”
如果非空,请指定一个包含解析值的文件,应针对该值验证代码库目录哈希值
标记:affects_outputsexperimental
已累计 --experimental_verify_repository_rules=<a string> 次多次使用
如果要验证输出目录的哈希值的代码库规则列表,则要通过 --experimental_repo_hash_file 指定文件。
标记:affects_outputsexperimental
此选项会影响 Starlark 语言或 build 文件、.bzl 文件或 WORKSPACE 文件可访问的 build API 的语义。
--[no]experimental_allow_top_level_aspects_parameters 默认值:“true”
空操作
标记:no_opdeprecatedexperimental
与查询输出和语义相关的选项:
--aspect_deps=<off, conservative or precise> 默认值:“conservative”
当输出格式为 {xml,proto,record} 之一时,如何解析切面依赖项。“off”表示不解析任何切面依赖项,“保守”(默认值)表示添加所有已声明的切面依赖关系,而不管它们是否被赋予直接依赖关系的规则类为直接依赖关系,“precise”表示仅添加在直接依赖关系规则类下可能处于活动状态的那些切面。请注意,精确模式需要加载其他软件包来评估单个目标,因此该模式比其他模式慢。另请注意,即使是精确模式也不是完全精确的:是否要计算某个切面的决策是在分析阶段决定的,而不是在“bazel 查询”期间运行。
标记: build_file_semantics
--[no]consistent_labels 默认值:“false”
启用后,每个查询命令都会发出标签,就像通过应用于 <code>Label</code> 实例的 Starlark <code>str</code> 函数发出一样。这对于需要匹配不同查询命令的输出和/或由规则发出的标签生成的工具非常有用。如果未启用,输出格式设置工具可以自由发出明显的仓库名称(相对于主仓库),以使输出更具可读性。
标记: terminal_output
--[no]graph:factored 默认值:“true”
如果为 true,则该图将发出“因式分解”处理,即拓扑相等的节点将合并在一起,其标签将串联起来。此选项仅适用于 --output=graph。
标记: terminal_output
--graph:node_limit=<an integer> 默认值:“512”
输出中图表节点的标签字符串的最大长度。较长的标签将被截断;-1 表示不会被截断。此选项仅适用于 --output=graph。
标记: terminal_output
--[no]implicit_deps 默认值:“true”
启用后,隐式依赖项将包含在执行查询的依赖关系图中。隐式依赖项是指未在 BUILD 文件中明确指定但由 bazel 添加的依赖项。对于 cquery,此选项用于控制过滤已解析的工具链。
标记: build_file_semantics
--[no]include_aspects 默认值:“true”
aquery、cquery:是否在输出中包含切面生成的操作。query: no-op(始终遵循切面)。
标记: terminal_output
--[no]incompatible_display_source_file_location 默认值:“true”
默认情况下为 true,显示源文件的目标。如果为 true,则显示位置输出中源文件第 1 行的位置。此标志仅用于迁移目的。
标记:terminal_outputincompatible_change
--[no]incompatible_package_group_includes_double_slash 默认值:“true”
如果启用此选项,则输出 package_group 的 `packages` 属性时,前导 `//` 将不会省略。
标记:terminal_outputincompatible_change
--[no]infer_universe_scope 默认值:“false”
如果您设置此参数,并且未设置 --universe_scope,则系统会将“--universe_scope”值推断为查询表达式中唯一目标模式的列表。请注意,针对使用 Universe 范围函数(例如 `allrdeps`)的查询表达式推断出的 --universe_scope 值可能不是您想要的值,因此除非您知道自己正在执行的操作,否则不应使用此选项。如需了解详情和示例,请参阅 https://bazel.build/reference/query#sky-query。如果设置了 --universe_scope,则会忽略此选项的值。注意:此选项仅适用于“query”(即不适用于“cquery”)。
标记:loading_and_analysis
--[no]line_terminator_null 默认值:“false”
每种格式是否以 \0(而非换行符)结束。
标记: terminal_output
--[no]nodep_deps 默认值:“true”
如果启用,则“nodep”属性中的依赖项将包含在执行查询的依赖关系图中。“nodep”属性的一个常见示例是“visibility”。运行并解析“info build-language”的输出,即可了解 build 语言中的所有“nodep”属性。
标记: build_file_semantics
--output=<a string> 默认值:“label”
应以哪种格式输出 cquery 结果。cquery 允许使用的值包括:label、label_Kind、textproto、transitions、proto、jsonproto。如果您选择“transitions”,还必须指定 --transitions=(lite|full) 选项。
标记: terminal_output
--[no]proto:default_values 默认值:“true”
如果为 true,则会包含 BUILD 文件中未明确指定值的属性;否则,会忽略这些属性。此选项适用于 --output=proto
标记:terminal_output
--[no]proto:definition_stack 默认值:“false”
填充 Definition_stack proto 字段,在定义规则的类时,为每个规则实例记录 Starlark 调用堆栈。
标记: terminal_output
--[no]proto:flatten_selects 默认值:“true”
启用后,通过 select() 创建的可配置属性将展平。对于列表类型,扁平化表示形式是一个列表,包含选定映射的每个值一次。标量类型会展平为 null。
标记: build_file_semantics
--[no]proto:include_configurations 默认值:“true”
如果启用,proto 输出将包含有关配置的信息。停用后,cquery proto 输出格式将类似于查询输出格式。
标记: affects_outputs
--[no]proto:include_synthetic_attribute_hash 默认值:“false”
是否计算和填充 $internal_attr_hash 属性。
标记: terminal_output
--[no]proto:instantiation_stack 默认值:“false”
填充每条规则的实例化调用堆栈。请注意,这需要有堆栈存在
标记:terminal_output
--[no]proto:locations 默认值:“true”
是否在 proto 输出中输出位置信息。
标记: terminal_output
--proto:output_rule_attrs=<comma-separated list of options> 默认值:“all”
要包含在输出中的属性列表(以英文逗号分隔)。默认值为所有属性。设置为空字符串,不输出任何属性。此选项适用于 --output=proto。
标记: terminal_output
--[no]proto:rule_inputs_and_outputs 默认值:“true”
是否填充 rules_input 和 rules_output 字段。
标记: terminal_output
--query_file=<a string> 默认值:“”
如果设置此参数,查询将从此处指定的文件中(而不是在命令行中)读取查询。在此处指定文件以及通过命令行查询是错误的。
标记: changes_inputs
--[no]relative_locations 默认值:“false”
如果为 true,则 BUILD 文件在 xml 和 proto 输出中的位置将是相对的。默认情况下,位置输出是绝对路径,在不同机器中不一致。您可以将此选项设置为 true,以便在不同机器上获得一致的结果。
标记: terminal_output
--show_config_fragments=<off, direct or transitive> 默认值:“off”
显示规则所需的配置片段及其传递依赖项。这对于评估可以对配置的目标图表进行修剪的程度非常有用。
标记: affects_outputs
--starlark:expr=<a string> 默认值:“”
一个 Starlark 表达式,用于在 cquery 的 --output=starlark 模式下设置每个已配置目标的格式。配置的目标会绑定到“target”。如果 --starlark:expr 和 --starlark:file 都未指定,此选项将默认为“str(target.label)”。同时指定 --starlark:expr 和 --starlark:file 是错误的。
标记: terminal_output
--starlark:file=<a string> 默认值:“”
文件的名称,该文件定义了一个名为“format”的 Starlark 函数,该函数具有一个参数,该函数会应用于每个已配置的目标,以将其格式化为字符串。同时指定 --starlark:expr 和 --starlark:file 是错误的。如需了解详情,请参阅 --output=starlark 帮助。
标记: terminal_output
--[no]tool_deps 默认值:“true”
查询:如果停用,对“主机配置”或“执行”目标的依赖关系将不会包含在执行查询的依赖关系图中。“主机配置”依赖项边缘(例如从任何“proto_library”规则到协议编译器的依赖项边缘)通常指向在构建期间执行的工具,而不是同一“目标”程序的一部分。 Cquery:如果停用,则会从发现此已配置目标的顶级目标中过滤掉所有跨主机或执行转换的已配置目标。这意味着,如果顶级目标位于目标配置中,则将仅返回同样位于目标配置中的已配置目标。如果顶级目标位于主机配置中,则系统将仅返回主机配置的目标。此选项不会排除已解析的工具链。
标记: build_file_semantics
--transitions=<full, lite or none> 默认值:“none”
cquery 输出转换信息的格式。
标记: affects_outputs
--universe_scope=<comma-separated list of options> 默认值:“”
一组以英文逗号分隔的目标模式(加法和减法)。此查询可以在由指定目标的传递闭合定义的宇宙中执行。此选项用于 query 和 cquery 命令。 对于 cquery,此选项的输入是构建所有答案的目标,因此此选项可能会影响配置和转换。如果未指定此选项,系统会假定顶级目标是通过查询表达式解析的目标。注意:对于 cquery,如果无法使用顶级选项构建从查询表达式解析的目标,则不指定此选项可能会导致构建中断。
标记: loading_and_analysis
与 Bzlmod 输出和语义相关的选项:
已累计 --allow_yanked_versions=<a string> 次多次使用
以 `<module1>@<version1>,<module2>@<version2>` 的形式指定模块版本,即使这些版本在来源的注册表中被声明了(如果它们不是来自 NonRegistryOverride),也会显示在已解析的依赖关系图中。否则,拉取版本将导致解析失败。您还可以使用 `BZLMOD_ALLOW_YANKED_VERSIONS` 环境变量定义允许的拖动版本。您可以使用关键字“all”停用此检查(不推荐)。
标记: loading_and_analysis
--check_bazel_compatibility=<error, warning or off> 默认值:“error”
检查 Bazel 模块的 Bazel 版本兼容性。有效值包括:“error”表示处理失败,“off”表示停用检查,“warning”表示检测到不匹配的情况时会显示警告。
标记: loading_and_analysis
--check_direct_dependencies=<off, warning or error> 默认值:“警告”
检查根模块中声明的直接“bazel_dep”依赖项是否与已解析的依赖关系图中的版本相同。有效值为 `off` 表示停用检查,`warning` 表示在检测到不匹配的情况时输出警告,或者是 `error`(用于将问题升级为解析失败)。
标记: loading_and_analysis
--[no]ignore_dev_dependency 默认值:“false”
如果为 true,Bazel 会忽略根模块的 MODULE.bazel 中声明为“dev_dependency”的“bazel_dep”和“use_extension”。请注意,无论此标志的值为何,只要不是根模块,MODULE.bazel 中就会始终忽略这些开发者依赖项。
标记: loading_and_analysis
--lockfile_mode=<off, update or error> 默认值:“off”
指定如何以及是否使用锁定文件。有效值包括:“update”表示使用 lockfile 并在发生变更时更新它;“error”表示使用 lockfile,但如果该文件不是最新状态,则会抛出错误;或者“off”表示既不从锁定文件读取数据,也不会向锁定文件写入数据。
标记: loading_and_analysis
已累计 --override_module=<an equals-separated mapping of module name to path> 次多次使用
替换采用 <模块名称>=<path> 形式的本地路径的模块。如果指定路径是绝对路径,系统将按原样使用该路径。如果指定路径是相对路径,则该路径相对于当前工作目录。如果指定路径以“%workspace%”开头,则该路径相对于工作区根目录,即“bazel info workspace”的输出
已累计 --registry=<a string> 次多次使用
指定用于查找 Bazel 模块依赖项的注册表。顺序很重要:系统会先在之前的注册表中查找模块,只有在之前的注册表中缺失模块时,才会回退到靠后的注册表。
标记: changes_inputs
影响日志记录的详细程度、格式或位置的选项:
--[no]experimental_record_metrics_for_all_mnemonics 默认值:“false”
默认情况下,操作类型的数量不得超过 20 种已执行操作数量最多的助记符。设置此选项会写入所有助记符的统计信息。
用于指定或更改不属于其他类别的 Bazel 命令的通用输入的选项:
--experimental_resolved_file_instead_of_workspace=<a string> 默认值:“”
如果为非空,则读取指定的已解析文件而不是 WORKSPACE 文件
标记: changes_inputs
远程缓存和执行选项:
--experimental_downloader_config=<a string> 默认值:请参阅说明
指定要用于配置远程下载程序的文件。此文件由几行组成,每个行都以指令(“allow”“block”或“rewrite”)开头,后跟主机名(分别用于“allow”和“block”)或两种格式,一种用于匹配,另一种用作替代网址,反向引用从“$1”开始。在这种情况下,系统可能会返回多个“rewrite”指令,供同一个网址提供,在这种情况下,系统会返回多个网址。
其他未分类的选项:
已累计 --override_repository=<an equals-separated mapping of repository name to path> 次多次使用
使用格式为 <repo name>=<path> 的本地路径替换代码库。如果指定路径是绝对路径,系统将按原样使用该路径。如果指定路径是相对路径,则该路径是相对于当前工作目录而言的。如果指定路径以“%workspace%”开头,则该路径相对于工作区根目录,即“bazel info workspace”的输出
用于控制构建执行的选项:
是否通过直接文件系统调用来创建符号链接树
标记:loading_and_analysisexecutionexperimental
--[no]experimental_remotable_source_manifests 默认值:“false”
是否将源清单操作设为远程
标记:loading_and_analysisexecutionexperimental
--[no]experimental_split_coverage_postprocessing 默认值:“false”
如果为 true,Bazel 会运行覆盖率后处理,以便在新生成中进行测试。
标记: execution
--[no]experimental_strict_fileset_output 默认值:“false”
如果启用此选项,文件集会将所有输出工件视为常规文件。它们不会遍历目录,也不会对符号链接敏感。
标记: execution
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...> 默认值:“”
根据操作助记符在操作的执行信息中添加或移除键。仅适用于支持执行信息的操作。许多常用操作都支持执行信息,例如 Genrule、CppCompile、Javac、StarlarkAction、TestRunner。在指定多个值时,顺序很重要,因为多个正则表达式可能适用于同一助记符。 语法:“regex=[+-]key,regex=[+-]key,...”。 示例: “.*=+x,.*=-y,.*=+z”会在所有操作的执行信息中添加“x”和“z”,并从中移除“y”。“Genrule=+如果需要-x”会将“require-x”添加到所有 Genrule 操作的执行信息中。'(?!Genrule).*=- requires-x' 从所有非 Genrule 操作的执行信息中移除“need-x”。
标记:executionaffects_outputsloading_and_analysis
--persistent_android_dex_desugar
使用 worker 启用永久性 Android dex 和脱糖操作。
会展开为:
  --internal_persistent_android_dex_desugar
  --strategy=Desugar=worker
  --strategy=DexBuilder=worker

标记:host_machine_resource_optimizationsexecution
--persistent_android_resource_processor
使用 worker 启用永久性 Android 资源处理器。
展开为:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
--strategy=Aapt2Optimize=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=workerhost_machine_resource_optimizationsexecution
--persistent_multiplex_android_dex_desugar
使用 worker 启用永久性多路复用 Android dex 和脱糖操作。
扩展为:
  --persistent_android_dex_desugar
  --internal_persistent_multiplex_android_dex_desugar

标记:host_machine_resource_optimizationsexecution
--persistent_multiplex_android_resource_processor
使用工作器启用永久性多路复用 Android 资源处理器。
展开为:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workershost_machine_resource_optimizationsexecution
--persistent_multiplex_android_tools
启用持久性和多路复用 Android 工具(dex 处理、脱糖和资源处理)。
展开为:
  --internal_persistent_multiplex_busybox_tools
  --persistent_multiplex_android_resource_processor
  --persistent_multiplex_android_dex_desugar

标记:host_machine_resource_optimizationsexecution
用于配置用于执行操作的工具链的选项:
--android_compiler=<a string> 默认值:请参阅说明
Android 目标编译器。
标记:affects_outputsloading_and_analysisloses_incremental_state
--android_crosstool_top=<a build target label> 默认值:“//external:android/crosstool”
用于 Android build 的 C++ 编译器的位置。
标记:affects_outputschanges_inputsloading_and_analysisloses_incremental_state
--android_grte_top=<a label> 默认值:请参阅说明
Android 目标 grte_top。
标记:changes_inputsloading_and_analysisloses_incremental_state
--android_manifest_merger=<legacy, android or force_android> 默认值:“android”
选择要用于 android_binary 规则的清单合并程序。用于帮助从旧版合并程序过渡到 Android 清单合并程序的标志。
标记:affects_outputsloading_and_analysisloses_incremental_state
--android_platforms=<a build target label> 默认值:“”
设置 android_binary 目标使用的平台。如果指定了多个平台,则二进制文件是一个胖 APK,其中包含每个指定目标平台的原生二进制文件。
标记:changes_inputsloading_and_analysisloses_incremental_state
--android_sdk=<a build target label> 默认值:“@bazel_tools//tools/android:sdk”
指定用于构建 Android 应用的 Android SDK/平台。
标记:changes_inputsloading_and_analysisloses_incremental_state
--apple_compiler=<a string> 默认值:请参阅说明
Apple 目标编译器。用于选择工具链的变体(例如 xcode-beta)。
标记:affects_outputsloading_and_analysisloses_incremental_state
--apple_crosstool_top=<a build target label> 默认值:“@bazel_tools//tools/cpp:toolchain”
要在 Apple 和 Objc 规则中使用的交叉工具软件包的标签及其依赖项。
标记:loses_incremental_statechanges_inputs
--apple_grte_top=<a build target label> 默认值:请参阅说明
Apple 目标 grte_top。
标记:changes_inputsloading_and_analysisloses_incremental_state
--cc_output_directory_tag=<a string> 默认值:“”
指定要添加到配置目录的后缀。
标记:affects_outputsexplicit_in_output_path
--compiler=<a string> 默认值:请参阅说明
用于编译目标的 C++ 编译器。
标记:loading_and_analysisexecution
--coverage_output_generator=<a build target label> 默认值:“@bazel_tools//tools/test:lcov_merger”
用于对原始覆盖率报告进行后处理的二进制文件的位置。目前,此值必须是包含单个文件(二进制文件)的文件组。默认值为“//tools/test:lcov_merger”。
标记:changes_inputsaffects_outputsloading_and_analysis
--coverage_report_generator=<a build target label> 默认值:“@bazel_tools//tools/test:coverage_report_generator”
用于生成覆盖率报告的二进制文件的位置。目前,此值必须是包含单个文件(二进制文件)的文件组。默认值为“//tools/test:coverage_report_generator”。
标记:changes_inputsaffects_outputsloading_and_analysis
--coverage_support=<a build target label> 默认值:“@bazel_tools//tools/test:coverage_support”
每个收集代码覆盖率的测试操作输入到的地方都需要支持文件的位置。默认值为“//tools/test:coverage_support”。
标记:changes_inputsaffects_outputsloading_and_analysis
--crosstool_top=<a build target label> 默认值:“@bazel_tools//tools/cpp:toolchain”
用于编译 C++ 代码的 crosstool 软件包标签。
标记:loading_and_analysischanges_inputsaffects_outputs
--custom_malloc=<a build target label> 默认值:请参阅说明
指定自定义 malloc 实现。此设置会覆盖构建规则中的 malloc 属性。
标记:changes_inputsaffects_outputs
已累计 --experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment> 次多次使用
以英文逗号分隔的正则表达式列表,每个表达式可以选择带有 -(否定表达式)前缀,并将 (=) 赋值给一系列以英文逗号分隔的约束值目标。如果目标没有与负表达式匹配,且至少有一个正表达式,则系统将执行其工具链解析,就像其已将约束值声明为执行约束条件一样。示例://demo,-test=@platforms//cpus:x86_64 会将“x86_64”添加到 //demo 下的任何目标(名称中包含“test”的目标除外)。
标记: loading_and_analysis
--[no]experimental_enable_objc_cc_deps 默认值:“true”
允许 objc_* 规则依赖于 cc_library,并使得针对 --ios_multi_cpu 中的任何值,在构建任何 objc 依赖项时将 --cpu 设置为“ios_<--ios_cpu>”。
标记:loading_and_analysisincompatible_change
--[no]experimental_include_xcode_execution_requirements 默认值:“false”
如果已设置,则向每项 Xcode 操作添加“require-xcode:{version}”的执行要求。如果 Xcode 版本带有带连字符的标签,请同时添加“required-xcode-label:{version_label}”执行要求。
标记:loses_incremental_stateloading_and_analysisexecution
--[no]experimental_prefer_mutual_xcode 默认值:“true”
如果为 true,请使用可在本地和远程访问的最新 Xcode。如果为 false,或者没有相互可用的版本,请使用通过 xcode-select 选择的本地 Xcode 版本。
标记: loses_incremental_state
已累计 --extra_execution_platforms=<comma-separated list of options> 次多次使用
可用作执行操作的执行平台的平台。平台可以按确切目标指定,也可以指定为目标模式。系统会先考虑这些平台,然后再考虑由 register_execution_platforms() 在 WORKSPACE 文件中声明的平台。
标记:execution
已累计 --extra_toolchains=<comma-separated list of options> 次多次使用
在工具链解析期间要考虑的工具链规则。工具链可以按确切目标指定,也可以指定为目标模式。系统会先考虑这些工具链,然后再考虑由 register_toolchains() 在 WORKSPACE 文件中声明的那些工具链。
标记:affects_outputschanges_inputsloading_and_analysis
--grte_top=<a label> 默认值:请参阅说明
已签入的 libc 库的标签。默认值由交叉工具工具链选择,您几乎永远不需要替换它。
标记:action_command_linesaffects_outputs
--host_compiler=<a string> 默认值:请参阅说明
用于主机编译的 C++ 编译器。如果未设置 --host_crosstool_top,则忽略该标志。
标记:loading_and_analysisexecution
--host_crosstool_top=<a build target label> 默认值:请参阅说明
默认情况下,--crosstool_top 和 --compiler 选项也会用于主机配置。如果提供此标志,Bazel 会针对给定 crosstool_top 使用默认 libc 和编译器。
标记:loading_and_analysischanges_inputsaffects_outputs
--host_grte_top=<a label> 默认值:请参阅说明
如果指定,此设置会覆盖主机配置的 libc 顶级目录 (--grte_top)。
标记:action_command_linesaffects_outputs
--host_platform=<a build target label> 默认值:“”
描述主机系统的平台规则标签。
标记:affects_outputschanges_inputsloading_and_analysis
--[no]incompatible_disable_expand_if_all_available_in_flag_set 默认值:“true”
如果为 true,Bazel 将不允许在 flag_sets 中指定 expand_if_all_available(如需了解迁移说明,请参阅 https://github.com/bazelbuild/bazel/issues/7008)。
标记:loading_and_analysisincompatible_change
--[no]incompatible_dont_enable_host_nonhost_crosstool_features 默认值:“true”
如果为 true,Bazel 不会在 C++ 工具链中启用“host”和“nonhost”功能(如需了解详情,请参阅 https://github.com/bazelbuild/bazel/issues/7407)。
标记:loading_and_analysisincompatible_change
--[no]incompatible_enable_android_toolchain_resolution 默认值:“false”
使用工具链解析选择 Android SDK for Android 规则(Starlark 和原生)
标记:loading_and_analysisincompatible_change
--[no]incompatible_enable_apple_toolchain_resolution 默认值:“false”
使用工具链解析选择 Apple SDK for Apple 规则(Starlark 和原生)
标记:loading_and_analysisincompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone 默认值:“true”
如果为 true,Bazel 不会将 C++ 链接操作命令行重复用于 lto 索引命令行(如需了解详情,请参阅 https://github.com/bazelbuild/bazel/issues/6791)。
标记:loading_and_analysisincompatible_change
--[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain 默认值:“true”
如果为 true,则设置 cc_toolchain.cpu 和 cc_toolchain.compiler 属性后,Bazel 会发出错误提示(有关迁移说明,请参阅 https://github.com/bazelbuild/bazel/issues/7075)。
标记:loading_and_analysisincompatible_change
--[no]incompatible_remove_legacy_whole_archive 默认值:“true”
如果为 true,则默认情况下,Bazel 不会将库依赖项链接到整个归档(如需了解迁移说明,请参阅 https://github.com/bazelbuild/bazel/issues/7362)。
标记:loading_and_analysisincompatible_change
--[no]incompatible_require_ctx_in_configure_features 默认值:“true”
如果为 true,则 Bazel 将需要在 cc_common.configure_features 中请求“时长”参数(如需了解详情,请参阅 https://github.com/bazelbuild/bazel/issues/7793)。
标记:loading_and_analysisincompatible_change
--[no]interface_shared_objects 默认值:“true”
如果工具链支持,请使用接口共享对象。目前,所有 ELF 工具链都支持此设置。
标记:loading_and_analysisaffects_outputsaffects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> 默认值:请参阅说明
指定用于构建 iOS 应用的 iOS SDK 版本。如果未指定,则使用“xcode_version”中的默认 iOS SDK 版本。
标记: loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> 默认值:请参阅说明
指定用于构建 macOS 应用的 macOS SDK 版本。如果未指定,则使用“xcode_version”中的默认 macOS SDK 版本。
标记: loses_incremental_state
--minimum_os_version=<a string> 默认值:请参阅说明
编译的目标最低操作系统版本。
标记:loading_and_analysisaffects_outputs
--platform_mappings=<a relative path> 默认值:“”
映射文件的位置,用于说明在未设置平台时应使用哪个平台,或在平台已存在时要设置哪些标志。必须相对于主工作区根目录。默认为“platform_mappings”(位于工作区根目录正下方的文件)。
标记:affects_outputschanges_inputsloading_and_analysis
--platforms=<a build target label> 默认值:“”
用于描述当前命令的目标平台的平台规则标签。
标记:affects_outputschanges_inputsloading_and_analysis
--python2_path=<a string> 默认值:请参阅说明
已废弃,空操作。已被“--incompatible_use_python_toolchains”停用。
标记:no_opdeprecated
--python3_path=<a string> 默认值:请参阅说明
已废弃,空操作。已被“--incompatible_use_python_toolchains”停用。
标记:no_opdeprecated
--python_path=<a string> 默认值:请参阅说明
为在目标平台上运行 Python 目标而调用的 Python 解释器的绝对路径。已弃用;已由 --incompatible_use_python_toolchains 停用。
标记:loading_and_analysisaffects_outputs
--python_top=<a build target label> 默认值:请参阅说明
py_runtime 的标签,表示为在目标平台上运行 Python 目标而调用的 Python 解释器。已弃用;已由 --incompatible_use_python_toolchains 停用。
标记:loading_and_analysisaffects_outputs
--target_platform_fallback=<a build target label> 默认值:“@local_config_platform//:host”
未设置目标平台且没有与当前标志集匹配的平台映射时应使用的平台规则标签。
标记:affects_outputschanges_inputsloading_and_analysis
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> 默认值:请参阅说明
指定用于构建 tvOS 应用的 tvOS SDK 版本。如果未指定,则使用“xcode_version”中的默认 tvOS SDK 版本。
标记: loses_incremental_state
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> 默认值:请参阅说明
指定用于构建 watchOS 应用的 watchOS SDK 版本。如果未指定,则使用“xcode_version”中的默认 watchOS SDK 版本。
标记: loses_incremental_state
--xcode_version=<a string> 默认值:请参阅说明
如果指定,则将给定版本的 Xcode 用于相关构建操作。如果未指定,则使用 Xcode 的执行程序默认版本。
标记: loses_incremental_state
--xcode_version_config=<a build target label> 默认值:“@bazel_tools//tools/cpp:host_xcodes”
xcode_config 规则的标签,用于在 build 配置中选择 Xcode 版本。
标记:loses_incremental_stateloading_and_analysis
用于控制命令输出的选项:
--[no]apple_enable_auto_dsym_dbg 默认值:“false”
是否强制启用为 dbg build 生成调试符号 (.dSYM) 文件的功能。
标记:affects_outputsaction_command_lines
--[no]apple_generate_dsym 默认值:“false”
是否生成调试符号 (.dSYM) 文件。
标记:affects_outputsaction_command_lines
如果为 true,则为所有目标构建 runfiles 符号链接林。如果为 false,请尽可能只写入清单。
标记: affects_outputs
--[no]build_runfile_manifests 默认值:“true”
如果为 true,则为所有目标编写 runfile 清单。如果为 false,请忽略它们。如果值为 false,本地测试将无法运行。
标记: affects_outputs
--[no]build_test_dwp 默认值:“false”
启用后,在以静态方式构建 C++ 测试时以及在 Fission 处打开时,系统也会自动构建测试二进制文件的 .dwp 文件。
标记:loading_and_analysisaffects_outputs
--cc_proto_library_header_suffixes=<comma-separated list of options> 默认值:“.pb.h”
设置 cc_proto_library 创建的头文件的前缀。
标记:affects_outputsloading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated list of options> 默认值:“.pb.cc”
设置 cc_proto_library 创建的源文件的前缀。
标记:affects_outputsloading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info 默认值:“false”
针对 proto_library 中的备用 Java API 版本运行额外操作。
标记:affects_outputsloading_and_analysisexperimental
--[no]experimental_proto_extra_actions 默认值:“false”
针对 proto_library 中的备用 Java API 版本运行额外操作。
标记:affects_outputsloading_and_analysisexperimental
--[no]experimental_save_feature_state 默认值:“false”
将启用和已请求功能的状态保存为编译的输出。
标记:affects_outputsexperimental
--fission=<a set of compilation modes> 默认值:“no”
指定哪些编译模式对 C++ 编译和链接使用断点。可以是 {'fastbuild', 'dbg', 'opt'} 的任意组合,也可以是特殊值:'yes'(用于启用所有模式)和 'no'(用于停用所有模式)。
标记:loading_and_analysisaction_command_linesaffects_outputs
--[no]incompatible_always_include_files_in_data 默认值:“true”
如果为 true,原生规则会将数据依赖项的 <code>DefaultInfo.files</code> 添加到其 runfile 中,这与 Starlark 规则的建议行为一致 (https://bazel.build/extending/rules#runfiles_features_to_avoid)。
标记:affects_outputsincompatible_change
--[no]legacy_external_runfiles 默认值:“true”
如果为 true,则为 .runfiles/wsname/external/repo(以及 .runfiles/repo)下的外部代码库构建 runfiles 符号链接林。
标记: affects_outputs
--[no]objc_generate_linkmap 默认值:“false”
指定是否生成链接映射文件。
标记: affects_outputs
--[no]save_temps 默认值:“false”
如果设置此参数,系统会保存 gcc 的临时输出。其中包括 .s 文件(编译器代码)、.i 文件(经过预处理的 C)和 .ii 文件(经过预处理的 C++)。
标记: affects_outputs
可让用户配置预期输出的选项,以影响预期输出的值,而非影响其存在性:
已累计 --action_env=<a 'name=value' assignment with an optional value part> 次多次使用
指定可用于具有目标配置的操作的一组环境变量。变量可以按名称指定(在这种情况下,值将从调用环境中获取),也可以通过 name=value 对(其值独立于调用环境设置)指定。此选项可以多次使用;对于同一变量提供的选项,系统会汇总最后胜出的选项。
标记: action_command_lines
--android_cpu=<a string> 默认值:“armeabi-v7a”
Android 目标 CPU。
标记:affects_outputsloading_and_analysisloses_incremental_state
--[no]android_databinding_use_androidx 默认值:“false”
生成与 AndroidX 兼容的数据绑定文件。这仅适用于数据绑定 v2。
标记:affects_outputsloading_and_analysisloses_incremental_stateexperimental
--[no]android_databinding_use_v3_4_args 默认值:“false”
使用带有 3.4.0 参数的 Android 数据绑定 v2
标记:affects_outputsloading_and_analysisloses_incremental_stateexperimental
--android_dynamic_mode=<off, default or fully> 默认值:“off”
确定当 cc_binary 未明确创建共享库时,是否要动态关联 Android 规则的 C++ 依赖项。“default”表示 bazel 将选择是否动态链接。“full”表示将动态地链接所有库。“off”表示所有库都将在基本静态模式下链接。
标记:affects_outputsloading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency> 默认值:“按字母顺序排列”
设置传递给 Android 二进制文件的清单合并程序的清单的顺序。ALPHABETIAL 表示清单按相对于 execroot 的路径进行排序。ALPHABETIVE_BY_CONFIGURATION 表示清单按相对于输出目录中配置目录的路径进行排序。DEPENDENCY 表示清单排序,每个库的清单排在其依赖项的清单之前。
标记:action_command_linesexecution
--[no]android_resource_shrinking 默认值:“false”
为使用 ProGuard 的 android_binary APK 启用资源缩减。
标记:affects_outputsloading_and_analysis
已累计 --apple_bitcode=<'mode' or 'platform=mode', where 'mode' is none, embedded_markers or embedded, and 'platform' is ios, visionos, watchos, tvos, macos or catalyst> 次多次使用
为针对设备架构的编译步骤指定 Apple 位码模式。值的格式为“[platform=]mode”,其中平台(必须为“ios”“macos”“tvos”或“watchos”)是可选的。如果提供位码模式,则专门针对该平台应用位码模式;如果省略,则将应用于所有平台。模式必须为“none”“embedded_markers”或“embedded”。此选项可能会提供多次。
标记: loses_incremental_state
--[no]build_python_zip 默认值:“auto”
构建 Python 可执行 zip 文件;在 Windows 上,在其他平台上关闭
标记: affects_outputs
已累计 --catalyst_cpus=<comma-separated list of options> 次多次使用
要为其构建 Apple Catalyst 二进制文件的架构列表(以英文逗号分隔)。
标记:loses_incremental_stateloading_and_analysis
--[no]collect_code_coverage 默认值:“false”
如果指定,Bazel 将对代码进行插桩处理(尽可能使用离线插桩),并在测试期间收集覆盖率信息。只有与“Instrumentation_filter”匹配的目标会受到影响。通常,不应直接指定此选项,应改用“bazelCoverage”命令。
标记: affects_outputs
--compilation_mode=<fastbuild, dbg or opt> [-c] 默认值:“fastbuild”
指定将在其中构建二进制文件的模式。值:“fastbuild”、“dbg”、“opt”。
标记:affects_outputsaction_command_linesexplicit_in_output_path
已累计 --conlyopt=<a string> 次多次使用
编译 C 源文件时要传递给 gcc 的附加选项。
标记:action_command_linesaffects_outputs
已累计 --copt=<a string> 次多次使用
可传递给 gcc 的其他选项。
标记:action_command_linesaffects_outputs
--cpu=<a string> 默认值:“”
目标 CPU。
标记:changes_inputsaffects_outputsexplicit_in_output_path
--cs_fdo_absolute_path=<a string> 默认值:请参阅说明
使用 CSFDO 配置文件信息优化编译。指定包含配置文件(原始或编入索引的 LLVM 配置文件)的 ZIP 文件的绝对路径名称。
标记: affects_outputs
--cs_fdo_instrument=<a string> 默认值:请参阅说明
使用上下文敏感 FDO 插桩生成二进制文件。使用 Clang/LLVM 编译器,它也接受在运行时转储原始配置文件所在的目录名称。
标记: affects_outputs
--cs_fdo_profile=<a build target label> 默认值:请参阅说明
cs_fdo_profile,表示要用于优化的上下文相关配置文件。
标记: affects_outputs
已累计 --cxxopt=<a string> 次多次使用
编译 C++ 源文件时要传递给 gcc 的附加选项。
标记:action_command_linesaffects_outputs
已累计 --define=<a 'name=value' assignment> 次多次使用
每个 --define 选项均可为 build 变量指定一个赋值。
标记:changes_inputsaffects_outputs
--dynamic_mode=<off, default or fully> 默认值:“default”
确定是否要动态链接 C++ 二进制文件。“default”表示 Bazel 将选择是否动态链接。“full”表示将动态地链接所有库。“off”表示所有库都将在基本静态模式下链接。
标记:loading_and_analysisaffects_outputs
--[no]enable_fdo_profile_absolute_path 默认值:“true”
如果设置此参数,使用 fdo_absolute_profile_path 会引发错误。
标记: affects_outputs
--[no]enable_runfiles 默认值:“auto”
启用 runfiles 符号链接树;默认情况下,此设置在 Windows 和其他平台上处于关闭状态。
标记: affects_outputs
已累计 --experimental_action_listener=<a build target label> 次多次使用
废弃了,取而代之的是切面。使用 action_listener 将 extra_action 附加到现有构建操作。
标记:executionexperimental
--[no]experimental_android_compress_java_resources 默认值:“false”
压缩 APK 中的 Java 资源
标记:affects_outputsloading_and_analysisexperimental
--[no]experimental_android_databinding_v2 默认值:“false”
使用 Android 数据绑定 v2
标记:affects_outputsloading_and_analysisloses_incremental_stateexperimental
--[no]experimental_android_resource_shrinking 默认值:“false”
为使用 ProGuard 的 android_binary APK 启用资源缩减。
标记:affects_outputsloading_and_analysis
--[no]experimental_android_rewrite_dexes_with_rex 默认值:“false”
使用 rex 工具重写 dex 文件
标记:affects_outputsloading_and_analysisloses_incremental_stateexperimental
--[no]experimental_collect_code_coverage_for_generated_files 默认值:“false”
如果指定,Bazel 还将为生成的文件生成收集覆盖率信息。
标记: affects_outputs
--experimental_objc_fastbuild_options=<comma-separated list of options> 默认值:“-O0,-DDEBUG=1”
使用这些字符串作为 objc quickbuild 编译器选项。
标记: action_command_lines
--[no]experimental_omitfp 默认值:“false”
如果为 true,则使用 libunwind 进行堆栈展开,并使用 -fomit-frame-pointer 和 -faSYNC-unwind-tables 进行编译。
标记:action_command_linesaffects_outputsexperimental
--[no]experimental_platform_in_output_dir 默认值:“false”
如果为 true,则输出目录名称中使用目标平台(而非 CPU)。
标记:affects_outputsexperimental
--[no]experimental_use_llvm_covmap 默认值:“false”
如果指定,则启用 collect_code_coverage 时,Bazel 将生成 llvm-cov 覆盖范围地图信息,而不是 gcov。
标记:changes_inputsaffects_outputsloading_and_analysisexperimental
--fat_apk_cpu=<comma-separated list of options> 默认值:“armeabi-v7a”
设置此选项会启用胖 APK,其中包含适用于所有指定目标架构的原生二进制文件,例如--fat_apk_cpu=x86,armeabi-v7a. 如果指定此标志,对于 android_binary 规则的依赖项,系统会忽略 --android_cpu。
标记:affects_outputsloading_and_analysisloses_incremental_state
--[no]fat_apk_hwasan 默认值:“false”
是否创建 HWASAN 分块。
标记:affects_outputsloading_and_analysisloses_incremental_state
--fdo_instrument=<a string> 默认值:请参阅说明
使用 FDO 插桩生成二进制文件。使用 Clang/LLVM 编译器,它也接受在运行时转储原始配置文件所在的目录名称。
标记: affects_outputs
--fdo_optimize=<a string> 默认值:请参阅说明
使用 FDO 配置文件信息优化编译。指定包含 .gcda 文件树的 zip 文件的名称、包含自动配置文件的 afdo 文件或 LLVM 配置文件的名称。此标志还接受指定为标签的文件(例如 `//foo/bar:file.afdo` - 您可能需要向相应的软件包添加 `exports_files` 指令)以及指向 `fdo_profile` 目标的标签。此标志将由“fdo_profile”规则取代。
标记: affects_outputs
--fdo_prefetch_hints=<a build target label> 默认值:请参阅说明
使用缓存预提取提示。
标记: affects_outputs
--fdo_profile=<a build target label> 默认值:请参阅说明
fdo_profile,表示要用于优化的配置文件。
标记: affects_outputs
已累计 --features=<a string> 次多次使用
对于目标配置中构建的目标,系统会默认启用或停用指定功能。指定 -<feature> 将停用该功能。负面特征始终会覆盖正特征。另请参阅 --host_features
标记:changes_inputsaffects_outputs
--[no]force_pic 默认值:“false”
启用后,所有 C++ 编译都会生成位置无关代码(“-fPIC”),链接首选 PIC 预构建库而非非 PIC 库,而链接会生成位置独立的可执行文件(“-pie”)。
标记:loading_and_analysisaffects_outputs
已累计 --host_action_env=<a 'name=value' assignment with an optional value part> 次多次使用
指定可用于具有主机或执行配置的操作的一组环境变量。变量可以按名称指定(在这种情况下,值将从调用环境中获取),也可以通过 name=value 对(其值独立于调用环境设置)指定。此选项可以多次使用;对于同一变量提供的选项,系统会汇总最后胜出的选项。
标记: action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt> 默认值:“opt”
指定构建期间要使用的工具的模式。值:“fastbuild”、“dbg”、“opt”。
标记:affects_outputsaction_command_lines
已累计 --host_conlyopt=<a string> 次多次使用
为主机工具编译 C 源文件时传递给 gcc 的附加选项。
标记:action_command_linesaffects_outputs
已累计 --host_copt=<a string> 次多次使用
传递给主机工具的 gcc 的其他选项。
标记:action_command_linesaffects_outputs
--host_cpu=<a string> 默认值:“”
主机 CPU。
标记:changes_inputsaffects_outputs
已累计 --host_cxxopt=<a string> 次多次使用
传递给主机工具的 gcc 的其他选项。
标记:action_command_linesaffects_outputs
已累计 --host_features=<a string> 次多次使用
对于 exec 配置中构建的目标,系统会默认启用或停用给定功能。指定 -<feature> 将停用该功能。负特征始终会覆盖正特征。
标记:changes_inputsaffects_outputs
--host_force_python=<PY2 or PY3> 默认值:请参阅说明
覆盖主机配置的 Python 版本。可以是“PY2”或“PY3”。
标记:loading_and_analysisaffects_outputs
已累计 --host_linkopt=<a string> 次多次使用
在关联主机工具时传递给 gcc 的附加选项。
标记:action_command_linesaffects_outputs
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> 默认值:请参阅说明
主机目标的最低兼容 macOS 版本。如果未指定,则使用“macos_sdk_version”。
标记: loses_incremental_state
已累计 --host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options> 次多次使用
在主机或 exec 配置中编译某些文件时,可选择性地传递给 C/C++ 编译器的其他选项。可以多次传递此选项。语法:regex_filter@option_1,option_2,...,option_n。其中,regex_filter 代表包含和排除正则表达式模式的列表(另请参阅 --instrumentation_filter)。 option_1 到 option_n 代表任意命令行选项。如果选项中包含英文逗号,则必须使用反斜杠将其括起来。选项可以包含 @。只有第一个 @ 用于拆分字符串。示例:--host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 向 //foo/(bar.cc 除外)中所有 cc 文件的 gcc 命令行添加 -O0 命令行选项。
标记:action_command_linesaffects_outputs
已累计 --host_swiftcopt=<a string> 次多次使用
为主机工具传递给 swiftc 的其他选项。
标记:action_command_linesaffects_outputs
--[no]incompatible_avoid_conflict_dlls 默认值:“true”
启用后,Windows 上的 cc_library 生成的所有 C++ 动态链接库 (DLL) 都将重命名为 name_{hash}.dll,其中哈希值根据 RepositoryName 和 DLL 的软件包路径计算。如果您有一个软件包依赖于多个同名的 cc_library(例如 //foo/bar1:utils 和 //foo/bar2:utils),则此选项非常有用。
标记:loading_and_analysisaffects_outputsincompatible_change
--[no]incompatible_merge_genfiles_directory 默认值:“true”
如果为 true,genfiles 目录会折叠到 bin 目录中。
标记:affects_outputsincompatible_change
--[no]incompatible_use_host_features 默认值:“false”
如果为 true,则仅对目标配置使用 --features,针对 exec 配置使用 --host_features。
标记:changes_inputsaffects_outputsincompatible_change
--[no]incompatible_use_platforms_repo_for_constraints 默认值:“true”
如果为 true,系统会移除 @bazel_tools 中的限制条件设置。
标记:affects_outputsincompatible_change
--[no]instrument_test_targets 默认值:“false”
启用覆盖率后,指定是否考虑对测试规则进行插桩测试。设置后,将对 --instrumentation_filter 包含的测试规则进行插桩处理。否则,测试规则始终会从覆盖范围插桩中排除。
标记: affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths> 默认值:“-/javatests[/:],-/test/java[/:]”
启用覆盖率后,系统只会对名称中包含指定基于正则表达式的过滤器的规则进行插桩处理。前缀为“-”的规则将被排除。请注意,除非启用了 --instrument_test_targets,否则只能对非测试规则进行插桩处理。
标记: affects_outputs
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> 默认值:请参阅说明
目标模拟器和设备的最低兼容 iOS 版本。如果未指定,则使用“ios_sdk_version”。
标记: loses_incremental_state
已累计 --ios_multi_cpus=<comma-separated list of options> 次多次使用
用于构建 ios_application 的架构列表(以英文逗号分隔)。从而生成一个包含所有指定架构的通用二进制文件。
标记:loses_incremental_stateloading_and_analysis
--[no]legacy_whole_archive 默认值:“true”
已废弃,已被 --incompatible_remove_legacy_whole_archive 取代(如需了解详情,请参阅 https://github.com/bazelbuild/bazel/issues/7362)。开启此设置后,请为 linkopts 中包含 linkshared=True 且 linkstatic=True 或“-static”的 cc_binary 规则使用 --whole-archive。这仅用于向后兼容。更好的替代方案是根据需要使用 alwayslink=1。
标记:action_command_linesaffects_outputsdeprecated
已累计 --linkopt=<a string> 次多次使用
在链接时传递给 gcc 的附加选项。
标记:action_command_linesaffects_outputs
已累计 --ltobackendopt=<a string> 次多次使用
用于传递给 LTO 后端步骤的附加选项(在 --features=thin_lto 下)。
标记:action_command_linesaffects_outputs
已累计 --ltoindexopt=<a string> 次多次使用
用于传递给 LTO 索引步骤的附加选项(在 --features=thin_lto 下)。
标记:action_command_linesaffects_outputs
已累计 --macos_cpus=<comma-separated list of options> 次多次使用
要为其构建 Apple macOS 二进制文件的架构列表(以英文逗号分隔)。
标记:loses_incremental_stateloading_and_analysis
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> 默认值:请参阅说明
目标的最低兼容 macOS 版本。如果未指定,则使用“macos_sdk_version”。
标记: loses_incremental_state
--[no]objc_debug_with_GLIBCXX 默认值:“false”
如果已设置此参数,并且编译模式设为“dbg”,则定义 GLIBCXX_DEBUG、GLIBCXX_DEBUG_PEDANTIC 和 GLIBCPP_CONCEPT_CHECKS。
标记: action_command_lines
--[no]objc_enable_binary_stripping 默认值:“false”
是否对链接的二进制文件执行符号和死代码删除。如果同时指定了此标志和 --compilation_mode=opt,系统会执行二进制文件剥离。
标记: action_command_lines
已累计 --objccopt=<a string> 次多次使用
编译 Objective-C/C++ 源文件时需要传递给 gcc 的其他选项。
标记: action_command_lines
已累计 --per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options> 次多次使用
在编译特定文件时,可选择性地传递给 gcc 的其他选项。可以多次传递此选项。语法:regex_filter@option_1,option_2,...,option_n。其中,regex_filter 代表包含和排除正则表达式模式的列表(另请参阅 --instrumentation_filter)。 option_1 到 option_n 代表任意命令行选项。如果选项中包含英文逗号,则必须使用反斜杠将其括起来。选项可以包含 @。只有第一个 @ 用于拆分字符串。示例:--per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 向 //foo/(bar.cc 除外)中所有 cc 文件的 gcc 命令行添加 -O0 命令行选项。
标记:action_command_linesaffects_outputs
已累计 --per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options> 次多次使用
在编译某些后端对象时,可选择性地传递到 LTO 后端(在 --features=thin_lto 下)的其他选项。可以多次传递此选项。语法:regex_filter@option_1,option_2,...,option_n。其中,regex_filter 代表包含和排除正则表达式模式的列表。 option_1 到 option_n 代表任意命令行选项。如果选项中包含英文逗号,则必须使用反斜杠将其括起来。选项可以包含 @。只有第一个 @ 用于拆分字符串。示例:--per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 向 //foo/(bar.o 除外)中所有 o 文件的 LTO 后端命令行添加 -O0 命令行选项。
标记:action_command_linesaffects_outputs
--platform_suffix=<a string> 默认值:请参阅说明
指定要添加到配置目录的后缀。
标记:loses_incremental_stateaffects_outputsloading_and_analysis
--propeller_optimize=<a build target label> 默认值:请参阅说明
使用螺旋桨配置文件信息优化构建目标。螺旋桨配置文件必须至少包含以下两个文件中的一个:cc 配置文件和 ld 配置文件。此标志接受必须引用螺旋桨配置文件输入文件的 build 标签。(此选项必须用作:--propeller_optimize=//a/b:propeller_profile
标记:action_command_linesaffects_outputs
--propeller_optimize_absolute_cc_profile=<a string> 默认值:请参阅说明
Propeller 优化 build 的 cc_profile 文件的绝对路径名称。
标记: affects_outputs
--propeller_optimize_absolute_ld_profile=<a string> 默认值:请参阅说明
Propeller 优化 build 的 ld_profile 文件的绝对路径名称。
标记: affects_outputs
--run_under=<a prefix in front of command> 默认值:请参阅说明
要在“test”和“run”命令的可执行文件前面插入的前缀。如果值为“foo -bar”,且执行命令行为“test_binary -baz”,则最终命令行为“foo -bar test_binary -baz”。这也可以是可执行目标的标签。部分示例包括:“valgrind”“strace”“strace -c”“valgrind --quiet --num-callers=20”“//package:target”“//package:target --options”。
标记: action_command_lines
--[no]share_native_deps 默认值:“true”
如果为 true,则包含相同功能的原生库将由不同的目标共享
标记:loading_and_analysisaffects_outputs
--[no]stamp 默认值:“false”
为二进制文件标记日期、用户名、主机名、工作区信息等。
标记: affects_outputs
--strip=<always, sometimes or never> 默认值:“有时”
指定是否删除二进制文件和共享库(使用“-Wl,--strip-debug”)。默认值“有时”表示,如果 f --compilation_mode=fastbuild,则执行剥离。
标记: affects_outputs
已累计 --stripopt=<a string> 次多次使用
生成“<name>.stripped”二进制文件时要传递的其他选项。
标记:action_command_linesaffects_outputs
已累计 --swiftcopt=<a string> 次多次使用
传递给 Swift 编译的更多选项。
标记: action_command_lines
已累计 --tvos_cpus=<comma-separated list of options> 次多次使用
要为其构建 Apple tvOS 二进制文件的架构列表(以英文逗号分隔)。
标记:loses_incremental_stateloading_and_analysis
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> 默认值:请参阅说明
目标模拟器和设备的最低兼容 tvOS 版本。如果未指定,则使用“tvos_sdk_version”。
标记: loses_incremental_state
已累计 --visionos_cpus=<comma-separated list of options> 次多次使用
要为其构建 Apple visionOS 二进制文件的架构列表(以英文逗号分隔)。
标记:loses_incremental_stateloading_and_analysis
已累计 --watchos_cpus=<comma-separated list of options> 次多次使用
要为其构建 Apple watchOS 二进制文件的架构列表(以英文逗号分隔)。
标记:loses_incremental_stateloading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> 默认值:请参阅说明
适用于目标模拟器和设备的最低兼容 watchOS 版本。如果未指定,则使用“watchos_sdk_version”。
标记: loses_incremental_state
--xbinary_fdo=<a build target label> 默认值:请参阅说明
使用 XbinaryFDO 配置文件信息优化编译。指定默认跨二进制配置文件的名称。当该选项与 --fdo_instrument/--fdo_optimize/--fdo_profile 一起使用时,这些选项将始终优先,就像从未指定 xbinary_fdo 一样。
标记: affects_outputs
影响 Bazel 强制执行有效 build 输入的严格程度的选项(规则定义、标志组合等):
--auto_cpu_environment_group=<a build target label> 默认值:“”
声明用于自动将 CPU 值映射到 target_environment 值的 environment_group。
标记:changes_inputsloading_and_analysisexperimental
--[no]check_licenses 默认值:“false”
检查依赖软件包施加的许可限制是否与正在构建的目标的分发模式冲突。默认情况下,系统不会选中许可。
标记: build_file_semantics
--[no]check_visibility 默认值:“true”
如果停用此设置,目标依赖项中的可见性错误会降级为警告。
标记: build_file_semantics
--[no]desugar_for_android 默认值:“true”
是否在 dex 处理之前对 Java 8 字节码进行脱糖。
标记:affects_outputsloading_and_analysisloses_incremental_state
--[no]desugar_java8_libs 默认值:“false”
是否在旧版设备应用中包含受支持的 Java 8 库。
标记:affects_outputsloading_and_analysisloses_incremental_stateexperimental
--[no]enforce_constraints 默认值:“true”
检查每个目标兼容的环境,如果任何目标的依赖项不支持相同环境,则报告错误
标记:build_file_semantics
--[no]experimental_allow_android_library_deps_without_srcs 默认值:“false”
用于帮助从允许转换为禁止使用依赖项的 srcs-less android_library 规则的标记。默认情况下,您需要清理仓库才能发布此仓库。
标记:eagerness_to_exitloading_and_analysis
--[no]experimental_check_desugar_deps 默认值:“true”
是否仔细检查 Android 二进制文件级别的脱糖是否正确。
标记:eagerness_to_exitloading_and_analysisexperimental
--experimental_import_deps_checking=<off, warning or error> 默认值:“OFF”
启用后,检查 aar_import 的依赖项是否完整。这种强制执行可能会破坏构建,或者只会导致警告。
标记: loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default> 默认值:“default”
如果为 true,则检查 Java 目标是否将所有直接使用的目标明确声明为依赖项。
标记:build_file_semanticseagerness_to_exit
--[no]incompatible_check_testonly_for_output_files 默认值:“false”
如果启用,则通过查找生成规则的 testonly 来仅检查 testonly(输出文件的必要目标)。这与可见性检查一致。
标记:build_file_semanticsincompatible_change
--[no]incompatible_disable_native_android_rules 默认值:“false”
启用后,系统会禁止直接使用原生 Android 规则。请使用 https://github.com/bazelbuild/rules_android 中的 Starlark Android 规则
标记:eagerness_to_exitincompatible_change
--[no]incompatible_disable_native_apple_binary_rule 默认值:“false”
无操作。保留在此处以确保向后兼容性。
标记:eagerness_to_exitincompatible_change
--[no]incompatible_force_strict_header_check_from_starlark 默认值:“true”
如果启用,请在 Starlark API 中设置严格的标头检查
标记:loading_and_analysischanges_inputsincompatible_change
--[no]incompatible_validate_top_level_header_inclusions 默认值:“true”
如果为 true,Bazel 还将验证是否包含顶级目录标头(如需了解详情,请参阅 https://github.com/bazelbuild/bazel/issues/10047)。
标记:loading_and_analysisincompatible_change
--[no]strict_filesets 默认值:“false”
如果启用此选项,跨越软件包边界的文件集会报告为错误。当 check_fileset_dependencies_recursively 停用时不起作用。
标记:build_file_semanticseagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default> 默认值:“error”
除非 OFF,否则检查 proto_library 目标是否明确将所有直接使用的目标声明为依赖项。
标记:build_file_semanticseagerness_to_exitincompatible_change
--strict_public_imports=<off, warn, error, strict or default> 默认值:“off”
除非 OFF,否则检查 proto_library 目标是否将“import public”中使用的所有目标明确声明为已导出。
标记:build_file_semanticseagerness_to_exitincompatible_change
--[no]strict_system_includes 默认值:“false”
如果为 true,则还需要声明通过系统包含路径 (-isystem) 找到的头文件。
标记:loading_and_analysiseagerness_to_exit
已累计 --target_environment=<a build target label> 次多次使用
声明此 build 的目标环境。必须是对“环境”规则的标签引用。如果指定,则所有顶级目标都必须与此环境兼容。
标记: changes_inputs
影响 build 的签名输出的选项:
--apk_signing_method=<v1, v2, v1_v2 or v4> 默认值:“v1_v2”
用于为 APK 签名的实现
标记:action_command_linesaffects_outputsloading_and_analysis
--[no]device_debug_entitlements 默认值:“true”
如果已设置且编译模式不是“opt”,objc 应用在签名时会包含调试权限。
标记: changes_inputs
--ios_signing_cert_name=<a string> 默认值:请参阅说明
用于 iOS 签名的证书名称。如果未设置,系统将回退到预配配置文件。可能是证书的钥匙串身份偏好设置或证书通用名称的(子字符串),详情请见代码签名的手册页面 (SIGNING IDENTITIES)。
标记:action_command_lines
此选项会影响 Starlark 语言或 build 文件、.bzl 文件或 WORKSPACE 文件可访问的 build API 的语义。
--[no]incompatible_disallow_legacy_py_provider 默认值:“true”
无操作性通知,很快就会被移除。
标记:loading_and_analysisincompatible_change
用于控制测试环境或测试运行程序的行为的选项:
--[no]allow_analysis_failures 默认值:“false”
如果为 true,则规则目标的分析失败会导致目标传播包含错误说明的 AnalysisFailureInfo 实例,而不会导致构建失败。
标记:loading_and_analysisexperimental
--analysis_testing_deps_limit=<an integer> 默认值:“2000”
通过包含 for_analysis_testing 配置转换的规则属性设置传递依赖项的数量上限。超过此限制将导致规则错误。
标记: loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure 默认值:“false”
如果 dex2oat 操作为 true,则会导致构建中断,而不会在测试运行时期间执行 dex2oat。
标记:loading_and_analysisexperimental
--[no]experimental_android_use_parallel_dex2oat 默认值:“false”
同时使用 dex2oat 可以加快 android_test 的运行速度。
标记:loading_and_analysishost_machine_resource_optimizationsexperimental
--[no]ios_memleaks 默认值:“false”
启用 ios_test 目标中的内存泄漏检查功能。
标记: action_command_lines
--ios_simulator_device=<a string> 默认值:请参阅说明
在模拟器中运行 iOS 应用(例如“iPhone 6”)时要模拟的设备。您可以在运行模拟器的机器上运行“xcrun simctl list devicetypes”来获取设备列表。
标记: test_runner
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> 默认值:请参阅说明
运行或测试时要在模拟器上运行的 iOS 版本。如果 ios_test 规则中指定了目标设备,系统会忽略此规则。
标记: test_runner
已累计 --runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once> 次多次使用
指定每项测试的运行次数。如果其中任何一项测试因任何原因失败,整个测试都将被视为失败。通常,指定的值只是一个整数。示例:--runs_per_test=3 会运行所有测试 3 次。替代语法:regex_filter@runs_per_test。其中,runs_per_test 代表整数值,而 regex_filter 代表包含和排除正则表达式模式的列表(另请参阅 --instrumentation_filter)。示例:--runs_per_test=//foo/.*,-//foo/bar/.*@3 运行 //foo/ 中的所有测试(foo/bar 下的测试除外)三次。可以多次传递此选项。最新传递且匹配的参数优先。如果没有匹配项,该测试将仅运行一次。
已累计 --test_env=<a 'name=value' assignment with an optional value part> 次多次使用
指定要注入到测试运行程序环境的其他环境变量。变量可以按名称指定(在这种情况下,其值将从 Bazel 客户端环境中读取),或者按名称=值对进行读取。可多次使用此选项来指定多个变量。仅供“bazel test”命令使用。
标记: test_runner
--test_timeout=<a single integer or comma-separated list of 4 integers> 默认值:“-1”
替换测试超时的默认测试超时值(以秒为单位)。如果指定了单个正整数值,则该值将覆盖所有类别。如果指定了 4 个以英文逗号分隔的整数,这些值会替换短、中、长和永恒(按此顺序)的超时设置。无论使用哪种方式,值 -1 都会指示 Blaze 对该类别使用其默认超时。
--tvos_simulator_device=<a string> 默认值:请参阅说明
在模拟器中运行 tvOS 应用时(例如“Apple TV 1080p”)时要模拟的设备。您可以在运行模拟器的机器上运行“xcrun simctl list devicetypes”来获取设备列表。
标记: test_runner
--tvos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> 默认值:请参阅说明
运行或测试时要在模拟器上运行的 tvOS 版本。
标记: test_runner
--watchos_simulator_device=<a string> 默认值:请参阅说明
在模拟器中运行 watchOS 应用时(例如“Apple Watch - 38mm”)时要模拟的设备。您可以在运行模拟器的机器上运行“xcrun simctl list devicetypes”来获取设备列表。
标记: test_runner
--watchos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> 默认值:请参阅说明
运行或测试时要在模拟器上运行的 watchOS 版本。
标记: test_runner
--[no]zip_undeclared_test_outputs 默认值:“true”
如果为 true,则未声明的测试输出将归档为一个 ZIP 文件。
标记: test_runner
与查询输出和语义相关的选项:
--aspect_deps=<off, conservative or precise> 默认值:“conservative”
当输出格式为 {xml,proto,record} 之一时,如何解析切面依赖项。“off”表示不解析任何切面依赖项,“保守”(默认值)表示添加所有已声明的切面依赖关系,而不管它们是否被赋予直接依赖关系的规则类为直接依赖关系,“precise”表示仅添加在直接依赖关系规则类下可能处于活动状态的那些切面。请注意,精确模式需要加载其他软件包来评估单个目标,因此该模式比其他模式慢。另请注意,即使是精确模式也不是完全精确的:是否要计算某个切面的决策是在分析阶段决定的,而不是在“bazel 查询”期间运行。
标记: build_file_semantics
--[no]consistent_labels 默认值:“false”
启用后,每个查询命令都会发出标签,就像通过应用于 <code>Label</code> 实例的 Starlark <code>str</code> 函数发出一样。这对于需要匹配不同查询命令的输出和/或由规则发出的标签生成的工具非常有用。如果未启用,输出格式设置工具可以自由发出明显的仓库名称(相对于主仓库),以使输出更具可读性。
标记: terminal_output
--[no]graph:factored 默认值:“true”
如果为 true,则该图将发出“因式分解”处理,即拓扑相等的节点将合并在一起,其标签将串联起来。此选项仅适用于 --output=graph。
标记: terminal_output
--graph:node_limit=<an integer> 默认值:“512”
输出中图表节点的标签字符串的最大长度。较长的标签将被截断;-1 表示不会被截断。此选项仅适用于 --output=graph。
标记: terminal_output
--[no]implicit_deps 默认值:“true”
启用后,隐式依赖项将包含在执行查询的依赖关系图中。隐式依赖项是指未在 BUILD 文件中明确指定但由 bazel 添加的依赖项。对于 cquery,此选项用于控制过滤已解析的工具链。
标记: build_file_semantics
--[no]include_aspects 默认值:“true”
aquery、cquery:是否在输出中包含切面生成的操作。query: no-op(始终遵循切面)。
标记: terminal_output
--[no]incompatible_display_source_file_location 默认值:“true”
默认情况下为 true,显示源文件的目标。如果为 true,则显示位置输出中源文件第 1 行的位置。此标志仅用于迁移目的。
标记:terminal_outputincompatible_change
--[no]incompatible_package_group_includes_double_slash 默认值:“true”
如果启用此选项,则输出 package_group 的 `packages` 属性时,前导 `//` 将不会省略。
标记:terminal_outputincompatible_change
--[no]infer_universe_scope 默认值:“false”
如果您设置此参数,并且未设置 --universe_scope,则系统会将“--universe_scope”值推断为查询表达式中唯一目标模式的列表。请注意,针对使用 Universe 范围函数(例如 `allrdeps`)的查询表达式推断出的 --universe_scope 值可能不是您想要的值,因此除非您知道自己正在执行的操作,否则不应使用此选项。如需了解详情和示例,请参阅 https://bazel.build/reference/query#sky-query。如果设置了 --universe_scope,则会忽略此选项的值。注意:此选项仅适用于“query”(即不适用于“cquery”)。
标记:loading_and_analysis
--[no]line_terminator_null 默认值:“false”
每种格式是否以 \0(而非换行符)结束。
标记: terminal_output
--[no]nodep_deps 默认值:“true”
如果启用,则“nodep”属性中的依赖项将包含在执行查询的依赖关系图中。“nodep”属性的一个常见示例是“visibility”。运行并解析“info build-language”的输出,即可了解 build 语言中的所有“nodep”属性。
标记: build_file_semantics
--output=<a string> 默认值:“label”
应以哪种格式输出 cquery 结果。cquery 允许使用的值包括:label、label_Kind、textproto、transitions、proto、jsonproto。如果您选择“transitions”,还必须指定 --transitions=(lite|full) 选项。
标记: terminal_output
--[no]proto:default_values 默认值:“true”
如果为 true,则会包含 BUILD 文件中未明确指定值的属性;否则,会忽略这些属性。此选项适用于 --output=proto
标记:terminal_output
--[no]proto:definition_stack 默认值:“false”
填充 Definition_stack proto 字段,在定义规则的类时,为每个规则实例记录 Starlark 调用堆栈。
标记: terminal_output
--[no]proto:flatten_selects 默认值:“true”
启用后,通过 select() 创建的可配置属性将展平。对于列表类型,扁平化表示形式是一个列表,包含选定映射的每个值一次。标量类型会展平为 null。
标记: build_file_semantics
--[no]proto:include_configurations 默认值:“true”
如果启用,proto 输出将包含有关配置的信息。停用后,cquery proto 输出格式将类似于查询输出格式。
标记: affects_outputs
--[no]proto:include_synthetic_attribute_hash 默认值:“false”
是否计算和填充 $internal_attr_hash 属性。
标记: terminal_output
--[no]proto:instantiation_stack 默认值:“false”
填充每条规则的实例化调用堆栈。请注意,这需要有堆栈存在
标记:terminal_output
--[no]proto:locations 默认值:“true”
是否在 proto 输出中输出位置信息。
标记: terminal_output
--proto:output_rule_attrs=<comma-separated list of options> 默认值:“all”
要包含在输出中的属性列表(以英文逗号分隔)。默认值为所有属性。设置为空字符串,不输出任何属性。此选项适用于 --output=proto。
标记: terminal_output
--[no]proto:rule_inputs_and_outputs 默认值:“true”
是否填充 rules_input 和 rules_output 字段。
标记: terminal_output
--query_file=<a string> 默认值:“”
如果设置此参数,查询将从此处指定的文件中(而不是在命令行中)读取查询。在此处指定文件以及通过命令行查询是错误的。
标记: changes_inputs
--[no]relative_locations 默认值:“false”
如果为 true,则 BUILD 文件在 xml 和 proto 输出中的位置将是相对的。默认情况下,位置输出是绝对路径,在不同机器中不一致。您可以将此选项设置为 true,以便在不同机器上获得一致的结果。
标记: terminal_output
--show_config_fragments=<off, direct or transitive> 默认值:“off”
显示规则所需的配置片段及其传递依赖项。这对于评估可以对配置的目标图表进行修剪的程度非常有用。
标记: affects_outputs
--starlark:expr=<a string> 默认值:“”
一个 Starlark 表达式,用于在 cquery 的 --output=starlark 模式下设置每个已配置目标的格式。配置的目标会绑定到“target”。如果 --starlark:expr 和 --starlark:file 都未指定,此选项将默认为“str(target.label)”。同时指定 --starlark:expr 和 --starlark:file 是错误的。
标记: terminal_output
--starlark:file=<a string> 默认值:“”
文件的名称,该文件定义了一个名为“format”的 Starlark 函数,该函数具有一个参数,该函数会应用于每个已配置的目标,以将其格式化为字符串。同时指定 --starlark:expr 和 --starlark:file 是错误的。如需了解详情,请参阅 --output=starlark 帮助。
标记: terminal_output
--[no]tool_deps 默认值:“true”
查询:如果停用,对“主机配置”或“执行”目标的依赖关系将不会包含在执行查询的依赖关系图中。“主机配置”依赖项边缘(例如从任何“proto_library”规则到协议编译器的依赖项边缘)通常指向在构建期间执行的工具,而不是同一“目标”程序的一部分。 Cquery:如果停用,则会从发现此已配置目标的顶级目标中过滤掉所有跨主机或执行转换的已配置目标。这意味着,如果顶级目标位于目标配置中,则将仅返回同样位于目标配置中的已配置目标。如果顶级目标位于主机配置中,则系统将仅返回主机配置的目标。此选项不会排除已解析的工具链。
标记: build_file_semantics
--transitions=<full, lite or none> 默认值:“none”
cquery 输出转换信息的格式。
标记: affects_outputs
--universe_scope=<comma-separated list of options> 默认值:“”
一组以英文逗号分隔的目标模式(加法和减法)。此查询可以在由指定目标的传递闭合定义的宇宙中执行。此选项用于 query 和 cquery 命令。 对于 cquery,此选项的输入是构建所有答案的目标,因此此选项可能会影响配置和转换。如果未指定此选项,系统会假定顶级目标是通过查询表达式解析的目标。注意:对于 cquery,如果无法使用顶级选项构建从查询表达式解析的目标,则不指定此选项可能会导致构建中断。
标记: loading_and_analysis
触发构建时优化的选项:
--[no]collapse_duplicate_defines 默认值:“false”
启用后,系统会在 build 中尽早移除多余的 --定义。这样可以避免某些类型的等效 build 出现不必要的分析缓存丢失。
标记:loading_and_analysisloses_incremental_state
--[no]experimental_filter_library_jar_with_program_jar 默认值:“false”
过滤 ProGuard ProgramJar 以移除 LibraryJar 中也存在的所有类。
标记: action_command_lines
--[no]experimental_inmemory_dotd_files 默认值:“true”
启用后,C++ .d 文件将直接从远程 build 节点在内存中传递,而不是写入磁盘。
标记:loading_and_analysisexecutionaffects_outputsexperimental
--[no]experimental_inmemory_jdeps_files 默认值:“true”
启用后,通过 Java 编译生成的依赖项 (.jdeps) 文件将直接从远程构建节点在内存中传递,而不是写入磁盘。
标记:loading_and_analysisexecutionaffects_outputsexperimental
--[no]experimental_objc_include_scanning 默认值:“false”
是否针对目标 C/C++ 执行包含扫描。
标记:loading_and_analysisexecutionchanges_inputs
--[no]experimental_parse_headers_skipped_if_corresponding_srcs_found 默认值:“false”
启用后,如果在同一目标中发现具有相同基名的来源,parse_headers 功能不会创建单独的标头编译操作。
标记:loading_and_analysisaffects_outputs
--[no]experimental_retain_test_configuration_across_testonly 默认值:“false”
启用后,对于标记为 testonly=1 的规则,--trim_test_configuration 不会修剪测试配置。这是为了减少非测试规则依赖于 cc_test 规则时的操作冲突问题。如果 --trim_test_configuration 为 false,则无效。
标记:loading_and_analysisloses_incremental_state
--[no]experimental_starlark_cc_import 默认值:“false”
启用后,即可使用 Starlark 版本的 cc_import。
标记:loading_and_analysisexperimental
--[no]experimental_unsupported_and_brittle_include_scanning 默认值:“false”
是否通过解析输入文件中的 #include 行来缩小 C/C++ 编译的输入范围。这可以通过减小编译输入树的大小来提高性能和增量。不过,它也可能会中断构建,因为 include 扫描器无法完全实现 C 预处理器语义。特别是,它不理解动态 #include 指令,并且会忽略预处理器的条件逻辑。使用时需自行承担风险。已提交的与此标志相关的任何问题都将关闭。
标记:loading_and_analysisexecutionchanges_inputs
--[no]incremental_dexing 默认值:“true”
为每个 Jar 文件分别执行 dex 处理的大部分工作。
标记:affects_outputsloading_and_analysisloses_incremental_state
--[no]objc_use_dotd_pruning 默认值:“true”
如果设置了此字段,则 Clang 发出的 .d 文件将用于剪除传入 objc 编译项的输入集。
标记:changes_inputsloading_and_analysis
--[no]process_headers_in_dependencies 默认值:“false”
构建目标 //a:a 时,处理 //a:a 所依赖的所有目标中的标头(如果工具链启用了标头处理功能)。
标记: execution
--[no]trim_test_configuration 默认值:“true”
启用后,与测试相关的选项将在 build 顶层下方清除。当此标志处于启用状态时,无法将测试构建为非测试规则的依赖项,但对测试相关选项的更改不会导致系统重新分析非测试规则。
标记:loading_and_analysisloses_incremental_state
--[no]use_singlejar_apkbuilder 默认值:“true”
此选项已弃用。该功能现在是一种空操作,很快就会被移除。
标记: loading_and_analysis
影响日志记录的详细程度、格式或位置的选项:
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths> 默认值:“-.*”
在工具链解析期间输出调试信息。该标志采用一个正则表达式,系统会根据工具链类型和特定目标检查该正则表达式,以确定要调试哪个版本。您可以使用英文逗号分隔多个正则表达式,然后单独检查每个正则表达式。注意:此标志的输出非常复杂,可能仅供工具链解析方面的专家使用。
标记: terminal_output
用于指定或更改不属于其他类别的 Bazel 命令的通用输入的选项:
已累计 --flag_alias=<a 'name=value' flag alias> 次多次使用
为 Starlark 标志设置简写名称。它使用“<key>=<value>”形式的单个键值对作为参数。
标记: changes_inputs
--[no]incompatible_default_to_explicit_init_py 默认值:“false”
此标志会更改默认行为,以便系统不再在 Python 目标的 runfile 中自动创建 __init__.py 文件。确切地说,当 py_binary 或 py_test 目标将 legacy_create_init 设置为“auto”(默认值)时,当且仅当设置了此标记时,它才会被视为 false。请参阅 https://github.com/bazelbuild/bazel/issues/10076。
标记:affects_outputsincompatible_change
--[no]incompatible_py2_outputs_are_suffixed 默认值:“true”
如果为 true,则在 Python 2 配置中构建的目标将显示在包含后缀“-py2”的输出根目录下,而为 Python 3 构建的目标将显示在没有与 Python 相关后缀的根下。这意味着,“bazel-bin”便捷符号链接将指向 Python 3 目标,而不是 Python 2。如果启用此选项,还建议您启用“--incompatible_py3_is_default”。
标记:affects_outputsincompatible_change
--[no]incompatible_py3_is_default 默认值:“true”
如果为 true,则未设置其 `python_version`(或 `default_python_version`)属性的 `py_binary` 和 `py_test` 目标将默认为 PY3,而不是 PY2。如果设置了此标志,还建议您设置“--incompatible_py2_outputs_are_suffixed”。
标记:loading_and_analysisaffects_outputsincompatible_change
--[no]incompatible_use_python_toolchains 默认值:“true”
如果设置为 true,可执行原生 Python 规则将使用 Python 工具链指定的 Python 运行时,而不是由旧版标志(如 --python_top)指定的运行时。
标记:loading_and_analysisincompatible_change
--python_version=<PY2 or PY3> 默认值:请参阅说明
Python 主要版本模式,即“PY2”或“PY3”。请注意,这会被“py_binary”和“py_test”目标替换(即使它们未明确指定版本),因此通常没有太多理由提供此标志。
标记:loading_and_analysisaffects_outputsexplicit_in_output_path
其他选项,未以其他方式分类:
--[no]cache_test_results [-t] 默认值:“auto”
如果设置为“auto”,则仅当满足以下条件时,Bazel 才会重新运行测试:(1) Bazel 检测到测试或其依赖项中的更改;(2) 测试标记为外部;(3) 使用 --runs_per_test 请求了多次测试运行;或(4) 之前测试失败。如果设置为“yes”,Bazel 会缓存所有测试结果,但标记为外部的测试除外。如果设置为“no”,Bazel 不会缓存任何测试结果。
--[no]experimental_cancel_concurrent_tests 默认值:“false”
如果为 true,则 Blaze 将在第一次成功运行时取消同时运行测试。此参数必须与 --runs_per_test_detects_flakes 结合使用。
标记:affects_outputsloading_and_analysis
--[no]experimental_fetch_all_coverage_outputs 默认值:“false”
如果为 true,Bazel 会在覆盖率运行期间为每个测试提取整个覆盖率数据目录。
标记:affects_outputsloading_and_analysis
--[no]experimental_generate_llvm_lcov 默认值:“false”
如果为 true,对 Clang 的覆盖率将生成 LCOV 报告。
标记:affects_outputsloading_and_analysis
--[no]experimental_j2objc_header_map 默认值:“true”
是否在 J2ObjC 转译的同时生成 J2ObjC 头文件映射。
--[no]experimental_j2objc_shorter_header_path 默认值:“false”
是否使用较短的标头路径(使用“_ios”而不是“_j2objc”)生成。
标记: affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel> 默认值:“javabuilder”
为 Java 编译启用了缩减的类路径。
--[no]experimental_limit_android_lint_to_android_constrained_java 默认值:“false”
将 --experimental_run_android_lint_on_java_rules 限制为 Android 兼容库。
标记: affects_outputs
--[no]experimental_run_android_lint_on_java_rules 默认值:“false”
是否验证 java_* 源代码。
标记: affects_outputs
--[no]explicit_java_test_deps 默认值:“false”
在 java_test 中明确指定 JUnit 或 Hamcrest 的依赖项,而不是意外从 TestRunner 的依赖项中获取。目前仅适用于 bazel。
--host_java_launcher=<a build target label> 默认值:请参阅说明
在构建期间执行的工具使用的 Java 启动器。
已累计 --host_javacopt=<a string> 次多次使用
构建在构建期间执行的工具时传递给 javac 的其他选项。
已累计 --host_jvmopt=<a string> 次多次使用
构建在构建期间执行的工具时传递给 Java 虚拟机的其他选项。这些选项将添加到每个 java_binary 目标的虚拟机启动选项中。
--[no]incompatible_check_sharding_support 默认值:“false”
如果为 true,则 Bazel 会在测试运行程序未通过轻触 TEST_SHARD_STATUS_FILE 路径下的文件来表明它支持分片时,导致分片测试失败。如果为 false,不支持分片的测试运行程序会导致在每个分片中运行所有测试。
标记: incompatible_change
--[no]incompatible_exclusive_test_sandboxed 默认值:“false”
如果为 true,专用测试将使用沙盒策略运行。添加“local”标记以在本地强制运行独家测试
标记: incompatible_change
--[no]incompatible_strict_action_env 默认值:“false”
如果为 true,Bazel 会使用具有静态 PATH 值的环境,并且不会继承 LD_LIBRARY_PATH。如果您想从客户端继承特定环境变量,请使用 --action_env=ENV_VARIABLE;但请注意,如果使用了共享缓存,这样做可能会阻止用户进行跨用户缓存。
标记:loading_and_analysisincompatible_change
已累计 --j2objc_translation_flags=<comma-separated list of options> 次多次使用
可传递给 J2ObjC 工具的其他选项。
--java_debug
使 Java 测试的 Java 虚拟机在开始测试之前等待来自兼容 JDWP 的调试程序(例如 jdb)的连接。隐式为 -test_output=streamed。
扩展为:
  --test_arg=--wrapper_script_flag=--debug
  --test_output=streamed
  --test_strategy=exclusive
  --test_timeout=9999
  --nocache_test_results
--[no]java_deps 默认值:“true”
每个 Java 目标生成依赖项信息(目前为编译时类路径)。
--[no]java_header_compilation 默认值:“true”
直接从源代码编译 ijar。
--java_language_version=<a string> 默认值:“8”
Java 语言版本
--java_launcher=<a build target label> 默认值:请参阅说明
构建 Java 二进制文件时使用的 Java 启动器。如果此标志设置为空字符串,系统会使用 JDK 启动器。“launcher”属性会替换此标志。
--java_runtime_version=<a string> 默认值:“local_jdk”
Java 运行时版本
已累计 --javacopt=<a string> 次多次使用
需要传递给 javac 的其他选项。
已累计 --jvmopt=<a string> 次多次使用
用于传递给 Java 虚拟机的其他选项。这些选项将添加到每个 java_binary 目标的虚拟机启动选项中。
--legacy_main_dex_list_generator=<a build target label> 默认值:请参阅说明
指定一个二进制文件,用于生成编译旧版 MultiDex 时必须位于主 dex 中的类列表。
已累计 --plugin=<a build target label> 次多次使用
要在 build 中使用的插件。目前可与 java_plugin 配合使用。
--proguard_top=<a build target label> 默认值:请参阅说明
指定在构建 Java 二进制文件时要使用哪种 ProGuard 版本移除代码。
--proto_compiler=<a build target label> 默认值:“@bazel_tools//tools/proto:protoc”
proto 编译器的标签。
标记:affects_outputsloading_and_analysis
--proto_toolchain_for_cc=<a build target label> 默认值:“@bazel_tools//tools/proto:cc_toolchain"
proto_lang_toolchain() 的标签,用于描述如何编译 C++ proto。
标记:affects_outputsloading_and_analysis
--proto_toolchain_for_j2objc=<a build target label> 默认值:“@bazel_tools//tools/j2objc:j2objc_proto_toolchain"
proto_lang_toolchain() 的标签,用于描述如何编译 j2objc protos
标记:affects_outputsloading_and_analysis
--proto_toolchain_for_java=<a build target label> 默认值:“@bazel_tools//tools/proto:java_toolchain"
proto_lang_toolchain() 的标签,用于描述如何编译 Java proto
标记:affects_outputsloading_and_analysis
--proto_toolchain_for_javalite=<a build target label> 默认值:“@bazel_tools//tools/proto:javalite_toolchain"
proto_lang_toolchain() 的标签,用于描述如何编译 JavaLite proto
标记:affects_outputsloading_and_analysis
已累计 --protocopt=<a string> 次多次使用
需要传递给 protobuf 编译器的其他选项。
标记: affects_outputs
--[no]runs_per_test_detects_flakes 默认值:“false”
如果为 true,则至少有一个运行/尝试通过且至少有一次运行/尝试失败的任何分片都会获得 FLAKY 状态。
--shell_executable=<a path> 默认值:请参阅说明
供 Bazel 使用的 shell 可执行文件的绝对路径。如果未设置此属性,但 BAZEL_SH 环境变量是在首次 Bazel 调用(启动 Bazel 服务器)时设置的,则 Bazel 会使用此变量。如果二者都未设置,则 Bazel 会使用硬编码的默认路径,具体取决于其运行的操作系统(Windows:c:/tools/msys64/usr/bin/bash.exe、FreeBSD:/usr/local/bin/bash,其他所有平台:/bin/bash)。请注意,使用与 bash 不兼容的 shell 可能会导致生成的二进制文件构建失败或运行时失败。
标记: loading_and_analysis
已累计 --test_arg=<a string> 次多次使用
指定应传递给测试可执行文件的其他选项和实参。可以多次使用指定多个参数。如果执行多个测试,每个测试都将收到相同的参数。仅供“bazel test”命令使用。
--test_filter=<a string> 默认值:请参阅说明
指定要转发到测试框架的过滤器。用于限制测试的运行。请注意,这不会影响构建哪些目标。
--test_result_expiration=<an integer> 默认值:“-1”
此选项已弃用,无效。
--[no]test_runner_fail_fast 默认值:“false”
将失败快速选项转发给测试运行程序。测试运行程序应在第一次失败时停止执行。
--test_sharding_strategy=<explicit or disabled> 默认值:“露骨内容”
指定测试分片策略:“露骨内容”,以便仅在存在“hard_count”BUILD 属性时才使用分片。“disabled”表示从不使用测试分片。
--tool_java_language_version=<a string> 默认值:“8”
用于执行构建期间所需工具的 Java 语言版本
--tool_java_runtime_version=<a string> 默认值:“remotejdk_11”
用于在构建期间执行工具的 Java 运行时版本
--[no]use_ijars 默认值:“true”
启用后,此选项会导致 Java 编译使用接口 JAR。这样可以加快增量编译的速度,但错误消息可能会有所不同。

转储选项

出现在命令之前并由客户端解析的选项:
已累计 --distdir=<a path> 次多次使用
在访问网络以下载归档文件之前,可在其他位置搜索归档文件。
标记: bazel_internal_configuration
如果已设置,代码库缓存将在缓存命中时对文件进行硬链接,而不是复制。这是为了节省磁盘空间。
标记: bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id 默认值:“false”
如果为 true,请使用从代码库下载网址派生的字符串作为 canonical_id(如果未指定)。这会导致网址发生变化,进而重新下载,即使缓存中包含具有相同哈希值的下载内容。这可用于验证网址更改不会导致损坏的代码库被缓存遮盖。
标记:loading_and_analysisexperimental
--[no]experimental_repository_disable_download 默认值:“false”
如果设置此参数,则不允许下载外部代码库。
标记: experimental
--experimental_repository_downloader_retries=<an integer> 默认值:“0”
重新尝试下载错误的最大尝试次数。如果设置为 0,系统会停用重试。
标记: experimental
--experimental_scale_timeouts=<a double> 默认值:“1.0”
按此系数扩缩 Starlark 代码库规则中的所有超时时间。通过这种方式,可以在不更改源代码的情况下使外部代码库在速度低于规则作者的机器上运行。
标记:bazel_internal_configurationexperimental
--http_timeout_scaling=<a double> 默认值:“1.0”
按指定系数调整与 HTTP 下载相关的所有超时
标记: bazel_internal_configuration
--repository_cache=<a path> 默认值:请参阅说明
指定在提取外部代码库期间获取的已下载值的缓存位置。使用空字符串作为参数会请求停用缓存。
标记: bazel_internal_configuration
用于控制命令输出的选项:
--[no]action_cache 默认值:“false”
转储操作缓存内容。
标记: bazel_monitoring
--[no]packages 默认值:“false”
转储软件包缓存内容。
标记: bazel_monitoring
--[no]rule_classes 默认值:“false”
转储规则类。
标记: bazel_monitoring
--[no]rules 默认值:“false”
转储规则,包括计数和内存用量(如果跟踪内存)。
标记: bazel_monitoring
--skyframe=<off, summary, count, deps or rdeps> 默认值:“off”
Dump Skyframe 图表:“off”、“summary”、“count”、“deps”或“rdeps”。
标记: bazel_monitoring
--skykey_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths> 默认值:“.*”
要输出的 SkyKey 名称的正则表达式过滤器。仅与 --skyframe=deps, rdeps 搭配使用。
标记: bazel_monitoring
--skylark_memory=<a string> 默认值:请参阅说明
将与 pprof 兼容的内存配置文件转储到指定路径。如需了解详情,请参阅 https://github.com/google/pprof。
标记: bazel_monitoring
影响 Bazel 强制执行有效 build 输入的严格程度的选项(规则定义、标志组合等):
--experimental_repository_hash_file=<a string> 默认值:“”
如果非空,请指定一个包含解析值的文件,应针对该值验证代码库目录哈希值
标记:affects_outputsexperimental
已累计 --experimental_verify_repository_rules=<a string> 次多次使用
如果要验证输出目录的哈希值的代码库规则列表,则要通过 --experimental_repo_hash_file 指定文件。
标记:affects_outputsexperimental
此选项会影响 Starlark 语言或 build 文件、.bzl 文件或 WORKSPACE 文件可访问的 build API 的语义。
--[no]experimental_allow_top_level_aspects_parameters 默认值:“true”
空操作
标记:no_opdeprecatedexperimental
与 Bzlmod 输出和语义相关的选项:
已累计 --allow_yanked_versions=<a string> 次多次使用
以 `<module1>@<version1>,<module2>@<version2>` 的形式指定模块版本,即使这些版本在来源的注册表中被声明了(如果它们不是来自 NonRegistryOverride),也会显示在已解析的依赖关系图中。否则,拉取版本将导致解析失败。您还可以使用 `BZLMOD_ALLOW_YANKED_VERSIONS` 环境变量定义允许的拖动版本。您可以使用关键字“all”停用此检查(不推荐)。
标记: loading_and_analysis
--check_bazel_compatibility=<error, warning or off> 默认值:“error”
检查 Bazel 模块的 Bazel 版本兼容性。有效值包括:“error”表示处理失败,“off”表示停用检查,“warning”表示检测到不匹配的情况时会显示警告。
标记: loading_and_analysis
--check_direct_dependencies=<off, warning or error> 默认值:“警告”
检查根模块中声明的直接“bazel_dep”依赖项是否与已解析的依赖关系图中的版本相同。有效值为 `off` 表示停用检查,`warning` 表示在检测到不匹配的情况时输出警告,或者是 `error`(用于将问题升级为解析失败)。
标记: loading_and_analysis
--[no]ignore_dev_dependency 默认值:“false”
如果为 true,Bazel 会忽略根模块的 MODULE.bazel 中声明为“dev_dependency”的“bazel_dep”和“use_extension”。请注意,无论此标志的值为何,只要不是根模块,MODULE.bazel 中就会始终忽略这些开发者依赖项。
标记: loading_and_analysis
--lockfile_mode=<off, update or error> 默认值:“off”
指定如何以及是否使用锁定文件。有效值包括:“update”表示使用 lockfile 并在发生变更时更新它;“error”表示使用 lockfile,但如果该文件不是最新状态,则会抛出错误;或者“off”表示既不从锁定文件读取数据,也不会向锁定文件写入数据。
标记: loading_and_analysis
已累计 --override_module=<an equals-separated mapping of module name to path> 次多次使用
替换采用 <模块名称>=<path> 形式的本地路径的模块。如果指定路径是绝对路径,系统将按原样使用该路径。如果指定路径是相对路径,则该路径相对于当前工作目录。如果指定路径以“%workspace%”开头,则该路径相对于工作区根目录,即“bazel info workspace”的输出
已累计 --registry=<a string> 次多次使用
指定用于查找 Bazel 模块依赖项的注册表。顺序很重要:系统会先在之前的注册表中查找模块,只有在之前的注册表中缺失模块时,才会回退到靠后的注册表。
标记: changes_inputs
影响日志记录的详细程度、格式或位置的选项:
--[no]experimental_record_metrics_for_all_mnemonics 默认值:“false”
默认情况下,操作类型的数量不得超过 20 种已执行操作数量最多的助记符。设置此选项会写入所有助记符的统计信息。
用于指定或更改不属于其他类别的 Bazel 命令的通用输入的选项:
--experimental_resolved_file_instead_of_workspace=<a string> 默认值:“”
如果为非空,则读取指定的已解析文件而不是 WORKSPACE 文件
标记: changes_inputs
远程缓存和执行选项:
--experimental_downloader_config=<a string> 默认值:请参阅说明
指定要用于配置远程下载程序的文件。此文件由几行组成,每个行都以指令(“allow”“block”或“rewrite”)开头,后跟主机名(分别用于“allow”和“block”)或两种格式,一种用于匹配,另一种用作替代网址,反向引用从“$1”开始。在这种情况下,系统可能会返回多个“rewrite”指令,供同一个网址提供,在这种情况下,系统会返回多个网址。
其他未分类的选项:
已累计 --override_repository=<an equals-separated mapping of repository name to path> 次多次使用
使用格式为 <repo name>=<path> 的本地路径替换代码库。如果指定路径是绝对路径,系统将按原样使用该路径。如果指定路径是相对路径,则该路径是相对于当前工作目录而言的。如果指定路径以“%workspace%”开头,则该路径相对于工作区根目录,即“bazel info workspace”的输出

提取选项

出现在命令之前并由客户端解析的选项:
已累计 --distdir=<a path> 次多次使用
在访问网络以下载归档文件之前,可在其他位置搜索归档文件。
标记: bazel_internal_configuration
如果已设置,代码库缓存将在缓存命中时对文件进行硬链接,而不是复制。这是为了节省磁盘空间。
标记: bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id 默认值:“false”
如果为 true,请使用从代码库下载网址派生的字符串作为 canonical_id(如果未指定)。这会导致网址发生变化,进而重新下载,即使缓存中包含具有相同哈希值的下载内容。这可用于验证网址更改不会导致损坏的代码库被缓存遮盖。
标记:loading_and_analysisexperimental
--[no]experimental_repository_disable_download 默认值:“false”
如果设置此参数,则不允许下载外部代码库。
标记: experimental
--experimental_repository_downloader_retries=<an integer> 默认值:“0”
重新尝试下载错误的最大尝试次数。如果设置为 0,系统会停用重试。
标记: experimental
--experimental_scale_timeouts=<a double> 默认值:“1.0”
按此系数扩缩 Starlark 代码库规则中的所有超时时间。通过这种方式,可以在不更改源代码的情况下使外部代码库在速度低于规则作者的机器上运行。
标记:bazel_internal_configurationexperimental
--http_timeout_scaling=<a double> 默认值:“1.0”
按指定系数调整与 HTTP 下载相关的所有超时
标记: bazel_internal_configuration
--repository_cache=<a path> 默认值:请参阅说明
指定在提取外部代码库期间获取的已下载值的缓存位置。使用空字符串作为参数会请求停用缓存。
标记: bazel_internal_configuration
用于控制构建执行的选项:
如果设为 true 且 --incompatible_remote_symlinks 也为 true,则操作输出中的符号链接可以悬挂。
标记:executionincompatible_change
如果设置为 true,则 Bazel 会在远程缓存/执行协议的操作输出中代表符号链接。否则,系统将追踪符号链接,并将其表示为文件或目录。如需了解详情,请参阅 #6631。
标记:executionincompatible_change
--[no]keep_going [-k] 默认值:“false”
出错后,应尽可能多地继续操作。虽然无法分析失败的目标以及依赖于该目标的目标,但这些目标的其他先决条件可以。
标记: eagerness_to_exit
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5"> 默认值:“auto”
用于加载/分析阶段的并行线程数。可接受整数或关键字(“auto”“HOST_CPUS”“HOST_RAM”),后面可视需要后跟操作 ([-|*]<float>),例如:"auto", "HOST_CPUS*.5"。“auto”根据主机资源设置合理的默认值。不得小于 1。
标记: bazel_internal_configuration
可让用户配置预期输出,从而影响预期输出值而非其存在的选项:
--bep_maximum_open_remote_upload_files=<an integer> 默认值:“-1”
上传 BEP 工件期间允许打开的文件数量上限。
标记: affects_outputs
--remote_download_minimal
不会将任何远程构建输出下载到本地机器。此标志是标志的快捷方式:--experimental_inmemory_jdeps_files、--experimental_inmemory_dotd_files、--experimental_action_cache_store_output_metadata 和 --remote_download_outputs=minimal。
扩展为:
  --nobuild_runfile_links
  --experimental_inmemory_jdeps_files
  --experimental_inmemory_dotd_files
  --experimental_action_cache_store_output_metadata
  --remote_download_outputs=minimal

标记: affects_outputs
--remote_download_outputs=<all, minimal or toplevel> 默认值:“all”
如果设置为“minimal”,系统不会将任何远程构建输出下载到本地机器,本地操作所需的输出除外。如果将此属性设置为 'toplevel',则其行为类似于'minimal',但也会将顶级目标的输出下载到本地计算机。如果网络带宽是瓶颈,那么这两种方案都可以显著缩短构建时间。
标记: affects_outputs
创建符号链接,而不是将远程构建输出下载到本地机器。您可以通过模板字符串形式指定符号链接的目标。此模板字符串可能包含 {hash} 和 {size_bytes},分别扩展为对象的哈希值和大小(以字节为单位)。例如,这些符号链接可能指向根据需要从 CAS 加载对象的 FUSE 文件系统。
标记: affects_outputs
--remote_download_toplevel
仅将顶级目标的远程输出下载到本地机器。此标志是标志的快捷方式:--experimental_inmemory_jdeps_files、--experimental_inmemory_dotd_files、--experimental_action_cache_store_output_metadata 和 --remote_download_outputs=toplevel。
可展开为:
  --experimental_inmemory_jdeps_files
  --experimental_inmemory_dotd_files
  --experimental_action_cache_store_output_metadata
  --remote_download_outputs=toplevel

标记:affects_outputs
影响 Bazel 强制执行有效 build 输入的严格程度的选项(规则定义、标志组合等):
--experimental_repository_hash_file=<a string> 默认值:“”
如果非空,请指定一个包含解析值的文件,应针对该值验证代码库目录哈希值
标记:affects_outputsexperimental
已累计 --experimental_verify_repository_rules=<a string> 次多次使用
如果要验证输出目录的哈希值的代码库规则列表,则要通过 --experimental_repo_hash_file 指定文件。
标记:affects_outputsexperimental
此选项会影响 Starlark 语言或 build 文件、.bzl 文件或 WORKSPACE 文件可访问的 build API 的语义。
--[no]experimental_allow_top_level_aspects_parameters 默认值:“true”
无操作
标记:no_opdeprecatedexperimental
--[no]incompatible_config_setting_private_default_visibility 默认值:“false”
如果 incompatible_enforce_config_setting_visibility=false,则代表着空操作。否则,如果此标志为 false,则没有明确可见性属性的任何 config_setting 都是 //visibility:public。如果此标志为 true,config_setting 遵循与所有其他规则相同的可见性逻辑。请参阅 https://github.com/bazelbuild/bazel/issues/12933。
标记:loading_and_analysisincompatible_change
--[no]incompatible_enforce_config_setting_visibility 默认值:“true”
如果为 true,则强制执行 config_setting 公开范围限制。如果为 false,则每个 config_setting 对每个目标都可见。请参阅 https://github.com/bazelbuild/bazel/issues/12932。
标记:loading_and_analysisincompatible_change
与 Bzlmod 输出和语义相关的选项:
已累计 --allow_yanked_versions=<a string> 次多次使用
以 `<module1>@<version1>,<module2>@<version2>` 的形式指定模块版本,即使这些版本在来源的注册表中被声明了(如果它们不是来自 NonRegistryOverride),也会显示在已解析的依赖关系图中。否则,拉取版本将导致解析失败。您还可以使用 `BZLMOD_ALLOW_YANKED_VERSIONS` 环境变量定义允许的拖动版本。您可以使用关键字“all”停用此检查(不推荐)。
标记: loading_and_analysis
--check_bazel_compatibility=<error, warning or off> 默认值:“error”
检查 Bazel 模块的 Bazel 版本兼容性。有效值包括:“error”表示处理失败,“off”表示停用检查,“warning”表示检测到不匹配的情况时会显示警告。
标记: loading_and_analysis
--check_direct_dependencies=<off, warning or error> 默认值:“警告”
检查根模块中声明的直接“bazel_dep”依赖项是否与已解析的依赖关系图中的版本相同。有效值为 `off` 表示停用检查,`warning` 表示在检测到不匹配的情况时输出警告,或者是 `error`(用于将问题升级为解析失败)。
标记: loading_and_analysis
--[no]ignore_dev_dependency 默认值:“false”
如果为 true,Bazel 会忽略根模块的 MODULE.bazel 中声明为“dev_dependency”的“bazel_dep”和“use_extension”。请注意,无论此标志的值为何,只要不是根模块,MODULE.bazel 中就会始终忽略这些开发者依赖项。
标记: loading_and_analysis
--lockfile_mode=<off, update or error> 默认值:“off”
指定如何以及是否使用锁定文件。有效值包括:“update”表示使用 lockfile 并在发生变更时更新它;“error”表示使用 lockfile,但如果该文件不是最新状态,则会抛出错误;或者“off”表示既不从锁定文件读取数据,也不会向锁定文件写入数据。
标记: loading_and_analysis
已累计 --override_module=<an equals-separated mapping of module name to path> 次多次使用
替换采用 <模块名称>=<path> 形式的本地路径的模块。如果指定路径是绝对路径,系统将按原样使用该路径。如果指定路径是相对路径,则该路径相对于当前工作目录。如果指定路径以“%workspace%”开头,则该路径相对于工作区根目录,即“bazel info workspace”的输出
已累计 --registry=<a string> 次多次使用
指定用于查找 Bazel 模块依赖项的注册表。顺序很重要:系统会先在之前的注册表中查找模块,只有在之前的注册表中缺失模块时,才会回退到靠后的注册表。
标记: changes_inputs
影响日志记录的详细程度、格式或位置的选项:
--[no]experimental_record_metrics_for_all_mnemonics 默认值:“false”
默认情况下,操作类型的数量不得超过 20 种已执行操作数量最多的助记符。设置此选项会写入所有助记符的统计信息。
--experimental_repository_resolved_file=<a string> 默认值:“”
如果为非空,则写入一个 Starlark 值,其中包含已执行的所有 Starlark 代码库规则的解析信息。
标记: affects_outputs
--remote_print_execution_messages=<failure, success or all> 默认值:“failure”
选择何时输出远程执行消息。有效值为“failure”,表示仅在失败时输出,用“success”表示仅在成功时输出,值为“all”,表示始终输出。
标记: terminal_output
用于指定或更改不属于其他类别的 Bazel 命令的通用输入的选项:
--experimental_resolved_file_instead_of_workspace=<a string> 默认值:“”
如果为非空,则读取指定的已解析文件而不是 WORKSPACE 文件
标记: changes_inputs
远程缓存和执行选项:
--experimental_circuit_breaker_strategy=<failure> 默认值:请参阅说明
指定断路器要使用的策略。可用策略为“失败”。选项的值无效时,与未设置此选项的行为相同。
标记: execution
--experimental_downloader_config=<a string> 默认值:请参阅说明
指定要用于配置远程下载程序的文件。此文件由几行组成,每个行都以指令(“allow”“block”或“rewrite”)开头,后跟主机名(分别用于“allow”和“block”)或两种格式,一种用于匹配,另一种用作替代网址,反向引用从“$1”开始。在这种情况下,系统可能会返回多个“rewrite”指令,供同一个网址提供,在这种情况下,系统会返回多个网址。
--[no]experimental_guard_against_concurrent_changes 默认值:“false”
关闭此设置可禁止在将操作上传到远程缓存之前检查其输入文件的 ctime。在某些情况下,Linux 内核会延迟写入文件,从而导致误报。
--experimental_remote_build_event_upload=<all or minimal> 默认值:“all”
如果设置为“all”,BEP 引用的所有本地输出都将上传到远程缓存。如果设置为“minimal”,则 BEP 引用的本地输出不会上传到远程缓存,但对 BEP 使用者很重要的文件(例如测试日志和计时配置文件)除外。即使文件在远程缓存中缺失,也会始终使用 bytestream:// 架构。 默认值为“all”。
--[no]experimental_remote_cache_async 默认值:“false”
如果为 true,远程缓存 I/O 将在后台进行,而不是在生成过程中进行。
--[no]experimental_remote_cache_compression 默认值:“false”
启用后,使用 zstd 压缩/解压缩缓存 blob。
--experimental_remote_capture_corrupted_outputs=<a path> 默认值:请参阅说明
将捕获损坏输出的目录的路径。
--[no]experimental_remote_discard_merkle_trees 默认值:“false”
如果设置为 true,则会在调用 GetActionResult() 和 Execute() 期间舍弃输入根的 Merkle 树和关联输入映射的内存中副本。这样可以显著减少内存用量,但需要 Bazel 在远程缓存未命中和重试时重新计算这些副本。
--experimental_remote_downloader=<a string> 默认值:请参阅说明
要用作远程下载代理的 Remote Asset API 端点 URI。支持的架构包括 grpc、grpcs(已启用 TLS 的 grpc)和 unix(本地 UNIX 套接字)。如果未提供架构,Bazel 将默认使用 grpc。请参阅:https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto
--[no]experimental_remote_downloader_local_fallback 默认值:“false”
如果远程下载程序失败,是否回退到本地下载程序。
--[no]experimental_remote_execution_keepalive 默认值:“false”
是否对远程执行调用使用 keepalive。
--experimental_remote_failure_rate_threshold=<an integer in 0-100 range> 默认值:“10”
设置特定时间范围内允许的失败率(以百分比表示),超过此时限后就会停止调用远程缓存/执行器。默认情况下,值为 10。将此值设为 0 表示无限制。
标记: execution
--experimental_remote_failure_window_interval=<An immutable length of time.> 默认值:“60s”
计算远程请求失败率的时间间隔。如果值为 0 或负值,则计算失败时长的总执行时长。可以使用以下单位:天 (d)、小时 (h)、分钟 (m)、秒 (s) 和毫秒 (ms)。如果省略单位,则值将解读为秒。
标记: execution
--[no]experimental_remote_mark_tool_inputs 默认值:“false”
如果设置为 true,Bazel 会将输入标记为远程执行程序的工具输入。这可用于实现远程持久性工作器。
--[no]experimental_remote_merkle_tree_cache 默认值:“false”
如果设置为 true,系统会记住 Merkle 树计算,以提高远程缓存命中检查速度。缓存的内存足迹由 --experimental_remote_merkle_tree_cache_size 控制。
--experimental_remote_merkle_tree_cache_size=<a long integer> 默认值:“1000”
为了提高远程缓存命中检查速度而要记忆的 Merkle 树数量。虽然缓存会根据 Java 对软引用的处理自动删减,但如果设置得过高,可能会出现内存不足错误。如果设置为 0,则缓存大小不受限制。最佳值因项目规模而异。默认值为 1,000。
--[no]experimental_remote_require_cached 默认值:“false”
如果设置为 true,系统会强制缓存所有可以远程运行的操作,否则会导致构建失败。这对于排查非确定性问题非常有用,因为它可以检查本应缓存的操作是否实际缓存,而不会错误地将新结果注入缓存。
--[no]incompatible_remote_build_event_upload_respect_no_cache 默认值:“false”
如果设置为 true,则在无法远程缓存生成的操作时,BEP 引用的输出不会上传到远程缓存。
--[no]incompatible_remote_downloader_send_all_headers 默认值:“true”
是否将一个多值标头的所有值(而不只是第一个值)发送给远程下载程序。
标记: incompatible_change
--[no]incompatible_remote_output_paths_relative_to_input_root 默认值:“false”
如果设置为 true,则输出路径将相对于输入根目录(而不是工作目录)。
标记: incompatible_change
--[no]incompatible_remote_results_ignore_disk 默认值:“true”
如果设置为 true,--noremote_upload_local_results 和 --noremote_accept_cached 将不会应用于磁盘缓存。如果使用组合缓存: --noremote_upload_local_results 将导致结果被写入磁盘缓存,但不会上传到远程缓存。 --noremote_accept_cached 则会导致 Bazel 检查磁盘缓存中的结果,但不会检查远程缓存中的结果。 no-remote-exec 操作可能会命中磁盘缓存。 如需了解详情,请参阅 #8216。
标记: incompatible_change
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs 默认值:“false”
如果设置为 true,那么当远程缓存在构建期间逐出 blob 时,Bazel 将使用新的退出代码 39(而不是 34)。
标记: incompatible_change
--[no]remote_accept_cached 默认值:“true”
是否接受远程缓存的操作结果。
--remote_bytestream_uri_prefix=<a string> 默认值:请参阅说明
在写入构建事件流的 bytestream:// URI 中使用的主机名和实例名称。使用代理执行构建时可以设置此选项,这会导致 --remote_executor 和 --remote_instance_name 的值不再与远程执行服务的规范名称相对应。如果未设置,则默认为“${hostname}/${instance_name}”。
--remote_cache=<a string> 默认值:请参阅说明
缓存端点的 URI。支持的架构包括 http、https、grpc、grpcs(已启用 TLS 的 grpc)和 unix(本地 UNIX 套接字)。如果未提供架构,Bazel 将默认使用 grpc。指定 grpc://、http:// 或 unix: 架构以停用 TLS。请参阅 https://bazel.build/remote/caching
已累计 --remote_cache_header=<a 'name=value' assignment> 次多次使用
指定要包含在缓存请求中的标头:--remote_cache_header=Name=Value。可以通过多次指定标志来传递多个标头。如果名称相同的多个值,系统会将其转换为以英文逗号分隔的列表。
已累计 --remote_default_exec_properties=<a 'name=value' assignment> 次多次使用
如果执行平台尚未设置 exec_properties,请设置要用作远程执行平台的默认 exec 属性。
标记: affects_outputs
--remote_default_platform_properties=<a string> 默认值:“”
如果执行平台尚未设置 remote_execution_properties,请设置要为远程执行 API 设置的默认平台属性。如果主机平台被选作远程执行的执行平台,也将使用此值。
已累计 --remote_downloader_header=<a 'name=value' assignment> 次多次使用
指定将在远程下载程序请求中包含的标头:--remote_downloader_header=Name=Value。可以通过多次指定标志来传递多个标头。如果名称相同的多个值,系统会将其转换为以英文逗号分隔的列表。
已累计 --remote_exec_header=<a 'name=value' assignment> 次多次使用
指定要包含在执行请求的标头:--remote_exec_header=Name=Value。可以通过多次指定标志来传递多个标头。如果名称相同的多个值,系统会将其转换为以英文逗号分隔的列表。
--remote_execution_priority=<an integer> 默认值:“0”
要远程执行的操作的相对优先级。特定优先级值的语义取决于服务器。
--remote_executor=<a string> 默认值:请参阅说明
远程执行端点的 HOST 或 HOST:PORT。支持的架构包括 grpc、grpcs(已启用 TLS 的 grpc)和 unix(本地 UNIX 套接字)。如果未提供架构,Bazel 将默认使用 grpc。指定 grpc:// 或 unix: 架构以停用 TLS。
--remote_grpc_log=<a path> 默认值:请参阅说明
如果指定,则为记录 gRPC 调用相关详细信息的文件的路径。此日志由一系列序列化的 com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry protobufs 组成,每条消息都带有一个 varint 前缀,表示以下序列化 protobuf 消息的大小,由 LogEntry.writeDelimitedTo(OutputStream) 方法执行。
已累计 --remote_header=<a 'name=value' assignment> 次多次使用
指定要包含在请求中的标头:--remote_header=Name=Value。可以通过多次指定标志来传递多个标头。如果名称相同的多个值,系统会将其转换为以英文逗号分隔的列表。
--remote_instance_name=<a string> 默认值:“”
在远程执行 API 中作为 instance_name 传递的值。
--[no]remote_local_fallback 默认值:“false”
如果远程执行失败,是否回退到独立的本地执行策略。
--remote_local_fallback_strategy=<a string> 默认值:“local”
无操作,已废弃。如需了解详情,请参阅 https://github.com/bazelbuild/bazel/issues/7480。
--remote_max_connections=<an integer> 默认值:“100”
限制远程缓存/执行器的并发连接数上限。默认情况下,该值为 100。将此值设为 0 表示无限制。 对于 HTTP 远程缓存,一个 TCP 连接一次可以处理一个请求,因此 Bazel 可以最多构建 --remote_max_connections 并发请求。 对于 gRPC 远程缓存/执行器,一个 gRPC 通道通常可以处理 100 多个并发请求,因此 Bazel 可以大约发出“--remote_max_connections * 100”个并发请求。
标记: host_machine_resource_optimizations
--remote_proxy=<a string> 默认值:请参阅说明
通过代理连接到远程缓存。目前,此标志只能用于配置 Unix 网域套接字 (unix:/path/to/socket)。
--remote_result_cache_priority=<an integer> 默认值:“0”
要存储在远程缓存中的远程操作的相对优先级。特定优先级值的语义取决于服务器。
--remote_retries=<an integer> 默认值:“5”
重试暂时性错误的最大尝试次数。如果设置为 0,系统会停用重试。
--remote_retry_max_delay=<An immutable length of time.> 默认值:“5s”
远程重试尝试之间的最大退避延迟时间。您可以使用以下单位:天 (d)、小时 (h)、分钟 (m)、秒 (s) 和毫秒 (ms)。如果省略单位,则值将解读为秒。
--remote_timeout=<An immutable length of time.> 默认值:“60s”
等待远程执行和缓存调用的最长时间。对于 REST 缓存,这是指连接和读取超时。您可以使用以下单位:天 (d)、小时 (h)、分钟 (m)、秒 (s) 和毫秒 (ms)。如果省略单位,则值将解读为秒。
--[no]remote_upload_local_results 默认值:“true”
决定是否将本地执行的操作结果上传到远程缓存(如果远程缓存支持且用户已获得执行此操作的授权)。
--[no]remote_verify_downloads 默认值:“true”
如果设置为 true,Bazel 会计算所有远程下载的哈希总和,并舍弃远程缓存的值(如果这些值与预期值不匹配)。
其他未分类的选项:
已累计 --credential_helper=<Path to a credential helper. It may be absolute, relative to the PATH environment variable, or %workspace%-relative. The path be optionally prefixed by a scope followed by an '='. The scope is a domain name, optionally with a single leading '*' wildcard component. A helper applies to URIs matching its scope, with more specific scopes preferred. If a helper has no scope, it applies to every URI.> 次多次使用
配置凭据帮助程序,用于检索代码库提取、远程缓存和执行以及构建事件服务的授权凭据。 帮助程序提供的凭据优先于 --google_default_credentials、--google_credentials、.netrc 文件或存储库 _ A 下载 和 库 _ . 下载和提取 的 auth 参数提供的凭据。 可以多次指定此参数以设置多个帮助程序。 如需了解详情,请参阅 https://github.com/bazelbuild/proposals/blob/main/designs/2022-06-07-bazel-credential-helpers.md。
--credential_helper_cache_duration=<An immutable length of time.> 默认值:“30m”
凭据帮助程序提供的凭据的缓存时长。 使用其他值调用将调整先前存在的条目的有效期;传递零可清除缓存。无论此标志为何,干净命令始终会清除缓存。
--credential_helper_timeout=<An immutable length of time.> 默认值:“10s”
配置凭据帮助程序的超时时间。 凭据帮助程序未能在此超时时间内响应将使调用失败。
--deleted_packages=<comma-separated list of package names> 默认值:“”
以逗号分隔的软件包名称列表,构建系统将其视为不存在的软件包名称,即使这些软件包在软件包路径上的某个位置可见。 当删除现有包“x”的子包“x/y”时,使用此选项。例如,在客户端中删除 x/y/BUILD 后,如果编译系统遇到标签“//x:y/z”(如果仍然由另一个 package_path 条目提供),则可能会收到错误消息。指定 --deleted_packages x/y 可避免此问题。
--disk_cache=<a path> 默认值:请参阅说明
一个目录的路径,Bazel 可以在该目录中读取和写入操作及操作输出。如果该目录不存在,系统将会创建该目录。
--google_auth_scopes=<comma-separated list of options> 默认值:“https://www.googleapis.com/auth/cloud-platform”
以逗号分隔的 Google Cloud 身份验证范围列表。
--google_credentials=<a string> 默认值:请参阅说明
指定从中获取身份验证凭据的文件。如需了解详情,请参阅 https://cloud.google.com/docs/authentication。
--[no]google_default_credentials 默认值:“false”
是否使用“Google 应用默认凭据”进行身份验证。如需了解详情,请参阅 https://cloud.google.com/docs/authentication。默认处于停用状态。
--grpc_keepalive_time=<An immutable length of time.> 默认值:请参阅说明
为传出 gRPC 连接配置 keep-alive ping。如果已设置,则 Bazel 会在连接上无读取操作这么长时间后发送 ping,但前提是至少有一个待处理的 gRPC 调用。时间被视为第二粒度;设置小于 1 秒的值是错误的。默认情况下, keep-alive ping 处于停用状态。在启用此设置前,请与服务所有者协调。例如,如需为此标志设置 30 秒的值,应按如下方式设置:--grpc_keepalive_time=30s
--grpc_keepalive_timeout=<An immutable length of time.> 默认值:“20s”
为传出 gRPC 连接配置 keep-alive 超时。如果通过 --grpc_keepalive_time 启用 keep-alive ping,则如果 Bazel 在这段时间后未收到 ping 回复,则会超时连接。时间被视为第二粒度;设置小于 1 秒的值是错误的。如果 keep-alive ping 处于停用状态,则忽略此设置。
已累计 --override_repository=<an equals-separated mapping of repository name to path> 次多次使用
使用格式为 <repo name>=<path> 的本地路径替换代码库。如果指定路径是绝对路径,系统将按原样使用该路径。如果指定路径是相对路径,则该路径是相对于当前工作目录而言的。如果指定路径以“%workspace%”开头,则该路径相对于工作区根目录,即“bazel info workspace”的输出
--package_path=<colon-separated list of options> 默认值:“%workspace%”
以英文冒号分隔的列表,用于列出查找软件包的位置。以“%workspace%”开头的元素相对于封闭工作区。如果省略或为空,则默认值为“bazel info default-package-path”的输出。
--[no]show_loading_progress 默认值:“true”
启用后,Bazel 会显示“正在加载软件包:”消息。
--tls_certificate=<a string> 默认值:请参阅说明
指定受信任 TLS 证书(用于对服务器证书进行签名)的路径。
--tls_client_certificate=<a string> 默认值:请参阅说明
指定要使用的 TLS 客户端证书;您还需要提供客户端密钥以启用客户端身份验证。
--tls_client_key=<a string> 默认值:请参阅说明
指定要使用的 TLS 客户端密钥;您还需要提供客户端证书以启用客户端身份验证。

帮助选项

出现在命令之前并由客户端解析的选项:
已累计 --distdir=<a path> 次多次使用
在访问网络以下载归档文件之前,可在其他位置搜索归档文件。
标记: bazel_internal_configuration
如果已设置,代码库缓存将在缓存命中时对文件进行硬链接,而不是复制。这是为了节省磁盘空间。
标记: bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id 默认值:“false”
如果为 true,请使用从代码库下载网址派生的字符串作为 canonical_id(如果未指定)。这会导致网址发生变化,进而重新下载,即使缓存中包含具有相同哈希值的下载内容。这可用于验证网址更改不会导致损坏的代码库被缓存遮盖。
标记:loading_and_analysisexperimental
--[no]experimental_repository_disable_download 默认值:“false”
如果设置此参数,则不允许下载外部代码库。
标记: experimental
--experimental_repository_downloader_retries=<an integer> 默认值:“0”
重新尝试下载错误的最大尝试次数。如果设置为 0,系统会停用重试。
标记: experimental
--experimental_scale_timeouts=<a double> 默认值:“1.0”
按此系数扩缩 Starlark 代码库规则中的所有超时时间。通过这种方式,可以在不更改源代码的情况下使外部代码库在速度低于规则作者的机器上运行。
标记:bazel_internal_configurationexperimental
--http_timeout_scaling=<a double> 默认值:“1.0”
按指定系数调整与 HTTP 下载相关的所有超时
标记: bazel_internal_configuration
--repository_cache=<a path> 默认值:请参阅说明
指定在提取外部代码库期间获取的已下载值的缓存位置。使用空字符串作为参数会请求停用缓存。
标记: bazel_internal_configuration
会影响 Bazel 强制执行有效 build 输入的严格程度的选项(规则定义、标志组合等):
--experimental_repository_hash_file=<a string> 默认值:“”
如果非空,请指定一个包含解析值的文件,应针对该值验证代码库目录哈希值
标记:affects_outputsexperimental
已累计 --experimental_verify_repository_rules=<a string> 次多次使用
如果要验证输出目录的哈希值的代码库规则列表,则要通过 --experimental_repo_hash_file 指定文件。
标记:affects_outputsexperimental
此选项会影响 Starlark 语言或 build 文件、.bzl 文件或 WORKSPACE 文件可访问的 build API 的语义。
--[no]experimental_allow_top_level_aspects_parameters 默认值:“true”
空操作
标记:no_opdeprecatedexperimental
与 Bzlmod 输出和语义相关的选项:
已累计 --allow_yanked_versions=<a string> 次多次使用
以 `<module1>@<version1>,<module2>@<version2>` 的形式指定模块版本,即使这些版本在来源的注册表中被声明了(如果它们不是来自 NonRegistryOverride),也会显示在已解析的依赖关系图中。否则,拉取版本将导致解析失败。您还可以使用 `BZLMOD_ALLOW_YANKED_VERSIONS` 环境变量定义允许的拖动版本。您可以使用关键字“all”停用此检查(不推荐)。
标记: loading_and_analysis
--check_bazel_compatibility=<error, warning or off> 默认值:“error”
检查 Bazel 模块的 Bazel 版本兼容性。有效值包括:“error”表示处理失败,“off”表示停用检查,“warning”表示检测到不匹配的情况时会显示警告。
标记: loading_and_analysis
--check_direct_dependencies=<off, warning or error> 默认值:“警告”
检查根模块中声明的直接“bazel_dep”依赖项是否与已解析的依赖关系图中的版本相同。有效值为 `off` 表示停用检查,`warning` 表示在检测到不匹配的情况时输出警告,或者是 `error`(用于将问题升级为解析失败)。
标记: loading_and_analysis
--[no]ignore_dev_dependency 默认值:“false”
如果为 true,Bazel 会忽略根模块的 MODULE.bazel 中声明为“dev_dependency”的“bazel_dep”和“use_extension”。请注意,无论此标志的值为何,只要不是根模块,MODULE.bazel 中就会始终忽略这些开发者依赖项。
标记: loading_and_analysis
--lockfile_mode=<off, update or error> 默认值:“off”
指定如何以及是否使用锁定文件。有效值包括:“update”表示使用 lockfile 并在发生变更时更新它;“error”表示使用 lockfile,但如果该文件不是最新状态,则会抛出错误;或者“off”表示既不从锁定文件读取数据,也不会向锁定文件写入数据。
标记: loading_and_analysis
已累计 --override_module=<an equals-separated mapping of module name to path> 次多次使用
替换采用 <模块名称>=<path> 形式的本地路径的模块。如果指定路径是绝对路径,系统将按原样使用该路径。如果指定路径是相对路径,则该路径相对于当前工作目录。如果指定路径以“%workspace%”开头,则该路径相对于工作区根目录,即“bazel info workspace”的输出
已累计 --registry=<a string> 次多次使用
指定用于查找 Bazel 模块依赖项的注册表。顺序很重要:系统会先在之前的注册表中查找模块,只有在之前的注册表中缺失模块时,才会回退到靠后的注册表。
标记: changes_inputs
影响日志记录的详细程度、格式或位置的选项:
--[no]experimental_record_metrics_for_all_mnemonics 默认值:“false”
默认情况下,操作类型的数量不得超过 20 种已执行操作数量最多的助记符。设置此选项会写入所有助记符的统计信息。
--help_verbosity=<long, medium or short> 默认值:“medium”
选择帮助命令的详细程度。
标记:affects_outputsterminal_output
--long [-l 个]
显示每个选项的完整说明,而不仅仅是其名称。
扩展为:
  --help_verbosity=long

标记:affects_outputsterminal_output
--short
仅显示选项名称,不显示选项类型或含义。
可展开为:
  --help_verbosity=short

标记: affects_outputsterminal_output
用于指定或更改不属于其他类别的 Bazel 命令的通用输入的选项:
--experimental_resolved_file_instead_of_workspace=<a string> 默认值:“”
如果为非空,则读取指定的已解析文件而不是 WORKSPACE 文件
标记: changes_inputs
远程缓存和执行选项:
--experimental_downloader_config=<a string> 默认值:请参阅说明
指定要用于配置远程下载程序的文件。此文件由几行组成,每个行都以指令(“allow”“block”或“rewrite”)开头,后跟主机名(分别用于“allow”和“block”)或两种格式,一种用于匹配,另一种用作替代网址,反向引用从“$1”开始。在这种情况下,系统可能会返回多个“rewrite”指令,供同一个网址提供,在这种情况下,系统会返回多个网址。
其他未分类的选项:
已累计 --override_repository=<an equals-separated mapping of repository name to path> 次多次使用
使用格式为 <repo name>=<path> 的本地路径替换代码库。如果指定路径是绝对路径,系统将按原样使用该路径。如果指定路径是相对路径,则该路径是相对于当前工作目录而言的。如果指定路径以“%workspace%”开头,则该路径相对于工作区根目录,即“bazel info workspace”的输出

信息选项

build 继承所有选项。

出现在命令之前并由客户端解析的选项:
已累计 --distdir=<a path> 次多次使用
在访问网络以下载归档文件之前,可在其他位置搜索归档文件。
标记: bazel_internal_configuration
如果已设置,代码库缓存将在缓存命中时对文件进行硬链接,而不是复制。这是为了节省磁盘空间。
标记: bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id 默认值:“false”
如果为 true,请使用从代码库下载网址派生的字符串作为 canonical_id(如果未指定)。这会导致网址发生变化,进而重新下载,即使缓存中包含具有相同哈希值的下载内容。这可用于验证网址更改不会导致损坏的代码库被缓存遮盖。
标记:loading_and_analysisexperimental
--[no]experimental_repository_disable_download 默认值:“false”
如果设置此参数,则不允许下载外部代码库。
标记: experimental
--experimental_repository_downloader_retries=<an integer> 默认值:“0”
重新尝试下载错误的最大尝试次数。如果设置为 0,系统会停用重试。
标记: experimental
--experimental_scale_timeouts=<a double> 默认值:“1.0”
按此系数扩缩 Starlark 代码库规则中的所有超时时间。通过这种方式,可以在不更改源代码的情况下使外部代码库在速度低于规则作者的机器上运行。
标记:bazel_internal_configurationexperimental
--http_timeout_scaling=<a double> 默认值:“1.0”
按指定系数调整与 HTTP 下载相关的所有超时
标记: bazel_internal_configuration
--repository_cache=<a path> 默认值:请参阅说明
指定在提取外部代码库期间获取的已下载值的缓存位置。使用空字符串作为参数会请求停用缓存。
标记: bazel_internal_configuration
会影响 Bazel 强制执行有效 build 输入的严格程度的选项(规则定义、标志组合等):
--experimental_repository_hash_file=<a string> 默认值:“”
如果非空,请指定一个包含解析值的文件,应针对该值验证代码库目录哈希值
标记:affects_outputsexperimental
已累计 --experimental_verify_repository_rules=<a string> 次多次使用
如果要验证输出目录的哈希值的代码库规则列表,则要通过 --experimental_repo_hash_file 指定文件。
标记:affects_outputsexperimental
此选项会影响 Starlark 语言或 build 文件、.bzl 文件或 WORKSPACE 文件可访问的 build API 的语义。
--[no]experimental_allow_top_level_aspects_parameters 默认值:“true”
空操作
标记:no_opdeprecatedexperimental
与 Bzlmod 输出和语义相关的选项:
已累计 --allow_yanked_versions=<a string> 次多次使用
以 `<module1>@<version1>,<module2>@<version2>` 的形式指定模块版本,即使这些版本在来源的注册表中被声明了(如果它们不是来自 NonRegistryOverride),也会显示在已解析的依赖关系图中。否则,拉取版本将导致解析失败。您还可以使用 `BZLMOD_ALLOW_YANKED_VERSIONS` 环境变量定义允许的拖动版本。您可以使用关键字“all”停用此检查(不推荐)。
标记: loading_and_analysis
--check_bazel_compatibility=<error, warning or off> 默认值:“error”
检查 Bazel 模块的 Bazel 版本兼容性。有效值包括:“error”表示处理失败,“off”表示停用检查,“warning”表示检测到不匹配的情况时会显示警告。
标记: loading_and_analysis
--check_direct_dependencies=<off, warning or error> 默认值:“警告”
检查根模块中声明的直接“bazel_dep”依赖项是否与已解析的依赖关系图中的版本相同。有效值为 `off` 表示停用检查,`warning` 表示在检测到不匹配的情况时输出警告,或者是 `error`(用于将问题升级为解析失败)。
标记: loading_and_analysis
--[no]ignore_dev_dependency 默认值:“false”
如果为 true,Bazel 会忽略根模块的 MODULE.bazel 中声明为“dev_dependency”的“bazel_dep”和“use_extension”。请注意,无论此标志的值为何,只要不是根模块,MODULE.bazel 中就会始终忽略这些开发者依赖项。
标记: loading_and_analysis
--lockfile_mode=<off, update or error> 默认值:“off”
指定如何以及是否使用锁定文件。有效值包括:“update”表示使用 lockfile 并在发生变更时更新它;“error”表示使用 lockfile,但如果该文件不是最新状态,则会抛出错误;或者“off”表示既不从锁定文件读取数据,也不会向锁定文件写入数据。
标记: loading_and_analysis
已累计 --override_module=<an equals-separated mapping of module name to path> 次多次使用
替换采用 <模块名称>=<path> 形式的本地路径的模块。如果指定路径是绝对路径,系统将按原样使用该路径。如果指定路径是相对路径,则该路径相对于当前工作目录。如果指定路径以“%workspace%”开头,则该路径相对于工作区根目录,即“bazel info workspace”的输出
已累计 --registry=<a string> 次多次使用
指定用于查找 Bazel 模块依赖项的注册表。顺序很重要:系统会先在之前的注册表中查找模块,只有在之前的注册表中缺失模块时,才会回退到靠后的注册表。
标记: changes_inputs
影响日志记录的详细程度、格式或位置的选项:
--[no]experimental_record_metrics_for_all_mnemonics 默认值:“false”
默认情况下,操作类型的数量不得超过 20 种已执行操作数量最多的助记符。设置此选项会写入所有助记符的统计信息。
--[no]show_make_env 默认值:“false”
在输出中添加“Make”环境。
标记:affects_outputsterminal_output
用于指定或更改 Bazel 命令的通用输入(不属于其他类别)的选项:
--experimental_resolved_file_instead_of_workspace=<a string> 默认值:“”
如果为非空,则读取指定的已解析文件而不是 WORKSPACE 文件
标记: changes_inputs
远程缓存和执行选项:
--experimental_downloader_config=<a string> 默认值:请参阅说明
指定要用于配置远程下载程序的文件。此文件由几行组成,每个行都以指令(“allow”“block”或“rewrite”)开头,后跟主机名(分别用于“allow”和“block”)或两种格式,一种用于匹配,另一种用作替代网址,反向引用从“$1”开始。在这种情况下,系统可能会返回多个“rewrite”指令,供同一个网址提供,在这种情况下,系统会返回多个网址。
其他未分类的选项:
已累计 --override_repository=<an equals-separated mapping of repository name to path> 次多次使用
使用格式为 <repo name>=<path> 的本地路径替换代码库。如果指定路径是绝对路径,系统将按原样使用该路径。如果指定路径是相对路径,则该路径是相对于当前工作目录而言的。如果指定路径以“%workspace%”开头,则该路径相对于工作区根目录,即“bazel info workspace”的输出

许可选项

出现在命令之前并由客户端解析的选项:
已累计 --distdir=<a path> 次多次使用
在访问网络以下载归档文件之前,可在其他位置搜索归档文件。
标记: bazel_internal_configuration
如果已设置,代码库缓存将在缓存命中时对文件进行硬链接,而不是复制。这是为了节省磁盘空间。
标记: bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id 默认值:“false”
如果为 true,请使用从代码库下载网址派生的字符串作为 canonical_id(如果未指定)。这会导致网址发生变化,进而重新下载,即使缓存中包含具有相同哈希值的下载内容。这可用于验证网址更改不会导致损坏的代码库被缓存遮盖。
标记:loading_and_analysisexperimental
--[no]experimental_repository_disable_download 默认值:“false”
如果设置此参数,则不允许下载外部代码库。
标记: experimental
--experimental_repository_downloader_retries=<an integer> 默认值:“0”
重新尝试下载错误的最大尝试次数。如果设置为 0,系统会停用重试。
标记: experimental
--experimental_scale_timeouts=<a double> 默认值:“1.0”
按此系数扩缩 Starlark 代码库规则中的所有超时时间。通过这种方式,可以在不更改源代码的情况下使外部代码库在速度低于规则作者的机器上运行。
标记:bazel_internal_configurationexperimental
--http_timeout_scaling=<a double> 默认值:“1.0”
按指定系数调整与 HTTP 下载相关的所有超时
标记: bazel_internal_configuration
--repository_cache=<a path> 默认值:请参阅说明
指定在提取外部代码库期间获取的已下载值的缓存位置。使用空字符串作为参数会请求停用缓存。
标记: bazel_internal_configuration
会影响 Bazel 强制执行有效 build 输入的严格程度的选项(规则定义、标志组合等):
--experimental_repository_hash_file=<a string> 默认值:“”
如果非空,请指定一个包含解析值的文件,应针对该值验证代码库目录哈希值
标记:affects_outputsexperimental
已累计 --experimental_verify_repository_rules=<a string> 次多次使用
如果要验证输出目录的哈希值的代码库规则列表,则要通过 --experimental_repo_hash_file 指定文件。
标记:affects_outputsexperimental
此选项会影响 Starlark 语言或 build 文件、.bzl 文件或 WORKSPACE 文件可访问的 build API 的语义。
--[no]experimental_allow_top_level_aspects_parameters 默认值:“true”
空操作
标记:no_opdeprecatedexperimental
与 Bzlmod 输出和语义相关的选项:
已累计 --allow_yanked_versions=<a string> 次多次使用
以 `<module1>@<version1>,<module2>@<version2>` 的形式指定模块版本,即使这些版本在来源的注册表中被声明了(如果它们不是来自 NonRegistryOverride),也会显示在已解析的依赖关系图中。否则,拉取版本将导致解析失败。您还可以使用 `BZLMOD_ALLOW_YANKED_VERSIONS` 环境变量定义允许的拖动版本。您可以使用关键字“all”停用此检查(不推荐)。
标记: loading_and_analysis
--check_bazel_compatibility=<error, warning or off> 默认值:“error”
检查 Bazel 模块的 Bazel 版本兼容性。有效值包括:“error”表示处理失败,“off”表示停用检查,“warning”表示检测到不匹配的情况时会显示警告。
标记: loading_and_analysis
--check_direct_dependencies=<off, warning or error> 默认值:“警告”
检查根模块中声明的直接“bazel_dep”依赖项是否与已解析的依赖关系图中的版本相同。有效值为 `off` 表示停用检查,`warning` 表示在检测到不匹配的情况时输出警告,或者是 `error`(用于将问题升级为解析失败)。
标记: loading_and_analysis
--[no]ignore_dev_dependency 默认值:“false”
如果为 true,Bazel 会忽略根模块的 MODULE.bazel 中声明为“dev_dependency”的“bazel_dep”和“use_extension”。请注意,无论此标志的值为何,只要不是根模块,MODULE.bazel 中就会始终忽略这些开发者依赖项。
标记: loading_and_analysis
--lockfile_mode=<off, update or error> 默认值:“off”
指定如何以及是否使用锁定文件。有效值包括:“update”表示使用 lockfile 并在发生变更时更新它;“error”表示使用 lockfile,但如果该文件不是最新状态,则会抛出错误;或者“off”表示既不从锁定文件读取数据,也不会向锁定文件写入数据。
标记: loading_and_analysis
已累计 --override_module=<an equals-separated mapping of module name to path> 次多次使用
替换采用 <模块名称>=<path> 形式的本地路径的模块。如果指定路径是绝对路径,系统将按原样使用该路径。如果指定路径是相对路径,则该路径相对于当前工作目录。如果指定路径以“%workspace%”开头,则该路径相对于工作区根目录,即“bazel info workspace”的输出
已累计 --registry=<a string> 次多次使用
指定用于查找 Bazel 模块依赖项的注册表。顺序很重要:系统会先在之前的注册表中查找模块,只有在之前的注册表中缺失模块时,才会回退到靠后的注册表。
标记: changes_inputs
影响日志记录的详细程度、格式或位置的选项:
--[no]experimental_record_metrics_for_all_mnemonics 默认值:“false”
默认情况下,操作类型的数量不得超过 20 种已执行操作数量最多的助记符。设置此选项会写入所有助记符的统计信息。
用于指定或更改不属于其他类别的 Bazel 命令的通用输入的选项:
--experimental_resolved_file_instead_of_workspace=<a string> 默认值:“”
如果为非空,则读取指定的已解析文件而不是 WORKSPACE 文件
标记: changes_inputs
远程缓存和执行选项:
--experimental_downloader_config=<a string> 默认值:请参阅说明
指定要用于配置远程下载程序的文件。此文件由几行组成,每个行都以指令(“allow”“block”或“rewrite”)开头,后跟主机名(分别用于“allow”和“block”)或两种格式,一种用于匹配,另一种用作替代网址,反向引用从“$1”开始。在这种情况下,系统可能会返回多个“rewrite”指令,供同一个网址提供,在这种情况下,系统会返回多个网址。
其他未分类的选项:
已累计 --override_repository=<an equals-separated mapping of repository name to path> 次多次使用
使用格式为 <repo name>=<path> 的本地路径替换代码库。如果指定路径是绝对路径,系统将按原样使用该路径。如果指定路径是相对路径,则该路径是相对于当前工作目录而言的。如果指定路径以“%workspace%”开头,则该路径相对于工作区根目录,即“bazel info workspace”的输出

移动设备安装选项

build 继承所有选项。

出现在命令之前并由客户端解析的选项:
已累计 --distdir=<a path> 次多次使用
在访问网络以下载归档文件之前,可在其他位置搜索归档文件。
标记: bazel_internal_configuration
如果已设置,代码库缓存将在缓存命中时对文件进行硬链接,而不是复制。这是为了节省磁盘空间。
标记: bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id 默认值:“false”
如果为 true,请使用从代码库下载网址派生的字符串作为 canonical_id(如果未指定)。这会导致网址发生变化,进而重新下载,即使缓存中包含具有相同哈希值的下载内容。这可用于验证网址更改不会导致损坏的代码库被缓存遮盖。
标记:loading_and_analysisexperimental
--[no]experimental_repository_disable_download 默认值:“false”
如果设置此参数,则不允许下载外部代码库。
标记: experimental
--experimental_repository_downloader_retries=<an integer> 默认值:“0”
重新尝试下载错误的最大尝试次数。如果设置为 0,系统会停用重试。
标记: experimental
--experimental_scale_timeouts=<a double> 默认值:“1.0”
按此系数扩缩 Starlark 代码库规则中的所有超时时间。通过这种方式,可以在不更改源代码的情况下使外部代码库在速度低于规则作者的机器上运行。
标记:bazel_internal_configurationexperimental
--http_timeout_scaling=<a double> 默认值:“1.0”
按指定系数调整与 HTTP 下载相关的所有超时
标记: bazel_internal_configuration
--repository_cache=<a path> 默认值:请参阅说明
指定在提取外部代码库期间获取的已下载值的缓存位置。使用空字符串作为参数会请求停用缓存。
标记: bazel_internal_configuration
用于控制构建执行的选项:
--mode=<classic, classic_internal_test_do_not_use or skylark> 默认值:“经典版”
选择如何运行移动安装。“classic”运行的是当前版本的移动安装。“skylark”使用新的 Starlark 版本,该版本支持 android_test。
标记:loading_and_analysisexecutionincompatible_change
用于配置用于执行操作的工具链的选项:
--adb=<a string> 默认值:“”
要用于“mobile-install”命令的 adb 二进制文件。如果未指定,则使用 Android SDK 中由 --android_sdk 命令行选项指定的 SDK(如果未指定 --android_sdk,则使用默认 SDK)。
标记: changes_inputs
用于控制命令输出的选项:
--[no]incremental 默认值:“false”
是否执行增量安装。如果为 true,则尝试通过读取要安装代码的设备的状态并使用该信息来避免不必要的额外工作。如果为 false(默认值),则始终执行完整安装。
标记: loading_and_analysis
--[no]split_apks 默认值:“false”
是否使用拆分 APK 在设备上安装和更新应用。仅适用于搭载 Marshmallow 或更高版本的设备
标记:loading_and_analysisaffects_outputs
可让用户配置预期输出(影响预期输出值而非其存在性)的选项:
已累计 --adb_arg=<a string> 次多次使用
要传递给 adb 的额外参数。通常用于指定要安装到的设备。
标记: action_command_lines
--debug_app
是否等待调试程序才能启动应用。
展开为:
  --start=DEBUG

标记: execution
--device=<a string> 默认值:“”
adb 设备序列号。如果未指定,系统将使用第一部设备。
标记: action_command_lines
--start=<no, cold, warm or debug> 默认值:“NO”
应用在安装后应如何启动。设置为 WARM,可在增量安装时保留并恢复应用状态。
标记: execution
--start_app
安装应用后是否启动应用。
可展开为:
  --start=COLD

标记: execution
会影响 Bazel 强制执行有效 build 输入的严格程度的选项(规则定义、标志组合等):
--experimental_repository_hash_file=<a string> 默认值:“”
如果非空,请指定一个包含解析值的文件,应针对该值验证代码库目录哈希值
标记:affects_outputsexperimental
已累计 --experimental_verify_repository_rules=<a string> 次多次使用
如果要验证输出目录的哈希值的代码库规则列表,则要通过 --experimental_repo_hash_file 指定文件。
标记:affects_outputsexperimental
此选项会影响 Starlark 语言或 build 文件、.bzl 文件或 WORKSPACE 文件可访问的 build API 的语义。
--[no]experimental_allow_top_level_aspects_parameters 默认值:“true”
空操作
标记:no_opdeprecatedexperimental
与 Bzlmod 输出和语义相关的选项:
已累计 --allow_yanked_versions=<a string> 次多次使用
以 `<module1>@<version1>,<module2>@<version2>` 的形式指定模块版本,即使这些版本在来源的注册表中被声明了(如果它们不是来自 NonRegistryOverride),也会显示在已解析的依赖关系图中。否则,拉取版本将导致解析失败。您还可以使用 `BZLMOD_ALLOW_YANKED_VERSIONS` 环境变量定义允许的拖动版本。您可以使用关键字“all”停用此检查(不推荐)。
标记: loading_and_analysis
--check_bazel_compatibility=<error, warning or off> 默认值:“error”
检查 Bazel 模块的 Bazel 版本兼容性。有效值包括:“error”表示处理失败,“off”表示停用检查,“warning”表示检测到不匹配的情况时会显示警告。
标记: loading_and_analysis
--check_direct_dependencies=<off, warning or error> 默认值:“警告”
检查根模块中声明的直接“bazel_dep”依赖项是否与已解析的依赖关系图中的版本相同。有效值为 `off` 表示停用检查,`warning` 表示在检测到不匹配的情况时输出警告,或者是 `error`(用于将问题升级为解析失败)。
标记: loading_and_analysis
--[no]ignore_dev_dependency 默认值:“false”
如果为 true,Bazel 会忽略根模块的 MODULE.bazel 中声明为“dev_dependency”的“bazel_dep”和“use_extension”。请注意,无论此标志的值为何,只要不是根模块,MODULE.bazel 中就会始终忽略这些开发者依赖项。
标记: loading_and_analysis
--lockfile_mode=<off, update or error> 默认值:“off”
指定如何以及是否使用锁定文件。有效值包括:“update”表示使用 lockfile 并在发生变更时更新它;“error”表示使用 lockfile,但如果该文件不是最新状态,则会抛出错误;或者“off”表示既不从锁定文件读取数据,也不会向锁定文件写入数据。
标记: loading_and_analysis
已累计 --override_module=<an equals-separated mapping of module name to path> 次多次使用
替换采用 <模块名称>=<path> 形式的本地路径的模块。如果指定路径是绝对路径,系统将按原样使用该路径。如果指定路径是相对路径,则该路径相对于当前工作目录。如果指定路径以“%workspace%”开头,则该路径相对于工作区根目录,即“bazel info workspace”的输出
已累计 --registry=<a string> 次多次使用
指定用于查找 Bazel 模块依赖项的注册表。顺序很重要:系统会先在之前的注册表中查找模块,只有在之前的注册表中缺失模块时,才会回退到靠后的注册表。
标记: changes_inputs
影响日志记录的详细程度、格式或位置的选项:
--[no]experimental_record_metrics_for_all_mnemonics 默认值:“false”
默认情况下,操作类型的数量不得超过 20 种已执行操作数量最多的助记符。设置此选项会写入所有助记符的统计信息。
--incremental_install_verbosity=<a string> 默认值:“”
增量安装的详细程度。对于调试日志记录,设置为 1。
标记: bazel_monitoring
用于指定或更改不属于其他类别的 Bazel 命令的通用输入的选项:
--experimental_resolved_file_instead_of_workspace=<a string> 默认值:“”
如果为非空,则读取指定的已解析文件而不是 WORKSPACE 文件
标记: changes_inputs
远程缓存和执行选项:
--experimental_downloader_config=<a string> 默认值:请参阅说明
指定要用于配置远程下载程序的文件。此文件由几行组成,每个行都以指令(“allow”“block”或“rewrite”)开头,后跟主机名(分别用于“allow”和“block”)或两种格式,一种用于匹配,另一种用作替代网址,反向引用从“$1”开始。在这种情况下,系统可能会返回多个“rewrite”指令,供同一个网址提供,在这种情况下,系统会返回多个网址。
其他未分类的选项:
已累计 --override_repository=<an equals-separated mapping of repository name to path> 次多次使用
使用格式为 <repo name>=<path> 的本地路径替换代码库。如果指定路径是绝对路径,系统将按原样使用该路径。如果指定路径是相对路径,则该路径是相对于当前工作目录而言的。如果指定路径以“%workspace%”开头,则该路径相对于工作区根目录,即“bazel info workspace”的输出

强化包选项

出现在命令之前并由客户端解析的选项:
已累计 --distdir=<a path> 次多次使用
在访问网络以下载归档文件之前,可在其他位置搜索归档文件。
标记: bazel_internal_configuration
如果已设置,代码库缓存将在缓存命中时对文件进行硬链接,而不是复制。这是为了节省磁盘空间。
标记: bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id 默认值:“false”
如果为 true,请使用从代码库下载网址派生的字符串作为 canonical_id(如果未指定)。这会导致网址发生变化,进而重新下载,即使缓存中包含具有相同哈希值的下载内容。这可用于验证网址更改不会导致损坏的代码库被缓存遮盖。
标记:loading_and_analysisexperimental
--[no]experimental_repository_disable_download 默认值:“false”
如果设置此参数,则不允许下载外部代码库。
标记: experimental
--experimental_repository_downloader_retries=<an integer> 默认值:“0”
重新尝试下载错误的最大尝试次数。如果设置为 0,系统会停用重试。
标记: experimental
--experimental_scale_timeouts=<a double> 默认值:“1.0”
按此系数扩缩 Starlark 代码库规则中的所有超时时间。通过这种方式,可以在不更改源代码的情况下使外部代码库在速度低于规则作者的机器上运行。
标记:bazel_internal_configurationexperimental
--http_timeout_scaling=<a double> 默认值:“1.0”
按指定系数调整与 HTTP 下载相关的所有超时
标记: bazel_internal_configuration
--repository_cache=<a path> 默认值:请参阅说明
指定在提取外部代码库期间获取的已下载值的缓存位置。使用空字符串作为参数会请求停用缓存。
标记: bazel_internal_configuration
用于控制构建执行的选项:
--[no]keep_going [-k] 默认值:“false”
出错后,应尽可能多地继续操作。虽然无法分析失败的目标以及依赖于该目标的目标,但这些目标的其他先决条件可以。
标记: eagerness_to_exit
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5"> 默认值:“auto”
用于加载/分析阶段的并行线程数。可接受整数或关键字(“auto”“HOST_CPUS”“HOST_RAM”),后面可视需要后跟操作 ([-|*]<float>),例如:"auto", "HOST_CPUS*.5"。“auto”根据主机资源设置合理的默认值。不得小于 1。
标记: bazel_internal_configuration
会影响 Bazel 强制执行有效 build 输入的严格程度的选项(规则定义、标志组合等):
--experimental_repository_hash_file=<a string> 默认值:“”
如果非空,请指定一个包含解析值的文件,应针对该值验证代码库目录哈希值
标记:affects_outputsexperimental
已累计 --experimental_verify_repository_rules=<a string> 次多次使用
如果要验证输出目录的哈希值的代码库规则列表,则要通过 --experimental_repo_hash_file 指定文件。
标记:affects_outputsexperimental
此选项会影响 Starlark 语言或 build 文件、.bzl 文件或 WORKSPACE 文件可访问的 build API 的语义。
--[no]experimental_allow_top_level_aspects_parameters 默认值:“true”
无操作
标记:no_opdeprecatedexperimental
--[no]incompatible_config_setting_private_default_visibility 默认值:“false”
如果 incompatible_enforce_config_setting_visibility=false,则代表着空操作。否则,如果此标志为 false,则没有明确可见性属性的任何 config_setting 都是 //visibility:public。如果此标志为 true,config_setting 遵循与所有其他规则相同的可见性逻辑。请参阅 https://github.com/bazelbuild/bazel/issues/12933。
标记:loading_and_analysisincompatible_change
--[no]incompatible_enforce_config_setting_visibility 默认值:“true”
如果为 true,则强制执行 config_setting 公开范围限制。如果为 false,则每个 config_setting 对每个目标都可见。请参阅 https://github.com/bazelbuild/bazel/issues/12932。
标记:loading_and_analysisincompatible_change
与“mod”子命令的输出和语义相关的选项:
--base_module=<"<root>" for the root module; <module>@<version> for a specific version of a module; <module> for all versions of a module; @<name> for a repo with the given apparent name; or @@<name> for a repo with the given canonical name> 默认值:“<root>”
指定与指定的目标代码库进行解释的模块。
标记: terminal_output
--charset=<utf8 or ascii> 默认值:“utf8”
选择要用于树的字符集。仅影响文本输出。有效值为“utf8”或“ascii”。默认值为“utf8”
标记:terminal_output
--[no]cycles 默认值:“false”
指出所显示树内的依赖项循环(默认情况下,这些循环通常会被忽略)。
标记: terminal_output
--depth=<an integer> 默认值:“-1”
依赖项树的最大显示深度。例如,深度为 1 可显示直接依赖项。对于树、path 和 all_path,它默认为 Integer.MAX_VALUE;而对于 deps 并说明,则默认为 1(除了目标叶子及其父级之外,仅显示根的直接依赖项)。
标记: terminal_output
--extension_filter=<a comma-separated list of <extension>s> 默认值:请参阅说明
只有在设置了这些模块扩展各自的标志的情况下,才会显示这些模块扩展及其生成的代码库的使用情况。如果设置了此字段,结果图表将只包含使用指定扩展名的模块的路径。空列表会停用过滤器,实际上是指定所有可能的扩展名。
标记: terminal_output
--extension_info=<hidden, usages, repos or all> 默认值:“隐藏”
指定要包含在查询结果中的扩展程序使用情况的详细信息。“Usages”仅显示扩展程序名称,“repos”还将包含使用 use_repo 导入的代码库,“all”还会显示扩展程序生成的其他代码库。
标记: terminal_output
--extension_usages=<a comma-separated list of <module>s> 默认值:“”
指定在 show_extension 查询中显示其扩展程序使用情况的模块。
标记: terminal_output
--from=<a comma-separated list of <module>s> 默认值:“<root>”
显示依赖关系图查询的起始模块。请检查每个查询的说明,了解确切的语义。默认为 <root>。
标记:terminal_output
--[no]include_builtin 默认值:“false”
在依赖关系图中添加内置模块。噪声过大,因此默认处于停用状态。
标记: terminal_output
--[no]include_unused 默认值:“false”
查询还会考虑并显示未使用的模块,这些模块在选择后不会出现在模块分辨率图中(由于最低版本选择或替换规则)。这可能会对每种查询类型产生不同的影响,例如在 all_paths 命令中包含新路径,或在说明命令中包含额外的依赖项。
标记: terminal_output
--output=<text, json or graph> 默认值:“text”
应以哪种格式输出查询结果。允许的查询值包括:text、json、graph
标记: terminal_output
--[no]verbose 默认值:“false”
查询还会显示模块被解析为当前版本的原因(如果已更改)。仅针对说明查询默认设为 true。
标记: terminal_output
与 Bzlmod 输出和语义相关的选项:
已累计 --allow_yanked_versions=<a string> 次多次使用
以 `<module1>@<version1>,<module2>@<version2>` 的形式指定模块版本,即使这些版本在来源的注册表中被声明了(如果它们不是来自 NonRegistryOverride),也会显示在已解析的依赖关系图中。否则,拉取版本将导致解析失败。您还可以使用 `BZLMOD_ALLOW_YANKED_VERSIONS` 环境变量定义允许的拖动版本。您可以使用关键字“all”停用此检查(不推荐)。
标记: loading_and_analysis
--check_bazel_compatibility=<error, warning or off> 默认值:“error”
检查 Bazel 模块的 Bazel 版本兼容性。有效值包括:“error”表示处理失败,“off”表示停用检查,“warning”表示检测到不匹配的情况时会显示警告。
标记: loading_and_analysis
--check_direct_dependencies=<off, warning or error> 默认值:“警告”
检查根模块中声明的直接“bazel_dep”依赖项是否与已解析的依赖关系图中的版本相同。有效值为 `off` 表示停用检查,`warning` 表示在检测到不匹配的情况时输出警告,或者是 `error`(用于将问题升级为解析失败)。
标记: loading_and_analysis
--[no]ignore_dev_dependency 默认值:“false”
如果为 true,Bazel 会忽略根模块的 MODULE.bazel 中声明为“dev_dependency”的“bazel_dep”和“use_extension”。请注意,无论此标志的值为何,只要不是根模块,MODULE.bazel 中就会始终忽略这些开发者依赖项。
标记: loading_and_analysis
--lockfile_mode=<off, update or error> 默认值:“off”
指定如何以及是否使用锁定文件。有效值包括:“update”表示使用 lockfile 并在发生变更时更新它;“error”表示使用 lockfile,但如果该文件不是最新状态,则会抛出错误;或者“off”表示既不从锁定文件读取数据,也不会向锁定文件写入数据。
标记: loading_and_analysis
已累计 --override_module=<an equals-separated mapping of module name to path> 次多次使用
替换采用 <模块名称>=<path> 形式的本地路径的模块。如果指定路径是绝对路径,系统将按原样使用该路径。如果指定路径是相对路径,则该路径相对于当前工作目录。如果指定路径以“%workspace%”开头,则该路径相对于工作区根目录,即“bazel info workspace”的输出
已累计 --registry=<a string> 次多次使用
指定用于查找 Bazel 模块依赖项的注册表。顺序很重要:系统会先在之前的注册表中查找模块,只有在之前的注册表中缺失模块时,才会回退到靠后的注册表。
标记: changes_inputs
影响日志记录的详细程度、格式或位置的选项:
--[no]experimental_record_metrics_for_all_mnemonics 默认值:“false”
默认情况下,操作类型的数量不得超过 20 种已执行操作数量最多的助记符。设置此选项会写入所有助记符的统计信息。
用于指定或更改不属于其他类别的 Bazel 命令的通用输入的选项:
--experimental_resolved_file_instead_of_workspace=<a string> 默认值:“”
如果为非空,则读取指定的已解析文件而不是 WORKSPACE 文件
标记: changes_inputs
远程缓存和执行选项:
--experimental_downloader_config=<a string> 默认值:请参阅说明
指定要用于配置远程下载程序的文件。此文件由几行组成,每个行都以指令(“allow”“block”或“rewrite”)开头,后跟主机名(分别用于“allow”和“block”)或两种格式,一种用于匹配,另一种用作替代网址,反向引用从“$1”开始。在这种情况下,系统可能会返回多个“rewrite”指令,供同一个网址提供,在这种情况下,系统会返回多个网址。
其他未分类的选项:
--deleted_packages=<comma-separated list of package names> 默认值:“”
以逗号分隔的软件包名称列表,构建系统将其视为不存在的软件包名称,即使这些软件包在软件包路径上的某个位置可见。 当删除现有包“x”的子包“x/y”时,使用此选项。例如,在客户端中删除 x/y/BUILD 后,如果编译系统遇到标签“//x:y/z”(如果仍然由另一个 package_path 条目提供),则可能会收到错误消息。指定 --deleted_packages x/y 可避免此问题。
已累计 --override_repository=<an equals-separated mapping of repository name to path> 次多次使用
使用格式为 <repo name>=<path> 的本地路径替换代码库。如果指定路径是绝对路径,系统将按原样使用该路径。如果指定路径是相对路径,则该路径是相对于当前工作目录而言的。如果指定路径以“%workspace%”开头,则该路径相对于工作区根目录,即“bazel info workspace”的输出
--package_path=<colon-separated list of options> 默认值:“%workspace%”
以英文冒号分隔的列表,用于列出查找软件包的位置。以“%workspace%”开头的元素相对于封闭工作区。如果省略或为空,则默认值为“bazel info default-package-path”的输出。
--[no]show_loading_progress 默认值:“true”
启用后,Bazel 会显示“正在加载软件包:”消息。

build 继承所有选项。

出现在命令之前并由客户端解析的选项:
已累计 --distdir=<a path> 次多次使用
在访问网络以下载归档文件之前,可在其他位置搜索归档文件。
标记: bazel_internal_configuration
如果已设置,代码库缓存将在缓存命中时对文件进行硬链接,而不是复制。这是为了节省磁盘空间。
标记: bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id 默认值:“false”
如果为 true,请使用从代码库下载网址派生的字符串作为 canonical_id(如果未指定)。这会导致网址发生变化,进而重新下载,即使缓存中包含具有相同哈希值的下载内容。这可用于验证网址更改不会导致损坏的代码库被缓存遮盖。
标记:loading_and_analysisexperimental
--[no]experimental_repository_disable_download 默认值:“false”
如果设置此参数,则不允许下载外部代码库。
标记: experimental
--experimental_repository_downloader_retries=<an integer> 默认值:“0”
重新尝试下载错误的最大尝试次数。如果设置为 0,系统会停用重试。
标记: experimental
--experimental_scale_timeouts=<a double> 默认值:“1.0”
按此系数扩缩 Starlark 代码库规则中的所有超时时间。通过这种方式,可以在不更改源代码的情况下使外部代码库在速度低于规则作者的机器上运行。
标记:bazel_internal_configuration