bazel [<startup options>] <command> [<args>]
bazel [<startup options>] <command> [<args>] -- [<target patterns>]
Sintaxis de las opciones
Las opciones se pueden pasar a Bazel de diferentes maneras. Las opciones que requieren un valor se pueden pasar con un signo igual o un espacio:
--<option>=<value> --<option> <value>
-<short_form> <value>
Las opciones booleanas se pueden habilitar de la siguiente manera:
--<option> --<option>=[true|yes|1]
--no<option> --<option>=[false|no|0]
Las opciones de tres estados suelen establecerse en automático de forma predeterminada y se pueden habilitar de forma forzada de la siguiente manera:
--<option>=[true|yes|1]
--no<option> --<option>=[false|no|0]
Comandos
analyze-profile |
Analiza los datos del perfil de compilación. |
aquery |
Analiza los objetivos proporcionados y consulta el gráfico de acción. |
build |
Compila los destinos especificados. |
canonicalize-flags |
Normaliza una lista de opciones de Bazel. |
clean |
Quita los archivos de salida y, de manera opcional, detiene el servidor. |
coverage |
Genera un informe de cobertura de código para los destinos de prueba especificados. |
cquery |
Carga, analiza y consulta los destinos especificados con las configuraciones. |
dump |
Volca el estado interno del proceso del servidor de Bazel. |
fetch |
Recupera los repositorios externos que son requisitos previos para los destinos. |
help |
Imprime ayuda para los comandos o el índice. |
info |
Muestra información del tiempo de ejecución sobre el servidor de Bazel. |
license |
Imprime la licencia de este software. |
mobile-install |
Instala destinos en dispositivos móviles. |
mod |
Consulta el gráfico de dependencias externas de Bzlmod |
print_action |
Imprime los argumentos de la línea de comandos para compilar un archivo. |
query |
Ejecuta una consulta de gráfico de dependencias. |
run |
Ejecuta el destino especificado. |
shutdown |
Detiene el servidor de Bazel. |
sync |
Sincroniza todos los repositorios especificados en el archivo del espacio de trabajo |
test |
Compila y ejecuta los destinos de prueba especificados. |
version |
Imprime la información de la versión de Bazel. |
Opciones de inicio
- Opciones que aparecen antes del comando y que el cliente analiza:
--[no]autodetect_server_javabase
predeterminado: "true"-
Cuando se pasa --noautodetect_server_javabase, Bazel no recurre al JDK local para ejecutar el servidor de Bazel y, en cambio, sale.
Etiquetas:affects_outputs
,loses_incremental_state
--[no]batch
predeterminado: "false"-
Si se configura, Bazel se ejecutará solo como un proceso cliente sin un servidor, en lugar de en el modo cliente/servidor estándar. Este método está en desuso y se quitará. Si deseas evitar que queden servidores inactivos, te recomendamos que apagues el servidor de forma explícita.
Etiquetas:loses_incremental_state
,bazel_internal_configuration
,deprecated
--[no]batch_cpu_scheduling
predeterminado: "false"-
Solo en Linux; usa la programación de CPU por lotes para Blaze. Esta política es útil para cargas de trabajo no interactivas, pero que no desean reducir su valor de nice. Consulta “man 2 sched_setscheduler”. Si es falso, Bazel no realiza una llamada al sistema.
Etiquetas:host_machine_resource_optimizations
--bazelrc=<path>
valor predeterminado: consulta la descripción-
Ubicación del archivo .bazelrc del usuario que contiene los valores predeterminados de las opciones de Bazel. /dev/null indica que se ignorarán todos los demás `--bazelrc`, lo que resulta útil para inhabilitar la búsqueda de un archivo rc del usuario, p.ej., en compilaciones de lanzamiento.
Esta opción también se puede especificar varias veces.
p.ej., con `--bazelrc=x.rc --bazelrc=y.rc --bazelrc=/dev/null --bazelrc=z.rc`, 1) se leen x.rc e y.rc.
2) Se ignora z.rc debido a la prioridad de /dev/null.
Si no se especifica, Bazel usa el primer archivo .bazelrc que encuentra en las siguientes dos ubicaciones: el directorio del espacio de trabajo y, luego, el directorio principal del usuario.
Nota: Las opciones de la línea de comandos siempre reemplazarán cualquier opción en bazelrc.
Etiquetas:changes_inputs
--[no]block_for_lock
predeterminado: "true"-
Cuando se pasa --noblock_for_lock, Bazel no espera a que se complete un comando en ejecución, sino que sale de inmediato.
Etiquetas:eagerness_to_exit
--[no]client_debug
predeterminado: "false"-
Si es verdadero, se registra la información de depuración del cliente en stderr. Cambiar esta opción no reiniciará el servidor.
Etiquetas:affects_outputs
,bazel_monitoring
--connect_timeout_secs=<an integer>
predeterminado: "30"-
Cantidad de tiempo que espera el cliente en cada intento de conexión al servidor
Etiquetas:bazel_internal_configuration
--[no]expand_configs_in_place
predeterminado: "true"-
Se cambió la expansión de las marcas --config para que se realice en el lugar, en lugar de en una expansión de punto fijo entre las opciones de rc normales y las opciones especificadas en la línea de comandos.
Etiquetas:no_op
,deprecated
--failure_detail_out=<path>
valor predeterminado: consulta la descripción-
Si se configura, especifica una ubicación para escribir un mensaje failure_detail de protobuf si el servidor experimenta una falla y no puede informarla a través de gRPC, como es normal. De lo contrario, la ubicación será ${OUTPUT_BASE}/failure_detail.rawproto.
Etiquetas:affects_outputs
,loses_incremental_state
--[no]home_rc
predeterminado: "true"-
Indica si se debe buscar el archivo .bazelrc principal en $HOME/.bazelrc
Etiquetas:changes_inputs
--[no]idle_server_tasks
predeterminado: "true"-
Ejecuta System.gc() cuando el servidor esté inactivo
Etiquetas:loses_incremental_state
,host_machine_resource_optimizations
--[no]ignore_all_rc_files
predeterminado: "false"-
Inhabilita todos los archivos .rc, independientemente de los valores de otras marcas que modifican el archivo .rc, incluso si estas marcas aparecen más adelante en la lista de opciones de inicio.
Etiquetas:changes_inputs
- Valor predeterminado de
--io_nice_level={-1,0,1,2,3,4,5,6,7}
: "-1" -
Solo en Linux; establece un nivel de 0 a 7 para la programación de E/S con el mejor esfuerzo posible a través de la llamada al sistema sys_ioprio_set. El 0 es la prioridad más alta y el 7, la más baja. El programador anticipatorio solo puede cumplir con prioridades de hasta 4. Si se establece en un valor negativo, Bazel no realiza una llamada al sistema.
Etiquetas:host_machine_resource_optimizations
--local_startup_timeout_secs=<an integer>
valor predeterminado: "120"-
Es la cantidad máxima de tiempo que el cliente espera para conectarse al servidor.
Etiquetas:bazel_internal_configuration
--macos_qos_class=<a string>
predeterminado: "default"-
Establece la clase de servicio de QoS del servidor de Bazel cuando se ejecuta en macOS. Esta marca no tiene efecto en las demás plataformas, pero se admite para garantizar que los archivos rc se puedan compartir entre ellas sin cambios. Los valores posibles son: user-interactive, user-initiated, default, utility y background.
Etiquetas:host_machine_resource_optimizations
--max_idle_secs=<integer>
predeterminado: "10800"-
Cantidad de segundos que el servidor de compilación esperará en estado de inactividad antes de apagarse. El valor cero significa que el servidor nunca se apagará. Esta opción solo se lee al iniciar el servidor, por lo que cambiarla no hará que se reinicie.
Etiquetas:eagerness_to_exit
,loses_incremental_state
--output_base=<path>
valor predeterminado: consulta la descripción-
Si se configura, especifica la ubicación de salida en la que se escribirá toda la salida de la compilación. De lo contrario, la ubicación será ${OUTPUT_ROOT}/_blaze_${USER}/${MD5_OF_WORKSPACE_ROOT}. Nota: Si especificas una opción diferente de una invocación a la siguiente de Bazel para este valor, es probable que inicies un servidor de Bazel nuevo y adicional. Bazel inicia exactamente un servidor por cada base de salida especificada. Por lo general, hay una base de salida por espacio de trabajo. Sin embargo, con esta opción, puedes tener varias bases de salida por espacio de trabajo y, de este modo, ejecutar varias compilaciones para el mismo cliente en la misma máquina de forma simultánea. Consulta "bazel help shutdown" para saber cómo detener un servidor de Bazel.
Etiquetas:affects_outputs
,loses_incremental_state
--output_user_root=<path>
valor predeterminado: consulta la descripción-
Es el directorio específico del usuario en el que se escriben todos los resultados de la compilación. De forma predeterminada, es una función de $USER, pero, si se especifica una constante, los resultados de la compilación se pueden compartir entre los usuarios que colaboran.
Etiquetas:affects_outputs
,loses_incremental_state
--[no]preemptible
predeterminado: "false"-
Si es verdadero, el comando se puede interrumpir si se inicia otro comando.
Etiquetas:eagerness_to_exit
--server_jvm_out=<path>
valor predeterminado: consulta la descripción-
Ubicación en la que se escribirá el resultado de la JVM del servidor. Si no se configura, se establece de forma predeterminada en una ubicación en output_base.
Etiquetas:affects_outputs
,loses_incremental_state
--[no]shutdown_on_low_sys_mem
predeterminado: "false"-
Si se establece max_idle_secs y el servidor de compilación ha estado inactivo durante un tiempo, apaga el servidor cuando el sistema tenga poca RAM libre. Solo en Linux.
Etiquetas:eagerness_to_exit
,loses_incremental_state
--[no]system_rc
predeterminado: "true"-
Indica si se debe buscar el archivo bazelrc de todo el sistema.
Etiquetas:changes_inputs
--[no]unlimit_coredumps
predeterminado: "false"-
Aumenta el límite flexible de volcado de memoria al límite fijo para que los volcados de memoria del servidor (incluida la JVM) y del cliente sean posibles en condiciones comunes. Agrega esta marca a tu archivo bazelrc una vez y olvídate de ella para que obtengas volcados de memoria cuando realmente encuentres una condición que los active.
Etiquetas:bazel_internal_configuration
--[no]watchfs
predeterminado: "false"-
Si es verdadero, Bazel intenta usar el servicio de supervisión de archivos del sistema operativo para detectar cambios locales en lugar de analizar cada archivo en busca de cambios.
Etiquetas:deprecated
--[no]windows_enable_symlinks
predeterminado: "false"-
Si es verdadero, se crearán vínculos simbólicos reales en Windows en lugar de copiar archivos. Requiere que se habilite el modo de desarrollador de Windows y Windows 10, versión 1703 o posterior.
Etiquetas:bazel_internal_configuration
--[no]workspace_rc
predeterminado: "true"-
Indica si se debe buscar el archivo bazelrc del espacio de trabajo en $workspace/.bazelrc
Etiquetas:changes_inputs
- Se acumulan los usos múltiples de
--host_jvm_args=<jvm_arg>
- Son marcas para pasar a la JVM que ejecuta Blaze.
--host_jvm_debug
-
Opción conveniente para agregar algunas marcas de inicio de JVM adicionales, que hacen que la JVM espere durante el inicio hasta que te conectes desde un depurador compatible con JDWP (como Eclipse) al puerto 5005.
Se expande a:
--host_jvm_args=-Xdebug
--host_jvm_args=-Xrunjdwp:transport=dt_socket,server=y,address=5005
- Valor predeterminado de
--host_jvm_profile=<profiler_name>
: "" - Opción de conveniencia para agregar algunas marcas de inicio de JVM específicas del generador de perfiles o el depurador. Bazel tiene una lista de valores conocidos que asigna a marcas de inicio de JVM codificadas, y es posible que busque algunas rutas codificadas para ciertos archivos.
- Valor predeterminado de
--server_javabase=<jvm path>
: "" - Ruta de acceso a la JVM que se usa para ejecutar Bazel.
Opciones comunes a todos los comandos
- Opciones que controlan la ejecución de la compilación:
--experimental_oom_more_eagerly_threshold=<an integer>
valor predeterminado: "100"-
Si esta marca se establece en un valor inferior a 100, Bazel se quedará sin memoria si, después de dos GC completos, aún se ocupa más de este porcentaje del montón (gen antiguo).
Etiquetas:host_machine_resource_optimizations
--experimental_ui_max_stdouterr_bytes=<an integer in (-1)-1073741819 range>
predeterminado: "1048576"-
Es el tamaño máximo de los archivos stdout / stderr que se imprimirán en la consola. El valor -1 implica que no hay límite.
Tags:execution
- Opciones que configuran la cadena de herramientas que se usa para la ejecución de acciones:
--[no]incompatible_enable_proto_toolchain_resolution
predeterminado: "false"-
Si es verdadero, las reglas de lenguaje proto definen cadenas de herramientas de los repositorios rules_proto, rules_java y rules_cc.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
- Se acumulan los usos múltiples de
--repo_env=<a 'name=value' assignment with an optional value part>
-
Especifica variables de entorno adicionales que solo estarán disponibles para las reglas del repositorio. Ten en cuenta que las reglas del repositorio ven el entorno completo de todos modos, pero, de esta manera, la información de configuración se puede pasar a los repositorios a través de opciones sin invalidar el gráfico de acciones.
Etiquetas:action_command_lines
- Opciones que afectan la rigidez con la que Bazel aplica las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
--[no]check_bzl_visibility
predeterminado: "true"-
Si se inhabilita, los errores de visibilidad de carga de .bzl se degradan a advertencias.
Etiquetas:build_file_semantics
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]enable_bzlmod
predeterminado: "false"-
Si es verdadero, habilita el sistema de administración de dependencias de Bzlmod, que tiene prioridad sobre WORKSPACE. Consulta https://bazel.build/docs/bzlmod para obtener más información.
Etiquetas:loading_and_analysis
--[no]experimental_action_resource_set
predeterminado: "true"-
Si se establece en verdadero, ctx.actions.run() y ctx.actions.run_shell() aceptan un parámetro resource_set para la ejecución local. De lo contrario, se establecerá de forma predeterminada en 250 MB de memoria y 1 CPU.
Etiquetas:execution
,build_file_semantics
,experimental
-
Si se establece como verdadero, las etiquetas se propagarán desde un destino a los requisitos de ejecución de las acciones; de lo contrario, no se propagarán. Consulta https://github.com/bazelbuild/bazel/issues/8830 para obtener más información.
Etiquetas:build_file_semantics
,experimental
--[no]experimental_analysis_test_call
predeterminado: "true"-
Si se establece como verdadero, la llamada nativa de analysis_test está disponible.
Etiquetas:loading_and_analysis
,build_file_semantics
,experimental
--[no]experimental_bzl_visibility
predeterminado: "true"-
Si está habilitado, agrega una función `visibility()` a la que los archivos .bzl pueden llamar durante la evaluación de nivel superior para establecer su visibilidad a los efectos de las instrucciones load().
Etiquetas:loading_and_analysis
,experimental
-
Si se establece como verdadero, los atributos de regla y los métodos de la API de Starlark necesarios para la regla cc_shared_library estarán disponibles.
Etiquetas:build_file_semantics
,loading_and_analysis
,experimental
--[no]experimental_disable_external_package
predeterminado: "false"-
Si se establece en verdadero, el paquete //external generado automáticamente ya no estará disponible. Bazel no podrá analizar el archivo "external/BUILD", pero los globs que lleguen a external/ desde el paquete sin nombre funcionarán.
Etiquetas:loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_enable_android_migration_apis
predeterminado: "false"-
Si se configura como verdadero, se habilitan las APIs necesarias para admitir la migración de Starlark de Android.
Etiquetas:build_file_semantics
--[no]experimental_get_fixed_configured_action_env
predeterminado: "false"-
Si está habilitado, action.env también devolverá variables de entorno fijas especificadas a través de la configuración de funciones.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_google_legacy_api
predeterminado: "false"-
Si se configura como verdadero, expone una serie de elementos experimentales de la API de compilación de Starlark relacionados con el código heredado de Google.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_isolated_extension_usages
predeterminado: "false"-
Si es verdadero, habilita el parámetro <code>isolate</code> en la función <a href="https://bazel.build/rules/lib/globals/module#use_extension"><code>use_extension</code></a>.
Etiquetas:loading_and_analysis
--[no]experimental_lazy_template_expansion
predeterminado: "true"-
Si se configura como verdadero, ctx.actions.expand_template() acepta un parámetro TemplateDict para la evaluación diferida de los valores de sustitución.
Etiquetas:execution
,build_file_semantics
,experimental
--[no]experimental_platforms_api
predeterminado: "false"-
Si se establece como verdadero, habilita varias APIs de Starlark relacionadas con la plataforma que son útiles para la depuración.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repo_remote_exec
predeterminado: "false"-
Si se establece como verdadero, repository_rule adquiere algunas capacidades de ejecución remota.
Etiquetas:build_file_semantics
,loading_and_analysis
,experimental
--[no]experimental_sibling_repository_layout
predeterminado: "false"-
Si se establece como verdadero, los repositorios que no son principales se plantan como vínculos simbólicos al repositorio principal en la raíz de ejecución. Es decir, todos los repositorios son elementos secundarios directos del directorio $output_base/execution_root. Esto tiene el efecto secundario de liberar $output_base/execution_root/__main__/external para el directorio "external" real de nivel superior.
Etiquetas:action_command_lines
,bazel_internal_configuration
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]incompatible_always_check_depset_elements
predeterminado: "true"-
Verifica la validez de los elementos agregados a los depsets en todos los constructores. Los elementos deben ser inmutables, pero, históricamente, el constructor depset(direct=…) olvidó realizar la verificación. Usa tuplas en lugar de listas en los elementos de depset. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/10313.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_depset_for_libraries_to_link_getter
predeterminado: "true"-
Cuando es verdadero, Bazel ya no devuelve una lista de linking_context.libraries_to_link, sino que devuelve un depset.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_disable_objc_library_transition
predeterminado: "false"-
Inhabilita la transición personalizada de objc_library y hereda del destino de nivel superior.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_disable_starlark_host_transitions
predeterminado: "false"-
Si se establece como verdadero, los atributos de regla no pueden establecer "cfg = "host"". En su lugar, las reglas deben establecer "cfg = "exec"".
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_disable_target_provider_fields
predeterminado: "false"-
Si se configura como verdadero, se inhabilita la capacidad de acceder a los proveedores en objetos "target" a través de la sintaxis de campos. En su lugar, usa la sintaxis de clave del proveedor. Por ejemplo, en lugar de usar `ctx.attr.dep.my_info` para acceder a `my_info` desde dentro de una función de implementación de reglas, usa `ctx.attr.dep[MyInfo]`. Consulta https://github.com/bazelbuild/bazel/issues/9014 para obtener más detalles.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_disallow_empty_glob
predeterminado: "false"-
Si se establece como verdadero, el valor predeterminado del argumento "allow_empty" de glob() es False.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_disallow_legacy_javainfo
predeterminado: "true"-
Obsoleto. No se realiza ninguna operación.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_disallow_struct_provider_syntax
predeterminado: "false"-
Si se establece como verdadero, es posible que las funciones de implementación de reglas no devuelvan una struct. En su lugar, deben devolver una lista de instancias del proveedor.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_enable_deprecated_label_apis
predeterminado: "true"-
Si se habilita, se pueden usar ciertas APIs obsoletas (native.repository_name, Label.workspace_name, Label.relative).
Etiquetas:loading_and_analysis
--[no]incompatible_existing_rules_immutable_view
predeterminado: "true"-
Si se configura como verdadero, native.existing_rule y native.existing_rules devuelven objetos de vista inmutables y ligeros en lugar de diccionarios mutables.
Etiquetas:build_file_semantics
,loading_and_analysis
,incompatible_change
--[no]incompatible_fail_on_unknown_attributes
predeterminado: "false"-
Si está habilitado, fallarán los objetivos que tengan atributos desconocidos establecidos en None.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_fix_package_group_reporoot_syntax
predeterminado: "true"-
En el atributo "packages" de package_group, cambia el significado del valor "//…" para que haga referencia a todos los paquetes del repositorio actual en lugar de a todos los paquetes de cualquier repositorio. Puedes usar el valor especial "public" en lugar de "//…" para obtener el comportamiento anterior. Esta marca requiere que también se habilite --incompatible_package_group_has_public_syntax.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_java_common_parameters
predeterminado: "true"-
Si se configura como verdadero, se quitarán los parámetros output_jar y host_javabase en pack_sources, y host_javabase en compile.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_merge_fixed_and_default_shell_env
predeterminado: "false"-
Si está habilitado, las acciones registradas con ctx.actions.run y ctx.actions.run_shell con "env" y "use_default_shell_env = True" especificados usarán un entorno obtenido del entorno de shell predeterminado anulando con los valores pasados a "env". Si está inhabilitado, el valor de "env" se ignora por completo en este caso.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_new_actions_api
predeterminado: "true"-
Si se configura como verdadero, la API para crear acciones solo está disponible en "ctx.actions", no en "ctx".
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_no_attr_license
predeterminado: "true"-
Si se establece como verdadero, inhabilita la función `attr.license`.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_no_implicit_file_export
predeterminado: "false"-
Si se configura, los archivos fuente (usados) son privados del paquete, a menos que se exporten de forma explícita. Consulta https://github.com/bazelbuild/proposals/blob/master/designs/2019-10-24-file-visibility.md.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_no_rule_outputs_param
predeterminado: "false"-
Si se configura como verdadero, inhabilita el parámetro "outputs" de la función "rule()" de Starlark.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_package_group_has_public_syntax
predeterminado: "true"-
En el atributo "packages" de package_group, permite escribir "public" o "private" para hacer referencia a todos los paquetes o a ninguno, respectivamente.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_require_linker_input_cc_api
predeterminado: "true"-
Si se configura como verdadero, la regla create_linking_context requerirá linker_inputs en lugar de libraries_to_link. Los métodos get antiguos de linking_context también se inhabilitarán y solo estarán disponibles los linker_inputs.
Etiquetas:build_file_semantics
,loading_and_analysis
,incompatible_change
--[no]incompatible_run_shell_command_string
predeterminado: "true"-
Si se establece como verdadero, el parámetro de comando de actions.run_shell solo aceptará cadenas.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_stop_exporting_language_modules
predeterminado: "false"-
Si está habilitado, ciertos módulos específicos del idioma (como `cc_common`) no están disponibles en los archivos .bzl del usuario y solo se pueden llamar desde sus respectivos repositorios de reglas.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_struct_has_no_methods
predeterminado: "false"-
Inhabilita los métodos to_json y to_proto de struct, que contaminan el espacio de nombres del campo struct. En su lugar, usa json.encode o json.encode_indent para JSON, o bien proto.encode_text para textproto.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_top_level_aspects_require_providers
predeterminado: "false"-
Si se configura como verdadero, el aspecto de nivel superior respetará sus proveedores obligatorios y solo se ejecutará en los objetivos de nivel superior cuyos proveedores anunciados por las reglas satisfagan los proveedores obligatorios del aspecto.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_unambiguous_label_stringification
predeterminado: "true"-
Cuando es verdadero, Bazel convertirá la etiqueta @//foo:bar en @//foo:bar, en lugar de //foo:bar. Esto solo afecta el comportamiento de str(), el operador % y demás; el comportamiento de repr() no cambia. Consulta https://github.com/bazelbuild/bazel/issues/15916 para obtener más información.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_use_cc_configure_from_rules_cc
predeterminado: "false"-
Cuando es verdadero, Bazel ya no permitirá usar cc_configure desde @bazel_tools. Consulta https://github.com/bazelbuild/bazel/issues/10134 para obtener detalles e instrucciones de migración.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_visibility_private_attributes_at_definition
predeterminado: "true"-
Si se establece en verdadero, la visibilidad de los atributos de reglas privadas se verifica con respecto a la definición de la regla y se recurre al uso de la regla si no es visible.
Etiquetas:build_file_semantics
,incompatible_change
--max_computation_steps=<a long integer>
predeterminado: "0"-
Es la cantidad máxima de pasos de cálculo de Starlark que puede ejecutar un archivo BUILD (cero significa que no hay límite).
Etiquetas:build_file_semantics
--nested_set_depth_limit=<an integer>
valor predeterminado: "3500"-
Es la profundidad máxima del gráfico interno de un depset (también conocido como NestedSet), por encima de la cual fallará el constructor de depset().
Etiquetas:loading_and_analysis
- Opciones que activan optimizaciones del tiempo de compilación:
--[no]incompatible_do_not_split_linking_cmdline
predeterminado: "true"-
Cuando es verdadero, Bazel ya no modifica las marcas de la línea de comandos que se usan para la vinculación y tampoco decide de forma selectiva qué marcas van al archivo de parámetros y cuáles no. Consulta https://github.com/bazelbuild/bazel/issues/7670 para obtener más información.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]keep_state_after_build
predeterminado: "true"-
Si es falso, Blaze descartará el estado en memoria de esta compilación cuando finalice. Las compilaciones posteriores no tendrán ninguna incrementalidad con respecto a esta.
Etiquetas:loses_incremental_state
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Es una marca para la configuración avanzada del motor interno Skyframe de Bazel. Si Bazel detecta que el uso del porcentaje de montón retenido es al menos este umbral, descartará el estado temporal innecesario de Skyframe. Ajustar este parámetro puede permitirte mitigar el impacto del tiempo real de la fluctuación del GC, cuando esta se debe (i) al uso de memoria de este estado temporal y (ii) es más costosa que reconstituir el estado cuando se necesita.
Etiquetas:host_machine_resource_optimizations
--[no]track_incremental_state
predeterminado: "true"-
Si es falso, Blaze no conservará los datos que permitan la invalidación y la reevaluación en las compilaciones incrementales para ahorrar memoria en esta compilación. Las compilaciones posteriores no tendrán ninguna incrementalidad con respecto a esta. Por lo general, querrás especificar --batch cuando establezcas este valor como falso.
Etiquetas:loses_incremental_state
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]announce_rc
predeterminado: "false"-
Indica si se deben anunciar las opciones de rc.
Etiquetas:affects_outputs
--[no]attempt_to_print_relative_paths
predeterminado: "false"-
Cuando se imprime la parte de la ubicación de los mensajes, se intenta usar una ruta de acceso relativa al directorio del espacio de trabajo o a uno de los directorios especificados por --package_path.
Etiquetas:terminal_output
- Valor predeterminado de
--bes_backend=<a string>
: "" -
Especifica el extremo de backend del servicio de eventos de compilación (BES) en el formato [SCHEME://]HOST[:PORT]. La opción predeterminada es inhabilitar las cargas de BES. Los esquemas admitidos son grpc y grpcs (grpc con TLS habilitado). Si no se proporciona ningún esquema, Bazel supone que es grpcs.
Etiquetas:affects_outputs
--[no]bes_check_preceding_lifecycle_events
predeterminado: "false"-
Establece el campo check_preceding_lifecycle_events_present en PublishBuildToolEventStreamRequest, que le indica a BES que verifique si anteriormente recibió eventos InvocationAttemptStarted y BuildEnqueued que coincidan con el evento de herramienta actual.
Etiquetas:affects_outputs
- Se acumulan los usos múltiples de
--bes_header=<a 'name=value' assignment>
-
Especifica un encabezado en formato NOMBRE=VALOR que se incluirá en las solicitudes de BES. Se pueden pasar varios encabezados especificando la marca varias veces. Los valores múltiples para el mismo nombre se convertirán en una lista separada por comas.
Etiquetas:affects_outputs
--bes_instance_name=<a string>
valor predeterminado: consulta la descripción-
Especifica el nombre de la instancia con la que el BES conservará el BEP subido. El valor predeterminado es nulo.
Etiquetas:affects_outputs
- Se acumulan los usos múltiples de
--bes_keywords=<comma-separated list of options>
-
Especifica una lista de palabras clave de notificación que se agregarán al conjunto predeterminado de palabras clave publicadas en BES ("command_name=<command_name> ", "protocol_name=BEP"). El valor predeterminado es none.
Etiquetas:affects_outputs
--[no]bes_lifecycle_events
predeterminado: "true"-
Especifica si se publicarán eventos de ciclo de vida de BES. (el valor predeterminado es "true").
Etiquetas:affects_outputs
--bes_oom_finish_upload_timeout=<An immutable length of time.>
predeterminado: "10 m"-
Especifica cuánto tiempo debe esperar Bazel a que se complete la carga de BES/BEP mientras se produce un error por falta de memoria. Esta marca garantiza la finalización cuando la JVM está realizando una recolección de basura excesiva y no puede avanzar en ningún subproceso del usuario.
Etiquetas:bazel_monitoring
--bes_outerr_buffer_size=<an integer>
predeterminado: "10240"-
Especifica el tamaño máximo de stdout o stderr que se almacenará en el búfer de BEP antes de que se informe como un evento de progreso. Las escrituras individuales se siguen registrando en un solo evento, incluso si son más grandes que el valor especificado hasta --bes_outerr_chunk_size.
Etiquetas:affects_outputs
--bes_outerr_chunk_size=<an integer>
predeterminado: "1048576"-
Especifica el tamaño máximo de stdout o stderr que se enviará a BEP en un solo mensaje.
Etiquetas:affects_outputs
--bes_proxy=<a string>
valor predeterminado: consulta la descripción- Conéctate al servicio de eventos de compilación a través de un proxy. Actualmente, esta marca solo se puede usar para configurar un socket de dominio Unix (unix:/ruta/al/socket).
- Valor predeterminado de
--bes_results_url=<a string>
: "" -
Especifica la URL base en la que un usuario puede ver la información transmitida al backend del BES. Bazel enviará a la terminal la URL a la que se adjuntó el ID de invocación.
Etiquetas:terminal_output
--bes_timeout=<An immutable length of time.>
predeterminado: "0s"-
Especifica cuánto tiempo debe esperar Bazel a que se complete la carga de BES/BEP después de que finalicen la compilación y las pruebas. Un tiempo de espera válido es un número natural seguido de una unidad: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). El valor predeterminado es "0", lo que significa que no hay tiempo de espera.
Etiquetas:affects_outputs
- Valor predeterminado de
--build_event_binary_file=<a string>
: "" -
Si no está vacío, escribe una representación binaria delimitada por varint de la representación del protocolo de eventos de compilación en ese archivo. Esta opción implica --bes_upload_mode=wait_for_upload_complete.
Etiquetas:affects_outputs
--[no]build_event_binary_file_path_conversion
predeterminado: "true"-
Convierte las rutas de la representación del archivo binario del protocolo de eventos de compilación en URIs más válidos a nivel global siempre que sea posible. Si se inhabilita, siempre se usará el esquema de URI file://.
Etiquetas:affects_outputs
- Valor predeterminado de
--build_event_json_file=<a string>
: "" -
Si no está vacío, escribe una serialización JSON del protocolo de eventos de compilación en ese archivo.
Etiquetas:affects_outputs
--[no]build_event_json_file_path_conversion
predeterminado: "true"-
Convierte las rutas de acceso en la representación del archivo JSON del protocolo de eventos de compilación en URIs más válidos a nivel global siempre que sea posible. Si esta opción está inhabilitada, siempre se usará el esquema de URI file://.
Etiquetas:affects_outputs
- Valor predeterminado de
--build_event_max_named_set_of_file_entries=<an integer>
: "-1" -
Es la cantidad máxima de entradas para un solo evento named_set_of_files. Se ignoran los valores inferiores a 2 y no se realiza ninguna división de eventos. Esto tiene como objetivo limitar el tamaño máximo del evento en el protocolo de eventos de compilación, aunque no controla directamente el tamaño del evento. El tamaño total del evento es una función de la estructura del conjunto, así como de las longitudes del archivo y el URI, que a su vez pueden depender de la función hash.
Etiquetas:affects_outputs
--[no]build_event_publish_all_actions
predeterminado: "false"-
Indica si se deben publicar todas las acciones.
Etiquetas:affects_outputs
- Valor predeterminado de
--build_event_text_file=<a string>
: "" -
Si no está vacío, escribe una representación textual del protocolo de eventos de compilación en ese archivo.
Etiquetas:affects_outputs
--[no]build_event_text_file_path_conversion
predeterminado: "true"-
Convierte las rutas de acceso en la representación de archivo de texto del protocolo de eventos de compilación en URIs más válidos a nivel global siempre que sea posible. Si esta opción está inhabilitada, siempre se usará el esquema de URI file://.
Etiquetas:affects_outputs
--[no]experimental_announce_profile_path
predeterminado: "false"-
Si está habilitado, agrega la ruta de acceso del perfil JSON al registro.
Etiquetas:affects_outputs
,bazel_monitoring
--[no]experimental_bep_target_summary
predeterminado: "false"- Indica si se publicarán eventos de TargetSummary.
--[no]experimental_build_event_expand_filesets
predeterminado: "false"-
Si es verdadero, expande los archivos Filesets en el BEP cuando se presenten los archivos de salida.
Etiquetas:affects_outputs
--[no]experimental_build_event_fully_resolve_fileset_symlinks
predeterminado: "false"-
Si es verdadero, resuelve por completo los vínculos simbólicos relativos de Fileset en el BEP cuando se presentan los archivos de salida. Requiere --experimental_build_event_expand_filesets.
Etiquetas:affects_outputs
- Valor predeterminado de
--experimental_build_event_upload_max_retries=<an integer>
: "4" -
Es la cantidad máxima de veces que Bazel debe reintentar subir un evento de compilación.
Etiquetas:bazel_internal_configuration
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
predeterminado: "1s"-
Es la demora inicial y mínima para los reintentos de retirada exponencial cuando falla la carga del BEP. (exponente: 1.6)
Etiquetas:bazel_internal_configuration
--experimental_build_event_upload_strategy=<a string>
valor predeterminado: consulta la descripción-
Selecciona cómo subir los artefactos a los que se hace referencia en el protocolo del evento de compilación.
Etiquetas:affects_outputs
- Se acumulan los usos múltiples de
--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>
-
Especifica tareas de perfil adicionales que se incluirán en el perfil.
Etiquetas:affects_outputs
,bazel_monitoring
--[no]experimental_profile_include_primary_output
predeterminado: "false"-
Incluye el atributo "out" adicional en los eventos de acción que contienen la ruta de ejecución a la salida principal de la acción.
Etiquetas:affects_outputs
,bazel_monitoring
--[no]experimental_profile_include_target_label
predeterminado: "false"-
Incluye la etiqueta de destino en los datos del perfil JSON de los eventos de acción.
Etiquetas:affects_outputs
,bazel_monitoring
--[no]experimental_stream_log_file_uploads
predeterminado: "false"-
Transmite las cargas de archivos de registro directamente al almacenamiento remoto en lugar de escribirlas en el disco.
Etiquetas:affects_outputs
--experimental_workspace_rules_log_file=<a path>
valor predeterminado: consulta la descripción- Registra ciertos eventos de las reglas de Workspace en este archivo como protos de WorkspaceEvent delimitados.
--[no]generate_json_trace_profile
predeterminado: "auto"-
Si está habilitado, Bazel genera un perfil de la compilación y escribe un perfil en formato JSON en un archivo de la base de salida. Carga el perfil en chrome://tracing para verlo. De forma predeterminada, Bazel escribe el perfil para todos los comandos y consultas similares a la compilación.
Etiquetas:affects_outputs
,bazel_monitoring
--[no]heap_dump_on_oom
predeterminado: "false"-
Indica si se debe generar manualmente un volcado de montón si se genera un error de OOM (incluidos los errores de OOM debido a --experimental_oom_more_eagerly_threshold). El volcado se escribirá en <output_base>/<invocation_id>.heapdump.hprof. Esta opción reemplaza de manera efectiva a -XX:+HeapDumpOnOutOfMemoryError, que no tiene efecto porque los errores OOM se detectan y se redireccionan a Runtime#halt.
Etiquetas:bazel_monitoring
--[no]legacy_important_outputs
predeterminado: "true"-
Úsalo para suprimir la generación del campo legacy important_outputs en el evento TargetComplete. Los important_outputs son necesarios para la integración de Bazel en ResultStore.
Etiquetas:affects_outputs
--logging=<0 <= an integer <= 6>
valor predeterminado: "3"-
Es el nivel de registro.
Etiquetas:affects_outputs
--memory_profile=<a path>
valor predeterminado: consulta la descripción-
Si se configura, escribe los datos de uso de memoria en el archivo especificado al final de las fases y el montón estable en el registro principal al final de la compilación.
Etiquetas:affects_outputs
,bazel_monitoring
--memory_profile_stable_heap_parameters=<integers, separated by a comma expected in pairs>
predeterminado: "1,0"-
Ajusta el cálculo del montón estable del perfil de memoria al final de la compilación. Debe ser una cantidad par de números enteros separados por comas. En cada par, el primer número entero es la cantidad de CG que se deben realizar. El segundo número entero de cada par es la cantidad de segundos que se deben esperar entre las CG. P. ej., 2,4,4,0 significaría 2 GC con una pausa de 4 s, seguidas de 4 GC con una pausa de cero segundos.
Etiquetas:bazel_monitoring
--profile=<a path>
valor predeterminado: consulta la descripción-
Si se configura, genera un perfil de Bazel y escribe datos en el archivo especificado. Usa bazel analyze-profile para analizar el perfil.
Etiquetas:affects_outputs
,bazel_monitoring
--[no]slim_profile
predeterminado: "true"-
Reduce el tamaño del perfil JSON combinando eventos si el perfil se vuelve demasiado grande.
Etiquetas:affects_outputs
,bazel_monitoring
- Valor predeterminado de
--starlark_cpu_profile=<a string>
: "" -
Escribe en el archivo especificado un perfil de pprof del uso de CPU de todos los subprocesos de Starlark.
Etiquetas:bazel_monitoring
- Valor predeterminado de
--tool_tag=<a string>
: "" -
Es el nombre de una herramienta para atribuir esta invocación de Bazel.
Etiquetas:affects_outputs
,bazel_monitoring
- Se acumulan los usos múltiples de
--ui_event_filters=<Convert list of comma separated event kind to list of filters>
-
Especifica qué eventos se mostrarán en la IU. Es posible agregar o quitar eventos de los predeterminados con los signos + o - al principio, o bien anular el conjunto predeterminado por completo con una asignación directa. El conjunto de tipos de eventos admitidos incluye INFO, DEBUG, ERROR y muchos más.
Etiquetas:terminal_output
- Opciones varias, no clasificadas de otra manera.:
- Se acumulan los usos múltiples de
--build_metadata=<a 'name=value' assignment>
-
Pares de cadenas clave-valor personalizados que se proporcionarán en un evento de compilación.
Etiquetas:terminal_output
--color=<yes, no or auto>
predeterminado: "auto"- Usa los controles de la terminal para colorear el resultado.
- Se acumulan los usos múltiples de
--config=<a string>
- Selecciona secciones de configuración adicionales de los archivos .rc. Para cada <command>, también extrae las opciones de <command>:<config> si existe tal sección. Si esta sección no existe en ningún archivo .rc, Blaze falla con un error. Las combinaciones de marcas y secciones de configuración a las que equivalen se encuentran en los archivos de configuración tools/*.blazerc.
- Se acumulan los usos múltiples de
--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.>
- Configura un auxiliar de credenciales para recuperar credenciales de autorización para la recuperación de repositorios, el almacenamiento en caché y la ejecución remotos, y el servicio de eventos de compilación. Las credenciales proporcionadas por un asistente tienen prioridad sobre las credenciales proporcionadas por --google_default_credentials, --google_credentials, un archivo .netrc o el parámetro de autenticación para repository_ctx.download y repository_ctx.download_and_extract. Se puede especificar varias veces para configurar varios asistentes. Para obtener más información, consulta https://github.com/bazelbuild/proposals/blob/main/designs/2022-06-07-bazel-credential-helpers.md.
--credential_helper_cache_duration=<An immutable length of time.>
predeterminado: "30 min"- Es la duración durante la que se almacenan en caché las credenciales proporcionadas por un auxiliar de credenciales. Si se invoca con un valor diferente, se ajustará la vida útil de las entradas existentes. Pasa cero para borrar la caché. Un comando clean siempre borra la caché, independientemente de esta marca.
--credential_helper_timeout=<An immutable length of time.>
predeterminado: "10s"- Configura el tiempo de espera para un auxiliar de credenciales. Los auxiliares de credenciales que no respondan dentro de este tiempo de espera fallarán en la invocación.
--curses=<yes, no or auto>
predeterminado: "auto"- Usa los controles del cursor de la terminal para minimizar el desplazamiento del resultado.
--[no]enable_platform_specific_config
predeterminado: "false"- Si es verdadero, Bazel toma las líneas de configuración específicas del SO host de los archivos bazelrc. Por ejemplo, si el SO host es Linux y ejecutas bazel build, Bazel selecciona las líneas que comienzan con build:linux. Los identificadores de SO admitidos son linux, macos, windows, freebsd y openbsd. Habilitar esta marca equivale a usar --config=linux en Linux, --config=windows en Windows, etcétera.
--[no]experimental_skymeld_ui
predeterminado: "false"-
Muestra el progreso de la fase de análisis y de ejecución cuando ambas se ejecutan de forma simultánea.
Etiquetas:terminal_output
--[no]experimental_windows_watchfs
predeterminado: "false"- Si es verdadero, se habilita la compatibilidad experimental con Windows para --watchfs. De lo contrario, --watchfs no tiene efecto en Windows. Asegúrate de habilitar también --watchfs.
--google_auth_scopes=<comma-separated list of options>
valor predeterminado: "https://www.googleapis.com/auth/cloud-platform"- Lista separada por comas de los permisos de autenticación de Google Cloud.
--google_credentials=<a string>
valor predeterminado: consulta la descripción- Especifica el archivo desde el que se obtienen las credenciales de autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más detalles.
--[no]google_default_credentials
predeterminado: "false"- Indica si se deben usar las "credenciales predeterminadas de la aplicación de Google" para la autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más detalles. Está inhabilitado de forma predeterminada.
--grpc_keepalive_time=<An immutable length of time.>
valor predeterminado: consulta la descripción- Configura los pings de keep-alive para las conexiones gRPC salientes. Si se configura, Bazel envía pings después de este tiempo sin operaciones de lectura en la conexión, pero solo si hay al menos una llamada de gRPC pendiente. Los tiempos se tratan con una granularidad de segundos; es un error establecer un valor inferior a un segundo. De forma predeterminada, los pings de Keep-Alive están inhabilitados. Antes de habilitar este parámetro de configuración, debes coordinarte con el propietario del servicio. Por ejemplo, para establecer un valor de 30 segundos en esta marca, se debe hacer de la siguiente manera: --grpc_keepalive_time=30s
--grpc_keepalive_timeout=<An immutable length of time.>
predeterminado: "20s"- Configura un tiempo de espera de keep-alive para las conexiones gRPC salientes. Si los pings de keep-alive están habilitados con --grpc_keepalive_time, Bazel agota el tiempo de espera de una conexión si no recibe una respuesta de ping después de este tiempo. Los tiempos se tratan con una granularidad de segundos; es un error establecer un valor inferior a un segundo. Si los pings de conexión activa están inhabilitados, se ignorará este parámetro de configuración.
--[no]incompatible_disallow_symlink_file_to_dir
predeterminado: "true"-
Si se establece en verdadero, `ctx.actions.symlink` no permitirá la creación de vínculos simbólicos de un archivo en un directorio.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_rule_name_parameter
predeterminado: "true"-
Si se establece como verdadero, no se puede llamar a "rule" con el parámetro "name".
Etiquetas:loading_and_analysis
,incompatible_change
--[no]progress_in_terminal_title
predeterminado: "false"- Muestra el progreso del comando en el título de la terminal. Es útil para ver lo que hace Bazel cuando hay varias pestañas de terminal.
--[no]show_progress
predeterminado: "true"- Mostrar mensajes de progreso durante una compilación
--show_progress_rate_limit=<a double>
predeterminado: "0.2"- Cantidad mínima de segundos entre los mensajes de progreso en el resultado.
--[no]show_timestamps
predeterminado: "false"- Incluye marcas de tiempo en los mensajes
--tls_certificate=<a string>
valor predeterminado: consulta la descripción- Especifica una ruta de acceso a un certificado TLS que se considera de confianza para firmar certificados de servidor.
--tls_client_certificate=<a string>
valor predeterminado: consulta la descripción- Especifica el certificado de cliente TLS que se usará. También debes proporcionar una clave de cliente para habilitar la autenticación del cliente.
--tls_client_key=<a string>
valor predeterminado: consulta la descripción- Especifica la clave del cliente TLS que se usará. También debes proporcionar un certificado de cliente para habilitar la autenticación del cliente.
--ui_actions_shown=<an integer>
predeterminado: "8"-
Cantidad de acciones simultáneas que se muestran en la barra de progreso detallada. Cada acción se muestra en una línea separada. La barra de progreso siempre muestra al menos un 1, ya que todos los números inferiores a 1 se asignan a 1.
Etiquetas:terminal_output
--[no]watchfs
predeterminado: "false"- En Linux o macOS: Si es verdadero, Bazel intenta usar el servicio de supervisión de archivos del sistema operativo para los cambios locales en lugar de analizar cada archivo en busca de un cambio. En Windows, esta marca actualmente no realiza ninguna operación, pero se puede habilitar junto con --experimental_windows_watchfs. En cualquier SO: El comportamiento no está definido si tu espacio de trabajo se encuentra en un sistema de archivos de red y los archivos se editan en una máquina remota.
Opciones de Analyze-profile
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan los usos múltiples de
--distdir=<a path>
-
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: "false"-
Si se configura, la caché del repositorio creará un vínculo físico al archivo en caso de acierto de caché, en lugar de copiarlo. Esto tiene como objetivo ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
predeterminado: "false"-
Si es verdadero, usa una cadena derivada de las URLs de las descargas del repositorio como canonical_id si no se especifica. Esto hace que un cambio en las URLs genere una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no provoquen que la caché oculte repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
predeterminado: "false"-
Si se configura, no se permite la descarga de repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark según este factor. De esta manera, los repositorios externos pueden funcionar en máquinas más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Ajusta todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
valor predeterminado: consulta la descripción-
Especifica la ubicación de la caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que afectan la rigidez con la que Bazel aplica las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
- Valor predeterminado de
--experimental_repository_hash_file=<a string>
: "" -
Si no está vacío, especifica un archivo que contiene un valor resuelto, con el que se deben verificar los hashes del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan los usos múltiples de
--experimental_verify_repository_rules=<a string>
-
Si se proporciona un archivo con --experimental_repository_hash_file, se debe verificar la lista de reglas del repositorio para las que se debe verificar el hash del directorio de salida.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: "true"-
No-op
Etiquetas:no_op
,deprecated
,experimental
- Opciones relacionadas con la salida y la semántica de Bzlmod:
- Se acumulan los usos múltiples de
--allow_yanked_versions=<a string>
-
Se especificaron las versiones del módulo en el formato "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran como retiradas en el registro del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones retiradas harán que falle la resolución. También puedes definir la versión anulada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivar el problema a una falla de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecta una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "warning"-
Verifica si las dependencias directas de `bazel_dep` declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivar el problema como una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el archivo MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
predeterminado: "off"-
Especifica cómo y si se debe usar el archivo de bloqueo. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "error" para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan los usos múltiples de
--override_module=<an equals-separated mapping of module name to path>
- Anula un módulo con una ruta local con el formato <nombre del módulo>=<ruta>. Si la ruta proporcionada es absoluta, se usará tal cual. Si la ruta proporcionada es relativa, será relativa al directorio de trabajo actual. Si la ruta de acceso proporcionada comienza con "%workspace%", es relativa a la raíz del espacio de trabajo, que es el resultado de "bazel info workspace".
- Se acumulan los usos múltiples de
--registry=<a string>
-
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: primero se buscarán los módulos en los registros anteriores y solo se recurrirá a los registros posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--dump=<text or raw>
[-d
] predeterminado: consulta la descripción-
Genera un volcado completo de los datos del perfil en formato "texto" legible por humanos o en formato "sin procesar" apto para secuencias de comandos.
Etiquetas:affects_outputs
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemónicas con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemónicas.
- Opciones que especifican o alteran una entrada genérica para un comando de Bazel que no se incluye en otras categorías:
- Valor predeterminado de
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
valor predeterminado: consulta la descripción- Especifica un archivo para configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva (`allow`, `block` o `rewrite`) seguida de un nombre de host (para `allow` y `block`) o dos patrones, uno para la coincidencia y otro para usar como URL sustituta, con referencias inversas que comienzan con `$1`. Es posible que se proporcionen varias directivas `rewrite` para la misma URL y, en este caso, se devolverán varias URLs.
- Opciones varias, no clasificadas de otra manera:
- Se acumulan los usos múltiples de
--override_repository=<an equals-separated mapping of repository name to path>
- Anula un repositorio con una ruta de acceso local con el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es absoluta, se usará tal cual. Si la ruta de acceso proporcionada es relativa, se relacionará con el directorio de trabajo actual. Si la ruta de acceso proporcionada comienza con "%workspace%", es relativa a la raíz del espacio de trabajo, que es el resultado de "bazel info workspace".
Opciones de Aquery
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan los usos múltiples de
--distdir=<a path>
-
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: "false"-
Si se configura, la caché del repositorio creará un vínculo físico al archivo en caso de acierto de caché, en lugar de copiarlo. Esto tiene como objetivo ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
predeterminado: "false"-
Si es verdadero, usa una cadena derivada de las URLs de las descargas del repositorio como canonical_id si no se especifica. Esto hace que un cambio en las URLs genere una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no provoquen que la caché oculte repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
predeterminado: "false"-
Si se configura, no se permite la descarga de repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark según este factor. De esta manera, los repositorios externos pueden funcionar en máquinas más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Ajusta todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
valor predeterminado: consulta la descripción-
Especifica la ubicación de la caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que afectan la rigidez con la que Bazel aplica las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
- Valor predeterminado de
--experimental_repository_hash_file=<a string>
: "" -
Si no está vacío, especifica un archivo que contiene un valor resuelto, con el que se deben verificar los hashes del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan los usos múltiples de
--experimental_verify_repository_rules=<a string>
-
Si se proporciona un archivo con --experimental_repository_hash_file, se debe verificar la lista de reglas del repositorio para las que se debe verificar el hash del directorio de salida.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: "true"-
No-op
Etiquetas:no_op
,deprecated
,experimental
- Opciones relacionadas con la salida y la semántica de la búsqueda:
--aspect_deps=<off, conservative or precise>
valor predeterminado: "conservative"-
Cómo resolver las dependencias de aspectos cuando el formato de salida es uno de {xml,proto,record}. "off" significa que no se resuelve ninguna dependencia de aspectos; "conservative" (el valor predeterminado) significa que se agregan todas las dependencias de aspectos declaradas, independientemente de si se les asigna la clase de regla de dependencias directas; "precise" significa que solo se agregan aquellos aspectos que posiblemente estén activos dada la clase de regla de las dependencias directas. Ten en cuenta que el modo preciso requiere cargar otros paquetes para evaluar un solo objetivo, lo que lo hace más lento que los otros modos. También ten en cuenta que incluso el modo preciso no es completamente preciso: la decisión de calcular un aspecto se toma en la fase de análisis, que no se ejecuta durante "bazel query".
Etiquetas:build_file_semantics
--[no]consistent_labels
predeterminado: "false"-
Si está habilitado, cada comando de consulta emite etiquetas como si se aplicara la función <code>str</code> de Starlark a una instancia de <code>Label</code>. Esto es útil para las herramientas que necesitan coincidir con el resultado de diferentes comandos de consulta o etiquetas emitidas por reglas. Si no está habilitado, los formateadores de salida pueden emitir nombres de repositorio aparentes (relativos al repositorio principal) para que la salida sea más legible.
Etiquetas:terminal_output
--[no]deduplicate_depsets
predeterminado: "true"-
Se quitan los duplicados de los elementos secundarios que no son hojas de un dep_set_of_files en el resultado final de proto/textproto/json. Esto no anula el duplicado de los depsets que no comparten un elemento superior inmediato. Esto no afecta la lista final efectiva de artefactos de entrada de las acciones.
Etiquetas:terminal_output
--[no]graph:factored
predeterminado: "true"-
Si es verdadero, el gráfico se emitirá "factorizado", es decir, los nodos topológicamente equivalentes se combinarán y sus etiquetas se concatenarán. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--graph:node_limit=<an integer>
valor predeterminado: "512"-
Es la longitud máxima de la cadena de etiqueta para un nodo de gráfico en el resultado. Las etiquetas más largas se truncarán. El valor -1 significa que no se truncarán. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--[no]implicit_deps
predeterminado: "true"-
Si está habilitado, las dependencias implícitas se incluirán en el gráfico de dependencias sobre el que opera la consulta. Una dependencia implícita es aquella que no se especifica de forma explícita en el archivo BUILD, pero que Bazel agrega. En el caso de cquery, esta opción controla el filtrado de las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
--[no]include_artifacts
predeterminado: "true"-
Incluye los nombres de las entradas y salidas de la acción en el resultado (potencialmente grande).
Etiquetas:terminal_output
--[no]include_aspects
predeterminado: "true"-
aquery, cquery: Indica si se deben incluir las acciones generadas por aspectos en el resultado. query: No es una operación (los aspectos siempre se siguen).
Etiquetas:terminal_output
--[no]include_commandline
predeterminado: "true"-
Incluye el contenido de las líneas de comandos de acción en el resultado (puede ser grande).
Etiquetas:terminal_output
--[no]include_file_write_contents
predeterminado: "false"-
Incluye el contenido del archivo para las acciones FileWrite y SourceSymlinkManifest (potencialmente grandes).
Etiquetas:terminal_output
--[no]include_param_files
predeterminado: "false"-
Incluye el contenido de los archivos de parámetros que se usan en el comando (podría ser grande). Nota: Si habilitas esta marca, se habilitará automáticamente la marca --include_commandline.
Etiquetas:terminal_output
--[no]incompatible_display_source_file_location
predeterminado: "true"-
Es verdadero de forma predeterminada y muestra el destino del archivo fuente. Si es verdadero, muestra la ubicación de la línea 1 de los archivos fuente en los resultados de ubicación. Esta marca solo existe para fines de migración.
Etiquetas:terminal_output
,incompatible_change
--[no]incompatible_package_group_includes_double_slash
predeterminado: "true"-
Si está habilitado, cuando se genere el atributo `packages` de package_group, no se omitirá el `//` inicial.
Etiquetas:terminal_output
,incompatible_change
--[no]infer_universe_scope
predeterminado: "false"-
Si se configura y no se configura --universe_scope, se inferirá un valor de --universe_scope como la lista de patrones de destino únicos en la expresión de búsqueda. Ten en cuenta que el valor de --universe_scope que se infiere para una expresión de búsqueda que usa funciones con alcance del universo (p.ej., "allrdeps") podría no ser el que deseas, por lo que debes usar esta opción solo si sabes lo que haces. Consulta https://bazel.build/reference/query#sky-query para obtener detalles y ejemplos. Si se establece --universe_scope, se ignora el valor de esta opción. Nota: Esta opción solo se aplica a `query` (es decir, no a `cquery`).
Etiquetas:loading_and_analysis
--[no]line_terminator_null
predeterminado: "false"-
Indica si cada formato termina con \0 en lugar de un salto de línea.
Etiquetas:terminal_output
--[no]nodep_deps
predeterminado: "true"-
Si está habilitado, las dependencias de los atributos "nodep" se incluirán en el gráfico de dependencias sobre el que opera la consulta. Un ejemplo común de un atributo "nodep" es "visibilidad". Ejecuta y analiza el resultado de `info build-language` para obtener información sobre todos los atributos "nodep" en el lenguaje de compilación.
Etiquetas:build_file_semantics
--output=<a string>
predeterminado: "text"-
Es el formato en el que se deben imprimir los resultados de aquery. Los valores permitidos para aquery son: text, textproto, proto y jsonproto.
Etiquetas:terminal_output
--[no]proto:default_values
predeterminado: "true"-
Si es verdadero, se incluyen los atributos cuyo valor no se especifica de forma explícita en el archivo BUILD; de lo contrario, se omiten. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
--[no]proto:definition_stack
predeterminado: "false"-
Propaga el campo proto definition_stack, que registra para cada instancia de regla la pila de llamadas de Starlark en el momento en que se definió la clase de la regla.
Etiquetas:terminal_output
--[no]proto:flatten_selects
predeterminado: "true"-
Si está habilitado, los atributos configurables creados por select() se aplanan. En el caso de los tipos de lista, la representación aplanada es una lista que contiene cada valor del mapa de selección exactamente una vez. Los tipos escalares se aplanan a nulos.
Etiquetas:build_file_semantics
--[no]proto:include_synthetic_attribute_hash
predeterminado: "false"-
Indica si se debe calcular y completar el atributo $internal_attr_hash.
Etiquetas:terminal_output
--[no]proto:instantiation_stack
predeterminado: "false"-
Propaga la pila de llamadas de instanciación de cada regla. Ten en cuenta que esto requiere que la pila esté presente.
Etiquetas:terminal_output
--[no]proto:locations
predeterminado: "true"-
Indica si se debe generar información de ubicación en la salida de proto.
Etiquetas:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
predeterminado: "all"-
Lista de atributos separados por comas que se incluirán en el resultado. La configuración predeterminada incluye todos los atributos. Se establece en una cadena vacía para no generar ningún atributo. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
--[no]proto:rule_inputs_and_outputs
predeterminado: "true"-
Indica si se deben propagar los campos rule_input y rule_output.
Etiquetas:terminal_output
- Valor predeterminado de
--query_file=<a string>
: "" -
Si se configura, la consulta leerá la consulta del archivo que se nombra aquí, en lugar de hacerlo desde la línea de comandos. Es un error especificar un archivo aquí y una consulta de línea de comandos.
Etiquetas:changes_inputs
--[no]relative_locations
predeterminado: "false"-
Si es verdadero, la ubicación de los archivos BUILD en las salidas de XML y proto será relativa. De forma predeterminada, la salida de ubicación es una ruta de acceso absoluta y no será coherente en todas las máquinas. Puedes establecer esta opción como verdadera para obtener un resultado coherente en todas las máquinas.
Etiquetas:terminal_output
--[no]skyframe_state
predeterminado: "false"-
Sin realizar análisis adicionales, vuelca el Action Graph actual de Skyframe. Nota: Por el momento, no se admite la especificación de un destino con --skyframe_state. Esta marca solo está disponible con --output=proto o --output=textproto.
Etiquetas:terminal_output
--[no]tool_deps
predeterminado: "true"-
Consulta: Si está inhabilitada, las dependencias de los destinos de "configuración del host" o "ejecución" no se incluirán en el gráfico de dependencias sobre el que opera la consulta. Un borde de dependencia de "configuración del host", como el que va de cualquier regla "proto_library" al compilador de Protocolos, suele apuntar a una herramienta que se ejecuta durante la compilación en lugar de a una parte del mismo programa "target".
Cquery: Si está inhabilitado, filtra todos los destinos configurados que cruzan una transición de host o de ejecución desde el destino de nivel superior que descubrió este destino configurado. Esto significa que, si el destino de nivel superior está en la configuración de destino, solo se devolverán los destinos configurados que también estén en la configuración de destino. Si el destino de nivel superior está en la configuración del host, solo se devolverán los destinos configurados del host. Esta opción NO excluirá las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
- Valor predeterminado de
--universe_scope=<comma-separated list of options>
: "" -
Es un conjunto de patrones de segmentación (aditivos y sustractivos) separados por comas. La consulta se puede realizar en el universo definido por el cierre transitivo de los destinos especificados. Esta opción se usa para los comandos query y cquery.
En el caso de cquery, la entrada de esta opción son los destinos en los que se compilan todas las respuestas, por lo que esta opción puede afectar las configuraciones y las transiciones. Si no se especifica esta opción, se supone que los destinos de nivel superior son los que se analizan a partir de la expresión de búsqueda. Nota: En el caso de cquery, no especificar esta opción puede provocar que se interrumpa la compilación si los destinos analizados a partir de la expresión de la consulta no se pueden compilar con las opciones de nivel superior.
Etiquetas:loading_and_analysis
- Opciones relacionadas con la salida y la semántica de Bzlmod:
- Se acumulan los usos múltiples de
--allow_yanked_versions=<a string>
-
Se especificaron las versiones del módulo en el formato "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran como retiradas en el registro del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones retiradas harán que falle la resolución. También puedes definir la versión anulada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivar el problema a una falla de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecta una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "warning"-
Verifica si las dependencias directas de `bazel_dep` declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivar el problema como una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el archivo MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
predeterminado: "off"-
Especifica cómo y si se debe usar el archivo de bloqueo. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "error" para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan los usos múltiples de
--override_module=<an equals-separated mapping of module name to path>
- Anula un módulo con una ruta local con el formato <nombre del módulo>=<ruta>. Si la ruta proporcionada es absoluta, se usará tal cual. Si la ruta proporcionada es relativa, será relativa al directorio de trabajo actual. Si la ruta de acceso proporcionada comienza con "%workspace%", es relativa a la raíz del espacio de trabajo, que es el resultado de "bazel info workspace".
- Se acumulan los usos múltiples de
--registry=<a string>
-
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: primero se buscarán los módulos en los registros anteriores y solo se recurrirá a los registros posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemónicas con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemónicas.
- Opciones que especifican o alteran una entrada genérica para un comando de Bazel que no se incluye en otras categorías:
- Valor predeterminado de
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
valor predeterminado: consulta la descripción- Especifica un archivo para configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva (`allow`, `block` o `rewrite`) seguida de un nombre de host (para `allow` y `block`) o dos patrones, uno para la coincidencia y otro para usar como URL sustituta, con referencias inversas que comienzan con `$1`. Es posible que se proporcionen varias directivas `rewrite` para la misma URL y, en este caso, se devolverán varias URLs.
- Opciones varias, no clasificadas de otra manera:
- Se acumulan los usos múltiples de
--override_repository=<an equals-separated mapping of repository name to path>
- Anula un repositorio con una ruta de acceso local con el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es absoluta, se usará tal cual. Si la ruta de acceso proporcionada es relativa, se relacionará con el directorio de trabajo actual. Si la ruta de acceso proporcionada comienza con "%workspace%", es relativa a la raíz del espacio de trabajo, que es el resultado de "bazel info workspace".
- Opciones que controlan la ejecución de la compilación:
--[no]experimental_inprocess_symlink_creation
predeterminado: "false"-
Indica si se deben realizar llamadas directas al sistema de archivos para crear árboles de vínculos simbólicos.
Etiquetas:loading_and_analysis
,execution
,experimental
--[no]experimental_remotable_source_manifests
predeterminado: "false"-
Indica si las acciones del manifiesto fuente se pueden realizar de forma remota.
Etiquetas:loading_and_analysis
,execution
,experimental
--[no]experimental_split_coverage_postprocessing
predeterminado: "false"-
Si es verdadero, Bazel ejecutará el procesamiento posterior de la cobertura para la prueba en una nueva generación.
Etiquetas:execution
--[no]experimental_strict_fileset_output
predeterminado: "false"-
Si esta opción está habilitada, los conjuntos de archivos tratarán todos los artefactos de salida como archivos normales. No recorrerán directorios ni serán sensibles a los vínculos simbólicos.
Etiquetas:execution
- Valor predeterminado de
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
: "" -
Agrega o quita claves de la información de ejecución de una acción según la mnemónica de la acción. Solo se aplica a las acciones que admiten información de ejecución. Muchas acciones comunes admiten información de ejecución, p.ej., Genrule, CppCompile, Javac, StarlarkAction y TestRunner. Cuando se especifican varios valores, el orden es importante porque muchas expresiones regulares pueden aplicarse a la misma mnemónica.
La sintaxis es "regex=[+-]key,regex=[+-]key,…".
Ejemplos:
".*=+x,.*=-y,.*=+z" agrega "x" y "z" a la información de ejecución de todas las acciones, y quita "y" de ella.
"Genrule=+requires-x" agrega "requires-x" a la información de ejecución de todas las acciones de Genrule.
"(?!Genrule).*=-requires-x" quita "requires-x" de la información de ejecución para todas las acciones que no sean Genrule.
Etiquetas:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Habilita acciones persistentes de dex y desugar de Android con trabajadores.
Se expande a:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
-
Habilita el procesador de recursos de Android persistente con trabajadores.
Se expande a lo siguiente:
--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=AARGenerator=worker
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_dex_desugar
-
Habilita acciones persistentes de dex y desugar de Android multiplexadas con trabajadores.
Se expande a:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
Habilita el procesador de recursos de Android multiplexado persistente con trabajadores.
Se expande a lo siguiente:
--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=AARGenerator=+supports-multiplex-workers
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_tools
-
Habilita herramientas de Android persistentes y multiplexadas (dexing, desugaring, procesamiento de recursos).
Se expande a:
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Etiquetas:host_machine_resource_optimizations
,execution
- Opciones que configuran la cadena de herramientas que se usa para la ejecución de acciones:
--android_compiler=<a string>
valor predeterminado: consulta la descripción-
Compilador de destino de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_crosstool_top=<a build target label>
predeterminado: "//external:android/crosstool"-
Ubicación del compilador de C++ que se usa para las compilaciones de Android.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_grte_top=<a label>
valor predeterminado: consulta la descripción-
El destino de Android grte_top.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
valor predeterminado: "android"-
Selecciona el combinador de manifiestos que se usará para las reglas de android_binary. Es una marca para ayudar en la transición de la herramienta de combinación heredada a la herramienta de combinación de manifiestos de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Valor predeterminado de
--android_platforms=<a build target label>
: "" -
Establece las plataformas que usan los destinos de android_binary. Si se especifican varias plataformas, el archivo binario es un APK grueso, que contiene archivos binarios nativos para cada plataforma de destino especificada.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_sdk=<a build target label>
default: "@bazel_tools//tools/android:sdk"-
Especifica el SDK o la plataforma de Android que se usan para compilar aplicaciones para Android.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--apple_compiler=<a string>
valor predeterminado: consulta la descripción-
El compilador de destino de Apple. Es útil para seleccionar variantes de una cadena de herramientas (p.ej., xcode-beta).
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--apple_crosstool_top=<a build target label>
predeterminado: "@bazel_tools//tools/cpp:toolchain"-
Es la etiqueta del paquete de herramientas cruzadas que se usará en las reglas de Apple y Objc, y sus dependencias.
Etiquetas:loses_incremental_state
,changes_inputs
--apple_grte_top=<a build target label>
valor predeterminado: consulta la descripción-
Es el grte_top de destino de Apple.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
- Valor predeterminado de
--cc_output_directory_tag=<a string>
: "" -
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas:affects_outputs
,explicit_in_output_path
--compiler=<a string>
valor predeterminado: consulta la descripción-
Es el compilador de C++ que se usará para compilar el destino.
Etiquetas:loading_and_analysis
,execution
--coverage_output_generator=<a build target label>
predeterminado: "@bazel_tools//tools/test:lcov_merger"-
Ubicación del archivo binario que se usa para el procesamiento posterior de los informes de cobertura sin procesar. Actualmente, debe ser un filegroup que contenga un solo archivo, el binario. El valor predeterminado es “//tools/test:lcov_merger”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
predeterminado: "@bazel_tools//tools/test:coverage_report_generator"-
Ubicación del archivo binario que se usa para generar informes de cobertura. Actualmente, debe ser un filegroup que contenga un solo archivo, el binario. El valor predeterminado es “//tools/test:coverage_report_generator”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
predeterminado: "@bazel_tools//tools/test:coverage_support"-
Ubicación de los archivos de asistencia que se requieren en las entradas de cada acción de prueba que recopila la cobertura del código. El valor predeterminado es “//tools/test:coverage_support”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--crosstool_top=<a build target label>
predeterminado: "@bazel_tools//tools/cpp:toolchain"-
Es la etiqueta del paquete de herramientas cruzadas que se usará para compilar código en C++.
Etiquetas:loading_and_analysis
,changes_inputs
,affects_outputs
--custom_malloc=<a build target label>
valor predeterminado: consulta la descripción-
Especifica una implementación de malloc personalizada. Este parámetro de configuración anula los atributos de malloc en las reglas de compilación.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan los usos múltiples de
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
-
Lista de expresiones regulares separadas por comas, cada una con el prefijo opcional - (expresión negativa), asignadas (=) a una lista de destinos de valores de restricción separados por comas. Si un destino no coincide con ninguna expresión negativa y coincide con al menos una expresión positiva, la resolución de su cadena de herramientas se realizará como si hubiera declarado los valores de restricción como restricciones de ejecución. Ejemplo: //demo,-test=@platforms//cpus:x86_64 agregará "x86_64" a cualquier destino en //demo, excepto a aquellos cuyo nombre contenga "test".
Etiquetas:loading_and_analysis
--[no]experimental_enable_objc_cc_deps
predeterminado: "true"-
Permite que las reglas objc_* dependan de cc_library y hace que cualquier dependencia de objc se compile con --cpu establecido en "ios_<--ios_cpu>" para cualquier valor en --ios_multi_cpu.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]experimental_include_xcode_execution_requirements
predeterminado: "false"-
Si se configura, agrega un requisito de ejecución "requires-xcode:{version}" a cada acción de Xcode. Si la versión de Xcode tiene una etiqueta con guiones, también agrega un requisito de ejecución "requires-xcode-label:{version_label}".
Etiquetas:loses_incremental_state
,loading_and_analysis
,execution
--[no]experimental_prefer_mutual_xcode
predeterminado: "true"-
Si es verdadero, usa el Xcode más reciente que esté disponible de forma local y remota. Si es falso o si no hay versiones disponibles mutuas, usa la versión local de Xcode seleccionada a través de xcode-select.
Etiquetas:loses_incremental_state
- Se acumulan los usos múltiples de
--extra_execution_platforms=<comma-separated list of options>
-
Son las plataformas disponibles como plataformas de ejecución para ejecutar acciones. Las plataformas se pueden especificar por objetivo exacto o como un patrón de objetivo. Estas plataformas se considerarán antes de las que se declaren en el archivo WORKSPACE con register_execution_platforms().
Etiquetas:execution
- Se acumulan los usos múltiples de
--extra_toolchains=<comma-separated list of options>
-
Son las reglas de la cadena de herramientas que se deben tener en cuenta durante la resolución de la cadena de herramientas. Las cadenas de herramientas se pueden especificar por destino exacto o como un patrón de destino. Estas cadenas de herramientas se considerarán antes de las que se declaran en el archivo WORKSPACE con register_toolchains().
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--grte_top=<a label>
valor predeterminado: consulta la descripción-
Es una etiqueta para una biblioteca de libc registrada. El valor predeterminado se selecciona con la cadena de herramientas de compilación cruzada y casi nunca es necesario anularlo.
Etiquetas:action_command_lines
,affects_outputs
--host_compiler=<a string>
valor predeterminado: consulta la descripción-
Es el compilador de C++ que se usará para la compilación del host. Se ignora si no se establece --host_crosstool_top.
Etiquetas:loading_and_analysis
,execution
--host_crosstool_top=<a build target label>
valor predeterminado: consulta la descripción-
De forma predeterminada, las opciones --crosstool_top y --compiler también se usan para la configuración del host. Si se proporciona esta marca, Bazel usa la libc y el compilador predeterminados para el crosstool_top determinado.
Etiquetas:loading_and_analysis
,changes_inputs
,affects_outputs
--host_grte_top=<a label>
valor predeterminado: consulta la descripción-
Si se especifica, este parámetro de configuración anula el directorio de nivel superior de libc (--grte_top) para la configuración del host.
Etiquetas:action_command_lines
,affects_outputs
- Valor predeterminado de
--host_platform=<a build target label>
: "" -
Etiqueta de una regla de plataforma que describe el sistema host.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--[no]incompatible_disable_expand_if_all_available_in_flag_set
predeterminado: "true"-
Si es verdadero, Bazel no permitirá especificar expand_if_all_available en flag_sets(consulta https://github.com/bazelbuild/bazel/issues/7008 para obtener instrucciones de migración).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
predeterminado: "true"-
Si es verdadero, Bazel no habilitará las funciones "host" y "nonhost" en la cadena de herramientas de C++ (consulta https://github.com/bazelbuild/bazel/issues/7407 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_android_toolchain_resolution
predeterminado: "false"-
Usa la resolución de cadenas de herramientas para seleccionar el SDK de Android para las reglas de Android (Starlark y nativas)
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_apple_toolchain_resolution
predeterminado: "false"-
Usa la resolución de la cadena de herramientas para seleccionar el SDK de Apple para las reglas de Apple (Starlark y nativas)
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone
predeterminado: "true"-
Si es verdadero, Bazel no volverá a usar las líneas de comandos de la acción de vinculación de C++ para las líneas de comandos de indexación de LTO (consulta https://github.com/bazelbuild/bazel/issues/6791 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain
predeterminado: "true"-
Si es verdadero, Bazel mostrará un error cuando se establezcan los atributos cc_toolchain.cpu y cc_toolchain.compiler (consulta https://github.com/bazelbuild/bazel/issues/7075 para obtener instrucciones de migración).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_legacy_whole_archive
predeterminado: "true"-
Si es verdadero, Bazel no vinculará las dependencias de la biblioteca como un archivo completo de forma predeterminada (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener instrucciones de migración).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_require_ctx_in_configure_features
predeterminado: "true"-
Si es verdadero, Bazel requerirá el parámetro "ctx" en cc_common.configure_features (consulta https://github.com/bazelbuild/bazel/issues/7793 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
-
Usa objetos compartidos de interfaz si la cadena de herramientas los admite. Actualmente, todas las cadenas de herramientas de ELF admiten este parámetro de configuración.
Etiquetas:loading_and_analysis
,affects_outputs
,affects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
valor predeterminado: consulta la descripción-
Especifica la versión del SDK de iOS que se usará para compilar aplicaciones para iOS. Si no se especifica, se usa la versión predeterminada del SDK de iOS de "xcode_version".
Etiquetas:loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
valor predeterminado: consulta la descripción-
Especifica la versión del SDK de macOS que se usará para compilar aplicaciones para macOS. Si no se especifica, se usa la versión predeterminada del SDK de macOS de "xcode_version".
Etiquetas:loses_incremental_state
--minimum_os_version=<a string>
valor predeterminado: consulta la descripción-
Es la versión mínima del SO para la que se compila tu app.
Etiquetas:loading_and_analysis
,affects_outputs
- Valor predeterminado de
--platform_mappings=<a relative path>
: "" -
Ubicación de un archivo de asignación que describe qué plataforma usar si no se configuró ninguna o qué marcas establecer cuando ya existe una plataforma. Debe ser relativa a la raíz del espacio de trabajo principal. El valor predeterminado es "platform_mappings" (un archivo directamente en la raíz del espacio de trabajo).
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
- Valor predeterminado de
--platforms=<a build target label>
: "" -
Son las etiquetas de las reglas de la plataforma que describen las plataformas de destino para el comando actual.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--python2_path=<a string>
valor predeterminado: consulta la descripción-
Obsoleto, no hace nada. Se inhabilita con `--incompatible_use_python_toolchains`.
Etiquetas:no_op
,deprecated
--python3_path=<a string>
valor predeterminado: consulta la descripción-
Obsoleto, no hace nada. Se inhabilita con `--incompatible_use_python_toolchains`.
Etiquetas:no_op
,deprecated
--python_path=<a string>
valor predeterminado: consulta la descripción-
Es la ruta de acceso absoluta del intérprete de Python invocado para ejecutar destinos de Python en la plataforma de destino. Obsoleto; se inhabilita con --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
--python_top=<a build target label>
valor predeterminado: consulta la descripción-
Es la etiqueta de un py_runtime que representa el intérprete de Python invocado para ejecutar destinos de Python en la plataforma de destino. Obsoleto; se inhabilita con --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
--target_platform_fallback=<a build target label>
predeterminado: "@local_config_platform//:host"-
Es la etiqueta de una regla de plataforma que se debe usar si no se establece ninguna plataforma de destino y ninguna asignación de plataforma coincide con el conjunto actual de marcas.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
valor predeterminado: consulta la descripción-
Especifica la versión del SDK de tvOS que se usará para compilar aplicaciones para tvOS. Si no se especifica, se usa la versión predeterminada del SDK de tvOS de "xcode_version".
Etiquetas:loses_incremental_state
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
valor predeterminado: consulta la descripción-
Especifica la versión del SDK de watchOS que se usará para compilar aplicaciones para watchOS. Si no se especifica, se usa la versión predeterminada del SDK de watchOS de "xcode_version".
Etiquetas:loses_incremental_state
--xcode_version=<a string>
valor predeterminado: consulta la descripción-
Si se especifica, usa Xcode de la versión indicada para las acciones de compilación pertinentes. Si no se especifica, se usa la versión predeterminada del ejecutor de Xcode.
Etiquetas:loses_incremental_state
--xcode_version_config=<a build target label>
valor predeterminado: "@bazel_tools//tools/cpp:host_xcodes"-
Es la etiqueta de la regla xcode_config que se usará para seleccionar la versión de Xcode en la configuración de compilación.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Opciones que controlan el resultado del comando:
--[no]apple_enable_auto_dsym_dbg
predeterminado: "false"-
Indica si se debe forzar la habilitación de la generación de archivos de símbolos de depuración (.dSYM) para las compilaciones de depuración.
Etiquetas:affects_outputs
,action_command_lines
--[no]apple_generate_dsym
predeterminado: "false"-
Indica si se deben generar archivos de símbolos de depuración (.dSYM).
Etiquetas:affects_outputs
,action_command_lines
--[no]build_runfile_links
predeterminado: "true"-
Si es verdadero, compila bosques de vínculos simbólicos de archivos ejecutables para todos los destinos. Si es falso, escribe solo manifiestos cuando sea posible.
Etiquetas:affects_outputs
--[no]build_runfile_manifests
predeterminado: "true"-
Si es verdadero, escribe manifiestos de archivos ejecutables para todos los destinos. Si es falso, omítelos. Las pruebas locales no se ejecutarán cuando sea falso.
Etiquetas:affects_outputs
--[no]build_test_dwp
predeterminado: "false"-
Si está habilitado, cuando se compilen pruebas de C++ de forma estática y con fission, también se compilará automáticamente el archivo .dwp para el archivo binario de prueba.
Etiquetas:loading_and_analysis
,affects_outputs
--cc_proto_library_header_suffixes=<comma-separated list of options>
predeterminado: ".pb.h"-
Establece los prefijos de los archivos de encabezado que crea un cc_proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated list of options>
predeterminado: ".pb.cc"-
Establece los prefijos de los archivos fuente que crea un cc_proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info
predeterminado: "false"-
Ejecuta acciones adicionales para versiones alternativas de la API de Java en un proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_proto_extra_actions
predeterminado: "false"-
Ejecuta acciones adicionales para versiones alternativas de la API de Java en un proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_save_feature_state
predeterminado: "false"-
Guarda el estado de las funciones habilitadas y solicitadas como resultado de la compilación.
Etiquetas:affects_outputs
,experimental
--fission=<a set of compilation modes>
predeterminado: "no"-
Especifica qué modos de compilación usan fission para las compilaciones y las vinculaciones de C++. Puede ser cualquier combinación de {"fastbuild", "dbg", "opt"} o los valores especiales "yes" para habilitar todos los modos y "no" para inhabilitar todos los modos.
Etiquetas:loading_and_analysis
,action_command_lines
,affects_outputs
--[no]incompatible_always_include_files_in_data
predeterminado: "true"-
Si es verdadero, las reglas nativas agregan <code>DefaultInfo.files</code> de las dependencias de datos a sus archivos ejecutables, lo que coincide con el comportamiento recomendado para las reglas de Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid).
Etiquetas:affects_outputs
,incompatible_change
--[no]legacy_external_runfiles
predeterminado: "true"-
Si es verdadero, compila bosques de vínculos simbólicos de archivos de ejecución para repositorios externos en .runfiles/wsname/external/repo (además de .runfiles/repo).
Etiquetas:affects_outputs
--[no]objc_generate_linkmap
predeterminado: "false"-
Especifica si se debe generar un archivo de mapa de vínculos.
Etiquetas:affects_outputs
--[no]save_temps
predeterminado: "false"-
Si se configura, se guardarán los resultados temporales de gcc. Estos incluyen archivos .s (código de ensamblador), archivos .i (C preprocesado) y archivos .ii (C++ preprocesado).
Etiquetas:affects_outputs
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
- Se acumulan los usos múltiples de
--action_env=<a 'name=value' assignment with an optional value part>
-
Especifica el conjunto de variables de entorno disponibles para las acciones con configuración de destino. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o bien por el par nombre=valor que establece el valor independientemente del entorno de invocación. Esta opción se puede usar varias veces. En el caso de las opciones proporcionadas para la misma variable, se aplica la más reciente. Las opciones para diferentes variables se acumulan.
Etiquetas:action_command_lines
--android_cpu=<a string>
predeterminado: "armeabi-v7a"-
Es la CPU objetivo de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]android_databinding_use_androidx
predeterminado: "false"-
Genera archivos de vinculación de datos compatibles con AndroidX. Esto solo se usa con la vinculación de datos v2.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]android_databinding_use_v3_4_args
predeterminado: "false"-
Usa la vinculación de datos de Android v2 con el argumento 3.4.0
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--android_dynamic_mode=<off, default or fully>
predeterminado: "off"-
Determina si las dependencias de C++ de las reglas de Android se vincularán de forma dinámica cuando un cc_binary no cree de forma explícita una biblioteca compartida. "default" significa que Bazel elegirá si se vincula de forma dinámica. "fully" significa que todas las bibliotecas se vincularán de forma dinámica. "off" significa que todas las bibliotecas se vincularán principalmente en modo estático.
Etiquetas:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
predeterminado: "alfabético"-
Establece el orden de los manifiestos que se pasan al combinador de manifiestos para los archivos binarios de Android. ALPHABETICAL significa que los manifiestos se ordenan por ruta de acceso relativa a execroot. ALPHABETICAL_BY_CONFIGURATION significa que los manifiestos se ordenan por rutas de acceso relativas al directorio de configuración dentro del directorio de salida. DEPENDENCY significa que los manifiestos se ordenan de modo que el manifiesto de cada biblioteca aparezca antes de los manifiestos de sus dependencias.
Etiquetas:action_command_lines
,execution
--[no]android_resource_shrinking
predeterminado: "false"-
Habilita la reducción de recursos para los APKs de android_binary que usan ProGuard.
Etiquetas:affects_outputs
,loading_and_analysis
- Se acumulan los usos múltiples de
--apple_bitcode=<'mode' or 'platform=mode', where 'mode' is none, embedded_markers or embedded, and 'platform' is ios, visionos, watchos, tvos, macos or catalyst>
-
Especifica el modo de bitcode de Apple para los pasos de compilación que tienen como objetivo las arquitecturas de dispositivos. Los valores tienen el formato "[plataforma=]modo", en el que la plataforma (que debe ser "ios", "macos", "tvos" o "watchos") es opcional. Si se proporciona, el modo de bitcode se aplica específicamente para esa plataforma. Si se omite, se aplica para todas las plataformas. El modo debe ser "none", "embedded_markers" o "embedded". Esta opción se puede proporcionar varias veces.
Etiquetas:loses_incremental_state
--[no]build_python_zip
predeterminado: "auto"-
Compila el archivo .zip ejecutable de Python; activado en Windows, desactivado en otras plataformas
Etiquetas:affects_outputs
- Se acumulan los usos múltiples de
--catalyst_cpus=<comma-separated list of options>
-
Lista separada por comas de las arquitecturas para las que se compilarán los archivos binarios de Apple Catalyst.
Etiquetas:loses_incremental_state
,loading_and_analysis
--[no]collect_code_coverage
predeterminado: "false"-
Si se especifica, Bazel instrumentará el código (con instrumentación sin conexión cuando sea posible) y recopilará información de cobertura durante las pruebas. Solo se verán afectados los destinos que coincidan con --instrumentation_filter. Por lo general, esta opción no se debe especificar directamente. En su lugar, se debe usar el comando "bazel coverage".
Etiquetas:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] valor predeterminado: "fastbuild"-
Especifica el modo en el que se compilará el objeto binario. Valores: "fastbuild", "dbg", "opt".
Etiquetas:affects_outputs
,action_command_lines
,explicit_in_output_path
- Se acumulan los usos múltiples de
--conlyopt=<a string>
-
Opción adicional para pasar a gcc cuando se compilan archivos de origen C.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan los usos múltiples de
--copt=<a string>
-
Opciones adicionales para pasar a gcc.
Etiquetas:action_command_lines
,affects_outputs
- Valor predeterminado de
--cpu=<a string>
: "" -
CPU objetivo.
Etiquetas:changes_inputs
,affects_outputs
,explicit_in_output_path
--cs_fdo_absolute_path=<a string>
valor predeterminado: consulta la descripción-
Usa la información del perfil de CSFDO para optimizar la compilación. Especifica el nombre de la ruta de acceso absoluta del archivo ZIP que contiene el archivo de perfil, un archivo de perfil de LLVM sin procesar o indexado.
Etiquetas:affects_outputs
--cs_fdo_instrument=<a string>
valor predeterminado: consulta la descripción-
Genera archivos binarios con la instrumentación de FDO sensible al contexto. Con el compilador Clang/LLVM, también acepta el nombre del directorio en el que se volcarán los archivos de perfil sin procesar en el tiempo de ejecución.
Etiquetas:affects_outputs
--cs_fdo_profile=<a build target label>
valor predeterminado: consulta la descripción-
Es el cs_fdo_profile que representa el perfil sensible al contexto que se usará para la optimización.
Etiquetas:affects_outputs
- Se acumulan los usos múltiples de
--cxxopt=<a string>
-
Opción adicional para pasar a gcc cuando se compilan archivos de origen C++.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan los usos múltiples de
--define=<a 'name=value' assignment>
-
Cada opción --define especifica una asignación para una variable de compilación.
Etiquetas:changes_inputs
,affects_outputs
--dynamic_mode=<off, default or fully>
predeterminado: "default"-
Determina si los archivos binarios de C++ se vincularán de forma dinámica. "default" significa que Bazel elegirá si se vincula de forma dinámica. "fully" significa que todas las bibliotecas se vincularán de forma dinámica. "off" significa que todas las bibliotecas se vincularán principalmente en modo estático.
Etiquetas:loading_and_analysis
,affects_outputs
--[no]enable_fdo_profile_absolute_path
predeterminado: "true"-
Si se configura, el uso de fdo_absolute_profile_path generará un error.
Etiquetas:affects_outputs
--[no]enable_runfiles
predeterminado: "auto"-
Habilita el árbol de vínculos simbólicos de runfiles. De forma predeterminada, está desactivado en Windows y activado en otras plataformas.
Etiquetas:affects_outputs
- Se acumulan los usos múltiples de
--experimental_action_listener=<a build target label>
-
Dejó de estar disponible y se reemplazó por aspectos. Usa action_listener para adjuntar un extra_action a las acciones de compilación existentes.
Etiquetas:execution
,experimental
--[no]experimental_android_compress_java_resources
predeterminado: "false"-
Comprimir recursos de Java en APKs
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_android_databinding_v2
predeterminado: "false"-
Use android databinding v2
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_android_resource_shrinking
predeterminado: "false"-
Habilita la reducción de recursos para los APKs de android_binary que usan ProGuard.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_android_rewrite_dexes_with_rex
predeterminado: "false"-
use rex tool to rewrite dex files
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_collect_code_coverage_for_generated_files
predeterminado: "false"-
Si se especifica, Bazel también generará información de recopilación de cobertura para los archivos generados.
Etiquetas:affects_outputs
--experimental_objc_fastbuild_options=<comma-separated list of options>
predeterminado: "-O0,-DDEBUG=1"-
Usa estas cadenas como opciones del compilador de compilación rápida de objc.
Etiquetas:action_command_lines
--[no]experimental_omitfp
predeterminado: "false"-
Si es verdadero, usa libunwind para el desenrollado de la pila y compila con -fomit-frame-pointer y -fasynchronous-unwind-tables.
Etiquetas:action_command_lines
,affects_outputs
,experimental
--[no]experimental_platform_in_output_dir
predeterminado: "false"-
Si es verdadero, la plataforma de destino se usa en el nombre del directorio de salida en lugar de la CPU.
Etiquetas:affects_outputs
,experimental
--[no]experimental_use_llvm_covmap
predeterminado: "false"-
Si se especifica, Bazel generará información del mapa de cobertura de llvm-cov en lugar de gcov cuando se habilite collect_code_coverage.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
--fat_apk_cpu=<comma-separated list of options>
predeterminado: "armeabi-v7a"-
Si configuras esta opción, se habilitarán los APKs multiarquitectura, que contienen objetos binarios nativos para todas las arquitecturas de destino especificadas, p.ej., --fat_apk_cpu=x86,armeabi-v7a. Si se especifica esta marca, se ignora --android_cpu para las dependencias de las reglas de android_binary.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]fat_apk_hwasan
predeterminado: "false"-
Indica si se deben crear divisiones de HWASAN.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--fdo_instrument=<a string>
valor predeterminado: consulta la descripción-
Genera archivos binarios con la instrumentación de FDO. Con el compilador Clang/LLVM, también acepta el nombre del directorio en el que se volcarán los archivos de perfil sin procesar en el tiempo de ejecución.
Etiquetas:affects_outputs
--fdo_optimize=<a string>
valor predeterminado: consulta la descripción-
Usa la información del perfil de FDO para optimizar la compilación. Especifica el nombre de un archivo ZIP que contenga un árbol de archivos .gcda, un archivo AFDO que contenga un perfil automático o un archivo de perfil de LLVM. Esta marca también acepta archivos especificados como etiquetas (p.ej., `//foo/bar:file.afdo`; es posible que debas agregar una directiva `exports_files` al paquete correspondiente) y etiquetas que apuntan a destinos `fdo_profile`. Esta marca se reemplazará por la regla "fdo_profile".
Etiquetas:affects_outputs
--fdo_prefetch_hints=<a build target label>
valor predeterminado: consulta la descripción-
Usa sugerencias de recuperación previa de caché.
Etiquetas:affects_outputs
--fdo_profile=<a build target label>
valor predeterminado: consulta la descripción-
Es el objeto fdo_profile que representa el perfil que se usará para la optimización.
Etiquetas:affects_outputs
- Se acumulan los usos múltiples de
--features=<a string>
-
Las funciones proporcionadas se habilitarán o inhabilitarán de forma predeterminada para los destinos compilados en la configuración de destino. Si especificas -<feature>, se inhabilitará la función. Las funciones negativas siempre anulan las positivas. Consulta también --host_features.
Etiquetas:changes_inputs
,affects_outputs
--[no]force_pic
predeterminado: "false"-
Si está habilitado, todas las compilaciones de C++ producen código independiente de la posición (“-fPIC”), las vinculaciones prefieren las bibliotecas prediseñadas PIC a las bibliotecas no PIC y las vinculaciones producen ejecutables independientes de la posición (“-pie”).
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan los usos múltiples de
--host_action_env=<a 'name=value' assignment with an optional value part>
-
Especifica el conjunto de variables de entorno disponibles para las acciones con configuraciones de host o de ejecución. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o bien por el par nombre=valor que establece el valor independientemente del entorno de invocación. Esta opción se puede usar varias veces. En el caso de las opciones proporcionadas para la misma variable, se aplica la más reciente. Las opciones para diferentes variables se acumulan.
Etiquetas:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
valor predeterminado: "opt"-
Especifica el modo en el que se compilarán las herramientas que se usan durante la compilación. Valores: "fastbuild", "dbg", "opt".
Etiquetas:affects_outputs
,action_command_lines
- Se acumulan los usos múltiples de
--host_conlyopt=<a string>
-
Opción adicional para pasar a gcc cuando se compilan archivos de origen C para herramientas del host.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan los usos múltiples de
--host_copt=<a string>
-
Opciones adicionales para pasar a gcc para las herramientas del host.
Etiquetas:action_command_lines
,affects_outputs
- Valor predeterminado de
--host_cpu=<a string>
: "" -
Es la CPU del host.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan los usos múltiples de
--host_cxxopt=<a string>
-
Opciones adicionales para pasar a gcc para las herramientas del host.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan los usos múltiples de
--host_features=<a string>
-
Las funciones proporcionadas se habilitarán o inhabilitarán de forma predeterminada para los destinos compilados en la configuración de ejecución. Si especificas -<feature>, se inhabilitará la función. Las funciones negativas siempre anulan las positivas.
Etiquetas:changes_inputs
,affects_outputs
--host_force_python=<PY2 or PY3>
valor predeterminado: consulta la descripción-
Anula la versión de Python para la configuración del host. Puede ser "PY2" o "PY3".
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan los usos múltiples de
--host_linkopt=<a string>
-
Opción adicional para pasar a gcc cuando se vinculan herramientas del host.
Etiquetas:action_command_lines
,affects_outputs
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
valor predeterminado: consulta la descripción-
Versión mínima de macOS compatible con los destinos de host. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan los usos múltiples de
--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>
-
Opciones adicionales para pasar de forma selectiva al compilador de C/C++ cuando se compilan ciertos archivos en las configuraciones de host o de ejecución. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,…,option_n. Aquí, regex_filter representa una lista de patrones de expresiones regulares de inclusión y exclusión (consulta también --instrumentation_filter), y option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe incluirse entre comillas con una barra diagonal inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos de gcc de todos los archivos .cc en //foo/, excepto bar.cc.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan los usos múltiples de
--host_swiftcopt=<a string>
-
Opciones adicionales para pasar a swiftc para las herramientas del host.
Etiquetas:action_command_lines
,affects_outputs
--[no]incompatible_avoid_conflict_dlls
predeterminado: "true"-
Si está habilitado, todas las bibliotecas de vínculos dinámicos (DLL) de C++ generadas por cc_library en Windows se cambiarán de nombre a name_{hash}.dll, donde hash se calcula en función de RepositoryName y la ruta del paquete de la DLL. Esta opción es útil cuando tienes un paquete que depende de varias cc_library con el mismo nombre (p. ej., //foo/bar1:utils y //foo/bar2:utils).
Etiquetas:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_merge_genfiles_directory
predeterminado: "true"-
Si es verdadero, el directorio genfiles se pliega en el directorio bin.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_use_host_features
predeterminado: "false"-
Si es verdadero, usa --features solo para la configuración de destino y --host_features para la configuración de ejecución.
Etiquetas:changes_inputs
,affects_outputs
,incompatible_change
--[no]incompatible_use_platforms_repo_for_constraints
predeterminado: "true"-
Si es verdadero, se quita la configuración de restricción de @bazel_tools.
Etiquetas:affects_outputs
,incompatible_change
--[no]instrument_test_targets
predeterminado: "false"-
Cuando la cobertura está habilitada, especifica si se deben considerar las reglas de prueba de instrumentación. Cuando se configura, se instrumentan las reglas de prueba incluidas por --instrumentation_filter. De lo contrario, las reglas de prueba siempre se excluyen de la instrumentación de cobertura.
Etiquetas:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
valor predeterminado: "-/javatests[/:],-/test/java[/:]"-
Cuando la cobertura está habilitada, solo se instrumentarán las reglas con nombres incluidos en el filtro basado en regex especificado. En su lugar, se excluyen las reglas que tienen el prefijo "-". Ten en cuenta que solo se instrumentan las reglas que no son de prueba, a menos que se habilite --instrument_test_targets.
Etiquetas:affects_outputs
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
valor predeterminado: consulta la descripción-
Versión mínima compatible de iOS para los simuladores y dispositivos de destino. Si no se especifica, se usa "ios_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan los usos múltiples de
--ios_multi_cpus=<comma-separated list of options>
-
Lista separada por comas de las arquitecturas con las que se compilará un ios_application. El resultado es un binario universal que contiene todas las arquitecturas especificadas.
Etiquetas:loses_incremental_state
,loading_and_analysis
--[no]legacy_whole_archive
predeterminado: "true"-
Obsoleto. Se reemplazó por --incompatible_remove_legacy_whole_archive (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener más detalles). Cuando está activado, usa --whole-archive para las reglas cc_binary que tienen linkshared=True y linkstatic=True o "-static" en linkopts. Esto es solo para la retrocompatibilidad. Una mejor alternativa es usar alwayslink=1 cuando sea necesario.
Etiquetas:action_command_lines
,affects_outputs
,deprecated
- Se acumulan los usos múltiples de
--linkopt=<a string>
-
Opción adicional para pasar a gcc durante la vinculación.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan los usos múltiples de
--ltobackendopt=<a string>
-
Opción adicional para pasar al paso de backend de LTO (en --features=thin_lto).
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan los usos múltiples de
--ltoindexopt=<a string>
-
Opción adicional para pasar al paso de indexación de LTO (en --features=thin_lto).
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan los usos múltiples de
--macos_cpus=<comma-separated list of options>
-
Lista separada por comas de las arquitecturas para las que se compilarán los archivos binarios de Apple macOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
valor predeterminado: consulta la descripción-
Versión mínima de macOS compatible con los destinos. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
--[no]objc_debug_with_GLIBCXX
predeterminado: "false"-
Si se configura y el modo de compilación se establece en "dbg", define GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC y GLIBCPP_CONCEPT_CHECKS.
Etiquetas:action_command_lines
--[no]objc_enable_binary_stripping
predeterminado: "false"-
Indica si se deben quitar los símbolos y el código no utilizado de los archivos binarios vinculados. Se realizará el despojo de binarios si se especifican esta marca y --compilation_mode=opt.
Etiquetas:action_command_lines
- Se acumulan los usos múltiples de
--objccopt=<a string>
-
Opciones adicionales para pasar a gcc cuando se compilan archivos de origen Objective-C/C++.
Etiquetas:action_command_lines
- Se acumulan los usos múltiples de
--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>
-
Opciones adicionales para pasar de forma selectiva a gcc cuando se compilan ciertos archivos. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,…,option_n. Aquí, regex_filter representa una lista de patrones de expresiones regulares de inclusión y exclusión (consulta también --instrumentation_filter), y option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe incluirse entre comillas con una barra diagonal inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos de gcc de todos los archivos cc en //foo/ excepto bar.cc.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan los usos múltiples de
--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>
-
Opciones adicionales para pasar de forma selectiva al backend de LTO (en --features=thin_lto) cuando se compilan ciertos objetos del backend. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,…,option_n. Aquí regex_filter representa una lista de patrones de expresiones regulares de inclusión y exclusión, y option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe incluirse entre comillas con una barra diagonal inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos del backend de LTO de todos los archivos .o en //foo/, excepto bar.o.
Etiquetas:action_command_lines
,affects_outputs
--platform_suffix=<a string>
valor predeterminado: consulta la descripción-
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas:loses_incremental_state
,affects_outputs
,loading_and_analysis
--propeller_optimize=<a build target label>
valor predeterminado: consulta la descripción-
Usa la información del perfil de Propeller para optimizar el destino de compilación.Un perfil de Propeller debe constar de al menos uno de los dos archivos, un perfil de cc y un perfil de ld. Esta marca acepta una etiqueta de compilación que debe hacer referencia a los archivos de entrada del perfil de Propeller. Por ejemplo, el archivo BUILD que define la etiqueta, en a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)Es posible que se deba agregar una directiva exports_files al paquete correspondiente para que Bazel pueda ver estos archivos. La opción se debe usar de la siguiente manera: --propeller_optimize=//a/b:propeller_profile
Etiquetas:action_command_lines
,affects_outputs
--propeller_optimize_absolute_cc_profile=<a string>
valor predeterminado: consulta la descripción-
Nombre de ruta de acceso absoluta del archivo cc_profile para las compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
valor predeterminado: consulta la descripción-
Nombre de ruta de acceso absoluta del archivo ld_profile para las compilaciones optimizadas con Propeller.
Etiquetas:affects_outputs
--run_under=<a prefix in front of command>
valor predeterminado: consulta la descripción-
Prefijo que se insertará antes de los ejecutables para los comandos "test" y "run". Si el valor es "foo -bar" y la línea de comandos de ejecución es "test_binary -baz", la línea de comandos final es "foo -bar test_binary -baz".También puede ser una etiqueta para un destino ejecutable. Algunos ejemplos son "valgrind", "strace", "strace -c", "valgrind --quiet --num-callers=20", "//package:target" y "//package:target --options".
Etiquetas:action_command_lines
-
Si es verdadero, las bibliotecas nativas que contienen la misma funcionalidad se compartirán entre diferentes destinos.
Etiquetas:loading_and_analysis
,affects_outputs
--[no]stamp
predeterminado: "false"-
Sella los archivos binarios con la fecha, el nombre de usuario, el nombre de host, la información del espacio de trabajo, etcétera.
Etiquetas:affects_outputs
- Valor predeterminado de
--strip=<always, sometimes or never>
: "sometimes" -
Especifica si se deben quitar los archivos binarios y las bibliotecas compartidas (con "-Wl,--strip-debug"). El valor predeterminado "sometimes" significa que se quita solo si --compilation_mode=fastbuild.
Etiquetas:affects_outputs
- Se acumulan los usos múltiples de
--stripopt=<a string>
-
Opciones adicionales para pasar a strip cuando se genera un objeto binario "<name>.stripped".
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan los usos múltiples de
--swiftcopt=<a string>
-
Opciones adicionales para pasar a la compilación de Swift.
Etiquetas:action_command_lines
- Se acumulan los usos múltiples de
--tvos_cpus=<comma-separated list of options>
-
Lista separada por comas de las arquitecturas para las que se compilarán los archivos binarios de tvOS de Apple.
Etiquetas:loses_incremental_state
,loading_and_analysis
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
valor predeterminado: consulta la descripción-
Versión mínima compatible de tvOS para los simuladores y dispositivos de destino. Si no se especifica, se usa "tvos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan los usos múltiples de
--visionos_cpus=<comma-separated list of options>
-
Lista separada por comas de las arquitecturas para las que se compilarán los archivos binarios de Apple visionOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Se acumulan los usos múltiples de
--watchos_cpus=<comma-separated list of options>
-
Lista separada por comas de las arquitecturas para las que se compilarán los archivos binarios de watchOS de Apple.
Etiquetas:loses_incremental_state
,loading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
valor predeterminado: consulta la descripción-
Versión mínima compatible de watchOS para los simuladores y dispositivos de destino. Si no se especifica, se usa "watchos_sdk_version".
Etiquetas:loses_incremental_state
--xbinary_fdo=<a build target label>
valor predeterminado: consulta la descripción-
Usa la información del perfil de XbinaryFDO para optimizar la compilación. Especifica el nombre del perfil predeterminado de varias plataformas. Cuando la opción se usa junto con --fdo_instrument/--fdo_optimize/--fdo_profile, esas opciones siempre prevalecerán como si xbinary_fdo nunca se hubiera especificado.
Etiquetas:affects_outputs
- Opciones que afectan la rigidez con la que Bazel aplica las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
- Valor predeterminado de
--auto_cpu_environment_group=<a build target label>
: "" -
Declara el environment_group que se usará para asignar automáticamente los valores de cpu a los valores de target_environment.
Etiquetas:changes_inputs
,loading_and_analysis
,experimental
--[no]check_licenses
predeterminado: "false"-
Verifica que las restricciones de licencias impuestas por los paquetes dependientes no entren en conflicto con los modos de distribución de los destinos que se compilan. De forma predeterminada, no se verifican las licencias.
Etiquetas:build_file_semantics
--[no]check_visibility
predeterminado: "true"-
Si se inhabilita, los errores de visibilidad en las dependencias de destino se degradan a advertencias.
Etiquetas:build_file_semantics
--[no]desugar_for_android
predeterminado: "true"-
Indica si se debe aplicar desugar al código de bytes de Java 8 antes de convertirlo en dex.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]desugar_java8_libs
predeterminado: "false"-
Indica si se deben incluir las bibliotecas de Java 8 compatibles en las apps para dispositivos heredados.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]enforce_constraints
predeterminado: "true"-
Verifica los entornos con los que es compatible cada destino y genera errores si algún destino tiene dependencias que no admiten los mismos entornos.
Etiquetas:build_file_semantics
--[no]experimental_allow_android_library_deps_without_srcs
predeterminado: "false"-
Es una marca para ayudar a la transición de permitir a no permitir reglas android_library sin srcs con dependencias. El depósito debe limpiarse para lanzar esta función de forma predeterminada.
Etiquetas:eagerness_to_exit
,loading_and_analysis
--[no]experimental_check_desugar_deps
predeterminado: "true"-
Indica si se debe verificar la desazucaración correcta a nivel binario de Android.
Etiquetas:eagerness_to_exit
,loading_and_analysis
,experimental
--experimental_import_deps_checking=<off, warning or error>
predeterminado: "OFF"-
Cuando está habilitado, verifica si las dependencias de un aar_import están completas. Esta aplicación de la política puede interrumpir la compilación o simplemente generar advertencias.
Etiquetas:loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
predeterminado: "default"-
Si es verdadero, verifica que un destino de Java declare explícitamente todos los destinos que se usan directamente como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files
predeterminado: "false"-
Si está habilitado, verifica testonly para los destinos de requisitos previos que son archivos de salida buscando el testonly de la regla de generación. Esto coincide con la verificación de visibilidad.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_disable_native_android_rules
predeterminado: "false"-
Si se habilita, se inhabilita el uso directo de las reglas nativas de Android. Usa las reglas de Starlark para Android de https://github.com/bazelbuild/rules_android.
Etiquetas:eagerness_to_exit
,incompatible_change
--[no]incompatible_disable_native_apple_binary_rule
predeterminado: "false"-
No realiza ninguna operación. Se mantiene aquí para la retrocompatibilidad.
Etiquetas:eagerness_to_exit
,incompatible_change
--[no]incompatible_force_strict_header_check_from_starlark
predeterminado: "true"-
Si está habilitado, establece la verificación estricta de encabezados en la API de Starlark.
Etiquetas:loading_and_analysis
,changes_inputs
,incompatible_change
--[no]incompatible_validate_top_level_header_inclusions
predeterminado: "true"-
Si es verdadero, Bazel también validará las inclusiones de encabezado de directorio de nivel superior (consulta https://github.com/bazelbuild/bazel/issues/10047 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]strict_filesets
predeterminado: "false"-
Si esta opción está habilitada, los conjuntos de archivos que cruzan los límites del paquete se informan como errores. No funciona cuando check_fileset_dependencies_recursively está inhabilitado.
Etiquetas:build_file_semantics
,eagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default>
predeterminado: "error"-
A menos que esté DESACTIVADO, verifica que un destino proto_library declare explícitamente todos los destinos utilizados directamente como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
--strict_public_imports=<off, warn, error, strict or default>
predeterminado: "off"-
A menos que esté DESACTIVADO, verifica que un destino proto_library declare de forma explícita todos los destinos que se usan en "import public" como exportados.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
--[no]strict_system_includes
predeterminado: "false"-
Si es verdadero, también se deben declarar los encabezados que se encuentran a través de las rutas de inclusión del sistema (-isystem).
Etiquetas:loading_and_analysis
,eagerness_to_exit
- Se acumulan los usos múltiples de
--target_environment=<a build target label>
-
Declara el entorno de destino de esta compilación. Debe ser una referencia de etiqueta a una regla "environment". Si se especifica, todos los objetivos de nivel superior deben ser compatibles con este entorno.
Etiquetas:changes_inputs
- Opciones que afectan los resultados de la firma de una compilación:
--apk_signing_method=<v1, v2, v1_v2 or v4>
predeterminado: "v1_v2"-
Implementación que se usará para firmar APKs
Etiquetas:action_command_lines
,affects_outputs
,loading_and_analysis
--[no]device_debug_entitlements
predeterminado: "true"-
Si se configura y el modo de compilación no es "opt", las apps en Objective-C incluirán derechos de depuración cuando se firmen.
Etiquetas:changes_inputs
--ios_signing_cert_name=<a string>
valor predeterminado: consulta la descripción-
Nombre del certificado que se usará para la firma de iOS. Si no se configura, se volverá al perfil de aprovisionamiento. Puede ser la preferencia de identidad del llavero del certificado o una subcadena del nombre común del certificado, según la página de manual de codesign (IDENTIDADES DE FIRMA).
Etiquetas:action_command_lines
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]incompatible_disallow_legacy_py_provider
predeterminado: "true"-
No-op, se quitará pronto.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones que rigen el comportamiento del entorno de prueba o del ejecutor de pruebas:
--[no]allow_analysis_failures
predeterminado: "false"-
Si es verdadero, un error de análisis de un destino de regla hace que el destino propague una instancia de AnalysisFailureInfo que contiene la descripción del error, en lugar de generar un error de compilación.
Etiquetas:loading_and_analysis
,experimental
--analysis_testing_deps_limit=<an integer>
predeterminado: "2000"-
Establece la cantidad máxima de dependencias transitivas a través de un atributo de regla con una transición de configuración for_analysis_testing. Si se supera este límite, se generará un error de regla.
Etiquetas:loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure
predeterminado: "false"-
Si es verdadero, los errores de la acción dex2oat harán que se interrumpa la compilación en lugar de ejecutar dex2oat durante el tiempo de ejecución de la prueba.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_android_use_parallel_dex2oat
predeterminado: "false"-
Usa dex2oat en paralelo para acelerar android_test.
Etiquetas:loading_and_analysis
,host_machine_resource_optimizations
,experimental
--[no]ios_memleaks
predeterminado: "false"-
Habilita la verificación de pérdidas de memoria en los destinos de ios_test.
Etiquetas:action_command_lines
--ios_simulator_device=<a string>
valor predeterminado: consulta la descripción-
Es el dispositivo que se simulará cuando se ejecute una aplicación para iOS en el simulador, p.ej., "iPhone 6". Puedes obtener una lista de dispositivos ejecutando "xcrun simctl list devicetypes" en la máquina en la que se ejecutará el simulador.
Etiquetas:test_runner
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
valor predeterminado: consulta la descripción-
Versión de iOS que se ejecutará en el simulador cuando se ejecute o pruebe. Se ignora para las reglas de ios_test si se especifica un dispositivo objetivo en la regla.
Etiquetas:test_runner
- Se acumulan los usos múltiples de
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
- Especifica la cantidad de veces que se ejecutará cada prueba. Si alguno de esos intentos falla por algún motivo, se considera que toda la prueba falló. Normalmente, el valor especificado es solo un número entero. Ejemplo: --runs_per_test=3 ejecutará todas las pruebas 3 veces. Sintaxis alternativa: regex_filter@runs_per_test. Aquí runs_per_test representa un valor entero y regex_filter representa una lista de patrones de expresiones regulares de inclusión y exclusión (consulta también --instrumentation_filter). Ejemplo: --runs_per_test=//foo/.*,-//foo/bar/.*@3 ejecuta todas las pruebas en //foo/ excepto las que se encuentran en foo/bar tres veces. Esta opción se puede pasar varias veces. Tiene prioridad el argumento que se pasó más recientemente y que coincide. Si no hay coincidencias, la prueba solo se ejecuta una vez.
- Se acumulan los usos múltiples de
--test_env=<a 'name=value' assignment with an optional value part>
-
Especifica variables de entorno adicionales que se insertarán en el entorno del ejecutor de pruebas. Las variables se pueden especificar por nombre, en cuyo caso su valor se leerá del entorno del cliente de Bazel, o por el par nombre=valor. Esta opción se puede usar varias veces para especificar varias variables. Solo se usa con el comando "bazel test".
Etiquetas:test_runner
- Valor predeterminado de
--test_timeout=<a single integer or comma-separated list of 4 integers>
: "-1" - Anula los valores predeterminados de tiempo de espera de la prueba (en segundos). Si se especifica un solo valor de número entero positivo, se anularán todas las categorías. Si se especifican 4 números enteros separados por comas, se anularán los tiempos de espera para corto, moderado, largo y eterno (en ese orden). En cualquiera de las dos formas, un valor de -1 le indica a Blaze que use sus tiempos de espera predeterminados para esa categoría.
--tvos_simulator_device=<a string>
valor predeterminado: consulta la descripción-
El dispositivo que se simulará cuando se ejecute una aplicación para tvOS en el simulador, p.ej., "Apple TV 1080p". Puedes obtener una lista de dispositivos ejecutando "xcrun simctl list devicetypes" en la máquina en la que se ejecutará el simulador.
Etiquetas:test_runner
--tvos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
valor predeterminado: consulta la descripción-
Es la versión de tvOS que se ejecutará en el simulador cuando se ejecute o pruebe.
Etiquetas:test_runner
--watchos_simulator_device=<a string>
valor predeterminado: consulta la descripción-
El dispositivo que se simulará cuando se ejecute una aplicación para watchOS en el simulador, p.ej., "Apple Watch - 38mm". Puedes obtener una lista de dispositivos ejecutando "xcrun simctl list devicetypes" en la máquina en la que se ejecutará el simulador.
Etiquetas:test_runner
--watchos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
valor predeterminado: consulta la descripción-
Versión de watchOS que se ejecutará en el simulador cuando se ejecute o pruebe.
Etiquetas:test_runner
--[no]zip_undeclared_test_outputs
predeterminado: "true"-
Si es verdadero, los resultados de las pruebas no declarados se archivarán en un archivo ZIP.
Etiquetas:test_runner
- Opciones relacionadas con la semántica y el resultado de la búsqueda:
--aspect_deps=<off, conservative or precise>
valor predeterminado: "conservative"-
Cómo resolver las dependencias de aspectos cuando el formato de salida es uno de {xml,proto,record}. "off" significa que no se resuelve ninguna dependencia de aspectos; "conservative" (el valor predeterminado) significa que se agregan todas las dependencias de aspectos declaradas, independientemente de si se les asigna la clase de regla de dependencias directas; "precise" significa que solo se agregan aquellos aspectos que posiblemente estén activos dada la clase de regla de las dependencias directas. Ten en cuenta que el modo preciso requiere cargar otros paquetes para evaluar un solo objetivo, lo que lo hace más lento que los otros modos. También ten en cuenta que incluso el modo preciso no es completamente preciso: la decisión de calcular un aspecto se toma en la fase de análisis, que no se ejecuta durante "bazel query".
Etiquetas:build_file_semantics
--[no]consistent_labels
predeterminado: "false"-
Si está habilitado, cada comando de consulta emite etiquetas como si se aplicara la función <code>str</code> de Starlark a una instancia de <code>Label</code>. Esto es útil para las herramientas que necesitan coincidir con el resultado de diferentes comandos de consulta o etiquetas emitidas por reglas. Si no está habilitado, los formateadores de salida pueden emitir nombres de repositorio aparentes (relativos al repositorio principal) para que la salida sea más legible.
Etiquetas:terminal_output
--[no]deduplicate_depsets
predeterminado: "true"-
Se quitan los duplicados de los elementos secundarios que no son hojas de un dep_set_of_files en el resultado final de proto/textproto/json. Esto no anula el duplicado de los depsets que no comparten un elemento superior inmediato. Esto no afecta la lista final efectiva de artefactos de entrada de las acciones.
Etiquetas:terminal_output
--[no]graph:factored
predeterminado: "true"-
Si es verdadero, el gráfico se emitirá "factorizado", es decir, los nodos topológicamente equivalentes se combinarán y sus etiquetas se concatenarán. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--graph:node_limit=<an integer>
valor predeterminado: "512"-
Es la longitud máxima de la cadena de etiqueta para un nodo de gráfico en el resultado. Las etiquetas más largas se truncarán. El valor -1 significa que no se truncarán. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--[no]implicit_deps
predeterminado: "true"-
Si está habilitado, las dependencias implícitas se incluirán en el gráfico de dependencias sobre el que opera la consulta. Una dependencia implícita es aquella que no se especifica de forma explícita en el archivo BUILD, pero que Bazel agrega. En el caso de cquery, esta opción controla el filtrado de las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
--[no]include_artifacts
predeterminado: "true"-
Incluye los nombres de las entradas y salidas de la acción en el resultado (potencialmente grande).
Etiquetas:terminal_output
--[no]include_aspects
predeterminado: "true"-
aquery, cquery: Indica si se deben incluir las acciones generadas por aspectos en el resultado. query: No es una operación (los aspectos siempre se siguen).
Etiquetas:terminal_output
--[no]include_commandline
predeterminado: "true"-
Incluye el contenido de las líneas de comandos de acción en el resultado (puede ser grande).
Etiquetas:terminal_output
--[no]include_file_write_contents
predeterminado: "false"-
Incluye el contenido del archivo para las acciones FileWrite y SourceSymlinkManifest (potencialmente grandes).
Etiquetas:terminal_output
--[no]include_param_files
predeterminado: "false"-
Incluye el contenido de los archivos de parámetros que se usan en el comando (podría ser grande). Nota: Si habilitas esta marca, se habilitará automáticamente la marca --include_commandline.
Etiquetas:terminal_output
--[no]incompatible_display_source_file_location
predeterminado: "true"-
Es verdadero de forma predeterminada y muestra el destino del archivo fuente. Si es verdadero, muestra la ubicación de la línea 1 de los archivos fuente en los resultados de ubicación. Esta marca solo existe para fines de migración.
Etiquetas:terminal_output
,incompatible_change
--[no]incompatible_package_group_includes_double_slash
predeterminado: "true"-
Si está habilitado, cuando se genere el atributo `packages` de package_group, no se omitirá el `//` inicial.
Etiquetas:terminal_output
,incompatible_change
--[no]infer_universe_scope
predeterminado: "false"-
Si se configura y no se configura --universe_scope, se inferirá un valor de --universe_scope como la lista de patrones de destino únicos en la expresión de búsqueda. Ten en cuenta que el valor de --universe_scope que se infiere para una expresión de búsqueda que usa funciones con alcance del universo (p.ej., "allrdeps") podría no ser el que deseas, por lo que debes usar esta opción solo si sabes lo que haces. Consulta https://bazel.build/reference/query#sky-query para obtener detalles y ejemplos. Si se establece --universe_scope, se ignora el valor de esta opción. Nota: Esta opción solo se aplica a `query` (es decir, no a `cquery`).
Etiquetas:loading_and_analysis
--[no]line_terminator_null
predeterminado: "false"-
Indica si cada formato termina con \0 en lugar de un salto de línea.
Etiquetas:terminal_output
--[no]nodep_deps
predeterminado: "true"-
Si está habilitado, las dependencias de los atributos "nodep" se incluirán en el gráfico de dependencias sobre el que opera la consulta. Un ejemplo común de un atributo "nodep" es "visibilidad". Ejecuta y analiza el resultado de `info build-language` para obtener información sobre todos los atributos "nodep" en el lenguaje de compilación.
Etiquetas:build_file_semantics
--output=<a string>
predeterminado: "text"-
Es el formato en el que se deben imprimir los resultados de aquery. Los valores permitidos para aquery son: text, textproto, proto y jsonproto.
Etiquetas:terminal_output
--[no]proto:default_values
predeterminado: "true"-
Si es verdadero, se incluyen los atributos cuyo valor no se especifica de forma explícita en el archivo BUILD; de lo contrario, se omiten. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
--[no]proto:definition_stack
predeterminado: "false"-
Propaga el campo proto definition_stack, que registra para cada instancia de regla la pila de llamadas de Starlark en el momento en que se definió la clase de la regla.
Etiquetas:terminal_output
--[no]proto:flatten_selects
predeterminado: "true"-
Si está habilitado, los atributos configurables creados por select() se aplanan. En el caso de los tipos de lista, la representación aplanada es una lista que contiene cada valor del mapa de selección exactamente una vez. Los tipos escalares se aplanan a nulos.
Etiquetas:build_file_semantics
--[no]proto:include_synthetic_attribute_hash
predeterminado: "false"-
Indica si se debe calcular y completar el atributo $internal_attr_hash.
Etiquetas:terminal_output
--[no]proto:instantiation_stack
predeterminado: "false"-
Propaga la pila de llamadas de instanciación de cada regla. Ten en cuenta que esto requiere que la pila esté presente.
Etiquetas:terminal_output
--[no]proto:locations
predeterminado: "true"-
Indica si se debe generar información de ubicación en la salida de proto.
Etiquetas:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
predeterminado: "all"-
Lista de atributos separados por comas que se incluirán en el resultado. La configuración predeterminada incluye todos los atributos. Se establece en una cadena vacía para no generar ningún atributo. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
--[no]proto:rule_inputs_and_outputs
predeterminado: "true"-
Indica si se deben propagar los campos rule_input y rule_output.
Etiquetas:terminal_output
- Valor predeterminado de
--query_file=<a string>
: "" -
Si se configura, la consulta leerá la consulta del archivo que se nombra aquí, en lugar de hacerlo desde la línea de comandos. Es un error especificar un archivo aquí y una consulta de línea de comandos.
Etiquetas:changes_inputs
--[no]relative_locations
predeterminado: "false"-
Si es verdadero, la ubicación de los archivos BUILD en las salidas de XML y proto será relativa. De forma predeterminada, la salida de ubicación es una ruta de acceso absoluta y no será coherente en todas las máquinas. Puedes establecer esta opción como verdadera para obtener un resultado coherente en todas las máquinas.
Etiquetas:terminal_output
--[no]skyframe_state
predeterminado: "false"-
Sin realizar análisis adicionales, vuelca el Action Graph actual de Skyframe. Nota: Por el momento, no se admite la especificación de un destino con --skyframe_state. Esta marca solo está disponible con --output=proto o --output=textproto.
Etiquetas:terminal_output
--[no]tool_deps
predeterminado: "true"-
Consulta: Si está inhabilitada, las dependencias de los destinos de "configuración del host" o "ejecución" no se incluirán en el gráfico de dependencias sobre el que opera la consulta. Un borde de dependencia de "configuración del host", como el que va de cualquier regla "proto_library" al compilador de Protocolos, suele apuntar a una herramienta que se ejecuta durante la compilación en lugar de a una parte del mismo programa "target".
Cquery: Si está inhabilitado, filtra todos los destinos configurados que cruzan una transición de host o de ejecución desde el destino de nivel superior que descubrió este destino configurado. Esto significa que, si el destino de nivel superior está en la configuración de destino, solo se devolverán los destinos configurados que también estén en la configuración de destino. Si el destino de nivel superior está en la configuración del host, solo se devolverán los destinos configurados del host. Esta opción NO excluirá las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
- Valor predeterminado de
--universe_scope=<comma-separated list of options>
: "" -
Es un conjunto de patrones de segmentación (aditivos y sustractivos) separados por comas. La consulta se puede realizar en el universo definido por el cierre transitivo de los destinos especificados. Esta opción se usa para los comandos query y cquery.
En el caso de cquery, la entrada de esta opción son los destinos en los que se compilan todas las respuestas, por lo que esta opción puede afectar las configuraciones y las transiciones. Si no se especifica esta opción, se supone que los destinos de nivel superior son los que se analizan a partir de la expresión de búsqueda. Nota: En el caso de cquery, no especificar esta opción puede provocar que se interrumpa la compilación si los destinos analizados a partir de la expresión de la consulta no se pueden compilar con las opciones de nivel superior.
Etiquetas:loading_and_analysis
- Opciones que activan optimizaciones del tiempo de compilación:
--[no]collapse_duplicate_defines
predeterminado: "false"-
Cuando está habilitado, los --defines redundantes se quitarán al principio de la compilación. Esto evita la pérdida innecesaria de la caché de análisis para ciertos tipos de compilaciones equivalentes.
Etiquetas:loading_and_analysis
,loses_incremental_state
--[no]experimental_filter_library_jar_with_program_jar
predeterminado: "false"-
Filtra el ProgramJar de ProGuard para quitar las clases que también estén presentes en el LibraryJar.
Etiquetas:action_command_lines
--[no]experimental_inmemory_dotd_files
predeterminado: "true"-
Si está habilitado, los archivos .d de C++ se pasarán por la memoria directamente desde los nodos de compilación remotos en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_inmemory_jdeps_files
predeterminado: "true"-
Si está habilitado, los archivos de dependencia (.jdeps) generados a partir de las compilaciones de Java se pasarán a través de la memoria directamente desde los nodos de compilación remotos en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_objc_include_scanning
predeterminado: "false"-
Indica si se debe realizar el análisis de inclusión para Objective-C/C++.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
--[no]experimental_parse_headers_skipped_if_corresponding_srcs_found
predeterminado: "false"-
Si está habilitada, la función parse_headers no crea una acción de compilación de encabezado separada si se encuentra una fuente con el mismo nombre base en el mismo destino.
Etiquetas:loading_and_analysis
,affects_outputs
--[no]experimental_retain_test_configuration_across_testonly
predeterminado: "false"-
Cuando está habilitado, --trim_test_configuration no recortará la configuración de prueba para las reglas marcadas como testonly=1. Esto tiene como objetivo reducir los problemas de conflicto de acciones cuando las reglas que no son de prueba dependen de las reglas cc_test. No tiene efecto si --trim_test_configuration es falso.
Etiquetas:loading_and_analysis
,loses_incremental_state
--[no]experimental_starlark_cc_import
predeterminado: "false"-
Si está habilitado, se puede usar la versión de Starlark de cc_import.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_unsupported_and_brittle_include_scanning
predeterminado: "false"-
Indica si se deben reducir las entradas a la compilación de C/C++ analizando las líneas #include de los archivos de entrada. Esto puede mejorar el rendimiento y la incrementalidad, ya que disminuye el tamaño de los árboles de entrada de compilación. Sin embargo, también puede interrumpir las compilaciones porque el analizador de inclusión no implementa por completo la semántica del preprocesador de C. En particular, no comprende las directivas #include dinámicas y omite la lógica condicional del preprocesador. Úsala bajo tu propia responsabilidad. Se cerrarán todos los problemas relacionados con este parámetro que se registren.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
--[no]incremental_dexing
predeterminado: "true"-
Realiza la mayor parte del trabajo de dexing por separado para cada archivo Jar.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]objc_use_dotd_pruning
predeterminado: "true"-
Si se configura, los archivos .d que emite clang se usarán para reducir el conjunto de entradas que se pasan a las compilaciones de objc.
Etiquetas:changes_inputs
,loading_and_analysis
--[no]process_headers_in_dependencies
predeterminado: "false"-
Cuando se compila un destino //a:a, se procesan los encabezados en todos los destinos de los que depende //a:a (si el procesamiento de encabezados está habilitado para la cadena de herramientas).
Etiquetas:execution
--[no]trim_test_configuration
predeterminado: "true"-
Cuando se habilita, las opciones relacionadas con las pruebas se borrarán debajo del nivel superior de la compilación. Cuando esta marca está activa, las pruebas no se pueden compilar como dependencias de reglas que no son de prueba, pero los cambios en las opciones relacionadas con las pruebas no harán que se vuelvan a analizar las reglas que no son de prueba.
Etiquetas:loading_and_analysis
,loses_incremental_state
--[no]use_singlejar_apkbuilder
predeterminado: "true"-
Esta opción está obsoleta. Ahora es una operación nula y se quitará pronto.
Etiquetas:loading_and_analysis
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Valor predeterminado de
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "-.*" -
Imprime información de depuración durante la resolución de la cadena de herramientas. La marca toma una regex, que se verifica con los tipos de cadenas de herramientas y los objetivos específicos para ver cuáles depurar. Se pueden separar varias expresiones regulares con comas y, luego, se verifica cada una por separado. Nota: El resultado de esta marca es muy complejo y es probable que solo sea útil para los expertos en la resolución de cadenas de herramientas.
Etiquetas:terminal_output
- Opciones que especifican o alteran una entrada genérica para un comando de Bazel que no se incluye en otras categorías.:
- Se acumulan los usos múltiples de
--flag_alias=<a 'name=value' flag alias>
-
Establece un nombre abreviado para una marca de Starlark. Toma un solo par clave-valor en el formato "<clave>=<valor>" como argumento.
Etiquetas:changes_inputs
--[no]incompatible_default_to_explicit_init_py
predeterminado: "false"-
Esta marca cambia el comportamiento predeterminado para que los archivos __init__.py ya no se creen automáticamente en los archivos ejecutables de los destinos de Python. Específicamente, cuando un destino py_binary o py_test tiene legacy_create_init establecido en "auto" (el valor predeterminado), se trata como falso si y solo si se establece esta marca. Consulta https://github.com/bazelbuild/bazel/issues/10076.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_py2_outputs_are_suffixed
predeterminado: "true"-
Si es verdadero, los destinos compilados en la configuración de Python 2 aparecerán en una raíz de salida que incluye el sufijo "-py2", mientras que los destinos compilados para Python 3 aparecerán en una raíz sin sufijo relacionado con Python. Esto significa que el vínculo simbólico de conveniencia `bazel-bin` apuntará a destinos de Python 3 en lugar de Python 2. Si habilitas esta opción, también se recomienda habilitar `--incompatible_py3_is_default`.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_py3_is_default
predeterminado: "true"-
Si es verdadero, los destinos `py_binary` y `py_test` que no configuren su atributo `python_version` (o `default_python_version`) se establecerán de forma predeterminada en PY3 en lugar de PY2. Si estableces esta marca, también se recomienda establecer `--incompatible_py2_outputs_are_suffixed`.
Etiquetas:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_use_python_toolchains
predeterminado: "true"-
Si se establece como verdadero, las reglas ejecutables de Python nativo usarán el entorno de ejecución de Python especificado por la cadena de herramientas de Python, en lugar del entorno de ejecución proporcionado por marcas heredadas como --python_top.
Etiquetas:loading_and_analysis
,incompatible_change
--python_version=<PY2 or PY3>
valor predeterminado: consulta la descripción-
Modo de versión principal de Python, ya sea "PY2" o "PY3". Ten en cuenta que los objetivos "py_binary" y "py_test" anulan este parámetro (incluso si no especifican una versión de forma explícita), por lo que, por lo general, no hay muchos motivos para proporcionar esta marca.
Etiquetas:loading_and_analysis
,affects_outputs
,explicit_in_output_path
- Opciones varias, no clasificadas de otra manera.:
--[no]cache_test_results
[-t
] default: "auto"- Si se configura como "auto", Bazel vuelve a ejecutar una prueba solo si se cumplen las siguientes condiciones: (1) Bazel detecta cambios en la prueba o sus dependencias, (2) la prueba se marca como externa, (3) se solicitaron varias ejecuciones de prueba con --runs_per_test o(4) la prueba falló anteriormente. Si se configura como “sí”, Bazel almacena en caché todos los resultados de las pruebas, excepto las que se marcan como externas. Si se configura como "no", Bazel no almacena en caché ningún resultado de la prueba.
--[no]experimental_cancel_concurrent_tests
predeterminado: "false"-
Si es verdadero, Blaze cancelará las pruebas que se ejecuten de forma simultánea en la primera ejecución exitosa. Esto solo es útil en combinación con --runs_per_test_detects_flakes.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_fetch_all_coverage_outputs
predeterminado: "false"-
Si es verdadero, Bazel recupera el directorio completo de datos de cobertura para cada prueba durante una ejecución de cobertura.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_generate_llvm_lcov
predeterminado: "false"-
Si es verdadero, la cobertura de clang generará un informe de LCOV.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_j2objc_header_map
predeterminado: "true"- Indica si se debe generar el mapa de encabezado de J2ObjC en paralelo con la transpilación de J2ObjC.
--[no]experimental_j2objc_shorter_header_path
predeterminado: "false"-
Indica si se debe generar con una ruta de encabezado más corta (usa "_ios" en lugar de "_j2objc").
Etiquetas:affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
predeterminado: "javabuilder"- Habilita rutas de acceso de clase reducidas para las compilaciones de Java.
--[no]experimental_limit_android_lint_to_android_constrained_java
predeterminado: "false"-
Limita --experimental_run_android_lint_on_java_rules a las bibliotecas compatibles con Android.
Etiquetas:affects_outputs
--[no]experimental_run_android_lint_on_java_rules
predeterminado: "false"-
Indica si se deben validar las fuentes java_*.
Etiquetas:affects_outputs
--[no]explicit_java_test_deps
predeterminado: "false"- Especifica de forma explícita una dependencia de JUnit o Hamcrest en un java_test en lugar de obtenerla accidentalmente de las dependencias de TestRunner. Por el momento, solo funciona para Bazel.
--host_java_launcher=<a build target label>
valor predeterminado: consulta la descripción- Es el launcher de Java que usan las herramientas que se ejecutan durante una compilación.
- Se acumulan los usos múltiples de
--host_javacopt=<a string>
- Opciones adicionales para pasar a javac cuando se compilan herramientas que se ejecutan durante una compilación.
- Se acumulan los usos múltiples de
--host_jvmopt=<a string>
- Opciones adicionales para pasar a la VM de Java cuando se compilan herramientas que se ejecutan durante la compilación. Estas opciones se agregarán a las opciones de inicio de la VM de cada destino java_binary.
--[no]incompatible_check_sharding_support
predeterminado: "false"-
Si es verdadero, Bazel fallará una prueba fragmentada si el ejecutor de pruebas no indica que admite el fragmentado tocando el archivo en la ruta de TEST_SHARD_STATUS_FILE. Si es falso, un ejecutor de pruebas que no admite la fragmentación hará que todas las pruebas se ejecuten en cada fragmento.
Etiquetas:incompatible_change
--[no]incompatible_exclusive_test_sandboxed
predeterminado: "false"-
Si es verdadero, las pruebas exclusivas se ejecutarán con la estrategia de zona de pruebas. Agrega la etiqueta "local" para forzar una ejecución de prueba exclusiva de forma local.
Etiquetas:incompatible_change
--[no]incompatible_strict_action_env
predeterminado: "false"-
Si es verdadero, Bazel usa un entorno con un valor estático para PATH y no hereda LD_LIBRARY_PATH. Usa --action_env=ENV_VARIABLE si deseas heredar variables de entorno específicas del cliente, pero ten en cuenta que esto puede impedir el almacenamiento en caché entre usuarios si se usa una caché compartida.
Etiquetas:loading_and_analysis
,incompatible_change
- Se acumulan los usos múltiples de
--j2objc_translation_flags=<comma-separated list of options>
- Opciones adicionales para pasar a la herramienta J2ObjC.
--java_debug
-
Hace que la máquina virtual de Java de una prueba de Java espere una conexión de un depurador compatible con JDWP (como jdb) antes de iniciar la prueba. Implica -test_output=streamed.
Se expande a:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
--[no]java_deps
predeterminado: "true"- Genera información de dependencia (por ahora, classpath de tiempo de compilación) por destino de Java.
--[no]java_header_compilation
predeterminado: "true"- Compila archivos .ijar directamente desde la fuente.
--java_language_version=<a string>
predeterminado: "8"- La versión del lenguaje Java
--java_launcher=<a build target label>
valor predeterminado: consulta la descripción- Es el lanzador de Java que se usará cuando se compilen archivos binarios de Java. Si esta marca se establece en la cadena vacía, se usa el iniciador del JDK. El atributo "launcher" anula esta marca.
--java_runtime_version=<a string>
valor predeterminado: "local_jdk"- La versión del entorno de ejecución de Java
- Se acumulan los usos múltiples de
--javacopt=<a string>
- Opciones adicionales para pasar a javac.
- Se acumulan los usos múltiples de
--jvmopt=<a string>
- Opciones adicionales para pasar a la JVM de Java. Estas opciones se agregarán a las opciones de inicio de la VM de cada destino java_binary.
--legacy_main_dex_list_generator=<a build target label>
valor predeterminado: consulta la descripción- Especifica un archivo binario que se usará para generar la lista de clases que deben estar en el archivo dex principal cuando se compile multidex heredado.
- Se acumulan los usos múltiples de
--plugin=<a build target label>
- Son los complementos que se usarán en la compilación. Actualmente, funciona con java_plugin.
--proguard_top=<a build target label>
valor predeterminado: consulta la descripción- Especifica qué versión de ProGuard se usará para quitar código cuando se compile un archivo binario de Java.
--proto_compiler=<a build target label>
default: "@bazel_tools//tools/proto:protoc"-
Es la etiqueta del compilador de .proto.
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
default: "@bazel_tools//tools/proto:cc_toolchain"-
Etiqueta de proto_lang_toolchain() que describe cómo compilar protos de C++
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
valor predeterminado: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"-
Etiqueta de proto_lang_toolchain() que describe cómo compilar protos de j2objc
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
default: "@bazel_tools//tools/proto:java_toolchain"-
Etiqueta de proto_lang_toolchain() que describe cómo compilar protos de Java
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
default: "@bazel_tools//tools/proto:javalite_toolchain"-
Etiqueta de proto_lang_toolchain() que describe cómo compilar protos de JavaLite
Etiquetas:affects_outputs
,loading_and_analysis
- Se acumulan los usos múltiples de
--protocopt=<a string>
-
Opciones adicionales para pasar al compilador de protobuf.
Etiquetas:affects_outputs
--[no]runs_per_test_detects_flakes
predeterminado: "false"- Si es verdadero, cualquier fragmento en el que se apruebe al menos una ejecución o intento y falle al menos una ejecución o intento obtendrá el estado FLAKY.
--shell_executable=<a path>
valor predeterminado: consulta la descripción-
Ruta de acceso absoluta al ejecutable del shell que Bazel debe usar. Si no se configura, pero la variable de entorno BAZEL_SH se establece en la primera invocación de Bazel (que inicia un servidor de Bazel), Bazel la usa. Si no se establece ninguno, Bazel usa una ruta de acceso predeterminada codificada de forma rígida según el sistema operativo en el que se ejecuta (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, todos los demás: /bin/bash). Ten en cuenta que usar un shell que no sea compatible con bash puede provocar fallas en la compilación o en el tiempo de ejecución de los archivos binarios generados.
Etiquetas:loading_and_analysis
- Se acumulan los usos múltiples de
--test_arg=<a string>
- Especifica argumentos y opciones adicionales que se deben pasar al ejecutable de la prueba. Se puede usar varias veces para especificar varios argumentos. Si se ejecutan varias pruebas, cada una de ellas recibirá argumentos idénticos. Solo se usa con el comando "bazel test".
--test_filter=<a string>
valor predeterminado: consulta la descripción- Especifica un filtro para reenviar al framework de pruebas. Se usa para limitar las pruebas que se ejecutan. Ten en cuenta que esto no afecta los destinos que se compilan.
- Valor predeterminado de
--test_result_expiration=<an integer>
: "-1" - Esta opción está obsoleta y no tiene ningún efecto.
--[no]test_runner_fail_fast
predeterminado: "false"- Reenvía la opción de falla rápida al ejecutor de pruebas. El ejecutor de pruebas debe detener la ejecución ante el primer error.
--test_sharding_strategy=<explicit or disabled>
predeterminado: "explícito"- Especifica la estrategia para la división de pruebas: "explícita" para usar la división solo si el atributo de compilación "shard_count" está presente. "disabled" para no usar nunca la división de pruebas.
--tool_java_language_version=<a string>
predeterminado: "8"- Versión del lenguaje Java que se usa para ejecutar las herramientas necesarias durante una compilación
--tool_java_runtime_version=<a string>
valor predeterminado: "remotejdk_11"- Versión del entorno de ejecución de Java que se usa para ejecutar herramientas durante la compilación
--[no]use_ijars
predeterminado: "true"- Si se habilita, esta opción hace que la compilación de Java use archivos .jar de interfaz. Esto generará una compilación incremental más rápida, pero los mensajes de error pueden ser diferentes.
Opciones de compilación
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan los usos múltiples de
--distdir=<a path>
-
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: "false"-
Si se configura, la caché del repositorio creará un vínculo físico al archivo en caso de acierto de caché, en lugar de copiarlo. Esto tiene como objetivo ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
predeterminado: "false"-
Si es verdadero, usa una cadena derivada de las URLs de las descargas del repositorio como canonical_id si no se especifica. Esto hace que un cambio en las URLs genere una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no provoquen que la caché oculte repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
predeterminado: "false"-
Si se configura, no se permite la descarga de repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark según este factor. De esta manera, los repositorios externos pueden funcionar en máquinas más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Ajusta todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
valor predeterminado: consulta la descripción-
Especifica la ubicación de la caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de la compilación:
--[no]check_up_to_date
predeterminado: "false"-
No realices la compilación, solo verifica si está actualizada. Si todos los destinos están actualizados, la compilación se completa correctamente. Si se debe ejecutar algún paso, se informa un error y falla la compilación.
Etiquetas:execution
--dynamic_local_execution_delay=<an integer>
predeterminado: "1000"-
¿Cuántos milisegundos se debe retrasar la ejecución local si la ejecución remota fue más rápida durante una compilación al menos una vez?
Etiquetas:execution
,host_machine_resource_optimizations
- Se acumulan los usos múltiples de
--dynamic_local_strategy=<a '[name=]value1[,..,valueN]' assignment>
-
Son las estrategias locales, en orden, que se usarán para la mnemónica determinada. Si pasas "local" como mnemónico, se establece el valor predeterminado para los mnemónicos no especificados. Toma [mnemonic=]local_strategy[,local_strategy,...]
Etiquetas:execution
,host_machine_resource_optimizations
- Se acumulan los usos múltiples de
--dynamic_remote_strategy=<a '[name=]value1[,..,valueN]' assignment>
-
Son las estrategias remotas que se usarán para la mnemónica determinada. Si pasas "remote" como mnemónico, se establece el valor predeterminado para los mnemónicos no especificados. Toma [mnemonic=]remote_strategy[,remote_strategy,...]
Etiquetas:execution
,host_machine_resource_optimizations
- Valor predeterminado de
--experimental_docker_image=<a string>
: "" -
Especifica un nombre de imagen de Docker (p.ej., "ubuntu:latest") que se debe usar para ejecutar una acción en zona de pruebas cuando se usa la estrategia de Docker y la acción en sí aún no tiene un atributo container-image en sus remote_execution_properties en la descripción de la plataforma. El valor de esta marca se pasa literalmente a "docker run", por lo que admite la misma sintaxis y los mismos mecanismos que Docker.
Etiquetas:execution
--[no]experimental_docker_use_customized_images
predeterminado: "true"-
Si está habilitado, inyecta el UID y el GID del usuario actual en la imagen de Docker antes de usarla. Esto es obligatorio si tu compilación o tus pruebas dependen de que el usuario tenga un nombre y un directorio principal dentro del contenedor. Esta opción está activada de forma predeterminada, pero puedes inhabilitarla en caso de que la función de personalización automática de imágenes no funcione en tu caso o sepas que no la necesitas.
Etiquetas:execution
--[no]experimental_dynamic_exclude_tools
predeterminado: "true"-
Cuando se configura, los objetivos que se compilan "para la herramienta" no están sujetos a la ejecución dinámica. Es muy poco probable que estos destinos se compilen de forma incremental, por lo que no vale la pena dedicarles ciclos locales.
Etiquetas:execution
,host_machine_resource_optimizations
--experimental_dynamic_local_load_factor=<a double>
predeterminado: "0"-
Controla la cantidad de carga de la ejecución dinámica que se debe colocar en la máquina local. Esta marca ajusta la cantidad de acciones en la ejecución dinámica que programaremos de forma simultánea. Se basa en la cantidad de CPUs que Blaze cree que están disponibles, lo que se puede controlar con la marca --local_cpu_resources.
Si esta marca es 0, todas las acciones se programan de inmediato a nivel local. Si es > 0, la cantidad de acciones programadas de forma local está limitada por la cantidad de CPU disponibles. Si es menor que 1, el factor de carga se usa para reducir la cantidad de acciones programadas de forma local cuando la cantidad de acciones en espera de programación es alta. Esto reduce la carga en la máquina local en el caso de una compilación limpia, en la que la máquina local no contribuye mucho.
Etiquetas:execution
,host_machine_resource_optimizations
--experimental_dynamic_slow_remote_time=<An immutable length of time.>
predeterminado: "0"-
Si es >0, es el tiempo que una acción ejecutada de forma dinámica debe ejecutarse solo de forma remota antes de que prioricemos su ejecución local para evitar tiempos de espera remotos. Esto puede ocultar algunos problemas en el sistema de ejecución remota. No actives esta opción sin supervisar los problemas de ejecución remota.
Etiquetas:execution
,host_machine_resource_optimizations
--[no]experimental_enable_docker_sandbox
predeterminado: "false"-
Habilita la zona de pruebas basada en Docker. Esta opción no tiene efecto si Docker no está instalado.
Etiquetas:execution
--experimental_persistent_javac
-
Habilita el compilador de Java persistente experimental.
Se expande a:
--strategy=Javac=worker
--strategy=JavaIjar=local
--strategy=JavaDeployJar=local
--strategy=JavaSourceJar=local
--strategy=Turbine=local
Etiquetas:execution
,host_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">
predeterminado: "0"-
Si es 0, borra los árboles de zona de pruebas en cuanto se completa una acción (lo que provoca que se retrase la finalización de la acción). Si es mayor que cero, ejecuta el borrado de esos tres en un grupo de subprocesos asíncronos que tiene un tamaño de 1 cuando se ejecuta la compilación y aumenta al tamaño especificado por esta marca cuando el servidor está inactivo.
Etiquetas:host_machine_resource_optimizations
,execution
--experimental_sandboxfs_path=<a string>
predeterminado: "sandboxfs"-
Ruta de acceso al objeto binario de sandboxfs que se usará cuando --experimental_use_sandboxfs sea verdadero. Si es un nombre simple, usa el primer binario de ese nombre que se encuentre en PATH.
Etiquetas:host_machine_resource_optimizations
,execution
--[no]experimental_split_xml_generation
predeterminado: "true"-
Si se configura esta marca y una acción de prueba no genera un archivo test.xml, Bazel usa una acción separada para generar un archivo test.xml ficticio que contiene el registro de la prueba. De lo contrario, Bazel genera un archivo test.xml como parte de la acción de prueba.
Etiquetas:execution
--experimental_total_worker_memory_limit_mb=<an integer, or "HOST_RAM", optionally followed by [-|*]<float>.>
predeterminado: "0"-
Si este límite es mayor que cero, es posible que se eliminen los trabajadores inactivos si el uso total de memoria de todos los trabajadores supera el límite.
Etiquetas:execution
,host_machine_resource_optimizations
--[no]experimental_use_hermetic_linux_sandbox
predeterminado: "false"-
Si se establece como verdadero, no se activará la raíz, solo se activará lo que se proporcione con sandbox_add_mount_pair. Los archivos de entrada se vincularán de forma rígida a la zona de pruebas en lugar de vincularse de forma simbólica desde la zona de pruebas. Si los archivos de entrada de la acción se encuentran en un sistema de archivos diferente del de la zona de pruebas, se copiarán los archivos de entrada.
Etiquetas:execution
--[no]experimental_use_sandboxfs
predeterminado: "false"-
Usa sandboxfs para crear los directorios execroot de las acciones en lugar de compilar un árbol de vínculos simbólicos. Si la respuesta es "sí", el archivo binario proporcionado por --experimental_sandboxfs_path debe ser válido y corresponder a una versión compatible de sandboxfs. Si es "auto", es posible que falte el objeto binario o que no sea compatible.
Etiquetas:host_machine_resource_optimizations
,execution
--[no]experimental_use_windows_sandbox
predeterminado: "false"- Usa el espacio aislado de Windows para ejecutar acciones. Si la respuesta es "sí", el archivo binario proporcionado por --experimental_windows_sandbox_path debe ser válido y corresponder a una versión compatible de sandboxfs. Si es "auto", es posible que falte el objeto binario o que no sea compatible.
--experimental_windows_sandbox_path=<a string>
default: "BazelSandbox.exe"- Ruta de acceso al objeto binario de la zona de pruebas de Windows que se usará cuando --experimental_use_windows_sandbox sea verdadero. Si es un nombre simple, usa el primer binario de ese nombre que se encuentre en PATH.
--[no]experimental_worker_as_resource
predeterminado: "false"-
Si está habilitado, los trabajadores se adquieren como recursos de ResourceManager.
Etiquetas:execution
,host_machine_resource_optimizations
--[no]experimental_worker_cancellation
predeterminado: "false"-
Si se habilita, Bazel puede enviar solicitudes de cancelación a los trabajadores que las admitan.
Etiquetas:execution
--[no]experimental_worker_multiplex
predeterminado: "true"-
Si se habilita, los trabajadores que admitan la función experimental de multiplexación la usarán.
Etiquetas:execution
,host_machine_resource_optimizations
--[no]experimental_worker_multiplex_sandboxing
predeterminado: "false"-
Si está habilitado, los trabajadores de multiplexación se ejecutarán en un espacio aislado, con un directorio de espacio aislado independiente por solicitud de trabajo. Solo se aislarán los trabajadores que tengan el requisito de ejecución "supports-multiplex-sandboxing".
Etiquetas:execution
--[no]experimental_worker_strict_flagfiles
predeterminado: "false"-
Si está habilitado, los argumentos de acciones para los trabajadores que no sigan la especificación del trabajador generarán un error. Los argumentos del trabajador deben tener exactamente un argumento @flagfile como el último de su lista de argumentos.
Etiquetas:execution
- Valor predeterminado de
--genrule_strategy=<comma-separated list of options>
: "" -
Especifica cómo ejecutar genrules. Esta marca se dará de baja. En su lugar, usa --spawn_strategy=<value> para controlar todas las acciones o --strategy=Genrule=<value> para controlar solo las genrules.
Etiquetas:execution
- Se acumulan los usos múltiples de
--high_priority_workers=<a string>
-
Son las mnemónicas de los trabajadores que se ejecutarán con alta prioridad. Cuando se ejecutan trabajadores de alta prioridad, se limita la velocidad de todos los demás trabajadores.
Etiquetas:execution
--[no]incompatible_remote_dangling_symlinks
predeterminado: "true"-
Si se establece como verdadero y --incompatible_remote_symlinks también es verdadero, se permite que los vínculos simbólicos en los resultados de la acción queden colgando.
Etiquetas:execution
,incompatible_change
--[no]incompatible_remote_symlinks
predeterminado: "true"-
Si se establece como verdadero, Bazel representará los vínculos simbólicos en los resultados de la acción en el protocolo de ejecución y almacenamiento en caché remotos como tales. De lo contrario, se seguirán los symlinks y se representarán como archivos o directorios. Consulta el problema #6631 para obtener más información.
Etiquetas:execution
,incompatible_change
--[no]incompatible_sandbox_hermetic_tmp
predeterminado: "false"-
Si se configura como verdadero, cada zona de pruebas de Linux tendrá su propio directorio vacío dedicado activado como /tmp en lugar de compartir /tmp con el sistema de archivos del host. Usa --sandbox_add_mount_pair=/tmp para seguir viendo el directorio /tmp del host en todos los espacios de pruebas.
Etiquetas:execution
--[no]internal_spawn_scheduler
predeterminado: "false"-
Opción de marcador de posición para que podamos saber en Blaze si se habilitó el programador de spawn.
Etiquetas:execution
,host_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
] default: "auto"-
Es la cantidad de trabajos simultáneos que se ejecutarán. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), seguido de forma opcional por una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". Los valores deben estar entre 1 y 5,000. Los valores superiores a 2,500 pueden causar problemas de memoria. "auto" calcula un valor predeterminado razonable según los recursos del host.
Etiquetas:host_machine_resource_optimizations
,execution
--[no]keep_going
[-k
] predeterminado: "false"-
Continúa lo más posible después de un error. Si bien no se pueden analizar el destino que falló ni los que dependen de él, sí se pueden analizar otros requisitos previos de estos destinos.
Etiquetas: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">
predeterminado: "auto"-
Cantidad de subprocesos paralelos que se usarán para la fase de carga o análisis. Toma un número entero o una palabra clave (“auto”, “HOST_CPUS”, “HOST_RAM”), seguida opcionalmente de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". "auto" establece un valor predeterminado razonable según los recursos del host. Debe ser 1 como mínimo.
Etiquetas:bazel_internal_configuration
--[no]reuse_sandbox_directories
predeterminado: "false"-
Si se establece como verdadero, los directorios que usa la ejecución no de trabajador en zona de pruebas se pueden reutilizar para evitar costos de configuración innecesarios.
Etiquetas:host_machine_resource_optimizations
,execution
- Valor predeterminado de
--sandbox_base=<a string>
: "" -
Permite que la zona de pruebas cree sus directorios debajo de esta ruta. Especifica una ruta de acceso en tmpfs (como /run/shm) para posiblemente mejorar mucho el rendimiento cuando tu compilación o tus pruebas tengan muchos archivos de entrada. Nota: Necesitas suficiente RAM y espacio libre en tmpfs para almacenar los archivos intermedios y de salida que se generan cuando se ejecutan las acciones.
Etiquetas:host_machine_resource_optimizations
,execution
--[no]sandbox_explicit_pseudoterminal
predeterminado: "false"-
Habilita de forma explícita la creación de pseudoterminales para acciones en zona de pruebas. Algunas distribuciones de Linux requieren que se establezca el ID de grupo del proceso en "tty" dentro de la zona de pruebas para que funcionen los pseudoterminales. Si esto causa problemas, se puede inhabilitar esta marca para permitir que se usen otros grupos.
Etiquetas:execution
- Se acumulan los usos múltiples de
--sandbox_tmpfs_path=<an absolute path>
-
Para las acciones en zona de pruebas, activa un directorio vacío y con permisos de escritura en esta ruta de acceso absoluta (si la implementación de zona de pruebas lo admite; de lo contrario, se ignora).
Etiquetas:host_machine_resource_optimizations
,execution
- Valor predeterminado de
--spawn_strategy=<comma-separated list of options>
: "" -
Especifica cómo se ejecutan las acciones de generación de forma predeterminada. Acepta una lista de estrategias separadas por comas, de mayor a menor prioridad. Para cada acción, Bazel elige la estrategia con la prioridad más alta que puede ejecutarla. El valor predeterminado es "remote,worker,sandboxed,local". Consulta https://blog.bazel.build/2019/06/19/list-strategy.html para obtener más información.
Etiquetas:execution
- Se acumulan los usos múltiples de
--strategy=<a '[name=]value1[,..,valueN]' assignment>
-
Especifica cómo distribuir la compilación de otras acciones de spawn. Acepta una lista de estrategias separadas por comas, de mayor a menor prioridad. Para cada acción, Bazel elige la estrategia con la prioridad más alta que puede ejecutarla. El valor predeterminado es "remote,worker,sandboxed,local". Esta marca anula los valores establecidos por --spawn_strategy (y --genrule_strategy si se usa con el mnemónico Genrule). Consulta https://blog.bazel.build/2019/06/19/list-strategy.html para obtener más información.
Etiquetas:execution
- Se acumulan los usos múltiples de
--strategy_regexp=<a '<RegexFilter>=value[,value]' assignment>
-
Anula qué estrategia de generación se debe usar para ejecutar acciones de generación que tengan descripciones que coincidan con un regex_filter determinado. Consulta --per_file_copt para obtener detalles sobre la coincidencia de regex_filter. Se usa el primer regex_filter que coincide con la descripción. Esta opción anula otras marcas para especificar la estrategia. Ejemplo: --strategy_regexp=//foo.*\.cc,-//foo/bar=local significa que se ejecutarán acciones con la estrategia local si sus descripciones coinciden con //foo.*.cc, pero no con //foo/bar. Ejemplo: --strategy_regexp='Compiling.*/bar=local --strategy_regexp=Compiling=sandboxed ejecutará "Compiling //foo/bar/baz" con la estrategia "local", pero, si se invierte el orden, se ejecutará con "sandboxed".
Etiquetas:execution
- Se acumulan los usos múltiples de
--worker_extra_flag=<a 'name=value' assignment>
-
Marcas de comandos adicionales que se pasarán a los procesos de trabajadores además de --persistent_worker, con clave por mnemónico (p.ej., --worker_extra_flag=Javac=--debug).
Etiquetas:execution
,host_machine_resource_optimizations
- Se acumulan los usos múltiples de
--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">
-
Cantidad de instancias de un proceso de trabajador (como el compilador de Java persistente) que se pueden iniciar si usas la estrategia "worker". Se puede especificar como [name=value] para asignar un valor diferente por mnemónico de trabajador. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), seguido de forma opcional por una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". "auto" calcula un valor predeterminado razonable en función de la capacidad de la máquina. "=value" establece un valor predeterminado para las mnemónicas no especificadas.
Etiquetas:execution
,host_machine_resource_optimizations
- Se acumulan los usos múltiples de
--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">
-
Cantidad de WorkRequests que un proceso de trabajador multiplex puede recibir en paralelo si usas la estrategia "worker" con --experimental_worker_multiplex. Se puede especificar como [name=value] para asignar un valor diferente por mnemónico de trabajador. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), seguido de forma opcional por una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". "auto" calcula un valor predeterminado razonable en función de la capacidad de la máquina. "=value" establece un valor predeterminado para las mnemónicas no especificadas.
Etiquetas:execution
,host_machine_resource_optimizations
--[no]worker_quit_after_build
predeterminado: "false"-
Si está habilitado, todos los trabajadores se detienen después de que se completa una compilación.
Etiquetas:execution
,host_machine_resource_optimizations
--[no]worker_sandboxing
predeterminado: "false"-
Si se habilita, los trabajadores se ejecutarán en un entorno de zona de pruebas.
Etiquetas:execution
--[no]worker_verbose
predeterminado: "false"- Si está habilitado, imprime mensajes detallados cuando se inician, detienen, etc., los trabajadores.
- Opciones que configuran la cadena de herramientas que se usa para la ejecución de acciones:
--[no]incompatible_disable_runtimes_filegroups
predeterminado: "false"-
Es una operación no operativa obsoleta.
Etiquetas:action_command_lines
,loading_and_analysis
,deprecated
,incompatible_change
--[no]incompatible_dont_emit_static_libgcc
predeterminado: "true"-
Es una operación no operativa obsoleta.
Etiquetas:action_command_lines
,loading_and_analysis
,deprecated
,incompatible_change
--[no]incompatible_linkopts_in_user_link_flags
predeterminado: "true"-
No-op en desuso.
Etiquetas:action_command_lines
,loading_and_analysis
,deprecated
,incompatible_change
- Opciones que controlan el resultado del comando:
--[no]build
predeterminado: "true"-
Ejecuta la compilación. Este es el comportamiento habitual. Si se especifica --nobuild, la compilación se detiene antes de ejecutar las acciones de compilación y devuelve cero si las fases de carga y análisis del paquete se completaron correctamente. Este modo es útil para probar esas fases.
Etiquetas:execution
,affects_outputs
--[no]experimental_run_validations
predeterminado: "true"-
En su lugar, usa --run_validations.
Etiquetas:execution
,affects_outputs
--[no]experimental_use_validation_aspect
predeterminado: "false"-
Indica si se deben ejecutar acciones de validación con el aspecto (para paralelismo con las pruebas).
Etiquetas:execution
,affects_outputs
- Se acumulan los usos múltiples de
--output_groups=<comma-separated list of options>
-
Es una lista de nombres de grupos de salida separados por comas, cada uno de los cuales puede tener un prefijo + o -. Los grupos con el prefijo + se agregan al conjunto predeterminado de grupos de salida, mientras que los grupos con el prefijo - se quitan del conjunto predeterminado. Si al menos un grupo no tiene prefijo, se omite el conjunto predeterminado de grupos de salida. Por ejemplo, --output_groups=+foo,+bar compila la unión del conjunto predeterminado, foo y bar, mientras que --output_groups=foo,bar anula el conjunto predeterminado de modo que solo se compilen foo y bar.
Etiquetas:execution
,affects_outputs
--[no]run_validations
predeterminado: "true"-
Indica si se deben ejecutar acciones de validación como parte de la compilación. Consulta https://bazel.build/rules/rules#validation_actions
Etiquetas:execution
,affects_outputs
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
- Se acumulan los usos múltiples de
--aspects=<comma-separated list of options>
- Lista separada por comas de los aspectos que se aplicarán a los objetivos de nivel superior. En la lista, si el aspecto some_aspect especifica proveedores de aspectos obligatorios a través de required_aspect_providers, some_aspect se ejecutará después de cada aspecto que se mencionó antes en la lista de aspectos cuyos proveedores anunciados satisfagan los proveedores de aspectos obligatorios de some_aspect. Además, some_aspect se ejecutará después de todos los aspectos requeridos especificados por el atributo requires. Luego, some_aspect tendrá acceso a los valores de los proveedores de esos aspectos. <bzl-file-label>%<aspect_name>, por ejemplo, "//tools:my_def.bzl%my_aspect", donde "my_aspect" es un valor de nivel superior de un archivo tools/my_def.bzl
- Valor predeterminado de
--bep_maximum_open_remote_upload_files=<an integer>
: "-1" -
Es la cantidad máxima de archivos abiertos permitidos durante la carga de artefactos del BEP.
Etiquetas:affects_outputs
--[no]experimental_convenience_symlinks
predeterminado: "normal"-
Esta marca controla cómo se administrarán los vínculos simbólicos de conveniencia (los vínculos simbólicos que aparecen en el espacio de trabajo después de la compilación). Valores posibles:
normal (predeterminado): Se creará o borrará cada tipo de vínculo simbólico de conveniencia, según lo determine la compilación.
clean: Se borrarán todos los vínculos simbólicos de forma incondicional.
ignore: Los vínculos simbólicos no se modificarán.
log_only: Genera mensajes de registro como si se hubiera pasado "normal", pero no realiza ninguna operación del sistema de archivos (útil para las herramientas).
Ten en cuenta que solo se pueden afectar los vínculos simbólicos cuyos nombres se generen con el valor actual de --symlink_prefix. Si cambia el prefijo, los vínculos simbólicos preexistentes no se modificarán.
Etiquetas:affects_outputs
--[no]experimental_convenience_symlinks_bep_event
predeterminado: "false"-
Esta marca controla si publicaremos el evento ConvenienceSymlinksIdentified de compilación en BuildEventProtocol. Si el valor es verdadero, BuildEventProtocol tendrá una entrada para convenienceSymlinksIdentified, en la que se enumerarán todos los vínculos simbólicos de conveniencia creados en tu espacio de trabajo. Si es falso, la entrada convenienceSymlinksIdentified en BuildEventProtocol estará vacía.
Etiquetas:affects_outputs
- Se acumulan los usos múltiples de
--experimental_multi_cpu=<comma-separated list of options>
-
Obsoleto. No se realiza ninguna operación.
Etiquetas:affects_outputs
,experimental
--remote_download_minimal
-
No descarga ningún resultado de compilación remota en la máquina local. Esta marca es un atajo para las marcas --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata y --remote_download_outputs=minimal.
Se expande a:
--nobuild_runfile_links
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=minimal
Etiquetas:affects_outputs
--remote_download_outputs=<all, minimal or toplevel>
predeterminado: "all"-
Si se configura como "mínimo", no se descargan los resultados de compilación remotos en la máquina local, excepto los que requieren las acciones locales. Si se configura como "toplevel", se comporta como "minimal", excepto que también descarga los resultados de los destinos de nivel superior en la máquina local. Ambas opciones pueden reducir significativamente los tiempos de compilación si el ancho de banda de la red es un cuello de botella.
Etiquetas:affects_outputs
- Valor predeterminado de
--remote_download_symlink_template=<a string>
: "" -
En lugar de descargar los resultados de compilación remota en la máquina local, crea vínculos simbólicos. El destino de los vínculos simbólicos se puede especificar en forma de una cadena de plantilla. Esta cadena de plantilla puede contener {hash} y {size_bytes}, que se expanden al hash del objeto y al tamaño en bytes, respectivamente. Por ejemplo, estos vínculos simbólicos pueden apuntar a un sistema de archivos FUSE que carga objetos del CAS a pedido.
Etiquetas:affects_outputs
--remote_download_toplevel
-
Solo descarga los resultados remotos de los destinos de nivel superior en la máquina local. Esta marca es un atajo para las marcas --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata y --remote_download_outputs=toplevel.
Se expande a:
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=toplevel
Etiquetas:affects_outputs
--symlink_prefix=<a string>
valor predeterminado: consulta la descripción-
Es el prefijo que se antepone a cualquiera de los vínculos simbólicos de conveniencia que se crean después de una compilación. Si se omite, el valor predeterminado es el nombre de la herramienta de compilación seguido de un guion. Si se pasa "/", no se crean vínculos simbólicos y no se emite ninguna advertencia. Advertencia: La funcionalidad especial para "/" dejará de estar disponible pronto. En su lugar, usa --experimental_convenience_symlinks=ignore.
Etiquetas:affects_outputs
- Opciones que afectan la rigidez con la que Bazel aplica las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
--[no]experimental_docker_privileged
predeterminado: "false"-
Si está habilitado, Bazel pasará la marca --privileged a "docker run" cuando ejecute acciones. Tu compilación podría requerir esto, pero también podría reducir la hermeticidad.
Etiquetas:execution
- Valor predeterminado de
--experimental_repository_hash_file=<a string>
: "" -
Si no está vacío, especifica un archivo que contiene un valor resuelto, con el que se deben verificar los hashes del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
--[no]experimental_sandboxfs_map_symlink_targets
predeterminado: "false"-
Si es verdadero, asigna los destinos de los vínculos simbólicos especificados como entradas de acción en el espacio aislado. Esta función existe únicamente para solucionar reglas con errores que no lo hacen por sí solas y se debe quitar una vez que se corrijan todas esas reglas.
Etiquetas:host_machine_resource_optimizations
,execution
- Se acumulan los usos múltiples de
--experimental_verify_repository_rules=<a string>
-
Si se proporciona un archivo con --experimental_repository_hash_file, se debe verificar la lista de reglas del repositorio para las que se debe verificar el hash del directorio de salida.
Etiquetas:affects_outputs
,experimental
--[no]incompatible_legacy_local_fallback
predeterminado: "true"-
Si se configura como verdadero, se habilita la estrategia de resguardo implícito heredada de la estrategia local a la de zona de pruebas. Con el tiempo, esta marca se establecerá de forma predeterminada como falsa y, luego, se convertirá en una operación sin efecto. En su lugar, usa --strategy, --spawn_strategy o --dynamic_local_strategy para configurar las reversiones.
Etiquetas:execution
,incompatible_change
- Se acumulan los usos múltiples de
--sandbox_add_mount_pair=<a single path or a 'source:target' pair>
-
Agrega un par de rutas de acceso adicionales para activar en la zona de pruebas.
Etiquetas:execution
- Se acumulan los usos múltiples de
--sandbox_block_path=<a string>
-
En el caso de las acciones en zona de pruebas, no permitas el acceso a esta ruta.
Etiquetas:execution
--[no]sandbox_default_allow_network
predeterminado: "true"- Permite el acceso a la red de forma predeterminada para las acciones. Es posible que esto no funcione con todas las implementaciones de zona de pruebas.
--[no]sandbox_fake_hostname
predeterminado: "false"-
Cambia el nombre de host actual a "localhost" para las acciones en zona de pruebas.
Etiquetas:execution
--[no]sandbox_fake_username
predeterminado: "false"-
Cambia el nombre de usuario actual a "nobody" para las acciones en zona de pruebas.
Etiquetas:execution
- Se acumulan los usos múltiples de
--sandbox_writable_path=<a string>
-
En el caso de las acciones en zona de pruebas, haz que un directorio existente se pueda escribir en la zona de pruebas (si la implementación de la zona de pruebas lo admite; de lo contrario, se ignora).
Etiquetas:execution
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: "true"-
Sin operación
Etiquetas:no_op
,deprecated
,experimental
--[no]incompatible_config_setting_private_default_visibility
predeterminado: "false"-
Si incompatible_enforce_config_setting_visibility=false, esta es una operación nula. De lo contrario, si esta marca es falsa, cualquier config_setting sin un atributo de visibilidad explícito es //visibility:public. Si esta marca es verdadera, config_setting sigue la misma lógica de visibilidad que todas las demás reglas. Consulta https://github.com/bazelbuild/bazel/issues/12933.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
predeterminado: "true"-
Si es verdadero, se aplican las restricciones de visibilidad de config_setting. Si es falso, todos los config_setting son visibles para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones que rigen el comportamiento del entorno de prueba o del ejecutor de pruebas:
--[no]check_tests_up_to_date
predeterminado: "false"-
No ejecuta pruebas, solo verifica si están actualizadas. Si todos los resultados de las pruebas están actualizados, la prueba se completa correctamente. Si se debe compilar o ejecutar alguna prueba, se informa un error y falla la prueba. Esta opción implica el comportamiento de --check_up_to_date.
Etiquetas:execution
- Se acumulan los usos múltiples de
--flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once>
-
Cada prueba se reintentará hasta la cantidad especificada de veces en caso de que falle. Las pruebas que requirieron más de un intento para aprobarse se marcan como "INESTABLES" en el resumen de la prueba. Por lo general, el valor especificado es solo un número entero o la cadena "default". Si es un número entero, todas las pruebas se ejecutarán hasta N veces. Si se establece en "default", solo se realizará un intento de prueba para las pruebas normales y tres para las pruebas marcadas explícitamente como inestables por su regla (atributo flaky=1). Sintaxis alternativa: regex_filter@flaky_test_attempts. Aquí flaky_test_attempts es como se explicó anteriormente y regex_filter representa una lista de patrones de expresiones regulares de inclusión y exclusión (consulta también --runs_per_test). Ejemplo: --flaky_test_attempts=//foo/.*,-//foo/bar/.*@3 elimina la inestabilidad de todas las pruebas en //foo/ excepto las que se encuentran en foo/bar tres veces. Esta opción se puede pasar varias veces. Tiene prioridad el argumento que se pasó más recientemente y que coincide. Si no hay coincidencias, el comportamiento es como el de "predeterminado" anterior.
Etiquetas: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">
predeterminado: "auto"-
Es la cantidad máxima de trabajos de prueba locales que se pueden ejecutar de forma simultánea. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), seguido de forma opcional por una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". El valor 0 significa que los recursos locales limitarán la cantidad de trabajos de prueba locales que se ejecutarán de forma simultánea. Establecer este valor en un número mayor que el valor de --jobs no tiene ningún efecto.
Etiquetas:execution
--[no]test_keep_going
predeterminado: "true"-
Cuando se inhabilita, cualquier prueba que no pase hará que se detenga toda la compilación. De forma predeterminada, se ejecutan todas las pruebas, incluso si algunas no se aprueban.
Etiquetas:execution
- Valor predeterminado de
--test_strategy=<a string>
: "" -
Especifica qué estrategia se debe usar cuando se ejecutan pruebas.
Etiquetas:execution
--test_tmpdir=<a path>
valor predeterminado: consulta la descripción- Especifica el directorio temporal base que usará "bazel test".
- Opciones relacionadas con la salida y la semántica de Bzlmod:
- Se acumulan los usos múltiples de
--allow_yanked_versions=<a string>
-
Se especificaron las versiones del módulo en el formato "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran como retiradas en el registro del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones retiradas harán que falle la resolución. También puedes definir la versión anulada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivar el problema a una falla de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecta una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "warning"-
Verifica si las dependencias directas de `bazel_dep` declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivar el problema como una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el archivo MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
predeterminado: "off"-
Especifica cómo y si se debe usar el archivo de bloqueo. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "error" para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan los usos múltiples de
--override_module=<an equals-separated mapping of module name to path>
- Anula un módulo con una ruta local con el formato <nombre del módulo>=<ruta>. Si la ruta proporcionada es absoluta, se usará tal cual. Si la ruta proporcionada es relativa, será relativa al directorio de trabajo actual. Si la ruta de acceso proporcionada comienza con "%workspace%", es relativa a la raíz del espacio de trabajo, que es el resultado de "bazel info workspace".
- Se acumulan los usos múltiples de
--registry=<a string>
-
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: primero se buscarán los módulos en los registros anteriores y solo se recurrirá a los registros posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]announce
predeterminado: "false"-
Obsoleto. No se realiza ninguna operación.
Etiquetas:affects_outputs
--[no]debug_spawn_scheduler
predeterminado: "false"--[no]experimental_bep_target_summary
predeterminado: "false"- Indica si se publicarán eventos de TargetSummary.
--[no]experimental_build_event_expand_filesets
predeterminado: "false"-
Si es verdadero, expande los archivos Filesets en el BEP cuando se presenten los archivos de salida.
Etiquetas:affects_outputs
--[no]experimental_build_event_fully_resolve_fileset_symlinks
predeterminado: "false"-
Si es verdadero, resuelve por completo los vínculos simbólicos relativos de Fileset en el BEP cuando se presentan los archivos de salida. Requiere --experimental_build_event_expand_filesets.
Etiquetas:affects_outputs
- Valor predeterminado de
--experimental_build_event_upload_max_retries=<an integer>
: "4" -
Es la cantidad máxima de veces que Bazel debe reintentar subir un evento de compilación.
Etiquetas:bazel_internal_configuration
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
predeterminado: "1s"-
Es la demora inicial y mínima para los reintentos de retirada exponencial cuando falla la carga del BEP. (exponente: 1.6)
Etiquetas:bazel_internal_configuration
--experimental_build_event_upload_strategy=<a string>
valor predeterminado: consulta la descripción-
Selecciona cómo subir los artefactos a los que se hace referencia en el protocolo del evento de compilación.
Etiquetas:affects_outputs
--[no]experimental_collect_local_sandbox_action_metrics
predeterminado: "true"-
Cuando se habilita, se registran las estadísticas de ejecución (como el tiempo del usuario y del sistema) para las acciones ejecutadas de forma local que usan el aislamiento de zona de pruebas.
Etiquetas:execution
--[no]experimental_docker_verbose
predeterminado: "false"-
Si se habilita, Bazel imprimirá mensajes más detallados sobre la estrategia de zona de pruebas de Docker.
Etiquetas:execution
--[no]experimental_materialize_param_files_directly
predeterminado: "false"-
Si materializas archivos de parámetros, hazlo con escrituras directas en el disco.
Etiquetas:execution
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemónicas con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemónicas.
- Valor predeterminado de
--experimental_repository_resolved_file=<a string>
: "" -
Si no está vacío, escribe un valor de Starlark con la información resuelta de todas las reglas del repositorio de Starlark que se ejecutaron.
Etiquetas:affects_outputs
--[no]experimental_stream_log_file_uploads
predeterminado: "false"-
Transmite las cargas de archivos de registro directamente al almacenamiento remoto en lugar de escribirlas en el disco.
Etiquetas:affects_outputs
--explain=<a path>
valor predeterminado: consulta la descripción-
Hace que el sistema de compilación explique cada paso ejecutado de la compilación. La explicación se escribe en el archivo de registro especificado.
Etiquetas:affects_outputs
--[no]legacy_important_outputs
predeterminado: "true"-
Úsalo para suprimir la generación del campo legacy important_outputs en el evento TargetComplete. Los important_outputs son necesarios para la integración de Bazel en ResultStore.
Etiquetas:affects_outputs
--[no]materialize_param_files
predeterminado: "false"-
Escribe archivos de parámetros intermedios en el árbol de salida, incluso cuando se usa la ejecución de acciones remotas. Es útil cuando se depuran acciones. Esto se infiere de --subcommands y --verbose_failures.
Etiquetas:execution
--max_config_changes_to_show=<an integer>
valor predeterminado: "3"-
Cuando se descarta la caché de análisis debido a un cambio en las opciones de compilación, se muestran hasta la cantidad determinada de nombres de opciones modificadas. Si el número proporcionado es -1, se mostrarán todas las opciones modificadas.
Etiquetas:terminal_output
- Valor predeterminado de
--max_test_output_bytes=<an integer>
: "-1" -
Especifica el tamaño máximo por registro de prueba que se puede emitir cuando --test_output es "errors" o "all". Es útil para evitar que el resultado se vea abrumado por un resultado de prueba demasiado ruidoso. El encabezado de la prueba se incluye en el tamaño del registro. Los valores negativos implican que no hay límite. El resultado es todo o nada.
Etiquetas:test_runner
,terminal_output
,execution
--output_filter=<a valid Java regular expression>
valor predeterminado: consulta la descripción-
Solo muestra advertencias para las reglas con un nombre que coincide con la expresión regular proporcionada.
Etiquetas:affects_outputs
--progress_report_interval=<an integer in 0-3600 range>
predeterminado: "0"-
Cantidad de segundos entre los informes sobre los trabajos que aún se están ejecutando. El valor predeterminado 0 significa que el primer informe se imprimirá después de 10 segundos, luego de 30 segundos y, después de eso, el progreso se informará una vez por minuto. Cuando se habilita --curses, el progreso se informa cada segundo.
Etiquetas:affects_outputs
--remote_print_execution_messages=<failure, success or all>
predeterminado: "failure"-
Elige cuándo imprimir los mensajes de ejecución remota. Los valores válidos son "failure" para imprimir solo en caso de errores, "success" para imprimir solo en caso de éxito y "all" para imprimir siempre.
Etiquetas:terminal_output
--[no]sandbox_debug
predeterminado: "false"-
Habilita las funciones de depuración para la función de zona de pruebas. Esto incluye dos aspectos: primero, el contenido raíz de la zona de pruebas no se modifica después de una compilación (y, si se usa sandboxfs, el sistema de archivos permanece montado); segundo, se imprime información de depuración adicional en la ejecución. Esto puede ayudar a los desarrolladores de reglas de Bazel o Starlark a depurar errores debido a la falta de archivos de entrada, etc.
Etiquetas:terminal_output
--show_result=<an integer>
valor predeterminado: "1"-
Muestra los resultados de la compilación. Para cada destino, indica si se actualizó o no y, si es así, proporciona una lista de los archivos de salida que se compilaron. Los archivos impresos son cadenas convenientes para copiar y pegar en el shell y ejecutarlos.
Esta opción requiere un argumento de número entero, que es la cantidad límite de objetivos por encima de la cual no se imprime la información de los resultados. Por lo tanto, el cero hace que se suprima el mensaje y MAX_INT hace que siempre se imprima el resultado. El valor predeterminado es uno.
Etiquetas:affects_outputs
--[no]subcommands
[-s
] predeterminado: "false"-
Muestra los subcomandos que se ejecutaron durante una compilación. Marcas relacionadas: --execution_log_json_file, --execution_log_binary_file (para registrar subcomandos en un archivo con un formato compatible con herramientas).
Etiquetas:terminal_output
--test_output=<summary, errors, all or streamed>
predeterminado: "summary"-
Especifica el modo de salida deseado. Los valores válidos son "summary" para generar solo el resumen del estado de la prueba, "errors" para imprimir también los registros de las pruebas fallidas, "all" para imprimir los registros de todas las pruebas y "streamed" para generar los registros de todas las pruebas en tiempo real (esto forzará la ejecución de las pruebas de forma local una a la vez, independientemente del valor de --test_strategy).
Etiquetas:test_runner
,terminal_output
,execution
- Valor predeterminado de
--test_summary=<short, terse, detailed, none or testcase>
: "short" -
Especifica el formato deseado del resumen de la prueba. Los valores válidos son "short" para imprimir información solo sobre las pruebas ejecutadas, "terse" para imprimir información solo sobre las pruebas fallidas que se ejecutaron, "detailed" para imprimir información detallada sobre los casos de prueba fallidos, "testcase" para imprimir un resumen en la resolución del caso de prueba, no imprimir información detallada sobre los casos de prueba fallidos y "none" para omitir el resumen.
Etiquetas:terminal_output
--[no]verbose_explanations
predeterminado: "false"-
Aumenta el nivel de detalle de las explicaciones emitidas si se habilita --explain. No tiene efecto si no se habilita --explain.
Etiquetas:affects_outputs
--[no]verbose_failures
predeterminado: "false"-
Si falla un comando, imprime la línea de comandos completa.
Etiquetas:terminal_output
- Opciones que especifican o alteran una entrada genérica para un comando de Bazel que no se incluye en otras categorías.:
- Se acumulan los usos múltiples de
--aspects_parameters=<a 'name=value' assignment>
-
Especifica los valores de los parámetros de aspectos de la línea de comandos. Cada valor de parámetro se especifica a través de <param_name>=<param_value>, por ejemplo, "my_param=my_val", donde "my_param" es un parámetro de algún aspecto en la lista --aspects o es requerido por un aspecto en la lista. Esta opción se puede usar varias veces. Sin embargo, no se permite asignar valores al mismo parámetro más de una vez.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Valor predeterminado de
--target_pattern_file=<a string>
: "" -
Si se configura, la compilación leerá los patrones del archivo que se menciona aquí, en lugar de hacerlo desde la línea de comandos. Es un error especificar un archivo aquí y patrones de línea de comandos.
Etiquetas:changes_inputs
- Opciones de almacenamiento en caché y ejecución remotos:
--experimental_circuit_breaker_strategy=<failure>
valor predeterminado: consulta la descripción-
Especifica la estrategia que usará el disyuntor. Las estrategias disponibles son "failure". Si el valor de la opción no es válido, el comportamiento es el mismo que si la opción no estuviera configurada.
Etiquetas:execution
--experimental_downloader_config=<a string>
valor predeterminado: consulta la descripción- Especifica un archivo para configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva (`allow`, `block` o `rewrite`) seguida de un nombre de host (para `allow` y `block`) o dos patrones, uno para la coincidencia y otro para usar como URL sustituta, con referencias inversas que comienzan con `$1`. Es posible que se proporcionen varias directivas `rewrite` para la misma URL y, en este caso, se devolverán varias URLs.
--[no]experimental_guard_against_concurrent_changes
predeterminado: "false"- Desactiva esta opción para inhabilitar la verificación de la hora de creación de los archivos de entrada de una acción antes de subirlos a una caché remota. Puede haber casos en los que el kernel de Linux retrase la escritura de archivos, lo que podría generar falsos positivos.
--experimental_remote_build_event_upload=<all or minimal>
predeterminado: "all"- Si se configura como "all", todos los resultados locales a los que hace referencia el BEP se suben a la caché remota. Si se establece en "mínimo", los resultados locales a los que se hace referencia en BEP no se suben a la caché remota, excepto los archivos que son importantes para los consumidores de BEP (p.ej., registros de pruebas y perfil de sincronización). El esquema bytestream:// siempre se usa para la URI de los archivos, incluso si faltan en la caché remota. El valor predeterminado es “all”.
--[no]experimental_remote_cache_async
predeterminado: "false"- Si es verdadero, las E/S de la caché remota se realizarán en segundo plano en lugar de como parte de una generación.
--[no]experimental_remote_cache_compression
predeterminado: "false"- Si está habilitado, comprime o descomprime los BLOB de caché con zstd.
--experimental_remote_cache_eviction_retries=<an integer>
predeterminado: "0"-
Es la cantidad máxima de intentos para volver a intentar la compilación si se produjo un error de expulsión de la caché remota. Un valor distinto de cero establecerá implícitamente --incompatible_remote_use_new_exit_code_for_lost_inputs como verdadero. Se generará un nuevo ID de invocación para cada intento. Si generas un ID de invocación y se lo proporcionas a Bazel con --invocation_id, no debes usar esta marca. En su lugar, establece la marca --incompatible_remote_use_new_exit_code_for_lost_inputs y verifica el código de salida 39.
Etiquetas:execution
--experimental_remote_capture_corrupted_outputs=<a path>
valor predeterminado: consulta la descripción- Es la ruta de acceso a un directorio en el que se capturarán los resultados dañados.
--[no]experimental_remote_discard_merkle_trees
predeterminado: "false"- Si se configura como verdadero, se descartan las copias en memoria del árbol de Merkle de la raíz de entrada y las asignaciones de entrada asociadas durante las llamadas a GetActionResult() y Execute(). Esto reduce significativamente el uso de memoria, pero requiere que Bazel vuelva a calcularlos en caso de errores de caché remota y reintentos.
--experimental_remote_downloader=<a string>
valor predeterminado: consulta la descripción- Es el URI de un extremo de la API de Remote Asset que se usará como proxy de descarga remota. Los esquemas admitidos son grpc, grpcs (grpc con TLS habilitado) y unix (sockets UNIX locales). Si no se proporciona ningún esquema, Bazel usará grpcs de forma predeterminada. Consulta https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto.
--[no]experimental_remote_downloader_local_fallback
predeterminado: "false"- Indica si se debe recurrir al descargador local si falla el descargador remoto.
--[no]experimental_remote_execution_keepalive
predeterminado: "false"- Indica si se debe usar keepalive para las llamadas de ejecución remota.
--experimental_remote_failure_rate_threshold=<an integer in 0-100 range>
predeterminado: "10"-
Establece la cantidad permitida de tasa de errores en porcentaje para un período específico después del cual deja de llamar a la caché o al ejecutor remotos. De forma predeterminada, el valor es 10. Si se establece en 0, significa que no hay limitación.
Etiquetas:execution
--experimental_remote_failure_window_interval=<An immutable length of time.>
predeterminado: "60s"-
Es el intervalo en el que se calcula la tasa de fallas de las solicitudes remotas. Si el valor es cero o negativo, la duración del error se calcula durante toda la ejecución.Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
Etiquetas:execution
--[no]experimental_remote_mark_tool_inputs
predeterminado: "false"- Si se establece como verdadero, Bazel marcará las entradas como entradas de herramientas para el ejecutor remoto. Esto se puede usar para implementar trabajadores persistentes remotos.
--[no]experimental_remote_merkle_tree_cache
predeterminado: "false"- Si se establece como verdadero, los cálculos del árbol de Merkle se almacenarán en caché para mejorar la velocidad de verificación de aciertos de la caché remota. La huella de memoria de la caché se controla con --experimental_remote_merkle_tree_cache_size.
--experimental_remote_merkle_tree_cache_size=<a long integer>
predeterminado: "1000"- Es la cantidad de árboles de Merkle que se deben memoizar para mejorar la velocidad de verificación de aciertos de caché remota. Aunque la caché se reduce automáticamente según el control de referencias débiles de Java, pueden producirse errores de memoria insuficiente si se establece un valor demasiado alto. Si se establece en 0, el tamaño de la caché es ilimitado. El valor óptimo varía según el tamaño del proyecto. El valor predeterminado es 1,000.
--[no]experimental_remote_require_cached
predeterminado: "false"- Si se establece en verdadero, se exige que todas las acciones que se pueden ejecutar de forma remota se almacenen en caché; de lo contrario, la compilación fallará. Esto es útil para solucionar problemas de no determinismo, ya que permite verificar si las acciones que deberían almacenarse en caché realmente se almacenan sin insertar de forma espuria resultados nuevos en la caché.
--[no]incompatible_remote_build_event_upload_respect_no_cache
predeterminado: "false"- Si se establece como verdadero, las salidas a las que hace referencia BEP no se suben a la caché remota si la acción de generación no se puede almacenar en caché de forma remota.
--[no]incompatible_remote_downloader_send_all_headers
predeterminado: "true"-
Indica si se deben enviar todos los valores de un encabezado con varios valores al descargador remoto en lugar de solo el primero.
Etiquetas:incompatible_change
--[no]incompatible_remote_output_paths_relative_to_input_root
predeterminado: "false"-
Si se configura como verdadero, las rutas de acceso de salida son relativas a la raíz de entrada en lugar del directorio de trabajo.
Etiquetas:incompatible_change
--[no]incompatible_remote_results_ignore_disk
predeterminado: "true"-
Si se establece como verdadero, --noremote_upload_local_results y --noremote_accept_cached no se aplicarán a la caché de disco. Si se usa una caché combinada:
--noremote_upload_local_results hará que los resultados se escriban en la caché de disco, pero no se suban a la caché remota.
--noremote_accept_cached hará que Bazel busque resultados en la caché del disco, pero no en la caché remota.
Las acciones no-remote-exec pueden acceder a la caché de disco.
Consulta el problema #8216 para obtener más información.
Etiquetas:incompatible_change
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
predeterminado: "false"-
Si se establece como verdadero, Bazel usará el nuevo código de salida 39 en lugar del 34 si la caché remota expulsa blobs durante la compilación.
Etiquetas:incompatible_change
--[no]remote_accept_cached
predeterminado: "true"- Indica si se deben aceptar los resultados de acciones almacenados en caché de forma remota.
--remote_bytestream_uri_prefix=<a string>
valor predeterminado: consulta la descripción- Es el nombre de host y el nombre de la instancia que se usarán en los URIs bytestream:// que se escriben en los flujos de eventos de compilación. Esta opción se puede configurar cuando las compilaciones se realizan con un proxy, lo que hace que los valores de --remote_executor y --remote_instance_name ya no correspondan al nombre canónico del servicio de ejecución remota. Si no se configura, el valor predeterminado será “${hostname}/${instance_name}”.
--remote_cache=<a string>
valor predeterminado: consulta la descripción- Es el URI de un extremo de almacenamiento en caché. Los esquemas admitidos son http, https, grpc, grpcs (grpc con TLS habilitado) y unix (sockets locales de UNIX). Si no se proporciona ningún esquema, Bazel usará grpcs de forma predeterminada. Especifica el esquema grpc://, http:// o unix: para inhabilitar TLS. Consulta https://bazel.build/remote/caching.
- Se acumulan los usos múltiples de
--remote_cache_header=<a 'name=value' assignment>
- Especifica un encabezado que se incluirá en las solicitudes de caché: --remote_cache_header=Name=Value. Se pueden pasar varios encabezados especificando la marca varias veces. Los valores múltiples para el mismo nombre se convertirán en una lista separada por comas.
- Se acumulan los usos múltiples de
--remote_default_exec_properties=<a 'name=value' assignment>
-
Establece las propiedades de ejecución predeterminadas que se usarán como la plataforma de ejecución remota si una plataforma de ejecución aún no establece exec_properties.
Etiquetas:affects_outputs
- Valor predeterminado de
--remote_default_platform_properties=<a string>
: "" - Establece las propiedades de la plataforma predeterminada que se configurarán para la API de ejecución remota, si la plataforma de ejecución aún no establece remote_execution_properties. Este valor también se usará si la plataforma host se selecciona como la plataforma de ejecución para la ejecución remota.
- Se acumulan los usos múltiples de
--remote_downloader_header=<a 'name=value' assignment>
- Especifica un encabezado que se incluirá en las solicitudes del descargador remoto: --remote_downloader_header=Name=Value. Se pueden pasar varios encabezados especificando la marca varias veces. Los valores múltiples para el mismo nombre se convertirán en una lista separada por comas.
- Se acumulan los usos múltiples de
--remote_exec_header=<a 'name=value' assignment>
- Especifica un encabezado que se incluirá en las solicitudes de ejecución: --remote_exec_header=Name=Value. Se pueden pasar varios encabezados especificando la marca varias veces. Los valores múltiples para el mismo nombre se convertirán en una lista separada por comas.
--remote_execution_priority=<an integer>
predeterminado: "0"- Es la prioridad relativa de las acciones que se ejecutarán de forma remota. La semántica de los valores de prioridad particulares depende del servidor.
--remote_executor=<a string>
valor predeterminado: consulta la descripción- HOST o HOST:PORT de un extremo de ejecución remota. Los esquemas admitidos son grpc, grpcs (grpc con TLS habilitado) y unix (sockets UNIX locales). Si no se proporciona ningún esquema, Bazel usará grpcs de forma predeterminada. Especifica el esquema grpc:// o unix: para inhabilitar TLS.
--remote_grpc_log=<a path>
valor predeterminado: consulta la descripción- Si se especifica, es la ruta de acceso a un archivo para registrar detalles relacionados con las llamadas a gRPC. Este registro consta de una secuencia de mensajes .proto serializados com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry, en la que cada mensaje tiene como prefijo un varint que denota el tamaño del siguiente mensaje .proto serializado, como lo realiza el método LogEntry.writeDelimitedTo(OutputStream).
- Se acumulan los usos múltiples de
--remote_header=<a 'name=value' assignment>
- Especifica un encabezado que se incluirá en las solicitudes: --remote_header=Name=Value. Se pueden pasar varios encabezados especificando la marca varias veces. Los valores múltiples para el mismo nombre se convertirán en una lista separada por comas.
- Valor predeterminado de
--remote_instance_name=<a string>
: "" - Es el valor que se pasará como instance_name en la API de ejecución remota.
--[no]remote_local_fallback
predeterminado: "false"- Indica si se debe recurrir a la estrategia de ejecución local independiente si falla la ejecución remota.
--remote_local_fallback_strategy=<a string>
predeterminado: "local"- Es una operación nula y está obsoleta. Consulta https://github.com/bazelbuild/bazel/issues/7480 para obtener más información.
--remote_max_connections=<an integer>
valor predeterminado: "100"-
Limita la cantidad máxima de conexiones simultáneas a la caché o al ejecutor remotos. De forma predeterminada, el valor es 100. Si se establece en 0, significa que no hay limitación.
En el caso de la caché remota HTTP, una conexión TCP puede controlar una solicitud a la vez, por lo que Bazel puede realizar hasta --remote_max_connections solicitudes simultáneas.
En el caso del ejecutor y la caché remotos de gRPC, un canal de gRPC suele controlar más de 100 solicitudes simultáneas, por lo que Bazel podría realizar alrededor de `--remote_max_connections * 100` solicitudes simultáneas.
Etiquetas:host_machine_resource_optimizations
--remote_proxy=<a string>
valor predeterminado: consulta la descripción- Conéctate a la caché remota a través de un proxy. Actualmente, esta marca solo se puede usar para configurar un socket de dominio Unix (unix:/ruta/al/socket).
--remote_result_cache_priority=<an integer>
predeterminado: "0"- Es la prioridad relativa de las acciones remotas que se almacenarán en la caché remota. La semántica de los valores de prioridad particulares depende del servidor.
--remote_retries=<an integer>
predeterminado: "5"- Es la cantidad máxima de intentos para reintentar un error transitorio. Si se establece en 0, se inhabilitan los reintentos.
--remote_retry_max_delay=<An immutable length of time.>
predeterminado: "5s"- Es la demora máxima de retirada entre los reintentos remotos. Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
--remote_timeout=<An immutable length of time.>
predeterminado: "60s"- Es la cantidad máxima de tiempo que se espera para las llamadas de ejecución remota y de caché. Para la caché de REST, este es el tiempo de espera de conexión y de lectura. Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
--[no]remote_upload_local_results
predeterminado: "true"- Indica si se deben subir los resultados de las acciones ejecutadas de forma local a la caché remota si esta lo admite y el usuario está autorizado para hacerlo.
--[no]remote_verify_downloads
predeterminado: "true"- Si se configura como verdadero, Bazel calculará la suma de hash de todas las descargas remotas y descartará los valores almacenados en caché de forma remota si no coinciden con el valor esperado.
- Opciones varias, no clasificadas de otra manera:
--[no]allow_analysis_cache_discard
predeterminado: "true"-
Si se descarta la caché de análisis debido a un cambio en el sistema de compilación, configurar esta opción como falsa hará que Bazel salga en lugar de continuar con la compilación. Esta opción no tiene ningún efecto cuando también se establece "discard_analysis_cache".
Etiquetas:eagerness_to_exit
--auto_output_filter=<none, all, packages or subpackages>
predeterminado: "none"- Si no se especifica --output_filter, se usa el valor de esta opción para crear un filtro automáticamente. Los valores permitidos son "none" (no filtrar nada / mostrar todo), "all" (filtrar todo / no mostrar nada), "packages" (incluir el resultado de las reglas en los paquetes mencionados en la línea de comandos de Blaze) y "subpackages" (como "packages", pero también incluye subpaquetes). Para los valores "packages" y "subpackages" (//java/foo y //javatests/foo se tratan como un solo paquete).
--[no]build_manual_tests
predeterminado: "false"- Obliga a compilar los destinos de prueba etiquetados como "manuales". Las pruebas "manuales" se excluyen del procesamiento. Esta opción obliga a que se compilen (pero no se ejecuten).
- Valor predeterminado de
--build_tag_filters=<comma-separated list of options>
: "" - Especifica una lista de etiquetas separadas por comas. Cada etiqueta puede ir precedida de un signo "-" para especificar las etiquetas excluidas. Solo se compilarán los destinos que contengan al menos una etiqueta incluida y no contengan ninguna etiqueta excluida. Esta opción no afecta el conjunto de pruebas que se ejecutan con el comando "test"; esas pruebas se rigen por las opciones de filtrado de pruebas, por ejemplo, "--test_tag_filters".
--[no]build_tests_only
predeterminado: "false"- Si se especifica, solo se compilarán las reglas *_test y test_suite, y se ignorarán otros destinos especificados en la línea de comandos. De forma predeterminada, se compilará todo lo que se solicitó.
--combined_report=<none or lcov>
predeterminado: "none"- Especifica el tipo de informe de cobertura acumulativa deseado. En este punto, solo se admite LCOV.
--[no]compile_one_dependency
predeterminado: "false"- Compila una sola dependencia de los archivos de argumentos. Esto es útil para verificar la sintaxis de los archivos fuente en los IDE, por ejemplo, recompilando un solo destino que depende del archivo fuente para detectar errores lo antes posible en el ciclo de edición, compilación y prueba. Este argumento afecta la forma en que se interpretan todos los argumentos que no son marcas. En lugar de ser destinos para compilar, son nombres de archivos fuente. Para cada nombre de archivo fuente, se compilará un destino arbitrario que dependa de él.
- Se acumulan los usos múltiples de
--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.>
- Configura un auxiliar de credenciales para recuperar credenciales de autorización para la recuperación de repositorios, el almacenamiento en caché y la ejecución remotos, y el servicio de eventos de compilación. Las credenciales proporcionadas por un asistente tienen prioridad sobre las credenciales proporcionadas por --google_default_credentials, --google_credentials, un archivo .netrc o el parámetro de autenticación para repository_ctx.download y repository_ctx.download_and_extract. Se puede especificar varias veces para configurar varios asistentes. Para obtener más información, consulta https://github.com/bazelbuild/proposals/blob/main/designs/2022-06-07-bazel-credential-helpers.md.
--credential_helper_cache_duration=<An immutable length of time.>
predeterminado: "30 min"- Es la duración durante la que se almacenan en caché las credenciales proporcionadas por un auxiliar de credenciales. Si se invoca con un valor diferente, se ajustará la vida útil de las entradas existentes. Pasa cero para borrar la caché. Un comando clean siempre borra la caché, independientemente de esta marca.
--credential_helper_timeout=<An immutable length of time.>
predeterminado: "10s"- Configura el tiempo de espera para un auxiliar de credenciales. Los auxiliares de credenciales que no respondan dentro de este tiempo de espera fallarán en la invocación.
- Valor predeterminado de
--deleted_packages=<comma-separated list of package names>
: "" - Es una lista separada por comas de los nombres de los paquetes que el sistema de compilación considerará inexistentes, incluso si son visibles en algún lugar de la ruta de acceso del paquete. Usa esta opción cuando borres un subpaquete "x/y" de un paquete existente "x". Por ejemplo, después de borrar x/y/BUILD en tu cliente, es posible que el sistema de compilación muestre un error si encuentra la etiqueta "//x:y/z" si otra entrada de package_path aún la proporciona. Si especificas --deleted_packages x/y, se evita este problema.
--[no]discard_analysis_cache
predeterminado: "false"- Descarta la caché de análisis inmediatamente después de que finalice la fase de análisis. Reduce el uso de memoria en un 10%, pero hace que las compilaciones incrementales posteriores sean más lentas.
--disk_cache=<a path>
valor predeterminado: consulta la descripción- Es la ruta de acceso a un directorio en el que Bazel puede leer y escribir acciones y resultados de acciones. Si el directorio no existe, se creará.
- Valor predeterminado de
--embed_label=<a one-line string>
: "" - Incorpora la revisión del control de código fuente o la etiqueta de versión en el archivo binario
--execution_log_binary_file=<a path>
valor predeterminado: consulta la descripción- Registra los comandos spawn ejecutados en este archivo como protos de Spawn delimitados, según src/main/protobuf/spawn.proto. Primero, el registro se escribe sin ordenar y, luego, al final de la invocación, se ordena de forma estable (puede requerir mucha CPU y memoria). Marcas relacionadas: --execution_log_json_file (formato json de texto ordenado), --experimental_execution_log_file (formato binario protobuf no ordenado), --subcommands (para mostrar subcomandos en el resultado de la terminal).
--execution_log_json_file=<a path>
valor predeterminado: consulta la descripción- Registra los elementos Spawn ejecutados en este archivo como una representación JSON de los protos de Spawn delimitados, según src/main/protobuf/spawn.proto. Primero, el registro se escribe sin ordenar y, luego, al final de la invocación, se ordena de forma estable (puede requerir mucha CPU y memoria). Marcas relacionadas: --execution_log_binary_file (formato binario de protobuf ordenado), --experimental_execution_log_file (formato binario de protobuf no ordenado), --subcommands (para mostrar subcomandos en el resultado de la terminal).
--[no]execution_log_sort
predeterminado: "true"- Indica si se debe ordenar el registro de ejecución. Se establece en falso para mejorar el rendimiento de la memoria, a costa de generar el registro en orden no determinístico.
--[no]expand_test_suites
predeterminado: "true"-
Expande los destinos de test_suite en sus pruebas constituyentes antes del análisis. Cuando esta marca está activada (opción predeterminada), los patrones de segmentación negativos se aplicarán a las pruebas que pertenecen al conjunto de pruebas. De lo contrario, no se aplicarán. Desactivar esta marca es útil cuando se aplican aspectos de nivel superior en la línea de comandos, ya que, de esta manera, se pueden analizar los destinos de test_suite.
Etiquetas:loading_and_analysis
--experimental_execution_log_file=<a path>
valor predeterminado: consulta la descripción- Registra los comandos spawn ejecutados en este archivo como protos de Spawn delimitados, según src/main/protobuf/spawn.proto. Este archivo se escribe en el orden de ejecución de los Spawns. Marcas relacionadas: --execution_log_binary_file (formato binario ordenado de protobuf), --execution_log_json_file (formato JSON de texto ordenado), --subcommands (para mostrar subcomandos en la salida de la terminal).
--[no]experimental_execution_log_spawn_metrics
predeterminado: "false"- Incluye métricas de generación en el registro de generaciones ejecutadas.
- Valor predeterminado de
--experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "" - Dejó de estar disponible y se reemplazó por aspectos. Es el conjunto de filtros de los objetivos para los que se programarán extra_actions.
--[no]experimental_extra_action_top_level_only
predeterminado: "false"- Dejó de estar disponible y se reemplazó por aspectos. Solo programa extra_actions para los destinos de nivel superior.
--[no]experimental_prioritize_local_actions
predeterminado: "true"-
Si se configura, las acciones que solo se pueden ejecutar de forma local tienen la primera oportunidad de adquirir recursos, los trabajadores que se ejecutan de forma dinámica tienen la segunda oportunidad y las acciones independientes que se ejecutan de forma dinámica son las últimas.
Etiquetas:execution
--experimental_spawn_scheduler
-
Habilita la ejecución dinámica ejecutando acciones de forma local y remota en paralelo. Bazel genera cada acción de forma local y remota, y elige la que se completa primero. Si una acción admite trabajadores, la acción local se ejecutará en el modo de trabajador persistente. Para habilitar la ejecución dinámica de un mnemónico de acción individual, usa las marcas `--internal_spawn_scheduler` y `--strategy=<mnemonic>=dynamic` en su lugar.
Se expande a:
--internal_spawn_scheduler
--spawn_strategy=dynamic
--google_auth_scopes=<comma-separated list of options>
valor predeterminado: "https://www.googleapis.com/auth/cloud-platform"- Lista separada por comas de los permisos de autenticación de Google Cloud.
--google_credentials=<a string>
valor predeterminado: consulta la descripción- Especifica el archivo desde el que se obtienen las credenciales de autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más detalles.
--[no]google_default_credentials
predeterminado: "false"- Indica si se deben usar las "credenciales predeterminadas de la aplicación de Google" para la autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más detalles. Está inhabilitado de forma predeterminada.
--grpc_keepalive_time=<An immutable length of time.>
valor predeterminado: consulta la descripción- Configura los pings de keep-alive para las conexiones gRPC salientes. Si se configura, Bazel envía pings después de este tiempo sin operaciones de lectura en la conexión, pero solo si hay al menos una llamada de gRPC pendiente. Los tiempos se tratan con una granularidad de segundos; es un error establecer un valor inferior a un segundo. De forma predeterminada, los pings de Keep-Alive están inhabilitados. Antes de habilitar este parámetro de configuración, debes coordinarte con el propietario del servicio. Por ejemplo, para establecer un valor de 30 segundos en esta marca, se debe hacer de la siguiente manera: --grpc_keepalive_time=30s
--grpc_keepalive_timeout=<An immutable length of time.>
predeterminado: "20s"- Configura un tiempo de espera de keep-alive para las conexiones gRPC salientes. Si los pings de keep-alive están habilitados con --grpc_keepalive_time, Bazel agota el tiempo de espera de una conexión si no recibe una respuesta de ping después de este tiempo. Los tiempos se tratan con una granularidad de segundos; es un error establecer un valor inferior a un segundo. Si los pings de conexión activa están inhabilitados, se ignorará este parámetro de configuración.
--[no]ignore_unsupported_sandboxing
predeterminado: "false"- No se imprime una advertencia cuando la ejecución en zona de pruebas no es compatible con este sistema.
--[no]incompatible_dont_use_javasourceinfoprovider
predeterminado: "false"-
No-op
Etiquetas:incompatible_change
--local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>
predeterminado: "HOST_CPUS"- Establece de forma explícita la cantidad total de núcleos de CPU locales disponibles para que Bazel los use en las acciones de compilación que se ejecutan de forma local. Toma un número entero o "HOST_CPUS", seguido de forma opcional por [-|*]<float> (p. ej., HOST_CPUS*.5 para usar la mitad de los núcleos de CPU disponibles).De forma predeterminada, ("HOST_CPUS"), Bazel consultará la configuración del sistema para estimar la cantidad de núcleos de CPU disponibles.
- Se acumulan los usos múltiples de
--local_extra_resources=<a named float, 'name=value'>
- Establece la cantidad de recursos adicionales disponibles para Bazel. Toma un par de cadena y número de punto flotante. Se puede usar varias veces para especificar varios tipos de recursos adicionales. Bazel limitará las acciones que se ejecutan de forma simultánea según los recursos adicionales disponibles y los recursos adicionales necesarios. Las pruebas pueden declarar la cantidad de recursos adicionales que necesitan con una etiqueta del formato "resources:<resoucename>:<amount>". Con esta marca, no se pueden establecer la CPU, la RAM ni los recursos disponibles.
--local_ram_resources=<an integer, or "HOST_RAM", optionally followed by [-|*]<float>.>
predeterminado: "HOST_RAM*.67"- Establece de forma explícita la cantidad total de RAM del host local (en MB) disponible para que Bazel la use en las acciones de compilación que se ejecutan de forma local. Toma un número entero o "HOST_RAM", seguido de forma opcional por [-|*]<float> (p. ej., HOST_RAM*.5 para usar la mitad de la RAM disponible). De forma predeterminada, ("HOST_RAM*.67"), Bazel consultará la configuración del sistema para estimar la cantidad de RAM disponible y usará el 67% de ella.
--local_termination_grace_seconds=<an integer>
predeterminado: "15"- Tiempo de espera entre la finalización de un proceso local debido a un tiempo de espera agotado y el cierre forzado.
- Se acumulan los usos múltiples de
--override_repository=<an equals-separated mapping of repository name to path>
- Anula un repositorio con una ruta de acceso local con el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es absoluta, se usará tal cual. Si la ruta de acceso proporcionada es relativa, se relacionará con el directorio de trabajo actual. Si la ruta de acceso proporcionada comienza con "%workspace%", es relativa a la raíz del espacio de trabajo, que es el resultado de "bazel info workspace".
--package_path=<colon-separated list of options>
valor predeterminado: "%workspace%"- Es una lista separada por dos puntos de las ubicaciones en las que se buscarán paquetes. Los elementos que comienzan con "%workspace%" son relativos al espacio de trabajo que los contiene. Si se omite o está vacío, el valor predeterminado es el resultado de "bazel info default-package-path".
--[no]show_loading_progress
predeterminado: "true"- Si está habilitado, hace que Bazel imprima mensajes de "Loading package:".
- Valor predeterminado de
--test_lang_filters=<comma-separated list of options>
: "" - Especifica una lista de idiomas de prueba separados por comas. Cada idioma puede ir precedido de un guion (“-”) para especificar los idiomas excluidos. Solo se encontrarán los objetivos de prueba que estén escritos en los idiomas especificados. El nombre que se usa para cada idioma debe ser el mismo que el prefijo de idioma en la regla *_test, p.ej., uno de "cc", "java", "py", etcétera. Esta opción afecta el comportamiento de --build_tests_only y el comando de prueba.
- Valor predeterminado de
--test_size_filters=<comma-separated list of values: small, medium, large or enormous>
: "" - Especifica una lista de tamaños de prueba separados por comas. Cada tamaño puede ir precedido de un guion "-" para especificar los tamaños excluidos. Solo se encontrarán aquellos objetivos de prueba que contengan al menos un tamaño incluido y no contengan ningún tamaño excluido. Esta opción afecta el comportamiento de --build_tests_only y el comando de prueba.
- Valor predeterminado de
--test_tag_filters=<comma-separated list of options>
: "" - Especifica una lista de etiquetas de prueba separadas por comas. Cada etiqueta puede ir precedida de un signo "-" para especificar las etiquetas excluidas. Solo se encontrarán aquellos destinos de prueba que contengan al menos una etiqueta incluida y no contengan ninguna etiqueta excluida. Esta opción afecta el comportamiento de --build_tests_only y el comando de prueba.
- Valor predeterminado de
--test_timeout_filters=<comma-separated list of values: short, moderate, long or eternal>
: "" - Especifica una lista de tiempos de espera de prueba separados por comas. Cada tiempo de espera puede ir precedido de un signo "-" para especificar los tiempos de espera excluidos. Solo se encontrarán aquellos destinos de prueba que contengan al menos un tiempo de espera incluido y no contengan ningún tiempo de espera excluido. Esta opción afecta el comportamiento de --build_tests_only y el comando de prueba.
--tls_certificate=<a string>
valor predeterminado: consulta la descripción- Especifica una ruta de acceso a un certificado TLS que se considera de confianza para firmar certificados de servidor.
--tls_client_certificate=<a string>
valor predeterminado: consulta la descripción- Especifica el certificado de cliente TLS que se usará. También debes proporcionar una clave de cliente para habilitar la autenticación del cliente.
--tls_client_key=<a string>
valor predeterminado: consulta la descripción- Especifica la clave del cliente TLS que se usará. También debes proporcionar un certificado de cliente para habilitar la autenticación del cliente.
- Valor predeterminado de
--workspace_status_command=<path>
: "" - Es un comando que se invoca al comienzo de la compilación para proporcionar información de estado sobre el espacio de trabajo en forma de pares clave-valor. Consulta el Manual del usuario para ver la especificación completa. Consulta también tools/buildstamp/get_workspace_status para ver un ejemplo.
- Opciones que controlan la ejecución de la compilación:
--[no]check_up_to_date
predeterminado: "false"-
No realices la compilación, solo verifica si está actualizada. Si todos los destinos están actualizados, la compilación se completa correctamente. Si se debe ejecutar algún paso, se informa un error y falla la compilación.
Etiquetas:execution
--[no]experimental_inprocess_symlink_creation
predeterminado: "false"-
Indica si se deben realizar llamadas directas al sistema de archivos para crear árboles de vínculos simbólicos.
Etiquetas:loading_and_analysis
,execution
,experimental
--[no]experimental_remotable_source_manifests
predeterminado: "false"-
Indica si las acciones del manifiesto fuente se pueden realizar de forma remota.
Etiquetas:loading_and_analysis
,execution
,experimental
--[no]experimental_split_coverage_postprocessing
predeterminado: "false"-
Si es verdadero, Bazel ejecutará el procesamiento posterior de la cobertura para la prueba en una nueva generación.
Etiquetas:execution
--[no]experimental_split_xml_generation
predeterminado: "true"-
Si se configura esta marca y una acción de prueba no genera un archivo test.xml, Bazel usa una acción separada para generar un archivo test.xml ficticio que contiene el registro de la prueba. De lo contrario, Bazel genera un archivo test.xml como parte de la acción de prueba.
Etiquetas:execution
--[no]experimental_strict_fileset_output
predeterminado: "false"-
Si esta opción está habilitada, los conjuntos de archivos tratarán todos los artefactos de salida como archivos normales. No recorrerán directorios ni serán sensibles a los vínculos simbólicos.
Etiquetas:execution
- Valor predeterminado de
--genrule_strategy=<comma-separated list of options>
: "" -
Especifica cómo ejecutar genrules. Esta marca se dará de baja. En su lugar, usa --spawn_strategy=<value> para controlar todas las acciones o --strategy=Genrule=<value> para controlar solo las genrules.
Etiquetas:execution
--jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
[-j
] default: "auto"-
Es la cantidad de trabajos simultáneos que se ejecutarán. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), seguido de forma opcional por una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". Los valores deben estar entre 1 y 5,000. Los valores superiores a 2,500 pueden causar problemas de memoria. "auto" calcula un valor predeterminado razonable según los recursos del host.
Etiquetas:host_machine_resource_optimizations
,execution
--[no]keep_going
[-k
] predeterminado: "false"-
Continúa lo más posible después de un error. Si bien no se pueden analizar el destino que falló ni los que dependen de él, sí se pueden analizar otros requisitos previos de estos destinos.
Etiquetas: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">
predeterminado: "auto"-
Cantidad de subprocesos paralelos que se usarán para la fase de carga o análisis. Toma un número entero o una palabra clave (“auto”, “HOST_CPUS”, “HOST_RAM”), seguida opcionalmente de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". "auto" establece un valor predeterminado razonable según los recursos del host. Debe ser 1 como mínimo.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
: "" -
Agrega o quita claves de la información de ejecución de una acción según la mnemónica de la acción. Solo se aplica a las acciones que admiten información de ejecución. Muchas acciones comunes admiten información de ejecución, p.ej., Genrule, CppCompile, Javac, StarlarkAction y TestRunner. Cuando se especifican varios valores, el orden es importante porque muchas expresiones regulares pueden aplicarse a la misma mnemónica.
La sintaxis es "regex=[+-]key,regex=[+-]key,…".
Ejemplos:
".*=+x,.*=-y,.*=+z" agrega "x" y "z" a la información de ejecución de todas las acciones, y quita "y" de ella.
"Genrule=+requires-x" agrega "requires-x" a la información de ejecución de todas las acciones de Genrule.
"(?!Genrule).*=-requires-x" quita "requires-x" de la información de ejecución para todas las acciones que no sean Genrule.
Etiquetas:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Habilita acciones persistentes de dex y desugar de Android con trabajadores.
Se expande a:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
-
Habilita el procesador de recursos de Android persistente con trabajadores.
Se expande a lo siguiente:
--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=AARGenerator=worker
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_dex_desugar
-
Habilita acciones persistentes de dex y desugar de Android multiplexadas con trabajadores.
Se expande a:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
Habilita el procesador de recursos de Android multiplexado persistente con trabajadores.
Se expande a lo siguiente:
--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=AARGenerator=+supports-multiplex-workers
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_tools
-
Habilita herramientas de Android persistentes y multiplexadas (dexing, desugaring, procesamiento de recursos).
Se expande a:
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Etiquetas:host_machine_resource_optimizations
,execution
- Valor predeterminado de
--spawn_strategy=<comma-separated list of options>
: "" -
Especifica cómo se ejecutan las acciones de generación de forma predeterminada. Acepta una lista de estrategias separadas por comas, de mayor a menor prioridad. Para cada acción, Bazel elige la estrategia con la prioridad más alta que puede ejecutarla. El valor predeterminado es "remote,worker,sandboxed,local". Consulta https://blog.bazel.build/2019/06/19/list-strategy.html para obtener más información.
Etiquetas:execution
- Se acumulan los usos múltiples de
--strategy=<a '[name=]value1[,..,valueN]' assignment>
-
Especifica cómo distribuir la compilación de otras acciones de spawn. Acepta una lista de estrategias separadas por comas, de mayor a menor prioridad. Para cada acción, Bazel elige la estrategia con la prioridad más alta que puede ejecutarla. El valor predeterminado es "remote,worker,sandboxed,local". Esta marca anula los valores establecidos por --spawn_strategy (y --genrule_strategy si se usa con el mnemónico Genrule). Consulta https://blog.bazel.build/2019/06/19/list-strategy.html para obtener más información.
Etiquetas:execution
- Se acumulan los usos múltiples de
--strategy_regexp=<a '<RegexFilter>=value[,value]' assignment>
-
Anula qué estrategia de generación se debe usar para ejecutar acciones de generación que tengan descripciones que coincidan con un regex_filter determinado. Consulta --per_file_copt para obtener detalles sobre la coincidencia de regex_filter. Se usa el primer regex_filter que coincide con la descripción. Esta opción anula otras marcas para especificar la estrategia. Ejemplo: --strategy_regexp=//foo.*\.cc,-//foo/bar=local significa que se ejecutarán acciones con la estrategia local si sus descripciones coinciden con //foo.*.cc, pero no con //foo/bar. Ejemplo: --strategy_regexp='Compiling.*/bar=local --strategy_regexp=Compiling=sandboxed ejecutará "Compiling //foo/bar/baz" con la estrategia "local", pero, si se invierte el orden, se ejecutará con "sandboxed".
Tags:execution
- Opciones que configuran la cadena de herramientas que se usa para la ejecución de acciones:
--android_compiler=<a string>
valor predeterminado: consulta la descripción-
Compilador de destino de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_crosstool_top=<a build target label>
predeterminado: "//external:android/crosstool"-
Ubicación del compilador de C++ que se usa para las compilaciones de Android.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_grte_top=<a label>
valor predeterminado: consulta la descripción-
El destino de Android grte_top.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
valor predeterminado: "android"-
Selecciona el combinador de manifiestos que se usará para las reglas de android_binary. Es una marca para ayudar en la transición de la herramienta de combinación heredada a la herramienta de combinación de manifiestos de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Valor predeterminado de
--android_platforms=<a build target label>
: "" -
Establece las plataformas que usan los destinos de android_binary. Si se especifican varias plataformas, el archivo binario es un APK grueso, que contiene archivos binarios nativos para cada plataforma de destino especificada.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_sdk=<a build target label>
default: "@bazel_tools//tools/android:sdk"-
Especifica el SDK o la plataforma de Android que se usan para compilar aplicaciones para Android.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--apple_compiler=<a string>
valor predeterminado: consulta la descripción-
El compilador de destino de Apple. Es útil para seleccionar variantes de una cadena de herramientas (p.ej., xcode-beta).
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--apple_crosstool_top=<a build target label>
predeterminado: "@bazel_tools//tools/cpp:toolchain"-
Es la etiqueta del paquete de herramientas cruzadas que se usará en las reglas de Apple y Objc, y sus dependencias.
Etiquetas:loses_incremental_state
,changes_inputs
--apple_grte_top=<a build target label>
valor predeterminado: consulta la descripción-
Es el grte_top de destino de Apple.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
- Valor predeterminado de
--cc_output_directory_tag=<a string>
: "" -
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas:affects_outputs
,explicit_in_output_path
--compiler=<a string>
valor predeterminado: consulta la descripción-
Es el compilador de C++ que se usará para compilar el destino.
Etiquetas:loading_and_analysis
,execution
--coverage_output_generator=<a build target label>
predeterminado: "@bazel_tools//tools/test:lcov_merger"-
Ubicación del archivo binario que se usa para el procesamiento posterior de los informes de cobertura sin procesar. Actualmente, debe ser un filegroup que contenga un solo archivo, el binario. El valor predeterminado es “//tools/test:lcov_merger”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
predeterminado: "@bazel_tools//tools/test:coverage_report_generator"-
Ubicación del archivo binario que se usa para generar informes de cobertura. Actualmente, debe ser un filegroup que contenga un solo archivo, el binario. El valor predeterminado es “//tools/test:coverage_report_generator”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
predeterminado: "@bazel_tools//tools/test:coverage_support"-
Ubicación de los archivos de asistencia que se requieren en las entradas de cada acción de prueba que recopila la cobertura del código. El valor predeterminado es “//tools/test:coverage_support”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--crosstool_top=<a build target label>
predeterminado: "@bazel_tools//tools/cpp:toolchain"-
Es la etiqueta del paquete de herramientas cruzadas que se usará para compilar código en C++.
Etiquetas:loading_and_analysis
,changes_inputs
,affects_outputs
--custom_malloc=<a build target label>
valor predeterminado: consulta la descripción-
Especifica una implementación de malloc personalizada. Este parámetro de configuración anula los atributos de malloc en las reglas de compilación.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan los usos múltiples de
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
-
Lista de expresiones regulares separadas por comas, cada una con el prefijo opcional - (expresión negativa), asignadas (=) a una lista de destinos de valores de restricción separados por comas. Si un destino no coincide con ninguna expresión negativa y coincide con al menos una expresión positiva, la resolución de su cadena de herramientas se realizará como si hubiera declarado los valores de restricción como restricciones de ejecución. Ejemplo: //demo,-test=@platforms//cpus:x86_64 agregará "x86_64" a cualquier destino en //demo, excepto a aquellos cuyo nombre contenga "test".
Etiquetas:loading_and_analysis
--[no]experimental_enable_objc_cc_deps
predeterminado: "true"-
Permite que las reglas objc_* dependan de cc_library y hace que cualquier dependencia de objc se compile con --cpu establecido en "ios_<--ios_cpu>" para cualquier valor en --ios_multi_cpu.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]experimental_include_xcode_execution_requirements
predeterminado: "false"-
Si se configura, agrega un requisito de ejecución "requires-xcode:{version}" a cada acción de Xcode. Si la versión de Xcode tiene una etiqueta con guiones, también agrega un requisito de ejecución "requires-xcode-label:{version_label}".
Etiquetas:loses_incremental_state
,loading_and_analysis
,execution
--[no]experimental_prefer_mutual_xcode
predeterminado: "true"-
Si es verdadero, usa el Xcode más reciente que esté disponible de forma local y remota. Si es falso o si no hay versiones disponibles mutuas, usa la versión local de Xcode seleccionada a través de xcode-select.
Etiquetas:loses_incremental_state
- Se acumulan los usos múltiples de
--extra_execution_platforms=<comma-separated list of options>
-
Son las plataformas disponibles como plataformas de ejecución para ejecutar acciones. Las plataformas se pueden especificar por objetivo exacto o como un patrón de objetivo. Estas plataformas se considerarán antes de las que se declaren en el archivo WORKSPACE con register_execution_platforms().
Etiquetas:execution
- Se acumulan los usos múltiples de
--extra_toolchains=<comma-separated list of options>
-
Son las reglas de la cadena de herramientas que se deben tener en cuenta durante la resolución de la cadena de herramientas. Las cadenas de herramientas se pueden especificar por destino exacto o como un patrón de destino. Estas cadenas de herramientas se considerarán antes de las que se declaran en el archivo WORKSPACE con register_toolchains().
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--grte_top=<a label>
valor predeterminado: consulta la descripción-
Es una etiqueta para una biblioteca de libc registrada. El valor predeterminado se selecciona con la cadena de herramientas de compilación cruzada y casi nunca es necesario anularlo.
Etiquetas:action_command_lines
,affects_outputs
--host_compiler=<a string>
valor predeterminado: consulta la descripción-
Es el compilador de C++ que se usará para la compilación del host. Se ignora si no se establece --host_crosstool_top.
Etiquetas:loading_and_analysis
,execution
--host_crosstool_top=<a build target label>
valor predeterminado: consulta la descripción-
De forma predeterminada, las opciones --crosstool_top y --compiler también se usan para la configuración del host. Si se proporciona esta marca, Bazel usa la libc y el compilador predeterminados para el crosstool_top determinado.
Etiquetas:loading_and_analysis
,changes_inputs
,affects_outputs
--host_grte_top=<a label>
valor predeterminado: consulta la descripción-
Si se especifica, este parámetro de configuración anula el directorio de nivel superior de libc (--grte_top) para la configuración del host.
Etiquetas:action_command_lines
,affects_outputs
- Valor predeterminado de
--host_platform=<a build target label>
: "" -
Etiqueta de una regla de plataforma que describe el sistema host.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--[no]incompatible_disable_expand_if_all_available_in_flag_set
predeterminado: "true"-
Si es verdadero, Bazel no permitirá especificar expand_if_all_available en flag_sets(consulta https://github.com/bazelbuild/bazel/issues/7008 para obtener instrucciones de migración).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
predeterminado: "true"-
Si es verdadero, Bazel no habilitará las funciones "host" y "nonhost" en la cadena de herramientas de C++ (consulta https://github.com/bazelbuild/bazel/issues/7407 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_android_toolchain_resolution
predeterminado: "false"-
Usa la resolución de cadenas de herramientas para seleccionar el SDK de Android para las reglas de Android (Starlark y nativas)
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_apple_toolchain_resolution
predeterminado: "false"-
Usa la resolución de la cadena de herramientas para seleccionar el SDK de Apple para las reglas de Apple (Starlark y nativas)
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone
predeterminado: "true"-
Si es verdadero, Bazel no volverá a usar las líneas de comandos de la acción de vinculación de C++ para las líneas de comandos de indexación de LTO (consulta https://github.com/bazelbuild/bazel/issues/6791 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain
predeterminado: "true"-
Si es verdadero, Bazel mostrará un error cuando se establezcan los atributos cc_toolchain.cpu y cc_toolchain.compiler (consulta https://github.com/bazelbuild/bazel/issues/7075 para obtener instrucciones de migración).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_legacy_whole_archive
predeterminado: "true"-
Si es verdadero, Bazel no vinculará las dependencias de la biblioteca como un archivo completo de forma predeterminada (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener instrucciones de migración).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_require_ctx_in_configure_features
predeterminado: "true"-
Si es verdadero, Bazel requerirá el parámetro "ctx" en cc_common.configure_features (consulta https://github.com/bazelbuild/bazel/issues/7793 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
-
Usa objetos compartidos de interfaz si la cadena de herramientas los admite. Actualmente, todas las cadenas de herramientas de ELF admiten este parámetro de configuración.
Etiquetas:loading_and_analysis
,affects_outputs
,affects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
valor predeterminado: consulta la descripción-
Especifica la versión del SDK de iOS que se usará para compilar aplicaciones para iOS. Si no se especifica, se usa la versión predeterminada del SDK de iOS de "xcode_version".
Etiquetas:loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
valor predeterminado: consulta la descripción-
Especifica la versión del SDK de macOS que se usará para compilar aplicaciones para macOS. Si no se especifica, se usa la versión predeterminada del SDK de macOS de "xcode_version".
Etiquetas:loses_incremental_state
--minimum_os_version=<a string>
valor predeterminado: consulta la descripción-
Es la versión mínima del SO para la que se compila tu app.
Etiquetas:loading_and_analysis
,affects_outputs
- Valor predeterminado de
--platform_mappings=<a relative path>
: "" -
Ubicación de un archivo de asignación que describe qué plataforma usar si no se configuró ninguna o qué marcas establecer cuando ya existe una plataforma. Debe ser relativa a la raíz del espacio de trabajo principal. El valor predeterminado es "platform_mappings" (un archivo directamente en la raíz del espacio de trabajo).
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
- Valor predeterminado de
--platforms=<a build target label>
: "" -
Son las etiquetas de las reglas de la plataforma que describen las plataformas de destino para el comando actual.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--python2_path=<a string>
valor predeterminado: consulta la descripción-
Obsoleto, no hace nada. Se inhabilita con `--incompatible_use_python_toolchains`.
Etiquetas:no_op
,deprecated
--python3_path=<a string>
valor predeterminado: consulta la descripción-
Obsoleto, no hace nada. Se inhabilita con `--incompatible_use_python_toolchains`.
Etiquetas:no_op
,deprecated
--python_path=<a string>
valor predeterminado: consulta la descripción-
Es la ruta de acceso absoluta del intérprete de Python invocado para ejecutar destinos de Python en la plataforma de destino. Obsoleto; se inhabilita con --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
--python_top=<a build target label>
valor predeterminado: consulta la descripción-
Es la etiqueta de un py_runtime que representa el intérprete de Python invocado para ejecutar destinos de Python en la plataforma de destino. Obsoleto; se inhabilita con --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
--target_platform_fallback=<a build target label>
predeterminado: "@local_config_platform//:host"-
Es la etiqueta de una regla de plataforma que se debe usar si no se establece ninguna plataforma de destino y ninguna asignación de plataforma coincide con el conjunto actual de marcas.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
valor predeterminado: consulta la descripción-
Especifica la versión del SDK de tvOS que se usará para compilar aplicaciones para tvOS. Si no se especifica, se usa la versión predeterminada del SDK de tvOS de "xcode_version".
Etiquetas:loses_incremental_state
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
valor predeterminado: consulta la descripción-
Especifica la versión del SDK de watchOS que se usará para compilar aplicaciones para watchOS. Si no se especifica, se usa la versión predeterminada del SDK de watchOS de "xcode_version".
Etiquetas:loses_incremental_state
--xcode_version=<a string>
valor predeterminado: consulta la descripción-
Si se especifica, usa Xcode de la versión indicada para las acciones de compilación pertinentes. Si no se especifica, se usa la versión predeterminada del ejecutor de Xcode.
Etiquetas:loses_incremental_state
--xcode_version_config=<a build target label>
valor predeterminado: "@bazel_tools//tools/cpp:host_xcodes"-
Es la etiqueta de la regla xcode_config que se usará para seleccionar la versión de Xcode en la configuración de compilación.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Opciones que controlan el resultado del comando:
--[no]apple_enable_auto_dsym_dbg
predeterminado: "false"-
Indica si se debe forzar la habilitación de la generación de archivos de símbolos de depuración (.dSYM) para las compilaciones de depuración.
Etiquetas:affects_outputs
,action_command_lines
--[no]apple_generate_dsym
predeterminado: "false"-
Indica si se deben generar archivos de símbolos de depuración (.dSYM).
Etiquetas:affects_outputs
,action_command_lines
--[no]build
predeterminado: "true"-
Ejecuta la compilación. Este es el comportamiento habitual. Si se especifica --nobuild, la compilación se detiene antes de ejecutar las acciones de compilación y devuelve cero si las fases de carga y análisis del paquete se completaron correctamente. Este modo es útil para probar esas fases.
Etiquetas:execution
,affects_outputs
--[no]build_runfile_links
predeterminado: "true"-
Si es verdadero, compila bosques de vínculos simbólicos de archivos ejecutables para todos los destinos. Si es falso, escribe solo manifiestos cuando sea posible.
Etiquetas:affects_outputs
--[no]build_runfile_manifests
predeterminado: "true"-
Si es verdadero, escribe manifiestos de archivos ejecutables para todos los destinos. Si es falso, omítelos. Las pruebas locales no se ejecutarán cuando sea falso.
Etiquetas:affects_outputs
--[no]build_test_dwp
predeterminado: "false"-
Si está habilitado, cuando se compilen pruebas de C++ de forma estática y con fission, también se compilará automáticamente el archivo .dwp para el archivo binario de prueba.
Etiquetas:loading_and_analysis
,affects_outputs
--cc_proto_library_header_suffixes=<comma-separated list of options>
predeterminado: ".pb.h"-
Establece los prefijos de los archivos de encabezado que crea un cc_proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated list of options>
predeterminado: ".pb.cc"-
Establece los prefijos de los archivos fuente que crea un cc_proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info
predeterminado: "false"-
Ejecuta acciones adicionales para versiones alternativas de la API de Java en un proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_proto_extra_actions
predeterminado: "false"-
Ejecuta acciones adicionales para versiones alternativas de la API de Java en un proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_run_validations
predeterminado: "true"-
En su lugar, usa --run_validations.
Etiquetas:execution
,affects_outputs
--[no]experimental_save_feature_state
predeterminado: "false"-
Guarda el estado de las funciones habilitadas y solicitadas como resultado de la compilación.
Etiquetas:affects_outputs
,experimental
--[no]experimental_use_validation_aspect
predeterminado: "false"-
Indica si se deben ejecutar acciones de validación con el aspecto (para paralelismo con las pruebas).
Etiquetas:execution
,affects_outputs
--fission=<a set of compilation modes>
predeterminado: "no"-
Especifica qué modos de compilación usan fission para las compilaciones y las vinculaciones de C++. Puede ser cualquier combinación de {"fastbuild", "dbg", "opt"} o los valores especiales "yes" para habilitar todos los modos y "no" para inhabilitar todos los modos.
Etiquetas:loading_and_analysis
,action_command_lines
,affects_outputs
--[no]incompatible_always_include_files_in_data
predeterminado: "true"-
Si es verdadero, las reglas nativas agregan <code>DefaultInfo.files</code> de las dependencias de datos a sus archivos ejecutables, lo que coincide con el comportamiento recomendado para las reglas de Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid).
Etiquetas:affects_outputs
,incompatible_change
--[no]legacy_external_runfiles
predeterminado: "true"-
Si es verdadero, compila bosques de vínculos simbólicos de archivos de ejecución para repositorios externos en .runfiles/wsname/external/repo (además de .runfiles/repo).
Etiquetas:affects_outputs
--[no]objc_generate_linkmap
predeterminado: "false"-
Especifica si se debe generar un archivo de mapa de vínculos.
Etiquetas:affects_outputs
- Se acumulan los usos múltiples de
--output_groups=<comma-separated list of options>
-
Es una lista de nombres de grupos de salida separados por comas, cada uno de los cuales puede tener un prefijo + o -. Los grupos con el prefijo + se agregan al conjunto predeterminado de grupos de salida, mientras que los grupos con el prefijo - se quitan del conjunto predeterminado. Si al menos un grupo no tiene prefijo, se omite el conjunto predeterminado de grupos de salida. Por ejemplo, --output_groups=+foo,+bar compila la unión del conjunto predeterminado, foo y bar, mientras que --output_groups=foo,bar anula el conjunto predeterminado de modo que solo se compilen foo y bar.
Etiquetas:execution
,affects_outputs
--[no]run_validations
predeterminado: "true"-
Indica si se deben ejecutar acciones de validación como parte de la compilación. Consulta https://bazel.build/rules/rules#validation_actions.
Etiquetas:execution
,affects_outputs
--[no]save_temps
predeterminado: "false"-
Si se configura, se guardarán los resultados temporales de gcc. Estos incluyen archivos .s (código de ensamblador), archivos .i (C preprocesado) y archivos .ii (C++ preprocesado).
Etiquetas:affects_outputs
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
- Se acumulan los usos múltiples de
--action_env=<a 'name=value' assignment with an optional value part>
-
Especifica el conjunto de variables de entorno disponibles para las acciones con configuración de destino. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o bien por el par nombre=valor que establece el valor independientemente del entorno de invocación. Esta opción se puede usar varias veces. En el caso de las opciones proporcionadas para la misma variable, se aplica la más reciente. Las opciones para diferentes variables se acumulan.
Etiquetas:action_command_lines
--android_cpu=<a string>
predeterminado: "armeabi-v7a"-
Es la CPU objetivo de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]android_databinding_use_androidx
predeterminado: "false"-
Genera archivos de vinculación de datos compatibles con AndroidX. Esto solo se usa con la vinculación de datos v2.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]android_databinding_use_v3_4_args
predeterminado: "false"-
Usa la vinculación de datos de Android v2 con el argumento 3.4.0
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--android_dynamic_mode=<off, default or fully>
predeterminado: "off"-
Determina si las dependencias de C++ de las reglas de Android se vincularán de forma dinámica cuando un cc_binary no cree de forma explícita una biblioteca compartida. "default" significa que Bazel elegirá si se vincula de forma dinámica. "fully" significa que todas las bibliotecas se vincularán de forma dinámica. "off" significa que todas las bibliotecas se vincularán principalmente en modo estático.
Etiquetas:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
predeterminado: "alfabético"-
Establece el orden de los manifiestos que se pasan al combinador de manifiestos para los archivos binarios de Android. ALPHABETICAL significa que los manifiestos se ordenan por ruta de acceso relativa a execroot. ALPHABETICAL_BY_CONFIGURATION significa que los manifiestos se ordenan por rutas de acceso relativas al directorio de configuración dentro del directorio de salida. DEPENDENCY significa que los manifiestos se ordenan de modo que el manifiesto de cada biblioteca aparezca antes de los manifiestos de sus dependencias.
Etiquetas:action_command_lines
,execution
--[no]android_resource_shrinking
predeterminado: "false"-
Habilita la reducción de recursos para los APKs de android_binary que usan ProGuard.
Etiquetas:affects_outputs
,loading_and_analysis
- Se acumulan los usos múltiples de
--apple_bitcode=<'mode' or 'platform=mode', where 'mode' is none, embedded_markers or embedded, and 'platform' is ios, visionos, watchos, tvos, macos or catalyst>
-
Especifica el modo de bitcode de Apple para los pasos de compilación que tienen como objetivo las arquitecturas de dispositivos. Los valores tienen el formato "[plataforma=]modo", en el que la plataforma (que debe ser "ios", "macos", "tvos" o "watchos") es opcional. Si se proporciona, el modo de bitcode se aplica específicamente para esa plataforma. Si se omite, se aplica para todas las plataformas. El modo debe ser "none", "embedded_markers" o "embedded". Esta opción se puede proporcionar varias veces.
Etiquetas:loses_incremental_state
- Se acumulan los usos múltiples de
--aspects=<comma-separated list of options>
- Lista separada por comas de los aspectos que se aplicarán a los objetivos de nivel superior. En la lista, si el aspecto some_aspect especifica proveedores de aspectos obligatorios a través de required_aspect_providers, some_aspect se ejecutará después de cada aspecto que se mencionó antes en la lista de aspectos cuyos proveedores anunciados satisfagan los proveedores de aspectos obligatorios de some_aspect. Además, some_aspect se ejecutará después de todos los aspectos requeridos especificados por el atributo requires. Luego, some_aspect tendrá acceso a los valores de los proveedores de esos aspectos. <bzl-file-label>%<aspect_name>, por ejemplo, "//tools:my_def.bzl%my_aspect", donde "my_aspect" es un valor de nivel superior de un archivo tools/my_def.bzl
--[no]build_python_zip
predeterminado: "auto"-
Compila el archivo .zip ejecutable de Python; activado en Windows, desactivado en otras plataformas
Etiquetas:affects_outputs
- Se acumulan los usos múltiples de
--catalyst_cpus=<comma-separated list of options>
-
Lista separada por comas de las arquitecturas para las que se compilarán los archivos binarios de Apple Catalyst.
Etiquetas:loses_incremental_state
,loading_and_analysis
--[no]collect_code_coverage
predeterminado: "false"-
Si se especifica, Bazel instrumentará el código (con instrumentación sin conexión cuando sea posible) y recopilará información de cobertura durante las pruebas. Solo se verán afectados los destinos que coincidan con --instrumentation_filter. Por lo general, esta opción no se debe especificar directamente. En su lugar, se debe usar el comando "bazel coverage".
Etiquetas:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] valor predeterminado: "fastbuild"-
Especifica el modo en el que se compilará el objeto binario. Valores: "fastbuild", "dbg", "opt".
Etiquetas:affects_outputs
,action_command_lines
,explicit_in_output_path
- Se acumulan los usos múltiples de
--conlyopt=<a string>
-
Opción adicional para pasar a gcc cuando se compilan archivos de origen C.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan los usos múltiples de
--copt=<a string>
-
Opciones adicionales para pasar a gcc.
Etiquetas:action_command_lines
,affects_outputs
- Valor predeterminado de
--cpu=<a string>
: "" -
CPU objetivo.
Etiquetas:changes_inputs
,affects_outputs
,explicit_in_output_path
--cs_fdo_absolute_path=<a string>
valor predeterminado: consulta la descripción-
Usa la información del perfil de CSFDO para optimizar la compilación. Especifica el nombre de la ruta de acceso absoluta del archivo ZIP que contiene el archivo de perfil, un archivo de perfil de LLVM sin procesar o indexado.
Etiquetas:affects_outputs
--cs_fdo_instrument=<a string>
valor predeterminado: consulta la descripción-
Genera archivos binarios con la instrumentación de FDO sensible al contexto. Con el compilador Clang/LLVM, también acepta el nombre del directorio en el que se volcarán los archivos de perfil sin procesar en el tiempo de ejecución.
Etiquetas:affects_outputs
--cs_fdo_profile=<a build target label>
valor predeterminado: consulta la descripción-
Es el cs_fdo_profile que representa el perfil sensible al contexto que se usará para la optimización.
Etiquetas:affects_outputs
- Se acumulan los usos múltiples de
--cxxopt=<a string>
-
Opción adicional para pasar a gcc cuando se compilan archivos de origen C++.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan los usos múltiples de
--define=<a 'name=value' assignment>
-
Cada opción --define especifica una asignación para una variable de compilación.
Etiquetas:changes_inputs
,affects_outputs
--dynamic_mode=<off, default or fully>
predeterminado: "default"-
Determina si los archivos binarios de C++ se vincularán de forma dinámica. "default" significa que Bazel elegirá si se vincula de forma dinámica. "fully" significa que todas las bibliotecas se vincularán de forma dinámica. "off" significa que todas las bibliotecas se vincularán principalmente en modo estático.
Etiquetas:loading_and_analysis
,affects_outputs
--[no]enable_fdo_profile_absolute_path
predeterminado: "true"-
Si se configura, el uso de fdo_absolute_profile_path generará un error.
Etiquetas:affects_outputs
--[no]enable_runfiles
predeterminado: "auto"-
Habilita el árbol de vínculos simbólicos de runfiles. De forma predeterminada, está desactivado en Windows y activado en otras plataformas.
Etiquetas:affects_outputs
- Se acumulan los usos múltiples de
--experimental_action_listener=<a build target label>
-
Dejó de estar disponible y se reemplazó por aspectos. Usa action_listener para adjuntar un extra_action a las acciones de compilación existentes.
Etiquetas:execution
,experimental
--[no]experimental_android_compress_java_resources
predeterminado: "false"-
Comprimir recursos de Java en APKs
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_android_databinding_v2
predeterminado: "false"-
Use android databinding v2
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_android_resource_shrinking
predeterminado: "false"-
Habilita la reducción de recursos para los APKs de android_binary que usan ProGuard.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_android_rewrite_dexes_with_rex
predeterminado: "false"-
use rex tool to rewrite dex files
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_collect_code_coverage_for_generated_files
predeterminado: "false"-
Si se especifica, Bazel también generará información de recopilación de cobertura para los archivos generados.
Etiquetas:affects_outputs
--[no]experimental_convenience_symlinks
predeterminado: "normal"-
Esta marca controla cómo se administrarán los vínculos simbólicos de conveniencia (los vínculos simbólicos que aparecen en el espacio de trabajo después de la compilación). Valores posibles:
normal (predeterminado): Se creará o borrará cada tipo de vínculo simbólico de conveniencia, según lo determine la compilación.
clean: Se borrarán todos los vínculos simbólicos de forma incondicional.
ignore: Los vínculos simbólicos no se modificarán.
log_only: Genera mensajes de registro como si se hubiera pasado "normal", pero no realiza ninguna operación del sistema de archivos (útil para las herramientas).
Ten en cuenta que solo se pueden afectar los vínculos simbólicos cuyos nombres se generen con el valor actual de --symlink_prefix. Si cambia el prefijo, los vínculos simbólicos preexistentes no se modificarán.
Etiquetas:affects_outputs
--[no]experimental_convenience_symlinks_bep_event
predeterminado: "false"-
Esta marca controla si publicaremos el evento ConvenienceSymlinksIdentified de compilación en BuildEventProtocol. Si el valor es verdadero, BuildEventProtocol tendrá una entrada para convenienceSymlinksIdentified, en la que se enumerarán todos los vínculos simbólicos de conveniencia creados en tu espacio de trabajo. Si es falso, la entrada convenienceSymlinksIdentified en BuildEventProtocol estará vacía.
Etiquetas:affects_outputs
- Se acumulan los usos múltiples de
--experimental_multi_cpu=<comma-separated list of options>
-
Obsoleto. No se realiza ninguna operación.
Etiquetas:affects_outputs
,experimental
--experimental_objc_fastbuild_options=<comma-separated list of options>
predeterminado: "-O0,-DDEBUG=1"-
Usa estas cadenas como opciones del compilador de compilación rápida de objc.
Etiquetas:action_command_lines
--[no]experimental_omitfp
predeterminado: "false"-
Si es verdadero, usa libunwind para el desenrollado de la pila y compila con -fomit-frame-pointer y -fasynchronous-unwind-tables.
Etiquetas:action_command_lines
,affects_outputs
,experimental
--[no]experimental_platform_in_output_dir
predeterminado: "false"-
Si es verdadero, la plataforma de destino se usa en el nombre del directorio de salida en lugar de la CPU.
Etiquetas:affects_outputs
,experimental
--[no]experimental_use_llvm_covmap
predeterminado: "false"-
Si se especifica, Bazel generará información del mapa de cobertura de llvm-cov en lugar de gcov cuando se habilite collect_code_coverage.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
--fat_apk_cpu=<comma-separated list of options>
predeterminado: "armeabi-v7a"-
Si configuras esta opción, se habilitarán los APKs multiarquitectura, que contienen objetos binarios nativos para todas las arquitecturas de destino especificadas, p.ej., --fat_apk_cpu=x86,armeabi-v7a. Si se especifica esta marca, se ignora --android_cpu para las dependencias de las reglas de android_binary.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]fat_apk_hwasan
predeterminado: "false"-
Indica si se deben crear divisiones de HWASAN.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--fdo_instrument=<a string>
valor predeterminado: consulta la descripción-
Genera archivos binarios con la instrumentación de FDO. Con el compilador Clang/LLVM, también acepta el nombre del directorio en el que se volcarán los archivos de perfil sin procesar en el tiempo de ejecución.
Etiquetas:affects_outputs
--fdo_optimize=<a string>
valor predeterminado: consulta la descripción-
Usa la información del perfil de FDO para optimizar la compilación. Especifica el nombre de un archivo ZIP que contenga un árbol de archivos .gcda, un archivo AFDO que contenga un perfil automático o un archivo de perfil de LLVM. Esta marca también acepta archivos especificados como etiquetas (p.ej., `//foo/bar:file.afdo`; es posible que debas agregar una directiva `exports_files` al paquete correspondiente) y etiquetas que apuntan a destinos `fdo_profile`. Esta marca se reemplazará por la regla "fdo_profile".
Etiquetas:affects_outputs
--fdo_prefetch_hints=<a build target label>
valor predeterminado: consulta la descripción-
Usa sugerencias de recuperación previa de caché.
Etiquetas:affects_outputs
--fdo_profile=<a build target label>
valor predeterminado: consulta la descripción-
Es el objeto fdo_profile que representa el perfil que se usará para la optimización.
Etiquetas:affects_outputs
- Se acumulan los usos múltiples de
--features=<a string>
-
Las funciones proporcionadas se habilitarán o inhabilitarán de forma predeterminada para los destinos compilados en la configuración de destino. Si especificas -<feature>, se inhabilitará la función. Las funciones negativas siempre anulan las positivas. Consulta también --host_features.
Etiquetas:changes_inputs
,affects_outputs
--[no]force_pic
predeterminado: "false"-
Si está habilitado, todas las compilaciones de C++ producen código independiente de la posición (“-fPIC”), las vinculaciones prefieren las bibliotecas prediseñadas PIC a las bibliotecas no PIC y las vinculaciones producen ejecutables independientes de la posición (“-pie”).
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan los usos múltiples de
--host_action_env=<a 'name=value' assignment with an optional value part>
-
Especifica el conjunto de variables de entorno disponibles para las acciones con configuraciones de host o de ejecución. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o bien por el par nombre=valor que establece el valor independientemente del entorno de invocación. Esta opción se puede usar varias veces. En el caso de las opciones proporcionadas para la misma variable, se aplica la más reciente. Las opciones para diferentes variables se acumulan.
Etiquetas:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
valor predeterminado: "opt"-
Especifica el modo en el que se compilarán las herramientas que se usan durante la compilación. Valores: "fastbuild", "dbg", "opt".
Etiquetas:affects_outputs
,action_command_lines
- Se acumulan los usos múltiples de
--host_conlyopt=<a string>
-
Opción adicional para pasar a gcc cuando se compilan archivos de origen C para herramientas del host.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan los usos múltiples de
--host_copt=<a string>
-
Opciones adicionales para pasar a gcc para las herramientas del host.
Etiquetas:action_command_lines
,affects_outputs
- Valor predeterminado de
--host_cpu=<a string>
: "" -
Es la CPU del host.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan los usos múltiples de
--host_cxxopt=<a string>
-
Opciones adicionales para pasar a gcc para las herramientas del host.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan los usos múltiples de
--host_features=<a string>
-
Las funciones proporcionadas se habilitarán o inhabilitarán de forma predeterminada para los destinos compilados en la configuración de ejecución. Si especificas -<feature>, se inhabilitará la función. Las funciones negativas siempre anulan las positivas.
Etiquetas:changes_inputs
,affects_outputs
--host_force_python=<PY2 or PY3>
valor predeterminado: consulta la descripción-
Anula la versión de Python para la configuración del host. Puede ser "PY2" o "PY3".
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan los usos múltiples de
--host_linkopt=<a string>
-
Opción adicional para pasar a gcc cuando se vinculan herramientas del host.
Etiquetas:action_command_lines
,affects_outputs
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
valor predeterminado: consulta la descripción-
Versión mínima de macOS compatible con los destinos de host. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan los usos múltiples de
--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>
-
Opciones adicionales para pasar de forma selectiva al compilador de C/C++ cuando se compilan ciertos archivos en las configuraciones de host o de ejecución. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,…,option_n. Aquí, regex_filter representa una lista de patrones de expresiones regulares de inclusión y exclusión (consulta también --instrumentation_filter), y option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe incluirse entre comillas con una barra diagonal inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos de gcc de todos los archivos .cc en //foo/, excepto bar.cc.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan los usos múltiples de
--host_swiftcopt=<a string>
-
Opciones adicionales para pasar a swiftc para las herramientas del host.
Etiquetas:action_command_lines
,affects_outputs
--[no]incompatible_avoid_conflict_dlls
predeterminado: "true"-
Si está habilitado, todas las bibliotecas de vínculos dinámicos (DLL) de C++ generadas por cc_library en Windows se cambiarán de nombre a name_{hash}.dll, donde hash se calcula en función de RepositoryName y la ruta del paquete de la DLL. Esta opción es útil cuando tienes un paquete que depende de varias cc_library con el mismo nombre (p. ej., //foo/bar1:utils y //foo/bar2:utils).
Etiquetas:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_merge_genfiles_directory
predeterminado: "true"-
Si es verdadero, el directorio genfiles se pliega en el directorio bin.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_use_host_features
predeterminado: "false"-
Si es verdadero, usa --features solo para la configuración de destino y --host_features para la configuración de ejecución.
Etiquetas:changes_inputs
,affects_outputs
,incompatible_change
--[no]incompatible_use_platforms_repo_for_constraints
predeterminado: "true"-
Si es verdadero, se quita la configuración de restricción de @bazel_tools.
Etiquetas:affects_outputs
,incompatible_change
--[no]instrument_test_targets
predeterminado: "false"-
Cuando la cobertura está habilitada, especifica si se deben considerar las reglas de prueba de instrumentación. Cuando se configura, se instrumentan las reglas de prueba incluidas por --instrumentation_filter. De lo contrario, las reglas de prueba siempre se excluyen de la instrumentación de cobertura.
Etiquetas:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
valor predeterminado: "-/javatests[/:],-/test/java[/:]"-
Cuando la cobertura está habilitada, solo se instrumentarán las reglas con nombres incluidos en el filtro basado en regex especificado. En su lugar, se excluyen las reglas que tienen el prefijo "-". Ten en cuenta que solo se instrumentan las reglas que no son de prueba, a menos que se habilite --instrument_test_targets.
Etiquetas:affects_outputs
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
valor predeterminado: consulta la descripción-
Versión mínima compatible de iOS para los simuladores y dispositivos de destino. Si no se especifica, se usa "ios_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan los usos múltiples de
--ios_multi_cpus=<comma-separated list of options>
-
Lista separada por comas de las arquitecturas con las que se compilará un ios_application. El resultado es un binario universal que contiene todas las arquitecturas especificadas.
Etiquetas:loses_incremental_state
,loading_and_analysis
--[no]legacy_whole_archive
predeterminado: "true"-
Obsoleto. Se reemplazó por --incompatible_remove_legacy_whole_archive (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener más detalles). Cuando está activado, usa --whole-archive para las reglas cc_binary que tienen linkshared=True y linkstatic=True o "-static" en linkopts. Esto es solo para la retrocompatibilidad. Una mejor alternativa es usar alwayslink=1 cuando sea necesario.
Etiquetas:action_command_lines
,affects_outputs
,deprecated
- Se acumulan los usos múltiples de
--linkopt=<a string>
-
Opción adicional para pasar a gcc durante la vinculación.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan los usos múltiples de
--ltobackendopt=<a string>
-
Opción adicional para pasar al paso de backend de LTO (en --features=thin_lto).
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan los usos múltiples de
--ltoindexopt=<a string>
-
Opción adicional para pasar al paso de indexación de LTO (en --features=thin_lto).
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan los usos múltiples de
--macos_cpus=<comma-separated list of options>
-
Lista separada por comas de las arquitecturas para las que se compilarán los archivos binarios de Apple macOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
valor predeterminado: consulta la descripción-
Versión mínima de macOS compatible con los destinos. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
--[no]objc_debug_with_GLIBCXX
predeterminado: "false"-
Si se configura y el modo de compilación se establece en "dbg", define GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC y GLIBCPP_CONCEPT_CHECKS.
Etiquetas:action_command_lines
--[no]objc_enable_binary_stripping
predeterminado: "false"-
Indica si se deben quitar los símbolos y el código no utilizado de los archivos binarios vinculados. Se realizará el despojo de binarios si se especifican esta marca y --compilation_mode=opt.
Etiquetas:action_command_lines
- Se acumulan los usos múltiples de
--objccopt=<a string>
-
Opciones adicionales para pasar a gcc cuando se compilan archivos de origen Objective-C/C++.
Etiquetas:action_command_lines
- Se acumulan los usos múltiples de
--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>
-
Opciones adicionales para pasar de forma selectiva a gcc cuando se compilan ciertos archivos. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,…,option_n. Aquí, regex_filter representa una lista de patrones de expresiones regulares de inclusión y exclusión (consulta también --instrumentation_filter), y option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe incluirse entre comillas con una barra diagonal inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos de gcc de todos los archivos cc en //foo/ excepto bar.cc.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan los usos múltiples de
--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>
-
Opciones adicionales para pasar de forma selectiva al backend de LTO (en --features=thin_lto) cuando se compilan ciertos objetos del backend. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,…,option_n. Aquí regex_filter representa una lista de patrones de expresiones regulares de inclusión y exclusión, y option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe incluirse entre comillas con una barra diagonal inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos del backend de LTO de todos los archivos .o en //foo/, excepto bar.o.
Etiquetas:action_command_lines
,affects_outputs
--platform_suffix=<a string>
valor predeterminado: consulta la descripción-
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas:loses_incremental_state
,affects_outputs
,loading_and_analysis
--propeller_optimize=<a build target label>
valor predeterminado: consulta la descripción-
Usa la información del perfil de Propeller para optimizar el destino de compilación.Un perfil de Propeller debe constar de al menos uno de los dos archivos, un perfil de cc y un perfil de ld. Esta marca acepta una etiqueta de compilación que debe hacer referencia a los archivos de entrada del perfil de Propeller. Por ejemplo, el archivo BUILD que define la etiqueta, en a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)Es posible que se deba agregar una directiva exports_files al paquete correspondiente para que Bazel pueda ver estos archivos. La opción se debe usar de la siguiente manera: --propeller_optimize=//a/b:propeller_profile
Etiquetas:action_command_lines
,affects_outputs
--propeller_optimize_absolute_cc_profile=<a string>
valor predeterminado: consulta la descripción-
Nombre de ruta de acceso absoluta del archivo cc_profile para las compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
valor predeterminado: consulta la descripción-
Nombre de ruta de acceso absoluta del archivo ld_profile para las compilaciones optimizadas con Propeller.
Etiquetas:affects_outputs
--run_under=<a prefix in front of command>
valor predeterminado: consulta la descripción-
Prefijo que se insertará antes de los ejecutables para los comandos "test" y "run". Si el valor es "foo -bar" y la línea de comandos de ejecución es "test_binary -baz", la línea de comandos final es "foo -bar test_binary -baz".También puede ser una etiqueta para un destino ejecutable. Algunos ejemplos son "valgrind", "strace", "strace -c", "valgrind --quiet --num-callers=20", "//package:target" y "//package:target --options".
Etiquetas:action_command_lines
-
Si es verdadero, las bibliotecas nativas que contienen la misma funcionalidad se compartirán entre diferentes destinos.
Etiquetas:loading_and_analysis
,affects_outputs
--[no]stamp
predeterminado: "false"-
Sella los archivos binarios con la fecha, el nombre de usuario, el nombre de host, la información del espacio de trabajo, etcétera.
Etiquetas:affects_outputs
- Valor predeterminado de
--strip=<always, sometimes or never>
: "sometimes" -
Especifica si se deben quitar los archivos binarios y las bibliotecas compartidas (con "-Wl,--strip-debug"). El valor predeterminado "sometimes" significa que se quita solo si --compilation_mode=fastbuild.
Etiquetas:affects_outputs
- Se acumulan los usos múltiples de
--stripopt=<a string>
-
Opciones adicionales para pasar a strip cuando se genera un objeto binario "<name>.stripped".
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan los usos múltiples de
--swiftcopt=<a string>
-
Opciones adicionales para pasar a la compilación de Swift.
Etiquetas:action_command_lines
--symlink_prefix=<a string>
valor predeterminado: consulta la descripción-
Es el prefijo que se antepone a cualquiera de los vínculos simbólicos de conveniencia que se crean después de una compilación. Si se omite, el valor predeterminado es el nombre de la herramienta de compilación seguido de un guion. Si se pasa "/", no se crean vínculos simbólicos y no se emite ninguna advertencia. Advertencia: La funcionalidad especial para "/" dejará de estar disponible pronto. En su lugar, usa --experimental_convenience_symlinks=ignore.
Etiquetas:affects_outputs
- Se acumulan los usos múltiples de
--tvos_cpus=<comma-separated list of options>
-
Lista separada por comas de las arquitecturas para las que se compilarán los archivos binarios de tvOS de Apple.
Etiquetas:loses_incremental_state
,loading_and_analysis
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
valor predeterminado: consulta la descripción-
Versión mínima compatible de tvOS para los simuladores y dispositivos de destino. Si no se especifica, se usa "tvos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan los usos múltiples de
--visionos_cpus=<comma-separated list of options>
-
Lista separada por comas de las arquitecturas para las que se compilarán los archivos binarios de Apple visionOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Se acumulan los usos múltiples de
--watchos_cpus=<comma-separated list of options>
-
Lista separada por comas de las arquitecturas para las que se compilarán los archivos binarios de watchOS de Apple.
Etiquetas:loses_incremental_state
,loading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
valor predeterminado: consulta la descripción-
Versión mínima compatible de watchOS para los simuladores y dispositivos de destino. Si no se especifica, se usa "watchos_sdk_version".
Etiquetas:loses_incremental_state
--xbinary_fdo=<a build target label>
valor predeterminado: consulta la descripción-
Usa la información del perfil de XbinaryFDO para optimizar la compilación. Especifica el nombre del perfil predeterminado de varias plataformas. Cuando la opción se usa junto con --fdo_instrument/--fdo_optimize/--fdo_profile, esas opciones siempre prevalecerán como si xbinary_fdo nunca se hubiera especificado.
Etiquetas:affects_outputs
- Opciones que afectan la rigidez con la que Bazel aplica las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
- Valor predeterminado de
--auto_cpu_environment_group=<a build target label>
: "" -
Declara el environment_group que se usará para asignar automáticamente los valores de cpu a los valores de target_environment.
Etiquetas:changes_inputs
,loading_and_analysis
,experimental
--[no]check_licenses
predeterminado: "false"-
Verifica que las restricciones de licencias impuestas por los paquetes dependientes no entren en conflicto con los modos de distribución de los destinos que se compilan. De forma predeterminada, no se verifican las licencias.
Etiquetas:build_file_semantics
--[no]check_visibility
predeterminado: "true"-
Si se inhabilita, los errores de visibilidad en las dependencias de destino se degradan a advertencias.
Etiquetas:build_file_semantics
--[no]desugar_for_android
predeterminado: "true"-
Indica si se debe aplicar desugar al código de bytes de Java 8 antes de convertirlo en dex.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]desugar_java8_libs
predeterminado: "false"-
Indica si se deben incluir las bibliotecas de Java 8 compatibles en las apps para dispositivos heredados.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]enforce_constraints
predeterminado: "true"-
Verifica los entornos con los que es compatible cada destino y genera errores si algún destino tiene dependencias que no admiten los mismos entornos.
Etiquetas:build_file_semantics
--[no]experimental_allow_android_library_deps_without_srcs
predeterminado: "false"-
Es una marca para ayudar a la transición de permitir a no permitir reglas android_library sin srcs con dependencias. El depósito debe limpiarse para lanzar esta función de forma predeterminada.
Etiquetas:eagerness_to_exit
,loading_and_analysis
--[no]experimental_check_desugar_deps
predeterminado: "true"-
Indica si se debe verificar la desazucaración correcta a nivel binario de Android.
Etiquetas:eagerness_to_exit
,loading_and_analysis
,experimental
--experimental_import_deps_checking=<off, warning or error>
predeterminado: "OFF"-
Cuando está habilitado, verifica si las dependencias de un aar_import están completas. Esta aplicación de la política puede interrumpir la compilación o simplemente generar advertencias.
Etiquetas:loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
predeterminado: "default"-
Si es verdadero, verifica que un destino de Java declare explícitamente todos los destinos que se usan directamente como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files
predeterminado: "false"-
Si está habilitado, verifica testonly para los destinos de requisitos previos que son archivos de salida buscando el testonly de la regla de generación. Esto coincide con la verificación de visibilidad.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_disable_native_android_rules
predeterminado: "false"-
Si se habilita, se inhabilita el uso directo de las reglas nativas de Android. Usa las reglas de Starlark para Android de https://github.com/bazelbuild/rules_android.
Etiquetas:eagerness_to_exit
,incompatible_change
--[no]incompatible_disable_native_apple_binary_rule
predeterminado: "false"-
No realiza ninguna operación. Se mantiene aquí para la retrocompatibilidad.
Etiquetas:eagerness_to_exit
,incompatible_change
--[no]incompatible_force_strict_header_check_from_starlark
predeterminado: "true"-
Si está habilitado, establece la verificación estricta de encabezados en la API de Starlark.
Etiquetas:loading_and_analysis
,changes_inputs
,incompatible_change
--[no]incompatible_validate_top_level_header_inclusions
predeterminado: "true"-
Si es verdadero, Bazel también validará las inclusiones de encabezado de directorio de nivel superior (consulta https://github.com/bazelbuild/bazel/issues/10047 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]strict_filesets
predeterminado: "false"-
Si esta opción está habilitada, los conjuntos de archivos que cruzan los límites del paquete se informan como errores. No funciona cuando check_fileset_dependencies_recursively está inhabilitado.
Etiquetas:build_file_semantics
,eagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default>
predeterminado: "error"-
A menos que esté DESACTIVADO, verifica que un destino proto_library declare explícitamente todos los destinos utilizados directamente como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
--strict_public_imports=<off, warn, error, strict or default>
predeterminado: "off"-
A menos que esté DESACTIVADO, verifica que un destino proto_library declare de forma explícita todos los destinos que se usan en "import public" como exportados.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
--[no]strict_system_includes
predeterminado: "false"-
Si es verdadero, también se deben declarar los encabezados que se encuentran a través de las rutas de inclusión del sistema (-isystem).
Etiquetas:loading_and_analysis
,eagerness_to_exit
- Se acumulan los usos múltiples de
--target_environment=<a build target label>
-
Declara el entorno de destino de esta compilación. Debe ser una referencia de etiqueta a una regla "environment". Si se especifica, todos los objetivos de nivel superior deben ser compatibles con este entorno.
Etiquetas:changes_inputs
- Opciones que afectan los resultados de la firma de una compilación:
--apk_signing_method=<v1, v2, v1_v2 or v4>
predeterminado: "v1_v2"-
Implementación que se usará para firmar APKs
Etiquetas:action_command_lines
,affects_outputs
,loading_and_analysis
--[no]device_debug_entitlements
predeterminado: "true"-
Si se configura y el modo de compilación no es "opt", las apps en Objective-C incluirán derechos de depuración cuando se firmen.
Etiquetas:changes_inputs
--ios_signing_cert_name=<a string>
valor predeterminado: consulta la descripción-
Nombre del certificado que se usará para la firma de iOS. Si no se configura, se volverá al perfil de aprovisionamiento. Puede ser la preferencia de identidad del llavero del certificado o una subcadena del nombre común del certificado, según la página de manual de codesign (IDENTIDADES DE FIRMA).
Etiquetas:action_command_lines
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility
predeterminado: "false"-
Si incompatible_enforce_config_setting_visibility=false, esta es una operación nula. De lo contrario, si esta marca es falsa, cualquier config_setting sin un atributo de visibilidad explícito es //visibility:public. Si esta marca es verdadera, config_setting sigue la misma lógica de visibilidad que todas las demás reglas. Consulta https://github.com/bazelbuild/bazel/issues/12933.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_legacy_py_provider
predeterminado: "true"-
No-op, se quitará pronto.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
predeterminado: "true"-
Si es verdadero, se aplican las restricciones de visibilidad de config_setting. Si es falso, todos los config_setting son visibles para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones que rigen el comportamiento del entorno de prueba o del ejecutor de pruebas:
--[no]allow_analysis_failures
predeterminado: "false"-
Si es verdadero, un error de análisis de un destino de regla hace que el destino propague una instancia de AnalysisFailureInfo que contiene la descripción del error, en lugar de generar un error de compilación.
Etiquetas:loading_and_analysis
,experimental
--analysis_testing_deps_limit=<an integer>
predeterminado: "2000"-
Establece la cantidad máxima de dependencias transitivas a través de un atributo de regla con una transición de configuración for_analysis_testing. Si se supera este límite, se generará un error de regla.
Etiquetas:loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure
predeterminado: "false"-
Si es verdadero, los errores de la acción dex2oat harán que se interrumpa la compilación en lugar de ejecutar dex2oat durante el tiempo de ejecución de la prueba.
Etiquetas:loading_and_analysis
,experimental
--[no]check_tests_up_to_date
predeterminado: "false"-
No ejecuta pruebas, solo verifica si están actualizadas. Si todos los resultados de las pruebas están actualizados, la prueba se completa correctamente. Si se debe compilar o ejecutar alguna prueba, se informa un error y falla la prueba. Esta opción implica el comportamiento de --check_up_to_date.
Etiquetas:execution
--[no]experimental_android_use_parallel_dex2oat
predeterminado: "false"-
Usa dex2oat en paralelo para acelerar android_test.
Etiquetas:loading_and_analysis
,host_machine_resource_optimizations
,experimental
- Se acumulan los usos múltiples de
--flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once>
-
Cada prueba se reintentará hasta la cantidad especificada de veces en caso de que falle. Las pruebas que requirieron más de un intento para aprobarse se marcan como "INESTABLES" en el resumen de la prueba. Por lo general, el valor especificado es solo un número entero o la cadena "default". Si es un número entero, todas las pruebas se ejecutarán hasta N veces. Si se establece en "default", solo se realizará un intento de prueba para las pruebas normales y tres para las pruebas marcadas explícitamente como inestables por su regla (atributo flaky=1). Sintaxis alternativa: regex_filter@flaky_test_attempts. Aquí flaky_test_attempts es como se explicó anteriormente y regex_filter representa una lista de patrones de expresiones regulares de inclusión y exclusión (consulta también --runs_per_test). Ejemplo: --flaky_test_attempts=//foo/.*,-//foo/bar/.*@3 elimina la inestabilidad de todas las pruebas en //foo/ excepto las que se encuentran en foo/bar tres veces. Esta opción se puede pasar varias veces. Tiene prioridad el argumento que se pasó más recientemente y que coincide. Si no hay coincidencias, el comportamiento es como el de "predeterminado" anterior.
Etiquetas:execution
--[no]ios_memleaks
predeterminado: "false"-
Habilita la verificación de pérdidas de memoria en los destinos de ios_test.
Etiquetas:action_command_lines
--ios_simulator_device=<a string>
valor predeterminado: consulta la descripción-
Es el dispositivo que se simulará cuando se ejecute una aplicación para iOS en el simulador, p.ej., "iPhone 6". Puedes obtener una lista de dispositivos ejecutando "xcrun simctl list devicetypes" en la máquina en la que se ejecutará el simulador.
Etiquetas:test_runner
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
valor predeterminado: consulta la descripción-
Versión de iOS que se ejecutará en el simulador cuando se ejecute o pruebe. Se ignora para las reglas de ios_test si se especifica un dispositivo objetivo en la regla.
Etiquetas: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">
predeterminado: "auto"-
Es la cantidad máxima de trabajos de prueba locales que se pueden ejecutar de forma simultánea. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), seguido de forma opcional por una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". El valor 0 significa que los recursos locales limitarán la cantidad de trabajos de prueba locales que se ejecutarán de forma simultánea. Establecer este valor en un número mayor que el valor de --jobs no tiene ningún efecto.
Etiquetas:execution
- Se acumulan los usos múltiples de
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
- Especifica la cantidad de veces que se ejecutará cada prueba. Si alguno de esos intentos falla por algún motivo, se considera que toda la prueba falló. Normalmente, el valor especificado es solo un número entero. Ejemplo: --runs_per_test=3 ejecutará todas las pruebas 3 veces. Sintaxis alternativa: regex_filter@runs_per_test. Aquí runs_per_test representa un valor entero y regex_filter representa una lista de patrones de expresiones regulares de inclusión y exclusión (consulta también --instrumentation_filter). Ejemplo: --runs_per_test=//foo/.*,-//foo/bar/.*@3 ejecuta todas las pruebas en //foo/ excepto las que se encuentran en foo/bar tres veces. Esta opción se puede pasar varias veces. Tiene prioridad el argumento que se pasó más recientemente y que coincide. Si no hay coincidencias, la prueba solo se ejecuta una vez.
- Se acumulan los usos múltiples de
--test_env=<a 'name=value' assignment with an optional value part>
-
Especifica variables de entorno adicionales que se insertarán en el entorno del ejecutor de pruebas. Las variables se pueden especificar por nombre, en cuyo caso su valor se leerá del entorno del cliente de Bazel, o por el par nombre=valor. Esta opción se puede usar varias veces para especificar varias variables. Solo se usa con el comando "bazel test".
Etiquetas:test_runner
--[no]test_keep_going
predeterminado: "true"-
Cuando se inhabilita, cualquier prueba que no pase hará que se detenga toda la compilación. De forma predeterminada, se ejecutan todas las pruebas, incluso si algunas no se aprueban.
Etiquetas:execution
- Valor predeterminado de
--test_strategy=<a string>
: "" -
Especifica qué estrategia se debe usar cuando se ejecutan pruebas.
Etiquetas:execution
- Valor predeterminado de
--test_timeout=<a single integer or comma-separated list of 4 integers>
: "-1" - Anula los valores predeterminados de tiempo de espera de la prueba (en segundos). Si se especifica un solo valor de número entero positivo, se anularán todas las categorías. Si se especifican 4 números enteros separados por comas, se anularán los tiempos de espera para corto, moderado, largo y eterno (en ese orden). En cualquiera de las dos formas, un valor de -1 le indica a Blaze que use sus tiempos de espera predeterminados para esa categoría.
--test_tmpdir=<a path>
valor predeterminado: consulta la descripción- Especifica el directorio temporal base que usará "bazel test".
--tvos_simulator_device=<a string>
valor predeterminado: consulta la descripción-
El dispositivo que se simulará cuando se ejecute una aplicación para tvOS en el simulador, p.ej., "Apple TV 1080p". Puedes obtener una lista de dispositivos ejecutando "xcrun simctl list devicetypes" en la máquina en la que se ejecutará el simulador.
Etiquetas:test_runner
--tvos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
valor predeterminado: consulta la descripción-
Es la versión de tvOS que se ejecutará en el simulador cuando se ejecute o pruebe.
Etiquetas:test_runner
--watchos_simulator_device=<a string>
valor predeterminado: consulta la descripción-
El dispositivo que se simulará cuando se ejecute una aplicación para watchOS en el simulador, p.ej., "Apple Watch - 38mm". Puedes obtener una lista de dispositivos ejecutando "xcrun simctl list devicetypes" en la máquina en la que se ejecutará el simulador.
Etiquetas:test_runner
--watchos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
valor predeterminado: consulta la descripción-
Versión de watchOS que se ejecutará en el simulador cuando se ejecute o pruebe.
Etiquetas:test_runner
--[no]zip_undeclared_test_outputs
predeterminado: "true"-
Si es verdadero, los resultados de las pruebas no declarados se archivarán en un archivo ZIP.
Etiquetas:test_runner
- Opciones que activan optimizaciones del tiempo de compilación:
--[no]collapse_duplicate_defines
predeterminado: "false"-
Cuando está habilitado, los --defines redundantes se quitarán al principio de la compilación. Esto evita la pérdida innecesaria de la caché de análisis para ciertos tipos de compilaciones equivalentes.
Etiquetas:loading_and_analysis
,loses_incremental_state
--[no]experimental_filter_library_jar_with_program_jar
predeterminado: "false"-
Filtra el ProgramJar de ProGuard para quitar las clases que también estén presentes en el LibraryJar.
Etiquetas:action_command_lines
--[no]experimental_inmemory_dotd_files
predeterminado: "true"-
Si está habilitado, los archivos .d de C++ se pasarán por la memoria directamente desde los nodos de compilación remotos en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_inmemory_jdeps_files
predeterminado: "true"-
Si está habilitado, los archivos de dependencia (.jdeps) generados a partir de las compilaciones de Java se pasarán a través de la memoria directamente desde los nodos de compilación remotos en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_objc_include_scanning
predeterminado: "false"-
Indica si se debe realizar el análisis de inclusión para Objective-C/C++.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
--[no]experimental_parse_headers_skipped_if_corresponding_srcs_found
predeterminado: "false"-
Si está habilitada, la función parse_headers no crea una acción de compilación de encabezado separada si se encuentra una fuente con el mismo nombre base en el mismo destino.
Etiquetas:loading_and_analysis
,affects_outputs
--[no]experimental_retain_test_configuration_across_testonly
predeterminado: "false"-
Cuando está habilitado, --trim_test_configuration no recortará la configuración de prueba para las reglas marcadas como testonly=1. Esto tiene como objetivo reducir los problemas de conflicto de acciones cuando las reglas que no son de prueba dependen de las reglas cc_test. No tiene efecto si --trim_test_configuration es falso.
Etiquetas:loading_and_analysis
,loses_incremental_state
--[no]experimental_starlark_cc_import
predeterminado: "false"-
Si está habilitado, se puede usar la versión de Starlark de cc_import.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_unsupported_and_brittle_include_scanning
predeterminado: "false"-
Indica si se deben reducir las entradas a la compilación de C/C++ analizando las líneas #include de los archivos de entrada. Esto puede mejorar el rendimiento y la incrementalidad, ya que disminuye el tamaño de los árboles de entrada de compilación. Sin embargo, también puede interrumpir las compilaciones porque el analizador de inclusión no implementa por completo la semántica del preprocesador de C. En particular, no comprende las directivas #include dinámicas y omite la lógica condicional del preprocesador. Úsala bajo tu propia responsabilidad. Se cerrarán todos los problemas relacionados con este parámetro que se registren.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
--[no]incremental_dexing
predeterminado: "true"-
Realiza la mayor parte del trabajo de dexing por separado para cada archivo Jar.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]objc_use_dotd_pruning
predeterminado: "true"-
Si se configura, los archivos .d que emite clang se usarán para reducir el conjunto de entradas que se pasan a las compilaciones de objc.
Etiquetas:changes_inputs
,loading_and_analysis
--[no]process_headers_in_dependencies
predeterminado: "false"-
Cuando se compila un destino //a:a, se procesan los encabezados en todos los destinos de los que depende //a:a (si el procesamiento de encabezados está habilitado para la cadena de herramientas).
Etiquetas:execution
--[no]trim_test_configuration
predeterminado: "true"-
Cuando se habilita, las opciones relacionadas con las pruebas se borrarán debajo del nivel superior de la compilación. Cuando esta marca está activa, las pruebas no se pueden compilar como dependencias de reglas que no son de prueba, pero los cambios en las opciones relacionadas con las pruebas no harán que se vuelvan a analizar las reglas que no son de prueba.
Etiquetas:loading_and_analysis
,loses_incremental_state
--[no]use_singlejar_apkbuilder
predeterminado: "true"-
Esta opción está obsoleta. Ahora es una operación nula y se quitará pronto.
Etiquetas:loading_and_analysis
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]announce
predeterminado: "false"-
Obsoleto. No se realiza ninguna operación.
Etiquetas:affects_outputs
--[no]experimental_bep_target_summary
predeterminado: "false"- Indica si se publicarán eventos de TargetSummary.
--[no]experimental_build_event_expand_filesets
predeterminado: "false"-
Si es verdadero, expande los archivos Filesets en el BEP cuando se presenten los archivos de salida.
Etiquetas:affects_outputs
--[no]experimental_build_event_fully_resolve_fileset_symlinks
predeterminado: "false"-
Si es verdadero, resuelve por completo los vínculos simbólicos relativos de Fileset en el BEP cuando se presentan los archivos de salida. Requiere --experimental_build_event_expand_filesets.
Etiquetas:affects_outputs
- Valor predeterminado de
--experimental_build_event_upload_max_retries=<an integer>
: "4" -
Es la cantidad máxima de veces que Bazel debe reintentar subir un evento de compilación.
Etiquetas:bazel_internal_configuration
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
predeterminado: "1s"-
Es la demora inicial y mínima para los reintentos de retirada exponencial cuando falla la carga del BEP. (exponente: 1.6)
Etiquetas:bazel_internal_configuration
--experimental_build_event_upload_strategy=<a string>
valor predeterminado: consulta la descripción-
Selecciona cómo subir los artefactos a los que se hace referencia en el protocolo del evento de compilación.
Etiquetas:affects_outputs
--[no]experimental_materialize_param_files_directly
predeterminado: "false"-
Si materializas archivos de parámetros, hazlo con escrituras directas en el disco.
Etiquetas:execution
--[no]experimental_stream_log_file_uploads
predeterminado: "false"-
Transmite las cargas de archivos de registro directamente al almacenamiento remoto en lugar de escribirlas en el disco.
Etiquetas:affects_outputs
--explain=<a path>
valor predeterminado: consulta la descripción-
Hace que el sistema de compilación explique cada paso ejecutado de la compilación. La explicación se escribe en el archivo de registro especificado.
Etiquetas:affects_outputs
--[no]legacy_important_outputs
predeterminado: "true"-
Úsalo para suprimir la generación del campo legacy important_outputs en el evento TargetComplete. Los important_outputs son necesarios para la integración de Bazel en ResultStore.
Etiquetas:affects_outputs
--[no]materialize_param_files
predeterminado: "false"-
Escribe archivos de parámetros intermedios en el árbol de salida, incluso cuando se usa la ejecución de acciones remotas. Es útil cuando se depuran acciones. Esto se infiere de --subcommands y --verbose_failures.
Etiquetas:execution
--max_config_changes_to_show=<an integer>
valor predeterminado: "3"-
Cuando se descarta la caché de análisis debido a un cambio en las opciones de compilación, se muestran hasta la cantidad determinada de nombres de opciones modificadas. Si el número proporcionado es -1, se mostrarán todas las opciones modificadas.
Etiquetas:terminal_output
- Valor predeterminado de
--max_test_output_bytes=<an integer>
: "-1" -
Especifica el tamaño máximo por registro de prueba que se puede emitir cuando --test_output es "errors" o "all". Es útil para evitar que el resultado se vea abrumado por un resultado de prueba demasiado ruidoso. El encabezado de la prueba se incluye en el tamaño del registro. Los valores negativos implican que no hay límite. El resultado es todo o nada.
Etiquetas:test_runner
,terminal_output
,execution
--output_filter=<a valid Java regular expression>
valor predeterminado: consulta la descripción-
Solo muestra advertencias para las reglas con un nombre que coincide con la expresión regular proporcionada.
Etiquetas:affects_outputs
--progress_report_interval=<an integer in 0-3600 range>
predeterminado: "0"-
Cantidad de segundos entre los informes sobre los trabajos que aún se están ejecutando. El valor predeterminado 0 significa que el primer informe se imprimirá después de 10 segundos, luego de 30 segundos y, después de eso, el progreso se informará una vez por minuto. Cuando se habilita --curses, el progreso se informa cada segundo.
Etiquetas:affects_outputs
--show_result=<an integer>
valor predeterminado: "1"-
Muestra los resultados de la compilación. Para cada destino, indica si se actualizó o no y, si es así, proporciona una lista de los archivos de salida que se compilaron. Los archivos impresos son cadenas convenientes para copiar y pegar en el shell y ejecutarlos.
Esta opción requiere un argumento de número entero, que es la cantidad límite de objetivos por encima de la cual no se imprime la información de los resultados. Por lo tanto, el cero hace que se suprima el mensaje y MAX_INT hace que siempre se imprima el resultado. El valor predeterminado es uno.
Etiquetas:affects_outputs
--[no]subcommands
[-s
] predeterminado: "false"-
Muestra los subcomandos que se ejecutaron durante una compilación. Marcas relacionadas: --execution_log_json_file, --execution_log_binary_file (para registrar subcomandos en un archivo con un formato compatible con herramientas).
Etiquetas:terminal_output
--test_output=<summary, errors, all or streamed>
predeterminado: "summary"-
Especifica el modo de salida deseado. Los valores válidos son "summary" para generar solo el resumen del estado de la prueba, "errors" para imprimir también los registros de las pruebas fallidas, "all" para imprimir los registros de todas las pruebas y "streamed" para generar los registros de todas las pruebas en tiempo real (esto forzará la ejecución de las pruebas de forma local una a la vez, independientemente del valor de --test_strategy).
Etiquetas:test_runner
,terminal_output
,execution
- Valor predeterminado de
--test_summary=<short, terse, detailed, none or testcase>
: "short" -
Especifica el formato deseado del resumen de la prueba. Los valores válidos son "short" para imprimir información solo sobre las pruebas ejecutadas, "terse" para imprimir información solo sobre las pruebas fallidas que se ejecutaron, "detailed" para imprimir información detallada sobre los casos de prueba fallidos, "testcase" para imprimir un resumen en la resolución del caso de prueba, no imprimir información detallada sobre los casos de prueba fallidos y "none" para omitir el resumen.
Etiquetas:terminal_output
- Valor predeterminado de
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "-.*" -
Imprime información de depuración durante la resolución de la cadena de herramientas. La marca toma una regex, que se verifica con los tipos de cadenas de herramientas y los objetivos específicos para ver cuáles depurar. Se pueden separar varias expresiones regulares con comas y, luego, se verifica cada una por separado. Nota: El resultado de esta marca es muy complejo y es probable que solo sea útil para los expertos en la resolución de cadenas de herramientas.
Etiquetas:terminal_output
--[no]verbose_explanations
predeterminado: "false"-
Aumenta el nivel de detalle de las explicaciones emitidas si se habilita --explain. No tiene efecto si no se habilita --explain.
Etiquetas:affects_outputs
--[no]verbose_failures
predeterminado: "false"-
Si falla un comando, imprime la línea de comandos completa.
Etiquetas:terminal_output
- Opciones que especifican o alteran una entrada genérica para un comando de Bazel que no se incluye en otras categorías.:
- Se acumulan los usos múltiples de
--aspects_parameters=<a 'name=value' assignment>
-
Especifica los valores de los parámetros de aspectos de la línea de comandos. Cada valor de parámetro se especifica a través de <param_name>=<param_value>, por ejemplo, "my_param=my_val", donde "my_param" es un parámetro de algún aspecto en la lista --aspects o es requerido por un aspecto en la lista. Esta opción se puede usar varias veces. Sin embargo, no se permite asignar valores al mismo parámetro más de una vez.
Etiquetas:loading_and_analysis
- Se acumulan los usos múltiples de
--flag_alias=<a 'name=value' flag alias>
-
Establece un nombre abreviado para una marca de Starlark. Toma un solo par clave-valor en el formato "<clave>=<valor>" como argumento.
Etiquetas:changes_inputs
--[no]incompatible_default_to_explicit_init_py
predeterminado: "false"-
Esta marca cambia el comportamiento predeterminado para que los archivos __init__.py ya no se creen automáticamente en los archivos ejecutables de los destinos de Python. Específicamente, cuando un destino py_binary o py_test tiene legacy_create_init establecido en "auto" (el valor predeterminado), se trata como falso si y solo si se establece esta marca. Consulta https://github.com/bazelbuild/bazel/issues/10076.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_py2_outputs_are_suffixed
predeterminado: "true"-
Si es verdadero, los destinos compilados en la configuración de Python 2 aparecerán en una raíz de salida que incluye el sufijo "-py2", mientras que los destinos compilados para Python 3 aparecerán en una raíz sin sufijo relacionado con Python. Esto significa que el vínculo simbólico de conveniencia `bazel-bin` apuntará a destinos de Python 3 en lugar de Python 2. Si habilitas esta opción, también se recomienda habilitar `--incompatible_py3_is_default`.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_py3_is_default
predeterminado: "true"-
Si es verdadero, los destinos `py_binary` y `py_test` que no configuren su atributo `python_version` (o `default_python_version`) se establecerán de forma predeterminada en PY3 en lugar de PY2. Si estableces esta marca, también se recomienda establecer `--incompatible_py2_outputs_are_suffixed`.
Etiquetas:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_use_python_toolchains
predeterminado: "true"-
Si se establece como verdadero, las reglas ejecutables de Python nativo usarán el entorno de ejecución de Python especificado por la cadena de herramientas de Python, en lugar del entorno de ejecución proporcionado por marcas heredadas como --python_top.
Etiquetas:loading_and_analysis
,incompatible_change
--python_version=<PY2 or PY3>
valor predeterminado: consulta la descripción-
Modo de versión principal de Python, ya sea "PY2" o "PY3". Ten en cuenta que los objetivos "py_binary" y "py_test" anulan este parámetro (incluso si no especifican una versión de forma explícita), por lo que, por lo general, no hay muchos motivos para proporcionar esta marca.
Etiquetas:loading_and_analysis
,affects_outputs
,explicit_in_output_path
- Valor predeterminado de
--target_pattern_file=<a string>
: "" -
Si se configura, la compilación leerá los patrones del archivo que se menciona aquí, en lugar de hacerlo desde la línea de comandos. Es un error especificar un archivo aquí y patrones de línea de comandos.
Etiquetas:changes_inputs
- Opciones de almacenamiento en caché y ejecución remotos:
--experimental_remote_cache_eviction_retries=<an integer>
predeterminado: "0"-
Es la cantidad máxima de intentos para volver a intentar la compilación si se produjo un error de expulsión de la caché remota. Un valor distinto de cero establecerá implícitamente --incompatible_remote_use_new_exit_code_for_lost_inputs como verdadero. Se generará un nuevo ID de invocación para cada intento. Si generas un ID de invocación y se lo proporcionas a Bazel con --invocation_id, no debes usar esta marca. En su lugar, establece la marca --incompatible_remote_use_new_exit_code_for_lost_inputs y verifica el código de salida 39.
Etiquetas:execution
- Opciones varias, no clasificadas de otra manera.:
--[no]allow_analysis_cache_discard
predeterminado: "true"-
Si se descarta la caché de análisis debido a un cambio en el sistema de compilación, configurar esta opción como falsa hará que Bazel salga en lugar de continuar con la compilación. Esta opción no tiene ningún efecto cuando también se establece "discard_analysis_cache".
Etiquetas:eagerness_to_exit
--[no]build_manual_tests
predeterminado: "false"- Obliga a compilar los destinos de prueba etiquetados como "manuales". Las pruebas "manuales" se excluyen del procesamiento. Esta opción obliga a que se compilen (pero no se ejecuten).
- Valor predeterminado de
--build_tag_filters=<comma-separated list of options>
: "" - Especifica una lista de etiquetas separadas por comas. Cada etiqueta puede ir precedida de un signo "-" para especificar las etiquetas excluidas. Solo se compilarán los destinos que contengan al menos una etiqueta incluida y no contengan ninguna etiqueta excluida. Esta opción no afecta el conjunto de pruebas que se ejecutan con el comando "test"; esas pruebas se rigen por las opciones de filtrado de pruebas, por ejemplo, "--test_tag_filters".
--[no]build_tests_only
predeterminado: "false"- Si se especifica, solo se compilarán las reglas *_test y test_suite, y se ignorarán otros destinos especificados en la línea de comandos. De forma predeterminada, se compilará todo lo que se solicitó.
--[no]cache_test_results
[-t
] default: "auto"- Si se configura como "auto", Bazel vuelve a ejecutar una prueba solo si se cumplen las siguientes condiciones: (1) Bazel detecta cambios en la prueba o sus dependencias, (2) la prueba se marca como externa, (3) se solicitaron varias ejecuciones de prueba con --runs_per_test o(4) la prueba falló anteriormente. Si se configura como “sí”, Bazel almacena en caché todos los resultados de las pruebas, excepto las que se marcan como externas. Si se configura como "no", Bazel no almacena en caché ningún resultado de la prueba.
--[no]compile_one_dependency
predeterminado: "false"- Compila una sola dependencia de los archivos de argumentos. Esto es útil para verificar la sintaxis de los archivos fuente en los IDE, por ejemplo, recompilando un solo destino que depende del archivo fuente para detectar errores lo antes posible en el ciclo de edición, compilación y prueba. Este argumento afecta la forma en que se interpretan todos los argumentos que no son marcas. En lugar de ser destinos para compilar, son nombres de archivos fuente. Para cada nombre de archivo fuente, se compilará un destino arbitrario que dependa de él.
- Valor predeterminado de
--deleted_packages=<comma-separated list of package names>
: "" - Es una lista separada por comas de los nombres de los paquetes que el sistema de compilación considerará inexistentes, incluso si son visibles en algún lugar de la ruta de acceso del paquete. Usa esta opción cuando borres un subpaquete "x/y" de un paquete existente "x". Por ejemplo, después de borrar x/y/BUILD en tu cliente, es posible que el sistema de compilación muestre un error si encuentra la etiqueta "//x:y/z" si otra entrada de package_path aún la proporciona. Si especificas --deleted_packages x/y, se evita este problema.
--[no]discard_analysis_cache
predeterminado: "false"- Descarta la caché de análisis inmediatamente después de que finalice la fase de análisis. Reduce el uso de memoria en un 10%, pero hace que las compilaciones incrementales posteriores sean más lentas.
--execution_log_binary_file=<a path>
valor predeterminado: consulta la descripción- Registra los comandos spawn ejecutados en este archivo como protos de Spawn delimitados, según src/main/protobuf/spawn.proto. Primero, el registro se escribe sin ordenar y, luego, al final de la invocación, se ordena de forma estable (puede requerir mucha CPU y memoria). Marcas relacionadas: --execution_log_json_file (formato json de texto ordenado), --experimental_execution_log_file (formato binario protobuf no ordenado), --subcommands (para mostrar subcomandos en el resultado de la terminal).
--execution_log_json_file=<a path>
valor predeterminado: consulta la descripción- Registra los elementos Spawn ejecutados en este archivo como una representación JSON de los protos de Spawn delimitados, según src/main/protobuf/spawn.proto. Primero, el registro se escribe sin ordenar y, luego, al final de la invocación, se ordena de forma estable (puede requerir mucha CPU y memoria). Marcas relacionadas: --execution_log_binary_file (formato binario de protobuf ordenado), --experimental_execution_log_file (formato binario de protobuf no ordenado), --subcommands (para mostrar subcomandos en el resultado de la terminal).
--[no]execution_log_sort
predeterminado: "true"- Indica si se debe ordenar el registro de ejecución. Se establece en falso para mejorar el rendimiento de la memoria, a costa de generar el registro en orden no determinístico.
--[no]expand_test_suites
predeterminado: "true"-
Expande los destinos de test_suite en sus pruebas constituyentes antes del análisis. Cuando esta marca está activada (opción predeterminada), los patrones de segmentación negativos se aplicarán a las pruebas que pertenecen al conjunto de pruebas. De lo contrario, no se aplicarán. Desactivar esta marca es útil cuando se aplican aspectos de nivel superior en la línea de comandos, ya que, de esta manera, se pueden analizar los destinos de test_suite.
Etiquetas:loading_and_analysis
--[no]experimental_cancel_concurrent_tests
predeterminado: "false"-
Si es verdadero, Blaze cancelará las pruebas que se ejecuten de forma simultánea en la primera ejecución exitosa. Esto solo es útil en combinación con --runs_per_test_detects_flakes.
Etiquetas:affects_outputs
,loading_and_analysis
--experimental_execution_log_file=<a path>
valor predeterminado: consulta la descripción- Registra los comandos spawn ejecutados en este archivo como protos de Spawn delimitados, según src/main/protobuf/spawn.proto. Este archivo se escribe en el orden de ejecución de los Spawns. Marcas relacionadas: --execution_log_binary_file (formato binario ordenado de protobuf), --execution_log_json_file (formato JSON de texto ordenado), --subcommands (para mostrar subcomandos en la salida de la terminal).
--[no]experimental_execution_log_spawn_metrics
predeterminado: "false"- Incluye métricas de generación en el registro de generaciones ejecutadas.
- Valor predeterminado de
--experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "" - Dejó de estar disponible y se reemplazó por aspectos. Es el conjunto de filtros de los objetivos para los que se programarán extra_actions.
--[no]experimental_extra_action_top_level_only
predeterminado: "false"- Dejó de estar disponible y se reemplazó por aspectos. Solo programa extra_actions para los destinos de nivel superior.
--[no]experimental_fetch_all_coverage_outputs
predeterminado: "false"-
Si es verdadero, Bazel recupera el directorio completo de datos de cobertura para cada prueba durante una ejecución de cobertura.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_generate_llvm_lcov
predeterminado: "false"-
Si es verdadero, la cobertura de clang generará un informe de LCOV.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_j2objc_header_map
predeterminado: "true"- Indica si se debe generar el mapa de encabezado de J2ObjC en paralelo con la transpilación de J2ObjC.
--[no]experimental_j2objc_shorter_header_path
predeterminado: "false"-
Indica si se debe generar con una ruta de encabezado más corta (usa "_ios" en lugar de "_j2objc").
Etiquetas:affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
predeterminado: "javabuilder"- Habilita rutas de acceso de clase reducidas para las compilaciones de Java.
--[no]experimental_limit_android_lint_to_android_constrained_java
predeterminado: "false"-
Limita --experimental_run_android_lint_on_java_rules a las bibliotecas compatibles con Android.
Etiquetas:affects_outputs
--[no]experimental_prioritize_local_actions
predeterminado: "true"-
Si se configura, las acciones que solo se pueden ejecutar de forma local tienen la primera oportunidad de adquirir recursos, los trabajadores que se ejecutan de forma dinámica tienen la segunda oportunidad y las acciones independientes que se ejecutan de forma dinámica son las últimas.
Etiquetas:execution
--[no]experimental_run_android_lint_on_java_rules
predeterminado: "false"-
Indica si se deben validar las fuentes java_*.
Etiquetas:affects_outputs
--[no]explicit_java_test_deps
predeterminado: "false"- Especifica de forma explícita una dependencia de JUnit o Hamcrest en un java_test en lugar de obtenerla accidentalmente de las dependencias de TestRunner. Por el momento, solo funciona para Bazel.
--host_java_launcher=<a build target label>
valor predeterminado: consulta la descripción- Es el launcher de Java que usan las herramientas que se ejecutan durante una compilación.
- Se acumulan los usos múltiples de
--host_javacopt=<a string>
- Opciones adicionales para pasar a javac cuando se compilan herramientas que se ejecutan durante una compilación.
- Se acumulan los usos múltiples de
--host_jvmopt=<a string>
- Opciones adicionales para pasar a la VM de Java cuando se compilan herramientas que se ejecutan durante la compilación. Estas opciones se agregarán a las opciones de inicio de la VM de cada destino java_binary.
--[no]incompatible_check_sharding_support
predeterminado: "false"-
Si es verdadero, Bazel fallará una prueba fragmentada si el ejecutor de pruebas no indica que admite el fragmentado tocando el archivo en la ruta de TEST_SHARD_STATUS_FILE. Si es falso, un ejecutor de pruebas que no admite la fragmentación hará que todas las pruebas se ejecuten en cada fragmento.
Etiquetas:incompatible_change
--[no]incompatible_exclusive_test_sandboxed
predeterminado: "false"-
Si es verdadero, las pruebas exclusivas se ejecutarán con la estrategia de zona de pruebas. Agrega la etiqueta "local" para forzar una ejecución de prueba exclusiva de forma local.
Etiquetas:incompatible_change
--[no]incompatible_strict_action_env
predeterminado: "false"-
Si es verdadero, Bazel usa un entorno con un valor estático para PATH y no hereda LD_LIBRARY_PATH. Usa --action_env=ENV_VARIABLE si deseas heredar variables de entorno específicas del cliente, pero ten en cuenta que esto puede impedir el almacenamiento en caché entre usuarios si se usa una caché compartida.
Etiquetas:loading_and_analysis
,incompatible_change
- Se acumulan los usos múltiples de
--j2objc_translation_flags=<comma-separated list of options>
- Opciones adicionales para pasar a la herramienta J2ObjC.
--java_debug
-
Hace que la máquina virtual de Java de una prueba de Java espere una conexión de un depurador compatible con JDWP (como jdb) antes de iniciar la prueba. Implica -test_output=streamed.
Se expande a:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
--[no]java_deps
predeterminado: "true"- Genera información de dependencia (por ahora, classpath de tiempo de compilación) por destino de Java.
--[no]java_header_compilation
predeterminado: "true"- Compila archivos .ijar directamente desde la fuente.
--java_language_version=<a string>
predeterminado: "8"- La versión del lenguaje Java
--java_launcher=<a build target label>
valor predeterminado: consulta la descripción- Es el lanzador de Java que se usará cuando se compilen archivos binarios de Java. Si esta marca se establece en la cadena vacía, se usa el iniciador del JDK. El atributo "launcher" anula esta marca.
--java_runtime_version=<a string>
valor predeterminado: "local_jdk"- La versión del entorno de ejecución de Java
- Se acumulan los usos múltiples de
--javacopt=<a string>
- Opciones adicionales para pasar a javac.
- Se acumulan los usos múltiples de
--jvmopt=<a string>
- Opciones adicionales para pasar a la JVM de Java. Estas opciones se agregarán a las opciones de inicio de la VM de cada destino java_binary.
--legacy_main_dex_list_generator=<a build target label>
valor predeterminado: consulta la descripción- Especifica un archivo binario que se usará para generar la lista de clases que deben estar en el archivo dex principal cuando se compile multidex heredado.
--local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>
predeterminado: "HOST_CPUS"- Establece de forma explícita la cantidad total de núcleos de CPU locales disponibles para que Bazel los use en las acciones de compilación que se ejecutan de forma local. Toma un número entero o "HOST_CPUS", seguido de forma opcional por [-|*]<float> (p. ej., HOST_CPUS*.5 para usar la mitad de los núcleos de CPU disponibles).De forma predeterminada, ("HOST_CPUS"), Bazel consultará la configuración del sistema para estimar la cantidad de núcleos de CPU disponibles.
- Se acumulan los usos múltiples de
--local_extra_resources=<a named float, 'name=value'>
- Establece la cantidad de recursos adicionales disponibles para Bazel. Toma un par de cadena y número de punto flotante. Se puede usar varias veces para especificar varios tipos de recursos adicionales. Bazel limitará las acciones que se ejecutan de forma simultánea según los recursos adicionales disponibles y los recursos adicionales necesarios. Las pruebas pueden declarar la cantidad de recursos adicionales que necesitan con una etiqueta del formato "resources:<resoucename>:<amount>". Con esta marca, no se pueden establecer la CPU, la RAM ni los recursos disponibles.
--local_ram_resources=<an integer, or "HOST_RAM", optionally followed by [-|*]<float>.>
predeterminado: "HOST_RAM*.67"- Establece de forma explícita la cantidad total de RAM del host local (en MB) disponible para que Bazel la use en las acciones de compilación que se ejecutan de forma local. Toma un número entero o "HOST_RAM", seguido de forma opcional por [-|*]<float> (p. ej., HOST_RAM*.5 para usar la mitad de la RAM disponible). De forma predeterminada, ("HOST_RAM*.67"), Bazel consultará la configuración del sistema para estimar la cantidad de RAM disponible y usará el 67% de ella.
--local_termination_grace_seconds=<an integer>
predeterminado: "15"- Tiempo de espera entre la finalización de un proceso local debido a un tiempo de espera agotado y el cierre forzado.
--package_path=<colon-separated list of options>
valor predeterminado: "%workspace%"- Es una lista separada por dos puntos de las ubicaciones en las que se buscarán paquetes. Los elementos que comienzan con "%workspace%" son relativos al espacio de trabajo que los contiene. Si se omite o está vacío, el valor predeterminado es el resultado de "bazel info default-package-path".
- Se acumulan los usos múltiples de
--plugin=<a build target label>
- Son los complementos que se usarán en la compilación. Actualmente, funciona con java_plugin.
--proguard_top=<a build target label>
valor predeterminado: consulta la descripción- Especifica qué versión de ProGuard se usará para quitar código cuando se compile un archivo binario de Java.
--proto_compiler=<a build target label>
default: "@bazel_tools//tools/proto:protoc"-
Es la etiqueta del compilador de .proto.
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
default: "@bazel_tools//tools/proto:cc_toolchain"-
Etiqueta de proto_lang_toolchain() que describe cómo compilar protos de C++
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
valor predeterminado: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"-
Etiqueta de proto_lang_toolchain() que describe cómo compilar protos de j2objc
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
default: "@bazel_tools//tools/proto:java_toolchain"-
Etiqueta de proto_lang_toolchain() que describe cómo compilar protos de Java
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
default: "@bazel_tools//tools/proto:javalite_toolchain"-
Etiqueta de proto_lang_toolchain() que describe cómo compilar protos de JavaLite
Etiquetas:affects_outputs
,loading_and_analysis
- Se acumulan los usos múltiples de
--protocopt=<a string>
-
Opciones adicionales para pasar al compilador de protobuf.
Etiquetas:affects_outputs
--[no]runs_per_test_detects_flakes
predeterminado: "false"- Si es verdadero, cualquier fragmento en el que se apruebe al menos una ejecución o intento y falle al menos una ejecución o intento obtendrá el estado FLAKY.
--shell_executable=<a path>
valor predeterminado: consulta la descripción-
Ruta de acceso absoluta al ejecutable del shell que Bazel debe usar. Si no se configura, pero la variable de entorno BAZEL_SH se establece en la primera invocación de Bazel (que inicia un servidor de Bazel), Bazel la usa. Si no se establece ninguno, Bazel usa una ruta de acceso predeterminada codificada de forma rígida según el sistema operativo en el que se ejecuta (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, todos los demás: /bin/bash). Ten en cuenta que usar un shell que no sea compatible con bash puede provocar fallas en la compilación o en el tiempo de ejecución de los archivos binarios generados.
Etiquetas:loading_and_analysis
--[no]show_loading_progress
predeterminado: "true"- Si está habilitado, hace que Bazel imprima mensajes de "Loading package:".
- Se acumulan los usos múltiples de
--test_arg=<a string>
- Especifica argumentos y opciones adicionales que se deben pasar al ejecutable de la prueba. Se puede usar varias veces para especificar varios argumentos. Si se ejecutan varias pruebas, cada una de ellas recibirá argumentos idénticos. Solo se usa con el comando "bazel test".
--test_filter=<a string>
valor predeterminado: consulta la descripción- Especifica un filtro para reenviar al framework de pruebas. Se usa para limitar las pruebas que se ejecutan. Ten en cuenta que esto no afecta los destinos que se compilan.
- Valor predeterminado de
--test_lang_filters=<comma-separated list of options>
: "" - Especifica una lista de idiomas de prueba separados por comas. Cada idioma puede ir precedido de un guion (“-”) para especificar los idiomas excluidos. Solo se encontrarán los objetivos de prueba que estén escritos en los idiomas especificados. El nombre que se usa para cada idioma debe ser el mismo que el prefijo de idioma en la regla *_test, p.ej., uno de "cc", "java", "py", etcétera. Esta opción afecta el comportamiento de --build_tests_only y el comando de prueba.
- Valor predeterminado de
--test_result_expiration=<an integer>
: "-1" - Esta opción está obsoleta y no tiene ningún efecto.
--[no]test_runner_fail_fast
predeterminado: "false"- Reenvía la opción de falla rápida al ejecutor de pruebas. El ejecutor de pruebas debe detener la ejecución ante el primer error.
--test_sharding_strategy=<explicit or disabled>
predeterminado: "explícito"- Especifica la estrategia para la división de pruebas: "explícita" para usar la división solo si el atributo de compilación "shard_count" está presente. "disabled" para no usar nunca la división de pruebas.
- Valor predeterminado de
--test_size_filters=<comma-separated list of values: small, medium, large or enormous>
: "" - Especifica una lista de tamaños de prueba separados por comas. Cada tamaño puede ir precedido de un guion "-" para especificar los tamaños excluidos. Solo se encontrarán aquellos objetivos de prueba que contengan al menos un tamaño incluido y no contengan ningún tamaño excluido. Esta opción afecta el comportamiento de --build_tests_only y el comando de prueba.
- Valor predeterminado de
--test_tag_filters=<comma-separated list of options>
: "" - Especifica una lista de etiquetas de prueba separadas por comas. Cada etiqueta puede ir precedida de un signo "-" para especificar las etiquetas excluidas. Solo se encontrarán aquellos destinos de prueba que contengan al menos una etiqueta incluida y no contengan ninguna etiqueta excluida. Esta opción afecta el comportamiento de --build_tests_only y el comando de prueba.
- Valor predeterminado de
--test_timeout_filters=<comma-separated list of values: short, moderate, long or eternal>
: "" - Especifica una lista de tiempos de espera de prueba separados por comas. Cada tiempo de espera puede ir precedido de un signo "-" para especificar los tiempos de espera excluidos. Solo se encontrarán aquellos destinos de prueba que contengan al menos un tiempo de espera incluido y no contengan ningún tiempo de espera excluido. Esta opción afecta el comportamiento de --build_tests_only y el comando de prueba.
--tool_java_language_version=<a string>
predeterminado: "8"- Versión del lenguaje Java que se usa para ejecutar las herramientas necesarias durante una compilación
--tool_java_runtime_version=<a string>
valor predeterminado: "remotejdk_11"- Versión del entorno de ejecución de Java que se usa para ejecutar herramientas durante la compilación
--[no]use_ijars
predeterminado: "true"- Si se habilita, esta opción hace que la compilación de Java use archivos .jar de interfaz. Esto generará una compilación incremental más rápida, pero los mensajes de error pueden ser diferentes.
Opciones de Canonicalize-flags
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan los usos múltiples de
--distdir=<a path>
-
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: "false"-
Si se configura, la caché del repositorio creará un vínculo físico al archivo en caso de acierto de caché, en lugar de copiarlo. Esto tiene como objetivo ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
predeterminado: "false"-
Si es verdadero, usa una cadena derivada de las URLs de las descargas del repositorio como canonical_id si no se especifica. Esto hace que un cambio en las URLs genere una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no provoquen que la caché oculte repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
predeterminado: "false"-
Si se configura, no se permite la descarga de repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark según este factor. De esta manera, los repositorios externos pueden funcionar en máquinas más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Ajusta todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
valor predeterminado: consulta la descripción-
Especifica la ubicación de la caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que controlan el resultado del comando:
--[no]canonicalize_policy
predeterminado: "false"-
Genera la política canónica después de la expansión y el filtrado. Para mantener la salida limpia, los argumentos de comando canonizados NO se mostrarán cuando esta opción se establezca como verdadera. Ten en cuenta que el comando especificado por --for_command afecta la política filtrada y, si no se especifica ninguno, el comando predeterminado es "build".
Etiquetas:affects_outputs
,terminal_output
--[no]show_warnings
predeterminado: "false"-
Advertencias del analizador de salida para el error estándar (p. ej., para opciones de marcas en conflicto)
Etiquetas:affects_outputs
,terminal_output
- Opciones que afectan la rigidez con la que Bazel aplica las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
- Valor predeterminado de
--experimental_repository_hash_file=<a string>
: "" -
Si no está vacío, especifica un archivo que contiene un valor resuelto, con el que se deben verificar los hashes del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan los usos múltiples de
--experimental_verify_repository_rules=<a string>
-
Si se proporciona un archivo con --experimental_repository_hash_file, se debe verificar la lista de reglas del repositorio para las que se debe verificar el hash del directorio de salida.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: "true"-
Sin operación
Etiquetas:no_op
,deprecated
,experimental
--[no]incompatible_config_setting_private_default_visibility
predeterminado: "false"-
Si incompatible_enforce_config_setting_visibility=false, esta es una operación nula. De lo contrario, si esta marca es falsa, cualquier config_setting sin un atributo de visibilidad explícito es //visibility:public. Si esta marca es verdadera, config_setting sigue la misma lógica de visibilidad que todas las demás reglas. Consulta https://github.com/bazelbuild/bazel/issues/12933.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
predeterminado: "true"-
Si es verdadero, se aplican las restricciones de visibilidad de config_setting. Si es falso, todos los config_setting son visibles para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones relacionadas con la salida y la semántica de Bzlmod:
- Se acumulan los usos múltiples de
--allow_yanked_versions=<a string>
-
Se especificaron las versiones del módulo en el formato "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran como retiradas en el registro del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones retiradas harán que falle la resolución. También puedes definir la versión anulada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivar el problema a una falla de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecta una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "warning"-
Verifica si las dependencias directas de `bazel_dep` declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivar el problema como una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el archivo MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
predeterminado: "off"-
Especifica cómo y si se debe usar el archivo de bloqueo. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "error" para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan los usos múltiples de
--override_module=<an equals-separated mapping of module name to path>
- Anula un módulo con una ruta local con el formato <nombre del módulo>=<ruta>. Si la ruta proporcionada es absoluta, se usará tal cual. Si la ruta proporcionada es relativa, será relativa al directorio de trabajo actual. Si la ruta de acceso proporcionada comienza con "%workspace%", es relativa a la raíz del espacio de trabajo, que es el resultado de "bazel info workspace".
- Se acumulan los usos múltiples de
--registry=<a string>
-
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: primero se buscarán los módulos en los registros anteriores y solo se recurrirá a los registros posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemónicas con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemónicas.
- Opciones que especifican o alteran una entrada genérica para un comando de Bazel que no se incluye en otras categorías:
- Valor predeterminado de
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
--for_command=<a string>
predeterminado: "build"-
Comando para el que se deben canonizar las opciones.
Etiquetas:affects_outputs
,terminal_output
- Valor predeterminado de
--invocation_policy=<a string>
: "" -
Aplica una política de invocación a las opciones que se deben canonizar.
Etiquetas:affects_outputs
,terminal_output
- Opciones de almacenamiento en caché y ejecución remotos:
--experimental_downloader_config=<a string>
valor predeterminado: consulta la descripción- Especifica un archivo para configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva (`allow`, `block` o `rewrite`) seguida de un nombre de host (para `allow` y `block`) o dos patrones, uno para la coincidencia y otro para usar como URL sustituta, con referencias inversas que comienzan con `$1`. Es posible que se proporcionen varias directivas `rewrite` para la misma URL y, en este caso, se devolverán varias URLs.
- Opciones varias, no clasificadas de otra manera:
- Valor predeterminado de
--deleted_packages=<comma-separated list of package names>
: "" - Es una lista separada por comas de los nombres de los paquetes que el sistema de compilación considerará inexistentes, incluso si son visibles en algún lugar de la ruta de acceso del paquete. Usa esta opción cuando borres un subpaquete "x/y" de un paquete existente "x". Por ejemplo, después de borrar x/y/BUILD en tu cliente, es posible que el sistema de compilación muestre un error si encuentra la etiqueta "//x:y/z" si otra entrada de package_path aún la proporciona. Si especificas --deleted_packages x/y, se evita este problema.
- Se acumulan los usos múltiples de
--override_repository=<an equals-separated mapping of repository name to path>
- Anula un repositorio con una ruta de acceso local con el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es absoluta, se usará tal cual. Si la ruta de acceso proporcionada es relativa, se relacionará con el directorio de trabajo actual. Si la ruta de acceso proporcionada comienza con "%workspace%", es relativa a la raíz del espacio de trabajo, que es el resultado de "bazel info workspace".
--package_path=<colon-separated list of options>
valor predeterminado: "%workspace%"- Es una lista separada por dos puntos de las ubicaciones en las que se buscarán paquetes. Los elementos que comienzan con "%workspace%" son relativos al espacio de trabajo que los contiene. Si se omite o está vacío, el valor predeterminado es el resultado de "bazel info default-package-path".
--[no]show_loading_progress
predeterminado: "true"- Si está habilitado, hace que Bazel imprima mensajes de "Loading package:".
Opciones de limpieza
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan los usos múltiples de
--distdir=<a path>
-
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: "false"-
Si se configura, la caché del repositorio creará un vínculo físico al archivo en caso de acierto de caché, en lugar de copiarlo. Esto tiene como objetivo ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
predeterminado: "false"-
Si es verdadero, usa una cadena derivada de las URLs de las descargas del repositorio como canonical_id si no se especifica. Esto hace que un cambio en las URLs genere una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no provoquen que la caché oculte repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
predeterminado: "false"-
Si se configura, no se permite la descarga de repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark según este factor. De esta manera, los repositorios externos pueden funcionar en máquinas más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Ajusta todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
valor predeterminado: consulta la descripción-
Especifica la ubicación de la caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que controlan el resultado del comando:
--[no]async
predeterminado: "false"-
Si es verdadero, la limpieza del resultado es asíncrona. Cuando se complete este comando, será seguro ejecutar comandos nuevos en el mismo cliente, aunque la eliminación continúe en segundo plano.
Etiquetas:host_machine_resource_optimizations
--[no]expunge
predeterminado: "false"-
Si es verdadero, clean quita todo el árbol de trabajo de esta instancia de Bazel, lo que incluye todos los archivos temporales y de salida de compilación creados por Bazel, y detiene el servidor de Bazel si se está ejecutando.
Etiquetas:host_machine_resource_optimizations
--expunge_async
-
Si se especifica, clean quita de forma asíncrona todo el árbol de trabajo de esta instancia de Bazel, lo que incluye todos los archivos temporales y de salida de compilación creados por Bazel, y detiene el servidor de Bazel si se está ejecutando. Cuando se complete este comando, será seguro ejecutar comandos nuevos en el mismo cliente, aunque la eliminación continúe en segundo plano.
Se expande a:
--expunge
--async
Etiquetas:host_machine_resource_optimizations
--[no]remove_all_convenience_symlinks
predeterminado: "false"-
Si es verdadero, se borrarán todos los vínculos simbólicos del espacio de trabajo que tengan el prefijo symlink_prefix. Sin esta marca, solo se limpian los vínculos simbólicos con los sufijos predefinidos.
Etiquetas:affects_outputs
- Opciones que afectan la rigidez con la que Bazel aplica las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
- Valor predeterminado de
--experimental_repository_hash_file=<a string>
: "" -
Si no está vacío, especifica un archivo que contiene un valor resuelto, con el que se deben verificar los hashes del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan los usos múltiples de
--experimental_verify_repository_rules=<a string>
-
Si se proporciona un archivo con --experimental_repository_hash_file, se debe verificar la lista de reglas del repositorio para las que se debe verificar el hash del directorio de salida.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: "true"-
No-op
Etiquetas:no_op
,deprecated
,experimental
- Opciones relacionadas con la salida y la semántica de Bzlmod:
- Se acumulan los usos múltiples de
--allow_yanked_versions=<a string>
-
Se especificaron las versiones del módulo en el formato "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran como retiradas en el registro del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones retiradas harán que falle la resolución. También puedes definir la versión anulada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivar el problema a una falla de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecta una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "warning"-
Verifica si las dependencias directas de `bazel_dep` declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivar el problema como una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el archivo MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
predeterminado: "off"-
Especifica cómo y si se debe usar el archivo de bloqueo. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "error" para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan los usos múltiples de
--override_module=<an equals-separated mapping of module name to path>
- Anula un módulo con una ruta local con el formato <nombre del módulo>=<ruta>. Si la ruta proporcionada es absoluta, se usará tal cual. Si la ruta proporcionada es relativa, será relativa al directorio de trabajo actual. Si la ruta de acceso proporcionada comienza con "%workspace%", es relativa a la raíz del espacio de trabajo, que es el resultado de "bazel info workspace".
- Se acumulan los usos múltiples de
--registry=<a string>
-
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: primero se buscarán los módulos en los registros anteriores y solo se recurrirá a los registros posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemónicas con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemónicas.
- Opciones que especifican o alteran una entrada genérica para un comando de Bazel que no se incluye en otras categorías:
- Valor predeterminado de
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
valor predeterminado: consulta la descripción- Especifica un archivo para configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva (`allow`, `block` o `rewrite`) seguida de un nombre de host (para `allow` y `block`) o dos patrones, uno para la coincidencia y otro para usar como URL sustituta, con referencias inversas que comienzan con `$1`. Es posible que se proporcionen varias directivas `rewrite` para la misma URL y, en este caso, se devolverán varias URLs.
- Opciones varias, no clasificadas de otra manera:
- Se acumulan los usos múltiples de
--override_repository=<an equals-separated mapping of repository name to path>
- Anula un repositorio con una ruta de acceso local con el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es absoluta, se usará tal cual. Si la ruta de acceso proporcionada es relativa, se relacionará con el directorio de trabajo actual. Si la ruta de acceso proporcionada comienza con "%workspace%", es relativa a la raíz del espacio de trabajo, que es el resultado de "bazel info workspace".
Opciones de configuración
Opciones de cobertura
Hereda todas las opciones de test.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan los usos múltiples de
--distdir=<a path>
-
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: "false"-
Si se configura, la caché del repositorio creará un vínculo físico al archivo en caso de acierto de caché, en lugar de copiarlo. Esto tiene como objetivo ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
predeterminado: "false"-
Si es verdadero, usa una cadena derivada de las URLs de las descargas del repositorio como canonical_id si no se especifica. Esto hace que un cambio en las URLs genere una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no provoquen que la caché oculte repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
predeterminado: "false"-
Si se configura, no se permite la descarga de repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark según este factor. De esta manera, los repositorios externos pueden funcionar en máquinas más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Ajusta todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
valor predeterminado: consulta la descripción-
Especifica la ubicación de la caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que afectan la rigidez con la que Bazel aplica las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
- Valor predeterminado de
--experimental_repository_hash_file=<a string>
: "" -
Si no está vacío, especifica un archivo que contiene un valor resuelto, con el que se deben verificar los hashes del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan los usos múltiples de
--experimental_verify_repository_rules=<a string>
-
Si se proporciona un archivo con --experimental_repository_hash_file, se debe verificar la lista de reglas del repositorio para las que se debe verificar el hash del directorio de salida.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: "true"-
No-op
Etiquetas:no_op
,deprecated
,experimental
- Opciones relacionadas con la salida y la semántica de Bzlmod:
- Se acumulan los usos múltiples de
--allow_yanked_versions=<a string>
-
Se especificaron las versiones del módulo en el formato "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran como retiradas en el registro del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones retiradas harán que falle la resolución. También puedes definir la versión anulada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivar el problema a una falla de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecta una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "warning"-
Verifica si las dependencias directas de `bazel_dep` declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivar el problema como una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el archivo MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
predeterminado: "off"-
Especifica cómo y si se debe usar el archivo de bloqueo. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "error" para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan los usos múltiples de
--override_module=<an equals-separated mapping of module name to path>
- Anula un módulo con una ruta local con el formato <nombre del módulo>=<ruta>. Si la ruta proporcionada es absoluta, se usará tal cual. Si la ruta proporcionada es relativa, será relativa al directorio de trabajo actual. Si la ruta de acceso proporcionada comienza con "%workspace%", es relativa a la raíz del espacio de trabajo, que es el resultado de "bazel info workspace".
- Se acumulan los usos múltiples de
--registry=<a string>
-
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: primero se buscarán los módulos en los registros anteriores y solo se recurrirá a los registros posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemónicas con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemónicas.
- Opciones que especifican o alteran una entrada genérica para un comando de Bazel que no se incluye en otras categorías:
- Valor predeterminado de
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
valor predeterminado: consulta la descripción- Especifica un archivo para configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva (`allow`, `block` o `rewrite`) seguida de un nombre de host (para `allow` y `block`) o dos patrones, uno para la coincidencia y otro para usar como URL sustituta, con referencias inversas que comienzan con `$1`. Es posible que se proporcionen varias directivas `rewrite` para la misma URL y, en este caso, se devolverán varias URLs.
- Opciones varias, no clasificadas de otra manera:
- Se acumulan los usos múltiples de
--override_repository=<an equals-separated mapping of repository name to path>
- Anula un repositorio con una ruta de acceso local con el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es absoluta, se usará tal cual. Si la ruta de acceso proporcionada es relativa, se relacionará con el directorio de trabajo actual. Si la ruta de acceso proporcionada comienza con "%workspace%", es relativa a la raíz del espacio de trabajo, que es el resultado de "bazel info workspace".
Opciones de Cquery
Hereda todas las opciones de test.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan los usos múltiples de
--distdir=<a path>
-
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: "false"-
Si se configura, la caché del repositorio creará un vínculo físico al archivo en caso de acierto de caché, en lugar de copiarlo. Esto tiene como objetivo ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
predeterminado: "false"-
Si es verdadero, usa una cadena derivada de las URLs de las descargas del repositorio como canonical_id si no se especifica. Esto hace que un cambio en las URLs genere una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no provoquen que la caché oculte repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
predeterminado: "false"-
Si se configura, no se permite la descarga de repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark según este factor. De esta manera, los repositorios externos pueden funcionar en máquinas más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Ajusta todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
valor predeterminado: consulta la descripción-
Especifica la ubicación de la caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que afectan la rigidez con la que Bazel aplica las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
- Valor predeterminado de
--experimental_repository_hash_file=<a string>
: "" -
Si no está vacío, especifica un archivo que contiene un valor resuelto, con el que se deben verificar los hashes del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan los usos múltiples de
--experimental_verify_repository_rules=<a string>
-
Si se proporciona un archivo con --experimental_repository_hash_file, se debe verificar la lista de reglas del repositorio para las que se debe verificar el hash del directorio de salida.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: "true"-
No-op
Etiquetas:no_op
,deprecated
,experimental
- Opciones relacionadas con la salida y la semántica de la búsqueda:
--aspect_deps=<off, conservative or precise>
valor predeterminado: "conservative"-
Cómo resolver las dependencias de aspectos cuando el formato de salida es uno de {xml,proto,record}. "off" significa que no se resuelve ninguna dependencia de aspectos; "conservative" (el valor predeterminado) significa que se agregan todas las dependencias de aspectos declaradas, independientemente de si se les asigna la clase de regla de dependencias directas; "precise" significa que solo se agregan aquellos aspectos que posiblemente estén activos dada la clase de regla de las dependencias directas. Ten en cuenta que el modo preciso requiere cargar otros paquetes para evaluar un solo objetivo, lo que lo hace más lento que los otros modos. También ten en cuenta que incluso el modo preciso no es completamente preciso: la decisión de calcular un aspecto se toma en la fase de análisis, que no se ejecuta durante "bazel query".
Etiquetas:build_file_semantics
--[no]consistent_labels
predeterminado: "false"-
Si está habilitado, cada comando de consulta emite etiquetas como si se aplicara la función <code>str</code> de Starlark a una instancia de <code>Label</code>. Esto es útil para las herramientas que necesitan coincidir con el resultado de diferentes comandos de consulta o etiquetas emitidas por reglas. Si no está habilitado, los formateadores de salida pueden emitir nombres de repositorio aparentes (relativos al repositorio principal) para que la salida sea más legible.
Etiquetas:terminal_output
--[no]graph:factored
predeterminado: "true"-
Si es verdadero, el gráfico se emitirá "factorizado", es decir, los nodos topológicamente equivalentes se combinarán y sus etiquetas se concatenarán. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--graph:node_limit=<an integer>
valor predeterminado: "512"-
Es la longitud máxima de la cadena de etiqueta para un nodo de gráfico en el resultado. Las etiquetas más largas se truncarán. El valor -1 significa que no se truncarán. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--[no]implicit_deps
predeterminado: "true"-
Si está habilitado, las dependencias implícitas se incluirán en el gráfico de dependencias sobre el que opera la consulta. Una dependencia implícita es aquella que no se especifica de forma explícita en el archivo BUILD, pero que Bazel agrega. En el caso de cquery, esta opción controla el filtrado de las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
--[no]include_aspects
predeterminado: "true"-
aquery, cquery: Indica si se deben incluir las acciones generadas por aspectos en el resultado. query: No es una operación (los aspectos siempre se siguen).
Etiquetas:terminal_output
--[no]incompatible_display_source_file_location
predeterminado: "true"-
Es verdadero de forma predeterminada y muestra el destino del archivo fuente. Si es verdadero, muestra la ubicación de la línea 1 de los archivos fuente en los resultados de ubicación. Esta marca solo existe para fines de migración.
Etiquetas:terminal_output
,incompatible_change
--[no]incompatible_package_group_includes_double_slash
predeterminado: "true"-
Si está habilitado, cuando se genere el atributo `packages` de package_group, no se omitirá el `//` inicial.
Etiquetas:terminal_output
,incompatible_change
--[no]infer_universe_scope
predeterminado: "false"-
Si se configura y no se configura --universe_scope, se inferirá un valor de --universe_scope como la lista de patrones de destino únicos en la expresión de búsqueda. Ten en cuenta que el valor de --universe_scope que se infiere para una expresión de búsqueda que usa funciones con alcance del universo (p.ej., "allrdeps") podría no ser el que deseas, por lo que debes usar esta opción solo si sabes lo que haces. Consulta https://bazel.build/reference/query#sky-query para obtener detalles y ejemplos. Si se establece --universe_scope, se ignora el valor de esta opción. Nota: Esta opción solo se aplica a `query` (es decir, no a `cquery`).
Etiquetas:loading_and_analysis
--[no]line_terminator_null
predeterminado: "false"-
Indica si cada formato termina con \0 en lugar de un salto de línea.
Etiquetas:terminal_output
--[no]nodep_deps
predeterminado: "true"-
Si está habilitado, las dependencias de los atributos "nodep" se incluirán en el gráfico de dependencias sobre el que opera la consulta. Un ejemplo común de un atributo "nodep" es "visibilidad". Ejecuta y analiza el resultado de `info build-language` para obtener información sobre todos los atributos "nodep" en el lenguaje de compilación.
Etiquetas:build_file_semantics
--output=<a string>
predeterminado: "label"-
Es el formato en el que se deben imprimir los resultados de cquery. Los valores permitidos para cquery son: label, label_kind, textproto, transitions, proto y jsonproto. Si seleccionas "transiciones", también debes especificar la opción --transitions=(lite|full).
Etiquetas:terminal_output
--[no]proto:default_values
predeterminado: "true"-
Si es verdadero, se incluyen los atributos cuyo valor no se especifica de forma explícita en el archivo BUILD; de lo contrario, se omiten. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
--[no]proto:definition_stack
predeterminado: "false"-
Propaga el campo proto definition_stack, que registra para cada instancia de regla la pila de llamadas de Starlark en el momento en que se definió la clase de la regla.
Etiquetas:terminal_output
--[no]proto:flatten_selects
predeterminado: "true"-
Si está habilitado, los atributos configurables creados por select() se aplanan. En el caso de los tipos de lista, la representación aplanada es una lista que contiene cada valor del mapa de selección exactamente una vez. Los tipos escalares se aplanan a nulos.
Etiquetas:build_file_semantics
--[no]proto:include_configurations
predeterminado: "true"-
Si está habilitado, el resultado de proto incluirá información sobre las configuraciones. Cuando se inhabilita,el formato de salida del arvo de .proto de cquery se parece al formato de salida de la consulta.
Etiquetas:affects_outputs
--[no]proto:include_synthetic_attribute_hash
predeterminado: "false"-
Indica si se debe calcular y completar el atributo $internal_attr_hash.
Etiquetas:terminal_output
--[no]proto:instantiation_stack
predeterminado: "false"-
Propaga la pila de llamadas de instanciación de cada regla. Ten en cuenta que esto requiere que la pila esté presente.
Etiquetas:terminal_output
--[no]proto:locations
predeterminado: "true"-
Indica si se debe generar información de ubicación en la salida de proto.
Etiquetas:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
predeterminado: "all"-
Lista de atributos separados por comas que se incluirán en el resultado. La configuración predeterminada incluye todos los atributos. Se establece en una cadena vacía para no generar ningún atributo. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
--[no]proto:rule_inputs_and_outputs
predeterminado: "true"-
Indica si se deben propagar los campos rule_input y rule_output.
Etiquetas:terminal_output
- Valor predeterminado de
--query_file=<a string>
: "" -
Si se configura, la consulta leerá la consulta del archivo que se nombra aquí, en lugar de hacerlo desde la línea de comandos. Es un error especificar un archivo aquí y una consulta de línea de comandos.
Etiquetas:changes_inputs
--[no]relative_locations
predeterminado: "false"-
Si es verdadero, la ubicación de los archivos BUILD en las salidas de XML y proto será relativa. De forma predeterminada, la salida de ubicación es una ruta de acceso absoluta y no será coherente en todas las máquinas. Puedes establecer esta opción como verdadera para obtener un resultado coherente en todas las máquinas.
Etiquetas:terminal_output
--show_config_fragments=<off, direct or transitive>
predeterminado: "off"-
Muestra los fragmentos de configuración que requiere una regla y sus dependencias transitivas. Esto puede ser útil para evaluar cuánto se puede reducir un gráfico de destino configurado.
Etiquetas:affects_outputs
- Valor predeterminado de
--starlark:expr=<a string>
: "" -
Es una expresión de Starlark para dar formato a cada destino configurado en el modo --output=starlark de cquery. El destino configurado está vinculado a "destino". Si no se especifican --starlark:expr ni --starlark:file, esta opción se establecerá de forma predeterminada en "str(target.label)". Es un error especificar tanto --starlark:expr como --starlark:file.
Etiquetas:terminal_output
- Valor predeterminado de
--starlark:file=<a string>
: "" -
Nombre de un archivo que define una función de Starlark llamada "format", de un argumento, que se aplica a cada destino configurado para darle formato como una cadena. Es un error especificar tanto --starlark:expr como --starlark:file. Consulta la ayuda de --output=starlark para obtener más detalles.
Etiquetas:terminal_output
--[no]tool_deps
predeterminado: "true"-
Consulta: Si está inhabilitada, las dependencias de los destinos de "configuración del host" o "ejecución" no se incluirán en el gráfico de dependencias sobre el que opera la consulta. Un borde de dependencia de "configuración del host", como el que va de cualquier regla "proto_library" al compilador de Protocolos, suele apuntar a una herramienta que se ejecuta durante la compilación en lugar de a una parte del mismo programa "target".
Cquery: Si está inhabilitado, filtra todos los destinos configurados que cruzan una transición de host o de ejecución desde el destino de nivel superior que descubrió este destino configurado. Esto significa que, si el destino de nivel superior está en la configuración de destino, solo se devolverán los destinos configurados que también estén en la configuración de destino. Si el destino de nivel superior está en la configuración del host, solo se devolverán los destinos configurados del host. Esta opción NO excluirá las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
--transitions=<full, lite or none>
predeterminado: "none"-
Es el formato en el que cquery imprimirá la información de transición.
Etiquetas:affects_outputs
- Valor predeterminado de
--universe_scope=<comma-separated list of options>
: "" -
Es un conjunto de patrones de segmentación (aditivos y sustractivos) separados por comas. La consulta se puede realizar en el universo definido por el cierre transitivo de los destinos especificados. Esta opción se usa para los comandos query y cquery.
En el caso de cquery, la entrada de esta opción son los destinos en los que se compilan todas las respuestas, por lo que esta opción puede afectar las configuraciones y las transiciones. Si no se especifica esta opción, se supone que los destinos de nivel superior son los que se analizan a partir de la expresión de búsqueda. Nota: En el caso de cquery, no especificar esta opción puede provocar que se interrumpa la compilación si los destinos analizados a partir de la expresión de la consulta no se pueden compilar con las opciones de nivel superior.
Etiquetas:loading_and_analysis
- Opciones relacionadas con la salida y la semántica de Bzlmod:
- Se acumulan los usos múltiples de
--allow_yanked_versions=<a string>
-
Se especificaron las versiones del módulo en el formato "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran como retiradas en el registro del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones retiradas harán que falle la resolución. También puedes definir la versión anulada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivar el problema a una falla de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecta una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "warning"-
Verifica si las dependencias directas de `bazel_dep` declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivar el problema como una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el archivo MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
predeterminado: "off"-
Especifica cómo y si se debe usar el archivo de bloqueo. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "error" para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan los usos múltiples de
--override_module=<an equals-separated mapping of module name to path>
- Anula un módulo con una ruta local con el formato <nombre del módulo>=<ruta>. Si la ruta proporcionada es absoluta, se usará tal cual. Si la ruta proporcionada es relativa, será relativa al directorio de trabajo actual. Si la ruta de acceso proporcionada comienza con "%workspace%", es relativa a la raíz del espacio de trabajo, que es el resultado de "bazel info workspace".
- Se acumulan los usos múltiples de
--registry=<a string>
-
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: primero se buscarán los módulos en los registros anteriores y solo se recurrirá a los registros posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemónicas con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemónicas.
- Opciones que especifican o alteran una entrada genérica para un comando de Bazel que no se incluye en otras categorías:
- Valor predeterminado de
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
valor predeterminado: consulta la descripción- Especifica un archivo para configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva (`allow`, `block` o `rewrite`) seguida de un nombre de host (para `allow` y `block`) o dos patrones, uno para la coincidencia y otro para usar como URL sustituta, con referencias inversas que comienzan con `$1`. Es posible que se proporcionen varias directivas `rewrite` para la misma URL y, en este caso, se devolverán varias URLs.
- Opciones varias, no clasificadas de otra manera:
- Se acumulan los usos múltiples de
--override_repository=<an equals-separated mapping of repository name to path>
- Anula un repositorio con una ruta de acceso local con el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es absoluta, se usará tal cual. Si la ruta de acceso proporcionada es relativa, se relacionará con el directorio de trabajo actual. Si la ruta de acceso proporcionada comienza con "%workspace%", es relativa a la raíz del espacio de trabajo, que es el resultado de "bazel info workspace".
- Opciones que controlan la ejecución de la compilación:
--[no]experimental_inprocess_symlink_creation
predeterminado: "false"-
Indica si se deben realizar llamadas directas al sistema de archivos para crear árboles de vínculos simbólicos.
Etiquetas:loading_and_analysis
,execution
,experimental
--[no]experimental_remotable_source_manifests
predeterminado: "false"-
Indica si las acciones del manifiesto fuente se pueden realizar de forma remota.
Etiquetas:loading_and_analysis
,execution
,experimental
--[no]experimental_split_coverage_postprocessing
predeterminado: "false"-
Si es verdadero, Bazel ejecutará el procesamiento posterior de la cobertura para la prueba en una nueva generación.
Etiquetas:execution
--[no]experimental_strict_fileset_output
predeterminado: "false"-
Si esta opción está habilitada, los conjuntos de archivos tratarán todos los artefactos de salida como archivos normales. No recorrerán directorios ni serán sensibles a los vínculos simbólicos.
Etiquetas:execution
- Valor predeterminado de
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
: "" -
Agrega o quita claves de la información de ejecución de una acción según la mnemónica de la acción. Solo se aplica a las acciones que admiten información de ejecución. Muchas acciones comunes admiten información de ejecución, p.ej., Genrule, CppCompile, Javac, StarlarkAction y TestRunner. Cuando se especifican varios valores, el orden es importante porque muchas expresiones regulares pueden aplicarse a la misma mnemónica.
La sintaxis es "regex=[+-]key,regex=[+-]key,…".
Ejemplos:
".*=+x,.*=-y,.*=+z" agrega "x" y "z" a la información de ejecución de todas las acciones, y quita "y" de ella.
"Genrule=+requires-x" agrega "requires-x" a la información de ejecución de todas las acciones de Genrule.
"(?!Genrule).*=-requires-x" quita "requires-x" de la información de ejecución para todas las acciones que no sean Genrule.
Etiquetas:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Habilita acciones persistentes de dex y desugar de Android con trabajadores.
Se expande a:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
-
Habilita el procesador de recursos de Android persistente con trabajadores.
Se expande a lo siguiente:
--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=AARGenerator=worker
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_dex_desugar
-
Habilita acciones persistentes de dex y desugar de Android multiplexadas con trabajadores.
Se expande a:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
Habilita el procesador de recursos de Android multiplexado persistente con trabajadores.
Se expande a lo siguiente:
--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=AARGenerator=+supports-multiplex-workers
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_tools
-
Habilita herramientas de Android persistentes y multiplexadas (dexing, desugaring, procesamiento de recursos).
Se expande a:
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Etiquetas:host_machine_resource_optimizations
,execution
- Opciones que configuran la cadena de herramientas que se usa para la ejecución de acciones:
--android_compiler=<a string>
valor predeterminado: consulta la descripción-
Compilador de destino de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_crosstool_top=<a build target label>
predeterminado: "//external:android/crosstool"-
Ubicación del compilador de C++ que se usa para las compilaciones de Android.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_grte_top=<a label>
valor predeterminado: consulta la descripción-
El destino de Android grte_top.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
valor predeterminado: "android"-
Selecciona el combinador de manifiestos que se usará para las reglas de android_binary. Es una marca para ayudar en la transición de la herramienta de combinación heredada a la herramienta de combinación de manifiestos de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Valor predeterminado de
--android_platforms=<a build target label>
: "" -
Establece las plataformas que usan los destinos de android_binary. Si se especifican varias plataformas, el archivo binario es un APK grueso, que contiene archivos binarios nativos para cada plataforma de destino especificada.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_sdk=<a build target label>
default: "@bazel_tools//tools/android:sdk"-
Especifica el SDK o la plataforma de Android que se usan para compilar aplicaciones para Android.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--apple_compiler=<a string>
valor predeterminado: consulta la descripción-
El compilador de destino de Apple. Es útil para seleccionar variantes de una cadena de herramientas (p.ej., xcode-beta).
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--apple_crosstool_top=<a build target label>
predeterminado: "@bazel_tools//tools/cpp:toolchain"-
Es la etiqueta del paquete de herramientas cruzadas que se usará en las reglas de Apple y Objc, y sus dependencias.
Etiquetas:loses_incremental_state
,changes_inputs
--apple_grte_top=<a build target label>
valor predeterminado: consulta la descripción-
Es el grte_top de destino de Apple.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
- Valor predeterminado de
--cc_output_directory_tag=<a string>
: "" -
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas:affects_outputs
,explicit_in_output_path
--compiler=<a string>
valor predeterminado: consulta la descripción-
Es el compilador de C++ que se usará para compilar el destino.
Etiquetas:loading_and_analysis
,execution
--coverage_output_generator=<a build target label>
predeterminado: "@bazel_tools//tools/test:lcov_merger"-
Ubicación del archivo binario que se usa para el procesamiento posterior de los informes de cobertura sin procesar. Actualmente, debe ser un filegroup que contenga un solo archivo, el binario. El valor predeterminado es “//tools/test:lcov_merger”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
predeterminado: "@bazel_tools//tools/test:coverage_report_generator"-
Ubicación del archivo binario que se usa para generar informes de cobertura. Actualmente, debe ser un filegroup que contenga un solo archivo, el binario. El valor predeterminado es “//tools/test:coverage_report_generator”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
predeterminado: "@bazel_tools//tools/test:coverage_support"-
Ubicación de los archivos de asistencia que se requieren en las entradas de cada acción de prueba que recopila la cobertura del código. El valor predeterminado es “//tools/test:coverage_support”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--crosstool_top=<a build target label>
predeterminado: "@bazel_tools//tools/cpp:toolchain"-
Es la etiqueta del paquete de herramientas cruzadas que se usará para compilar código en C++.
Etiquetas:loading_and_analysis
,changes_inputs
,affects_outputs
--custom_malloc=<a build target label>
valor predeterminado: consulta la descripción-
Especifica una implementación de malloc personalizada. Este parámetro de configuración anula los atributos de malloc en las reglas de compilación.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan los usos múltiples de
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
-
Lista de expresiones regulares separadas por comas, cada una con el prefijo opcional - (expresión negativa), asignadas (=) a una lista de destinos de valores de restricción separados por comas. Si un destino no coincide con ninguna expresión negativa y coincide con al menos una expresión positiva, la resolución de su cadena de herramientas se realizará como si hubiera declarado los valores de restricción como restricciones de ejecución. Ejemplo: //demo,-test=@platforms//cpus:x86_64 agregará "x86_64" a cualquier destino en //demo, excepto a aquellos cuyo nombre contenga "test".
Etiquetas:loading_and_analysis
--[no]experimental_enable_objc_cc_deps
predeterminado: "true"-
Permite que las reglas objc_* dependan de cc_library y hace que cualquier dependencia de objc se compile con --cpu establecido en "ios_<--ios_cpu>" para cualquier valor en --ios_multi_cpu.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]experimental_include_xcode_execution_requirements
predeterminado: "false"-
Si se configura, agrega un requisito de ejecución "requires-xcode:{version}" a cada acción de Xcode. Si la versión de Xcode tiene una etiqueta con guiones, también agrega un requisito de ejecución "requires-xcode-label:{version_label}".
Etiquetas:loses_incremental_state
,loading_and_analysis
,execution
--[no]experimental_prefer_mutual_xcode
predeterminado: "true"-
Si es verdadero, usa el Xcode más reciente que esté disponible de forma local y remota. Si es falso o si no hay versiones disponibles mutuas, usa la versión local de Xcode seleccionada a través de xcode-select.
Etiquetas:loses_incremental_state
- Se acumulan los usos múltiples de
--extra_execution_platforms=<comma-separated list of options>
-
Son las plataformas disponibles como plataformas de ejecución para ejecutar acciones. Las plataformas se pueden especificar por objetivo exacto o como un patrón de objetivo. Estas plataformas se considerarán antes de las que se declaren en el archivo WORKSPACE con register_execution_platforms().
Etiquetas:execution
- Se acumulan los usos múltiples de
--extra_toolchains=<comma-separated list of options>
-
Son las reglas de la cadena de herramientas que se deben tener en cuenta durante la resolución de la cadena de herramientas. Las cadenas de herramientas se pueden especificar por destino exacto o como un patrón de destino. Estas cadenas de herramientas se considerarán antes de las que se declaran en el archivo WORKSPACE con register_toolchains().
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--grte_top=<a label>
valor predeterminado: consulta la descripción-
Es una etiqueta para una biblioteca de libc registrada. El valor predeterminado se selecciona con la cadena de herramientas de compilación cruzada y casi nunca es necesario anularlo.
Etiquetas:action_command_lines
,affects_outputs
--host_compiler=<a string>
valor predeterminado: consulta la descripción-
Es el compilador de C++ que se usará para la compilación del host. Se ignora si no se establece --host_crosstool_top.
Etiquetas:loading_and_analysis
,execution
--host_crosstool_top=<a build target label>
valor predeterminado: consulta la descripción-
De forma predeterminada, las opciones --crosstool_top y --compiler también se usan para la configuración del host. Si se proporciona esta marca, Bazel usa la libc y el compilador predeterminados para el crosstool_top determinado.
Etiquetas:loading_and_analysis
,changes_inputs
,affects_outputs
--host_grte_top=<a label>
valor predeterminado: consulta la descripción-
Si se especifica, este parámetro de configuración anula el directorio de nivel superior de libc (--grte_top) para la configuración del host.
Etiquetas:action_command_lines
,affects_outputs
- Valor predeterminado de
--host_platform=<a build target label>
: "" -
Etiqueta de una regla de plataforma que describe el sistema host.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--[no]incompatible_disable_expand_if_all_available_in_flag_set
predeterminado: "true"-
Si es verdadero, Bazel no permitirá especificar expand_if_all_available en flag_sets(consulta https://github.com/bazelbuild/bazel/issues/7008 para obtener instrucciones de migración).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
predeterminado: "true"-
Si es verdadero, Bazel no habilitará las funciones "host" y "nonhost" en la cadena de herramientas de C++ (consulta https://github.com/bazelbuild/bazel/issues/7407 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_android_toolchain_resolution
predeterminado: "false"-
Usa la resolución de cadenas de herramientas para seleccionar el SDK de Android para las reglas de Android (Starlark y nativas)
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_apple_toolchain_resolution
predeterminado: "false"-
Usa la resolución de la cadena de herramientas para seleccionar el SDK de Apple para las reglas de Apple (Starlark y nativas)
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone
predeterminado: "true"-
Si es verdadero, Bazel no volverá a usar las líneas de comandos de la acción de vinculación de C++ para las líneas de comandos de indexación de LTO (consulta https://github.com/bazelbuild/bazel/issues/6791 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain
predeterminado: "true"-
Si es verdadero, Bazel mostrará un error cuando se establezcan los atributos cc_toolchain.cpu y cc_toolchain.compiler (consulta https://github.com/bazelbuild/bazel/issues/7075 para obtener instrucciones de migración).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_legacy_whole_archive
predeterminado: "true"-
Si es verdadero, Bazel no vinculará las dependencias de la biblioteca como un archivo completo de forma predeterminada (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener instrucciones de migración).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_require_ctx_in_configure_features
predeterminado: "true"-
Si es verdadero, Bazel requerirá el parámetro "ctx" en cc_common.configure_features (consulta https://github.com/bazelbuild/bazel/issues/7793 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
-
Usa objetos compartidos de interfaz si la cadena de herramientas los admite. Actualmente, todas las cadenas de herramientas de ELF admiten este parámetro de configuración.
Etiquetas:loading_and_analysis
,affects_outputs
,affects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
valor predeterminado: consulta la descripción-
Especifica la versión del SDK de iOS que se usará para compilar aplicaciones para iOS. Si no se especifica, se usa la versión predeterminada del SDK de iOS de "xcode_version".
Etiquetas:loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
valor predeterminado: consulta la descripción-
Especifica la versión del SDK de macOS que se usará para compilar aplicaciones para macOS. Si no se especifica, se usa la versión predeterminada del SDK de macOS de "xcode_version".
Etiquetas:loses_incremental_state
--minimum_os_version=<a string>
valor predeterminado: consulta la descripción-
Es la versión mínima del SO para la que se compila tu app.
Etiquetas:loading_and_analysis
,affects_outputs
- Valor predeterminado de
--platform_mappings=<a relative path>
: "" -
Ubicación de un archivo de asignación que describe qué plataforma usar si no se configuró ninguna o qué marcas establecer cuando ya existe una plataforma. Debe ser relativa a la raíz del espacio de trabajo principal. El valor predeterminado es "platform_mappings" (un archivo directamente en la raíz del espacio de trabajo).
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
- Valor predeterminado de
--platforms=<a build target label>
: "" -
Son las etiquetas de las reglas de la plataforma que describen las plataformas de destino para el comando actual.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--python2_path=<a string>
valor predeterminado: consulta la descripción-
Obsoleto, no hace nada. Se inhabilita con `--incompatible_use_python_toolchains`.
Etiquetas:no_op
,deprecated
--python3_path=<a string>
valor predeterminado: consulta la descripción-
Obsoleto, no hace nada. Se inhabilita con `--incompatible_use_python_toolchains`.
Etiquetas:no_op
,deprecated
--python_path=<a string>
valor predeterminado: consulta la descripción-
Es la ruta de acceso absoluta del intérprete de Python invocado para ejecutar destinos de Python en la plataforma de destino. Obsoleto; se inhabilita con --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
--python_top=<a build target label>
valor predeterminado: consulta la descripción-
Es la etiqueta de un py_runtime que representa el intérprete de Python invocado para ejecutar destinos de Python en la plataforma de destino. Obsoleto; se inhabilita con --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
--target_platform_fallback=<a build target label>
predeterminado: "@local_config_platform//:host"-
Es la etiqueta de una regla de plataforma que se debe usar si no se establece ninguna plataforma de destino y ninguna asignación de plataforma coincide con el conjunto actual de marcas.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
valor predeterminado: consulta la descripción-
Especifica la versión del SDK de tvOS que se usará para compilar aplicaciones para tvOS. Si no se especifica, se usa la versión predeterminada del SDK de tvOS de "xcode_version".
Etiquetas:loses_incremental_state
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
valor predeterminado: consulta la descripción-
Especifica la versión del SDK de watchOS que se usará para compilar aplicaciones para watchOS. Si no se especifica, se usa la versión predeterminada del SDK de watchOS de "xcode_version".
Etiquetas:loses_incremental_state
--xcode_version=<a string>
valor predeterminado: consulta la descripción-
Si se especifica, usa Xcode de la versión indicada para las acciones de compilación pertinentes. Si no se especifica, se usa la versión predeterminada del ejecutor de Xcode.
Etiquetas:loses_incremental_state
--xcode_version_config=<a build target label>
valor predeterminado: "@bazel_tools//tools/cpp:host_xcodes"-
Es la etiqueta de la regla xcode_config que se usará para seleccionar la versión de Xcode en la configuración de compilación.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Opciones que controlan el resultado del comando:
--[no]apple_enable_auto_dsym_dbg
predeterminado: "false"-
Indica si se debe forzar la habilitación de la generación de archivos de símbolos de depuración (.dSYM) para las compilaciones de depuración.
Etiquetas:affects_outputs
,action_command_lines
--[no]apple_generate_dsym
predeterminado: "false"-
Indica si se deben generar archivos de símbolos de depuración (.dSYM).
Etiquetas:affects_outputs
,action_command_lines
--[no]build_runfile_links
predeterminado: "true"-
Si es verdadero, compila bosques de vínculos simbólicos de archivos ejecutables para todos los destinos. Si es falso, escribe solo manifiestos cuando sea posible.
Etiquetas:affects_outputs
--[no]build_runfile_manifests
predeterminado: "true"-
Si es verdadero, escribe manifiestos de archivos ejecutables para todos los destinos. Si es falso, omítelos. Las pruebas locales no se ejecutarán cuando sea falso.
Etiquetas:affects_outputs
--[no]build_test_dwp
predeterminado: "false"-
Si está habilitado, cuando se compilen pruebas de C++ de forma estática y con fission, también se compilará automáticamente el archivo .dwp para el archivo binario de prueba.
Etiquetas:loading_and_analysis
,affects_outputs
--cc_proto_library_header_suffixes=<comma-separated list of options>
predeterminado: ".pb.h"-
Establece los prefijos de los archivos de encabezado que crea un cc_proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated list of options>
predeterminado: ".pb.cc"-
Establece los prefijos de los archivos fuente que crea un cc_proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info
predeterminado: "false"-
Ejecuta acciones adicionales para versiones alternativas de la API de Java en un proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_proto_extra_actions
predeterminado: "false"-
Ejecuta acciones adicionales para versiones alternativas de la API de Java en un proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_save_feature_state
predeterminado: "false"-
Guarda el estado de las funciones habilitadas y solicitadas como resultado de la compilación.
Etiquetas:affects_outputs
,experimental
--fission=<a set of compilation modes>
predeterminado: "no"-
Especifica qué modos de compilación usan fission para las compilaciones y las vinculaciones de C++. Puede ser cualquier combinación de {"fastbuild", "dbg", "opt"} o los valores especiales "yes" para habilitar todos los modos y "no" para inhabilitar todos los modos.
Etiquetas:loading_and_analysis
,action_command_lines
,affects_outputs
--[no]incompatible_always_include_files_in_data
predeterminado: "true"-
Si es verdadero, las reglas nativas agregan <code>DefaultInfo.files</code> de las dependencias de datos a sus archivos ejecutables, lo que coincide con el comportamiento recomendado para las reglas de Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid).
Etiquetas:affects_outputs
,incompatible_change
--[no]legacy_external_runfiles
predeterminado: "true"-
Si es verdadero, compila bosques de vínculos simbólicos de archivos de ejecución para repositorios externos en .runfiles/wsname/external/repo (además de .runfiles/repo).
Etiquetas:affects_outputs
--[no]objc_generate_linkmap
predeterminado: "false"-
Especifica si se debe generar un archivo de mapa de vínculos.
Etiquetas:affects_outputs
--[no]save_temps
predeterminado: "false"-
Si se configura, se guardarán los resultados temporales de gcc. Estos incluyen archivos .s (código de ensamblador), archivos .i (C preprocesado) y archivos .ii (C++ preprocesado).
Etiquetas:affects_outputs
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
- Se acumulan los usos múltiples de
--action_env=<a 'name=value' assignment with an optional value part>
-
Especifica el conjunto de variables de entorno disponibles para las acciones con configuración de destino. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o bien por el par nombre=valor que establece el valor independientemente del entorno de invocación. Esta opción se puede usar varias veces. En el caso de las opciones proporcionadas para la misma variable, se aplica la más reciente. Las opciones para diferentes variables se acumulan.
Etiquetas:action_command_lines
--android_cpu=<a string>
predeterminado: "armeabi-v7a"-
Es la CPU objetivo de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]android_databinding_use_androidx
predeterminado: "false"-
Genera archivos de vinculación de datos compatibles con AndroidX. Esto solo se usa con la vinculación de datos v2.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]android_databinding_use_v3_4_args
predeterminado: "false"-
Usa la vinculación de datos de Android v2 con el argumento 3.4.0
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--android_dynamic_mode=<off, default or fully>
predeterminado: "off"-
Determina si las dependencias de C++ de las reglas de Android se vincularán de forma dinámica cuando un cc_binary no cree de forma explícita una biblioteca compartida. "default" significa que Bazel elegirá si se vincula de forma dinámica. "fully" significa que todas las bibliotecas se vincularán de forma dinámica. "off" significa que todas las bibliotecas se vincularán principalmente en modo estático.
Etiquetas:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
predeterminado: "alfabético"-
Establece el orden de los manifiestos que se pasan al combinador de manifiestos para los archivos binarios de Android. ALPHABETICAL significa que los manifiestos se ordenan por ruta de acceso relativa a execroot. ALPHABETICAL_BY_CONFIGURATION significa que los manifiestos se ordenan por rutas de acceso relativas al directorio de configuración dentro del directorio de salida. DEPENDENCY significa que los manifiestos se ordenan de modo que el manifiesto de cada biblioteca aparezca antes de los manifiestos de sus dependencias.
Etiquetas:action_command_lines
,execution
--[no]android_resource_shrinking
predeterminado: "false"-
Habilita la reducción de recursos para los APKs de android_binary que usan ProGuard.
Etiquetas:affects_outputs
,loading_and_analysis
- Se acumulan los usos múltiples de
--apple_bitcode=<'mode' or 'platform=mode', where 'mode' is none, embedded_markers or embedded, and 'platform' is ios, visionos, watchos, tvos, macos or catalyst>
-
Especifica el modo de bitcode de Apple para los pasos de compilación que tienen como objetivo las arquitecturas de dispositivos. Los valores tienen el formato "[plataforma=]modo", en el que la plataforma (que debe ser "ios", "macos", "tvos" o "watchos") es opcional. Si se proporciona, el modo de bitcode se aplica específicamente para esa plataforma. Si se omite, se aplica para todas las plataformas. El modo debe ser "none", "embedded_markers" o "embedded". Esta opción se puede proporcionar varias veces.
Etiquetas:loses_incremental_state
--[no]build_python_zip
predeterminado: "auto"-
Compila el archivo .zip ejecutable de Python; activado en Windows, desactivado en otras plataformas
Etiquetas:affects_outputs
- Se acumulan los usos múltiples de
--catalyst_cpus=<comma-separated list of options>
-
Lista separada por comas de las arquitecturas para las que se compilarán los archivos binarios de Apple Catalyst.
Etiquetas:loses_incremental_state
,loading_and_analysis
--[no]collect_code_coverage
predeterminado: "false"-
Si se especifica, Bazel instrumentará el código (con instrumentación sin conexión cuando sea posible) y recopilará información de cobertura durante las pruebas. Solo se verán afectados los destinos que coincidan con --instrumentation_filter. Por lo general, esta opción no se debe especificar directamente. En su lugar, se debe usar el comando "bazel coverage".
Etiquetas:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] valor predeterminado: "fastbuild"-
Especifica el modo en el que se compilará el objeto binario. Valores: "fastbuild", "dbg", "opt".
Etiquetas:affects_outputs
,action_command_lines
,explicit_in_output_path
- Se acumulan los usos múltiples de
--conlyopt=<a string>
-
Opción adicional para pasar a gcc cuando se compilan archivos de origen C.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan los usos múltiples de
--copt=<a string>
-
Opciones adicionales para pasar a gcc.
Etiquetas:action_command_lines
,affects_outputs
- Valor predeterminado de
--cpu=<a string>
: "" -
CPU objetivo.
Etiquetas:changes_inputs
,affects_outputs
,explicit_in_output_path
--cs_fdo_absolute_path=<a string>
valor predeterminado: consulta la descripción-
Usa la información del perfil de CSFDO para optimizar la compilación. Especifica el nombre de la ruta de acceso absoluta del archivo ZIP que contiene el archivo de perfil, un archivo de perfil de LLVM sin procesar o indexado.
Etiquetas:affects_outputs
--cs_fdo_instrument=<a string>
valor predeterminado: consulta la descripción-
Genera archivos binarios con la instrumentación de FDO sensible al contexto. Con el compilador Clang/LLVM, también acepta el nombre del directorio en el que se volcarán los archivos de perfil sin procesar en el tiempo de ejecución.
Etiquetas:affects_outputs
--cs_fdo_profile=<a build target label>
valor predeterminado: consulta la descripción-
Es el cs_fdo_profile que representa el perfil sensible al contexto que se usará para la optimización.
Etiquetas:affects_outputs
- Se acumulan los usos múltiples de
--cxxopt=<a string>
-
Opción adicional para pasar a gcc cuando se compilan archivos de origen C++.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan los usos múltiples de
--define=<a 'name=value' assignment>
-
Cada opción --define especifica una asignación para una variable de compilación.
Etiquetas:changes_inputs
,affects_outputs
--dynamic_mode=<off, default or fully>
predeterminado: "default"-
Determina si los archivos binarios de C++ se vincularán de forma dinámica. "default" significa que Bazel elegirá si se vincula de forma dinámica. "fully" significa que todas las bibliotecas se vincularán de forma dinámica. "off" significa que todas las bibliotecas se vincularán principalmente en modo estático.
Etiquetas:loading_and_analysis
,affects_outputs
--[no]enable_fdo_profile_absolute_path
predeterminado: "true"-
Si se configura, el uso de fdo_absolute_profile_path generará un error.
Etiquetas:affects_outputs
--[no]enable_runfiles
predeterminado: "auto"-
Habilita el árbol de vínculos simbólicos de runfiles. De forma predeterminada, está desactivado en Windows y activado en otras plataformas.
Etiquetas:affects_outputs
- Se acumulan los usos múltiples de
--experimental_action_listener=<a build target label>
-
Dejó de estar disponible y se reemplazó por aspectos. Usa action_listener para adjuntar un extra_action a las acciones de compilación existentes.
Etiquetas:execution
,experimental
--[no]experimental_android_compress_java_resources
predeterminado: "false"-
Comprimir recursos de Java en APKs
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_android_databinding_v2
predeterminado: "false"-
Use android databinding v2
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_android_resource_shrinking
predeterminado: "false"-
Habilita la reducción de recursos para los APKs de android_binary que usan ProGuard.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_android_rewrite_dexes_with_rex
predeterminado: "false"-
use rex tool to rewrite dex files
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_collect_code_coverage_for_generated_files
predeterminado: "false"-
Si se especifica, Bazel también generará información de recopilación de cobertura para los archivos generados.
Etiquetas:affects_outputs
--experimental_objc_fastbuild_options=<comma-separated list of options>
predeterminado: "-O0,-DDEBUG=1"-
Usa estas cadenas como opciones del compilador de compilación rápida de objc.
Etiquetas:action_command_lines
--[no]experimental_omitfp
predeterminado: "false"-
Si es verdadero, usa libunwind para el desenrollado de la pila y compila con -fomit-frame-pointer y -fasynchronous-unwind-tables.
Etiquetas:action_command_lines
,affects_outputs
,experimental
--[no]experimental_platform_in_output_dir
predeterminado: "false"-
Si es verdadero, la plataforma de destino se usa en el nombre del directorio de salida en lugar de la CPU.
Etiquetas:affects_outputs
,experimental
--[no]experimental_use_llvm_covmap
predeterminado: "false"-
Si se especifica, Bazel generará información del mapa de cobertura de llvm-cov en lugar de gcov cuando se habilite collect_code_coverage.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
--fat_apk_cpu=<comma-separated list of options>
predeterminado: "armeabi-v7a"-
Si configuras esta opción, se habilitarán los APKs multiarquitectura, que contienen objetos binarios nativos para todas las arquitecturas de destino especificadas, p.ej., --fat_apk_cpu=x86,armeabi-v7a. Si se especifica esta marca, se ignora --android_cpu para las dependencias de las reglas de android_binary.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]fat_apk_hwasan
predeterminado: "false"-
Indica si se deben crear divisiones de HWASAN.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--fdo_instrument=<a string>
valor predeterminado: consulta la descripción-
Genera archivos binarios con la instrumentación de FDO. Con el compilador Clang/LLVM, también acepta el nombre del directorio en el que se volcarán los archivos de perfil sin procesar en el tiempo de ejecución.
Etiquetas:affects_outputs
--fdo_optimize=<a string>
valor predeterminado: consulta la descripción-
Usa la información del perfil de FDO para optimizar la compilación. Especifica el nombre de un archivo ZIP que contenga un árbol de archivos .gcda, un archivo AFDO que contenga un perfil automático o un archivo de perfil de LLVM. Esta marca también acepta archivos especificados como etiquetas (p.ej., `//foo/bar:file.afdo`; es posible que debas agregar una directiva `exports_files` al paquete correspondiente) y etiquetas que apuntan a destinos `fdo_profile`. Esta marca se reemplazará por la regla "fdo_profile".
Etiquetas:affects_outputs
--fdo_prefetch_hints=<a build target label>
valor predeterminado: consulta la descripción-
Usa sugerencias de recuperación previa de caché.
Etiquetas:affects_outputs
--fdo_profile=<a build target label>
valor predeterminado: consulta la descripción-
Es el objeto fdo_profile que representa el perfil que se usará para la optimización.
Etiquetas:affects_outputs
- Se acumulan los usos múltiples de
--features=<a string>
-
Las funciones proporcionadas se habilitarán o inhabilitarán de forma predeterminada para los destinos compilados en la configuración de destino. Si especificas -<feature>, se inhabilitará la función. Las funciones negativas siempre anulan las positivas. Consulta también --host_features.
Etiquetas:changes_inputs
,affects_outputs
--[no]force_pic
predeterminado: "false"-
Si está habilitado, todas las compilaciones de C++ producen código independiente de la posición (“-fPIC”), las vinculaciones prefieren las bibliotecas prediseñadas PIC a las bibliotecas no PIC y las vinculaciones producen ejecutables independientes de la posición (“-pie”).
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan los usos múltiples de
--host_action_env=<a 'name=value' assignment with an optional value part>
-
Especifica el conjunto de variables de entorno disponibles para las acciones con configuraciones de host o de ejecución. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o bien por el par nombre=valor que establece el valor independientemente del entorno de invocación. Esta opción se puede usar varias veces. En el caso de las opciones proporcionadas para la misma variable, se aplica la más reciente. Las opciones para diferentes variables se acumulan.
Etiquetas:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
valor predeterminado: "opt"-
Especifica el modo en el que se compilarán las herramientas que se usan durante la compilación. Valores: "fastbuild", "dbg", "opt".
Etiquetas:affects_outputs
,action_command_lines
- Se acumulan los usos múltiples de
--host_conlyopt=<a string>
-
Opción adicional para pasar a gcc cuando se compilan archivos de origen C para herramientas del host.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan los usos múltiples de
--host_copt=<a string>
-
Opciones adicionales para pasar a gcc para las herramientas del host.
Etiquetas:action_command_lines
,affects_outputs
- Valor predeterminado de
--host_cpu=<a string>
: "" -
Es la CPU del host.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan los usos múltiples de
--host_cxxopt=<a string>
-
Opciones adicionales para pasar a gcc para las herramientas del host.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan los usos múltiples de
--host_features=<a string>
-
Las funciones proporcionadas se habilitarán o inhabilitarán de forma predeterminada para los destinos compilados en la configuración de ejecución. Si especificas -<feature>, se inhabilitará la función. Las funciones negativas siempre anulan las positivas.
Etiquetas:changes_inputs
,affects_outputs
--host_force_python=<PY2 or PY3>
valor predeterminado: consulta la descripción-
Anula la versión de Python para la configuración del host. Puede ser "PY2" o "PY3".
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan los usos múltiples de
--host_linkopt=<a string>
-
Opción adicional para pasar a gcc cuando se vinculan herramientas del host.
Etiquetas:action_command_lines
,affects_outputs
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
valor predeterminado: consulta la descripción-
Versión mínima de macOS compatible con los destinos de host. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan los usos múltiples de
--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>
-
Opciones adicionales para pasar de forma selectiva al compilador de C/C++ cuando se compilan ciertos archivos en las configuraciones de host o de ejecución. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,…,option_n. Aquí, regex_filter representa una lista de patrones de expresiones regulares de inclusión y exclusión (consulta también --instrumentation_filter), y option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe incluirse entre comillas con una barra diagonal inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos de gcc de todos los archivos .cc en //foo/, excepto bar.cc.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan los usos múltiples de
--host_swiftcopt=<a string>
-
Opciones adicionales para pasar a swiftc para las herramientas del host.
Etiquetas:action_command_lines
,affects_outputs
--[no]incompatible_avoid_conflict_dlls
predeterminado: "true"-
Si está habilitado, todas las bibliotecas de vínculos dinámicos (DLL) de C++ generadas por cc_library en Windows se cambiarán de nombre a name_{hash}.dll, donde hash se calcula en función de RepositoryName y la ruta del paquete de la DLL. Esta opción es útil cuando tienes un paquete que depende de varias cc_library con el mismo nombre (p. ej., //foo/bar1:utils y //foo/bar2:utils).
Etiquetas:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_merge_genfiles_directory
predeterminado: "true"-
Si es verdadero, el directorio genfiles se pliega en el directorio bin.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_use_host_features
predeterminado: "false"-
Si es verdadero, usa --features solo para la configuración de destino y --host_features para la configuración de ejecución.
Etiquetas:changes_inputs
,affects_outputs
,incompatible_change
--[no]incompatible_use_platforms_repo_for_constraints
predeterminado: "true"-
Si es verdadero, se quita la configuración de restricción de @bazel_tools.
Etiquetas:affects_outputs
,incompatible_change
--[no]instrument_test_targets
predeterminado: "false"-
Cuando la cobertura está habilitada, especifica si se deben considerar las reglas de prueba de instrumentación. Cuando se configura, se instrumentan las reglas de prueba incluidas por --instrumentation_filter. De lo contrario, las reglas de prueba siempre se excluyen de la instrumentación de cobertura.
Etiquetas:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
valor predeterminado: "-/javatests[/:],-/test/java[/:]"-
Cuando la cobertura está habilitada, solo se instrumentarán las reglas con nombres incluidos en el filtro basado en regex especificado. En su lugar, se excluyen las reglas que tienen el prefijo "-". Ten en cuenta que solo se instrumentan las reglas que no son de prueba, a menos que se habilite --instrument_test_targets.
Etiquetas:affects_outputs
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
valor predeterminado: consulta la descripción-
Versión mínima compatible de iOS para los simuladores y dispositivos de destino. Si no se especifica, se usa "ios_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan los usos múltiples de
--ios_multi_cpus=<comma-separated list of options>
-
Lista separada por comas de las arquitecturas con las que se compilará un ios_application. El resultado es un binario universal que contiene todas las arquitecturas especificadas.
Etiquetas:loses_incremental_state
,loading_and_analysis
--[no]legacy_whole_archive
predeterminado: "true"-
Obsoleto. Se reemplazó por --incompatible_remove_legacy_whole_archive (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener más detalles). Cuando está activado, usa --whole-archive para las reglas cc_binary que tienen linkshared=True y linkstatic=True o "-static" en linkopts. Esto es solo para la retrocompatibilidad. Una mejor alternativa es usar alwayslink=1 cuando sea necesario.
Etiquetas:action_command_lines
,affects_outputs
,deprecated
- Se acumulan los usos múltiples de
--linkopt=<a string>
-
Opción adicional para pasar a gcc durante la vinculación.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan los usos múltiples de
--ltobackendopt=<a string>
-
Opción adicional para pasar al paso de backend de LTO (en --features=thin_lto).
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan los usos múltiples de
--ltoindexopt=<a string>
-
Opción adicional para pasar al paso de indexación de LTO (en --features=thin_lto).
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan los usos múltiples de
--macos_cpus=<comma-separated list of options>
-
Lista separada por comas de las arquitecturas para las que se compilarán los archivos binarios de Apple macOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
valor predeterminado: consulta la descripción-
Versión mínima de macOS compatible con los destinos. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
--[no]objc_debug_with_GLIBCXX
predeterminado: "false"-
Si se configura y el modo de compilación se establece en "dbg", define GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC y GLIBCPP_CONCEPT_CHECKS.
Etiquetas:action_command_lines
--[no]objc_enable_binary_stripping
predeterminado: "false"-
Indica si se deben quitar los símbolos y el código no utilizado de los archivos binarios vinculados. Se realizará el despojo de binarios si se especifican esta marca y --compilation_mode=opt.
Etiquetas:action_command_lines
- Se acumulan los usos múltiples de
--objccopt=<a string>
-
Opciones adicionales para pasar a gcc cuando se compilan archivos de origen Objective-C/C++.
Etiquetas:action_command_lines
- Se acumulan los usos múltiples de
--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>
-
Opciones adicionales para pasar de forma selectiva a gcc cuando se compilan ciertos archivos. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,…,option_n. Aquí, regex_filter representa una lista de patrones de expresiones regulares de inclusión y exclusión (consulta también --instrumentation_filter), y option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe incluirse entre comillas con una barra diagonal inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos de gcc de todos los archivos cc en //foo/ excepto bar.cc.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan los usos múltiples de
--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>
-
Opciones adicionales para pasar de forma selectiva al backend de LTO (en --features=thin_lto) cuando se compilan ciertos objetos del backend. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,…,option_n. Aquí regex_filter representa una lista de patrones de expresiones regulares de inclusión y exclusión, y option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe incluirse entre comillas con una barra diagonal inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos del backend de LTO de todos los archivos .o en //foo/, excepto bar.o.
Etiquetas:action_command_lines
,affects_outputs
--platform_suffix=<a string>
valor predeterminado: consulta la descripción-
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas:loses_incremental_state
,affects_outputs
,loading_and_analysis
--propeller_optimize=<a build target label>
valor predeterminado: consulta la descripción-
Usa la información del perfil de Propeller para optimizar el destino de compilación.Un perfil de Propeller debe constar de al menos uno de los dos archivos, un perfil de cc y un perfil de ld. Esta marca acepta una etiqueta de compilación que debe hacer referencia a los archivos de entrada del perfil de Propeller. Por ejemplo, el archivo BUILD que define la etiqueta, en a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)Es posible que se deba agregar una directiva exports_files al paquete correspondiente para que Bazel pueda ver estos archivos. La opción se debe usar de la siguiente manera: --propeller_optimize=//a/b:propeller_profile
Etiquetas:action_command_lines
,affects_outputs
--propeller_optimize_absolute_cc_profile=<a string>
valor predeterminado: consulta la descripción-
Nombre de ruta de acceso absoluta del archivo cc_profile para las compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
valor predeterminado: consulta la descripción-
Nombre de ruta de acceso absoluta del archivo ld_profile para las compilaciones optimizadas con Propeller.
Etiquetas:affects_outputs
--run_under=<a prefix in front of command>
valor predeterminado: consulta la descripción-
Prefijo que se insertará antes de los ejecutables para los comandos "test" y "run". Si el valor es "foo -bar" y la línea de comandos de ejecución es "test_binary -baz", la línea de comandos final es "foo -bar test_binary -baz".También puede ser una etiqueta para un destino ejecutable. Algunos ejemplos son "valgrind", "strace", "strace -c", "valgrind --quiet --num-callers=20", "//package:target" y "//package:target --options".
Etiquetas:action_command_lines
-
Si es verdadero, las bibliotecas nativas que contienen la misma funcionalidad se compartirán entre diferentes destinos.
Etiquetas:loading_and_analysis
,affects_outputs
--[no]stamp
predeterminado: "false"-
Sella los archivos binarios con la fecha, el nombre de usuario, el nombre de host, la información del espacio de trabajo, etcétera.
Etiquetas:affects_outputs
- Valor predeterminado de
--strip=<always, sometimes or never>
: "sometimes" -
Especifica si se deben quitar los archivos binarios y las bibliotecas compartidas (con "-Wl,--strip-debug"). El valor predeterminado "sometimes" significa que se quita solo si --compilation_mode=fastbuild.
Etiquetas:affects_outputs
- Se acumulan los usos múltiples de
--stripopt=<a string>
-
Opciones adicionales para pasar a strip cuando se genera un objeto binario "<name>.stripped".
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan los usos múltiples de
--swiftcopt=<a string>
-
Opciones adicionales para pasar a la compilación de Swift.
Etiquetas:action_command_lines
- Se acumulan los usos múltiples de
--tvos_cpus=<comma-separated list of options>
-
Lista separada por comas de las arquitecturas para las que se compilarán los archivos binarios de tvOS de Apple.
Etiquetas:loses_incremental_state
,loading_and_analysis
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
valor predeterminado: consulta la descripción-
Versión mínima compatible de tvOS para los simuladores y dispositivos de destino. Si no se especifica, se usa "tvos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan los usos múltiples de
--visionos_cpus=<comma-separated list of options>
-
Lista separada por comas de las arquitecturas para las que se compilarán los archivos binarios de Apple visionOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Se acumulan los usos múltiples de
--watchos_cpus=<comma-separated list of options>
-
Lista separada por comas de las arquitecturas para las que se compilarán los archivos binarios de watchOS de Apple.
Etiquetas:loses_incremental_state
,loading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
valor predeterminado: consulta la descripción-
Versión mínima compatible de watchOS para los simuladores y dispositivos de destino. Si no se especifica, se usa "watchos_sdk_version".
Etiquetas:loses_incremental_state
--xbinary_fdo=<a build target label>
valor predeterminado: consulta la descripción-
Usa la información del perfil de XbinaryFDO para optimizar la compilación. Especifica el nombre del perfil predeterminado de varias plataformas. Cuando la opción se usa junto con --fdo_instrument/--fdo_optimize/--fdo_profile, esas opciones siempre prevalecerán como si xbinary_fdo nunca se hubiera especificado.
Etiquetas:affects_outputs
- Opciones que afectan la rigidez con la que Bazel aplica las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
- Valor predeterminado de
--auto_cpu_environment_group=<a build target label>
: "" -
Declara el environment_group que se usará para asignar automáticamente los valores de cpu a los valores de target_environment.
Etiquetas:changes_inputs
,loading_and_analysis
,experimental
--[no]check_licenses
predeterminado: "false"-
Verifica que las restricciones de licencias impuestas por los paquetes dependientes no entren en conflicto con los modos de distribución de los destinos que se compilan. De forma predeterminada, no se verifican las licencias.
Etiquetas:build_file_semantics
--[no]check_visibility
predeterminado: "true"-
Si se inhabilita, los errores de visibilidad en las dependencias de destino se degradan a advertencias.
Etiquetas:build_file_semantics
--[no]desugar_for_android
predeterminado: "true"-
Indica si se debe aplicar desugar al código de bytes de Java 8 antes de convertirlo en dex.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]desugar_java8_libs
predeterminado: "false"-
Indica si se deben incluir las bibliotecas de Java 8 compatibles en las apps para dispositivos heredados.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]enforce_constraints
predeterminado: "true"-
Verifica los entornos con los que es compatible cada destino y genera errores si algún destino tiene dependencias que no admiten los mismos entornos.
Etiquetas:build_file_semantics
--[no]experimental_allow_android_library_deps_without_srcs
predeterminado: "false"-
Es una marca para ayudar a la transición de permitir a no permitir reglas android_library sin srcs con dependencias. El depósito debe limpiarse para lanzar esta función de forma predeterminada.
Etiquetas:eagerness_to_exit
,loading_and_analysis
--[no]experimental_check_desugar_deps
predeterminado: "true"-
Indica si se debe verificar la desazucaración correcta a nivel binario de Android.
Etiquetas:eagerness_to_exit
,loading_and_analysis
,experimental
--experimental_import_deps_checking=<off, warning or error>
predeterminado: "OFF"-
Cuando está habilitado, verifica si las dependencias de un aar_import están completas. Esta aplicación de la política puede interrumpir la compilación o simplemente generar advertencias.
Etiquetas:loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
predeterminado: "default"-
Si es verdadero, verifica que un destino de Java declare explícitamente todos los destinos que se usan directamente como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files
predeterminado: "false"-
Si está habilitado, verifica testonly para los destinos de requisitos previos que son archivos de salida buscando el testonly de la regla de generación. Esto coincide con la verificación de visibilidad.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_disable_native_android_rules
predeterminado: "false"-
Si se habilita, se inhabilita el uso directo de las reglas nativas de Android. Usa las reglas de Starlark para Android de https://github.com/bazelbuild/rules_android.
Etiquetas:eagerness_to_exit
,incompatible_change
--[no]incompatible_disable_native_apple_binary_rule
predeterminado: "false"-
No realiza ninguna operación. Se mantiene aquí para la retrocompatibilidad.
Etiquetas:eagerness_to_exit
,incompatible_change
--[no]incompatible_force_strict_header_check_from_starlark
predeterminado: "true"-
Si está habilitado, establece la verificación estricta de encabezados en la API de Starlark.
Etiquetas:loading_and_analysis
,changes_inputs
,incompatible_change
--[no]incompatible_validate_top_level_header_inclusions
predeterminado: "true"-
Si es verdadero, Bazel también validará las inclusiones de encabezado de directorio de nivel superior (consulta https://github.com/bazelbuild/bazel/issues/10047 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]strict_filesets
predeterminado: "false"-
Si esta opción está habilitada, los conjuntos de archivos que cruzan los límites del paquete se informan como errores. No funciona cuando check_fileset_dependencies_recursively está inhabilitado.
Etiquetas:build_file_semantics
,eagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default>
predeterminado: "error"-
A menos que esté DESACTIVADO, verifica que un destino proto_library declare explícitamente todos los destinos utilizados directamente como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
--strict_public_imports=<off, warn, error, strict or default>
predeterminado: "off"-
A menos que esté DESACTIVADO, verifica que un destino proto_library declare de forma explícita todos los destinos que se usan en "import public" como exportados.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
--[no]strict_system_includes
predeterminado: "false"-
Si es verdadero, también se deben declarar los encabezados que se encuentran a través de las rutas de inclusión del sistema (-isystem).
Etiquetas:loading_and_analysis
,eagerness_to_exit
- Se acumulan los usos múltiples de
--target_environment=<a build target label>
-
Declara el entorno de destino de esta compilación. Debe ser una referencia de etiqueta a una regla "environment". Si se especifica, todos los objetivos de nivel superior deben ser compatibles con este entorno.
Etiquetas:changes_inputs
- Opciones que afectan los resultados de la firma de una compilación:
--apk_signing_method=<v1, v2, v1_v2 or v4>
predeterminado: "v1_v2"-
Implementación que se usará para firmar APKs
Etiquetas:action_command_lines
,affects_outputs
,loading_and_analysis
--[no]device_debug_entitlements
predeterminado: "true"-
Si se configura y el modo de compilación no es "opt", las apps en Objective-C incluirán derechos de depuración cuando se firmen.
Etiquetas:changes_inputs
--ios_signing_cert_name=<a string>
valor predeterminado: consulta la descripción-
Nombre del certificado que se usará para la firma de iOS. Si no se configura, se volverá al perfil de aprovisionamiento. Puede ser la preferencia de identidad del llavero del certificado o una subcadena del nombre común del certificado, según la página de manual de codesign (IDENTIDADES DE FIRMA).
Etiquetas:action_command_lines
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]incompatible_disallow_legacy_py_provider
predeterminado: "true"-
No-op, se quitará pronto.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones que rigen el comportamiento del entorno de prueba o del ejecutor de pruebas:
--[no]allow_analysis_failures
predeterminado: "false"-
Si es verdadero, un error de análisis de un destino de regla hace que el destino propague una instancia de AnalysisFailureInfo que contiene la descripción del error, en lugar de generar un error de compilación.
Etiquetas:loading_and_analysis
,experimental
--analysis_testing_deps_limit=<an integer>
predeterminado: "2000"-
Establece la cantidad máxima de dependencias transitivas a través de un atributo de regla con una transición de configuración for_analysis_testing. Si se supera este límite, se generará un error de regla.
Etiquetas:loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure
predeterminado: "false"-
Si es verdadero, los errores de la acción dex2oat harán que se interrumpa la compilación en lugar de ejecutar dex2oat durante el tiempo de ejecución de la prueba.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_android_use_parallel_dex2oat
predeterminado: "false"-
Usa dex2oat en paralelo para acelerar android_test.
Etiquetas:loading_and_analysis
,host_machine_resource_optimizations
,experimental
--[no]ios_memleaks
predeterminado: "false"-
Habilita la verificación de pérdidas de memoria en los destinos de ios_test.
Etiquetas:action_command_lines
--ios_simulator_device=<a string>
valor predeterminado: consulta la descripción-
Es el dispositivo que se simulará cuando se ejecute una aplicación para iOS en el simulador, p.ej., "iPhone 6". Puedes obtener una lista de dispositivos ejecutando "xcrun simctl list devicetypes" en la máquina en la que se ejecutará el simulador.
Etiquetas:test_runner
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
valor predeterminado: consulta la descripción-
Versión de iOS que se ejecutará en el simulador cuando se ejecute o pruebe. Se ignora para las reglas de ios_test si se especifica un dispositivo objetivo en la regla.
Etiquetas:test_runner
- Se acumulan los usos múltiples de
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
- Especifica la cantidad de veces que se ejecutará cada prueba. Si alguno de esos intentos falla por algún motivo, se considera que toda la prueba falló. Normalmente, el valor especificado es solo un número entero. Ejemplo: --runs_per_test=3 ejecutará todas las pruebas 3 veces. Sintaxis alternativa: regex_filter@runs_per_test. Aquí runs_per_test representa un valor entero y regex_filter representa una lista de patrones de expresiones regulares de inclusión y exclusión (consulta también --instrumentation_filter). Ejemplo: --runs_per_test=//foo/.*,-//foo/bar/.*@3 ejecuta todas las pruebas en //foo/ excepto las que se encuentran en foo/bar tres veces. Esta opción se puede pasar varias veces. Tiene prioridad el argumento que se pasó más recientemente y que coincide. Si no hay coincidencias, la prueba solo se ejecuta una vez.
- Se acumulan los usos múltiples de
--test_env=<a 'name=value' assignment with an optional value part>
-
Especifica variables de entorno adicionales que se insertarán en el entorno del ejecutor de pruebas. Las variables se pueden especificar por nombre, en cuyo caso su valor se leerá del entorno del cliente de Bazel, o por el par nombre=valor. Esta opción se puede usar varias veces para especificar varias variables. Solo se usa con el comando "bazel test".
Etiquetas:test_runner
- Valor predeterminado de
--test_timeout=<a single integer or comma-separated list of 4 integers>
: "-1" - Anula los valores predeterminados de tiempo de espera de la prueba (en segundos). Si se especifica un solo valor de número entero positivo, se anularán todas las categorías. Si se especifican 4 números enteros separados por comas, se anularán los tiempos de espera para corto, moderado, largo y eterno (en ese orden). En cualquiera de las dos formas, un valor de -1 le indica a Blaze que use sus tiempos de espera predeterminados para esa categoría.
--tvos_simulator_device=<a string>
valor predeterminado: consulta la descripción-
El dispositivo que se simulará cuando se ejecute una aplicación para tvOS en el simulador, p.ej., "Apple TV 1080p". Puedes obtener una lista de dispositivos ejecutando "xcrun simctl list devicetypes" en la máquina en la que se ejecutará el simulador.
Etiquetas:test_runner
--tvos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
valor predeterminado: consulta la descripción-
Es la versión de tvOS que se ejecutará en el simulador cuando se ejecute o pruebe.
Etiquetas:test_runner
--watchos_simulator_device=<a string>
valor predeterminado: consulta la descripción-
El dispositivo que se simulará cuando se ejecute una aplicación para watchOS en el simulador, p.ej., "Apple Watch - 38mm". Puedes obtener una lista de dispositivos ejecutando "xcrun simctl list devicetypes" en la máquina en la que se ejecutará el simulador.
Etiquetas:test_runner
--watchos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
valor predeterminado: consulta la descripción-
Versión de watchOS que se ejecutará en el simulador cuando se ejecute o pruebe.
Etiquetas:test_runner
--[no]zip_undeclared_test_outputs
predeterminado: "true"-
Si es verdadero, los resultados de las pruebas no declarados se archivarán en un archivo ZIP.
Etiquetas:test_runner
- Opciones relacionadas con la semántica y el resultado de la búsqueda:
--aspect_deps=<off, conservative or precise>
valor predeterminado: "conservative"-
Cómo resolver las dependencias de aspectos cuando el formato de salida es uno de {xml,proto,record}. "off" significa que no se resuelve ninguna dependencia de aspectos; "conservative" (el valor predeterminado) significa que se agregan todas las dependencias de aspectos declaradas, independientemente de si se les asigna la clase de regla de dependencias directas; "precise" significa que solo se agregan aquellos aspectos que posiblemente estén activos dada la clase de regla de las dependencias directas. Ten en cuenta que el modo preciso requiere cargar otros paquetes para evaluar un solo objetivo, lo que lo hace más lento que los otros modos. También ten en cuenta que incluso el modo preciso no es completamente preciso: la decisión de calcular un aspecto se toma en la fase de análisis, que no se ejecuta durante "bazel query".
Etiquetas:build_file_semantics
--[no]consistent_labels
predeterminado: "false"-
Si está habilitado, cada comando de consulta emite etiquetas como si se aplicara la función <code>str</code> de Starlark a una instancia de <code>Label</code>. Esto es útil para las herramientas que necesitan coincidir con el resultado de diferentes comandos de consulta o etiquetas emitidas por reglas. Si no está habilitado, los formateadores de salida pueden emitir nombres de repositorio aparentes (relativos al repositorio principal) para que la salida sea más legible.
Etiquetas:terminal_output
--[no]graph:factored
predeterminado: "true"-
Si es verdadero, el gráfico se emitirá "factorizado", es decir, los nodos topológicamente equivalentes se combinarán y sus etiquetas se concatenarán. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--graph:node_limit=<an integer>
valor predeterminado: "512"-
Es la longitud máxima de la cadena de etiqueta para un nodo de gráfico en el resultado. Las etiquetas más largas se truncarán. El valor -1 significa que no se truncarán. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--[no]implicit_deps
predeterminado: "true"-
Si está habilitado, las dependencias implícitas se incluirán en el gráfico de dependencias sobre el que opera la consulta. Una dependencia implícita es aquella que no se especifica de forma explícita en el archivo BUILD, pero que Bazel agrega. En el caso de cquery, esta opción controla el filtrado de las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
--[no]include_aspects
predeterminado: "true"-
aquery, cquery: Indica si se deben incluir las acciones generadas por aspectos en el resultado. query: No es una operación (los aspectos siempre se siguen).
Etiquetas:terminal_output
--[no]incompatible_display_source_file_location
predeterminado: "true"-
Es verdadero de forma predeterminada y muestra el destino del archivo fuente. Si es verdadero, muestra la ubicación de la línea 1 de los archivos fuente en los resultados de ubicación. Esta marca solo existe para fines de migración.
Etiquetas:terminal_output
,incompatible_change
--[no]incompatible_package_group_includes_double_slash
predeterminado: "true"-
Si está habilitado, cuando se genere el atributo `packages` de package_group, no se omitirá el `//` inicial.
Etiquetas:terminal_output
,incompatible_change
--[no]infer_universe_scope
predeterminado: "false"-
Si se configura y no se configura --universe_scope, se inferirá un valor de --universe_scope como la lista de patrones de destino únicos en la expresión de búsqueda. Ten en cuenta que el valor de --universe_scope que se infiere para una expresión de búsqueda que usa funciones con alcance del universo (p.ej., "allrdeps") podría no ser el que deseas, por lo que debes usar esta opción solo si sabes lo que haces. Consulta https://bazel.build/reference/query#sky-query para obtener detalles y ejemplos. Si se establece --universe_scope, se ignora el valor de esta opción. Nota: Esta opción solo se aplica a `query` (es decir, no a `cquery`).
Etiquetas:loading_and_analysis
--[no]line_terminator_null
predeterminado: "false"-
Indica si cada formato termina con \0 en lugar de un salto de línea.
Etiquetas:terminal_output
--[no]nodep_deps
predeterminado: "true"-
Si está habilitado, las dependencias de los atributos "nodep" se incluirán en el gráfico de dependencias sobre el que opera la consulta. Un ejemplo común de un atributo "nodep" es "visibilidad". Ejecuta y analiza el resultado de `info build-language` para obtener información sobre todos los atributos "nodep" en el lenguaje de compilación.
Etiquetas:build_file_semantics
--output=<a string>
predeterminado: "label"-
Es el formato en el que se deben imprimir los resultados de cquery. Los valores permitidos para cquery son: label, label_kind, textproto, transitions, proto y jsonproto. Si seleccionas "transiciones", también debes especificar la opción --transitions=(lite|full).
Etiquetas:terminal_output
--[no]proto:default_values
predeterminado: "true"-
Si es verdadero, se incluyen los atributos cuyo valor no se especifica de forma explícita en el archivo BUILD; de lo contrario, se omiten. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
--[no]proto:definition_stack
predeterminado: "false"-
Propaga el campo proto definition_stack, que registra para cada instancia de regla la pila de llamadas de Starlark en el momento en que se definió la clase de la regla.
Etiquetas:terminal_output
--[no]proto:flatten_selects
predeterminado: "true"-
Si está habilitado, los atributos configurables creados por select() se aplanan. En el caso de los tipos de lista, la representación aplanada es una lista que contiene cada valor del mapa de selección exactamente una vez. Los tipos escalares se aplanan a nulos.
Etiquetas:build_file_semantics
--[no]proto:include_configurations
predeterminado: "true"-
Si está habilitado, el resultado de proto incluirá información sobre las configuraciones. Cuando se inhabilita,el formato de salida del arvo de .proto de cquery se parece al formato de salida de la consulta.
Etiquetas:affects_outputs
--[no]proto:include_synthetic_attribute_hash
predeterminado: "false"-
Indica si se debe calcular y completar el atributo $internal_attr_hash.
Etiquetas:terminal_output
--[no]proto:instantiation_stack
predeterminado: "false"-
Propaga la pila de llamadas de instanciación de cada regla. Ten en cuenta que esto requiere que la pila esté presente.
Etiquetas:terminal_output
--[no]proto:locations
predeterminado: "true"-
Indica si se debe generar información de ubicación en la salida de proto.
Etiquetas:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
predeterminado: "all"-
Lista de atributos separados por comas que se incluirán en el resultado. La configuración predeterminada incluye todos los atributos. Se establece en una cadena vacía para no generar ningún atributo. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
--[no]proto:rule_inputs_and_outputs
predeterminado: "true"-
Indica si se deben propagar los campos rule_input y rule_output.
Etiquetas:terminal_output
- Valor predeterminado de
--query_file=<a string>
: "" -
Si se configura, la consulta leerá la consulta del archivo que se nombra aquí, en lugar de hacerlo desde la línea de comandos. Es un error especificar un archivo aquí y una consulta de línea de comandos.
Etiquetas:changes_inputs
--[no]relative_locations
predeterminado: "false"-
Si es verdadero, la ubicación de los archivos BUILD en las salidas de XML y proto será relativa. De forma predeterminada, la salida de ubicación es una ruta de acceso absoluta y no será coherente en todas las máquinas. Puedes establecer esta opción como verdadera para obtener un resultado coherente en todas las máquinas.
Etiquetas:terminal_output
--show_config_fragments=<off, direct or transitive>
predeterminado: "off"-
Muestra los fragmentos de configuración que requiere una regla y sus dependencias transitivas. Esto puede ser útil para evaluar cuánto se puede reducir un gráfico de destino configurado.
Etiquetas:affects_outputs
- Valor predeterminado de
--starlark:expr=<a string>
: "" -
Es una expresión de Starlark para dar formato a cada destino configurado en el modo --output=starlark de cquery. El destino configurado está vinculado a "destino". Si no se especifican --starlark:expr ni --starlark:file, esta opción se establecerá de forma predeterminada en "str(target.label)". Es un error especificar tanto --starlark:expr como --starlark:file.
Etiquetas:terminal_output
- Valor predeterminado de
--starlark:file=<a string>
: "" -
Nombre de un archivo que define una función de Starlark llamada "format", de un argumento, que se aplica a cada destino configurado para darle formato como una cadena. Es un error especificar tanto --starlark:expr como --starlark:file. Consulta la ayuda de --output=starlark para obtener más detalles.
Etiquetas:terminal_output
--[no]tool_deps
predeterminado: "true"-
Consulta: Si está inhabilitada, las dependencias de los destinos de "configuración del host" o "ejecución" no se incluirán en el gráfico de dependencias sobre el que opera la consulta. Un borde de dependencia de "configuración del host", como el que va de cualquier regla "proto_library" al compilador de Protocolos, suele apuntar a una herramienta que se ejecuta durante la compilación en lugar de a una parte del mismo programa "target".
Cquery: Si está inhabilitado, filtra todos los destinos configurados que cruzan una transición de host o de ejecución desde el destino de nivel superior que descubrió este destino configurado. Esto significa que, si el destino de nivel superior está en la configuración de destino, solo se devolverán los destinos configurados que también estén en la configuración de destino. Si el destino de nivel superior está en la configuración del host, solo se devolverán los destinos configurados del host. Esta opción NO excluirá las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
--transitions=<full, lite or none>
predeterminado: "none"-
Es el formato en el que cquery imprimirá la información de transición.
Etiquetas:affects_outputs
- Valor predeterminado de
--universe_scope=<comma-separated list of options>
: "" -
Es un conjunto de patrones de segmentación (aditivos y sustractivos) separados por comas. La consulta se puede realizar en el universo definido por el cierre transitivo de los destinos especificados. Esta opción se usa para los comandos query y cquery.
En el caso de cquery, la entrada de esta opción son los destinos en los que se compilan todas las respuestas, por lo que esta opción puede afectar las configuraciones y las transiciones. Si no se especifica esta opción, se supone que los destinos de nivel superior son los que se analizan a partir de la expresión de búsqueda. Nota: En el caso de cquery, no especificar esta opción puede provocar que se interrumpa la compilación si los destinos analizados a partir de la expresión de la consulta no se pueden compilar con las opciones de nivel superior.
Etiquetas:loading_and_analysis
- Opciones que activan optimizaciones del tiempo de compilación:
--[no]collapse_duplicate_defines
predeterminado: "false"-
Cuando está habilitado, los --defines redundantes se quitarán al principio de la compilación. Esto evita la pérdida innecesaria de la caché de análisis para ciertos tipos de compilaciones equivalentes.
Etiquetas:loading_and_analysis
,loses_incremental_state
--[no]experimental_filter_library_jar_with_program_jar
predeterminado: "false"-
Filtra el ProgramJar de ProGuard para quitar las clases que también estén presentes en el LibraryJar.
Etiquetas:action_command_lines
--[no]experimental_inmemory_dotd_files
predeterminado: "true"-
Si está habilitado, los archivos .d de C++ se pasarán por la memoria directamente desde los nodos de compilación remotos en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_inmemory_jdeps_files
predeterminado: "true"-
Si está habilitado, los archivos de dependencia (.jdeps) generados a partir de las compilaciones de Java se pasarán a través de la memoria directamente desde los nodos de compilación remotos en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_objc_include_scanning
predeterminado: "false"-
Indica si se debe realizar el análisis de inclusión para Objective-C/C++.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
--[no]experimental_parse_headers_skipped_if_corresponding_srcs_found
predeterminado: "false"-
Si está habilitada, la función parse_headers no crea una acción de compilación de encabezado separada si se encuentra una fuente con el mismo nombre base en el mismo destino.
Etiquetas:loading_and_analysis
,affects_outputs
--[no]experimental_retain_test_configuration_across_testonly
predeterminado: "false"-
Cuando está habilitado, --trim_test_configuration no recortará la configuración de prueba para las reglas marcadas como testonly=1. Esto tiene como objetivo reducir los problemas de conflicto de acciones cuando las reglas que no son de prueba dependen de las reglas cc_test. No tiene efecto si --trim_test_configuration es falso.
Etiquetas:loading_and_analysis
,loses_incremental_state
--[no]experimental_starlark_cc_import
predeterminado: "false"-
Si está habilitado, se puede usar la versión de Starlark de cc_import.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_unsupported_and_brittle_include_scanning
predeterminado: "false"-
Indica si se deben reducir las entradas a la compilación de C/C++ analizando las líneas #include de los archivos de entrada. Esto puede mejorar el rendimiento y la incrementalidad, ya que disminuye el tamaño de los árboles de entrada de compilación. Sin embargo, también puede interrumpir las compilaciones porque el analizador de inclusión no implementa por completo la semántica del preprocesador de C. En particular, no comprende las directivas #include dinámicas y omite la lógica condicional del preprocesador. Úsala bajo tu propia responsabilidad. Se cerrarán todos los problemas relacionados con este parámetro que se registren.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
--[no]incremental_dexing
predeterminado: "true"-
Realiza la mayor parte del trabajo de dexing por separado para cada archivo Jar.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]objc_use_dotd_pruning
predeterminado: "true"-
Si se configura, los archivos .d que emite clang se usarán para reducir el conjunto de entradas que se pasan a las compilaciones de objc.
Etiquetas:changes_inputs
,loading_and_analysis
--[no]process_headers_in_dependencies
predeterminado: "false"-
Cuando se compila un destino //a:a, se procesan los encabezados en todos los destinos de los que depende //a:a (si el procesamiento de encabezados está habilitado para la cadena de herramientas).
Etiquetas:execution
--[no]trim_test_configuration
predeterminado: "true"-
Cuando se habilita, las opciones relacionadas con las pruebas se borrarán debajo del nivel superior de la compilación. Cuando esta marca está activa, las pruebas no se pueden compilar como dependencias de reglas que no son de prueba, pero los cambios en las opciones relacionadas con las pruebas no harán que se vuelvan a analizar las reglas que no son de prueba.
Etiquetas:loading_and_analysis
,loses_incremental_state
--[no]use_singlejar_apkbuilder
predeterminado: "true"-
Esta opción está obsoleta. Ahora es una operación nula y se quitará pronto.
Etiquetas:loading_and_analysis
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Valor predeterminado de
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "-.*" -
Imprime información de depuración durante la resolución de la cadena de herramientas. La marca toma una regex, que se verifica con los tipos de cadenas de herramientas y los objetivos específicos para ver cuáles depurar. Se pueden separar varias expresiones regulares con comas y, luego, se verifica cada una por separado. Nota: El resultado de esta marca es muy complejo y es probable que solo sea útil para los expertos en la resolución de cadenas de herramientas.
Etiquetas:terminal_output
- Opciones que especifican o alteran una entrada genérica para un comando de Bazel que no se incluye en otras categorías.:
- Se acumulan los usos múltiples de
--flag_alias=<a 'name=value' flag alias>
-
Establece un nombre abreviado para una marca de Starlark. Toma un solo par clave-valor en el formato "<clave>=<valor>" como argumento.
Etiquetas:changes_inputs
--[no]incompatible_default_to_explicit_init_py
predeterminado: "false"-
Esta marca cambia el comportamiento predeterminado para que los archivos __init__.py ya no se creen automáticamente en los archivos ejecutables de los destinos de Python. Específicamente, cuando un destino py_binary o py_test tiene legacy_create_init establecido en "auto" (el valor predeterminado), se trata como falso si y solo si se establece esta marca. Consulta https://github.com/bazelbuild/bazel/issues/10076.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_py2_outputs_are_suffixed
predeterminado: "true"-
Si es verdadero, los destinos compilados en la configuración de Python 2 aparecerán en una raíz de salida que incluye el sufijo "-py2", mientras que los destinos compilados para Python 3 aparecerán en una raíz sin sufijo relacionado con Python. Esto significa que el vínculo simbólico de conveniencia `bazel-bin` apuntará a destinos de Python 3 en lugar de Python 2. Si habilitas esta opción, también se recomienda habilitar `--incompatible_py3_is_default`.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_py3_is_default
predeterminado: "true"-
Si es verdadero, los destinos `py_binary` y `py_test` que no configuren su atributo `python_version` (o `default_python_version`) se establecerán de forma predeterminada en PY3 en lugar de PY2. Si estableces esta marca, también se recomienda establecer `--incompatible_py2_outputs_are_suffixed`.
Etiquetas:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_use_python_toolchains
predeterminado: "true"-
Si se establece como verdadero, las reglas ejecutables de Python nativo usarán el entorno de ejecución de Python especificado por la cadena de herramientas de Python, en lugar del entorno de ejecución proporcionado por marcas heredadas como --python_top.
Etiquetas:loading_and_analysis
,incompatible_change
--python_version=<PY2 or PY3>
valor predeterminado: consulta la descripción-
Modo de versión principal de Python, ya sea "PY2" o "PY3". Ten en cuenta que los objetivos "py_binary" y "py_test" anulan este parámetro (incluso si no especifican una versión de forma explícita), por lo que, por lo general, no hay muchos motivos para proporcionar esta marca.
Etiquetas:loading_and_analysis
,affects_outputs
,explicit_in_output_path
- Opciones varias, no clasificadas de otra manera.:
--[no]cache_test_results
[-t
] default: "auto"- Si se configura como "auto", Bazel vuelve a ejecutar una prueba solo si se cumplen las siguientes condiciones: (1) Bazel detecta cambios en la prueba o sus dependencias, (2) la prueba se marca como externa, (3) se solicitaron varias ejecuciones de prueba con --runs_per_test o(4) la prueba falló anteriormente. Si se configura como “sí”, Bazel almacena en caché todos los resultados de las pruebas, excepto las que se marcan como externas. Si se configura como "no", Bazel no almacena en caché ningún resultado de la prueba.
--[no]experimental_cancel_concurrent_tests
predeterminado: "false"-
Si es verdadero, Blaze cancelará las pruebas que se ejecuten de forma simultánea en la primera ejecución exitosa. Esto solo es útil en combinación con --runs_per_test_detects_flakes.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_fetch_all_coverage_outputs
predeterminado: "false"-
Si es verdadero, Bazel recupera el directorio completo de datos de cobertura para cada prueba durante una ejecución de cobertura.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_generate_llvm_lcov
predeterminado: "false"-
Si es verdadero, la cobertura de clang generará un informe de LCOV.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_j2objc_header_map
predeterminado: "true"- Indica si se debe generar el mapa de encabezado de J2ObjC en paralelo con la transpilación de J2ObjC.
--[no]experimental_j2objc_shorter_header_path
predeterminado: "false"-
Indica si se debe generar con una ruta de encabezado más corta (usa "_ios" en lugar de "_j2objc").
Etiquetas:affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
predeterminado: "javabuilder"- Habilita rutas de acceso de clase reducidas para las compilaciones de Java.
--[no]experimental_limit_android_lint_to_android_constrained_java
predeterminado: "false"-
Limita --experimental_run_android_lint_on_java_rules a las bibliotecas compatibles con Android.
Etiquetas:affects_outputs
--[no]experimental_run_android_lint_on_java_rules
predeterminado: "false"-
Indica si se deben validar las fuentes java_*.
Etiquetas:affects_outputs
--[no]explicit_java_test_deps
predeterminado: "false"- Especifica de forma explícita una dependencia de JUnit o Hamcrest en un java_test en lugar de obtenerla accidentalmente de las dependencias de TestRunner. Por el momento, solo funciona para Bazel.
--host_java_launcher=<a build target label>
valor predeterminado: consulta la descripción- Es el launcher de Java que usan las herramientas que se ejecutan durante una compilación.
- Se acumulan los usos múltiples de
--host_javacopt=<a string>
- Opciones adicionales para pasar a javac cuando se compilan herramientas que se ejecutan durante una compilación.
- Se acumulan los usos múltiples de
--host_jvmopt=<a string>
- Opciones adicionales para pasar a la VM de Java cuando se compilan herramientas que se ejecutan durante la compilación. Estas opciones se agregarán a las opciones de inicio de la VM de cada destino java_binary.
--[no]incompatible_check_sharding_support
predeterminado: "false"-
Si es verdadero, Bazel fallará una prueba fragmentada si el ejecutor de pruebas no indica que admite el fragmentado tocando el archivo en la ruta de TEST_SHARD_STATUS_FILE. Si es falso, un ejecutor de pruebas que no admite la fragmentación hará que todas las pruebas se ejecuten en cada fragmento.
Etiquetas:incompatible_change
--[no]incompatible_exclusive_test_sandboxed
predeterminado: "false"-
Si es verdadero, las pruebas exclusivas se ejecutarán con la estrategia de zona de pruebas. Agrega la etiqueta "local" para forzar una ejecución de prueba exclusiva de forma local.
Etiquetas:incompatible_change
--[no]incompatible_strict_action_env
predeterminado: "false"-
Si es verdadero, Bazel usa un entorno con un valor estático para PATH y no hereda LD_LIBRARY_PATH. Usa --action_env=ENV_VARIABLE si deseas heredar variables de entorno específicas del cliente, pero ten en cuenta que esto puede impedir el almacenamiento en caché entre usuarios si se usa una caché compartida.
Etiquetas:loading_and_analysis
,incompatible_change
- Se acumulan los usos múltiples de
--j2objc_translation_flags=<comma-separated list of options>
- Opciones adicionales para pasar a la herramienta J2ObjC.
--java_debug
-
Hace que la máquina virtual de Java de una prueba de Java espere una conexión de un depurador compatible con JDWP (como jdb) antes de iniciar la prueba. Implica -test_output=streamed.
Se expande a:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
--[no]java_deps
predeterminado: "true"- Genera información de dependencia (por ahora, classpath de tiempo de compilación) por destino de Java.
--[no]java_header_compilation
predeterminado: "true"- Compila archivos .ijar directamente desde la fuente.
--java_language_version=<a string>
predeterminado: "8"- La versión del lenguaje Java
--java_launcher=<a build target label>
valor predeterminado: consulta la descripción- Es el lanzador de Java que se usará cuando se compilen archivos binarios de Java. Si esta marca se establece en la cadena vacía, se usa el iniciador del JDK. El atributo "launcher" anula esta marca.
--java_runtime_version=<a string>
valor predeterminado: "local_jdk"- La versión del entorno de ejecución de Java
- Se acumulan los usos múltiples de
--javacopt=<a string>
- Opciones adicionales para pasar a javac.
- Se acumulan los usos múltiples de
--jvmopt=<a string>
- Opciones adicionales para pasar a la JVM de Java. Estas opciones se agregarán a las opciones de inicio de la VM de cada destino java_binary.
--legacy_main_dex_list_generator=<a build target label>
valor predeterminado: consulta la descripción- Especifica un archivo binario que se usará para generar la lista de clases que deben estar en el archivo dex principal cuando se compile multidex heredado.
- Se acumulan los usos múltiples de
--plugin=<a build target label>
- Son los complementos que se usarán en la compilación. Actualmente, funciona con java_plugin.
--proguard_top=<a build target label>
valor predeterminado: consulta la descripción- Especifica qué versión de ProGuard se usará para quitar código cuando se compile un archivo binario de Java.
--proto_compiler=<a build target label>
default: "@bazel_tools//tools/proto:protoc"-
Es la etiqueta del compilador de .proto.
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
default: "@bazel_tools//tools/proto:cc_toolchain"-
Etiqueta de proto_lang_toolchain() que describe cómo compilar protos de C++
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
valor predeterminado: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"-
Etiqueta de proto_lang_toolchain() que describe cómo compilar protos de j2objc
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
default: "@bazel_tools//tools/proto:java_toolchain"-
Etiqueta de proto_lang_toolchain() que describe cómo compilar protos de Java
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
default: "@bazel_tools//tools/proto:javalite_toolchain"-
Etiqueta de proto_lang_toolchain() que describe cómo compilar protos de JavaLite
Etiquetas:affects_outputs
,loading_and_analysis
- Se acumulan los usos múltiples de
--protocopt=<a string>
-
Opciones adicionales para pasar al compilador de protobuf.
Etiquetas:affects_outputs
--[no]runs_per_test_detects_flakes
predeterminado: "false"- Si es verdadero, cualquier fragmento en el que se apruebe al menos una ejecución o intento y falle al menos una ejecución o intento obtendrá el estado FLAKY.
--shell_executable=<a path>
valor predeterminado: consulta la descripción-
Ruta de acceso absoluta al ejecutable del shell que Bazel debe usar. Si no se configura, pero la variable de entorno BAZEL_SH se establece en la primera invocación de Bazel (que inicia un servidor de Bazel), Bazel la usa. Si no se establece ninguno, Bazel usa una ruta de acceso predeterminada codificada de forma rígida según el sistema operativo en el que se ejecuta (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, todos los demás: /bin/bash). Ten en cuenta que usar un shell que no sea compatible con bash puede provocar fallas en la compilación o en el tiempo de ejecución de los archivos binarios generados.
Etiquetas:loading_and_analysis
- Se acumulan los usos múltiples de
--test_arg=<a string>
- Especifica argumentos y opciones adicionales que se deben pasar al ejecutable de la prueba. Se puede usar varias veces para especificar varios argumentos. Si se ejecutan varias pruebas, cada una de ellas recibirá argumentos idénticos. Solo se usa con el comando "bazel test".
--test_filter=<a string>
valor predeterminado: consulta la descripción- Especifica un filtro para reenviar al framework de pruebas. Se usa para limitar las pruebas que se ejecutan. Ten en cuenta que esto no afecta los destinos que se compilan.
- Valor predeterminado de
--test_result_expiration=<an integer>
: "-1" - Esta opción está obsoleta y no tiene ningún efecto.
--[no]test_runner_fail_fast
predeterminado: "false"- Reenvía la opción de falla rápida al ejecutor de pruebas. El ejecutor de pruebas debe detener la ejecución ante el primer error.
--test_sharding_strategy=<explicit or disabled>
predeterminado: "explícito"- Especifica la estrategia para la división de pruebas: "explícita" para usar la división solo si el atributo de compilación "shard_count" está presente. "disabled" para no usar nunca la división de pruebas.
--tool_java_language_version=<a string>
predeterminado: "8"- Versión del lenguaje Java que se usa para ejecutar las herramientas necesarias durante una compilación
--tool_java_runtime_version=<a string>
valor predeterminado: "remotejdk_11"- Versión del entorno de ejecución de Java que se usa para ejecutar herramientas durante la compilación
--[no]use_ijars
predeterminado: "true"- Si se habilita, esta opción hace que la compilación de Java use archivos .jar de interfaz. Esto generará una compilación incremental más rápida, pero los mensajes de error pueden ser diferentes.
Opciones de volcado
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan los usos múltiples de
--distdir=<a path>
-
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: "false"-
Si se configura, la caché del repositorio creará un vínculo físico al archivo en caso de acierto de caché, en lugar de copiarlo. Esto tiene como objetivo ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
predeterminado: "false"-
Si es verdadero, usa una cadena derivada de las URLs de las descargas del repositorio como canonical_id si no se especifica. Esto hace que un cambio en las URLs genere una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no provoquen que la caché oculte repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
predeterminado: "false"-
Si se configura, no se permite la descarga de repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark según este factor. De esta manera, los repositorios externos pueden funcionar en máquinas más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Ajusta todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
valor predeterminado: consulta la descripción-
Especifica la ubicación de la caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que controlan el resultado del comando:
--[no]action_cache
predeterminado: "false"-
Volca el contenido de la caché de acciones.
Etiquetas:bazel_monitoring
--[no]packages
predeterminado: "false"-
Volca el contenido de la caché de paquetes.
Etiquetas:bazel_monitoring
--[no]rule_classes
predeterminado: "false"-
Volca las clases de reglas.
Etiquetas:bazel_monitoring
--[no]rules
predeterminado: "false"-
Reglas de volcado, incluidos los recuentos y el uso de memoria (si se hace un seguimiento de la memoria).
Etiquetas:bazel_monitoring
--skyframe=<off, summary, count, deps or rdeps>
predeterminado: "off"-
Volcado del gráfico de Skyframe: "off", "summary", "count", "deps" o "rdeps".
Etiquetas:bazel_monitoring
- Valor predeterminado de
--skykey_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: ".*" -
Filtro de regex de los nombres de SkyKey que se generarán. Solo se usa con --skyframe=deps, rdeps.
Etiquetas:bazel_monitoring
--skylark_memory=<a string>
valor predeterminado: consulta la descripción-
Volca un perfil de memoria compatible con pprof en la ruta de acceso especificada. Para obtener más información, consulta https://github.com/google/pprof.
Etiquetas:bazel_monitoring
- Opciones que afectan la rigidez con la que Bazel aplica las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
- Valor predeterminado de
--experimental_repository_hash_file=<a string>
: "" -
Si no está vacío, especifica un archivo que contiene un valor resuelto, con el que se deben verificar los hashes del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan los usos múltiples de
--experimental_verify_repository_rules=<a string>
-
Si se proporciona un archivo con --experimental_repository_hash_file, se debe verificar la lista de reglas del repositorio para las que se debe verificar el hash del directorio de salida.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: "true"-
No-op
Etiquetas:no_op
,deprecated
,experimental
- Opciones relacionadas con la salida y la semántica de Bzlmod:
- Se acumulan los usos múltiples de
--allow_yanked_versions=<a string>
-
Se especificaron las versiones del módulo en el formato "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran como retiradas en el registro del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones retiradas harán que falle la resolución. También puedes definir la versión anulada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivar el problema a una falla de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecta una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "warning"-
Verifica si las dependencias directas de `bazel_dep` declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivar el problema como una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el archivo MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
predeterminado: "off"-
Especifica cómo y si se debe usar el archivo de bloqueo. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "error" para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan los usos múltiples de
--override_module=<an equals-separated mapping of module name to path>
- Anula un módulo con una ruta local con el formato <nombre del módulo>=<ruta>. Si la ruta proporcionada es absoluta, se usará tal cual. Si la ruta proporcionada es relativa, será relativa al directorio de trabajo actual. Si la ruta de acceso proporcionada comienza con "%workspace%", es relativa a la raíz del espacio de trabajo, que es el resultado de "bazel info workspace".
- Se acumulan los usos múltiples de
--registry=<a string>
-
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: primero se buscarán los módulos en los registros anteriores y solo se recurrirá a los registros posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemónicas con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemónicas.
- Opciones que especifican o alteran una entrada genérica para un comando de Bazel que no se incluye en otras categorías:
- Valor predeterminado de
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
valor predeterminado: consulta la descripción- Especifica un archivo para configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva (`allow`, `block` o `rewrite`) seguida de un nombre de host (para `allow` y `block`) o dos patrones, uno para la coincidencia y otro para usar como URL sustituta, con referencias inversas que comienzan con `$1`. Es posible que se proporcionen varias directivas `rewrite` para la misma URL y, en este caso, se devolverán varias URLs.
- Opciones varias, no clasificadas de otra manera:
- Se acumulan los usos múltiples de
--override_repository=<an equals-separated mapping of repository name to path>
- Anula un repositorio con una ruta de acceso local con el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es absoluta, se usará tal cual. Si la ruta de acceso proporcionada es relativa, se relacionará con el directorio de trabajo actual. Si la ruta de acceso proporcionada comienza con "%workspace%", es relativa a la raíz del espacio de trabajo, que es el resultado de "bazel info workspace".
Opciones de recuperación
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan los usos múltiples de
--distdir=<a path>
-
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: "false"-
Si se configura, la caché del repositorio creará un vínculo físico al archivo en caso de acierto de caché, en lugar de copiarlo. Esto tiene como objetivo ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
predeterminado: "false"-
Si es verdadero, usa una cadena derivada de las URLs de las descargas del repositorio como canonical_id si no se especifica. Esto hace que un cambio en las URLs genere una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no provoquen que la caché oculte repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
predeterminado: "false"-
Si se configura, no se permite la descarga de repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark según este factor. De esta manera, los repositorios externos pueden funcionar en máquinas más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Ajusta todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
valor predeterminado: consulta la descripción-
Especifica la ubicación de la caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de la compilación:
--[no]incompatible_remote_dangling_symlinks
predeterminado: "true"-
Si se establece como verdadero y --incompatible_remote_symlinks también es verdadero, se permite que los vínculos simbólicos en los resultados de la acción queden colgando.
Etiquetas:execution
,incompatible_change
--[no]incompatible_remote_symlinks
predeterminado: "true"-
Si se establece como verdadero, Bazel representará los vínculos simbólicos en los resultados de la acción en el protocolo de ejecución y almacenamiento en caché remotos como tales. De lo contrario, se seguirán los symlinks y se representarán como archivos o directorios. Consulta el problema #6631 para obtener más información.
Etiquetas:execution
,incompatible_change
--[no]keep_going
[-k
] predeterminado: "false"-
Continúa lo más posible después de un error. Si bien no se pueden analizar el destino que falló ni los que dependen de él, sí se pueden analizar otros requisitos previos de estos destinos.
Etiquetas: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">
predeterminado: "auto"-
Cantidad de subprocesos paralelos que se usarán para la fase de carga o análisis. Toma un número entero o una palabra clave (“auto”, “HOST_CPUS”, “HOST_RAM”), seguida opcionalmente de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". "auto" establece un valor predeterminado razonable según los recursos del host. Debe ser 1 como mínimo.
Etiquetas:bazel_internal_configuration
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, a diferencia de su existencia:
- Valor predeterminado de
--bep_maximum_open_remote_upload_files=<an integer>
: "-1" -
Es la cantidad máxima de archivos abiertos permitidos durante la carga de artefactos del BEP.
Etiquetas:affects_outputs
--remote_download_minimal
-
No descarga ningún resultado de compilación remota en la máquina local. Esta marca es un atajo para las marcas --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata y --remote_download_outputs=minimal.
Se expande a:
--nobuild_runfile_links
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=minimal
Etiquetas:affects_outputs
--remote_download_outputs=<all, minimal or toplevel>
predeterminado: "all"-
Si se configura como "mínimo", no se descargan los resultados de compilación remotos en la máquina local, excepto los que requieren las acciones locales. Si se configura como "toplevel", se comporta como "minimal", excepto que también descarga los resultados de los destinos de nivel superior en la máquina local. Ambas opciones pueden reducir significativamente los tiempos de compilación si el ancho de banda de la red es un cuello de botella.
Etiquetas:affects_outputs
- Valor predeterminado de
--remote_download_symlink_template=<a string>
: "" -
En lugar de descargar los resultados de compilación remota en la máquina local, crea vínculos simbólicos. El destino de los vínculos simbólicos se puede especificar en forma de una cadena de plantilla. Esta cadena de plantilla puede contener {hash} y {size_bytes}, que se expanden al hash del objeto y al tamaño en bytes, respectivamente. Por ejemplo, estos vínculos simbólicos pueden apuntar a un sistema de archivos FUSE que carga objetos del CAS a pedido.
Etiquetas:affects_outputs
--remote_download_toplevel
-
Solo descarga los resultados remotos de los destinos de nivel superior en la máquina local. Esta marca es un atajo para las marcas --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata y --remote_download_outputs=toplevel.
Se expande a:
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=toplevel
Etiquetas:affects_outputs
- Opciones que afectan la forma en que Bazel aplica de manera estricta las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
- Valor predeterminado de
--experimental_repository_hash_file=<a string>
: "" -
Si no está vacío, especifica un archivo que contiene un valor resuelto, con el que se deben verificar los hashes del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan los usos múltiples de
--experimental_verify_repository_rules=<a string>
-
Si se proporciona un archivo con --experimental_repository_hash_file, se debe verificar la lista de reglas del repositorio para las que se debe verificar el hash del directorio de salida.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: "true"-
Sin operación
Etiquetas:no_op
,deprecated
,experimental
--[no]incompatible_config_setting_private_default_visibility
predeterminado: "false"-
Si incompatible_enforce_config_setting_visibility=false, esta es una operación nula. De lo contrario, si esta marca es falsa, cualquier config_setting sin un atributo de visibilidad explícito es //visibility:public. Si esta marca es verdadera, config_setting sigue la misma lógica de visibilidad que todas las demás reglas. Consulta https://github.com/bazelbuild/bazel/issues/12933.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
predeterminado: "true"-
Si es verdadero, se aplican las restricciones de visibilidad de config_setting. Si es falso, todos los config_setting son visibles para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones relacionadas con la salida y la semántica de Bzlmod:
- Se acumulan los usos múltiples de
--allow_yanked_versions=<a string>
-
Se especificaron las versiones del módulo en el formato "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran como retiradas en el registro del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones retiradas harán que falle la resolución. También puedes definir la versión anulada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivar el problema a una falla de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecta una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "warning"-
Verifica si las dependencias directas de `bazel_dep` declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivar el problema como una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el archivo MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
predeterminado: "off"-
Especifica cómo y si se debe usar el archivo de bloqueo. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "error" para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan los usos múltiples de
--override_module=<an equals-separated mapping of module name to path>
- Anula un módulo con una ruta local con el formato <nombre del módulo>=<ruta>. Si la ruta proporcionada es absoluta, se usará tal cual. Si la ruta proporcionada es relativa, será relativa al directorio de trabajo actual. Si la ruta de acceso proporcionada comienza con "%workspace%", es relativa a la raíz del espacio de trabajo, que es el resultado de "bazel info workspace".
- Se acumulan los usos múltiples de
--registry=<a string>
-
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: primero se buscarán los módulos en los registros anteriores y solo se recurrirá a los registros posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemónicas con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemónicas.
- Valor predeterminado de
--experimental_repository_resolved_file=<a string>
: "" -
Si no está vacío, escribe un valor de Starlark con la información resuelta de todas las reglas del repositorio de Starlark que se ejecutaron.
Etiquetas:affects_outputs
--remote_print_execution_messages=<failure, success or all>
predeterminado: "failure"-
Elige cuándo imprimir los mensajes de ejecución remota. Los valores válidos son "failure" para imprimir solo en caso de errores, "success" para imprimir solo en caso de éxito y "all" para imprimir siempre.
Etiquetas:terminal_output
- Opciones que especifican o alteran una entrada genérica para un comando de Bazel que no se incluye en otras categorías.:
- Valor predeterminado de
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_circuit_breaker_strategy=<failure>
valor predeterminado: consulta la descripción-
Especifica la estrategia que usará el disyuntor. Las estrategias disponibles son "failure". Si el valor de la opción no es válido, el comportamiento es el mismo que si la opción no estuviera configurada.
Etiquetas:execution
--experimental_downloader_config=<a string>
valor predeterminado: consulta la descripción- Especifica un archivo para configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva (`allow`, `block` o `rewrite`) seguida de un nombre de host (para `allow` y `block`) o dos patrones, uno para la coincidencia y otro para usar como URL sustituta, con referencias inversas que comienzan con `$1`. Es posible que se proporcionen varias directivas `rewrite` para la misma URL y, en este caso, se devolverán varias URLs.
--[no]experimental_guard_against_concurrent_changes
predeterminado: "false"- Desactiva esta opción para inhabilitar la verificación de la hora de creación de los archivos de entrada de una acción antes de subirlos a una caché remota. Puede haber casos en los que el kernel de Linux retrase la escritura de archivos, lo que podría generar falsos positivos.
--experimental_remote_build_event_upload=<all or minimal>
predeterminado: "all"- Si se configura como "all", todos los resultados locales a los que hace referencia el BEP se suben a la caché remota. Si se establece en "mínimo", los resultados locales a los que se hace referencia en BEP no se suben a la caché remota, excepto los archivos que son importantes para los consumidores de BEP (p.ej., registros de pruebas y perfil de sincronización). El esquema bytestream:// siempre se usa para la URI de los archivos, incluso si faltan en la caché remota. El valor predeterminado es “all”.
--[no]experimental_remote_cache_async
predeterminado: "false"- Si es verdadero, las E/S de la caché remota se realizarán en segundo plano en lugar de como parte de una generación.
--[no]experimental_remote_cache_compression
predeterminado: "false"- Si está habilitado, comprime o descomprime los BLOB de caché con zstd.
--experimental_remote_capture_corrupted_outputs=<a path>
valor predeterminado: consulta la descripción- Es la ruta de acceso a un directorio en el que se capturarán los resultados dañados.
--[no]experimental_remote_discard_merkle_trees
predeterminado: "false"- Si se configura como verdadero, se descartan las copias en memoria del árbol de Merkle de la raíz de entrada y las asignaciones de entrada asociadas durante las llamadas a GetActionResult() y Execute(). Esto reduce significativamente el uso de memoria, pero requiere que Bazel vuelva a calcularlos en caso de errores de caché remota y reintentos.
--experimental_remote_downloader=<a string>
valor predeterminado: consulta la descripción- Es el URI de un extremo de la API de Remote Asset que se usará como proxy de descarga remota. Los esquemas admitidos son grpc, grpcs (grpc con TLS habilitado) y unix (sockets UNIX locales). Si no se proporciona ningún esquema, Bazel usará grpcs de forma predeterminada. Consulta https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto.
--[no]experimental_remote_downloader_local_fallback
predeterminado: "false"- Indica si se debe recurrir al descargador local si falla el descargador remoto.
--[no]experimental_remote_execution_keepalive
predeterminado: "false"- Indica si se debe usar keepalive para las llamadas de ejecución remota.
--experimental_remote_failure_rate_threshold=<an integer in 0-100 range>
predeterminado: "10"-
Establece la cantidad permitida de tasa de errores en porcentaje para un período específico después del cual deja de llamar a la caché o al ejecutor remotos. De forma predeterminada, el valor es 10. Si se establece en 0, significa que no hay limitación.
Etiquetas:execution
--experimental_remote_failure_window_interval=<An immutable length of time.>
predeterminado: "60s"-
Es el intervalo en el que se calcula la tasa de fallas de las solicitudes remotas. Si el valor es cero o negativo, la duración del error se calcula durante toda la ejecución.Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
Etiquetas:execution
--[no]experimental_remote_mark_tool_inputs
predeterminado: "false"- Si se establece como verdadero, Bazel marcará las entradas como entradas de herramientas para el ejecutor remoto. Esto se puede usar para implementar trabajadores persistentes remotos.
--[no]experimental_remote_merkle_tree_cache
predeterminado: "false"- Si se establece como verdadero, los cálculos del árbol de Merkle se almacenarán en caché para mejorar la velocidad de verificación de aciertos de la caché remota. La huella de memoria de la caché se controla con --experimental_remote_merkle_tree_cache_size.
--experimental_remote_merkle_tree_cache_size=<a long integer>
predeterminado: "1000"- Es la cantidad de árboles de Merkle que se deben memoizar para mejorar la velocidad de verificación de aciertos de caché remota. Aunque la caché se reduce automáticamente según el control de referencias débiles de Java, pueden producirse errores de memoria insuficiente si se establece un valor demasiado alto. Si se establece en 0, el tamaño de la caché es ilimitado. El valor óptimo varía según el tamaño del proyecto. El valor predeterminado es 1,000.
--[no]experimental_remote_require_cached
predeterminado: "false"- Si se establece en verdadero, se exige que todas las acciones que se pueden ejecutar de forma remota se almacenen en caché; de lo contrario, la compilación fallará. Esto es útil para solucionar problemas de no determinismo, ya que permite verificar si las acciones que deberían almacenarse en caché realmente se almacenan sin insertar de forma espuria resultados nuevos en la caché.
--[no]incompatible_remote_build_event_upload_respect_no_cache
predeterminado: "false"- Si se establece como verdadero, las salidas a las que hace referencia BEP no se suben a la caché remota si la acción de generación no se puede almacenar en caché de forma remota.
--[no]incompatible_remote_downloader_send_all_headers
predeterminado: "true"-
Indica si se deben enviar todos los valores de un encabezado con varios valores al descargador remoto en lugar de solo el primero.
Etiquetas:incompatible_change
--[no]incompatible_remote_output_paths_relative_to_input_root
predeterminado: "false"-
Si se configura como verdadero, las rutas de acceso de salida son relativas a la raíz de entrada en lugar del directorio de trabajo.
Etiquetas:incompatible_change
--[no]incompatible_remote_results_ignore_disk
predeterminado: "true"-
Si se establece como verdadero, --noremote_upload_local_results y --noremote_accept_cached no se aplicarán a la caché de disco. Si se usa una caché combinada:
--noremote_upload_local_results hará que los resultados se escriban en la caché de disco, pero no se suban a la caché remota.
--noremote_accept_cached hará que Bazel busque resultados en la caché del disco, pero no en la caché remota.
Las acciones no-remote-exec pueden acceder a la caché de disco.
Consulta el problema #8216 para obtener más información.
Etiquetas:incompatible_change
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
predeterminado: "false"-
Si se establece como verdadero, Bazel usará el nuevo código de salida 39 en lugar del 34 si la caché remota expulsa blobs durante la compilación.
Etiquetas:incompatible_change
--[no]remote_accept_cached
predeterminado: "true"- Indica si se deben aceptar los resultados de acciones almacenados en caché de forma remota.
--remote_bytestream_uri_prefix=<a string>
valor predeterminado: consulta la descripción- Es el nombre de host y el nombre de la instancia que se usarán en los URIs bytestream:// que se escriben en los flujos de eventos de compilación. Esta opción se puede configurar cuando las compilaciones se realizan con un proxy, lo que hace que los valores de --remote_executor y --remote_instance_name ya no correspondan al nombre canónico del servicio de ejecución remota. Si no se configura, el valor predeterminado será “${hostname}/${instance_name}”.
--remote_cache=<a string>
valor predeterminado: consulta la descripción- Es el URI de un extremo de almacenamiento en caché. Los esquemas admitidos son http, https, grpc, grpcs (grpc con TLS habilitado) y unix (sockets locales de UNIX). Si no se proporciona ningún esquema, Bazel usará grpcs de forma predeterminada. Especifica el esquema grpc://, http:// o unix: para inhabilitar TLS. Consulta https://bazel.build/remote/caching.
- Se acumulan los usos múltiples de
--remote_cache_header=<a 'name=value' assignment>
- Especifica un encabezado que se incluirá en las solicitudes de caché: --remote_cache_header=Name=Value. Se pueden pasar varios encabezados especificando la marca varias veces. Los valores múltiples para el mismo nombre se convertirán en una lista separada por comas.
- Se acumulan los usos múltiples de
--remote_default_exec_properties=<a 'name=value' assignment>
-
Establece las propiedades de ejecución predeterminadas que se usarán como la plataforma de ejecución remota si una plataforma de ejecución aún no establece exec_properties.
Etiquetas:affects_outputs
- Valor predeterminado de
--remote_default_platform_properties=<a string>
: "" - Establece las propiedades de la plataforma predeterminada que se configurarán para la API de ejecución remota, si la plataforma de ejecución aún no establece remote_execution_properties. Este valor también se usará si la plataforma host se selecciona como la plataforma de ejecución para la ejecución remota.
- Se acumulan los usos múltiples de
--remote_downloader_header=<a 'name=value' assignment>
- Especifica un encabezado que se incluirá en las solicitudes del descargador remoto: --remote_downloader_header=Name=Value. Se pueden pasar varios encabezados especificando la marca varias veces. Los valores múltiples para el mismo nombre se convertirán en una lista separada por comas.
- Se acumulan los usos múltiples de
--remote_exec_header=<a 'name=value' assignment>
- Especifica un encabezado que se incluirá en las solicitudes de ejecución: --remote_exec_header=Name=Value. Se pueden pasar varios encabezados especificando la marca varias veces. Los valores múltiples para el mismo nombre se convertirán en una lista separada por comas.
--remote_execution_priority=<an integer>
predeterminado: "0"- Es la prioridad relativa de las acciones que se ejecutarán de forma remota. La semántica de los valores de prioridad particulares depende del servidor.
--remote_executor=<a string>
valor predeterminado: consulta la descripción- HOST o HOST:PORT de un extremo de ejecución remota. Los esquemas admitidos son grpc, grpcs (grpc con TLS habilitado) y unix (sockets UNIX locales). Si no se proporciona ningún esquema, Bazel usará grpcs de forma predeterminada. Especifica el esquema grpc:// o unix: para inhabilitar TLS.
--remote_grpc_log=<a path>
valor predeterminado: consulta la descripción- Si se especifica, es la ruta de acceso a un archivo para registrar detalles relacionados con las llamadas a gRPC. Este registro consta de una secuencia de mensajes .proto serializados com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry, en la que cada mensaje tiene como prefijo un varint que denota el tamaño del siguiente mensaje .proto serializado, como lo realiza el método LogEntry.writeDelimitedTo(OutputStream).
- Se acumulan los usos múltiples de
--remote_header=<a 'name=value' assignment>
- Especifica un encabezado que se incluirá en las solicitudes: --remote_header=Name=Value. Se pueden pasar varios encabezados especificando la marca varias veces. Los valores múltiples para el mismo nombre se convertirán en una lista separada por comas.
- Valor predeterminado de
--remote_instance_name=<a string>
: "" - Es el valor que se pasará como instance_name en la API de ejecución remota.
--[no]remote_local_fallback
predeterminado: "false"- Indica si se debe recurrir a la estrategia de ejecución local independiente si falla la ejecución remota.
--remote_local_fallback_strategy=<a string>
predeterminado: "local"- Es una operación nula y está obsoleta. Consulta https://github.com/bazelbuild/bazel/issues/7480 para obtener más información.
--remote_max_connections=<an integer>
valor predeterminado: "100"-
Limita la cantidad máxima de conexiones simultáneas a la caché o al ejecutor remotos. De forma predeterminada, el valor es 100. Si se establece en 0, significa que no hay limitación.
En el caso de la caché remota HTTP, una conexión TCP puede controlar una solicitud a la vez, por lo que Bazel puede realizar hasta --remote_max_connections solicitudes simultáneas.
En el caso del ejecutor y la caché remotos de gRPC, un canal de gRPC suele controlar más de 100 solicitudes simultáneas, por lo que Bazel podría realizar alrededor de `--remote_max_connections * 100` solicitudes simultáneas.
Etiquetas:host_machine_resource_optimizations
--remote_proxy=<a string>
valor predeterminado: consulta la descripción- Conéctate a la caché remota a través de un proxy. Actualmente, esta marca solo se puede usar para configurar un socket de dominio Unix (unix:/ruta/al/socket).
--remote_result_cache_priority=<an integer>
predeterminado: "0"- Es la prioridad relativa de las acciones remotas que se almacenarán en la caché remota. La semántica de los valores de prioridad particulares depende del servidor.
--remote_retries=<an integer>
predeterminado: "5"- Es la cantidad máxima de intentos para reintentar un error transitorio. Si se establece en 0, se inhabilitan los reintentos.
--remote_retry_max_delay=<An immutable length of time.>
predeterminado: "5s"- Es la demora máxima de retirada entre los reintentos remotos. Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
--remote_timeout=<An immutable length of time.>
predeterminado: "60s"- Es la cantidad máxima de tiempo que se espera para las llamadas de ejecución remota y de caché. Para la caché de REST, este es el tiempo de espera de conexión y de lectura. Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
--[no]remote_upload_local_results
predeterminado: "true"- Indica si se deben subir los resultados de las acciones ejecutadas de forma local a la caché remota si esta lo admite y el usuario está autorizado para hacerlo.
--[no]remote_verify_downloads
predeterminado: "true"- Si se configura como verdadero, Bazel calculará la suma de hash de todas las descargas remotas y descartará los valores almacenados en caché de forma remota si no coinciden con el valor esperado.
- Opciones varias, no clasificadas de otra manera:
- Se acumulan los usos múltiples de
--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.>
- Configura un auxiliar de credenciales para recuperar credenciales de autorización para la recuperación de repositorios, el almacenamiento en caché y la ejecución remotos, y el servicio de eventos de compilación. Las credenciales proporcionadas por un asistente tienen prioridad sobre las credenciales proporcionadas por --google_default_credentials, --google_credentials, un archivo .netrc o el parámetro de autenticación para repository_ctx.download y repository_ctx.download_and_extract. Se puede especificar varias veces para configurar varios asistentes. Para obtener más información, consulta https://github.com/bazelbuild/proposals/blob/main/designs/2022-06-07-bazel-credential-helpers.md.
--credential_helper_cache_duration=<An immutable length of time.>
predeterminado: "30 min"- Es la duración durante la que se almacenan en caché las credenciales proporcionadas por un auxiliar de credenciales. Si se invoca con un valor diferente, se ajustará la vida útil de las entradas existentes. Pasa cero para borrar la caché. Un comando clean siempre borra la caché, independientemente de esta marca.
--credential_helper_timeout=<An immutable length of time.>
predeterminado: "10s"- Configura el tiempo de espera para un auxiliar de credenciales. Los auxiliares de credenciales que no respondan dentro de este tiempo de espera fallarán en la invocación.
- Valor predeterminado de
--deleted_packages=<comma-separated list of package names>
: "" - Es una lista separada por comas de los nombres de los paquetes que el sistema de compilación considerará inexistentes, incluso si son visibles en algún lugar de la ruta de acceso del paquete. Usa esta opción cuando borres un subpaquete "x/y" de un paquete existente "x". Por ejemplo, después de borrar x/y/BUILD en tu cliente, es posible que el sistema de compilación muestre un error si encuentra la etiqueta "//x:y/z" si otra entrada de package_path aún la proporciona. Si especificas --deleted_packages x/y, se evita este problema.
--disk_cache=<a path>
valor predeterminado: consulta la descripción- Es la ruta de acceso a un directorio en el que Bazel puede leer y escribir acciones y resultados de acciones. Si el directorio no existe, se creará.
--google_auth_scopes=<comma-separated list of options>
valor predeterminado: "https://www.googleapis.com/auth/cloud-platform"- Lista separada por comas de los permisos de autenticación de Google Cloud.
--google_credentials=<a string>
valor predeterminado: consulta la descripción- Especifica el archivo desde el que se obtienen las credenciales de autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más detalles.
--[no]google_default_credentials
predeterminado: "false"- Indica si se deben usar las "credenciales predeterminadas de la aplicación de Google" para la autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más detalles. Está inhabilitado de forma predeterminada.
--grpc_keepalive_time=<An immutable length of time.>
valor predeterminado: consulta la descripción- Configura los pings de keep-alive para las conexiones gRPC salientes. Si se configura, Bazel envía pings después de este tiempo sin operaciones de lectura en la conexión, pero solo si hay al menos una llamada de gRPC pendiente. Los tiempos se tratan con una granularidad de segundos; es un error establecer un valor inferior a un segundo. De forma predeterminada, los pings de Keep-Alive están inhabilitados. Antes de habilitar este parámetro de configuración, debes coordinarte con el propietario del servicio. Por ejemplo, para establecer un valor de 30 segundos en esta marca, se debe hacer de la siguiente manera: --grpc_keepalive_time=30s
--grpc_keepalive_timeout=<An immutable length of time.>
predeterminado: "20s"- Configura un tiempo de espera de keep-alive para las conexiones gRPC salientes. Si los pings de keep-alive están habilitados con --grpc_keepalive_time, Bazel agota el tiempo de espera de una conexión si no recibe una respuesta de ping después de este tiempo. Los tiempos se tratan con una granularidad de segundos; es un error establecer un valor inferior a un segundo. Si los pings de conexión activa están inhabilitados, se ignorará este parámetro de configuración.
- Se acumulan los usos múltiples de
--override_repository=<an equals-separated mapping of repository name to path>
- Anula un repositorio con una ruta de acceso local con el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es absoluta, se usará tal cual. Si la ruta de acceso proporcionada es relativa, se relacionará con el directorio de trabajo actual. Si la ruta de acceso proporcionada comienza con "%workspace%", es relativa a la raíz del espacio de trabajo, que es el resultado de "bazel info workspace".
--package_path=<colon-separated list of options>
valor predeterminado: "%workspace%"- Es una lista separada por dos puntos de las ubicaciones en las que se buscarán paquetes. Los elementos que comienzan con "%workspace%" son relativos al espacio de trabajo que los contiene. Si se omite o está vacío, el valor predeterminado es el resultado de "bazel info default-package-path".
--[no]show_loading_progress
predeterminado: "true"- Si está habilitado, hace que Bazel imprima mensajes de "Loading package:".
--tls_certificate=<a string>
valor predeterminado: consulta la descripción- Especifica una ruta de acceso a un certificado TLS que se considera de confianza para firmar certificados de servidor.
--tls_client_certificate=<a string>
valor predeterminado: consulta la descripción- Especifica el certificado de cliente TLS que se usará. También debes proporcionar una clave de cliente para habilitar la autenticación del cliente.
--tls_client_key=<a string>
valor predeterminado: consulta la descripción- Especifica la clave del cliente TLS que se usará. También debes proporcionar un certificado de cliente para habilitar la autenticación del cliente.
Opciones de ayuda
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan los usos múltiples de
--distdir=<a path>
-
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: "false"-
Si se configura, la caché del repositorio creará un vínculo físico al archivo en caso de acierto de caché, en lugar de copiarlo. Esto tiene como objetivo ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
predeterminado: "false"-
Si es verdadero, usa una cadena derivada de las URLs de las descargas del repositorio como canonical_id si no se especifica. Esto hace que un cambio en las URLs genere una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no provoquen que la caché oculte repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
predeterminado: "false"-
Si se configura, no se permite la descarga de repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark según este factor. De esta manera, los repositorios externos pueden funcionar en máquinas más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Ajusta todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
valor predeterminado: consulta la descripción-
Especifica la ubicación de la caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que afectan la rigidez con la que Bazel aplica las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
- Valor predeterminado de
--experimental_repository_hash_file=<a string>
: "" -
Si no está vacío, especifica un archivo que contiene un valor resuelto, con el que se deben verificar los hashes del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan los usos múltiples de
--experimental_verify_repository_rules=<a string>
-
Si se proporciona un archivo con --experimental_repository_hash_file, se debe verificar la lista de reglas del repositorio para las que se debe verificar el hash del directorio de salida.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: "true"-
No-op
Etiquetas:no_op
,deprecated
,experimental
- Opciones relacionadas con la salida y la semántica de Bzlmod:
- Se acumulan los usos múltiples de
--allow_yanked_versions=<a string>
-
Se especificaron las versiones del módulo en el formato "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran como retiradas en el registro del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones retiradas harán que falle la resolución. También puedes definir la versión anulada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivar el problema a una falla de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecta una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "warning"-
Verifica si las dependencias directas de `bazel_dep` declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivar el problema como una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el archivo MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
predeterminado: "off"-
Especifica cómo y si se debe usar el archivo de bloqueo. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "error" para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan los usos múltiples de
--override_module=<an equals-separated mapping of module name to path>
- Anula un módulo con una ruta local con el formato <nombre del módulo>=<ruta>. Si la ruta proporcionada es absoluta, se usará tal cual. Si la ruta proporcionada es relativa, será relativa al directorio de trabajo actual. Si la ruta de acceso proporcionada comienza con "%workspace%", es relativa a la raíz del espacio de trabajo, que es el resultado de "bazel info workspace".
- Se acumulan los usos múltiples de
--registry=<a string>
-
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: primero se buscarán los módulos en los registros anteriores y solo se recurrirá a los registros posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemónicas con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemónicas.
--help_verbosity=<long, medium or short>
predeterminado: "medium"-
Selecciona el nivel de detalle del comando de ayuda.
Etiquetas:affects_outputs
,terminal_output
--long
[-l
]-
Muestra la descripción completa de cada opción, en lugar de solo su nombre.
Se expande a:
--help_verbosity=long
Etiquetas:affects_outputs
,terminal_output
--short
-
Muestra solo los nombres de las opciones, no sus tipos ni significados.
Se expande a:
--help_verbosity=short
Etiquetas:affects_outputs
,terminal_output
- Opciones que especifican o modifican una entrada genérica para un comando de Bazel que no se incluye en otras categorías:
- Valor predeterminado de
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
valor predeterminado: consulta la descripción- Especifica un archivo para configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva (`allow`, `block` o `rewrite`) seguida de un nombre de host (para `allow` y `block`) o dos patrones, uno para la coincidencia y otro para usar como URL sustituta, con referencias inversas que comienzan con `$1`. Es posible que se proporcionen varias directivas `rewrite` para la misma URL y, en este caso, se devolverán varias URLs.
- Opciones varias, no clasificadas de otra manera:
- Se acumulan los usos múltiples de
--override_repository=<an equals-separated mapping of repository name to path>
- Anula un repositorio con una ruta de acceso local con el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es absoluta, se usará tal cual. Si la ruta de acceso proporcionada es relativa, se relacionará con el directorio de trabajo actual. Si la ruta de acceso proporcionada comienza con "%workspace%", es relativa a la raíz del espacio de trabajo, que es el resultado de "bazel info workspace".
Opciones de información
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan los usos múltiples de
--distdir=<a path>
-
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: "false"-
Si se configura, la caché del repositorio creará un vínculo físico al archivo en caso de acierto de caché, en lugar de copiarlo. Esto tiene como objetivo ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
predeterminado: "false"-
Si es verdadero, usa una cadena derivada de las URLs de las descargas del repositorio como canonical_id si no se especifica. Esto hace que un cambio en las URLs genere una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no provoquen que la caché oculte repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
predeterminado: "false"-
Si se configura, no se permite la descarga de repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark según este factor. De esta manera, los repositorios externos pueden funcionar en máquinas más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Ajusta todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
valor predeterminado: consulta la descripción-
Especifica la ubicación de la caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que afectan la rigidez con la que Bazel aplica las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
- Valor predeterminado de
--experimental_repository_hash_file=<a string>
: "" -
Si no está vacío, especifica un archivo que contiene un valor resuelto, con el que se deben verificar los hashes del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan los usos múltiples de
--experimental_verify_repository_rules=<a string>
-
Si se proporciona un archivo con --experimental_repository_hash_file, se debe verificar la lista de reglas del repositorio para las que se debe verificar el hash del directorio de salida.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: "true"-
No-op
Etiquetas:no_op
,deprecated
,experimental
- Opciones relacionadas con la salida y la semántica de Bzlmod:
- Se acumulan los usos múltiples de
--allow_yanked_versions=<a string>
-
Se especificaron las versiones del módulo en el formato "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran como retiradas en el registro del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones retiradas harán que falle la resolución. También puedes definir la versión anulada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivar el problema a una falla de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecta una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "warning"-
Verifica si las dependencias directas de `bazel_dep` declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivar el problema como una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el archivo MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
predeterminado: "off"-
Especifica cómo y si se debe usar el archivo de bloqueo. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "error" para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan los usos múltiples de
--override_module=<an equals-separated mapping of module name to path>
- Anula un módulo con una ruta local con el formato <nombre del módulo>=<ruta>. Si la ruta proporcionada es absoluta, se usará tal cual. Si la ruta proporcionada es relativa, será relativa al directorio de trabajo actual. Si la ruta de acceso proporcionada comienza con "%workspace%", es relativa a la raíz del espacio de trabajo, que es el resultado de "bazel info workspace".
- Se acumulan los usos múltiples de
--registry=<a string>
-
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: primero se buscarán los módulos en los registros anteriores y solo se recurrirá a los registros posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemónicas con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemónicas.
--[no]show_make_env
predeterminado: "false"-
Incluye el entorno "Make" en el resultado.
Etiquetas:affects_outputs
,terminal_output
- Opciones que especifican o modifican una entrada genérica para un comando de Bazel que no se incluye en otras categorías.:
- Valor predeterminado de
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
valor predeterminado: consulta la descripción- Especifica un archivo para configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva (`allow`, `block` o `rewrite`) seguida de un nombre de host (para `allow` y `block`) o dos patrones, uno para la coincidencia y otro para usar como URL sustituta, con referencias inversas que comienzan con `$1`. Es posible que se proporcionen varias directivas `rewrite` para la misma URL y, en este caso, se devolverán varias URLs.
- Opciones varias, no clasificadas de otra manera:
- Se acumulan los usos múltiples de
--override_repository=<an equals-separated mapping of repository name to path>
- Anula un repositorio con una ruta de acceso local con el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es absoluta, se usará tal cual. Si la ruta de acceso proporcionada es relativa, se relacionará con el directorio de trabajo actual. Si la ruta de acceso proporcionada comienza con "%workspace%", es relativa a la raíz del espacio de trabajo, que es el resultado de "bazel info workspace".
Opciones de licencia
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan los usos múltiples de
--distdir=<a path>
-
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: "false"-
Si se configura, la caché del repositorio creará un vínculo físico al archivo en caso de acierto de caché, en lugar de copiarlo. Esto tiene como objetivo ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
predeterminado: "false"-
Si es verdadero, usa una cadena derivada de las URLs de las descargas del repositorio como canonical_id si no se especifica. Esto hace que un cambio en las URLs genere una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no provoquen que la caché oculte repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
predeterminado: "false"-
Si se configura, no se permite la descarga de repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark según este factor. De esta manera, los repositorios externos pueden funcionar en máquinas más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Ajusta todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
valor predeterminado: consulta la descripción-
Especifica la ubicación de la caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que afectan la rigidez con la que Bazel aplica las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
- Valor predeterminado de
--experimental_repository_hash_file=<a string>
: "" -
Si no está vacío, especifica un archivo que contiene un valor resuelto, con el que se deben verificar los hashes del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan los usos múltiples de
--experimental_verify_repository_rules=<a string>
-
Si se proporciona un archivo con --experimental_repository_hash_file, se debe verificar la lista de reglas del repositorio para las que se debe verificar el hash del directorio de salida.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: "true"-
No-op
Etiquetas:no_op
,deprecated
,experimental
- Opciones relacionadas con la salida y la semántica de Bzlmod:
- Se acumulan los usos múltiples de
--allow_yanked_versions=<a string>
-
Se especificaron las versiones del módulo en el formato "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran como retiradas en el registro del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones retiradas harán que falle la resolución. También puedes definir la versión anulada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivar el problema a una falla de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecta una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "warning"-
Verifica si las dependencias directas de `bazel_dep` declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivar el problema como una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el archivo MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
predeterminado: "off"-
Especifica cómo y si se debe usar el archivo de bloqueo. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "error" para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan los usos múltiples de
--override_module=<an equals-separated mapping of module name to path>
- Anula un módulo con una ruta local con el formato <nombre del módulo>=<ruta>. Si la ruta proporcionada es absoluta, se usará tal cual. Si la ruta proporcionada es relativa, será relativa al directorio de trabajo actual. Si la ruta de acceso proporcionada comienza con "%workspace%", es relativa a la raíz del espacio de trabajo, que es el resultado de "bazel info workspace".
- Se acumulan los usos múltiples de
--registry=<a string>
-
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: primero se buscarán los módulos en los registros anteriores y solo se recurrirá a los registros posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemónicas con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemónicas.
- Opciones que especifican o alteran una entrada genérica para un comando de Bazel que no se incluye en otras categorías:
- Valor predeterminado de
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
valor predeterminado: consulta la descripción- Especifica un archivo para configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva (`allow`, `block` o `rewrite`) seguida de un nombre de host (para `allow` y `block`) o dos patrones, uno para la coincidencia y otro para usar como URL sustituta, con referencias inversas que comienzan con `$1`. Es posible que se proporcionen varias directivas `rewrite` para la misma URL y, en este caso, se devolverán varias URLs.
- Opciones varias, no clasificadas de otra manera:
- Se acumulan los usos múltiples de
--override_repository=<an equals-separated mapping of repository name to path>
- Anula un repositorio con una ruta de acceso local con el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es absoluta, se usará tal cual. Si la ruta de acceso proporcionada es relativa, se relacionará con el directorio de trabajo actual. Si la ruta de acceso proporcionada comienza con "%workspace%", es relativa a la raíz del espacio de trabajo, que es el resultado de "bazel info workspace".
Opciones de instalación en dispositivos móviles
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan los usos múltiples de
--distdir=<a path>
-
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: "false"-
Si se configura, la caché del repositorio creará un vínculo físico al archivo en caso de acierto de caché, en lugar de copiarlo. Esto tiene como objetivo ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
predeterminado: "false"-
Si es verdadero, usa una cadena derivada de las URLs de las descargas del repositorio como canonical_id si no se especifica. Esto hace que un cambio en las URLs genere una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no provoquen que la caché oculte repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
predeterminado: "false"-
Si se configura, no se permite la descarga de repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark según este factor. De esta manera, los repositorios externos pueden funcionar en máquinas más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Ajusta todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
valor predeterminado: consulta la descripción-
Especifica la ubicación de la caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de la compilación:
--mode=<classic, classic_internal_test_do_not_use or skylark>
predeterminado: "classic"-
Selecciona cómo ejecutar la campaña de instalación de aplicaciones para dispositivos móviles. "classic" ejecuta la versión actual de mobile-install. "skylark" usa la nueva versión de Starlark, que admite android_test.
Etiquetas:loading_and_analysis
,execution
,incompatible_change
- Opciones que configuran la cadena de herramientas que se usa para la ejecución de acciones:
- Valor predeterminado de
--adb=<a string>
: "" -
Objeto binario de adb que se usará para el comando "mobile-install". Si no se especifica, se usa el que se encuentra en el SDK de Android especificado por la opción de línea de comandos --android_sdk (o el SDK predeterminado si no se especifica --android_sdk).
Etiquetas:changes_inputs
- Opciones que controlan el resultado del comando:
--[no]incremental
predeterminado: "false"-
Indica si se debe realizar una instalación incremental. Si es verdadero, intenta evitar trabajo adicional innecesario leyendo el estado del dispositivo en el que se instalará el código y usando esa información para evitar trabajo innecesario. Si es falso (valor predeterminado), siempre se realiza una instalación completa.
Etiquetas:loading_and_analysis
--[no]split_apks
predeterminado: "false"-
Indica si se deben usar APKs divididos para instalar y actualizar la aplicación en el dispositivo. Solo funciona con dispositivos con Marshmallow o versiones posteriores
Etiquetas:loading_and_analysis
,affects_outputs
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, a diferencia de su existencia:
- Se acumulan los usos múltiples de
--adb_arg=<a string>
-
Argumentos adicionales que se pasarán a adb. Se suele usar para designar un dispositivo en el que se instalará.
Etiquetas:action_command_lines
--debug_app
-
Indica si se debe esperar al depurador antes de iniciar la app.
Se expande a:
--start=DEBUG
Etiquetas:execution
- Valor predeterminado de
--device=<a string>
: "" -
Es el número de serie del dispositivo de adb. Si no se especifica, se usará el primer dispositivo.
Etiquetas:action_command_lines
--start=<no, cold, warm or debug>
valor predeterminado: "NO"-
Cómo se debe iniciar la app después de instalarla. Se establece en WARM para conservar y restablecer el estado de la aplicación en las instalaciones incrementales.
Etiquetas:execution
--start_app
-
Indica si se debe iniciar la app después de instalarla.
Se expande a:
--start=COLD
Etiquetas:execution
- Opciones que afectan la rigidez con la que Bazel aplica las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
- Valor predeterminado de
--experimental_repository_hash_file=<a string>
: "" -
Si no está vacío, especifica un archivo que contiene un valor resuelto, con el que se deben verificar los hashes del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan los usos múltiples de
--experimental_verify_repository_rules=<a string>
-
Si se proporciona un archivo con --experimental_repository_hash_file, se debe verificar la lista de reglas del repositorio para las que se debe verificar el hash del directorio de salida.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: "true"-
No-op
Etiquetas:no_op
,deprecated
,experimental
- Opciones relacionadas con la salida y la semántica de Bzlmod:
- Se acumulan los usos múltiples de
--allow_yanked_versions=<a string>
-
Se especificaron las versiones del módulo en el formato "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran como retiradas en el registro del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones retiradas harán que falle la resolución. También puedes definir la versión anulada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivar el problema a una falla de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecta una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "warning"-
Verifica si las dependencias directas de `bazel_dep` declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivar el problema como una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el archivo MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
predeterminado: "off"-
Especifica cómo y si se debe usar el archivo de bloqueo. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "error" para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan los usos múltiples de
--override_module=<an equals-separated mapping of module name to path>
- Anula un módulo con una ruta local con el formato <nombre del módulo>=<ruta>. Si la ruta proporcionada es absoluta, se usará tal cual. Si la ruta proporcionada es relativa, será relativa al directorio de trabajo actual. Si la ruta de acceso proporcionada comienza con "%workspace%", es relativa a la raíz del espacio de trabajo, que es el resultado de "bazel info workspace".
- Se acumulan los usos múltiples de
--registry=<a string>
-
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: primero se buscarán los módulos en los registros anteriores y solo se recurrirá a los registros posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemónicas con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemónicas.
- Valor predeterminado de
--incremental_install_verbosity=<a string>
: "" -
Es el nivel de detalle de la instalación incremental. Se establece en 1 para el registro de depuración.
Etiquetas:bazel_monitoring
- Opciones que especifican o alteran una entrada genérica para un comando de Bazel que no se incluye en otras categorías.:
- Valor predeterminado de
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
valor predeterminado: consulta la descripción- Especifica un archivo para configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva (`allow`, `block` o `rewrite`) seguida de un nombre de host (para `allow` y `block`) o dos patrones, uno para la coincidencia y otro para usar como URL sustituta, con referencias inversas que comienzan con `$1`. Es posible que se proporcionen varias directivas `rewrite` para la misma URL y, en este caso, se devolverán varias URLs.
- Opciones varias, no clasificadas de otra manera:
- Se acumulan los usos múltiples de
--override_repository=<an equals-separated mapping of repository name to path>
- Anula un repositorio con una ruta de acceso local con el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es absoluta, se usará tal cual. Si la ruta de acceso proporcionada es relativa, se relacionará con el directorio de trabajo actual. Si la ruta de acceso proporcionada comienza con "%workspace%", es relativa a la raíz del espacio de trabajo, que es el resultado de "bazel info workspace".
Opciones de modificación
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan los usos múltiples de
--distdir=<a path>
-
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: "false"-
Si se configura, la caché del repositorio creará un vínculo físico al archivo en caso de acierto de caché, en lugar de copiarlo. Esto tiene como objetivo ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
predeterminado: "false"-
Si es verdadero, usa una cadena derivada de las URLs de las descargas del repositorio como canonical_id si no se especifica. Esto hace que un cambio en las URLs genere una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no provoquen que la caché oculte repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
predeterminado: "false"-
Si se configura, no se permite la descarga de repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark según este factor. De esta manera, los repositorios externos pueden funcionar en máquinas más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Ajusta todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
valor predeterminado: consulta la descripción-
Especifica la ubicación de la caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de la compilación:
--[no]keep_going
[-k
] predeterminado: "false"-
Continúa lo más posible después de un error. Si bien no se pueden analizar el destino que falló ni los que dependen de él, sí se pueden analizar otros requisitos previos de estos destinos.
Etiquetas: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">
predeterminado: "auto"-
Cantidad de subprocesos paralelos que se usarán para la fase de carga o análisis. Toma un número entero o una palabra clave (“auto”, “HOST_CPUS”, “HOST_RAM”), seguida opcionalmente de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". "auto" establece un valor predeterminado razonable según los recursos del host. Debe ser 1 como mínimo.
Etiquetas:bazel_internal_configuration
- Opciones que afectan la rigidez con la que Bazel aplica las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
- Valor predeterminado de
--experimental_repository_hash_file=<a string>
: "" -
Si no está vacío, especifica un archivo que contiene un valor resuelto, con el que se deben verificar los hashes del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan los usos múltiples de
--experimental_verify_repository_rules=<a string>
-
Si se proporciona un archivo con --experimental_repository_hash_file, se debe verificar la lista de reglas del repositorio para las que se debe verificar el hash del directorio de salida.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: "true"-
Sin operación
Etiquetas:no_op
,deprecated
,experimental
--[no]incompatible_config_setting_private_default_visibility
predeterminado: "false"-
Si incompatible_enforce_config_setting_visibility=false, esta es una operación nula. De lo contrario, si esta marca es falsa, cualquier config_setting sin un atributo de visibilidad explícito es //visibility:public. Si esta marca es verdadera, config_setting sigue la misma lógica de visibilidad que todas las demás reglas. Consulta https://github.com/bazelbuild/bazel/issues/12933.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
predeterminado: "true"-
Si es verdadero, se aplican las restricciones de visibilidad de config_setting. Si es falso, todos los config_setting son visibles para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones relacionadas con el resultado y la semántica del subcomando "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>
valor predeterminado: "<root>"-
Especifica un módulo en relación con el cual se interpretarán los repositorios de destino especificados.
Etiquetas:terminal_output
--charset=<utf8 or ascii>
predeterminado: "utf8"-
Elige el conjunto de caracteres que se usará para el árbol. Solo afecta la salida de texto. Los valores válidos son “utf8” o “ascii”. El valor predeterminado es "utf8".
Etiquetas:terminal_output
--[no]cycles
predeterminado: "false"-
Señala los ciclos de dependencia dentro del árbol que se muestra, que normalmente se ignoran de forma predeterminada.
Etiquetas:terminal_output
- Valor predeterminado de
--depth=<an integer>
: "-1" -
Profundidad máxima de visualización del árbol de dependencias. Por ejemplo, una profundidad de 1 muestra las dependencias directas. Para tree, path y all_paths, el valor predeterminado es Integer.MAX_VALUE, mientras que para deps y explain, el valor predeterminado es 1 (solo se muestran las dependencias directas de la raíz, además de las hojas de destino y sus elementos superiores).
Etiquetas:terminal_output
--extension_filter=<a comma-separated list of <extension>s>
valor predeterminado: consulta la descripción-
Solo se muestran los usos de estas extensiones de módulos y los repositorios que generan si se configuran sus respectivas marcas. Si se configura, el gráfico de resultados solo incluirá rutas que contengan módulos que usen las extensiones especificadas. Una lista vacía inhabilita el filtro y especifica todas las extensiones posibles.
Etiquetas:terminal_output
--extension_info=<hidden, usages, repos or all>
predeterminado: "hidden"-
Especifica cuántos detalles sobre los usos de la extensión se deben incluir en el resultado de la búsqueda. "Usages" solo mostrará los nombres de las extensiones, "repos" también incluirá los repositorios importados con use_repo y "all" también mostrará los otros repositorios generados por las extensiones.
Etiquetas:terminal_output
- Valor predeterminado de
--extension_usages=<a comma-separated list of <module>s>
: "" -
Especifica los módulos cuyos usos de extensiones se mostrarán en la búsqueda show_extension.
Etiquetas:terminal_output
--from=<a comma-separated list of <module>s>
valor predeterminado: "<root>"-
Son los módulos a partir de los cuales se mostrará la consulta del gráfico de dependencias. Consulta la descripción de cada búsqueda para conocer la semántica exacta. El valor predeterminado es <root>.
Etiquetas:terminal_output
--[no]include_builtin
predeterminado: "false"-
Incluye módulos integrados en el gráfico de dependencias. Está inhabilitado de forma predeterminada porque genera mucho ruido.
Etiquetas:terminal_output
--[no]include_unused
predeterminado: "false"-
Las búsquedas también tendrán en cuenta y mostrarán los módulos no utilizados, que no están presentes en el gráfico de resolución de módulos después de la selección (debido a la selección de versión mínima o a las reglas de anulación). Esto puede tener diferentes efectos para cada uno de los tipos de consultas, es decir, incluir nuevas rutas en el comando all_paths o dependencias adicionales en el comando explain.
Etiquetas:terminal_output
--output=<text, json or graph>
predeterminado: "text"-
Es el formato en el que se deben imprimir los resultados de la búsqueda. Los valores permitidos para la búsqueda son: text, json, graph.
Etiquetas:terminal_output
--[no]verbose
predeterminado: "false"-
Las búsquedas también mostrarán el motivo por el que los módulos se resolvieron en su versión actual (si se cambió). El valor predeterminado es verdadero solo para la consulta de explicación.
Etiquetas:terminal_output
- Opciones relacionadas con la salida y la semántica de Bzlmod:
- Se acumulan los usos múltiples de
--allow_yanked_versions=<a string>
-
Se especificaron las versiones del módulo en el formato "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran como retiradas en el registro del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones retiradas harán que falle la resolución. También puedes definir la versión anulada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivar el problema a una falla de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecta una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "warning"-
Verifica si las dependencias directas de `bazel_dep` declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivar el problema como una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el archivo MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
predeterminado: "off"-
Especifica cómo y si se debe usar el archivo de bloqueo. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "error" para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan los usos múltiples de
--override_module=<an equals-separated mapping of module name to path>
- Anula un módulo con una ruta local con el formato <nombre del módulo>=<ruta>. Si la ruta proporcionada es absoluta, se usará tal cual. Si la ruta proporcionada es relativa, será relativa al directorio de trabajo actual. Si la ruta de acceso proporcionada comienza con "%workspace%", es relativa a la raíz del espacio de trabajo, que es el resultado de "bazel info workspace".
- Se acumulan los usos múltiples de
--registry=<a string>
-
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: primero se buscarán los módulos en los registros anteriores y solo se recurrirá a los registros posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemónicas con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemónicas.
- Opciones que especifican o alteran una entrada genérica para un comando de Bazel que no se incluye en otras categorías:
- Valor predeterminado de
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
valor predeterminado: consulta la descripción- Especifica un archivo para configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva (`allow`, `block` o `rewrite`) seguida de un nombre de host (para `allow` y `block`) o dos patrones, uno para la coincidencia y otro para usar como URL sustituta, con referencias inversas que comienzan con `$1`. Es posible que se proporcionen varias directivas `rewrite` para la misma URL y, en este caso, se devolverán varias URLs.
- Opciones varias, no clasificadas de otra manera:
- Valor predeterminado de
--deleted_packages=<comma-separated list of package names>
: "" - Es una lista separada por comas de los nombres de los paquetes que el sistema de compilación considerará inexistentes, incluso si son visibles en algún lugar de la ruta de acceso del paquete. Usa esta opción cuando borres un subpaquete "x/y" de un paquete existente "x". Por ejemplo, después de borrar x/y/BUILD en tu cliente, es posible que el sistema de compilación muestre un error si encuentra la etiqueta "//x:y/z" si otra entrada de package_path aún la proporciona. Si especificas --deleted_packages x/y, se evita este problema.
- Se acumulan los usos múltiples de
--override_repository=<an equals-separated mapping of repository name to path>
- Anula un repositorio con una ruta de acceso local con el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es absoluta, se usará tal cual. Si la ruta de acceso proporcionada es relativa, se relacionará con el directorio de trabajo actual. Si la ruta de acceso proporcionada comienza con "%workspace%", es relativa a la raíz del espacio de trabajo, que es el resultado de "bazel info workspace".
--package_path=<colon-separated list of options>
valor predeterminado: "%workspace%"- Es una lista separada por dos puntos de las ubicaciones en las que se buscarán paquetes. Los elementos que comienzan con "%workspace%" son relativos al espacio de trabajo que los contiene. Si se omite o está vacío, el valor predeterminado es el resultado de "bazel info default-package-path".
--[no]show_loading_progress
predeterminado: "true"- Si está habilitado, hace que Bazel imprima mensajes de "Loading package:".
Opciones de Print_action
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan los usos múltiples de
--distdir=<a path>
-
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: "false"-
Si se configura, la caché del repositorio creará un vínculo físico al archivo en caso de acierto de caché, en lugar de copiarlo. Esto tiene como objetivo ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
predeterminado: "false"-
Si es verdadero, usa una cadena derivada de las URLs de las descargas del repositorio como canonical_id si no se especifica. Esto hace que un cambio en las URLs genere una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no provoquen que la caché oculte repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
predeterminado: "false"-
Si se configura, no se permite la descarga de repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark según este factor. De esta manera, los repositorios externos pueden funcionar en máquinas más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Ajusta todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
valor predeterminado: consulta la descripción-
Especifica la ubicación de la caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que afectan la rigidez con la que Bazel aplica las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
- Valor predeterminado de
--experimental_repository_hash_file=<a string>
: "" -
Si no está vacío, especifica un archivo que contiene un valor resuelto, con el que se deben verificar los hashes del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan los usos múltiples de
--experimental_verify_repository_rules=<a string>
-
Si se proporciona un archivo con --experimental_repository_hash_file, se debe verificar la lista de reglas del repositorio para las que se debe verificar el hash del directorio de salida.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: "true"-
No-op
Etiquetas:no_op
,deprecated
,experimental
- Opciones relacionadas con la salida y la semántica de Bzlmod:
- Se acumulan los usos múltiples de
--allow_yanked_versions=<a string>
-
Se especificaron las versiones del módulo en el formato "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran como retiradas en el registro del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones retiradas harán que falle la resolución. También puedes definir la versión anulada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivar el problema a una falla de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecta una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "warning"-
Verifica si las dependencias directas de `bazel_dep` declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivar el problema como una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el archivo MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
predeterminado: "off"-
Especifica cómo y si se debe usar el archivo de bloqueo. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "error" para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan los usos múltiples de
--override_module=<an equals-separated mapping of module name to path>
- Anula un módulo con una ruta local con el formato <nombre del módulo>=<ruta>. Si la ruta proporcionada es absoluta, se usará tal cual. Si la ruta proporcionada es relativa, será relativa al directorio de trabajo actual. Si la ruta de acceso proporcionada comienza con "%workspace%", es relativa a la raíz del espacio de trabajo, que es el resultado de "bazel info workspace".
- Se acumulan los usos múltiples de
--registry=<a string>
-
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: primero se buscarán los módulos en los registros anteriores y solo se recurrirá a los registros posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemónicas con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemónicas.
- Opciones que especifican o alteran una entrada genérica para un comando de Bazel que no se incluye en otras categorías:
- Valor predeterminado de
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
valor predeterminado: consulta la descripción- Especifica un archivo para configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva (`allow`, `block` o `rewrite`) seguida de un nombre de host (para `allow` y `block`) o dos patrones, uno para la coincidencia y otro para usar como URL sustituta, con referencias inversas que comienzan con `$1`. Es posible que se proporcionen varias directivas `rewrite` para la misma URL y, en este caso, se devolverán varias URLs.
- Opciones varias, no clasificadas de otra manera:
- Se acumulan los usos múltiples de
--override_repository=<an equals-separated mapping of repository name to path>
- Anula un repositorio con una ruta de acceso local con el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es absoluta, se usará tal cual. Si la ruta de acceso proporcionada es relativa, se relacionará con el directorio de trabajo actual. Si la ruta de acceso proporcionada comienza con "%workspace%", es relativa a la raíz del espacio de trabajo, que es el resultado de "bazel info workspace".
- Se acumulan los usos múltiples de
--print_action_mnemonics=<a string>
- Enumera los mnemónicos por los que se filtrarán los datos de print_action. Si se deja vacío, no se realizará ningún filtrado.
Opciones de consulta
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan los usos múltiples de
--distdir=<a path>
-
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: "false"-
Si se configura, la caché del repositorio creará un vínculo físico al archivo en caso de acierto de caché, en lugar de copiarlo. Esto tiene como objetivo ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
predeterminado: "false"-
Si es verdadero, usa una cadena derivada de las URLs de las descargas del repositorio como canonical_id si no se especifica. Esto hace que un cambio en las URLs genere una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no provoquen que la caché oculte repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
predeterminado: "false"-
Si se configura, no se permite la descarga de repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark según este factor. De esta manera, los repositorios externos pueden funcionar en máquinas más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Ajusta todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
valor predeterminado: consulta la descripción-
Especifica la ubicación de la caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de la compilación:
--[no]incompatible_remote_dangling_symlinks
predeterminado: "true"-
Si se establece como verdadero y --incompatible_remote_symlinks también es verdadero, se permite que los vínculos simbólicos en los resultados de la acción queden colgando.
Etiquetas:execution
,incompatible_change
--[no]incompatible_remote_symlinks
predeterminado: "true"-
Si se establece como verdadero, Bazel representará los vínculos simbólicos en los resultados de la acción en el protocolo de ejecución y almacenamiento en caché remotos como tales. De lo contrario, se seguirán los symlinks y se representarán como archivos o directorios. Consulta el problema #6631 para obtener más información.
Etiquetas:execution
,incompatible_change
--[no]keep_going
[-k
] predeterminado: "false"-
Continúa lo más posible después de un error. Si bien no se pueden analizar el destino que falló ni los que dependen de él, sí se pueden analizar otros requisitos previos de estos destinos.
Etiquetas: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">
predeterminado: "auto"-
Cantidad de subprocesos paralelos que se usarán para la fase de carga o análisis. Toma un número entero o una palabra clave (“auto”, “HOST_CPUS”, “HOST_RAM”), seguida opcionalmente de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". "auto" establece un valor predeterminado razonable según los recursos del host. Debe ser 1 como mínimo.
Etiquetas:bazel_internal_configuration
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, a diferencia de su existencia:
- Valor predeterminado de
--bep_maximum_open_remote_upload_files=<an integer>
: "-1" -
Es la cantidad máxima de archivos abiertos permitidos durante la carga de artefactos del BEP.
Etiquetas:affects_outputs
--remote_download_minimal
-
No descarga ningún resultado de compilación remota en la máquina local. Esta marca es un atajo para las marcas --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata y --remote_download_outputs=minimal.
Se expande a:
--nobuild_runfile_links
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=minimal
Etiquetas:affects_outputs
--remote_download_outputs=<all, minimal or toplevel>
predeterminado: "all"-
Si se configura como "mínimo", no se descargan los resultados de compilación remotos en la máquina local, excepto los que requieren las acciones locales. Si se configura como "toplevel", se comporta como "minimal", excepto que también descarga los resultados de los destinos de nivel superior en la máquina local. Ambas opciones pueden reducir significativamente los tiempos de compilación si el ancho de banda de la red es un cuello de botella.
Etiquetas:affects_outputs
- Valor predeterminado de
--remote_download_symlink_template=<a string>
: "" -
En lugar de descargar los resultados de compilación remota en la máquina local, crea vínculos simbólicos. El destino de los vínculos simbólicos se puede especificar en forma de una cadena de plantilla. Esta cadena de plantilla puede contener {hash} y {size_bytes}, que se expanden al hash del objeto y al tamaño en bytes, respectivamente. Por ejemplo, estos vínculos simbólicos pueden apuntar a un sistema de archivos FUSE que carga objetos del CAS a pedido.
Etiquetas:affects_outputs
--remote_download_toplevel
-
Solo descarga los resultados remotos de los destinos de nivel superior en la máquina local. Esta marca es un atajo para las marcas --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata y --remote_download_outputs=toplevel.
Se expande a:
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=toplevel
Etiquetas:affects_outputs
- Opciones que afectan la forma en que Bazel aplica de manera estricta las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
- Valor predeterminado de
--experimental_repository_hash_file=<a string>
: "" -
Si no está vacío, especifica un archivo que contiene un valor resuelto, con el que se deben verificar los hashes del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan los usos múltiples de
--experimental_verify_repository_rules=<a string>
-
Si se proporciona un archivo con --experimental_repository_hash_file, se debe verificar la lista de reglas del repositorio para las que se debe verificar el hash del directorio de salida.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: "true"-
Sin operación
Etiquetas:no_op
,deprecated
,experimental
--[no]incompatible_config_setting_private_default_visibility
predeterminado: "false"-
Si incompatible_enforce_config_setting_visibility=false, esta es una operación nula. De lo contrario, si esta marca es falsa, cualquier config_setting sin un atributo de visibilidad explícito es //visibility:public. Si esta marca es verdadera, config_setting sigue la misma lógica de visibilidad que todas las demás reglas. Consulta https://github.com/bazelbuild/bazel/issues/12933.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
predeterminado: "true"-
Si es verdadero, se aplican las restricciones de visibilidad de config_setting. Si es falso, todos los config_setting son visibles para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones relacionadas con la salida y la semántica de la búsqueda:
--aspect_deps=<off, conservative or precise>
valor predeterminado: "conservative"-
Cómo resolver las dependencias de aspectos cuando el formato de salida es uno de {xml,proto,record}. "off" significa que no se resuelve ninguna dependencia de aspectos; "conservative" (el valor predeterminado) significa que se agregan todas las dependencias de aspectos declaradas, independientemente de si se les asigna la clase de regla de dependencias directas; "precise" significa que solo se agregan aquellos aspectos que posiblemente estén activos dada la clase de regla de las dependencias directas. Ten en cuenta que el modo preciso requiere cargar otros paquetes para evaluar un solo objetivo, lo que lo hace más lento que los otros modos. También ten en cuenta que incluso el modo preciso no es completamente preciso: la decisión de calcular un aspecto se toma en la fase de análisis, que no se ejecuta durante "bazel query".
Etiquetas:build_file_semantics
--[no]consistent_labels
predeterminado: "false"-
Si está habilitado, cada comando de consulta emite etiquetas como si se aplicara la función <code>str</code> de Starlark a una instancia de <code>Label</code>. Esto es útil para las herramientas que necesitan coincidir con el resultado de diferentes comandos de consulta o etiquetas emitidas por reglas. Si no está habilitado, los formateadores de salida pueden emitir nombres de repositorio aparentes (relativos al repositorio principal) para que la salida sea más legible.
Etiquetas:terminal_output
--[no]experimental_graphless_query
predeterminado: "auto"-
Si es verdadero, usa una implementación de Query que no hace una copia del gráfico. La nueva implementación solo admite --order_output=no, así como un subconjunto de los formateadores de salida.
Etiquetas:build_file_semantics
,eagerness_to_exit
- Valor predeterminado de
--graph:conditional_edges_limit=<an integer>
: "4" -
Es la cantidad máxima de etiquetas de condición que se pueden mostrar. -1 significa que no hay truncamiento y 0 significa que no hay anotaciones. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--[no]graph:factored
predeterminado: "true"-
Si es verdadero, el gráfico se emitirá "factorizado", es decir, los nodos topológicamente equivalentes se combinarán y sus etiquetas se concatenarán. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--graph:node_limit=<an integer>
valor predeterminado: "512"-
Es la longitud máxima de la cadena de etiqueta para un nodo de gráfico en el resultado. Las etiquetas más largas se truncarán. El valor -1 significa que no se truncarán. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--[no]implicit_deps
predeterminado: "true"-
Si está habilitado, las dependencias implícitas se incluirán en el gráfico de dependencias sobre el que opera la consulta. Una dependencia implícita es aquella que no se especifica de forma explícita en el archivo BUILD, pero que Bazel agrega. En el caso de cquery, esta opción controla el filtrado de las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
--[no]include_aspects
predeterminado: "true"-
aquery, cquery: Indica si se deben incluir las acciones generadas por aspectos en el resultado. query: No es una operación (los aspectos siempre se siguen).
Etiquetas:terminal_output
--[no]incompatible_display_source_file_location
predeterminado: "true"-
Es verdadero de forma predeterminada y muestra el destino del archivo fuente. Si es verdadero, muestra la ubicación de la línea 1 de los archivos fuente en los resultados de ubicación. Esta marca solo existe para fines de migración.
Etiquetas:terminal_output
,incompatible_change
--[no]incompatible_lexicographical_output
predeterminado: "true"-
Si se establece esta opción, se ordena la salida de --order_output=auto en orden lexicográfico.
Etiquetas:terminal_output
,incompatible_change
--[no]incompatible_package_group_includes_double_slash
predeterminado: "true"-
Si está habilitado, cuando se genere el atributo `packages` de package_group, no se omitirá el `//` inicial.
Etiquetas:terminal_output
,incompatible_change
--[no]infer_universe_scope
predeterminado: "false"-
Si se configura y no se configura --universe_scope, se inferirá un valor de --universe_scope como la lista de patrones de destino únicos en la expresión de búsqueda. Ten en cuenta que el valor de --universe_scope que se infiere para una expresión de búsqueda que usa funciones con alcance del universo (p.ej., "allrdeps") podría no ser el que deseas, por lo que debes usar esta opción solo si sabes lo que haces. Consulta https://bazel.build/reference/query#sky-query para obtener detalles y ejemplos. Si se establece --universe_scope, se ignora el valor de esta opción. Nota: Esta opción solo se aplica a `query` (es decir, no a `cquery`).
Etiquetas:loading_and_analysis
--[no]line_terminator_null
predeterminado: "false"-
Indica si cada formato termina con \0 en lugar de un salto de línea.
Etiquetas:terminal_output
--[no]nodep_deps
predeterminado: "true"-
Si está habilitado, las dependencias de los atributos "nodep" se incluirán en el gráfico de dependencias sobre el que opera la consulta. Un ejemplo común de un atributo "nodep" es "visibilidad". Ejecuta y analiza el resultado de `info build-language` para obtener información sobre todos los atributos "nodep" en el lenguaje de compilación.
Etiquetas:build_file_semantics
--noorder_results
-
Genera los resultados en orden de dependencia (predeterminado) o sin ordenar. La salida no ordenada es más rápida, pero solo se admite cuando --output no es minrank, maxrank o graph.
Se expande a:
--order_output=no
Etiquetas:terminal_output
--null
-
Indica si cada formato termina con \0 en lugar de un salto de línea.
Se expande a:
--line_terminator_null=true
Etiquetas:terminal_output
--order_output=<no, deps, auto or full>
predeterminado: "auto"-
Genera los resultados sin ordenar (no), ordenados según la dependencia (deps) o completamente ordenados (full). El valor predeterminado es "auto", lo que significa que los resultados se generan ordenados por dependencia o completamente ordenados, según el formateador de salida (ordenados por dependencia para proto, minrank, maxrank y graph, y completamente ordenados para todos los demás). Cuando la salida está completamente ordenada, los nodos se imprimen en un orden totalmente determinístico (total). Primero, todos los nodos se ordenan alfabéticamente. Luego, cada nodo de la lista se usa como el inicio de una búsqueda en profundidad posterior al pedido en la que los bordes salientes a los nodos no visitados se atraviesan en orden alfabético de los nodos sucesores. Por último, los nodos se imprimen en el orden inverso al que se visitaron.
Etiquetas:terminal_output
--order_results
-
Genera los resultados en orden de dependencia (predeterminado) o sin ordenar. La salida no ordenada es más rápida, pero solo se admite cuando --output no es minrank, maxrank o graph.
Se expande a:
--order_output=auto
Etiquetas:terminal_output
--output=<a string>
predeterminado: "label"-
Es el formato en el que se deben imprimir los resultados de la búsqueda. Los valores permitidos para la búsqueda son: build, graph, streamed_jsonproto, label, label_kind, location, maxrank, minrank, package, proto, xml.
Etiquetas:terminal_output
--[no]proto:default_values
predeterminado: "true"-
Si es verdadero, se incluyen los atributos cuyo valor no se especifica de forma explícita en el archivo BUILD; de lo contrario, se omiten. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
--[no]proto:definition_stack
predeterminado: "false"-
Propaga el campo proto definition_stack, que registra para cada instancia de regla la pila de llamadas de Starlark en el momento en que se definió la clase de la regla.
Etiquetas:terminal_output
--[no]proto:flatten_selects
predeterminado: "true"-
Si está habilitado, los atributos configurables creados por select() se aplanan. En el caso de los tipos de lista, la representación aplanada es una lista que contiene cada valor del mapa de selección exactamente una vez. Los tipos escalares se aplanan a nulos.
Etiquetas:build_file_semantics
--[no]proto:include_synthetic_attribute_hash
predeterminado: "false"-
Indica si se debe calcular y completar el atributo $internal_attr_hash.
Etiquetas:terminal_output
--[no]proto:instantiation_stack
predeterminado: "false"-
Propaga la pila de llamadas de instanciación de cada regla. Ten en cuenta que esto requiere que la pila esté presente.
Etiquetas:terminal_output
--[no]proto:locations
predeterminado: "true"-
Indica si se debe generar información de ubicación en la salida de proto.
Etiquetas:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
predeterminado: "all"-
Lista de atributos separados por comas que se incluirán en el resultado. La configuración predeterminada incluye todos los atributos. Se establece en una cadena vacía para no generar ningún atributo. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
--[no]proto:rule_inputs_and_outputs
predeterminado: "true"-
Indica si se deben propagar los campos rule_input y rule_output.
Etiquetas:terminal_output
- Valor predeterminado de
--query_file=<a string>
: "" -
Si se configura, la consulta leerá la consulta del archivo que se nombra aquí, en lugar de hacerlo desde la línea de comandos. Es un error especificar un archivo aquí y una consulta de línea de comandos.
Etiquetas:changes_inputs
--[no]relative_locations
predeterminado: "false"-
Si es verdadero, la ubicación de los archivos BUILD en las salidas de XML y proto será relativa. De forma predeterminada, la salida de ubicación es una ruta de acceso absoluta y no será coherente en todas las máquinas. Puedes establecer esta opción como verdadera para obtener un resultado coherente en todas las máquinas.
Etiquetas:terminal_output
--[no]strict_test_suite
predeterminado: "false"-
Si es verdadero, la expresión tests() arroja un error si encuentra un test_suite que contiene destinos que no son de prueba.
Etiquetas:build_file_semantics
,eagerness_to_exit
--[no]tool_deps
predeterminado: "true"-
Consulta: Si está inhabilitada, las dependencias de los destinos de "configuración del host" o "ejecución" no se incluirán en el gráfico de dependencias sobre el que opera la consulta. Un borde de dependencia de "configuración del host", como el que va de cualquier regla "proto_library" al compilador de Protocolos, suele apuntar a una herramienta que se ejecuta durante la compilación en lugar de a una parte del mismo programa "target".
Cquery: Si está inhabilitado, filtra todos los destinos configurados que cruzan una transición de host o de ejecución desde el destino de nivel superior que descubrió este destino configurado. Esto significa que, si el destino de nivel superior está en la configuración de destino, solo se devolverán los destinos configurados que también estén en la configuración de destino. Si el destino de nivel superior está en la configuración del host, solo se devolverán los destinos configurados del host. Esta opción NO excluirá las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
- Valor predeterminado de
--universe_scope=<comma-separated list of options>
: "" -
Es un conjunto de patrones de segmentación (aditivos y sustractivos) separados por comas. La consulta se puede realizar en el universo definido por el cierre transitivo de los destinos especificados. Esta opción se usa para los comandos query y cquery.
En el caso de cquery, la entrada de esta opción son los destinos en los que se compilan todas las respuestas, por lo que esta opción puede afectar las configuraciones y las transiciones. Si no se especifica esta opción, se supone que los destinos de nivel superior son los que se analizan a partir de la expresión de búsqueda. Nota: En el caso de cquery, no especificar esta opción puede provocar que se interrumpa la compilación si los destinos analizados a partir de la expresión de la consulta no se pueden compilar con las opciones de nivel superior.
Etiquetas:loading_and_analysis
--[no]xml:default_values
predeterminado: "false"-
Si es verdadero, se imprimen los atributos de regla cuyo valor no se especifica de forma explícita en el archivo BUILD; de lo contrario, se omiten.
Etiquetas:terminal_output
--[no]xml:line_numbers
predeterminado: "true"-
Si es verdadero, el resultado XML contiene números de línea. Si inhabilitas esta opción, es posible que las comparaciones sean más fáciles de leer. Esta opción solo se aplica a --output=xml.
Etiquetas:terminal_output
- Opciones relacionadas con la salida y la semántica de Bzlmod:
- Se acumulan los usos múltiples de
--allow_yanked_versions=<a string>
-
Se especificaron las versiones del módulo en el formato "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran como retiradas en el registro del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones retiradas harán que falle la resolución. También puedes definir la versión anulada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivar el problema a una falla de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecta una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "warning"-
Verifica si las dependencias directas de `bazel_dep` declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivar el problema como una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el archivo MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
predeterminado: "off"-
Especifica cómo y si se debe usar el archivo de bloqueo. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "error" para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan los usos múltiples de
--override_module=<an equals-separated mapping of module name to path>
- Anula un módulo con una ruta local con el formato <nombre del módulo>=<ruta>. Si la ruta proporcionada es absoluta, se usará tal cual. Si la ruta proporcionada es relativa, será relativa al directorio de trabajo actual. Si la ruta de acceso proporcionada comienza con "%workspace%", es relativa a la raíz del espacio de trabajo, que es el resultado de "bazel info workspace".
- Se acumulan los usos múltiples de
--registry=<a string>
-
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: primero se buscarán los módulos en los registros anteriores y solo se recurrirá a los registros posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemónicas con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemónicas.
- Valor predeterminado de
--experimental_repository_resolved_file=<a string>
: "" -
Si no está vacío, escribe un valor de Starlark con la información resuelta de todas las reglas del repositorio de Starlark que se ejecutaron.
Etiquetas:affects_outputs
--remote_print_execution_messages=<failure, success or all>
predeterminado: "failure"-
Elige cuándo imprimir los mensajes de ejecución remota. Los valores válidos son "failure" para imprimir solo en caso de errores, "success" para imprimir solo en caso de éxito y "all" para imprimir siempre.
Etiquetas:terminal_output
- Opciones que especifican o alteran una entrada genérica para un comando de Bazel que no se incluye en otras categorías.:
- Valor predeterminado de
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_circuit_breaker_strategy=<failure>
valor predeterminado: consulta la descripción-
Especifica la estrategia que usará el disyuntor. Las estrategias disponibles son "failure". Si el valor de la opción no es válido, el comportamiento es el mismo que si la opción no estuviera configurada.
Etiquetas:execution
--experimental_downloader_config=<a string>
valor predeterminado: consulta la descripción- Especifica un archivo para configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva (`allow`, `block` o `rewrite`) seguida de un nombre de host (para `allow` y `block`) o dos patrones, uno para la coincidencia y otro para usar como URL sustituta, con referencias inversas que comienzan con `$1`. Es posible que se proporcionen varias directivas `rewrite` para la misma URL y, en este caso, se devolverán varias URLs.
--[no]experimental_guard_against_concurrent_changes
predeterminado: "false"- Desactiva esta opción para inhabilitar la verificación de la hora de creación de los archivos de entrada de una acción antes de subirlos a una caché remota. Puede haber casos en los que el kernel de Linux retrase la escritura de archivos, lo que podría generar falsos positivos.
--experimental_remote_build_event_upload=<all or minimal>
predeterminado: "all"- Si se configura como "all", todos los resultados locales a los que hace referencia el BEP se suben a la caché remota. Si se establece en "mínimo", los resultados locales a los que se hace referencia en BEP no se suben a la caché remota, excepto los archivos que son importantes para los consumidores de BEP (p.ej., registros de pruebas y perfil de sincronización). El esquema bytestream:// siempre se usa para la URI de los archivos, incluso si faltan en la caché remota. El valor predeterminado es “all”.
--[no]experimental_remote_cache_async
predeterminado: "false"- Si es verdadero, las E/S de la caché remota se realizarán en segundo plano en lugar de como parte de una generación.
--[no]experimental_remote_cache_compression
predeterminado: "false"- Si está habilitado, comprime o descomprime los BLOB de caché con zstd.
--experimental_remote_capture_corrupted_outputs=<a path>
valor predeterminado: consulta la descripción- Es la ruta de acceso a un directorio en el que se capturarán los resultados dañados.
--[no]experimental_remote_discard_merkle_trees
predeterminado: "false"- Si se configura como verdadero, se descartan las copias en memoria del árbol de Merkle de la raíz de entrada y las asignaciones de entrada asociadas durante las llamadas a GetActionResult() y Execute(). Esto reduce significativamente el uso de memoria, pero requiere que Bazel vuelva a calcularlos en caso de errores de caché remota y reintentos.
--experimental_remote_downloader=<a string>
valor predeterminado: consulta la descripción- Es el URI de un extremo de la API de Remote Asset que se usará como proxy de descarga remota. Los esquemas admitidos son grpc, grpcs (grpc con TLS habilitado) y unix (sockets UNIX locales). Si no se proporciona ningún esquema, Bazel usará grpcs de forma predeterminada. Consulta https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto.
--[no]experimental_remote_downloader_local_fallback
predeterminado: "false"- Indica si se debe recurrir al descargador local si falla el descargador remoto.
--[no]experimental_remote_execution_keepalive
predeterminado: "false"- Indica si se debe usar keepalive para las llamadas de ejecución remota.
--experimental_remote_failure_rate_threshold=<an integer in 0-100 range>
predeterminado: "10"-
Establece la cantidad permitida de tasa de errores en porcentaje para un período específico después del cual deja de llamar a la caché o al ejecutor remotos. De forma predeterminada, el valor es 10. Si se establece en 0, significa que no hay limitación.
Etiquetas:execution
--experimental_remote_failure_window_interval=<An immutable length of time.>
predeterminado: "60s"-
Es el intervalo en el que se calcula la tasa de fallas de las solicitudes remotas. Si el valor es cero o negativo, la duración del error se calcula durante toda la ejecución.Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
Etiquetas:execution
--[no]experimental_remote_mark_tool_inputs
predeterminado: "false"- Si se establece como verdadero, Bazel marcará las entradas como entradas de herramientas para el ejecutor remoto. Esto se puede usar para implementar trabajadores persistentes remotos.
--[no]experimental_remote_merkle_tree_cache
predeterminado: "false"- Si se establece como verdadero, los cálculos del árbol de Merkle se almacenarán en caché para mejorar la velocidad de verificación de aciertos de la caché remota. La huella de memoria de la caché se controla con --experimental_remote_merkle_tree_cache_size.
--experimental_remote_merkle_tree_cache_size=<a long integer>
predeterminado: "1000"- Es la cantidad de árboles de Merkle que se deben memoizar para mejorar la velocidad de verificación de aciertos de caché remota. Aunque la caché se reduce automáticamente según el control de referencias débiles de Java, pueden producirse errores de memoria insuficiente si se establece un valor demasiado alto. Si se establece en 0, el tamaño de la caché es ilimitado. El valor óptimo varía según el tamaño del proyecto. El valor predeterminado es 1,000.
--[no]experimental_remote_require_cached
predeterminado: "false"- Si se establece en verdadero, se exige que todas las acciones que se pueden ejecutar de forma remota se almacenen en caché; de lo contrario, la compilación fallará. Esto es útil para solucionar problemas de no determinismo, ya que permite verificar si las acciones que deberían almacenarse en caché realmente se almacenan sin insertar de forma espuria resultados nuevos en la caché.
--[no]incompatible_remote_build_event_upload_respect_no_cache
predeterminado: "false"- Si se establece como verdadero, las salidas a las que hace referencia BEP no se suben a la caché remota si la acción de generación no se puede almacenar en caché de forma remota.
--[no]incompatible_remote_downloader_send_all_headers
predeterminado: "true"-
Indica si se deben enviar todos los valores de un encabezado con varios valores al descargador remoto en lugar de solo el primero.
Etiquetas:incompatible_change
--[no]incompatible_remote_output_paths_relative_to_input_root
predeterminado: "false"-
Si se configura como verdadero, las rutas de acceso de salida son relativas a la raíz de entrada en lugar del directorio de trabajo.
Etiquetas:incompatible_change
--[no]incompatible_remote_results_ignore_disk
predeterminado: "true"-
Si se establece como verdadero, --noremote_upload_local_results y --noremote_accept_cached no se aplicarán a la caché de disco. Si se usa una caché combinada:
--noremote_upload_local_results hará que los resultados se escriban en la caché de disco, pero no se suban a la caché remota.
--noremote_accept_cached hará que Bazel busque resultados en la caché del disco, pero no en la caché remota.
Las acciones no-remote-exec pueden acceder a la caché de disco.
Consulta el problema #8216 para obtener más información.
Etiquetas:incompatible_change
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
predeterminado: "false"-
Si se establece como verdadero, Bazel usará el nuevo código de salida 39 en lugar del 34 si la caché remota expulsa blobs durante la compilación.
Etiquetas:incompatible_change
--[no]remote_accept_cached
predeterminado: "true"- Indica si se deben aceptar los resultados de acciones almacenados en caché de forma remota.
--remote_bytestream_uri_prefix=<a string>
valor predeterminado: consulta la descripción- Es el nombre de host y el nombre de la instancia que se usarán en los URIs bytestream:// que se escriben en los flujos de eventos de compilación. Esta opción se puede configurar cuando las compilaciones se realizan con un proxy, lo que hace que los valores de --remote_executor y --remote_instance_name ya no correspondan al nombre canónico del servicio de ejecución remota. Si no se configura, el valor predeterminado será “${hostname}/${instance_name}”.
--remote_cache=<a string>
valor predeterminado: consulta la descripción- Es el URI de un extremo de almacenamiento en caché. Los esquemas admitidos son http, https, grpc, grpcs (grpc con TLS habilitado) y unix (sockets locales de UNIX). Si no se proporciona ningún esquema, Bazel usará grpcs de forma predeterminada. Especifica el esquema grpc://, http:// o unix: para inhabilitar TLS. Consulta https://bazel.build/remote/caching.
- Se acumulan los usos múltiples de
--remote_cache_header=<a 'name=value' assignment>
- Especifica un encabezado que se incluirá en las solicitudes de caché: --remote_cache_header=Name=Value. Se pueden pasar varios encabezados especificando la marca varias veces. Los valores múltiples para el mismo nombre se convertirán en una lista separada por comas.
- Se acumulan los usos múltiples de
--remote_default_exec_properties=<a 'name=value' assignment>
-
Establece las propiedades de ejecución predeterminadas que se usarán como la plataforma de ejecución remota si una plataforma de ejecución aún no establece exec_properties.
Etiquetas:affects_outputs
- Valor predeterminado de
--remote_default_platform_properties=<a string>
: "" - Establece las propiedades de la plataforma predeterminada que se configurarán para la API de ejecución remota, si la plataforma de ejecución aún no establece remote_execution_properties. Este valor también se usará si la plataforma host se selecciona como la plataforma de ejecución para la ejecución remota.
- Se acumulan los usos múltiples de
--remote_downloader_header=<a 'name=value' assignment>
- Especifica un encabezado que se incluirá en las solicitudes del descargador remoto: --remote_downloader_header=Name=Value. Se pueden pasar varios encabezados especificando la marca varias veces. Los valores múltiples para el mismo nombre se convertirán en una lista separada por comas.
- Se acumulan los usos múltiples de
--remote_exec_header=<a 'name=value' assignment>
- Especifica un encabezado que se incluirá en las solicitudes de ejecución: --remote_exec_header=Name=Value. Se pueden pasar varios encabezados especificando la marca varias veces. Los valores múltiples para el mismo nombre se convertirán en una lista separada por comas.
--remote_execution_priority=<an integer>
predeterminado: "0"- Es la prioridad relativa de las acciones que se ejecutarán de forma remota. La semántica de los valores de prioridad particulares depende del servidor.
--remote_executor=<a string>
valor predeterminado: consulta la descripción- HOST o HOST:PORT de un extremo de ejecución remota. Los esquemas admitidos son grpc, grpcs (grpc con TLS habilitado) y unix (sockets UNIX locales). Si no se proporciona ningún esquema, Bazel usará grpcs de forma predeterminada. Especifica el esquema grpc:// o unix: para inhabilitar TLS.
--remote_grpc_log=<a path>
valor predeterminado: consulta la descripción- Si se especifica, es la ruta de acceso a un archivo para registrar detalles relacionados con las llamadas a gRPC. Este registro consta de una secuencia de mensajes .proto serializados com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry, en la que cada mensaje tiene como prefijo un varint que denota el tamaño del siguiente mensaje .proto serializado, como lo realiza el método LogEntry.writeDelimitedTo(OutputStream).
- Se acumulan los usos múltiples de
--remote_header=<a 'name=value' assignment>
- Especifica un encabezado que se incluirá en las solicitudes: --remote_header=Name=Value. Se pueden pasar varios encabezados especificando la marca varias veces. Los valores múltiples para el mismo nombre se convertirán en una lista separada por comas.
- Valor predeterminado de
--remote_instance_name=<a string>
: "" - Es el valor que se pasará como instance_name en la API de ejecución remota.
--[no]remote_local_fallback
predeterminado: "false"- Indica si se debe recurrir a la estrategia de ejecución local independiente si falla la ejecución remota.
--remote_local_fallback_strategy=<a string>
predeterminado: "local"- Es una operación nula y está obsoleta. Consulta https://github.com/bazelbuild/bazel/issues/7480 para obtener más información.
--remote_max_connections=<an integer>
valor predeterminado: "100"-
Limita la cantidad máxima de conexiones simultáneas a la caché o al ejecutor remotos. De forma predeterminada, el valor es 100. Si se establece en 0, significa que no hay limitación.
En el caso de la caché remota HTTP, una conexión TCP puede controlar una solicitud a la vez, por lo que Bazel puede realizar hasta --remote_max_connections solicitudes simultáneas.
En el caso del ejecutor y la caché remotos de gRPC, un canal de gRPC suele controlar más de 100 solicitudes simultáneas, por lo que Bazel podría realizar alrededor de `--remote_max_connections * 100` solicitudes simultáneas.
Etiquetas:host_machine_resource_optimizations
--remote_proxy=<a string>
valor predeterminado: consulta la descripción- Conéctate a la caché remota a través de un proxy. Actualmente, esta marca solo se puede usar para configurar un socket de dominio Unix (unix:/ruta/al/socket).
--remote_result_cache_priority=<an integer>
predeterminado: "0"- Es la prioridad relativa de las acciones remotas que se almacenarán en la caché remota. La semántica de los valores de prioridad particulares depende del servidor.
--remote_retries=<an integer>
predeterminado: "5"- Es la cantidad máxima de intentos para reintentar un error transitorio. Si se establece en 0, se inhabilitan los reintentos.
--remote_retry_max_delay=<An immutable length of time.>
predeterminado: "5s"- Es la demora máxima de retirada entre los reintentos remotos. Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
--remote_timeout=<An immutable length of time.>
predeterminado: "60s"- Es la cantidad máxima de tiempo que se espera para las llamadas de ejecución remota y de caché. Para la caché de REST, este es el tiempo de espera de conexión y de lectura. Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
--[no]remote_upload_local_results
predeterminado: "true"- Indica si se deben subir los resultados de las acciones ejecutadas de forma local a la caché remota si esta lo admite y el usuario está autorizado para hacerlo.
--[no]remote_verify_downloads
predeterminado: "true"- Si se configura como verdadero, Bazel calculará la suma de hash de todas las descargas remotas y descartará los valores almacenados en caché de forma remota si no coinciden con el valor esperado.
- Opciones varias, no clasificadas de otra manera:
- Se acumulan los usos múltiples de
--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.>
- Configura un auxiliar de credenciales para recuperar credenciales de autorización para la recuperación de repositorios, el almacenamiento en caché y la ejecución remotos, y el servicio de eventos de compilación. Las credenciales proporcionadas por un asistente tienen prioridad sobre las credenciales proporcionadas por --google_default_credentials, --google_credentials, un archivo .netrc o el parámetro de autenticación para repository_ctx.download y repository_ctx.download_and_extract. Se puede especificar varias veces para configurar varios asistentes. Para obtener más información, consulta https://github.com/bazelbuild/proposals/blob/main/designs/2022-06-07-bazel-credential-helpers.md.
--credential_helper_cache_duration=<An immutable length of time.>
predeterminado: "30 min"- Es la duración durante la que se almacenan en caché las credenciales proporcionadas por un auxiliar de credenciales. Si se invoca con un valor diferente, se ajustará la vida útil de las entradas existentes. Pasa cero para borrar la caché. Un comando clean siempre borra la caché, independientemente de esta marca.
--credential_helper_timeout=<An immutable length of time.>
predeterminado: "10s"- Configura el tiempo de espera para un auxiliar de credenciales. Los auxiliares de credenciales que no respondan dentro de este tiempo de espera fallarán en la invocación.
- Valor predeterminado de
--deleted_packages=<comma-separated list of package names>
: "" - Es una lista separada por comas de los nombres de los paquetes que el sistema de compilación considerará inexistentes, incluso si son visibles en algún lugar de la ruta de acceso del paquete. Usa esta opción cuando borres un subpaquete "x/y" de un paquete existente "x". Por ejemplo, después de borrar x/y/BUILD en tu cliente, es posible que el sistema de compilación muestre un error si encuentra la etiqueta "//x:y/z" si otra entrada de package_path aún la proporciona. Si especificas --deleted_packages x/y, se evita este problema.
--disk_cache=<a path>
valor predeterminado: consulta la descripción- Es la ruta de acceso a un directorio en el que Bazel puede leer y escribir acciones y resultados de acciones. Si el directorio no existe, se creará.
--google_auth_scopes=<comma-separated list of options>
valor predeterminado: "https://www.googleapis.com/auth/cloud-platform"- Lista separada por comas de los permisos de autenticación de Google Cloud.
--google_credentials=<a string>
valor predeterminado: consulta la descripción- Especifica el archivo desde el que se obtienen las credenciales de autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más detalles.
--[no]google_default_credentials
predeterminado: "false"- Indica si se deben usar las "credenciales predeterminadas de la aplicación de Google" para la autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más detalles. Está inhabilitado de forma predeterminada.
--grpc_keepalive_time=<An immutable length of time.>
valor predeterminado: consulta la descripción- Configura los pings de keep-alive para las conexiones gRPC salientes. Si se configura, Bazel envía pings después de este tiempo sin operaciones de lectura en la conexión, pero solo si hay al menos una llamada de gRPC pendiente. Los tiempos se tratan con una granularidad de segundos; es un error establecer un valor inferior a un segundo. De forma predeterminada, los pings de Keep-Alive están inhabilitados. Antes de habilitar este parámetro de configuración, debes coordinarte con el propietario del servicio. Por ejemplo, para establecer un valor de 30 segundos en esta marca, se debe hacer de la siguiente manera: --grpc_keepalive_time=30s
--grpc_keepalive_timeout=<An immutable length of time.>
predeterminado: "20s"- Configura un tiempo de espera de keep-alive para las conexiones gRPC salientes. Si los pings de keep-alive están habilitados con --grpc_keepalive_time, Bazel agota el tiempo de espera de una conexión si no recibe una respuesta de ping después de este tiempo. Los tiempos se tratan con una granularidad de segundos; es un error establecer un valor inferior a un segundo. Si los pings de conexión activa están inhabilitados, se ignorará este parámetro de configuración.
- Se acumulan los usos múltiples de
--override_repository=<an equals-separated mapping of repository name to path>
- Anula un repositorio con una ruta de acceso local con el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es absoluta, se usará tal cual. Si la ruta de acceso proporcionada es relativa, se relacionará con el directorio de trabajo actual. Si la ruta de acceso proporcionada comienza con "%workspace%", es relativa a la raíz del espacio de trabajo, que es el resultado de "bazel info workspace".
--package_path=<colon-separated list of options>
valor predeterminado: "%workspace%"- Es una lista separada por dos puntos de las ubicaciones en las que se buscarán paquetes. Los elementos que comienzan con "%workspace%" son relativos al espacio de trabajo que los contiene. Si se omite o está vacío, el valor predeterminado es el resultado de "bazel info default-package-path".
--[no]show_loading_progress
predeterminado: "true"- Si está habilitado, hace que Bazel imprima mensajes de "Loading package:".
--tls_certificate=<a string>
valor predeterminado: consulta la descripción- Especifica una ruta de acceso a un certificado TLS que se considera de confianza para firmar certificados de servidor.
--tls_client_certificate=<a string>
valor predeterminado: consulta la descripción- Especifica el certificado de cliente TLS que se usará. También debes proporcionar una clave de cliente para habilitar la autenticación del cliente.
--tls_client_key=<a string>
valor predeterminado: consulta la descripción- Especifica la clave del cliente TLS que se usará. También debes proporcionar un certificado de cliente para habilitar la autenticación del cliente.
Opciones de ejecución
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan los usos múltiples de
--distdir=<a path>
-
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: "false"-
Si se configura, la caché del repositorio creará un vínculo físico al archivo en caso de acierto de caché, en lugar de copiarlo. Esto tiene como objetivo ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
predeterminado: "false"-
Si es verdadero, usa una cadena derivada de las URLs de las descargas del repositorio como canonical_id si no se especifica. Esto hace que un cambio en las URLs genere una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no provoquen que la caché oculte repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
predeterminado: "false"-
Si se configura, no se permite la descarga de repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark según este factor. De esta manera, los repositorios externos pueden funcionar en máquinas más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Ajusta todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
valor predeterminado: consulta la descripción-
Especifica la ubicación de la caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
--script_path=<a path>
valor predeterminado: consulta la descripción-
Si se configura, escribe una secuencia de comandos de shell en el archivo determinado que invoca el destino. Si se establece esta opción, el destino no se ejecuta desde Bazel. Usa "bazel run --script_path=foo //foo && ./foo" para invocar el destino "//foo". Esto difiere de "bazel run //foo" en que se libera el bloqueo de bazel y el ejecutable se conecta a stdin de la terminal.
Etiquetas:affects_outputs
,execution
- Opciones que afectan la forma en que Bazel aplica de manera estricta las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
- Valor predeterminado de
--experimental_repository_hash_file=<a string>
: "" -
Si no está vacío, especifica un archivo que contiene un valor resuelto, con el que se deben verificar los hashes del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan los usos múltiples de
--experimental_verify_repository_rules=<a string>
-
Si se proporciona un archivo con --experimental_repository_hash_file, se debe verificar la lista de reglas del repositorio para las que se debe verificar el hash del directorio de salida.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: "true"-
No-op
Etiquetas:no_op
,deprecated
,experimental
- Opciones relacionadas con la salida y la semántica de Bzlmod:
- Se acumulan los usos múltiples de
--allow_yanked_versions=<a string>
-
Se especificaron las versiones del módulo en el formato "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran como retiradas en el registro del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones retiradas harán que falle la resolución. También puedes definir la versión anulada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivar el problema a una falla de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecta una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "warning"-
Verifica si las dependencias directas de `bazel_dep` declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivar el problema como una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el archivo MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
predeterminado: "off"-
Especifica cómo y si se debe usar el archivo de bloqueo. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "error" para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan los usos múltiples de
--override_module=<an equals-separated mapping of module name to path>
- Anula un módulo con una ruta local con el formato <nombre del módulo>=<ruta>. Si la ruta proporcionada es absoluta, se usará tal cual. Si la ruta proporcionada es relativa, será relativa al directorio de trabajo actual. Si la ruta de acceso proporcionada comienza con "%workspace%", es relativa a la raíz del espacio de trabajo, que es el resultado de "bazel info workspace".
- Se acumulan los usos múltiples de
--registry=<a string>
-
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: primero se buscarán los módulos en los registros anteriores y solo se recurrirá a los registros posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemónicas con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemónicas.
- Opciones que especifican o alteran una entrada genérica para un comando de Bazel que no se incluye en otras categorías:
- Valor predeterminado de
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
valor predeterminado: consulta la descripción- Especifica un archivo para configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva (`allow`, `block` o `rewrite`) seguida de un nombre de host (para `allow` y `block`) o dos patrones, uno para la coincidencia y otro para usar como URL sustituta, con referencias inversas que comienzan con `$1`. Es posible que se proporcionen varias directivas `rewrite` para la misma URL y, en este caso, se devolverán varias URLs.
- Opciones varias, no clasificadas de otra manera:
- Se acumulan los usos múltiples de
--override_repository=<an equals-separated mapping of repository name to path>
- Anula un repositorio con una ruta de acceso local con el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es absoluta, se usará tal cual. Si la ruta de acceso proporcionada es relativa, se relacionará con el directorio de trabajo actual. Si la ruta de acceso proporcionada comienza con "%workspace%", es relativa a la raíz del espacio de trabajo, que es el resultado de "bazel info workspace".
Opciones de apagado
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan los usos múltiples de
--distdir=<a path>
-
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: "false"-
Si se configura, la caché del repositorio creará un vínculo físico al archivo en caso de acierto de caché, en lugar de copiarlo. Esto tiene como objetivo ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
predeterminado: "false"-
Si es verdadero, usa una cadena derivada de las URLs de las descargas del repositorio como canonical_id si no se especifica. Esto hace que un cambio en las URLs genere una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no provoquen que la caché oculte repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
predeterminado: "false"-
Si se configura, no se permite la descarga de repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark según este factor. De esta manera, los repositorios externos pueden funcionar en máquinas más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Ajusta todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
valor predeterminado: consulta la descripción-
Especifica la ubicación de la caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que controlan el resultado del comando:
--iff_heap_size_greater_than=<an integer>
predeterminado: "0"-
Si es distinto de cero, el cierre solo se realizará si la memoria total (en MB) que consume la JVM supera este valor.
Etiquetas:loses_incremental_state
,eagerness_to_exit
- Opciones que afectan la rigidez con la que Bazel aplica las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
- Valor predeterminado de
--experimental_repository_hash_file=<a string>
: "" -
Si no está vacío, especifica un archivo que contiene un valor resuelto, con el que se deben verificar los hashes del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan los usos múltiples de
--experimental_verify_repository_rules=<a string>
-
Si se proporciona un archivo con --experimental_repository_hash_file, se debe verificar la lista de reglas del repositorio para las que se debe verificar el hash del directorio de salida.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: "true"-
No-op
Etiquetas:no_op
,deprecated
,experimental
- Opciones relacionadas con la salida y la semántica de Bzlmod:
- Se acumulan los usos múltiples de
--allow_yanked_versions=<a string>
-
Se especificaron las versiones del módulo en el formato "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran como retiradas en el registro del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones retiradas harán que falle la resolución. También puedes definir la versión anulada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivar el problema a una falla de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecta una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "warning"-
Verifica si las dependencias directas de `bazel_dep` declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivar el problema como una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el archivo MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
predeterminado: "off"-
Especifica cómo y si se debe usar el archivo de bloqueo. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "error" para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan los usos múltiples de
--override_module=<an equals-separated mapping of module name to path>
- Anula un módulo con una ruta local con el formato <nombre del módulo>=<ruta>. Si la ruta proporcionada es absoluta, se usará tal cual. Si la ruta proporcionada es relativa, será relativa al directorio de trabajo actual. Si la ruta de acceso proporcionada comienza con "%workspace%", es relativa a la raíz del espacio de trabajo, que es el resultado de "bazel info workspace".
- Se acumulan los usos múltiples de
--registry=<a string>
-
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: primero se buscarán los módulos en los registros anteriores y solo se recurrirá a los registros posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemónicas con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemónicas.
- Opciones que especifican o alteran una entrada genérica para un comando de Bazel que no se incluye en otras categorías:
- Valor predeterminado de
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
valor predeterminado: consulta la descripción- Especifica un archivo para configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva (`allow`, `block` o `rewrite`) seguida de un nombre de host (para `allow` y `block`) o dos patrones, uno para la coincidencia y otro para usar como URL sustituta, con referencias inversas que comienzan con `$1`. Es posible que se proporcionen varias directivas `rewrite` para la misma URL y, en este caso, se devolverán varias URLs.
- Opciones varias, no clasificadas de otra manera:
- Se acumulan los usos múltiples de
--override_repository=<an equals-separated mapping of repository name to path>
- Anula un repositorio con una ruta de acceso local con el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es absoluta, se usará tal cual. Si la ruta de acceso proporcionada es relativa, se relacionará con el directorio de trabajo actual. Si la ruta de acceso proporcionada comienza con "%workspace%", es relativa a la raíz del espacio de trabajo, que es el resultado de "bazel info workspace".
Opciones de sincronización
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan los usos múltiples de
--distdir=<a path>
-
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: "false"-
Si se configura, la caché del repositorio creará un vínculo físico al archivo en caso de acierto de caché, en lugar de copiarlo. Esto tiene como objetivo ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
predeterminado: "false"-
Si es verdadero, usa una cadena derivada de las URLs de las descargas del repositorio como canonical_id si no se especifica. Esto hace que un cambio en las URLs genere una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no provoquen que la caché oculte repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
predeterminado: "false"-
Si se configura, no se permite la descarga de repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark según este factor. De esta manera, los repositorios externos pueden funcionar en máquinas más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Ajusta todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
valor predeterminado: consulta la descripción-
Especifica la ubicación de la caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de la compilación:
--[no]configure
predeterminado: "False"-
Solo se sincronizan los repositorios marcados como "configure" para fines de configuración del sistema.
Etiquetas:changes_inputs
--[no]incompatible_remote_dangling_symlinks
predeterminado: "true"-
Si se establece como verdadero y --incompatible_remote_symlinks también es verdadero, se permite que los vínculos simbólicos en los resultados de la acción queden colgando.
Etiquetas:execution
,incompatible_change
--[no]incompatible_remote_symlinks
predeterminado: "true"-
Si se establece como verdadero, Bazel representará los vínculos simbólicos en los resultados de la acción en el protocolo de ejecución y almacenamiento en caché remotos como tales. De lo contrario, se seguirán los symlinks y se representarán como archivos o directorios. Consulta el problema #6631 para obtener más información.
Etiquetas:execution
,incompatible_change
--[no]keep_going
[-k
] predeterminado: "false"-
Continúa lo más posible después de un error. Si bien no se pueden analizar el destino que falló ni los que dependen de él, sí se pueden analizar otros requisitos previos de estos destinos.
Etiquetas: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">
predeterminado: "auto"-
Cantidad de subprocesos paralelos que se usarán para la fase de carga o análisis. Toma un número entero o una palabra clave (“auto”, “HOST_CPUS”, “HOST_RAM”), seguida opcionalmente de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". "auto" establece un valor predeterminado razonable según los recursos del host. Debe ser 1 como mínimo.
Etiquetas:bazel_internal_configuration
- Se acumulan los usos múltiples de
--only=<a string>
-
Si se proporciona esta opción, solo se sincronizarán los repositorios especificados con ella. Aún se consideran obsoletos todos los paquetes (o todos los que se pueden configurar, si se proporciona --configure).
Etiquetas:changes_inputs
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, a diferencia de su existencia:
- Valor predeterminado de
--bep_maximum_open_remote_upload_files=<an integer>
: "-1" -
Es la cantidad máxima de archivos abiertos permitidos durante la carga de artefactos del BEP.
Etiquetas:affects_outputs
--remote_download_minimal
-
No descarga ningún resultado de compilación remota en la máquina local. Esta marca es un atajo para las marcas --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata y --remote_download_outputs=minimal.
Se expande a:
--nobuild_runfile_links
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=minimal
Etiquetas:affects_outputs
--remote_download_outputs=<all, minimal or toplevel>
predeterminado: "all"-
Si se configura como "mínimo", no se descargan los resultados de compilación remotos en la máquina local, excepto los que requieren las acciones locales. Si se configura como "toplevel", se comporta como "minimal", excepto que también descarga los resultados de los destinos de nivel superior en la máquina local. Ambas opciones pueden reducir significativamente los tiempos de compilación si el ancho de banda de la red es un cuello de botella.
Etiquetas:affects_outputs
- Valor predeterminado de
--remote_download_symlink_template=<a string>
: "" -
En lugar de descargar los resultados de compilación remota en la máquina local, crea vínculos simbólicos. El destino de los vínculos simbólicos se puede especificar en forma de una cadena de plantilla. Esta cadena de plantilla puede contener {hash} y {size_bytes}, que se expanden al hash del objeto y al tamaño en bytes, respectivamente. Por ejemplo, estos vínculos simbólicos pueden apuntar a un sistema de archivos FUSE que carga objetos del CAS a pedido.
Etiquetas:affects_outputs
--remote_download_toplevel
-
Solo descarga los resultados remotos de los destinos de nivel superior en la máquina local. Esta marca es un atajo para las marcas --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata y --remote_download_outputs=toplevel.
Se expande a:
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=toplevel
Etiquetas:affects_outputs
- Opciones que afectan la forma en que Bazel aplica de manera estricta las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
- Valor predeterminado de
--experimental_repository_hash_file=<a string>
: "" -
Si no está vacío, especifica un archivo que contiene un valor resuelto, con el que se deben verificar los hashes del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan los usos múltiples de
--experimental_verify_repository_rules=<a string>
-
Si se proporciona un archivo con --experimental_repository_hash_file, se debe verificar la lista de reglas del repositorio para las que se debe verificar el hash del directorio de salida.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: "true"-
Sin operación
Etiquetas:no_op
,deprecated
,experimental
--[no]incompatible_config_setting_private_default_visibility
predeterminado: "false"-
Si incompatible_enforce_config_setting_visibility=false, esta es una operación nula. De lo contrario, si esta marca es falsa, cualquier config_setting sin un atributo de visibilidad explícito es //visibility:public. Si esta marca es verdadera, config_setting sigue la misma lógica de visibilidad que todas las demás reglas. Consulta https://github.com/bazelbuild/bazel/issues/12933.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
predeterminado: "true"-
Si es verdadero, se aplican las restricciones de visibilidad de config_setting. Si es falso, todos los config_setting son visibles para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones relacionadas con la salida y la semántica de Bzlmod:
- Se acumulan los usos múltiples de
--allow_yanked_versions=<a string>
-
Se especificaron las versiones del módulo en el formato "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran como retiradas en el registro del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones retiradas harán que falle la resolución. También puedes definir la versión anulada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivar el problema a una falla de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecta una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "warning"-
Verifica si las dependencias directas de `bazel_dep` declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivar el problema como una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el archivo MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
predeterminado: "off"-
Especifica cómo y si se debe usar el archivo de bloqueo. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "error" para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan los usos múltiples de
--override_module=<an equals-separated mapping of module name to path>
- Anula un módulo con una ruta local con el formato <nombre del módulo>=<ruta>. Si la ruta proporcionada es absoluta, se usará tal cual. Si la ruta proporcionada es relativa, será relativa al directorio de trabajo actual. Si la ruta de acceso proporcionada comienza con "%workspace%", es relativa a la raíz del espacio de trabajo, que es el resultado de "bazel info workspace".
- Se acumulan los usos múltiples de
--registry=<a string>
-
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: primero se buscarán los módulos en los registros anteriores y solo se recurrirá a los registros posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemónicas con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemónicas.
- Valor predeterminado de
--experimental_repository_resolved_file=<a string>
: "" -
Si no está vacío, escribe un valor de Starlark con la información resuelta de todas las reglas del repositorio de Starlark que se ejecutaron.
Etiquetas:affects_outputs
--remote_print_execution_messages=<failure, success or all>
predeterminado: "failure"-
Elige cuándo imprimir los mensajes de ejecución remota. Los valores válidos son "failure" para imprimir solo en caso de errores, "success" para imprimir solo en caso de éxito y "all" para imprimir siempre.
Etiquetas:terminal_output
- Opciones que especifican o alteran una entrada genérica para un comando de Bazel que no se incluye en otras categorías.:
- Valor predeterminado de
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_circuit_breaker_strategy=<failure>
valor predeterminado: consulta la descripción-
Especifica la estrategia que usará el disyuntor. Las estrategias disponibles son "failure". Si el valor de la opción no es válido, el comportamiento es el mismo que si la opción no estuviera configurada.
Etiquetas:execution
--experimental_downloader_config=<a string>
valor predeterminado: consulta la descripción- Especifica un archivo para configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva (`allow`, `block` o `rewrite`) seguida de un nombre de host (para `allow` y `block`) o dos patrones, uno para la coincidencia y otro para usar como URL sustituta, con referencias inversas que comienzan con `$1`. Es posible que se proporcionen varias directivas `rewrite` para la misma URL y, en este caso, se devolverán varias URLs.
--[no]experimental_guard_against_concurrent_changes
predeterminado: "false"- Desactiva esta opción para inhabilitar la verificación de la hora de creación de los archivos de entrada de una acción antes de subirlos a una caché remota. Puede haber casos en los que el kernel de Linux retrase la escritura de archivos, lo que podría generar falsos positivos.
--experimental_remote_build_event_upload=<all or minimal>
predeterminado: "all"- Si se configura como "all", todos los resultados locales a los que hace referencia el BEP se suben a la caché remota. Si se establece en "mínimo", los resultados locales a los que se hace referencia en BEP no se suben a la caché remota, excepto los archivos que son importantes para los consumidores de BEP (p.ej., registros de pruebas y perfil de sincronización). El esquema bytestream:// siempre se usa para la URI de los archivos, incluso si faltan en la caché remota. El valor predeterminado es “all”.
--[no]experimental_remote_cache_async
predeterminado: "false"- Si es verdadero, las E/S de la caché remota se realizarán en segundo plano en lugar de como parte de una generación.
--[no]experimental_remote_cache_compression
predeterminado: "false"- Si está habilitado, comprime o descomprime los BLOB de caché con zstd.
--experimental_remote_capture_corrupted_outputs=<a path>
valor predeterminado: consulta la descripción- Es la ruta de acceso a un directorio en el que se capturarán los resultados dañados.
--[no]experimental_remote_discard_merkle_trees
predeterminado: "false"- Si se configura como verdadero, se descartan las copias en memoria del árbol de Merkle de la raíz de entrada y las asignaciones de entrada asociadas durante las llamadas a GetActionResult() y Execute(). Esto reduce significativamente el uso de memoria, pero requiere que Bazel vuelva a calcularlos en caso de errores de caché remota y reintentos.
--experimental_remote_downloader=<a string>
valor predeterminado: consulta la descripción- Es el URI de un extremo de la API de Remote Asset que se usará como proxy de descarga remota. Los esquemas admitidos son grpc, grpcs (grpc con TLS habilitado) y unix (sockets UNIX locales). Si no se proporciona ningún esquema, Bazel usará grpcs de forma predeterminada. Consulta https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto.
--[no]experimental_remote_downloader_local_fallback
predeterminado: "false"- Indica si se debe recurrir al descargador local si falla el descargador remoto.
--[no]experimental_remote_execution_keepalive
predeterminado: "false"- Indica si se debe usar keepalive para las llamadas de ejecución remota.
--experimental_remote_failure_rate_threshold=<an integer in 0-100 range>
predeterminado: "10"-
Establece la cantidad permitida de tasa de errores en porcentaje para un período específico después del cual deja de llamar a la caché o al ejecutor remotos. De forma predeterminada, el valor es 10. Si se establece en 0, significa que no hay limitación.
Etiquetas:execution
--experimental_remote_failure_window_interval=<An immutable length of time.>
predeterminado: "60s"-
Es el intervalo en el que se calcula la tasa de fallas de las solicitudes remotas. Si el valor es cero o negativo, la duración del error se calcula durante toda la ejecución.Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
Etiquetas:execution
--[no]experimental_remote_mark_tool_inputs
predeterminado: "false"- Si se establece como verdadero, Bazel marcará las entradas como entradas de herramientas para el ejecutor remoto. Esto se puede usar para implementar trabajadores persistentes remotos.
--[no]experimental_remote_merkle_tree_cache
predeterminado: "false"- Si se establece como verdadero, los cálculos del árbol de Merkle se almacenarán en caché para mejorar la velocidad de verificación de aciertos de la caché remota. La huella de memoria de la caché se controla con --experimental_remote_merkle_tree_cache_size.
--experimental_remote_merkle_tree_cache_size=<a long integer>
predeterminado: "1000"- Es la cantidad de árboles de Merkle que se deben memoizar para mejorar la velocidad de verificación de aciertos de caché remota. Aunque la caché se reduce automáticamente según el control de referencias débiles de Java, pueden producirse errores de memoria insuficiente si se establece un valor demasiado alto. Si se establece en 0, el tamaño de la caché es ilimitado. El valor óptimo varía según el tamaño del proyecto. El valor predeterminado es 1,000.
--[no]experimental_remote_require_cached
predeterminado: "false"- Si se establece en verdadero, se exige que todas las acciones que se pueden ejecutar de forma remota se almacenen en caché; de lo contrario, la compilación fallará. Esto es útil para solucionar problemas de no determinismo, ya que permite verificar si las acciones que deberían almacenarse en caché realmente se almacenan sin insertar de forma espuria resultados nuevos en la caché.
--[no]incompatible_remote_build_event_upload_respect_no_cache
predeterminado: "false"- Si se establece como verdadero, las salidas a las que hace referencia BEP no se suben a la caché remota si la acción de generación no se puede almacenar en caché de forma remota.
--[no]incompatible_remote_downloader_send_all_headers
predeterminado: "true"-
Indica si se deben enviar todos los valores de un encabezado con varios valores al descargador remoto en lugar de solo el primero.
Etiquetas:incompatible_change
--[no]incompatible_remote_output_paths_relative_to_input_root
predeterminado: "false"-
Si se configura como verdadero, las rutas de acceso de salida son relativas a la raíz de entrada en lugar del directorio de trabajo.
Etiquetas:incompatible_change
--[no]incompatible_remote_results_ignore_disk
predeterminado: "true"-
Si se establece como verdadero, --noremote_upload_local_results y --noremote_accept_cached no se aplicarán a la caché de disco. Si se usa una caché combinada:
--noremote_upload_local_results hará que los resultados se escriban en la caché de disco, pero no se suban a la caché remota.
--noremote_accept_cached hará que Bazel busque resultados en la caché del disco, pero no en la caché remota.
Las acciones no-remote-exec pueden acceder a la caché de disco.
Consulta el problema #8216 para obtener más información.
Etiquetas:incompatible_change
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
predeterminado: "false"-
Si se establece como verdadero, Bazel usará el nuevo código de salida 39 en lugar del 34 si la caché remota expulsa blobs durante la compilación.
Etiquetas:incompatible_change
--[no]remote_accept_cached
predeterminado: "true"- Indica si se deben aceptar los resultados de acciones almacenados en caché de forma remota.
--remote_bytestream_uri_prefix=<a string>
valor predeterminado: consulta la descripción- Es el nombre de host y el nombre de la instancia que se usarán en los URIs bytestream:// que se escriben en los flujos de eventos de compilación. Esta opción se puede configurar cuando las compilaciones se realizan con un proxy, lo que hace que los valores de --remote_executor y --remote_instance_name ya no correspondan al nombre canónico del servicio de ejecución remota. Si no se configura, el valor predeterminado será “${hostname}/${instance_name}”.
--remote_cache=<a string>
valor predeterminado: consulta la descripción- Es el URI de un extremo de almacenamiento en caché. Los esquemas admitidos son http, https, grpc, grpcs (grpc con TLS habilitado) y unix (sockets locales de UNIX). Si no se proporciona ningún esquema, Bazel usará grpcs de forma predeterminada. Especifica el esquema grpc://, http:// o unix: para inhabilitar TLS. Consulta https://bazel.build/remote/caching.
- Se acumulan los usos múltiples de
--remote_cache_header=<a 'name=value' assignment>
- Especifica un encabezado que se incluirá en las solicitudes de caché: --remote_cache_header=Name=Value. Se pueden pasar varios encabezados especificando la marca varias veces. Los valores múltiples para el mismo nombre se convertirán en una lista separada por comas.
- Se acumulan los usos múltiples de
--remote_default_exec_properties=<a 'name=value' assignment>
-
Establece las propiedades de ejecución predeterminadas que se usarán como la plataforma de ejecución remota si una plataforma de ejecución aún no establece exec_properties.
Etiquetas:affects_outputs
- Valor predeterminado de
--remote_default_platform_properties=<a string>
: "" - Establece las propiedades de la plataforma predeterminada que se configurarán para la API de ejecución remota, si la plataforma de ejecución aún no establece remote_execution_properties. Este valor también se usará si la plataforma host se selecciona como la plataforma de ejecución para la ejecución remota.
- Se acumulan los usos múltiples de
--remote_downloader_header=<a 'name=value' assignment>
- Especifica un encabezado que se incluirá en las solicitudes del descargador remoto: --remote_downloader_header=Name=Value. Se pueden pasar varios encabezados especificando la marca varias veces. Los valores múltiples para el mismo nombre se convertirán en una lista separada por comas.
- Se acumulan los usos múltiples de
--remote_exec_header=<a 'name=value' assignment>
- Especifica un encabezado que se incluirá en las solicitudes de ejecución: --remote_exec_header=Name=Value. Se pueden pasar varios encabezados especificando la marca varias veces. Los valores múltiples para el mismo nombre se convertirán en una lista separada por comas.
--remote_execution_priority=<an integer>
predeterminado: "0"- Es la prioridad relativa de las acciones que se ejecutarán de forma remota. La semántica de los valores de prioridad particulares depende del servidor.
--remote_executor=<a string>
valor predeterminado: consulta la descripción- HOST o HOST:PORT de un extremo de ejecución remota. Los esquemas admitidos son grpc, grpcs (grpc con TLS habilitado) y unix (sockets UNIX locales). Si no se proporciona ningún esquema, Bazel usará grpcs de forma predeterminada. Especifica el esquema grpc:// o unix: para inhabilitar TLS.
--remote_grpc_log=<a path>
valor predeterminado: consulta la descripción- Si se especifica, es la ruta de acceso a un archivo para registrar detalles relacionados con las llamadas a gRPC. Este registro consta de una secuencia de mensajes .proto serializados com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry, en la que cada mensaje tiene como prefijo un varint que denota el tamaño del siguiente mensaje .proto serializado, como lo realiza el método LogEntry.writeDelimitedTo(OutputStream).
- Se acumulan los usos múltiples de
--remote_header=<a 'name=value' assignment>
- Especifica un encabezado que se incluirá en las solicitudes: --remote_header=Name=Value. Se pueden pasar varios encabezados especificando la marca varias veces. Los valores múltiples para el mismo nombre se convertirán en una lista separada por comas.
- Valor predeterminado de
--remote_instance_name=<a string>
: "" - Es el valor que se pasará como instance_name en la API de ejecución remota.
--[no]remote_local_fallback
predeterminado: "false"- Indica si se debe recurrir a la estrategia de ejecución local independiente si falla la ejecución remota.
--remote_local_fallback_strategy=<a string>
predeterminado: "local"- Es una operación nula y está obsoleta. Consulta https://github.com/bazelbuild/bazel/issues/7480 para obtener más información.
--remote_max_connections=<an integer>
valor predeterminado: "100"-
Limita la cantidad máxima de conexiones simultáneas a la caché o al ejecutor remotos. De forma predeterminada, el valor es 100. Si se establece en 0, significa que no hay limitación.
En el caso de la caché remota HTTP, una conexión TCP puede controlar una solicitud a la vez, por lo que Bazel puede realizar hasta --remote_max_connections solicitudes simultáneas.
En el caso del ejecutor y la caché remotos de gRPC, un canal de gRPC suele controlar más de 100 solicitudes simultáneas, por lo que Bazel podría realizar alrededor de `--remote_max_connections * 100` solicitudes simultáneas.
Etiquetas:host_machine_resource_optimizations
--remote_proxy=<a string>
valor predeterminado: consulta la descripción- Conéctate a la caché remota a través de un proxy. Actualmente, esta marca solo se puede usar para configurar un socket de dominio Unix (unix:/ruta/al/socket).
--remote_result_cache_priority=<an integer>
predeterminado: "0"- Es la prioridad relativa de las acciones remotas que se almacenarán en la caché remota. La semántica de los valores de prioridad particulares depende del servidor.
--remote_retries=<an integer>
predeterminado: "5"- Es la cantidad máxima de intentos para reintentar un error transitorio. Si se establece en 0, se inhabilitan los reintentos.
--remote_retry_max_delay=<An immutable length of time.>
predeterminado: "5s"- Es la demora máxima de retirada entre los reintentos remotos. Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
--remote_timeout=<An immutable length of time.>
predeterminado: "60s"- Es la cantidad máxima de tiempo que se espera para las llamadas de ejecución remota y de caché. Para la caché de REST, este es el tiempo de espera de conexión y de lectura. Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
--[no]remote_upload_local_results
predeterminado: "true"- Indica si se deben subir los resultados de las acciones ejecutadas de forma local a la caché remota si esta lo admite y el usuario está autorizado para hacerlo.
--[no]remote_verify_downloads
predeterminado: "true"- Si se configura como verdadero, Bazel calculará la suma de hash de todas las descargas remotas y descartará los valores almacenados en caché de forma remota si no coinciden con el valor esperado.
- Opciones varias, no clasificadas de otra manera:
- Se acumulan los usos múltiples de
--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.>
- Configura un auxiliar de credenciales para recuperar credenciales de autorización para la recuperación de repositorios, el almacenamiento en caché y la ejecución remotos, y el servicio de eventos de compilación. Las credenciales proporcionadas por un asistente tienen prioridad sobre las credenciales proporcionadas por --google_default_credentials, --google_credentials, un archivo .netrc o el parámetro de autenticación para repository_ctx.download y repository_ctx.download_and_extract. Se puede especificar varias veces para configurar varios asistentes. Para obtener más información, consulta https://github.com/bazelbuild/proposals/blob/main/designs/2022-06-07-bazel-credential-helpers.md.
--credential_helper_cache_duration=<An immutable length of time.>
predeterminado: "30 min"- Es la duración durante la que se almacenan en caché las credenciales proporcionadas por un auxiliar de credenciales. Si se invoca con un valor diferente, se ajustará la vida útil de las entradas existentes. Pasa cero para borrar la caché. Un comando clean siempre borra la caché, independientemente de esta marca.
--credential_helper_timeout=<An immutable length of time.>
predeterminado: "10s"- Configura el tiempo de espera para un auxiliar de credenciales. Los auxiliares de credenciales que no respondan dentro de este tiempo de espera fallarán en la invocación.
- Valor predeterminado de
--deleted_packages=<comma-separated list of package names>
: "" - Es una lista separada por comas de los nombres de los paquetes que el sistema de compilación considerará inexistentes, incluso si son visibles en algún lugar de la ruta de acceso del paquete. Usa esta opción cuando borres un subpaquete "x/y" de un paquete existente "x". Por ejemplo, después de borrar x/y/BUILD en tu cliente, es posible que el sistema de compilación muestre un error si encuentra la etiqueta "//x:y/z" si otra entrada de package_path aún la proporciona. Si especificas --deleted_packages x/y, se evita este problema.
--disk_cache=<a path>
valor predeterminado: consulta la descripción- Es la ruta de acceso a un directorio en el que Bazel puede leer y escribir acciones y resultados de acciones. Si el directorio no existe, se creará.
--google_auth_scopes=<comma-separated list of options>
valor predeterminado: "https://www.googleapis.com/auth/cloud-platform"- Lista separada por comas de los permisos de autenticación de Google Cloud.
--google_credentials=<a string>
valor predeterminado: consulta la descripción- Especifica el archivo desde el que se obtienen las credenciales de autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más detalles.
--[no]google_default_credentials
predeterminado: "false"- Indica si se deben usar las "credenciales predeterminadas de la aplicación de Google" para la autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más detalles. Está inhabilitado de forma predeterminada.
--grpc_keepalive_time=<An immutable length of time.>
valor predeterminado: consulta la descripción- Configura los pings de keep-alive para las conexiones gRPC salientes. Si se configura, Bazel envía pings después de este tiempo sin operaciones de lectura en la conexión, pero solo si hay al menos una llamada de gRPC pendiente. Los tiempos se tratan con una granularidad de segundos; es un error establecer un valor inferior a un segundo. De forma predeterminada, los pings de Keep-Alive están inhabilitados. Antes de habilitar este parámetro de configuración, debes coordinarte con el propietario del servicio. Por ejemplo, para establecer un valor de 30 segundos en esta marca, se debe hacer de la siguiente manera: --grpc_keepalive_time=30s
--grpc_keepalive_timeout=<An immutable length of time.>
predeterminado: "20s"- Configura un tiempo de espera de keep-alive para las conexiones gRPC salientes. Si los pings de keep-alive están habilitados con --grpc_keepalive_time, Bazel agota el tiempo de espera de una conexión si no recibe una respuesta de ping después de este tiempo. Los tiempos se tratan con una granularidad de segundos; es un error establecer un valor inferior a un segundo. Si los pings de conexión activa están inhabilitados, se ignorará este parámetro de configuración.
- Se acumulan los usos múltiples de
--override_repository=<an equals-separated mapping of repository name to path>
- Anula un repositorio con una ruta de acceso local con el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es absoluta, se usará tal cual. Si la ruta de acceso proporcionada es relativa, se relacionará con el directorio de trabajo actual. Si la ruta de acceso proporcionada comienza con "%workspace%", es relativa a la raíz del espacio de trabajo, que es el resultado de "bazel info workspace".
--package_path=<colon-separated list of options>
valor predeterminado: "%workspace%"- Es una lista separada por dos puntos de las ubicaciones en las que se buscarán paquetes. Los elementos que comienzan con "%workspace%" son relativos al espacio de trabajo que los contiene. Si se omite o está vacío, el valor predeterminado es el resultado de "bazel info default-package-path".
--[no]show_loading_progress
predeterminado: "true"- Si está habilitado, hace que Bazel imprima mensajes de "Loading package:".
--tls_certificate=<a string>
valor predeterminado: consulta la descripción- Especifica una ruta de acceso a un certificado TLS que se considera de confianza para firmar certificados de servidor.
--tls_client_certificate=<a string>
valor predeterminado: consulta la descripción- Especifica el certificado de cliente TLS que se usará. También debes proporcionar una clave de cliente para habilitar la autenticación del cliente.
--tls_client_key=<a string>
valor predeterminado: consulta la descripción- Especifica la clave del cliente TLS que se usará. También debes proporcionar un certificado de cliente para habilitar la autenticación del cliente.
Opciones de prueba
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan los usos múltiples de
--distdir=<a path>
-
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: "false"-
Si se configura, la caché del repositorio creará un vínculo físico al archivo en caso de acierto de caché, en lugar de copiarlo. Esto tiene como objetivo ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
predeterminado: "false"-
Si es verdadero, usa una cadena derivada de las URLs de las descargas del repositorio como canonical_id si no se especifica. Esto hace que un cambio en las URLs genere una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no provoquen que la caché oculte repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
predeterminado: "false"-
Si se configura, no se permite la descarga de repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark según este factor. De esta manera, los repositorios externos pueden funcionar en máquinas más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Ajusta todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
valor predeterminado: consulta la descripción-
Especifica la ubicación de la caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de la compilación:
--[no]incompatible_remote_dangling_symlinks
predeterminado: "true"-
Si se establece como verdadero y --incompatible_remote_symlinks también es verdadero, se permite que los vínculos simbólicos en los resultados de la acción queden colgando.
Etiquetas:execution
,incompatible_change
--[no]incompatible_remote_symlinks
predeterminado: "true"-
Si se establece como verdadero, Bazel representará los vínculos simbólicos en los resultados de la acción en el protocolo de ejecución y almacenamiento en caché remotos como tales. De lo contrario, se seguirán los symlinks y se representarán como archivos o directorios. Consulta el problema #6631 para obtener más información.
Etiquetas:execution
,incompatible_change
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
- Valor predeterminado de
--bep_maximum_open_remote_upload_files=<an integer>
: "-1" -
Es la cantidad máxima de archivos abiertos permitidos durante la carga de artefactos del BEP.
Etiquetas:affects_outputs
--remote_download_minimal
-
No descarga ningún resultado de compilación remota en la máquina local. Esta marca es un atajo para las marcas --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata y --remote_download_outputs=minimal.
Se expande a:
--nobuild_runfile_links
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=minimal
Etiquetas:affects_outputs
--remote_download_outputs=<all, minimal or toplevel>
predeterminado: "all"-
Si se configura como "mínimo", no se descargan los resultados de compilación remotos en la máquina local, excepto los que requieren las acciones locales. Si se configura como "toplevel", se comporta como "minimal", excepto que también descarga los resultados de los destinos de nivel superior en la máquina local. Ambas opciones pueden reducir significativamente los tiempos de compilación si el ancho de banda de la red es un cuello de botella.
Etiquetas:affects_outputs
- Valor predeterminado de
--remote_download_symlink_template=<a string>
: "" -
En lugar de descargar los resultados de compilación remota en la máquina local, crea vínculos simbólicos. El destino de los vínculos simbólicos se puede especificar en forma de una cadena de plantilla. Esta cadena de plantilla puede contener {hash} y {size_bytes}, que se expanden al hash del objeto y al tamaño en bytes, respectivamente. Por ejemplo, estos vínculos simbólicos pueden apuntar a un sistema de archivos FUSE que carga objetos del CAS a pedido.
Etiquetas:affects_outputs
--remote_download_toplevel
-
Solo descarga los resultados remotos de los destinos de nivel superior en la máquina local. Esta marca es un atajo para las marcas --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata y --remote_download_outputs=toplevel.
Se expande a:
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=toplevel
Etiquetas:affects_outputs
- Opciones que afectan la forma en que Bazel aplica de manera estricta las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
- Valor predeterminado de
--experimental_repository_hash_file=<a string>
: "" -
Si no está vacío, especifica un archivo que contiene un valor resuelto, con el que se deben verificar los hashes del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan los usos múltiples de
--experimental_verify_repository_rules=<a string>
-
Si se proporciona un archivo con --experimental_repository_hash_file, se debe verificar la lista de reglas del repositorio para las que se debe verificar el hash del directorio de salida.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: "true"-
No-op
Etiquetas:no_op
,deprecated
,experimental
- Opciones relacionadas con la salida y la semántica de Bzlmod:
- Se acumulan los usos múltiples de
--allow_yanked_versions=<a string>
-
Se especificaron las versiones del módulo en el formato "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran como retiradas en el registro del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones retiradas harán que falle la resolución. También puedes definir la versión anulada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivar el problema a una falla de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecta una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "warning"-
Verifica si las dependencias directas de `bazel_dep` declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivar el problema como una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el archivo MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
predeterminado: "off"-
Especifica cómo y si se debe usar el archivo de bloqueo. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "error" para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan los usos múltiples de
--override_module=<an equals-separated mapping of module name to path>
- Anula un módulo con una ruta local con el formato <nombre del módulo>=<ruta>. Si la ruta proporcionada es absoluta, se usará tal cual. Si la ruta proporcionada es relativa, será relativa al directorio de trabajo actual. Si la ruta de acceso proporcionada comienza con "%workspace%", es relativa a la raíz del espacio de trabajo, que es el resultado de "bazel info workspace".
- Se acumulan los usos múltiples de
--registry=<a string>
-
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: primero se buscarán los módulos en los registros anteriores y solo se recurrirá a los registros posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemónicas con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemónicas.
--[no]print_relative_test_log_paths
predeterminado: "false"-
Si es verdadero, cuando se imprima la ruta de acceso a un registro de prueba, se usará la ruta de acceso relativa que utiliza el vínculo simbólico de conveniencia "testlogs". Nota: Una invocación posterior de "compilación", "prueba", etcétera, con una configuración diferente puede hacer que cambie el destino de este vínculo simbólico, lo que hace que la ruta impresa anteriormente ya no sea útil.
Etiquetas:affects_outputs
--remote_print_execution_messages=<failure, success or all>
predeterminado: "failure"-
Elige cuándo imprimir los mensajes de ejecución remota. Los valores válidos son "failure" para imprimir solo en caso de errores, "success" para imprimir solo en caso de éxito y "all" para imprimir siempre.
Etiquetas:terminal_output
--[no]test_verbose_timeout_warnings
predeterminado: "false"-
Si es verdadero, imprime advertencias adicionales cuando el tiempo de ejecución real de la prueba no coincide con el tiempo de espera definido por la prueba (ya sea implícito o explícito).
Etiquetas:affects_outputs
--[no]verbose_test_summary
predeterminado: "true"-
Si es verdadero, imprime información adicional (sincronización, cantidad de ejecuciones fallidas, etc.) en el resumen de la prueba.
Etiquetas:affects_outputs
- Opciones que especifican o alteran una entrada genérica para un comando de Bazel que no se incluye en otras categorías.:
- Valor predeterminado de
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_circuit_breaker_strategy=<failure>
valor predeterminado: consulta la descripción-
Especifica la estrategia que usará el disyuntor. Las estrategias disponibles son "failure". Si el valor de la opción no es válido, el comportamiento es el mismo que si la opción no estuviera configurada.
Etiquetas:execution
--experimental_downloader_config=<a string>
valor predeterminado: consulta la descripción- Especifica un archivo para configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva (`allow`, `block` o `rewrite`) seguida de un nombre de host (para `allow` y `block`) o dos patrones, uno para la coincidencia y otro para usar como URL sustituta, con referencias inversas que comienzan con `$1`. Es posible que se proporcionen varias directivas `rewrite` para la misma URL y, en este caso, se devolverán varias URLs.
--[no]experimental_guard_against_concurrent_changes
predeterminado: "false"- Desactiva esta opción para inhabilitar la verificación de la hora de creación de los archivos de entrada de una acción antes de subirlos a una caché remota. Puede haber casos en los que el kernel de Linux retrase la escritura de archivos, lo que podría generar falsos positivos.
--experimental_remote_build_event_upload=<all or minimal>
predeterminado: "all"- Si se configura como "all", todos los resultados locales a los que hace referencia el BEP se suben a la caché remota. Si se establece en "mínimo", los resultados locales a los que se hace referencia en BEP no se suben a la caché remota, excepto los archivos que son importantes para los consumidores de BEP (p.ej., registros de pruebas y perfil de sincronización). El esquema bytestream:// siempre se usa para la URI de los archivos, incluso si faltan en la caché remota. El valor predeterminado es “all”.
--[no]experimental_remote_cache_async
predeterminado: "false"- Si es verdadero, las E/S de la caché remota se realizarán en segundo plano en lugar de como parte de una generación.
--[no]experimental_remote_cache_compression
predeterminado: "false"- Si está habilitado, comprime o descomprime los BLOB de caché con zstd.
--experimental_remote_capture_corrupted_outputs=<a path>
valor predeterminado: consulta la descripción- Es la ruta de acceso a un directorio en el que se capturarán los resultados dañados.
--[no]experimental_remote_discard_merkle_trees
predeterminado: "false"- Si se configura como verdadero, se descartan las copias en memoria del árbol de Merkle de la raíz de entrada y las asignaciones de entrada asociadas durante las llamadas a GetActionResult() y Execute(). Esto reduce significativamente el uso de memoria, pero requiere que Bazel vuelva a calcularlos en caso de errores de caché remota y reintentos.
--experimental_remote_downloader=<a string>
valor predeterminado: consulta la descripción- Es el URI de un extremo de la API de Remote Asset que se usará como proxy de descarga remota. Los esquemas admitidos son grpc, grpcs (grpc con TLS habilitado) y unix (sockets UNIX locales). Si no se proporciona ningún esquema, Bazel usará grpcs de forma predeterminada. Consulta https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto.
--[no]experimental_remote_downloader_local_fallback
predeterminado: "false"- Indica si se debe recurrir al descargador local si falla el descargador remoto.
--[no]experimental_remote_execution_keepalive
predeterminado: "false"- Indica si se debe usar keepalive para las llamadas de ejecución remota.
--experimental_remote_failure_rate_threshold=<an integer in 0-100 range>
predeterminado: "10"-
Establece la cantidad permitida de tasa de errores en porcentaje para un período específico después del cual deja de llamar a la caché o al ejecutor remotos. De forma predeterminada, el valor es 10. Si se establece en 0, significa que no hay limitación.
Etiquetas:execution
--experimental_remote_failure_window_interval=<An immutable length of time.>
predeterminado: "60s"-
Es el intervalo en el que se calcula la tasa de fallas de las solicitudes remotas. Si el valor es cero o negativo, la duración del error se calcula durante toda la ejecución.Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
Etiquetas:execution
--[no]experimental_remote_mark_tool_inputs
predeterminado: "false"- Si se establece como verdadero, Bazel marcará las entradas como entradas de herramientas para el ejecutor remoto. Esto se puede usar para implementar trabajadores persistentes remotos.
--[no]experimental_remote_merkle_tree_cache
predeterminado: "false"- Si se establece como verdadero, los cálculos del árbol de Merkle se almacenarán en caché para mejorar la velocidad de verificación de aciertos de la caché remota. La huella de memoria de la caché se controla con --experimental_remote_merkle_tree_cache_size.
--experimental_remote_merkle_tree_cache_size=<a long integer>
predeterminado: "1000"- Es la cantidad de árboles de Merkle que se deben memoizar para mejorar la velocidad de verificación de aciertos de caché remota. Aunque la caché se reduce automáticamente según el control de referencias débiles de Java, pueden producirse errores de memoria insuficiente si se establece un valor demasiado alto. Si se establece en 0, el tamaño de la caché es ilimitado. El valor óptimo varía según el tamaño del proyecto. El valor predeterminado es 1,000.
--[no]experimental_remote_require_cached
predeterminado: "false"- Si se establece en verdadero, se exige que todas las acciones que se pueden ejecutar de forma remota se almacenen en caché; de lo contrario, la compilación fallará. Esto es útil para solucionar problemas de no determinismo, ya que permite verificar si las acciones que deberían almacenarse en caché realmente se almacenan sin insertar de forma espuria resultados nuevos en la caché.
--[no]incompatible_remote_build_event_upload_respect_no_cache
predeterminado: "false"- Si se establece como verdadero, las salidas a las que hace referencia BEP no se suben a la caché remota si la acción de generación no se puede almacenar en caché de forma remota.
--[no]incompatible_remote_downloader_send_all_headers
predeterminado: "true"-
Indica si se deben enviar todos los valores de un encabezado con varios valores al descargador remoto en lugar de solo el primero.
Etiquetas:incompatible_change
--[no]incompatible_remote_output_paths_relative_to_input_root
predeterminado: "false"-
Si se configura como verdadero, las rutas de acceso de salida son relativas a la raíz de entrada en lugar del directorio de trabajo.
Etiquetas:incompatible_change
--[no]incompatible_remote_results_ignore_disk
predeterminado: "true"-
Si se establece como verdadero, --noremote_upload_local_results y --noremote_accept_cached no se aplicarán a la caché de disco. Si se usa una caché combinada:
--noremote_upload_local_results hará que los resultados se escriban en la caché de disco, pero no se suban a la caché remota.
--noremote_accept_cached hará que Bazel busque resultados en la caché del disco, pero no en la caché remota.
Las acciones no-remote-exec pueden acceder a la caché de disco.
Consulta el problema #8216 para obtener más información.
Etiquetas:incompatible_change
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
predeterminado: "false"-
Si se establece como verdadero, Bazel usará el nuevo código de salida 39 en lugar del 34 si la caché remota expulsa blobs durante la compilación.
Etiquetas:incompatible_change
--[no]remote_accept_cached
predeterminado: "true"- Indica si se deben aceptar los resultados de acciones almacenados en caché de forma remota.
--remote_bytestream_uri_prefix=<a string>
valor predeterminado: consulta la descripción- Es el nombre de host y el nombre de la instancia que se usarán en los URIs bytestream:// que se escriben en los flujos de eventos de compilación. Esta opción se puede configurar cuando las compilaciones se realizan con un proxy, lo que hace que los valores de --remote_executor y --remote_instance_name ya no correspondan al nombre canónico del servicio de ejecución remota. Si no se configura, el valor predeterminado será “${hostname}/${instance_name}”.
--remote_cache=<a string>
valor predeterminado: consulta la descripción- Es el URI de un extremo de almacenamiento en caché. Los esquemas admitidos son http, https, grpc, grpcs (grpc con TLS habilitado) y unix (sockets locales de UNIX). Si no se proporciona ningún esquema, Bazel usará grpcs de forma predeterminada. Especifica el esquema grpc://, http:// o unix: para inhabilitar TLS. Consulta https://bazel.build/remote/caching.
- Se acumulan los usos múltiples de
--remote_cache_header=<a 'name=value' assignment>
- Especifica un encabezado que se incluirá en las solicitudes de caché: --remote_cache_header=Name=Value. Se pueden pasar varios encabezados especificando la marca varias veces. Los valores múltiples para el mismo nombre se convertirán en una lista separada por comas.
- Se acumulan los usos múltiples de
--remote_default_exec_properties=<a 'name=value' assignment>
-
Establece las propiedades de ejecución predeterminadas que se usarán como la plataforma de ejecución remota si una plataforma de ejecución aún no establece exec_properties.
Etiquetas:affects_outputs
- Valor predeterminado de
--remote_default_platform_properties=<a string>
: "" - Establece las propiedades de la plataforma predeterminada que se configurarán para la API de ejecución remota, si la plataforma de ejecución aún no establece remote_execution_properties. Este valor también se usará si la plataforma host se selecciona como la plataforma de ejecución para la ejecución remota.
- Se acumulan los usos múltiples de
--remote_downloader_header=<a 'name=value' assignment>
- Especifica un encabezado que se incluirá en las solicitudes del descargador remoto: --remote_downloader_header=Name=Value. Se pueden pasar varios encabezados especificando la marca varias veces. Los valores múltiples para el mismo nombre se convertirán en una lista separada por comas.
- Se acumulan los usos múltiples de
--remote_exec_header=<a 'name=value' assignment>
- Especifica un encabezado que se incluirá en las solicitudes de ejecución: --remote_exec_header=Name=Value. Se pueden pasar varios encabezados especificando la marca varias veces. Los valores múltiples para el mismo nombre se convertirán en una lista separada por comas.
--remote_execution_priority=<an integer>
predeterminado: "0"- Es la prioridad relativa de las acciones que se ejecutarán de forma remota. La semántica de los valores de prioridad particulares depende del servidor.
--remote_executor=<a string>
valor predeterminado: consulta la descripción- HOST o HOST:PORT de un extremo de ejecución remota. Los esquemas admitidos son grpc, grpcs (grpc con TLS habilitado) y unix (sockets UNIX locales). Si no se proporciona ningún esquema, Bazel usará grpcs de forma predeterminada. Especifica el esquema grpc:// o unix: para inhabilitar TLS.
--remote_grpc_log=<a path>
valor predeterminado: consulta la descripción- Si se especifica, es la ruta de acceso a un archivo para registrar detalles relacionados con las llamadas a gRPC. Este registro consta de una secuencia de mensajes .proto serializados com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry, en la que cada mensaje tiene como prefijo un varint que denota el tamaño del siguiente mensaje .proto serializado, como lo realiza el método LogEntry.writeDelimitedTo(OutputStream).
- Se acumulan los usos múltiples de
--remote_header=<a 'name=value' assignment>
- Especifica un encabezado que se incluirá en las solicitudes: --remote_header=Name=Value. Se pueden pasar varios encabezados especificando la marca varias veces. Los valores múltiples para el mismo nombre se convertirán en una lista separada por comas.
- Valor predeterminado de
--remote_instance_name=<a string>
: "" - Es el valor que se pasará como instance_name en la API de ejecución remota.
--[no]remote_local_fallback
predeterminado: "false"- Indica si se debe recurrir a la estrategia de ejecución local independiente si falla la ejecución remota.
--remote_local_fallback_strategy=<a string>
predeterminado: "local"- Es una operación nula y está obsoleta. Consulta https://github.com/bazelbuild/bazel/issues/7480 para obtener más información.
--remote_max_connections=<an integer>
valor predeterminado: "100"-
Limita la cantidad máxima de conexiones simultáneas a la caché o al ejecutor remotos. De forma predeterminada, el valor es 100. Si se establece en 0, significa que no hay limitación.
En el caso de la caché remota HTTP, una conexión TCP puede controlar una solicitud a la vez, por lo que Bazel puede realizar hasta --remote_max_connections solicitudes simultáneas.
En el caso del ejecutor y la caché remotos de gRPC, un canal de gRPC suele controlar más de 100 solicitudes simultáneas, por lo que Bazel podría realizar alrededor de `--remote_max_connections * 100` solicitudes simultáneas.
Etiquetas:host_machine_resource_optimizations
--remote_proxy=<a string>
valor predeterminado: consulta la descripción- Conéctate a la caché remota a través de un proxy. Actualmente, esta marca solo se puede usar para configurar un socket de dominio Unix (unix:/ruta/al/socket).
--remote_result_cache_priority=<an integer>
predeterminado: "0"- Es la prioridad relativa de las acciones remotas que se almacenarán en la caché remota. La semántica de los valores de prioridad particulares depende del servidor.
--remote_retries=<an integer>
predeterminado: "5"- Es la cantidad máxima de intentos para reintentar un error transitorio. Si se establece en 0, se inhabilitan los reintentos.
--remote_retry_max_delay=<An immutable length of time.>
predeterminado: "5s"- Es la demora máxima de retirada entre los reintentos remotos. Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
--remote_timeout=<An immutable length of time.>
predeterminado: "60s"- Es la cantidad máxima de tiempo que se espera para las llamadas de ejecución remota y de caché. Para la caché de REST, este es el tiempo de espera de conexión y de lectura. Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
--[no]remote_upload_local_results
predeterminado: "true"- Indica si se deben subir los resultados de las acciones ejecutadas de forma local a la caché remota si esta lo admite y el usuario está autorizado para hacerlo.
--[no]remote_verify_downloads
predeterminado: "true"- Si se configura como verdadero, Bazel calculará la suma de hash de todas las descargas remotas y descartará los valores almacenados en caché de forma remota si no coinciden con el valor esperado.
- Opciones varias, no clasificadas de otra manera:
- Se acumulan los usos múltiples de
--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.>
- Configura un auxiliar de credenciales para recuperar credenciales de autorización para la recuperación de repositorios, el almacenamiento en caché y la ejecución remotos, y el servicio de eventos de compilación. Las credenciales proporcionadas por un asistente tienen prioridad sobre las credenciales proporcionadas por --google_default_credentials, --google_credentials, un archivo .netrc o el parámetro de autenticación para repository_ctx.download y repository_ctx.download_and_extract. Se puede especificar varias veces para configurar varios asistentes. Para obtener más información, consulta https://github.com/bazelbuild/proposals/blob/main/designs/2022-06-07-bazel-credential-helpers.md.
--credential_helper_cache_duration=<An immutable length of time.>
predeterminado: "30 min"- Es la duración durante la que se almacenan en caché las credenciales proporcionadas por un auxiliar de credenciales. Si se invoca con un valor diferente, se ajustará la vida útil de las entradas existentes. Pasa cero para borrar la caché. Un comando clean siempre borra la caché, independientemente de esta marca.
--credential_helper_timeout=<An immutable length of time.>
predeterminado: "10s"- Configura el tiempo de espera para un auxiliar de credenciales. Los auxiliares de credenciales que no respondan dentro de este tiempo de espera fallarán en la invocación.
--disk_cache=<a path>
valor predeterminado: consulta la descripción- Es la ruta de acceso a un directorio en el que Bazel puede leer y escribir acciones y resultados de acciones. Si el directorio no existe, se creará.
--google_auth_scopes=<comma-separated list of options>
valor predeterminado: "https://www.googleapis.com/auth/cloud-platform"- Lista separada por comas de los permisos de autenticación de Google Cloud.
--google_credentials=<a string>
valor predeterminado: consulta la descripción- Especifica el archivo desde el que se obtienen las credenciales de autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más detalles.
--[no]google_default_credentials
predeterminado: "false"- Indica si se deben usar las "credenciales predeterminadas de la aplicación de Google" para la autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más detalles. Está inhabilitado de forma predeterminada.
--grpc_keepalive_time=<An immutable length of time.>
valor predeterminado: consulta la descripción- Configura los pings de keep-alive para las conexiones gRPC salientes. Si se configura, Bazel envía pings después de este tiempo sin operaciones de lectura en la conexión, pero solo si hay al menos una llamada de gRPC pendiente. Los tiempos se tratan con una granularidad de segundos; es un error establecer un valor inferior a un segundo. De forma predeterminada, los pings de Keep-Alive están inhabilitados. Antes de habilitar este parámetro de configuración, debes coordinarte con el propietario del servicio. Por ejemplo, para establecer un valor de 30 segundos en esta marca, se debe hacer de la siguiente manera: --grpc_keepalive_time=30s
--grpc_keepalive_timeout=<An immutable length of time.>
predeterminado: "20s"- Configura un tiempo de espera de keep-alive para las conexiones gRPC salientes. Si los pings de keep-alive están habilitados con --grpc_keepalive_time, Bazel agota el tiempo de espera de una conexión si no recibe una respuesta de ping después de este tiempo. Los tiempos se tratan con una granularidad de segundos; es un error establecer un valor inferior a un segundo. Si los pings de conexión activa están inhabilitados, se ignorará este parámetro de configuración.
- Se acumulan los usos múltiples de
--override_repository=<an equals-separated mapping of repository name to path>
- Anula un repositorio con una ruta de acceso local con el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es absoluta, se usará tal cual. Si la ruta de acceso proporcionada es relativa, se relacionará con el directorio de trabajo actual. Si la ruta de acceso proporcionada comienza con "%workspace%", es relativa a la raíz del espacio de trabajo, que es el resultado de "bazel info workspace".
--tls_certificate=<a string>
valor predeterminado: consulta la descripción- Especifica una ruta de acceso a un certificado TLS que se considera de confianza para firmar certificados de servidor.
--tls_client_certificate=<a string>
valor predeterminado: consulta la descripción- Especifica el certificado de cliente TLS que se usará. También debes proporcionar una clave de cliente para habilitar la autenticación del cliente.
--tls_client_key=<a string>
valor predeterminado: consulta la descripción- Especifica la clave del cliente TLS que se usará. También debes proporcionar un certificado de cliente para habilitar la autenticación del cliente.
Opciones de versión
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan los usos múltiples de
--distdir=<a path>
-
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: "false"-
Si se configura, la caché del repositorio creará un vínculo físico al archivo en caso de acierto de caché, en lugar de copiarlo. Esto tiene como objetivo ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
predeterminado: "false"-
Si es verdadero, usa una cadena derivada de las URLs de las descargas del repositorio como canonical_id si no se especifica. Esto hace que un cambio en las URLs genere una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no provoquen que la caché oculte repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
predeterminado: "false"-
Si se configura, no se permite la descarga de repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark según este factor. De esta manera, los repositorios externos pueden funcionar en máquinas más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Ajusta todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
valor predeterminado: consulta la descripción-
Especifica la ubicación de la caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
--[no]gnu_format
predeterminado: "false"-
Si se configura, escribe la versión en stdout con las convenciones que se describen en los estándares de GNU.
Etiquetas:affects_outputs
,execution
- Opciones que afectan la forma en que Bazel aplica de manera estricta las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
- Valor predeterminado de
--experimental_repository_hash_file=<a string>
: "" -
Si no está vacío, especifica un archivo que contiene un valor resuelto, con el que se deben verificar los hashes del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan los usos múltiples de
--experimental_verify_repository_rules=<a string>
-
Si se proporciona un archivo con --experimental_repository_hash_file, se debe verificar la lista de reglas del repositorio para las que se debe verificar el hash del directorio de salida.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: "true"-
No-op
Etiquetas:no_op
,deprecated
,experimental
- Opciones relacionadas con la salida y la semántica de Bzlmod:
- Se acumulan los usos múltiples de
--allow_yanked_versions=<a string>
-
Se especificaron las versiones del módulo en el formato "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran como retiradas en el registro del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones retiradas harán que falle la resolución. También puedes definir la versión anulada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivar el problema a una falla de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecta una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "warning"-
Verifica si las dependencias directas de `bazel_dep` declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivar el problema como una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el archivo MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
predeterminado: "off"-
Especifica cómo y si se debe usar el archivo de bloqueo. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "error" para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan los usos múltiples de
--override_module=<an equals-separated mapping of module name to path>
- Anula un módulo con una ruta local con el formato <nombre del módulo>=<ruta>. Si la ruta proporcionada es absoluta, se usará tal cual. Si la ruta proporcionada es relativa, será relativa al directorio de trabajo actual. Si la ruta de acceso proporcionada comienza con "%workspace%", es relativa a la raíz del espacio de trabajo, que es el resultado de "bazel info workspace".
- Se acumulan los usos múltiples de
--registry=<a string>
-
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: primero se buscarán los módulos en los registros anteriores y solo se recurrirá a los registros posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemónicas con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemónicas.
- Opciones que especifican o alteran una entrada genérica para un comando de Bazel que no se incluye en otras categorías:
- Valor predeterminado de
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
valor predeterminado: consulta la descripción- Especifica un archivo para configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva (`allow`, `block` o `rewrite`) seguida de un nombre de host (para `allow` y `block`) o dos patrones, uno para la coincidencia y otro para usar como URL sustituta, con referencias inversas que comienzan con `$1`. Es posible que se proporcionen varias directivas `rewrite` para la misma URL y, en este caso, se devolverán varias URLs.
- Opciones varias, no clasificadas de otra manera:
- Se acumulan los usos múltiples de
--override_repository=<an equals-separated mapping of repository name to path>
- Anula un repositorio con una ruta de acceso local con el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es absoluta, se usará tal cual. Si la ruta de acceso proporcionada es relativa, se relacionará con el directorio de trabajo actual. Si la ruta de acceso proporcionada comienza con "%workspace%", es relativa a la raíz del espacio de trabajo, que es el resultado de "bazel info workspace".
Etiquetas de efecto de opción
unknown |
Esta opción tiene un efecto desconocido o no documentado. |
no_op |
Esta opción no tiene ningún efecto. |
loses_incremental_state |
Cambiar el valor de esta opción puede causar una pérdida significativa del estado incremental, lo que ralentiza las compilaciones. El estado podría perderse debido a un reinicio del servidor o a la invalidación de una gran parte del gráfico de dependencias. |
changes_inputs |
Esta opción cambia de forma activa las entradas que Bazel considera para la compilación, como las restricciones del sistema de archivos, las versiones del repositorio o cualquier otra opción. |
affects_outputs |
Esta opción afecta los resultados de Bazel. Esta etiqueta es intencionalmente amplia, puede incluir efectos transitivos y no especifica el tipo de resultado que afecta. |
build_file_semantics |
Esta opción afecta la semántica de los archivos BUILD o .bzl. |
bazel_internal_configuration |
Esta opción afecta la configuración de la maquinaria interna de Bazel. Por sí sola, esta etiqueta no significa que los artefactos de compilación se vean afectados. |
loading_and_analysis |
Esta opción afecta la carga y el análisis de las dependencias, y la compilación del gráfico de dependencias. |
execution |
Esta opción afecta la fase de ejecución, como las opciones relacionadas con el aislamiento o la ejecución remota. |
host_machine_resource_optimizations |
Esta opción activa una optimización que puede ser específica de la máquina y no se garantiza que funcione en todas las máquinas. La optimización podría incluir una compensación con otros aspectos del rendimiento, como el costo de la memoria o la CPU. |
eagerness_to_exit |
Esta opción cambia la rapidez con la que Bazel saldrá de un error, en los casos en que exista la opción de continuar a pesar del error o finalizar la invocación. |
bazel_monitoring |
Esta opción se usa para supervisar el comportamiento y el rendimiento de Bazel. |
terminal_output |
Esta opción afecta la salida de la terminal de Bazel. |
action_command_lines |
Esta opción cambia los argumentos de la línea de comandos de una o más acciones de compilación. |
test_runner |
Esta opción cambia el entorno del ejecutor de pruebas de la compilación. |
Etiquetas de metadatos de opciones
experimental |
Esta opción activa una función experimental sin garantías de funcionalidad. |
incompatible_change |
Esta opción activa un cambio rotundo. Usa esta opción para probar si tu migración está lista o para obtener acceso anticipado a la nueva función |
deprecated |
Esta opción está obsoleta. Es posible que la función que afecta esté obsoleta o que se prefiera otro método para proporcionar la información. |
explicit_in_output_path |
Esta opción se menciona de forma explícita en el directorio de salida. |