bazel [<startup options>] <command> [<args>]o
bazel [<startup options>] <command> [<args>] -- [<target patterns>]Consulta la Guía del usuario para conocer la sintaxis de los patrones de segmentación.
Sintaxis de la opción
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>Algunas opciones tienen una forma corta de un solo carácter; en ese caso, la forma corta se debe pasar con un solo guion y espacio.
-<short_form> <value>
Las opciones booleanas se pueden habilitar de la siguiente manera:
--<option> --<option>=[true|yes|1]y, luego, inhabilitarse de la siguiente manera:
--no<option> --<option>=[false|no|0]
Las opciones de triestado suelen estar configuradas como automáticas de forma predeterminada y se pueden habilitar de manera forzosa de la siguiente manera:
--<option>=[true|yes|1]o forzar la inhabilitación de la siguiente manera:
--no<option> --<option>=[false|no|0]
Comandos
analyze-profile |
Analiza los datos de perfil de compilación. |
aquery |
Analiza los objetivos dados y consulta el gráfico de acción. |
build |
Compila los destinos especificados. |
canonicalize-flags |
Canonicaliza una lista de opciones de bazel. |
clean |
Quita los archivos de salida y, de manera opcional, detiene el servidor. |
coverage |
Genera un informe de cobertura de código para objetivos de prueba especificados. |
cquery |
Carga, analiza y consulta los objetivos especificados con configuraciones. |
dump |
Vuelca el estado interno del proceso del servidor de Bazel. |
fetch |
Recupera repositorios externos que son requisitos previos para los destinos. |
help |
Imprime la 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 dependencia externa 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 objetivo 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. |
vendor |
Recupera repositorios externos en una carpeta específica especificada por la marca --vendor_dir. |
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:
- El valor predeterminado de
--[no]autodetect_server_javabase
es "true" (verdadero). -
Cuando se pasa --noautodetect_server_javabase, Bazel no recurre al JDK local para ejecutar el servidor de Bazel y, en su lugar, se cierra.
Etiquetas:affects_outputs
,loses_incremental_state
--[no]batch
valor predeterminado: "false"-
Si se configura, Bazel se ejecutará como un proceso de cliente sin un servidor, en lugar de en el modo estándar de cliente/servidor. Esta función dejó de estar disponible y se quitará. Si quieres evitar que los servidores permanezcan activos, es preferible que apagues el servidor de forma explícita.
Etiquetas:loses_incremental_state
,bazel_internal_configuration
,deprecated
--[no]batch_cpu_scheduling
valor predeterminado: "false"-
Solo en Linux; usa la programación de CPU "por lotes" para Blaze. Esta política es útil para las cargas de trabajo que no son interactivas, pero que no desean reducir su valor adecuado. Consulta "man 2 sched_setscheduler". Si es falso, Bazel no realiza una llamada al sistema.
Etiquetas:host_machine_resource_optimizations
- Configuración predeterminada de
--bazelrc=<path>
: ver descripción -
La ubicación del archivo .bazelrc del usuario que contiene los valores predeterminados de las opciones de Bazel. /dev/null indica que se ignorarán todos los demás `--bazelrc`, lo que es útil para inhabilitar la búsqueda de un archivo RC del usuario, p.ej., en compilaciones de lanzamiento.
Esta opción también se puede especificar varias veces.
P.ej., con `--bazelrc=x.rc --bazelrc=y.rc --bazelrc=/dev/null --bazelrc=z.rc`,
1) se leen x.rc y y.rc.
2) z.rc se ignora debido a la existencia anterior de /dev/null.
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 la línea de comandos siempre sustituirán a cualquier opción en Bazelrc.
Etiquetas:changes_inputs
- El valor predeterminado de
--[no]block_for_lock
es "true" (verdadero). -
Cuando se pasa --noblock_for_lock, Bazel no espera a que se complete un comando en ejecución, sino que se cierra de inmediato.
Etiquetas:eagerness_to_exit
--[no]client_debug
valor predeterminado: "false"-
Si es verdadero, registra la información de depuración del cliente en stderr. El cambio de esta opción no provocará que el servidor se reinicie.
Etiquetas:affects_outputs
,bazel_monitoring
--connect_timeout_secs=<an integer>
predeterminado: "30"-
La cantidad de tiempo que el cliente espera cada intento de conectarse al servidor
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--digest_function=<hash function>
: ver descripción -
Es la función hash que se usa cuando se calculan los resúmenes de archivos.
Etiquetas:loses_incremental_state
,bazel_internal_configuration
- El valor predeterminado de
--[no]expand_configs_in_place
es "true" (verdadero). -
Se cambió la expansión de las marcas --config para que se realice de forma local, en lugar de en una expansión de puntos fijos entre las opciones de RC normales y las opciones especificadas de la línea de comandos.
Etiquetas:no_op
,deprecated
- Configuración predeterminada de
--failure_detail_out=<path>
: ver descripción -
Si se configura, especifica una ubicación para escribir un mensaje protobuf de failed_detail si el servidor experimenta una falla y no puede informarla a través de gRPC, como es habitual. De lo contrario, la ubicación será ${OUTPUT_BASE}/failure_detail.rawproto.
Etiquetas:affects_outputs
,loses_incremental_state
- El valor predeterminado de
--[no]home_rc
es "true" (verdadero). -
Si se debe buscar o no el archivo de bazelrc doméstico en $HOME/.bazelrc
Etiquetas:changes_inputs
- El valor predeterminado de
--[no]idle_server_tasks
es "true" (verdadero). -
Ejecuta System.gc() cuando el servidor esté inactivo
Etiquetas:loses_incremental_state
,host_machine_resource_optimizations
--[no]ignore_all_rc_files
valor predeterminado: "false"-
Inhabilita todos los archivos RC, sin importar los valores de otras marcas de modificación de RC, incluso si estas marcas aparecen más adelante en la lista de opciones de inicio.
Etiquetas:changes_inputs
--io_nice_level={-1,0,1,2,3,4,5,6,7}
valor predeterminado: "-1"-
Solo en Linux. Establece un nivel del 0 al 7 para la mejor programación de E/S de esfuerzo con la llamada del sistema sys_ioprio_set. 0 es la prioridad más alta, 7 es la menor. El programador anticipativo 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"-
La cantidad máxima de tiempo que el cliente espera para conectarse al servidor
Etiquetas:bazel_internal_configuration
--macos_qos_class=<a string>
valor predeterminado: "default"-
Establece la clase de servicio QoS del servidor de Bazel cuando se ejecuta en macOS. Esta marca no tiene efecto en todas las demás plataformas, pero es compatible para garantizar que los archivos RC se puedan compartir entre ellas sin cambios. Los valores posibles son: interactivo por el usuario, iniciado por el usuario, predeterminado, utilidad y 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 apagará. Esto solo se lee cuando se inicia el servidor; cambiar esta opción no hará que el servidor se reinicie.
Etiquetas:eagerness_to_exit
,loses_incremental_state
- Configuración predeterminada de
--output_base=<path>
: ver descripción -
Si se configura, especifica la ubicación de salida en la que se escribirán todos los resultados de la compilación. De lo contrario, la ubicación será ${OUTPUT_ROOT}/_blaze_${USER}/${MD5_OF_WORKSPACE_ROOT}. Nota: Si especificas una opción diferente a la siguiente invocación de Bazel para este valor, es probable que inicies un nuevo servidor de Bazel adicional. Bazel inicia exactamente un servidor por base de salida especificada. Por lo general, hay una base de salida por lugar de trabajo. Sin embargo, con esta opción, puedes tener varias bases de salida por lugar de trabajo y, por lo tanto, ejecutar varias compilaciones para el mismo cliente en la misma máquina de forma simultánea. Consulta “Ayuda de Bazel para apagar” las instrucciones para apagar un servidor de Bazel.
Etiquetas:affects_outputs
,loses_incremental_state
- Configuración predeterminada de
--output_user_root=<path>
: ver descripción -
El directorio específico del usuario debajo del cual se escriben todos los resultados de compilación. De forma predeterminada, esta es una función de $USER. Sin embargo, si se especifica una constante, los resultados de compilación se pueden compartir entre los usuarios colaboradores.
Etiquetas:affects_outputs
,loses_incremental_state
--[no]preemptible
valor predeterminado: "false"-
Si es verdadero, el comando puede interrumpirse si se inicia otro.
Etiquetas:eagerness_to_exit
- Configuración predeterminada de
--server_jvm_out=<path>
: ver descripción -
Es la ubicación en la que se escribirá la salida de 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
valor predeterminado: "false"-
Si se establece max_idle_secs y el servidor de compilación ha estado inactivo durante un tiempo, apágalo cuando el sistema tenga poca memoria RAM libre. Solo en Linux.
Etiquetas:eagerness_to_exit
,loses_incremental_state
- El valor predeterminado de
--[no]system_rc
es "true" (verdadero). -
Indica si se debe buscar o no el Bazelrc en todo el sistema.
Etiquetas:changes_inputs
--[no]unlimit_coredumps
valor predeterminado: "false"-
Aumenta el límite de softdump de softdump al límite estricto para que, en condiciones comunes, sean posibles los coredump del servidor (incluida la JVM) y del cliente. Pega esta marca en tu Bazelrc una vez y olvídate de ella para obtener coredumps cuando encuentres una condición que los active.
Etiquetas:bazel_internal_configuration
--[no]watchfs
valor predeterminado: "false"-
Si es verdadero, Bazel intenta usar el servicio de supervisión de archivos del sistema operativo para realizar cambios locales en lugar de analizar todos los archivos en busca de cambios.
Etiquetas:deprecated
--[no]windows_enable_symlinks
valor predeterminado: "false"-
Si es verdadero, se crearán vínculos simbólicos reales en Windows en lugar de la copia de archivos. Requiere que esté habilitado el modo de desarrollador de Windows y Windows 10 versión 1703 o posterior.
Etiquetas:bazel_internal_configuration
- El valor predeterminado de
--[no]workspace_rc
es "true" (verdadero). -
Busca o no el archivo de bazelrc de Workspace en $workspace/.bazelrc
Etiquetas:changes_inputs
- Opciones varias, que no están categorizadas:
- Se acumulan
--host_jvm_args=<jvm_arg>
usos múltiples - Marcas para pasar a la JVM que ejecuta Blaze.
--host_jvm_debug
-
Es una opción conveniente para agregar algunas marcas de inicio de JVM adicionales, que hacen que la JVM espere durante el inicio hasta que te conectes desde un depurador compatible con JDWP (como Eclipse) al puerto 5005.
Se expande a:
--host_jvm_args=-Xdebug
--host_jvm_args=-Xrunjdwp:transport=dt_socket,server=y,address=5005
--server_javabase=<jvm path>
predeterminado: ""- Ruta de acceso a la JVM que se usó para ejecutar Bazel.
Opciones comunes para 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 y stderr que se imprimirán en la consola. -1 implica que no hay límite.
Etiquetas:execution
- El valor predeterminado de
--[no]incompatible_remote_dangling_symlinks
es "true" (verdadero). -
Si se configura como verdadera, los symlinks subidos a una caché remota o de disco pueden colgarse.
Etiquetas:execution
,incompatible_change
- El valor predeterminado de
--[no]incompatible_remote_symlinks
es "true" (verdadero). -
Si se configura como verdadera, Bazel siempre subirá symlinks, como tales, a una caché remota o de disco. De lo contrario, se subirán solo esos vínculos simbólicos relativos (y solo aquellos) como el archivo o directorio al que apuntan.
Etiquetas:execution
,incompatible_change
- Opciones que configuran la cadena de herramientas que se usa para ejecutar la acción:
--[no]incompatible_enable_proto_toolchain_resolution
valor predeterminado: "false"-
Si es verdadero, las reglas de proto lang definen cadenas de herramientas a partir de repositorios de rules_proto, rules_java, 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>
valor predeterminado: "-1"-
Cantidad máxima de archivos abiertos permitida durante la carga del artefacto BEP.
Etiquetas:affects_outputs
--remote_download_all
-
Descarga todas las salidas remotas 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 en 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 configura como “mínima”, no se descarga ningún resultado de compilación remota en la máquina local, excepto los que requieren las acciones locales. Si se configura 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 representa un cuello de botella.
Etiquetas:affects_outputs
--remote_download_symlink_template=<a string>
predeterminado: ""-
En lugar de descargar resultados de compilación remotas en la máquina local, crea vínculos simbólicos. El destino de los vínculos simbólicos puede especificarse con la forma de una cadena de plantilla. Esta string de plantilla puede contener {hash} y {size_bytes} que se expanden al hash del objeto y el tamaño en bytes, respectivamente. Estos vínculos simbólicos pueden apuntar, por ejemplo, a un sistema de archivos FUSE que cargue objetos de CAS a pedido.
Etiquetas:affects_outputs
--remote_download_toplevel
- Solo descarga las salidas remotas de los 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
--repo_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica variables de entorno adicionales que estarán disponibles solo para las reglas del repositorio. Ten en cuenta que las reglas del repositorio ven el entorno completo de todas formas, 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 acción.
Etiquetas:action_command_lines
- Opciones que afectan la medida en la que Bazel aplica de manera estricta entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
- El valor predeterminado de
--[no]check_bzl_visibility
es "true" (verdadero). - Si se inhabilita, los errores de visibilidad de carga .bzl descienden a advertencias.
Etiquetas:build_file_semantics
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE.:
- El valor predeterminado de
--[no]enable_bzlmod
es "true" (verdadero). -
Si es verdadero, se habilita el sistema de administración de dependencias Bzlmod, y tiene prioridad sobre WORKSPACE. Para obtener más información, consulta https://bazel.build/docs/bzlmod.
Etiquetas:loading_and_analysis
- El valor predeterminado de
--[no]enable_workspace
es "true" (verdadero). -
Si es verdadero, se habilita el sistema WORKSPACE heredado para las dependencias externas. Consulta https://bazel.build/external/overview para obtener más información.
Etiquetas:loading_and_analysis
- El valor predeterminado de
--[no]experimental_action_resource_set
es "true" (verdadero). -
Si se configura como verdadera, ="{.actions.run() y ="{.actions.run_shell() aceptan un parámetro resource_set para la ejecución local. De lo contrario, el valor predeterminado será de 250 MB para la memoria y 1 CPU.
Etiquetas:execution
,build_file_semantics
,experimental
- El valor predeterminado de
--[no]experimental_bzl_visibility
es "true" (verdadero). -
Si se habilita, se agrega una función `visibility()` a la que los archivos .bzl pueden llamar durante la evaluación de nivel superior para configurar su visibilidad con el fin de sentencias load().
Etiquetas:loading_and_analysis
,experimental
-
Si se configura como verdadera, los atributos de la regla y los métodos de la API de Starlark necesarios para la regla cc_shared_library estarán disponibles
Etiquetas:build_file_semantics
,loading_and_analysis
,experimental
--[no]experimental_disable_external_package
valor predeterminado: "false"-
Si se configura como verdadera, el paquete externo //generado automáticamente ya no estará disponible. Bazel aún no podrá analizar el archivo “external/BUILD”, pero los globs que lleguen a external/ desde el paquete sin nombre funcionarán.
Etiquetas:loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_enable_android_migration_apis
valor predeterminado: "false"-
Si se configura como verdadera, habilita las APIs necesarias para admitir la migración de Android Starlark.
Etiquetas:build_file_semantics
--[no]experimental_enable_first_class_macros
valor predeterminado: "false"-
Si se establece como verdadera, se habilita la construcción `macro()` para definir macros de primera clase.
Etiquetas:build_file_semantics
--[no]experimental_enable_scl_dialect
valor predeterminado: "false"-
Si se configura como verdadera, los archivos .scl se pueden usar en las declaraciones load().
Etiquetas:build_file_semantics
--[no]experimental_google_legacy_api
valor predeterminado: "false"-
Si se establece como verdadera, se exponen algunas piezas 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
valor 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
valor predeterminado: "false"-
Si se habilita, el módulo experimental_java_library_export_do_not_use estará disponible.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]experimental_platforms_api
valor predeterminado: "false"-
Si se configura como verdadera, se habilitan varias APIs de Starlark relacionadas con la plataforma que son útiles para la depuración.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repo_remote_exec
valor predeterminado: "false"-
Si se configura como true, Repositories_rule obtiene algunas capacidades de ejecución remota.
Etiquetas:build_file_semantics
,loading_and_analysis
,experimental
--[no]experimental_sibling_repository_layout
valor predeterminado: "false"-
Si se configura como true, los repositorios que no sean 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 “external” de nivel superior real.
Etiquetas:action_command_lines
,bazel_internal_configuration
,loading_and_analysis
,loses_incremental_state
yexperimental
-
Si se configura como verdadera, las etiquetas se propagarán desde un destino a los requisitos de ejecución de las acciones; de lo contrario, las etiquetas no se propagarán. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/8830.
Etiquetas:build_file_semantics
,experimental
- El valor predeterminado de
--[no]incompatible_always_check_depset_elements
es "true" (verdadero). -
Verifica la validez de los elementos agregados a depsets, en todos los constructores. Los elementos deben ser inmutables, pero históricamente el constructor depset(direct=...) olvidó verificarlos. Usa tuplas en lugar de listas en los elementos depset. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/10313.
Etiquetas:build_file_semantics
,incompatible_change
- El valor predeterminado de
--[no]incompatible_depset_for_libraries_to_link_getter
es "true" (verdadero). -
Cuando el valor es verdadero, Bazel ya no muestra una lista de links_context.libraries_to_link y, en su lugar, muestra un depset.
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_disable_objc_library_transition
es "true" (verdadero). -
Inhabilitar la transición personalizada de objc_library y heredar contenido del objetivo de nivel superior
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_disable_starlark_host_transitions
valor predeterminado: "false"-
Si se establece como verdadera, los atributos de la regla no pueden establecer “cfg = “host”. En su lugar, se debe establecer “cfg = “exec”' en las reglas.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_disable_target_default_provider_fields
valor predeterminado: "false"-
Si se establece como verdadera, se inhabilita la capacidad de acceder a los proveedores en los objetos "de destino" mediante la sintaxis de campos. En su lugar, usa la sintaxis de clave de proveedor. Por ejemplo, en lugar de usar `="{.attr.dep.my_info` para acceder a `my_info` desde una función de implementación de reglas, usa `="{.attr.dep[MyInfo]`. Visita https://github.com/bazelbuild/bazel/issues/9014 para obtener más detalles.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_disable_target_provider_fields
valor predeterminado: "false"-
Si se establece como verdadera, se inhabilita la capacidad de usar el proveedor predeterminado a través de la sintaxis de campos. En su lugar, usa la sintaxis de clave de proveedor. Por ejemplo, en lugar de usar `="{.attr.dep.files` para acceder a `files`, usa `="{.attr.dep[DefaultInfo].files. Consulta https://github.com/bazelbuild/bazel/issues/9014 para obtener más detalles.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_disallow_empty_glob
valor predeterminado: "false"-
Si se configura como true, el valor predeterminado del argumento `allow_empty` de glob() es False.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_disallow_struct_provider_syntax
valor predeterminado: "false"-
Si se establece como verdadera, es posible que las funciones de implementación de reglas no muestren un struct. En su lugar, debe mostrar una lista de instancias del proveedor.
Etiquetas:build_file_semantics
,incompatible_change
- El valor predeterminado de
--[no]incompatible_enable_deprecated_label_apis
es "true" (verdadero). -
Si se habilita, se pueden usar ciertas APIs obsoletas (native.repository_name, Label.workspace_name, Label.relative).
Etiquetas:loading_and_analysis
- El valor predeterminado de
--[no]incompatible_existing_rules_immutable_view
es "true" (verdadero). -
Si se configura como true, native.existing_rule y native.existing_rules, se muestran objetos de vista inmutables ligeros en lugar de diccionarios mutables.
Etiquetas:build_file_semantics
,loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_fail_on_unknown_attributes
es "true" (verdadero). -
Si se habilita, fallan los destinos con atributos desconocidos configurados como "None".
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_fix_package_group_reporoot_syntax
es "true" (verdadero). -
En el atributo `packages` de package_group, cambia el significado del valor "//..." para hacer referencia a todos los paquetes en el repositorio actual en lugar de a todos los paquetes en cualquier repositorio. Puedes usar el valor especial "public" en lugar de "//..." para obtener el comportamiento anterior. Esta marca requiere que también se habilite la sintaxis --incompatible_package_group_has_public_syntax.
Etiquetas:build_file_semantics
,incompatible_change
- El valor predeterminado de
--[no]incompatible_java_common_parameters
es "true" (verdadero). -
Si se establece como verdadera, se quitarán los parámetros output_jar y host_javabase en pack_sources y host_javabase de compilación.
Etiquetas:build_file_semantics
,incompatible_change
- El valor predeterminado de
--[no]incompatible_merge_fixed_and_default_shell_env
es "true" (verdadero). -
Si se habilita esta opción, las acciones registradas con ="{.actions.run y ="{.actions.run_shell con los valores 'env' y 'use_default_shell_env = True' especificados usarán un entorno obtenido del entorno de shell predeterminado anulando con los valores pasados a 'env'. Si está inhabilitada, el valor de “env” se ignora por completo en este caso.
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_no_attr_license
es "true" (verdadero). -
Si se configura como verdadera, se inhabilita la función `attr.license`.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_no_implicit_file_export
valor predeterminado: "false"-
Si se configura, los archivos de origen (usados) son privados en paquetes, 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
valor predeterminado: "false"-
Si se configura como true, se inhabilita el parámetro `outputs` de la función `rule()`.
Etiquetas:build_file_semantics
,incompatible_change
- El valor predeterminado de
--[no]incompatible_package_group_has_public_syntax
es "true" (verdadero). -
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
- El valor predeterminado de
--[no]incompatible_require_linker_input_cc_api
es "true" (verdadero). -
Si se establece como verdadera, la regla create_linking_context requerirá linker_inputs en lugar de library_to_link. También se inhabilitarán los métodos get anteriores de links_context y solo estarán disponibles los linker_inputs.
Etiquetas:build_file_semantics
,loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_run_shell_command_string
es "true" (verdadero). -
Si se configura como true, el parámetro de comando de actions.run_shell solo aceptará la cadena
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_stop_exporting_build_file_path
valor predeterminado: "false"-
Si la estableces como verdadera, no estará disponible el parámetro ="{.build_file_path obsoleto. En su lugar, se puede usar ="{.label.package + '/BUILD'.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_stop_exporting_language_modules
valor predeterminado: "false"-
Si se habilita, ciertos módulos específicos de lenguaje (como "cc_common") no están disponibles en los archivos .bzl del usuario y solo se los puede llamar desde sus respectivos repositorios de reglas.
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_struct_has_no_methods
es "true" (verdadero). -
Inhabilita los métodos to_json y to_proto de struct, que contaminan el espacio de nombres del campo de 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
valor predeterminado: "false"-
Si se configura como verdadera, el aspecto de nivel superior respetará sus proveedores requeridos y solo se ejecutará en destinos de nivel superior cuyos proveedores promocionados de reglas satisfagan los proveedores requeridos del aspecto.
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_unambiguous_label_stringification
es "true" (verdadero). -
Cuando sea verdadero, Bazel vinculará la etiqueta @//foo:bar a @//foo:bar, en lugar de //foo:bar. Esto solo afecta el comportamiento de str(), el operador %, etc.; el comportamiento de repr() no se modifica. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/15916.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_use_cc_configure_from_rules_cc
valor predeterminado: "false"-
Cuando sea verdadero, Bazel ya no permitirá el uso de 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
--max_computation_steps=<a long integer>
predeterminado: "0"-
Es la cantidad máxima de pasos de cálculo de Starlark que puede ejecutar un archivo BUILD (cero significa que no hay límite).
Etiquetas:build_file_semantics
--nested_set_depth_limit=<an integer>
predeterminado: "3500"-
Es la profundidad máxima del gráfico interno de un depset (también conocido como NestedSet), por encima de la cual fallará el constructor depset().
Etiquetas:loading_and_analysis
- Opciones que activan optimizaciones del tiempo de compilación:
--[no]heuristically_drop_nodes
valor predeterminado: "false"-
Si es verdadero, Blaze quitará los nodos FileState y DirectoryListingState después de que se completen los nodos relacionados File y DirectoryListing para ahorrar memoria. Esperamos que sea menos probable que estos nodos se necesiten nuevamente. De ser así, el programa los volverá a evaluar.
Etiquetas:loses_incremental_state
- El valor predeterminado de
--[no]incompatible_do_not_split_linking_cmdline
es "true" (verdadero). -
Cuando es verdadero, Bazel ya no modifica las marcas de línea de comandos que se usan para la vinculación y tampoco decide qué marcas van al archivo de parámetros y cuáles no. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/7670.
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]keep_state_after_build
es "true" (verdadero). -
Si es falso, Blaze descartará el estado de memoria de esta compilación cuando finalice. Las compilaciones posteriores no tendrán ninguna incrementalidad con respecto a esta.
Etiquetas:loses_incremental_state
- El valor predeterminado de
--[no]track_incremental_state
es "true" (verdadero). -
Si es falso, Blaze no conservará datos que permitan la invalidación y la reevaluación en compilaciones incrementales para ahorrar memoria en esta compilación. Las compilaciones posteriores no tendrán ninguna incrementalidad con respecto a esta. Por lo general, es posible que desees especificar --batch cuando configuras esto como falso.
Etiquetas:loses_incremental_state
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]announce_rc
valor predeterminado: "false"-
Indica si se deben anunciar las opciones de RCS.
Etiquetas:affects_outputs
--[no]attempt_to_print_relative_paths
valor predeterminado: "false"-
Cuando imprimas la parte de la ubicación de los mensajes, intenta usar una ruta de acceso relativa al directorio del lugar 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 admitidos son grpc y grpcs (grpc con TLS habilitada). Si no se proporciona un esquema, Bazel asume que es grpcs.
Etiquetas:affects_outputs
--[no]bes_check_preceding_lifecycle_events
valor predeterminado: "false"-
Establece el campo check_preceding_lifecycle_events_present en PublishBuildToolEventStreamRequest, que le indica a BES que verifique si anteriormente recibió eventos InvocationRetryStarted y BuildEnqueue que coinciden con el evento actual de la herramienta.
Etiquetas:affects_outputs
- Se acumulan
--bes_header=<a 'name=value' assignment>
usos múltiples -
Especifica un encabezado en el formulario NAME=VALUE que se incluirá en las solicitudes de BES. Se pueden pasar varios encabezados si se especifica la marca varias veces. Si hay varios valores con el mismo nombre, se convertirán en una lista separada por comas.
Etiquetas:affects_outputs
- Configuración predeterminada de
--bes_instance_name=<a string>
: ver descripción -
Especifica el nombre de la instancia en la que el BES conservará el BEP subido. El valor predeterminado es nulo.
Etiquetas:affects_outputs
- Se acumulan
--bes_keywords=<comma-separated list of options>
usos múltiples -
Especifica una lista de palabras clave de notificación que deben agregarse al conjunto predeterminado de palabras clave publicadas en BES ("command_name=<command_name> ", "protocol_name=BEP"). La configuración predeterminada es Ninguna.
Etiquetas:affects_outputs
- El valor predeterminado de
--[no]bes_lifecycle_events
es "true" (verdadero). -
Especifica si se publican eventos de ciclo de vida de BES. (el valor predeterminado es "true").
Etiquetas:affects_outputs
--bes_oom_finish_upload_timeout=<An immutable length of time.>
predeterminado: "10m"-
Especifica cuánto tiempo debe esperar Bazel para que se complete la carga de BES/BEP mientras se realiza la OOM. Esta marca garantiza la finalización cuando la JVM tiene una hiperpaginación excesiva de GC y no puede progresar en ningún subproceso del usuario.
Etiquetas:bazel_monitoring
--bes_outerr_buffer_size=<an integer>
predeterminado: "10240"-
Especifica el tamaño máximo de stdout o stderr que se almacenará en búfer en BEP antes de que se informe como un evento de progreso. Las escrituras individuales se informan en un solo evento, incluso si son mayores que el valor especificado hasta (--bes_outerr_chunk_size).
Etiquetas:affects_outputs
--bes_outerr_chunk_size=<an integer>
predeterminado: "1048576"-
Especifica el tamaño máximo de stdout o stderr que se enviará a BEP en un solo mensaje.
Etiquetas:affects_outputs
- Configuración predeterminada de
--bes_proxy=<a string>
: ver descripción - Conéctate al servicio de eventos de compilación a través de un proxy. Actualmente, esta marca solo se puede usar para configurar un socket de dominio Unix (unix:/path/to/socket).
--bes_results_url=<a string>
predeterminado: ""-
Especifica la URL base en la que un usuario puede ver la información que se transmite al backend de BES. Bazel enviará a la terminal la URL que agregó el ID de invocación.
Etiquetas:terminal_output
- Se acumulan
--bes_system_keywords=<comma-separated list of options>
usos múltiples -
Especifica una lista de palabras clave para notificaciones que se incluirán directamente, sin el prefijo "user_keyword=", para las palabras clave suministradas mediante --bes_Keywords. Está destinado a los operadores del servicio de compilación que establecen --bes_lifecycle_events=false y que incluyen palabras clave cuando se llama a PublishLifecycleEvent. Los operadores de servicios de compilación que usan esta marca deberían evitar que los usuarios anulen el valor de la marca.
Etiquetas:affects_outputs
- Valor predeterminado de
--bes_timeout=<An immutable length of time.>
: "0 s" -
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>
valor 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 debe finalizar la invocación de inmediato y finalizar la carga en segundo plano. Puede ser “wait_for_upload_complete” (predeterminado), “nowait_for_upload_complete” o “completamente_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 de representación del protocolo de eventos de compilación en ese archivo. Esta opción implica --bes_upload_mode=wait_for_upload_complete.
Etiquetas:affects_outputs
- El valor predeterminado de
--[no]build_event_binary_file_path_conversion
es "true" (verdadero). -
Convierte las rutas de acceso de la representación de archivo binario del protocolo de eventos de compilación en URIs más válidos a nivel global siempre que sea posible. Si se inhabilita, siempre se usará el esquema file:// uri
Tags:affects_outputs
--build_event_binary_file_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>
valor 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 debe finalizar la invocación de inmediato y finalizar la carga en segundo plano. Puede ser “wait_for_upload_complete” (predeterminado), “nowait_for_upload_complete” o “completamente_async”.
Etiquetas:eagerness_to_exit
--build_event_json_file=<a string>
predeterminado: ""-
Si no está vacío, escribe una serialización JSON del protocolo de eventos de compilación en ese archivo. Esta opción implica --bes_upload_mode=wait_for_upload_complete.
Etiquetas:affects_outputs
- El valor predeterminado de
--[no]build_event_json_file_path_conversion
es "true" (verdadero). -
Convierte las rutas de acceso de la representación del archivo JSON del protocolo de eventos de compilación en URIs más válidos a nivel global siempre que sea posible. Si se inhabilita, siempre se usará el esquema file:// uri
Tags:affects_outputs
--build_event_json_file_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>
valor 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 debe finalizar la invocación de inmediato y finalizar la carga en segundo plano. Puede ser “wait_for_upload_complete” (predeterminado), “nowait_for_upload_complete” o “completamente_async”.
Etiquetas:eagerness_to_exit
--build_event_max_named_set_of_file_entries=<an integer>
predeterminado: "5000"-
Es la cantidad máxima de entradas para un solo evento names_set_of_files. Se ignoran los valores menores que 2 y no se realiza ninguna división de eventos. Está diseñado para limitar el tamaño máximo del evento en el protocolo de eventos de compilación, aunque no controla el tamaño del evento de forma directa. El tamaño total del evento es una función de la estructura del conjunto, así como 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
valor predeterminado: "false"-
Determina 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 de eventos de compilación en ese archivo
Etiquetas:affects_outputs
- El valor predeterminado de
--[no]build_event_text_file_path_conversion
es "true" (verdadero). -
Convierte las rutas de acceso de la representación de archivo de texto del protocolo de eventos de compilación en URIs más válidos a nivel global siempre que sea posible. Si se inhabilita, siempre se usará el esquema file:// uri
Tags:affects_outputs
--build_event_text_file_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>
valor 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 debe finalizar la invocación de inmediato y finalizar la carga en segundo plano. Puede ser “wait_for_upload_complete” (predeterminado), “nowait_for_upload_complete” o “completamente_async”.
Etiquetas:eagerness_to_exit
--build_event_upload_max_retries=<an integer>
predeterminado: "4"-
Es la cantidad máxima de veces que Bazel debe reintentar subir un evento de compilación.
Etiquetas:bazel_internal_configuration
--[no]experimental_announce_profile_path
valor predeterminado: "false"-
Si se habilita, agrega la ruta de acceso del perfil JSON al registro.
Etiquetas:bazel_monitoring
--[no]experimental_bep_target_summary
valor predeterminado: "false"- Determina si se publican eventos de TargetSummary.
--[no]experimental_build_event_expand_filesets
valor predeterminado: "false"-
Si es verdadero, expande los conjuntos de archivos en el BEP cuando presentes los archivos de salida.
Etiquetas:affects_outputs
--[no]experimental_build_event_fully_resolve_fileset_symlinks
valor predeterminado: "false"-
Si es verdadero, resuelve por completo los symlinks del conjunto de archivos relativos en el BEP cuando se presentan los archivos de salida. Requiere --experimental_build_event_expand_filesets.
Etiquetas:affects_outputs
- Valor predeterminado de
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
: "1 s" -
Retraso inicial y mínimo para los reintentos de retirada exponencial cuando falla la carga de BEP (exponente: 1.6)
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--experimental_build_event_upload_strategy=<a string>
: ver descripción -
Selecciona cómo subir los artefactos a los que se hace referencia en el protocolo de eventos de compilación.
Etiquetas:affects_outputs
- El valor predeterminado de
--[no]experimental_collect_load_average_in_profiler
es "true" (verdadero). - Si se habilita, el generador de perfiles recopila el promedio de carga general del sistema.
Etiquetas:bazel_monitoring
--[no]experimental_collect_pressure_stall_indicators
valor predeterminado: "false"- Si se habilita, el generador de perfiles recopila los datos de PSI de Linux.
Etiquetas:bazel_monitoring
--[no]experimental_collect_resource_estimation
valor predeterminado: "false"-
Si se habilita, el generador de perfiles recopila la estimación del uso de CPU y memoria de las acciones locales.
Etiquetas:bazel_monitoring
--[no]experimental_collect_system_network_usage
valor predeterminado: "false"- Si se habilita, el generador de perfiles recopila el uso de red del sistema.
Etiquetas:bazel_monitoring
--[no]experimental_collect_worker_data_in_profiler
valor predeterminado: "false"-
Si se habilita, el generador de perfiles recopila los datos de recursos agregados del trabajador.
Etiquetas:bazel_monitoring
- Se acumulan
--experimental_profile_additional_tasks=<phase, action, action_check, action_lock, action_release, action_update, action_complete, bzlmod, info, create_package, remote_execution, local_execution, scanner, local_parse, upload_time, remote_process_time, remote_queue, remote_setup, fetch, local_process_time, vfs_stat, vfs_dir, vfs_readlink, vfs_md5, vfs_xattr, vfs_delete, vfs_open, vfs_read, vfs_write, vfs_glob, vfs_vmfs_stat, vfs_vmfs_dir, vfs_vmfs_read, wait, thread_name, thread_sort_index, skyframe_eval, skyfunction, critical_path, critical_path_component, handle_gc_notification, action_counts, action_cache_counts, local_cpu_usage, system_cpu_usage, cpu_usage_estimation, local_memory_usage, system_memory_usage, memory_usage_estimation, system_network_up_usage, system_network_down_usage, workers_memory_usage, system_load_average, starlark_parser, starlark_user_fn, starlark_builtin_fn, starlark_user_compiled_fn, starlark_repository_fn, action_fs_staging, remote_cache_check, remote_download, remote_network, filesystem_traversal, worker_execution, worker_setup, worker_borrow, worker_working, worker_copying_outputs, credential_helper, pressure_stall_full_io, pressure_stall_full_memory, pressure_stall_some_io, pressure_stall_some_memory, pressure_stall_some_cpu, conflict_check, dynamic_lock, repository_fetch or unknown>
usos múltiples -
Especifica las tareas adicionales que se incluirán en el perfil.
Etiquetas:bazel_monitoring
--[no]experimental_profile_include_primary_output
valor 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
valor predeterminado: "false"-
Incluye la etiqueta de destino en los datos de perfil JSON de los eventos de acción.
Etiquetas:bazel_monitoring
--[no]experimental_run_bep_event_include_residue
valor predeterminado: "false"-
Determina 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 de comandos de ejecución que podrían contenerlo.
Etiquetas:affects_outputs
--[no]experimental_stream_log_file_uploads
valor predeterminado: "false"-
Transmite las cargas de archivos de registro directamente al almacenamiento remoto en lugar de escribirlos en el disco.
Etiquetas:affects_outputs
- Configuración predeterminada de
--experimental_workspace_rules_log_file=<a path>
: ver descripción - Registra ciertos eventos de reglas de Workspace en este archivo como protos WorkspaceEvent delimitados.
- Valor predeterminado de
--[no]generate_json_trace_profile
: "auto" -
Si se habilita, Bazel genera perfiles de la compilación y escribe un perfil en formato JSON en un archivo en la base de salida. Para ver el perfil, carga el archivo en chrome://tracing. De forma predeterminada, Bazel escribe el perfil para todos los comandos y las consultas similares a las de compilación.
Etiquetas:bazel_monitoring
--[no]heap_dump_on_oom
valor predeterminado: "false"-
Indica si se debe generar manualmente un volcado de montón si se arroja una OOM (incluidas las OOM manuales debido a que se alcanza --gc_thrashing_limits). El volcado se escribirá en <output_base>/<invocation_id>.heapdump.hprof. Esta opción reemplaza de forma efectiva -XX:+HeapDumpOnOutOfMemoryError, que no tiene efecto para las OOM manuales.
Etiquetas:bazel_monitoring
- El valor predeterminado de
--[no]legacy_important_outputs
es "true" (verdadero). -
Usa esta opción para suprimir la generación del campo relevant_outputs heredado en el evento TargetComplete. Para la integración de Bazel a ResultStore, se requiere relevant_outputs.
Etiquetas:affects_outputs
--logging=<0 <= an integer <= 6>
predeterminado: "3"- El nivel de registro
Etiquetas:affects_outputs
- Configuración predeterminada de
--memory_profile=<a path>
: ver descripción -
Si se establece esta opción, escribe los datos de uso de memoria en el archivo especificado al finalizar 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 perfil de memoria del montón estable al final de la compilación. Deben ser números pares y deben estar separados por comas. En cada par, el primer número entero es la cantidad de GC que se realizarán. El segundo número entero de cada par es la cantidad de segundos que se debe esperar entre las GC. P. ej.: 2,4,4,0 usaría 2 GC con una pausa de 4 segundos, seguidas de 4 GC con pausa de cero segundos.
Etiquetas:bazel_monitoring
- Configuración predeterminada de
--profile=<a path>
: ver descripción -
Si se configura, genera perfiles de Bazel y escribe datos en el archivo especificado. Usa el analizador de perfiles de Bazel para analizarlo.
Etiquetas:bazel_monitoring
--[no]record_full_profiler_data
valor predeterminado: "false"-
De forma predeterminada, el generador de perfiles de Bazel solo registrará datos agregados para eventos rápidos pero numerosos (como el registro del archivo). Si se habilita esta opción, el generador de perfiles registrará cada evento, lo que generará datos de generación de perfiles más precisos, pero un impacto de rendimiento GRANDE. 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>
: “error” -
Elige cuándo imprimir mensajes de ejecución remota. Los valores válidos son “failure”, para imprimir solo en caso de errores, “success” para imprimir solo en casos exitosos y “all” para imprimir siempre.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]slim_profile
es "true" (verdadero). -
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 de 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
--ui_event_filters=<Convert list of comma separated event kind to list of filters>
usos múltiples -
Especifica qué eventos se mostrarán en la IU. Puedes agregar o quitar eventos a los predeterminados usando el signo +/- inicial, o bien anular el valor predeterminado por completo con la asignación directa. El conjunto de tipos de eventos admitidos incluye INFO, DEBUG, ERROR y muchos más.
Etiquetas:terminal_output
- Opciones de ejecución y almacenamiento en caché remoto:
- Configuración predeterminada de
--experimental_circuit_breaker_strategy=<failure>
: ver descripción -
Especifica la estrategia que usará el disyuntor. Las estrategias disponibles son el “fracaso”. Si el valor de la opción no es válido, no se establece el comportamiento de la opción.
Etiquetas:execution
--[no]experimental_guard_against_concurrent_changes
valor predeterminado: "false"- Desactiva esta opción para inhabilitar la verificación de la hora 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 retrasa la escritura de archivos, lo que podría causar falsos positivos.
--[no]experimental_remote_cache_async
valor predeterminado: "false"- Si es verdadero, la E/S de la caché remota se producirá en segundo plano, en lugar de tener lugar como parte de una generación.
--experimental_remote_cache_compression_threshold=<an integer>
predeterminado: "0"- El tamaño mínimo de BLOB que se requiere para comprimir o descomprimir con zstd. No tiene efecto, a menos que se configure --remote_cache_compression.
--[no]experimental_remote_cache_lease_extension
valor predeterminado: "false"- Si se configura como verdadera, Bazel extenderá la asignación de tiempo para resultados de acciones remotas durante la compilación mediante el envío de llamadas a “FindMissingBlobs” de forma periódica a la caché remota. La frecuencia se basa en el valor de “--experimental_remote_cache_ttl”.
--experimental_remote_cache_ttl=<An immutable length of time.>
(valor predeterminado): "3h"-
El TTL mínimo garantizado de los BLOB en la caché remota después de que se hace referencia recientemente a sus resúmenes, p.ej., mediante ActionResult o FindMissingBlobs. Bazel realiza varias optimizaciones basadas en el TTL de los BLOB, p.ej., no llama repetidamente a GetActionResult en una compilación incremental. El valor debe establecerse un poco menos que el TTL real, ya que hay un espacio entre el momento en que el servidor muestra los resúmenes y el momento en que Bazel los recibe.
Etiquetas:execution
- Configuración predeterminada de
--experimental_remote_capture_corrupted_outputs=<a path>
: ver descripción - Una ruta de acceso a un directorio en el que se capturarán los resultados dañados.
- El valor predeterminado de
--[no]experimental_remote_discard_merkle_trees
es "true" (verdadero). - Si se configura como verdadera, descarta las copias en memoria del árbol Merkle de la raíz de entrada y las asignaciones de entradas asociadas durante las llamadas a GetActionResult() y Execute(). Esta acción reduce el uso de memoria de forma significativa, pero requiere que Bazel vuelva a calcularlas ante errores y reintentos de la caché remota.
- Configuración predeterminada de
--experimental_remote_downloader=<a string>
: ver descripción - Un URI de extremo de la API de Remote Asset, que se usará como proxy de descarga remoto. Los esquemas compatibles son grpc, grpcs (grpc con TLS habilitada) y Unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel se establecerá de forma predeterminada en grpcs. Consulta: https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto
--[no]experimental_remote_downloader_local_fallback
valor predeterminado: "false"- Indica si se debe recurrir al cargador local si falla el cargador remoto.
--[no]experimental_remote_execution_keepalive
valor predeterminado: "false"- Indica si se debe usar keepalive para llamadas de ejecución remota.
--experimental_remote_failure_rate_threshold=<an integer in 0-100 range>
predeterminado: "10"-
Establece la cantidad permitida de tasa de fallas en un porcentaje para un período específico después del cual se deja de llamar al ejecutor o la caché remotos. El valor predeterminado es 10. Establecerlo en 0 significa que no existen limitaciones.
Etiquetas:execution
- Valor predeterminado de
--experimental_remote_failure_window_interval=<An immutable length of time.>
: "60s" -
El intervalo en el que se calcula la tasa de fallas de las solicitudes remotas. En un valor negativo o cero, la duración de la falla se calcula la duración total de la ejecución.Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
Etiquetas:execution
--[no]experimental_remote_mark_tool_inputs
valor predeterminado: "false"- Si se configura como verdadera, Bazel marcará las entradas como entradas de herramientas para el ejecutor remoto. Se puede usar para implementar trabajadores persistentes remotos.
--[no]experimental_remote_merkle_tree_cache
valor predeterminado: "false"- Si se establece como verdadera, se memorizarán los cálculos del árbol de Merkle para mejorar la velocidad de comprobación de aciertos de la caché remota. La huella de pie en la memoria de la caché se controla con --experimental_remote_merkle_tree_cache_size.
--experimental_remote_merkle_tree_cache_size=<a long integer>
predeterminado: "1000"- La cantidad de árboles de Merkle que se deben memorizar para mejorar la velocidad de verificación de aciertos de la caché remota. Aunque la caché se reduce automáticamente según el manejo de las referencias de software por parte de Java, pueden producirse errores de memoria insuficiente si la configuración es 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. La configuración predeterminada es 1,000.
- Configuración predeterminada de
--experimental_remote_output_service=<a string>
: ver descripción - HOST o HOST:PORT de un extremo de servicio de salida remoto Los esquemas compatibles son grpc, grpcs (grpc con TLS habilitada) y Unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel se establecerá de forma predeterminada en grpcs. Especifica grpc:// o Unix: esquema para inhabilitar TLS.
--experimental_remote_output_service_output_path_prefix=<a string>
predeterminado: ""- La ruta de acceso en la que se coloca el contenido de los directorios de salida administrados por --experimental_remote_output_service. El directorio de salida real que use una compilación será un descendiente de esta ruta de acceso y lo determinará el servicio de salida.
--[no]experimental_remote_require_cached
valor predeterminado: "false"- Si se configura como verdadera, exige que todas las acciones que se pueden ejecutar de forma remota se almacenen en caché o, de lo contrario, falle la compilación. Esto es útil para solucionar problemas de no determinismo, ya que permite verificar si las acciones que deben almacenarse en caché realmente se almacenan en caché sin inyectar resultados nuevos en la caché de forma falsa.
- Configuración predeterminada de
--experimental_remote_scrubbing_config=<Converts to a Scrubber>
: ver descripción - Permite la depuración remota de claves de caché con el archivo de configuración proporcionado, que debe ser un búfer de protocolo en formato de texto (consulta src/main/protobuf/remote_scrubbing.proto). El objetivo de esta función es facilitar el uso compartido de una caché remota o de disco entre acciones que se ejecutan en distintas plataformas, pero que tienen como objetivo la misma plataforma. Se debe usar con mucho cuidado, ya que una configuración incorrecta puede provocar que se compartan accidentalmente las entradas de caché y dar lugar a compilaciones incorrectas. El arrastre no afecta la forma en que se ejecuta una acción, solo la forma en que se calcula la clave de caché remota/disco con el fin de recuperar o almacenar el resultado de una acción. Las acciones de arrastre no son compatibles con la ejecución remota y, por lo tanto, siempre se ejecutarán de forma local. Modificar la configuración de depuración no invalida los resultados presentes en el sistema de archivos local o en las memorias caché internas; se requiere una compilación limpia para volver a ejecutar las acciones afectadas. Para usar correctamente esta función, probablemente te convenga configurar una plataforma personalizada --host_platform junto con --experimental_platform_in_output_dir (para normalizar los prefijos de salida) y la --incompatible_strict_action_env (para normalizar las variables de entorno).
--[no]incompatible_remote_build_event_upload_respect_no_cache
valor predeterminado: "false"- Obsoleto. No-op. En su lugar, usa --remote_build_event_upload=minimal.
- El valor predeterminado de
--[no]incompatible_remote_downloader_send_all_headers
es "true" (verdadero). -
Indica si se deben enviar todos los valores de un encabezado con varios valores al cargador remoto en lugar de solo el primero.
Etiquetas:incompatible_change
--[no]incompatible_remote_output_paths_relative_to_input_root
valor predeterminado: "false"-
Si se configura como verdadera, las rutas de salida están relacionadas con la raíz de entrada en lugar del directorio de trabajo.
Etiquetas:incompatible_change
- El valor predeterminado de
--[no]incompatible_remote_results_ignore_disk
es "true" (verdadero). -
No-ops
Etiquetas:incompatible_change
- El valor predeterminado de
--[no]remote_accept_cached
es "true" (verdadero). - Indica si se aceptan resultados de acciones almacenados en caché de forma remota.
- Valor predeterminado de
--remote_build_event_upload=<all or minimal>
: "mínimo" - Si se configura como “all”, todas las salidas locales a las que hace referencia BEP se suben a la caché remota. Si se configura como “mínimo”, las salidas locales a las que hace referencia BEP no se suben a la caché remota, excepto los archivos que son importantes para los consumidores de BEP (p.ej., registros de prueba y perfil de sincronización). El esquema bytestream:// siempre se usa para el URI de los archivos, incluso si faltan de la caché remota. La configuración predeterminada es “mínima”.
- Configuración predeterminada de
--remote_bytestream_uri_prefix=<a string>
: ver descripción - El nombre de host y el nombre de la instancia que se usarán en los URI bytestream:// que se escriben en transmisiones de eventos de compilación. Esta opción se puede configurar cuando las compilaciones se realizan con un proxy, lo que hace que los valores de --remote_executor y --remote_instance_name ya no correspondan con el nombre canónico del servicio de ejecución remota. Si no se establece, el valor predeterminado será “${hostname}/${instance_name}”.
- Configuración predeterminada de
--remote_cache=<a string>
: ver descripción - Un URI de un extremo de almacenamiento en caché. Los esquemas admitidos son http, https, grpc, grpcs (grpc con TLS habilitada) y Unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel se establecerá de forma predeterminada en grpcs. Especifica el esquema grpc://, http:// o Unix: para inhabilitar TLS. Consulta https://bazel.build/remote/caching
--[no]remote_cache_compression
valor predeterminado: "false"- Si se habilita, comprime o descomprime los BLOB de caché con zstd cuando su tamaño sea al menos --experimental_remote_cache_compression_threshold.
- Se acumulan
--remote_cache_header=<a 'name=value' assignment>
usos múltiples - Especifica un encabezado que se incluirá en las solicitudes de caché: --remote_cache_header=Name=Value. Se pueden pasar varios encabezados si se especifica la marca varias veces. Si hay varios valores con el mismo nombre, se convertirán en una lista separada por comas.
- Se acumulan
--remote_default_exec_properties=<a 'name=value' assignment>
usos múltiples -
Configura las propiedades de ejecución predeterminadas que se usarán como plataforma de ejecución remota si una plataforma de ejecución aún no configuró exec_properties.
Etiquetas:affects_outputs
--remote_default_platform_properties=<a string>
predeterminado: ""- Establece las propiedades de plataforma predeterminadas para la API de ejecución remota si la plataforma de ejecución aún no configuró remote_execution_properties. Este valor también se usará si se selecciona la plataforma host como la plataforma de ejecución para la ejecución remota.
- Se acumulan
--remote_download_regex=<a valid Java regular expression>
usos múltiples -
Fuerza la descarga de las salidas de compilación remotas cuya ruta de acceso coincide con este patrón, independientemente de --remote_download_outputs. Se pueden especificar varios patrones mediante la repetición de esta marca.
Etiquetas:affects_outputs
- Se acumulan
--remote_downloader_header=<a 'name=value' assignment>
usos múltiples - Especifica un encabezado que se incluirá en las solicitudes de cargadores remotos: --remote_downloader_header=Name=Value. Se pueden pasar varios encabezados si se especifica la marca varias veces. Si hay varios valores con el mismo nombre, se convertirán en una lista separada por comas.
- Se acumulan
--remote_exec_header=<a 'name=value' assignment>
usos múltiples - Especifica un encabezado que se incluirá en las solicitudes de ejecución: --remote_exec_header=Name=Value. Se pueden pasar varios encabezados si se especifica la marca varias veces. Si hay varios valores con el mismo nombre, se convertirán en una lista separada por comas.
--remote_execution_priority=<an integer>
predeterminado: "0"- La prioridad relativa de las acciones que se ejecutarán de forma remota. La semántica de los valores de prioridad particulares depende del servidor.
- Configuración predeterminada de
--remote_executor=<a string>
: ver descripción - HOST o HOST:PORT de un extremo de ejecución remota. Los esquemas compatibles son grpc, grpcs (grpc con TLS habilitada) y Unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel se establecerá de forma predeterminada en grpcs. Especifica grpc:// o Unix: esquema para inhabilitar TLS.
- Configuración predeterminada de
--remote_grpc_log=<a path>
: ver descripción - Si se especifica, es una ruta a un archivo para registrar los detalles relacionados con las llamadas de gRPC. Este registro consta de una secuencia de protobufs serializados com.google.Dev
- Se acumulan
--remote_header=<a 'name=value' assignment>
usos múltiples - Especifica un encabezado que se incluirá en las solicitudes: --remote_header=Name=Value. Se pueden pasar varios encabezados si se especifica la marca varias veces. Si hay varios valores con el mismo nombre, se convertirán en una lista separada por comas.
--remote_instance_name=<a string>
predeterminado: ""- Valor que se pasará como instance_name en la API de ejecución remota.
--[no]remote_local_fallback
valor predeterminado: "false"- Determina si se debe recurrir a la estrategia de ejecución local independiente si falla la ejecución remota.
- El valor predeterminado de
--remote_local_fallback_strategy=<a string>
es "local" - No-ops, obsoleto. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/7480.
--remote_max_connections=<an integer>
predeterminado: "100"-
Limita la cantidad máxima de conexiones simultáneas a la caché o al ejecutor remoto. De forma predeterminada, el valor es 100. Establecerlo en 0 significa que no existen limitaciones.
Para la caché remota HTTP, una conexión TCP podría manejar una solicitud a la vez, por lo que Bazel podría compensar hasta --remote_max_connections solicitudes simultáneas.
Para la caché o el ejecutor remoto de gRPC, por lo general, un canal de gRPC podría manejar más de 100 solicitudes simultáneas, por lo que Bazel podría hacer alrededor de `--remote_max_connections * 100` solicitudes simultáneas.
Etiquetas:host_machine_resource_optimizations
- Configuración predeterminada de
--remote_proxy=<a string>
: ver descripción - Conéctate a la caché remota a través de un proxy. Actualmente, esta marca solo se puede usar para configurar un socket de dominio Unix (unix:/path/to/socket).
--remote_result_cache_priority=<an integer>
predeterminado: "0"- La prioridad relativa de las acciones remotas que se almacenarán en la caché remota. La semántica de los valores de prioridad particulares depende del servidor.
--remote_retries=<an integer>
predeterminado: "5"- La cantidad máxima de intentos para reintentar un error transitorio. Si se establece en 0, se inhabilitan los reintentos.
- Valor predeterminado de
--remote_retry_max_delay=<An immutable length of time.>
: "5 s" - Es el retraso máximo de retirada entre intentos 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.
- Valor predeterminado de
--remote_timeout=<An immutable length of time.>
: "60s" - La cantidad máxima de tiempo que se debe esperar para la ejecución remota y las llamadas a caché. Para la caché de REST, este es el tiempo de espera de conexión y 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.
- El valor predeterminado de
--[no]remote_upload_local_results
es "true" (verdadero). - Indica si se deben subir los resultados de acciones ejecutadas de forma local a la caché remota si la caché remota lo admite y el usuario está autorizado para hacerlo.
- El valor predeterminado de
--[no]remote_verify_downloads
es "true" (verdadero). - Si se configura como verdadera, Bazel calculará la suma de hash de todas las descargas remotas y descartará los valores almacenados en caché de manera remota si no coinciden con el valor esperado.
- Opciones varias, que no están categorizadas:
- Se acumulan
--build_metadata=<a 'name=value' assignment>
usos múltiples -
Pares de cadenas clave-valor personalizados para proporcionar en un evento de compilación
Etiquetas:terminal_output
- Valor predeterminado de
--color=<yes, no or auto>
: "auto" - Usa los controles de la terminal para colorear el resultado.
- Se acumulan
--config=<a string>
usos múltiples - Selecciona secciones de configuración adicionales de los archivos rc; para cada <command>, también extrae las opciones de <command>:<config> si 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 son equivalentes se encuentran en los archivos de configuración de tools/*.blazerc.
- Se acumulan
--credential_helper=<Path to a credential helper. It may be absolute, relative to the PATH environment variable, or %workspace%-relative. The path be optionally prefixed by a scope followed by an '='. The scope is a domain name, optionally with a single leading '*' wildcard component. A helper applies to URIs matching its scope, with more specific scopes preferred. If a helper has no scope, it applies to every URI.>
usos múltiples - Configura un auxiliar de credenciales de acuerdo con la <a href="https://github.com/EngFlow/credential-helper-spec">especificación del asistente de credenciales</a> a fin de recuperar las credenciales de autorización para la recuperación del repositorio, el almacenamiento en caché y la ejecución remotos, 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 auth para `repository_="{.download()` y `repository_="{.download_and_extract()`. Se pueden especificar varias veces para configurar varios asistentes. Para obtener instrucciones, consulta https://blog.engflow.com/2023/10/09/configure-bazels-credential-helper/.
--credential_helper_cache_duration=<An immutable length of time.>
predeterminado: "30m"- Es el tiempo predeterminado durante el cual las credenciales que proporciona un auxiliar de credenciales se almacenan en caché si este no lo hace cuando vencen.
- Valor predeterminado de
--credential_helper_timeout=<An immutable length of time.>
: "10 s" - Configura el tiempo de espera para un auxiliar de credenciales. Los auxiliares de credenciales que no respondan dentro de este tiempo de espera fallarán la invocación.
- Valor predeterminado de
--curses=<yes, no or auto>
: "auto" - Usa los controles del cursor de la terminal para minimizar el resultado del desplazamiento.
- Configuración predeterminada de
--disk_cache=<a path>
: ver descripción - Una ruta de acceso a un directorio en el que Bazel puede leer y escribir acciones y resultados de acciones. Si el directorio no existe, se creará.
--[no]enable_platform_specific_config
valor predeterminado: "false"- Si es verdadero, Bazel recoge líneas de configuración específicas del SO del host de los archivos de bazelrc. Por ejemplo, si el SO del host es Linux y ejecutas la compilación de Bazel, Bazel detecta las líneas que comienzan con build:linux. Los identificadores de SO compatibles son linux, macos, windows, freebsd y openbsd. Habilitar esta marca equivale a usar --config=linux en Linux, --config=windows en Windows, etcétera.
--[no]experimental_rule_extension_api
valor predeterminado: "false"-
Habilitar la API de extensión experimental de reglas y las APIs de subregla
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_windows_watchfs
valor predeterminado: "false"- Si es verdadero, se habilitará la compatibilidad experimental de Windows con --watchfs. De lo contrario, --watchfsis no funciona en Windows. Asegúrate de habilitar también --watchfs.
- El valor predeterminado de
--google_auth_scopes=<comma-separated list of options>
es "https://www.googleapis.com/auth/cloud-platform" - Una lista separada por comas de los permisos de autenticación de Google Cloud.
- Configuración predeterminada de
--google_credentials=<a string>
: ver descripción - Especifica el archivo del que se obtendrán credenciales de autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más detalles.
--[no]google_default_credentials
valor predeterminado: "false"- Indica si se deben usar las “Credenciales predeterminadas de la aplicación de Google” para la autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más detalles. Están inhabilitados de forma predeterminada.
- Configuración predeterminada de
--grpc_keepalive_time=<An immutable length of time.>
: ver descripción - Configura pings de keep-alive para las conexiones de gRPC salientes. Si se establece, Bazel envía pings después de este período sin operaciones de lectura en la conexión, pero solo si hay al menos una llamada de gRPC pendiente. Los horarios se consideran de segundo nivel de detalle; es un error establecer un valor inferior a un segundo. De forma predeterminada, los pings de keep-alive 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 para esta marca, debe hacerse de esta manera: --grpc_keepalive_time=30s.
- Valor predeterminado de
--grpc_keepalive_timeout=<An immutable length of time.>
: "20 s" - Configura un tiempo de espera de keep-alive para las conexiones de gRPC salientes. Si los pings keep-alive están habilitados con --grpc_keepalive_time, Bazel agota el tiempo de espera de una conexión si no recibe una respuesta de ping después de este tiempo. Los horarios se consideran de segundo nivel de detalle; es un error establecer un valor inferior a un segundo. Si los pings de keep-alive están inhabilitados, se ignora esta configuración.
--[no]incompatible_disable_non_executable_java_binary
valor predeterminado: "false"-
Si es verdadero, java_binary es siempre ejecutable y se quita el atributo create_executable.
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_disallow_symlink_file_to_dir
es "true" (verdadero). -
No-ops
Etiquetas:loading_and_analysis
,incompatible_change
--[no]progress_in_terminal_title
valor predeterminado: "false"- Muestra el progreso del comando en el título de la terminal. Es útil para ver qué hace Bazel cuando hay varias pestañas de terminal.
- El valor predeterminado de
--[no]show_progress
es "true" (verdadero). - 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 del resultado.
--[no]show_timestamps
valor predeterminado: "false"- Incluir marcas de tiempo en los mensajes
- Configuración predeterminada de
--tls_certificate=<a string>
: ver descripción - Especifica una ruta de acceso a un certificado TLS que sea confiable para firmar certificados de servidor.
- Configuración predeterminada de
--tls_client_certificate=<a string>
: ver 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.
- Configuración predeterminada de
--tls_client_key=<a string>
: ver 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 separada. La barra de progreso siempre muestra al menos uno, y todos los números menores que 1 se asignan a 1.
Etiquetas:terminal_output
--[no]watchfs
valor predeterminado: "false"- En Linux o macOS: Si es verdadero, Bazel intenta usar el servicio de supervisión de archivos del sistema operativo para realizar cambios locales en lugar de analizar todos los archivos en busca de un cambio. En Windows: esta marca actualmente no es operativa, pero se puede habilitar junto con --experimental_windows_watchfs. En cualquier SO: El comportamiento no está definido si tu lugar de trabajo está en un sistema de archivos de red y los archivos se editan en una máquina remota.
Opciones del perfil de análisis
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Más lugares donde buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
valor predeterminado: "false"-
Si se configura, la caché del repositorio vinculará el archivo de forma fija en caso de un acierto de caché, en lugar de copiar. Esto sirve para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Usa este factor para escalar todos los tiempos de espera en las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que sean 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 para descargas de http.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--http_connector_retry_max_timeout=<An immutable length of time.>
: "0 s" -
Es el tiempo de espera máximo para los reintentos de descarga de HTTP. Con el valor 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 descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación en caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché; de lo contrario, se usa el valor predeterminado “<output_user_root>/cache/repos/v1”
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
valor predeterminado: "false"-
Si se establece esta configuración, no se permitirá la descarga con ="{.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no está completamente deshabilitado; ="{.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"-
Indica el porcentaje de espacio ocupado (0-100) por encima del cual GcThrashingDetector considera los eventos de presión de la memoria en función de sus límites (--gc_thrashing_limits). Si se configura en 100, GcThrashingDetector se inhabilita.
Etiquetas:host_machine_resource_optimizations
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE.:
- El valor predeterminado de
--[no]incompatible_depset_for_java_output_source_jars
es "true" (verdadero). -
No-ops
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_new_actions_api
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,incompatible_change
- El valor predeterminado de
--[no]incompatible_visibility_private_attributes_at_definition
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,incompatible_change
- El valor predeterminado de
--[no]separate_aspect_deps
es "true" (verdadero). -
No-op
Etiquetas:no_op
- Opciones relacionadas con la semántica y el resultado de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Especificaste las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirá en el gráfico de dependencias resueltas incluso si se declararon de forma privada en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones anteriores harán que la resolución falle. También puedes definir la versión transferida 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
- El valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
es "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 una falla de resolución, “off” para inhabilitar la verificación o “warning” para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas `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 detecte una discrepancia o “error” para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
valor predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
valor predeterminado: "actualizar"-
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son “update” para usar el archivo de bloqueo y actualizarlo si hay cambios; “error” para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o “off” para no leerlo ni escribirlo en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y se recurrirá únicamente a los posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Configuración predeterminada de
--vendor_dir=<a path>
: ver descripción -
Especifica el directorio que debe contener los repositorios externos en modo de proveedor, ya sea con el fin de recuperarlos o usarlos durante la compilación. La ruta de acceso se puede especificar como una ruta de acceso absoluta o una ruta relativa al directorio del lugar de trabajo.
Etiquetas:loading_and_analysis
- 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 fallar Bazel con un OOM. Cada límite se especifica como <period>:<count>, donde el período es una duración y el recuento es un número entero positivo. Si más del --gc_thrashing_threshold por ciento del espacio titular (montón de generación anterior) permanece ocupado después de <count> GC completas consecutivas dentro de <period>, se activa una 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"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje de montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC completo, descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos de GC completos nunca activarán disminuciones. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de recolección de elementos no utilizados completo y se supere el umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje de montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC menor, descartará el estado temporal innecesario de Skyframe, hasta esta cantidad por invocación. El valor predeterminado es Integer.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos menores de GC nunca activarán disminuciones. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento menor de recolección de elementos no utilizados y se supere el umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje retenido de montón está al menos en este umbral, descartará el estado temporal innecesario de Skyframe. Un ajuste puede permitirte mitigar el impacto de la hiperpaginación de la GC en el tiempo, cuando esta (i) causa el uso de memoria de este estado temporal y (ii) es más costosa que reconstruir el estado cuando es necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--dump=<text or raw>
[-d
] (valor predeterminado): ver descripción- genera el volcado de datos del perfil completo en formato de “texto” legible o en formato “sin procesar” compatible con secuencias de comandos.
Etiquetas:bazel_monitoring
- Configuración predeterminada de
--experimental_command_profile=<cpu, wall, alloc or lock>
: ver descripción - Registra un perfil de grabadora de vuelo de Java mientras dure el comando. Se debe proporcionar uno de los tipos de eventos de generación de perfiles admitidos (cpu, muro, alloc o bloqueo) como argumento. El perfil se escribe en un archivo con el nombre del tipo de evento en el directorio base de salida. La sintaxis y semántica de esta marca podría cambiar en el futuro para admitir tipos de perfil o formatos de salida adicionales; úsala bajo tu responsabilidad.
--[no]experimental_record_metrics_for_all_mnemonics
valor predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán estadísticas para todos los mnemotécnicos.
- 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é remoto:
- Configuración predeterminada de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo para configurar el cargador 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 con el que debe coincidir y otro para usar como URL sustitutiva, con referencias inversas que comienzan con "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL, y se mostrarán varias URL.
- Valor predeterminado de
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "auto" - Es el modo de subprocesos que se usará para la recuperación del repositorio. Si se configura en “off”, no se usa ningún subproceso de trabajo y la recuperación del repositorio está sujeta a reinicios. De lo contrario, utiliza un subproceso de plataforma (es decir, subproceso del SO) si se configura como “platform” o un subproceso virtual si se establece como “virtual”. Si se configura como "auto", se usan subprocesos virtuales si están disponibles (es decir, se ejecutan en JDK 21 y versiones posteriores); de lo contrario, no se usan subprocesos de trabajo.
- Opciones varias, que no están categorizadas:
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada 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
--distdir=<a path>
usos múltiples -
Más lugares donde buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
valor predeterminado: "false"-
Si se configura, la caché del repositorio vinculará el archivo de forma fija en caso de un acierto de caché, en lugar de copiar. Esto sirve para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Usa este factor para escalar todos los tiempos de espera en las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que sean 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 para descargas de http.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--http_connector_retry_max_timeout=<An immutable length of time.>
: "0 s" -
Es el tiempo de espera máximo para los reintentos de descarga de HTTP. Con el valor 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 descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación en caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché; de lo contrario, se usa el valor predeterminado “<output_user_root>/cache/repos/v1”
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
valor predeterminado: "false"-
Si se establece esta configuración, no se permitirá la descarga con ="{.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no está completamente deshabilitado; ="{.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"-
Indica el porcentaje de espacio ocupado (0-100) por encima del cual GcThrashingDetector considera los eventos de presión de la memoria en función de sus límites (--gc_thrashing_limits). Si se configura en 100, GcThrashingDetector se inhabilita.
Etiquetas:host_machine_resource_optimizations
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE.:
- El valor predeterminado de
--[no]incompatible_depset_for_java_output_source_jars
es "true" (verdadero). -
No-ops
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_new_actions_api
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,incompatible_change
- El valor predeterminado de
--[no]incompatible_visibility_private_attributes_at_definition
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,incompatible_change
- El valor predeterminado de
--[no]separate_aspect_deps
es "true" (verdadero). -
No-op
Etiquetas:no_op
- Opciones relacionadas con el resultado y la semántica de la consulta:
- El valor predeterminado de
--aspect_deps=<off, conservative or precise>
es "conservador". -
Cómo resolver dependencias de aspecto cuando el formato de salida es {xml,proto,record}. “desactivado” significa que no se resuelven las dependencias de aspecto, “conservadora” (el valor predeterminado) significa que se agregan todas las dependencias de aspecto declaradas sin importar si se les otorga la clase de regla de las dependencias directas. “preciso” significa que solo se agregan esos aspectos que posiblemente estén activos dada la clase de regla de las dependencias directas. Ten en cuenta que el modo preciso requiere cargar otros paquetes para evaluar un solo objetivo, por lo que es más lento que los otros modos. Además, ten en cuenta que incluso el modo preciso no es del todo preciso: la decisión de calcular un aspecto se decide en la fase de análisis, que no se ejecuta durante la “consulta de Bazel”.
Etiquetas:build_file_semantics
--[no]consistent_labels
valor predeterminado: "false"-
Si se habilita, cada comando de consulta emite etiquetas como si lo hiciera la función <code>str</code> de Starlark aplicada a una instancia de <code>etiqueta</code>. Esto es útil para las herramientas que necesitan hacer coincidir el resultado de diferentes comandos de consulta o etiquetas emitidas por reglas. Si no están habilitados, los formateadores de salida tienen la libertad de emitir nombres de repositorio aparentes (en relación con el repositorio principal) para que los resultados sean más legibles.
Etiquetas:terminal_output
--[no]experimental_explicit_aspects
valor predeterminado: "false"-
aquery, cquery: si se deben incluir acciones generadas por el aspecto en el resultado. query: no-op (siempre se siguen los aspectos).
Etiquetas:terminal_output
- El valor predeterminado de
--[no]graph:factored
es "true" (verdadero). -
Si es "true", el gráfico se emitirá "factorizado", es decir, los nodos equivalentes topológicamente se combinarán y sus etiquetas se concatenarán. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--graph:node_limit=<an integer>
predeterminado: "512"-
La longitud máxima de la string de etiqueta para un nodo del gráfico en el resultado. Las etiquetas más largas se truncarán; -1 significa que no hay truncamiento. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]implicit_deps
es "true" (verdadero). -
Si se habilita, las dependencias implícitas se incluirán en el gráfico de dependencias en el que opera la consulta. Una dependencia implícita es aquella que no se especifica de forma explícita en el archivo BUILD, sino que Bazel la agrega. En el caso de cquery, esta opción controla el filtrado de cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
- El valor predeterminado de
--[no]include_artifacts
es "true" (verdadero). -
Incluye los nombres de las entradas y salidas de acción en la salida (posiblemente grande).
Etiquetas:terminal_output
- El valor predeterminado de
--[no]include_aspects
es "true" (verdadero). -
aquery, cquery: si se deben incluir acciones generadas por el aspecto en el resultado. query: no-op (siempre se siguen los aspectos).
Etiquetas:terminal_output
- El valor predeterminado de
--[no]include_commandline
es "true" (verdadero). -
Incluye el contenido de las líneas de comandos de acción en el resultado (posiblemente grande).
Etiquetas:terminal_output
--[no]include_file_write_contents
valor predeterminado: "false"-
Incluye el contenido del archivo para las acciones FileWrite, SourceSymlinkManifest y RepoMappingManifest (posiblemente grandes).
Etiquetas:terminal_output
--[no]include_param_files
valor predeterminado: "false"-
Incluye el contenido de los archivos de parámetros que se usaron en el comando (posiblemente grandes). Nota: Habilitar esta marca habilitará automáticamente la marca --include_commandline.
Etiquetas:terminal_output
--[no]include_scheduling_dependencies
valor predeterminado: "false"-
Incluye los nombres de las dependencias de programación de acciones (posiblemente grandes). Solo tendrá efecto si también se configura --include_artifacts.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]incompatible_package_group_includes_double_slash
es "true" (verdadero). -
Si se habilita, cuando se genere el atributo `packages` de package_group, no se omitirá el signo `//` inicial.
Etiquetas:terminal_output
,incompatible_change
--[no]infer_universe_scope
valor predeterminado: "false"-
Si se configura y --universe_scope no se establece, se inferirá un valor de --universe_scope como la lista de patrones de objetivo únicos en la expresión de consulta. Ten en cuenta que el valor de --universe_scope que se infiere para una expresión de consulta que utiliza funciones con alcance universal (p.ej., `allrdeps`) puede no ser lo que quieres, por lo que solo debes usar esta opción si sabes lo que estás haciendo. Consulta https://bazel.build/reference/query#sky-query para obtener detalles y ejemplos. Si se configura --universe_scope, se ignora el valor de esta opción. Nota: Esta opción solo se aplica a “consulta” (es decir, no a “cquery”).
Etiquetas:loading_and_analysis
--[no]line_terminator_null
valor predeterminado: "false"-
Indica si cada formato termina con \0 en lugar de una línea nueva.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]nodep_deps
es "true" (verdadero). -
Si se habilita, las dependencias de los atributos “nodep” se incluirán en el gráfico de dependencias en el que opera la consulta. Un ejemplo común de un atributo “nodep” es la “visibilidad”. Ejecuta y analiza el resultado de `info build-language` para conocer todos los atributos “nodep” en el lenguaje de compilación.
Etiquetas:build_file_semantics
--output=<a string>
predeterminado: "text"-
Formato en el que se deben imprimir los resultados de una consulta. Los valores permitidos para una consulta son los siguientes: text, textproto, proto, broadcast_proto, jsonproto.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]proto:default_values
es "true" (verdadero). -
Si el valor es "true", 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
valor predeterminado: "false"-
Propaga el campo proto define_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
- El valor predeterminado de
--[no]proto:flatten_selects
es "true" (verdadero). -
Si se habilita, se compactan los atributos configurables creados por select(). Para los tipos de lista, la representación plana es una lista que contiene cada valor del mapa de selección exactamente una vez. Los tipos escalares se acoplan a nulos.
Etiquetas:build_file_semantics
--[no]proto:include_attribute_source_aspects
valor predeterminado: "false"-
Propaga el campo proto source_aspect_name de cada Atributo con el aspecto de origen del que provino (si no lo hizo, una cadena vacía).
Etiquetas:terminal_output
--[no]proto:include_synthetic_attribute_hash
valor predeterminado: "false"-
Indica si se debe calcular y propagar el atributo $internal_attr_hash o no.
Etiquetas:terminal_output
--[no]proto:instantiation_stack
valor 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
- El valor predeterminado de
--[no]proto:locations
es "true" (verdadero). - Indica si se debe generar información de ubicación en el resultado de proto.
Etiquetas:terminal_output
- La configuración predeterminada de
--proto:output_rule_attrs=<comma-separated list of options>
es "todos" -
Lista de atributos separados por comas para incluir en el resultado. La configuración predeterminada es todos los atributos. Se establece como una cadena vacía para no generar ningún atributo. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]proto:rule_inputs_and_outputs
es "true" (verdadero). -
Indica si se deben propagar los campos rule_input y rule_output o no.
Etiquetas:terminal_output
--query_file=<a string>
predeterminado: ""-
Si se configura, la consulta leerá la consulta desde el archivo que se menciona aquí, en lugar de hacerlo desde la línea de comandos. Es un error especificar un archivo aquí, así como una consulta de línea de comandos.
Etiquetas:changes_inputs
--[no]relative_locations
valor predeterminado: "false"-
Si es "true", la ubicación de los archivos BUILD en los resultados xml y proto será relativa. De forma predeterminada, el resultado de la ubicación es una ruta de acceso absoluta y no será coherente en todas las máquinas. Puedes configurar esta opción como verdadera para obtener un resultado coherente en todas las máquinas.
Etiquetas:terminal_output
--[no]skyframe_state
valor predeterminado: "false"-
Sin realizar un análisis adicional, vuelca el Action Graph actual de Skyframe. Nota: Actualmente, no se admite especificar un destino con --skyframe_state. Esta marca solo está disponible con --output=proto o --output=textproto.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]tool_deps
es "true" (verdadero). -
Consulta: Si se inhabilita, las dependencias de la "configuración de ejecución" no se incluirán en el gráfico de dependencias en el que opera la consulta. Un perímetro de dependencia de 'ejecución de configuración', como el de cualquier regla 'proto_library' al compilador de protocolos, generalmente apunta a una herramienta ejecutada durante la compilación en lugar de a una parte del mismo programa 'target'.
Cquery: Si se inhabilita, filtra todos los destinos configurados que cruzan una transición de ejecución del objetivo de nivel superior que descubrió este objetivo configurado. Esto significa que si el objetivo de nivel superior está en la configuración de destino, solo se mostrarán los objetivos configurados también en esa configuración. Si el objetivo de nivel superior está en la configuración de ejecución, solo se mostrarán los objetivos configurados de ejecución. Esta opción NO excluirá las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
--universe_scope=<comma-separated list of options>
predeterminado: ""-
Un conjunto de patrones de objetivo separados por comas (aditivos y sustractivos). 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.
Para cquery, la entrada a esta opción son los destinos en los que se compilan todas las respuestas, por lo que esta opción puede afectar las configuraciones y las transiciones. Si no se especifica esta opción, se supone que los destinos de nivel superior son los destinos analizados a partir de la expresión de consulta. Nota: En el caso de cquery, no especificar esta opción puede provocar que la compilación falle si los objetivos analizados a partir de la expresión de consulta no se pueden compilar con opciones de nivel superior.
Etiquetas:loading_and_analysis
- Opciones relacionadas con la semántica y el resultado de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Especificaste las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirá en el gráfico de dependencias resueltas incluso si se declararon de forma privada en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones anteriores harán que la resolución falle. También puedes definir la versión transferida 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
- El valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
es "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 una falla de resolución, “off” para inhabilitar la verificación o “warning” para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas `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 detecte una discrepancia o “error” para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
valor predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
valor predeterminado: "actualizar"-
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son “update” para usar el archivo de bloqueo y actualizarlo si hay cambios; “error” para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o “off” para no leerlo ni escribirlo en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y se recurrirá únicamente a los posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Configuración predeterminada de
--vendor_dir=<a path>
: ver descripción -
Especifica el directorio que debe contener los repositorios externos en modo de proveedor, ya sea con el fin de recuperarlos o usarlos durante la compilación. La ruta de acceso se puede especificar como una ruta de acceso absoluta o una ruta relativa al directorio del lugar de trabajo.
Etiquetas:loading_and_analysis
- 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 fallar Bazel con un OOM. Cada límite se especifica como <period>:<count>, donde el período es una duración y el recuento es un número entero positivo. Si más del --gc_thrashing_threshold por ciento del espacio titular (montón de generación anterior) permanece ocupado después de <count> GC completas consecutivas dentro de <period>, se activa una 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"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje de montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC completo, descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos de GC completos nunca activarán disminuciones. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de recolección de elementos no utilizados completo y se supere el umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje de montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC menor, descartará el estado temporal innecesario de Skyframe, hasta esta cantidad por invocación. El valor predeterminado es Integer.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos menores de GC nunca activarán disminuciones. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento menor de recolección de elementos no utilizados y se supere el umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje retenido de montón está al menos en este umbral, descartará el estado temporal innecesario de Skyframe. Un ajuste puede permitirte mitigar el impacto de la hiperpaginación de la GC en el tiempo, cuando esta (i) causa el uso de memoria de este estado temporal y (ii) es más costosa que reconstruir el estado cuando es necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Configuración predeterminada de
--experimental_command_profile=<cpu, wall, alloc or lock>
: ver descripción - Registra un perfil de grabadora de vuelo de Java mientras dure el comando. Se debe proporcionar uno de los tipos de eventos de generación de perfiles admitidos (cpu, muro, alloc o bloqueo) como argumento. El perfil se escribe en un archivo con el nombre del tipo de evento en el directorio base de salida. La sintaxis y semántica de esta marca podría cambiar en el futuro para admitir tipos de perfil o formatos de salida adicionales; úsala bajo tu responsabilidad.
--[no]experimental_record_metrics_for_all_mnemonics
valor predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán estadísticas para todos los mnemotécnicos.
- 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é remoto:
- Configuración predeterminada de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo para configurar el cargador 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 con el que debe coincidir y otro para usar como URL sustitutiva, con referencias inversas que comienzan con "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL, y se mostrarán varias URL.
- Valor predeterminado de
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "auto" - Es el modo de subprocesos que se usará para la recuperación del repositorio. Si se configura en “off”, no se usa ningún subproceso de trabajo y la recuperación del repositorio está sujeta a reinicios. De lo contrario, utiliza un subproceso de plataforma (es decir, subproceso del SO) si se configura como “platform” o un subproceso virtual si se establece como “virtual”. Si se configura como "auto", se usan subprocesos virtuales si están disponibles (es decir, se ejecutan en JDK 21 y versiones posteriores); de lo contrario, no se usan subprocesos de trabajo.
- Opciones varias, que no están categorizadas:
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa 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"
- Opciones que controlan la ejecución de la compilación:
--[no]experimental_inprocess_symlink_creation
valor predeterminado: "false"-
Indica 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
valor predeterminado: "false"-
Habilita el extractor de aar persistente con trabajadores.
Etiquetas:execution
--[no]experimental_remotable_source_manifests
valor predeterminado: "false"-
Indica si se pueden hacer que las acciones del manifiesto de origen sean remotas
Etiquetas:loading_and_analysis
,execution
,experimental
--[no]experimental_split_coverage_postprocessing
valor predeterminado: "false"-
Si es verdadero, Bazel ejecutará el procesamiento posterior de la cobertura para probarlo en un nuevo generador.
Etiquetas:execution
--[no]experimental_strict_fileset_output
valor predeterminado: "false"-
Si habilitas esta opción, los conjuntos de archivos tratarán todos los artefactos de salida como archivos normales. No desviarán directorios ni serán sensibles a los symlinks.
Etiquetas:execution
--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 el valor mnemotécnico de la acción. Solo se aplica a las acciones que admiten información de ejecución. Muchas acciones comunes admiten información de ejecución, p.ej., Genrule, CppCompile, Javac, StarlarkAction y TestRunner. Cuando se especifican varios valores, el orden es importante porque muchas regex pueden aplicarse al mismo valor mnemotécnico.
Sintaxis: "regex=[+-]key,regex=[+-]key,...".
Ejemplos:
“.*=+x,.*=-y,.*=+z” agrega “x” y “z” a la información de ejecución de todas las acciones y quita “y”.
“Genrule=+requires-x” agrega “require-x” a la información de ejecución para todas las acciones de Genrule.
“(?!Genrule).*=-requires-x” quita “require-x” de la información de ejecución para todas las acciones que no son de Genrule.
Etiquetas:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Habilita las acciones persistentes de dex y desugar de Android con trabajadores.
Se expande a:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
-
Habilita el procesador de recursos persistentes de Android usando 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
}}{/13/}
--strategy=Aapt2Optimize=worker
--strategy=Aapt2Optimize=worker
--strategy=Aapt2Optimize=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
--strategy=ProcessDatabinding=worker
--strategy=GenerateDataBindingBaseClasses=worker
host_machine_resource_optimizations
execution
--persistent_multiplex_android_dex_desugar
-
Habilita las acciones de dex y desugar multiplexadas 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 multiplexados persistentes de Android usando 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=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
host_machine_resource_optimizations
execution
--persistent_multiplex_android_tools
-
Habilita herramientas persistentes y multiplexadas de Android (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
valor predeterminado: "false"-
Si es "true", Bazel usará la plataforma de destino para ejecutar pruebas en lugar del grupo de ejecuciones de prueba.
Etiquetas:execution
- Opciones que configuran la cadena de herramientas usada para ejecutar la acción:
- Configuración predeterminada de
--android_compiler=<a string>
: ver 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
yloses_incremental_state
- Configuración predeterminada de
--android_grte_top=<a label>
: ver descripción -
El objetivo de Android es grte_top.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
predeterminado: "android"-
Selecciona la combinación de manifiestos que se usará para las reglas android_binary. Marca para ayudar en 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 objetivos de android_binary. Si se especifican varias plataformas, el objeto binario es un APK multiarquitectura, que incluye 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 utiliza 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"-
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
- Configuración predeterminada de
--compiler=<a string>
: ver descripción -
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 objeto binario que se usa para procesar posteriormente los informes de cobertura sin procesar. Actualmente, debe ser un grupo de archivos que contenga un solo archivo, el binario. La configuración predeterminada 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 objeto binario que se usa para generar informes de cobertura. Actualmente, debe ser un grupo de archivos que contenga un solo archivo, el binario. La configuración predeterminada 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. La configuración predeterminada es "//tools/test:coverage_support".
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
- Configuración predeterminada de
--custom_malloc=<a build target label>
: ver descripción -
Especifica una implementación de malloc personalizada. Este parámetro de configuración anula los atributos malloc en las reglas de compilación.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
usos múltiples -
Lista de expresiones regulares separadas por comas, cada una con el prefijo - (expresión negativa), asignada (=) a una lista de valores de restricción separados por comas. Si un objetivo no coincide con ninguna expresión negativa y al menos una expresión positiva, la resolución de la cadena de herramientas se ejecutará 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 aquellos cuyo nombre contenga 'prueba'.
Etiquetas:loading_and_analysis
--[no]experimental_include_xcode_execution_requirements
valor predeterminado: "false"-
Si se configura, agrega un requisito de ejecución “requires-xcode:{version}” a cada acción de Xcode. Si la versión de Xcode tiene una etiqueta con guion, también agrega un requisito de ejecución “requires-xcode-label:{version_label}”.
Etiquetas:loses_incremental_state
,loading_and_analysis
,execution
- El valor predeterminado de
--[no]experimental_prefer_mutual_xcode
es "true" (verdadero). -
Si es verdadero, usa el Xcode más reciente que esté disponible de forma local y remota. Si es falso, o si no existen 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 objetivo exacto o como patrón de objetivo. Estas plataformas se considerarán antes que las declaradas en el archivo WORKSPACE por register_execution_platforms(). Esta opción solo se puede configurar una vez; las instancias posteriores anularán la configuración de marcas anterior.
Etiquetas:execution
- Se acumulan
--extra_toolchains=<comma-separated list of options>
usos múltiples -
Son las reglas de la cadena de herramientas que se tendrán en cuenta durante su resolución. Las cadenas de herramientas se pueden especificar por objetivo exacto o como patrón de objetivo. Estas cadenas de herramientas se considerarán antes de las declaradas en el archivo WORKSPACE por register_toolchains().
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
- Configuración predeterminada de
--grte_top=<a label>
: ver descripción -
Es una etiqueta de una biblioteca libc registrada. La cadena de herramientas de herramientas cruzadas selecciona el valor predeterminado, y casi nunca necesitas anularlo.
Etiquetas:action_command_lines
,affects_outputs
- Configuración predeterminada de
--host_compiler=<a string>
: ver descripción -
Marca no-op. Se quitará en una versión futura.
Etiquetas:loading_and_analysis
,execution
- Configuración predeterminada de
--host_grte_top=<a label>
: ver descripción -
Si se especifica, esta configuración anula el directorio de nivel superior de libc (--grte_top) para la configuración de ejecución.
Etiquetas:action_command_lines
,affects_outputs
--host_platform=<a build target label>
valor predeterminado: "@local_config_platform//:host"-
Es la etiqueta de una regla de la plataforma que describe el sistema host.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
- El valor predeterminado de
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
es "true" (verdadero). -
Si es "true", 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
- El valor predeterminado de
--[no]incompatible_enable_android_toolchain_resolution
es "true" (verdadero). -
Usa la resolución de la cadena de herramientas para seleccionar el SDK de Android para reglas de Android (Starlark y nativo)
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_apple_toolchain_resolution
valor predeterminado: "false"-
Usa la resolución de la cadena de herramientas para seleccionar el SDK de Apple para las reglas de Apple (Starlark y nativo)
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_make_thinlto_command_lines_standalone
es "true" (verdadero). -
Esta marca es una noop y se programó su eliminación.
Etiquetas:no_op
,incompatible_change
- El valor predeterminado de
--[no]incompatible_remove_legacy_whole_archive
es "true" (verdadero). -
Si es verdadero, Bazel no vinculará las dependencias de la biblioteca como todo el archivo de forma predeterminada (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener instrucciones de migración).
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_require_ctx_in_configure_features
es "true" (verdadero). -
Esta marca es una noop y se programó su eliminación.
Etiquetas:no_op
,incompatible_change
--[no]incompatible_strip_executable_safely
valor predeterminado: "false"-
Si es verdadero, la acción de quitar para los ejecutables usará la marca -x, lo que no interrumpe la resolución de símbolos dinámicos.
Etiquetas:action_command_lines
,incompatible_change
- Usa objetos compartidos de interfaz si la cadena de herramientas lo admite. Todas las cadenas de herramientas de ELF admiten actualmente este parámetro de configuración.
Etiquetas:loading_and_analysis
,affects_outputs
,affects_outputs
- Configuración predeterminada de
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Especifica la versión del SDK de iOS que se usará para compilar aplicaciones para iOS. Si no se especifica, usa la versión predeterminada del SDK para iOS de “xcode_version”.
Etiquetas:loses_incremental_state
- Configuración predeterminada de
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Especifica la versión del SDK de macOS que se usará para compilar aplicaciones de macOS. Si no se especifica, se usa la versión predeterminada del SDK de macOS de “xcode_version”.
Etiquetas:loses_incremental_state
- Configuración predeterminada de
--minimum_os_version=<a string>
: ver descripción -
La versión mínima del SO a la que se orienta tu compilación.
Etiquetas:loading_and_analysis
,affects_outputs
--platform_mappings=<a relative path>
predeterminado: ""-
Es la ubicación de un archivo de asignación en la que se describe qué plataforma usar si no hay ninguna establecida o qué marcas se deben configurar cuando ya existe una plataforma. Debe estar relacionado con la raíz del lugar de trabajo principal. La configuración predeterminada es "platform_mappings", que es un archivo directamente en la raíz del lugar de trabajo.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
yimmutable
--platforms=<a build target label>
predeterminado: ""-
Las etiquetas de las reglas de la plataforma que describen las plataformas de destino para el comando actual.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
- Configuración predeterminada de
--python2_path=<a string>
: ver descripción -
Obsoleto, no-op. Inhabilitado por `--incompatible_use_python_toolchains`.
Etiquetas:no_op
,deprecated
- Configuración predeterminada de
--python3_path=<a string>
: ver descripción -
Obsoleto, no-op. Inhabilitado por `--incompatible_use_python_toolchains`.
Etiquetas:no_op
,deprecated
- Configuración predeterminada de
--python_path=<a string>
: ver descripción -
Es la ruta de acceso absoluta del intérprete de Python que se invoca para ejecutar los objetivos de Python en la plataforma de destino. Obsoleto; inhabilitado por --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
- Configuración predeterminada de
--python_top=<a build target label>
: ver descripción -
La etiqueta de un py_runtime que representa el intérprete de Python invocado para ejecutar objetivos de Python en la plataforma de destino. Obsoleto; inhabilitado por --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
- Configuración predeterminada de
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Especifica la versión del SDK de tvOS que se usará para compilar aplicaciones de tvOS. Si no se especifica, se usa la versión predeterminada del SDK de tvOS de “xcode_version”.
Etiquetas:loses_incremental_state
- Configuración predeterminada de
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Especifica la versión del SDK de watchOS que se usará para compilar aplicaciones de watchOS. Si no se especifica, se usa la versión predeterminada del SDK de watchOS de “xcode_version”.
Etiquetas:loses_incremental_state
- Configuración predeterminada de
--xcode_version=<a string>
: ver descripción -
Si se especifica, usa Xcode de la versión determinada para las acciones de compilación relevantes. Si no se especifica, usa la versión predeterminada del ejecutor de Xcode.
Etiquetas:loses_incremental_state
--xcode_version_config=<a build target label>
predeterminado: "@bazel_tools//tools/cpp:host_xcodes"-
La etiqueta de la regla xcode_config que se usará para seleccionar la versión de Xcode en la configuración de compilación.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Opciones que controlan el resultado del comando:
--[no]apple_generate_dsym
valor predeterminado: "false"-
Indica si se deben generar archivos de símbolos de depuración (.dSYM).
Etiquetas:affects_outputs
,action_command_lines
- El valor predeterminado de
--[no]build_runfile_links
es "true" (verdadero). -
Si esta opción es verdadera, compila bosques de symlinks de archivos de ejecución para todos los destinos. Si es falso, escríbelos solo cuando lo requiera una acción local, un comando de prueba o ejecución.
Etiquetas:affects_outputs
- El valor predeterminado de
--[no]build_runfile_manifests
es "true" (verdadero). -
Si esta opción es verdadera, se escriben manifiestos de archivos de ejecución para todos los destinos. Si es falso, omítelos. Las pruebas locales no se ejecutarán si el valor es falso.
Etiquetas:affects_outputs
--[no]build_test_dwp
valor predeterminado: "false"-
Si se habilita, cuando se compilen pruebas de C++ de forma estática y con fisión, 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"-
Establece los sufijos de los archivos fuente que crea una cc_proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info
valor 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
valor 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
valor predeterminado: "false"-
Guarda el estado de las funciones habilitadas y solicitadas como resultado de la compilación.
Etiquetas:affects_outputs
,experimental
- El valor predeterminado de
--fission=<a set of compilation modes>
es "no" -
Especifica qué modos de compilación usan fisión para compilaciones y 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
- El valor predeterminado de
--[no]incompatible_always_include_files_in_data
es "true" (verdadero). -
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
- El valor predeterminado de
--[no]legacy_external_runfiles
es "true" (verdadero). -
Si esta opción es verdadera, compila bosques de symlink de archivos de ejecución para repositorios externos en .runfiles/wsname/external/repo (además de .runfiles/repo).
Etiquetas:affects_outputs
--[no]objc_generate_linkmap
valor predeterminado: "false"-
Especifica si se debe generar un archivo de mapa de vínculos.
Etiquetas:affects_outputs
--[no]save_temps
valor predeterminado: "false"-
Si se establece, se guardarán los resultados temporales de GCC. Estos incluyen archivos .s (código ensamblador), archivos .i (C preprocesado) y archivos .ii (C++ previamente procesados).
Etiquetas:affects_outputs
- Opciones que permiten al usuario configurar el resultado deseado y afectar su valor, en lugar de su existencia:
- Se acumulan
--action_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica el conjunto de variables de entorno disponibles para 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 mediante el par nombre=valor que establece el valor independientemente del entorno de invocación. Esta opción se puede usar varias veces; para opciones proporcionadas para la misma variable, se acumulan los últimos éxitos, las opciones para diferentes variables se acumulan.
Etiquetas:action_command_lines
--android_cpu=<a string>
predeterminado: "armeabi-v7a"-
Es la CPU de destino de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- El valor predeterminado de
--[no]android_databinding_use_androidx
es "true" (verdadero). -
Genera archivos de vinculación de datos compatibles con AndroidX. Esto solo se usa con Databinding v2. Esta marca es una no-op.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- El valor predeterminado de
--[no]android_databinding_use_v3_4_args
es "true" (verdadero). -
Usa Android Databinding v2 con un argumento 3.4.0. Esta marca es una no-op.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- El valor predeterminado de
--android_dynamic_mode=<off, default or fully>
es "desactivado" -
Determina si las dependencias de C++ de las reglas de Android se vincularán de forma dinámica cuando un objeto cc_binary no cree explícitamente una biblioteca compartida. “default” significa que Bazel decide si se vincula de forma dinámica. "completamente" significa que todas las bibliotecas se vincularán de forma dinámica. “off” significa que todas las bibliotecas se vincularán en su mayor parte en modo estático.
Etiquetas:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
valor predeterminado: "alphabetical"-
Establece el orden de los manifiestos que se pasan a la combinación de manifiestos para objetos binarios de Android. ALFABÉTICO significa que los manifiestos se ordenan por ruta de acceso relativa a la execroot. ALPHABETICAL_BY_CONFIGURATION significa que los manifiestos se ordenan por rutas de acceso relacionadas con el directorio de configuración dentro del directorio de salida. DEPENDENCY significa que los manifiestos se ordenan con los manifiestos de cada biblioteca antes que los de sus dependencias.
Etiquetas:action_command_lines
,execution
--[no]android_resource_shrinking
valor predeterminado: "false"-
Habilita la reducción de recursos para los APKs de android_binary que usan ProGuard.
Etiquetas:affects_outputs
,loading_and_analysis
- Valor predeterminado de
--[no]build_python_zip
: "auto" -
Compila el archivo ZIP del comando de Python; en Windows, desactivado en otras plataformas
Etiquetas:affects_outputs
- Se acumulan
--catalyst_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se compilan los objetos binarios de Apple Catalyst.
Etiquetas:loses_incremental_state
,loading_and_analysis
--[no]collect_code_coverage
valor predeterminado: "false"-
Si se especifica, Bazel instrumentará código (con instrumentación sin conexión cuando sea posible) y recopilará información de cobertura durante las pruebas. Solo se verán afectados los objetivos que coincidan con --instrumentation_filter. Por lo general, esta opción no debe especificarse directamente; en su lugar, debes usar el comando "bazel esquema".
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
--conlyopt=<a string>
usos múltiples -
Es una opción adicional para pasar a gcc cuando se compilan archivos de origen C.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--copt=<a string>
usos múltiples -
Opciones adicionales para pasar a gcc.
Etiquetas:action_command_lines
,affects_outputs
--cpu=<a string>
predeterminado: ""-
La CPU de destino.
Etiquetas:changes_inputs
,affects_outputs
- Configuración predeterminada de
--cs_fdo_absolute_path=<a string>
: ver descripción - Usa la información del perfil de CSFDO para optimizar la compilación. Especifica el nombre de ruta de acceso absoluto del archivo ZIP que contiene el archivo de perfil, un archivo de perfil de LLVM sin procesar o indexado.
Etiquetas:affects_outputs
- Configuración predeterminada de
--cs_fdo_instrument=<a string>
: ver descripción - Genera objetos binarios con instrumentación de FDO sensible al contexto. Con el compilador Clang/LLVM, también acepta el nombre de directorio bajo el cual se volcarán los archivos de perfil sin procesar durante el tiempo de ejecución.
Etiquetas:affects_outputs
- Configuración predeterminada de
--cs_fdo_profile=<a build target label>
: ver descripción -
El cs_fdo_profile, que representa el perfil sensible al contexto que se usará para la optimización.
Etiquetas:affects_outputs
- Se acumulan
--cxxopt=<a string>
usos múltiples -
Es una opción adicional para pasar a gcc cuando se compilan archivos de origen C++.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--define=<a 'name=value' assignment>
usos múltiples -
Cada opción --define especifica una asignación para una variable de compilación. Si hay varios valores para una variable, ganará el último.
Etiquetas:changes_inputs
,affects_outputs
--dynamic_mode=<off, default or fully>
valor predeterminado: "default"-
Determina si los objetos binarios de C++ se vincularán de forma dinámica. “predeterminada” significa que Bazel elegirá si se vinculará de forma dinámica. "completamente" significa que todas las bibliotecas se vincularán de forma dinámica. “off” significa que todas las bibliotecas se vincularán en su mayor parte en modo estático.
Etiquetas:loading_and_analysis
,affects_outputs
- El valor predeterminado de
--[no]enable_fdo_profile_absolute_path
es "true" (verdadero). -
Si se configura, el uso de fdo_absolute_profile_path generará un error.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]enable_runfiles
: "auto" -
Habilita el árbol del symlink de los archivos de ejecución. De forma predeterminada, está desactivado en Windows y en otras plataformas.
Etiquetas:affects_outputs
- Se acumulan
--experimental_action_listener=<a build target label>
usos múltiples -
Se dio de baja a favor de los 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
valor predeterminado: "false"-
Comprime los recursos de Java en APK
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
- El valor predeterminado de
--[no]experimental_android_databinding_v2
es "true" (verdadero). - Usa Android Databinding v2. Esta marca es una no-op.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_android_resource_shrinking
valor 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
valor predeterminado: "false"-
usar la herramienta Rex para reescribir archivos dex
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_collect_code_coverage_for_generated_files
valor predeterminado: "false"-
Si se especifica, Bazel también generará información de cobertura para los archivos generados.
Etiquetas:affects_outputs
--experimental_objc_fastbuild_options=<comma-separated list of options>
predeterminado: "-O0,-DDEBUG=1"-
Usa estas cadenas como opciones del compilador objc fastbuild.
Etiquetas:action_command_lines
--[no]experimental_omitfp
valor predeterminado: "false"-
Si esta opción es "true", usa libunwind para desenrollar la pila y compila con -fomit-frame-pointer y -fasym-unwind-tables.
Etiquetas:action_command_lines
,affects_outputs
,experimental
- El valor predeterminado de
--experimental_output_paths=<off, content or strip>
es "desactivado" -
Indica qué modelo usar en qué parte de las reglas del árbol de resultados escriben sus resultados, en particular para compilaciones multiplataforma o de varias configuraciones. Esto es altamente experimental. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/6526. Las acciones de Starlark pueden habilitar la asignación de ruta agregando la clave “supports-path-mapping” al diccionario “execution_requirements”.
Etiquetas:loses_incremental_state
,bazel_internal_configuration
,affects_outputs
yexecution
- Se acumulan
--experimental_override_name_platform_in_output_dir=<a 'label=value' assignment>
usos múltiples -
Cada entrada debe tener el formato label=value, en el que la etiqueta hace referencia a una plataforma y los valores son el nombre corto deseado para usar en la ruta de acceso del resultado. Solo se usa cuando --experimental_platform_in_output_dir es verdadero. Tiene la prioridad de nombre más alta.
Etiquetas:affects_outputs
,experimental
--[no]experimental_platform_in_output_dir
valor 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: en primer lugar, en el caso poco frecuente de que la opción --platforms no tenga exactamente un valor, se utilizará un hash de la opción de plataformas. Luego, si --experimental_override_name_platform_in_output_dir registró algún nombre corto para la plataforma actual, entonces se utiliza ese nombre corto. Luego, si se configura --experimental_use_platforms_in_output_dir_legacy_heuristic, se debe utilizar un nombre corto basado en la etiqueta actual de la plataforma. Por último, se usa un hash de la opción de plataforma como último recurso.
Etiquetas:affects_outputs
,experimental
--[no]experimental_use_llvm_covmap
valor predeterminado: "false"-
Si se especifica, Bazel generará información del mapa de cobertura llvm-cov en lugar de gcov cuando collect_code_coverage esté habilitado.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
yexperimental
- El valor predeterminado de
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic
es "true" (verdadero). -
Usa esta marca solo como parte de una estrategia sugerida de migración o prueba. 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"-
Mediante la configuración de esta opción, se habilitan los APK multiarquitecturas, 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, --android_cpu se ignora para dependencias de reglas android_binary.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]fat_apk_hwasan
valor predeterminado: "false"-
Marca no-op. Se quitará en una versión futura.
Etiquetas:no_op
- Configuración predeterminada de
--fdo_instrument=<a string>
: ver descripción - Genera objetos binarios con instrumentación de FDO. Con el compilador Clang/LLVM, también acepta el nombre de directorio bajo el cual se volcarán los archivos de perfil sin procesar durante el tiempo de ejecución.
Etiquetas:affects_outputs
- Configuración predeterminada de
--fdo_optimize=<a string>
: ver 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 apunten a objetivos de `fdo_profile`. Esta marca será reemplazada por la regla “fdo_profile”.
Etiquetas:affects_outputs
- Configuración predeterminada de
--fdo_prefetch_hints=<a build target label>
: ver descripción -
Usa sugerencias de carga previa de caché.
Etiquetas:affects_outputs
- Configuración predeterminada de
--fdo_profile=<a build target label>
: ver descripción -
El fdo_profile, que representa el perfil que se utilizará para la optimización.
Etiquetas:affects_outputs
- Se acumulan
--features=<a string>
usos múltiples -
Estas funciones estarán habilitadas o inhabilitadas de forma predeterminada para los destinos integrados en la configuración de destino. Si especificas -<feature>, se inhabilitará la función. Los atributos negativos siempre anulan a los positivos. Consulta también --host_features
Etiquetas:changes_inputs
,affects_outputs
--[no]force_pic
valor predeterminado: "false"-
Si se habilita, todas las compilaciones de C++ producen código independiente de la posición ("-fPIC"), los vínculos prefieren bibliotecas PIC compiladas previamente en lugar de bibliotecas que no son PIC, y los vínculos producen ejecutables independientes de la posición ("-pie").
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan
--host_action_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica el conjunto de variables de entorno disponibles para acciones con configuraciones de ejecución. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o mediante el par nombre=valor que establece el valor independientemente del entorno de invocación. Esta opción se puede usar varias veces; para opciones proporcionadas para la misma variable, se acumulan los últimos éxitos, las opciones para diferentes variables se acumulan.
Etiquetas:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
valor predeterminado: "opt"- Especifica el modo en el que se integrarán las herramientas usadas durante la compilación. Valores: "fastbuild", "dbg", "opt".
Etiquetas:affects_outputs
,action_command_lines
- Se acumulan
--host_conlyopt=<a string>
usos múltiples -
Es una opción adicional para pasar al compilador C cuando se compilan archivos de origen C (pero no C++) en las configuraciones de ejecución.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--host_copt=<a string>
usos múltiples -
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: ""-
Es la CPU del host.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan
--host_cxxopt=<a string>
usos múltiples -
Opciones adicionales para pasar al compilador de C++ para herramientas compiladas en configuraciones de ejecución.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--host_features=<a string>
usos múltiples -
Las funciones determinadas estarán habilitadas o inhabilitadas de forma predeterminada para los destinos integrados en la configuración de ejecución. Si especificas -<feature>, se inhabilitará la función. Los atributos negativos siempre anulan a los positivos.
Etiquetas:changes_inputs
,affects_outputs
- Configuración predeterminada de
--host_force_python=<PY2 or PY3>
: ver descripción -
Anula la versión de Python para la configuración de ejecución. Puede ser “PY2” o “PY3”.
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan
--host_linkopt=<a string>
usos múltiples -
Es una opción adicional para pasar al vinculador cuando se vinculan herramientas en la configuración de ejecución.
Etiquetas:action_command_lines
,affects_outputs
- Configuración predeterminada de
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima de macOS compatible para los destinos de host. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
usos múltiples -
Son 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 aprobar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter significa una lista de patrones de expresiones regulares de inclusión y exclusión (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 ir entre comillas con una barra inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos gcc de todos los archivos cc en //foo/, excepto bar.cc.
Etiquetas:action_command_lines
,affects_outputs
--[no]incompatible_auto_exec_groups
valor predeterminado: "false"-
Cuando se habilita, se crea automáticamente un grupo de ejecutables 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
- El valor predeterminado de
--[no]incompatible_merge_genfiles_directory
es "true" (verdadero). -
Si es verdadero, el directorio genfiles se pliega en el directorio bin.
Etiquetas:affects_outputs
,incompatible_change
--[no]instrument_test_targets
valor predeterminado: "false"-
Cuando la cobertura está habilitada, especifica si se debe considerar la instrumentación de reglas de prueba. Cuando se establece, se instrumentan las reglas de prueba incluidas por --instrumentation_filter. De lo contrario, las reglas de prueba siempre se excluyen de la instrumentación de cobertura.
Etiquetas:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
valor predeterminado: "-/javatests[/:],-/test/java[/:]"-
Cuando la cobertura esté habilitada, solo se instrumentarán las reglas con nombres incluidos en el filtro basado en regex especificado. En su lugar, se excluyen las reglas con el prefijo “-”. Ten en cuenta que solo se instrumentan las reglas que no son de prueba, a menos que esté habilitado --instrument_test_targets.
Etiquetas:affects_outputs
- Configuración predeterminada de
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima de iOS compatible con los simuladores y dispositivos de destino. Si no se especifica, usa “ios_sdk_version”.
Etiquetas:loses_incremental_state
- Se acumulan
--ios_multi_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para compilar una ios_application. El resultado es un objeto binario universal que contiene todas las arquitecturas especificadas.
Etiquetas:loses_incremental_state
,loading_and_analysis
- El valor predeterminado de
--[no]legacy_whole_archive
es "true" (verdadero). -
Obsoleto y sustituido por --incompatible_remove_legacy_whole_archive (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener más información). Cuando esta opción está activada, se usa --whole-archive para reglas cc_binary que tengan linkshared=True y linkstatic=True o '-static' en linkopts. Esto es solo para retrocompatibilidad. Una mejor alternativa es usar Alwayslink=1 cuando sea necesario.
Etiquetas:action_command_lines
,affects_outputs
,deprecated
- Se acumulan
--linkopt=<a string>
usos múltiples -
Es una opción adicional para pasar a gcc durante la vinculación.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--ltobackendopt=<a string>
usos múltiples -
Es una opción adicional para pasar al paso de backend de LTO (en --features=thin_lto).
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--ltoindexopt=<a string>
usos múltiples -
Es una opción adicional para pasar al paso de indexación LTO (en --features=thin_lto).
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--macos_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se compilan objetos binarios de Apple macOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Configuración predeterminada de
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima de macOS compatible para los objetivos. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
- Configuración predeterminada de
--memprof_profile=<a build target label>
: ver descripción -
Usar el perfil de memprof.
Etiquetas:affects_outputs
--[no]objc_debug_with_GLIBCXX
valor predeterminado: "false"-
Si estableces la política y el modo de compilación está configurado como "dbg", define GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC y GLIBCPP_CONCEPT_CHECKS.
Etiquetas:action_command_lines
--[no]objc_enable_binary_stripping
valor predeterminado: "false"-
Determina si se deben quitar símbolos y códigos muertos en objetos binarios vinculados. Si se especifican esta marca y --compilation_mode=opt, se realizarán eliminaciones binarias.
Etiquetas:action_command_lines
- Se acumulan
--objccopt=<a string>
usos múltiples -
Opciones adicionales para pasar a gcc cuando se compilan archivos fuente Objective-C/C++.
Etiquetas:action_command_lines
- Se acumulan
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
usos múltiples -
Opciones adicionales para pasar selectivamente a gcc cuando se compilan ciertos archivos. Esta opción se puede aprobar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter significa una lista de patrones de expresiones regulares de inclusión y exclusión (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 ir entre comillas con una barra inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos gcc de todos los archivos cc en //foo/, excepto bar.cc.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
usos múltiples -
Opciones adicionales para pasar de forma selectiva al backend de LTO (en --features=thin_lto) cuando se compilan ciertos objetos de backend. Esta opción se puede aprobar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter significa una lista de patrones de expresiones regulares de inclusión y exclusión, y option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe ir entre comillas con una barra inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos del backend de LTO de todos los archivos o en //foo/, excepto bar.o.
Etiquetas:action_command_lines
,affects_outputs
- Configuración predeterminada de
--platform_suffix=<a string>
: ver descripción -
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas:loses_incremental_state
,affects_outputs
,loading_and_analysis
- Configuración predeterminada de
--propeller_optimize=<a build target label>
: ver descripción -
Usa la información del perfil de Propeller para optimizar el objetivo de compilación.Un perfil de propulsor debe constar de al menos uno de dos archivos, un perfil cc y un perfil ld. Esta marca acepta una etiqueta de compilación que debe hacer referencia a los archivos de entrada del perfil de propulsor. Por ejemplo, el archivo BUILD que define la etiqueta La opción debe usarse de la siguiente manera: --propeller_optimize=//a/b:propeller_profile
Etiquetas:action_command_lines
,affects_outputs
- Configuración predeterminada de
--propeller_optimize_absolute_cc_profile=<a string>
: ver descripción -
Nombre de ruta de acceso absoluto del archivo cc_profile para compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
- Configuración predeterminada de
--propeller_optimize_absolute_ld_profile=<a string>
: ver descripción -
Nombre de ruta de acceso absoluto del archivo ld_profile para compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
- Configuración predeterminada de
--run_under=<a prefix in front of command>
: ver descripción -
Es el prefijo que se debe insertar antes de los ejecutables para los comandos “test” y “run”. Si el valor es “foo -bar”, y la línea de comandos de ejecución es “test_binary -baz”, la línea de comandos final es “foo -bar test_binary -baz”. También puede ser una etiqueta para un destino ejecutable. Estos son algunos ejemplos: 'valgrind', 'strace', 'strace -c', 'valgrind --quiet --num-callers=20', '//package:target', '//package:target --options'.
Etiquetas:action_command_lines
-
Si es "true", las bibliotecas nativas que contengan la misma funcionalidad se compartirán entre diferentes destinos
Etiquetas:loading_and_analysis
,affects_outputs
--[no]stamp
valor predeterminado: "false"-
Sella los objetos binarios con la fecha, el nombre de usuario, el nombre de host, la información del lugar de trabajo, etcétera.
Etiquetas:affects_outputs
- El valor predeterminado de
--strip=<always, sometimes or never>
es " a veces". -
Especifica si se quitan los objetos binarios y las bibliotecas compartidas (con "-Wl,--strip-debug"). El valor predeterminado de "algunas veces" significa quitar iff --compilation_mode=fastbuild.
Etiquetas:affects_outputs
- Se acumulan
--stripopt=<a string>
usos múltiples -
Opciones adicionales para quitar cuando se genera un objeto binario “<name>.stripped”.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--tvos_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se compilan objetos binarios de Apple tvOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Configuración predeterminada de
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima de tvOS compatible para simuladores de objetivo y dispositivos. Si no se especifica, se usa "tvos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan
--visionos_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se compilan objetos binarios de visionOS de Apple.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Se acumulan
--watchos_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se compilan objetos binarios de watchOS de Apple.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Configuración predeterminada de
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima de watchOS compatible para los simuladores y dispositivos de destino. Si no se especifica, se usa “watchos_sdk_version”.
Etiquetas:loses_incremental_state
- Configuración predeterminada de
--xbinary_fdo=<a build target label>
: ver 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 medida en la que Bazel aplica de manera estricta 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 entorno_group para asignarlo automáticamente a los valores de CPU a los valores target_environment.
Etiquetas:changes_inputs
,loading_and_analysis
,experimental
--[no]check_licenses
valor predeterminado: "false"-
Verifica que las restricciones de licencias impuestas por los paquetes dependientes no entren en conflicto con los modos de distribución de los destinos que se compilan. De forma predeterminada, las licencias no están marcadas.
Etiquetas:build_file_semantics
- El valor predeterminado de
--[no]check_visibility
es "true" (verdadero). - Si se inhabilita, los errores de visibilidad en las dependencias de destino descienden a advertencias.
Etiquetas:build_file_semantics
- El valor predeterminado de
--[no]desugar_for_android
es "true" (verdadero). -
Indica si se debe usar la expansión de sintaxis del código de bytes Java 8 antes de la conversión a DEX.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]desugar_java8_libs
valor predeterminado: "false"-
Determina si se deben incluir bibliotecas de Java 8 compatibles en apps para dispositivos heredados.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
yexperimental
- El valor predeterminado de
--[no]enforce_constraints
es "true" (verdadero). -
Verifica los entornos compatibles con cada destino y, luego, informa errores si algún destino tiene dependencias que no admiten los mismos entornos
Etiquetas:build_file_semantics
- El valor predeterminado de
--[no]experimental_check_desugar_deps
es "true" (verdadero). -
Indica si se debe verificar la expansión de sintaxis correcta a nivel binario de Android.
Etiquetas:eagerness_to_exit
,loading_and_analysis
,experimental
- Configuración predeterminada de
--experimental_import_deps_checking=<off, warning or error>
: "DESACTIVADA" -
Cuando se habilita, verifica si las dependencias de aar_import están completas. Esta aplicación puede dañar la compilación o simplemente generar advertencias.
Etiquetas:loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
valor predeterminado: "default"-
Si es verdadero, verifica que un destino de Java declare de forma explícita todos los destinos usados de forma directa como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files
valor predeterminado: "false"-
Si se habilita esta opción, verifica los objetivos de solo prueba de los requisitos previos que sean archivos de salida. Para ello, busca el solo de prueba de la regla de generación. Esto coincide con la verificación de visibilidad.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_check_visibility_for_toolchains
valor predeterminado: "false"-
Si se habilita, la verificación de visibilidad también se aplica a las implementaciones de las cadenas de herramientas.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_disable_native_android_rules
valor predeterminado: "false"-
Si se habilita, se inhabilita el uso directo de las reglas nativas de Android. Usa las reglas de Starlark para Android de https://github.com/bazelbuild/rules_android
Etiquetas:eagerness_to_exit
,incompatible_change
--[no]incompatible_disable_native_apple_binary_rule
valor predeterminado: "false"-
No-ops. Se conserva aquí para brindar retrocompatibilidad.
Etiquetas:eagerness_to_exit
,incompatible_change
- El valor predeterminado de
--[no]incompatible_python_disable_py2
es "true" (verdadero). -
Si es verdadero, usar la configuración de Python 2 generará un error. Esto incluye python_version=PY2, srcs_version=PY2 y srcs_version=PY2ONLY. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/15684.
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_validate_top_level_header_inclusions
es "true" (verdadero). -
Esta marca es una noop y se programó su eliminación.
Etiquetas:no_op
,incompatible_change
- Configuración predeterminada de
--python_native_rules_allowlist=<a build target label>
: ver descripción -
Una lista de entidades permitidas (objetivo de grupo de paquete) para usar cuando se aplique --incompatible_python_Disallow_native_rules.
Etiquetas:loading_and_analysis
--[no]strict_filesets
valor predeterminado: "false"- Si se habilita esta opción, los conjuntos de archivos que cruzan los límites de los paquetes se informan como errores.
Etiquetas:build_file_semantics
,eagerness_to_exit
- El valor predeterminado de
--strict_proto_deps=<off, warn, error, strict or default>
es "error" -
A menos que esté DESACTIVADO, verifica que un destino proto_library declare de forma explícita todos los destinos usados de forma directa como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
- El valor predeterminado de
--strict_public_imports=<off, warn, error, strict or default>
es "desactivado" -
A menos que esté DESACTIVADO, verifica que un destino proto_library declare de forma explícita todos los destinos usados en "import public" como exportados.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
--[no]strict_system_includes
valor 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
--target_environment=<a build target label>
usos múltiples -
Declara el entorno de destino de esta compilación. Debe ser una referencia de etiqueta a una regla de “entorno”. Si se especifica, todos los destinos 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 usa para firmar APKs
Etiquetas:action_command_lines
,affects_outputs
,loading_and_analysis
- El valor predeterminado de
--[no]device_debug_entitlements
es "true" (verdadero). -
Si se configura y el modo de compilación no es "opt", las apps de objc incluirán derechos de depuración durante la firma.
Etiquetas:changes_inputs
- Configuración predeterminada de
--ios_signing_cert_name=<a string>
: ver descripción -
Nombre del certificado que se usará para la firma de iOS. Si no la estableces, se recurrirá al perfil de aprovisionamiento. Puede ser la preferencia de identidad del llavero del certificado o (subcadena) del nombre común del certificado, según la página manual de la señal de código (SIGNING IDENTITIES).
Etiquetas:action_command_lines
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE.:
- El valor predeterminado de
--[no]incompatible_disallow_legacy_py_provider
es "true" (verdadero). -
No-ops, se quitará pronto.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_sdk_frameworks_attributes
valor predeterminado: "false"-
Si el valor es "true", se inhabilitan los atributos sdk_frameworks y débil_sdk_frameworks en objc_library andobjc_import.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_objc_alwayslink_by_default
valor predeterminado: "false"-
Si el valor predeterminado es "true", 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
valor 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 determinan el comportamiento del entorno de pruebas o del ejecutor de pruebas:
--[no]allow_analysis_failures
valor predeterminado: "false"-
Si es verdadero, una falla de análisis de un destino de regla provocará la propagación del objetivo de una instancia de AnalysisFailureInfo que contiene la descripción del error, en lugar de 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 mediante un atributo de regla con una transición de configuración for_analysis_testing. Si se supera ese límite, se mostrará un error de regla.
Etiquetas:loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure
valor predeterminado: "false"-
Si se producen errores reales en la acción de dex2oat, la compilación falla en lugar de ejecutar dex2oat durante el tiempo de ejecución de la prueba.
Etiquetas:loading_and_analysis
,experimental
- Se acumulan
--default_test_resources=<a resource name followed by equal and 1 float or 4 float, e.g memory=10,30,60,100>
usos múltiples - Anula la cantidad predeterminada de recursos para las pruebas. El formato esperado es <resource>=<value>. Si se especifica un solo número positivo como <value>, se anularán los recursos predeterminados para todos los tamaños de prueba. Si se especifican 4 números separados por comas, anularán la cantidad de recursos para los tamaños de prueba pequeños, medianos, grandes y, respectivamente. Los valores también pueden ser HOST_RAM/HOST_CPU, opcionalmente seguido de [-|*]<float> (p. ej., memoria=HOST_RAM*.1, HOST_RAM*.2, HOST_RAM*.3, HOST_RAM*.4). Los recursos de prueba predeterminados que especifica esta marca se anulan con los recursos explícitos especificados en las etiquetas.
--[no]experimental_android_use_parallel_dex2oat
valor predeterminado: "false"-
Usa dex2oat en paralelo para, quizás, acelerar android_test.
Etiquetas:loading_and_analysis
,host_machine_resource_optimizations
,experimental
--[no]ios_memleaks
valor predeterminado: "false"-
Habilita la comprobación de fugas de memoria en los destinos ios_test.
Etiquetas:action_command_lines
- Configuración predeterminada de
--ios_simulator_device=<a string>
: ver 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 que se ejecutará el simulador.
Etiquetas:test_runner
- Configuración predeterminada de
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Es la versión de iOS que se ejecutará en el simulador cuando se ejecute o realice pruebas. Esto se ignora para las reglas ios_test si se especifica un dispositivo de destino en la regla.
Etiquetas:test_runner
- Se acumulan
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
usos múltiples - Especifica la cantidad de veces que se debe ejecutar cada prueba. Si alguno de esos intentos falla por algún motivo, toda la prueba se considerará fallida. Normalmente, el valor especificado es solo un número entero. Ejemplo: --runs_per_test=3 ejecutará todas las pruebas 3 veces. Sintaxis alternativa: regex_filter@runs_per_test. Donde run_per_test significa un valor de número entero y regex_filter significa una lista de patrones de expresiones regulares de inclusión y exclusión (también consulta --instrumentation_filter). Ejemplo: --runs_per_test=//foo/.*,-//foo/bar/.*@3 ejecuta todas las pruebas en //foo/ excepto las que se encuentran en foo/bar tres veces. Esta opción se puede aprobar varias veces. El último argumento pasado que coincida tendrá prioridad. Si no hay coincidencia, la prueba se ejecuta solo una vez.
- Se acumulan
--test_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
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á desde el entorno del cliente de Bazel o mediante el par nombre=valor. Esta opción se puede usar varias veces para especificar distintas variables. Solo lo usa el comando “bazel test”.
Etiquetas:test_runner
--test_timeout=<a single integer or comma-separated list of 4 integers>
valor predeterminado: "-1"- Anula los valores predeterminados de tiempo de espera de la prueba (en segundos). Si se especifica un solo valor entero positivo, se anularán todas las categorías. Si se especifican 4 números enteros separados por comas, estos anularán los tiempos de espera: corto, moderado, largo y eterno (en ese orden). En cualquier forma, un valor de -1 le indica a blaze que use sus tiempos de espera predeterminados para esa categoría.
- El valor predeterminado de
--[no]zip_undeclared_test_outputs
es "true" (verdadero). -
Si es verdadero, los resultados de pruebas no declarados se archivarán en un archivo ZIP.
Etiquetas:test_runner
- Opciones relacionadas con el resultado y la semántica de la consulta:
- El valor predeterminado de
--aspect_deps=<off, conservative or precise>
es "conservador". -
Cómo resolver dependencias de aspecto cuando el formato de salida es {xml,proto,record}. “desactivado” significa que no se resuelven las dependencias de aspecto, “conservadora” (el valor predeterminado) significa que se agregan todas las dependencias de aspecto declaradas sin importar si se les otorga la clase de regla de las dependencias directas. “preciso” significa que solo se agregan esos aspectos que posiblemente estén activos dada la clase de regla de las dependencias directas. Ten en cuenta que el modo preciso requiere cargar otros paquetes para evaluar un solo objetivo, por lo que es más lento que los otros modos. Además, ten en cuenta que incluso el modo preciso no es del todo preciso: la decisión de calcular un aspecto se decide en la fase de análisis, que no se ejecuta durante la “consulta de Bazel”.
Etiquetas:build_file_semantics
--[no]consistent_labels
valor predeterminado: "false"-
Si se habilita, cada comando de consulta emite etiquetas como si lo hiciera la función <code>str</code> de Starlark aplicada a una instancia de <code>etiqueta</code>. Esto es útil para las herramientas que necesitan hacer coincidir el resultado de diferentes comandos de consulta o etiquetas emitidas por reglas. Si no están habilitados, los formateadores de salida tienen la libertad de emitir nombres de repositorio aparentes (en relación con el repositorio principal) para que los resultados sean más legibles.
Etiquetas:terminal_output
--[no]experimental_explicit_aspects
valor predeterminado: "false"-
aquery, cquery: si se deben incluir acciones generadas por el aspecto en el resultado. query: no-op (siempre se siguen los aspectos).
Etiquetas:terminal_output
- El valor predeterminado de
--[no]graph:factored
es "true" (verdadero). -
Si es "true", el gráfico se emitirá "factorizado", es decir, los nodos equivalentes topológicamente se combinarán y sus etiquetas se concatenarán. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--graph:node_limit=<an integer>
predeterminado: "512"-
La longitud máxima de la string de etiqueta para un nodo del gráfico en el resultado. Las etiquetas más largas se truncarán; -1 significa que no hay truncamiento. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]implicit_deps
es "true" (verdadero). -
Si se habilita, las dependencias implícitas se incluirán en el gráfico de dependencias en el que opera la consulta. Una dependencia implícita es aquella que no se especifica de forma explícita en el archivo BUILD, sino que Bazel la agrega. En el caso de cquery, esta opción controla el filtrado de cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
- El valor predeterminado de
--[no]include_artifacts
es "true" (verdadero). -
Incluye los nombres de las entradas y salidas de acción en la salida (posiblemente grande).
Etiquetas:terminal_output
- El valor predeterminado de
--[no]include_aspects
es "true" (verdadero). -
aquery, cquery: si se deben incluir acciones generadas por el aspecto en el resultado. query: no-op (siempre se siguen los aspectos).
Etiquetas:terminal_output
- El valor predeterminado de
--[no]include_commandline
es "true" (verdadero). -
Incluye el contenido de las líneas de comandos de acción en el resultado (posiblemente grande).
Etiquetas:terminal_output
--[no]include_file_write_contents
valor predeterminado: "false"-
Incluye el contenido del archivo para las acciones FileWrite, SourceSymlinkManifest y RepoMappingManifest (posiblemente grandes).
Etiquetas:terminal_output
--[no]include_param_files
valor predeterminado: "false"-
Incluye el contenido de los archivos de parámetros que se usaron en el comando (posiblemente grandes). Nota: Habilitar esta marca habilitará automáticamente la marca --include_commandline.
Etiquetas:terminal_output
--[no]include_scheduling_dependencies
valor predeterminado: "false"-
Incluye los nombres de las dependencias de programación de acciones (posiblemente grandes). Solo tendrá efecto si también se configura --include_artifacts.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]incompatible_package_group_includes_double_slash
es "true" (verdadero). -
Si se habilita, cuando se genere el atributo `packages` de package_group, no se omitirá el signo `//` inicial.
Etiquetas:terminal_output
,incompatible_change
--[no]infer_universe_scope
valor predeterminado: "false"-
Si se configura y --universe_scope no se establece, se inferirá un valor de --universe_scope como la lista de patrones de objetivo únicos en la expresión de consulta. Ten en cuenta que el valor de --universe_scope que se infiere para una expresión de consulta que utiliza funciones con alcance universal (p.ej., `allrdeps`) puede no ser lo que quieres, por lo que solo debes usar esta opción si sabes lo que estás haciendo. Consulta https://bazel.build/reference/query#sky-query para obtener detalles y ejemplos. Si se configura --universe_scope, se ignora el valor de esta opción. Nota: Esta opción solo se aplica a “consulta” (es decir, no a “cquery”).
Etiquetas:loading_and_analysis
--[no]line_terminator_null
valor predeterminado: "false"-
Indica si cada formato termina con \0 en lugar de una línea nueva.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]nodep_deps
es "true" (verdadero). -
Si se habilita, las dependencias de los atributos “nodep” se incluirán en el gráfico de dependencias en el que opera la consulta. Un ejemplo común de un atributo “nodep” es la “visibilidad”. Ejecuta y analiza el resultado de `info build-language` para conocer todos los atributos “nodep” en el lenguaje de compilación.
Etiquetas:build_file_semantics
--output=<a string>
predeterminado: "text"-
Formato en el que se deben imprimir los resultados de una consulta. Los valores permitidos para una consulta son los siguientes: text, textproto, proto, broadcast_proto, jsonproto.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]proto:default_values
es "true" (verdadero). -
Si el valor es "true", 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
valor predeterminado: "false"-
Propaga el campo proto define_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
- El valor predeterminado de
--[no]proto:flatten_selects
es "true" (verdadero). -
Si se habilita, se compactan los atributos configurables creados por select(). Para los tipos de lista, la representación plana es una lista que contiene cada valor del mapa de selección exactamente una vez. Los tipos escalares se acoplan a nulos.
Etiquetas:build_file_semantics
--[no]proto:include_attribute_source_aspects
valor predeterminado: "false"-
Propaga el campo proto source_aspect_name de cada Atributo con el aspecto de origen del que provino (si no lo hizo, una cadena vacía).
Etiquetas:terminal_output
--[no]proto:include_synthetic_attribute_hash
valor predeterminado: "false"-
Indica si se debe calcular y propagar el atributo $internal_attr_hash o no.
Etiquetas:terminal_output
--[no]proto:instantiation_stack
valor 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
- El valor predeterminado de
--[no]proto:locations
es "true" (verdadero). - Indica si se debe generar información de ubicación en el resultado de proto.
Etiquetas:terminal_output
- La configuración predeterminada de
--proto:output_rule_attrs=<comma-separated list of options>
es "todos" -
Lista de atributos separados por comas para incluir en el resultado. La configuración predeterminada es todos los atributos. Se establece como una cadena vacía para no generar ningún atributo. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]proto:rule_inputs_and_outputs
es "true" (verdadero). -
Indica si se deben propagar los campos rule_input y rule_output o no.
Etiquetas:terminal_output
--query_file=<a string>
predeterminado: ""-
Si se configura, la consulta leerá la consulta desde el archivo que se menciona aquí, en lugar de hacerlo desde la línea de comandos. Es un error especificar un archivo aquí, así como una consulta de línea de comandos.
Etiquetas:changes_inputs
--[no]relative_locations
valor predeterminado: "false"-
Si es "true", la ubicación de los archivos BUILD en los resultados xml y proto será relativa. De forma predeterminada, el resultado de la ubicación es una ruta de acceso absoluta y no será coherente en todas las máquinas. Puedes configurar esta opción como verdadera para obtener un resultado coherente en todas las máquinas.
Etiquetas:terminal_output
--[no]skyframe_state
valor predeterminado: "false"-
Sin realizar un análisis adicional, vuelca el Action Graph actual de Skyframe. Nota: Actualmente, no se admite especificar un destino con --skyframe_state. Esta marca solo está disponible con --output=proto o --output=textproto.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]tool_deps
es "true" (verdadero). -
Consulta: Si se inhabilita, las dependencias de la "configuración de ejecución" no se incluirán en el gráfico de dependencias en el que opera la consulta. Un perímetro de dependencia de 'ejecución de configuración', como el de cualquier regla 'proto_library' al compilador de protocolos, generalmente apunta a una herramienta ejecutada durante la compilación en lugar de a una parte del mismo programa 'target'.
Cquery: Si se inhabilita, filtra todos los destinos configurados que cruzan una transición de ejecución del objetivo de nivel superior que descubrió este objetivo configurado. Esto significa que si el objetivo de nivel superior está en la configuración de destino, solo se mostrarán los objetivos configurados también en esa configuración. Si el objetivo de nivel superior está en la configuración de ejecución, solo se mostrarán los objetivos configurados de ejecución. Esta opción NO excluirá las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
--universe_scope=<comma-separated list of options>
predeterminado: ""-
Un conjunto de patrones de objetivo separados por comas (aditivos y sustractivos). 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.
Para cquery, la entrada a esta opción son los destinos en los que se compilan todas las respuestas, por lo que esta opción puede afectar las configuraciones y las transiciones. Si no se especifica esta opción, se supone que los destinos de nivel superior son los destinos analizados a partir de la expresión de consulta. Nota: En el caso de cquery, no especificar esta opción puede provocar que la compilación falle si los objetivos analizados a partir 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
valor predeterminado: "false"-
Filtra ProgramJar de ProGuard para quitar cualquier clase que también esté presente en LibraryJar.
Etiquetas:action_command_lines
- El valor predeterminado de
--[no]experimental_inmemory_dotd_files
es "true" (verdadero). -
Si se habilita, los archivos .d de C++ se pasarán directamente en la memoria desde los nodos de compilación remota, en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
yexperimental
- El valor predeterminado de
--[no]experimental_inmemory_jdeps_files
es "true" (verdadero). -
Si se habilita esta opción, los archivos de dependencia (.jdeps) generados a partir de compilaciones de Java se pasarán directamente a la memoria desde los nodos de compilación remota, en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
yexperimental
--[no]experimental_retain_test_configuration_across_testonly
valor predeterminado: "false"-
Cuando se habilita, --trim_test_configuration no recortará la configuración de prueba de las reglas marcadas como testonly=1. Esto tiene como objetivo reducir los problemas de conflicto de acciones cuando las reglas que no son de prueba dependen de las reglas cc_test. No tiene efecto si --trim_test_configuration es falso.
Etiquetas:loading_and_analysis
,loses_incremental_state
--[no]experimental_starlark_cc_import
valor predeterminado: "false"-
Si se habilita, se puede usar la versión de cc_import de Starlark.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_unsupported_and_brittle_include_scanning
valor predeterminado: "false"-
Determina si se deben reducir las entradas a la compilación de C/C++ analizando #include líneas de los archivos de entrada. Esto puede mejorar el rendimiento y la incrementalidad disminuyendo el tamaño de los árboles de entrada de la compilación. Sin embargo, también puede romper compilaciones porque el escáner de inclusión no implementa por completo la semántica del preprocesador de C. En particular, no comprende las directivas #include dinámicas e ignora la lógica condicional del preprocesador. Úsala bajo tu propia responsabilidad. Se cerrarán todos los problemas relacionados con esta marca que se presenten.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
- El valor predeterminado de
--[no]incremental_dexing
es "true" (verdadero). -
Realiza la mayor parte del trabajo para la conversión a DEX por separado para cada archivo Jar.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- El valor predeterminado de
--[no]objc_use_dotd_pruning
es "true" (verdadero). -
Si se configura, se usarán los archivos .d emitidos por Clang para reducir el conjunto de entradas que se pasaron a compilaciones de objc.
Etiquetas:changes_inputs
,loading_and_analysis
--[no]process_headers_in_dependencies
valor 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
- El valor predeterminado de
--[no]trim_test_configuration
es "true" (verdadero). -
Cuando se habilita, las opciones relacionadas con pruebas se borrarán en el nivel superior de la compilación. Cuando esta marca está activa, las pruebas no se pueden compilar como dependencias de reglas que no sean de prueba, pero los cambios en las opciones relacionadas con pruebas no provocarán que las reglas que no son de prueba se vuelvan a analizar.
Etiquetas:loading_and_analysis
,loses_incremental_state
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
predeterminado: "-.*"-
Imprime información de depuración durante la resolución de la cadena de herramientas. La marca toma una regex, que se compara con tipos de cadenas de herramientas y objetivos específicos para ver cuál depurar. Varias regex se pueden separar por comas y, luego, cada regex se verifica por separado. Nota: El resultado de esta marca es muy complejo y probablemente solo sea útil para los expertos en la resolución de la cadena de herramientas.
Etiquetas:terminal_output
- Opciones que especifican o modifican una entrada genérica a un comando de Bazel que no se incluye en otras categorías:
- Se acumulan
--flag_alias=<a 'name=value' flag alias>
usos múltiples - Establece un nombre abreviado para una marca de Starlark. Toma un solo par clave-valor con el formato "<key>=<value>" como argumento.
Etiquetas:changes_inputs
--[no]incompatible_default_to_explicit_init_py
valor 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. De manera precisa, cuando un destino py_binary o py_test tiene legacy_create_init configurado como "auto" (predeterminado), se trata como falso si y solo si esta marca está configurada. Consulta https://github.com/bazelbuild/bazel/issues/10076.
Etiquetas:affects_outputs
,incompatible_change
- El valor predeterminado de
--[no]incompatible_py2_outputs_are_suffixed
es "true" (verdadero). -
Si es verdadero, los destinos compilados en la configuración de Python 2 aparecerán bajo 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 los 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
- El valor predeterminado de
--[no]incompatible_py3_is_default
es "true" (verdadero). -
Si el valor es true, los destinos `py_binary` y `py_test` que no establecen su atributo `python_version` (o `default_python_version`) se establecerán de forma predeterminada como PY3 en lugar de PY2. Si estableces esta marca, también se recomienda configurar `--incompatible_py2_outputs_are_sufsolution`.
Etiquetas:loading_and_analysis
,affects_outputs
,incompatible_change
- El valor predeterminado de
--[no]incompatible_use_python_toolchains
es "true" (verdadero). -
Si se configura como verdadera, las reglas nativas ejecutables de Python usarán el entorno de ejecución de Python especificado por la cadena de herramientas de Python, en lugar del entorno de ejecución proporcionado por marcas heredadas como --python_top.
Etiquetas:loading_and_analysis
,incompatible_change
- Configuración predeterminada de
--python_version=<PY2 or PY3>
: ver descripción -
Es el modo de versión principal de Python, que puede ser “PY2” o “PY3”. Ten en cuenta que los objetivos “py_binary” y “py_test” anulan esto (incluso si no especifican explícitamente una versión), por lo que, por lo general, no hay muchas razones para proporcionar esta marca.
Etiquetas:loading_and_analysis
,affects_outputs
- Opciones varias, que no están categorizadas:
--[no]cache_test_results
[-t
] predeterminado: "auto"- Si se configura como "auto", Bazel vuelve a ejecutar una prueba solo si (1) Bazel detecta cambios en la prueba o sus dependencias, (2) la prueba se marca como externa, (3) se solicitaron varias ejecuciones de prueba con --runs_per_test o(4) si la prueba falló anteriormente. Si se configura como “sí”, Bazel almacena en caché todos los resultados de la prueba, excepto las que se marcaron como externas. Si se configura como “no”, Bazel no almacena en caché ningún resultado de prueba.
--[no]experimental_cancel_concurrent_tests
valor predeterminado: "false"-
Si es "true", el Blaze cancelará las pruebas que se ejecutan de forma simultánea en la primera ejecución exitosa. Esto solo es útil en combinación con --runs_per_test_detects_flakes.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_fetch_all_coverage_outputs
valor 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
valor predeterminado: "false"-
Si es "true", la cobertura de Clang generará un informe de LCOV.
Etiquetas:affects_outputs
,loading_and_analysis
- El valor predeterminado de
--[no]experimental_j2objc_header_map
es "true" (verdadero). - Indica si se debe generar el mapa de encabezados de J2ObjC en paralelo de la transpilación de J2ObjC.
--[no]experimental_j2objc_shorter_header_path
valor predeterminado: "false"-
Indica si se debe generar con una ruta de encabezado más corta (usa "_ios" en lugar de "_j2objc").
Etiquetas:affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
predeterminado: "javabuilder"- Habilita rutas de clase reducidas para compilaciones de Java.
--[no]experimental_limit_android_lint_to_android_constrained_java
valor predeterminado: "false"- Limita --experimental_run_android_lint_on_java_rules a bibliotecas compatibles con Android.
Etiquetas:affects_outputs
--[no]experimental_run_android_lint_on_java_rules
valor predeterminado: "false"- Determina si se deben validar las fuentes java_*.
Etiquetas:affects_outputs
--[no]explicit_java_test_deps
valor predeterminado: "false"- Especifica de forma explícita una dependencia a JUnit o Hamcrest en una java_test, en lugar de obtenerla accidentalmente desde las dependencias de TestRunner. Por el momento, solo funciona para Bazel.
- Configuración predeterminada de
--host_java_launcher=<a build target label>
: ver descripción - El Selector de Java utilizado por las herramientas que se ejecutan durante una compilación.
- Se acumulan
--host_javacopt=<a string>
usos múltiples - Son opciones adicionales para pasar a javac cuando se compilan herramientas que se ejecutan durante una compilación.
- Se acumulan
--host_jvmopt=<a string>
usos múltiples - Opciones adicionales para pasar a la VM de Java cuando se compilan herramientas que se ejecutan durante la compilación. Estas opciones se agregarán a las opciones de inicio de la VM de cada destino java_binary.
- El valor predeterminado de
--[no]incompatible_check_sharding_support
es "true" (verdadero). -
Si es verdadero, Bazel fallará una prueba fragmentada si el ejecutor de pruebas no indica que admite la fragmentación tocando el archivo en la ruta de acceso en TEST_SHARD_STATUS_FILE. Si es falso, un ejecutor de pruebas que no admita la fragmentación hará que se ejecuten todas las pruebas en cada fragmento.
Etiquetas:incompatible_change
- El valor predeterminado de
--[no]incompatible_exclusive_test_sandboxed
es "true" (verdadero). -
Si es verdadero, se ejecutarán pruebas exclusivas con la estrategia de zona de pruebas. Agrega la etiqueta “local” para forzar una ejecución de prueba exclusiva de forma local.
Etiquetas:incompatible_change
--[no]incompatible_strict_action_env
valor predeterminado: "false"-
Si es verdadero, Bazel usa un entorno con un valor estático para PATH y no hereda LD_LIBRARY_PATH. Usa --action_env=ENV_VARIABLE si deseas heredar variables de entorno específicas del cliente, pero ten en cuenta que esto puede evitar el almacenamiento en caché entre usuarios si se usa una caché compartida.
Etiquetas:loading_and_analysis
,incompatible_change
- Se acumulan
--j2objc_translation_flags=<comma-separated list of options>
usos múltiples - Opciones adicionales para pasar a la herramienta J2ObjC.
--java_debug
-
Hace que la máquina virtual Java de una prueba de Java espere una conexión de un depurador compatible con JDWP (como jdb) antes de comenzar la prueba. Insinúa -test_output=streamed.
Se expande a:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
- El valor predeterminado de
--[no]java_deps
es "true" (verdadero). - Genera información de dependencias (por ahora, la ruta de clase en tiempo de compilación) por destino de Java.
- El valor predeterminado de
--[no]java_header_compilation
es "true" (verdadero). - Compila ijars directamente desde la fuente.
--java_language_version=<a string>
predeterminado: ""- La versión del lenguaje Java
- Configuración predeterminada de
--java_launcher=<a build target label>
: ver descripción - El Selector de Java que se usa cuando se compilan objetos binarios de Java. Si esta marca se establece en una cadena vacía, se usa el selector de JDK. El atributo "launcher" anula esta marca.
--java_runtime_version=<a string>
valor predeterminado: "local_jdk"- La versión del entorno de ejecución de Java
- Se acumulan
--javacopt=<a string>
usos múltiples - Opciones adicionales para pasar a javac.
- Se acumulan
--jvmopt=<a string>
usos múltiples - Opciones adicionales para pasar a la VM de Java. Estas opciones se agregarán a las opciones de inicio de la VM de cada destino java_binary.
- Configuración predeterminada de
--legacy_main_dex_list_generator=<a build target label>
: ver descripción - Especifica un objeto binario que se usará para generar la lista de clases que deben estar en el DEX principal cuando se compila multidex heredado.
- Configuración predeterminada de
--optimizing_dexer=<a build target label>
: ver descripción - Especifica un objeto binario que se usará para realizar la conversión a DEX sin fragmentar.
- Se acumulan
--plugin=<a build target label>
usos múltiples - Complementos para usar en la compilación. Actualmente, funciona con java_plugin.
- Configuración predeterminada de
--proguard_top=<a build target label>
: ver descripción - Especifica qué versión de ProGuard se usará para quitar código cuando se compile un objeto binario de Java.
--proto_compiler=<a build target label>
predeterminado: "@bazel_tools//tools/proto:protoc"-
Es la etiqueta del compilador de protocolos.
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 j2objc
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
valor 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>
valor 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
--protocopt=<a string>
usos múltiples -
Son opciones adicionales para pasar al compilador de protobuf.
Etiquetas:affects_outputs
--[no]runs_per_test_detects_flakes
valor predeterminado: "false"- Si es verdadero, cualquier fragmento en el que al menos una ejecución o un intento se complete y al menos uno falle tenga un estado FLAKY.
- Configuración predeterminada de
--shell_executable=<a path>
: ver descripción -
Ruta de acceso absoluta al shell ejecutable para que lo use Bazel. Si no se configura, pero la variable de entorno BAZEL_SH está configurada en la primera invocación de Bazel (que inicia un servidor de Bazel), Bazel la usa. Si no se establece ninguno, Bazel usa una ruta de acceso predeterminada hard-coded 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 el uso de una shell que no es compatible con Bash puede provocar fallas de compilación o de tiempo de ejecución de los objetos binarios generados.
Etiquetas:loading_and_analysis
- Se acumulan
--test_arg=<a string>
usos múltiples - Especifica 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 recibirá argumentos idénticos. Solo lo usa el comando “bazel test”.
- Configuración predeterminada de
--test_filter=<a string>
: ver descripción - Especifica un filtro para reenviar al framework de pruebas. Se usa para limitar la ejecución de pruebas. Ten en cuenta que esto no afecta los destinos que se compilan.
--test_result_expiration=<an integer>
valor predeterminado: "-1"- Esta opción dejó de estar disponible y no tiene efecto.
--[no]test_runner_fail_fast
valor predeterminado: "false"- Reenvía la opción de falla rápida al ejecutor de pruebas. El ejecutor de pruebas debe detener la ejecución en la primera falla.
- Valor predeterminado de
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>
: "explícito" - Especifica una estrategia para la fragmentación de pruebas: "explícito" para usar solo la fragmentación si está presente el atributo de COMPILACIÓN "shard_count". “inhabilitado” para no usar nunca la fragmentación de pruebas. "forced=k" permite aplicar "k" fragmentos para las pruebas, sin importar el atributo de BUILD "shard_count".
--tool_java_language_version=<a string>
predeterminado: ""- La versión del lenguaje Java que se usa para ejecutar las herramientas que se necesitan 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
- El valor predeterminado de
--[no]use_ijars
es "true" (verdadero). - Si se habilita, esta opción hace que la compilación de Java use archivos jar de la interfaz. Esto dará como resultado una compilación incremental más rápida, pero los mensajes de error pueden ser diferentes.
Opciones de compilación
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Más lugares donde buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
valor predeterminado: "false"-
Si se configura, la caché del repositorio vinculará el archivo de forma fija en caso de un acierto de caché, en lugar de copiar. Esto sirve para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Usa este factor para escalar todos los tiempos de espera en las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que sean 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 para descargas de http.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--http_connector_retry_max_timeout=<An immutable length of time.>
: "0 s" -
Es el tiempo de espera máximo para los reintentos de descarga de HTTP. Con el valor 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 descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación en caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché; de lo contrario, se usa el valor predeterminado “<output_user_root>/cache/repos/v1”
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
valor predeterminado: "false"-
Si se establece esta configuración, no se permitirá la descarga con ="{.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no está completamente deshabilitado; ="{.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
valor predeterminado: "false"-
No realices la compilación, solo verifica si está actualizada. Si todos los destinos están actualizados, la compilación se completa de forma correcta. Si es necesario ejecutar algún paso, se informa un error y la compilación falla.
Etiquetas:execution
--dynamic_local_execution_delay=<an integer>
predeterminado: "1000"-
¿Cuántos milisegundos debe retrasarse 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
--dynamic_local_strategy=<a '[name=]value1[,..,valueN]' assignment>
usos múltiples -
Las estrategias locales, de modo que se usen para el valor mnemotécnico específico; se utiliza la primera estrategia aplicable. Por ejemplo, `worker,sandboxed` ejecuta acciones que admiten trabajadores persistentes mediante la estrategia de trabajador y todas las demás usan la estrategia de zona de pruebas. Si no se proporciona ningún valor mnemotécnico, se usa la lista de estrategias como resguardo para todos los mnemotécnicos. La lista de resguardo predeterminada es `worker,sandboxed` o`worker,sandboxed,standalone` si se configura `experimental_local_lockfree_output`. Toma [mnemonic=]local_strategy[,local_strategy,...]
Etiquetas:execution
,host_machine_resource_optimizations
- Se acumulan
--dynamic_remote_strategy=<a '[name=]value1[,..,valueN]' assignment>
usos múltiples -
Las estrategias remotas, que se usarán para el valor mnemotécnico específico; se utilizará la primera estrategia aplicable. Si no se proporciona ningún valor mnemotécnico, se usa la lista de estrategias como resguardo para todos los mnemotécnicos. La lista de resguardo predeterminada es “remote”, por lo que, por lo general, esta marca no necesita configurarse 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 debería usar para ejecutar una acción de zona de pruebas cuando se use la estrategia de Docker. La acción en sí no tiene un atributo de imagen de contenedor en su remote_execution_properties en la descripción de la plataforma. El valor de esta marca se pasa literalmente a “docker run”, por lo que admite la misma sintaxis y los mismos mecanismos que Docker.
Etiquetas:execution
- El valor predeterminado de
--[no]experimental_docker_use_customized_images
es "true" (verdadero). -
Si está habilitada, inyecta el UID y GID del usuario actual en la imagen de Docker antes de usarla. Esto es obligatorio si tus compilaciones 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 si la función de personalización automática de imágenes no funciona en tu caso o si sabes que no la necesitas.
Etiquetas:execution
- El valor predeterminado de
--[no]experimental_dynamic_exclude_tools
es "true" (verdadero). -
Cuando se configuran, los objetivos que se compilan "para la herramienta" no están sujetos a ejecución dinámica. Es muy poco probable que esos objetivos se creen de forma incremental y, por lo tanto, no vale la pena invertir ciclos locales en ellos.
Etiquetas:execution
,host_machine_resource_optimizations
--experimental_dynamic_local_load_factor=<a double>
predeterminado: "0"-
Controla cuánta carga de la ejecución dinámica se debe colocar en la máquina local. Esta marca ajusta la cantidad de acciones en la ejecución dinámica que programaremos de forma simultánea. Se basa en la cantidad de CPU que Blaze considera que está disponible y se puede controlar con la función experimental --local_cpu_resources.
Si esta marca es 0, todas las acciones se programan de forma local de inmediato. Si es > 0, la cantidad de acciones programadas de forma local está limitada por la cantidad de CPU disponibles. Si es inferior a 1, el factor de carga se usa para reducir la cantidad de acciones programadas localmente cuando la cantidad de acciones en espera para programarse es alta. Esto disminuye la carga en la máquina local en el caso de compilación limpio, 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 >0, el tiempo en que una acción ejecutada de forma dinámica solo debe ejecutarse de forma remota antes de que prioricemos su ejecución local para evitar tiempos de espera remotos. Es posible que se oculten algunos problemas en el sistema de ejecución remota. No actives esta función sin supervisar los problemas de ejecución remota.
Etiquetas:execution
,host_machine_resource_optimizations
--[no]experimental_enable_docker_sandbox
valor 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 el valor es 0, borra los árboles de la zona de pruebas tan pronto como se complete una acción (y se retrase la finalización de la acción). Si es mayor que cero, ejecuta la eliminación de esos tres en un grupo de subprocesos asíncrono que tenga tamaño 1 cuando la compilación esté en ejecución y aumente al 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 al directorio de cgroups.
Etiquetas:execution
--[no]experimental_shrink_worker_pool
valor predeterminado: "false"-
Si se habilita, podría reducir el grupo de trabajadores si la presión de la memoria de estos es alta. Esta marca solo funciona cuando la marca experimental_total_worker_memory_limit_mb está habilitada.
Etiquetas:execution
,host_machine_resource_optimizations
- El valor predeterminado de
--[no]experimental_split_xml_generation
es "true" (verdadero). -
Si se configura esta marca y una acción de prueba no genera un archivo test.xml, Bazel usa una acción separada para generar un archivo test.xml ficticio que contenga el registro de prueba. De lo contrario, Bazel generará un archivo 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 trabajadores inactivos, es posible que se cierren 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
valor predeterminado: "false"-
Si se establece como verdadera, no actives la raíz, sino solo lo que se proporciona con sandbox_add_mount_pair. Los archivos de entrada se vincularán directamente a la zona de pruebas en lugar de se vincularán con un symlink desde la zona de pruebas. Si los archivos de entrada de acciones se encuentran en un sistema de archivos diferente del de la zona de pruebas, los archivos de entrada se copiarán en su lugar.
Etiquetas:execution
- El valor predeterminado de
--[no]experimental_use_semaphore_for_jobs
es "true" (verdadero). -
Si se configura como true, también usa el semáforo para limitar la cantidad de trabajos simultáneos.
Etiquetas:host_machine_resource_optimizations
,execution
--[no]experimental_use_windows_sandbox
valor predeterminado: "false"- Usa la zona de pruebas de Windows para ejecutar acciones. Si la respuesta es "sí", el objeto binario que proporciona --experimental_windows_sandbox_path debe ser válido y corresponder a una versión compatible de sandboxfs. Si es "auto", es posible que el objeto binario falte o no sea compatible.
Etiquetas:execution
--experimental_windows_sandbox_path=<a string>
predeterminado: "BazelSandbox.exe"-
Ruta de acceso al objeto binario de la zona de pruebas de Windows que se usará cuando --experimental_use_windows_sandbox sea verdadero. Si es un nombre simple, usa el primer objeto binario con ese nombre que se encuentra en la ruta de acceso (PATH).
Etiquetas:execution
- Configuración predeterminada de
--experimental_worker_allowlist=<comma-separated set of options>
: ver descripción -
Si no está vacío, solo permite el uso de trabajadores persistentes con el valor mnemotécnico de la clave de trabajador correspondiente.
Etiquetas:execution
,host_machine_resource_optimizations
- El valor predeterminado de
--[no]experimental_worker_as_resource
es "true" (verdadero). -
No-ops, se quitará pronto.
Etiquetas:no_op
--[no]experimental_worker_cancellation
valor predeterminado: "false"-
Si se habilita, Bazel puede enviar solicitudes de cancelación a los trabajadores compatibles.
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 cierren los trabajadores si su uso de memoria supera el límite. Si no se usa junto con la ejecución dinámica y con `--experimental_dynamic_ignore_local_signals=9`, es posible que se bloquee tu compilación.
Etiquetas:execution
,host_machine_resource_optimizations
- Valor predeterminado de
--experimental_worker_metrics_poll_interval=<An immutable length of time.>
: "5 s" -
El intervalo entre la recopilación de las métricas de trabajador y los intentos de expulsiones. No puede ser inferior a 1 s por motivos de rendimiento.
Etiquetas:execution
,host_machine_resource_optimizations
--[no]experimental_worker_multiplex_sandboxing
valor predeterminado: "false"-
Si se habilita, los trabajadores multiplex se someterán a una zona de pruebas y se usará un directorio de zona de pruebas independiente para cada solicitud de trabajo. Solo los trabajadores que tengan el requisito de ejecución “supports-multiplex-sandboxing” serán de zona de pruebas.
Etiquetas:execution
--[no]experimental_worker_sandbox_hardening
valor predeterminado: "false"-
Si se habilita, los trabajadores se ejecutan en una zona de pruebas endurecida si la implementación lo permite.
Etiquetas:execution
--[no]experimental_worker_strict_flagfiles
valor predeterminado: "false"-
Si se habilita, los argumentos de acciones para trabajadores que no sigan la especificación del trabajador causarán un error. Los argumentos de los trabajadores 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"-
Indica el porcentaje de espacio ocupado (0-100) por encima del cual GcThrashingDetector considera los eventos de presión de la memoria en función de sus límites (--gc_thrashing_limits). Si se configura en 100, GcThrashingDetector se inhabilita.
Etiquetas:host_machine_resource_optimizations
--genrule_strategy=<comma-separated list of options>
predeterminado: ""-
Especifica cómo ejecutar genrules. Esta marca se eliminará gradualmente. En su lugar, usa --spawn_strategy=<value> para controlar todas las acciones o --strategy=Genrule=<value> para controlar solo genrules.
Etiquetas:execution
- Se acumulan
--high_priority_workers=<a string>
usos múltiples -
No-ops, se quitará pronto.
Etiquetas:execution
- El valor predeterminado de
--[no]incompatible_remote_dangling_symlinks
es "true" (verdadero). -
Si se configura como verdadera, los symlinks subidos a una caché remota o de disco pueden colgarse.
Etiquetas:execution
,incompatible_change
- El valor predeterminado de
--[no]incompatible_remote_symlinks
es "true" (verdadero). -
Si se configura como verdadera, Bazel siempre subirá symlinks, como tales, a una caché remota o de disco. De lo contrario, se subirán solo esos vínculos simbólicos relativos (y solo aquellos) como el archivo o directorio al que apuntan.
Etiquetas:execution
,incompatible_change
- El valor predeterminado de
--[no]incompatible_sandbox_hermetic_tmp
es "true" (verdadero). -
Si se configura como verdadera, 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. Utiliza --sandbox_add_mount_pair=/tmp para seguir viendo el /tmp del host en todas las zonas de pruebas.
Etiquetas:execution
--[no]internal_spawn_scheduler
valor predeterminado: "false"-
Es una opción de marcador de posición para que podamos determinar en el Blaze si el programador de generación está habilitado.
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"-
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 seguido 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 en función de 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 el objetivo que falló y aquellos que dependen de él no se pueden analizar, otros requisitos previos de estos objetivos pueden serlo.
Etiquetas:eagerness_to_exit
- Valor predeterminado de
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "auto" -
Cantidad de subprocesos paralelos que se usarán en la fase de carga o análisis. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguido 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
- El valor predeterminado de
--[no]reuse_sandbox_directories
es "true" (verdadero). -
Si se establece como verdadera, los directorios que utiliza la ejecución de entorno aislado que no son trabajadores 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 de zona de pruebas debajo de esta ruta de acceso. Especifica una ruta de acceso en tmpfs (como /run/shm) para mejorar mucho el rendimiento cuando tus compilaciones y pruebas tengan muchos archivos de entrada. Nota: Necesitas suficiente RAM y espacio libre en los tmpfs para contener los archivos intermedios y de salida generados por la ejecución de acciones.
Etiquetas:host_machine_resource_optimizations
,execution
--[no]sandbox_explicit_pseudoterminal
valor predeterminado: "false"-
Habilita de forma explícita la creación de seudoterminales para acciones de zona de pruebas. Algunas distribuciones de Linux requieren configurar el ID de grupo del proceso en “tty” dentro de la zona de pruebas para que funcionen los pseudoterminales. Si esto está causando problemas, esta marca se puede inhabilitar para permitir que se usen otros grupos.
Etiquetas:execution
- Se acumulan
--sandbox_tmpfs_path=<an absolute path>
usos múltiples -
Para acciones de zona de pruebas, activa un directorio vacío que admita escritura en esta ruta de acceso absoluta (si la implementación de la zona de pruebas lo admite, se ignora de lo contrario).
Etiquetas:host_machine_resource_optimizations
,execution
--[no]skip_incompatible_explicit_targets
valor 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 dichos destinos genera un error, pero se omiten en silencio cuando esta opción está habilitada. 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 generación de forma predeterminada. Acepta una lista de estrategias separadas por comas de mayor a menor prioridad. Para cada acción, Bazel elige la estrategia con la prioridad más alta que puede ejecutar la acción. El valor predeterminado es “remote,worker,sandboxed,local”. Para obtener más información, consulta https://blog.bazel.build/2019/06/19/list-strategy.html.
Etiquetas:execution
- Se acumulan
--strategy=<a '[name=]value1[,..,valueN]' assignment>
usos múltiples -
Especifica cómo distribuir la compilación de otras acciones de generación. Acepta una lista de estrategias separadas por comas de mayor a menor prioridad. Para cada acción, Bazel elige la estrategia con la prioridad más alta que puede ejecutar la acción. El valor predeterminado es “remote,worker,sandboxed,local”. Esta marca anula los valores establecidos por --spawn_strategy (y --genrule_strategy si se utiliza con Genrule mnemónico). Para obtener más información, consulta https://blog.bazel.build/2019/06/19/list-strategy.html.
Etiquetas:execution
- Se acumulan
--strategy_regexp=<a '<RegexFilter>=value[,value]' assignment>
usos múltiples -
Anula la estrategia de generación que se debe usar para ejecutar acciones de generación que tengan descripciones que coincidan con un regex_filter determinado. Consulta --per_file_copt para obtener detalles sobre la coincidencia deregex_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 que se deben 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á "Compila //foo/bar/baz" con la estrategia "local", pero revertir el orden ejecutaría "sandboxed".
Etiquetas:execution
- Se acumulan
--worker_extra_flag=<a 'name=value' assignment>
usos múltiples -
Marcas de comandos adicionales que se pasarán a los procesos trabajadores, además de --persistent_worker, con claves mnemológicas (p.ej., --worker_extra_flag=Javac=--debug.
Etiquetas:execution
,host_machine_resource_optimizations
- Se acumulan
--worker_max_instances=<[name=]value, where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
usos múltiples -
Cuántas instancias de cada tipo de trabajador persistente se pueden iniciar si usas la estrategia de “worker”. Se puede especificar como [name=value] para proporcionar un valor diferente por nombre nemotécnico. El límite se basa en las claves de trabajador, que se diferencian según el sistema mnemotécnico, pero también en las marcas de inicio y el entorno, por lo que en algunos casos puede haber más trabajadores por mnemotécnica de los que especifica esta marca. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguido 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 los mnemotécnicos no especificados.
Etiquetas:execution
,host_machine_resource_optimizations
- Se acumulan
--worker_max_multiplex_instances=<[name=]value, where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
usos múltiples -
La cantidad de WorkRequests que puede recibir un proceso de trabajador multiplex en paralelo si usas la estrategia "worker" con --worker_multiplex. Se puede especificar como [name=value] para proporcionar un valor diferente por nombre nemotécnico. El límite se basa en las claves de trabajador, que se diferencian según el sistema mnemotécnico, pero también en las marcas de inicio y el entorno, por lo que en algunos casos puede haber más trabajadores por mnemotécnica de los que especifica esta marca. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguido 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 los mnemotécnicos no especificados.
Etiquetas:execution
,host_machine_resource_optimizations
- El valor predeterminado de
--[no]worker_multiplex
es "true" (verdadero). -
Si se habilita, los trabajadores usarán la multiplexación si lo admiten.
Etiquetas:execution
,host_machine_resource_optimizations
--[no]worker_quit_after_build
valor predeterminado: "false"-
Si se habilita, todos los trabajadores salen después de que se completa una compilación.
Etiquetas:execution
,host_machine_resource_optimizations
--[no]worker_sandboxing
valor predeterminado: "false"-
Si se habilita, los trabajadores se ejecutarán en un entorno de zona de pruebas.
Etiquetas:execution
--[no]worker_verbose
valor predeterminado: "false"- Si se habilita, muestra mensajes detallados cuando se inician los trabajadores, cierran, ...
- Opciones que configuran la cadena de herramientas usada para ejecutar la acción:
--target_platform_fallback=<a string>
predeterminado: ""-
Esta opción dejó de estar disponible y no tiene efecto.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
- Opciones que controlan el resultado del comando:
- El valor predeterminado de
--[no]build
es "true" (verdadero). -
Ejecuta la compilación; este es el comportamiento habitual. La especificación de --nobuild hace que la compilación se detenga antes de ejecutar las acciones de compilación y muestra cero si las fases de análisis y carga del paquete se completaron correctamente. Este modo es útil para probar esas fases.
Etiquetas:execution
,affects_outputs
--[no]experimental_use_validation_aspect
valor predeterminado: "false"-
Determina si se deben ejecutar acciones de validación con el aspecto (para el paralelismo con pruebas).
Etiquetas:execution
,affects_outputs
- Se acumulan
--output_groups=<comma-separated list of options>
usos múltiples -
Una lista de nombres de grupos de salida separados por comas, cada uno de los cuales puede ir con el prefijo + o -. Un grupo con prefijo + se agrega al conjunto predeterminado de grupos de salida, mientras que uno con prefijo - se quita del conjunto predeterminado. Si al menos un grupo no tiene prefijo, se omite el conjunto predeterminado de grupos de salida. Por ejemplo, --output_groups=+foo,+bar 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
- El valor predeterminado de
--[no]run_validations
es "true" (verdadero). -
Determina 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
--aspects=<comma-separated list of options>
usos múltiples - Lista de aspectos separados por coma que se aplicarán a los objetivos de nivel superior. En la lista, si Aspecto some_aspect especifica los proveedores de aspecto requeridos mediante 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 a algunos de los proveedores de aspecto requeridos. Además, some_aspect se ejecutará después de todos los aspectos obligatorios especificados por el atributo requirements. 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>
valor predeterminado: "-1"-
Cantidad máxima de archivos abiertos permitida durante la carga del artefacto BEP.
Etiquetas:affects_outputs
- El valor predeterminado de
--[no]experimental_convenience_symlinks
es "normal" -
Esta marca controla cómo se administrarán los symlinks de conveniencia (los que aparecen en el lugar de trabajo después de la compilación). Valores posibles: normal (predeterminado): Se creará o borrará cada tipo de symlink de conveniencia, según lo determine la compilación.
clean: Todos los symlinks se borrarán incondicionalmente.
ignorar: Los enlaces simbólicos no se verán afectados.
log_only: Genera mensajes de registro como si se pasaran “normales”, pero no realizas ninguna operación de sistema de archivos (útil para las herramientas).
Ten en cuenta que solo pueden verse afectados los symlinks cuyos nombres se generen por el valor actual de --symlink_prefix. Si el prefijo cambia, cualquier symlink preexistente quedará solo.
Etiquetas:affects_outputs
--[no]experimental_convenience_symlinks_bep_event
valor predeterminado: "false"-
Esta marca controla si publicaremos o no el evento de compilaciónConvenienceSymlinksIdentified en BuildEventProtocol. Si el valor es verdadero, BuildEventProtocol tendrá una entrada para convenienciaSymlinksIdentified y enumerará todos los symlinks de conveniencia creados en tu lugar de trabajo. Si es falso, la entrada convenienciaSymlinksIdentified en BuildEventProtocol estará vacía.
Etiquetas:affects_outputs
--remote_download_all
-
Descarga todas las salidas remotas en la máquina local. Esta marca es un alias 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 en 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 configura como “mínima”, no se descarga ningún resultado de compilación remota en la máquina local, excepto los que requieren las acciones locales. Si se configura 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 representa un cuello de botella.
Etiquetas:affects_outputs
--remote_download_symlink_template=<a string>
predeterminado: ""-
En lugar de descargar resultados de compilación remotas en la máquina local, crea vínculos simbólicos. El destino de los vínculos simbólicos puede especificarse con la forma de una cadena de plantilla. Esta string de plantilla puede contener {hash} y {size_bytes} que se expanden al hash del objeto y el tamaño en bytes, respectivamente. Estos vínculos simbólicos pueden apuntar, por ejemplo, a un sistema de archivos FUSE que cargue objetos de CAS a pedido.
Etiquetas:affects_outputs
--remote_download_toplevel
- Solo descarga las salidas remotas de los 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
- Configuración predeterminada de
--symlink_prefix=<a string>
: ver descripción -
Es el prefijo que se antepone 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 medida en la que Bazel aplica de manera estricta entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
--[no]experimental_docker_privileged
valor predeterminado: "false"-
Si se habilita, Bazel pasará la marca --privileged a “docker run” cuando se ejecuten 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
valor predeterminado: "false"-
No-ops
Etiquetas:host_machine_resource_optimizations
,execution
--[no]incompatible_legacy_local_fallback
valor predeterminado: "false"-
Si se configura como verdadera, se habilita el resguardo implícito heredado de la zona de pruebas a la estrategia local. Esta marca eventualmente se establecerá como falsa de forma predeterminada y luego se convertirá en una no-op. En su lugar, usa --strategy, --spawn_strategy o --dynamic_local_strategy para configurar resguardos.
Etiquetas:execution
,incompatible_change
- Se acumulan
--sandbox_add_mount_pair=<a single path or a 'source:target' pair>
usos múltiples -
Agrega un par de rutas de acceso adicional para activarlo en la zona de pruebas.
Etiquetas:execution
- Se acumulan
--sandbox_block_path=<a string>
usos múltiples -
En el caso de las acciones de zona de pruebas, inhabilita el acceso a esta ruta de acceso.
Etiquetas:execution
- El valor predeterminado de
--[no]sandbox_default_allow_network
es "true" (verdadero). -
Permite el acceso a la red de forma predeterminada para las acciones. Es posible que esto no funcione con todas las implementaciones de zonas de pruebas.
Etiquetas:execution
--[no]sandbox_fake_hostname
valor predeterminado: "false"-
Cambia el nombre de host actual a “localhost” para acciones de la zona de pruebas.
Etiquetas:execution
--[no]sandbox_fake_username
valor predeterminado: "false"-
Cambia el nombre de usuario actual a "nadie" para realizar acciones en la zona de pruebas.
Etiquetas:execution
- Se acumulan
--sandbox_writable_path=<a string>
usos múltiples -
Para las acciones de la zona de pruebas, haz que un directorio existente se pueda escribir en ella (si la implementación de la zona de pruebas lo admite; de lo contrario, se debe ignorar).
Etiquetas:execution
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility
valor predeterminado: "false"-
Si es incompatible_enforce_config_setting_visibility=false, esta es una noop. De lo contrario, si la 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
- El valor predeterminado de
--[no]incompatible_depset_for_java_output_source_jars
es "true" (verdadero). -
No-ops
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_enforce_config_setting_visibility
es "true" (verdadero). -
Si es verdadero, aplica restricciones de visibilidad config_setting. Si es falso, cada config_setting es visible para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_new_actions_api
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,incompatible_change
- El valor predeterminado de
--[no]incompatible_visibility_private_attributes_at_definition
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,incompatible_change
- El valor predeterminado de
--[no]separate_aspect_deps
es "true" (verdadero). -
No-op
Etiquetas:no_op
- Opciones que determinan el comportamiento del entorno de pruebas o del ejecutor de pruebas:
--[no]check_tests_up_to_date
valor predeterminado: "false"-
No ejecutes pruebas. Solo tienes que comprobar si están actualizadas. Si todos los resultados están actualizados, las pruebas se completarán de forma correcta. Si es necesario compilar o ejecutar alguna prueba, se informa un error y falla la prueba. Esta opción implica el comportamiento de --check_up_to_date.
Etiquetas:execution
- Se acumulan
--flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once>
usos múltiples -
Cada prueba se volverá a intentar la cantidad especificada de veces, en caso de que falle. Las pruebas que requieren más de un intento para aprobarse se marcan como "FLAKY" en el resumen. Normalmente, el valor especificado es solo un número entero o la cadena "default". Si es un número entero, todas las pruebas se ejecutarán hasta N veces. Si la política es "default", se realizará un solo intento para las pruebas regulares y tres para las pruebas marcadas explícitamente como inestables por su regla (falta=1). Sintaxis alternativa: regex_filter@flaky_test_attempts. Donde flaky_test_attempts es lo anterior y regex_filter significa una lista de patrones de expresiones regulares de inclusión y exclusión (también consulta --runs_per_test). Ejemplo: --flaky_test_attempts=//foo/.*,-//foo/bar/.*@3 disminuye todas las pruebas de //foo/ excepto las que se encuentran en foo/bar tres veces. Esta opción se puede aprobar varias veces. El último argumento pasado que coincida tendrá prioridad. Si no hay coincidencia, el comportamiento es “default” arriba.
Etiquetas:execution
- Valor predeterminado de
--local_test_jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "auto" -
La cantidad máxima de trabajos de prueba locales que se ejecutan de forma simultánea. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguido 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 para que se ejecuten simultáneamente. Establecer este parámetro como mayor que el valor de --jobs no es eficaz.
Etiquetas:execution
- El valor predeterminado de
--[no]test_keep_going
es "true" (verdadero). -
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 son exitosas.
Etiquetas:execution
--test_strategy=<a string>
predeterminado: ""-
Especifica qué estrategia usar cuando se ejecutan pruebas.
Etiquetas:execution
- Configuración predeterminada de
--test_tmpdir=<a path>
: ver descripción - Especifica el directorio temporal base que debe usar "bazel test".
- Opciones relacionadas con el resultado y la semántica de la consulta:
- El valor predeterminado de
--[no]experimental_parallel_aquery_output
es "true" (verdadero). - No-op
- Opciones relacionadas con la semántica y el resultado de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Especificaste las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirá en el gráfico de dependencias resueltas incluso si se declararon de forma privada en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones anteriores harán que la resolución falle. También puedes definir la versión transferida 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
- El valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
es "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 una falla de resolución, “off” para inhabilitar la verificación o “warning” para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas `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 detecte una discrepancia o “error” para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
valor predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
valor predeterminado: "actualizar"-
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son “update” para usar el archivo de bloqueo y actualizarlo si hay cambios; “error” para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o “off” para no leerlo ni escribirlo en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y se recurrirá únicamente a los posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Configuración predeterminada de
--vendor_dir=<a path>
: ver descripción -
Especifica el directorio que debe contener los repositorios externos en modo de proveedor, ya sea con el fin de recuperarlos o usarlos durante la compilación. La ruta de acceso se puede especificar como una ruta de acceso absoluta o una ruta relativa al directorio del lugar de trabajo.
Etiquetas:loading_and_analysis
- Opciones que activan optimizaciones del tiempo de compilación:
--cache_computed_file_digests=<a long integer>
predeterminado: "50000"- Si es mayor que 0, configura Bazel para que almacene en caché los resúmenes de archivos en la memoria en función de sus metadatos, en lugar de volver a calcular los resúmenes del disco cada vez que sean necesarios. Establecerlo en 0 garantiza la precisión, ya que no todos los cambios en el archivo se pueden anotar a partir de los metadatos. Si no es 0, el número indica el tamaño de la caché como la cantidad de resúmenes de archivos que se deben almacenar en caché.
- Configuración predeterminada de
--experimental_dynamic_ignore_local_signals=<a comma-separated list of signal numbers>
: ver descripción -
Toma una lista de números de indicadores del SO. Si se elimina una rama local de ejecución dinámica con cualquiera de estos indicadores, la rama remota podrá finalizar en su lugar. En el caso de los trabajadores persistentes, esto solo afecta los indicadores que finalizan el proceso del trabajador.
Etiquetas:execution
--[no]experimental_enable_skyfocus
valor predeterminado: "false"-
Si es verdadero, habilita el uso de --experimental_working_set para reducir el uso de memoria de Bazel para compilaciones incrementales. Esta función se conoce como Skyfocus.
Etiquetas:host_machine_resource_optimizations
--experimental_working_set=<comma-separated list of options>
predeterminado: ""-
El conjunto de tareas para Skyfocus. Especifica como rutas relativas de raíz de lugar de trabajo separadas por comas. Esta es una marca con estado. Cuando se define un conjunto de trabajo, este se conserva para invocaciones posteriores hasta que se redefine con un conjunto nuevo.
Etiquetas:host_machine_resource_optimizations
--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 fallar Bazel con un OOM. Cada límite se especifica como <period>:<count>, donde el período es una duración y el recuento es un número entero positivo. Si más del --gc_thrashing_threshold por ciento del espacio titular (montón de generación anterior) permanece ocupado después de <count> GC completas consecutivas dentro de <period>, se activa una OOM. Se pueden especificar varios límites separados por comas.
Etiquetas:host_machine_resource_optimizations
- Valor predeterminado de
--local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>
: "HOST_CPUS" -
Establece de forma explícita la cantidad total de núcleos de CPU locales disponibles para que Bazel invierta en acciones de compilación ejecutadas de forma local. Toma un número entero o "HOST_CPUS", opcionalmente seguido de [-|*]<float> (p. ej., HOST_CPUS*.5 para usar la mitad de los núcleos de CPU disponibles). De forma predeterminada, (“HOST_CPUS”), Bazel consultará la configuración del sistema para estimar la cantidad de núcleos de CPU disponibles.
Etiquetas:host_machine_resource_optimizations
- Se acumulan
--local_extra_resources=<a named float, 'name=value'>
usos múltiples -
Establece la cantidad de recursos adicionales disponibles para Bazel. Toma un par de cadena-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 necesarios. Las pruebas pueden declarar la cantidad de recursos adicionales que necesitan usando una etiqueta con el formato “resources:<resoucename>:<amount>”. La CPU, la RAM y los recursos disponibles no se pueden configurar con esta marca.
Etiquetas:host_machine_resource_optimizations
- Valor predeterminado de
--local_ram_resources=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
: "HOST_RAM*.67" -
Establece de forma explícita la cantidad total de RAM del host local (en MB) disponible para que Bazel invierta en acciones de compilación ejecutadas de forma local. Toma un número entero, o “HOST_RAM”, opcionalmente seguido de [-|*]<float> (p. ej., HOST_RAM*.5 para usar la mitad de la RAM disponible). De forma predeterminada, ("HOST_RAM*.67"), Bazel consultará la configuración del sistema para estimar la cantidad de RAM disponible y usará el 67%.
Etiquetas:host_machine_resource_optimizations
- Se acumulan
--local_resources=<a named double, 'name=value', where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
usos múltiples -
Establece la cantidad de recursos disponibles para Bazel. Toma una asignación a un número de punto flotante o a HOST_RAM/HOST_CPUS, opcionalmente seguido de [-|*]<float> (p. ej., memoria=HOST_RAM*.5 para usar la mitad de la RAM disponible). Se pueden usar varias veces para especificar varios tipos de recursos. Bazel limitará las acciones que se ejecutan de forma simultánea según los recursos disponibles y necesarios. Las pruebas pueden declarar la cantidad de recursos que necesitan con la etiqueta del formato “resources:<resource name>:<amount>”. Anula los recursos especificados por --local_{cpu|ram|extra}_resources.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje de montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC completo, descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos de GC completos nunca activarán disminuciones. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de recolección de elementos no utilizados completo y se supere el umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje de montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC menor, descartará el estado temporal innecesario de Skyframe, hasta esta cantidad por invocación. El valor predeterminado es Integer.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos menores de GC nunca activarán disminuciones. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento menor de recolección de elementos no utilizados y se supere el umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje retenido de montón está al menos en este umbral, descartará el estado temporal innecesario de Skyframe. Un ajuste puede permitirte mitigar el impacto de la hiperpaginación de la GC en el tiempo, cuando esta (i) causa el uso de memoria de este estado temporal y (ii) es más costosa que reconstruir el estado cuando es necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--build_event_upload_max_retries=<an integer>
predeterminado: "4"-
Es la cantidad máxima de veces que Bazel debe reintentar subir un evento de compilación.
Etiquetas:bazel_internal_configuration
--[no]debug_spawn_scheduler
valor predeterminado: "false"--[no]experimental_bep_target_summary
valor predeterminado: "false"- Determina si se publican eventos de TargetSummary.
--[no]experimental_build_event_expand_filesets
valor predeterminado: "false"-
Si es verdadero, expande los conjuntos de archivos en el BEP cuando presentes los archivos de salida.
Etiquetas:affects_outputs
--[no]experimental_build_event_fully_resolve_fileset_symlinks
valor predeterminado: "false"-
Si es verdadero, resuelve por completo los symlinks del conjunto de archivos relativos en el BEP cuando se presentan los archivos de salida. Requiere --experimental_build_event_expand_filesets.
Etiquetas:affects_outputs
- Valor predeterminado de
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
: "1 s" -
Retraso inicial y mínimo para los reintentos de retirada exponencial cuando falla la carga de BEP (exponente: 1.6)
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--experimental_build_event_upload_strategy=<a string>
: ver descripción -
Selecciona cómo subir los artefactos a los que se hace referencia en el protocolo de eventos de compilación.
Etiquetas:affects_outputs
- El valor predeterminado de
--[no]experimental_collect_local_sandbox_action_metrics
es "true" (verdadero). -
No-op obsoleto.
Etiquetas:execution
- Configuración predeterminada de
--experimental_command_profile=<cpu, wall, alloc or lock>
: ver descripción - Registra un perfil de grabadora de vuelo de Java mientras dure el comando. Se debe proporcionar uno de los tipos de eventos de generación de perfiles admitidos (cpu, muro, alloc o bloqueo) como argumento. El perfil se escribe en un archivo con el nombre del tipo de evento en el directorio base de salida. La sintaxis y semántica de esta marca podría cambiar en el futuro para admitir tipos de perfil o formatos de salida adicionales; úsala bajo tu responsabilidad.
--[no]experimental_docker_verbose
valor 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
valor predeterminado: "false"-
Si materializas archivos de parámetros, hazlo con escrituras directas en el disco.
Etiquetas:execution
--[no]experimental_record_metrics_for_all_mnemonics
valor predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán estadísticas para todos los mnemotécnicos.
--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
valor predeterminado: "false"-
Determina 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 de comandos de ejecución que podrían contenerlo.
Etiquetas:affects_outputs
- La configuración predeterminada de
--experimental_skyfocus_dump_keys=<none, count or verbose>
es “ninguna” -
Para depurar Skyfocus. Vuelca las SkyKeys enfocadas (raíces, hojas, dependencias enfocadas, rdeps enfocadas).
Etiquetas:terminal_output
--[no]experimental_skyfocus_dump_post_gc_stats
valor predeterminado: "false"-
Para depurar Skyfocus. Si se habilita esta opción, activa la recolección manual antes o después del enfoque para informar reducciones de tamaño de montón. Esto aumentará la latencia de Skyfocus.
Etiquetas:terminal_output
--[no]experimental_stream_log_file_uploads
valor predeterminado: "false"-
Transmite las cargas de archivos de registro directamente al almacenamiento remoto en lugar de escribirlos en el disco.
Etiquetas:affects_outputs
- Configuración predeterminada de
--explain=<a path>
: ver descripción -
Hace que el sistema de compilación explique cada paso ejecutado de la compilación. La explicación se escribe en el archivo de registro especificado.
Etiquetas:affects_outputs
--[no]ignore_unsupported_sandboxing
valor predeterminado: "false"-
No muestres una advertencia cuando este sistema no admita la ejecución de zona de pruebas.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]legacy_important_outputs
es "true" (verdadero). -
Usa esta opción para suprimir la generación del campo relevant_outputs heredado en el evento TargetComplete. Para la integración de Bazel a ResultStore, se requiere relevant_outputs.
Etiquetas:affects_outputs
--[no]materialize_param_files
valor predeterminado: "false"-
Escribe archivos de parámetros intermedios para generar un árbol incluso cuando se usa la ejecución de acciones remotas. Es útil para depurar acciones. Esto está implícito por --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 asignado es -1, se mostrarán todas las opciones modificadas.
Etiquetas:terminal_output
--max_test_output_bytes=<an integer>
valor predeterminado: "-1"-
Especifica el tamaño máximo por registro de prueba que puede emitirse cuando --test_output es “errores” o “todos”. Es útil para evitar abrumar el resultado con un resultado de prueba demasiado ruidoso. 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
- Configuración predeterminada de
--output_filter=<a valid Java regular expression>
: ver descripción -
Solo muestra advertencias y resultados de acciones para las reglas cuyo nombre coincida con la expresión regular proporcionada.
Etiquetas:affects_outputs
--progress_report_interval=<an integer in 0-3600 range>
predeterminado: "0"-
La cantidad de segundos que se debe esperar entre los informes de los trabajos que aún se están ejecutando. El valor predeterminado 0 significa que el primer informe se imprimirá después de 10 segundos; luego, 30 segundos; después de ese progreso, se informa una vez por minuto. Cuando --curses está habilitado, el progreso se informa cada segundo.
Etiquetas:affects_outputs
- Valor predeterminado de
--remote_print_execution_messages=<failure, success or all>
: “error” -
Elige cuándo imprimir mensajes de ejecución remota. Los valores válidos son “failure”, para imprimir solo en caso de errores, “success” para imprimir solo en casos exitosos y “all” para imprimir siempre.
Etiquetas:terminal_output
--[no]sandbox_debug
valor predeterminado: "false"-
Habilita las funciones de depuración para la función de zona de pruebas. Esto incluye dos cosas: en primer lugar, el contenido raíz de la zona de pruebas no se modifica después de una compilación; y en segundo lugar, imprime información adicional de depuración durante la ejecución. Esto puede ayudar a los desarrolladores de reglas de Bazel o Starlark con fallas de depuración debido a archivos de entrada faltantes, etcétera.
Etiquetas:terminal_output
--show_result=<an integer>
predeterminado: "1"-
Muestra los resultados de la compilación. Para cada destino, indica si se actualizó o no y, de ser así, una lista de los archivos de salida que se crearon. Los archivos impresos son cadenas convenientes para copiar y pegar en la shell a fin de ejecutarlos.
Esta opción requiere un argumento de número entero, que es el umbral de objetivos por encima del cual no se imprime la información del resultado. Por lo tanto, cero provoca la supresión del mensaje y MAX_INT hace que la impresión del resultado ocurra siempre. El valor predeterminado es uno.
Si no se compiló nada para un objetivo, es posible que se omitan sus resultados a fin de mantener los resultados por debajo del umbral.
Etiquetas:affects_outputs
--[no]subcommands
[-s
] predeterminado: "false"-
Muestra los subcomandos que se ejecutaron durante una compilación. Marcas relacionadas: --execution_log_json_file, --execution_log_binary_file (para registrar subcomandos en un archivo en un formato compatible con herramientas).
Etiquetas:terminal_output
--test_output=<summary, errors, all or streamed>
valor 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 “stream” para generar los registros de todas las pruebas en tiempo real (esto forzará a que las pruebas se ejecuten de forma local, una a la vez, sin importar el valor de --test_strategy).
Etiquetas:test_runner
,terminal_output
,execution
--test_summary=<short, terse, detailed, none or testcase>
valor predeterminado: "short"-
Especifica el formato deseado del resumen de la prueba. Los valores válidos son “corto” para imprimir información solo sobre las pruebas ejecutadas; “terse”, para imprimir solo información sobre las pruebas fallidas que se ejecutaron, “detallado” para imprimir información detallada sobre casos de prueba con errores, “caso de prueba” para imprimir el resumen en la resolución del caso de prueba, no imprimir información detallada sobre casos de prueba fallidos y “ninguno” para omitir el resumen.
Etiquetas:terminal_output
--[no]verbose_explanations
valor predeterminado: "false"-
Aumenta la verbosidad de las explicaciones emitidas si --explain está habilitado. No tiene ningún efecto si --explain no está habilitado.
Etiquetas:affects_outputs
--[no]verbose_failures
valor predeterminado: "false"-
Si un comando falla, imprime la línea de comandos completa.
Etiquetas:terminal_output
- Opciones que especifican o modifican una entrada genérica a un comando de Bazel que no se incluye en otras categorías:
- Se acumulan
--aspects_parameters=<a 'name=value' assignment>
usos múltiples -
Especifica los valores de los parámetros de aspectos de la línea de comandos. Cada valor del parámetro se especifica con <param_name>=<param_value>. Por ejemplo, 'my_param=my_val', donde 'my_param' es un parámetro de algún aspecto en la lista --aspects o lo requiere un aspecto de la lista. Esta opción se puede usar varias veces. Sin embargo, no se puede 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 configura, la compilación leerá los patrones del archivo que se menciona aquí, en lugar de hacerlo en la línea de comandos. Es un error especificar un archivo aquí, así como patrones de la línea de comandos.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remoto:
- Configuración predeterminada de
--experimental_circuit_breaker_strategy=<failure>
: ver descripción -
Especifica la estrategia que usará el disyuntor. Las estrategias disponibles son el “fracaso”. Si el valor de la opción no es válido, no se establece el comportamiento de la opción.
Etiquetas:execution
- Configuración predeterminada de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo para configurar el cargador 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 con el que debe coincidir y otro para usar como URL sustitutiva, con referencias inversas que comienzan con "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL, y se mostrarán varias URL.
--[no]experimental_guard_against_concurrent_changes
valor predeterminado: "false"- Desactiva esta opción para inhabilitar la verificación de la hora 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 retrasa la escritura de archivos, lo que podría causar falsos positivos.
--[no]experimental_remote_cache_async
valor predeterminado: "false"- Si es verdadero, la E/S de la caché remota se producirá en segundo plano, en lugar de tener lugar como parte de una generación.
--experimental_remote_cache_compression_threshold=<an integer>
predeterminado: "0"- El tamaño mínimo de BLOB que se requiere para comprimir o descomprimir con zstd. No tiene efecto, a menos que se configure --remote_cache_compression.
--experimental_remote_cache_eviction_retries=<an integer>
predeterminado: "0"-
La cantidad máxima de intentos de reintento si la compilación detectó 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 verifica el código de salida 39.
Etiquetas:execution
--[no]experimental_remote_cache_lease_extension
valor predeterminado: "false"- Si se configura como verdadera, Bazel extenderá la asignación de tiempo para resultados de acciones remotas durante la compilación mediante el envío de llamadas a “FindMissingBlobs” de forma periódica a la caché remota. La frecuencia se basa en el valor de “--experimental_remote_cache_ttl”.
--experimental_remote_cache_ttl=<An immutable length of time.>
(valor predeterminado): "3h"-
El TTL mínimo garantizado de los BLOB en la caché remota después de que se hace referencia recientemente a sus resúmenes, p.ej., mediante ActionResult o FindMissingBlobs. Bazel realiza varias optimizaciones basadas en el TTL de los BLOB, p.ej., no llama repetidamente a GetActionResult en una compilación incremental. El valor debe establecerse un poco menos que el TTL real, ya que hay un espacio entre el momento en que el servidor muestra los resúmenes y el momento en que Bazel los recibe.
Etiquetas:execution
- Configuración predeterminada de
--experimental_remote_capture_corrupted_outputs=<a path>
: ver descripción - Una ruta de acceso a un directorio en el que se capturarán los resultados dañados.
- El valor predeterminado de
--[no]experimental_remote_discard_merkle_trees
es "true" (verdadero). - Si se configura como verdadera, descarta las copias en memoria del árbol Merkle de la raíz de entrada y las asignaciones de entradas asociadas durante las llamadas a GetActionResult() y Execute(). Esta acción reduce el uso de memoria de forma significativa, pero requiere que Bazel vuelva a calcularlas ante errores y reintentos de la caché remota.
- Configuración predeterminada de
--experimental_remote_downloader=<a string>
: ver descripción - Un URI de extremo de la API de Remote Asset, que se usará como proxy de descarga remoto. Los esquemas compatibles son grpc, grpcs (grpc con TLS habilitada) y Unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel se establecerá de forma predeterminada en grpcs. Consulta: https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto
--[no]experimental_remote_downloader_local_fallback
valor predeterminado: "false"- Indica si se debe recurrir al cargador local si falla el cargador remoto.
--[no]experimental_remote_execution_keepalive
valor predeterminado: "false"- Indica si se debe usar keepalive para llamadas de ejecución remota.
--experimental_remote_failure_rate_threshold=<an integer in 0-100 range>
predeterminado: "10"-
Establece la cantidad permitida de tasa de fallas en un porcentaje para un período específico después del cual se deja de llamar al ejecutor o la caché remotos. El valor predeterminado es 10. Establecerlo en 0 significa que no existen limitaciones.
Etiquetas:execution
- Valor predeterminado de
--experimental_remote_failure_window_interval=<An immutable length of time.>
: "60s" -
El intervalo en el que se calcula la tasa de fallas de las solicitudes remotas. En un valor negativo o cero, la duración de la falla se calcula la duración total de la ejecución.Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
Etiquetas:execution
--[no]experimental_remote_mark_tool_inputs
valor predeterminado: "false"- Si se configura como verdadera, Bazel marcará las entradas como entradas de herramientas para el ejecutor remoto. Se puede usar para implementar trabajadores persistentes remotos.
--[no]experimental_remote_merkle_tree_cache
valor predeterminado: "false"- Si se establece como verdadera, se memorizarán los cálculos del árbol de Merkle para mejorar la velocidad de comprobación de aciertos de la caché remota. La huella de pie en la memoria de la caché se controla con --experimental_remote_merkle_tree_cache_size.
--experimental_remote_merkle_tree_cache_size=<a long integer>
predeterminado: "1000"- La cantidad de árboles de Merkle que se deben memorizar para mejorar la velocidad de verificación de aciertos de la caché remota. Aunque la caché se reduce automáticamente según el manejo de las referencias de software por parte de Java, pueden producirse errores de memoria insuficiente si la configuración es 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. La configuración predeterminada es 1,000.
- Configuración predeterminada de
--experimental_remote_output_service=<a string>
: ver descripción - HOST o HOST:PORT de un extremo de servicio de salida remoto Los esquemas compatibles son grpc, grpcs (grpc con TLS habilitada) y Unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel se establecerá de forma predeterminada en grpcs. Especifica grpc:// o Unix: esquema para inhabilitar TLS.
--experimental_remote_output_service_output_path_prefix=<a string>
predeterminado: ""- La ruta de acceso en la que se coloca el contenido de los directorios de salida administrados por --experimental_remote_output_service. El directorio de salida real que use una compilación será un descendiente de esta ruta de acceso y lo determinará el servicio de salida.
--[no]experimental_remote_require_cached
valor predeterminado: "false"- Si se configura como verdadera, exige que todas las acciones que se pueden ejecutar de forma remota se almacenen en caché o, de lo contrario, falle la compilación. Esto es útil para solucionar problemas de no determinismo, ya que permite verificar si las acciones que deben almacenarse en caché realmente se almacenan en caché sin inyectar resultados nuevos en la caché de forma falsa.
- Configuración predeterminada de
--experimental_remote_scrubbing_config=<Converts to a Scrubber>
: ver descripción - Permite la depuración remota de claves de caché con el archivo de configuración proporcionado, que debe ser un búfer de protocolo en formato de texto (consulta src/main/protobuf/remote_scrubbing.proto). El objetivo de esta función es facilitar el uso compartido de una caché remota o de disco entre acciones que se ejecutan en distintas plataformas, pero que tienen como objetivo la misma plataforma. Se debe usar con mucho cuidado, ya que una configuración incorrecta puede provocar que se compartan accidentalmente las entradas de caché y dar lugar a compilaciones incorrectas. El arrastre no afecta la forma en que se ejecuta una acción, solo la forma en que se calcula la clave de caché remota/disco con el fin de recuperar o almacenar el resultado de una acción. Las acciones de arrastre no son compatibles con la ejecución remota y, por lo tanto, siempre se ejecutarán de forma local. Modificar la configuración de depuración no invalida los resultados presentes en el sistema de archivos local o en las memorias caché internas; se requiere una compilación limpia para volver a ejecutar las acciones afectadas. Para usar correctamente esta función, probablemente te convenga configurar una plataforma personalizada --host_platform junto con --experimental_platform_in_output_dir (para normalizar los prefijos de salida) y la --incompatible_strict_action_env (para normalizar las variables de entorno).
- Valor predeterminado de
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "auto" - Es el modo de subprocesos que se usará para la recuperación del repositorio. Si se configura en “off”, no se usa ningún subproceso de trabajo y la recuperación del repositorio está sujeta a reinicios. De lo contrario, utiliza un subproceso de plataforma (es decir, subproceso del SO) si se configura como “platform” o un subproceso virtual si se establece como “virtual”. Si se configura como "auto", se usan subprocesos virtuales si están disponibles (es decir, se ejecutan en JDK 21 y versiones posteriores); de lo contrario, no se usan subprocesos de trabajo.
--[no]incompatible_remote_build_event_upload_respect_no_cache
valor predeterminado: "false"- Obsoleto. No-op. En su lugar, usa --remote_build_event_upload=minimal.
- El valor predeterminado de
--[no]incompatible_remote_downloader_send_all_headers
es "true" (verdadero). -
Indica si se deben enviar todos los valores de un encabezado con varios valores al cargador remoto en lugar de solo el primero.
Etiquetas:incompatible_change
--[no]incompatible_remote_output_paths_relative_to_input_root
valor predeterminado: "false"-
Si se configura como verdadera, las rutas de salida están relacionadas con la raíz de entrada en lugar del directorio de trabajo.
Etiquetas:incompatible_change
- El valor predeterminado de
--[no]incompatible_remote_results_ignore_disk
es "true" (verdadero). -
No-ops
Etiquetas:incompatible_change
- El valor predeterminado de
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
es "true" (verdadero). -
Si se configura como verdadera, Bazel usará el nuevo código de salida 39 en lugar del 34 si la caché remota expulsa los BLOB durante la compilación.
Etiquetas:incompatible_change
- El valor predeterminado de
--[no]remote_accept_cached
es "true" (verdadero). - Indica si se aceptan resultados de acciones almacenados en caché de forma remota.
- Valor predeterminado de
--remote_build_event_upload=<all or minimal>
: "mínimo" - Si se configura como “all”, todas las salidas locales a las que hace referencia BEP se suben a la caché remota. Si se configura como “mínimo”, las salidas locales a las que hace referencia BEP no se suben a la caché remota, excepto los archivos que son importantes para los consumidores de BEP (p.ej., registros de prueba y perfil de sincronización). El esquema bytestream:// siempre se usa para el URI de los archivos, incluso si faltan de la caché remota. La configuración predeterminada es “mínima”.
- Configuración predeterminada de
--remote_bytestream_uri_prefix=<a string>
: ver descripción - El nombre de host y el nombre de la instancia que se usarán en los URI bytestream:// que se escriben en transmisiones de eventos de compilación. Esta opción se puede configurar cuando las compilaciones se realizan con un proxy, lo que hace que los valores de --remote_executor y --remote_instance_name ya no correspondan con el nombre canónico del servicio de ejecución remota. Si no se establece, el valor predeterminado será “${hostname}/${instance_name}”.
- Configuración predeterminada de
--remote_cache=<a string>
: ver descripción - Un URI de un extremo de almacenamiento en caché. Los esquemas admitidos son http, https, grpc, grpcs (grpc con TLS habilitada) y Unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel se establecerá de forma predeterminada en grpcs. Especifica el esquema grpc://, http:// o Unix: para inhabilitar TLS. Consulta https://bazel.build/remote/caching
--[no]remote_cache_compression
valor predeterminado: "false"- Si se habilita, comprime o descomprime los BLOB de caché con zstd cuando su tamaño sea al menos --experimental_remote_cache_compression_threshold.
- Se acumulan
--remote_cache_header=<a 'name=value' assignment>
usos múltiples - Especifica un encabezado que se incluirá en las solicitudes de caché: --remote_cache_header=Name=Value. Se pueden pasar varios encabezados si se especifica la marca varias veces. Si hay varios valores con el mismo nombre, se convertirán en una lista separada por comas.
- Se acumulan
--remote_default_exec_properties=<a 'name=value' assignment>
usos múltiples -
Configura las propiedades de ejecución predeterminadas que se usarán como plataforma de ejecución remota si una plataforma de ejecución aún no configuró exec_properties.
Etiquetas:affects_outputs
--remote_default_platform_properties=<a string>
predeterminado: ""- Establece las propiedades de plataforma predeterminadas para la API de ejecución remota si la plataforma de ejecución aún no configuró remote_execution_properties. Este valor también se usará si se selecciona la plataforma host como la plataforma de ejecución para la ejecución remota.
- Se acumulan
--remote_download_regex=<a valid Java regular expression>
usos múltiples -
Fuerza la descarga de las salidas de compilación remotas cuya ruta de acceso coincide con este patrón, independientemente de --remote_download_outputs. Se pueden especificar varios patrones mediante la repetición de esta marca.
Etiquetas:affects_outputs
- Se acumulan
--remote_downloader_header=<a 'name=value' assignment>
usos múltiples - Especifica un encabezado que se incluirá en las solicitudes de cargadores remotos: --remote_downloader_header=Name=Value. Se pueden pasar varios encabezados si se especifica la marca varias veces. Si hay varios valores con el mismo nombre, se convertirán en una lista separada por comas.
- Se acumulan
--remote_exec_header=<a 'name=value' assignment>
usos múltiples - Especifica un encabezado que se incluirá en las solicitudes de ejecución: --remote_exec_header=Name=Value. Se pueden pasar varios encabezados si se especifica la marca varias veces. Si hay varios valores con el mismo nombre, se convertirán en una lista separada por comas.
--remote_execution_priority=<an integer>
predeterminado: "0"- La prioridad relativa de las acciones que se ejecutarán de forma remota. La semántica de los valores de prioridad particulares depende del servidor.
- Configuración predeterminada de
--remote_executor=<a string>
: ver descripción - HOST o HOST:PORT de un extremo de ejecución remota. Los esquemas compatibles son grpc, grpcs (grpc con TLS habilitada) y Unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel se establecerá de forma predeterminada en grpcs. Especifica grpc:// o Unix: esquema para inhabilitar TLS.
- Configuración predeterminada de
--remote_grpc_log=<a path>
: ver descripción - Si se especifica, es una ruta a un archivo para registrar los detalles relacionados con las llamadas de gRPC. Este registro consta de una secuencia de protobufs serializados com.google.Dev
- Se acumulan
--remote_header=<a 'name=value' assignment>
usos múltiples - Especifica un encabezado que se incluirá en las solicitudes: --remote_header=Name=Value. Se pueden pasar varios encabezados si se especifica la marca varias veces. Si hay varios valores con el mismo nombre, se convertirán en una lista separada por comas.
--remote_instance_name=<a string>
predeterminado: ""- Valor que se pasará como instance_name en la API de ejecución remota.
--[no]remote_local_fallback
valor predeterminado: "false"- Determina si se debe recurrir a la estrategia de ejecución local independiente si falla la ejecución remota.
- El valor predeterminado de
--remote_local_fallback_strategy=<a string>
es "local" - No-ops, obsoleto. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/7480.
--remote_max_connections=<an integer>
predeterminado: "100"-
Limita la cantidad máxima de conexiones simultáneas a la caché o al ejecutor remoto. De forma predeterminada, el valor es 100. Establecerlo en 0 significa que no existen limitaciones.
Para la caché remota HTTP, una conexión TCP podría manejar una solicitud a la vez, por lo que Bazel podría compensar hasta --remote_max_connections solicitudes simultáneas.
Para la caché o el ejecutor remoto de gRPC, por lo general, un canal de gRPC podría manejar más de 100 solicitudes simultáneas, por lo que Bazel podría hacer alrededor de `--remote_max_connections * 100` solicitudes simultáneas.
Etiquetas:host_machine_resource_optimizations
- Configuración predeterminada de
--remote_proxy=<a string>
: ver descripción - Conéctate a la caché remota a través de un proxy. Actualmente, esta marca solo se puede usar para configurar un socket de dominio Unix (unix:/path/to/socket).
--remote_result_cache_priority=<an integer>
predeterminado: "0"- La prioridad relativa de las acciones remotas que se almacenarán en la caché remota. La semántica de los valores de prioridad particulares depende del servidor.
--remote_retries=<an integer>
predeterminado: "5"- La cantidad máxima de intentos para reintentar un error transitorio. Si se establece en 0, se inhabilitan los reintentos.
- Valor predeterminado de
--remote_retry_max_delay=<An immutable length of time.>
: "5 s" - Es el retraso máximo de retirada entre intentos 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.
- Valor predeterminado de
--remote_timeout=<An immutable length of time.>
: "60s" - La cantidad máxima de tiempo que se debe esperar para la ejecución remota y las llamadas a caché. Para la caché de REST, este es el tiempo de espera de conexión y 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.
- El valor predeterminado de
--[no]remote_upload_local_results
es "true" (verdadero). - Indica si se deben subir los resultados de acciones ejecutadas de forma local a la caché remota si la caché remota lo admite y el usuario está autorizado para hacerlo.
- El valor predeterminado de
--[no]remote_verify_downloads
es "true" (verdadero). - Si se configura como verdadera, Bazel calculará la suma de hash de todas las descargas remotas y descartará los valores almacenados en caché de manera remota si no coinciden con el valor esperado.
- Opciones varias, que no están categorizadas:
- El valor predeterminado de
--[no]allow_analysis_cache_discard
es "true" (verdadero). -
Si se descarta la caché de análisis debido a un cambio en el sistema de compilación, configurar esta opción como falsa provocará que Bazel salga, 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
- La configuración predeterminada de
--auto_output_filter=<none, all, packages or subpackages>
es “ninguna” - Si no se especifica --output_filter, se usa el valor de esta opción para crear un filtro automáticamente. Los valores permitidos son “ninguno” (no filtrar nada / mostrar todo), “todos” (filtrar todo / mostrar nada), “paquetes” (incluye el resultado de las reglas de los paquetes mencionados en la línea de comandos de Blaze) y los “subpaquetes” (como “paquetes”, pero también incluyen subpaquetes). Para los “paquetes” y “subpaquetes”, los valores //java/foo y //javatests/foo se tratan como un solo paquete)'.
--[no]build_manual_tests
valor predeterminado: "false"- Fuerza la compilación de objetivos de prueba etiquetados como “manuales”. 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. Cada etiqueta puede estar precedida opcionalmente por “-” para especificar las etiquetas excluidas. Solo se crearán aquellos destinos que contengan al menos una etiqueta incluida y no contengan ninguna etiqueta excluida. Esta opción no afecta el conjunto de pruebas ejecutadas con el comando “test”, ya que se rigen por las opciones de filtrado de pruebas, por ejemplo, “--test_tag_filters”.
--[no]build_tests_only
valor predeterminado: "false"- Si se especifica, solo se compilarán las reglas *_test y test_suite, y se ignorarán otros destinos especificados en la línea de comandos. De forma predeterminada, se compilará todo lo que se solicitó.
- La configuración predeterminada de
--combined_report=<none or lcov>
es “ninguna” - Especifica el tipo de informe de cobertura acumulativo deseado. En este punto, solo se admite el LCOV.
--[no]compile_one_dependency
valor predeterminado: "false"- Compila una sola dependencia de los archivos de argumentos. Esto es útil para verificar la sintaxis de los archivos de origen en IDE, por ejemplo, cuando vuelves a compilar un solo destino que depende del archivo de origen 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 marcadores; en lugar de ser objetivos para compilar, son nombres de archivo de origen. Para cada nombre de archivo de origen, se compilará un destino arbitrario que dependa de él.
- Se acumulan
--deleted_packages=<comma-separated list of package names>
usos múltiples - Una lista separada por comas de los nombres de los paquetes que el sistema de compilación considerará que no existen, incluso si están visibles en algún lugar de la ruta del paquete. Usa esta opción cuando borres un subpaquete 'x/y' de un paquete 'x' existente. Por ejemplo, después de borrar x/y/BUILD en el cliente, el sistema de compilación puede presentar un reclamo si encuentra la etiqueta '//x:y/z' si todavía la proporciona otra entrada package_path. Si especificas --deleted_packages x/y se evita este problema.
--[no]discard_analysis_cache
valor predeterminado: "false"- Descartar la caché de análisis inmediatamente después de que se complete la fase de análisis. Reduce el uso de memoria en aproximadamente un 10%, pero ralentiza las compilaciones incrementales adicionales.
- Configuración predeterminada de
--disk_cache=<a path>
: ver descripción - Una ruta de acceso a un directorio en el que Bazel puede leer y escribir acciones y resultados de acciones. Si el directorio no existe, se creará.
--embed_label=<a one-line string>
predeterminado: ""- Incorporar la etiqueta de la versión o la revisión del control de código fuente en un objeto binario
- Configuración predeterminada de
--execution_log_binary_file=<a path>
: ver descripción - Registra las generaciones ejecutadas en este archivo como protos SpawnExec delimitados por longitud, de acuerdo con src/main/protobuf/spawn.proto. Marcas relacionadas: --execution_log_json_file (formato JSON de texto; excluyente mutuamente), --execution_log_sort (si se debe ordenar el registro de ejecución), --subcomandos (para mostrar subcomandos en el resultado de la terminal).
- Configuración predeterminada de
--execution_log_json_file=<a path>
: ver descripción - Registra las generaciones ejecutadas en este archivo como representaciones JSON delimitadas por saltos de línea de los archivos proto de SpawnExec, de acuerdo con 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), --subcomandos (para mostrar subcomandos en el resultado de terminal).
- El valor predeterminado de
--[no]execution_log_sort
es "true" (verdadero). - Indica si se debe ordenar el registro de ejecución para facilitar la comparación de los registros en las invocaciones. Se establece como false para evitar un uso potencialmente significativo de CPU y memoria al final de la invocación, a costa de producir el registro en orden de ejecución no determinista. Solo se aplica a los formatos binarios y JSON; el formato compacto nunca se ordena.
- El valor predeterminado de
--[no]expand_test_suites
es "true" (verdadero). -
Amplía los objetivos de test_suite en las pruebas constituyentes antes del análisis. Cuando esta marca está activada (configuración predeterminada), se aplicarán patrones de objetivo negativos a las pruebas que pertenezcan al paquete de pruebas; de lo contrario, no. Desactivar esta marca es útil cuando los aspectos de nivel superior se aplican en la línea de comandos: entonces pueden analizar los objetivos de test_suite.
Etiquetas:loading_and_analysis
- Configuración predeterminada de
--experimental_execution_log_compact_file=<a path>
: ver descripción - Registra las generaciones ejecutadas en este archivo como protos ExecLogEntry delimitados por longitud, de acuerdo con src/main/protobuf/spawn.proto. El archivo completo está comprimido en zstd. Este es un formato experimental en desarrollo activo y puede cambiar en cualquier momento. Marcas relacionadas: --execution_log_binary_file (formato protobuf binario; mutuamente excluyente), --execution_log_json_file (formato JSON de texto; mutuamente excluyentes), --subcomandos (para mostrar subcomandos en el resultado de terminal).
--experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
predeterminado: ""- Se dio de baja a favor de los aspectos. Filtra el conjunto de objetivos para los que se programan acciones adicionales.
--[no]experimental_extra_action_top_level_only
valor predeterminado: "false"- Se dio de baja a favor de los aspectos. Solo programa las acciones adicionales para los objetivos de nivel superior.
--experimental_spawn_scheduler
-
Habilita la ejecución dinámica ejecutando acciones de forma local y remota en paralelo. Bazel genera cada acción de forma local y remota, y elige la que se completa primero. Si una acción admite trabajadores, la acción local se ejecutará en el modo de trabajador persistente. Para habilitar la ejecución dinámica de un valor mnemotécnico de acción individual, usa las marcas `--internal_spawn_scheduler` y `--strategy=<mnemonic>=dynamic`.
Se expande a:
--internal_spawn_scheduler
--spawn_strategy=dynamic
- El valor predeterminado de
--[no]fetch
es "true" (verdadero). - Permite que el comando recupere dependencias externas. Si se establece como falsa, el comando usará cualquier versión almacenada en caché de la dependencia. Si no existe ninguna, el comando fallará.
--[no]incompatible_dont_use_javasourceinfoprovider
valor predeterminado: "false"-
No-ops
Etiquetas:incompatible_change
--local_termination_grace_seconds=<an integer>
predeterminado: "15"- Tiempo de espera entre la finalización de un proceso local debido al tiempo de espera y el cierre forzado.
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
--package_path=<colon-separated list of options>
predeterminado: "%workspace%"- Una lista separada por dos puntos sobre dónde buscar paquetes. Los elementos que comienzan con "%workspace%" son relativos al lugar de trabajo que lo contiene. Si se omite o está vacío, el valor predeterminado es el resultado de “bazel info default-package-path”.
- El valor predeterminado de
--[no]show_loading_progress
es "true" (verdadero). - Si se habilita, hace que Bazel imprima mensajes "Cargando 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 las ubicaciones de prueba que estén escritas en los idiomas especificados. El nombre que se usa para cada lenguaje debe ser el mismo que el prefijo de idioma en la regla *_test, p.ej., "cc", "java", "py", etc. Esta opción afecta el comportamiento de --build_tests_only y el comando de prueba.
--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. Cada tamaño puede estar precedido opcionalmente por “-” 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 de prueba.
--test_tag_filters=<comma-separated list of options>
predeterminado: ""- Especifica una lista de etiquetas de prueba separadas por comas. Cada etiqueta puede estar precedida opcionalmente por “-” para especificar las etiquetas excluidas. Solo se encontrarán los destinos de prueba que contengan al menos una etiqueta incluida y no contengan ninguna etiqueta excluida. Esta opción afecta el comportamiento de --build_tests_only y el comando de prueba.
--test_timeout_filters=<comma-separated list of values: short, moderate, long or eternal>
predeterminado: ""- Especifica una lista separada por comas de tiempos de espera de pruebas. Cada tiempo de espera puede estar precedido opcionalmente por “-” para especificar los tiempos de espera excluidos. Solo se encontrarán los destinos 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 de prueba.
--workspace_status_command=<path>
predeterminado: ""- Es un comando invocado al comienzo de la compilación para proporcionar información de estado sobre el lugar de trabajo en forma de pares clave-valor. Consulta el manual del usuario para ver la especificación completa. También consulta tools/buildstamp/get_workspace_status para ver un ejemplo.
- Opciones que controlan la ejecución de la compilación:
--[no]check_up_to_date
valor predeterminado: "false"-
No realices la compilación, solo verifica si está actualizada. Si todos los destinos están actualizados, la compilación se completa de forma correcta. Si es necesario ejecutar algún paso, se informa un error y la compilación falla.
Etiquetas:execution
--[no]experimental_inprocess_symlink_creation
valor predeterminado: "false"-
Indica 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
valor predeterminado: "false"-
Habilita el extractor de aar persistente con trabajadores.
Etiquetas:execution
--[no]experimental_remotable_source_manifests
valor predeterminado: "false"-
Indica si se pueden hacer que las acciones del manifiesto de origen sean remotas
Etiquetas:loading_and_analysis
,execution
,experimental
--[no]experimental_split_coverage_postprocessing
valor predeterminado: "false"-
Si es verdadero, Bazel ejecutará el procesamiento posterior de la cobertura para probarlo en un nuevo generador.
Etiquetas:execution
- El valor predeterminado de
--[no]experimental_split_xml_generation
es "true" (verdadero). -
Si se configura esta marca y una acción de prueba no genera un archivo test.xml, Bazel usa una acción separada para generar un archivo test.xml ficticio que contenga el registro de prueba. De lo contrario, Bazel generará un archivo test.xml como parte de la acción de prueba.
Etiquetas:execution
--[no]experimental_strict_fileset_output
valor predeterminado: "false"-
Si habilitas esta opción, los conjuntos de archivos tratarán todos los artefactos de salida como archivos normales. No desviarán directorios ni serán sensibles a los symlinks.
Etiquetas:execution
- El valor predeterminado de
--[no]experimental_use_semaphore_for_jobs
es "true" (verdadero). -
Si se configura como true, también usa el 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 eliminará gradualmente. En su lugar, usa --spawn_strategy=<value> para controlar todas las acciones o --strategy=Genrule=<value> para controlar solo 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"-
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 seguido 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 en función de 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 el objetivo que falló y aquellos que dependen de él no se pueden analizar, otros requisitos previos de estos objetivos pueden serlo.
Etiquetas:eagerness_to_exit
- Valor predeterminado de
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "auto" -
Cantidad de subprocesos paralelos que se usarán en la fase de carga o análisis. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguido 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 el valor mnemotécnico de la acción. Solo se aplica a las acciones que admiten información de ejecución. Muchas acciones comunes admiten información de ejecución, p.ej., Genrule, CppCompile, Javac, StarlarkAction y TestRunner. Cuando se especifican varios valores, el orden es importante porque muchas regex pueden aplicarse al mismo valor mnemotécnico.
Sintaxis: "regex=[+-]key,regex=[+-]key,...".
Ejemplos:
“.*=+x,.*=-y,.*=+z” agrega “x” y “z” a la información de ejecución de todas las acciones y quita “y”.
“Genrule=+requires-x” agrega “require-x” a la información de ejecución para todas las acciones de Genrule.
“(?!Genrule).*=-requires-x” quita “require-x” de la información de ejecución para todas las acciones que no son de Genrule.
Etiquetas:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Habilita las acciones persistentes de dex y desugar de Android con trabajadores.
Se expande a:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
-
Habilita el procesador de recursos persistentes de Android usando 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
}}{/13/}
--strategy=Aapt2Optimize=worker
--strategy=Aapt2Optimize=worker
--strategy=Aapt2Optimize=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
--strategy=ProcessDatabinding=worker
--strategy=GenerateDataBindingBaseClasses=worker
host_machine_resource_optimizations
execution
--persistent_multiplex_android_dex_desugar
-
Habilita las acciones de dex y desugar multiplexadas 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 multiplexados persistentes de Android usando 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=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
host_machine_resource_optimizations
execution
--persistent_multiplex_android_tools
-
Habilita herramientas persistentes y multiplexadas de Android (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
valor 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 dichos destinos genera un error, pero se omiten en silencio cuando esta opción está habilitada. 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 generación de forma predeterminada. Acepta una lista de estrategias separadas por comas de mayor a menor prioridad. Para cada acción, Bazel elige la estrategia con la prioridad más alta que puede ejecutar la acción. El valor predeterminado es “remote,worker,sandboxed,local”. Para obtener más información, consulta https://blog.bazel.build/2019/06/19/list-strategy.html.
Etiquetas:execution
- Se acumulan
--strategy=<a '[name=]value1[,..,valueN]' assignment>
usos múltiples -
Especifica cómo distribuir la compilación de otras acciones de generación. Acepta una lista de estrategias separadas por comas de mayor a menor prioridad. Para cada acción, Bazel elige la estrategia con la prioridad más alta que puede ejecutar la acción. El valor predeterminado es “remote,worker,sandboxed,local”. Esta marca anula los valores establecidos por --spawn_strategy (y --genrule_strategy si se utiliza con Genrule mnemónico). Para obtener más información, consulta https://blog.bazel.build/2019/06/19/list-strategy.html.
Etiquetas:execution
- Se acumulan
--strategy_regexp=<a '<RegexFilter>=value[,value]' assignment>
usos múltiples -
Anula la estrategia de generación que se debe usar para ejecutar acciones de generación que tengan descripciones que coincidan con un regex_filter determinado. Consulta --per_file_copt para obtener detalles sobre la coincidencia deregex_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 que se deben 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á "Compila //foo/bar/baz" con la estrategia "local", pero revertir el orden ejecutaría "sandboxed".
Etiquetas:execution
--[no]use_target_platform_for_tests
valor predeterminado: "false"-
Si es "true", Bazel usará la plataforma de destino para ejecutar pruebas en lugar del grupo de ejecuciones de prueba.
Etiquetas:execution
- Opciones que configuran la cadena de herramientas usada para ejecutar la acción:
- Configuración predeterminada de
--android_compiler=<a string>
: ver 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
yloses_incremental_state
- Configuración predeterminada de
--android_grte_top=<a label>
: ver descripción -
El objetivo de Android es grte_top.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
predeterminado: "android"-
Selecciona la combinación de manifiestos que se usará para las reglas android_binary. Marca para ayudar en 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 objetivos de android_binary. Si se especifican varias plataformas, el objeto binario es un APK multiarquitectura, que incluye 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 utiliza 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"-
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
- Configuración predeterminada de
--compiler=<a string>
: ver descripción -
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 objeto binario que se usa para procesar posteriormente los informes de cobertura sin procesar. Actualmente, debe ser un grupo de archivos que contenga un solo archivo, el binario. La configuración predeterminada 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 objeto binario que se usa para generar informes de cobertura. Actualmente, debe ser un grupo de archivos que contenga un solo archivo, el binario. La configuración predeterminada 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. La configuración predeterminada es "//tools/test:coverage_support".
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
- Configuración predeterminada de
--custom_malloc=<a build target label>
: ver descripción -
Especifica una implementación de malloc personalizada. Este parámetro de configuración anula los atributos malloc en las reglas de compilación.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
usos múltiples -
Lista de expresiones regulares separadas por comas, cada una con el prefijo - (expresión negativa), asignada (=) a una lista de valores de restricción separados por comas. Si un objetivo no coincide con ninguna expresión negativa y al menos una expresión positiva, la resolución de la cadena de herramientas se ejecutará 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 aquellos cuyo nombre contenga 'prueba'.
Etiquetas:loading_and_analysis
--[no]experimental_include_xcode_execution_requirements
valor predeterminado: "false"-
Si se configura, agrega un requisito de ejecución “requires-xcode:{version}” a cada acción de Xcode. Si la versión de Xcode tiene una etiqueta con guion, también agrega un requisito de ejecución “requires-xcode-label:{version_label}”.
Etiquetas:loses_incremental_state
,loading_and_analysis
,execution
- El valor predeterminado de
--[no]experimental_prefer_mutual_xcode
es "true" (verdadero). -
Si es verdadero, usa el Xcode más reciente que esté disponible de forma local y remota. Si es falso, o si no existen 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 objetivo exacto o como patrón de objetivo. Estas plataformas se considerarán antes que las declaradas en el archivo WORKSPACE por register_execution_platforms(). Esta opción solo se puede configurar una vez; las instancias posteriores anularán la configuración de marcas anterior.
Etiquetas:execution
- Se acumulan
--extra_toolchains=<comma-separated list of options>
usos múltiples -
Son las reglas de la cadena de herramientas que se tendrán en cuenta durante su resolución. Las cadenas de herramientas se pueden especificar por objetivo exacto o como patrón de objetivo. Estas cadenas de herramientas se considerarán antes de las declaradas en el archivo WORKSPACE por register_toolchains().
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
- Configuración predeterminada de
--grte_top=<a label>
: ver descripción -
Es una etiqueta de una biblioteca libc registrada. La cadena de herramientas de herramientas cruzadas selecciona el valor predeterminado, y casi nunca necesitas anularlo.
Etiquetas:action_command_lines
,affects_outputs
- Configuración predeterminada de
--host_compiler=<a string>
: ver descripción -
Marca no-op. Se quitará en una versión futura.
Etiquetas:loading_and_analysis
,execution
- Configuración predeterminada de
--host_grte_top=<a label>
: ver descripción -
Si se especifica, esta configuración anula el directorio de nivel superior de libc (--grte_top) para la configuración de ejecución.
Etiquetas:action_command_lines
,affects_outputs
--host_platform=<a build target label>
valor predeterminado: "@local_config_platform//:host"-
Es la etiqueta de una regla de la plataforma que describe el sistema host.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
- El valor predeterminado de
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
es "true" (verdadero). -
Si es "true", 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
- El valor predeterminado de
--[no]incompatible_enable_android_toolchain_resolution
es "true" (verdadero). -
Usa la resolución de la cadena de herramientas para seleccionar el SDK de Android para reglas de Android (Starlark y nativo)
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_apple_toolchain_resolution
valor predeterminado: "false"-
Usa la resolución de la cadena de herramientas para seleccionar el SDK de Apple para las reglas de Apple (Starlark y nativo)
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_make_thinlto_command_lines_standalone
es "true" (verdadero). -
Esta marca es una noop y se programó su eliminación.
Etiquetas:no_op
,incompatible_change
- El valor predeterminado de
--[no]incompatible_remove_legacy_whole_archive
es "true" (verdadero). -
Si es verdadero, Bazel no vinculará las dependencias de la biblioteca como todo el archivo de forma predeterminada (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener instrucciones de migración).
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_require_ctx_in_configure_features
es "true" (verdadero). -
Esta marca es una noop y se programó su eliminación.
Etiquetas:no_op
,incompatible_change
--[no]incompatible_strip_executable_safely
valor predeterminado: "false"-
Si es verdadero, la acción de quitar para los ejecutables usará la marca -x, lo que no interrumpe la resolución de símbolos dinámicos.
Etiquetas:action_command_lines
,incompatible_change
- Usa objetos compartidos de interfaz si la cadena de herramientas lo admite. Todas las cadenas de herramientas de ELF admiten actualmente este parámetro de configuración.
Etiquetas:loading_and_analysis
,affects_outputs
,affects_outputs
- Configuración predeterminada de
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Especifica la versión del SDK de iOS que se usará para compilar aplicaciones para iOS. Si no se especifica, usa la versión predeterminada del SDK para iOS de “xcode_version”.
Etiquetas:loses_incremental_state
- Configuración predeterminada de
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Especifica la versión del SDK de macOS que se usará para compilar aplicaciones de macOS. Si no se especifica, se usa la versión predeterminada del SDK de macOS de “xcode_version”.
Etiquetas:loses_incremental_state
- Configuración predeterminada de
--minimum_os_version=<a string>
: ver descripción -
La versión mínima del SO a la que se orienta tu compilación.
Etiquetas:loading_and_analysis
,affects_outputs
--platform_mappings=<a relative path>
predeterminado: ""-
Es la ubicación de un archivo de asignación en la que se describe qué plataforma usar si no hay ninguna establecida o qué marcas se deben configurar cuando ya existe una plataforma. Debe estar relacionado con la raíz del lugar de trabajo principal. La configuración predeterminada es "platform_mappings", que es un archivo directamente en la raíz del lugar de trabajo.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
yimmutable
--platforms=<a build target label>
predeterminado: ""-
Las etiquetas de las reglas de la plataforma que describen las plataformas de destino para el comando actual.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
- Configuración predeterminada de
--python2_path=<a string>
: ver descripción -
Obsoleto, no-op. Inhabilitado por `--incompatible_use_python_toolchains`.
Etiquetas:no_op
,deprecated
- Configuración predeterminada de
--python3_path=<a string>
: ver descripción -
Obsoleto, no-op. Inhabilitado por `--incompatible_use_python_toolchains`.
Etiquetas:no_op
,deprecated
- Configuración predeterminada de
--python_path=<a string>
: ver descripción -
Es la ruta de acceso absoluta del intérprete de Python que se invoca para ejecutar los objetivos de Python en la plataforma de destino. Obsoleto; inhabilitado por --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
- Configuración predeterminada de
--python_top=<a build target label>
: ver descripción -
La etiqueta de un py_runtime que representa el intérprete de Python invocado para ejecutar objetivos de Python en la plataforma de destino. Obsoleto; inhabilitado por --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
- Configuración predeterminada de
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Especifica la versión del SDK de tvOS que se usará para compilar aplicaciones de tvOS. Si no se especifica, se usa la versión predeterminada del SDK de tvOS de “xcode_version”.
Etiquetas:loses_incremental_state
- Configuración predeterminada de
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Especifica la versión del SDK de watchOS que se usará para compilar aplicaciones de watchOS. Si no se especifica, se usa la versión predeterminada del SDK de watchOS de “xcode_version”.
Etiquetas:loses_incremental_state
- Configuración predeterminada de
--xcode_version=<a string>
: ver descripción -
Si se especifica, usa Xcode de la versión determinada para las acciones de compilación relevantes. Si no se especifica, usa la versión predeterminada del ejecutor de Xcode.
Etiquetas:loses_incremental_state
--xcode_version_config=<a build target label>
predeterminado: "@bazel_tools//tools/cpp:host_xcodes"-
La etiqueta de la regla xcode_config que se usará para seleccionar la versión de Xcode en la configuración de compilación.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Opciones que controlan el resultado del comando:
--[no]apple_generate_dsym
valor predeterminado: "false"-
Indica si se deben generar archivos de símbolos de depuración (.dSYM).
Etiquetas:affects_outputs
,action_command_lines
- El valor predeterminado de
--[no]build
es "true" (verdadero). -
Ejecuta la compilación; este es el comportamiento habitual. La especificación de --nobuild hace que la compilación se detenga antes de ejecutar las acciones de compilación y muestra cero si las fases de análisis y carga del paquete se completaron correctamente. Este modo es útil para probar esas fases.
Etiquetas:execution
,affects_outputs
- El valor predeterminado de
--[no]build_runfile_links
es "true" (verdadero). -
Si esta opción es verdadera, compila bosques de symlinks de archivos de ejecución para todos los destinos. Si es falso, escríbelos solo cuando lo requiera una acción local, un comando de prueba o ejecución.
Etiquetas:affects_outputs
- El valor predeterminado de
--[no]build_runfile_manifests
es "true" (verdadero). -
Si esta opción es verdadera, se escriben manifiestos de archivos de ejecución para todos los destinos. Si es falso, omítelos. Las pruebas locales no se ejecutarán si el valor es falso.
Etiquetas:affects_outputs
--[no]build_test_dwp
valor predeterminado: "false"-
Si se habilita, cuando se compilen pruebas de C++ de forma estática y con fisión, 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"-
Establece los sufijos de los archivos fuente que crea una cc_proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info
valor 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
valor 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
valor predeterminado: "false"-
Guarda el estado de las funciones habilitadas y solicitadas como resultado de la compilación.
Etiquetas:affects_outputs
,experimental
--[no]experimental_use_validation_aspect
valor predeterminado: "false"-
Determina si se deben ejecutar acciones de validación con el aspecto (para el paralelismo con pruebas).
Etiquetas:execution
,affects_outputs
- El valor predeterminado de
--fission=<a set of compilation modes>
es "no" -
Especifica qué modos de compilación usan fisión para compilaciones y 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
- El valor predeterminado de
--[no]incompatible_always_include_files_in_data
es "true" (verdadero). -
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
- El valor predeterminado de
--[no]legacy_external_runfiles
es "true" (verdadero). -
Si esta opción es verdadera, compila bosques de symlink de archivos de ejecución para repositorios externos en .runfiles/wsname/external/repo (además de .runfiles/repo).
Etiquetas:affects_outputs
--[no]objc_generate_linkmap
valor predeterminado: "false"-
Especifica si se debe generar un archivo de mapa de vínculos.
Etiquetas:affects_outputs
- Se acumulan
--output_groups=<comma-separated list of options>
usos múltiples -
Una lista de nombres de grupos de salida separados por comas, cada uno de los cuales puede ir con el prefijo + o -. Un grupo con prefijo + se agrega al conjunto predeterminado de grupos de salida, mientras que uno con prefijo - se quita del conjunto predeterminado. Si al menos un grupo no tiene prefijo, se omite el conjunto predeterminado de grupos de salida. Por ejemplo, --output_groups=+foo,+bar 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
- El valor predeterminado de
--[no]run_validations
es "true" (verdadero). -
Determina 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
valor predeterminado: "false"-
Si se establece, se guardarán los resultados temporales de GCC. Estos incluyen archivos .s (código ensamblador), archivos .i (C preprocesado) y archivos .ii (C++ previamente procesados).
Etiquetas:affects_outputs
- Opciones que permiten al usuario configurar el resultado deseado y afectar su valor, en lugar de su existencia:
- Se acumulan
--action_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica el conjunto de variables de entorno disponibles para 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 mediante el par nombre=valor que establece el valor independientemente del entorno de invocación. Esta opción se puede usar varias veces; para opciones proporcionadas para la misma variable, se acumulan los últimos éxitos, las opciones para diferentes variables se acumulan.
Etiquetas:action_command_lines
--android_cpu=<a string>
predeterminado: "armeabi-v7a"-
Es la CPU de destino de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- El valor predeterminado de
--[no]android_databinding_use_androidx
es "true" (verdadero). -
Genera archivos de vinculación de datos compatibles con AndroidX. Esto solo se usa con Databinding v2. Esta marca es una no-op.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- El valor predeterminado de
--[no]android_databinding_use_v3_4_args
es "true" (verdadero). -
Usa Android Databinding v2 con un argumento 3.4.0. Esta marca es una no-op.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- El valor predeterminado de
--android_dynamic_mode=<off, default or fully>
es "desactivado" -
Determina si las dependencias de C++ de las reglas de Android se vincularán de forma dinámica cuando un objeto cc_binary no cree explícitamente una biblioteca compartida. “default” significa que Bazel decide si se vincula de forma dinámica. "completamente" significa que todas las bibliotecas se vincularán de forma dinámica. “off” significa que todas las bibliotecas se vincularán en su mayor parte en modo estático.
Etiquetas:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
valor predeterminado: "alphabetical"-
Establece el orden de los manifiestos que se pasan a la combinación de manifiestos para objetos binarios de Android. ALFABÉTICO significa que los manifiestos se ordenan por ruta de acceso relativa a la execroot. ALPHABETICAL_BY_CONFIGURATION significa que los manifiestos se ordenan por rutas de acceso relacionadas con el directorio de configuración dentro del directorio de salida. DEPENDENCY significa que los manifiestos se ordenan con los manifiestos de cada biblioteca antes que los de sus dependencias.
Etiquetas:action_command_lines
,execution
--[no]android_resource_shrinking
valor 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
--aspects=<comma-separated list of options>
usos múltiples - Lista de aspectos separados por coma que se aplicarán a los objetivos de nivel superior. En la lista, si Aspecto some_aspect especifica los proveedores de aspecto requeridos mediante 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 a algunos de los proveedores de aspecto requeridos. Además, some_aspect se ejecutará después de todos los aspectos obligatorios especificados por el atributo requirements. Luego, some_aspect tendrá acceso a los valores de los proveedores de esos aspectos. <bzl-file-label>%<aspect_name>, por ejemplo, “//tools:my_def.bzl%my_aspect”, donde “my_aspect” es un valor de nivel superior de un archivo tools/my_def.bzl
- Valor predeterminado de
--[no]build_python_zip
: "auto" -
Compila el archivo ZIP del comando de Python; en Windows, desactivado en otras plataformas
Etiquetas:affects_outputs
- Se acumulan
--catalyst_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se compilan los objetos binarios de Apple Catalyst.
Etiquetas:loses_incremental_state
,loading_and_analysis
--[no]collect_code_coverage
valor predeterminado: "false"-
Si se especifica, Bazel instrumentará código (con instrumentación sin conexión cuando sea posible) y recopilará información de cobertura durante las pruebas. Solo se verán afectados los objetivos que coincidan con --instrumentation_filter. Por lo general, esta opción no debe especificarse directamente; en su lugar, debes usar el comando "bazel esquema".
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
--conlyopt=<a string>
usos múltiples -
Es una opción adicional para pasar a gcc cuando se compilan archivos de origen C.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--copt=<a string>
usos múltiples -
Opciones adicionales para pasar a gcc.
Etiquetas:action_command_lines
,affects_outputs
--cpu=<a string>
predeterminado: ""-
La CPU de destino.
Etiquetas:changes_inputs
,affects_outputs
- Configuración predeterminada de
--cs_fdo_absolute_path=<a string>
: ver descripción - Usa la información del perfil de CSFDO para optimizar la compilación. Especifica el nombre de ruta de acceso absoluto del archivo ZIP que contiene el archivo de perfil, un archivo de perfil de LLVM sin procesar o indexado.
Etiquetas:affects_outputs
- Configuración predeterminada de
--cs_fdo_instrument=<a string>
: ver descripción - Genera objetos binarios con instrumentación de FDO sensible al contexto. Con el compilador Clang/LLVM, también acepta el nombre de directorio bajo el cual se volcarán los archivos de perfil sin procesar durante el tiempo de ejecución.
Etiquetas:affects_outputs
- Configuración predeterminada de
--cs_fdo_profile=<a build target label>
: ver descripción -
El cs_fdo_profile, que representa el perfil sensible al contexto que se usará para la optimización.
Etiquetas:affects_outputs
- Se acumulan
--cxxopt=<a string>
usos múltiples -
Es una opción adicional para pasar a gcc cuando se compilan archivos de origen C++.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--define=<a 'name=value' assignment>
usos múltiples -
Cada opción --define especifica una asignación para una variable de compilación. Si hay varios valores para una variable, ganará el último.
Etiquetas:changes_inputs
,affects_outputs
--dynamic_mode=<off, default or fully>
valor predeterminado: "default"-
Determina si los objetos binarios de C++ se vincularán de forma dinámica. “predeterminada” significa que Bazel elegirá si se vinculará de forma dinámica. "completamente" significa que todas las bibliotecas se vincularán de forma dinámica. “off” significa que todas las bibliotecas se vincularán en su mayor parte en modo estático.
Etiquetas:loading_and_analysis
,affects_outputs
- El valor predeterminado de
--[no]enable_fdo_profile_absolute_path
es "true" (verdadero). -
Si se configura, el uso de fdo_absolute_profile_path generará un error.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]enable_runfiles
: "auto" -
Habilita el árbol del symlink de los archivos de ejecución. De forma predeterminada, está desactivado en Windows y en otras plataformas.
Etiquetas:affects_outputs
- Se acumulan
--experimental_action_listener=<a build target label>
usos múltiples -
Se dio de baja a favor de los 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
valor predeterminado: "false"-
Comprime los recursos de Java en APK
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
- El valor predeterminado de
--[no]experimental_android_databinding_v2
es "true" (verdadero). - Usa Android Databinding v2. Esta marca es una no-op.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_android_resource_shrinking
valor 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
valor predeterminado: "false"-
usar la herramienta Rex para reescribir archivos dex
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_collect_code_coverage_for_generated_files
valor predeterminado: "false"-
Si se especifica, Bazel también generará información de cobertura para los archivos generados.
Etiquetas:affects_outputs
- El valor predeterminado de
--[no]experimental_convenience_symlinks
es "normal" -
Esta marca controla cómo se administrarán los symlinks de conveniencia (los que aparecen en el lugar de trabajo después de la compilación). Valores posibles: normal (predeterminado): Se creará o borrará cada tipo de symlink de conveniencia, según lo determine la compilación.
clean: Todos los symlinks se borrarán incondicionalmente.
ignorar: Los enlaces simbólicos no se verán afectados.
log_only: Genera mensajes de registro como si se pasaran “normales”, pero no realizas ninguna operación de sistema de archivos (útil para las herramientas).
Ten en cuenta que solo pueden verse afectados los symlinks cuyos nombres se generen por el valor actual de --symlink_prefix. Si el prefijo cambia, cualquier symlink preexistente quedará solo.
Etiquetas:affects_outputs
--[no]experimental_convenience_symlinks_bep_event
valor predeterminado: "false"-
Esta marca controla si publicaremos o no el evento de compilaciónConvenienceSymlinksIdentified en BuildEventProtocol. Si el valor es verdadero, BuildEventProtocol tendrá una entrada para convenienciaSymlinksIdentified y enumerará todos los symlinks de conveniencia creados en tu lugar de trabajo. Si es falso, la entrada convenienciaSymlinksIdentified en BuildEventProtocol estará vacía.
Etiquetas:affects_outputs
--experimental_objc_fastbuild_options=<comma-separated list of options>
predeterminado: "-O0,-DDEBUG=1"-
Usa estas cadenas como opciones del compilador objc fastbuild.
Etiquetas:action_command_lines
--[no]experimental_omitfp
valor predeterminado: "false"-
Si esta opción es "true", usa libunwind para desenrollar la pila y compila con -fomit-frame-pointer y -fasym-unwind-tables.
Etiquetas:action_command_lines
,affects_outputs
,experimental
- El valor predeterminado de
--experimental_output_paths=<off, content or strip>
es "desactivado" -
Indica qué modelo usar en qué parte de las reglas del árbol de resultados escriben sus resultados, en particular para compilaciones multiplataforma o de varias configuraciones. Esto es altamente experimental. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/6526. Las acciones de Starlark pueden habilitar la asignación de ruta agregando la clave “supports-path-mapping” al diccionario “execution_requirements”.
Etiquetas:loses_incremental_state
,bazel_internal_configuration
,affects_outputs
yexecution
- Se acumulan
--experimental_override_name_platform_in_output_dir=<a 'label=value' assignment>
usos múltiples -
Cada entrada debe tener el formato label=value, en el que la etiqueta hace referencia a una plataforma y los valores son el nombre corto deseado para usar en la ruta de acceso del resultado. Solo se usa cuando --experimental_platform_in_output_dir es verdadero. Tiene la prioridad de nombre más alta.
Etiquetas:affects_outputs
,experimental
--[no]experimental_platform_in_output_dir
valor 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: en primer lugar, en el caso poco frecuente de que la opción --platforms no tenga exactamente un valor, se utilizará un hash de la opción de plataformas. Luego, si --experimental_override_name_platform_in_output_dir registró algún nombre corto para la plataforma actual, entonces se utiliza ese nombre corto. Luego, si se configura --experimental_use_platforms_in_output_dir_legacy_heuristic, se debe utilizar un nombre corto basado en la etiqueta actual de la plataforma. Por último, se usa un hash de la opción de plataforma como último recurso.
Etiquetas:affects_outputs
,experimental
--[no]experimental_use_llvm_covmap
valor predeterminado: "false"-
Si se especifica, Bazel generará información del mapa de cobertura llvm-cov en lugar de gcov cuando collect_code_coverage esté habilitado.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
yexperimental
- El valor predeterminado de
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic
es "true" (verdadero). -
Usa esta marca solo como parte de una estrategia sugerida de migración o prueba. 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"-
Mediante la configuración de esta opción, se habilitan los APK multiarquitecturas, 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, --android_cpu se ignora para dependencias de reglas android_binary.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]fat_apk_hwasan
valor predeterminado: "false"-
Marca no-op. Se quitará en una versión futura.
Etiquetas:no_op
- Configuración predeterminada de
--fdo_instrument=<a string>
: ver descripción - Genera objetos binarios con instrumentación de FDO. Con el compilador Clang/LLVM, también acepta el nombre de directorio bajo el cual se volcarán los archivos de perfil sin procesar durante el tiempo de ejecución.
Etiquetas:affects_outputs
- Configuración predeterminada de
--fdo_optimize=<a string>
: ver 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 apunten a objetivos de `fdo_profile`. Esta marca será reemplazada por la regla “fdo_profile”.
Etiquetas:affects_outputs
- Configuración predeterminada de
--fdo_prefetch_hints=<a build target label>
: ver descripción -
Usa sugerencias de carga previa de caché.
Etiquetas:affects_outputs
- Configuración predeterminada de
--fdo_profile=<a build target label>
: ver descripción -
El fdo_profile, que representa el perfil que se utilizará para la optimización.
Etiquetas:affects_outputs
- Se acumulan
--features=<a string>
usos múltiples -
Estas funciones estarán habilitadas o inhabilitadas de forma predeterminada para los destinos integrados en la configuración de destino. Si especificas -<feature>, se inhabilitará la función. Los atributos negativos siempre anulan a los positivos. Consulta también --host_features
Etiquetas:changes_inputs
,affects_outputs
--[no]force_pic
valor predeterminado: "false"-
Si se habilita, todas las compilaciones de C++ producen código independiente de la posición ("-fPIC"), los vínculos prefieren bibliotecas PIC compiladas previamente en lugar de bibliotecas que no son PIC, y los vínculos producen ejecutables independientes de la posición ("-pie").
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan
--host_action_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica el conjunto de variables de entorno disponibles para acciones con configuraciones de ejecución. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o mediante el par nombre=valor que establece el valor independientemente del entorno de invocación. Esta opción se puede usar varias veces; para opciones proporcionadas para la misma variable, se acumulan los últimos éxitos, las opciones para diferentes variables se acumulan.
Etiquetas:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
valor predeterminado: "opt"- Especifica el modo en el que se integrarán las herramientas usadas durante la compilación. Valores: "fastbuild", "dbg", "opt".
Etiquetas:affects_outputs
,action_command_lines
- Se acumulan
--host_conlyopt=<a string>
usos múltiples -
Es una opción adicional para pasar al compilador C cuando se compilan archivos de origen C (pero no C++) en las configuraciones de ejecución.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--host_copt=<a string>
usos múltiples -
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: ""-
Es la CPU del host.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan
--host_cxxopt=<a string>
usos múltiples -
Opciones adicionales para pasar al compilador de C++ para herramientas compiladas en configuraciones de ejecución.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--host_features=<a string>
usos múltiples -
Las funciones determinadas estarán habilitadas o inhabilitadas de forma predeterminada para los destinos integrados en la configuración de ejecución. Si especificas -<feature>, se inhabilitará la función. Los atributos negativos siempre anulan a los positivos.
Etiquetas:changes_inputs
,affects_outputs
- Configuración predeterminada de
--host_force_python=<PY2 or PY3>
: ver descripción -
Anula la versión de Python para la configuración de ejecución. Puede ser “PY2” o “PY3”.
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan
--host_linkopt=<a string>
usos múltiples -
Es una opción adicional para pasar al vinculador cuando se vinculan herramientas en la configuración de ejecución.
Etiquetas:action_command_lines
,affects_outputs
- Configuración predeterminada de
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima de macOS compatible para los destinos de host. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
usos múltiples -
Son 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 aprobar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter significa una lista de patrones de expresiones regulares de inclusión y exclusión (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 ir entre comillas con una barra inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos gcc de todos los archivos cc en //foo/, excepto bar.cc.
Etiquetas:action_command_lines
,affects_outputs
--[no]incompatible_auto_exec_groups
valor predeterminado: "false"-
Cuando se habilita, se crea automáticamente un grupo de ejecutables 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
- El valor predeterminado de
--[no]incompatible_merge_genfiles_directory
es "true" (verdadero). -
Si es verdadero, el directorio genfiles se pliega en el directorio bin.
Etiquetas:affects_outputs
,incompatible_change
--[no]instrument_test_targets
valor predeterminado: "false"-
Cuando la cobertura está habilitada, especifica si se debe considerar la instrumentación de reglas de prueba. Cuando se establece, se instrumentan las reglas de prueba incluidas por --instrumentation_filter. De lo contrario, las reglas de prueba siempre se excluyen de la instrumentación de cobertura.
Etiquetas:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
valor predeterminado: "-/javatests[/:],-/test/java[/:]"-
Cuando la cobertura esté habilitada, solo se instrumentarán las reglas con nombres incluidos en el filtro basado en regex especificado. En su lugar, se excluyen las reglas con el prefijo “-”. Ten en cuenta que solo se instrumentan las reglas que no son de prueba, a menos que esté habilitado --instrument_test_targets.
Etiquetas:affects_outputs
- Configuración predeterminada de
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima de iOS compatible con los simuladores y dispositivos de destino. Si no se especifica, usa “ios_sdk_version”.
Etiquetas:loses_incremental_state
- Se acumulan
--ios_multi_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para compilar una ios_application. El resultado es un objeto binario universal que contiene todas las arquitecturas especificadas.
Etiquetas:loses_incremental_state
,loading_and_analysis
- El valor predeterminado de
--[no]legacy_whole_archive
es "true" (verdadero). -
Obsoleto y sustituido por --incompatible_remove_legacy_whole_archive (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener más información). Cuando esta opción está activada, se usa --whole-archive para reglas cc_binary que tengan linkshared=True y linkstatic=True o '-static' en linkopts. Esto es solo para retrocompatibilidad. Una mejor alternativa es usar Alwayslink=1 cuando sea necesario.
Etiquetas:action_command_lines
,affects_outputs
,deprecated
- Se acumulan
--linkopt=<a string>
usos múltiples -
Es una opción adicional para pasar a gcc durante la vinculación.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--ltobackendopt=<a string>
usos múltiples -
Es una opción adicional para pasar al paso de backend de LTO (en --features=thin_lto).
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--ltoindexopt=<a string>
usos múltiples -
Es una opción adicional para pasar al paso de indexación LTO (en --features=thin_lto).
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--macos_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se compilan objetos binarios de Apple macOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Configuración predeterminada de
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima de macOS compatible para los objetivos. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
- Configuración predeterminada de
--memprof_profile=<a build target label>
: ver descripción -
Usar el perfil de memprof.
Etiquetas:affects_outputs
--[no]objc_debug_with_GLIBCXX
valor predeterminado: "false"-
Si estableces la política y el modo de compilación está configurado como "dbg", define GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC y GLIBCPP_CONCEPT_CHECKS.
Etiquetas:action_command_lines
--[no]objc_enable_binary_stripping
valor predeterminado: "false"-
Determina si se deben quitar símbolos y códigos muertos en objetos binarios vinculados. Si se especifican esta marca y --compilation_mode=opt, se realizarán eliminaciones binarias.
Etiquetas:action_command_lines
- Se acumulan
--objccopt=<a string>
usos múltiples -
Opciones adicionales para pasar a gcc cuando se compilan archivos fuente Objective-C/C++.
Etiquetas:action_command_lines
- Se acumulan
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
usos múltiples -
Opciones adicionales para pasar selectivamente a gcc cuando se compilan ciertos archivos. Esta opción se puede aprobar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter significa una lista de patrones de expresiones regulares de inclusión y exclusión (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 ir entre comillas con una barra inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos gcc de todos los archivos cc en //foo/, excepto bar.cc.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
usos múltiples -
Opciones adicionales para pasar de forma selectiva al backend de LTO (en --features=thin_lto) cuando se compilan ciertos objetos de backend. Esta opción se puede aprobar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter significa una lista de patrones de expresiones regulares de inclusión y exclusión, y option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe ir entre comillas con una barra inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos del backend de LTO de todos los archivos o en //foo/, excepto bar.o.
Etiquetas:action_command_lines
,affects_outputs
- Configuración predeterminada de
--platform_suffix=<a string>
: ver descripción -
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas:loses_incremental_state
,affects_outputs
,loading_and_analysis
- Configuración predeterminada de
--propeller_optimize=<a build target label>
: ver descripción -
Usa la información del perfil de Propeller para optimizar el objetivo de compilación.Un perfil de propulsor debe constar de al menos uno de dos archivos, un perfil cc y un perfil ld. Esta marca acepta una etiqueta de compilación que debe hacer referencia a los archivos de entrada del perfil de propulsor. Por ejemplo, el archivo BUILD que define la etiqueta La opción debe usarse de la siguiente manera: --propeller_optimize=//a/b:propeller_profile
Etiquetas:action_command_lines
,affects_outputs
- Configuración predeterminada de
--propeller_optimize_absolute_cc_profile=<a string>
: ver descripción -
Nombre de ruta de acceso absoluto del archivo cc_profile para compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
- Configuración predeterminada de
--propeller_optimize_absolute_ld_profile=<a string>
: ver descripción -
Nombre de ruta de acceso absoluto del archivo ld_profile para compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
- Configuración predeterminada de
--run_under=<a prefix in front of command>
: ver descripción -
Es el prefijo que se debe insertar antes de los ejecutables para los comandos “test” y “run”. Si el valor es “foo -bar”, y la línea de comandos de ejecución es “test_binary -baz”, la línea de comandos final es “foo -bar test_binary -baz”. También puede ser una etiqueta para un destino ejecutable. Estos son algunos ejemplos: 'valgrind', 'strace', 'strace -c', 'valgrind --quiet --num-callers=20', '//package:target', '//package:target --options'.
Etiquetas:action_command_lines
-
Si es "true", las bibliotecas nativas que contengan la misma funcionalidad se compartirán entre diferentes destinos
Etiquetas:loading_and_analysis
,affects_outputs
--[no]stamp
valor predeterminado: "false"-
Sella los objetos binarios con la fecha, el nombre de usuario, el nombre de host, la información del lugar de trabajo, etcétera.
Etiquetas:affects_outputs
- El valor predeterminado de
--strip=<always, sometimes or never>
es " a veces". -
Especifica si se quitan los objetos binarios y las bibliotecas compartidas (con "-Wl,--strip-debug"). El valor predeterminado de "algunas veces" significa quitar iff --compilation_mode=fastbuild.
Etiquetas:affects_outputs
- Se acumulan
--stripopt=<a string>
usos múltiples -
Opciones adicionales para quitar cuando se genera un objeto binario “<name>.stripped”.
Etiquetas:action_command_lines
,affects_outputs
- Configuración predeterminada de
--symlink_prefix=<a string>
: ver descripción -
Es el prefijo que se antepone 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
--tvos_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se compilan objetos binarios de Apple tvOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Configuración predeterminada de
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima de tvOS compatible para simuladores de objetivo y dispositivos. Si no se especifica, se usa "tvos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan
--visionos_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se compilan objetos binarios de visionOS de Apple.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Se acumulan
--watchos_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se compilan objetos binarios de watchOS de Apple.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Configuración predeterminada de
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima de watchOS compatible para los simuladores y dispositivos de destino. Si no se especifica, se usa “watchos_sdk_version”.
Etiquetas:loses_incremental_state
- Configuración predeterminada de
--xbinary_fdo=<a build target label>
: ver 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 medida en la que Bazel aplica de manera estricta 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 entorno_group para asignarlo automáticamente a los valores de CPU a los valores target_environment.
Etiquetas:changes_inputs
,loading_and_analysis
,experimental
--[no]check_licenses
valor predeterminado: "false"-
Verifica que las restricciones de licencias impuestas por los paquetes dependientes no entren en conflicto con los modos de distribución de los destinos que se compilan. De forma predeterminada, las licencias no están marcadas.
Etiquetas:build_file_semantics
- El valor predeterminado de
--[no]check_visibility
es "true" (verdadero). - Si se inhabilita, los errores de visibilidad en las dependencias de destino descienden a advertencias.
Etiquetas:build_file_semantics
- El valor predeterminado de
--[no]desugar_for_android
es "true" (verdadero). -
Indica si se debe usar la expansión de sintaxis del código de bytes Java 8 antes de la conversión a DEX.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]desugar_java8_libs
valor predeterminado: "false"-
Determina si se deben incluir bibliotecas de Java 8 compatibles en apps para dispositivos heredados.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
yexperimental
- El valor predeterminado de
--[no]enforce_constraints
es "true" (verdadero). -
Verifica los entornos compatibles con cada destino y, luego, informa errores si algún destino tiene dependencias que no admiten los mismos entornos
Etiquetas:build_file_semantics
- El valor predeterminado de
--[no]experimental_check_desugar_deps
es "true" (verdadero). -
Indica si se debe verificar la expansión de sintaxis correcta a nivel binario de Android.
Etiquetas:eagerness_to_exit
,loading_and_analysis
,experimental
- Configuración predeterminada de
--experimental_import_deps_checking=<off, warning or error>
: "DESACTIVADA" -
Cuando se habilita, verifica si las dependencias de aar_import están completas. Esta aplicación puede dañar la compilación o simplemente generar advertencias.
Etiquetas:loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
valor predeterminado: "default"-
Si es verdadero, verifica que un destino de Java declare de forma explícita todos los destinos usados de forma directa como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files
valor predeterminado: "false"-
Si se habilita esta opción, verifica los objetivos de solo prueba de los requisitos previos que sean archivos de salida. Para ello, busca el solo de prueba de la regla de generación. Esto coincide con la verificación de visibilidad.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_check_visibility_for_toolchains
valor predeterminado: "false"-
Si se habilita, la verificación de visibilidad también se aplica a las implementaciones de las cadenas de herramientas.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_disable_native_android_rules
valor predeterminado: "false"-
Si se habilita, se inhabilita el uso directo de las reglas nativas de Android. Usa las reglas de Starlark para Android de https://github.com/bazelbuild/rules_android
Etiquetas:eagerness_to_exit
,incompatible_change
--[no]incompatible_disable_native_apple_binary_rule
valor predeterminado: "false"-
No-ops. Se conserva aquí para brindar retrocompatibilidad.
Etiquetas:eagerness_to_exit
,incompatible_change
- El valor predeterminado de
--[no]incompatible_python_disable_py2
es "true" (verdadero). -
Si es verdadero, usar la configuración de Python 2 generará un error. Esto incluye python_version=PY2, srcs_version=PY2 y srcs_version=PY2ONLY. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/15684.
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_validate_top_level_header_inclusions
es "true" (verdadero). -
Esta marca es una noop y se programó su eliminación.
Etiquetas:no_op
,incompatible_change
- Configuración predeterminada de
--python_native_rules_allowlist=<a build target label>
: ver descripción -
Una lista de entidades permitidas (objetivo de grupo de paquete) para usar cuando se aplique --incompatible_python_Disallow_native_rules.
Etiquetas:loading_and_analysis
--[no]strict_filesets
valor predeterminado: "false"- Si se habilita esta opción, los conjuntos de archivos que cruzan los límites de los paquetes se informan como errores.
Etiquetas:build_file_semantics
,eagerness_to_exit
- El valor predeterminado de
--strict_proto_deps=<off, warn, error, strict or default>
es "error" -
A menos que esté DESACTIVADO, verifica que un destino proto_library declare de forma explícita todos los destinos usados de forma directa como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
- El valor predeterminado de
--strict_public_imports=<off, warn, error, strict or default>
es "desactivado" -
A menos que esté DESACTIVADO, verifica que un destino proto_library declare de forma explícita todos los destinos usados en "import public" como exportados.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
--[no]strict_system_includes
valor 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
--target_environment=<a build target label>
usos múltiples -
Declara el entorno de destino de esta compilación. Debe ser una referencia de etiqueta a una regla de “entorno”. Si se especifica, todos los destinos 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 usa para firmar APKs
Etiquetas:action_command_lines
,affects_outputs
,loading_and_analysis
- El valor predeterminado de
--[no]device_debug_entitlements
es "true" (verdadero). -
Si se configura y el modo de compilación no es "opt", las apps de objc incluirán derechos de depuración durante la firma.
Etiquetas:changes_inputs
- Configuración predeterminada de
--ios_signing_cert_name=<a string>
: ver descripción -
Nombre del certificado que se usará para la firma de iOS. Si no la estableces, se recurrirá al perfil de aprovisionamiento. Puede ser la preferencia de identidad del llavero del certificado o (subcadena) del nombre común del certificado, según la página manual de la señal de código (SIGNING IDENTITIES).
Etiquetas:action_command_lines
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility
valor predeterminado: "false"-
Si es incompatible_enforce_config_setting_visibility=false, esta es una noop. De lo contrario, si la 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
- El valor predeterminado de
--[no]incompatible_disallow_legacy_py_provider
es "true" (verdadero). -
No-ops, se quitará pronto.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_sdk_frameworks_attributes
valor predeterminado: "false"-
Si el valor es "true", se inhabilitan los atributos sdk_frameworks y débil_sdk_frameworks en objc_library andobjc_import.
Etiquetas:build_file_semantics
,incompatible_change
- El valor predeterminado de
--[no]incompatible_enforce_config_setting_visibility
es "true" (verdadero). -
Si es verdadero, aplica restricciones de visibilidad config_setting. Si es falso, cada config_setting es visible para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_objc_alwayslink_by_default
valor predeterminado: "false"-
Si el valor predeterminado es "true", 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
valor 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 determinan el comportamiento del entorno de pruebas o del ejecutor de pruebas:
--[no]allow_analysis_failures
valor predeterminado: "false"-
Si es verdadero, una falla de análisis de un destino de regla provocará la propagación del objetivo de una instancia de AnalysisFailureInfo que contiene la descripción del error, en lugar de 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 mediante un atributo de regla con una transición de configuración for_analysis_testing. Si se supera ese límite, se mostrará un error de regla.
Etiquetas:loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure
valor predeterminado: "false"-
Si se producen errores reales en la acción de dex2oat, la compilación falla 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
valor predeterminado: "false"-
No ejecutes pruebas. Solo tienes que comprobar si están actualizadas. Si todos los resultados están actualizados, las pruebas se completarán de forma correcta. Si es necesario compilar o ejecutar alguna prueba, se informa un error y falla la prueba. Esta opción implica el comportamiento de --check_up_to_date.
Etiquetas:execution
- Se acumulan
--default_test_resources=<a resource name followed by equal and 1 float or 4 float, e.g memory=10,30,60,100>
usos múltiples - Anula la cantidad predeterminada de recursos para las pruebas. El formato esperado es <resource>=<value>. Si se especifica un solo número positivo como <value>, se anularán los recursos predeterminados para todos los tamaños de prueba. Si se especifican 4 números separados por comas, anularán la cantidad de recursos para los tamaños de prueba pequeños, medianos, grandes y, respectivamente. Los valores también pueden ser HOST_RAM/HOST_CPU, opcionalmente seguido de [-|*]<float> (p. ej., memoria=HOST_RAM*.1, HOST_RAM*.2, HOST_RAM*.3, HOST_RAM*.4). Los recursos de prueba predeterminados que especifica esta marca se anulan con los recursos explícitos especificados en las etiquetas.
--[no]experimental_android_use_parallel_dex2oat
valor predeterminado: "false"-
Usa dex2oat en paralelo para, quizás, acelerar android_test.
Etiquetas:loading_and_analysis
,host_machine_resource_optimizations
,experimental
- Se acumulan
--flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once>
usos múltiples -
Cada prueba se volverá a intentar la cantidad especificada de veces, en caso de que falle. Las pruebas que requieren más de un intento para aprobarse se marcan como "FLAKY" en el resumen. Normalmente, el valor especificado es solo un número entero o la cadena "default". Si es un número entero, todas las pruebas se ejecutarán hasta N veces. Si la política es "default", se realizará un solo intento para las pruebas regulares y tres para las pruebas marcadas explícitamente como inestables por su regla (falta=1). Sintaxis alternativa: regex_filter@flaky_test_attempts. Donde flaky_test_attempts es lo anterior y regex_filter significa una lista de patrones de expresiones regulares de inclusión y exclusión (también consulta --runs_per_test). Ejemplo: --flaky_test_attempts=//foo/.*,-//foo/bar/.*@3 disminuye todas las pruebas de //foo/ excepto las que se encuentran en foo/bar tres veces. Esta opción se puede aprobar varias veces. El último argumento pasado que coincida tendrá prioridad. Si no hay coincidencia, el comportamiento es “default” arriba.
Etiquetas:execution
--[no]ios_memleaks
valor predeterminado: "false"-
Habilita la comprobación de fugas de memoria en los destinos ios_test.
Etiquetas:action_command_lines
- Configuración predeterminada de
--ios_simulator_device=<a string>
: ver 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 que se ejecutará el simulador.
Etiquetas:test_runner
- Configuración predeterminada de
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Es la versión de iOS que se ejecutará en el simulador cuando se ejecute o realice pruebas. Esto se ignora para las reglas ios_test si se especifica un dispositivo de destino en la regla.
Etiquetas:test_runner
- Valor predeterminado de
--local_test_jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "auto" -
La cantidad máxima de trabajos de prueba locales que se ejecutan de forma simultánea. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguido 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 para que se ejecuten simultáneamente. Establecer este parámetro como mayor que el valor de --jobs no es eficaz.
Etiquetas:execution
- Se acumulan
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
usos múltiples - Especifica la cantidad de veces que se debe ejecutar cada prueba. Si alguno de esos intentos falla por algún motivo, toda la prueba se considerará fallida. Normalmente, el valor especificado es solo un número entero. Ejemplo: --runs_per_test=3 ejecutará todas las pruebas 3 veces. Sintaxis alternativa: regex_filter@runs_per_test. Donde run_per_test significa un valor de número entero y regex_filter significa una lista de patrones de expresiones regulares de inclusión y exclusión (también consulta --instrumentation_filter). Ejemplo: --runs_per_test=//foo/.*,-//foo/bar/.*@3 ejecuta todas las pruebas en //foo/ excepto las que se encuentran en foo/bar tres veces. Esta opción se puede aprobar varias veces. El último argumento pasado que coincida tendrá prioridad. Si no hay coincidencia, la prueba se ejecuta solo una vez.
- Se acumulan
--test_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
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á desde el entorno del cliente de Bazel o mediante el par nombre=valor. Esta opción se puede usar varias veces para especificar distintas variables. Solo lo usa el comando “bazel test”.
Etiquetas:test_runner
- El valor predeterminado de
--[no]test_keep_going
es "true" (verdadero). -
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 son exitosas.
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>
valor predeterminado: "-1"- Anula los valores predeterminados de tiempo de espera de la prueba (en segundos). Si se especifica un solo valor entero positivo, se anularán todas las categorías. Si se especifican 4 números enteros separados por comas, estos anularán los tiempos de espera: corto, moderado, largo y eterno (en ese orden). En cualquier forma, un valor de -1 le indica a blaze que use sus tiempos de espera predeterminados para esa categoría.
- Configuración predeterminada de
--test_tmpdir=<a path>
: ver descripción - Especifica el directorio temporal base que debe usar "bazel test".
- El valor predeterminado de
--[no]zip_undeclared_test_outputs
es "true" (verdadero). -
Si es verdadero, los resultados de pruebas no declarados se archivarán en un archivo ZIP.
Etiquetas:test_runner
- Opciones que activan optimizaciones del tiempo de compilación:
--cache_computed_file_digests=<a long integer>
predeterminado: "50000"- Si es mayor que 0, configura Bazel para que almacene en caché los resúmenes de archivos en la memoria en función de sus metadatos, en lugar de volver a calcular los resúmenes del disco cada vez que sean necesarios. Establecerlo en 0 garantiza la precisión, ya que no todos los cambios en el archivo se pueden anotar a partir de los metadatos. Si no es 0, el número indica el tamaño de la caché como la cantidad de resúmenes de archivos que se deben almacenar en caché.
--[no]experimental_enable_skyfocus
valor predeterminado: "false"-
Si es verdadero, habilita el uso de --experimental_working_set para reducir el uso de memoria de Bazel para compilaciones incrementales. Esta función se conoce como Skyfocus.
Etiquetas:host_machine_resource_optimizations
--[no]experimental_filter_library_jar_with_program_jar
valor predeterminado: "false"-
Filtra ProgramJar de ProGuard para quitar cualquier clase que también esté presente en LibraryJar.
Etiquetas:action_command_lines
- El valor predeterminado de
--[no]experimental_inmemory_dotd_files
es "true" (verdadero). -
Si se habilita, los archivos .d de C++ se pasarán directamente en la memoria desde los nodos de compilación remota, en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
yexperimental
- El valor predeterminado de
--[no]experimental_inmemory_jdeps_files
es "true" (verdadero). -
Si se habilita esta opción, los archivos de dependencia (.jdeps) generados a partir de compilaciones de Java se pasarán directamente a la memoria desde los nodos de compilación remota, en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
yexperimental
--[no]experimental_retain_test_configuration_across_testonly
valor predeterminado: "false"-
Cuando se habilita, --trim_test_configuration no recortará la configuración de prueba de las reglas marcadas como testonly=1. Esto tiene como objetivo reducir los problemas de conflicto de acciones cuando las reglas que no son de prueba dependen de las reglas cc_test. No tiene efecto si --trim_test_configuration es falso.
Etiquetas:loading_and_analysis
,loses_incremental_state
--[no]experimental_starlark_cc_import
valor predeterminado: "false"-
Si se habilita, se puede usar la versión de cc_import de Starlark.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_unsupported_and_brittle_include_scanning
valor predeterminado: "false"-
Determina si se deben reducir las entradas a la compilación de C/C++ analizando #include líneas de los archivos de entrada. Esto puede mejorar el rendimiento y la incrementalidad disminuyendo el tamaño de los árboles de entrada de la compilación. Sin embargo, también puede romper compilaciones porque el escáner de inclusión no implementa por completo la semántica del preprocesador de C. En particular, no comprende las directivas #include dinámicas e ignora la lógica condicional del preprocesador. Úsala bajo tu propia responsabilidad. Se cerrarán todos los problemas relacionados con esta marca que se presenten.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
--experimental_working_set=<comma-separated list of options>
predeterminado: ""-
El conjunto de tareas para Skyfocus. Especifica como rutas relativas de raíz de lugar de trabajo separadas por comas. Esta es una marca con estado. Cuando se define un conjunto de trabajo, este se conserva para invocaciones posteriores hasta que se redefine con un conjunto nuevo.
Etiquetas:host_machine_resource_optimizations
- El valor predeterminado de
--[no]incremental_dexing
es "true" (verdadero). -
Realiza la mayor parte del trabajo para la conversión a DEX por separado para cada archivo Jar.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Valor predeterminado de
--local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>
: "HOST_CPUS" -
Establece de forma explícita la cantidad total de núcleos de CPU locales disponibles para que Bazel invierta en acciones de compilación ejecutadas de forma local. Toma un número entero o "HOST_CPUS", opcionalmente seguido de [-|*]<float> (p. ej., HOST_CPUS*.5 para usar la mitad de los núcleos de CPU disponibles). De forma predeterminada, (“HOST_CPUS”), Bazel consultará la configuración del sistema para estimar la cantidad de núcleos de CPU disponibles.
Etiquetas:host_machine_resource_optimizations
- Se acumulan
--local_extra_resources=<a named float, 'name=value'>
usos múltiples -
Establece la cantidad de recursos adicionales disponibles para Bazel. Toma un par de cadena-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 necesarios. Las pruebas pueden declarar la cantidad de recursos adicionales que necesitan usando una etiqueta con el formato “resources:<resoucename>:<amount>”. La CPU, la RAM y los recursos disponibles no se pueden configurar con esta marca.
Etiquetas:host_machine_resource_optimizations
- Valor predeterminado de
--local_ram_resources=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
: "HOST_RAM*.67" -
Establece de forma explícita la cantidad total de RAM del host local (en MB) disponible para que Bazel invierta en acciones de compilación ejecutadas de forma local. Toma un número entero, o “HOST_RAM”, opcionalmente seguido de [-|*]<float> (p. ej., HOST_RAM*.5 para usar la mitad de la RAM disponible). De forma predeterminada, ("HOST_RAM*.67"), Bazel consultará la configuración del sistema para estimar la cantidad de RAM disponible y usará el 67%.
Etiquetas:host_machine_resource_optimizations
- Se acumulan
--local_resources=<a named double, 'name=value', where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
usos múltiples -
Establece la cantidad de recursos disponibles para Bazel. Toma una asignación a un número de punto flotante o a HOST_RAM/HOST_CPUS, opcionalmente seguido de [-|*]<float> (p. ej., memoria=HOST_RAM*.5 para usar la mitad de la RAM disponible). Se pueden usar varias veces para especificar varios tipos de recursos. Bazel limitará las acciones que se ejecutan de forma simultánea según los recursos disponibles y necesarios. Las pruebas pueden declarar la cantidad de recursos que necesitan con la etiqueta del formato “resources:<resource name>:<amount>”. Anula los recursos especificados por --local_{cpu|ram|extra}_resources.
Etiquetas:host_machine_resource_optimizations
- El valor predeterminado de
--[no]objc_use_dotd_pruning
es "true" (verdadero). -
Si se configura, se usarán los archivos .d emitidos por Clang para reducir el conjunto de entradas que se pasaron a compilaciones de objc.
Etiquetas:changes_inputs
,loading_and_analysis
--[no]process_headers_in_dependencies
valor 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
- El valor predeterminado de
--[no]trim_test_configuration
es "true" (verdadero). -
Cuando se habilita, las opciones relacionadas con pruebas se borrarán en el nivel superior de la compilación. Cuando esta marca está activa, las pruebas no se pueden compilar como dependencias de reglas que no sean de prueba, pero los cambios en las opciones relacionadas con pruebas no provocarán que las reglas que no son de prueba se vuelvan a analizar.
Etiquetas:loading_and_analysis
,loses_incremental_state
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--build_event_upload_max_retries=<an integer>
predeterminado: "4"-
Es la cantidad máxima de veces que Bazel debe reintentar subir un evento de compilación.
Etiquetas:bazel_internal_configuration
--[no]experimental_bep_target_summary
valor predeterminado: "false"- Determina si se publican eventos de TargetSummary.
--[no]experimental_build_event_expand_filesets
valor predeterminado: "false"-
Si es verdadero, expande los conjuntos de archivos en el BEP cuando presentes los archivos de salida.
Etiquetas:affects_outputs
--[no]experimental_build_event_fully_resolve_fileset_symlinks
valor predeterminado: "false"-
Si es verdadero, resuelve por completo los symlinks del conjunto de archivos relativos en el BEP cuando se presentan los archivos de salida. Requiere --experimental_build_event_expand_filesets.
Etiquetas:affects_outputs
- Valor predeterminado de
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
: "1 s" -
Retraso inicial y mínimo para los reintentos de retirada exponencial cuando falla la carga de BEP (exponente: 1.6)
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--experimental_build_event_upload_strategy=<a string>
: ver descripción -
Selecciona cómo subir los artefactos a los que se hace referencia en el protocolo de eventos de compilación.
Etiquetas:affects_outputs
--[no]experimental_materialize_param_files_directly
valor predeterminado: "false"-
Si materializas archivos de parámetros, hazlo con escrituras directas en el disco.
Etiquetas:execution
--[no]experimental_run_bep_event_include_residue
valor predeterminado: "false"-
Determina 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 de comandos de ejecución que podrían contenerlo.
Etiquetas:affects_outputs
- La configuración predeterminada de
--experimental_skyfocus_dump_keys=<none, count or verbose>
es “ninguna” -
Para depurar Skyfocus. Vuelca las SkyKeys enfocadas (raíces, hojas, dependencias enfocadas, rdeps enfocadas).
Etiquetas:terminal_output
--[no]experimental_skyfocus_dump_post_gc_stats
valor predeterminado: "false"-
Para depurar Skyfocus. Si se habilita esta opción, activa la recolección manual antes o después del enfoque para informar reducciones de tamaño de montón. Esto aumentará la latencia de Skyfocus.
Etiquetas:terminal_output
--[no]experimental_stream_log_file_uploads
valor predeterminado: "false"-
Transmite las cargas de archivos de registro directamente al almacenamiento remoto en lugar de escribirlos en el disco.
Etiquetas:affects_outputs
- Configuración predeterminada de
--explain=<a path>
: ver descripción -
Hace que el sistema de compilación explique cada paso ejecutado de la compilación. La explicación se escribe en el archivo de registro especificado.
Etiquetas:affects_outputs
- El valor predeterminado de
--[no]legacy_important_outputs
es "true" (verdadero). -
Usa esta opción para suprimir la generación del campo relevant_outputs heredado en el evento TargetComplete. Para la integración de Bazel a ResultStore, se requiere relevant_outputs.
Etiquetas:affects_outputs
--[no]materialize_param_files
valor predeterminado: "false"-
Escribe archivos de parámetros intermedios para generar un árbol incluso cuando se usa la ejecución de acciones remotas. Es útil para depurar acciones. Esto está implícito por --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 asignado es -1, se mostrarán todas las opciones modificadas.
Etiquetas:terminal_output
--max_test_output_bytes=<an integer>
valor predeterminado: "-1"-
Especifica el tamaño máximo por registro de prueba que puede emitirse cuando --test_output es “errores” o “todos”. Es útil para evitar abrumar el resultado con un resultado de prueba demasiado ruidoso. 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
- Configuración predeterminada de
--output_filter=<a valid Java regular expression>
: ver descripción -
Solo muestra advertencias y resultados de acciones para las reglas cuyo nombre coincida con la expresión regular proporcionada.
Etiquetas:affects_outputs
--progress_report_interval=<an integer in 0-3600 range>
predeterminado: "0"-
La cantidad de segundos que se debe esperar entre los informes de los trabajos que aún se están ejecutando. El valor predeterminado 0 significa que el primer informe se imprimirá después de 10 segundos; luego, 30 segundos; después de ese progreso, se informa una vez por minuto. Cuando --curses está habilitado, el progreso se informa cada segundo.
Etiquetas:affects_outputs
--show_result=<an integer>
predeterminado: "1"-
Muestra los resultados de la compilación. Para cada destino, indica si se actualizó o no y, de ser así, una lista de los archivos de salida que se crearon. Los archivos impresos son cadenas convenientes para copiar y pegar en la shell a fin de ejecutarlos.
Esta opción requiere un argumento de número entero, que es el umbral de objetivos por encima del cual no se imprime la información del resultado. Por lo tanto, cero provoca la supresión del mensaje y MAX_INT hace que la impresión del resultado ocurra siempre. El valor predeterminado es uno.
Si no se compiló nada para un objetivo, es posible que se omitan sus resultados a fin de mantener los resultados por debajo del umbral.
Etiquetas:affects_outputs
--[no]subcommands
[-s
] predeterminado: "false"-
Muestra los subcomandos que se ejecutaron durante una compilación. Marcas relacionadas: --execution_log_json_file, --execution_log_binary_file (para registrar subcomandos en un archivo en un formato compatible con herramientas).
Etiquetas:terminal_output
--test_output=<summary, errors, all or streamed>
valor 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 “stream” para generar los registros de todas las pruebas en tiempo real (esto forzará a que las pruebas se ejecuten de forma local, una a la vez, sin importar el valor de --test_strategy).
Etiquetas:test_runner
,terminal_output
,execution
--test_summary=<short, terse, detailed, none or testcase>
valor predeterminado: "short"-
Especifica el formato deseado del resumen de la prueba. Los valores válidos son “corto” para imprimir información solo sobre las pruebas ejecutadas; “terse”, para imprimir solo información sobre las pruebas fallidas que se ejecutaron, “detallado” para imprimir información detallada sobre casos de prueba con errores, “caso de prueba” para imprimir el resumen en la resolución del caso de prueba, no imprimir información detallada sobre casos de prueba fallidos y “ninguno” para omitir el resumen.
Etiquetas:terminal_output
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
predeterminado: "-.*"-
Imprime información de depuración durante la resolución de la cadena de herramientas. La marca toma una regex, que se compara con tipos de cadenas de herramientas y objetivos específicos para ver cuál depurar. Varias regex se pueden separar por comas y, luego, cada regex se verifica por separado. Nota: El resultado de esta marca es muy complejo y probablemente solo sea útil para los expertos en la resolución de la cadena de herramientas.
Etiquetas:terminal_output
--[no]verbose_explanations
valor predeterminado: "false"-
Aumenta la verbosidad de las explicaciones emitidas si --explain está habilitado. No tiene ningún efecto si --explain no está habilitado.
Etiquetas:affects_outputs
--[no]verbose_failures
valor predeterminado: "false"-
Si un comando falla, imprime la línea de comandos completa.
Etiquetas:terminal_output
- Opciones que especifican o modifican una entrada genérica a un comando de Bazel que no se incluye en otras categorías:
- Se acumulan
--aspects_parameters=<a 'name=value' assignment>
usos múltiples -
Especifica los valores de los parámetros de aspectos de la línea de comandos. Cada valor del parámetro se especifica con <param_name>=<param_value>. Por ejemplo, 'my_param=my_val', donde 'my_param' es un parámetro de algún aspecto en la lista --aspects o lo requiere un aspecto de la lista. Esta opción se puede usar varias veces. Sin embargo, no se puede asignar valores al mismo parámetro más de una vez.
Etiquetas:loading_and_analysis
- Se acumulan
--flag_alias=<a 'name=value' flag alias>
usos múltiples - Establece un nombre abreviado para una marca de Starlark. Toma un solo par clave-valor con el formato "<key>=<value>" como argumento.
Etiquetas:changes_inputs
--[no]incompatible_default_to_explicit_init_py
valor 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. De manera precisa, cuando un destino py_binary o py_test tiene legacy_create_init configurado como "auto" (predeterminado), se trata como falso si y solo si esta marca está configurada. Consulta https://github.com/bazelbuild/bazel/issues/10076.
Etiquetas:affects_outputs
,incompatible_change
- El valor predeterminado de
--[no]incompatible_py2_outputs_are_suffixed
es "true" (verdadero). -
Si es verdadero, los destinos compilados en la configuración de Python 2 aparecerán bajo 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 los 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
- El valor predeterminado de
--[no]incompatible_py3_is_default
es "true" (verdadero). -
Si el valor es true, los destinos `py_binary` y `py_test` que no establecen su atributo `python_version` (o `default_python_version`) se establecerán de forma predeterminada como PY3 en lugar de PY2. Si estableces esta marca, también se recomienda configurar `--incompatible_py2_outputs_are_sufsolution`.
Etiquetas:loading_and_analysis
,affects_outputs
,incompatible_change
- El valor predeterminado de
--[no]incompatible_use_python_toolchains
es "true" (verdadero). -
Si se configura como verdadera, las reglas nativas ejecutables de Python usarán el entorno de ejecución de Python especificado por la cadena de herramientas de Python, en lugar del entorno de ejecución proporcionado por marcas heredadas como --python_top.
Etiquetas:loading_and_analysis
,incompatible_change
- Configuración predeterminada de
--python_version=<PY2 or PY3>
: ver descripción -
Es el modo de versión principal de Python, que puede ser “PY2” o “PY3”. Ten en cuenta que los objetivos “py_binary” y “py_test” anulan esto (incluso si no especifican explícitamente una versión), por lo que, por lo general, no hay muchas razones para proporcionar esta marca.
Etiquetas:loading_and_analysis
,affects_outputs
--target_pattern_file=<a string>
predeterminado: ""-
Si se configura, la compilación leerá los patrones del archivo que se menciona aquí, en lugar de hacerlo en la línea de comandos. Es un error especificar un archivo aquí, así como patrones de la línea de comandos.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remoto:
--experimental_remote_cache_eviction_retries=<an integer>
predeterminado: "0"-
La cantidad máxima de intentos de reintento si la compilación detectó 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 verifica el código de salida 39.
Etiquetas:execution
- El valor predeterminado de
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
es "true" (verdadero). -
Si se configura como verdadera, Bazel usará el nuevo código de salida 39 en lugar del 34 si la caché remota expulsa los BLOB durante la compilación.
Etiquetas:incompatible_change
- Opciones varias, que no están categorizadas:
- El valor predeterminado de
--[no]allow_analysis_cache_discard
es "true" (verdadero). -
Si se descarta la caché de análisis debido a un cambio en el sistema de compilación, configurar esta opción como falsa provocará que Bazel salga, 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
valor predeterminado: "false"- Fuerza la compilación de objetivos de prueba etiquetados como “manuales”. 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. Cada etiqueta puede estar precedida opcionalmente por “-” para especificar las etiquetas excluidas. Solo se crearán aquellos destinos que contengan al menos una etiqueta incluida y no contengan ninguna etiqueta excluida. Esta opción no afecta el conjunto de pruebas ejecutadas con el comando “test”, ya que se rigen por las opciones de filtrado de pruebas, por ejemplo, “--test_tag_filters”.
--[no]build_tests_only
valor predeterminado: "false"- Si se especifica, solo se compilarán las reglas *_test y test_suite, y se ignorarán otros destinos especificados en la línea de comandos. De forma predeterminada, se compilará todo lo que se solicitó.
--[no]cache_test_results
[-t
] predeterminado: "auto"- Si se configura como "auto", Bazel vuelve a ejecutar una prueba solo si (1) Bazel detecta cambios en la prueba o sus dependencias, (2) la prueba se marca como externa, (3) se solicitaron varias ejecuciones de prueba con --runs_per_test o(4) si la prueba falló anteriormente. Si se configura como “sí”, Bazel almacena en caché todos los resultados de la prueba, excepto las que se marcaron como externas. Si se configura como “no”, Bazel no almacena en caché ningún resultado de prueba.
--[no]compile_one_dependency
valor predeterminado: "false"- Compila una sola dependencia de los archivos de argumentos. Esto es útil para verificar la sintaxis de los archivos de origen en IDE, por ejemplo, cuando vuelves a compilar un solo destino que depende del archivo de origen 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 marcadores; en lugar de ser objetivos para compilar, son nombres de archivo de origen. Para cada nombre de archivo de origen, se compilará un destino arbitrario que dependa de él.
- Se acumulan
--deleted_packages=<comma-separated list of package names>
usos múltiples - Una lista separada por comas de los nombres de los paquetes que el sistema de compilación considerará que no existen, incluso si están visibles en algún lugar de la ruta del paquete. Usa esta opción cuando borres un subpaquete 'x/y' de un paquete 'x' existente. Por ejemplo, después de borrar x/y/BUILD en el cliente, el sistema de compilación puede presentar un reclamo si encuentra la etiqueta '//x:y/z' si todavía la proporciona otra entrada package_path. Si especificas --deleted_packages x/y se evita este problema.
--[no]discard_analysis_cache
valor predeterminado: "false"- Descartar la caché de análisis inmediatamente después de que se complete la fase de análisis. Reduce el uso de memoria en aproximadamente un 10%, pero ralentiza las compilaciones incrementales adicionales.
- Configuración predeterminada de
--execution_log_binary_file=<a path>
: ver descripción - Registra las generaciones ejecutadas en este archivo como protos SpawnExec delimitados por longitud, de acuerdo con src/main/protobuf/spawn.proto. Marcas relacionadas: --execution_log_json_file (formato JSON de texto; excluyente mutuamente), --execution_log_sort (si se debe ordenar el registro de ejecución), --subcomandos (para mostrar subcomandos en el resultado de la terminal).
- Configuración predeterminada de
--execution_log_json_file=<a path>
: ver descripción - Registra las generaciones ejecutadas en este archivo como representaciones JSON delimitadas por saltos de línea de los archivos proto de SpawnExec, de acuerdo con 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), --subcomandos (para mostrar subcomandos en el resultado de terminal).
- El valor predeterminado de
--[no]execution_log_sort
es "true" (verdadero). - Indica si se debe ordenar el registro de ejecución para facilitar la comparación de los registros en las invocaciones. Se establece como false para evitar un uso potencialmente significativo de CPU y memoria al final de la invocación, a costa de producir el registro en orden de ejecución no determinista. Solo se aplica a los formatos binarios y JSON; el formato compacto nunca se ordena.
- El valor predeterminado de
--[no]expand_test_suites
es "true" (verdadero). -
Amplía los objetivos de test_suite en las pruebas constituyentes antes del análisis. Cuando esta marca está activada (configuración predeterminada), se aplicarán patrones de objetivo negativos a las pruebas que pertenezcan al paquete de pruebas; de lo contrario, no. Desactivar esta marca es útil cuando los aspectos de nivel superior se aplican en la línea de comandos: entonces pueden analizar los objetivos de test_suite.
Etiquetas:loading_and_analysis
--[no]experimental_cancel_concurrent_tests
valor predeterminado: "false"-
Si es "true", el Blaze cancelará las pruebas que se ejecutan de forma simultánea en la primera ejecución exitosa. Esto solo es útil en combinación con --runs_per_test_detects_flakes.
Etiquetas:affects_outputs
,loading_and_analysis
- Configuración predeterminada de
--experimental_execution_log_compact_file=<a path>
: ver descripción - Registra las generaciones ejecutadas en este archivo como protos ExecLogEntry delimitados por longitud, de acuerdo con src/main/protobuf/spawn.proto. El archivo completo está comprimido en zstd. Este es un formato experimental en desarrollo activo y puede cambiar en cualquier momento. Marcas relacionadas: --execution_log_binary_file (formato protobuf binario; mutuamente excluyente), --execution_log_json_file (formato JSON de texto; mutuamente excluyentes), --subcomandos (para mostrar subcomandos en el resultado de terminal).
--experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
predeterminado: ""- Se dio de baja a favor de los aspectos. Filtra el conjunto de objetivos para los que se programan acciones adicionales.
--[no]experimental_extra_action_top_level_only
valor predeterminado: "false"- Se dio de baja a favor de los aspectos. Solo programa las acciones adicionales para los objetivos de nivel superior.
--[no]experimental_fetch_all_coverage_outputs
valor 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
valor predeterminado: "false"-
Si es "true", la cobertura de Clang generará un informe de LCOV.
Etiquetas:affects_outputs
,loading_and_analysis
- El valor predeterminado de
--[no]experimental_j2objc_header_map
es "true" (verdadero). - Indica si se debe generar el mapa de encabezados de J2ObjC en paralelo de la transpilación de J2ObjC.
--[no]experimental_j2objc_shorter_header_path
valor predeterminado: "false"-
Indica si se debe generar con una ruta de encabezado más corta (usa "_ios" en lugar de "_j2objc").
Etiquetas:affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
predeterminado: "javabuilder"- Habilita rutas de clase reducidas para compilaciones de Java.
--[no]experimental_limit_android_lint_to_android_constrained_java
valor predeterminado: "false"- Limita --experimental_run_android_lint_on_java_rules a bibliotecas compatibles con Android.
Etiquetas:affects_outputs
--[no]experimental_run_android_lint_on_java_rules
valor predeterminado: "false"- Determina si se deben validar las fuentes java_*.
Etiquetas:affects_outputs
--[no]explicit_java_test_deps
valor predeterminado: "false"- Especifica de forma explícita una dependencia a JUnit o Hamcrest en una java_test, en lugar de obtenerla accidentalmente desde las dependencias de TestRunner. Por el momento, solo funciona para Bazel.
- El valor predeterminado de
--[no]fetch
es "true" (verdadero). - Permite que el comando recupere dependencias externas. Si se establece como falsa, el comando usará cualquier versión almacenada en caché de la dependencia. Si no existe ninguna, el comando fallará.
- Configuración predeterminada de
--host_java_launcher=<a build target label>
: ver descripción - El Selector de Java utilizado por las herramientas que se ejecutan durante una compilación.
- Se acumulan
--host_javacopt=<a string>
usos múltiples - Son opciones adicionales para pasar a javac cuando se compilan herramientas que se ejecutan durante una compilación.
- Se acumulan
--host_jvmopt=<a string>
usos múltiples - Opciones adicionales para pasar a la VM de Java cuando se compilan herramientas que se ejecutan durante la compilación. Estas opciones se agregarán a las opciones de inicio de la VM de cada destino java_binary.
- El valor predeterminado de
--[no]incompatible_check_sharding_support
es "true" (verdadero). -
Si es verdadero, Bazel fallará una prueba fragmentada si el ejecutor de pruebas no indica que admite la fragmentación tocando el archivo en la ruta de acceso en TEST_SHARD_STATUS_FILE. Si es falso, un ejecutor de pruebas que no admita la fragmentación hará que se ejecuten todas las pruebas en cada fragmento.
Etiquetas:incompatible_change
- El valor predeterminado de
--[no]incompatible_exclusive_test_sandboxed
es "true" (verdadero). -
Si es verdadero, se ejecutarán pruebas exclusivas con la estrategia de zona de pruebas. Agrega la etiqueta “local” para forzar una ejecución de prueba exclusiva de forma local.
Etiquetas:incompatible_change
--[no]incompatible_strict_action_env
valor predeterminado: "false"-
Si es verdadero, Bazel usa un entorno con un valor estático para PATH y no hereda LD_LIBRARY_PATH. Usa --action_env=ENV_VARIABLE si deseas heredar variables de entorno específicas del cliente, pero ten en cuenta que esto puede evitar el almacenamiento en caché entre usuarios si se usa una caché compartida.
Etiquetas:loading_and_analysis
,incompatible_change
- Se acumulan
--j2objc_translation_flags=<comma-separated list of options>
usos múltiples - Opciones adicionales para pasar a la herramienta J2ObjC.
--java_debug
-
Hace que la máquina virtual Java de una prueba de Java espere una conexión de un depurador compatible con JDWP (como jdb) antes de comenzar la prueba. Insinúa -test_output=streamed.
Se expande a:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
- El valor predeterminado de
--[no]java_deps
es "true" (verdadero). - Genera información de dependencias (por ahora, la ruta de clase en tiempo de compilación) por destino de Java.
- El valor predeterminado de
--[no]java_header_compilation
es "true" (verdadero). - Compila ijars directamente desde la fuente.
--java_language_version=<a string>
predeterminado: ""- La versión del lenguaje Java
- Configuración predeterminada de
--java_launcher=<a build target label>
: ver descripción - El Selector de Java que se usa cuando se compilan objetos binarios de Java. Si esta marca se establece en una cadena vacía, se usa el selector de JDK. El atributo "launcher" anula esta marca.
--java_runtime_version=<a string>
valor predeterminado: "local_jdk"- La versión del entorno de ejecución de Java
- Se acumulan
--javacopt=<a string>
usos múltiples - Opciones adicionales para pasar a javac.
- Se acumulan
--jvmopt=<a string>
usos múltiples - Opciones adicionales para pasar a la VM de Java. Estas opciones se agregarán a las opciones de inicio de la VM de cada destino java_binary.
- Configuración predeterminada de
--legacy_main_dex_list_generator=<a build target label>
: ver descripción - Especifica un objeto binario que se usará para generar la lista de clases que deben estar en el DEX principal cuando se compila multidex heredado.
--local_termination_grace_seconds=<an integer>
predeterminado: "15"- Tiempo de espera entre la finalización de un proceso local debido al tiempo de espera y el cierre forzado.
- Configuración predeterminada de
--optimizing_dexer=<a build target label>
: ver descripción - Especifica un objeto binario que se usará para realizar la conversión a DEX sin fragmentar.
--package_path=<colon-separated list of options>
predeterminado: "%workspace%"- Una lista separada por dos puntos sobre dónde buscar paquetes. Los elementos que comienzan con "%workspace%" son relativos al lugar de trabajo que lo contiene. Si se omite o está vacío, el valor predeterminado es el resultado de “bazel info default-package-path”.
- Se acumulan
--plugin=<a build target label>
usos múltiples - Complementos para usar en la compilación. Actualmente, funciona con java_plugin.
- Configuración predeterminada de
--proguard_top=<a build target label>
: ver descripción - Especifica qué versión de ProGuard se usará para quitar código cuando se compile un objeto binario de Java.
--proto_compiler=<a build target label>
predeterminado: "@bazel_tools//tools/proto:protoc"-
Es la etiqueta del compilador de protocolos.
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 j2objc
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
valor 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>
valor 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
--protocopt=<a string>
usos múltiples -
Son opciones adicionales para pasar al compilador de protobuf.
Etiquetas:affects_outputs
--[no]runs_per_test_detects_flakes
valor predeterminado: "false"- Si es verdadero, cualquier fragmento en el que al menos una ejecución o un intento se complete y al menos uno falle tenga un estado FLAKY.
- Configuración predeterminada de
--shell_executable=<a path>
: ver descripción -
Ruta de acceso absoluta al shell ejecutable para que lo use Bazel. Si no se configura, pero la variable de entorno BAZEL_SH está configurada en la primera invocación de Bazel (que inicia un servidor de Bazel), Bazel la usa. Si no se establece ninguno, Bazel usa una ruta de acceso predeterminada hard-coded 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 el uso de una shell que no es compatible con Bash puede provocar fallas de compilación o de tiempo de ejecución de los objetos binarios generados.
Etiquetas:loading_and_analysis
- El valor predeterminado de
--[no]show_loading_progress
es "true" (verdadero). - Si se habilita, hace que Bazel imprima mensajes "Cargando paquete:".
- Se acumulan
--test_arg=<a string>
usos múltiples - 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 recibirá argumentos idénticos. Solo lo usa el comando “bazel test”.
- Configuración predeterminada de
--test_filter=<a string>
: ver descripción - Especifica un filtro para reenviar al framework de pruebas. Se usa para limitar la ejecución de pruebas. 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 las ubicaciones de prueba que estén escritas en los idiomas especificados. El nombre que se usa para cada lenguaje debe ser el mismo que el prefijo de idioma en la regla *_test, p.ej., "cc", "java", "py", etc. Esta opción afecta el comportamiento de --build_tests_only y el comando de prueba.
--test_result_expiration=<an integer>
valor predeterminado: "-1"- Esta opción dejó de estar disponible y no tiene efecto.
--[no]test_runner_fail_fast
valor predeterminado: "false"- Reenvía la opción de falla rápida al ejecutor de pruebas. El ejecutor de pruebas debe detener la ejecución en la primera falla.
- Valor predeterminado de
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>
: "explícito" - Especifica una estrategia para la fragmentación de pruebas: "explícito" para usar solo la fragmentación si está presente el atributo de COMPILACIÓN "shard_count". “inhabilitado” para no usar nunca la fragmentación de pruebas. "forced=k" permite aplicar "k" fragmentos para las pruebas, sin importar el atributo de 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. Cada tamaño puede estar precedido opcionalmente por “-” 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 de prueba.
--test_tag_filters=<comma-separated list of options>
predeterminado: ""- Especifica una lista de etiquetas de prueba separadas por comas. Cada etiqueta puede estar precedida opcionalmente por “-” para especificar las etiquetas excluidas. Solo se encontrarán los destinos de prueba que contengan al menos una etiqueta incluida y no contengan ninguna etiqueta excluida. Esta opción afecta el comportamiento de --build_tests_only y el comando de prueba.
--test_timeout_filters=<comma-separated list of values: short, moderate, long or eternal>
predeterminado: ""- Especifica una lista separada por comas de tiempos de espera de pruebas. Cada tiempo de espera puede estar precedido opcionalmente por “-” para especificar los tiempos de espera excluidos. Solo se encontrarán los destinos 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 de prueba.
--tool_java_language_version=<a string>
predeterminado: ""- La versión del lenguaje Java que se usa para ejecutar las herramientas que se necesitan 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
- El valor predeterminado de
--[no]use_ijars
es "true" (verdadero). - Si se habilita, esta opción hace que la compilación de Java use archivos jar de la interfaz. Esto dará como resultado una compilación incremental más rápida, pero los mensajes de error pueden ser diferentes.
Opciones de marcas de canonicalización
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Más lugares donde buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
valor predeterminado: "false"-
Si se configura, la caché del repositorio vinculará el archivo de forma fija en caso de un acierto de caché, en lugar de copiar. Esto sirve para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Usa este factor para escalar todos los tiempos de espera en las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que sean 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 para descargas de http.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--http_connector_retry_max_timeout=<An immutable length of time.>
: "0 s" -
Es el tiempo de espera máximo para los reintentos de descarga de HTTP. Con el valor 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 descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación en caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché; de lo contrario, se usa el valor predeterminado “<output_user_root>/cache/repos/v1”
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
valor predeterminado: "false"-
Si se establece esta configuración, no se permitirá la descarga con ="{.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no está completamente deshabilitado; ="{.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"-
Indica el porcentaje de espacio ocupado (0-100) por encima del cual GcThrashingDetector considera los eventos de presión de la memoria en función de sus límites (--gc_thrashing_limits). Si se configura en 100, GcThrashingDetector se inhabilita.
Etiquetas:host_machine_resource_optimizations
- Opciones que controlan el resultado del comando:
--[no]canonicalize_policy
valor predeterminado: "false"-
Muestra la política canónica, después de la expansión y el filtrado. Para mantener el resultado limpio, los argumentos del comando canonicalizados NO se mostrarán cuando esta opción se establezca en true. Ten en cuenta que el comando especificado por --for_command afecta la política filtrada y, si no se especifica ninguno, el comando predeterminado es "build".
Etiquetas:affects_outputs
,terminal_output
- El valor predeterminado de
--[no]experimental_include_default_values
es "true" (verdadero). -
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 de 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
valor predeterminado: "false"-
Si es incompatible_enforce_config_setting_visibility=false, esta es una noop. De lo contrario, si la 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
- El valor predeterminado de
--[no]incompatible_depset_for_java_output_source_jars
es "true" (verdadero). -
No-ops
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_enforce_config_setting_visibility
es "true" (verdadero). -
Si es verdadero, aplica restricciones de visibilidad config_setting. Si es falso, cada config_setting es visible para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_new_actions_api
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,incompatible_change
- El valor predeterminado de
--[no]incompatible_visibility_private_attributes_at_definition
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,incompatible_change
- El valor predeterminado de
--[no]separate_aspect_deps
es "true" (verdadero). -
No-op
Etiquetas:no_op
- Opciones relacionadas con la semántica y el resultado de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Especificaste las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirá en el gráfico de dependencias resueltas incluso si se declararon de forma privada en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones anteriores harán que la resolución falle. También puedes definir la versión transferida 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
- El valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
es "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 una falla de resolución, “off” para inhabilitar la verificación o “warning” para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas `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 detecte una discrepancia o “error” para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
valor predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
valor predeterminado: "actualizar"-
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son “update” para usar el archivo de bloqueo y actualizarlo si hay cambios; “error” para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o “off” para no leerlo ni escribirlo en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y se recurrirá únicamente a los posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Configuración predeterminada de
--vendor_dir=<a path>
: ver descripción -
Especifica el directorio que debe contener los repositorios externos en modo de proveedor, ya sea con el fin de recuperarlos o usarlos durante la compilación. La ruta de acceso se puede especificar como una ruta de acceso absoluta o una ruta relativa al directorio del lugar de trabajo.
Etiquetas:loading_and_analysis
- 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 fallar Bazel con un OOM. Cada límite se especifica como <period>:<count>, donde el período es una duración y el recuento es un número entero positivo. Si más del --gc_thrashing_threshold por ciento del espacio titular (montón de generación anterior) permanece ocupado después de <count> GC completas consecutivas dentro de <period>, se activa una 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"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje de montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC completo, descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos de GC completos nunca activarán disminuciones. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de recolección de elementos no utilizados completo y se supere el umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje de montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC menor, descartará el estado temporal innecesario de Skyframe, hasta esta cantidad por invocación. El valor predeterminado es Integer.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos menores de GC nunca activarán disminuciones. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento menor de recolección de elementos no utilizados y se supere el umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje retenido de montón está al menos en este umbral, descartará el estado temporal innecesario de Skyframe. Un ajuste puede permitirte mitigar el impacto de la hiperpaginación de la GC en el tiempo, cuando esta (i) causa el uso de memoria de este estado temporal y (ii) es más costosa que reconstruir el estado cuando es necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Configuración predeterminada de
--experimental_command_profile=<cpu, wall, alloc or lock>
: ver descripción - Registra un perfil de grabadora de vuelo de Java mientras dure el comando. Se debe proporcionar uno de los tipos de eventos de generación de perfiles admitidos (cpu, muro, alloc o bloqueo) como argumento. El perfil se escribe en un archivo con el nombre del tipo de evento en el directorio base de salida. La sintaxis y semántica de esta marca podría cambiar en el futuro para admitir tipos de perfil o formatos de salida adicionales; úsala bajo tu responsabilidad.
--[no]experimental_record_metrics_for_all_mnemonics
valor predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán estadísticas para todos los mnemotécnicos.
- 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
--for_command=<a string>
valor predeterminado: "build"-
Es el comando para el que se deben canonicalizar las opciones.
Etiquetas:affects_outputs
,terminal_output
--invocation_policy=<a string>
predeterminado: ""-
Aplica una política de invocación a las opciones que se canonicalizarán.
Etiquetas:affects_outputs
,terminal_output
- Opciones de ejecución y almacenamiento en caché remoto:
- Configuración predeterminada de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo para configurar el cargador 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 con el que debe coincidir y otro para usar como URL sustitutiva, con referencias inversas que comienzan con "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL, y se mostrarán varias URL.
- Valor predeterminado de
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "auto" - Es el modo de subprocesos que se usará para la recuperación del repositorio. Si se configura en “off”, no se usa ningún subproceso de trabajo y la recuperación del repositorio está sujeta a reinicios. De lo contrario, utiliza un subproceso de plataforma (es decir, subproceso del SO) si se configura como “platform” o un subproceso virtual si se establece como “virtual”. Si se configura como "auto", se usan subprocesos virtuales si están disponibles (es decir, se ejecutan en JDK 21 y versiones posteriores); de lo contrario, no se usan subprocesos de trabajo.
- Opciones varias, que no están categorizadas:
- Se acumulan
--deleted_packages=<comma-separated list of package names>
usos múltiples - Una lista separada por comas de los nombres de los paquetes que el sistema de compilación considerará que no existen, incluso si están visibles en algún lugar de la ruta del paquete. Usa esta opción cuando borres un subpaquete 'x/y' de un paquete 'x' existente. Por ejemplo, después de borrar x/y/BUILD en el cliente, el sistema de compilación puede presentar un reclamo si encuentra la etiqueta '//x:y/z' si todavía la proporciona otra entrada package_path. Si especificas --deleted_packages x/y se evita este problema.
- El valor predeterminado de
--[no]fetch
es "true" (verdadero). - Permite que el comando recupere dependencias externas. Si se establece como falsa, el comando usará cualquier versión almacenada en caché de la dependencia. Si no existe ninguna, el comando fallará.
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
--package_path=<colon-separated list of options>
predeterminado: "%workspace%"- Una lista separada por dos puntos sobre dónde buscar paquetes. Los elementos que comienzan con "%workspace%" son relativos al lugar de trabajo que lo contiene. Si se omite o está vacío, el valor predeterminado es el resultado de “bazel info default-package-path”.
- El valor predeterminado de
--[no]show_loading_progress
es "true" (verdadero). - Si se habilita, hace que Bazel imprima mensajes "Cargando paquete:".
Opciones de limpieza
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Más lugares donde buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
valor predeterminado: "false"-
Si se configura, la caché del repositorio vinculará el archivo de forma fija en caso de un acierto de caché, en lugar de copiar. Esto sirve para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Usa este factor para escalar todos los tiempos de espera en las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que sean 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 para descargas de http.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--http_connector_retry_max_timeout=<An immutable length of time.>
: "0 s" -
Es el tiempo de espera máximo para los reintentos de descarga de HTTP. Con el valor 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 descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación en caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché; de lo contrario, se usa el valor predeterminado “<output_user_root>/cache/repos/v1”
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
valor predeterminado: "false"-
Si se establece esta configuración, no se permitirá la descarga con ="{.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no está completamente deshabilitado; ="{.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"-
Indica el porcentaje de espacio ocupado (0-100) por encima del cual GcThrashingDetector considera los eventos de presión de la memoria en función de sus límites (--gc_thrashing_limits). Si se configura en 100, GcThrashingDetector se inhabilita.
Etiquetas:host_machine_resource_optimizations
- Opciones que controlan el resultado del comando:
--[no]async
valor predeterminado: "false"- Si es verdadero, la limpieza de resultados es asíncrona. Cuando se complete este comando, será seguro ejecutar comandos nuevos en el mismo cliente, aunque la eliminación continúe en segundo plano.
Etiquetas:host_machine_resource_optimizations
--[no]expunge
valor predeterminado: "false"-
Si el valor es verdadero, clean quita todo el árbol de trabajo de esta instancia de Bazel, que incluye todos los archivos temporales y de salida 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 de forma asíncrona quita todo el árbol de trabajo para esta instancia de Bazel, que incluye todos los archivos temporales y de salida 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 continúe en segundo plano.
Se expande a:
--expunge
--async
Etiquetas:host_machine_resource_optimizations
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE.:
- El valor predeterminado de
--[no]incompatible_depset_for_java_output_source_jars
es "true" (verdadero). -
No-ops
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_new_actions_api
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,incompatible_change
- El valor predeterminado de
--[no]incompatible_visibility_private_attributes_at_definition
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,incompatible_change
- El valor predeterminado de
--[no]separate_aspect_deps
es "true" (verdadero). -
No-op
Etiquetas:no_op
- Opciones relacionadas con la semántica y el resultado de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Especificaste las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirá en el gráfico de dependencias resueltas incluso si se declararon de forma privada en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones anteriores harán que la resolución falle. También puedes definir la versión transferida 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
- El valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
es "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 una falla de resolución, “off” para inhabilitar la verificación o “warning” para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas `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 detecte una discrepancia o “error” para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
valor predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
valor predeterminado: "actualizar"-
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son “update” para usar el archivo de bloqueo y actualizarlo si hay cambios; “error” para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o “off” para no leerlo ni escribirlo en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y se recurrirá únicamente a los posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Configuración predeterminada de
--vendor_dir=<a path>
: ver descripción -
Especifica el directorio que debe contener los repositorios externos en modo de proveedor, ya sea con el fin de recuperarlos o usarlos durante la compilación. La ruta de acceso se puede especificar como una ruta de acceso absoluta o una ruta relativa al directorio del lugar de trabajo.
Etiquetas:loading_and_analysis
- 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 fallar Bazel con un OOM. Cada límite se especifica como <period>:<count>, donde el período es una duración y el recuento es un número entero positivo. Si más del --gc_thrashing_threshold por ciento del espacio titular (montón de generación anterior) permanece ocupado después de <count> GC completas consecutivas dentro de <period>, se activa una 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"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje de montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC completo, descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos de GC completos nunca activarán disminuciones. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de recolección de elementos no utilizados completo y se supere el umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje de montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC menor, descartará el estado temporal innecesario de Skyframe, hasta esta cantidad por invocación. El valor predeterminado es Integer.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos menores de GC nunca activarán disminuciones. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento menor de recolección de elementos no utilizados y se supere el umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje retenido de montón está al menos en este umbral, descartará el estado temporal innecesario de Skyframe. Un ajuste puede permitirte mitigar el impacto de la hiperpaginación de la GC en el tiempo, cuando esta (i) causa el uso de memoria de este estado temporal y (ii) es más costosa que reconstruir el estado cuando es necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Configuración predeterminada de
--experimental_command_profile=<cpu, wall, alloc or lock>
: ver descripción - Registra un perfil de grabadora de vuelo de Java mientras dure el comando. Se debe proporcionar uno de los tipos de eventos de generación de perfiles admitidos (cpu, muro, alloc o bloqueo) como argumento. El perfil se escribe en un archivo con el nombre del tipo de evento en el directorio base de salida. La sintaxis y semántica de esta marca podría cambiar en el futuro para admitir tipos de perfil o formatos de salida adicionales; úsala bajo tu responsabilidad.
--[no]experimental_record_metrics_for_all_mnemonics
valor predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán estadísticas para todos los mnemotécnicos.
- 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é remoto:
- Configuración predeterminada de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo para configurar el cargador 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 con el que debe coincidir y otro para usar como URL sustitutiva, con referencias inversas que comienzan con "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL, y se mostrarán varias URL.
- Valor predeterminado de
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "auto" - Es el modo de subprocesos que se usará para la recuperación del repositorio. Si se configura en “off”, no se usa ningún subproceso de trabajo y la recuperación del repositorio está sujeta a reinicios. De lo contrario, utiliza un subproceso de plataforma (es decir, subproceso del SO) si se configura como “platform” o un subproceso virtual si se establece como “virtual”. Si se configura como "auto", se usan subprocesos virtuales si están disponibles (es decir, se ejecutan en JDK 21 y versiones posteriores); de lo contrario, no se usan subprocesos de trabajo.
- Opciones varias, que no están categorizadas:
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
Opciones de configuración
Opciones de cobertura
Hereda todas las opciones de test.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Más lugares donde buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
valor predeterminado: "false"-
Si se configura, la caché del repositorio vinculará el archivo de forma fija en caso de un acierto de caché, en lugar de copiar. Esto sirve para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Usa este factor para escalar todos los tiempos de espera en las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que sean 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 para descargas de http.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--http_connector_retry_max_timeout=<An immutable length of time.>
: "0 s" -
Es el tiempo de espera máximo para los reintentos de descarga de HTTP. Con el valor 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 descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación en caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché; de lo contrario, se usa el valor predeterminado “<output_user_root>/cache/repos/v1”
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
valor predeterminado: "false"-
Si se establece esta configuración, no se permitirá la descarga con ="{.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no está completamente deshabilitado; ="{.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"-
Indica el porcentaje de espacio ocupado (0-100) por encima del cual GcThrashingDetector considera los eventos de presión de la memoria en función de sus límites (--gc_thrashing_limits). Si se configura en 100, GcThrashingDetector se inhabilita.
Etiquetas:host_machine_resource_optimizations
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE.:
- El valor predeterminado de
--[no]incompatible_depset_for_java_output_source_jars
es "true" (verdadero). -
No-ops
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_new_actions_api
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,incompatible_change
- El valor predeterminado de
--[no]incompatible_visibility_private_attributes_at_definition
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,incompatible_change
- El valor predeterminado de
--[no]separate_aspect_deps
es "true" (verdadero). -
No-op
Etiquetas:no_op
- Opciones relacionadas con la semántica y el resultado de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Especificaste las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirá en el gráfico de dependencias resueltas incluso si se declararon de forma privada en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones anteriores harán que la resolución falle. También puedes definir la versión transferida 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
- El valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
es "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 una falla de resolución, “off” para inhabilitar la verificación o “warning” para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas `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 detecte una discrepancia o “error” para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
valor predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
valor predeterminado: "actualizar"-
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son “update” para usar el archivo de bloqueo y actualizarlo si hay cambios; “error” para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o “off” para no leerlo ni escribirlo en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y se recurrirá únicamente a los posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Configuración predeterminada de
--vendor_dir=<a path>
: ver descripción -
Especifica el directorio que debe contener los repositorios externos en modo de proveedor, ya sea con el fin de recuperarlos o usarlos durante la compilación. La ruta de acceso se puede especificar como una ruta de acceso absoluta o una ruta relativa al directorio del lugar de trabajo.
Etiquetas:loading_and_analysis
- 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 fallar Bazel con un OOM. Cada límite se especifica como <period>:<count>, donde el período es una duración y el recuento es un número entero positivo. Si más del --gc_thrashing_threshold por ciento del espacio titular (montón de generación anterior) permanece ocupado después de <count> GC completas consecutivas dentro de <period>, se activa una 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"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje de montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC completo, descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos de GC completos nunca activarán disminuciones. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de recolección de elementos no utilizados completo y se supere el umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje de montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC menor, descartará el estado temporal innecesario de Skyframe, hasta esta cantidad por invocación. El valor predeterminado es Integer.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos menores de GC nunca activarán disminuciones. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento menor de recolección de elementos no utilizados y se supere el umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje retenido de montón está al menos en este umbral, descartará el estado temporal innecesario de Skyframe. Un ajuste puede permitirte mitigar el impacto de la hiperpaginación de la GC en el tiempo, cuando esta (i) causa el uso de memoria de este estado temporal y (ii) es más costosa que reconstruir el estado cuando es necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Configuración predeterminada de
--experimental_command_profile=<cpu, wall, alloc or lock>
: ver descripción - Registra un perfil de grabadora de vuelo de Java mientras dure el comando. Se debe proporcionar uno de los tipos de eventos de generación de perfiles admitidos (cpu, muro, alloc o bloqueo) como argumento. El perfil se escribe en un archivo con el nombre del tipo de evento en el directorio base de salida. La sintaxis y semántica de esta marca podría cambiar en el futuro para admitir tipos de perfil o formatos de salida adicionales; úsala bajo tu responsabilidad.
--[no]experimental_record_metrics_for_all_mnemonics
valor predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán estadísticas para todos los mnemotécnicos.
- 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é remoto:
- Configuración predeterminada de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo para configurar el cargador 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 con el que debe coincidir y otro para usar como URL sustitutiva, con referencias inversas que comienzan con "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL, y se mostrarán varias URL.
- Valor predeterminado de
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "auto" - Es el modo de subprocesos que se usará para la recuperación del repositorio. Si se configura en “off”, no se usa ningún subproceso de trabajo y la recuperación del repositorio está sujeta a reinicios. De lo contrario, utiliza un subproceso de plataforma (es decir, subproceso del SO) si se configura como “platform” o un subproceso virtual si se establece como “virtual”. Si se configura como "auto", se usan subprocesos virtuales si están disponibles (es decir, se ejecutan en JDK 21 y versiones posteriores); de lo contrario, no se usan subprocesos de trabajo.
- Opciones varias, que no están categorizadas:
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
Opciones de cquery
Hereda todas las opciones de test.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Más lugares donde buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
valor predeterminado: "false"-
Si se configura, la caché del repositorio vinculará el archivo de forma fija en caso de un acierto de caché, en lugar de copiar. Esto sirve para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Usa este factor para escalar todos los tiempos de espera en las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que sean 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 para descargas de http.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--http_connector_retry_max_timeout=<An immutable length of time.>
: "0 s" -
Es el tiempo de espera máximo para los reintentos de descarga de HTTP. Con el valor 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 descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación en caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché; de lo contrario, se usa el valor predeterminado “<output_user_root>/cache/repos/v1”
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
valor predeterminado: "false"-
Si se establece esta configuración, no se permitirá la descarga con ="{.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no está completamente deshabilitado; ="{.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"-
Indica el porcentaje de espacio ocupado (0-100) por encima del cual GcThrashingDetector considera los eventos de presión de la memoria en función de sus límites (--gc_thrashing_limits). Si se configura en 100, GcThrashingDetector se inhabilita.
Etiquetas:host_machine_resource_optimizations
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE.:
- El valor predeterminado de
--[no]incompatible_depset_for_java_output_source_jars
es "true" (verdadero). -
No-ops
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_new_actions_api
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,incompatible_change
- El valor predeterminado de
--[no]incompatible_visibility_private_attributes_at_definition
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,incompatible_change
- El valor predeterminado de
--[no]separate_aspect_deps
es "true" (verdadero). -
No-op
Etiquetas:no_op
- Opciones relacionadas con el resultado y la semántica de la consulta:
- El valor predeterminado de
--aspect_deps=<off, conservative or precise>
es "conservador". -
Cómo resolver dependencias de aspecto cuando el formato de salida es {xml,proto,record}. “desactivado” significa que no se resuelven las dependencias de aspecto, “conservadora” (el valor predeterminado) significa que se agregan todas las dependencias de aspecto declaradas sin importar si se les otorga la clase de regla de las dependencias directas. “preciso” significa que solo se agregan esos aspectos que posiblemente estén activos dada la clase de regla de las dependencias directas. Ten en cuenta que el modo preciso requiere cargar otros paquetes para evaluar un solo objetivo, por lo que es más lento que los otros modos. Además, ten en cuenta que incluso el modo preciso no es del todo preciso: la decisión de calcular un aspecto se decide en la fase de análisis, que no se ejecuta durante la “consulta de Bazel”.
Etiquetas:build_file_semantics
--[no]consistent_labels
valor predeterminado: "false"-
Si se habilita, cada comando de consulta emite etiquetas como si lo hiciera la función <code>str</code> de Starlark aplicada a una instancia de <code>etiqueta</code>. Esto es útil para las herramientas que necesitan hacer coincidir el resultado de diferentes comandos de consulta o etiquetas emitidas por reglas. Si no están habilitados, los formateadores de salida tienen la libertad de emitir nombres de repositorio aparentes (en relación con el repositorio principal) para que los resultados sean más legibles.
Etiquetas:terminal_output
--[no]experimental_explicit_aspects
valor predeterminado: "false"-
aquery, cquery: si se deben incluir acciones generadas por el aspecto en el resultado. query: no-op (siempre se siguen los aspectos).
Etiquetas:terminal_output
- El valor predeterminado de
--[no]graph:factored
es "true" (verdadero). -
Si es "true", el gráfico se emitirá "factorizado", es decir, los nodos equivalentes topológicamente se combinarán y sus etiquetas se concatenarán. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--graph:node_limit=<an integer>
predeterminado: "512"-
La longitud máxima de la string de etiqueta para un nodo del gráfico en el resultado. Las etiquetas más largas se truncarán; -1 significa que no hay truncamiento. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]implicit_deps
es "true" (verdadero). -
Si se habilita, las dependencias implícitas se incluirán en el gráfico de dependencias en el que opera la consulta. Una dependencia implícita es aquella que no se especifica de forma explícita en el archivo BUILD, sino que Bazel la agrega. En el caso de cquery, esta opción controla el filtrado de cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
- El valor predeterminado de
--[no]include_aspects
es "true" (verdadero). -
aquery, cquery: si se deben incluir acciones generadas por el aspecto en el resultado. query: no-op (siempre se siguen los aspectos).
Etiquetas:terminal_output
- El valor predeterminado de
--[no]incompatible_package_group_includes_double_slash
es "true" (verdadero). -
Si se habilita, cuando se genere el atributo `packages` de package_group, no se omitirá el signo `//` inicial.
Etiquetas:terminal_output
,incompatible_change
--[no]infer_universe_scope
valor predeterminado: "false"-
Si se configura y --universe_scope no se establece, se inferirá un valor de --universe_scope como la lista de patrones de objetivo únicos en la expresión de consulta. Ten en cuenta que el valor de --universe_scope que se infiere para una expresión de consulta que utiliza funciones con alcance universal (p.ej., `allrdeps`) puede no ser lo que quieres, por lo que solo debes usar esta opción si sabes lo que estás haciendo. Consulta https://bazel.build/reference/query#sky-query para obtener detalles y ejemplos. Si se configura --universe_scope, se ignora el valor de esta opción. Nota: Esta opción solo se aplica a “consulta” (es decir, no a “cquery”).
Etiquetas:loading_and_analysis
--[no]line_terminator_null
valor predeterminado: "false"-
Indica si cada formato termina con \0 en lugar de una línea nueva.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]nodep_deps
es "true" (verdadero). -
Si se habilita, las dependencias de los atributos “nodep” se incluirán en el gráfico de dependencias en el que opera la consulta. Un ejemplo común de un atributo “nodep” es la “visibilidad”. Ejecuta y analiza el resultado de `info build-language` para conocer todos los atributos “nodep” en el lenguaje de compilación.
Etiquetas:build_file_semantics
--output=<a string>
, valor predeterminado: “label”-
El formato en el que se deben imprimir los resultados de cquery. Los valores permitidos para cquery son los siguientes: label, label_kind, textproto, transiciones, proto, streaming_proto, jsonproto. Si seleccionas "transitions", también debes especificar la opción --transitions=(lite|full).
Etiquetas:terminal_output
- El valor predeterminado de
--[no]proto:default_values
es "true" (verdadero). -
Si el valor es "true", 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
valor predeterminado: "false"-
Propaga el campo proto define_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
- El valor predeterminado de
--[no]proto:flatten_selects
es "true" (verdadero). -
Si se habilita, se compactan los atributos configurables creados por select(). Para los tipos de lista, la representación plana es una lista que contiene cada valor del mapa de selección exactamente una vez. Los tipos escalares se acoplan a nulos.
Etiquetas:build_file_semantics
--[no]proto:include_attribute_source_aspects
valor predeterminado: "false"-
Propaga el campo proto source_aspect_name de cada Atributo con el aspecto de origen del que provino (si no lo hizo, una cadena vacía).
Etiquetas:terminal_output
- El valor predeterminado de
--[no]proto:include_configurations
es "true" (verdadero).
Si se habilita - , el resultado de proto incluirá información sobre los parámetros de configuración. Cuando se inhabilita,el formato de salida de cquery proto se asemeja al formato de resultados de la consulta.
Etiquetas:affects_outputs
--[no]proto:include_synthetic_attribute_hash
valor predeterminado: "false"-
Indica si se debe calcular y propagar el atributo $internal_attr_hash o no.
Etiquetas:terminal_output
--[no]proto:instantiation_stack
valor 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
- El valor predeterminado de
--[no]proto:locations
es "true" (verdadero). - Indica si se debe generar información de ubicación en el resultado de proto.
Etiquetas:terminal_output
- La configuración predeterminada de
--proto:output_rule_attrs=<comma-separated list of options>
es "todos" -
Lista de atributos separados por comas para incluir en el resultado. La configuración predeterminada es todos los atributos. Se establece como una cadena vacía para no generar ningún atributo. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]proto:rule_inputs_and_outputs
es "true" (verdadero). -
Indica si se deben propagar los campos rule_input y rule_output o no.
Etiquetas:terminal_output
--query_file=<a string>
predeterminado: ""-
Si se configura, la consulta leerá la consulta desde el archivo que se menciona aquí, en lugar de hacerlo desde la línea de comandos. Es un error especificar un archivo aquí, así como una consulta de línea de comandos.
Etiquetas:changes_inputs
--[no]relative_locations
valor predeterminado: "false"-
Si es "true", la ubicación de los archivos BUILD en los resultados xml y proto será relativa. De forma predeterminada, el resultado de la ubicación es una ruta de acceso absoluta y no será coherente en todas las máquinas. Puedes configurar esta opción como verdadera para obtener un resultado coherente en todas las máquinas.
Etiquetas:terminal_output
- El valor predeterminado de
--show_config_fragments=<off, direct or transitive>
es "desactivado" -
Muestra los fragmentos de configuración que requiere una regla y sus dependencias transitivas. Esto puede ser útil para evaluar cuánto se puede recortar un gráfico de destino configurado.
Etiquetas:affects_outputs
--starlark:expr=<a string>
predeterminado: ""-
Una expresión de Starlark para dar formato a cada destino configurado en el modo --output=starlark de cquery. El destino configurado está vinculado al “objetivo”. Si no se especifica --starlark:expr ni --starlark:file, esta opción se establecerá de forma predeterminada como “str(target.label)”. Es un error especificar --starlark:expr y --starlark:file.
Etiquetas:terminal_output
--starlark:file=<a string>
predeterminado: ""-
Es el nombre de un archivo que define una función de Starlark llamada "formato" de un argumento que se aplica a cada destino configurado para darle formato como una cadena. Es un error especificar --starlark:expr y --starlark:file. Consulta la ayuda de --output=starlark para obtener más detalles.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]tool_deps
es "true" (verdadero). -
Consulta: Si se inhabilita, las dependencias de la "configuración de ejecución" no se incluirán en el gráfico de dependencias en el que opera la consulta. Un perímetro de dependencia de 'ejecución de configuración', como el de cualquier regla 'proto_library' al compilador de protocolos, generalmente apunta a una herramienta ejecutada durante la compilación en lugar de a una parte del mismo programa 'target'.
Cquery: Si se inhabilita, filtra todos los destinos configurados que cruzan una transición de ejecución del objetivo de nivel superior que descubrió este objetivo configurado. Esto significa que si el objetivo de nivel superior está en la configuración de destino, solo se mostrarán los objetivos configurados también en esa configuración. Si el objetivo de nivel superior está en la configuración de ejecución, solo se mostrarán los objetivos configurados de ejecución. Esta opción NO excluirá las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
- La configuración predeterminada de
--transitions=<full, lite or none>
es “ninguna” -
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: ""-
Un conjunto de patrones de objetivo separados por comas (aditivos y sustractivos). 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.
Para cquery, la entrada a esta opción son los destinos en los que se compilan todas las respuestas, por lo que esta opción puede afectar las configuraciones y las transiciones. Si no se especifica esta opción, se supone que los destinos de nivel superior son los destinos analizados a partir de la expresión de consulta. Nota: En el caso de cquery, no especificar esta opción puede provocar que la compilación falle si los objetivos analizados a partir de la expresión de consulta no se pueden compilar con opciones de nivel superior.
Etiquetas:loading_and_analysis
- Opciones relacionadas con la semántica y el resultado de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Especificaste las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirá en el gráfico de dependencias resueltas incluso si se declararon de forma privada en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones anteriores harán que la resolución falle. También puedes definir la versión transferida 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
- El valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
es "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 una falla de resolución, “off” para inhabilitar la verificación o “warning” para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas `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 detecte una discrepancia o “error” para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
valor predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
valor predeterminado: "actualizar"-
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son “update” para usar el archivo de bloqueo y actualizarlo si hay cambios; “error” para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o “off” para no leerlo ni escribirlo en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y se recurrirá únicamente a los posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Configuración predeterminada de
--vendor_dir=<a path>
: ver descripción -
Especifica el directorio que debe contener los repositorios externos en modo de proveedor, ya sea con el fin de recuperarlos o usarlos durante la compilación. La ruta de acceso se puede especificar como una ruta de acceso absoluta o una ruta relativa al directorio del lugar de trabajo.
Etiquetas:loading_and_analysis
- 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 fallar Bazel con un OOM. Cada límite se especifica como <period>:<count>, donde el período es una duración y el recuento es un número entero positivo. Si más del --gc_thrashing_threshold por ciento del espacio titular (montón de generación anterior) permanece ocupado después de <count> GC completas consecutivas dentro de <period>, se activa una 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"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje de montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC completo, descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos de GC completos nunca activarán disminuciones. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de recolección de elementos no utilizados completo y se supere el umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje de montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC menor, descartará el estado temporal innecesario de Skyframe, hasta esta cantidad por invocación. El valor predeterminado es Integer.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos menores de GC nunca activarán disminuciones. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento menor de recolección de elementos no utilizados y se supere el umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje retenido de montón está al menos en este umbral, descartará el estado temporal innecesario de Skyframe. Un ajuste puede permitirte mitigar el impacto de la hiperpaginación de la GC en el tiempo, cuando esta (i) causa el uso de memoria de este estado temporal y (ii) es más costosa que reconstruir el estado cuando es necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Configuración predeterminada de
--experimental_command_profile=<cpu, wall, alloc or lock>
: ver descripción - Registra un perfil de grabadora de vuelo de Java mientras dure el comando. Se debe proporcionar uno de los tipos de eventos de generación de perfiles admitidos (cpu, muro, alloc o bloqueo) como argumento. El perfil se escribe en un archivo con el nombre del tipo de evento en el directorio base de salida. La sintaxis y semántica de esta marca podría cambiar en el futuro para admitir tipos de perfil o formatos de salida adicionales; úsala bajo tu responsabilidad.
--[no]experimental_record_metrics_for_all_mnemonics
valor predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán estadísticas para todos los mnemotécnicos.
- 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é remoto:
- Configuración predeterminada de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo para configurar el cargador 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 con el que debe coincidir y otro para usar como URL sustitutiva, con referencias inversas que comienzan con "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL, y se mostrarán varias URL.
- Valor predeterminado de
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "auto" - Es el modo de subprocesos que se usará para la recuperación del repositorio. Si se configura en “off”, no se usa ningún subproceso de trabajo y la recuperación del repositorio está sujeta a reinicios. De lo contrario, utiliza un subproceso de plataforma (es decir, subproceso del SO) si se configura como “platform” o un subproceso virtual si se establece como “virtual”. Si se configura como "auto", se usan subprocesos virtuales si están disponibles (es decir, se ejecutan en JDK 21 y versiones posteriores); de lo contrario, no se usan subprocesos de trabajo.
- Opciones varias, que no están categorizadas:
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa 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"
- Opciones que controlan la ejecución de la compilación:
--[no]experimental_inprocess_symlink_creation
valor predeterminado: "false"-
Indica 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
valor predeterminado: "false"-
Habilita el extractor de aar persistente con trabajadores.
Etiquetas:execution
--[no]experimental_remotable_source_manifests
valor predeterminado: "false"-
Indica si se pueden hacer que las acciones del manifiesto de origen sean remotas
Etiquetas:loading_and_analysis
,execution
,experimental
--[no]experimental_split_coverage_postprocessing
valor predeterminado: "false"-
Si es verdadero, Bazel ejecutará el procesamiento posterior de la cobertura para probarlo en un nuevo generador.
Etiquetas:execution
--[no]experimental_strict_fileset_output
valor predeterminado: "false"-
Si habilitas esta opción, los conjuntos de archivos tratarán todos los artefactos de salida como archivos normales. No desviarán directorios ni serán sensibles a los symlinks.
Etiquetas:execution
--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 el valor mnemotécnico de la acción. Solo se aplica a las acciones que admiten información de ejecución. Muchas acciones comunes admiten información de ejecución, p.ej., Genrule, CppCompile, Javac, StarlarkAction y TestRunner. Cuando se especifican varios valores, el orden es importante porque muchas regex pueden aplicarse al mismo valor mnemotécnico.
Sintaxis: "regex=[+-]key,regex=[+-]key,...".
Ejemplos:
“.*=+x,.*=-y,.*=+z” agrega “x” y “z” a la información de ejecución de todas las acciones y quita “y”.
“Genrule=+requires-x” agrega “require-x” a la información de ejecución para todas las acciones de Genrule.
“(?!Genrule).*=-requires-x” quita “require-x” de la información de ejecución para todas las acciones que no son de Genrule.
Etiquetas:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Habilita las acciones persistentes de dex y desugar de Android con trabajadores.
Se expande a:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
-
Habilita el procesador de recursos persistentes de Android usando 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
}}{/13/}
--strategy=Aapt2Optimize=worker
--strategy=Aapt2Optimize=worker
--strategy=Aapt2Optimize=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
--strategy=ProcessDatabinding=worker
--strategy=GenerateDataBindingBaseClasses=worker
host_machine_resource_optimizations
execution
--persistent_multiplex_android_dex_desugar
-
Habilita las acciones de dex y desugar multiplexadas 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 multiplexados persistentes de Android usando 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=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
host_machine_resource_optimizations
execution
--persistent_multiplex_android_tools
-
Habilita herramientas persistentes y multiplexadas de Android (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
valor predeterminado: "false"-
Si es "true", Bazel usará la plataforma de destino para ejecutar pruebas en lugar del grupo de ejecuciones de prueba.
Etiquetas:execution
- Opciones que configuran la cadena de herramientas usada para ejecutar la acción:
- Configuración predeterminada de
--android_compiler=<a string>
: ver 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
yloses_incremental_state
- Configuración predeterminada de
--android_grte_top=<a label>
: ver descripción -
El objetivo de Android es grte_top.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
predeterminado: "android"-
Selecciona la combinación de manifiestos que se usará para las reglas android_binary. Marca para ayudar en 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 objetivos de android_binary. Si se especifican varias plataformas, el objeto binario es un APK multiarquitectura, que incluye 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 utiliza 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"-
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
- Configuración predeterminada de
--compiler=<a string>
: ver descripción -
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 objeto binario que se usa para procesar posteriormente los informes de cobertura sin procesar. Actualmente, debe ser un grupo de archivos que contenga un solo archivo, el binario. La configuración predeterminada 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 objeto binario que se usa para generar informes de cobertura. Actualmente, debe ser un grupo de archivos que contenga un solo archivo, el binario. La configuración predeterminada 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. La configuración predeterminada es "//tools/test:coverage_support".
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
- Configuración predeterminada de
--custom_malloc=<a build target label>
: ver descripción -
Especifica una implementación de malloc personalizada. Este parámetro de configuración anula los atributos malloc en las reglas de compilación.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
usos múltiples -
Lista de expresiones regulares separadas por comas, cada una con el prefijo - (expresión negativa), asignada (=) a una lista de valores de restricción separados por comas. Si un objetivo no coincide con ninguna expresión negativa y al menos una expresión positiva, la resolución de la cadena de herramientas se ejecutará 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 aquellos cuyo nombre contenga 'prueba'.
Etiquetas:loading_and_analysis
--[no]experimental_include_xcode_execution_requirements
valor predeterminado: "false"-
Si se configura, agrega un requisito de ejecución “requires-xcode:{version}” a cada acción de Xcode. Si la versión de Xcode tiene una etiqueta con guion, también agrega un requisito de ejecución “requires-xcode-label:{version_label}”.
Etiquetas:loses_incremental_state
,loading_and_analysis
,execution
- El valor predeterminado de
--[no]experimental_prefer_mutual_xcode
es "true" (verdadero). -
Si es verdadero, usa el Xcode más reciente que esté disponible de forma local y remota. Si es falso, o si no existen 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 objetivo exacto o como patrón de objetivo. Estas plataformas se considerarán antes que las declaradas en el archivo WORKSPACE por register_execution_platforms(). Esta opción solo se puede configurar una vez; las instancias posteriores anularán la configuración de marcas anterior.
Etiquetas:execution
- Se acumulan
--extra_toolchains=<comma-separated list of options>
usos múltiples -
Son las reglas de la cadena de herramientas que se tendrán en cuenta durante su resolución. Las cadenas de herramientas se pueden especificar por objetivo exacto o como patrón de objetivo. Estas cadenas de herramientas se considerarán antes de las declaradas en el archivo WORKSPACE por register_toolchains().
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
- Configuración predeterminada de
--grte_top=<a label>
: ver descripción -
Es una etiqueta de una biblioteca libc registrada. La cadena de herramientas de herramientas cruzadas selecciona el valor predeterminado, y casi nunca necesitas anularlo.
Etiquetas:action_command_lines
,affects_outputs
- Configuración predeterminada de
--host_compiler=<a string>
: ver descripción -
Marca no-op. Se quitará en una versión futura.
Etiquetas:loading_and_analysis
,execution
- Configuración predeterminada de
--host_grte_top=<a label>
: ver descripción -
Si se especifica, esta configuración anula el directorio de nivel superior de libc (--grte_top) para la configuración de ejecución.
Etiquetas:action_command_lines
,affects_outputs
--host_platform=<a build target label>
valor predeterminado: "@local_config_platform//:host"-
Es la etiqueta de una regla de la plataforma que describe el sistema host.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
- El valor predeterminado de
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
es "true" (verdadero). -
Si es "true", 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
- El valor predeterminado de
--[no]incompatible_enable_android_toolchain_resolution
es "true" (verdadero). -
Usa la resolución de la cadena de herramientas para seleccionar el SDK de Android para reglas de Android (Starlark y nativo)
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_apple_toolchain_resolution
valor predeterminado: "false"-
Usa la resolución de la cadena de herramientas para seleccionar el SDK de Apple para las reglas de Apple (Starlark y nativo)
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_make_thinlto_command_lines_standalone
es "true" (verdadero). -
Esta marca es una noop y se programó su eliminación.
Etiquetas:no_op
,incompatible_change
- El valor predeterminado de
--[no]incompatible_remove_legacy_whole_archive
es "true" (verdadero). -
Si es verdadero, Bazel no vinculará las dependencias de la biblioteca como todo el archivo de forma predeterminada (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener instrucciones de migración).
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_require_ctx_in_configure_features
es "true" (verdadero). -
Esta marca es una noop y se programó su eliminación.
Etiquetas:no_op
,incompatible_change
--[no]incompatible_strip_executable_safely
valor predeterminado: "false"-
Si es verdadero, la acción de quitar para los ejecutables usará la marca -x, lo que no interrumpe la resolución de símbolos dinámicos.
Etiquetas:action_command_lines
,incompatible_change
- Usa objetos compartidos de interfaz si la cadena de herramientas lo admite. Todas las cadenas de herramientas de ELF admiten actualmente este parámetro de configuración.
Etiquetas:loading_and_analysis
,affects_outputs
,affects_outputs
- Configuración predeterminada de
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Especifica la versión del SDK de iOS que se usará para compilar aplicaciones para iOS. Si no se especifica, usa la versión predeterminada del SDK para iOS de “xcode_version”.
Etiquetas:loses_incremental_state
- Configuración predeterminada de
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Especifica la versión del SDK de macOS que se usará para compilar aplicaciones de macOS. Si no se especifica, se usa la versión predeterminada del SDK de macOS de “xcode_version”.
Etiquetas:loses_incremental_state
- Configuración predeterminada de
--minimum_os_version=<a string>
: ver descripción -
La versión mínima del SO a la que se orienta tu compilación.
Etiquetas:loading_and_analysis
,affects_outputs
--platform_mappings=<a relative path>
predeterminado: ""-
Es la ubicación de un archivo de asignación en la que se describe qué plataforma usar si no hay ninguna establecida o qué marcas se deben configurar cuando ya existe una plataforma. Debe estar relacionado con la raíz del lugar de trabajo principal. La configuración predeterminada es "platform_mappings", que es un archivo directamente en la raíz del lugar de trabajo.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
yimmutable
--platforms=<a build target label>
predeterminado: ""-
Las etiquetas de las reglas de la plataforma que describen las plataformas de destino para el comando actual.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
- Configuración predeterminada de
--python2_path=<a string>
: ver descripción -
Obsoleto, no-op. Inhabilitado por `--incompatible_use_python_toolchains`.
Etiquetas:no_op
,deprecated
- Configuración predeterminada de
--python3_path=<a string>
: ver descripción -
Obsoleto, no-op. Inhabilitado por `--incompatible_use_python_toolchains`.
Etiquetas:no_op
,deprecated
- Configuración predeterminada de
--python_path=<a string>
: ver descripción -
Es la ruta de acceso absoluta del intérprete de Python que se invoca para ejecutar los objetivos de Python en la plataforma de destino. Obsoleto; inhabilitado por --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
- Configuración predeterminada de
--python_top=<a build target label>
: ver descripción -
La etiqueta de un py_runtime que representa el intérprete de Python invocado para ejecutar objetivos de Python en la plataforma de destino. Obsoleto; inhabilitado por --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
- Configuración predeterminada de
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Especifica la versión del SDK de tvOS que se usará para compilar aplicaciones de tvOS. Si no se especifica, se usa la versión predeterminada del SDK de tvOS de “xcode_version”.
Etiquetas:loses_incremental_state
- Configuración predeterminada de
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Especifica la versión del SDK de watchOS que se usará para compilar aplicaciones de watchOS. Si no se especifica, se usa la versión predeterminada del SDK de watchOS de “xcode_version”.
Etiquetas:loses_incremental_state
- Configuración predeterminada de
--xcode_version=<a string>
: ver descripción -
Si se especifica, usa Xcode de la versión determinada para las acciones de compilación relevantes. Si no se especifica, usa la versión predeterminada del ejecutor de Xcode.
Etiquetas:loses_incremental_state
--xcode_version_config=<a build target label>
predeterminado: "@bazel_tools//tools/cpp:host_xcodes"-
La etiqueta de la regla xcode_config que se usará para seleccionar la versión de Xcode en la configuración de compilación.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Opciones que controlan el resultado del comando:
--[no]apple_generate_dsym
valor predeterminado: "false"-
Indica si se deben generar archivos de símbolos de depuración (.dSYM).
Etiquetas:affects_outputs
,action_command_lines
- El valor predeterminado de
--[no]build_runfile_links
es "true" (verdadero). -
Si esta opción es verdadera, compila bosques de symlinks de archivos de ejecución para todos los destinos. Si es falso, escríbelos solo cuando lo requiera una acción local, un comando de prueba o ejecución.
Etiquetas:affects_outputs
- El valor predeterminado de
--[no]build_runfile_manifests
es "true" (verdadero). -
Si esta opción es verdadera, se escriben manifiestos de archivos de ejecución para todos los destinos. Si es falso, omítelos. Las pruebas locales no se ejecutarán si el valor es falso.
Etiquetas:affects_outputs
--[no]build_test_dwp
valor predeterminado: "false"-
Si se habilita, cuando se compilen pruebas de C++ de forma estática y con fisión, 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"-
Establece los sufijos de los archivos fuente que crea una cc_proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info
valor 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
valor 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
valor predeterminado: "false"-
Guarda el estado de las funciones habilitadas y solicitadas como resultado de la compilación.
Etiquetas:affects_outputs
,experimental
- El valor predeterminado de
--fission=<a set of compilation modes>
es "no" -
Especifica qué modos de compilación usan fisión para compilaciones y 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
- El valor predeterminado de
--[no]incompatible_always_include_files_in_data
es "true" (verdadero). -
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
- El valor predeterminado de
--[no]legacy_external_runfiles
es "true" (verdadero). -
Si esta opción es verdadera, compila bosques de symlink de archivos de ejecución para repositorios externos en .runfiles/wsname/external/repo (además de .runfiles/repo).
Etiquetas:affects_outputs
--[no]objc_generate_linkmap
valor predeterminado: "false"-
Especifica si se debe generar un archivo de mapa de vínculos.
Etiquetas:affects_outputs
--[no]save_temps
valor predeterminado: "false"-
Si se establece, se guardarán los resultados temporales de GCC. Estos incluyen archivos .s (código ensamblador), archivos .i (C preprocesado) y archivos .ii (C++ previamente procesados).
Etiquetas:affects_outputs
- Opciones que permiten al usuario configurar el resultado deseado y afectar su valor, en lugar de su existencia:
- Se acumulan
--action_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica el conjunto de variables de entorno disponibles para 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 mediante el par nombre=valor que establece el valor independientemente del entorno de invocación. Esta opción se puede usar varias veces; para opciones proporcionadas para la misma variable, se acumulan los últimos éxitos, las opciones para diferentes variables se acumulan.
Etiquetas:action_command_lines
--android_cpu=<a string>
predeterminado: "armeabi-v7a"-
Es la CPU de destino de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- El valor predeterminado de
--[no]android_databinding_use_androidx
es "true" (verdadero). -
Genera archivos de vinculación de datos compatibles con AndroidX. Esto solo se usa con Databinding v2. Esta marca es una no-op.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- El valor predeterminado de
--[no]android_databinding_use_v3_4_args
es "true" (verdadero). -
Usa Android Databinding v2 con un argumento 3.4.0. Esta marca es una no-op.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- El valor predeterminado de
--android_dynamic_mode=<off, default or fully>
es "desactivado" -
Determina si las dependencias de C++ de las reglas de Android se vincularán de forma dinámica cuando un objeto cc_binary no cree explícitamente una biblioteca compartida. “default” significa que Bazel decide si se vincula de forma dinámica. "completamente" significa que todas las bibliotecas se vincularán de forma dinámica. “off” significa que todas las bibliotecas se vincularán en su mayor parte en modo estático.
Etiquetas:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
valor predeterminado: "alphabetical"-
Establece el orden de los manifiestos que se pasan a la combinación de manifiestos para objetos binarios de Android. ALFABÉTICO significa que los manifiestos se ordenan por ruta de acceso relativa a la execroot. ALPHABETICAL_BY_CONFIGURATION significa que los manifiestos se ordenan por rutas de acceso relacionadas con el directorio de configuración dentro del directorio de salida. DEPENDENCY significa que los manifiestos se ordenan con los manifiestos de cada biblioteca antes que los de sus dependencias.
Etiquetas:action_command_lines
,execution
--[no]android_resource_shrinking
valor predeterminado: "false"-
Habilita la reducción de recursos para los APKs de android_binary que usan ProGuard.
Etiquetas:affects_outputs
,loading_and_analysis
- Valor predeterminado de
--[no]build_python_zip
: "auto" -
Compila el archivo ZIP del comando de Python; en Windows, desactivado en otras plataformas
Etiquetas:affects_outputs
- Se acumulan
--catalyst_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se compilan los objetos binarios de Apple Catalyst.
Etiquetas:loses_incremental_state
,loading_and_analysis
--[no]collect_code_coverage
valor predeterminado: "false"-
Si se especifica, Bazel instrumentará código (con instrumentación sin conexión cuando sea posible) y recopilará información de cobertura durante las pruebas. Solo se verán afectados los objetivos que coincidan con --instrumentation_filter. Por lo general, esta opción no debe especificarse directamente; en su lugar, debes usar el comando "bazel esquema".
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
--conlyopt=<a string>
usos múltiples -
Es una opción adicional para pasar a gcc cuando se compilan archivos de origen C.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--copt=<a string>
usos múltiples -
Opciones adicionales para pasar a gcc.
Etiquetas:action_command_lines
,affects_outputs
--cpu=<a string>
predeterminado: ""-
La CPU de destino.
Etiquetas:changes_inputs
,affects_outputs
- Configuración predeterminada de
--cs_fdo_absolute_path=<a string>
: ver descripción - Usa la información del perfil de CSFDO para optimizar la compilación. Especifica el nombre de ruta de acceso absoluto del archivo ZIP que contiene el archivo de perfil, un archivo de perfil de LLVM sin procesar o indexado.
Etiquetas:affects_outputs
- Configuración predeterminada de
--cs_fdo_instrument=<a string>
: ver descripción - Genera objetos binarios con instrumentación de FDO sensible al contexto. Con el compilador Clang/LLVM, también acepta el nombre de directorio bajo el cual se volcarán los archivos de perfil sin procesar durante el tiempo de ejecución.
Etiquetas:affects_outputs
- Configuración predeterminada de
--cs_fdo_profile=<a build target label>
: ver descripción -
El cs_fdo_profile, que representa el perfil sensible al contexto que se usará para la optimización.
Etiquetas:affects_outputs
- Se acumulan
--cxxopt=<a string>
usos múltiples -
Es una opción adicional para pasar a gcc cuando se compilan archivos de origen C++.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--define=<a 'name=value' assignment>
usos múltiples -
Cada opción --define especifica una asignación para una variable de compilación. Si hay varios valores para una variable, ganará el último.
Etiquetas:changes_inputs
,affects_outputs
--dynamic_mode=<off, default or fully>
valor predeterminado: "default"-
Determina si los objetos binarios de C++ se vincularán de forma dinámica. “predeterminada” significa que Bazel elegirá si se vinculará de forma dinámica. "completamente" significa que todas las bibliotecas se vincularán de forma dinámica. “off” significa que todas las bibliotecas se vincularán en su mayor parte en modo estático.
Etiquetas:loading_and_analysis
,affects_outputs
- El valor predeterminado de
--[no]enable_fdo_profile_absolute_path
es "true" (verdadero). -
Si se configura, el uso de fdo_absolute_profile_path generará un error.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]enable_runfiles
: "auto" -
Habilita el árbol del symlink de los archivos de ejecución. De forma predeterminada, está desactivado en Windows y en otras plataformas.
Etiquetas:affects_outputs
- Se acumulan
--experimental_action_listener=<a build target label>
usos múltiples -
Se dio de baja a favor de los 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
valor predeterminado: "false"-
Comprime los recursos de Java en APK
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
- El valor predeterminado de
--[no]experimental_android_databinding_v2
es "true" (verdadero). - Usa Android Databinding v2. Esta marca es una no-op.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_android_resource_shrinking
valor 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
valor predeterminado: "false"-
usar la herramienta Rex para reescribir archivos dex
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_collect_code_coverage_for_generated_files
valor predeterminado: "false"-
Si se especifica, Bazel también generará información de cobertura para los archivos generados.
Etiquetas:affects_outputs
--experimental_objc_fastbuild_options=<comma-separated list of options>
predeterminado: "-O0,-DDEBUG=1"-
Usa estas cadenas como opciones del compilador objc fastbuild.
Etiquetas:action_command_lines
--[no]experimental_omitfp
valor predeterminado: "false"-
Si esta opción es "true", usa libunwind para desenrollar la pila y compila con -fomit-frame-pointer y -fasym-unwind-tables.
Etiquetas:action_command_lines
,affects_outputs
,experimental
- El valor predeterminado de
--experimental_output_paths=<off, content or strip>
es "desactivado" -
Indica qué modelo usar en qué parte de las reglas del árbol de resultados escriben sus resultados, en particular para compilaciones multiplataforma o de varias configuraciones. Esto es altamente experimental. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/6526. Las acciones de Starlark pueden habilitar la asignación de ruta agregando la clave “supports-path-mapping” al diccionario “execution_requirements”.
Etiquetas:loses_incremental_state
,bazel_internal_configuration
,affects_outputs
yexecution
- Se acumulan
--experimental_override_name_platform_in_output_dir=<a 'label=value' assignment>
usos múltiples -
Cada entrada debe tener el formato label=value, en el que la etiqueta hace referencia a una plataforma y los valores son el nombre corto deseado para usar en la ruta de acceso del resultado. Solo se usa cuando --experimental_platform_in_output_dir es verdadero. Tiene la prioridad de nombre más alta.
Etiquetas:affects_outputs
,experimental
--[no]experimental_platform_in_output_dir
valor 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: en primer lugar, en el caso poco frecuente de que la opción --platforms no tenga exactamente un valor, se utilizará un hash de la opción de plataformas. Luego, si --experimental_override_name_platform_in_output_dir registró algún nombre corto para la plataforma actual, entonces se utiliza ese nombre corto. Luego, si se configura --experimental_use_platforms_in_output_dir_legacy_heuristic, se debe utilizar un nombre corto basado en la etiqueta actual de la plataforma. Por último, se usa un hash de la opción de plataforma como último recurso.
Etiquetas:affects_outputs
,experimental
--[no]experimental_use_llvm_covmap
valor predeterminado: "false"-
Si se especifica, Bazel generará información del mapa de cobertura llvm-cov en lugar de gcov cuando collect_code_coverage esté habilitado.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
yexperimental
- El valor predeterminado de
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic
es "true" (verdadero). -
Usa esta marca solo como parte de una estrategia sugerida de migración o prueba. 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"-
Mediante la configuración de esta opción, se habilitan los APK multiarquitecturas, 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, --android_cpu se ignora para dependencias de reglas android_binary.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]fat_apk_hwasan
valor predeterminado: "false"-
Marca no-op. Se quitará en una versión futura.
Etiquetas:no_op
- Configuración predeterminada de
--fdo_instrument=<a string>
: ver descripción - Genera objetos binarios con instrumentación de FDO. Con el compilador Clang/LLVM, también acepta el nombre de directorio bajo el cual se volcarán los archivos de perfil sin procesar durante el tiempo de ejecución.
Etiquetas:affects_outputs
- Configuración predeterminada de
--fdo_optimize=<a string>
: ver 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 apunten a objetivos de `fdo_profile`. Esta marca será reemplazada por la regla “fdo_profile”.
Etiquetas:affects_outputs
- Configuración predeterminada de
--fdo_prefetch_hints=<a build target label>
: ver descripción -
Usa sugerencias de carga previa de caché.
Etiquetas:affects_outputs
- Configuración predeterminada de
--fdo_profile=<a build target label>
: ver descripción -
El fdo_profile, que representa el perfil que se utilizará para la optimización.
Etiquetas:affects_outputs
- Se acumulan
--features=<a string>
usos múltiples -
Estas funciones estarán habilitadas o inhabilitadas de forma predeterminada para los destinos integrados en la configuración de destino. Si especificas -<feature>, se inhabilitará la función. Los atributos negativos siempre anulan a los positivos. Consulta también --host_features
Etiquetas:changes_inputs
,affects_outputs
--[no]force_pic
valor predeterminado: "false"-
Si se habilita, todas las compilaciones de C++ producen código independiente de la posición ("-fPIC"), los vínculos prefieren bibliotecas PIC compiladas previamente en lugar de bibliotecas que no son PIC, y los vínculos producen ejecutables independientes de la posición ("-pie").
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan
--host_action_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica el conjunto de variables de entorno disponibles para acciones con configuraciones de ejecución. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o mediante el par nombre=valor que establece el valor independientemente del entorno de invocación. Esta opción se puede usar varias veces; para opciones proporcionadas para la misma variable, se acumulan los últimos éxitos, las opciones para diferentes variables se acumulan.
Etiquetas:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
valor predeterminado: "opt"- Especifica el modo en el que se integrarán las herramientas usadas durante la compilación. Valores: "fastbuild", "dbg", "opt".
Etiquetas:affects_outputs
,action_command_lines
- Se acumulan
--host_conlyopt=<a string>
usos múltiples -
Es una opción adicional para pasar al compilador C cuando se compilan archivos de origen C (pero no C++) en las configuraciones de ejecución.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--host_copt=<a string>
usos múltiples -
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: ""-
Es la CPU del host.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan
--host_cxxopt=<a string>
usos múltiples -
Opciones adicionales para pasar al compilador de C++ para herramientas compiladas en configuraciones de ejecución.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--host_features=<a string>
usos múltiples -
Las funciones determinadas estarán habilitadas o inhabilitadas de forma predeterminada para los destinos integrados en la configuración de ejecución. Si especificas -<feature>, se inhabilitará la función. Los atributos negativos siempre anulan a los positivos.
Etiquetas:changes_inputs
,affects_outputs
- Configuración predeterminada de
--host_force_python=<PY2 or PY3>
: ver descripción -
Anula la versión de Python para la configuración de ejecución. Puede ser “PY2” o “PY3”.
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan
--host_linkopt=<a string>
usos múltiples -
Es una opción adicional para pasar al vinculador cuando se vinculan herramientas en la configuración de ejecución.
Etiquetas:action_command_lines
,affects_outputs
- Configuración predeterminada de
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima de macOS compatible para los destinos de host. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
usos múltiples -
Son 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 aprobar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter significa una lista de patrones de expresiones regulares de inclusión y exclusión (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 ir entre comillas con una barra inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos gcc de todos los archivos cc en //foo/, excepto bar.cc.
Etiquetas:action_command_lines
,affects_outputs
--[no]incompatible_auto_exec_groups
valor predeterminado: "false"-
Cuando se habilita, se crea automáticamente un grupo de ejecutables 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
- El valor predeterminado de
--[no]incompatible_merge_genfiles_directory
es "true" (verdadero). -
Si es verdadero, el directorio genfiles se pliega en el directorio bin.
Etiquetas:affects_outputs
,incompatible_change
--[no]instrument_test_targets
valor predeterminado: "false"-
Cuando la cobertura está habilitada, especifica si se debe considerar la instrumentación de reglas de prueba. Cuando se establece, se instrumentan las reglas de prueba incluidas por --instrumentation_filter. De lo contrario, las reglas de prueba siempre se excluyen de la instrumentación de cobertura.
Etiquetas:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
valor predeterminado: "-/javatests[/:],-/test/java[/:]"-
Cuando la cobertura esté habilitada, solo se instrumentarán las reglas con nombres incluidos en el filtro basado en regex especificado. En su lugar, se excluyen las reglas con el prefijo “-”. Ten en cuenta que solo se instrumentan las reglas que no son de prueba, a menos que esté habilitado --instrument_test_targets.
Etiquetas:affects_outputs
- Configuración predeterminada de
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima de iOS compatible con los simuladores y dispositivos de destino. Si no se especifica, usa “ios_sdk_version”.
Etiquetas:loses_incremental_state
- Se acumulan
--ios_multi_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para compilar una ios_application. El resultado es un objeto binario universal que contiene todas las arquitecturas especificadas.
Etiquetas:loses_incremental_state
,loading_and_analysis
- El valor predeterminado de
--[no]legacy_whole_archive
es "true" (verdadero). -
Obsoleto y sustituido por --incompatible_remove_legacy_whole_archive (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener más información). Cuando esta opción está activada, se usa --whole-archive para reglas cc_binary que tengan linkshared=True y linkstatic=True o '-static' en linkopts. Esto es solo para retrocompatibilidad. Una mejor alternativa es usar Alwayslink=1 cuando sea necesario.
Etiquetas:action_command_lines
,affects_outputs
,deprecated
- Se acumulan
--linkopt=<a string>
usos múltiples -
Es una opción adicional para pasar a gcc durante la vinculación.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--ltobackendopt=<a string>
usos múltiples -
Es una opción adicional para pasar al paso de backend de LTO (en --features=thin_lto).
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--ltoindexopt=<a string>
usos múltiples -
Es una opción adicional para pasar al paso de indexación LTO (en --features=thin_lto).
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--macos_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se compilan objetos binarios de Apple macOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Configuración predeterminada de
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima de macOS compatible para los objetivos. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
- Configuración predeterminada de
--memprof_profile=<a build target label>
: ver descripción -
Usar el perfil de memprof.
Etiquetas:affects_outputs
--[no]objc_debug_with_GLIBCXX
valor predeterminado: "false"-
Si estableces la política y el modo de compilación está configurado como "dbg", define GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC y GLIBCPP_CONCEPT_CHECKS.
Etiquetas:action_command_lines
--[no]objc_enable_binary_stripping
valor predeterminado: "false"-
Determina si se deben quitar símbolos y códigos muertos en objetos binarios vinculados. Si se especifican esta marca y --compilation_mode=opt, se realizarán eliminaciones binarias.
Etiquetas:action_command_lines
- Se acumulan
--objccopt=<a string>
usos múltiples -
Opciones adicionales para pasar a gcc cuando se compilan archivos fuente Objective-C/C++.
Etiquetas:action_command_lines
- Se acumulan
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
usos múltiples -
Opciones adicionales para pasar selectivamente a gcc cuando se compilan ciertos archivos. Esta opción se puede aprobar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter significa una lista de patrones de expresiones regulares de inclusión y exclusión (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 ir entre comillas con una barra inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos gcc de todos los archivos cc en //foo/, excepto bar.cc.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
usos múltiples -
Opciones adicionales para pasar de forma selectiva al backend de LTO (en --features=thin_lto) cuando se compilan ciertos objetos de backend. Esta opción se puede aprobar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter significa una lista de patrones de expresiones regulares de inclusión y exclusión, y option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe ir entre comillas con una barra inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos del backend de LTO de todos los archivos o en //foo/, excepto bar.o.
Etiquetas:action_command_lines
,affects_outputs
- Configuración predeterminada de
--platform_suffix=<a string>
: ver descripción -
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas:loses_incremental_state
,affects_outputs
,loading_and_analysis
- Configuración predeterminada de
--propeller_optimize=<a build target label>
: ver descripción -
Usa la información del perfil de Propeller para optimizar el objetivo de compilación.Un perfil de propulsor debe constar de al menos uno de dos archivos, un perfil cc y un perfil ld. Esta marca acepta una etiqueta de compilación que debe hacer referencia a los archivos de entrada del perfil de propulsor. Por ejemplo, el archivo BUILD que define la etiqueta La opción debe usarse de la siguiente manera: --propeller_optimize=//a/b:propeller_profile
Etiquetas:action_command_lines
,affects_outputs
- Configuración predeterminada de
--propeller_optimize_absolute_cc_profile=<a string>
: ver descripción -
Nombre de ruta de acceso absoluto del archivo cc_profile para compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
- Configuración predeterminada de
--propeller_optimize_absolute_ld_profile=<a string>
: ver descripción -
Nombre de ruta de acceso absoluto del archivo ld_profile para compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
- Configuración predeterminada de
--run_under=<a prefix in front of command>
: ver descripción -
Es el prefijo que se debe insertar antes de los ejecutables para los comandos “test” y “run”. Si el valor es “foo -bar”, y la línea de comandos de ejecución es “test_binary -baz”, la línea de comandos final es “foo -bar test_binary -baz”. También puede ser una etiqueta para un destino ejecutable. Estos son algunos ejemplos: 'valgrind', 'strace', 'strace -c', 'valgrind --quiet --num-callers=20', '//package:target', '//package:target --options'.
Etiquetas:action_command_lines
-
Si es "true", las bibliotecas nativas que contengan la misma funcionalidad se compartirán entre diferentes destinos
Etiquetas:loading_and_analysis
,affects_outputs
--[no]stamp
valor predeterminado: "false"-
Sella los objetos binarios con la fecha, el nombre de usuario, el nombre de host, la información del lugar de trabajo, etcétera.
Etiquetas:affects_outputs
- El valor predeterminado de
--strip=<always, sometimes or never>
es " a veces". -
Especifica si se quitan los objetos binarios y las bibliotecas compartidas (con "-Wl,--strip-debug"). El valor predeterminado de "algunas veces" significa quitar iff --compilation_mode=fastbuild.
Etiquetas:affects_outputs
- Se acumulan
--stripopt=<a string>
usos múltiples -
Opciones adicionales para quitar cuando se genera un objeto binario “<name>.stripped”.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--tvos_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se compilan objetos binarios de Apple tvOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Configuración predeterminada de
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima de tvOS compatible para simuladores de objetivo y dispositivos. Si no se especifica, se usa "tvos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan
--visionos_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se compilan objetos binarios de visionOS de Apple.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Se acumulan
--watchos_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se compilan objetos binarios de watchOS de Apple.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Configuración predeterminada de
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima de watchOS compatible para los simuladores y dispositivos de destino. Si no se especifica, se usa “watchos_sdk_version”.
Etiquetas:loses_incremental_state
- Configuración predeterminada de
--xbinary_fdo=<a build target label>
: ver 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 medida en la que Bazel aplica de manera estricta 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 entorno_group para asignarlo automáticamente a los valores de CPU a los valores target_environment.
Etiquetas:changes_inputs
,loading_and_analysis
,experimental
--[no]check_licenses
valor predeterminado: "false"-
Verifica que las restricciones de licencias impuestas por los paquetes dependientes no entren en conflicto con los modos de distribución de los destinos que se compilan. De forma predeterminada, las licencias no están marcadas.
Etiquetas:build_file_semantics
- El valor predeterminado de
--[no]check_visibility
es "true" (verdadero). - Si se inhabilita, los errores de visibilidad en las dependencias de destino descienden a advertencias.
Etiquetas:build_file_semantics
- El valor predeterminado de
--[no]desugar_for_android
es "true" (verdadero). -
Indica si se debe usar la expansión de sintaxis del código de bytes Java 8 antes de la conversión a DEX.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]desugar_java8_libs
valor predeterminado: "false"-
Determina si se deben incluir bibliotecas de Java 8 compatibles en apps para dispositivos heredados.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
yexperimental
- El valor predeterminado de
--[no]enforce_constraints
es "true" (verdadero). -
Verifica los entornos compatibles con cada destino y, luego, informa errores si algún destino tiene dependencias que no admiten los mismos entornos
Etiquetas:build_file_semantics
- El valor predeterminado de
--[no]experimental_check_desugar_deps
es "true" (verdadero). -
Indica si se debe verificar la expansión de sintaxis correcta a nivel binario de Android.
Etiquetas:eagerness_to_exit
,loading_and_analysis
,experimental
- Configuración predeterminada de
--experimental_import_deps_checking=<off, warning or error>
: "DESACTIVADA" -
Cuando se habilita, verifica si las dependencias de aar_import están completas. Esta aplicación puede dañar la compilación o simplemente generar advertencias.
Etiquetas:loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
valor predeterminado: "default"-
Si es verdadero, verifica que un destino de Java declare de forma explícita todos los destinos usados de forma directa como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files
valor predeterminado: "false"-
Si se habilita esta opción, verifica los objetivos de solo prueba de los requisitos previos que sean archivos de salida. Para ello, busca el solo de prueba de la regla de generación. Esto coincide con la verificación de visibilidad.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_check_visibility_for_toolchains
valor predeterminado: "false"-
Si se habilita, la verificación de visibilidad también se aplica a las implementaciones de las cadenas de herramientas.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_disable_native_android_rules
valor predeterminado: "false"-
Si se habilita, se inhabilita el uso directo de las reglas nativas de Android. Usa las reglas de Starlark para Android de https://github.com/bazelbuild/rules_android
Etiquetas:eagerness_to_exit
,incompatible_change
--[no]incompatible_disable_native_apple_binary_rule
valor predeterminado: "false"-
No-ops. Se conserva aquí para brindar retrocompatibilidad.
Etiquetas:eagerness_to_exit
,incompatible_change
- El valor predeterminado de
--[no]incompatible_python_disable_py2
es "true" (verdadero). -
Si es verdadero, usar la configuración de Python 2 generará un error. Esto incluye python_version=PY2, srcs_version=PY2 y srcs_version=PY2ONLY. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/15684.
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_validate_top_level_header_inclusions
es "true" (verdadero). -
Esta marca es una noop y se programó su eliminación.
Etiquetas:no_op
,incompatible_change
- Configuración predeterminada de
--python_native_rules_allowlist=<a build target label>
: ver descripción -
Una lista de entidades permitidas (objetivo de grupo de paquete) para usar cuando se aplique --incompatible_python_Disallow_native_rules.
Etiquetas:loading_and_analysis
--[no]strict_filesets
valor predeterminado: "false"- Si se habilita esta opción, los conjuntos de archivos que cruzan los límites de los paquetes se informan como errores.
Etiquetas:build_file_semantics
,eagerness_to_exit
- El valor predeterminado de
--strict_proto_deps=<off, warn, error, strict or default>
es "error" -
A menos que esté DESACTIVADO, verifica que un destino proto_library declare de forma explícita todos los destinos usados de forma directa como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
- El valor predeterminado de
--strict_public_imports=<off, warn, error, strict or default>
es "desactivado" -
A menos que esté DESACTIVADO, verifica que un destino proto_library declare de forma explícita todos los destinos usados en "import public" como exportados.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
--[no]strict_system_includes
valor 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
--target_environment=<a build target label>
usos múltiples -
Declara el entorno de destino de esta compilación. Debe ser una referencia de etiqueta a una regla de “entorno”. Si se especifica, todos los destinos 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 usa para firmar APKs
Etiquetas:action_command_lines
,affects_outputs
,loading_and_analysis
- El valor predeterminado de
--[no]device_debug_entitlements
es "true" (verdadero). -
Si se configura y el modo de compilación no es "opt", las apps de objc incluirán derechos de depuración durante la firma.
Etiquetas:changes_inputs
- Configuración predeterminada de
--ios_signing_cert_name=<a string>
: ver descripción -
Nombre del certificado que se usará para la firma de iOS. Si no la estableces, se recurrirá al perfil de aprovisionamiento. Puede ser la preferencia de identidad del llavero del certificado o (subcadena) del nombre común del certificado, según la página manual de la señal de código (SIGNING IDENTITIES).
Etiquetas:action_command_lines
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE.:
- El valor predeterminado de
--[no]incompatible_disallow_legacy_py_provider
es "true" (verdadero). -
No-ops, se quitará pronto.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_sdk_frameworks_attributes
valor predeterminado: "false"-
Si el valor es "true", se inhabilitan los atributos sdk_frameworks y débil_sdk_frameworks en objc_library andobjc_import.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_objc_alwayslink_by_default
valor predeterminado: "false"-
Si el valor predeterminado es "true", 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
valor 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 determinan el comportamiento del entorno de pruebas o del ejecutor de pruebas:
--[no]allow_analysis_failures
valor predeterminado: "false"-
Si es verdadero, una falla de análisis de un destino de regla provocará la propagación del objetivo de una instancia de AnalysisFailureInfo que contiene la descripción del error, en lugar de 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 mediante un atributo de regla con una transición de configuración for_analysis_testing. Si se supera ese límite, se mostrará un error de regla.
Etiquetas:loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure
valor predeterminado: "false"-
Si se producen errores reales en la acción de dex2oat, la compilación falla en lugar de ejecutar dex2oat durante el tiempo de ejecución de la prueba.
Etiquetas:loading_and_analysis
,experimental
- Se acumulan
--default_test_resources=<a resource name followed by equal and 1 float or 4 float, e.g memory=10,30,60,100>
usos múltiples - Anula la cantidad predeterminada de recursos para las pruebas. El formato esperado es <resource>=<value>. Si se especifica un solo número positivo como <value>, se anularán los recursos predeterminados para todos los tamaños de prueba. Si se especifican 4 números separados por comas, anularán la cantidad de recursos para los tamaños de prueba pequeños, medianos, grandes y, respectivamente. Los valores también pueden ser HOST_RAM/HOST_CPU, opcionalmente seguido de [-|*]<float> (p. ej., memoria=HOST_RAM*.1, HOST_RAM*.2, HOST_RAM*.3, HOST_RAM*.4). Los recursos de prueba predeterminados que especifica esta marca se anulan con los recursos explícitos especificados en las etiquetas.
--[no]experimental_android_use_parallel_dex2oat
valor predeterminado: "false"-
Usa dex2oat en paralelo para, quizás, acelerar android_test.
Etiquetas:loading_and_analysis
,host_machine_resource_optimizations
,experimental
--[no]ios_memleaks
valor predeterminado: "false"-
Habilita la comprobación de fugas de memoria en los destinos ios_test.
Etiquetas:action_command_lines
- Configuración predeterminada de
--ios_simulator_device=<a string>
: ver 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 que se ejecutará el simulador.
Etiquetas:test_runner
- Configuración predeterminada de
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Es la versión de iOS que se ejecutará en el simulador cuando se ejecute o realice pruebas. Esto se ignora para las reglas ios_test si se especifica un dispositivo de destino en la regla.
Etiquetas:test_runner
- Se acumulan
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
usos múltiples - Especifica la cantidad de veces que se debe ejecutar cada prueba. Si alguno de esos intentos falla por algún motivo, toda la prueba se considerará fallida. Normalmente, el valor especificado es solo un número entero. Ejemplo: --runs_per_test=3 ejecutará todas las pruebas 3 veces. Sintaxis alternativa: regex_filter@runs_per_test. Donde run_per_test significa un valor de número entero y regex_filter significa una lista de patrones de expresiones regulares de inclusión y exclusión (también consulta --instrumentation_filter). Ejemplo: --runs_per_test=//foo/.*,-//foo/bar/.*@3 ejecuta todas las pruebas en //foo/ excepto las que se encuentran en foo/bar tres veces. Esta opción se puede aprobar varias veces. El último argumento pasado que coincida tendrá prioridad. Si no hay coincidencia, la prueba se ejecuta solo una vez.
- Se acumulan
--test_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
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á desde el entorno del cliente de Bazel o mediante el par nombre=valor. Esta opción se puede usar varias veces para especificar distintas variables. Solo lo usa el comando “bazel test”.
Etiquetas:test_runner
--test_timeout=<a single integer or comma-separated list of 4 integers>
valor predeterminado: "-1"- Anula los valores predeterminados de tiempo de espera de la prueba (en segundos). Si se especifica un solo valor entero positivo, se anularán todas las categorías. Si se especifican 4 números enteros separados por comas, estos anularán los tiempos de espera: corto, moderado, largo y eterno (en ese orden). En cualquier forma, un valor de -1 le indica a blaze que use sus tiempos de espera predeterminados para esa categoría.
- El valor predeterminado de
--[no]zip_undeclared_test_outputs
es "true" (verdadero). -
Si es verdadero, los resultados de pruebas no declarados se archivarán en un archivo ZIP.
Etiquetas:test_runner
- Opciones relacionadas con el resultado y la semántica de la consulta:
- El valor predeterminado de
--aspect_deps=<off, conservative or precise>
es "conservador". -
Cómo resolver dependencias de aspecto cuando el formato de salida es {xml,proto,record}. “desactivado” significa que no se resuelven las dependencias de aspecto, “conservadora” (el valor predeterminado) significa que se agregan todas las dependencias de aspecto declaradas sin importar si se les otorga la clase de regla de las dependencias directas. “preciso” significa que solo se agregan esos aspectos que posiblemente estén activos dada la clase de regla de las dependencias directas. Ten en cuenta que el modo preciso requiere cargar otros paquetes para evaluar un solo objetivo, por lo que es más lento que los otros modos. Además, ten en cuenta que incluso el modo preciso no es del todo preciso: la decisión de calcular un aspecto se decide en la fase de análisis, que no se ejecuta durante la “consulta de Bazel”.
Etiquetas:build_file_semantics
--[no]consistent_labels
valor predeterminado: "false"-
Si se habilita, cada comando de consulta emite etiquetas como si lo hiciera la función <code>str</code> de Starlark aplicada a una instancia de <code>etiqueta</code>. Esto es útil para las herramientas que necesitan hacer coincidir el resultado de diferentes comandos de consulta o etiquetas emitidas por reglas. Si no están habilitados, los formateadores de salida tienen la libertad de emitir nombres de repositorio aparentes (en relación con el repositorio principal) para que los resultados sean más legibles.
Etiquetas:terminal_output
--[no]experimental_explicit_aspects
valor predeterminado: "false"-
aquery, cquery: si se deben incluir acciones generadas por el aspecto en el resultado. query: no-op (siempre se siguen los aspectos).
Etiquetas:terminal_output
- El valor predeterminado de
--[no]graph:factored
es "true" (verdadero). -
Si es "true", el gráfico se emitirá "factorizado", es decir, los nodos equivalentes topológicamente se combinarán y sus etiquetas se concatenarán. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--graph:node_limit=<an integer>
predeterminado: "512"-
La longitud máxima de la string de etiqueta para un nodo del gráfico en el resultado. Las etiquetas más largas se truncarán; -1 significa que no hay truncamiento. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]implicit_deps
es "true" (verdadero). -
Si se habilita, las dependencias implícitas se incluirán en el gráfico de dependencias en el que opera la consulta. Una dependencia implícita es aquella que no se especifica de forma explícita en el archivo BUILD, sino que Bazel la agrega. En el caso de cquery, esta opción controla el filtrado de cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
- El valor predeterminado de
--[no]include_aspects
es "true" (verdadero). -
aquery, cquery: si se deben incluir acciones generadas por el aspecto en el resultado. query: no-op (siempre se siguen los aspectos).
Etiquetas:terminal_output
- El valor predeterminado de
--[no]incompatible_package_group_includes_double_slash
es "true" (verdadero). -
Si se habilita, cuando se genere el atributo `packages` de package_group, no se omitirá el signo `//` inicial.
Etiquetas:terminal_output
,incompatible_change
--[no]infer_universe_scope
valor predeterminado: "false"-
Si se configura y --universe_scope no se establece, se inferirá un valor de --universe_scope como la lista de patrones de objetivo únicos en la expresión de consulta. Ten en cuenta que el valor de --universe_scope que se infiere para una expresión de consulta que utiliza funciones con alcance universal (p.ej., `allrdeps`) puede no ser lo que quieres, por lo que solo debes usar esta opción si sabes lo que estás haciendo. Consulta https://bazel.build/reference/query#sky-query para obtener detalles y ejemplos. Si se configura --universe_scope, se ignora el valor de esta opción. Nota: Esta opción solo se aplica a “consulta” (es decir, no a “cquery”).
Etiquetas:loading_and_analysis
--[no]line_terminator_null
valor predeterminado: "false"-
Indica si cada formato termina con \0 en lugar de una línea nueva.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]nodep_deps
es "true" (verdadero). -
Si se habilita, las dependencias de los atributos “nodep” se incluirán en el gráfico de dependencias en el que opera la consulta. Un ejemplo común de un atributo “nodep” es la “visibilidad”. Ejecuta y analiza el resultado de `info build-language` para conocer todos los atributos “nodep” en el lenguaje de compilación.
Etiquetas:build_file_semantics
--output=<a string>
, valor predeterminado: “label”-
El formato en el que se deben imprimir los resultados de cquery. Los valores permitidos para cquery son los siguientes: label, label_kind, textproto, transiciones, proto, streaming_proto, jsonproto. Si seleccionas "transitions", también debes especificar la opción --transitions=(lite|full).
Etiquetas:terminal_output
- El valor predeterminado de
--[no]proto:default_values
es "true" (verdadero). -
Si el valor es "true", 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
valor predeterminado: "false"-
Propaga el campo proto define_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
- El valor predeterminado de
--[no]proto:flatten_selects
es "true" (verdadero). -
Si se habilita, se compactan los atributos configurables creados por select(). Para los tipos de lista, la representación plana es una lista que contiene cada valor del mapa de selección exactamente una vez. Los tipos escalares se acoplan a nulos.
Etiquetas:build_file_semantics
--[no]proto:include_attribute_source_aspects
valor predeterminado: "false"-
Propaga el campo proto source_aspect_name de cada Atributo con el aspecto de origen del que provino (si no lo hizo, una cadena vacía).
Etiquetas:terminal_output
- El valor predeterminado de
--[no]proto:include_configurations
es "true" (verdadero).
Si se habilita - , el resultado de proto incluirá información sobre los parámetros de configuración. Cuando se inhabilita,el formato de salida de cquery proto se asemeja al formato de resultados de la consulta.
Etiquetas:affects_outputs
--[no]proto:include_synthetic_attribute_hash
valor predeterminado: "false"-
Indica si se debe calcular y propagar el atributo $internal_attr_hash o no.
Etiquetas:terminal_output
--[no]proto:instantiation_stack
valor 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
- El valor predeterminado de
--[no]proto:locations
es "true" (verdadero). - Indica si se debe generar información de ubicación en el resultado de proto.
Etiquetas:terminal_output
- La configuración predeterminada de
--proto:output_rule_attrs=<comma-separated list of options>
es "todos" -
Lista de atributos separados por comas para incluir en el resultado. La configuración predeterminada es todos los atributos. Se establece como una cadena vacía para no generar ningún atributo. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]proto:rule_inputs_and_outputs
es "true" (verdadero). -
Indica si se deben propagar los campos rule_input y rule_output o no.
Etiquetas:terminal_output
--query_file=<a string>
predeterminado: ""-
Si se configura, la consulta leerá la consulta desde el archivo que se menciona aquí, en lugar de hacerlo desde la línea de comandos. Es un error especificar un archivo aquí, así como una consulta de línea de comandos.
Etiquetas:changes_inputs
--[no]relative_locations
valor predeterminado: "false"-
Si es "true", la ubicación de los archivos BUILD en los resultados xml y proto será relativa. De forma predeterminada, el resultado de la ubicación es una ruta de acceso absoluta y no será coherente en todas las máquinas. Puedes configurar esta opción como verdadera para obtener un resultado coherente en todas las máquinas.
Etiquetas:terminal_output
- El valor predeterminado de
--show_config_fragments=<off, direct or transitive>
es "desactivado" -
Muestra los fragmentos de configuración que requiere una regla y sus dependencias transitivas. Esto puede ser útil para evaluar cuánto se puede recortar un gráfico de destino configurado.
Etiquetas:affects_outputs
--starlark:expr=<a string>
predeterminado: ""-
Una expresión de Starlark para dar formato a cada destino configurado en el modo --output=starlark de cquery. El destino configurado está vinculado al “objetivo”. Si no se especifica --starlark:expr ni --starlark:file, esta opción se establecerá de forma predeterminada como “str(target.label)”. Es un error especificar --starlark:expr y --starlark:file.
Etiquetas:terminal_output
--starlark:file=<a string>
predeterminado: ""-
Es el nombre de un archivo que define una función de Starlark llamada "formato" de un argumento que se aplica a cada destino configurado para darle formato como una cadena. Es un error especificar --starlark:expr y --starlark:file. Consulta la ayuda de --output=starlark para obtener más detalles.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]tool_deps
es "true" (verdadero). -
Consulta: Si se inhabilita, las dependencias de la "configuración de ejecución" no se incluirán en el gráfico de dependencias en el que opera la consulta. Un perímetro de dependencia de 'ejecución de configuración', como el de cualquier regla 'proto_library' al compilador de protocolos, generalmente apunta a una herramienta ejecutada durante la compilación en lugar de a una parte del mismo programa 'target'.
Cquery: Si se inhabilita, filtra todos los destinos configurados que cruzan una transición de ejecución del objetivo de nivel superior que descubrió este objetivo configurado. Esto significa que si el objetivo de nivel superior está en la configuración de destino, solo se mostrarán los objetivos configurados también en esa configuración. Si el objetivo de nivel superior está en la configuración de ejecución, solo se mostrarán los objetivos configurados de ejecución. Esta opción NO excluirá las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
- La configuración predeterminada de
--transitions=<full, lite or none>
es “ninguna” -
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: ""-
Un conjunto de patrones de objetivo separados por comas (aditivos y sustractivos). 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.
Para cquery, la entrada a esta opción son los destinos en los que se compilan todas las respuestas, por lo que esta opción puede afectar las configuraciones y las transiciones. Si no se especifica esta opción, se supone que los destinos de nivel superior son los destinos analizados a partir de la expresión de consulta. Nota: En el caso de cquery, no especificar esta opción puede provocar que la compilación falle si los objetivos analizados a partir 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
valor predeterminado: "false"-
Filtra ProgramJar de ProGuard para quitar cualquier clase que también esté presente en LibraryJar.
Etiquetas:action_command_lines
- El valor predeterminado de
--[no]experimental_inmemory_dotd_files
es "true" (verdadero). -
Si se habilita, los archivos .d de C++ se pasarán directamente en la memoria desde los nodos de compilación remota, en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
yexperimental
- El valor predeterminado de
--[no]experimental_inmemory_jdeps_files
es "true" (verdadero). -
Si se habilita esta opción, los archivos de dependencia (.jdeps) generados a partir de compilaciones de Java se pasarán directamente a la memoria desde los nodos de compilación remota, en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
yexperimental
--[no]experimental_retain_test_configuration_across_testonly
valor predeterminado: "false"-
Cuando se habilita, --trim_test_configuration no recortará la configuración de prueba de las reglas marcadas como testonly=1. Esto tiene como objetivo reducir los problemas de conflicto de acciones cuando las reglas que no son de prueba dependen de las reglas cc_test. No tiene efecto si --trim_test_configuration es falso.
Etiquetas:loading_and_analysis
,loses_incremental_state
--[no]experimental_starlark_cc_import
valor predeterminado: "false"-
Si se habilita, se puede usar la versión de cc_import de Starlark.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_unsupported_and_brittle_include_scanning
valor predeterminado: "false"-
Determina si se deben reducir las entradas a la compilación de C/C++ analizando #include líneas de los archivos de entrada. Esto puede mejorar el rendimiento y la incrementalidad disminuyendo el tamaño de los árboles de entrada de la compilación. Sin embargo, también puede romper compilaciones porque el escáner de inclusión no implementa por completo la semántica del preprocesador de C. En particular, no comprende las directivas #include dinámicas e ignora la lógica condicional del preprocesador. Úsala bajo tu propia responsabilidad. Se cerrarán todos los problemas relacionados con esta marca que se presenten.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
- El valor predeterminado de
--[no]incremental_dexing
es "true" (verdadero). -
Realiza la mayor parte del trabajo para la conversión a DEX por separado para cada archivo Jar.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- El valor predeterminado de
--[no]objc_use_dotd_pruning
es "true" (verdadero). -
Si se configura, se usarán los archivos .d emitidos por Clang para reducir el conjunto de entradas que se pasaron a compilaciones de objc.
Etiquetas:changes_inputs
,loading_and_analysis
--[no]process_headers_in_dependencies
valor 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
- El valor predeterminado de
--[no]trim_test_configuration
es "true" (verdadero). -
Cuando se habilita, las opciones relacionadas con pruebas se borrarán en el nivel superior de la compilación. Cuando esta marca está activa, las pruebas no se pueden compilar como dependencias de reglas que no sean de prueba, pero los cambios en las opciones relacionadas con pruebas no provocarán que las reglas que no son de prueba se vuelvan a analizar.
Etiquetas:loading_and_analysis
,loses_incremental_state
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
predeterminado: "-.*"-
Imprime información de depuración durante la resolución de la cadena de herramientas. La marca toma una regex, que se compara con tipos de cadenas de herramientas y objetivos específicos para ver cuál depurar. Varias regex se pueden separar por comas y, luego, cada regex se verifica por separado. Nota: El resultado de esta marca es muy complejo y probablemente solo sea útil para los expertos en la resolución de la cadena de herramientas.
Etiquetas:terminal_output
- Opciones que especifican o modifican una entrada genérica a un comando de Bazel que no se incluye en otras categorías:
- Se acumulan
--flag_alias=<a 'name=value' flag alias>
usos múltiples - Establece un nombre abreviado para una marca de Starlark. Toma un solo par clave-valor con el formato "<key>=<value>" como argumento.
Etiquetas:changes_inputs
--[no]incompatible_default_to_explicit_init_py
valor 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. De manera precisa, cuando un destino py_binary o py_test tiene legacy_create_init configurado como "auto" (predeterminado), se trata como falso si y solo si esta marca está configurada. Consulta https://github.com/bazelbuild/bazel/issues/10076.
Etiquetas:affects_outputs
,incompatible_change
- El valor predeterminado de
--[no]incompatible_py2_outputs_are_suffixed
es "true" (verdadero). -
Si es verdadero, los destinos compilados en la configuración de Python 2 aparecerán bajo 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 los 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
- El valor predeterminado de
--[no]incompatible_py3_is_default
es "true" (verdadero). -
Si el valor es true, los destinos `py_binary` y `py_test` que no establecen su atributo `python_version` (o `default_python_version`) se establecerán de forma predeterminada como PY3 en lugar de PY2. Si estableces esta marca, también se recomienda configurar `--incompatible_py2_outputs_are_sufsolution`.
Etiquetas:loading_and_analysis
,affects_outputs
,incompatible_change
- El valor predeterminado de
--[no]incompatible_use_python_toolchains
es "true" (verdadero). -
Si se configura como verdadera, las reglas nativas ejecutables de Python usarán el entorno de ejecución de Python especificado por la cadena de herramientas de Python, en lugar del entorno de ejecución proporcionado por marcas heredadas como --python_top.
Etiquetas:loading_and_analysis
,incompatible_change
- Configuración predeterminada de
--python_version=<PY2 or PY3>
: ver descripción -
Es el modo de versión principal de Python, que puede ser “PY2” o “PY3”. Ten en cuenta que los objetivos “py_binary” y “py_test” anulan esto (incluso si no especifican explícitamente una versión), por lo que, por lo general, no hay muchas razones para proporcionar esta marca.
Etiquetas:loading_and_analysis
,affects_outputs
- Opciones varias, que no están categorizadas:
--[no]cache_test_results
[-t
] predeterminado: "auto"- Si se configura como "auto", Bazel vuelve a ejecutar una prueba solo si (1) Bazel detecta cambios en la prueba o sus dependencias, (2) la prueba se marca como externa, (3) se solicitaron varias ejecuciones de prueba con --runs_per_test o(4) si la prueba falló anteriormente. Si se configura como “sí”, Bazel almacena en caché todos los resultados de la prueba, excepto las que se marcaron como externas. Si se configura como “no”, Bazel no almacena en caché ningún resultado de prueba.
--[no]experimental_cancel_concurrent_tests
valor predeterminado: "false"-
Si es "true", el Blaze cancelará las pruebas que se ejecutan de forma simultánea en la primera ejecución exitosa. Esto solo es útil en combinación con --runs_per_test_detects_flakes.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_fetch_all_coverage_outputs
valor 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
valor predeterminado: "false"-
Si es "true", la cobertura de Clang generará un informe de LCOV.
Etiquetas:affects_outputs
,loading_and_analysis
- El valor predeterminado de
--[no]experimental_j2objc_header_map
es "true" (verdadero). - Indica si se debe generar el mapa de encabezados de J2ObjC en paralelo de la transpilación de J2ObjC.
--[no]experimental_j2objc_shorter_header_path
valor predeterminado: "false"-
Indica si se debe generar con una ruta de encabezado más corta (usa "_ios" en lugar de "_j2objc").
Etiquetas:affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
predeterminado: "javabuilder"- Habilita rutas de clase reducidas para compilaciones de Java.
--[no]experimental_limit_android_lint_to_android_constrained_java
valor predeterminado: "false"- Limita --experimental_run_android_lint_on_java_rules a bibliotecas compatibles con Android.
Etiquetas:affects_outputs
--[no]experimental_run_android_lint_on_java_rules
valor predeterminado: "false"- Determina si se deben validar las fuentes java_*.
Etiquetas:affects_outputs
--[no]explicit_java_test_deps
valor predeterminado: "false"- Especifica de forma explícita una dependencia a JUnit o Hamcrest en una java_test, en lugar de obtenerla accidentalmente desde las dependencias de TestRunner. Por el momento, solo funciona para Bazel.
- Configuración predeterminada de
--host_java_launcher=<a build target label>
: ver descripción - El Selector de Java utilizado por las herramientas que se ejecutan durante una compilación.
- Se acumulan
--host_javacopt=<a string>
usos múltiples - Son opciones adicionales para pasar a javac cuando se compilan herramientas que se ejecutan durante una compilación.
- Se acumulan
--host_jvmopt=<a string>
usos múltiples - Opciones adicionales para pasar a la VM de Java cuando se compilan herramientas que se ejecutan durante la compilación. Estas opciones se agregarán a las opciones de inicio de la VM de cada destino java_binary.
- El valor predeterminado de
--[no]incompatible_check_sharding_support
es "true" (verdadero). -
Si es verdadero, Bazel fallará una prueba fragmentada si el ejecutor de pruebas no indica que admite la fragmentación tocando el archivo en la ruta de acceso en TEST_SHARD_STATUS_FILE. Si es falso, un ejecutor de pruebas que no admita la fragmentación hará que se ejecuten todas las pruebas en cada fragmento.
Etiquetas:incompatible_change
- El valor predeterminado de
--[no]incompatible_exclusive_test_sandboxed
es "true" (verdadero). -
Si es verdadero, se ejecutarán pruebas exclusivas con la estrategia de zona de pruebas. Agrega la etiqueta “local” para forzar una ejecución de prueba exclusiva de forma local.
Etiquetas:incompatible_change
--[no]incompatible_strict_action_env
valor predeterminado: "false"-
Si es verdadero, Bazel usa un entorno con un valor estático para PATH y no hereda LD_LIBRARY_PATH. Usa --action_env=ENV_VARIABLE si deseas heredar variables de entorno específicas del cliente, pero ten en cuenta que esto puede evitar el almacenamiento en caché entre usuarios si se usa una caché compartida.
Etiquetas:loading_and_analysis
,incompatible_change
- Se acumulan
--j2objc_translation_flags=<comma-separated list of options>
usos múltiples - Opciones adicionales para pasar a la herramienta J2ObjC.
--java_debug
-
Hace que la máquina virtual Java de una prueba de Java espere una conexión de un depurador compatible con JDWP (como jdb) antes de comenzar la prueba. Insinúa -test_output=streamed.
Se expande a:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
- El valor predeterminado de
--[no]java_deps
es "true" (verdadero). - Genera información de dependencias (por ahora, la ruta de clase en tiempo de compilación) por destino de Java.
- El valor predeterminado de
--[no]java_header_compilation
es "true" (verdadero). - Compila ijars directamente desde la fuente.
--java_language_version=<a string>
predeterminado: ""- La versión del lenguaje Java
- Configuración predeterminada de
--java_launcher=<a build target label>
: ver descripción - El Selector de Java que se usa cuando se compilan objetos binarios de Java. Si esta marca se establece en una cadena vacía, se usa el selector de JDK. El atributo "launcher" anula esta marca.
--java_runtime_version=<a string>
valor predeterminado: "local_jdk"- La versión del entorno de ejecución de Java
- Se acumulan
--javacopt=<a string>
usos múltiples - Opciones adicionales para pasar a javac.
- Se acumulan
--jvmopt=<a string>
usos múltiples - Opciones adicionales para pasar a la VM de Java. Estas opciones se agregarán a las opciones de inicio de la VM de cada destino java_binary.
- Configuración predeterminada de
--legacy_main_dex_list_generator=<a build target label>
: ver descripción - Especifica un objeto binario que se usará para generar la lista de clases que deben estar en el DEX principal cuando se compila multidex heredado.
- Configuración predeterminada de
--optimizing_dexer=<a build target label>
: ver descripción - Especifica un objeto binario que se usará para realizar la conversión a DEX sin fragmentar.
- Se acumulan
--plugin=<a build target label>
usos múltiples - Complementos para usar en la compilación. Actualmente, funciona con java_plugin.
- Configuración predeterminada de
--proguard_top=<a build target label>
: ver descripción - Especifica qué versión de ProGuard se usará para quitar código cuando se compile un objeto binario de Java.
--proto_compiler=<a build target label>
predeterminado: "@bazel_tools//tools/proto:protoc"-
Es la etiqueta del compilador de protocolos.
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 j2objc
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
valor 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>
valor 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
--protocopt=<a string>
usos múltiples -
Son opciones adicionales para pasar al compilador de protobuf.
Etiquetas:affects_outputs
--[no]runs_per_test_detects_flakes
valor predeterminado: "false"- Si es verdadero, cualquier fragmento en el que al menos una ejecución o un intento se complete y al menos uno falle tenga un estado FLAKY.
- Configuración predeterminada de
--shell_executable=<a path>
: ver descripción -
Ruta de acceso absoluta al shell ejecutable para que lo use Bazel. Si no se configura, pero la variable de entorno BAZEL_SH está configurada en la primera invocación de Bazel (que inicia un servidor de Bazel), Bazel la usa. Si no se establece ninguno, Bazel usa una ruta de acceso predeterminada hard-coded 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 el uso de una shell que no es compatible con Bash puede provocar fallas de compilación o de tiempo de ejecución de los objetos binarios generados.
Etiquetas:loading_and_analysis
- Se acumulan
--test_arg=<a string>
usos múltiples - Especifica 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 recibirá argumentos idénticos. Solo lo usa el comando “bazel test”.
- Configuración predeterminada de
--test_filter=<a string>
: ver descripción - Especifica un filtro para reenviar al framework de pruebas. Se usa para limitar la ejecución de pruebas. Ten en cuenta que esto no afecta los destinos que se compilan.
--test_result_expiration=<an integer>
valor predeterminado: "-1"- Esta opción dejó de estar disponible y no tiene efecto.
--[no]test_runner_fail_fast
valor predeterminado: "false"- Reenvía la opción de falla rápida al ejecutor de pruebas. El ejecutor de pruebas debe detener la ejecución en la primera falla.
- Valor predeterminado de
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>
: "explícito" - Especifica una estrategia para la fragmentación de pruebas: "explícito" para usar solo la fragmentación si está presente el atributo de COMPILACIÓN "shard_count". “inhabilitado” para no usar nunca la fragmentación de pruebas. "forced=k" permite aplicar "k" fragmentos para las pruebas, sin importar el atributo de BUILD "shard_count".
--tool_java_language_version=<a string>
predeterminado: ""- La versión del lenguaje Java que se usa para ejecutar las herramientas que se necesitan 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
- El valor predeterminado de
--[no]use_ijars
es "true" (verdadero). - Si se habilita, esta opción hace que la compilación de Java use archivos jar de la interfaz. Esto dará como resultado una compilación incremental más rápida, pero los mensajes de error pueden ser diferentes.
Opciones de volcado
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Más lugares donde buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
valor predeterminado: "false"-
Si se configura, la caché del repositorio vinculará el archivo de forma fija en caso de un acierto de caché, en lugar de copiar. Esto sirve para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Usa este factor para escalar todos los tiempos de espera en las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que sean 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 para descargas de http.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--http_connector_retry_max_timeout=<An immutable length of time.>
: "0 s" -
Es el tiempo de espera máximo para los reintentos de descarga de HTTP. Con el valor 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 descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación en caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché; de lo contrario, se usa el valor predeterminado “<output_user_root>/cache/repos/v1”
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
valor predeterminado: "false"-
Si se establece esta configuración, no se permitirá la descarga con ="{.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no está completamente deshabilitado; ="{.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"-
Indica el porcentaje de espacio ocupado (0-100) por encima del cual GcThrashingDetector considera los eventos de presión de la memoria en función de sus límites (--gc_thrashing_limits). Si se configura en 100, GcThrashingDetector se inhabilita.
Etiquetas:host_machine_resource_optimizations
- Opciones que controlan el resultado del comando:
--[no]action_cache
valor predeterminado: "false"-
Volcar el contenido de la caché de la acción.
Etiquetas:bazel_monitoring
- La configuración predeterminada de
--memory=<none, shallow or deep>
es “ninguna” -
Vacía el uso de memoria de un nodo de Skyframe determinado.
Etiquetas:bazel_monitoring
- Configuración predeterminada de
--memory_package=<a string>
: ver descripción -
El paquete cuyo uso de memoria se debe volcar.
Etiquetas:bazel_monitoring
- Configuración predeterminada de
--memory_starlark_module=<a build target label>
: ver descripción -
El módulo de Starlark cuyo uso de memoria se debe volcar.
Etiquetas:bazel_monitoring
--[no]packages
valor predeterminado: "false"- Vacía el contenido de la caché del paquete.
Etiquetas:bazel_monitoring
--[no]rule_classes
valor predeterminado: "false"-
Clases de reglas de volcado
Etiquetas:bazel_monitoring
--[no]rules
valor predeterminado: "false"-
Reglas de volcado, incluidos los recuentos y el uso de memoria (si se hace un seguimiento de la memoria).
Etiquetas:bazel_monitoring
- El valor predeterminado de
--skyframe=<off, summary, count, value, deps, rdeps or function_graph>
es "desactivado" -
Gráfico de volcado de Skyframe: "off", "summary", "count", "value", "deps", "rdeps" o "function_graph".
Etiquetas:bazel_monitoring
--skykey_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
predeterminado: ".*"-
Filtro de regex de los nombres de SkyKey que se deben generar. Solo se utiliza con --skyframe=deps, rdeps, function_graph.
Etiquetas:bazel_monitoring
- Configuración predeterminada de
--skylark_memory=<a string>
: ver descripción -
Vuelca un perfil de memoria compatible con pprof en la ruta de acceso especificada. Para obtener más información, consulta https://github.com/google/pprof.
Etiquetas:bazel_monitoring
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE.:
- El valor predeterminado de
--[no]incompatible_depset_for_java_output_source_jars
es "true" (verdadero). -
No-ops
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_new_actions_api
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,incompatible_change
- El valor predeterminado de
--[no]incompatible_visibility_private_attributes_at_definition
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,incompatible_change
- El valor predeterminado de
--[no]separate_aspect_deps
es "true" (verdadero). -
No-op
Etiquetas:no_op
- Opciones relacionadas con la semántica y el resultado de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Especificaste las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirá en el gráfico de dependencias resueltas incluso si se declararon de forma privada en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones anteriores harán que la resolución falle. También puedes definir la versión transferida 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
- El valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
es "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 una falla de resolución, “off” para inhabilitar la verificación o “warning” para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas `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 detecte una discrepancia o “error” para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
valor predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
valor predeterminado: "actualizar"-
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son “update” para usar el archivo de bloqueo y actualizarlo si hay cambios; “error” para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o “off” para no leerlo ni escribirlo en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y se recurrirá únicamente a los posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Configuración predeterminada de
--vendor_dir=<a path>
: ver descripción -
Especifica el directorio que debe contener los repositorios externos en modo de proveedor, ya sea con el fin de recuperarlos o usarlos durante la compilación. La ruta de acceso se puede especificar como una ruta de acceso absoluta o una ruta relativa al directorio del lugar de trabajo.
Etiquetas:loading_and_analysis
- 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 fallar Bazel con un OOM. Cada límite se especifica como <period>:<count>, donde el período es una duración y el recuento es un número entero positivo. Si más del --gc_thrashing_threshold por ciento del espacio titular (montón de generación anterior) permanece ocupado después de <count> GC completas consecutivas dentro de <period>, se activa una 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"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje de montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC completo, descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos de GC completos nunca activarán disminuciones. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de recolección de elementos no utilizados completo y se supere el umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje de montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC menor, descartará el estado temporal innecesario de Skyframe, hasta esta cantidad por invocación. El valor predeterminado es Integer.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos menores de GC nunca activarán disminuciones. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento menor de recolección de elementos no utilizados y se supere el umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje retenido de montón está al menos en este umbral, descartará el estado temporal innecesario de Skyframe. Un ajuste puede permitirte mitigar el impacto de la hiperpaginación de la GC en el tiempo, cuando esta (i) causa el uso de memoria de este estado temporal y (ii) es más costosa que reconstruir el estado cuando es necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Configuración predeterminada de
--experimental_command_profile=<cpu, wall, alloc or lock>
: ver descripción - Registra un perfil de grabadora de vuelo de Java mientras dure el comando. Se debe proporcionar uno de los tipos de eventos de generación de perfiles admitidos (cpu, muro, alloc o bloqueo) como argumento. El perfil se escribe en un archivo con el nombre del tipo de evento en el directorio base de salida. La sintaxis y semántica de esta marca podría cambiar en el futuro para admitir tipos de perfil o formatos de salida adicionales; úsala bajo tu responsabilidad.
--[no]experimental_record_metrics_for_all_mnemonics
valor predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán estadísticas para todos los mnemotécnicos.
- 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é remoto:
- Configuración predeterminada de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo para configurar el cargador 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 con el que debe coincidir y otro para usar como URL sustitutiva, con referencias inversas que comienzan con "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL, y se mostrarán varias URL.
- Valor predeterminado de
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "auto" - Es el modo de subprocesos que se usará para la recuperación del repositorio. Si se configura en “off”, no se usa ningún subproceso de trabajo y la recuperación del repositorio está sujeta a reinicios. De lo contrario, utiliza un subproceso de plataforma (es decir, subproceso del SO) si se configura como “platform” o un subproceso virtual si se establece como “virtual”. Si se configura como "auto", se usan subprocesos virtuales si están disponibles (es decir, se ejecutan en JDK 21 y versiones posteriores); de lo contrario, no se usan subprocesos de trabajo.
- Opciones varias, que no están categorizadas:
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada 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
Hereda todas las opciones de test.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Más lugares donde buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
valor predeterminado: "false"-
Si se configura, la caché del repositorio vinculará el archivo de forma fija en caso de un acierto de caché, en lugar de copiar. Esto sirve para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Usa este factor para escalar todos los tiempos de espera en las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que sean 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 para descargas de http.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--http_connector_retry_max_timeout=<An immutable length of time.>
: "0 s" -
Es el tiempo de espera máximo para los reintentos de descarga de HTTP. Con el valor 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 descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación en caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché; de lo contrario, se usa el valor predeterminado “<output_user_root>/cache/repos/v1”
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
valor predeterminado: "false"-
Si se establece esta configuración, no se permitirá la descarga con ="{.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no está completamente deshabilitado; ="{.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
valor predeterminado: "false"-
Recupera todos los repositorios externos necesarios para compilar cualquier destino o repositorio. Solo funciona cuando --enable_bzlmod está activado.
Etiquetas:changes_inputs
--gc_thrashing_threshold=<an integer in 0-100 range>
predeterminado: "100"-
Indica el porcentaje de espacio ocupado (0-100) por encima del cual GcThrashingDetector considera los eventos de presión de la memoria en función de sus límites (--gc_thrashing_limits). Si se configura en 100, GcThrashingDetector se inhabilita.
Etiquetas:host_machine_resource_optimizations
--[no]keep_going
[-k
] predeterminado: "false"-
Continúa tanto como sea posible después de un error. Si bien el objetivo que falló y aquellos que dependen de él no se pueden analizar, otros requisitos previos de estos objetivos pueden serlo.
Etiquetas:eagerness_to_exit
- Valor predeterminado de
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "auto" -
Cantidad de subprocesos paralelos que se usarán en la fase de carga o análisis. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguido 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 de Starlark o la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility
valor predeterminado: "false"-
Si es incompatible_enforce_config_setting_visibility=false, esta es una noop. De lo contrario, si la 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
- El valor predeterminado de
--[no]incompatible_depset_for_java_output_source_jars
es "true" (verdadero). -
No-ops
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_enforce_config_setting_visibility
es "true" (verdadero). -
Si es verdadero, aplica restricciones de visibilidad config_setting. Si es falso, cada config_setting es visible para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_new_actions_api
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,incompatible_change
- El valor predeterminado de
--[no]incompatible_visibility_private_attributes_at_definition
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,incompatible_change
- El valor predeterminado de
--[no]separate_aspect_deps
es "true" (verdadero). -
No-op
Etiquetas:no_op
- Opciones relacionadas con el resultado y la semántica de la consulta:
- El valor predeterminado de
--aspect_deps=<off, conservative or precise>
es "conservador". -
Cómo resolver dependencias de aspecto cuando el formato de salida es {xml,proto,record}. “desactivado” significa que no se resuelven las dependencias de aspecto, “conservadora” (el valor predeterminado) significa que se agregan todas las dependencias de aspecto declaradas sin importar si se les otorga la clase de regla de las dependencias directas. “preciso” significa que solo se agregan esos aspectos que posiblemente estén activos dada la clase de regla de las dependencias directas. Ten en cuenta que el modo preciso requiere cargar otros paquetes para evaluar un solo objetivo, por lo que es más lento que los otros modos. Además, ten en cuenta que incluso el modo preciso no es del todo preciso: la decisión de calcular un aspecto se decide en la fase de análisis, que no se ejecuta durante la “consulta de Bazel”.
Etiquetas:build_file_semantics
--[no]consistent_labels
valor predeterminado: "false"-
Si se habilita, cada comando de consulta emite etiquetas como si lo hiciera la función <code>str</code> de Starlark aplicada a una instancia de <code>etiqueta</code>. Esto es útil para las herramientas que necesitan hacer coincidir el resultado de diferentes comandos de consulta o etiquetas emitidas por reglas. Si no están habilitados, los formateadores de salida tienen la libertad de emitir nombres de repositorio aparentes (en relación con el repositorio principal) para que los resultados sean más legibles.
Etiquetas:terminal_output
--[no]experimental_explicit_aspects
valor predeterminado: "false"-
aquery, cquery: si se deben incluir acciones generadas por el aspecto en el resultado. query: no-op (siempre se siguen los aspectos).
Etiquetas:terminal_output
- El valor predeterminado de
--[no]graph:factored
es "true" (verdadero). -
Si es "true", el gráfico se emitirá "factorizado", es decir, los nodos equivalentes topológicamente se combinarán y sus etiquetas se concatenarán. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--graph:node_limit=<an integer>
predeterminado: "512"-
La longitud máxima de la string de etiqueta para un nodo del gráfico en el resultado. Las etiquetas más largas se truncarán; -1 significa que no hay truncamiento. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]implicit_deps
es "true" (verdadero). -
Si se habilita, las dependencias implícitas se incluirán en el gráfico de dependencias en el que opera la consulta. Una dependencia implícita es aquella que no se especifica de forma explícita en el archivo BUILD, sino que Bazel la agrega. En el caso de cquery, esta opción controla el filtrado de cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
- El valor predeterminado de
--[no]include_aspects
es "true" (verdadero). -
aquery, cquery: si se deben incluir acciones generadas por el aspecto en el resultado. query: no-op (siempre se siguen los aspectos).
Etiquetas:terminal_output
- El valor predeterminado de
--[no]incompatible_package_group_includes_double_slash
es "true" (verdadero). -
Si se habilita, cuando se genere el atributo `packages` de package_group, no se omitirá el signo `//` inicial.
Etiquetas:terminal_output
,incompatible_change
--[no]infer_universe_scope
valor predeterminado: "false"-
Si se configura y --universe_scope no se establece, se inferirá un valor de --universe_scope como la lista de patrones de objetivo únicos en la expresión de consulta. Ten en cuenta que el valor de --universe_scope que se infiere para una expresión de consulta que utiliza funciones con alcance universal (p.ej., `allrdeps`) puede no ser lo que quieres, por lo que solo debes usar esta opción si sabes lo que estás haciendo. Consulta https://bazel.build/reference/query#sky-query para obtener detalles y ejemplos. Si se configura --universe_scope, se ignora el valor de esta opción. Nota: Esta opción solo se aplica a “consulta” (es decir, no a “cquery”).
Etiquetas:loading_and_analysis
--[no]line_terminator_null
valor predeterminado: "false"-
Indica si cada formato termina con \0 en lugar de una línea nueva.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]nodep_deps
es "true" (verdadero). -
Si se habilita, las dependencias de los atributos “nodep” se incluirán en el gráfico de dependencias en el que opera la consulta. Un ejemplo común de un atributo “nodep” es la “visibilidad”. Ejecuta y analiza el resultado de `info build-language` para conocer todos los atributos “nodep” en el lenguaje de compilación.
Etiquetas:build_file_semantics
--output=<a string>
, valor predeterminado: “label”-
El formato en el que se deben imprimir los resultados de cquery. Los valores permitidos para cquery son los siguientes: label, label_kind, textproto, transiciones, proto, streaming_proto, jsonproto. Si seleccionas "transitions", también debes especificar la opción --transitions=(lite|full).
Etiquetas:terminal_output
- El valor predeterminado de
--[no]proto:default_values
es "true" (verdadero). -
Si el valor es "true", 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
valor predeterminado: "false"-
Propaga el campo proto define_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
- El valor predeterminado de
--[no]proto:flatten_selects
es "true" (verdadero). -
Si se habilita, se compactan los atributos configurables creados por select(). Para los tipos de lista, la representación plana es una lista que contiene cada valor del mapa de selección exactamente una vez. Los tipos escalares se acoplan a nulos.
Etiquetas:build_file_semantics
--[no]proto:include_attribute_source_aspects
valor predeterminado: "false"-
Propaga el campo proto source_aspect_name de cada Atributo con el aspecto de origen del que provino (si no lo hizo, una cadena vacía).
Etiquetas:terminal_output
- El valor predeterminado de
--[no]proto:include_configurations
es "true" (verdadero).
Si se habilita - , el resultado de proto incluirá información sobre los parámetros de configuración. Cuando se inhabilita,el formato de salida de cquery proto se asemeja al formato de resultados de la consulta.
Etiquetas:affects_outputs
--[no]proto:include_synthetic_attribute_hash
valor predeterminado: "false"-
Indica si se debe calcular y propagar el atributo $internal_attr_hash o no.
Etiquetas:terminal_output
--[no]proto:instantiation_stack
valor 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
- El valor predeterminado de
--[no]proto:locations
es "true" (verdadero). - Indica si se debe generar información de ubicación en el resultado de proto.
Etiquetas:terminal_output
- La configuración predeterminada de
--proto:output_rule_attrs=<comma-separated list of options>
es "todos" -
Lista de atributos separados por comas para incluir en el resultado. La configuración predeterminada es todos los atributos. Se establece como una cadena vacía para no generar ningún atributo. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]proto:rule_inputs_and_outputs
es "true" (verdadero). -
Indica si se deben propagar los campos rule_input y rule_output o no.
Etiquetas:terminal_output
--query_file=<a string>
predeterminado: ""-
Si se configura, la consulta leerá la consulta desde el archivo que se menciona aquí, en lugar de hacerlo desde la línea de comandos. Es un error especificar un archivo aquí, así como una consulta de línea de comandos.
Etiquetas:changes_inputs
--[no]relative_locations
valor predeterminado: "false"-
Si es "true", la ubicación de los archivos BUILD en los resultados xml y proto será relativa. De forma predeterminada, el resultado de la ubicación es una ruta de acceso absoluta y no será coherente en todas las máquinas. Puedes configurar esta opción como verdadera para obtener un resultado coherente en todas las máquinas.
Etiquetas:terminal_output
- El valor predeterminado de
--show_config_fragments=<off, direct or transitive>
es "desactivado" -
Muestra los fragmentos de configuración que requiere una regla y sus dependencias transitivas. Esto puede ser útil para evaluar cuánto se puede recortar un gráfico de destino configurado.
Etiquetas:affects_outputs
--starlark:expr=<a string>
predeterminado: ""-
Una expresión de Starlark para dar formato a cada destino configurado en el modo --output=starlark de cquery. El destino configurado está vinculado al “objetivo”. Si no se especifica --starlark:expr ni --starlark:file, esta opción se establecerá de forma predeterminada como “str(target.label)”. Es un error especificar --starlark:expr y --starlark:file.
Etiquetas:terminal_output
--starlark:file=<a string>
predeterminado: ""-
Es el nombre de un archivo que define una función de Starlark llamada "formato" de un argumento que se aplica a cada destino configurado para darle formato como una cadena. Es un error especificar --starlark:expr y --starlark:file. Consulta la ayuda de --output=starlark para obtener más detalles.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]tool_deps
es "true" (verdadero). -
Consulta: Si se inhabilita, las dependencias de la "configuración de ejecución" no se incluirán en el gráfico de dependencias en el que opera la consulta. Un perímetro de dependencia de 'ejecución de configuración', como el de cualquier regla 'proto_library' al compilador de protocolos, generalmente apunta a una herramienta ejecutada durante la compilación en lugar de a una parte del mismo programa 'target'.
Cquery: Si se inhabilita, filtra todos los destinos configurados que cruzan una transición de ejecución del objetivo de nivel superior que descubrió este objetivo configurado. Esto significa que si el objetivo de nivel superior está en la configuración de destino, solo se mostrarán los objetivos configurados también en esa configuración. Si el objetivo de nivel superior está en la configuración de ejecución, solo se mostrarán los objetivos configurados de ejecución. Esta opción NO excluirá las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
- La configuración predeterminada de
--transitions=<full, lite or none>
es “ninguna” -
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: ""-
Un conjunto de patrones de objetivo separados por comas (aditivos y sustractivos). 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.
Para cquery, la entrada a esta opción son los destinos en los que se compilan todas las respuestas, por lo que esta opción puede afectar las configuraciones y las transiciones. Si no se especifica esta opción, se supone que los destinos de nivel superior son los destinos analizados a partir de la expresión de consulta. Nota: En el caso de cquery, no especificar esta opción puede provocar que la compilación falle si los objetivos analizados a partir de la expresión de consulta no se pueden compilar con opciones de nivel superior.
Etiquetas:loading_and_analysis
- Opciones relacionadas con la semántica y el resultado de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Especificaste las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirá en el gráfico de dependencias resueltas incluso si se declararon de forma privada en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones anteriores harán que la resolución falle. También puedes definir la versión transferida 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
- El valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
es "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 una falla de resolución, “off” para inhabilitar la verificación o “warning” para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas `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 detecte una discrepancia o “error” para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
--[no]configure
valor predeterminado: "false"-
Solo recupera los repositorios marcados como “configurar” para fines de configuración del sistema. Solo funciona cuando --enable_bzlmod está activado.
Etiquetas:changes_inputs
--[no]force
valor predeterminado: "false"-
Ignora el repositorio existente, si lo hay, y vuelve a forzar la recuperación del repositorio. Solo funciona cuando --enable_bzlmod está activado.
Etiquetas:changes_inputs
--[no]ignore_dev_dependency
valor predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
valor predeterminado: "actualizar"-
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son “update” para usar el archivo de bloqueo y actualizarlo si hay cambios; “error” para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o “off” para no leerlo ni escribirlo en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y se recurrirá únicamente a los posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Se acumulan
--repo=<a string>
usos múltiples -
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
- Configuración predeterminada de
--vendor_dir=<a path>
: ver descripción -
Especifica el directorio que debe contener los repositorios externos en modo de proveedor, ya sea con el fin de recuperarlos o usarlos durante la compilación. La ruta de acceso se puede especificar como una ruta de acceso absoluta o una ruta relativa al directorio del lugar de trabajo.
Etiquetas:loading_and_analysis
- 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 fallar Bazel con un OOM. Cada límite se especifica como <period>:<count>, donde el período es una duración y el recuento es un número entero positivo. Si más del --gc_thrashing_threshold por ciento del espacio titular (montón de generación anterior) permanece ocupado después de <count> GC completas consecutivas dentro de <period>, se activa una 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"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje de montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC completo, descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos de GC completos nunca activarán disminuciones. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de recolección de elementos no utilizados completo y se supere el umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje de montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC menor, descartará el estado temporal innecesario de Skyframe, hasta esta cantidad por invocación. El valor predeterminado es Integer.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos menores de GC nunca activarán disminuciones. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento menor de recolección de elementos no utilizados y se supere el umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje retenido de montón está al menos en este umbral, descartará el estado temporal innecesario de Skyframe. Un ajuste puede permitirte mitigar el impacto de la hiperpaginación de la GC en el tiempo, cuando esta (i) causa el uso de memoria de este estado temporal y (ii) es más costosa que reconstruir el estado cuando es necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Configuración predeterminada de
--experimental_command_profile=<cpu, wall, alloc or lock>
: ver descripción - Registra un perfil de grabadora de vuelo de Java mientras dure el comando. Se debe proporcionar uno de los tipos de eventos de generación de perfiles admitidos (cpu, muro, alloc o bloqueo) como argumento. El perfil se escribe en un archivo con el nombre del tipo de evento en el directorio base de salida. La sintaxis y semántica de esta marca podría cambiar en el futuro para admitir tipos de perfil o formatos de salida adicionales; úsala bajo tu responsabilidad.
--[no]experimental_record_metrics_for_all_mnemonics
valor predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán estadísticas para todos los mnemotécnicos.
--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
- Opciones que especifican o modifican 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é remoto:
- Configuración predeterminada de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo para configurar el cargador 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 con el que debe coincidir y otro para usar como URL sustitutiva, con referencias inversas que comienzan con "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL, y se mostrarán varias URL.
- Valor predeterminado de
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "auto" - Es el modo de subprocesos que se usará para la recuperación del repositorio. Si se configura en “off”, no se usa ningún subproceso de trabajo y la recuperación del repositorio está sujeta a reinicios. De lo contrario, utiliza un subproceso de plataforma (es decir, subproceso del SO) si se configura como “platform” o un subproceso virtual si se establece como “virtual”. Si se configura como "auto", se usan subprocesos virtuales si están disponibles (es decir, se ejecutan en JDK 21 y versiones posteriores); de lo contrario, no se usan subprocesos de trabajo.
- Opciones varias, que no están categorizadas:
- Se acumulan
--deleted_packages=<comma-separated list of package names>
usos múltiples - Una lista separada por comas de los nombres de los paquetes que el sistema de compilación considerará que no existen, incluso si están visibles en algún lugar de la ruta del paquete. Usa esta opción cuando borres un subpaquete 'x/y' de un paquete 'x' existente. Por ejemplo, después de borrar x/y/BUILD en el cliente, el sistema de compilación puede presentar un reclamo si encuentra la etiqueta '//x:y/z' si todavía la proporciona otra entrada package_path. Si especificas --deleted_packages x/y se evita este problema.
- El valor predeterminado de
--[no]fetch
es "true" (verdadero). - Permite que el comando recupere dependencias externas. Si se establece como falsa, el comando usará cualquier versión almacenada en caché de la dependencia. Si no existe ninguna, el comando fallará.
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
--package_path=<colon-separated list of options>
predeterminado: "%workspace%"- Una lista separada por dos puntos sobre dónde buscar paquetes. Los elementos que comienzan con "%workspace%" son relativos al lugar de trabajo que lo contiene. Si se omite o está vacío, el valor predeterminado es el resultado de “bazel info default-package-path”.
- El valor predeterminado de
--[no]show_loading_progress
es "true" (verdadero). - Si se habilita, hace que Bazel imprima mensajes "Cargando paquete:".
- Opciones que controlan la ejecución de la compilación:
--[no]all
valor predeterminado: "false"-
Recupera todos los repositorios externos necesarios para compilar cualquier destino o repositorio. Solo funciona cuando --enable_bzlmod está activado.
Etiquetas:changes_inputs
--[no]experimental_inprocess_symlink_creation
valor predeterminado: "false"-
Indica 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
valor predeterminado: "false"-
Habilita el extractor de aar persistente con trabajadores.
Etiquetas:execution
--[no]experimental_remotable_source_manifests
valor predeterminado: "false"-
Indica si se pueden hacer que las acciones del manifiesto de origen sean remotas
Etiquetas:loading_and_analysis
,execution
,experimental
--[no]experimental_split_coverage_postprocessing
valor predeterminado: "false"-
Si es verdadero, Bazel ejecutará el procesamiento posterior de la cobertura para probarlo en un nuevo generador.
Etiquetas:execution
--[no]experimental_strict_fileset_output
valor predeterminado: "false"-
Si habilitas esta opción, los conjuntos de archivos tratarán todos los artefactos de salida como archivos normales. No desviarán directorios ni serán sensibles a los symlinks.
Etiquetas:execution
--[no]keep_going
[-k
] predeterminado: "false"-
Continúa tanto como sea posible después de un error. Si bien el objetivo que falló y aquellos que dependen de él no se pueden analizar, otros requisitos previos de estos objetivos pueden serlo.
Etiquetas:eagerness_to_exit
- Valor predeterminado de
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "auto" -
Cantidad de subprocesos paralelos que se usarán en la fase de carga o análisis. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguido 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 el valor mnemotécnico de la acción. Solo se aplica a las acciones que admiten información de ejecución. Muchas acciones comunes admiten información de ejecución, p.ej., Genrule, CppCompile, Javac, StarlarkAction y TestRunner. Cuando se especifican varios valores, el orden es importante porque muchas regex pueden aplicarse al mismo valor mnemotécnico.
Sintaxis: "regex=[+-]key,regex=[+-]key,...".
Ejemplos:
“.*=+x,.*=-y,.*=+z” agrega “x” y “z” a la información de ejecución de todas las acciones y quita “y”.
“Genrule=+requires-x” agrega “require-x” a la información de ejecución para todas las acciones de Genrule.
“(?!Genrule).*=-requires-x” quita “require-x” de la información de ejecución para todas las acciones que no son de Genrule.
Etiquetas:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Habilita las acciones persistentes de dex y desugar de Android con trabajadores.
Se expande a:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
-
Habilita el procesador de recursos persistentes de Android usando 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
}}{/13/}
--strategy=Aapt2Optimize=worker
--strategy=Aapt2Optimize=worker
--strategy=Aapt2Optimize=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
--strategy=ProcessDatabinding=worker
--strategy=GenerateDataBindingBaseClasses=worker
host_machine_resource_optimizations
execution
--persistent_multiplex_android_dex_desugar
-
Habilita las acciones de dex y desugar multiplexadas 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 multiplexados persistentes de Android usando 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=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
host_machine_resource_optimizations
execution
--persistent_multiplex_android_tools
-
Habilita herramientas persistentes y multiplexadas de Android (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
valor predeterminado: "false"-
Si es "true", Bazel usará la plataforma de destino para ejecutar pruebas en lugar del grupo de ejecuciones de prueba.
Etiquetas:execution
- Opciones que configuran la cadena de herramientas usada para ejecutar la acción:
- Configuración predeterminada de
--android_compiler=<a string>
: ver 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
yloses_incremental_state
- Configuración predeterminada de
--android_grte_top=<a label>
: ver descripción -
El objetivo de Android es grte_top.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
predeterminado: "android"-
Selecciona la combinación de manifiestos que se usará para las reglas android_binary. Marca para ayudar en 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 objetivos de android_binary. Si se especifican varias plataformas, el objeto binario es un APK multiarquitectura, que incluye 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 utiliza 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"-
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
- Configuración predeterminada de
--compiler=<a string>
: ver descripción -
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 objeto binario que se usa para procesar posteriormente los informes de cobertura sin procesar. Actualmente, debe ser un grupo de archivos que contenga un solo archivo, el binario. La configuración predeterminada 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 objeto binario que se usa para generar informes de cobertura. Actualmente, debe ser un grupo de archivos que contenga un solo archivo, el binario. La configuración predeterminada 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. La configuración predeterminada es "//tools/test:coverage_support".
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
- Configuración predeterminada de
--custom_malloc=<a build target label>
: ver descripción -
Especifica una implementación de malloc personalizada. Este parámetro de configuración anula los atributos malloc en las reglas de compilación.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
usos múltiples -
Lista de expresiones regulares separadas por comas, cada una con el prefijo - (expresión negativa), asignada (=) a una lista de valores de restricción separados por comas. Si un objetivo no coincide con ninguna expresión negativa y al menos una expresión positiva, la resolución de la cadena de herramientas se ejecutará 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 aquellos cuyo nombre contenga 'prueba'.
Etiquetas:loading_and_analysis
--[no]experimental_include_xcode_execution_requirements
valor predeterminado: "false"-
Si se configura, agrega un requisito de ejecución “requires-xcode:{version}” a cada acción de Xcode. Si la versión de Xcode tiene una etiqueta con guion, también agrega un requisito de ejecución “requires-xcode-label:{version_label}”.
Etiquetas:loses_incremental_state
,loading_and_analysis
,execution
- El valor predeterminado de
--[no]experimental_prefer_mutual_xcode
es "true" (verdadero). -
Si es verdadero, usa el Xcode más reciente que esté disponible de forma local y remota. Si es falso, o si no existen 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 objetivo exacto o como patrón de objetivo. Estas plataformas se considerarán antes que las declaradas en el archivo WORKSPACE por register_execution_platforms(). Esta opción solo se puede configurar una vez; las instancias posteriores anularán la configuración de marcas anterior.
Etiquetas:execution
- Se acumulan
--extra_toolchains=<comma-separated list of options>
usos múltiples -
Son las reglas de la cadena de herramientas que se tendrán en cuenta durante su resolución. Las cadenas de herramientas se pueden especificar por objetivo exacto o como patrón de objetivo. Estas cadenas de herramientas se considerarán antes de las declaradas en el archivo WORKSPACE por register_toolchains().
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
- Configuración predeterminada de
--grte_top=<a label>
: ver descripción -
Es una etiqueta de una biblioteca libc registrada. La cadena de herramientas de herramientas cruzadas selecciona el valor predeterminado, y casi nunca necesitas anularlo.
Etiquetas:action_command_lines
,affects_outputs
- Configuración predeterminada de
--host_compiler=<a string>
: ver descripción -
Marca no-op. Se quitará en una versión futura.
Etiquetas:loading_and_analysis
,execution
- Configuración predeterminada de
--host_grte_top=<a label>
: ver descripción -
Si se especifica, esta configuración anula el directorio de nivel superior de libc (--grte_top) para la configuración de ejecución.
Etiquetas:action_command_lines
,affects_outputs
--host_platform=<a build target label>
valor predeterminado: "@local_config_platform//:host"-
Es la etiqueta de una regla de la plataforma que describe el sistema host.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
- El valor predeterminado de
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
es "true" (verdadero). -
Si es "true", 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
- El valor predeterminado de
--[no]incompatible_enable_android_toolchain_resolution
es "true" (verdadero). -
Usa la resolución de la cadena de herramientas para seleccionar el SDK de Android para reglas de Android (Starlark y nativo)
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_apple_toolchain_resolution
valor predeterminado: "false"-
Usa la resolución de la cadena de herramientas para seleccionar el SDK de Apple para las reglas de Apple (Starlark y nativo)
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_make_thinlto_command_lines_standalone
es "true" (verdadero). -
Esta marca es una noop y se programó su eliminación.
Etiquetas:no_op
,incompatible_change
- El valor predeterminado de
--[no]incompatible_remove_legacy_whole_archive
es "true" (verdadero). -
Si es verdadero, Bazel no vinculará las dependencias de la biblioteca como todo el archivo de forma predeterminada (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener instrucciones de migración).
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_require_ctx_in_configure_features
es "true" (verdadero). -
Esta marca es una noop y se programó su eliminación.
Etiquetas:no_op
,incompatible_change
--[no]incompatible_strip_executable_safely
valor predeterminado: "false"-
Si es verdadero, la acción de quitar para los ejecutables usará la marca -x, lo que no interrumpe la resolución de símbolos dinámicos.
Etiquetas:action_command_lines
,incompatible_change
- Usa objetos compartidos de interfaz si la cadena de herramientas lo admite. Todas las cadenas de herramientas de ELF admiten actualmente este parámetro de configuración.
Etiquetas:loading_and_analysis
,affects_outputs
,affects_outputs
- Configuración predeterminada de
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Especifica la versión del SDK de iOS que se usará para compilar aplicaciones para iOS. Si no se especifica, usa la versión predeterminada del SDK para iOS de “xcode_version”.
Etiquetas:loses_incremental_state
- Configuración predeterminada de
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Especifica la versión del SDK de macOS que se usará para compilar aplicaciones de macOS. Si no se especifica, se usa la versión predeterminada del SDK de macOS de “xcode_version”.
Etiquetas:loses_incremental_state
- Configuración predeterminada de
--minimum_os_version=<a string>
: ver descripción -
La versión mínima del SO a la que se orienta tu compilación.
Etiquetas:loading_and_analysis
,affects_outputs
--platform_mappings=<a relative path>
predeterminado: ""-
Es la ubicación de un archivo de asignación en la que se describe qué plataforma usar si no hay ninguna establecida o qué marcas se deben configurar cuando ya existe una plataforma. Debe estar relacionado con la raíz del lugar de trabajo principal. La configuración predeterminada es "platform_mappings", que es un archivo directamente en la raíz del lugar de trabajo.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
yimmutable
--platforms=<a build target label>
predeterminado: ""-
Las etiquetas de las reglas de la plataforma que describen las plataformas de destino para el comando actual.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
- Configuración predeterminada de
--python2_path=<a string>
: ver descripción -
Obsoleto, no-op. Inhabilitado por `--incompatible_use_python_toolchains`.
Etiquetas:no_op
,deprecated
- Configuración predeterminada de
--python3_path=<a string>
: ver descripción -
Obsoleto, no-op. Inhabilitado por `--incompatible_use_python_toolchains`.
Etiquetas:no_op
,deprecated
- Configuración predeterminada de
--python_path=<a string>
: ver descripción -
Es la ruta de acceso absoluta del intérprete de Python que se invoca para ejecutar los objetivos de Python en la plataforma de destino. Obsoleto; inhabilitado por --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
- Configuración predeterminada de
--python_top=<a build target label>
: ver descripción -
La etiqueta de un py_runtime que representa el intérprete de Python invocado para ejecutar objetivos de Python en la plataforma de destino. Obsoleto; inhabilitado por --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
- Configuración predeterminada de
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Especifica la versión del SDK de tvOS que se usará para compilar aplicaciones de tvOS. Si no se especifica, se usa la versión predeterminada del SDK de tvOS de “xcode_version”.
Etiquetas:loses_incremental_state
- Configuración predeterminada de
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Especifica la versión del SDK de watchOS que se usará para compilar aplicaciones de watchOS. Si no se especifica, se usa la versión predeterminada del SDK de watchOS de “xcode_version”.
Etiquetas:loses_incremental_state
- Configuración predeterminada de
--xcode_version=<a string>
: ver descripción -
Si se especifica, usa Xcode de la versión determinada para las acciones de compilación relevantes. Si no se especifica, usa la versión predeterminada del ejecutor de Xcode.
Etiquetas:loses_incremental_state
--xcode_version_config=<a build target label>
predeterminado: "@bazel_tools//tools/cpp:host_xcodes"-
La etiqueta de la regla xcode_config que se usará para seleccionar la versión de Xcode en la configuración de compilación.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Opciones que controlan el resultado del comando:
--[no]apple_generate_dsym
valor predeterminado: "false"-
Indica si se deben generar archivos de símbolos de depuración (.dSYM).
Etiquetas:affects_outputs
,action_command_lines
- El valor predeterminado de
--[no]build_runfile_links
es "true" (verdadero). -
Si esta opción es verdadera, compila bosques de symlinks de archivos de ejecución para todos los destinos. Si es falso, escríbelos solo cuando lo requiera una acción local, un comando de prueba o ejecución.
Etiquetas:affects_outputs
- El valor predeterminado de
--[no]build_runfile_manifests
es "true" (verdadero). -
Si esta opción es verdadera, se escriben manifiestos de archivos de ejecución para todos los destinos. Si es falso, omítelos. Las pruebas locales no se ejecutarán si el valor es falso.
Etiquetas:affects_outputs
--[no]build_test_dwp
valor predeterminado: "false"-
Si se habilita, cuando se compilen pruebas de C++ de forma estática y con fisión, 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"-
Establece los sufijos de los archivos fuente que crea una cc_proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info
valor 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
valor 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
valor predeterminado: "false"-
Guarda el estado de las funciones habilitadas y solicitadas como resultado de la compilación.
Etiquetas:affects_outputs
,experimental
- El valor predeterminado de
--fission=<a set of compilation modes>
es "no" -
Especifica qué modos de compilación usan fisión para compilaciones y 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
- El valor predeterminado de
--[no]incompatible_always_include_files_in_data
es "true" (verdadero). -
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
- El valor predeterminado de
--[no]legacy_external_runfiles
es "true" (verdadero). -
Si esta opción es verdadera, compila bosques de symlink de archivos de ejecución para repositorios externos en .runfiles/wsname/external/repo (además de .runfiles/repo).
Etiquetas:affects_outputs
--[no]objc_generate_linkmap
valor predeterminado: "false"-
Especifica si se debe generar un archivo de mapa de vínculos.
Etiquetas:affects_outputs
--[no]save_temps
valor predeterminado: "false"-
Si se establece, se guardarán los resultados temporales de GCC. Estos incluyen archivos .s (código ensamblador), archivos .i (C preprocesado) y archivos .ii (C++ previamente procesados).
Etiquetas:affects_outputs
- Opciones que permiten al usuario configurar el resultado deseado y afectar su valor, en lugar de su existencia:
- Se acumulan
--action_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica el conjunto de variables de entorno disponibles para 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 mediante el par nombre=valor que establece el valor independientemente del entorno de invocación. Esta opción se puede usar varias veces; para opciones proporcionadas para la misma variable, se acumulan los últimos éxitos, las opciones para diferentes variables se acumulan.
Etiquetas:action_command_lines
--android_cpu=<a string>
predeterminado: "armeabi-v7a"-
Es la CPU de destino de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- El valor predeterminado de
--[no]android_databinding_use_androidx
es "true" (verdadero). -
Genera archivos de vinculación de datos compatibles con AndroidX. Esto solo se usa con Databinding v2. Esta marca es una no-op.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- El valor predeterminado de
--[no]android_databinding_use_v3_4_args
es "true" (verdadero). -
Usa Android Databinding v2 con un argumento 3.4.0. Esta marca es una no-op.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- El valor predeterminado de
--android_dynamic_mode=<off, default or fully>
es "desactivado" -
Determina si las dependencias de C++ de las reglas de Android se vincularán de forma dinámica cuando un objeto cc_binary no cree explícitamente una biblioteca compartida. “default” significa que Bazel decide si se vincula de forma dinámica. "completamente" significa que todas las bibliotecas se vincularán de forma dinámica. “off” significa que todas las bibliotecas se vincularán en su mayor parte en modo estático.
Etiquetas:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
valor predeterminado: "alphabetical"-
Establece el orden de los manifiestos que se pasan a la combinación de manifiestos para objetos binarios de Android. ALFABÉTICO significa que los manifiestos se ordenan por ruta de acceso relativa a la execroot. ALPHABETICAL_BY_CONFIGURATION significa que los manifiestos se ordenan por rutas de acceso relacionadas con el directorio de configuración dentro del directorio de salida. DEPENDENCY significa que los manifiestos se ordenan con los manifiestos de cada biblioteca antes que los de sus dependencias.
Etiquetas:action_command_lines
,execution
--[no]android_resource_shrinking
valor predeterminado: "false"-
Habilita la reducción de recursos para los APKs de android_binary que usan ProGuard.
Etiquetas:affects_outputs
,loading_and_analysis
- Valor predeterminado de
--[no]build_python_zip
: "auto" -
Compila el archivo ZIP del comando de Python; en Windows, desactivado en otras plataformas
Etiquetas:affects_outputs
- Se acumulan
--catalyst_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se compilan los objetos binarios de Apple Catalyst.
Etiquetas:loses_incremental_state
,loading_and_analysis
--[no]collect_code_coverage
valor predeterminado: "false"-
Si se especifica, Bazel instrumentará código (con instrumentación sin conexión cuando sea posible) y recopilará información de cobertura durante las pruebas. Solo se verán afectados los objetivos que coincidan con --instrumentation_filter. Por lo general, esta opción no debe especificarse directamente; en su lugar, debes usar el comando "bazel esquema".
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
--conlyopt=<a string>
usos múltiples -
Es una opción adicional para pasar a gcc cuando se compilan archivos de origen C.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--copt=<a string>
usos múltiples -
Opciones adicionales para pasar a gcc.
Etiquetas:action_command_lines
,affects_outputs
--cpu=<a string>
predeterminado: ""-
La CPU de destino.
Etiquetas:changes_inputs
,affects_outputs
- Configuración predeterminada de
--cs_fdo_absolute_path=<a string>
: ver descripción - Usa la información del perfil de CSFDO para optimizar la compilación. Especifica el nombre de ruta de acceso absoluto del archivo ZIP que contiene el archivo de perfil, un archivo de perfil de LLVM sin procesar o indexado.
Etiquetas:affects_outputs
- Configuración predeterminada de
--cs_fdo_instrument=<a string>
: ver descripción - Genera objetos binarios con instrumentación de FDO sensible al contexto. Con el compilador Clang/LLVM, también acepta el nombre de directorio bajo el cual se volcarán los archivos de perfil sin procesar durante el tiempo de ejecución.
Etiquetas:affects_outputs
- Configuración predeterminada de
--cs_fdo_profile=<a build target label>
: ver descripción -
El cs_fdo_profile, que representa el perfil sensible al contexto que se usará para la optimización.
Etiquetas:affects_outputs
- Se acumulan
--cxxopt=<a string>
usos múltiples -
Es una opción adicional para pasar a gcc cuando se compilan archivos de origen C++.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--define=<a 'name=value' assignment>
usos múltiples -
Cada opción --define especifica una asignación para una variable de compilación. Si hay varios valores para una variable, ganará el último.
Etiquetas:changes_inputs
,affects_outputs
--dynamic_mode=<off, default or fully>
valor predeterminado: "default"-
Determina si los objetos binarios de C++ se vincularán de forma dinámica. “predeterminada” significa que Bazel elegirá si se vinculará de forma dinámica. "completamente" significa que todas las bibliotecas se vincularán de forma dinámica. “off” significa que todas las bibliotecas se vincularán en su mayor parte en modo estático.
Etiquetas:loading_and_analysis
,affects_outputs
- El valor predeterminado de
--[no]enable_fdo_profile_absolute_path
es "true" (verdadero). -
Si se configura, el uso de fdo_absolute_profile_path generará un error.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]enable_runfiles
: "auto" -
Habilita el árbol del symlink de los archivos de ejecución. De forma predeterminada, está desactivado en Windows y en otras plataformas.
Etiquetas:affects_outputs
- Se acumulan
--experimental_action_listener=<a build target label>
usos múltiples -
Se dio de baja a favor de los 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
valor predeterminado: "false"-
Comprime los recursos de Java en APK
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
- El valor predeterminado de
--[no]experimental_android_databinding_v2
es "true" (verdadero). - Usa Android Databinding v2. Esta marca es una no-op.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_android_resource_shrinking
valor 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
valor predeterminado: "false"-
usar la herramienta Rex para reescribir archivos dex
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_collect_code_coverage_for_generated_files
valor predeterminado: "false"-
Si se especifica, Bazel también generará información de cobertura para los archivos generados.
Etiquetas:affects_outputs
--experimental_objc_fastbuild_options=<comma-separated list of options>
predeterminado: "-O0,-DDEBUG=1"-
Usa estas cadenas como opciones del compilador objc fastbuild.
Etiquetas:action_command_lines
--[no]experimental_omitfp
valor predeterminado: "false"-
Si esta opción es "true", usa libunwind para desenrollar la pila y compila con -fomit-frame-pointer y -fasym-unwind-tables.
Etiquetas:action_command_lines
,affects_outputs
,experimental
- El valor predeterminado de
--experimental_output_paths=<off, content or strip>
es "desactivado" -
Indica qué modelo usar en qué parte de las reglas del árbol de resultados escriben sus resultados, en particular para compilaciones multiplataforma o de varias configuraciones. Esto es altamente experimental. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/6526. Las acciones de Starlark pueden habilitar la asignación de ruta agregando la clave “supports-path-mapping” al diccionario “execution_requirements”.
Etiquetas:loses_incremental_state
,bazel_internal_configuration
,affects_outputs
yexecution
- Se acumulan
--experimental_override_name_platform_in_output_dir=<a 'label=value' assignment>
usos múltiples -
Cada entrada debe tener el formato label=value, en el que la etiqueta hace referencia a una plataforma y los valores son el nombre corto deseado para usar en la ruta de acceso del resultado. Solo se usa cuando --experimental_platform_in_output_dir es verdadero. Tiene la prioridad de nombre más alta.
Etiquetas:affects_outputs
,experimental
--[no]experimental_platform_in_output_dir
valor 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: en primer lugar, en el caso poco frecuente de que la opción --platforms no tenga exactamente un valor, se utilizará un hash de la opción de plataformas. Luego, si --experimental_override_name_platform_in_output_dir registró algún nombre corto para la plataforma actual, entonces se utiliza ese nombre corto. Luego, si se configura --experimental_use_platforms_in_output_dir_legacy_heuristic, se debe utilizar un nombre corto basado en la etiqueta actual de la plataforma. Por último, se usa un hash de la opción de plataforma como último recurso.
Etiquetas:affects_outputs
,experimental
--[no]experimental_use_llvm_covmap
valor predeterminado: "false"-
Si se especifica, Bazel generará información del mapa de cobertura llvm-cov en lugar de gcov cuando collect_code_coverage esté habilitado.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
yexperimental
- El valor predeterminado de
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic
es "true" (verdadero). -
Usa esta marca solo como parte de una estrategia sugerida de migración o prueba. 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"-
Mediante la configuración de esta opción, se habilitan los APK multiarquitecturas, 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, --android_cpu se ignora para dependencias de reglas android_binary.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]fat_apk_hwasan
valor predeterminado: "false"-
Marca no-op. Se quitará en una versión futura.
Etiquetas:no_op
- Configuración predeterminada de
--fdo_instrument=<a string>
: ver descripción - Genera objetos binarios con instrumentación de FDO. Con el compilador Clang/LLVM, también acepta el nombre de directorio bajo el cual se volcarán los archivos de perfil sin procesar durante el tiempo de ejecución.
Etiquetas:affects_outputs
- Configuración predeterminada de
--fdo_optimize=<a string>
: ver 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 apunten a objetivos de `fdo_profile`. Esta marca será reemplazada por la regla “fdo_profile”.
Etiquetas:affects_outputs
- Configuración predeterminada de
--fdo_prefetch_hints=<a build target label>
: ver descripción -
Usa sugerencias de carga previa de caché.
Etiquetas:affects_outputs
- Configuración predeterminada de
--fdo_profile=<a build target label>
: ver descripción -
El fdo_profile, que representa el perfil que se utilizará para la optimización.
Etiquetas:affects_outputs
- Se acumulan
--features=<a string>
usos múltiples -
Estas funciones estarán habilitadas o inhabilitadas de forma predeterminada para los destinos integrados en la configuración de destino. Si especificas -<feature>, se inhabilitará la función. Los atributos negativos siempre anulan a los positivos. Consulta también --host_features
Etiquetas:changes_inputs
,affects_outputs
--[no]force_pic
valor predeterminado: "false"-
Si se habilita, todas las compilaciones de C++ producen código independiente de la posición ("-fPIC"), los vínculos prefieren bibliotecas PIC compiladas previamente en lugar de bibliotecas que no son PIC, y los vínculos producen ejecutables independientes de la posición ("-pie").
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan
--host_action_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica el conjunto de variables de entorno disponibles para acciones con configuraciones de ejecución. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o mediante el par nombre=valor que establece el valor independientemente del entorno de invocación. Esta opción se puede usar varias veces; para opciones proporcionadas para la misma variable, se acumulan los últimos éxitos, las opciones para diferentes variables se acumulan.
Etiquetas:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
valor predeterminado: "opt"- Especifica el modo en el que se integrarán las herramientas usadas durante la compilación. Valores: "fastbuild", "dbg", "opt".
Etiquetas:affects_outputs
,action_command_lines
- Se acumulan
--host_conlyopt=<a string>
usos múltiples -
Es una opción adicional para pasar al compilador C cuando se compilan archivos de origen C (pero no C++) en las configuraciones de ejecución.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--host_copt=<a string>
usos múltiples -
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: ""-
Es la CPU del host.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan
--host_cxxopt=<a string>
usos múltiples -
Opciones adicionales para pasar al compilador de C++ para herramientas compiladas en configuraciones de ejecución.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--host_features=<a string>
usos múltiples -
Las funciones determinadas estarán habilitadas o inhabilitadas de forma predeterminada para los destinos integrados en la configuración de ejecución. Si especificas -<feature>, se inhabilitará la función. Los atributos negativos siempre anulan a los positivos.
Etiquetas:changes_inputs
,affects_outputs
- Configuración predeterminada de
--host_force_python=<PY2 or PY3>
: ver descripción -
Anula la versión de Python para la configuración de ejecución. Puede ser “PY2” o “PY3”.
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan
--host_linkopt=<a string>
usos múltiples -
Es una opción adicional para pasar al vinculador cuando se vinculan herramientas en la configuración de ejecución.
Etiquetas:action_command_lines
,affects_outputs
- Configuración predeterminada de
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima de macOS compatible para los destinos de host. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
usos múltiples -
Son 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 aprobar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter significa una lista de patrones de expresiones regulares de inclusión y exclusión (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 ir entre comillas con una barra inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos gcc de todos los archivos cc en //foo/, excepto bar.cc.
Etiquetas:action_command_lines
,affects_outputs
--[no]incompatible_auto_exec_groups
valor predeterminado: "false"-
Cuando se habilita, se crea automáticamente un grupo de ejecutables 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
- El valor predeterminado de
--[no]incompatible_merge_genfiles_directory
es "true" (verdadero). -
Si es verdadero, el directorio genfiles se pliega en el directorio bin.
Etiquetas:affects_outputs
,incompatible_change
--[no]instrument_test_targets
valor predeterminado: "false"-
Cuando la cobertura está habilitada, especifica si se debe considerar la instrumentación de reglas de prueba. Cuando se establece, se instrumentan las reglas de prueba incluidas por --instrumentation_filter. De lo contrario, las reglas de prueba siempre se excluyen de la instrumentación de cobertura.
Etiquetas:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
valor predeterminado: "-/javatests[/:],-/test/java[/:]"-
Cuando la cobertura esté habilitada, solo se instrumentarán las reglas con nombres incluidos en el filtro basado en regex especificado. En su lugar, se excluyen las reglas con el prefijo “-”. Ten en cuenta que solo se instrumentan las reglas que no son de prueba, a menos que esté habilitado --instrument_test_targets.
Etiquetas:affects_outputs
- Configuración predeterminada de
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima de iOS compatible con los simuladores y dispositivos de destino. Si no se especifica, usa “ios_sdk_version”.
Etiquetas:loses_incremental_state
- Se acumulan
--ios_multi_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para compilar una ios_application. El resultado es un objeto binario universal que contiene todas las arquitecturas especificadas.
Etiquetas:loses_incremental_state
,loading_and_analysis
- El valor predeterminado de
--[no]legacy_whole_archive
es "true" (verdadero). -
Obsoleto y sustituido por --incompatible_remove_legacy_whole_archive (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener más información). Cuando esta opción está activada, se usa --whole-archive para reglas cc_binary que tengan linkshared=True y linkstatic=True o '-static' en linkopts. Esto es solo para retrocompatibilidad. Una mejor alternativa es usar Alwayslink=1 cuando sea necesario.
Etiquetas:action_command_lines
,affects_outputs
,deprecated
- Se acumulan
--linkopt=<a string>
usos múltiples -
Es una opción adicional para pasar a gcc durante la vinculación.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--ltobackendopt=<a string>
usos múltiples -
Es una opción adicional para pasar al paso de backend de LTO (en --features=thin_lto).
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--ltoindexopt=<a string>
usos múltiples -
Es una opción adicional para pasar al paso de indexación LTO (en --features=thin_lto).
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--macos_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se compilan objetos binarios de Apple macOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Configuración predeterminada de
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima de macOS compatible para los objetivos. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
- Configuración predeterminada de
--memprof_profile=<a build target label>
: ver descripción -
Usar el perfil de memprof.
Etiquetas:affects_outputs
--[no]objc_debug_with_GLIBCXX
valor predeterminado: "false"-
Si estableces la política y el modo de compilación está configurado como "dbg", define GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC y GLIBCPP_CONCEPT_CHECKS.
Etiquetas:action_command_lines
--[no]objc_enable_binary_stripping
valor predeterminado: "false"-
Determina si se deben quitar símbolos y códigos muertos en objetos binarios vinculados. Si se especifican esta marca y --compilation_mode=opt, se realizarán eliminaciones binarias.
Etiquetas:action_command_lines
- Se acumulan
--objccopt=<a string>
usos múltiples -
Opciones adicionales para pasar a gcc cuando se compilan archivos fuente Objective-C/C++.
Etiquetas:action_command_lines
- Se acumulan
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
usos múltiples -
Opciones adicionales para pasar selectivamente a gcc cuando se compilan ciertos archivos. Esta opción se puede aprobar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter significa una lista de patrones de expresiones regulares de inclusión y exclusión (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 ir entre comillas con una barra inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos gcc de todos los archivos cc en //foo/, excepto bar.cc.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
usos múltiples -
Opciones adicionales para pasar de forma selectiva al backend de LTO (en --features=thin_lto) cuando se compilan ciertos objetos de backend. Esta opción se puede aprobar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter significa una lista de patrones de expresiones regulares de inclusión y exclusión, y option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe ir entre comillas con una barra inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos del backend de LTO de todos los archivos o en //foo/, excepto bar.o.
Etiquetas:action_command_lines
,affects_outputs
- Configuración predeterminada de
--platform_suffix=<a string>
: ver descripción -
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas:loses_incremental_state
,affects_outputs
,loading_and_analysis
- Configuración predeterminada de
--propeller_optimize=<a build target label>
: ver descripción -
Usa la información del perfil de Propeller para optimizar el objetivo de compilación.Un perfil de propulsor debe constar de al menos uno de dos archivos, un perfil cc y un perfil ld. Esta marca acepta una etiqueta de compilación que debe hacer referencia a los archivos de entrada del perfil de propulsor. Por ejemplo, el archivo BUILD que define la etiqueta La opción debe usarse de la siguiente manera: --propeller_optimize=//a/b:propeller_profile
Etiquetas:action_command_lines
,affects_outputs
- Configuración predeterminada de
--propeller_optimize_absolute_cc_profile=<a string>
: ver descripción -
Nombre de ruta de acceso absoluto del archivo cc_profile para compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
- Configuración predeterminada de
--propeller_optimize_absolute_ld_profile=<a string>
: ver descripción -
Nombre de ruta de acceso absoluto del archivo ld_profile para compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
- Configuración predeterminada de
--run_under=<a prefix in front of command>
: ver descripción -
Es el prefijo que se debe insertar antes de los ejecutables para los comandos “test” y “run”. Si el valor es “foo -bar”, y la línea de comandos de ejecución es “test_binary -baz”, la línea de comandos final es “foo -bar test_binary -baz”. También puede ser una etiqueta para un destino ejecutable. Estos son algunos ejemplos: 'valgrind', 'strace', 'strace -c', 'valgrind --quiet --num-callers=20', '//package:target', '//package:target --options'.
Etiquetas:action_command_lines
-
Si es "true", las bibliotecas nativas que contengan la misma funcionalidad se compartirán entre diferentes destinos
Etiquetas:loading_and_analysis
,affects_outputs
--[no]stamp
valor predeterminado: "false"-
Sella los objetos binarios con la fecha, el nombre de usuario, el nombre de host, la información del lugar de trabajo, etcétera.
Etiquetas:affects_outputs
- El valor predeterminado de
--strip=<always, sometimes or never>
es " a veces". -
Especifica si se quitan los objetos binarios y las bibliotecas compartidas (con "-Wl,--strip-debug"). El valor predeterminado de "algunas veces" significa quitar iff --compilation_mode=fastbuild.
Etiquetas:affects_outputs
- Se acumulan
--stripopt=<a string>
usos múltiples -
Opciones adicionales para quitar cuando se genera un objeto binario “<name>.stripped”.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--tvos_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se compilan objetos binarios de Apple tvOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Configuración predeterminada de
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima de tvOS compatible para simuladores de objetivo y dispositivos. Si no se especifica, se usa "tvos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan
--visionos_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se compilan objetos binarios de visionOS de Apple.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Se acumulan
--watchos_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se compilan objetos binarios de watchOS de Apple.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Configuración predeterminada de
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima de watchOS compatible para los simuladores y dispositivos de destino. Si no se especifica, se usa “watchos_sdk_version”.
Etiquetas:loses_incremental_state
- Configuración predeterminada de
--xbinary_fdo=<a build target label>
: ver 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 medida en la que Bazel aplica de manera estricta 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 entorno_group para asignarlo automáticamente a los valores de CPU a los valores target_environment.
Etiquetas:changes_inputs
,loading_and_analysis
,experimental
--[no]check_licenses
valor predeterminado: "false"-
Verifica que las restricciones de licencias impuestas por los paquetes dependientes no entren en conflicto con los modos de distribución de los destinos que se compilan. De forma predeterminada, las licencias no están marcadas.
Etiquetas:build_file_semantics
- El valor predeterminado de
--[no]check_visibility
es "true" (verdadero). - Si se inhabilita, los errores de visibilidad en las dependencias de destino descienden a advertencias.
Etiquetas:build_file_semantics
- El valor predeterminado de
--[no]desugar_for_android
es "true" (verdadero). -
Indica si se debe usar la expansión de sintaxis del código de bytes Java 8 antes de la conversión a DEX.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]desugar_java8_libs
valor predeterminado: "false"-
Determina si se deben incluir bibliotecas de Java 8 compatibles en apps para dispositivos heredados.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
yexperimental
- El valor predeterminado de
--[no]enforce_constraints
es "true" (verdadero). -
Verifica los entornos compatibles con cada destino y, luego, informa errores si algún destino tiene dependencias que no admiten los mismos entornos
Etiquetas:build_file_semantics
- El valor predeterminado de
--[no]experimental_check_desugar_deps
es "true" (verdadero). -
Indica si se debe verificar la expansión de sintaxis correcta a nivel binario de Android.
Etiquetas:eagerness_to_exit
,loading_and_analysis
,experimental
- Configuración predeterminada de
--experimental_import_deps_checking=<off, warning or error>
: "DESACTIVADA" -
Cuando se habilita, verifica si las dependencias de aar_import están completas. Esta aplicación puede dañar la compilación o simplemente generar advertencias.
Etiquetas:loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
valor predeterminado: "default"-
Si es verdadero, verifica que un destino de Java declare de forma explícita todos los destinos usados de forma directa como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files
valor predeterminado: "false"-
Si se habilita esta opción, verifica los objetivos de solo prueba de los requisitos previos que sean archivos de salida. Para ello, busca el solo de prueba de la regla de generación. Esto coincide con la verificación de visibilidad.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_check_visibility_for_toolchains
valor predeterminado: "false"-
Si se habilita, la verificación de visibilidad también se aplica a las implementaciones de las cadenas de herramientas.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_disable_native_android_rules
valor predeterminado: "false"-
Si se habilita, se inhabilita el uso directo de las reglas nativas de Android. Usa las reglas de Starlark para Android de https://github.com/bazelbuild/rules_android
Etiquetas:eagerness_to_exit
,incompatible_change
--[no]incompatible_disable_native_apple_binary_rule
valor predeterminado: "false"-
No-ops. Se conserva aquí para brindar retrocompatibilidad.
Etiquetas:eagerness_to_exit
,incompatible_change
- El valor predeterminado de
--[no]incompatible_python_disable_py2
es "true" (verdadero). -
Si es verdadero, usar la configuración de Python 2 generará un error. Esto incluye python_version=PY2, srcs_version=PY2 y srcs_version=PY2ONLY. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/15684.
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_validate_top_level_header_inclusions
es "true" (verdadero). -
Esta marca es una noop y se programó su eliminación.
Etiquetas:no_op
,incompatible_change
- Configuración predeterminada de
--python_native_rules_allowlist=<a build target label>
: ver descripción -
Una lista de entidades permitidas (objetivo de grupo de paquete) para usar cuando se aplique --incompatible_python_Disallow_native_rules.
Etiquetas:loading_and_analysis
--[no]strict_filesets
valor predeterminado: "false"- Si se habilita esta opción, los conjuntos de archivos que cruzan los límites de los paquetes se informan como errores.
Etiquetas:build_file_semantics
,eagerness_to_exit
- El valor predeterminado de
--strict_proto_deps=<off, warn, error, strict or default>
es "error" -
A menos que esté DESACTIVADO, verifica que un destino proto_library declare de forma explícita todos los destinos usados de forma directa como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
- El valor predeterminado de
--strict_public_imports=<off, warn, error, strict or default>
es "desactivado" -
A menos que esté DESACTIVADO, verifica que un destino proto_library declare de forma explícita todos los destinos usados en "import public" como exportados.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
--[no]strict_system_includes
valor 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
--target_environment=<a build target label>
usos múltiples -
Declara el entorno de destino de esta compilación. Debe ser una referencia de etiqueta a una regla de “entorno”. Si se especifica, todos los destinos 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 usa para firmar APKs
Etiquetas:action_command_lines
,affects_outputs
,loading_and_analysis
- El valor predeterminado de
--[no]device_debug_entitlements
es "true" (verdadero). -
Si se configura y el modo de compilación no es "opt", las apps de objc incluirán derechos de depuración durante la firma.
Etiquetas:changes_inputs
- Configuración predeterminada de
--ios_signing_cert_name=<a string>
: ver descripción -
Nombre del certificado que se usará para la firma de iOS. Si no la estableces, se recurrirá al perfil de aprovisionamiento. Puede ser la preferencia de identidad del llavero del certificado o (subcadena) del nombre común del certificado, según la página manual de la señal de código (SIGNING IDENTITIES).
Etiquetas:action_command_lines
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility
valor predeterminado: "false"-
Si es incompatible_enforce_config_setting_visibility=false, esta es una noop. De lo contrario, si la 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
- El valor predeterminado de
--[no]incompatible_disallow_legacy_py_provider
es "true" (verdadero). -
No-ops, se quitará pronto.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_sdk_frameworks_attributes
valor predeterminado: "false"-
Si el valor es "true", se inhabilitan los atributos sdk_frameworks y débil_sdk_frameworks en objc_library andobjc_import.
Etiquetas:build_file_semantics
,incompatible_change
- El valor predeterminado de
--[no]incompatible_enforce_config_setting_visibility
es "true" (verdadero). -
Si es verdadero, aplica restricciones de visibilidad config_setting. Si es falso, cada config_setting es visible para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_objc_alwayslink_by_default
valor predeterminado: "false"-
Si el valor predeterminado es "true", 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
valor 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 determinan el comportamiento del entorno de pruebas o del ejecutor de pruebas:
--[no]allow_analysis_failures
valor predeterminado: "false"-
Si es verdadero, una falla de análisis de un destino de regla provocará la propagación del objetivo de una instancia de AnalysisFailureInfo que contiene la descripción del error, en lugar de 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 mediante un atributo de regla con una transición de configuración for_analysis_testing. Si se supera ese límite, se mostrará un error de regla.
Etiquetas:loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure
valor predeterminado: "false"-
Si se producen errores reales en la acción de dex2oat, la compilación falla en lugar de ejecutar dex2oat durante el tiempo de ejecución de la prueba.
Etiquetas:loading_and_analysis
,experimental
- Se acumulan
--default_test_resources=<a resource name followed by equal and 1 float or 4 float, e.g memory=10,30,60,100>
usos múltiples - Anula la cantidad predeterminada de recursos para las pruebas. El formato esperado es <resource>=<value>. Si se especifica un solo número positivo como <value>, se anularán los recursos predeterminados para todos los tamaños de prueba. Si se especifican 4 números separados por comas, anularán la cantidad de recursos para los tamaños de prueba pequeños, medianos, grandes y, respectivamente. Los valores también pueden ser HOST_RAM/HOST_CPU, opcionalmente seguido de [-|*]<float> (p. ej., memoria=HOST_RAM*.1, HOST_RAM*.2, HOST_RAM*.3, HOST_RAM*.4). Los recursos de prueba predeterminados que especifica esta marca se anulan con los recursos explícitos especificados en las etiquetas.
--[no]experimental_android_use_parallel_dex2oat
valor predeterminado: "false"-
Usa dex2oat en paralelo para, quizás, acelerar android_test.
Etiquetas:loading_and_analysis
,host_machine_resource_optimizations
,experimental
--[no]ios_memleaks
valor predeterminado: "false"-
Habilita la comprobación de fugas de memoria en los destinos ios_test.
Etiquetas:action_command_lines
- Configuración predeterminada de
--ios_simulator_device=<a string>
: ver 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 que se ejecutará el simulador.
Etiquetas:test_runner
- Configuración predeterminada de
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Es la versión de iOS que se ejecutará en el simulador cuando se ejecute o realice pruebas. Esto se ignora para las reglas ios_test si se especifica un dispositivo de destino en la regla.
Etiquetas:test_runner
- Se acumulan
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
usos múltiples - Especifica la cantidad de veces que se debe ejecutar cada prueba. Si alguno de esos intentos falla por algún motivo, toda la prueba se considerará fallida. Normalmente, el valor especificado es solo un número entero. Ejemplo: --runs_per_test=3 ejecutará todas las pruebas 3 veces. Sintaxis alternativa: regex_filter@runs_per_test. Donde run_per_test significa un valor de número entero y regex_filter significa una lista de patrones de expresiones regulares de inclusión y exclusión (también consulta --instrumentation_filter). Ejemplo: --runs_per_test=//foo/.*,-//foo/bar/.*@3 ejecuta todas las pruebas en //foo/ excepto las que se encuentran en foo/bar tres veces. Esta opción se puede aprobar varias veces. El último argumento pasado que coincida tendrá prioridad. Si no hay coincidencia, la prueba se ejecuta solo una vez.
- Se acumulan
--test_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
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á desde el entorno del cliente de Bazel o mediante el par nombre=valor. Esta opción se puede usar varias veces para especificar distintas variables. Solo lo usa el comando “bazel test”.
Etiquetas:test_runner
--test_timeout=<a single integer or comma-separated list of 4 integers>
valor predeterminado: "-1"- Anula los valores predeterminados de tiempo de espera de la prueba (en segundos). Si se especifica un solo valor entero positivo, se anularán todas las categorías. Si se especifican 4 números enteros separados por comas, estos anularán los tiempos de espera: corto, moderado, largo y eterno (en ese orden). En cualquier forma, un valor de -1 le indica a blaze que use sus tiempos de espera predeterminados para esa categoría.
- El valor predeterminado de
--[no]zip_undeclared_test_outputs
es "true" (verdadero). -
Si es verdadero, los resultados de pruebas no declarados se archivarán en un archivo ZIP.
Etiquetas:test_runner
- Opciones relacionadas con el resultado y la semántica de la consulta:
- El valor predeterminado de
--aspect_deps=<off, conservative or precise>
es "conservador". -
Cómo resolver dependencias de aspecto cuando el formato de salida es {xml,proto,record}. “desactivado” significa que no se resuelven las dependencias de aspecto, “conservadora” (el valor predeterminado) significa que se agregan todas las dependencias de aspecto declaradas sin importar si se les otorga la clase de regla de las dependencias directas. “preciso” significa que solo se agregan esos aspectos que posiblemente estén activos dada la clase de regla de las dependencias directas. Ten en cuenta que el modo preciso requiere cargar otros paquetes para evaluar un solo objetivo, por lo que es más lento que los otros modos. Además, ten en cuenta que incluso el modo preciso no es del todo preciso: la decisión de calcular un aspecto se decide en la fase de análisis, que no se ejecuta durante la “consulta de Bazel”.
Etiquetas:build_file_semantics
--[no]consistent_labels
valor predeterminado: "false"-
Si se habilita, cada comando de consulta emite etiquetas como si lo hiciera la función <code>str</code> de Starlark aplicada a una instancia de <code>etiqueta</code>. Esto es útil para las herramientas que necesitan hacer coincidir el resultado de diferentes comandos de consulta o etiquetas emitidas por reglas. Si no están habilitados, los formateadores de salida tienen la libertad de emitir nombres de repositorio aparentes (en relación con el repositorio principal) para que los resultados sean más legibles.
Etiquetas:terminal_output
--[no]experimental_explicit_aspects
valor predeterminado: "false"-
aquery, cquery: si se deben incluir acciones generadas por el aspecto en el resultado. query: no-op (siempre se siguen los aspectos).
Etiquetas:terminal_output
- El valor predeterminado de
--[no]graph:factored
es "true" (verdadero). -
Si es "true", el gráfico se emitirá "factorizado", es decir, los nodos equivalentes topológicamente se combinarán y sus etiquetas se concatenarán. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--graph:node_limit=<an integer>
predeterminado: "512"-
La longitud máxima de la string de etiqueta para un nodo del gráfico en el resultado. Las etiquetas más largas se truncarán; -1 significa que no hay truncamiento. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]implicit_deps
es "true" (verdadero). -
Si se habilita, las dependencias implícitas se incluirán en el gráfico de dependencias en el que opera la consulta. Una dependencia implícita es aquella que no se especifica de forma explícita en el archivo BUILD, sino que Bazel la agrega. En el caso de cquery, esta opción controla el filtrado de cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
- El valor predeterminado de
--[no]include_aspects
es "true" (verdadero). -
aquery, cquery: si se deben incluir acciones generadas por el aspecto en el resultado. query: no-op (siempre se siguen los aspectos).
Etiquetas:terminal_output
- El valor predeterminado de
--[no]incompatible_package_group_includes_double_slash
es "true" (verdadero). -
Si se habilita, cuando se genere el atributo `packages` de package_group, no se omitirá el signo `//` inicial.
Etiquetas:terminal_output
,incompatible_change
--[no]infer_universe_scope
valor predeterminado: "false"-
Si se configura y --universe_scope no se establece, se inferirá un valor de --universe_scope como la lista de patrones de objetivo únicos en la expresión de consulta. Ten en cuenta que el valor de --universe_scope que se infiere para una expresión de consulta que utiliza funciones con alcance universal (p.ej., `allrdeps`) puede no ser lo que quieres, por lo que solo debes usar esta opción si sabes lo que estás haciendo. Consulta https://bazel.build/reference/query#sky-query para obtener detalles y ejemplos. Si se configura --universe_scope, se ignora el valor de esta opción. Nota: Esta opción solo se aplica a “consulta” (es decir, no a “cquery”).
Etiquetas:loading_and_analysis
--[no]line_terminator_null
valor predeterminado: "false"-
Indica si cada formato termina con \0 en lugar de una línea nueva.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]nodep_deps
es "true" (verdadero). -
Si se habilita, las dependencias de los atributos “nodep” se incluirán en el gráfico de dependencias en el que opera la consulta. Un ejemplo común de un atributo “nodep” es la “visibilidad”. Ejecuta y analiza el resultado de `info build-language` para conocer todos los atributos “nodep” en el lenguaje de compilación.
Etiquetas:build_file_semantics
--output=<a string>
, valor predeterminado: “label”-
El formato en el que se deben imprimir los resultados de cquery. Los valores permitidos para cquery son los siguientes: label, label_kind, textproto, transiciones, proto, streaming_proto, jsonproto. Si seleccionas "transitions", también debes especificar la opción --transitions=(lite|full).
Etiquetas:terminal_output
- El valor predeterminado de
--[no]proto:default_values
es "true" (verdadero). -
Si el valor es "true", 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
valor predeterminado: "false"-
Propaga el campo proto define_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
- El valor predeterminado de
--[no]proto:flatten_selects
es "true" (verdadero). -
Si se habilita, se compactan los atributos configurables creados por select(). Para los tipos de lista, la representación plana es una lista que contiene cada valor del mapa de selección exactamente una vez. Los tipos escalares se acoplan a nulos.
Etiquetas:build_file_semantics
--[no]proto:include_attribute_source_aspects
valor predeterminado: "false"-
Propaga el campo proto source_aspect_name de cada Atributo con el aspecto de origen del que provino (si no lo hizo, una cadena vacía).
Etiquetas:terminal_output
- El valor predeterminado de
--[no]proto:include_configurations
es "true" (verdadero).
Si se habilita - , el resultado de proto incluirá información sobre los parámetros de configuración. Cuando se inhabilita,el formato de salida de cquery proto se asemeja al formato de resultados de la consulta.
Etiquetas:affects_outputs
--[no]proto:include_synthetic_attribute_hash
valor predeterminado: "false"-
Indica si se debe calcular y propagar el atributo $internal_attr_hash o no.
Etiquetas:terminal_output
--[no]proto:instantiation_stack
valor 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
- El valor predeterminado de
--[no]proto:locations
es "true" (verdadero). - Indica si se debe generar información de ubicación en el resultado de proto.
Etiquetas:terminal_output
- La configuración predeterminada de
--proto:output_rule_attrs=<comma-separated list of options>
es "todos" -
Lista de atributos separados por comas para incluir en el resultado. La configuración predeterminada es todos los atributos. Se establece como una cadena vacía para no generar ningún atributo. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]proto:rule_inputs_and_outputs
es "true" (verdadero). -
Indica si se deben propagar los campos rule_input y rule_output o no.
Etiquetas:terminal_output
--query_file=<a string>
predeterminado: ""-
Si se configura, la consulta leerá la consulta desde el archivo que se menciona aquí, en lugar de hacerlo desde la línea de comandos. Es un error especificar un archivo aquí, así como una consulta de línea de comandos.
Etiquetas:changes_inputs
--[no]relative_locations
valor predeterminado: "false"-
Si es "true", la ubicación de los archivos BUILD en los resultados xml y proto será relativa. De forma predeterminada, el resultado de la ubicación es una ruta de acceso absoluta y no será coherente en todas las máquinas. Puedes configurar esta opción como verdadera para obtener un resultado coherente en todas las máquinas.
Etiquetas:terminal_output
- El valor predeterminado de
--show_config_fragments=<off, direct or transitive>
es "desactivado" -
Muestra los fragmentos de configuración que requiere una regla y sus dependencias transitivas. Esto puede ser útil para evaluar cuánto se puede recortar un gráfico de destino configurado.
Etiquetas:affects_outputs
--starlark:expr=<a string>
predeterminado: ""-
Una expresión de Starlark para dar formato a cada destino configurado en el modo --output=starlark de cquery. El destino configurado está vinculado al “objetivo”. Si no se especifica --starlark:expr ni --starlark:file, esta opción se establecerá de forma predeterminada como “str(target.label)”. Es un error especificar --starlark:expr y --starlark:file.
Etiquetas:terminal_output
--starlark:file=<a string>
predeterminado: ""-
Es el nombre de un archivo que define una función de Starlark llamada "formato" de un argumento que se aplica a cada destino configurado para darle formato como una cadena. Es un error especificar --starlark:expr y --starlark:file. Consulta la ayuda de --output=starlark para obtener más detalles.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]tool_deps
es "true" (verdadero). -
Consulta: Si se inhabilita, las dependencias de la "configuración de ejecución" no se incluirán en el gráfico de dependencias en el que opera la consulta. Un perímetro de dependencia de 'ejecución de configuración', como el de cualquier regla 'proto_library' al compilador de protocolos, generalmente apunta a una herramienta ejecutada durante la compilación en lugar de a una parte del mismo programa 'target'.
Cquery: Si se inhabilita, filtra todos los destinos configurados que cruzan una transición de ejecución del objetivo de nivel superior que descubrió este objetivo configurado. Esto significa que si el objetivo de nivel superior está en la configuración de destino, solo se mostrarán los objetivos configurados también en esa configuración. Si el objetivo de nivel superior está en la configuración de ejecución, solo se mostrarán los objetivos configurados de ejecución. Esta opción NO excluirá las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
- La configuración predeterminada de
--transitions=<full, lite or none>
es “ninguna” -
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: ""-
Un conjunto de patrones de objetivo separados por comas (aditivos y sustractivos). 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.
Para cquery, la entrada a esta opción son los destinos en los que se compilan todas las respuestas, por lo que esta opción puede afectar las configuraciones y las transiciones. Si no se especifica esta opción, se supone que los destinos de nivel superior son los destinos analizados a partir de la expresión de consulta. Nota: En el caso de cquery, no especificar esta opción puede provocar que la compilación falle si los objetivos analizados a partir de la expresión de consulta no se pueden compilar con opciones de nivel superior.
Etiquetas:loading_and_analysis
- Opciones relacionadas con la semántica y el resultado de Bzlmod:
--[no]configure
valor predeterminado: "false"-
Solo recupera los repositorios marcados como “configurar” para fines de configuración del sistema. Solo funciona cuando --enable_bzlmod está activado.
Etiquetas:changes_inputs
--[no]force
valor predeterminado: "false"-
Ignora el repositorio existente, si lo hay, y vuelve a forzar la recuperación del repositorio. Solo funciona cuando --enable_bzlmod está activado.
Etiquetas:changes_inputs
- Se acumulan
--repo=<a string>
usos múltiples -
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
- Opciones que activan optimizaciones del tiempo de compilación:
--[no]experimental_filter_library_jar_with_program_jar
valor predeterminado: "false"-
Filtra ProgramJar de ProGuard para quitar cualquier clase que también esté presente en LibraryJar.
Etiquetas:action_command_lines
- El valor predeterminado de
--[no]experimental_inmemory_dotd_files
es "true" (verdadero). -
Si se habilita, los archivos .d de C++ se pasarán directamente en la memoria desde los nodos de compilación remota, en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
yexperimental
- El valor predeterminado de
--[no]experimental_inmemory_jdeps_files
es "true" (verdadero). -
Si se habilita esta opción, los archivos de dependencia (.jdeps) generados a partir de compilaciones de Java se pasarán directamente a la memoria desde los nodos de compilación remota, en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
yexperimental
--[no]experimental_retain_test_configuration_across_testonly
valor predeterminado: "false"-
Cuando se habilita, --trim_test_configuration no recortará la configuración de prueba de las reglas marcadas como testonly=1. Esto tiene como objetivo reducir los problemas de conflicto de acciones cuando las reglas que no son de prueba dependen de las reglas cc_test. No tiene efecto si --trim_test_configuration es falso.
Etiquetas:loading_and_analysis
,loses_incremental_state
--[no]experimental_starlark_cc_import
valor predeterminado: "false"-
Si se habilita, se puede usar la versión de cc_import de Starlark.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_unsupported_and_brittle_include_scanning
valor predeterminado: "false"-
Determina si se deben reducir las entradas a la compilación de C/C++ analizando #include líneas de los archivos de entrada. Esto puede mejorar el rendimiento y la incrementalidad disminuyendo el tamaño de los árboles de entrada de la compilación. Sin embargo, también puede romper compilaciones porque el escáner de inclusión no implementa por completo la semántica del preprocesador de C. En particular, no comprende las directivas #include dinámicas e ignora la lógica condicional del preprocesador. Úsala bajo tu propia responsabilidad. Se cerrarán todos los problemas relacionados con esta marca que se presenten.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
- El valor predeterminado de
--[no]incremental_dexing
es "true" (verdadero). -
Realiza la mayor parte del trabajo para la conversión a DEX por separado para cada archivo Jar.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- El valor predeterminado de
--[no]objc_use_dotd_pruning
es "true" (verdadero). -
Si se configura, se usarán los archivos .d emitidos por Clang para reducir el conjunto de entradas que se pasaron a compilaciones de objc.
Etiquetas:changes_inputs
,loading_and_analysis
--[no]process_headers_in_dependencies
valor 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
- El valor predeterminado de
--[no]trim_test_configuration
es "true" (verdadero). -
Cuando se habilita, las opciones relacionadas con pruebas se borrarán en el nivel superior de la compilación. Cuando esta marca está activa, las pruebas no se pueden compilar como dependencias de reglas que no sean de prueba, pero los cambios en las opciones relacionadas con pruebas no provocarán que las reglas que no son de prueba se vuelvan a analizar.
Etiquetas:loading_and_analysis
,loses_incremental_state
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
predeterminado: "-.*"-
Imprime información de depuración durante la resolución de la cadena de herramientas. La marca toma una regex, que se compara con tipos de cadenas de herramientas y objetivos específicos para ver cuál depurar. Varias regex se pueden separar por comas y, luego, cada regex se verifica por separado. Nota: El resultado de esta marca es muy complejo y probablemente solo sea útil para los expertos en la resolución de la cadena de herramientas.
Etiquetas:terminal_output
- Opciones que especifican o modifican una entrada genérica a un comando de Bazel que no se incluye en otras categorías:
- Se acumulan
--flag_alias=<a 'name=value' flag alias>
usos múltiples - Establece un nombre abreviado para una marca de Starlark. Toma un solo par clave-valor con el formato "<key>=<value>" como argumento.
Etiquetas:changes_inputs
--[no]incompatible_default_to_explicit_init_py
valor 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. De manera precisa, cuando un destino py_binary o py_test tiene legacy_create_init configurado como "auto" (predeterminado), se trata como falso si y solo si esta marca está configurada. Consulta https://github.com/bazelbuild/bazel/issues/10076.
Etiquetas:affects_outputs
,incompatible_change
- El valor predeterminado de
--[no]incompatible_py2_outputs_are_suffixed
es "true" (verdadero). -
Si es verdadero, los destinos compilados en la configuración de Python 2 aparecerán bajo 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 los 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
- El valor predeterminado de
--[no]incompatible_py3_is_default
es "true" (verdadero). -
Si el valor es true, los destinos `py_binary` y `py_test` que no establecen su atributo `python_version` (o `default_python_version`) se establecerán de forma predeterminada como PY3 en lugar de PY2. Si estableces esta marca, también se recomienda configurar `--incompatible_py2_outputs_are_sufsolution`.
Etiquetas:loading_and_analysis
,affects_outputs
,incompatible_change
- El valor predeterminado de
--[no]incompatible_use_python_toolchains
es "true" (verdadero). -
Si se configura como verdadera, las reglas nativas ejecutables de Python usarán el entorno de ejecución de Python especificado por la cadena de herramientas de Python, en lugar del entorno de ejecución proporcionado por marcas heredadas como --python_top.
Etiquetas:loading_and_analysis
,incompatible_change
- Configuración predeterminada de
--python_version=<PY2 or PY3>
: ver descripción -
Es el modo de versión principal de Python, que puede ser “PY2” o “PY3”. Ten en cuenta que los objetivos “py_binary” y “py_test” anulan esto (incluso si no especifican explícitamente una versión), por lo que, por lo general, no hay muchas razones para proporcionar esta marca.
Etiquetas:loading_and_analysis
,affects_outputs
- Opciones varias, que no están categorizadas:
--[no]cache_test_results
[-t
] predeterminado: "auto"- Si se configura como "auto", Bazel vuelve a ejecutar una prueba solo si (1) Bazel detecta cambios en la prueba o sus dependencias, (2) la prueba se marca como externa, (3) se solicitaron varias ejecuciones de prueba con --runs_per_test o(4) si la prueba falló anteriormente. Si se configura como “sí”, Bazel almacena en caché todos los resultados de la prueba, excepto las que se marcaron como externas. Si se configura como “no”, Bazel no almacena en caché ningún resultado de prueba.
- Se acumulan
--deleted_packages=<comma-separated list of package names>
usos múltiples - Una lista separada por comas de los nombres de los paquetes que el sistema de compilación considerará que no existen, incluso si están visibles en algún lugar de la ruta del paquete. Usa esta opción cuando borres un subpaquete 'x/y' de un paquete 'x' existente. Por ejemplo, después de borrar x/y/BUILD en el cliente, el sistema de compilación puede presentar un reclamo si encuentra la etiqueta '//x:y/z' si todavía la proporciona otra entrada package_path. Si especificas --deleted_packages x/y se evita este problema.
--[no]experimental_cancel_concurrent_tests
valor predeterminado: "false"-
Si es "true", el Blaze cancelará las pruebas que se ejecutan de forma simultánea en la primera ejecución exitosa. Esto solo es útil en combinación con --runs_per_test_detects_flakes.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_fetch_all_coverage_outputs
valor 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
valor predeterminado: "false"-
Si es "true", la cobertura de Clang generará un informe de LCOV.
Etiquetas:affects_outputs
,loading_and_analysis
- El valor predeterminado de
--[no]experimental_j2objc_header_map
es "true" (verdadero). - Indica si se debe generar el mapa de encabezados de J2ObjC en paralelo de la transpilación de J2ObjC.
--[no]experimental_j2objc_shorter_header_path
valor predeterminado: "false"-
Indica si se debe generar con una ruta de encabezado más corta (usa "_ios" en lugar de "_j2objc").
Etiquetas:affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
predeterminado: "javabuilder"- Habilita rutas de clase reducidas para compilaciones de Java.
--[no]experimental_limit_android_lint_to_android_constrained_java
valor predeterminado: "false"- Limita --experimental_run_android_lint_on_java_rules a bibliotecas compatibles con Android.
Etiquetas:affects_outputs
--[no]experimental_run_android_lint_on_java_rules
valor predeterminado: "false"- Determina si se deben validar las fuentes java_*.
Etiquetas:affects_outputs
--[no]explicit_java_test_deps
valor predeterminado: "false"- Especifica de forma explícita una dependencia a JUnit o Hamcrest en una java_test, en lugar de obtenerla accidentalmente desde las dependencias de TestRunner. Por el momento, solo funciona para Bazel.
- El valor predeterminado de
--[no]fetch
es "true" (verdadero). - Permite que el comando recupere dependencias externas. Si se establece como falsa, el comando usará cualquier versión almacenada en caché de la dependencia. Si no existe ninguna, el comando fallará.
- Configuración predeterminada de
--host_java_launcher=<a build target label>
: ver descripción - El Selector de Java utilizado por las herramientas que se ejecutan durante una compilación.
- Se acumulan
--host_javacopt=<a string>
usos múltiples - Son opciones adicionales para pasar a javac cuando se compilan herramientas que se ejecutan durante una compilación.
- Se acumulan
--host_jvmopt=<a string>
usos múltiples - Opciones adicionales para pasar a la VM de Java cuando se compilan herramientas que se ejecutan durante la compilación. Estas opciones se agregarán a las opciones de inicio de la VM de cada destino java_binary.
- El valor predeterminado de
--[no]incompatible_check_sharding_support
es "true" (verdadero). -
Si es verdadero, Bazel fallará una prueba fragmentada si el ejecutor de pruebas no indica que admite la fragmentación tocando el archivo en la ruta de acceso en TEST_SHARD_STATUS_FILE. Si es falso, un ejecutor de pruebas que no admita la fragmentación hará que se ejecuten todas las pruebas en cada fragmento.
Etiquetas:incompatible_change
- El valor predeterminado de
--[no]incompatible_exclusive_test_sandboxed
es "true" (verdadero). -
Si es verdadero, se ejecutarán pruebas exclusivas con la estrategia de zona de pruebas. Agrega la etiqueta “local” para forzar una ejecución de prueba exclusiva de forma local.
Etiquetas:incompatible_change
--[no]incompatible_strict_action_env
valor predeterminado: "false"-
Si es verdadero, Bazel usa un entorno con un valor estático para PATH y no hereda LD_LIBRARY_PATH. Usa --action_env=ENV_VARIABLE si deseas heredar variables de entorno específicas del cliente, pero ten en cuenta que esto puede evitar el almacenamiento en caché entre usuarios si se usa una caché compartida.
Etiquetas:loading_and_analysis
,incompatible_change
- Se acumulan
--j2objc_translation_flags=<comma-separated list of options>
usos múltiples - Opciones adicionales para pasar a la herramienta J2ObjC.
--java_debug
-
Hace que la máquina virtual Java de una prueba de Java espere una conexión de un depurador compatible con JDWP (como jdb) antes de comenzar la prueba. Insinúa -test_output=streamed.
Se expande a:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
- El valor predeterminado de
--[no]java_deps
es "true" (verdadero). - Genera información de dependencias (por ahora, la ruta de clase en tiempo de compilación) por destino de Java.
- El valor predeterminado de
--[no]java_header_compilation
es "true" (verdadero). - Compila ijars directamente desde la fuente.
--java_language_version=<a string>
predeterminado: ""- La versión del lenguaje Java
- Configuración predeterminada de
--java_launcher=<a build target label>
: ver descripción - El Selector de Java que se usa cuando se compilan objetos binarios de Java. Si esta marca se establece en una cadena vacía, se usa el selector de JDK. El atributo "launcher" anula esta marca.
--java_runtime_version=<a string>
valor predeterminado: "local_jdk"- La versión del entorno de ejecución de Java
- Se acumulan
--javacopt=<a string>
usos múltiples - Opciones adicionales para pasar a javac.
- Se acumulan
--jvmopt=<a string>
usos múltiples - Opciones adicionales para pasar a la VM de Java. Estas opciones se agregarán a las opciones de inicio de la VM de cada destino java_binary.
- Configuración predeterminada de
--legacy_main_dex_list_generator=<a build target label>
: ver descripción - Especifica un objeto binario que se usará para generar la lista de clases que deben estar en el DEX principal cuando se compila multidex heredado.
- Configuración predeterminada de
--optimizing_dexer=<a build target label>
: ver descripción - Especifica un objeto binario que se usará para realizar la conversión a DEX sin fragmentar.
--package_path=<colon-separated list of options>
predeterminado: "%workspace%"- Una lista separada por dos puntos sobre dónde buscar paquetes. Los elementos que comienzan con "%workspace%" son relativos al lugar de trabajo que lo contiene. Si se omite o está vacío, el valor predeterminado es el resultado de “bazel info default-package-path”.
- Se acumulan
--plugin=<a build target label>
usos múltiples - Complementos para usar en la compilación. Actualmente, funciona con java_plugin.
- Configuración predeterminada de
--proguard_top=<a build target label>
: ver descripción - Especifica qué versión de ProGuard se usará para quitar código cuando se compile un objeto binario de Java.
--proto_compiler=<a build target label>
predeterminado: "@bazel_tools//tools/proto:protoc"-
Es la etiqueta del compilador de protocolos.
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 j2objc
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
valor 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>
valor 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
--protocopt=<a string>
usos múltiples -
Son opciones adicionales para pasar al compilador de protobuf.
Etiquetas:affects_outputs
--[no]runs_per_test_detects_flakes
valor predeterminado: "false"- Si es verdadero, cualquier fragmento en el que al menos una ejecución o un intento se complete y al menos uno falle tenga un estado FLAKY.
- Configuración predeterminada de
--shell_executable=<a path>
: ver descripción -
Ruta de acceso absoluta al shell ejecutable para que lo use Bazel. Si no se configura, pero la variable de entorno BAZEL_SH está configurada en la primera invocación de Bazel (que inicia un servidor de Bazel), Bazel la usa. Si no se establece ninguno, Bazel usa una ruta de acceso predeterminada hard-coded 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 el uso de una shell que no es compatible con Bash puede provocar fallas de compilación o de tiempo de ejecución de los objetos binarios generados.
Etiquetas:loading_and_analysis
- El valor predeterminado de
--[no]show_loading_progress
es "true" (verdadero). - Si se habilita, hace que Bazel imprima mensajes "Cargando paquete:".
- Se acumulan
--test_arg=<a string>
usos múltiples - 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 recibirá argumentos idénticos. Solo lo usa el comando “bazel test”.
- Configuración predeterminada de
--test_filter=<a string>
: ver descripción - Especifica un filtro para reenviar al framework de pruebas. Se usa para limitar la ejecución de pruebas. Ten en cuenta que esto no afecta los destinos que se compilan.
--test_result_expiration=<an integer>
valor predeterminado: "-1"- Esta opción dejó de estar disponible y no tiene efecto.
--[no]test_runner_fail_fast
valor predeterminado: "false"- Reenvía la opción de falla rápida al ejecutor de pruebas. El ejecutor de pruebas debe detener la ejecución en la primera falla.
- Valor predeterminado de
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>
: "explícito" - Especifica una estrategia para la fragmentación de pruebas: "explícito" para usar solo la fragmentación si está presente el atributo de COMPILACIÓN "shard_count". “inhabilitado” para no usar nunca la fragmentación de pruebas. "forced=k" permite aplicar "k" fragmentos para las pruebas, sin importar el atributo de BUILD "shard_count".
--tool_java_language_version=<a string>
predeterminado: ""- La versión del lenguaje Java que se usa para ejecutar las herramientas que se necesitan 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
- El valor predeterminado de
--[no]use_ijars
es "true" (verdadero). - Si se habilita, esta opción hace que la compilación de Java use archivos jar de la interfaz. Esto dará como resultado una compilación incremental más rápida, pero los mensajes de error pueden ser diferentes.
Opciones de ayuda
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Más lugares donde buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
valor predeterminado: "false"-
Si se configura, la caché del repositorio vinculará el archivo de forma fija en caso de un acierto de caché, en lugar de copiar. Esto sirve para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Usa este factor para escalar todos los tiempos de espera en las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que sean 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 para descargas de http.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--http_connector_retry_max_timeout=<An immutable length of time.>
: "0 s" -
Es el tiempo de espera máximo para los reintentos de descarga de HTTP. Con el valor 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 descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación en caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché; de lo contrario, se usa el valor predeterminado “<output_user_root>/cache/repos/v1”
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
valor predeterminado: "false"-
Si se establece esta configuración, no se permitirá la descarga con ="{.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no está completamente deshabilitado; ="{.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"-
Indica el porcentaje de espacio ocupado (0-100) por encima del cual GcThrashingDetector considera los eventos de presión de la memoria en función de sus límites (--gc_thrashing_limits). Si se configura en 100, GcThrashingDetector se inhabilita.
Etiquetas:host_machine_resource_optimizations
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE.:
- El valor predeterminado de
--[no]incompatible_depset_for_java_output_source_jars
es "true" (verdadero). -
No-ops
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_new_actions_api
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,incompatible_change
- El valor predeterminado de
--[no]incompatible_visibility_private_attributes_at_definition
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,incompatible_change
- El valor predeterminado de
--[no]separate_aspect_deps
es "true" (verdadero). -
No-op
Etiquetas:no_op
- Opciones relacionadas con la semántica y el resultado de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Especificaste las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirá en el gráfico de dependencias resueltas incluso si se declararon de forma privada en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones anteriores harán que la resolución falle. También puedes definir la versión transferida 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
- El valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
es "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 una falla de resolución, “off” para inhabilitar la verificación o “warning” para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas `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 detecte una discrepancia o “error” para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
valor predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
valor predeterminado: "actualizar"-
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son “update” para usar el archivo de bloqueo y actualizarlo si hay cambios; “error” para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o “off” para no leerlo ni escribirlo en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y se recurrirá únicamente a los posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Configuración predeterminada de
--vendor_dir=<a path>
: ver descripción -
Especifica el directorio que debe contener los repositorios externos en modo de proveedor, ya sea con el fin de recuperarlos o usarlos durante la compilación. La ruta de acceso se puede especificar como una ruta de acceso absoluta o una ruta relativa al directorio del lugar de trabajo.
Etiquetas:loading_and_analysis
- 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 fallar Bazel con un OOM. Cada límite se especifica como <period>:<count>, donde el período es una duración y el recuento es un número entero positivo. Si más del --gc_thrashing_threshold por ciento del espacio titular (montón de generación anterior) permanece ocupado después de <count> GC completas consecutivas dentro de <period>, se activa una 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"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje de montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC completo, descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos de GC completos nunca activarán disminuciones. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de recolección de elementos no utilizados completo y se supere el umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje de montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC menor, descartará el estado temporal innecesario de Skyframe, hasta esta cantidad por invocación. El valor predeterminado es Integer.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos menores de GC nunca activarán disminuciones. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento menor de recolección de elementos no utilizados y se supere el umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje retenido de montón está al menos en este umbral, descartará el estado temporal innecesario de Skyframe. Un ajuste puede permitirte mitigar el impacto de la hiperpaginación de la GC en el tiempo, cuando esta (i) causa el uso de memoria de este estado temporal y (ii) es más costosa que reconstruir el estado cuando es necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Configuración predeterminada de
--experimental_command_profile=<cpu, wall, alloc or lock>
: ver descripción - Registra un perfil de grabadora de vuelo de Java mientras dure el comando. Se debe proporcionar uno de los tipos de eventos de generación de perfiles admitidos (cpu, muro, alloc o bloqueo) como argumento. El perfil se escribe en un archivo con el nombre del tipo de evento en el directorio base de salida. La sintaxis y semántica de esta marca podría cambiar en el futuro para admitir tipos de perfil o formatos de salida adicionales; úsala bajo tu responsabilidad.
--[no]experimental_record_metrics_for_all_mnemonics
valor predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán estadísticas para todos los mnemotécnicos.
- Valor predeterminado de
--help_verbosity=<long, medium or short>
: "media" -
Selecciona el nivel de verbosidad del comando de ayuda.
Etiquetas:terminal_output
--long
[-l
]-
Muestra la descripción completa de cada opción, en lugar de solo el nombre.
Se expande a:
--help_verbosity=long
Etiquetas:terminal_output
--short
-
Muestra solo los nombres de las opciones, no sus tipos o significados.
Se expande a:
--help_verbosity=short
Etiquetas:terminal_output
- Opciones que especifican o modifican una entrada genérica para 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é remoto:
- Configuración predeterminada de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo para configurar el cargador 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 con el que debe coincidir y otro para usar como URL sustitutiva, con referencias inversas que comienzan con "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL, y se mostrarán varias URL.
- Valor predeterminado de
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "auto" - Es el modo de subprocesos que se usará para la recuperación del repositorio. Si se configura en “off”, no se usa ningún subproceso de trabajo y la recuperación del repositorio está sujeta a reinicios. De lo contrario, utiliza un subproceso de plataforma (es decir, subproceso del SO) si se configura como “platform” o un subproceso virtual si se establece como “virtual”. Si se configura como "auto", se usan subprocesos virtuales si están disponibles (es decir, se ejecutan en JDK 21 y versiones posteriores); de lo contrario, no se usan subprocesos de trabajo.
- Opciones varias, que no están categorizadas:
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada 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
--distdir=<a path>
usos múltiples -
Más lugares donde buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
valor predeterminado: "false"-
Si se configura, la caché del repositorio vinculará el archivo de forma fija en caso de un acierto de caché, en lugar de copiar. Esto sirve para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Usa este factor para escalar todos los tiempos de espera en las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que sean 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 para descargas de http.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--http_connector_retry_max_timeout=<An immutable length of time.>
: "0 s" -
Es el tiempo de espera máximo para los reintentos de descarga de HTTP. Con el valor 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 descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación en caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché; de lo contrario, se usa el valor predeterminado “<output_user_root>/cache/repos/v1”
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
valor predeterminado: "false"-
Si se establece esta configuración, no se permitirá la descarga con ="{.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no está completamente deshabilitado; ="{.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"-
Indica el porcentaje de espacio ocupado (0-100) por encima del cual GcThrashingDetector considera los eventos de presión de la memoria en función de sus límites (--gc_thrashing_limits). Si se configura en 100, GcThrashingDetector se inhabilita.
Etiquetas:host_machine_resource_optimizations
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE.:
- El valor predeterminado de
--[no]incompatible_depset_for_java_output_source_jars
es "true" (verdadero). -
No-ops
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_new_actions_api
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,incompatible_change
- El valor predeterminado de
--[no]incompatible_visibility_private_attributes_at_definition
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,incompatible_change
- El valor predeterminado de
--[no]separate_aspect_deps
es "true" (verdadero). -
No-op
Etiquetas:no_op
- Opciones relacionadas con la semántica y el resultado de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Especificaste las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirá en el gráfico de dependencias resueltas incluso si se declararon de forma privada en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones anteriores harán que la resolución falle. También puedes definir la versión transferida 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
- El valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
es "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 una falla de resolución, “off” para inhabilitar la verificación o “warning” para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas `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 detecte una discrepancia o “error” para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
valor predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
valor predeterminado: "actualizar"-
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son “update” para usar el archivo de bloqueo y actualizarlo si hay cambios; “error” para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o “off” para no leerlo ni escribirlo en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y se recurrirá únicamente a los posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Configuración predeterminada de
--vendor_dir=<a path>
: ver descripción -
Especifica el directorio que debe contener los repositorios externos en modo de proveedor, ya sea con el fin de recuperarlos o usarlos durante la compilación. La ruta de acceso se puede especificar como una ruta de acceso absoluta o una ruta relativa al directorio del lugar de trabajo.
Etiquetas:loading_and_analysis
- 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 fallar Bazel con un OOM. Cada límite se especifica como <period>:<count>, donde el período es una duración y el recuento es un número entero positivo. Si más del --gc_thrashing_threshold por ciento del espacio titular (montón de generación anterior) permanece ocupado después de <count> GC completas consecutivas dentro de <period>, se activa una 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"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje de montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC completo, descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos de GC completos nunca activarán disminuciones. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de recolección de elementos no utilizados completo y se supere el umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje de montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC menor, descartará el estado temporal innecesario de Skyframe, hasta esta cantidad por invocación. El valor predeterminado es Integer.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos menores de GC nunca activarán disminuciones. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento menor de recolección de elementos no utilizados y se supere el umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje retenido de montón está al menos en este umbral, descartará el estado temporal innecesario de Skyframe. Un ajuste puede permitirte mitigar el impacto de la hiperpaginación de la GC en el tiempo, cuando esta (i) causa el uso de memoria de este estado temporal y (ii) es más costosa que reconstruir el estado cuando es necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Configuración predeterminada de
--experimental_command_profile=<cpu, wall, alloc or lock>
: ver descripción - Registra un perfil de grabadora de vuelo de Java mientras dure el comando. Se debe proporcionar uno de los tipos de eventos de generación de perfiles admitidos (cpu, muro, alloc o bloqueo) como argumento. El perfil se escribe en un archivo con el nombre del tipo de evento en el directorio base de salida. La sintaxis y semántica de esta marca podría cambiar en el futuro para admitir tipos de perfil o formatos de salida adicionales; úsala bajo tu responsabilidad.
--[no]experimental_record_metrics_for_all_mnemonics
valor predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán estadísticas para todos los mnemotécnicos.
--[no]show_make_env
valor predeterminado: "false"-
Incluye el entorno “Make” en el resultado.
Etiquetas:affects_outputs
,terminal_output
- Opciones que especifican o modifican una entrada genérica para un comando de Bazel que no se incluye en otras categorías:
--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é remoto:
- Configuración predeterminada de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo para configurar el cargador 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 con el que debe coincidir y otro para usar como URL sustitutiva, con referencias inversas que comienzan con "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL, y se mostrarán varias URL.
- Valor predeterminado de
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "auto" - Es el modo de subprocesos que se usará para la recuperación del repositorio. Si se configura en “off”, no se usa ningún subproceso de trabajo y la recuperación del repositorio está sujeta a reinicios. De lo contrario, utiliza un subproceso de plataforma (es decir, subproceso del SO) si se configura como “platform” o un subproceso virtual si se establece como “virtual”. Si se configura como "auto", se usan subprocesos virtuales si están disponibles (es decir, se ejecutan en JDK 21 y versiones posteriores); de lo contrario, no se usan subprocesos de trabajo.
- Opciones varias, que no están categorizadas:
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada 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
--distdir=<a path>
usos múltiples -
Más lugares donde buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
valor predeterminado: "false"-
Si se configura, la caché del repositorio vinculará el archivo de forma fija en caso de un acierto de caché, en lugar de copiar. Esto sirve para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Usa este factor para escalar todos los tiempos de espera en las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que sean 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 para descargas de http.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--http_connector_retry_max_timeout=<An immutable length of time.>
: "0 s" -
Es el tiempo de espera máximo para los reintentos de descarga de HTTP. Con el valor 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 descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación en caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché; de lo contrario, se usa el valor predeterminado “<output_user_root>/cache/repos/v1”
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
valor predeterminado: "false"-
Si se establece esta configuración, no se permitirá la descarga con ="{.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no está completamente deshabilitado; ="{.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"-
Indica el porcentaje de espacio ocupado (0-100) por encima del cual GcThrashingDetector considera los eventos de presión de la memoria en función de sus límites (--gc_thrashing_limits). Si se configura en 100, GcThrashingDetector se inhabilita.
Etiquetas:host_machine_resource_optimizations
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE.:
- El valor predeterminado de
--[no]incompatible_depset_for_java_output_source_jars
es "true" (verdadero). -
No-ops
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_new_actions_api
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,incompatible_change
- El valor predeterminado de
--[no]incompatible_visibility_private_attributes_at_definition
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,incompatible_change
- El valor predeterminado de
--[no]separate_aspect_deps
es "true" (verdadero). -
No-op
Etiquetas:no_op
- Opciones relacionadas con la semántica y el resultado de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Especificaste las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirá en el gráfico de dependencias resueltas incluso si se declararon de forma privada en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones anteriores harán que la resolución falle. También puedes definir la versión transferida 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
- El valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
es "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 una falla de resolución, “off” para inhabilitar la verificación o “warning” para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas `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 detecte una discrepancia o “error” para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
valor predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
valor predeterminado: "actualizar"-
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son “update” para usar el archivo de bloqueo y actualizarlo si hay cambios; “error” para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o “off” para no leerlo ni escribirlo en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y se recurrirá únicamente a los posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Configuración predeterminada de
--vendor_dir=<a path>
: ver descripción -
Especifica el directorio que debe contener los repositorios externos en modo de proveedor, ya sea con el fin de recuperarlos o usarlos durante la compilación. La ruta de acceso se puede especificar como una ruta de acceso absoluta o una ruta relativa al directorio del lugar de trabajo.
Etiquetas:loading_and_analysis
- 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 fallar Bazel con un OOM. Cada límite se especifica como <period>:<count>, donde el período es una duración y el recuento es un número entero positivo. Si más del --gc_thrashing_threshold por ciento del espacio titular (montón de generación anterior) permanece ocupado después de <count> GC completas consecutivas dentro de <period>, se activa una 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"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje de montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC completo, descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos de GC completos nunca activarán disminuciones. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de recolección de elementos no utilizados completo y se supere el umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje de montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC menor, descartará el estado temporal innecesario de Skyframe, hasta esta cantidad por invocación. El valor predeterminado es Integer.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos menores de GC nunca activarán disminuciones. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento menor de recolección de elementos no utilizados y se supere el umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje retenido de montón está al menos en este umbral, descartará el estado temporal innecesario de Skyframe. Un ajuste puede permitirte mitigar el impacto de la hiperpaginación de la GC en el tiempo, cuando esta (i) causa el uso de memoria de este estado temporal y (ii) es más costosa que reconstruir el estado cuando es necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Configuración predeterminada de
--experimental_command_profile=<cpu, wall, alloc or lock>
: ver descripción - Registra un perfil de grabadora de vuelo de Java mientras dure el comando. Se debe proporcionar uno de los tipos de eventos de generación de perfiles admitidos (cpu, muro, alloc o bloqueo) como argumento. El perfil se escribe en un archivo con el nombre del tipo de evento en el directorio base de salida. La sintaxis y semántica de esta marca podría cambiar en el futuro para admitir tipos de perfil o formatos de salida adicionales; úsala bajo tu responsabilidad.
--[no]experimental_record_metrics_for_all_mnemonics
valor predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán estadísticas para todos los mnemotécnicos.
- 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é remoto:
- Configuración predeterminada de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo para configurar el cargador 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 con el que debe coincidir y otro para usar como URL sustitutiva, con referencias inversas que comienzan con "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL, y se mostrarán varias URL.
- Valor predeterminado de
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "auto" - Es el modo de subprocesos que se usará para la recuperación del repositorio. Si se configura en “off”, no se usa ningún subproceso de trabajo y la recuperación del repositorio está sujeta a reinicios. De lo contrario, utiliza un subproceso de plataforma (es decir, subproceso del SO) si se configura como “platform” o un subproceso virtual si se establece como “virtual”. Si se configura como "auto", se usan subprocesos virtuales si están disponibles (es decir, se ejecutan en JDK 21 y versiones posteriores); de lo contrario, no se usan subprocesos de trabajo.
- Opciones varias, que no están categorizadas:
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada 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 desde dispositivos móviles
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Más lugares donde buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
valor predeterminado: "false"-
Si se configura, la caché del repositorio vinculará el archivo de forma fija en caso de un acierto de caché, en lugar de copiar. Esto sirve para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Usa este factor para escalar todos los tiempos de espera en las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que sean 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 para descargas de http.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--http_connector_retry_max_timeout=<An immutable length of time.>
: "0 s" -
Es el tiempo de espera máximo para los reintentos de descarga de HTTP. Con el valor 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 descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación en caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché; de lo contrario, se usa el valor predeterminado “<output_user_root>/cache/repos/v1”
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
valor predeterminado: "false"-
Si se establece esta configuración, no se permitirá la descarga con ="{.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no está completamente deshabilitado; ="{.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"-
Indica el porcentaje de espacio ocupado (0-100) por encima del cual GcThrashingDetector considera los eventos de presión de la memoria en función de sus límites (--gc_thrashing_limits). Si se configura en 100, GcThrashingDetector se inhabilita.
Etiquetas:host_machine_resource_optimizations
--mode=<classic, classic_internal_test_do_not_use or skylark>
predeterminado: "classic"-
Selecciona cómo ejecutar la instalación para dispositivos móviles. "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 ejecutar la acción:
--adb=<a string>
predeterminado: ""
Es el objeto binario de adb - que se usará para el comando "mobile-install". Si no se especifica, se usa 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
valor predeterminado: "false"-
Indica si se debe realizar una instalación incremental. Si es verdadero, intenta evitar trabajos adicionales innecesarios. Para ello, lee el estado del dispositivo en el que se instalará el código y usa esa información para evitar trabajos innecesarios. Si es falso (la opción predeterminada), siempre realiza una instalación completa.
Etiquetas:loading_and_analysis
--[no]split_apks
valor predeterminado: "false"-
Determina si se deben usar APK 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 y afectar su valor, en lugar de su existencia:
- Se acumulan
--adb_arg=<a string>
usos múltiples -
Argumentos adicionales para pasar a adb. Por lo general, se usa para designar un dispositivo en el que se instalará la app.
Etiquetas:action_command_lines
--debug_app
-
Indica si se debe esperar al depurador antes de iniciar la app.
Se expande a:
--start=DEBUG
Etiquetas:execution
--device=<a string>
predeterminado: ""-
Es el número de serie del dispositivo adb. Si no se especifica, se usará el primer dispositivo.
Etiquetas:action_command_lines
- Valor predeterminado de
--start=<no, cold, warm or debug>
: "NO" -
Cómo se debe iniciar la app después de instalarla. Configúralo como WARM para preservar y restablecer el estado de la app en las instalaciones incrementales.
Etiquetas:execution
--start_app
-
Determina si se debe iniciar la app después de instalarla.
Se expande a:
--start=COLD
Etiquetas:execution
- Esta opción afecta la semántica del lenguaje de Starlark o la API de Build a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.:
- El valor predeterminado de
--[no]incompatible_depset_for_java_output_source_jars
es "true" (verdadero). -
No-ops
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_new_actions_api
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,incompatible_change
- El valor predeterminado de
--[no]incompatible_visibility_private_attributes_at_definition
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,incompatible_change
- El valor predeterminado de
--[no]separate_aspect_deps
es "true" (verdadero). -
No-op
Etiquetas:no_op
- Opciones relacionadas con la semántica y el resultado de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Especificaste las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirá en el gráfico de dependencias resueltas incluso si se declararon de forma privada en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones anteriores harán que la resolución falle. También puedes definir la versión transferida 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
- El valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
es "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 una falla de resolución, “off” para inhabilitar la verificación o “warning” para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas `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 detecte una discrepancia o “error” para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
valor predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
valor predeterminado: "actualizar"-
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son “update” para usar el archivo de bloqueo y actualizarlo si hay cambios; “error” para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o “off” para no leerlo ni escribirlo en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y se recurrirá únicamente a los posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Configuración predeterminada de
--vendor_dir=<a path>
: ver descripción -
Especifica el directorio que debe contener los repositorios externos en modo de proveedor, ya sea con el fin de recuperarlos o usarlos durante la compilación. La ruta de acceso se puede especificar como una ruta de acceso absoluta o una ruta relativa al directorio del lugar de trabajo.
Etiquetas:loading_and_analysis
- 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 fallar Bazel con un OOM. Cada límite se especifica como <period>:<count>, donde el período es una duración y el recuento es un número entero positivo. Si más del --gc_thrashing_threshold por ciento del espacio titular (montón de generación anterior) permanece ocupado después de <count> GC completas consecutivas dentro de <period>, se activa una 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"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje de montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC completo, descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos de GC completos nunca activarán disminuciones. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de recolección de elementos no utilizados completo y se supere el umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje de montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC menor, descartará el estado temporal innecesario de Skyframe, hasta esta cantidad por invocación. El valor predeterminado es Integer.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos menores de GC nunca activarán disminuciones. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento menor de recolección de elementos no utilizados y se supere el umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje retenido de montón está al menos en este umbral, descartará el estado temporal innecesario de Skyframe. Un ajuste puede permitirte mitigar el impacto de la hiperpaginación de la GC en el tiempo, cuando esta (i) causa el uso de memoria de este estado temporal y (ii) es más costosa que reconstruir el estado cuando es necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Configuración predeterminada de
--experimental_command_profile=<cpu, wall, alloc or lock>
: ver descripción - Registra un perfil de grabadora de vuelo de Java mientras dure el comando. Se debe proporcionar uno de los tipos de eventos de generación de perfiles admitidos (cpu, muro, alloc o bloqueo) como argumento. El perfil se escribe en un archivo con el nombre del tipo de evento en el directorio base de salida. La sintaxis y semántica de esta marca podría cambiar en el futuro para admitir tipos de perfil o formatos de salida adicionales; úsala bajo tu responsabilidad.
--[no]experimental_record_metrics_for_all_mnemonics
valor predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán estadísticas para todos los mnemotécnicos.
--incremental_install_verbosity=<a string>
predeterminado: ""-
La verbosidad para una instalación incremental. Configúralo en 1 para el registro de depuración.
Etiquetas:bazel_monitoring
- Opciones que especifican o modifican 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é remoto:
- Configuración predeterminada de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo para configurar el cargador 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 con el que debe coincidir y otro para usar como URL sustitutiva, con referencias inversas que comienzan con "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL, y se mostrarán varias URL.
- Valor predeterminado de
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "auto" - Es el modo de subprocesos que se usará para la recuperación del repositorio. Si se configura en “off”, no se usa ningún subproceso de trabajo y la recuperación del repositorio está sujeta a reinicios. De lo contrario, utiliza un subproceso de plataforma (es decir, subproceso del SO) si se configura como “platform” o un subproceso virtual si se establece como “virtual”. Si se configura como "auto", se usan subprocesos virtuales si están disponibles (es decir, se ejecutan en JDK 21 y versiones posteriores); de lo contrario, no se usan subprocesos de trabajo.
- Opciones varias, que no están categorizadas:
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
Opciones de moderación
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Más lugares donde buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
valor predeterminado: "false"-
Si se configura, la caché del repositorio vinculará el archivo de forma fija en caso de un acierto de caché, en lugar de copiar. Esto sirve para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Usa este factor para escalar todos los tiempos de espera en las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que sean 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 para descargas de http.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--http_connector_retry_max_timeout=<An immutable length of time.>
: "0 s" -
Es el tiempo de espera máximo para los reintentos de descarga de HTTP. Con el valor 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 descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación en caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché; de lo contrario, se usa el valor predeterminado “<output_user_root>/cache/repos/v1”
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
valor predeterminado: "false"-
Si se establece esta configuración, no se permitirá la descarga con ="{.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no está completamente deshabilitado; ="{.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"-
Indica el porcentaje de espacio ocupado (0-100) por encima del cual GcThrashingDetector considera los eventos de presión de la memoria en función de sus límites (--gc_thrashing_limits). Si se configura en 100, GcThrashingDetector se inhabilita.
Etiquetas:host_machine_resource_optimizations
--[no]keep_going
[-k
] predeterminado: "false"-
Continúa tanto como sea posible después de un error. Si bien el objetivo que falló y aquellos que dependen de él no se pueden analizar, otros requisitos previos de estos objetivos pueden serlo.
Etiquetas:eagerness_to_exit
- Valor predeterminado de
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "auto" -
Cantidad de subprocesos paralelos que se usarán en la fase de carga o análisis. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguido 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 de Starlark o la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility
valor predeterminado: "false"-
Si es incompatible_enforce_config_setting_visibility=false, esta es una noop. De lo contrario, si la 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
- El valor predeterminado de
--[no]incompatible_depset_for_java_output_source_jars
es "true" (verdadero). -
No-ops
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_enforce_config_setting_visibility
es "true" (verdadero). -
Si es verdadero, aplica restricciones de visibilidad config_setting. Si es falso, cada config_setting es visible para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_new_actions_api
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,incompatible_change
- El valor predeterminado de
--[no]incompatible_visibility_private_attributes_at_definition
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,incompatible_change
- El valor predeterminado de
--[no]separate_aspect_deps
es "true" (verdadero). -
No-op
Etiquetas:no_op
- Opciones relacionadas con el resultado y la semántica del subcomando “mod”:
--base_module=<"<root>" for the root module; <module>@<version> for a specific version of a module; <module> for all versions of a module; @<name> for a repo with the given apparent name; or @@<name> for a repo with the given canonical name>
valor predeterminado: "<root>"-
Especifica un módulo relacionado con el que se interpretarán los repositorios de destino especificados.
Etiquetas:terminal_output
--charset=<utf8 or ascii>
predeterminado: "utf8"-
Elige el grupo de caracteres que se usará para el árbol. Solo afecta la salida de texto. Los valores válidos son “utf8” o “ascii”. El valor predeterminado es “utf8”.
Etiquetas:terminal_output
--[no]cycles
valor predeterminado: "false"-
Señala los ciclos de dependencia dentro del árbol que se muestra, que suelen ignorarse de forma predeterminada.
Etiquetas:terminal_output
--depth=<an integer>
valor predeterminado: "-1"-
Profundidad de visualización máxima del árbol de dependencias. Por ejemplo, una profundidad de 1 muestra las dependencias directas. Para las dependencias de árbol, path y all_paths, la configuración predeterminada es Integer.MAX_VALUE, mientras que para las dependencias y explica que, de forma predeterminada, 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
- Configuración predeterminada de
--extension_filter=<a comma-separated list of <extension>s>
: ver descripción -
Solo muestra los usos de estas extensiones de módulo y los repositorios que generaron si se configuraron sus respectivas marcas. Si se establece, el gráfico de resultados solo incluirá rutas de acceso que contengan módulos con las extensiones especificadas. Una lista vacía inhabilita el filtro y especifica de forma efectiva todas las extensiones posibles.
Etiquetas:terminal_output
- La configuración predeterminada de
--extension_info=<hidden, usages, repos or all>
es "oculta" -
Especifica cuántos detalles sobre los usos de extensiones se deben incluir en el resultado de la consulta. "Usos" solo mostrará los nombres de las extensiones, "repos" también incluirá los repositorios importados con use_repo, y "todos" también mostrará los otros repositorios generados por extensiones.
Etiquetas:terminal_output
--extension_usages=<a comma-separated list of <module>s>
predeterminado: ""-
Especifica los módulos cuyos usos de extensiones se mostrarán en la consulta show_extension.
Etiquetas:terminal_output
--from=<a comma-separated list of <module>s>
valor predeterminado: "<root>"-
Los módulos a partir de los cuales se mostrará la consulta del gráfico de dependencias. Revisa la descripción de cada consulta para conocer la semántica exacta. La configuración predeterminada es <root>.
Etiquetas:terminal_output
--[no]include_builtin
valor predeterminado: "false"-
Incluye módulos integrados en el gráfico de dependencia. Está inhabilitado de forma predeterminada porque es bastante ruidoso.
Etiquetas:terminal_output
--[no]include_unused
valor predeterminado: "false"-
Las consultas también considerarán y mostrarán los módulos sin usar, que no están presentes en el gráfico de resolución del módulo después de la selección (debido a las reglas de selección de versión mínima o anulación). Esto puede tener diferentes efectos para cada uno de los tipos de consulta, p.ej., 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"-
El formato en el que se deben imprimir los resultados de la consulta. Los valores permitidos para la consulta son los siguientes: texto, JSON, gráfico
Etiquetas:terminal_output
--[no]verbose
valor predeterminado: "false"-
Las consultas también mostrarán el motivo por el que los módulos se resolvieron en su versión actual (si se modificó). El valor predeterminado es verdadero solo para la consulta de explicación.
Etiquetas:terminal_output
- Opciones relacionadas con la semántica y el resultado de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Especificaste las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirá en el gráfico de dependencias resueltas incluso si se declararon de forma privada en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones anteriores harán que la resolución falle. También puedes definir la versión transferida 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
- El valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
es "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 una falla de resolución, “off” para inhabilitar la verificación o “warning” para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas `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 detecte una discrepancia o “error” para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
valor predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
valor predeterminado: "actualizar"-
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son “update” para usar el archivo de bloqueo y actualizarlo si hay cambios; “error” para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o “off” para no leerlo ni escribirlo en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y se recurrirá únicamente a los posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Configuración predeterminada de
--vendor_dir=<a path>
: ver descripción -
Especifica el directorio que debe contener los repositorios externos en modo de proveedor, ya sea con el fin de recuperarlos o usarlos durante la compilación. La ruta de acceso se puede especificar como una ruta de acceso absoluta o una ruta relativa al directorio del lugar de trabajo.
Etiquetas:loading_and_analysis
- 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 fallar Bazel con un OOM. Cada límite se especifica como <period>:<count>, donde el período es una duración y el recuento es un número entero positivo. Si más del --gc_thrashing_threshold por ciento del espacio titular (montón de generación anterior) permanece ocupado después de <count> GC completas consecutivas dentro de <period>, se activa una 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"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje de montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC completo, descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos de GC completos nunca activarán disminuciones. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de recolección de elementos no utilizados completo y se supere el umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje de montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC menor, descartará el estado temporal innecesario de Skyframe, hasta esta cantidad por invocación. El valor predeterminado es Integer.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos menores de GC nunca activarán disminuciones. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento menor de recolección de elementos no utilizados y se supere el umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje retenido de montón está al menos en este umbral, descartará el estado temporal innecesario de Skyframe. Un ajuste puede permitirte mitigar el impacto de la hiperpaginación de la GC en el tiempo, cuando esta (i) causa el uso de memoria de este estado temporal y (ii) es más costosa que reconstruir el estado cuando es necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Configuración predeterminada de
--experimental_command_profile=<cpu, wall, alloc or lock>
: ver descripción - Registra un perfil de grabadora de vuelo de Java mientras dure el comando. Se debe proporcionar uno de los tipos de eventos de generación de perfiles admitidos (cpu, muro, alloc o bloqueo) como argumento. El perfil se escribe en un archivo con el nombre del tipo de evento en el directorio base de salida. La sintaxis y semántica de esta marca podría cambiar en el futuro para admitir tipos de perfil o formatos de salida adicionales; úsala bajo tu responsabilidad.
--[no]experimental_record_metrics_for_all_mnemonics
valor predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán estadísticas para todos los mnemotécnicos.
- 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é remoto:
- Configuración predeterminada de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo para configurar el cargador 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 con el que debe coincidir y otro para usar como URL sustitutiva, con referencias inversas que comienzan con "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL, y se mostrarán varias URL.
- Valor predeterminado de
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "auto" - Es el modo de subprocesos que se usará para la recuperación del repositorio. Si se configura en “off”, no se usa ningún subproceso de trabajo y la recuperación del repositorio está sujeta a reinicios. De lo contrario, utiliza un subproceso de plataforma (es decir, subproceso del SO) si se configura como “platform” o un subproceso virtual si se establece como “virtual”. Si se configura como "auto", se usan subprocesos virtuales si están disponibles (es decir, se ejecutan en JDK 21 y versiones posteriores); de lo contrario, no se usan subprocesos de trabajo.
- Opciones varias, que no están categorizadas:
- Se acumulan
--deleted_packages=<comma-separated list of package names>
usos múltiples - Una lista separada por comas de los nombres de los paquetes que el sistema de compilación considerará que no existen, incluso si están visibles en algún lugar de la ruta del paquete. Usa esta opción cuando borres un subpaquete 'x/y' de un paquete 'x' existente. Por ejemplo, después de borrar x/y/BUILD en el cliente, el sistema de compilación puede presentar un reclamo si encuentra la etiqueta '//x:y/z' si todavía la proporciona otra entrada package_path. Si especificas --deleted_packages x/y se evita este problema.
- El valor predeterminado de
--[no]fetch
es "true" (verdadero). - Permite que el comando recupere dependencias externas. Si se establece como falsa, el comando usará cualquier versión almacenada en caché de la dependencia. Si no existe ninguna, el comando fallará.
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
--package_path=<colon-separated list of options>
predeterminado: "%workspace%"- Una lista separada por dos puntos sobre dónde buscar paquetes. Los elementos que comienzan con "%workspace%" son relativos al lugar de trabajo que lo contiene. Si se omite o está vacío, el valor predeterminado es el resultado de “bazel info default-package-path”.
- El valor predeterminado de
--[no]show_loading_progress
es "true" (verdadero). - Si se habilita, hace que Bazel imprima mensajes "Cargando paquete:".
Opciones de Print_action
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Más lugares donde buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
valor predeterminado: "false"-
Si se configura, la caché del repositorio vinculará el archivo de forma fija en caso de un acierto de caché, en lugar de copiar. Esto sirve para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Usa este factor para escalar todos los tiempos de espera en las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que sean 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 para descargas de http.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--http_connector_retry_max_timeout=<An immutable length of time.>
: "0 s" -
Es el tiempo de espera máximo para los reintentos de descarga de HTTP. Con el valor 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 descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación en caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché; de lo contrario, se usa el valor predeterminado “<output_user_root>/cache/repos/v1”
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
valor predeterminado: "false"-
Si se establece esta configuración, no se permitirá la descarga con ="{.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no está completamente deshabilitado; ="{.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"-
Indica el porcentaje de espacio ocupado (0-100) por encima del cual GcThrashingDetector considera los eventos de presión de la memoria en función de sus límites (--gc_thrashing_limits). Si se configura en 100, GcThrashingDetector se inhabilita.
Etiquetas:host_machine_resource_optimizations
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE.:
- El valor predeterminado de
--[no]incompatible_depset_for_java_output_source_jars
es "true" (verdadero). -
No-ops
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_new_actions_api
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,incompatible_change
- El valor predeterminado de
--[no]incompatible_visibility_private_attributes_at_definition
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,incompatible_change
- El valor predeterminado de
--[no]separate_aspect_deps
es "true" (verdadero). -
No-op
Etiquetas:no_op
- Opciones relacionadas con la semántica y el resultado de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Especificaste las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirá en el gráfico de dependencias resueltas incluso si se declararon de forma privada en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones anteriores harán que la resolución falle. También puedes definir la versión transferida 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
- El valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
es "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 una falla de resolución, “off” para inhabilitar la verificación o “warning” para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas `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 detecte una discrepancia o “error” para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
valor predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
valor predeterminado: "actualizar"-
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son “update” para usar el archivo de bloqueo y actualizarlo si hay cambios; “error” para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o “off” para no leerlo ni escribirlo en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y se recurrirá únicamente a los posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Configuración predeterminada de
--vendor_dir=<a path>
: ver descripción -
Especifica el directorio que debe contener los repositorios externos en modo de proveedor, ya sea con el fin de recuperarlos o usarlos durante la compilación. La ruta de acceso se puede especificar como una ruta de acceso absoluta o una ruta relativa al directorio del lugar de trabajo.
Etiquetas:loading_and_analysis
- 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 fallar Bazel con un OOM. Cada límite se especifica como <period>:<count>, donde el período es una duración y el recuento es un número entero positivo. Si más del --gc_thrashing_threshold por ciento del espacio titular (montón de generación anterior) permanece ocupado después de <count> GC completas consecutivas dentro de <period>, se activa una 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"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje de montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC completo, descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos de GC completos nunca activarán disminuciones. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de recolección de elementos no utilizados completo y se supere el umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje de montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC menor, descartará el estado temporal innecesario de Skyframe, hasta esta cantidad por invocación. El valor predeterminado es Integer.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos menores de GC nunca activarán disminuciones. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento menor de recolección de elementos no utilizados y se supere el umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje retenido de montón está al menos en este umbral, descartará el estado temporal innecesario de Skyframe. Un ajuste puede permitirte mitigar el impacto de la hiperpaginación de la GC en el tiempo, cuando esta (i) causa el uso de memoria de este estado temporal y (ii) es más costosa que reconstruir el estado cuando es necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Configuración predeterminada de
--experimental_command_profile=<cpu, wall, alloc or lock>
: ver descripción - Registra un perfil de grabadora de vuelo de Java mientras dure el comando. Se debe proporcionar uno de los tipos de eventos de generación de perfiles admitidos (cpu, muro, alloc o bloqueo) como argumento. El perfil se escribe en un archivo con el nombre del tipo de evento en el directorio base de salida. La sintaxis y semántica de esta marca podría cambiar en el futuro para admitir tipos de perfil o formatos de salida adicionales; úsala bajo tu responsabilidad.
--[no]experimental_record_metrics_for_all_mnemonics
valor predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán estadísticas para todos los mnemotécnicos.
- 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é remoto:
- Configuración predeterminada de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo para configurar el cargador 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 con el que debe coincidir y otro para usar como URL sustitutiva, con referencias inversas que comienzan con "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL, y se mostrarán varias URL.
- Valor predeterminado de
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "auto" - Es el modo de subprocesos que se usará para la recuperación del repositorio. Si se configura en “off”, no se usa ningún subproceso de trabajo y la recuperación del repositorio está sujeta a reinicios. De lo contrario, utiliza un subproceso de plataforma (es decir, subproceso del SO) si se configura como “platform” o un subproceso virtual si se establece como “virtual”. Si se configura como "auto", se usan subprocesos virtuales si están disponibles (es decir, se ejecutan en JDK 21 y versiones posteriores); de lo contrario, no se usan subprocesos de trabajo.
- Opciones varias, que no están categorizadas:
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--print_action_mnemonics=<a string>
usos múltiples - Enumera los mnemotécnicos según los cuales se filtran los datos print_action. No se realizan filtros cuando se deja vacío.
Opciones de consulta
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Más lugares donde buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
valor predeterminado: "false"-
Si se configura, la caché del repositorio vinculará el archivo de forma fija en caso de un acierto de caché, en lugar de copiar. Esto sirve para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Usa este factor para escalar todos los tiempos de espera en las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que sean 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 para descargas de http.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--http_connector_retry_max_timeout=<An immutable length of time.>
: "0 s" -
Es el tiempo de espera máximo para los reintentos de descarga de HTTP. Con el valor 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 descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación en caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché; de lo contrario, se usa el valor predeterminado “<output_user_root>/cache/repos/v1”
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
valor predeterminado: "false"-
Si se establece esta configuración, no se permitirá la descarga con ="{.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no está completamente deshabilitado; ="{.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"-
Indica el porcentaje de espacio ocupado (0-100) por encima del cual GcThrashingDetector considera los eventos de presión de la memoria en función de sus límites (--gc_thrashing_limits). Si se configura en 100, GcThrashingDetector se inhabilita.
Etiquetas:host_machine_resource_optimizations
--[no]keep_going
[-k
] predeterminado: "false"-
Continúa tanto como sea posible después de un error. Si bien el objetivo que falló y aquellos que dependen de él no se pueden analizar, otros requisitos previos de estos objetivos pueden serlo.
Etiquetas:eagerness_to_exit
- Valor predeterminado de
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "auto" -
Cantidad de subprocesos paralelos que se usarán en la fase de carga o análisis. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguido 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 de Starlark o la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility
valor predeterminado: "false"-
Si es incompatible_enforce_config_setting_visibility=false, esta es una noop. De lo contrario, si la 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
- El valor predeterminado de
--[no]incompatible_depset_for_java_output_source_jars
es "true" (verdadero). -
No-ops
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_enforce_config_setting_visibility
es "true" (verdadero). -
Si es verdadero, aplica restricciones de visibilidad config_setting. Si es falso, cada config_setting es visible para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_new_actions_api
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,incompatible_change
- El valor predeterminado de
--[no]incompatible_visibility_private_attributes_at_definition
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,incompatible_change
- El valor predeterminado de
--[no]separate_aspect_deps
es "true" (verdadero). -
No-op
Etiquetas:no_op
- Opciones relacionadas con el resultado y la semántica de la consulta:
- El valor predeterminado de
--aspect_deps=<off, conservative or precise>
es "conservador". -
Cómo resolver dependencias de aspecto cuando el formato de salida es {xml,proto,record}. “desactivado” significa que no se resuelven las dependencias de aspecto, “conservadora” (el valor predeterminado) significa que se agregan todas las dependencias de aspecto declaradas sin importar si se les otorga la clase de regla de las dependencias directas. “preciso” significa que solo se agregan esos aspectos que posiblemente estén activos dada la clase de regla de las dependencias directas. Ten en cuenta que el modo preciso requiere cargar otros paquetes para evaluar un solo objetivo, por lo que es más lento que los otros modos. Además, ten en cuenta que incluso el modo preciso no es del todo preciso: la decisión de calcular un aspecto se decide en la fase de análisis, que no se ejecuta durante la “consulta de Bazel”.
Etiquetas:build_file_semantics
--[no]consistent_labels
valor predeterminado: "false"-
Si se habilita, cada comando de consulta emite etiquetas como si lo hiciera la función <code>str</code> de Starlark aplicada a una instancia de <code>etiqueta</code>. Esto es útil para las herramientas que necesitan hacer coincidir el resultado de diferentes comandos de consulta o etiquetas emitidas por reglas. Si no están habilitados, los formateadores de salida tienen la libertad de emitir nombres de repositorio aparentes (en relación con el repositorio principal) para que los resultados sean más legibles.
Etiquetas:terminal_output
--[no]experimental_explicit_aspects
valor predeterminado: "false"-
aquery, cquery: si se deben incluir acciones generadas por el aspecto en el resultado. query: no-op (siempre se siguen los aspectos).
Etiquetas:terminal_output
- Valor predeterminado de
--[no]experimental_graphless_query
: "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, y también un subconjunto de formateadores de salida.
Etiquetas:build_file_semantics
,eagerness_to_exit
--graph:conditional_edges_limit=<an integer>
predeterminado: "4"-
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 ninguna anotación. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]graph:factored
es "true" (verdadero). -
Si es "true", el gráfico se emitirá "factorizado", es decir, los nodos equivalentes topológicamente se combinarán y sus etiquetas se concatenarán. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--graph:node_limit=<an integer>
predeterminado: "512"-
La longitud máxima de la string de etiqueta para un nodo del gráfico en el resultado. Las etiquetas más largas se truncarán; -1 significa que no hay truncamiento. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]implicit_deps
es "true" (verdadero). -
Si se habilita, las dependencias implícitas se incluirán en el gráfico de dependencias en el que opera la consulta. Una dependencia implícita es aquella que no se especifica de forma explícita en el archivo BUILD, sino que Bazel la agrega. En el caso de cquery, esta opción controla el filtrado de cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
- El valor predeterminado de
--[no]include_aspects
es "true" (verdadero). -
aquery, cquery: si se deben incluir acciones generadas por el aspecto en el resultado. query: no-op (siempre se siguen los aspectos).
Etiquetas:terminal_output
- El valor predeterminado de
--[no]incompatible_lexicographical_output
es "true" (verdadero). -
Si se configura esta opción, ordena --order_output=auto salida en orden lexicográfico.
Etiquetas:terminal_output
,incompatible_change
- El valor predeterminado de
--[no]incompatible_package_group_includes_double_slash
es "true" (verdadero). -
Si se habilita, cuando se genere el atributo `packages` de package_group, no se omitirá el signo `//` inicial.
Etiquetas:terminal_output
,incompatible_change
--[no]infer_universe_scope
valor predeterminado: "false"-
Si se configura y --universe_scope no se establece, se inferirá un valor de --universe_scope como la lista de patrones de objetivo únicos en la expresión de consulta. Ten en cuenta que el valor de --universe_scope que se infiere para una expresión de consulta que utiliza funciones con alcance universal (p.ej., `allrdeps`) puede no ser lo que quieres, por lo que solo debes usar esta opción si sabes lo que estás haciendo. Consulta https://bazel.build/reference/query#sky-query para obtener detalles y ejemplos. Si se configura --universe_scope, se ignora el valor de esta opción. Nota: Esta opción solo se aplica a “consulta” (es decir, no a “cquery”).
Etiquetas:loading_and_analysis
--[no]line_terminator_null
valor predeterminado: "false"-
Indica si cada formato termina con \0 en lugar de una línea nueva.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]nodep_deps
es "true" (verdadero). -
Si se habilita, las dependencias de los atributos “nodep” se incluirán en el gráfico de dependencias en el que opera la consulta. Un ejemplo común de un atributo “nodep” es la “visibilidad”. Ejecuta y analiza el resultado de `info build-language` para conocer todos los atributos “nodep” en el lenguaje de compilación.
Etiquetas:build_file_semantics
--noorder_results
-
Muestra los resultados en orden de dependencia (predeterminado) o desordenado. El resultado desordenado es más rápido, pero solo se admite cuando --output no es el rango mínimo, el rango máximo ni el gráfico.
Se expande a:
--order_output=no
Etiquetas:terminal_output
--null
-
Indica si cada formato termina con \0 en lugar de una línea nueva.
Se expande a:
--line_terminator_null=true
Etiquetas:terminal_output
- Valor predeterminado de
--order_output=<no, deps, auto or full>
: "auto" -
Muestra los resultados sin orden (no), ordenados por dependencia (dependencias) o completamente ordenados (completo). El valor predeterminado es 'auto', lo que significa que los resultados se muestran en orden de dependencia o completamente ordenados, según el formateador de salida (dependencia ordenada para proto, minrank, maxrank y grafo, completamente ordenado para todos los demás). Cuando la salida está completamente ordenada, los nodos se imprimen en un orden totalmente determinista (total). Primero, todos los nodos se ordenan alfabéticamente. Luego, cada nodo de la lista se utiliza como el inicio de una búsqueda de profundidad primero posterior al orden, en la que las aristas salientes a los nodos no visitados se recorren en orden alfabético de los nodos sucesores. Por último, los nodos se imprimen en orden inverso al orden en que se visitaron.
Etiquetas:terminal_output
--order_results
-
Muestra los resultados en orden de dependencia (predeterminado) o desordenado. El resultado desordenado es más rápido, pero solo se admite cuando --output no es el rango mínimo, el rango máximo ni el gráfico.
Se expande a:
--order_output=auto
Etiquetas:terminal_output
--output=<a string>
, valor predeterminado: “label”-
El formato en el que se deben imprimir los resultados de la consulta. Los valores permitidos para la consulta son los siguientes: build, grafo, stream_jsonproto, label, label_kind, location, maxrank, minrank, package, proto, stream_proto, xml.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]proto:default_values
es "true" (verdadero). -
Si el valor es "true", 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
valor predeterminado: "false"-
Propaga el campo proto define_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
- El valor predeterminado de
--[no]proto:flatten_selects
es "true" (verdadero). -
Si se habilita, se compactan los atributos configurables creados por select(). Para los tipos de lista, la representación plana es una lista que contiene cada valor del mapa de selección exactamente una vez. Los tipos escalares se acoplan a nulos.
Etiquetas:build_file_semantics
--[no]proto:include_attribute_source_aspects
valor predeterminado: "false"-
Propaga el campo proto source_aspect_name de cada Atributo con el aspecto de origen del que provino (si no lo hizo, una cadena vacía).
Etiquetas:terminal_output
--[no]proto:include_synthetic_attribute_hash
valor predeterminado: "false"-
Indica si se debe calcular y propagar el atributo $internal_attr_hash o no.
Etiquetas:terminal_output
--[no]proto:instantiation_stack
valor 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
- El valor predeterminado de
--[no]proto:locations
es "true" (verdadero). - Indica si se debe generar información de ubicación en el resultado de proto.
Etiquetas:terminal_output
- La configuración predeterminada de
--proto:output_rule_attrs=<comma-separated list of options>
es "todos" -
Lista de atributos separados por comas para incluir en el resultado. La configuración predeterminada es todos los atributos. Se establece como una cadena vacía para no generar ningún atributo. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]proto:rule_inputs_and_outputs
es "true" (verdadero). -
Indica si se deben propagar los campos rule_input y rule_output o no.
Etiquetas:terminal_output
--query_file=<a string>
predeterminado: ""-
Si se configura, la consulta leerá la consulta desde el archivo que se menciona aquí, en lugar de hacerlo desde la línea de comandos. Es un error especificar un archivo aquí, así como una consulta de línea de comandos.
Etiquetas:changes_inputs
--[no]relative_locations
valor predeterminado: "false"-
Si es "true", la ubicación de los archivos BUILD en los resultados xml y proto será relativa. De forma predeterminada, el resultado de la ubicación es una ruta de acceso absoluta y no será coherente en todas las máquinas. Puedes configurar esta opción como verdadera para obtener un resultado coherente en todas las máquinas.
Etiquetas:terminal_output
--[no]strict_test_suite
valor predeterminado: "false"-
Si es verdadero, la expresión tests() muestra un error si encuentra un paquete test_suite que contiene objetivos que no son de prueba.
Etiquetas:build_file_semantics
,eagerness_to_exit
- El valor predeterminado de
--[no]tool_deps
es "true" (verdadero). -
Consulta: Si se inhabilita, las dependencias de la "configuración de ejecución" no se incluirán en el gráfico de dependencias en el que opera la consulta. Un perímetro de dependencia de 'ejecución de configuración', como el de cualquier regla 'proto_library' al compilador de protocolos, generalmente apunta a una herramienta ejecutada durante la compilación en lugar de a una parte del mismo programa 'target'.
Cquery: Si se inhabilita, filtra todos los destinos configurados que cruzan una transición de ejecución del objetivo de nivel superior que descubrió este objetivo configurado. Esto significa que si el objetivo de nivel superior está en la configuración de destino, solo se mostrarán los objetivos configurados también en esa configuración. Si el objetivo de nivel superior está en la configuración de ejecución, solo se mostrarán los objetivos configurados de ejecución. Esta opción NO excluirá las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
--universe_scope=<comma-separated list of options>
predeterminado: ""-
Un conjunto de patrones de objetivo separados por comas (aditivos y sustractivos). 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.
Para cquery, la entrada a esta opción son los destinos en los que se compilan todas las respuestas, por lo que esta opción puede afectar las configuraciones y las transiciones. Si no se especifica esta opción, se supone que los destinos de nivel superior son los destinos analizados a partir de la expresión de consulta. Nota: En el caso de cquery, no especificar esta opción puede provocar que la compilación falle si los objetivos analizados a partir de la expresión de consulta no se pueden compilar con opciones de nivel superior.
Etiquetas:loading_and_analysis
--[no]xml:default_values
valor predeterminado: "false"-
Si el valor es "true", se imprimen los atributos de la regla cuyo valor no se especifica explícitamente en el archivo BUILD. De lo contrario, se omiten.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]xml:line_numbers
es "true" (verdadero). -
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 la semántica y el resultado de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Especificaste las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirá en el gráfico de dependencias resueltas incluso si se declararon de forma privada en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones anteriores harán que la resolución falle. También puedes definir la versión transferida 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
- El valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
es "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 una falla de resolución, “off” para inhabilitar la verificación o “warning” para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas `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 detecte una discrepancia o “error” para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
valor predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
valor predeterminado: "actualizar"-
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son “update” para usar el archivo de bloqueo y actualizarlo si hay cambios; “error” para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o “off” para no leerlo ni escribirlo en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y se recurrirá únicamente a los posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Configuración predeterminada de
--vendor_dir=<a path>
: ver descripción -
Especifica el directorio que debe contener los repositorios externos en modo de proveedor, ya sea con el fin de recuperarlos o usarlos durante la compilación. La ruta de acceso se puede especificar como una ruta de acceso absoluta o una ruta relativa al directorio del lugar de trabajo.
Etiquetas:loading_and_analysis
- 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 fallar Bazel con un OOM. Cada límite se especifica como <period>:<count>, donde el período es una duración y el recuento es un número entero positivo. Si más del --gc_thrashing_threshold por ciento del espacio titular (montón de generación anterior) permanece ocupado después de <count> GC completas consecutivas dentro de <period>, se activa una 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"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje de montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC completo, descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos de GC completos nunca activarán disminuciones. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de recolección de elementos no utilizados completo y se supere el umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje de montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC menor, descartará el estado temporal innecesario de Skyframe, hasta esta cantidad por invocación. El valor predeterminado es Integer.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos menores de GC nunca activarán disminuciones. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento menor de recolección de elementos no utilizados y se supere el umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje retenido de montón está al menos en este umbral, descartará el estado temporal innecesario de Skyframe. Un ajuste puede permitirte mitigar el impacto de la hiperpaginación de la GC en el tiempo, cuando esta (i) causa el uso de memoria de este estado temporal y (ii) es más costosa que reconstruir el estado cuando es necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Configuración predeterminada de
--experimental_command_profile=<cpu, wall, alloc or lock>
: ver descripción - Registra un perfil de grabadora de vuelo de Java mientras dure el comando. Se debe proporcionar uno de los tipos de eventos de generación de perfiles admitidos (cpu, muro, alloc o bloqueo) como argumento. El perfil se escribe en un archivo con el nombre del tipo de evento en el directorio base de salida. La sintaxis y semántica de esta marca podría cambiar en el futuro para admitir tipos de perfil o formatos de salida adicionales; úsala bajo tu responsabilidad.
--[no]experimental_record_metrics_for_all_mnemonics
valor predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán estadísticas para todos los mnemotécnicos.
--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
- Opciones que especifican o modifican 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é remoto:
- Configuración predeterminada de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo para configurar el cargador 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 con el que debe coincidir y otro para usar como URL sustitutiva, con referencias inversas que comienzan con "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL, y se mostrarán varias URL.
- Valor predeterminado de
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "auto" - Es el modo de subprocesos que se usará para la recuperación del repositorio. Si se configura en “off”, no se usa ningún subproceso de trabajo y la recuperación del repositorio está sujeta a reinicios. De lo contrario, utiliza un subproceso de plataforma (es decir, subproceso del SO) si se configura como “platform” o un subproceso virtual si se establece como “virtual”. Si se configura como "auto", se usan subprocesos virtuales si están disponibles (es decir, se ejecutan en JDK 21 y versiones posteriores); de lo contrario, no se usan subprocesos de trabajo.
- Opciones varias, que no están categorizadas:
- Se acumulan
--deleted_packages=<comma-separated list of package names>
usos múltiples - Una lista separada por comas de los nombres de los paquetes que el sistema de compilación considerará que no existen, incluso si están visibles en algún lugar de la ruta del paquete. Usa esta opción cuando borres un subpaquete 'x/y' de un paquete 'x' existente. Por ejemplo, después de borrar x/y/BUILD en el cliente, el sistema de compilación puede presentar un reclamo si encuentra la etiqueta '//x:y/z' si todavía la proporciona otra entrada package_path. Si especificas --deleted_packages x/y se evita este problema.
- El valor predeterminado de
--[no]fetch
es "true" (verdadero). - Permite que el comando recupere dependencias externas. Si se establece como falsa, el comando usará cualquier versión almacenada en caché de la dependencia. Si no existe ninguna, el comando fallará.
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
--package_path=<colon-separated list of options>
predeterminado: "%workspace%"- Una lista separada por dos puntos sobre dónde buscar paquetes. Los elementos que comienzan con "%workspace%" son relativos al lugar de trabajo que lo contiene. Si se omite o está vacío, el valor predeterminado es el resultado de “bazel info default-package-path”.
- El valor predeterminado de
--[no]show_loading_progress
es "true" (verdadero). - Si se habilita, hace que Bazel imprima mensajes "Cargando paquete:".
Opciones de ejecución
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Más lugares donde buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
valor predeterminado: "false"-
Si se configura, la caché del repositorio vinculará el archivo de forma fija en caso de un acierto de caché, en lugar de copiar. Esto sirve para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Usa este factor para escalar todos los tiempos de espera en las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que sean 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 para descargas de http.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--http_connector_retry_max_timeout=<An immutable length of time.>
: "0 s" -
Es el tiempo de espera máximo para los reintentos de descarga de HTTP. Con el valor 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 descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
--[no]portable_paths
valor predeterminado: "false"-
Si es verdadero, incluye rutas de acceso que se reemplazarán en ExecRequest para que las rutas resultantes sean portátiles.
Etiquetas:affects_outputs
- Configuración predeterminada de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación en caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché; de lo contrario, se usa el valor predeterminado “<output_user_root>/cache/repos/v1”
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
valor predeterminado: "false"-
Si se establece esta configuración, no se permitirá la descarga con ="{.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no está completamente deshabilitado; ="{.execute aún podría ejecutar un ejecutable arbitrario que acceda a Internet.
Etiquetas:bazel_internal_configuration
- El valor predeterminado de
--[no]run
es "true" (verdadero). -
Si es falso, omite la ejecución de la línea de comandos creada para el destino compilado. Ten en cuenta que esta marca se ignora para todas las compilaciones de --script_path.
Etiquetas:affects_outputs
- Opciones que controlan la ejecución de la compilación:
--gc_thrashing_threshold=<an integer in 0-100 range>
predeterminado: "100"-
Indica el porcentaje de espacio ocupado (0-100) por encima del cual GcThrashingDetector considera los eventos de presión de la memoria en función de sus límites (--gc_thrashing_limits). Si se configura en 100, GcThrashingDetector se inhabilita.
Etiquetas:host_machine_resource_optimizations
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
- Configuración predeterminada de
--script_path=<a path>
: ver descripción -
Si se configura, escribe una secuencia de comandos de shell en el archivo determinado que invoque el destino. Si se configura esta opción, el destino no se ejecuta desde Bazel. Usa “bazel run --script_path=foo //foo && ./foo” para invocar el destino “//foo”. La diferencia de “bazel run //foo” es que el bloqueo de Bazel se libera y el ejecutable está conectado al stdin de la terminal.
Etiquetas:affects_outputs
,execution
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE.:
- El valor predeterminado de
--[no]incompatible_depset_for_java_output_source_jars
es "true" (verdadero). -
No-ops
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_new_actions_api
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,incompatible_change
- El valor predeterminado de
--[no]incompatible_visibility_private_attributes_at_definition
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,incompatible_change
- El valor predeterminado de
--[no]separate_aspect_deps
es "true" (verdadero). -
No-op
Etiquetas:no_op
- Opciones relacionadas con la semántica y el resultado de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Especificaste las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirá en el gráfico de dependencias resueltas incluso si se declararon de forma privada en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones anteriores harán que la resolución falle. También puedes definir la versión transferida 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
- El valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
es "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 una falla de resolución, “off” para inhabilitar la verificación o “warning” para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas `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 detecte una discrepancia o “error” para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
valor predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
valor predeterminado: "actualizar"-
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son “update” para usar el archivo de bloqueo y actualizarlo si hay cambios; “error” para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o “off” para no leerlo ni escribirlo en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y se recurrirá únicamente a los posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Configuración predeterminada de
--vendor_dir=<a path>
: ver descripción -
Especifica el directorio que debe contener los repositorios externos en modo de proveedor, ya sea con el fin de recuperarlos o usarlos durante la compilación. La ruta de acceso se puede especificar como una ruta de acceso absoluta o una ruta relativa al directorio del lugar de trabajo.
Etiquetas:loading_and_analysis
- 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 fallar Bazel con un OOM. Cada límite se especifica como <period>:<count>, donde el período es una duración y el recuento es un número entero positivo. Si más del --gc_thrashing_threshold por ciento del espacio titular (montón de generación anterior) permanece ocupado después de <count> GC completas consecutivas dentro de <period>, se activa una 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"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje de montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC completo, descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos de GC completos nunca activarán disminuciones. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de recolección de elementos no utilizados completo y se supere el umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje de montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC menor, descartará el estado temporal innecesario de Skyframe, hasta esta cantidad por invocación. El valor predeterminado es Integer.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos menores de GC nunca activarán disminuciones. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento menor de recolección de elementos no utilizados y se supere el umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje retenido de montón está al menos en este umbral, descartará el estado temporal innecesario de Skyframe. Un ajuste puede permitirte mitigar el impacto de la hiperpaginación de la GC en el tiempo, cuando esta (i) causa el uso de memoria de este estado temporal y (ii) es más costosa que reconstruir el estado cuando es necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Configuración predeterminada de
--experimental_command_profile=<cpu, wall, alloc or lock>
: ver descripción - Registra un perfil de grabadora de vuelo de Java mientras dure el comando. Se debe proporcionar uno de los tipos de eventos de generación de perfiles admitidos (cpu, muro, alloc o bloqueo) como argumento. El perfil se escribe en un archivo con el nombre del tipo de evento en el directorio base de salida. La sintaxis y semántica de esta marca podría cambiar en el futuro para admitir tipos de perfil o formatos de salida adicionales; úsala bajo tu responsabilidad.
--[no]experimental_record_metrics_for_all_mnemonics
valor predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán estadísticas para todos los mnemotécnicos.
- 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é remoto:
- Configuración predeterminada de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo para configurar el cargador 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 con el que debe coincidir y otro para usar como URL sustitutiva, con referencias inversas que comienzan con "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL, y se mostrarán varias URL.
- Valor predeterminado de
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "auto" - Es el modo de subprocesos que se usará para la recuperación del repositorio. Si se configura en “off”, no se usa ningún subproceso de trabajo y la recuperación del repositorio está sujeta a reinicios. De lo contrario, utiliza un subproceso de plataforma (es decir, subproceso del SO) si se configura como “platform” o un subproceso virtual si se establece como “virtual”. Si se configura como "auto", se usan subprocesos virtuales si están disponibles (es decir, se ejecutan en JDK 21 y versiones posteriores); de lo contrario, no se usan subprocesos de trabajo.
- Opciones varias, que no están categorizadas:
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada 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
--distdir=<a path>
usos múltiples -
Más lugares donde buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
valor predeterminado: "false"-
Si se configura, la caché del repositorio vinculará el archivo de forma fija en caso de un acierto de caché, en lugar de copiar. Esto sirve para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Usa este factor para escalar todos los tiempos de espera en las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que sean 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 para descargas de http.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--http_connector_retry_max_timeout=<An immutable length of time.>
: "0 s" -
Es el tiempo de espera máximo para los reintentos de descarga de HTTP. Con el valor 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 descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación en caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché; de lo contrario, se usa el valor predeterminado “<output_user_root>/cache/repos/v1”
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
valor predeterminado: "false"-
Si se establece esta configuración, no se permitirá la descarga con ="{.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no está completamente deshabilitado; ="{.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"-
Indica el porcentaje de espacio ocupado (0-100) por encima del cual GcThrashingDetector considera los eventos de presión de la memoria en función de sus límites (--gc_thrashing_limits). Si se configura en 100, GcThrashingDetector se inhabilita.
Etiquetas:host_machine_resource_optimizations
- Opciones que controlan el resultado del comando:
--iff_heap_size_greater_than=<an integer>
predeterminado: "0"-
Si no es cero, el apagado solo apagará el servidor si la memoria total (en MB) que consume la JVM supera este valor.
Etiquetas:loses_incremental_state
,eagerness_to_exit
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.:
- El valor predeterminado de
--[no]incompatible_depset_for_java_output_source_jars
es "true" (verdadero). -
No-ops
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_new_actions_api
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,incompatible_change
- El valor predeterminado de
--[no]incompatible_visibility_private_attributes_at_definition
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,incompatible_change
- El valor predeterminado de
--[no]separate_aspect_deps
es "true" (verdadero). -
No-op
Etiquetas:no_op
- Opciones relacionadas con la semántica y el resultado de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Especificaste las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirá en el gráfico de dependencias resueltas incluso si se declararon de forma privada en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones anteriores harán que la resolución falle. También puedes definir la versión transferida 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
- El valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
es "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 una falla de resolución, “off” para inhabilitar la verificación o “warning” para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas `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 detecte una discrepancia o “error” para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
valor predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
valor predeterminado: "actualizar"-
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son “update” para usar el archivo de bloqueo y actualizarlo si hay cambios; “error” para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o “off” para no leerlo ni escribirlo en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y se recurrirá únicamente a los posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Configuración predeterminada de
--vendor_dir=<a path>
: ver descripción -
Especifica el directorio que debe contener los repositorios externos en modo de proveedor, ya sea con el fin de recuperarlos o usarlos durante la compilación. La ruta de acceso se puede especificar como una ruta de acceso absoluta o una ruta relativa al directorio del lugar de trabajo.
Etiquetas:loading_and_analysis
- 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 fallar Bazel con un OOM. Cada límite se especifica como <period>:<count>, donde el período es una duración y el recuento es un número entero positivo. Si más del --gc_thrashing_threshold por ciento del espacio titular (montón de generación anterior) permanece ocupado después de <count> GC completas consecutivas dentro de <period>, se activa una 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"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje de montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC completo, descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos de GC completos nunca activarán disminuciones. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de recolección de elementos no utilizados completo y se supere el umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje de montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC menor, descartará el estado temporal innecesario de Skyframe, hasta esta cantidad por invocación. El valor predeterminado es Integer.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos menores de GC nunca activarán disminuciones. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento menor de recolección de elementos no utilizados y se supere el umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje retenido de montón está al menos en este umbral, descartará el estado temporal innecesario de Skyframe. Un ajuste puede permitirte mitigar el impacto de la hiperpaginación de la GC en el tiempo, cuando esta (i) causa el uso de memoria de este estado temporal y (ii) es más costosa que reconstruir el estado cuando es necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Configuración predeterminada de
--experimental_command_profile=<cpu, wall, alloc or lock>
: ver descripción - Registra un perfil de grabadora de vuelo de Java mientras dure el comando. Se debe proporcionar uno de los tipos de eventos de generación de perfiles admitidos (cpu, muro, alloc o bloqueo) como argumento. El perfil se escribe en un archivo con el nombre del tipo de evento en el directorio base de salida. La sintaxis y semántica de esta marca podría cambiar en el futuro para admitir tipos de perfil o formatos de salida adicionales; úsala bajo tu responsabilidad.
--[no]experimental_record_metrics_for_all_mnemonics
valor predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán estadísticas para todos los mnemotécnicos.
- 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é remoto:
- Configuración predeterminada de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo para configurar el cargador 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 con el que debe coincidir y otro para usar como URL sustitutiva, con referencias inversas que comienzan con "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL, y se mostrarán varias URL.
- Valor predeterminado de
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "auto" - Es el modo de subprocesos que se usará para la recuperación del repositorio. Si se configura en “off”, no se usa ningún subproceso de trabajo y la recuperación del repositorio está sujeta a reinicios. De lo contrario, utiliza un subproceso de plataforma (es decir, subproceso del SO) si se configura como “platform” o un subproceso virtual si se establece como “virtual”. Si se configura como "auto", se usan subprocesos virtuales si están disponibles (es decir, se ejecutan en JDK 21 y versiones posteriores); de lo contrario, no se usan subprocesos de trabajo.
- Opciones varias, que no están categorizadas:
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada 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
--distdir=<a path>
usos múltiples -
Más lugares donde buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
valor predeterminado: "false"-
Si se configura, la caché del repositorio vinculará el archivo de forma fija en caso de un acierto de caché, en lugar de copiar. Esto sirve para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Usa este factor para escalar todos los tiempos de espera en las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que sean 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 para descargas de http.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--http_connector_retry_max_timeout=<An immutable length of time.>
: "0 s" -
Es el tiempo de espera máximo para los reintentos de descarga de HTTP. Con el valor 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 descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación en caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché; de lo contrario, se usa el valor predeterminado “<output_user_root>/cache/repos/v1”
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
valor predeterminado: "false"-
Si se establece esta configuración, no se permitirá la descarga con ="{.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no está completamente deshabilitado; ="{.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:
- El valor predeterminado de
--[no]configure
es "Falso". -
Solo sincroniza los repositorios marcados como "configurar" para fines de configuración del sistema.
Etiquetas:changes_inputs
--gc_thrashing_threshold=<an integer in 0-100 range>
predeterminado: "100"-
Indica el porcentaje de espacio ocupado (0-100) por encima del cual GcThrashingDetector considera los eventos de presión de la memoria en función de sus límites (--gc_thrashing_limits). Si se configura en 100, GcThrashingDetector se inhabilita.
Etiquetas:host_machine_resource_optimizations
--[no]keep_going
[-k
] predeterminado: "false"-
Continúa tanto como sea posible después de un error. Si bien el objetivo que falló y aquellos que dependen de él no se pueden analizar, otros requisitos previos de estos objetivos pueden serlo.
Etiquetas:eagerness_to_exit
- Valor predeterminado de
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "auto" -
Cantidad de subprocesos paralelos que se usarán en la fase de carga o análisis. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguido 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
--only=<a string>
usos múltiples -
Si se te brinda esta opción, solo sincroniza los repositorios especificados con esta opción. Considera que todos los parámetros de configuración de --configure (o todos ellos) están desactualizados.
Etiquetas:changes_inputs
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility
valor predeterminado: "false"-
Si es incompatible_enforce_config_setting_visibility=false, esta es una noop. De lo contrario, si la 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
- El valor predeterminado de
--[no]incompatible_depset_for_java_output_source_jars
es "true" (verdadero). -
No-ops
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_enforce_config_setting_visibility
es "true" (verdadero). -
Si es verdadero, aplica restricciones de visibilidad config_setting. Si es falso, cada config_setting es visible para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_new_actions_api
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,incompatible_change
- El valor predeterminado de
--[no]incompatible_visibility_private_attributes_at_definition
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,incompatible_change
- El valor predeterminado de
--[no]separate_aspect_deps
es "true" (verdadero). -
No-op
Etiquetas:no_op
- Opciones relacionadas con la semántica y el resultado de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Especificaste las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirá en el gráfico de dependencias resueltas incluso si se declararon de forma privada en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones anteriores harán que la resolución falle. También puedes definir la versión transferida 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
- El valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
es "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 una falla de resolución, “off” para inhabilitar la verificación o “warning” para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas `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 detecte una discrepancia o “error” para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
valor predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
valor predeterminado: "actualizar"-
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son “update” para usar el archivo de bloqueo y actualizarlo si hay cambios; “error” para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o “off” para no leerlo ni escribirlo en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y se recurrirá únicamente a los posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Configuración predeterminada de
--vendor_dir=<a path>
: ver descripción -
Especifica el directorio que debe contener los repositorios externos en modo de proveedor, ya sea con el fin de recuperarlos o usarlos durante la compilación. La ruta de acceso se puede especificar como una ruta de acceso absoluta o una ruta relativa al directorio del lugar de trabajo.
Etiquetas:loading_and_analysis
- 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 fallar Bazel con un OOM. Cada límite se especifica como <period>:<count>, donde el período es una duración y el recuento es un número entero positivo. Si más del --gc_thrashing_threshold por ciento del espacio titular (montón de generación anterior) permanece ocupado después de <count> GC completas consecutivas dentro de <period>, se activa una 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"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje de montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC completo, descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos de GC completos nunca activarán disminuciones. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de recolección de elementos no utilizados completo y se supere el umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje de montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC menor, descartará el estado temporal innecesario de Skyframe, hasta esta cantidad por invocación. El valor predeterminado es Integer.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos menores de GC nunca activarán disminuciones. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento menor de recolección de elementos no utilizados y se supere el umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje retenido de montón está al menos en este umbral, descartará el estado temporal innecesario de Skyframe. Un ajuste puede permitirte mitigar el impacto de la hiperpaginación de la GC en el tiempo, cuando esta (i) causa el uso de memoria de este estado temporal y (ii) es más costosa que reconstruir el estado cuando es necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Configuración predeterminada de
--experimental_command_profile=<cpu, wall, alloc or lock>
: ver descripción - Registra un perfil de grabadora de vuelo de Java mientras dure el comando. Se debe proporcionar uno de los tipos de eventos de generación de perfiles admitidos (cpu, muro, alloc o bloqueo) como argumento. El perfil se escribe en un archivo con el nombre del tipo de evento en el directorio base de salida. La sintaxis y semántica de esta marca podría cambiar en el futuro para admitir tipos de perfil o formatos de salida adicionales; úsala bajo tu responsabilidad.
--[no]experimental_record_metrics_for_all_mnemonics
valor predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán estadísticas para todos los mnemotécnicos.
--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
- Opciones que especifican o modifican 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é remoto:
- Configuración predeterminada de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo para configurar el cargador 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 con el que debe coincidir y otro para usar como URL sustitutiva, con referencias inversas que comienzan con "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL, y se mostrarán varias URL.
- Valor predeterminado de
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "auto" - Es el modo de subprocesos que se usará para la recuperación del repositorio. Si se configura en “off”, no se usa ningún subproceso de trabajo y la recuperación del repositorio está sujeta a reinicios. De lo contrario, utiliza un subproceso de plataforma (es decir, subproceso del SO) si se configura como “platform” o un subproceso virtual si se establece como “virtual”. Si se configura como "auto", se usan subprocesos virtuales si están disponibles (es decir, se ejecutan en JDK 21 y versiones posteriores); de lo contrario, no se usan subprocesos de trabajo.
- Opciones varias, que no están categorizadas:
- Se acumulan
--deleted_packages=<comma-separated list of package names>
usos múltiples - Una lista separada por comas de los nombres de los paquetes que el sistema de compilación considerará que no existen, incluso si están visibles en algún lugar de la ruta del paquete. Usa esta opción cuando borres un subpaquete 'x/y' de un paquete 'x' existente. Por ejemplo, después de borrar x/y/BUILD en el cliente, el sistema de compilación puede presentar un reclamo si encuentra la etiqueta '//x:y/z' si todavía la proporciona otra entrada package_path. Si especificas --deleted_packages x/y se evita este problema.
- El valor predeterminado de
--[no]fetch
es "true" (verdadero). - Permite que el comando recupere dependencias externas. Si se establece como falsa, el comando usará cualquier versión almacenada en caché de la dependencia. Si no existe ninguna, el comando fallará.
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
--package_path=<colon-separated list of options>
predeterminado: "%workspace%"- Una lista separada por dos puntos sobre dónde buscar paquetes. Los elementos que comienzan con "%workspace%" son relativos al lugar de trabajo que lo contiene. Si se omite o está vacío, el valor predeterminado es el resultado de “bazel info default-package-path”.
- El valor predeterminado de
--[no]show_loading_progress
es "true" (verdadero). - Si se habilita, hace que Bazel imprima mensajes "Cargando paquete:".
Opciones de pruebas
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Más lugares donde buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
valor predeterminado: "false"-
Si se configura, la caché del repositorio vinculará el archivo de forma fija en caso de un acierto de caché, en lugar de copiar. Esto sirve para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Usa este factor para escalar todos los tiempos de espera en las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que sean 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 para descargas de http.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--http_connector_retry_max_timeout=<An immutable length of time.>
: "0 s" -
Es el tiempo de espera máximo para los reintentos de descarga de HTTP. Con el valor 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 descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación en caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché; de lo contrario, se usa el valor predeterminado “<output_user_root>/cache/repos/v1”
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
valor predeterminado: "false"-
Si se establece esta configuración, no se permitirá la descarga con ="{.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no está completamente deshabilitado; ="{.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"-
Indica el porcentaje de espacio ocupado (0-100) por encima del cual GcThrashingDetector considera los eventos de presión de la memoria en función de sus límites (--gc_thrashing_limits). Si se configura en 100, GcThrashingDetector se inhabilita.
Etiquetas:host_machine_resource_optimizations
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE.:
- El valor predeterminado de
--[no]incompatible_depset_for_java_output_source_jars
es "true" (verdadero). -
No-ops
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_new_actions_api
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,incompatible_change
- El valor predeterminado de
--[no]incompatible_visibility_private_attributes_at_definition
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,incompatible_change
- El valor predeterminado de
--[no]separate_aspect_deps
es "true" (verdadero). -
No-op
Etiquetas:no_op
- Opciones relacionadas con la semántica y el resultado de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Especificaste las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirá en el gráfico de dependencias resueltas incluso si se declararon de forma privada en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones anteriores harán que la resolución falle. También puedes definir la versión transferida 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
- El valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
es "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 una falla de resolución, “off” para inhabilitar la verificación o “warning” para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas `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 detecte una discrepancia o “error” para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
valor predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
valor predeterminado: "actualizar"-
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son “update” para usar el archivo de bloqueo y actualizarlo si hay cambios; “error” para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o “off” para no leerlo ni escribirlo en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y se recurrirá únicamente a los posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Configuración predeterminada de
--vendor_dir=<a path>
: ver descripción -
Especifica el directorio que debe contener los repositorios externos en modo de proveedor, ya sea con el fin de recuperarlos o usarlos durante la compilación. La ruta de acceso se puede especificar como una ruta de acceso absoluta o una ruta relativa al directorio del lugar de trabajo.
Etiquetas:loading_and_analysis
- 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 fallar Bazel con un OOM. Cada límite se especifica como <period>:<count>, donde el período es una duración y el recuento es un número entero positivo. Si más del --gc_thrashing_threshold por ciento del espacio titular (montón de generación anterior) permanece ocupado después de <count> GC completas consecutivas dentro de <period>, se activa una 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"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje de montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC completo, descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos de GC completos nunca activarán disminuciones. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de recolección de elementos no utilizados completo y se supere el umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje de montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC menor, descartará el estado temporal innecesario de Skyframe, hasta esta cantidad por invocación. El valor predeterminado es Integer.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos menores de GC nunca activarán disminuciones. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento menor de recolección de elementos no utilizados y se supere el umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje retenido de montón está al menos en este umbral, descartará el estado temporal innecesario de Skyframe. Un ajuste puede permitirte mitigar el impacto de la hiperpaginación de la GC en el tiempo, cuando esta (i) causa el uso de memoria de este estado temporal y (ii) es más costosa que reconstruir el estado cuando es necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Configuración predeterminada de
--experimental_command_profile=<cpu, wall, alloc or lock>
: ver descripción - Registra un perfil de grabadora de vuelo de Java mientras dure el comando. Se debe proporcionar uno de los tipos de eventos de generación de perfiles admitidos (cpu, muro, alloc o bloqueo) como argumento. El perfil se escribe en un archivo con el nombre del tipo de evento en el directorio base de salida. La sintaxis y semántica de esta marca podría cambiar en el futuro para admitir tipos de perfil o formatos de salida adicionales; úsala bajo tu responsabilidad.
--[no]experimental_record_metrics_for_all_mnemonics
valor predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán estadísticas para todos los mnemotécnicos.
--[no]print_relative_test_log_paths
valor predeterminado: "false"-
Si es verdadero, cuando imprimas la ruta de acceso a un registro de pruebas, usa una ruta de acceso relativa que use el symlink de conveniencia “testlogs”. Nota importante: Una invocación de “build'/'test'/etc. con una configuración diferente puede hacer que cambie el destino de este symlink, lo que hace que la ruta de acceso impresa antes ya no sea útil.
Etiquetas:affects_outputs
--[no]test_verbose_timeout_warnings
valor predeterminado: "false"-
Si es "true", imprimir advertencias adicionales cuando el tiempo de ejecución de la prueba real no coincida con el tiempo de espera definido por la prueba (ya sea implícito o explícito).
Etiquetas:affects_outputs
- El valor predeterminado de
--[no]verbose_test_summary
es "true" (verdadero). -
Si es "true", imprime información adicional (tiempo, cantidad de ejecuciones con errores, etc.) en el resumen de la prueba.
Etiquetas:affects_outputs
- Opciones que especifican o modifican 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é remoto:
- Configuración predeterminada de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo para configurar el cargador 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 con el que debe coincidir y otro para usar como URL sustitutiva, con referencias inversas que comienzan con "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL, y se mostrarán varias URL.
- Valor predeterminado de
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "auto" - Es el modo de subprocesos que se usará para la recuperación del repositorio. Si se configura en “off”, no se usa ningún subproceso de trabajo y la recuperación del repositorio está sujeta a reinicios. De lo contrario, utiliza un subproceso de plataforma (es decir, subproceso del SO) si se configura como “platform” o un subproceso virtual si se establece como “virtual”. Si se configura como "auto", se usan subprocesos virtuales si están disponibles (es decir, se ejecutan en JDK 21 y versiones posteriores); de lo contrario, no se usan subprocesos de trabajo.
- Opciones varias, que no están categorizadas:
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
Opciones de proveedores
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Más lugares donde buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
valor predeterminado: "false"-
Si se configura, la caché del repositorio vinculará el archivo de forma fija en caso de un acierto de caché, en lugar de copiar. Esto sirve para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Usa este factor para escalar todos los tiempos de espera en las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que sean 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 para descargas de http.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--http_connector_retry_max_timeout=<An immutable length of time.>
: "0 s" -
Es el tiempo de espera máximo para los reintentos de descarga de HTTP. Con el valor 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 descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación en caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché; de lo contrario, se usa el valor predeterminado “<output_user_root>/cache/repos/v1”
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
valor predeterminado: "false"-
Si se establece esta configuración, no se permitirá la descarga con ="{.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no está completamente deshabilitado; ="{.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"-
Indica el porcentaje de espacio ocupado (0-100) por encima del cual GcThrashingDetector considera los eventos de presión de la memoria en función de sus límites (--gc_thrashing_limits). Si se configura en 100, GcThrashingDetector se inhabilita.
Etiquetas:host_machine_resource_optimizations
--[no]keep_going
[-k
] predeterminado: "false"-
Continúa tanto como sea posible después de un error. Si bien el objetivo que falló y aquellos que dependen de él no se pueden analizar, otros requisitos previos de estos objetivos pueden serlo.
Etiquetas:eagerness_to_exit
- Valor predeterminado de
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "auto" -
Cantidad de subprocesos paralelos que se usarán en la fase de carga o análisis. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguido 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 de Starlark o la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility
valor predeterminado: "false"-
Si es incompatible_enforce_config_setting_visibility=false, esta es una noop. De lo contrario, si la 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
- El valor predeterminado de
--[no]incompatible_depset_for_java_output_source_jars
es "true" (verdadero). -
No-ops
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_enforce_config_setting_visibility
es "true" (verdadero). -
Si es verdadero, aplica restricciones de visibilidad config_setting. Si es falso, cada config_setting es visible para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_new_actions_api
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,incompatible_change
- El valor predeterminado de
--[no]incompatible_visibility_private_attributes_at_definition
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,incompatible_change
- El valor predeterminado de
--[no]separate_aspect_deps
es "true" (verdadero). -
No-op
Etiquetas:no_op
- Opciones relacionadas con la semántica y el resultado de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Especificaste las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirá en el gráfico de dependencias resueltas incluso si se declararon de forma privada en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones anteriores harán que la resolución falle. También puedes definir la versión transferida 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
- El valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
es "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 una falla de resolución, “off” para inhabilitar la verificación o “warning” para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas `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 detecte una discrepancia o “error” para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
valor predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
valor predeterminado: "actualizar"-
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son “update” para usar el archivo de bloqueo y actualizarlo si hay cambios; “error” para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o “off” para no leerlo ni escribirlo en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y se recurrirá únicamente a los posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Se acumulan
--repo=<a string>
usos múltiples -
Solo proveedores del repositorio especificado, que puede ser `@apparent_repo_name` o `@@canonical_repo_name`. Esta opción se puede configurar varias veces
Tags:changes_inputs
- Configuración predeterminada de
--vendor_dir=<a path>
: ver descripción -
Especifica el directorio que debe contener los repositorios externos en modo de proveedor, ya sea con el fin de recuperarlos o usarlos durante la compilación. La ruta de acceso se puede especificar como una ruta de acceso absoluta o una ruta relativa al directorio del lugar de trabajo.
Etiquetas:loading_and_analysis
- 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 fallar Bazel con un OOM. Cada límite se especifica como <period>:<count>, donde el período es una duración y el recuento es un número entero positivo. Si más del --gc_thrashing_threshold por ciento del espacio titular (montón de generación anterior) permanece ocupado después de <count> GC completas consecutivas dentro de <period>, se activa una 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"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje de montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC completo, descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos de GC completos nunca activarán disminuciones. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de recolección de elementos no utilizados completo y se supere el umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje de montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC menor, descartará el estado temporal innecesario de Skyframe, hasta esta cantidad por invocación. El valor predeterminado es Integer.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos menores de GC nunca activarán disminuciones. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento menor de recolección de elementos no utilizados y se supere el umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje retenido de montón está al menos en este umbral, descartará el estado temporal innecesario de Skyframe. Un ajuste puede permitirte mitigar el impacto de la hiperpaginación de la GC en el tiempo, cuando esta (i) causa el uso de memoria de este estado temporal y (ii) es más costosa que reconstruir el estado cuando es necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Configuración predeterminada de
--experimental_command_profile=<cpu, wall, alloc or lock>
: ver descripción - Registra un perfil de grabadora de vuelo de Java mientras dure el comando. Se debe proporcionar uno de los tipos de eventos de generación de perfiles admitidos (cpu, muro, alloc o bloqueo) como argumento. El perfil se escribe en un archivo con el nombre del tipo de evento en el directorio base de salida. La sintaxis y semántica de esta marca podría cambiar en el futuro para admitir tipos de perfil o formatos de salida adicionales; úsala bajo tu responsabilidad.
--[no]experimental_record_metrics_for_all_mnemonics
valor predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán estadísticas para todos los mnemotécnicos.
- 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é remoto:
- Configuración predeterminada de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo para configurar el cargador 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 con el que debe coincidir y otro para usar como URL sustitutiva, con referencias inversas que comienzan con "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL, y se mostrarán varias URL.
- Valor predeterminado de
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "auto" - Es el modo de subprocesos que se usará para la recuperación del repositorio. Si se configura en “off”, no se usa ningún subproceso de trabajo y la recuperación del repositorio está sujeta a reinicios. De lo contrario, utiliza un subproceso de plataforma (es decir, subproceso del SO) si se configura como “platform” o un subproceso virtual si se establece como “virtual”. Si se configura como "auto", se usan subprocesos virtuales si están disponibles (es decir, se ejecutan en JDK 21 y versiones posteriores); de lo contrario, no se usan subprocesos de trabajo.
- Opciones varias, que no están categorizadas:
- Se acumulan
--deleted_packages=<comma-separated list of package names>
usos múltiples - Una lista separada por comas de los nombres de los paquetes que el sistema de compilación considerará que no existen, incluso si están visibles en algún lugar de la ruta del paquete. Usa esta opción cuando borres un subpaquete 'x/y' de un paquete 'x' existente. Por ejemplo, después de borrar x/y/BUILD en el cliente, el sistema de compilación puede presentar un reclamo si encuentra la etiqueta '//x:y/z' si todavía la proporciona otra entrada package_path. Si especificas --deleted_packages x/y se evita este problema.
- El valor predeterminado de
--[no]fetch
es "true" (verdadero). - Permite que el comando recupere dependencias externas. Si se establece como falsa, el comando usará cualquier versión almacenada en caché de la dependencia. Si no existe ninguna, el comando fallará.
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
--package_path=<colon-separated list of options>
predeterminado: "%workspace%"- Una lista separada por dos puntos sobre dónde buscar paquetes. Los elementos que comienzan con "%workspace%" son relativos al lugar de trabajo que lo contiene. Si se omite o está vacío, el valor predeterminado es el resultado de “bazel info default-package-path”.
- El valor predeterminado de
--[no]show_loading_progress
es "true" (verdadero). - Si se habilita, hace que Bazel imprima mensajes "Cargando paquete:".
Opciones de versión
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Más lugares donde buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
valor predeterminado: "false"-
Si se configura, la caché del repositorio vinculará el archivo de forma fija en caso de un acierto de caché, en lugar de copiar. Esto sirve para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Usa este factor para escalar todos los tiempos de espera en las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que sean 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 para descargas de http.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--http_connector_retry_max_timeout=<An immutable length of time.>
: "0 s" -
Es el tiempo de espera máximo para los reintentos de descarga de HTTP. Con el valor 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 descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación en caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché; de lo contrario, se usa el valor predeterminado “<output_user_root>/cache/repos/v1”
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
valor predeterminado: "false"-
Si se establece esta configuración, no se permitirá la descarga con ="{.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no está completamente deshabilitado; ="{.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"-
Indica el porcentaje de espacio ocupado (0-100) por encima del cual GcThrashingDetector considera los eventos de presión de la memoria en función de sus límites (--gc_thrashing_limits). Si se configura en 100, GcThrashingDetector se inhabilita.
Etiquetas:host_machine_resource_optimizations
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
--[no]gnu_format
valor predeterminado: "false"-
Si se configura, escribe la versión en stdout usando las convenciones descritas en los estándares de GNU.
Etiquetas:affects_outputs
,execution
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE.:
- El valor predeterminado de
--[no]incompatible_depset_for_java_output_source_jars
es "true" (verdadero). -
No-ops
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_new_actions_api
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,incompatible_change
- El valor predeterminado de
--[no]incompatible_visibility_private_attributes_at_definition
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,incompatible_change
- El valor predeterminado de
--[no]separate_aspect_deps
es "true" (verdadero). -
No-op
Etiquetas:no_op
- Opciones relacionadas con la semántica y el resultado de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Especificaste las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirá en el gráfico de dependencias resueltas incluso si se declararon de forma privada en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones anteriores harán que la resolución falle. También puedes definir la versión transferida 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
- El valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
es "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 una falla de resolución, “off” para inhabilitar la verificación o “warning” para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas `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 detecte una discrepancia o “error” para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
valor predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update or error>
valor predeterminado: "actualizar"-
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son “update” para usar el archivo de bloqueo y actualizarlo si hay cambios; “error” para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o “off” para no leerlo ni escribirlo en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y se recurrirá únicamente a los posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Configuración predeterminada de
--vendor_dir=<a path>
: ver descripción -
Especifica el directorio que debe contener los repositorios externos en modo de proveedor, ya sea con el fin de recuperarlos o usarlos durante la compilación. La ruta de acceso se puede especificar como una ruta de acceso absoluta o una ruta relativa al directorio del lugar de trabajo.
Etiquetas:loading_and_analysis
- 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 fallar Bazel con un OOM. Cada límite se especifica como <period>:<count>, donde el período es una duración y el recuento es un número entero positivo. Si más del --gc_thrashing_threshold por ciento del espacio titular (montón de generación anterior) permanece ocupado después de <count> GC completas consecutivas dentro de <period>, se activa una 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"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje de montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC completo, descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos de GC completos nunca activarán disminuciones. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de recolección de elementos no utilizados completo y se supere el umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje de montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC menor, descartará el estado temporal innecesario de Skyframe, hasta esta cantidad por invocación. El valor predeterminado es Integer.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos menores de GC nunca activarán disminuciones. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento menor de recolección de elementos no utilizados y se supere el umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje retenido de montón está al menos en este umbral, descartará el estado temporal innecesario de Skyframe. Un ajuste puede permitirte mitigar el impacto de la hiperpaginación de la GC en el tiempo, cuando esta (i) causa el uso de memoria de este estado temporal y (ii) es más costosa que reconstruir el estado cuando es necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Configuración predeterminada de
--experimental_command_profile=<cpu, wall, alloc or lock>
: ver descripción - Registra un perfil de grabadora de vuelo de Java mientras dure el comando. Se debe proporcionar uno de los tipos de eventos de generación de perfiles admitidos (cpu, muro, alloc o bloqueo) como argumento. El perfil se escribe en un archivo con el nombre del tipo de evento en el directorio base de salida. La sintaxis y semántica de esta marca podría cambiar en el futuro para admitir tipos de perfil o formatos de salida adicionales; úsala bajo tu responsabilidad.
--[no]experimental_record_metrics_for_all_mnemonics
valor predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán estadísticas para todos los mnemotécnicos.
- 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é remoto:
- Configuración predeterminada de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo para configurar el cargador 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 con el que debe coincidir y otro para usar como URL sustitutiva, con referencias inversas que comienzan con "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL, y se mostrarán varias URL.
- Valor predeterminado de
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "auto" - Es el modo de subprocesos que se usará para la recuperación del repositorio. Si se configura en “off”, no se usa ningún subproceso de trabajo y la recuperación del repositorio está sujeta a reinicios. De lo contrario, utiliza un subproceso de plataforma (es decir, subproceso del SO) si se configura como “platform” o un subproceso virtual si se establece como “virtual”. Si se configura como "auto", se usan subprocesos virtuales si están disponibles (es decir, se ejecutan en JDK 21 y versiones posteriores); de lo contrario, no se usan subprocesos de trabajo.
- Opciones varias, que no están categorizadas:
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
Etiquetas de efecto de la opción
unknown |
Esta opción tiene un efecto desconocido o no documentado. |
no_op |
Esta opción literalmente no tiene efecto. |
loses_incremental_state |
Cambiar el valor de esta opción puede causar una pérdida significativa del estado incremental, lo que ralentiza las compilaciones. El estado podría perderse debido a un reinicio del servidor o a la invalidación de una gran parte del gráfico de dependencias. |
changes_inputs |
Esta opción cambia de forma activa las entradas que Bazel considera para la compilación, como restricciones del sistema de archivos, versiones del repositorio y otras opciones. |
affects_outputs |
Esta opción afecta las salidas de Bazel. Esta etiqueta es intencionalmente amplia, puede incluir efectos transitivos y no especifica el tipo de salida que afecta. |
build_file_semantics |
Esta opción afecta la semántica de los archivos BUILD o .bzl. |
bazel_internal_configuration |
Esta opción afecta la configuración de la maquinaria interna de Bazel. Por sí sola, esta etiqueta no significa que los artefactos de compilación se vean afectados. |
loading_and_analysis |
Esta opción afecta la carga y el análisis de dependencias, y la compilación del gráfico de dependencias. |
execution |
Esta opción afecta la fase de ejecución, como las opciones relacionadas con 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 una máquina y no garantiza su funcionamiento en todas ellas. La optimización puede incluir una compensación con otros aspectos del rendimiento, como el costo de CPU o memoria. |
eagerness_to_exit |
Esta opción cambia la anticipación con la que Bazel sale de una falla, en la que existe la opción de 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 la línea de comandos de una o más acciones de compilación. |
test_runner |
Esta opción cambia el entorno del ejecutor de pruebas de la compilación. |
Etiquetas de metadatos de opción
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 tu preparación para la migración o para obtener acceso anticipado a la función nueva |
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. |
immutable |
Esta opción no se puede cambiar en una transición. |