bazel [<startup options>] <command> [<args>]
bazel [<startup options>] <command> [<args>] -- [<target patterns>]
Sintaxis de la opción
Las opciones se pueden pasar a Bazel de diferentes maneras. Opciones que requieren un valor se puede pasar con un signo igual o un espacio:
--<option>=<value> --<option> <value>
-<short_form> <value>
Las opciones booleanas se pueden habilitar de la siguiente manera:
--<option> --<option>=[true|yes|1]
--no<option> --<option>=[false|no|0]
Las opciones de triestado suelen establecerse como automáticas de forma predeterminada y pueden forzar la habilitación de la siguiente manera:
--<option>=[true|yes|1]
--no<option> --<option>=[false|no|0]
Comandos
analyze-profile |
Analiza los datos del perfil de compilación. |
aquery |
Analiza los objetivos dados y consulta el gráfico de acciones. |
build |
Compila los destinos especificados. |
canonicalize-flags |
Canonicaliza una lista de opciones de Bazel. |
clean |
Quita los archivos de salida y, de manera opcional, detiene el servidor. |
coverage |
Genera un informe de cobertura de código para los objetivos de prueba especificados. |
cquery |
Carga, analiza y consulta los destinos especificados con los parámetros de configuración. |
dump |
Vuelca el estado interno del proceso del servidor de Bazel. |
fetch |
Recupera repositorios externos que son requisitos previos para los destinos. |
help |
Imprime ayuda para comandos o el índice. |
info |
Muestra información del entorno de ejecución sobre el servidor de Bazel. |
license |
Imprime la licencia de este software. |
mobile-install |
Instala orientaciones en dispositivos móviles. |
mod |
Consulta el gráfico de dependencia externa de Bzlmod |
print_action |
Imprime los argumentos de la línea de comandos para compilar un archivo. |
query |
Ejecuta una consulta de grafo de dependencia. |
run |
Ejecuta el destino especificado. |
shutdown |
Detiene el servidor de Bazel. |
sync |
Sincroniza todos los repositorios especificados en el archivo del espacio de trabajo. |
test |
Compila y ejecuta los objetivos de prueba especificados. |
vendor |
Recupera repositorios externos en una carpeta específica especificada por la marca --vendor_dir. |
version |
Imprime información de la versión para Bazel. |
Opciones de inicio
- Opciones que aparecen antes del comando y que el cliente analiza:
- Valor predeterminado de
--[no]autodetect_server_javabase
: "true" -
Cuando se pasa --noautodetect_server_javabase, Bazel no recurre al JDK local para ejecutar el servidor de Bazel y, en su lugar, sale.
Etiquetas:affects_outputs
yloses_incremental_state
- Valor predeterminado de
--[no]batch
: "falso" -
Si se configura, Bazel se ejecutará como un proceso de cliente sin un servidor, en lugar de en el modo estándar de cliente/servidor. Esta función dejó de estar disponible y se quitará. Para evitar que queden servidores, es preferible que apagues el servidor de forma explícita.
Etiquetas:loses_incremental_state
,bazel_internal_configuration
ydeprecated
- Valor predeterminado de
--[no]batch_cpu_scheduling
: "falso" -
Solo en Linux; usar “lote” programación de CPU para Blaze. Esta política es útil para cargas de trabajo que no son interactivas, pero que no desean reducir su valor atractivo. Consulta 'man 2 sched_setscheduler'. Si es falso, Bazel no realiza una llamada al sistema.
Etiquetas:host_machine_resource_optimizations
- Valor predeterminado de
--bazelrc=<path>
: ver descripción -
La ubicación del archivo .bazelrc del usuario que contiene los valores predeterminados de las opciones de Bazel. /dev/null indica que se ignorarán todos los demás `--bazelrc`, lo que es útil para inhabilitar la búsqueda de un archivo rc del usuario, p.ej., en compilaciones de lanzamiento.
Esta opción también se puede especificar varias veces.
P.ej., con `--bazelrc=x.rc --bazelrc=y.rc --bazelrc=/dev/null --bazelrc=z.rc`,
1) Se leen x.rc y y.rc.
2) z.rc se ignora debido al valor /dev/null anterior.
Si no se especifica, Bazel usa el primer archivo .bazelrc que encuentra en las siguientes dos ubicaciones: el directorio del espacio de trabajo y, luego, el directorio principal del usuario.
Nota: Las opciones de línea de comandos siempre reemplazarán a cualquier opción en bazelrc.
Etiquetas:changes_inputs
- Valor predeterminado de
--[no]block_for_lock
: "true" -
Cuando se pasa --noblock_for_lock, Bazel no espera a que se complete un comando en ejecución, sino que sale de inmediato.
Etiquetas:eagerness_to_exit
- Valor predeterminado de
--[no]client_debug
: "falso" -
Si es verdadero, registra la información de depuración del cliente en stderr. Cambiar esta opción no hará que el servidor se reinicie.
Etiquetas:affects_outputs
ybazel_monitoring
- Valor predeterminado de
--connect_timeout_secs=<an integer>
: "30" -
La cantidad de tiempo que el cliente espera cada intento de conexión al servidor
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--digest_function=<hash function>
: ver descripción -
La función hash que se usará para procesar resúmenes de archivos.
Etiquetas:loses_incremental_state
ybazel_internal_configuration
- Valor predeterminado de
--[no]expand_configs_in_place
: "true" -
Se cambió la expansión de las marcas --config para que se realicen de manera local, en lugar de una expansión de punto fija entre las opciones de rc normales y las opciones especificadas en la línea de comandos.
Etiquetas:no_op
ydeprecated
- Valor predeterminado de
--failure_detail_out=<path>
: ver descripción -
Si se configura, especifica una ubicación para escribir un mensaje protobuf failed_detail si el servidor experimenta una falla y no puede informarlo a través de gRPC, como de costumbre. De lo contrario, la ubicación será ${OUTPUT_BASE}/failure_detail.rawproto.
Etiquetas:affects_outputs
yloses_incremental_state
- Valor predeterminado de
--[no]home_rc
: "true" -
Indica si se debe buscar o no el archivo bazelrc de inicio en $HOME/.bazelrc
Etiquetas:changes_inputs
- Valor predeterminado de
--[no]idle_server_tasks
: "true" -
Ejecuta System.gc() cuando el servidor está inactivo
Etiquetas:loses_incremental_state
yhost_machine_resource_optimizations
- Valor predeterminado de
--[no]ignore_all_rc_files
: "falso" -
Inhabilita todos los archivos rc, independientemente de los valores de otras marcas de modificación de rc, incluso si estas marcas aparecen más adelante en la lista de opciones de inicio.
Etiquetas:changes_inputs
- Valor predeterminado de
--io_nice_level={-1,0,1,2,3,4,5,6,7}
: "-1" -
Solo en Linux; establece un nivel de 0 a 7 para la mejor programación de IO con la llamada del sistema sys_ioprio_set. 0 es la prioridad más alta, 7 es la menor. El programador anticipado solo puede respetar hasta la prioridad 4. Si se establece en un valor negativo, Bazel no realizará una llamada al sistema.
Etiquetas:host_machine_resource_optimizations
- Valor predeterminado de
--local_startup_timeout_secs=<an integer>
: "120" -
La cantidad máxima de tiempo que el cliente espera para conectarse al servidor
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--macos_qos_class=<a string>
: “predeterminado” -
Establece la clase de servicio QoS del servidor de Bazel cuando se ejecuta en macOS. Esta marca no tiene efecto en todas las demás plataformas, pero es compatible para garantizar que los archivos rc se puedan compartir entre ellas sin cambios. Los valores posibles son: interactivo por el usuario, iniciado por el usuario, predeterminado, de utilidad y segundo plano.
Etiquetas:host_machine_resource_optimizations
- Valor predeterminado de
--max_idle_secs=<integer>
: "10800" -
La cantidad de segundos que el servidor de compilación esperará inactivo antes de apagarse. Cero significa que el servidor nunca se apagará. Esto solo se lee cuando se inicia el servidor; cambiar esta opción no hará que el servidor se reinicie.
Etiquetas:eagerness_to_exit
yloses_incremental_state
- Valor predeterminado de
--output_base=<path>
: ver descripción -
Si se configura, especifica la ubicación de salida en la que se escribirán todos los resultados de la compilación. De lo contrario, la ubicación será ${OUTPUT_ROOT}/_blaze_${USER}/${MD5_OF_WORKSPACE_ROOT}. Nota: Si especificas una opción diferente de una a la siguiente invocación de Bazel para este valor, es probable que inicies un nuevo servidor de Bazel adicional. Bazel inicia exactamente un servidor por base de salida especificada. Por lo general, hay una base de salida por lugar de trabajo; sin embargo, con esta opción, puedes tener varias bases de salida por lugar de trabajo y, por lo tanto, ejecutar varias compilaciones para el mismo cliente en la misma máquina de forma simultánea. Consulta la sección "Ayuda de Bazel para apagar" sobre cómo apagar un servidor de Bazel.
Etiquetas:affects_outputs
yloses_incremental_state
- Valor predeterminado de
--output_user_root=<path>
: ver descripción -
El directorio específico del usuario en el que se escriben todos los resultados de compilación. De forma predeterminada, esta es una función de $USER, pero si se especifica una constante, los resultados de la compilación se pueden compartir entre los usuarios que colaboran.
Etiquetas:affects_outputs
yloses_incremental_state
- Valor predeterminado de
--[no]preemptible
: "falso" -
Si es verdadero, el comando se puede interrumpir si se inicia otro comando.
Etiquetas:eagerness_to_exit
- Valor predeterminado de
--server_jvm_out=<path>
: ver descripción -
La ubicación para escribir la salida de JVM del servidor. Si no se configura, se establece de forma predeterminada en una ubicación en output_base.
Etiquetas:affects_outputs
yloses_incremental_state
- Valor predeterminado de
--[no]shutdown_on_low_sys_mem
: "falso" -
Si se configura max_idle_secs y el servidor de compilación ha estado inactivo durante un tiempo, apaga el servidor cuando el sistema tenga poca memoria RAM libre. Solo en Linux.
Etiquetas:eagerness_to_exit
yloses_incremental_state
- Valor predeterminado de
--[no]system_rc
: "true" -
Indica si se debe buscar bazelrc en todo el sistema.
Etiquetas:changes_inputs
- Valor predeterminado de
--[no]unlimit_coredumps
: "falso" -
Aumenta el límite de soft coredump al límite estricto para hacer posibles volcados de núcleos del servidor (incluida la JVM) y del cliente en condiciones comunes. Pega esta marca en bazelrc una vez y olvídate de ella para obtener volcados de memoria cuando encuentres una condición que los active.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]watchfs
: "falso" -
Si es verdadero, Bazel intenta usar el servicio de análisis de archivos del sistema operativo para detectar cambios locales, en lugar de analizar cada archivo en busca de cambios.
Etiquetas:deprecated
- Valor predeterminado de
--[no]windows_enable_symlinks
: "falso" -
Si esta preferencia se establece como "true", se crearán vínculos simbólicos reales en Windows en lugar de copiar archivos. Requiere que se habilite el modo de desarrollador de Windows y Windows 10 1703 o versiones posteriores.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]workspace_rc
: "true" -
Indica si se debe buscar o no el archivo bazelrc de Workspace en $workspace/.bazelrc.
Etiquetas:changes_inputs
- Otras opciones, sin categorizar:
- Se acumulan
--host_jvm_args=<jvm_arg>
usos múltiples - Son marcas para pasar a la JVM que ejecuta Blaze.
--host_jvm_debug
-
Una opción conveniente para agregar algunos marcadores de inicio de JVM adicionales, que hacen que la JVM espere durante el inicio hasta que te conectes desde un depurador compatible con JDWP (como Eclipse) al puerto 5005.
Se expande a:
--host_jvm_args=-Xdebug
--host_jvm_args=-Xrunjdwp:transport=dt_socket,server=y,address=5005
.
- Valor predeterminado de
--host_jvm_profile=<profiler_name>
: "" - Opción conveniente para agregar algunas marcas de inicio de JVM específicas del generador de perfiles/depurador. Bazel tiene una lista de valores conocidos que la asigna a marcas de inicio de JVM codificadas, posiblemente en busca de rutas de acceso codificadas para ciertos archivos.
- Valor predeterminado de
--server_javabase=<jvm path>
: "" - Es la ruta de acceso a la JVM que se usa para ejecutar Bazel.
Opciones comunes para todos los comandos
- Opciones que controlan la ejecución de compilación:
--experimental_ui_max_stdouterr_bytes=<an integer in (-1)-1073741819 range>
predeterminado: “1048576”-
El tamaño máximo de los archivos stdout / stderr que se imprimirán en la consola. -1 implica que no hay límite.
Etiquetas:execution
- Valor predeterminado de
--[no]incompatible_remote_dangling_symlinks
: "true" -
Si la estableces como verdadera, se podrán colgar los symlinks subidos a una caché de disco o remota.
Etiquetas:execution
yincompatible_change
- Valor predeterminado de
--[no]incompatible_remote_symlinks
: "true" -
Si se configura como verdadera, Bazel siempre subirá symlinks como tales a una caché remota o de disco. De lo contrario, se subirán los symlinks relacionados que no son de vinculación (y solo esos) como el archivo o directorio al que apunten.
Etiquetas:execution
yincompatible_change
- Opciones que configuran la cadena de herramientas utilizada para la ejecución de la acción:
- Valor predeterminado de
--[no]incompatible_enable_proto_toolchain_resolution
: "falso" -
Si es verdadero, las reglas proto lang definen conjuntos de herramientas desde los repositorios rules_proto, rules_java y rules_cc.
Etiquetas:loading_and_analysis
yincompatible_change
- Opciones que permiten al usuario configurar el resultado previsto y que afectan su valor, en lugar de su existencia:
- Valor predeterminado de
--bep_maximum_open_remote_upload_files=<an integer>
: "-1" -
Cantidad máxima de archivos abiertos permitidos durante la carga del artefacto de BEP.
Etiquetas:affects_outputs
--remote_download_all
-
Descarga todas las salidas remotas en la máquina local. Esta marca es un alias de --remote_download_outputs=all.
Se expande a:
--remote_download_outputs=all
Etiquetas:affects_outputs
--remote_download_minimal
-
No descarga ningún resultado de compilación remota en la máquina local. Esta marca es un alias de --remote_download_outputs=minimal.
Se expande a:
--remote_download_outputs=minimal
Etiquetas:affects_outputs
--remote_download_outputs=<all, minimal or toplevel>
predeterminado: “nivel superior”-
Si está establecido en “mínimo” No se descargan resultados de compilación remota en la máquina local, excepto los que requieren las acciones locales. Si se establece como "toplevel" se comporta como “mínimo” excepto que también descarga resultados de objetivos de nivel superior en la máquina local. Ambas opciones pueden reducir significativamente los tiempos de compilación si el ancho de banda de la red es un cuello de botella.
Etiquetas:affects_outputs
- Valor predeterminado de
--remote_download_symlink_template=<a string>
: "" -
En lugar de descargar resultados de compilación remotos en la máquina local, crea vínculos simbólicos. El objetivo de los vínculos simbólicos se puede especificar en el formato de una cadena de plantilla. Esta cadena de plantilla puede contener {hash} y {size_bytes} que se expanden al hash del objeto y al tamaño en bytes, respectivamente. Estos vínculos simbólicos pueden, por ejemplo, apuntar a un sistema de archivos FUSE que carga objetos desde CAS a pedido.
Etiquetas:affects_outputs
--remote_download_toplevel
-
Solo descarga las salidas remotas de los objetivos de nivel superior en la máquina local. Esta marca es un alias de --remote_download_outputs=toplevel.
Se expande a:
--remote_download_outputs=toplevel
Etiquetas:affects_outputs
- Se acumulan
--repo_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica las variables de entorno adicionales que estén disponibles solo para las reglas del repositorio. Ten en cuenta que las reglas del repositorio ven el entorno completo de todos modos, pero, de esta manera, la información de configuración puede pasarse a los repositorios a través de las opciones sin invalidar el gráfico de acciones.
Etiquetas:action_command_lines
- Opciones que afectan la precisión con la que Bazel aplica entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
- Valor predeterminado de
--[no]check_bzl_visibility
: "true" -
Si se inhabilita, los errores de visibilidad de carga .bzl descienden a advertencias.
Etiquetas:build_file_semantics
- Esta opción afecta la semántica del lenguaje de Starlark o de la API de compilación a la que pueden acceder los archivos BUILD, los archivos .bzl o los archivos WORKSPACE:
- Valor predeterminado de
--[no]enable_bzlmod
: "true" -
Si es verdadero, se habilita el sistema de administración de dependencias Bzlmod, que tiene prioridad sobre WORKSPACE. Consulta https://bazel.build/docs/bzlmod para obtener más información.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]enable_workspace
: "true" -
Si es verdadero, se habilita el sistema WORKSPACE heredado para dependencias externas. Consulta https://bazel.build/external/overview para obtener más información.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]experimental_action_resource_set
: "true" -
Si se configura como verdadero, ctx.actions.run() y ctx.actions.run_shell() aceptan un parámetro resource_set para la ejecución local. De lo contrario, se establecerá de forma predeterminada en 250 MB para la memoria y 1 CPU.
Etiquetas:execution
,build_file_semantics
yexperimental
- Valor predeterminado de
--[no]experimental_bzl_visibility
: "true" -
Si se habilita, agrega una función `visibility()` a la que los archivos .bzl pueden llamar durante la evaluación de nivel superior para establecer su visibilidad con fines de sentencias load().
Etiquetas:loading_and_analysis
yexperimental
-
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
yexperimental
- Valor predeterminado de
--[no]experimental_disable_external_package
: "falso" -
Si la estableces como verdadera, el paquete externo //generado automáticamente ya no estará disponible. Bazel aún no podrá analizar el archivo “external/BUILD”, pero los globs que lleguen a external/ desde el paquete sin nombre sí funcionarán.
Etiquetas:loading_and_analysis
,loses_incremental_state
yexperimental
- Valor predeterminado de
--[no]experimental_enable_android_migration_apis
: "falso" -
Si se configura como verdadera, habilita las APIs necesarias para admitir la migración de Android Starlark.
Etiquetas:build_file_semantics
- Valor predeterminado de
--[no]experimental_enable_scl_dialect
: "falso" -
Si se configura como true, se pueden usar archivos .scl en las sentencias load().
Etiquetas:build_file_semantics
- Valor predeterminado de
--[no]experimental_google_legacy_api
: "falso" -
Si se configura como verdadero, expone varias partes experimentales de la API de compilación de Starlark relacionadas con el código heredado de Google.
Etiquetas:loading_and_analysis
yexperimental
- Valor predeterminado de
--[no]experimental_isolated_extension_usages
: "falso" -
Si es verdadero, se habilita el parámetro <code>aislar</code>. en <a href="https://bazel.build/rules/lib/globals/module#use_extension"><code>use_extension</code></a> .
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]experimental_java_library_export
: "falso" -
Si se habilita, se encuentra disponible el módulo experimental_java_library_export_do_not_use.
Etiquetas:loading_and_analysis
yincompatible_change
- Valor predeterminado de
--[no]experimental_platforms_api
: "falso" -
Si se configura como verdadera, habilita varias APIs de Starlark relacionadas con la plataforma que son útiles para la depuración.
Etiquetas:loading_and_analysis
yexperimental
- Valor predeterminado de
--[no]experimental_repo_remote_exec
: "falso" -
Si se configura como true, repository_rule obtiene algunas capacidades de ejecución remota.
Etiquetas:build_file_semantics
,loading_and_analysis
yexperimental
- Valor predeterminado de
--[no]experimental_sibling_repository_layout
: "falso" -
Si se configura como verdadero, los repositorios que no son principales se colocan como symlinks al repositorio principal en la raíz de ejecución. Es decir, todos los repositorios son elementos secundarios directos del directorio $output_base/execution_root. Esto tiene el efecto secundario de liberar $output_base/execution_root/__main__/external para el valor "external" de nivel superior real .
Etiquetas:action_command_lines
,bazel_internal_configuration
,loading_and_analysis
,loses_incremental_state
yexperimental
-
Si la estableces como verdadera, las etiquetas se propagarán de un destino a las acciones los requisitos de ejecución; De lo contrario, las etiquetas no se propagan. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/8830.
Etiquetas:build_file_semantics
yexperimental
- Valor predeterminado de
--[no]incompatible_always_check_depset_elements
: "true" -
Verifica la validez de los elementos agregados a los depsets en todos los constructores. Los elementos deben ser inmutables, pero, históricamente, el constructor depset(direct=...) se olvidó de verificar. Usa tuplas en lugar de listas en elementos depset. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/10313.
Etiquetas:build_file_semantics
yincompatible_change
- Valor predeterminado de
--[no]incompatible_depset_for_java_output_source_jars
: "true" -
Cuando es verdadero, Bazel ya no muestra una lista de java_info.java_output[0].source_jars, sino que muestra un depset.
Etiquetas:loading_and_analysis
yincompatible_change
- Valor predeterminado de
--[no]incompatible_depset_for_libraries_to_link_getter
: "true" -
Cuando el valor es verdadero, Bazel ya no muestra una lista de links_context.libraries_to_link, pero mostrará un depset.
Etiquetas:loading_and_analysis
yincompatible_change
- Valor predeterminado de
--[no]incompatible_disable_objc_library_transition
: "true" -
Inhabilita la transición personalizada de objc_library y hereda del objetivo de nivel superior
Etiquetas:build_file_semantics
yincompatible_change
- Valor predeterminado de
--[no]incompatible_disable_starlark_host_transitions
: "falso" -
Si se establece como verdadero, los atributos de la regla no pueden establecer 'cfg = "host"'. Las reglas deben establecer 'cfg = "exec"'. en su lugar.
Etiquetas:loading_and_analysis
yincompatible_change
- Valor predeterminado de
--[no]incompatible_disable_target_provider_fields
: "falso" -
Si la estableces como verdadera, inhabilitar la capacidad de acceder a los proveedores en el “objetivo” objetos a través de la sintaxis de campos. En su lugar, usa la sintaxis de clave de proveedor. Por ejemplo, en lugar de usar `ctx.attr.dep.my_info` para acceder a `my_info` desde una función de implementación de reglas, usa `ctx.attr.dep[MyInfo]`. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/9014.
Etiquetas:build_file_semantics
yincompatible_change
- Valor predeterminado de
--[no]incompatible_disallow_empty_glob
: "falso" -
Si la estableces como verdadera, el valor predeterminado del argumento `allow_empty` de glob() es False.
Etiquetas:build_file_semantics
yincompatible_change
- Valor predeterminado de
--[no]incompatible_disallow_struct_provider_syntax
: "falso" -
Si se configura como verdadera, es posible que las funciones de implementación de reglas no muestren un struct. En su lugar, deben mostrar una lista de instancias del proveedor.
Etiquetas:build_file_semantics
yincompatible_change
- Valor predeterminado de
--[no]incompatible_enable_deprecated_label_apis
: "true" -
Si se habilita, se pueden usar ciertas APIs obsoletas (native.repository_name, Label.workspace_name, Label.relative).
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]incompatible_existing_rules_immutable_view
: "true" -
Si se configura como verdadero, native.existing_rule y native.existing_rules, que se muestren objetos de vista inmutables y ligeros en lugar de diccionarios mutables.
Etiquetas:build_file_semantics
,loading_and_analysis
yincompatible_change
- Valor predeterminado de
--[no]incompatible_fail_on_unknown_attributes
: "true" -
Si se habilita, los destinos con atributos desconocidos establecidos en Ninguno fallan.
Etiquetas:loading_and_analysis
yincompatible_change
- Valor predeterminado de
--[no]incompatible_fix_package_group_reporoot_syntax
: "true" -
En el atributo "packages" de package_group, cambia el significado del valor "//..." para referirnos a todos los paquetes del repositorio actual
en lugar de a todos los de cualquier repositorio. Puedes usar el valor especial “public” en lugar de “//...” para obtener el comportamiento anterior. Esta marca requiere que también se habilite --incompatible_package_group_has_public_syntax.
Etiquetas:build_file_semantics
yincompatible_change
- Valor predeterminado de
--[no]incompatible_java_common_parameters
: "true" -
Si la estableces como verdadera, se quitarán los parámetros output_jar y host_javabase en pack_sources y host_javabase en compile.
Etiquetas:build_file_semantics
yincompatible_change
- Valor predeterminado de
--[no]incompatible_merge_fixed_and_default_shell_env
: "true" -
Si se habilita, las acciones registradas con ctx.actions.run y ctx.actions.run_shell con ambos “env” y 'use_default_shell_env = True' especificado usará un entorno obtenido del entorno de shell predeterminado mediante la anulación con los valores que se pasan a “env”. Si está inhabilitada, el valor de “env” se ignora por completo en este caso.
Etiquetas:loading_and_analysis
yincompatible_change
- Valor predeterminado de
--[no]incompatible_new_actions_api
: "true" -
Si se configura como verdadera, la API para crear acciones solo estará disponible en `ctx.actions`, no en `ctx`.
Etiquetas:build_file_semantics
yincompatible_change
- Valor predeterminado de
--[no]incompatible_no_attr_license
: "true" -
Si se configura como "true", inhabilita la función "attr.license".
Etiquetas:build_file_semantics
yincompatible_change
- Valor predeterminado de
--[no]incompatible_no_implicit_file_export
: "falso" -
Si se configura, (usado) los archivos de origen son privados del paquete, a menos que se exporten explícitamente. Consultar https://github.com/bazelbuild/proposals/blob/master/designs/2019-10-24-file-visibility.md
Etiquetas:build_file_semantics
yincompatible_change
- Valor predeterminado de
--[no]incompatible_no_rule_outputs_param
: "falso" -
Si se configura como verdadero, inhabilita el parámetro `outputs` de la función `rule()` de Starlark.
Etiquetas:build_file_semantics
yincompatible_change
- Valor predeterminado de
--[no]incompatible_objc_provider_remove_linking_info
: "falso" -
Si se configura como verdadera, se quitarán las APIs de ObjcProvider para la información de vinculación.
Etiquetas:build_file_semantics
yincompatible_change
- Valor predeterminado de
--[no]incompatible_package_group_has_public_syntax
: "true" -
En el atributo "packages" de package_group, permite escribir "public" o "privado" para referirnos a todos los paquetes
o a ninguno, respectivamente.
Etiquetas:build_file_semantics
yincompatible_change
- Valor predeterminado de
--[no]incompatible_require_linker_input_cc_api
: "true" -
Si la estableces como verdadera, la regla create_linking_context requerirá linker_inputs en lugar de libraries_to_link. Los métodos get anteriores de links_context también se inhabilitarán y solo linker_inputs estará disponible.
Etiquetas:build_file_semantics
,loading_and_analysis
yincompatible_change
- Valor predeterminado de
--[no]incompatible_run_shell_command_string
: "true" -
Si se configura como true, el parámetro de comando de actions.run_shell solo aceptará cadena
Etiquetas:build_file_semantics
yincompatible_change
- Valor predeterminado de
--[no]incompatible_stop_exporting_language_modules
: "falso" -
Si se habilita esta opción, ciertos módulos específicos del lenguaje (como `cc_common`) no estarán disponibles en los archivos .bzl del usuario y solo se los podrá llamar desde sus respectivos repositorios de reglas.
Etiquetas:loading_and_analysis
yincompatible_change
- Valor predeterminado de
--[no]incompatible_struct_has_no_methods
: "falso" -
Inhabilita los métodos to_json y to_proto de la struct, que contaminan el espacio de nombres del campo del struct. En su lugar, usa json.encode o json.encode_indent para JSON, o proto.encode_text para textproto.
Etiquetas:build_file_semantics
yincompatible_change
- Valor predeterminado de
--[no]incompatible_top_level_aspects_require_providers
: "falso" -
Si se establece como verdadera, el aspecto de nivel superior respetará los proveedores requeridos y solo se ejecutará en los objetivos de nivel superior cuyas reglas los proveedores anunciados cumplen con los requisitos del aspecto.
Etiquetas:loading_and_analysis
yincompatible_change
- Valor predeterminado de
--[no]incompatible_unambiguous_label_stringification
: "true" -
Si el valor es verdadero, Bazel aplicará strings de la etiqueta @//foo:bar a @//foo:bar, en lugar de //foo:bar. Esto solo afecta el comportamiento de str(), el operador %, etc. el comportamiento de repr() no cambia. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/15916.
Etiquetas:loading_and_analysis
yincompatible_change
- Valor predeterminado de
--[no]incompatible_use_cc_configure_from_rules_cc
: "falso" -
Si es verdadero, Bazel ya no permitirá el uso de cc_configure de @bazel_tools. Consulta https://github.com/bazelbuild/bazel/issues/10134 para obtener detalles y las instrucciones de migración.
Etiquetas:loading_and_analysis
yincompatible_change
- Valor predeterminado de
--[no]incompatible_visibility_private_attributes_at_definition
: "true" -
Si se configura como verdadera, se verifica la visibilidad de los atributos de la regla privada con respecto a la definición de la regla y se recurre al uso de la regla si no está visible.
Etiquetas:build_file_semantics
yincompatible_change
- Valor predeterminado de
--max_computation_steps=<a long integer>
: "0" -
La cantidad máxima de pasos de procesamiento de Starlark que puede ejecutar un archivo BUILD (cero significa que no hay límite).
Etiquetas:build_file_semantics
- Valor predeterminado de
--nested_set_depth_limit=<an integer>
: "3500" -
La profundidad máxima del grafo interna de un depset (también conocido como NestedSet), por encima de la cual el constructor depset() fallará.
Etiquetas:loading_and_analysis
- Opciones que activan optimizaciones del tiempo de compilación:
- Valor predeterminado de
--[no]heuristically_drop_nodes
: "falso" -
Si esta preferencia se establece como "true", Blaze quitará los nodos FileState y DirectoryListingState una vez que el nodo File y DirectoryListing relacionado esté listo para ahorrar memoria. Esperamos que sea menos probable que se vuelvan a necesitar estos nodos. De ser así, el programa los volverá a evaluar.
Etiquetas:loses_incremental_state
- Valor predeterminado de
--[no]incompatible_do_not_split_linking_cmdline
: "true" -
Cuando es verdadero, Bazel ya no modifica las marcas de línea de comandos que se usan para la vinculación y tampoco decide de manera selectiva qué marcas van al archivo de parámetros y cuáles no. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/7670.
Etiquetas:loading_and_analysis
yincompatible_change
- Valor predeterminado de
--[no]keep_state_after_build
: "true" -
Si se establece como "false", Blaze descartará el estado en la memoria de esta compilación cuando esta finalice. Las compilaciones posteriores no tendrán ninguna incrementalidad con respecto a esta.
Etiquetas:loses_incremental_state
- Valor predeterminado de
--[no]track_incremental_state
: "true" -
Si se establece como "false", Blaze no conservará datos que permitan invalidar y volver a evaluar las compilaciones incrementales para ahorrar memoria en esta compilación. Las compilaciones posteriores no tendrán ninguna incrementalidad con respecto a esta. Por lo general, deberás especificar --batch cuando lo configures como falso.
Etiquetas:loses_incremental_state
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Valor predeterminado de
--[no]announce_rc
: "falso" -
Indica si se deben anunciar las opciones de rc.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]attempt_to_print_relative_paths
: "falso" -
Cuando imprimas la ubicación de los mensajes, intenta usar una ruta de acceso relativa al directorio del espacio de trabajo o a uno de los directorios especificados por --package_path.
Etiquetas:terminal_output
- Valor predeterminado de
--bes_backend=<a string>
: "" -
Especifica el extremo de backend del servicio de eventos de compilación (BES) con el formato [SCHEME://]HOST[:PORT]. La configuración predeterminada es inhabilitar las cargas a BES. Los esquemas compatibles son grpc y grpcs (grpc con TLS habilitado). Si no se proporciona ningún esquema, Bazel supone los grpcs.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]bes_check_preceding_lifecycle_events
: "falso" -
Configura el campo check_preceding_lifecycle_events_present en PublishBuildToolEventStreamRequest, que le indica a BES que verifique si recibió anteriormente los eventos InvocationAttemptStarted y BuildEnqueued que coincidan con el evento actual de la herramienta.
Etiquetas:affects_outputs
- Se acumulan
--bes_header=<a 'name=value' assignment>
usos múltiples -
Especifica un encabezado con el formato NAME=VALUE que se incluirá en las solicitudes de BES. Se pueden pasar varios encabezados especificando la marca varias veces. Si hay varios valores para el mismo nombre, se convertirán en una lista separada por comas.
Etiquetas:affects_outputs
- Valor predeterminado de
--bes_instance_name=<a string>
: ver descripción -
Especifica el nombre de la instancia bajo el cual la BES conservará los BEP subidos. La configuración predeterminada es null.
Etiquetas:affects_outputs
- Se acumulan
--bes_keywords=<comma-separated list of options>
usos múltiples -
Especifica una lista de palabras clave de notificación que se agregarán al conjunto predeterminado de palabras clave publicadas en BES ("command_name=<command_name>", "protocol_name=BEP"). La configuración predeterminada es "none".
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]bes_lifecycle_events
: "true" -
Especifica si se deben publicar los eventos de ciclo de vida de BES. (el valor predeterminado es “true”).
Etiquetas:affects_outputs
--bes_oom_finish_upload_timeout=<An immutable length of time.>
valor predeterminado: "10m"-
Especifica cuánto tiempo debe esperar Bazel para que se complete la carga de BES/BEP mientras se realiza la operación OOM. Esta marca garantiza la finalización cuando la JVM realiza una hiperpaginación grave de GC y no puede progresar en ningún subproceso de usuario.
Etiquetas:bazel_monitoring
- Valor predeterminado de
--bes_outerr_buffer_size=<an integer>
: "10240" -
Especifica el tamaño máximo de stdout o stderr que se almacenará en el búfer en BEP antes de que se informe como un evento de progreso. Las escrituras individuales se informan en un solo evento, incluso si son mayores que el valor especificado hasta --bes_outerr_chunk_size.
Etiquetas:affects_outputs
--bes_outerr_chunk_size=<an integer>
predeterminado: “1048576”-
Especifica el tamaño máximo de stdout o stderr que se enviará a BEP en un solo mensaje.
Etiquetas:affects_outputs
- Valor predeterminado de
--bes_proxy=<a string>
: ver descripción - Conéctate al servicio de eventos de compilación a través de un proxy. Actualmente, esta marca solo se puede usar para configurar un socket de dominio Unix (unix:/path/to/socket).
- Valor predeterminado de
--bes_results_url=<a string>
: "" -
Especifica la URL base en la que un usuario puede ver la información transmitida al backend de BES. Bazel enviará a la terminal la URL anexada por el ID de invocación.
Etiquetas:terminal_output
- Se acumulan
--bes_system_keywords=<comma-separated list of options>
usos múltiples -
Especifica una lista de palabras clave de notificación que se incluirán directamente, sin el parámetro "user_keyword=" prefijo incluido para las palabras clave proporcionadas con --bes_keyword. Está destinado a los operadores de servicios de compilación que configuran --bes_lifecycle_events=false y, además, incluyen palabras clave cuando llaman a PublishLifecycleEvent. Los operadores de servicios de compilación que usan esta marca deberían evitar que los usuarios anulen el valor de la marca.
Etiquetas:affects_outputs
- Valor predeterminado de
--bes_timeout=<An immutable length of time.>
: "0s" -
Especifica cuánto tiempo debe esperar Bazel a que se complete la carga de BES/BEP una vez que finalicen la compilación y las pruebas. Un tiempo de espera válido es un número natural seguido de una unidad: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). El valor predeterminado es "0". lo que significa que no hay tiempo de espera.
Etiquetas:affects_outputs
- Valor predeterminado de
--bes_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>
: "wait_for_upload_complete" -
Especifica si la carga del servicio de eventos de compilación debe bloquear la finalización de la compilación o finalizar la invocación de inmediato y finalizar la carga en segundo plano. "wait_for_upload_complete" (predeterminado), 'nowait_for_upload_complete' o 'completamente_async'.
Etiquetas:eagerness_to_exit
- Valor predeterminado de
--build_event_binary_file=<a string>
: "" -
Si no está vacío, escribe una representación binaria delimitada por varint de la representación del protocolo de eventos de compilación en ese archivo. Esta opción implica --bes_upload_mode=wait_for_upload_complete.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]build_event_binary_file_path_conversion
: "true" -
Siempre que sea posible, convierte las rutas de acceso en la representación de archivo binario del protocolo de eventos de compilación en URI más válidos a nivel global. Si se inhabilita, siempre se usará el esquema de URI file://
Etiquetas:affects_outputs
- Valor predeterminado de
--build_event_binary_file_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>
: "wait_for_upload_complete" -
Especifica si la carga del servicio de eventos de compilación para --build_event_binary_file debe bloquear la finalización de la compilación o finalizar la invocación de inmediato y finalizar la carga en segundo plano. "wait_for_upload_complete" (predeterminado), 'nowait_for_upload_complete' o 'completamente_async'.
Etiquetas:eagerness_to_exit
- Valor predeterminado de
--build_event_json_file=<a string>
: "" -
Si no está vacío, escribe una serialización JSON del protocolo de evento de compilación en ese archivo. Esta opción implica --bes_upload_mode=wait_for_upload_complete.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]build_event_json_file_path_conversion
: "true" -
Siempre que sea posible, convierte las rutas de acceso de la representación de archivo JSON del protocolo de eventos de compilación en URI más válidos a nivel global. Si se inhabilita, siempre se usará el esquema de URI file://
Etiquetas:affects_outputs
- Valor predeterminado de
--build_event_json_file_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>
: "wait_for_upload_complete" -
Especifica si la carga del servicio de evento de compilación para --build_event_json_file debe bloquear la finalización de la compilación o debe finalizar la invocación de inmediato y finalizar la carga en segundo plano. "wait_for_upload_complete" (predeterminado), 'nowait_for_upload_complete' o 'completamente_async'.
Etiquetas:eagerness_to_exit
- Valor predeterminado de
--build_event_max_named_set_of_file_entries=<an integer>
: "-1" -
Cantidad máxima de entradas para un solo evento con nombre_conjunto_de_archivos; los valores inferiores a 2 se ignoran y no se realiza ninguna división de eventos. Esto está diseñado para limitar el tamaño máximo del evento en el protocolo de evento de compilación, aunque no controla directamente el tamaño del evento. El tamaño total del evento es una función de la estructura del conjunto, así como de las longitudes del archivo y del URI, que, a su vez, pueden depender de la función hash.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]build_event_publish_all_actions
: "falso" -
Si todas las acciones deben publicarse.
Etiquetas:affects_outputs
- Valor predeterminado de
--build_event_text_file=<a string>
: "" -
Si no está vacío, escribe una representación textual del protocolo del evento de compilación en ese archivo.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]build_event_text_file_path_conversion
: "true" -
Siempre que sea posible, convierte las rutas de acceso en la representación del archivo de texto del protocolo de eventos de compilación en URI más válidos a nivel global. Si se inhabilita, siempre se usará el esquema de URI file://
Etiquetas:affects_outputs
- Valor predeterminado de
--build_event_text_file_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>
: "wait_for_upload_complete" -
Especifica si la carga del servicio de eventos de compilación para --build_event_text_file debe bloquear la finalización de la compilación o finalizar la invocación de inmediato y finalizar la carga en segundo plano. "wait_for_upload_complete" (predeterminado), 'nowait_for_upload_complete' o 'completamente_async'.
Etiquetas:eagerness_to_exit
- Valor predeterminado de
--[no]experimental_announce_profile_path
: "falso" -
Si se habilita, agrega la ruta del perfil JSON al registro.
Etiquetas:bazel_monitoring
- Valor predeterminado de
--[no]experimental_bep_target_summary
: "falso" - Especifica si se publicarán los eventos de TargetSummary.
- Valor predeterminado de
--[no]experimental_build_event_expand_filesets
: "falso" -
Si es verdadero, expande los conjuntos de archivos en BEP cuando presentes archivos de salida.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]experimental_build_event_fully_resolve_fileset_symlinks
: "falso" -
Si es verdadero, resuelve por completo los symlinks relativos del conjunto de archivos en el BEP cuando presentes los archivos de salida. Requiere --experimental_build_event_expand_filesets.
Etiquetas:affects_outputs
- Valor predeterminado de
--experimental_build_event_upload_max_retries=<an integer>
: "4" -
La cantidad máxima de veces que Bazel debería reintentar subir un evento de compilación.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
: "1s" -
Es el retraso mínimo inicial para los reintentos de retirada exponencial cuando falla la carga de BEP. (exponente: 1.6)
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--experimental_build_event_upload_strategy=<a string>
: ver descripción -
Selecciona cómo subir los artefactos a los que se hace referencia en el protocolo del evento de compilación.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]experimental_collect_load_average_in_profiler
: "true" -
Si se habilita, el generador de perfiles recopila el promedio de carga general del sistema.
Etiquetas:bazel_monitoring
- Valor predeterminado de
--[no]experimental_collect_pressure_stall_indicators
: "falso" -
Si se habilita, el generador de perfiles recopila los datos de PSI de Linux.
Etiquetas:bazel_monitoring
- Valor predeterminado de
--[no]experimental_collect_resource_estimation
: "falso" -
Si se habilita, el generador de perfiles recopila los cálculos de uso de CPU y memoria de las acciones locales.
Etiquetas:bazel_monitoring
- Valor predeterminado de
--[no]experimental_collect_system_network_usage
: "falso" -
Si se habilita, el generador de perfiles recopila el uso de red del sistema.
Etiquetas:bazel_monitoring
- Valor predeterminado de
--[no]experimental_collect_worker_data_in_profiler
: "falso" -
Si se habilita, el generador de perfiles recopila los datos de recursos agregados del trabajador.
Etiquetas:bazel_monitoring
- Se acumulan
--experimental_profile_additional_tasks=<phase, action, action_check, action_lock, action_release, action_update, action_complete, bzlmod, info, create_package, remote_execution, local_execution, scanner, local_parse, upload_time, remote_process_time, remote_queue, remote_setup, fetch, local_process_time, vfs_stat, vfs_dir, vfs_readlink, vfs_md5, vfs_xattr, vfs_delete, vfs_open, vfs_read, vfs_write, vfs_glob, vfs_vmfs_stat, vfs_vmfs_dir, vfs_vmfs_read, wait, thread_name, thread_sort_index, skyframe_eval, skyfunction, critical_path, critical_path_component, handle_gc_notification, action_counts, action_cache_counts, local_cpu_usage, system_cpu_usage, cpu_usage_estimation, local_memory_usage, system_memory_usage, memory_usage_estimation, system_network_up_usage, system_network_down_usage, workers_memory_usage, system_load_average, starlark_parser, starlark_user_fn, starlark_builtin_fn, starlark_user_compiled_fn, starlark_repository_fn, action_fs_staging, remote_cache_check, remote_download, remote_network, filesystem_traversal, worker_execution, worker_setup, worker_borrow, worker_working, worker_copying_outputs, credential_helper, pressure_stall_io, pressure_stall_memory, conflict_check, dynamic_lock, repository_fetch or unknown>
usos múltiples -
Especifica las tareas de perfil adicionales que se incluirán en el perfil.
Etiquetas:bazel_monitoring
- Valor predeterminado de
--[no]experimental_profile_include_primary_output
: "falso" -
Incluye el "out" adicional en eventos de acción que contiene la ruta de acceso de ejecución a la salida principal de la acción.
Etiquetas:bazel_monitoring
- Valor predeterminado de
--[no]experimental_profile_include_target_label
: "falso" -
Incluye la etiqueta objetivo en los eventos de acción Datos de perfil JSON.
Etiquetas:bazel_monitoring
- Valor predeterminado de
--[no]experimental_run_bep_event_include_residue
: "falso" -
Indica si se debe incluir el residue de línea de comandos en eventos de compilación en ejecución que podrían contener el residue. De forma predeterminada, el residue no se incluye en los eventos de compilación de comandos de ejecución que podrían contener el residue.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]experimental_stream_log_file_uploads
: "falso" -
Transmite las cargas de archivos de registro directamente al almacenamiento remoto en lugar de escribirlas en el disco.
Etiquetas:affects_outputs
- Valor predeterminado de
--experimental_workspace_rules_log_file=<a path>
: ver descripción - Registra ciertos eventos de reglas de Workspace en este archivo como archivos proto delimitados de WorkspaceEvent.
--[no]generate_json_trace_profile
predeterminado: "automático"-
Si se habilita, Bazel genera perfiles de la compilación y escribe un perfil en formato JSON en un archivo en la base de salida. Ver el perfil cargando en chrome://tracing. De forma predeterminada, Bazel escribe el perfil para todos los comandos y consultas similares a los de compilación.
Etiquetas:bazel_monitoring
- Valor predeterminado de
--[no]heap_dump_on_oom
: "falso" -
Establece si se debe generar de forma manual un volcado de montón si se arroja un OOM (incluidas las OOM manuales debido a que se alcanza --gc_thrashing_limits). El volcado se escribirá en <output_base>/<invocation_id>.heapdump.hprof. Esta opción reemplaza efectivamente -XX:+HeapDumpOnOutOfMemoryError, que no tiene efecto en las OOM manuales.
Etiquetas:bazel_monitoring
- Valor predeterminado de
--[no]legacy_important_outputs
: "true" -
Úsalo para suprimir la generación del campo relevant_outputs heredado en el evento TargetComplete. importantes_outputs son obligatorios para la integración de Bazel a ResultStore.
Etiquetas:affects_outputs
- Valor predeterminado de
--logging=<0 <= an integer <= 6>
: "3" -
El nivel de registro.
Etiquetas:affects_outputs
- Valor predeterminado de
--memory_profile=<a path>
: ver descripción -
Si está establecido, escribe los datos de uso de memoria en el archivo especificado al finalizar la fase y en el montón estable en el registro principal al final de la compilación.
Etiquetas:bazel_monitoring
- Valor predeterminado de
--memory_profile_stable_heap_parameters=<integers, separated by a comma expected in pairs>
: "1,0" -
Ajusta el cálculo del perfil de memoria de montón estable al final de la compilación. Debe haber un número par de números enteros separados por comas. En cada par, el primer número entero es la cantidad de GC que se realizarán. El segundo número entero de cada par es la cantidad de segundos que se debe esperar entre las GC. P. ej.: 2,4,4,0 implicarían 2 recolecciones con una pausa de 4 segundos, seguidas de 4 recolecciones con pausa de cero segundos
Etiquetas:bazel_monitoring
- Valor predeterminado de
--profile=<a path>
: ver descripción -
Si está configurado, genera perfiles de Bazel y escribe datos en el archivo especificado. Usa analyze-profile de Bazel para analizar el perfil.
Etiquetas:bazel_monitoring
- Valor predeterminado de
--[no]record_full_profiler_data
: "falso" -
De forma predeterminada, el generador de perfiles de Bazel solo registrará datos agregados para eventos rápidos pero numerosos (como la estadística de un archivo). Si se habilita esta opción, el generador de perfiles registrará cada evento, lo que dará como resultado datos de generación de perfiles más precisos, pero un hit de rendimiento GRANDE. La opción solo tiene efecto si también se utiliza --profile.
Etiquetas:bazel_monitoring
- Valor predeterminado de
--remote_print_execution_messages=<failure, success or all>
: "error" -
Elige cuándo imprimir los mensajes de ejecución remota. Los valores válidos son `failure` (error), para imprimir solo en caso de errores, "success" para imprimir solo en caso de éxito y "all" para imprimir siempre.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]slim_profile
: "true" -
Reduce el tamaño del perfil JSON combinando eventos si el perfil es demasiado grande.
Etiquetas:bazel_monitoring
- Valor predeterminado de
--starlark_cpu_profile=<a string>
: "" -
Escribe en el archivo especificado un perfil pprof del uso de CPU por parte de todos los subprocesos de Starlark.
Etiquetas:bazel_monitoring
- Valor predeterminado de
--tool_tag=<a string>
: "" -
Es un nombre de herramienta al que se le atribuirá esta invocación de Bazel.
Etiquetas:affects_outputs
ybazel_monitoring
- Se acumulan
--ui_event_filters=<Convert list of comma separated event kind to list of filters>
usos múltiples -
Especifica qué eventos se mostrarán en la IU. Es posible agregar o quitar eventos a los predeterminados con el signo +/- inicial o anular el conjunto predeterminado por completo con una asignación directa. El conjunto de tipos de eventos admitidos incluye INFO, DEBUG, ERROR y muchos más.
Etiquetas:terminal_output
- Opciones de ejecución y almacenamiento en caché remoto:
- Valor predeterminado de
--experimental_circuit_breaker_strategy=<failure>
: ver descripción -
Especifica la estrategia que usará el disyuntor. Las estrategias disponibles son “fallas”. Si el valor de la opción no es válido, no se establece el mismo comportamiento que la opción.
Etiquetas:execution
- Valor predeterminado de
--[no]experimental_guard_against_concurrent_changes
: "falso" - Desactiva esta opción para inhabilitar la verificación del tiempo de los archivos de entrada de una acción antes de subirla a una caché remota. Puede haber casos en los que el kernel de Linux retrase la escritura de archivos, lo que podría provocar falsos positivos.
- Valor predeterminado de
--[no]experimental_remote_cache_async
: "falso" - Si es verdadero, la E/S de la caché remota ocurrirá en segundo plano, en lugar de ocurrir como parte de un generador.
- Valor predeterminado de
--experimental_remote_cache_compression_threshold=<an integer>
: "0" - El tamaño mínimo de BLOB para comprimir o descomprimir con zstd. Es ineficaz, a menos que se configure --remote_cache_compression.
- Valor predeterminado de
--[no]experimental_remote_cache_lease_extension
: "falso" - Si se configura como verdadero, Bazel extenderá la asignación de tiempo para los resultados de las acciones remotas durante la compilación enviando llamadas a `FindMissingBlobs` de forma periódica a la caché remota. La frecuencia se basa en el valor de `--experimental_remote_cache_ttl`.
--experimental_remote_cache_ttl=<An immutable length of time.>
valor predeterminado: "3h"-
El TTL mínimo garantizado de los BLOB en la caché remota después de que se hace referencia recientemente a sus resúmenes, p.ej., por un ActionResult o FindMissingBlobs. Bazel realiza varias optimizaciones basadas en la información de los BLOB. TTL, p.ej., no llama repetidamente a GetActionResult en una compilación incremental. El valor debe establecerse un poco menor que el TTL real, ya que hay un espacio entre el momento en que el servidor muestra los resúmenes y el momento en que Bazel los recibe.
Etiquetas:execution
- Valor predeterminado de
--experimental_remote_capture_corrupted_outputs=<a path>
: ver descripción - Una ruta de acceso a un directorio en el que se capturarán los resultados dañados.
- Valor predeterminado de
--[no]experimental_remote_discard_merkle_trees
: "falso" - Si se configura como verdadera, descarta las copias en la memoria del árbol Merkle de la raíz de entrada y las asignaciones de entradas asociadas durante las llamadas a GetActionResult() y Execute(). Esto reduce significativamente el uso de memoria, pero requiere que Bazel vuelva a procesarlos ante errores y reintentos de caché remota.
- Valor predeterminado de
--experimental_remote_downloader=<a string>
: ver descripción - Un URI de extremo de la API de Remote Asset, que se usará como proxy de descarga remota. Los esquemas compatibles son gRPC, grpcs (grpc con TLS habilitado) y Unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel usará grpcs de forma predeterminada. Visita https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto.
- Valor predeterminado de
--[no]experimental_remote_downloader_local_fallback
: "falso" - Indica si se debe recurrir a la descarga local en caso de que falle la descarga remota.
- Valor predeterminado de
--[no]experimental_remote_execution_keepalive
: "falso" - Indica si se debe usar keepalive para llamadas de ejecución remota.
- Valor predeterminado de
--experimental_remote_failure_rate_threshold=<an integer in 0-100 range>
: "10" -
Establece la cantidad permitida de tasa de fallas en porcentaje para un período específico, después del cual se deja de llamar a la caché o al ejecutor remoto. De forma predeterminada, el valor es 10. Si se establece en 0, no hay limitación.
Etiquetas:execution
--experimental_remote_failure_window_interval=<An immutable length of time.>
valor predeterminado: "60 s"-
El intervalo en el que se calcula la tasa de fallas de las solicitudes remotas. Con un valor de cero o negativo, la duración de la falla se calcula por toda la duración de la ejecución.Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
Etiquetas:execution
- Valor predeterminado de
--[no]experimental_remote_mark_tool_inputs
: "falso" - Si la estableces como verdadera, Bazel marcará las entradas como entradas de herramientas para el ejecutor remoto. Puede usarse para implementar trabajadores persistentes remotos.
- Valor predeterminado de
--[no]experimental_remote_merkle_tree_cache
: "falso" - Si se establece en true, se memorizarán los cálculos del árbol de Merkle para mejorar la velocidad de comprobación de aciertos de caché remota. La huella de memoria de la caché se controla mediante --experimental_remote_merkle_tree_cache_size.
- Valor predeterminado de
--experimental_remote_merkle_tree_cache_size=<a long integer>
: "1000" - La cantidad de árboles de Merkle que se deben memorizar para mejorar la velocidad de comprobación de aciertos de caché remota. Aunque la caché se reduce automáticamente según el manejo de referencias suaves de Java, se pueden producir errores de memoria insuficiente si la configuración es muy 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.
- Valor predeterminado de
--[no]experimental_remote_require_cached
: "falso" - Si se configura como verdadera, establece que todas las acciones que pueden ejecutarse de forma remota se almacenen en caché o que falle la compilación. Esto es útil para solucionar problemas de no determinismo, ya que permite comprobar si las acciones que deben almacenarse en caché realmente se almacenan en caché sin insertar falsamente resultados nuevos en la caché.
- Valor predeterminado de
--experimental_remote_scrubbing_config=<Converts to a Scrubber>
: ver descripción - Permite el borrado de claves de caché remota con el archivo de configuración suministrado, que debe ser un búfer de protocolo en formato de texto (consulta src/main/protobuf/remote_scrubbing.proto). Esta función está diseñada para facilitar el uso compartido de una caché remota o de disco entre acciones que se ejecutan en diferentes plataformas, pero que se orientan a la misma. Se debe utilizar con mucho cuidado, ya que una configuración incorrecta puede provocar que las entradas de la caché se compartan accidentalmente y dar como resultado compilaciones incorrectas. La limpieza no afecta la forma en que se ejecuta una acción, solo la manera en que se calcula su clave de caché remota o de disco con el fin de recuperar o almacenar un resultado de acción. Las acciones depuradas son incompatibles con la ejecución remota y, por lo tanto, siempre se ejecutarán de manera 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, es recomendable que configures --host_platform junto con --experimental_platform_in_output_dir (para normalizar los prefijos de salida) y --incompatible_strict_action_env (para normalizar las variables de entorno).
- Valor predeterminado de
--[no]incompatible_remote_build_event_upload_respect_no_cache
: "falso" - Obsoleto. No-ops. En su lugar, usa --remote_build_event_upload=minimal.
- Valor predeterminado de
--[no]incompatible_remote_downloader_send_all_headers
: "true" -
Establece si se deben enviar todos los valores de un encabezado con valores múltiples al cargador remoto en lugar de solo al primero.
Etiquetas:incompatible_change
- Valor predeterminado de
--[no]incompatible_remote_output_paths_relative_to_input_root
: "falso" -
Si se configura como verdadera, las rutas de salida son relativas a la raíz de entrada en lugar del directorio de trabajo.
Etiquetas:incompatible_change
- Valor predeterminado de
--[no]incompatible_remote_results_ignore_disk
: "true" -
No-ops
Etiquetas:incompatible_change
- Valor predeterminado de
--[no]remote_accept_cached
: "true" - Indica si se deben aceptar los resultados de acciones almacenados en caché de forma remota.
- Valor predeterminado de
--remote_build_event_upload=<all or minimal>
: “mínimo” - Si se configura como “all”, todas las salidas locales a las que hace referencia BEP se suben a la caché remota. Si se configura como “mínimo”, las salidas locales a las que hace referencia BEP no se suben a la caché remota, excepto los archivos que son importantes para los consumidores de BEP (p.ej., los registros de prueba y el perfil de tiempo). El esquema bytestream:// siempre se usa para el URI de los archivos, incluso si faltan en la caché remota. La configuración predeterminada es "minimal".
- Valor predeterminado de
--remote_bytestream_uri_prefix=<a string>
: ver descripción - El nombre de host y el nombre de la instancia que se usarán en los URI bytestream:// que se escriben en transmisiones de eventos de compilación. Esta opción se puede configurar cuando las compilaciones se realizan con un proxy, lo que hace que los valores de --remote_executor y --remote_instance_name ya no correspondan con el nombre canónico del servicio de ejecución remota. Si no la estableces, se establecerá la configuración predeterminada como "${hostname}/${instance_name}".
- Valor predeterminado de
--remote_cache=<a string>
: ver descripción - Un URI de un extremo de almacenamiento en caché. Los esquemas compatibles son http, https, grpc, grpcs (grpc con TLS habilitado) y Unix (sockets UNIX locales), Si no se proporciona un esquema, Bazel usará grpcs de forma predeterminada. Especifica el esquema grpc://, http:// o unix: para inhabilitar TLS. Consulta https://bazel.build/remote/caching
- Valor predeterminado de
--[no]remote_cache_compression
: "falso" - Si se habilita, comprime o descomprime los BLOB de caché con zstd 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 especificando la marca varias veces. Si hay varios valores para el mismo nombre, se convertirán en una lista separada por comas.
- Se acumulan
--remote_default_exec_properties=<a 'name=value' assignment>
usos múltiples -
Establece las propiedades de ejecución predeterminadas que se usarán como plataforma de ejecución remota si una plataforma de ejecución aún no configuró exec_properties.
Etiquetas:affects_outputs
- Valor predeterminado de
--remote_default_platform_properties=<a string>
: "" - Establece las propiedades de plataforma predeterminadas que se establecerán para la API de ejecución remota, si la plataforma de ejecución todavía no configuró remote_execution_properties. Este valor también se usará si se selecciona la plataforma host como plataforma de ejecución remota.
- Se acumulan
--remote_download_regex=<a string>
usos múltiples -
Forzar a Bazel a descargar los artefactos que coincidan con la regexp determinada Se debe usar junto con Build sin los bytes (o el equivalente interno) para permitir que el cliente solicite ciertos artefactos que podrían ser necesarios a nivel local (p.ej., compatibilidad con IDE). Se pueden especificar múltiples regex con la repetición de esta marca.
Etiquetas:affects_outputs
- Se acumulan
--remote_downloader_header=<a 'name=value' assignment>
usos múltiples - Especifica un encabezado que se incluirá en las solicitudes de descargas remotas: --remote_downloader_header=Name=Value. Se pueden pasar varios encabezados especificando la marca varias veces. Si hay varios valores para el mismo nombre, se convertirán en una lista separada por comas.
- Se acumulan
--remote_exec_header=<a 'name=value' assignment>
usos múltiples - Especifica un encabezado que se incluirá en las solicitudes de ejecución: --remote_exec_header=Name=Value. Se pueden pasar varios encabezados especificando la marca varias veces. Si hay varios valores para el mismo nombre, se convertirán en una lista separada por comas.
- Valor predeterminado de
--remote_execution_priority=<an integer>
: "0" - La prioridad relativa de las acciones que se ejecutarán de forma remota. La semántica de los valores de prioridad particulares depende del servidor.
- Valor predeterminado de
--remote_executor=<a string>
: ver descripción - HOST o HOST:PORT de un extremo de ejecución remota. Los esquemas compatibles son gRPC, grpcs (grpc con TLS habilitado) y Unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel usará grpcs de forma predeterminada. Especifica el esquema grpc:// o unix: para inhabilitar TLS.
- Valor predeterminado de
--remote_grpc_log=<a path>
: ver descripción - Si se especifica, una ruta de acceso a un archivo para registrar detalles relacionados con la llamada de gRPC. Este registro consta de una secuencia de protobufs com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry serializados con cada mensaje con prefijo de un varint que denota el tamaño del siguiente mensaje protobuf serializado, como lo realiza el método LogEntry.writeDelimitedTo(OutputStream).
- Se acumulan
--remote_header=<a 'name=value' assignment>
usos múltiples - Especifica un encabezado que se incluirá en las solicitudes: --remote_header=Name=Value. Se pueden pasar varios encabezados especificando la marca varias veces. Si hay varios valores para el mismo nombre, se convertirán en una lista separada por comas.
- Valor predeterminado de
--remote_instance_name=<a string>
: "" - Valor para pasar como instance_name en la API de ejecución remota.
- Valor predeterminado de
--[no]remote_local_fallback
: "falso" - Determina si se debe recurrir a una estrategia de ejecución local independiente si falla la ejecución remota.
- Valor predeterminado de
--remote_local_fallback_strategy=<a string>
: "local" - No-op, obsoleto. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/7480.
- Valor predeterminado de
--remote_max_connections=<an integer>
: "100" -
Limita la cantidad máxima de conexiones simultáneas al ejecutor o la caché remotos. De forma predeterminada, el valor es 100. Si se establece en 0, no hay limitación.
Para la caché remota HTTP, una conexión TCP podía manejar una solicitud a la vez, por lo que Bazel podría generar hasta --remote_max_connections solicitudes simultáneas.
Para el ejecutor o la caché remoto de gRPC, un canal de gRPC, por lo general, podía manejar más de 100 solicitudes simultáneas, por lo que Bazel podría realizar alrededor de `--remote_max_connections * 100` solicitudes simultáneas.
Etiquetas:host_machine_resource_optimizations
- Valor predeterminado de
--remote_proxy=<a string>
: ver descripción - Conéctate a la caché remota a través de un proxy. Actualmente, esta marca solo se puede usar para configurar un socket de dominio Unix (unix:/path/to/socket).
- Valor predeterminado de
--remote_result_cache_priority=<an integer>
: "0" - La prioridad relativa de las acciones remotas que se almacenarán en la caché remota. La semántica de los valores de prioridad particulares depende del servidor.
- Valor predeterminado de
--remote_retries=<an integer>
: "5" - La cantidad máxima de intentos para reintentar un error transitorio. Si se establece en 0, se inhabilitan los reintentos.
- Valor predeterminado de
--remote_retry_max_delay=<An immutable length of time.>
: "5 s" - El retraso máximo de retirada entre los reintentos remotos. Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
--remote_timeout=<An immutable length of time.>
valor predeterminado: "60 s"- La cantidad máxima de tiempo que se debe esperar la ejecución remota y las llamadas de caché. Para la caché REST, este es el tiempo de espera de conexión y de lectura. Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
- Valor predeterminado de
--[no]remote_upload_local_results
: "true" - Establece si se deben subir resultados de acciones ejecutadas de forma local a la caché remota si esta lo admite y si el usuario tiene autorización para hacerlo.
- Valor predeterminado de
--[no]remote_verify_downloads
: "true" - Si la estableces como verdadera, Bazel calculará la suma de hash de todas las descargas remotas y descartará los valores almacenados en caché remotamente si no coinciden con el valor esperado.
- Otras opciones, que no se categorizan de ninguna otra manera:
- Se acumulan
--build_metadata=<a 'name=value' assignment>
usos múltiples -
Pares clave-valor personalizados para proporcionar en un evento de compilación.
Etiquetas:terminal_output
--color=<yes, no or auto>
predeterminado: "automático"- Usa los controles de la terminal para colorear el resultado.
- Se acumulan
--config=<a string>
usos múltiples - Selecciona secciones de configuración adicionales de los archivos rc. para cada <command>, también extrae las opciones de <command>:<config> si dicha sección existe; si esta sección no existe en ningún archivo .rc, Blaze fallará y mostrará un error. Las secciones de configuración y las combinaciones de marcas a las que son equivalentes se encuentran en los archivos de configuración tools/*.blazerc.
- Se acumulan
--credential_helper=<Path to a credential helper. It may be absolute, relative to the PATH environment variable, or %workspace%-relative. The path be optionally prefixed by a scope followed by an '='. The scope is a domain name, optionally with a single leading '*' wildcard component. A helper applies to URIs matching its scope, with more specific scopes preferred. If a helper has no scope, it applies to every URI.>
usos múltiples - Configura un auxiliar de credenciales de acuerdo con la <a href="https://github.com/EngFlow/credential-helper-spec">especificación del asistente de credenciales</a>. que se usará en la recuperación de 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 suministra "--google_default_credentials", "--google_credentials", un archivo ".netrc" o el parámetro auth a "repository_ctx.download()" y "repository_ctx.download_and_extract()`". Se puede especificar varias veces para configurar varios asistentes. Consulta https://blog.engflow.com/2023/10/09/configuration-bazels-credential-helper/ para obtener instrucciones.
--credential_helper_cache_duration=<An immutable length of time.>
valor predeterminado: "30m"- Es el tiempo predeterminado durante el cual se almacenan en caché las credenciales proporcionadas por un auxiliar de credenciales si este no lo proporciona cuando las credenciales caducan.
- Valor predeterminado de
--credential_helper_timeout=<An immutable length of time.>
: "10 s" - Configura el tiempo de espera para un auxiliar de credenciales. Los auxiliares de credenciales que no respondan dentro de este tiempo de espera fallarán la invocación.
--curses=<yes, no or auto>
predeterminado: "automático"- Usa los controles del cursor de la terminal para minimizar el resultado del desplazamiento.
- Valor predeterminado de
--disk_cache=<a path>
: ver descripción - Una ruta de acceso a un directorio en el que Bazel puede leer y escribir acciones y resultados de acciones. Si el directorio no existe, se creará.
- Valor predeterminado de
--[no]enable_platform_specific_config
: "falso" - Si es verdadero, Bazel recopila líneas de configuración específicas del host y el SO de los archivos bazelrc. Por ejemplo, si el SO host es Linux y ejecutas bazel build, Bazel recopila líneas que comienzan con build:linux. Los identificadores de SO compatibles son linux, macos, Windows, freebsd y openbsd. Habilitar esta marca equivale a usar --config=linux en Linux, --config=windows en Windows, etcétera.
- Valor predeterminado de
--[no]experimental_rule_extension_api
: "falso" -
Habilitar la API experimental de extensión de reglas y las APIs de subreglas
Etiquetas:loading_and_analysis
yexperimental
- Valor predeterminado de
--[no]experimental_windows_watchfs
: "falso" - Si es verdadero, se habilitará la compatibilidad experimental de Windows para --watchfs. De lo contrario, --watchfsis una no-op en Windows. Asegúrate de habilitar también --watchfs.
--google_auth_scopes=<comma-separated list of options>
predeterminado: "https://www.googleapis.com/auth/cloud-platform"- Una lista separada por comas de los permisos de autenticación de Google Cloud.
- Valor predeterminado de
--google_credentials=<a string>
: ver descripción - Especifica el archivo del que se deben obtener las credenciales de autenticación. Para obtener más información, consulta https://cloud.google.com/docs/authentication.
- Valor predeterminado de
--[no]google_default_credentials
: "falso" - Si se debe usar “Credenciales predeterminadas de la aplicación de Google” para la autenticación. Para obtener más información, consulta https://cloud.google.com/docs/authentication. Inhabilitada de forma predeterminada.
- Valor predeterminado de
--grpc_keepalive_time=<An immutable length of time.>
: ver descripción - Configura pings de keep-alive para conexiones gRPC salientes. Si se configura, Bazel enviará pings después de este tiempo sin operaciones de lectura en la conexión, pero solo si hay al menos una llamada de gRPC pendiente. Los tiempos se tratan como un segundo nivel de detalle. es un error establecer un valor inferior a un segundo. De forma predeterminada, los pings keep-alive están inhabilitados. Debes coordinar con el propietario del servicio antes de habilitar este parámetro de configuración. Por ejemplo, si quieres establecer un valor de 30 segundos para esta marca, debes hacerlo así: --grpc_keepalive_time=30s
- Valor predeterminado de
--grpc_keepalive_timeout=<An immutable length of time.>
: "20 s" - Configura un tiempo de espera keep-alive para conexiones gRPC salientes. Si los pings keep-alive están habilitados con --grpc_keepalive_time, Bazel agota el tiempo de espera de una conexión si no recibe una respuesta de ping después de este tiempo. Los tiempos se tratan como un segundo nivel de detalle. es un error establecer un valor inferior a un segundo. Si los pings keep-alive están inhabilitados, se ignora esta configuración.
- Valor predeterminado de
--[no]incompatible_disable_non_executable_java_binary
: "falso" -
Si es verdadero, java_binary siempre es ejecutable. Se quitó el atributo create_executable.
Etiquetas:loading_and_analysis
yincompatible_change
- Valor predeterminado de
--[no]incompatible_disallow_symlink_file_to_dir
: "true" -
No-ops.
Etiquetas:loading_and_analysis
yincompatible_change
- Valor predeterminado de
--[no]progress_in_terminal_title
: "falso" - Muestra el progreso del comando en el título de la terminal. Es útil para ver qué hace Bazel cuando tienes varias pestañas de terminal.
- Valor predeterminado de
--[no]show_progress
: "true" - Muestra mensajes de progreso durante una compilación.
--show_progress_rate_limit=<a double>
valor predeterminado: "0.2"- Cantidad mínima de segundos entre los mensajes de progreso en el resultado.
- Valor predeterminado de
--[no]show_timestamps
: "falso" - Incluir marcas de tiempo en los mensajes
- Valor predeterminado de
--tls_certificate=<a string>
: ver descripción - Especifica una ruta de acceso a un certificado TLS que sea de confianza para firmar certificados de servidor.
- Valor predeterminado de
--tls_client_certificate=<a string>
: ver descripción - Especifica el certificado de cliente de TLS que se usará; también debes proporcionar una clave de cliente para habilitar la autenticación del cliente.
- Valor predeterminado de
--tls_client_key=<a string>
: ver descripción - Especifica la clave de cliente de TLS que se usará; También debes proporcionar un certificado de cliente para habilitar la autenticación de cliente.
- Valor predeterminado de
--ui_actions_shown=<an integer>
: "8" -
Cantidad de acciones simultáneas que se muestran en la barra de progreso detallada. cada acción se muestra en una línea separada. La barra de progreso siempre muestra al menos uno; todos los números inferiores a 1 se asignan a 1.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]watchfs
: "falso" - En Linux/macOS: Si esta preferencia se establece como "true", bazel intenta usar el servicio de análisis de archivos del sistema operativo para detectar cambios locales, en lugar de analizar todos los archivos en busca de cambios. En Windows: esta marca actualmente no es operativa, pero se puede habilitar junto con --experimental_windows_watchfs. En cualquier SO: El comportamiento no está definido si tu espacio de trabajo está en un sistema de archivos de red y los archivos se editan en una máquina remota.
Opciones de análisis del perfil
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Lugares adicionales para buscar archivos antes de acceder a la red y descargarlos.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]experimental_repository_cache_hardlinks
: "falso" -
Si se configura, la caché del repositorio vinculará el archivo en lugar de copiarlo en caso de que se produzca un acierto de caché. Esto está diseñado para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--experimental_repository_downloader_retries=<an integer>
: "0" -
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
valor predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark según este factor. De esta manera, los repositorios externos pueden funcionar en máquinas más lentas de lo esperado por el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
yexperimental
- Valor predeterminado de
--http_connector_attempts=<an integer>
: "8" -
La cantidad máxima de intentos para descargas http.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--http_connector_retry_max_timeout=<An immutable length of time.>
: "0s" -
El tiempo de espera máximo para los reintentos de descarga de HTTP. Con un valor de 0, no se define ningún tiempo de espera máximo.
Etiquetas:bazel_internal_configuration
--http_timeout_scaling=<a double>
valor predeterminado: "1.0"-
Escalar todos los tiempos de espera relacionados con las descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación de caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché; de lo contrario, el valor predeterminado es '<output_user_root>/cache/repos/v1'. se usa
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]repository_disable_download
: "falso" -
Si se configura, no se permite la descarga con ctx.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no está completamente inhabilitado. ctx.execute aún podría ejecutar un ejecutable arbitrario que acceda a Internet.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de compilación:
- Valor predeterminado de
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
El porcentaje del espacio permanente ocupado (0-100) por encima del cual GcThrashingDetector considera eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, GcThrashingDetector está inhabilitado.
Etiquetas:host_machine_resource_optimizations
- Opciones relacionadas con la salida y la semántica de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Se especificaron las versiones de los módulos con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resueltas, incluso si se declaran como eliminadas en el registro del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones rechazadas harán que la resolución falle. También puedes definir la versión generada permitida con la variable de entorno `BZLMOD_ALLOW_YANKED_VERSIONS`. Puedes inhabilitar esta verificación con la palabra clave “todo” (no se recomienda).
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
: "error" -
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivar el caso a una falla de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecta una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas de `bazel_dep` declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]ignore_dev_dependency
: "falso" -
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--lockfile_mode=<off, update or error>
: "actualizar" -
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "error" para usar el archivo de bloqueo, pero arroja un error si no está actualizado, o "off" para que no se lea ni escriba en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <module name>=<path>. Si la ruta de acceso dada es una ruta de acceso absoluta, se usará tal como es. Si la ruta de acceso determinada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso dada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace"
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en registros anteriores y solo se recurrirán a los registros posteriores cuando falten en los registros anteriores.
Etiquetas:changes_inputs
- Valor predeterminado de
--vendor_dir=<a path>
: ver descripción -
Especifica el directorio que debe almacenar los repositorios externos en modo de proveedor, ya sea para recuperarlos o usarlos durante la compilación. La ruta 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 bloquee Bazel con una OOM. Cada límite se especifica como <period>:<count> En el ejemplo anterior, el período es una duración y el recuento es un número entero positivo. Si hay más de --gc_thrashing_threshold por ciento de espacio titular (montón de generación anterior) permanece ocupado después de <count> varias recolecciones de elementos no utilizados consecutivas dentro de <period>, se activará una OOM. Si hay varios límites, puedes separarlos por comas.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: “2147483647”-
Marca de configuración avanzada del motor interno Skyframe de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de recolección de elementos no utilizados completa, eliminará el estado temporal de Skyframe innecesario, hasta esta cantidad de veces por invocación. La configuración predeterminada es Integer.MAX_VALUE; eficazmente ilimitados. Cero significa que los eventos de recolección de elementos no utilizados completas nunca activarán la acción de soltar. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC completo y se supere ese umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: “2147483647”-
Marca de configuración avanzada del motor interno Skyframe de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando ocurra un evento menor de recolección de elementos no utilizados, se eliminará el estado temporal de Skyframe innecesario, hasta esta cantidad de veces por invocación. La configuración predeterminada es Integer.MAX_VALUE; eficazmente ilimitados. Cero significa que los eventos menores de recolección de elementos no utilizados nunca activarán la acción de soltar. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC menor y se supere ese umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
- Valor predeterminado de
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
Marca de configuración avanzada del motor interno Skyframe de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es al menos este umbral, descartará el estado temporal de Skyframe innecesario. Ajustar esto puede permitirte mitigar el impacto en el tiempo de la hiperpaginación de GC cuando la hiperpaginación de GC (i) es causada por el uso de memoria de este estado temporal y (ii) es más costosa que reconstituir el estado cuando sea necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--dump=<text or raw>
[-d
] predeterminado: ver descripción-
resultado del volcado de datos del perfil completo, ya sea en un texto legible por humanos formato o "raw" compatible con secuencias de comandos de un conjunto de datos
tengan un formato común.
Etiquetas:affects_outputs
- Valor predeterminado de
--experimental_command_profile=<cpu, wall, alloc or lock>
: ver descripción - Registra un perfil de la grabadora de vuelos de Java mientras dure el comando. Se debe proporcionar uno de los tipos de eventos de generación de perfiles admitidos (CPU, muro, asignación 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 la semántica de esta marca podrían cambiar en el futuro para admitir tipos de perfil o formatos de salida adicionales. usar bajo tu propia responsabilidad.
- Valor predeterminado de
--[no]experimental_record_metrics_for_all_mnemonics
: "falso" - De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemónicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán las estadísticas de todos los mnemónicos.
- Opciones que especifican o modifican una entrada genérica para un comando de Bazel que no se encuentra en otras categorías:
- Valor predeterminado de
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remoto:
- Valor predeterminado de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo con el que se configurará el cargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno que debe coincidir y otro para usar como URL sustituta, con referencias inversas a partir de `$1`. Es posible proporcionar varias directivas "rewrite" para la misma URL; en este caso, se devolverán varias URL.
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
predeterminado: "automático"- El modo de subprocesos que se usará para la recuperación del repositorio. Si se configura en “off”, no se usa ningún subproceso de trabajo y la recuperación del repositorio está sujeta a reinicios. De lo contrario, utiliza un subproceso de plataforma (es decir, un subproceso del SO) si está configurado como "platform". o un subproceso virtual si está configurado como “virtual”. Si se configura como "auto", se usan subprocesos virtuales si están disponibles (es decir, si se ejecutan en JDK 21+). De lo contrario, no se utiliza ningún subproceso de trabajador.
- Otras opciones, que no se categorizan de ninguna otra manera:
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso dada es una ruta de acceso absoluta, se usará tal como es. Si la ruta de acceso determinada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso dada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace"
Opciones de consulta
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Lugares adicionales para buscar archivos antes de acceder a la red y descargarlos.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]experimental_repository_cache_hardlinks
: "falso" -
Si se configura, la caché del repositorio vinculará el archivo en lugar de copiarlo en caso de que se produzca un acierto de caché. Esto está diseñado para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--experimental_repository_downloader_retries=<an integer>
: "0" -
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
valor predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark según este factor. De esta manera, los repositorios externos pueden funcionar en máquinas más lentas de lo esperado por el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
yexperimental
- Valor predeterminado de
--http_connector_attempts=<an integer>
: "8" -
La cantidad máxima de intentos para descargas http.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--http_connector_retry_max_timeout=<An immutable length of time.>
: "0s" -
El tiempo de espera máximo para los reintentos de descarga de HTTP. Con un valor de 0, no se define ningún tiempo de espera máximo.
Etiquetas:bazel_internal_configuration
--http_timeout_scaling=<a double>
valor predeterminado: "1.0"-
Escalar todos los tiempos de espera relacionados con las descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación de caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché; de lo contrario, el valor predeterminado es '<output_user_root>/cache/repos/v1'. se usa
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]repository_disable_download
: "falso" -
Si se configura, no se permite la descarga con ctx.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no está completamente inhabilitado. ctx.execute aún podría ejecutar un ejecutable arbitrario que acceda a Internet.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de compilación:
- Valor predeterminado de
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
El porcentaje del espacio permanente ocupado (0-100) por encima del cual GcThrashingDetector considera eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, GcThrashingDetector está inhabilitado.
Etiquetas:host_machine_resource_optimizations
- Opciones relacionadas con el resultado de la consulta y la semántica:
--aspect_deps=<off, conservative or precise>
predeterminado: “conservadora”-
Cómo resolver dependencias de aspecto cuando el formato de salida es {xml,proto,record}. "desactivado" significa que no se resuelven dependencias de aspecto, “conservadora” (predeterminado) significa que todas las dependencias de aspecto declaradas se agregan independientemente de si se les da la clase de regla de dependencias directas, “precisa”. significa que solo se agregan los aspectos que posiblemente estén activos dada la clase de regla de las dependencias directas. Ten en cuenta que el modo preciso requiere cargar otros paquetes para evaluar un solo objetivo, lo que lo hace más lento que los otros modos. Además, ten en cuenta que incluso el modo preciso no es del todo preciso: la decisión de calcular un aspecto se decide en la fase de análisis, que no se ejecuta durante la “consulta de Bazel”.
Etiquetas:build_file_semantics
- Valor predeterminado de
--[no]consistent_labels
: "falso" -
Si se habilita, cada comando de consulta emite etiquetas como si <code>str</code> de Starlark función aplicada a una <code>etiqueta</code> instancia. Esto resulta útil para las herramientas que necesitan hacer coincidir el resultado de diferentes comandos de consulta o etiquetas emitidas por las reglas. Si no se habilita, los formateadores de salida pueden emitir nombres de repositorio aparentes (en relación con el repositorio principal) en lugar de hacer que el resultado sea más legible.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]experimental_explicit_aspects
: "falso" -
aquery, cquery: Se incluyen acciones generadas por aspectos en el resultado. consulta: no-op (siempre se siguen los aspectos).
Etiquetas:terminal_output
- Valor predeterminado de
--[no]graph:factored
: "true" -
Si es verdadero, el grafo se emitirá “factorizado”, es decir, los nodos topológicamente equivalentes se combinarán y sus etiquetas se concatenarán. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--graph:node_limit=<an integer>
predeterminado: "512"-
La longitud máxima de la cadena de etiqueta para un nodo del grafo en el resultado. Las etiquetas más largas se truncarán. -1 significa que no hay truncamiento. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]implicit_deps
: "true" -
Si se habilita, las dependencias implícitas se incluirán en el gráfico de dependencias sobre el que opera la consulta. Una dependencia implícita es una que no se especifica de forma explícita en el archivo BUILD, pero la agrega Bazel. En el caso de cquery, esta opción controla el filtrado de cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
- Valor predeterminado de
--[no]include_artifacts
: "true" -
Incluye los nombres de las entradas y salidas de las acciones en la salida (posiblemente grandes).
Etiquetas:terminal_output
- Valor predeterminado de
--[no]include_aspects
: "true" -
aquery, cquery: Se incluyen acciones generadas por aspectos en el resultado. consulta: no-op (siempre se siguen los aspectos).
Etiquetas:terminal_output
- Valor predeterminado de
--[no]include_commandline
: "true" -
Incluye el contenido de las líneas de comandos de acción en el resultado (posiblemente grande).
Etiquetas:terminal_output
- Valor predeterminado de
--[no]include_file_write_contents
: "falso" -
Incluye el contenido del archivo para las acciones FileWrite, SourceSymlinkManifest y RepoMappingManifest (posiblemente grandes).
Etiquetas:terminal_output
- Valor predeterminado de
--[no]include_param_files
: "falso" -
Incluye el contenido de los archivos de parámetros que se usaron en el comando (posiblemente grandes). Nota: Habilitar esta marca habilitará automáticamente la marca --include_commandline.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]incompatible_package_group_includes_double_slash
: "true" -
Si se habilita esta opción, cuando se genere el atributo `packages` de package_group, no se omitirá el `//` inicial.
Etiquetas:terminal_output
yincompatible_change
- Valor predeterminado de
--[no]infer_universe_scope
: "falso" -
Si no se establece ni --universe_scope, se inferirá un valor de --universe_scope como la lista de patrones de destino únicos en la expresión de consulta. Ten en cuenta que es posible que el valor --universe_scope inferido para una expresión de consulta que usa funciones con alcance universal (p.ej., `allrdeps`) no sea lo que quieres, por lo que debes usar esta opción solo si sabes lo que estás haciendo. Consulta https://bazel.build/reference/query#sky-query para obtener detalles y ejemplos. Si se configura --universe_scope, se ignora el valor de esta opción. Nota: Esta opción solo se aplica a “query” (es decir, no a “cquery”).
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]line_terminator_null
: "falso" -
Indica si cada formato termina con \0 en lugar de un salto de línea.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]nodep_deps
: "true" -
Si está habilitada, las dependencias de “nodep” atributos se incluirán en el gráfico de la dependencia en el que opera la consulta. Un ejemplo común de un “nodep” es “visibilidad”. Ejecuta y analiza el resultado de `info build-language` para conocer todos los “nodep” atributos en el lenguaje de compilación.
Etiquetas:build_file_semantics
--output=<a string>
predeterminado: "texto"-
El formato en el que se deben imprimir los resultados de BigQuery. Los valores permitidos para aquery son los siguientes: text, textproto, proto, broadcast_proto y jsonproto.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:default_values
: "true" -
Si es verdadero, se incluirán los atributos cuyo valor no se especifica explícitamente en el archivo BUILD. de lo contrario, se omitirán. Esta opción se aplica a --output=proto
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:definition_stack
: "falso" -
Propaga el campo de proto definition_stack, que registra la pila de llamadas de Starlark para cada instancia de la regla en el momento en que se definió la clase de la regla.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:flatten_selects
: "true" -
Si se habilita, se acoplan los atributos configurables creados por select(). Para los tipos de lista, la representación plana es una lista que contiene cada valor del mapa de selección exactamente una vez. Los tipos escalares se acoplan a nulos.
Etiquetas:build_file_semantics
- Valor predeterminado de
--[no]proto:include_attribute_source_aspects
: "falso" -
Propaga el campo de protocolo source_aspect_name de cada atributo con el aspecto de origen del que provino (cadena vacía si no es así).
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:include_synthetic_attribute_hash
: "falso" -
Indica si se debe calcular y propagar el atributo $internal_attr_hash.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:instantiation_stack
: "falso" -
Propaga la pila de llamadas de creación de instancias de cada regla. Ten en cuenta que esto requiere que la pila esté presente
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:locations
: "true" -
Establece si se debe emitir información de ubicación en el resultado de proto.
Etiquetas:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
predeterminado: "todos"-
Lista de atributos separados por comas para incluir en el resultado. La configuración predeterminada es todos los atributos. Si la estableces como una string vacía, no se generará ningún atributo. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:rule_inputs_and_outputs
: "true" -
Indica si se deben completar o no los campos rule_input y rule_output.
Etiquetas:terminal_output
- Valor predeterminado de
--query_file=<a string>
: "" -
Si se configura, la consulta leerá la consulta desde el archivo que se nombra aquí, en lugar de hacerlo en la línea de comandos. Es un error especificar aquí un archivo así como una consulta de línea de comandos.
Etiquetas:changes_inputs
- Valor predeterminado de
--[no]relative_locations
: "falso" -
Si es verdadero, la ubicación de los archivos Build en los resultados xml y proto será relativa. De forma predeterminada, el resultado de la ubicación es una ruta de acceso absoluta y no será coherente en todas las máquinas. Puedes configurar esta opción como verdadera para obtener un resultado coherente en todas las máquinas.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]skyframe_state
: "falso" -
Sin realizar un análisis adicional, vuelca el gráfico de acción actual de Skyframe. Nota: Por el momento, no se admite la especificación de un destino con --skyframe_state. Este indicador solo está disponible con --output=proto o --output=textproto.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]tool_deps
: "true" -
Consulta: Si está inhabilitada, depende de “exec configuration” no se incluirán en el gráfico de la dependencia en el que opera la consulta. Una “configuración de ejecución” perímetro de dependencia, como el de cualquier "proto_library" al compilador de protocolos, por lo general, apunta a una herramienta ejecutada durante la compilación en lugar de a una parte del mismo “destino” .
Cquery: Si se inhabilita, filtra todos los destinos configurados que cruzan una transición de ejecución del objetivo de nivel superior que descubrió este objetivo configurado. Esto significa que, si el destino de nivel superior se encuentra en la configuración de destino, solo se mostrarán los destinos configurados que se encuentren también en esa configuración. Si el destino de nivel superior está en la configuración de ejecución, solo se mostrarán los destinos configurados de ejecución. Esta opción NO excluirá las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
- Valor predeterminado de
--universe_scope=<comma-separated list of options>
: "" -
Un conjunto de patrones de destino separados por comas (aditivos y sustractivos). La consulta puede realizarse en el universo definido por el cierre transitivo de los objetivos especificados. Esta opción se usa para los comandos de consulta y cquery.
Para cquery, la entrada de esta opción son los destinos en los que se crean todas las respuestas, por lo que esta opción puede afectar las configuraciones y transiciones. Si no se especifica esta opción, se supone que los objetivos de nivel superior son los objetivos analizados de la expresión de consulta. Nota: Para cquery, no especificar esta opción puede hacer que la compilación se rompa si los objetivos analizados desde la expresión de consulta no se pueden compilar con las opciones de nivel superior.
Etiquetas:loading_and_analysis
- Opciones relacionadas con la salida y la semántica de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Se especificaron las versiones de los módulos con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resueltas, incluso si se declaran como eliminadas en el registro del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones rechazadas harán que la resolución falle. También puedes definir la versión generada permitida con la variable de entorno `BZLMOD_ALLOW_YANKED_VERSIONS`. Puedes inhabilitar esta verificación con la palabra clave “todo” (no se recomienda).
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
: "error" -
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivar el caso a una falla de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecta una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas de `bazel_dep` declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]ignore_dev_dependency
: "falso" -
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--lockfile_mode=<off, update or error>
: "actualizar" -
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "error" para usar el archivo de bloqueo, pero arroja un error si no está actualizado, o "off" para que no se lea ni escriba en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <module name>=<path>. Si la ruta de acceso dada es una ruta de acceso absoluta, se usará tal como es. Si la ruta de acceso determinada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso dada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace"
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en registros anteriores y solo se recurrirán a los registros posteriores cuando falten en los registros anteriores.
Etiquetas:changes_inputs
- Valor predeterminado de
--vendor_dir=<a path>
: ver descripción -
Especifica el directorio que debe almacenar los repositorios externos en modo de proveedor, ya sea para recuperarlos o usarlos durante la compilación. La ruta 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 bloquee Bazel con una OOM. Cada límite se especifica como <period>:<count> En el ejemplo anterior, el período es una duración y el recuento es un número entero positivo. Si hay más de --gc_thrashing_threshold por ciento de espacio titular (montón de generación anterior) permanece ocupado después de <count> varias recolecciones de elementos no utilizados consecutivas dentro de <period>, se activará una OOM. Si hay varios límites, puedes separarlos por comas.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: “2147483647”-
Marca de configuración avanzada del motor interno Skyframe de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de recolección de elementos no utilizados completa, eliminará el estado temporal de Skyframe innecesario, hasta esta cantidad de veces por invocación. La configuración predeterminada es Integer.MAX_VALUE; eficazmente ilimitados. Cero significa que los eventos de recolección de elementos no utilizados completas nunca activarán la acción de soltar. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC completo y se supere ese umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: “2147483647”-
Marca de configuración avanzada del motor interno Skyframe de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando ocurra un evento menor de recolección de elementos no utilizados, se eliminará el estado temporal de Skyframe innecesario, hasta esta cantidad de veces por invocación. La configuración predeterminada es Integer.MAX_VALUE; eficazmente ilimitados. Cero significa que los eventos menores de recolección de elementos no utilizados nunca activarán la acción de soltar. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC menor y se supere ese umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
- Valor predeterminado de
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
Marca de configuración avanzada del motor interno Skyframe de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es al menos este umbral, descartará el estado temporal de Skyframe innecesario. Ajustar esto puede permitirte mitigar el impacto en el tiempo de la hiperpaginación de GC cuando la hiperpaginación de GC (i) es causada por el uso de memoria de este estado temporal y (ii) es más costosa que reconstituir el estado cuando sea necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Valor predeterminado de
--experimental_command_profile=<cpu, wall, alloc or lock>
: ver descripción - Registra un perfil de la grabadora de vuelos de Java mientras dure el comando. Se debe proporcionar uno de los tipos de eventos de generación de perfiles admitidos (CPU, muro, asignación 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 la semántica de esta marca podrían cambiar en el futuro para admitir tipos de perfil o formatos de salida adicionales. usar bajo tu propia responsabilidad.
- Valor predeterminado de
--[no]experimental_record_metrics_for_all_mnemonics
: "falso" - De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemónicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán las estadísticas de todos los mnemónicos.
- Opciones que especifican o modifican una entrada genérica para un comando de Bazel que no se encuentra en otras categorías:
- Valor predeterminado de
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remoto:
- Valor predeterminado de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo con el que se configurará el cargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno que debe coincidir y otro para usar como URL sustituta, con referencias inversas a partir de `$1`. Es posible proporcionar varias directivas "rewrite" para la misma URL; en este caso, se devolverán varias URL.
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
predeterminado: "automático"- El modo de subprocesos que se usará para la recuperación del repositorio. Si se configura en “off”, no se usa ningún subproceso de trabajo y la recuperación del repositorio está sujeta a reinicios. De lo contrario, utiliza un subproceso de plataforma (es decir, un subproceso del SO) si está configurado como "platform". o un subproceso virtual si está configurado como “virtual”. Si se configura como "auto", se usan subprocesos virtuales si están disponibles (es decir, si se ejecutan en JDK 21+). De lo contrario, no se utiliza ningún subproceso de trabajador.
- Otras opciones, que no se categorizan de ninguna otra manera:
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso dada es una ruta de acceso absoluta, se usará tal como es. Si la ruta de acceso determinada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso dada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace"
- Opciones que controlan la ejecución de compilación:
- Valor predeterminado de
--[no]experimental_inprocess_symlink_creation
: "falso" -
Especifica si se deben realizar llamadas directas al sistema de archivos para crear árboles de symlinks.
Etiquetas:loading_and_analysis
,execution
yexperimental
- Valor predeterminado de
--[no]experimental_persistent_aar_extractor
: "falso" -
Habilita el extractor de aar persistente con trabajadores.
Etiquetas:execution
- Valor predeterminado de
--[no]experimental_remotable_source_manifests
: "falso" -
Establece si las acciones del manifiesto de la fuente se pueden usar de forma remota.
Etiquetas:loading_and_analysis
,execution
yexperimental
- Valor predeterminado de
--[no]experimental_split_coverage_postprocessing
: "falso" -
Si es verdadero, Bazel ejecutará el procesamiento posterior de cobertura para realizar pruebas en un generación nuevo.
Etiquetas:execution
- Valor predeterminado de
--[no]experimental_strict_fileset_output
: "falso" -
Si se habilita esta opción, los conjuntos de archivos tratarán todos los artefactos de salida como archivos normales. No desviarán directorios ni serán sensibles a los symlinks.
Etiquetas:execution
- Valor predeterminado de
--[no]incompatible_disallow_unsound_directory_outputs
: "true" -
Si se configura, es un error que una acción materialice un archivo de salida como un directorio. No afecta a los directorios de origen. Consulta https://github.com/bazelbuild/bazel/issues/18646.
Etiquetas:bazel_internal_configuration
yincompatible_change
- Valor predeterminado de
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
: "" -
Agrega o quita teclas de la información de ejecución de una acción según el nombre nemotécnico de la acción. Solo se aplica a las acciones que admiten información de ejecución. Muchas acciones comunes admiten información de ejecución, p.ej., Genrule, CppCompile, Javac, StarlarkAction y TestRunner. Cuando se especifican varios valores, el orden es importante porque muchas regex pueden aplicarse al mismo nombre nemotécnico.
Sintaxis: “regex=[+-]key,regex=[+-]key,...”.
Ejemplos:
'.*=+x,.*=-y,.*=+z' agrega una 'x' y en "z" a y quita "y" de la información de ejecución de todas las acciones.
'Genrule=+requires-x' agrega “requiere-x” a la información de ejecución de todas las acciones de Genrule.
“(?!Genrule).*=-required-x” quita “requiere-x” a partir de la información de ejecución
para todas las acciones que no son de Genrule.
Etiquetas:execution
,affects_outputs
yloading_and_analysis
--persistent_android_dex_desugar
-
Habilita acciones persistentes de dex y expansión de sintaxis de Android mediante trabajadores.
Se expande a:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Etiquetas:host_machine_resource_optimizations
yexecution
--persistent_android_resource_processor
-
Habilita el procesador de recursos persistente de Android con trabajadores.
Se expande a:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
de--strategy=AndroidResourceMerger=worker
de--strategy=AndroidCompiledResourceMerger=worker
de--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
de--strategy=AARGenerator=worker
de--strategy=ProcessDatabinding=worker
de--strategy=GenerateDataBindingBaseClasses=worker
Etiquetas:host_machine_resource_optimizations
yexecution
--persistent_multiplex_android_dex_desugar
-
Habilita acciones persistentes de dex y desugar de Android multiplexadas usando trabajadores.
Se expande a:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
Etiquetas:host_machine_resource_optimizations
yexecution
--persistent_multiplex_android_resource_processor
-
Habilita el procesador de recursos multiplexados de Android persistente con trabajadores.
Se expande a:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
de--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
de--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
de--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
de--modify_execution_info=AARGenerator=+supports-multiplex-workers
Etiquetas:host_machine_resource_optimizations
yexecution
--persistent_multiplex_android_tools
-
Habilita herramientas de Android persistentes y multiplexadas (dexing, expansión de sintaxis y procesamiento de recursos).
Se expande a:
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Etiquetas:host_machine_resource_optimizations
yexecution
- Valor predeterminado de
--[no]use_target_platform_for_tests
: "falso" -
Si es verdadero, Bazel usará la plataforma de destino para ejecutar pruebas en lugar del grupo de ejecución de pruebas.
Etiquetas:execution
- Opciones que configuran la cadena de herramientas utilizada para la ejecución de la acción:
- Valor predeterminado de
--android_compiler=<a string>
: ver descripción -
El compilador de destino de Android.
Etiquetas:affects_outputs
,loading_and_analysis
yloses_incremental_state
--android_crosstool_top=<a build target label>
predeterminado: "//external:android/crosstool"-
La ubicación del compilador C++ que se usa para las compilaciones de Android.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
yloses_incremental_state
- Valor predeterminado de
--android_grte_top=<a label>
: ver descripción -
El objetivo de Android grte_top.
Etiquetas:changes_inputs
,loading_and_analysis
yloses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
predeterminado: "android"-
Selecciona la combinación de manifiestos que se usará para las reglas android_binary. Marca para ayudar a la transición de la combinación de manifiestos de Android desde la combinación heredada.
Etiquetas:affects_outputs
,loading_and_analysis
yloses_incremental_state
- Valor predeterminado de
--android_platforms=<a build target label>
: "" -
Establece las plataformas que usan los objetivos android_binary. Si se especifican varias plataformas, el objeto binario es un APK multiarquitectura, que contiene binarios nativos para cada plataforma de destino especificada.
Etiquetas:changes_inputs
,loading_and_analysis
yloses_incremental_state
--android_sdk=<a build target label>
predeterminado: "@bazel_tools//tools/android:sdk"-
Especifica el SDK o la plataforma de Android que se usa para compilar aplicaciones para Android.
Etiquetas:changes_inputs
,loading_and_analysis
yloses_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
ychanges_inputs
- Valor predeterminado de
--cc_output_directory_tag=<a string>
: "" -
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas:affects_outputs
- Valor predeterminado de
--compiler=<a string>
: ver descripción -
El compilador de C++ que se usará para compilar el destino.
Etiquetas:loading_and_analysis
yexecution
--coverage_output_generator=<a build target label>
predeterminado: "@bazel_tools//tools/test:lcov_merger"-
Ubicación del objeto binario que se usa para procesar posteriormente los informes de cobertura sin procesar. Actualmente, debe ser un grupo de archivos que contenga un solo archivo: el objeto binario. La configuración predeterminada es “//tools/test:lcov_merger”.
Etiquetas:changes_inputs
,affects_outputs
yloading_and_analysis
--coverage_report_generator=<a build target label>
predeterminado: “@bazel_tools//tools/test:coverage_report_generator”-
Ubicación del objeto binario que se usa para generar informes de cobertura. Actualmente, debe ser un grupo de archivos que contenga un solo archivo: el objeto binario. La configuración predeterminada es “//tools/test:coverage_report_generator”.
Etiquetas:changes_inputs
,affects_outputs
yloading_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
yloading_and_analysis
--crosstool_top=<a build target label>
predeterminado: “@bazel_tools//tools/cpp:toolchain”-
La etiqueta del paquete de herramientas cruzadas que se usará para compilar el código de C++.
Etiquetas:loading_and_analysis
,changes_inputs
yaffects_outputs
- Valor predeterminado de
--custom_malloc=<a build target label>
: ver descripción -
Especifica una implementación de malloc personalizada. Esta configuración anula los atributos malloc en las reglas de compilación.
Etiquetas:changes_inputs
yaffects_outputs
- Se acumulan
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
usos múltiples -
Lista de expresiones regulares separadas por comas, cada una con el prefijo - (expresión negativa) opcionalmente, asignadas (=) a una lista de objetivos de valores de restricción separados por comas. Si un objetivo no coincide con ninguna expresión negativa y al menos una expresión positiva, la resolución de la cadena de herramientas se realizará como si se hubieran declarado los valores de la restricción como restricciones de ejecución. Ejemplo: //demo,-test=@platforms//cpus:x86_64 agregará 'x86_64' a cualquier destino en //demo, excepto a aquellos cuyo nombre contenga “test”.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]experimental_include_xcode_execution_requirements
: "falso" -
Si está configurado, agrega un campo "requires-xcode:{version}". de ejecución requerido a cada acción de Xcode. Si la versión de Xcode tiene una etiqueta con guiones, agrega también la etiqueta “requires-xcode-label:{version_label}”. de ejecución.
Etiquetas:loses_incremental_state
,loading_and_analysis
yexecution
- Valor predeterminado de
--[no]experimental_prefer_mutual_xcode
: "true" -
Si es verdadero, usa el Xcode más reciente que está disponible de forma local y remota. Si es falso, o si no hay versiones mutuas disponibles, usa la versión de Xcode local seleccionada a través de xcode-select.
Etiquetas:loses_incremental_state
- Valor predeterminado de
--extra_execution_platforms=<comma-separated list of options>
: "" -
Son las plataformas que están disponibles como plataformas de ejecución para ejecutar acciones. Las plataformas se pueden especificar por objetivo exacto o como un patrón de objetivo. Estas plataformas se considerarán antes de las declaradas en el archivo WORKSPACE por register_execution_platforms(). Esta opción solo se puede configurar una vez. las instancias posteriores anularán la configuración de las marcas anteriores.
Etiquetas:execution
- Se acumulan
--extra_toolchains=<comma-separated list of options>
usos múltiples -
Las reglas de la cadena de herramientas que se deben considerar durante su resolución. Las cadenas de herramientas se pueden especificar por objetivo exacto o como un patrón de objetivo. Estas cadenas de herramientas se considerarán antes de las declaradas en el archivo WORKSPACE por register_toolchains().
Etiquetas:affects_outputs
,changes_inputs
yloading_and_analysis
- Valor predeterminado de
--grte_top=<a label>
: ver descripción -
Es una etiqueta para una biblioteca de libc abierta. La cadena de herramientas de crosstool selecciona el valor predeterminado, y casi nunca necesitas anularlo.
Etiquetas:action_command_lines
yaffects_outputs
- Valor predeterminado de
--host_compiler=<a string>
: ver descripción -
El compilador de C++ que se usará para la compilación del host. Se ignora si no se configura --host_crosstool_top.
Etiquetas:loading_and_analysis
yexecution
- Valor predeterminado de
--host_crosstool_top=<a build target label>
: ver descripción -
De forma predeterminada, las opciones --crosstool_top y --compiler también se usan para la configuración de ejecución. Si se proporciona este indicador, Bazel usa el compilador y la libc predeterminados para el crosstool_top específico.
Etiquetas:loading_and_analysis
,changes_inputs
yaffects_outputs
- Valor predeterminado de
--host_grte_top=<a label>
: ver descripción -
Si se especifica, esta configuración anula el directorio de nivel superior de libc (--grte_top) para la configuración de exec.
Etiquetas:action_command_lines
yaffects_outputs
--host_platform=<a build target label>
predeterminado: “@local_config_platform//:host”-
Es la etiqueta de una regla de la plataforma que describe el sistema host.
Etiquetas:affects_outputs
,changes_inputs
yloading_and_analysis
- Valor predeterminado de
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
: "true" -
Si es verdadero, Bazel no habilitará “host”. y “no host” de la cadena de herramientas de c++ (consulta https://github.com/bazelbuild/bazel/issues/7407 para obtener más información).
Etiquetas:loading_and_analysis
yincompatible_change
- Valor predeterminado de
--[no]incompatible_enable_android_toolchain_resolution
: "true" -
Usa la resolución de la cadena de herramientas para seleccionar el SDK de Android para las reglas de Android (Starlark y nativo)
Etiquetas:loading_and_analysis
yincompatible_change
- Valor predeterminado de
--[no]incompatible_enable_apple_toolchain_resolution
: "falso" -
Usa la resolución de la cadena de herramientas para seleccionar el SDK de Apple para las reglas de Apple (Starlark y nativo)
Etiquetas:loading_and_analysis
yincompatible_change
- Valor predeterminado de
--[no]incompatible_make_thinlto_command_lines_standalone
: "true" -
Si es verdadero, Bazel no reutilizará las líneas de comandos de acción de vínculo de C++ para las líneas de comandos de indexación lto (consulta https://github.com/bazelbuild/bazel/issues/6791 para obtener más información).
Etiquetas:loading_and_analysis
yincompatible_change
- Valor predeterminado de
--[no]incompatible_remove_legacy_whole_archive
: "true" -
Si es verdadero, Bazel no vinculará las dependencias de bibliotecas como archivos completos de forma predeterminada (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener instrucciones de migración).
Etiquetas:loading_and_analysis
yincompatible_change
- Valor predeterminado de
--[no]incompatible_require_ctx_in_configure_features
: "true" -
Si el valor es verdadero, Bazel requerirá "{4/}". en cc_common.configure_features (consulta https://github.com/bazelbuild/bazel/issues/7793 para obtener más información).
Etiquetas:loading_and_analysis
yincompatible_change
-
Usa objetos compartidos de la interfaz si la cadena de herramientas lo admite. Actualmente, todas las cadenas de herramientas ELF admiten esta configuración.
Etiquetas:loading_and_analysis
,affects_outputs
yaffects_outputs
- Valor predeterminado de
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Especifica la versión del SDK de iOS que se usará para compilar aplicaciones de iOS. Si no se especifica, usa la versión predeterminada del SDK de iOS de “xcode_version”.
Etiquetas:loses_incremental_state
- Valor predeterminado de
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Especifica la versión del SDK de macOS que se usará para compilar aplicaciones de macOS. Si no se especifica, se usa la versión predeterminada del SDK de macOS de “xcode_version”.
Etiquetas:loses_incremental_state
- Valor predeterminado de
--minimum_os_version=<a string>
: ver descripción -
La versión mínima del SO a la que se orienta tu compilación.
Etiquetas:loading_and_analysis
yaffects_outputs
- Valor predeterminado de
--platform_mappings=<a relative path>
: "" -
La ubicación de un archivo de asignación que describe qué plataforma usar si no hay ninguna establecida o qué marcas se deben configurar cuando ya existe una plataforma. Debe estar relacionada con la raíz principal del lugar de trabajo. La configuración predeterminada es “platform_mappings”. (un archivo directamente debajo de la raíz del espacio de trabajo).
Etiquetas:affects_outputs
,changes_inputs
yloading_and_analysis
- Valor predeterminado de
--platforms=<a build target label>
: "" -
Las etiquetas de las reglas de la plataforma que describen las plataformas de destino para el comando actual.
Etiquetas:affects_outputs
,changes_inputs
yloading_and_analysis
- Valor predeterminado de
--python2_path=<a string>
: ver descripción -
Obsoleto, no-op. Inhabilitado por `--incompatible_use_python_toolchains`.
Etiquetas:no_op
ydeprecated
- Valor predeterminado de
--python3_path=<a string>
: ver descripción -
Obsoleto, no-op. Inhabilitado por `--incompatible_use_python_toolchains`.
Etiquetas:no_op
ydeprecated
- Valor predeterminado de
--python_path=<a string>
: ver descripción -
La ruta de acceso absoluta del intérprete de Python invocado para ejecutar objetivos de Python en la plataforma de destino. Obsoleto; inhabilitado por --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
yaffects_outputs
- Valor predeterminado de
--python_top=<a build target label>
: ver descripción -
Es la etiqueta de un py_runtime que representa el intérprete de Python invocado para ejecutar objetivos de Python en la plataforma de destino. Obsoleto; inhabilitado por --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
yaffects_outputs
- Valor predeterminado de
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Especifica la versión del SDK de tvOS que se usará para compilar aplicaciones de tvOS. Si no se especifica, usa la versión predeterminada del SDK de tvOS de "xcode_version".
Etiquetas:loses_incremental_state
- Valor predeterminado de
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Especifica la versión del SDK de watchOS que se usará para compilar aplicaciones de watchOS. Si no se especifica, se usa la versión predeterminada del SDK de watchOS de “xcode_version”.
Etiquetas:loses_incremental_state
- Valor predeterminado de
--xcode_version=<a string>
: ver descripción -
Si se especifica, usa Xcode de la versión determinada para las acciones de compilación relevantes. Si no se especifica, usa la versión predeterminada del ejecutor de Xcode.
Etiquetas:loses_incremental_state
--xcode_version_config=<a build target label>
predeterminado: “@bazel_tools//tools/cpp:host_xcodes”-
La etiqueta de la regla xcode_config que se usará para seleccionar la versión de Xcode en la configuración de compilación.
Etiquetas:loses_incremental_state
yloading_and_analysis
- Opciones que controlan el resultado del comando:
- Valor predeterminado de
--[no]apple_generate_dsym
: "falso" -
Indica si se deben generar archivos de símbolos de depuración (.dSYM).
Etiquetas:affects_outputs
yaction_command_lines
- Valor predeterminado de
--[no]build_runfile_links
: "true" -
Si es verdadero, compila bosques de symlink de archivos de ejecución para todos los destinos. Si es falso, escríbelos solo cuando lo requiera una acción local, prueba o comando de ejecución.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]build_runfile_manifests
: "true" -
Si es verdadero, escribe manifiestos de archivos de ejecución para todos los destinos. Si es falsa, omítelas. Las pruebas locales no se ejecutarán si el valor es falso.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]build_test_dwp
: "falso" -
Si se habilita, al compilar pruebas de C++ de forma estática y con fisión, también se compilará automáticamente el archivo .dwp para el objeto binario de prueba.
Etiquetas:loading_and_analysis
yaffects_outputs
--cc_proto_library_header_suffixes=<comma-separated set of options>
predeterminado: ".pb.h"-
Establece los sufijos de los archivos de encabezado que crea cc_proto_library.
Etiquetas:affects_outputs
yloading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated set of options>
predeterminado: ".pb.cc"-
Establece los sufijos de los archivos de origen que crea cc_proto_library.
Etiquetas:affects_outputs
yloading_and_analysis
- Valor predeterminado de
--[no]experimental_proto_descriptor_sets_include_source_info
: "falso" -
Ejecuta acciones adicionales para versiones alternativas de la API de Java en una proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
yexperimental
- Valor predeterminado de
--[no]experimental_proto_extra_actions
: "falso" -
Ejecuta acciones adicionales para versiones alternativas de la API de Java en una proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
yexperimental
- Valor predeterminado de
--[no]experimental_save_feature_state
: "falso" -
Guarda el estado de las funciones habilitadas y solicitadas como resultado de la compilación.
Etiquetas:affects_outputs
yexperimental
--fission=<a set of compilation modes>
predeterminado: "no"-
Especifica qué modos de compilación usan la fisión para compilaciones y vínculos de C++. Puede ser cualquier combinación de {'fastbuild', 'dbg', 'opt'} o los valores especiales 'sí' para habilitar todos los modos y hacer clic en "no". para inhabilitar todos los modos.
Etiquetas:loading_and_analysis
,action_command_lines
yaffects_outputs
- Valor predeterminado de
--[no]incompatible_always_include_files_in_data
: "true" -
Si esta preferencia se establece como "true", las reglas nativas agregarán <code>DefaultInfo.files</code>. de las dependencias de datos a sus runfiles, lo que coincide con el comportamiento recomendado para las reglas de Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid).
Etiquetas:affects_outputs
yincompatible_change
- Valor predeterminado de
--[no]legacy_external_runfiles
: "true" -
Si es verdadero, compila bosques de symlink de archivos de ejecución para repositorios externos en .runfiles/wsname/external/repo (además de .runfiles/repo).
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]objc_generate_linkmap
: "falso" -
Especifica si se debe generar un archivo de mapa de vínculos.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]save_temps
: "falso" -
Si lo estableces, se guardarán los resultados temporales de GCC. Entre estos, se incluyen archivos .s (código ensamblador), .i (C++ previamente procesado) y .ii (C++ previamente procesados).
Etiquetas:affects_outputs
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
- Se acumulan
--action_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica el conjunto de variables de entorno disponibles para las acciones con configuración de destino. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o por el par nombre=valor que establece el valor de forma independiente del entorno de invocación. Esta opción se puede usar varias veces. en el caso de opciones proporcionadas para la misma variable, se acumulan las últimas victorias y se acumulan opciones para diferentes variables.
Etiquetas:action_command_lines
--android_cpu=<a string>
predeterminado: "armeabi-v7a"-
La CPU de destino de Android
Etiquetas:affects_outputs
,loading_and_analysis
yloses_incremental_state
- Valor predeterminado de
--[no]android_databinding_use_androidx
: "true" -
Genera archivos de vinculación de datos compatibles con AndroidX. Esto solo se usa con la vinculación de datos v2. Esta marca es una no-op.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
yexperimental
- Valor predeterminado de
--[no]android_databinding_use_v3_4_args
: "true" -
Usa android databinding v2 con el argumento 3.4.0. Esta marca es una no-op.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
yexperimental
- Configuración predeterminada de
--android_dynamic_mode=<off, default or fully>
: "desactivada" -
Determina si las dependencias de C++ de reglas de Android se vincularán dinámicamente cuando un objeto cc_binary no cree explícitamente una biblioteca compartida. 'predeterminado' significa que Bazel elegirá si realizar la vinculación de forma dinámica. "completamente" significa que todas las bibliotecas se vincularán de forma dinámica. "desactivado" significa que todas las bibliotecas se vincularán
en su mayoría en modo estático.
Etiquetas:affects_outputs
yloading_and_analysis
- Valor predeterminado de
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
: "alfabético" -
Establece el orden de los manifiestos que se pasan a la combinación de manifiestos para los objetos binarios de Android. ALFABÉTICO significa que los manifiestos se ordenan por ruta de acceso relativa a execroot. ALPHABETICAL_BY_CONFIGURATION significa que los manifiestos se ordenan por rutas de acceso relacionadas con el directorio de configuración dentro del directorio de salida. DEPENDENCY significa que los manifiestos se ordenan; el de cada biblioteca antecede a los de sus dependencias.
Etiquetas:action_command_lines
yexecution
- Valor predeterminado de
--[no]android_resource_shrinking
: "falso" -
Habilita la reducción de recursos para los APK android_binary que usan ProGuard.
Etiquetas:affects_outputs
yloading_and_analysis
--[no]build_python_zip
predeterminado: "automático"-
Compila el archivo ZIP ejecutable de Python; Activado en Windows y desactivado en otras plataformas
Etiquetas:affects_outputs
- Se acumulan
--catalyst_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se compilarán objetos binarios de Apple Catalyst.
Etiquetas:loses_incremental_state
yloading_and_analysis
- Valor predeterminado de
--[no]collect_code_coverage
: "falso" -
Si se especifica, Bazel instrumentará el código (usando instrumentación sin conexión cuando sea posible) y recopilará información de cobertura durante las pruebas. Solo se verán afectadas las orientaciones que coincidan con --instrumentation_filter. Por lo general, esta opción no debe especificarse directamente: "cobertura de Bazel". en su lugar.
Etiquetas:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] predeterminado: "fastbuild"-
Especifica el modo en que se compilará el objeto binario. Valores: “fastbuild”, “dbg”, “opt”.
Etiquetas:affects_outputs
yaction_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
yaffects_outputs
- Se acumulan
--copt=<a string>
usos múltiples -
Opciones adicionales para pasar a gcc.
Etiquetas:action_command_lines
yaffects_outputs
- Valor predeterminado de
--cpu=<a string>
: "" -
La CPU de destino.
Etiquetas:changes_inputs
yaffects_outputs
- Valor predeterminado de
--cs_fdo_absolute_path=<a string>
: ver descripción -
Usa la información de perfil de CSFDO para optimizar la compilación. Especifica el nombre de la ruta de acceso absoluta del archivo ZIP que contiene el archivo de perfil, un archivo de perfil de LLVM indexado o sin procesar.
Etiquetas:affects_outputs
- Valor predeterminado de
--cs_fdo_instrument=<a string>
: ver descripción -
Genera objetos binarios con instrumentación FDO sensible al contexto. Con el compilador Clang/LLVM, también acepta el nombre del directorio bajo el cual se volcarán los archivos de perfil sin procesar en el tiempo de ejecución.
Etiquetas:affects_outputs
- Valor predeterminado de
--cs_fdo_profile=<a build target label>
: ver descripción -
El cs_fdo_profile que representa el perfil sensible al contexto que se usará para la optimización.
Etiquetas:affects_outputs
- Se acumulan
--cxxopt=<a string>
usos múltiples -
Es una opción adicional para pasar a gcc cuando se compilan archivos de origen C++.
Etiquetas:action_command_lines
yaffects_outputs
- Se acumulan
--define=<a 'name=value' assignment>
usos múltiples -
Cada opción --define especifica una asignación para una variable de compilación.
Etiquetas:changes_inputs
yaffects_outputs
- Valor predeterminado de
--dynamic_mode=<off, default or fully>
: “predeterminado” -
Determina si se vincularán dinámicamente los objetos binarios de C++. 'predeterminado' significa que Bazel elegirá si realizar la vinculación de forma dinámica. "completamente" significa que todas las bibliotecas se vincularán de forma dinámica. "desactivado" significa que todas las bibliotecas se vincularán
en su mayoría en modo estático.
Etiquetas:loading_and_analysis
yaffects_outputs
- Valor predeterminado de
--[no]enable_fdo_profile_absolute_path
: "true" -
Si se configura, el uso de fdo_logical_profile_path generará un error.
Etiquetas:affects_outputs
--[no]enable_runfiles
predeterminado: "automático"-
Habilitar el árbol de symlink de archivos de ejecución De forma predeterminada, la función está desactivada en Windows y activada en otras plataformas.
Etiquetas:affects_outputs
- Se acumulan
--experimental_action_listener=<a build target label>
usos múltiples -
Obsoleto para dar lugar a aspectos. Usa action_listener para adjuntar una extra_action a las acciones de compilación existentes.
Etiquetas:execution
yexperimental
- Valor predeterminado de
--[no]experimental_android_compress_java_resources
: "falso" -
Comprime recursos de Java en los APK
Etiquetas:affects_outputs
,loading_and_analysis
yexperimental
- Valor predeterminado de
--[no]experimental_android_databinding_v2
: "true" -
Usa Android Databinding v2. Esta marca es una no-op.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
yexperimental
- Valor predeterminado de
--[no]experimental_android_resource_shrinking
: "falso" -
Habilita la reducción de recursos para los APK android_binary que usan ProGuard.
Etiquetas:affects_outputs
yloading_and_analysis
- Valor predeterminado de
--[no]experimental_android_rewrite_dexes_with_rex
: "falso" -
usar la herramienta rex para reescribir archivos dex
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
yexperimental
- Valor predeterminado de
--[no]experimental_collect_code_coverage_for_generated_files
: "falso" -
Si se especifica, Bazel también recopilará información de cobertura para los archivos generados.
Etiquetas:affects_outputs
--experimental_objc_fastbuild_options=<comma-separated list of options>
predeterminado: "-O0,-DDEBUG=1"-
Usa estas cadenas como opciones del compilador objc fastbuild.
Etiquetas:action_command_lines
- Valor predeterminado de
--[no]experimental_omitfp
: "falso" -
Si es verdadero, usa libunwind para desenrollar la pila y compila con -fomit-frame-pointer y -faasync-unwind-tables.
Etiquetas:action_command_lines
,affects_outputs
yexperimental
- Configuración predeterminada de
--experimental_output_paths=<off, content or strip>
: "desactivada" -
Qué modelo usar para dónde en las reglas del árbol de salida se escriben sus resultados, en particular para compilaciones multiplataforma o con varias configuraciones. Esto es altamente experimental. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/6526. Las acciones de Starlark pueden habilitar la asignación de rutas agregando la tecla “supports-path-mapping”. a los requisitos de ejecución dict.
Etiquetas:loses_incremental_state
,bazel_internal_configuration
,affects_outputs
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 es el nombre corto deseado para usar en la ruta de salida. Solo se utiliza cuando --experimental_platform_in_output_dir es verdadero. Tiene la prioridad de nomenclatura más alta.
Etiquetas:affects_outputs
yexperimental
- Valor predeterminado de
--[no]experimental_platform_in_output_dir
: "falso" -
Si es verdadero, se usa un nombre corto para la plataforma de destino en el nombre del directorio de salida en lugar de la CPU. El esquema exacto es experimental y está sujeto a cambios. En primer lugar, en el caso poco probable de que la opción --platforms no tenga exactamente un valor, se utiliza un hash de la opción de plataformas. A continuación, si --experimental_override_name_platform_in_output_dir registró algún nombre corto para la plataforma actual, se utilizará ese nombre corto. Luego, si se configuró --experimental_use_platforms_in_output_dir_legacy_heuristic, use un nombre corto basado en la etiqueta de la plataforma actual. Por último, se usa un hash de la opción de plataforma como último recurso.
Etiquetas:affects_outputs
yexperimental
- Valor predeterminado de
--[no]experimental_use_llvm_covmap
: "falso" -
Si se especifica, Bazel generará información del mapa de cobertura llvm-cov en lugar de gcov cuando collect_code_coverage esté habilitado.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
yexperimental
- Valor predeterminado de
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic
: "true" -
Solo usa esta marca como parte de una estrategia de prueba o migración sugerida. Ten en cuenta que la heurística presenta deficiencias conocidas y se sugiere migrar a solo --experimental_override_name_platform_in_output_dir.
Etiquetas:affects_outputs
yexperimental
--fat_apk_cpu=<comma-separated set of options>
predeterminado: "armeabi-v7a"-
Configurar esta opción habilita los APK multiarquitectura, que contienen objetos binarios nativos para todas las arquitecturas de destino especificadas, p.ej., --fat_apk_cpu=x86,armeabi-v7a. Si se especifica esta marca, se ignora --android_cpu para las dependencias de las reglas android_binary.
Etiquetas:affects_outputs
,loading_and_analysis
yloses_incremental_state
- Valor predeterminado de
--[no]fat_apk_hwasan
: "falso" -
Establece si se deben crear divisiones de HWASAN.
Etiquetas:affects_outputs
,loading_and_analysis
yloses_incremental_state
- Valor predeterminado de
--fdo_instrument=<a string>
: ver descripción -
Generar objetos binarios con instrumentación FDO Con el compilador Clang/LLVM, también acepta el nombre del directorio bajo el cual se volcarán los archivos de perfil sin procesar en el tiempo de ejecución.
Etiquetas:affects_outputs
- Valor predeterminado de
--fdo_optimize=<a string>
: ver descripción -
Usa la información del perfil FDO para optimizar la compilación. Especifica el nombre de un archivo ZIP que contenga un árbol de archivos .gcda, un archivo afdo que contenga un perfil automático o un archivo de perfil LLVM. Esta marca también acepta archivos especificados como etiquetas (p.ej., `//foo/bar:file.afdo`; es posible que debas agregar una directiva `exports_files` al paquete correspondiente) y etiquetas que apunten a destinos de `fdo_profile`. Esta marca se reemplazará por la regla `fdo_profile`.
Etiquetas:affects_outputs
- Valor predeterminado de
--fdo_prefetch_hints=<a build target label>
: ver descripción -
Usa sugerencias de carga previa de caché.
Etiquetas:affects_outputs
- Valor predeterminado de
--fdo_profile=<a build target label>
: ver descripción -
El fdo_profile que representa el perfil que se utilizará para la optimización.
Etiquetas:affects_outputs
- Se acumulan
--features=<a string>
usos múltiples -
Las funciones determinadas estarán habilitadas o inhabilitadas de forma predeterminada para los destinos integrados en la configuración de destino. Especificando -<feature> la inhabilitará. Los atributos negativos siempre anulan los positivos. Consulta también --host_features
Etiquetas:changes_inputs
yaffects_outputs
- Valor predeterminado de
--[no]force_pic
: "falso" -
Si se habilitan, todas las compilaciones de C++ producen código independiente de la posición ("-fPIC"), los vínculos prefieren bibliotecas PIC compiladas previamente en lugar de bibliotecas que no son PIC y producen ejecutables independientes de la posición ("-pie").
Etiquetas:loading_and_analysis
yaffects_outputs
- Se acumulan
--host_action_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica el conjunto de variables de entorno disponibles para acciones con configuraciones de ejecución. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o por el par nombre=valor que establece el valor de forma independiente del entorno de invocación. Esta opción se puede usar varias veces. en el caso de opciones proporcionadas para la misma variable, se acumulan las últimas victorias y se acumulan opciones para diferentes variables.
Etiquetas:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
predeterminado: "opt"-
Especifica el modo en que se integrarán las herramientas usadas durante la compilación. Valores: “fastbuild”, “dbg”, “opt”.
Etiquetas:affects_outputs
yaction_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
yaffects_outputs
- Se acumulan
--host_copt=<a string>
usos múltiples -
Opciones adicionales para pasar al compilador C para herramientas integradas en las configuraciones de ejecución.
Etiquetas:action_command_lines
yaffects_outputs
- Valor predeterminado de
--host_cpu=<a string>
: "" -
La CPU host
Etiquetas:changes_inputs
yaffects_outputs
- Se acumulan
--host_cxxopt=<a string>
usos múltiples -
Opciones adicionales para pasar al compilador C++ en el caso de las herramientas integradas en las configuraciones de ejecución.
Etiquetas:action_command_lines
yaffects_outputs
- Se acumulan
--host_features=<a string>
usos múltiples -
Las funciones determinadas estarán habilitadas o inhabilitadas de forma predeterminada para los destinos compilados en la configuración de ejecución. Especificando -<feature> la inhabilitará. Los atributos negativos siempre anulan los positivos.
Etiquetas:changes_inputs
yaffects_outputs
- Valor predeterminado de
--host_force_python=<PY2 or PY3>
: ver descripción -
Anula la versión de Python para la configuración de ejecución. Puede ser "PY2". o “PY3”.
Etiquetas:loading_and_analysis
yaffects_outputs
- Se acumulan
--host_linkopt=<a string>
usos múltiples -
Es una opción adicional para pasar al vinculador cuando se vinculan herramientas en las configuraciones de ejecución.
Etiquetas:action_command_lines
yaffects_outputs
- Valor predeterminado de
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima de macOS compatible para los destinos de host. Si no se especifica, usa "macos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
usos múltiples -
Opciones adicionales para pasar de forma selectiva al compilador C/C++ cuando compilas ciertos archivos en las configuraciones de ejecución. Esta opción se puede aprobar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter significa una lista de patrones de inclusión y exclusión de expresiones regulares (consulta también --instrumentation_filter). opción_1 a option_n significa opciones arbitrarias de la línea de comandos. Si una opción contiene una coma, se debe colocar entre una barra inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos gcc de todos los archivos cc en //foo/, excepto bar.cc.
Etiquetas:action_command_lines
yaffects_outputs
- Se acumulan
--host_swiftcopt=<a string>
usos múltiples -
Opciones adicionales para pasar a swiftc para herramientas de ejecución.
Etiquetas:action_command_lines
yaffects_outputs
- Valor predeterminado de
--[no]incompatible_auto_exec_groups
: "falso" -
Cuando se habilita, se crea automáticamente un grupo de ejecución para cada cadena de herramientas que usa una regla. Para que esta regla funcione, se debe especificar el parámetro `toolchain` en sus acciones. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/17134.
Etiquetas:affects_outputs
yincompatible_change
- Valor predeterminado de
--[no]incompatible_merge_genfiles_directory
: "true" -
Si es verdadero, el directorio genfiles se pliega en el directorio bin.
Etiquetas:affects_outputs
yincompatible_change
- Valor predeterminado de
--[no]incompatible_use_host_features
: "true" -
Si es verdadero, usa --features solo para la configuración de destino y --host_features para la configuración de ejecución.
Etiquetas:changes_inputs
,affects_outputs
yincompatible_change
- Valor predeterminado de
--[no]instrument_test_targets
: "falso" -
Cuando la cobertura está habilitada, especifica si se deben considerar reglas de prueba. Cuando se establecen, se instrumentan las reglas de prueba incluidas por --instrumentation_filter. De lo contrario, las reglas de prueba siempre se excluyen de la instrumentación de cobertura.
Etiquetas:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
predeterminado: "-/javatests[/:],-/test/java[/:]"-
Cuando se habilite la cobertura, solo se instrumentarán las reglas con nombres incluidos por el filtro basado en regex especificado. Reglas con el prefijo “-” en su lugar. Ten en cuenta que solo se instrumentan las reglas que no son de prueba, a menos que se habilite --instrument_test_targets.
Etiquetas:affects_outputs
- Valor predeterminado de
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión de iOS mínima compatible para simuladores y dispositivos de destino. Si no se especifica, usa "ios_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan
--ios_multi_cpus=<comma-separated list of options>
usos múltiples -
Lista separada por comas de arquitecturas con las que se compilará una aplicación ios_application. El resultado es un objeto binario universal que contiene todas las arquitecturas especificadas.
Etiquetas:loses_incremental_state
yloading_and_analysis
- Valor predeterminado de
--[no]legacy_whole_archive
: "true" -
Obsoleto y sustituido por --incompatible_remove_legacy_whole_archive (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener más información). Cuando esta opción esté activada, usa --whole-archive para las reglas cc_binary que tengan linkshared=True y linkstatic=True o '-static'. en linkopts. Esto es solo para la retrocompatibilidad. Una mejor alternativa es usar Alwayslink=1 cuando sea necesario.
Etiquetas:action_command_lines
,affects_outputs
ydeprecated
- 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
yaffects_outputs
- Se acumulan
--ltobackendopt=<a string>
usos múltiples -
Es una opción adicional para pasar al paso del backend de LTO (en --features=thin_lto).
Etiquetas:action_command_lines
yaffects_outputs
- Se acumulan
--ltoindexopt=<a string>
usos múltiples -
Es una opción adicional para pasar al paso de indexación de LTO (en --features=thin_lto).
Etiquetas:action_command_lines
yaffects_outputs
- Se acumulan
--macos_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se compilarán objetos binarios de Apple macOS.
Etiquetas:loses_incremental_state
yloading_and_analysis
- Valor predeterminado de
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima de macOS compatible para destinos. Si no se especifica, usa "macos_sdk_version".
Etiquetas:loses_incremental_state
- Valor predeterminado de
--memprof_profile=<a build target label>
: ver descripción -
Usar perfil de memprof.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]objc_debug_with_GLIBCXX
: "falso" -
Si se establece y el modo de compilación está establecido en "dbg", define GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC y GLIBCPP_CONCEPT_CHECKS.
Etiquetas:action_command_lines
- Valor predeterminado de
--[no]objc_enable_binary_stripping
: "falso" -
Indica si se deben realizar eliminaciones de símbolos y de código no muerto en objetos binarios vinculados. Se realizarán eliminaciones de objetos binarios si se especifican esta marca y --compilation_mode=opt.
Etiquetas:action_command_lines
- Se acumulan
--objccopt=<a string>
usos múltiples -
Opciones adicionales para pasar a gcc cuando se compilan archivos de origen Objective-C/C++.
Etiquetas:action_command_lines
- Se acumulan
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
usos múltiples -
Opciones adicionales para pasar a gcc de forma selectiva cuando se compilan ciertos archivos. Esta opción se puede aprobar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter significa una lista de patrones de inclusión y exclusión de expresiones regulares (consulta también --instrumentation_filter). opción_1 a option_n significa opciones arbitrarias de la línea de comandos. Si una opción contiene una coma, se debe colocar entre una barra inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos gcc de todos los archivos cc en //foo/, excepto bar.cc.
Etiquetas:action_command_lines
yaffects_outputs
- Se acumulan
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
usos múltiples -
Opciones adicionales para pasar de forma selectiva al backend de LTO (en --features=thin_lto) cuando se compilan ciertos objetos de backend. Esta opción se puede aprobar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter significa una lista de patrones de incluir y excluir expresiones regulares. opción_1 a option_n significa opciones arbitrarias de la línea de comandos. Si una opción contiene una coma, se debe colocar entre una barra inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos del backend LTO de todos los archivos o en //foo/ excepto bar.o.
Etiquetas:action_command_lines
yaffects_outputs
- Valor predeterminado de
--platform_suffix=<a string>
: ver descripción -
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas:loses_incremental_state
,affects_outputs
yloading_and_analysis
- Valor predeterminado de
--propeller_optimize=<a build target label>
: ver descripción -
Usa la información del perfil de Propeller para optimizar el objetivo de la compilación.Un perfil de propeller debe constar de al menos uno de dos archivos, un perfil cc y un perfil ld. Esta marca acepta una etiqueta de compilación que debe hacer referencia a los archivos de entrada del perfil del propeler. Por ejemplo, el archivo COMPILAR que define la etiqueta, en a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)Es posible que se deba agregar una directiva export_files al paquete correspondiente para que estos archivos sean visibles para Bazel. La opción debe usarse como: --propeller_optimize=//a/b:propeller_profile
Etiquetas:action_command_lines
yaffects_outputs
- Valor predeterminado de
--propeller_optimize_absolute_cc_profile=<a string>
: ver descripción -
Nombre de la ruta de acceso absoluta del archivo cc_profile para compilaciones de Propeller Optimized.
Etiquetas:affects_outputs
- Valor predeterminado de
--propeller_optimize_absolute_ld_profile=<a string>
: ver descripción -
Nombre de la ruta de acceso absoluta del archivo ld_profile para compilaciones de Propeller Optimized.
Etiquetas:affects_outputs
- Valor predeterminado de
--run_under=<a prefix in front of command>
: ver descripción -
Prefijo para insertar antes de los ejecutables para la “prueba” y "ejecutar" con comandos de SQL sencillos. Si el valor es “foo -bar” y la línea de comandos de ejecución es “test_binary -baz”, la última línea de comandos es “foo -bar test_binary -baz”. También puede ser una etiqueta para un destino ejecutable. Estos son algunos ejemplos: 'valgrind', 'strace', 'strace -c', 'valgrind --quiet --num-callers=20', '//package:target', '//package:target --options'.
Etiquetas:action_command_lines
-
Si es verdadero, las bibliotecas nativas que contengan una funcionalidad idéntica se compartirán entre diferentes destinos
Etiquetas:loading_and_analysis
yaffects_outputs
- Valor predeterminado de
--[no]stamp
: "falso" -
Sella objetos binarios con la fecha, el nombre de usuario, el nombre de host, la información del espacio de trabajo, etcétera.
Etiquetas:affects_outputs
--strip=<always, sometimes or never>
predeterminado: “a veces”-
Especifica si se deben eliminar los objetos binarios y las bibliotecas compartidas (mediante "-Wl,--strip-debug"). El valor predeterminado de “A veces” significa quitar iff --compilation_mode=fastbuild.
Etiquetas:affects_outputs
- Se acumulan
--stripopt=<a string>
usos múltiples -
Opciones adicionales para pasar a la barra cuando se genera un archivo '<name>.stripped' binario.
Etiquetas:action_command_lines
yaffects_outputs
- Se acumulan
--swiftcopt=<a string>
usos múltiples -
Opciones adicionales para pasar a la compilación de Swift.
Etiquetas:action_command_lines
- Se acumulan
--tvos_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se compilarán objetos binarios de tvOS de Apple.
Etiquetas:loses_incremental_state
yloading_and_analysis
- Valor predeterminado de
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima de tvOS compatible para dispositivos y simuladores de destino. Si no se especifica, usa "tvos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan
--visionos_cpus=<comma-separated list of options>
usos múltiples -
Lista separada por comas de arquitecturas para las que se compilarán objetos binarios de visionOS de Apple.
Etiquetas:loses_incremental_state
yloading_and_analysis
- Se acumulan
--watchos_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para compilar objetos binarios de watchOS de Apple.
Etiquetas:loses_incremental_state
yloading_and_analysis
- Valor predeterminado de
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima de watchOS compatible con simuladores y dispositivos de destino. Si no se especifica, usa “watchos_sdk_version”.
Etiquetas:loses_incremental_state
- Valor predeterminado de
--xbinary_fdo=<a build target label>
: ver descripción -
Usa la información de perfil de XbinaryFDO para optimizar la compilación. Especifica el nombre del perfil de multibinario predeterminado. Cuando la opción se usa junto con --fdo_instrument/--fdo_optimize/--fdo_profile, esas opciones siempre prevalecerán como si nunca se especificara xbinary_fdo.
Etiquetas:affects_outputs
- Opciones que afectan la precisión con la que Bazel aplica entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
- Valor predeterminado de
--auto_cpu_environment_group=<a build target label>
: "" -
Declara el grupo de entorno que se usará para asignar automáticamente los valores de la CPU a los valores de target_environment.
Etiquetas:changes_inputs
,loading_and_analysis
yexperimental
- Valor predeterminado de
--[no]check_licenses
: "falso" -
Verifica que las restricciones de licencias impuestas por los paquetes dependientes no entren en conflicto con los modos de distribución de los objetivos que se compilan. De forma predeterminada, las licencias no están marcadas.
Etiquetas:build_file_semantics
- Valor predeterminado de
--[no]check_visibility
: "true" -
Si se inhabilita, los errores de visibilidad en las dependencias objetivo descienden a advertencias.
Etiquetas:build_file_semantics
- Valor predeterminado de
--[no]desugar_for_android
: "true" -
Establece si se debe expandir el código de bytes de Java 8 antes de la conversión a DEX.
Etiquetas:affects_outputs
,loading_and_analysis
yloses_incremental_state
- Valor predeterminado de
--[no]desugar_java8_libs
: "falso" -
Especifica si se deben incluir bibliotecas de Java 8 compatibles en las apps para dispositivos heredados.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
yexperimental
- Valor predeterminado de
--[no]enforce_constraints
: "true" -
Verifica los entornos con los que cada destino es compatible y, luego, informa los errores si alguno de ellos tiene dependencias que no admiten los mismos entornos.
Etiquetas:build_file_semantics
- Valor predeterminado de
--[no]experimental_check_desugar_deps
: "true" -
Establece si se debe verificar la expansión de sintaxis correcta a nivel del objeto binario de Android.
Etiquetas:eagerness_to_exit
,loading_and_analysis
yexperimental
- Configuración predeterminada de
--experimental_import_deps_checking=<off, warning or error>
: "DESACTIVADA" -
Cuando se habilita, se verifica si las dependencias de aar_import están completas. Esta aplicación puede romper la compilación o generar advertencias.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--experimental_strict_java_deps=<off, warn, error, strict or default>
: “predeterminado” -
Si es verdadero, comprueba que un destino de Java declare de manera explícita todos los objetivos usados directamente como dependencias.
Etiquetas:build_file_semantics
yeagerness_to_exit
- Valor predeterminado de
--[no]incompatible_check_testonly_for_output_files
: "falso" -
Si se habilita, comprueba los objetivos de prerrequisito de solo prueba que son archivos de salida buscando solo la prueba de la regla que se genera. Esto coincide con la verificación de visibilidad.
Etiquetas:build_file_semantics
yincompatible_change
- Valor predeterminado de
--[no]incompatible_check_visibility_for_toolchains
: "falso" -
Si se habilita, la verificación de visibilidad también se aplica a las implementaciones de cadenas de herramientas.
Etiquetas:build_file_semantics
yincompatible_change
- Valor predeterminado de
--[no]incompatible_disable_native_android_rules
: "falso" -
Si se habilita esta opción, se inhabilitará el uso directo de las reglas nativas de Android. Usa las reglas de Starlark para Android que se encuentran en https://github.com/bazelbuild/rules_android
Etiquetas:eagerness_to_exit
yincompatible_change
- Valor predeterminado de
--[no]incompatible_disable_native_apple_binary_rule
: "falso" -
No-ops. Se guardan aquí para brindar retrocompatibilidad.
Etiquetas:eagerness_to_exit
yincompatible_change
- Valor predeterminado de
--[no]incompatible_python_disable_py2
: "true" -
Si es verdadero, usar la configuración de Python 2 generará un error. Esto incluye python_version=PY2, srcs_version=PY2 y srcs_version=PY2ONLY. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/15684.
Etiquetas:loading_and_analysis
yincompatible_change
- Valor predeterminado de
--[no]incompatible_validate_top_level_header_inclusions
: "true" -
Si es verdadero, Bazel también validará las inclusiones de encabezados de directorio de nivel superior (consulta https://github.com/bazelbuild/bazel/issues/10047 para obtener más información).
Etiquetas:loading_and_analysis
yincompatible_change
- Valor predeterminado de
--python_native_rules_allowlist=<a build target label>
: ver descripción -
Una lista de entidades permitidas (destino del grupo de productos) que se usará cuando se aplique --incompatible_python_Disallow_native_rules.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]strict_filesets
: "falso" -
Si se habilita esta opción, los conjuntos de archivos que cruzan los límites de paquetes se informan como errores.
Etiquetas:build_file_semantics
yeagerness_to_exit
- Valor predeterminado de
--strict_proto_deps=<off, warn, error, strict or default>
: "error" -
A menos que esté DESACTIVADA, comprueba que un destino proto_library declare de forma explícita todos los objetivos usados directamente como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
yincompatible_change
- Configuración predeterminada de
--strict_public_imports=<off, warn, error, strict or default>
: "desactivada" -
A menos que esté DESACTIVADA, comprueba que un objetivo proto_library declare de forma explícita todos los destinos usados en el campo "import public" como se exportó.
Etiquetas:build_file_semantics
,eagerness_to_exit
yincompatible_change
- Valor predeterminado de
--[no]strict_system_includes
: "falso" -
Si es verdadero, también se deben declarar los encabezados que se encuentran en el sistema incluyen rutas de acceso (-isystem).
Etiquetas:loading_and_analysis
yeagerness_to_exit
- Se acumulan
--target_environment=<a build target label>
usos múltiples -
Declara el entorno de destino de esta compilación. Debe ser una referencia de etiqueta a un "entorno" . Si se especifica, todos los objetivos de nivel superior deben ser compatibles con este entorno.
Etiquetas:changes_inputs
- Opciones que afectan los resultados de firma de una compilación:
--apk_signing_method=<v1, v2, v1_v2 or v4>
predeterminado: “v1_v2”-
Implementación para firmar APKs
Etiquetas:action_command_lines
,affects_outputs
yloading_and_analysis
- Valor predeterminado de
--[no]device_debug_entitlements
: "true" -
Si se configura y el modo de compilación no es "opt", las apps objc incluirán derechos de depuración cuando firmen.
Etiquetas:changes_inputs
- Valor predeterminado de
--ios_signing_cert_name=<a string>
: ver descripción -
Nombre del certificado que se usará para la firma de iOS. De lo contrario, se recurrirá al perfil de aprovisionamiento. Puede ser la preferencia de identidad del llavero del certificado o (subcadena) del nombre común del certificado, según la página del manual del símbolo de código (IDENTIDADES DE FIRMA).
Etiquetas:action_command_lines
- Esta opción afecta la semántica del lenguaje de Starlark o de la API de compilación a la que pueden acceder los archivos BUILD, los archivos .bzl o los archivos WORKSPACE:
- Valor predeterminado de
--[no]incompatible_disallow_legacy_py_provider
: "true" -
No-op; se quitará pronto.
Etiquetas:loading_and_analysis
yincompatible_change
- Valor predeterminado de
--[no]incompatible_disallow_sdk_frameworks_attributes
: "falso" -
Si esta preferencia se establece como verdadera, no permite los atributos sdk_frameworks y bad_sdk_frameworks en objc_library y objc_import.
Etiquetas:build_file_semantics
yincompatible_change
- Valor predeterminado de
--[no]incompatible_objc_alwayslink_by_default
: "falso" -
Si es verdadero, establece como verdadero el valor predeterminado para los atributos Alwayslink en objc_library y objc_import.
Etiquetas:build_file_semantics
yincompatible_change
- Valor predeterminado de
--[no]incompatible_python_disallow_native_rules
: "falso" -
Si es verdadero, se produce un error cuando se usan las reglas py_* integradas. en su lugar, se deben usar las reglas rule_python. Consulta https://github.com/bazelbuild/bazel/issues/17773 para obtener más información y las instrucciones de migración.
Etiquetas:loading_and_analysis
yincompatible_change
- Opciones que determinan el comportamiento del entorno de pruebas o del ejecutor de pruebas:
- Valor predeterminado de
--[no]allow_analysis_failures
: "falso" -
Si es verdadero, una falla de análisis del destino de una regla da como resultado la propagación del destino de una instancia de AnalysisFailureInfo que contiene la descripción del error, en lugar de generar una falla de compilación.
Etiquetas:loading_and_analysis
yexperimental
- Valor predeterminado de
--analysis_testing_deps_limit=<an integer>
: "2000" -
Establece el número máximo de dependencias transitivas mediante un atributo de regla con una transición de configuración for_analysis_testing. Si superas este límite, se producirá un error de regla.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]break_build_on_parallel_dex2oat_failure
: "falso" -
Si las verdaderas fallas de acción de dex2oat harán que la compilación se rompa en lugar de ejecutar dex2oat durante el tiempo de ejecución de la prueba.
Etiquetas:loading_and_analysis
yexperimental
- 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 de recursos predeterminada para las pruebas. El formato esperado es <resource>=<value>. Si un solo número positivo se especifica como <valor> se anularán los recursos predeterminados para todos los tamaños de pruebas. Si se especifican 4 números separados por comas, se anulará la cantidad de recursos para los tamaños de prueba pequeños, medianos, grandes y enormes, 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 explícitos especificados en las etiquetas anulan los recursos de prueba predeterminados que especifica esta marca.
- Valor predeterminado de
--[no]experimental_android_use_parallel_dex2oat
: "falso" -
Usa dex2oat en paralelo para acelerar la ejecución de android_test.
Etiquetas:loading_and_analysis
,host_machine_resource_optimizations
yexperimental
- Valor predeterminado de
--[no]ios_memleaks
: "falso" -
Habilitar la verificación de fugas de memoria en los destinos de ios_test.
Etiquetas:action_command_lines
- Valor predeterminado de
--ios_simulator_device=<a string>
: ver descripción -
El dispositivo que se debe simular cuando se ejecuta una aplicación para iOS en el simulador, p.ej., "iPhone 6". Ejecuta “xcrun simctl list devicetypes” para obtener una lista de dispositivos. de la máquina en la que se ejecutará el simulador.
Etiquetas:test_runner
- Valor predeterminado de
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Es la versión de iOS que se ejecuta en el simulador durante la ejecución o las pruebas. Esto se ignora para las reglas ios_test si se especifica un dispositivo de destino en la regla.
Etiquetas:test_runner
- Se acumulan
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
usos múltiples - Especifica la cantidad de veces que se debe ejecutar cada prueba. Si alguno de esos intentos falla por cualquier motivo, toda la prueba se considera fallida. Por lo general, el valor especificado es solo un número entero. Ejemplo: --runs_per_test=3 ejecutará todas las pruebas 3 veces. Sintaxis alternativa: regex_filter@runs_per_test. En el ejemplo anterior, ejecuta_per_prueba significa un valor entero y regex_filter representa una lista de patrones de expresiones regulares de inclusión y exclusión (consulta también --instrumentation_filter). Ejemplo: --runs_per_test=//foo/.*,-//foo/bar/.*@3 ejecuta todas las pruebas en //foo/ excepto las que se encuentran en foo/bar tres veces. Esta opción se puede aprobar varias veces. El argumento que se pasó más recientemente y que coincida tiene prioridad. Si no hay coincidencias, la prueba se ejecutará solo una vez.
- Se acumulan
--test_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica las variables de entorno adicionales que se insertarán en el entorno del ejecutor de pruebas. Las variables pueden especificarse por nombre, en cuyo caso su valor se leerá desde el entorno de cliente de Bazel o por el par nombre=valor. Esta opción se puede usar varias veces para especificar muchas variables. Solo lo usa la "prueba de Bazel". kubectl.
Etiquetas:test_runner
- Valor predeterminado de
--test_timeout=<a single integer or comma-separated list of 4 integers>
: "-1" - Anula los valores predeterminados del tiempo de espera de la prueba (en segundos). Si se especifica un valor entero positivo único, se anularán todas las categorías. Si se especifican 4 números enteros separados por comas, se anularán los tiempos de espera de corto, moderado, largo y eterno (en ese orden). En cualquier caso, el valor -1 indica al blaze que use los tiempos de espera predeterminados para esa categoría.
- Valor predeterminado de
--[no]zip_undeclared_test_outputs
: "true" -
Si es verdadero, los resultados de la prueba que no se declaren se archivarán en un archivo ZIP.
Etiquetas:test_runner
- Opciones relacionadas con el resultado de la consulta y la semántica:
--aspect_deps=<off, conservative or precise>
predeterminado: “conservadora”-
Cómo resolver dependencias de aspecto cuando el formato de salida es {xml,proto,record}. "desactivado" significa que no se resuelven dependencias de aspecto, “conservadora” (predeterminado) significa que todas las dependencias de aspecto declaradas se agregan independientemente de si se les da la clase de regla de dependencias directas, “precisa”. significa que solo se agregan los aspectos que posiblemente estén activos dada la clase de regla de las dependencias directas. Ten en cuenta que el modo preciso requiere cargar otros paquetes para evaluar un solo objetivo, lo que lo hace más lento que los otros modos. Además, ten en cuenta que incluso el modo preciso no es del todo preciso: la decisión de calcular un aspecto se decide en la fase de análisis, que no se ejecuta durante la “consulta de Bazel”.
Etiquetas:build_file_semantics
- Valor predeterminado de
--[no]consistent_labels
: "falso" -
Si se habilita, cada comando de consulta emite etiquetas como si <code>str</code> de Starlark función aplicada a una <code>etiqueta</code> instancia. Esto resulta útil para las herramientas que necesitan hacer coincidir el resultado de diferentes comandos de consulta o etiquetas emitidas por las reglas. Si no se habilita, los formateadores de salida pueden emitir nombres de repositorio aparentes (en relación con el repositorio principal) en lugar de hacer que el resultado sea más legible.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]experimental_explicit_aspects
: "falso" -
aquery, cquery: Se incluyen acciones generadas por aspectos en el resultado. consulta: no-op (siempre se siguen los aspectos).
Etiquetas:terminal_output
- Valor predeterminado de
--[no]graph:factored
: "true" -
Si es verdadero, el grafo se emitirá “factorizado”, es decir, los nodos topológicamente equivalentes se combinarán y sus etiquetas se concatenarán. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--graph:node_limit=<an integer>
predeterminado: "512"-
La longitud máxima de la cadena de etiqueta para un nodo del grafo en el resultado. Las etiquetas más largas se truncarán. -1 significa que no hay truncamiento. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]implicit_deps
: "true" -
Si se habilita, las dependencias implícitas se incluirán en el gráfico de dependencias sobre el que opera la consulta. Una dependencia implícita es una que no se especifica de forma explícita en el archivo BUILD, pero la agrega Bazel. En el caso de cquery, esta opción controla el filtrado de cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
- Valor predeterminado de
--[no]include_artifacts
: "true" -
Incluye los nombres de las entradas y salidas de las acciones en la salida (posiblemente grandes).
Etiquetas:terminal_output
- Valor predeterminado de
--[no]include_aspects
: "true" -
aquery, cquery: Se incluyen acciones generadas por aspectos en el resultado. consulta: no-op (siempre se siguen los aspectos).
Etiquetas:terminal_output
- Valor predeterminado de
--[no]include_commandline
: "true" -
Incluye el contenido de las líneas de comandos de acción en el resultado (posiblemente grande).
Etiquetas:terminal_output
- Valor predeterminado de
--[no]include_file_write_contents
: "falso" -
Incluye el contenido del archivo para las acciones FileWrite, SourceSymlinkManifest y RepoMappingManifest (posiblemente grandes).
Etiquetas:terminal_output
- Valor predeterminado de
--[no]include_param_files
: "falso" -
Incluye el contenido de los archivos de parámetros que se usaron en el comando (posiblemente grandes). Nota: Habilitar esta marca habilitará automáticamente la marca --include_commandline.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]incompatible_package_group_includes_double_slash
: "true" -
Si se habilita esta opción, cuando se genere el atributo `packages` de package_group, no se omitirá el `//` inicial.
Etiquetas:terminal_output
yincompatible_change
- Valor predeterminado de
--[no]infer_universe_scope
: "falso" -
Si no se establece ni --universe_scope, se inferirá un valor de --universe_scope como la lista de patrones de destino únicos en la expresión de consulta. Ten en cuenta que es posible que el valor --universe_scope inferido para una expresión de consulta que usa funciones con alcance universal (p.ej., `allrdeps`) no sea lo que quieres, por lo que debes usar esta opción solo si sabes lo que estás haciendo. Consulta https://bazel.build/reference/query#sky-query para obtener detalles y ejemplos. Si se configura --universe_scope, se ignora el valor de esta opción. Nota: Esta opción solo se aplica a “query” (es decir, no a “cquery”).
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]line_terminator_null
: "falso" -
Indica si cada formato termina con \0 en lugar de un salto de línea.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]nodep_deps
: "true" -
Si está habilitada, las dependencias de “nodep” atributos se incluirán en el gráfico de la dependencia en el que opera la consulta. Un ejemplo común de un “nodep” es “visibilidad”. Ejecuta y analiza el resultado de `info build-language` para conocer todos los “nodep” atributos en el lenguaje de compilación.
Etiquetas:build_file_semantics
--output=<a string>
predeterminado: "texto"-
El formato en el que se deben imprimir los resultados de BigQuery. Los valores permitidos para aquery son los siguientes: text, textproto, proto, broadcast_proto y jsonproto.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:default_values
: "true" -
Si es verdadero, se incluirán los atributos cuyo valor no se especifica explícitamente en el archivo BUILD. de lo contrario, se omitirán. Esta opción se aplica a --output=proto
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:definition_stack
: "falso" -
Propaga el campo de proto definition_stack, que registra la pila de llamadas de Starlark para cada instancia de la regla en el momento en que se definió la clase de la regla.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:flatten_selects
: "true" -
Si se habilita, se acoplan los atributos configurables creados por select(). Para los tipos de lista, la representación plana es una lista que contiene cada valor del mapa de selección exactamente una vez. Los tipos escalares se acoplan a nulos.
Etiquetas:build_file_semantics
- Valor predeterminado de
--[no]proto:include_attribute_source_aspects
: "falso" -
Propaga el campo de protocolo source_aspect_name de cada atributo con el aspecto de origen del que provino (cadena vacía si no es así).
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:include_synthetic_attribute_hash
: "falso" -
Indica si se debe calcular y propagar el atributo $internal_attr_hash.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:instantiation_stack
: "falso" -
Propaga la pila de llamadas de creación de instancias de cada regla. Ten en cuenta que esto requiere que la pila esté presente
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:locations
: "true" -
Establece si se debe emitir información de ubicación en el resultado de proto.
Etiquetas:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
predeterminado: "todos"-
Lista de atributos separados por comas para incluir en el resultado. La configuración predeterminada es todos los atributos. Si la estableces como una string vacía, no se generará ningún atributo. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:rule_inputs_and_outputs
: "true" -
Indica si se deben completar o no los campos rule_input y rule_output.
Etiquetas:terminal_output
- Valor predeterminado de
--query_file=<a string>
: "" -
Si se configura, la consulta leerá la consulta desde el archivo que se nombra aquí, en lugar de hacerlo en la línea de comandos. Es un error especificar aquí un archivo así como una consulta de línea de comandos.
Etiquetas:changes_inputs
- Valor predeterminado de
--[no]relative_locations
: "falso" -
Si es verdadero, la ubicación de los archivos Build en los resultados xml y proto será relativa. De forma predeterminada, el resultado de la ubicación es una ruta de acceso absoluta y no será coherente en todas las máquinas. Puedes configurar esta opción como verdadera para obtener un resultado coherente en todas las máquinas.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]skyframe_state
: "falso" -
Sin realizar un análisis adicional, vuelca el gráfico de acción actual de Skyframe. Nota: Por el momento, no se admite la especificación de un destino con --skyframe_state. Este indicador solo está disponible con --output=proto o --output=textproto.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]tool_deps
: "true" -
Consulta: Si está inhabilitada, depende de “exec configuration” no se incluirán en el gráfico de la dependencia en el que opera la consulta. Una “configuración de ejecución” perímetro de dependencia, como el de cualquier "proto_library" al compilador de protocolos, por lo general, apunta a una herramienta ejecutada durante la compilación en lugar de a una parte del mismo “destino” .
Cquery: Si se inhabilita, filtra todos los destinos configurados que cruzan una transición de ejecución del objetivo de nivel superior que descubrió este objetivo configurado. Esto significa que, si el destino de nivel superior se encuentra en la configuración de destino, solo se mostrarán los destinos configurados que se encuentren también en esa configuración. Si el destino de nivel superior está en la configuración de ejecución, solo se mostrarán los destinos configurados de ejecución. Esta opción NO excluirá las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
- Valor predeterminado de
--universe_scope=<comma-separated list of options>
: "" -
Un conjunto de patrones de destino separados por comas (aditivos y sustractivos). La consulta puede realizarse en el universo definido por el cierre transitivo de los objetivos especificados. Esta opción se usa para los comandos de consulta y cquery.
Para cquery, la entrada de esta opción son los destinos en los que se crean todas las respuestas, por lo que esta opción puede afectar las configuraciones y transiciones. Si no se especifica esta opción, se supone que los objetivos de nivel superior son los objetivos analizados de la expresión de consulta. Nota: Para cquery, no especificar esta opción puede hacer que la compilación se rompa si los objetivos analizados desde la expresión de consulta no se pueden compilar con las opciones de nivel superior.
Etiquetas:loading_and_analysis
- Opciones que activan optimizaciones del tiempo de compilación:
- Valor predeterminado de
--[no]experimental_filter_library_jar_with_program_jar
: "falso" -
Filtra ProgramJar de ProGuard para quitar las clases que también estén presentes en el LibraryJar.
Etiquetas:action_command_lines
- Valor predeterminado de
--[no]experimental_inmemory_dotd_files
: "true" -
Si se habilita, los archivos .d de C++ se pasarán a la memoria directamente desde los nodos de compilación remotos en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
yexperimental
- Valor predeterminado de
--[no]experimental_inmemory_jdeps_files
: "true" -
Si se habilita, los archivos de dependencia (.jdeps) generados a partir de compilaciones de Java se pasarán a la memoria directamente desde los nodos de compilación remotos en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
yexperimental
- Valor predeterminado de
--[no]experimental_objc_include_scanning
: "falso" -
Si se debe realizar, incluye el análisis del objetivo de C/C++.
Etiquetas:loading_and_analysis
,execution
ychanges_inputs
- Valor predeterminado de
--[no]experimental_retain_test_configuration_across_testonly
: "falso" -
Cuando se habilita, --trim_test_configuration no recortará la configuración de prueba para las reglas marcadas como testonly=1. El objetivo de esto es reducir los problemas de conflictos de acciones cuando las reglas que no son de prueba dependen de las reglas cc_test. No tiene efecto si --trim_test_configuration es falso.
Etiquetas:loading_and_analysis
yloses_incremental_state
- Valor predeterminado de
--[no]experimental_starlark_cc_import
: "falso" -
Si se habilita, se puede usar la versión de Starlark de cc_import.
Etiquetas:loading_and_analysis
yexperimental
- Valor predeterminado de
--[no]experimental_unsupported_and_brittle_include_scanning
: "falso" -
Establece si las entradas se limitan a la compilación C/C++ mediante el análisis de #include líneas de archivos de entrada. Esto puede mejorar el rendimiento y la incrementalidad disminuyendo el tamaño de los árboles de entrada de compilación. Sin embargo, también puede romper compilaciones porque el escáner de inclusión no implementa por completo la semántica del preprocesador de C. En particular, no comprende las directivas dinámicas #include y, también, ignora la lógica condicional del preprocesador. Úsala bajo tu propia responsabilidad. Se cerrarán todos los problemas relacionados con esta marca que se hayan presentado.
Etiquetas:loading_and_analysis
,execution
ychanges_inputs
- Valor predeterminado de
--[no]incremental_dexing
: "true" -
Realiza la mayor parte del trabajo para la conversión a DEX por separado para cada archivo jar.
Etiquetas:affects_outputs
,loading_and_analysis
yloses_incremental_state
- Valor predeterminado de
--[no]objc_use_dotd_pruning
: "true" -
Si se configura, los archivos .d emitidos por Clang se usarán para reducir el conjunto de entradas que se pasan a compilaciones objc.
Etiquetas:changes_inputs
yloading_and_analysis
- Valor predeterminado de
--[no]process_headers_in_dependencies
: "falso" -
Cuando se compila un //a:a de destino, procesa encabezados en todos los destinos de los que depende //a:a (si el procesamiento de encabezados está habilitado para la cadena de herramientas).
Etiquetas:execution
- Valor predeterminado de
--[no]trim_test_configuration
: "true" -
Cuando se habilita esta opción, las opciones relacionadas con las pruebas se borran debajo del nivel superior de la compilación. Cuando esta marca está activa, las pruebas no se pueden compilar como dependencias de reglas que no son de prueba, pero los cambios en las opciones relacionadas con pruebas no harán que las reglas que no son de prueba se vuelvan a analizar.
Etiquetas:loading_and_analysis
yloses_incremental_state
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Valor predeterminado de
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: “-.*” -
Imprime la información de depuración durante la resolución de la cadena de herramientas. La marca toma una regex, que se verifica con los tipos de la cadena de herramientas y los objetivos específicos para ver cuál depurar. Es posible que varias regex estén separadas con comas y, luego, cada regex se verifique por separado. Nota: El resultado de esta marca es muy complejo y es probable que solo sea útil para los expertos en la resolución de la cadena de herramientas.
Etiquetas:terminal_output
- Opciones que especifican o modifican una entrada genérica para un comando de Bazel que no se encuentra en otras categorías.
- Se acumulan
--flag_alias=<a 'name=value' flag alias>
usos múltiples -
Establece un nombre abreviado para una bandera de Starlark. Toma un solo par clave-valor con el formato "<clave>=<valor>" como argumento.
Etiquetas:changes_inputs
- Valor predeterminado de
--[no]incompatible_default_to_explicit_init_py
: "falso" -
Esta marca cambia el comportamiento predeterminado para que los archivos __init__.py ya no se creen automáticamente en los runfiles de los objetivos de Python. De manera precisa, cuando un destino py_binary o py_test tiene legacy_create_init configurado en “auto” (configuración predeterminada), se trata como falsa solo si se configura esta marca. Consulta https://github.com/bazelbuild/bazel/issues/10076.
Etiquetas:affects_outputs
yincompatible_change
- Valor predeterminado de
--[no]incompatible_py2_outputs_are_suffixed
: "true" -
Si es verdadero, los destinos compilados en la configuración de Python 2 aparecerán en una raíz de salida que incluya el sufijo "-py2", mientras que los destinos compilados para Python 3 aparecerán en una raíz sin sufijo relacionado con Python. Esto significa que el symlink de conveniencia "bazel-bin" apuntará a los objetivos de Python 3 en lugar de a Python 2. Si habilitas esta opción, también se recomienda habilitar “--incompatible_py3_is_default”.
Etiquetas:affects_outputs
yincompatible_change
- Valor predeterminado de
--[no]incompatible_py3_is_default
: "true" -
Si el valor es verdadero, los destinos "py_binary" y "py_test" que no establezcan sus atributos "python_version" (o "default_python_version") pasarán a ser PY3 de forma predeterminada en lugar de PY2. Si configuras esta marca, también se recomienda configurar `--incompatible_py2_outputs_are_suffixed`.
Etiquetas:loading_and_analysis
,affects_outputs
yincompatible_change
- Valor predeterminado de
--[no]incompatible_use_python_toolchains
: "true" -
Si se configura como verdadera, las reglas ejecutables nativas de Python usarán el entorno de ejecución de Python especificado por la cadena de herramientas de Python, en lugar del entorno de ejecución proporcionado por marcas heredadas como --python_top.
Etiquetas:loading_and_analysis
yincompatible_change
- Valor predeterminado de
--python_version=<PY2 or PY3>
: ver descripción -
El modo de versión principal de Python, ya sea “PY2” o “PY3”. Ten en cuenta que los objetivos "py_binary" y "py_test" anulan esta opción (incluso si no especifican explícitamente una versión), por lo que no suele haber muchos motivos para proporcionar esta marca.
Etiquetas:loading_and_analysis
yaffects_outputs
- Otras opciones, sin categorizar.
--[no]cache_test_results
[-t
] predeterminada: "automática"- Si se configura como “auto”, Bazel vuelve a ejecutar una prueba solo en los siguientes casos: (1) Bazel detecta cambios en la prueba o sus dependencias, (2) la prueba se marcó como externa, (3) se solicitaron múltiples ejecuciones de prueba con --runs_per_test o(4) la prueba falló anteriormente. Si se configura en "sí", Bazel almacenará en caché todos los resultados de las pruebas, excepto las marcadas como externas. Si la estableces como "no", Bazel no almacenará en caché ningún resultado de prueba.
- Valor predeterminado de
--[no]experimental_cancel_concurrent_tests
: "falso" -
Si esta preferencia se establece como "true", Blaze cancelará las pruebas que se estén ejecutando simultáneamente en la primera ejecución correcta. Esto solo es útil en combinación con --runs_per_test_detects_flakes.
Etiquetas:affects_outputs
yloading_and_analysis
- Valor predeterminado de
--[no]experimental_fetch_all_coverage_outputs
: "falso" -
Si es verdadero, Bazel recupera todo el directorio de datos de cobertura para cada prueba durante una ejecución de cobertura.
Etiquetas:affects_outputs
yloading_and_analysis
- Valor predeterminado de
--[no]experimental_generate_llvm_lcov
: "falso" -
Si es verdadero, la cobertura de clang generará un informe de LCOV.
Etiquetas:affects_outputs
yloading_and_analysis
- Valor predeterminado de
--[no]experimental_j2objc_header_map
: "true" - Establece si se debe generar un mapa de encabezado de J2ObjC en paralelo a la transpilación de J2ObjC.
- Valor predeterminado de
--[no]experimental_j2objc_shorter_header_path
: "falso" -
Indica si se debe generar con una ruta de encabezado más corta (usa "_ios" en lugar de "_j2objc").
Etiquetas:affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
predeterminado: "javabuilder"- Habilita rutas de clase reducidas para compilaciones de Java.
- Valor predeterminado de
--[no]experimental_limit_android_lint_to_android_constrained_java
: "falso" -
Limita las --experimental_run_android_lint_on_java_rules a bibliotecas compatibles con Android.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]experimental_run_android_lint_on_java_rules
: "falso" -
Establece si se deben validar fuentes java_*.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]explicit_java_test_deps
: "falso" - Especifica de forma explícita una dependencia para JUnit o Hamcrest en una java_test, en lugar de obtener por error de las dependencias de TestRunner. Por el momento, solo funciona para Bazel.
- Valor predeterminado de
--host_java_launcher=<a build target label>
: ver descripción - El selector de Java que usan las herramientas que se ejecutan durante una compilación.
- Se acumulan
--host_javacopt=<a string>
usos múltiples - Opciones adicionales para pasar a javac cuando se compilan herramientas que se ejecutan durante una compilación.
- Se acumulan
--host_jvmopt=<a string>
usos múltiples - Opciones adicionales para pasar a la VM de Java cuando se compilan herramientas que se ejecutan durante la compilación. Estas se agregarán a las opciones de inicio de la VM de cada destino java_binary.
- Valor predeterminado de
--[no]incompatible_check_sharding_support
: "true" -
Si es verdadero, Bazel fallará una prueba fragmentada si el ejecutor de pruebas no indica que admite la fragmentación tocando el archivo en la ruta de acceso en TEST_SHARD_STATUS_FILE. Si es falso, un ejecutor de pruebas que no admite la fragmentación dará lugar a que se ejecuten todas las pruebas en cada fragmento.
Etiquetas:incompatible_change
- Valor predeterminado de
--[no]incompatible_exclusive_test_sandboxed
: "true" -
Si es verdadero, las pruebas exclusivas se ejecutarán con la estrategia de zona de pruebas. Agregar “local” etiqueta para forzar una ejecución de prueba exclusiva de forma local
Etiquetas:incompatible_change
- Valor predeterminado de
--[no]incompatible_strict_action_env
: "falso" -
Si es verdadero, Bazel usa un entorno con un valor estático para PATH y no hereda LD_LIBRARY_PATH. Usa --action_env=ENV_VARIABLE si deseas heredar variables de entorno específicas del cliente, pero ten en cuenta que hacerlo puede evitar el almacenamiento en caché entre usuarios si se usa una caché compartida.
Etiquetas:loading_and_analysis
yincompatible_change
- Se acumulan
--j2objc_translation_flags=<comma-separated list of options>
usos múltiples - Opciones adicionales para pasar a la herramienta J2ObjC.
--java_debug
-
Hace que la máquina virtual Java de una prueba de Java espere una conexión desde un depurador compatible con JDWP (como jdb) antes de comenzar la prueba. Implica -test_output=streamed.
Se expande a:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
- Valor predeterminado de
--[no]java_deps
: "true" - Genera información de dependencia (por ahora, la ruta de clase del tiempo de compilación) por objetivo de Java.
- Valor predeterminado de
--[no]java_header_compilation
: "true" - Compila ijars directamente desde la fuente.
- Valor predeterminado de
--java_language_version=<a string>
: "" - La versión del lenguaje Java
- Valor predeterminado de
--java_launcher=<a build target label>
: ver descripción - Selector de Java que se usa cuando se compilan objetos binarios de Java. Si esta marca se establece en la cadena vacía, se usa el selector de JDK. El "selector" anula esta marca.
--java_runtime_version=<a string>
predeterminado: “local_jdk”- La versión del entorno de ejecución de Java
- Se acumulan
--javacopt=<a string>
usos múltiples - Opciones adicionales para pasar a javac.
- Se acumulan
--jvmopt=<a string>
usos múltiples - Opciones adicionales para pasar a la VM de Java. Estas se agregarán a las opciones de inicio de la VM de cada destino java_binary.
- Valor predeterminado de
--legacy_main_dex_list_generator=<a build target label>
: ver descripción - Especifica un objeto binario que se debe usar para generar la lista de clases que deben estar en el DEX principal al compilar multidex heredado.
- Valor predeterminado de
--optimizing_dexer=<a build target label>
: ver descripción - Especifica el objeto binario que se usará para generar archivos dex sin fragmentación.
- Se acumulan
--plugin=<a build target label>
usos múltiples - Complementos para usar en la compilación. Actualmente funciona con java_plugin.
- Valor predeterminado de
--proguard_top=<a build target label>
: ver descripción - Especifica qué versión de ProGuard se debe usar para la eliminación de código al compilar un objeto binario de Java.
--proto_compiler=<a build target label>
predeterminado: “@bazel_tools//tools/proto:protoc”-
Es la etiqueta del proto-compiler.
Etiquetas:affects_outputs
yloading_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
yloading_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
yloading_and_analysis
--proto_toolchain_for_java=<a build target label>
predeterminado: "@bazel_tools//tools/proto:java_toolchain"-
Etiqueta de proto_lang_toolchain() que describe cómo compilar protos de Java.
Etiquetas:affects_outputs
yloading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
predeterminado: "@bazel_tools//tools/proto:javalite_toolchain"-
Etiqueta de proto_lang_toolchain() que describe cómo compilar protos de JavaLite.
Etiquetas:affects_outputs
yloading_and_analysis
- Se acumulan
--protocopt=<a string>
usos múltiples -
Opciones adicionales para pasar al compilador de protobuf.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]runs_per_test_detects_flakes
: "falso" - Si es verdadero, cualquier fragmento en el que se haya completado al menos una ejecución o un intento y al menos una falla o ejecución tendrá un estado FLAKY.
- Valor predeterminado de
--shell_executable=<a path>
: ver descripción -
Ruta de acceso absoluta al shell ejecutable para que lo use Bazel. Si no la estableces, pero la variable de entorno BAZEL_SH está establecida en la primera invocación de Bazel (que inicia un servidor de Bazel), Bazel la usará. Si no se establece ninguna, Bazel usa una ruta de acceso predeterminada hard-coded según el sistema operativo en el que se ejecute (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, todos los demás: /bin/bash). Ten en cuenta que usar un shell que no es compatible con Bash puede generar fallas de compilación o de tiempo de ejecución de los objetos binarios generados.
Etiquetas:loading_and_analysis
- Se acumulan
--test_arg=<a string>
usos múltiples - Especifica las opciones y los argumentos adicionales que se deben pasar al ejecutable de la prueba. Se puede usar varias veces para especificar varios argumentos. Si se ejecutan varias pruebas, cada una recibirá argumentos idénticos. Solo lo usa la "prueba de Bazel". kubectl.
- Valor predeterminado de
--test_filter=<a string>
: ver descripción - Especifica un filtro para reenviar al framework de prueba. Se usa para limitar las pruebas que se ejecutan. Ten en cuenta que esto no afecta los destinos que se compilan.
- Valor predeterminado de
--test_result_expiration=<an integer>
: "-1" - Esta opción dejó de estar disponible y no tiene efecto.
- Valor predeterminado de
--[no]test_runner_fail_fast
: "falso" - La opción de reenvíos falla con rapidez al ejecutor de pruebas. El ejecutor de pruebas debe detener la ejecución cuando ocurre la primera falla.
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>
predeterminado: "explícito"- Especifica la estrategia para la fragmentación de pruebas: “explícita” solo use la fragmentación si el atributo 'shard_count' El atributo BUILD está presente. 'inhabilitado' nunca usen la fragmentación de pruebas. “forced=k” aplicar “k” fragmentos para realizar pruebas sin importar la variable 'shard_count' Build.
- Valor predeterminado de
--tool_java_language_version=<a string>
: "" - La versión de lenguaje Java que se usa para ejecutar las herramientas necesarias durante una compilación
--tool_java_runtime_version=<a string>
predeterminado: "remotejdk_11"- La versión del entorno de ejecución de Java que se usa para ejecutar herramientas durante la compilación
- Valor predeterminado de
--[no]use_ijars
: "true" - Si se habilita, esta opción hace que la compilación de Java use archivos jar de la interfaz. Esto dará como resultado una compilación incremental más rápida, pero los mensajes de error pueden ser diferentes.
Opciones de compilación
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Lugares adicionales para buscar archivos antes de acceder a la red y descargarlos.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]experimental_repository_cache_hardlinks
: "falso" -
Si se configura, la caché del repositorio vinculará el archivo en lugar de copiarlo en caso de que se produzca un acierto de caché. Esto está diseñado para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--experimental_repository_downloader_retries=<an integer>
: "0" -
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
valor predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark según este factor. De esta manera, los repositorios externos pueden funcionar en máquinas más lentas de lo esperado por el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
yexperimental
- Valor predeterminado de
--http_connector_attempts=<an integer>
: "8" -
La cantidad máxima de intentos para descargas http.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--http_connector_retry_max_timeout=<An immutable length of time.>
: "0s" -
El tiempo de espera máximo para los reintentos de descarga de HTTP. Con un valor de 0, no se define ningún tiempo de espera máximo.
Etiquetas:bazel_internal_configuration
--http_timeout_scaling=<a double>
valor predeterminado: "1.0"-
Escalar todos los tiempos de espera relacionados con las descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación de caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché; de lo contrario, el valor predeterminado es '<output_user_root>/cache/repos/v1'. se usa
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]repository_disable_download
: "falso" -
Si se configura, no se permite la descarga con ctx.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no está completamente inhabilitado. ctx.execute aún podría ejecutar un ejecutable arbitrario que acceda a Internet.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de compilación:
- Valor predeterminado de
--[no]check_up_to_date
: "falso" -
No realices la compilación, solo verifica si está actualizada. Si todos los destinos están actualizados, la compilación se completará de forma correcta. Si es necesario ejecutar algún paso, se informa un error y la compilación falla.
Etiquetas:execution
- Valor predeterminado de
--dynamic_local_execution_delay=<an integer>
: "1000" -
¿Cuántos milisegundos se deben retrasar la ejecución local si la ejecución remota fue más rápida durante una compilación al menos una vez?
Etiquetas:execution
yhost_machine_resource_optimizations
- Se acumulan
--dynamic_local_strategy=<a '[name=]value1[,..,valueN]' assignment>
usos múltiples -
Son las estrategias locales que se usarán para el nombre mnemotécnico; se utiliza la primera estrategia aplicable. Por ejemplo, `worker,sandboxed` ejecuta acciones que admiten trabajadores persistentes usando la estrategia de trabajadores, y todas las demás acciones usando la estrategia de zona de pruebas. Si no se proporciona un nombre mnemotécnico, se usa la lista de estrategias como resguardo para todos los mnemotécnicos. La lista de resguardo predeterminada es `worker,sandboxed` o`worker,sandboxed,standalone` si `experimental_local_lockfree_output` está configurada. Utiliza [mnemonic=]local_strategy[,local_strategy,...]
Etiquetas:execution
yhost_machine_resource_optimizations
- Se acumulan
--dynamic_remote_strategy=<a '[name=]value1[,..,valueN]' assignment>
usos múltiples -
Las estrategias remotas, en orden, que se usarán para el nombre mnemotécnico; se utiliza la primera estrategia aplicable. Si no se proporciona un nombre mnemotécnico, se usa la lista de estrategias como resguardo para todos los mnemotécnicos. La lista de resguardo predeterminada es “remote”, por lo que esta marca generalmente no tiene que establecerse de forma explícita. Utiliza [mnemonic=]remote_strategy[,remote_strategy,...]
Etiquetas:execution
yhost_machine_resource_optimizations
- Valor predeterminado de
--experimental_docker_image=<a string>
: "" -
Especifica un nombre de imagen de Docker (p.ej., “ubuntu:latest”) que se debe usar para ejecutar una acción de zona de pruebas cuando se usa la estrategia de Docker, y la acción en sí no tiene un atributo de imagen de contenedor en sus propiedades remote_execution_properties en la descripción de la plataforma. El valor de esta marca se pasa literalmente a 'docker run', por lo que admite la misma sintaxis y los mismos mecanismos que Docker.
Etiquetas:execution
- Valor predeterminado de
--[no]experimental_docker_use_customized_images
: "true" -
Si se habilita, inserta el UID y el GID del usuario actual en la imagen de Docker antes de utilizarla. Esto es necesario si la compilación o las pruebas dependen de que el usuario tenga un nombre y un directorio principal dentro del contenedor. Esta opción está activada de forma predeterminada, pero puedes inhabilitarla si la función de personalización automática de imágenes no funciona en tu caso o si sabes que no la necesitas.
Etiquetas:execution
- Valor predeterminado de
--[no]experimental_dynamic_exclude_tools
: "true" -
Cuando se establecen, los objetivos se crean "para la herramienta" no están sujetos a ejecución dinámica. Es muy poco probable que esos objetivos se creen de forma incremental y, por lo tanto, no vale la pena invertir en ciclos locales.
Etiquetas:execution
yhost_machine_resource_optimizations
- Valor predeterminado de
--experimental_dynamic_local_load_factor=<a double>
: "0" -
Controla cuánta carga de la ejecución dinámica debe colocar en la máquina local. Esta marca ajusta la cantidad de acciones de la ejecución dinámica que programaremos de forma simultánea. Se basa en la cantidad de CPU que Blaze cree que está disponible, las cuales pueden controlarse con la marca --local_cpu_resources.
Si esta marca es 0, todas las acciones se programan de forma local inmediatamente. Si > 0, la cantidad de acciones programadas localmente está limitada por la cantidad de CPU disponibles. Si < 1, el factor de carga se usa para reducir la cantidad de acciones programadas localmente cuando la cantidad de acciones en espera para programar es alta. Esto disminuye la carga en la máquina local durante el caso de compilación limpia, en el que la máquina local no contribuye mucho.
Etiquetas:execution
yhost_machine_resource_optimizations
- Valor predeterminado de
--experimental_dynamic_slow_remote_time=<An immutable length of time.>
: "0" -
Si es >0, el tiempo en el que una acción ejecutada dinámicamente debe ejecutarse solo de manera remota antes de que prioricemos su ejecución local para evitar tiempos de espera remotos. Esto puede ocultar algunos problemas en el sistema de ejecución remota. No actives esta función sin supervisar los problemas de ejecución remota.
Etiquetas:execution
yhost_machine_resource_optimizations
- Valor predeterminado de
--[no]experimental_enable_docker_sandbox
: "falso" -
Habilitar la zona de pruebas basada en Docker Esta opción no tiene efecto si Docker no está instalado.
Etiquetas:execution
- Valor predeterminado de
--experimental_sandbox_async_tree_delete_idle_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "4" -
Si el valor es 0, borra los árboles de la zona de pruebas en cuanto se complete una acción (lo que hará que se retrase la finalización de la acción). Si es mayor que cero, ejecuta la eliminación de esos tres en un grupo de subprocesos asíncrono que tenga un tamaño de 1 cuando la compilación se esté ejecutando y aumente al tamaño especificado por esta marca cuando el servidor esté inactivo.
Etiquetas:host_machine_resource_optimizations
yexecution
- Valor predeterminado de
--experimental_sandbox_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
: "0" -
Si > 0, cada zona de pruebas de Linux se limitará a la cantidad determinada de memoria (en MB). Requiere cgroups v1 o v2 y permisos para que los usuarios accedan al directorio de cgroups.
Etiquetas:execution
- Valor predeterminado de
--[no]experimental_shrink_worker_pool
: "falso" -
Si se habilita, es posible que se reduzca el grupo de trabajadores si la presión de su memoria es alta. Esta marca solo funciona cuando está habilitada la marca experimental_total_worker_memory_limit_mb.
Etiquetas:execution
yhost_machine_resource_optimizations
- Valor predeterminado de
--[no]experimental_split_xml_generation
: "true" -
Si se establece esta marca y una acción de prueba no genera un archivo test.xml, Bazel usa una acción independiente para generar un archivo test.xml de prueba que contiene el registro de pruebas. De lo contrario, Bazel genera un archivo test.xml como parte de la acción de prueba.
Etiquetas:execution
- Valor predeterminado de
--experimental_total_worker_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
: "0" -
Si este límite es superior a cero trabajadores inactivos, se podrían finalizar si el uso total de memoria de todos los trabajadores supera el límite.
Etiquetas:execution
yhost_machine_resource_optimizations
- Valor predeterminado de
--[no]experimental_use_hermetic_linux_sandbox
: "falso" -
Si se configura como verdadera, no actives la raíz, solo activa lo que se proporciona con sandbox_add_mount_pair. Los archivos de entrada tendrán un vínculo duro a la zona de pruebas en lugar de un symlink a él desde la zona de pruebas. Si los archivos de entrada de acciones se encuentran en un sistema de archivos diferente al de la zona de pruebas, se copiarán los archivos de entrada.
Etiquetas:execution
- Valor predeterminado de
--[no]experimental_use_semaphore_for_jobs
: "true" -
Si se configura como verdadero, además, usa el semáforo para limitar la cantidad de trabajos simultáneos.
Etiquetas:host_machine_resource_optimizations
yexecution
- Valor predeterminado de
--[no]experimental_use_windows_sandbox
: "falso" -
Usa la zona de pruebas de Windows para ejecutar acciones. Si es "Sí", el objeto binario proporcionado por --experimental_windows_sandbox_path debe ser válido y corresponder a una versión compatible de sandboxfs. Si es "auto", es posible que falte el objeto binario o que no sea compatible.
Etiquetas:execution
--experimental_windows_sandbox_path=<a string>
predeterminado: "BazelSandbox.exe"-
Ruta de acceso al objeto binario de la zona de pruebas de Windows que se usará cuando --experimental_use_windows_sandbox sea verdadero. Si el nombre es vacío, usa el primer objeto binario con ese nombre que se encuentra en la ruta de acceso.
Etiquetas:execution
- Valor predeterminado de
--experimental_worker_allowlist=<comma-separated set of options>
: ver descripción -
Si no está vacío, solo permite el uso de trabajadores persistentes con el nombre nemotécnico de la clave de trabajador especificada.
Etiquetas:execution
yhost_machine_resource_optimizations
- Valor predeterminado de
--[no]experimental_worker_as_resource
: "true" -
No-op; se quitará pronto.
Etiquetas:no_op
- Valor predeterminado de
--[no]experimental_worker_cancellation
: "falso" -
Si se habilita, Bazel puede enviar solicitudes de cancelación a los trabajadores que las admiten.
Etiquetas:execution
- Valor predeterminado de
--experimental_worker_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
: "0" -
Si este límite es mayor que cero, es posible que se cierren los trabajadores si su uso de memoria supera el límite. Si no se usa junto con la ejecución dinámica y `--experimental_dynamic_ignore_local_signals=9`, es posible que falle tu compilación.
Etiquetas:execution
yhost_machine_resource_optimizations
- Valor predeterminado de
--experimental_worker_metrics_poll_interval=<An immutable length of time.>
: "5 s" -
El intervalo entre la recopilación de métricas de trabajadores y la posible intento de expulsiones. Por motivos de rendimiento, no puede ser inferior a 1 s.
Etiquetas:execution
yhost_machine_resource_optimizations
- Valor predeterminado de
--[no]experimental_worker_multiplex_sandboxing
: "falso" -
Si se habilita esta opción, los trabajadores multiplex se colocarán en una zona de pruebas usando un directorio de zona de pruebas independiente por solicitud de trabajo. Solo los trabajadores que tengan el permiso “supports-multiplex-sandboxing” el requisito de ejecución se someterá a una zona de pruebas.
Etiquetas:execution
- Valor predeterminado de
--[no]experimental_worker_sandbox_hardening
: "falso" -
Si se habilita, los trabajadores se ejecutan en una zona de pruebas endurecida, si la implementación lo permite.
Etiquetas:execution
- Valor predeterminado de
--[no]experimental_worker_strict_flagfiles
: "falso" -
Si se habilita, los argumentos de acciones para trabajadores que no siguen la especificación del trabajador generarán un error. Los argumentos de trabajador deben tener exactamente un argumento @flagfile como el último de su lista de argumentos.
Etiquetas:execution
- Valor predeterminado de
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
El porcentaje del espacio permanente ocupado (0-100) por encima del cual GcThrashingDetector considera eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, GcThrashingDetector está inhabilitado.
Etiquetas:host_machine_resource_optimizations
- Valor predeterminado de
--genrule_strategy=<comma-separated list of options>
: "" -
Especifica cómo ejecutar genrules. Esta marca se eliminará gradualmente. En su lugar, usa --spawn_strategy=<value> para controlar todas las acciones o --strategy=Genrule=<value> para que controlen solo las genrules.
Etiquetas:execution
- Se acumulan
--high_priority_workers=<a string>
usos múltiples -
No-op; se quitará pronto.
Etiquetas:execution
- Valor predeterminado de
--[no]incompatible_remote_dangling_symlinks
: "true" -
Si la estableces como verdadera, se podrán colgar los symlinks subidos a una caché de disco o remota.
Etiquetas:execution
yincompatible_change
- Valor predeterminado de
--[no]incompatible_remote_symlinks
: "true" -
Si se configura como verdadera, Bazel siempre subirá symlinks como tales a una caché remota o de disco. De lo contrario, se subirán los symlinks relacionados que no son de vinculación (y solo esos) como el archivo o directorio al que apunten.
Etiquetas:execution
yincompatible_change
- Valor predeterminado de
--[no]incompatible_sandbox_hermetic_tmp
: "true" -
Si la estableces como verdadera, cada zona de pruebas de Linux tendrá su propio directorio vacío y dedicado activado como /tmp en lugar de compartir /tmp con el sistema de archivos del host. Usa --sandbox_add_mount_pair=/tmp para seguir viendo el /tmp del host en todas las zonas de pruebas.
Etiquetas:execution
- Valor predeterminado de
--[no]internal_spawn_scheduler
: "falso" -
Opción de marcador de posición para que podamos saber en Blaze si se habilitó el programador de generación.
Etiquetas:execution
yhost_machine_resource_optimizations
--jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
[-j
] predeterminada: "automática"-
La cantidad de trabajos simultáneos que se ejecutarán. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5" Los valores deben estar entre 1 y 5,000. Los valores superiores a 2,500 pueden causar problemas de memoria. "automático" calcula un valor predeterminado razonable
según los recursos del host.
Etiquetas:host_machine_resource_optimizations
yexecution
--[no]keep_going
[-k
] predeterminado: "false"-
Continúa tanto como sea posible después de un error. Si bien el destino que falló y los que dependen de él no se pueden analizar, otros requisitos previos de estos objetivos pueden serlo.
Etiquetas:eagerness_to_exit
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
predeterminado: "automático"-
Cantidad de subprocesos paralelos que se usarán en la fase de carga/análisis. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5" "automático" establece un valor predeterminado razonable
según los recursos del host. Debe ser 1 como mínimo.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]reuse_sandbox_directories
: "true" -
Si la estableces como verdadera, es posible que se reutilicen los directorios que usa la ejecución que no es de trabajadores en la zona de pruebas para evitar costos de configuración innecesarios.
Etiquetas:host_machine_resource_optimizations
yexecution
- Valor predeterminado de
--sandbox_base=<a string>
: "" -
Permite que la zona de pruebas cree sus directorios de zona de pruebas debajo de esta ruta de acceso. Especifica una ruta de acceso en tmpfs (como /run/shm) para posiblemente mejorar mucho el rendimiento cuando tu compilación o pruebas tengan muchos archivos de entrada. Nota: Necesitas suficiente RAM y espacio libre en el tmpfs para contener archivos intermedios y de salida que se generan con la ejecución de acciones.
Etiquetas:host_machine_resource_optimizations
yexecution
- Valor predeterminado de
--[no]sandbox_explicit_pseudoterminal
: "falso" -
Habilitar de forma explícita la creación de pseudoterminales para las acciones de la zona de pruebas Algunas distribuciones de Linux requieren que se configure el ID de grupo del proceso como “tty”. dentro de la zona de pruebas
para que funcionen las pseudoterminales. Si esto está causando problemas, esta marca se puede inhabilitar para habilitar el uso de otros grupos.
Etiquetas:execution
- Se acumulan
--sandbox_tmpfs_path=<an absolute path>
usos múltiples -
Para las acciones de zona de pruebas, activa un directorio vacío que admita escritura en esta ruta de acceso absoluta (si la implementación de la zona de pruebas lo admite; de lo contrario, se ignora).
Etiquetas:host_machine_resource_optimizations
yexecution
- Valor predeterminado de
--[no]skip_incompatible_explicit_targets
: "falso" -
Omite los destinos incompatibles que se enumeran explícitamente en la línea de comandos. De forma predeterminada, la compilación de estos destinos genera un error, pero se omiten en silencio cuando esta opción está habilitada. Consulta https://bazel.build/extending/platforms#skipping-incompatible-targets
Etiquetas:loading_and_analysis
- Valor predeterminado de
--spawn_strategy=<comma-separated list of options>
: "" -
Especifica cómo se ejecutan las acciones de generación de forma predeterminada. Acepta una lista de estrategias separadas por comas de mayor a menor prioridad. Para cada acción, Bazel elige la estrategia con la prioridad más alta que puede ejecutar la acción. El valor predeterminado es “remote,worker,sandboxed,local”. Consulta https://blog.bazel.build/2019/06/19/list-strategy.html para obtener más información.
Etiquetas:execution
- Se acumulan
--strategy=<a '[name=]value1[,..,valueN]' assignment>
usos múltiples -
Especifica cómo distribuir la compilación de otras acciones de generación. Acepta una lista de estrategias separadas por comas de mayor a menor prioridad. Para cada acción, Bazel elige la estrategia con la prioridad más alta que puede ejecutar la acción. El valor predeterminado es “remote,worker,sandboxed,local”. Esta marca anula los valores establecidos por --spawn_strategy (y --genrule_strategy si se usa con Genrule mnemotécnico). Consulta https://blog.bazel.build/2019/06/19/list-strategy.html para obtener más información.
Etiquetas:execution
- Se acumulan
--strategy_regexp=<a '<RegexFilter>=value[,value]' assignment>
usos múltiples -
Anula qué estrategia de generación se debe usar para ejecutar acciones de generación que tengan descripciones que coincidan con un determinado regex_filter. Consulta --per_file_copt para obtener detalles sobre la coincidencia de onregex_filter. Se usa el último regex_filter que coincida con la descripción. Esta opción anula otras marcas para especificar la estrategia. Ejemplo: --strategy_regexp=//foo.*\.cc,-//foo/bar=local significa ejecutar acciones con la estrategia local si sus descripciones coinciden con //foo.*.cc, pero no con //foo/bar. Ejemplo: --strategy_regexp='Compiling.*/bar=local --strategy_regexp=Compiling=sandboxed ejecutará 'Compiling //foo/bar/baz'. con la configuración "local" pero revertir el pedido lo ejecutaría con “sandboxed”.
Etiquetas:execution
- Se acumulan
--worker_extra_flag=<a 'name=value' assignment>
usos múltiples -
Marcas de comandos adicionales que se pasarán a los procesos trabajadores además de --persistent_worker, con clave mnemotécnica (p.ej., --worker_extra_flag=Javac=--debug.
Etiquetas:execution
yhost_machine_resource_optimizations
- Se acumulan
--worker_max_instances=<[name=]value, where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
usos múltiples -
Cuántas instancias de cada tipo de trabajador persistente se pueden iniciar si utilizas el "trabajador" de administración de amenazas. Se puede especificar como [name=value] para dar un valor diferente por nombre mnemotécnico. El límite se basa en claves de trabajador, que se diferencian según el mnemónico, pero también en las marcas de inicio y el entorno, por lo que, en algunos casos, puede haber más trabajadores por mnemónico que los especificados en esta marca. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5" 'automático' calcula un valor predeterminado razonable
según la capacidad de la máquina. “=valor” establece un valor predeterminado para mnemónicos no especificados.
Etiquetas:execution
yhost_machine_resource_optimizations
- Se acumulan
--worker_max_multiplex_instances=<[name=]value, where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
usos múltiples -
Cantidad de WorkRequests que puede recibir un proceso de trabajador multiplex en paralelo si usas el "trabajador" con --worker_multiplex. Se puede especificar como [name=value] para dar un valor diferente por nombre mnemotécnico. El límite se basa en claves de trabajador, que se diferencian según el mnemónico, pero también en las marcas de inicio y el entorno, por lo que, en algunos casos, puede haber más trabajadores por mnemónico que los especificados en esta marca. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5" 'automático' calcula un valor predeterminado razonable
según la capacidad de la máquina. “=valor” establece un valor predeterminado para mnemónicos no especificados.
Etiquetas:execution
yhost_machine_resource_optimizations
- Valor predeterminado de
--[no]worker_multiplex
: "true" -
Si se habilita, los trabajadores usarán la multiplexación si la admiten.
Etiquetas:execution
yhost_machine_resource_optimizations
- Valor predeterminado de
--[no]worker_quit_after_build
: "falso" -
Si se habilita, todos los trabajadores abandonan después de que se completa una compilación.
Etiquetas:execution
yhost_machine_resource_optimizations
- Valor predeterminado de
--[no]worker_sandboxing
: "falso" -
Si se habilita, los trabajadores se ejecutarán en un entorno de zona de pruebas.
Etiquetas:execution
- Valor predeterminado de
--[no]worker_verbose
: "falso" - Si se habilita esta opción, se imprimen mensajes detallados cuando se inician, apagan los trabajadores...
- Opciones que configuran la cadena de herramientas utilizada para la ejecución de la acción:
- Valor predeterminado de
--target_platform_fallback=<a string>
: "" -
Esta opción dejó de estar disponible y no tiene efecto.
Etiquetas:affects_outputs
,changes_inputs
yloading_and_analysis
- Opciones que controlan el resultado del comando:
- Valor predeterminado de
--[no]build
: "true" -
Ejecuta la compilación. este es el comportamiento habitual. La especificación de --nobuild hace que la compilación se detenga antes de ejecutar las acciones de compilación y muestra cero si las fases de carga del paquete y análisis se completaron correctamente. este modo es útil para probar esas fases.
Etiquetas:execution
yaffects_outputs
- Valor predeterminado de
--[no]experimental_use_validation_aspect
: "falso" -
Establece si se deben ejecutar acciones de validación con aspecto (para el paralelismo con pruebas).
Etiquetas:execution
yaffects_outputs
- Se acumulan
--output_groups=<comma-separated list of options>
usos múltiples -
Una lista de nombres de grupos de salida separados por comas, cada uno de los cuales, de manera opcional, con el prefijo + o -. Se agrega un grupo con el prefijo + al conjunto predeterminado de grupos de salida, mientras que un grupo con el prefijo - se quita del conjunto predeterminado. Si al menos un grupo no tiene prefijo, se omite el conjunto predeterminado de grupos de salida. Por ejemplo, --output_groups=+foo,+bar crea la unión del conjunto predeterminado, foo y bar, mientras que --output_groups=foo,bar anula el conjunto predeterminado de modo que solo se compilan foo y bar.
Etiquetas:execution
yaffects_outputs
- Valor predeterminado de
--[no]run_validations
: "true" -
Establece si se deben ejecutar acciones de validación como parte de la compilación. Consulta https://bazel.build/extending/rules#validation_actions
Etiquetas:execution
yaffects_outputs
- Opciones que permiten al usuario configurar el resultado previsto y que afectan su valor, en lugar de su existencia:
- Se acumulan
--aspects=<comma-separated list of options>
usos múltiples - Lista separada por comas de los aspectos que se aplicarán a las orientaciones de nivel superior. En la lista, si el aspecto some_aspect especifica los proveedores de aspectos requeridos a través de required_aspect_providers, some_aspect se ejecutará después de cada aspecto que se mencionó antes en la lista de aspectos cuyos proveedores promocionados satisfacen algunos proveedores de aspectos obligatorios de algunos_aspect. Además, some_aspect se ejecutará después de todos los aspectos obligatorios especificados por el atributo exige. some_aspect tendrá acceso a los valores de esos aspectos proveedores. <bzl-file-label>%<aspect_name>, por ejemplo “//tools:my_def.bzl%my_aspect”, donde “my_aspect” es un valor de nivel superior de un archivo tools/my_def.bzl
- Valor predeterminado de
--bep_maximum_open_remote_upload_files=<an integer>
: "-1" -
Cantidad máxima de archivos abiertos permitidos durante la carga del artefacto de BEP.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]experimental_convenience_symlinks
: “normal” -
Esta marca controla cómo se administrarán los symlinks convenientes (los que aparecen en el lugar de trabajo después de la compilación). Valores posibles:
normal (predeterminado): Se creará o borrará cada tipo de symlink de conveniencia, según lo determine la compilación.
limpio: Todos los symlinks se borrarán incondicionalmente.
Ignorar: Los vínculos simbólicos se dejarán solos.
log_only: Generar mensajes de registro como si fuera “normal” se pasaron, pero en realidad no realizan ninguna operación del sistema de archivos (útil para las herramientas).
Ten en cuenta que solo pueden verse afectados los symlinks cuyos nombres son generados por el valor actual de --symlink_prefix. Si el prefijo cambia, los symlinks preexistentes quedarán solos.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]experimental_convenience_symlinks_bep_event
: "falso" -
Esta marca controla si se publicará o no el evento de compilaciónConvenienceSymlinksIdentified en BuildEventProtocol. Si el valor es verdadero, BuildEventProtocol tendrá una entrada para beneficenciaSymlinksIdentified, que enumerará todos los symlinks convenientes creados en su lugar de trabajo. Si es falso, la entrada minimercadoSymlinksIdentified en BuildEventProtocol estará vacía.
Etiquetas:affects_outputs
--remote_download_all
-
Descarga todas las salidas remotas en la máquina local. Esta marca es un alias de --remote_download_outputs=all.
Se expande a:
--remote_download_outputs=all
Etiquetas:affects_outputs
--remote_download_minimal
-
No descarga ningún resultado de compilación remota en la máquina local. Esta marca es un alias de --remote_download_outputs=minimal.
Se expande a:
--remote_download_outputs=minimal
Etiquetas:affects_outputs
--remote_download_outputs=<all, minimal or toplevel>
predeterminado: “nivel superior”-
Si está establecido en “mínimo” No se descargan resultados de compilación remota en la máquina local, excepto los que requieren las acciones locales. Si se establece como "toplevel" se comporta como “mínimo” excepto que también descarga resultados de objetivos de nivel superior en la máquina local. Ambas opciones pueden reducir significativamente los tiempos de compilación si el ancho de banda de la red es un cuello de botella.
Etiquetas:affects_outputs
- Valor predeterminado de
--remote_download_symlink_template=<a string>
: "" -
En lugar de descargar resultados de compilación remotos en la máquina local, crea vínculos simbólicos. El objetivo de los vínculos simbólicos se puede especificar en el formato de una cadena de plantilla. Esta cadena de plantilla puede contener {hash} y {size_bytes} que se expanden al hash del objeto y al tamaño en bytes, respectivamente. Estos vínculos simbólicos pueden, por ejemplo, apuntar a un sistema de archivos FUSE que carga objetos desde CAS a pedido.
Etiquetas:affects_outputs
--remote_download_toplevel
-
Solo descarga las salidas remotas de los objetivos de nivel superior en la máquina local. Esta marca es un alias de --remote_download_outputs=toplevel.
Se expande a:
--remote_download_outputs=toplevel
Etiquetas:affects_outputs
- Valor predeterminado de
--symlink_prefix=<a string>
: ver descripción -
El prefijo que se antepone a cualquiera de los symlinks convenientes que se crean después de una compilación. Si se omite, el valor predeterminado es el nombre de la herramienta de compilación seguido de un guion. Si “/” se pasa, no se crean symlinks ni se emite ninguna advertencia. Advertencia: la funcionalidad especial para "/" pronto quedarán obsoletas; usa --experimental_convenience_symlinks=ignore en su lugar.
Etiquetas:affects_outputs
- Opciones que afectan la precisión con la que Bazel aplica entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
- Valor predeterminado de
--[no]experimental_docker_privileged
: "falso" -
Si se habilita, Bazel pasará la marca --privileged a 'docker run'. cuando ejecutas acciones. Esto puede ser necesario para tu compilación, pero también podría reducir la hermeticidad.
Etiquetas:execution
- Valor predeterminado de
--[no]experimental_sandboxfs_map_symlink_targets
: "falso" -
No-ops
Etiquetas:host_machine_resource_optimizations
yexecution
- Valor predeterminado de
--[no]incompatible_legacy_local_fallback
: "falso" -
Si se configura como verdadera, habilita el resguardo implícito heredado de la zona de pruebas a la estrategia local. Con el tiempo, esta marca se establecerá como falsa de forma predeterminada y, luego, se convertirá en una no-op. En su lugar, usa --strategy, --spawn_strategy o --dynamic_local_strategy para configurar resguardos.
Etiquetas:execution
yincompatible_change
- Se acumulan
--sandbox_add_mount_pair=<a single path or a 'source:target' pair>
usos múltiples -
Agrega un par de rutas de acceso adicional para activarlo en la zona de pruebas.
Etiquetas:execution
- Se acumulan
--sandbox_block_path=<a string>
usos múltiples -
Para las acciones de la zona de pruebas, inhabilita el acceso a esta ruta de acceso.
Etiquetas:execution
- Valor predeterminado de
--[no]sandbox_default_allow_network
: "true" -
Permitir el acceso a la red de forma predeterminada para las acciones Es posible que esto no funcione con todas las implementaciones de la zona de pruebas.
Etiquetas:execution
- Valor predeterminado de
--[no]sandbox_fake_hostname
: "falso" -
Cambia el nombre de host actual a “localhost” para las acciones de la zona de pruebas.
Etiquetas:execution
- Valor predeterminado de
--[no]sandbox_fake_username
: "falso" -
Cambiar el nombre de usuario actual a "nadie" para las acciones de la zona de pruebas.
Etiquetas:execution
- Se acumulan
--sandbox_writable_path=<a string>
usos múltiples -
Para las acciones de zona de pruebas, haz que un directorio existente pueda escribirse en la zona de pruebas (si la implementación de la zona de pruebas lo admite; de lo contrario, se ignora).
Etiquetas:execution
- Esta opción afecta la semántica del lenguaje de Starlark o de la API de compilación a la que pueden acceder los archivos BUILD, los archivos .bzl o los archivos WORKSPACE:
- Valor predeterminado de
--[no]incompatible_config_setting_private_default_visibility
: "falso" -
Si incompatible_enforce_config_setting_visibility=false, es una noop. De lo contrario, si esta marca es falsa, cualquier config_setting sin un atributo de visibilidad explícito será //visibility:public. Si esta marca es verdadera, config_setting sigue la misma lógica de visibilidad que todas las demás reglas. Consulta https://github.com/bazelbuild/bazel/issues/12933.
Etiquetas:loading_and_analysis
yincompatible_change
- Valor predeterminado de
--[no]incompatible_enforce_config_setting_visibility
: "true" -
Si es verdadero, aplica las restricciones de visibilidad config_setting. Si es falso, cada config_setting es visible para cada destino. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
yincompatible_change
- Opciones que determinan el comportamiento del entorno de pruebas o del ejecutor de pruebas:
- Valor predeterminado de
--[no]check_tests_up_to_date
: "falso" -
No ejecutes pruebas, solo verifica que estén actualizadas. Si todos los resultados de las pruebas están actualizados, estas se completarán de forma correcta. Si es necesario compilar o ejecutar alguna prueba, se informa un error y la prueba falla. Esta opción implica un comportamiento --check_up_to_date.
Etiquetas:execution
- Se acumulan
--flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once>
usos múltiples -
Cada prueba se volverá a intentar hasta la cantidad especificada de veces en caso de que falle la prueba. Las pruebas que requerían más de un intento de aprobación se marcan como "FLAKY". en el resumen de la prueba. Normalmente, el valor especificado es solo un número entero o la cadena 'default'. Si es un número entero, todas las pruebas se ejecutarán hasta N veces. Si es "default", solo se realizará un intento de prueba para las pruebas regulares y tres para las que su regla marque explícitamente como inestable (atributo poco confiable). Sintaxis alternativa: regex_filter@flaky_test_attempts. Donde flaky_test_attempts es como se muestra arriba y regex_filter significa una lista de patrones de incluir y excluir expresiones regulares (consulta también --runs_per_test). Ejemplo: --flaky_test_attempts=//foo/.*,-//foo/bar/.*@3 desencripta todas las pruebas en //foo/, excepto las que se encuentran en foo/bar tres veces. Esta opción se puede aprobar varias veces. El argumento que se pasó más recientemente y que coincida tiene prioridad. Si no hay coincidencias, el comportamiento es “predeterminado” arriba.
Etiquetas:execution
--local_test_jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
predeterminado: "automático"-
La cantidad máxima de trabajos de prueba locales que se ejecutan de forma simultánea. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5" 0 significa que los recursos locales limitarán la cantidad de trabajos de prueba locales que se ejecutarán simultáneamente. Establecer este valor mayor que el valor de --jobs no tiene efecto.
Etiquetas:execution
- Valor predeterminado de
--[no]test_keep_going
: "true" -
Cuando se inhabilita, cualquier prueba que no se apruebe hará que se detenga toda la compilación. De forma predeterminada, se ejecutan todas las pruebas, incluso si algunas no se aprueban.
Etiquetas:execution
- Valor predeterminado de
--test_strategy=<a string>
: "" -
Especifica qué estrategia usar cuando se ejecutan pruebas.
Etiquetas:execution
- Valor predeterminado de
--test_tmpdir=<a path>
: ver descripción - Especifica el directorio temporal base para la "prueba de Bazel". usar.
- Opciones relacionadas con el resultado de la consulta y la semántica:
- Valor predeterminado de
--[no]experimental_parallel_aquery_output
: "true" - No-ops.
- Opciones relacionadas con la salida y la semántica de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Se especificaron las versiones de los módulos con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resueltas, incluso si se declaran como eliminadas en el registro del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones rechazadas harán que la resolución falle. También puedes definir la versión generada permitida con la variable de entorno `BZLMOD_ALLOW_YANKED_VERSIONS`. Puedes inhabilitar esta verificación con la palabra clave “todo” (no se recomienda).
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
: "error" -
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivar el caso a una falla de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecta una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas de `bazel_dep` declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]ignore_dev_dependency
: "falso" -
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--lockfile_mode=<off, update or error>
: "actualizar" -
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "error" para usar el archivo de bloqueo, pero arroja un error si no está actualizado, o "off" para que no se lea ni escriba en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <module name>=<path>. Si la ruta de acceso dada es una ruta de acceso absoluta, se usará tal como es. Si la ruta de acceso determinada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso dada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace"
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en registros anteriores y solo se recurrirán a los registros posteriores cuando falten en los registros anteriores.
Etiquetas:changes_inputs
- Valor predeterminado de
--vendor_dir=<a path>
: ver descripción -
Especifica el directorio que debe almacenar los repositorios externos en modo de proveedor, ya sea para recuperarlos o usarlos durante la compilación. La ruta 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:
- Valor predeterminado de
--cache_computed_file_digests=<a long integer>
: "50000" - Si el valor es mayor que 0, configura Bazel para almacenar en caché resúmenes de archivos en la memoria según sus metadatos, en lugar de volver a procesar los resúmenes del disco cada vez que se necesiten. Establecer esta opción en 0 garantiza la precisión, ya que no se pueden observar todos los cambios en los metadatos del archivo. Cuando no es 0, el número indica el tamaño de la caché como la cantidad de resúmenes de archivos que se almacenarán en caché.
- Valor predeterminado de
--experimental_dynamic_ignore_local_signals=<a comma-separated list of signal numbers>
: ver descripción -
Toma una lista de los números de las señales del SO. Si se cierra una rama local de ejecución dinámica con cualquiera de estos indicadores, se permitirá que la rama remota finalice en su lugar. Para los trabajadores persistentes, esto solo afecta a las señales que finalizan el proceso trabajador.
Etiquetas:execution
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
predeterminado: "1s:2,20s:3,1m:5"-
Límites que, si se alcanzan, hacen que GcThrashingDetector bloquee Bazel con una OOM. Cada límite se especifica como <period>:<count> En el ejemplo anterior, el período es una duración y el recuento es un número entero positivo. Si hay más de --gc_thrashing_threshold por ciento de espacio titular (montón de generación anterior) permanece ocupado después de <count> varias recolecciones de elementos no utilizados consecutivas dentro de <period>, se activará una OOM. Si hay varios límites, puedes separarlos por comas.
Etiquetas:host_machine_resource_optimizations
- Valor predeterminado de
--local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>
: "HOST_CPUS" -
Establece de forma explícita la cantidad total de núcleos de CPU locales disponibles para que Bazel invierta en acciones de compilación ejecutadas de forma local. Toma un número entero o "HOST_CPUS", opcionalmente seguido de [-|*]<float> (p. ej., HOST_CPUS*.5 para usar la mitad de los núcleos de CPU disponibles). De forma predeterminada, (“HOST_CPUS”), Bazel consultará la configuración del sistema para estimar la cantidad de núcleos de CPU disponibles.
Etiquetas:host_machine_resource_optimizations
- Se acumulan
--local_extra_resources=<a named float, 'name=value'>
usos múltiples -
Establece la cantidad de recursos adicionales disponibles para Bazel. Toma un par de números de punto flotante de cadena. Se puede usar varias veces para especificar varios tipos de recursos adicionales. Bazel limitará las acciones que se ejecutan en simultáneo en función de los recursos adicionales disponibles y los necesarios. Las pruebas pueden declarar la cantidad de recursos adicionales que necesitan con una etiqueta de “resources:<resoucename>:<amount>”. de un conjunto de datos
tengan un formato común. La CPU, la RAM y los recursos disponibles no se pueden configurar con esta marca.
Etiquetas:host_machine_resource_optimizations
--local_ram_resources=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
valor predeterminado: "HOST_RAM*.67"-
Establece de forma explícita la cantidad total de RAM del host local (en MB) disponible para Bazel a fin de invertir en acciones de compilación ejecutadas localmente. Toma un número entero, o "HOST_RAM", opcionalmente seguido de [-|*]<float> (p. ej., HOST_RAM*.5 para usar la mitad de la RAM disponible). De forma predeterminada, ("HOST_RAM*.67"), Bazel consultará la configuración del sistema para estimar la cantidad de RAM disponible y utilizará el 67% de esta.
Etiquetas:host_machine_resource_optimizations
- 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. Recibe una asignación a un número de punto flotante o HOST_RAM/HOST_CPUS, opcionalmente seguido de [-|*]<float> (p. ej., memory=HOST_RAM*.5 para usar la mitad de la RAM disponible). Se puede usar varias veces para especificar varios tipos de recursos. Bazel limitará las acciones que se ejecutan en simultáneo según los recursos disponibles y los necesarios. Las pruebas pueden declarar la cantidad de recursos que necesitan con la etiqueta “resources:<resource name>:<amount>”. de un conjunto de datos
tengan un formato común. 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 de configuración avanzada del motor interno Skyframe de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de recolección de elementos no utilizados completa, eliminará el estado temporal de Skyframe innecesario, hasta esta cantidad de veces por invocación. La configuración predeterminada es Integer.MAX_VALUE; eficazmente ilimitados. Cero significa que los eventos de recolección de elementos no utilizados completas nunca activarán la acción de soltar. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC completo y se supere ese umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: “2147483647”-
Marca de configuración avanzada del motor interno Skyframe de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando ocurra un evento menor de recolección de elementos no utilizados, se eliminará el estado temporal de Skyframe innecesario, hasta esta cantidad de veces por invocación. La configuración predeterminada es Integer.MAX_VALUE; eficazmente ilimitados. Cero significa que los eventos menores de recolección de elementos no utilizados nunca activarán la acción de soltar. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC menor y se supere ese umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
- Valor predeterminado de
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
Marca de configuración avanzada del motor interno Skyframe de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es al menos este umbral, descartará el estado temporal de Skyframe innecesario. Ajustar esto puede permitirte mitigar el impacto en el tiempo de la hiperpaginación de GC cuando la hiperpaginación de GC (i) es causada por el uso de memoria de este estado temporal y (ii) es más costosa que reconstituir el estado cuando sea necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Valor predeterminado de
--[no]debug_spawn_scheduler
: "falso" - Valor predeterminado de
--[no]experimental_bep_target_summary
: "falso" - Especifica si se publicarán los eventos de TargetSummary.
- Valor predeterminado de
--[no]experimental_build_event_expand_filesets
: "falso" -
Si es verdadero, expande los conjuntos de archivos en BEP cuando presentes archivos de salida.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]experimental_build_event_fully_resolve_fileset_symlinks
: "falso" -
Si es verdadero, resuelve por completo los symlinks relativos del conjunto de archivos en el BEP cuando presentes los archivos de salida. Requiere --experimental_build_event_expand_filesets.
Etiquetas:affects_outputs
- Valor predeterminado de
--experimental_build_event_upload_max_retries=<an integer>
: "4" -
La cantidad máxima de veces que Bazel debería reintentar subir un evento de compilación.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
: "1s" -
Es el retraso mínimo inicial para los reintentos de retirada exponencial cuando falla la carga de BEP. (exponente: 1.6)
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--experimental_build_event_upload_strategy=<a string>
: ver descripción -
Selecciona cómo subir los artefactos a los que se hace referencia en el protocolo del evento de compilación.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]experimental_collect_local_sandbox_action_metrics
: "true" -
No-op dejó de estar disponible.
Etiquetas:execution
- Valor predeterminado de
--experimental_command_profile=<cpu, wall, alloc or lock>
: ver descripción - Registra un perfil de la grabadora de vuelos de Java mientras dure el comando. Se debe proporcionar uno de los tipos de eventos de generación de perfiles admitidos (CPU, muro, asignación 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 la semántica de esta marca podrían cambiar en el futuro para admitir tipos de perfil o formatos de salida adicionales. usar bajo tu propia responsabilidad.
- Valor predeterminado de
--[no]experimental_docker_verbose
: "falso" -
Si se habilita, Bazel imprimirá mensajes más detallados sobre la estrategia de la zona de pruebas de Docker.
Etiquetas:execution
- Valor predeterminado de
--[no]experimental_materialize_param_files_directly
: "falso" -
Si materializas archivos de parámetros, hazlo con escrituras directas en el disco.
Etiquetas:execution
- Valor predeterminado de
--[no]experimental_record_metrics_for_all_mnemonics
: "falso" - De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemónicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán las estadísticas de todos los mnemónicos.
- Valor predeterminado de
--experimental_repository_resolved_file=<a string>
: "" -
Si no está vacío, escriba un valor de Starlark con la información resuelta de todas las reglas del repositorio de Starlark que se ejecutaron.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]experimental_run_bep_event_include_residue
: "falso" -
Indica si se debe incluir el residue de línea de comandos en eventos de compilación en ejecución que podrían contener el residue. De forma predeterminada, el residue no se incluye en los eventos de compilación de comandos de ejecución que podrían contener el residue.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]experimental_stream_log_file_uploads
: "falso" -
Transmite las cargas de archivos de registro directamente al almacenamiento remoto en lugar de escribirlas en el disco.
Etiquetas:affects_outputs
- Valor predeterminado de
--explain=<a path>
: ver descripción -
Hace que el sistema de compilación explique cada paso ejecutado de la compilación. La explicación se escribe en el archivo de registro especificado.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]ignore_unsupported_sandboxing
: "falso" -
No imprimir una advertencia cuando este sistema no admita la ejecución de la zona de pruebas.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]legacy_important_outputs
: "true" -
Úsalo para suprimir la generación del campo relevant_outputs heredado en el evento TargetComplete. importantes_outputs son obligatorios para la integración de Bazel a ResultStore.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]materialize_param_files
: "falso" -
Escribe archivos de parámetros intermedios en el árbol de salida, incluso cuando se usa la ejecución de acción remota. Es útil para depurar acciones. Esto está implícito en --subcomandos y --verbose_failures.
Etiquetas:execution
- Valor predeterminado de
--max_config_changes_to_show=<an integer>
: "3" -
Cuando se descarta la caché de análisis debido a un cambio en las opciones de compilación, se muestra hasta la cantidad determinada de nombres de opciones modificados. Si el número proporcionado es -1, se mostrarán todas las opciones modificadas.
Etiquetas:terminal_output
- Valor predeterminado de
--max_test_output_bytes=<an integer>
: "-1" -
Especifica el tamaño máximo por registro de prueba que puede emitirse cuando --test_output es “errores” o "todos". Es útil para evitar sobrecargar la salida con resultados de prueba demasiado ruidosos. El encabezado de la prueba se incluye en el tamaño del registro. Los valores negativos implican que no hay límite. La salida es todo o nada.
Etiquetas:test_runner
,terminal_output
yexecution
- Valor predeterminado de
--output_filter=<a valid Java regular expression>
: ver descripción -
Solo muestra advertencias y resultados de acciones para reglas cuyo nombre coincida con la expresión regular proporcionada.
Etiquetas:affects_outputs
- Valor predeterminado de
--progress_report_interval=<an integer in 0-3600 range>
: "0" -
La cantidad de segundos que se debe esperar entre informes sobre trabajos que aún se están ejecutando. El valor predeterminado 0 significa que el primer informe se imprimirá después de 10 segundos, luego 30 segundos y, después de ese tiempo, se informará una vez por minuto. Cuando se habilita --maldiciones, el progreso se informa cada segundo.
Etiquetas:affects_outputs
- Valor predeterminado de
--remote_print_execution_messages=<failure, success or all>
: "error" -
Elige cuándo imprimir los mensajes de ejecución remota. Los valores válidos son `failure` (error), para imprimir solo en caso de errores, "success" para imprimir solo en caso de éxito y "all" para imprimir siempre.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]sandbox_debug
: "falso" -
Habilita las funciones de depuración para la función de zona de pruebas. Esto incluye dos cosas: primero, el contenido raíz de la zona de pruebas no se modifica después de una compilación. Segundo, imprime información de depuración adicional en la ejecución. Esto puede ayudar a los desarrolladores de reglas de Bazel o Starlark con fallas de depuración debido a archivos de entrada faltantes, etcétera.
Etiquetas:terminal_output
- Valor predeterminado de
--show_result=<an integer>
: "1" -
Muestra los resultados de la compilación. Para cada destino, indica si se actualizó y, de ser así, una lista de los archivos de salida que se compilaron. Los archivos impresos son cadenas convenientes que se pueden copiar y pegar en la shell para ejecutarlos.
Esta opción requiere un argumento de número entero, que es el número de umbral de objetivos por encima del cual no se imprime la información del resultado. Por lo tanto, cero provoca la supresión del mensaje y MAX_INT hace que siempre se imprima el resultado. El valor predeterminado es uno.
Si no se compiló nada para un objetivo, se pueden omitir sus resultados a fin de mantener los resultados por debajo del umbral.
Etiquetas:affects_outputs
--[no]subcommands
[-s
] predeterminado: "false"-
Muestra los subcomandos que se ejecutaron durante una compilación. Marcas relacionadas: --execution_log_json_file, --execution_log_binary_file (para registrar subcomandos en un archivo en un formato compatible con las herramientas)
Etiquetas:terminal_output
--test_output=<summary, errors, all or streamed>
predeterminado: "summary"-
Especifica el modo de salida deseado. Los valores válidos son “summary”. para mostrar solo el resumen del estado de prueba, para imprimir registros de prueba de las pruebas fallidas, "all" para imprimir registros de todas las pruebas y "transmitidos" para generar registros para todas las pruebas en tiempo real (esto forzará la ejecución local de las pruebas, una a la vez, independientemente del valor de --test_strategy)
Etiquetas:test_runner
,terminal_output
yexecution
- Valor predeterminado de
--test_summary=<short, terse, detailed, none or testcase>
: “short” -
Especifica el formato deseado para el resumen de la prueba. Los valores válidos son "short" para imprimir solo información sobre las pruebas ejecutadas, "terse", para imprimir información sobre las pruebas no exitosas que se hayan ejecutado, "detalladas" para imprimir información detallada sobre casos de prueba fallidos, “testcase” para imprimir el resumen en la resolución de casos de prueba, no imprimir información detallada sobre los casos de prueba fallidos y “ninguno” para omitir el resumen.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]verbose_explanations
: "falso" -
Aumenta la verbosidad de las explicaciones emitidas si --explain está habilitada. No tiene efecto si --explain no está habilitada.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]verbose_failures
: "falso" -
Si un comando falla, muestra la línea de comandos completa.
Etiquetas:terminal_output
- Opciones que especifican o modifican una entrada genérica para un comando de Bazel que no se encuentra en otras categorías.
- Se acumulan
--aspects_parameters=<a 'name=value' assignment>
usos múltiples -
Especifica los valores de los parámetros de aspectos de la línea de comandos. Cada valor del parámetro se especifica mediante <param_name>=<param_value>, por ejemplo, 'my_param=my_val' en el que “my_param” es un parámetro de algún aspecto en la lista de --aspects o requerido por un aspecto de la lista. Esta opción se puede usar varias veces. Sin embargo, no se permite asignar valores al mismo parámetro más de una vez.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Valor predeterminado de
--target_pattern_file=<a string>
: "" -
Si se configura, la compilación leerá los patrones del archivo nombrado aquí, en lugar de hacerlo en la línea de comandos. Es un error especificar un archivo aquí, al igual que patrones de la línea de comandos.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remoto:
- Valor predeterminado de
--experimental_circuit_breaker_strategy=<failure>
: ver descripción -
Especifica la estrategia que usará el disyuntor. Las estrategias disponibles son “fallas”. Si el valor de la opción no es válido, no se establece el mismo comportamiento que la opción.
Etiquetas:execution
- Valor predeterminado de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo con el que se configurará el cargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno que debe coincidir y otro para usar como URL sustituta, con referencias inversas a partir de `$1`. Es posible proporcionar varias directivas "rewrite" para la misma URL; en este caso, se devolverán varias URL.
- Valor predeterminado de
--[no]experimental_guard_against_concurrent_changes
: "falso" - Desactiva esta opción para inhabilitar la verificación del tiempo de los archivos de entrada de una acción antes de subirla a una caché remota. Puede haber casos en los que el kernel de Linux retrase la escritura de archivos, lo que podría provocar falsos positivos.
- Valor predeterminado de
--[no]experimental_remote_cache_async
: "falso" - Si es verdadero, la E/S de la caché remota ocurrirá en segundo plano, en lugar de ocurrir como parte de un generador.
- Valor predeterminado de
--experimental_remote_cache_compression_threshold=<an integer>
: "0" - El tamaño mínimo de BLOB para comprimir o descomprimir con zstd. Es ineficaz, a menos que se configure --remote_cache_compression.
- Valor predeterminado de
--experimental_remote_cache_eviction_retries=<an integer>
: "0" -
La cantidad máxima de intentos para reintentar si la compilación encontró un error de expulsión de caché remota. Un valor distinto de cero establecerá implícitamente --incompatible_remote_use_new_exit_code_for_lost_inputs como true. Se generará un nuevo ID de invocación para cada intento. Si generas el ID de invocación y se lo proporcionas a Bazel con --invocation_id, no debes usar esta marca. En su lugar, configura la marca --incompatible_remote_use_new_exit_code_for_lost_inputs y verifica el código de salida 39.
Etiquetas:execution
- Valor predeterminado de
--[no]experimental_remote_cache_lease_extension
: "falso" - Si se configura como verdadero, Bazel extenderá la asignación de tiempo para los resultados de las acciones remotas durante la compilación enviando llamadas a `FindMissingBlobs` de forma periódica a la caché remota. La frecuencia se basa en el valor de `--experimental_remote_cache_ttl`.
--experimental_remote_cache_ttl=<An immutable length of time.>
valor predeterminado: "3h"-
El TTL mínimo garantizado de los BLOB en la caché remota después de que se hace referencia recientemente a sus resúmenes, p.ej., por un ActionResult o FindMissingBlobs. Bazel realiza varias optimizaciones basadas en la información de los BLOB. TTL, p.ej., no llama repetidamente a GetActionResult en una compilación incremental. El valor debe establecerse un poco menor que el TTL real, ya que hay un espacio entre el momento en que el servidor muestra los resúmenes y el momento en que Bazel los recibe.
Etiquetas:execution
- Valor predeterminado de
--experimental_remote_capture_corrupted_outputs=<a path>
: ver descripción - Una ruta de acceso a un directorio en el que se capturarán los resultados dañados.
- Valor predeterminado de
--[no]experimental_remote_discard_merkle_trees
: "falso" - Si se configura como verdadera, descarta las copias en la memoria del árbol Merkle de la raíz de entrada y las asignaciones de entradas asociadas durante las llamadas a GetActionResult() y Execute(). Esto reduce significativamente el uso de memoria, pero requiere que Bazel vuelva a procesarlos ante errores y reintentos de caché remota.
- Valor predeterminado de
--experimental_remote_downloader=<a string>
: ver descripción - Un URI de extremo de la API de Remote Asset, que se usará como proxy de descarga remota. Los esquemas compatibles son gRPC, grpcs (grpc con TLS habilitado) y Unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel usará grpcs de forma predeterminada. Visita https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto.
- Valor predeterminado de
--[no]experimental_remote_downloader_local_fallback
: "falso" - Indica si se debe recurrir a la descarga local en caso de que falle la descarga remota.
- Valor predeterminado de
--[no]experimental_remote_execution_keepalive
: "falso" - Indica si se debe usar keepalive para llamadas de ejecución remota.
- Valor predeterminado de
--experimental_remote_failure_rate_threshold=<an integer in 0-100 range>
: "10" -
Establece la cantidad permitida de tasa de fallas en porcentaje para un período específico, después del cual se deja de llamar a la caché o al ejecutor remoto. De forma predeterminada, el valor es 10. Si se establece en 0, no hay limitación.
Etiquetas:execution
--experimental_remote_failure_window_interval=<An immutable length of time.>
valor predeterminado: "60 s"-
El intervalo en el que se calcula la tasa de fallas de las solicitudes remotas. Con un valor de cero o negativo, la duración de la falla se calcula por toda la duración de la ejecución.Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
Etiquetas:execution
- Valor predeterminado de
--[no]experimental_remote_mark_tool_inputs
: "falso" - Si la estableces como verdadera, Bazel marcará las entradas como entradas de herramientas para el ejecutor remoto. Puede usarse para implementar trabajadores persistentes remotos.
- Valor predeterminado de
--[no]experimental_remote_merkle_tree_cache
: "falso" - Si se establece en true, se memorizarán los cálculos del árbol de Merkle para mejorar la velocidad de comprobación de aciertos de caché remota. La huella de memoria de la caché se controla mediante --experimental_remote_merkle_tree_cache_size.
- Valor predeterminado de
--experimental_remote_merkle_tree_cache_size=<a long integer>
: "1000" - La cantidad de árboles de Merkle que se deben memorizar para mejorar la velocidad de comprobación de aciertos de caché remota. Aunque la caché se reduce automáticamente según el manejo de referencias suaves de Java, se pueden producir errores de memoria insuficiente si la configuración es muy 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.
- Valor predeterminado de
--[no]experimental_remote_require_cached
: "falso" - Si se configura como verdadera, establece que todas las acciones que pueden ejecutarse de forma remota se almacenen en caché o que falle la compilación. Esto es útil para solucionar problemas de no determinismo, ya que permite comprobar si las acciones que deben almacenarse en caché realmente se almacenan en caché sin insertar falsamente resultados nuevos en la caché.
- Valor predeterminado de
--experimental_remote_scrubbing_config=<Converts to a Scrubber>
: ver descripción - Permite el borrado de claves de caché remota con el archivo de configuración suministrado, que debe ser un búfer de protocolo en formato de texto (consulta src/main/protobuf/remote_scrubbing.proto). Esta función está diseñada para facilitar el uso compartido de una caché remota o de disco entre acciones que se ejecutan en diferentes plataformas, pero que se orientan a la misma. Se debe utilizar con mucho cuidado, ya que una configuración incorrecta puede provocar que las entradas de la caché se compartan accidentalmente y dar como resultado compilaciones incorrectas. La limpieza no afecta la forma en que se ejecuta una acción, solo la manera en que se calcula su clave de caché remota o de disco con el fin de recuperar o almacenar un resultado de acción. Las acciones depuradas son incompatibles con la ejecución remota y, por lo tanto, siempre se ejecutarán de manera 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, es recomendable que configures --host_platform junto con --experimental_platform_in_output_dir (para normalizar los prefijos de salida) y --incompatible_strict_action_env (para normalizar las variables de entorno).
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
predeterminado: "automático"- El modo de subprocesos que se usará para la recuperación del repositorio. Si se configura en “off”, no se usa ningún subproceso de trabajo y la recuperación del repositorio está sujeta a reinicios. De lo contrario, utiliza un subproceso de plataforma (es decir, un subproceso del SO) si está configurado como "platform". o un subproceso virtual si está configurado como “virtual”. Si se configura como "auto", se usan subprocesos virtuales si están disponibles (es decir, si se ejecutan en JDK 21+). De lo contrario, no se utiliza ningún subproceso de trabajador.
- Valor predeterminado de
--[no]incompatible_remote_build_event_upload_respect_no_cache
: "falso" - Obsoleto. No-ops. En su lugar, usa --remote_build_event_upload=minimal.
- Valor predeterminado de
--[no]incompatible_remote_downloader_send_all_headers
: "true" -
Establece si se deben enviar todos los valores de un encabezado con valores múltiples al cargador remoto en lugar de solo al primero.
Etiquetas:incompatible_change
- Valor predeterminado de
--[no]incompatible_remote_output_paths_relative_to_input_root
: "falso" -
Si se configura como verdadera, las rutas de salida son relativas a la raíz de entrada en lugar del directorio de trabajo.
Etiquetas:incompatible_change
- Valor predeterminado de
--[no]incompatible_remote_results_ignore_disk
: "true" -
No-ops
Etiquetas:incompatible_change
- Valor predeterminado de
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
: "true" -
Si la estableces como verdadera, Bazel usará el nuevo código de salida 39, en lugar de 34, si la caché remota expulsa los BLOB durante la compilación.
Etiquetas:incompatible_change
- Valor predeterminado de
--[no]remote_accept_cached
: "true" - Indica si se deben aceptar los resultados de acciones almacenados en caché de forma remota.
- Valor predeterminado de
--remote_build_event_upload=<all or minimal>
: “mínimo” - Si se configura como “all”, todas las salidas locales a las que hace referencia BEP se suben a la caché remota. Si se configura como “mínimo”, las salidas locales a las que hace referencia BEP no se suben a la caché remota, excepto los archivos que son importantes para los consumidores de BEP (p.ej., los registros de prueba y el perfil de tiempo). El esquema bytestream:// siempre se usa para el URI de los archivos, incluso si faltan en la caché remota. La configuración predeterminada es "minimal".
- Valor predeterminado de
--remote_bytestream_uri_prefix=<a string>
: ver descripción - El nombre de host y el nombre de la instancia que se usarán en los URI bytestream:// que se escriben en transmisiones de eventos de compilación. Esta opción se puede configurar cuando las compilaciones se realizan con un proxy, lo que hace que los valores de --remote_executor y --remote_instance_name ya no correspondan con el nombre canónico del servicio de ejecución remota. Si no la estableces, se establecerá la configuración predeterminada como "${hostname}/${instance_name}".
- Valor predeterminado de
--remote_cache=<a string>
: ver descripción - Un URI de un extremo de almacenamiento en caché. Los esquemas compatibles son http, https, grpc, grpcs (grpc con TLS habilitado) y Unix (sockets UNIX locales), Si no se proporciona un esquema, Bazel usará grpcs de forma predeterminada. Especifica el esquema grpc://, http:// o unix: para inhabilitar TLS. Consulta https://bazel.build/remote/caching
- Valor predeterminado de
--[no]remote_cache_compression
: "falso" - Si se habilita, comprime o descomprime los BLOB de caché con zstd 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 especificando la marca varias veces. Si hay varios valores para el mismo nombre, se convertirán en una lista separada por comas.
- Se acumulan
--remote_default_exec_properties=<a 'name=value' assignment>
usos múltiples -
Establece las propiedades de ejecución predeterminadas que se usarán como plataforma de ejecución remota si una plataforma de ejecución aún no configuró exec_properties.
Etiquetas:affects_outputs
- Valor predeterminado de
--remote_default_platform_properties=<a string>
: "" - Establece las propiedades de plataforma predeterminadas que se establecerán para la API de ejecución remota, si la plataforma de ejecución todavía no configuró remote_execution_properties. Este valor también se usará si se selecciona la plataforma host como plataforma de ejecución remota.
- Se acumulan
--remote_download_regex=<a string>
usos múltiples -
Forzar a Bazel a descargar los artefactos que coincidan con la regexp determinada Se debe usar junto con Build sin los bytes (o el equivalente interno) para permitir que el cliente solicite ciertos artefactos que podrían ser necesarios a nivel local (p.ej., compatibilidad con IDE). Se pueden especificar múltiples regex con la repetición de esta marca.
Etiquetas:affects_outputs
- Se acumulan
--remote_downloader_header=<a 'name=value' assignment>
usos múltiples - Especifica un encabezado que se incluirá en las solicitudes de descargas remotas: --remote_downloader_header=Name=Value. Se pueden pasar varios encabezados especificando la marca varias veces. Si hay varios valores para el mismo nombre, se convertirán en una lista separada por comas.
- Se acumulan
--remote_exec_header=<a 'name=value' assignment>
usos múltiples - Especifica un encabezado que se incluirá en las solicitudes de ejecución: --remote_exec_header=Name=Value. Se pueden pasar varios encabezados especificando la marca varias veces. Si hay varios valores para el mismo nombre, se convertirán en una lista separada por comas.
- Valor predeterminado de
--remote_execution_priority=<an integer>
: "0" - La prioridad relativa de las acciones que se ejecutarán de forma remota. La semántica de los valores de prioridad particulares depende del servidor.
- Valor predeterminado de
--remote_executor=<a string>
: ver descripción - HOST o HOST:PORT de un extremo de ejecución remota. Los esquemas compatibles son gRPC, grpcs (grpc con TLS habilitado) y Unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel usará grpcs de forma predeterminada. Especifica el esquema grpc:// o unix: para inhabilitar TLS.
- Valor predeterminado de
--remote_grpc_log=<a path>
: ver descripción - Si se especifica, una ruta de acceso a un archivo para registrar detalles relacionados con la llamada de gRPC. Este registro consta de una secuencia de protobufs com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry serializados con cada mensaje con prefijo de un varint que denota el tamaño del siguiente mensaje protobuf serializado, como lo realiza el método LogEntry.writeDelimitedTo(OutputStream).
- Se acumulan
--remote_header=<a 'name=value' assignment>
usos múltiples - Especifica un encabezado que se incluirá en las solicitudes: --remote_header=Name=Value. Se pueden pasar varios encabezados especificando la marca varias veces. Si hay varios valores para el mismo nombre, se convertirán en una lista separada por comas.
- Valor predeterminado de
--remote_instance_name=<a string>
: "" - Valor para pasar como instance_name en la API de ejecución remota.
- Valor predeterminado de
--[no]remote_local_fallback
: "falso" - Determina si se debe recurrir a una estrategia de ejecución local independiente si falla la ejecución remota.
- Valor predeterminado de
--remote_local_fallback_strategy=<a string>
: "local" - No-op, obsoleto. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/7480.
- Valor predeterminado de
--remote_max_connections=<an integer>
: "100" -
Limita la cantidad máxima de conexiones simultáneas al ejecutor o la caché remotos. De forma predeterminada, el valor es 100. Si se establece en 0, no hay limitación.
Para la caché remota HTTP, una conexión TCP podía manejar una solicitud a la vez, por lo que Bazel podría generar hasta --remote_max_connections solicitudes simultáneas.
Para el ejecutor o la caché remoto de gRPC, un canal de gRPC, por lo general, podía manejar más de 100 solicitudes simultáneas, por lo que Bazel podría realizar alrededor de `--remote_max_connections * 100` solicitudes simultáneas.
Etiquetas:host_machine_resource_optimizations
- Valor predeterminado de
--remote_proxy=<a string>
: ver descripción - Conéctate a la caché remota a través de un proxy. Actualmente, esta marca solo se puede usar para configurar un socket de dominio Unix (unix:/path/to/socket).
- Valor predeterminado de
--remote_result_cache_priority=<an integer>
: "0" - La prioridad relativa de las acciones remotas que se almacenarán en la caché remota. La semántica de los valores de prioridad particulares depende del servidor.
- Valor predeterminado de
--remote_retries=<an integer>
: "5" - La cantidad máxima de intentos para reintentar un error transitorio. Si se establece en 0, se inhabilitan los reintentos.
- Valor predeterminado de
--remote_retry_max_delay=<An immutable length of time.>
: "5 s" - El retraso máximo de retirada entre los reintentos remotos. Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
--remote_timeout=<An immutable length of time.>
valor predeterminado: "60 s"- La cantidad máxima de tiempo que se debe esperar la ejecución remota y las llamadas de caché. Para la caché REST, este es el tiempo de espera de conexión y de lectura. Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
- Valor predeterminado de
--[no]remote_upload_local_results
: "true" - Establece si se deben subir resultados de acciones ejecutadas de forma local a la caché remota si esta lo admite y si el usuario tiene autorización para hacerlo.
- Valor predeterminado de
--[no]remote_verify_downloads
: "true" - Si la estableces como verdadera, Bazel calculará la suma de hash de todas las descargas remotas y descartará los valores almacenados en caché remotamente si no coinciden con el valor esperado.
- Otras opciones, que no se categorizan de ninguna otra manera:
- Valor predeterminado de
--[no]allow_analysis_cache_discard
: "true" -
Si se descarta la caché de análisis debido a un cambio en el sistema de compilación, configurar esta opción como falsa hará que Bazel se cierre, en lugar de continuar con la compilación. Esta opción no tiene efecto cuando "discard_analysis_cache" también se configura.
Etiquetas:eagerness_to_exit
- Valor predeterminado de
--auto_output_filter=<none, all, packages or subpackages>
: "ninguno" - Si no se especifica --output_filter, entonces el valor de esta opción se usa para crear un filtro automáticamente. Los valores permitidos son "ninguno" (filtrar nada / mostrar todo), 'todo' (filtrar todo / no mostrar nada), 'paquetes' (incluye el resultado de las reglas de los paquetes mencionados en la línea de comandos de Blaze) y los “subpaquetes” (como "paquetes", pero también incluir subpaquetes). Para los 'paquetes' y “subpaquetes” los valores //java/foo y //javatests/foo se tratan como un solo paquete)'.
- Valor predeterminado de
--[no]build_manual_tests
: "falso" - Fuerza los objetivos de prueba etiquetados como "manuales" que se construya. 'manual' se excluyen del procesamiento. Esta opción los obliga a compilarse (pero no a ejecutarse).
- Valor predeterminado de
--build_tag_filters=<comma-separated list of options>
: "" - Especifica una lista de etiquetas separadas por comas. De manera opcional, cada etiqueta puede ir precedida por "-" para especificar etiquetas excluidas. Solo se crearán esos objetivos que contengan al menos una etiqueta incluida y que no contengan ninguna etiqueta excluida. Esta opción no afecta el conjunto de pruebas ejecutadas con el comando "test" comando; se rigen por las opciones de filtro de prueba, por ejemplo, "--test_tag_filters"
- Valor predeterminado de
--[no]build_tests_only
: "falso" - Si se especifica, solo se compilarán las reglas *_test y test_suite y se ignorarán los demás destinos especificados en la línea de comandos. De forma predeterminada, se compilará todo lo que se solicitó.
- Valor predeterminado de
--combined_report=<none or lcov>
: "ninguno" - Especifica el tipo de informe de cobertura acumulativa deseado. En este punto, solo se admite LCOV.
- Valor predeterminado de
--[no]compile_one_dependency
: "falso" - Compila una sola dependencia de los archivos de argumento. Esto es útil para verificar la sintaxis de los archivos de origen en los IDE, por ejemplo, recompilando un único destino que depende del archivo fuente para detectar errores lo antes posible en el ciclo de edición, compilación y prueba. Este argumento afecta la forma en que se interpretan todos los argumentos que no son de marca. en lugar de ser objetivos de compilación, sino nombres de archivos de origen. Para cada nombre de archivo de origen, se compilará un destino arbitrario que dependa de él.
- Se acumulan
--deleted_packages=<comma-separated list of package names>
usos múltiples - Una lista separada por comas de los nombres de los paquetes que el sistema de compilación considerará inexistentes, incluso si están visibles en alguna parte de la ruta del paquete. Usa esta opción cuando borres un subpaquete "x/y" de un paquete 'x' existente. Por ejemplo, después de borrar x/y/BUILD en tu cliente, el sistema de compilación puede presentar un reclamo si encuentra la etiqueta “//x:y/z”. si aún lo proporciona otra entrada package_path. Especificar --deleted_packages x/y evita este problema.
- Valor predeterminado de
--[no]discard_analysis_cache
: "falso" - Descarta la caché de análisis inmediatamente después de que se complete la fase de análisis. Reduce el uso de memoria en aproximadamente un 10%, pero ralentiza las compilaciones incrementales adicionales.
- Valor predeterminado de
--disk_cache=<a path>
: ver descripción - Una ruta de acceso a un directorio en el que Bazel puede leer y escribir acciones y resultados de acciones. Si el directorio no existe, se creará.
- Valor predeterminado de
--embed_label=<a one-line string>
: "" - Incorpora la revisión del control de origen o la etiqueta de la versión en el objeto binario
- Valor predeterminado de
--execution_log_binary_file=<a path>
: ver descripción - Registra los generadores ejecutados en este archivo como protos SpawnExec delimitados por longitud, según src/main/protobuf/spawn.proto. Marcas relacionadas: --execution_log_json_file (formato JSON de texto; mutuamente excluyente), --execution_log_sort (si se debe ordenar el registro de ejecución), --subcomandos (para mostrar subcomandos en el resultado de la terminal).
- Valor predeterminado de
--execution_log_json_file=<a path>
: ver descripción - Registra los generadores ejecutados en este archivo como representaciones JSON delimitadas por saltos de línea de los proto SpawnExec, según src/main/protobuf/spawn.proto. Marcas relacionadas: --execution_log_binary_file (formato binario protobuf, mutuamente excluyente), --execution_log_sort (si se debe ordenar el registro de ejecución), --subcomandos (para mostrar subcomandos en el resultado de la terminal).
- Valor predeterminado de
--[no]execution_log_sort
: "true" - Establece si se debe ordenar el registro de ejecución, lo que facilita la comparación de registros en las invocaciones. Se configura como falso para evitar un uso potencialmente significativo de CPU y memoria al final de la invocación, a costa de producir el registro en un orden de ejecución no determinista. Solo se aplica a los formatos binarios y JSON. el formato compacto nunca está ordenado.
- Valor predeterminado de
--[no]expand_test_suites
: "true" -
Expandir los objetivos de test_suite a sus pruebas constituyentes antes del análisis Cuando esta marca esté activada (configuración predeterminada), se aplicarán patrones de objetivo negativo a las pruebas que pertenezcan al paquete de pruebas; de lo contrario, no se aplicarán. Desactivar esta marca es útil cuando los aspectos de nivel superior se aplican en la línea de comandos: luego, pueden analizar los objetivos de test_suite.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--experimental_execution_log_compact_file=<a path>
: ver descripción - Registra los generadores ejecutados en este archivo como protos ExecLogEntry delimitados por longitud, según src/main/protobuf/spawn.proto. Todo el archivo 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 binario protobuf, mutuamente excluyente), --execution_log_json_file (formato JSON de texto; mutuamente excluyente), --subcomandos (para mostrar subcomandos en el resultado de la terminal).
- Valor predeterminado de
--experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "" - Obsoleto para dar lugar a aspectos. Filtra el conjunto de objetivos para los que se programarán acciones extra.
- Valor predeterminado de
--[no]experimental_extra_action_top_level_only
: "falso" - Obsoleto para dar lugar a aspectos. Solo programa extra_actions para los objetivos de nivel superior.
--experimental_spawn_scheduler
-
Habilita la ejecución dinámica ejecutando acciones de forma local y remota en paralelo. Bazel genera cada acción de forma local y remota, y elige la que se complete primero. Si una acción admite trabajadores, la acción local se ejecutará en modo de trabajador persistente. Para habilitar la ejecución dinámica para un nombre mnemotécnico de acción individual, usa las marcas `--internal_spawn_scheduler` y `--strategy=<mnemonic>=dynamic`.
Se expande a:
--internal_spawn_scheduler
--spawn_strategy=dynamic
.
- Valor predeterminado de
--[no]fetch
: "true" - Permite que el comando recupere dependencias externas. Si se configura como falsa, el comando usará cualquier versión almacenada en caché de la dependencia; si no existe ninguna, el comando fallará.
- Valor predeterminado de
--[no]incompatible_dont_use_javasourceinfoprovider
: "falso" -
No-ops
Etiquetas:incompatible_change
- Valor predeterminado de
--local_termination_grace_seconds=<an integer>
: "15" - Tiempo de espera entre la finalización de un proceso local debido al tiempo de espera y su cierre forzado.
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso dada es una ruta de acceso absoluta, se usará tal como es. Si la ruta de acceso determinada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso dada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace"
--package_path=<colon-separated list of options>
predeterminado: “%workspace%”- Una lista separada por dos puntos de dónde buscar paquetes Elementos que comienzan con “%workspace%” están relacionadas con el espacio de trabajo que los contiene. Si se omite o está vacío, el valor predeterminado es el resultado de “bazel info default-package-path”.
- Valor predeterminado de
--[no]show_loading_progress
: "true" - Si se habilita, hace que Bazel imprima el mensaje "Loading package:" (Cargando paquete): mensajes nuevos.
- Valor predeterminado de
--test_lang_filters=<comma-separated list of options>
: "" - Especifica la lista de idiomas de prueba separados por comas. De manera opcional, cada idioma puede ir precedido por "-" para especificar los idiomas excluidos. Solo se encontrarán los objetivos de prueba que están escritos en los idiomas especificados. El nombre que se usa para cada idioma debe ser el mismo que el prefijo de idioma de la regla *_test; p.ej., uno de 'cc', 'java', 'py', etc. Esta opción afecta el comportamiento --build_tests_only y el comando de prueba.
- Valor predeterminado de
--test_size_filters=<comma-separated list of values: small, medium, large or enormous>
: "" - Especifica la lista de tamaños de prueba separados por comas. De manera opcional, cada tamaño puede ir precedido por "-" para especificar los tamaños excluidos. Solo se detectarán los objetivos de prueba que contienen, al menos, un tamaño incluido y no contienen tamaños excluidos. Esta opción afecta el comportamiento --build_tests_only y el comando test.
- Valor predeterminado de
--test_tag_filters=<comma-separated list of options>
: "" - Especifica la lista de etiquetas de prueba separadas por comas. De manera opcional, cada etiqueta puede ir precedida por "-" para especificar etiquetas excluidas. Solo se detectarán los objetivos de prueba que contienen al menos una etiqueta incluida y no contienen ninguna etiqueta excluida. Esta opción afecta el comportamiento --build_tests_only y el comando test.
- Valor predeterminado de
--test_timeout_filters=<comma-separated list of values: short, moderate, long or eternal>
: "" - Especifica la lista de tiempos de espera de prueba separados por comas. De manera opcional, cada tiempo de espera puede ir precedido por "-" para especificar tiempos de espera excluidos. Solo se detectarán los objetivos de prueba que contienen al menos un tiempo de espera incluido y no contienen tiempos de espera excluidos. Esta opción afecta el comportamiento --build_tests_only y el comando test.
- Valor predeterminado de
--workspace_status_command=<path>
: "" - Es un comando que se invoca al comienzo de la compilación para proporcionar información de estado sobre el lugar de trabajo en forma de pares clave-valor. Consulta el manual del usuario para ver las especificaciones completas. Consulta también tools/buildstamp/get_workspace_status para ver un ejemplo.
- Opciones que controlan la ejecución de compilación:
- Valor predeterminado de
--[no]check_up_to_date
: "falso" -
No realices la compilación, solo verifica si está actualizada. Si todos los destinos están actualizados, la compilación se completará de forma correcta. Si es necesario ejecutar algún paso, se informa un error y la compilación falla.
Etiquetas:execution
- Valor predeterminado de
--[no]experimental_inprocess_symlink_creation
: "falso" -
Especifica si se deben realizar llamadas directas al sistema de archivos para crear árboles de symlinks.
Etiquetas:loading_and_analysis
,execution
yexperimental
- Valor predeterminado de
--[no]experimental_persistent_aar_extractor
: "falso" -
Habilita el extractor de aar persistente con trabajadores.
Etiquetas:execution
- Valor predeterminado de
--[no]experimental_remotable_source_manifests
: "falso" -
Establece si las acciones del manifiesto de la fuente se pueden usar de forma remota.
Etiquetas:loading_and_analysis
,execution
yexperimental
- Valor predeterminado de
--[no]experimental_split_coverage_postprocessing
: "falso" -
Si es verdadero, Bazel ejecutará el procesamiento posterior de cobertura para realizar pruebas en un generación nuevo.
Etiquetas:execution
- Valor predeterminado de
--[no]experimental_split_xml_generation
: "true" -
Si se establece esta marca y una acción de prueba no genera un archivo test.xml, Bazel usa una acción independiente para generar un archivo test.xml de prueba que contiene el registro de pruebas. De lo contrario, Bazel genera un archivo test.xml como parte de la acción de prueba.
Etiquetas:execution
- Valor predeterminado de
--[no]experimental_strict_fileset_output
: "falso" -
Si se habilita esta opción, los conjuntos de archivos tratarán todos los artefactos de salida como archivos normales. No desviarán directorios ni serán sensibles a los symlinks.
Etiquetas:execution
- Valor predeterminado de
--[no]experimental_use_semaphore_for_jobs
: "true" -
Si se configura como verdadero, además, usa el semáforo para limitar la cantidad de trabajos simultáneos.
Etiquetas:host_machine_resource_optimizations
yexecution
- Valor predeterminado de
--genrule_strategy=<comma-separated list of options>
: "" -
Especifica cómo ejecutar genrules. Esta marca se eliminará gradualmente. En su lugar, usa --spawn_strategy=<value> para controlar todas las acciones o --strategy=Genrule=<value> para que controlen solo las genrules.
Etiquetas:execution
- Valor predeterminado de
--[no]incompatible_disallow_unsound_directory_outputs
: "true" -
Si se configura, es un error que una acción materialice un archivo de salida como un directorio. No afecta a los directorios de origen. Consulta https://github.com/bazelbuild/bazel/issues/18646.
Etiquetas:bazel_internal_configuration
yincompatible_change
--jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
[-j
] predeterminada: "automática"-
La cantidad de trabajos simultáneos que se ejecutarán. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5" Los valores deben estar entre 1 y 5,000. Los valores superiores a 2,500 pueden causar problemas de memoria. "automático" calcula un valor predeterminado razonable
según los recursos del host.
Etiquetas:host_machine_resource_optimizations
yexecution
--[no]keep_going
[-k
] predeterminado: "false"-
Continúa tanto como sea posible después de un error. Si bien el destino que falló y los que dependen de él no se pueden analizar, otros requisitos previos de estos objetivos pueden serlo.
Etiquetas:eagerness_to_exit
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
predeterminado: "automático"-
Cantidad de subprocesos paralelos que se usarán en la fase de carga/análisis. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5" "automático" establece un valor predeterminado razonable
según los recursos del host. Debe ser 1 como mínimo.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
: "" -
Agrega o quita teclas de la información de ejecución de una acción según el nombre nemotécnico de la acción. Solo se aplica a las acciones que admiten información de ejecución. Muchas acciones comunes admiten información de ejecución, p.ej., Genrule, CppCompile, Javac, StarlarkAction y TestRunner. Cuando se especifican varios valores, el orden es importante porque muchas regex pueden aplicarse al mismo nombre nemotécnico.
Sintaxis: “regex=[+-]key,regex=[+-]key,...”.
Ejemplos:
'.*=+x,.*=-y,.*=+z' agrega una 'x' y en "z" a y quita "y" de la información de ejecución de todas las acciones.
'Genrule=+requires-x' agrega “requiere-x” a la información de ejecución de todas las acciones de Genrule.
“(?!Genrule).*=-required-x” quita “requiere-x” a partir de la información de ejecución
para todas las acciones que no son de Genrule.
Etiquetas:execution
,affects_outputs
yloading_and_analysis
--persistent_android_dex_desugar
-
Habilita acciones persistentes de dex y expansión de sintaxis de Android mediante trabajadores.
Se expande a:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Etiquetas:host_machine_resource_optimizations
yexecution
--persistent_android_resource_processor
-
Habilita el procesador de recursos persistente de Android con trabajadores.
Se expande a:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
de--strategy=AndroidResourceMerger=worker
de--strategy=AndroidCompiledResourceMerger=worker
de--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
de--strategy=AARGenerator=worker
de--strategy=ProcessDatabinding=worker
de--strategy=GenerateDataBindingBaseClasses=worker
Etiquetas:host_machine_resource_optimizations
yexecution
--persistent_multiplex_android_dex_desugar
-
Habilita acciones persistentes de dex y desugar de Android multiplexadas usando trabajadores.
Se expande a:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
Etiquetas:host_machine_resource_optimizations
yexecution
--persistent_multiplex_android_resource_processor
-
Habilita el procesador de recursos multiplexados de Android persistente con trabajadores.
Se expande a:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
de--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
de--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
de--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
de--modify_execution_info=AARGenerator=+supports-multiplex-workers
Etiquetas:host_machine_resource_optimizations
yexecution
--persistent_multiplex_android_tools
-
Habilita herramientas de Android persistentes y multiplexadas (dexing, expansión de sintaxis y procesamiento de recursos).
Se expande a:
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Etiquetas:host_machine_resource_optimizations
yexecution
- Valor predeterminado de
--[no]skip_incompatible_explicit_targets
: "falso" -
Omite los destinos incompatibles que se enumeran explícitamente en la línea de comandos. De forma predeterminada, la compilación de estos destinos genera un error, pero se omiten en silencio cuando esta opción está habilitada. Consulta https://bazel.build/extending/platforms#skipping-incompatible-targets
Etiquetas:loading_and_analysis
- Valor predeterminado de
--spawn_strategy=<comma-separated list of options>
: "" -
Especifica cómo se ejecutan las acciones de generación de forma predeterminada. Acepta una lista de estrategias separadas por comas de mayor a menor prioridad. Para cada acción, Bazel elige la estrategia con la prioridad más alta que puede ejecutar la acción. El valor predeterminado es “remote,worker,sandboxed,local”. Consulta https://blog.bazel.build/2019/06/19/list-strategy.html para obtener más información.
Etiquetas:execution
- Se acumulan
--strategy=<a '[name=]value1[,..,valueN]' assignment>
usos múltiples -
Especifica cómo distribuir la compilación de otras acciones de generación. Acepta una lista de estrategias separadas por comas de mayor a menor prioridad. Para cada acción, Bazel elige la estrategia con la prioridad más alta que puede ejecutar la acción. El valor predeterminado es “remote,worker,sandboxed,local”. Esta marca anula los valores establecidos por --spawn_strategy (y --genrule_strategy si se usa con Genrule mnemotécnico). Consulta https://blog.bazel.build/2019/06/19/list-strategy.html para obtener más información.
Etiquetas:execution
- Se acumulan
--strategy_regexp=<a '<RegexFilter>=value[,value]' assignment>
usos múltiples -
Anula qué estrategia de generación se debe usar para ejecutar acciones de generación que tengan descripciones que coincidan con un determinado regex_filter. Consulta --per_file_copt para obtener detalles sobre la coincidencia de onregex_filter. Se usa el último regex_filter que coincida con la descripción. Esta opción anula otras marcas para especificar la estrategia. Ejemplo: --strategy_regexp=//foo.*\.cc,-//foo/bar=local significa ejecutar acciones con la estrategia local si sus descripciones coinciden con //foo.*.cc, pero no con //foo/bar. Ejemplo: --strategy_regexp='Compiling.*/bar=local --strategy_regexp=Compiling=sandboxed ejecutará 'Compiling //foo/bar/baz'. con la configuración "local" pero revertir el pedido lo ejecutaría con “sandboxed”.
Etiquetas:execution
- Valor predeterminado de
--[no]use_target_platform_for_tests
: "falso" -
Si es verdadero, Bazel usará la plataforma de destino para ejecutar pruebas en lugar del grupo de ejecución de pruebas.
Etiquetas:execution
- Opciones que configuran la cadena de herramientas utilizada para la ejecución de la acción:
- Valor predeterminado de
--android_compiler=<a string>
: ver descripción -
El compilador de destino de Android.
Etiquetas:affects_outputs
,loading_and_analysis
yloses_incremental_state
--android_crosstool_top=<a build target label>
predeterminado: "//external:android/crosstool"-
La ubicación del compilador C++ que se usa para las compilaciones de Android.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
yloses_incremental_state
- Valor predeterminado de
--android_grte_top=<a label>
: ver descripción -
El objetivo de Android grte_top.
Etiquetas:changes_inputs
,loading_and_analysis
yloses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
predeterminado: "android"-
Selecciona la combinación de manifiestos que se usará para las reglas android_binary. Marca para ayudar a la transición de la combinación de manifiestos de Android desde la combinación heredada.
Etiquetas:affects_outputs
,loading_and_analysis
yloses_incremental_state
- Valor predeterminado de
--android_platforms=<a build target label>
: "" -
Establece las plataformas que usan los objetivos android_binary. Si se especifican varias plataformas, el objeto binario es un APK multiarquitectura, que contiene binarios nativos para cada plataforma de destino especificada.
Etiquetas:changes_inputs
,loading_and_analysis
yloses_incremental_state
--android_sdk=<a build target label>
predeterminado: "@bazel_tools//tools/android:sdk"-
Especifica el SDK o la plataforma de Android que se usa para compilar aplicaciones para Android.
Etiquetas:changes_inputs
,loading_and_analysis
yloses_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
ychanges_inputs
- Valor predeterminado de
--cc_output_directory_tag=<a string>
: "" -
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas:affects_outputs
- Valor predeterminado de
--compiler=<a string>
: ver descripción -
El compilador de C++ que se usará para compilar el destino.
Etiquetas:loading_and_analysis
yexecution
--coverage_output_generator=<a build target label>
predeterminado: "@bazel_tools//tools/test:lcov_merger"-
Ubicación del objeto binario que se usa para procesar posteriormente los informes de cobertura sin procesar. Actualmente, debe ser un grupo de archivos que contenga un solo archivo: el objeto binario. La configuración predeterminada es “//tools/test:lcov_merger”.
Etiquetas:changes_inputs
,affects_outputs
yloading_and_analysis
--coverage_report_generator=<a build target label>
predeterminado: “@bazel_tools//tools/test:coverage_report_generator”-
Ubicación del objeto binario que se usa para generar informes de cobertura. Actualmente, debe ser un grupo de archivos que contenga un solo archivo: el objeto binario. La configuración predeterminada es “//tools/test:coverage_report_generator”.
Etiquetas:changes_inputs
,affects_outputs
yloading_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
yloading_and_analysis
--crosstool_top=<a build target label>
predeterminado: “@bazel_tools//tools/cpp:toolchain”-
La etiqueta del paquete de herramientas cruzadas que se usará para compilar el código de C++.
Etiquetas:loading_and_analysis
,changes_inputs
yaffects_outputs
- Valor predeterminado de
--custom_malloc=<a build target label>
: ver descripción -
Especifica una implementación de malloc personalizada. Esta configuración anula los atributos malloc en las reglas de compilación.
Etiquetas:changes_inputs
yaffects_outputs
- Se acumulan
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
usos múltiples -
Lista de expresiones regulares separadas por comas, cada una con el prefijo - (expresión negativa) opcionalmente, asignadas (=) a una lista de objetivos de valores de restricción separados por comas. Si un objetivo no coincide con ninguna expresión negativa y al menos una expresión positiva, la resolución de la cadena de herramientas se realizará como si se hubieran declarado los valores de la restricción como restricciones de ejecución. Ejemplo: //demo,-test=@platforms//cpus:x86_64 agregará 'x86_64' a cualquier destino en //demo, excepto a aquellos cuyo nombre contenga “test”.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]experimental_include_xcode_execution_requirements
: "falso" -
Si está configurado, agrega un campo "requires-xcode:{version}". de ejecución requerido a cada acción de Xcode. Si la versión de Xcode tiene una etiqueta con guiones, agrega también la etiqueta “requires-xcode-label:{version_label}”. de ejecución.
Etiquetas:loses_incremental_state
,loading_and_analysis
yexecution
- Valor predeterminado de
--[no]experimental_prefer_mutual_xcode
: "true" -
Si es verdadero, usa el Xcode más reciente que está disponible de forma local y remota. Si es falso, o si no hay versiones mutuas disponibles, usa la versión de Xcode local seleccionada a través de xcode-select.
Etiquetas:loses_incremental_state
- Valor predeterminado de
--extra_execution_platforms=<comma-separated list of options>
: "" -
Son las plataformas que están disponibles como plataformas de ejecución para ejecutar acciones. Las plataformas se pueden especificar por objetivo exacto o como un patrón de objetivo. Estas plataformas se considerarán antes de las declaradas en el archivo WORKSPACE por register_execution_platforms(). Esta opción solo se puede configurar una vez. las instancias posteriores anularán la configuración de las marcas anteriores.
Etiquetas:execution
- Se acumulan
--extra_toolchains=<comma-separated list of options>
usos múltiples -
Las reglas de la cadena de herramientas que se deben considerar durante su resolución. Las cadenas de herramientas se pueden especificar por objetivo exacto o como un patrón de objetivo. Estas cadenas de herramientas se considerarán antes de las declaradas en el archivo WORKSPACE por register_toolchains().
Etiquetas:affects_outputs
,changes_inputs
yloading_and_analysis
- Valor predeterminado de
--grte_top=<a label>
: ver descripción -
Es una etiqueta para una biblioteca de libc abierta. La cadena de herramientas de crosstool selecciona el valor predeterminado, y casi nunca necesitas anularlo.
Etiquetas:action_command_lines
yaffects_outputs
- Valor predeterminado de
--host_compiler=<a string>
: ver descripción -
El compilador de C++ que se usará para la compilación del host. Se ignora si no se configura --host_crosstool_top.
Etiquetas:loading_and_analysis
yexecution
- Valor predeterminado de
--host_crosstool_top=<a build target label>
: ver descripción -
De forma predeterminada, las opciones --crosstool_top y --compiler también se usan para la configuración de ejecución. Si se proporciona este indicador, Bazel usa el compilador y la libc predeterminados para el crosstool_top específico.
Etiquetas:loading_and_analysis
,changes_inputs
yaffects_outputs
- Valor predeterminado de
--host_grte_top=<a label>
: ver descripción -
Si se especifica, esta configuración anula el directorio de nivel superior de libc (--grte_top) para la configuración de exec.
Etiquetas:action_command_lines
yaffects_outputs
--host_platform=<a build target label>
predeterminado: “@local_config_platform//:host”-
Es la etiqueta de una regla de la plataforma que describe el sistema host.
Etiquetas:affects_outputs
,changes_inputs
yloading_and_analysis
- Valor predeterminado de
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
: "true" -
Si es verdadero, Bazel no habilitará “host”. y “no host” de la cadena de herramientas de c++ (consulta https://github.com/bazelbuild/bazel/issues/7407 para obtener más información).
Etiquetas:loading_and_analysis
yincompatible_change
- Valor predeterminado de
--[no]incompatible_enable_android_toolchain_resolution
: "true" -
Usa la resolución de la cadena de herramientas para seleccionar el SDK de Android para las reglas de Android (Starlark y nativo)
Etiquetas:loading_and_analysis
yincompatible_change
- Valor predeterminado de
--[no]incompatible_enable_apple_toolchain_resolution
: "falso" -
Usa la resolución de la cadena de herramientas para seleccionar el SDK de Apple para las reglas de Apple (Starlark y nativo)
Etiquetas:loading_and_analysis
yincompatible_change
- Valor predeterminado de
--[no]incompatible_make_thinlto_command_lines_standalone
: "true" -
Si es verdadero, Bazel no reutilizará las líneas de comandos de acción de vínculo de C++ para las líneas de comandos de indexación lto (consulta https://github.com/bazelbuild/bazel/issues/6791 para obtener más información).
Etiquetas:loading_and_analysis
yincompatible_change
- Valor predeterminado de
--[no]incompatible_remove_legacy_whole_archive
: "true" -
Si es verdadero, Bazel no vinculará las dependencias de bibliotecas como archivos completos de forma predeterminada (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener instrucciones de migración).
Etiquetas:loading_and_analysis
yincompatible_change
- Valor predeterminado de
--[no]incompatible_require_ctx_in_configure_features
: "true" -
Si el valor es verdadero, Bazel requerirá "{4/}". en cc_common.configure_features (consulta https://github.com/bazelbuild/bazel/issues/7793 para obtener más información).
Etiquetas:loading_and_analysis
yincompatible_change
-
Usa objetos compartidos de la interfaz si la cadena de herramientas lo admite. Actualmente, todas las cadenas de herramientas ELF admiten esta configuración.
Etiquetas:loading_and_analysis
,affects_outputs
yaffects_outputs
- Valor predeterminado de
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Especifica la versión del SDK de iOS que se usará para compilar aplicaciones de iOS. Si no se especifica, usa la versión predeterminada del SDK de iOS de “xcode_version”.
Etiquetas:loses_incremental_state
- Valor predeterminado de
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Especifica la versión del SDK de macOS que se usará para compilar aplicaciones de macOS. Si no se especifica, se usa la versión predeterminada del SDK de macOS de “xcode_version”.
Etiquetas:loses_incremental_state
- Valor predeterminado de
--minimum_os_version=<a string>
: ver descripción -
La versión mínima del SO a la que se orienta tu compilación.
Etiquetas:loading_and_analysis
yaffects_outputs
- Valor predeterminado de
--platform_mappings=<a relative path>
: "" -
La ubicación de un archivo de asignación que describe qué plataforma usar si no hay ninguna establecida o qué marcas se deben configurar cuando ya existe una plataforma. Debe estar relacionada con la raíz principal del lugar de trabajo. La configuración predeterminada es “platform_mappings”. (un archivo directamente debajo de la raíz del espacio de trabajo).
Etiquetas:affects_outputs
,changes_inputs
yloading_and_analysis
- Valor predeterminado de
--platforms=<a build target label>
: "" -
Las etiquetas de las reglas de la plataforma que describen las plataformas de destino para el comando actual.
Etiquetas:affects_outputs
,changes_inputs
yloading_and_analysis
- Valor predeterminado de
--python2_path=<a string>
: ver descripción -
Obsoleto, no-op. Inhabilitado por `--incompatible_use_python_toolchains`.
Etiquetas:no_op
ydeprecated
- Valor predeterminado de
--python3_path=<a string>
: ver descripción -
Obsoleto, no-op. Inhabilitado por `--incompatible_use_python_toolchains`.
Etiquetas:no_op
ydeprecated
- Valor predeterminado de
--python_path=<a string>
: ver descripción -
La ruta de acceso absoluta del intérprete de Python invocado para ejecutar objetivos de Python en la plataforma de destino. Obsoleto; inhabilitado por --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
yaffects_outputs
- Valor predeterminado de
--python_top=<a build target label>
: ver descripción -
Es la etiqueta de un py_runtime que representa el intérprete de Python invocado para ejecutar objetivos de Python en la plataforma de destino. Obsoleto; inhabilitado por --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
yaffects_outputs
- Valor predeterminado de
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Especifica la versión del SDK de tvOS que se usará para compilar aplicaciones de tvOS. Si no se especifica, usa la versión predeterminada del SDK de tvOS de "xcode_version".
Etiquetas:loses_incremental_state
- Valor predeterminado de
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Especifica la versión del SDK de watchOS que se usará para compilar aplicaciones de watchOS. Si no se especifica, se usa la versión predeterminada del SDK de watchOS de “xcode_version”.
Etiquetas:loses_incremental_state
- Valor predeterminado de
--xcode_version=<a string>
: ver descripción -
Si se especifica, usa Xcode de la versión determinada para las acciones de compilación relevantes. Si no se especifica, usa la versión predeterminada del ejecutor de Xcode.
Etiquetas:loses_incremental_state
--xcode_version_config=<a build target label>
predeterminado: “@bazel_tools//tools/cpp:host_xcodes”-
La etiqueta de la regla xcode_config que se usará para seleccionar la versión de Xcode en la configuración de compilación.
Etiquetas:loses_incremental_state
yloading_and_analysis
- Opciones que controlan el resultado del comando:
- Valor predeterminado de
--[no]apple_generate_dsym
: "falso" -
Indica si se deben generar archivos de símbolos de depuración (.dSYM).
Etiquetas:affects_outputs
yaction_command_lines
- Valor predeterminado de
--[no]build
: "true" -
Ejecuta la compilación. este es el comportamiento habitual. La especificación de --nobuild hace que la compilación se detenga antes de ejecutar las acciones de compilación y muestra cero si las fases de carga del paquete y análisis se completaron correctamente. este modo es útil para probar esas fases.
Etiquetas:execution
yaffects_outputs
- Valor predeterminado de
--[no]build_runfile_links
: "true" -
Si es verdadero, compila bosques de symlink de archivos de ejecución para todos los destinos. Si es falso, escríbelos solo cuando lo requiera una acción local, prueba o comando de ejecución.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]build_runfile_manifests
: "true" -
Si es verdadero, escribe manifiestos de archivos de ejecución para todos los destinos. Si es falsa, omítelas. Las pruebas locales no se ejecutarán si el valor es falso.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]build_test_dwp
: "falso" -
Si se habilita, al compilar pruebas de C++ de forma estática y con fisión, también se compilará automáticamente el archivo .dwp para el objeto binario de prueba.
Etiquetas:loading_and_analysis
yaffects_outputs
--cc_proto_library_header_suffixes=<comma-separated set of options>
predeterminado: ".pb.h"-
Establece los sufijos de los archivos de encabezado que crea cc_proto_library.
Etiquetas:affects_outputs
yloading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated set of options>
predeterminado: ".pb.cc"-
Establece los sufijos de los archivos de origen que crea cc_proto_library.
Etiquetas:affects_outputs
yloading_and_analysis
- Valor predeterminado de
--[no]experimental_proto_descriptor_sets_include_source_info
: "falso" -
Ejecuta acciones adicionales para versiones alternativas de la API de Java en una proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
yexperimental
- Valor predeterminado de
--[no]experimental_proto_extra_actions
: "falso" -
Ejecuta acciones adicionales para versiones alternativas de la API de Java en una proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
yexperimental
- Valor predeterminado de
--[no]experimental_save_feature_state
: "falso" -
Guarda el estado de las funciones habilitadas y solicitadas como resultado de la compilación.
Etiquetas:affects_outputs
yexperimental
- Valor predeterminado de
--[no]experimental_use_validation_aspect
: "falso" -
Establece si se deben ejecutar acciones de validación con aspecto (para el paralelismo con pruebas).
Etiquetas:execution
yaffects_outputs
--fission=<a set of compilation modes>
predeterminado: "no"-
Especifica qué modos de compilación usan la fisión para compilaciones y vínculos de C++. Puede ser cualquier combinación de {'fastbuild', 'dbg', 'opt'} o los valores especiales 'sí' para habilitar todos los modos y hacer clic en "no". para inhabilitar todos los modos.
Etiquetas:loading_and_analysis
,action_command_lines
yaffects_outputs
- Valor predeterminado de
--[no]incompatible_always_include_files_in_data
: "true" -
Si esta preferencia se establece como "true", las reglas nativas agregarán <code>DefaultInfo.files</code>. de las dependencias de datos a sus runfiles, lo que coincide con el comportamiento recomendado para las reglas de Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid).
Etiquetas:affects_outputs
yincompatible_change
- Valor predeterminado de
--[no]legacy_external_runfiles
: "true" -
Si es verdadero, compila bosques de symlink de archivos de ejecución para repositorios externos en .runfiles/wsname/external/repo (además de .runfiles/repo).
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]objc_generate_linkmap
: "falso" -
Especifica si se debe generar un archivo de mapa de vínculos.
Etiquetas:affects_outputs
- Se acumulan
--output_groups=<comma-separated list of options>
usos múltiples -
Una lista de nombres de grupos de salida separados por comas, cada uno de los cuales, de manera opcional, con el prefijo + o -. Se agrega un grupo con el prefijo + al conjunto predeterminado de grupos de salida, mientras que un grupo con el prefijo - se quita del conjunto predeterminado. Si al menos un grupo no tiene prefijo, se omite el conjunto predeterminado de grupos de salida. Por ejemplo, --output_groups=+foo,+bar crea la unión del conjunto predeterminado, foo y bar, mientras que --output_groups=foo,bar anula el conjunto predeterminado de modo que solo se compilan foo y bar.
Etiquetas:execution
yaffects_outputs
- Valor predeterminado de
--[no]run_validations
: "true" -
Establece si se deben ejecutar acciones de validación como parte de la compilación. Consulta https://bazel.build/extending/rules#validation_actions
Etiquetas:execution
yaffects_outputs
- Valor predeterminado de
--[no]save_temps
: "falso" -
Si lo estableces, se guardarán los resultados temporales de GCC. Entre estos, se incluyen archivos .s (código ensamblador), .i (C++ previamente procesado) y .ii (C++ previamente procesados).
Etiquetas:affects_outputs
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
- Se acumulan
--action_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica el conjunto de variables de entorno disponibles para las acciones con configuración de destino. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o por el par nombre=valor que establece el valor de forma independiente del entorno de invocación. Esta opción se puede usar varias veces. en el caso de opciones proporcionadas para la misma variable, se acumulan las últimas victorias y se acumulan opciones para diferentes variables.
Etiquetas:action_command_lines
--android_cpu=<a string>
predeterminado: "armeabi-v7a"-
La CPU de destino de Android
Etiquetas:affects_outputs
,loading_and_analysis
yloses_incremental_state
- Valor predeterminado de
--[no]android_databinding_use_androidx
: "true" -
Genera archivos de vinculación de datos compatibles con AndroidX. Esto solo se usa con la vinculación de datos v2. Esta marca es una no-op.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
yexperimental
- Valor predeterminado de
--[no]android_databinding_use_v3_4_args
: "true" -
Usa android databinding v2 con el argumento 3.4.0. Esta marca es una no-op.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
yexperimental
- Configuración predeterminada de
--android_dynamic_mode=<off, default or fully>
: "desactivada" -
Determina si las dependencias de C++ de reglas de Android se vincularán dinámicamente cuando un objeto cc_binary no cree explícitamente una biblioteca compartida. 'predeterminado' significa que Bazel elegirá si realizar la vinculación de forma dinámica. "completamente" significa que todas las bibliotecas se vincularán de forma dinámica. "desactivado" significa que todas las bibliotecas se vincularán
en su mayoría en modo estático.
Etiquetas:affects_outputs
yloading_and_analysis
- Valor predeterminado de
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
: "alfabético" -
Establece el orden de los manifiestos que se pasan a la combinación de manifiestos para los objetos binarios de Android. ALFABÉTICO significa que los manifiestos se ordenan por ruta de acceso relativa a execroot. ALPHABETICAL_BY_CONFIGURATION significa que los manifiestos se ordenan por rutas de acceso relacionadas con el directorio de configuración dentro del directorio de salida. DEPENDENCY significa que los manifiestos se ordenan; el de cada biblioteca antecede a los de sus dependencias.
Etiquetas:action_command_lines
yexecution
- Valor predeterminado de
--[no]android_resource_shrinking
: "falso" -
Habilita la reducción de recursos para los APK android_binary que usan ProGuard.
Etiquetas:affects_outputs
yloading_and_analysis
- Se acumulan
--aspects=<comma-separated list of options>
usos múltiples - Lista separada por comas de los aspectos que se aplicarán a las orientaciones de nivel superior. En la lista, si el aspecto some_aspect especifica los proveedores de aspectos requeridos a través de required_aspect_providers, some_aspect se ejecutará después de cada aspecto que se mencionó antes en la lista de aspectos cuyos proveedores promocionados satisfacen algunos proveedores de aspectos obligatorios de algunos_aspect. Además, some_aspect se ejecutará después de todos los aspectos obligatorios especificados por el atributo exige. some_aspect tendrá acceso a los valores de esos aspectos proveedores. <bzl-file-label>%<aspect_name>, por ejemplo “//tools:my_def.bzl%my_aspect”, donde “my_aspect” es un valor de nivel superior de un archivo tools/my_def.bzl
--[no]build_python_zip
predeterminado: "automático"-
Compila el archivo ZIP ejecutable de Python; Activado en Windows y desactivado en otras plataformas
Etiquetas:affects_outputs
- Se acumulan
--catalyst_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se compilarán objetos binarios de Apple Catalyst.
Etiquetas:loses_incremental_state
yloading_and_analysis
- Valor predeterminado de
--[no]collect_code_coverage
: "falso" -
Si se especifica, Bazel instrumentará el código (usando instrumentación sin conexión cuando sea posible) y recopilará información de cobertura durante las pruebas. Solo se verán afectadas las orientaciones que coincidan con --instrumentation_filter. Por lo general, esta opción no debe especificarse directamente: "cobertura de Bazel". en su lugar.
Etiquetas:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] predeterminado: "fastbuild"-
Especifica el modo en que se compilará el objeto binario. Valores: “fastbuild”, “dbg”, “opt”.
Etiquetas:affects_outputs
yaction_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
yaffects_outputs
- Se acumulan
--copt=<a string>
usos múltiples -
Opciones adicionales para pasar a gcc.
Etiquetas:action_command_lines
yaffects_outputs
- Valor predeterminado de
--cpu=<a string>
: "" -
La CPU de destino.
Etiquetas:changes_inputs
yaffects_outputs
- Valor predeterminado de
--cs_fdo_absolute_path=<a string>
: ver descripción -
Usa la información de perfil de CSFDO para optimizar la compilación. Especifica el nombre de la ruta de acceso absoluta del archivo ZIP que contiene el archivo de perfil, un archivo de perfil de LLVM indexado o sin procesar.
Etiquetas:affects_outputs
- Valor predeterminado de
--cs_fdo_instrument=<a string>
: ver descripción -
Genera objetos binarios con instrumentación FDO sensible al contexto. Con el compilador Clang/LLVM, también acepta el nombre del directorio bajo el cual se volcarán los archivos de perfil sin procesar en el tiempo de ejecución.
Etiquetas:affects_outputs
- Valor predeterminado de
--cs_fdo_profile=<a build target label>
: ver descripción -
El cs_fdo_profile que representa el perfil sensible al contexto que se usará para la optimización.
Etiquetas:affects_outputs
- Se acumulan
--cxxopt=<a string>
usos múltiples -
Es una opción adicional para pasar a gcc cuando se compilan archivos de origen C++.
Etiquetas:action_command_lines
yaffects_outputs
- Se acumulan
--define=<a 'name=value' assignment>
usos múltiples -
Cada opción --define especifica una asignación para una variable de compilación.
Etiquetas:changes_inputs
yaffects_outputs
- Valor predeterminado de
--dynamic_mode=<off, default or fully>
: “predeterminado” -
Determina si se vincularán dinámicamente los objetos binarios de C++. 'predeterminado' significa que Bazel elegirá si realizar la vinculación de forma dinámica. "completamente" significa que todas las bibliotecas se vincularán de forma dinámica. "desactivado" significa que todas las bibliotecas se vincularán
en su mayoría en modo estático.
Etiquetas:loading_and_analysis
yaffects_outputs
- Valor predeterminado de
--[no]enable_fdo_profile_absolute_path
: "true" -
Si se configura, el uso de fdo_logical_profile_path generará un error.
Etiquetas:affects_outputs
--[no]enable_runfiles
predeterminado: "automático"-
Habilitar el árbol de symlink de archivos de ejecución De forma predeterminada, la función está desactivada en Windows y activada en otras plataformas.
Etiquetas:affects_outputs
- Se acumulan
--experimental_action_listener=<a build target label>
usos múltiples -
Obsoleto para dar lugar a aspectos. Usa action_listener para adjuntar una extra_action a las acciones de compilación existentes.
Etiquetas:execution
yexperimental
- Valor predeterminado de
--[no]experimental_android_compress_java_resources
: "falso" -
Comprime recursos de Java en los APK
Etiquetas:affects_outputs
,loading_and_analysis
yexperimental
- Valor predeterminado de
--[no]experimental_android_databinding_v2
: "true" -
Usa Android Databinding v2. Esta marca es una no-op.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
yexperimental
- Valor predeterminado de
--[no]experimental_android_resource_shrinking
: "falso" -
Habilita la reducción de recursos para los APK android_binary que usan ProGuard.
Etiquetas:affects_outputs
yloading_and_analysis
- Valor predeterminado de
--[no]experimental_android_rewrite_dexes_with_rex
: "falso" -
usar la herramienta rex para reescribir archivos dex
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
yexperimental
- Valor predeterminado de
--[no]experimental_collect_code_coverage_for_generated_files
: "falso" -
Si se especifica, Bazel también recopilará información de cobertura para los archivos generados.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]experimental_convenience_symlinks
: “normal” -
Esta marca controla cómo se administrarán los symlinks convenientes (los que aparecen en el lugar de trabajo después de la compilación). Valores posibles:
normal (predeterminado): Se creará o borrará cada tipo de symlink de conveniencia, según lo determine la compilación.
limpio: Todos los symlinks se borrarán incondicionalmente.
Ignorar: Los vínculos simbólicos se dejarán solos.
log_only: Generar mensajes de registro como si fuera “normal” se pasaron, pero en realidad no realizan ninguna operación del sistema de archivos (útil para las herramientas).
Ten en cuenta que solo pueden verse afectados los symlinks cuyos nombres son generados por el valor actual de --symlink_prefix. Si el prefijo cambia, los symlinks preexistentes quedarán solos.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]experimental_convenience_symlinks_bep_event
: "falso" -
Esta marca controla si se publicará o no el evento de compilaciónConvenienceSymlinksIdentified en BuildEventProtocol. Si el valor es verdadero, BuildEventProtocol tendrá una entrada para beneficenciaSymlinksIdentified, que enumerará todos los symlinks convenientes creados en su lugar de trabajo. Si es falso, la entrada minimercadoSymlinksIdentified en BuildEventProtocol estará vacía.
Etiquetas:affects_outputs
--experimental_objc_fastbuild_options=<comma-separated list of options>
predeterminado: "-O0,-DDEBUG=1"-
Usa estas cadenas como opciones del compilador objc fastbuild.
Etiquetas:action_command_lines
- Valor predeterminado de
--[no]experimental_omitfp
: "falso" -
Si es verdadero, usa libunwind para desenrollar la pila y compila con -fomit-frame-pointer y -faasync-unwind-tables.
Etiquetas:action_command_lines
,affects_outputs
yexperimental
- Configuración predeterminada de
--experimental_output_paths=<off, content or strip>
: "desactivada" -
Qué modelo usar para dónde en las reglas del árbol de salida se escriben sus resultados, en particular para compilaciones multiplataforma o con varias configuraciones. Esto es altamente experimental. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/6526. Las acciones de Starlark pueden habilitar la asignación de rutas agregando la tecla “supports-path-mapping”. a los requisitos de ejecución dict.
Etiquetas:loses_incremental_state
,bazel_internal_configuration
,affects_outputs
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 es el nombre corto deseado para usar en la ruta de salida. Solo se utiliza cuando --experimental_platform_in_output_dir es verdadero. Tiene la prioridad de nomenclatura más alta.
Etiquetas:affects_outputs
yexperimental
- Valor predeterminado de
--[no]experimental_platform_in_output_dir
: "falso" -
Si es verdadero, se usa un nombre corto para la plataforma de destino en el nombre del directorio de salida en lugar de la CPU. El esquema exacto es experimental y está sujeto a cambios. En primer lugar, en el caso poco probable de que la opción --platforms no tenga exactamente un valor, se utiliza un hash de la opción de plataformas. A continuación, si --experimental_override_name_platform_in_output_dir registró algún nombre corto para la plataforma actual, se utilizará ese nombre corto. Luego, si se configuró --experimental_use_platforms_in_output_dir_legacy_heuristic, use un nombre corto basado en la etiqueta de la plataforma actual. Por último, se usa un hash de la opción de plataforma como último recurso.
Etiquetas:affects_outputs
yexperimental
- Valor predeterminado de
--[no]experimental_use_llvm_covmap
: "falso" -
Si se especifica, Bazel generará información del mapa de cobertura llvm-cov en lugar de gcov cuando collect_code_coverage esté habilitado.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
yexperimental
- Valor predeterminado de
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic
: "true" -
Solo usa esta marca como parte de una estrategia de prueba o migración sugerida. Ten en cuenta que la heurística presenta deficiencias conocidas y se sugiere migrar a solo --experimental_override_name_platform_in_output_dir.
Etiquetas:affects_outputs
yexperimental
--fat_apk_cpu=<comma-separated set of options>
predeterminado: "armeabi-v7a"-
Configurar esta opción habilita los APK multiarquitectura, que contienen objetos binarios nativos para todas las arquitecturas de destino especificadas, p.ej., --fat_apk_cpu=x86,armeabi-v7a. Si se especifica esta marca, se ignora --android_cpu para las dependencias de las reglas android_binary.
Etiquetas:affects_outputs
,loading_and_analysis
yloses_incremental_state
- Valor predeterminado de
--[no]fat_apk_hwasan
: "falso" -
Establece si se deben crear divisiones de HWASAN.
Etiquetas:affects_outputs
,loading_and_analysis
yloses_incremental_state
- Valor predeterminado de
--fdo_instrument=<a string>
: ver descripción -
Generar objetos binarios con instrumentación FDO Con el compilador Clang/LLVM, también acepta el nombre del directorio bajo el cual se volcarán los archivos de perfil sin procesar en el tiempo de ejecución.
Etiquetas:affects_outputs
- Valor predeterminado de
--fdo_optimize=<a string>
: ver descripción -
Usa la información del perfil FDO para optimizar la compilación. Especifica el nombre de un archivo ZIP que contenga un árbol de archivos .gcda, un archivo afdo que contenga un perfil automático o un archivo de perfil LLVM. Esta marca también acepta archivos especificados como etiquetas (p.ej., `//foo/bar:file.afdo`; es posible que debas agregar una directiva `exports_files` al paquete correspondiente) y etiquetas que apunten a destinos de `fdo_profile`. Esta marca se reemplazará por la regla `fdo_profile`.
Etiquetas:affects_outputs
- Valor predeterminado de
--fdo_prefetch_hints=<a build target label>
: ver descripción -
Usa sugerencias de carga previa de caché.
Etiquetas:affects_outputs
- Valor predeterminado de
--fdo_profile=<a build target label>
: ver descripción -
El fdo_profile que representa el perfil que se utilizará para la optimización.
Etiquetas:affects_outputs
- Se acumulan
--features=<a string>
usos múltiples -
Las funciones determinadas estarán habilitadas o inhabilitadas de forma predeterminada para los destinos integrados en la configuración de destino. Especificando -<feature> la inhabilitará. Los atributos negativos siempre anulan los positivos. Consulta también --host_features
Etiquetas:changes_inputs
yaffects_outputs
- Valor predeterminado de
--[no]force_pic
: "falso" -
Si se habilitan, todas las compilaciones de C++ producen código independiente de la posición ("-fPIC"), los vínculos prefieren bibliotecas PIC compiladas previamente en lugar de bibliotecas que no son PIC y producen ejecutables independientes de la posición ("-pie").
Etiquetas:loading_and_analysis
yaffects_outputs
- Se acumulan
--host_action_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica el conjunto de variables de entorno disponibles para acciones con configuraciones de ejecución. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o por el par nombre=valor que establece el valor de forma independiente del entorno de invocación. Esta opción se puede usar varias veces. en el caso de opciones proporcionadas para la misma variable, se acumulan las últimas victorias y se acumulan opciones para diferentes variables.
Etiquetas:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
predeterminado: "opt"-
Especifica el modo en que se integrarán las herramientas usadas durante la compilación. Valores: “fastbuild”, “dbg”, “opt”.
Etiquetas:affects_outputs
yaction_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
yaffects_outputs
- Se acumulan
--host_copt=<a string>
usos múltiples -
Opciones adicionales para pasar al compilador C para herramientas integradas en las configuraciones de ejecución.
Etiquetas:action_command_lines
yaffects_outputs
- Valor predeterminado de
--host_cpu=<a string>
: "" -
La CPU host
Etiquetas:changes_inputs
yaffects_outputs
- Se acumulan
--host_cxxopt=<a string>
usos múltiples -
Opciones adicionales para pasar al compilador C++ en el caso de las herramientas integradas en las configuraciones de ejecución.
Etiquetas:action_command_lines
yaffects_outputs
- Se acumulan
--host_features=<a string>
usos múltiples -
Las funciones determinadas estarán habilitadas o inhabilitadas de forma predeterminada para los destinos compilados en la configuración de ejecución. Especificando -<feature> la inhabilitará. Los atributos negativos siempre anulan los positivos.
Etiquetas:changes_inputs
yaffects_outputs
- Valor predeterminado de
--host_force_python=<PY2 or PY3>
: ver descripción -
Anula la versión de Python para la configuración de ejecución. Puede ser "PY2". o “PY3”.
Etiquetas:loading_and_analysis
yaffects_outputs
- Se acumulan
--host_linkopt=<a string>
usos múltiples -
Es una opción adicional para pasar al vinculador cuando se vinculan herramientas en las configuraciones de ejecución.
Etiquetas:action_command_lines
yaffects_outputs
- Valor predeterminado de
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima de macOS compatible para los destinos de host. Si no se especifica, usa "macos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
usos múltiples -
Opciones adicionales para pasar de forma selectiva al compilador C/C++ cuando compilas ciertos archivos en las configuraciones de ejecución. Esta opción se puede aprobar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter significa una lista de patrones de inclusión y exclusión de expresiones regulares (consulta también --instrumentation_filter). opción_1 a option_n significa opciones arbitrarias de la línea de comandos. Si una opción contiene una coma, se debe colocar entre una barra inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos gcc de todos los archivos cc en //foo/, excepto bar.cc.
Etiquetas:action_command_lines
yaffects_outputs
- Se acumulan
--host_swiftcopt=<a string>
usos múltiples -
Opciones adicionales para pasar a swiftc para herramientas de ejecución.
Etiquetas:action_command_lines
yaffects_outputs
- Valor predeterminado de
--[no]incompatible_auto_exec_groups
: "falso" -
Cuando se habilita, se crea automáticamente un grupo de ejecución para cada cadena de herramientas que usa una regla. Para que esta regla funcione, se debe especificar el parámetro `toolchain` en sus acciones. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/17134.
Etiquetas:affects_outputs
yincompatible_change
- Valor predeterminado de
--[no]incompatible_merge_genfiles_directory
: "true" -
Si es verdadero, el directorio genfiles se pliega en el directorio bin.
Etiquetas:affects_outputs
yincompatible_change
- Valor predeterminado de
--[no]incompatible_use_host_features
: "true" -
Si es verdadero, usa --features solo para la configuración de destino y --host_features para la configuración de ejecución.
Etiquetas:changes_inputs
,affects_outputs
yincompatible_change
- Valor predeterminado de
--[no]instrument_test_targets
: "falso" -
Cuando la cobertura está habilitada, especifica si se deben considerar reglas de prueba. Cuando se establecen, se instrumentan las reglas de prueba incluidas por --instrumentation_filter. De lo contrario, las reglas de prueba siempre se excluyen de la instrumentación de cobertura.
Etiquetas:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
predeterminado: "-/javatests[/:],-/test/java[/:]"-
Cuando se habilite la cobertura, solo se instrumentarán las reglas con nombres incluidos por el filtro basado en regex especificado. Reglas con el prefijo “-” en su lugar. Ten en cuenta que solo se instrumentan las reglas que no son de prueba, a menos que se habilite --instrument_test_targets.
Etiquetas:affects_outputs
- Valor predeterminado de
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión de iOS mínima compatible para simuladores y dispositivos de destino. Si no se especifica, usa "ios_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan
--ios_multi_cpus=<comma-separated list of options>
usos múltiples -
Lista separada por comas de arquitecturas con las que se compilará una aplicación ios_application. El resultado es un objeto binario universal que contiene todas las arquitecturas especificadas.
Etiquetas:loses_incremental_state
yloading_and_analysis
- Valor predeterminado de
--[no]legacy_whole_archive
: "true" -
Obsoleto y sustituido por --incompatible_remove_legacy_whole_archive (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener más información). Cuando esta opción esté activada, usa --whole-archive para las reglas cc_binary que tengan linkshared=True y linkstatic=True o '-static'. en linkopts. Esto es solo para la retrocompatibilidad. Una mejor alternativa es usar Alwayslink=1 cuando sea necesario.
Etiquetas:action_command_lines
,affects_outputs
ydeprecated
- 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
yaffects_outputs
- Se acumulan
--ltobackendopt=<a string>
usos múltiples -
Es una opción adicional para pasar al paso del backend de LTO (en --features=thin_lto).
Etiquetas:action_command_lines
yaffects_outputs
- Se acumulan
--ltoindexopt=<a string>
usos múltiples -
Es una opción adicional para pasar al paso de indexación de LTO (en --features=thin_lto).
Etiquetas:action_command_lines
yaffects_outputs
- Se acumulan
--macos_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se compilarán objetos binarios de Apple macOS.
Etiquetas:loses_incremental_state
yloading_and_analysis
- Valor predeterminado de
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima de macOS compatible para destinos. Si no se especifica, usa "macos_sdk_version".
Etiquetas:loses_incremental_state
- Valor predeterminado de
--memprof_profile=<a build target label>
: ver descripción -
Usar perfil de memprof.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]objc_debug_with_GLIBCXX
: "falso" -
Si se establece y el modo de compilación está establecido en "dbg", define GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC y GLIBCPP_CONCEPT_CHECKS.
Etiquetas:action_command_lines
- Valor predeterminado de
--[no]objc_enable_binary_stripping
: "falso" -
Indica si se deben realizar eliminaciones de símbolos y de código no muerto en objetos binarios vinculados. Se realizarán eliminaciones de objetos binarios si se especifican esta marca y --compilation_mode=opt.
Etiquetas:action_command_lines
- Se acumulan
--objccopt=<a string>
usos múltiples -
Opciones adicionales para pasar a gcc cuando se compilan archivos de origen Objective-C/C++.
Etiquetas:action_command_lines
- Se acumulan
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
usos múltiples -
Opciones adicionales para pasar a gcc de forma selectiva cuando se compilan ciertos archivos. Esta opción se puede aprobar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter significa una lista de patrones de inclusión y exclusión de expresiones regulares (consulta también --instrumentation_filter). opción_1 a option_n significa opciones arbitrarias de la línea de comandos. Si una opción contiene una coma, se debe colocar entre una barra inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos gcc de todos los archivos cc en //foo/, excepto bar.cc.
Etiquetas:action_command_lines
yaffects_outputs
- Se acumulan
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
usos múltiples -
Opciones adicionales para pasar de forma selectiva al backend de LTO (en --features=thin_lto) cuando se compilan ciertos objetos de backend. Esta opción se puede aprobar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter significa una lista de patrones de incluir y excluir expresiones regulares. opción_1 a option_n significa opciones arbitrarias de la línea de comandos. Si una opción contiene una coma, se debe colocar entre una barra inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos del backend LTO de todos los archivos o en //foo/ excepto bar.o.
Etiquetas:action_command_lines
yaffects_outputs
- Valor predeterminado de
--platform_suffix=<a string>
: ver descripción -
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas:loses_incremental_state
,affects_outputs
yloading_and_analysis
- Valor predeterminado de
--propeller_optimize=<a build target label>
: ver descripción -
Usa la información del perfil de Propeller para optimizar el objetivo de la compilación.Un perfil de propeller debe constar de al menos uno de dos archivos, un perfil cc y un perfil ld. Esta marca acepta una etiqueta de compilación que debe hacer referencia a los archivos de entrada del perfil del propeler. Por ejemplo, el archivo COMPILAR que define la etiqueta, en a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)Es posible que se deba agregar una directiva export_files al paquete correspondiente para que estos archivos sean visibles para Bazel. La opción debe usarse como: --propeller_optimize=//a/b:propeller_profile
Etiquetas:action_command_lines
yaffects_outputs
- Valor predeterminado de
--propeller_optimize_absolute_cc_profile=<a string>
: ver descripción -
Nombre de la ruta de acceso absoluta del archivo cc_profile para compilaciones de Propeller Optimized.
Etiquetas:affects_outputs
- Valor predeterminado de
--propeller_optimize_absolute_ld_profile=<a string>
: ver descripción -
Nombre de la ruta de acceso absoluta del archivo ld_profile para compilaciones de Propeller Optimized.
Etiquetas:affects_outputs
- Valor predeterminado de
--run_under=<a prefix in front of command>
: ver descripción -
Prefijo para insertar antes de los ejecutables para la “prueba” y "ejecutar" con comandos de SQL sencillos. Si el valor es “foo -bar” y la línea de comandos de ejecución es “test_binary -baz”, la última línea de comandos es “foo -bar test_binary -baz”. También puede ser una etiqueta para un destino ejecutable. Estos son algunos ejemplos: 'valgrind', 'strace', 'strace -c', 'valgrind --quiet --num-callers=20', '//package:target', '//package:target --options'.
Etiquetas:action_command_lines
-
Si es verdadero, las bibliotecas nativas que contengan una funcionalidad idéntica se compartirán entre diferentes destinos
Etiquetas:loading_and_analysis
yaffects_outputs
- Valor predeterminado de
--[no]stamp
: "falso" -
Sella objetos binarios con la fecha, el nombre de usuario, el nombre de host, la información del espacio de trabajo, etcétera.
Etiquetas:affects_outputs
--strip=<always, sometimes or never>
predeterminado: “a veces”-
Especifica si se deben eliminar los objetos binarios y las bibliotecas compartidas (mediante "-Wl,--strip-debug"). El valor predeterminado de “A veces” significa quitar iff --compilation_mode=fastbuild.
Etiquetas:affects_outputs
- Se acumulan
--stripopt=<a string>
usos múltiples -
Opciones adicionales para pasar a la barra cuando se genera un archivo '<name>.stripped' binario.
Etiquetas:action_command_lines
yaffects_outputs
- Se acumulan
--swiftcopt=<a string>
usos múltiples -
Opciones adicionales para pasar a la compilación de Swift.
Etiquetas:action_command_lines
- Valor predeterminado de
--symlink_prefix=<a string>
: ver descripción -
El prefijo que se antepone a cualquiera de los symlinks convenientes que se crean después de una compilación. Si se omite, el valor predeterminado es el nombre de la herramienta de compilación seguido de un guion. Si “/” se pasa, no se crean symlinks ni se emite ninguna advertencia. Advertencia: la funcionalidad especial para "/" pronto quedarán obsoletas; usa --experimental_convenience_symlinks=ignore en su lugar.
Etiquetas:affects_outputs
- Se acumulan
--tvos_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se compilarán objetos binarios de tvOS de Apple.
Etiquetas:loses_incremental_state
yloading_and_analysis
- Valor predeterminado de
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima de tvOS compatible para dispositivos y simuladores de destino. Si no se especifica, usa "tvos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan
--visionos_cpus=<comma-separated list of options>
usos múltiples -
Lista separada por comas de arquitecturas para las que se compilarán objetos binarios de visionOS de Apple.
Etiquetas:loses_incremental_state
yloading_and_analysis
- Se acumulan
--watchos_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para compilar objetos binarios de watchOS de Apple.
Etiquetas:loses_incremental_state
yloading_and_analysis
- Valor predeterminado de
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima de watchOS compatible con simuladores y dispositivos de destino. Si no se especifica, usa “watchos_sdk_version”.
Etiquetas:loses_incremental_state
- Valor predeterminado de
--xbinary_fdo=<a build target label>
: ver descripción -
Usa la información de perfil de XbinaryFDO para optimizar la compilación. Especifica el nombre del perfil de multibinario predeterminado. Cuando la opción se usa junto con --fdo_instrument/--fdo_optimize/--fdo_profile, esas opciones siempre prevalecerán como si nunca se especificara xbinary_fdo.
Etiquetas:affects_outputs
- Opciones que afectan la precisión con la que Bazel aplica entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
- Valor predeterminado de
--auto_cpu_environment_group=<a build target label>
: "" -
Declara el grupo de entorno que se usará para asignar automáticamente los valores de la CPU a los valores de target_environment.
Etiquetas:changes_inputs
,loading_and_analysis
yexperimental
- Valor predeterminado de
--[no]check_licenses
: "falso" -
Verifica que las restricciones de licencias impuestas por los paquetes dependientes no entren en conflicto con los modos de distribución de los objetivos que se compilan. De forma predeterminada, las licencias no están marcadas.
Etiquetas:build_file_semantics
- Valor predeterminado de
--[no]check_visibility
: "true" -
Si se inhabilita, los errores de visibilidad en las dependencias objetivo descienden a advertencias.
Etiquetas:build_file_semantics
- Valor predeterminado de
--[no]desugar_for_android
: "true" -
Establece si se debe expandir el código de bytes de Java 8 antes de la conversión a DEX.
Etiquetas:affects_outputs
,loading_and_analysis
yloses_incremental_state
- Valor predeterminado de
--[no]desugar_java8_libs
: "falso" -
Especifica si se deben incluir bibliotecas de Java 8 compatibles en las apps para dispositivos heredados.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
yexperimental
- Valor predeterminado de
--[no]enforce_constraints
: "true" -
Verifica los entornos con los que cada destino es compatible y, luego, informa los errores si alguno de ellos tiene dependencias que no admiten los mismos entornos.
Etiquetas:build_file_semantics
- Valor predeterminado de
--[no]experimental_check_desugar_deps
: "true" -
Establece si se debe verificar la expansión de sintaxis correcta a nivel del objeto binario de Android.
Etiquetas:eagerness_to_exit
,loading_and_analysis
yexperimental
- Configuración predeterminada de
--experimental_import_deps_checking=<off, warning or error>
: "DESACTIVADA" -
Cuando se habilita, se verifica si las dependencias de aar_import están completas. Esta aplicación puede romper la compilación o generar advertencias.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--experimental_strict_java_deps=<off, warn, error, strict or default>
: “predeterminado” -
Si es verdadero, comprueba que un destino de Java declare de manera explícita todos los objetivos usados directamente como dependencias.
Etiquetas:build_file_semantics
yeagerness_to_exit
- Valor predeterminado de
--[no]incompatible_check_testonly_for_output_files
: "falso" -
Si se habilita, comprueba los objetivos de prerrequisito de solo prueba que son archivos de salida buscando solo la prueba de la regla que se genera. Esto coincide con la verificación de visibilidad.
Etiquetas:build_file_semantics
yincompatible_change
- Valor predeterminado de
--[no]incompatible_check_visibility_for_toolchains
: "falso" -
Si se habilita, la verificación de visibilidad también se aplica a las implementaciones de cadenas de herramientas.
Etiquetas:build_file_semantics
yincompatible_change
- Valor predeterminado de
--[no]incompatible_disable_native_android_rules
: "falso" -
Si se habilita esta opción, se inhabilitará el uso directo de las reglas nativas de Android. Usa las reglas de Starlark para Android que se encuentran en https://github.com/bazelbuild/rules_android
Etiquetas:eagerness_to_exit
yincompatible_change
- Valor predeterminado de
--[no]incompatible_disable_native_apple_binary_rule
: "falso" -
No-ops. Se guardan aquí para brindar retrocompatibilidad.
Etiquetas:eagerness_to_exit
yincompatible_change
- Valor predeterminado de
--[no]incompatible_python_disable_py2
: "true" -
Si es verdadero, usar la configuración de Python 2 generará un error. Esto incluye python_version=PY2, srcs_version=PY2 y srcs_version=PY2ONLY. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/15684.
Etiquetas:loading_and_analysis
yincompatible_change
- Valor predeterminado de
--[no]incompatible_validate_top_level_header_inclusions
: "true" -
Si es verdadero, Bazel también validará las inclusiones de encabezados de directorio de nivel superior (consulta https://github.com/bazelbuild/bazel/issues/10047 para obtener más información).
Etiquetas:loading_and_analysis
yincompatible_change
- Valor predeterminado de
--python_native_rules_allowlist=<a build target label>
: ver descripción -
Una lista de entidades permitidas (destino del grupo de productos) que se usará cuando se aplique --incompatible_python_Disallow_native_rules.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]strict_filesets
: "falso" -
Si se habilita esta opción, los conjuntos de archivos que cruzan los límites de paquetes se informan como errores.
Etiquetas:build_file_semantics
yeagerness_to_exit
- Valor predeterminado de
--strict_proto_deps=<off, warn, error, strict or default>
: "error" -
A menos que esté DESACTIVADA, comprueba que un destino proto_library declare de forma explícita todos los objetivos usados directamente como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
yincompatible_change
- Configuración predeterminada de
--strict_public_imports=<off, warn, error, strict or default>
: "desactivada" -
A menos que esté DESACTIVADA, comprueba que un objetivo proto_library declare de forma explícita todos los destinos usados en el campo "import public" como se exportó.
Etiquetas:build_file_semantics
,eagerness_to_exit
yincompatible_change
- Valor predeterminado de
--[no]strict_system_includes
: "falso" -
Si es verdadero, también se deben declarar los encabezados que se encuentran en el sistema incluyen rutas de acceso (-isystem).
Etiquetas:loading_and_analysis
yeagerness_to_exit
- Se acumulan
--target_environment=<a build target label>
usos múltiples -
Declara el entorno de destino de esta compilación. Debe ser una referencia de etiqueta a un "entorno" . Si se especifica, todos los objetivos de nivel superior deben ser compatibles con este entorno.
Etiquetas:changes_inputs
- Opciones que afectan los resultados de firma de una compilación:
--apk_signing_method=<v1, v2, v1_v2 or v4>
predeterminado: “v1_v2”-
Implementación para firmar APKs
Etiquetas:action_command_lines
,affects_outputs
yloading_and_analysis
- Valor predeterminado de
--[no]device_debug_entitlements
: "true" -
Si se configura y el modo de compilación no es "opt", las apps objc incluirán derechos de depuración cuando firmen.
Etiquetas:changes_inputs
- Valor predeterminado de
--ios_signing_cert_name=<a string>
: ver descripción -
Nombre del certificado que se usará para la firma de iOS. De lo contrario, se recurrirá al perfil de aprovisionamiento. Puede ser la preferencia de identidad del llavero del certificado o (subcadena) del nombre común del certificado, según la página del manual del símbolo de código (IDENTIDADES DE FIRMA).
Etiquetas:action_command_lines
- Esta opción afecta la semántica del lenguaje de Starlark o de la API de compilación a la que pueden acceder los archivos BUILD, los archivos .bzl o los archivos WORKSPACE:
- Valor predeterminado de
--[no]incompatible_config_setting_private_default_visibility
: "falso" -
Si incompatible_enforce_config_setting_visibility=false, es una noop. De lo contrario, si esta marca es falsa, cualquier config_setting sin un atributo de visibilidad explícito será //visibility:public. Si esta marca es verdadera, config_setting sigue la misma lógica de visibilidad que todas las demás reglas. Consulta https://github.com/bazelbuild/bazel/issues/12933.
Etiquetas:loading_and_analysis
yincompatible_change
- Valor predeterminado de
--[no]incompatible_disallow_legacy_py_provider
: "true" -
No-op; se quitará pronto.
Etiquetas:loading_and_analysis
yincompatible_change
- Valor predeterminado de
--[no]incompatible_disallow_sdk_frameworks_attributes
: "falso" -
Si esta preferencia se establece como verdadera, no permite los atributos sdk_frameworks y bad_sdk_frameworks en objc_library y objc_import.
Etiquetas:build_file_semantics
yincompatible_change
- Valor predeterminado de
--[no]incompatible_enforce_config_setting_visibility
: "true" -
Si es verdadero, aplica las restricciones de visibilidad config_setting. Si es falso, cada config_setting es visible para cada destino. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
yincompatible_change
- Valor predeterminado de
--[no]incompatible_objc_alwayslink_by_default
: "falso" -
Si es verdadero, establece como verdadero el valor predeterminado para los atributos Alwayslink en objc_library y objc_import.
Etiquetas:build_file_semantics
yincompatible_change
- Valor predeterminado de
--[no]incompatible_python_disallow_native_rules
: "falso" -
Si es verdadero, se produce un error cuando se usan las reglas py_* integradas. en su lugar, se deben usar las reglas rule_python. Consulta https://github.com/bazelbuild/bazel/issues/17773 para obtener más información y las instrucciones de migración.
Etiquetas:loading_and_analysis
yincompatible_change
- Opciones que determinan el comportamiento del entorno de pruebas o del ejecutor de pruebas:
- Valor predeterminado de
--[no]allow_analysis_failures
: "falso" -
Si es verdadero, una falla de análisis del destino de una regla da como resultado la propagación del destino de una instancia de AnalysisFailureInfo que contiene la descripción del error, en lugar de generar una falla de compilación.
Etiquetas:loading_and_analysis
yexperimental
- Valor predeterminado de
--analysis_testing_deps_limit=<an integer>
: "2000" -
Establece el número máximo de dependencias transitivas mediante un atributo de regla con una transición de configuración for_analysis_testing. Si superas este límite, se producirá un error de regla.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]break_build_on_parallel_dex2oat_failure
: "falso" -
Si las verdaderas fallas de acción de dex2oat harán que la compilación se rompa en lugar de ejecutar dex2oat durante el tiempo de ejecución de la prueba.
Etiquetas:loading_and_analysis
yexperimental
- Valor predeterminado de
--[no]check_tests_up_to_date
: "falso" -
No ejecutes pruebas, solo verifica que estén actualizadas. Si todos los resultados de las pruebas están actualizados, estas se completarán de forma correcta. Si es necesario compilar o ejecutar alguna prueba, se informa un error y la prueba falla. Esta opción implica un comportamiento --check_up_to_date.
Etiquetas:execution
- Se acumulan
--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 de recursos predeterminada para las pruebas. El formato esperado es <resource>=<value>. Si un solo número positivo se especifica como <valor> se anularán los recursos predeterminados para todos los tamaños de pruebas. Si se especifican 4 números separados por comas, se anulará la cantidad de recursos para los tamaños de prueba pequeños, medianos, grandes y enormes, 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 explícitos especificados en las etiquetas anulan los recursos de prueba predeterminados que especifica esta marca.
- Valor predeterminado de
--[no]experimental_android_use_parallel_dex2oat
: "falso" -
Usa dex2oat en paralelo para acelerar la ejecución de android_test.
Etiquetas:loading_and_analysis
,host_machine_resource_optimizations
yexperimental
- Se acumulan
--flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once>
usos múltiples -
Cada prueba se volverá a intentar hasta la cantidad especificada de veces en caso de que falle la prueba. Las pruebas que requerían más de un intento de aprobación se marcan como "FLAKY". en el resumen de la prueba. Normalmente, el valor especificado es solo un número entero o la cadena 'default'. Si es un número entero, todas las pruebas se ejecutarán hasta N veces. Si es "default", solo se realizará un intento de prueba para las pruebas regulares y tres para las que su regla marque explícitamente como inestable (atributo poco confiable). Sintaxis alternativa: regex_filter@flaky_test_attempts. Donde flaky_test_attempts es como se muestra arriba y regex_filter significa una lista de patrones de incluir y excluir expresiones regulares (consulta también --runs_per_test). Ejemplo: --flaky_test_attempts=//foo/.*,-//foo/bar/.*@3 desencripta todas las pruebas en //foo/, excepto las que se encuentran en foo/bar tres veces. Esta opción se puede aprobar varias veces. El argumento que se pasó más recientemente y que coincida tiene prioridad. Si no hay coincidencias, el comportamiento es “predeterminado” arriba.
Etiquetas:execution
- Valor predeterminado de
--[no]ios_memleaks
: "falso" -
Habilitar la verificación de fugas de memoria en los destinos de ios_test.
Etiquetas:action_command_lines
- Valor predeterminado de
--ios_simulator_device=<a string>
: ver descripción -
El dispositivo que se debe simular cuando se ejecuta una aplicación para iOS en el simulador, p.ej., "iPhone 6". Ejecuta “xcrun simctl list devicetypes” para obtener una lista de dispositivos. de la máquina en la que se ejecutará el simulador.
Etiquetas:test_runner
- Valor predeterminado de
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Es la versión de iOS que se ejecuta en el simulador durante la ejecución o las pruebas. Esto se ignora para las reglas ios_test si se especifica un dispositivo de destino en la regla.
Etiquetas:test_runner
--local_test_jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
predeterminado: "automático"-
La cantidad máxima de trabajos de prueba locales que se ejecutan de forma simultánea. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5" 0 significa que los recursos locales limitarán la cantidad de trabajos de prueba locales que se ejecutarán simultáneamente. Establecer este valor mayor que el valor de --jobs no tiene efecto.
Etiquetas:execution
- Se acumulan
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
usos múltiples - Especifica la cantidad de veces que se debe ejecutar cada prueba. Si alguno de esos intentos falla por cualquier motivo, toda la prueba se considera fallida. Por lo general, el valor especificado es solo un número entero. Ejemplo: --runs_per_test=3 ejecutará todas las pruebas 3 veces. Sintaxis alternativa: regex_filter@runs_per_test. En el ejemplo anterior, ejecuta_per_prueba significa un valor entero y regex_filter representa una lista de patrones de expresiones regulares de inclusión y exclusión (consulta también --instrumentation_filter). Ejemplo: --runs_per_test=//foo/.*,-//foo/bar/.*@3 ejecuta todas las pruebas en //foo/ excepto las que se encuentran en foo/bar tres veces. Esta opción se puede aprobar varias veces. El argumento que se pasó más recientemente y que coincida tiene prioridad. Si no hay coincidencias, la prueba se ejecutará solo una vez.
- Se acumulan
--test_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica las variables de entorno adicionales que se insertarán en el entorno del ejecutor de pruebas. Las variables pueden especificarse por nombre, en cuyo caso su valor se leerá desde el entorno de cliente de Bazel o por el par nombre=valor. Esta opción se puede usar varias veces para especificar muchas variables. Solo lo usa la "prueba de Bazel". kubectl.
Etiquetas:test_runner
- Valor predeterminado de
--[no]test_keep_going
: "true" -
Cuando se inhabilita, cualquier prueba que no se apruebe hará que se detenga toda la compilación. De forma predeterminada, se ejecutan todas las pruebas, incluso si algunas no se aprueban.
Etiquetas:execution
- Valor predeterminado de
--test_strategy=<a string>
: "" -
Especifica qué estrategia usar cuando se ejecutan pruebas.
Etiquetas:execution
- Valor predeterminado de
--test_timeout=<a single integer or comma-separated list of 4 integers>
: "-1" - Anula los valores predeterminados del tiempo de espera de la prueba (en segundos). Si se especifica un valor entero positivo único, se anularán todas las categorías. Si se especifican 4 números enteros separados por comas, se anularán los tiempos de espera de corto, moderado, largo y eterno (en ese orden). En cualquier caso, el valor -1 indica al blaze que use los tiempos de espera predeterminados para esa categoría.
- Valor predeterminado de
--test_tmpdir=<a path>
: ver descripción - Especifica el directorio temporal base para la "prueba de Bazel". usar.
- Valor predeterminado de
--[no]zip_undeclared_test_outputs
: "true" -
Si es verdadero, los resultados de la prueba que no se declaren se archivarán en un archivo ZIP.
Etiquetas:test_runner
- Opciones que activan optimizaciones del tiempo de compilación:
- Valor predeterminado de
--cache_computed_file_digests=<a long integer>
: "50000" - Si el valor es mayor que 0, configura Bazel para almacenar en caché resúmenes de archivos en la memoria según sus metadatos, en lugar de volver a procesar los resúmenes del disco cada vez que se necesiten. Establecer esta opción en 0 garantiza la precisión, ya que no se pueden observar todos los cambios en los metadatos del archivo. Cuando no es 0, el número indica el tamaño de la caché como la cantidad de resúmenes de archivos que se almacenarán en caché.
- Valor predeterminado de
--[no]experimental_filter_library_jar_with_program_jar
: "falso" -
Filtra ProgramJar de ProGuard para quitar las clases que también estén presentes en el LibraryJar.
Etiquetas:action_command_lines
- Valor predeterminado de
--[no]experimental_inmemory_dotd_files
: "true" -
Si se habilita, los archivos .d de C++ se pasarán a la memoria directamente desde los nodos de compilación remotos en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
yexperimental
- Valor predeterminado de
--[no]experimental_inmemory_jdeps_files
: "true" -
Si se habilita, los archivos de dependencia (.jdeps) generados a partir de compilaciones de Java se pasarán a la memoria directamente desde los nodos de compilación remotos en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
yexperimental
- Valor predeterminado de
--[no]experimental_objc_include_scanning
: "falso" -
Si se debe realizar, incluye el análisis del objetivo de C/C++.
Etiquetas:loading_and_analysis
,execution
ychanges_inputs
- Valor predeterminado de
--[no]experimental_retain_test_configuration_across_testonly
: "falso" -
Cuando se habilita, --trim_test_configuration no recortará la configuración de prueba para las reglas marcadas como testonly=1. El objetivo de esto es reducir los problemas de conflictos de acciones cuando las reglas que no son de prueba dependen de las reglas cc_test. No tiene efecto si --trim_test_configuration es falso.
Etiquetas:loading_and_analysis
yloses_incremental_state
- Valor predeterminado de
--[no]experimental_starlark_cc_import
: "falso" -
Si se habilita, se puede usar la versión de Starlark de cc_import.
Etiquetas:loading_and_analysis
yexperimental
- Valor predeterminado de
--[no]experimental_unsupported_and_brittle_include_scanning
: "falso" -
Establece si las entradas se limitan a la compilación C/C++ mediante el análisis de #include líneas de archivos de entrada. Esto puede mejorar el rendimiento y la incrementalidad disminuyendo el tamaño de los árboles de entrada de compilación. Sin embargo, también puede romper compilaciones porque el escáner de inclusión no implementa por completo la semántica del preprocesador de C. En particular, no comprende las directivas dinámicas #include y, también, ignora la lógica condicional del preprocesador. Úsala bajo tu propia responsabilidad. Se cerrarán todos los problemas relacionados con esta marca que se hayan presentado.
Etiquetas:loading_and_analysis
,execution
ychanges_inputs
- Valor predeterminado de
--[no]incremental_dexing
: "true" -
Realiza la mayor parte del trabajo para la conversión a DEX por separado para cada archivo jar.
Etiquetas:affects_outputs
,loading_and_analysis
yloses_incremental_state
- Valor predeterminado de
--local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>
: "HOST_CPUS" -
Establece de forma explícita la cantidad total de núcleos de CPU locales disponibles para que Bazel invierta en acciones de compilación ejecutadas de forma local. Toma un número entero o "HOST_CPUS", opcionalmente seguido de [-|*]<float> (p. ej., HOST_CPUS*.5 para usar la mitad de los núcleos de CPU disponibles). De forma predeterminada, (“HOST_CPUS”), Bazel consultará la configuración del sistema para estimar la cantidad de núcleos de CPU disponibles.
Etiquetas:host_machine_resource_optimizations
- Se acumulan
--local_extra_resources=<a named float, 'name=value'>
usos múltiples -
Establece la cantidad de recursos adicionales disponibles para Bazel. Toma un par de números de punto flotante de cadena. Se puede usar varias veces para especificar varios tipos de recursos adicionales. Bazel limitará las acciones que se ejecutan en simultáneo en función de los recursos adicionales disponibles y los necesarios. Las pruebas pueden declarar la cantidad de recursos adicionales que necesitan con una etiqueta de “resources:<resoucename>:<amount>”. de un conjunto de datos
tengan un formato común. La CPU, la RAM y los recursos disponibles no se pueden configurar con esta marca.
Etiquetas:host_machine_resource_optimizations
--local_ram_resources=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
valor predeterminado: "HOST_RAM*.67"-
Establece de forma explícita la cantidad total de RAM del host local (en MB) disponible para Bazel a fin de invertir en acciones de compilación ejecutadas localmente. Toma un número entero, o "HOST_RAM", opcionalmente seguido de [-|*]<float> (p. ej., HOST_RAM*.5 para usar la mitad de la RAM disponible). De forma predeterminada, ("HOST_RAM*.67"), Bazel consultará la configuración del sistema para estimar la cantidad de RAM disponible y utilizará el 67% de esta.
Etiquetas:host_machine_resource_optimizations
- 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. Recibe una asignación a un número de punto flotante o HOST_RAM/HOST_CPUS, opcionalmente seguido de [-|*]<float> (p. ej., memory=HOST_RAM*.5 para usar la mitad de la RAM disponible). Se puede usar varias veces para especificar varios tipos de recursos. Bazel limitará las acciones que se ejecutan en simultáneo según los recursos disponibles y los necesarios. Las pruebas pueden declarar la cantidad de recursos que necesitan con la etiqueta “resources:<resource name>:<amount>”. de un conjunto de datos
tengan un formato común. Anula los recursos especificados por --local_{cpu|ram|extra}_resources.
Etiquetas:host_machine_resource_optimizations
- Valor predeterminado de
--[no]objc_use_dotd_pruning
: "true" -
Si se configura, los archivos .d emitidos por Clang se usarán para reducir el conjunto de entradas que se pasan a compilaciones objc.
Etiquetas:changes_inputs
yloading_and_analysis
- Valor predeterminado de
--[no]process_headers_in_dependencies
: "falso" -
Cuando se compila un //a:a de destino, procesa encabezados en todos los destinos de los que depende //a:a (si el procesamiento de encabezados está habilitado para la cadena de herramientas).
Etiquetas:execution
- Valor predeterminado de
--[no]trim_test_configuration
: "true" -
Cuando se habilita esta opción, las opciones relacionadas con las pruebas se borran debajo del nivel superior de la compilación. Cuando esta marca está activa, las pruebas no se pueden compilar como dependencias de reglas que no son de prueba, pero los cambios en las opciones relacionadas con pruebas no harán que las reglas que no son de prueba se vuelvan a analizar.
Etiquetas:loading_and_analysis
yloses_incremental_state
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Valor predeterminado de
--[no]experimental_bep_target_summary
: "falso" - Especifica si se publicarán los eventos de TargetSummary.
- Valor predeterminado de
--[no]experimental_build_event_expand_filesets
: "falso" -
Si es verdadero, expande los conjuntos de archivos en BEP cuando presentes archivos de salida.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]experimental_build_event_fully_resolve_fileset_symlinks
: "falso" -
Si es verdadero, resuelve por completo los symlinks relativos del conjunto de archivos en el BEP cuando presentes los archivos de salida. Requiere --experimental_build_event_expand_filesets.
Etiquetas:affects_outputs
- Valor predeterminado de
--experimental_build_event_upload_max_retries=<an integer>
: "4" -
La cantidad máxima de veces que Bazel debería reintentar subir un evento de compilación.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
: "1s" -
Es el retraso mínimo inicial para los reintentos de retirada exponencial cuando falla la carga de BEP. (exponente: 1.6)
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--experimental_build_event_upload_strategy=<a string>
: ver descripción -
Selecciona cómo subir los artefactos a los que se hace referencia en el protocolo del evento de compilación.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]experimental_materialize_param_files_directly
: "falso" -
Si materializas archivos de parámetros, hazlo con escrituras directas en el disco.
Etiquetas:execution
- Valor predeterminado de
--[no]experimental_run_bep_event_include_residue
: "falso" -
Indica si se debe incluir el residue de línea de comandos en eventos de compilación en ejecución que podrían contener el residue. De forma predeterminada, el residue no se incluye en los eventos de compilación de comandos de ejecución que podrían contener el residue.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]experimental_stream_log_file_uploads
: "falso" -
Transmite las cargas de archivos de registro directamente al almacenamiento remoto en lugar de escribirlas en el disco.
Etiquetas:affects_outputs
- Valor predeterminado de
--explain=<a path>
: ver descripción -
Hace que el sistema de compilación explique cada paso ejecutado de la compilación. La explicación se escribe en el archivo de registro especificado.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]legacy_important_outputs
: "true" -
Úsalo para suprimir la generación del campo relevant_outputs heredado en el evento TargetComplete. importantes_outputs son obligatorios para la integración de Bazel a ResultStore.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]materialize_param_files
: "falso" -
Escribe archivos de parámetros intermedios en el árbol de salida, incluso cuando se usa la ejecución de acción remota. Es útil para depurar acciones. Esto está implícito en --subcomandos y --verbose_failures.
Etiquetas:execution
- Valor predeterminado de
--max_config_changes_to_show=<an integer>
: "3" -
Cuando se descarta la caché de análisis debido a un cambio en las opciones de compilación, se muestra hasta la cantidad determinada de nombres de opciones modificados. Si el número proporcionado es -1, se mostrarán todas las opciones modificadas.
Etiquetas:terminal_output
- Valor predeterminado de
--max_test_output_bytes=<an integer>
: "-1" -
Especifica el tamaño máximo por registro de prueba que puede emitirse cuando --test_output es “errores” o "todos". Es útil para evitar sobrecargar la salida con resultados de prueba demasiado ruidosos. El encabezado de la prueba se incluye en el tamaño del registro. Los valores negativos implican que no hay límite. La salida es todo o nada.
Etiquetas:test_runner
,terminal_output
yexecution
- Valor predeterminado de
--output_filter=<a valid Java regular expression>
: ver descripción -
Solo muestra advertencias y resultados de acciones para reglas cuyo nombre coincida con la expresión regular proporcionada.
Etiquetas:affects_outputs
- Valor predeterminado de
--progress_report_interval=<an integer in 0-3600 range>
: "0" -
La cantidad de segundos que se debe esperar entre informes sobre trabajos que aún se están ejecutando. El valor predeterminado 0 significa que el primer informe se imprimirá después de 10 segundos, luego 30 segundos y, después de ese tiempo, se informará una vez por minuto. Cuando se habilita --maldiciones, el progreso se informa cada segundo.
Etiquetas:affects_outputs
- Valor predeterminado de
--show_result=<an integer>
: "1" -
Muestra los resultados de la compilación. Para cada destino, indica si se actualizó y, de ser así, una lista de los archivos de salida que se compilaron. Los archivos impresos son cadenas convenientes que se pueden copiar y pegar en la shell para ejecutarlos.
Esta opción requiere un argumento de número entero, que es el número de umbral de objetivos por encima del cual no se imprime la información del resultado. Por lo tanto, cero provoca la supresión del mensaje y MAX_INT hace que siempre se imprima el resultado. El valor predeterminado es uno.
Si no se compiló nada para un objetivo, se pueden omitir sus resultados a fin de mantener los resultados por debajo del umbral.
Etiquetas:affects_outputs
--[no]subcommands
[-s
] predeterminado: "false"-
Muestra los subcomandos que se ejecutaron durante una compilación. Marcas relacionadas: --execution_log_json_file, --execution_log_binary_file (para registrar subcomandos en un archivo en un formato compatible con las herramientas)
Etiquetas:terminal_output
--test_output=<summary, errors, all or streamed>
predeterminado: "summary"-
Especifica el modo de salida deseado. Los valores válidos son “summary”. para mostrar solo el resumen del estado de prueba, para imprimir registros de prueba de las pruebas fallidas, "all" para imprimir registros de todas las pruebas y "transmitidos" para generar registros para todas las pruebas en tiempo real (esto forzará la ejecución local de las pruebas, una a la vez, independientemente del valor de --test_strategy)
Etiquetas:test_runner
,terminal_output
yexecution
- Valor predeterminado de
--test_summary=<short, terse, detailed, none or testcase>
: “short” -
Especifica el formato deseado para el resumen de la prueba. Los valores válidos son "short" para imprimir solo información sobre las pruebas ejecutadas, "terse", para imprimir información sobre las pruebas no exitosas que se hayan ejecutado, "detalladas" para imprimir información detallada sobre casos de prueba fallidos, “testcase” para imprimir el resumen en la resolución de casos de prueba, no imprimir información detallada sobre los casos de prueba fallidos y “ninguno” para omitir el resumen.
Etiquetas:terminal_output
- Valor predeterminado de
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: “-.*” -
Imprime la información de depuración durante la resolución de la cadena de herramientas. La marca toma una regex, que se verifica con los tipos de la cadena de herramientas y los objetivos específicos para ver cuál depurar. Es posible que varias regex estén separadas con comas y, luego, cada regex se verifique por separado. Nota: El resultado de esta marca es muy complejo y es probable que solo sea útil para los expertos en la resolución de la cadena de herramientas.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]verbose_explanations
: "falso" -
Aumenta la verbosidad de las explicaciones emitidas si --explain está habilitada. No tiene efecto si --explain no está habilitada.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]verbose_failures
: "falso" -
Si un comando falla, muestra la línea de comandos completa.
Etiquetas:terminal_output
- Opciones que especifican o modifican una entrada genérica para un comando de Bazel que no se encuentra en otras categorías.
- Se acumulan
--aspects_parameters=<a 'name=value' assignment>
usos múltiples -
Especifica los valores de los parámetros de aspectos de la línea de comandos. Cada valor del parámetro se especifica mediante <param_name>=<param_value>, por ejemplo, 'my_param=my_val' en el que “my_param” es un parámetro de algún aspecto en la lista de --aspects o requerido por un aspecto de la lista. Esta opción se puede usar varias veces. Sin embargo, no se permite asignar valores al mismo parámetro más de una vez.
Etiquetas:loading_and_analysis
- Se acumulan
--flag_alias=<a 'name=value' flag alias>
usos múltiples -
Establece un nombre abreviado para una bandera de Starlark. Toma un solo par clave-valor con el formato "<clave>=<valor>" como argumento.
Etiquetas:changes_inputs
- Valor predeterminado de
--[no]incompatible_default_to_explicit_init_py
: "falso" -
Esta marca cambia el comportamiento predeterminado para que los archivos __init__.py ya no se creen automáticamente en los runfiles de los objetivos de Python. De manera precisa, cuando un destino py_binary o py_test tiene legacy_create_init configurado en “auto” (configuración predeterminada), se trata como falsa solo si se configura esta marca. Consulta https://github.com/bazelbuild/bazel/issues/10076.
Etiquetas:affects_outputs
yincompatible_change
- Valor predeterminado de
--[no]incompatible_py2_outputs_are_suffixed
: "true" -
Si es verdadero, los destinos compilados en la configuración de Python 2 aparecerán en una raíz de salida que incluya el sufijo "-py2", mientras que los destinos compilados para Python 3 aparecerán en una raíz sin sufijo relacionado con Python. Esto significa que el symlink de conveniencia "bazel-bin" apuntará a los objetivos de Python 3 en lugar de a Python 2. Si habilitas esta opción, también se recomienda habilitar “--incompatible_py3_is_default”.
Etiquetas:affects_outputs
yincompatible_change
- Valor predeterminado de
--[no]incompatible_py3_is_default
: "true" -
Si el valor es verdadero, los destinos "py_binary" y "py_test" que no establezcan sus atributos "python_version" (o "default_python_version") pasarán a ser PY3 de forma predeterminada en lugar de PY2. Si configuras esta marca, también se recomienda configurar `--incompatible_py2_outputs_are_suffixed`.
Etiquetas:loading_and_analysis
,affects_outputs
yincompatible_change
- Valor predeterminado de
--[no]incompatible_use_python_toolchains
: "true" -
Si se configura como verdadera, las reglas ejecutables nativas de Python usarán el entorno de ejecución de Python especificado por la cadena de herramientas de Python, en lugar del entorno de ejecución proporcionado por marcas heredadas como --python_top.
Etiquetas:loading_and_analysis
yincompatible_change
- Valor predeterminado de
--python_version=<PY2 or PY3>
: ver descripción -
El modo de versión principal de Python, ya sea “PY2” o “PY3”. Ten en cuenta que los objetivos "py_binary" y "py_test" anulan esta opción (incluso si no especifican explícitamente una versión), por lo que no suele haber muchos motivos para proporcionar esta marca.
Etiquetas:loading_and_analysis
yaffects_outputs
- Valor predeterminado de
--target_pattern_file=<a string>
: "" -
Si se configura, la compilación leerá los patrones del archivo nombrado aquí, en lugar de hacerlo en la línea de comandos. Es un error especificar un archivo aquí, al igual que patrones de la línea de comandos.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remoto:
- Valor predeterminado de
--experimental_remote_cache_eviction_retries=<an integer>
: "0" -
La cantidad máxima de intentos para reintentar si la compilación encontró un error de expulsión de caché remota. Un valor distinto de cero establecerá implícitamente --incompatible_remote_use_new_exit_code_for_lost_inputs como true. Se generará un nuevo ID de invocación para cada intento. Si generas el ID de invocación y se lo proporcionas a Bazel con --invocation_id, no debes usar esta marca. En su lugar, configura la marca --incompatible_remote_use_new_exit_code_for_lost_inputs y verifica el código de salida 39.
Etiquetas:execution
- Valor predeterminado de
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
: "true" -
Si la estableces como verdadera, Bazel usará el nuevo código de salida 39, en lugar de 34, si la caché remota expulsa los BLOB durante la compilación.
Etiquetas:incompatible_change
- Otras opciones, sin categorizar:
- Valor predeterminado de
--[no]allow_analysis_cache_discard
: "true" -
Si se descarta la caché de análisis debido a un cambio en el sistema de compilación, configurar esta opción como falsa hará que Bazel se cierre, en lugar de continuar con la compilación. Esta opción no tiene efecto cuando "discard_analysis_cache" también se configura.
Etiquetas:eagerness_to_exit
- Valor predeterminado de
--[no]build_manual_tests
: "falso" - Fuerza los objetivos de prueba etiquetados como "manuales" que se construya. 'manual' se excluyen del procesamiento. Esta opción los obliga a compilarse (pero no a ejecutarse).
- Valor predeterminado de
--build_tag_filters=<comma-separated list of options>
: "" - Especifica una lista de etiquetas separadas por comas. De manera opcional, cada etiqueta puede ir precedida por "-" para especificar etiquetas excluidas. Solo se crearán esos objetivos que contengan al menos una etiqueta incluida y que no contengan ninguna etiqueta excluida. Esta opción no afecta el conjunto de pruebas ejecutadas con el comando "test" comando; se rigen por las opciones de filtro de prueba, por ejemplo, "--test_tag_filters"
- Valor predeterminado de
--[no]build_tests_only
: "falso" - Si se especifica, solo se compilarán las reglas *_test y test_suite y se ignorarán los demás destinos especificados en la línea de comandos. De forma predeterminada, se compilará todo lo que se solicitó.
--[no]cache_test_results
[-t
] predeterminada: "automática"- Si se configura como “auto”, Bazel vuelve a ejecutar una prueba solo en los siguientes casos: (1) Bazel detecta cambios en la prueba o sus dependencias, (2) la prueba se marcó como externa, (3) se solicitaron múltiples ejecuciones de prueba con --runs_per_test o(4) la prueba falló anteriormente. Si se configura en "sí", Bazel almacenará en caché todos los resultados de las pruebas, excepto las marcadas como externas. Si la estableces como "no", Bazel no almacenará en caché ningún resultado de prueba.
- Valor predeterminado de
--[no]compile_one_dependency
: "falso" - Compila una sola dependencia de los archivos de argumento. Esto es útil para verificar la sintaxis de los archivos de origen en los IDE, por ejemplo, recompilando un único destino que depende del archivo fuente para detectar errores lo antes posible en el ciclo de edición, compilación y prueba. Este argumento afecta la forma en que se interpretan todos los argumentos que no son de marca. en lugar de ser objetivos de compilación, sino nombres de archivos de origen. Para cada nombre de archivo de origen, se compilará un destino arbitrario que dependa de él.
- Se acumulan
--deleted_packages=<comma-separated list of package names>
usos múltiples - Una lista separada por comas de los nombres de los paquetes que el sistema de compilación considerará inexistentes, incluso si están visibles en alguna parte de la ruta del paquete. Usa esta opción cuando borres un subpaquete "x/y" de un paquete 'x' existente. Por ejemplo, después de borrar x/y/BUILD en tu cliente, el sistema de compilación puede presentar un reclamo si encuentra la etiqueta “//x:y/z”. si aún lo proporciona otra entrada package_path. Especificar --deleted_packages x/y evita este problema.
- Valor predeterminado de
--[no]discard_analysis_cache
: "falso" - Descarta la caché de análisis inmediatamente después de que se complete la fase de análisis. Reduce el uso de memoria en aproximadamente un 10%, pero ralentiza las compilaciones incrementales adicionales.
- Valor predeterminado de
--execution_log_binary_file=<a path>
: ver descripción - Registra los generadores ejecutados en este archivo como protos SpawnExec delimitados por longitud, según src/main/protobuf/spawn.proto. Marcas relacionadas: --execution_log_json_file (formato JSON de texto; mutuamente excluyente), --execution_log_sort (si se debe ordenar el registro de ejecución), --subcomandos (para mostrar subcomandos en el resultado de la terminal).
- Valor predeterminado de
--execution_log_json_file=<a path>
: ver descripción - Registra los generadores ejecutados en este archivo como representaciones JSON delimitadas por saltos de línea de los proto SpawnExec, según src/main/protobuf/spawn.proto. Marcas relacionadas: --execution_log_binary_file (formato binario protobuf, mutuamente excluyente), --execution_log_sort (si se debe ordenar el registro de ejecución), --subcomandos (para mostrar subcomandos en el resultado de la terminal).
- Valor predeterminado de
--[no]execution_log_sort
: "true" - Establece si se debe ordenar el registro de ejecución, lo que facilita la comparación de registros en las invocaciones. Se configura como falso para evitar un uso potencialmente significativo de CPU y memoria al final de la invocación, a costa de producir el registro en un orden de ejecución no determinista. Solo se aplica a los formatos binarios y JSON. el formato compacto nunca está ordenado.
- Valor predeterminado de
--[no]expand_test_suites
: "true" -
Expandir los objetivos de test_suite a sus pruebas constituyentes antes del análisis Cuando esta marca esté activada (configuración predeterminada), se aplicarán patrones de objetivo negativo a las pruebas que pertenezcan al paquete de pruebas; de lo contrario, no se aplicarán. Desactivar esta marca es útil cuando los aspectos de nivel superior se aplican en la línea de comandos: luego, pueden analizar los objetivos de test_suite.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]experimental_cancel_concurrent_tests
: "falso" -
Si esta preferencia se establece como "true", Blaze cancelará las pruebas que se estén ejecutando simultáneamente en la primera ejecución correcta. Esto solo es útil en combinación con --runs_per_test_detects_flakes.
Etiquetas:affects_outputs
yloading_and_analysis
- Valor predeterminado de
--experimental_execution_log_compact_file=<a path>
: ver descripción - Registra los generadores ejecutados en este archivo como protos ExecLogEntry delimitados por longitud, según src/main/protobuf/spawn.proto. Todo el archivo 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 binario protobuf, mutuamente excluyente), --execution_log_json_file (formato JSON de texto; mutuamente excluyente), --subcomandos (para mostrar subcomandos en el resultado de la terminal).
- Valor predeterminado de
--experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "" - Obsoleto para dar lugar a aspectos. Filtra el conjunto de objetivos para los que se programarán acciones extra.
- Valor predeterminado de
--[no]experimental_extra_action_top_level_only
: "falso" - Obsoleto para dar lugar a aspectos. Solo programa extra_actions para los objetivos de nivel superior.
- Valor predeterminado de
--[no]experimental_fetch_all_coverage_outputs
: "falso" -
Si es verdadero, Bazel recupera todo el directorio de datos de cobertura para cada prueba durante una ejecución de cobertura.
Etiquetas:affects_outputs
yloading_and_analysis
- Valor predeterminado de
--[no]experimental_generate_llvm_lcov
: "falso" -
Si es verdadero, la cobertura de clang generará un informe de LCOV.
Etiquetas:affects_outputs
yloading_and_analysis
- Valor predeterminado de
--[no]experimental_j2objc_header_map
: "true" - Establece si se debe generar un mapa de encabezado de J2ObjC en paralelo a la transpilación de J2ObjC.
- Valor predeterminado de
--[no]experimental_j2objc_shorter_header_path
: "falso" -
Indica si se debe generar con una ruta de encabezado más corta (usa "_ios" en lugar de "_j2objc").
Etiquetas:affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
predeterminado: "javabuilder"- Habilita rutas de clase reducidas para compilaciones de Java.
- Valor predeterminado de
--[no]experimental_limit_android_lint_to_android_constrained_java
: "falso" -
Limita las --experimental_run_android_lint_on_java_rules a bibliotecas compatibles con Android.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]experimental_run_android_lint_on_java_rules
: "falso" -
Establece si se deben validar fuentes java_*.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]explicit_java_test_deps
: "falso" - Especifica de forma explícita una dependencia para JUnit o Hamcrest en una java_test, en lugar de obtener por error de las dependencias de TestRunner. Por el momento, solo funciona para Bazel.
- Valor predeterminado de
--[no]fetch
: "true" - Permite que el comando recupere dependencias externas. Si se configura como falsa, el comando usará cualquier versión almacenada en caché de la dependencia; si no existe ninguna, el comando fallará.
- Valor predeterminado de
--host_java_launcher=<a build target label>
: ver descripción - El selector de Java que usan las herramientas que se ejecutan durante una compilación.
- Se acumulan
--host_javacopt=<a string>
usos múltiples - Opciones adicionales para pasar a javac cuando se compilan herramientas que se ejecutan durante una compilación.
- Se acumulan
--host_jvmopt=<a string>
usos múltiples - Opciones adicionales para pasar a la VM de Java cuando se compilan herramientas que se ejecutan durante la compilación. Estas se agregarán a las opciones de inicio de la VM de cada destino java_binary.
- Valor predeterminado de
--[no]incompatible_check_sharding_support
: "true" -
Si es verdadero, Bazel fallará una prueba fragmentada si el ejecutor de pruebas no indica que admite la fragmentación tocando el archivo en la ruta de acceso en TEST_SHARD_STATUS_FILE. Si es falso, un ejecutor de pruebas que no admite la fragmentación dará lugar a que se ejecuten todas las pruebas en cada fragmento.
Etiquetas:incompatible_change
- Valor predeterminado de
--[no]incompatible_exclusive_test_sandboxed
: "true" -
Si es verdadero, las pruebas exclusivas se ejecutarán con la estrategia de zona de pruebas. Agregar “local” etiqueta para forzar una ejecución de prueba exclusiva de forma local
Etiquetas:incompatible_change
- Valor predeterminado de
--[no]incompatible_strict_action_env
: "falso" -
Si es verdadero, Bazel usa un entorno con un valor estático para PATH y no hereda LD_LIBRARY_PATH. Usa --action_env=ENV_VARIABLE si deseas heredar variables de entorno específicas del cliente, pero ten en cuenta que hacerlo puede evitar el almacenamiento en caché entre usuarios si se usa una caché compartida.
Etiquetas:loading_and_analysis
yincompatible_change
- Se acumulan
--j2objc_translation_flags=<comma-separated list of options>
usos múltiples - Opciones adicionales para pasar a la herramienta J2ObjC.
--java_debug
-
Hace que la máquina virtual Java de una prueba de Java espere una conexión desde un depurador compatible con JDWP (como jdb) antes de comenzar la prueba. Implica -test_output=streamed.
Se expande a:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
- Valor predeterminado de
--[no]java_deps
: "true" - Genera información de dependencia (por ahora, la ruta de clase del tiempo de compilación) por objetivo de Java.
- Valor predeterminado de
--[no]java_header_compilation
: "true" - Compila ijars directamente desde la fuente.
- Valor predeterminado de
--java_language_version=<a string>
: "" - La versión del lenguaje Java
- Valor predeterminado de
--java_launcher=<a build target label>
: ver descripción - Selector de Java que se usa cuando se compilan objetos binarios de Java. Si esta marca se establece en la cadena vacía, se usa el selector de JDK. El "selector" anula esta marca.
--java_runtime_version=<a string>
predeterminado: “local_jdk”- La versión del entorno de ejecución de Java
- Se acumulan
--javacopt=<a string>
usos múltiples - Opciones adicionales para pasar a javac.
- Se acumulan
--jvmopt=<a string>
usos múltiples - Opciones adicionales para pasar a la VM de Java. Estas se agregarán a las opciones de inicio de la VM de cada destino java_binary.
- Valor predeterminado de
--legacy_main_dex_list_generator=<a build target label>
: ver descripción - Especifica un objeto binario que se debe usar para generar la lista de clases que deben estar en el DEX principal al compilar multidex heredado.
- Valor predeterminado de
--local_termination_grace_seconds=<an integer>
: "15" - Tiempo de espera entre la finalización de un proceso local debido al tiempo de espera y su cierre forzado.
- Valor predeterminado de
--optimizing_dexer=<a build target label>
: ver descripción - Especifica el objeto binario que se usará para generar archivos dex sin fragmentación.
--package_path=<colon-separated list of options>
predeterminado: “%workspace%”- Una lista separada por dos puntos de dónde buscar paquetes Elementos que comienzan con “%workspace%” están relacionadas con el espacio de trabajo que los contiene. Si se omite o está vacío, el valor predeterminado es el resultado de “bazel info default-package-path”.
- Se acumulan
--plugin=<a build target label>
usos múltiples - Complementos para usar en la compilación. Actualmente funciona con java_plugin.
- Valor predeterminado de
--proguard_top=<a build target label>
: ver descripción - Especifica qué versión de ProGuard se debe usar para la eliminación de código al compilar un objeto binario de Java.
--proto_compiler=<a build target label>
predeterminado: “@bazel_tools//tools/proto:protoc”-
Es la etiqueta del proto-compiler.
Etiquetas:affects_outputs
yloading_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
yloading_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
yloading_and_analysis
--proto_toolchain_for_java=<a build target label>
predeterminado: "@bazel_tools//tools/proto:java_toolchain"-
Etiqueta de proto_lang_toolchain() que describe cómo compilar protos de Java.
Etiquetas:affects_outputs
yloading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
predeterminado: "@bazel_tools//tools/proto:javalite_toolchain"-
Etiqueta de proto_lang_toolchain() que describe cómo compilar protos de JavaLite.
Etiquetas:affects_outputs
yloading_and_analysis
- Se acumulan
--protocopt=<a string>
usos múltiples -
Opciones adicionales para pasar al compilador de protobuf.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]runs_per_test_detects_flakes
: "falso" - Si es verdadero, cualquier fragmento en el que se haya completado al menos una ejecución o un intento y al menos una falla o ejecución tendrá un estado FLAKY.
- Valor predeterminado de
--shell_executable=<a path>
: ver descripción -
Ruta de acceso absoluta al shell ejecutable para que lo use Bazel. Si no la estableces, pero la variable de entorno BAZEL_SH está establecida en la primera invocación de Bazel (que inicia un servidor de Bazel), Bazel la usará. Si no se establece ninguna, Bazel usa una ruta de acceso predeterminada hard-coded según el sistema operativo en el que se ejecute (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, todos los demás: /bin/bash). Ten en cuenta que usar un shell que no es compatible con Bash puede generar fallas de compilación o de tiempo de ejecución de los objetos binarios generados.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]show_loading_progress
: "true" - Si se habilita, hace que Bazel imprima el mensaje "Loading package:" (Cargando paquete): mensajes nuevos.
- Se acumulan
--test_arg=<a string>
usos múltiples - Especifica las opciones y los argumentos adicionales que se deben pasar al ejecutable de la prueba. Se puede usar varias veces para especificar varios argumentos. Si se ejecutan varias pruebas, cada una recibirá argumentos idénticos. Solo lo usa la "prueba de Bazel". kubectl.
- Valor predeterminado de
--test_filter=<a string>
: ver descripción - Especifica un filtro para reenviar al framework de prueba. Se usa para limitar las pruebas que se ejecutan. Ten en cuenta que esto no afecta los destinos que se compilan.
- Valor predeterminado de
--test_lang_filters=<comma-separated list of options>
: "" - Especifica la lista de idiomas de prueba separados por comas. De manera opcional, cada idioma puede ir precedido por "-" para especificar los idiomas excluidos. Solo se encontrarán los objetivos de prueba que están escritos en los idiomas especificados. El nombre que se usa para cada idioma debe ser el mismo que el prefijo de idioma de la regla *_test; p.ej., uno de 'cc', 'java', 'py', etc. Esta opción afecta el comportamiento --build_tests_only y el comando de prueba.
- Valor predeterminado de
--test_result_expiration=<an integer>
: "-1" - Esta opción dejó de estar disponible y no tiene efecto.
- Valor predeterminado de
--[no]test_runner_fail_fast
: "falso" - La opción de reenvíos falla con rapidez al ejecutor de pruebas. El ejecutor de pruebas debe detener la ejecución cuando ocurre la primera falla.
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>
predeterminado: "explícito"- Especifica la estrategia para la fragmentación de pruebas: “explícita” solo use la fragmentación si el atributo 'shard_count' El atributo BUILD está presente. 'inhabilitado' nunca usen la fragmentación de pruebas. “forced=k” aplicar “k” fragmentos para realizar pruebas sin importar la variable 'shard_count' Build.
- Valor predeterminado de
--test_size_filters=<comma-separated list of values: small, medium, large or enormous>
: "" - Especifica la lista de tamaños de prueba separados por comas. De manera opcional, cada tamaño puede ir precedido por "-" para especificar los tamaños excluidos. Solo se detectarán los objetivos de prueba que contienen, al menos, un tamaño incluido y no contienen tamaños excluidos. Esta opción afecta el comportamiento --build_tests_only y el comando test.
- Valor predeterminado de
--test_tag_filters=<comma-separated list of options>
: "" - Especifica la lista de etiquetas de prueba separadas por comas. De manera opcional, cada etiqueta puede ir precedida por "-" para especificar etiquetas excluidas. Solo se detectarán los objetivos de prueba que contienen al menos una etiqueta incluida y no contienen ninguna etiqueta excluida. Esta opción afecta el comportamiento --build_tests_only y el comando test.
- Valor predeterminado de
--test_timeout_filters=<comma-separated list of values: short, moderate, long or eternal>
: "" - Especifica la lista de tiempos de espera de prueba separados por comas. De manera opcional, cada tiempo de espera puede ir precedido por "-" para especificar tiempos de espera excluidos. Solo se detectarán los objetivos de prueba que contienen al menos un tiempo de espera incluido y no contienen tiempos de espera excluidos. Esta opción afecta el comportamiento --build_tests_only y el comando test.
- Valor predeterminado de
--tool_java_language_version=<a string>
: "" - La versión de lenguaje Java que se usa para ejecutar las herramientas necesarias durante una compilación
--tool_java_runtime_version=<a string>
predeterminado: "remotejdk_11"- La versión del entorno de ejecución de Java que se usa para ejecutar herramientas durante la compilación
- Valor predeterminado de
--[no]use_ijars
: "true" - Si se habilita, esta opción hace que la compilación de Java use archivos jar de la interfaz. Esto dará como resultado una compilación incremental más rápida, pero los mensajes de error pueden ser diferentes.
Opciones de canonicalización de marcas
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Lugares adicionales para buscar archivos antes de acceder a la red y descargarlos.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]experimental_repository_cache_hardlinks
: "falso" -
Si se configura, la caché del repositorio vinculará el archivo en lugar de copiarlo en caso de que se produzca un acierto de caché. Esto está diseñado para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--experimental_repository_downloader_retries=<an integer>
: "0" -
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
valor predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark según este factor. De esta manera, los repositorios externos pueden funcionar en máquinas más lentas de lo esperado por el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
yexperimental
- Valor predeterminado de
--http_connector_attempts=<an integer>
: "8" -
La cantidad máxima de intentos para descargas http.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--http_connector_retry_max_timeout=<An immutable length of time.>
: "0s" -
El tiempo de espera máximo para los reintentos de descarga de HTTP. Con un valor de 0, no se define ningún tiempo de espera máximo.
Etiquetas:bazel_internal_configuration
--http_timeout_scaling=<a double>
valor predeterminado: "1.0"-
Escalar todos los tiempos de espera relacionados con las descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación de caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché; de lo contrario, el valor predeterminado es '<output_user_root>/cache/repos/v1'. se usa
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]repository_disable_download
: "falso" -
Si se configura, no se permite la descarga con ctx.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no está completamente inhabilitado. ctx.execute aún podría ejecutar un ejecutable arbitrario que acceda a Internet.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de compilación:
- Valor predeterminado de
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
El porcentaje del espacio permanente ocupado (0-100) por encima del cual GcThrashingDetector considera eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, GcThrashingDetector está inhabilitado.
Etiquetas:host_machine_resource_optimizations
- Opciones que controlan el resultado del comando:
- Valor predeterminado de
--[no]canonicalize_policy
: "falso" -
Muestra la política canónica después de la expansión y el filtrado. Para mantener el resultado limpio, los argumentos del comando canonicalizado NO se mostrarán cuando esta opción se configure como verdadera. Ten en cuenta que el comando especificado por --for_command afecta la política filtrada y, si no se especifica ninguno, el comando predeterminado es "build".
Etiquetas:affects_outputs
yterminal_output
- Valor predeterminado de
--[no]experimental_include_default_values
: "falso" -
Indica si las opciones de Starlark configuradas en sus valores predeterminados se incluyen en el resultado.
Etiquetas:affects_outputs
yterminal_output
- Esta opción afecta la semántica del lenguaje de Starlark o de la API de compilación accesible para los archivos BUILD, los archivos .bzl o los archivos WORKSPACE:
- Valor predeterminado de
--[no]incompatible_config_setting_private_default_visibility
: "falso" -
Si incompatible_enforce_config_setting_visibility=false, es una noop. De lo contrario, si esta marca es falsa, cualquier config_setting sin un atributo de visibilidad explícito será //visibility:public. Si esta marca es verdadera, config_setting sigue la misma lógica de visibilidad que todas las demás reglas. Consulta https://github.com/bazelbuild/bazel/issues/12933.
Etiquetas:loading_and_analysis
yincompatible_change
- Valor predeterminado de
--[no]incompatible_enforce_config_setting_visibility
: "true" -
Si es verdadero, aplica las restricciones de visibilidad config_setting. Si es falso, cada config_setting es visible para cada destino. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
yincompatible_change
- Opciones relacionadas con la salida y la semántica de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Se especificaron las versiones de los módulos con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resueltas, incluso si se declaran como eliminadas en el registro del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones rechazadas harán que la resolución falle. También puedes definir la versión generada permitida con la variable de entorno `BZLMOD_ALLOW_YANKED_VERSIONS`. Puedes inhabilitar esta verificación con la palabra clave “todo” (no se recomienda).
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
: "error" -
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivar el caso a una falla de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecta una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas de `bazel_dep` declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]ignore_dev_dependency
: "falso" -
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--lockfile_mode=<off, update or error>
: "actualizar" -
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "error" para usar el archivo de bloqueo, pero arroja un error si no está actualizado, o "off" para que no se lea ni escriba en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <module name>=<path>. Si la ruta de acceso dada es una ruta de acceso absoluta, se usará tal como es. Si la ruta de acceso determinada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso dada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace"
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en registros anteriores y solo se recurrirán a los registros posteriores cuando falten en los registros anteriores.
Etiquetas:changes_inputs
- Valor predeterminado de
--vendor_dir=<a path>
: ver descripción -
Especifica el directorio que debe almacenar los repositorios externos en modo de proveedor, ya sea para recuperarlos o usarlos durante la compilación. La ruta 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 bloquee Bazel con una OOM. Cada límite se especifica como <period>:<count> En el ejemplo anterior, el período es una duración y el recuento es un número entero positivo. Si hay más de --gc_thrashing_threshold por ciento de espacio titular (montón de generación anterior) permanece ocupado después de <count> varias recolecciones de elementos no utilizados consecutivas dentro de <period>, se activará una OOM. Si hay varios límites, puedes separarlos por comas.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: “2147483647”-
Marca de configuración avanzada del motor interno Skyframe de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de recolección de elementos no utilizados completa, eliminará el estado temporal de Skyframe innecesario, hasta esta cantidad de veces por invocación. La configuración predeterminada es Integer.MAX_VALUE; eficazmente ilimitados. Cero significa que los eventos de recolección de elementos no utilizados completas nunca activarán la acción de soltar. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC completo y se supere ese umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: “2147483647”-
Marca de configuración avanzada del motor interno Skyframe de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando ocurra un evento menor de recolección de elementos no utilizados, se eliminará el estado temporal de Skyframe innecesario, hasta esta cantidad de veces por invocación. La configuración predeterminada es Integer.MAX_VALUE; eficazmente ilimitados. Cero significa que los eventos menores de recolección de elementos no utilizados nunca activarán la acción de soltar. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC menor y se supere ese umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
- Valor predeterminado de
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
Marca de configuración avanzada del motor interno Skyframe de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es al menos este umbral, descartará el estado temporal de Skyframe innecesario. Ajustar esto puede permitirte mitigar el impacto en el tiempo de la hiperpaginación de GC cuando la hiperpaginación de GC (i) es causada por el uso de memoria de este estado temporal y (ii) es más costosa que reconstituir el estado cuando sea necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Valor predeterminado de
--experimental_command_profile=<cpu, wall, alloc or lock>
: ver descripción - Registra un perfil de la grabadora de vuelos de Java mientras dure el comando. Se debe proporcionar uno de los tipos de eventos de generación de perfiles admitidos (CPU, muro, asignación 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 la semántica de esta marca podrían cambiar en el futuro para admitir tipos de perfil o formatos de salida adicionales. usar bajo tu propia responsabilidad.
- Valor predeterminado de
--[no]experimental_record_metrics_for_all_mnemonics
: "falso" - De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemónicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán las estadísticas de todos los mnemónicos.
- Opciones que especifican o modifican una entrada genérica para un comando de Bazel que no se encuentra en otras categorías:
- Valor predeterminado de
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
--for_command=<a string>
predeterminado: "compilación"-
Es el comando para el que se deben canonicalizar las opciones.
Etiquetas:affects_outputs
yterminal_output
- Valor predeterminado de
--invocation_policy=<a string>
: "" -
Aplica una política de invocación a las opciones que se van a canonicalizar.
Etiquetas:affects_outputs
yterminal_output
- Opciones de ejecución y almacenamiento en caché remoto:
- Valor predeterminado de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo con el que se configurará el cargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno que debe coincidir y otro para usar como URL sustituta, con referencias inversas a partir de `$1`. Es posible proporcionar varias directivas "rewrite" para la misma URL; en este caso, se devolverán varias URL.
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
predeterminado: "automático"- El modo de subprocesos que se usará para la recuperación del repositorio. Si se configura en “off”, no se usa ningún subproceso de trabajo y la recuperación del repositorio está sujeta a reinicios. De lo contrario, utiliza un subproceso de plataforma (es decir, un subproceso del SO) si está configurado como "platform". o un subproceso virtual si está configurado como “virtual”. Si se configura como "auto", se usan subprocesos virtuales si están disponibles (es decir, cuando se ejecutan en JDK 21+). De lo contrario, no se utiliza ningún subproceso de trabajador.
- Otras opciones, que no se categorizan de ninguna otra manera:
- Se acumulan
--deleted_packages=<comma-separated list of package names>
usos múltiples - Una lista separada por comas de los nombres de los paquetes que el sistema de compilación considerará inexistentes, incluso si están visibles en alguna parte de la ruta del paquete. Usa esta opción cuando borres un subpaquete "x/y" de un paquete 'x' existente. Por ejemplo, después de borrar x/y/BUILD en tu cliente, el sistema de compilación puede presentar un reclamo si encuentra la etiqueta “//x:y/z”. si aún lo proporciona otra entrada package_path. Especificar --deleted_packages x/y evita este problema.
- Valor predeterminado de
--[no]fetch
: "true" - Permite que el comando recupere dependencias externas. Si se configura 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 dada es una ruta de acceso absoluta, se usará tal como es. Si la ruta de acceso determinada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso dada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace"
--package_path=<colon-separated list of options>
predeterminado: “%workspace%”- Una lista separada por dos puntos de dónde buscar paquetes Elementos que comienzan con “%workspace%” están relacionadas con el espacio de trabajo que los contiene. Si se omite o está vacío, el valor predeterminado es el resultado de “bazel info default-package-path”.
- Valor predeterminado de
--[no]show_loading_progress
: "true" - Si se habilita, hace que Bazel imprima el mensaje "Loading package:" (Cargando paquete): mensajes nuevos.
Opciones de limpieza
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Lugares adicionales para buscar archivos antes de acceder a la red y descargarlos.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]experimental_repository_cache_hardlinks
: "falso" -
Si se configura, la caché del repositorio vinculará el archivo en lugar de copiarlo en caso de que se produzca un acierto de caché. Esto está diseñado para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--experimental_repository_downloader_retries=<an integer>
: "0" -
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
valor predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark según este factor. De esta manera, los repositorios externos pueden funcionar en máquinas más lentas de lo esperado por el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
yexperimental
- Valor predeterminado de
--http_connector_attempts=<an integer>
: "8" -
La cantidad máxima de intentos para descargas http.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--http_connector_retry_max_timeout=<An immutable length of time.>
: "0s" -
El tiempo de espera máximo para los reintentos de descarga de HTTP. Con un valor de 0, no se define ningún tiempo de espera máximo.
Etiquetas:bazel_internal_configuration
--http_timeout_scaling=<a double>
valor predeterminado: "1.0"-
Escalar todos los tiempos de espera relacionados con las descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación de caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché; de lo contrario, el valor predeterminado es '<output_user_root>/cache/repos/v1'. se usa
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]repository_disable_download
: "falso" -
Si se configura, no se permite la descarga con ctx.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no está completamente inhabilitado. ctx.execute aún podría ejecutar un ejecutable arbitrario que acceda a Internet.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de compilación:
- Valor predeterminado de
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
El porcentaje del espacio permanente ocupado (0-100) por encima del cual GcThrashingDetector considera eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, GcThrashingDetector está inhabilitado.
Etiquetas:host_machine_resource_optimizations
- Opciones que controlan el resultado del comando:
- Valor predeterminado de
--[no]async
: "falso" -
Si es verdadero, la limpieza de resultados es asíncrona. Cuando se complete este comando, será seguro ejecutar comandos nuevos en el mismo cliente, aunque la eliminación pueda continuar en segundo plano.
Etiquetas:host_machine_resource_optimizations
- Valor predeterminado de
--[no]expunge
: "falso" -
Si es verdadero, clean quita todo el árbol de trabajo de esta instancia de Bazel, que incluye todos los archivos de salida temporales y de compilación creados por Bazel, y detiene el servidor de Bazel si se está ejecutando.
Etiquetas:host_machine_resource_optimizations
--expunge_async
-
Si se especifica, clean quita de forma asíncrona todo el árbol de trabajo para esta instancia de Bazel, que incluye todos los archivos de salida temporales y de compilación creados por Bazel, y detiene el servidor de Bazel si se está ejecutando. Cuando se complete este comando, será seguro ejecutar comandos nuevos en el mismo cliente, aunque la eliminación pueda continuar en segundo plano.
Se expande a:
--expunge
--async
Etiquetas:host_machine_resource_optimizations
- Opciones relacionadas con la salida y la semántica de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Se especificaron las versiones de los módulos con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resueltas, incluso si se declaran como eliminadas en el registro del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones rechazadas harán que la resolución falle. También puedes definir la versión generada permitida con la variable de entorno `BZLMOD_ALLOW_YANKED_VERSIONS`. Puedes inhabilitar esta verificación con la palabra clave “todo” (no se recomienda).
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
: "error" -
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivar el caso a una falla de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecta una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas de `bazel_dep` declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]ignore_dev_dependency
: "falso" -
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--lockfile_mode=<off, update or error>
: "actualizar" -
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "error" para usar el archivo de bloqueo, pero arroja un error si no está actualizado, o "off" para que no se lea ni escriba en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <module name>=<path>. Si la ruta de acceso dada es una ruta de acceso absoluta, se usará tal como es. Si la ruta de acceso determinada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso dada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace"
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en registros anteriores y solo se recurrirán a los registros posteriores cuando falten en los registros anteriores.
Etiquetas:changes_inputs
- Valor predeterminado de
--vendor_dir=<a path>
: ver descripción -
Especifica el directorio que debe almacenar los repositorios externos en modo de proveedor, ya sea para recuperarlos o usarlos durante la compilación. La ruta 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 bloquee Bazel con una OOM. Cada límite se especifica como <period>:<count> En el ejemplo anterior, el período es una duración y el recuento es un número entero positivo. Si hay más de --gc_thrashing_threshold por ciento de espacio titular (montón de generación anterior) permanece ocupado después de <count> varias recolecciones de elementos no utilizados consecutivas dentro de <period>, se activará una OOM. Si hay varios límites, puedes separarlos por comas.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: “2147483647”-
Marca de configuración avanzada del motor interno Skyframe de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de recolección de elementos no utilizados completa, eliminará el estado temporal de Skyframe innecesario, hasta esta cantidad de veces por invocación. La configuración predeterminada es Integer.MAX_VALUE; eficazmente ilimitados. Cero significa que los eventos de recolección de elementos no utilizados completas nunca activarán la acción de soltar. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC completo y se supere ese umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: “2147483647”-
Marca de configuración avanzada del motor interno Skyframe de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando ocurra un evento menor de recolección de elementos no utilizados, se eliminará el estado temporal de Skyframe innecesario, hasta esta cantidad de veces por invocación. La configuración predeterminada es Integer.MAX_VALUE; eficazmente ilimitados. Cero significa que los eventos menores de recolección de elementos no utilizados nunca activarán la acción de soltar. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC menor y se supere ese umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
- Valor predeterminado de
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
Marca de configuración avanzada del motor interno Skyframe de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es al menos este umbral, descartará el estado temporal de Skyframe innecesario. Ajustar esto puede permitirte mitigar el impacto en el tiempo de la hiperpaginación de GC cuando la hiperpaginación de GC (i) es causada por el uso de memoria de este estado temporal y (ii) es más costosa que reconstituir el estado cuando sea necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Valor predeterminado de
--experimental_command_profile=<cpu, wall, alloc or lock>
: ver descripción - Registra un perfil de la grabadora de vuelos de Java mientras dure el comando. Se debe proporcionar uno de los tipos de eventos de generación de perfiles admitidos (CPU, muro, asignación 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 la semántica de esta marca podrían cambiar en el futuro para admitir tipos de perfil o formatos de salida adicionales. usar bajo tu propia responsabilidad.
- Valor predeterminado de
--[no]experimental_record_metrics_for_all_mnemonics
: "falso" - De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemónicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán las estadísticas de todos los mnemónicos.
- Opciones que especifican o modifican una entrada genérica para un comando de Bazel que no se encuentra en otras categorías:
- Valor predeterminado de
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remoto:
- Valor predeterminado de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo con el que se configurará el cargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno que debe coincidir y otro para usar como URL sustituta, con referencias inversas a partir de `$1`. Es posible proporcionar varias directivas "rewrite" para la misma URL; en este caso, se devolverán varias URL.
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
predeterminado: "automático"- El modo de subprocesos que se usará para la recuperación del repositorio. Si se configura en “off”, no se usa ningún subproceso de trabajo y la recuperación del repositorio está sujeta a reinicios. De lo contrario, utiliza un subproceso de plataforma (es decir, un subproceso del SO) si está configurado como "platform". o un subproceso virtual si está configurado como “virtual”. Si se configura como "auto", se usan subprocesos virtuales si están disponibles (es decir, cuando se ejecutan en JDK 21+). De lo contrario, no se utiliza ningún subproceso de trabajador.
- Otras opciones, que no se categorizan de ninguna otra manera:
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso dada es una ruta de acceso absoluta, se usará tal como es. Si la ruta de acceso determinada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso dada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace"
Opciones de configuración
Opciones de cobertura
Hereda todas las opciones de test.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Lugares adicionales para buscar archivos antes de acceder a la red y descargarlos.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]experimental_repository_cache_hardlinks
: "falso" -
Si se configura, la caché del repositorio vinculará el archivo en lugar de copiarlo en caso de que se produzca un acierto de caché. Esto está diseñado para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--experimental_repository_downloader_retries=<an integer>
: "0" -
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
valor predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark según este factor. De esta manera, los repositorios externos pueden funcionar en máquinas más lentas de lo esperado por el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
yexperimental
- Valor predeterminado de
--http_connector_attempts=<an integer>
: "8" -
La cantidad máxima de intentos para descargas http.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--http_connector_retry_max_timeout=<An immutable length of time.>
: "0s" -
El tiempo de espera máximo para los reintentos de descarga de HTTP. Con un valor de 0, no se define ningún tiempo de espera máximo.
Etiquetas:bazel_internal_configuration
--http_timeout_scaling=<a double>
valor predeterminado: "1.0"-
Escalar todos los tiempos de espera relacionados con las descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación de caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché; de lo contrario, el valor predeterminado es '<output_user_root>/cache/repos/v1'. se usa
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]repository_disable_download
: "falso" -
Si se configura, no se permite la descarga con ctx.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no está completamente inhabilitado. ctx.execute aún podría ejecutar un ejecutable arbitrario que acceda a Internet.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de compilación:
- Valor predeterminado de
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
El porcentaje del espacio permanente ocupado (0-100) por encima del cual GcThrashingDetector considera eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, GcThrashingDetector está inhabilitado.
Etiquetas:host_machine_resource_optimizations
- Opciones relacionadas con la salida y la semántica de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Se especificaron las versiones de los módulos con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resueltas, incluso si se declaran como eliminadas en el registro del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones rechazadas harán que la resolución falle. También puedes definir la versión generada permitida con la variable de entorno `BZLMOD_ALLOW_YANKED_VERSIONS`. Puedes inhabilitar esta verificación con la palabra clave “todo” (no se recomienda).
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
: "error" -
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivar el caso a una falla de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecta una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas de `bazel_dep` declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]ignore_dev_dependency
: "falso" -
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--lockfile_mode=<off, update or error>
: "actualizar" -
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "error" para usar el archivo de bloqueo, pero arroja un error si no está actualizado, o "off" para que no se lea ni escriba en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <module name>=<path>. Si la ruta de acceso dada es una ruta de acceso absoluta, se usará tal como es. Si la ruta de acceso determinada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso dada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace"
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en registros anteriores y solo se recurrirán a los registros posteriores cuando falten en los registros anteriores.
Etiquetas:changes_inputs
- Valor predeterminado de
--vendor_dir=<a path>
: ver descripción -
Especifica el directorio que debe almacenar los repositorios externos en modo de proveedor, ya sea para recuperarlos o usarlos durante la compilación. La ruta 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 bloquee Bazel con una OOM. Cada límite se especifica como <period>:<count> En el ejemplo anterior, el período es una duración y el recuento es un número entero positivo. Si hay más de --gc_thrashing_threshold por ciento de espacio titular (montón de generación anterior) permanece ocupado después de <count> varias recolecciones de elementos no utilizados consecutivas dentro de <period>, se activará una OOM. Si hay varios límites, puedes separarlos por comas.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: “2147483647”-
Marca de configuración avanzada del motor interno Skyframe de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de recolección de elementos no utilizados completa, eliminará el estado temporal de Skyframe innecesario, hasta esta cantidad de veces por invocación. La configuración predeterminada es Integer.MAX_VALUE; eficazmente ilimitados. Cero significa que los eventos de recolección de elementos no utilizados completas nunca activarán la acción de soltar. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC completo y se supere ese umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: “2147483647”-
Marca de configuración avanzada del motor interno Skyframe de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando ocurra un evento menor de recolección de elementos no utilizados, se eliminará el estado temporal de Skyframe innecesario, hasta esta cantidad de veces por invocación. La configuración predeterminada es Integer.MAX_VALUE; eficazmente ilimitados. Cero significa que los eventos menores de recolección de elementos no utilizados nunca activarán la acción de soltar. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC menor y se supere ese umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
- Valor predeterminado de
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
Marca de configuración avanzada del motor interno Skyframe de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es al menos este umbral, descartará el estado temporal de Skyframe innecesario. Ajustar esto puede permitirte mitigar el impacto en el tiempo de la hiperpaginación de GC cuando la hiperpaginación de GC (i) es causada por el uso de memoria de este estado temporal y (ii) es más costosa que reconstituir el estado cuando sea necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Valor predeterminado de
--experimental_command_profile=<cpu, wall, alloc or lock>
: ver descripción - Registra un perfil de la grabadora de vuelos de Java mientras dure el comando. Se debe proporcionar uno de los tipos de eventos de generación de perfiles admitidos (CPU, muro, asignación 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 la semántica de esta marca podrían cambiar en el futuro para admitir tipos de perfil o formatos de salida adicionales. usar bajo tu propia responsabilidad.
- Valor predeterminado de
--[no]experimental_record_metrics_for_all_mnemonics
: "falso" - De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemónicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán las estadísticas de todos los mnemónicos.
- Opciones que especifican o modifican una entrada genérica para un comando de Bazel que no se encuentra en otras categorías:
- Valor predeterminado de
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remoto:
- Valor predeterminado de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo con el que se configurará el cargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno que debe coincidir y otro para usar como URL sustituta, con referencias inversas a partir de `$1`. Es posible proporcionar varias directivas "rewrite" para la misma URL; en este caso, se devolverán varias URL.
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
predeterminado: "automático"- El modo de subprocesos que se usará para la recuperación del repositorio. Si se configura en “off”, no se usa ningún subproceso de trabajo y la recuperación del repositorio está sujeta a reinicios. De lo contrario, utiliza un subproceso de plataforma (es decir, un subproceso del SO) si está configurado como "platform". o un subproceso virtual si está configurado como “virtual”. Si se configura como "auto", se usan subprocesos virtuales si están disponibles (es decir, cuando se ejecutan en JDK 21+). De lo contrario, no se utiliza ningún subproceso de trabajador.
- Otras opciones, que no se categorizan de ninguna otra manera:
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso dada es una ruta de acceso absoluta, se usará tal como es. Si la ruta de acceso determinada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso dada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace"
Opciones de Cquery
Hereda todas las opciones de test.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Lugares adicionales para buscar archivos antes de acceder a la red y descargarlos.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]experimental_repository_cache_hardlinks
: "falso" -
Si se configura, la caché del repositorio vinculará el archivo en lugar de copiarlo en caso de que se produzca un acierto de caché. Esto está diseñado para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--experimental_repository_downloader_retries=<an integer>
: "0" -
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
valor predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark según este factor. De esta manera, los repositorios externos pueden funcionar en máquinas más lentas de lo esperado por el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
yexperimental
- Valor predeterminado de
--http_connector_attempts=<an integer>
: "8" -
La cantidad máxima de intentos para descargas http.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--http_connector_retry_max_timeout=<An immutable length of time.>
: "0s" -
El tiempo de espera máximo para los reintentos de descarga de HTTP. Con un valor de 0, no se define ningún tiempo de espera máximo.
Etiquetas:bazel_internal_configuration
--http_timeout_scaling=<a double>
valor predeterminado: "1.0"-
Escalar todos los tiempos de espera relacionados con las descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación de caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché; de lo contrario, el valor predeterminado es '<output_user_root>/cache/repos/v1'. se usa
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]repository_disable_download
: "falso" -
Si se configura, no se permite la descarga con ctx.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no está completamente inhabilitado. ctx.execute aún podría ejecutar un ejecutable arbitrario que acceda a Internet.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de compilación:
- Valor predeterminado de
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
El porcentaje del espacio permanente ocupado (0-100) por encima del cual GcThrashingDetector considera eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, GcThrashingDetector está inhabilitado.
Etiquetas:host_machine_resource_optimizations
- Opciones relacionadas con el resultado de la consulta y la semántica:
--aspect_deps=<off, conservative or precise>
predeterminado: “conservadora”-
Cómo resolver dependencias de aspecto cuando el formato de salida es {xml,proto,record}. "desactivado" significa que no se resuelven dependencias de aspecto, “conservadora” (predeterminado) significa que todas las dependencias de aspecto declaradas se agregan independientemente de si se les da la clase de regla de dependencias directas, “precisa”. significa que solo se agregan los aspectos que posiblemente estén activos dada la clase de regla de las dependencias directas. Ten en cuenta que el modo preciso requiere cargar otros paquetes para evaluar un solo objetivo, lo que lo hace más lento que los otros modos. Además, ten en cuenta que incluso el modo preciso no es del todo preciso: la decisión de calcular un aspecto se decide en la fase de análisis, que no se ejecuta durante la “consulta de Bazel”.
Etiquetas:build_file_semantics
- Valor predeterminado de
--[no]consistent_labels
: "falso" -
Si se habilita, cada comando de consulta emite etiquetas como si <code>str</code> de Starlark función aplicada a una <code>etiqueta</code> instancia. Esto resulta útil para las herramientas que necesitan hacer coincidir el resultado de diferentes comandos de consulta o etiquetas emitidas por las reglas. Si no se habilita, los formateadores de salida pueden emitir nombres de repositorio aparentes (en relación con el repositorio principal) en lugar de hacer que el resultado sea más legible.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]experimental_explicit_aspects
: "falso" -
aquery, cquery: Se incluyen acciones generadas por aspectos en el resultado. consulta: no-op (siempre se siguen los aspectos).
Etiquetas:terminal_output
- Valor predeterminado de
--[no]graph:factored
: "true" -
Si es verdadero, el grafo se emitirá “factorizado”, es decir, los nodos topológicamente equivalentes se combinarán y sus etiquetas se concatenarán. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--graph:node_limit=<an integer>
predeterminado: "512"-
La longitud máxima de la cadena de etiqueta para un nodo del grafo en el resultado. Las etiquetas más largas se truncarán. -1 significa que no hay truncamiento. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]implicit_deps
: "true" -
Si se habilita, las dependencias implícitas se incluirán en el gráfico de dependencias sobre el que opera la consulta. Una dependencia implícita es una que no se especifica de forma explícita en el archivo BUILD, pero la agrega Bazel. En el caso de cquery, esta opción controla el filtrado de cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
- Valor predeterminado de
--[no]include_aspects
: "true" -
aquery, cquery: Se incluyen acciones generadas por aspectos en el resultado. consulta: no-op (siempre se siguen los aspectos).
Etiquetas:terminal_output
- Valor predeterminado de
--[no]incompatible_package_group_includes_double_slash
: "true" -
Si se habilita esta opción, cuando se genere el atributo `packages` de package_group, no se omitirá el `//` inicial.
Etiquetas:terminal_output
yincompatible_change
- Valor predeterminado de
--[no]infer_universe_scope
: "falso" -
Si no se establece ni --universe_scope, se inferirá un valor de --universe_scope como la lista de patrones de destino únicos en la expresión de consulta. Ten en cuenta que es posible que el valor --universe_scope inferido para una expresión de consulta que usa funciones con alcance universal (p.ej., `allrdeps`) no sea lo que quieres, por lo que debes usar esta opción solo si sabes lo que estás haciendo. Consulta https://bazel.build/reference/query#sky-query para obtener detalles y ejemplos. Si se configura --universe_scope, se ignora el valor de esta opción. Nota: Esta opción solo se aplica a “query” (es decir, no a “cquery”).
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]line_terminator_null
: "falso" -
Indica si cada formato termina con \0 en lugar de un salto de línea.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]nodep_deps
: "true" -
Si está habilitada, las dependencias de “nodep” atributos se incluirán en el gráfico de la dependencia en el que opera la consulta. Un ejemplo común de un “nodep” es “visibilidad”. Ejecuta y analiza el resultado de `info build-language` para conocer todos los “nodep” atributos en el lenguaje de compilación.
Etiquetas:build_file_semantics
--output=<a string>
predeterminado: "etiqueta"-
El formato en el que se deben imprimir los resultados de cquery. Los valores permitidos para cquery son los siguientes: label, label_kind, textproto, transactions, proto, streaming_proto y jsonproto. Si seleccionas "transiciones", también debes especificar la opción --transitions=(lite|full).
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:default_values
: "true" -
Si es verdadero, se incluirán los atributos cuyo valor no se especifica explícitamente en el archivo BUILD. de lo contrario, se omitirán. Esta opción se aplica a --output=proto
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:definition_stack
: "falso" -
Propaga el campo de proto definition_stack, que registra la pila de llamadas de Starlark para cada instancia de la regla en el momento en que se definió la clase de la regla.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:flatten_selects
: "true" -
Si se habilita, se acoplan los atributos configurables creados por select(). Para los tipos de lista, la representación plana es una lista que contiene cada valor del mapa de selección exactamente una vez. Los tipos escalares se acoplan a nulos.
Etiquetas:build_file_semantics
- Valor predeterminado de
--[no]proto:include_attribute_source_aspects
: "falso" -
Propaga el campo de protocolo source_aspect_name de cada atributo con el aspecto de origen del que provino (cadena vacía si no es así).
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:include_configurations
: "true" -
si está habilitado, el resultado del protocolo incluirá información sobre la configuración. Cuando está inhabilitado,el formato de salida de cquery proto se asemeja al formato de salida de la consulta.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]proto:include_synthetic_attribute_hash
: "falso" -
Indica si se debe calcular y propagar el atributo $internal_attr_hash.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:instantiation_stack
: "falso" -
Propaga la pila de llamadas de creación de instancias de cada regla. Ten en cuenta que esto requiere que la pila esté presente
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:locations
: "true" -
Establece si se debe emitir información de ubicación en el resultado de proto.
Etiquetas:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
predeterminado: "todos"-
Lista de atributos separados por comas para incluir en el resultado. La configuración predeterminada es todos los atributos. Si la estableces como una string vacía, no se generará ningún atributo. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:rule_inputs_and_outputs
: "true" -
Indica si se deben completar o no los campos rule_input y rule_output.
Etiquetas:terminal_output
- Valor predeterminado de
--query_file=<a string>
: "" -
Si se configura, la consulta leerá la consulta desde el archivo que se nombra aquí, en lugar de hacerlo en la línea de comandos. Es un error especificar aquí un archivo así como una consulta de línea de comandos.
Etiquetas:changes_inputs
- Valor predeterminado de
--[no]relative_locations
: "falso" -
Si es verdadero, la ubicación de los archivos Build en los resultados xml y proto será relativa. De forma predeterminada, el resultado de la ubicación es una ruta de acceso absoluta y no será coherente en todas las máquinas. Puedes configurar esta opción como verdadera para obtener un resultado coherente en todas las máquinas.
Etiquetas:terminal_output
- Configuración predeterminada de
--show_config_fragments=<off, direct or transitive>
: "desactivada" -
Muestra los fragmentos de configuración que requiere una regla y sus dependencias transitivas. Esto puede ser útil para evaluar cuánto se puede recortar un gráfico de destino configurado.
Etiquetas:affects_outputs
- Valor predeterminado de
--starlark:expr=<a string>
: "" -
Una expresión de Starlark para dar formato a cada destino configurado en el modo --output=starlark de cquery. El destino configurado está vinculado a "target". Si no se especifica --starlark:expr ni --starlark:file, la opción predeterminada será 'str(target.label)'. Es un error especificar --starlark:expr y --starlark:file.
Etiquetas:terminal_output
- Valor predeterminado de
--starlark:file=<a string>
: "" -
El nombre de un archivo que define una función de Starlark llamada "format", de un argumento, que se aplica a cada destino configurado para darle formato como una cadena. Es un error especificar --starlark:expr y --starlark:file. Consulta la ayuda de --output=starlark para obtener más detalles.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]tool_deps
: "true" -
Consulta: Si está inhabilitada, depende de “exec configuration” no se incluirán en el gráfico de la dependencia en el que opera la consulta. Una “configuración de ejecución” perímetro de dependencia, como el de cualquier "proto_library" al compilador de protocolos, por lo general, apunta a una herramienta ejecutada durante la compilación en lugar de a una parte del mismo “destino” .
Cquery: Si se inhabilita, filtra todos los destinos configurados que cruzan una transición de ejecución del objetivo de nivel superior que descubrió este objetivo configurado. Esto significa que, si el destino de nivel superior se encuentra en la configuración de destino, solo se mostrarán los destinos configurados que se encuentren también en esa configuración. Si el destino de nivel superior está en la configuración de ejecución, solo se mostrarán los destinos configurados de ejecución. Esta opción NO excluirá las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
- Valor predeterminado de
--transitions=<full, lite or none>
: "ninguno" -
El formato en el que cquery imprimirá la información de transición.
Etiquetas:affects_outputs
- Valor predeterminado de
--universe_scope=<comma-separated list of options>
: "" -
Un conjunto de patrones de destino separados por comas (aditivos y sustractivos). La consulta puede realizarse en el universo definido por el cierre transitivo de los objetivos especificados. Esta opción se usa para los comandos de consulta y cquery.
Para cquery, la entrada de esta opción son los destinos en los que se crean todas las respuestas, por lo que esta opción puede afectar las configuraciones y transiciones. Si no se especifica esta opción, se supone que los objetivos de nivel superior son los objetivos analizados de la expresión de consulta. Nota: Para cquery, no especificar esta opción puede hacer que la compilación se rompa si los objetivos analizados desde la expresión de consulta no se pueden compilar con las opciones de nivel superior.
Etiquetas:loading_and_analysis
- Opciones relacionadas con la salida y la semántica de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Se especificaron las versiones de los módulos con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resueltas, incluso si se declaran como eliminadas en el registro del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones rechazadas harán que la resolución falle. También puedes definir la versión generada permitida con la variable de entorno `BZLMOD_ALLOW_YANKED_VERSIONS`. Puedes inhabilitar esta verificación con la palabra clave “todo” (no se recomienda).
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
: "error" -
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivar el caso a una falla de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecta una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas de `bazel_dep` declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]ignore_dev_dependency
: "falso" -
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--lockfile_mode=<off, update or error>
: "actualizar" -
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "error" para usar el archivo de bloqueo, pero arroja un error si no está actualizado, o "off" para que no se lea ni escriba en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <module name>=<path>. Si la ruta de acceso dada es una ruta de acceso absoluta, se usará tal como es. Si la ruta de acceso determinada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso dada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace"
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en registros anteriores y solo se recurrirán a los registros posteriores cuando falten en los registros anteriores.
Etiquetas:changes_inputs
- Valor predeterminado de
--vendor_dir=<a path>
: ver descripción -
Especifica el directorio que debe almacenar los repositorios externos en modo de proveedor, ya sea para recuperarlos o usarlos durante la compilación. La ruta 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 bloquee Bazel con una OOM. Cada límite se especifica como <period>:<count> En el ejemplo anterior, el período es una duración y el recuento es un número entero positivo. Si hay más de --gc_thrashing_threshold por ciento de espacio titular (montón de generación anterior) permanece ocupado después de <count> varias recolecciones de elementos no utilizados consecutivas dentro de <period>, se activará una OOM. Si hay varios límites, puedes separarlos por comas.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: “2147483647”-
Marca de configuración avanzada del motor interno Skyframe de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de recolección de elementos no utilizados completa, eliminará el estado temporal de Skyframe innecesario, hasta esta cantidad de veces por invocación. La configuración predeterminada es Integer.MAX_VALUE; eficazmente ilimitados. Cero significa que los eventos de recolección de elementos no utilizados completas nunca activarán la acción de soltar. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC completo y se supere ese umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: “2147483647”-
Marca de configuración avanzada del motor interno Skyframe de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando ocurra un evento menor de recolección de elementos no utilizados, se eliminará el estado temporal de Skyframe innecesario, hasta esta cantidad de veces por invocación. La configuración predeterminada es Integer.MAX_VALUE; eficazmente ilimitados. Cero significa que los eventos menores de recolección de elementos no utilizados nunca activarán la acción de soltar. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC menor y se supere ese umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
- Valor predeterminado de
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
Marca de configuración avanzada del motor interno Skyframe de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es al menos este umbral, descartará el estado temporal de Skyframe innecesario. Ajustar esto puede permitirte mitigar el impacto en el tiempo de la hiperpaginación de GC cuando la hiperpaginación de GC (i) es causada por el uso de memoria de este estado temporal y (ii) es más costosa que reconstituir el estado cuando sea necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Valor predeterminado de
--experimental_command_profile=<cpu, wall, alloc or lock>
: ver descripción - Registra un perfil de la grabadora de vuelos de Java mientras dure el comando. Se debe proporcionar uno de los tipos de eventos de generación de perfiles admitidos (CPU, muro, asignación 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 la semántica de esta marca podrían cambiar en el futuro para admitir tipos de perfil o formatos de salida adicionales. usar bajo tu propia responsabilidad.
- Valor predeterminado de
--[no]experimental_record_metrics_for_all_mnemonics
: "falso" - De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemónicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán las estadísticas de todos los mnemónicos.
- Opciones que especifican o modifican una entrada genérica para un comando de Bazel que no se encuentra en otras categorías:
- Valor predeterminado de
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remoto:
- Valor predeterminado de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo con el que se configurará el cargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno que debe coincidir y otro para usar como URL sustituta, con referencias inversas a partir de `$1`. Es posible proporcionar varias directivas "rewrite" para la misma URL; en este caso, se devolverán varias URL.
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
predeterminado: "automático"- El modo de subprocesos que se usará para la recuperación del repositorio. Si se configura en “off”, no se usa ningún subproceso de trabajo y la recuperación del repositorio está sujeta a reinicios. De lo contrario, utiliza un subproceso de plataforma (es decir, un subproceso del SO) si está configurado como "platform". o un subproceso virtual si está configurado como “virtual”. Si se configura como "auto", se usan subprocesos virtuales si están disponibles (es decir, cuando se ejecutan en JDK 21+). De lo contrario, no se utiliza ningún subproceso de trabajador.
- Otras opciones, que no se categorizan de ninguna otra manera:
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso dada es una ruta de acceso absoluta, se usará tal como es. Si la ruta de acceso determinada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso dada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace"
- Opciones que controlan la ejecución de compilación:
- Valor predeterminado de
--[no]experimental_inprocess_symlink_creation
: "falso" -
Especifica si se deben realizar llamadas directas al sistema de archivos para crear árboles de symlinks.
Etiquetas:loading_and_analysis
,execution
yexperimental
- Valor predeterminado de
--[no]experimental_persistent_aar_extractor
: "falso" -
Habilita el extractor de aar persistente con trabajadores.
Etiquetas:execution
- Valor predeterminado de
--[no]experimental_remotable_source_manifests
: "falso" -
Establece si las acciones del manifiesto de la fuente se pueden usar de forma remota.
Etiquetas:loading_and_analysis
,execution
yexperimental
- Valor predeterminado de
--[no]experimental_split_coverage_postprocessing
: "falso" -
Si es verdadero, Bazel ejecutará el procesamiento posterior de cobertura para realizar pruebas en un generación nuevo.
Etiquetas:execution
- Valor predeterminado de
--[no]experimental_strict_fileset_output
: "falso" -
Si se habilita esta opción, los conjuntos de archivos tratarán todos los artefactos de salida como archivos normales. No desviarán directorios ni serán sensibles a los symlinks.
Etiquetas:execution
- Valor predeterminado de
--[no]incompatible_disallow_unsound_directory_outputs
: "true" -
Si se configura, es un error que una acción materialice un archivo de salida como un directorio. No afecta a los directorios de origen. Consulta https://github.com/bazelbuild/bazel/issues/18646.
Etiquetas:bazel_internal_configuration
yincompatible_change
- Valor predeterminado de
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
: "" -
Agrega o quita teclas de la información de ejecución de una acción según el nombre nemotécnico de la acción. Solo se aplica a las acciones que admiten información de ejecución. Muchas acciones comunes admiten información de ejecución, p.ej., Genrule, CppCompile, Javac, StarlarkAction y TestRunner. Cuando se especifican varios valores, el orden es importante porque muchas regex pueden aplicarse al mismo nombre nemotécnico.
Sintaxis: “regex=[+-]key,regex=[+-]key,...”.
Ejemplos:
'.*=+x,.*=-y,.*=+z' agrega una 'x' y en "z" a y quita "y" de la información de ejecución de todas las acciones.
'Genrule=+requires-x' agrega “requiere-x” a la información de ejecución de todas las acciones de Genrule.
“(?!Genrule).*=-required-x” quita “requiere-x” a partir de la información de ejecución
para todas las acciones que no son de Genrule.
Etiquetas:execution
,affects_outputs
yloading_and_analysis
--persistent_android_dex_desugar
-
Habilita acciones persistentes de dex y expansión de sintaxis de Android mediante trabajadores.
Se expande a:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Etiquetas:host_machine_resource_optimizations
yexecution
--persistent_android_resource_processor
-
Habilita el procesador de recursos persistente de Android con trabajadores.
Se expande a:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
de--strategy=AndroidResourceMerger=worker
de--strategy=AndroidCompiledResourceMerger=worker
de--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
de--strategy=AARGenerator=worker
de--strategy=ProcessDatabinding=worker
de--strategy=GenerateDataBindingBaseClasses=worker
Etiquetas:host_machine_resource_optimizations
yexecution
--persistent_multiplex_android_dex_desugar
-
Habilita acciones persistentes de dex y desugar de Android multiplexadas usando trabajadores.
Se expande a:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
Etiquetas:host_machine_resource_optimizations
yexecution
--persistent_multiplex_android_resource_processor
-
Habilita el procesador de recursos multiplexados de Android persistente con trabajadores.
Se expande a:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
de--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
de--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
de--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
de--modify_execution_info=AARGenerator=+supports-multiplex-workers
Etiquetas:host_machine_resource_optimizations
yexecution
--persistent_multiplex_android_tools
-
Habilita herramientas de Android persistentes y multiplexadas (dexing, expansión de sintaxis y procesamiento de recursos).
Se expande a:
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Etiquetas:host_machine_resource_optimizations
yexecution
- Valor predeterminado de
--[no]use_target_platform_for_tests
: "falso" -
Si es verdadero, Bazel usará la plataforma de destino para ejecutar pruebas en lugar del grupo de ejecución de pruebas.
Etiquetas:execution
- Opciones que configuran la cadena de herramientas utilizada para la ejecución de la acción:
- Valor predeterminado de
--android_compiler=<a string>
: ver descripción -
El compilador de destino de Android.
Etiquetas:affects_outputs
,loading_and_analysis
yloses_incremental_state
--android_crosstool_top=<a build target label>
predeterminado: "//external:android/crosstool"-
La ubicación del compilador C++ que se usa para las compilaciones de Android.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
yloses_incremental_state
- Valor predeterminado de
--android_grte_top=<a label>
: ver descripción -
El objetivo de Android grte_top.
Etiquetas:changes_inputs
,loading_and_analysis
yloses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
predeterminado: "android"-
Selecciona la combinación de manifiestos que se usará para las reglas android_binary. Marca para ayudar a la transición de la combinación de manifiestos de Android desde la combinación heredada.
Etiquetas:affects_outputs
,loading_and_analysis
yloses_incremental_state
- Valor predeterminado de
--android_platforms=<a build target label>
: "" -
Establece las plataformas que usan los objetivos android_binary. Si se especifican varias plataformas, el objeto binario es un APK multiarquitectura, que contiene binarios nativos para cada plataforma de destino especificada.
Etiquetas:changes_inputs
,loading_and_analysis
yloses_incremental_state
--android_sdk=<a build target label>
predeterminado: "@bazel_tools//tools/android:sdk"-
Especifica el SDK o la plataforma de Android que se usa para compilar aplicaciones para Android.
Etiquetas:changes_inputs
,loading_and_analysis
yloses_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
ychanges_inputs
- Valor predeterminado de
--cc_output_directory_tag=<a string>
: "" -
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas:affects_outputs
- Valor predeterminado de
--compiler=<a string>
: ver descripción -
El compilador de C++ que se usará para compilar el destino.
Etiquetas:loading_and_analysis
yexecution
--coverage_output_generator=<a build target label>
predeterminado: "@bazel_tools//tools/test:lcov_merger"-
Ubicación del objeto binario que se usa para procesar posteriormente los informes de cobertura sin procesar. Actualmente, debe ser un grupo de archivos que contenga un solo archivo: el objeto binario. La configuración predeterminada es “//tools/test:lcov_merger”.
Etiquetas:changes_inputs
,affects_outputs
yloading_and_analysis
--coverage_report_generator=<a build target label>
predeterminado: “@bazel_tools//tools/test:coverage_report_generator”-
Ubicación del objeto binario que se usa para generar informes de cobertura. Actualmente, debe ser un grupo de archivos que contenga un solo archivo: el objeto binario. La configuración predeterminada es “//tools/test:coverage_report_generator”.
Etiquetas:changes_inputs
,affects_outputs
yloading_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
yloading_and_analysis
--crosstool_top=<a build target label>
predeterminado: “@bazel_tools//tools/cpp:toolchain”-
La etiqueta del paquete de herramientas cruzadas que se usará para compilar el código de C++.
Etiquetas:loading_and_analysis
,changes_inputs
yaffects_outputs
- Valor predeterminado de
--custom_malloc=<a build target label>
: ver descripción -
Especifica una implementación de malloc personalizada. Esta configuración anula los atributos malloc en las reglas de compilación.
Etiquetas:changes_inputs
yaffects_outputs
- Se acumulan
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
usos múltiples -
Lista de expresiones regulares separadas por comas, cada una con el prefijo - (expresión negativa) opcionalmente, asignadas (=) a una lista de objetivos de valores de restricción separados por comas. Si un objetivo no coincide con ninguna expresión negativa y al menos una expresión positiva, la resolución de la cadena de herramientas se realizará como si se hubieran declarado los valores de la restricción como restricciones de ejecución. Ejemplo: //demo,-test=@platforms//cpus:x86_64 agregará 'x86_64' a cualquier destino en //demo, excepto a aquellos cuyo nombre contenga “test”.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]experimental_include_xcode_execution_requirements
: "falso" -
Si está configurado, agrega un campo "requires-xcode:{version}". de ejecución requerido a cada acción de Xcode. Si la versión de Xcode tiene una etiqueta con guiones, agrega también la etiqueta “requires-xcode-label:{version_label}”. de ejecución.
Etiquetas:loses_incremental_state
,loading_and_analysis
yexecution
- Valor predeterminado de
--[no]experimental_prefer_mutual_xcode
: "true" -
Si es verdadero, usa el Xcode más reciente que está disponible de forma local y remota. Si es falso, o si no hay versiones mutuas disponibles, usa la versión de Xcode local seleccionada a través de xcode-select.
Etiquetas:loses_incremental_state
- Valor predeterminado de
--extra_execution_platforms=<comma-separated list of options>
: "" -
Son las plataformas que están disponibles como plataformas de ejecución para ejecutar acciones. Las plataformas se pueden especificar por objetivo exacto o como un patrón de objetivo. Estas plataformas se considerarán antes de las declaradas en el archivo WORKSPACE por register_execution_platforms(). Esta opción solo se puede configurar una vez. las instancias posteriores anularán la configuración de las marcas anteriores.
Etiquetas:execution
- Se acumulan
--extra_toolchains=<comma-separated list of options>
usos múltiples -
Las reglas de la cadena de herramientas que se deben considerar durante su resolución. Las cadenas de herramientas se pueden especificar por objetivo exacto o como un patrón de objetivo. Estas cadenas de herramientas se considerarán antes de las declaradas en el archivo WORKSPACE por register_toolchains().
Etiquetas:affects_outputs
,changes_inputs
yloading_and_analysis
- Valor predeterminado de
--grte_top=<a label>
: ver descripción -
Es una etiqueta para una biblioteca de libc abierta. La cadena de herramientas de crosstool selecciona el valor predeterminado, y casi nunca necesitas anularlo.
Etiquetas:action_command_lines
yaffects_outputs
- Valor predeterminado de
--host_compiler=<a string>
: ver descripción -
El compilador de C++ que se usará para la compilación del host. Se ignora si no se configura --host_crosstool_top.
Etiquetas:loading_and_analysis
yexecution
- Valor predeterminado de
--host_crosstool_top=<a build target label>
: ver descripción -
De forma predeterminada, las opciones --crosstool_top y --compiler también se usan para la configuración de ejecución. Si se proporciona este indicador, Bazel usa el compilador y la libc predeterminados para el crosstool_top específico.
Etiquetas:loading_and_analysis
,changes_inputs
yaffects_outputs
- Valor predeterminado de
--host_grte_top=<a label>
: ver descripción -
Si se especifica, esta configuración anula el directorio de nivel superior de libc (--grte_top) para la configuración de exec.
Etiquetas:action_command_lines
yaffects_outputs
--host_platform=<a build target label>
predeterminado: “@local_config_platform//:host”-
Es la etiqueta de una regla de la plataforma que describe el sistema host.
Etiquetas:affects_outputs
,changes_inputs
yloading_and_analysis
- Valor predeterminado de
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
: "true" -
Si es verdadero, Bazel no habilitará “host”. y “no host” de la cadena de herramientas de c++ (consulta https://github.com/bazelbuild/bazel/issues/7407 para obtener más información).
Etiquetas:loading_and_analysis
yincompatible_change
- Valor predeterminado de
--[no]incompatible_enable_android_toolchain_resolution
: "true" -
Usa la resolución de la cadena de herramientas para seleccionar el SDK de Android para las reglas de Android (Starlark y nativo)
Etiquetas:loading_and_analysis
yincompatible_change
- Valor predeterminado de
--[no]incompatible_enable_apple_toolchain_resolution
: "falso" -
Usa la resolución de la cadena de herramientas para seleccionar el SDK de Apple para las reglas de Apple (Starlark y nativo)
Etiquetas:loading_and_analysis
yincompatible_change
- Valor predeterminado de
--[no]incompatible_make_thinlto_command_lines_standalone
: "true" -
Si es verdadero, Bazel no reutilizará las líneas de comandos de acción de vínculo de C++ para las líneas de comandos de indexación lto (consulta https://github.com/bazelbuild/bazel/issues/6791 para obtener más información).
Etiquetas:loading_and_analysis
yincompatible_change
- Valor predeterminado de
--[no]incompatible_remove_legacy_whole_archive
: "true" -
Si es verdadero, Bazel no vinculará las dependencias de bibliotecas como archivos completos de forma predeterminada (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener instrucciones de migración).
Etiquetas:loading_and_analysis
yincompatible_change
- Valor predeterminado de
--[no]incompatible_require_ctx_in_configure_features
: "true" -
Si el valor es verdadero, Bazel requerirá "{4/}". en cc_common.configure_features (consulta https://github.com/bazelbuild/bazel/issues/7793 para obtener más información).
Etiquetas:loading_and_analysis
yincompatible_change
-
Usa objetos compartidos de la interfaz si la cadena de herramientas lo admite. Actualmente, todas las cadenas de herramientas ELF admiten esta configuración.
Etiquetas:loading_and_analysis
,affects_outputs
yaffects_outputs
- Valor predeterminado de
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Especifica la versión del SDK de iOS que se usará para compilar aplicaciones de iOS. Si no se especifica, usa la versión predeterminada del SDK de iOS de “xcode_version”.
Etiquetas:loses_incremental_state
- Valor predeterminado de
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Especifica la versión del SDK de macOS que se usará para compilar aplicaciones de macOS. Si no se especifica, se usa la versión predeterminada del SDK de macOS de “xcode_version”.
Etiquetas:loses_incremental_state
- Valor predeterminado de
--minimum_os_version=<a string>
: ver descripción -
La versión mínima del SO a la que se orienta tu compilación.
Etiquetas:loading_and_analysis
yaffects_outputs
- Valor predeterminado de
--platform_mappings=<a relative path>
: "" -
La ubicación de un archivo de asignación que describe qué plataforma usar si no hay ninguna establecida o qué marcas se deben configurar cuando ya existe una plataforma. Debe estar relacionada con la raíz principal del lugar de trabajo. La configuración predeterminada es “platform_mappings”. (un archivo directamente debajo de la raíz del espacio de trabajo).
Etiquetas:affects_outputs
,changes_inputs
yloading_and_analysis
- Valor predeterminado de
--platforms=<a build target label>
: "" -
Las etiquetas de las reglas de la plataforma que describen las plataformas de destino para el comando actual.
Etiquetas:affects_outputs
,changes_inputs
yloading_and_analysis
- Valor predeterminado de
--python2_path=<a string>
: ver descripción -
Obsoleto, no-op. Inhabilitado por `--incompatible_use_python_toolchains`.
Etiquetas:no_op
ydeprecated
- Valor predeterminado de
--python3_path=<a string>
: ver descripción -
Obsoleto, no-op. Inhabilitado por `--incompatible_use_python_toolchains`.
Etiquetas:no_op
ydeprecated
- Valor predeterminado de
--python_path=<a string>
: ver descripción -
La ruta de acceso absoluta del intérprete de Python invocado para ejecutar objetivos de Python en la plataforma de destino. Obsoleto; inhabilitado por --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
yaffects_outputs
- Valor predeterminado de
--python_top=<a build target label>
: ver descripción -
Es la etiqueta de un py_runtime que representa el intérprete de Python invocado para ejecutar objetivos de Python en la plataforma de destino. Obsoleto; inhabilitado por --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
yaffects_outputs
- Valor predeterminado de
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Especifica la versión del SDK de tvOS que se usará para compilar aplicaciones de tvOS. Si no se especifica, usa la versión predeterminada del SDK de tvOS de "xcode_version".
Etiquetas:loses_incremental_state
- Valor predeterminado de
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Especifica la versión del SDK de watchOS que se usará para compilar aplicaciones de watchOS. Si no se especifica, se usa la versión predeterminada del SDK de watchOS de “xcode_version”.
Etiquetas:loses_incremental_state
- Valor predeterminado de
--xcode_version=<a string>
: ver descripción -
Si se especifica, usa Xcode de la versión determinada para las acciones de compilación relevantes. Si no se especifica, usa la versión predeterminada del ejecutor de Xcode.
Etiquetas:loses_incremental_state
--xcode_version_config=<a build target label>
predeterminado: “@bazel_tools//tools/cpp:host_xcodes”-
La etiqueta de la regla xcode_config que se usará para seleccionar la versión de Xcode en la configuración de compilación.
Etiquetas:loses_incremental_state
yloading_and_analysis
- Opciones que controlan el resultado del comando:
- Valor predeterminado de
--[no]apple_generate_dsym
: "falso" -
Indica si se deben generar archivos de símbolos de depuración (.dSYM).
Etiquetas:affects_outputs
yaction_command_lines
- Valor predeterminado de
--[no]build_runfile_links
: "true" -
Si es verdadero, compila bosques de symlink de archivos de ejecución para todos los destinos. Si es falso, escríbelos solo cuando lo requiera una acción local, prueba o comando de ejecución.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]build_runfile_manifests
: "true" -
Si es verdadero, escribe manifiestos de archivos de ejecución para todos los destinos. Si es falsa, omítelas. Las pruebas locales no se ejecutarán si el valor es falso.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]build_test_dwp
: "falso" -
Si se habilita, al compilar pruebas de C++ de forma estática y con fisión, también se compilará automáticamente el archivo .dwp para el objeto binario de prueba.
Etiquetas:loading_and_analysis
yaffects_outputs
--cc_proto_library_header_suffixes=<comma-separated set of options>
predeterminado: ".pb.h"-
Establece los sufijos de los archivos de encabezado que crea cc_proto_library.
Etiquetas:affects_outputs
yloading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated set of options>
predeterminado: ".pb.cc"-
Establece los sufijos de los archivos de origen que crea cc_proto_library.
Etiquetas:affects_outputs
yloading_and_analysis
- Valor predeterminado de
--[no]experimental_proto_descriptor_sets_include_source_info
: "falso" -
Ejecuta acciones adicionales para versiones alternativas de la API de Java en una proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
yexperimental
- Valor predeterminado de
--[no]experimental_proto_extra_actions
: "falso" -
Ejecuta acciones adicionales para versiones alternativas de la API de Java en una proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
yexperimental
- Valor predeterminado de
--[no]experimental_save_feature_state
: "falso" -
Guarda el estado de las funciones habilitadas y solicitadas como resultado de la compilación.
Etiquetas:affects_outputs
yexperimental
--fission=<a set of compilation modes>
predeterminado: "no"-
Especifica qué modos de compilación usan la fisión para compilaciones y vínculos de C++. Puede ser cualquier combinación de {'fastbuild', 'dbg', 'opt'} o los valores especiales 'sí' para habilitar todos los modos y hacer clic en "no". para inhabilitar todos los modos.
Etiquetas:loading_and_analysis
,action_command_lines
yaffects_outputs
- Valor predeterminado de
--[no]incompatible_always_include_files_in_data
: "true" -
Si esta preferencia se establece como "true", las reglas nativas agregarán <code>DefaultInfo.files</code>. de las dependencias de datos a sus runfiles, lo que coincide con el comportamiento recomendado para las reglas de Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid).
Etiquetas:affects_outputs
yincompatible_change
- Valor predeterminado de
--[no]legacy_external_runfiles
: "true" -
Si es verdadero, compila bosques de symlink de archivos de ejecución para repositorios externos en .runfiles/wsname/external/repo (además de .runfiles/repo).
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]objc_generate_linkmap
: "falso" -
Especifica si se debe generar un archivo de mapa de vínculos.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]save_temps
: "falso" -
Si lo estableces, se guardarán los resultados temporales de GCC. Entre estos, se incluyen archivos .s (código ensamblador), .i (C++ previamente procesado) y .ii (C++ previamente procesados).
Etiquetas:affects_outputs
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
- Se acumulan
--action_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica el conjunto de variables de entorno disponibles para las acciones con configuración de destino. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o por el par nombre=valor que establece el valor de forma independiente del entorno de invocación. Esta opción se puede usar varias veces. en el caso de opciones proporcionadas para la misma variable, se acumulan las últimas victorias y se acumulan opciones para diferentes variables.
Etiquetas:action_command_lines
--android_cpu=<a string>
predeterminado: "armeabi-v7a"-
La CPU de destino de Android
Etiquetas:affects_outputs
,loading_and_analysis
yloses_incremental_state
- Valor predeterminado de
--[no]android_databinding_use_androidx
: "true" -
Genera archivos de vinculación de datos compatibles con AndroidX. Esto solo se usa con la vinculación de datos v2. Esta marca es una no-op.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
yexperimental
- Valor predeterminado de
--[no]android_databinding_use_v3_4_args
: "true" -
Usa android databinding v2 con el argumento 3.4.0. Esta marca es una no-op.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
yexperimental
- Configuración predeterminada de
--android_dynamic_mode=<off, default or fully>
: "desactivada" -
Determina si las dependencias de C++ de reglas de Android se vincularán dinámicamente cuando un objeto cc_binary no cree explícitamente una biblioteca compartida. 'predeterminado' significa que Bazel elegirá si realizar la vinculación de forma dinámica. "completamente" significa que todas las bibliotecas se vincularán de forma dinámica. "desactivado" significa que todas las bibliotecas se vincularán
en su mayoría en modo estático.
Etiquetas:affects_outputs
yloading_and_analysis
- Valor predeterminado de
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
: "alfabético" -
Establece el orden de los manifiestos que se pasan a la combinación de manifiestos para los objetos binarios de Android. ALFABÉTICO significa que los manifiestos se ordenan por ruta de acceso relativa a execroot. ALPHABETICAL_BY_CONFIGURATION significa que los manifiestos se ordenan por rutas de acceso relacionadas con el directorio de configuración dentro del directorio de salida. DEPENDENCY significa que los manifiestos se ordenan; el de cada biblioteca antecede a los de sus dependencias.
Etiquetas:action_command_lines
yexecution
- Valor predeterminado de
--[no]android_resource_shrinking
: "falso" -
Habilita la reducción de recursos para los APK android_binary que usan ProGuard.
Etiquetas:affects_outputs
yloading_and_analysis
--[no]build_python_zip
predeterminado: "automático"-
Compila el archivo ZIP ejecutable de Python; Activado en Windows y desactivado en otras plataformas
Etiquetas:affects_outputs
- Se acumulan
--catalyst_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se compilarán objetos binarios de Apple Catalyst.
Etiquetas:loses_incremental_state
yloading_and_analysis
- Valor predeterminado de
--[no]collect_code_coverage
: "falso" -
Si se especifica, Bazel instrumentará el código (usando instrumentación sin conexión cuando sea posible) y recopilará información de cobertura durante las pruebas. Solo se verán afectadas las orientaciones que coincidan con --instrumentation_filter. Por lo general, esta opción no debe especificarse directamente: "cobertura de Bazel". en su lugar.
Etiquetas:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] predeterminado: "fastbuild"-
Especifica el modo en que se compilará el objeto binario. Valores: “fastbuild”, “dbg”, “opt”.
Etiquetas:affects_outputs
yaction_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
yaffects_outputs
- Se acumulan
--copt=<a string>
usos múltiples -
Opciones adicionales para pasar a gcc.
Etiquetas:action_command_lines
yaffects_outputs
- Valor predeterminado de
--cpu=<a string>
: "" -
La CPU de destino.
Etiquetas:changes_inputs
yaffects_outputs
- Valor predeterminado de
--cs_fdo_absolute_path=<a string>
: ver descripción -
Usa la información de perfil de CSFDO para optimizar la compilación. Especifica el nombre de la ruta de acceso absoluta del archivo ZIP que contiene el archivo de perfil, un archivo de perfil de LLVM indexado o sin procesar.
Etiquetas:affects_outputs
- Valor predeterminado de
--cs_fdo_instrument=<a string>
: ver descripción -
Genera objetos binarios con instrumentación FDO sensible al contexto. Con el compilador Clang/LLVM, también acepta el nombre del directorio bajo el cual se volcarán los archivos de perfil sin procesar en el tiempo de ejecución.
Etiquetas:affects_outputs
- Valor predeterminado de
--cs_fdo_profile=<a build target label>
: ver descripción -
El cs_fdo_profile que representa el perfil sensible al contexto que se usará para la optimización.
Etiquetas:affects_outputs
- Se acumulan
--cxxopt=<a string>
usos múltiples -
Es una opción adicional para pasar a gcc cuando se compilan archivos de origen C++.
Etiquetas:action_command_lines
yaffects_outputs
- Se acumulan
--define=<a 'name=value' assignment>
usos múltiples -
Cada opción --define especifica una asignación para una variable de compilación.
Etiquetas:changes_inputs
yaffects_outputs
- Valor predeterminado de
--dynamic_mode=<off, default or fully>
: “predeterminado” -
Determina si se vincularán dinámicamente los objetos binarios de C++. 'predeterminado' significa que Bazel elegirá si realizar la vinculación de forma dinámica. "completamente" significa que todas las bibliotecas se vincularán de forma dinámica. "desactivado" significa que todas las bibliotecas se vincularán
en su mayoría en modo estático.
Etiquetas:loading_and_analysis
yaffects_outputs
- Valor predeterminado de
--[no]enable_fdo_profile_absolute_path
: "true" -
Si se configura, el uso de fdo_logical_profile_path generará un error.
Etiquetas:affects_outputs
--[no]enable_runfiles
predeterminado: "automático"-
Habilitar el árbol de symlink de archivos de ejecución De forma predeterminada, la función está desactivada en Windows y activada en otras plataformas.
Etiquetas:affects_outputs
- Se acumulan
--experimental_action_listener=<a build target label>
usos múltiples -
Obsoleto para dar lugar a aspectos. Usa action_listener para adjuntar una extra_action a las acciones de compilación existentes.
Etiquetas:execution
yexperimental
- Valor predeterminado de
--[no]experimental_android_compress_java_resources
: "falso" -
Comprime recursos de Java en los APK
Etiquetas:affects_outputs
,loading_and_analysis
yexperimental
- Valor predeterminado de
--[no]experimental_android_databinding_v2
: "true" -
Usa Android Databinding v2. Esta marca es una no-op.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
yexperimental
- Valor predeterminado de
--[no]experimental_android_resource_shrinking
: "falso" -
Habilita la reducción de recursos para los APK android_binary que usan ProGuard.
Etiquetas:affects_outputs
yloading_and_analysis
- Valor predeterminado de
--[no]experimental_android_rewrite_dexes_with_rex
: "falso" -
usar la herramienta rex para reescribir archivos dex
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
yexperimental
- Valor predeterminado de
--[no]experimental_collect_code_coverage_for_generated_files
: "falso" -
Si se especifica, Bazel también recopilará información de cobertura para los archivos generados.
Etiquetas:affects_outputs
--experimental_objc_fastbuild_options=<comma-separated list of options>
predeterminado: "-O0,-DDEBUG=1"-
Usa estas cadenas como opciones del compilador objc fastbuild.
Etiquetas:action_command_lines
- Valor predeterminado de
--[no]experimental_omitfp
: "falso" -
Si es verdadero, usa libunwind para desenrollar la pila y compila con -fomit-frame-pointer y -faasync-unwind-tables.
Etiquetas:action_command_lines
,affects_outputs
yexperimental
- Configuración predeterminada de
--experimental_output_paths=<off, content or strip>
: "desactivada" -
Qué modelo usar para dónde en las reglas del árbol de salida se escriben sus resultados, en particular para compilaciones multiplataforma o con varias configuraciones. Esto es altamente experimental. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/6526. Las acciones de Starlark pueden habilitar la asignación de rutas agregando la tecla “supports-path-mapping”. a los requisitos de ejecución dict.
Etiquetas:loses_incremental_state
,bazel_internal_configuration
,affects_outputs
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 es el nombre corto deseado para usar en la ruta de salida. Solo se utiliza cuando --experimental_platform_in_output_dir es verdadero. Tiene la prioridad de nomenclatura más alta.
Etiquetas:affects_outputs
yexperimental
- Valor predeterminado de
--[no]experimental_platform_in_output_dir
: "falso" -
Si es verdadero, se usa un nombre corto para la plataforma de destino en el nombre del directorio de salida en lugar de la CPU. El esquema exacto es experimental y está sujeto a cambios. En primer lugar, en el caso poco probable de que la opción --platforms no tenga exactamente un valor, se utiliza un hash de la opción de plataformas. A continuación, si --experimental_override_name_platform_in_output_dir registró algún nombre corto para la plataforma actual, se utilizará ese nombre corto. Luego, si se configuró --experimental_use_platforms_in_output_dir_legacy_heuristic, use un nombre corto basado en la etiqueta de la plataforma actual. Por último, se usa un hash de la opción de plataforma como último recurso.
Etiquetas:affects_outputs
yexperimental
- Valor predeterminado de
--[no]experimental_use_llvm_covmap
: "falso" -
Si se especifica, Bazel generará información del mapa de cobertura llvm-cov en lugar de gcov cuando collect_code_coverage esté habilitado.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
yexperimental
- Valor predeterminado de
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic
: "true" -
Solo usa esta marca como parte de una estrategia de prueba o migración sugerida. Ten en cuenta que la heurística presenta deficiencias conocidas y se sugiere migrar a solo --experimental_override_name_platform_in_output_dir.
Etiquetas:affects_outputs
yexperimental
--fat_apk_cpu=<comma-separated set of options>
predeterminado: "armeabi-v7a"-
Configurar esta opción habilita los APK multiarquitectura, que contienen objetos binarios nativos para todas las arquitecturas de destino especificadas, p.ej., --fat_apk_cpu=x86,armeabi-v7a. Si se especifica esta marca, se ignora --android_cpu para las dependencias de las reglas android_binary.
Etiquetas:affects_outputs
,loading_and_analysis
yloses_incremental_state
- Valor predeterminado de
--[no]fat_apk_hwasan
: "falso" -
Establece si se deben crear divisiones de HWASAN.
Etiquetas:affects_outputs
,loading_and_analysis
yloses_incremental_state
- Valor predeterminado de
--fdo_instrument=<a string>
: ver descripción -
Generar objetos binarios con instrumentación FDO Con el compilador Clang/LLVM, también acepta el nombre del directorio bajo el cual se volcarán los archivos de perfil sin procesar en el tiempo de ejecución.
Etiquetas:affects_outputs
- Valor predeterminado de
--fdo_optimize=<a string>
: ver descripción -
Usa la información del perfil FDO para optimizar la compilación. Especifica el nombre de un archivo ZIP que contenga un árbol de archivos .gcda, un archivo afdo que contenga un perfil automático o un archivo de perfil LLVM. Esta marca también acepta archivos especificados como etiquetas (p.ej., `//foo/bar:file.afdo`; es posible que debas agregar una directiva `exports_files` al paquete correspondiente) y etiquetas que apunten a destinos de `fdo_profile`. Esta marca se reemplazará por la regla `fdo_profile`.
Etiquetas:affects_outputs
- Valor predeterminado de
--fdo_prefetch_hints=<a build target label>
: ver descripción -
Usa sugerencias de carga previa de caché.
Etiquetas:affects_outputs
- Valor predeterminado de
--fdo_profile=<a build target label>
: ver descripción -
El fdo_profile que representa el perfil que se utilizará para la optimización.
Etiquetas:affects_outputs
- Se acumulan
--features=<a string>
usos múltiples -
Las funciones determinadas estarán habilitadas o inhabilitadas de forma predeterminada para los destinos integrados en la configuración de destino. Especificando -<feature> la inhabilitará. Los atributos negativos siempre anulan los positivos. Consulta también --host_features
Etiquetas:changes_inputs
yaffects_outputs
- Valor predeterminado de
--[no]force_pic
: "falso" -
Si se habilitan, todas las compilaciones de C++ producen código independiente de la posición ("-fPIC"), los vínculos prefieren bibliotecas PIC compiladas previamente en lugar de bibliotecas que no son PIC y producen ejecutables independientes de la posición ("-pie").
Etiquetas:loading_and_analysis
yaffects_outputs
- Se acumulan
--host_action_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica el conjunto de variables de entorno disponibles para acciones con configuraciones de ejecución. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o por el par nombre=valor que establece el valor de forma independiente del entorno de invocación. Esta opción se puede usar varias veces. en el caso de opciones proporcionadas para la misma variable, se acumulan las últimas victorias y se acumulan opciones para diferentes variables.
Etiquetas:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
predeterminado: "opt"-
Especifica el modo en que se integrarán las herramientas usadas durante la compilación. Valores: “fastbuild”, “dbg”, “opt”.
Etiquetas:affects_outputs
yaction_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
yaffects_outputs
- Se acumulan
--host_copt=<a string>
usos múltiples -
Opciones adicionales para pasar al compilador C para herramientas integradas en las configuraciones de ejecución.
Etiquetas:action_command_lines
yaffects_outputs
- Valor predeterminado de
--host_cpu=<a string>
: "" -
La CPU host
Etiquetas:changes_inputs
yaffects_outputs
- Se acumulan
--host_cxxopt=<a string>
usos múltiples -
Opciones adicionales para pasar al compilador C++ en el caso de las herramientas integradas en las configuraciones de ejecución.
Etiquetas:action_command_lines
yaffects_outputs
- Se acumulan
--host_features=<a string>
usos múltiples -
Las funciones determinadas estarán habilitadas o inhabilitadas de forma predeterminada para los destinos compilados en la configuración de ejecución. Especificando -<feature> la inhabilitará. Los atributos negativos siempre anulan los positivos.
Etiquetas:changes_inputs
yaffects_outputs
- Valor predeterminado de
--host_force_python=<PY2 or PY3>
: ver descripción -
Anula la versión de Python para la configuración de ejecución. Puede ser "PY2". o “PY3”.
Etiquetas:loading_and_analysis
yaffects_outputs
- Se acumulan
--host_linkopt=<a string>
usos múltiples -
Es una opción adicional para pasar al vinculador cuando se vinculan herramientas en las configuraciones de ejecución.
Etiquetas:action_command_lines
yaffects_outputs
- Valor predeterminado de
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima de macOS compatible para los destinos de host. Si no se especifica, usa "macos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
usos múltiples -
Opciones adicionales para pasar de forma selectiva al compilador C/C++ cuando compilas ciertos archivos en las configuraciones de ejecución. Esta opción se puede aprobar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter significa una lista de patrones de inclusión y exclusión de expresiones regulares (consulta también --instrumentation_filter). opción_1 a option_n significa opciones arbitrarias de la línea de comandos. Si una opción contiene una coma, se debe colocar entre una barra inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos gcc de todos los archivos cc en //foo/, excepto bar.cc.
Etiquetas:action_command_lines
yaffects_outputs
- Se acumulan
--host_swiftcopt=<a string>
usos múltiples -
Opciones adicionales para pasar a swiftc para herramientas de ejecución.
Etiquetas:action_command_lines
yaffects_outputs
- Valor predeterminado de
--[no]incompatible_auto_exec_groups
: "falso" -
Cuando se habilita, se crea automáticamente un grupo de ejecución para cada cadena de herramientas que usa una regla. Para que esta regla funcione, se debe especificar el parámetro `toolchain` en sus acciones. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/17134.
Etiquetas:affects_outputs
yincompatible_change
- Valor predeterminado de
--[no]incompatible_merge_genfiles_directory
: "true" -
Si es verdadero, el directorio genfiles se pliega en el directorio bin.
Etiquetas:affects_outputs
yincompatible_change
- Valor predeterminado de
--[no]incompatible_use_host_features
: "true" -
Si es verdadero, usa --features solo para la configuración de destino y --host_features para la configuración de ejecución.
Etiquetas:changes_inputs
,affects_outputs
yincompatible_change
- Valor predeterminado de
--[no]instrument_test_targets
: "falso" -
Cuando la cobertura está habilitada, especifica si se deben considerar reglas de prueba. Cuando se establecen, se instrumentan las reglas de prueba incluidas por --instrumentation_filter. De lo contrario, las reglas de prueba siempre se excluyen de la instrumentación de cobertura.
Etiquetas:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
predeterminado: "-/javatests[/:],-/test/java[/:]"-
Cuando se habilite la cobertura, solo se instrumentarán las reglas con nombres incluidos por el filtro basado en regex especificado. Reglas con el prefijo “-” en su lugar. Ten en cuenta que solo se instrumentan las reglas que no son de prueba, a menos que se habilite --instrument_test_targets.
Etiquetas:affects_outputs
- Valor predeterminado de
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión de iOS mínima compatible para simuladores y dispositivos de destino. Si no se especifica, usa "ios_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan
--ios_multi_cpus=<comma-separated list of options>
usos múltiples -
Lista separada por comas de arquitecturas con las que se compilará una aplicación ios_application. El resultado es un objeto binario universal que contiene todas las arquitecturas especificadas.
Etiquetas:loses_incremental_state
yloading_and_analysis
- Valor predeterminado de
--[no]legacy_whole_archive
: "true" -
Obsoleto y sustituido por --incompatible_remove_legacy_whole_archive (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener más información). Cuando esta opción esté activada, usa --whole-archive para las reglas cc_binary que tengan linkshared=True y linkstatic=True o '-static'. en linkopts. Esto es solo para la retrocompatibilidad. Una mejor alternativa es usar Alwayslink=1 cuando sea necesario.
Etiquetas:action_command_lines
,affects_outputs
ydeprecated
- 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
yaffects_outputs
- Se acumulan
--ltobackendopt=<a string>
usos múltiples -
Es una opción adicional para pasar al paso del backend de LTO (en --features=thin_lto).
Etiquetas:action_command_lines
yaffects_outputs
- Se acumulan
--ltoindexopt=<a string>
usos múltiples -
Es una opción adicional para pasar al paso de indexación de LTO (en --features=thin_lto).
Etiquetas:action_command_lines
yaffects_outputs
- Se acumulan
--macos_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se compilarán objetos binarios de Apple macOS.
Etiquetas:loses_incremental_state
yloading_and_analysis
- Valor predeterminado de
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima de macOS compatible para destinos. Si no se especifica, usa "macos_sdk_version".
Etiquetas:loses_incremental_state
- Valor predeterminado de
--memprof_profile=<a build target label>
: ver descripción -
Usar perfil de memprof.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]objc_debug_with_GLIBCXX
: "falso" -
Si se establece y el modo de compilación está establecido en "dbg", define GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC y GLIBCPP_CONCEPT_CHECKS.
Etiquetas:action_command_lines
- Valor predeterminado de
--[no]objc_enable_binary_stripping
: "falso" -
Indica si se deben realizar eliminaciones de símbolos y de código no muerto en objetos binarios vinculados. Se realizarán eliminaciones de objetos binarios si se especifican esta marca y --compilation_mode=opt.
Etiquetas:action_command_lines
- Se acumulan
--objccopt=<a string>
usos múltiples -
Opciones adicionales para pasar a gcc cuando se compilan archivos de origen Objective-C/C++.
Etiquetas:action_command_lines
- Se acumulan
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
usos múltiples -
Opciones adicionales para pasar a gcc de forma selectiva cuando se compilan ciertos archivos. Esta opción se puede aprobar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter significa una lista de patrones de inclusión y exclusión de expresiones regulares (consulta también --instrumentation_filter). opción_1 a option_n significa opciones arbitrarias de la línea de comandos. Si una opción contiene una coma, se debe colocar entre una barra inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos gcc de todos los archivos cc en //foo/, excepto bar.cc.
Etiquetas:action_command_lines
yaffects_outputs
- Se acumulan
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
usos múltiples -
Opciones adicionales para pasar de forma selectiva al backend de LTO (en --features=thin_lto) cuando se compilan ciertos objetos de backend. Esta opción se puede aprobar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter significa una lista de patrones de incluir y excluir expresiones regulares. opción_1 a option_n significa opciones arbitrarias de la línea de comandos. Si una opción contiene una coma, se debe colocar entre una barra inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos del backend LTO de todos los archivos o en //foo/ excepto bar.o.
Etiquetas:action_command_lines
yaffects_outputs
- Valor predeterminado de
--platform_suffix=<a string>
: ver descripción -
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas:loses_incremental_state
,affects_outputs
yloading_and_analysis
- Valor predeterminado de
--propeller_optimize=<a build target label>
: ver descripción -
Usa la información del perfil de Propeller para optimizar el objetivo de la compilación.Un perfil de propeller debe constar de al menos uno de dos archivos, un perfil cc y un perfil ld. Esta marca acepta una etiqueta de compilación que debe hacer referencia a los archivos de entrada del perfil del propeler. Por ejemplo, el archivo COMPILAR que define la etiqueta, en a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)Es posible que se deba agregar una directiva export_files al paquete correspondiente para que estos archivos sean visibles para Bazel. La opción debe usarse como: --propeller_optimize=//a/b:propeller_profile
Etiquetas:action_command_lines
yaffects_outputs
- Valor predeterminado de
--propeller_optimize_absolute_cc_profile=<a string>
: ver descripción -
Nombre de la ruta de acceso absoluta del archivo cc_profile para compilaciones de Propeller Optimized.
Etiquetas:affects_outputs
- Valor predeterminado de
--propeller_optimize_absolute_ld_profile=<a string>
: ver descripción -
Nombre de la ruta de acceso absoluta del archivo ld_profile para compilaciones de Propeller Optimized.
Etiquetas:affects_outputs
- Valor predeterminado de
--run_under=<a prefix in front of command>
: ver descripción -
Prefijo para insertar antes de los ejecutables para la “prueba” y "ejecutar" con comandos de SQL sencillos. Si el valor es “foo -bar” y la línea de comandos de ejecución es “test_binary -baz”, la última línea de comandos es “foo -bar test_binary -baz”. También puede ser una etiqueta para un destino ejecutable. Estos son algunos ejemplos: 'valgrind', 'strace', 'strace -c', 'valgrind --quiet --num-callers=20', '//package:target', '//package:target --options'.
Etiquetas:action_command_lines
-
Si es verdadero, las bibliotecas nativas que contengan una funcionalidad idéntica se compartirán entre diferentes destinos
Etiquetas:loading_and_analysis
yaffects_outputs
- Valor predeterminado de
--[no]stamp
: "falso" -
Sella objetos binarios con la fecha, el nombre de usuario, el nombre de host, la información del espacio de trabajo, etcétera.
Etiquetas:affects_outputs
--strip=<always, sometimes or never>
predeterminado: “a veces”-
Especifica si se deben eliminar los objetos binarios y las bibliotecas compartidas (mediante "-Wl,--strip-debug"). El valor predeterminado de “A veces” significa quitar iff --compilation_mode=fastbuild.
Etiquetas:affects_outputs
- Se acumulan
--stripopt=<a string>
usos múltiples -
Opciones adicionales para pasar a la barra cuando se genera un archivo '<name>.stripped' binario.
Etiquetas:action_command_lines
yaffects_outputs
- Se acumulan
--swiftcopt=<a string>
usos múltiples -
Opciones adicionales para pasar a la compilación de Swift.
Etiquetas:action_command_lines
- Se acumulan
--tvos_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se compilarán objetos binarios de tvOS de Apple.
Etiquetas:loses_incremental_state
yloading_and_analysis
- Valor predeterminado de
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima de tvOS compatible para dispositivos y simuladores de destino. Si no se especifica, usa "tvos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan
--visionos_cpus=<comma-separated list of options>
usos múltiples -
Lista separada por comas de arquitecturas para las que se compilarán objetos binarios de visionOS de Apple.
Etiquetas:loses_incremental_state
yloading_and_analysis
- Se acumulan
--watchos_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para compilar objetos binarios de watchOS de Apple.
Etiquetas:loses_incremental_state
yloading_and_analysis
- Valor predeterminado de
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima de watchOS compatible con simuladores y dispositivos de destino. Si no se especifica, usa “watchos_sdk_version”.
Etiquetas:loses_incremental_state
- Valor predeterminado de
--xbinary_fdo=<a build target label>
: ver descripción -
Usa la información de perfil de XbinaryFDO para optimizar la compilación. Especifica el nombre del perfil de multibinario predeterminado. Cuando la opción se usa junto con --fdo_instrument/--fdo_optimize/--fdo_profile, esas opciones siempre prevalecerán como si nunca se especificara xbinary_fdo.
Etiquetas:affects_outputs
- Opciones que afectan la precisión con la que Bazel aplica entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
- Valor predeterminado de
--auto_cpu_environment_group=<a build target label>
: "" -
Declara el grupo de entorno que se usará para asignar automáticamente los valores de la CPU a los valores de target_environment.
Etiquetas:changes_inputs
,loading_and_analysis
yexperimental
- Valor predeterminado de
--[no]check_licenses
: "falso" -
Verifica que las restricciones de licencias impuestas por los paquetes dependientes no entren en conflicto con los modos de distribución de los objetivos que se compilan. De forma predeterminada, las licencias no están marcadas.
Etiquetas:build_file_semantics
- Valor predeterminado de
--[no]check_visibility
: "true" -
Si se inhabilita, los errores de visibilidad en las dependencias objetivo descienden a advertencias.
Etiquetas:build_file_semantics
- Valor predeterminado de
--[no]desugar_for_android
: "true" -
Establece si se debe expandir el código de bytes de Java 8 antes de la conversión a DEX.
Etiquetas:affects_outputs
,loading_and_analysis
yloses_incremental_state
- Valor predeterminado de
--[no]desugar_java8_libs
: "falso" -
Especifica si se deben incluir bibliotecas de Java 8 compatibles en las apps para dispositivos heredados.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
yexperimental
- Valor predeterminado de
--[no]enforce_constraints
: "true" -
Verifica los entornos con los que cada destino es compatible y, luego, informa los errores si alguno de ellos tiene dependencias que no admiten los mismos entornos.
Etiquetas:build_file_semantics
- Valor predeterminado de
--[no]experimental_check_desugar_deps
: "true" -
Establece si se debe verificar la expansión de sintaxis correcta a nivel del objeto binario de Android.
Etiquetas:eagerness_to_exit
,loading_and_analysis
yexperimental
- Configuración predeterminada de
--experimental_import_deps_checking=<off, warning or error>
: "DESACTIVADA" -
Cuando se habilita, se verifica si las dependencias de aar_import están completas. Esta aplicación puede romper la compilación o generar advertencias.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--experimental_strict_java_deps=<off, warn, error, strict or default>
: “predeterminado” -
Si es verdadero, comprueba que un destino de Java declare de manera explícita todos los objetivos usados directamente como dependencias.
Etiquetas:build_file_semantics
yeagerness_to_exit
- Valor predeterminado de
--[no]incompatible_check_testonly_for_output_files
: "falso" -
Si se habilita, comprueba los objetivos de prerrequisito de solo prueba que son archivos de salida buscando solo la prueba de la regla que se genera. Esto coincide con la verificación de visibilidad.
Etiquetas:build_file_semantics
yincompatible_change
- Valor predeterminado de
--[no]incompatible_check_visibility_for_toolchains
: "falso" -
Si se habilita, la verificación de visibilidad también se aplica a las implementaciones de cadenas de herramientas.
Etiquetas:build_file_semantics
yincompatible_change
- Valor predeterminado de
--[no]incompatible_disable_native_android_rules
: "falso" -
Si se habilita esta opción, se inhabilitará el uso directo de las reglas nativas de Android. Usa las reglas de Starlark para Android que se encuentran en https://github.com/bazelbuild/rules_android
Etiquetas:eagerness_to_exit
yincompatible_change
- Valor predeterminado de
--[no]incompatible_disable_native_apple_binary_rule
: "falso" -
No-ops. Se guardan aquí para brindar retrocompatibilidad.
Etiquetas:eagerness_to_exit
yincompatible_change
- Valor predeterminado de
--[no]incompatible_python_disable_py2
: "true" -
Si es verdadero, usar la configuración de Python 2 generará un error. Esto incluye python_version=PY2, srcs_version=PY2 y srcs_version=PY2ONLY. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/15684.
Etiquetas:loading_and_analysis
yincompatible_change
- Valor predeterminado de
--[no]incompatible_validate_top_level_header_inclusions
: "true" -
Si es verdadero, Bazel también validará las inclusiones de encabezados de directorio de nivel superior (consulta https://github.com/bazelbuild/bazel/issues/10047 para obtener más información).
Etiquetas:loading_and_analysis
yincompatible_change
- Valor predeterminado de
--python_native_rules_allowlist=<a build target label>
: ver descripción -
Una lista de entidades permitidas (destino del grupo de productos) que se usará cuando se aplique --incompatible_python_Disallow_native_rules.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]strict_filesets
: "falso" -
Si se habilita esta opción, los conjuntos de archivos que cruzan los límites de paquetes se informan como errores.
Etiquetas:build_file_semantics
yeagerness_to_exit
- Valor predeterminado de
--strict_proto_deps=<off, warn, error, strict or default>
: "error" -
A menos que esté DESACTIVADA, comprueba que un destino proto_library declare de forma explícita todos los objetivos usados directamente como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
yincompatible_change
- Configuración predeterminada de
--strict_public_imports=<off, warn, error, strict or default>
: "desactivada" -
A menos que esté DESACTIVADA, comprueba que un objetivo proto_library declare de forma explícita todos los destinos usados en el campo "import public" como se exportó.
Etiquetas:build_file_semantics
,eagerness_to_exit
yincompatible_change
- Valor predeterminado de
--[no]strict_system_includes
: "falso" -
Si es verdadero, también se deben declarar los encabezados que se encuentran en el sistema incluyen rutas de acceso (-isystem).
Etiquetas:loading_and_analysis
yeagerness_to_exit
- Se acumulan
--target_environment=<a build target label>
usos múltiples -
Declara el entorno de destino de esta compilación. Debe ser una referencia de etiqueta a un "entorno" . Si se especifica, todos los objetivos de nivel superior deben ser compatibles con este entorno.
Etiquetas:changes_inputs
- Opciones que afectan los resultados de firma de una compilación:
--apk_signing_method=<v1, v2, v1_v2 or v4>
predeterminado: “v1_v2”-
Implementación para firmar APKs
Etiquetas:action_command_lines
,affects_outputs
yloading_and_analysis
- Valor predeterminado de
--[no]device_debug_entitlements
: "true" -
Si se configura y el modo de compilación no es "opt", las apps objc incluirán derechos de depuración cuando firmen.
Etiquetas:changes_inputs
- Valor predeterminado de
--ios_signing_cert_name=<a string>
: ver descripción -
Nombre del certificado que se usará para la firma de iOS. De lo contrario, se recurrirá al perfil de aprovisionamiento. Puede ser la preferencia de identidad del llavero del certificado o (subcadena) del nombre común del certificado, según la página del manual del símbolo de código (IDENTIDADES DE FIRMA).
Etiquetas:action_command_lines
- Esta opción afecta la semántica del lenguaje de Starlark o de la API de compilación a la que pueden acceder los archivos BUILD, los archivos .bzl o los archivos WORKSPACE:
- Valor predeterminado de
--[no]incompatible_disallow_legacy_py_provider
: "true" -
No-op; se quitará pronto.
Etiquetas:loading_and_analysis
yincompatible_change
- Valor predeterminado de
--[no]incompatible_disallow_sdk_frameworks_attributes
: "falso" -
Si esta preferencia se establece como verdadera, no permite los atributos sdk_frameworks y bad_sdk_frameworks en objc_library y objc_import.
Etiquetas:build_file_semantics
yincompatible_change
- Valor predeterminado de
--[no]incompatible_objc_alwayslink_by_default
: "falso" -
Si es verdadero, establece como verdadero el valor predeterminado para los atributos Alwayslink en objc_library y objc_import.
Etiquetas:build_file_semantics
yincompatible_change
- Valor predeterminado de
--[no]incompatible_python_disallow_native_rules
: "falso" -
Si es verdadero, se produce un error cuando se usan las reglas py_* integradas. en su lugar, se deben usar las reglas rule_python. Consulta https://github.com/bazelbuild/bazel/issues/17773 para obtener más información y las instrucciones de migración.
Etiquetas:loading_and_analysis
yincompatible_change
- Opciones que determinan el comportamiento del entorno de pruebas o del ejecutor de pruebas:
- Valor predeterminado de
--[no]allow_analysis_failures
: "falso" -
Si es verdadero, una falla de análisis del destino de una regla da como resultado la propagación del destino de una instancia de AnalysisFailureInfo que contiene la descripción del error, en lugar de generar una falla de compilación.
Etiquetas:loading_and_analysis
yexperimental
- Valor predeterminado de
--analysis_testing_deps_limit=<an integer>
: "2000" -
Establece el número máximo de dependencias transitivas mediante un atributo de regla con una transición de configuración for_analysis_testing. Si superas este límite, se producirá un error de regla.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]break_build_on_parallel_dex2oat_failure
: "falso" -
Si las verdaderas fallas de acción de dex2oat harán que la compilación se rompa en lugar de ejecutar dex2oat durante el tiempo de ejecución de la prueba.
Etiquetas:loading_and_analysis
yexperimental
- 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 de recursos predeterminada para las pruebas. El formato esperado es <resource>=<value>. Si un solo número positivo se especifica como <valor> se anularán los recursos predeterminados para todos los tamaños de pruebas. Si se especifican 4 números separados por comas, se anulará la cantidad de recursos para los tamaños de prueba pequeños, medianos, grandes y enormes, 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 explícitos especificados en las etiquetas anulan los recursos de prueba predeterminados que especifica esta marca.
- Valor predeterminado de
--[no]experimental_android_use_parallel_dex2oat
: "falso" -
Usa dex2oat en paralelo para acelerar la ejecución de android_test.
Etiquetas:loading_and_analysis
,host_machine_resource_optimizations
yexperimental
- Valor predeterminado de
--[no]ios_memleaks
: "falso" -
Habilitar la verificación de fugas de memoria en los destinos de ios_test.
Etiquetas:action_command_lines
- Valor predeterminado de
--ios_simulator_device=<a string>
: ver descripción -
El dispositivo que se debe simular cuando se ejecuta una aplicación para iOS en el simulador, p.ej., "iPhone 6". Ejecuta “xcrun simctl list devicetypes” para obtener una lista de dispositivos. de la máquina en la que se ejecutará el simulador.
Etiquetas:test_runner
- Valor predeterminado de
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Es la versión de iOS que se ejecuta en el simulador durante la ejecución o las pruebas. Esto se ignora para las reglas ios_test si se especifica un dispositivo de destino en la regla.
Etiquetas:test_runner
- Se acumulan
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
usos múltiples - Especifica la cantidad de veces que se debe ejecutar cada prueba. Si alguno de esos intentos falla por cualquier motivo, toda la prueba se considera fallida. Por lo general, el valor especificado es solo un número entero. Ejemplo: --runs_per_test=3 ejecutará todas las pruebas 3 veces. Sintaxis alternativa: regex_filter@runs_per_test. En el ejemplo anterior, ejecuta_per_prueba significa un valor entero y regex_filter representa una lista de patrones de expresiones regulares de inclusión y exclusión (consulta también --instrumentation_filter). Ejemplo: --runs_per_test=//foo/.*,-//foo/bar/.*@3 ejecuta todas las pruebas en //foo/ excepto las que se encuentran en foo/bar tres veces. Esta opción se puede aprobar varias veces. El argumento que se pasó más recientemente y que coincida tiene prioridad. Si no hay coincidencias, la prueba se ejecutará solo una vez.
- Se acumulan
--test_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica las variables de entorno adicionales que se insertarán en el entorno del ejecutor de pruebas. Las variables pueden especificarse por nombre, en cuyo caso su valor se leerá desde el entorno de cliente de Bazel o por el par nombre=valor. Esta opción se puede usar varias veces para especificar muchas variables. Solo lo usa la "prueba de Bazel". kubectl.
Etiquetas:test_runner
- Valor predeterminado de
--test_timeout=<a single integer or comma-separated list of 4 integers>
: "-1" - Anula los valores predeterminados del tiempo de espera de la prueba (en segundos). Si se especifica un valor entero positivo único, se anularán todas las categorías. Si se especifican 4 números enteros separados por comas, se anularán los tiempos de espera de corto, moderado, largo y eterno (en ese orden). En cualquier caso, el valor -1 indica al blaze que use los tiempos de espera predeterminados para esa categoría.
- Valor predeterminado de
--[no]zip_undeclared_test_outputs
: "true" -
Si es verdadero, los resultados de la prueba que no se declaren se archivarán en un archivo ZIP.
Etiquetas:test_runner
- Opciones relacionadas con el resultado de la consulta y la semántica:
--aspect_deps=<off, conservative or precise>
predeterminado: “conservadora”-
Cómo resolver dependencias de aspecto cuando el formato de salida es {xml,proto,record}. "desactivado" significa que no se resuelven dependencias de aspecto, “conservadora” (predeterminado) significa que todas las dependencias de aspecto declaradas se agregan independientemente de si se les da la clase de regla de dependencias directas, “precisa”. significa que solo se agregan los aspectos que posiblemente estén activos dada la clase de regla de las dependencias directas. Ten en cuenta que el modo preciso requiere cargar otros paquetes para evaluar un solo objetivo, lo que lo hace más lento que los otros modos. Además, ten en cuenta que incluso el modo preciso no es del todo preciso: la decisión de calcular un aspecto se decide en la fase de análisis, que no se ejecuta durante la “consulta de Bazel”.
Etiquetas:build_file_semantics
- Valor predeterminado de
--[no]consistent_labels
: "falso" -
Si se habilita, cada comando de consulta emite etiquetas como si <code>str</code> de Starlark función aplicada a una <code>etiqueta</code> instancia. Esto resulta útil para las herramientas que necesitan hacer coincidir el resultado de diferentes comandos de consulta o etiquetas emitidas por las reglas. Si no se habilita, los formateadores de salida pueden emitir nombres de repositorio aparentes (en relación con el repositorio principal) en lugar de hacer que el resultado sea más legible.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]experimental_explicit_aspects
: "falso" -
aquery, cquery: Se incluyen acciones generadas por aspectos en el resultado. consulta: no-op (siempre se siguen los aspectos).
Etiquetas:terminal_output
- Valor predeterminado de
--[no]graph:factored
: "true" -
Si es verdadero, el grafo se emitirá “factorizado”, es decir, los nodos topológicamente equivalentes se combinarán y sus etiquetas se concatenarán. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--graph:node_limit=<an integer>
predeterminado: "512"-
La longitud máxima de la cadena de etiqueta para un nodo del grafo en el resultado. Las etiquetas más largas se truncarán. -1 significa que no hay truncamiento. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]implicit_deps
: "true" -
Si se habilita, las dependencias implícitas se incluirán en el gráfico de dependencias sobre el que opera la consulta. Una dependencia implícita es una que no se especifica de forma explícita en el archivo BUILD, pero la agrega Bazel. En el caso de cquery, esta opción controla el filtrado de cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
- Valor predeterminado de
--[no]include_aspects
: "true" -
aquery, cquery: Se incluyen acciones generadas por aspectos en el resultado. consulta: no-op (siempre se siguen los aspectos).
Etiquetas:terminal_output
- Valor predeterminado de
--[no]incompatible_package_group_includes_double_slash
: "true" -
Si se habilita esta opción, cuando se genere el atributo `packages` de package_group, no se omitirá el `//` inicial.
Etiquetas:terminal_output
yincompatible_change
- Valor predeterminado de
--[no]infer_universe_scope
: "falso" -
Si no se establece ni --universe_scope, se inferirá un valor de --universe_scope como la lista de patrones de destino únicos en la expresión de consulta. Ten en cuenta que es posible que el valor --universe_scope inferido para una expresión de consulta que usa funciones con alcance universal (p.ej., `allrdeps`) no sea lo que quieres, por lo que debes usar esta opción solo si sabes lo que estás haciendo. Consulta https://bazel.build/reference/query#sky-query para obtener detalles y ejemplos. Si se configura --universe_scope, se ignora el valor de esta opción. Nota: Esta opción solo se aplica a “query” (es decir, no a “cquery”).
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]line_terminator_null
: "falso" -
Indica si cada formato termina con \0 en lugar de un salto de línea.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]nodep_deps
: "true" -
Si está habilitada, las dependencias de “nodep” atributos se incluirán en el gráfico de la dependencia en el que opera la consulta. Un ejemplo común de un “nodep” es “visibilidad”. Ejecuta y analiza el resultado de `info build-language` para conocer todos los “nodep” atributos en el lenguaje de compilación.
Etiquetas:build_file_semantics
--output=<a string>
predeterminado: "etiqueta"-
El formato en el que se deben imprimir los resultados de cquery. Los valores permitidos para cquery son los siguientes: label, label_kind, textproto, transactions, proto, streaming_proto y jsonproto. Si seleccionas "transiciones", también debes especificar la opción --transitions=(lite|full).
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:default_values
: "true" -
Si es verdadero, se incluirán los atributos cuyo valor no se especifica explícitamente en el archivo BUILD. de lo contrario, se omitirán. Esta opción se aplica a --output=proto
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:definition_stack
: "falso" -
Propaga el campo de proto definition_stack, que registra la pila de llamadas de Starlark para cada instancia de la regla en el momento en que se definió la clase de la regla.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:flatten_selects
: "true" -
Si se habilita, se acoplan los atributos configurables creados por select(). Para los tipos de lista, la representación plana es una lista que contiene cada valor del mapa de selección exactamente una vez. Los tipos escalares se acoplan a nulos.
Etiquetas:build_file_semantics
- Valor predeterminado de
--[no]proto:include_attribute_source_aspects
: "falso" -
Propaga el campo de protocolo source_aspect_name de cada atributo con el aspecto de origen del que provino (cadena vacía si no es así).
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:include_configurations
: "true" -
si está habilitado, el resultado del protocolo incluirá información sobre la configuración. Cuando está inhabilitado,el formato de salida de cquery proto se asemeja al formato de salida de la consulta.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]proto:include_synthetic_attribute_hash
: "falso" -
Indica si se debe calcular y propagar el atributo $internal_attr_hash.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:instantiation_stack
: "falso" -
Propaga la pila de llamadas de creación de instancias de cada regla. Ten en cuenta que esto requiere que la pila esté presente
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:locations
: "true" -
Establece si se debe emitir información de ubicación en el resultado de proto.
Etiquetas:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
predeterminado: "todos"-
Lista de atributos separados por comas para incluir en el resultado. La configuración predeterminada es todos los atributos. Si la estableces como una string vacía, no se generará ningún atributo. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:rule_inputs_and_outputs
: "true" -
Indica si se deben completar o no los campos rule_input y rule_output.
Etiquetas:terminal_output
- Valor predeterminado de
--query_file=<a string>
: "" -
Si se configura, la consulta leerá la consulta desde el archivo que se nombra aquí, en lugar de hacerlo en la línea de comandos. Es un error especificar aquí un archivo así como una consulta de línea de comandos.
Etiquetas:changes_inputs
- Valor predeterminado de
--[no]relative_locations
: "falso" -
Si es verdadero, la ubicación de los archivos Build en los resultados xml y proto será relativa. De forma predeterminada, el resultado de la ubicación es una ruta de acceso absoluta y no será coherente en todas las máquinas. Puedes configurar esta opción como verdadera para obtener un resultado coherente en todas las máquinas.
Etiquetas:terminal_output
- Configuración predeterminada de
--show_config_fragments=<off, direct or transitive>
: "desactivada" -
Muestra los fragmentos de configuración que requiere una regla y sus dependencias transitivas. Esto puede ser útil para evaluar cuánto se puede recortar un gráfico de destino configurado.
Etiquetas:affects_outputs
- Valor predeterminado de
--starlark:expr=<a string>
: "" -
Una expresión de Starlark para dar formato a cada destino configurado en el modo --output=starlark de cquery. El destino configurado está vinculado a "target". Si no se especifica --starlark:expr ni --starlark:file, la opción predeterminada será 'str(target.label)'. Es un error especificar --starlark:expr y --starlark:file.
Etiquetas:terminal_output
- Valor predeterminado de
--starlark:file=<a string>
: "" -
El nombre de un archivo que define una función de Starlark llamada "format", de un argumento, que se aplica a cada destino configurado para darle formato como una cadena. Es un error especificar --starlark:expr y --starlark:file. Consulta la ayuda de --output=starlark para obtener más detalles.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]tool_deps
: "true" -
Consulta: Si está inhabilitada, depende de “exec configuration” no se incluirán en el gráfico de la dependencia en el que opera la consulta. Una “configuración de ejecución” perímetro de dependencia, como el de cualquier "proto_library" al compilador de protocolos, por lo general, apunta a una herramienta ejecutada durante la compilación en lugar de a una parte del mismo “destino” .
Cquery: Si se inhabilita, filtra todos los destinos configurados que cruzan una transición de ejecución del objetivo de nivel superior que descubrió este objetivo configurado. Esto significa que, si el destino de nivel superior se encuentra en la configuración de destino, solo se mostrarán los destinos configurados que se encuentren también en esa configuración. Si el destino de nivel superior está en la configuración de ejecución, solo se mostrarán los destinos configurados de ejecución. Esta opción NO excluirá las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
- Valor predeterminado de
--transitions=<full, lite or none>
: "ninguno" -
El formato en el que cquery imprimirá la información de transición.
Etiquetas:affects_outputs
- Valor predeterminado de
--universe_scope=<comma-separated list of options>
: "" -
Un conjunto de patrones de destino separados por comas (aditivos y sustractivos). La consulta puede realizarse en el universo definido por el cierre transitivo de los objetivos especificados. Esta opción se usa para los comandos de consulta y cquery.
Para cquery, la entrada de esta opción son los destinos en los que se crean todas las respuestas, por lo que esta opción puede afectar las configuraciones y transiciones. Si no se especifica esta opción, se supone que los objetivos de nivel superior son los objetivos analizados de la expresión de consulta. Nota: Para cquery, no especificar esta opción puede hacer que la compilación se rompa si los objetivos analizados desde la expresión de consulta no se pueden compilar con las opciones de nivel superior.
Etiquetas:loading_and_analysis
- Opciones que activan optimizaciones del tiempo de compilación:
- Valor predeterminado de
--[no]experimental_filter_library_jar_with_program_jar
: "falso" -
Filtra ProgramJar de ProGuard para quitar las clases que también estén presentes en el LibraryJar.
Etiquetas:action_command_lines
- Valor predeterminado de
--[no]experimental_inmemory_dotd_files
: "true" -
Si se habilita, los archivos .d de C++ se pasarán a la memoria directamente desde los nodos de compilación remotos en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
yexperimental
- Valor predeterminado de
--[no]experimental_inmemory_jdeps_files
: "true" -
Si se habilita, los archivos de dependencia (.jdeps) generados a partir de compilaciones de Java se pasarán a la memoria directamente desde los nodos de compilación remotos en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
yexperimental
- Valor predeterminado de
--[no]experimental_objc_include_scanning
: "falso" -
Si se debe realizar, incluye el análisis del objetivo de C/C++.
Etiquetas:loading_and_analysis
,execution
ychanges_inputs
- Valor predeterminado de
--[no]experimental_retain_test_configuration_across_testonly
: "falso" -
Cuando se habilita, --trim_test_configuration no recortará la configuración de prueba para las reglas marcadas como testonly=1. El objetivo de esto es reducir los problemas de conflictos de acciones cuando las reglas que no son de prueba dependen de las reglas cc_test. No tiene efecto si --trim_test_configuration es falso.
Etiquetas:loading_and_analysis
yloses_incremental_state
- Valor predeterminado de
--[no]experimental_starlark_cc_import
: "falso" -
Si se habilita, se puede usar la versión de Starlark de cc_import.
Etiquetas:loading_and_analysis
yexperimental
- Valor predeterminado de
--[no]experimental_unsupported_and_brittle_include_scanning
: "falso" -
Establece si las entradas se limitan a la compilación C/C++ mediante el análisis de #include líneas de archivos de entrada. Esto puede mejorar el rendimiento y la incrementalidad disminuyendo el tamaño de los árboles de entrada de compilación. Sin embargo, también puede romper compilaciones porque el escáner de inclusión no implementa por completo la semántica del preprocesador de C. En particular, no comprende las directivas dinámicas #include y, también, ignora la lógica condicional del preprocesador. Úsala bajo tu propia responsabilidad. Se cerrarán todos los problemas relacionados con esta marca que se hayan presentado.
Etiquetas:loading_and_analysis
,execution
ychanges_inputs
- Valor predeterminado de
--[no]incremental_dexing
: "true" -
Realiza la mayor parte del trabajo para la conversión a DEX por separado para cada archivo jar.
Etiquetas:affects_outputs
,loading_and_analysis
yloses_incremental_state
- Valor predeterminado de
--[no]objc_use_dotd_pruning
: "true" -
Si se configura, los archivos .d emitidos por Clang se usarán para reducir el conjunto de entradas que se pasan a compilaciones objc.
Etiquetas:changes_inputs
yloading_and_analysis
- Valor predeterminado de
--[no]process_headers_in_dependencies
: "falso" -
Cuando se compila un //a:a de destino, procesa encabezados en todos los destinos de los que depende //a:a (si el procesamiento de encabezados está habilitado para la cadena de herramientas).
Etiquetas:execution
- Valor predeterminado de
--[no]trim_test_configuration
: "true" -
Cuando se habilita esta opción, las opciones relacionadas con las pruebas se borran debajo del nivel superior de la compilación. Cuando esta marca está activa, las pruebas no se pueden compilar como dependencias de reglas que no son de prueba, pero los cambios en las opciones relacionadas con pruebas no harán que las reglas que no son de prueba se vuelvan a analizar.
Etiquetas:loading_and_analysis
yloses_incremental_state
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Valor predeterminado de
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: “-.*” -
Imprime la información de depuración durante la resolución de la cadena de herramientas. La marca toma una regex, que se verifica con los tipos de la cadena de herramientas y los objetivos específicos para ver cuál depurar. Es posible que varias regex estén separadas con comas y, luego, cada regex se verifique por separado. Nota: El resultado de esta marca es muy complejo y es probable que solo sea útil para los expertos en la resolución de la cadena de herramientas.
Etiquetas:terminal_output
- Opciones que especifican o modifican una entrada genérica para un comando de Bazel que no se encuentra en otras categorías.
- Se acumulan
--flag_alias=<a 'name=value' flag alias>
usos múltiples -
Establece un nombre abreviado para una bandera de Starlark. Toma un solo par clave-valor con el formato "<clave>=<valor>" como argumento.
Etiquetas:changes_inputs
- Valor predeterminado de
--[no]incompatible_default_to_explicit_init_py
: "falso" -
Esta marca cambia el comportamiento predeterminado para que los archivos __init__.py ya no se creen automáticamente en los runfiles de los objetivos de Python. De manera precisa, cuando un destino py_binary o py_test tiene legacy_create_init configurado en “auto” (configuración predeterminada), se trata como falsa solo si se configura esta marca. Consulta https://github.com/bazelbuild/bazel/issues/10076.
Etiquetas:affects_outputs
yincompatible_change
- Valor predeterminado de
--[no]incompatible_py2_outputs_are_suffixed
: "true" -
Si es verdadero, los destinos compilados en la configuración de Python 2 aparecerán en una raíz de salida que incluya el sufijo "-py2", mientras que los destinos compilados para Python 3 aparecerán en una raíz sin sufijo relacionado con Python. Esto significa que el symlink de conveniencia "bazel-bin" apuntará a los objetivos de Python 3 en lugar de a Python 2. Si habilitas esta opción, también se recomienda habilitar “--incompatible_py3_is_default”.
Etiquetas:affects_outputs
yincompatible_change
- Valor predeterminado de
--[no]incompatible_py3_is_default
: "true" -
Si el valor es verdadero, los destinos "py_binary" y "py_test" que no establezcan sus atributos "python_version" (o "default_python_version") pasarán a ser PY3 de forma predeterminada en lugar de PY2. Si configuras esta marca, también se recomienda configurar `--incompatible_py2_outputs_are_suffixed`.
Etiquetas:loading_and_analysis
,affects_outputs
yincompatible_change
- Valor predeterminado de
--[no]incompatible_use_python_toolchains
: "true" -
Si se configura como verdadera, las reglas ejecutables nativas de Python usarán el entorno de ejecución de Python especificado por la cadena de herramientas de Python, en lugar del entorno de ejecución proporcionado por marcas heredadas como --python_top.
Etiquetas:loading_and_analysis
yincompatible_change
- Valor predeterminado de