bazel [<startup options>] <command> [<args>]
bazel [<startup options>] <command> [<args>] -- [<target patterns>]
Sintaxis de opciones
Las opciones se pueden pasar a Bazel de diferentes maneras. Las opciones que requieren un valor se pueden pasar con un signo igual o un espacio:
--<option>=<value> --<option> <value>
-<short_form> <value>
Las opciones booleanas se pueden habilitar de la siguiente manera:
--<option> --<option>=[true|yes|1]
--no<option> --<option>=[false|no|0]
Por lo general, las opciones de tres estados se configuran como automáticas de forma predeterminada y se pueden forzar de la siguiente manera:
--<option>=[true|yes|1]
--no<option> --<option>=[false|no|0]
Comandos
analyze-profile |
Analiza los datos del perfil de compilación. |
aquery |
Analiza los objetivos determinados y consulta el gráfico de acciones. |
build |
Compila los destinos especificados. |
canonicalize-flags |
Canoniza una lista de opciones de Bazel. |
clean |
Quita los archivos de salida y, de manera opcional, detiene el servidor. |
coverage |
Genera un informe de cobertura de código para los destinos de prueba especificados. |
cquery |
Carga, analiza y consulta los destinos especificados con configuraciones. |
dump |
Genera un volcado del estado interno del proceso del servidor de Bazel. |
fetch |
Recupera repositorios externos que son requisitos previos para los destinos. |
help |
Imprime ayuda para los 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 destinos en dispositivos móviles. |
mod |
Consulta el gráfico de dependencias externas de Bzlmod. |
print_action |
Imprime los argumentos de la línea de comandos para compilar un archivo. |
query |
Ejecuta una consulta de gráfico de dependencias. |
run |
Ejecuta el destino especificado. |
shutdown |
Detiene el servidor de Bazel. |
sync |
Sincroniza todos los repositorios especificados en el archivo del lugar de trabajo. |
test |
Compila y ejecuta los destinos de prueba especificados. |
version |
Imprime la información de la versión de bazel. |
Opciones de inicio
- Opciones que aparecen antes del comando y que el cliente analiza:
--[no]autodetect_server_javabase
predeterminado: "true"-
Cuando se pasa --noautodetect_server_javabase, Bazel no recurre al JDK local para ejecutar el servidor de Bazel y, en su lugar, sale.
Etiquetas:affects_outputs
,loses_incremental_state
--[no]batch
predeterminado: “false”-
Si se establece, Bazel se ejecutará solo como un proceso de cliente sin un servidor, en lugar de en el modo cliente-servidor estándar. Esta función dejó de estar disponible y se quitará. Si quieres evitar que los servidores permanezcan en el sistema, cierra el servidor de forma explícita.
Etiquetas:loses_incremental_state
,bazel_internal_configuration
,deprecated
--[no]batch_cpu_scheduling
predeterminado: “false”-
Solo en Linux. Usa la programación de CPU "por lotes" para Blaze. Esta política es útil para cargas de trabajo que no son interactivas, pero no quieren disminuir su valor de agrado. Consulta "man 2 sched_setscheduler". Si es falso, Bazel no realiza una llamada al sistema.
Etiquetas:host_machine_resource_optimizations
--bazelrc=<path>
predeterminado: Consulta la descripción-
Es 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 de usuario, p.ej., en compilaciones de lanzamiento.
Esta opción también se puede especificar varias veces.
Por ejemplo, con `--bazelrc=x.rc --bazelrc=y.rc --bazelrc=/dev/null --bazelrc=z.rc`,
1) Se leen x.rc y y.rc.
2) Se ignora z.rc debido al /dev/null anterior.
Si no se especifica, Bazel usa el primer archivo .bazelrc que encuentra en las siguientes dos ubicaciones: el directorio del lugar de trabajo y, luego, el directorio principal del usuario.
Nota: Las opciones de línea de comandos siempre reemplazarán cualquier opción en bazelrc.
Etiquetas:changes_inputs
--[no]block_for_lock
predeterminado: "true"-
Cuando se pasa --noblock_for_lock, Bazel no espera a que se complete un comando en ejecución, sino que sale de inmediato.
Etiquetas:eagerness_to_exit
--[no]client_debug
predeterminado: “false”-
Si es verdadero, registra la información de depuración del cliente en stderr. Cambiar esta opción no hará que se reinicie el servidor.
Etiquetas:affects_outputs
,bazel_monitoring
--connect_timeout_secs=<an integer>
predeterminado: “30”-
Es la cantidad de tiempo que el cliente espera por cada intento de conexión al servidor.
Etiquetas:bazel_internal_configuration
--[no]expand_configs_in_place
predeterminado: "true"-
Se cambió la expansión de las marcas --config para que se realice en el lugar, en lugar de una expansión de punto fijo entre las opciones de rc normales y las opciones especificadas en la línea de comandos.
Etiquetas:no_op
,deprecated
--failure_detail_out=<path>
predeterminado: Consulta la descripción-
Si se establece, especifica una ubicación para escribir un mensaje de protobuf failure_detail si el servidor experimenta una falla y no puede informarla a través de gRPC, como de costumbre. De lo contrario, la ubicación será ${OUTPUT_BASE}/failure_detail.rawproto.
Etiquetas:affects_outputs
,loses_incremental_state
--[no]home_rc
predeterminado: "true"-
Determina si se debe buscar o no el archivo bazelrc de inicio en $HOME/.bazelrc.
Etiquetas:changes_inputs
--[no]idle_server_tasks
predeterminado: "true"-
Ejecuta System.gc() cuando el servidor esté inactivo.
Etiquetas:loses_incremental_state
,host_machine_resource_optimizations
--[no]ignore_all_rc_files
predeterminado: “false”-
Inhabilita todos los archivos rc, independientemente de los valores de otras marcas que modifiquen rc, incluso si estas marcas aparecen más adelante en la lista de opciones de inicio.
Etiquetas:changes_inputs
--io_nice_level={-1,0,1,2,3,4,5,6,7}
predeterminado: “-1”-
Solo en Linux. Establece un nivel de 0 a 7 para la programación de E/S del mejor esfuerzo con la llamada al sistema sys_ioprio_set. 0 es la prioridad más alta y 7 es la más baja. El programador anticipado solo puede respetar hasta la prioridad 4. Si se establece en un valor negativo, Bazel no realiza una llamada al sistema.
Etiquetas:host_machine_resource_optimizations
--local_startup_timeout_secs=<an integer>
predeterminado: "120"-
Es la cantidad máxima de tiempo que el cliente espera para conectarse al servidor.
Etiquetas:bazel_internal_configuration
--macos_qos_class=<a string>
predeterminado: "predeterminado"-
Establece la clase de servicio de QoS del servidor bazel cuando se ejecuta en macOS. Esta marca no tiene efecto en 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 con el usuario, iniciado por el usuario, predeterminado, de utilidad y en segundo plano.
Etiquetas:host_machine_resource_optimizations
--max_idle_secs=<integer>
predeterminado: “10800”-
Es la cantidad de segundos que el servidor de compilación esperará inactivo antes de apagarse. Cero significa que el servidor nunca se cerrará. Solo se lee al iniciar el servidor. Cambiar esta opción no hará que el servidor se reinicie.
Etiquetas:eagerness_to_exit
,loses_incremental_state
--output_base=<path>
predeterminado: Consulta la descripción-
Si se establece, especifica la ubicación de salida a la que se escribirá todo el resultado 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 espacio de trabajo. Sin embargo, con esta opción, puedes tener varias bases de salida por espacio de trabajo y, de esta manera, ejecutar varias compilaciones para el mismo cliente en la misma máquina de forma simultánea. Consulta "bazel help shutdown" para obtener información sobre cómo cerrar un servidor de Bazel.
Etiquetas:affects_outputs
,loses_incremental_state
--output_user_root=<path>
predeterminado: Consulta la descripción-
Es el directorio específico del usuario debajo del cual se escriben todos los resultados de la compilación. De forma predeterminada, esta es una función de $USER, pero si especificas una constante, los resultados de la compilación se pueden compartir entre los usuarios que colaboran.
Etiquetas:affects_outputs
,loses_incremental_state
--[no]preemptible
predeterminado: “false”-
Si es verdadero, el comando se puede anular si se inicia otro comando.
Etiquetas:eagerness_to_exit
--server_jvm_out=<path>
predeterminado: Consulta la descripción-
Es la ubicación en la que se escribirá el resultado de la JVM del servidor. Si no se establece, se establece de forma predeterminada en una ubicación en output_base.
Etiquetas:affects_outputs
,loses_incremental_state
--[no]shutdown_on_low_sys_mem
predeterminado: “false”-
Si se configuró max_idle_secs y el servidor de compilación estuvo inactivo durante un tiempo, cierra el servidor cuando el sistema tenga poca RAM libre. Solo en Linux.
Etiquetas:eagerness_to_exit
,loses_incremental_state
--[no]system_rc
predeterminado: "true"-
Indica si se debe buscar o no el bazelrc en todo el sistema.
Etiquetas:changes_inputs
--[no]unlimit_coredumps
predeterminado: “false”-
Aumenta el límite de volcado de núcleo suave al límite duro para que se puedan crear volcados de núcleo del servidor (incluida la JVM) y del cliente en condiciones comunes. Agrega esta marca a tu bazelrc una vez y olvídate de ella para obtener volcados de memoria principal cuando encuentres una condición que los active.
Etiquetas:bazel_internal_configuration
--[no]watchfs
predeterminado: “false”-
Si es verdadero, bazel intenta usar el servicio de supervisión de archivos del sistema operativo para los cambios locales en lugar de analizar cada archivo en busca de cambios.
Etiquetas:deprecated
--[no]windows_enable_symlinks
predeterminado: “false”-
Si es verdadero, se crearán vínculos simbólicos reales en Windows en lugar de copiar archivos. Requiere que se habilite el modo de desarrollador de Windows y que se ejecute Windows 10 versión 1703 o posterior.
Etiquetas:bazel_internal_configuration
--[no]workspace_rc
predeterminado: "true"-
Determina si se debe buscar o no el archivo bazelrc del espacio de trabajo en $workspace/.bazelrc.
Etiquetas:changes_inputs
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--host_jvm_args=<jvm_arg>
. - Son marcas para pasar a la JVM que ejecuta Blaze.
--host_jvm_debug
-
Opción de conveniencia para agregar algunas marcas de inicio adicionales de JVM, 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
--host_jvm_profile=<profiler_name>
predeterminado: ""- Opción de conveniencia para agregar algunas marcas de inicio de JVM específicas del generador de perfiles o depurador. Bazel tiene una lista de valores conocidos que asigna a marcas de inicio de JVM codificadas, posiblemente buscando algunas rutas de acceso fijas para ciertos archivos.
--server_javabase=<jvm path>
predeterminado: ""- Ruta de acceso a la JVM que se usa para ejecutar Bazel.
Opciones comunes a todos los comandos
- Opciones que controlan la ejecución de la compilación:
--experimental_ui_max_stdouterr_bytes=<an integer in (-1)-1073741819 range>
predeterminado: “1048576”-
Es el tamaño máximo de los archivos stdout / stderr que se imprimirán en la consola. -1 implica que no hay límite.
Etiquetas:execution
--[no]incompatible_remote_dangling_symlinks
predeterminado: "true"-
Si se establece como verdadero y --incompatible_remote_symlinks también es verdadero, los symlinks en los resultados de la acción pueden colgar.
Etiquetas:execution
,incompatible_change
--[no]incompatible_remote_symlinks
predeterminado: "true"-
Si se establece como verdadero, Bazel representará los symlinks en los resultados de la acción en el protocolo de ejecución o almacenamiento en caché remoto como tal. De lo contrario, se seguirán los symlinks y se representarán como archivos o directorios. Consulta el problema #6631 para obtener más información.
Etiquetas:execution
,incompatible_change
- Opciones que configuran la cadena de herramientas que se usa para la ejecución de acciones:
--[no]incompatible_enable_proto_toolchain_resolution
predeterminado: “false”-
Si es verdadero, las reglas de proto lang definen cadenas de herramientas de los repositorios rules_proto, rules_java y rules_cc.
Etiquetas
:loading_and_analysis
,incompatible_change
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
--bep_maximum_open_remote_upload_files=<an integer>
predeterminado: “-1”-
Cantidad máxima de archivos abiertos permitidos durante la carga de artefactos de BEP.
Etiquetas:affects_outputs
--remote_download_all
-
Descarga todos los resultados remotos en la máquina local. Esta marca es un alias para --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 a la máquina local. Esta marca es un alias para --remote_download_outputs=minimal.
Se expande a:
--remote_download_outputs=minimal
Etiquetas:affects_outputs
--remote_download_outputs=<all, minimal or toplevel>
predeterminado: "toplevel"-
Si se establece en "minimal", no se descargan resultados de compilación remotas en la máquina local, excepto los que requieren las acciones locales. Si se establece en "toplevel", se comporta como "minimal", excepto que también descarga los resultados de los destinos de nivel superior en la máquina local. Ambas opciones pueden reducir significativamente los tiempos de compilación si el ancho de banda de la red es un cuello de botella.
Etiquetas:affects_outputs
--remote_download_symlink_template=<a string>
predeterminado: ""-
En lugar de descargar resultados de compilación remotos en la máquina local, crea vínculos simbólicos. El destino de los vínculos simbólicos se puede especificar en forma de una cadena de plantilla. Esta cadena de plantilla puede contener {hash} y {size_bytes} que se expanden al hash del objeto y al tamaño en bytes, respectivamente. Estos vínculos simbólicos pueden, por ejemplo, apuntar a un sistema de archivos FUSE que cargue objetos del CAS a pedido.
Etiquetas:affects_outputs
--remote_download_toplevel
- Solo descarga resultados remotos de destinos de nivel superior en la máquina local. Esta marca es un alias para --remote_download_outputs=toplevel.
Se expande a:
--remote_download_outputs=toplevel
Etiquetas:affects_outputs
- Se acumulan varios usos de
--repo_env=<a 'name=value' assignment with an optional value part>
. - especifica variables de entorno adicionales que estarán disponibles solo para las reglas del repositorio. Ten en cuenta que, de todos modos, las reglas del repositorio ven el entorno completo, pero de esta manera la información de configuración se puede pasar a los repositorios a través de opciones sin invalidar el gráfico de acciones.
Etiquetas:action_command_lines
- Opciones que afectan la rigurosidad con la que Bazel aplica entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
--[no]check_bzl_visibility
predeterminado: "true"-
Si se inhabilita, los errores de visibilidad de carga de .bzl se degradan a advertencias.
Etiquetas:build_file_semantics
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.:
--[no]enable_bzlmod
predeterminado: "true"-
Si es verdadero, habilita el sistema de administración de dependencias de Bzlmod, que tiene prioridad sobre WORKSPACE. Consulta https://bazel.build/docs/bzlmod para obtener más información.
Etiquetas:loading_and_analysis
--[no]experimental_action_resource_set
predeterminado: "true"-
Si se establece 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
,experimental
--[no]experimental_bzl_visibility
predeterminado: "true"-
Si está habilitada, 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 el fin de las sentencias load().
Etiquetas:loading_and_analysis
,experimental
-
Si se establece como verdadero, los atributos de reglas y los métodos de la API de Starlark necesarios para la regla cc_shared_library estarán disponibles.
Etiquetas:build_file_semantics
,loading_and_analysis
,experimental
--[no]experimental_disable_external_package
predeterminado: “false”-
Si se establece en verdadero, el paquete //external generado automáticamente ya no estará disponible. Bazel aún no podrá analizar el archivo "external/BUILD", pero funcionarán los globs que lleguen a external/ desde el paquete sin nombre.
Etiquetas:loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_enable_android_migration_apis
predeterminado: “false”-
Si se establece como verdadero, habilita las APIs necesarias para admitir la migración de Starlark de Android.
Etiquetas:build_file_semantics
--[no]experimental_enable_scl_dialect
predeterminado: “false”-
Si se establece como verdadero, se pueden usar archivos .scl en las sentencias load().
Etiquetas:build_file_semantics
--[no]experimental_google_legacy_api
predeterminado: “false”-
Si se establece en "true", expone varias partes experimentales de la API de compilación de Starlark relacionadas con el código heredado de Google.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_isolated_extension_usages
predeterminado: “false”-
Si es verdadero, habilita el parámetro <code>isolate</code> en la función <a href="https://bazel.build/rules/lib/globals/module#use_extension"><code>use_extension</code></a>.
Etiquetas:loading_and_analysis
--[no]experimental_java_library_export
predeterminado: “false”-
Si está habilitado, el módulo experimental_java_library_export_do_not_use está disponible.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]experimental_platforms_api
predeterminado: “false”-
Si se establece como verdadero, habilita varias APIs de Starlark relacionadas con la plataforma que son útiles para depurar.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repo_remote_exec
predeterminado: “false”-
Si se establece como verdadero, repository_rule obtiene algunas capacidades de ejecución remota.
Etiquetas:build_file_semantics
,loading_and_analysis
,experimental
--[no]experimental_sibling_repository_layout
predeterminado: “false”-
Si se establece como verdadero, los repositorios que no son principales se plantan como 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 directorio "externo" de nivel superior real.
Etiquetas:action_command_lines
,bazel_internal_configuration
,loading_and_analysis
,loses_incremental_state
,experimental
-
Si se establece como verdadero, las etiquetas se propagarán de un objetivo a los requisitos de ejecución de las acciones. De lo contrario, no se propagarán. Consulta https://github.com/bazelbuild/bazel/issues/8830 para obtener más información.
Etiquetas:build_file_semantics
,experimental
--[no]incompatible_always_check_depset_elements
predeterminado: "true"-
Verifica la validez de los elementos agregados a los conjuntos de dependencias en todos los constructores. Los elementos deben ser inmutables, pero, históricamente, el constructor depset(direct=…) se olvidó de verificarlo. Usa tuplas en lugar de listas en los elementos de depset. Consulta https://github.com/bazelbuild/bazel/issues/10313 para obtener más información.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_depset_for_java_output_source_jars
predeterminado: "true"-
Cuando es verdadero, Bazel ya no muestra una lista de java_info.java_output[0].source_jars, sino un conjunto de dependencias.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_depset_for_libraries_to_link_getter
predeterminado: "true"-
Cuando es verdadero, Bazel ya no muestra una lista de linking_context.libraries_to_link, sino un conjunto de dependencias.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_disable_objc_library_transition
predeterminado: "true"-
Inhabilita la transición personalizada de objc_library y hereda del destino de nivel superior en su lugar
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_disable_starlark_host_transitions
predeterminado: “false”-
Si se establece como verdadero, los atributos de la regla no pueden establecer "cfg = "host"'. En su lugar, las reglas deben establecer "cfg = "exec"'.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_disable_target_provider_fields
predeterminado: “false”-
Si se establece como verdadero, inhabilita la capacidad de acceder a los proveedores en objetos "objetivo" a través de la sintaxis de campo. 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 dentro de una función de implementación de reglas, usa "ctx.attr.dep[MyInfo]". Consulta https://github.com/bazelbuild/bazel/issues/9014 para obtener más información.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_disallow_empty_glob
predeterminado: “false”-
Si se establece en verdadero, el valor predeterminado del argumento "allow_empty" de glob() es falso.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_disallow_struct_provider_syntax
predeterminado: “false”-
Si se establece como verdadero, es posible que las funciones de implementación de reglas no muestren una struct. En su lugar, deben mostrar una lista de instancias del proveedor.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_existing_rules_immutable_view
predeterminado: "true"-
Si se establece como verdadero, native.existing_rule y native.existing_rules muestran objetos de vista inmutables ligeros en lugar de diccionarios mutables.
Etiquetas:build_file_semantics
,loading_and_analysis
,incompatible_change
--[no]incompatible_fail_on_unknown_attributes
predeterminado: "true"-
Si está habilitada, fallan los objetivos que tienen atributos desconocidos establecidos en Ninguno.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_fix_package_group_reporoot_syntax
predeterminado: "true"-
En el atributo "packages" de package_group, cambia el significado del valor "//…" para que haga referencia a todos los paquetes del repositorio actual en lugar de a todos los paquetes de cualquier repositorio. Puedes usar el valor especial "public" en lugar de "//…" para obtener el comportamiento anterior. Esta marca requiere que también se habilite --incompatible_package_group_has_public_syntax.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_java_common_parameters
predeterminado: "true"-
Si se establece como verdadero, se quitarán todos los parámetros output_jar y host_javabase en pack_sources y host_javabase en compile.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_merge_fixed_and_default_shell_env
predeterminado: "true"-
Si está habilitada, las acciones registradas con ctx.actions.run y ctx.actions.run_shell con "env" y "use_default_shell_env = True" especificadas usarán un entorno obtenido del entorno de shell predeterminado anulando con los valores pasados a "env". Si se inhabilita, el valor de "env" se ignora por completo en este caso.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_new_actions_api
predeterminado: "true"-
Si se establece como verdadero, la API para crear acciones solo está disponible en "ctx.actions", no en "ctx".
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_no_attr_license
predeterminado: "true"-
Si se establece como verdadero, inhabilita la función "attr.license".
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_no_implicit_file_export
predeterminado: “false”-
Si se establece, los archivos de origen (usados) son privados del paquete, a menos que se exporten de forma explícita. Consulta https://github.com/bazelbuild/proposals/blob/master/designs/2019-10-24-file-visibility.md
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_no_rule_outputs_param
predeterminado: “false”-
Si se establece como verdadero, inhabilita el parámetro "outputs" de la función Starlark "rule()</quot;.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_objc_provider_remove_linking_info
predeterminado: “false”-
Si se establece como verdadero, se quitarán las APIs de ObjcProvider para vincular información.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_package_group_has_public_syntax
predeterminado: "true"-
En el atributo "packages" de package_group, permite escribir "public" o "private" para hacer referencia a todos los paquetes o a ninguno, respectivamente.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_require_linker_input_cc_api
predeterminado: "true"-
Si se establece como verdadero, la regla create_linking_context requerirá linker_inputs en lugar de libraries_to_link. Los antiguos métodos get de linking_context también se inhabilitarán y solo estarán disponibles los métodos linker_inputs.
Etiquetas:build_file_semantics
,loading_and_analysis
,incompatible_change
--[no]incompatible_run_shell_command_string
predeterminado: "true"-
Si se establece como verdadero, el parámetro de comando de actions.run_shell solo aceptará cadenas
de etiquetas
:build_file_semantics
,incompatible_change
--[no]incompatible_stop_exporting_language_modules
predeterminado: “false”-
Si está habilitado, ciertos módulos específicos de lenguaje (como "cc_common") no están disponibles en los archivos .bzl del usuario y solo se puede llamar desde sus respectivos repositorios de reglas.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_struct_has_no_methods
predeterminado: “false”-
Inhabilita los métodos to_json y to_proto de struct, que contaminan el espacio de nombres del campo struct. En su lugar, usa json.encode o json.encode_indent para JSON, o proto.encode_text para textproto.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_top_level_aspects_require_providers
predeterminado: “false”-
Si se establece como verdadero, el aspecto de nivel superior respetará sus proveedores obligatorios y solo se ejecutará en los destinos de nivel superior cuyos proveedores anunciados por las reglas satisfagan los proveedores obligatorios del aspecto.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_unambiguous_label_stringification
predeterminado: "true"-
Cuando sea verdadero, Bazel convertirá la etiqueta @//foo:bar en @//foo:bar, en lugar de //foo:bar. Esto solo afecta el comportamiento de str(), el operador %, etcétera. El comportamiento de repr() no cambia. Consulta https://github.com/bazelbuild/bazel/issues/15916 para obtener más información.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_use_cc_configure_from_rules_cc
predeterminado: “false”-
Cuando sea verdadero, Bazel ya no permitirá usar cc_configure desde @bazel_tools. Consulta https://github.com/bazelbuild/bazel/issues/10134 para obtener detalles y las instrucciones de migración.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_visibility_private_attributes_at_definition
predeterminado: "true"-
Si se establece como "true", se verifica la visibilidad de los atributos de reglas privadas en relación con la definición de la regla y, si no es visible, se recurre al uso de la regla.
Etiquetas:build_file_semantics
,incompatible_change
--max_computation_steps=<a long integer>
predeterminado: “0”-
Es 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
--nested_set_depth_limit=<an integer>
predeterminado: “3500”-
Es la profundidad máxima del gráfico interno de un conjunto de dependencias (también conocido como NestedSet), por encima de la cual fallará el constructor de depset().
Etiquetas:loading_and_analysis
- Opciones que activan optimizaciones del tiempo de compilación:
--[no]heuristically_drop_nodes
predeterminado: “false”-
Si es verdadero, Blaze quitará los nodos FileState y DirectoryListingState después de que se complete el nodo File y DirectoryListing relacionados para ahorrar memoria. Esperamos que sea menos probable que se vuelvan a necesitar estos nodos. Si es así, el programa los volverá a evaluar.
Etiquetas:loses_incremental_state
--[no]incompatible_do_not_split_linking_cmdline
predeterminado: "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 forma selectiva qué marcas van al archivo de parámetros y cuáles no. Consulta https://github.com/bazelbuild/bazel/issues/7670 para obtener más información.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]keep_state_after_build
predeterminado: "true"-
Si es falso, Blaze descartará el estado en memoria de esta compilación cuando esta finalice. Las compilaciones posteriores no tendrán ninguna incrementalidad con respecto a esta.
Etiquetas:loses_incremental_state
--[no]track_incremental_state
predeterminado: "true"-
Si es falso, Blaze no conservará los datos que permiten 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, querrás especificar --batch cuando establezcas este valor en falso.
Etiquetas:loses_incremental_state
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]announce_rc
predeterminado: “false”-
Indica si se deben anunciar las opciones de rc.
Etiquetas:affects_outputs
--[no]attempt_to_print_relative_paths
predeterminado: “false”-
Cuando imprimas la parte de 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
--bes_backend=<a string>
predeterminado: ""-
Especifica el extremo de backend del servicio de eventos de compilación (BES) en el formato [SCHEME://]HOST[:PORT]. La opción predeterminada es inhabilitar las cargas de BES. Los esquemas compatibles son grpc y grpcs (grpc con TLS habilitado). Si no se proporciona un esquema, Bazel supone que se trata de GRPC.
Etiquetas:affects_outputs
--[no]bes_check_preceding_lifecycle_events
predeterminado: “false”-
Establece el campo check_preceding_lifecycle_events_present en PublishBuildToolEventStreamRequest, que le indica a BES que verifique si recibió anteriormente eventos InvocationAttemptStarted y BuildEnqueued que coincidan con el evento de herramienta actual.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--bes_header=<a 'name=value' assignment>
. -
Especifica un encabezado en el formato NAME=VALUE que se incluirá en las solicitudes de BES. Se pueden pasar varios encabezados si especificas la marca varias veces. Los múltiples valores para el mismo nombre se convertirán en una lista separada por comas.
Etiquetas:affects_outputs
--bes_instance_name=<a string>
predeterminado: Consulta la descripción-
Especifica el nombre de la instancia en la que el BES conservará el BEP subido. La configuración predeterminada es nula.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--bes_keywords=<comma-separated list of options>
. -
Especifica una lista de palabras clave de notificación que se agregarán al conjunto predeterminado de palabras clave publicadas en BES ("command_name=<command_name> ", "protocol_name=BEP"). El valor predeterminado es ninguno.
Etiquetas:affects_outputs
--[no]bes_lifecycle_events
predeterminado: "true"-
Especifica si se deben publicar eventos del ciclo de vida de BES. (el valor predeterminado es "true").
Etiquetas:affects_outputs
--bes_oom_finish_upload_timeout=<An immutable length of time.>
predeterminado: "10m"-
Especifica cuánto tiempo debe esperar bazel para que se complete la carga de BES/BEP mientras se produce una falta de memoria. Esta marca garantiza la finalización cuando la JVM tiene una fragmentación grave de GC y no puede avanzar en ningún subproceso de usuario.
Etiquetas:bazel_monitoring
--bes_outerr_buffer_size=<an integer>
predeterminado: “10240”-
Especifica el tamaño máximo de stdout o stderr que se almacenará en búfer en BEP, antes de que se informe como un evento de progreso. Las operaciones de escritura individuales se siguen informando en un solo evento, incluso si son más grandes que el valor especificado hasta --bes_outerr_chunk_size.
Etiquetas:affects_outputs
--bes_outerr_chunk_size=<an integer>
predeterminado: “1048576”-
Especifica el tamaño máximo de stdout o stderr que se enviará a BEP en un solo mensaje.
Etiquetas:affects_outputs
--bes_proxy=<a string>
predeterminado: Consulta la descripción- Conéctate al servicio de eventos de compilación a través de un proxy. Actualmente, esta marca solo se puede usar para configurar un socket de dominio Unix (unix:/path/to/socket).
--bes_results_url=<a string>
predeterminado: ""-
Especifica la URL base en la que un usuario puede ver la información transmitida al backend de BES. Bazel mostrará la URL que el ID de invocación adjuntó a la terminal.
Etiquetas:terminal_output
- Se acumulan varios usos de
--bes_system_keywords=<comma-separated list of options>
. -
Especifica una lista de palabras clave de notificación que se incluirán directamente, sin el prefijo "user_keyword=" para las palabras clave proporcionadas a través de --bes_keywords. Se diseñó para operadores de servicios de compilación que establecen --bes_lifecycle_events=false y que incluyen palabras clave cuando llaman a PublishLifecycleEvent. La compilación de operadores de servicio con esta marca debería evitar que los usuarios anulen el valor de la marca.
Etiquetas:affects_outputs
--bes_timeout=<An immutable length of time.>
predeterminado: “0s”-
Especifica cuánto tiempo debe esperar bazel para que se complete la carga de BES/BEP después de que finalicen la compilación y las pruebas. Un tiempo de espera válido es un número natural seguido de una unidad: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). El valor predeterminado es "0", lo que significa que no hay tiempo de espera.
Etiquetas:affects_outputs
--bes_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>
predeterminado: "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 terminar la carga en segundo plano. Puede ser "wait_for_upload_complete" (predeterminada), "nowait_for_upload_complete" o "fully_async".
Etiquetas:eagerness_to_exit
--build_event_binary_file=<a string>
predeterminado: ""-
Si no está vacío, escribe una representación binaria delimitada por varint del protocolo de eventos de compilación en ese archivo. Esta opción implica --bes_upload_mode=wait_for_upload_complete.
Etiquetas:affects_outputs
--[no]build_event_binary_file_path_conversion
predeterminado: "true"-
Convierte las rutas de acceso en la representación de archivo binario del protocolo de evento de compilación a URIs válidos de forma más global siempre que sea posible. Si se inhabilita, siempre se usará el esquema de URI file://.
Etiquetas:affects_outputs
--build_event_binary_file_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>
predeterminado: "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 terminar la carga en segundo plano. Puede ser "wait_for_upload_complete" (predeterminada), "nowait_for_upload_complete" o "fully_async".
Etiquetas:eagerness_to_exit
--build_event_json_file=<a string>
predeterminado: ""-
Si no está vacío, escribe una serialización JSON del protocolo del evento de compilación en ese archivo. Esta opción implica --bes_upload_mode=wait_for_upload_complete.
Etiquetas:affects_outputs
--[no]build_event_json_file_path_conversion
predeterminado: "true"-
Convierte las rutas de acceso en la representación del archivo JSON del protocolo de evento de compilación a URIs más válidos a nivel global siempre que sea posible. Si se inhabilita, siempre se usará el esquema de URI file://.
Etiquetas:affects_outputs
--build_event_json_file_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>
predeterminado: "wait_for_upload_complete"-
Especifica si la carga del servicio de eventos de compilación para --build_event_json_file debe bloquear la finalización de la compilación o finalizar la invocación de inmediato y terminar la carga en segundo plano. Puede ser "wait_for_upload_complete" (predeterminada), "nowait_for_upload_complete" o "fully_async".
Etiquetas:eagerness_to_exit
--build_event_max_named_set_of_file_entries=<an integer>
predeterminado: “-1”-
Es la cantidad máxima de entradas para un solo evento named_set_of_files. Se ignoran los valores menores que 2 y no se realiza ninguna división de eventos. El objetivo es limitar el tamaño máximo del evento en el protocolo de eventos de compilación, aunque no controla directamente el tamaño del evento. El tamaño total del evento es una función de la estructura del conjunto, así como de las longitudes del archivo y del URI, que a su vez pueden depender de la función hash.
Etiquetas:affects_outputs
--[no]build_event_publish_all_actions
predeterminado: “false”-
Indica si se deben publicar todas las acciones.
Etiquetas:affects_outputs
--build_event_text_file=<a string>
predeterminado: ""-
Si no está vacío, escribe una representación textual del protocolo del evento de compilación en ese archivo.
Etiquetas:affects_outputs
--[no]build_event_text_file_path_conversion
predeterminado: "true"-
Convierte las rutas de acceso en la representación del archivo de texto del protocolo del evento de compilación a URIs más válidos a nivel global siempre que sea posible. Si se inhabilita, siempre se usará el esquema de URI file://.
Etiquetas:affects_outputs
--build_event_text_file_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>
predeterminado: "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 terminar la carga en segundo plano. Puede ser "wait_for_upload_complete" (predeterminada), "nowait_for_upload_complete" o "fully_async".
Etiquetas:eagerness_to_exit
--[no]experimental_announce_profile_path
predeterminado: “false”-
Si está habilitado, agrega la ruta de acceso del perfil JSON al registro.
Etiquetas:bazel_monitoring
--[no]experimental_bep_target_summary
predeterminado: “false”- Determina si se deben publicar eventos TargetSummary.
--[no]experimental_build_event_expand_filesets
predeterminado: “false”-
Si es verdadero, expande los conjuntos de archivos en el BEP cuando se presenten los archivos de salida.
Etiquetas:affects_outputs
--[no]experimental_build_event_fully_resolve_fileset_symlinks
predeterminado: “false”-
Si es verdadero, resuelve completamente los symlinks de conjuntos de archivos relativos en el BEP cuando se presentan archivos de salida. Requiere --experimental_build_event_expand_filesets.
Etiquetas:affects_outputs
--experimental_build_event_upload_max_retries=<an integer>
predeterminado: “4”-
Es la cantidad máxima de veces que Bazel debe volver a intentar subir un evento de compilación.
Etiquetas:bazel_internal_configuration
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
predeterminado: "1s"-
Retraso inicial mínimo para los reintentos de retirada exponencial cuando falla la carga de BEP. (exponente: 1.6)
Etiquetas:bazel_internal_configuration
--experimental_build_event_upload_strategy=<a string>
predeterminado: Consulta la descripción-
Selecciona cómo subir artefactos a los que se hace referencia en el protocolo del evento de compilación.
Etiquetas:affects_outputs
--[no]experimental_collect_load_average_in_profiler
predeterminado: "true"- Si está habilitado, el generador de perfiles recopila el promedio de carga general del sistema.
Etiquetas:bazel_monitoring
--[no]experimental_collect_pressure_stall_indicators
predeterminado: “false”-
Si está habilitado, el generador de perfiles recopila los datos de PSI de Linux.
Etiquetas:bazel_monitoring
--[no]experimental_collect_resource_estimation
predeterminado: “false”-
Si está habilitado, el generador de perfiles recopila una estimación del uso de CPU y memoria para las acciones locales.
Etiquetas:bazel_monitoring
--[no]experimental_collect_system_network_usage
predeterminado: “false”-
Si está habilitado, el generador de perfiles recopila el uso de red del sistema.
Etiquetas:bazel_monitoring
--[no]experimental_collect_worker_data_in_profiler
predeterminado: “false”-
Si está habilitado, el generador de perfiles recopila los datos de recursos agregados del trabajador.
Etiquetas:bazel_monitoring
- Se acumulan varios usos de
--experimental_profile_additional_tasks=<phase, action, action_check, action_lock, action_release, action_update, action_complete, bzlmod, info, create_package, remote_execution, local_execution, scanner, local_parse, upload_time, 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>
. -
Especifica las tareas de perfil adicionales que se incluirán en el perfil.
Etiquetas:bazel_monitoring
--[no]experimental_profile_include_primary_output
predeterminado: “false”-
Incluye el atributo "out" adicional en los eventos de acción que contiene la ruta de ejecución al resultado principal de la acción.
Etiquetas:bazel_monitoring
--[no]experimental_profile_include_target_label
predeterminado: “false”-
Incluye la etiqueta de destino en los datos del perfil JSON de los eventos de acción.
Etiquetas:bazel_monitoring
--[no]experimental_run_bep_event_include_residue
predeterminado: “false”-
Indica si se debe incluir el residuo de la línea de comandos en los eventos de compilación de ejecución que podrían contener el residuo. De forma predeterminada, el residuo no se incluye en los eventos de compilación del comando de ejecución que podrían contenerlo.
Etiquetas:affects_outputs
--[no]experimental_stream_log_file_uploads
predeterminado: “false”-
El archivo de registro de transmisión se sube directamente al almacenamiento remoto en lugar de escribirlo en el disco.
Etiquetas:affects_outputs
--experimental_workspace_rules_log_file=<a path>
predeterminado: Consulta la descripción- Registra ciertos eventos de las reglas de Workspace en este archivo como protos de WorkspaceEvent delimitados.
--[no]generate_json_trace_profile
predeterminado: “auto”-
Si está habilitado, Bazel genera perfiles de la compilación y escribe un perfil en formato JSON en un archivo de la base de salida. Para ver el perfil, carga chrome://tracing. De forma predeterminada, Bazel escribe el perfil para todos los comandos y consultas similares a la compilación.
Etiquetas:bazel_monitoring
--[no]heap_dump_on_oom
predeterminado: “false”-
Indica si se debe generar manualmente un volcado de montón si se genera una OOM (incluidas las OOM manuales debido a que se alcanzan los --gc_thrashing_limits). El volcado se escribirá en <output_base>/<invocation_id>.heapdump.hprof. Esta opción reemplaza de manera efectiva -XX:+HeapDumpOnOutOfMemoryError, que no tiene efecto en los OOM manuales.
Etiquetas:bazel_monitoring
--[no]legacy_important_outputs
predeterminado: "true"-
Usa esto para suprimir la generación del campo important_outputs heredado en el evento TargetComplete. important_outputs es obligatorio para la integración de Bazel en ResultStore.
Etiquetas:affects_outputs
--logging=<0 <= an integer <= 6>
predeterminado: “3”- : Es el nivel de registro.
Etiquetas:affects_outputs
--memory_profile=<a path>
predeterminado: Consulta la descripción-
Si se establece, escribe los datos de uso de la memoria en el archivo especificado al final de la fase y el montón estable en el registro principal al final de la compilación.
Etiquetas:bazel_monitoring
--memory_profile_stable_heap_parameters=<integers, separated by a comma expected in pairs>
predeterminado: “1,0”-
Ajusta el cálculo del montón estable del perfil de memoria al final de la compilación. Debe ser una cantidad par de números enteros separados por comas. En cada par, el primer número entero es la cantidad de GC que se deben realizar. 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 serían 2 GC con una pausa de 4 segundos, seguidas de 4 GC con una pausa de cero segundos.
Etiquetas:bazel_monitoring
--profile=<a path>
predeterminado: Consulta la descripción-
Si se establece, se genera un perfil de Bazel y se escriben datos en el archivo especificado. Usa bazel analyze-profile para analizar el perfil.
Etiquetas:bazel_monitoring
--[no]record_full_profiler_data
predeterminado: “false”-
De forma predeterminada, el generador de perfiles de Bazel solo registrará datos agregados para eventos rápidos, pero numerosos (como el estado del archivo). Si esta opción está habilitada, el generador de perfiles registrará cada evento, lo que generará datos de perfiles más precisos, pero con un gran impacto en el rendimiento. La opción solo tiene efecto si también se usa --profile.
Etiquetas:bazel_monitoring
- Valor predeterminado de
--remote_print_execution_messages=<failure, success or all>
: “failure” -
Elige cuándo imprimir los mensajes de ejecución remota. Los valores válidos son "failure" para imprimir solo en caso de fallas, "success" para imprimir solo en caso de éxitos y "all" para imprimir siempre.
Etiquetas:terminal_output
--[no]slim_profile
predeterminado: "true"-
Reduce el tamaño del perfil JSON combinando eventos si el perfil se vuelve demasiado grande.
Etiquetas:bazel_monitoring
--starlark_cpu_profile=<a string>
predeterminado: ""-
Escribe en el archivo especificado un perfil pprof del uso de CPU de todos los subprocesos de Starlark.
Etiquetas:bazel_monitoring
--tool_tag=<a string>
predeterminado: ""-
Es un nombre de herramienta al que se atribuirá esta invocación de Bazel.
Etiquetas:affects_outputs
,bazel_monitoring
- Se acumulan varios usos de
--ui_event_filters=<Convert list of comma separated event kind to list of filters>
. -
Especifica qué eventos se mostrarán en la IU. Es posible agregar o quitar eventos a los predeterminados con los signos +/- iniciales, o bien anular el conjunto predeterminado por completo con la asignación directa. El conjunto de tipos de eventos admitidos incluye INFO, DEBUG, ERROR y mucho más.
Etiquetas:terminal_output
- Opciones de almacenamiento en caché y ejecución remotas:
--experimental_circuit_breaker_strategy=<failure>
predeterminado: Consulta la descripción- especifica la estrategia que debe usar el disyuntor. Las estrategias disponibles son "error". Si el valor de la opción no es válido, no se establece el mismo comportamiento que la opción.
Etiquetas:execution
--[no]experimental_guard_against_concurrent_changes
predeterminado: “false”- Desactiva esta opción para inhabilitar la verificación del ctime 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 generar falsos positivos.
--[no]experimental_remote_cache_async
predeterminado: “false”- Si es verdadero, las operaciones de E/S de caché remota se realizarán en segundo plano en lugar de hacerlo como parte de un inicio.
--[no]experimental_remote_cache_lease_extension
predeterminado: “false”- Si se establece como verdadero, Bazel extenderá el arrendamiento de los resultados de las acciones remotas durante la compilación enviando llamadas a "FindMissingBlobs" periódicamente 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.>
predeterminado: "3h"-
Es el TTL mínimo garantizado de los blobs en la caché remota después de que se hace referencia a sus resúmenes recientemente, p.ej., por un ActionResult o FindMissingBlobs. Bazel realiza varias optimizaciones en función del TTL de los blobs, p.ej., no llama repetidamente a GetActionResult en una compilación incremental. El valor debe establecerse un poco por debajo del TTL real, ya que hay una brecha entre el momento en que el servidor muestra los resúmenes y el momento en que Bazel los recibe.
Etiquetas:execution
--experimental_remote_capture_corrupted_outputs=<a path>
predeterminado: Consulta la descripción- Es una ruta de acceso a un directorio en el que se capturarán los resultados dañados.
--[no]experimental_remote_discard_merkle_trees
predeterminado: “false”- Si se establece en verdadero, se descartan las copias en memoria del árbol de Merkle de la raíz de entrada y las asignaciones de entrada asociadas durante las llamadas a GetActionResult() y Execute(). Esto reduce significativamente el uso de memoria, pero requiere que Bazel vuelva a calcularlas cuando se pierda la caché remota y se vuelvan a intentar.
--experimental_remote_downloader=<a string>
predeterminado: Consulta la descripción- Es un URI de extremo de la API de Remote Asset que se usará como proxy de descarga remoto. Los esquemas admitidos son grpc, grpcs (grpc con TLS habilitado) y unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel usará grpcs de forma predeterminada. Consulta: https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto
--[no]experimental_remote_downloader_local_fallback
predeterminado: “false”- Indica si se debe recurrir al descargador local si falla el descargador remoto.
--[no]experimental_remote_execution_keepalive
predeterminado: “false”- Indica si se debe usar el mantenimiento de la conexión para las llamadas de ejecución remotas.
--experimental_remote_failure_rate_threshold=<an integer in 0-100 range>
predeterminado: "10"-
Establece la cantidad permitida de porcentaje de fallas para un período específico, después del cual deja de llamar a la caché o al ejecutor remotos. De forma predeterminada, el valor es 10. Si lo estableces en 0, no habrá limitaciones.
Etiquetas:execution
--experimental_remote_failure_window_interval=<An immutable length of time.>
predeterminado: "60s"-
Es el intervalo en el que se calcula la tasa de fallas de las solicitudes remotas. Si el valor es cero o negativo, la duración de la falla se calcula durante toda la ejecución.Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
Etiquetas:execution
--[no]experimental_remote_mark_tool_inputs
predeterminado: “false”- Si se establece como verdadero, Bazel marcará las entradas como entradas de herramientas para el ejecutor remoto. Esto se puede usar para implementar trabajadores persistentes remotos.
--[no]experimental_remote_merkle_tree_cache
predeterminado: “false”- Si se establece como verdadero, los cálculos del árbol de Merkle se almacenarán en caché para mejorar la velocidad de verificación de hits de caché remotos. El espacio en memoria de la caché se controla con --experimental_remote_merkle_tree_cache_size.
--experimental_remote_merkle_tree_cache_size=<a long integer>
predeterminado: “1000”- Es la cantidad de árboles de Merkle que se deben almacenar en caché para mejorar la velocidad de verificación de aciertos de caché remotos. Aunque la caché se poda automáticamente según el manejo de referencias suaves de Java, pueden ocurrir errores de falta de memoria si se establece demasiado alta. Si se establece en 0, el tamaño de la caché es ilimitado. El valor óptimo varía según el tamaño del proyecto. El valor predeterminado es 1,000.
--[no]experimental_remote_require_cached
predeterminado: “false”- Si se establece como verdadero, se aplica la directiva de que todas las acciones que se pueden ejecutar de forma remota se almacenen en caché, o bien se producirá un error en la compilación. Esto es útil para solucionar problemas de no determinismo, ya que permite verificar si las acciones que deberían almacenarse en caché realmente se almacenan en caché sin insertar resultados nuevos de forma falsa en la caché.
--experimental_remote_scrubbing_config=<Converts to a Scrubber>
predeterminado: Consulta la descripción- Habilita la limpieza de claves de caché remotas con el archivo de configuración proporcionado, que debe ser un búfer de protocolo ScrubbingConfig en formato de texto. El objetivo de esta función es facilitar el uso compartido de una caché remota o en el disco entre acciones que se ejecutan en diferentes plataformas, pero que se orientan a la misma plataforma. Se debe usar con mucho cuidado, ya que una configuración incorrecta puede provocar el uso compartido accidental de entradas de caché y generar compilaciones incorrectas. La limpieza no afecta la forma en que se ejecuta una acción, solo la forma en que se calcula su clave de caché remota o en el disco para recuperar o almacenar un resultado de acción. No se puede usar junto con la ejecución remota. Modificar la configuración de limpieza no invalida los resultados presentes en el sistema de archivos local o las cachés internas. Se requiere una compilación limpia para volver a ejecutar las acciones afectadas. Para usar esta función correctamente, es probable que debas establecer un --host_platform personalizado junto con --experimental_platform_in_output_dir (para normalizar los prefijos de salida) y --incompatible_strict_action_env (para normalizar las variables de entorno).
--[no]incompatible_remote_build_event_upload_respect_no_cache
predeterminado: “false”- Obsoleto. No realiza ninguna acción. En su lugar, usa --remote_build_event_upload=minimal.
--[no]incompatible_remote_downloader_send_all_headers
predeterminado: "true"-
Indica si se deben enviar todos los valores de un encabezado con varios valores al descargador remoto en lugar de solo el primero.
Etiquetas:incompatible_change
--[no]incompatible_remote_output_paths_relative_to_input_root
predeterminado: “false”-
Si se establece como verdadero, las rutas de acceso de salida son relativas a la raíz de entrada en lugar del directorio de trabajo.
Etiquetas:incompatible_change
--[no]incompatible_remote_results_ignore_disk
predeterminado: "true"-
Etiquetas
sin operación:incompatible_change
--[no]remote_accept_cached
predeterminado: "true"- Indica si se aceptan los resultados de las acciones almacenadas en caché de forma remota.
--remote_build_event_upload=<all or minimal>
predeterminado: "minimal"- Si se establece en “todos”, todos los resultados locales a los que hace referencia BEP se suben a la caché remota. Si se establece en "minimal", los resultados locales a los que hace referencia BEP no se suben a la caché remota, excepto los archivos que son importantes para los consumidores de BEP (p.ej., registros de prueba y perfil de tiempo). El esquema bytestream:// siempre se usa para el URI de los archivos, incluso si no están en la caché remota. El valor predeterminado es "minimal".
--remote_bytestream_uri_prefix=<a string>
predeterminado: Consulta la descripción- Es el nombre de host y el nombre de la instancia que se usarán en los URIs bytestream:// que se escriben en los flujos de eventos de compilación. Esta opción se puede establecer cuando las compilaciones se realizan con un proxy, lo que hace que los valores de --remote_executor y --remote_instance_name ya no correspondan al nombre canónico del servicio de ejecución remota. Si no se establece, el valor predeterminado será “${hostname}/${instance_name}”.
--remote_cache=<a string>
predeterminado: Consulta la descripción- Es 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
--[no]remote_cache_compression
predeterminado: “false”- Si está habilitado, comprime o descomprime los blobs de caché con zstd.
- Se acumulan varios usos de
--remote_cache_header=<a 'name=value' assignment>
. - Especifica un encabezado que se incluirá en las solicitudes de caché: --remote_cache_header=Nombre=Valor. Se pueden pasar varios encabezados si especificas la marca varias veces. Los múltiples valores para el mismo nombre se convertirán en una lista separada por comas.
- Se acumulan varios usos de
--remote_default_exec_properties=<a 'name=value' assignment>
. -
Establece las propiedades de ejecución predeterminadas que se usarán como la plataforma de ejecución remota si una plataforma de ejecución aún no establece exec_properties.
Etiquetas:affects_outputs
--remote_default_platform_properties=<a string>
predeterminado: ""- 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 establece remote_execution_properties. Este valor también se usará si se selecciona la plataforma host como la plataforma de ejecución para la ejecución remota.
- Se acumulan varios usos de
--remote_download_regex=<a string>
. -
Forzar a Bazel a descargar los artefactos que coincidan con la regex proporcionada. Se usa junto con Build sin los bytes (o el equivalente interno) para permitir que el cliente solicite ciertos artefactos que podrían ser necesarios de forma local (p.ej., compatibilidad con IDE). Se pueden especificar varias regex repitiendo esta marca.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--remote_downloader_header=<a 'name=value' assignment>
. - Especifica un encabezado que se incluirá en las solicitudes del descargador remoto: --remote_downloader_header=Nombre=Valor. Se pueden pasar varios encabezados si especificas la marca varias veces. Los múltiples valores para el mismo nombre se convertirán en una lista separada por comas.
- Se acumulan varios usos de
--remote_exec_header=<a 'name=value' assignment>
. - Especifica un encabezado que se incluirá en las solicitudes de ejecución: --remote_exec_header=Nombre=Valor. Se pueden pasar varios encabezados si especificas la marca varias veces. Los múltiples valores para el mismo nombre se convertirán en una lista separada por comas.
--remote_execution_priority=<an integer>
predeterminado: “0”- Es la prioridad relativa de las acciones que se ejecutarán de forma remota. La semántica de los valores de prioridad particulares depende del servidor.
--remote_executor=<a string>
predeterminado: Consulta la descripción- HOST o HOST:PORT de un extremo de ejecución remota. Los esquemas admitidos son grpc, grpcs (grpc con TLS habilitado) y unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel usará grpcs de forma predeterminada. Especifica el esquema grpc:// o unix: para inhabilitar TLS.
--remote_grpc_log=<a path>
predeterminado: Consulta la descripción- Si se especifica, es una ruta de acceso a un archivo para registrar los detalles relacionados con las llamadas de gRPC. Este registro consta de una secuencia de protobufs com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry serializados con cada mensaje con un prefijo de varint que indica el tamaño del siguiente mensaje de protobuf serializado, como lo realiza el método LogEntry.writeDelimitedTo(OutputStream).
- Se acumulan varios usos de
--remote_header=<a 'name=value' assignment>
. - Especifica un encabezado que se incluirá en las solicitudes: --remote_header=Nombre=Valor. Se pueden pasar varios encabezados si especificas la marca varias veces. Los múltiples valores para el mismo nombre se convertirán en una lista separada por comas.
--remote_instance_name=<a string>
predeterminado: ""- Es el valor que se pasa como instance_name en la API de ejecución remota.
--[no]remote_local_fallback
predeterminado: “false”- Determina si se debe recurrir a la estrategia de ejecución local independiente si falla la ejecución remota.
- Valor predeterminado de
--remote_local_fallback_strategy=<a string>
: “local” - No realiza ninguna acción, está obsoleto. Consulta https://github.com/bazelbuild/bazel/issues/7480 para obtener más información.
--remote_max_connections=<an integer>
predeterminado: "100"-
Limita la cantidad máxima de conexiones simultáneas a la caché o al ejecutor remotos. De forma predeterminada, el valor es 100. Si lo estableces en 0, no habrá limitaciones.
Para la caché remota HTTP, una conexión TCP podría controlar una solicitud a la vez, por lo que Bazel podría realizar hasta --remote_max_connections solicitudes simultáneas.
En el caso de la caché o el ejecutor remotos de gRPC, un canal de gRPC suele poder controlar más de 100 solicitudes simultáneas, por lo que Bazel podría realizar alrededor de `--remote_max_connections * 100` solicitudes simultáneas.
Etiquetas:host_machine_resource_optimizations
--remote_proxy=<a string>
predeterminado: Consulta la descripción- Conéctate a la caché remota a través de un proxy. Actualmente, esta marca solo se puede usar para configurar un socket de dominio Unix (unix:/path/to/socket).
--remote_result_cache_priority=<an integer>
predeterminado: “0”- Es la prioridad relativa de las acciones remotas que se almacenarán en la caché remota. La semántica de los valores de prioridad particulares depende del servidor.
--remote_retries=<an integer>
predeterminado: “5”- Es la cantidad máxima de intentos para reintentar un error transitorio. Si se establece en 0, se inhabilitan los reintentos.
--remote_retry_max_delay=<An immutable length of time.>
predeterminado: "5s"- Es la demora máxima de la retirada entre los intentos de reintento remotos. Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
--remote_timeout=<An immutable length of time.>
predeterminado: "60s"- Es la cantidad máxima de tiempo que se espera para la ejecución remota y las llamadas a la caché. Para la caché de REST, este es el tiempo de espera de conexión y de lectura. Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
--[no]remote_upload_local_results
predeterminado: "true"- Determina si se deben subir los resultados de las acciones ejecutadas de forma local a la caché remota si esta la admite y el usuario está autorizado para hacerlo.
--[no]remote_verify_downloads
predeterminado: "true"- Si se establece como verdadero, Bazel calculará la suma de hash de todas las descargas remotas y descartará los valores almacenados en caché de forma remota si no coinciden con el valor esperado.
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--build_metadata=<a 'name=value' assignment>
. -
Son pares de cadenas clave-valor personalizados que se proporcionan en un evento de compilación.
Etiquetas:terminal_output
--color=<yes, no or auto>
predeterminado: “auto”- Usa los controles de la terminal para colorear el resultado.
- Se acumulan varios usos de
--config=<a string>
. - Selecciona secciones de configuración adicionales de los archivos rc. Para cada <command>, también extrae las opciones de <command>:<config> si existe esa sección. Si esta sección no existe en ningún archivo .rc, Blaze falla con un error. Las secciones de configuración y las combinaciones de marcas a las que equivalen se encuentran en los archivos de configuración tools/*.blazerc.
- Se acumulan varios usos de
--credential_helper=<Path to a credential helper. It may be absolute, relative to the PATH environment variable, or %workspace%-relative. The path be optionally prefixed by a scope followed by an '='. The scope is a domain name, optionally with a single leading '*' wildcard component. A helper applies to URIs matching its scope, with more specific scopes preferred. If a helper has no scope, it applies to every URI.>
. - Configura un auxiliar de credenciales para recuperar credenciales de autorización para la recuperación del repositorio, la ejecución y la caché remotas, y el servicio de eventos de compilación. Las credenciales que proporciona un asistente tienen prioridad sobre las que proporcionan --google_default_credentials, --google_credentials, un archivo .netrc o el parámetro de autenticación para repository_ctx.download y repository_ctx.download_and_extract. Se puede especificar varias veces para configurar varios asistentes. Consulta https://github.com/bazelbuild/proposals/blob/main/designs/2022-06-07-bazel-credential-helpers.md para obtener más información.
--credential_helper_cache_duration=<An immutable length of time.>
predeterminado: “30m”- Es la duración durante la cual se almacenan en caché las credenciales que proporciona un auxiliar de credenciales. Si lo invocas con un valor diferente, se 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.
--credential_helper_timeout=<An immutable length of time.>
predeterminado: "10s"- Configura el tiempo de espera de un auxiliar de credenciales. Si los auxiliares de credenciales no responden dentro de este tiempo de espera, la invocación fallará.
--curses=<yes, no or auto>
predeterminado: “auto”- Usa los controles del cursor de la terminal para minimizar el resultado del desplazamiento.
--disk_cache=<a path>
predeterminado: Consulta la descripción- Es 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á.
--[no]enable_platform_specific_config
predeterminado: “false”- Si es verdadero, Bazel recupera 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 toma líneas que comienzan con build:linux. Los identificadores de SO admitidos son linux, macos, windows, freebsd y openbsd. Habilitar esta marca equivale a usar --config=linux en Linux, --config=windows en Windows, etcétera.
--[no]experimental_rule_extension_api
predeterminado: “false”-
Habilita las APIs de extensión de reglas experimentales y de subreglas
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_windows_watchfs
predeterminado: “false”- Si es verdadero, se habilita la compatibilidad experimental de Windows con --watchfs. De lo contrario, --watchfs no es una opción 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"- Es una lista separada por comas de los permisos de autenticación de Google Cloud.
--google_credentials=<a string>
predeterminado: Consulta la descripción- Especifica el archivo del que se deben obtener las credenciales de autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más información.
--[no]google_default_credentials
predeterminado: “false”- Indica si se deben usar "Credenciales predeterminadas de la aplicación de Google" para la autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más información. Está inhabilitado de forma predeterminada.
--grpc_keepalive_time=<An immutable length of time.>
predeterminado: Consulta la descripción- Configura pings de keepalive para las conexiones de gRPC salientes. Si se establece, Bazel envía pings después de este tiempo sin operaciones de lectura en la conexión, pero solo si hay al menos una llamada gRPC pendiente. Los tiempos se tratan como nivel de detalle de segundo. Es un error establecer un valor inferior a un segundo. De forma predeterminada, los pings de mantenimiento de la conexión están inhabilitados. Debes coordinar con el propietario del servicio antes de habilitar este parámetro de configuración. Por ejemplo, para establecer un valor de 30 segundos en esta marca, se debe hacer de la siguiente manera: --grpc_keepalive_time=30s
--grpc_keepalive_timeout=<An immutable length of time.>
predeterminado: "20s"- Configura un tiempo de espera de keepalive para las conexiones gRPC salientes. Si los pings de mantenimiento 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 nivel de detalle de segundo. Es un error establecer un valor inferior a un segundo. Si los pings de mantenimiento de la conexión están inhabilitados, se ignora este parámetro de configuración.
--[no]incompatible_disable_non_executable_java_binary
predeterminado: “false”-
Si es verdadero, java_binary siempre es ejecutable. Se quita el atributo create_executable.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_symlink_file_to_dir
predeterminado: "true"-
Sin operación.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]progress_in_terminal_title
predeterminado: “false”- Muestra el progreso del comando en el título de la terminal. Es útil para ver qué está haciendo bazel cuando tienes varias pestañas de la terminal.
--[no]show_progress
predeterminado: "true"- Muestra mensajes de progreso durante una compilación.
--show_progress_rate_limit=<a double>
predeterminado: “0.2”- Cantidad mínima de segundos entre los mensajes de progreso en la salida.
--[no]show_timestamps
predeterminado: “false”- Incluye marcas de tiempo en los mensajes
--tls_certificate=<a string>
predeterminado: Consulta la descripción- Especifica una ruta de acceso a un certificado TLS de confianza para firmar certificados de servidor.
--tls_client_certificate=<a string>
predeterminado: Consulta la descripción- Especifica el certificado de cliente TLS que se usará. También debes proporcionar una clave de cliente para habilitar la autenticación de cliente.
--tls_client_key=<a string>
predeterminado: Consulta la descripción- Especifica la clave de cliente TLS que se usará. También debes proporcionar un certificado de cliente para habilitar la autenticación de cliente.
--ui_actions_shown=<an integer>
predeterminado: “8”-
Cantidad de acciones simultáneas que se muestran en la barra de progreso detallada. Cada acción se muestra en una línea independiente. La barra de progreso siempre muestra al menos un uno, y todos los números inferiores a 1 se asignan a 1.
Etiquetas:terminal_output
--[no]watchfs
predeterminado: “false”- En Linux o macOS: Si es verdadero, bazel intenta usar el servicio de supervisión de archivos del sistema operativo para los cambios locales en lugar de analizar cada archivo en busca de cambios. En Windows, esta marca actualmente no está disponible, pero se puede habilitar junto con --experimental_windows_watchfs. En cualquier SO: El comportamiento no se define 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 Analyze-profile
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
. -
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, se puede hacer que los repositorios externos funcionen en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_connector_attempts=<an integer>
predeterminado: “8”-
Es la cantidad máxima de intentos de descargas HTTP.
Etiquetas:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
predeterminado: “0s”-
Es el tiempo de espera máximo para los reintentos de descarga HTTP. Con un valor de 0, no se define un tiempo de espera máximo.
Etiquetas:bazel_internal_configuration
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la 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, se usa el valor predeterminado de '<output_user_root>/cache/repos/v1'.
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
predeterminado: “false”-
Si se establece, 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 se inhabilita por completo; 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 la compilación:
--gc_thrashing_threshold=<an integer in 0-100 range>
predeterminado: "100"-
Es el porcentaje de espacio ocupado (de 0 a 100) por encima del cual GcThrashingDetector considera los eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, se inhabilita GcThrashingDetector.
Etiquetas:host_machine_resource_optimizations
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
. -
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitadas en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "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 un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
predeterminado: “update”- especifica cómo usar el archivo de bloqueo y si se debe usar o no. 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 mostrar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
. - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso proporcionada es una ruta de acceso absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta de acceso relativa, se hará referencia al directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace".
- Se acumulan varios usos de
--registry=<a string>
. -
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los 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 haga que Bazel falle con un error de OOM. Cada límite se especifica como <period>:<count>, en el que period es una duración y count es un número entero positivo. Si más del porcentaje --gc_thrashing_threshold del espacio a perpetuidad (heap de generación anterior) permanece ocupado después de <count> GC completas consecutivas en <period>, se activa un error de OOM. Se pueden especificar varios límites separados por comas.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Es una marca para la configuración avanzada del motor Skyframe interno 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 GC completo, se descartará el estado temporal innecesario de Skyframe hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC completos nunca activarán las bajadas. 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"-
Es una marca para la configuración avanzada del motor Skyframe interno 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 GC menor, se descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC menores nunca activarán las bajadas. 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
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es de al menos este límite, descartará el estado temporal innecesario de Skyframe. Si ajustas este parámetro, es posible que puedas mitigar el impacto del tiempo de ejecución de la fragmentación de GC, cuando esta se produce (i) por el uso de memoria de este estado temporal y (ii) es más costoso 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: Consulta la descripción- muestra un volcado de datos de perfil completo, ya sea en formato "text" legible por humanos o en formato "sin procesar" compatible con secuencias de comandos.
Etiquetas:affects_outputs
--[no]experimental_command_profile
predeterminado: “false”- Graba un perfil de CPU de Java Flight Recorder en un archivo profile.jfr en el directorio base de salida. La sintaxis y la semántica de esta marca pueden cambiar en el futuro para admitir diferentes tipos de perfiles o formatos de salida. Úsala bajo tu propio riesgo.
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
- Opciones que especifican o alteran una entrada genérica a un comando de Bazel que no se incluye en otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite"), seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
--experimental_worker_for_repo_fetching=<off, platform or virtual>
predeterminado: "off"- Es el modo de subprocesos que se usará para recuperar el repo. Si se establece en "desactivado", no se usa ningún subproceso de trabajo y la recuperación del repo está sujeta a reinicios. De lo contrario, usa un subproceso de plataforma (es decir, un subproceso del SO) si se establece en "platform" o un subproceso virtual si se establece en "virtual".
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
. - Anula un repositorio con una ruta de acceso local en el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es una ruta absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta relativa, se relaciona con el directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace".
Opciones de Aquery
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
. -
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, los repositorios externos pueden funcionar en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_connector_attempts=<an integer>
predeterminado: “8”-
Es la cantidad máxima de intentos de descargas HTTP.
Etiquetas:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
predeterminado: “0s”-
Es el tiempo de espera máximo para los reintentos de descarga HTTP. Con un valor de 0, no se define un tiempo de espera máximo.
Etiquetas:bazel_internal_configuration
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la 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, se usa el valor predeterminado de '<output_user_root>/cache/repos/v1'.
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
predeterminado: “false”-
Si se establece, 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 se inhabilita por completo; 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 la compilación:
--gc_thrashing_threshold=<an integer in 0-100 range>
predeterminado: "100"-
Es el porcentaje de espacio ocupado (de 0 a 100) por encima del cual GcThrashingDetector considera los eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, se inhabilita GcThrashingDetector.
Etiquetas:host_machine_resource_optimizations
- Opciones relacionadas con el resultado de la consulta y la semántica:
--aspect_deps=<off, conservative or precise>
predeterminado: "conservador"-
Cómo resolver las dependencias de aspecto cuando el formato de salida es uno de {xml,proto,record}. "Desactivado" significa que no se resuelven las dependencias de aspecto. "Conservador" (la opción predeterminada) significa que se agregan todas las dependencias de aspecto declaradas, independientemente de si se les asigna la clase de regla de dependencias directas. "Preciso" significa que solo se agregan los aspectos que pueden estar activos según la clase de regla de las dependencias directas. Ten en cuenta que el modo preciso requiere la carga de otros paquetes para evaluar un solo objetivo, lo que lo hace más lento que los otros modos. Ten en cuenta también que incluso el modo preciso no es del todo preciso: la decisión de si calcular un aspecto se toma en la fase de análisis, que no se ejecuta durante la "consulta de bazel".
Etiquetas:build_file_semantics
--[no]consistent_labels
predeterminado: “false”-
Si está habilitada, cada comando de consulta emite etiquetas como si fuera la función Starlark <code>str</code> aplicada a una instancia de <code>Label</code>. Esto es útil para las herramientas que deben coincidir con el resultado de diferentes comandos de consulta o etiquetas que emiten las reglas. Si no están habilitados, los formateadores de salida pueden emitir nombres de repositorio aparentes (en relación con el repositorio principal) para que el resultado sea más legible.
Etiquetas:terminal_output
--[no]graph:factored
predeterminado: "true"-
Si es verdadero, el gráfico se emitirá "factorizado", es decir, los nodos topológicamente equivalentes se combinarán y sus etiquetas se concatenarán. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--graph:node_limit=<an integer>
predeterminado: “512”-
Es la longitud máxima de la cadena de etiqueta para un nodo de gráfico en el resultado. Las etiquetas más largas se truncarán. -1 significa que no se truncará. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--[no]implicit_deps
predeterminado: "true"-
Si está habilitada, se incluirán dependencias implícitas en el gráfico de dependencias sobre el que opera la consulta. Una dependencia implícita es aquella que no se especifica de forma explícita en el archivo BUILD, pero que Bazel agrega. En el caso de cquery, esta opción controla el filtrado de cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
--[no]include_artifacts
predeterminado: "true"-
Incluye los nombres de las entradas y salidas de la acción en el resultado (potencialmente grande).
Etiquetas:terminal_output
--[no]include_aspects
predeterminado: "true"-
aquery, cquery: Indica si se deben incluir acciones generadas por aspectos en el resultado. query: No-op (siempre se siguen los aspectos).
Etiquetas:terminal_output
--[no]include_commandline
predeterminado: "true"-
Incluye el contenido de las líneas de comandos de acción en el resultado (potencialmente grande).
Etiquetas:terminal_output
--[no]include_file_write_contents
predeterminado: “false”-
Incluye el contenido del archivo para las acciones FileWrite, SourceSymlinkManifest y RepoMappingManifest (potencialmente grandes).
Etiquetas:terminal_output
--[no]include_param_files
predeterminado: “false”-
Incluye el contenido de los archivos de parámetros que se usan en el comando (potencialmente grande). Nota: Si habilitas esta marca, se habilitará automáticamente la marca --include_commandline.
Etiquetas:terminal_output
--[no]incompatible_package_group_includes_double_slash
predeterminado: "true"-
Si está habilitada, cuando se genere el atributo "packages" de package_group, no se omitirá el "//" inicial.
Etiquetas:terminal_output
,incompatible_change
--[no]infer_universe_scope
predeterminado: “false”-
Si se establece y no se establece --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 el valor de --universe_scope inferido para una expresión de consulta que usa funciones centradas en el universo (p.ej., "allrdeps") puede no ser lo que deseas, 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 establece --universe_scope, se ignora el valor de esta opción. Nota: Esta opción solo se aplica a "query" (es decir, no a "cquery").
Etiquetas:loading_and_analysis
--[no]line_terminator_null
predeterminado: “false”-
Indica si cada formato finaliza con \0 en lugar de una línea nueva.
Etiquetas:terminal_output
--[no]nodep_deps
predeterminado: "true"-
Si está habilitada, las dependencias de los atributos "nodep" se incluirán en el gráfico de dependencias sobre el que opera la consulta. Un ejemplo común de un atributo "nodep" es "visibility". Ejecuta y analiza el resultado de "info build-language" para obtener información sobre todos los atributos "nodep" en el lenguaje de compilación.
Etiquetas:build_file_semantics
--output=<a string>
predeterminado: “text”-
Es el formato en el que se deben imprimir los resultados de la consulta. Los valores permitidos para aquery son: text, textproto, proto, streamed_proto y jsonproto.
Etiquetas:terminal_output
--[no]proto:default_values
predeterminado: "true"-
Si es verdadero, se incluyen los atributos cuyo valor no se especifica de forma explícita en el archivo BUILD; de lo contrario, se omiten. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
--[no]proto:definition_stack
predeterminado: “false”-
Propaga el campo proto definition_stack, que registra para cada instancia de regla la pila de llamadas de Starlark en el momento en que se definió la clase de la regla.
Etiquetas:terminal_output
--[no]proto:flatten_selects
predeterminado: "true"-
Si está habilitada, los atributos configurables creados por select() se aplanan. En el caso de los tipos de lista, la representación aplanada es una lista que contiene cada valor del mapa de selección exactamente una vez. Los tipos escalares se aplanan a nulos.
Etiquetas:build_file_semantics
--[no]proto:include_attribute_source_aspects
predeterminado: “false”-
Propaga el campo proto source_aspect_name de cada atributo con el aspecto de origen del que proviene el atributo (cadena vacía si no es así).
Etiquetas:terminal_output
--[no]proto:include_synthetic_attribute_hash
predeterminado: “false”-
Indica si se debe calcular y propagar el atributo $internal_attr_hash.
Etiquetas:terminal_output
--[no]proto:instantiation_stack
predeterminado: “false”-
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
--[no]proto:locations
predeterminado: "true"-
Indica si se debe generar información de ubicación en el resultado de proto.
Etiquetas:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
predeterminado: “all”-
Es una lista de atributos separados por comas que se deben incluir en el resultado. La configuración predeterminada es todos los atributos. Se establece en una cadena vacía para no mostrar ningún atributo. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
--[no]proto:rule_inputs_and_outputs
predeterminado: "true"-
Indica si se propagan o no los campos rule_input y rule_output.
Etiquetas:terminal_output
--query_file=<a string>
predeterminado: ""-
Si se establece, la consulta leerá la consulta del archivo que se nombra aquí, en lugar de la línea de comandos. Especificar un archivo aquí y una consulta de línea de comandos es un error.
Etiquetas:changes_inputs
--[no]relative_locations
predeterminado: “false”-
Si es verdadero, la ubicación de los archivos BUILD en los resultados de 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 establecer esta opción en verdadero para obtener un resultado coherente en todas las máquinas.
Etiquetas:terminal_output
--[no]skyframe_state
predeterminado: “false”-
Sin realizar un análisis adicional, volca el grafo de acciones actual de Skyframe. Nota: Por el momento, no se admite especificar un destino con --skyframe_state. Esta marca solo está disponible con --output=proto o --output=textproto.
Etiquetas:terminal_output
--[no]tool_deps
predeterminado: "true"-
Consulta: Si se inhabilita, las dependencias de "configuración de ejecución" no se incluirán en el gráfico de dependencias sobre el que opera la consulta. Un borde de dependencia de "configuración de ejecución", como el de cualquier regla "proto_library" al compilador de protocolos, suele apuntar a una herramienta que se ejecuta durante la compilación en lugar de a una parte del mismo programa "objetivo".
Cquery: Si se inhabilita, filtra todos los objetivos configurados que crucen una transición de ejecución desde el objetivo de nivel superior que descubrió este objetivo configurado. Esto significa que, si el objetivo de nivel superior está en la configuración de destino, solo se mostrarán los objetivos configurados también en la configuración de destino. Si el objetivo de nivel superior está en la configuración de exec, solo se mostrarán los objetivos configurados de exec. Esta opción NO excluirá las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
--universe_scope=<comma-separated list of options>
predeterminado: ""-
Es un conjunto de patrones de segmentación (aditivos y sustractivos) separados por comas. La consulta se puede realizar en el universo definido por el cierre transitivo de los destinos especificados. Esta opción se usa para los comandos query y cquery.
En el caso de cquery, la entrada de esta opción son los objetivos en los que se compilan todas las respuestas, por lo que esta opción puede afectar las configuraciones y las transiciones. Si no se especifica esta opción, se supone que los destinos de nivel superior son los que se analizan de la expresión de consulta. Nota: En el caso de cquery, si no especificas esta opción, es posible que la compilación falle si los destinos analizados de la expresión de consulta no se pueden compilar con opciones de nivel superior.
Etiquetas:loading_and_analysis
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
. -
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitadas en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "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 un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
predeterminado: “update”- especifica cómo usar el archivo de bloqueo y si se debe usar o no. 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 mostrar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
. - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso proporcionada es una ruta de acceso absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta de acceso relativa, se hará referencia al directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace".
- Se acumulan varios usos de
--registry=<a string>
. -
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los 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 haga que Bazel falle con un error de OOM. Cada límite se especifica como <period>:<count>, en el que period es una duración y count es un número entero positivo. Si más del porcentaje --gc_thrashing_threshold del espacio a perpetuidad (heap de generación anterior) permanece ocupado después de <count> GC completas consecutivas en <period>, se activa un error de OOM. Se pueden especificar varios límites separados por comas.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Es una marca para la configuración avanzada del motor Skyframe interno 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 GC completo, se descartará el estado temporal innecesario de Skyframe hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC completos nunca activarán las bajadas. 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"-
Es una marca para la configuración avanzada del motor Skyframe interno 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 GC menor, se descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC menores nunca activarán las bajadas. 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
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es de al menos este límite, descartará el estado temporal innecesario de Skyframe. Si ajustas este parámetro, es posible que puedas mitigar el impacto del tiempo de ejecución de la fragmentación de GC, cuando esta se produce (i) por el uso de memoria de este estado temporal y (ii) es más costoso 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:
--[no]experimental_command_profile
predeterminado: “false”- Graba un perfil de CPU de Java Flight Recorder en un archivo profile.jfr en el directorio base de salida. La sintaxis y la semántica de esta marca pueden cambiar en el futuro para admitir diferentes tipos de perfiles o formatos de salida. Úsala bajo tu propio riesgo.
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
- Opciones que especifican o alteran una entrada genérica a un comando de Bazel que no se incluye en otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite"), seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
--experimental_worker_for_repo_fetching=<off, platform or virtual>
predeterminado: "off"- Es el modo de subprocesos que se usará para recuperar el repo. Si se establece en "desactivado", no se usa ningún subproceso de trabajo y la recuperación del repo está sujeta a reinicios. De lo contrario, usa un subproceso de plataforma (es decir, un subproceso del SO) si se establece en "platform" o un subproceso virtual si se establece en "virtual".
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
. - Anula un repositorio con una ruta de acceso local en el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es una ruta absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta relativa, se relaciona con el directorio de trabajo actual. Si la ruta de acceso determinada 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 la compilación:
--[no]experimental_inprocess_symlink_creation
predeterminado: “false”-
Determina si se deben realizar llamadas directas al sistema de archivos para crear árboles de symlinks.
Etiquetas:loading_and_analysis
,execution
,experimental
--[no]experimental_persistent_aar_extractor
predeterminado: “false”-
Habilita el extractor de aar persistente con trabajadores.
Etiquetas:execution
--[no]experimental_remotable_source_manifests
predeterminado: “false”-
Determina si las acciones del manifiesto de origen se pueden controlar de forma remota.
Etiquetas:loading_and_analysis
,execution
,experimental
--[no]experimental_split_coverage_postprocessing
predeterminado: “false”-
Si es verdadero, Bazel ejecutará el procesamiento posterior de la cobertura para la prueba en un nuevo inicio.
Etiquetas:execution
--[no]experimental_strict_fileset_output
predeterminado: “false”-
Si esta opción está habilitada, los conjuntos de archivos tratarán todos los artefactos de salida como archivos normales. No recorrerán directorios ni serán sensibles a los symlinks.
Etiquetas:execution
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
predeterminado: ""-
Agrega o quita claves de la información de ejecución de una acción según la mnemotecnia 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 especificas varios valores, el orden es importante porque muchas regex pueden aplicarse al mismo mnemónico.
Sintaxis: "regex=[+-]clave,regex=[+-]clave,…".
Ejemplos:
'.*=+x,.*=-y,.*=+z' agrega "x" y "z" a la información de ejecución de todas las acciones y quita "y".
"Genrule=+requires-x" agrega "requires-x" a la información de ejecución de todas las acciones de Genrule.
"(?!Genrule).*=-requires-x" quita "requires-x" de la información de ejecución para todas las acciones que no sean de Genrule.
Etiquetas:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Habilita las acciones de expansión de sintaxis y dex persistentes de Android con trabajadores.
Se expande a:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
-
Habilita el procesador de recursos de Android persistente con trabajadores.
Se expande a:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
--strategy=ProcessDatabinding=worker
--strategy=GenerateDataBindingBaseClasses=worker
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_dex_desugar
-
Habilita las acciones de desugar y dex multiplexadas y persistentes de Android con trabajadores.
Se expande a:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
Habilita el procesador de recursos de Android multiplexado persistente con trabajadores.
Se expande a:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_tools
-
Habilita las herramientas de Android persistentes y multiplexadas (dexing, expansión de sintaxis, procesamiento de recursos).
Se expande a:
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Etiquetas:host_machine_resource_optimizations
,execution
--[no]use_target_platform_for_tests
predeterminado: “false”-
Si es verdadero, Bazel usará la plataforma de destino para ejecutar pruebas en lugar del grupo de ejecución de pruebas.
Etiquetas:execution
- Son opciones que configuran la cadena de herramientas que se usa para la ejecución de acciones:
--android_compiler=<a string>
predeterminado: Consulta la descripción-
El compilador de destino de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_crosstool_top=<a build target label>
predeterminado: "//external:android/crosstool"-
Es la ubicación del compilador de C++ que se usa para las compilaciones de Android.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_grte_top=<a label>
predeterminado: Consulta la descripción-
El objetivo grte_top de Android.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
predeterminado: "android"-
Selecciona el combinador de manifiestos que se usará para las reglas android_binary. Marca para ayudar a la transición a la combinación de manifiestos de Android desde la combinación heredada.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_platforms=<a build target label>
predeterminado: ""-
Establece las plataformas que usan los destinos de android_binary. Si se especifican varias plataformas, el objeto binario es un APK grueso, que contiene objetos binarios nativos para cada plataforma de destino especificada.
Etiquetas:changes_inputs
,loading_and_analysis
,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
,loses_incremental_state
--apple_crosstool_top=<a build target label>
predeterminado: "@bazel_tools//tools/cpp:toolchain"-
Es la etiqueta del paquete de herramientas cruzadas que se usará en las reglas de Apple y Objc, y sus dependencias.
Etiquetas:loses_incremental_state
,changes_inputs
--cc_output_directory_tag=<a string>
predeterminado: ""-
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas:affects_outputs
--compiler=<a string>
predeterminado: Consulta la descripción-
Es el compilador de C++ que se usará para compilar el destino.
Etiquetas:loading_and_analysis
,execution
--coverage_output_generator=<a build target label>
predeterminado: "@bazel_tools//tools/test:lcov_merger"-
Ubicación del binario que se usa para postprocesar informes de cobertura sin procesar. Actualmente, debe ser un grupo de archivos que contenga un solo archivo, el binario. El valor predeterminado es “//tools/test:lcov_merger”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
predeterminado: "@bazel_tools//tools/test:coverage_report_generator"-
Ubicación del binario que se usa para generar informes de cobertura. Actualmente, debe ser un grupo de archivos que contenga un solo archivo, el binario. El valor predeterminado es "//tools/test:coverage_report_generator".
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
predeterminado: "@bazel_tools//tools/test:coverage_support"-
Ubicación de los archivos de compatibilidad que se requieren en las entradas de cada acción de prueba que recopila la cobertura de código. El valor predeterminado es “//tools/test:coverage_support”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--crosstool_top=<a build target label>
predeterminado: "@bazel_tools//tools/cpp:toolchain"-
Es la etiqueta del paquete de herramientas cruzadas que se usará para compilar código C++.
Etiquetas:loading_and_analysis
,changes_inputs
,affects_outputs
--custom_malloc=<a build target label>
predeterminado: Consulta la descripción- especifica una implementación personalizada de malloc. Este parámetro de configuración anula los atributos malloc en las reglas de compilación.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan varios usos de
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
. -
Es una lista de expresiones regulares separadas por comas, cada una con el prefijo - (expresión negativa) de forma opcional, 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 con al menos una expresión positiva, la resolución de la cadena de herramientas se realizará como si hubiera declarado los valores de restricción como restricciones de ejecución. Ejemplo: //demo,-test=@platforms//cpus:x86_64 agregará "x86_64" a cualquier destino de //demo, excepto a aquellos cuyo nombre contenga "test".
Etiquetas:loading_and_analysis
--[no]experimental_include_xcode_execution_requirements
predeterminado: “false”-
Si se establece, agrega un requisito de ejecución "requires-xcode:{version}" a cada acción de Xcode. Si la versión de Xcode tiene una etiqueta con guiones, también agrega un requisito de ejecución "requires-xcode-label:{version_label}".
Etiquetas:loses_incremental_state
,loading_and_analysis
,execution
--[no]experimental_prefer_mutual_xcode
predeterminado: "true"-
Si es verdadero, usa la versión más reciente de Xcode que esté disponible de forma local y remota. Si es falso o si no hay versiones mutuas disponibles, usa la versión local de Xcode seleccionada a través de xcode-select.
Etiquetas:loses_incremental_state
--extra_execution_platforms=<comma-separated list of options>
predeterminado: ""-
Son las plataformas disponibles como plataformas de ejecución para ejecutar acciones. Las plataformas se pueden especificar por destino exacto o como un patrón de destino. Estas plataformas se considerarán antes de las declaradas en el archivo WORKSPACE por register_execution_platforms(). Esta opción solo se puede establecer una vez; las instancias posteriores anularán la configuración de la marca anterior.
Etiquetas:execution
- Se acumulan varios usos de
--extra_toolchains=<comma-separated list of options>
. -
Son las reglas de la cadena de herramientas que se deben tener en cuenta durante la resolución de la cadena de herramientas. Las cadenas de herramientas se pueden especificar por destino exacto o como un patrón de destino. Estas cadenas de herramientas se considerarán antes que las declaradas en el archivo WORKSPACE por register_toolchains().
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--grte_top=<a label>
predeterminado: Consulta la descripción-
Es una etiqueta para una biblioteca libc verificada. La cadena de herramientas de crosstool selecciona el valor predeterminado, y casi nunca es necesario anularlo.
Etiquetas:action_command_lines
,affects_outputs
--host_compiler=<a string>
predeterminado: Consulta la descripción-
Es el compilador de C++ que se usará para la compilación del host. Se ignora si no se establece --host_crosstool_top.
Etiquetas:loading_and_analysis
,execution
--host_crosstool_top=<a build target label>
predeterminado: Consulta la descripción-
De forma predeterminada, las opciones --crosstool_top y --compiler también se usan para la configuración de exec. Si se proporciona esta marca, Bazel usa la libc y el compilador predeterminados para el crosstool_top determinado.
Etiquetas:loading_and_analysis
,changes_inputs
,affects_outputs
--host_grte_top=<a label>
predeterminado: Consulta la descripción-
Si se especifica, este parámetro de configuración anula el directorio de nivel superior de libc (--grte_top) para la configuración de exec.
Etiquetas:action_command_lines
,affects_outputs
--host_platform=<a build target label>
predeterminado: "@local_config_platform//:host"-
La etiqueta de una regla de plataforma que describe el sistema host.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
predeterminado: "true"-
Si es verdadero, Bazel no habilitará las funciones "host" y "nonhost" en la cadena de herramientas de C++ (consulta https://github.com/bazelbuild/bazel/issues/7407 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_android_toolchain_resolution
predeterminado: "true"-
Usa la resolución de cadena de herramientas para seleccionar el SDK de Android para las reglas de Android (Starlark y nativo)
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_apple_toolchain_resolution
predeterminado: “false”-
Usa la resolución de cadena de herramientas para seleccionar el SDK de Apple para las reglas de Apple (Starlark y nativo)
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone
predeterminado: "true"-
Si es verdadero, Bazel no reutilizará las líneas de comandos de la acción de vinculación de C++ para las líneas de comandos de indexación de lto (consulta https://github.com/bazelbuild/bazel/issues/6791 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_legacy_whole_archive
predeterminado: "true"-
Si es verdadero, Bazel no vinculará las dependencias de la biblioteca como un archivo completo de forma predeterminada (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener instrucciones de migración).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_require_ctx_in_configure_features
predeterminado: "true"-
Si es verdadero, Bazel requerirá el parámetro "ctx" en cc_common.configure_features (consulta https://github.com/bazelbuild/bazel/issues/7793 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
-
Usa objetos compartidos de interfaz si la cadena de herramientas es compatible. Actualmente, todas las cadenas de herramientas ELF admiten este parámetro de configuración.
Etiquetas:loading_and_analysis
,affects_outputs
,affects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Especifica la versión del SDK de iOS que se usará para compilar aplicaciones para iOS. Si no se especifica, usa la versión predeterminada del SDK de iOS de "xcode_version".
Etiquetas:loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Especifica la versión del SDK de macOS que se usará para compilar aplicaciones para macOS. Si no se especifica, se usa la versión predeterminada del SDK de macOS de "xcode_version".
Etiquetas:loses_incremental_state
--minimum_os_version=<a string>
predeterminado: Consulta la descripción-
Es la versión mínima del SO a la que se orienta tu compilación.
Etiquetas:loading_and_analysis
,affects_outputs
--platform_mappings=<a relative path>
predeterminado: ""-
Es la ubicación de un archivo de asignación que describe qué plataforma usar si no se establece ninguna o qué marcas establecer cuando ya existe una plataforma. Debe ser relativo a la raíz del espacio de trabajo principal. El valor predeterminado es "platform_mappings" (un archivo directamente debajo de la raíz del espacio de trabajo).
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--platforms=<a build target label>
predeterminado: ""-
Son las etiquetas de las reglas de la plataforma que describen las plataformas de destino del comando actual.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--python2_path=<a string>
predeterminado: Consulta la descripción-
Obsoleto, no realiza ninguna acción. Se inhabilitó con `--incompatible_use_python_toolchains`.
Etiquetas:no_op
,deprecated
--python3_path=<a string>
predeterminado: Consulta la descripción-
Obsoleto, no realiza ninguna acción. Se inhabilitó con `--incompatible_use_python_toolchains`.
Etiquetas:no_op
,deprecated
--python_path=<a string>
predeterminado: Consulta la descripción-
Es la ruta de acceso absoluta del intérprete de Python que se invocó para ejecutar destinos de Python en la plataforma de destino. Obsoleto; se inhabilitó con --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
--python_top=<a build target label>
predeterminado: Consulta la descripción-
La etiqueta de un py_runtime que representa el intérprete de Python invocado para ejecutar destinos de Python en la plataforma de destino. Obsoleto; se inhabilitó con --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Especifica la versión del SDK de tvOS que se usará para compilar aplicaciones para tvOS. Si no se especifica, se usa la versión predeterminada del SDK de tvOS de "xcode_version".
Etiquetas:loses_incremental_state
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Especifica la versión del SDK de watchOS que se usará para compilar aplicaciones para watchOS. Si no se especifica, se usa la versión predeterminada del SDK de watchOS de "xcode_version".
Etiquetas:loses_incremental_state
--xcode_version=<a string>
predeterminado: Consulta la descripción-
Si se especifica, usa Xcode de la versión determinada para las acciones de compilación relevantes. Si no se especifica, se usa la versión predeterminada del ejecutor de Xcode.
Etiquetas:loses_incremental_state
--xcode_version_config=<a build target label>
predeterminado: "@bazel_tools//tools/cpp:host_xcodes"-
Es la etiqueta de la regla xcode_config que se usará para seleccionar la versión de Xcode en la configuración de compilación.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Opciones que controlan el resultado del comando:
--[no]apple_generate_dsym
predeterminado: “false”-
Indica si se deben generar archivos de símbolos de depuración (.dSYM).
Etiquetas:affects_outputs
,action_command_lines
--[no]build_runfile_links
predeterminado: "true"-
Si es verdadero, compila bosques de symlinks de runfiles para todos los destinos. Si es falso, escríbelos solo cuando lo requiera una acción local, una prueba o un comando de ejecución.
Etiquetas:affects_outputs
--[no]build_runfile_manifests
predeterminado: "true"-
Si es verdadero, escribe manifiestos de runfiles para todos los destinos. Si es falso, omítelos. Las pruebas locales no se ejecutarán si es falso.
Etiquetas:affects_outputs
--[no]build_test_dwp
predeterminado: “false”-
Si está habilitado, cuando se compilen pruebas de C++ de forma estática y con Fission, el archivo .dwp para el objeto binario de prueba también se compilará automáticamente.
Etiquetas:loading_and_analysis
,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 una cc_proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated set of options>
predeterminado: “.pb.cc”-
Configura los sufijos de los archivos de origen que crea una cc_proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info
predeterminado: “false”-
Ejecuta acciones adicionales para versiones alternativas de la API de Java en una proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_proto_extra_actions
predeterminado: “false”-
Ejecuta acciones adicionales para versiones alternativas de la API de Java en una proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_save_feature_state
predeterminado: “false”-
Guarda el estado de las funciones habilitadas y solicitadas como un resultado de la compilación.
Etiquetas:affects_outputs
,experimental
--fission=<a set of compilation modes>
predeterminado: “no”-
Especifica qué modos de compilación usan la fisión para las compilaciones y los vínculos de C++. Puede ser cualquier combinación de {'fastbuild', 'dbg', 'opt'} o los valores especiales "yes" para habilitar todos los modos y "no" para inhabilitarlos.
Etiquetas:loading_and_analysis
,action_command_lines
,affects_outputs
--[no]incompatible_always_include_files_in_data
predeterminado: "true"-
Si es verdadero, las reglas nativas agregan <code>DefaultInfo.files</code> de dependencias de datos a sus archivos de ejecución, lo que coincide con el comportamiento recomendado para las reglas de Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid).
Etiquetas:affects_outputs
,incompatible_change
--[no]legacy_external_runfiles
predeterminado: "true"-
Si es verdadero, compila bosques de symlinks de runfiles para repositorios externos en .runfiles/wsname/external/repo (además de .runfiles/repo).
Etiquetas:affects_outputs
--[no]objc_generate_linkmap
predeterminado: “false”- especifica si se debe generar un archivo de mapa de vínculos.
Etiquetas:affects_outputs
--[no]save_temps
predeterminado: “false”-
Si se establece, se guardarán los resultados temporales de gcc. Estos incluyen archivos .s (código de ensamblador), archivos .i (C procesado) y archivos .ii (C++ procesado).
Etiquetas:affects_outputs
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
- Se acumulan varios usos de
--action_env=<a 'name=value' assignment with an optional value part>
. -
Especifica el conjunto de variables de entorno disponibles para las acciones con configuración de destino. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o bien por el par nombre=valor, que establece el valor independientemente del entorno de invocación. Esta opción se puede usar varias veces. En el caso de las opciones que se proporcionan para la misma variable, se aplica la más reciente, y se acumulan las opciones para diferentes variables.
Etiquetas:action_command_lines
--android_cpu=<a string>
predeterminado: "armeabi-v7a"-
La CPU objetivo de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]android_databinding_use_androidx
predeterminado: "true"-
Genera archivos de vinculación de datos compatibles con AndroidX. Esto solo se usa con la vinculación de datos v2. Esta marca no realiza ninguna acción.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]android_databinding_use_v3_4_args
predeterminado: "true"-
Usa Android Databinding v2 con el argumento 3.4.0. Esta marca no realiza ninguna acción.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--android_dynamic_mode=<off, default or fully>
predeterminado: "off"-
Determina si las dependencias de C++ de las reglas de Android se vincularán de forma dinámica cuando un cc_binary no cree una biblioteca compartida de forma explícita. "default" significa que bazel elegirá si vincular 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 modo principalmente estático.
Etiquetas:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
predeterminado: "alphabetical"-
Establece el orden de los manifiestos que se pasan a la combinación de manifiestos para los objetos binarios de Android. ALPHABETICAL significa que los manifiestos se ordenan por ruta de acceso en relación con el execroot. ALPHABETICAL_BY_CONFIGURATION significa que los manifiestos se ordenan por rutas de acceso relativas al directorio de configuración dentro del directorio de salida. DEPENDENCY significa que los manifiestos se ordenan de modo que el manifiesto de cada biblioteca aparezca antes que los manifiestos de sus dependencias.
Etiquetas:action_command_lines
,execution
--[no]android_resource_shrinking
predeterminado: “false”-
Habilita la reducción de recursos para los APKs de android_binary que usan ProGuard.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]build_python_zip
predeterminado: “auto”-
Compila el archivo ZIP ejecutable de Python; activado en Windows, desactivado en otras plataformas.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--catalyst_cpus=<comma-separated list of options>
. -
Es una lista de arquitecturas separadas por comas para las que se compilarán objetos binarios de Apple Catalyst.
Etiquetas:loses_incremental_state
,loading_and_analysis
--[no]collect_code_coverage
predeterminado: “false”-
Si se especifica, Bazel instrumentará el código (con instrumentación sin conexión siempre que sea posible) y recopilará información de cobertura durante las pruebas. Solo se verán afectados los destinos que coincidan con --instrumentation_filter. Por lo general, esta opción no debe especificarse directamente. En su lugar, se debe usar el comando "bazel coverage".
Etiquetas:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] predeterminado: "fastbuild"-
Especifica el modo en el que se compilará el objeto binario. Valores: "fastbuild", "dbg", "opt".
Etiquetas:affects_outputs
,action_command_lines
- Se acumulan varios usos de
--conlyopt=<a string>
. -
Opción adicional para pasar a gcc cuando se compilan archivos de origen C.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--copt=<a string>
. - Opciones adicionales para pasar a gcc.
Etiquetas:action_command_lines
,affects_outputs
--cpu=<a string>
predeterminado: ""-
La CPU objetivo.
Etiquetas:changes_inputs
,affects_outputs
--cs_fdo_absolute_path=<a string>
predeterminado: Consulta la descripción-
Usa la información del perfil de CSFDO para optimizar la compilación. Especifica el nombre de la ruta de acceso absoluta del archivo ZIP que contiene el archivo de perfil, un archivo de perfil LLVM sin procesar o indexado.
Etiquetas:affects_outputs
--cs_fdo_instrument=<a string>
predeterminado: Consulta la descripción-
Genera objetos binarios con instrumentación de FDO sensible al contexto. Con el compilador Clang/LLVM, también acepta el nombre del directorio en el que se volcarán los archivos de perfil sin procesar durante el tiempo de ejecución.
Etiquetas:affects_outputs
--cs_fdo_profile=<a build target label>
predeterminado: Consulta la 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 varios usos de
--cxxopt=<a string>
. -
Opción adicional para pasar a gcc cuando se compilan archivos de origen C++.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--define=<a 'name=value' assignment>
. -
Cada opción --define especifica una asignación para una variable de compilación.
Etiquetas:changes_inputs
,affects_outputs
--dynamic_mode=<off, default or fully>
predeterminado: "predeterminado"- determina si los objetos binarios de C++ se vincularán de forma dinámica. "default" significa que Bazel elegirá si vincular 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 modo principalmente estático.
Etiquetas:loading_and_analysis
,affects_outputs
--[no]enable_fdo_profile_absolute_path
predeterminado: "true"-
Si se establece, el uso de fdo_absolute_profile_path generará un error.
Etiquetas:affects_outputs
--[no]enable_runfiles
predeterminado: “auto”-
Habilita el árbol de symlinks de runfiles. De forma predeterminada, está desactivado en Windows y en otras plataformas.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--experimental_action_listener=<a build target label>
. - dejó de estar disponible y se reemplazó por aspectos. Usa action_listener para adjuntar una extra_action a las acciones de compilación existentes.
Etiquetas:execution
,experimental
--[no]experimental_android_compress_java_resources
predeterminado: “false”-
Comprime los recursos de Java en los APKs.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_android_databinding_v2
predeterminado: "true"-
Usa Android Databinding v2. Esta marca no realiza ninguna acción.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_android_resource_shrinking
predeterminado: “false”-
Habilita la reducción de recursos para los APKs de android_binary que usan ProGuard.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_android_rewrite_dexes_with_rex
predeterminado: “false”-
Usa la herramienta rex para volver a escribir archivos dex.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_collect_code_coverage_for_generated_files
predeterminado: “false”-
Si se especifica, Bazel también generará información de cobertura recopilada para los archivos generados.
Etiquetas:affects_outputs
--experimental_objc_fastbuild_options=<comma-separated list of options>
predeterminado: "-O0,-DDEBUG=1"-
Usa estas cadenas como opciones del compilador de fastbuild de objc.
Etiquetas:action_command_lines
--[no]experimental_omitfp
predeterminado: “false”-
Si es verdadero, usa libunwind para el desenredo de pila y compila con -fomit-frame-pointer y -fasynchronous-unwind-tables.
Etiquetas:action_command_lines
,affects_outputs
,experimental
--experimental_output_paths=<off, content or strip>
predeterminado: "off"-
Qué modelo usar para determinar en qué parte del árbol de salida las reglas escriben sus resultados, en particular para compilaciones multiplataforma o multiconfiguración. Esta función es muy experimental. Consulta https://github.com/bazelbuild/bazel/issues/6526 para obtener más información. Las acciones de Starlark pueden habilitar la asignación de rutas de acceso agregando la clave "supports-path-mapping" al diccionario "execution_requirements".
Etiquetas:loses_incremental_state
,bazel_internal_configuration
,affects_outputs
,execution
- Se acumulan varios usos de
--experimental_override_name_platform_in_output_dir=<a 'label=value' assignment>
. -
Cada entrada debe tener el formato etiqueta=valor, en el que etiqueta hace referencia a una plataforma y valor es el nombre abreviado que se desea usar en la ruta de salida. Solo se usa cuando --experimental_platform_in_output_dir es verdadero. Tiene la prioridad de nombres más alta.
Etiquetas:affects_outputs
,experimental
--[no]experimental_platform_in_output_dir
predeterminado: “false”-
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: primero, en el caso poco frecuente de que la opción --platforms no tenga exactamente un valor, se usa un hash de la opción platforms. A continuación, si se registró algún nombre corto para la plataforma actual con --experimental_override_name_platform_in_output_dir, se usará ese nombre corto. Luego, si se establece --experimental_use_platforms_in_output_dir_legacy_heuristic, usa un nombre corto basado en la etiqueta de plataforma actual. Por último, se usa un hash de la opción de plataforma como último recurso.
Etiquetas:affects_outputs
,experimental
--[no]experimental_use_llvm_covmap
predeterminado: “false”-
Si se especifica, Bazel generará información del mapa de cobertura de llvm-cov en lugar de gcov cuando se habilite collect_code_coverage.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic
predeterminado: "true"-
Usa esta marca solo como parte de una estrategia de migración o prueba sugerida. Ten en cuenta que la heurística tiene deficiencias conocidas y se recomienda migrar a depender solo de --experimental_override_name_platform_in_output_dir.
Etiquetas:affects_outputs
,experimental
--fat_apk_cpu=<comma-separated set of options>
predeterminado: "armeabi-v7a"-
Si configuras esta opción, se habilitan los APKs multiarquitectura, que contienen objetos binarios nativos para todas las arquitecturas de destino especificadas, p.ej., --fat_apk_cpu=x86,armeabi-v7a. Si se especifica esta marca, se ignora --android_cpu para las dependencias de las reglas android_binary.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]fat_apk_hwasan
predeterminado: “false”-
Indica si se deben crear divisiones HWASAN.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--fdo_instrument=<a string>
predeterminado: Consulta la descripción-
Genera objetos binarios con la instrumentación de FDO. Con el compilador Clang/LLVM, también acepta el nombre del directorio en el que se volcarán los archivos de perfil sin procesar durante el tiempo de ejecución.
Etiquetas:affects_outputs
--fdo_optimize=<a string>
predeterminado: Consulta la descripción-
Usa la información del perfil de FDO para optimizar la compilación. Especifica el nombre de un archivo ZIP que contenga un árbol de archivos .gcda, un archivo afdo que contenga un perfil automático o un archivo de perfil de LLVM. Esta marca también acepta archivos especificados como etiquetas (p.ej., "//foo/bar:file.afdo"; es posible que debas agregar una directiva "exports_files" al paquete correspondiente) y etiquetas que apuntan a destinos "fdo_profile". La regla "fdo_profile" reemplazará esta marca.
Etiquetas:affects_outputs
--fdo_prefetch_hints=<a build target label>
predeterminado: Consulta la descripción-
Usa sugerencias de almacenamiento en caché para la carga previa.
Etiquetas:affects_outputs
--fdo_profile=<a build target label>
predeterminado: Consulta la descripción-
Es el fdo_profile que representa el perfil que se usará para la optimización.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--features=<a string>
. -
Las funciones determinadas se habilitarán o inhabilitarán de forma predeterminada para los destinos compilados en la configuración de destino. Si especificas -<feature>, se inhabilitará la función. Los atributos negativos siempre anulan los positivos. Consulta también --host_features
Etiquetas:changes_inputs
,affects_outputs
--[no]force_pic
predeterminado: “false”-
Si está habilitado, todas las compilaciones de C++ producen código independiente de la posición ("-fPIC"), los vínculos prefieren las bibliotecas precompiladas de PIC en lugar de las bibliotecas que no son de PIC, y los vínculos producen ejecutables independientes de la posición ("-pie").
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan varios usos de
--host_action_env=<a 'name=value' assignment with an optional value part>
. -
Especifica el conjunto de variables de entorno disponibles para las acciones con configuraciones de ejecución. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o bien por el par nombre=valor, que establece el valor independientemente del entorno de invocación. Esta opción se puede usar varias veces. En el caso de las opciones que se proporcionan para la misma variable, se aplica la más reciente, y se acumulan las opciones para diferentes variables.
Etiquetas:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
predeterminado: "opt"-
Especifica el modo en el que se compilarán las herramientas que se usan durante la compilación. Valores: "fastbuild", "dbg", "opt".
Etiquetas:affects_outputs
,action_command_lines
- Se acumulan varios usos de
--host_conlyopt=<a string>
. -
Opción adicional para pasar al compilador de C cuando se compilan archivos de origen C (pero no C++) en las configuraciones de ejecución.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--host_copt=<a string>
. -
Opciones adicionales para pasar al compilador C para herramientas compiladas en las configuraciones de ejecución.
Etiquetas:action_command_lines
,affects_outputs
--host_cpu=<a string>
predeterminado: ""-
La CPU del host.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan varios usos de
--host_cxxopt=<a string>
. -
Opciones adicionales para pasar al compilador de C++ para herramientas compiladas en las configuraciones de ejecución.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--host_features=<a string>
. -
Las funciones determinadas se habilitarán o inhabilitarán de forma predeterminada para los destinos compilados en la configuración de ejecución. Si especificas -<feature>, se inhabilitará la función. Los atributos negativos siempre anulan los positivos.
Etiquetas:changes_inputs
,affects_outputs
--host_force_python=<PY2 or PY3>
predeterminado: Consulta la descripción-
Anula la versión de Python para la configuración de ejecución. Puede ser “PY2” o “PY3”.
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan varios usos de
--host_linkopt=<a string>
. -
Opción adicional para pasar al vinculador cuando se vinculan herramientas en las configuraciones de ejecución.
Etiquetas:action_command_lines
,affects_outputs
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Versión mínima compatible de macOS para los destinos de host. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan varios usos de
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
. -
Opciones adicionales para pasar de forma selectiva al compilador C/C++ cuando se compilan ciertos archivos en las configuraciones de ejecución. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. En la que regex_filter representa una lista de patrones de expresiones regulares para incluir y excluir (consulta también --instrumentation_filter). option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe estar entre comillas con una barra invertida. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos de gcc de todos los archivos cc en //foo/, excepto bar.cc.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--host_swiftcopt=<a string>
. -
Opciones adicionales para pasar a swiftc para herramientas de ejecución.
Etiquetas:action_command_lines
,affects_outputs
--[no]incompatible_auto_exec_groups
predeterminado: “false”-
Cuando se habilita, se crea automáticamente un grupo de ejecución para cada cadena de herramientas que usa una regla. Para que esto funcione, la regla 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
,incompatible_change
--[no]incompatible_merge_genfiles_directory
predeterminado: "true"-
Si es verdadero, el directorio genfiles se une al directorio bin.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_use_host_features
predeterminado: "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
,incompatible_change
--[no]instrument_test_targets
predeterminado: “false”-
Cuando la cobertura está habilitada, especifica si se deben considerar las reglas de prueba de instrumentación. Cuando se establece, se instrumentan las reglas de prueba que incluye --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 habilita la cobertura, solo se instrumentarán las reglas con nombres incluidos en el filtro basado en regex especificado. En su lugar, se excluyen las reglas con el prefijo “-”. Ten en cuenta que solo se instrumentan las reglas que no son de prueba, a menos que se habilite --instrument_test_targets.
Etiquetas:affects_outputs
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Es la versión mínima de iOS compatible para los simuladores y dispositivos de destino. Si no se especifica, se usa "ios_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan varios usos de
--ios_multi_cpus=<comma-separated list of options>
. -
Es una lista de arquitecturas separadas por comas con las que se compila una ios_application. El resultado es un binario universal que contiene todas las arquitecturas especificadas.
Etiquetas:loses_incremental_state
,loading_and_analysis
--[no]legacy_whole_archive
predeterminado: "true"-
Obsoleto, reemplazado por --incompatible_remove_legacy_whole_archive (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener más información). Cuando está activado, usa --whole-archive para las reglas cc_binary que tienen linkshared=True y linkstatic=True o “-static” en linkopts. Esto es solo para la retrocompatibilidad. Una mejor alternativa es usar alwayslink=1 cuando sea necesario.
Etiquetas:action_command_lines
,affects_outputs
,deprecated
- Se acumulan varios usos de
--linkopt=<a string>
. - : Opción adicional para pasar a gcc cuando se realiza la vinculación.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--ltobackendopt=<a string>
. -
Opción adicional para pasar al paso de backend de LTO (en --features=thin_lto).
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--ltoindexopt=<a string>
. -
Opción adicional para pasar al paso de indexación de LTO (en --features=thin_lto).
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--macos_cpus=<comma-separated list of options>
. -
Es una lista separada por comas de las arquitecturas para las que se compilarán los objetos binarios de Apple macOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Versión mínima de macOS compatible para los destinos. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
--memprof_profile=<a build target label>
predeterminado: Consulta la descripción-
Usa el perfil de memprof.
Etiquetas:affects_outputs
--[no]objc_debug_with_GLIBCXX
predeterminado: “false”-
Si se establece y el modo de compilación se establece en "dbg", define GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC y GLIBCPP_CONCEPT_CHECKS.
Etiquetas:action_command_lines
--[no]objc_enable_binary_stripping
predeterminado: “false”-
Determina si se deben quitar los símbolos y el código muerto en los 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 varios usos de
--objccopt=<a string>
. -
Opciones adicionales para pasar a gcc cuando se compilan archivos de origen Objective-C/C++.
Etiquetas:action_command_lines
- Se acumulan varios usos de
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
. -
Opciones adicionales para pasar de forma selectiva a gcc cuando se compilan ciertos archivos. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. En la que regex_filter representa una lista de patrones de expresiones regulares para incluir y excluir (consulta también --instrumentation_filter). option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe estar entre comillas con una barra invertida. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos de gcc de todos los archivos cc en //foo/, excepto bar.cc.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
. -
Opciones adicionales para pasar de forma selectiva al backend de LTO (en --features=thin_lto) cuando se compilan ciertos objetos de backend. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. En la que regex_filter representa una lista de patrones de expresión regular para incluir y excluir. option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe estar entre comillas con una barra invertida. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos del backend de LTO de todos los archivos o en //foo/, excepto bar.o.
Etiquetas:action_command_lines
,affects_outputs
--platform_suffix=<a string>
predeterminado: Consulta la descripción-
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas:loses_incremental_state
,affects_outputs
,loading_and_analysis
--propeller_optimize=<a build target label>
predeterminado: Consulta la descripción-
Usa la información del perfil de Propeller para optimizar el destino de compilación.Un perfil de Propeller debe constar de al menos uno de dos archivos: un perfil de cc y un perfil de ld. Esta marca acepta una etiqueta de compilación que debe hacer referencia a los archivos de entrada del perfil de Propeller. Por ejemplo, el archivo BUILD que define la etiqueta, en a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)Es posible que se deba agregar una directiva exports_files al paquete correspondiente para que Bazel pueda ver estos archivos. La opción se debe usar de la siguiente manera: --propeller_optimize=//a/b:propeller_profile
Etiquetas:action_command_lines
,affects_outputs
--propeller_optimize_absolute_cc_profile=<a string>
predeterminado: Consulta la descripción-
Nombre de ruta de acceso absoluta del archivo cc_profile para compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
predeterminado: Consulta la descripción-
Es el nombre de ruta de acceso absoluto del archivo ld_profile para las compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
--run_under=<a prefix in front of command>
predeterminado: Consulta la descripción-
Es el prefijo que se inserta antes de los ejecutables para los comandos "test" y "run". Si el valor es "foo -bar" y la línea de comandos de ejecución es "test_binary -baz", la línea de comandos final es "foo -bar test_binary -baz".También puede ser una etiqueta para un destino ejecutable. Algunos ejemplos son: "valgrind", "strace", "strace -c", "valgrind --quiet --num-callers=20", "//package:target", "//package:target --options".
Etiquetas:action_command_lines
-
Si es verdadero, las bibliotecas nativas que contienen funcionalidad idéntica se compartirán entre diferentes destinos.
Etiquetas:loading_and_analysis
,affects_outputs
--[no]stamp
predeterminado: “false”-
Marca los 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
- Valor predeterminado de
--strip=<always, sometimes or never>
: “sometimes” - especifica si se deben quitar los objetos binarios y las bibliotecas compartidas (con "-Wl,--strip-debug"). El valor predeterminado de "sometimes" significa quitar si --compilation_mode=fastbuild.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--stripopt=<a string>
. -
Opciones adicionales para pasar a la eliminación cuando se genera un objeto binario "<name>.stripped".
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--swiftcopt=<a string>
. -
Opciones adicionales para pasar a la compilación de Swift.
Etiquetas:action_command_lines
- Se acumulan varios usos de
--tvos_cpus=<comma-separated list of options>
. -
Es una lista separada por comas de las arquitecturas para las que se compilarán los objetos binarios de Apple tvOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Versión mínima compatible de tvOS para los simuladores y dispositivos de destino. Si no se especifica, se usa "tvos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan varios usos de
--visionos_cpus=<comma-separated list of options>
. -
Es una lista separada por comas de las arquitecturas para las que se compilarán los objetos binarios de Apple visionOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Se acumulan varios usos de
--watchos_cpus=<comma-separated list of options>
. -
Es una lista separada por comas de las arquitecturas para las que se compilarán los objetos binarios de Apple watchOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Versión mínima compatible de watchOS para los simuladores y dispositivos de destino. Si no se especifica, se usa "watchos_sdk_version".
Etiquetas:loses_incremental_state
--xbinary_fdo=<a build target label>
predeterminado: Consulta la descripción-
Usa la información del perfil de XbinaryFDO para optimizar la compilación. Especifica el nombre del perfil binario cruzado 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 rigurosidad con la que Bazel aplica entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
--auto_cpu_environment_group=<a build target label>
predeterminado: ""-
Declara el environment_group que se usará para asignar automáticamente los valores de CPU a los valores de target_environment.
Etiquetas:changes_inputs
,loading_and_analysis
,experimental
--[no]check_licenses
predeterminado: “false”-
Verifica que las restricciones de licencias que imponen los paquetes dependientes no entren en conflicto con los modos de distribución de los destinos que se compilan. De forma predeterminada, no se verifican las licencias.
Etiquetas:build_file_semantics
--[no]check_visibility
predeterminado: "true"-
Si se inhabilita, los errores de visibilidad en las dependencias de destino se degradan a advertencias.
Etiquetas:build_file_semantics
--[no]desugar_for_android
predeterminado: "true"-
Indica si se debe expandir el código de bytes de Java 8 antes de dexificarlo.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]desugar_java8_libs
predeterminado: “false”-
Indica si se deben incluir bibliotecas compatibles de Java 8 en apps para dispositivos heredados.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]enforce_constraints
predeterminado: "true"-
Verifica los entornos con los que es compatible cada objetivo y, luego, informa errores si alguno tiene dependencias que no admiten los mismos entornos.
Etiquetas:build_file_semantics
--[no]experimental_check_desugar_deps
predeterminado: "true"-
Determina si se debe volver a verificar la expansión correcta a nivel binario de Android.
Etiquetas:eagerness_to_exit
,loading_and_analysis
,experimental
--experimental_import_deps_checking=<off, warning or error>
predeterminado: “OFF”-
Cuando está habilitado, verifica si las dependencias de una aar_import están completas. Esta aplicación forzosa puede interrumpir la compilación o generar advertencias.
Etiquetas:loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
predeterminado: "predeterminado"-
Si es verdadero, verifica que un destino de Java declare explícitamente todos los destinos utilizados directamente como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files
predeterminado: “false”-
Si está habilitado, busca el atributo testonly de la regla de generación para verificar si hay destinos de requisitos previos que sean archivos de salida. Esto coincide con la verificación de visibilidad.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_check_visibility_for_toolchains
predeterminado: “false”-
Si está habilitada, la verificación de visibilidad también se aplica a las implementaciones de la cadena de herramientas.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_disable_native_android_rules
predeterminado: “false”-
Si se habilita, se inhabilita el uso directo de las reglas nativas de Android. Usa las reglas de Android de Starlark de https://github.com/bazelbuild/rules_android.
Etiquetas:eagerness_to_exit
,incompatible_change
--[no]incompatible_disable_native_apple_binary_rule
predeterminado: “false”-
No realiza ninguna acción. Se mantiene aquí para la retrocompatibilidad.
Etiquetas:eagerness_to_exit
,incompatible_change
--[no]incompatible_python_disable_py2
predeterminado: "true"-
Si es verdadero, usar la configuración de Python 2 provocará un error. Esto incluye python_version=PY2, srcs_version=PY2 y srcs_version=PY2ONLY. Consulta https://github.com/bazelbuild/bazel/issues/15684 para obtener más información.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_validate_top_level_header_inclusions
predeterminado: "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
,incompatible_change
--python_native_rules_allowlist=<a build target label>
predeterminado: Consulta la descripción-
Es una lista de entidades permitidas (objetivo de package_group) que se usará cuando se aplique --incompatible_python_disallow_native_rules.
Etiquetas:loading_and_analysis
--[no]strict_filesets
predeterminado: “false”-
Si esta opción está habilitada, los conjuntos de archivos que cruzan los límites de los paquetes se informan como errores.
Etiquetas:build_file_semantics
,eagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default>
predeterminado: "error"-
A menos que esté desactivado, comprueba que un destino de proto_library declare de forma explícita todos los destinos utilizados directamente como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
--strict_public_imports=<off, warn, error, strict or default>
predeterminado: "off"-
A menos que esté desactivado, comprueba que un objetivo de proto_library declare de forma explícita todos los objetivos que se usan en "import public" como exportados.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
--[no]strict_system_includes
predeterminado: “false”-
Si es verdadero, también se deben declarar los encabezados que se encuentran a través de las rutas de inclusión del sistema (-isystem).
Etiquetas:loading_and_analysis
,eagerness_to_exit
- Se acumulan varios usos de
--target_environment=<a build target label>
. -
Declara el entorno de destino de esta compilación. Debe ser una referencia de etiqueta a una regla de "entorno". Si se especifican, 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 que se usará para firmar APKs
Etiquetas:action_command_lines
,affects_outputs
,loading_and_analysis
--[no]device_debug_entitlements
predeterminado: "true"-
Si se establece y el modo de compilación no es "opt", las apps de objc incluirán derechos de depuración cuando se firmen.
Etiquetas:changes_inputs
--ios_signing_cert_name=<a string>
predeterminado: Consulta la descripción-
Nombre del certificado que se usará para la firma de iOS. Si no se establece, se usará el perfil de aprovisionamiento. Puede ser la preferencia de identidad del llavero del certificado o la substring del nombre común del certificado, según la página de man de codesign (IDENTIDADES DE FIRMA).
Etiquetas:action_command_lines
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.:
--[no]incompatible_disallow_legacy_py_provider
predeterminado: "true"-
No se puede usar y se quitará pronto.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_sdk_frameworks_attributes
predeterminado: “false”-
Si es verdadero, no se permiten los atributos sdk_frameworks y weak_sdk_frameworks en objc_library y objc_import.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_objc_alwayslink_by_default
predeterminado: “false”-
Si es verdadero, establece el valor predeterminado como verdadero para los atributos alwayslink en objc_library y objc_import.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_python_disallow_native_rules
predeterminado: “false”-
Cuando 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
,incompatible_change
- Opciones que rigen el comportamiento del entorno de prueba o del ejecutor de pruebas:
--[no]allow_analysis_failures
predeterminado: “false”-
Si es verdadero, una falla de análisis de un objetivo de regla genera la propagación del objetivo 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
,experimental
--analysis_testing_deps_limit=<an integer>
predeterminado: “2000”-
Establece la cantidad máxima de dependencias transitivas a través de un atributo de regla con una transición de configuración for_analysis_testing. Si se supera este límite, se mostrará un error de regla.
Etiquetas:loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure
predeterminado: “false”-
Si es verdadero, las fallas de la acción de dex2oat causarán que la compilación falle en lugar de ejecutar dex2oat durante el tiempo de ejecución de la prueba.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_android_use_parallel_dex2oat
predeterminado: “false”-
Usa dex2oat en paralelo para acelerar android_test.
Etiquetas:loading_and_analysis
,host_machine_resource_optimizations
,experimental
--[no]ios_memleaks
predeterminado: “false”-
Habilita la verificación de fugas de memoria en los destinos de ios_test.
Etiquetas:action_command_lines
--ios_simulator_device=<a string>
predeterminado: Consulta la descripción-
Es el dispositivo que se simula cuando se ejecuta una aplicación para iOS en el simulador, p.ej., "iPhone 6". Para obtener una lista de dispositivos, ejecuta "xcrun simctl list devicetypes" en la máquina en la que se ejecutará el simulador.
Etiquetas:test_runner
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Es la versión de iOS que se ejecutará 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 varios usos de
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
. - especifica la cantidad de veces que se debe ejecutar cada prueba. Si alguno de esos intentos falla por algún motivo, se considera que toda la prueba falló. 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 la que runs_per_test representa un valor entero y regex_filter representa una lista de patrones de expresiones regulares para incluir y excluir (consulta también --instrumentation_filter). Ejemplo: --runs_per_test=//foo/.*,-//foo/bar/.*@3 ejecuta todas las pruebas en //foo/, excepto las que se encuentran en foo/bar, tres veces. Esta opción se puede pasar varias veces. El argumento pasado más recientemente que coincida tiene prioridad. Si no hay coincidencias, la prueba solo se ejecuta una vez.
- Se acumulan varios usos de
--test_env=<a 'name=value' assignment with an optional value part>
. -
Especifica variables de entorno adicionales que se insertarán en el entorno del ejecutor de pruebas. Las variables se pueden especificar por nombre, en cuyo caso su valor se leerá del entorno del cliente de Bazel, o por el par nombre=valor. Esta opción se puede usar varias veces para especificar varias variables. Solo lo usa el comando "bazel test".
Etiquetas:test_runner
--test_timeout=<a single integer or comma-separated list of 4 integers>
predeterminado: “-1”- Anula los valores predeterminados de tiempo de espera de prueba para los tiempos de espera de prueba (en segundos). Si se especifica un solo valor de número entero positivo, se anularán todas las categorías. Si se especifican 4 números enteros separados por comas, se anularán los tiempos de espera para corto, moderado, largo y eterno (en ese orden). De cualquier forma, un valor de -1 le indica a blaze que use sus tiempos de espera predeterminados para esa categoría.
--[no]zip_undeclared_test_outputs
predeterminado: "true"-
Si es verdadero, los resultados de las pruebas no declaradas 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: "conservador"-
Cómo resolver las dependencias de aspecto cuando el formato de salida es uno de {xml,proto,record}. "Desactivado" significa que no se resuelven las dependencias de aspecto. "Conservador" (la opción predeterminada) significa que se agregan todas las dependencias de aspecto declaradas, independientemente de si se les asigna la clase de regla de dependencias directas. "Preciso" significa que solo se agregan los aspectos que pueden estar activos según la clase de regla de las dependencias directas. Ten en cuenta que el modo preciso requiere la carga de otros paquetes para evaluar un solo objetivo, lo que lo hace más lento que los otros modos. Ten en cuenta también que incluso el modo preciso no es del todo preciso: la decisión de si calcular un aspecto se toma en la fase de análisis, que no se ejecuta durante la "consulta de bazel".
Etiquetas:build_file_semantics
--[no]consistent_labels
predeterminado: “false”-
Si está habilitada, cada comando de consulta emite etiquetas como si fuera la función Starlark <code>str</code> aplicada a una instancia de <code>Label</code>. Esto es útil para las herramientas que deben coincidir con el resultado de diferentes comandos de consulta o etiquetas que emiten las reglas. Si no están habilitados, los formateadores de salida pueden emitir nombres de repositorio aparentes (en relación con el repositorio principal) para que el resultado sea más legible.
Etiquetas:terminal_output
--[no]graph:factored
predeterminado: "true"-
Si es verdadero, el gráfico se emitirá "factorizado", es decir, los nodos topológicamente equivalentes se combinarán y sus etiquetas se concatenarán. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--graph:node_limit=<an integer>
predeterminado: “512”-
Es la longitud máxima de la cadena de etiqueta para un nodo de gráfico en el resultado. Las etiquetas más largas se truncarán. -1 significa que no se truncará. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--[no]implicit_deps
predeterminado: "true"-
Si está habilitada, se incluirán dependencias implícitas en el gráfico de dependencias sobre el que opera la consulta. Una dependencia implícita es aquella que no se especifica de forma explícita en el archivo BUILD, pero que Bazel agrega. En el caso de cquery, esta opción controla el filtrado de cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
--[no]include_artifacts
predeterminado: "true"-
Incluye los nombres de las entradas y salidas de la acción en el resultado (potencialmente grande).
Etiquetas:terminal_output
--[no]include_aspects
predeterminado: "true"-
aquery, cquery: Indica si se deben incluir acciones generadas por aspectos en el resultado. query: No-op (siempre se siguen los aspectos).
Etiquetas:terminal_output
--[no]include_commandline
predeterminado: "true"-
Incluye el contenido de las líneas de comandos de acción en el resultado (potencialmente grande).
Etiquetas:terminal_output
--[no]include_file_write_contents
predeterminado: “false”-
Incluye el contenido del archivo para las acciones FileWrite, SourceSymlinkManifest y RepoMappingManifest (potencialmente grandes).
Etiquetas:terminal_output
--[no]include_param_files
predeterminado: “false”-
Incluye el contenido de los archivos de parámetros que se usan en el comando (potencialmente grande). Nota: Si habilitas esta marca, se habilitará automáticamente la marca --include_commandline.
Etiquetas:terminal_output
--[no]incompatible_package_group_includes_double_slash
predeterminado: "true"-
Si está habilitada, cuando se genere el atributo "packages" de package_group, no se omitirá el "//" inicial.
Etiquetas:terminal_output
,incompatible_change
--[no]infer_universe_scope
predeterminado: “false”-
Si se establece y no se establece --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 el valor de --universe_scope inferido para una expresión de consulta que usa funciones centradas en el universo (p.ej., "allrdeps") puede no ser lo que deseas, 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 establece --universe_scope, se ignora el valor de esta opción. Nota: Esta opción solo se aplica a "query" (es decir, no a "cquery").
Etiquetas:loading_and_analysis
--[no]line_terminator_null
predeterminado: “false”-
Indica si cada formato finaliza con \0 en lugar de una línea nueva.
Etiquetas:terminal_output
--[no]nodep_deps
predeterminado: "true"-
Si está habilitada, las dependencias de los atributos "nodep" se incluirán en el gráfico de dependencias sobre el que opera la consulta. Un ejemplo común de un atributo "nodep" es "visibility". Ejecuta y analiza el resultado de "info build-language" para obtener información sobre todos los atributos "nodep" en el lenguaje de compilación.
Etiquetas:build_file_semantics
--output=<a string>
predeterminado: “text”-
Es el formato en el que se deben imprimir los resultados de la consulta. Los valores permitidos para aquery son: text, textproto, proto, streamed_proto y jsonproto.
Etiquetas:terminal_output
--[no]proto:default_values
predeterminado: "true"-
Si es verdadero, se incluyen los atributos cuyo valor no se especifica de forma explícita en el archivo BUILD; de lo contrario, se omiten. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
--[no]proto:definition_stack
predeterminado: “false”-
Propaga el campo proto definition_stack, que registra para cada instancia de regla la pila de llamadas de Starlark en el momento en que se definió la clase de la regla.
Etiquetas:terminal_output
--[no]proto:flatten_selects
predeterminado: "true"-
Si está habilitada, los atributos configurables creados por select() se aplanan. En el caso de los tipos de lista, la representación aplanada es una lista que contiene cada valor del mapa de selección exactamente una vez. Los tipos escalares se aplanan a nulos.
Etiquetas:build_file_semantics
--[no]proto:include_attribute_source_aspects
predeterminado: “false”-
Propaga el campo proto source_aspect_name de cada atributo con el aspecto de origen del que proviene el atributo (cadena vacía si no es así).
Etiquetas:terminal_output
--[no]proto:include_synthetic_attribute_hash
predeterminado: “false”-
Indica si se debe calcular y propagar el atributo $internal_attr_hash.
Etiquetas:terminal_output
--[no]proto:instantiation_stack
predeterminado: “false”-
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
--[no]proto:locations
predeterminado: "true"-
Indica si se debe generar información de ubicación en el resultado de proto.
Etiquetas:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
predeterminado: “all”-
Es una lista de atributos separados por comas que se deben incluir en el resultado. La configuración predeterminada es todos los atributos. Se establece en una cadena vacía para no mostrar ningún atributo. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
--[no]proto:rule_inputs_and_outputs
predeterminado: "true"-
Indica si se propagan o no los campos rule_input y rule_output.
Etiquetas:terminal_output
--query_file=<a string>
predeterminado: ""-
Si se establece, la consulta leerá la consulta del archivo que se nombra aquí, en lugar de la línea de comandos. Especificar un archivo aquí y una consulta de línea de comandos es un error.
Etiquetas:changes_inputs
--[no]relative_locations
predeterminado: “false”-
Si es verdadero, la ubicación de los archivos BUILD en los resultados de 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 establecer esta opción en verdadero para obtener un resultado coherente en todas las máquinas.
Etiquetas:terminal_output
--[no]skyframe_state
predeterminado: “false”-
Sin realizar un análisis adicional, volca el grafo de acciones actual de Skyframe. Nota: Por el momento, no se admite especificar un destino con --skyframe_state. Esta marca solo está disponible con --output=proto o --output=textproto.
Etiquetas:terminal_output
--[no]tool_deps
predeterminado: "true"-
Consulta: Si se inhabilita, las dependencias de "configuración de ejecución" no se incluirán en el gráfico de dependencias sobre el que opera la consulta. Un borde de dependencia de "configuración de ejecución", como el de cualquier regla "proto_library" al compilador de protocolos, suele apuntar a una herramienta que se ejecuta durante la compilación en lugar de a una parte del mismo programa "objetivo".
Cquery: Si se inhabilita, filtra todos los objetivos configurados que crucen una transición de ejecución desde el objetivo de nivel superior que descubrió este objetivo configurado. Esto significa que, si el objetivo de nivel superior está en la configuración de destino, solo se mostrarán los objetivos configurados también en la configuración de destino. Si el objetivo de nivel superior está en la configuración de exec, solo se mostrarán los objetivos configurados de exec. Esta opción NO excluirá las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
--universe_scope=<comma-separated list of options>
predeterminado: ""-
Es un conjunto de patrones de segmentación (aditivos y sustractivos) separados por comas. La consulta se puede realizar en el universo definido por el cierre transitivo de los destinos especificados. Esta opción se usa para los comandos query y cquery.
En el caso de cquery, la entrada de esta opción son los objetivos en los que se compilan todas las respuestas, por lo que esta opción puede afectar las configuraciones y las transiciones. Si no se especifica esta opción, se supone que los destinos de nivel superior son los que se analizan de la expresión de consulta. Nota: En el caso de cquery, si no especificas esta opción, es posible que la compilación falle si los destinos analizados de la expresión de consulta no se pueden compilar con opciones de nivel superior.
Etiquetas:loading_and_analysis
- Opciones que activan optimizaciones del tiempo de compilación:
--[no]experimental_filter_library_jar_with_program_jar
predeterminado: “false”-
Filtra el ProgramJar de ProGuard para quitar las clases que también estén presentes en el LibraryJar.
Etiquetas:action_command_lines
--[no]experimental_inmemory_dotd_files
predeterminado: "true"-
Si se habilita, los archivos .d de C++ se pasarán en la memoria directamente desde los nodos de compilación remotos en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_inmemory_jdeps_files
predeterminado: "true"-
Si está habilitado, los archivos de dependencia (.jdeps) generados a partir de compilaciones de Java se pasarán en la memoria directamente desde los nodos de compilación remotos en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_objc_include_scanning
predeterminado: “false”-
Indica si se debe incluir el análisis de C/C++ objetivo.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
--[no]experimental_retain_test_configuration_across_testonly
predeterminado: “false”-
Cuando se habilita, --trim_test_configuration no recortará la configuración de prueba de las reglas marcadas como testonly=1. Esto se hace para reducir los problemas de conflicto de acciones cuando las reglas que no son de prueba dependen de las reglas de cc_test. No tiene efecto si --trim_test_configuration es falso.
Etiquetas:loading_and_analysis
,loses_incremental_state
--[no]experimental_starlark_cc_import
predeterminado: “false”-
Si está habilitada, se puede usar la versión de Starlark de cc_import.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_unsupported_and_brittle_include_scanning
predeterminado: “false”-
Determina si se deben reducir las entradas a la compilación de C/C++ a través del análisis de líneas #include de los archivos de entrada. Esto puede mejorar el rendimiento y la incrementalidad, ya que reduce el tamaño de los árboles de entrada de compilación. Sin embargo, también puede interrumpir las compilaciones porque el escáner de inclusión no implementa por completo la semántica del preprocesador C. En particular, no comprende las directivas #include dinámicas y omite la lógica condicional del preprocesador. Úsala bajo tu propia responsabilidad. Se cerrarán todos los problemas relacionados con esta marca que se hayan presentado.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
--[no]incremental_dexing
predeterminado: "true"-
Realiza la mayor parte del trabajo de dexing por separado para cada archivo JAR.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]objc_use_dotd_pruning
predeterminado: "true"-
Si se establece, los archivos .d emitidos por clang se usarán para podar el conjunto de entradas que se pasan a las compilaciones de objc.
Etiquetas:changes_inputs
,loading_and_analysis
--[no]process_headers_in_dependencies
predeterminado: “false”-
Cuando compilas un destino //a:a, procesa los encabezados en todos los destinos de los que depende //a:a (si el procesamiento de encabezados está habilitado para la cadena de herramientas).
Etiquetas:execution
--[no]trim_test_configuration
predeterminado: "true"-
Cuando se habilita, se borran las opciones relacionadas con las pruebas debajo del nivel superior de la compilación. Cuando esta marca está activa, las pruebas no se pueden compilar como dependencias de reglas que no son de prueba, pero los cambios en las opciones relacionadas con las pruebas no harán que se vuelvan a analizar las reglas que no son de prueba.
Etiquetas:loading_and_analysis
,loses_incremental_state
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Valor predeterminado de
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: “-.*”. -
Imprime información de depuración durante la resolución de la cadena de herramientas. La marca toma una regex, que se compara con los tipos de cadena de herramientas y los objetivos específicos para ver cuál depurar. Se pueden separar varias regex con comas y, luego, cada una se verifica por separado. Nota: El resultado de esta marca es muy complejo y es probable que solo sea útil para expertos en la resolución de cadenas de herramientas.
Etiquetas:terminal_output
- Son opciones que especifican o alteran una entrada genérica en un comando de Bazel que no pertenece a otras categorías.:
- Se acumulan varios usos de
--flag_alias=<a 'name=value' flag alias>
. -
Establece un nombre abreviado para una marca de Starlark. Toma un solo par clave-valor en el formato "<clave>=<valor>" como argumento.
Etiquetas:changes_inputs
--[no]incompatible_default_to_explicit_init_py
predeterminado: “false”-
Esta marca cambia el comportamiento predeterminado para que los archivos __init__.py ya no se creen automáticamente en los archivos de ejecución de los destinos de Python. Específicamente, cuando un objetivo py_binary o py_test tiene legacy_create_init establecido en "auto" (el valor predeterminado), se considera falso solo si se establece esta marca. Consulta https://github.com/bazelbuild/bazel/issues/10076.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_py2_outputs_are_suffixed
predeterminado: "true"-
Si es verdadero, los destinos compilados en la configuración de Python 2 aparecerán en una raíz de salida que incluye el sufijo "-py2", mientras que los destinos compilados para Python 3 aparecerán en una raíz sin sufijo relacionado con Python. Esto significa que el symlink de conveniencia "bazel-bin" apuntará a destinos de Python 3 en lugar de Python 2. Si habilitas esta opción, también se recomienda habilitar `--incompatible_py3_is_default`.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_py3_is_default
predeterminado: "true"-
Si es verdadero, los destinos "py_binary" y "py_test" que no establezcan su atributo "python_version" (o "default_python_version") usarán PY3 de forma predeterminada en lugar de PY2. Si estableces esta marca, también se recomienda establecer `--incompatible_py2_outputs_are_suffixed`.
Etiquetas:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_use_python_toolchains
predeterminado: "true"-
Si se establece como verdadero, las reglas ejecutables de Python nativas usarán el entorno de ejecución de Python especificado por la cadena de herramientas de Python, en lugar del entorno de ejecución que proporcionan las marcas heredadas, como --python_top.
Etiquetas:loading_and_analysis
,incompatible_change
--python_version=<PY2 or PY3>
predeterminado: Consulta la descripción-
Es el modo de versión principal de Python, ya sea "PY2" o "PY3". Ten en cuenta que esto se anula con los destinos "py_binary" y "py_test" (incluso si no especifican una versión de forma explícita), por lo que, por lo general, no hay muchos motivos para proporcionar esta marca.
Etiquetas:loading_and_analysis
,affects_outputs
- Opciones misceláneas que no se clasifican de otra manera:
--[no]cache_test_results
[-t
] predeterminado: "auto"- Si se establece en “auto”, Bazel vuelve a ejecutar una prueba solo si se cumplen las siguientes condiciones: (1) Bazel detecta cambios en la prueba o sus dependencias, (2) la prueba está marcada como externa, (3) se solicitaron varias ejecuciones de prueba con --runs_per_test o(4) la prueba falló anteriormente. Si se establece como “sí”, Bazel almacena en caché todos los resultados de las pruebas, excepto las marcadas como externas. Si se establece en "no", Bazel no almacena en caché ningún resultado de la prueba.
--[no]experimental_cancel_concurrent_tests
predeterminado: “false”-
Si es verdadero, Blaze cancelará las pruebas que se ejecutan de forma simultánea en la primera ejecución correcta. Esto solo es útil en combinación con --runs_per_test_detects_flakes.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_fetch_all_coverage_outputs
predeterminado: “false”-
Si es verdadero, Bazel recupera todo el directorio de datos de cobertura para cada prueba durante una ejecución de cobertura.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_generate_llvm_lcov
predeterminado: “false”-
Si es verdadero, la cobertura de clang generará un informe LCOV.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_j2objc_header_map
predeterminado: "true"- Determina si se debe generar un mapa de encabezados de J2ObjC en paralelo con la transpilación de J2ObjC.
--[no]experimental_j2objc_shorter_header_path
predeterminado: “false”-
Indica si se debe generar con una ruta de encabezado más corta (usa “_ios” en lugar de “_j2objc”).
Etiquetas:affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
predeterminado: "javabuilder"- Habilita classpaths reducidos para compilaciones de Java.
--[no]experimental_limit_android_lint_to_android_constrained_java
predeterminado: “false”-
Limita --experimental_run_android_lint_on_java_rules a las bibliotecas compatibles con Android.
Etiquetas:affects_outputs
--[no]experimental_run_android_lint_on_java_rules
predeterminado: “false”-
Determina si se deben validar las fuentes java_*.
Etiquetas:affects_outputs
--[no]explicit_java_test_deps
predeterminado: “false”- Especifica de forma explícita una dependencia a JUnit o Hamcrest en un java_test en lugar de obtenerla accidentalmente de las dependencias de TestRunner. Por el momento, solo funciona para bazel.
--host_java_launcher=<a build target label>
predeterminado: Consulta la descripción- Es el selector de Java que usan las herramientas que se ejecutan durante una compilación.
- Se acumulan varios usos de
--host_javacopt=<a string>
. - Opciones adicionales para pasar a javac cuando se compilan herramientas que se ejecutan durante una compilación.
- Se acumulan varios usos de
--host_jvmopt=<a string>
. - Opciones adicionales para pasar a la VM de Java cuando se compilan herramientas que se ejecutan durante la compilación. Estas opciones se agregarán a las opciones de inicio de la VM de cada destino java_binary.
--[no]incompatible_check_sharding_support
predeterminado: "true"-
Si es verdadero, Bazel fallará en una prueba fragmentada si el ejecutor de pruebas no indica que admite el fragmentación tocando el archivo en la ruta de acceso en TEST_SHARD_STATUS_FILE. Si es falso, un ejecutor de pruebas que no admita la fragmentación hará que todas las pruebas se ejecuten en cada fragmento.
Etiquetas:incompatible_change
--[no]incompatible_exclusive_test_sandboxed
predeterminado: "true"-
Si es verdadero, las pruebas exclusivas se ejecutarán con la estrategia de zona de pruebas. Agrega la etiqueta "local" para forzar que se ejecute una prueba exclusiva de forma local.
Etiquetas:incompatible_change
--[no]incompatible_strict_action_env
predeterminado: “false”-
Si es verdadero, Bazel usa un entorno con un valor estático para PATH y no hereda LD_LIBRARY_PATH. Usa --action_env=ENV_VARIABLE si deseas heredar variables de entorno específicas del cliente, pero ten en cuenta que, de esta manera, se puede evitar la caché entre usuarios si se usa una caché compartida.
Etiquetas:loading_and_analysis
,incompatible_change
- Se acumulan varios usos de
--j2objc_translation_flags=<comma-separated list of options>
. - : Opciones adicionales para pasar a la herramienta J2ObjC.
--java_debug
-
Hace que la máquina virtual de Java de una prueba de Java espere una conexión de un depurador compatible con JDWP (como jdb) antes de iniciar la prueba. Implica -test_output=streamed.
Se expande a:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
--[no]java_deps
predeterminado: "true"- Genera información de dependencia (por ahora, el classpath del tiempo de compilación) por destino de Java.
--[no]java_header_compilation
predeterminado: "true"- Compila ijars directamente desde la fuente.
--java_language_version=<a string>
predeterminado: ""- La versión del lenguaje Java
--java_launcher=<a build target label>
predeterminado: Consulta la descripción- Es el selector de Java que se usará cuando se compilen objetos binarios de Java. Si esta marca se establece en la cadena vacía, se usa el selector de JDK. El atributo "launcher" anula esta marca.
--java_runtime_version=<a string>
predeterminado: "local_jdk"- La versión del entorno de ejecución de Java
- Se acumulan varios usos de
--javacopt=<a string>
. - Opciones adicionales para pasar a javac.
- Se acumulan varios usos de
--jvmopt=<a string>
. - Opciones adicionales para pasar a la VM de Java. Estas opciones se agregarán a las opciones de inicio de la VM de cada destino java_binary.
--legacy_main_dex_list_generator=<a build target label>
predeterminado: Consulta la descripción- especifica un objeto binario que se usará para generar la lista de clases que deben estar en el archivo DEX principal cuando se compila el multidex heredado.
--optimizing_dexer=<a build target label>
predeterminado: Consulta la descripción- Especifica un objeto binario para usar y realizar la conversión a Dex sin fragmentación.
- Se acumulan varios usos de
--plugin=<a build target label>
. - Plug-ins para usar en la compilación. Actualmente, funciona con java_plugin.
--proguard_top=<a build target label>
predeterminado: Consulta la descripción- Especifica qué versión de ProGuard se usará para quitar el código cuando se compila un objeto binario de Java.
--proto_compiler=<a build target label>
predeterminado: "@bazel_tools//tools/proto:protoc"-
Es la etiqueta del protocompilador.
Etiquetas:affects_outputs
,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
,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 de j2objc
Etiquetas:affects_outputs
,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
,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
,loading_and_analysis
- Se acumulan varios usos de
--protocopt=<a string>
. -
Opciones adicionales para pasar al compilador de protobuf.
Etiquetas:affects_outputs
--[no]runs_per_test_detects_flakes
predeterminado: “false”- Si es verdadero, cualquier fragmento en el que se apruebe al menos una ejecución o intento y falle al menos una ejecución o intento tendrá el estado FLAKY.
--shell_executable=<a path>
predeterminado: Consulta la descripción-
Ruta de acceso absoluta al ejecutable de shell que usará Bazel. Si no se establece, pero la variable de entorno BAZEL_SH se establece en la primera invocación de Bazel (que inicia un servidor de Bazel), Bazel la usará. Si no se establece ninguno, Bazel usa una ruta de acceso predeterminada fija según el sistema operativo en el que se ejecuta (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, todos los demás: /bin/bash). Ten en cuenta que usar un shell que no sea compatible con bash puede generar fallas de compilación o de tiempo de ejecución de los objetos binarios generados.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--test_arg=<a string>
. - Especifica opciones y argumentos adicionales que se deben pasar al ejecutable de prueba. Se puede usar varias veces para especificar varios argumentos. Si se ejecutan varias pruebas, cada una de ellas recibirá argumentos idénticos. Solo lo usa el comando "bazel test".
--test_filter=<a string>
predeterminado: Consulta la descripción- : Especifica un filtro para reenviar al framework de pruebas. Se usa para limitar las pruebas que se ejecutan. Ten en cuenta que esto no afecta los destinos que se compilan.
--test_result_expiration=<an integer>
predeterminado: “-1”- Esta opción está obsoleta y no tiene ningún efecto.
--[no]test_runner_fail_fast
predeterminado: “false”- Redirecciona la opción de falla rápida al ejecutor de pruebas. El ejecutor de pruebas debe detener la ejecución en la primera falla.
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>
predeterminado: "explicit"- Especifica la estrategia para el fragmentación de prueba: "explicit" para usar solo la fragmentación si está presente el atributo BUILD "shard_count". "disabled" para nunca usar el fragmentación de prueba. "forced=k" para aplicar fragmentos "k" para las pruebas, independientemente del atributo BUILD "shard_count".
--tool_java_language_version=<a string>
predeterminado: ""- La versión del 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
--[no]use_ijars
predeterminado: "true"- Si está habilitada, esta opción hace que la compilación de Java use archivos JAR de interfaz. Esto generará una compilación incremental más rápida, pero los mensajes de error pueden ser diferentes.
Build Options
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
. -
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, se puede hacer que los repositorios externos funcionen en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_connector_attempts=<an integer>
predeterminado: “8”-
Es la cantidad máxima de intentos de descargas HTTP.
Etiquetas:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
predeterminado: “0s”-
Es el tiempo de espera máximo para los reintentos de descarga HTTP. Con un valor de 0, no se define un tiempo de espera máximo.
Etiquetas:bazel_internal_configuration
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la 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, se usa el valor predeterminado de '<output_user_root>/cache/repos/v1'.
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
predeterminado: “false”-
Si se establece, 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 se inhabilita por completo; 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 la compilación:
--[no]check_up_to_date
predeterminado: “false”-
No realices la compilación, solo verifica si está actualizada. Si todos los destinos están actualizados, la compilación se completa correctamente. Si se debe ejecutar algún paso, se informa un error y falla la compilación.
Etiquetas:execution
--dynamic_local_execution_delay=<an integer>
predeterminado: “1000”-
¿Cuántos milisegundos se debe retrasar la ejecución local si la ejecución remota fue más rápida durante una compilación al menos una vez?
Etiquetas:execution
,host_machine_resource_optimizations
- Se acumulan varios usos de
--dynamic_local_strategy=<a '[name=]value1[,..,valueN]' assignment>
. -
Las estrategias locales, en orden, que se usarán para la mnemotecnia determinada (se usa la primera estrategia aplicable). Por ejemplo, "worker,sandboxed" ejecuta acciones que admiten trabajadores persistentes con la estrategia de trabajador y todas las demás con la estrategia de zona de pruebas. Si no se proporciona ninguna mnemotecnia, la lista de estrategias se usa como resguardo para todas las mnemotecnias. La lista de resguardo predeterminada es "worker,sandboxed" o "worker,sandboxed,standalone" si se establece "experimental_local_lockfree_output". Toma [mnemonic=]local_strategy[,local_strategy,…]
Etiquetas:execution
,host_machine_resource_optimizations
- Se acumulan varios usos de
--dynamic_remote_strategy=<a '[name=]value1[,..,valueN]' assignment>
. -
Las estrategias remotas, en orden, para usar en la mnemotecnia determinada (se usa la primera estrategia aplicable). Si no se proporciona ninguna mnemotecnia, la lista de estrategias se usa como resguardo para todas las mnemotecnias. La lista de resguardo predeterminada es "remote", por lo que, por lo general, no es necesario configurar esta marca de forma explícita. Toma [mnemonic=]remote_strategy[,remote_strategy,...]
Etiquetas:execution
,host_machine_resource_optimizations
--experimental_docker_image=<a string>
predeterminado: ""-
Especifica un nombre de imagen de Docker (p.ej., “ubuntu:latest”) que se debe usar para ejecutar una acción en zona de pruebas cuando se usa la estrategia de Docker y la acción en sí no tiene un atributo de imagen de contenedor en sus remote_execution_properties en la descripción de la plataforma. El valor de esta marca se pasa de forma literal a "docker run", por lo que admite la misma sintaxis y los mismos mecanismos que Docker.
Etiquetas:execution
--[no]experimental_docker_use_customized_images
predeterminado: "true"-
Si está habilitada, inserta el UID y el GID del usuario actual en la imagen de Docker antes de usarla. Esto es obligatorio si tu compilación o pruebas dependen de que el usuario tenga un nombre y un directorio principal dentro del contenedor. Esta opción está activada de forma predeterminada, pero puedes inhabilitarla en caso de que la función de personalización automática de imágenes no funcione en tu caso o sepas que no la necesitas.
Etiquetas:execution
--[no]experimental_dynamic_exclude_tools
predeterminado: "true"-
Cuando se configuran, los destinos que se compilan "para la herramienta" no están sujetos a la ejecución dinámica. Es muy poco probable que estos objetivos se compilen de forma incremental y, por lo tanto, no vale la pena invertir ciclos locales en ellos.
Etiquetas:execution
,host_machine_resource_optimizations
--experimental_dynamic_local_load_factor=<a double>
predeterminado: “0”- Controla la cantidad de carga de la ejecución dinámica que se colocará en la máquina local. Esta marca ajusta la cantidad de acciones en la ejecución dinámica que programaremos de forma simultánea. Se basa en la cantidad de CPUs que Blaze considera que están disponibles, que se puede controlar con la marca --local_cpu_resources.
Si esta marca es 0, todas las acciones se programan de forma local de inmediato. Si es mayor que 0, la cantidad de acciones programadas de forma local se limita por la cantidad de CPUs disponibles. Si es menor que 1, el factor de carga se usa para reducir la cantidad de acciones programadas de forma local cuando la cantidad de acciones que esperan programación es alta. Esto reduce la carga en la máquina local en el caso de la compilación limpia, en el que la máquina local no contribuye mucho.
Etiquetas:execution
,host_machine_resource_optimizations
--experimental_dynamic_slow_remote_time=<An immutable length of time.>
predeterminado: “0”-
Si es mayor que 0, es el tiempo que una acción que se ejecuta de forma dinámica debe ejecutarse solo de forma remota antes de que prioricemos su ejecución local para evitar tiempos de espera remotos. Esto puede ocultar algunos problemas en el sistema de ejecución remota. No actives esta opción sin supervisar los problemas de ejecución remota.
Etiquetas:execution
,host_machine_resource_optimizations
--[no]experimental_enable_docker_sandbox
predeterminado: “false”-
Habilita la zona de pruebas basada en Docker. Esta opción no tiene efecto si Docker no está instalado.
Etiquetas:execution
--experimental_sandbox_async_tree_delete_idle_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
predeterminado: “4”-
Si es 0, borra los árboles de zona de pruebas en cuanto se completa una acción (lo que retrasa 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 el tamaño 1 cuando se ejecute la compilación y que crezca hasta el tamaño especificado por esta marca cuando el servidor esté inactivo.
Etiquetas:host_machine_resource_optimizations
,execution
--experimental_sandbox_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
predeterminado: “0”-
Si es mayor que 0, cada zona de pruebas de Linux se limitará a la cantidad de memoria determinada (en MB). Requiere cgroups v1 o v2 y permisos para que los usuarios accedan a la carpeta de cgroups.
Etiquetas:execution
--[no]experimental_shrink_worker_pool
predeterminado: “false”-
Si está habilitado, podría reducir el grupo de trabajadores si la presión de memoria del trabajador es alta. Esta marca solo funciona cuando la marca experimental_total_worker_memory_limit_mb está habilitada.
Etiquetas:execution
,host_machine_resource_optimizations
--[no]experimental_split_xml_generation
predeterminado: "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 ficticio que contiene el registro de prueba. De lo contrario, Bazel genera un test.xml como parte de la acción de prueba.
Etiquetas:execution
--experimental_total_worker_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
predeterminado: “0”-
Si este límite es mayor que cero, es posible que se eliminen los trabajadores inactivos si el uso total de memoria de todos los trabajadores supera el límite.
Etiquetas:execution
,host_machine_resource_optimizations
--[no]experimental_use_hermetic_linux_sandbox
predeterminado: “false”-
Si se establece como verdadero, no 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 vínculo simbólico desde la zona de pruebas. Si los archivos de entrada de la acción se encuentran en un sistema de archivos diferente al de la zona de pruebas, se copiarán los archivos de entrada.
Etiquetas:execution
--[no]experimental_use_semaphore_for_jobs
predeterminado: “false”-
Si se establece en verdadero, además, usa un semáforo para limitar la cantidad de trabajos simultáneos.
Etiquetas:host_machine_resource_optimizations
,execution
--[no]experimental_use_windows_sandbox
predeterminado: “false”-
Usa la zona de pruebas de Windows para ejecutar acciones. Si es "sí", el binario que proporciona --experimental_windows_sandbox_path debe ser válido y debe 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"-
Es la ruta de acceso al objeto binario de la zona de pruebas de Windows que se usará cuando --experimental_use_windows_sandbox sea verdadero. Si es un nombre sin formato, usa el primer objeto binario de ese nombre que se encuentre en la PATH.
Etiquetas:execution
--experimental_worker_allowlist=<comma-separated set of options>
predeterminado: Consulta la descripción-
Si no está vacío, solo permite usar trabajadores persistentes con la mnemotecnia de clave de trabajador determinada.
Etiquetas:execution
,host_machine_resource_optimizations
--[no]experimental_worker_as_resource
predeterminado: "true"-
No se puede usar y se quitará pronto.
Etiquetas:no_op
--[no]experimental_worker_cancellation
predeterminado: “false”-
Si está habilitado, Bazel puede enviar solicitudes de cancelación a los trabajadores que las admiten.
Etiquetas:execution
--experimental_worker_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
predeterminado: “0”-
Si este límite es mayor que cero, es posible que se cancelen los trabajadores si el uso de memoria del trabajador 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 tu compilación falle.
Etiquetas:execution
,host_machine_resource_optimizations
--experimental_worker_metrics_poll_interval=<An immutable length of time.>
predeterminado: "5s"-
Es el intervalo entre la recopilación de métricas de los trabajadores y, posiblemente, el intento de desalojos. No puede ser inferior a 1 segundo por motivos de rendimiento.
Etiquetas:execution
,host_machine_resource_optimizations
--[no]experimental_worker_multiplex_sandboxing
predeterminado: “false”-
Si se habilita, los trabajadores de multiplexación se colocarán en la zona de pruebas, con un directorio de zona de pruebas independiente por solicitud de trabajo. Solo se incluirán en la zona de pruebas los trabajadores que tengan el requisito de ejecución "supports-multiplex-sandboxing".
Etiquetas:execution
--[no]experimental_worker_sandbox_hardening
predeterminado: “false”-
Si está habilitada, los trabajadores se ejecutan en una zona de pruebas endurecida, si la implementación lo permite.
Etiquetas:execution
--[no]experimental_worker_strict_flagfiles
predeterminado: “false”-
Si está habilitado, los argumentos de acciones para los trabajadores que no siguen la especificación del trabajador generarán un error. Los argumentos del trabajador deben tener exactamente un argumento @flagfile como el último de su lista de argumentos.
Etiquetas:execution
--gc_thrashing_threshold=<an integer in 0-100 range>
predeterminado: "100"-
Es el porcentaje de espacio ocupado (de 0 a 100) por encima del cual GcThrashingDetector considera los eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, se inhabilita GcThrashingDetector.
Etiquetas:host_machine_resource_optimizations
--genrule_strategy=<comma-separated list of options>
predeterminado: ""-
Especifica cómo ejecutar genrules. Esta marca se dará de baja gradualmente. En su lugar, usa --spawn_strategy=<value> para controlar todas las acciones o --strategy=Genrule=<value> para controlar solo las genrules.
Etiquetas:execution
- Se acumulan varios usos de
--high_priority_workers=<a string>
. -
No se puede usar y se quitará pronto.
Etiquetas:execution
--[no]incompatible_remote_dangling_symlinks
predeterminado: "true"-
Si se establece como verdadero y --incompatible_remote_symlinks también es verdadero, los symlinks en los resultados de la acción pueden colgar.
Etiquetas:execution
,incompatible_change
--[no]incompatible_remote_symlinks
predeterminado: "true"-
Si se establece como verdadero, Bazel representará los symlinks en los resultados de la acción en el protocolo de ejecución o almacenamiento en caché remoto como tal. De lo contrario, se seguirán los symlinks y se representarán como archivos o directorios. Consulta el problema #6631 para obtener más información.
Etiquetas:execution
,incompatible_change
--[no]incompatible_sandbox_hermetic_tmp
predeterminado: "true"-
Si se establece como verdadero, cada zona de pruebas de Linux tendrá su propio directorio vacío dedicado activado como /tmp en lugar de compartir /tmp con el sistema de archivos del host. Usa --sandbox_add_mount_pair=/tmp para seguir viendo el /tmp del host en todas las zonas de pruebas.
Etiquetas:execution
--[no]internal_spawn_scheduler
predeterminado: “false”-
Opción de marcador de posición para que podamos indicar en Blaze si se habilitó el programador de creación.
Etiquetas:execution
,host_machine_resource_optimizations
--jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
[-j
] predeterminado: "auto"-
Es la cantidad de trabajos simultáneos que se ejecutarán. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), 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. "auto" calcula un valor predeterminado razonable según los recursos del host.
Etiquetas:host_machine_resource_optimizations
,execution
--[no]keep_going
[-k
] predeterminado: "false"-
Continúa tanto como sea posible después de un error. Si bien no se pueden analizar el objetivo que falló ni los que dependen de él, sí se pueden analizar otros requisitos previos de estos objetivos.
Etiquetas:eagerness_to_exit
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
predeterminado: “auto”-
Cantidad de subprocesos en paralelo que se usarán para la fase de carga o análisis. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". "auto" establece un valor predeterminado razonable según los recursos del host. Debe ser 1 como mínimo.
Etiquetas:bazel_internal_configuration
--[no]reuse_sandbox_directories
predeterminado: "true"-
Si se establece en verdadero, los directorios que usa la ejecución no de trabajador en zona de pruebas se pueden volver a usar para evitar costos de configuración innecesarios.
Etiquetas:host_machine_resource_optimizations
,execution
--sandbox_base=<a string>
predeterminado: ""-
Permite que la zona de pruebas cree sus directorios en esta ruta. Especifica una ruta de acceso en tmpfs (como /run/shm) para 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 los archivos de salida y los archivos intermedios que generan las acciones de ejecución.
Etiquetas:host_machine_resource_optimizations
,execution
--[no]sandbox_explicit_pseudoterminal
predeterminado: “false”-
Habilita de forma explícita la creación de pseudoterminales para acciones en zona de pruebas. Algunas distribuciones de Linux requieren que se configure el ID de grupo del proceso en "tty" dentro de la zona de pruebas para que funcionen los pseudoterminales. Si esto causa problemas, se puede inhabilitar esta marca para permitir el uso de otros grupos.
Etiquetas:execution
- Se acumulan varios usos de
--sandbox_tmpfs_path=<an absolute path>
. -
Para las acciones en zona de pruebas, activa un directorio vacío y con permisos de escritura en esta ruta de acceso absoluta (si la implementación de zona de pruebas lo admite, se ignora de lo contrario).
Etiquetas:host_machine_resource_optimizations
,execution
--[no]skip_incompatible_explicit_targets
predeterminado: “false”-
Omite los destinos incompatibles que se enumeran de forma explícita en la línea de comandos. De forma predeterminada, la compilación de esos destinos genera un error, pero se omiten de forma silenciosa cuando se habilita esta opción. Consulta: https://bazel.build/extending/platforms#skipping-incompatible-targets
Etiquetas:loading_and_analysis
--spawn_strategy=<comma-separated list of options>
predeterminado: ""-
Especifica cómo se ejecutan las acciones de creació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 varios usos de
--strategy=<a '[name=]value1[,..,valueN]' assignment>
. -
Especifica cómo distribuir la compilación de otras acciones de creació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 mnemónico). Consulta https://blog.bazel.build/2019/06/19/list-strategy.html para obtener más información.
Etiquetas:execution
- Se acumulan varios usos de
--strategy_regexp=<a '<RegexFilter>=value[,value]' assignment>
. -
Anula qué estrategia de activación se debe usar para ejecutar acciones de activación que tengan descripciones que coincidan con un cierto regex_filter. Consulta --per_file_copt para obtener detalles sobre la coincidencia de regex_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 estrategia "local", pero si se invierte el orden, se ejecutará con "sandboxed".
Etiquetas:execution
- Se acumulan varios usos de
--worker_extra_flag=<a 'name=value' assignment>
. -
Son marcas de comando adicionales que se pasarán a los procesos de trabajo, además de --persistent_worker, con clave mnemónica (p.ej., --worker_extra_flag=Javac=--debug.
Etiquetas:execution
,host_machine_resource_optimizations
- Se acumulan varios usos de
--worker_max_instances=<[name=]value, where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
. -
Cuántas instancias de cada tipo de trabajador persistente se pueden iniciar si usas la estrategia "worker". Se puede especificar como [name=value] para dar un valor diferente por mnemotecnia. El límite se basa en las claves de trabajador, que se diferencian según la mnemotecnia, pero también según las marcas de inicio y el entorno, por lo que, en algunos casos, puede haber más trabajadores por mnemotecnia de los que especifica 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". "auto" calcula un valor predeterminado razonable en función de la capacidad de la máquina. “=value” establece un valor predeterminado para mnemotecnias no especificadas.
Etiquetas:execution
,host_machine_resource_optimizations
- Se acumulan varios usos de
--worker_max_multiplex_instances=<[name=]value, where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
. -
Cuántas WorkRequests puede recibir en paralelo un proceso de trabajador multiplexado si usas la estrategia "worker" con --worker_multiplex. Se puede especificar como [name=value] para dar un valor diferente por mnemotecnia. El límite se basa en las claves de trabajador, que se diferencian según la mnemotecnia, pero también según las marcas de inicio y el entorno, por lo que, en algunos casos, puede haber más trabajadores por mnemotecnia de los que especifica 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". "auto" calcula un valor predeterminado razonable en función de la capacidad de la máquina. “=value” establece un valor predeterminado para mnemotecnias no especificadas.
Etiquetas:execution
,host_machine_resource_optimizations
--[no]worker_multiplex
predeterminado: "true"-
Si está habilitada, los trabajadores usarán la multiplexación si la admiten.
Etiquetas:execution
,host_machine_resource_optimizations
--[no]worker_quit_after_build
predeterminado: “false”-
Si se habilita, todos los trabajadores se quitan después de que se completa una compilación.
Etiquetas:execution
,host_machine_resource_optimizations
--[no]worker_sandboxing
predeterminado: “false”-
Si se habilita, los trabajadores se ejecutarán en un entorno de zona de pruebas.
Etiquetas:execution
--[no]worker_verbose
predeterminado: “false”- Si está habilitada, imprime mensajes detallados cuando se inician, se cierran, etc. los trabajadores.
- Opciones que configuran la cadena de herramientas que se usa para la ejecución de acciones:
--target_platform_fallback=<a string>
predeterminado: ""-
Esta opción está obsoleta y no tiene ningún efecto.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
- Opciones que controlan el resultado del comando:
--[no]build
predeterminado: "true"-
Ejecuta la compilación. Este es el comportamiento habitual. Especificar --nobuild hace que la compilación se detenga antes de ejecutar las acciones de compilación y devuelva cero si las fases de carga y análisis del paquete se completaron correctamente. Este modo es útil para probar esas fases.
Etiquetas:execution
,affects_outputs
--[no]experimental_use_validation_aspect
predeterminado: “false”-
Indica si se deben ejecutar acciones de validación con el aspecto (para el paralelismo con las pruebas).
Etiquetas:execution
,affects_outputs
- Se acumulan varios usos de
--output_groups=<comma-separated list of options>
. -
Es una lista de nombres de grupos de salida separados por comas, cada uno de los cuales puede tener un prefijo de + o -. Un grupo con el prefijo + se agrega al conjunto predeterminado de grupos de salida, mientras que un grupo con el prefijo - se quita del conjunto predeterminado. Si no se agrega un prefijo a, al menos, un grupo, se omite el conjunto predeterminado de grupos de salida. Por ejemplo, --output_groups=+foo,+bar compila la unión del conjunto predeterminado, foo y bar, mientras que --output_groups=foo,bar anula el conjunto predeterminado de modo que solo se compilen foo y bar.
Etiquetas:execution
,affects_outputs
--[no]run_validations
predeterminado: "true"-
Indica si se deben ejecutar acciones de validación como parte de la compilación. Consulta https://bazel.build/extending/rules#validation_actions
Etiquetas:execution
,affects_outputs
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
- Se acumulan varios usos de
--aspects=<comma-separated list of options>
. - Es una lista de aspectos separados por comas que se aplicarán a los objetivos de nivel superior. En la lista, si el aspecto some_aspect especifica proveedores de aspectos obligatorios a través de required_aspect_providers, some_aspect se ejecutará después de cada aspecto que se mencionó antes en la lista de aspectos cuyos proveedores anunciados satisfacen los proveedores de aspectos obligatorios de some_aspect. Además, some_aspect se ejecutará después de todos sus aspectos obligatorios especificados por el atributo requires. Luego, some_aspect tendrá acceso a los valores de los proveedores de esos aspectos. <bzl-file-label>%<aspect_name>, por ejemplo, "//tools:my_def.bzl%my_aspect", donde "my_aspect" es un valor de nivel superior de un archivo tools/my_def.bzl
--bep_maximum_open_remote_upload_files=<an integer>
predeterminado: “-1”-
Cantidad máxima de archivos abiertos permitidos durante la carga de artefactos de BEP.
Etiquetas:affects_outputs
--[no]experimental_convenience_symlinks
predeterminado: "normal"-
Esta marca controla cómo se administrarán los symlinks de conveniencia (los symlinks 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.
clean: Se borrarán todos los symlinks sin condiciones.
ignore: Los symlinks no se modificarán.
log_only: Genera mensajes de registro como si se pasara "normal", pero no realiza ninguna operación de sistema de archivos (útil para herramientas).
Ten en cuenta que solo se pueden ver afectados los symlinks cuyos nombres genera el valor actual de --symlink_prefix. Si cambia el prefijo, no se modificarán los symlinks preexistentes.
Etiquetas:affects_outputs
--[no]experimental_convenience_symlinks_bep_event
predeterminado: “false”-
Esta marca controla si publicaremos o no el evento de compilación ConvenienceSymlinksIdentified en BuildEventProtocol. Si el valor es verdadero, BuildEventProtocol tendrá una entrada para convenienceSymlinksIdentified, en la que se enumerarán todos los symlinks de conveniencia creados en tu lugar de trabajo. Si es falso, la entrada convenienceSymlinksIdentified en BuildEventProtocol estará vacía.
Etiquetas:affects_outputs
--remote_download_all
-
Descarga todos los resultados remotos en la máquina local. Esta marca es un alias para --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 a la máquina local. Esta marca es un alias para --remote_download_outputs=minimal.
Se expande a:
--remote_download_outputs=minimal
Etiquetas:affects_outputs
--remote_download_outputs=<all, minimal or toplevel>
predeterminado: "toplevel"-
Si se establece en "minimal", no se descargan resultados de compilación remotas en la máquina local, excepto los que requieren las acciones locales. Si se establece en "toplevel", se comporta como "minimal", excepto que también descarga los resultados de los destinos de nivel superior en la máquina local. Ambas opciones pueden reducir significativamente los tiempos de compilación si el ancho de banda de la red es un cuello de botella.
Etiquetas:affects_outputs
--remote_download_symlink_template=<a string>
predeterminado: ""-
En lugar de descargar resultados de compilación remotos en la máquina local, crea vínculos simbólicos. El destino de los vínculos simbólicos se puede especificar en forma de una cadena de plantilla. Esta cadena de plantilla puede contener {hash} y {size_bytes} que se expanden al hash del objeto y al tamaño en bytes, respectivamente. Estos vínculos simbólicos pueden, por ejemplo, apuntar a un sistema de archivos FUSE que cargue objetos del CAS a pedido.
Etiquetas:affects_outputs
--remote_download_toplevel
- Solo descarga resultados remotos de destinos de nivel superior en la máquina local. Esta marca es un alias para --remote_download_outputs=toplevel.
Se expande a:
--remote_download_outputs=toplevel
Etiquetas:affects_outputs
--symlink_prefix=<a string>
predeterminado: Consulta la descripción-
Es el prefijo que se agrega a cualquiera de los symlinks de conveniencia que se crean después de una compilación. Si se omite, el valor predeterminado es el nombre de la herramienta de compilación seguido de un guion. Si se pasa “/”, no se crean symlinks ni se emite ninguna advertencia. Advertencia: La funcionalidad especial para "/" dejará de estar disponible pronto. En su lugar, usa --experimental_convenience_symlinks=ignore.
Etiquetas:affects_outputs
- Opciones que afectan la rigurosidad con la que Bazel aplica entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
--[no]experimental_docker_privileged
predeterminado: “false”-
Si está habilitada, Bazel pasará la marca --privileged a "docker run" cuando ejecute acciones. Es posible que tu compilación lo requiera, pero también podría reducir la hermeticidad.
Etiquetas:execution
--[no]experimental_sandboxfs_map_symlink_targets
predeterminado: “false”-
Etiquetas de operación sin efecto
:host_machine_resource_optimizations
,execution
--[no]incompatible_legacy_local_fallback
predeterminado: “false”-
Si se establece como verdadero, habilita el resguardo implícito heredado de la estrategia de zona de pruebas a la estrategia local. Con el tiempo, esta marca se establecerá de forma predeterminada como falsa y, luego, se convertirá en una no operación. En su lugar, usa --strategy, --spawn_strategy o --dynamic_local_strategy para configurar los resguardos.
Etiquetas:execution
,incompatible_change
- Se acumulan varios usos de
--sandbox_add_mount_pair=<a single path or a 'source:target' pair>
. -
Agrega un par de rutas de acceso adicionales para activar en la zona de pruebas.
Etiquetas:execution
- Se acumulan varios usos de
--sandbox_block_path=<a string>
. -
Para las acciones en zona de pruebas, no permitas el acceso a esta ruta.
Etiquetas:execution
--[no]sandbox_default_allow_network
predeterminado: "true"-
Permite el acceso a la red de forma predeterminada para las acciones. Es posible que esto no funcione con todas las implementaciones de zona de pruebas.
Etiquetas:execution
--[no]sandbox_fake_hostname
predeterminado: “false”-
Cambia el nombre de host actual a "localhost" para las acciones en zona de pruebas.
Etiquetas:execution
--[no]sandbox_fake_username
predeterminado: “false”-
Cambia el nombre de usuario actual a "nadie" para las acciones en zona de pruebas.
Etiquetas:execution
- Se acumulan varios usos de
--sandbox_writable_path=<a string>
. -
Para las acciones en la zona de pruebas, crea un directorio existente en el que se pueda escribir en la zona de pruebas (si la implementación de la zona de pruebas lo admite, se ignora de lo contrario).
Etiquetas:execution
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility
predeterminado: “false”-
Si incompatible_enforce_config_setting_visibility=false, esto es una operación no realizada. De lo contrario, si esta marca es falsa, cualquier config_setting sin un atributo de visibilidad explícito es //visibility:public. Si esta marca es verdadera, config_setting sigue la misma lógica de visibilidad que todas las demás reglas. Consulta https://github.com/bazelbuild/bazel/issues/12933.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
predeterminado: "true"-
Si es verdadero, aplica las restricciones de visibilidad de config_setting. Si es falso, todos los config_setting son visibles para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones que rigen el comportamiento del entorno de prueba o del ejecutor de pruebas:
--[no]check_tests_up_to_date
predeterminado: “false”-
No ejecutes pruebas, solo verifica si están actualizadas. Si todos los resultados de las pruebas están actualizados, la prueba se completa correctamente. Si se debe compilar o ejecutar alguna prueba, se informa un error y la prueba falla. Esta opción implica el comportamiento de --check_up_to_date.
Etiquetas:execution
- Se acumulan varios usos de
--flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once>
. -
Cada prueba se reintentará hasta la cantidad especificada de veces en caso de que falle. Las pruebas que requirieron más de un intento para aprobar se marcan como "FLAKY" en el resumen de la prueba. Por lo general, el valor especificado es solo un número entero o la cadena "default". Si es un número entero, todas las pruebas se ejecutarán hasta N veces. Si es "default", solo se realizará un intento de prueba para las pruebas normales y tres para las pruebas marcadas explícitamente como inestables por su regla (atributo flaky=1). Sintaxis alternativa: regex_filter@flaky_test_attempts. En el que flaky_test_attempts es como se indicó anteriormente y regex_filter representa una lista de patrones de expresiones regulares para incluir y excluir (consulta también --runs_per_test). Ejemplo: --flaky_test_attempts=//foo/.*,-//foo/bar/.*@3 corrige todas las pruebas en //foo/, excepto las de foo/bar, tres veces. Esta opción se puede pasar varias veces. El argumento pasado más recientemente que coincida tiene prioridad. Si no hay coincidencias, el comportamiento es como el de "default" anterior.
Etiquetas:execution
--local_test_jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
predeterminado: “auto”-
Es la cantidad máxima de trabajos de prueba locales que se ejecutarán 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 de forma simultánea. Establecer este valor por encima del valor de --jobs no es eficaz.
Etiquetas:execution
--[no]test_keep_going
predeterminado: "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
--test_strategy=<a string>
predeterminado: ""-
Especifica qué estrategia usar cuando se ejecutan pruebas.
Etiquetas:execution
--test_tmpdir=<a path>
predeterminado: Consulta la descripción- Especifica el directorio temporal base que usará "bazel test".
- Opciones relacionadas con el resultado y la semántica de la consulta:
--[no]experimental_parallel_aquery_output
predeterminado: "true"- Sin operación.
- Opciones relacionadas con la salida y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
. -
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitadas en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "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 un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
predeterminado: “update”- especifica cómo usar el archivo de bloqueo y si se debe usar o no. 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 mostrar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
. - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso proporcionada es una ruta de acceso absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta de acceso relativa, se hará referencia al directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace".
- Se acumulan varios usos de
--registry=<a string>
. -
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los anteriores.
Etiquetas:changes_inputs
- Opciones que activan optimizaciones del tiempo de compilación:
--experimental_dynamic_ignore_local_signals=<a comma-separated list of signal numbers>
predeterminado: Consulta la descripción-
Toma una lista de números de indicadores del SO. Si se cancela una rama local de ejecución dinámica con cualquiera de estos indicadores, la rama remota podrá finalizar. En el caso de los trabajadores persistentes, esto solo afecta a los indicadores que finalizan el proceso del 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 haga que Bazel falle con un error de OOM. Cada límite se especifica como <period>:<count>, en el que period es una duración y count es un número entero positivo. Si más del porcentaje --gc_thrashing_threshold del espacio a perpetuidad (heap de generación anterior) permanece ocupado después de <count> GC completas consecutivas en <period>, se activa un error de OOM. Se pueden especificar varios límites separados por comas.
Etiquetas:host_machine_resource_optimizations
--local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>
predeterminado: "HOST_CPUS"-
Establece de forma explícita la cantidad total de núcleos de CPU locales disponibles para que Bazel los destine a las acciones de compilación que se ejecutan de forma local. Toma un número entero o "HOST_CPUS", seguido de forma opcional por [-|*]<float> (p. ej., HOST_CPUS*.5 para usar la mitad de los núcleos de CPU disponibles).De forma predeterminada ("HOST_CPUS"), Bazel consultará la configuración del sistema para estimar la cantidad de núcleos de CPU disponibles.
Etiquetas:host_machine_resource_optimizations
- Se acumulan varios usos de
--local_extra_resources=<a named float, 'name=value'>
. -
Establece la cantidad de recursos adicionales disponibles para Bazel. Recibe un par de cadena-número de punto flotante. Se puede usar varias veces para especificar varios tipos de recursos adicionales. Bazel limitará las acciones que se ejecutan de forma simultánea según los recursos adicionales disponibles y los recursos adicionales necesarios. Las pruebas pueden declarar la cantidad de recursos adicionales que necesitan con una etiqueta del formato "resources:<nombre_recurso>:<cantidad>". No se pueden establecer la CPU, la RAM ni los recursos disponibles con esta marca.
Etiquetas:host_machine_resource_optimizations
--local_ram_resources=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
predeterminado: "HOST_RAM*.67"-
Establece de forma explícita la cantidad total de RAM del host local (en MB) disponible para que Bazel la invierta en acciones de compilación que se ejecuten de forma local. Toma un número entero o "HOST_RAM", seguido de forma opcional por [-|*]<float> (p. ej., HOST_RAM*.5 para usar la mitad de la RAM disponible). De forma predeterminada ("HOST_RAM*.67"), Bazel consultará la configuración del sistema para estimar la cantidad de RAM disponible y usará el 67%.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Es una marca para la configuración avanzada del motor Skyframe interno 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 GC completo, se descartará el estado temporal innecesario de Skyframe hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC completos nunca activarán las bajadas. 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"-
Es una marca para la configuración avanzada del motor Skyframe interno 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 GC menor, se descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC menores nunca activarán las bajadas. 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
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es de al menos este límite, descartará el estado temporal innecesario de Skyframe. Si ajustas este parámetro, es posible que puedas mitigar el impacto del tiempo de ejecución de la fragmentación de GC, cuando esta se produce (i) por el uso de memoria de este estado temporal y (ii) es más costoso 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:
--[no]debug_spawn_scheduler
predeterminado: “false”--[no]experimental_bep_target_summary
predeterminado: “false”- Determina si se deben publicar eventos TargetSummary.
--[no]experimental_build_event_expand_filesets
predeterminado: “false”-
Si es verdadero, expande los conjuntos de archivos en el BEP cuando se presenten los archivos de salida.
Etiquetas:affects_outputs
--[no]experimental_build_event_fully_resolve_fileset_symlinks
predeterminado: “false”-
Si es verdadero, resuelve completamente los symlinks de conjuntos de archivos relativos en el BEP cuando se presentan archivos de salida. Requiere --experimental_build_event_expand_filesets.
Etiquetas:affects_outputs
--experimental_build_event_upload_max_retries=<an integer>
predeterminado: “4”-
Es la cantidad máxima de veces que Bazel debe volver a intentar subir un evento de compilación.
Etiquetas:bazel_internal_configuration
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
predeterminado: "1s"-
Retraso inicial mínimo para los reintentos de retirada exponencial cuando falla la carga de BEP. (exponente: 1.6)
Etiquetas:bazel_internal_configuration
--experimental_build_event_upload_strategy=<a string>
predeterminado: Consulta la descripción-
Selecciona cómo subir artefactos a los que se hace referencia en el protocolo del evento de compilación.
Etiquetas:affects_outputs
--[no]experimental_collect_local_sandbox_action_metrics
predeterminado: "true"-
Operación sin efecto obsoleta.
Etiquetas:execution
--[no]experimental_command_profile
predeterminado: “false”- Graba un perfil de CPU de Java Flight Recorder en un archivo profile.jfr en el directorio base de salida. La sintaxis y la semántica de esta marca pueden cambiar en el futuro para admitir diferentes tipos de perfiles o formatos de salida. Úsala bajo tu propio riesgo.
--[no]experimental_docker_verbose
predeterminado: “false”-
Si se habilita, Bazel imprimirá mensajes más detallados sobre la estrategia de zona de pruebas de Docker.
Etiquetas:execution
--[no]experimental_materialize_param_files_directly
predeterminado: “false”-
Si materializas archivos de parámetros, hazlo con operaciones de escritura directa en el disco.
Etiquetas:execution
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
--experimental_repository_resolved_file=<a string>
predeterminado: ""-
Si no está vacío, escribe un valor de Starlark con la información resuelta de todas las reglas del repositorio de Starlark que se ejecutaron.
Etiquetas:affects_outputs
--[no]experimental_run_bep_event_include_residue
predeterminado: “false”-
Indica si se debe incluir el residuo de la línea de comandos en los eventos de compilación de ejecución que podrían contener el residuo. De forma predeterminada, el residuo no se incluye en los eventos de compilación del comando de ejecución que podrían contenerlo.
Etiquetas:affects_outputs
--[no]experimental_stream_log_file_uploads
predeterminado: “false”-
El archivo de registro de transmisión se sube directamente al almacenamiento remoto en lugar de escribirlo en el disco.
Etiquetas:affects_outputs
--explain=<a path>
predeterminado: Consulta la descripción-
Hace que el sistema de compilación explique cada paso ejecutado de la compilación. La explicación se escribe en el archivo de registro especificado.
Etiquetas:affects_outputs
--[no]ignore_unsupported_sandboxing
predeterminado: “false”-
No imprime una advertencia cuando la ejecución en zona de pruebas no es compatible con este sistema.
Etiquetas:terminal_output
--[no]legacy_important_outputs
predeterminado: "true"-
Usa esto para suprimir la generación del campo important_outputs heredado en el evento TargetComplete. important_outputs es obligatorio para la integración de Bazel en ResultStore.
Etiquetas:affects_outputs
--[no]materialize_param_files
predeterminado: “false”-
Escribe archivos de parámetros intermedios en el árbol de salida, incluso cuando se usa la ejecución de acciones remotas. Es útil cuando se depuran acciones. Esto se infiere de --subcommands y --verbose_failures.
Etiquetas:execution
--max_config_changes_to_show=<an integer>
predeterminado: “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 que se proporciona es -1, se mostrarán todas las opciones cambiadas.
Etiquetas:terminal_output
--max_test_output_bytes=<an integer>
predeterminado: “-1”-
Especifica el tamaño máximo de registro por prueba que se puede emitir cuando --test_output es "errors" o "all". Es útil para evitar que el resultado se vea abrumado por un resultado de prueba con demasiado ruido. El encabezado de prueba se incluye en el tamaño del registro. Los valores negativos implican que no hay límite. El resultado es todo o nada.
Etiquetas:test_runner
,terminal_output
,execution
--output_filter=<a valid Java regular expression>
predeterminado: Consulta la descripción-
Solo muestra advertencias y resultados de acciones para reglas con un nombre que coincida con la expresión regular proporcionada.
Etiquetas:affects_outputs
--progress_report_interval=<an integer in 0-3600 range>
predeterminado: “0”-
Es la cantidad de segundos que se debe esperar entre los informes de las tareas que aún se están ejecutando. El valor predeterminado 0 significa que el primer informe se imprimirá después de 10 segundos, luego de 30 segundos y, después de ese progreso, se informará una vez por minuto. Cuando se habilita --curses, el progreso se informa cada segundo.
Etiquetas:affects_outputs
- Valor predeterminado de
--remote_print_execution_messages=<failure, success or all>
: “failure” -
Elige cuándo imprimir los mensajes de ejecución remota. Los valores válidos son "failure" para imprimir solo en caso de fallas, "success" para imprimir solo en caso de éxitos y "all" para imprimir siempre.
Etiquetas:terminal_output
--[no]sandbox_debug
predeterminado: “false”-
Habilita las funciones de depuración para la función de zona de pruebas. Esto incluye dos aspectos: primero, el contenido raíz de la zona de pruebas no se modifica después de una compilación y, segundo, imprime información de depuración adicional durante la ejecución. Esto puede ayudar a los desarrolladores de reglas de Bazel o Starlark con fallas de depuración debido a la falta de archivos de entrada, etcétera.
Etiquetas:terminal_output
--show_result=<an integer>
predeterminado: “1”-
Muestra los resultados de la compilación. Para cada objetivo, indica si se actualizó o no y, de ser así, una lista de los archivos de salida que se compilaron. Los archivos impresos son cadenas convenientes para copiar y pegar en la shell y ejecutarlas.
Esta opción requiere un argumento de número entero, que es la cantidad de objetivos de umbral por encima de la cual no se imprime la información de los resultados. Por lo tanto, cero causa la supresión del mensaje y MAX_INT hace que la impresión del resultado siempre se produzca. El valor predeterminado es uno.
Si no se compiló nada para un destino, se pueden omitir sus resultados para mantener el resultado por debajo del umbral.
Etiquetas:affects_outputs
--[no]subcommands
[-s
] predeterminado: "false"-
Muestra los subcomandos ejecutados 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 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 la prueba, "errors" para imprimir también los registros de prueba de las pruebas fallidas, "all" para imprimir los registros de todas las pruebas y "streamed" para mostrar los registros de todas las pruebas en tiempo real (esto forzará que las pruebas se ejecuten de forma local de a una a la vez, independientemente del valor de --test_strategy).
Etiquetas:test_runner
,terminal_output
,execution
- Valor predeterminado de
--test_summary=<short, terse, detailed, none or testcase>
: “short” - : Especifica el formato deseado del resumen de la prueba. Los valores válidos son "short" para imprimir información solo sobre las pruebas ejecutadas, "terse" para imprimir información solo sobre las pruebas que no se ejecutaron correctamente, "detailed" para imprimir información detallada sobre los 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 "none" para omitir el resumen.
Etiquetas:terminal_output
--[no]verbose_explanations
predeterminado: “false”-
Aumenta el nivel de detalle de las explicaciones emitidas si se habilita --explain. No tiene efecto si no se habilita --explain.
Etiquetas:affects_outputs
--[no]verbose_failures
predeterminado: “false”-
Si un comando falla, imprime la línea de comandos completa.
Etiquetas:terminal_output
- Son opciones que especifican o alteran una entrada genérica en un comando de Bazel que no pertenece a otras categorías.:
- Se acumulan varios usos de
--aspects_parameters=<a 'name=value' assignment>
. -
Especifica los valores de los parámetros de aspectos de la línea de comandos. Cada valor de parámetro se especifica mediante <param_name>=<param_value>, por ejemplo, "my_param=my_val", en la que "my_param" es un parámetro de algún aspecto en la lista --aspects o que es obligatorio para 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
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
--target_pattern_file=<a string>
predeterminado: ""-
Si se establece, la compilación leerá patrones del archivo que se nombra aquí, en lugar de la línea de comandos. Es un error especificar un archivo aquí, así como patrones de línea de comandos.
Etiquetas:changes_inputs
- Opciones de almacenamiento en caché y ejecución remotas:
--experimental_circuit_breaker_strategy=<failure>
predeterminado: Consulta la descripción- especifica la estrategia que debe usar el disyuntor. Las estrategias disponibles son "error". Si el valor de la opción no es válido, no se establece el mismo comportamiento que la opción.
Etiquetas:execution
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite"), seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
--[no]experimental_guard_against_concurrent_changes
predeterminado: “false”- Desactiva esta opción para inhabilitar la verificación del ctime 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 generar falsos positivos.
--[no]experimental_remote_cache_async
predeterminado: “false”- Si es verdadero, las operaciones de E/S de caché remota se realizarán en segundo plano en lugar de hacerlo como parte de un inicio.
--experimental_remote_cache_eviction_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos que se pueden 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 verdadero. Se generará un ID de invocación nuevo para cada intento. Si generas un ID de invocación y se lo proporcionas a Bazel con --invocation_id, no debes usar esta marca. En su lugar, establece la marca --incompatible_remote_use_new_exit_code_for_lost_inputs y busca el código de salida 39.
Etiquetas:execution
--[no]experimental_remote_cache_lease_extension
predeterminado: “false”- Si se establece como verdadero, Bazel extenderá el arrendamiento de los resultados de las acciones remotas durante la compilación enviando llamadas a "FindMissingBlobs" periódicamente 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.>
predeterminado: "3h"-
Es el TTL mínimo garantizado de los blobs en la caché remota después de que se hace referencia a sus resúmenes recientemente, p.ej., por un ActionResult o FindMissingBlobs. Bazel realiza varias optimizaciones en función del TTL de los blobs, p.ej., no llama repetidamente a GetActionResult en una compilación incremental. El valor debe establecerse un poco por debajo del TTL real, ya que hay una brecha entre el momento en que el servidor muestra los resúmenes y el momento en que Bazel los recibe.
Etiquetas:execution
--experimental_remote_capture_corrupted_outputs=<a path>
predeterminado: Consulta la descripción- Es una ruta de acceso a un directorio en el que se capturarán los resultados dañados.
--[no]experimental_remote_discard_merkle_trees
predeterminado: “false”- Si se establece en verdadero, se descartan las copias en memoria del árbol de Merkle de la raíz de entrada y las asignaciones de entrada asociadas durante las llamadas a GetActionResult() y Execute(). Esto reduce significativamente el uso de memoria, pero requiere que Bazel vuelva a calcularlas cuando se pierda la caché remota y se vuelvan a intentar.
--experimental_remote_downloader=<a string>
predeterminado: Consulta la descripción- Es un URI de extremo de la API de Remote Asset que se usará como proxy de descarga remoto. Los esquemas admitidos son grpc, grpcs (grpc con TLS habilitado) y unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel usará grpcs de forma predeterminada. Consulta: https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto
--[no]experimental_remote_downloader_local_fallback
predeterminado: “false”- Indica si se debe recurrir al descargador local si falla el descargador remoto.
--[no]experimental_remote_execution_keepalive
predeterminado: “false”- Indica si se debe usar el mantenimiento de la conexión para las llamadas de ejecución remotas.
--experimental_remote_failure_rate_threshold=<an integer in 0-100 range>
predeterminado: "10"-
Establece la cantidad permitida de porcentaje de fallas para un período específico, después del cual deja de llamar a la caché o al ejecutor remotos. De forma predeterminada, el valor es 10. Si lo estableces en 0, no habrá limitaciones.
Etiquetas:execution
--experimental_remote_failure_window_interval=<An immutable length of time.>
predeterminado: "60s"-
Es el intervalo en el que se calcula la tasa de fallas de las solicitudes remotas. Si el valor es cero o negativo, la duración de la falla se calcula durante toda la ejecución.Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
Etiquetas:execution
--[no]experimental_remote_mark_tool_inputs
predeterminado: “false”- Si se establece como verdadero, Bazel marcará las entradas como entradas de herramientas para el ejecutor remoto. Esto se puede usar para implementar trabajadores persistentes remotos.
--[no]experimental_remote_merkle_tree_cache
predeterminado: “false”- Si se establece como verdadero, los cálculos del árbol de Merkle se almacenarán en caché para mejorar la velocidad de verificación de hits de caché remotos. El espacio en memoria de la caché se controla con --experimental_remote_merkle_tree_cache_size.
--experimental_remote_merkle_tree_cache_size=<a long integer>
predeterminado: “1000”- Es la cantidad de árboles de Merkle que se deben almacenar en caché para mejorar la velocidad de verificación de aciertos de caché remotos. Aunque la caché se poda automáticamente según el manejo de referencias suaves de Java, pueden ocurrir errores de falta de memoria si se establece demasiado alta. Si se establece en 0, el tamaño de la caché es ilimitado. El valor óptimo varía según el tamaño del proyecto. El valor predeterminado es 1,000.
--[no]experimental_remote_require_cached
predeterminado: “false”- Si se establece como verdadero, se aplica la directiva de que todas las acciones que se pueden ejecutar de forma remota se almacenen en caché, o bien se producirá un error en la compilación. Esto es útil para solucionar problemas de no determinismo, ya que permite verificar si las acciones que deberían almacenarse en caché realmente se almacenan en caché sin insertar resultados nuevos de forma falsa en la caché.
--experimental_remote_scrubbing_config=<Converts to a Scrubber>
predeterminado: Consulta la descripción- Habilita la limpieza de claves de caché remotas con el archivo de configuración proporcionado, que debe ser un búfer de protocolo de ScrubbingConfig en formato de texto. El objetivo de esta función es facilitar el uso compartido de una caché remota o en el disco entre acciones que se ejecutan en diferentes plataformas, pero que se orientan a la misma plataforma. Se debe usar con mucho cuidado, ya que una configuración incorrecta puede provocar el uso compartido accidental de entradas de caché y generar compilaciones incorrectas. La limpieza no afecta la forma en que se ejecuta una acción, solo la forma en que se calcula su clave de caché remota o en el disco para recuperar o almacenar un resultado de acción. No se puede usar junto con la ejecución remota. Modificar la configuración de limpieza no invalida los resultados presentes en el sistema de archivos local o las cachés internas. Se requiere una compilación limpia para volver a ejecutar las acciones afectadas. Para usar esta función correctamente, es probable que debas establecer un --host_platform personalizado junto con --experimental_platform_in_output_dir (para normalizar los prefijos de salida) y --incompatible_strict_action_env (para normalizar las variables de entorno).
--experimental_worker_for_repo_fetching=<off, platform or virtual>
predeterminado: "off"- Es el modo de subprocesos que se usará para recuperar el repo. Si se establece en "desactivado", no se usa ningún subproceso de trabajo y la recuperación del repo está sujeta a reinicios. De lo contrario, usa un subproceso de plataforma (es decir, un subproceso del SO) si se establece en "platform" o un subproceso virtual si se establece en "virtual".
--[no]incompatible_remote_build_event_upload_respect_no_cache
predeterminado: “false”- Obsoleto. No realiza ninguna acción. En su lugar, usa --remote_build_event_upload=minimal.
--[no]incompatible_remote_downloader_send_all_headers
predeterminado: "true"-
Indica si se deben enviar todos los valores de un encabezado con varios valores al descargador remoto en lugar de solo el primero.
Etiquetas:incompatible_change
--[no]incompatible_remote_output_paths_relative_to_input_root
predeterminado: “false”-
Si se establece como verdadero, las rutas de acceso de salida son relativas a la raíz de entrada en lugar del directorio de trabajo.
Etiquetas:incompatible_change
--[no]incompatible_remote_results_ignore_disk
predeterminado: "true"-
Etiquetas
sin operación:incompatible_change
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
predeterminado: "true"-
Si se establece como verdadero, Bazel usará el nuevo código de salida 39 en lugar de 34 si la caché remota desaloja blobs durante la compilación.
Etiquetas:incompatible_change
--[no]remote_accept_cached
predeterminado: "true"- Indica si se aceptan los resultados de las acciones almacenadas en caché de forma remota.
--remote_build_event_upload=<all or minimal>
predeterminado: "minimal"- Si se establece en “todos”, todos los resultados locales a los que hace referencia BEP se suben a la caché remota. Si se establece en "minimal", los resultados locales a los que hace referencia BEP no se suben a la caché remota, excepto los archivos que son importantes para los consumidores de BEP (p.ej., registros de prueba y perfil de tiempo). El esquema bytestream:// siempre se usa para el URI de los archivos, incluso si no están en la caché remota. El valor predeterminado es "minimal".
--remote_bytestream_uri_prefix=<a string>
predeterminado: Consulta la descripción- Es el nombre de host y el nombre de la instancia que se usarán en los URIs bytestream:// que se escriben en los flujos de eventos de compilación. Esta opción se puede establecer cuando las compilaciones se realizan con un proxy, lo que hace que los valores de --remote_executor y --remote_instance_name ya no correspondan al nombre canónico del servicio de ejecución remota. Si no se establece, el valor predeterminado será “${hostname}/${instance_name}”.
--remote_cache=<a string>
predeterminado: Consulta la descripción- Es 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
--[no]remote_cache_compression
predeterminado: “false”- Si está habilitado, comprime o descomprime los blobs de caché con zstd.
- Se acumulan varios usos de
--remote_cache_header=<a 'name=value' assignment>
. - Especifica un encabezado que se incluirá en las solicitudes de caché: --remote_cache_header=Nombre=Valor. Se pueden pasar varios encabezados si especificas la marca varias veces. Los múltiples valores para el mismo nombre se convertirán en una lista separada por comas.
- Se acumulan varios usos de
--remote_default_exec_properties=<a 'name=value' assignment>
. -
Establece las propiedades de ejecución predeterminadas que se usarán como la plataforma de ejecución remota si una plataforma de ejecución aún no establece exec_properties.
Etiquetas:affects_outputs
--remote_default_platform_properties=<a string>
predeterminado: ""- 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 establece remote_execution_properties. Este valor también se usará si se selecciona la plataforma host como la plataforma de ejecución para la ejecución remota.
- Se acumulan varios usos de
--remote_download_regex=<a string>
. -
Forzar a Bazel a descargar los artefactos que coincidan con la regex proporcionada. Se usa junto con Build sin los bytes (o el equivalente interno) para permitir que el cliente solicite ciertos artefactos que podrían ser necesarios de forma local (p.ej., compatibilidad con IDE). Se pueden especificar varias regex repitiendo esta marca.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--remote_downloader_header=<a 'name=value' assignment>
. - Especifica un encabezado que se incluirá en las solicitudes del descargador remoto: --remote_downloader_header=Nombre=Valor. Se pueden pasar varios encabezados si especificas la marca varias veces. Los múltiples valores para el mismo nombre se convertirán en una lista separada por comas.
- Se acumulan varios usos de
--remote_exec_header=<a 'name=value' assignment>
. - Especifica un encabezado que se incluirá en las solicitudes de ejecución: --remote_exec_header=Nombre=Valor. Se pueden pasar varios encabezados si especificas la marca varias veces. Los múltiples valores para el mismo nombre se convertirán en una lista separada por comas.
--remote_execution_priority=<an integer>
predeterminado: “0”- Es la prioridad relativa de las acciones que se ejecutarán de forma remota. La semántica de los valores de prioridad particulares depende del servidor.
--remote_executor=<a string>
predeterminado: Consulta la descripción- HOST o HOST:PORT de un extremo de ejecución remota. Los esquemas admitidos son grpc, grpcs (grpc con TLS habilitado) y unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel usará grpcs de forma predeterminada. Especifica el esquema grpc:// o unix: para inhabilitar TLS.
--remote_grpc_log=<a path>
predeterminado: Consulta la descripción- Si se especifica, es una ruta de acceso a un archivo para registrar los detalles relacionados con las llamadas de gRPC. Este registro consta de una secuencia de protobufs com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry serializados con cada mensaje con un prefijo de varint que indica el tamaño del siguiente mensaje de protobuf serializado, como lo realiza el método LogEntry.writeDelimitedTo(OutputStream).
- Se acumulan varios usos de
--remote_header=<a 'name=value' assignment>
. - Especifica un encabezado que se incluirá en las solicitudes: --remote_header=Nombre=Valor. Se pueden pasar varios encabezados si especificas la marca varias veces. Los múltiples valores para el mismo nombre se convertirán en una lista separada por comas.
--remote_instance_name=<a string>
predeterminado: ""- Es el valor que se pasa como instance_name en la API de ejecución remota.
--[no]remote_local_fallback
predeterminado: “false”- Determina si se debe recurrir a la estrategia de ejecución local independiente si falla la ejecución remota.
- Valor predeterminado de
--remote_local_fallback_strategy=<a string>
: “local” - No realiza ninguna acción, está obsoleto. Consulta https://github.com/bazelbuild/bazel/issues/7480 para obtener más información.
--remote_max_connections=<an integer>
predeterminado: "100"-
Limita la cantidad máxima de conexiones simultáneas a la caché o al ejecutor remotos. De forma predeterminada, el valor es 100. Si lo estableces en 0, no habrá limitaciones.
Para la caché remota HTTP, una conexión TCP podría controlar una solicitud a la vez, por lo que Bazel podría realizar hasta --remote_max_connections solicitudes simultáneas.
En el caso de la caché o el ejecutor remotos de gRPC, un canal de gRPC suele poder controlar más de 100 solicitudes simultáneas, por lo que Bazel podría realizar alrededor de `--remote_max_connections * 100` solicitudes simultáneas.
Etiquetas:host_machine_resource_optimizations
--remote_proxy=<a string>
predeterminado: Consulta la descripción- Conéctate a la caché remota a través de un proxy. Actualmente, esta marca solo se puede usar para configurar un socket de dominio Unix (unix:/path/to/socket).
--remote_result_cache_priority=<an integer>
predeterminado: “0”- Es la prioridad relativa de las acciones remotas que se almacenarán en la caché remota. La semántica de los valores de prioridad particulares depende del servidor.
--remote_retries=<an integer>
predeterminado: “5”- Es la cantidad máxima de intentos para reintentar un error transitorio. Si se establece en 0, se inhabilitan los reintentos.
--remote_retry_max_delay=<An immutable length of time.>
predeterminado: "5s"- Es la demora máxima de la retirada entre los intentos de reintento remotos. Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
--remote_timeout=<An immutable length of time.>
predeterminado: "60s"- Es la cantidad máxima de tiempo que se espera para la ejecución remota y las llamadas a la caché. Para la caché de REST, este es el tiempo de espera de conexión y de lectura. Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
--[no]remote_upload_local_results
predeterminado: "true"- Determina si se deben subir los resultados de las acciones ejecutadas de forma local a la caché remota si esta la admite y el usuario está autorizado para hacerlo.
--[no]remote_verify_downloads
predeterminado: "true"- Si se establece como verdadero, Bazel calculará la suma de hash de todas las descargas remotas y descartará los valores almacenados en caché de forma remota si no coinciden con el valor esperado.
- Opciones misceláneas que no se clasifican de otra manera:
--[no]allow_analysis_cache_discard
predeterminado: "true"-
Si se descarta la caché de análisis debido a un cambio en el sistema de compilación, configurar esta opción como falsa hará que bazel se cierre, en lugar de continuar con la compilación. Esta opción no tiene efecto cuando también se establece "discard_analysis_cache".
Etiquetas:eagerness_to_exit
- Valor predeterminado de
--auto_output_filter=<none, all, packages or subpackages>
: “none” - Si no se especifica --output_filter, se usa el valor de esta opción para crear un filtro automáticamente. Los valores permitidos son "none" (no filtrar nada o mostrar todo), "all" (filtrar todo o no mostrar nada), "packages" (incluye el resultado de las reglas en los paquetes mencionados en la línea de comandos de Blaze) y "subpackages" (como "packages", pero también incluye subpaquetes). Para los valores "packages" y "subpackages", //java/foo y //javatests/foo se tratan como un solo paquete).
--[no]build_manual_tests
predeterminado: “false”- Forza la compilación de los destinos de prueba etiquetados como "manual". Las pruebas "manuales" se excluyen del procesamiento. Esta opción los obliga a compilarse (pero no a ejecutarse).
--build_tag_filters=<comma-separated list of options>
predeterminado: ""- Especifica una lista de etiquetas separadas por comas. De manera opcional, cada etiqueta puede ir precedida de "-" para especificar las etiquetas excluidas. Solo se compilarán los destinos que contengan al menos una etiqueta incluida y no contengan ninguna etiqueta excluida. Esta opción no afecta el conjunto de pruebas que se ejecutan con el comando "test", ya que se rigen por las opciones de filtrado de pruebas, por ejemplo, "--test_tag_filters".
--[no]build_tests_only
predeterminado: “false”- Si se especifica, solo se compilarán las reglas *_test y test_suite, y se ignorarán los otros objetivos 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>
: “none” - Especifica el tipo de informe de cobertura acumulativa deseado. En este momento, solo se admite LCOV.
--[no]compile_one_dependency
predeterminado: “false”- Compila una sola dependencia de los archivos de argumentos. Esto es útil para verificar la sintaxis de los archivos fuente en IDEs, por ejemplo, cuando se vuelve a compilar un solo destino que depende del archivo fuente para detectar errores lo antes posible en el ciclo de edición, compilación y prueba. Este argumento afecta la forma en que se interpretan todos los argumentos que no son de marca. En lugar de ser objetivos para compilar, son nombres de archivos de origen. Para cada nombre de archivo de origen, se compilará un destino arbitrario que depende de él.
- Se acumulan varios usos de
--deleted_packages=<comma-separated list of package names>
. - Es una lista separada por comas de nombres de paquetes que el sistema de compilación considerará inexistentes, incluso si son visibles en algún lugar de la ruta de acceso del paquete. Usa esta opción cuando borres un subpaquete "x/y" de un paquete existente "x". Por ejemplo, después de borrar x/y/BUILD en tu cliente, es posible que el sistema de compilación se queje si encuentra una etiqueta "//x:y/z" si otra entrada de package_path aún la proporciona. Especificar --deleted_packages x/y evita este problema.
--[no]discard_analysis_cache
predeterminado: “false”- Descarta la caché de análisis inmediatamente después de que se complete la fase de análisis. Reduce el uso de memoria en un 10% aproximadamente, pero ralentiza las compilaciones incrementales posteriores.
--disk_cache=<a path>
predeterminado: Consulta la descripción- Es 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á.
--embed_label=<a one-line string>
predeterminado: ""- Incorpora la revisión o la etiqueta de lanzamiento del control de código fuente en el objeto binario.
--execution_log_binary_file=<a path>
predeterminado: Consulta la descripción- Registra los inicios ejecutados en este archivo como protos de inicio 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) y --subcommands (para mostrar subcomandos en el resultado de la terminal).
--execution_log_json_file=<a path>
predeterminado: Consulta la descripción- Registra los inicios ejecutados en este archivo como una representación JSON de los protos de inicio delimitados, según src/main/protobuf/spawn.proto. Marcas relacionadas: --execution_log_binary_file (formato protobuf binario; mutuamente excluyente), --execution_log_sort (si se debe ordenar el registro de ejecución) y --subcommands (para mostrar subcomandos en el resultado de la terminal).
--[no]execution_log_sort
predeterminado: "true"- Indica si se debe ordenar el registro de ejecución, lo que facilita la comparación de registros entre invocaciones. Se establece en "false" para evitar un uso potencialmente significativo de la CPU y la memoria al final de la invocación, a costa de producir el registro en orden de ejecución no determinista.
--[no]expand_test_suites
predeterminado: "true"-
Expande los objetivos de test_suite en sus pruebas constituyentes antes del análisis. Cuando esta marca esté activada (la opción predeterminada), se aplicarán patrones de destino negativos a las pruebas que pertenecen al paquete de pruebas; de lo contrario, no se aplicarán. Desactivar esta marca es útil cuando se aplican aspectos de nivel superior en la línea de comandos: luego, pueden analizar los destinos de test_suite.
Etiquetas:loading_and_analysis
--experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
predeterminado: ""- dejó de estar disponible y se reemplazó por aspectos. Filtra el conjunto de objetivos para los que se programarán las extra_actions.
--[no]experimental_extra_action_top_level_only
predeterminado: “false”- dejó de estar disponible y se reemplazó por aspectos. Solo programa extra_actions para los objetivos de nivel superior.
--experimental_spawn_scheduler
-
Ejecuta acciones de forma local y remota en paralelo para habilitar la ejecución dinámica. Bazel genera cada acción de forma local y remota, y elige la que se completa primero. Si una acción admite trabajadores, la acción local se ejecutará en el modo de trabajador persistente. Para habilitar la ejecución dinámica de una mnemotecnia de acción individual, usa las marcas `--internal_spawn_scheduler` y `--strategy=<mnemonic>=dynamic`.
Se expande a:
--internal_spawn_scheduler
--spawn_strategy=dynamic
--[no]incompatible_dont_use_javasourceinfoprovider
predeterminado: “false”-
Etiquetas
sin operación:incompatible_change
--local_termination_grace_seconds=<an integer>
predeterminado: “15”- Es el tiempo de espera entre la finalización de un proceso local debido al tiempo de espera y su cierre forzoso.
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
. - Anula un repositorio con una ruta de acceso local en el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es una ruta absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta relativa, se relaciona con el directorio de trabajo actual. Si la ruta de acceso determinada 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%"- Es una lista separada por dos puntos de dónde buscar paquetes. Los elementos que comienzan con "%workspace%" son relativos al lugar de trabajo que los contiene. Si se omite o está vacío, el valor predeterminado es el resultado de "bazel info default-package-path".
--[no]show_loading_progress
predeterminado: "true"- Si está habilitado, hace que Bazel imprima mensajes de "Carga del paquete:".
--test_lang_filters=<comma-separated list of options>
predeterminado: ""- Especifica una lista de idiomas de prueba separados por comas. De manera opcional, cada idioma puede ir precedido de “-” para especificar los idiomas excluidos. Solo se encontrarán los objetivos de prueba que estén escritos en los idiomas especificados. El nombre que se usa para cada idioma debe ser el mismo que el prefijo de idioma en la regla *_test, p.ej., uno de "cc", "java", "py", etc. Esta opción afecta el comportamiento de --build_tests_only y el comando test.
--test_size_filters=<comma-separated list of values: small, medium, large or enormous>
predeterminado: ""- Especifica una lista de tamaños de prueba separados por comas. De manera opcional, cada tamaño puede ir precedido de "-" para especificar los tamaños excluidos. Solo se encontrarán los objetivos de prueba que contengan al menos un tamaño incluido y no contengan ningún tamaño excluido. Esta opción afecta el comportamiento de --build_tests_only y el comando test.
--test_tag_filters=<comma-separated list of options>
predeterminado: ""- Especifica una lista de etiquetas de prueba separadas por comas. De manera opcional, cada etiqueta puede ir precedida de "-" para especificar las etiquetas excluidas. Solo se encontrarán los objetivos de prueba que contengan al menos una etiqueta incluida y no contengan ninguna etiqueta excluida. Esta opción afecta el comportamiento de --build_tests_only y el comando test.
--test_timeout_filters=<comma-separated list of values: short, moderate, long or eternal>
predeterminado: ""- Especifica una lista de tiempos de espera de prueba separados por comas. De manera opcional, cada tiempo de espera puede ir precedido de "-" para especificar los tiempos de espera excluidos. Solo se encontrarán los objetivos de prueba que contengan al menos un tiempo de espera incluido y no contengan tiempos de espera excluidos. Esta opción afecta el comportamiento de --build_tests_only y el comando test.
--workspace_status_command=<path>
predeterminado: ""- Es un comando que se invoca al comienzo de la compilación para proporcionar información de estado sobre el espacio de trabajo en forma de pares clave-valor. Consulta el manual del usuario para conocer las especificaciones completas. Consulta también tools/buildstamp/get_workspace_status para ver un ejemplo.
- Opciones que controlan la ejecución de la compilación:
--[no]check_up_to_date
predeterminado: “false”-
No realices la compilación, solo verifica si está actualizada. Si todos los destinos están actualizados, la compilación se completa correctamente. Si se debe ejecutar algún paso, se informa un error y falla la compilación.
Etiquetas:execution
--[no]experimental_inprocess_symlink_creation
predeterminado: “false”-
Determina si se deben realizar llamadas directas al sistema de archivos para crear árboles de symlinks.
Etiquetas:loading_and_analysis
,execution
,experimental
--[no]experimental_persistent_aar_extractor
predeterminado: “false”-
Habilita el extractor de aar persistente con trabajadores.
Etiquetas:execution
--[no]experimental_remotable_source_manifests
predeterminado: “false”-
Determina si las acciones del manifiesto de origen se pueden controlar de forma remota.
Etiquetas:loading_and_analysis
,execution
,experimental
--[no]experimental_split_coverage_postprocessing
predeterminado: “false”-
Si es verdadero, Bazel ejecutará el procesamiento posterior de la cobertura para la prueba en un nuevo inicio.
Etiquetas:execution
--[no]experimental_split_xml_generation
predeterminado: "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 ficticio que contiene el registro de prueba. De lo contrario, Bazel genera un test.xml como parte de la acción de prueba.
Etiquetas:execution
--[no]experimental_strict_fileset_output
predeterminado: “false”-
Si esta opción está habilitada, los conjuntos de archivos tratarán todos los artefactos de salida como archivos normales. No recorrerán directorios ni serán sensibles a los symlinks.
Etiquetas:execution
--[no]experimental_use_semaphore_for_jobs
predeterminado: “false”-
Si se establece en verdadero, además, usa un semáforo para limitar la cantidad de trabajos simultáneos.
Etiquetas:host_machine_resource_optimizations
,execution
--genrule_strategy=<comma-separated list of options>
predeterminado: ""-
Especifica cómo ejecutar genrules. Esta marca se dará de baja gradualmente. En su lugar, usa --spawn_strategy=<value> para controlar todas las acciones o --strategy=Genrule=<value> para controlar solo las genrules.
Etiquetas:execution
--jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
[-j
] predeterminado: "auto"-
Es la cantidad de trabajos simultáneos que se ejecutarán. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), 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. "auto" calcula un valor predeterminado razonable según los recursos del host.
Etiquetas:host_machine_resource_optimizations
,execution
--[no]keep_going
[-k
] predeterminado: "false"-
Continúa tanto como sea posible después de un error. Si bien no se pueden analizar el objetivo que falló ni los que dependen de él, sí se pueden analizar otros requisitos previos de estos objetivos.
Etiquetas:eagerness_to_exit
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
predeterminado: “auto”-
Cantidad de subprocesos en paralelo que se usarán para la fase de carga o análisis. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". "auto" establece un valor predeterminado razonable según los recursos del host. Debe ser 1 como mínimo.
Etiquetas:bazel_internal_configuration
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
predeterminado: ""-
Agrega o quita claves de la información de ejecución de una acción según la mnemotecnia 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 especificas varios valores, el orden es importante porque muchas regex pueden aplicarse al mismo mnemónico.
Sintaxis: "regex=[+-]clave,regex=[+-]clave,…".
Ejemplos:
'.*=+x,.*=-y,.*=+z' agrega "x" y "z" a la información de ejecución de todas las acciones y quita "y".
"Genrule=+requires-x" agrega "requires-x" a la información de ejecución de todas las acciones de Genrule.
"(?!Genrule).*=-requires-x" quita "requires-x" de la información de ejecución para todas las acciones que no sean de Genrule.
Etiquetas:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Habilita las acciones de expansión de sintaxis y dex persistentes de Android con trabajadores.
Se expande a:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
-
Habilita el procesador de recursos de Android persistente con trabajadores.
Se expande a:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
--strategy=ProcessDatabinding=worker
--strategy=GenerateDataBindingBaseClasses=worker
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_dex_desugar
-
Habilita las acciones de desugar y dex multiplexadas y persistentes de Android con trabajadores.
Se expande a:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
Habilita el procesador de recursos de Android multiplexado persistente con trabajadores.
Se expande a:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_tools
-
Habilita las herramientas de Android persistentes y multiplexadas (dexing, expansión de sintaxis, procesamiento de recursos).
Se expande a:
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Etiquetas:host_machine_resource_optimizations
,execution
--[no]skip_incompatible_explicit_targets
predeterminado: “false”-
Omite los destinos incompatibles que se enumeran de forma explícita en la línea de comandos. De forma predeterminada, la compilación de esos destinos genera un error, pero se omiten de forma silenciosa cuando se habilita esta opción. Consulta: https://bazel.build/extending/platforms#skipping-incompatible-targets
Etiquetas:loading_and_analysis
--spawn_strategy=<comma-separated list of options>
predeterminado: ""-
Especifica cómo se ejecutan las acciones de creació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 varios usos de
--strategy=<a '[name=]value1[,..,valueN]' assignment>
. -
Especifica cómo distribuir la compilación de otras acciones de creació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 mnemónico). Consulta https://blog.bazel.build/2019/06/19/list-strategy.html para obtener más información.
Etiquetas:execution
- Se acumulan varios usos de
--strategy_regexp=<a '<RegexFilter>=value[,value]' assignment>
. -
Anula qué estrategia de activación se debe usar para ejecutar acciones de activación que tengan descripciones que coincidan con un cierto regex_filter. Consulta --per_file_copt para obtener detalles sobre la coincidencia de regex_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 estrategia "local", pero si se invierte el orden, se ejecutará con "sandboxed".
Etiquetas:execution
--[no]use_target_platform_for_tests
predeterminado: “false”-
Si es verdadero, Bazel usará la plataforma de destino para ejecutar pruebas en lugar del grupo de ejecución de pruebas.
Etiquetas:execution
- Son opciones que configuran la cadena de herramientas que se usa para la ejecución de acciones:
--android_compiler=<a string>
predeterminado: Consulta la descripción-
El compilador de destino de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_crosstool_top=<a build target label>
predeterminado: "//external:android/crosstool"-
Es la ubicación del compilador de C++ que se usa para las compilaciones de Android.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_grte_top=<a label>
predeterminado: Consulta la descripción-
El objetivo grte_top de Android.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
predeterminado: "android"-
Selecciona el combinador de manifiestos que se usará para las reglas android_binary. Marca para ayudar a la transición a la combinación de manifiestos de Android desde la combinación heredada.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_platforms=<a build target label>
predeterminado: ""-
Establece las plataformas que usan los destinos de android_binary. Si se especifican varias plataformas, el objeto binario es un APK grueso, que contiene objetos binarios nativos para cada plataforma de destino especificada.
Etiquetas:changes_inputs
,loading_and_analysis
,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
,loses_incremental_state
--apple_crosstool_top=<a build target label>
predeterminado: "@bazel_tools//tools/cpp:toolchain"-
Es la etiqueta del paquete de herramientas cruzadas que se usará en las reglas de Apple y Objc, y sus dependencias.
Etiquetas:loses_incremental_state
,changes_inputs
--cc_output_directory_tag=<a string>
predeterminado: ""-
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas:affects_outputs
--compiler=<a string>
predeterminado: Consulta la descripción-
Es el compilador de C++ que se usará para compilar el destino.
Etiquetas:loading_and_analysis
,execution
--coverage_output_generator=<a build target label>
predeterminado: "@bazel_tools//tools/test:lcov_merger"-
Ubicación del binario que se usa para postprocesar informes de cobertura sin procesar. Actualmente, debe ser un grupo de archivos que contenga un solo archivo, el binario. El valor predeterminado es “//tools/test:lcov_merger”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
predeterminado: "@bazel_tools//tools/test:coverage_report_generator"-
Ubicación del binario que se usa para generar informes de cobertura. Actualmente, debe ser un grupo de archivos que contenga un solo archivo, el binario. El valor predeterminado es "//tools/test:coverage_report_generator".
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
predeterminado: "@bazel_tools//tools/test:coverage_support"-
Ubicación de los archivos de compatibilidad que se requieren en las entradas de cada acción de prueba que recopila la cobertura de código. El valor predeterminado es “//tools/test:coverage_support”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--crosstool_top=<a build target label>
predeterminado: "@bazel_tools//tools/cpp:toolchain"-
Es la etiqueta del paquete de herramientas cruzadas que se usará para compilar código C++.
Etiquetas:loading_and_analysis
,changes_inputs
,affects_outputs
--custom_malloc=<a build target label>
predeterminado: Consulta la descripción- especifica una implementación personalizada de malloc. Este parámetro de configuración anula los atributos malloc en las reglas de compilación.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan varios usos de
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
. -
Es una lista de expresiones regulares separadas por comas, cada una con el prefijo - (expresión negativa) de forma opcional, 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 con al menos una expresión positiva, la resolución de la cadena de herramientas se realizará como si hubiera declarado los valores de restricción como restricciones de ejecución. Ejemplo: //demo,-test=@platforms//cpus:x86_64 agregará "x86_64" a cualquier destino de //demo, excepto a aquellos cuyo nombre contenga "test".
Etiquetas:loading_and_analysis
--[no]experimental_include_xcode_execution_requirements
predeterminado: “false”-
Si se establece, agrega un requisito de ejecución "requires-xcode:{version}" a cada acción de Xcode. Si la versión de Xcode tiene una etiqueta con guiones, también agrega un requisito de ejecución "requires-xcode-label:{version_label}".
Etiquetas:loses_incremental_state
,loading_and_analysis
,execution
--[no]experimental_prefer_mutual_xcode
predeterminado: "true"-
Si es verdadero, usa la versión más reciente de Xcode que esté disponible de forma local y remota. Si es falso o si no hay versiones mutuas disponibles, usa la versión local de Xcode seleccionada a través de xcode-select.
Etiquetas:loses_incremental_state
--extra_execution_platforms=<comma-separated list of options>
predeterminado: ""-
Son las plataformas disponibles como plataformas de ejecución para ejecutar acciones. Las plataformas se pueden especificar por destino exacto o como un patrón de destino. Estas plataformas se considerarán antes de las declaradas en el archivo WORKSPACE por register_execution_platforms(). Esta opción solo se puede establecer una vez; las instancias posteriores anularán la configuración de la marca anterior.
Etiquetas:execution
- Se acumulan varios usos de
--extra_toolchains=<comma-separated list of options>
. -
Son las reglas de la cadena de herramientas que se deben tener en cuenta durante la resolución de la cadena de herramientas. Las cadenas de herramientas se pueden especificar por destino exacto o como un patrón de destino. Estas cadenas de herramientas se considerarán antes que las declaradas en el archivo WORKSPACE por register_toolchains().
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--grte_top=<a label>
predeterminado: Consulta la descripción-
Es una etiqueta para una biblioteca libc verificada. La cadena de herramientas de crosstool selecciona el valor predeterminado, y casi nunca es necesario anularlo.
Etiquetas:action_command_lines
,affects_outputs
--host_compiler=<a string>
predeterminado: Consulta la descripción-
Es el compilador de C++ que se usará para la compilación del host. Se ignora si no se establece --host_crosstool_top.
Etiquetas:loading_and_analysis
,execution
--host_crosstool_top=<a build target label>
predeterminado: Consulta la descripción-
De forma predeterminada, las opciones --crosstool_top y --compiler también se usan para la configuración de exec. Si se proporciona esta marca, Bazel usa la libc y el compilador predeterminados para el crosstool_top determinado.
Etiquetas:loading_and_analysis
,changes_inputs
,affects_outputs
--host_grte_top=<a label>
predeterminado: Consulta la descripción-
Si se especifica, este parámetro de configuración anula el directorio de nivel superior de libc (--grte_top) para la configuración de exec.
Etiquetas:action_command_lines
,affects_outputs
--host_platform=<a build target label>
predeterminado: "@local_config_platform//:host"-
La etiqueta de una regla de plataforma que describe el sistema host.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
predeterminado: "true"-
Si es verdadero, Bazel no habilitará las funciones "host" y "nonhost" en la cadena de herramientas de C++ (consulta https://github.com/bazelbuild/bazel/issues/7407 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_android_toolchain_resolution
predeterminado: "true"-
Usa la resolución de cadena de herramientas para seleccionar el SDK de Android para las reglas de Android (Starlark y nativo)
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_apple_toolchain_resolution
predeterminado: “false”-
Usa la resolución de cadena de herramientas para seleccionar el SDK de Apple para las reglas de Apple (Starlark y nativo)
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone
predeterminado: "true"-
Si es verdadero, Bazel no reutilizará las líneas de comandos de la acción de vinculación de C++ para las líneas de comandos de indexación de lto (consulta https://github.com/bazelbuild/bazel/issues/6791 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_legacy_whole_archive
predeterminado: "true"-
Si es verdadero, Bazel no vinculará las dependencias de la biblioteca como un archivo completo de forma predeterminada (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener instrucciones de migración).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_require_ctx_in_configure_features
predeterminado: "true"-
Si es verdadero, Bazel requerirá el parámetro "ctx" en cc_common.configure_features (consulta https://github.com/bazelbuild/bazel/issues/7793 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
-
Usa objetos compartidos de interfaz si la cadena de herramientas es compatible. Actualmente, todas las cadenas de herramientas ELF admiten este parámetro de configuración.
Etiquetas:loading_and_analysis
,affects_outputs
,affects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Especifica la versión del SDK de iOS que se usará para compilar aplicaciones para iOS. Si no se especifica, usa la versión predeterminada del SDK de iOS de "xcode_version".
Etiquetas:loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Especifica la versión del SDK de macOS que se usará para compilar aplicaciones para macOS. Si no se especifica, se usa la versión predeterminada del SDK de macOS de "xcode_version".
Etiquetas:loses_incremental_state
--minimum_os_version=<a string>
predeterminado: Consulta la descripción-
Es la versión mínima del SO a la que se orienta tu compilación.
Etiquetas:loading_and_analysis
,affects_outputs
--platform_mappings=<a relative path>
predeterminado: ""-
Es la ubicación de un archivo de asignación que describe qué plataforma usar si no se establece ninguna o qué marcas establecer cuando ya existe una plataforma. Debe ser relativo a la raíz del espacio de trabajo principal. El valor predeterminado es "platform_mappings" (un archivo directamente debajo de la raíz del espacio de trabajo).
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--platforms=<a build target label>
predeterminado: ""-
Son las etiquetas de las reglas de la plataforma que describen las plataformas de destino del comando actual.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--python2_path=<a string>
predeterminado: Consulta la descripción-
Obsoleto, no realiza ninguna acción. Se inhabilitó con `--incompatible_use_python_toolchains`.
Etiquetas:no_op
,deprecated
--python3_path=<a string>
predeterminado: Consulta la descripción-
Obsoleto, no realiza ninguna acción. Se inhabilitó con `--incompatible_use_python_toolchains`.
Etiquetas:no_op
,deprecated
--python_path=<a string>
predeterminado: Consulta la descripción-
Es la ruta de acceso absoluta del intérprete de Python que se invocó para ejecutar destinos de Python en la plataforma de destino. Obsoleto; se inhabilitó con --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
--python_top=<a build target label>
predeterminado: Consulta la descripción-
La etiqueta de un py_runtime que representa el intérprete de Python invocado para ejecutar destinos de Python en la plataforma de destino. Obsoleto; se inhabilitó con --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Especifica la versión del SDK de tvOS que se usará para compilar aplicaciones para tvOS. Si no se especifica, se usa la versión predeterminada del SDK de tvOS de "xcode_version".
Etiquetas:loses_incremental_state
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Especifica la versión del SDK de watchOS que se usará para compilar aplicaciones para watchOS. Si no se especifica, se usa la versión predeterminada del SDK de watchOS de "xcode_version".
Etiquetas:loses_incremental_state
--xcode_version=<a string>
predeterminado: Consulta la descripción-
Si se especifica, usa Xcode de la versión determinada para las acciones de compilación relevantes. Si no se especifica, se usa la versión predeterminada del ejecutor de Xcode.
Etiquetas:loses_incremental_state
--xcode_version_config=<a build target label>
predeterminado: "@bazel_tools//tools/cpp:host_xcodes"-
Es la etiqueta de la regla xcode_config que se usará para seleccionar la versión de Xcode en la configuración de compilación.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Opciones que controlan el resultado del comando:
--[no]apple_generate_dsym
predeterminado: “false”-
Indica si se deben generar archivos de símbolos de depuración (.dSYM).
Etiquetas:affects_outputs
,action_command_lines
--[no]build
predeterminado: "true"-
Ejecuta la compilación. Este es el comportamiento habitual. Especificar --nobuild hace que la compilación se detenga antes de ejecutar las acciones de compilación y devuelva cero si las fases de carga y análisis del paquete se completaron correctamente. Este modo es útil para probar esas fases.
Etiquetas:execution
,affects_outputs
--[no]build_runfile_links
predeterminado: "true"-
Si es verdadero, compila bosques de symlinks de runfiles para todos los destinos. Si es falso, escríbelos solo cuando lo requiera una acción local, una prueba o un comando de ejecución.
Etiquetas:affects_outputs
--[no]build_runfile_manifests
predeterminado: "true"-
Si es verdadero, escribe manifiestos de runfiles para todos los destinos. Si es falso, omítelos. Las pruebas locales no se ejecutarán si es falso.
Etiquetas:affects_outputs
--[no]build_test_dwp
predeterminado: “false”-
Si está habilitado, cuando se compilen pruebas de C++ de forma estática y con Fission, el archivo .dwp para el objeto binario de prueba también se compilará automáticamente.
Etiquetas:loading_and_analysis
,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 una cc_proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated set of options>
predeterminado: “.pb.cc”-
Configura los sufijos de los archivos de origen que crea una cc_proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info
predeterminado: “false”-
Ejecuta acciones adicionales para versiones alternativas de la API de Java en una proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_proto_extra_actions
predeterminado: “false”-
Ejecuta acciones adicionales para versiones alternativas de la API de Java en una proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_save_feature_state
predeterminado: “false”-
Guarda el estado de las funciones habilitadas y solicitadas como un resultado de la compilación.
Etiquetas:affects_outputs
,experimental
--[no]experimental_use_validation_aspect
predeterminado: “false”-
Indica si se deben ejecutar acciones de validación con el aspecto (para el paralelismo con las pruebas).
Etiquetas:execution
,affects_outputs
--fission=<a set of compilation modes>
predeterminado: “no”-
Especifica qué modos de compilación usan la fisión para las compilaciones y los vínculos de C++. Puede ser cualquier combinación de {'fastbuild', 'dbg', 'opt'} o los valores especiales "yes" para habilitar todos los modos y "no" para inhabilitarlos.
Etiquetas:loading_and_analysis
,action_command_lines
,affects_outputs
--[no]incompatible_always_include_files_in_data
predeterminado: "true"-
Si es verdadero, las reglas nativas agregan <code>DefaultInfo.files</code> de dependencias de datos a sus archivos de ejecución, lo que coincide con el comportamiento recomendado para las reglas de Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid).
Etiquetas:affects_outputs
,incompatible_change
--[no]legacy_external_runfiles
predeterminado: "true"-
Si es verdadero, compila bosques de symlinks de runfiles para repositorios externos en .runfiles/wsname/external/repo (además de .runfiles/repo).
Etiquetas:affects_outputs
--[no]objc_generate_linkmap
predeterminado: “false”- especifica si se debe generar un archivo de mapa de vínculos.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--output_groups=<comma-separated list of options>
. -
Es una lista de nombres de grupos de salida separados por comas, cada uno de los cuales puede tener un prefijo de + o -. Un grupo con el prefijo + se agrega al conjunto predeterminado de grupos de salida, mientras que un grupo con el prefijo - se quita del conjunto predeterminado. Si no se agrega un prefijo a, al menos, un grupo, se omite el conjunto predeterminado de grupos de salida. Por ejemplo, --output_groups=+foo,+bar compila la unión del conjunto predeterminado, foo y bar, mientras que --output_groups=foo,bar anula el conjunto predeterminado de modo que solo se compilen foo y bar.
Etiquetas:execution
,affects_outputs
--[no]run_validations
predeterminado: "true"-
Indica si se deben ejecutar acciones de validación como parte de la compilación. Consulta https://bazel.build/extending/rules#validation_actions.
Etiquetas:execution
,affects_outputs
--[no]save_temps
predeterminado: “false”-
Si se establece, se guardarán los resultados temporales de gcc. Estos incluyen archivos .s (código de ensamblador), archivos .i (C procesado) y archivos .ii (C++ procesado).
Etiquetas:affects_outputs
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
- Se acumulan varios usos de
--action_env=<a 'name=value' assignment with an optional value part>
. -
Especifica el conjunto de variables de entorno disponibles para las acciones con configuración de destino. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o bien por el par nombre=valor, que establece el valor independientemente del entorno de invocación. Esta opción se puede usar varias veces. En el caso de las opciones que se proporcionan para la misma variable, se aplica la más reciente, y se acumulan las opciones para diferentes variables.
Etiquetas:action_command_lines
--android_cpu=<a string>
predeterminado: "armeabi-v7a"-
La CPU objetivo de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]android_databinding_use_androidx
predeterminado: "true"-
Genera archivos de vinculación de datos compatibles con AndroidX. Esto solo se usa con la vinculación de datos v2. Esta marca no realiza ninguna acción.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]android_databinding_use_v3_4_args
predeterminado: "true"-
Usa Android Databinding v2 con el argumento 3.4.0. Esta marca no realiza ninguna acción.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--android_dynamic_mode=<off, default or fully>
predeterminado: "off"-
Determina si las dependencias de C++ de las reglas de Android se vincularán de forma dinámica cuando un cc_binary no cree una biblioteca compartida de forma explícita. "default" significa que bazel elegirá si vincular 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 modo principalmente estático.
Etiquetas:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
predeterminado: "alphabetical"-
Establece el orden de los manifiestos que se pasan a la combinación de manifiestos para los objetos binarios de Android. ALPHABETICAL significa que los manifiestos se ordenan por ruta de acceso en relación con el execroot. ALPHABETICAL_BY_CONFIGURATION significa que los manifiestos se ordenan por rutas de acceso relativas al directorio de configuración dentro del directorio de salida. DEPENDENCY significa que los manifiestos se ordenan de modo que el manifiesto de cada biblioteca aparezca antes que los manifiestos de sus dependencias.
Etiquetas:action_command_lines
,execution
--[no]android_resource_shrinking
predeterminado: “false”-
Habilita la reducción de recursos para los APKs de android_binary que usan ProGuard.
Etiquetas:affects_outputs
,loading_and_analysis
- Se acumulan varios usos de
--aspects=<comma-separated list of options>
. - Es una lista de aspectos separados por comas que se aplicarán a los objetivos de nivel superior. En la lista, si el aspecto some_aspect especifica proveedores de aspectos obligatorios a través de required_aspect_providers, some_aspect se ejecutará después de cada aspecto que se haya mencionado antes en la lista de aspectos cuyos proveedores anunciados satisfagan los proveedores de aspectos obligatorios de some_aspect. Además, some_aspect se ejecutará después de todos sus aspectos obligatorios especificados por el atributo requires. Luego, some_aspect tendrá acceso a los valores de los proveedores de esos aspectos. <bzl-file-label>%<aspect_name>, por ejemplo, "//tools:my_def.bzl%my_aspect", donde "my_aspect" es un valor de nivel superior de un archivo tools/my_def.bzl
--[no]build_python_zip
predeterminado: “auto”-
Compila el archivo ZIP ejecutable de Python; activado en Windows, desactivado en otras plataformas.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--catalyst_cpus=<comma-separated list of options>
. -
Es una lista de arquitecturas separadas por comas para las que se compilarán objetos binarios de Apple Catalyst.
Etiquetas:loses_incremental_state
,loading_and_analysis
--[no]collect_code_coverage
predeterminado: “false”-
Si se especifica, Bazel instrumentará el código (con instrumentación sin conexión siempre que sea posible) y recopilará información de cobertura durante las pruebas. Solo se verán afectados los destinos que coincidan con --instrumentation_filter. Por lo general, esta opción no debe especificarse directamente. En su lugar, se debe usar el comando "bazel coverage".
Etiquetas:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] predeterminado: "fastbuild"-
Especifica el modo en el que se compilará el objeto binario. Valores: "fastbuild", "dbg", "opt".
Etiquetas:affects_outputs
,action_command_lines
- Se acumulan varios usos de
--conlyopt=<a string>
. -
Opción adicional para pasar a gcc cuando se compilan archivos de origen C.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--copt=<a string>
. - Opciones adicionales para pasar a gcc.
Etiquetas:action_command_lines
,affects_outputs
--cpu=<a string>
predeterminado: ""-
La CPU objetivo.
Etiquetas:changes_inputs
,affects_outputs
--cs_fdo_absolute_path=<a string>
predeterminado: Consulta la descripción-
Usa la información del perfil de CSFDO para optimizar la compilación. Especifica el nombre de la ruta de acceso absoluta del archivo ZIP que contiene el archivo de perfil, un archivo de perfil LLVM sin procesar o indexado.
Etiquetas:affects_outputs
--cs_fdo_instrument=<a string>
predeterminado: Consulta la descripción-
Genera objetos binarios con instrumentación de FDO sensible al contexto. Con el compilador Clang/LLVM, también acepta el nombre del directorio en el que se volcarán los archivos de perfil sin procesar durante el tiempo de ejecución.
Etiquetas:affects_outputs
--cs_fdo_profile=<a build target label>
predeterminado: Consulta la 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 varios usos de
--cxxopt=<a string>
. -
Opción adicional para pasar a gcc cuando se compilan archivos de origen C++.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--define=<a 'name=value' assignment>
. -
Cada opción --define especifica una asignación para una variable de compilación.
Etiquetas:changes_inputs
,affects_outputs
--dynamic_mode=<off, default or fully>
predeterminado: "predeterminado"- determina si los objetos binarios de C++ se vincularán de forma dinámica. "default" significa que Bazel elegirá si vincular 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 modo principalmente estático.
Etiquetas:loading_and_analysis
,affects_outputs
--[no]enable_fdo_profile_absolute_path
predeterminado: "true"-
Si se establece, el uso de fdo_absolute_profile_path generará un error.
Etiquetas:affects_outputs
--[no]enable_runfiles
predeterminado: “auto”-
Habilita el árbol de symlinks de runfiles. De forma predeterminada, está desactivado en Windows y en otras plataformas.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--experimental_action_listener=<a build target label>
. - dejó de estar disponible y se reemplazó por aspectos. Usa action_listener para adjuntar una extra_action a las acciones de compilación existentes.
Etiquetas:execution
,experimental
--[no]experimental_android_compress_java_resources
predeterminado: “false”-
Comprime los recursos de Java en los APKs.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_android_databinding_v2
predeterminado: "true"-
Usa Android Databinding v2. Esta marca no realiza ninguna acción.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_android_resource_shrinking
predeterminado: “false”-
Habilita la reducción de recursos para los APKs de android_binary que usan ProGuard.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_android_rewrite_dexes_with_rex
predeterminado: “false”-
Usa la herramienta rex para volver a escribir archivos dex.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_collect_code_coverage_for_generated_files
predeterminado: “false”-
Si se especifica, Bazel también generará información de cobertura recopilada para los archivos generados.
Etiquetas:affects_outputs
--[no]experimental_convenience_symlinks
predeterminado: "normal"-
Esta marca controla cómo se administrarán los symlinks de conveniencia (los symlinks 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.
clean: Se borrarán todos los symlinks sin condiciones.
ignore: Los symlinks no se modificarán.
log_only: Genera mensajes de registro como si se pasara "normal", pero no realiza ninguna operación de sistema de archivos (útil para herramientas).
Ten en cuenta que solo se pueden ver afectados los symlinks cuyos nombres genera el valor actual de --symlink_prefix. Si cambia el prefijo, no se modificarán los symlinks preexistentes.
Etiquetas:affects_outputs
--[no]experimental_convenience_symlinks_bep_event
predeterminado: “false”-
Esta marca controla si publicaremos o no el evento de compilación ConvenienceSymlinksIdentified en BuildEventProtocol. Si el valor es verdadero, BuildEventProtocol tendrá una entrada para convenienceSymlinksIdentified, en la que se enumerarán todos los symlinks de conveniencia creados en tu lugar de trabajo. Si es falso, la entrada convenienceSymlinksIdentified 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 de fastbuild de objc.
Etiquetas:action_command_lines
--[no]experimental_omitfp
predeterminado: “false”-
Si es verdadero, usa libunwind para el desenredo de pila y compila con -fomit-frame-pointer y -fasynchronous-unwind-tables.
Etiquetas:action_command_lines
,affects_outputs
,experimental
--experimental_output_paths=<off, content or strip>
predeterminado: "off"-
Qué modelo usar para determinar en qué parte del árbol de salida las reglas escriben sus resultados, en particular para compilaciones multiplataforma o multiconfiguración. Esta función es muy experimental. Consulta https://github.com/bazelbuild/bazel/issues/6526 para obtener más información. Las acciones de Starlark pueden habilitar la asignación de rutas de acceso agregando la clave "supports-path-mapping" al diccionario "execution_requirements".
Etiquetas:loses_incremental_state
,bazel_internal_configuration
,affects_outputs
,execution
- Se acumulan varios usos de
--experimental_override_name_platform_in_output_dir=<a 'label=value' assignment>
. -
Cada entrada debe tener el formato etiqueta=valor, en el que etiqueta hace referencia a una plataforma y valor es el nombre abreviado que se desea usar en la ruta de salida. Solo se usa cuando --experimental_platform_in_output_dir es verdadero. Tiene la prioridad de nombres más alta.
Etiquetas:affects_outputs
,experimental
--[no]experimental_platform_in_output_dir
predeterminado: “false”-
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: primero, en el caso poco frecuente de que la opción --platforms no tenga exactamente un valor, se usa un hash de la opción platforms. A continuación, si se registró algún nombre corto para la plataforma actual con --experimental_override_name_platform_in_output_dir, se usará ese nombre corto. Luego, si se establece --experimental_use_platforms_in_output_dir_legacy_heuristic, usa un nombre corto basado en la etiqueta de plataforma actual. Por último, se usa un hash de la opción de plataforma como último recurso.
Etiquetas:affects_outputs
,experimental
--[no]experimental_use_llvm_covmap
predeterminado: “false”-
Si se especifica, Bazel generará información del mapa de cobertura de llvm-cov en lugar de gcov cuando se habilite collect_code_coverage.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic
predeterminado: "true"-
Usa esta marca solo como parte de una estrategia de migración o prueba sugerida. Ten en cuenta que la heurística tiene deficiencias conocidas y se recomienda migrar a depender solo de --experimental_override_name_platform_in_output_dir.
Etiquetas:affects_outputs
,experimental
--fat_apk_cpu=<comma-separated set of options>
predeterminado: "armeabi-v7a"-
Si configuras esta opción, se habilitan los APKs multiarquitectura, que contienen objetos binarios nativos para todas las arquitecturas de destino especificadas, p.ej., --fat_apk_cpu=x86,armeabi-v7a. Si se especifica esta marca, se ignora --android_cpu para las dependencias de las reglas android_binary.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]fat_apk_hwasan
predeterminado: “false”-
Indica si se deben crear divisiones HWASAN.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--fdo_instrument=<a string>
predeterminado: Consulta la descripción-
Genera objetos binarios con la instrumentación de FDO. Con el compilador Clang/LLVM, también acepta el nombre del directorio en el que se volcarán los archivos de perfil sin procesar durante el tiempo de ejecución.
Etiquetas:affects_outputs
--fdo_optimize=<a string>
predeterminado: Consulta la descripción-
Usa la información del perfil de FDO para optimizar la compilación. Especifica el nombre de un archivo ZIP que contenga un árbol de archivos .gcda, un archivo afdo que contenga un perfil automático o un archivo de perfil de LLVM. Esta marca también acepta archivos especificados como etiquetas (p.ej., "//foo/bar:file.afdo"; es posible que debas agregar una directiva "exports_files" al paquete correspondiente) y etiquetas que apuntan a destinos "fdo_profile". La regla "fdo_profile" reemplazará esta marca.
Etiquetas:affects_outputs
--fdo_prefetch_hints=<a build target label>
predeterminado: Consulta la descripción-
Usa sugerencias de almacenamiento en caché para la carga previa.
Etiquetas:affects_outputs
--fdo_profile=<a build target label>
predeterminado: Consulta la descripción-
Es el fdo_profile que representa el perfil que se usará para la optimización.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--features=<a string>
. -
Las funciones determinadas se habilitarán o inhabilitarán de forma predeterminada para los destinos compilados en la configuración de destino. Si especificas -<feature>, se inhabilitará la función. Los atributos negativos siempre anulan los positivos. Consulta también --host_features
Etiquetas:changes_inputs
,affects_outputs
--[no]force_pic
predeterminado: “false”-
Si está habilitado, todas las compilaciones de C++ producen código independiente de la posición ("-fPIC"), los vínculos prefieren las bibliotecas precompiladas de PIC en lugar de las bibliotecas que no son de PIC, y los vínculos producen ejecutables independientes de la posición ("-pie").
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan varios usos de
--host_action_env=<a 'name=value' assignment with an optional value part>
. -
Especifica el conjunto de variables de entorno disponibles para las acciones con configuraciones de ejecución. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o bien por el par nombre=valor, que establece el valor independientemente del entorno de invocación. Esta opción se puede usar varias veces. En el caso de las opciones que se proporcionan para la misma variable, se aplica la más reciente, y se acumulan las opciones para diferentes variables.
Etiquetas:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
predeterminado: "opt"-
Especifica el modo en el que se compilarán las herramientas que se usan durante la compilación. Valores: "fastbuild", "dbg", "opt".
Etiquetas:affects_outputs
,action_command_lines
- Se acumulan varios usos de
--host_conlyopt=<a string>
. -
Opción adicional para pasar al compilador de C cuando se compilan archivos de origen C (pero no C++) en las configuraciones de ejecución.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--host_copt=<a string>
. -
Opciones adicionales para pasar al compilador C para herramientas compiladas en las configuraciones de ejecución.
Etiquetas:action_command_lines
,affects_outputs
--host_cpu=<a string>
predeterminado: ""-
La CPU del host.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan varios usos de
--host_cxxopt=<a string>
. -
Opciones adicionales para pasar al compilador de C++ para herramientas compiladas en las configuraciones de ejecución.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--host_features=<a string>
. -
Las funciones determinadas se habilitarán o inhabilitarán de forma predeterminada para los destinos compilados en la configuración de ejecución. Si especificas -<feature>, se inhabilitará la función. Los atributos negativos siempre anulan los positivos.
Etiquetas:changes_inputs
,affects_outputs
--host_force_python=<PY2 or PY3>
predeterminado: Consulta la descripción-
Anula la versión de Python para la configuración de ejecución. Puede ser “PY2” o “PY3”.
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan varios usos de
--host_linkopt=<a string>
. -
Opción adicional para pasar al vinculador cuando se vinculan herramientas en las configuraciones de ejecución.
Etiquetas:action_command_lines
,affects_outputs
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Versión mínima compatible de macOS para los destinos de host. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan varios usos de
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
. -
Opciones adicionales para pasar de forma selectiva al compilador C/C++ cuando se compilan ciertos archivos en las configuraciones de ejecución. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. En la que regex_filter representa una lista de patrones de expresiones regulares para incluir y excluir (consulta también --instrumentation_filter). option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe estar entre comillas con una barra invertida. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos de gcc de todos los archivos cc en //foo/, excepto bar.cc.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--host_swiftcopt=<a string>
. -
Opciones adicionales para pasar a swiftc para herramientas de ejecución.
Etiquetas:action_command_lines
,affects_outputs
--[no]incompatible_auto_exec_groups
predeterminado: “false”-
Cuando se habilita, se crea automáticamente un grupo de ejecución para cada cadena de herramientas que usa una regla. Para que esto funcione, la regla 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
,incompatible_change
--[no]incompatible_merge_genfiles_directory
predeterminado: "true"-
Si es verdadero, el directorio genfiles se une al directorio bin.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_use_host_features
predeterminado: "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
,incompatible_change
--[no]instrument_test_targets
predeterminado: “false”-
Cuando la cobertura está habilitada, especifica si se deben considerar las reglas de prueba de instrumentación. Cuando se establece, se instrumentan las reglas de prueba que incluye --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 habilita la cobertura, solo se instrumentarán las reglas con nombres incluidos en el filtro basado en regex especificado. En su lugar, se excluyen las reglas con el prefijo “-”. Ten en cuenta que solo se instrumentan las reglas que no son de prueba, a menos que se habilite --instrument_test_targets.
Etiquetas:affects_outputs
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Es la versión mínima de iOS compatible para los simuladores y dispositivos de destino. Si no se especifica, se usa "ios_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan varios usos de
--ios_multi_cpus=<comma-separated list of options>
. -
Es una lista de arquitecturas separadas por comas con las que se compila una ios_application. El resultado es un binario universal que contiene todas las arquitecturas especificadas.
Etiquetas:loses_incremental_state
,loading_and_analysis
--[no]legacy_whole_archive
predeterminado: "true"-
Obsoleto, reemplazado por --incompatible_remove_legacy_whole_archive (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener más información). Cuando está activado, usa --whole-archive para las reglas cc_binary que tienen linkshared=True y linkstatic=True o “-static” en linkopts. Esto es solo para la retrocompatibilidad. Una mejor alternativa es usar alwayslink=1 cuando sea necesario.
Etiquetas:action_command_lines
,affects_outputs
,deprecated
- Se acumulan varios usos de
--linkopt=<a string>
. - : Opción adicional para pasar a gcc cuando se realiza la vinculación.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--ltobackendopt=<a string>
. -
Opción adicional para pasar al paso de backend de LTO (en --features=thin_lto).
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--ltoindexopt=<a string>
. -
Opción adicional para pasar al paso de indexación de LTO (en --features=thin_lto).
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--macos_cpus=<comma-separated list of options>
. -
Es una lista separada por comas de las arquitecturas para las que se compilarán los objetos binarios de Apple macOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Versión mínima de macOS compatible para los destinos. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
--memprof_profile=<a build target label>
predeterminado: Consulta la descripción-
Usa el perfil de memprof.
Etiquetas:affects_outputs
--[no]objc_debug_with_GLIBCXX
predeterminado: “false”-
Si se establece y el modo de compilación se establece en "dbg", define GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC y GLIBCPP_CONCEPT_CHECKS.
Etiquetas:action_command_lines
--[no]objc_enable_binary_stripping
predeterminado: “false”-
Determina si se deben quitar los símbolos y el código muerto en los 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 varios usos de
--objccopt=<a string>
. -
Opciones adicionales para pasar a gcc cuando se compilan archivos de origen Objective-C/C++.
Etiquetas:action_command_lines
- Se acumulan varios usos de
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
. -
Opciones adicionales para pasar de forma selectiva a gcc cuando se compilan ciertos archivos. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. En la que regex_filter representa una lista de patrones de expresiones regulares para incluir y excluir (consulta también --instrumentation_filter). option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe estar entre comillas con una barra invertida. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos de gcc de todos los archivos cc en //foo/, excepto bar.cc.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
. -
Opciones adicionales para pasar de forma selectiva al backend de LTO (en --features=thin_lto) cuando se compilan ciertos objetos de backend. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. En la que regex_filter representa una lista de patrones de expresión regular para incluir y excluir. option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe estar entre comillas con una barra invertida. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos del backend de LTO de todos los archivos o en //foo/, excepto bar.o.
Etiquetas:action_command_lines
,affects_outputs
--platform_suffix=<a string>
predeterminado: Consulta la descripción-
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas:loses_incremental_state
,affects_outputs
,loading_and_analysis
--propeller_optimize=<a build target label>
predeterminado: Consulta la descripción-
Usa la información del perfil de Propeller para optimizar el destino de compilación.Un perfil de Propeller debe constar de al menos uno de dos archivos: un perfil de cc y un perfil de ld. Esta marca acepta una etiqueta de compilación que debe hacer referencia a los archivos de entrada del perfil de Propeller. Por ejemplo, el archivo BUILD que define la etiqueta, en a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)Es posible que se deba agregar una directiva exports_files al paquete correspondiente para que Bazel pueda ver estos archivos. La opción se debe usar de la siguiente manera: --propeller_optimize=//a/b:propeller_profile
Etiquetas:action_command_lines
,affects_outputs
--propeller_optimize_absolute_cc_profile=<a string>
predeterminado: Consulta la descripción-
Nombre de ruta de acceso absoluta del archivo cc_profile para compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
predeterminado: Consulta la descripción-
Es el nombre de ruta de acceso absoluto del archivo ld_profile para las compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
--run_under=<a prefix in front of command>
predeterminado: Consulta la descripción-
Es el prefijo que se inserta antes de los ejecutables para los comandos "test" y "run". Si el valor es "foo -bar" y la línea de comandos de ejecución es "test_binary -baz", la línea de comandos final es "foo -bar test_binary -baz".También puede ser una etiqueta para un destino ejecutable. Algunos ejemplos son: "valgrind", "strace", "strace -c", "valgrind --quiet --num-callers=20", "//package:target", "//package:target --options".
Etiquetas:action_command_lines
-
Si es verdadero, las bibliotecas nativas que contienen funcionalidad idéntica se compartirán entre diferentes destinos.
Etiquetas:loading_and_analysis
,affects_outputs
--[no]stamp
predeterminado: “false”-
Marca los 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
- Valor predeterminado de
--strip=<always, sometimes or never>
: “sometimes” - especifica si se deben quitar los objetos binarios y las bibliotecas compartidas (con "-Wl,--strip-debug"). El valor predeterminado de "sometimes" significa quitar si --compilation_mode=fastbuild.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--stripopt=<a string>
. -
Opciones adicionales para pasar a la eliminación cuando se genera un objeto binario "<name>.stripped".
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--swiftcopt=<a string>
. -
Opciones adicionales para pasar a la compilación de Swift.
Etiquetas:action_command_lines
--symlink_prefix=<a string>
predeterminado: Consulta la descripción-
Es el prefijo que se agrega a cualquiera de los symlinks de conveniencia que se crean después de una compilación. Si se omite, el valor predeterminado es el nombre de la herramienta de compilación seguido de un guion. Si se pasa “/”, no se crean symlinks ni se emite ninguna advertencia. Advertencia: La funcionalidad especial para "/" dejará de estar disponible pronto. En su lugar, usa --experimental_convenience_symlinks=ignore.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--tvos_cpus=<comma-separated list of options>
. -
Es una lista separada por comas de las arquitecturas para las que se compilarán los objetos binarios de Apple tvOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Versión mínima compatible de tvOS para los simuladores y dispositivos de destino. Si no se especifica, se usa "tvos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan varios usos de
--visionos_cpus=<comma-separated list of options>
. -
Es una lista separada por comas de las arquitecturas para las que se compilarán los objetos binarios de Apple visionOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Se acumulan varios usos de
--watchos_cpus=<comma-separated list of options>
. -
Es una lista separada por comas de las arquitecturas para las que se compilarán los objetos binarios de Apple watchOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Versión mínima compatible de watchOS para los simuladores y dispositivos de destino. Si no se especifica, se usa "watchos_sdk_version".
Etiquetas:loses_incremental_state
--xbinary_fdo=<a build target label>
predeterminado: Consulta la descripción-
Usa la información del perfil de XbinaryFDO para optimizar la compilación. Especifica el nombre del perfil binario cruzado 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 rigurosidad con la que Bazel aplica entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
--auto_cpu_environment_group=<a build target label>
predeterminado: ""-
Declara el environment_group que se usará para asignar automáticamente los valores de CPU a los valores de target_environment.
Etiquetas:changes_inputs
,loading_and_analysis
,experimental
--[no]check_licenses
predeterminado: “false”-
Verifica que las restricciones de licencias que imponen los paquetes dependientes no entren en conflicto con los modos de distribución de los destinos que se compilan. De forma predeterminada, no se verifican las licencias.
Etiquetas:build_file_semantics
--[no]check_visibility
predeterminado: "true"-
Si se inhabilita, los errores de visibilidad en las dependencias de destino se degradan a advertencias.
Etiquetas:build_file_semantics
--[no]desugar_for_android
predeterminado: "true"-
Indica si se debe expandir el código de bytes de Java 8 antes de dexificarlo.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]desugar_java8_libs
predeterminado: “false”-
Indica si se deben incluir bibliotecas compatibles de Java 8 en apps para dispositivos heredados.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]enforce_constraints
predeterminado: "true"-
Verifica los entornos con los que es compatible cada objetivo y, luego, informa errores si alguno tiene dependencias que no admiten los mismos entornos.
Etiquetas:build_file_semantics
--[no]experimental_check_desugar_deps
predeterminado: "true"-
Determina si se debe volver a verificar la expansión correcta a nivel binario de Android.
Etiquetas:eagerness_to_exit
,loading_and_analysis
,experimental
--experimental_import_deps_checking=<off, warning or error>
predeterminado: “OFF”-
Cuando está habilitado, verifica si las dependencias de una aar_import están completas. Esta aplicación forzosa puede interrumpir la compilación o generar advertencias.
Etiquetas:loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
predeterminado: "predeterminado"-
Si es verdadero, verifica que un destino de Java declare explícitamente todos los destinos utilizados directamente como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files
predeterminado: “false”-
Si está habilitado, busca el atributo testonly de la regla de generación para verificar si hay destinos de requisitos previos que sean archivos de salida. Esto coincide con la verificación de visibilidad.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_check_visibility_for_toolchains
predeterminado: “false”-
Si está habilitada, la verificación de visibilidad también se aplica a las implementaciones de la cadena de herramientas.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_disable_native_android_rules
predeterminado: “false”-
Si se habilita, se inhabilita el uso directo de las reglas nativas de Android. Usa las reglas de Android de Starlark de https://github.com/bazelbuild/rules_android.
Etiquetas:eagerness_to_exit
,incompatible_change
--[no]incompatible_disable_native_apple_binary_rule
predeterminado: “false”-
No realiza ninguna acción. Se mantiene aquí para la retrocompatibilidad.
Etiquetas:eagerness_to_exit
,incompatible_change
--[no]incompatible_python_disable_py2
predeterminado: "true"-
Si es verdadero, usar la configuración de Python 2 provocará un error. Esto incluye python_version=PY2, srcs_version=PY2 y srcs_version=PY2ONLY. Consulta https://github.com/bazelbuild/bazel/issues/15684 para obtener más información.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_validate_top_level_header_inclusions
predeterminado: "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
,incompatible_change
--python_native_rules_allowlist=<a build target label>
predeterminado: Consulta la descripción-
Es una lista de entidades permitidas (objetivo de package_group) que se usará cuando se aplique --incompatible_python_disallow_native_rules.
Etiquetas:loading_and_analysis
--[no]strict_filesets
predeterminado: “false”-
Si esta opción está habilitada, los conjuntos de archivos que cruzan los límites de los paquetes se informan como errores.
Etiquetas:build_file_semantics
,eagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default>
predeterminado: "error"-
A menos que esté desactivado, comprueba que un destino de proto_library declare de forma explícita todos los destinos utilizados directamente como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
--strict_public_imports=<off, warn, error, strict or default>
predeterminado: "off"-
A menos que esté desactivado, comprueba que un objetivo de proto_library declare de forma explícita todos los objetivos que se usan en "import public" como exportados.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
--[no]strict_system_includes
predeterminado: “false”-
Si es verdadero, también se deben declarar los encabezados que se encuentran a través de las rutas de inclusión del sistema (-isystem).
Etiquetas:loading_and_analysis
,eagerness_to_exit
- Se acumulan varios usos de
--target_environment=<a build target label>
. -
Declara el entorno de destino de esta compilación. Debe ser una referencia de etiqueta a una regla de "entorno". Si se especifican, 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 que se usará para firmar APKs
Etiquetas:action_command_lines
,affects_outputs
,loading_and_analysis
--[no]device_debug_entitlements
predeterminado: "true"-
Si se establece y el modo de compilación no es "opt", las apps de objc incluirán derechos de depuración cuando se firmen.
Etiquetas:changes_inputs
--ios_signing_cert_name=<a string>
predeterminado: Consulta la descripción-
Nombre del certificado que se usará para la firma de iOS. Si no se establece, se usará el perfil de aprovisionamiento. Puede ser la preferencia de identidad del llavero del certificado o la substring del nombre común del certificado, según la página de man de codesign (IDENTIDADES DE FIRMA).
Etiquetas:action_command_lines
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility
predeterminado: “false”-
Si incompatible_enforce_config_setting_visibility=false, esto es una operación no realizada. De lo contrario, si esta marca es falsa, cualquier config_setting sin un atributo de visibilidad explícito es //visibility:public. Si esta marca es verdadera, config_setting sigue la misma lógica de visibilidad que todas las demás reglas. Consulta https://github.com/bazelbuild/bazel/issues/12933.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_legacy_py_provider
predeterminado: "true"-
No se puede usar y se quitará pronto.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_sdk_frameworks_attributes
predeterminado: “false”-
Si es verdadero, no se permiten los atributos sdk_frameworks y weak_sdk_frameworks en objc_library y objc_import.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
predeterminado: "true"-
Si es verdadero, aplica las restricciones de visibilidad de config_setting. Si es falso, todos los config_setting son visibles para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_objc_alwayslink_by_default
predeterminado: “false”-
Si es verdadero, establece el valor predeterminado como verdadero para los atributos alwayslink en objc_library y objc_import.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_python_disallow_native_rules
predeterminado: “false”-
Cuando 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
,incompatible_change
- Opciones que rigen el comportamiento del entorno de prueba o del ejecutor de pruebas:
--[no]allow_analysis_failures
predeterminado: “false”-
Si es verdadero, una falla de análisis de un objetivo de regla genera la propagación del objetivo 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
,experimental
--analysis_testing_deps_limit=<an integer>
predeterminado: “2000”-
Establece la cantidad máxima de dependencias transitivas a través de un atributo de regla con una transición de configuración for_analysis_testing. Si se supera este límite, se mostrará un error de regla.
Etiquetas:loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure
predeterminado: “false”-
Si es verdadero, las fallas de la acción de dex2oat causarán que la compilación falle en lugar de ejecutar dex2oat durante el tiempo de ejecución de la prueba.
Etiquetas:loading_and_analysis
,experimental
--[no]check_tests_up_to_date
predeterminado: “false”-
No ejecutes pruebas, solo verifica si están actualizadas. Si todos los resultados de las pruebas están actualizados, la prueba se completa correctamente. Si se debe compilar o ejecutar alguna prueba, se informa un error y la prueba falla. Esta opción implica el comportamiento de --check_up_to_date.
Etiquetas:execution
--[no]experimental_android_use_parallel_dex2oat
predeterminado: “false”-
Usa dex2oat en paralelo para acelerar android_test.
Etiquetas:loading_and_analysis
,host_machine_resource_optimizations
,experimental
- Se acumulan varios usos de
--flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once>
. -
Cada prueba se reintentará hasta la cantidad especificada de veces en caso de que falle. Las pruebas que requirieron más de un intento para aprobar se marcan como "FLAKY" en el resumen de la prueba. Por lo general, el valor especificado es solo un número entero o la cadena "default". Si es un número entero, todas las pruebas se ejecutarán hasta N veces. Si es "default", solo se realizará un intento de prueba para las pruebas normales y tres para las pruebas marcadas explícitamente como inestables por su regla (atributo flaky=1). Sintaxis alternativa: regex_filter@flaky_test_attempts. En el que flaky_test_attempts es como se indicó anteriormente y regex_filter representa una lista de patrones de expresiones regulares para incluir y excluir (consulta también --runs_per_test). Ejemplo: --flaky_test_attempts=//foo/.*,-//foo/bar/.*@3 corrige todas las pruebas en //foo/, excepto las de foo/bar, tres veces. Esta opción se puede pasar varias veces. El argumento pasado más recientemente que coincida tiene prioridad. Si no hay coincidencias, el comportamiento es como el de "default" anterior.
Etiquetas:execution
--[no]ios_memleaks
predeterminado: “false”-
Habilita la verificación de fugas de memoria en los destinos de ios_test.
Etiquetas:action_command_lines
--ios_simulator_device=<a string>
predeterminado: Consulta la descripción-
Es el dispositivo que se simula cuando se ejecuta una aplicación para iOS en el simulador, p.ej., "iPhone 6". Para obtener una lista de dispositivos, ejecuta "xcrun simctl list devicetypes" en la máquina en la que se ejecutará el simulador.
Etiquetas:test_runner
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Es la versión de iOS que se ejecutará 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: “auto”-
Es la cantidad máxima de trabajos de prueba locales que se ejecutarán 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 de forma simultánea. Establecer este valor por encima del valor de --jobs no es eficaz.
Etiquetas:execution
- Se acumulan varios usos de
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
. - especifica la cantidad de veces que se debe ejecutar cada prueba. Si alguno de esos intentos falla por algún motivo, se considera que toda la prueba falló. 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 la que runs_per_test representa un valor entero y regex_filter representa una lista de patrones de expresiones regulares para incluir y excluir (consulta también --instrumentation_filter). Ejemplo: --runs_per_test=//foo/.*,-//foo/bar/.*@3 ejecuta todas las pruebas en //foo/, excepto las que se encuentran en foo/bar, tres veces. Esta opción se puede pasar varias veces. El argumento pasado más recientemente que coincida tiene prioridad. Si no hay coincidencias, la prueba solo se ejecuta una vez.
- Se acumulan varios usos de
--test_env=<a 'name=value' assignment with an optional value part>
. -
Especifica variables de entorno adicionales que se insertarán en el entorno del ejecutor de pruebas. Las variables se pueden especificar por nombre, en cuyo caso su valor se leerá del entorno del cliente de Bazel, o por el par nombre=valor. Esta opción se puede usar varias veces para especificar varias variables. Solo lo usa el comando "bazel test".
Etiquetas:test_runner
--[no]test_keep_going
predeterminado: "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
--test_strategy=<a string>
predeterminado: ""-
Especifica qué estrategia usar cuando se ejecutan pruebas.
Etiquetas:execution
--test_timeout=<a single integer or comma-separated list of 4 integers>
predeterminado: “-1”- Anula los valores predeterminados de tiempo de espera de prueba para los tiempos de espera de prueba (en segundos). Si se especifica un solo valor de número entero positivo, se anularán todas las categorías. Si se especifican 4 números enteros separados por comas, se anularán los tiempos de espera para corto, moderado, largo y eterno (en ese orden). De cualquier forma, un valor de -1 le indica a blaze que use sus tiempos de espera predeterminados para esa categoría.
--test_tmpdir=<a path>
predeterminado: Consulta la descripción- Especifica el directorio temporal base que usará "bazel test".
--[no]zip_undeclared_test_outputs
predeterminado: "true"-
Si es verdadero, los resultados de las pruebas no declaradas se archivarán en un archivo ZIP.
Etiquetas:test_runner
- Opciones que activan optimizaciones del tiempo de compilación:
--[no]experimental_filter_library_jar_with_program_jar
predeterminado: “false”-
Filtra el ProgramJar de ProGuard para quitar las clases que también estén presentes en el LibraryJar.
Etiquetas:action_command_lines
--[no]experimental_inmemory_dotd_files
predeterminado: "true"-
Si se habilita, los archivos .d de C++ se pasarán en la memoria directamente desde los nodos de compilación remotos en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_inmemory_jdeps_files
predeterminado: "true"-
Si está habilitado, los archivos de dependencia (.jdeps) generados a partir de compilaciones de Java se pasarán en la memoria directamente desde los nodos de compilación remotos en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_objc_include_scanning
predeterminado: “false”-
Indica si se debe incluir el análisis de C/C++ objetivo.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
--[no]experimental_retain_test_configuration_across_testonly
predeterminado: “false”-
Cuando se habilita, --trim_test_configuration no recortará la configuración de prueba de las reglas marcadas como testonly=1. Esto se hace para reducir los problemas de conflicto de acciones cuando las reglas que no son de prueba dependen de las reglas de cc_test. No tiene efecto si --trim_test_configuration es falso.
Etiquetas:loading_and_analysis
,loses_incremental_state
--[no]experimental_starlark_cc_import
predeterminado: “false”-
Si está habilitada, se puede usar la versión de Starlark de cc_import.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_unsupported_and_brittle_include_scanning
predeterminado: “false”-
Determina si se deben reducir las entradas a la compilación de C/C++ a través del análisis de líneas #include de los archivos de entrada. Esto puede mejorar el rendimiento y la incrementalidad, ya que reduce el tamaño de los árboles de entrada de compilación. Sin embargo, también puede interrumpir las compilaciones porque el escáner de inclusión no implementa por completo la semántica del preprocesador C. En particular, no comprende las directivas #include dinámicas y omite la lógica condicional del preprocesador. Úsala bajo tu propia responsabilidad. Se cerrarán todos los problemas relacionados con esta marca que se hayan presentado.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
--[no]incremental_dexing
predeterminado: "true"-
Realiza la mayor parte del trabajo de dexing por separado para cada archivo JAR.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>
predeterminado: "HOST_CPUS"-
Establece de forma explícita la cantidad total de núcleos de CPU locales disponibles para que Bazel los destine a las acciones de compilación que se ejecutan de forma local. Toma un número entero o "HOST_CPUS", seguido de forma opcional por [-|*]<float> (p. ej., HOST_CPUS*.5 para usar la mitad de los núcleos de CPU disponibles).De forma predeterminada ("HOST_CPUS"), Bazel consultará la configuración del sistema para estimar la cantidad de núcleos de CPU disponibles.
Etiquetas:host_machine_resource_optimizations
- Se acumulan varios usos de
--local_extra_resources=<a named float, 'name=value'>
. -
Establece la cantidad de recursos adicionales disponibles para Bazel. Recibe un par de cadena-número de punto flotante. Se puede usar varias veces para especificar varios tipos de recursos adicionales. Bazel limitará las acciones que se ejecutan de forma simultánea según los recursos adicionales disponibles y los recursos adicionales necesarios. Las pruebas pueden declarar la cantidad de recursos adicionales que necesitan con una etiqueta del formato "resources:<nombre_recurso>:<cantidad>". No se pueden establecer la CPU, la RAM ni los recursos disponibles con esta marca.
Etiquetas:host_machine_resource_optimizations
--local_ram_resources=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
predeterminado: "HOST_RAM*.67"-
Establece de forma explícita la cantidad total de RAM del host local (en MB) disponible para que Bazel la invierta en acciones de compilación que se ejecuten de forma local. Toma un número entero o "HOST_RAM", seguido de forma opcional por [-|*]<float> (p. ej., HOST_RAM*.5 para usar la mitad de la RAM disponible). De forma predeterminada ("HOST_RAM*.67"), Bazel consultará la configuración del sistema para estimar la cantidad de RAM disponible y usará el 67%.
Etiquetas:host_machine_resource_optimizations
--[no]objc_use_dotd_pruning
predeterminado: "true"-
Si se establece, los archivos .d emitidos por clang se usarán para podar el conjunto de entradas que se pasan a las compilaciones de objc.
Etiquetas:changes_inputs
,loading_and_analysis
--[no]process_headers_in_dependencies
predeterminado: “false”-
Cuando compilas un destino //a:a, procesa los encabezados en todos los destinos de los que depende //a:a (si el procesamiento de encabezados está habilitado para la cadena de herramientas).
Etiquetas:execution
--[no]trim_test_configuration
predeterminado: "true"-
Cuando se habilita, se borran las opciones relacionadas con las pruebas debajo del nivel superior de la compilación. Cuando esta marca está activa, las pruebas no se pueden compilar como dependencias de reglas que no son de prueba, pero los cambios en las opciones relacionadas con las pruebas no harán que se vuelvan a analizar las reglas que no son de prueba.
Etiquetas:loading_and_analysis
,loses_incremental_state
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_bep_target_summary
predeterminado: “false”- Determina si se deben publicar eventos TargetSummary.
--[no]experimental_build_event_expand_filesets
predeterminado: “false”-
Si es verdadero, expande los conjuntos de archivos en el BEP cuando se presenten los archivos de salida.
Etiquetas:affects_outputs
--[no]experimental_build_event_fully_resolve_fileset_symlinks
predeterminado: “false”-
Si es verdadero, resuelve completamente los symlinks de conjuntos de archivos relativos en el BEP cuando se presentan archivos de salida. Requiere --experimental_build_event_expand_filesets.
Etiquetas:affects_outputs
--experimental_build_event_upload_max_retries=<an integer>
predeterminado: “4”-
Es la cantidad máxima de veces que Bazel debe volver a intentar subir un evento de compilación.
Etiquetas:bazel_internal_configuration
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
predeterminado: "1s"-
Retraso inicial mínimo para los reintentos de retirada exponencial cuando falla la carga de BEP. (exponente: 1.6)
Etiquetas:bazel_internal_configuration
--experimental_build_event_upload_strategy=<a string>
predeterminado: Consulta la descripción-
Selecciona cómo subir artefactos a los que se hace referencia en el protocolo del evento de compilación.
Etiquetas:affects_outputs
--[no]experimental_materialize_param_files_directly
predeterminado: “false”-
Si materializas archivos de parámetros, hazlo con operaciones de escritura directa en el disco.
Etiquetas:execution
--[no]experimental_run_bep_event_include_residue
predeterminado: “false”-
Indica si se debe incluir el residuo de la línea de comandos en los eventos de compilación de ejecución que podrían contener el residuo. De forma predeterminada, el residuo no se incluye en los eventos de compilación del comando de ejecución que podrían contenerlo.
Etiquetas:affects_outputs
--[no]experimental_stream_log_file_uploads
predeterminado: “false”-
El archivo de registro de transmisión se sube directamente al almacenamiento remoto en lugar de escribirlo en el disco.
Etiquetas:affects_outputs
--explain=<a path>
predeterminado: Consulta la descripción-
Hace que el sistema de compilación explique cada paso ejecutado de la compilación. La explicación se escribe en el archivo de registro especificado.
Etiquetas:affects_outputs
--[no]legacy_important_outputs
predeterminado: "true"-
Usa esto para suprimir la generación del campo important_outputs heredado en el evento TargetComplete. important_outputs es obligatorio para la integración de Bazel en ResultStore.
Etiquetas:affects_outputs
--[no]materialize_param_files
predeterminado: “false”-
Escribe archivos de parámetros intermedios en el árbol de salida, incluso cuando se usa la ejecución de acciones remotas. Es útil cuando se depuran acciones. Esto se implica con --subcommands y --verbose_failures.
Etiquetas:execution
--max_config_changes_to_show=<an integer>
predeterminado: “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 que se proporciona es -1, se mostrarán todas las opciones cambiadas.
Etiquetas:terminal_output
--max_test_output_bytes=<an integer>
predeterminado: “-1”-
Especifica el tamaño máximo de registro por prueba que se puede emitir cuando --test_output es "errors" o "all". Es útil para evitar que el resultado se vea abrumado por un resultado de prueba con demasiado ruido. El encabezado de prueba se incluye en el tamaño del registro. Los valores negativos implican que no hay límite. El resultado es todo o nada.
Etiquetas:test_runner
,terminal_output
,execution
--output_filter=<a valid Java regular expression>
predeterminado: Consulta la descripción-
Solo muestra advertencias y resultados de acciones para reglas con un nombre que coincida con la expresión regular proporcionada.
Etiquetas:affects_outputs
--progress_report_interval=<an integer in 0-3600 range>
predeterminado: “0”-
Es la cantidad de segundos que se debe esperar entre los informes de las tareas que aún se están ejecutando. El valor predeterminado 0 significa que el primer informe se imprimirá después de 10 segundos, luego de 30 segundos y, después de ese progreso, se informará una vez por minuto. Cuando se habilita --curses, el progreso se informa cada segundo.
Etiquetas:affects_outputs
--show_result=<an integer>
predeterminado: “1”-
Muestra los resultados de la compilación. Para cada objetivo, indica si se actualizó o no y, de ser así, una lista de los archivos de salida que se compilaron. Los archivos impresos son cadenas convenientes para copiar y pegar en la shell y ejecutarlas.
Esta opción requiere un argumento de número entero, que es la cantidad de objetivos de umbral por encima de la cual no se imprime la información de los resultados. Por lo tanto, cero causa la supresión del mensaje y MAX_INT hace que la impresión del resultado siempre se produzca. El valor predeterminado es uno.
Si no se compiló nada para un destino, se pueden omitir sus resultados para mantener el resultado por debajo del umbral.
Etiquetas:affects_outputs
--[no]subcommands
[-s
] predeterminado: "false"-
Muestra los subcomandos ejecutados 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 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 la prueba, "errors" para imprimir también los registros de prueba de las pruebas fallidas, "all" para imprimir los registros de todas las pruebas y "streamed" para mostrar los registros de todas las pruebas en tiempo real (esto forzará que las pruebas se ejecuten de forma local de a una a la vez, independientemente del valor de --test_strategy).
Etiquetas:test_runner
,terminal_output
,execution
- Valor predeterminado de
--test_summary=<short, terse, detailed, none or testcase>
: “short” - : Especifica el formato deseado del resumen de la prueba. Los valores válidos son "short" para imprimir información solo sobre las pruebas ejecutadas, "terse" para imprimir información solo sobre las pruebas que no se ejecutaron correctamente, "detailed" para imprimir información detallada sobre los 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 "none" para omitir el resumen.
Etiquetas:terminal_output
- Valor predeterminado de
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: “-.*”. -
Imprime información de depuración durante la resolución de la cadena de herramientas. La marca toma una regex, que se compara con los tipos de cadena de herramientas y los objetivos específicos para ver cuál depurar. Se pueden separar varias regex con comas y, luego, cada una se verifica por separado. Nota: El resultado de esta marca es muy complejo y es probable que solo sea útil para expertos en la resolución de cadenas de herramientas.
Etiquetas:terminal_output
--[no]verbose_explanations
predeterminado: “false”-
Aumenta el nivel de detalle de las explicaciones emitidas si se habilita --explain. No tiene efecto si no se habilita --explain.
Etiquetas:affects_outputs
--[no]verbose_failures
predeterminado: “false”-
Si un comando falla, imprime la línea de comandos completa.
Etiquetas:terminal_output
- Son opciones que especifican o alteran una entrada genérica en un comando de Bazel que no pertenece a otras categorías.:
- Se acumulan varios usos de
--aspects_parameters=<a 'name=value' assignment>
. -
Especifica los valores de los parámetros de aspectos de la línea de comandos. Cada valor de parámetro se especifica mediante <param_name>=<param_value>, por ejemplo, "my_param=my_val", en la que "my_param" es un parámetro de algún aspecto en la lista --aspects o que es obligatorio para 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 varios usos de
--flag_alias=<a 'name=value' flag alias>
. -
Establece un nombre abreviado para una marca de Starlark. Toma un solo par clave-valor en el formato "<clave>=<valor>" como argumento.
Etiquetas:changes_inputs
--[no]incompatible_default_to_explicit_init_py
predeterminado: “false”-
Esta marca cambia el comportamiento predeterminado para que los archivos __init__.py ya no se creen automáticamente en los archivos de ejecución de los destinos de Python. Específicamente, cuando un objetivo py_binary o py_test tiene legacy_create_init establecido en "auto" (el valor predeterminado), se considera falso solo si se establece esta marca. Consulta https://github.com/bazelbuild/bazel/issues/10076.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_py2_outputs_are_suffixed
predeterminado: "true"-
Si es verdadero, los destinos compilados en la configuración de Python 2 aparecerán en una raíz de salida que incluye el sufijo "-py2", mientras que los destinos compilados para Python 3 aparecerán en una raíz sin sufijo relacionado con Python. Esto significa que el symlink de conveniencia "bazel-bin" apuntará a destinos de Python 3 en lugar de Python 2. Si habilitas esta opción, también se recomienda habilitar `--incompatible_py3_is_default`.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_py3_is_default
predeterminado: "true"-
Si es verdadero, los destinos "py_binary" y "py_test" que no establezcan su atributo "python_version" (o "default_python_version") usarán PY3 de forma predeterminada en lugar de PY2. Si estableces esta marca, también se recomienda establecer `--incompatible_py2_outputs_are_suffixed`.
Etiquetas:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_use_python_toolchains
predeterminado: "true"-
Si se establece como verdadero, las reglas ejecutables de Python nativas usarán el entorno de ejecución de Python especificado por la cadena de herramientas de Python, en lugar del entorno de ejecución que proporcionan las marcas heredadas, como --python_top.
Etiquetas:loading_and_analysis
,incompatible_change
--python_version=<PY2 or PY3>
predeterminado: Consulta la descripción-
Es el modo de versión principal de Python, ya sea "PY2" o "PY3". Ten en cuenta que esto se anula con los destinos "py_binary" y "py_test" (incluso si no especifican una versión de forma explícita), por lo que, por lo general, no hay muchos motivos para proporcionar esta marca.
Etiquetas:loading_and_analysis
,affects_outputs
--target_pattern_file=<a string>
predeterminado: ""-
Si se establece, la compilación leerá patrones del archivo que se nombra aquí, en lugar de la línea de comandos. Es un error especificar un archivo aquí, así como patrones de línea de comandos.
Etiquetas:changes_inputs
- Opciones de almacenamiento en caché y ejecución remotas:
--experimental_remote_cache_eviction_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos que se pueden realizar 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 verdadero. Se generará un ID de invocación nuevo para cada intento. Si generas un ID de invocación y se lo proporcionas a Bazel con --invocation_id, no debes usar esta marca. En su lugar, establece la marca --incompatible_remote_use_new_exit_code_for_lost_inputs y busca el código de salida 39.
Etiquetas:execution
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
predeterminado: "true"-
Si se establece como verdadero, Bazel usará el nuevo código de salida 39 en lugar de 34 si la caché remota desaloja blobs durante la compilación.
Etiquetas:incompatible_change
- Opciones misceláneas que no se clasifican de otra manera:
--[no]allow_analysis_cache_discard
predeterminado: "true"-
Si se descarta la caché de análisis debido a un cambio en el sistema de compilación, configurar esta opción como falsa hará que bazel se cierre, en lugar de continuar con la compilación. Esta opción no tiene efecto cuando también se establece "discard_analysis_cache".
Etiquetas:eagerness_to_exit
--[no]build_manual_tests
predeterminado: “false”- Forza la compilación de los destinos de prueba etiquetados como "manual". Las pruebas "manuales" se excluyen del procesamiento. Esta opción los obliga a compilarse (pero no a ejecutarse).
--build_tag_filters=<comma-separated list of options>
predeterminado: ""- Especifica una lista de etiquetas separadas por comas. De manera opcional, cada etiqueta puede ir precedida de "-" para especificar las etiquetas excluidas. Solo se compilarán los destinos que contengan al menos una etiqueta incluida y no contengan ninguna etiqueta excluida. Esta opción no afecta el conjunto de pruebas que se ejecutan con el comando "test", ya que se rigen por las opciones de filtrado de pruebas, por ejemplo, "--test_tag_filters".
--[no]build_tests_only
predeterminado: “false”- Si se especifica, solo se compilarán las reglas *_test y test_suite, y se ignorarán los otros objetivos especificados en la línea de comandos. De forma predeterminada, se compilará todo lo que se solicitó.
--[no]cache_test_results
[-t
] predeterminado: "auto"- Si se establece en “auto”, Bazel vuelve a ejecutar una prueba solo si se cumplen las siguientes condiciones: (1) Bazel detecta cambios en la prueba o sus dependencias, (2) la prueba está marcada como externa, (3) se solicitaron varias ejecuciones de prueba con --runs_per_test o(4) la prueba falló anteriormente. Si se establece como “sí”, Bazel almacena en caché todos los resultados de las pruebas, excepto las marcadas como externas. Si se establece en "no", Bazel no almacena en caché ningún resultado de la prueba.
--[no]compile_one_dependency
predeterminado: “false”- Compila una sola dependencia de los archivos de argumentos. Esto es útil para verificar la sintaxis de los archivos fuente en IDEs, por ejemplo, cuando se vuelve a compilar un solo destino que depende del archivo fuente para detectar errores lo antes posible en el ciclo de edición, compilación y prueba. Este argumento afecta la forma en que se interpretan todos los argumentos que no son de marca. En lugar de ser objetivos para compilar, son nombres de archivos de origen. Para cada nombre de archivo de origen, se compilará un destino arbitrario que depende de él.
- Se acumulan varios usos de
--deleted_packages=<comma-separated list of package names>
. - Es una lista separada por comas de nombres de paquetes que el sistema de compilación considerará inexistentes, incluso si son visibles en algún lugar de la ruta de acceso del paquete. Usa esta opción cuando borres un subpaquete "x/y" de un paquete existente "x". Por ejemplo, después de borrar x/y/BUILD en tu cliente, es posible que el sistema de compilación se queje si encuentra una etiqueta "//x:y/z" si otra entrada de package_path aún la proporciona. Especificar --deleted_packages x/y evita este problema.
--[no]discard_analysis_cache
predeterminado: “false”- Descarta la caché de análisis inmediatamente después de que se complete la fase de análisis. Reduce el uso de memoria en un 10% aproximadamente, pero ralentiza las compilaciones incrementales posteriores.
--execution_log_binary_file=<a path>
predeterminado: Consulta la descripción- Registra los inicios ejecutados en este archivo como protos de inicio 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) y --subcommands (para mostrar subcomandos en el resultado de la terminal).
--execution_log_json_file=<a path>
predeterminado: Consulta la descripción- Registra los inicios ejecutados en este archivo como una representación JSON de los protos de inicio delimitados, según src/main/protobuf/spawn.proto. Marcas relacionadas: --execution_log_binary_file (formato protobuf binario; mutuamente excluyente), --execution_log_sort (si se debe ordenar el registro de ejecución) y --subcommands (para mostrar subcomandos en el resultado de la terminal).
--[no]execution_log_sort
predeterminado: "true"- Indica si se debe ordenar el registro de ejecución, lo que facilita la comparación de registros entre invocaciones. Se establece en "false" para evitar un uso potencialmente significativo de la CPU y la memoria al final de la invocación, a costa de producir el registro en orden de ejecución no determinista.
--[no]expand_test_suites
predeterminado: "true"-
Expande los objetivos de test_suite en sus pruebas constituyentes antes del análisis. Cuando esta marca esté activada (la opción predeterminada), se aplicarán patrones de destino negativos a las pruebas que pertenecen al paquete de pruebas; de lo contrario, no se aplicarán. Desactivar esta marca es útil cuando se aplican aspectos de nivel superior en la línea de comandos: luego, pueden analizar los destinos de test_suite.
Etiquetas:loading_and_analysis
--[no]experimental_cancel_concurrent_tests
predeterminado: “false”-
Si es verdadero, Blaze cancelará las pruebas que se ejecutan de forma simultánea en la primera ejecución correcta. Esto solo es útil en combinación con --runs_per_test_detects_flakes.
Etiquetas:affects_outputs
,loading_and_analysis
--experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
predeterminado: ""- dejó de estar disponible y se reemplazó por aspectos. Filtra el conjunto de objetivos para los que se programarán las extra_actions.
--[no]experimental_extra_action_top_level_only
predeterminado: “false”- dejó de estar disponible y se reemplazó por aspectos. Solo programa extra_actions para los objetivos de nivel superior.
--[no]experimental_fetch_all_coverage_outputs
predeterminado: “false”-
Si es verdadero, Bazel recupera todo el directorio de datos de cobertura para cada prueba durante una ejecución de cobertura.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_generate_llvm_lcov
predeterminado: “false”-
Si es verdadero, la cobertura de clang generará un informe LCOV.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_j2objc_header_map
predeterminado: "true"- Determina si se debe generar un mapa de encabezados de J2ObjC en paralelo con la transpilación de J2ObjC.
--[no]experimental_j2objc_shorter_header_path
predeterminado: “false”-
Indica si se debe generar con una ruta de encabezado más corta (usa “_ios” en lugar de “_j2objc”).
Etiquetas:affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
predeterminado: "javabuilder"- Habilita classpaths reducidos para compilaciones de Java.
--[no]experimental_limit_android_lint_to_android_constrained_java
predeterminado: “false”-
Limita --experimental_run_android_lint_on_java_rules a las bibliotecas compatibles con Android.
Etiquetas:affects_outputs
--[no]experimental_run_android_lint_on_java_rules
predeterminado: “false”-
Determina si se deben validar las fuentes java_*.
Etiquetas:affects_outputs
--[no]explicit_java_test_deps
predeterminado: “false”- Especifica de forma explícita una dependencia a JUnit o Hamcrest en un java_test en lugar de obtenerla accidentalmente de las dependencias de TestRunner. Por el momento, solo funciona para bazel.
--host_java_launcher=<a build target label>
predeterminado: Consulta la descripción- Es el selector de Java que usan las herramientas que se ejecutan durante una compilación.
- Se acumulan varios usos de
--host_javacopt=<a string>
. - Opciones adicionales para pasar a javac cuando se compilan herramientas que se ejecutan durante una compilación.
- Se acumulan varios usos de
--host_jvmopt=<a string>
. - Opciones adicionales para pasar a la VM de Java cuando se compilan herramientas que se ejecutan durante la compilación. Estas opciones se agregarán a las opciones de inicio de la VM de cada destino java_binary.
--[no]incompatible_check_sharding_support
predeterminado: "true"-
Si es verdadero, Bazel fallará en una prueba fragmentada si el ejecutor de pruebas no indica que admite el fragmentación tocando el archivo en la ruta de acceso en TEST_SHARD_STATUS_FILE. Si es falso, un ejecutor de pruebas que no admita la fragmentación hará que todas las pruebas se ejecuten en cada fragmento.
Etiquetas:incompatible_change
--[no]incompatible_exclusive_test_sandboxed
predeterminado: "true"-
Si es verdadero, las pruebas exclusivas se ejecutarán con la estrategia de zona de pruebas. Agrega la etiqueta "local" para forzar que se ejecute una prueba exclusiva de forma local.
Etiquetas:incompatible_change
--[no]incompatible_strict_action_env
predeterminado: “false”-
Si es verdadero, Bazel usa un entorno con un valor estático para PATH y no hereda LD_LIBRARY_PATH. Usa --action_env=ENV_VARIABLE si deseas heredar variables de entorno específicas del cliente, pero ten en cuenta que, de esta manera, se puede evitar la caché entre usuarios si se usa una caché compartida.
Etiquetas:loading_and_analysis
,incompatible_change
- Se acumulan varios usos de
--j2objc_translation_flags=<comma-separated list of options>
. - : Opciones adicionales para pasar a la herramienta J2ObjC.
--java_debug
-
Hace que la máquina virtual de Java de una prueba de Java espere una conexión de un depurador compatible con JDWP (como jdb) antes de iniciar la prueba. Implica -test_output=streamed.
Se expande a:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
--[no]java_deps
predeterminado: "true"- Genera información de dependencia (por ahora, el classpath del tiempo de compilación) por destino de Java.
--[no]java_header_compilation
predeterminado: "true"- Compila ijars directamente desde la fuente.
--java_language_version=<a string>
predeterminado: ""- La versión del lenguaje Java
--java_launcher=<a build target label>
predeterminado: Consulta la descripción- Es el selector de Java que se usará cuando se compilen objetos binarios de Java. Si esta marca se establece en la cadena vacía, se usa el selector de JDK. El atributo "launcher" anula esta marca.
--java_runtime_version=<a string>
predeterminado: "local_jdk"- La versión del entorno de ejecución de Java
- Se acumulan varios usos de
--javacopt=<a string>
. - Opciones adicionales para pasar a javac.
- Se acumulan varios usos de
--jvmopt=<a string>
. - Opciones adicionales para pasar a la VM de Java. Estas opciones se agregarán a las opciones de inicio de la VM de cada destino java_binary.
--legacy_main_dex_list_generator=<a build target label>
predeterminado: Consulta la descripción- especifica un objeto binario que se usará para generar la lista de clases que deben estar en el archivo DEX principal cuando se compila el multidex heredado.
--local_termination_grace_seconds=<an integer>
predeterminado: “15”- Es el tiempo de espera entre la finalización de un proceso local debido al tiempo de espera y su cierre forzoso.
--optimizing_dexer=<a build target label>
predeterminado: Consulta la descripción- Especifica un objeto binario para usar y realizar la conversión a Dex sin fragmentación.
--package_path=<colon-separated list of options>
predeterminado: "%workspace%"- Es una lista separada por dos puntos de dónde buscar paquetes. Los elementos que comienzan con "%workspace%" son relativos al lugar 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 varios usos de
--plugin=<a build target label>
. - Plug-ins para usar en la compilación. Actualmente, funciona con java_plugin.
--proguard_top=<a build target label>
predeterminado: Consulta la descripción- Especifica qué versión de ProGuard se usará para quitar el código cuando se compila un objeto binario de Java.
--proto_compiler=<a build target label>
predeterminado: "@bazel_tools//tools/proto:protoc"-
Es la etiqueta del protocompilador.
Etiquetas:affects_outputs
,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
,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 de j2objc
Etiquetas:affects_outputs
,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
,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
,loading_and_analysis
- Se acumulan varios usos de
--protocopt=<a string>
. -
Opciones adicionales para pasar al compilador de protobuf.
Etiquetas:affects_outputs
--[no]runs_per_test_detects_flakes
predeterminado: “false”- Si es verdadero, cualquier fragmento en el que se apruebe al menos una ejecución o intento y falle al menos una ejecución o intento tendrá el estado FLAKY.
--shell_executable=<a path>
predeterminado: Consulta la descripción-
Ruta de acceso absoluta al ejecutable de shell que usará Bazel. Si no se establece, pero la variable de entorno BAZEL_SH se establece en la primera invocación de Bazel (que inicia un servidor de Bazel), Bazel la usará. Si no se establece ninguno, Bazel usa una ruta de acceso predeterminada fija según el sistema operativo en el que se ejecuta (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, todos los demás: /bin/bash). Ten en cuenta que usar un shell que no sea compatible con bash puede generar fallas de compilación o de tiempo de ejecución de los objetos binarios generados.
Etiquetas:loading_and_analysis
--[no]show_loading_progress
predeterminado: "true"- Si está habilitado, hace que Bazel imprima mensajes de "Carga del paquete:".
- Se acumulan varios usos de
--test_arg=<a string>
. - Especifica opciones y argumentos adicionales que se deben pasar al ejecutable de prueba. Se puede usar varias veces para especificar varios argumentos. Si se ejecutan varias pruebas, cada una de ellas recibirá argumentos idénticos. Solo lo usa el comando "bazel test".
--test_filter=<a string>
predeterminado: Consulta la descripción- : Especifica un filtro para reenviar al framework de pruebas. Se usa para limitar las pruebas que se ejecutan. Ten en cuenta que esto no afecta los destinos que se compilan.
--test_lang_filters=<comma-separated list of options>
predeterminado: ""- Especifica una lista de idiomas de prueba separados por comas. De manera opcional, cada idioma puede ir precedido de “-” para especificar los idiomas excluidos. Solo se encontrarán los objetivos de prueba que estén escritos en los idiomas especificados. El nombre que se usa para cada idioma debe ser el mismo que el prefijo de idioma en la regla *_test, p.ej., uno de "cc", "java", "py", etc. Esta opción afecta el comportamiento de --build_tests_only y el comando test.
--test_result_expiration=<an integer>
predeterminado: “-1”- Esta opción está obsoleta y no tiene ningún efecto.
--[no]test_runner_fail_fast
predeterminado: “false”- Redirecciona la opción de falla rápida al ejecutor de pruebas. El ejecutor de pruebas debe detener la ejecución en la primera falla.
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>
predeterminado: "explicit"- Especifica la estrategia para el fragmentación de prueba: "explicit" para usar solo la fragmentación si está presente el atributo BUILD "shard_count". "disabled" para nunca usar el fragmentación de prueba. "forced=k" para aplicar fragmentos "k" para las pruebas, independientemente del atributo BUILD "shard_count".
--test_size_filters=<comma-separated list of values: small, medium, large or enormous>
predeterminado: ""- Especifica una lista de tamaños de prueba separados por comas. De manera opcional, cada tamaño puede ir precedido de "-" para especificar los tamaños excluidos. Solo se encontrarán los objetivos de prueba que contengan al menos un tamaño incluido y no contengan ningún tamaño excluido. Esta opción afecta el comportamiento de --build_tests_only y el comando test.
--test_tag_filters=<comma-separated list of options>
predeterminado: ""- Especifica una lista de etiquetas de prueba separadas por comas. De manera opcional, cada etiqueta puede ir precedida de "-" para especificar las etiquetas excluidas. Solo se encontrarán los objetivos de prueba que contengan al menos una etiqueta incluida y no contengan ninguna etiqueta excluida. Esta opción afecta el comportamiento de --build_tests_only y el comando test.
--test_timeout_filters=<comma-separated list of values: short, moderate, long or eternal>
predeterminado: ""- Especifica una lista de tiempos de espera de prueba separados por comas. De manera opcional, cada tiempo de espera puede ir precedido de "-" para especificar los tiempos de espera excluidos. Solo se encontrarán los objetivos de prueba que contengan al menos un tiempo de espera incluido y no contengan tiempos de espera excluidos. Esta opción afecta el comportamiento de --build_tests_only y el comando test.
--tool_java_language_version=<a string>
predeterminado: ""- La versión del 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
--[no]use_ijars
predeterminado: "true"- Si está habilitada, esta opción hace que la compilación de Java use archivos JAR de interfaz. Esto generará una compilación incremental más rápida, pero los mensajes de error pueden ser diferentes.
Opciones de canonicalize-flags
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
. -
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, se puede hacer que los repositorios externos funcionen en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_connector_attempts=<an integer>
predeterminado: “8”-
Es la cantidad máxima de intentos de descargas HTTP.
Etiquetas:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
predeterminado: “0s”-
Es el tiempo de espera máximo para los reintentos de descarga HTTP. Con un valor de 0, no se define un tiempo de espera máximo.
Etiquetas:bazel_internal_configuration
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la 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, se usa el valor predeterminado de '<output_user_root>/cache/repos/v1'.
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
predeterminado: “false”-
Si se establece, 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 se inhabilita por completo; 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 la compilación:
--gc_thrashing_threshold=<an integer in 0-100 range>
predeterminado: "100"-
Es el porcentaje de espacio ocupado (de 0 a 100) por encima del cual GcThrashingDetector considera los eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, se inhabilita GcThrashingDetector.
Etiquetas:host_machine_resource_optimizations
- Opciones que controlan el resultado del comando:
--[no]canonicalize_policy
predeterminado: “false”-
Muestra la política canónica después de la expansión y el filtrado. Para mantener el resultado limpio, NO se mostrarán los argumentos de comando canonizados cuando esta opción se establezca como verdadera. Ten en cuenta que el comando especificado por --for_command afecta a la política filtrada y, si no se especifica ninguno, el comando predeterminado es "build".
Etiquetas:affects_outputs
,terminal_output
--[no]experimental_include_default_values
predeterminado: “false”-
Indica si las opciones de Starlark configuradas en sus valores predeterminados se incluyen en el resultado.
Etiquetas:affects_outputs
,terminal_output
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility
predeterminado: “false”-
Si incompatible_enforce_config_setting_visibility=false, esto es una operación no realizada. De lo contrario, si esta marca es falsa, cualquier config_setting sin un atributo de visibilidad explícito es //visibility:public. Si esta marca es verdadera, config_setting sigue la misma lógica de visibilidad que todas las demás reglas. Consulta https://github.com/bazelbuild/bazel/issues/12933.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
predeterminado: "true"-
Si es verdadero, aplica las restricciones de visibilidad de config_setting. Si es falso, todos los config_setting son visibles para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
. -
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitadas en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "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 un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
predeterminado: “update”- especifica cómo usar el archivo de bloqueo y si se debe usar o no. 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 mostrar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
. - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso proporcionada es una ruta de acceso absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta de acceso relativa, se hará referencia al directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace".
- Se acumulan varios usos de
--registry=<a string>
. -
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los 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 haga que Bazel falle con un error de OOM. Cada límite se especifica como <period>:<count>, en el que period es una duración y count es un número entero positivo. Si más del porcentaje --gc_thrashing_threshold del espacio a perpetuidad (heap de generación anterior) permanece ocupado después de <count> GC completas consecutivas en <period>, se activa un error de OOM. Se pueden especificar varios límites separados por comas.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Es una marca para la configuración avanzada del motor Skyframe interno 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 GC completo, se descartará el estado temporal innecesario de Skyframe hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC completos nunca activarán las bajadas. 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"-
Es una marca para la configuración avanzada del motor Skyframe interno 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 GC menor, se descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC menores nunca activarán las bajadas. 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
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es de al menos este límite, descartará el estado temporal innecesario de Skyframe. Si ajustas este parámetro, es posible que puedas mitigar el impacto del tiempo de ejecución de la fragmentación de GC, cuando esta se produce (i) por el uso de memoria de este estado temporal y (ii) es más costoso 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:
--[no]experimental_command_profile
predeterminado: “false”- Graba un perfil de CPU de Java Flight Recorder en un archivo profile.jfr en el directorio base de salida. La sintaxis y la semántica de esta marca pueden cambiar en el futuro para admitir diferentes tipos de perfiles o formatos de salida. Úsala bajo tu propio riesgo.
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
- Opciones que especifican o alteran una entrada genérica a un comando de Bazel que no se incluye en otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
--for_command=<a string>
predeterminado: "build"-
Es el comando para el que se deben canonizar las opciones.
Etiquetas:affects_outputs
,terminal_output
--invocation_policy=<a string>
predeterminado: ""-
Aplica una política de invocación a las opciones que se van a canónicar.
Etiquetas:affects_outputs
,terminal_output
- Opciones de almacenamiento en caché y ejecución remotas:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite"), seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
--experimental_worker_for_repo_fetching=<off, platform or virtual>
predeterminado: "off"- Es el modo de subprocesos que se usará para recuperar el repo. Si se establece en "desactivado", no se usa ningún subproceso de trabajo y la recuperación del repo está sujeta a reinicios. De lo contrario, usa un subproceso de plataforma (es decir, un subproceso del SO) si se establece en "platform" o un subproceso virtual si se establece en "virtual".
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--deleted_packages=<comma-separated list of package names>
. - Es una lista separada por comas de nombres de paquetes que el sistema de compilación considerará inexistentes, incluso si son visibles en algún lugar de la ruta de acceso del paquete. Usa esta opción cuando borres un subpaquete "x/y" de un paquete existente "x". Por ejemplo, después de borrar x/y/BUILD en tu cliente, es posible que el sistema de compilación se queje si encuentra una etiqueta "//x:y/z" si otra entrada de package_path aún la proporciona. Especificar --deleted_packages x/y evita este problema.
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
. - Anula un repositorio con una ruta de acceso local en el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es una ruta absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta relativa, se relaciona con el directorio de trabajo actual. Si la ruta de acceso determinada 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%"- Es una lista separada por dos puntos de dónde buscar paquetes. Los elementos que comienzan con "%workspace%" son relativos al lugar de trabajo que los contiene. Si se omite o está vacío, el valor predeterminado es el resultado de "bazel info default-package-path".
--[no]show_loading_progress
predeterminado: "true"- Si está habilitado, hace que Bazel imprima mensajes de "Carga del paquete:".
Opciones de limpieza
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
. -
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, se puede hacer que los repositorios externos funcionen en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_connector_attempts=<an integer>
predeterminado: “8”-
Es la cantidad máxima de intentos de descargas HTTP.
Etiquetas:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
predeterminado: “0s”-
Es el tiempo de espera máximo para los reintentos de descarga HTTP. Con un valor de 0, no se define un tiempo de espera máximo.
Etiquetas:bazel_internal_configuration
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la 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, se usa el valor predeterminado de '<output_user_root>/cache/repos/v1'.
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
predeterminado: “false”-
Si se establece, 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 se inhabilita por completo; 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 la compilación:
--gc_thrashing_threshold=<an integer in 0-100 range>
predeterminado: "100"-
Es el porcentaje de espacio ocupado (de 0 a 100) por encima del cual GcThrashingDetector considera los eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, se inhabilita GcThrashingDetector.
Etiquetas:host_machine_resource_optimizations
- Opciones que controlan el resultado del comando:
--[no]async
predeterminado: “false”-
Si es verdadero, la limpieza de salida 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
--[no]expunge
predeterminado: “false”-
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 está en ejecución.
Etiquetas:host_machine_resource_optimizations
--expunge_async
-
Si se especifica, clean quita de forma asíncrona todo el árbol de trabajo de esta instancia de Bazel, lo que incluye todos los archivos de salida temporales y de compilación creados por Bazel, y detiene el servidor de Bazel si está en ejecución. 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 el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
. -
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitadas en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "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 un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
predeterminado: “update”- especifica cómo usar el archivo de bloqueo y si se debe usar o no. 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 mostrar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
. - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso proporcionada es una ruta de acceso absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta de acceso relativa, se hará referencia al directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace".
- Se acumulan varios usos de
--registry=<a string>
. -
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los 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 haga que Bazel falle con un error de OOM. Cada límite se especifica como <period>:<count>, en el que period es una duración y count es un número entero positivo. Si más del porcentaje --gc_thrashing_threshold del espacio a perpetuidad (heap de generación anterior) permanece ocupado después de <count> GC completas consecutivas en <period>, se activa un error de OOM. Se pueden especificar varios límites separados por comas.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Es una marca para la configuración avanzada del motor Skyframe interno 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 GC completo, se descartará el estado temporal innecesario de Skyframe hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC completos nunca activarán las bajadas. 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"-
Es una marca para la configuración avanzada del motor Skyframe interno 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 GC menor, se descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC menores nunca activarán las bajadas. 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
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es de al menos este límite, descartará el estado temporal innecesario de Skyframe. Si ajustas este parámetro, es posible que puedas mitigar el impacto del tiempo de ejecución de la fragmentación de GC, cuando esta se produce (i) por el uso de memoria de este estado temporal y (ii) es más costoso 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:
--[no]experimental_command_profile
predeterminado: “false”- Graba un perfil de CPU de Java Flight Recorder en un archivo profile.jfr en el directorio base de salida. La sintaxis y la semántica de esta marca pueden cambiar en el futuro para admitir diferentes tipos de perfiles o formatos de salida. Úsala bajo tu propio riesgo.
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
- Opciones que especifican o alteran una entrada genérica a un comando de Bazel que no se incluye en otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de almacenamiento en caché y ejecución remotas:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite"), seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
--experimental_worker_for_repo_fetching=<off, platform or virtual>
predeterminado: "off"- Es el modo de subprocesos que se usará para recuperar el repo. Si se establece en "desactivado", no se usa ningún subproceso de trabajo y la recuperación del repo está sujeta a reinicios. De lo contrario, usa un subproceso de plataforma (es decir, un subproceso del SO) si se establece en "platform" o un subproceso virtual si se establece en "virtual".
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
. - Anula un repositorio con una ruta de acceso local en el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es una ruta absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta relativa, se relaciona con el directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace".
Config Options
Opciones de cobertura
Hereda todas las opciones de test.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
. -
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, se puede hacer que los repositorios externos funcionen en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_connector_attempts=<an integer>
predeterminado: “8”-
Es la cantidad máxima de intentos de descargas HTTP.
Etiquetas:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
predeterminado: “0s”-
Es el tiempo de espera máximo para los reintentos de descarga HTTP. Con un valor de 0, no se define un tiempo de espera máximo.
Etiquetas:bazel_internal_configuration
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la 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, se usa el valor predeterminado de '<output_user_root>/cache/repos/v1'.
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
predeterminado: “false”-
Si se establece, 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 se inhabilita por completo; 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 la compilación:
--gc_thrashing_threshold=<an integer in 0-100 range>
predeterminado: "100"-
Es el porcentaje de espacio ocupado (de 0 a 100) por encima del cual GcThrashingDetector considera los eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, se inhabilita GcThrashingDetector.
Etiquetas:host_machine_resource_optimizations
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
. -
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitadas en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "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 un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
predeterminado: “update”- especifica cómo usar el archivo de bloqueo y si se debe usar o no. 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 mostrar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
. - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso proporcionada es una ruta de acceso absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta de acceso relativa, se hará referencia al directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace".
- Se acumulan varios usos de
--registry=<a string>
. -
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los 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 haga que Bazel falle con un error de OOM. Cada límite se especifica como <period>:<count>, en el que period es una duración y count es un número entero positivo. Si más del porcentaje --gc_thrashing_threshold del espacio a perpetuidad (heap de generación anterior) permanece ocupado después de <count> GC completas consecutivas en <period>, se activa un error de OOM. Se pueden especificar varios límites separados por comas.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Es una marca para la configuración avanzada del motor Skyframe interno 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 GC completo, se descartará el estado temporal innecesario de Skyframe hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC completos nunca activarán las bajadas. 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"-
Es una marca para la configuración avanzada del motor Skyframe interno 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 GC menor, se descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC menores nunca activarán las bajadas. 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
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es de al menos este límite, descartará el estado temporal innecesario de Skyframe. Si ajustas este parámetro, es posible que puedas mitigar el impacto del tiempo de ejecución de la fragmentación de GC, cuando esta se produce (i) por el uso de memoria de este estado temporal y (ii) es más costoso 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:
--[no]experimental_command_profile
predeterminado: “false”- Graba un perfil de CPU de Java Flight Recorder en un archivo profile.jfr en el directorio base de salida. La sintaxis y la semántica de esta marca pueden cambiar en el futuro para admitir diferentes tipos de perfiles o formatos de salida. Úsala bajo tu propio riesgo.
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
- Opciones que especifican o alteran una entrada genérica a un comando de Bazel que no se incluye en otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite"), seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
--experimental_worker_for_repo_fetching=<off, platform or virtual>
predeterminado: "off"- Es el modo de subprocesos que se usará para recuperar el repo. Si se establece en "desactivado", no se usa ningún subproceso de trabajo y la recuperación del repo está sujeta a reinicios. De lo contrario, usa un subproceso de plataforma (es decir, un subproceso del SO) si se establece en "platform" o un subproceso virtual si se establece en "virtual".
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
. - Anula un repositorio con una ruta de acceso local en el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es una ruta absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta relativa, se relaciona con el directorio de trabajo actual. Si la ruta de acceso determinada 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 varios usos de
--distdir=<a path>
. -
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, se puede hacer que los repositorios externos funcionen en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_connector_attempts=<an integer>
predeterminado: “8”-
Es la cantidad máxima de intentos de descargas HTTP.
Etiquetas:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
predeterminado: “0s”-
Es el tiempo de espera máximo para los reintentos de descarga HTTP. Con un valor de 0, no se define un tiempo de espera máximo.
Etiquetas:bazel_internal_configuration
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la 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, se usa el valor predeterminado de '<output_user_root>/cache/repos/v1'.
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
predeterminado: “false”-
Si se establece, 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 se inhabilita por completo; 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 la compilación:
--gc_thrashing_threshold=<an integer in 0-100 range>
predeterminado: "100"-
Es el porcentaje de espacio ocupado (de 0 a 100) por encima del cual GcThrashingDetector considera los eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, se inhabilita GcThrashingDetector.
Etiquetas:host_machine_resource_optimizations
- Opciones relacionadas con el resultado de la consulta y la semántica:
--aspect_deps=<off, conservative or precise>
predeterminado: "conservador"-
Cómo resolver las dependencias de aspecto cuando el formato de salida es uno de {xml,proto,record}. "Desactivado" significa que no se resuelven las dependencias de aspecto. "Conservador" (la opción predeterminada) significa que se agregan todas las dependencias de aspecto declaradas, independientemente de si se les asigna la clase de regla de dependencias directas. "Preciso" significa que solo se agregan los aspectos que pueden estar activos según la clase de regla de las dependencias directas. Ten en cuenta que el modo preciso requiere la carga de otros paquetes para evaluar un solo objetivo, lo que lo hace más lento que los otros modos. Ten en cuenta también que incluso el modo preciso no es del todo preciso: la decisión de si calcular un aspecto se toma en la fase de análisis, que no se ejecuta durante la "consulta de bazel".
Etiquetas:build_file_semantics
--[no]consistent_labels
predeterminado: “false”-
Si está habilitada, cada comando de consulta emite etiquetas como si fuera la función Starlark <code>str</code> aplicada a una instancia de <code>Label</code>. Esto es útil para las herramientas que deben coincidir con el resultado de diferentes comandos de consulta o etiquetas que emiten las reglas. Si no están habilitados, los formateadores de salida pueden emitir nombres de repositorio aparentes (en relación con el repositorio principal) para que el resultado sea más legible.
Etiquetas:terminal_output
--[no]graph:factored
predeterminado: "true"-
Si es verdadero, el gráfico se emitirá "factorizado", es decir, los nodos topológicamente equivalentes se combinarán y sus etiquetas se concatenarán. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--graph:node_limit=<an integer>
predeterminado: “512”-
Es la longitud máxima de la cadena de etiqueta para un nodo de gráfico en el resultado. Las etiquetas más largas se truncarán. -1 significa que no se truncará. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--[no]implicit_deps
predeterminado: "true"-
Si está habilitada, se incluirán dependencias implícitas en el gráfico de dependencias sobre el que opera la consulta. Una dependencia implícita es aquella que no se especifica de forma explícita en el archivo BUILD, pero que Bazel agrega. En el caso de cquery, esta opción controla el filtrado de cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
--[no]include_aspects
predeterminado: "true"-
aquery, cquery: Indica si se deben incluir acciones generadas por aspectos en el resultado. query: No-op (siempre se siguen los aspectos).
Etiquetas:terminal_output
--[no]incompatible_package_group_includes_double_slash
predeterminado: "true"-
Si está habilitada, cuando se genere el atributo "packages" de package_group, no se omitirá el "//" inicial.
Etiquetas:terminal_output
,incompatible_change
--[no]infer_universe_scope
predeterminado: “false”-
Si se establece y no se establece --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 el valor de --universe_scope inferido para una expresión de consulta que usa funciones centradas en el universo (p.ej., "allrdeps") puede no ser lo que deseas, 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 establece --universe_scope, se ignora el valor de esta opción. Nota: Esta opción solo se aplica a "query" (es decir, no a "cquery").
Etiquetas:loading_and_analysis
--[no]line_terminator_null
predeterminado: “false”-
Indica si cada formato finaliza con \0 en lugar de una línea nueva.
Etiquetas:terminal_output
--[no]nodep_deps
predeterminado: "true"-
Si está habilitada, las dependencias de los atributos "nodep" se incluirán en el gráfico de dependencias sobre el que opera la consulta. Un ejemplo común de un atributo "nodep" es "visibility". Ejecuta y analiza el resultado de "info build-language" para obtener información sobre todos los atributos "nodep" en el lenguaje de compilación.
Etiquetas:build_file_semantics
--output=<a string>
predeterminado: "label"-
Es el formato en el que se deben imprimir los resultados de cquery. Los valores permitidos para cquery son: etiqueta, etiqueta_tipo, textoproto, transiciones, proto, proto_transmitido y jsonproto. Si seleccionas "transiciones", también debes especificar la opción --transitions=(lite|full).
Etiquetas:terminal_output
--[no]proto:default_values
predeterminado: "true"-
Si es verdadero, se incluyen los atributos cuyo valor no se especifica de forma explícita en el archivo BUILD; de lo contrario, se omiten. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
--[no]proto:definition_stack
predeterminado: “false”-
Propaga el campo proto definition_stack, que registra para cada instancia de regla la pila de llamadas de Starlark en el momento en que se definió la clase de la regla.
Etiquetas:terminal_output
--[no]proto:flatten_selects
predeterminado: "true"-
Si está habilitada, los atributos configurables creados por select() se aplanan. En el caso de los tipos de lista, la representación aplanada es una lista que contiene cada valor del mapa de selección exactamente una vez. Los tipos escalares se aplanan a nulos.
Etiquetas:build_file_semantics
--[no]proto:include_attribute_source_aspects
predeterminado: “false”-
Propaga el campo proto source_aspect_name de cada atributo con el aspecto de origen del que proviene el atributo (cadena vacía si no es así).
Etiquetas:terminal_output
--[no]proto:include_configurations
predeterminado: "true"-
Si está habilitado, el resultado de proto incluirá información sobre las configuraciones. Cuando se inhabilita,el formato de salida de cquery proto se asemeja al formato de salida de la consulta.
Etiquetas:affects_outputs
--[no]proto:include_synthetic_attribute_hash
predeterminado: “false”-
Indica si se debe calcular y propagar el atributo $internal_attr_hash.
Etiquetas:terminal_output
--[no]proto:instantiation_stack
predeterminado: “false”-
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
--[no]proto:locations
predeterminado: "true"-
Indica si se debe generar información de ubicación en el resultado de proto.
Etiquetas:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
predeterminado: “all”-
Es una lista de atributos separados por comas que se incluirán en el resultado. La configuración predeterminada es todos los atributos. Se establece en una cadena vacía para no mostrar ningún atributo. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
--[no]proto:rule_inputs_and_outputs
predeterminado: "true"-
Indica si se propagan o no los campos rule_input y rule_output.
Etiquetas:terminal_output
--query_file=<a string>
predeterminado: ""-
Si se establece, la consulta leerá la consulta del archivo que se nombra aquí, en lugar de la línea de comandos. Especificar un archivo aquí y una consulta de línea de comandos es un error.
Etiquetas:changes_inputs
--[no]relative_locations
predeterminado: “false”-
Si es verdadero, la ubicación de los archivos BUILD en los resultados de 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 establecer esta opción en verdadero para obtener un resultado coherente en todas las máquinas.
Etiquetas:terminal_output
--show_config_fragments=<off, direct or transitive>
predeterminado: "off"-
Muestra los fragmentos de configuración que requiere una regla y sus dependencias transitivas. Esto puede ser útil para evaluar cuánto se puede recortar un gráfico objetivo configurado.
Etiquetas:affects_outputs
--starlark:expr=<a string>
predeterminado: ""-
Es una expresión Starlark para dar formato a cada destino configurado en el modo --output=starlark de cquery. El objetivo configurado está vinculado a "target". Si no se especifican --starlark:expr ni --starlark:file, esta opción se establecerá de forma predeterminada en "str(target.label)". Especificar --starlark:expr y --starlark:file es un error.
Etiquetas:terminal_output
--starlark:file=<a string>
predeterminado: ""-
Es el nombre de un archivo que define una función Starlark llamada "format", de un argumento, que se aplica a cada destino configurado para darle formato como una cadena. Especificar --starlark:expr y --starlark:file es un error. Consulta la ayuda de --output=starlark para obtener más detalles.
Etiquetas:terminal_output
--[no]tool_deps
predeterminado: "true"-
Consulta: Si se inhabilita, las dependencias de "configuración de ejecución" no se incluirán en el gráfico de dependencias sobre el que opera la consulta. Un borde de dependencia de "configuración de ejecución", como el de cualquier regla "proto_library" al compilador de protocolos, suele apuntar a una herramienta que se ejecuta durante la compilación en lugar de a una parte del mismo programa "objetivo".
Cquery: Si se inhabilita, filtra todos los objetivos configurados que crucen una transición de ejecución desde el objetivo de nivel superior que descubrió este objetivo configurado. Esto significa que, si el objetivo de nivel superior está en la configuración de destino, solo se mostrarán los objetivos configurados también en la configuración de destino. Si el objetivo de nivel superior está en la configuración de exec, solo se mostrarán los objetivos configurados de exec. Esta opción NO excluirá las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
- Valor predeterminado de
--transitions=<full, lite or none>
: “none” -
Es el formato en el que cquery imprimirá la información de transición.
Etiquetas:affects_outputs
--universe_scope=<comma-separated list of options>
predeterminado: ""-
Es un conjunto de patrones de segmentación (aditivos y sustractivos) separados por comas. La consulta se puede realizar en el universo definido por el cierre transitivo de los destinos especificados. Esta opción se usa para los comandos query y cquery.
En el caso de cquery, la entrada de esta opción son los objetivos en los que se compilan todas las respuestas, por lo que esta opción puede afectar las configuraciones y las transiciones. Si no se especifica esta opción, se supone que los destinos de nivel superior son los que se analizan de la expresión de consulta. Nota: En el caso de cquery, si no especificas esta opción, es posible que la compilación falle si los destinos analizados de la expresión de consulta no se pueden compilar con opciones de nivel superior.
Etiquetas:loading_and_analysis
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
. -
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitadas en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "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 un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
predeterminado: “update”- especifica cómo usar el archivo de bloqueo y si se debe usar o no. 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 mostrar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
. - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso proporcionada es una ruta de acceso absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta de acceso relativa, se hará referencia al directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace".
- Se acumulan varios usos de
--registry=<a string>
. -
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los 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 haga que Bazel falle con un error de OOM. Cada límite se especifica como <period>:<count>, en el que period es una duración y count es un número entero positivo. Si más del porcentaje --gc_thrashing_threshold del espacio a perpetuidad (heap de generación anterior) permanece ocupado después de <count> GC completas consecutivas en <period>, se activa un error de OOM. Se pueden especificar varios límites separados por comas.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Es una marca para la configuración avanzada del motor Skyframe interno 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 GC completo, se descartará el estado temporal innecesario de Skyframe hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC completos nunca activarán las bajadas. 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"-
Es una marca para la configuración avanzada del motor Skyframe interno 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 GC menor, se descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC menores nunca activarán las bajadas. 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
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es de al menos este límite, descartará el estado temporal innecesario de Skyframe. Si ajustas este parámetro, es posible que puedas mitigar el impacto del tiempo de ejecución de la fragmentación de GC, cuando esta se produce (i) por el uso de memoria de este estado temporal y (ii) es más costoso 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:
--[no]experimental_command_profile
predeterminado: “false”- Graba un perfil de CPU de Java Flight Recorder en un archivo profile.jfr en el directorio base de salida. La sintaxis y la semántica de esta marca pueden cambiar en el futuro para admitir diferentes tipos de perfiles o formatos de salida. Úsala bajo tu propio riesgo.
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
- Opciones que especifican o alteran una entrada genérica a un comando de Bazel que no se incluye en otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de almacenamiento en caché y ejecución remotas:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite"), seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
--experimental_worker_for_repo_fetching=<off, platform or virtual>
predeterminado: "off"- Es el modo de subprocesos que se usará para recuperar el repo. Si se establece en "desactivado", no se usa ningún subproceso de trabajo y la recuperación del repo está sujeta a reinicios. De lo contrario, usa un subproceso de plataforma (es decir, un subproceso del SO) si se establece en "platform" o un subproceso virtual si se establece en "virtual".
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
. - Anula un repositorio con una ruta de acceso local en el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es una ruta absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta relativa, se relaciona con el directorio de trabajo actual. Si la ruta de acceso determinada 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 la compilación:
--[no]experimental_inprocess_symlink_creation
predeterminado: “false”-
Determina si se deben realizar llamadas directas al sistema de archivos para crear árboles de symlinks.
Etiquetas:loading_and_analysis
,execution
,experimental
--[no]experimental_persistent_aar_extractor
predeterminado: “false”-
Habilita el extractor de aar persistente con trabajadores.
Etiquetas:execution
--[no]experimental_remotable_source_manifests
predeterminado: “false”-
Determina si las acciones del manifiesto de origen se pueden controlar de forma remota.
Etiquetas:loading_and_analysis
,execution
,experimental
--[no]experimental_split_coverage_postprocessing
predeterminado: “false”-
Si es verdadero, Bazel ejecutará el procesamiento posterior de la cobertura para la prueba en un nuevo inicio.
Etiquetas:execution
--[no]experimental_strict_fileset_output
predeterminado: “false”-
Si esta opción está habilitada, los conjuntos de archivos tratarán todos los artefactos de salida como archivos normales. No recorrerán directorios ni serán sensibles a los symlinks.
Etiquetas:execution
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
predeterminado: ""-
Agrega o quita claves de la información de ejecución de una acción según la mnemotecnia 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 especificas varios valores, el orden es importante porque muchas regex pueden aplicarse al mismo mnemónico.
Sintaxis: "regex=[+-]clave,regex=[+-]clave,…".
Ejemplos:
'.*=+x,.*=-y,.*=+z' agrega "x" y "z" a la información de ejecución de todas las acciones y quita "y".
"Genrule=+requires-x" agrega "requires-x" a la información de ejecución de todas las acciones de Genrule.
"(?!Genrule).*=-requires-x" quita "requires-x" de la información de ejecución para todas las acciones que no sean de Genrule.
Etiquetas:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Habilita las acciones de expansión de sintaxis y dex persistentes de Android con trabajadores.
Se expande a:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
-
Habilita el procesador de recursos de Android persistente con trabajadores.
Se expande a:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
--strategy=ProcessDatabinding=worker
--strategy=GenerateDataBindingBaseClasses=worker
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_dex_desugar
-
Habilita las acciones de desugar y dex multiplexadas y persistentes de Android con trabajadores.
Se expande a:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
Habilita el procesador de recursos de Android multiplexado persistente con trabajadores.
Se expande a:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_tools
-
Habilita las herramientas de Android persistentes y multiplexadas (dexing, expansión de sintaxis, procesamiento de recursos).
Se expande a:
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Etiquetas:host_machine_resource_optimizations
,execution
--[no]use_target_platform_for_tests
predeterminado: “false”-
Si es verdadero, Bazel usará la plataforma de destino para ejecutar pruebas en lugar del grupo de ejecución de pruebas.
Etiquetas:execution
- Son opciones que configuran la cadena de herramientas que se usa para la ejecución de acciones:
--android_compiler=<a string>
predeterminado: Consulta la descripción-
El compilador de destino de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_crosstool_top=<a build target label>
predeterminado: "//external:android/crosstool"-
Es la ubicación del compilador de C++ que se usa para las compilaciones de Android.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_grte_top=<a label>
predeterminado: Consulta la descripción-
El objetivo grte_top de Android.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
predeterminado: "android"-
Selecciona el combinador de manifiestos que se usará para las reglas android_binary. Marca para ayudar a la transición a la combinación de manifiestos de Android desde la combinación heredada.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_platforms=<a build target label>
predeterminado: ""-
Establece las plataformas que usan los destinos de android_binary. Si se especifican varias plataformas, el objeto binario es un APK grueso, que contiene objetos binarios nativos para cada plataforma de destino especificada.
Etiquetas:changes_inputs
,loading_and_analysis
,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
,loses_incremental_state
--apple_crosstool_top=<a build target label>
predeterminado: "@bazel_tools//tools/cpp:toolchain"-
Es la etiqueta del paquete de herramientas cruzadas que se usará en las reglas de Apple y Objc, y sus dependencias.
Etiquetas:loses_incremental_state
,changes_inputs
--cc_output_directory_tag=<a string>
predeterminado: ""-
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas:affects_outputs
--compiler=<a string>
predeterminado: Consulta la descripción-
Es el compilador de C++ que se usará para compilar el destino.
Etiquetas:loading_and_analysis
,execution
--coverage_output_generator=<a build target label>
predeterminado: "@bazel_tools//tools/test:lcov_merger"-
Ubicación del binario que se usa para postprocesar informes de cobertura sin procesar. Actualmente, debe ser un grupo de archivos que contenga un solo archivo, el binario. El valor predeterminado es “//tools/test:lcov_merger”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
predeterminado: "@bazel_tools//tools/test:coverage_report_generator"-
Ubicación del binario que se usa para generar informes de cobertura. Actualmente, debe ser un grupo de archivos que contenga un solo archivo, el binario. El valor predeterminado es "//tools/test:coverage_report_generator".
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
predeterminado: "@bazel_tools//tools/test:coverage_support"-
Ubicación de los archivos de compatibilidad que se requieren en las entradas de cada acción de prueba que recopila la cobertura de código. El valor predeterminado es “//tools/test:coverage_support”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--crosstool_top=<a build target label>
predeterminado: "@bazel_tools//tools/cpp:toolchain"-
Es la etiqueta del paquete de herramientas cruzadas que se usará para compilar código C++.
Etiquetas:loading_and_analysis
,changes_inputs
,affects_outputs
--custom_malloc=<a build target label>
predeterminado: Consulta la descripción- especifica una implementación personalizada de malloc. Este parámetro de configuración anula los atributos malloc en las reglas de compilación.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan varios usos de
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
. -
Es una lista de expresiones regulares separadas por comas, cada una con el prefijo - (expresión negativa) de forma opcional, 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 con al menos una expresión positiva, la resolución de la cadena de herramientas se realizará como si hubiera declarado los valores de restricción como restricciones de ejecución. Ejemplo: //demo,-test=@platforms//cpus:x86_64 agregará "x86_64" a cualquier destino de //demo, excepto a aquellos cuyo nombre contenga "test".
Etiquetas:loading_and_analysis
--[no]experimental_include_xcode_execution_requirements
predeterminado: “false”-
Si se establece, agrega un requisito de ejecución "requires-xcode:{version}" a cada acción de Xcode. Si la versión de Xcode tiene una etiqueta con guiones, también agrega un requisito de ejecución "requires-xcode-label:{version_label}".
Etiquetas:loses_incremental_state
,loading_and_analysis
,execution
--[no]experimental_prefer_mutual_xcode
predeterminado: "true"-
Si es verdadero, usa la versión más reciente de Xcode que esté disponible de forma local y remota. Si es falso o si no hay versiones mutuas disponibles, usa la versión local de Xcode seleccionada a través de xcode-select.
Etiquetas:loses_incremental_state
--extra_execution_platforms=<comma-separated list of options>
predeterminado: ""-
Son las plataformas disponibles como plataformas de ejecución para ejecutar acciones. Las plataformas se pueden especificar por destino exacto o como un patrón de destino. Estas plataformas se considerarán antes de las declaradas en el archivo WORKSPACE por register_execution_platforms(). Esta opción solo se puede establecer una vez; las instancias posteriores anularán la configuración de la marca anterior.
Etiquetas:execution
- Se acumulan varios usos de
--extra_toolchains=<comma-separated list of options>
. -
Son las reglas de la cadena de herramientas que se deben tener en cuenta durante la resolución de la cadena de herramientas. Las cadenas de herramientas se pueden especificar por destino exacto o como un patrón de destino. Estas cadenas de herramientas se considerarán antes que las declaradas en el archivo WORKSPACE por register_toolchains().
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--grte_top=<a label>
predeterminado: Consulta la descripción-
Es una etiqueta para una biblioteca libc verificada. La cadena de herramientas de crosstool selecciona el valor predeterminado, y casi nunca es necesario anularlo.
Etiquetas:action_command_lines
,affects_outputs
--host_compiler=<a string>
predeterminado: Consulta la descripción-
Es el compilador de C++ que se usará para la compilación del host. Se ignora si no se establece --host_crosstool_top.
Etiquetas:loading_and_analysis
,execution
--host_crosstool_top=<a build target label>
predeterminado: Consulta la descripción-
De forma predeterminada, las opciones --crosstool_top y --compiler también se usan para la configuración de exec. Si se proporciona esta marca, Bazel usa la libc y el compilador predeterminados para el crosstool_top determinado.
Etiquetas:loading_and_analysis
,changes_inputs
,affects_outputs
--host_grte_top=<a label>
predeterminado: Consulta la descripción-
Si se especifica, este parámetro de configuración anula el directorio de nivel superior de libc (--grte_top) para la configuración de exec.
Etiquetas:action_command_lines
,affects_outputs
--host_platform=<a build target label>
predeterminado: "@local_config_platform//:host"-
La etiqueta de una regla de plataforma que describe el sistema host.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
predeterminado: "true"-
Si es verdadero, Bazel no habilitará las funciones "host" y "nonhost" en la cadena de herramientas de C++ (consulta https://github.com/bazelbuild/bazel/issues/7407 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_android_toolchain_resolution
predeterminado: "true"-
Usa la resolución de cadena de herramientas para seleccionar el SDK de Android para las reglas de Android (Starlark y nativo)
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_apple_toolchain_resolution
predeterminado: “false”-
Usa la resolución de cadena de herramientas para seleccionar el SDK de Apple para las reglas de Apple (Starlark y nativo)
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone
predeterminado: "true"-
Si es verdadero, Bazel no reutilizará las líneas de comandos de la acción de vinculación de C++ para las líneas de comandos de indexación de lto (consulta https://github.com/bazelbuild/bazel/issues/6791 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_legacy_whole_archive
predeterminado: "true"-
Si es verdadero, Bazel no vinculará las dependencias de la biblioteca como un archivo completo de forma predeterminada (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener instrucciones de migración).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_require_ctx_in_configure_features
predeterminado: "true"-
Si es verdadero, Bazel requerirá el parámetro "ctx" en cc_common.configure_features (consulta https://github.com/bazelbuild/bazel/issues/7793 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
-
Usa objetos compartidos de interfaz si la cadena de herramientas es compatible. Actualmente, todas las cadenas de herramientas ELF admiten este parámetro de configuración.
Etiquetas:loading_and_analysis
,affects_outputs
,affects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Especifica la versión del SDK de iOS que se usará para compilar aplicaciones para iOS. Si no se especifica, usa la versión predeterminada del SDK de iOS de "xcode_version".
Etiquetas:loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Especifica la versión del SDK de macOS que se usará para compilar aplicaciones para macOS. Si no se especifica, se usa la versión predeterminada del SDK de macOS de "xcode_version".
Etiquetas:loses_incremental_state
--minimum_os_version=<a string>
predeterminado: Consulta la descripción-
Es la versión mínima del SO a la que se orienta tu compilación.
Etiquetas:loading_and_analysis
,affects_outputs
--platform_mappings=<a relative path>
predeterminado: ""-
Es la ubicación de un archivo de asignación que describe qué plataforma usar si no se establece ninguna o qué marcas establecer cuando ya existe una plataforma. Debe ser relativo a la raíz del espacio de trabajo principal. El valor predeterminado es "platform_mappings" (un archivo directamente debajo de la raíz del espacio de trabajo).
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--platforms=<a build target label>
predeterminado: ""-
Son las etiquetas de las reglas de la plataforma que describen las plataformas de destino del comando actual.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--python2_path=<a string>
predeterminado: Consulta la descripción-
Obsoleto, no realiza ninguna acción. Se inhabilitó con `--incompatible_use_python_toolchains`.
Etiquetas:no_op
,deprecated
--python3_path=<a string>
predeterminado: Consulta la descripción-
Obsoleto, no realiza ninguna acción. Se inhabilitó con `--incompatible_use_python_toolchains`.
Etiquetas:no_op
,deprecated
--python_path=<a string>
predeterminado: Consulta la descripción-
Es la ruta de acceso absoluta del intérprete de Python que se invocó para ejecutar destinos de Python en la plataforma de destino. Obsoleto; se inhabilitó con --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
--python_top=<a build target label>
predeterminado: Consulta la descripción-
La etiqueta de un py_runtime que representa el intérprete de Python invocado para ejecutar destinos de Python en la plataforma de destino. Obsoleto; se inhabilitó con --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Especifica la versión del SDK de tvOS que se usará para compilar aplicaciones para tvOS. Si no se especifica, se usa la versión predeterminada del SDK de tvOS de "xcode_version".
Etiquetas:loses_incremental_state
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Especifica la versión del SDK de watchOS que se usará para compilar aplicaciones para watchOS. Si no se especifica, se usa la versión predeterminada del SDK de watchOS de "xcode_version".
Etiquetas:loses_incremental_state
--xcode_version=<a string>
predeterminado: Consulta la descripción-
Si se especifica, usa Xcode de la versión determinada para las acciones de compilación relevantes. Si no se especifica, se usa la versión predeterminada del ejecutor de Xcode.
Etiquetas:loses_incremental_state
--xcode_version_config=<a build target label>
predeterminado: "@bazel_tools//tools/cpp:host_xcodes"-
Es la etiqueta de la regla xcode_config que se usará para seleccionar la versión de Xcode en la configuración de compilación.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Opciones que controlan el resultado del comando:
--[no]apple_generate_dsym
predeterminado: “false”-
Indica si se deben generar archivos de símbolos de depuración (.dSYM).
Etiquetas:affects_outputs
,action_command_lines
--[no]build_runfile_links
predeterminado: "true"-
Si es verdadero, compila bosques de symlinks de runfiles para todos los destinos. Si es falso, escríbelos solo cuando lo requiera una acción local, una prueba o un comando de ejecución.
Etiquetas:affects_outputs
--[no]build_runfile_manifests
predeterminado: "true"-
Si es verdadero, escribe manifiestos de runfiles para todos los destinos. Si es falso, omítelos. Las pruebas locales no se ejecutarán si es falso.
Etiquetas:affects_outputs
--[no]build_test_dwp
predeterminado: “false”-
Si está habilitado, cuando se compilen pruebas de C++ de forma estática y con Fission, el archivo .dwp para el objeto binario de prueba también se compilará automáticamente.
Etiquetas:loading_and_analysis
,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 una cc_proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated set of options>
predeterminado: “.pb.cc”-
Configura los sufijos de los archivos de origen que crea una cc_proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info
predeterminado: “false”-
Ejecuta acciones adicionales para versiones alternativas de la API de Java en una proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_proto_extra_actions
predeterminado: “false”-
Ejecuta acciones adicionales para versiones alternativas de la API de Java en una proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_save_feature_state
predeterminado: “false”-
Guarda el estado de las funciones habilitadas y solicitadas como un resultado de la compilación.
Etiquetas:affects_outputs
,experimental
--fission=<a set of compilation modes>
predeterminado: “no”-
Especifica qué modos de compilación usan la fisión para las compilaciones y los vínculos de C++. Puede ser cualquier combinación de {'fastbuild', 'dbg', 'opt'} o los valores especiales "yes" para habilitar todos los modos y "no" para inhabilitarlos.
Etiquetas:loading_and_analysis
,action_command_lines
,affects_outputs
--[no]incompatible_always_include_files_in_data
predeterminado: "true"-
Si es verdadero, las reglas nativas agregan <code>DefaultInfo.files</code> de dependencias de datos a sus archivos de ejecución, lo que coincide con el comportamiento recomendado para las reglas de Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid).
Etiquetas:affects_outputs
,incompatible_change
--[no]legacy_external_runfiles
predeterminado: "true"-
Si es verdadero, compila bosques de symlinks de runfiles para repositorios externos en .runfiles/wsname/external/repo (además de .runfiles/repo).
Etiquetas:affects_outputs
--[no]objc_generate_linkmap
predeterminado: “false”- especifica si se debe generar un archivo de mapa de vínculos.
Etiquetas:affects_outputs
--[no]save_temps
predeterminado: “false”-
Si se establece, se guardarán los resultados temporales de gcc. Estos incluyen archivos .s (código de ensamblador), archivos .i (C procesado) y archivos .ii (C++ procesado).
Etiquetas:affects_outputs
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
- Se acumulan varios usos de
--action_env=<a 'name=value' assignment with an optional value part>
. -
Especifica el conjunto de variables de entorno disponibles para las acciones con configuración de destino. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o bien por el par nombre=valor, que establece el valor independientemente del entorno de invocación. Esta opción se puede usar varias veces. En el caso de las opciones que se proporcionan para la misma variable, se aplica la más reciente, y se acumulan las opciones para diferentes variables.
Etiquetas:action_command_lines
--android_cpu=<a string>
predeterminado: "armeabi-v7a"-
La CPU objetivo de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]android_databinding_use_androidx
predeterminado: "true"-
Genera archivos de vinculación de datos compatibles con AndroidX. Esto solo se usa con la vinculación de datos v2. Esta marca no realiza ninguna acción.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]android_databinding_use_v3_4_args
predeterminado: "true"-
Usa Android Databinding v2 con el argumento 3.4.0. Esta marca no realiza ninguna acción.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--android_dynamic_mode=<off, default or fully>
predeterminado: "off"-
Determina si las dependencias de C++ de las reglas de Android se vincularán de forma dinámica cuando un cc_binary no cree una biblioteca compartida de forma explícita. "default" significa que bazel elegirá si vincular 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 modo principalmente estático.
Etiquetas:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
predeterminado: "alphabetical"-
Establece el orden de los manifiestos que se pasan a la combinación de manifiestos para los objetos binarios de Android. ALPHABETICAL significa que los manifiestos se ordenan por ruta de acceso en relación con el execroot. ALPHABETICAL_BY_CONFIGURATION significa que los manifiestos se ordenan por rutas de acceso relativas al directorio de configuración dentro del directorio de salida. DEPENDENCY significa que los manifiestos se ordenan de modo que el manifiesto de cada biblioteca aparezca antes que los manifiestos de sus dependencias.
Etiquetas:action_command_lines
,execution
--[no]android_resource_shrinking
predeterminado: “false”-
Habilita la reducción de recursos para los APKs de android_binary que usan ProGuard.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]build_python_zip
predeterminado: “auto”-
Compila el archivo ZIP ejecutable de Python; activado en Windows, desactivado en otras plataformas.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--catalyst_cpus=<comma-separated list of options>
. -
Es una lista de arquitecturas separadas por comas para las que se compilarán objetos binarios de Apple Catalyst.
Etiquetas:loses_incremental_state
,loading_and_analysis
--[no]collect_code_coverage
predeterminado: “false”-
Si se especifica, Bazel instrumentará el código (con instrumentación sin conexión siempre que sea posible) y recopilará información de cobertura durante las pruebas. Solo se verán afectados los destinos que coincidan con --instrumentation_filter. Por lo general, esta opción no debe especificarse directamente. En su lugar, se debe usar el comando "bazel coverage".
Etiquetas:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] predeterminado: "fastbuild"-
Especifica el modo en el que se compilará el objeto binario. Valores: "fastbuild", "dbg", "opt".
Etiquetas:affects_outputs
,action_command_lines
- Se acumulan varios usos de
--conlyopt=<a string>
. -
Opción adicional para pasar a gcc cuando se compilan archivos de origen C.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--copt=<a string>
. - Opciones adicionales para pasar a gcc.
Etiquetas:action_command_lines
,affects_outputs
--cpu=<a string>
predeterminado: ""-
La CPU objetivo.
Etiquetas:changes_inputs
,affects_outputs
--cs_fdo_absolute_path=<a string>
predeterminado: Consulta la descripción-
Usa la información del perfil de CSFDO para optimizar la compilación. Especifica el nombre de la ruta de acceso absoluta del archivo ZIP que contiene el archivo de perfil, un archivo de perfil LLVM sin procesar o indexado.
Etiquetas:affects_outputs
--cs_fdo_instrument=<a string>
predeterminado: Consulta la descripción-
Genera objetos binarios con instrumentación de FDO sensible al contexto. Con el compilador Clang/LLVM, también acepta el nombre del directorio en el que se volcarán los archivos de perfil sin procesar durante el tiempo de ejecución.
Etiquetas:affects_outputs
--cs_fdo_profile=<a build target label>
predeterminado: Consulta la 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 varios usos de
--cxxopt=<a string>
. -
Opción adicional para pasar a gcc cuando se compilan archivos de origen C++.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--define=<a 'name=value' assignment>
. -
Cada opción --define especifica una asignación para una variable de compilación.
Etiquetas:changes_inputs
,affects_outputs
--dynamic_mode=<off, default or fully>
predeterminado: "predeterminado"- determina si los objetos binarios de C++ se vincularán de forma dinámica. "default" significa que Bazel elegirá si vincular 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 modo principalmente estático.
Etiquetas:loading_and_analysis
,affects_outputs
--[no]enable_fdo_profile_absolute_path
predeterminado: "true"-
Si se establece, el uso de fdo_absolute_profile_path generará un error.
Etiquetas:affects_outputs
--[no]enable_runfiles
predeterminado: “auto”-
Habilita el árbol de symlinks de runfiles. De forma predeterminada, está desactivado en Windows y en otras plataformas.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--experimental_action_listener=<a build target label>
. - dejó de estar disponible y se reemplazó por aspectos. Usa action_listener para adjuntar una extra_action a las acciones de compilación existentes.
Etiquetas:execution
,experimental
--[no]experimental_android_compress_java_resources
predeterminado: “false”-
Comprime los recursos de Java en los APKs.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_android_databinding_v2
predeterminado: "true"-
Usa Android Databinding v2. Esta marca no realiza ninguna acción.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_android_resource_shrinking
predeterminado: “false”-
Habilita la reducción de recursos para los APKs de android_binary que usan ProGuard.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_android_rewrite_dexes_with_rex
predeterminado: “false”-
Usa la herramienta rex para volver a escribir archivos dex.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_collect_code_coverage_for_generated_files
predeterminado: “false”-
Si se especifica, Bazel también generará información de cobertura recopilada para los archivos generados.
Etiquetas:affects_outputs
--experimental_objc_fastbuild_options=<comma-separated list of options>
predeterminado: "-O0,-DDEBUG=1"-
Usa estas cadenas como opciones del compilador de fastbuild de objc.
Etiquetas:action_command_lines
--[no]experimental_omitfp
predeterminado: “false”-
Si es verdadero, usa libunwind para el desenredo de pila y compila con -fomit-frame-pointer y -fasynchronous-unwind-tables.
Etiquetas:action_command_lines
,affects_outputs
,experimental
--experimental_output_paths=<off, content or strip>
predeterminado: "off"-
Qué modelo usar para determinar en qué parte del árbol de salida las reglas escriben sus resultados, en particular para compilaciones multiplataforma o multiconfiguración. Esta función es muy experimental. Consulta https://github.com/bazelbuild/bazel/issues/6526 para obtener más información. Las acciones de Starlark pueden habilitar la asignación de rutas de acceso agregando la clave "supports-path-mapping" al diccionario "execution_requirements".
Etiquetas:loses_incremental_state
,bazel_internal_configuration
,affects_outputs
,execution
- Se acumulan varios usos de
--experimental_override_name_platform_in_output_dir=<a 'label=value' assignment>
. -
Cada entrada debe tener el formato etiqueta=valor, en el que etiqueta hace referencia a una plataforma y valor es el nombre abreviado que se desea usar en la ruta de salida. Solo se usa cuando --experimental_platform_in_output_dir es verdadero. Tiene la prioridad de nombres más alta.
Etiquetas:affects_outputs
,experimental
--[no]experimental_platform_in_output_dir
predeterminado: “false”-
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: primero, en el caso poco frecuente de que la opción --platforms no tenga exactamente un valor, se usa un hash de la opción platforms. A continuación, si se registró algún nombre corto para la plataforma actual con --experimental_override_name_platform_in_output_dir, se usará ese nombre corto. Luego, si se establece --experimental_use_platforms_in_output_dir_legacy_heuristic, usa un nombre corto basado en la etiqueta de plataforma actual. Por último, se usa un hash de la opción de plataforma como último recurso.
Etiquetas:affects_outputs
,experimental
--[no]experimental_use_llvm_covmap
predeterminado: “false”-
Si se especifica, Bazel generará información del mapa de cobertura de llvm-cov en lugar de gcov cuando se habilite collect_code_coverage.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic
predeterminado: "true"-
Usa esta marca solo como parte de una estrategia de migración o prueba sugerida. Ten en cuenta que la heurística tiene deficiencias conocidas y se recomienda migrar a depender solo de --experimental_override_name_platform_in_output_dir.
Etiquetas:affects_outputs
,experimental
--fat_apk_cpu=<comma-separated set of options>
predeterminado: "armeabi-v7a"-
Si configuras esta opción, se habilitan los APKs multiarquitectura, que contienen objetos binarios nativos para todas las arquitecturas de destino especificadas, p.ej., --fat_apk_cpu=x86,armeabi-v7a. Si se especifica esta marca, se ignora --android_cpu para las dependencias de las reglas android_binary.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]fat_apk_hwasan
predeterminado: “false”-
Indica si se deben crear divisiones HWASAN.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--fdo_instrument=<a string>
predeterminado: Consulta la descripción-
Genera objetos binarios con la instrumentación de FDO. Con el compilador Clang/LLVM, también acepta el nombre del directorio en el que se volcarán los archivos de perfil sin procesar durante el tiempo de ejecución.
Etiquetas:affects_outputs
--fdo_optimize=<a string>
predeterminado: Consulta la descripción-
Usa la información del perfil de FDO para optimizar la compilación. Especifica el nombre de un archivo ZIP que contenga un árbol de archivos .gcda, un archivo afdo que contenga un perfil automático o un archivo de perfil de LLVM. Esta marca también acepta archivos especificados como etiquetas (p.ej., "//foo/bar:file.afdo"; es posible que debas agregar una directiva "exports_files" al paquete correspondiente) y etiquetas que apuntan a destinos "fdo_profile". La regla "fdo_profile" reemplazará esta marca.
Etiquetas:affects_outputs
--fdo_prefetch_hints=<a build target label>
predeterminado: Consulta la descripción-
Usa sugerencias de almacenamiento en caché para la carga previa.
Etiquetas:affects_outputs
--fdo_profile=<a build target label>
predeterminado: Consulta la descripción-
Es el fdo_profile que representa el perfil que se usará para la optimización.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--features=<a string>
. -
Las funciones determinadas se habilitarán o inhabilitarán de forma predeterminada para los destinos compilados en la configuración de destino. Si especificas -<feature>, se inhabilitará la función. Los atributos negativos siempre anulan los positivos. Consulta también --host_features
Etiquetas:changes_inputs
,affects_outputs
--[no]force_pic
predeterminado: “false”-
Si está habilitado, todas las compilaciones de C++ producen código independiente de la posición ("-fPIC"), los vínculos prefieren las bibliotecas precompiladas de PIC en lugar de las bibliotecas que no son de PIC, y los vínculos producen ejecutables independientes de la posición ("-pie").
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan varios usos de
--host_action_env=<a 'name=value' assignment with an optional value part>
. -
Especifica el conjunto de variables de entorno disponibles para las acciones con configuraciones de ejecución. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o bien por el par nombre=valor, que establece el valor independientemente del entorno de invocación. Esta opción se puede usar varias veces. En el caso de las opciones que se proporcionan para la misma variable, se aplica la más reciente, y se acumulan las opciones para diferentes variables.
Etiquetas:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
predeterminado: "opt"-
Especifica el modo en el que se compilarán las herramientas que se usan durante la compilación. Valores: "fastbuild", "dbg", "opt".
Etiquetas:affects_outputs
,action_command_lines
- Se acumulan varios usos de
--host_conlyopt=<a string>
. -
Opción adicional para pasar al compilador de C cuando se compilan archivos de origen C (pero no C++) en las configuraciones de ejecución.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--host_copt=<a string>
. -
Opciones adicionales para pasar al compilador C para herramientas compiladas en las configuraciones de ejecución.
Etiquetas:action_command_lines
,affects_outputs
--host_cpu=<a string>
predeterminado: ""-
La CPU del host.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan varios usos de
--host_cxxopt=<a string>
. -
Opciones adicionales para pasar al compilador de C++ para herramientas compiladas en las configuraciones de ejecución.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--host_features=<a string>
. -
Las funciones determinadas se habilitarán o inhabilitarán de forma predeterminada para los destinos compilados en la configuración de ejecución. Si especificas -<feature>, se inhabilitará la función. Los atributos negativos siempre anulan los positivos.
Etiquetas:changes_inputs
,affects_outputs
--host_force_python=<PY2 or PY3>
predeterminado: Consulta la descripción-
Anula la versión de Python para la configuración de ejecución. Puede ser “PY2” o “PY3”.
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan varios usos de
--host_linkopt=<a string>
. -
Opción adicional para pasar al vinculador cuando se vinculan herramientas en las configuraciones de ejecución.
Etiquetas:action_command_lines
,affects_outputs
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Versión mínima compatible de macOS para los destinos de host. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan varios usos de
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
. -
Opciones adicionales para pasar de forma selectiva al compilador C/C++ cuando se compilan ciertos archivos en las configuraciones de ejecución. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. En la que regex_filter representa una lista de patrones de expresiones regulares para incluir y excluir (consulta también --instrumentation_filter). option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe estar entre comillas con una barra invertida. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos de gcc de todos los archivos cc en //foo/, excepto bar.cc.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--host_swiftcopt=<a string>
. -
Opciones adicionales para pasar a swiftc para herramientas de ejecución.
Etiquetas:action_command_lines
,affects_outputs
--[no]incompatible_auto_exec_groups
predeterminado: “false”-
Cuando se habilita, se crea automáticamente un grupo de ejecución para cada cadena de herramientas que usa una regla. Para que esto funcione, la regla 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
,incompatible_change
--[no]incompatible_merge_genfiles_directory
predeterminado: "true"-
Si es verdadero, el directorio genfiles se une al directorio bin.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_use_host_features
predeterminado: "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
,incompatible_change
--[no]instrument_test_targets
predeterminado: “false”-
Cuando la cobertura está habilitada, especifica si se deben considerar las reglas de prueba de instrumentación. Cuando se establece, se instrumentan las reglas de prueba que incluye --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 la cobertura esté habilitada, solo se instrumentarán las reglas con nombres incluidos en el filtro basado en regex especificado. En su lugar, se excluyen las reglas con el prefijo “-”. Ten en cuenta que solo se instrumentan las reglas que no son de prueba, a menos que se habilite --instrument_test_targets.
Etiquetas:affects_outputs
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Es la versión mínima de iOS compatible para los simuladores y dispositivos de destino. Si no se especifica, se usa "ios_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan varios usos de
--ios_multi_cpus=<comma-separated list of options>
. -
Es una lista de arquitecturas separadas por comas con las que se compila una ios_application. El resultado es un binario universal que contiene todas las arquitecturas especificadas.
Etiquetas:loses_incremental_state
,loading_and_analysis
--[no]legacy_whole_archive
predeterminado: "true"-
Obsoleto, reemplazado por --incompatible_remove_legacy_whole_archive (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener más información). Cuando está activado, usa --whole-archive para las reglas cc_binary que tienen linkshared=True y linkstatic=True o “-static” en linkopts. Esto es solo para la retrocompatibilidad. Una mejor alternativa es usar alwayslink=1 cuando sea necesario.
Etiquetas:action_command_lines
,affects_outputs
,deprecated
- Se acumulan varios usos de
--linkopt=<a string>
. - : Opción adicional para pasar a gcc cuando se realiza la vinculación.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--ltobackendopt=<a string>
. -
Opción adicional para pasar al paso de backend de LTO (en --features=thin_lto).
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--ltoindexopt=<a string>
. -
Opción adicional para pasar al paso de indexación de LTO (en --features=thin_lto).
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--macos_cpus=<comma-separated list of options>
. -
Es una lista separada por comas de las arquitecturas para las que se compilarán los objetos binarios de Apple macOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Versión mínima de macOS compatible para los destinos. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
--memprof_profile=<a build target label>
predeterminado: Consulta la descripción-
Usa el perfil de memprof.
Etiquetas:affects_outputs
--[no]objc_debug_with_GLIBCXX
predeterminado: “false”-
Si se establece y el modo de compilación se establece en "dbg", define GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC y GLIBCPP_CONCEPT_CHECKS.
Etiquetas:action_command_lines
--[no]objc_enable_binary_stripping
predeterminado: “false”-
Determina si se deben quitar los símbolos y el código muerto en los 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 varios usos de
--objccopt=<a string>
. -
Opciones adicionales para pasar a gcc cuando se compilan archivos de origen Objective-C/C++.
Etiquetas:action_command_lines
- Se acumulan varios usos de
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
. -
Opciones adicionales para pasar de forma selectiva a gcc cuando se compilan ciertos archivos. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. En la que regex_filter representa una lista de patrones de expresiones regulares para incluir y excluir (consulta también --instrumentation_filter). option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe estar entre comillas con una barra invertida. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos de gcc de todos los archivos cc en //foo/, excepto bar.cc.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
. -
Opciones adicionales para pasar de forma selectiva al backend de LTO (en --features=thin_lto) cuando se compilan ciertos objetos de backend. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. En la que regex_filter representa una lista de patrones de expresión regular para incluir y excluir. option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe estar entre comillas con una barra invertida. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos del backend de LTO de todos los archivos o en //foo/, excepto bar.o.
Etiquetas:action_command_lines
,affects_outputs
--platform_suffix=<a string>
predeterminado: Consulta la descripción-
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas:loses_incremental_state
,affects_outputs
,loading_and_analysis
--propeller_optimize=<a build target label>
predeterminado: Consulta la descripción-
Usa la información del perfil de Propeller para optimizar el destino de compilación.Un perfil de Propeller debe constar de al menos uno de dos archivos: un perfil de cc y un perfil de ld. Esta marca acepta una etiqueta de compilación que debe hacer referencia a los archivos de entrada del perfil de Propeller. Por ejemplo, el archivo BUILD que define la etiqueta, en a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)Es posible que se deba agregar una directiva exports_files al paquete correspondiente para que Bazel pueda ver estos archivos. La opción se debe usar de la siguiente manera: --propeller_optimize=//a/b:propeller_profile
Etiquetas:action_command_lines
,affects_outputs
--propeller_optimize_absolute_cc_profile=<a string>
predeterminado: Consulta la descripción-
Nombre de ruta de acceso absoluta del archivo cc_profile para compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
predeterminado: Consulta la descripción-
Es el nombre de ruta de acceso absoluto del archivo ld_profile para las compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
--run_under=<a prefix in front of command>
predeterminado: Consulta la descripción-
Es el prefijo que se inserta antes de los ejecutables para los comandos "test" y "run". Si el valor es "foo -bar" y la línea de comandos de ejecución es "test_binary -baz", la línea de comandos final es "foo -bar test_binary -baz".También puede ser una etiqueta para un destino ejecutable. Algunos ejemplos son: "valgrind", "strace", "strace -c", "valgrind --quiet --num-callers=20", "//package:target", "//package:target --options".
Etiquetas:action_command_lines
-
Si es verdadero, las bibliotecas nativas que contienen funcionalidad idéntica se compartirán entre diferentes destinos.
Etiquetas:loading_and_analysis
,affects_outputs
--[no]stamp
predeterminado: “false”-
Marca los 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
- Valor predeterminado de
--strip=<always, sometimes or never>
: “sometimes” - especifica si se deben quitar los objetos binarios y las bibliotecas compartidas (con "-Wl,--strip-debug"). El valor predeterminado de "sometimes" significa quitar si --compilation_mode=fastbuild.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--stripopt=<a string>
. -
Opciones adicionales para pasar a la eliminación cuando se genera un objeto binario "<name>.stripped".
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--swiftcopt=<a string>
. -
Opciones adicionales para pasar a la compilación de Swift.
Etiquetas:action_command_lines
- Se acumulan varios usos de
--tvos_cpus=<comma-separated list of options>
. -
Es una lista separada por comas de las arquitecturas para las que se compilarán los objetos binarios de Apple tvOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Versión mínima compatible de tvOS para los simuladores y dispositivos de destino. Si no se especifica, se usa "tvos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan varios usos de
--visionos_cpus=<comma-separated list of options>
. -
Es una lista separada por comas de las arquitecturas para las que se compilarán los objetos binarios de Apple visionOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Se acumulan varios usos de
--watchos_cpus=<comma-separated list of options>
. -
Es una lista separada por comas de las arquitecturas para las que se compilarán los objetos binarios de Apple watchOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Versión mínima compatible de watchOS para los simuladores y dispositivos de destino. Si no se especifica, se usa "watchos_sdk_version".
Etiquetas:loses_incremental_state
--xbinary_fdo=<a build target label>
predeterminado: Consulta la descripción-
Usa la información del perfil de XbinaryFDO para optimizar la compilación. Especifica el nombre del perfil binario cruzado 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 rigurosidad con la que Bazel aplica entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
--auto_cpu_environment_group=<a build target label>
predeterminado: ""-
Declara el environment_group que se usará para asignar automáticamente los valores de CPU a los valores de target_environment.
Etiquetas:changes_inputs
,loading_and_analysis
,experimental
--[no]check_licenses
predeterminado: “false”-
Verifica que las restricciones de licencias que imponen los paquetes dependientes no entren en conflicto con los modos de distribución de los destinos que se compilan. De forma predeterminada, no se verifican las licencias.
Etiquetas:build_file_semantics
--[no]check_visibility
predeterminado: "true"-
Si se inhabilita, los errores de visibilidad en las dependencias de destino se degradan a advertencias.
Etiquetas:build_file_semantics
--[no]desugar_for_android
predeterminado: "true"-
Indica si se debe expandir el código de bytes de Java 8 antes de dexificarlo.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]desugar_java8_libs
predeterminado: “false”-
Indica si se deben incluir bibliotecas compatibles de Java 8 en apps para dispositivos heredados.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]enforce_constraints
predeterminado: "true"-
Verifica los entornos con los que es compatible cada objetivo y, luego, informa errores si alguno tiene dependencias que no admiten los mismos entornos.
Etiquetas:build_file_semantics
--[no]experimental_check_desugar_deps
predeterminado: "true"-
Determina si se debe volver a verificar la expansión correcta a nivel binario de Android.
Etiquetas:eagerness_to_exit
,loading_and_analysis
,experimental
--experimental_import_deps_checking=<off, warning or error>
predeterminado: “OFF”-
Cuando está habilitado, verifica si las dependencias de una aar_import están completas. Esta aplicación forzosa puede interrumpir la compilación o generar advertencias.
Etiquetas:loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
predeterminado: "predeterminado"-
Si es verdadero, verifica que un destino de Java declare explícitamente todos los destinos utilizados directamente como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files
predeterminado: “false”-
Si está habilitado, busca el atributo testonly de la regla de generación para verificar si hay destinos de requisitos previos que sean archivos de salida. Esto coincide con la verificación de visibilidad.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_check_visibility_for_toolchains
predeterminado: “false”-
Si está habilitada, la verificación de visibilidad también se aplica a las implementaciones de la cadena de herramientas.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_disable_native_android_rules
predeterminado: “false”-
Si se habilita, se inhabilita el uso directo de las reglas nativas de Android. Usa las reglas de Android de Starlark de https://github.com/bazelbuild/rules_android.
Etiquetas:eagerness_to_exit
,incompatible_change
--[no]incompatible_disable_native_apple_binary_rule
predeterminado: “false”-
No realiza ninguna acción. Se mantiene aquí para la retrocompatibilidad.
Etiquetas:eagerness_to_exit
,incompatible_change
--[no]incompatible_python_disable_py2
predeterminado: "true"-
Si es verdadero, usar la configuración de Python 2 provocará un error. Esto incluye python_version=PY2, srcs_version=PY2 y srcs_version=PY2ONLY. Consulta https://github.com/bazelbuild/bazel/issues/15684 para obtener más información.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_validate_top_level_header_inclusions
predeterminado: "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
,incompatible_change
--python_native_rules_allowlist=<a build target label>
predeterminado: Consulta la descripción-
Es una lista de entidades permitidas (objetivo de package_group) que se usará cuando se aplique --incompatible_python_disallow_native_rules.
Etiquetas:loading_and_analysis
--[no]strict_filesets
predeterminado: “false”-
Si esta opción está habilitada, los conjuntos de archivos que cruzan los límites de los paquetes se informan como errores.
Etiquetas:build_file_semantics
,eagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default>
predeterminado: "error"-
A menos que esté desactivado, comprueba que un destino de proto_library declare de forma explícita todos los destinos utilizados directamente como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
--strict_public_imports=<off, warn, error, strict or default>
predeterminado: "off"-
A menos que esté desactivado, comprueba que un objetivo de proto_library declare de forma explícita todos los objetivos que se usan en "import public" como exportados.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
--[no]strict_system_includes
predeterminado: “false”-
Si es verdadero, también se deben declarar los encabezados que se encuentran a través de las rutas de inclusión del sistema (-isystem).
Etiquetas:loading_and_analysis
,eagerness_to_exit
- Se acumulan varios usos de
--target_environment=<a build target label>
. -
Declara el entorno de destino de esta compilación. Debe ser una referencia de etiqueta a una regla de "entorno". Si se especifican, 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 que se usará para firmar APKs
Etiquetas:action_command_lines
,affects_outputs
,loading_and_analysis
--[no]device_debug_entitlements
predeterminado: "true"-
Si se establece y el modo de compilación no es "opt", las apps de objc incluirán derechos de depuración cuando se firmen.
Etiquetas:changes_inputs
--ios_signing_cert_name=<a string>
predeterminado: Consulta la descripción-
Nombre del certificado que se usará para la firma de iOS. Si no se establece, se usará el perfil de aprovisionamiento. Puede ser la preferencia de identidad del llavero del certificado o la substring del nombre común del certificado, según la página de man de codesign (IDENTIDADES DE FIRMA).
Etiquetas:action_command_lines
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.:
--[no]incompatible_disallow_legacy_py_provider
predeterminado: "true"-
No se puede usar y se quitará pronto.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_sdk_frameworks_attributes
predeterminado: “false”-
Si es verdadero, no se permiten los atributos sdk_frameworks y weak_sdk_frameworks en objc_library y objc_import.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_objc_alwayslink_by_default
predeterminado: “false”-
Si es verdadero, establece el valor predeterminado como verdadero para los atributos alwayslink en objc_library y objc_import.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_python_disallow_native_rules
predeterminado: “false”-
Cuando 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
,incompatible_change
- Opciones que rigen el comportamiento del entorno de prueba o del ejecutor de pruebas:
--[no]allow_analysis_failures
predeterminado: “false”-
Si es verdadero, una falla de análisis de un objetivo de regla genera la propagación del objetivo 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
,experimental
--analysis_testing_deps_limit=<an integer>
predeterminado: “2000”-
Establece la cantidad máxima de dependencias transitivas a través de un atributo de regla con una transición de configuración for_analysis_testing. Si se supera este límite, se mostrará un error de regla.
Etiquetas:loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure
predeterminado: “false”-
Si es verdadero, las fallas de la acción de dex2oat causarán que la compilación falle en lugar de ejecutar dex2oat durante el tiempo de ejecución de la prueba.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_android_use_parallel_dex2oat
predeterminado: “false”-
Usa dex2oat en paralelo para acelerar android_test.
Etiquetas:loading_and_analysis
,host_machine_resource_optimizations
,experimental
--[no]ios_memleaks
predeterminado: “false”-
Habilita la verificación de fugas de memoria en los destinos de ios_test.
Etiquetas:action_command_lines
--ios_simulator_device=<a string>
predeterminado: Consulta la descripción-
Es el dispositivo que se simula cuando se ejecuta una aplicación para iOS en el simulador, p.ej., "iPhone 6". Para obtener una lista de dispositivos, ejecuta "xcrun simctl list devicetypes" en la máquina en la que se ejecutará el simulador.
Etiquetas:test_runner
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Es la versión de iOS que se ejecutará 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 varios usos de
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
. - especifica la cantidad de veces que se debe ejecutar cada prueba. Si alguno de esos intentos falla por algún motivo, se considera que toda la prueba falló. 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 la que runs_per_test representa un valor entero y regex_filter representa una lista de patrones de expresiones regulares para incluir y excluir (consulta también --instrumentation_filter). Ejemplo: --runs_per_test=//foo/.*,-//foo/bar/.*@3 ejecuta todas las pruebas en //foo/, excepto las que se encuentran en foo/bar, tres veces. Esta opción se puede pasar varias veces. El argumento pasado más recientemente que coincida tiene prioridad. Si no hay coincidencias, la prueba solo se ejecuta una vez.
- Se acumulan varios usos de
--test_env=<a 'name=value' assignment with an optional value part>
. -
Especifica variables de entorno adicionales que se insertarán en el entorno del ejecutor de pruebas. Las variables se pueden especificar por nombre, en cuyo caso su valor se leerá del entorno del cliente de Bazel, o por el par nombre=valor. Esta opción se puede usar varias veces para especificar varias variables. Solo lo usa el comando "bazel test".
Etiquetas:test_runner
--test_timeout=<a single integer or comma-separated list of 4 integers>
predeterminado: “-1”- Anula los valores predeterminados de tiempo de espera de prueba para los tiempos de espera de prueba (en segundos). Si se especifica un solo valor de número entero positivo, se anularán todas las categorías. Si se especifican 4 números enteros separados por comas, se anularán los tiempos de espera para corto, moderado, largo y eterno (en ese orden). De cualquier forma, un valor de -1 le indica a blaze que use sus tiempos de espera predeterminados para esa categoría.
--[no]zip_undeclared_test_outputs
predeterminado: "true"-
Si es verdadero, los resultados de las pruebas no declaradas 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: "conservador"-
Cómo resolver las dependencias de aspecto cuando el formato de salida es uno de {xml,proto,record}. "Desactivado" significa que no se resuelven las dependencias de aspecto. "Conservador" (la opción predeterminada) significa que se agregan todas las dependencias de aspecto declaradas, independientemente de si se les asigna la clase de regla de dependencias directas. "Preciso" significa que solo se agregan los aspectos que pueden estar activos según la clase de regla de las dependencias directas. Ten en cuenta que el modo preciso requiere la carga de otros paquetes para evaluar un solo objetivo, lo que lo hace más lento que los otros modos. Ten en cuenta también que incluso el modo preciso no es del todo preciso: la decisión de si calcular un aspecto se toma en la fase de análisis, que no se ejecuta durante la "consulta de bazel".
Etiquetas:build_file_semantics
--[no]consistent_labels
predeterminado: “false”-
Si está habilitada, cada comando de consulta emite etiquetas como si fuera la función Starlark <code>str</code> aplicada a una instancia de <code>Label</code>. Esto es útil para las herramientas que deben coincidir con el resultado de diferentes comandos de consulta o etiquetas que emiten las reglas. Si no están habilitados, los formateadores de salida pueden emitir nombres de repositorio aparentes (en relación con el repositorio principal) para que el resultado sea más legible.
Etiquetas:terminal_output
--[no]graph:factored
predeterminado: "true"-
Si es verdadero, el gráfico se emitirá "factorizado", es decir, los nodos topológicamente equivalentes se combinarán y sus etiquetas se concatenarán. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--graph:node_limit=<an integer>
predeterminado: “512”-
Es la longitud máxima de la cadena de etiqueta para un nodo de gráfico en el resultado. Las etiquetas más largas se truncarán. -1 significa que no se truncará. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--[no]implicit_deps
predeterminado: "true"-
Si está habilitada, se incluirán dependencias implícitas en el gráfico de dependencias sobre el que opera la consulta. Una dependencia implícita es aquella que no se especifica de forma explícita en el archivo BUILD, pero que Bazel agrega. En el caso de cquery, esta opción controla el filtrado de cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
--[no]include_aspects
predeterminado: "true"-
aquery, cquery: Indica si se deben incluir acciones generadas por aspectos en el resultado. query: No-op (siempre se siguen los aspectos).
Etiquetas:terminal_output
--[no]incompatible_package_group_includes_double_slash
predeterminado: "true"-
Si está habilitada, cuando se genere el atributo "packages" de package_group, no se omitirá el "//" inicial.
Etiquetas:terminal_output
,incompatible_change
--[no]infer_universe_scope
predeterminado: “false”-
Si se establece y no se establece --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 el valor de --universe_scope inferido para una expresión de consulta que usa funciones centradas en el universo (p.ej., "allrdeps") puede no ser lo que deseas, 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 establece --universe_scope, se ignora el valor de esta opción. Nota: Esta opción solo se aplica a "query" (es decir, no a "cquery").
Etiquetas:loading_and_analysis
--[no]line_terminator_null
predeterminado: “false”-
Indica si cada formato finaliza con \0 en lugar de una línea nueva.
Etiquetas:terminal_output
--[no]nodep_deps
predeterminado: "true"-
Si está habilitada, las dependencias de los atributos "nodep" se incluirán en el gráfico de dependencias sobre el que opera la consulta. Un ejemplo común de un atributo "nodep" es "visibility". Ejecuta y analiza el resultado de "info build-language" para obtener información sobre todos los atributos "nodep" en el lenguaje de compilación.
Etiquetas:build_file_semantics
--output=<a string>
predeterminado: "label"-
Es el formato en el que se deben imprimir los resultados de cquery. Los valores permitidos para cquery son: etiqueta, etiqueta_tipo, textoproto, transiciones, proto, proto_transmitido y jsonproto. Si seleccionas "transiciones", también debes especificar la opción --transitions=(lite|full).
Etiquetas:terminal_output
--[no]proto:default_values
predeterminado: "true"-
Si es verdadero, se incluyen los atributos cuyo valor no se especifica de forma explícita en el archivo BUILD; de lo contrario, se omiten. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
--[no]proto:definition_stack
predeterminado: “false”-
Propaga el campo proto definition_stack, que registra para cada instancia de regla la pila de llamadas de Starlark en el momento en que se definió la clase de la regla.
Etiquetas:terminal_output
--[no]proto:flatten_selects
predeterminado: "true"-
Si está habilitada, los atributos configurables creados por select() se aplanan. En el caso de los tipos de lista, la representación aplanada es una lista que contiene cada valor del mapa de selección exactamente una vez. Los tipos escalares se aplanan a nulos.
Etiquetas:build_file_semantics
--[no]proto:include_attribute_source_aspects
predeterminado: “false”-
Propaga el campo proto source_aspect_name de cada atributo con el aspecto de origen del que proviene el atributo (cadena vacía si no es así).
Etiquetas:terminal_output
--[no]proto:include_configurations
predeterminado: "true"-
Si está habilitado, el resultado de proto incluirá información sobre las configuraciones. Cuando se inhabilita,el formato de salida de cquery proto se asemeja al formato de salida de la consulta.
Etiquetas:affects_outputs
--[no]proto:include_synthetic_attribute_hash
predeterminado: “false”-
Indica si se debe calcular y propagar el atributo $internal_attr_hash.
Etiquetas:terminal_output
--[no]proto:instantiation_stack
predeterminado: “false”-
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
--[no]proto:locations
predeterminado: "true"-
Indica si se debe generar información de ubicación en el resultado de proto.
Etiquetas:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
predeterminado: “all”-
Es una lista de atributos separados por comas que se incluirán en el resultado. La configuración predeterminada es todos los atributos. Se establece en una cadena vacía para no mostrar ningún atributo. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
--[no]proto:rule_inputs_and_outputs
predeterminado: "true"-
Indica si se propagan o no los campos rule_input y rule_output.
Etiquetas:terminal_output
--query_file=<a string>
predeterminado: ""-
Si se establece, la consulta leerá la consulta del archivo que se nombra aquí, en lugar de la línea de comandos. Especificar un archivo aquí y una consulta de línea de comandos es un error.
Etiquetas:changes_inputs
--[no]relative_locations
predeterminado: “false”-
Si es verdadero, la ubicación de los archivos BUILD en los resultados de 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 establecer esta opción en verdadero para obtener un resultado coherente en todas las máquinas.
Etiquetas:terminal_output
--show_config_fragments=<off, direct or transitive>
predeterminado: "off"-
Muestra los fragmentos de configuración que requiere una regla y sus dependencias transitivas. Esto puede ser útil para evaluar cuánto se puede recortar un gráfico objetivo configurado.
Etiquetas:affects_outputs
--starlark:expr=<a string>
predeterminado: ""-
Es una expresión Starlark para dar formato a cada destino configurado en el modo --output=starlark de cquery. El objetivo configurado está vinculado a "target". Si no se especifican --starlark:expr ni --starlark:file, esta opción se establecerá de forma predeterminada en "str(target.label)". Especificar --starlark:expr y --starlark:file es un error.
Etiquetas:terminal_output
--starlark:file=<a string>
predeterminado: ""-
Es el nombre de un archivo que define una función Starlark llamada "format", de un argumento, que se aplica a cada destino configurado para darle formato como una cadena. Especificar --starlark:expr y --starlark:file es un error. Consulta la ayuda de --output=starlark para obtener más detalles.
Etiquetas:terminal_output
--[no]tool_deps
predeterminado: "true"-
Consulta: Si se inhabilita, las dependencias de "configuración de ejecución" no se incluirán en el gráfico de dependencias sobre el que opera la consulta. Un borde de dependencia de "configuración de ejecución", como el de cualquier regla "proto_library" al compilador de protocolos, suele apuntar a una herramienta que se ejecuta durante la compilación en lugar de a una parte del mismo programa "objetivo".
Cquery: Si se inhabilita, filtra todos los objetivos configurados que crucen una transición de ejecución desde el objetivo de nivel superior que descubrió este objetivo configurado. Esto significa que, si el objetivo de nivel superior está en la configuración de destino, solo se mostrarán los objetivos configurados también en la configuración de destino. Si el objetivo de nivel superior está en la configuración de exec, solo se mostrarán los objetivos configurados de exec. Esta opción NO excluirá las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
- Valor predeterminado de
--transitions=<full, lite or none>
: “none” -
Es el formato en el que cquery imprimirá la información de transición.
Etiquetas:affects_outputs
--universe_scope=<comma-separated list of options>
predeterminado: ""-
Es un conjunto de patrones de segmentación (aditivos y sustractivos) separados por comas. La consulta se puede realizar en el universo definido por el cierre transitivo de los destinos especificados. Esta opción se usa para los comandos query y cquery.
En el caso de cquery, la entrada de esta opción son los objetivos en los que se compilan todas las respuestas, por lo que esta opción puede afectar las configuraciones y las transiciones. Si no se especifica esta opción, se supone que los destinos de nivel superior son los que se analizan de la expresión de consulta. Nota: En el caso de cquery, si no especificas esta opción, es posible que la compilación falle si los destinos analizados de la expresión de consulta no se pueden compilar con opciones de nivel superior.
Etiquetas:loading_and_analysis
- Opciones que activan optimizaciones del tiempo de compilación:
--[no]experimental_filter_library_jar_with_program_jar
predeterminado: “false”-
Filtra el ProgramJar de ProGuard para quitar las clases que también estén presentes en el LibraryJar.
Etiquetas:action_command_lines
--[no]experimental_inmemory_dotd_files
predeterminado: "true"-
Si se habilita, los archivos .d de C++ se pasarán en la memoria directamente desde los nodos de compilación remotos en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_inmemory_jdeps_files
predeterminado: "true"-
Si está habilitado, los archivos de dependencia (.jdeps) generados a partir de compilaciones de Java se pasarán en la memoria directamente desde los nodos de compilación remotos en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_objc_include_scanning
predeterminado: “false”-
Indica si se debe incluir el análisis de C/C++ objetivo.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
--[no]experimental_retain_test_configuration_across_testonly
predeterminado: “false”-
Cuando se habilita, --trim_test_configuration no recortará la configuración de prueba de las reglas marcadas como testonly=1. Esto se hace para reducir los problemas de conflicto de acciones cuando las reglas que no son de prueba dependen de las reglas de cc_test. No tiene efecto si --trim_test_configuration es falso.
Etiquetas:loading_and_analysis
,loses_incremental_state
--[no]experimental_starlark_cc_import
predeterminado: “false”-
Si está habilitada, se puede usar la versión de Starlark de cc_import.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_unsupported_and_brittle_include_scanning
predeterminado: “false”-
Determina si se deben reducir las entradas a la compilación de C/C++ a través del análisis de líneas #include de los archivos de entrada. Esto puede mejorar el rendimiento y la incrementalidad, ya que reduce el tamaño de los árboles de entrada de compilación. Sin embargo, también puede interrumpir las compilaciones porque el escáner de inclusión no implementa por completo la semántica del preprocesador C. En particular, no comprende las directivas #include dinámicas y omite la lógica condicional del preprocesador. Úsala bajo tu propia responsabilidad. Se cerrarán todos los problemas relacionados con esta marca que se hayan presentado.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
--[no]incremental_dexing
predeterminado: "true"-
Realiza la mayor parte del trabajo de dexing por separado para cada archivo JAR.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]objc_use_dotd_pruning
predeterminado: "true"-
Si se establece, los archivos .d emitidos por clang se usarán para podar el conjunto de entradas que se pasan a las compilaciones de objc.
Etiquetas:changes_inputs
,loading_and_analysis
--[no]process_headers_in_dependencies
predeterminado: “false”-
Cuando compilas un destino //a:a, procesa los encabezados en todos los destinos de los que depende //a:a (si el procesamiento de encabezados está habilitado para la cadena de herramientas).
Etiquetas:execution
--[no]trim_test_configuration
predeterminado: "true"-
Cuando se habilita, se borran las opciones relacionadas con las pruebas debajo del nivel superior de la compilación. Cuando esta marca está activa, las pruebas no se pueden compilar como dependencias de reglas que no son de prueba, pero los cambios en las opciones relacionadas con las pruebas no harán que se vuelvan a analizar las reglas que no son de prueba.
Etiquetas:loading_and_analysis
,loses_incremental_state
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Valor predeterminado de
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: “-.*”. -
Imprime información de depuración durante la resolución de la cadena de herramientas. La marca toma una regex, que se compara con los tipos de cadena de herramientas y los objetivos específicos para ver cuál depurar. Se pueden separar varias regex con comas y, luego, cada una se verifica por separado. Nota: El resultado de esta marca es muy complejo y es probable que solo sea útil para expertos en la resolución de cadenas de herramientas.
Etiquetas:terminal_output
- Son opciones que especifican o alteran una entrada genérica en un comando de Bazel que no pertenece a otras categorías.:
- Se acumulan varios usos de
--flag_alias=<a 'name=value' flag alias>
. -
Establece un nombre abreviado para una marca de Starlark. Toma un solo par clave-valor en el formato "<clave>=<valor>" como argumento.
Etiquetas:changes_inputs
--[no]incompatible_default_to_explicit_init_py
predeterminado: “false”-
Esta marca cambia el comportamiento predeterminado para que los archivos __init__.py ya no se creen automáticamente en los archivos de ejecución de los destinos de Python. Específicamente, cuando un objetivo py_binary o py_test tiene legacy_create_init establecido en "auto" (el valor predeterminado), se considera falso solo si se establece esta marca. Consulta https://github.com/bazelbuild/bazel/issues/10076.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_py2_outputs_are_suffixed
predeterminado: "true"-
Si es verdadero, los destinos compilados en la configuración de Python 2 aparecerán en una raíz de salida que incluye el sufijo "-py2", mientras que los destinos compilados para Python 3 aparecerán en una raíz sin sufijo relacionado con Python. Esto significa que el symlink de conveniencia "bazel-bin" apuntará a destinos de Python 3 en lugar de Python 2. Si habilitas esta opción, también se recomienda habilitar `--incompatible_py3_is_default`.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_py3_is_default
predeterminado: "true"-
Si es verdadero, los destinos "py_binary" y "py_test" que no establezcan su atributo "python_version" (o "default_python_version") usarán PY3 de forma predeterminada en lugar de PY2. Si estableces esta marca, también se recomienda establecer `--incompatible_py2_outputs_are_suffixed`.
Etiquetas:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_use_python_toolchains
predeterminado: "true"-
Si se establece como verdadero, las reglas ejecutables de Python nativas usarán el entorno de ejecución de Python especificado por la cadena de herramientas de Python, en lugar del entorno de ejecución que proporcionan las marcas heredadas, como --python_top.
Etiquetas:loading_and_analysis
,incompatible_change
--python_version=<PY2 or PY3>
predeterminado: Consulta la descripción-
Es el modo de versión principal de Python, ya sea "PY2" o "PY3". Ten en cuenta que esto se anula con los destinos "py_binary" y "py_test" (incluso si no especifican una versión de forma explícita), por lo que, por lo general, no hay muchos motivos para proporcionar esta marca.
Etiquetas:loading_and_analysis
,affects_outputs
- Opciones misceláneas que no se clasifican de otra manera:
--[no]cache_test_results
[-t
] predeterminado: "auto"- Si se establece en “auto”, Bazel vuelve a ejecutar una prueba solo si se cumplen las siguientes condiciones: (1) Bazel detecta cambios en la prueba o sus dependencias, (2) la prueba está marcada como externa, (3) se solicitaron varias ejecuciones de prueba con --runs_per_test o(4) la prueba falló anteriormente. Si se establece como “sí”, Bazel almacena en caché todos los resultados de las pruebas, excepto las marcadas como externas. Si se establece en "no", Bazel no almacena en caché ningún resultado de la prueba.
--[no]experimental_cancel_concurrent_tests
predeterminado: “false”-
Si es verdadero, Blaze cancelará las pruebas que se ejecutan de forma simultánea en la primera ejecución correcta. Esto solo es útil en combinación con --runs_per_test_detects_flakes.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_fetch_all_coverage_outputs
predeterminado: “false”-
Si es verdadero, Bazel recupera todo el directorio de datos de cobertura para cada prueba durante una ejecución de cobertura.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_generate_llvm_lcov
predeterminado: “false”-
Si es verdadero, la cobertura de clang generará un informe LCOV.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_j2objc_header_map
predeterminado: "true"- Determina si se debe generar un mapa de encabezados de J2ObjC en paralelo con la transpilación de J2ObjC.
--[no]experimental_j2objc_shorter_header_path
predeterminado: “false”-
Indica si se debe generar con una ruta de encabezado más corta (usa “_ios” en lugar de “_j2objc”).
Etiquetas:affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
predeterminado: "javabuilder"- Habilita classpaths reducidos para compilaciones de Java.
--[no]experimental_limit_android_lint_to_android_constrained_java
predeterminado: “false”-
Limita --experimental_run_android_lint_on_java_rules a las bibliotecas compatibles con Android.
Etiquetas:affects_outputs
--[no]experimental_run_android_lint_on_java_rules
predeterminado: “false”-
Determina si se deben validar las fuentes java_*.
Etiquetas:affects_outputs
--[no]explicit_java_test_deps
predeterminado: “false”- Especifica de forma explícita una dependencia a JUnit o Hamcrest en un java_test en lugar de obtenerla accidentalmente de las dependencias de TestRunner. Por el momento, solo funciona para bazel.
--host_java_launcher=<a build target label>
predeterminado: Consulta la descripción- Es el selector de Java que usan las herramientas que se ejecutan durante una compilación.
- Se acumulan varios usos de
--host_javacopt=<a string>
. - Opciones adicionales para pasar a javac cuando se compilan herramientas que se ejecutan durante una compilación.
- Se acumulan varios usos de
--host_jvmopt=<a string>
. - Opciones adicionales para pasar a la VM de Java cuando se compilan herramientas que se ejecutan durante la compilación. Estas opciones se agregarán a las opciones de inicio de la VM de cada destino java_binary.
--[no]incompatible_check_sharding_support
predeterminado: "true"-
Si es verdadero, Bazel fallará en una prueba fragmentada si el ejecutor de pruebas no indica que admite el fragmentación tocando el archivo en la ruta de acceso en TEST_SHARD_STATUS_FILE. Si es falso, un ejecutor de pruebas que no admita la fragmentación hará que todas las pruebas se ejecuten en cada fragmento.
Etiquetas:incompatible_change
--[no]incompatible_exclusive_test_sandboxed
predeterminado: "true"-
Si es verdadero, las pruebas exclusivas se ejecutarán con la estrategia de zona de pruebas. Agrega la etiqueta "local" para forzar que se ejecute una prueba exclusiva de forma local.
Etiquetas:incompatible_change
--[no]incompatible_strict_action_env
predeterminado: “false”-
Si es verdadero, Bazel usa un entorno con un valor estático para PATH y no hereda LD_LIBRARY_PATH. Usa --action_env=ENV_VARIABLE si deseas heredar variables de entorno específicas del cliente, pero ten en cuenta que, de esta manera, se puede evitar la caché entre usuarios si se usa una caché compartida.
Etiquetas:loading_and_analysis
,incompatible_change
- Se acumulan varios usos de
--j2objc_translation_flags=<comma-separated list of options>
. - : Opciones adicionales para pasar a la herramienta J2ObjC.
--java_debug
-
Hace que la máquina virtual de Java de una prueba de Java espere una conexión de un depurador compatible con JDWP (como jdb) antes de iniciar la prueba. Implica -test_output=streamed.
Se expande a:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
--[no]java_deps
predeterminado: "true"- Genera información de dependencia (por ahora, el classpath del tiempo de compilación) por destino de Java.
--[no]java_header_compilation
predeterminado: "true"- Compila ijars directamente desde la fuente.
--java_language_version=<a string>
predeterminado: ""- La versión del lenguaje Java
--java_launcher=<a build target label>
predeterminado: Consulta la descripción- Es el selector de Java que se usará cuando se compilen objetos binarios de Java. Si esta marca se establece en la cadena vacía, se usa el selector de JDK. El atributo "launcher" anula esta marca.
--java_runtime_version=<a string>
predeterminado: "local_jdk"- La versión del entorno de ejecución de Java
- Se acumulan varios usos de
--javacopt=<a string>
. - Opciones adicionales para pasar a javac.
- Se acumulan varios usos de
--jvmopt=<a string>
. - Opciones adicionales para pasar a la VM de Java. Estas opciones se agregarán a las opciones de inicio de la VM de cada destino java_binary.
--legacy_main_dex_list_generator=<a build target label>
predeterminado: Consulta la descripción- especifica un objeto binario que se usará para generar la lista de clases que deben estar en el archivo DEX principal cuando se compila el multidex heredado.
--optimizing_dexer=<a build target label>
predeterminado: Consulta la descripción- Especifica un objeto binario para usar y realizar la conversión a Dex sin fragmentación.
- Se acumulan varios usos de
--plugin=<a build target label>
. - Plug-ins para usar en la compilación. Actualmente, funciona con java_plugin.
--proguard_top=<a build target label>
predeterminado: Consulta la descripción- Especifica qué versión de ProGuard se usará para quitar el código cuando se compila un objeto binario de Java.
--proto_compiler=<a build target label>
predeterminado: "@bazel_tools//tools/proto:protoc"-
Es la etiqueta del protocompilador.
Etiquetas:affects_outputs
,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
,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 de j2objc
Etiquetas:affects_outputs
,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
,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
,loading_and_analysis
- Se acumulan varios usos de
--protocopt=<a string>
. -
Opciones adicionales para pasar al compilador de protobuf.
Etiquetas:affects_outputs
--[no]runs_per_test_detects_flakes
predeterminado: “false”- Si es verdadero, cualquier fragmento en el que se apruebe al menos una ejecución o intento y falle al menos una ejecución o intento tendrá el estado FLAKY.
--shell_executable=<a path>
predeterminado: Consulta la descripción-
Ruta de acceso absoluta al ejecutable de shell que usará Bazel. Si no se establece, pero la variable de entorno BAZEL_SH se establece en la primera invocación de Bazel (que inicia un servidor de Bazel), Bazel la usará. Si no se establece ninguno, Bazel usa una ruta de acceso predeterminada fija según el sistema operativo en el que se ejecuta (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, todos los demás: /bin/bash). Ten en cuenta que usar un shell que no sea compatible con bash puede generar fallas de compilación o de tiempo de ejecución de los objetos binarios generados.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--test_arg=<a string>
. - Especifica opciones y argumentos adicionales que se deben pasar al ejecutable de prueba. Se puede usar varias veces para especificar varios argumentos. Si se ejecutan varias pruebas, cada una de ellas recibirá argumentos idénticos. Solo lo usa el comando "bazel test".
--test_filter=<a string>
predeterminado: Consulta la descripción- : Especifica un filtro para reenviar al framework de pruebas. Se usa para limitar las pruebas que se ejecutan. Ten en cuenta que esto no afecta los destinos que se compilan.
--test_result_expiration=<an integer>
predeterminado: “-1”- Esta opción está obsoleta y no tiene ningún efecto.
--[no]test_runner_fail_fast
predeterminado: “false”- Redirecciona la opción de falla rápida al ejecutor de pruebas. El ejecutor de pruebas debe detener la ejecución en la primera falla.
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>
predeterminado: "explicit"- Especifica la estrategia para el fragmentación de prueba: "explicit" para usar solo la fragmentación si está presente el atributo BUILD "shard_count". "disabled" para nunca usar el fragmentación de prueba. "forced=k" para aplicar fragmentos "k" para las pruebas, independientemente del atributo BUILD "shard_count".
--tool_java_language_version=<a string>
predeterminado: ""- La versión del 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
--[no]use_ijars
predeterminado: "true"- Si está habilitada, esta opción hace que la compilación de Java use archivos JAR de interfaz. Esto generará una compilación incremental más rápida, pero los mensajes de error pueden ser diferentes.
Opciones de volcado
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
. -
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, se puede hacer que los repositorios externos funcionen en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_connector_attempts=<an integer>
predeterminado: “8”-
Es la cantidad máxima de intentos de descargas HTTP.
Etiquetas:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
predeterminado: “0s”-
Es el tiempo de espera máximo para los reintentos de descarga HTTP. Con un valor de 0, no se define un tiempo de espera máximo.
Etiquetas:bazel_internal_configuration
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la 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, se usa el valor predeterminado de '<output_user_root>/cache/repos/v1'.
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
predeterminado: “false”-
Si se establece, 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 se inhabilita por completo; 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 la compilación:
--gc_thrashing_threshold=<an integer in 0-100 range>
predeterminado: "100"-
Es el porcentaje de espacio ocupado (de 0 a 100) por encima del cual GcThrashingDetector considera los eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, se inhabilita GcThrashingDetector.
Etiquetas:host_machine_resource_optimizations
- Opciones que controlan el resultado del comando:
--[no]action_cache
predeterminado: “false”-
Ejecuta el volcado del contenido de la caché de acciones.
Etiquetas:bazel_monitoring
--[no]packages
predeterminado: “false”-
Escribe el contenido de la caché del paquete.
Etiquetas:bazel_monitoring
--[no]rule_classes
predeterminado: “false”-
Ejecuta el volcado de clases de reglas.
Etiquetas:bazel_monitoring
--[no]rules
predeterminado: “false”-
Reglas de volcado, incluidos los recuentos y el uso de memoria (si se realiza un seguimiento de la memoria)
Etiquetas:bazel_monitoring
--skyframe=<off, summary, count, deps or rdeps>
predeterminado: "off"-
Ejecuta el comando para volcar el gráfico de Skyframe: "off", "summary", "count", "deps" o "rdeps".
Etiquetas:bazel_monitoring
- Valor predeterminado de
--skykey_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: “.*”. -
Filtro de regex de nombres de SkyKey para la salida. Solo se usa con --skyframe=deps, rdeps.
Etiquetas:bazel_monitoring
--skylark_memory=<a string>
predeterminado: Consulta la descripción-
Descarga un perfil de memoria compatible con pprof en la ruta especificada. Para obtener más información, consulta https://github.com/google/pprof.
Etiquetas:bazel_monitoring
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
. -
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitadas en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "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 un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
predeterminado: “update”- especifica cómo usar el archivo de bloqueo y si se debe usar o no. 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 mostrar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
. - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso proporcionada es una ruta de acceso absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta de acceso relativa, se hará referencia al directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace".
- Se acumulan varios usos de
--registry=<a string>
. -
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los 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 haga que Bazel falle con un error de OOM. Cada límite se especifica como <period>:<count>, en el que period es una duración y count es un número entero positivo. Si más del porcentaje --gc_thrashing_threshold del espacio a perpetuidad (heap de generación anterior) permanece ocupado después de <count> GC completas consecutivas en <period>, se activa un error de OOM. Se pueden especificar varios límites separados por comas.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Es una marca para la configuración avanzada del motor Skyframe interno 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 GC completo, se descartará el estado temporal innecesario de Skyframe hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC completos nunca activarán las bajadas. 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"-
Es una marca para la configuración avanzada del motor Skyframe interno 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 GC menor, se descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC menores nunca activarán las bajadas. 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
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es de al menos este límite, descartará el estado temporal innecesario de Skyframe. Si ajustas este parámetro, es posible que puedas mitigar el impacto del tiempo de ejecución de la fragmentación de GC, cuando esta se produce (i) por el uso de memoria de este estado temporal y (ii) es más costoso 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:
--[no]experimental_command_profile
predeterminado: “false”- Graba un perfil de CPU de Java Flight Recorder en un archivo profile.jfr en el directorio base de salida. La sintaxis y la semántica de esta marca pueden cambiar en el futuro para admitir diferentes tipos de perfiles o formatos de salida. Úsala bajo tu propio riesgo.
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
- Opciones que especifican o alteran una entrada genérica a un comando de Bazel que no se incluye en otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de almacenamiento en caché y ejecución remotas:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite"), seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
--experimental_worker_for_repo_fetching=<off, platform or virtual>
predeterminado: "off"- Es el modo de subprocesos que se usará para recuperar el repo. Si se establece en "desactivado", no se usa ningún subproceso de trabajo y la recuperación del repo está sujeta a reinicios. De lo contrario, usa un subproceso de plataforma (es decir, un subproceso del SO) si se establece en "platform" o un subproceso virtual si se establece en "virtual".
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
. - Anula un repositorio con una ruta de acceso local en el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es una ruta absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta relativa, se relaciona con el directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace".
Opciones de recuperación
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
. -
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, los repositorios externos pueden funcionar en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_connector_attempts=<an integer>
predeterminado: “8”-
Es la cantidad máxima de intentos de descargas HTTP.
Etiquetas:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
predeterminado: “0s”-
Es el tiempo de espera máximo para los reintentos de descarga HTTP. Con un valor de 0, no se define un tiempo de espera máximo.
Etiquetas:bazel_internal_configuration
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la 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, se usa el valor predeterminado de '<output_user_root>/cache/repos/v1'.
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
predeterminado: “false”-
Si se establece, 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 se inhabilita por completo; 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 la compilación:
--[no]all
predeterminado: “false”-
Obtiene todos los repositorios externos necesarios para compilar cualquier destino o repositorio. Solo funciona cuando --enable_bzlmod está activado.
Etiquetas:changes_inputs
--[no]configure
predeterminado: “false”-
Solo recupera repositorios marcados como "configurar" para la configuración del sistema. Solo funciona cuando --enable_bzlmod está activado.
Etiquetas:changes_inputs
--[no]force
predeterminado: “false”-
Ignora el repositorio existente, si corresponde, y vuelve a recuperarlo de forma forzosa. Solo funciona cuando --enable_bzlmod está activado.
Etiquetas:changes_inputs
--gc_thrashing_threshold=<an integer in 0-100 range>
predeterminado: "100"-
Es el porcentaje de espacio ocupado (de 0 a 100) por encima del cual GcThrashingDetector considera los eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, se inhabilita GcThrashingDetector.
Etiquetas:host_machine_resource_optimizations
--[no]keep_going
[-k
] predeterminado: "false"-
Continúa tanto como sea posible después de un error. Si bien no se pueden analizar el objetivo que falló ni los que dependen de él, sí se pueden analizar otros requisitos previos de estos objetivos.
Etiquetas:eagerness_to_exit
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
predeterminado: “auto”-
Cantidad de subprocesos en paralelo que se usarán para la fase de carga o análisis. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". "auto" establece un valor predeterminado razonable según los recursos del host. Debe ser 1 como mínimo.
Etiquetas:bazel_internal_configuration
- Se acumulan varios usos de
--repo=<a string>
. -
Solo recupera el repositorio especificado, que puede ser {@apparent_repo_name} o {@@canonical_repo_name}. Solo funciona cuando --enable_bzlmod está activado.
Etiquetas:changes_inputs
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility
predeterminado: “false”-
Si incompatible_enforce_config_setting_visibility=false, esto es una operación no realizada. De lo contrario, si esta marca es falsa, cualquier config_setting sin un atributo de visibilidad explícito es //visibility:public. Si esta marca es verdadera, config_setting sigue la misma lógica de visibilidad que todas las demás reglas. Consulta https://github.com/bazelbuild/bazel/issues/12933.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
predeterminado: "true"-
Si es verdadero, aplica las restricciones de visibilidad de config_setting. Si es falso, todos los config_setting son visibles para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
. -
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitadas en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "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 un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
predeterminado: “update”- especifica cómo usar el archivo de bloqueo y si se debe usar o no. 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 mostrar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
. - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso proporcionada es una ruta de acceso absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta de acceso relativa, se hará referencia al directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace".
- Se acumulan varios usos de
--registry=<a string>
. -
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los 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 haga que Bazel falle con un error de OOM. Cada límite se especifica como <period>:<count>, en el que period es una duración y count es un número entero positivo. Si más del porcentaje --gc_thrashing_threshold del espacio a perpetuidad (heap de generación anterior) permanece ocupado después de <count> GC completas consecutivas en <period>, se activa un error de OOM. Se pueden especificar varios límites separados por comas.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Es una marca para la configuración avanzada del motor Skyframe interno 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 GC completo, se descartará el estado temporal innecesario de Skyframe hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC completos nunca activarán las bajadas. 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"-
Es una marca para la configuración avanzada del motor Skyframe interno 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 GC menor, se descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC menores nunca activarán las bajadas. 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
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es de al menos este límite, descartará el estado temporal innecesario de Skyframe. Si ajustas este parámetro, es posible que puedas mitigar el impacto del tiempo de ejecución de la fragmentación de GC, cuando esta se produce (i) por el uso de memoria de este estado temporal y (ii) es más costoso 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:
--[no]experimental_command_profile
predeterminado: “false”- Graba un perfil de CPU de Java Flight Recorder en un archivo profile.jfr en el directorio base de salida. La sintaxis y la semántica de esta marca pueden cambiar en el futuro para admitir diferentes tipos de perfiles o formatos de salida. Úsala bajo tu propio riesgo.
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
--experimental_repository_resolved_file=<a string>
predeterminado: ""-
Si no está vacío, escribe un valor de Starlark con la información resuelta de todas las reglas del repositorio de Starlark que se ejecutaron.
Etiquetas:affects_outputs
- Son opciones que especifican o alteran una entrada genérica en un comando de Bazel que no pertenece a otras categorías.:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de almacenamiento en caché y ejecución remotas:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite"), seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
--experimental_worker_for_repo_fetching=<off, platform or virtual>
predeterminado: "off"- Es el modo de subprocesos que se usará para recuperar el repo. Si se establece en "desactivado", no se usa ningún subproceso de trabajo y la recuperación del repo está sujeta a reinicios. De lo contrario, usa un subproceso de plataforma (es decir, un subproceso del SO) si se establece en "platform" o un subproceso virtual si se establece en "virtual".
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--deleted_packages=<comma-separated list of package names>
. - Es una lista separada por comas de nombres de paquetes que el sistema de compilación considerará inexistentes, incluso si son visibles en algún lugar de la ruta de acceso del paquete. Usa esta opción cuando borres un subpaquete "x/y" de un paquete existente "x". Por ejemplo, después de borrar x/y/BUILD en tu cliente, es posible que el sistema de compilación se queje si encuentra una etiqueta "//x:y/z" si otra entrada de package_path aún la proporciona. Especificar --deleted_packages x/y evita este problema.
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
. - Anula un repositorio con una ruta de acceso local en el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es una ruta absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta relativa, se relaciona con el directorio de trabajo actual. Si la ruta de acceso determinada 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%"- Es una lista separada por dos puntos de dónde buscar paquetes. Los elementos que comienzan con "%workspace%" son relativos al lugar de trabajo que los contiene. Si se omite o está vacío, el valor predeterminado es el resultado de "bazel info default-package-path".
--[no]show_loading_progress
predeterminado: "true"- Si está habilitado, hace que Bazel imprima mensajes de "Carga del paquete:".
Opciones de ayuda
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
. -
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, se puede hacer que los repositorios externos funcionen en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_connector_attempts=<an integer>
predeterminado: “8”-
Es la cantidad máxima de intentos de descargas HTTP.
Etiquetas:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
predeterminado: “0s”-
Es el tiempo de espera máximo para los reintentos de descarga HTTP. Con un valor de 0, no se define un tiempo de espera máximo.
Etiquetas:bazel_internal_configuration
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la 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, se usa el valor predeterminado de '<output_user_root>/cache/repos/v1'.
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
predeterminado: “false”-
Si se establece, 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 se inhabilita por completo; 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 la compilación:
--gc_thrashing_threshold=<an integer in 0-100 range>
predeterminado: "100"-
Es el porcentaje de espacio ocupado (de 0 a 100) por encima del cual GcThrashingDetector considera los eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, se inhabilita GcThrashingDetector.
Etiquetas:host_machine_resource_optimizations
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
. -
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitadas en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "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 un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
predeterminado: “update”- especifica cómo usar el archivo de bloqueo y si se debe usar o no. 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 mostrar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
. - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso proporcionada es una ruta de acceso absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta de acceso relativa, se hará referencia al directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace".
- Se acumulan varios usos de
--registry=<a string>
. -
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los 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 haga que Bazel falle con un error de OOM. Cada límite se especifica como <period>:<count>, en el que period es una duración y count es un número entero positivo. Si más del porcentaje --gc_thrashing_threshold del espacio a perpetuidad (heap de generación anterior) permanece ocupado después de <count> GC completas consecutivas en <period>, se activa un error de OOM. Se pueden especificar varios límites separados por comas.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Es una marca para la configuración avanzada del motor Skyframe interno 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 GC completo, se descartará el estado temporal innecesario de Skyframe hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC completos nunca activarán las bajadas. 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"-
Es una marca para la configuración avanzada del motor Skyframe interno 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 GC menor, se descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC menores nunca activarán las bajadas. 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
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es de al menos este límite, descartará el estado temporal innecesario de Skyframe. Si ajustas este parámetro, es posible que puedas mitigar el impacto del tiempo de ejecución de la fragmentación de GC, cuando esta se produce (i) por el uso de memoria de este estado temporal y (ii) es más costoso 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:
--[no]experimental_command_profile
predeterminado: “false”- Graba un perfil de CPU de Java Flight Recorder en un archivo profile.jfr en el directorio base de salida. La sintaxis y la semántica de esta marca pueden cambiar en el futuro para admitir diferentes tipos de perfiles o formatos de salida. Úsala bajo tu propio riesgo.
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
--help_verbosity=<long, medium or short>
predeterminado: “medium”-
Selecciona la verbosidad del comando help.
Etiquetas:affects_outputs
,terminal_output
--long
[-l
]-
Muestra la descripción completa de cada opción, en lugar de solo su nombre.
Se expande a:
--help_verbosity=long
Etiquetas:affects_outputs
,terminal_output
--short
-
Muestra solo los nombres de las opciones, no sus tipos ni significados.
Se expande a:
--help_verbosity=short
Etiquetas:affects_outputs
,terminal_output
- Opciones que especifican o alteran una entrada genérica a un comando de Bazel que no pertenece a otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite"), seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
--experimental_worker_for_repo_fetching=<off, platform or virtual>
predeterminado: "off"- Es el modo de subprocesos que se usará para recuperar el repo. Si se establece en "desactivado", no se usa ningún subproceso de trabajo y la recuperación del repo está sujeta a reinicios. De lo contrario, usa un subproceso de plataforma (es decir, un subproceso del SO) si se establece en "platform" o un subproceso virtual si se establece en "virtual".
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
. - Anula un repositorio con una ruta de acceso local en el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es una ruta absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta relativa, se relaciona con el directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace".
Opciones de información
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
. -
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, se puede hacer que los repositorios externos funcionen en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_connector_attempts=<an integer>
predeterminado: “8”-
Es la cantidad máxima de intentos de descargas HTTP.
Etiquetas:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
predeterminado: “0s”-
Es el tiempo de espera máximo para los reintentos de descarga HTTP. Con un valor de 0, no se define un tiempo de espera máximo.
Etiquetas:bazel_internal_configuration
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la 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, se usa el valor predeterminado de '<output_user_root>/cache/repos/v1'.
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
predeterminado: “false”-
Si se establece, 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 se inhabilita por completo; 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 la compilación:
--gc_thrashing_threshold=<an integer in 0-100 range>
predeterminado: "100"-
Es el porcentaje de espacio ocupado (de 0 a 100) por encima del cual GcThrashingDetector considera los eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, se inhabilita GcThrashingDetector.
Etiquetas:host_machine_resource_optimizations
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
. -
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitadas en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "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 un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
predeterminado: “update”- especifica cómo usar el archivo de bloqueo y si se debe usar o no. 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 mostrar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
. - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso proporcionada es una ruta de acceso absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta de acceso relativa, se hará referencia al directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace".
- Se acumulan varios usos de
--registry=<a string>
. -
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los 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 haga que Bazel falle con un error de OOM. Cada límite se especifica como <period>:<count>, en el que period es una duración y count es un número entero positivo. Si más del porcentaje --gc_thrashing_threshold del espacio a perpetuidad (heap de generación anterior) permanece ocupado después de <count> GC completas consecutivas en <period>, se activa un error de OOM. Se pueden especificar varios límites separados por comas.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Es una marca para la configuración avanzada del motor Skyframe interno 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 GC completo, se descartará el estado temporal innecesario de Skyframe hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC completos nunca activarán las bajadas. 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"-
Es una marca para la configuración avanzada del motor Skyframe interno 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 GC menor, se descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC menores nunca activarán las bajadas. 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
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es de al menos este límite, descartará el estado temporal innecesario de Skyframe. Si ajustas este parámetro, es posible que puedas mitigar el impacto del tiempo de ejecución de la fragmentación de GC, cuando esta se produce (i) por el uso de memoria de este estado temporal y (ii) es más costoso 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:
--[no]experimental_command_profile
predeterminado: “false”- Graba un perfil de CPU de Java Flight Recorder en un archivo profile.jfr en el directorio base de salida. La sintaxis y la semántica de esta marca pueden cambiar en el futuro para admitir diferentes tipos de perfiles o formatos de salida. Úsala bajo tu propio riesgo.
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
--[no]show_make_env
predeterminado: “false”-
Incluye el entorno "Make" en el resultado.
Etiquetas:affects_outputs
,terminal_output
- Son opciones que especifican o alteran una entrada genérica en un comando de Bazel que no se incluye en otras categorías.:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite"), seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
--experimental_worker_for_repo_fetching=<off, platform or virtual>
predeterminado: "off"- Es el modo de subprocesos que se usará para recuperar el repo. Si se establece en "desactivado", no se usa ningún subproceso de trabajo y la recuperación del repo está sujeta a reinicios. De lo contrario, usa un subproceso de plataforma (es decir, un subproceso del SO) si se establece en "platform" o un subproceso virtual si se establece en "virtual".
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
. - Anula un repositorio con una ruta de acceso local en el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es una ruta absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta relativa, se relaciona con el directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace".
Opciones de licencia
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
. -
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, se puede hacer que los repositorios externos funcionen en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_connector_attempts=<an integer>
predeterminado: “8”-
Es la cantidad máxima de intentos de descargas HTTP.
Etiquetas:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
predeterminado: “0s”-
Es el tiempo de espera máximo para los reintentos de descarga HTTP. Con un valor de 0, no se define un tiempo de espera máximo.
Etiquetas:bazel_internal_configuration
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la 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, se usa el valor predeterminado de '<output_user_root>/cache/repos/v1'.
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
predeterminado: “false”-
Si se establece, 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 se inhabilita por completo; 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 la compilación:
--gc_thrashing_threshold=<an integer in 0-100 range>
predeterminado: "100"-
Es el porcentaje de espacio ocupado (de 0 a 100) por encima del cual GcThrashingDetector considera los eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, se inhabilita GcThrashingDetector.
Etiquetas:host_machine_resource_optimizations
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
. -
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitadas en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "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 un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
predeterminado: “update”- especifica cómo usar el archivo de bloqueo y si se debe usar o no. 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 mostrar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
. - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso proporcionada es una ruta de acceso absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta de acceso relativa, se hará referencia al directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace".
- Se acumulan varios usos de
--registry=<a string>
. -
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los 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 haga que Bazel falle con un error de OOM. Cada límite se especifica como <period>:<count>, en el que period es una duración y count es un número entero positivo. Si más del porcentaje --gc_thrashing_threshold del espacio a perpetuidad (heap de generación anterior) permanece ocupado después de <count> GC completas consecutivas en <period>, se activa un error de OOM. Se pueden especificar varios límites separados por comas.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Es una marca para la configuración avanzada del motor Skyframe interno 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 GC completo, se descartará el estado temporal innecesario de Skyframe hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC completos nunca activarán las bajadas. 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"-
Es una marca para la configuración avanzada del motor Skyframe interno 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 GC menor, se descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC menores nunca activarán las bajadas. 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
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es de al menos este límite, descartará el estado temporal innecesario de Skyframe. Si ajustas este parámetro, es posible que puedas mitigar el impacto del tiempo de ejecución de la fragmentación de GC, cuando esta se produce (i) por el uso de memoria de este estado temporal y (ii) es más costoso 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:
--[no]experimental_command_profile
predeterminado: “false”- Graba un perfil de CPU de Java Flight Recorder en un archivo profile.jfr en el directorio base de salida. La sintaxis y la semántica de esta marca pueden cambiar en el futuro para admitir diferentes tipos de perfiles o formatos de salida. Úsala bajo tu propio riesgo.
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
- Opciones que especifican o alteran una entrada genérica a un comando de Bazel que no se incluye en otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite"), seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
--experimental_worker_for_repo_fetching=<off, platform or virtual>
predeterminado: "off"- Es el modo de subprocesos que se usará para recuperar el repo. Si se establece en "desactivado", no se usa ningún subproceso de trabajo y la recuperación del repo está sujeta a reinicios. De lo contrario, usa un subproceso de plataforma (es decir, un subproceso del SO) si se establece en "platform" o un subproceso virtual si se establece en "virtual".
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
. - Anula un repositorio con una ruta de acceso local en el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es una ruta absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta relativa, se relaciona con el directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace".
Opciones de instalación para dispositivos móviles
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
. -
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, se puede hacer que los repositorios externos funcionen en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_connector_attempts=<an integer>
predeterminado: “8”-
Es la cantidad máxima de intentos de descargas HTTP.
Etiquetas:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
predeterminado: “0s”-
Es el tiempo de espera máximo para los reintentos de descarga HTTP. Con un valor de 0, no se define un tiempo de espera máximo.
Etiquetas:bazel_internal_configuration
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la 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, se usa el valor predeterminado de '<output_user_root>/cache/repos/v1'.
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
predeterminado: “false”-
Si se establece, 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 se inhabilita por completo; 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 la compilación:
--gc_thrashing_threshold=<an integer in 0-100 range>
predeterminado: "100"-
Es el porcentaje de espacio ocupado (de 0 a 100) por encima del cual GcThrashingDetector considera los eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, se inhabilita GcThrashingDetector.
Etiquetas:host_machine_resource_optimizations
--mode=<classic, classic_internal_test_do_not_use or skylark>
predeterminado: “classic”-
Selecciona cómo ejecutar mobile-install. "classic" ejecuta la versión actual de mobile-install. "skylark" usa la nueva versión de Starlark, que es compatible con android_test.
Etiquetas:loading_and_analysis
,execution
,incompatible_change
- Opciones que configuran la cadena de herramientas que se usa para la ejecución de acciones:
--adb=<a string>
predeterminado: ""
Objeto binario - adb que se usará para el comando "mobile-install". Si no se especifica, se usa el que se encuentra en el SDK de Android especificado por la opción de línea de comandos --android_sdk (o el SDK predeterminado si no se especifica --android_sdk).
Etiquetas:changes_inputs
- Opciones que controlan el resultado del comando:
--[no]incremental
predeterminado: “false”-
Indica si se debe realizar una instalación incremental. Si es verdadero, intenta evitar el trabajo adicional innecesario leyendo el estado del dispositivo en el que se instalará el código y usando esa información para evitar el trabajo innecesario. Si es falso (la opción predeterminada), siempre realiza una instalación completa.
Etiquetas:loading_and_analysis
--[no]split_apks
predeterminado: “false”-
Indica si se deben usar APKs divididos para instalar y actualizar la aplicación en el dispositivo. Solo funciona con dispositivos con Marshmallow o versiones posteriores.
Etiquetas:loading_and_analysis
,affects_outputs
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
- Se acumulan varios usos de
--adb_arg=<a string>
. -
Argumentos adicionales que se pasan a adb. Por lo general, se usa para designar un dispositivo en el que se instalará.
Etiquetas:action_command_lines
--debug_app
-
Determina si se debe esperar al depurador antes de iniciar la app.
Se expande a lo siguiente:
--start=DEBUG
Etiquetas:execution
--device=<a string>
predeterminado: ""-
Es el número de serie del dispositivo de ADB. Si no se especifica, se usará el primer dispositivo.
Etiquetas:action_command_lines
--start=<no, cold, warm or debug>
predeterminado: “NO”-
Cómo se debe iniciar la app después de instalarla. Establece el valor en WARM para conservar y restablecer el estado de la aplicación en las instalaciones incrementales.
Etiquetas:execution
--start_app
-
Indica si se debe iniciar la app después de instalarla.
Se expande a:
--start=COLD
Etiquetas:execution
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
. -
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitadas en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "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 un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
predeterminado: “update”- especifica cómo usar el archivo de bloqueo y si se debe usar o no. 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 mostrar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
. - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso proporcionada es una ruta de acceso absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta de acceso relativa, se hará referencia al directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace".
- Se acumulan varios usos de
--registry=<a string>
. -
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los 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 haga que Bazel falle con un error de OOM. Cada límite se especifica como <period>:<count>, en el que period es una duración y count es un número entero positivo. Si más del porcentaje --gc_thrashing_threshold del espacio a perpetuidad (heap de generación anterior) permanece ocupado después de <count> GC completas consecutivas en <period>, se activa un error de OOM. Se pueden especificar varios límites separados por comas.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Es una marca para la configuración avanzada del motor Skyframe interno 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 GC completo, se descartará el estado temporal innecesario de Skyframe hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC completos nunca activarán las bajadas. 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"-
Es una marca para la configuración avanzada del motor Skyframe interno 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 GC menor, se descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC menores nunca activarán las bajadas. 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
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es de al menos este límite, descartará el estado temporal innecesario de Skyframe. Si ajustas este parámetro, es posible que puedas mitigar el impacto del tiempo de ejecución de la fragmentación de GC, cuando esta se produce (i) por el uso de memoria de este estado temporal y (ii) es más costoso 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:
--[no]experimental_command_profile
predeterminado: “false”- Graba un perfil de CPU de Java Flight Recorder en un archivo profile.jfr en el directorio base de salida. La sintaxis y la semántica de esta marca pueden cambiar en el futuro para admitir diferentes tipos de perfiles o formatos de salida. Úsala bajo tu propio riesgo.
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
--incremental_install_verbosity=<a string>
predeterminado: ""-
Es el nivel de detalle de la instalación incremental. Establece en 1 para el registro de depuración.
Etiquetas:bazel_monitoring
- Son opciones que especifican o alteran una entrada genérica en un comando de Bazel que no pertenece a otras categorías.:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de almacenamiento en caché y ejecución remotas:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite"), seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
--experimental_worker_for_repo_fetching=<off, platform or virtual>
predeterminado: "off"- Es el modo de subprocesos que se usará para recuperar el repo. Si se establece en "desactivado", no se usa ningún subproceso de trabajo y la recuperación del repo está sujeta a reinicios. De lo contrario, usa un subproceso de plataforma (es decir, un subproceso del SO) si se establece en "platform" o un subproceso virtual si se establece en "virtual".
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
. - Anula un repositorio con una ruta de acceso local en el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es una ruta absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta relativa, se relaciona con el directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace".
Opciones de mod
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
. -
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, se puede hacer que los repositorios externos funcionen en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_connector_attempts=<an integer>
predeterminado: “8”-
Es la cantidad máxima de intentos de descargas HTTP.
Etiquetas:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
predeterminado: “0s”-
Es el tiempo de espera máximo para los reintentos de descarga HTTP. Con un valor de 0, no se define un tiempo de espera máximo.
Etiquetas:bazel_internal_configuration
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la 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, se usa el valor predeterminado de '<output_user_root>/cache/repos/v1'.
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
predeterminado: “false”-
Si se establece, 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 se inhabilita por completo; 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 la compilación:
--gc_thrashing_threshold=<an integer in 0-100 range>
predeterminado: "100"-
Es el porcentaje de espacio ocupado (de 0 a 100) por encima del cual GcThrashingDetector considera los eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, se inhabilita GcThrashingDetector.
Etiquetas:host_machine_resource_optimizations
--[no]keep_going
[-k
] predeterminado: "false"-
Continúa tanto como sea posible después de un error. Si bien no se pueden analizar el objetivo que falló ni los que dependen de él, sí se pueden analizar otros requisitos previos de estos objetivos.
Etiquetas:eagerness_to_exit
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
predeterminado: “auto”-
Cantidad de subprocesos en paralelo que se usarán para la fase de carga o análisis. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". "auto" establece un valor predeterminado razonable según los recursos del host. Debe ser 1 como mínimo.
Etiquetas:bazel_internal_configuration
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility
predeterminado: “false”-
Si incompatible_enforce_config_setting_visibility=false, esto es una operación no realizada. De lo contrario, si esta marca es falsa, cualquier config_setting sin un atributo de visibilidad explícito es //visibility:public. Si esta marca es verdadera, config_setting sigue la misma lógica de visibilidad que todas las demás reglas. Consulta https://github.com/bazelbuild/bazel/issues/12933.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
predeterminado: "true"-
Si es verdadero, aplica las restricciones de visibilidad de config_setting. Si es falso, todos los config_setting son visibles para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones relacionadas con el resultado y la semántica del subcomando "mod":
--base_module=<"<root>" for the root module; <module>@<version> for a specific version of a module; <module> for all versions of a module; @<name> for a repo with the given apparent name; or @@<name> for a repo with the given canonical name>
predeterminado: "<root>"-
Especifica un módulo en relación con el cual se interpretarán los repositorios de destino especificados.
Etiquetas:terminal_output
--charset=<utf8 or ascii>
predeterminado: "utf8"-
Elige el conjunto de caracteres que se usará para el árbol. Solo afecta a la salida de texto. Los valores válidos son “utf8” o “ascii”. El valor predeterminado es "utf8".
Etiquetas:terminal_output
--[no]cycles
predeterminado: “false”-
Indica los ciclos de dependencia dentro del árbol que se muestra, que normalmente se ignoran de forma predeterminada.
Etiquetas:terminal_output
--depth=<an integer>
predeterminado: “-1”-
Profundidad máxima de visualización del árbol de dependencias. Por ejemplo, una profundidad de 1 muestra las dependencias directas. Para tree, path y all_paths, el valor predeterminado es Integer.MAX_VALUE, mientras que para deps y explain, el valor predeterminado es 1 (solo muestra las dependencias directas de la raíz además de las hojas de destino y sus elementos superiores).
Etiquetas:terminal_output
--extension_filter=<a comma-separated list of <extension>s>
predeterminado: Consulta la descripción-
Solo muestra los usos de estas extensiones de módulo y los repositorios que generan si se establecen sus respectivas marcas. Si se establece, el gráfico de resultados solo incluirá las rutas de acceso que contengan módulos que usen las extensiones especificadas. Una lista vacía inhabilita el filtro y especifica de manera efectiva todas las extensiones posibles.
Etiquetas:terminal_output
--extension_info=<hidden, usages, repos or all>
predeterminado: "hidden"-
Especifica cuántos detalles sobre los usos de la extensión se deben incluir en el resultado de la consulta. En "Usages", solo se mostrarán los nombres de las extensiones. En "Repositories", también se incluirán los repositorios importados con use_repo, y en "Todos", también se mostrarán los otros repositorios que generan las extensiones.
Etiquetas:terminal_output
--extension_usages=<a comma-separated list of <module>s>
predeterminado: ""-
Especifica los módulos cuyos usos de extensión se mostrarán en la consulta show_extension.
Etiquetas:terminal_output
--from=<a comma-separated list of <module>s>
predeterminado: "<root>"-
Son los módulos desde los que se mostrará la consulta del gráfico de dependencias. Verifica la descripción de cada consulta para ver la semántica exacta. El valor predeterminado es <root>.
Etiquetas:terminal_output
--[no]include_builtin
predeterminado: “false”-
Incluye módulos integrados en el gráfico de dependencias. Está inhabilitado de forma predeterminada porque genera mucho ruido.
Etiquetas:terminal_output
--[no]include_unused
predeterminado: “false”-
Las consultas también tendrán en cuenta y mostrarán los módulos no utilizados, que no están presentes en el gráfico de resolución de módulos después de la selección (debido a la selección de versión mínima o las reglas de anulación). Esto puede tener diferentes efectos para cada uno de los tipos de consulta, es decir, incluir rutas nuevas en el comando all_paths o dependencias adicionales en el comando explain.
Etiquetas:terminal_output
--output=<text, json or graph>
predeterminado: “text”-
Es el formato en el que se deben imprimir los resultados de la consulta. Los valores permitidos para la consulta son: texto, json, gráfico.
Etiquetas:terminal_output
--[no]verbose
predeterminado: “false”-
Las consultas también mostrarán el motivo por el que los módulos se resolvieron a su versión actual (si se cambiaron). El valor predeterminado es verdadero solo para la consulta explain.
Etiquetas:terminal_output
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
. -
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitadas en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "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 un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
predeterminado: “update”- especifica cómo usar el archivo de bloqueo y si se debe usar o no. 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 mostrar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
. - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso proporcionada es una ruta de acceso absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta de acceso relativa, se hará referencia al directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace".
- Se acumulan varios usos de
--registry=<a string>
. -
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los 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 haga que Bazel falle con un error de OOM. Cada límite se especifica como <period>:<count>, en el que period es una duración y count es un número entero positivo. Si más del porcentaje --gc_thrashing_threshold del espacio a perpetuidad (heap de generación anterior) permanece ocupado después de <count> GC completas consecutivas en <period>, se activa un error de OOM. Se pueden especificar varios límites separados por comas.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Es una marca para la configuración avanzada del motor Skyframe interno 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 GC completo, se descartará el estado temporal innecesario de Skyframe hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC completos nunca activarán las bajadas. 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"-
Es una marca para la configuración avanzada del motor Skyframe interno 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 GC menor, se descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC menores nunca activarán las bajadas. 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
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es de al menos este límite, descartará el estado temporal innecesario de Skyframe. Si ajustas este parámetro, es posible que puedas mitigar el impacto del tiempo de ejecución de la fragmentación de GC, cuando esta se produce (i) por el uso de memoria de este estado temporal y (ii) es más costoso 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:
--[no]experimental_command_profile
predeterminado: “false”- Graba un perfil de CPU de Java Flight Recorder en un archivo profile.jfr en el directorio base de salida. La sintaxis y la semántica de esta marca pueden cambiar en el futuro para admitir diferentes tipos de perfiles o formatos de salida. Úsala bajo tu propio riesgo.
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
- Opciones que especifican o alteran una entrada genérica a un comando de Bazel que no se incluye en otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite"), seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
--experimental_worker_for_repo_fetching=<off, platform or virtual>
predeterminado: "off"- Es el modo de subprocesos que se usará para recuperar el repo. Si se establece en "desactivado", no se usa ningún subproceso de trabajo y la recuperación del repo está sujeta a reinicios. De lo contrario, usa un subproceso de plataforma (es decir, un subproceso del SO) si se establece en "platform" o un subproceso virtual si se establece en "virtual".
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--deleted_packages=<comma-separated list of package names>
. - Es una lista separada por comas de nombres de paquetes que el sistema de compilación considerará inexistentes, incluso si son visibles en algún lugar de la ruta de acceso del paquete. Usa esta opción cuando borres un subpaquete "x/y" de un paquete existente "x". Por ejemplo, después de borrar x/y/BUILD en tu cliente, es posible que el sistema de compilación se queje si encuentra una etiqueta "//x:y/z" si otra entrada de package_path aún la proporciona. Especificar --deleted_packages x/y evita este problema.
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
. - Anula un repositorio con una ruta de acceso local en el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es una ruta absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta relativa, se relaciona con el directorio de trabajo actual. Si la ruta de acceso determinada 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%"- Es una lista separada por dos puntos de dónde buscar paquetes. Los elementos que comienzan con "%workspace%" son relativos al lugar de trabajo que los contiene. Si se omite o está vacío, el valor predeterminado es el resultado de "bazel info default-package-path".
--[no]show_loading_progress
predeterminado: "true"- Si está habilitado, hace que Bazel imprima mensajes de "Carga del paquete:".
Opciones de Print_action
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
. -
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, se puede hacer que los repositorios externos funcionen en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_connector_attempts=<an integer>
predeterminado: “8”-
Es la cantidad máxima de intentos de descargas HTTP.
Etiquetas:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
predeterminado: “0s”-
Es el tiempo de espera máximo para los reintentos de descarga HTTP. Con un valor de 0, no se define un tiempo de espera máximo.
Etiquetas:bazel_internal_configuration
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la 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, se usa el valor predeterminado de '<output_user_root>/cache/repos/v1'.
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
predeterminado: “false”-
Si se establece, 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 se inhabilita por completo; 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 la compilación:
--gc_thrashing_threshold=<an integer in 0-100 range>
predeterminado: "100"-
Es el porcentaje de espacio ocupado (de 0 a 100) por encima del cual GcThrashingDetector considera los eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, se inhabilita GcThrashingDetector.
Etiquetas:host_machine_resource_optimizations
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
. -
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitadas en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "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 un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
predeterminado: “update”- especifica cómo usar el archivo de bloqueo y si se debe usar o no. 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 mostrar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
. - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso proporcionada es una ruta de acceso absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta de acceso relativa, se hará referencia al directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace".
- Se acumulan varios usos de
--registry=<a string>
. -
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los 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 haga que Bazel falle con un error de OOM. Cada límite se especifica como <period>:<count>, en el que period es una duración y count es un número entero positivo. Si más del porcentaje --gc_thrashing_threshold del espacio a perpetuidad (heap de generación anterior) permanece ocupado después de <count> GC completas consecutivas en <period>, se activa un error de OOM. Se pueden especificar varios límites separados por comas.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Es una marca para la configuración avanzada del motor Skyframe interno 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 GC completo, se descartará el estado temporal innecesario de Skyframe hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC completos nunca activarán las bajadas. 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"-
Es una marca para la configuración avanzada del motor Skyframe interno 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 GC menor, se descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC menores nunca activarán las bajadas. 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
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es de al menos este límite, descartará el estado temporal innecesario de Skyframe. Si ajustas este parámetro, es posible que puedas mitigar el impacto del tiempo de ejecución de la fragmentación de GC, cuando esta se produce (i) por el uso de memoria de este estado temporal y (ii) es más costoso 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:
--[no]experimental_command_profile
predeterminado: “false”- Graba un perfil de CPU de Java Flight Recorder en un archivo profile.jfr en el directorio base de salida. La sintaxis y la semántica de esta marca pueden cambiar en el futuro para admitir diferentes tipos de perfiles o formatos de salida. Úsala bajo tu propio riesgo.
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
- Opciones que especifican o alteran una entrada genérica a un comando de Bazel que no se incluye en otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite"), seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
--experimental_worker_for_repo_fetching=<off, platform or virtual>
predeterminado: "off"- Es el modo de subprocesos que se usará para recuperar el repo. Si se establece en "desactivado", no se usa ningún subproceso de trabajo y la recuperación del repo está sujeta a reinicios. De lo contrario, usa un subproceso de plataforma (es decir, un subproceso del SO) si se establece en "platform" o un subproceso virtual si se establece en "virtual".
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
. - Anula un repositorio con una ruta de acceso local en el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es una ruta absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta relativa, se relaciona con el directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace".
- Se acumulan varios usos de
--print_action_mnemonics=<a string>
. - Enumera los mnemónicos por los que se deben filtrar los datos de print_action. No se realiza ningún filtrado si se deja vacío.
Opciones de consulta
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
. -
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, se puede hacer que los repositorios externos funcionen en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_connector_attempts=<an integer>
predeterminado: “8”-
Es la cantidad máxima de intentos de descargas HTTP.
Etiquetas:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
predeterminado: “0s”-
Es el tiempo de espera máximo para los reintentos de descarga HTTP. Con un valor de 0, no se define un tiempo de espera máximo.
Etiquetas:bazel_internal_configuration
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la 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, se usa el valor predeterminado de '<output_user_root>/cache/repos/v1'.
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
predeterminado: “false”-
Si se establece, 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 se inhabilita por completo; 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 la compilación:
--gc_thrashing_threshold=<an integer in 0-100 range>
predeterminado: "100"-
Es el porcentaje de espacio ocupado (de 0 a 100) por encima del cual GcThrashingDetector considera los eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, se inhabilita GcThrashingDetector.
Etiquetas:host_machine_resource_optimizations
--[no]keep_going
[-k
] predeterminado: "false"-
Continúa tanto como sea posible después de un error. Si bien no se pueden analizar el objetivo que falló ni los que dependen de él, sí se pueden analizar otros requisitos previos de estos objetivos.
Etiquetas:eagerness_to_exit
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
predeterminado: “auto”-
Cantidad de subprocesos en paralelo que se usarán para la fase de carga o análisis. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". "auto" establece un valor predeterminado razonable según los recursos del host. Debe ser 1 como mínimo.
Etiquetas:bazel_internal_configuration
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility
predeterminado: “false”-
Si incompatible_enforce_config_setting_visibility=false, esto es una operación no realizada. De lo contrario, si esta marca es falsa, cualquier config_setting sin un atributo de visibilidad explícito es //visibility:public. Si esta marca es verdadera, config_setting sigue la misma lógica de visibilidad que todas las demás reglas. Consulta https://github.com/bazelbuild/bazel/issues/12933.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
predeterminado: "true"-
Si es verdadero, aplica las restricciones de visibilidad de config_setting. Si es falso, todos los config_setting son visibles para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones relacionadas con el resultado y la semántica de la consulta:
--aspect_deps=<off, conservative or precise>
predeterminado: "conservador"-
Cómo resolver las dependencias de aspecto cuando el formato de salida es uno de {xml,proto,record}. "Desactivado" significa que no se resuelven las dependencias de aspecto. "Conservador" (la opción predeterminada) significa que se agregan todas las dependencias de aspecto declaradas, independientemente de si se les asigna la clase de regla de dependencias directas. "Preciso" significa que solo se agregan los aspectos que pueden estar activos según la clase de regla de las dependencias directas. Ten en cuenta que el modo preciso requiere la carga de otros paquetes para evaluar un solo objetivo, lo que lo hace más lento que los otros modos. Ten en cuenta también que incluso el modo preciso no es del todo preciso: la decisión de si calcular un aspecto se toma en la fase de análisis, que no se ejecuta durante la "consulta de bazel".
Etiquetas:build_file_semantics
--[no]consistent_labels
predeterminado: “false”-
Si está habilitada, cada comando de consulta emite etiquetas como si fuera la función Starlark <code>str</code> aplicada a una instancia de <code>Label</code>. Esto es útil para las herramientas que deben coincidir con el resultado de diferentes comandos de consulta o etiquetas que emiten las reglas. Si no están habilitados, los formateadores de salida pueden emitir nombres de repositorio aparentes (en relación con el repositorio principal) para que el resultado sea más legible.
Etiquetas:terminal_output
--[no]experimental_graphless_query
predeterminado: “auto”-
Si es verdadero, usa una implementación de consulta que no crea una copia del gráfico. La nueva implementación solo admite --order_output=no, así como un subconjunto de formateadores de salida.
Etiquetas:build_file_semantics
,eagerness_to_exit
--graph:conditional_edges_limit=<an integer>
predeterminado: “4”-
Es la cantidad máxima de etiquetas de condición que se mostrarán. -1 significa que no hay truncamiento y 0 significa que no hay anotaciones. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--[no]graph:factored
predeterminado: "true"-
Si es verdadero, el gráfico se emitirá "factorizado", es decir, los nodos topológicamente equivalentes se combinarán y sus etiquetas se concatenarán. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--graph:node_limit=<an integer>
predeterminado: “512”-
Es la longitud máxima de la cadena de etiqueta para un nodo de gráfico en el resultado. Las etiquetas más largas se truncarán. -1 significa que no se truncará. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--[no]implicit_deps
predeterminado: "true"-
Si está habilitada, se incluirán dependencias implícitas en el gráfico de dependencias sobre el que opera la consulta. Una dependencia implícita es aquella que no se especifica de forma explícita en el archivo BUILD, pero que Bazel agrega. En el caso de cquery, esta opción controla el filtrado de cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
--[no]include_aspects
predeterminado: "true"-
aquery, cquery: Indica si se deben incluir acciones generadas por aspectos en el resultado. query: No-op (siempre se siguen los aspectos).
Etiquetas:terminal_output
--[no]incompatible_lexicographical_output
predeterminado: "true"-
Si se establece esta opción, se ordena el resultado de --order_output=auto en orden alfabético.
Etiquetas:terminal_output
,incompatible_change
--[no]incompatible_package_group_includes_double_slash
predeterminado: "true"-
Si está habilitada, cuando se genere el atributo "packages" de package_group, no se omitirá el "//" inicial.
Etiquetas:terminal_output
,incompatible_change
--[no]infer_universe_scope
predeterminado: “false”-
Si se establece y no se establece --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 el valor de --universe_scope inferido para una expresión de consulta que usa funciones centradas en el universo (p.ej., "allrdeps") puede no ser lo que deseas, 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 establece --universe_scope, se ignora el valor de esta opción. Nota: Esta opción solo se aplica a "query" (es decir, no a "cquery").
Etiquetas:loading_and_analysis
--[no]line_terminator_null
predeterminado: “false”-
Indica si cada formato finaliza con \0 en lugar de una línea nueva.
Etiquetas:terminal_output
--[no]nodep_deps
predeterminado: "true"-
Si está habilitada, las dependencias de los atributos "nodep" se incluirán en el gráfico de dependencias sobre el que opera la consulta. Un ejemplo común de un atributo "nodep" es "visibility". Ejecuta y analiza el resultado de "info build-language" para obtener información sobre todos los atributos "nodep" en el lenguaje de compilación.
Etiquetas:build_file_semantics
--noorder_results
-
Muestra los resultados de forma ordenada por dependencias (predeterminada) o desordenada. La salida no ordenada es más rápida, pero solo se admite cuando --output no es minrank, maxrank ni graph.
Se expande a:
--order_output=no
Etiquetas:terminal_output
--null
-
Indica si cada formato finaliza con \0 en lugar de una línea nueva.
Se expande a:
--line_terminator_null=true
Etiquetas:terminal_output
--order_output=<no, deps, auto or full>
predeterminado: “auto”-
Muestra los resultados sin ordenar (no), ordenados por dependencia (deps) o completamente ordenados (full). El valor predeterminado es "auto", lo que significa que los resultados se ordenan según la dependencia o se ordenan por completo, según el formato de salida (ordenados por dependencia para proto, minrank, maxrank y gráfico, y ordenados por completo para todos los demás). Cuando el resultado está completamente ordenado, los nodos se imprimen en un orden completamente determinista (total). Primero, todos los nodos se ordenan alfabéticamente. Luego, cada nodo de la lista se usa como el inicio de una búsqueda en profundidad post-orden en la que los bordes salientes a los nodos no visitados se recorren en orden alfabético de los nodos sucesores. Por último, los nodos se imprimen en el orden inverso en el que se visitaron.
Etiquetas:terminal_output
--order_results
-
Muestra los resultados de forma ordenada por dependencias (predeterminada) o desordenada. La salida no ordenada es más rápida, pero solo se admite cuando --output no es minrank, maxrank ni graph.
Se expande a:
--order_output=auto
Etiquetas:terminal_output
--output=<a string>
predeterminado: "label"-
Es el formato en el que se deben imprimir los resultados de la consulta. Los valores permitidos para la consulta son: build, graph, streamed_jsonproto, label, label_kind, location, maxrank, minrank, package, proto, streamed_proto, textproto, xml.
Etiquetas:terminal_output
--[no]proto:default_values
predeterminado: "true"-
Si es verdadero, se incluyen los atributos cuyo valor no se especifica de forma explícita en el archivo BUILD; de lo contrario, se omiten. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
--[no]proto:definition_stack
predeterminado: “false”-
Propaga el campo proto definition_stack, que registra para cada instancia de regla la pila de llamadas de Starlark en el momento en que se definió la clase de la regla.
Etiquetas:terminal_output
--[no]proto:flatten_selects
predeterminado: "true"-
Si está habilitada, los atributos configurables creados por select() se aplanan. En el caso de los tipos de lista, la representación aplanada es una lista que contiene cada valor del mapa de selección exactamente una vez. Los tipos escalares se aplanan a nulos.
Etiquetas:build_file_semantics
--[no]proto:include_attribute_source_aspects
predeterminado: “false”-
Propaga el campo proto source_aspect_name de cada atributo con el aspecto de origen del que proviene el atributo (cadena vacía si no es así).
Etiquetas:terminal_output
--[no]proto:include_synthetic_attribute_hash
predeterminado: “false”-
Indica si se debe calcular y propagar el atributo $internal_attr_hash.
Etiquetas:terminal_output
--[no]proto:instantiation_stack
predeterminado: “false”-
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
--[no]proto:locations
predeterminado: "true"-
Indica si se debe generar información de ubicación en el resultado de proto.
Etiquetas:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
predeterminado: “all”-
Es una lista de atributos separados por comas que se incluirán en el resultado. La configuración predeterminada es todos los atributos. Se establece en una cadena vacía para no mostrar ningún atributo. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
--[no]proto:rule_inputs_and_outputs
predeterminado: "true"-
Indica si se propagan o no los campos rule_input y rule_output.
Etiquetas:terminal_output
--query_file=<a string>
predeterminado: ""-
Si se establece, la consulta leerá la consulta del archivo que se nombra aquí, en lugar de la línea de comandos. Especificar un archivo aquí y una consulta de línea de comandos es un error.
Etiquetas:changes_inputs
--[no]relative_locations
predeterminado: “false”-
Si es verdadero, la ubicación de los archivos BUILD en los resultados de 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 establecer esta opción en verdadero para obtener un resultado coherente en todas las máquinas.
Etiquetas:terminal_output
--[no]strict_test_suite
predeterminado: “false”-
Si es verdadero, la expresión tests() muestra un error si encuentra un test_suite que contiene destinos que no son de prueba.
Etiquetas:build_file_semantics
,eagerness_to_exit
--[no]tool_deps
predeterminado: "true"-
Consulta: Si se inhabilita, las dependencias de "configuración de ejecución" no se incluirán en el gráfico de dependencias sobre el que opera la consulta. Un borde de dependencia de "configuración de ejecución", como el de cualquier regla "proto_library" al compilador de protocolos, suele apuntar a una herramienta que se ejecuta durante la compilación en lugar de a una parte del mismo programa "objetivo".
Cquery: Si se inhabilita, filtra todos los objetivos configurados que crucen una transición de ejecución desde el objetivo de nivel superior que descubrió este objetivo configurado. Esto significa que, si el objetivo de nivel superior está en la configuración de destino, solo se mostrarán los objetivos configurados también en la configuración de destino. Si el objetivo de nivel superior está en la configuración de exec, solo se mostrarán los objetivos configurados de exec. Esta opción NO excluirá las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
--universe_scope=<comma-separated list of options>
predeterminado: ""-
Es un conjunto de patrones de segmentación (aditivos y sustractivos) separados por comas. La consulta se puede realizar en el universo definido por el cierre transitivo de los destinos especificados. Esta opción se usa para los comandos query y cquery.
En el caso de cquery, la entrada de esta opción son los objetivos en los que se compilan todas las respuestas, por lo que esta opción puede afectar las configuraciones y las transiciones. Si no se especifica esta opción, se supone que los destinos de nivel superior son los que se analizan de la expresión de consulta. Nota: En el caso de cquery, si no especificas esta opción, es posible que la compilación falle si los destinos analizados de la expresión de consulta no se pueden compilar con opciones de nivel superior.
Etiquetas:loading_and_analysis
--[no]xml:default_values
predeterminado: “false”-
Si es verdadero, se imprimen los atributos de regla cuyo valor no se especifica de forma explícita en el archivo BUILD; de lo contrario, se omiten.
Etiquetas:terminal_output
--[no]xml:line_numbers
predeterminado: "true"-
Si es verdadero, el resultado en formato XML contiene números de línea. Si inhabilitas esta opción, es posible que las diferencias sean más fáciles de leer. Esta opción solo se aplica a --output=xml.
Etiquetas:terminal_output
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
. -
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitadas en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "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 un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
predeterminado: “update”- especifica cómo usar el archivo de bloqueo y si se debe usar o no. 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 mostrar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
. - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso proporcionada es una ruta de acceso absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta de acceso relativa, se hará referencia al directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace".
- Se acumulan varios usos de
--registry=<a string>
. -
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los 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 haga que Bazel falle con un error de OOM. Cada límite se especifica como <period>:<count>, en el que period es una duración y count es un número entero positivo. Si más del porcentaje --gc_thrashing_threshold del espacio a perpetuidad (heap de generación anterior) permanece ocupado después de <count> GC completas consecutivas en <period>, se activa un error de OOM. Se pueden especificar varios límites separados por comas.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Es una marca para la configuración avanzada del motor Skyframe interno 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 GC completo, se descartará el estado temporal innecesario de Skyframe hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC completos nunca activarán las bajadas. 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"-
Es una marca para la configuración avanzada del motor Skyframe interno 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 GC menor, se descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC menores nunca activarán las bajadas. 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
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es de al menos este límite, descartará el estado temporal innecesario de Skyframe. Si ajustas este parámetro, es posible que puedas mitigar el impacto del tiempo de ejecución de la fragmentación de GC, cuando esta se produce (i) por el uso de memoria de este estado temporal y (ii) es más costoso 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:
--[no]experimental_command_profile
predeterminado: “false”- Graba un perfil de CPU de Java Flight Recorder en un archivo profile.jfr en el directorio base de salida. La sintaxis y la semántica de esta marca pueden cambiar en el futuro para admitir diferentes tipos de perfiles o formatos de salida. Úsala bajo tu propio riesgo.
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
--experimental_repository_resolved_file=<a string>
predeterminado: ""-
Si no está vacío, escribe un valor de Starlark con la información resuelta de todas las reglas del repositorio de Starlark que se ejecutaron.
Etiquetas:affects_outputs
- Son opciones que especifican o alteran una entrada genérica en un comando de Bazel que no pertenece a otras categorías.:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de almacenamiento en caché y ejecución remotas:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite"), seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
--experimental_worker_for_repo_fetching=<off, platform or virtual>
predeterminado: "off"- Es el modo de subprocesos que se usará para recuperar el repo. Si se establece en "desactivado", no se usa ningún subproceso de trabajo y la recuperación del repo está sujeta a reinicios. De lo contrario, usa un subproceso de plataforma (es decir, un subproceso del SO) si se establece en "platform" o un subproceso virtual si se establece en "virtual".
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--deleted_packages=<comma-separated list of package names>
. - Es una lista separada por comas de nombres de paquetes que el sistema de compilación considerará inexistentes, incluso si son visibles en algún lugar de la ruta de acceso del paquete. Usa esta opción cuando borres un subpaquete "x/y" de un paquete existente "x". Por ejemplo, después de borrar x/y/BUILD en tu cliente, es posible que el sistema de compilación se queje si encuentra una etiqueta "//x:y/z" si otra entrada de package_path aún la proporciona. Especificar --deleted_packages x/y evita este problema.
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
. - Anula un repositorio con una ruta de acceso local en el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es una ruta absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta relativa, se relaciona con el directorio de trabajo actual. Si la ruta de acceso determinada 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%"- Es una lista separada por dos puntos de dónde buscar paquetes. Los elementos que comienzan con "%workspace%" son relativos al lugar de trabajo que los contiene. Si se omite o está vacío, el valor predeterminado es el resultado de "bazel info default-package-path".
--[no]show_loading_progress
predeterminado: "true"- Si está habilitado, hace que Bazel imprima mensajes de "Carga del paquete:".
Run Options
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
. -
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, los repositorios externos pueden funcionar en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_connector_attempts=<an integer>
predeterminado: “8”-
Es la cantidad máxima de intentos de descargas HTTP.
Etiquetas:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
predeterminado: “0s”-
Es el tiempo de espera máximo para los reintentos de descarga HTTP. Con un valor de 0, no se define un tiempo de espera máximo.
Etiquetas:bazel_internal_configuration
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la 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, se usa el valor predeterminado de '<output_user_root>/cache/repos/v1'.
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
predeterminado: “false”-
Si se establece, 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 se inhabilita por completo; ctx.execute aún podría ejecutar un ejecutable arbitrario que acceda a Internet.
Etiquetas:bazel_internal_configuration
--[no]run
predeterminado: "true"-
Si es falso, se omite la ejecución de la línea de comandos creada para el destino compilado.
Etiquetas:affects_outputs
- Opciones que controlan la ejecución de la compilación:
--gc_thrashing_threshold=<an integer in 0-100 range>
predeterminado: "100"-
Es el porcentaje de espacio ocupado (de 0 a 100) por encima del cual GcThrashingDetector considera los eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, se inhabilita GcThrashingDetector.
Etiquetas:host_machine_resource_optimizations
- Son opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
--script_path=<a path>
predeterminado: Consulta la descripción-
Si se establece, escribe una secuencia de comandos de shell en el archivo determinado que invoque el destino. Si se establece esta opción, el destino no se ejecuta desde bazel. Usa "bazel run --script_path=foo //foo && ./foo" para invocar el objetivo "//foo". Esto difiere de "bazel run //foo" en que se libera el bloqueo de Bazel y el ejecutable se conecta al stdin de la terminal.
Etiquetas:affects_outputs
,execution
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
. -
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitadas en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "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 un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
predeterminado: “update”- especifica cómo usar el archivo de bloqueo y si se debe usar o no. 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 mostrar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
. - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso proporcionada es una ruta de acceso absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta de acceso relativa, se hará referencia al directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace".
- Se acumulan varios usos de
--registry=<a string>
. -
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los 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 haga que Bazel falle con un error de OOM. Cada límite se especifica como <period>:<count>, en el que period es una duración y count es un número entero positivo. Si más del porcentaje --gc_thrashing_threshold del espacio a perpetuidad (heap de generación anterior) permanece ocupado después de <count> GC completas consecutivas en <period>, se activa un error de OOM. Se pueden especificar varios límites separados por comas.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Es una marca para la configuración avanzada del motor Skyframe interno 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 GC completo, se descartará el estado temporal innecesario de Skyframe hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC completos nunca activarán las bajadas. 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"-
Es una marca para la configuración avanzada del motor Skyframe interno 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 GC menor, se descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC menores nunca activarán las bajadas. 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
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es de al menos este límite, descartará el estado temporal innecesario de Skyframe. Si ajustas este parámetro, es posible que puedas mitigar el impacto del tiempo de ejecución de la fragmentación de GC, cuando esta se produce (i) por el uso de memoria de este estado temporal y (ii) es más costoso 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:
--[no]experimental_command_profile
predeterminado: “false”- Graba un perfil de CPU de Java Flight Recorder en un archivo profile.jfr en el directorio base de salida. La sintaxis y la semántica de esta marca pueden cambiar en el futuro para admitir diferentes tipos de perfiles o formatos de salida. Úsala bajo tu propio riesgo.
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
- Opciones que especifican o alteran una entrada genérica a un comando de Bazel que no se incluye en otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite"), seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
--experimental_worker_for_repo_fetching=<off, platform or virtual>
predeterminado: "off"- Es el modo de subprocesos que se usará para recuperar el repo. Si se establece en "desactivado", no se usa ningún subproceso de trabajo y la recuperación del repo está sujeta a reinicios. De lo contrario, usa un subproceso de plataforma (es decir, un subproceso del SO) si se establece en "platform" o un subproceso virtual si se establece en "virtual".
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
. - Anula un repositorio con una ruta de acceso local en el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es una ruta absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta relativa, se relaciona con el directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace".
Opciones de apagado
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
. -
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, se puede hacer que los repositorios externos funcionen en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_connector_attempts=<an integer>
predeterminado: “8”-
Es la cantidad máxima de intentos de descargas HTTP.
Etiquetas:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
predeterminado: “0s”-
Es el tiempo de espera máximo para los reintentos de descarga HTTP. Con un valor de 0, no se define un tiempo de espera máximo.
Etiquetas:bazel_internal_configuration
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la 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, se usa el valor predeterminado de '<output_user_root>/cache/repos/v1'.
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
predeterminado: “false”-
Si se establece, 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 se inhabilita por completo; 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 la compilación:
--gc_thrashing_threshold=<an integer in 0-100 range>
predeterminado: "100"-
Es el porcentaje de espacio ocupado (de 0 a 100) por encima del cual GcThrashingDetector considera los eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, se inhabilita GcThrashingDetector.
Etiquetas:host_machine_resource_optimizations
- Opciones que controlan el resultado del comando:
--iff_heap_size_greater_than=<an integer>
predeterminado: “0”-
Si es distinto de cero, el cierre solo apagará el servidor si la memoria total (en MB) que consume la JVM supera este valor.
Etiquetas:loses_incremental_state
,eagerness_to_exit
- Opciones relacionadas con la salida y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
. -
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitadas en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "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 un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
predeterminado: “update”- especifica cómo usar el archivo de bloqueo y si se debe usar o no. 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 mostrar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
. - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso proporcionada es una ruta de acceso absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta de acceso relativa, se hará referencia al directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace".
- Se acumulan varios usos de
--registry=<a string>
. -
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los 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 haga que Bazel falle con un error de OOM. Cada límite se especifica como <period>:<count>, en el que period es una duración y count es un número entero positivo. Si más del porcentaje --gc_thrashing_threshold del espacio a perpetuidad (heap de generación anterior) permanece ocupado después de <count> GC completas consecutivas en <period>, se activa un error de OOM. Se pueden especificar varios límites separados por comas.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Es una marca para la configuración avanzada del motor Skyframe interno 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 GC completo, se descartará el estado temporal innecesario de Skyframe hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC completos nunca activarán las bajadas. 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"-
Es una marca para la configuración avanzada del motor Skyframe interno 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 GC menor, se descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC menores nunca activarán las bajadas. 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
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es de al menos este límite, descartará el estado temporal innecesario de Skyframe. Si ajustas este parámetro, es posible que puedas mitigar el impacto del tiempo de ejecución de la fragmentación de GC, cuando esta se produce (i) por el uso de memoria de este estado temporal y (ii) es más costoso 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:
--[no]experimental_command_profile
predeterminado: “false”- Graba un perfil de CPU de Java Flight Recorder en un archivo profile.jfr en el directorio base de salida. La sintaxis y la semántica de esta marca pueden cambiar en el futuro para admitir diferentes tipos de perfiles o formatos de salida. Úsala bajo tu propio riesgo.
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
- Opciones que especifican o alteran una entrada genérica a un comando de Bazel que no se incluye en otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite"), seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
--experimental_worker_for_repo_fetching=<off, platform or virtual>
predeterminado: "off"- Es el modo de subprocesos que se usará para recuperar el repo. Si se establece en "desactivado", no se usa ningún subproceso de trabajo y la recuperación del repo está sujeta a reinicios. De lo contrario, usa un subproceso de plataforma (es decir, un subproceso del SO) si se establece en "platform" o un subproceso virtual si se establece en "virtual".
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
. - Anula un repositorio con una ruta de acceso local en el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es una ruta absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta relativa, se relaciona con el directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace".
Opciones de sincronización
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
. -
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, se puede hacer que los repositorios externos funcionen en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_connector_attempts=<an integer>
predeterminado: “8”-
Es la cantidad máxima de intentos de descargas HTTP.
Etiquetas:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
predeterminado: “0s”-
Es el tiempo de espera máximo para los reintentos de descarga HTTP. Con un valor de 0, no se define un tiempo de espera máximo.
Etiquetas:bazel_internal_configuration
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la 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, se usa el valor predeterminado de '<output_user_root>/cache/repos/v1'.
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
predeterminado: “false”-
Si se establece, 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 se inhabilita por completo; 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 la compilación:
--[no]configure
predeterminado: "False"-
Solo los repositorios de sincronización marcados como "configurar" para la configuración del sistema.
Etiquetas:changes_inputs
--gc_thrashing_threshold=<an integer in 0-100 range>
predeterminado: "100"-
Es el porcentaje de espacio ocupado (de 0 a 100) por encima del cual GcThrashingDetector considera los eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, se inhabilita GcThrashingDetector.
Etiquetas:host_machine_resource_optimizations
--[no]keep_going
[-k
] predeterminado: "false"-
Continúa tanto como sea posible después de un error. Si bien no se pueden analizar el objetivo que falló ni los que dependen de él, sí se pueden analizar otros requisitos previos de estos objetivos.
Etiquetas:eagerness_to_exit
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
predeterminado: “auto”-
Cantidad de subprocesos en paralelo que se usarán para la fase de carga o análisis. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". "auto" establece un valor predeterminado razonable según los recursos del host. Debe ser 1 como mínimo.
Etiquetas:bazel_internal_configuration
- Se acumulan varios usos de
--only=<a string>
. -
Si se proporciona esta opción, solo se sincronizarán los repositorios especificados con esta opción. Aún se consideran obsoletos todos los comandos (o todos los comandos similares a configure, si se proporciona --configure).
Etiquetas:changes_inputs
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility
predeterminado: “false”-
Si incompatible_enforce_config_setting_visibility=false, esto es una operación no realizada. De lo contrario, si esta marca es falsa, cualquier config_setting sin un atributo de visibilidad explícito es //visibility:public. Si esta marca es verdadera, config_setting sigue la misma lógica de visibilidad que todas las demás reglas. Consulta https://github.com/bazelbuild/bazel/issues/12933.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
predeterminado: "true"-
Si es verdadero, aplica las restricciones de visibilidad de config_setting. Si es falso, todos los config_setting son visibles para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
. -
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitadas en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "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 un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
predeterminado: “update”- especifica cómo usar el archivo de bloqueo y si se debe usar o no. 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 mostrar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
. - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso proporcionada es una ruta de acceso absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta de acceso relativa, se hará referencia al directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace".
- Se acumulan varios usos de
--registry=<a string>
. -
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los 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 haga que Bazel falle con un error de OOM. Cada límite se especifica como <period>:<count>, en el que period es una duración y count es un número entero positivo. Si más del porcentaje --gc_thrashing_threshold del espacio a perpetuidad (heap de generación anterior) permanece ocupado después de <count> GC completas consecutivas en <period>, se activa un error de OOM. Se pueden especificar varios límites separados por comas.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Es una marca para la configuración avanzada del motor Skyframe interno 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 GC completo, se descartará el estado temporal innecesario de Skyframe hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC completos nunca activarán las bajadas. 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"-
Es una marca para la configuración avanzada del motor Skyframe interno 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 GC menor, se descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC menores nunca activarán las bajadas. 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
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es de al menos este límite, descartará el estado temporal innecesario de Skyframe. Si ajustas este parámetro, es posible que puedas mitigar el impacto del tiempo de ejecución de la fragmentación de GC, cuando esta se produce (i) por el uso de memoria de este estado temporal y (ii) es más costoso 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:
--[no]experimental_command_profile
predeterminado: “false”- Graba un perfil de CPU de Java Flight Recorder en un archivo profile.jfr en el directorio base de salida. La sintaxis y la semántica de esta marca pueden cambiar en el futuro para admitir diferentes tipos de perfiles o formatos de salida. Úsala bajo tu propio riesgo.
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
--experimental_repository_resolved_file=<a string>
predeterminado: ""-
Si no está vacío, escribe un valor de Starlark con la información resuelta de todas las reglas del repositorio de Starlark que se ejecutaron.
Etiquetas:affects_outputs
- Son opciones que especifican o alteran una entrada genérica en un comando de Bazel que no pertenece a otras categorías.:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite"), seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
--experimental_worker_for_repo_fetching=<off, platform or virtual>
predeterminado: "off"- Es el modo de subprocesos que se usará para recuperar el repo. Si se establece en "desactivado", no se usa ningún subproceso de trabajo y la recuperación del repo está sujeta a reinicios. De lo contrario, usa un subproceso de plataforma (es decir, un subproceso del SO) si se establece en "platform" o un subproceso virtual si se establece en "virtual".
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--deleted_packages=<comma-separated list of package names>
. - Es una lista separada por comas de nombres de paquetes que el sistema de compilación considerará inexistentes, incluso si son visibles en algún lugar de la ruta de acceso del paquete. Usa esta opción cuando borres un subpaquete "x/y" de un paquete existente "x". Por ejemplo, después de borrar x/y/BUILD en tu cliente, es posible que el sistema de compilación se queje si encuentra una etiqueta "//x:y/z" si otra entrada de package_path aún la proporciona. Especificar --deleted_packages x/y evita este problema.
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
. - Anula un repositorio con una ruta de acceso local en el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es una ruta absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta relativa, se relaciona con el directorio de trabajo actual. Si la ruta de acceso determinada 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%"- Es una lista separada por dos puntos de dónde buscar paquetes. Los elementos que comienzan con "%workspace%" son relativos al lugar de trabajo que los contiene. Si se omite o está vacío, el valor predeterminado es el resultado de "bazel info default-package-path".
--[no]show_loading_progress
predeterminado: "true"- Si está habilitado, hace que Bazel imprima mensajes de "Carga del paquete:".
Opciones de prueba
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
. -
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, se puede hacer que los repositorios externos funcionen en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_connector_attempts=<an integer>
predeterminado: “8”-
Es la cantidad máxima de intentos de descargas HTTP.
Etiquetas:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
predeterminado: “0s”-
Es el tiempo de espera máximo para los reintentos de descarga HTTP. Con un valor de 0, no se define un tiempo de espera máximo.
Etiquetas:bazel_internal_configuration
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la 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, se usa el valor predeterminado de '<output_user_root>/cache/repos/v1'.
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
predeterminado: “false”-
Si se establece, 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 se inhabilita por completo; 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 la compilación:
--gc_thrashing_threshold=<an integer in 0-100 range>
predeterminado: "100"-
Es el porcentaje de espacio ocupado (de 0 a 100) por encima del cual GcThrashingDetector considera los eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, se inhabilita GcThrashingDetector.
Etiquetas:host_machine_resource_optimizations
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
. -
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitadas en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "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 un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
predeterminado: “update”- especifica cómo usar el archivo de bloqueo y si se debe usar o no. 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 mostrar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
. - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso proporcionada es una ruta de acceso absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta de acceso relativa, se hará referencia al directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace".
- Se acumulan varios usos de
--registry=<a string>
. -
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los 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 haga que Bazel falle con un error de OOM. Cada límite se especifica como <period>:<count>, en el que period es una duración y count es un número entero positivo. Si más del porcentaje --gc_thrashing_threshold del espacio a perpetuidad (heap de generación anterior) permanece ocupado después de <count> GC completas consecutivas en <period>, se activa un error de OOM. Se pueden especificar varios límites separados por comas.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Es una marca para la configuración avanzada del motor Skyframe interno 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 GC completo, se descartará el estado temporal innecesario de Skyframe hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC completos nunca activarán las bajadas. 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"-
Es una marca para la configuración avanzada del motor Skyframe interno 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 GC menor, se descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC menores nunca activarán las bajadas. 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
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es de al menos este límite, descartará el estado temporal innecesario de Skyframe. Si ajustas este parámetro, es posible que puedas mitigar el impacto del tiempo de ejecución de la fragmentación de GC, cuando esta se produce (i) por el uso de memoria de este estado temporal y (ii) es más costoso 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:
--[no]experimental_command_profile
predeterminado: “false”- Graba un perfil de CPU de Java Flight Recorder en un archivo profile.jfr en el directorio base de salida. La sintaxis y la semántica de esta marca pueden cambiar en el futuro para admitir diferentes tipos de perfiles o formatos de salida. Úsala bajo tu propio riesgo.
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
--[no]print_relative_test_log_paths
predeterminado: “false”-
Si es verdadero, cuando imprimas la ruta de acceso a un registro de prueba, usa la ruta de acceso relativa que usa el symlink de conveniencia "testlogs". Nota: Una invocación posterior de "build", "test", etc., con una configuración diferente puede hacer que cambie el destino de este symlink, por lo que la ruta impresa anteriormente ya no es útil.
Etiquetas:affects_outputs
--[no]test_verbose_timeout_warnings
predeterminado: “false”-
Si es verdadero, imprime advertencias adicionales cuando el tiempo de ejecución real de la prueba no coincida con el tiempo de espera definido por la prueba (ya sea implícito o explícito).
Etiquetas:affects_outputs
--[no]verbose_test_summary
predeterminado: "true"-
Si es verdadero, imprime información adicional (tiempos, cantidad de ejecuciones fallidas, etcétera) en el resumen de la prueba.
Etiquetas:affects_outputs
- Son opciones que especifican o alteran una entrada genérica en un comando de Bazel que no pertenece a otras categorías.:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de almacenamiento en caché y ejecución remotas:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite"), seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
--experimental_worker_for_repo_fetching=<off, platform or virtual>
predeterminado: "off"- Es el modo de subprocesos que se usará para recuperar el repo. Si se establece en "desactivado", no se usa ningún subproceso de trabajo y la recuperación del repo está sujeta a reinicios. De lo contrario, usa un subproceso de plataforma (es decir, un subproceso del SO) si se establece en "platform" o un subproceso virtual si se establece en "virtual".
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
. - Anula un repositorio con una ruta de acceso local en el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es una ruta absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta relativa, se relaciona con el directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace".
Opciones de versión
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
. -
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, los repositorios externos pueden funcionar en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_connector_attempts=<an integer>
predeterminado: “8”-
Es la cantidad máxima de intentos de descargas HTTP.
Etiquetas:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
predeterminado: “0s”-
Es el tiempo de espera máximo para los reintentos de descarga HTTP. Con un valor de 0, no se define un tiempo de espera máximo.
Etiquetas:bazel_internal_configuration
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la 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, se usa el valor predeterminado de '<output_user_root>/cache/repos/v1'.
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
predeterminado: “false”-
Si se establece, 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 se inhabilita por completo; 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 la compilación:
--gc_thrashing_threshold=<an integer in 0-100 range>
predeterminado: "100"-
Es el porcentaje de espacio ocupado (de 0 a 100) por encima del cual GcThrashingDetector considera los eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, se inhabilita GcThrashingDetector.
Etiquetas:host_machine_resource_optimizations
- Son opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
--[no]gnu_format
predeterminado: “false”-
Si se establece, escribe la versión en stdout con las convenciones que se describen en los estándares de GNU.
Etiquetas:affects_outputs
,execution
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
. -
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitadas en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "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 un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
predeterminado: “update”- especifica cómo usar el archivo de bloqueo y si se debe usar o no. 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 mostrar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
. - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso proporcionada es una ruta de acceso absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta de acceso relativa, se hará referencia al directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace".
- Se acumulan varios usos de
--registry=<a string>
. -
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los 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 haga que Bazel falle con un error de OOM. Cada límite se especifica como <period>:<count>, en el que period es una duración y count es un número entero positivo. Si más del porcentaje --gc_thrashing_threshold del espacio a perpetuidad (heap de generación anterior) permanece ocupado después de <count> GC completas consecutivas en <period>, se activa un error de OOM. Se pueden especificar varios límites separados por comas.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Es una marca para la configuración avanzada del motor Skyframe interno 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 GC completo, se descartará el estado temporal innecesario de Skyframe hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC completos nunca activarán las bajadas. 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"-
Es una marca para la configuración avanzada del motor Skyframe interno 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 GC menor, se descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC menores nunca activarán las bajadas. 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
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es de al menos este límite, descartará el estado temporal innecesario de Skyframe. Si ajustas este parámetro, es posible que puedas mitigar el impacto del tiempo de ejecución de la fragmentación de GC, cuando esta se produce (i) por el uso de memoria de este estado temporal y (ii) es más costoso 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:
--[no]experimental_command_profile
predeterminado: “false”- Graba un perfil de CPU de Java Flight Recorder en un archivo profile.jfr en el directorio base de salida. La sintaxis y la semántica de esta marca pueden cambiar en el futuro para admitir diferentes tipos de perfiles o formatos de salida. Úsala bajo tu propio riesgo.
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
- Opciones que especifican o alteran una entrada genérica a un comando de Bazel que no se incluye en otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite"), seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
--experimental_worker_for_repo_fetching=<off, platform or virtual>
predeterminado: "off"- Es el modo de subprocesos que se usará para recuperar el repo. Si se establece en "desactivado", no se usa ningún subproceso de trabajo y la recuperación del repo está sujeta a reinicios. De lo contrario, usa un subproceso de plataforma (es decir, un subproceso del SO) si se establece en "platform" o un subproceso virtual si se establece en "virtual".
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
. - Anula un repositorio con una ruta de acceso local en el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es una ruta absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta relativa, se relaciona con el directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace".
Etiquetas de efectos de opciones
unknown |
Esta opción tiene un efecto desconocido o no documentado. |
no_op |
Esta opción literalmente no tiene ningún efecto. |
loses_incremental_state |
Cambiar el valor de esta opción puede provocar una pérdida significativa del estado incremental, lo que ralentiza las compilaciones. Es posible que se pierda el estado debido a un reinicio del servidor o a la invalidación de una gran parte del gráfico de dependencias. |
changes_inputs |
Esta opción cambia de forma activa las entradas que bazel considera para la compilación, como las restricciones del sistema de archivos, las versiones del repositorio y otras opciones. |
affects_outputs |
Esta opción afecta los resultados de bazel. Esta etiqueta es amplia de forma intencional, puede incluir efectos transitivos y no especifica el tipo de resultado que afecta. |
build_file_semantics |
Esta opción afecta la semántica de los archivos BUILD o .bzl. |
bazel_internal_configuration |
Esta opción afecta la configuración de la maquinaria interna de Bazel. Esta etiqueta, por sí sola, no significa que los artefactos de compilación se vean afectados. |
loading_and_analysis |
Esta opción afecta la carga y el análisis de las dependencias, así como la compilación del gráfico de dependencias. |
execution |
Esta opción afecta la fase de ejecución, como las opciones relacionadas con la zona de pruebas o la ejecución remota. |
host_machine_resource_optimizations |
Esta opción activa una optimización que puede ser específica de la máquina y no se garantiza que funcione en todas las máquinas. La optimización podría incluir una compensación con otros aspectos del rendimiento, como el costo de la memoria o la CPU. |
eagerness_to_exit |
Esta opción cambia la rapidez con la que bazel saldrá de una falla, en la que existe una opción entre continuar a pesar de la falla y finalizar la invocación. |
bazel_monitoring |
Esta opción se usa para supervisar el comportamiento y el rendimiento de bazel. |
terminal_output |
Esta opción afecta el resultado de la terminal de bazel. |
action_command_lines |
Esta opción cambia los argumentos de línea de comandos de una o más acciones de compilación. |
test_runner |
Esta opción cambia el entorno de testrunner de la compilación. |
Etiquetas de metadatos de opciones
experimental |
Esta opción activa una función experimental sin garantías de funcionalidad. |
incompatible_change |
Esta opción activa un cambio rotundo. Usa esta opción para probar si tu cuenta está preparada para la migración o para obtener acceso anticipado a la nueva función. |
deprecated |
Esta opción está obsoleta. Es posible que la función a la que afecta esté obsoleta o que se prefiera otro método para proporcionar la información. |