Referencia de línea de comandos

bazel [<startup options>] <command> [<args>]
o
bazel [<startup options>] <command> [<args>] -- [<target patterns>]
Consulta la Guía del usuario para obtener la sintaxis de los patrones de destino.

Sintaxis de la opción

Las opciones se pueden pasar a Bazel de diferentes maneras. Opciones que requieren un valor se puede pasar con un signo igual o un espacio:

--<option>=<value>
--<option> <value>
Algunas opciones tienen una forma abreviada de un solo carácter. en ese caso, la forma abreviada debe pasarse con un solo guion y un espacio.
-<short_form> <value>

Las opciones booleanas se pueden habilitar de la siguiente manera:

--<option>
--<option>=[true|yes|1]
y, luego, inhabilitarlo de la siguiente manera:
--no<option>
--<option>=[false|no|0]

Las opciones de triestado suelen establecerse como automáticas de forma predeterminada y pueden forzar la habilitación de la siguiente manera:

--<option>=[true|yes|1]
o forzar su inhabilitación de la siguiente manera:
--no<option>
--<option>=[false|no|0]

Comandos

analyze-profile Analiza los datos del perfil de compilación.
aquery Analiza los objetivos dados y consulta el gráfico de acciones.
build Compila los destinos especificados.
canonicalize-flags Canonicaliza 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 objetivos de prueba especificados.
cquery Carga, analiza y consulta los destinos especificados con los parámetros de configuración.
dump Vuelca el estado interno del proceso del servidor de Bazel.
fetch Recupera repositorios externos que son requisitos previos para los destinos.
help Imprime ayuda para comandos o el índice.
info Muestra información del entorno de ejecución sobre el servidor de Bazel.
license Imprime la licencia de este software.
mobile-install Instala orientaciones en dispositivos móviles.
mod Consulta el gráfico de dependencia externa de Bzlmod
print_action Imprime los argumentos de la línea de comandos para compilar un archivo.
query Ejecuta una consulta de grafo de dependencia.
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 objetivos de prueba especificados.
version Imprime información de la versión para Bazel.

Opciones de inicio

Opciones que aparecen antes del comando y que el cliente analiza:
Valor predeterminado de --[no]autodetect_server_javabase: "true"
Cuando se pasa --noautodetect_server_javabase, Bazel no recurre al JDK local para ejecutar el servidor de Bazel y, en su lugar, sale.
Etiquetas: affects_outputs y loses_incremental_state
Valor predeterminado de --[no]batch: "falso"
Si se configura, Bazel se ejecutará como un proceso de cliente sin un servidor, en lugar de en el modo estándar de cliente/servidor. Esta función dejó de estar disponible y se quitará. Para evitar que queden servidores, es preferible que apagues el servidor de forma explícita.
Etiquetas: loses_incremental_state, bazel_internal_configuration y deprecated
Valor predeterminado de --[no]batch_cpu_scheduling: "falso"
Solo en Linux; usar “lote” programación de CPU para Blaze. Esta política es útil para cargas de trabajo que no son interactivas, pero que no desean reducir su valor atractivo. Consulta 'man 2 sched_setscheduler'. Si es falso, Bazel no realiza una llamada al sistema.
Etiquetas: host_machine_resource_optimizations
Valor predeterminado de --bazelrc=<path>: ver descripción
La 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 es ú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 y y.rc. 2) z.rc se ignora debido al valor /dev/null anterior. 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 línea de comandos siempre reemplazarán a cualquier opción en bazelrc.
Etiquetas: changes_inputs
Valor predeterminado de --[no]block_for_lock: "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
Valor predeterminado de --[no]client_debug: "falso"
Si es verdadero, registra la información de depuración del cliente en stderr. Cambiar esta opción no hará que el servidor se reinicie.
Etiquetas: affects_outputs y bazel_monitoring
Valor predeterminado de --connect_timeout_secs=<an integer>: "30"
La cantidad de tiempo que el cliente espera cada intento de conexión al servidor
Etiquetas: bazel_internal_configuration
Valor predeterminado de --[no]expand_configs_in_place: "true"
Se cambió la expansión de las marcas --config para que se realicen de manera local, en lugar de una expansión de punto fija entre las opciones de rc normales y las opciones especificadas en la línea de comandos.
Etiquetas: no_op y deprecated
Valor predeterminado de --failure_detail_out=<path>: ver descripción
Si se configura, especifica una ubicación para escribir un mensaje protobuf failed_detail si el servidor experimenta una falla y no puede informarlo a través de gRPC, como de costumbre. De lo contrario, la ubicación será ${OUTPUT_BASE}/failure_detail.rawproto.
Etiquetas: affects_outputs y loses_incremental_state
Valor predeterminado de --[no]home_rc: "true"
Indica si se debe buscar o no el archivo bazelrc de inicio en $HOME/.bazelrc
Etiquetas: changes_inputs
Valor predeterminado de --[no]idle_server_tasks: "true"
Ejecuta System.gc() cuando el servidor está inactivo
Etiquetas: loses_incremental_state y host_machine_resource_optimizations
Valor predeterminado de --[no]ignore_all_rc_files: "falso"
Inhabilita todos los archivos rc, independientemente de los valores de otras marcas de modificación de 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 mejor programación de IO con la llamada del sistema sys_ioprio_set. 0 es la prioridad más alta, 7 es la menor. El programador anticipado solo puede respetar hasta la prioridad 4. Si se establece en un valor negativo, Bazel no realizará una llamada al sistema.
Etiquetas: host_machine_resource_optimizations
Valor predeterminado de --local_startup_timeout_secs=<an integer>: "120"
La cantidad máxima de tiempo que el cliente espera para conectarse al servidor
Etiquetas: bazel_internal_configuration
Valor predeterminado de --macos_qos_class=<a string>: “predeterminado”
Establece la clase de servicio QoS del servidor de Bazel cuando se ejecuta en macOS. Esta marca no tiene efecto en todas las demás plataformas, pero es compatible para garantizar que los archivos rc se puedan compartir entre ellas sin cambios. Los valores posibles son: interactivo por el usuario, iniciado por el usuario, predeterminado, de utilidad y segundo plano.
Etiquetas: host_machine_resource_optimizations
Valor predeterminado de --max_idle_secs=<integer>: "10800"
La cantidad de segundos que el servidor de compilación esperará inactivo antes de apagarse. Cero significa que el servidor nunca se apagará. Esto solo se lee cuando se inicia el servidor; cambiar esta opción no hará que el servidor se reinicie.
Etiquetas: eagerness_to_exit y loses_incremental_state
Valor predeterminado de --output_base=<path>: ver descripción
Si se configura, especifica la ubicación de salida en la que se escribirán todos los resultados 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 a la siguiente invocación de Bazel para este valor, es probable que inicies un nuevo servidor de Bazel adicional. Bazel inicia exactamente un servidor por base de salida especificada. Por lo general, hay una base de salida por lugar de trabajo; sin embargo, con esta opción, puedes tener varias bases de salida por lugar de trabajo y, por lo tanto, ejecutar varias compilaciones para el mismo cliente en la misma máquina de forma simultánea. Consulta la sección "Ayuda de Bazel para apagar" sobre cómo apagar un servidor de Bazel.
Etiquetas: affects_outputs y loses_incremental_state
Valor predeterminado de --output_user_root=<path>: ver descripción
El directorio específico del usuario en el que se escriben todos los resultados de compilación. De forma predeterminada, esta 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 y loses_incremental_state
Valor predeterminado de --[no]preemptible: "falso"
Si es verdadero, el comando se puede interrumpir si se inicia otro comando.
Etiquetas: eagerness_to_exit
Valor predeterminado de --server_jvm_out=<path>: ver descripción
La ubicación para escribir la salida de JVM del servidor. Si no se configura, se establece de forma predeterminada en una ubicación en output_base.
Etiquetas: affects_outputs y loses_incremental_state
Valor predeterminado de --[no]shutdown_on_low_sys_mem: "falso"
Si se configura max_idle_secs y el servidor de compilación ha estado inactivo durante un tiempo, apaga el servidor cuando el sistema tenga poca memoria RAM libre. Solo en Linux.
Etiquetas: eagerness_to_exit y loses_incremental_state
Valor predeterminado de --[no]system_rc: "true"
Indica si se debe buscar bazelrc en todo el sistema.
Etiquetas: changes_inputs
Valor predeterminado de --[no]unlimit_coredumps: "falso"
Aumenta el límite de soft coredump al límite estricto para hacer posibles volcados de núcleos del servidor (incluida la JVM) y del cliente en condiciones comunes. Pega esta marca en bazelrc una vez y olvídate de ella para obtener volcados de memoria cuando encuentres una condición que los active.
Etiquetas: bazel_internal_configuration
Valor predeterminado de --[no]watchfs: "falso"
Si es verdadero, Bazel intenta usar el servicio de análisis de archivos del sistema operativo para detectar cambios locales, en lugar de analizar cada archivo en busca de cambios.
Etiquetas: deprecated
Si esta preferencia se establece como "true", 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 1703 o versiones posteriores.
Etiquetas: bazel_internal_configuration
Valor predeterminado de --[no]workspace_rc: "true"
Indica si se debe buscar o no el archivo bazelrc de Workspace en $workspace/.bazelrc.
Etiquetas: changes_inputs
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
Otras opciones, sin categorizar:
Se acumulan --host_jvm_args=<jvm_arg> usos múltiples
Son marcas para pasar a la JVM que ejecuta Blaze.
--host_jvm_debug
Una opción conveniente para agregar algunos marcadores 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 conveniente para agregar algunas marcas de inicio de JVM específicas del generador de perfiles/depurador. Bazel tiene una lista de valores conocidos que la asigna a marcas de inicio de JVM codificadas, posiblemente en busca de rutas de acceso codificadas para ciertos archivos.
Valor predeterminado de --server_javabase=<jvm path>: ""
Es la ruta de acceso a la JVM que se usa para ejecutar Bazel.

Opciones comunes para todos los comandos

Opciones que controlan la ejecución de compilación:
--experimental_ui_max_stdouterr_bytes=<an integer in (-1)-1073741819 range> predeterminado: “1048576”
El tamaño máximo de los archivos stdout / stderr que se imprimirán en la consola. -1 implica que no hay límite.
Etiquetas: execution
Si se configura como verdadero y --incompatible_remote_symlinks también es verdadero, los symlinks en las salidas de acción pueden colgar.
Etiquetas: execution y incompatible_change
Si la estableces como verdadera, Bazel representará symlinks en salidas en acción en el protocolo de ejecución/almacenamiento en caché remoto como tal. De lo contrario, se seguirán los symlinks y se representarán como archivos o directorios. Consulta #6631 para obtener más detalles.
Etiquetas: execution y incompatible_change
Opciones que configuran la cadena de herramientas utilizada para la ejecución de la acción:
Valor predeterminado de --[no]incompatible_enable_proto_toolchain_resolution: "falso"
Si es verdadero, las reglas proto lang definen conjuntos de herramientas desde los repositorios rules_proto, rules_java y rules_cc.
Etiquetas: loading_and_analysis y incompatible_change
Opciones que permiten al usuario configurar el resultado previsto y que afectan su valor, en lugar de su existencia:
Valor predeterminado de --bep_maximum_open_remote_upload_files=<an integer>: "-1"
Cantidad máxima de archivos abiertos permitidos durante la carga del artefacto de BEP.
Etiquetas: affects_outputs
--remote_download_all
Descarga todas las salidas remotas en la máquina local. Esta marca es un alias de --remote_download_outputs=all.
Se expande a:
--remote_download_outputs=all

Etiquetas: affects_outputs
--remote_download_minimal
No descarga ningún resultado de compilación remota en la máquina local. Esta marca es un alias de --remote_download_outputs=minimal.
Se expande a:
--remote_download_outputs=minimal

Etiquetas: affects_outputs
--remote_download_outputs=<all, minimal or toplevel> predeterminado: “nivel superior”
Si está establecido en “mínimo” No se descargan resultados de compilación remota en la máquina local, excepto los que requieren las acciones locales. Si se establece como "toplevel" se comporta como “mínimo” excepto que también descarga resultados de objetivos de nivel superior en la máquina local. Ambas opciones pueden reducir de manera significativa los tiempos de compilación si el ancho de banda de la red es un cuello de botella.
Etiquetas: affects_outputs
En lugar de descargar resultados de compilación remotos en la máquina local, crea vínculos simbólicos. El objetivo de los vínculos simbólicos se puede especificar en el formato 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. Estos vínculos simbólicos pueden, por ejemplo, apuntar a un sistema de archivos FUSE que carga objetos desde CAS a pedido.
Etiquetas: affects_outputs
--remote_download_toplevel
Solo descarga las salidas remotas de los objetivos de nivel superior en la máquina local. Esta marca es un alias de --remote_download_outputs=toplevel.
Se expande a:
--remote_download_outputs=toplevel

Etiquetas: affects_outputs
Se acumulan --repo_env=<a 'name=value' assignment with an optional value part> usos múltiples
Especifica las variables de entorno adicionales que estén disponibles solo 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 puede pasarse a los repositorios a través de las opciones sin invalidar el gráfico de acciones.
Etiquetas: action_command_lines
.
Opciones que afectan la precisión con la que Bazel aplica entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
Valor predeterminado de --[no]check_bzl_visibility: "true"
Si se inhabilita, los errores de visibilidad de carga .bzl descienden a advertencias.
Etiquetas: build_file_semantics
.
Esta opción afecta la semántica del lenguaje de Starlark o de la API de compilación a la que pueden acceder los archivos BUILD, los archivos .bzl o los archivos WORKSPACE:
Valor predeterminado de --[no]enable_bzlmod: "true"
Si es verdadero, se habilita el sistema de administración de dependencias Bzlmod, que tiene prioridad sobre WORKSPACE. Consulta https://bazel.build/docs/bzlmod para obtener más información.
Etiquetas: loading_and_analysis
Valor predeterminado de --[no]experimental_action_resource_set: "true"
Si se configura como 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 para la memoria y 1 CPU.
Etiquetas: execution, build_file_semantics y experimental
Valor predeterminado de --[no]experimental_bzl_visibility: "true"
Si se habilita, agrega una función `visibility()` a la que los archivos .bzl pueden llamar durante la evaluación de nivel superior para establecer su visibilidad con fines de sentencias load().
Etiquetas: loading_and_analysis y experimental
Valor predeterminado de --[no]experimental_cc_shared_library: "falso"
Si se configura como verdadera, los atributos de la 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 y experimental
Valor predeterminado de --[no]experimental_disable_external_package: "falso"
Si la estableces como verdadera, el paquete externo //generado automáticamente ya no estará disponible. Bazel aún no podrá analizar el archivo “external/BUILD”, pero los globs que lleguen a external/ desde el paquete sin nombre sí funcionarán.
Etiquetas: loading_and_analysis, loses_incremental_state y experimental
Valor predeterminado de --[no]experimental_enable_android_migration_apis: "falso"
Si se configura como verdadera, habilita las APIs necesarias para admitir la migración de Android Starlark.
Etiquetas: build_file_semantics
Valor predeterminado de --[no]experimental_enable_scl_dialect: "falso"
Si se configura como true, se pueden usar archivos .scl en las sentencias load().
Etiquetas: build_file_semantics
Valor predeterminado de --[no]experimental_google_legacy_api: "falso"
Si se configura como verdadero, expone varias partes experimentales de la API de compilación de Starlark relacionadas con el código heredado de Google.
Etiquetas: loading_and_analysis y experimental
Valor predeterminado de --[no]experimental_isolated_extension_usages: "falso"
Si es verdadero, se habilita el parámetro <code>aislar</code>. en <a href="https://bazel.build/rules/lib/globals/module#use_extension"><code>use_extension</code></a> .
Etiquetas: loading_and_analysis
Valor predeterminado de --[no]experimental_java_library_export: "falso"
Si se habilita, se encuentra disponible el módulo experimental_java_library_export_do_not_use.
Etiquetas: loading_and_analysis y incompatible_change
Valor predeterminado de --[no]experimental_platforms_api: "falso"
Si se configura como verdadera, habilita varias APIs de Starlark relacionadas con la plataforma que son útiles para la depuración.
Etiquetas: loading_and_analysis y experimental
Valor predeterminado de --[no]experimental_repo_remote_exec: "falso"
Si se configura como true, repository_rule obtiene algunas capacidades de ejecución remota.
Etiquetas: build_file_semantics, loading_and_analysis y experimental
Valor predeterminado de --[no]experimental_sibling_repository_layout: "falso"
Si se configura como verdadero, los repositorios que no son principales se colocan como symlinks 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 valor "external" de nivel superior real .
Etiquetas: action_command_lines, bazel_internal_configuration, loading_and_analysis, loses_incremental_state y experimental
Valor predeterminado de --[no]incompatible_allow_tags_propagation: "true"
Si la estableces como verdadera, las etiquetas se propagarán de un destino a las acciones los requisitos de ejecución; De lo contrario, las etiquetas no se propagan. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/8830.
Etiquetas: build_file_semantics y experimental
Valor predeterminado de --[no]incompatible_always_check_depset_elements: "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=...) se olvidó de verificar. Usa tuplas en lugar de listas en elementos depset. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/10313.
Etiquetas: build_file_semantics y incompatible_change
Valor predeterminado de --[no]incompatible_depset_for_java_output_source_jars: "true"
Cuando es verdadero, Bazel ya no muestra una lista de java_info.java_output[0].source_jars, sino que muestra un depset.
Etiquetas: loading_and_analysis y incompatible_change
Cuando el valor es verdadero, Bazel ya no muestra una lista de links_context.libraries_to_link, pero mostrará un depset.
Etiquetas: loading_and_analysis y incompatible_change
Valor predeterminado de --[no]incompatible_disable_objc_library_transition: "true"
Inhabilita la transición personalizada de objc_library y hereda del objetivo de nivel superior
Etiquetas: build_file_semantics y incompatible_change
Valor predeterminado de --[no]incompatible_disable_starlark_host_transitions: "falso"
Si se establece como verdadero, los atributos de la regla no pueden establecer 'cfg = "host"'. Las reglas deben establecer 'cfg = "exec"'. en su lugar.
Etiquetas: loading_and_analysis y incompatible_change
Valor predeterminado de --[no]incompatible_disable_target_provider_fields: "falso"
Si la estableces como verdadera, inhabilitar la capacidad de acceder a los proveedores en el “objetivo” objetos a través de la sintaxis de campos. En su lugar, usa la sintaxis de clave de proveedor. Por ejemplo, en lugar de usar `ctx.attr.dep.my_info` para acceder a `my_info` desde una función de implementación de reglas, usa `ctx.attr.dep[MyInfo]`. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/9014.
Etiquetas: build_file_semantics y incompatible_change
Valor predeterminado de --[no]incompatible_disallow_empty_glob: "falso"
Si la estableces como verdadera, el valor predeterminado del argumento `allow_empty` de glob() es False.
Etiquetas: build_file_semantics y incompatible_change
Valor predeterminado de --[no]incompatible_disallow_struct_provider_syntax: "falso"
Si se configura como verdadera, es posible que las funciones de implementación de reglas no muestren un struct. En su lugar, deben mostrar una lista de instancias del proveedor.
Etiquetas: build_file_semantics y incompatible_change
Valor predeterminado de --[no]incompatible_existing_rules_immutable_view: "true"
Si se configura como verdadero, native.existing_rule y native.existing_rules, que se muestren objetos de vista inmutables y ligeros en lugar de diccionarios mutables.
Etiquetas: build_file_semantics, loading_and_analysis y incompatible_change
Valor predeterminado de --[no]incompatible_fail_on_unknown_attributes: "true"
Si se habilita, los destinos con atributos desconocidos establecidos en Ninguno fallan.
Etiquetas: loading_and_analysis y incompatible_change
Valor predeterminado de --[no]incompatible_fix_package_group_reporoot_syntax: "true"
En el atributo "packages" de package_group, cambia el significado del valor "//..." para referirnos a todos los paquetes del repositorio actual en lugar de a todos los 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 y incompatible_change
Valor predeterminado de --[no]incompatible_java_common_parameters: "true"
Si la estableces como verdadera, se quitarán los parámetros output_jar y host_javabase en pack_sources y host_javabase en compile.
Etiquetas: build_file_semantics y incompatible_change
Valor predeterminado de --[no]incompatible_merge_fixed_and_default_shell_env: "true"
Si se habilita, las acciones registradas con ctx.actions.run y ctx.actions.run_shell con ambos “env” y 'use_default_shell_env = True' especificado usará un entorno obtenido del entorno de shell predeterminado mediante la anulación con los valores que se pasan a “env”. Si está inhabilitada, el valor de “env” se ignora por completo en este caso.
Etiquetas: loading_and_analysis y incompatible_change
Valor predeterminado de --[no]incompatible_new_actions_api: "true"
Si se configura como verdadera, la API para crear acciones solo estará disponible en `ctx.actions`, no en `ctx`.
Etiquetas: build_file_semantics y incompatible_change
Valor predeterminado de --[no]incompatible_no_attr_license: "true"
Si se configura como "true", inhabilita la función "attr.license".
Etiquetas: build_file_semantics y incompatible_change
Valor predeterminado de --[no]incompatible_no_implicit_file_export: "falso"
Si se configura, (usado) los archivos de origen son privados del paquete, a menos que se exporten explícitamente. Consultar https://github.com/bazelbuild/proposals/blob/master/designs/2019-10-24-file-visibility.md
Etiquetas: build_file_semantics y incompatible_change
Valor predeterminado de --[no]incompatible_no_rule_outputs_param: "falso"
Si se configura como verdadero, inhabilita el parámetro `outputs` de la función `rule()` de Starlark.
Etiquetas: build_file_semantics y incompatible_change
Valor predeterminado de --[no]incompatible_objc_provider_remove_linking_info: "falso"
Si se configura como verdadera, se quitarán las APIs de ObjcProvider para la información de vinculación.
Etiquetas: build_file_semantics y incompatible_change
Valor predeterminado de --[no]incompatible_package_group_has_public_syntax: "true"
En el atributo "packages" de package_group, permite escribir "public" o "privado" para referirnos a todos los paquetes o a ninguno, respectivamente.
Etiquetas: build_file_semantics y incompatible_change
Valor predeterminado de --[no]incompatible_require_linker_input_cc_api: "true"
Si la estableces como verdadera, la regla create_linking_context requerirá linker_inputs en lugar de libraries_to_link. Los métodos get anteriores de links_context también se inhabilitarán y solo linker_inputs estará disponible.
Etiquetas: build_file_semantics, loading_and_analysis y incompatible_change
Valor predeterminado de --[no]incompatible_run_shell_command_string: "true"
Si se configura como true, el parámetro de comando de actions.run_shell solo aceptará cadena
Etiquetas: build_file_semantics y incompatible_change
Valor predeterminado de --[no]incompatible_stop_exporting_language_modules: "falso"
Si se habilita esta opción, ciertos módulos específicos del lenguaje (como `cc_common`) no estarán disponibles en los archivos .bzl del usuario y solo se los podrá llamar desde sus respectivos repositorios de reglas.
Etiquetas: loading_and_analysis y incompatible_change
Valor predeterminado de --[no]incompatible_struct_has_no_methods: "falso"
Inhabilita los métodos to_json y to_proto de la struct, que contaminan el espacio de nombres del campo del struct. En su lugar, usa json.encode o json.encode_indent para JSON, o proto.encode_text para textproto.
Etiquetas: build_file_semantics y incompatible_change
Valor predeterminado de --[no]incompatible_top_level_aspects_require_providers: "falso"
Si se establece como verdadera, el aspecto de nivel superior respetará los proveedores requeridos y solo se ejecutará en los objetivos de nivel superior cuyas reglas los proveedores anunciados cumplen con los requisitos del aspecto.
Etiquetas: loading_and_analysis y incompatible_change
Valor predeterminado de --[no]incompatible_unambiguous_label_stringification: "true"
Si el valor es verdadero, Bazel aplicará strings de la etiqueta @//foo:bar a @//foo:bar, en lugar de //foo:bar. Esto solo afecta el comportamiento de str(), el operador %, etc. el comportamiento de repr() no cambia. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/15916.
Etiquetas: loading_and_analysis y incompatible_change
Valor predeterminado de --[no]incompatible_use_cc_configure_from_rules_cc: "falso"
Si es verdadero, Bazel ya no permitirá el uso de cc_configure de @bazel_tools. Consulta https://github.com/bazelbuild/bazel/issues/10134 para obtener detalles y las instrucciones de migración.
Etiquetas: loading_and_analysis y incompatible_change
Valor predeterminado de --[no]incompatible_visibility_private_attributes_at_definition: "true"
Si se configura como verdadera, se verifica la visibilidad de los atributos de la regla privada con respecto a la definición de la regla y se recurre al uso de la regla si no está visible.
Etiquetas: build_file_semantics y incompatible_change
Valor predeterminado de --max_computation_steps=<a long integer>: "0"
La cantidad máxima de pasos de procesamiento de Starlark que puede ejecutar un archivo BUILD (cero significa que no hay límite).
Etiquetas: build_file_semantics
Valor predeterminado de --nested_set_depth_limit=<an integer>: "3500"
La profundidad máxima del grafo interna de un depset (también conocido como NestedSet), por encima de la cual el constructor depset() fallará.
Etiquetas: loading_and_analysis
.
Opciones que activan optimizaciones del tiempo de compilación:
Valor predeterminado de --[no]heuristically_drop_nodes: "falso"
Si esta preferencia se establece como "true", Blaze quitará los nodos FileState y DirectoryListingState una vez que el nodo File y DirectoryListing relacionado esté listo para ahorrar memoria. Esperamos que sea menos probable que se vuelvan a necesitar estos nodos. De ser así, el programa los volverá a evaluar.
Etiquetas: loses_incremental_state
Valor predeterminado de --[no]incompatible_do_not_split_linking_cmdline: "true"
Cuando es verdadero, Bazel ya no modifica las marcas de línea de comandos que se usan para la vinculación y tampoco decide de manera selectiva qué marcas van al archivo de parámetros y cuáles no. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/7670.
Etiquetas: loading_and_analysis y incompatible_change
Valor predeterminado de --[no]keep_state_after_build: "true"
Si se establece como "false", Blaze descartará el estado en la memoria de esta compilación cuando esta finalice. Las compilaciones posteriores no tendrán ninguna incrementalidad con respecto a esta.
Etiquetas: loses_incremental_state
Valor predeterminado de --[no]track_incremental_state: "true"
Si se establece como "false", Blaze no conservará datos que permitan invalidar y volver a evaluar 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, deberás especificar --batch cuando lo configures como falso.
Etiquetas: loses_incremental_state
.
Opciones que afectan la verbosidad, el formato o la ubicación del registro:
Valor predeterminado de --[no]announce_rc: "falso"
Indica si se deben anunciar las opciones de rc.
Etiquetas: affects_outputs
Valor predeterminado de --[no]attempt_to_print_relative_paths: "falso"
Cuando imprimas la ubicación de los mensajes, 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) con el formato [SCHEME://]HOST[:PORT]. La configuración predeterminada es inhabilitar las cargas a BES. Los esquemas compatibles son grpc y grpcs (grpc con TLS habilitado). Si no se proporciona ningún esquema, Bazel supone los grpcs.
Etiquetas: affects_outputs
Valor predeterminado de --[no]bes_check_preceding_lifecycle_events: "falso"
Configura el campo check_preceding_lifecycle_events_present en PublishBuildToolEventStreamRequest, que le indica a BES que verifique si recibió anteriormente los eventos InvocationAttemptStarted y BuildEnqueued que coincidan con el evento actual de la herramienta.
Etiquetas: affects_outputs
Se acumulan --bes_header=<a 'name=value' assignment> usos múltiples
Especifica un encabezado con el formato NAME=VALUE que se incluirá en las solicitudes de BES. Se pueden pasar varios encabezados especificando la marca varias veces. Si hay varios valores para el mismo nombre, se convertirán en una lista separada por comas.
Etiquetas: affects_outputs
Valor predeterminado de --bes_instance_name=<a string>: ver descripción
Especifica el nombre de la instancia bajo el cual la BES conservará los BEP subidos. La configuración predeterminada es null.
Etiquetas: affects_outputs
Se acumulan --bes_keywords=<comma-separated list of options> usos múltiples
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"). La configuración predeterminada es "none".
Etiquetas: affects_outputs
Valor predeterminado de --[no]bes_lifecycle_events: "true"
Especifica si se deben publicar los 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.> valor predeterminado: "10m"
Especifica cuánto tiempo debe esperar Bazel para que se complete la carga de BES/BEP mientras se realiza la operación OOM. Esta marca garantiza la finalización cuando la JVM realiza una hiperpaginación grave de GC y no puede progresar en ningún subproceso de usuario.
Etiquetas: bazel_monitoring
Valor predeterminado de --bes_outerr_buffer_size=<an integer>: "10240"
Especifica el tamaño máximo de stdout o stderr que se almacenará en el búfer en BEP antes de que se informe como un evento de progreso. Las escrituras individuales se informan en un solo evento, incluso si son mayores 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
Valor predeterminado de --bes_proxy=<a string>: ver 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:/path/to/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 de BES. Bazel enviará a la terminal la URL anexada por el ID de invocación.
Etiquetas: terminal_output
Se acumulan --bes_system_keywords=<comma-separated list of options> usos múltiples
Especifica una lista de palabras clave de notificación que se incluirán directamente, sin el parámetro "user_keyword=" prefijo incluido para las palabras clave proporcionadas con --bes_keyword. Está destinado a los operadores de servicios de compilación que configuran --bes_lifecycle_events=false y, además, incluyen palabras clave cuando llaman a PublishLifecycleEvent. Los operadores de servicios de compilación que usan esta marca deberían evitar que los usuarios anulen el valor de la marca.
Etiquetas: affects_outputs
Valor predeterminado de --bes_timeout=<An immutable length of time.>: "0s"
Especifica cuánto tiempo debe esperar Bazel a que se complete la carga de BES/BEP una vez 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 --bes_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>: "wait_for_upload_complete"
Especifica si la carga del servicio de eventos de compilación debe bloquear la finalización de la compilación o finalizar la invocación de inmediato y finalizar la carga en segundo plano. "wait_for_upload_complete" (predeterminado), 'nowait_for_upload_complete' o 'completamente_async'.
Etiquetas: eagerness_to_exit
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
Valor predeterminado de --[no]build_event_binary_file_path_conversion: "true"
Siempre que sea posible, convierte las rutas de acceso en la representación de archivo binario del protocolo de eventos de compilación en URI más válidos a nivel global. Si se inhabilita, siempre se usará el esquema de URI file://
Etiquetas: affects_outputs
Valor predeterminado de --build_event_binary_file_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>: "wait_for_upload_complete"
Especifica si la carga del servicio de eventos de compilación para --build_event_binary_file debe bloquear la finalización de la compilación o finalizar la invocación de inmediato y finalizar la carga en segundo plano. "wait_for_upload_complete" (predeterminado), 'nowait_for_upload_complete' o 'completamente_async'.
Etiquetas: eagerness_to_exit
Valor predeterminado de --build_event_json_file=<a string>: ""
Si no está vacío, escribe una serialización JSON del protocolo de evento de compilación en ese archivo. Esta opción implica --bes_upload_mode=wait_for_upload_complete.
Etiquetas: affects_outputs
Valor predeterminado de --[no]build_event_json_file_path_conversion: "true"
Siempre que sea posible, convierte las rutas de acceso de la representación de archivo JSON del protocolo de eventos de compilación en URI más válidos a nivel global. Si se inhabilita, siempre se usará el esquema de URI file://
Etiquetas: affects_outputs
Valor predeterminado de --build_event_json_file_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>: "wait_for_upload_complete"
Especifica si la carga del servicio de evento de compilación para --build_event_json_file debe bloquear la finalización de la compilación o debe finalizar la invocación de inmediato y finalizar la carga en segundo plano. "wait_for_upload_complete" (predeterminado), 'nowait_for_upload_complete' o 'completamente_async'.
Etiquetas: eagerness_to_exit
Valor predeterminado de --build_event_max_named_set_of_file_entries=<an integer>: "-1"
Cantidad máxima de entradas para un solo evento con nombre_conjunto_de_archivos; los valores inferiores a 2 se ignoran y no se realiza ninguna división de eventos. Esto está diseñado para limitar el tamaño máximo del evento en el protocolo de evento 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 del URI, que, a su vez, pueden depender de la función hash.
Etiquetas: affects_outputs
Valor predeterminado de --[no]build_event_publish_all_actions: "falso"
Si todas las acciones deben publicarse.
Etiquetas: affects_outputs
Valor predeterminado de --build_event_text_file=<a string>: ""
Si no está vacío, escribe una representación textual del protocolo del evento de compilación en ese archivo.
Etiquetas: affects_outputs
Valor predeterminado de --[no]build_event_text_file_path_conversion: "true"
Siempre que sea posible, convierte las rutas de acceso en la representación del archivo de texto del protocolo de eventos de compilación en URI más válidos a nivel global. Si se inhabilita, siempre se usará el esquema de URI file://
Etiquetas: affects_outputs
Valor predeterminado de --build_event_text_file_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>: "wait_for_upload_complete"
Especifica si la carga del servicio de eventos de compilación para --build_event_text_file debe bloquear la finalización de la compilación o finalizar la invocación de inmediato y finalizar la carga en segundo plano. "wait_for_upload_complete" (predeterminado), 'nowait_for_upload_complete' o 'completamente_async'.
Etiquetas: eagerness_to_exit
Valor predeterminado de --[no]experimental_announce_profile_path: "falso"
Si se habilita, agrega la ruta del perfil JSON al registro.
Etiquetas: bazel_monitoring
Valor predeterminado de --[no]experimental_bep_target_summary: "falso"
Especifica si se publicarán los eventos de TargetSummary.
Valor predeterminado de --[no]experimental_build_event_expand_filesets: "falso"
Si es verdadero, expande los conjuntos de archivos en BEP cuando presentes archivos de salida.
Etiquetas: affects_outputs
Si es verdadero, resuelve por completo los symlinks relativos del conjunto de archivos en el BEP cuando presentes 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"
La cantidad máxima de veces que Bazel debería reintentar subir un evento de compilación.
Etiquetas: bazel_internal_configuration
Valor predeterminado de --experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>: "1s"
Es el retraso mínimo inicial para los reintentos de retirada exponencial cuando falla la carga de BEP. (exponente: 1.6)
Etiquetas: bazel_internal_configuration
Valor predeterminado de --experimental_build_event_upload_strategy=<a string>: ver 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
Valor predeterminado de --[no]experimental_collect_load_average_in_profiler: "true"
Si se habilita, el generador de perfiles recopila el promedio de carga general del sistema.
Etiquetas: bazel_monitoring
Valor predeterminado de --[no]experimental_collect_pressure_stall_indicators: "falso"
Si se habilita, el generador de perfiles recopila los datos de PSI de Linux.
Etiquetas: bazel_monitoring
Valor predeterminado de --[no]experimental_collect_resource_estimation: "falso"
Si se habilita, el generador de perfiles recopila los cálculos de uso de CPU y memoria de las acciones locales.
Etiquetas: bazel_monitoring
Valor predeterminado de --[no]experimental_collect_system_network_usage: "falso"
Si se habilita, el generador de perfiles recopila el uso de red del sistema.
Etiquetas: bazel_monitoring
Valor predeterminado de --[no]experimental_collect_worker_data_in_profiler: "falso"
Si se habilita, el generador de perfiles recopila los datos de recursos agregados del trabajador.
Etiquetas: bazel_monitoring
Se acumulan --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, remote_process_time, remote_queue, remote_setup, fetch, local_process_time, 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, action_cache_counts, local_cpu_usage, system_cpu_usage, cpu_usage_estimation, local_memory_usage, system_memory_usage, memory_usage_estimation, 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, pressure_stall_io, pressure_stall_memory, conflict_check, dynamic_lock or unknown> usos múltiples
Especifica las tareas de perfil adicionales que se incluirán en el perfil.
Etiquetas: bazel_monitoring
Valor predeterminado de --[no]experimental_profile_include_primary_output: "falso"
Incluye el "out" adicional en eventos de acción que contiene la ruta de acceso de ejecución a la salida principal de la acción.
Etiquetas: bazel_monitoring
Valor predeterminado de --[no]experimental_profile_include_target_label: "falso"
Incluye la etiqueta objetivo en los eventos de acción Datos de perfil JSON.
Etiquetas: bazel_monitoring
Valor predeterminado de --[no]experimental_run_bep_event_include_residue: "falso"
Indica si se debe incluir el residue de línea de comandos en eventos de compilación en ejecución que podrían contener el residue. De forma predeterminada, el residue no se incluye en los eventos de compilación de comandos de ejecución que podrían contener el residue.
Etiquetas: affects_outputs
Valor predeterminado de --[no]experimental_stream_log_file_uploads: "falso"
Transmite las cargas de archivos de registro directamente al almacenamiento remoto en lugar de escribirlas en el disco.
Etiquetas: affects_outputs
Valor predeterminado de --experimental_workspace_rules_log_file=<a path>: ver descripción
Registra ciertos eventos de reglas de Workspace en este archivo como archivos proto delimitados de WorkspaceEvent.
--[no]generate_json_trace_profile predeterminado: "automático"
Si se habilita, Bazel genera perfiles de la compilación y escribe un perfil en formato JSON en un archivo en la base de salida. Ver el perfil cargando en chrome://tracing. De forma predeterminada, Bazel escribe el perfil para todos los comandos y consultas similares a los de compilación.
Etiquetas: bazel_monitoring
Valor predeterminado de --[no]heap_dump_on_oom: "falso"
Establece si se debe generar de forma manual un volcado de montón si se arroja un OOM (incluidas las OOM manuales debido a que se alcanza --gc_thrashing_limits). El volcado se escribirá en <output_base>/<invocation_id>.heapdump.hprof. Esta opción reemplaza efectivamente -XX:+HeapDumpOnOutOfMemoryError, que no tiene efecto en las OOM manuales.
Etiquetas: bazel_monitoring
Valor predeterminado de --[no]legacy_important_outputs: "true"
Úsalo para suprimir la generación del campo relevant_outputs heredado en el evento TargetComplete. importantes_outputs son obligatorios para la integración de Bazel a ResultStore.
Etiquetas: affects_outputs
Valor predeterminado de --logging=<0 <= an integer <= 6>: "3"
El nivel de registro.
Etiquetas: affects_outputs
Valor predeterminado de --memory_profile=<a path>: ver descripción
Si está establecido, escribe los datos de uso de memoria en el archivo especificado al finalizar la fase y en el montón estable en el registro principal al final de la compilación.
Etiquetas: bazel_monitoring
Valor predeterminado de --memory_profile_stable_heap_parameters=<integers, separated by a comma expected in pairs>: "1,0"
Ajusta el cálculo del perfil de memoria de montón estable al final de la compilación. Debe haber un número par de números enteros separados por comas. En cada par, el primer número entero es la cantidad de GC que se realizarán. El segundo número entero de cada par es la cantidad de segundos que se debe esperar entre las GC. P. ej.: 2,4,4,0 implicarían 2 recolecciones con una pausa de 4 segundos, seguidas de 4 recolecciones con pausa de cero segundos
Etiquetas: bazel_monitoring
Valor predeterminado de --profile=<a path>: ver descripción
Si está configurado, genera perfiles de Bazel y escribe datos en el archivo especificado. Usa analyze-profile de Bazel para analizar el perfil.
Etiquetas: bazel_monitoring
Valor predeterminado de --[no]record_full_profiler_data: "falso"
De forma predeterminada, el generador de perfiles de Bazel solo registrará datos agregados para eventos rápidos pero numerosos (como la estadística de un archivo). Si se habilita esta opción, el generador de perfiles registrará cada evento, lo que dará como resultado datos de generación de perfiles más precisos, pero un hit de rendimiento GRANDE. La opción solo tiene efecto si también se utiliza --profile.
Etiquetas: bazel_monitoring
Valor predeterminado de --remote_print_execution_messages=<failure, success or all>: "error"
Elige cuándo imprimir los mensajes de ejecución remota. Los valores válidos son `failure` (error), para imprimir solo en caso de errores, "success" para imprimir solo en caso de éxito y "all" para imprimir siempre.
Etiquetas: terminal_output
Valor predeterminado de --[no]slim_profile: "true"
Reduce el tamaño del perfil JSON combinando eventos si el perfil es demasiado grande.
Etiquetas: bazel_monitoring
Valor predeterminado de --starlark_cpu_profile=<a string>: ""
Escribe en el archivo especificado un perfil pprof del uso de CPU por parte de todos los subprocesos de Starlark.
Etiquetas: bazel_monitoring
Valor predeterminado de --tool_tag=<a string>: ""
Es un nombre de herramienta al que se le atribuirá esta invocación de Bazel.
Etiquetas: affects_outputs y bazel_monitoring
Se acumulan --ui_event_filters=<Convert list of comma separated event kind to list of filters> usos múltiples
Especifica qué eventos se mostrarán en la IU. Es posible agregar o quitar eventos a los predeterminados con el signo +/- inicial o 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 de ejecución y almacenamiento en caché remoto:
Valor predeterminado de --experimental_circuit_breaker_strategy=<failure>: ver descripción
Especifica la estrategia que usará el disyuntor. Las estrategias disponibles son “fallas”. Si el valor de la opción no es válido, no se establece el mismo comportamiento que la opción.
Etiquetas: execution
Valor predeterminado de --[no]experimental_guard_against_concurrent_changes: "falso"
Desactiva esta opción para inhabilitar la verificación del tiempo de los archivos de entrada de una acción antes de subirla a una caché remota. Puede haber casos en los que el kernel de Linux retrase la escritura de archivos, lo que podría provocar falsos positivos.
Valor predeterminado de --[no]experimental_remote_cache_async: "falso"
Si es verdadero, la E/S de la caché remota ocurrirá en segundo plano, en lugar de ocurrir como parte de un generador.
Valor predeterminado de --[no]experimental_remote_cache_lease_extension: "falso"
Si se configura como verdadero, Bazel extenderá la asignación de tiempo para los resultados de las acciones remotas durante la compilación enviando llamadas a `FindMissingBlobs` de forma periódica a la caché remota. La frecuencia se basa en el valor de `--experimental_remote_cache_ttl`.
--experimental_remote_cache_ttl=<An immutable length of time.> valor predeterminado: "3h"
El TTL mínimo garantizado de los BLOB en la caché remota después de que se hace referencia recientemente a sus resúmenes, p.ej., por un ActionResult o FindMissingBlobs. Bazel realiza varias optimizaciones basadas en la información de los BLOB. TTL, p.ej., no llama repetidamente a GetActionResult en una compilación incremental. El valor debe establecerse un poco menor que el TTL real, ya que hay un espacio entre el momento en que el servidor muestra los resúmenes y el momento en que Bazel los recibe.
Etiquetas: execution
Valor predeterminado de --experimental_remote_capture_corrupted_outputs=<a path>: ver descripción
Una ruta de acceso a un directorio en el que se capturarán los resultados dañados.
Valor predeterminado de --[no]experimental_remote_discard_merkle_trees: "falso"
Si se configura como verdadera, descarta las copias en la memoria del árbol Merkle de la raíz de entrada y las asignaciones de entradas asociadas durante las llamadas a GetActionResult() y Execute(). Esto reduce significativamente el uso de memoria, pero requiere que Bazel vuelva a procesarlos ante errores y reintentos de caché remota.
Valor predeterminado de --experimental_remote_downloader=<a string>: ver descripción
Un URI de extremo de la API de Remote Asset, que se usará como proxy de descarga remota. Los esquemas compatibles son gRPC, grpcs (grpc con TLS habilitado) y Unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel usará grpcs de forma predeterminada. Visita https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto.
Valor predeterminado de --[no]experimental_remote_downloader_local_fallback: "falso"
Indica si se debe recurrir a la descarga local en caso de que falle la descarga remota.
Valor predeterminado de --[no]experimental_remote_execution_keepalive: "falso"
Indica si se debe usar keepalive para llamadas de ejecución remota.
Valor predeterminado de --experimental_remote_failure_rate_threshold=<an integer in 0-100 range>: "10"
Establece la cantidad permitida de tasa de fallas en porcentaje para un período específico, después del cual se deja de llamar a la caché o al ejecutor remoto. De forma predeterminada, el valor es 10. Si se establece en 0, no hay limitación.
Etiquetas: execution
--experimental_remote_failure_window_interval=<An immutable length of time.> valor predeterminado: "60 s"
El intervalo en el que se calcula la tasa de fallas de las solicitudes remotas. Con un valor de cero o negativo, la duración de la falla se calcula por toda la duración de 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
Valor predeterminado de --[no]experimental_remote_mark_tool_inputs: "falso"
Si la estableces como verdadera, Bazel marcará las entradas como entradas de herramientas para el ejecutor remoto. Puede usarse para implementar trabajadores persistentes remotos.
Valor predeterminado de --[no]experimental_remote_merkle_tree_cache: "falso"
Si se establece como verdadera, los cálculos del árbol de Merkle se memorizarán para mejorar la velocidad de comprobación de aciertos de caché remota. La huella de memoria de la caché se controla mediante --experimental_remote_merkle_tree_cache_size.
Valor predeterminado de --experimental_remote_merkle_tree_cache_size=<a long integer>: "1000"
La cantidad de árboles de Merkle que se deben memorizar para mejorar la velocidad de comprobación de aciertos de caché remota. Aunque la caché se reduce automáticamente según el manejo de referencias suaves de Java, se pueden producir errores por falta de memoria si se configura en 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. La configuración predeterminada es 1,000.
Valor predeterminado de --[no]experimental_remote_require_cached: "falso"
Si se configura como verdadera, establece que todas las acciones que pueden ejecutarse de forma remota se almacenen en caché o que falle la compilación. Esto es útil para solucionar problemas de no determinismo, ya que permite comprobar si las acciones que deben almacenarse en caché realmente se almacenan en caché sin insertar falsamente resultados nuevos en la caché.
Valor predeterminado de --experimental_remote_scrubbing_config=<Converts to a Scrubber>: ver descripción
Habilita el borrado de claves de caché remota con el archivo de configuración suministrado, que debe ser un búfer de protocolo ScrubbingConfig en formato de texto. Esta función está diseñada para facilitar el uso compartido de una caché remota o de disco entre acciones que se ejecutan en diferentes plataformas, pero que se orientan a la misma. Se debe utilizar con mucho cuidado, ya que una configuración incorrecta puede provocar que las entradas de la caché se compartan accidentalmente y dar como resultado compilaciones incorrectas. La limpieza no afecta la forma en que se ejecuta una acción, solo la manera en que se calcula su clave de caché remota o de disco con el fin de recuperar o almacenar un resultado de acción. No se puede usar junto con la ejecución remota. Modificar la configuración de depuración no invalida los resultados presentes en el sistema de archivos local o en las memorias caché internas. se requiere una compilación limpia para volver a ejecutar las acciones afectadas. Para usar correctamente esta función, es recomendable que configures --host_platform junto con --experimental_platform_in_output_dir (para normalizar los prefijos de salida) y --incompatible_strict_action_env (para normalizar las variables de entorno).
Valor predeterminado de --[no]incompatible_remote_build_event_upload_respect_no_cache: "falso"
Obsoleto. No-ops. En su lugar, usa --remote_build_event_upload=minimal.
Valor predeterminado de --[no]incompatible_remote_downloader_send_all_headers: "true"
Establece si se deben enviar todos los valores de un encabezado con valores múltiples al cargador remoto en lugar de solo al primero.
Etiquetas: incompatible_change
Valor predeterminado de --[no]incompatible_remote_output_paths_relative_to_input_root: "falso"
Si se configura como verdadera, las rutas de salida son relativas a la raíz de entrada en lugar del directorio de trabajo.
Etiquetas: incompatible_change
Valor predeterminado de --[no]incompatible_remote_results_ignore_disk: "true"
No-ops
Etiquetas: incompatible_change
Valor predeterminado de --[no]remote_accept_cached: "true"
Indica si se deben aceptar los resultados de acciones almacenados en caché de forma remota.
Valor predeterminado de --remote_build_event_upload=<all or minimal>: “mínimo”
Si se configura como “all”, todas las salidas locales a las que hace referencia BEP se suben a la caché remota. Si se configura como “mínimo”, las salidas locales a las que hace referencia BEP no se suben a la caché remota, excepto los archivos que son importantes para los consumidores de BEP (p.ej., los registros de prueba y el perfil de tiempo). El esquema bytestream:// siempre se usa para el URI de los archivos, incluso si faltan en la caché remota. La configuración predeterminada es "minimal".
Valor predeterminado de --remote_bytestream_uri_prefix=<a string>: ver descripción
El nombre de host y el nombre de la instancia que se usarán en los URI bytestream:// que se escriben en transmisiones 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 con el nombre canónico del servicio de ejecución remota. Si no la estableces, se establecerá la configuración predeterminada como "${hostname}/${instance_name}".
Valor predeterminado de --remote_cache=<a string>: ver descripción
Un URI de un extremo de almacenamiento en caché. Los esquemas compatibles son http, https, grpc, grpcs (grpc con TLS habilitado) y Unix (sockets UNIX locales), Si no se proporciona un esquema, Bazel usará grpcs de forma predeterminada. Especifica el esquema grpc://, http:// o unix: para inhabilitar TLS. Consulta https://bazel.build/remote/caching
Valor predeterminado de --[no]remote_cache_compression: "falso"
Si se habilita, comprime o descomprime los BLOB de caché con zstd.
Se acumulan --remote_cache_header=<a 'name=value' assignment> usos múltiples
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. Si hay varios valores para el mismo nombre, se convertirán en una lista separada por comas.
Se acumulan --remote_default_exec_properties=<a 'name=value' assignment> usos múltiples
Establece las propiedades de ejecución predeterminadas que se usarán como plataforma de ejecución remota si una plataforma de ejecución aún no configuró exec_properties.
Etiquetas: affects_outputs
Valor predeterminado de --remote_default_platform_properties=<a string>: ""
Establece las propiedades de plataforma predeterminadas que se establecerán para la API de ejecución remota, si la plataforma de ejecución aún no configuró remote_execution_properties. Este valor también se usará si se selecciona la plataforma host como plataforma de ejecución remota.
Se acumulan --remote_download_regex=<a string> usos múltiples
Forzar a Bazel a descargar los artefactos que coincidan con la regexp determinada Se debe usar junto con Build sin los bytes (o el equivalente interno) para permitir que el cliente solicite ciertos artefactos que podrían ser necesarios a nivel local (p.ej., compatibilidad con IDE). Se pueden especificar múltiples regex con la repetición de esta marca.
Etiquetas: affects_outputs
Se acumulan --remote_downloader_header=<a 'name=value' assignment> usos múltiples
Especifica un encabezado que se incluirá en las solicitudes de descargas remotas: --remote_downloader_header=Name=Value. Se pueden pasar varios encabezados especificando la marca varias veces. Si hay varios valores para el mismo nombre, se convertirán en una lista separada por comas.
Se acumulan --remote_exec_header=<a 'name=value' assignment> usos múltiples
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. Si hay varios valores para el mismo nombre, se convertirán en una lista separada por comas.
Valor predeterminado de --remote_execution_priority=<an integer>: "0"
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.
Valor predeterminado de --remote_executor=<a string>: ver descripción
HOST o HOST:PORT de un extremo de ejecución remota. Los esquemas compatibles son gRPC, grpcs (grpc con TLS habilitado) y Unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel usará grpcs de forma predeterminada. Especifica el esquema grpc:// o unix: para inhabilitar TLS.
Valor predeterminado de --remote_grpc_log=<a path>: ver descripción
Si se especifica, una ruta de acceso a un archivo para registrar detalles relacionados con la llamada de gRPC. Este registro consta de una secuencia de protobufs com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry serializados con cada mensaje con prefijo de un varint que denota el tamaño del siguiente mensaje protobuf serializado, como lo realiza el método LogEntry.writeDelimitedTo(OutputStream).
Se acumulan --remote_header=<a 'name=value' assignment> usos múltiples
Especifica un encabezado que se incluirá en las solicitudes: --remote_header=Name=Value. Se pueden pasar varios encabezados especificando la marca varias veces. Si hay varios valores para el mismo nombre, se convertirán en una lista separada por comas.
Valor predeterminado de --remote_instance_name=<a string>: ""
Valor para pasar como instance_name en la API de ejecución remota.
Valor predeterminado de --[no]remote_local_fallback: "falso"
Determina si se debe recurrir a una estrategia de ejecución local independiente si falla la ejecución remota.
Valor predeterminado de --remote_local_fallback_strategy=<a string>: "local"
No-op, obsoleto. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/7480.
Valor predeterminado de --remote_max_connections=<an integer>: "100"
Limita la cantidad máxima de conexiones simultáneas al ejecutor o la caché remotos. De forma predeterminada, el valor es 100. Si se establece en 0, no hay limitación. Para la caché remota HTTP, una conexión TCP podía manejar una solicitud a la vez, por lo que Bazel podría generar hasta --remote_max_connections solicitudes simultáneas. Para el ejecutor o la caché remoto de gRPC, un canal de gRPC, por lo general, podía manejar 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
Valor predeterminado de --remote_proxy=<a string>: ver 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:/path/to/socket).
Valor predeterminado de --remote_result_cache_priority=<an integer>: "0"
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.
Valor predeterminado de --remote_retries=<an integer>: "5"
La cantidad máxima de intentos para reintentar un error transitorio. Si se establece en 0, se inhabilitan los reintentos.
Valor predeterminado de --remote_retry_max_delay=<An immutable length of time.>: "5 s"
El retraso máximo 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.> valor predeterminado: "60 s"
La cantidad máxima de tiempo que se debe esperar la ejecución remota y las llamadas de caché. Para la caché 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.
Valor predeterminado de --[no]remote_upload_local_results: "true"
Establece si se deben subir resultados de acciones ejecutadas de forma local a la caché remota si esta lo admite y si el usuario tiene autorización para hacerlo.
Valor predeterminado de --[no]remote_verify_downloads: "true"
Si la estableces como verdadera, Bazel calculará la suma de hash de todas las descargas remotas y descartará los valores almacenados en caché remotamente si no coinciden con el valor esperado.
Otras opciones, que no se categorizan de ninguna otra manera:
Se acumulan --build_metadata=<a 'name=value' assignment> usos múltiples
Pares clave-valor personalizados para proporcionar en un evento de compilación.
Etiquetas: terminal_output
--color=<yes, no or auto> predeterminado: "automático"
Usa los controles de la terminal para colorear el resultado.
Se acumulan --config=<a string> usos múltiples
Selecciona secciones de configuración adicionales de los archivos rc. para cada <command>, también extrae las opciones de <command>:<config> si dicha sección existe; si esta sección no existe en ningún archivo .rc, Blaze fallará y mostrará un error. Las secciones de configuración y las combinaciones de marcas a las que son equivalentes se encuentran en los archivos de configuración tools/*.blazerc.
Se acumulan --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.> usos múltiples
Configura un auxiliar de credenciales que se usará en la recuperación de 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 que suministran --google_default_credentials, --google_credentials, un archivo .netrc o el parámetro auth a 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.> valor predeterminado: "30m"
Es el tiempo durante el cual se almacenan en caché las credenciales proporcionadas por un auxiliar de credenciales. La invocación con un valor diferente ajustará la vida útil de las entradas preexistentes. pasa cero para borrar la caché. Un comando clean siempre borra la caché, independientemente de esta marca.
Valor predeterminado de --credential_helper_timeout=<An immutable length of time.>: "10 s"
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 la invocación.
--curses=<yes, no or auto> predeterminado: "automático"
Usa los controles del cursor de la terminal para minimizar el resultado del desplazamiento.
Valor predeterminado de --disk_cache=<a path>: ver descripción
Una 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 --[no]enable_platform_specific_config: "falso"
Si es verdadero, Bazel recopila líneas de configuración específicas del host y el SO de los archivos bazelrc. Por ejemplo, si el SO host es Linux y ejecutas bazel build, Bazel recopila líneas que comienzan con build:linux. Los identificadores de SO compatibles son linux, macos, Windows, freebsd y openbsd. Habilitar esta marca equivale a usar --config=linux en Linux, --config=windows en Windows, etcétera.
Valor predeterminado de --[no]experimental_rule_extension_api: "falso"
Habilitar la API experimental de extensión de reglas y las APIs de subreglas
Etiquetas: loading_and_analysis y experimental
Valor predeterminado de --[no]experimental_windows_watchfs: "falso"
Si es verdadero, se habilitará la compatibilidad experimental de Windows para --watchfs. De lo contrario, --watchfsis una no-op en Windows. Asegúrate de habilitar también --watchfs.
--google_auth_scopes=<comma-separated list of options> predeterminado: "https://www.googleapis.com/auth/cloud-platform"
Una lista separada por comas de los permisos de autenticación de Google Cloud.
Valor predeterminado de --google_credentials=<a string>: ver descripción
Especifica el archivo del que se deben obtener las credenciales de autenticación. Para obtener más información, consulta https://cloud.google.com/docs/authentication.
Valor predeterminado de --[no]google_default_credentials: "falso"
Si se debe usar “Credenciales predeterminadas de la aplicación de Google” para la autenticación. Para obtener más información, consulta https://cloud.google.com/docs/authentication. Inhabilitada de forma predeterminada.
Valor predeterminado de --grpc_keepalive_time=<An immutable length of time.>: ver descripción
Configura pings de keep-alive para conexiones gRPC salientes. Si se configura, Bazel enviará 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 como un segundo nivel de detalle. es un error establecer un valor inferior a un segundo. De forma predeterminada, los pings keep-alive están inhabilitados. Debes coordinar con el propietario del servicio antes de habilitar este parámetro de configuración. Por ejemplo, si quieres establecer un valor de 30 segundos para esta marca, debes hacerlo así: --grpc_keepalive_time=30s
Valor predeterminado de --grpc_keepalive_timeout=<An immutable length of time.>: "20 s"
Configura un tiempo de espera keep-alive para conexiones gRPC salientes. Si los pings 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 como un segundo nivel de detalle. es un error establecer un valor inferior a un segundo. Si los pings keep-alive están inhabilitados, se ignora esta configuración.
Valor predeterminado de --[no]incompatible_disable_non_executable_java_binary: "falso"
Si es verdadero, java_binary siempre es ejecutable. Se quitó el atributo create_executable.
Etiquetas: loading_and_analysis y incompatible_change
No-ops.
Etiquetas: loading_and_analysis y incompatible_change
Valor predeterminado de --[no]progress_in_terminal_title: "falso"
Muestra el progreso del comando en el título de la terminal. Es útil para ver qué hace Bazel cuando tienes varias pestañas de terminal.
Valor predeterminado de --[no]show_progress: "true"
Muestra mensajes de progreso durante una compilación.
--show_progress_rate_limit=<a double> valor predeterminado: "0.2"
Cantidad mínima de segundos entre los mensajes de progreso en el resultado.
Valor predeterminado de --[no]show_timestamps: "falso"
Incluir marcas de tiempo en los mensajes
Valor predeterminado de --tls_certificate=<a string>: ver descripción
Especifica una ruta de acceso a un certificado TLS que sea de confianza para firmar certificados de servidor.
Valor predeterminado de --tls_client_certificate=<a string>: ver descripción
Especifica el certificado de cliente de TLS que se usará; también debes proporcionar una clave de cliente para habilitar la autenticación del cliente.
Valor predeterminado de --tls_client_key=<a string>: ver descripción
Especifica la clave de cliente de TLS que se usará; También debes proporcionar un certificado de cliente para habilitar la autenticación de cliente.
Valor predeterminado de --ui_actions_shown=<an integer>: "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 uno; todos los números inferiores a 1 se asignan a 1.
Etiquetas: terminal_output
Valor predeterminado de --[no]watchfs: "falso"
En Linux/macOS: Si esta preferencia se establece como "true", bazel intenta usar el servicio de análisis de archivos del sistema operativo para detectar cambios locales, en lugar de analizar todos los archivos en busca de cambios. En Windows: esta marca actualmente no es operativa, pero se puede habilitar junto con --experimental_windows_watchfs. En cualquier SO: El comportamiento no está definido si tu espacio de trabajo está en un sistema de archivos de red y los archivos se editan en una máquina remota.

Opciones de análisis del perfil

Opciones que aparecen antes del comando y que el cliente analiza:
Se acumulan --distdir=<a path> usos múltiples
Lugares adicionales para buscar archivos antes de acceder a la red y descargarlos.
Etiquetas: bazel_internal_configuration
Si se configura, la caché del repositorio vinculará el archivo en lugar de copiarlo en caso de que se produzca un acierto de caché. Esto está diseñado para ahorrar espacio en el disco.
Etiquetas: bazel_internal_configuration
Valor predeterminado de --experimental_repository_downloader_retries=<an integer>: "0"
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> valor 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 esperado por el autor de la regla, sin cambiar el código fuente.
Etiquetas: bazel_internal_configuration y experimental
Valor predeterminado de --http_connector_attempts=<an integer>: "8"
La cantidad máxima de intentos para descargas http.
Etiquetas: bazel_internal_configuration
Valor predeterminado de --http_connector_retry_max_timeout=<An immutable length of time.>: "0s"
El tiempo de espera máximo para los reintentos de descarga de HTTP. Con un valor de 0, no se define ningún tiempo de espera máximo.
Etiquetas: bazel_internal_configuration
--http_timeout_scaling=<a double> valor predeterminado: "1.0"
Escalar todos los tiempos de espera relacionados con las descargas HTTP según el factor determinado
Etiquetas: bazel_internal_configuration
Valor predeterminado de --repository_cache=<a path>: ver descripción
Especifica la ubicación de caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché; de lo contrario, el valor predeterminado es '<output_user_root>/cache/repos/v1'. se usa
Etiquetas: bazel_internal_configuration
Valor predeterminado de --[no]repository_disable_download: "falso"
Si se configura, no se permite la descarga con ctx.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no está completamente inhabilitado. ctx.execute aún podría ejecutar un ejecutable arbitrario que acceda a Internet.
Etiquetas: bazel_internal_configuration
.
Opciones que controlan la ejecución de compilación:
Valor predeterminado de --gc_thrashing_threshold=<an integer in 0-100 range>: "100"
El porcentaje del espacio permanente ocupado (0-100) por encima del cual GcThrashingDetector considera eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, GcThrashingDetector está inhabilitado.
Etiquetas: host_machine_resource_optimizations
.
Opciones relacionadas con la salida y la semántica de Bzlmod:
Se acumulan --allow_yanked_versions=<a string> usos múltiples
Se especificaron las versiones de los módulos con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resueltas, incluso si se declaran como eliminadas en el registro del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones rechazadas harán que la resolución falle. También puedes definir la versión generada permitida con la variable de entorno `BZLMOD_ALLOW_YANKED_VERSIONS`. Puedes inhabilitar esta verificación con la palabra clave “todo” (no se recomienda).
Etiquetas: loading_and_analysis
Valor predeterminado de --check_bazel_compatibility=<error, warning or off>: "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 caso 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: "advertencia"
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 derivarla a una falla de resolución.
Etiquetas: loading_and_analysis
Valor predeterminado de --[no]ignore_dev_dependency: "falso"
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en 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
Valor predeterminado de --lockfile_mode=<off, update or error>: "actualizar"
Especifica cómo y si se debe usar o no 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 arroja un error si no está actualizado, o "off" para que no se lea ni escriba en el archivo de bloqueo.
Etiquetas: loading_and_analysis
Se acumulan --override_module=<an equals-separated mapping of module name to path> usos múltiples
Anula un módulo con una ruta de acceso local en el formato <module name>=<path>. Si la ruta de acceso dada es una ruta de acceso absoluta, se usará tal como es. Si la ruta de acceso determinada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso dada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace"
Se acumulan --registry=<a string> usos múltiples
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en registros anteriores y solo se recurrirán a los registros posteriores cuando no estén en los registros anteriores.
Etiquetas: changes_inputs
.
Opciones que activan optimizaciones del tiempo de compilación:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>> predeterminado: "1s:2,20s:3,1m:5"
Límites que, si se alcanzan, hacen que GcThrashingDetector bloquee Bazel con una OOM. Cada límite se especifica como <period>:<count> En el ejemplo anterior, el período es una duración y el recuento es un número entero positivo. Si hay más de --gc_thrashing_threshold por ciento de espacio titular (montón de generación anterior) permanece ocupado después de <count> recolecciones de elementos no utilizados consecutivos en <period>, se activará una OOM. Si hay varios límites, puedes separarlos por comas.
Etiquetas: host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0> predeterminado: “2147483647”
Marca de configuración avanzada del motor interno Skyframe de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de recolección de elementos no utilizados completa, eliminará el estado temporal de Skyframe innecesario, hasta esta cantidad de veces por invocación. La configuración predeterminada es Integer.MAX_VALUE; eficazmente ilimitados. Cero significa que los eventos de recolección de elementos no utilizados completas nunca activarán la acción de soltar. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC completo y se supere ese umbral de porcentaje de montón retenido.
Etiquetas: host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0> predeterminado: “2147483647”
Marca de configuración avanzada del motor interno Skyframe de Bazel. Si Bazel detecta que el uso porcentual retenido del montón supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando ocurra un evento menor de recolección de elementos no utilizados, se eliminará el estado temporal de Skyframe innecesario, hasta esta cantidad de veces por invocación. La configuración predeterminada es Integer.MAX_VALUE; eficazmente ilimitados. Cero significa que los eventos menores de recolección de elementos no utilizados nunca activarán la acción de soltar. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC menor y se supere ese umbral de porcentaje de montón retenido.
Etiquetas: host_machine_resource_optimizations
Valor predeterminado de --skyframe_high_water_mark_threshold=<an integer>: "85"
Marca de configuración avanzada del motor interno Skyframe de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es al menos este umbral, descartará el estado temporal de Skyframe innecesario. Ajustar esto puede permitirte mitigar el impacto en el tiempo de la hiperpaginación de GC cuando la hiperpaginación de GC (i) es causada por el uso de memoria de este estado temporal y (ii) es más costosa que reconstituir el estado cuando sea necesario.
Etiquetas: host_machine_resource_optimizations
.
Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--dump=<text or raw> [-d] predeterminado: ver descripción
resultado del volcado de datos del perfil completo, ya sea en un texto legible por humanos formato o "raw" compatible con secuencias de comandos de un conjunto de datos tengan un formato común.
Etiquetas: affects_outputs
Valor predeterminado de --[no]experimental_command_profile: "falso"
Registra un perfil de CPU de la grabadora de vuelos de Java en un archivo profile.jfr en el directorio base de salida. La sintaxis y la semántica de esta marca podrían cambiar en el futuro para admitir diferentes tipos de perfil o formatos de salida. usar bajo tu propia responsabilidad.
Valor predeterminado de --[no]experimental_record_metrics_for_all_mnemonics: "falso"
De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemónicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán las estadísticas de todos los mnemónicos.
Opciones que especifican o modifican una entrada genérica para un comando de Bazel que no se encuentra 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é remoto:
Valor predeterminado de --experimental_downloader_config=<a string>: ver descripción
Especifica un archivo con el que se configurará el cargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguidas de un nombre de host (para "allow" y "block") o dos patrones, uno para buscar coincidencias y otro para usar como URL sustituta, con referencias inversas a partir de `$1`. Es posible proporcionar varias directivas "rewrite" para la misma URL; en este caso, se devolverán varias URL.
Configuración predeterminada de --experimental_worker_for_repo_fetching=<off, platform or virtual>: "desactivada"
El modo de subprocesos que se usará para la recuperación del repositorio. Si se configura en “off”, no se usa ningún subproceso de trabajo y la recuperación del repositorio está sujeta a reinicios. De lo contrario, utiliza un subproceso de plataforma (es decir, un subproceso del SO) si está configurado como "platform". o un subproceso virtual si está configurado como “virtual”.
Otras opciones, que no se categorizan de ninguna otra manera:
Se acumulan --override_repository=<an equals-separated mapping of repository name to path> usos múltiples
Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso dada es una ruta de acceso absoluta, se usará tal como es. Si la ruta de acceso determinada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso dada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace"

Opciones de consulta

Hereda todas las opciones de build.

Opciones que aparecen antes del comando y que el cliente analiza:
Se acumulan --distdir=<a path> usos múltiples
Lugares adicionales para buscar archivos antes de acceder a la red y descargarlos.
Etiquetas: bazel_internal_configuration
Si se configura, la caché del repositorio vinculará el archivo en lugar de copiarlo en caso de que se produzca un acierto de caché. Esto está diseñado para ahorrar espacio en el disco.
Etiquetas: bazel_internal_configuration
Valor predeterminado de --experimental_repository_downloader_retries=<an integer>: "0"
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> valor 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 esperado por el autor de la regla, sin cambiar el código fuente.
Etiquetas: bazel_internal_configuration y experimental
Valor predeterminado de --http_connector_attempts=<an integer>: "8"
La cantidad máxima de intentos para descargas http.
Etiquetas: bazel_internal_configuration
Valor predeterminado de --http_connector_retry_max_timeout=<An immutable length of time.>: "0s"
El tiempo de espera máximo para los reintentos de descarga de HTTP. Con un valor de 0, no se define ningún tiempo de espera máximo.
Etiquetas: bazel_internal_configuration
--http_timeout_scaling=<a double> valor predeterminado: "1.0"
Escalar todos los tiempos de espera relacionados con las descargas HTTP según el factor determinado
Etiquetas: bazel_internal_configuration
Valor predeterminado de --repository_cache=<a path>: ver descripción
Especifica la ubicación de caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché; de lo contrario, el valor predeterminado es '<output_user_root>/cache/repos/v1'. se usa
Etiquetas: bazel_internal_configuration
Valor predeterminado de --[no]repository_disable_download: "falso"
Si se configura, no se permite la descarga con ctx.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no está completamente inhabilitado. ctx.execute aún podría ejecutar un ejecutable arbitrario que acceda a Internet.
Etiquetas: bazel_internal_configuration
.
Opciones que controlan la ejecución de compilación:
Valor predeterminado de --gc_thrashing_threshold=<an integer in 0-100 range>: "100"
El porcentaje del espacio permanente ocupado (0-100) por encima del cual GcThrashingDetector considera eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, GcThrashingDetector está inhabilitado.
Etiquetas: host_machine_resource_optimizations
.
Opciones relacionadas con el resultado de la consulta y la semántica:
--aspect_deps=<off, conservative or precise> predeterminado: “conservadora”
Cómo resolver dependencias de aspecto cuando el formato de salida es {xml,proto,record}. "desactivado" significa que no se resuelven dependencias de aspecto, “conservadora” (predeterminado) significa que todas las dependencias de aspecto declaradas se agregan independientemente de si se les da la clase de regla de dependencias directas, “precisa”. significa que solo se agregan los 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. Además, ten en cuenta que incluso el modo preciso no es del todo preciso: la decisión de calcular un aspecto se decide en la fase de análisis, que no se ejecuta durante la “consulta de Bazel”.
Etiquetas: build_file_semantics
Valor predeterminado de --[no]consistent_labels: "falso"
Si se habilita, cada comando de consulta emite etiquetas como si <code>str</code> de Starlark función aplicada a una <code>etiqueta</code> instancia. Esto resulta útil para las herramientas que necesitan hacer coincidir el resultado de diferentes comandos de consulta o etiquetas emitidas por las reglas. Si no se habilita, los formateadores de salida pueden emitir nombres de repositorio aparentes (en relación con el repositorio principal) en lugar de hacer que el resultado sea más legible.
Etiquetas: terminal_output
Valor predeterminado de --[no]graph:factored: "true"
Si es verdadero, el grafo 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> predeterminado: "512"
La longitud máxima de la cadena de etiqueta para un nodo del grafo en el resultado. Las etiquetas más largas se truncarán. -1 significa que no hay truncamiento. Esta opción solo se aplica a --output=graph.
Etiquetas: terminal_output
Valor predeterminado de --[no]implicit_deps: "true"
Si se habilita, las dependencias implícitas se incluirán en el gráfico de dependencias sobre el que opera la consulta. Una dependencia implícita es una que no se especifica de forma explícita en el archivo BUILD, pero la agrega Bazel. En el caso de cquery, esta opción controla el filtrado de cadenas de herramientas resueltas.
Etiquetas: build_file_semantics
Valor predeterminado de --[no]include_artifacts: "true"
Incluye los nombres de las entradas y salidas de las acciones en la salida (posiblemente grandes).
Etiquetas: terminal_output
Valor predeterminado de --[no]include_aspects: "true"
aquery, cquery: Se incluyen acciones generadas por aspectos en el resultado. consulta: no-op (siempre se siguen los aspectos).
Etiquetas: terminal_output
Valor predeterminado de --[no]include_commandline: "true"
Incluye el contenido de las líneas de comandos de acción en el resultado (posiblemente grande).
Etiquetas: terminal_output
Valor predeterminado de --[no]include_file_write_contents: "falso"
Incluye el contenido del archivo para las acciones FileWrite, SourceSymlinkManifest y RepoMappingManifest (posiblemente grandes).
Etiquetas: terminal_output
Valor predeterminado de --[no]include_param_files: "falso"
Incluye el contenido de los archivos de parámetros que se usaron en el comando (posiblemente grandes). Nota: Habilitar esta marca habilitará automáticamente la marca --include_commandline.
Etiquetas: terminal_output
Valor predeterminado de --[no]incompatible_package_group_includes_double_slash: "true"
Si se habilita esta opción, cuando se genere el atributo `packages` de package_group, no se omitirá el `//` inicial.
Etiquetas: terminal_output y incompatible_change
Valor predeterminado de --[no]infer_universe_scope: "falso"
Si no se establece ni --universe_scope, se inferirá un valor de --universe_scope como la lista de patrones de destino únicos en la expresión de consulta. Ten en cuenta que es posible que el valor --universe_scope inferido para una expresión de consulta que usa funciones con alcance universal (p.ej., `allrdeps`) no sea lo que quieres, por lo que debes usar esta opción solo si sabes lo que estás haciendo. Consulta https://bazel.build/reference/query#sky-query para obtener detalles y ejemplos. Si se configura --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
Valor predeterminado de --[no]line_terminator_null: "falso"
Indica si cada formato termina con \0 en lugar de un salto de línea.
Etiquetas: terminal_output
Valor predeterminado de --[no]nodep_deps: "true"
Si está habilitada, las dependencias de “nodep” atributos se incluirán en el gráfico de la dependencia en el que opera la consulta. Un ejemplo común de un “nodep” es “visibilidad”. Ejecuta y analiza el resultado de `info build-language` para conocer todos los “nodep” atributos en el lenguaje de compilación.
Etiquetas: build_file_semantics
--output=<a string> predeterminado: "texto"
El formato en el que se deben imprimir los resultados de BigQuery. Los valores permitidos para aquery son los siguientes: text, textproto, proto, streaming_proto y jsonproto.
Etiquetas: terminal_output
Valor predeterminado de --[no]proto:default_values: "true"
Si es verdadero, se incluirán los atributos cuyo valor no se especifica explícitamente en el archivo BUILD. de lo contrario, se omitirán. Esta opción se aplica a --output=proto
Etiquetas: terminal_output
Valor predeterminado de --[no]proto:definition_stack: "falso"
Propaga el campo de proto definition_stack, que registra la pila de llamadas de Starlark para cada instancia de la regla en el momento en que se definió la clase de la regla.
Etiquetas: terminal_output
Valor predeterminado de --[no]proto:flatten_selects: "true"
Si se habilita, se acoplan los atributos configurables creados por select(). Para los tipos de lista, la representación plana es una lista que contiene cada valor del mapa de selección exactamente una vez. Los tipos escalares se acoplan a nulos.
Etiquetas: build_file_semantics
Valor predeterminado de --[no]proto:include_attribute_source_aspects: "falso"
Propaga el campo de protocolo source_aspect_name de cada atributo con el aspecto de origen del que provino (cadena vacía si no es así).
Etiquetas: terminal_output
Valor predeterminado de --[no]proto:include_synthetic_attribute_hash: "falso"
Indica si se debe calcular y propagar el atributo $internal_attr_hash.
Etiquetas: terminal_output
Valor predeterminado de --[no]proto:instantiation_stack: "falso"
Propaga la pila de llamadas de creación de instancias de cada regla. Ten en cuenta que esto requiere que la pila esté presente
Etiquetas: terminal_output
Valor predeterminado de --[no]proto:locations: "true"
Establece si se debe emitir información de ubicación en el resultado de proto.
Etiquetas: terminal_output
--proto:output_rule_attrs=<comma-separated list of options> predeterminado: "todos"
Lista de atributos separados por comas para incluir en el resultado. La configuración predeterminada es todos los atributos. Se configura como una cadena vacía para no generar ningún atributo. Esta opción se aplica a --output=proto.
Etiquetas: terminal_output
Valor predeterminado de --[no]proto:rule_inputs_and_outputs: "true"
Indica si se deben completar o no 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 desde el archivo que se nombra aquí, en lugar de hacerlo en la línea de comandos. Es un error especificar aquí un archivo así como una consulta de línea de comandos.
Etiquetas: changes_inputs
Valor predeterminado de --[no]relative_locations: "falso"
Si es verdadero, la ubicación de los archivos Build en los resultados xml y proto será relativa. De forma predeterminada, el resultado de la ubicación es una ruta de acceso absoluta y no será coherente en todas las máquinas. Puedes configurar esta opción como verdadera para obtener un resultado coherente en todas las máquinas.
Etiquetas: terminal_output
Valor predeterminado de --[no]skyframe_state: "falso"
Sin realizar un análisis adicional, vuelca el gráfico de acción actual de Skyframe. Nota: Por el momento, no se admite la especificación de un destino con --skyframe_state. Este indicador solo está disponible con --output=proto o --output=textproto.
Etiquetas: terminal_output
Valor predeterminado de --[no]tool_deps: "true"
Consulta: Si está inhabilitada, depende de “exec configuration” no se incluirán en el gráfico de la dependencia en el que opera la consulta. Una “configuración de ejecución” perímetro de dependencia, como el de cualquier "proto_library" al compilador de protocolos, por lo general, apunta a una herramienta ejecutada durante la compilación en lugar de a una parte del mismo “destino” . Cquery: Si se inhabilita, filtra todos los destinos configurados que cruzan una transición de ejecución del objetivo de nivel superior que descubrió este objetivo configurado. Esto significa que, si el destino de nivel superior se encuentra en la configuración de destino, solo se mostrarán los destinos configurados que se encuentren también en esa configuración. Si el destino de nivel superior está en la configuración de ejecución, solo se mostrarán los destinos configurados de ejecución. Esta opción NO excluirá las cadenas de herramientas resueltas.
Etiquetas: build_file_semantics
Valor predeterminado de --universe_scope=<comma-separated list of options>: ""
Un conjunto de patrones de destino separados por comas (aditivos y sustractivos). La consulta puede realizarse en el universo definido por el cierre transitivo de los objetivos especificados. Esta opción se usa para los comandos de consulta y cquery. Para cquery, la entrada de esta opción son los destinos en los que se crean todas las respuestas, por lo que esta opción puede afectar las configuraciones y transiciones. Si no se especifica esta opción, se supone que los objetivos de nivel superior son los objetivos analizados de la expresión de consulta. Nota: Para cquery, no especificar esta opción puede hacer que la compilación se rompa si los objetivos analizados desde la expresión de 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 --allow_yanked_versions=<a string> usos múltiples
Se especificaron las versiones de los módulos con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resueltas, incluso si se declaran como eliminadas en el registro del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones rechazadas harán que la resolución falle. También puedes definir la versión generada permitida con la variable de entorno `BZLMOD_ALLOW_YANKED_VERSIONS`. Puedes inhabilitar esta verificación con la palabra clave “todo” (no se recomienda).
Etiquetas: loading_and_analysis
Valor predeterminado de --check_bazel_compatibility=<error, warning or off>: "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 caso 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: "advertencia"
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 derivarla a una falla de resolución.
Etiquetas: loading_and_analysis
Valor predeterminado de --[no]ignore_dev_dependency: "falso"
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en 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
Valor predeterminado de --lockfile_mode=<off, update or error>: "actualizar"
Especifica cómo y si se debe usar o no 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 arroja un error si no está actualizado, o "off" para que no se lea ni escriba en el archivo de bloqueo.
Etiquetas: loading_and_analysis
Se acumulan --override_module=<an equals-separated mapping of module name to path> usos múltiples
Anula un módulo con una ruta de acceso local en el formato <module name>=<path>. Si la ruta de acceso dada es una ruta de acceso absoluta, se usará tal como es. Si la ruta de acceso determinada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso dada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace"
Se acumulan --registry=<a string> usos múltiples
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en registros anteriores y solo se recurrirán a los registros posteriores cuando no estén en los registros anteriores.
Etiquetas: changes_inputs
.
Opciones que activan optimizaciones del tiempo de compilación:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>> predeterminado: "1s:2,20s:3,1m:5"
Límites que, si se alcanzan, hacen que GcThrashingDetector bloquee Bazel con una OOM. Cada límite se especifica como <period>:<count> En el ejemplo anterior, el período es una duración y el recuento es un número entero positivo. Si hay más de --gc_thrashing_threshold por ciento de espacio titular (montón de generación anterior) permanece ocupado después de <count> recolecciones de elementos no utilizados consecutivos en <period>, se activará una OOM. Si hay varios límites, puedes separarlos por comas.
Etiquetas: host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0> predeterminado: “2147483647”
Marca de configuración avanzada del motor interno Skyframe de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de recolección de elementos no utilizados completa, eliminará el estado temporal de Skyframe innecesario, hasta esta cantidad de veces por invocación. La configuración predeterminada es Integer.MAX_VALUE; eficazmente ilimitados. Cero significa que los eventos de recolección de elementos no utilizados completas nunca activarán la acción de soltar. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC completo y se supere ese umbral de porcentaje de montón retenido.
Etiquetas: host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0> predeterminado: “2147483647”
Marca de configuración avanzada del motor interno Skyframe de Bazel. Si Bazel detecta que el uso porcentual retenido del montón supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando ocurra un evento menor de recolección de elementos no utilizados, se eliminará el estado temporal de Skyframe innecesario, hasta esta cantidad de veces por invocación. La configuración predeterminada es Integer.MAX_VALUE; eficazmente ilimitados. Cero significa que los eventos menores de recolección de elementos no utilizados nunca activarán la acción de soltar. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC menor y se supere ese umbral de porcentaje de montón retenido.
Etiquetas: host_machine_resource_optimizations
Valor predeterminado de --skyframe_high_water_mark_threshold=<an integer>: "85"
Marca de configuración avanzada del motor interno Skyframe de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es al menos este umbral, descartará el estado temporal de Skyframe innecesario. Ajustar esto puede permitirte mitigar el impacto en el tiempo de la hiperpaginación de GC cuando la hiperpaginación de GC (i) es causada por el uso de memoria de este estado temporal y (ii) es más costosa que reconstituir el estado cuando sea necesario.
Etiquetas: host_machine_resource_optimizations
.
Opciones que afectan la verbosidad, el formato o la ubicación del registro:
Valor predeterminado de --[no]experimental_command_profile: "falso"
Registra un perfil de CPU de la grabadora de vuelos de Java en un archivo profile.jfr en el directorio base de salida. La sintaxis y la semántica de esta marca podrían cambiar en el futuro para admitir diferentes tipos de perfil o formatos de salida. usar bajo tu propia responsabilidad.
Valor predeterminado de --[no]experimental_record_metrics_for_all_mnemonics: "falso"
De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemónicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán las estadísticas de todos los mnemónicos.
Opciones que especifican o modifican una entrada genérica para un comando de Bazel que no se encuentra 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é remoto:
Valor predeterminado de --experimental_downloader_config=<a string>: ver descripción
Especifica un archivo con el que se configurará el cargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguidas de un nombre de host (para "allow" y "block") o dos patrones, uno para buscar coincidencias y otro para usar como URL sustituta, con referencias inversas a partir de `$1`. Es posible proporcionar varias directivas "rewrite" para la misma URL; en este caso, se devolverán varias URL.
Configuración predeterminada de --experimental_worker_for_repo_fetching=<off, platform or virtual>: "desactivada"
El modo de subprocesos que se usará para la recuperación del repositorio. Si se configura en “off”, no se usa ningún subproceso de trabajo y la recuperación del repositorio está sujeta a reinicios. De lo contrario, utiliza un subproceso de plataforma (es decir, un subproceso del SO) si está configurado como "platform". o un subproceso virtual si está configurado como “virtual”.
Otras opciones, que no se categorizan de ninguna otra manera:
Se acumulan --override_repository=<an equals-separated mapping of repository name to path> usos múltiples
Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso dada es una ruta de acceso absoluta, se usará tal como es. Si la ruta de acceso determinada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso dada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace"
Opciones que controlan la ejecución de compilación:
Especifica si se deben realizar llamadas directas al sistema de archivos para crear árboles de symlinks.
Etiquetas: loading_and_analysis, execution y experimental
Valor predeterminado de --[no]experimental_persistent_aar_extractor: "falso"
Habilita el extractor de aar persistente con trabajadores.
Etiquetas: execution
Valor predeterminado de --[no]experimental_remotable_source_manifests: "falso"
Establece si las acciones del manifiesto de la fuente se pueden usar de forma remota.
Etiquetas: loading_and_analysis, execution y experimental
Valor predeterminado de --[no]experimental_split_coverage_postprocessing: "falso"
Si es verdadero, Bazel ejecutará el procesamiento posterior de cobertura para realizar pruebas en un generación nuevo.
Etiquetas: execution
Valor predeterminado de --[no]experimental_strict_fileset_output: "falso"
Si se habilita esta opción, los conjuntos de archivos tratarán todos los artefactos de salida como archivos normales. No desviarán directorios ni serán sensibles a los symlinks.
Etiquetas: execution
Valor predeterminado de --modify_execution_info=<regex=[+-]key,regex=[+-]key,...>: ""
Agrega o quita teclas de la información de ejecución de una acción según el nombre nemotécnico 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 regex pueden aplicarse al mismo nombre nemotécnico. Sintaxis: “regex=[+-]key,regex=[+-]key,...”. Ejemplos: '.*=+x,.*=-y,.*=+z' agrega una 'x' y en "z" a y quita "y" de la información de ejecución de todas las acciones. 'Genrule=+requires-x' agrega “requiere-x” a la información de ejecución de todas las acciones de Genrule. “(?!Genrule).*=-required-x” quita “requiere-x” a partir de la información de ejecución para todas las acciones que no son de Genrule.
Etiquetas: execution, affects_outputs y loading_and_analysis
--persistent_android_dex_desugar
Habilita acciones persistentes de dex y expansión de sintaxis de Android mediante trabajadores.
Se expande a:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker

Etiquetas: host_machine_resource_optimizations y execution
--persistent_android_resource_processor
Habilita el procesador de recursos persistente de Android con trabajadores.
Se expande a:
--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

de --strategy=AndroidResourceMerger=worker
de --strategy=AndroidCompiledResourceMerger=worker
de --strategy=ManifestMerger=worker --strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker

de --strategy=AARGenerator=worker
de --strategy=ProcessDatabinding=worker
de --strategy=GenerateDataBindingBaseClasses=worker
Etiquetas: host_machine_resource_optimizations y execution
--persistent_multiplex_android_dex_desugar
Habilita acciones persistentes de dex y desugar de Android multiplexadas usando trabajadores.
Se expande a:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar

Etiquetas: host_machine_resource_optimizations y execution
--persistent_multiplex_android_resource_processor
Habilita el procesador de recursos multiplexados de Android persistente con trabajadores.
Se expande a:
--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

de --modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
de --modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
de --modify_execution_info=ManifestMerger=+supports-multiplex-workers --modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers

de --modify_execution_info=AARGenerator=+supports-multiplex-workers
Etiquetas: host_machine_resource_optimizations y execution
--persistent_multiplex_android_tools
Habilita herramientas de Android persistentes y multiplexadas (dexing, expansión de sintaxis y 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 y execution
Valor predeterminado de --[no]use_target_platform_for_tests: "falso"
Si es verdadero, Bazel usará la plataforma de destino para ejecutar pruebas en lugar del grupo de ejecución de pruebas.
Etiquetas: execution
.
Opciones que configuran la cadena de herramientas utilizada para la ejecución de la acción:
Valor predeterminado de --android_compiler=<a string>: ver descripción
El compilador de destino de Android.
Etiquetas: affects_outputs, loading_and_analysis y loses_incremental_state
--android_crosstool_top=<a build target label> predeterminado: "//external:android/crosstool"
La ubicación del compilador C++ que se usa para las compilaciones de Android.
Etiquetas: affects_outputs, changes_inputs, loading_and_analysis y loses_incremental_state
Valor predeterminado de --android_grte_top=<a label>: ver descripción
El objetivo de Android grte_top.
Etiquetas: changes_inputs, loading_and_analysis y loses_incremental_state
--android_manifest_merger=<legacy, android or force_android> predeterminado: "android"
Selecciona la combinación de manifiestos que se usará para las reglas android_binary. Marca para ayudar a la transición de la combinación de manifiestos de Android desde la combinación heredada.
Etiquetas: affects_outputs, loading_and_analysis y loses_incremental_state
Valor predeterminado de --android_platforms=<a build target label>: ""
Establece las plataformas que usan los objetivos android_binary. Si se especifican varias plataformas, el objeto binario es un APK multiarquitectura, que contiene binarios nativos para cada plataforma de destino especificada.
Etiquetas: changes_inputs, loading_and_analysis y loses_incremental_state
--android_sdk=<a build target label> predeterminado: "@bazel_tools//tools/android:sdk"
Especifica el SDK o la plataforma de Android que se usa para compilar aplicaciones para Android.
Etiquetas: changes_inputs, loading_and_analysis y loses_incremental_state
--apple_crosstool_top=<a build target label> predeterminado: “@bazel_tools//tools/cpp:toolchain”
La etiqueta del paquete de herramientas cruzadas que se usará en las reglas de Apple y Objc y sus dependencias.
Etiquetas: loses_incremental_state y changes_inputs
Valor predeterminado de --cc_output_directory_tag=<a string>: ""
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas: affects_outputs
Valor predeterminado de --compiler=<a string>: ver descripción
El compilador de C++ que se usará para compilar el destino.
Etiquetas: loading_and_analysis y execution
--coverage_output_generator=<a build target label> predeterminado: "@bazel_tools//tools/test:lcov_merger"
Ubicación del objeto binario que se usa para procesar posteriormente los informes de cobertura sin procesar. Actualmente, debe ser un grupo de archivos que contenga un solo archivo: el objeto binario. La configuración predeterminada es “//tools/test:lcov_merger”.
Etiquetas: changes_inputs, affects_outputs y loading_and_analysis
--coverage_report_generator=<a build target label> predeterminado: “@bazel_tools//tools/test:coverage_report_generator”
Ubicación del objeto binario que se usa para generar informes de cobertura. Actualmente, debe ser un grupo de archivos que contenga un solo archivo: el objeto binario. La configuración predeterminada es “//tools/test:coverage_report_generator”.
Etiquetas: changes_inputs, affects_outputs y loading_and_analysis
--coverage_support=<a build target label> predeterminado: "@bazel_tools//tools/test:coverage_support"
Ubicación de los archivos de compatibilidad que se requieren en las entradas de cada acción de prueba que recopila la cobertura de código. La configuración predeterminada es “//tools/test:coverage_support”.
Etiquetas: changes_inputs, affects_outputs y loading_and_analysis
--crosstool_top=<a build target label> predeterminado: “@bazel_tools//tools/cpp:toolchain”
La etiqueta del paquete de herramientas cruzadas que se usará para compilar el código de C++.
Etiquetas: loading_and_analysis, changes_inputs y affects_outputs
Valor predeterminado de --custom_malloc=<a build target label>: ver descripción
Especifica una implementación de malloc personalizada. Esta configuración anula los atributos malloc en las reglas de compilación.
Etiquetas: changes_inputs y affects_outputs
Se acumulan --experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment> usos múltiples
Lista de expresiones regulares separadas por comas, cada una con el prefijo - (expresión negativa) opcionalmente, asignadas (=) a una lista de objetivos de valores de restricción separados por comas. Si un objetivo no coincide con ninguna expresión negativa y al menos una expresión positiva, la resolución de la cadena de herramientas se realizará como si se hubieran declarado los valores de la 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
Valor predeterminado de --[no]experimental_include_xcode_execution_requirements: "falso"
Si está configurado, agrega un campo "requires-xcode:{version}". de ejecución requerido a cada acción de Xcode. Si la versión de Xcode tiene una etiqueta con guiones, agrega también la etiqueta “requires-xcode-label:{version_label}”. de ejecución.
Etiquetas: loses_incremental_state, loading_and_analysis y execution
Valor predeterminado de --[no]experimental_prefer_mutual_xcode: "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 mutuas disponibles, usa la versión de Xcode local seleccionada a través de xcode-select.
Etiquetas: loses_incremental_state
Valor predeterminado de --extra_execution_platforms=<comma-separated list of options>: ""
Son las plataformas que están 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 declaradas en el archivo WORKSPACE por register_execution_platforms(). Esta opción solo se puede configurar una vez. las instancias posteriores anularán la configuración de las marcas anteriores.
Etiquetas: execution
Se acumulan --extra_toolchains=<comma-separated list of options> usos múltiples
Las reglas de la cadena de herramientas que se deben considerar durante su resolución. Las cadenas de herramientas se pueden especificar por objetivo exacto o como un patrón de objetivo. Estas cadenas de herramientas se considerarán antes de las declaradas en el archivo WORKSPACE por register_toolchains().
Etiquetas: affects_outputs, changes_inputs y loading_and_analysis
Valor predeterminado de --grte_top=<a label>: ver descripción
Es una etiqueta para una biblioteca de libc abierta. La cadena de herramientas de crosstool selecciona el valor predeterminado, y casi nunca necesitas anularlo.
Etiquetas: action_command_lines y affects_outputs
Valor predeterminado de --host_compiler=<a string>: ver descripción
El compilador de C++ que se usará para la compilación del host. Se ignora si no se configura --host_crosstool_top.
Etiquetas: loading_and_analysis y execution
Valor predeterminado de --host_crosstool_top=<a build target label>: ver descripción
De forma predeterminada, las opciones --crosstool_top y --compiler también se usan para la configuración de ejecución. Si se proporciona este indicador, Bazel usa el compilador y la libc predeterminados para el crosstool_top específico.
Etiquetas: loading_and_analysis, changes_inputs y affects_outputs
Valor predeterminado de --host_grte_top=<a label>: ver descripción
Si se especifica, esta configuración anula el directorio de nivel superior de libc (--grte_top) para la configuración de exec.
Etiquetas: action_command_lines y affects_outputs
--host_platform=<a build target label> predeterminado: “@local_config_platform//:host”
Es la etiqueta de una regla de la plataforma que describe el sistema host.
Etiquetas: affects_outputs, changes_inputs y loading_and_analysis
Valor predeterminado de --[no]incompatible_dont_enable_host_nonhost_crosstool_features: "true"
Si es verdadero, Bazel no habilitará “host”. y “no host” de la cadena de herramientas de c++ (consulta https://github.com/bazelbuild/bazel/issues/7407 para obtener más información).
Etiquetas: loading_and_analysis y incompatible_change
Valor predeterminado de --[no]incompatible_enable_android_toolchain_resolution: "true"
Usa la resolución de la cadena de herramientas para seleccionar el SDK de Android para las reglas de Android (Starlark y nativo)
Etiquetas: loading_and_analysis y incompatible_change
Valor predeterminado de --[no]incompatible_enable_apple_toolchain_resolution: "falso"
Usa la resolución de la cadena de herramientas para seleccionar el SDK de Apple para las reglas de Apple (Starlark y nativo)
Etiquetas: loading_and_analysis y incompatible_change
Valor predeterminado de --[no]incompatible_make_thinlto_command_lines_standalone: "true"
Si es verdadero, Bazel no reutilizará las líneas de comandos de acción de vínculo de C++ para las líneas de comandos de indexación lto (consulta https://github.com/bazelbuild/bazel/issues/6791 para obtener más información).
Etiquetas: loading_and_analysis y incompatible_change
Valor predeterminado de --[no]incompatible_remove_legacy_whole_archive: "true"
Si es verdadero, Bazel no vinculará las dependencias de bibliotecas como archivos completos de forma predeterminada (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener instrucciones de migración).
Etiquetas: loading_and_analysis y incompatible_change
Valor predeterminado de --[no]incompatible_require_ctx_in_configure_features: "true"
Si el valor es verdadero, Bazel requerirá "{4/}". en cc_common.configure_features (consulta https://github.com/bazelbuild/bazel/issues/7793 para obtener más información).
Etiquetas: loading_and_analysis y incompatible_change
Valor predeterminado de --[no]interface_shared_objects: "true"
Usa objetos compartidos de la interfaz si la cadena de herramientas lo admite. Actualmente, todas las cadenas de herramientas ELF admiten esta configuración.
Etiquetas: loading_and_analysis, affects_outputs y affects_outputs
Valor predeterminado de --ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ver descripción
Especifica la versión del SDK de iOS que se usará para compilar aplicaciones de iOS. Si no se especifica, usa la versión predeterminada del SDK de iOS de “xcode_version”.
Etiquetas: loses_incremental_state
Valor predeterminado de --macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ver descripción
Especifica la versión del SDK de macOS que se usará para compilar aplicaciones de macOS. Si no se especifica, se usa la versión predeterminada del SDK de macOS de “xcode_version”.
Etiquetas: loses_incremental_state
Valor predeterminado de --minimum_os_version=<a string>: ver descripción
La versión mínima del SO a la que se orienta tu compilación.
Etiquetas: loading_and_analysis y affects_outputs
Valor predeterminado de --platform_mappings=<a relative path>: ""
La ubicación de un archivo de asignación que describe qué plataforma usar si no hay ninguna establecida o qué marcas se deben configurar cuando ya existe una plataforma. Debe estar relacionada con la raíz principal del lugar de trabajo. La configuración predeterminada es “platform_mappings”. (un archivo directamente debajo de la raíz del espacio de trabajo).
Etiquetas: affects_outputs, changes_inputs y loading_and_analysis
Valor predeterminado de --platforms=<a build target label>: ""
Las etiquetas de las reglas de la plataforma que describen las plataformas de destino para el comando actual.
Etiquetas: affects_outputs, changes_inputs y loading_and_analysis
Valor predeterminado de --python2_path=<a string>: ver descripción
Obsoleto, no-op. Inhabilitado por `--incompatible_use_python_toolchains`.
Etiquetas: no_op y deprecated
Valor predeterminado de --python3_path=<a string>: ver descripción
Obsoleto, no-op. Inhabilitado por `--incompatible_use_python_toolchains`.
Etiquetas: no_op y deprecated
Valor predeterminado de --python_path=<a string>: ver descripción
La ruta de acceso absoluta del intérprete de Python invocado para ejecutar objetivos de Python en la plataforma de destino. Obsoleto; inhabilitado por --incompatible_use_python_toolchains.
Etiquetas: loading_and_analysis y affects_outputs
Valor predeterminado de --python_top=<a build target label>: ver descripción
Es la etiqueta de un py_runtime que representa el intérprete de Python invocado para ejecutar objetivos de Python en la plataforma de destino. Obsoleto; inhabilitado por --incompatible_use_python_toolchains.
Etiquetas: loading_and_analysis y affects_outputs
Valor predeterminado de --tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ver descripción
Especifica la versión del SDK de tvOS que se usará para compilar aplicaciones de tvOS. Si no se especifica, usa la versión predeterminada del SDK de tvOS de "xcode_version".
Etiquetas: loses_incremental_state
Valor predeterminado de --watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ver descripción
Especifica la versión del SDK de watchOS que se usará para compilar aplicaciones de watchOS. Si no se especifica, se usa la versión predeterminada del SDK de watchOS de “xcode_version”.
Etiquetas: loses_incremental_state
Valor predeterminado de --xcode_version=<a string>: ver descripción
Si se especifica, usa Xcode de la versión determinada para las acciones de compilación relevantes. Si no se especifica, usa la versión predeterminada del ejecutor de Xcode.
Etiquetas: loses_incremental_state
--xcode_version_config=<a build target label> predeterminado: “@bazel_tools//tools/cpp:host_xcodes”
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 y loading_and_analysis
Opciones que controlan el resultado del comando:
Valor predeterminado de --[no]apple_generate_dsym: "falso"
Indica si se deben generar archivos de símbolos de depuración (.dSYM).
Etiquetas: affects_outputs y action_command_lines
Si es verdadero, compila bosques de symlink de archivos de ejecución para todos los destinos. Si es falso, escríbelos solo cuando lo requiera una acción local, prueba o comando de ejecución.
Etiquetas: affects_outputs
Valor predeterminado de --[no]build_runfile_manifests: "true"
Si es verdadero, escribe manifiestos de archivos de ejecución para todos los destinos. Si es falsa, omítelas. Las pruebas locales no se ejecutarán si el valor es falso.
Etiquetas: affects_outputs
Valor predeterminado de --[no]build_test_dwp: "falso"
Si se habilita, al compilar pruebas de C++ de forma estática y con fisión, también se compilará automáticamente el archivo .dwp para el objeto binario de prueba.
Etiquetas: loading_and_analysis y affects_outputs
--cc_proto_library_header_suffixes=<comma-separated set of options> predeterminado: ".pb.h"
Establece los sufijos de los archivos de encabezado que crea cc_proto_library.
Etiquetas: affects_outputs y loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated set of options> predeterminado: ".pb.cc"
Establece los sufijos de los archivos de origen que crea cc_proto_library.
Etiquetas: affects_outputs y loading_and_analysis
Valor predeterminado de --[no]experimental_proto_descriptor_sets_include_source_info: "falso"
Ejecuta acciones adicionales para versiones alternativas de la API de Java en una proto_library.
Etiquetas: affects_outputs, loading_and_analysis y experimental
Valor predeterminado de --[no]experimental_proto_extra_actions: "falso"
Ejecuta acciones adicionales para versiones alternativas de la API de Java en una proto_library.
Etiquetas: affects_outputs, loading_and_analysis y experimental
Valor predeterminado de --[no]experimental_save_feature_state: "falso"
Guarda el estado de las funciones habilitadas y solicitadas como resultado de la compilación.
Etiquetas: affects_outputs y experimental
--fission=<a set of compilation modes> predeterminado: "no"
Especifica qué modos de compilación usan la fisión para compilaciones y vínculos de C++. Puede ser cualquier combinación de {'fastbuild', 'dbg', 'opt'} o los valores especiales 'sí' para habilitar todos los modos y hacer clic en "no". para inhabilitar todos los modos.
Etiquetas: loading_and_analysis, action_command_lines y affects_outputs
Valor predeterminado de --[no]incompatible_always_include_files_in_data: "true"
Si esta preferencia se establece como "true", las reglas nativas agregarán <code>DefaultInfo.files</code>. de las dependencias de datos a sus runfiles, lo que coincide con el comportamiento recomendado para las reglas de Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid).
Etiquetas: affects_outputs y incompatible_change
Valor predeterminado de --[no]legacy_external_runfiles: "true"
Si es verdadero, compila bosques de symlink de archivos de ejecución para repositorios externos en .runfiles/wsname/external/repo (además de .runfiles/repo).
Etiquetas: affects_outputs
Valor predeterminado de --[no]objc_generate_linkmap: "falso"
Especifica si se debe generar un archivo de mapa de vínculos.
Etiquetas: affects_outputs
Valor predeterminado de --[no]save_temps: "falso"
Si lo estableces, se guardarán los resultados temporales de GCC. Entre estos, se incluyen archivos .s (código ensamblador), .i (C++ previamente procesado) y .ii (C++ previamente procesados).
Etiquetas: affects_outputs
.
Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
Se acumulan --action_env=<a 'name=value' assignment with an optional value part> usos múltiples
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 por el par nombre=valor que establece el valor de forma independiente del entorno de invocación. Esta opción se puede usar varias veces. en el caso de opciones proporcionadas para la misma variable, se acumulan las últimas victorias y se acumulan opciones para diferentes variables.
Etiquetas: action_command_lines
--android_cpu=<a string> predeterminado: "armeabi-v7a"
La CPU de destino de Android
Etiquetas: affects_outputs, loading_and_analysis y loses_incremental_state
Valor predeterminado de --[no]android_databinding_use_androidx: "true"
Genera archivos de vinculación de datos compatibles con AndroidX. Esto solo se usa con la vinculación de datos v2. Esta marca es una no-op.
Etiquetas: affects_outputs, loading_and_analysis, loses_incremental_state y experimental
Valor predeterminado de --[no]android_databinding_use_v3_4_args: "true"
Usa android databinding v2 con el argumento 3.4.0. Esta marca es una no-op.
Etiquetas: affects_outputs, loading_and_analysis, loses_incremental_state y experimental
Configuración predeterminada de --android_dynamic_mode=<off, default or fully>: "desactivada"
Determina si las dependencias de C++ de reglas de Android se vincularán dinámicamente cuando un objeto cc_binary no cree explícitamente una biblioteca compartida. 'predeterminado' significa que Bazel elegirá si realizar la vinculación de forma dinámica. "completamente" significa que todas las bibliotecas se vincularán de forma dinámica. "desactivado" significa que todas las bibliotecas se vincularán en su mayoría en modo estático.
Etiquetas: affects_outputs y loading_and_analysis
Valor predeterminado de --android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>: "alfabético"
Establece el orden de los manifiestos que se pasan a la combinación de manifiestos para los objetos binarios de Android. ALFABÉTICO 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 relacionadas con el directorio de configuración dentro del directorio de salida. DEPENDENCY significa que los manifiestos se ordenan; el de cada biblioteca antecede a los de sus dependencias.
Etiquetas: action_command_lines y execution
Valor predeterminado de --[no]android_resource_shrinking: "falso"
Habilita la reducción de recursos para los APK android_binary que usan ProGuard.
Etiquetas: affects_outputs y loading_and_analysis
--[no]build_python_zip predeterminado: "automático"
Compila el archivo ZIP ejecutable de Python; Activado en Windows y desactivado en otras plataformas
Etiquetas: affects_outputs
Se acumulan --catalyst_cpus=<comma-separated list of options> usos múltiples
Lista de arquitecturas separadas por comas para las que se compilarán objetos binarios de Apple Catalyst.
Etiquetas: loses_incremental_state y loading_and_analysis
Valor predeterminado de --[no]collect_code_coverage: "falso"
Si se especifica, Bazel instrumentará el código (usando instrumentación sin conexión cuando sea posible) y recopilará información de cobertura durante las pruebas. Solo se verán afectadas las orientaciones que coincidan con --instrumentation_filter. Por lo general, esta opción no debe especificarse directamente: "cobertura de Bazel". en su lugar.
Etiquetas: affects_outputs
--compilation_mode=<fastbuild, dbg or opt> [-c] predeterminado: "fastbuild"
Especifica el modo en que se compilará el objeto binario. Valores: “fastbuild”, “dbg”, “opt”.
Etiquetas: affects_outputs y action_command_lines
Se acumulan --conlyopt=<a string> usos múltiples
Es una opción adicional para pasar a gcc cuando se compilan archivos de origen C.
Etiquetas: action_command_lines y affects_outputs
Se acumulan --copt=<a string> usos múltiples
Opciones adicionales para pasar a gcc.
Etiquetas: action_command_lines y affects_outputs
Valor predeterminado de --cpu=<a string>: ""
La CPU de destino.
Etiquetas: changes_inputs y affects_outputs
Valor predeterminado de --cs_fdo_absolute_path=<a string>: ver descripción
Usa la información de 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 indexado o sin procesar.
Etiquetas: affects_outputs
Valor predeterminado de --cs_fdo_instrument=<a string>: ver descripción
Genera objetos binarios con instrumentación FDO sensible al contexto. Con el compilador Clang/LLVM, también acepta el nombre del directorio bajo el cual se volcarán los archivos de perfil sin procesar en el tiempo de ejecución.
Etiquetas: affects_outputs
Valor predeterminado de --cs_fdo_profile=<a build target label>: ver descripción
El cs_fdo_profile que representa el perfil sensible al contexto que se usará para la optimización.
Etiquetas: affects_outputs
Se acumulan --cxxopt=<a string> usos múltiples
Es una opción adicional para pasar a gcc cuando se compilan archivos de origen C++.
Etiquetas: action_command_lines y affects_outputs
Se acumulan --define=<a 'name=value' assignment> usos múltiples
Cada opción --define especifica una asignación para una variable de compilación.
Etiquetas: changes_inputs y affects_outputs
Valor predeterminado de --dynamic_mode=<off, default or fully>: “predeterminado”
Determina si se vincularán dinámicamente los objetos binarios de C++. 'predeterminado' significa que Bazel elegirá si realizar la vinculación de forma dinámica. "completamente" significa que todas las bibliotecas se vincularán de forma dinámica. "desactivado" significa que todas las bibliotecas se vincularán en su mayoría en modo estático.
Etiquetas: loading_and_analysis y affects_outputs
Valor predeterminado de --[no]enable_fdo_profile_absolute_path: "true"
Si se configura, el uso de fdo_logical_profile_path generará un error.
Etiquetas: affects_outputs
--[no]enable_runfiles predeterminado: "automático"
Habilitar el árbol de symlink de archivos de ejecución De forma predeterminada, la función está desactivada en Windows y activada en otras plataformas.
Etiquetas: affects_outputs
Se acumulan --experimental_action_listener=<a build target label> usos múltiples
Obsoleto para dar lugar a aspectos. Usa action_listener para adjuntar una extra_action a las acciones de compilación existentes.
Etiquetas: execution y experimental
Valor predeterminado de --[no]experimental_android_compress_java_resources: "falso"
Comprime recursos de Java en los APK
Etiquetas: affects_outputs, loading_and_analysis y experimental
Valor predeterminado de --[no]experimental_android_databinding_v2: "true"
Usa Android Databinding v2. Esta marca es una no-op.
Etiquetas: affects_outputs, loading_and_analysis, loses_incremental_state y experimental
Valor predeterminado de --[no]experimental_android_resource_shrinking: "falso"
Habilita la reducción de recursos para los APK android_binary que usan ProGuard.
Etiquetas: affects_outputs y loading_and_analysis
Valor predeterminado de --[no]experimental_android_rewrite_dexes_with_rex: "falso"
usar la herramienta rex para reescribir archivos dex
Etiquetas: affects_outputs, loading_and_analysis, loses_incremental_state y experimental
Valor predeterminado de --[no]experimental_collect_code_coverage_for_generated_files: "falso"
Si se especifica, Bazel también recopilará informació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 objc fastbuild.
Etiquetas: action_command_lines
Valor predeterminado de --[no]experimental_omitfp: "falso"
Si es verdadero, usa libunwind para desenrollar la pila y compila con -fomit-frame-pointer y -faasync-unwind-tables.
Etiquetas: action_command_lines, affects_outputs y experimental
Configuración predeterminada de --experimental_output_paths=<off, content or strip>: "desactivada"
Qué modelo usar para dónde en las reglas del árbol de salida se escriben sus resultados, en particular para compilaciones multiplataforma o con varias configuraciones. Esto es altamente experimental. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/6526. Las acciones de Starlark pueden habilitar la asignación de rutas agregando la tecla “supports-path-mapping”. a los requisitos de ejecución dict.
Etiquetas: loses_incremental_state, bazel_internal_configuration, affects_outputs y execution
Se acumulan --experimental_override_name_platform_in_output_dir=<a 'label=value' assignment> usos múltiples
Cada entrada debe tener el formato label=value, en el que la etiqueta hace referencia a una plataforma y los valores es el nombre corto deseado para usar en la ruta de salida. Solo se utiliza cuando --experimental_platform_in_output_dir es verdadero. Tiene la prioridad de nomenclatura más alta.
Etiquetas: affects_outputs y experimental
Valor predeterminado de --[no]experimental_platform_in_output_dir: "falso"
Si es verdadero, se usa un nombre corto para la plataforma de destino en el nombre del directorio de salida en lugar de la CPU. El esquema exacto es experimental y está sujeto a cambios. En primer lugar, en el caso poco probable de que la opción --platforms no tenga exactamente un valor, se utiliza un hash de la opción de plataformas. A continuación, si --experimental_override_name_platform_in_output_dir registró algún nombre corto para la plataforma actual, se utilizará ese nombre corto. Luego, si se configuró --experimental_use_platforms_in_output_dir_legacy_heuristic, use un nombre corto basado en la etiqueta de la plataforma actual. Por último, se usa un hash de la opción de plataforma como último recurso.
Etiquetas: affects_outputs y experimental
Valor predeterminado de --[no]experimental_use_llvm_covmap: "falso"
Si se especifica, Bazel generará información del mapa de cobertura llvm-cov en lugar de gcov cuando collect_code_coverage esté habilitado.
Etiquetas: changes_inputs, affects_outputs, loading_and_analysis y experimental
Valor predeterminado de --[no]experimental_use_platforms_in_output_dir_legacy_heuristic: "true"
Solo usa esta marca como parte de una estrategia de prueba o migración sugerida. Ten en cuenta que la heurística presenta deficiencias conocidas y se sugiere migrar a solo --experimental_override_name_platform_in_output_dir.
Etiquetas: affects_outputs y experimental
--fat_apk_cpu=<comma-separated set of options> predeterminado: "armeabi-v7a"
Configurar esta opción habilita los APK 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 android_binary.
Etiquetas: affects_outputs, loading_and_analysis y loses_incremental_state
Valor predeterminado de --[no]fat_apk_hwasan: "falso"
Establece si se deben crear divisiones de HWASAN.
Etiquetas: affects_outputs, loading_and_analysis y loses_incremental_state
Valor predeterminado de --fdo_instrument=<a string>: ver descripción
Generar objetos binarios con instrumentación FDO Con el compilador Clang/LLVM, también acepta el nombre del directorio bajo el cual se volcarán los archivos de perfil sin procesar en el tiempo de ejecución.
Etiquetas: affects_outputs
Valor predeterminado de --fdo_optimize=<a string>: ver descripción
Usa la información del perfil 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 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 apunten a destinos de `fdo_profile`. Esta marca se reemplazará por la regla `fdo_profile`.
Etiquetas: affects_outputs
Valor predeterminado de --fdo_prefetch_hints=<a build target label>: ver descripción
Usa sugerencias de carga previa de caché.
Etiquetas: affects_outputs
Valor predeterminado de --fdo_profile=<a build target label>: ver descripción
El fdo_profile que representa el perfil que se utilizará para la optimización.
Etiquetas: affects_outputs
Se acumulan --features=<a string> usos múltiples
Las funciones determinadas estarán habilitadas o inhabilitadas de forma predeterminada para los destinos integrados en la configuración de destino. Especificando -<feature> la inhabilitará. Los atributos negativos siempre anulan los positivos. Consulta también --host_features
Etiquetas: changes_inputs y affects_outputs
Valor predeterminado de --[no]force_pic: "falso"
Si se habilitan, todas las compilaciones de C++ producen código independiente de la posición ("-fPIC"), los vínculos prefieren bibliotecas PIC compiladas previamente en lugar de bibliotecas que no son PIC y producen ejecutables independientes de la posición ("-pie").
Etiquetas: loading_and_analysis y affects_outputs
Se acumulan --host_action_env=<a 'name=value' assignment with an optional value part> usos múltiples
Especifica el conjunto de variables de entorno disponibles para acciones con configuraciones de ejecución. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o por el par nombre=valor que establece el valor de forma independiente del entorno de invocación. Esta opción se puede usar varias veces. en el caso de opciones proporcionadas para la misma variable, se acumulan las últimas victorias y se acumulan opciones para diferentes variables.
Etiquetas: action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt> predeterminado: "opt"
Especifica el modo en que se integrarán las herramientas usadas durante la compilación. Valores: “fastbuild”, “dbg”, “opt”.
Etiquetas: affects_outputs y action_command_lines
Se acumulan --host_conlyopt=<a string> usos múltiples
Es una opción adicional para pasar al compilador C cuando se compilan archivos de origen C (pero no C++) en las configuraciones de ejecución.
Etiquetas: action_command_lines y affects_outputs
Se acumulan --host_copt=<a string> usos múltiples
Opciones adicionales para pasar al compilador C para herramientas integradas en las configuraciones de ejecución.
Etiquetas: action_command_lines y affects_outputs
Valor predeterminado de --host_cpu=<a string>: ""
La CPU host
Etiquetas: changes_inputs y affects_outputs
Se acumulan --host_cxxopt=<a string> usos múltiples
Opciones adicionales para pasar al compilador C++ en el caso de las herramientas integradas en las configuraciones de ejecución.
Etiquetas: action_command_lines y affects_outputs
Se acumulan --host_features=<a string> usos múltiples
Las funciones determinadas estarán habilitadas o inhabilitadas de forma predeterminada para los destinos compilados en la configuración de ejecución. Especificando -<feature> la inhabilitará. Los atributos negativos siempre anulan los positivos.
Etiquetas: changes_inputs y affects_outputs
Valor predeterminado de --host_force_python=<PY2 or PY3>: ver descripción
Anula la versión de Python para la configuración de ejecución. Puede ser "PY2". o “PY3”.
Etiquetas: loading_and_analysis y affects_outputs
Se acumulan --host_linkopt=<a string> usos múltiples
Es una opción adicional para pasar al vinculador cuando se vinculan herramientas en las configuraciones de ejecución.
Etiquetas: action_command_lines y affects_outputs
Valor predeterminado de --host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ver descripción
Versión mínima de macOS compatible para los destinos de host. Si no se especifica, usa "macos_sdk_version".
Etiquetas: loses_incremental_state
Se acumulan --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> usos múltiples
Opciones adicionales para pasar de forma selectiva al compilador C/C++ cuando compilas ciertos archivos en las configuraciones de ejecución. Esta opción se puede aprobar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter significa una lista de patrones de inclusión y exclusión de expresiones regulares (consulta también --instrumentation_filter). opción_1 a option_n significa opciones arbitrarias de la línea de comandos. Si una opción contiene una coma, se debe colocar entre una barra 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 gcc de todos los archivos cc en //foo/, excepto bar.cc.
Etiquetas: action_command_lines y affects_outputs
Se acumulan --host_swiftcopt=<a string> usos múltiples
Opciones adicionales para pasar a swiftc para herramientas de ejecución.
Etiquetas: action_command_lines y affects_outputs
Valor predeterminado de --[no]incompatible_auto_exec_groups: "falso"
Cuando se habilita, se crea automáticamente un grupo de ejecución para cada cadena de herramientas que usa una regla. Para que esta regla funcione, se debe especificar el parámetro `toolchain` en sus acciones. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/17134.
Etiquetas: affects_outputs y incompatible_change
Valor predeterminado de --[no]incompatible_merge_genfiles_directory: "true"
Si es verdadero, el directorio genfiles se pliega en el directorio bin.
Etiquetas: affects_outputs y incompatible_change
Valor predeterminado de --[no]incompatible_use_host_features: "true"
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 y incompatible_change
Valor predeterminado de --[no]instrument_test_targets: "falso"
Cuando la cobertura está habilitada, especifica si se deben considerar reglas de prueba. Cuando se establecen, 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> predeterminado: "-/javatests[/:],-/test/java[/:]"
Cuando se habilite la cobertura, solo se instrumentarán las reglas con nombres incluidos por el filtro basado en regex especificado. Reglas con el prefijo “-” en su lugar. 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
Valor predeterminado de --ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ver descripción
Versión de iOS mínima compatible para simuladores y dispositivos de destino. Si no se especifica, usa "ios_sdk_version".
Etiquetas: loses_incremental_state
Se acumulan --ios_multi_cpus=<comma-separated list of options> usos múltiples
Lista separada por comas de arquitecturas con las que se compilará una aplicación ios_application. El resultado es un objeto binario universal que contiene todas las arquitecturas especificadas.
Etiquetas: loses_incremental_state y loading_and_analysis
Valor predeterminado de --[no]legacy_whole_archive: "true"
Obsoleto y sustituido por --incompatible_remove_legacy_whole_archive (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener más información). Cuando esta opción esté activada, usa --whole-archive para las reglas cc_binary que tengan 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 y deprecated
Se acumulan --linkopt=<a string> usos múltiples
Es una opción adicional para pasar a gcc durante la vinculación.
Etiquetas: action_command_lines y affects_outputs
Se acumulan --ltobackendopt=<a string> usos múltiples
Es una opción adicional para pasar al paso del backend de LTO (en --features=thin_lto).
Etiquetas: action_command_lines y affects_outputs
Se acumulan --ltoindexopt=<a string> usos múltiples
Es una opción adicional para pasar al paso de indexación de LTO (en --features=thin_lto).
Etiquetas: action_command_lines y affects_outputs
Se acumulan --macos_cpus=<comma-separated list of options> usos múltiples
Lista de arquitecturas separadas por comas para las que se compilarán objetos binarios de Apple macOS.
Etiquetas: loses_incremental_state y loading_and_analysis
Valor predeterminado de --macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ver descripción
Versión mínima de macOS compatible para destinos. Si no se especifica, usa "macos_sdk_version".
Etiquetas: loses_incremental_state
Valor predeterminado de --memprof_profile=<a build target label>: ver descripción
Usar perfil de memprof.
Etiquetas: affects_outputs
Valor predeterminado de --[no]objc_debug_with_GLIBCXX: "falso"
Si se establece y el modo de compilación está establecido en "dbg", define GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC y GLIBCPP_CONCEPT_CHECKS.
Etiquetas: action_command_lines
Valor predeterminado de --[no]objc_enable_binary_stripping: "falso"
Indica si se deben realizar eliminaciones de símbolos y de código no muerto en objetos binarios vinculados. Se realizarán eliminaciones de objetos binarios si se especifican esta marca y --compilation_mode=opt.
Etiquetas: action_command_lines
Se acumulan --objccopt=<a string> usos múltiples
Opciones adicionales para pasar a gcc cuando se compilan archivos de origen Objective-C/C++.
Etiquetas: action_command_lines
Se acumulan --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> usos múltiples
Opciones adicionales para pasar a gcc de forma selectiva cuando se compilan ciertos archivos. Esta opción se puede aprobar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter significa una lista de patrones de inclusión y exclusión de expresiones regulares (consulta también --instrumentation_filter). opción_1 a option_n significa opciones arbitrarias de la línea de comandos. Si una opción contiene una coma, se debe colocar entre una barra 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 gcc de todos los archivos cc en //foo/, excepto bar.cc.
Etiquetas: action_command_lines y affects_outputs
Se acumulan --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> usos múltiples
Opciones adicionales para pasar de forma selectiva al backend de LTO (en --features=thin_lto) cuando se compilan ciertos objetos de backend. Esta opción se puede aprobar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter significa una lista de patrones de incluir y excluir expresiones regulares. opción_1 a option_n significa opciones arbitrarias de la línea de comandos. Si una opción contiene una coma, se debe colocar entre una barra 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 LTO de todos los archivos o en //foo/ excepto bar.o.
Etiquetas: action_command_lines y affects_outputs
Valor predeterminado de --platform_suffix=<a string>: ver descripción
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas: loses_incremental_state, affects_outputs y loading_and_analysis
Valor predeterminado de --propeller_optimize=<a build target label>: ver descripción
Usa la información del perfil de Propeller para optimizar el objetivo de la compilación.Un perfil de propeller debe constar de al menos uno de dos archivos, un perfil cc y un perfil ld. Esta marca acepta una etiqueta de compilación que debe hacer referencia a los archivos de entrada del perfil del propeler. Por ejemplo, el archivo COMPILAR 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 export_files al paquete correspondiente para que estos archivos sean visibles para Bazel. La opción debe usarse como: --propeller_optimize=//a/b:propeller_profile
Etiquetas: action_command_lines y affects_outputs
Valor predeterminado de --propeller_optimize_absolute_cc_profile=<a string>: ver descripción
Nombre de la ruta de acceso absoluta del archivo cc_profile para compilaciones de Propeller Optimized.
Etiquetas: affects_outputs
Valor predeterminado de --propeller_optimize_absolute_ld_profile=<a string>: ver descripción
Nombre de la ruta de acceso absoluta del archivo ld_profile para compilaciones de Propeller Optimized.
Etiquetas: affects_outputs
Valor predeterminado de --run_under=<a prefix in front of command>: ver descripción
Prefijo para insertar antes de los ejecutables para la “prueba” y "ejecutar" con comandos de SQL sencillos. Si el valor es “foo -bar” y la línea de comandos de ejecución es “test_binary -baz”, la última línea de comandos es “foo -bar test_binary -baz”. También puede ser una etiqueta para un destino ejecutable. Estos son algunos ejemplos: 'valgrind', 'strace', 'strace -c', 'valgrind --quiet --num-callers=20', '//package:target', '//package:target --options'.
Etiquetas: action_command_lines
Valor predeterminado de --[no]share_native_deps: "true"
Si es verdadero, las bibliotecas nativas que contengan una funcionalidad idéntica se compartirán entre diferentes destinos
Etiquetas: loading_and_analysis y affects_outputs
Valor predeterminado de --[no]stamp: "falso"
Sella objetos binarios con la fecha, el nombre de usuario, el nombre de host, la información del espacio de trabajo, etcétera.
Etiquetas: affects_outputs
--strip=<always, sometimes or never> predeterminado: “a veces”
Especifica si se deben eliminar los objetos binarios y las bibliotecas compartidas (mediante "-Wl,--strip-debug"). El valor predeterminado de “A veces” significa quitar iff --compilation_mode=fastbuild.
Etiquetas: affects_outputs
Se acumulan --stripopt=<a string> usos múltiples
Opciones adicionales para pasar a la barra cuando se genera un archivo '<name>.stripped' binario.
Etiquetas: action_command_lines y affects_outputs
Se acumulan --swiftcopt=<a string> usos múltiples
Opciones adicionales para pasar a la compilación de Swift.
Etiquetas: action_command_lines
Se acumulan --tvos_cpus=<comma-separated list of options> usos múltiples
Lista de arquitecturas separadas por comas para las que se compilarán objetos binarios de tvOS de Apple.
Etiquetas: loses_incremental_state y loading_and_analysis
Valor predeterminado de --tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ver descripción
Versión mínima de tvOS compatible para dispositivos y simuladores de destino. Si no se especifica, usa "tvos_sdk_version".
Etiquetas: loses_incremental_state
Se acumulan --visionos_cpus=<comma-separated list of options> usos múltiples
Lista separada por comas de arquitecturas para las que se compilarán objetos binarios de visionOS de Apple.
Etiquetas: loses_incremental_state y loading_and_analysis
Se acumulan --watchos_cpus=<comma-separated list of options> usos múltiples
Lista de arquitecturas separadas por comas para compilar objetos binarios de watchOS de Apple.
Etiquetas: loses_incremental_state y loading_and_analysis
Valor predeterminado de --watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ver descripción
Versión mínima de watchOS compatible con simuladores y dispositivos de destino. Si no se especifica, usa “watchos_sdk_version”.
Etiquetas: loses_incremental_state
Valor predeterminado de --xbinary_fdo=<a build target label>: ver descripción
Usa la información de perfil de XbinaryFDO para optimizar la compilación. Especifica el nombre del perfil de multibinario predeterminado. Cuando la opción se usa junto con --fdo_instrument/--fdo_optimize/--fdo_profile, esas opciones siempre prevalecerán como si nunca se especificara xbinary_fdo.
Etiquetas: affects_outputs
.
Opciones que afectan la precisión con la que Bazel aplica 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 grupo de entorno que se usará para asignar automáticamente los valores de la CPU a los valores de target_environment.
Etiquetas: changes_inputs, loading_and_analysis y experimental
Valor predeterminado de --[no]check_licenses: "falso"
Verifica que las restricciones de licencias impuestas por los paquetes dependientes no entren en conflicto con los modos de distribución de los objetivos que se compilan. De forma predeterminada, las licencias no están marcadas.
Etiquetas: build_file_semantics
Valor predeterminado de --[no]check_visibility: "true"
Si se inhabilita, los errores de visibilidad en las dependencias objetivo descienden a advertencias.
Etiquetas: build_file_semantics
Valor predeterminado de --[no]desugar_for_android: "true"
Establece si se debe expandir el código de bytes de Java 8 antes de la conversión a DEX.
Etiquetas: affects_outputs, loading_and_analysis y loses_incremental_state
Valor predeterminado de --[no]desugar_java8_libs: "falso"
Especifica si se deben incluir bibliotecas de Java 8 compatibles en las apps para dispositivos heredados.
Etiquetas: affects_outputs, loading_and_analysis, loses_incremental_state y experimental
Valor predeterminado de --[no]enforce_constraints: "true"
Verifica los entornos con los que cada destino es compatible y, luego, informa los errores si alguno de ellos tiene dependencias que no admiten los mismos entornos.
Etiquetas: build_file_semantics
Valor predeterminado de --[no]experimental_check_desugar_deps: "true"
Establece si se debe verificar la expansión de sintaxis correcta a nivel del objeto binario de Android.
Etiquetas: eagerness_to_exit, loading_and_analysis y experimental
Configuración predeterminada de --experimental_import_deps_checking=<off, warning or error>: "DESACTIVADA"
Cuando se habilita, se verifica si las dependencias de aar_import están completas. Esta aplicación puede romper la compilación o generar advertencias.
Etiquetas: loading_and_analysis
Valor predeterminado de --experimental_strict_java_deps=<off, warn, error, strict or default>: “predeterminado”
Si es verdadero, comprueba que un destino de Java declare de manera explícita todos los objetivos usados directamente como dependencias.
Etiquetas: build_file_semantics y eagerness_to_exit
Valor predeterminado de --[no]incompatible_check_testonly_for_output_files: "falso"
Si se habilita, comprueba los objetivos de prerrequisito de solo prueba que son archivos de salida buscando solo la prueba de la regla que se genera. Esto coincide con la verificación de visibilidad.
Etiquetas: build_file_semantics y incompatible_change
Valor predeterminado de --[no]incompatible_check_visibility_for_toolchains: "falso"
Si se habilita, la verificación de visibilidad también se aplica a las implementaciones de cadenas de herramientas.
Etiquetas: build_file_semantics y incompatible_change
Valor predeterminado de --[no]incompatible_disable_native_android_rules: "falso"
Si se habilita esta opción, se inhabilitará el uso directo de las reglas nativas de Android. Usa las reglas de Starlark para Android que se encuentran en https://github.com/bazelbuild/rules_android
Etiquetas: eagerness_to_exit y incompatible_change
Valor predeterminado de --[no]incompatible_disable_native_apple_binary_rule: "falso"
No-ops. Se guardan aquí para brindar retrocompatibilidad.
Etiquetas: eagerness_to_exit y incompatible_change
Valor predeterminado de --[no]incompatible_python_disable_py2: "true"
Si es verdadero, usar la configuración de Python 2 generará un error. Esto incluye python_version=PY2, srcs_version=PY2 y srcs_version=PY2ONLY. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/15684.
Etiquetas: loading_and_analysis y incompatible_change
Valor predeterminado de --[no]incompatible_validate_top_level_header_inclusions: "true"
Si es verdadero, Bazel también validará las inclusiones de encabezados de directorio de nivel superior (consulta https://github.com/bazelbuild/bazel/issues/10047 para obtener más información).
Etiquetas: loading_and_analysis y incompatible_change
Valor predeterminado de --python_native_rules_allowlist=<a build target label>: ver descripción
Una lista de entidades permitidas (destino del grupo de productos) que se usará cuando se aplique --incompatible_python_Disallow_native_rules.
Etiquetas: loading_and_analysis
Valor predeterminado de --[no]strict_filesets: "falso"
Si se habilita esta opción, los conjuntos de archivos que cruzan los límites de paquetes se informan como errores.
Etiquetas: build_file_semantics y eagerness_to_exit
Valor predeterminado de --strict_proto_deps=<off, warn, error, strict or default>: "error"
A menos que esté DESACTIVADA, comprueba que un destino proto_library declare de forma explícita todos los objetivos usados directamente como dependencias.
Etiquetas: build_file_semantics, eagerness_to_exit y incompatible_change
Configuración predeterminada de --strict_public_imports=<off, warn, error, strict or default>: "desactivada"
A menos que esté DESACTIVADA, comprueba que un objetivo proto_library declare de forma explícita todos los destinos usados en el campo "import public" como se exportó.
Etiquetas: build_file_semantics, eagerness_to_exit y incompatible_change
Valor predeterminado de --[no]strict_system_includes: "falso"
Si es verdadero, también se deben declarar los encabezados que se encuentran en el sistema incluyen rutas de acceso (-isystem).
Etiquetas: loading_and_analysis y eagerness_to_exit
Se acumulan --target_environment=<a build target label> usos múltiples
Declara el entorno de destino de esta compilación. Debe ser una referencia de etiqueta a un "entorno" . Si se especifica, todos los objetivos de nivel superior deben ser compatibles con este entorno.
Etiquetas: changes_inputs
.
Opciones que afectan los resultados de firma de una compilación:
--apk_signing_method=<v1, v2, v1_v2 or v4> predeterminado: “v1_v2”
Implementación para firmar APKs
Etiquetas: action_command_lines, affects_outputs y loading_and_analysis
Valor predeterminado de --[no]device_debug_entitlements: "true"
Si se configura y el modo de compilación no es "opt", las apps objc incluirán derechos de depuración cuando firmen.
Etiquetas: changes_inputs
Valor predeterminado de --ios_signing_cert_name=<a string>: ver descripción
Nombre del certificado que se usará para la firma de iOS. De lo contrario, se recurrirá al perfil de aprovisionamiento. Puede ser la preferencia de identidad del llavero del certificado o (subcadena) del nombre común del certificado, según la página del manual del símbolo de código (IDENTIDADES DE FIRMA).
Etiquetas: action_command_lines
.
Esta opción afecta la semántica del lenguaje de Starlark o de la API de compilación a la que pueden acceder los archivos BUILD, los archivos .bzl o los archivos WORKSPACE:
Valor predeterminado de --[no]incompatible_disallow_legacy_py_provider: "true"
No-op; se quitará pronto.
Etiquetas: loading_and_analysis y incompatible_change
Valor predeterminado de --[no]incompatible_disallow_sdk_frameworks_attributes: "falso"
Si esta preferencia se establece como verdadera, no permite los atributos sdk_frameworks y bad_sdk_frameworks en objc_library y objc_import.
Etiquetas: build_file_semantics y incompatible_change
Si es verdadero, establece como verdadero el valor predeterminado para los atributos Alwayslink en objc_library y objc_import.
Etiquetas: build_file_semantics y incompatible_change
Valor predeterminado de --[no]incompatible_python_disallow_native_rules: "falso"
Si es verdadero, se produce un error cuando se usan las reglas py_* integradas. en su lugar, se deben usar las reglas rule_python. Consulta https://github.com/bazelbuild/bazel/issues/17773 para obtener más información y las instrucciones de migración.
Etiquetas: loading_and_analysis y incompatible_change
Opciones que determinan el comportamiento del entorno de pruebas o del ejecutor de pruebas:
Valor predeterminado de --[no]allow_analysis_failures: "falso"
Si es verdadero, una falla de análisis del destino de una regla da como resultado la propagación del destino de una instancia de AnalysisFailureInfo que contiene la descripción del error, en lugar de generar una falla de compilación.
Etiquetas: loading_and_analysis y experimental
Valor predeterminado de --analysis_testing_deps_limit=<an integer>: "2000"
Establece el número máximo de dependencias transitivas mediante un atributo de regla con una transición de configuración for_analysis_testing. Si superas este límite, se producirá un error de regla.
Etiquetas: loading_and_analysis
Valor predeterminado de --[no]break_build_on_parallel_dex2oat_failure: "falso"
Si las verdaderas fallas de acción de dex2oat harán que la compilación se rompa en lugar de ejecutar dex2oat durante el tiempo de ejecución de la prueba.
Etiquetas: loading_and_analysis y experimental
Valor predeterminado de --[no]experimental_android_use_parallel_dex2oat: "falso"
Usa dex2oat en paralelo para acelerar la ejecución de android_test.
Etiquetas: loading_and_analysis, host_machine_resource_optimizations y experimental
Valor predeterminado de --[no]ios_memleaks: "falso"
Habilitar la verificación de fugas de memoria en los destinos de ios_test.
Etiquetas: action_command_lines
Valor predeterminado de --ios_simulator_device=<a string>: ver descripción
El dispositivo que se debe simular cuando se ejecuta una aplicación para iOS en el simulador, p.ej., "iPhone 6". Ejecuta “xcrun simctl list devicetypes” para obtener una lista de dispositivos. de la máquina en la que se ejecutará el simulador.
Etiquetas: test_runner
Valor predeterminado de --ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ver descripción
Es la versión de iOS que se ejecuta en el simulador durante la ejecución o las pruebas. Esto se ignora para las reglas ios_test si se especifica un dispositivo de destino en la regla.
Etiquetas: test_runner
Se acumulan --runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once> usos múltiples
Especifica la cantidad de veces que se debe ejecutar cada prueba. Si alguno de esos intentos falla por cualquier motivo, toda la prueba se considera fallida. Por lo general, 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. En el ejemplo anterior, ejecuta_per_prueba significa 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 aprobar varias veces. El argumento que se pasó más recientemente y que coincida tiene prioridad. Si no hay coincidencias, la prueba se ejecutará solo una vez.
Se acumulan --test_env=<a 'name=value' assignment with an optional value part> usos múltiples
Especifica las variables de entorno adicionales que se insertarán en el entorno del ejecutor de pruebas. Las variables pueden especificarse por nombre, en cuyo caso su valor se leerá desde el entorno de cliente de Bazel o por el par nombre=valor. Esta opción se puede usar varias veces para especificar muchas variables. Solo lo usa la "prueba de Bazel". kubectl.
Etiquetas: test_runner
Valor predeterminado de --test_timeout=<a single integer or comma-separated list of 4 integers>: "-1"
Anula los valores predeterminados del tiempo de espera de la prueba (en segundos). Si se especifica un valor entero positivo único, se anularán todas las categorías. Si se especifican 4 números enteros separados por comas, se anularán los tiempos de espera de corto, moderado, largo y eterno (en ese orden). En cualquier caso, el valor -1 indica al blaze que use los tiempos de espera predeterminados para esa categoría.
Valor predeterminado de --[no]zip_undeclared_test_outputs: "true"
Si es verdadero, los resultados de la prueba que no se declaren se archivarán en un archivo ZIP.
Etiquetas: test_runner
.
Opciones relacionadas con el resultado de la consulta y la semántica:
--aspect_deps=<off, conservative or precise> predeterminado: “conservadora”
Cómo resolver dependencias de aspecto cuando el formato de salida es {xml,proto,record}. "desactivado" significa que no se resuelven dependencias de aspecto, “conservadora” (predeterminado) significa que todas las dependencias de aspecto declaradas se agregan independientemente de si se les da la clase de regla de dependencias directas, “precisa”. significa que solo se agregan los 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. Además, ten en cuenta que incluso el modo preciso no es del todo preciso: la decisión de calcular un aspecto se decide en la fase de análisis, que no se ejecuta durante la “consulta de Bazel”.
Etiquetas: build_file_semantics
Valor predeterminado de --[no]consistent_labels: "falso"
Si se habilita, cada comando de consulta emite etiquetas como si <code>str</code> de Starlark función aplicada a una <code>etiqueta</code> instancia. Esto resulta útil para las herramientas que necesitan hacer coincidir el resultado de diferentes comandos de consulta o etiquetas emitidas por las reglas. Si no se habilita, los formateadores de salida pueden emitir nombres de repositorio aparentes (en relación con el repositorio principal) en lugar de hacer que el resultado sea más legible.
Etiquetas: terminal_output
Valor predeterminado de --[no]graph:factored: "true"
Si es verdadero, el grafo 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> predeterminado: "512"
La longitud máxima de la cadena de etiqueta para un nodo del grafo en el resultado. Las etiquetas más largas se truncarán. -1 significa que no hay truncamiento. Esta opción solo se aplica a --output=graph.
Etiquetas: terminal_output
Valor predeterminado de --[no]implicit_deps: "true"
Si se habilita, las dependencias implícitas se incluirán en el gráfico de dependencias sobre el que opera la consulta. Una dependencia implícita es una que no se especifica de forma explícita en el archivo BUILD, pero la agrega Bazel. En el caso de cquery, esta opción controla el filtrado de cadenas de herramientas resueltas.
Etiquetas: build_file_semantics
Valor predeterminado de --[no]include_artifacts: "true"
Incluye los nombres de las entradas y salidas de las acciones en la salida (posiblemente grandes).
Etiquetas: terminal_output
Valor predeterminado de --[no]include_aspects: "true"
aquery, cquery: Se incluyen acciones generadas por aspectos en el resultado. consulta: no-op (siempre se siguen los aspectos).
Etiquetas: terminal_output
Valor predeterminado de --[no]include_commandline: "true"
Incluye el contenido de las líneas de comandos de acción en el resultado (posiblemente grande).
Etiquetas: terminal_output
Valor predeterminado de --[no]include_file_write_contents: "falso"
Incluye el contenido del archivo para las acciones FileWrite, SourceSymlinkManifest y RepoMappingManifest (posiblemente grandes).
Etiquetas: terminal_output
Valor predeterminado de --[no]include_param_files: "falso"
Incluye el contenido de los archivos de parámetros que se usaron en el comando (posiblemente grandes). Nota: Habilitar esta marca habilitará automáticamente la marca --include_commandline.
Etiquetas: terminal_output
Valor predeterminado de --[no]incompatible_package_group_includes_double_slash: "true"
Si se habilita esta opción, cuando se genere el atributo `packages` de package_group, no se omitirá el `//` inicial.
Etiquetas: terminal_output y incompatible_change
Valor predeterminado de --[no]infer_universe_scope: "falso"
Si no se establece ni --universe_scope, se inferirá un valor de --universe_scope como la lista de patrones de destino únicos en la expresión de consulta. Ten en cuenta que es posible que el valor --universe_scope inferido para una expresión de consulta que usa funciones con alcance universal (p.ej., `allrdeps`) no sea lo que quieres, por lo que debes usar esta opción solo si sabes lo que estás haciendo. Consulta https://bazel.build/reference/query#sky-query para obtener detalles y ejemplos. Si se configura --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
Valor predeterminado de --[no]line_terminator_null: "falso"
Indica si cada formato termina con \0 en lugar de un salto de línea.
Etiquetas: terminal_output
Valor predeterminado de --[no]nodep_deps: "true"
Si está habilitada, las dependencias de “nodep” atributos se incluirán en el gráfico de la dependencia en el que opera la consulta. Un ejemplo común de un “nodep” es “visibilidad”. Ejecuta y analiza el resultado de `info build-language` para conocer todos los “nodep” atributos en el lenguaje de compilación.
Etiquetas: build_file_semantics
--output=<a string> predeterminado: "texto"
El formato en el que se deben imprimir los resultados de BigQuery. Los valores permitidos para aquery son los siguientes: text, textproto, proto, streaming_proto y jsonproto.
Etiquetas: terminal_output
Valor predeterminado de --[no]proto:default_values: "true"
Si es verdadero, se incluirán los atributos cuyo valor no se especifica explícitamente en el archivo BUILD. de lo contrario, se omitirán. Esta opción se aplica a --output=proto
Etiquetas: terminal_output
Valor predeterminado de --[no]proto:definition_stack: "falso"
Propaga el campo de proto definition_stack, que registra la pila de llamadas de Starlark para cada instancia de la regla en el momento en que se definió la clase de la regla.
Etiquetas: terminal_output
Valor predeterminado de --[no]proto:flatten_selects: "true"
Si se habilita, se acoplan los atributos configurables creados por select(). Para los tipos de lista, la representación plana es una lista que contiene cada valor del mapa de selección exactamente una vez. Los tipos escalares se acoplan a nulos.
Etiquetas: build_file_semantics
Valor predeterminado de --[no]proto:include_attribute_source_aspects: "falso"
Propaga el campo de protocolo source_aspect_name de cada atributo con el aspecto de origen del que provino (cadena vacía si no es así).
Etiquetas: terminal_output
Valor predeterminado de --[no]proto:include_synthetic_attribute_hash: "falso"
Indica si se debe calcular y propagar el atributo $internal_attr_hash.
Etiquetas: terminal_output
Valor predeterminado de --[no]proto:instantiation_stack: "falso"
Propaga la pila de llamadas de creación de instancias de cada regla. Ten en cuenta que esto requiere que la pila esté presente
Etiquetas: terminal_output
Valor predeterminado de --[no]proto:locations: "true"
Establece si se debe emitir información de ubicación en el resultado de proto.
Etiquetas: terminal_output
--proto:output_rule_attrs=<comma-separated list of options> predeterminado: "todos"
Lista de atributos separados por comas para incluir en el resultado. La configuración predeterminada es todos los atributos. Se configura como una cadena vacía para no generar ningún atributo. Esta opción se aplica a --output=proto.
Etiquetas: terminal_output
Valor predeterminado de --[no]proto:rule_inputs_and_outputs: "true"
Indica si se deben completar o no 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 desde el archivo que se nombra aquí, en lugar de hacerlo en la línea de comandos. Es un error especificar aquí un archivo así como una consulta de línea de comandos.
Etiquetas: changes_inputs
Valor predeterminado de --[no]relative_locations: "falso"
Si es verdadero, la ubicación de los archivos Build en los resultados xml y proto será relativa. De forma predeterminada, el resultado de la ubicación es una ruta de acceso absoluta y no será coherente en todas las máquinas. Puedes configurar esta opción como verdadera para obtener un resultado coherente en todas las máquinas.
Etiquetas: terminal_output
Valor predeterminado de --[no]skyframe_state: "falso"
Sin realizar un análisis adicional, vuelca el gráfico de acción actual de Skyframe. Nota: Por el momento, no se admite la especificación de un destino con --skyframe_state. Este indicador solo está disponible con --output=proto o --output=textproto.
Etiquetas: terminal_output
Valor predeterminado de --[no]tool_deps: "true"
Consulta: Si está inhabilitada, depende de “exec configuration” no se incluirán en el gráfico de la dependencia en el que opera la consulta. Una “configuración de ejecución” perímetro de dependencia, como el de cualquier "proto_library" al compilador de protocolos, por lo general, apunta a una herramienta ejecutada durante la compilación en lugar de a una parte del mismo “destino” . Cquery: Si se inhabilita, filtra todos los destinos configurados que cruzan una transición de ejecución del objetivo de nivel superior que descubrió este objetivo configurado. Esto significa que, si el destino de nivel superior se encuentra en la configuración de destino, solo se mostrarán los destinos configurados que se encuentren también en esa configuración. Si el destino de nivel superior está en la configuración de ejecución, solo se mostrarán los destinos configurados de ejecución. Esta opción NO excluirá las cadenas de herramientas resueltas.
Etiquetas: build_file_semantics
Valor predeterminado de --universe_scope=<comma-separated list of options>: ""
Un conjunto de patrones de destino separados por comas (aditivos y sustractivos). La consulta puede realizarse en el universo definido por el cierre transitivo de los objetivos especificados. Esta opción se usa para los comandos de consulta y cquery. Para cquery, la entrada de esta opción son los destinos en los que se crean todas las respuestas, por lo que esta opción puede afectar las configuraciones y transiciones. Si no se especifica esta opción, se supone que los objetivos de nivel superior son los objetivos analizados de la expresión de consulta. Nota: Para cquery, no especificar esta opción puede hacer que la compilación se rompa si los objetivos analizados desde la expresión de consulta no se pueden compilar con las opciones de nivel superior.
Etiquetas: loading_and_analysis
.
Opciones que activan optimizaciones del tiempo de compilación:
Valor predeterminado de --[no]experimental_filter_library_jar_with_program_jar: "falso"
Filtra ProgramJar de ProGuard para quitar las clases que también estén presentes en el LibraryJar.
Etiquetas: action_command_lines
Valor predeterminado de --[no]experimental_inmemory_dotd_files: "true"
Si se habilita, los archivos .d de C++ se pasarán a la memoria directamente desde los nodos de compilación remotos en lugar de escribirse en el disco.
Etiquetas: loading_and_analysis, execution, affects_outputs y experimental
Valor predeterminado de --[no]experimental_inmemory_jdeps_files: "true"
Si se habilita, los archivos de dependencia (.jdeps) generados a partir de compilaciones de Java se pasarán a la memoria directamente desde los nodos de compilación remotos en lugar de escribirse en el disco.
Etiquetas: loading_and_analysis, execution, affects_outputs y experimental
Valor predeterminado de --[no]experimental_objc_include_scanning: "falso"
Si se debe realizar, incluye el análisis del objetivo de C/C++.
Etiquetas: loading_and_analysis, execution y changes_inputs
Valor predeterminado de --[no]experimental_retain_test_configuration_across_testonly: "falso"
Cuando se habilita, --trim_test_configuration no recortará la configuración de prueba para las reglas marcadas como testonly=1. El objetivo de esto es reducir los problemas de conflictos 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 y loses_incremental_state
Valor predeterminado de --[no]experimental_starlark_cc_import: "falso"
Si se habilita, se puede usar la versión de Starlark de cc_import.
Etiquetas: loading_and_analysis y experimental
Valor predeterminado de --[no]experimental_unsupported_and_brittle_include_scanning: "falso"
Establece si las entradas se limitan a la compilación C/C++ mediante el análisis de #include líneas de archivos de entrada. Esto puede mejorar el rendimiento y la incrementalidad disminuyendo el tamaño de los árboles de entrada de compilación. Sin embargo, también puede romper compilaciones porque el escáner de inclusión no implementa por completo la semántica del preprocesador de C. En particular, no comprende las directivas dinámicas #include y, también, ignora la lógica condicional del preprocesador. Úsala bajo tu propia responsabilidad. Se cerrarán todos los problemas relacionados con esta marca que se hayan presentado.
Etiquetas: loading_and_analysis, execution y changes_inputs
Valor predeterminado de --[no]incremental_dexing: "true"
Realiza la mayor parte del trabajo para la conversión a DEX por separado para cada archivo jar.
Etiquetas: affects_outputs, loading_and_analysis y loses_incremental_state
Valor predeterminado de --[no]objc_use_dotd_pruning: "true"
Si se configura, los archivos .d emitidos por Clang se usarán para reducir el conjunto de entradas que se pasan a compilaciones objc.
Etiquetas: changes_inputs y loading_and_analysis
Valor predeterminado de --[no]process_headers_in_dependencies: "falso"
Cuando se compila un //a:a de destino, procesa 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
Valor predeterminado de --[no]trim_test_configuration: "true"
Cuando se habilita esta opción, las opciones relacionadas con las pruebas se borran 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 pruebas no harán que las reglas que no son de prueba se vuelvan a analizar.
Etiquetas: loading_and_analysis y loses_incremental_state
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 la 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 la cadena de herramientas y los objetivos específicos para ver cuál depurar. Es posible que varias regex estén separadas con comas y, luego, cada regex se verifique 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 la cadena de herramientas.
Etiquetas: terminal_output
.
Opciones que especifican o modifican una entrada genérica para un comando de Bazel que no se encuentra en otras categorías.
Se acumulan --flag_alias=<a 'name=value' flag alias> usos múltiples
Establece un nombre abreviado para una bandera de Starlark. Toma un solo par clave-valor con el formato "<clave>=<valor>" como argumento.
Etiquetas: changes_inputs
Valor predeterminado de --[no]incompatible_default_to_explicit_init_py: "falso"
Esta marca cambia el comportamiento predeterminado para que los archivos __init__.py ya no se creen automáticamente en los runfiles de los objetivos de Python. De manera precisa, cuando un destino py_binary o py_test tiene legacy_create_init configurado en “auto” (configuración predeterminada), se trata como falsa solo si se configura esta marca. Consulta https://github.com/bazelbuild/bazel/issues/10076.
Etiquetas: affects_outputs y incompatible_change
Valor predeterminado de --[no]incompatible_py2_outputs_are_suffixed: "true"
Si es verdadero, los destinos compilados en la configuración de Python 2 aparecerán en una raíz de salida que incluya 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 symlink de conveniencia "bazel-bin" apuntará a los objetivos de Python 3 en lugar de a Python 2. Si habilitas esta opción, también se recomienda habilitar `--incompatible_py3_is_default`.
Etiquetas: affects_outputs y incompatible_change
Valor predeterminado de --[no]incompatible_py3_is_default: "true"
Si el valor es verdadero, los destinos "py_binary" y "py_test" que no establezcan sus atributos "python_version" (o "default_python_version") pasarán a ser PY3 de forma predeterminada en lugar de PY2. Si configuras esta marca, también se recomienda configurar `--incompatible_py2_outputs_are_suffixed`.
Etiquetas: loading_and_analysis, affects_outputs y incompatible_change
Valor predeterminado de --[no]incompatible_use_python_toolchains: "true"
Si se configura como verdadera, las reglas ejecutables nativas de Python 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 y incompatible_change
Valor predeterminado de --python_version=<PY2 or PY3>: ver descripción
El modo de versión principal de Python, ya sea “PY2” o “PY3”. Ten en cuenta que los objetivos "py_binary" y "py_test" anulan esta opción (incluso si no especifican explícitamente una versión), por lo que no suele haber muchos motivos para proporcionar esta marca.
Etiquetas: loading_and_analysis y affects_outputs
Otras opciones, sin categorizar.
--[no]cache_test_results [-t] predeterminada: "automática"
Si se configura como “auto”, Bazel vuelve a ejecutar una prueba solo en los siguientes casos: (1) Bazel detecta cambios en la prueba o sus dependencias, (2) la prueba se marcó como externa, (3) se solicitaron múltiples ejecuciones de prueba con --runs_per_test o(4) la prueba falló anteriormente. Si se configura en "sí", Bazel almacenará en caché todos los resultados de las pruebas, excepto las marcadas como externas. Si la estableces como "no", Bazel no almacenará en caché ningún resultado de prueba.
Valor predeterminado de --[no]experimental_cancel_concurrent_tests: "falso"
Si esta preferencia se establece como "true", Blaze cancelará las pruebas que se estén ejecutando simultáneamente en la primera ejecución correcta. Esto solo es útil en combinación con --runs_per_test_detects_flakes.
Etiquetas: affects_outputs y loading_and_analysis
Valor predeterminado de --[no]experimental_fetch_all_coverage_outputs: "falso"
Si es verdadero, Bazel recupera todo el directorio de datos de cobertura para cada prueba durante una ejecución de cobertura.
Etiquetas: affects_outputs y loading_and_analysis
Valor predeterminado de --[no]experimental_generate_llvm_lcov: "falso"
Si es verdadero, la cobertura de clang generará un informe de LCOV.
Etiquetas: affects_outputs y loading_and_analysis
Valor predeterminado de --[no]experimental_j2objc_header_map: "true"
Establece si se debe generar un mapa de encabezado de J2ObjC en paralelo a la transpilación de J2ObjC.
Valor predeterminado de --[no]experimental_j2objc_shorter_header_path: "falso"
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 clase reducidas para compilaciones de Java.
Valor predeterminado de --[no]experimental_limit_android_lint_to_android_constrained_java: "falso"
Limita las --experimental_run_android_lint_on_java_rules a bibliotecas compatibles con Android.
Etiquetas: affects_outputs
Valor predeterminado de --[no]experimental_run_android_lint_on_java_rules: "falso"
Establece si se deben validar fuentes java_*.
Etiquetas: affects_outputs
Valor predeterminado de --[no]explicit_java_test_deps: "falso"
Especifica de forma explícita una dependencia para JUnit o Hamcrest en una java_test, en lugar de obtener por error de las dependencias de TestRunner. Por el momento, solo funciona para Bazel.
Valor predeterminado de --host_java_launcher=<a build target label>: ver descripción
El selector de Java que usan las herramientas que se ejecutan durante una compilación.
Se acumulan --host_javacopt=<a string> usos múltiples
Opciones adicionales para pasar a javac cuando se compilan herramientas que se ejecutan durante una compilación.
Se acumulan --host_jvmopt=<a string> usos múltiples
Opciones adicionales para pasar a la VM de Java cuando se compilan herramientas que se ejecutan durante la compilación. Estas se agregarán a las opciones de inicio de la VM de cada destino java_binary.
Valor predeterminado de --[no]incompatible_check_sharding_support: "true"
Si es verdadero, Bazel fallará una prueba fragmentada si el ejecutor de pruebas no indica que admite la fragmentación tocando el archivo en la ruta de acceso en TEST_SHARD_STATUS_FILE. Si es falso, un ejecutor de pruebas que no admite la fragmentación dará lugar a que se ejecuten todas las pruebas en cada fragmento.
Etiquetas: incompatible_change
Valor predeterminado de --[no]incompatible_exclusive_test_sandboxed: "true"
Si es verdadero, las pruebas exclusivas se ejecutarán con la estrategia de zona de pruebas. Agregar “local” etiqueta para forzar una ejecución de prueba exclusiva de forma local
Etiquetas: incompatible_change
Valor predeterminado de --[no]incompatible_strict_action_env: "falso"
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 hacerlo puede evitar el almacenamiento en caché entre usuarios si se usa una caché compartida.
Etiquetas: loading_and_analysis y incompatible_change
Se acumulan --j2objc_translation_flags=<comma-separated list of options> usos múltiples
Opciones adicionales para pasar a la herramienta J2ObjC.
--java_debug
Hace que la máquina virtual Java de una prueba de Java espere una conexión desde un depurador compatible con JDWP (como jdb) antes de comenzar 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
Valor predeterminado de --[no]java_deps: "true"
Genera información de dependencia (por ahora, la ruta de clase del tiempo de compilación) por objetivo de Java.
Valor predeterminado de --[no]java_header_compilation: "true"
Compila ijars directamente desde la fuente.
Valor predeterminado de --java_language_version=<a string>: ""
La versión del lenguaje Java
Valor predeterminado de --java_launcher=<a build target label>: ver descripción
Selector de Java que se usa cuando se compilan objetos binarios de Java. Si esta marca se establece en la cadena vacía, se usa el selector de JDK. El "selector" anula esta marca.
--java_runtime_version=<a string> predeterminado: “local_jdk”
La versión del entorno de ejecución de Java
Se acumulan --javacopt=<a string> usos múltiples
Opciones adicionales para pasar a javac.
Se acumulan --jvmopt=<a string> usos múltiples
Opciones adicionales para pasar a la VM de Java. Estas se agregarán a las opciones de inicio de la VM de cada destino java_binary.
Valor predeterminado de --legacy_main_dex_list_generator=<a build target label>: ver descripción
Especifica un objeto binario que se debe usar para generar la lista de clases que deben estar en el DEX principal al compilar multidex heredado.
Valor predeterminado de --optimizing_dexer=<a build target label>: ver descripción
Especifica el objeto binario que se usará para generar archivos dex sin fragmentación.
Se acumulan --plugin=<a build target label> usos múltiples
Complementos para usar en la compilación. Actualmente funciona con java_plugin.
Valor predeterminado de --proguard_top=<a build target label>: ver descripción
Especifica qué versión de ProGuard se debe usar para la eliminación de código al compilar un objeto binario de Java.
--proto_compiler=<a build target label> predeterminado: “@bazel_tools//tools/proto:protoc”
Es la etiqueta del proto-compiler.
Etiquetas: affects_outputs y loading_and_analysis
--proto_toolchain_for_cc=<a build target label> predeterminado: "@bazel_tools//tools/proto:cc_toolchain"
Etiqueta de proto_lang_toolchain() que describe cómo compilar protos de C++
Etiquetas: affects_outputs y loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label> predeterminado: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"
Etiqueta de proto_lang_toolchain() que describe cómo compilar protos j2objc.
Etiquetas: affects_outputs y loading_and_analysis
--proto_toolchain_for_java=<a build target label> predeterminado: "@bazel_tools//tools/proto:java_toolchain"
Etiqueta de proto_lang_toolchain() que describe cómo compilar protos de Java.
Etiquetas: affects_outputs y loading_and_analysis
--proto_toolchain_for_javalite=<a build target label> predeterminado: "@bazel_tools//tools/proto:javalite_toolchain"
Etiqueta de proto_lang_toolchain() que describe cómo compilar protos de JavaLite.
Etiquetas: affects_outputs y loading_and_analysis
Se acumulan --protocopt=<a string> usos múltiples
Opciones adicionales para pasar al compilador de protobuf.
Etiquetas: affects_outputs
Valor predeterminado de --[no]runs_per_test_detects_flakes: "falso"
Si es verdadero, cualquier fragmento en el que se haya completado al menos una ejecución o un intento y al menos una falla o ejecución tendrá un estado FLAKY.
Valor predeterminado de --shell_executable=<a path>: ver descripción
Ruta de acceso absoluta al shell ejecutable para que lo use Bazel. Si no la estableces, pero la variable de entorno BAZEL_SH está establecida en la primera invocación de Bazel (que inicia un servidor de Bazel), Bazel la usará. Si no se establece ninguna, Bazel usa una ruta de acceso predeterminada hard-coded según el sistema operativo en el que se ejecute (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 es compatible con Bash puede generar fallas de compilación o de tiempo de ejecución de los objetos binarios generados.
Etiquetas: loading_and_analysis
Se acumulan --test_arg=<a string> usos múltiples
Especifica las opciones y los argumentos 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 recibirá argumentos idénticos. Solo lo usa la "prueba de Bazel". kubectl.
Valor predeterminado de --test_filter=<a string>: ver descripción
Especifica un filtro para reenviar al framework de prueba. 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 dejó de estar disponible y no tiene efecto.
Valor predeterminado de --[no]test_runner_fail_fast: "falso"
La opción de reenvíos falla con rapidez al ejecutor de pruebas. El ejecutor de pruebas debe detener la ejecución cuando se produce la primera falla.
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce> predeterminado: "explícito"
Especifica la estrategia para la fragmentación de pruebas: “explícita” solo use la fragmentación si el atributo 'shard_count' El atributo BUILD está presente. 'inhabilitado' nunca usen la fragmentación de pruebas. “forced=k” aplicar “k” fragmentos para realizar pruebas sin importar la variable 'shard_count' Build.
Valor predeterminado de --tool_java_language_version=<a string>: ""
La versión de lenguaje Java que se usa para ejecutar las herramientas necesarias durante una compilación
--tool_java_runtime_version=<a string> predeterminado: "remotejdk_11"
La versión del entorno de ejecución de Java que se usa para ejecutar herramientas durante la compilación
Valor predeterminado de --[no]use_ijars: "true"
Si se habilita, esta opción hace que la compilación de Java use archivos jar de la interfaz. Esto dará como resultado 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 --distdir=<a path> usos múltiples
Lugares adicionales para buscar archivos antes de acceder a la red y descargarlos.
Etiquetas: bazel_internal_configuration
Si se configura, la caché del repositorio vinculará el archivo en lugar de copiarlo en caso de que se produzca un acierto de caché. Esto está diseñado para ahorrar espacio en el disco.
Etiquetas: bazel_internal_configuration
Valor predeterminado de --experimental_repository_downloader_retries=<an integer>: "0"
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> valor 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 esperado por el autor de la regla, sin cambiar el código fuente.
Etiquetas: bazel_internal_configuration y experimental
Valor predeterminado de --http_connector_attempts=<an integer>: "8"
La cantidad máxima de intentos para descargas http.
Etiquetas: bazel_internal_configuration
Valor predeterminado de --http_connector_retry_max_timeout=<An immutable length of time.>: "0s"
El tiempo de espera máximo para los reintentos de descarga de HTTP. Con un valor de 0, no se define ningún tiempo de espera máximo.
Etiquetas: bazel_internal_configuration
--http_timeout_scaling=<a double> valor predeterminado: "1.0"
Escalar todos los tiempos de espera relacionados con las descargas HTTP según el factor determinado
Etiquetas: bazel_internal_configuration
Valor predeterminado de --repository_cache=<a path>: ver descripción
Especifica la ubicación de caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché; de lo contrario, el valor predeterminado es '<output_user_root>/cache/repos/v1'. se usa
Etiquetas: bazel_internal_configuration
Valor predeterminado de --[no]repository_disable_download: "falso"
Si se configura, no se permite la descarga con ctx.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no está completamente inhabilitado. ctx.execute aún podría ejecutar un ejecutable arbitrario que acceda a Internet.
Etiquetas: bazel_internal_configuration
.
Opciones que controlan la ejecución de compilación:
Valor predeterminado de --[no]check_up_to_date: "falso"
No realices la compilación, solo verifica si está actualizada. Si todos los destinos están actualizados, la compilación se completará de forma correcta. Si es necesario ejecutar algún paso, se informa un error y la compilación falla.
Etiquetas: execution
Valor predeterminado de --dynamic_local_execution_delay=<an integer>: "1000"
¿Cuántos milisegundos se deben 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 y host_machine_resource_optimizations
Se acumulan --dynamic_local_strategy=<a '[name=]value1[,..,valueN]' assignment> usos múltiples
Son las estrategias locales que se usarán para el nombre mnemotécnico; se utiliza la primera estrategia aplicable. Por ejemplo, `worker,sandboxed` ejecuta acciones que admiten trabajadores persistentes usando la estrategia de trabajadores, y todas las demás acciones usando la estrategia de zona de pruebas. Si no se proporciona un nombre mnemotécnico, se usa la lista de estrategias como resguardo para todos los mnemotécnicos. La lista de resguardo predeterminada es `worker,sandboxed` o`worker,sandboxed,standalone` si `experimental_local_lockfree_output` está configurada. Utiliza [mnemonic=]local_strategy[,local_strategy,...]
Etiquetas: execution y host_machine_resource_optimizations
Se acumulan --dynamic_remote_strategy=<a '[name=]value1[,..,valueN]' assignment> usos múltiples
Las estrategias remotas, en orden, que se usarán para el nombre mnemotécnico; se utiliza la primera estrategia aplicable. Si no se proporciona un nombre mnemotécnico, se usa la lista de estrategias como resguardo para todos los mnemotécnicos. La lista de resguardo predeterminada es “remote”, por lo que esta marca generalmente no tiene que establecerse de forma explícita. Utiliza [mnemonic=]remote_strategy[,remote_strategy,...]
Etiquetas: execution y 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 de zona de pruebas cuando se usa la estrategia de Docker, y la acción en sí no tiene un atributo de imagen de contenedor en sus propiedades 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
Valor predeterminado de --[no]experimental_docker_use_customized_images: "true"
Si se habilita, inserta el UID y el GID del usuario actual en la imagen de Docker antes de utilizarla. Esto es necesario si la compilación o las 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 si la función de personalización automática de imágenes no funciona en tu caso o si sabes que no la necesitas.
Etiquetas: execution
Valor predeterminado de --[no]experimental_dynamic_exclude_tools: "true"
Cuando se establecen, los objetivos se crean "para la herramienta" no están sujetos a ejecución dinámica. Es muy poco probable que esos objetivos se creen de forma incremental y, por lo tanto, no vale la pena invertir en ciclos locales.
Etiquetas: execution y host_machine_resource_optimizations
Valor predeterminado de --experimental_dynamic_local_load_factor=<a double>: "0"
Controla cuánta carga de la ejecución dinámica debe colocar en la máquina local. Esta marca ajusta la cantidad de acciones de la ejecución dinámica que programaremos de forma simultánea. Se basa en la cantidad de CPU que Blaze cree que está disponible, las cuales pueden controlarse con la marca --local_cpu_resources. Si esta marca es 0, todas las acciones se programan de forma local inmediatamente. Si > 0, la cantidad de acciones programadas localmente está limitada por la cantidad de CPU disponibles. Si < 1, el factor de carga se usa para reducir la cantidad de acciones programadas localmente cuando la cantidad de acciones en espera para programar es alta. Esto disminuye la carga en la máquina local durante el caso de compilación limpia, en el que la máquina local no contribuye mucho.
Etiquetas: execution y host_machine_resource_optimizations
Valor predeterminado de --experimental_dynamic_slow_remote_time=<An immutable length of time.>: "0"
Si es >0, el tiempo en el que una acción ejecutada dinámicamente debe ejecutarse solo de manera 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 función sin supervisar los problemas de ejecución remota.
Etiquetas: execution y host_machine_resource_optimizations
Valor predeterminado de --[no]experimental_enable_docker_sandbox: "falso"
Habilitar la zona de pruebas basada en Docker Esta opción no tiene efecto si Docker no está instalado.
Etiquetas: execution
Valor predeterminado de --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">: "4"
Si el valor es 0, borra los árboles de la zona de pruebas en cuanto se complete una acción (lo que hará que se retrase la finalización de la acción). Si es mayor que cero, ejecuta la eliminación de esos tres en un grupo de subprocesos asíncrono que tenga un tamaño de 1 cuando la compilación se esté ejecutando y aumente al tamaño especificado por esta marca cuando el servidor esté inactivo.
Etiquetas: host_machine_resource_optimizations y execution
Valor predeterminado de --experimental_sandbox_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>: "0"
Si > 0, cada zona de pruebas de Linux se limitará a la cantidad determinada de memoria (en MB). Requiere cgroups v1 o v2 y permisos para que los usuarios accedan al directorio de cgroups.
Etiquetas: execution
Valor predeterminado de --[no]experimental_shrink_worker_pool: "falso"
Si se habilita, es posible que se reduzca el grupo de trabajadores si la presión de su memoria es alta. Esta marca solo funciona cuando está habilitada la marca experimental_total_worker_memory_limit_mb.
Etiquetas: execution y host_machine_resource_optimizations
Valor predeterminado de --[no]experimental_split_xml_generation: "true"
Si se establece esta marca y una acción de prueba no genera un archivo test.xml, Bazel usa una acción independiente para generar un archivo test.xml de prueba que contiene el registro de pruebas. De lo contrario, Bazel genera un archivo test.xml como parte de la acción de prueba.
Etiquetas: execution
Valor predeterminado de --experimental_total_worker_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>: "0"
Si este límite es superior a cero trabajadores inactivos, se podrían finalizar si el uso total de memoria de todos los trabajadores supera el límite.
Etiquetas: execution y host_machine_resource_optimizations
Valor predeterminado de --[no]experimental_use_hermetic_linux_sandbox: "falso"
Si se configura como verdadera, no actives la raíz, solo activa lo que se proporciona con sandbox_add_mount_pair. Los archivos de entrada tendrán un vínculo duro a la zona de pruebas en lugar de un symlink a él desde la zona de pruebas. Si los archivos de entrada de acciones se encuentran en un sistema de archivos diferente al de la zona de pruebas, se copiarán los archivos de entrada.
Etiquetas: execution
Valor predeterminado de --[no]experimental_use_semaphore_for_jobs: "falso"
Si se configura como verdadero, además, usa el semáforo para limitar la cantidad de trabajos simultáneos.
Etiquetas: host_machine_resource_optimizations y execution
Valor predeterminado de --[no]experimental_use_windows_sandbox: "falso"
Usa la zona de pruebas de Windows para ejecutar acciones. Si es "Sí", el objeto 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.
Etiquetas: execution
--experimental_windows_sandbox_path=<a string> predeterminado: "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 el nombre es vacío, usa el primer objeto binario con ese nombre que se encuentra en la ruta de acceso.
Etiquetas: execution
Valor predeterminado de --experimental_worker_allowlist=<comma-separated set of options>: ver descripción
Si no está vacío, solo permite el uso de trabajadores persistentes con el nombre nemotécnico de la clave de trabajador especificada.
Etiquetas: execution y host_machine_resource_optimizations
Valor predeterminado de --[no]experimental_worker_as_resource: "true"
No-op; se quitará pronto.
Etiquetas: no_op
Valor predeterminado de --[no]experimental_worker_cancellation: "falso"
Si se habilita, Bazel puede enviar solicitudes de cancelación a los trabajadores que las admiten.
Etiquetas: execution
Valor predeterminado de --experimental_worker_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>: "0"
Si este límite es mayor que cero, es posible que se cierren los trabajadores si su uso de memoria supera el límite. Si no se usa junto con la ejecución dinámica y `--experimental_dynamic_ignore_local_signals=9`, es posible que falle tu compilación.
Etiquetas: execution y host_machine_resource_optimizations
Valor predeterminado de --experimental_worker_metrics_poll_interval=<An immutable length of time.>: "5 s"
El intervalo entre la recopilación de métricas de trabajadores y la posible intento de expulsiones. Por motivos de rendimiento, no puede ser inferior a 1 s.
Etiquetas: execution y host_machine_resource_optimizations
Valor predeterminado de --[no]experimental_worker_multiplex_sandboxing: "falso"
Si se habilita esta opción, los trabajadores multiplex se colocarán en una zona de pruebas usando un directorio de zona de pruebas independiente por solicitud de trabajo. Solo los trabajadores que tengan el permiso “supports-multiplex-sandboxing” el requisito de ejecución se someterá a una zona de pruebas.
Etiquetas: execution
Valor predeterminado de --[no]experimental_worker_sandbox_hardening: "falso"
Si se habilita, los trabajadores se ejecutan en una zona de pruebas endurecida, si la implementación lo permite.
Etiquetas: execution
Valor predeterminado de --[no]experimental_worker_strict_flagfiles: "falso"
Si se habilita, los argumentos de acciones para trabajadores que no siguen la especificación del trabajador generarán un error. Los argumentos de trabajador deben tener exactamente un argumento @flagfile como el último de su lista de argumentos.
Etiquetas: execution
Valor predeterminado de --gc_thrashing_threshold=<an integer in 0-100 range>: "100"
El porcentaje del espacio permanente ocupado (0-100) por encima del cual GcThrashingDetector considera eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, GcThrashingDetector está inhabilitado.
Etiquetas: host_machine_resource_optimizations
Valor predeterminado de --genrule_strategy=<comma-separated list of options>: ""
Especifica cómo ejecutar genrules. Esta marca se eliminará gradualmente. En su lugar, usa --spawn_strategy=<value> para controlar todas las acciones o --strategy=Genrule=<value> para que controlen solo las genrules.
Etiquetas: execution
Se acumulan --high_priority_workers=<a string> usos múltiples
No-op; se quitará pronto.
Etiquetas: execution
Si se configura como verdadero y --incompatible_remote_symlinks también es verdadero, los symlinks en las salidas de acción pueden colgar.
Etiquetas: execution y incompatible_change
Si la estableces como verdadera, Bazel representará symlinks en salidas en acción en el protocolo de ejecución/almacenamiento en caché remoto como tal. De lo contrario, se seguirán los symlinks y se representarán como archivos o directorios. Consulta #6631 para obtener más detalles.
Etiquetas: execution y incompatible_change
Valor predeterminado de --[no]incompatible_sandbox_hermetic_tmp: "true"
Si la estableces como verdadera, cada zona de pruebas de Linux tendrá su propio directorio vacío y 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 /tmp del host en todas las zonas de pruebas.
Etiquetas: execution
Valor predeterminado de --[no]internal_spawn_scheduler: "falso"
Opción de marcador de posición para que podamos saber en Blaze si se habilitó el programador de generación.
Etiquetas: execution y 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] predeterminada: "automática"
La cantidad de trabajos simultáneos que se ejecutarán. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de 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. "automático" calcula un valor predeterminado razonable según los recursos del host.
Etiquetas: host_machine_resource_optimizations y execution
--[no]keep_going [-k] predeterminado: "false"
Continúa tanto como sea posible después de un error. Si bien el destino que falló y los que dependen de él no se pueden analizar, otros requisitos previos de estos objetivos pueden serlo.
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: "automático"
Cantidad de subprocesos paralelos que se usarán en la fase de carga/análisis. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5" "automático" establece un valor predeterminado razonable según los recursos del host. Debe ser 1 como mínimo.
Etiquetas: bazel_internal_configuration
Valor predeterminado de --[no]reuse_sandbox_directories: "true"
Si la estableces como verdadera, es posible que se reutilicen los directorios que usa la ejecución que no es de trabajadores en la zona de pruebas para evitar costos de configuración innecesarios.
Etiquetas: host_machine_resource_optimizations y execution
Valor predeterminado de --sandbox_base=<a string>: ""
Permite que la zona de pruebas cree sus directorios de zona de pruebas debajo de esta ruta de acceso. Especifica una ruta de acceso en tmpfs (como /run/shm) para posiblemente mejorar mucho el rendimiento cuando tu compilación o pruebas tengan muchos archivos de entrada. Nota: Necesitas suficiente RAM y espacio libre en el tmpfs para contener archivos intermedios y de salida que se generan con la ejecución de acciones.
Etiquetas: host_machine_resource_optimizations y execution
Valor predeterminado de --[no]sandbox_explicit_pseudoterminal: "falso"
Habilitar de forma explícita la creación de pseudoterminales para las acciones de la zona de pruebas Algunas distribuciones de Linux requieren que se configure el ID de grupo del proceso como “tty”. dentro de la zona de pruebas para que funcionen las pseudoterminales. Si esto está causando problemas, esta marca se puede inhabilitar para habilitar el uso de otros grupos.
Etiquetas: execution
Se acumulan --sandbox_tmpfs_path=<an absolute path> usos múltiples
Para las acciones de zona de pruebas, activa un directorio vacío que admita escritura en esta ruta de acceso absoluta (si la implementación de la zona de pruebas lo admite; de lo contrario, se ignora).
Etiquetas: host_machine_resource_optimizations y execution
Valor predeterminado de --[no]skip_incompatible_explicit_targets: "falso"
Omite los destinos incompatibles que se enumeran explícitamente en la línea de comandos. De forma predeterminada, la compilación de estos destinos genera un error, pero se omiten en silencio cuando esta opción está habilitada. Visita https://bazel.build/extending/platforms#skipping-incompatible-targets
Etiquetas: loading_and_analysis
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 ejecutar la acción. 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 --strategy=<a '[name=]value1[,..,valueN]' assignment> usos múltiples
Especifica cómo distribuir la compilación de otras acciones de generación. 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 ejecutar la acción. El valor predeterminado es “remote,worker,sandboxed,local”. Esta marca anula los valores establecidos por --spawn_strategy (y --genrule_strategy si se usa con Genrule mnemotécnico). Consulta https://blog.bazel.build/2019/06/19/list-strategy.html para obtener más información.
Etiquetas: execution
Se acumulan --strategy_regexp=<a '<RegexFilter>=value[,value]' assignment> usos múltiples
Anula qué estrategia de generación se debe usar para ejecutar acciones de generación que tengan descripciones que coincidan con un determinado regex_filter. Consulta --per_file_copt para obtener detalles sobre la coincidencia de onregex_filter. Se usa el último regex_filter que coincida con la descripción. Esta opción anula otras marcas para especificar la estrategia. Ejemplo: --strategy_regexp=//foo.*\.cc,-//foo/bar=local significa ejecutar 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 configuración "local" pero revertir el pedido lo ejecutaría con “sandboxed”.
Etiquetas: execution
Se acumulan --worker_extra_flag=<a 'name=value' assignment> usos múltiples
Marcas de comandos adicionales que se pasarán a los procesos trabajadores además de --persistent_worker, con clave mnemotécnica (p.ej., --worker_extra_flag=Javac=--debug.
Etiquetas: execution y host_machine_resource_optimizations
Se acumulan --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"> usos múltiples
Cuántas instancias de cada tipo de trabajador persistente se pueden iniciar si utilizas el "trabajador" de administración de amenazas. Se puede especificar como [name=value] para dar un valor diferente por nombre mnemotécnico. El límite se basa en claves de trabajador, que se diferencian según el mnemónico, pero también en las marcas de inicio y el entorno, por lo que, en algunos casos, puede haber más trabajadores por mnemónico que los especificados en esta marca. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5" 'automático' calcula un valor predeterminado razonable según la capacidad de la máquina. “=valor” establece un valor predeterminado para mnemónicos no especificados.
Etiquetas: execution y host_machine_resource_optimizations
Se acumulan --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"> usos múltiples
Cantidad de WorkRequests que puede recibir un proceso de trabajador multiplex en paralelo si usas el "trabajador" con --worker_multiplex. Se puede especificar como [name=value] para dar un valor diferente por nombre mnemotécnico. El límite se basa en claves de trabajador, que se diferencian según el mnemónico, pero también en las marcas de inicio y el entorno, por lo que, en algunos casos, puede haber más trabajadores por mnemónico que los especificados en esta marca. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5" 'automático' calcula un valor predeterminado razonable según la capacidad de la máquina. “=valor” establece un valor predeterminado para mnemónicos no especificados.
Etiquetas: execution y host_machine_resource_optimizations
Valor predeterminado de --[no]worker_multiplex: "true"
Si se habilita, los trabajadores usarán la multiplexación si la admiten.
Etiquetas: execution y host_machine_resource_optimizations
Valor predeterminado de --[no]worker_quit_after_build: "falso"
Si se habilita, todos los trabajadores abandonan después de que se completa una compilación.
Etiquetas: execution y host_machine_resource_optimizations
Valor predeterminado de --[no]worker_sandboxing: "falso"
Si se habilita, los trabajadores se ejecutarán en un entorno de zona de pruebas.
Etiquetas: execution
Valor predeterminado de --[no]worker_verbose: "falso"
Si se habilita esta opción, se imprimen mensajes detallados cuando se inician, apagan los trabajadores...
Opciones que configuran la cadena de herramientas utilizada para la ejecución de la acción:
Valor predeterminado de --target_platform_fallback=<a string>: ""
Esta opción dejó de estar disponible y no tiene efecto.
Etiquetas: affects_outputs, changes_inputs y loading_and_analysis
Opciones que controlan el resultado del comando:
Valor predeterminado de --[no]build: "true"
Ejecuta la compilación. este es el comportamiento habitual. La especificación de --nobuild hace que la compilación se detenga antes de ejecutar las acciones de compilación y muestra cero si las fases de carga del paquete y análisis se completaron correctamente. este modo es útil para probar esas fases.
Etiquetas: execution y affects_outputs
Valor predeterminado de --[no]experimental_use_validation_aspect: "falso"
Establece si se deben ejecutar acciones de validación con aspecto (para el paralelismo con pruebas).
Etiquetas: execution y affects_outputs
Se acumulan --output_groups=<comma-separated list of options> usos múltiples
Una lista de nombres de grupos de salida separados por comas, cada uno de los cuales, de manera opcional, con el prefijo + o -. Se agrega un grupo con el prefijo + al conjunto predeterminado de grupos de salida, mientras que un grupo con el prefijo - se quita 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 crea la unión del conjunto predeterminado, foo y bar, mientras que --output_groups=foo,bar anula el conjunto predeterminado de modo que solo se compilan foo y bar.
Etiquetas: execution y affects_outputs
Valor predeterminado de --[no]run_validations: "true"
Establece si se deben ejecutar acciones de validación como parte de la compilación. Consulta https://bazel.build/extending/rules#validation_actions
Etiquetas: execution y affects_outputs
Opciones que permiten al usuario configurar el resultado previsto y que afectan su valor, en lugar de su existencia:
Se acumulan --aspects=<comma-separated list of options> usos múltiples
Lista separada por comas de los aspectos que se aplicarán a las orientaciones de nivel superior. En la lista, si el aspecto some_aspect especifica los proveedores de aspectos requeridos 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 promocionados satisfacen algunos proveedores de aspectos obligatorios de algunos_aspect. Además, some_aspect se ejecutará después de todos los aspectos obligatorios especificados por el atributo exige. some_aspect tendrá acceso a los valores de esos aspectos proveedores. <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"
Cantidad máxima de archivos abiertos permitidos durante la carga del artefacto de BEP.
Etiquetas: affects_outputs
Esta marca controla cómo se administrarán los symlinks convenientes (los que aparecen en el lugar de trabajo después de la compilación). Valores posibles: normal (predeterminado): Se creará o borrará cada tipo de symlink de conveniencia, según lo determine la compilación. limpio: Todos los symlinks se borrarán incondicionalmente. Ignorar: Los vínculos simbólicos se dejarán solos. log_only: Generar mensajes de registro como si fuera “normal” se pasaron, pero en realidad no realizan ninguna operación del sistema de archivos (útil para las herramientas). Ten en cuenta que solo pueden verse afectados los symlinks cuyos nombres son generados por el valor actual de --symlink_prefix. Si el prefijo cambia, los symlinks preexistentes quedarán solos.
Etiquetas: affects_outputs
Esta marca controla si se publicará o no el evento de compilaciónConvenienceSymlinksIdentified en BuildEventProtocol. Si el valor es verdadero, BuildEventProtocol tendrá una entrada para beneficenciaSymlinksIdentified, que enumerará todos los symlinks convenientes creados en su lugar de trabajo. Si es falso, la entrada minimercadoSymlinksIdentified en BuildEventProtocol estará vacía.
Etiquetas: affects_outputs
--remote_download_all
Descarga todas las salidas remotas en la máquina local. Esta marca es un alias de --remote_download_outputs=all.
Se expande a:
--remote_download_outputs=all

Etiquetas: affects_outputs
--remote_download_minimal
No descarga ningún resultado de compilación remota en la máquina local. Esta marca es un alias de --remote_download_outputs=minimal.
Se expande a:
--remote_download_outputs=minimal

Etiquetas: affects_outputs
--remote_download_outputs=<all, minimal or toplevel> predeterminado: “nivel superior”
Si está establecido en “mínimo” No se descargan resultados de compilación remota en la máquina local, excepto los que requieren las acciones locales. Si se establece como "toplevel" se comporta como “mínimo” excepto que también descarga resultados de objetivos de nivel superior en la máquina local. Ambas opciones pueden reducir de manera significativa los tiempos de compilación si el ancho de banda de la red es un cuello de botella.
Etiquetas: affects_outputs
En lugar de descargar resultados de compilación remotos en la máquina local, crea vínculos simbólicos. El objetivo de los vínculos simbólicos se puede especificar en el formato 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. Estos vínculos simbólicos pueden, por ejemplo, apuntar a un sistema de archivos FUSE que carga objetos desde CAS a pedido.
Etiquetas: affects_outputs
--remote_download_toplevel
Solo descarga las salidas remotas de los objetivos de nivel superior en la máquina local. Esta marca es un alias de --remote_download_outputs=toplevel.
Se expande a:
--remote_download_outputs=toplevel

Etiquetas: affects_outputs
El prefijo que se antepone a cualquiera de los symlinks convenientes 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 symlinks ni se emite ninguna advertencia. Advertencia: la funcionalidad especial para "/" pronto quedarán obsoletas; usa --experimental_convenience_symlinks=ignore en su lugar.
Etiquetas: affects_outputs
.
Opciones que afectan la precisión con la que Bazel aplica entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
Valor predeterminado de --[no]experimental_docker_privileged: "falso"
Si se habilita, Bazel pasará la marca --privileged a 'docker run'. cuando ejecutas acciones. Esto puede ser necesario para tu compilación, pero también podría reducir la hermeticidad.
Etiquetas: execution
No-ops
Etiquetas: host_machine_resource_optimizations y execution
Valor predeterminado de --[no]incompatible_legacy_local_fallback: "falso"
Si se configura como verdadera, habilita el resguardo implícito heredado de la zona de pruebas a la estrategia local. Con el tiempo, esta marca se establecerá como falsa de forma predeterminada y, luego, se convertirá en una no-op. En su lugar, usa --strategy, --spawn_strategy o --dynamic_local_strategy para configurar resguardos.
Etiquetas: execution y incompatible_change
Se acumulan --sandbox_add_mount_pair=<a single path or a 'source:target' pair> usos múltiples
Agrega un par de rutas de acceso adicional para activarlo en la zona de pruebas.
Etiquetas: execution
Se acumulan --sandbox_block_path=<a string> usos múltiples
Para las acciones de la zona de pruebas, inhabilita el acceso a esta ruta de acceso.
Etiquetas: execution
Valor predeterminado de --[no]sandbox_default_allow_network: "true"
Permitir el acceso a la red de forma predeterminada para las acciones Es posible que esto no funcione con todas las implementaciones de la zona de pruebas.
Etiquetas: execution
Valor predeterminado de --[no]sandbox_fake_hostname: "falso"
Cambia el nombre de host actual a “localhost” para las acciones de la zona de pruebas.
Etiquetas: execution
Valor predeterminado de --[no]sandbox_fake_username: "falso"
Cambiar el nombre de usuario actual a "nadie" para las acciones de la zona de pruebas.
Etiquetas: execution
Se acumulan --sandbox_writable_path=<a string> usos múltiples
Para las acciones de zona de pruebas, haz que un directorio existente pueda escribirse 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 de Starlark o de la API de compilación a la que pueden acceder los archivos BUILD, los archivos .bzl o los archivos WORKSPACE:
Valor predeterminado de --[no]incompatible_config_setting_private_default_visibility: "falso"
Si incompatible_enforce_config_setting_visibility=false, es una noop. De lo contrario, si esta marca es falsa, cualquier config_setting sin un atributo de visibilidad explícito será //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 y incompatible_change
Valor predeterminado de --[no]incompatible_enforce_config_setting_visibility: "true"
Si es verdadero, aplica las restricciones de visibilidad config_setting. Si es falso, cada config_setting es visible para cada destino. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas: loading_and_analysis y incompatible_change
Opciones que determinan el comportamiento del entorno de pruebas o del ejecutor de pruebas:
Valor predeterminado de --[no]check_tests_up_to_date: "falso"
No ejecutes pruebas, solo verifica que estén actualizadas. Si todos los resultados de las pruebas están actualizados, estas se completarán de forma correcta. Si es necesario compilar o ejecutar alguna prueba, se informa un error y la prueba falla. Esta opción implica un comportamiento --check_up_to_date.
Etiquetas: execution
Se acumulan --flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once> usos múltiples
Cada prueba se volverá a intentar hasta la cantidad especificada de veces en caso de que falle la prueba. Las pruebas que requerían más de un intento de aprobación se marcan como "FLAKY". en el resumen de la prueba. Normalmente, 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 es "default", solo se realizará un intento de prueba para las pruebas regulares y tres para las que su regla marque explícitamente como inestable (atributo poco confiable). Sintaxis alternativa: regex_filter@flaky_test_attempts. Donde flaky_test_attempts es como se muestra arriba y regex_filter significa una lista de patrones de incluir y excluir expresiones regulares (consulta también --runs_per_test). Ejemplo: --flaky_test_attempts=//foo/.*,-//foo/bar/.*@3 desencripta todas las pruebas en //foo/, excepto las que se encuentran en foo/bar tres veces. Esta opción se puede aprobar varias veces. El argumento que se pasó más recientemente y que coincida tiene prioridad. Si no hay coincidencias, el comportamiento es “predeterminado” arriba.
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: "automático"
La cantidad máxima de trabajos de prueba locales que se ejecutan de forma simultánea. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5" 0 significa que los recursos locales limitarán la cantidad de trabajos de prueba locales que se ejecutarán simultáneamente. Establecer este valor mayor que el valor de --jobs no tiene efecto.
Etiquetas: execution
Valor predeterminado de --[no]test_keep_going: "true"
Cuando se inhabilita, cualquier prueba que no se apruebe 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 usar cuando se ejecutan pruebas.
Etiquetas: execution
Valor predeterminado de --test_tmpdir=<a path>: ver descripción
Especifica el directorio temporal base para la "prueba de Bazel". usar.
Opciones relacionadas con el resultado de la consulta y la semántica:
Valor predeterminado de --[no]experimental_parallel_aquery_output: "true"
No-ops.
Opciones relacionadas con la salida y la semántica de Bzlmod:
Se acumulan --allow_yanked_versions=<a string> usos múltiples
Se especificaron las versiones de los módulos con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resueltas, incluso si se declaran como eliminadas en el registro del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones rechazadas harán que la resolución falle. También puedes definir la versión generada permitida con la variable de entorno `BZLMOD_ALLOW_YANKED_VERSIONS`. Puedes inhabilitar esta verificación con la palabra clave “todo” (no se recomienda).
Etiquetas: loading_and_analysis
Valor predeterminado de --check_bazel_compatibility=<error, warning or off>: "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 caso 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: "advertencia"
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 derivarla a una falla de resolución.
Etiquetas: loading_and_analysis
Valor predeterminado de --[no]ignore_dev_dependency: "falso"
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en 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
Valor predeterminado de --lockfile_mode=<off, update or error>: "actualizar"
Especifica cómo y si se debe usar o no 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 arroja un error si no está actualizado, o "off" para que no se lea ni escriba en el archivo de bloqueo.
Etiquetas: loading_and_analysis
Se acumulan --override_module=<an equals-separated mapping of module name to path> usos múltiples
Anula un módulo con una ruta de acceso local en el formato <module name>=<path>. Si la ruta de acceso dada es una ruta de acceso absoluta, se usará tal como es. Si la ruta de acceso determinada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso dada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace"
Se acumulan --registry=<a string> usos múltiples
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en registros anteriores y solo se recurrirán a los registros posteriores cuando no estén en los registros anteriores.
Etiquetas: changes_inputs
.
Opciones que activan optimizaciones del tiempo de compilación:
Valor predeterminado de --experimental_dynamic_ignore_local_signals=<a comma-separated list of signal numbers>: ver descripción
Toma una lista de los números de las señales del SO. Si se cierra una rama local de ejecución dinámica con cualquiera de estos indicadores, se permitirá que la rama remota finalice en su lugar. Para los trabajadores persistentes, esto solo afecta a las señales que finalizan el proceso trabajador.
Etiquetas: execution
--gc_thrashing_limits=<comma separated pairs of <period>:<count>> predeterminado: "1s:2,20s:3,1m:5"
Límites que, si se alcanzan, hacen que GcThrashingDetector bloquee Bazel con una OOM. Cada límite se especifica como <period>:<count> En el ejemplo anterior, el período es una duración y el recuento es un número entero positivo. Si hay más de --gc_thrashing_threshold por ciento de espacio titular (montón de generación anterior) permanece ocupado después de <count> recolecciones de elementos no utilizados consecutivos en <period>, se activará una OOM. Si hay varios límites, puedes separarlos por comas.
Etiquetas: host_machine_resource_optimizations
Valor predeterminado de --local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>: "HOST_CPUS"
Establece de forma explícita la cantidad total de núcleos de CPU locales disponibles para que Bazel invierta en acciones de compilación ejecutadas de forma local. Toma un número entero o "HOST_CPUS", opcionalmente seguido de [-|*]<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.
Etiquetas: host_machine_resource_optimizations
Se acumulan --local_extra_resources=<a named float, 'name=value'> usos múltiples
Establece la cantidad de recursos adicionales disponibles para Bazel. Toma un par de números de punto flotante de cadena. Se puede usar varias veces para especificar varios tipos de recursos adicionales. Bazel limitará las acciones que se ejecutan en simultáneo en función de los recursos adicionales disponibles y los necesarios. Las pruebas pueden declarar la cantidad de recursos adicionales que necesitan con una etiqueta de “resources:<resoucename>:<amount>”. de un conjunto de datos tengan un formato común. La CPU, la RAM y los recursos disponibles no se pueden configurar con esta marca.
Etiquetas: host_machine_resource_optimizations
--local_ram_resources=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.> valor predeterminado: "HOST_RAM*.67"
Establece de forma explícita la cantidad total de RAM del host local (en MB) disponible para Bazel a fin de invertir en acciones de compilación ejecutadas localmente. Toma un número entero, o "HOST_RAM", opcionalmente seguido de [-|*]<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 utilizará el 67% de esta.
Etiquetas: host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0> predeterminado: “2147483647”
Marca de configuración avanzada del motor interno Skyframe de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de recolección de elementos no utilizados completa, eliminará el estado temporal de Skyframe innecesario, hasta esta cantidad de veces por invocación. La configuración predeterminada es Integer.MAX_VALUE; eficazmente ilimitados. Cero significa que los eventos de recolección de elementos no utilizados completas nunca activarán la acción de soltar. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC completo y se supere ese umbral de porcentaje de montón retenido.
Etiquetas: host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0> predeterminado: “2147483647”
Marca de configuración avanzada del motor interno Skyframe de Bazel. Si Bazel detecta que el uso porcentual retenido del montón supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando ocurra un evento menor de recolección de elementos no utilizados, se eliminará el estado temporal de Skyframe innecesario, hasta esta cantidad de veces por invocación. La configuración predeterminada es Integer.MAX_VALUE; eficazmente ilimitados. Cero significa que los eventos menores de recolección de elementos no utilizados nunca activarán la acción de soltar. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC menor y se supere ese umbral de porcentaje de montón retenido.
Etiquetas: host_machine_resource_optimizations
Valor predeterminado de --skyframe_high_water_mark_threshold=<an integer>: "85"
Marca de configuración avanzada del motor interno Skyframe de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es al menos este umbral, descartará el estado temporal de Skyframe innecesario. Ajustar esto puede permitirte mitigar el impacto en el tiempo de la hiperpaginación de GC cuando la hiperpaginación de GC (i) es causada por el uso de memoria de este estado temporal y (ii) es más costosa que reconstituir el estado cuando sea necesario.
Etiquetas: host_machine_resource_optimizations
.
Opciones que afectan la verbosidad, el formato o la ubicación del registro:
Valor predeterminado de --[no]debug_spawn_scheduler: "falso"
Valor predeterminado de --[no]experimental_bep_target_summary: "falso"
Especifica si se publicarán los eventos de TargetSummary.
Valor predeterminado de --[no]experimental_build_event_expand_filesets: "falso"
Si es verdadero, expande los conjuntos de archivos en BEP cuando presentes archivos de salida.
Etiquetas: affects_outputs
Si es verdadero, resuelve por completo los symlinks relativos del conjunto de archivos en el BEP cuando presentes 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"
La cantidad máxima de veces que Bazel debería reintentar subir un evento de compilación.
Etiquetas: bazel_internal_configuration
Valor predeterminado de --experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>: "1s"
Es el retraso mínimo inicial para los reintentos de retirada exponencial cuando falla la carga de BEP. (exponente: 1.6)
Etiquetas: bazel_internal_configuration
Valor predeterminado de --experimental_build_event_upload_strategy=<a string>: ver 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
Valor predeterminado de --[no]experimental_collect_local_sandbox_action_metrics: "true"
No-op dejó de estar disponible.
Etiquetas: execution
Valor predeterminado de --[no]experimental_command_profile: "falso"
Registra un perfil de CPU de la grabadora de vuelos de Java en un archivo profile.jfr en el directorio base de salida. La sintaxis y la semántica de esta marca podrían cambiar en el futuro para admitir diferentes tipos de perfil o formatos de salida. usar bajo tu propia responsabilidad.
Valor predeterminado de --[no]experimental_docker_verbose: "falso"
Si se habilita, Bazel imprimirá mensajes más detallados sobre la estrategia de la zona de pruebas de Docker.
Etiquetas: execution
Valor predeterminado de --[no]experimental_materialize_param_files_directly: "falso"
Si materializas archivos de parámetros, hazlo con escrituras directas en el disco.
Etiquetas: execution
Valor predeterminado de --[no]experimental_record_metrics_for_all_mnemonics: "falso"
De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemónicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán las estadísticas de todos los mnemónicos.
Valor predeterminado de --experimental_repository_resolved_file=<a string>: ""
Si no está vacío, escriba un valor de Starlark con la información resuelta de todas las reglas del repositorio de Starlark que se ejecutaron.
Etiquetas: affects_outputs
Valor predeterminado de --[no]experimental_run_bep_event_include_residue: "falso"
Indica si se debe incluir el residue de línea de comandos en eventos de compilación en ejecución que podrían contener el residue. De forma predeterminada, el residue no se incluye en los eventos de compilación de comandos de ejecución que podrían contener el residue.
Etiquetas: affects_outputs
Valor predeterminado de --[no]experimental_stream_log_file_uploads: "falso"
Transmite las cargas de archivos de registro directamente al almacenamiento remoto en lugar de escribirlas en el disco.
Etiquetas: affects_outputs
Valor predeterminado de --explain=<a path>: ver 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
Valor predeterminado de --[no]ignore_unsupported_sandboxing: "falso"
No imprimir una advertencia cuando este sistema no admita la ejecución de la zona de pruebas.
Etiquetas: terminal_output
Valor predeterminado de --[no]legacy_important_outputs: "true"
Úsalo para suprimir la generación del campo relevant_outputs heredado en el evento TargetComplete. importantes_outputs son obligatorios para la integración de Bazel a ResultStore.
Etiquetas: affects_outputs
Valor predeterminado de --[no]materialize_param_files: "falso"
Escribe archivos de parámetros intermedios en el árbol de salida, incluso cuando se usa la ejecución de acción remota. Es útil para depurar acciones. Esto está implícito en --subcomandos y --verbose_failures.
Etiquetas: execution
Valor predeterminado de --max_config_changes_to_show=<an integer>: "3"
Cuando se descarta la caché de análisis debido a un cambio en las opciones de compilación, se muestra hasta la cantidad determinada de nombres de opciones modificados. 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 puede emitirse cuando --test_output es “errores” o "todos". Es útil para evitar sobrecargar la salida con resultados de prueba demasiado ruidosos. El encabezado de la prueba se incluye en el tamaño del registro. Los valores negativos implican que no hay límite. La salida es todo o nada.
Etiquetas: test_runner, terminal_output y execution
Valor predeterminado de --output_filter=<a valid Java regular expression>: ver descripción
Solo muestra advertencias y resultados de acciones para reglas cuyo nombre coincida con la expresión regular proporcionada.
Etiquetas: affects_outputs
Valor predeterminado de --progress_report_interval=<an integer in 0-3600 range>: "0"
La cantidad de segundos que se debe esperar entre informes sobre 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 30 segundos y, después de ese tiempo, se informará una vez por minuto. Cuando se habilita --maldiciones, el progreso se informa cada segundo.
Etiquetas: affects_outputs
Valor predeterminado de --remote_print_execution_messages=<failure, success or all>: "error"
Elige cuándo imprimir los mensajes de ejecución remota. Los valores válidos son `failure` (error), para imprimir solo en caso de errores, "success" para imprimir solo en caso de éxito y "all" para imprimir siempre.
Etiquetas: terminal_output
Valor predeterminado de --[no]sandbox_debug: "falso"
Habilita las funciones de depuración para la función de zona de pruebas. Esto incluye dos cosas: primero, el contenido raíz de la zona de pruebas no se modifica después de una compilación. Segundo, imprime información de depuración adicional en la ejecución. Esto puede ayudar a los desarrolladores de reglas de Bazel o Starlark con fallas de depuración debido a archivos de entrada faltantes, etcétera.
Etiquetas: terminal_output
Valor predeterminado de --show_result=<an integer>: "1"
Muestra los resultados de la compilación. Para cada destino, indica si se actualizó y, de ser así, una lista de los archivos de salida que se compilaron. Los archivos impresos son cadenas convenientes que se pueden copiar y pegar en la shell para ejecutarlos. Esta opción requiere un argumento de número entero, que es el número de umbral de objetivos por encima del cual no se imprime la información del resultado. Por lo tanto, cero provoca la supresión del mensaje y MAX_INT hace que siempre se imprima el resultado. El valor predeterminado es uno. Si no se compiló nada para un objetivo, se pueden omitir sus resultados a fin de mantener los resultados por debajo del umbral.
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 en un formato compatible con las 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 mostrar solo el resumen del estado de prueba, para imprimir registros de prueba de las pruebas fallidas, "all" para imprimir registros de todas las pruebas y "transmitidos" para generar registros para todas las pruebas en tiempo real (esto forzará la ejecución local de las pruebas, una a la vez, independientemente del valor de --test_strategy)
Etiquetas: test_runner, terminal_output y execution
Valor predeterminado de --test_summary=<short, terse, detailed, none or testcase>: “short”
Especifica el formato deseado para el resumen de la prueba. Los valores válidos son "short" para imprimir solo información sobre las pruebas ejecutadas, "terse", para imprimir información sobre las pruebas no exitosas que se hayan ejecutado, "detalladas" para imprimir información detallada sobre casos de prueba fallidos, “testcase” para imprimir el resumen en la resolución de casos de prueba, no imprimir información detallada sobre los casos de prueba fallidos y “ninguno” para omitir el resumen.
Etiquetas: terminal_output
Valor predeterminado de --[no]verbose_explanations: "falso"
Aumenta la verbosidad de las explicaciones emitidas si --explain está habilitada. No tiene efecto si --explain no está habilitada.
Etiquetas: affects_outputs
Valor predeterminado de --[no]verbose_failures: "falso"
Si un comando falla, muestra la línea de comandos completa.
Etiquetas: terminal_output
.
Opciones que especifican o modifican una entrada genérica para un comando de Bazel que no se encuentra en otras categorías.
Se acumulan --aspects_parameters=<a 'name=value' assignment> usos múltiples
Especifica los valores de los parámetros de aspectos de la línea de comandos. Cada valor del parámetro se especifica mediante <param_name>=<param_value>, por ejemplo, 'my_param=my_val' en el que “my_param” es un parámetro de algún aspecto en la lista de --aspects o requerido por un aspecto de 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 nombrado aquí, en lugar de hacerlo en la línea de comandos. Es un error especificar un archivo aquí, al igual que patrones de la línea de comandos.
Etiquetas: changes_inputs
.
Opciones de ejecución y almacenamiento en caché remoto:
Valor predeterminado de --experimental_circuit_breaker_strategy=<failure>: ver descripción
Especifica la estrategia que usará el disyuntor. Las estrategias disponibles son “fallas”. Si el valor de la opción no es válido, no se establece el mismo comportamiento que la opción.
Etiquetas: execution
Valor predeterminado de --experimental_downloader_config=<a string>: ver descripción
Especifica un archivo con el que se configurará el cargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguidas de un nombre de host (para "allow" y "block") o dos patrones, uno para buscar coincidencias y otro para usar como URL sustituta, con referencias inversas a partir de `$1`. Es posible proporcionar varias directivas "rewrite" para la misma URL; en este caso, se devolverán varias URL.
Valor predeterminado de --[no]experimental_guard_against_concurrent_changes: "falso"
Desactiva esta opción para inhabilitar la verificación del tiempo de los archivos de entrada de una acción antes de subirla a una caché remota. Puede haber casos en los que el kernel de Linux retrase la escritura de archivos, lo que podría provocar falsos positivos.
Valor predeterminado de --[no]experimental_remote_cache_async: "falso"
Si es verdadero, la E/S de la caché remota ocurrirá en segundo plano, en lugar de ocurrir como parte de un generador.
Valor predeterminado de --experimental_remote_cache_eviction_retries=<an integer>: "0"
La cantidad máxima de intentos para reintentar si la compilación encontró un error de expulsión de caché remota. Un valor distinto de cero establecerá implícitamente --incompatible_remote_use_new_exit_code_for_lost_inputs como true. Se generará un nuevo ID de invocación para cada intento. Si generas el ID de invocación y se lo proporcionas a Bazel con --invocation_id, no debes usar esta marca. En su lugar, configura la marca --incompatible_remote_use_new_exit_code_for_lost_inputs y verifica el código de salida 39.
Etiquetas: execution
Valor predeterminado de --[no]experimental_remote_cache_lease_extension: "falso"
Si se configura como verdadero, Bazel extenderá la asignación de tiempo para los resultados de las acciones remotas durante la compilación enviando llamadas a `FindMissingBlobs` de forma periódica a la caché remota. La frecuencia se basa en el valor de `--experimental_remote_cache_ttl`.
--experimental_remote_cache_ttl=<An immutable length of time.> valor predeterminado: "3h"
El TTL mínimo garantizado de los BLOB en la caché remota después de que se hace referencia recientemente a sus resúmenes, p.ej., por un ActionResult o FindMissingBlobs. Bazel realiza varias optimizaciones basadas en la información de los BLOB. TTL, p.ej., no llama repetidamente a GetActionResult en una compilación incremental. El valor debe establecerse un poco menor que el TTL real, ya que hay un espacio entre el momento en que el servidor muestra los resúmenes y el momento en que Bazel los recibe.
Etiquetas: execution
Valor predeterminado de --experimental_remote_capture_corrupted_outputs=<a path>: ver descripción
Una ruta de acceso a un directorio en el que se capturarán los resultados dañados.
Valor predeterminado de --[no]experimental_remote_discard_merkle_trees: "falso"
Si se configura como verdadera, descarta las copias en la memoria del árbol Merkle de la raíz de entrada y las asignaciones de entradas asociadas durante las llamadas a GetActionResult() y Execute(). Esto reduce significativamente el uso de memoria, pero requiere que Bazel vuelva a procesarlos ante errores y reintentos de caché remota.
Valor predeterminado de --experimental_remote_downloader=<a string>: ver descripción
Un URI de extremo de la API de Remote Asset, que se usará como proxy de descarga remota. Los esquemas compatibles son gRPC, grpcs (grpc con TLS habilitado) y Unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel usará grpcs de forma predeterminada. Visita https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto.
Valor predeterminado de --[no]experimental_remote_downloader_local_fallback: "falso"
Indica si se debe recurrir a la descarga local en caso de que falle la descarga remota.
Valor predeterminado de --[no]experimental_remote_execution_keepalive: "falso"
Indica si se debe usar keepalive para llamadas de ejecución remota.
Valor predeterminado de --experimental_remote_failure_rate_threshold=<an integer in 0-100 range>: "10"
Establece la cantidad permitida de tasa de fallas en porcentaje para un período específico, después del cual se deja de llamar a la caché o al ejecutor remoto. De forma predeterminada, el valor es 10. Si se establece en 0, no hay limitación.
Etiquetas: execution
--experimental_remote_failure_window_interval=<An immutable length of time.> valor predeterminado: "60 s"
El intervalo en el que se calcula la tasa de fallas de las solicitudes remotas. Con un valor de cero o negativo, la duración de la falla se calcula por toda la duración de 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
Valor predeterminado de --[no]experimental_remote_mark_tool_inputs: "falso"
Si la estableces como verdadera, Bazel marcará las entradas como entradas de herramientas para el ejecutor remoto. Puede usarse para implementar trabajadores persistentes remotos.
Valor predeterminado de --[no]experimental_remote_merkle_tree_cache: "falso"
Si se establece como verdadera, los cálculos del árbol de Merkle se memorizarán para mejorar la velocidad de comprobación de aciertos de caché remota. La huella de memoria de la caché se controla mediante --experimental_remote_merkle_tree_cache_size.
Valor predeterminado de --experimental_remote_merkle_tree_cache_size=<a long integer>: "1000"
La cantidad de árboles de Merkle que se deben memorizar para mejorar la velocidad de comprobación de aciertos de caché remota. Aunque la caché se reduce automáticamente según el manejo de referencias suaves de Java, se pueden producir errores por falta de memoria si se configura en 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. La configuración predeterminada es 1,000.
Valor predeterminado de --[no]experimental_remote_require_cached: "falso"
Si se configura como verdadera, establece que todas las acciones que pueden ejecutarse de forma remota se almacenen en caché o que falle la compilación. Esto es útil para solucionar problemas de no determinismo, ya que permite comprobar si las acciones que deben almacenarse en caché realmente se almacenan en caché sin insertar falsamente resultados nuevos en la caché.
Valor predeterminado de --experimental_remote_scrubbing_config=<Converts to a Scrubber>: ver descripción
Habilita el borrado de claves de caché remota con el archivo de configuración suministrado, que debe ser un búfer de protocolo ScrubbingConfig en formato de texto. Esta función está diseñada para facilitar el uso compartido de una caché remota o de disco entre acciones que se ejecutan en diferentes plataformas, pero que se orientan a la misma. Se debe utilizar con mucho cuidado, ya que una configuración incorrecta puede provocar que las entradas de la caché se compartan accidentalmente y dar como resultado compilaciones incorrectas. La limpieza no afecta la forma en que se ejecuta una acción, solo la manera en que se calcula su clave de caché remota o de disco con el fin de recuperar o almacenar un resultado de acción. No se puede usar junto con la ejecución remota. Modificar la configuración de depuración no invalida los resultados presentes en el sistema de archivos local o en las memorias caché internas. se requiere una compilación limpia para volver a ejecutar las acciones afectadas. Para usar correctamente esta función, es recomendable que configures --host_platform junto con --experimental_platform_in_output_dir (para normalizar los prefijos de salida) y --incompatible_strict_action_env (para normalizar las variables de entorno).
Configuración predeterminada de --experimental_worker_for_repo_fetching=<off, platform or virtual>: "desactivada"
El modo de subprocesos que se usará para la recuperación del repositorio. Si se configura en “off”, no se usa ningún subproceso de trabajo y la recuperación del repositorio está sujeta a reinicios. De lo contrario, utiliza un subproceso de plataforma (es decir, un subproceso del SO) si está configurado como "platform". o un subproceso virtual si está configurado como “virtual”.
Valor predeterminado de --[no]incompatible_remote_build_event_upload_respect_no_cache: "falso"
Obsoleto. No-ops. En su lugar, usa --remote_build_event_upload=minimal.
Valor predeterminado de --[no]incompatible_remote_downloader_send_all_headers: "true"
Establece si se deben enviar todos los valores de un encabezado con valores múltiples al cargador remoto en lugar de solo al primero.
Etiquetas: incompatible_change
Valor predeterminado de --[no]incompatible_remote_output_paths_relative_to_input_root: "falso"
Si se configura como verdadera, las rutas de salida son relativas a la raíz de entrada en lugar del directorio de trabajo.
Etiquetas: incompatible_change
Valor predeterminado de --[no]incompatible_remote_results_ignore_disk: "true"
No-ops
Etiquetas: incompatible_change
Valor predeterminado de --[no]incompatible_remote_use_new_exit_code_for_lost_inputs: "true"
Si la estableces como verdadera, Bazel usará el nuevo código de salida 39, en lugar de 34, si la caché remota expulsa los BLOB durante la compilación.
Etiquetas: incompatible_change
Valor predeterminado de --[no]remote_accept_cached: "true"
Indica si se deben aceptar los resultados de acciones almacenados en caché de forma remota.
Valor predeterminado de --remote_build_event_upload=<all or minimal>: “mínimo”
Si se configura como “all”, todas las salidas locales a las que hace referencia BEP se suben a la caché remota. Si se configura como “mínimo”, las salidas locales a las que hace referencia BEP no se suben a la caché remota, excepto los archivos que son importantes para los consumidores de BEP (p.ej., los registros de prueba y el perfil de tiempo). El esquema bytestream:// siempre se usa para el URI de los archivos, incluso si faltan en la caché remota. La configuración predeterminada es "minimal".
Valor predeterminado de --remote_bytestream_uri_prefix=<a string>: ver descripción
El nombre de host y el nombre de la instancia que se usarán en los URI bytestream:// que se escriben en transmisiones 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 con el nombre canónico del servicio de ejecución remota. Si no la estableces, se establecerá la configuración predeterminada como "${hostname}/${instance_name}".
Valor predeterminado de --remote_cache=<a string>: ver descripción
Un URI de un extremo de almacenamiento en caché. Los esquemas compatibles son http, https, grpc, grpcs (grpc con TLS habilitado) y Unix (sockets UNIX locales), Si no se proporciona un esquema, Bazel usará grpcs de forma predeterminada. Especifica el esquema grpc://, http:// o unix: para inhabilitar TLS. Consulta https://bazel.build/remote/caching
Valor predeterminado de --[no]remote_cache_compression: "falso"
Si se habilita, comprime o descomprime los BLOB de caché con zstd.
Se acumulan --remote_cache_header=<a 'name=value' assignment> usos múltiples
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. Si hay varios valores para el mismo nombre, se convertirán en una lista separada por comas.
Se acumulan --remote_default_exec_properties=<a 'name=value' assignment> usos múltiples
Establece las propiedades de ejecución predeterminadas que se usarán como plataforma de ejecución remota si una plataforma de ejecución aún no configuró exec_properties.
Etiquetas: affects_outputs
Valor predeterminado de --remote_default_platform_properties=<a string>: ""
Establece las propiedades de plataforma predeterminadas que se establecerán para la API de ejecución remota, si la plataforma de ejecución aún no configuró remote_execution_properties. Este valor también se usará si se selecciona la plataforma host como plataforma de ejecución remota.
Se acumulan --remote_download_regex=<a string> usos múltiples
Forzar a Bazel a descargar los artefactos que coincidan con la regexp determinada Se debe usar junto con Build sin los bytes (o el equivalente interno) para permitir que el cliente solicite ciertos artefactos que podrían ser necesarios a nivel local (p.ej., compatibilidad con IDE). Se pueden especificar múltiples regex con la repetición de esta marca.
Etiquetas: affects_outputs
Se acumulan --remote_downloader_header=<a 'name=value' assignment> usos múltiples
Especifica un encabezado que se incluirá en las solicitudes de descargas remotas: --remote_downloader_header=Name=Value. Se pueden pasar varios encabezados especificando la marca varias veces. Si hay varios valores para el mismo nombre, se convertirán en una lista separada por comas.
Se acumulan --remote_exec_header=<a 'name=value' assignment> usos múltiples
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. Si hay varios valores para el mismo nombre, se convertirán en una lista separada por comas.
Valor predeterminado de --remote_execution_priority=<an integer>: "0"
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.
Valor predeterminado de --remote_executor=<a string>: ver descripción
HOST o HOST:PORT de un extremo de ejecución remota. Los esquemas compatibles son gRPC, grpcs (grpc con TLS habilitado) y Unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel usará grpcs de forma predeterminada. Especifica el esquema grpc:// o unix: para inhabilitar TLS.
Valor predeterminado de --remote_grpc_log=<a path>: ver descripción
Si se especifica, una ruta de acceso a un archivo para registrar detalles relacionados con la llamada de gRPC. Este registro consta de una secuencia de protobufs com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry serializados con cada mensaje con prefijo de un varint que denota el tamaño del siguiente mensaje protobuf serializado, como lo realiza el método LogEntry.writeDelimitedTo(OutputStream).
Se acumulan --remote_header=<a 'name=value' assignment> usos múltiples
Especifica un encabezado que se incluirá en las solicitudes: --remote_header=Name=Value. Se pueden pasar varios encabezados especificando la marca varias veces. Si hay varios valores para el mismo nombre, se convertirán en una lista separada por comas.
Valor predeterminado de --remote_instance_name=<a string>: ""
Valor para pasar como instance_name en la API de ejecución remota.
Valor predeterminado de --[no]remote_local_fallback: "falso"
Determina si se debe recurrir a una estrategia de ejecución local independiente si falla la ejecución remota.
Valor predeterminado de --remote_local_fallback_strategy=<a string>: "local"
No-op, obsoleto. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/7480.
Valor predeterminado de --remote_max_connections=<an integer>: "100"
Limita la cantidad máxima de conexiones simultáneas al ejecutor o la caché remotos. De forma predeterminada, el valor es 100. Si se establece en 0, no hay limitación. Para la caché remota HTTP, una conexión TCP podía manejar una solicitud a la vez, por lo que Bazel podría generar hasta --remote_max_connections solicitudes simultáneas. Para el ejecutor o la caché remoto de gRPC, un canal de gRPC, por lo general, podía manejar 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
Valor predeterminado de --remote_proxy=<a string>: ver 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:/path/to/socket).
Valor predeterminado de --remote_result_cache_priority=<an integer>: "0"
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.
Valor predeterminado de --remote_retries=<an integer>: "5"
La cantidad máxima de intentos para reintentar un error transitorio. Si se establece en 0, se inhabilitan los reintentos.
Valor predeterminado de --remote_retry_max_delay=<An immutable length of time.>: "5 s"
El retraso máximo 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.> valor predeterminado: "60 s"
La cantidad máxima de tiempo que se debe esperar la ejecución remota y las llamadas de caché. Para la caché 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.
Valor predeterminado de --[no]remote_upload_local_results: "true"
Establece si se deben subir resultados de acciones ejecutadas de forma local a la caché remota si esta lo admite y si el usuario tiene autorización para hacerlo.
Valor predeterminado de --[no]remote_verify_downloads: "true"
Si la estableces como verdadera, Bazel calculará la suma de hash de todas las descargas remotas y descartará los valores almacenados en caché remotamente si no coinciden con el valor esperado.
Otras opciones, que no se categorizan de ninguna otra manera:
Valor predeterminado de --[no]allow_analysis_cache_discard: "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 se cierre, en lugar de continuar con la compilación. Esta opción no tiene efecto cuando "discard_analysis_cache" también se configura.
Etiquetas: eagerness_to_exit
Valor predeterminado de --auto_output_filter=<none, all, packages or subpackages>: "ninguno"
Si no se especifica --output_filter, entonces el valor de esta opción se usa para crear un filtro automáticamente. Los valores permitidos son "ninguno" (filtrar nada / mostrar todo), 'todo' (filtrar todo / no mostrar nada), 'paquetes' (incluye el resultado de las reglas de los paquetes mencionados en la línea de comandos de Blaze) y los “subpaquetes” (como "paquetes", pero también incluir subpaquetes). Para los 'paquetes' y “subpaquetes” los valores //java/foo y //javatests/foo se tratan como un solo paquete)'.
Valor predeterminado de --[no]build_manual_tests: "falso"
Fuerza los objetivos de prueba etiquetados como "manuales" que se construya. 'manual' se excluyen del procesamiento. Esta opción los obliga a compilarse (pero no a ejecutarse).
Valor predeterminado de --build_tag_filters=<comma-separated list of options>: ""
Especifica una lista de etiquetas separadas por comas. De manera opcional, cada etiqueta puede ir precedida por "-" para especificar etiquetas excluidas. Solo se crearán esos objetivos que contengan al menos una etiqueta incluida y que no contengan ninguna etiqueta excluida. Esta opción no afecta el conjunto de pruebas ejecutadas con el comando "test" comando; se rigen por las opciones de filtro de prueba, por ejemplo, "--test_tag_filters"
Valor predeterminado de --[no]build_tests_only: "falso"
Si se especifica, solo se compilarán las reglas *_test y test_suite y se ignorarán los demás destinos especificados en la línea de comandos. De forma predeterminada, se compilará todo lo que se solicitó.
Valor predeterminado de --combined_report=<none or lcov>: "ninguno"
Especifica el tipo de informe de cobertura acumulativa deseado. En este punto, solo se admite LCOV.
Valor predeterminado de --[no]compile_one_dependency: "falso"
Compila una sola dependencia de los archivos de argumento. Esto es útil para verificar la sintaxis de los archivos de origen en los IDE, por ejemplo, reconstruiendo un único 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 de marca. en lugar de ser objetivos de compilación, sino nombres de archivos de origen. Para cada nombre de archivo de origen, se compilará un destino arbitrario que dependa de él.
Se acumulan --deleted_packages=<comma-separated list of package names> usos múltiples
Una lista separada por comas de los nombres de los paquetes que el sistema de compilación considerará inexistentes, incluso si están visibles en alguna parte de la ruta del paquete. Usa esta opción cuando borres un subpaquete "x/y" de un paquete 'x' existente. Por ejemplo, después de borrar x/y/BUILD en tu cliente, el sistema de compilación puede presentar un reclamo si encuentra la etiqueta “//x:y/z”. si aún lo proporciona otra entrada package_path. Especificar --deleted_packages x/y evita este problema.
Valor predeterminado de --[no]discard_analysis_cache: "falso"
Descarta la caché de análisis inmediatamente después de que se complete la fase de análisis. Reduce el uso de memoria en aproximadamente un 10%, pero ralentiza las compilaciones incrementales adicionales.
Valor predeterminado de --disk_cache=<a path>: ver descripción
Una 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 origen o la etiqueta de la versión en el objeto binario
Valor predeterminado de --execution_log_binary_file=<a path>: ver descripción
Registra los generadores ejecutados en este archivo como protos de generación delimitados, según src/main/protobuf/spawn.proto. Marcas relacionadas: --execution_log_json_file (formato JSON de texto; mutuamente excluyente), --execution_log_sort (si se debe ordenar el registro de ejecución), --subcomandos (para mostrar subcomandos en el resultado de la terminal).
Valor predeterminado de --execution_log_json_file=<a path>: ver descripción
Registra los generadores ejecutados en este archivo como una representación JSON de los protos de Spawn delimitados, según src/main/protobuf/spawn.proto. Marcas relacionadas: --execution_log_binary_file (formato binario protobuf, mutuamente excluyente), --execution_log_sort (si se debe ordenar el registro de ejecución), --subcomandos (para mostrar subcomandos en el resultado de la terminal).
Valor predeterminado de --[no]execution_log_sort: "true"
Establece si se debe ordenar el registro de ejecución, lo que facilita la comparación de registros en las invocaciones. Se configura como falso para evitar un uso potencialmente significativo de CPU y memoria al final de la invocación, a costa de producir el registro en un orden de ejecución no determinista.
Valor predeterminado de --[no]expand_test_suites: "true"
Expandir los objetivos de test_suite a sus pruebas constituyentes antes del análisis Cuando esta marca esté activada (configuración predeterminada), se aplicarán patrones de objetivo negativo a las pruebas que pertenezcan al paquete de pruebas; de lo contrario, no se aplicarán. Desactivar esta marca es útil cuando los aspectos de nivel superior se aplican en la línea de comandos: luego, pueden analizar los objetivos de test_suite.
Etiquetas: loading_and_analysis
Valor predeterminado de --experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>: ""
Obsoleto para dar lugar a aspectos. Filtra el conjunto de objetivos para los que se programarán acciones extra.
Valor predeterminado de --[no]experimental_extra_action_top_level_only: "falso"
Obsoleto para dar lugar a aspectos. Solo programa extra_actions para los objetivos de nivel superior.
--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 complete primero. Si una acción admite trabajadores, la acción local se ejecutará en modo de trabajador persistente. Para habilitar la ejecución dinámica para un nombre mnemotécnico de acción individual, usa las marcas `--internal_spawn_scheduler` y `--strategy=<mnemonic>=dynamic`.
Se expande a:
--internal_spawn_scheduler
--spawn_strategy=dynamic
.
Valor predeterminado de --[no]incompatible_dont_use_javasourceinfoprovider: "falso"
No-ops
Etiquetas: incompatible_change
Valor predeterminado de --local_termination_grace_seconds=<an integer>: "15"
Tiempo de espera entre la finalización de un proceso local debido al tiempo de espera y su cierre forzado.
Se acumulan --override_repository=<an equals-separated mapping of repository name to path> usos múltiples
Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso dada es una ruta de acceso absoluta, se usará tal como es. Si la ruta de acceso determinada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso dada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace"
--package_path=<colon-separated list of options> predeterminado: “%workspace%”
Una lista separada por dos puntos de dónde buscar paquetes Elementos que comienzan con “%workspace%” están relacionadas con el 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”.
Valor predeterminado de --[no]show_loading_progress: "true"
Si se habilita, hace que Bazel imprima el mensaje "Loading package:" (Cargando paquete): mensajes nuevos.
Valor predeterminado de --test_lang_filters=<comma-separated list of options>: ""
Especifica la lista de idiomas de prueba separados por comas. De manera opcional, cada idioma puede ir precedido por "-" 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 de la regla *_test; p.ej., uno de 'cc', 'java', 'py', etc. Esta opción afecta el comportamiento --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 la lista de tamaños de prueba separados por comas. De manera opcional, cada tamaño puede ir precedido por "-" para especificar los tamaños excluidos. Solo se detectarán los objetivos de prueba que contienen, al menos, un tamaño incluido y no contienen tamaños excluidos. Esta opción afecta el comportamiento --build_tests_only y el comando test.
Valor predeterminado de --test_tag_filters=<comma-separated list of options>: ""
Especifica la lista de etiquetas de prueba separadas por comas. De manera opcional, cada etiqueta puede ir precedida por "-" para especificar etiquetas excluidas. Solo se detectarán los objetivos de prueba que contienen al menos una etiqueta incluida y no contienen ninguna etiqueta excluida. Esta opción afecta el comportamiento --build_tests_only y el comando test.
Valor predeterminado de --test_timeout_filters=<comma-separated list of values: short, moderate, long or eternal>: ""
Especifica la lista de tiempos de espera de prueba separados por comas. De manera opcional, cada tiempo de espera puede ir precedido por "-" para especificar tiempos de espera excluidos. Solo se detectarán los objetivos de prueba que contienen al menos un tiempo de espera incluido y no contienen tiempos de espera excluidos. Esta opción afecta el comportamiento --build_tests_only y el comando test.
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 lugar de trabajo en forma de pares clave-valor. Consulta el manual del usuario para ver las especificaciones completas. Consulta también tools/buildstamp/get_workspace_status para ver un ejemplo.
Opciones que controlan la ejecución de compilación:
Valor predeterminado de --[no]check_up_to_date: "falso"
No realices la compilación, solo verifica si está actualizada. Si todos los destinos están actualizados, la compilación se completará de forma correcta. Si es necesario ejecutar algún paso, se informa un error y la compilación falla.
Etiquetas: execution
Especifica si se deben realizar llamadas directas al sistema de archivos para crear árboles de symlinks.
Etiquetas: loading_and_analysis, execution y experimental
Valor predeterminado de --[no]experimental_persistent_aar_extractor: "falso"
Habilita el extractor de aar persistente con trabajadores.
Etiquetas: execution
Valor predeterminado de --[no]experimental_remotable_source_manifests: "falso"
Establece si las acciones del manifiesto de la fuente se pueden usar de forma remota.
Etiquetas: loading_and_analysis, execution y experimental
Valor predeterminado de --[no]experimental_split_coverage_postprocessing: "falso"
Si es verdadero, Bazel ejecutará el procesamiento posterior de cobertura para realizar pruebas en un generación nuevo.
Etiquetas: execution
Valor predeterminado de --[no]experimental_split_xml_generation: "true"
Si se establece esta marca y una acción de prueba no genera un archivo test.xml, Bazel usa una acción independiente para generar un archivo test.xml de prueba que contiene el registro de pruebas. De lo contrario, Bazel genera un archivo test.xml como parte de la acción de prueba.
Etiquetas: execution
Valor predeterminado de --[no]experimental_strict_fileset_output: "falso"
Si se habilita esta opción, los conjuntos de archivos tratarán todos los artefactos de salida como archivos normales. No desviarán directorios ni serán sensibles a los symlinks.
Etiquetas: execution
Valor predeterminado de --[no]experimental_use_semaphore_for_jobs: "falso"
Si se configura como verdadero, además, usa el semáforo para limitar la cantidad de trabajos simultáneos.
Etiquetas: host_machine_resource_optimizations y execution
Valor predeterminado de --genrule_strategy=<comma-separated list of options>: ""
Especifica cómo ejecutar genrules. Esta marca se eliminará gradualmente. En su lugar, usa --spawn_strategy=<value> para controlar todas las acciones o --strategy=Genrule=<value> para que controlen 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] predeterminada: "automática"
La cantidad de trabajos simultáneos que se ejecutarán. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de 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. "automático" calcula un valor predeterminado razonable según los recursos del host.
Etiquetas: host_machine_resource_optimizations y execution
--[no]keep_going [-k] predeterminado: "false"
Continúa tanto como sea posible después de un error. Si bien el destino que falló y los que dependen de él no se pueden analizar, otros requisitos previos de estos objetivos pueden serlo.
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: "automático"
Cantidad de subprocesos paralelos que se usarán en la fase de carga/análisis. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5" "automático" 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 teclas de la información de ejecución de una acción según el nombre nemotécnico 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 regex pueden aplicarse al mismo nombre nemotécnico. Sintaxis: “regex=[+-]key,regex=[+-]key,...”. Ejemplos: '.*=+x,.*=-y,.*=+z' agrega una 'x' y en "z" a y quita "y" de la información de ejecución de todas las acciones. 'Genrule=+requires-x' agrega “requiere-x” a la información de ejecución de todas las acciones de Genrule. “(?!Genrule).*=-required-x” quita “requiere-x” a partir de la información de ejecución para todas las acciones que no son de Genrule.
Etiquetas: execution, affects_outputs y loading_and_analysis
--persistent_android_dex_desugar
Habilita acciones persistentes de dex y expansión de sintaxis de Android mediante trabajadores.
Se expande a:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker

Etiquetas: host_machine_resource_optimizations y execution
--persistent_android_resource_processor
Habilita el procesador de recursos persistente de Android con trabajadores.
Se expande a:
--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

de --strategy=AndroidResourceMerger=worker
de --strategy=AndroidCompiledResourceMerger=worker
de --strategy=ManifestMerger=worker --strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker

de --strategy=AARGenerator=worker
de --strategy=ProcessDatabinding=worker
de --strategy=GenerateDataBindingBaseClasses=worker
Etiquetas: host_machine_resource_optimizations y execution
--persistent_multiplex_android_dex_desugar
Habilita acciones persistentes de dex y desugar de Android multiplexadas usando trabajadores.
Se expande a:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar

Etiquetas: host_machine_resource_optimizations y execution
--persistent_multiplex_android_resource_processor
Habilita el procesador de recursos multiplexados de Android persistente con trabajadores.
Se expande a:
--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

de --modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
de --modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
de --modify_execution_info=ManifestMerger=+supports-multiplex-workers --modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers

de --modify_execution_info=AARGenerator=+supports-multiplex-workers
Etiquetas: host_machine_resource_optimizations y execution
--persistent_multiplex_android_tools
Habilita herramientas de Android persistentes y multiplexadas (dexing, expansión de sintaxis y 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 y execution
Valor predeterminado de --[no]skip_incompatible_explicit_targets: "falso"
Omite los destinos incompatibles que se enumeran explícitamente en la línea de comandos. De forma predeterminada, la compilación de estos destinos genera un error, pero se omiten en silencio cuando esta opción está habilitada. Visita https://bazel.build/extending/platforms#skipping-incompatible-targets
Etiquetas: loading_and_analysis
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 ejecutar la acción. 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 --strategy=<a '[name=]value1[,..,valueN]' assignment> usos múltiples
Especifica cómo distribuir la compilación de otras acciones de generación. 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 ejecutar la acción. El valor predeterminado es “remote,worker,sandboxed,local”. Esta marca anula los valores establecidos por --spawn_strategy (y --genrule_strategy si se usa con Genrule mnemotécnico). Consulta https://blog.bazel.build/2019/06/19/list-strategy.html para obtener más información.
Etiquetas: execution
Se acumulan --strategy_regexp=<a '<RegexFilter>=value[,value]' assignment> usos múltiples
Anula qué estrategia de generación se debe usar para ejecutar acciones de generación que tengan descripciones que coincidan con un determinado regex_filter. Consulta --per_file_copt para obtener detalles sobre la coincidencia de onregex_filter. Se usa el último regex_filter que coincida con la descripción. Esta opción anula otras marcas para especificar la estrategia. Ejemplo: --strategy_regexp=//foo.*\.cc,-//foo/bar=local significa ejecutar 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 configuración "local" pero revertir el pedido lo ejecutaría con “sandboxed”.
Etiquetas: execution
Valor predeterminado de --[no]use_target_platform_for_tests: "falso"
Si es verdadero, Bazel usará la plataforma de destino para ejecutar pruebas en lugar del grupo de ejecución de pruebas.
Etiquetas: execution
.
Opciones que configuran la cadena de herramientas utilizada para la ejecución de la acción:
Valor predeterminado de --android_compiler=<a string>: ver descripción
El compilador de destino de Android.
Etiquetas: affects_outputs, loading_and_analysis y loses_incremental_state
--android_crosstool_top=<a build target label> predeterminado: "//external:android/crosstool"
La ubicación del compilador C++ que se usa para las compilaciones de Android.
Etiquetas: affects_outputs, changes_inputs, loading_and_analysis y loses_incremental_state
Valor predeterminado de --android_grte_top=<a label>: ver descripción
El objetivo de Android grte_top.
Etiquetas: changes_inputs, loading_and_analysis y loses_incremental_state
--android_manifest_merger=<legacy, android or force_android> predeterminado: "android"
Selecciona la combinación de manifiestos que se usará para las reglas android_binary. Marca para ayudar a la transición de la combinación de manifiestos de Android desde la combinación heredada.
Etiquetas: affects_outputs, loading_and_analysis y loses_incremental_state
Valor predeterminado de --android_platforms=<a build target label>: ""
Establece las plataformas que usan los objetivos android_binary. Si se especifican varias plataformas, el objeto binario es un APK multiarquitectura, que contiene binarios nativos para cada plataforma de destino especificada.
Etiquetas: changes_inputs, loading_and_analysis y loses_incremental_state
--android_sdk=<a build target label> predeterminado: "@bazel_tools//tools/android:sdk"
Especifica el SDK o la plataforma de Android que se usa para compilar aplicaciones para Android.
Etiquetas: changes_inputs, loading_and_analysis y loses_incremental_state
--apple_crosstool_top=<a build target label> predeterminado: “@bazel_tools//tools/cpp:toolchain”
La etiqueta del paquete de herramientas cruzadas que se usará en las reglas de Apple y Objc y sus dependencias.
Etiquetas: loses_incremental_state y changes_inputs
Valor predeterminado de --cc_output_directory_tag=<a string>: ""
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas: affects_outputs
Valor predeterminado de --compiler=<a string>: ver descripción
El compilador de C++ que se usará para compilar el destino.
Etiquetas: loading_and_analysis y execution
--coverage_output_generator=<a build target label> predeterminado: "@bazel_tools//tools/test:lcov_merger"
Ubicación del objeto binario que se usa para procesar posteriormente los informes de cobertura sin procesar. Actualmente, debe ser un grupo de archivos que contenga un solo archivo: el objeto binario. La configuración predeterminada es “//tools/test:lcov_merger”.
Etiquetas: changes_inputs, affects_outputs y loading_and_analysis
--coverage_report_generator=<a build target label> predeterminado: “@bazel_tools//tools/test:coverage_report_generator”
Ubicación del objeto binario que se usa para generar informes de cobertura. Actualmente, debe ser un grupo de archivos que contenga un solo archivo: el objeto binario. La configuración predeterminada es “//tools/test:coverage_report_generator”.
Etiquetas: changes_inputs, affects_outputs y loading_and_analysis
--coverage_support=<a build target label> predeterminado: "@bazel_tools//tools/test:coverage_support"
Ubicación de los archivos de compatibilidad que se requieren en las entradas de cada acción de prueba que recopila la cobertura de código. La configuración predeterminada es “//tools/test:coverage_support”.
Etiquetas: changes_inputs, affects_outputs y loading_and_analysis
--crosstool_top=<a build target label> predeterminado: “@bazel_tools//tools/cpp:toolchain”
La etiqueta del paquete de herramientas cruzadas que se usará para compilar el código de C++.
Etiquetas: loading_and_analysis, changes_inputs y affects_outputs
Valor predeterminado de --custom_malloc=<a build target label>: ver descripción
Especifica una implementación de malloc personalizada. Esta configuración anula los atributos malloc en las reglas de compilación.
Etiquetas: changes_inputs y affects_outputs
Se acumulan --experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment> usos múltiples
Lista de expresiones regulares separadas por comas, cada una con el prefijo - (expresión negativa) opcionalmente, asignadas (=) a una lista de objetivos de valores de restricción separados por comas. Si un objetivo no coincide con ninguna expresión negativa y al menos una expresión positiva, la resolución de la cadena de herramientas se realizará como si se hubieran declarado los valores de la 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
Valor predeterminado de --[no]experimental_include_xcode_execution_requirements: "falso"
Si está configurado, agrega un campo "requires-xcode:{version}". de ejecución requerido a cada acción de Xcode. Si la versión de Xcode tiene una etiqueta con guiones, agrega también la etiqueta “requires-xcode-label:{version_label}”. de ejecución.
Etiquetas: loses_incremental_state, loading_and_analysis y execution
Valor predeterminado de --[no]experimental_prefer_mutual_xcode: "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 mutuas disponibles, usa la versión de Xcode local seleccionada a través de xcode-select.
Etiquetas: loses_incremental_state
Valor predeterminado de --extra_execution_platforms=<comma-separated list of options>: ""
Son las plataformas que están 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 declaradas en el archivo WORKSPACE por register_execution_platforms(). Esta opción solo se puede configurar una vez. las instancias posteriores anularán la configuración de las marcas anteriores.
Etiquetas: execution
Se acumulan --extra_toolchains=<comma-separated list of options> usos múltiples
Las reglas de la cadena de herramientas que se deben considerar durante su resolución. Las cadenas de herramientas se pueden especificar por objetivo exacto o como un patrón de objetivo. Estas cadenas de herramientas se considerarán antes de las declaradas en el archivo WORKSPACE por register_toolchains().
Etiquetas: affects_outputs, changes_inputs y loading_and_analysis
Valor predeterminado de --grte_top=<a label>: ver descripción
Es una etiqueta para una biblioteca de libc abierta. La cadena de herramientas de crosstool selecciona el valor predeterminado, y casi nunca necesitas anularlo.
Etiquetas: action_command_lines y affects_outputs
Valor predeterminado de --host_compiler=<a string>: ver descripción
El compilador de C++ que se usará para la compilación del host. Se ignora si no se configura --host_crosstool_top.
Etiquetas: loading_and_analysis y execution
Valor predeterminado de --host_crosstool_top=<a build target label>: ver descripción
De forma predeterminada, las opciones --crosstool_top y --compiler también se usan para la configuración de ejecución. Si se proporciona este indicador, Bazel usa el compilador y la libc predeterminados para el crosstool_top específico.
Etiquetas: loading_and_analysis, changes_inputs y affects_outputs
Valor predeterminado de --host_grte_top=<a label>: ver descripción
Si se especifica, esta configuración anula el directorio de nivel superior de libc (--grte_top) para la configuración de ejecución.
Etiquetas: action_command_lines y affects_outputs
--host_platform=<a build target label> predeterminado: “@local_config_platform//:host”
Es la etiqueta de una regla de la plataforma que describe el sistema host.
Etiquetas: affects_outputs, changes_inputs y loading_and_analysis
Valor predeterminado de --[no]incompatible_dont_enable_host_nonhost_crosstool_features: "true"
Si es verdadero, Bazel no habilitará “host”. y “no host” de la cadena de herramientas de c++ (consulta https://github.com/bazelbuild/bazel/issues/7407 para obtener más información).
Etiquetas: loading_and_analysis y incompatible_change
Valor predeterminado de --[no]incompatible_enable_android_toolchain_resolution: "true"
Usa la resolución de la cadena de herramientas para seleccionar el SDK de Android para las reglas de Android (Starlark y nativo)
Etiquetas: loading_and_analysis y incompatible_change
Valor predeterminado de --[no]incompatible_enable_apple_toolchain_resolution: "falso"
Usa la resolución de la cadena de herramientas para seleccionar el SDK de Apple para las reglas de Apple (Starlark y nativo)
Etiquetas: loading_and_analysis y incompatible_change
Valor predeterminado de --[no]incompatible_make_thinlto_command_lines_standalone: "true"
Si es verdadero, Bazel no reutilizará las líneas de comandos de acción de vínculo de C++ para las líneas de comandos de indexación lto (consulta https://github.com/bazelbuild/bazel/issues/6791 para obtener más información).
Etiquetas: loading_and_analysis y incompatible_change
Valor predeterminado de --[no]incompatible_remove_legacy_whole_archive: "true"
Si es verdadero, Bazel no vinculará las dependencias de bibliotecas como archivos completos de forma predeterminada (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener instrucciones de migración).
Etiquetas: loading_and_analysis y incompatible_change
Valor predeterminado de --[no]incompatible_require_ctx_in_configure_features: "true"
Si el valor es verdadero, Bazel requerirá "{4/}". en cc_common.configure_features (consulta https://github.com/bazelbuild/bazel/issues/7793 para obtener más información).
Etiquetas: loading_and_analysis y incompatible_change
Valor predeterminado de --[no]interface_shared_objects: "true"
Usa objetos compartidos de la interfaz si la cadena de herramientas lo admite. Actualmente, todas las cadenas de herramientas ELF admiten esta configuración.
Etiquetas: loading_and_analysis, affects_outputs y affects_outputs
Valor predeterminado de --ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ver descripción
Especifica la versión del SDK de iOS que se usará para compilar aplicaciones de iOS. Si no se especifica, usa la versión predeterminada del SDK de iOS de “xcode_version”.
Etiquetas: loses_incremental_state
Valor predeterminado de --macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ver descripción
Especifica la versión del SDK de macOS que se usará para compilar aplicaciones de macOS. Si no se especifica, se usa la versión predeterminada del SDK de macOS de “xcode_version”.
Etiquetas: loses_incremental_state
Valor predeterminado de --minimum_os_version=<a string>: ver descripción
La versión mínima del SO a la que se orienta tu compilación.
Etiquetas: loading_and_analysis y affects_outputs
Valor predeterminado de --platform_mappings=<a relative path>: ""
La ubicación de un archivo de asignación que describe qué plataforma usar si no hay ninguna establecida o qué marcas se deben configurar cuando ya existe una plataforma. Debe estar relacionada con la raíz principal del lugar de trabajo. La configuración predeterminada es “platform_mappings”. (un archivo directamente debajo de la raíz del espacio de trabajo).
Etiquetas: affects_outputs, changes_inputs y loading_and_analysis
Valor predeterminado de --platforms=<a build target label>: ""
Las etiquetas de las reglas de la plataforma que describen las plataformas de destino para el comando actual.
Etiquetas: affects_outputs, changes_inputs y loading_and_analysis
Valor predeterminado de --python2_path=<a string>: ver descripción
Obsoleto, no-op. Inhabilitado por `--incompatible_use_python_toolchains`.
Etiquetas: no_op y deprecated
Valor predeterminado de --python3_path=<a string>: ver descripción
Obsoleto, no-op. Inhabilitado por `--incompatible_use_python_toolchains`.
Etiquetas: no_op y deprecated
Valor predeterminado de --python_path=<a string>: ver descripción
La ruta de acceso absoluta del intérprete de Python invocado para ejecutar objetivos de Python en la plataforma de destino. Obsoleto; inhabilitado por --incompatible_use_python_toolchains.
Etiquetas: loading_and_analysis y affects_outputs
Valor predeterminado de --python_top=<a build target label>: ver descripción
Es la etiqueta de un py_runtime que representa el intérprete de Python invocado para ejecutar objetivos de Python en la plataforma de destino. Obsoleto; inhabilitado por --incompatible_use_python_toolchains.
Etiquetas: loading_and_analysis y affects_outputs
Valor predeterminado de --tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ver descripción
Especifica la versión del SDK de tvOS que se usará para compilar aplicaciones de tvOS. Si no se especifica, usa la versión predeterminada del SDK de tvOS de "xcode_version".
Etiquetas: loses_incremental_state
Valor predeterminado de --watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ver descripción
Especifica la versión del SDK de watchOS que se usará para compilar aplicaciones de watchOS. Si no se especifica, se usa la versión predeterminada del SDK de watchOS de “xcode_version”.
Etiquetas: loses_incremental_state
Valor predeterminado de --xcode_version=<a string>: ver descripción
Si se especifica, usa Xcode de la versión determinada para las acciones de compilación relevantes. Si no se especifica, usa la versión predeterminada del ejecutor de Xcode.
Etiquetas: loses_incremental_state
--xcode_version_config=<a build target label> predeterminado: “@bazel_tools//tools/cpp:host_xcodes”
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 y loading_and_analysis
Opciones que controlan el resultado del comando:
Valor predeterminado de --[no]apple_generate_dsym: "falso"
Indica si se deben generar archivos de símbolos de depuración (.dSYM).
Etiquetas: affects_outputs y action_command_lines
Valor predeterminado de --[no]build: "true"
Ejecuta la compilación. este es el comportamiento habitual. La especificación de --nobuild hace que la compilación se detenga antes de ejecutar las acciones de compilación y muestra cero si las fases de carga del paquete y análisis se completaron correctamente. este modo es útil para probar esas fases.
Etiquetas: execution y affects_outputs
Si es verdadero, compila bosques de symlink de archivos de ejecución para todos los destinos. Si es falso, escríbelos solo cuando lo requiera una acción local, prueba o comando de ejecución.
Etiquetas: affects_outputs
Valor predeterminado de --[no]build_runfile_manifests: "true"
Si es verdadero, escribe manifiestos de archivos de ejecución para todos los destinos. Si es falsa, omítelas. Las pruebas locales no se ejecutarán si el valor es falso.
Etiquetas: affects_outputs
Valor predeterminado de --[no]build_test_dwp: "falso"
Si se habilita, al compilar pruebas de C++ de forma estática y con fisión, también se compilará automáticamente el archivo .dwp para el objeto binario de prueba.
Etiquetas: loading_and_analysis y affects_outputs
--cc_proto_library_header_suffixes=<comma-separated set of options> predeterminado: ".pb.h"
Establece los sufijos de los archivos de encabezado que crea cc_proto_library.
Etiquetas: affects_outputs y loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated set of options> predeterminado: ".pb.cc"
Establece los sufijos de los archivos de origen que crea cc_proto_library.
Etiquetas: affects_outputs y loading_and_analysis
Valor predeterminado de --[no]experimental_proto_descriptor_sets_include_source_info: "falso"
Ejecuta acciones adicionales para versiones alternativas de la API de Java en una proto_library.
Etiquetas: affects_outputs, loading_and_analysis y experimental
Valor predeterminado de --[no]experimental_proto_extra_actions: "falso"
Ejecuta acciones adicionales para versiones alternativas de la API de Java en una proto_library.
Etiquetas: affects_outputs, loading_and_analysis y experimental
Valor predeterminado de --[no]experimental_save_feature_state: "falso"
Guarda el estado de las funciones habilitadas y solicitadas como resultado de la compilación.
Etiquetas: affects_outputs y experimental
Valor predeterminado de --[no]experimental_use_validation_aspect: "falso"
Establece si se deben ejecutar acciones de validación con aspecto (para el paralelismo con pruebas).
Etiquetas: execution y affects_outputs
--fission=<a set of compilation modes> predeterminado: "no"
Especifica qué modos de compilación usan la fisión para compilaciones y vínculos de C++. Puede ser cualquier combinación de {'fastbuild', 'dbg', 'opt'} o los valores especiales 'sí' para habilitar todos los modos y hacer clic en "no". para inhabilitar todos los modos.
Etiquetas: loading_and_analysis, action_command_lines y affects_outputs
Valor predeterminado de --[no]incompatible_always_include_files_in_data: "true"
Si esta preferencia se establece como "true", las reglas nativas agregarán <code>DefaultInfo.files</code>. de las dependencias de datos a sus runfiles, lo que coincide con el comportamiento recomendado para las reglas de Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid).
Etiquetas: affects_outputs y incompatible_change
Valor predeterminado de --[no]legacy_external_runfiles: "true"
Si es verdadero, compila bosques de symlink de archivos de ejecución para repositorios externos en .runfiles/wsname/external/repo (además de .runfiles/repo).
Etiquetas: affects_outputs
Valor predeterminado de --[no]objc_generate_linkmap: "falso"
Especifica si se debe generar un archivo de mapa de vínculos.
Etiquetas: affects_outputs
Se acumulan --output_groups=<comma-separated list of options> usos múltiples
Una lista de nombres de grupos de salida separados por comas, cada uno de los cuales, de manera opcional, con el prefijo + o -. Se agrega un grupo con el prefijo + al conjunto predeterminado de grupos de salida, mientras que un grupo con el prefijo - se quita 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 crea la unión del conjunto predeterminado, foo y bar, mientras que --output_groups=foo,bar anula el conjunto predeterminado de modo que solo se compilan foo y bar.
Etiquetas: execution y affects_outputs
Valor predeterminado de --[no]run_validations: "true"
Establece si se deben ejecutar acciones de validación como parte de la compilación. Consulta https://bazel.build/extending/rules#validation_actions
Etiquetas: execution y affects_outputs
Valor predeterminado de --[no]save_temps: "falso"
Si lo estableces, se guardarán los resultados temporales de GCC. Entre estos, se incluyen archivos .s (código ensamblador), .i (C++ previamente procesado) y .ii (C++ previamente procesados).
Etiquetas: affects_outputs
.
Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
Se acumulan --action_env=<a 'name=value' assignment with an optional value part> usos múltiples
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 por el par nombre=valor que establece el valor de forma independiente del entorno de invocación. Esta opción se puede usar varias veces. en el caso de opciones proporcionadas para la misma variable, se acumulan las últimas victorias y se acumulan opciones para diferentes variables.
Etiquetas: action_command_lines
--android_cpu=<a string> predeterminado: "armeabi-v7a"
La CPU de destino de Android
Etiquetas: affects_outputs, loading_and_analysis y loses_incremental_state
Valor predeterminado de --[no]android_databinding_use_androidx: "true"
Genera archivos de vinculación de datos compatibles con AndroidX. Esto solo se usa con la vinculación de datos v2. Esta marca es una no-op.
Etiquetas: affects_outputs, loading_and_analysis, loses_incremental_state y experimental
Valor predeterminado de --[no]android_databinding_use_v3_4_args: "true"
Usa android databinding v2 con el argumento 3.4.0. Esta marca es una no-op.
Etiquetas: affects_outputs, loading_and_analysis, loses_incremental_state y experimental
Configuración predeterminada de --android_dynamic_mode=<off, default or fully>: "desactivada"
Determina si las dependencias de C++ de reglas de Android se vincularán dinámicamente cuando un objeto cc_binary no cree explícitamente una biblioteca compartida. 'predeterminado' significa que Bazel elegirá si realizar la vinculación de forma dinámica. "completamente" significa que todas las bibliotecas se vincularán de forma dinámica. "desactivado" significa que todas las bibliotecas se vincularán en su mayoría en modo estático.
Etiquetas: affects_outputs y loading_and_analysis
Valor predeterminado de --android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>: "alfabético"
Establece el orden de los manifiestos que se pasan a la combinación de manifiestos para los objetos binarios de Android. ALFABÉTICO 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 relacionadas con el directorio de configuración dentro del directorio de salida. DEPENDENCY significa que los manifiestos se ordenan; el de cada biblioteca antecede a los de sus dependencias.
Etiquetas: action_command_lines y execution
Valor predeterminado de --[no]android_resource_shrinking: "falso"
Habilita la reducción de recursos para los APK android_binary que usan ProGuard.
Etiquetas: affects_outputs y loading_and_analysis
Se acumulan --aspects=<comma-separated list of options> usos múltiples
Lista separada por comas de los aspectos que se aplicarán a las orientaciones de nivel superior. En la lista, si el aspecto some_aspect especifica los proveedores de aspectos requeridos 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 promocionados satisfacen algunos proveedores de aspectos obligatorios de algunos_aspect. Además, some_aspect se ejecutará después de todos los aspectos obligatorios especificados por el atributo exige. some_aspect tendrá acceso a los valores de esos aspectos proveedores. <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: "automático"
Compila el archivo ZIP ejecutable de Python; Activado en Windows y desactivado en otras plataformas
Etiquetas: affects_outputs
Se acumulan --catalyst_cpus=<comma-separated list of options> usos múltiples
Lista de arquitecturas separadas por comas para las que se compilarán objetos binarios de Apple Catalyst.
Etiquetas: loses_incremental_state y loading_and_analysis
Valor predeterminado de --[no]collect_code_coverage: "falso"
Si se especifica, Bazel instrumentará el código (usando instrumentación sin conexión cuando sea posible) y recopilará información de cobertura durante las pruebas. Solo se verán afectadas las orientaciones que coincidan con --instrumentation_filter. Por lo general, esta opción no debe especificarse directamente: "cobertura de Bazel". en su lugar.
Etiquetas: affects_outputs
--compilation_mode=<fastbuild, dbg or opt> [-c] predeterminado: "fastbuild"
Especifica el modo en que se compilará el objeto binario. Valores: “fastbuild”, “dbg”, “opt”.
Etiquetas: affects_outputs y action_command_lines
Se acumulan --conlyopt=<a string> usos múltiples
Es una opción adicional para pasar a gcc cuando se compilan archivos de origen C.
Etiquetas: action_command_lines y affects_outputs
Se acumulan --copt=<a string> usos múltiples
Opciones adicionales para pasar a gcc.
Etiquetas: action_command_lines y affects_outputs
Valor predeterminado de --cpu=<a string>: ""
La CPU de destino.
Etiquetas: changes_inputs y affects_outputs
Valor predeterminado de --cs_fdo_absolute_path=<a string>: ver descripción
Usa la información de 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 indexado o sin procesar.
Etiquetas: affects_outputs
Valor predeterminado de --cs_fdo_instrument=<a string>: ver descripción
Genera objetos binarios con instrumentación FDO sensible al contexto. Con el compilador Clang/LLVM, también acepta el nombre del directorio bajo el cual se volcarán los archivos de perfil sin procesar en el tiempo de ejecución.
Etiquetas: affects_outputs
Valor predeterminado de --cs_fdo_profile=<a build target label>: ver descripción
El cs_fdo_profile que representa el perfil sensible al contexto que se usará para la optimización.
Etiquetas: affects_outputs
Se acumulan --cxxopt=<a string> usos múltiples
Es una opción adicional para pasar a gcc cuando se compilan archivos de origen C++.
Etiquetas: action_command_lines y affects_outputs
Se acumulan --define=<a 'name=value' assignment> usos múltiples
Cada opción --define especifica una asignación para una variable de compilación.
Etiquetas: changes_inputs y affects_outputs
Valor predeterminado de --dynamic_mode=<off, default or fully>: “predeterminado”
Determina si se vincularán dinámicamente los objetos binarios de C++. 'predeterminado' significa que Bazel elegirá si realizar la vinculación de forma dinámica. "completamente" significa que todas las bibliotecas se vincularán de forma dinámica. "desactivado" significa que todas las bibliotecas se vincularán en su mayoría en modo estático.
Etiquetas: loading_and_analysis y affects_outputs
Valor predeterminado de --[no]enable_fdo_profile_absolute_path: "true"
Si se configura, el uso de fdo_logical_profile_path generará un error.
Etiquetas: affects_outputs
--[no]enable_runfiles predeterminado: "automático"
Habilitar el árbol de symlink de archivos de ejecución De forma predeterminada, la función está desactivada en Windows y activada en otras plataformas.
Etiquetas: affects_outputs
Se acumulan --experimental_action_listener=<a build target label> usos múltiples
Obsoleto para dar lugar a aspectos. Usa action_listener para adjuntar una extra_action a las acciones de compilación existentes.
Etiquetas: execution y experimental
Valor predeterminado de --[no]experimental_android_compress_java_resources: "falso"
Comprime recursos de Java en los APK
Etiquetas: affects_outputs, loading_and_analysis y experimental
Valor predeterminado de --[no]experimental_android_databinding_v2: "true"
Usa Android Databinding v2. Esta marca es una no-op.
Etiquetas: affects_outputs, loading_and_analysis, loses_incremental_state y experimental
Valor predeterminado de --[no]experimental_android_resource_shrinking: "falso"
Habilita la reducción de recursos para los APK android_binary que usan ProGuard.
Etiquetas: affects_outputs y loading_and_analysis
Valor predeterminado de --[no]experimental_android_rewrite_dexes_with_rex: "falso"
usar la herramienta rex para reescribir archivos dex
Etiquetas: affects_outputs, loading_and_analysis, loses_incremental_state y experimental
Valor predeterminado de --[no]experimental_collect_code_coverage_for_generated_files: "falso"
Si se especifica, Bazel también recopilará información de cobertura para los archivos generados.
Etiquetas: affects_outputs
Esta marca controla cómo se administrarán los symlinks convenientes (los que aparecen en el lugar de trabajo después de la compilación). Valores posibles: normal (predeterminado): Se creará o borrará cada tipo de symlink de conveniencia, según lo determine la compilación. limpio: Todos los symlinks se borrarán incondicionalmente. Ignorar: Los vínculos simbólicos se dejarán solos. log_only: Generar mensajes de registro como si fuera “normal” se pasaron, pero en realidad no realizan ninguna operación del sistema de archivos (útil para las herramientas). Ten en cuenta que solo pueden verse afectados los symlinks cuyos nombres son generados por el valor actual de --symlink_prefix. Si el prefijo cambia, los symlinks preexistentes quedarán solos.
Etiquetas: affects_outputs
Esta marca controla si se publicará o no el evento de compilaciónConvenienceSymlinksIdentified en BuildEventProtocol. Si el valor es verdadero, BuildEventProtocol tendrá una entrada para beneficenciaSymlinksIdentified, que enumerará todos los symlinks convenientes creados en su lugar de trabajo. Si es falso, la entrada minimercadoSymlinksIdentified en BuildEventProtocol estará vacía.
Etiquetas: affects_outputs
--experimental_objc_fastbuild_options=<comma-separated list of options> predeterminado: "-O0,-DDEBUG=1"
Usa estas cadenas como opciones del compilador objc fastbuild.
Etiquetas: action_command_lines
Valor predeterminado de --[no]experimental_omitfp: "falso"
Si es verdadero, usa libunwind para desenrollar la pila y compila con -fomit-frame-pointer y -faasync-unwind-tables.
Etiquetas: action_command_lines, affects_outputs y experimental
Configuración predeterminada de --experimental_output_paths=<off, content or strip>: "desactivada"
Qué modelo usar para dónde en las reglas del árbol de salida se escriben sus resultados, en particular para compilaciones multiplataforma o con varias configuraciones. Esto es altamente experimental. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/6526. Las acciones de Starlark pueden habilitar la asignación de rutas agregando la tecla “supports-path-mapping”. a los requisitos de ejecución dict.
Etiquetas: loses_incremental_state, bazel_internal_configuration, affects_outputs y execution
Se acumulan --experimental_override_name_platform_in_output_dir=<a 'label=value' assignment> usos múltiples
Cada entrada debe tener el formato label=value, en el que la etiqueta hace referencia a una plataforma y los valores es el nombre corto deseado para usar en la ruta de salida. Solo se utiliza cuando --experimental_platform_in_output_dir es verdadero. Tiene la prioridad de nomenclatura más alta.
Etiquetas: affects_outputs y experimental
Valor predeterminado de --[no]experimental_platform_in_output_dir: "falso"
Si es verdadero, se usa un nombre corto para la plataforma de destino en el nombre del directorio de salida en lugar de la CPU. El esquema exacto es experimental y está sujeto a cambios. En primer lugar, en el caso poco probable de que la opción --platforms no tenga exactamente un valor, se utiliza un hash de la opción de plataformas. A continuación, si --experimental_override_name_platform_in_output_dir registró algún nombre corto para la plataforma actual, se utilizará ese nombre corto. Luego, si se configuró --experimental_use_platforms_in_output_dir_legacy_heuristic, use un nombre corto basado en la etiqueta de la plataforma actual. Por último, se usa un hash de la opción de plataforma como último recurso.
Etiquetas: affects_outputs y experimental
Valor predeterminado de --[no]experimental_use_llvm_covmap: "falso"
Si se especifica, Bazel generará información del mapa de cobertura llvm-cov en lugar de gcov cuando collect_code_coverage esté habilitado.
Etiquetas: changes_inputs, affects_outputs, loading_and_analysis y experimental
Valor predeterminado de --[no]experimental_use_platforms_in_output_dir_legacy_heuristic: "true"
Solo usa esta marca como parte de una estrategia de prueba o migración sugerida. Ten en cuenta que la heurística presenta deficiencias conocidas y se sugiere migrar a solo --experimental_override_name_platform_in_output_dir.
Etiquetas: affects_outputs y experimental
--fat_apk_cpu=<comma-separated set of options> predeterminado: "armeabi-v7a"
Configurar esta opción habilita los APK 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 android_binary.
Etiquetas: affects_outputs, loading_and_analysis y loses_incremental_state
Valor predeterminado de --[no]fat_apk_hwasan: "falso"
Establece si se deben crear divisiones de HWASAN.
Etiquetas: affects_outputs, loading_and_analysis y loses_incremental_state
Valor predeterminado de --fdo_instrument=<a string>: ver descripción
Generar objetos binarios con instrumentación FDO Con el compilador Clang/LLVM, también acepta el nombre del directorio bajo el cual se volcarán los archivos de perfil sin procesar en el tiempo de ejecución.
Etiquetas: affects_outputs
Valor predeterminado de --fdo_optimize=<a string>: ver descripción
Usa la información del perfil 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 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 apunten a destinos de `fdo_profile`. Esta marca se reemplazará por la regla `fdo_profile`.
Etiquetas: affects_outputs
Valor predeterminado de --fdo_prefetch_hints=<a build target label>: ver descripción
Usa sugerencias de carga previa de caché.
Etiquetas: affects_outputs
Valor predeterminado de --fdo_profile=<a build target label>: ver descripción
El fdo_profile que representa el perfil que se utilizará para la optimización.
Etiquetas: affects_outputs
Se acumulan --features=<a string> usos múltiples
Las funciones determinadas estarán habilitadas o inhabilitadas de forma predeterminada para los destinos integrados en la configuración de destino. Especificando -<feature> la inhabilitará. Los atributos negativos siempre anulan los positivos. Consulta también --host_features
Etiquetas: changes_inputs y affects_outputs
Valor predeterminado de --[no]force_pic: "falso"
Si se habilitan, todas las compilaciones de C++ producen código independiente de la posición ("-fPIC"), los vínculos prefieren bibliotecas PIC compiladas previamente en lugar de bibliotecas que no son PIC y producen ejecutables independientes de la posición ("-pie").
Etiquetas: loading_and_analysis y affects_outputs
Se acumulan --host_action_env=<a 'name=value' assignment with an optional value part> usos múltiples
Especifica el conjunto de variables de entorno disponibles para acciones con configuraciones de ejecución. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o por el par nombre=valor que establece el valor de forma independiente del entorno de invocación. Esta opción se puede usar varias veces. en el caso de opciones proporcionadas para la misma variable, se acumulan las últimas victorias y se acumulan opciones para diferentes variables.
Etiquetas: action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt> predeterminado: "opt"
Especifica el modo en que se integrarán las herramientas usadas durante la compilación. Valores: “fastbuild”, “dbg”, “opt”.
Etiquetas: affects_outputs y action_command_lines
Se acumulan --host_conlyopt=<a string> usos múltiples
Es una opción adicional para pasar al compilador C cuando se compilan archivos de origen C (pero no C++) en las configuraciones de ejecución.
Etiquetas: action_command_lines y affects_outputs
Se acumulan --host_copt=<a string> usos múltiples
Opciones adicionales para pasar al compilador C para herramientas integradas en las configuraciones de ejecución.
Etiquetas: action_command_lines y affects_outputs
Valor predeterminado de --host_cpu=<a string>: ""
La CPU host
Etiquetas: changes_inputs y affects_outputs
Se acumulan --host_cxxopt=<a string> usos múltiples
Opciones adicionales para pasar al compilador C++ en el caso de las herramientas integradas en las configuraciones de ejecución.
Etiquetas: action_command_lines y affects_outputs
Se acumulan --host_features=<a string> usos múltiples
Las funciones determinadas estarán habilitadas o inhabilitadas de forma predeterminada para los destinos compilados en la configuración de ejecución. Especificando -<feature> la inhabilitará. Los atributos negativos siempre anulan los positivos.
Etiquetas: changes_inputs y affects_outputs
Valor predeterminado de --host_force_python=<PY2 or PY3>: ver descripción
Anula la versión de Python para la configuración de ejecución. Puede ser "PY2". o “PY3”.
Etiquetas: loading_and_analysis y affects_outputs
Se acumulan --host_linkopt=<a string> usos múltiples
Es una opción adicional para pasar al vinculador cuando se vinculan herramientas en las configuraciones de ejecución.
Etiquetas: action_command_lines y affects_outputs
Valor predeterminado de --host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ver descripción
Versión mínima de macOS compatible para los destinos de host. Si no se especifica, usa "macos_sdk_version".
Etiquetas: loses_incremental_state
Se acumulan --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> usos múltiples
Opciones adicionales para pasar de forma selectiva al compilador C/C++ cuando compilas ciertos archivos en las configuraciones de ejecución. Esta opción se puede aprobar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter significa una lista de patrones de inclusión y exclusión de expresiones regulares (consulta también --instrumentation_filter). opción_1 a option_n significa opciones arbitrarias de la línea de comandos. Si una opción contiene una coma, se debe colocar entre una barra 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 gcc de todos los archivos cc en //foo/, excepto bar.cc.
Etiquetas: action_command_lines y affects_outputs
Se acumulan --host_swiftcopt=<a string> usos múltiples
Opciones adicionales para pasar a swiftc para herramientas de ejecución.
Etiquetas: action_command_lines y affects_outputs
Valor predeterminado de --[no]incompatible_auto_exec_groups: "falso"
Cuando se habilita, se crea automáticamente un grupo de ejecución para cada cadena de herramientas que usa una regla. Para que esta regla funcione, se debe especificar el parámetro `toolchain` en sus acciones. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/17134.
Etiquetas: affects_outputs y incompatible_change
Valor predeterminado de --[no]incompatible_merge_genfiles_directory: "true"
Si es verdadero, el directorio genfiles se pliega en el directorio bin.
Etiquetas: affects_outputs y incompatible_change
Valor predeterminado de --[no]incompatible_use_host_features: "true"
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 y incompatible_change
Valor predeterminado de --[no]instrument_test_targets: "falso"
Cuando la cobertura está habilitada, especifica si se deben considerar reglas de prueba. Cuando se establecen, 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> predeterminado: "-/javatests[/:],-/test/java[/:]"
Cuando se habilite la cobertura, solo se instrumentarán las reglas con nombres incluidos por el filtro basado en regex especificado. Reglas con el prefijo “-” en su lugar. 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
Valor predeterminado de --ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ver descripción
Versión de iOS mínima compatible para simuladores y dispositivos de destino. Si no se especifica, usa "ios_sdk_version".
Etiquetas: loses_incremental_state
Se acumulan --ios_multi_cpus=<comma-separated list of options> usos múltiples
Lista separada por comas de arquitecturas con las que se compilará una aplicación ios_application. El resultado es un objeto binario universal que contiene todas las arquitecturas especificadas.
Etiquetas: loses_incremental_state y loading_and_analysis
Valor predeterminado de --[no]legacy_whole_archive: "true"
Obsoleto y sustituido por --incompatible_remove_legacy_whole_archive (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener más información). Cuando esta opción esté activada, usa --whole-archive para las reglas cc_binary que tengan 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 y deprecated
Se acumulan --linkopt=<a string> usos múltiples
Es una opción adicional para pasar a gcc durante la vinculación.
Etiquetas: action_command_lines y affects_outputs
Se acumulan --ltobackendopt=<a string> usos múltiples
Es una opción adicional para pasar al paso del backend de LTO (en --features=thin_lto).
Etiquetas: action_command_lines y affects_outputs
Se acumulan --ltoindexopt=<a string> usos múltiples
Es una opción adicional para pasar al paso de indexación de LTO (en --features=thin_lto).
Etiquetas: action_command_lines y affects_outputs
Se acumulan --macos_cpus=<comma-separated list of options> usos múltiples
Lista de arquitecturas separadas por comas para las que se compilarán objetos binarios de Apple macOS.
Etiquetas: loses_incremental_state y loading_and_analysis
Valor predeterminado de --macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ver descripción
Versión mínima de macOS compatible para destinos. Si no se especifica, usa "macos_sdk_version".
Etiquetas: loses_incremental_state
Valor predeterminado de --memprof_profile=<a build target label>: ver descripción
Usar perfil de memprof.
Etiquetas: affects_outputs
Valor predeterminado de --[no]objc_debug_with_GLIBCXX: "falso"
Si se establece y el modo de compilación está establecido en "dbg", define GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC y GLIBCPP_CONCEPT_CHECKS.
Etiquetas: action_command_lines
Valor predeterminado de --[no]objc_enable_binary_stripping: "falso"
Indica si se deben realizar eliminaciones de símbolos y de código no muerto en objetos binarios vinculados. Se realizarán eliminaciones de objetos binarios si se especifican esta marca y --compilation_mode=opt.
Etiquetas: action_command_lines
Se acumulan --objccopt=<a string> usos múltiples
Opciones adicionales para pasar a gcc cuando se compilan archivos de origen Objective-C/C++.
Etiquetas: action_command_lines
Se acumulan --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> usos múltiples
Opciones adicionales para pasar a gcc de forma selectiva cuando se compilan ciertos archivos. Esta opción se puede aprobar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter significa una lista de patrones de inclusión y exclusión de expresiones regulares (consulta también --instrumentation_filter). opción_1 a option_n significa opciones arbitrarias de la línea de comandos. Si una opción contiene una coma, se debe colocar entre una barra 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 gcc de todos los archivos cc en //foo/, excepto bar.cc.
Etiquetas: action_command_lines y affects_outputs
Se acumulan --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> usos múltiples
Opciones adicionales para pasar de forma selectiva al backend de LTO (en --features=thin_lto) cuando se compilan ciertos objetos de backend. Esta opción se puede aprobar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter significa una lista de patrones de incluir y excluir expresiones regulares. opción_1 a option_n significa opciones arbitrarias de la línea de comandos. Si una opción contiene una coma, se debe colocar entre una barra 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 LTO de todos los archivos o en //foo/ excepto bar.o.
Etiquetas: action_command_lines y affects_outputs
Valor predeterminado de --platform_suffix=<a string>: ver descripción
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas: loses_incremental_state, affects_outputs y loading_and_analysis
Valor predeterminado de --propeller_optimize=<a build target label>: ver descripción
Usa la información del perfil de Propeller para optimizar el objetivo de la compilación.Un perfil de propeller debe constar de al menos uno de dos archivos, un perfil cc y un perfil ld. Esta marca acepta una etiqueta de compilación que debe hacer referencia a los archivos de entrada del perfil del propeler. Por ejemplo, el archivo COMPILAR 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 export_files al paquete correspondiente para que estos archivos sean visibles para Bazel. La opción debe usarse como: --propeller_optimize=//a/b:propeller_profile
Etiquetas: action_command_lines y affects_outputs
Valor predeterminado de --propeller_optimize_absolute_cc_profile=<a string>: ver descripción
Nombre de la ruta de acceso absoluta del archivo cc_profile para compilaciones de Propeller Optimized.
Etiquetas: affects_outputs
Valor predeterminado de --propeller_optimize_absolute_ld_profile=<a string>: ver descripción
Nombre de la ruta de acceso absoluta del archivo ld_profile para compilaciones de Propeller Optimized.
Etiquetas: affects_outputs
Valor predeterminado de --run_under=<a prefix in front of command>: ver descripción
Prefijo para insertar antes de los ejecutables para la “prueba” y "ejecutar" con comandos de SQL sencillos. Si el valor es “foo -bar” y la línea de comandos de ejecución es “test_binary -baz”, la última línea de comandos es “foo -bar test_binary -baz”. También puede ser una etiqueta para un destino ejecutable. Estos son algunos ejemplos: 'valgrind', 'strace', 'strace -c', 'valgrind --quiet --num-callers=20', '//package:target', '//package:target --options'.
Etiquetas: action_command_lines
Valor predeterminado de --[no]share_native_deps: "true"
Si es verdadero, las bibliotecas nativas que contengan una funcionalidad idéntica se compartirán entre diferentes destinos
Etiquetas: loading_and_analysis y affects_outputs
Valor predeterminado de --[no]stamp: "falso"
Sella objetos binarios con la fecha, el nombre de usuario, el nombre de host, la información del espacio de trabajo, etcétera.
Etiquetas: affects_outputs
--strip=<always, sometimes or never> predeterminado: “a veces”
Especifica si se deben eliminar los objetos binarios y las bibliotecas compartidas (mediante "-Wl,--strip-debug"). El valor predeterminado de “A veces” significa quitar iff --compilation_mode=fastbuild.
Etiquetas: affects_outputs
Se acumulan --stripopt=<a string> usos múltiples
Opciones adicionales para pasar a la barra cuando se genera un archivo '<name>.stripped' binario.
Etiquetas: action_command_lines y affects_outputs
Se acumulan --swiftcopt=<a string> usos múltiples
Opciones adicionales para pasar a la compilación de Swift.
Etiquetas: action_command_lines
El prefijo que se antepone a cualquiera de los symlinks convenientes 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 symlinks ni se emite ninguna advertencia. Advertencia: la funcionalidad especial para "/" pronto quedarán obsoletas; usa --experimental_convenience_symlinks=ignore en su lugar.
Etiquetas: affects_outputs
Se acumulan --tvos_cpus=<comma-separated list of options> usos múltiples
Lista de arquitecturas separadas por comas para las que se compilarán objetos binarios de tvOS de Apple.
Etiquetas: loses_incremental_state y loading_and_analysis
Valor predeterminado de --tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ver descripción
Versión mínima de tvOS compatible para dispositivos y simuladores de destino. Si no se especifica, usa "tvos_sdk_version".
Etiquetas: loses_incremental_state
Se acumulan --visionos_cpus=<comma-separated list of options> usos múltiples
Lista separada por comas de arquitecturas para las que se compilarán objetos binarios de visionOS de Apple.
Etiquetas: loses_incremental_state y loading_and_analysis
Se acumulan --watchos_cpus=<comma-separated list of options> usos múltiples
Lista de arquitecturas separadas por comas para compilar objetos binarios de watchOS de Apple.
Etiquetas: loses_incremental_state y loading_and_analysis
Valor predeterminado de --watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ver descripción
Versión mínima de watchOS compatible con simuladores y dispositivos de destino. Si no se especifica, usa “watchos_sdk_version”.
Etiquetas: loses_incremental_state
Valor predeterminado de --xbinary_fdo=<a build target label>: ver descripción
Usa la información de perfil de XbinaryFDO para optimizar la compilación. Especifica el nombre del perfil de multibinario predeterminado. Cuando la opción se usa junto con --fdo_instrument/--fdo_optimize/--fdo_profile, esas opciones siempre prevalecerán como si nunca se especificara xbinary_fdo.
Etiquetas: affects_outputs
.
Opciones que afectan la precisión con la que Bazel aplica 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 grupo de entorno que se usará para asignar automáticamente los valores de la CPU a los valores de target_environment.
Etiquetas: changes_inputs, loading_and_analysis y experimental
Valor predeterminado de --[no]check_licenses: "falso"
Verifica que las restricciones de licencias impuestas por los paquetes dependientes no entren en conflicto con los modos de distribución de los objetivos que se compilan. De forma predeterminada, las licencias no están marcadas.
Etiquetas: build_file_semantics
Valor predeterminado de --[no]check_visibility: "true"
Si se inhabilita, los errores de visibilidad en las dependencias objetivo descienden a advertencias.
Etiquetas: build_file_semantics
Valor predeterminado de --[no]desugar_for_android: "true"
Establece si se debe expandir el código de bytes de Java 8 antes de la conversión a DEX.
Etiquetas: affects_outputs, loading_and_analysis y loses_incremental_state
Valor predeterminado de --[no]desugar_java8_libs: "falso"
Especifica si se deben incluir bibliotecas de Java 8 compatibles en las apps para dispositivos heredados.
Etiquetas: affects_outputs, loading_and_analysis, loses_incremental_state y experimental
Valor predeterminado de --[no]enforce_constraints: "true"
Verifica los entornos con los que cada destino es compatible y, luego, informa los errores si alguno de ellos tiene dependencias que no admiten los mismos entornos.
Etiquetas: build_file_semantics
Valor predeterminado de --[no]experimental_check_desugar_deps: "true"
Establece si se debe verificar la expansión de sintaxis correcta a nivel del objeto binario de Android.
Etiquetas: eagerness_to_exit, loading_and_analysis y experimental
Configuración predeterminada de --experimental_import_deps_checking=<off, warning or error>: "DESACTIVADA"
Cuando se habilita, se verifica si las dependencias de aar_import están completas. Esta aplicación puede romper la compilación o generar advertencias.
Etiquetas: loading_and_analysis
Valor predeterminado de --experimental_strict_java_deps=<off, warn, error, strict or default>: “predeterminado”
Si es verdadero, comprueba que un destino de Java declare de manera explícita todos los objetivos usados directamente como dependencias.
Etiquetas: build_file_semantics y eagerness_to_exit
Valor predeterminado de --[no]incompatible_check_testonly_for_output_files: "falso"
Si se habilita, comprueba los objetivos de prerrequisito de solo prueba que son archivos de salida buscando solo la prueba de la regla que se genera. Esto coincide con la verificación de visibilidad.
Etiquetas: build_file_semantics y incompatible_change
Valor predeterminado de --[no]incompatible_check_visibility_for_toolchains: "falso"
Si se habilita, la verificación de visibilidad también se aplica a las implementaciones de cadenas de herramientas.
Etiquetas: build_file_semantics y incompatible_change
Valor predeterminado de --[no]incompatible_disable_native_android_rules: "falso"
Si se habilita esta opción, se inhabilitará el uso directo de las reglas nativas de Android. Usa las reglas de Starlark para Android que se encuentran en https://github.com/bazelbuild/rules_android
Etiquetas: eagerness_to_exit y incompatible_change
Valor predeterminado de --[no]incompatible_disable_native_apple_binary_rule: "falso"
No-ops. Se guardan aquí para brindar retrocompatibilidad.
Etiquetas: eagerness_to_exit y incompatible_change
Valor predeterminado de --[no]incompatible_python_disable_py2: "true"
Si es verdadero, usar la configuración de Python 2 generará un error. Esto incluye python_version=PY2, srcs_version=PY2 y srcs_version=PY2ONLY. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/15684.
Etiquetas: loading_and_analysis y incompatible_change
Valor predeterminado de --[no]incompatible_validate_top_level_header_inclusions: "true"
Si es verdadero, Bazel también validará las inclusiones de encabezados de directorio de nivel superior (consulta https://github.com/bazelbuild/bazel/issues/10047 para obtener más información).
Etiquetas: loading_and_analysis y incompatible_change
Valor predeterminado de --python_native_rules_allowlist=<a build target label>: ver descripción
Una lista de entidades permitidas (destino del grupo de productos) que se usará cuando se aplique --incompatible_python_Disallow_native_rules.
Etiquetas: loading_and_analysis
Valor predeterminado de --[no]strict_filesets: "falso"
Si se habilita esta opción, los conjuntos de archivos que cruzan los límites de paquetes se informan como errores.
Etiquetas: build_file_semantics y eagerness_to_exit
Valor predeterminado de --strict_proto_deps=<off, warn, error, strict or default>: "error"
A menos que esté DESACTIVADA, comprueba que un destino proto_library declare de forma explícita todos los objetivos usados directamente como dependencias.
Etiquetas: build_file_semantics, eagerness_to_exit y incompatible_change
Configuración predeterminada de --strict_public_imports=<off, warn, error, strict or default>: "desactivada"
A menos que esté DESACTIVADA, comprueba que un objetivo proto_library declare de forma explícita todos los destinos usados en el campo "import public" como se exportó.
Etiquetas: build_file_semantics, eagerness_to_exit y incompatible_change
Valor predeterminado de --[no]strict_system_includes: "falso"
Si es verdadero, también se deben declarar los encabezados que se encuentran en el sistema incluyen rutas de acceso (-isystem).
Etiquetas: loading_and_analysis y eagerness_to_exit
Se acumulan --target_environment=<a build target label> usos múltiples
Declara el entorno de destino de esta compilación. Debe ser una referencia de etiqueta a un "entorno" . Si se especifica, todos los objetivos de nivel superior deben ser compatibles con este entorno.
Etiquetas: changes_inputs
.
Opciones que afectan los resultados de firma de una compilación:
--apk_signing_method=<v1, v2, v1_v2 or v4> predeterminado: “v1_v2”
Implementación para firmar APKs
Etiquetas: action_command_lines, affects_outputs y loading_and_analysis
Valor predeterminado de --[no]device_debug_entitlements: "true"
Si se configura y el modo de compilación no es "opt", las apps objc incluirán derechos de depuración cuando firmen.
Etiquetas: changes_inputs
Valor predeterminado de --ios_signing_cert_name=<a string>: ver descripción
Nombre del certificado que se usará para la firma de iOS. De lo contrario, se recurrirá al perfil de aprovisionamiento. Puede ser la preferencia de identidad del llavero del certificado o (subcadena) del nombre común del certificado, según la página del manual del símbolo de código (IDENTIDADES DE FIRMA).
Etiquetas: action_command_lines
.
Esta opción afecta la semántica del lenguaje de Starlark o de la API de compilación a la que pueden acceder los archivos BUILD, los archivos .bzl o los archivos WORKSPACE:
Valor predeterminado de --[no]incompatible_config_setting_private_default_visibility: "falso"
Si incompatible_enforce_config_setting_visibility=false, es una noop. De lo contrario, si esta marca es falsa, cualquier config_setting sin un atributo de visibilidad explícito será //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 y incompatible_change
Valor predeterminado de --[no]incompatible_disallow_legacy_py_provider: "true"
No-op; se quitará pronto.
Etiquetas: loading_and_analysis y incompatible_change
Valor predeterminado de --[no]incompatible_disallow_sdk_frameworks_attributes: "falso"
Si esta preferencia se establece como verdadera, no permite los atributos sdk_frameworks y bad_sdk_frameworks en objc_library y objc_import.
Etiquetas: build_file_semantics y incompatible_change
Valor predeterminado de --[no]incompatible_enforce_config_setting_visibility: "true"
Si es verdadero, aplica las restricciones de visibilidad config_setting. Si es falso, cada config_setting es visible para cada destino. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas: loading_and_analysis y incompatible_change
Si es verdadero, establece como verdadero el valor predeterminado para los atributos Alwayslink en objc_library y objc_import.
Etiquetas: build_file_semantics y incompatible_change
Valor predeterminado de --[no]incompatible_python_disallow_native_rules: "falso"
Si es verdadero, se produce un error cuando se usan las reglas py_* integradas. en su lugar, se deben usar las reglas rule_python. Consulta https://github.com/bazelbuild/bazel/issues/17773 para obtener más información y las instrucciones de migración.
Etiquetas: loading_and_analysis y incompatible_change
Opciones que determinan el comportamiento del entorno de pruebas o del ejecutor de pruebas:
Valor predeterminado de --[no]allow_analysis_failures: "falso"
Si es verdadero, una falla de análisis del destino de una regla da como resultado la propagación del destino de una instancia de AnalysisFailureInfo que contiene la descripción del error, en lugar de generar una falla de compilación.
Etiquetas: loading_and_analysis y experimental
Valor predeterminado de --analysis_testing_deps_limit=<an integer>: "2000"
Establece el número máximo de dependencias transitivas mediante un atributo de regla con una transición de configuración for_analysis_testing. Si superas este límite, se producirá un error de regla.
Etiquetas: loading_and_analysis
Valor predeterminado de --[no]break_build_on_parallel_dex2oat_failure: "falso"
Si las verdaderas fallas de acción de dex2oat harán que la compilación se rompa en lugar de ejecutar dex2oat durante el tiempo de ejecución de la prueba.
Etiquetas: loading_and_analysis y experimental
Valor predeterminado de --[no]check_tests_up_to_date: "falso"
No ejecutes pruebas, solo verifica que estén actualizadas. Si todos los resultados de las pruebas están actualizados, estas se completarán de forma correcta. Si es necesario compilar o ejecutar alguna prueba, se informa un error y la prueba falla. Esta opción implica un comportamiento --check_up_to_date.
Etiquetas: execution
Valor predeterminado de --[no]experimental_android_use_parallel_dex2oat: "falso"
Usa dex2oat en paralelo para acelerar la ejecución de android_test.
Etiquetas: loading_and_analysis, host_machine_resource_optimizations y experimental
Se acumulan --flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once> usos múltiples
Cada prueba se volverá a intentar hasta la cantidad especificada de veces en caso de que falle la prueba. Las pruebas que requerían más de un intento de aprobación se marcan como "FLAKY". en el resumen de la prueba. Normalmente, 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 es "default", solo se realizará un intento de prueba para las pruebas regulares y tres para las que su regla marque explícitamente como inestable (atributo poco confiable). Sintaxis alternativa: regex_filter@flaky_test_attempts. Donde flaky_test_attempts es como se muestra arriba y regex_filter significa una lista de patrones de incluir y excluir expresiones regulares (consulta también --runs_per_test). Ejemplo: --flaky_test_attempts=//foo/.*,-//foo/bar/.*@3 desencripta todas las pruebas en //foo/, excepto las que se encuentran en foo/bar tres veces. Esta opción se puede aprobar varias veces. El argumento que se pasó más recientemente y que coincida tiene prioridad. Si no hay coincidencias, el comportamiento es “predeterminado” arriba.
Etiquetas: execution
Valor predeterminado de --[no]ios_memleaks: "falso"
Habilitar la verificación de fugas de memoria en los destinos de ios_test.
Etiquetas: action_command_lines
Valor predeterminado de --ios_simulator_device=<a string>: ver descripción
El dispositivo que se debe simular cuando se ejecuta una aplicación para iOS en el simulador, p.ej., "iPhone 6". Ejecuta “xcrun simctl list devicetypes” para obtener una lista de dispositivos. de la máquina en la que se ejecutará el simulador.
Etiquetas: test_runner
Valor predeterminado de --ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ver descripción
Es la versión de iOS que se ejecuta en el simulador durante la ejecución o las pruebas. Esto se ignora para las reglas ios_test si se especifica un dispositivo de destino 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: "automático"
La cantidad máxima de trabajos de prueba locales que se ejecutan de forma simultánea. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5" 0 significa que los recursos locales limitarán la cantidad de trabajos de prueba locales que se ejecutarán simultáneamente. Establecer este valor mayor que el valor de --jobs no tiene efecto.
Etiquetas: execution
Se acumulan --runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once> usos múltiples
Especifica la cantidad de veces que se debe ejecutar cada prueba. Si alguno de esos intentos falla por cualquier motivo, toda la prueba se considera fallida. Por lo general, 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. En el ejemplo anterior, ejecuta_per_prueba significa 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 aprobar varias veces. El argumento que se pasó más recientemente y que coincida tiene prioridad. Si no hay coincidencias, la prueba se ejecutará solo una vez.
Se acumulan --test_env=<a 'name=value' assignment with an optional value part> usos múltiples
Especifica las variables de entorno adicionales que se insertarán en el entorno del ejecutor de pruebas. Las variables pueden especificarse por nombre, en cuyo caso su valor se leerá desde el entorno de cliente de Bazel o por el par nombre=valor. Esta opción se puede usar varias veces para especificar muchas variables. Solo lo usa la "prueba de Bazel". kubectl.
Etiquetas: test_runner
Valor predeterminado de --[no]test_keep_going: "true"
Cuando se inhabilita, cualquier prueba que no se apruebe 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 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 del tiempo de espera de la prueba (en segundos). Si se especifica un valor entero positivo único, se anularán todas las categorías. Si se especifican 4 números enteros separados por comas, se anularán los tiempos de espera de corto, moderado, largo y eterno (en ese orden). En cualquier caso, el valor -1 indica al blaze que use los tiempos de espera predeterminados para esa categoría.
Valor predeterminado de --test_tmpdir=<a path>: ver descripción
Especifica el directorio temporal base para la "prueba de Bazel". usar.
Valor predeterminado de --[no]zip_undeclared_test_outputs: "true"
Si es verdadero, los resultados de la prueba que no se declaren se archivarán en un archivo ZIP.
Etiquetas: test_runner
.
Opciones que activan optimizaciones del tiempo de compilación:
Valor predeterminado de --[no]experimental_filter_library_jar_with_program_jar: "falso"
Filtra ProgramJar de ProGuard para quitar las clases que también estén presentes en el LibraryJar.
Etiquetas: action_command_lines
Valor predeterminado de --[no]experimental_inmemory_dotd_files: "true"
Si se habilita, los archivos .d de C++ se pasarán a la memoria directamente desde los nodos de compilación remotos en lugar de escribirse en el disco.
Etiquetas: loading_and_analysis, execution, affects_outputs y experimental
Valor predeterminado de --[no]experimental_inmemory_jdeps_files: "true"
Si se habilita, los archivos de dependencia (.jdeps) generados a partir de compilaciones de Java se pasarán a la memoria directamente desde los nodos de compilación remotos en lugar de escribirse en el disco.
Etiquetas: loading_and_analysis, execution, affects_outputs y experimental
Valor predeterminado de --[no]experimental_objc_include_scanning: "falso"
Si se debe realizar, incluye el análisis del objetivo de C/C++.
Etiquetas: loading_and_analysis, execution y changes_inputs
Valor predeterminado de --[no]experimental_retain_test_configuration_across_testonly: "falso"
Cuando se habilita, --trim_test_configuration no recortará la configuración de prueba para las reglas marcadas como testonly=1. El objetivo de esto es reducir los problemas de conflictos 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 y loses_incremental_state
Valor predeterminado de --[no]experimental_starlark_cc_import: "falso"
Si se habilita, se puede usar la versión de Starlark de cc_import.
Etiquetas: loading_and_analysis y experimental
Valor predeterminado de --[no]experimental_unsupported_and_brittle_include_scanning: "falso"
Establece si las entradas se limitan a la compilación C/C++ mediante el análisis de #include líneas de archivos de entrada. Esto puede mejorar el rendimiento y la incrementalidad disminuyendo el tamaño de los árboles de entrada de compilación. Sin embargo, también puede romper compilaciones porque el escáner de inclusión no implementa por completo la semántica del preprocesador de C. En particular, no comprende las directivas dinámicas #include y, también, ignora la lógica condicional del preprocesador. Úsala bajo tu propia responsabilidad. Se cerrarán todos los problemas relacionados con esta marca que se hayan presentado.
Etiquetas: loading_and_analysis, execution y changes_inputs
Valor predeterminado de --[no]incremental_dexing: "true"
Realiza la mayor parte del trabajo para la conversión a DEX por separado para cada archivo jar.
Etiquetas: affects_outputs, loading_and_analysis y loses_incremental_state
Valor predeterminado de --local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>: "HOST_CPUS"
Establece de forma explícita la cantidad total de núcleos de CPU locales disponibles para que Bazel invierta en acciones de compilación ejecutadas de forma local. Toma un número entero o "HOST_CPUS", opcionalmente seguido de [-|*]<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.
Etiquetas: host_machine_resource_optimizations
Se acumulan --local_extra_resources=<a named float, 'name=value'> usos múltiples
Establece la cantidad de recursos adicionales disponibles para Bazel. Toma un par de números de punto flotante de cadena. Se puede usar varias veces para especificar varios tipos de recursos adicionales. Bazel limitará las acciones que se ejecutan en simultáneo en función de los recursos adicionales disponibles y los necesarios. Las pruebas pueden declarar la cantidad de recursos adicionales que necesitan con una etiqueta de “resources:<resoucename>:<amount>”. de un conjunto de datos tengan un formato común. La CPU, la RAM y los recursos disponibles no se pueden configurar con esta marca.
Etiquetas: host_machine_resource_optimizations
--local_ram_resources=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.> valor predeterminado: "HOST_RAM*.67"
Establece de forma explícita la cantidad total de RAM del host local (en MB) disponible para Bazel a fin de invertir en acciones de compilación ejecutadas localmente. Toma un número entero, o "HOST_RAM", opcionalmente seguido de [-|*]<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 utilizará el 67% de esta.
Etiquetas: host_machine_resource_optimizations
Valor predeterminado de --[no]objc_use_dotd_pruning: "true"
Si se configura, los archivos .d emitidos por Clang se usarán para reducir el conjunto de entradas que se pasan a compilaciones objc.
Etiquetas: changes_inputs y loading_and_analysis
Valor predeterminado de --[no]process_headers_in_dependencies: "falso"
Cuando se compila un //a:a de destino, procesa 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
Valor predeterminado de --[no]trim_test_configuration: "true"
Cuando se habilita esta opción, las opciones relacionadas con las pruebas se borran 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 pruebas no harán que las reglas que no son de prueba se vuelvan a analizar.
Etiquetas: loading_and_analysis y loses_incremental_state
Opciones que afectan la verbosidad, el formato o la ubicación del registro:
Valor predeterminado de --[no]experimental_bep_target_summary: "falso"
Especifica si se publicarán los eventos de TargetSummary.
Valor predeterminado de --[no]experimental_build_event_expand_filesets: "falso"
Si es verdadero, expande los conjuntos de archivos en BEP cuando presentes archivos de salida.
Etiquetas: affects_outputs
Si es verdadero, resuelve por completo los symlinks relativos del conjunto de archivos en el BEP cuando presentes 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"
La cantidad máxima de veces que Bazel debería reintentar subir un evento de compilación.
Etiquetas: bazel_internal_configuration
Valor predeterminado de --experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>: "1s"
Es el retraso mínimo inicial para los reintentos de retirada exponencial cuando falla la carga de BEP. (exponente: 1.6)
Etiquetas: bazel_internal_configuration
Valor predeterminado de --experimental_build_event_upload_strategy=<a string>: ver 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
Valor predeterminado de --[no]experimental_materialize_param_files_directly: "falso"
Si materializas archivos de parámetros, hazlo con escrituras directas en el disco.
Etiquetas: execution
Valor predeterminado de --[no]experimental_run_bep_event_include_residue: "falso"
Indica si se debe incluir el residue de línea de comandos en eventos de compilación en ejecución que podrían contener el residue. De forma predeterminada, el residue no se incluye en los eventos de compilación de comandos de ejecución que podrían contener el residue.
Etiquetas: affects_outputs
Valor predeterminado de --[no]experimental_stream_log_file_uploads: "falso"
Transmite las cargas de archivos de registro directamente al almacenamiento remoto en lugar de escribirlas en el disco.
Etiquetas: affects_outputs
Valor predeterminado de --explain=<a path>: ver 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
Valor predeterminado de --[no]legacy_important_outputs: "true"
Úsalo para suprimir la generación del campo relevant_outputs heredado en el evento TargetComplete. importantes_outputs son obligatorios para la integración de Bazel a ResultStore.
Etiquetas: affects_outputs
Valor predeterminado de --[no]materialize_param_files: "falso"
Escribe archivos de parámetros intermedios en el árbol de salida, incluso cuando se usa la ejecución de acción remota. Es útil para depurar acciones. Esto está implícito en --subcomandos y --verbose_failures.
Etiquetas: execution
Valor predeterminado de --max_config_changes_to_show=<an integer>: "3"
Cuando se descarta la caché de análisis debido a un cambio en las opciones de compilación, se muestra hasta la cantidad determinada de nombres de opciones modificados. 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 puede emitirse cuando --test_output es “errores” o "todos". Es útil para evitar sobrecargar la salida con resultados de prueba demasiado ruidosos. El encabezado de la prueba se incluye en el tamaño del registro. Los valores negativos implican que no hay límite. La salida es todo o nada.
Etiquetas: test_runner, terminal_output y execution
Valor predeterminado de --output_filter=<a valid Java regular expression>: ver descripción
Solo muestra advertencias y resultados de acciones para reglas cuyo nombre coincida con la expresión regular proporcionada.
Etiquetas: affects_outputs
Valor predeterminado de --progress_report_interval=<an integer in 0-3600 range>: "0"
La cantidad de segundos que se debe esperar entre informes sobre 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 30 segundos y, después de ese tiempo, se informará una vez por minuto. Cuando se habilita --maldiciones, el progreso se informa cada segundo.
Etiquetas: affects_outputs
Valor predeterminado de --show_result=<an integer>: "1"
Muestra los resultados de la compilación. Para cada destino, indica si se actualizó y, de ser así, una lista de los archivos de salida que se compilaron. Los archivos impresos son cadenas convenientes que se pueden copiar y pegar en la shell para ejecutarlos. Esta opción requiere un argumento de número entero, que es el número de umbral de objetivos por encima del cual no se imprime la información del resultado. Por lo tanto, cero provoca la supresión del mensaje y MAX_INT hace que siempre se imprima el resultado. El valor predeterminado es uno. Si no se compiló nada para un objetivo, se pueden omitir sus resultados a fin de mantener los resultados por debajo del umbral.
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 en un formato compatible con las 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 mostrar solo el resumen del estado de prueba, para imprimir registros de prueba de las pruebas fallidas, "all" para imprimir registros de todas las pruebas y "transmitidos" para generar registros para todas las pruebas en tiempo real (esto forzará la ejecución local de las pruebas, una a la vez, independientemente del valor de --test_strategy)
Etiquetas: test_runner, terminal_output y execution
Valor predeterminado de --test_summary=<short, terse, detailed, none or testcase>: “short”
Especifica el formato deseado para el resumen de la prueba. Los valores válidos son "short" para imprimir solo información sobre las pruebas ejecutadas, "terse", para imprimir información sobre las pruebas no exitosas que se hayan ejecutado, "detalladas" para imprimir información detallada sobre casos de prueba fallidos, “testcase” para imprimir el resumen en la resolución de casos de prueba, no imprimir información detallada sobre los casos de prueba fallidos y “ninguno” 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 la 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 la cadena de herramientas y los objetivos específicos para ver cuál depurar. Es posible que varias regex estén separadas con comas y, luego, cada regex se verifique 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 la cadena de herramientas.
Etiquetas: terminal_output
Valor predeterminado de --[no]verbose_explanations: "falso"
Aumenta la verbosidad de las explicaciones emitidas si --explain está habilitada. No tiene efecto si --explain no está habilitada.
Etiquetas: affects_outputs
Valor predeterminado de --[no]verbose_failures: "falso"
Si un comando falla, muestra la línea de comandos completa.
Etiquetas: terminal_output
.
Opciones que especifican o modifican una entrada genérica para un comando de Bazel que no se encuentra en otras categorías.
Se acumulan --aspects_parameters=<a 'name=value' assignment> usos múltiples
Especifica los valores de los parámetros de aspectos de la línea de comandos. Cada valor del parámetro se especifica mediante <param_name>=<param_value>, por ejemplo, 'my_param=my_val' en el que “my_param” es un parámetro de algún aspecto en la lista de --aspects o requerido por un aspecto de 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 --flag_alias=<a 'name=value' flag alias> usos múltiples
Establece un nombre abreviado para una bandera de Starlark. Toma un solo par clave-valor con el formato "<clave>=<valor>" como argumento.
Etiquetas: changes_inputs
Valor predeterminado de --[no]incompatible_default_to_explicit_init_py: "falso"
Esta marca cambia el comportamiento predeterminado para que los archivos __init__.py ya no se creen automáticamente en los runfiles de los objetivos de Python. De manera precisa, cuando un destino py_binary o py_test tiene legacy_create_init configurado en “auto” (configuración predeterminada), se trata como falsa solo si se configura esta marca. Consulta https://github.com/bazelbuild/bazel/issues/10076.
Etiquetas: affects_outputs y incompatible_change
Valor predeterminado de --[no]incompatible_py2_outputs_are_suffixed: "true"
Si es verdadero, los destinos compilados en la configuración de Python 2 aparecerán en una raíz de salida que incluya 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 symlink de conveniencia "bazel-bin" apuntará a los objetivos de Python 3 en lugar de a Python 2. Si habilitas esta opción, también se recomienda habilitar `--incompatible_py3_is_default`.
Etiquetas: affects_outputs y incompatible_change
Valor predeterminado de --[no]incompatible_py3_is_default: "true"
Si el valor es verdadero, los destinos "py_binary" y "py_test" que no establezcan sus atributos "python_version" (o "default_python_version") pasarán a ser PY3 de forma predeterminada en lugar de PY2. Si configuras esta marca, también se recomienda configurar `--incompatible_py2_outputs_are_suffixed`.
Etiquetas: loading_and_analysis, affects_outputs y incompatible_change
Valor predeterminado de --[no]incompatible_use_python_toolchains: "true"
Si se configura como verdadera, las reglas ejecutables nativas de Python 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 y incompatible_change
Valor predeterminado de --python_version=<PY2 or PY3>: ver descripción
El modo de versión principal de Python, ya sea “PY2” o “PY3”. Ten en cuenta que los objetivos "py_binary" y "py_test" anulan esta opción (incluso si no especifican explícitamente una versión), por lo que no suele haber muchos motivos para proporcionar esta marca.
Etiquetas: loading_and_analysis y affects_outputs
Valor predeterminado de --target_pattern_file=<a string>: ""
Si se configura, la compilación leerá los patrones del archivo nombrado aquí, en lugar de hacerlo en la línea de comandos. Es un error especificar un archivo aquí, al igual que patrones de la línea de comandos.
Etiquetas: changes_inputs
.
Opciones de ejecución y almacenamiento en caché remoto:
Valor predeterminado de --experimental_remote_cache_eviction_retries=<an integer>: "0"
La cantidad máxima de intentos para reintentar si la compilación encontró un error de expulsión de caché remota. Un valor distinto de cero establecerá implícitamente --incompatible_remote_use_new_exit_code_for_lost_inputs como true. Se generará un nuevo ID de invocación para cada intento. Si generas el ID de invocación y se lo proporcionas a Bazel con --invocation_id, no debes usar esta marca. En su lugar, configura la marca --incompatible_remote_use_new_exit_code_for_lost_inputs y verifica el código de salida 39.
Etiquetas: execution
Valor predeterminado de --[no]incompatible_remote_use_new_exit_code_for_lost_inputs: "true"
Si la estableces como verdadera, Bazel usará el nuevo código de salida 39, en lugar de 34, si la caché remota expulsa los BLOB durante la compilación.
Etiquetas: incompatible_change
.
Otras opciones, sin categorizar:
Valor predeterminado de --[no]allow_analysis_cache_discard: "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 se cierre, en lugar de continuar con la compilación. Esta opción no tiene efecto cuando "discard_analysis_cache" también se configura.
Etiquetas: eagerness_to_exit
Valor predeterminado de --[no]build_manual_tests: "falso"
Fuerza los objetivos de prueba etiquetados como "manuales" que se construya. 'manual' se excluyen del procesamiento. Esta opción los obliga a compilarse (pero no a ejecutarse).
Valor predeterminado de --build_tag_filters=<comma-separated list of options>: ""
Especifica una lista de etiquetas separadas por comas. De manera opcional, cada etiqueta puede ir precedida por "-" para especificar etiquetas excluidas. Solo se crearán esos objetivos que contengan al menos una etiqueta incluida y que no contengan ninguna etiqueta excluida. Esta opción no afecta el conjunto de pruebas ejecutadas con el comando "test" comando; se rigen por las opciones de filtro de prueba, por ejemplo, "--test_tag_filters"
Valor predeterminado de --[no]build_tests_only: "falso"
Si se especifica, solo se compilarán las reglas *_test y test_suite y se ignorarán los demás destinos especificados en la línea de comandos. De forma predeterminada, se compilará todo lo que se solicitó.
--[no]cache_test_results [-t] predeterminada: "automática"
Si se configura como “auto”, Bazel vuelve a ejecutar una prueba solo en los siguientes casos: (1) Bazel detecta cambios en la prueba o sus dependencias, (2) la prueba se marcó como externa, (3) se solicitaron múltiples ejecuciones de prueba con --runs_per_test o(4) la prueba falló anteriormente. Si se configura en "sí", Bazel almacenará en caché todos los resultados de las pruebas, excepto las marcadas como externas. Si la estableces como "no", Bazel no almacenará en caché ningún resultado de prueba.
Valor predeterminado de --[no]compile_one_dependency: "falso"
Compila una sola dependencia de los archivos de argumento. Esto es útil para verificar la sintaxis de los archivos de origen en los IDE, por ejemplo, reconstruiendo un único 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 de marca. en lugar de ser objetivos de compilación, sino nombres de archivos de origen. Para cada nombre de archivo de origen, se compilará un destino arbitrario que dependa de él.
Se acumulan --deleted_packages=<comma-separated list of package names> usos múltiples
Una lista separada por comas de los nombres de los paquetes que el sistema de compilación considerará inexistentes, incluso si están visibles en alguna parte de la ruta del paquete. Usa esta opción cuando borres un subpaquete "x/y" de un paquete 'x' existente. Por ejemplo, después de borrar x/y/BUILD en tu cliente, el sistema de compilación puede presentar un reclamo si encuentra la etiqueta “//x:y/z”. si aún lo proporciona otra entrada package_path. Especificar --deleted_packages x/y evita este problema.
Valor predeterminado de --[no]discard_analysis_cache: "falso"
Descarta la caché de análisis inmediatamente después de que se complete la fase de análisis. Reduce el uso de memoria en aproximadamente un 10%, pero ralentiza las compilaciones incrementales adicionales.
Valor predeterminado de --execution_log_binary_file=<a path>: ver descripción
Registra los generadores ejecutados en este archivo como protos de generación delimitados, según src/main/protobuf/spawn.proto. Marcas relacionadas: --execution_log_json_file (formato JSON de texto; mutuamente excluyente), --execution_log_sort (si se debe ordenar el registro de ejecución), --subcomandos (para mostrar subcomandos en el resultado de la terminal).
Valor predeterminado de --execution_log_json_file=<a path>: ver descripción
Registra los generadores ejecutados en este archivo como una representación JSON de los protos de Spawn delimitados, según src/main/protobuf/spawn.proto. Marcas relacionadas: --execution_log_binary_file (formato binario protobuf, mutuamente excluyente), --execution_log_sort (si se debe ordenar el registro de ejecución), --subcomandos (para mostrar subcomandos en el resultado de la terminal).
Valor predeterminado de --[no]execution_log_sort: "true"
Establece si se debe ordenar el registro de ejecución, lo que facilita la comparación de registros en las invocaciones. Se configura como falso para evitar un uso potencialmente significativo de CPU y memoria al final de la invocación, a costa de producir el registro en un orden de ejecución no determinista.
Valor predeterminado de --[no]expand_test_suites: "true"
Expandir los objetivos de test_suite a sus pruebas constituyentes antes del análisis Cuando esta marca esté activada (configuración predeterminada), se aplicarán patrones de objetivo negativo a las pruebas que pertenezcan al paquete de pruebas; de lo contrario, no se aplicarán. Desactivar esta marca es útil cuando los aspectos de nivel superior se aplican en la línea de comandos: luego, pueden analizar los objetivos de test_suite.
Etiquetas: loading_and_analysis
Valor predeterminado de --[no]experimental_cancel_concurrent_tests: "falso"
Si esta preferencia se establece como "true", Blaze cancelará las pruebas que se estén ejecutando simultáneamente en la primera ejecución correcta. Esto solo es útil en combinación con --runs_per_test_detects_flakes.
Etiquetas: affects_outputs y loading_and_analysis
Valor predeterminado de --experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>: ""
Obsoleto para dar lugar a aspectos. Filtra el conjunto de objetivos para los que se programarán acciones extra.
Valor predeterminado de --[no]experimental_extra_action_top_level_only: "falso"
Obsoleto para dar lugar a aspectos. Solo programa extra_actions para los objetivos de nivel superior.
Valor predeterminado de --[no]experimental_fetch_all_coverage_outputs: "falso"
Si es verdadero, Bazel recupera todo el directorio de datos de cobertura para cada prueba durante una ejecución de cobertura.
Etiquetas: affects_outputs y loading_and_analysis
Valor predeterminado de --[no]experimental_generate_llvm_lcov: "falso"
Si es verdadero, la cobertura de clang generará un informe de LCOV.
Etiquetas: affects_outputs y loading_and_analysis
Valor predeterminado de --[no]experimental_j2objc_header_map: "true"
Establece si se debe generar un mapa de encabezado de J2ObjC en paralelo a la transpilación de J2ObjC.
Valor predeterminado de --[no]experimental_j2objc_shorter_header_path: "falso"
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 clase reducidas para compilaciones de Java.
Valor predeterminado de --[no]experimental_limit_android_lint_to_android_constrained_java: "falso"
Limita las --experimental_run_android_lint_on_java_rules a bibliotecas compatibles con Android.
Etiquetas: affects_outputs
Valor predeterminado de --[no]experimental_run_android_lint_on_java_rules: "falso"
Establece si se deben validar fuentes java_*.
Etiquetas: affects_outputs
Valor predeterminado de --[no]explicit_java_test_deps: "falso"
Especifica de forma explícita una dependencia para JUnit o Hamcrest en una java_test, en lugar de obtener por error de las dependencias de TestRunner. Por el momento, solo funciona para Bazel.
Valor predeterminado de --host_java_launcher=<a build target label>: ver descripción
El selector de Java que usan las herramientas que se ejecutan durante una compilación.
Se acumulan --host_javacopt=<a string> usos múltiples
Opciones adicionales para pasar a javac cuando se compilan herramientas que se ejecutan durante una compilación.
Se acumulan --host_jvmopt=<a string> usos múltiples
Opciones adicionales para pasar a la VM de Java cuando se compilan herramientas que se ejecutan durante la compilación. Estas se agregarán a las opciones de inicio de la VM de cada destino java_binary.
Valor predeterminado de --[no]incompatible_check_sharding_support: "true"
Si es verdadero, Bazel fallará una prueba fragmentada si el ejecutor de pruebas no indica que admite la fragmentación tocando el archivo en la ruta de acceso en TEST_SHARD_STATUS_FILE. Si es falso, un ejecutor de pruebas que no admite la fragmentación dará lugar a que se ejecuten todas las pruebas en cada fragmento.
Etiquetas: incompatible_change
Valor predeterminado de --[no]incompatible_exclusive_test_sandboxed: "true"
Si es verdadero, las pruebas exclusivas se ejecutarán con la estrategia de zona de pruebas. Agregar “local” etiqueta para forzar una ejecución de prueba exclusiva de forma local
Etiquetas: incompatible_change
Valor predeterminado de --[no]incompatible_strict_action_env: "falso"
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 hacerlo puede evitar el almacenamiento en caché entre usuarios si se usa una caché compartida.
Etiquetas: loading_and_analysis y incompatible_change
Se acumulan --j2objc_translation_flags=<comma-separated list of options> usos múltiples
Opciones adicionales para pasar a la herramienta J2ObjC.
--java_debug
Hace que la máquina virtual Java de una prueba de Java espere una conexión desde un depurador compatible con JDWP (como jdb) antes de comenzar 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
Valor predeterminado de --[no]java_deps: "true"
Genera información de dependencia (por ahora, la ruta de clase del tiempo de compilación) por objetivo de Java.
Valor predeterminado de --[no]java_header_compilation: "true"
Compila ijars directamente desde la fuente.
Valor predeterminado de --java_language_version=<a string>: ""
La versión del lenguaje Java
Valor predeterminado de --java_launcher=<a build target label>: ver descripción
Selector de Java que se usa cuando se compilan objetos binarios de Java. Si esta marca se establece en la cadena vacía, se usa el selector de JDK. El "selector" anula esta marca.
--java_runtime_version=<a string> predeterminado: “local_jdk”
La versión del entorno de ejecución de Java
Se acumulan --javacopt=<a string> usos múltiples
Opciones adicionales para pasar a javac.
Se acumulan --jvmopt=<a string> usos múltiples
Opciones adicionales para pasar a la VM de Java. Estas se agregarán a las opciones de inicio de la VM de cada destino java_binary.
Valor predeterminado de --legacy_main_dex_list_generator=<a build target label>: ver descripción
Especifica un objeto binario que se debe usar para generar la lista de clases que deben estar en el DEX principal al compilar multidex heredado.
Valor predeterminado de --local_termination_grace_seconds=<an integer>: "15"
Tiempo de espera entre la finalización de un proceso local debido al tiempo de espera y su cierre forzado.
Valor predeterminado de --optimizing_dexer=<a build target label>: ver descripción
Especifica el objeto binario que se usará para generar archivos dex sin fragmentación.
--package_path=<colon-separated list of options> predeterminado: “%workspace%”
Una lista separada por dos puntos de dónde buscar paquetes Elementos que comienzan con “%workspace%” están relacionadas con el 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 --plugin=<a build target label> usos múltiples
Complementos para usar en la compilación. Actualmente funciona con java_plugin.
Valor predeterminado de --proguard_top=<a build target label>: ver descripción
Especifica qué versión de ProGuard se debe usar para la eliminación de código al compilar un objeto binario de Java.
--proto_compiler=<a build target label> predeterminado: “@bazel_tools//tools/proto:protoc”
Es la etiqueta del proto-compiler.
Etiquetas: affects_outputs y loading_and_analysis
--proto_toolchain_for_cc=<a build target label> predeterminado: "@bazel_tools//tools/proto:cc_toolchain"
Etiqueta de proto_lang_toolchain() que describe cómo compilar protos de C++
Etiquetas: affects_outputs y loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label> predeterminado: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"
Etiqueta de proto_lang_toolchain() que describe cómo compilar protos j2objc.
Etiquetas: affects_outputs y loading_and_analysis
--proto_toolchain_for_java=<a build target label> predeterminado: "@bazel_tools//tools/proto:java_toolchain"
Etiqueta de proto_lang_toolchain() que describe cómo compilar protos de Java.
Etiquetas: affects_outputs y loading_and_analysis
--proto_toolchain_for_javalite=<a build target label> predeterminado: "@bazel_tools//tools/proto:javalite_toolchain"
Etiqueta de proto_lang_toolchain() que describe cómo compilar protos de JavaLite.
Etiquetas: affects_outputs y loading_and_analysis
Se acumulan --protocopt=<a string> usos múltiples
Opciones adicionales para pasar al compilador de protobuf.
Etiquetas: affects_outputs
Valor predeterminado de --[no]runs_per_test_detects_flakes: "falso"
Si es verdadero, cualquier fragmento en el que se haya completado al menos una ejecución o un intento y al menos una falla o ejecución tendrá un estado FLAKY.
Valor predeterminado de --shell_executable=<a path>: ver descripción
Ruta de acceso absoluta al shell ejecutable para que lo use Bazel. Si no la estableces, pero la variable de entorno BAZEL_SH está establecida en la primera invocación de Bazel (que inicia un servidor de Bazel), Bazel la usará. Si no se establece ninguna, Bazel usa una ruta de acceso predeterminada hard-coded según el sistema operativo en el que se ejecute (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 es compatible con Bash puede generar fallas de compilación o de tiempo de ejecución de los objetos binarios generados.
Etiquetas: loading_and_analysis
Valor predeterminado de --[no]show_loading_progress: "true"
Si se habilita, hace que Bazel imprima el mensaje "Loading package:" (Cargando paquete): mensajes nuevos.
Se acumulan --test_arg=<a string> usos múltiples
Especifica las opciones y los argumentos 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 recibirá argumentos idénticos. Solo lo usa la "prueba de Bazel". kubectl.
Valor predeterminado de --test_filter=<a string>: ver descripción
Especifica un filtro para reenviar al framework de prueba. 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 la lista de idiomas de prueba separados por comas. De manera opcional, cada idioma puede ir precedido por "-" 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 de la regla *_test; p.ej., uno de 'cc', 'java', 'py', etc. Esta opción afecta el comportamiento --build_tests_only y el comando de prueba.
Valor predeterminado de --test_result_expiration=<an integer>: "-1"
Esta opción dejó de estar disponible y no tiene efecto.
Valor predeterminado de --[no]test_runner_fail_fast: "falso"
La opción de reenvíos falla con rapidez al ejecutor de pruebas. El ejecutor de pruebas debe detener la ejecución cuando se produce la primera falla.
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce> predeterminado: "explícito"
Especifica la estrategia para la fragmentación de pruebas: “explícita” solo use la fragmentación si el atributo 'shard_count' El atributo BUILD está presente. 'inhabilitado' nunca usen la fragmentación de pruebas. “forced=k” aplicar “k” fragmentos para realizar pruebas sin importar la variable 'shard_count' Build.
Valor predeterminado de --test_size_filters=<comma-separated list of values: small, medium, large or enormous>: ""
Especifica la lista de tamaños de prueba separados por comas. De manera opcional, cada tamaño puede ir precedido por "-" para especificar los tamaños excluidos. Solo se detectarán los objetivos de prueba que contienen, al menos, un tamaño incluido y no contienen tamaños excluidos. Esta opción afecta el comportamiento --build_tests_only y el comando test.
Valor predeterminado de --test_tag_filters=<comma-separated list of options>: ""
Especifica la lista de etiquetas de prueba separadas por comas. De manera opcional, cada etiqueta puede ir precedida por "-" para especificar etiquetas excluidas. Solo se detectarán los objetivos de prueba que contienen al menos una etiqueta incluida y no contienen ninguna etiqueta excluida. Esta opción afecta el comportamiento --build_tests_only y el comando test.
Valor predeterminado de --test_timeout_filters=<comma-separated list of values: short, moderate, long or eternal>: ""
Especifica la lista de tiempos de espera de prueba separados por comas. De manera opcional, cada tiempo de espera puede ir precedido por "-" para especificar tiempos de espera excluidos. Solo se detectarán los objetivos de prueba que contienen al menos un tiempo de espera incluido y no contienen tiempos de espera excluidos. Esta opción afecta el comportamiento --build_tests_only y el comando test.
Valor predeterminado de --tool_java_language_version=<a string>: ""
La versión de lenguaje Java que se usa para ejecutar las herramientas necesarias durante una compilación
--tool_java_runtime_version=<a string> predeterminado: "remotejdk_11"
La versión del entorno de ejecución de Java que se usa para ejecutar herramientas durante la compilación
Valor predeterminado de --[no]use_ijars: "true"
Si se habilita, esta opción hace que la compilación de Java use archivos jar de la interfaz. Esto dará como resultado una compilación incremental más rápida, pero los mensajes de error pueden ser diferentes.

Opciones de canonicalización de marcas

Hereda todas las opciones de build.

Opciones que aparecen antes del comando y que el cliente analiza:
Se acumulan --distdir=<a path> usos múltiples
Lugares adicionales para buscar archivos antes de acceder a la red y descargarlos.
Etiquetas: bazel_internal_configuration
Si se configura, la caché del repositorio vinculará el archivo en lugar de copiarlo en caso de que se produzca un acierto de caché. Esto está diseñado para ahorrar espacio en el disco.
Etiquetas: bazel_internal_configuration
Valor predeterminado de --experimental_repository_downloader_retries=<an integer>: "0"
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> valor 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 esperado por el autor de la regla, sin cambiar el código fuente.
Etiquetas: bazel_internal_configuration y experimental
Valor predeterminado de --http_connector_attempts=<an integer>: "8"
La cantidad máxima de intentos para descargas http.
Etiquetas: bazel_internal_configuration
Valor predeterminado de --http_connector_retry_max_timeout=<An immutable length of time.>: "0s"
El tiempo de espera máximo para los reintentos de descarga de HTTP. Con un valor de 0, no se define ningún tiempo de espera máximo.
Etiquetas: bazel_internal_configuration
--http_timeout_scaling=<a double> valor predeterminado: "1.0"
Escalar todos los tiempos de espera relacionados con las descargas HTTP según el factor determinado
Etiquetas: bazel_internal_configuration
Valor predeterminado de --repository_cache=<a path>: ver descripción
Especifica la ubicación de caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché; de lo contrario, el valor predeterminado es '<output_user_root>/cache/repos/v1'. se usa
Etiquetas: bazel_internal_configuration
Valor predeterminado de --[no]repository_disable_download: "falso"
Si se configura, no se permite la descarga con ctx.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no está completamente inhabilitado. ctx.execute aún podría ejecutar un ejecutable arbitrario que acceda a Internet.
Etiquetas: bazel_internal_configuration
.
Opciones que controlan la ejecución de compilación:
Valor predeterminado de --gc_thrashing_threshold=<an integer in 0-100 range>: "100"
El porcentaje del espacio permanente ocupado (0-100) por encima del cual GcThrashingDetector considera eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, GcThrashingDetector está inhabilitado.
Etiquetas: host_machine_resource_optimizations
.
Opciones que controlan el resultado del comando:
Valor predeterminado de --[no]canonicalize_policy: "falso"
Muestra la política canónica después de la expansión y el filtrado. Para mantener el resultado limpio, los argumentos del comando canonicalizado NO se mostrarán cuando esta opción se configure 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 y terminal_output
Valor predeterminado de --[no]experimental_include_default_values: "falso"
Indica si las opciones de Starlark configuradas en sus valores predeterminados se incluyen en el resultado.
Etiquetas: affects_outputs y terminal_output
Esta opción afecta la semántica del lenguaje de Starlark o de la API de compilación accesible para los archivos BUILD, los archivos .bzl o los archivos WORKSPACE:
Valor predeterminado de --[no]incompatible_config_setting_private_default_visibility: "falso"
Si incompatible_enforce_config_setting_visibility=false, es una noop. De lo contrario, si esta marca es falsa, cualquier config_setting sin un atributo de visibilidad explícito será //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 y incompatible_change
Valor predeterminado de --[no]incompatible_enforce_config_setting_visibility: "true"
Si es verdadero, aplica las restricciones de visibilidad config_setting. Si es falso, cada config_setting es visible para cada destino. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas: loading_and_analysis y incompatible_change
Opciones relacionadas con la salida y la semántica de Bzlmod:
Se acumulan --allow_yanked_versions=<a string> usos múltiples
Se especificaron las versiones de los módulos con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resueltas, incluso si se declaran como eliminadas en el registro del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones rechazadas harán que la resolución falle. También puedes definir la versión generada permitida con la variable de entorno `BZLMOD_ALLOW_YANKED_VERSIONS`. Puedes inhabilitar esta verificación con la palabra clave “todo” (no se recomienda).
Etiquetas: loading_and_analysis
Valor predeterminado de --check_bazel_compatibility=<error, warning or off>: "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 caso 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: "advertencia"
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 derivarla a una falla de resolución.
Etiquetas: loading_and_analysis
Valor predeterminado de --[no]ignore_dev_dependency: "falso"
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en 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
Valor predeterminado de --lockfile_mode=<off, update or error>: "actualizar"
Especifica cómo y si se debe usar o no 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 arroja un error si no está actualizado, o "off" para que no se lea ni escriba en el archivo de bloqueo.
Etiquetas: loading_and_analysis
Se acumulan --override_module=<an equals-separated mapping of module name to path> usos múltiples
Anula un módulo con una ruta de acceso local en el formato <module name>=<path>. Si la ruta de acceso dada es una ruta de acceso absoluta, se usará tal como es. Si la ruta de acceso determinada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso dada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace"
Se acumulan --registry=<a string> usos múltiples
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en registros anteriores y solo se recurrirán a los registros posteriores cuando no estén en los registros anteriores.
Etiquetas: changes_inputs
.
Opciones que activan optimizaciones del tiempo de compilación:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>> predeterminado: "1s:2,20s:3,1m:5"
Límites que, si se alcanzan, hacen que GcThrashingDetector bloquee Bazel con una OOM. Cada límite se especifica como <period>:<count> En el ejemplo anterior, el período es una duración y el recuento es un número entero positivo. Si hay más de --gc_thrashing_threshold por ciento de espacio titular (montón de generación anterior) permanece ocupado después de <count> recolecciones de elementos no utilizados consecutivos en <period>, se activará una OOM. Si hay varios límites, puedes separarlos por comas.
Etiquetas: host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0> predeterminado: “2147483647”
Marca de configuración avanzada del motor interno Skyframe de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de recolección de elementos no utilizados completa, eliminará el estado temporal de Skyframe innecesario, hasta esta cantidad de veces por invocación. La configuración predeterminada es Integer.MAX_VALUE; eficazmente ilimitados. Cero significa que los eventos de recolección de elementos no utilizados completas nunca activarán la acción de soltar. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC completo y se supere ese umbral de porcentaje de montón retenido.
Etiquetas: host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0> predeterminado: “2147483647”
Marca de configuración avanzada del motor interno Skyframe de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando ocurra un evento menor de recolección de elementos no utilizados, se eliminará el estado temporal de Skyframe innecesario, hasta esta cantidad de veces por invocación. La configuración predeterminada es Integer.MAX_VALUE; eficazmente ilimitados. Cero significa que los eventos menores de recolección de elementos no utilizados nunca activarán la acción de soltar. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC menor y se supere ese umbral de porcentaje de montón retenido.
Etiquetas: host_machine_resource_optimizations
Valor predeterminado de --skyframe_high_water_mark_threshold=<an integer>: "85"
Marca de configuración avanzada del motor interno Skyframe de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es al menos este umbral, descartará el estado temporal de Skyframe innecesario. Ajustar esto puede permitirte mitigar el impacto en el tiempo de la hiperpaginación de GC cuando la hiperpaginación de GC (i) es causada por el uso de memoria de este estado temporal y (ii) es más costosa que reconstituir el estado cuando sea necesario.
Etiquetas: host_machine_resource_optimizations
.
Opciones que afectan la verbosidad, el formato o la ubicación del registro:
Valor predeterminado de --[no]experimental_command_profile: "falso"
Registra un perfil de CPU de la grabadora de vuelos de Java en un archivo profile.jfr en el directorio base de salida. La sintaxis y la semántica de esta marca podrían cambiar en el futuro para admitir diferentes tipos de perfil o formatos de salida. usar bajo tu propia responsabilidad.
Valor predeterminado de --[no]experimental_record_metrics_for_all_mnemonics: "falso"
De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemónicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán las estadísticas de todos los mnemónicos.
Opciones que especifican o modifican una entrada genérica para un comando de Bazel que no se encuentra 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: "compilación"
Es el comando para el que se deben canonicalizar las opciones.
Etiquetas: affects_outputs y terminal_output
Valor predeterminado de --invocation_policy=<a string>: ""
Aplica una política de invocación a las opciones que se van a canonicalizar.
Etiquetas: affects_outputs y terminal_output
Opciones de ejecución y almacenamiento en caché remoto:
Valor predeterminado de --experimental_downloader_config=<a string>: ver descripción
Especifica un archivo con el que se configurará el cargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguidas de un nombre de host (para "allow" y "block") o dos patrones, uno para buscar coincidencias y otro para usar como URL sustituta, con referencias inversas a partir de `$1`. Es posible proporcionar varias directivas "rewrite" para la misma URL; en este caso, se devolverán varias URL.
Configuración predeterminada de --experimental_worker_for_repo_fetching=<off, platform or virtual>: "desactivada"
El modo de subprocesos que se usará para la recuperación del repositorio. Si se configura en “off”, no se usa ningún subproceso de trabajo y la recuperación del repositorio está sujeta a reinicios. De lo contrario, utiliza un subproceso de plataforma (es decir, un subproceso del SO) si está configurado como "platform". o un subproceso virtual si está configurado como “virtual”.
Otras opciones, que no se categorizan de ninguna otra manera:
Se acumulan --deleted_packages=<comma-separated list of package names> usos múltiples
Una lista separada por comas de los nombres de los paquetes que el sistema de compilación considerará inexistentes, incluso si están visibles en alguna parte de la ruta del paquete. Usa esta opción cuando borres un subpaquete "x/y" de un paquete 'x' existente. Por ejemplo, después de borrar x/y/BUILD en tu cliente, el sistema de compilación puede presentar un reclamo si encuentra la etiqueta “//x:y/z”. si aún lo proporciona otra entrada package_path. Especificar --deleted_packages x/y evita este problema.
Se acumulan --override_repository=<an equals-separated mapping of repository name to path> usos múltiples
Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso dada es una ruta de acceso absoluta, se usará tal como es. Si la ruta de acceso determinada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso dada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace"
--package_path=<colon-separated list of options> predeterminado: “%workspace%”
Una lista separada por dos puntos de dónde buscar paquetes Elementos que comienzan con “%workspace%” están relacionadas con el 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”.
Valor predeterminado de --[no]show_loading_progress: "true"
Si se habilita, hace que Bazel imprima el mensaje "Loading package:" (Cargando paquete): mensajes nuevos.

Opciones de limpieza

Hereda todas las opciones de build.

Opciones que aparecen antes del comando y que el cliente analiza:
Se acumulan --distdir=<a path> usos múltiples
Lugares adicionales para buscar archivos antes de acceder a la red y descargarlos.
Etiquetas: bazel_internal_configuration
Si se configura, la caché del repositorio vinculará el archivo en lugar de copiarlo en caso de que se produzca un acierto de caché. Esto está diseñado para ahorrar espacio en el disco.
Etiquetas: bazel_internal_configuration
Valor predeterminado de --experimental_repository_downloader_retries=<an integer>: "0"
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> valor 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 esperado por el autor de la regla, sin cambiar el código fuente.
Etiquetas: bazel_internal_configuration y experimental
Valor predeterminado de --http_connector_attempts=<an integer>: "8"
La cantidad máxima de intentos para descargas http.
Etiquetas: bazel_internal_configuration
Valor predeterminado de --http_connector_retry_max_timeout=<An immutable length of time.>: "0s"
El tiempo de espera máximo para los reintentos de descarga de HTTP. Con un valor de 0, no se define ningún tiempo de espera máximo.
Etiquetas: bazel_internal_configuration
--http_timeout_scaling=<a double> valor predeterminado: "1.0"
Escalar todos los tiempos de espera relacionados con las descargas HTTP según el factor determinado
Etiquetas: bazel_internal_configuration
Valor predeterminado de --repository_cache=<a path>: ver descripción
Especifica la ubicación de caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché; de lo contrario, el valor predeterminado es '<output_user_root>/cache/repos/v1'. se usa
Etiquetas: bazel_internal_configuration
Valor predeterminado de --[no]repository_disable_download: "falso"
Si se configura, no se permite la descarga con ctx.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no está completamente inhabilitado. ctx.execute aún podría ejecutar un ejecutable arbitrario que acceda a Internet.
Etiquetas: bazel_internal_configuration
.
Opciones que controlan la ejecución de compilación:
Valor predeterminado de --gc_thrashing_threshold=<an integer in 0-100 range>: "100"
El porcentaje del espacio permanente ocupado (0-100) por encima del cual GcThrashingDetector considera eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, GcThrashingDetector está inhabilitado.
Etiquetas: host_machine_resource_optimizations
.
Opciones que controlan el resultado del comando:
Valor predeterminado de --[no]async: "falso"
Si es verdadero, la limpieza de resultados es asíncrona. Cuando se complete este comando, será seguro ejecutar comandos nuevos en el mismo cliente, aunque la eliminación pueda continuar en segundo plano.
Etiquetas: host_machine_resource_optimizations
Valor predeterminado de --[no]expunge: "falso"
Si es verdadero, clean quita todo el árbol de trabajo de esta instancia de Bazel, que incluye todos los archivos de salida temporales y 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 para esta instancia de Bazel, que incluye todos los archivos de salida temporales y 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 pueda continuar en segundo plano.
Se expande a:
--expunge
--async

Etiquetas: host_machine_resource_optimizations
Opciones relacionadas con la salida y la semántica de Bzlmod:
Se acumulan --allow_yanked_versions=<a string> usos múltiples
Se especificaron las versiones de los módulos con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resueltas, incluso si se declaran como eliminadas en el registro del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones rechazadas harán que la resolución falle. También puedes definir la versión generada permitida con la variable de entorno `BZLMOD_ALLOW_YANKED_VERSIONS`. Puedes inhabilitar esta verificación con la palabra clave “todo” (no se recomienda).
Etiquetas: loading_and_analysis
Valor predeterminado de --check_bazel_compatibility=<error, warning or off>: "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 caso 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: "advertencia"
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 derivarla a una falla de resolución.
Etiquetas: loading_and_analysis
Valor predeterminado de --[no]ignore_dev_dependency: "falso"
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en 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
Valor predeterminado de --lockfile_mode=<off, update or error>: "actualizar"
Especifica cómo y si se debe usar o no 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 arroja un error si no está actualizado, o "off" para que no se lea ni escriba en el archivo de bloqueo.
Etiquetas: loading_and_analysis
Se acumulan --override_module=<an equals-separated mapping of module name to path> usos múltiples
Anula un módulo con una ruta de acceso local en el formato <module name>=<path>. Si la ruta de acceso dada es una ruta de acceso absoluta, se usará tal como es. Si la ruta de acceso determinada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso dada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace"
Se acumulan --registry=<a string> usos múltiples
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en registros anteriores y solo se recurrirán a los registros posteriores cuando no estén en los registros anteriores.
Etiquetas: changes_inputs
.
Opciones que activan optimizaciones del tiempo de compilación:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>> predeterminado: "1s:2,20s:3,1m:5"
Límites que, si se alcanzan, hacen que GcThrashingDetector bloquee Bazel con una OOM. Cada límite se especifica como <period>:<count> En el ejemplo anterior, el período es una duración y el recuento es un número entero positivo. Si hay más de --gc_thrashing_threshold por ciento de espacio titular (montón de generación anterior) permanece ocupado después de <count> recolecciones de elementos no utilizados consecutivos en <period>, se activará una OOM. Si hay varios límites, puedes separarlos por comas.
Etiquetas: host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0> predeterminado: “2147483647”
Marca de configuración avanzada del motor interno Skyframe de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de recolección de elementos no utilizados completa, eliminará el estado temporal de Skyframe innecesario, hasta esta cantidad de veces por invocación. La configuración predeterminada es Integer.MAX_VALUE; eficazmente ilimitados. Cero significa que los eventos de recolección de elementos no utilizados completas nunca activarán la acción de soltar. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC completo y se supere ese umbral de porcentaje de montón retenido.
Etiquetas: host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0> predeterminado: “2147483647”
Marca de configuración avanzada del motor interno Skyframe de Bazel. Si Bazel detecta que el uso porcentual retenido del montón supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando ocurra un evento menor de recolección de elementos no utilizados, se eliminará el estado temporal de Skyframe innecesario, hasta esta cantidad de veces por invocación. La configuración predeterminada es Integer.MAX_VALUE; eficazmente ilimitados. Cero significa que los eventos menores de recolección de elementos no utilizados nunca activarán la acción de soltar. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC menor y se supere ese umbral de porcentaje de montón retenido.
Etiquetas: host_machine_resource_optimizations
Valor predeterminado de --skyframe_high_water_mark_threshold=<an integer>: "85"
Marca de configuración avanzada del motor interno Skyframe de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es al menos este umbral, descartará el estado temporal de Skyframe innecesario. Ajustar esto puede permitirte mitigar el impacto en el tiempo de la hiperpaginación de GC cuando la hiperpaginación de GC (i) es causada por el uso de memoria de este estado temporal y (ii) es más costosa que reconstituir el estado cuando sea necesario.
Etiquetas: host_machine_resource_optimizations
.
Opciones que afectan la verbosidad, el formato o la ubicación del registro:
Valor predeterminado de --[no]experimental_command_profile: "falso"
Registra un perfil de CPU de la grabadora de vuelos de Java en un archivo profile.jfr en el directorio base de salida. La sintaxis y la semántica de esta marca podrían cambiar en el futuro para admitir diferentes tipos de perfil o formatos de salida. usar bajo tu propia responsabilidad.
Valor predeterminado de --[no]experimental_record_metrics_for_all_mnemonics: "falso"
De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemónicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán las estadísticas de todos los mnemónicos.
Opciones que especifican o modifican una entrada genérica para un comando de Bazel que no se encuentra 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é remoto:
Valor predeterminado de --experimental_downloader_config=<a string>: ver descripción
Especifica un archivo con el que se configurará el cargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguidas de un nombre de host (para "allow" y "block") o dos patrones, uno para buscar coincidencias y otro para usar como URL sustituta, con referencias inversas a partir de `$1`. Es posible proporcionar varias directivas "rewrite" para la misma URL; en este caso, se devolverán varias URL.
Configuración predeterminada de --experimental_worker_for_repo_fetching=<off, platform or virtual>: "desactivada"
El modo de subprocesos que se usará para la recuperación del repositorio. Si se configura en “off”, no se usa ningún subproceso de trabajo y la recuperación del repositorio está sujeta a reinicios. De lo contrario, utiliza un subproceso de plataforma (es decir, un subproceso del SO) si está configurado como "platform". o un subproceso virtual si está configurado como “virtual”.
Otras opciones, que no se categorizan de ninguna otra manera:
Se acumulan --override_repository=<an equals-separated mapping of repository name to path> usos múltiples
Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso dada es una ruta de acceso absoluta, se usará tal como es. Si la ruta de acceso determinada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso dada comienza con "%workspace%", es relativa a la raíz del lugar 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 --distdir=<a path> usos múltiples
Lugares adicionales para buscar archivos antes de acceder a la red y descargarlos.
Etiquetas: bazel_internal_configuration
Si se configura, la caché del repositorio vinculará el archivo en lugar de copiarlo en caso de que se produzca un acierto de caché. Esto está diseñado para ahorrar espacio en el disco.
Etiquetas: bazel_internal_configuration
Valor predeterminado de --experimental_repository_downloader_retries=<an integer>: "0"
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> valor 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 esperado por el autor de la regla, sin cambiar el código fuente.
Etiquetas: bazel_internal_configuration y experimental
Valor predeterminado de --http_connector_attempts=<an integer>: "8"
La cantidad máxima de intentos para descargas http.
Etiquetas: bazel_internal_configuration
Valor predeterminado de --http_connector_retry_max_timeout=<An immutable length of time.>: "0s"
El tiempo de espera máximo para los reintentos de descarga de HTTP. Con un valor de 0, no se define ningún tiempo de espera máximo.
Etiquetas: bazel_internal_configuration
--http_timeout_scaling=<a double> valor predeterminado: "1.0"
Escalar todos los tiempos de espera relacionados con las descargas HTTP según el factor determinado
Etiquetas: bazel_internal_configuration
Valor predeterminado de --repository_cache=<a path>: ver descripción
Especifica la ubicación de caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché; de lo contrario, el valor predeterminado es '<output_user_root>/cache/repos/v1'. se usa
Etiquetas: bazel_internal_configuration
Valor predeterminado de --[no]repository_disable_download: "falso"
Si se configura, no se permite la descarga con ctx.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no está completamente inhabilitado. ctx.execute aún podría ejecutar un ejecutable arbitrario que acceda a Internet.
Etiquetas: bazel_internal_configuration
.
Opciones que controlan la ejecución de compilación:
Valor predeterminado de --gc_thrashing_threshold=<an integer in 0-100 range>: "100"
El porcentaje del espacio permanente ocupado (0-100) por encima del cual GcThrashingDetector considera eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, GcThrashingDetector está inhabilitado.
Etiquetas: host_machine_resource_optimizations
.
Opciones relacionadas con la salida y la semántica de Bzlmod:
Se acumulan --allow_yanked_versions=<a string> usos múltiples
Se especificaron las versiones de los módulos con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resueltas, incluso si se declaran como eliminadas en el registro del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones rechazadas harán que la resolución falle. También puedes definir la versión generada permitida con la variable de entorno `BZLMOD_ALLOW_YANKED_VERSIONS`. Puedes inhabilitar esta verificación con la palabra clave “todo” (no se recomienda).
Etiquetas: loading_and_analysis
Valor predeterminado de --check_bazel_compatibility=<error, warning or off>: "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 caso 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: "advertencia"
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 derivarla a una falla de resolución.
Etiquetas: loading_and_analysis
Valor predeterminado de --[no]ignore_dev_dependency: "falso"
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en 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
Valor predeterminado de --lockfile_mode=<off, update or error>: "actualizar"
Especifica cómo y si se debe usar o no 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 arroja un error si no está actualizado, o "off" para que no se lea ni escriba en el archivo de bloqueo.
Etiquetas: loading_and_analysis
Se acumulan --override_module=<an equals-separated mapping of module name to path> usos múltiples
Anula un módulo con una ruta de acceso local en el formato <module name>=<path>. Si la ruta de acceso dada es una ruta de acceso absoluta, se usará tal como es. Si la ruta de acceso determinada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso dada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace"
Se acumulan --registry=<a string> usos múltiples
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en registros anteriores y solo se recurrirán a los registros posteriores cuando no estén en los registros anteriores.
Etiquetas: changes_inputs
.
Opciones que activan optimizaciones del tiempo de compilación:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>> predeterminado: "1s:2,20s:3,1m:5"
Límites que, si se alcanzan, hacen que GcThrashingDetector bloquee Bazel con una OOM. Cada límite se especifica como <period>:<count> En el ejemplo anterior, el período es una duración y el recuento es un número entero positivo. Si hay más de --gc_thrashing_threshold por ciento de espacio titular (montón de generación anterior) permanece ocupado después de <count> recolecciones de elementos no utilizados consecutivos en <period>, se activará una OOM. Si hay varios límites, puedes separarlos por comas.
Etiquetas: host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0> predeterminado: “2147483647”
Marca de configuración avanzada del motor interno Skyframe de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de recolección de elementos no utilizados completa, eliminará el estado temporal de Skyframe innecesario, hasta esta cantidad de veces por invocación. La configuración predeterminada es Integer.MAX_VALUE; eficazmente ilimitados. Cero significa que los eventos de recolección de elementos no utilizados completas nunca activarán la acción de soltar. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC completo y se supere ese umbral de porcentaje de montón retenido.
Etiquetas: host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0> predeterminado: “2147483647”
Marca de configuración avanzada del motor interno Skyframe de Bazel. Si Bazel detecta que el uso porcentual retenido del montón supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando ocurra un evento menor de recolección de elementos no utilizados, se eliminará el estado temporal de Skyframe innecesario, hasta esta cantidad de veces por invocación. La configuración predeterminada es Integer.MAX_VALUE; eficazmente ilimitados. Cero significa que los eventos menores de recolección de elementos no utilizados nunca activarán la acción de soltar. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC menor y se supere ese umbral de porcentaje de montón retenido.
Etiquetas: host_machine_resource_optimizations
Valor predeterminado de --skyframe_high_water_mark_threshold=<an integer>: "85"
Marca de configuración avanzada del motor interno Skyframe de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es al menos este umbral, descartará el estado temporal de Skyframe innecesario. Ajustar esto puede permitirte mitigar el impacto en el tiempo de la hiperpaginación de GC cuando la hiperpaginación de GC (i) es causada por el uso de memoria de este estado temporal y (ii) es más costosa que reconstituir el estado cuando sea necesario.
Etiquetas: host_machine_resource_optimizations
.
Opciones que afectan la verbosidad, el formato o la ubicación del registro:
Valor predeterminado de --[no]experimental_command_profile: "falso"
Registra un perfil de CPU de la grabadora de vuelos de Java en un archivo profile.jfr en el directorio base de salida. La sintaxis y la semántica de esta marca podrían cambiar en el futuro para admitir diferentes tipos de perfil o formatos de salida. usar bajo tu propia responsabilidad.
Valor predeterminado de --[no]experimental_record_metrics_for_all_mnemonics: "falso"
De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemónicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán las estadísticas de todos los mnemónicos.
Opciones que especifican o modifican una entrada genérica para un comando de Bazel que no se encuentra 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é remoto:
Valor predeterminado de --experimental_downloader_config=<a string>: ver descripción
Especifica un archivo con el que se configurará el cargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguidas de un nombre de host (para "allow" y "block") o dos patrones, uno para buscar coincidencias y otro para usar como URL sustituta, con referencias inversas a partir de `$1`. Es posible proporcionar varias directivas "rewrite" para la misma URL; en este caso, se devolverán varias URL.
Configuración predeterminada de --experimental_worker_for_repo_fetching=<off, platform or virtual>: "desactivada"
El modo de subprocesos que se usará para la recuperación del repositorio. Si se configura en “off”, no se usa ningún subproceso de trabajo y la recuperación del repositorio está sujeta a reinicios. De lo contrario, utiliza un subproceso de plataforma (es decir, un subproceso del SO) si está configurado como "platform". o un subproceso virtual si está configurado como “virtual”.
Otras opciones, que no se categorizan de ninguna otra manera:
Se acumulan --override_repository=<an equals-separated mapping of repository name to path> usos múltiples
Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso dada es una ruta de acceso absoluta, se usará tal como es. Si la ruta de acceso determinada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso dada comienza con "%workspace%", es relativa a la raíz del lugar 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 --distdir=<a path> usos múltiples
Lugares adicionales para buscar archivos antes de acceder a la red y descargarlos.
Etiquetas: bazel_internal_configuration
Si se configura, la caché del repositorio vinculará el archivo en lugar de copiarlo en caso de que se produzca un acierto de caché. Esto está diseñado para ahorrar espacio en el disco.
Etiquetas: bazel_internal_configuration
Valor predeterminado de --experimental_repository_downloader_retries=<an integer>: "0"
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> valor 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 esperado por el autor de la regla, sin cambiar el código fuente.
Etiquetas: bazel_internal_configuration y experimental
Valor predeterminado de --http_connector_attempts=<an integer>: "8"
La cantidad máxima de intentos para descargas http.
Etiquetas: bazel_internal_configuration
Valor predeterminado de --http_connector_retry_max_timeout=<An immutable length of time.>: "0s"
El tiempo de espera máximo para los reintentos de descarga de HTTP. Con un valor de 0, no se define ningún tiempo de espera máximo.
Etiquetas: bazel_internal_configuration
--http_timeout_scaling=<a double> valor predeterminado: "1.0"
Escalar todos los tiempos de espera relacionados con las descargas HTTP según el factor determinado
Etiquetas: bazel_internal_configuration
Valor predeterminado de --repository_cache=<a path>: ver descripción
Especifica la ubicación de caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché; de lo contrario, el valor predeterminado es '<output_user_root>/cache/repos/v1'. se usa
Etiquetas: bazel_internal_configuration
Valor predeterminado de --[no]repository_disable_download: "falso"
Si se configura, no se permite la descarga con ctx.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no está completamente inhabilitado. ctx.execute aún podría ejecutar un ejecutable arbitrario que acceda a Internet.
Etiquetas: bazel_internal_configuration
.
Opciones que controlan la ejecución de compilación:
Valor predeterminado de --gc_thrashing_threshold=<an integer in 0-100 range>: "100"
El porcentaje del espacio permanente ocupado (0-100) por encima del cual GcThrashingDetector considera eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, GcThrashingDetector está inhabilitado.
Etiquetas: host_machine_resource_optimizations
.
Opciones relacionadas con el resultado de la consulta y la semántica:
--aspect_deps=<off, conservative or precise> predeterminado: “conservadora”
Cómo resolver dependencias de aspecto cuando el formato de salida es {xml,proto,record}. "desactivado" significa que no se resuelven dependencias de aspecto, “conservadora” (predeterminado) significa que todas las dependencias de aspecto declaradas se agregan independientemente de si se les da la clase de regla de dependencias directas, “precisa”. significa que solo se agregan los 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. Además, ten en cuenta que incluso el modo preciso no es del todo preciso: la decisión de calcular un aspecto se decide en la fase de análisis, que no se ejecuta durante la “consulta de Bazel”.
Etiquetas: build_file_semantics
Valor predeterminado de --[no]consistent_labels: "falso"
Si se habilita, cada comando de consulta emite etiquetas como si <code>str</code> de Starlark función aplicada a una <code>etiqueta</code> instancia. Esto resulta útil para las herramientas que necesitan hacer coincidir el resultado de diferentes comandos de consulta o etiquetas emitidas por las reglas. Si no se habilita, los formateadores de salida pueden emitir nombres de repositorio aparentes (en relación con el repositorio principal) en lugar de hacer que el resultado sea más legible.
Etiquetas: terminal_output
Valor predeterminado de --[no]graph:factored: "true"
Si es verdadero, el grafo 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> predeterminado: "512"
La longitud máxima de la cadena de etiqueta para un nodo del grafo en el resultado. Las etiquetas más largas se truncarán. -1 significa que no hay truncamiento. Esta opción solo se aplica a --output=graph.
Etiquetas: terminal_output
Valor predeterminado de --[no]implicit_deps: "true"
Si se habilita, las dependencias implícitas se incluirán en el gráfico de dependencias sobre el que opera la consulta. Una dependencia implícita es una que no se especifica de forma explícita en el archivo BUILD, pero la agrega Bazel. En el caso de cquery, esta opción controla el filtrado de cadenas de herramientas resueltas.
Etiquetas: build_file_semantics
Valor predeterminado de --[no]include_aspects: "true"
aquery, cquery: Se incluyen acciones generadas por aspectos en el resultado. consulta: no-op (siempre se siguen los aspectos).
Etiquetas: terminal_output
Valor predeterminado de --[no]incompatible_package_group_includes_double_slash: "true"
Si se habilita esta opción, cuando se genere el atributo `packages` de package_group, no se omitirá el `//` inicial.
Etiquetas: terminal_output y incompatible_change
Valor predeterminado de --[no]infer_universe_scope: "falso"
Si no se establece ni --universe_scope, se inferirá un valor de --universe_scope como la lista de patrones de destino únicos en la expresión de consulta. Ten en cuenta que es posible que el valor --universe_scope inferido para una expresión de consulta que usa funciones con alcance universal (p.ej., `allrdeps`) no sea lo que quieres, por lo que debes usar esta opción solo si sabes lo que estás haciendo. Consulta https://bazel.build/reference/query#sky-query para obtener detalles y ejemplos. Si se configura --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
Valor predeterminado de --[no]line_terminator_null: "falso"
Indica si cada formato termina con \0 en lugar de un salto de línea.
Etiquetas: terminal_output
Valor predeterminado de --[no]nodep_deps: "true"
Si está habilitada, las dependencias de “nodep” atributos se incluirán en el gráfico de la dependencia en el que opera la consulta. Un ejemplo común de un “nodep” es “visibilidad”. Ejecuta y analiza el resultado de `info build-language` para conocer todos los “nodep” atributos en el lenguaje de compilación.
Etiquetas: build_file_semantics
--output=<a string> predeterminado: "etiqueta"
El formato en el que se deben imprimir los resultados de cquery. Los valores permitidos para cquery son los siguientes: label, label_kind, textproto,Transitions, proto, streaming_proto y jsonproto. Si seleccionas "transiciones", también debes especificar la opción --transitions=(lite|full).
Etiquetas: terminal_output
Valor predeterminado de --[no]proto:default_values: "true"
Si es verdadero, se incluirán los atributos cuyo valor no se especifica explícitamente en el archivo BUILD. de lo contrario, se omitirán. Esta opción se aplica a --output=proto
Etiquetas: terminal_output
Valor predeterminado de --[no]proto:definition_stack: "falso"
Propaga el campo de proto definition_stack, que registra la pila de llamadas de Starlark para cada instancia de la regla en el momento en que se definió la clase de la regla.
Etiquetas: terminal_output
Valor predeterminado de --[no]proto:flatten_selects: "true"
Si se habilita, se acoplan los atributos configurables creados por select(). Para los tipos de lista, la representación plana es una lista que contiene cada valor del mapa de selección exactamente una vez. Los tipos escalares se acoplan a nulos.
Etiquetas: build_file_semantics
Valor predeterminado de --[no]proto:include_attribute_source_aspects: "falso"
Propaga el campo de protocolo source_aspect_name de cada atributo con el aspecto de origen del que provino (cadena vacía si no es así).
Etiquetas: terminal_output
Valor predeterminado de --[no]proto:include_configurations: "true"
si está habilitado, el resultado del protocolo incluirá información sobre la configuración. Cuando está inhabilitado,el formato de salida de cquery proto se asemeja al formato de salida de la consulta.
Etiquetas: affects_outputs
Valor predeterminado de --[no]proto:include_synthetic_attribute_hash: "falso"
Indica si se debe calcular y propagar el atributo $internal_attr_hash.
Etiquetas: terminal_output
Valor predeterminado de --[no]proto:instantiation_stack: "falso"
Propaga la pila de llamadas de creación de instancias de cada regla. Ten en cuenta que esto requiere que la pila esté presente
Etiquetas: terminal_output
Valor predeterminado de --[no]proto:locations: "true"
Establece si se debe emitir información de ubicación en el resultado de proto.
Etiquetas: terminal_output
--proto:output_rule_attrs=<comma-separated list of options> predeterminado: "todos"
Lista de atributos separados por comas para incluir en el resultado. La configuración predeterminada es todos los atributos. Se configura como una cadena vacía para no generar ningún atributo. Esta opción se aplica a --output=proto.
Etiquetas: terminal_output
Valor predeterminado de --[no]proto:rule_inputs_and_outputs: "true"
Indica si se deben completar o no 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 desde el archivo que se nombra aquí, en lugar de hacerlo en la línea de comandos. Es un error especificar aquí un archivo así como una consulta de línea de comandos.
Etiquetas: changes_inputs
Valor predeterminado de --[no]relative_locations: "falso"
Si es verdadero, la ubicación de los archivos Build en los resultados xml y proto será relativa. De forma predeterminada, el resultado de la ubicación es una ruta de acceso absoluta y no será coherente en todas las máquinas. Puedes configurar esta opción como verdadera para obtener un resultado coherente en todas las máquinas.
Etiquetas: terminal_output
Configuración predeterminada de --show_config_fragments=<off, direct or transitive>: "desactivada"
Muestra los fragmentos de configuración que requiere una regla y sus dependencias transitivas. Esto puede ser útil para evaluar cuánto se puede recortar un gráfico de destino configurado.
Etiquetas: affects_outputs
Valor predeterminado de --starlark:expr=<a string>: ""
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 "target". Si no se especifica --starlark:expr ni --starlark:file, la opción predeterminada será 'str(target.label)'. Es un error especificar --starlark:expr y --starlark:file.
Etiquetas: terminal_output
Valor predeterminado de --starlark:file=<a string>: ""
El 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 --starlark:expr y --starlark:file. Consulta la ayuda de --output=starlark para obtener más detalles.
Etiquetas: terminal_output
Valor predeterminado de --[no]tool_deps: "true"
Consulta: Si está inhabilitada, depende de “exec configuration” no se incluirán en el gráfico de la dependencia en el que opera la consulta. Una “configuración de ejecución” perímetro de dependencia, como el de cualquier "proto_library" al compilador de protocolos, por lo general, apunta a una herramienta ejecutada durante la compilación en lugar de a una parte del mismo “destino” . Cquery: Si se inhabilita, filtra todos los destinos configurados que cruzan una transición de ejecución del objetivo de nivel superior que descubrió este objetivo configurado. Esto significa que, si el destino de nivel superior se encuentra en la configuración de destino, solo se mostrarán los destinos configurados que se encuentren también en esa configuración. Si el destino de nivel superior está en la configuración de ejecución, solo se mostrarán los destinos configurados de ejecución. Esta opción NO excluirá las cadenas de herramientas resueltas.
Etiquetas: build_file_semantics
Valor predeterminado de --transitions=<full, lite or none>: "ninguno"
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>: ""
Un conjunto de patrones de destino separados por comas (aditivos y sustractivos). La consulta puede realizarse en el universo definido por el cierre transitivo de los objetivos especificados. Esta opción se usa para los comandos de consulta y cquery. Para cquery, la entrada de esta opción son los destinos en los que se crean todas las respuestas, por lo que esta opción puede afectar las configuraciones y transiciones. Si no se especifica esta opción, se supone que los objetivos de nivel superior son los objetivos analizados de la expresión de consulta. Nota: Para cquery, no especificar esta opción puede hacer que la compilación se rompa si los objetivos analizados desde la expresión de 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 --allow_yanked_versions=<a string> usos múltiples
Se especificaron las versiones de los módulos con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resueltas, incluso si se declaran como eliminadas en el registro del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones rechazadas harán que la resolución falle. También puedes definir la versión generada permitida con la variable de entorno `BZLMOD_ALLOW_YANKED_VERSIONS`. Puedes inhabilitar esta verificación con la palabra clave “todo” (no se recomienda).
Etiquetas: loading_and_analysis
Valor predeterminado de --check_bazel_compatibility=<error, warning or off>: "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 caso 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: "advertencia"
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 derivarla a una falla de resolución.
Etiquetas: loading_and_analysis
Valor predeterminado de --[no]ignore_dev_dependency: "falso"
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en 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
Valor predeterminado de --lockfile_mode=<off, update or error>: "actualizar"
Especifica cómo y si se debe usar o no 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 arroja un error si no está actualizado, o "off" para que no se lea ni escriba en el archivo de bloqueo.
Etiquetas: loading_and_analysis
Se acumulan --override_module=<an equals-separated mapping of module name to path> usos múltiples
Anula un módulo con una ruta de acceso local en el formato <module name>=<path>. Si la ruta de acceso dada es una ruta de acceso absoluta, se usará tal como es. Si la ruta de acceso determinada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso dada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace"
Se acumulan --registry=<a string> usos múltiples
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en registros anteriores y solo se recurrirán a los registros posteriores cuando no estén en los registros anteriores.
Etiquetas: changes_inputs
.
Opciones que activan optimizaciones del tiempo de compilación:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>> predeterminado: "1s:2,20s:3,1m:5"
Límites que, si se alcanzan, hacen que GcThrashingDetector bloquee Bazel con una OOM. Cada límite se especifica como <period>:<count> En el ejemplo anterior, el período es una duración y el recuento es un número entero positivo. Si hay más de --gc_thrashing_threshold por ciento de espacio titular (montón de generación anterior) permanece ocupado después de <count> recolecciones de elementos no utilizados consecutivos en <period>, se activará una OOM. Si hay varios límites, puedes separarlos por comas.
Etiquetas: host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0> predeterminado: “2147483647”
Marca de configuración avanzada del motor interno Skyframe de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de recolección de elementos no utilizados completa, eliminará el estado temporal de Skyframe innecesario, hasta esta cantidad de veces por invocación. La configuración predeterminada es Integer.MAX_VALUE; eficazmente ilimitados. Cero significa que los eventos de recolección de elementos no utilizados completas nunca activarán la acción de soltar. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC completo y se supere ese umbral de porcentaje de montón retenido.
Etiquetas: host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0> predeterminado: “2147483647”
Marca de configuración avanzada del motor interno Skyframe de Bazel. Si Bazel detecta que el uso porcentual retenido del montón supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando ocurra un evento menor de recolección de elementos no utilizados, se eliminará el estado temporal de Skyframe innecesario, hasta esta cantidad de veces por invocación. La configuración predeterminada es Integer.MAX_VALUE; eficazmente ilimitados. Cero significa que los eventos menores de recolección de elementos no utilizados nunca activarán la acción de soltar. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC menor y se supere ese umbral de porcentaje de montón retenido.
Etiquetas: host_machine_resource_optimizations
Valor predeterminado de --skyframe_high_water_mark_threshold=<an integer>: "85"
Marca de configuración avanzada del motor interno Skyframe de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es al menos este umbral, descartará el estado temporal de Skyframe innecesario. Ajustar esto puede permitirte mitigar el impacto en el tiempo de la hiperpaginación de GC cuando la hiperpaginación de GC (i) es causada por el uso de memoria de este estado temporal y (ii) es más costosa que reconstituir el estado cuando sea necesario.
Etiquetas: host_machine_resource_optimizations
.
Opciones que afectan la verbosidad, el formato o la ubicación del registro:
Valor predeterminado de --[no]experimental_command_profile: "falso"
Registra un perfil de CPU de la grabadora de vuelos de Java en un archivo profile.jfr en el directorio base de salida. La sintaxis y la semántica de esta marca podrían cambiar en el futuro para admitir diferentes tipos de perfil o formatos de salida. usar bajo tu propia responsabilidad.
Valor predeterminado de --[no]experimental_record_metrics_for_all_mnemonics: "falso"
De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemónicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán las estadísticas de todos los mnemónicos.
Opciones que especifican o modifican una entrada genérica para un comando de Bazel que no se encuentra 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é remoto:
Valor predeterminado de --experimental_downloader_config=<a string>: ver descripción
Especifica un archivo con el que se configurará el cargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguidas de un nombre de host (para "allow" y "block") o dos patrones, uno para buscar coincidencias y otro para usar como URL sustituta, con referencias inversas a partir de `$1`. Es posible proporcionar varias directivas "rewrite" para la misma URL; en este caso, se devolverán varias URL.
Configuración predeterminada de --experimental_worker_for_repo_fetching=<off, platform or virtual>: "desactivada"
El modo de subprocesos que se usará para la recuperación del repositorio. Si se configura en “off”, no se usa ningún subproceso de trabajo y la recuperación del repositorio está sujeta a reinicios. De lo contrario, utiliza un subproceso de plataforma (es decir, un subproceso del SO) si está configurado como "platform". o un subproceso virtual si está configurado como “virtual”.
Otras opciones, que no se categorizan de ninguna otra manera:
Se acumulan --override_repository=<an equals-separated mapping of repository name to path> usos múltiples
Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso dada es una ruta de acceso absoluta, se usará tal como es. Si la ruta de acceso determinada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso dada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace"
Opciones que controlan la ejecución de compilación:
Especifica si se deben realizar llamadas directas al sistema de archivos para crear árboles de symlinks.
Etiquetas: loading_and_analysis, execution y experimental
Valor predeterminado de --[no]experimental_persistent_aar_extractor: "falso"
Habilita el extractor de aar persistente con trabajadores.
Etiquetas: execution
Valor predeterminado de --[no]experimental_remotable_source_manifests: "falso"
Establece si las acciones del manifiesto de la fuente se pueden usar de forma remota.
Etiquetas: loading_and_analysis, execution y experimental
Valor predeterminado de --[no]experimental_split_coverage_postprocessing: "falso"
Si es verdadero, Bazel ejecutará el procesamiento posterior de cobertura para realizar pruebas en un generación nuevo.
Etiquetas: execution
Valor predeterminado de --[no]experimental_strict_fileset_output: "falso"
Si se habilita esta opción, los conjuntos de archivos tratarán todos los artefactos de salida como archivos normales. No desviarán directorios ni serán sensibles a los symlinks.
Etiquetas: execution
Valor predeterminado de --modify_execution_info=<regex=[+-]key,regex=[+-]key,...>: ""
Agrega o quita teclas de la información de ejecución de una acción según el nombre nemotécnico 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 regex pueden aplicarse al mismo nombre nemotécnico. Sintaxis: “regex=[+-]key,regex=[+-]key,...”. Ejemplos: '.*=+x,.*=-y,.*=+z' agrega una 'x' y en "z" a y quita "y" de la información de ejecución de todas las acciones. 'Genrule=+requires-x' agrega “requiere-x” a la información de ejecución de todas las acciones de Genrule. “(?!Genrule).*=-required-x” quita “requiere-x” a partir de la información de ejecución para todas las acciones que no son de Genrule.
Etiquetas: execution, affects_outputs y loading_and_analysis
--persistent_android_dex_desugar
Habilita acciones persistentes de dex y expansión de sintaxis de Android mediante trabajadores.
Se expande a:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker

Etiquetas: host_machine_resource_optimizations y execution
--persistent_android_resource_processor
Habilita el procesador de recursos persistente de Android con trabajadores.
Se expande a:
--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

de --strategy=AndroidResourceMerger=worker
de --strategy=AndroidCompiledResourceMerger=worker
de --strategy=ManifestMerger=worker --strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker

de --strategy=AARGenerator=worker
de --strategy=ProcessDatabinding=worker
de --strategy=GenerateDataBindingBaseClasses=worker
Etiquetas: host_machine_resource_optimizations y execution
--persistent_multiplex_android_dex_desugar
Habilita acciones persistentes de dex y desugar de Android multiplexadas usando trabajadores.
Se expande a:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar

Etiquetas: host_machine_resource_optimizations y execution
--persistent_multiplex_android_resource_processor
Habilita el procesador de recursos multiplexados de Android persistente con trabajadores.
Se expande a:
--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

de --modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
de --modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
de --modify_execution_info=ManifestMerger=+supports-multiplex-workers --modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers

de --modify_execution_info=AARGenerator=+supports-multiplex-workers
Etiquetas: host_machine_resource_optimizations y execution
--persistent_multiplex_android_tools
Habilita herramientas de Android persistentes y multiplexadas (dexing, expansión de sintaxis y 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 y execution
Valor predeterminado de --[no]use_target_platform_for_tests: "falso"
Si es verdadero, Bazel usará la plataforma de destino para ejecutar pruebas en lugar del grupo de ejecución de pruebas.
Etiquetas: execution
.
Opciones que configuran la cadena de herramientas utilizada para la ejecución de la acción:
Valor predeterminado de --android_compiler=<a string>: ver descripción
El compilador de destino de Android.
Etiquetas: affects_outputs, loading_and_analysis y loses_incremental_state
--android_crosstool_top=<a build target label> predeterminado: "//external:android/crosstool"
La ubicación del compilador C++ que se usa para las compilaciones de Android.
Etiquetas: affects_outputs, changes_inputs, loading_and_analysis y loses_incremental_state
Valor predeterminado de --android_grte_top=<a label>: ver descripción
El objetivo de Android grte_top.
Etiquetas: changes_inputs, loading_and_analysis y loses_incremental_state
--android_manifest_merger=<legacy, android or force_android> predeterminado: "android"
Selecciona la combinación de manifiestos que se usará para las reglas android_binary. Marca para ayudar a la transición de la combinación de manifiestos de Android desde la combinación heredada.
Etiquetas: affects_outputs, loading_and_analysis y loses_incremental_state
Valor predeterminado de --android_platforms=<a build target label>: ""
Establece las plataformas que usan los objetivos android_binary. Si se especifican varias plataformas, el objeto binario es un APK multiarquitectura, que contiene binarios nativos para cada plataforma de destino especificada.
Etiquetas: changes_inputs, loading_and_analysis y loses_incremental_state
--android_sdk=<a build target label> predeterminado: "@bazel_tools//tools/android:sdk"
Especifica el SDK o la plataforma de Android que se usa para compilar aplicaciones para Android.
Etiquetas: changes_inputs, loading_and_analysis y loses_incremental_state
--apple_crosstool_top=<a build target label> predeterminado: “@bazel_tools//tools/cpp:toolchain”
La etiqueta del paquete de herramientas cruzadas que se usará en las reglas de Apple y Objc y sus dependencias.
Etiquetas: loses_incremental_state y changes_inputs
Valor predeterminado de --cc_output_directory_tag=<a string>: ""
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas: affects_outputs
Valor predeterminado de --compiler=<a string>: ver descripción
El compilador de C++ que se usará para compilar el destino.
Etiquetas: loading_and_analysis y execution
--coverage_output_generator=<a build target label> predeterminado: "@bazel_tools//tools/test:lcov_merger"
Ubicación del objeto binario que se usa para procesar posteriormente los informes de cobertura sin procesar. Actualmente, debe ser un grupo de archivos que contenga un solo archivo: el objeto binario. La configuración predeterminada es “//tools/test:lcov_merger”.
Etiquetas: changes_inputs, affects_outputs y loading_and_analysis
--coverage_report_generator=<a build target label> predeterminado: “@bazel_tools//tools/test:coverage_report_generator”
Ubicación del objeto binario que se usa para generar informes de cobertura. Actualmente, debe ser un grupo de archivos que contenga un solo archivo: el objeto binario. La configuración predeterminada es “//tools/test:coverage_report_generator”.
Etiquetas: changes_inputs, affects_outputs y loading_and_analysis
--coverage_support=<a build target label> predeterminado: "@bazel_tools//tools/test:coverage_support"
Ubicación de los archivos de compatibilidad que se requieren en las entradas de cada acción de prueba que recopila la cobertura de código. La configuración predeterminada es “//tools/test:coverage_support”.
Etiquetas: changes_inputs, affects_outputs y loading_and_analysis
--crosstool_top=<a build target label> predeterminado: “@bazel_tools//tools/cpp:toolchain”
La etiqueta del paquete de herramientas cruzadas que se usará para compilar el código de C++.
Etiquetas: loading_and_analysis, changes_inputs y affects_outputs
Valor predeterminado de --custom_malloc=<a build target label>: ver descripción
Especifica una implementación de malloc personalizada. Esta configuración anula los atributos malloc en las reglas de compilación.
Etiquetas: changes_inputs y affects_outputs
Se acumulan --experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment> usos múltiples
Lista de expresiones regulares separadas por comas, cada una con el prefijo - (expresión negativa) opcionalmente, asignadas (=) a una lista de objetivos de valores de restricción separados por comas. Si un objetivo no coincide con ninguna expresión negativa y al menos una expresión positiva, la resolución de la cadena de herramientas se realizará como si se hubieran declarado los valores de la 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
Valor predeterminado de --[no]experimental_include_xcode_execution_requirements: "falso"
Si está configurado, agrega un campo "requires-xcode:{version}". de ejecución requerido a cada acción de Xcode. Si la versión de Xcode tiene una etiqueta con guiones, agrega también la etiqueta “requires-xcode-label:{version_label}”. de ejecución.
Etiquetas: loses_incremental_state, loading_and_analysis y execution
Valor predeterminado de --[no]experimental_prefer_mutual_xcode: "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 mutuas disponibles, usa la versión de Xcode local seleccionada a través de xcode-select.
Etiquetas: loses_incremental_state
Valor predeterminado de --extra_execution_platforms=<comma-separated list of options>: ""
Son las plataformas que están 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 declaradas en el archivo WORKSPACE por register_execution_platforms(). Esta opción solo se puede configurar una vez. las instancias posteriores anularán la configuración de las marcas anteriores.
Etiquetas: execution
Se acumulan --extra_toolchains=<comma-separated list of options> usos múltiples
Las reglas de la cadena de herramientas que se deben considerar durante su resolución. Las cadenas de herramientas se pueden especificar por objetivo exacto o como un patrón de objetivo. Estas cadenas de herramientas se considerarán antes de las declaradas en el archivo WORKSPACE por register_toolchains().
Etiquetas: affects_outputs, changes_inputs y loading_and_analysis
Valor predeterminado de --grte_top=<a label>: ver descripción
Es una etiqueta para una biblioteca de libc abierta. La cadena de herramientas de crosstool selecciona el valor predeterminado, y casi nunca necesitas anularlo.
Etiquetas: action_command_lines y affects_outputs
Valor predeterminado de --host_compiler=<a string>: ver descripción
El compilador de C++ que se usará para la compilación del host. Se ignora si no se configura --host_crosstool_top.
Etiquetas: loading_and_analysis y execution
Valor predeterminado de --host_crosstool_top=<a build target label>: ver descripción
De forma predeterminada, las opciones --crosstool_top y --compiler también se usan para la configuración de ejecución. Si se proporciona este indicador, Bazel usa el compilador y la libc predeterminados para el crosstool_top específico.
Etiquetas: loading_and_analysis, changes_inputs y affects_outputs
Valor predeterminado de --host_grte_top=<a label>: ver descripción
Si se especifica, esta configuración anula el directorio de nivel superior de libc (--grte_top) para la configuración de exec.
Etiquetas: action_command_lines y affects_outputs
--host_platform=<a build target label> predeterminado: “@local_config_platform//:host”
Es la etiqueta de una regla de la plataforma que describe el sistema host.
Etiquetas: affects_outputs, changes_inputs y loading_and_analysis
Valor predeterminado de --[no]incompatible_dont_enable_host_nonhost_crosstool_features: "true"
Si es verdadero, Bazel no habilitará “host”. y “no host” de la cadena de herramientas de c++ (consulta https://github.com/bazelbuild/bazel/issues/7407 para obtener más información).
Etiquetas: loading_and_analysis y incompatible_change
Valor predeterminado de --[no]incompatible_enable_android_toolchain_resolution: "true"
Usa la resolución de la cadena de herramientas para seleccionar el SDK de Android para las reglas de Android (Starlark y nativo)
Etiquetas: loading_and_analysis y incompatible_change
Valor predeterminado de --[no]incompatible_enable_apple_toolchain_resolution: "falso"
Usa la resolución de la cadena de herramientas para seleccionar el SDK de Apple para las reglas de Apple (Starlark y nativo)
Etiquetas: loading_and_analysis y incompatible_change
Valor predeterminado de --[no]incompatible_make_thinlto_command_lines_standalone: "true"
Si es verdadero, Bazel no reutilizará las líneas de comandos de acción de vínculo de C++ para las líneas de comandos de indexación lto (consulta https://github.com/bazelbuild/bazel/issues/6791 para obtener más información).
Etiquetas: loading_and_analysis y incompatible_change
Valor predeterminado de --[no]incompatible_remove_legacy_whole_archive: "true"
Si es verdadero, Bazel no vinculará las dependencias de bibliotecas como archivos completos de forma predeterminada (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener instrucciones de migración).
Etiquetas: loading_and_analysis y incompatible_change
Valor predeterminado de --[no]incompatible_require_ctx_in_configure_features: "true"
Si el valor es verdadero, Bazel requerirá "{4/}". en cc_common.configure_features (consulta https://github.com/bazelbuild/bazel/issues/7793 para obtener más información).
Etiquetas: loading_and_analysis y incompatible_change
Valor predeterminado de --[no]interface_shared_objects: "true"
Usa objetos compartidos de la interfaz si la cadena de herramientas lo admite. Actualmente, todas las cadenas de herramientas ELF admiten esta configuración.
Etiquetas: loading_and_analysis, affects_outputs y affects_outputs
Valor predeterminado de --ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ver descripción
Especifica la versión del SDK de iOS que se usará para compilar aplicaciones de iOS. Si no se especifica, usa la versión predeterminada del SDK de iOS de “xcode_version”.
Etiquetas: loses_incremental_state
Valor predeterminado de --macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ver descripción
Especifica la versión del SDK de macOS que se usará para compilar aplicaciones de macOS. Si no se especifica, se usa la versión predeterminada del SDK de macOS de “xcode_version”.
Etiquetas: loses_incremental_state
Valor predeterminado de --minimum_os_version=<a string>: ver descripción
La versión mínima del SO a la que se orienta tu compilación.
Etiquetas: loading_and_analysis y affects_outputs
Valor predeterminado de --platform_mappings=<a relative path>: ""
La ubicación de un archivo de asignación que describe qué plataforma usar si no hay ninguna establecida o qué marcas se deben configurar cuando ya existe una plataforma. Debe estar relacionada con la raíz principal del lugar de trabajo. La configuración predeterminada es “platform_mappings”. (un archivo directamente debajo de la raíz del espacio de trabajo).
Etiquetas: affects_outputs, changes_inputs y loading_and_analysis
Valor predeterminado de --platforms=<a build target label>: ""
Las etiquetas de las reglas de la plataforma que describen las plataformas de destino para el comando actual.
Etiquetas: affects_outputs, changes_inputs y loading_and_analysis
Valor predeterminado de --python2_path=<a string>: ver descripción
Obsoleto, no-op. Inhabilitado por `--incompatible_use_python_toolchains`.
Etiquetas: no_op y deprecated
Valor predeterminado de --python3_path=<a string>: ver descripción
Obsoleto, no-op. Inhabilitado por `--incompatible_use_python_toolchains`.
Etiquetas: no_op y deprecated
Valor predeterminado de --python_path=<a string>: ver descripción
La ruta de acceso absoluta del intérprete de Python invocado para ejecutar objetivos de Python en la plataforma de destino. Obsoleto; inhabilitado por --incompatible_use_python_toolchains.
Etiquetas: loading_and_analysis y affects_outputs
Valor predeterminado de --python_top=<a build target label>: ver descripción
Es la etiqueta de un py_runtime que representa el intérprete de Python invocado para ejecutar objetivos de Python en la plataforma de destino. Obsoleto; inhabilitado por --incompatible_use_python_toolchains.
Etiquetas: loading_and_analysis y affects_outputs
Valor predeterminado de --tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ver descripción
Especifica la versión del SDK de tvOS que se usará para compilar aplicaciones de tvOS. Si no se especifica, usa la versión predeterminada del SDK de tvOS de "xcode_version".
Etiquetas: loses_incremental_state
Valor predeterminado de --watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ver descripción
Especifica la versión del SDK de watchOS que se usará para compilar aplicaciones de watchOS. Si no se especifica, se usa la versión predeterminada del SDK de watchOS de “xcode_version”.
Etiquetas: loses_incremental_state
Valor predeterminado de --xcode_version=<a string>: ver descripción
Si se especifica, usa Xcode de la versión determinada para las acciones de compilación relevantes. Si no se especifica, usa la versión predeterminada del ejecutor de Xcode.
Etiquetas: loses_incremental_state
--xcode_version_config=<a build target label> predeterminado: “@bazel_tools//tools/cpp:host_xcodes”
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 y loading_and_analysis
Opciones que controlan el resultado del comando:
Valor predeterminado de --[no]apple_generate_dsym: "falso"
Indica si se deben generar archivos de símbolos de depuración (.dSYM).
Etiquetas: affects_outputs y action_command_lines
Si es verdadero, compila bosques de symlink de archivos de ejecución para todos los destinos. Si es falso, escríbelos solo cuando lo requiera una acción local, prueba o comando de ejecución.
Etiquetas: affects_outputs
Valor predeterminado de --[no]build_runfile_manifests: "true"
Si es verdadero, escribe manifiestos de archivos de ejecución para todos los destinos. Si es falsa, omítelas. Las pruebas locales no se ejecutarán si el valor es falso.
Etiquetas: affects_outputs
Valor predeterminado de --[no]build_test_dwp: "falso"
Si se habilita, al compilar pruebas de C++ de forma estática y con fisión, también se compilará automáticamente el archivo .dwp para el objeto binario de prueba.
Etiquetas: loading_and_analysis y affects_outputs
--cc_proto_library_header_suffixes=<comma-separated set of options> predeterminado: ".pb.h"
Establece los sufijos de los archivos de encabezado que crea cc_proto_library.
Etiquetas: affects_outputs y loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated set of options> predeterminado: ".pb.cc"
Establece los sufijos de los archivos de origen que crea cc_proto_library.
Etiquetas: affects_outputs y loading_and_analysis
Valor predeterminado de --[no]experimental_proto_descriptor_sets_include_source_info: "falso"
Ejecuta acciones adicionales para versiones alternativas de la API de Java en una proto_library.
Etiquetas: affects_outputs, loading_and_analysis y experimental
Valor predeterminado de --[no]experimental_proto_extra_actions: "falso"
Ejecuta acciones adicionales para versiones alternativas de la API de Java en una proto_library.
Etiquetas: affects_outputs, loading_and_analysis y experimental
Valor predeterminado de --[no]experimental_save_feature_state: "falso"
Guarda el estado de las funciones habilitadas y solicitadas como resultado de la compilación.
Etiquetas: affects_outputs y experimental
--fission=<a set of compilation modes> predeterminado: "no"
Especifica qué modos de compilación usan la fisión para compilaciones y vínculos de C++. Puede ser cualquier combinación de {'fastbuild', 'dbg', 'opt'} o los valores especiales 'sí' para habilitar todos los modos y hacer clic en "no". para inhabilitar todos los modos.
Etiquetas: loading_and_analysis, action_command_lines y affects_outputs
Valor predeterminado de --[no]incompatible_always_include_files_in_data: "true"
Si esta preferencia se establece como "true", las reglas nativas agregarán <code>DefaultInfo.files</code>. de las dependencias de datos a sus runfiles, lo que coincide con el comportamiento recomendado para las reglas de Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid).
Etiquetas: affects_outputs y incompatible_change
Valor predeterminado de --[no]legacy_external_runfiles: "true"
Si es verdadero, compila bosques de symlink de archivos de ejecución para repositorios externos en .runfiles/wsname/external/repo (además de .runfiles/repo).
Etiquetas: affects_outputs
Valor predeterminado de --[no]objc_generate_linkmap: "falso"
Especifica si se debe generar un archivo de mapa de vínculos.
Etiquetas: affects_outputs
Valor predeterminado de --[no]save_temps: "falso"
Si lo estableces, se guardarán los resultados temporales de GCC. Entre estos, se incluyen archivos .s (código ensamblador), .i (C++ previamente procesado) y .ii (C++ previamente procesados).
Etiquetas: affects_outputs
.
Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
Se acumulan --action_env=<a 'name=value' assignment with an optional value part> usos múltiples
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 por el par nombre=valor que establece el valor de forma independiente del entorno de invocación. Esta opción se puede usar varias veces. en el caso de opciones proporcionadas para la misma variable, se acumulan las últimas victorias y se acumulan opciones para diferentes variables.
Etiquetas: action_command_lines
--android_cpu=<a string> predeterminado: "armeabi-v7a"
La CPU de destino de Android
Etiquetas: affects_outputs, loading_and_analysis y loses_incremental_state
Valor predeterminado de --[no]android_databinding_use_androidx: "true"
Genera archivos de vinculación de datos compatibles con AndroidX. Esto solo se usa con la vinculación de datos v2. Esta marca es una no-op.
Etiquetas: affects_outputs, loading_and_analysis, loses_incremental_state y experimental
Valor predeterminado de --[no]android_databinding_use_v3_4_args: "true"
Usa android databinding v2 con el argumento 3.4.0. Esta marca es una no-op.
Etiquetas: affects_outputs, loading_and_analysis, loses_incremental_state y experimental
Configuración predeterminada de --android_dynamic_mode=<off, default or fully>: "desactivada"
Determina si las dependencias de C++ de reglas de Android se vincularán dinámicamente cuando un objeto cc_binary no cree explícitamente una biblioteca compartida. 'predeterminado' significa que Bazel elegirá si realizar la vinculación de forma dinámica. "completamente" significa que todas las bibliotecas se vincularán de forma dinámica. "desactivado" significa que todas las bibliotecas se vincularán en su mayoría en modo estático.
Etiquetas: affects_outputs y loading_and_analysis
Valor predeterminado de --android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>: "alfabético"
Establece el orden de los manifiestos que se pasan a la combinación de manifiestos para los objetos binarios de Android. ALFABÉTICO 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 relacionadas con el directorio de configuración dentro del directorio de salida. DEPENDENCY significa que los manifiestos se ordenan; el de cada biblioteca antecede a los de sus dependencias.
Etiquetas: action_command_lines y execution
Valor predeterminado de --[no]android_resource_shrinking: "falso"
Habilita la reducción de recursos para los APK android_binary que usan ProGuard.
Etiquetas: affects_outputs y loading_and_analysis
--[no]build_python_zip predeterminado: "automático"
Compila el archivo ZIP ejecutable de Python; Activado en Windows y desactivado en otras plataformas
Etiquetas: affects_outputs
Se acumulan --catalyst_cpus=<comma-separated list of options> usos múltiples
Lista de arquitecturas separadas por comas para las que se compilarán objetos binarios de Apple Catalyst.
Etiquetas: loses_incremental_state y loading_and_analysis
Valor predeterminado de --[no]collect_code_coverage: "falso"
Si se especifica, Bazel instrumentará el código (usando instrumentación sin conexión cuando sea posible) y recopilará información de cobertura durante las pruebas. Solo se verán afectadas las orientaciones que coincidan con --instrumentation_filter. Por lo general, esta opción no debe especificarse directamente: "cobertura de Bazel". en su lugar.
Etiquetas: affects_outputs
--compilation_mode=<fastbuild, dbg or opt> [-c] predeterminado: "fastbuild"
Especifica el modo en que se compilará el objeto binario. Valores: “fastbuild”, “dbg”, “opt”.
Etiquetas: affects_outputs y action_command_lines
Se acumulan --conlyopt=<a string> usos múltiples
Es una opción adicional para pasar a gcc cuando se compilan archivos de origen C.
Etiquetas: action_command_lines y affects_outputs
Se acumulan --copt=<a string> usos múltiples
Opciones adicionales para pasar a gcc.
Etiquetas: action_command_lines y affects_outputs
Valor predeterminado de --cpu=<a string>: ""
La CPU de destino.
Etiquetas: changes_inputs y affects_outputs
Valor predeterminado de --cs_fdo_absolute_path=<a string>: ver descripción
Usa la información de 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 indexado o sin procesar.
Etiquetas: affects_outputs
Valor predeterminado de --cs_fdo_instrument=<a string>: ver descripción
Genera objetos binarios con instrumentación FDO sensible al contexto. Con el compilador Clang/LLVM, también acepta el nombre del directorio bajo el cual se volcarán los archivos de perfil sin procesar en el tiempo de ejecución.
Etiquetas: affects_outputs
Valor predeterminado de --cs_fdo_profile=<a build target label>: ver descripción
El cs_fdo_profile que representa el perfil sensible al contexto que se usará para la optimización.
Etiquetas: affects_outputs
Se acumulan --cxxopt=<a string> usos múltiples
Es una opción adicional para pasar a gcc cuando se compilan archivos de origen C++.
Etiquetas: action_command_lines y affects_outputs
Se acumulan --define=<a 'name=value' assignment> usos múltiples
Cada opción --define especifica una asignación para una variable de compilación.
Etiquetas: changes_inputs y affects_outputs
Valor predeterminado de --dynamic_mode=<off, default or fully>: “predeterminado”
Determina si se vincularán dinámicamente los objetos binarios de C++. 'predeterminado' significa que Bazel elegirá si realizar la vinculación de forma dinámica. "completamente" significa que todas las bibliotecas se vincularán de forma dinámica. "desactivado" significa que todas las bibliotecas se vincularán en su mayoría en modo estático.
Etiquetas: loading_and_analysis y affects_outputs
Valor predeterminado de --[no]enable_fdo_profile_absolute_path: "true"
Si se configura, el uso de fdo_logical_profile_path generará un error.
Etiquetas: affects_outputs
--[no]enable_runfiles predeterminado: "automático"
Habilitar el árbol de symlink de archivos de ejecución De forma predeterminada, la función está desactivada en Windows y activada en otras plataformas.
Etiquetas: affects_outputs
Se acumulan --experimental_action_listener=<a build target label> usos múltiples
Obsoleto para dar lugar a aspectos. Usa action_listener para adjuntar una extra_action a las acciones de compilación existentes.
Etiquetas: execution y experimental
Valor predeterminado de --[no]experimental_android_compress_java_resources: "falso"
Comprime recursos de Java en los APK
Etiquetas: affects_outputs, loading_and_analysis y experimental
Valor predeterminado de --[no]experimental_android_databinding_v2: "true"
Usa Android Databinding v2. Esta marca es una no-op.
Etiquetas: affects_outputs, loading_and_analysis, loses_incremental_state y experimental
Valor predeterminado de --[no]experimental_android_resource_shrinking: "falso"
Habilita la reducción de recursos para los APK android_binary que usan ProGuard.
Etiquetas: affects_outputs y loading_and_analysis
Valor predeterminado de --[no]experimental_android_rewrite_dexes_with_rex: "falso"
usar la herramienta rex para reescribir archivos dex
Etiquetas: affects_outputs, loading_and_analysis, loses_incremental_state y experimental
Valor predeterminado de --[no]experimental_collect_code_coverage_for_generated_files: "falso"
Si se especifica, Bazel también recopilará informació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 objc fastbuild.
Etiquetas: action_command_lines
Valor predeterminado de --[no]experimental_omitfp: "falso"
Si es verdadero, usa libunwind para desenrollar la pila y compila con -fomit-frame-pointer y -faasync-unwind-tables.
Etiquetas: action_command_lines, affects_outputs y experimental
Configuración predeterminada de --experimental_output_paths=<off, content or strip>: "desactivada"
Qué modelo usar para dónde en las reglas del árbol de salida se escriben sus resultados, en particular para compilaciones multiplataforma o con varias configuraciones. Esto es altamente experimental. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/6526. Las acciones de Starlark pueden habilitar la asignación de rutas agregando la tecla “supports-path-mapping”. a los requisitos de ejecución dict.
Etiquetas: loses_incremental_state, bazel_internal_configuration, affects_outputs y execution
Se acumulan --experimental_override_name_platform_in_output_dir=<a 'label=value' assignment> usos múltiples
Cada entrada debe tener el formato label=value, en el que la etiqueta hace referencia a una plataforma y los valores es el nombre corto deseado para usar en la ruta de salida. Solo se utiliza cuando --experimental_platform_in_output_dir es verdadero. Tiene la prioridad de nomenclatura más alta.
Etiquetas: affects_outputs y experimental
Valor predeterminado de --[no]experimental_platform_in_output_dir: "falso"
Si es verdadero, se usa un nombre corto para la plataforma de destino en el nombre del directorio de salida en lugar de la CPU. El esquema exacto es experimental y está sujeto a cambios. En primer lugar, en el caso poco probable de que la opción --platforms no tenga exactamente un valor, se utiliza un hash de la opción de plataformas. A continuación, si --experimental_override_name_platform_in_output_dir registró algún nombre corto para la plataforma actual, se utilizará ese nombre corto. Luego, si se configuró --experimental_use_platforms_in_output_dir_legacy_heuristic, use un nombre corto basado en la etiqueta de la plataforma actual. Por último, se usa un hash de la opción de plataforma como último recurso.
Etiquetas: affects_outputs y experimental
Valor predeterminado de --[no]experimental_use_llvm_covmap: "falso"
Si se especifica, Bazel generará información del mapa de cobertura llvm-cov en lugar de gcov cuando collect_code_coverage esté habilitado.
Etiquetas: changes_inputs, affects_outputs, loading_and_analysis y experimental
Valor predeterminado de --[no]experimental_use_platforms_in_output_dir_legacy_heuristic: "true"
Solo usa esta marca como parte de una estrategia de prueba o migración sugerida. Ten en cuenta que la heurística presenta deficiencias conocidas y se sugiere migrar a solo --experimental_override_name_platform_in_output_dir.
Etiquetas: affects_outputs y experimental
--fat_apk_cpu=<comma-separated set of options> predeterminado: "armeabi-v7a"
Configurar esta opción habilita los APK 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 android_binary.
Etiquetas: affects_outputs, loading_and_analysis y loses_incremental_state
Valor predeterminado de --[no]fat_apk_hwasan: "falso"
Establece si se deben crear divisiones de HWASAN.
Etiquetas: affects_outputs, loading_and_analysis y loses_incremental_state
Valor predeterminado de --fdo_instrument=<a string>: ver descripción
Generar objetos binarios con instrumentación FDO Con el compilador Clang/LLVM, también acepta el nombre del directorio bajo el cual se volcarán los archivos de perfil sin procesar en el tiempo de ejecución.
Etiquetas: affects_outputs
Valor predeterminado de --fdo_optimize=<a string>: ver descripción
Usa la información del perfil 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 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 apunten a destinos de `fdo_profile`. Esta marca se reemplazará por la regla `fdo_profile`.
Etiquetas: affects_outputs
Valor predeterminado de --fdo_prefetch_hints=<a build target label>: ver descripción
Usa sugerencias de carga previa de caché.
Etiquetas: affects_outputs
Valor predeterminado de --fdo_profile=<a build target label>: ver descripción
El fdo_profile que representa el perfil que se utilizará para la optimización.
Etiquetas: affects_outputs
Se acumulan --features=<a string> usos múltiples
Las funciones determinadas estarán habilitadas o inhabilitadas de forma predeterminada para los destinos integrados en la configuración de destino. Especificando -<feature> la inhabilitará. Los atributos negativos siempre anulan los positivos. Consulta también --host_features
Etiquetas: changes_inputs y affects_outputs
Valor predeterminado de --[no]force_pic: "falso"
Si se habilitan, todas las compilaciones de C++ producen código independiente de la posición ("-fPIC"), los vínculos prefieren bibliotecas PIC compiladas previamente en lugar de bibliotecas que no son PIC y producen ejecutables independientes de la posición ("-pie").
Etiquetas: loading_and_analysis y affects_outputs
Se acumulan --host_action_env=<a 'name=value' assignment with an optional value part> usos múltiples
Especifica el conjunto de variables de entorno disponibles para acciones con configuraciones de ejecución. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o por el par nombre=valor que establece el valor de forma independiente del entorno de invocación. Esta opción se puede usar varias veces. en el caso de opciones proporcionadas para la misma variable, se acumulan las últimas victorias y se acumulan opciones para diferentes variables.
Etiquetas: action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt> predeterminado: "opt"
Especifica el modo en que se integrarán las herramientas usadas durante la compilación. Valores: “fastbuild”, “dbg”, “opt”.
Etiquetas: affects_outputs y action_command_lines
Se acumulan --host_conlyopt=<a string> usos múltiples
Es una opción adicional para pasar al compilador C cuando se compilan archivos de origen C (pero no C++) en las configuraciones de ejecución.
Etiquetas: action_command_lines y affects_outputs
Se acumulan --host_copt=<a string> usos múltiples
Opciones adicionales para pasar al compilador C para herramientas integradas en las configuraciones de ejecución.
Etiquetas: action_command_lines y affects_outputs
Valor predeterminado de --host_cpu=<a string>: ""
La CPU host
Etiquetas: changes_inputs y affects_outputs
Se acumulan --host_cxxopt=<a string> usos múltiples
Opciones adicionales para pasar al compilador C++ en el caso de las herramientas integradas en las configuraciones de ejecución.
Etiquetas: action_command_lines y affects_outputs
Se acumulan --host_features=<a string> usos múltiples
Las funciones determinadas estarán habilitadas o inhabilitadas de forma predeterminada para los destinos compilados en la configuración de ejecución. Especificando -<feature> la inhabilitará. Los atributos negativos siempre anulan los positivos.
Etiquetas: changes_inputs y affects_outputs
Valor predeterminado de --host_force_python=<PY2 or PY3>: ver descripción
Anula la versión de Python para la configuración de ejecución. Puede ser "PY2". o “PY3”.
Etiquetas: loading_and_analysis y affects_outputs
Se acumulan --host_linkopt=<a string> usos múltiples
Es una opción adicional para pasar al vinculador cuando se vinculan herramientas en las configuraciones de ejecución.
Etiquetas: action_command_lines y affects_outputs
Valor predeterminado de --host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ver descripción
Versión mínima de macOS compatible para los destinos de host. Si no se especifica, usa "macos_sdk_version".
Etiquetas: loses_incremental_state
Se acumulan --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> usos múltiples
Opciones adicionales para pasar de forma selectiva al compilador C/C++ cuando compilas ciertos archivos en las configuraciones de ejecución. Esta opción se puede aprobar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter significa una lista de patrones de inclusión y exclusión de expresiones regulares (consulta también --instrumentation_filter). opción_1 a option_n significa opciones arbitrarias de la línea de comandos. Si una opción contiene una coma, se debe colocar entre una barra 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 gcc de todos los archivos cc en //foo/, excepto bar.cc.
Etiquetas: action_command_lines y affects_outputs
Se acumulan --host_swiftcopt=<a string> usos múltiples
Opciones adicionales para pasar a swiftc para herramientas de ejecución.
Etiquetas: action_command_lines y affects_outputs
Valor predeterminado de --[no]incompatible_auto_exec_groups: "falso"
Cuando se habilita, se crea automáticamente un grupo de ejecución para cada cadena de herramientas que usa una regla. Para que esta regla funcione, se debe especificar el parámetro `toolchain` en sus acciones. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/17134.
Etiquetas: affects_outputs y incompatible_change
Valor predeterminado de --[no]incompatible_merge_genfiles_directory: "true"
Si es verdadero, el directorio genfiles se pliega en el directorio bin.
Etiquetas: affects_outputs y incompatible_change
Valor predeterminado de --[no]incompatible_use_host_features: "true"
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 y incompatible_change
Valor predeterminado de --[no]instrument_test_targets: "falso"
Cuando la cobertura está habilitada, especifica si se deben considerar reglas de prueba. Cuando se establecen, 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> predeterminado: "-/javatests[/:],-/test/java[/:]"
Cuando se habilite la cobertura, solo se instrumentarán las reglas con nombres incluidos por el filtro basado en regex especificado. Reglas con el prefijo “-” en su lugar. 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
Valor predeterminado de --ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ver descripción
Versión de iOS mínima compatible para simuladores y dispositivos de destino. Si no se especifica, usa "ios_sdk_version".
Etiquetas: loses_incremental_state
Se acumulan --ios_multi_cpus=<comma-separated list of options> usos múltiples
Lista separada por comas de arquitecturas con las que se compilará una aplicación ios_application. El resultado es un objeto binario universal que contiene todas las arquitecturas especificadas.
Etiquetas: loses_incremental_state y loading_and_analysis
Valor predeterminado de --[no]legacy_whole_archive: "true"
Obsoleto y sustituido por --incompatible_remove_legacy_whole_archive (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener más información). Cuando esta opción esté activada, usa --whole-archive para las reglas cc_binary que tengan 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 y deprecated
Se acumulan --linkopt=<a string> usos múltiples
Es una opción adicional para pasar a gcc durante la vinculación.
Etiquetas: action_command_lines y affects_outputs
Se acumulan --ltobackendopt=<a string> usos múltiples
Es una opción adicional para pasar al paso del backend de LTO (en --features=thin_lto).
Etiquetas: action_command_lines y affects_outputs
Se acumulan --ltoindexopt=<a string> usos múltiples
Es una opción adicional para pasar al paso de indexación de LTO (en --features=thin_lto).
Etiquetas: action_command_lines y affects_outputs
Se acumulan --macos_cpus=<comma-separated list of options> usos múltiples
Lista de arquitecturas separadas por comas para las que se compilarán objetos binarios de Apple macOS.
Etiquetas: loses_incremental_state y loading_and_analysis
Valor predeterminado de --macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ver descripción
Versión mínima de macOS compatible para destinos. Si no se especifica, usa "macos_sdk_version".
Etiquetas: loses_incremental_state
Valor predeterminado de --memprof_profile=<a build target label>: ver descripción
Usar perfil de memprof.
Etiquetas: affects_outputs
Valor predeterminado de --[no]objc_debug_with_GLIBCXX: "falso"
Si se establece y el modo de compilación está establecido en "dbg", define GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC y GLIBCPP_CONCEPT_CHECKS.
Etiquetas: action_command_lines
Valor predeterminado de --[no]objc_enable_binary_stripping: "falso"
Indica si se deben realizar eliminaciones de símbolos y de código no muerto en objetos binarios vinculados. Se realizarán eliminaciones de objetos binarios si se especifican esta marca y --compilation_mode=opt.
Etiquetas: action_command_lines
Se acumulan --objccopt=<a string> usos múltiples
Opciones adicionales para pasar a gcc cuando se compilan archivos de origen Objective-C/C++.
Etiquetas: action_command_lines
Se acumulan --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> usos múltiples
Opciones adicionales para pasar a gcc de forma selectiva cuando se compilan ciertos archivos. Esta opción se puede aprobar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter significa una lista de patrones de inclusión y exclusión de expresiones regulares (consulta también --instrumentation_filter). opción_1 a option_n significa opciones arbitrarias de la línea de comandos. Si una opción contiene una coma, se debe colocar entre una barra 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 gcc de todos los archivos cc en //foo/, excepto bar.cc.
Etiquetas: action_command_lines y affects_outputs
Se acumulan --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> usos múltiples
Opciones adicionales para pasar de forma selectiva al backend de LTO (en --features=thin_lto) cuando se compilan ciertos objetos de backend. Esta opción se puede aprobar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter significa una lista de patrones de incluir y excluir expresiones regulares. opción_1 a option_n significa opciones arbitrarias de la línea de comandos. Si una opción contiene una coma, se debe colocar entre una barra 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 LTO de todos los archivos o en //foo/ excepto bar.o.
Etiquetas: action_command_lines y affects_outputs
Valor predeterminado de --platform_suffix=<a string>: ver descripción
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas: loses_incremental_state, affects_outputs y loading_and_analysis
Valor predeterminado de --propeller_optimize=<a build target label>: ver descripción
Usa la información del perfil de Propeller para optimizar el objetivo de la compilación.Un perfil de propeller debe constar de al menos uno de dos archivos, un perfil cc y un perfil ld. Esta marca acepta una etiqueta de compilación que debe hacer referencia a los archivos de entrada del perfil del propeler. Por ejemplo, el archivo COMPILAR 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 export_files al paquete correspondiente para que estos archivos sean visibles para Bazel. La opción debe usarse como: --propeller_optimize=//a/b:propeller_profile
Etiquetas: action_command_lines y affects_outputs
Valor predeterminado de --propeller_optimize_absolute_cc_profile=<a string>: ver descripción
Nombre de la ruta de acceso absoluta del archivo cc_profile para compilaciones de Propeller Optimized.
Etiquetas: affects_outputs
Valor predeterminado de --propeller_optimize_absolute_ld_profile=<a string>: ver descripción
Nombre de la ruta de acceso absoluta del archivo ld_profile para compilaciones de Propeller Optimized.
Etiquetas: affects_outputs
Valor predeterminado de --run_under=<a prefix in front of command>: ver descripción
Prefijo para insertar antes de los ejecutables para la “prueba” y "ejecutar" con comandos de SQL sencillos. Si el valor es “foo -bar” y la línea de comandos de ejecución es “test_binary -baz”, la última línea de comandos es “foo -bar test_binary -baz”. También puede ser una etiqueta para un destino ejecutable. Estos son algunos ejemplos: 'valgrind', 'strace', 'strace -c', 'valgrind --quiet --num-callers=20', '//package:target', '//package:target --options'.
Etiquetas: action_command_lines
Valor predeterminado de --[no]share_native_deps: "true"
Si es verdadero, las bibliotecas nativas que contengan una funcionalidad idéntica se compartirán entre diferentes destinos
Etiquetas: loading_and_analysis y affects_outputs
Valor predeterminado de --[no]stamp: "falso"
Sella objetos binarios con la fecha, el nombre de usuario, el nombre de host, la información del espacio de trabajo, etcétera.
Etiquetas: affects_outputs
--strip=<always, sometimes or never> predeterminado: “a veces”
Especifica si se deben eliminar los objetos binarios y las bibliotecas compartidas (mediante "-Wl,--strip-debug"). El valor predeterminado de “A veces” significa quitar iff --compilation_mode=fastbuild.
Etiquetas: affects_outputs
Se acumulan --stripopt=<a string> usos múltiples
Opciones adicionales para pasar a la barra cuando se genera un archivo '<name>.stripped' binario.
Etiquetas: action_command_lines y affects_outputs
Se acumulan --swiftcopt=<a string> usos múltiples
Opciones adicionales para pasar a la compilación de Swift.
Etiquetas: action_command_lines
Se acumulan --tvos_cpus=<comma-separated list of options> usos múltiples
Lista de arquitecturas separadas por comas para las que se compilarán objetos binarios de tvOS de Apple.
Etiquetas: loses_incremental_state y loading_and_analysis
Valor predeterminado de --tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ver descripción
Versión mínima de tvOS compatible para dispositivos y simuladores de destino. Si no se especifica, usa "tvos_sdk_version".
Etiquetas: loses_incremental_state
Se acumulan --visionos_cpus=<comma-separated list of options> usos múltiples
Lista separada por comas de arquitecturas para las que se compilarán objetos binarios de visionOS de Apple.
Etiquetas: loses_incremental_state y loading_and_analysis
Se acumulan --watchos_cpus=<comma-separated list of options> usos múltiples
Lista de arquitecturas separadas por comas para compilar objetos binarios de watchOS de Apple.
Etiquetas: loses_incremental_state y loading_and_analysis
Valor predeterminado de --watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ver descripción
Versión mínima de watchOS compatible con simuladores y dispositivos de destino. Si no se especifica, usa “watchos_sdk_version”.
Etiquetas: loses_incremental_state
Valor predeterminado de --xbinary_fdo=<a build target label>: ver descripción
Usa la información de perfil de XbinaryFDO para optimizar la compilación. Especifica el nombre del perfil de multibinario predeterminado. Cuando la opción se usa junto con --fdo_instrument/--fdo_optimize/--fdo_profile, esas opciones siempre prevalecerán como si nunca se especificara xbinary_fdo.
Etiquetas: affects_outputs
.
Opciones que afectan la precisión con la que Bazel aplica 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 grupo de entorno que se usará para asignar automáticamente los valores de la CPU a los valores de target_environment.
Etiquetas: changes_inputs, loading_and_analysis y experimental
Valor predeterminado de --[no]check_licenses: "falso"
Verifica que las restricciones de licencias impuestas por los paquetes dependientes no entren en conflicto con los modos de distribución de los objetivos que se compilan. De forma predeterminada, las licencias no están marcadas.
Etiquetas: build_file_semantics
Valor predeterminado de --[no]check_visibility: "true"
Si se inhabilita, los errores de visibilidad en las dependencias objetivo descienden a advertencias.
Etiquetas: build_file_semantics
Valor predeterminado de --[no]desugar_for_android: "true"
Establece si se debe expandir el código de bytes de Java 8 antes de la conversión a DEX.
Etiquetas: affects_outputs, loading_and_analysis y loses_incremental_state
Valor predeterminado de --[no]desugar_java8_libs: "falso"
Especifica si se deben incluir bibliotecas de Java 8 compatibles en las apps para dispositivos heredados.
Etiquetas: affects_outputs, loading_and_analysis, loses_incremental_state y experimental
Valor predeterminado de --[no]enforce_constraints: "true"
Verifica los entornos con los que cada destino es compatible y, luego, informa los errores si alguno de ellos tiene dependencias que no admiten los mismos entornos.
Etiquetas: build_file_semantics
Valor predeterminado de --[no]experimental_check_desugar_deps: "true"
Establece si se debe verificar la expansión de sintaxis correcta a nivel del objeto binario de Android.
Etiquetas: eagerness_to_exit, loading_and_analysis y experimental
Configuración predeterminada de --experimental_import_deps_checking=<off, warning or error>: "DESACTIVADA"
Cuando se habilita, se verifica si las dependencias de aar_import están completas. Esta aplicación puede romper la compilación o generar advertencias.
Etiquetas: loading_and_analysis
Valor predeterminado de --experimental_strict_java_deps=<off, warn, error, strict or default>: “predeterminado”
Si es verdadero, comprueba que un destino de Java declare de manera explícita todos los objetivos usados directamente como dependencias.
Etiquetas: build_file_semantics y eagerness_to_exit
Valor predeterminado de --[no]incompatible_check_testonly_for_output_files: "falso"
Si se habilita, comprueba los objetivos de prerrequisito de solo prueba que son archivos de salida buscando solo la prueba de la regla que se genera. Esto coincide con la verificación de visibilidad.
Etiquetas: build_file_semantics y incompatible_change
Valor predeterminado de --[no]incompatible_check_visibility_for_toolchains: "falso"
Si se habilita, la verificación de visibilidad también se aplica a las implementaciones de cadenas de herramientas.
Etiquetas: build_file_semantics y incompatible_change
Valor predeterminado de --[no]incompatible_disable_native_android_rules: "falso"
Si se habilita esta opción, se inhabilitará el uso directo de las reglas nativas de Android. Usa las reglas de Starlark para Android que se encuentran en https://github.com/bazelbuild/rules_android
Etiquetas: eagerness_to_exit y incompatible_change
Valor predeterminado de --[no]incompatible_disable_native_apple_binary_rule: "falso"
No-ops. Se guardan aquí para brindar retrocompatibilidad.
Etiquetas: eagerness_to_exit y incompatible_change
Valor predeterminado de --[no]incompatible_python_disable_py2: "true"
Si es verdadero, usar la configuración de Python 2 generará un error. Esto incluye python_version=PY2, srcs_version=PY2 y srcs_version=PY2ONLY. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/15684.
Etiquetas: loading_and_analysis y incompatible_change
Valor predeterminado de --[no]incompatible_validate_top_level_header_inclusions: "true"
Si es verdadero, Bazel también validará las inclusiones de encabezados de directorio de nivel superior (consulta https://github.com/bazelbuild/bazel/issues/10047 para obtener más información).
Etiquetas: loading_and_analysis y incompatible_change
Valor predeterminado de --python_native_rules_allowlist=<a build target label>: ver descripción
Una lista de entidades permitidas (destino del grupo de productos) que se usará cuando se aplique --incompatible_python_Disallow_native_rules.
Etiquetas: loading_and_analysis
Valor predeterminado de --[no]strict_filesets: "falso"
Si se habilita esta opción, los conjuntos de archivos que cruzan los límites de paquetes se informan como errores.
Etiquetas: build_file_semantics y eagerness_to_exit
Valor predeterminado de --strict_proto_deps=<off, warn, error, strict or default>: "error"
A menos que esté DESACTIVADA, comprueba que un destino proto_library declare de forma explícita todos los objetivos usados directamente como dependencias.
Etiquetas: build_file_semantics, eagerness_to_exit y incompatible_change
Configuración predeterminada de --strict_public_imports=<off, warn, error, strict or default>: "desactivada"
A menos que esté DESACTIVADA, comprueba que un objetivo proto_library declare de forma explícita todos los destinos usados en el campo "import public" como se exportó.
Etiquetas: build_file_semantics, eagerness_to_exit y incompatible_change
Valor predeterminado de --[no]strict_system_includes: "falso"
Si es verdadero, también se deben declarar los encabezados que se encuentran en el sistema incluyen rutas de acceso (-isystem).
Etiquetas: loading_and_analysis y eagerness_to_exit
Se acumulan --target_environment=<a build target label> usos múltiples
Declara el entorno de destino de esta compilación. Debe ser una referencia de etiqueta a un "entorno" . Si se especifica, todos los objetivos de nivel superior deben ser compatibles con este entorno.
Etiquetas: changes_inputs
.
Opciones que afectan los resultados de firma de una compilación:
--apk_signing_method=<v1, v2, v1_v2 or v4> predeterminado: “v1_v2”
Implementación para firmar APKs
Etiquetas: action_command_lines, affects_outputs y loading_and_analysis
Valor predeterminado de --[no]device_debug_entitlements: "true"
Si se configura y el modo de compilación no es "opt", las apps objc incluirán derechos de depuración cuando firmen.
Etiquetas: changes_inputs
Valor predeterminado de --ios_signing_cert_name=<a string>: ver descripción
Nombre del certificado que se usará para la firma de iOS. De lo contrario, se recurrirá al perfil de aprovisionamiento. Puede ser la preferencia de identidad del llavero del certificado o (subcadena) del nombre común del certificado, según la página del manual del símbolo de código (IDENTIDADES DE FIRMA).
Etiquetas: action_command_lines
.
Esta opción afecta la semántica del lenguaje de Starlark o de la API de compilación a la que pueden acceder los archivos BUILD, los archivos .bzl o los archivos WORKSPACE:
Valor predeterminado de --[no]incompatible_disallow_legacy_py_provider: "true"
No-op; se quitará pronto.
Etiquetas: loading_and_analysis y incompatible_change
Valor predeterminado de --[no]incompatible_disallow_sdk_frameworks_attributes: "falso"
Si esta preferencia se establece como verdadera, no permite los atributos sdk_frameworks y bad_sdk_frameworks en objc_library y objc_import.
Etiquetas: build_file_semantics y incompatible_change
Si es verdadero, establece como verdadero el valor predeterminado para los atributos Alwayslink en objc_library y objc_import.
Etiquetas: build_file_semantics y incompatible_change
Valor predeterminado de --[no]incompatible_python_disallow_native_rules: "falso"
Si es verdadero, se produce un error cuando se usan las reglas py_* integradas. en su lugar, se deben usar las reglas rule_python. Consulta https://github.com/bazelbuild/bazel/issues/17773 para obtener más información y las instrucciones de migración.
Etiquetas: loading_and_analysis y incompatible_change
Opciones que determinan el comportamiento del entorno de pruebas o del ejecutor de pruebas:
Valor predeterminado de --[no]allow_analysis_failures: "falso"
Si es verdadero, una falla de análisis del destino de una regla da como resultado la propagación del destino de una instancia de AnalysisFailureInfo que contiene la descripción del error, en lugar de generar una falla de compilación.
Etiquetas: loading_and_analysis y experimental
Valor predeterminado de --analysis_testing_deps_limit=<an integer>: "2000"
Establece el número máximo de dependencias transitivas mediante un atributo de regla con una transición de configuración for_analysis_testing. Si superas este límite, se producirá un error de regla.
Etiquetas: loading_and_analysis
Valor predeterminado de --[no]break_build_on_parallel_dex2oat_failure: "falso"
Si las verdaderas fallas de acción de dex2oat harán que la compilación se rompa en lugar de ejecutar dex2oat durante el tiempo de ejecución de la prueba.
Etiquetas: loading_and_analysis y experimental
Valor predeterminado de --[no]experimental_android_use_parallel_dex2oat: "falso"
Usa dex2oat en paralelo para acelerar la ejecución de android_test.
Etiquetas: loading_and_analysis, host_machine_resource_optimizations y experimental
Valor predeterminado de --[no]ios_memleaks: "falso"
Habilitar la verificación de fugas de memoria en los destinos de ios_test.
Etiquetas: action_command_lines
Valor predeterminado de --ios_simulator_device=<a string>: ver descripción
El dispositivo que se debe simular cuando se ejecuta una aplicación para iOS en el simulador, p.ej., "iPhone 6". Ejecuta “xcrun simctl list devicetypes” para obtener una lista de dispositivos. de la máquina en la que se ejecutará el simulador.
Etiquetas: test_runner
Valor predeterminado de --ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ver descripción
Es la versión de iOS que se ejecuta en el simulador durante la ejecución o las pruebas. Esto se ignora para las reglas ios_test si se especifica un dispositivo de destino en la regla.
Etiquetas: test_runner
Se acumulan --runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once> usos múltiples
Especifica la cantidad de veces que se debe ejecutar cada prueba. Si alguno de esos intentos falla por cualquier motivo, toda la prueba se considera fallida. Por lo general, 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. En el ejemplo anterior, ejecuta_per_prueba significa 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 aprobar varias veces. El argumento que se pasó más recientemente y que coincida tiene prioridad. Si no hay coincidencias, la prueba se ejecutará solo una vez.
Se acumulan --test_env=<a 'name=value' assignment with an optional value part> usos múltiples
Especifica las variables de entorno adicionales que se insertarán en el entorno del ejecutor de pruebas. Las variables pueden especificarse por nombre, en cuyo caso su valor se leerá desde el entorno de cliente de Bazel o por el par nombre=valor. Esta opción se puede usar varias veces para especificar muchas variables. Solo lo usa la "prueba de Bazel". kubectl.
Etiquetas: test_runner
Valor predeterminado de --test_timeout=<a single integer or comma-separated list of 4 integers>: "-1"
Anula los valores predeterminados del tiempo de espera de la prueba (en segundos). Si se especifica un valor entero positivo único, se anularán todas las categorías. Si se especifican 4 números enteros separados por comas, se anularán los tiempos de espera de corto, moderado, largo y eterno (en ese orden). En cualquier caso, el valor -1 indica al blaze que use los tiempos de espera predeterminados para esa categoría.
Valor predeterminado de --[no]zip_undeclared_test_outputs: "true"
Si es verdadero, los resultados de la prueba que no se declaren se archivarán en un archivo ZIP.
Etiquetas: test_runner
.
Opciones relacionadas con el resultado de la consulta y la semántica:
--aspect_deps=<off, conservative or precise> predeterminado: “conservadora”
Cómo resolver dependencias de aspecto cuando el formato de salida es {xml,proto,record}. "desactivado" significa que no se resuelven dependencias de aspecto, “conservadora” (predeterminado) significa que todas las dependencias de aspecto declaradas se agregan independientemente de si se les da la clase de regla de dependencias directas, “precisa”. significa que solo se agregan los 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. Además, ten en cuenta que incluso el modo preciso no es del todo preciso: la decisión de calcular un aspecto se decide en la fase de análisis, que no se ejecuta durante la “consulta de Bazel”.
Etiquetas: build_file_semantics
Valor predeterminado de --[no]consistent_labels: "falso"
Si se habilita, cada comando de consulta emite etiquetas como si <code>str</code> de Starlark función aplicada a una <code>etiqueta</code> instancia. Esto resulta útil para las herramientas que necesitan hacer coincidir el resultado de diferentes comandos de consulta o etiquetas emitidas por las reglas. Si no se habilita, los formateadores de salida pueden emitir nombres de repositorio aparentes (en relación con el repositorio principal) en lugar de hacer que el resultado sea más legible.
Etiquetas: terminal_output
Valor predeterminado de --[no]graph:factored: "true"
Si es verdadero, el grafo 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> predeterminado: "512"
La longitud máxima de la cadena de etiqueta para un nodo del grafo en el resultado. Las etiquetas más largas se truncarán. -1 significa que no hay truncamiento. Esta opción solo se aplica a --output=graph.
Etiquetas: terminal_output
Valor predeterminado de --[no]implicit_deps: "true"
Si se habilita, las dependencias implícitas se incluirán en el gráfico de dependencias sobre el que opera la consulta. Una dependencia implícita es una que no se especifica de forma explícita en el archivo BUILD, pero la agrega Bazel. En el caso de cquery, esta opción controla el filtrado de cadenas de herramientas resueltas.
Etiquetas: build_file_semantics
Valor predeterminado de --[no]include_aspects: "true"
aquery, cquery: Se incluyen acciones generadas por aspectos en el resultado. consulta: no-op (siempre se siguen los aspectos).
Etiquetas: terminal_output
Valor predeterminado de --[no]incompatible_package_group_includes_double_slash: "true"
Si se habilita esta opción, cuando se genere el atributo `packages` de package_group, no se omitirá el `//` inicial.
Etiquetas: terminal_output y incompatible_change
Valor predeterminado de --[no]infer_universe_scope: "falso"
Si no se establece ni --universe_scope, se inferirá un valor de --universe_scope como la lista de patrones de destino únicos en la expresión de consulta. Ten en cuenta que es posible que el valor --universe_scope inferido para una expresión de consulta que usa funciones con alcance universal (p.ej., `allrdeps`) no sea lo que quieres, por lo que debes usar esta opción solo si sabes lo que estás haciendo. Consulta https://bazel.build/reference/query#sky-query para obtener detalles y ejemplos. Si se configura --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
Valor predeterminado de --[no]line_terminator_null: "falso"
Indica si cada formato termina con \0 en lugar de un salto de línea.
Etiquetas: terminal_output
Valor predeterminado de --[no]nodep_deps: "true"
Si está habilitada, las dependencias de “nodep” atributos se incluirán en el gráfico de la dependencia en el que opera la consulta. Un ejemplo común de un “nodep” es “visibilidad”. Ejecuta y analiza el resultado de `info build-language` para conocer todos los “nodep” atributos en el lenguaje de compilación.
Etiquetas: build_file_semantics
--output=<a string> predeterminado: "etiqueta"
El formato en el que se deben imprimir los resultados de cquery. Los valores permitidos para cquery son los siguientes: label, label_kind, textproto,Transitions, proto, streaming_proto y jsonproto. Si seleccionas "transiciones", también debes especificar la opción --transitions=(lite|full).
Etiquetas: terminal_output
Valor predeterminado de --[no]proto:default_values: "true"
Si es verdadero, se incluirán los atributos cuyo valor no se especifica explícitamente en el archivo BUILD. de lo contrario, se omitirán. Esta opción se aplica a --output=proto
Etiquetas: terminal_output
Valor predeterminado de --[no]proto:definition_stack: "falso"
Propaga el campo de proto definition_stack, que registra la pila de llamadas de Starlark para cada instancia de la regla en el momento en que se definió la clase de la regla.
Etiquetas: terminal_output
Valor predeterminado de --[no]proto:flatten_selects: "true"
Si se habilita, se acoplan los atributos configurables creados por select(). Para los tipos de lista, la representación plana es una lista que contiene cada valor del mapa de selección exactamente una vez. Los tipos escalares se acoplan a nulos.
Etiquetas: build_file_semantics
Valor predeterminado de --[no]proto:include_attribute_source_aspects: "falso"
Propaga el campo de protocolo source_aspect_name de cada atributo con el aspecto de origen del que provino (cadena vacía si no es así).
Etiquetas: terminal_output
Valor predeterminado de --[no]proto:include_configurations: "true"
si está habilitado, el resultado del protocolo incluirá información sobre la configuración. Cuando está inhabilitado,el formato de salida de cquery proto se asemeja al formato de salida de la consulta.
Etiquetas: affects_outputs
Valor predeterminado de --[no]proto:include_synthetic_attribute_hash: "falso"
Indica si se debe calcular y propagar el atributo $internal_attr_hash.
Etiquetas: terminal_output
Valor predeterminado de --[no]proto:instantiation_stack: "falso"
Propaga la pila de llamadas de creación de instancias de cada regla. Ten en cuenta que esto requiere que la pila esté presente
Etiquetas: terminal_output
Valor predeterminado de --[no]proto:locations: "true"
Establece si se debe emitir información de ubicación en el resultado de proto.
Etiquetas: terminal_output
--proto:output_rule_attrs=<comma-separated list of options> predeterminado: "todos"
Lista de atributos separados por comas para incluir en el resultado. La configuración predeterminada es todos los atributos. Se configura como una cadena vacía para no generar ningún atributo. Esta opción se aplica a --output=proto.
Etiquetas: terminal_output
Valor predeterminado de --[no]proto:rule_inputs_and_outputs: "true"
Indica si se deben completar o no 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 desde el archivo que se nombra aquí, en lugar de hacerlo en la línea de comandos. Es un error especificar aquí un archivo así como una consulta de línea de comandos.
Etiquetas: changes_inputs
Valor predeterminado de --[no]relative_locations: "falso"
Si es verdadero, la ubicación de los archivos Build en los resultados xml y proto será relativa. De forma predeterminada, el resultado de la ubicación es una ruta de acceso absoluta y no será coherente en todas las máquinas. Puedes configurar esta opción como verdadera para obtener un resultado coherente en todas las máquinas.
Etiquetas: terminal_output
Configuración predeterminada de --show_config_fragments=<off, direct or transitive>: "desactivada"
Muestra los fragmentos de configuración que requiere una regla y sus dependencias transitivas. Esto puede ser útil para evaluar cuánto se puede recortar un gráfico de destino configurado.
Etiquetas: affects_outputs
Valor predeterminado de --starlark:expr=<a string>: ""
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 "target". Si no se especifica --starlark:expr ni --starlark:file, la opción predeterminada será 'str(target.label)'. Es un error especificar --starlark:expr y --starlark:file.
Etiquetas: terminal_output
Valor predeterminado de --starlark:file=<a string>: ""
El 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 --starlark:expr y --starlark:file. Consulta la ayuda de --output=starlark para obtener más detalles.
Etiquetas: terminal_output
Valor predeterminado de --[no]tool_deps: "true"
Consulta: Si está inhabilitada, depende de “exec configuration” no se incluirán en el gráfico de la dependencia en el que opera la consulta. Una “configuración de ejecución” perímetro de dependencia, como el de cualquier "proto_library" al compilador de protocolos, por lo general, apunta a una herramienta ejecutada durante la compilación en lugar de a una parte del mismo “destino” . Cquery: Si se inhabilita, filtra todos los destinos configurados que cruzan una transición de ejecución del objetivo de nivel superior que descubrió este objetivo configurado. Esto significa que, si el destino de nivel superior se encuentra en la configuración de destino, solo se mostrarán los destinos configurados que se encuentren también en esa configuración. Si el destino de nivel superior está en la configuración de ejecución, solo se mostrarán los destinos configurados de ejecución. Esta opción NO excluirá las cadenas de herramientas resueltas.
Etiquetas: build_file_semantics
Valor predeterminado de --transitions=<full, lite or none>: "ninguno"
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>: ""
Un conjunto de patrones de destino separados por comas (aditivos y sustractivos). La consulta puede realizarse en el universo definido por el cierre transitivo de los objetivos especificados. Esta opción se usa para los comandos de consulta y cquery. Para cquery, la entrada de esta opción son los destinos en los que se crean todas las respuestas, por lo que esta opción puede afectar las configuraciones y transiciones. Si no se especifica esta opción, se supone que los objetivos de nivel superior son los objetivos analizados de la expresión de consulta. Nota: Para cquery, no especificar esta opción puede hacer que la compilación se rompa si los objetivos analizados desde la expresión de consulta no se pueden compilar con las opciones de nivel superior.
Etiquetas: loading_and_analysis
.
Opciones que activan optimizaciones del tiempo de compilación:
Valor predeterminado de --[no]experimental_filter_library_jar_with_program_jar: "falso"
Filtra ProgramJar de ProGuard para quitar las clases que también estén presentes en el LibraryJar.
Etiquetas: action_command_lines
Valor predeterminado de --[no]experimental_inmemory_dotd_files: "true"
Si se habilita, los archivos .d de C++ se pasarán a la memoria directamente desde los nodos de compilación remotos en lugar de escribirse en el disco.
Etiquetas: loading_and_analysis, execution, affects_outputs y experimental
Valor predeterminado de --[no]experimental_inmemory_jdeps_files: "true"
Si se habilita, los archivos de dependencia (.jdeps) generados a partir de compilaciones de Java se pasarán a la memoria directamente desde los nodos de compilación remotos en lugar de escribirse en el disco.
Etiquetas: loading_and_analysis, execution, affects_outputs y experimental
Valor predeterminado de --[no]experimental_objc_include_scanning: "falso"
Si se debe realizar, incluye el análisis del objetivo de C/C++.
Etiquetas: loading_and_analysis, execution y changes_inputs
Valor predeterminado de --[no]experimental_retain_test_configuration_across_testonly: "falso"
Cuando se habilita, --trim_test_configuration no recortará la configuración de prueba para las reglas marcadas como testonly=1. El objetivo de esto es reducir los problemas de conflictos 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 y loses_incremental_state
Valor predeterminado de --[no]experimental_starlark_cc_import: "falso"
Si se habilita, se puede usar la versión de Starlark de cc_import.
Etiquetas: loading_and_analysis y experimental
Valor predeterminado de --[no]experimental_unsupported_and_brittle_include_scanning: "falso"
Establece si las entradas se limitan a la compilación C/C++ mediante el análisis de #include líneas de archivos de entrada. Esto puede mejorar el rendimiento y la incrementalidad disminuyendo el tamaño de los árboles de entrada de compilación. Sin embargo, también puede romper compilaciones porque el escáner de inclusión no implementa por completo la semántica del preprocesador de C. En particular, no comprende las directivas dinámicas #include y, también, ignora la lógica condicional del preprocesador. Úsala bajo tu propia responsabilidad. Se cerrarán todos los problemas relacionados con esta marca que se hayan presentado.
Etiquetas: loading_and_analysis, execution y changes_inputs
Valor predeterminado de --[no]incremental_dexing: "true"
Realiza la mayor parte del trabajo para la conversión a DEX por separado para cada archivo jar.
Etiquetas: affects_outputs, loading_and_analysis y loses_incremental_state
Valor predeterminado de --[no]objc_use_dotd_pruning: "true"
Si se configura, los archivos .d emitidos por Clang se usarán para reducir el conjunto de entradas que se pasan a compilaciones objc.
Etiquetas: changes_inputs y loading_and_analysis
Valor predeterminado de --[no]process_headers_in_dependencies: "falso"
Cuando se compila un //a:a de destino, procesa 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
Valor predeterminado de --[no]trim_test_configuration: "true"
Cuando se habilita esta opción, las opciones relacionadas con las pruebas se borran 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 pruebas no harán que las reglas que no son de prueba se vuelvan a analizar.
Etiquetas: loading_and_analysis y loses_incremental_state
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 la 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 la cadena de herramientas y los objetivos específicos para ver cuál depurar. Es posible que varias regex estén separadas con comas y, luego, cada regex se verifique 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 la cadena de herramientas.
Etiquetas: terminal_output
.
Opciones que especifican o modifican una entrada genérica para un comando de Bazel que no se encuentra en otras categorías.
Se acumulan --flag_alias=<a 'name=value' flag alias> usos múltiples
Establece un nombre abreviado para una bandera de Starlark. Toma un solo par clave-valor con el formato "<clave>=<valor>" como argumento.
Etiquetas: changes_inputs
Valor predeterminado de --[no]incompatible_default_to_explicit_init_py: "falso"
Esta marca cambia el comportamiento predeterminado para que los archivos __init__.py ya no se creen automáticamente en los runfiles de los objetivos de Python. De manera precisa, cuando un destino py_binary o py_test tiene legacy_create_init configurado en “auto” (configuración predeterminada), se trata como falsa solo si se configura esta marca. Consulta https://github.com/bazelbuild/bazel/issues/10076.
Etiquetas: affects_outputs y incompatible_change
Valor predeterminado de --[no]incompatible_py2_outputs_are_suffixed: "true"
Si es verdadero, los destinos compilados en la configuración de Python 2 aparecerán en una raíz de salida que incluya 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 symlink de conveniencia "bazel-bin" apuntará a los objetivos de Python 3 en lugar de a Python 2. Si habilitas esta opción, también se recomienda habilitar `--incompatible_py3_is_default`.
Etiquetas: affects_outputs y incompatible_change
Valor predeterminado de --[no]incompatible_py3_is_default: "true"
Si el valor es verdadero, los destinos "py_binary" y "py_test" que no establezcan sus atributos "python_version" (o "default_python_version") pasarán a ser PY3 de forma predeterminada en lugar de PY2. Si configuras esta marca, también se recomienda configurar `--incompatible_py2_outputs_are_suffixed`.
Etiquetas: loading_and_analysis, affects_outputs y incompatible_change
Valor predeterminado de --[no]incompatible_use_python_toolchains: "true"
Si se configura como verdadera, las reglas ejecutables nativas de Python 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 y incompatible_change
Valor predeterminado de --python_version=<PY2 or PY3>: ver descripción
El modo de versión principal de Python, ya sea “PY2” o “PY3”. Ten en cuenta que los objetivos "py_binary" y "py_test" anulan esta opción (incluso si no especifican explícitamente una versión), por lo que no suele haber muchos motivos para proporcionar esta marca.
Etiquetas: loading_and_analysis y affects_outputs
Otras opciones, sin categorizar.
--[no]cache_test_results [-t] predeterminada: "automática"
Si se configura como “auto”, Bazel vuelve a ejecutar una prueba solo en los siguientes casos: (1) Bazel detecta cambios en la prueba o sus dependencias, (2) la prueba se marcó como externa, (3) se solicitaron múltiples ejecuciones de prueba con --runs_per_test o(4) la prueba falló anteriormente. Si se configura en "sí", Bazel almacenará en caché todos los resultados de las pruebas, excepto las marcadas como externas. Si la estableces como "no", Bazel no almacenará en caché ningún resultado de prueba.
Valor predeterminado de --[no]experimental_cancel_concurrent_tests: "falso"
Si esta preferencia se establece como "true", Blaze cancelará las pruebas que se estén ejecutando simultáneamente en la primera ejecución correcta. Esto solo es útil en combinación con --runs_per_test_detects_flakes.
Etiquetas: affects_outputs y loading_and_analysis
Valor predeterminado de --[no]experimental_fetch_all_coverage_outputs: "falso"
Si es verdadero, Bazel recupera todo el directorio de datos de cobertura para cada prueba durante una ejecución de cobertura.
Etiquetas: affects_outputs y loading_and_analysis
Valor predeterminado de --[no]experimental_generate_llvm_lcov: "falso"
Si es verdadero, la cobertura de clang generará un informe de LCOV.
Etiquetas: affects_outputs y loading_and_analysis
Valor predeterminado de --[no]experimental_j2objc_header_map: "true"
Establece si se debe generar un mapa de encabezado de J2ObjC en paralelo a la transpilación de J2ObjC.
Valor predeterminado de --[no]experimental_j2objc_shorter_header_path: "falso"
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 clase reducidas para compilaciones de Java.
Valor predeterminado de --[no]experimental_limit_android_lint_to_android_constrained_java: "falso"
Limita las --experimental_run_android_lint_on_java_rules a bibliotecas compatibles con Android.
Etiquetas: affects_outputs
Valor predeterminado de --[no]experimental_run_android_lint_on_java_rules: "falso"
Establece si se deben validar fuentes java_*.
Etiquetas: affects_outputs
Valor predeterminado de --[no]explicit_java_test_deps: "falso"
Especifica de forma explícita una dependencia para JUnit o Hamcrest en una java_test, en lugar de obtener por error de las dependencias de TestRunner. Por el momento, solo funciona para Bazel.
Valor predeterminado de --host_java_launcher=<a build target label>: ver descripción
El selector de Java que usan las herramientas que se ejecutan durante una compilación.
Se acumulan --host_javacopt=<a string> usos múltiples
Opciones adicionales para pasar a javac cuando se compilan herramientas que se ejecutan durante una compilación.
Se acumulan --host_jvmopt=<a string> usos múltiples
Opciones adicionales para pasar a la VM de Java cuando se compilan herramientas que se ejecutan durante la compilación. Estas se agregarán a las opciones de inicio de la VM de cada destino java_binary.
Valor predeterminado de --[no]incompatible_check_sharding_support: "true"
Si es verdadero, Bazel fallará una prueba fragmentada si el ejecutor de pruebas no indica que admite la fragmentación tocando el archivo en la ruta de acceso en TEST_SHARD_STATUS_FILE. Si es falso, un ejecutor de pruebas que no admite la fragmentación dará lugar a que se ejecuten todas las pruebas en cada fragmento.
Etiquetas: incompatible_change
Valor predeterminado de --[no]incompatible_exclusive_test_sandboxed: "true"
Si es verdadero, las pruebas exclusivas se ejecutarán con la estrategia de zona de pruebas. Agregar “local” etiqueta para forzar una ejecución de prueba exclusiva de forma local
Etiquetas: incompatible_change
Valor predeterminado de --[no]incompatible_strict_action_env: "falso"
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 hacerlo puede evitar el almacenamiento en caché entre usuarios si se usa una caché compartida.
Etiquetas: loading_and_analysis y incompatible_change
Se acumulan --j2objc_translation_flags=<comma-separated list of options> usos múltiples
Opciones adicionales para pasar a la herramienta J2ObjC.
--java_debug
Hace que la máquina virtual Java de una prueba de Java espere una conexión desde un depurador compatible con JDWP (como jdb) antes de comenzar 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
Valor predeterminado de --[no]java_deps: "true"
Genera información de dependencia (por ahora, la ruta de clase del tiempo de compilación) por objetivo de Java.
Valor predeterminado de --[no]java_header_compilation: "true"
Compila ijars directamente desde la fuente.
Valor predeterminado de --java_language_version=<a string>: ""
La versión del lenguaje Java
Valor predeterminado de --java_launcher=<a build target label>: ver descripción
Selector de Java que se usa cuando se compilan objetos binarios de Java. Si esta marca se establece en la cadena vacía, se usa el selector de JDK. El "selector" anula esta marca.
--java_runtime_version=<a string> predeterminado: “local_jdk”
La versión del entorno de ejecución de Java
Se acumulan --javacopt=<a string> usos múltiples
Opciones adicionales para pasar a javac.
Se acumulan --jvmopt=<a string> usos múltiples
Opciones adicionales para pasar a la VM de Java. Estas se agregarán a las opciones de inicio de la VM de cada destino java_binary.
Valor predeterminado de --legacy_main_dex_list_generator=<a build target label>: ver descripción
Especifica un objeto binario que se debe usar para generar la lista de clases que deben estar en el DEX principal al compilar multidex heredado.
Valor predeterminado de --optimizing_dexer=<a build target label>: ver descripción
Especifica el objeto binario que se usará para generar archivos dex sin fragmentación.
Se acumulan --plugin=<a build target label> usos múltiples
Complementos para usar en la compilación. Actualmente funciona con java_plugin.
Valor predeterminado de --proguard_top=<a build target label>: ver descripción
Especifica qué versión de ProGuard se debe usar para la eliminación de código al compilar un objeto binario de Java.
--proto_compiler=<a build target label> predeterminado: “@bazel_tools//tools/proto:protoc”
Es la etiqueta del proto-compiler.
Etiquetas: affects_outputs y loading_and_analysis
--proto_toolchain_for_cc=<a build target label> predeterminado: "@bazel_tools//tools/proto:cc_toolchain"
Etiqueta de proto_lang_toolchain() que describe cómo compilar protos de C++
Etiquetas: affects_outputs y loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label> predeterminado: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"
Etiqueta de proto_lang_toolchain() que describe cómo compilar protos j2objc.
Etiquetas: affects_outputs y loading_and_analysis
--proto_toolchain_for_java=<a build target label> predeterminado: "@bazel_tools//tools/proto:java_toolchain"
Etiqueta de proto_lang_toolchain() que describe cómo compilar protos de Java.
Etiquetas: affects_outputs y loading_and_analysis
--proto_toolchain_for_javalite=<a build target label> predeterminado: "@bazel_tools//tools/proto:javalite_toolchain"
Etiqueta de proto_lang_toolchain() que describe cómo compilar protos de JavaLite.
Etiquetas: affects_outputs y loading_and_analysis
Se acumulan --protocopt=<a string> usos múltiples
Opciones adicionales para pasar al compilador de protobuf.
Etiquetas: affects_outputs
Valor predeterminado de --[no]runs_per_test_detects_flakes: "falso"
Si es verdadero, cualquier fragmento en el que se haya completado al menos una ejecución o un intento y al menos una falla o ejecución tendrá un estado FLAKY.
Valor predeterminado de --shell_executable=<a path>: ver descripción
Ruta de acceso absoluta al shell ejecutable para que lo use Bazel. Si no la estableces, pero la variable de entorno BAZEL_SH está establecida en la primera invocación de Bazel (que inicia un servidor de Bazel), Bazel la usará. Si no se establece ninguna, Bazel usa una ruta de acceso predeterminada hard-coded según el sistema operativo en el que se ejecute (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 es compatible con Bash puede generar fallas de compilación o de tiempo de ejecución de los objetos binarios generados.
Etiquetas: loading_and_analysis
Se acumulan --test_arg=<a string> usos múltiples
Especifica las opciones y los argumentos 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 recibirá argumentos idénticos. Solo lo usa la "prueba de Bazel". kubectl.
Valor predeterminado de --test_filter=<a string>: ver descripción
Especifica un filtro para reenviar al framework de prueba. 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 dejó de estar disponible y no tiene efecto.
Valor predeterminado de --[no]test_runner_fail_fast: "falso"
La opción de reenvíos falla con rapidez al ejecutor de pruebas. El ejecutor de pruebas debe detener la ejecución cuando se produce la primera falla.
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce> predeterminado: "explícito"
Especifica la estrategia para la fragmentación de pruebas: “explícita” solo use la fragmentación si el atributo 'shard_count' El atributo BUILD está presente. 'inhabilitado' nunca usen la fragmentación de pruebas. “forced=k” aplicar “k” fragmentos para realizar pruebas sin importar la variable 'shard_count' Build.
Valor predeterminado de --tool_java_language_version=<a string>: ""
La versión de lenguaje Java que se usa para ejecutar las herramientas necesarias durante una compilación
--tool_java_runtime_version=<a string> predeterminado: "remotejdk_11"
La versión del entorno de ejecución de Java que se usa para ejecutar herramientas durante la compilación
Valor predeterminado de --[no]use_ijars: "true"
Si se habilita, esta opción hace que la compilación de Java use archivos jar de la interfaz. Esto dará como resultado 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 --distdir=<a path> usos múltiples
Lugares adicionales para buscar archivos antes de acceder a la red y descargarlos.
Etiquetas: bazel_internal_configuration
Si se configura, la caché del repositorio vinculará el archivo en lugar de copiarlo en caso de que se produzca un acierto de caché. Esto está diseñado para ahorrar espacio en el disco.
Etiquetas: bazel_internal_configuration
Valor predeterminado de --experimental_repository_downloader_retries=<an integer>: "0"
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas: experimental