bazel [<startup options>] <command> [<args>]
bazel [<startup options>] <command> [<args>] -- [<target patterns>]
Sintaxis de opciones
Las opciones se pueden pasar a Bazel de diferentes maneras. Las opciones que requieren un valor se pueden pasar con un signo igual o un espacio:
--<option>=<value> --<option> <value>
-<short_form> <value>
Las opciones booleanas se pueden habilitar de la siguiente manera:
--<option> --<option>=[true|yes|1]
--no<option> --<option>=[false|no|0]
Por lo general, las opciones de tres estados se configuran como automáticas de forma predeterminada y se pueden habilitar de forma forzosa 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 |
Canoniza una lista de opciones de Bazel. |
clean |
Quita los archivos de salida y, de manera opcional, detiene el servidor. |
coverage |
Genera un informe de cobertura de código para los destinos de prueba especificados. |
cquery |
Carga, analiza y consulta los destinos especificados con configuraciones. |
dump |
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 los comandos o el índice. |
info |
Muestra información del entorno de ejecución sobre el servidor de Bazel. |
license |
Imprime la licencia de este software. |
mobile-install |
Instala destinos en dispositivos móviles. |
mod |
Consulta el gráfico de dependencias externas de Bzlmod. |
print_action |
Imprime los argumentos de la línea de comandos para compilar un archivo. |
query |
Ejecuta una consulta de gráfico de dependencias. |
run |
Ejecuta el destino especificado. |
shutdown |
Detiene el servidor de Bazel. |
sync |
Sincroniza todos los repositorios especificados en el archivo del lugar de trabajo. |
test |
Compila y ejecuta los objetivos de prueba especificados. |
vendor |
Recupera repositorios externos en una carpeta especificada por la marca --vendor_dir. |
version |
Imprime la información de la versión de bazel. |
Opciones de inicio
- Opciones que aparecen antes del comando y que el cliente analiza:
--[no]autodetect_server_javabase
predeterminado: "true"-
Cuando se pasa --noautodetect_server_javabase, Bazel no recurre al JDK local para ejecutar el servidor de Bazel y, en su lugar, sale.
Etiquetas:affects_outputs
,loses_incremental_state
- Valor predeterminado de
--[no]batch
: "falso" -
Si se establece, Bazel se ejecutará solo como un proceso de cliente sin un servidor, en lugar de en el modo cliente-servidor estándar. Esta función dejó de estar disponible y se quitará. Para evitar que queden servidores, es preferible que apagues el servidor de forma explícita.
Etiquetas:loses_incremental_state
,bazel_internal_configuration
,deprecated
- Valor predeterminado de
--[no]batch_cpu_scheduling
: "falso" -
Solo en Linux; usa la programación de CPU “por lotes” para Blaze. Esta política es útil para cargas de trabajo que no son interactivas, pero no quieren disminuir su valor de agrado. Consulta "man 2 sched_setscheduler". Si es falso, Bazel no realiza una llamada al sistema.
Etiquetas:host_machine_resource_optimizations
--bazelrc=<path>
predeterminado: Consulta la descripción-
Es la ubicación del archivo .bazelrc del usuario que contiene los valores predeterminados de las opciones de Bazel. /dev/null indica que se ignorarán todos los demás `--bazelrc`, lo que es útil para inhabilitar la búsqueda de un archivo rc de usuario, p.ej., en compilaciones de lanzamiento.
Esta opción también se puede especificar varias veces.
Por ejemplo, con `--bazelrc=x.rc --bazelrc=y.rc --bazelrc=/dev/null --bazelrc=z.rc`,
1) Se leen x.rc y y.rc.
2) Se ignora z.rc debido al /dev/null anterior.
Si no se especifica, Bazel usa el primer archivo .bazelrc que encuentra en las siguientes dos ubicaciones: el directorio del espacio de trabajo y, luego, el directorio principal del usuario.
Nota: Las opciones de línea de comandos siempre reemplazarán cualquier opción en bazelrc.
Etiquetas:changes_inputs
- 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
--[no]client_debug
predeterminado: “false”-
Si es verdadero, registra la información de depuración del cliente en stderr. Cambiar esta opción no hará que se reinicie el servidor.
Etiquetas:affects_outputs
,bazel_monitoring
--connect_timeout_secs=<an integer>
predeterminado: “30”-
La cantidad de tiempo que el cliente espera cada intento de conectarse al servidor
Etiquetas:bazel_internal_configuration
--digest_function=<hash function>
predeterminado: Consulta la descripción-
Es la función hash que se usará para calcular los resúmenes de archivos.
Etiquetas:loses_incremental_state
,bazel_internal_configuration
--[no]expand_configs_in_place
predeterminado: "true"-
Se cambió la expansión de las marcas --config para que se realice en el lugar, en lugar de una expansión de punto fijo entre las opciones de rc normales y las opciones especificadas en la línea de comandos.
Etiquetas:no_op
,deprecated
- Valor predeterminado de
--failure_detail_out=<path>
: ver descripción -
Si se establece, especifica una ubicación para escribir un mensaje de protobuf failure_detail si el servidor experimenta una falla y no puede informarla a través de gRPC, como de costumbre. De lo contrario, la ubicación será ${OUTPUT_BASE}/failure_detail.rawproto.
Etiquetas:affects_outputs
,loses_incremental_state
--[no]home_rc
predeterminado: "true"-
Busca o no el archivo bazelrc principal 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
,host_machine_resource_optimizations
--[no]ignore_all_rc_files
predeterminado: “false”-
Inhabilita todos los archivos rc, independientemente de los valores de otras marcas que modifiquen rc, incluso si estas marcas aparecen más adelante en la lista de opciones de inicio.
Etiquetas:changes_inputs
- Valor predeterminado de
--io_nice_level={-1,0,1,2,3,4,5,6,7}
: "-1" -
Solo en Linux. Establece un nivel de 0 a 7 para la programación de E/S del mejor esfuerzo con la llamada al sistema sys_ioprio_set. 0 es la prioridad más alta y 7 es la más baja. El programador anticipado solo puede respetar hasta la prioridad 4. Si se establece en un valor negativo, Bazel no realiza una llamada al sistema.
Etiquetas:host_machine_resource_optimizations
--local_startup_timeout_secs=<an integer>
predeterminado: "120"-
Es la cantidad máxima de tiempo que el cliente espera para conectarse al servidor.
Etiquetas:bazel_internal_configuration
--macos_qos_class=<a string>
predeterminado: "predeterminado"-
Establece la clase de servicio de QoS del servidor bazel cuando se ejecuta en macOS. Esta marca no tiene efecto en ninguna otra plataforma, 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
--max_idle_secs=<integer>
predeterminado: “10800”-
Es la cantidad de segundos que el servidor de compilación esperará inactivo antes de apagarse. Cero significa que el servidor nunca se apagará. Solo se lee al iniciar el servidor. Si cambias esta opción, no se reiniciará el servidor.
Etiquetas:eagerness_to_exit
,loses_incremental_state
- Valor predeterminado de
--output_base=<path>
: ver descripción -
Si se configura, especifica la ubicación de salida en la que se escribirán todos los resultados de la compilación. De lo contrario, la ubicación será ${OUTPUT_ROOT}/_blaze_${USER}/${MD5_OF_WORKSPACE_ROOT}. Nota: Si especificas una opción diferente de una a la siguiente invocación de Bazel para este valor, es probable que inicies un nuevo servidor de Bazel adicional. Bazel inicia exactamente un servidor por base de salida especificada. Por lo general, hay una base de salida por espacio de trabajo. Sin embargo, con esta opción, puedes tener varias bases de salida por espacio de trabajo y, de esta manera, ejecutar varias compilaciones para el mismo cliente en la misma máquina de forma simultánea. Consulta la sección de ayuda sobre cómo apagar un servidor de Bazel.
Etiquetas:affects_outputs
,loses_incremental_state
- Valor predeterminado de
--output_user_root=<path>
: ver descripción -
Es el directorio específico del usuario debajo del cual se escriben todos los resultados de la compilación. De forma predeterminada, esta es una función de $USER, pero si especificas una constante, los resultados de la compilación se pueden compartir entre los usuarios que colaboran.
Etiquetas:affects_outputs
,loses_incremental_state
--[no]preemptible
predeterminado: “false”-
Si es verdadero, se puede anular el comando si se inicia otro.
Etiquetas:eagerness_to_exit
--server_jvm_out=<path>
predeterminado: Consulta la descripción-
Es la ubicación en la que se escribirá el resultado de la JVM del servidor. Si no se establece, se establece de forma predeterminada en una ubicación en output_base.
Etiquetas:affects_outputs
,loses_incremental_state
--[no]shutdown_on_low_sys_mem
predeterminado: “false”-
Si se configura max_idle_secs y el servidor de compilación ha estado inactivo durante un tiempo, apágalo cuando el sistema tenga poca memoria RAM libre. Solo en Linux.
Etiquetas:eagerness_to_exit
,loses_incremental_state
--[no]system_rc
predeterminado: "true"-
Indica si se debe buscar o no el bazelrc en todo el sistema.
Etiquetas:changes_inputs
--[no]unlimit_coredumps
predeterminado: “false”-
Eleva el límite de volcado de núcleo suave al límite duro para que se puedan crear volcados de núcleo del servidor (incluida la JVM) y del cliente en condiciones comunes. 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
--[no]watchfs
predeterminado: “false”-
Si es verdadero, bazel intenta usar el servicio de supervisión de archivos del sistema operativo para los cambios locales en lugar de analizar cada archivo en busca de cambios.
Etiquetas:deprecated
- Valor predeterminado de
--[no]windows_enable_symlinks
: "falso" -
Si el valor es "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
--[no]workspace_rc
predeterminado: "true"-
Determina si se debe buscar o no el archivo bazelrc del espacio de trabajo en $workspace/.bazelrc.
Etiquetas:changes_inputs
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan
--host_jvm_args=<jvm_arg>
usos múltiples - Son marcas para pasar a la JVM que ejecuta Blaze.
--host_jvm_debug
-
Opción de conveniencia para agregar algunas marcas de inicio de JVM adicionales, que hacen que la JVM espere durante el inicio hasta que te conectes desde un depurador compatible con JDWP (como Eclipse) al puerto 5005.
Se expande a:
--host_jvm_args=-Xdebug
--host_jvm_args=-Xrunjdwp:transport=dt_socket,server=y,address=5005
--host_jvm_profile=<profiler_name>
predeterminado: ""- Opción de conveniencia para agregar algunas marcas de inicio de JVM específicas del generador de perfiles o depurador. Bazel tiene una lista de valores conocidos que asigna a marcas de inicio de JVM codificadas, posiblemente buscando algunas rutas de acceso fijas para ciertos archivos.
--server_javabase=<jvm path>
predeterminado: ""- Ruta de acceso a la JVM que se usa para ejecutar Bazel.
Opciones comunes a todos los comandos
- Opciones que aparecen antes del comando y que el cliente analiza:
--http_connector_attempts=<an integer>
predeterminado: “8”-
Es la cantidad máxima de intentos para las descargas de HTTP.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--http_connector_retry_max_timeout=<An immutable length of time.>
: "0s" -
Es el tiempo de espera máximo para los reintentos de descarga HTTP. Con un valor de 0, no se define un tiempo de espera máximo.
Etiquetas:bazel_internal_configuration
--http_max_parallel_downloads=<an integer>
predeterminado: “8”-
Es la cantidad máxima de descargas de HTTP paralelas.
Etiquetas:bazel_internal_configuration
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escalar todos los tiempos de espera relacionados con las descargas http según el factor determinado
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de compilación:
--experimental_ui_max_stdouterr_bytes=<an integer in (-1)-1073741819 range>
predeterminado: “1048576”-
Es el tamaño máximo de los archivos stdout / stderr que se imprimirán en la consola. -1 implica que no hay límite.
Etiquetas:execution
- Valor predeterminado de
--[no]incompatible_remote_dangling_symlinks
: "true" -
Si se establece como verdadero, se permite que los symlinks subidos a una caché remota o de disco estén colgados.
Etiquetas:execution
,incompatible_change
--[no]incompatible_remote_symlinks
predeterminado: "true"-
Si se establece como verdadero, Bazel siempre subirá los symlinks como tales a una caché remota o en el disco. De lo contrario, los symlinks relativos no colgantes (y solo esos) se subirán como el archivo o directorio al que apuntan.
Etiquetas:execution
,incompatible_change
- Opciones que configuran la cadena de herramientas utilizada para la ejecución de acciones:
--[no]incompatible_enable_proto_toolchain_resolution
predeterminado: “false”-
Si es verdadero, las reglas proto lang definen cadenas de herramientas desde los repositorios rules_proto, rules_java y rules_cc.
Etiquetas
:loading_and_analysis
,incompatible_change
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
--bep_maximum_open_remote_upload_files=<an integer>
predeterminado: “-1”-
Cantidad máxima de archivos abiertos permitidos durante la carga de artefactos de BEP.
Etiquetas:affects_outputs
--remote_download_all
-
Descarga todas las salidas remotas en la máquina local. Esta marca es un alias para --remote_download_outputs=all.
Se expande a:
--remote_download_outputs=all
Etiquetas:affects_outputs
--remote_download_minimal
-
No descarga ningún resultado de compilación remota en la máquina local. Esta marca es un alias para --remote_download_outputs=minimal.
Se expande a:
--remote_download_outputs=minimal
Etiquetas:affects_outputs
--remote_download_outputs=<all, minimal or toplevel>
predeterminado: “nivel superior”-
Si se configura como “mínimo”, no se descargarán resultados de compilación remota en la máquina local, excepto los que requieren las acciones locales. Si se establece en "toplevel", se comporta como "minimal", excepto que también descarga los resultados de los destinos de nivel superior en la máquina local. Ambas opciones pueden reducir significativamente los tiempos de compilación si el ancho de banda de la red es un cuello de botella.
Etiquetas:affects_outputs
--remote_download_symlink_template=<a string>
predeterminado: ""-
En lugar de descargar resultados de compilación remotos en la máquina local, crea vínculos simbólicos. El destino de los vínculos simbólicos se puede especificar en forma de una cadena de plantilla. Esta cadena de plantilla puede contener {hash} y {size_bytes} que se expanden al hash del objeto y al tamaño en bytes, respectivamente. Estos vínculos simbólicos pueden, por ejemplo, apuntar a un sistema de archivos FUSE que cargue objetos del CAS a pedido.
Etiquetas:affects_outputs
--remote_download_toplevel
- Solo descarga resultados remotos de destinos de nivel superior en la máquina local. Esta marca es un alias de --remote_download_outputs=toplevel.
Se expande a:
--remote_download_outputs=toplevel
Etiquetas:affects_outputs
- Se acumulan varios usos de
--repo_env=<a 'name=value' assignment with an optional value part>
-
Especifica variables de entorno adicionales de modo que estén disponibles solo para las reglas del repositorio. Ten en cuenta que, de todos modos, las reglas del repositorio ven el entorno completo, pero de esta manera la información de configuración se puede pasar a los repositorios a través de opciones sin invalidar el gráfico de acciones.
Etiquetas:action_command_lines
- Opciones que afectan la exactitud con la que Bazel aplica de manera forzosa las 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 de .bzl se degradan a advertencias.
Etiquetas:build_file_semantics
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación a la que se puede acceder para archivos BUILD, archivos .bzl o WORKSPACE:
--[no]enable_bzlmod
predeterminado: "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
--[no]enable_workspace
predeterminado: "true"-
Si es verdadero, habilita el sistema WORKSPACE heredado para dependencias externas. Consulta https://bazel.build/external/overview para obtener más información.
Etiquetas:loading_and_analysis
--[no]experimental_action_resource_set
predeterminado: "true"-
Si se establece como verdadero, ctx.actions.run() y ctx.actions.run_shell() aceptan un parámetro resource_set para la ejecución local. De lo contrario, se establecerá de forma predeterminada en 250 MB para la memoria y 1 CPU.
Etiquetas:execution
,build_file_semantics
,experimental
--[no]experimental_bzl_visibility
predeterminado: "true"-
Si está habilitada, agrega una función "visibility()` a la que los archivos .bzl pueden llamar durante la evaluación de nivel superior para establecer su visibilidad con el fin de las sentencias load().
Etiquetas:loading_and_analysis
,experimental
-
Si se configura como verdadera, estarán disponibles los atributos de la regla y los métodos de la API de Starlark necesarios para la regla cc_shared_library.
Etiquetas:build_file_semantics
,loading_and_analysis
,experimental
--[no]experimental_cc_static_library
predeterminado: “false”-
Si se establece como verdadera, estarán disponibles los atributos de la regla y los métodos de la API de Starlark necesarios para la regla cc_static_library.
Etiquetas:build_file_semantics
,loading_and_analysis
,experimental
- Valor predeterminado de
--[no]experimental_disable_external_package
: "falso" -
Si se establece en verdadero, el paquete //external generado automáticamente ya no estará disponible. Bazel aún no podrá analizar el archivo "external/BUILD", pero funcionarán los globs que lleguen a external/ desde el paquete sin nombre.
Etiquetas:loading_and_analysis
,loses_incremental_state
,experimental
- Valor predeterminado de
--[no]experimental_enable_android_migration_apis
: "falso" -
Si se establece como verdadero, habilita las APIs necesarias para admitir la migración de Starlark de Android.
Etiquetas:build_file_semantics
--[no]experimental_enable_scl_dialect
predeterminado: “false”-
Si se establece como verdadero, se pueden usar archivos .scl en las sentencias load().
Etiquetas:build_file_semantics
- Valor predeterminado de
--[no]experimental_google_legacy_api
: "falso" -
Si se establece en "true", expone varias partes experimentales de la API de compilación de Starlark relacionadas con el código heredado de Google.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_isolated_extension_usages
predeterminado: “false”-
Si es verdadero, habilita el parámetro <code>isolate</code> en la función <a href="https://bazel.build/rules/lib/globals/module#use_extension"><code>use_extension</code></a>.
Etiquetas:loading_and_analysis
--[no]experimental_java_library_export
predeterminado: “false”-
Si se habilita, se encuentra disponible el módulo experimental_java_library_export_do_not_use.
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]experimental_platforms_api
: "falso" -
Si se establece como verdadero, habilita varias APIs de Starlark relacionadas con la plataforma que son útiles para depurar.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repo_remote_exec
predeterminado: “false”-
Si se establece como verdadero, repository_rule obtiene algunas capacidades de ejecución remota.
Etiquetas:build_file_semantics
,loading_and_analysis
,experimental
--[no]experimental_sibling_repository_layout
predeterminado: “false”-
Si se establece como verdadero, los repositorios que no son principales se plantan como symlinks al repositorio principal en la raíz de ejecución. Es decir, todos los repositorios son elementos secundarios directos del directorio $output_base/execution_root. Esto tiene el efecto secundario de liberar $output_base/execution_root/__main__/external para el directorio "externo" de nivel superior real.
Etiquetas:action_command_lines
,bazel_internal_configuration
,loading_and_analysis
,loses_incremental_state
,experimental
-
Si se establece como verdadero, las etiquetas se propagarán de un objetivo a los requisitos de ejecución de las acciones. De lo contrario, no se propagarán. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/8830.
Etiquetas:build_file_semantics
,experimental
--[no]incompatible_always_check_depset_elements
predeterminado: "true"-
Verifica la validez de los elementos agregados a los depsets en todos los constructores. Los elementos deben ser inmutables, pero, históricamente, el constructor depset(direct=…) se olvidó de verificarlo. Usa tuplas en lugar de listas en los elementos de depset. Consulta https://github.com/bazelbuild/bazel/issues/10313 para obtener más información.
Etiquetas:build_file_semantics
,incompatible_change
--incompatible_autoload_externally=<comma-separated set of options>
predeterminado: ""-
Es una lista separada por comas de reglas (o de otros símbolos) que antes formaban parte de Bazel y que ahora se deben recuperar de sus respectivos repositorios externos. El objetivo de esta marca es facilitar la migración de reglas fuera de Bazel. Consulta también https://github.com/bazelbuild/bazel/issues/23043.
Un símbolo que se carga automáticamente dentro de un archivo se comporta como si su definición integrada en Bazel se reemplazara por su definición nueva canónica en un repositorio externo. Para un archivo BUILD, esto significa, en esencia, agregar implícitamente una sentencia load(). Para un archivo .bzl, es una sentencia load() o un cambio en un campo del objeto "native", según si el símbolo cargado automáticamente es una regla.
Bazel mantiene una lista codificada de todos los símbolos que se pueden cargar automáticamente. Solo esos símbolos pueden aparecer en esta marca. Para cada símbolo, Bazel conoce la nueva ubicación de definición en un repositorio externo, así como un conjunto de repositorios con casos especiales que no deben cargarlo automáticamente para evitar crear ciclos.
Un elemento de lista de “+foo” en esta marca hace que el símbolo foo se cargue automáticamente, excepto en los repositorios exentos de foo, dentro de los cuales la versión de foo definida por Bazel aún está disponible.
Un elemento de lista de “foo” activa la carga automática como se muestra arriba, pero la versión de foo definida por Bazel no está disponible para los repositorios excluidos. Esto garantiza que el repositorio externo de foo no dependa de la implementación anterior de Bazel de foo. Un elemento de lista de "-foo" no activa ninguna carga automática, pero hace que la versión de foo definida por Bazel no sea accesible en todo el espacio de trabajo. Se usa para validar que el espacio de trabajo esté listo para que se borre la definición de foo de Bazel.
Si no se nombra un símbolo en esta marca, seguirá funcionando de forma normal; no se realizará la carga automática ni se suprimirá la versión definida por Bazel. Para la configuración, consulta https://github.com/bazelbuild/bazel/blob/master/src/main/java/com/google/devtools/build/lib/packages/AutoloadSymbols.java. Como atajo, también se puede usar todo el repositorio, por ejemplo, +@rules_python cargará automáticamente todas las reglas de Python.
Etiquetas:loses_incremental_state
,build_file_semantics
,incompatible_change
--[no]incompatible_depset_for_java_output_source_jars
predeterminado: "true"-
Cuando es verdadero, Bazel ya no muestra una lista de java_info.java_output[0].source_jars, sino un conjunto de dependencias.
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]incompatible_depset_for_libraries_to_link_getter
: "true" -
Cuando es verdadero, Bazel ya no muestra una lista de linking_context.libraries_to_link, sino que muestra un conjunto de dependencias.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_disable_objc_library_transition
predeterminado: "true"-
Inhabilita la transición personalizada de objc_library y hereda del destino de nivel superior en su lugar
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_disable_starlark_host_transitions
predeterminado: “false”-
Si se establece como verdadero, los atributos de la regla no pueden establecer "cfg = "host"'. En su lugar, las reglas deben configurar 'cfg = "exec"'.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_disable_target_provider_fields
predeterminado: “false”-
Si se configura como verdadera, inhabilita la capacidad de acceder a los proveedores en objetos de "destino" a través de la sintaxis de campo. En su lugar, usa la sintaxis de clave de proveedor. Por ejemplo, en lugar de usar "ctx.attr.dep.my_info" para acceder a "my_info" desde dentro de una función de implementación de reglas, usa "ctx.attr.dep[MyInfo]". Consulta https://github.com/bazelbuild/bazel/issues/9014 para obtener más información.
Etiquetas:build_file_semantics
,incompatible_change
- Valor predeterminado de
--[no]incompatible_disallow_empty_glob
: "falso" -
Si se establece en verdadero, el valor predeterminado del argumento "allow_empty" de glob() es falso.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_disallow_struct_provider_syntax
predeterminado: “false”-
Si se establece como verdadero, es posible que las funciones de implementación de reglas no devuelvan una struct. En su lugar, deben mostrar una lista de instancias de proveedor.
Etiquetas:build_file_semantics
,incompatible_change
- Valor predeterminado de
--[no]incompatible_enable_deprecated_label_apis
: "true" -
Si está habilitada, se pueden usar ciertas APIs obsoletas (native.repository_name, Label.workspace_name, Label.relative).
Etiquetas:loading_and_analysis
--[no]incompatible_existing_rules_immutable_view
predeterminado: "true"-
Si se establece en verdadero, native.existing_rule y native.existing_rules muestran objetos de vista inmutables ligeros en lugar de diccionarios mutables.
Etiquetas:build_file_semantics
,loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]incompatible_fail_on_unknown_attributes
: "true" -
Si está habilitada, fallarán los objetivos que tengan atributos desconocidos establecidos en Ninguno.
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]incompatible_fix_package_group_reporoot_syntax
: "true" -
En el atributo "packages" de package_group, cambia el significado del valor "//…" para que haga referencia a todos los paquetes del repositorio actual en lugar de a todos los paquetes de cualquier repositorio. Puedes usar el valor especial "public" en lugar de "//…" para obtener el comportamiento anterior. Esta marca requiere que también se habilite --incompatible_package_group_has_public_syntax.
Etiquetas:build_file_semantics
,incompatible_change
- Valor predeterminado de
--[no]incompatible_java_common_parameters
: "true" -
Si se establece como verdadero, se quitarán todos los parámetros output_jar y host_javabase en pack_sources y host_javabase en compile.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_merge_fixed_and_default_shell_env
predeterminado: "true"-
Si está habilitada, las acciones registradas con ctx.actions.run y ctx.actions.run_shell con "env" y "use_default_shell_env = True" especificadas usarán un entorno obtenido del entorno de shell predeterminado anulando con los valores pasados a "env". Si se inhabilita, el valor de "env" se ignora por completo en este caso.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_new_actions_api
predeterminado: "true"-
Si se configura como verdadera, la API para crear acciones solo estará disponible en "ctx.actions", no en "ctx".
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_no_attr_license
predeterminado: "true"-
Si se establece como verdadero, inhabilita la función "attr.license".
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_no_implicit_file_export
predeterminado: “false”-
Si se establece, los archivos de origen (usados) son privados del paquete, a menos que se exporten de forma explícita. Consulta https://github.com/bazelbuild/proposals/blob/master/designs/2019-10-24-file-visibility.md
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_no_implicit_watch_label
predeterminado: “false”-
Si es verdadero, los métodos en <code>repository_ctx</code> a los que se les pasa una etiqueta ya no supervisarán automáticamente el archivo de esa etiqueta en busca de cambios, incluso si <code>watch = "no"</code>, y <code>repository_ctx.path</code> ya no hace que se supervise la ruta de acceso que se muestra. En su lugar, usa <code>repository_ctx.watch</code>.
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]incompatible_no_rule_outputs_param
: "falso" -
Si se establece como verdadero, inhabilita el parámetro "outputs" de la función Starlark "rule()`".
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_objc_provider_remove_linking_info
predeterminado: “false”-
Si se establece como verdadero, se quitarán las APIs de ObjcProvider para vincular información.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_package_group_has_public_syntax
predeterminado: "true"-
En el atributo "packages" de package_group, permite escribir "public" o "private" para hacer referencia a todos los paquetes o a ninguno, respectivamente.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_require_linker_input_cc_api
predeterminado: "true"-
Si 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
,incompatible_change
--[no]incompatible_run_shell_command_string
predeterminado: "true"-
Si se establece como verdadero, el parámetro de comando de actions.run_shell solo aceptará cadenas
de etiquetas
:build_file_semantics
,incompatible_change
--[no]incompatible_stop_exporting_language_modules
predeterminado: “false”-
Si está habilitado, ciertos módulos específicos de lenguaje (como "cc_common") no están disponibles en los archivos .bzl del usuario y solo se puede llamar desde sus respectivos repositorios de reglas.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_struct_has_no_methods
predeterminado: “false”-
Inhabilita los métodos to_json y to_proto de struct, que contaminan el espacio de nombres del campo struct. En su lugar, usa json.encode o json.encode_indent para JSON, o proto.encode_text para textproto.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_top_level_aspects_require_providers
predeterminado: “false”-
Si se establece como verdadero, el aspecto de nivel superior respetará sus proveedores obligatorios y solo se ejecutará en los destinos de nivel superior cuyos proveedores anunciados por las reglas satisfagan los proveedores obligatorios del aspecto.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_unambiguous_label_stringification
predeterminado: "true"-
Cuando sea verdadero, Bazel convertirá la etiqueta @//foo:bar en @//foo:bar, en lugar de //foo:bar. Esto solo afecta el comportamiento de str(), el operador %, etcétera. El comportamiento de repr() no cambia. Consulta https://github.com/bazelbuild/bazel/issues/15916 para obtener más información.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_use_cc_configure_from_rules_cc
predeterminado: “false”-
Cuando sea verdadero, Bazel ya no permitirá usar cc_configure desde @bazel_tools. Consulta https://github.com/bazelbuild/bazel/issues/10134 para obtener detalles y las instrucciones de migración.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_use_plus_in_repo_names
predeterminado: “false”-
Si es verdadero, usa el signo más (+) como separador en los nombres de repositorios canónicos, en lugar de la virgulilla (~). Esto se hace para abordar problemas graves de rendimiento en Windows. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/22865.
Etiquetas:loading_and_analysis
--[no]incompatible_visibility_private_attributes_at_definition
predeterminado: "true"-
Si se establece como "true", se verifica la visibilidad de los atributos de reglas privadas en relación con la definición de la regla y, si no es visible, se recurre al uso de la regla.
Etiquetas:build_file_semantics
,incompatible_change
--max_computation_steps=<a long integer>
predeterminado: “0”-
Es la cantidad máxima de pasos de procesamiento de Starlark que puede ejecutar un archivo BUILD (cero significa que no hay límite).
Etiquetas:build_file_semantics
--nested_set_depth_limit=<an integer>
predeterminado: “3500”-
Es la profundidad máxima del grafo interna de un depset (también conocido como NestedSet), por encima de la cual fallará el constructor depset().
Etiquetas:loading_and_analysis
- Valor predeterminado de
--repositories_without_autoloads=<comma-separated set of options>
: "" -
Una lista de repositorios adicionales (más allá de los codificados que Bazel conoce) a los que no se deben agregar las cargas automáticas. Por lo general, esto debe contener repositorios de los que depende de forma transitiva un repositorio que se puede cargar automáticamente (y que, por lo tanto, pueden crear un ciclo).
Etiquetas:loses_incremental_state
,build_file_semantics
,incompatible_change
- Opciones que activan optimizaciones del tiempo de compilación:
--[no]heuristically_drop_nodes
predeterminado: “false”-
Si es verdadero, Blaze quitará los nodos FileState y DirectoryListingState después de que se complete el nodo File y DirectoryListing relacionados para ahorrar memoria. Esperamos que sea menos probable que se vuelvan a necesitar estos nodos. Si es así, el programa los volverá a evaluar.
Etiquetas:loses_incremental_state
--[no]incompatible_do_not_split_linking_cmdline
predeterminado: "true"-
Cuando es verdadero, Bazel ya no modifica las marcas de línea de comandos que se usan para la vinculación y tampoco decide de forma selectiva qué marcas van al archivo de parámetros y cuáles no. Consulta https://github.com/bazelbuild/bazel/issues/7670 para obtener más información.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]keep_state_after_build
predeterminado: "true"-
Si es falso, Blaze descartará el estado en memoria de esta compilación cuando finalice. Las compilaciones posteriores no tendrán ninguna incrementalidad con respecto a esta.
Etiquetas:loses_incremental_state
--[no]track_incremental_state
predeterminado: "true"-
Si se establece como falsa, Blaze no conservará datos que permitan invalidar y reevaluar las compilaciones incrementales para ahorrar memoria en esta compilación. Las compilaciones posteriores no tendrán ninguna incrementalidad con respecto a esta. Por lo general, querrás especificar --batch cuando establezcas este valor en falso.
Etiquetas:loses_incremental_state
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]announce_rc
predeterminado: “false”-
Indica si se deben anunciar las opciones de rc.
Etiquetas:affects_outputs
- 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 uno de los directorios especificados por --package_path.
Etiquetas:terminal_output
--bes_backend=<a string>
predeterminado: ""-
Especifica el extremo de backend del servicio de eventos de compilación (BES) en el formato [SCHEME://]HOST[:PORT]. La configuración predeterminada es inhabilitar las cargas a BES. Los esquemas compatibles son grpc y grpcs (grpc con TLS habilitado). Si no se proporciona un esquema, Bazel supone que se trata de GRPC.
Etiquetas:affects_outputs
--[no]bes_check_preceding_lifecycle_events
predeterminado: “false”-
Establece el campo check_preceding_lifecycle_events_present en PublishBuildToolEventStreamRequest, que le indica a BES que verifique si recibió anteriormente los eventos InvocationAttemptStarted y BuildEnqueued que coincidan con el evento actual de la herramienta.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--bes_header=<a 'name=value' assignment>
-
Especifica un encabezado en el formato NAME=VALUE que se incluirá en las solicitudes de BES. Se pueden pasar varios encabezados si especificas la marca varias veces. Los múltiples valores para el mismo nombre se convertirán en una lista separada por comas.
Etiquetas:affects_outputs
--bes_instance_name=<a string>
predeterminado: Consulta la descripción-
Especifica el nombre de la instancia en el que la BES conservará los BEP subidos. La configuración predeterminada es nula.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--bes_keywords=<comma-separated list of options>
. -
Especifica una lista de palabras clave de notificación que se agregarán al conjunto predeterminado de palabras clave publicadas en BES ("command_name=<command_name>", "protocol_name=BEP"). El valor predeterminado es ninguno.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]bes_lifecycle_events
: "true" -
Especifica si se deben publicar eventos del ciclo de vida de BES. (el valor predeterminado es "true").
Etiquetas:affects_outputs
--bes_oom_finish_upload_timeout=<An immutable length of time.>
predeterminado: "10m"-
Especifica cuánto tiempo debe esperar bazel para que se complete la carga de BES/BEP mientras se produce una falta de memoria. Esta marca garantiza la finalización cuando la JVM tiene una fragmentación grave de GC y no puede avanzar en ningún subproceso de usuario.
Etiquetas:bazel_monitoring
--bes_outerr_buffer_size=<an integer>
predeterminado: “10240”-
Especifica el tamaño máximo de stdout o stderr que se almacenará en búfer en BEP, antes de que se informe como un evento de progreso. Las 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
--bes_proxy=<a string>
predeterminado: Consulta la descripción- Conéctate al servicio de eventos de compilación a través de un proxy. Actualmente, esta marca solo se puede usar para configurar un socket de dominio Unix (unix:/path/to/socket).
--bes_results_url=<a string>
predeterminado: ""-
Especifica la URL base en la que un usuario puede ver la información que se transmite al backend de BES. Bazel enviará a la terminal la URL anexada por el ID de invocación.
Etiquetas:terminal_output
- Se acumulan varios usos de
--bes_system_keywords=<comma-separated list of options>
-
Especifica una lista de palabras clave de notificación que se incluirán directamente, sin el prefijo "user_keyword=" incluido para las palabras clave proporcionadas a través de --bes_keyword. Se diseñó para operadores de servicios de compilación que establecen --bes_lifecycle_events=false y que incluyen palabras clave cuando llaman a PublishLifecycleEvent. La compilación de operadores de servicio con esta marca debería evitar que los usuarios anulen el valor de la marca.
Etiquetas:affects_outputs
--bes_timeout=<An immutable length of time.>
predeterminado: “0s”-
Especifica cuánto tiempo debe esperar bazel para que se complete la carga de BES/BEP después de que finalicen la compilación y las pruebas. Un tiempo de espera válido es un número natural seguido de una unidad: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). El valor predeterminado es “0”, lo que significa que no hay tiempo de espera.
Etiquetas:affects_outputs
- 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 terminar la carga en segundo plano. Puede ser "wait_for_upload_complete" (predeterminada), "nowait_for_upload_complete" o "fully_async".
Etiquetas:eagerness_to_exit
--build_event_binary_file=<a string>
predeterminado: ""-
Si no está vacío, escribe una representación binaria delimitada por varint del protocolo de eventos de compilación en ese archivo. Esta opción implica --bes_upload_mode=wait_for_upload_complete.
Etiquetas:affects_outputs
--[no]build_event_binary_file_path_conversion
predeterminado: "true"-
Convierte las rutas de acceso en la representación de archivo binario del protocolo de evento de compilación a URIs más válidos a nivel global siempre que sea posible. Si está inhabilitado, siempre se usará el esquema de URI file://.
Etiquetas:affects_outputs
--build_event_binary_file_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>
predeterminado: "wait_for_upload_complete"-
Especifica si la carga del servicio de eventos de compilación para --build_event_binary_file debe bloquear la finalización de la compilación o debe finalizar la invocación de inmediato y terminar la carga en segundo plano. "wait_for_upload_complete" (predeterminado), "nowait_for_upload_complete" o "full_async".
Etiquetas:eagerness_to_exit
--build_event_json_file=<a string>
predeterminado: ""-
Si no está vacío, escribe una serialización JSON del protocolo del evento de compilación en ese archivo. Esta opción implica --bes_upload_mode=wait_for_upload_complete.
Etiquetas:affects_outputs
--[no]build_event_json_file_path_conversion
predeterminado: "true"-
Convierte las rutas de acceso en la representación del archivo JSON del protocolo del evento de compilación a URIs más válidos a nivel global siempre que sea posible. Si se inhabilita, siempre se usará el esquema de URI file://.
Etiquetas:affects_outputs
--build_event_json_file_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>
predeterminado: "wait_for_upload_complete"-
Especifica si la carga del servicio de eventos de compilación para --build_event_json_file debe bloquear la finalización de la compilación o finalizar la invocación de inmediato y terminar la carga en segundo plano. Puede ser "wait_for_upload_complete" (predeterminada), "nowait_for_upload_complete" o "fully_async".
Etiquetas:eagerness_to_exit
--build_event_max_named_set_of_file_entries=<an integer>
predeterminado: “-1”-
Es la cantidad máxima de entradas para un solo evento named_set_of_files. Se ignoran los valores menores que 2 y no se realiza ninguna división de eventos. Su objetivo es limitar el tamaño máximo del evento en el protocolo de eventos de compilación, aunque no controla directamente el tamaño del evento. El tamaño total del evento es una función de la estructura del conjunto, así como de las longitudes del archivo y del URI, que a su vez pueden depender de la función hash.
Etiquetas:affects_outputs
--[no]build_event_publish_all_actions
predeterminado: “false”-
Indica si se deben publicar todas las acciones.
Etiquetas:affects_outputs
--build_event_text_file=<a string>
predeterminado: ""-
Si no está vacío, escribe una representación textual del protocolo del evento de compilación en ese archivo.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]build_event_text_file_path_conversion
: "true" -
Convierte las rutas de acceso en la representación del archivo de texto del protocolo del evento de compilación a URIs más válidos a nivel global siempre que sea posible. Si se inhabilita, siempre se usará el esquema de URI file://.
Etiquetas:affects_outputs
- 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 terminar la carga en segundo plano. Puede ser "wait_for_upload_complete" (predeterminada), "nowait_for_upload_complete" o "fully_async".
Etiquetas:eagerness_to_exit
--[no]experimental_announce_profile_path
predeterminado: “false”-
Si está habilitado, agrega la ruta de acceso del perfil JSON al registro.
Etiquetas:bazel_monitoring
- Valor predeterminado de
--[no]experimental_bep_target_summary
: "falso" - Determina si se deben publicar eventos TargetSummary.
- Valor predeterminado de
--[no]experimental_build_event_expand_filesets
: "falso" -
Si es verdadero, expande los conjuntos de archivos en BEP cuando presentes los archivos de salida.
Etiquetas:affects_outputs
--[no]experimental_build_event_fully_resolve_fileset_symlinks
predeterminado: “false”-
Si es verdadero, resuelve completamente los symlinks de conjuntos de archivos relativos en el BEP cuando se presentan archivos de salida. Requiere --experimental_build_event_expand_filesets.
Etiquetas:affects_outputs
--experimental_build_event_upload_max_retries=<an integer>
predeterminado: “4”-
Es la cantidad máxima de veces que Bazel debe volver a intentar subir un evento de compilación.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
: "1s" -
Retraso mínimo inicial de los reintentos de retirada exponencial cuando falla la carga de BEP. (exponente: 1.6)
Etiquetas:bazel_internal_configuration
--experimental_build_event_upload_strategy=<a string>
predeterminado: Consulta la descripción-
Selecciona cómo subir los artefactos a los que se hace referencia en el protocolo del evento de compilación.
Etiquetas:affects_outputs
--[no]experimental_collect_load_average_in_profiler
predeterminado: "true"-
Si 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 está habilitado, el generador de perfiles recopila los datos de PSI de Linux.
Etiquetas:bazel_monitoring
--[no]experimental_collect_resource_estimation
predeterminado: “false”-
Si está habilitado, el generador de perfiles recopila una estimación del uso de CPU y memoria para las acciones locales.
Etiquetas:bazel_monitoring
--[no]experimental_collect_system_network_usage
predeterminado: “false”-
Si está habilitado, el generador de perfiles recopila el uso de red del sistema.
Etiquetas:bazel_monitoring
--[no]experimental_collect_worker_data_in_profiler
predeterminado: “false”-
Si está habilitado, el generador de perfiles recopila los datos de recursos agregados del trabajador.
Etiquetas:bazel_monitoring
- Se acumulan
--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, repository_vendor or unknown>
usos múltiples -
Especifica las tareas de perfil adicionales que se incluirán en el perfil.
Etiquetas:bazel_monitoring
--[no]experimental_profile_include_primary_output
predeterminado: “false”-
Incluye el atributo adicional "out" en los eventos de acción que contiene la ruta de acceso de ejecución al resultado principal de la acción.
Etiquetas:bazel_monitoring
- Valor predeterminado de
--[no]experimental_profile_include_target_label
: "falso" -
Incluye la etiqueta de destino en los datos de perfil JSON de los eventos de acción.
Etiquetas:bazel_monitoring
- Valor predeterminado de
--[no]experimental_run_bep_event_include_residue
: "falso" -
Indica si se debe incluir el residuo de la línea de comandos en los eventos de compilación de ejecución que podrían contener el residuo. De forma predeterminada, el residuo no se incluye en los eventos de compilación del comando de ejecución que podrían contenerlo.
Etiquetas:affects_outputs
--[no]experimental_stream_log_file_uploads
predeterminado: “false”-
El archivo de registro de transmisión se sube directamente al almacenamiento remoto en lugar de escribirlo en el disco.
Etiquetas:affects_outputs
--experimental_workspace_rules_log_file=<a path>
predeterminado: Consulta la descripción- Registra ciertos eventos de las reglas de Workspace en este archivo como protos de WorkspaceEvent delimitados.
--[no]generate_json_trace_profile
predeterminado: “auto”-
Si 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 la compilación.
Etiquetas:bazel_monitoring
--[no]heap_dump_on_oom
predeterminado: “false”-
Determina si se debe generar manualmente un volcado de montón si se genera una OOM (incluidas las OOM manuales debido a que se alcanzan los --gc_thrashing_limits). El volcado se escribirá en <output_base>/<invocation_id>.heapdump.hprof. Esta opción reemplaza de manera efectiva -XX:+HeapDumpOnOutOfMemoryError, que no tiene efecto en los OOM manuales.
Etiquetas:bazel_monitoring
--[no]legacy_important_outputs
predeterminado: "true"-
Usa esta opción para suprimir la generación del campo relevant_outputs heredado en el evento TargetComplete. Los campos relevant_outputs son obligatorios para la integración de Bazel con ResultStore.
Etiquetas:affects_outputs
--logging=<0 <= an integer <= 6>
predeterminado: “3”-
El nivel de registro.
Etiquetas:affects_outputs
--memory_profile=<a path>
predeterminado: Consulta la descripción-
Si se establece, escribe los datos de uso de la memoria en el archivo especificado al final de la fase y el montón estable en el registro principal al final de la compilación.
Etiquetas:bazel_monitoring
- Valor predeterminado de
--memory_profile_stable_heap_parameters=<integers, separated by a comma expected in pairs>
: "1,0" - Ajusta el cálculo del montón estable del perfil de memoria al final de la compilación. Debe ser una cantidad par de números enteros separados por comas. En cada par, el primer número entero es la cantidad de GC que se 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 serían 2 GC con una pausa de 4 segundos, seguidas de 4 GC con una pausa de cero segundos.
Etiquetas:bazel_monitoring
--profile=<a path>
predeterminado: Consulta la descripción-
Si se establece, se genera un perfil de Bazel y se escriben datos en el archivo especificado. Usa bazel analyze-profile para analizar el perfil.
Etiquetas:bazel_monitoring
--[no]record_full_profiler_data
predeterminado: “false”-
De forma predeterminada, el generador de perfiles de Bazel solo registrará datos agregados para eventos rápidos, pero numerosos (como el estado del archivo). Si esta opción está habilitada, el generador de perfiles registrará cada evento, lo que generará datos de perfiles más precisos, pero con un gran impacto en el rendimiento. La opción solo tiene efecto si también se usa --profile.
Etiquetas:bazel_monitoring
- Valor predeterminado de
--remote_print_execution_messages=<failure, success or all>
: “failure” -
Elige cuándo imprimir los mensajes de ejecución remota. Los valores válidos son "failure" para imprimir solo en caso de fallas, "success" para imprimir solo en caso de éxitos y "all" para imprimir siempre.
Etiquetas:terminal_output
--[no]slim_profile
predeterminado: "true"-
Reduce el tamaño del perfil JSON combinando eventos si el perfil se vuelve demasiado grande.
Etiquetas:bazel_monitoring
--starlark_cpu_profile=<a string>
predeterminado: ""-
Escribe en el archivo especificado un perfil pprof del uso de CPU de todos los subprocesos de Starlark.
Etiquetas:bazel_monitoring
- Valor predeterminado de
--tool_tag=<a string>
: "" -
Es un nombre de herramienta al que se atribuirá esta invocación de Bazel.
Etiquetas:affects_outputs
,bazel_monitoring
- Se acumulan varios usos de
--ui_event_filters=<Convert list of comma separated event kind to list of filters>
. -
Especifica qué eventos se mostrarán en la IU. Es posible agregar o quitar eventos a los predeterminados con los signos +/- iniciales, o bien anular el conjunto predeterminado por completo con la asignación directa. El conjunto de tipos de eventos admitidos incluye INFO, DEBUG, ERROR y mucho más.
Etiquetas:terminal_output
- Opciones de almacenamiento en caché y ejecución remotas:
- Valor predeterminado de
--experimental_circuit_breaker_strategy=<failure>
: ver descripción - especifica la estrategia que debe usar el disyuntor. Las estrategias disponibles son "error". Si el valor de la opción no es válido, no se establece el mismo comportamiento que la opción.
Etiquetas:execution
--[no]experimental_guard_against_concurrent_changes
predeterminado: “false”- Desactiva esta opción para inhabilitar la verificación del ctime de los archivos de entrada de una acción antes de subirla a una caché remota. Puede haber casos en los que el kernel de Linux retrase la escritura de archivos, lo que podría generar falsos positivos.
--[no]experimental_remote_cache_async
predeterminado: “false”- Si es verdadero, la E/S de caché remota ocurrirá en segundo plano, en lugar de ocurrir como parte de un generación.
- Valor predeterminado de
--experimental_remote_cache_compression_threshold=<an integer>
: "0" - Es el tamaño mínimo de blob necesario para comprimir o descomprimir con zstd. No es eficaz, a menos que se establezca --remote_cache_compression.
--[no]experimental_remote_cache_lease_extension
predeterminado: “false”- Si se establece como verdadero, Bazel extenderá el arrendamiento de los resultados de las acciones remotas durante la compilación enviando llamadas a "FindMissingBlobs" periódicamente a la caché remota. La frecuencia se basa en el valor de `--experimental_remote_cache_ttl`.
--experimental_remote_cache_ttl=<An immutable length of time.>
predeterminado: "3h"-
El TTL mínimo garantizado de los BLOB en la caché remota después de que se hace referencia recientemente a sus resúmenes, p. ej., mediante un ActionResult o FindMissingBlobs Bazel realiza varias optimizaciones en función del TTL de los blobs, p.ej., no llama repetidamente a GetActionResult en una compilación incremental. El valor debe establecerse un poco 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
--experimental_remote_capture_corrupted_outputs=<a path>
predeterminado: Consulta la descripción- Es una ruta de acceso a un directorio en el que se capturarán los resultados dañados.
- 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 el uso de memoria de forma significativa, pero requiere que Bazel vuelva a procesarlas ante errores y reintentos de caché remota.
--experimental_remote_downloader=<a string>
predeterminado: Consulta la descripción- Es un URI de extremo de la API de Remote Asset que se usará como proxy de descarga remoto. Los esquemas admitidos son grpc, grpcs (grpc con TLS habilitado) y unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel usará grpcs de forma predeterminada. Consulta: https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto
--[no]experimental_remote_downloader_local_fallback
predeterminado: “false”- Indica si se debe recurrir al descargador local si falla el descargador remoto.
- Valor predeterminado de
--[no]experimental_remote_execution_keepalive
: "falso" - Indica si se debe usar el mantenimiento de la conexión para las llamadas de ejecución remotas.
- 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 lo estableces en 0, no habrá limitaciones.
Etiquetas:execution
--experimental_remote_failure_window_interval=<An immutable length of time.>
predeterminado: "60s"-
El intervalo en el que se calcula la tasa de fallas de las solicitudes remotas. Si el valor es cero o negativo, la duración de la falla se calcula durante toda la ejecución.Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
Etiquetas:execution
- Valor predeterminado de
--[no]experimental_remote_mark_tool_inputs
: "falso" - Si se establece como verdadero, Bazel marcará las entradas como entradas de herramientas para el ejecutor remoto. Se puede usar para implementar trabajadores persistentes remotos.
--[no]experimental_remote_merkle_tree_cache
predeterminado: “false”- Si se establece como verdadera, los cálculos del árbol de Merkle se memorizarán para mejorar la velocidad de comprobación de aciertos de caché remota. El espacio en memoria de la caché se controla con --experimental_remote_merkle_tree_cache_size.
- Valor predeterminado de
--experimental_remote_merkle_tree_cache_size=<a long integer>
: "1000" - Es la cantidad de árboles de Merkle que se deben almacenar en caché para mejorar la velocidad de verificación de aciertos de caché remotos. Aunque la caché se poda automáticamente según el manejo de referencias suaves de Java, pueden ocurrir errores de falta de memoria si se establece demasiado alta. Si se establece en 0, el tamaño de la caché es ilimitado. El valor óptimo varía según el tamaño del proyecto. El valor predeterminado es 1,000.
--experimental_remote_output_service=<a string>
predeterminado: Consulta la descripción- HOST o HOST:PORT de un extremo de servicio de salida remoto. 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.
--experimental_remote_output_service_output_path_prefix=<a string>
predeterminado: ""- Es la ruta de acceso en la que se coloca el contenido de los directorios de salida que administra el --experimental_remote_output_service. El directorio de salida real que usa una compilación será un descendiente de esta ruta de acceso y lo determinará el servicio de salida.
--[no]experimental_remote_require_cached
predeterminado: “false”- Si se establece como "true", se aplica la directiva de que todas las acciones que se pueden ejecutar de forma remota se almacenen en caché, o bien se producirá un error en la compilación. Esto es útil para solucionar problemas de no determinismo, ya que permite comprobar si las acciones que deben almacenarse en caché realmente se almacenan en caché sin insertar falsamente resultados nuevos en la caché.
- Valor predeterminado de
--experimental_remote_scrubbing_config=<Converts to a Scrubber>
: ver descripción - Habilita la limpieza de claves de caché remotas con el archivo de configuración proporcionado, que debe ser un búfer de protocolo en formato de texto (consulta src/main/protobuf/remote_scrubbing.proto). El objetivo de esta función es facilitar el uso compartido de una caché remota o en el disco entre acciones que se ejecutan en diferentes plataformas, pero que se orientan a la misma plataforma. 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, sino solo la forma en que se calcula su clave de caché remota o en el disco para recuperar o almacenar un resultado de acción. Las acciones limpiadas no son compatibles con la ejecución remota y siempre se ejecutarán de forma local. Modificar la configuración de limpieza no invalida los resultados presentes en el sistema de archivos local o las cachés internas. Se requiere una compilación limpia para volver a ejecutar las acciones afectadas. Para usar esta función correctamente, es probable que desees establecer un --host_platform personalizado junto con --experimental_platform_in_output_dir (para normalizar los prefijos de salida) y --incompatible_strict_action_env (para normalizar las variables de entorno).
--[no]incompatible_remote_build_event_upload_respect_no_cache
predeterminado: “false”- Obsoleto. No realiza ninguna acción. En su lugar, usa --remote_build_event_upload=minimal.
--[no]incompatible_remote_downloader_send_all_headers
predeterminado: "true"-
Indica si se deben enviar todos los valores de un encabezado con varios valores al descargador remoto en lugar de solo el primero.
Etiquetas:incompatible_change
--[no]incompatible_remote_output_paths_relative_to_input_root
predeterminado: “false”-
Si se establece como verdadero, las rutas de acceso de salida son relativas a la raíz de entrada en lugar del directorio de trabajo.
Etiquetas:incompatible_change
--[no]incompatible_remote_results_ignore_disk
predeterminado: "true"-
Etiquetas
sin acción:incompatible_change
--[no]remote_accept_cached
predeterminado: "true"- Determina si se aceptan los resultados de acciones almacenados en caché de forma remota.
- Valor predeterminado de
--remote_build_event_upload=<all or minimal>
: “mínimo” - Si se establece en “todos”, todos los resultados locales a los que hace referencia BEP se suben a la caché remota. Si se establece en "minimal", los resultados locales a los que hace referencia BEP no se suben a la caché remota, excepto los archivos que son importantes para los consumidores de BEP (p.ej., registros de prueba y perfil de tiempo). El esquema bytestream:// siempre se usa para el URI de los archivos, incluso si faltan en la caché remota. El valor predeterminado es "minimal".
--remote_bytestream_uri_prefix=<a string>
predeterminado: Consulta la descripción- Es el nombre de host y el nombre de la instancia que se usarán en los URIs bytestream:// que se escriben en los flujos de eventos de compilación. Esta opción se puede establecer cuando las compilaciones se realizan con un proxy, lo que hace que los valores de --remote_executor y --remote_instance_name ya no correspondan al nombre canónico del servicio de ejecución remota. Si no se establece, el valor predeterminado será “${hostname}/${instance_name}”.
--remote_cache=<a string>
predeterminado: Consulta la descripción- Es un URI de un extremo de almacenamiento en caché. Los esquemas compatibles son http, https, grpc, grpcs (grpc con TLS habilitado) y unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel usará grpcs de forma predeterminada. Especifica el esquema grpc://, http:// o unix: para inhabilitar TLS. Consulta https://bazel.build/remote/caching
--[no]remote_cache_compression
predeterminado: “false”- Si está habilitado, comprime o descomprime los blobs de caché con zstd cuando su tamaño sea de al menos --experimental_remote_cache_compression_threshold.
- Se acumulan varios usos de
--remote_cache_header=<a 'name=value' assignment>
- Especifica un encabezado que se incluirá en las solicitudes de caché: --remote_cache_header=Nombre=Valor. Se pueden pasar varios encabezados especificando la marca varias veces. Los múltiples valores para el mismo nombre se convertirán en una lista separada por comas.
- Se acumulan varios usos de
--remote_default_exec_properties=<a 'name=value' assignment>
-
Configura las propiedades de ejecución predeterminadas que se usarán como plataforma de ejecución remota si una plataforma de ejecución aún no configuró exec_properties.
Etiquetas:affects_outputs
--remote_default_platform_properties=<a string>
predeterminado: ""- Establece las propiedades de plataforma predeterminadas que se establecerán para la API de ejecución remota, si la plataforma de ejecución aún no establece remote_execution_properties. Este valor también se usará si se selecciona la plataforma host como la plataforma de ejecución para la ejecución remota.
- Se acumulan
--remote_download_regex=<a valid Java regular expression>
usos múltiples -
Forzar la descarga de los resultados de la compilación remota cuya ruta coincida con este patrón, independientemente de --remote_download_outputs. Se pueden especificar múltiples patrones repitiendo esta marca.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--remote_downloader_header=<a 'name=value' assignment>
- Especifica un encabezado que se incluirá en las solicitudes del descargador remoto: --remote_downloader_header=Nombre=Valor. Se pueden pasar varios encabezados si especificas la marca varias veces. 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=Nombre=Valor. 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" - Es la prioridad relativa de las acciones que se ejecutarán de forma remota. La semántica de los valores de prioridad particulares depende del servidor.
--remote_executor=<a string>
predeterminado: Consulta la descripción- HOST o HOST:PORT de un extremo de ejecución remota. Los esquemas 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.
--remote_grpc_log=<a path>
predeterminado: Consulta la descripción- Si se especifica, es una ruta de acceso a un archivo para registrar los detalles relacionados con las llamadas de gRPC. Este registro consta de una secuencia de protobufs com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry serializados con cada mensaje con 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 si especificas la marca varias veces. Si hay varios valores para el mismo nombre, se convertirán en una lista separada por comas.
--remote_instance_name=<a string>
predeterminado: ""- Es el valor que se pasa como instance_name en la API de ejecución remota.
--[no]remote_local_fallback
predeterminado: “false”- Determina si se debe recurrir a la estrategia de ejecución local independiente si falla la ejecución remota.
--remote_local_fallback_strategy=<a string>
predeterminado: "local"- No-op, obsoleto. Consulta https://github.com/bazelbuild/bazel/issues/7480 para obtener más información.
--remote_max_connections=<an integer>
predeterminado: "100"-
Limita la cantidad máxima de conexiones simultáneas a la caché o al ejecutor remotos. De forma predeterminada, el valor es 100. Si 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
--remote_proxy=<a string>
predeterminado: Consulta la descripción- Conéctate a la caché remota a través de un proxy. Actualmente, esta marca solo se puede usar para configurar un socket de dominio Unix (unix:/path/to/socket).
--remote_result_cache_priority=<an integer>
predeterminado: “0”- Es la prioridad relativa de las acciones remotas que se almacenarán en la caché remota. La semántica de los valores de prioridad particulares depende del servidor.
--remote_retries=<an integer>
predeterminado: “5”- Es la cantidad máxima de intentos para reintentar un error transitorio. Si se establece en 0, se inhabilitan los reintentos.
--remote_retry_max_delay=<An immutable length of time.>
predeterminado: "5s"- Es la demora máxima de la retirada entre los intentos de reintento remotos. Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
--remote_timeout=<An immutable length of time.>
predeterminado: "60s"- Es la cantidad máxima de tiempo que se espera para la ejecución remota y las llamadas a la caché. Para la caché REST, este es el tiempo de espera de conexión y de lectura. Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
--[no]remote_upload_local_results
predeterminado: "true"- Determina si se deben subir resultados de acciones ejecutadas de forma local a la caché remota si esta lo admite y el usuario tiene autorización para hacerlo.
--[no]remote_verify_downloads
predeterminado: "true"- Si se establece como verdadero, Bazel calculará la suma de hash de todas las descargas remotas y descartará los valores almacenados en caché de forma remota si no coinciden con el valor esperado.
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--build_metadata=<a 'name=value' assignment>
-
Son pares de cadenas clave-valor personalizados que se proporcionan en un evento de compilación.
Etiquetas:terminal_output
--color=<yes, no or auto>
predeterminado: "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 existe esa sección. Si esta sección no existe en ningún archivo .rc, Blaze falla con un error. Las secciones de configuración y las combinaciones de marcas a las que son equivalentes se encuentran en los archivos de configuración tools/*.blazerc.
- Se acumulan
--credential_helper=<Path to a credential helper. It may be absolute, relative to the PATH environment variable, or %workspace%-relative. The path be optionally prefixed by a scope followed by an '='. The scope is a domain name, optionally with a single leading '*' wildcard component. A helper applies to URIs matching its scope, with more specific scopes preferred. If a helper has no scope, it applies to every URI.>
usos múltiples - Configura un auxiliar de credenciales que cumpla con la <a href="https://github.com/EngFlow/credential-helper-spec">Especificación del auxiliar de credenciales</a> para usarlo en la recuperación de credenciales de autorización para la recuperación del repositorio, la ejecución y la caché remotas, y el servicio de eventos de compilación. Las credenciales que proporciona un ayudante tienen prioridad sobre las que proporcionan `--google_default_credentials`, `--google_credentials`, un archivo ".netrc" o el parámetro de autenticación para "repository_ctx.download()` y "repository_ctx.download_and_extract()`. Se puede especificar varias veces para configurar varios ayudantes. Consulta https://blog.engflow.com/2023/10/09/configuring-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 las proporciona cuando vencen las credenciales.
--credential_helper_timeout=<An immutable length of time.>
predeterminado: "10s"- Configura el tiempo de espera de un auxiliar de credenciales. Si los auxiliares de credenciales no responden dentro de este tiempo de espera, la invocación fallará.
--curses=<yes, no or auto>
predeterminado: “auto”- Usa los controles del cursor de la terminal para minimizar el resultado del desplazamiento.
--disk_cache=<a path>
predeterminado: Consulta la descripción- Es una ruta de acceso a un directorio en el que Bazel puede leer y escribir acciones y resultados de acciones. Si el directorio no existe, se creará.
- Valor predeterminado de
--[no]enable_platform_specific_config
: "falso" - Si es verdadero, Bazel recupera líneas de configuración específicas del host y el SO de los archivos bazelrc. Por ejemplo, si el SO host es Linux y ejecutas bazel build, Bazel recopila líneas que comienzan con build:linux. Los identificadores de SO admitidos son linux, macos, windows, freebsd y openbsd. Habilitar esta marca equivale a usar --config=linux en Linux, --config=windows en Windows, etcétera.
--experimental_disk_cache_gc_idle_delay=<An immutable length of time.>
predeterminado: "5m"- Es la cantidad de tiempo que el servidor debe permanecer inactivo antes de que se produzca una recolección de elementos no utilizados de la caché del disco. Para especificar la política de recolección de elementos no utilizados, establece --experimental_disk_cache_gc_max_size o --experimental_disk_cache_gc_max_age.
--experimental_disk_cache_gc_max_age=<An immutable length of time.>
predeterminado: “0”- Si se establece en un valor positivo, la caché de disco se eliminará periódicamente como elementos no utilizados para quitar las entradas que tengan más antigüedad que esta. Si se establece junto con --experimental_disk_cache_gc_max_size, se aplican ambos criterios. La recolección de basura se produce en segundo plano una vez que el servidor se vuelve inactivo, según lo determine la marca --experimental_disk_cache_gc_idle_delay.
- Valor predeterminado de
--experimental_disk_cache_gc_max_size=<a size in bytes, optionally followed by a K, M, G or T multiplier>
: "0" - Si se establece en un valor positivo, la caché de disco se eliminará periódicamente para mantenerse por debajo de este tamaño. Si se establece junto con --experimental_disk_cache_gc_max_age, se aplican ambos criterios. La recolección de basura se produce en segundo plano una vez que el servidor se vuelve inactivo, según lo determine la marca --experimental_disk_cache_gc_idle_delay.
--[no]experimental_rule_extension_api
predeterminado: “false”-
Habilita las APIs de extensión de reglas experimentales y de subreglas
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_windows_watchfs
predeterminado: “false”- Si es verdadero, se habilita la compatibilidad experimental de Windows con --watchfs. De lo contrario, --watchfs no es una opción en Windows. Asegúrate de habilitar también --watchfs.
--google_auth_scopes=<comma-separated list of options>
predeterminado: "https://www.googleapis.com/auth/cloud-platform"- Es una lista separada por comas de los permisos de autenticación de Google Cloud.
- 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.
--[no]google_default_credentials
predeterminado: “false”- Determina si se deben usar "Credenciales predeterminadas de la aplicación de Google" para la autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más información. Está inhabilitado de forma predeterminada.
- Valor predeterminado de
--grpc_keepalive_time=<An immutable length of time.>
: ver descripción - Configura pings de keepalive para las conexiones de gRPC salientes. Si se establece, Bazel envía pings después de este tiempo sin operaciones de lectura en la conexión, pero solo si hay al menos una llamada gRPC pendiente. Los tiempos se tratan como nivel de detalle de segundo. Es un error establecer un valor inferior a un segundo. De forma predeterminada, los pings de mantenimiento de la conexión están inhabilitados. Debes coordinar con el propietario del servicio antes de habilitar este parámetro de configuración. Por ejemplo, para establecer un valor de 30 segundos en esta marca, se debe hacer de la siguiente manera: --grpc_keepalive_time=30s
- Valor predeterminado de
--grpc_keepalive_timeout=<An immutable length of time.>
: "20 s" - Configura un tiempo de espera de keepalive para las 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 definir un valor inferior a un segundo. Si los pings de mantenimiento de la conexión están inhabilitados, se ignora este parámetro de configuración.
--[no]incompatible_disable_non_executable_java_binary
predeterminado: “false”-
Si es verdadero, java_binary siempre es ejecutable. Se quita el atributo create_executable.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_symlink_file_to_dir
predeterminado: "true"-
No-ops.
Etiquetas:loading_and_analysis
,incompatible_change
--invocation_id=<a UUID>
predeterminado: ""-
Es el identificador único, en formato UUID, del comando que se ejecuta. Si se especifica de forma explícita, el llamador debe garantizar la unicidad. El UUID se imprime en stderr, el BEP y el protocolo de ejecución remota.
Etiquetas:bazel_monitoring
,bazel_internal_configuration
--[no]progress_in_terminal_title
predeterminado: “false”- 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.
--[no]show_progress
predeterminado: "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 la salida.
--[no]show_timestamps
predeterminado: “false”- 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 de confianza para firmar certificados de servidor.
--tls_client_certificate=<a string>
predeterminado: Consulta la descripción- Especifica el certificado de cliente TLS que se usará. También debes proporcionar una clave de cliente para habilitar la autenticación del cliente.
--tls_client_key=<a string>
predeterminado: Consulta la descripción- Especifica la clave de cliente TLS que se usará. También debes proporcionar un certificado de cliente para habilitar la autenticación del 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 independiente. La barra de progreso siempre muestra al menos un uno, y todos los números inferiores a 1 se asignan a 1.
Etiquetas:terminal_output
--[no]watchfs
predeterminado: “false”- En Linux/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 está disponible, pero se puede habilitar junto con --experimental_windows_watchfs. En cualquier SO: El comportamiento no se define si tu espacio de trabajo está en un sistema de archivos de red y los archivos se editan en una máquina remota.
Opciones de Analyze-profile
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
-
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]experimental_repository_cache_hardlinks
: "falso" -
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--experimental_repository_downloader_retries=<an integer>
: "0" -
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Ajusta todos los tiempos de espera en las reglas del repositorio de Starlark con este factor. De esta manera, se puede hacer que los repositorios externos funcionen en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--[no]incompatible_disable_native_repo_rules
predeterminado: “false”-
Si es falso, se pueden usar reglas de repositorio nativas en WORKSPACE. De lo contrario, se deben usar reglas de repositorio de Starlark. Las reglas de repositorio nativo incluyen local_repository, new_local_repository, local_config_platform, android_sdk_repository y android_ndk_repository.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché. De lo contrario, se usa el valor predeterminado de '<output_user_root>/cache/repos/v1'.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]repository_disable_download
: "falso" -
Si se establece, no se permite la descarga con ctx.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no se inhabilita por completo; ctx.execute aún podría ejecutar un ejecutable arbitrario que acceda a Internet.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de la compilación:
--gc_thrashing_threshold=<an integer in 0-100 range>
predeterminado: "100"-
Es el porcentaje de espacio ocupado (de 0 a 100) por encima del cual GcThrashingDetector considera los eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, se inhabilita GcThrashingDetector.
Etiquetas:host_machine_resource_optimizations
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
-
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitadas en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones rechazadas harán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para 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
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "advertencia" -
Verifica si las dependencias directas de "bazel_dep" declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivarla a un error de resolución.
Etiquetas:loading_and_analysis
- 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 dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--lockfile_mode=<off, update, refresh 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, "refresh" para actualizar periódicamente la información mutable (versiones quitadas y módulos que faltaban anteriormente) de los registros remotos, "error" para usar el archivo de bloqueo, pero mostrar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
- Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso proporcionada es una ruta de acceso absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta de acceso relativa, se considerará en relación con el directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace". Si la ruta de acceso determinada está vacía, quita las anulaciones anteriores.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los anteriores.
Etiquetas:changes_inputs
- Valor predeterminado de
--vendor_dir=<a path>
: ver descripción -
Especifica el directorio que debe contener los repositorios externos en modo de proveedor, ya sea para recuperarlos o usarlos durante la compilación. La ruta de acceso se puede especificar como una ruta absoluta o una ruta relativa al directorio del espacio 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 falle con Bazel con una OOM. Cada límite se especifica como <period>:<count>, donde el período es una duración y el conteo es un número entero positivo. Si hay más de --gc_thrashing_threshold por ciento de espacio permanente (montón de generación anterior) permanece ocupado después de <count> recolecciones de elementos no utilizados consecutivos en <period>, se activará una OOM. Si hay varios límites, puedes separarlos por comas.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC completo, se descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC completos nunca activarán las bajadas. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC completo y se supere ese umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Marca de configuración avanzada del motor interno de 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. El valor predeterminado es Integer.MAX_VALUE, es decir, ilimitado. 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
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es de al menos este límite, descartará el estado temporal innecesario de Skyframe. Si ajustas este parámetro, es posible que puedas mitigar el impacto del tiempo de ejecución de la fragmentación de GC, cuando esta se produce (i) por el uso de memoria de este estado temporal y (ii) es más costoso que reconstituir el estado cuando sea necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--dump=<text or raw>
[-d
] predeterminado: Consulta la descripción- muestra un volcado completo de datos de perfil, ya sea en formato "text" legible por humanos o en formato "sin procesar" compatible con secuencias de comandos.
Etiquetas:affects_outputs
- Valor predeterminado de
--experimental_command_profile=<cpu, wall, alloc or lock>
: ver descripción - Graba un perfil de Java Flight Recorder durante el tiempo que se ejecuta el comando. Se debe proporcionar como argumento uno de los tipos de eventos de generación de perfiles admitidos (cpu, wall, alloc o lock). El perfil se escribe en un archivo con el nombre del tipo de evento en el directorio de salida base. La sintaxis y la semántica de esta marca pueden cambiar en el futuro para admitir tipos de perfiles o formatos de salida adicionales. Úsala bajo tu propio riesgo.
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemónicos con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
- Opciones que especifican o modifican una entrada genérica para un comando de Bazel que no se encuentra en otras categorías.
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de almacenamiento en caché y ejecución remotas:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite"), seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
predeterminado: “auto”- Es el modo de subprocesos que se usará para recuperar el repo. Si se establece en "desactivado", no se usa ningún subproceso de trabajo y la recuperación del repo está sujeta a reinicios. De lo contrario, usa un subproceso de trabajador virtual.
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
. - Anula un repositorio con una ruta de acceso local en el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es una ruta absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta relativa, se relaciona con el directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace". Si la ruta de acceso determinada está vacía, quita las anulaciones anteriores.
Opciones de consulta
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
. -
Dónde 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 caso de un acierto de caché, en lugar de copiarse. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: “1.0”-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, se puede hacer que los repositorios externos funcionen en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--[no]incompatible_disable_native_repo_rules
predeterminado: “false”-
Si es falso, se pueden usar reglas de repositorio nativas en WORKSPACE. De lo contrario, se deben usar reglas de repositorio de Starlark. Las reglas de repositorio nativo incluyen local_repository, new_local_repository, local_config_platform, android_sdk_repository y android_ndk_repository.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación en caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché. De lo contrario, se usa el valor predeterminado de '<output_user_root>/cache/repos/v1'.
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
predeterminado: “false”-
Si se establece, no se permite la descarga con ctx.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no se inhabilita por completo; ctx.execute aún podría ejecutar un ejecutable arbitrario que acceda a Internet.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de la compilación:
--gc_thrashing_threshold=<an integer in 0-100 range>
predeterminado: "100"-
Es el porcentaje de espacio ocupado (de 0 a 100) por encima del cual GcThrashingDetector considera los eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, se inhabilita GcThrashingDetector.
Etiquetas:host_machine_resource_optimizations
- Opciones relacionadas con el resultado y la semántica de la consulta:
--aspect_deps=<off, conservative or precise>
predeterminado: "conservative"-
Cómo resolver las dependencias de aspecto cuando el formato de salida es uno de {xml,proto,record}. “off” significa que no se resuelven dependencias de aspecto, mientras que “conservative” (la opción predeterminada) significa que se agregan todas las dependencias de aspecto declaradas, independientemente de si se les asigna la clase de regla de dependencias directas. “precise” significa que solo se agregan los aspectos posiblemente activos dada la clase de regla de las dependencias directas. Ten en cuenta que el modo preciso requiere la carga de otros paquetes para evaluar un solo objetivo, lo que lo hace más lento que los otros modos. Ten en cuenta también que incluso el modo preciso no es del todo preciso: la decisión de calcular un aspecto se toma en la fase de análisis, que no se ejecuta durante la "consulta de bazel".
Etiquetas:build_file_semantics
--[no]consistent_labels
predeterminado: “false”-
Si está habilitada, cada comando de consulta emite etiquetas como si fuera la función Starlark <code>str</code> aplicada a una instancia de <code>Label</code>. Esto es útil para las herramientas que deben coincidir con el resultado de diferentes comandos de consulta o etiquetas emitidos por 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: Indica si se deben incluir acciones generadas por aspectos en el resultado. query: No-op (siempre se siguen los aspectos).
Etiquetas:terminal_output
--[no]graph:factored
predeterminado: "true"-
Si es verdadero, el gráfico se emitirá "factorizado", es decir, los nodos topológicamente equivalentes se combinarán y sus etiquetas se concatenarán. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--graph:node_limit=<an integer>
predeterminado: “512”-
Es la longitud máxima de la cadena de etiqueta para un nodo de grafo en el resultado. Las etiquetas más largas se truncan. -1 significa que no hay truncamiento. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--[no]implicit_deps
predeterminado: "true"-
Si está habilitada, se incluirán dependencias implícitas en el gráfico de dependencias sobre el que opera la consulta. Una dependencia implícita es 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
--[no]include_artifacts
predeterminado: "true"-
Incluye los nombres de las entradas y salidas de la acción en el resultado (potencialmente grande).
Etiquetas:terminal_output
--[no]include_aspects
predeterminado: "true"-
aquery, cquery: Indica si se deben incluir acciones generadas por aspectos en el resultado. query: No-op (siempre se siguen los aspectos).
Etiquetas:terminal_output
--[no]include_commandline
predeterminado: "true"-
Incluye el contenido de las líneas de comandos de la acción en el resultado (potencialmente 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 (potencialmente grandes).
Etiquetas:terminal_output
--[no]include_param_files
predeterminado: “false”-
Incluye el contenido de los archivos de parámetros que se usaron en el comando (posiblemente grandes). Nota: Si habilitas esta marca, se habilitará automáticamente la marca --include_commandline.
Etiquetas:terminal_output
--[no]incompatible_package_group_includes_double_slash
predeterminado: "true"-
Si está habilitada, cuando se genere el atributo "packages" de package_group, no se omitirá el "//" inicial.
Etiquetas:terminal_output
,incompatible_change
--[no]infer_universe_scope
predeterminado: “false”-
Si 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 establece --universe_scope, se ignora el valor de esta opción. Nota: Esta opción solo se aplica a "query" (es decir, no a "cquery").
Etiquetas:loading_and_analysis
--[no]line_terminator_null
predeterminado: “false”-
Indica si cada formato finaliza con \0 en lugar de una línea nueva.
Etiquetas:terminal_output
--[no]nodep_deps
predeterminado: "true"-
Si se habilita, las dependencias de los atributos “nodep” se incluirán en el gráfico de la dependencia en el que opera la consulta. Un ejemplo común de un atributo "nodep" es "visibility". Ejecuta y analiza el resultado de `info build-language` para conocer todos los atributos "nodep" en el lenguaje de compilación.
Etiquetas:build_file_semantics
--output=<a string>
predeterminado: "texto"-
Es el formato en el que se deben imprimir los resultados de la consulta. Los valores permitidos para aquery son: text, textproto, proto, streamed_proto y jsonproto.
Etiquetas:terminal_output
--[no]proto:default_values
predeterminado: "true"-
Si es verdadero, se incluyen los atributos cuyo valor no se especifica de forma explícita en el archivo BUILD; de lo contrario, se omiten. Esta opción se aplica a --output=proto
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:definition_stack
: "falso" -
Propaga el campo proto definition_stack, que registra para cada instancia de regla la pila de llamadas de Starlark en el momento en que se definió la clase de la regla.
Etiquetas:terminal_output
--[no]proto:flatten_selects
predeterminado: "true"-
Si está habilitada, los atributos configurables creados por select() se aplanan. 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 aplanan a nulos.
Etiquetas:build_file_semantics
--[no]proto:include_attribute_source_aspects
predeterminado: “false”-
Propaga el campo proto source_aspect_name de cada atributo con el aspecto de origen del que proviene el atributo (cadena vacía si no es así).
Etiquetas:terminal_output
- 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
--[no]proto:instantiation_stack
predeterminado: “false”-
Propaga la pila de llamadas de creación de instancias de cada regla. Ten en cuenta que esto requiere que la pila esté presente.
Etiquetas:terminal_output
--[no]proto:locations
predeterminado: "true"-
Indica si se debe generar información de ubicación en el resultado de proto.
Etiquetas:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
predeterminado: "todos"-
Es una lista de atributos separados por comas que se deben 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
--[no]proto:rule_inputs_and_outputs
predeterminado: "true"-
Indica si se propagan o no los campos rule_input y rule_output.
Etiquetas:terminal_output
--query_file=<a string>
predeterminado: ""-
Si se establece, la consulta leerá la consulta del archivo que se nombra aquí, en lugar de la línea de comandos. Especificar un archivo aquí y una consulta de línea de comandos es un error.
Etiquetas:changes_inputs
--[no]relative_locations
predeterminado: “false”-
Si es verdadero, la ubicación de los archivos Build en los resultados xml y proto será relativa. De forma predeterminada, el resultado de la ubicación es una ruta de acceso absoluta y no será coherente en todas las máquinas. Puedes establecer esta opción en verdadero para obtener un resultado coherente en todas las máquinas.
Etiquetas:terminal_output
--[no]skyframe_state
predeterminado: “false”-
Sin realizar un análisis adicional, 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
--[no]tool_deps
predeterminado: "true"-
Consulta: Si se inhabilita, las dependencias de "configuración de ejecución" no se incluirán en el gráfico de dependencias sobre el que opera la consulta. Un borde de dependencia de "configuración de ejecución", como el de cualquier regla "proto_library" al compilador de protocolos, suele apuntar a una herramienta que se ejecuta durante la compilación en lugar de a una parte del mismo programa "objetivo".
Cquery: Si se inhabilita, filtra todos los objetivos configurados que crucen una transición de ejecución desde el objetivo de nivel superior que descubrió este objetivo configurado. Esto significa que, si el objetivo de nivel superior está en la configuración de destino, solo se mostrarán los objetivos configurados también en la configuración de destino. Si el objetivo de nivel superior está en la configuración de exec, solo se mostrarán los objetivos configurados por exec. Esta opción NO excluirá las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
--universe_scope=<comma-separated list of options>
predeterminado: ""-
Un conjunto de patrones de destino separados por comas (aditivos y sustractivos). La consulta se puede realizar en el universo definido por el cierre transitivo de los destinos especificados. Esta opción se usa para los comandos de consulta y cquery.
En el caso de cquery, la entrada de esta opción son los objetivos en los que se compilan todas las respuestas, por lo que esta opción puede afectar las configuraciones y las transiciones. Si no se especifica esta opción, se supone que los destinos de nivel superior son los que se analizaron 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 el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
-
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitados en el registro de donde 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
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "advertencia" -
Verifica si las dependencias directas de “bazel_dep” declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivarla a un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
predeterminado: “update”- especifica cómo usar el archivo de bloqueo y si se debe usar o no. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "refresh" para actualizar adicionalmente la información mutable (versiones anuladas y módulos anteriores faltantes) de los registros remotos de vez en cuando, "error" para usar el archivo bloqueado, pero arrojar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
- Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso proporcionada es una ruta de acceso absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta de acceso relativa, se considerará en relación con el directorio de trabajo actual. Si la ruta de acceso proporcionada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado del "espacio de trabajo de información de bazel". Si la ruta dada está vacía, quita las anulaciones anteriores.
- Se acumulan varios usos de
--registry=<a string>
-
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los anteriores.
Etiquetas:changes_inputs
- Valor predeterminado de
--vendor_dir=<a path>
: ver descripción -
Especifica el directorio que debe contener los repositorios externos en modo de proveedor, ya sea para recuperarlos o usarlos durante la compilación. La ruta de acceso se puede especificar como una ruta absoluta o una ruta relativa al directorio del espacio de trabajo.
Etiquetas:loading_and_analysis
- Opciones que activan optimizaciones del tiempo de compilación:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
predeterminado: "1s:2,20s:3,1m:5"-
Límites que, si se alcanzan, hacen que GcThrashingDetector haga que Bazel falle con un error de OOM. Cada límite se especifica como <period>:<count>, en el que period es una duración y count es un número entero positivo. Si más del porcentaje --gc_thrashing_threshold del espacio a perpetuidad (heap de generación anterior) permanece ocupado después de <count> GC completas consecutivas en <period>, se activa un error de OOM. 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"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de recolección de elementos no utilizados completa, eliminará el estado temporal de Skyframe innecesario, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE, es decir, ilimitado. Cero significa que los eventos de GC completos nunca activarán las bajadas. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC completo y se supere ese umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produce un evento de GC menor, descartará el estado temporal innecesario de Skyframe hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos 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
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es al menos este umbral, descartará el estado temporal de Skyframe innecesario. Si ajustas este parámetro, es posible que puedas mitigar el impacto del tiempo de ejecución de la fragmentación de GC, cuando esta se produce (i) por el uso de memoria de este estado temporal y (ii) es más costoso que reconstituir el estado cuando sea necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--experimental_command_profile=<cpu, wall, alloc or lock>
predeterminado: Consulta la descripción- Graba un perfil de Java Flight Recorder durante el tiempo que se ejecuta el comando. Se debe proporcionar como argumento uno de los tipos de eventos de generación de perfiles admitidos (cpu, wall, alloc o lock). El perfil se escribe en un archivo que lleva el nombre del tipo de evento en el directorio de salida base. La sintaxis y la semántica de esta marca pueden cambiar en el futuro para admitir tipos de perfiles o formatos de salida adicionales. Úsala bajo tu propio riesgo.
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemónicos con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
- Opciones que especifican o modifican una entrada genérica para un comando de Bazel que no se encuentra en otras categorías.
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
predeterminado: "automático"- Es el modo de subprocesos que se usará para recuperar el repo. Si se establece en "desactivado", no se usa ningún subproceso de trabajo y la recuperación del repo está sujeta a reinicios. De lo contrario, usa un subproceso de trabajador virtual.
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
- Anula un repositorio con una ruta de acceso local en el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es una ruta absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta relativa, se relaciona con el directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace". Si la ruta de acceso determinada está vacía, quita las anulaciones anteriores.
- Opciones que controlan la ejecución de la compilación:
--[no]experimental_inprocess_symlink_creation
predeterminado: “false”-
Determina si se deben realizar llamadas directas al sistema de archivos para crear árboles de symlinks.
Etiquetas:loading_and_analysis
,execution
,experimental
--[no]experimental_persistent_aar_extractor
predeterminado: “false”-
Habilita el extractor de aar persistente con trabajadores.
Etiquetas:execution
--[no]experimental_remotable_source_manifests
predeterminado: “false”-
Determina si las acciones del manifiesto de origen se pueden controlar de forma remota.
Etiquetas:loading_and_analysis
,execution
,experimental
--[no]experimental_split_coverage_postprocessing
predeterminado: “false”-
Si es verdadero, Bazel ejecutará el procesamiento posterior de la cobertura para la prueba en un nuevo inicio.
Etiquetas:execution
--[no]experimental_strict_fileset_output
predeterminado: “false”-
Si se habilita esta opción, los conjuntos de archivos tratarán todos los artefactos de salida como archivos normales. No recorrerán directorios ni serán sensibles a los symlinks.
Etiquetas:execution
- 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
,incompatible_change
--[no]incompatible_modify_execution_info_additive
predeterminado: “false”-
Cuando está habilitada, pasar varias marcas --modify_execution_info es aditivo. Cuando se inhabilita, solo se tiene en cuenta la última marca.
Etiquetas:execution
,affects_outputs
,loading_and_analysis
,incompatible_change
- Se acumulan varios usos de
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
-
Agrega o quita claves de la información de ejecución de una acción según la mnemotecnia de la acción. Solo se aplica a las acciones que admiten información de ejecución. Muchas acciones comunes admiten información de ejecución, p.ej., Genrule, CppCompile, Javac, StarlarkAction y TestRunner. Cuando especificas varios valores, el orden es importante porque muchas regex pueden aplicarse al mismo mnemónico.
Sintaxis: “regex=[+-]key,regex=[+-]key,...”.
Ejemplos:
'.*=+x,.*=-y,.*=+z' agrega "x" y "z" a la información de ejecución de todas las acciones y quita "y".
“Genrule=+requires-x” agrega “requires-x” a la información de ejecución de todas las acciones de Genrule.
"(?!Genrule).*=-requires-x" quita "requires-x" de la información de ejecución para todas las acciones que no sean de Genrule.
Etiquetas:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Habilita las acciones de expansión de sintaxis y dex persistentes de Android con trabajadores.
Se expande a:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
-
Habilita el procesador de recursos de Android persistente con trabajadores.
Se expande a:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
--strategy=ProcessDatabinding=worker
--strategy=GenerateDataBindingBaseClasses=worker
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_dex_desugar
-
Habilita las acciones de desugar y dex multiplexadas y persistentes de Android con trabajadores.
Se expande a:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
Habilita el procesador de recursos de Android multiplexado persistente con trabajadores.
Se expande a lo siguiente:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
/}:--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
{/14/}: }{/17/:--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
: } } }--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
host_machine_resource_optimizations
execution
--persistent_multiplex_android_tools
-
Habilita las herramientas de Android persistentes y multiplexadas (dexing, expansión de sintaxis, procesamiento de recursos).
Se expande a:
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Etiquetas:host_machine_resource_optimizations
,execution
--[no]use_target_platform_for_tests
predeterminado: “false”-
Si es verdadero, Bazel usará la plataforma de destino para ejecutar pruebas en lugar del grupo de ejecución de pruebas.
Etiquetas:execution
- Opciones que configuran la cadena de herramientas que se usa para la ejecución de acciones:
- Valor predeterminado de
--android_compiler=<a string>
: ver descripción -
El compilador de destino de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_crosstool_top=<a build target label>
predeterminado: "//external:android/crosstool"-
Es la ubicación del compilador de C++ que se usa para las compilaciones de Android.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_grte_top=<a label>
predeterminado: Consulta la descripción-
El grte_top de destino de Android.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
predeterminado: "android"-
Selecciona el combinador de manifiestos que se usará para las reglas android_binary. Marca para ayudar a la transición a la combinación de manifiestos de Android desde la combinación heredada.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Valor predeterminado de
--android_platforms=<a build target label>
: "" -
Establece las plataformas que usan los destinos de android_binary. Si se especifican varias plataformas, el objeto binario es un APK grueso, que contiene objetos binarios nativos para cada plataforma de destino especificada.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_sdk=<a build target label>
predeterminado: "@bazel_tools//tools/android:sdk"-
Especifica el SDK o la plataforma de Android que se usa para compilar aplicaciones para Android.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--apple_crosstool_top=<a build target label>
predeterminado: "@bazel_tools//tools/cpp:toolchain"-
Es la etiqueta del paquete de herramientas cruzadas que se usará en las reglas de Apple y Objc, y sus dependencias.
Etiquetas:loses_incremental_state
,changes_inputs
--cc_output_directory_tag=<a string>
predeterminado: ""-
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas:affects_outputs
--compiler=<a string>
predeterminado: Consulta la descripción-
Es el compilador de C++ que se usará para compilar el destino.
Etiquetas:loading_and_analysis
,execution
--coverage_output_generator=<a build target label>
predeterminado: "@bazel_tools//tools/test:lcov_merger"-
Ubicación del binario que se usa para postprocesar informes de cobertura sin procesar. Actualmente, debe ser un grupo de archivos que contenga un solo archivo, el binario. La configuración predeterminada es “//tools/test:lcov_merger”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
predeterminado: "@bazel_tools//tools/test:coverage_report_generator"-
Ubicación del binario que se usa para generar informes de cobertura. Actualmente, debe ser un grupo de archivos que contenga un solo archivo: el objeto binario. El valor predeterminado es "//tools/test:coverage_report_generator".
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
predeterminado: "@bazel_tools//tools/test:coverage_support"-
Ubicación de los archivos de compatibilidad que se requieren en las entradas de cada acción de prueba que recopila la cobertura de código. El valor predeterminado es “//tools/test:coverage_support”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--crosstool_top=<a build target label>
predeterminado: "@bazel_tools//tools/cpp:toolchain"-
Es la etiqueta del paquete de herramientas cruzadas que se usará para compilar código C++.
Etiquetas:loading_and_analysis
,changes_inputs
,affects_outputs
--custom_malloc=<a build target label>
predeterminado: Consulta la descripción-
Especifica una implementación de malloc personalizada. Esta configuración anula los atributos malloc en las reglas de compilación.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan varios usos de
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
. -
Es una lista de expresiones regulares separadas por comas, cada una con el prefijo - (expresión negativa) de forma opcional, asignadas (=) a una lista de objetivos de valores de restricción separados por comas. Si un objetivo no coincide con ninguna expresión negativa y con al menos una expresión positiva, la resolución de la cadena de herramientas se realizará como si hubiera declarado los valores de restricción como restricciones de ejecución. Ejemplo: //demo,-test=@platforms//cpus:x86_64 agregará "x86_64" a cualquier destino de //demo, excepto a aquellos cuyo nombre contenga "test".
Etiquetas:loading_and_analysis
--[no]experimental_include_xcode_execution_requirements
predeterminado: “false”-
Si se configura, agrega un requisito de ejecución “requires-xcode:{version}” a cada acción de Xcode. Si la versión de Xcode tiene una etiqueta con guiones, también agrega un requisito de ejecución "requires-xcode-label:{version_label}".
Etiquetas:loses_incremental_state
,loading_and_analysis
,execution
- Valor predeterminado de
--[no]experimental_prefer_mutual_xcode
: "true" -
Si es verdadero, usa la versión más reciente de Xcode que esté disponible de forma local y remota. Si es falso, o si no hay versiones mutuas disponibles, usa la versión 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 disponibles como plataformas de ejecución para ejecutar acciones. Las plataformas se pueden especificar por destino exacto o como un patrón de destino. Estas plataformas se considerarán antes de las declaradas en el archivo WORKSPACE por register_execution_platforms(). Esta opción solo se puede establecer una vez; las instancias posteriores anularán la configuración de la marca anterior.
Etiquetas:execution
- Se acumulan
--extra_toolchains=<comma-separated list of options>
usos múltiples -
Son las reglas de la cadena de herramientas que se deben tener en cuenta durante la resolución de la cadena de herramientas. Las cadenas de herramientas se pueden especificar por 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
,loading_and_analysis
--grte_top=<a label>
predeterminado: Consulta la descripción-
Es una etiqueta para una biblioteca de libc registrada. La cadena de herramientas de crosstool selecciona el valor predeterminado, y casi nunca es necesario anularlo.
Etiquetas:action_command_lines
,affects_outputs
--host_compiler=<a string>
predeterminado: Consulta la descripción-
Es el compilador de C++ que se usará para la compilación del host. Se ignora si no se configura --host_crosstool_top.
Etiquetas:loading_and_analysis
,execution
- Valor predeterminado de
--host_crosstool_top=<a build target label>
: ver descripción -
De forma predeterminada, las opciones --crosstool_top y --compiler también se usan para la configuración de exec. Si se proporciona esta marca, Bazel usa la libc y el compilador predeterminados para el crosstool_top determinado.
Etiquetas:loading_and_analysis
,changes_inputs
,affects_outputs
--host_grte_top=<a label>
predeterminado: Consulta la descripción-
Si se especifica, este parámetro de configuración anula el directorio de nivel superior de libc (--grte_top) para la configuración de exec.
Etiquetas:action_command_lines
,affects_outputs
--host_platform=<a build target label>
valor predeterminado: "@bazel_tools//tools:host_platform"-
Etiqueta de una regla de la plataforma que describe el sistema de host.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
predeterminado: "true"-
Si es verdadero, Bazel no habilitará las funciones "host" y "nonhost" en la cadena de herramientas de C++ (consulta https://github.com/bazelbuild/bazel/issues/7407 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_android_toolchain_resolution
predeterminado: "true"-
Usa la resolución de la cadena de herramientas para seleccionar el SDK de Android para reglas de Android (Starlark y Native)
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_apple_toolchain_resolution
predeterminado: “false”-
Usa la resolución de la cadena de herramientas para seleccionar el SDK de Apple para las reglas de Apple (Starlark y Native)
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone
predeterminado: "true"-
Si es verdadero, Bazel no reutilizará las líneas de comandos de la acción de vinculación de C++ para las líneas de comandos de indexación de lto (consulta https://github.com/bazelbuild/bazel/issues/6791 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_legacy_whole_archive
predeterminado: "true"-
Si es verdadero, Bazel no vinculará las dependencias de la biblioteca como un archivo completo de forma predeterminada (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener instrucciones de migración).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_require_ctx_in_configure_features
predeterminado: "true"-
Si es verdadero, Bazel requerirá el parámetro "ctx" en cc_common.configure_features (consulta https://github.com/bazelbuild/bazel/issues/7793 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
-
Usa objetos compartidos de la interfaz si la cadena de herramientas lo admite. Actualmente, todas las cadenas de herramientas ELF admiten este parámetro de configuración.
Etiquetas:loading_and_analysis
,affects_outputs
,affects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Especifica la versión del SDK de iOS que se usará para compilar aplicaciones para iOS. Si no se especifica, usa la versión predeterminada del SDK de iOS de "xcode_version".
Etiquetas:loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Especifica la versión del SDK de macOS que se usará para compilar aplicaciones para macOS. Si no se especifica, usa la versión predeterminada del SDK de macOS de "xcode_version".
Etiquetas:loses_incremental_state
--minimum_os_version=<a string>
predeterminado: Consulta la descripción-
Es la versión mínima del SO a la que se orienta tu compilación.
Etiquetas:loading_and_analysis
,affects_outputs
--platform_mappings=<a relative path>
predeterminado: ""-
Es la ubicación de un archivo de asignación que describe qué plataforma usar si no se establece ninguna o qué marcas establecer cuando ya existe una plataforma. Debe ser relativo a la raíz del espacio de trabajo principal. El valor predeterminado es "platform_mappings" (un archivo directamente debajo de la raíz del espacio de trabajo).
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--platforms=<a build target label>
predeterminado: ""-
Son las etiquetas de las reglas de la plataforma que describen las plataformas de destino del comando actual.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--python2_path=<a string>
predeterminado: Consulta la descripción-
Obsoleto, no-op. Inhabilitado por `--incompatible_use_python_toolchains`.
Etiquetas:no_op
,deprecated
--python3_path=<a string>
predeterminado: Consulta la descripción-
Obsoleto, no-op. Inhabilitado por `--incompatible_use_python_toolchains`.
Etiquetas:no_op
,deprecated
--python_path=<a string>
predeterminado: Consulta la descripción-
Es la ruta de acceso absoluta del intérprete de Python que se invocó para ejecutar destinos de Python en la plataforma de destino. Obsoleto; se inhabilitó con --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
- Valor predeterminado de
--python_top=<a build target label>
: ver descripción -
La etiqueta de un py_runtime que representa el intérprete de Python invocado para ejecutar destinos de Python en la plataforma de destino. Obsoleto; se inhabilitó con --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Especifica la versión del SDK de tvOS que se usará para compilar aplicaciones de tvOS. Si no se especifica, se usa la versión predeterminada del SDK de tvOS de "xcode_version".
Etiquetas:loses_incremental_state
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Especifica la versión del SDK de watchOS que se usará para compilar aplicaciones para watchOS. Si no se especifica, 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"-
Es la etiqueta de la regla xcode_config que se usará para seleccionar la versión de Xcode en la configuración de compilación.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Opciones que controlan el resultado del comando:
--[no]apple_generate_dsym
predeterminado: “false”-
Indica si se deben generar archivos de símbolos de depuración (.dSYM).
Etiquetas:affects_outputs
,action_command_lines
--[no]build_runfile_links
predeterminado: "true"-
Si es verdadero, compila bosques de symlinks de runfiles para todos los destinos. Si es falso, escríbelos solo cuando lo requiera una acción local, una prueba o un comando de ejecución.
Etiquetas:affects_outputs
--[no]build_runfile_manifests
predeterminado: "true"-
Si es verdadero, escribe manifiestos de archivos runfiles para todos los destinos. Si es falsa, omítelas. Las pruebas locales no se ejecutarán si es falso.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]build_test_dwp
: "falso" -
Si está habilitado, cuando se compilen pruebas de C++ de forma estática y con Fission, el archivo .dwp para el objeto binario de prueba también se compilará automáticamente.
Etiquetas:loading_and_analysis
,affects_outputs
--cc_proto_library_header_suffixes=<comma-separated set of options>
predeterminado: “.pb.h”-
Establece los sufijos de los archivos de encabezado que crea una cc_proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated set of options>
predeterminado: “.pb.cc”-
Establece los sufijos de los archivos de origen que crea cc_proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
- Valor predeterminado de
--[no]experimental_proto_descriptor_sets_include_source_info
: "falso" -
Ejecuta acciones adicionales para versiones alternativas de la API de Java en una proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_proto_extra_actions
predeterminado: “false”-
Ejecuta acciones adicionales para versiones alternativas de la API de Java en una proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_save_feature_state
predeterminado: “false”-
Guarda el estado de las funciones habilitadas y solicitadas como un resultado de la compilación.
Etiquetas:affects_outputs
,experimental
--fission=<a set of compilation modes>
predeterminado: "no"-
Especifica qué modos de compilación usan la fisión para las compilaciones y los vínculos de C++. Puede ser cualquier combinación de {'fastbuild', 'dbg', 'opt'} o los valores especiales "yes" para habilitar todos los modos y "no" para inhabilitarlos.
Etiquetas:loading_and_analysis
,action_command_lines
,affects_outputs
--[no]incompatible_always_include_files_in_data
predeterminado: "true"-
Si es verdadero, las reglas nativas agregan <code>DefaultInfo.files</code> de dependencias de datos a sus archivos de ejecución, lo que coincide con el comportamiento recomendado para las reglas de Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid).
Etiquetas:affects_outputs
,incompatible_change
--[no]legacy_external_runfiles
predeterminado: "true"-
Si es verdadero, compila bosques de symlinks de runfiles para repositorios externos en .runfiles/wsname/external/repo (además de .runfiles/repo).
Etiquetas:affects_outputs
--[no]objc_generate_linkmap
predeterminado: “false”-
Especifica si se genera un archivo de mapa de vínculos.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]save_temps
: "falso" -
Si se establece, se guardarán los resultados temporales de gcc. Estos incluyen archivos .s (código de ensamblador), archivos .i (C procesado) y archivos .ii (C++ procesado).
Etiquetas:affects_outputs
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
- Se acumulan varios usos de
--action_env=<a 'name=value' assignment with an optional value part>
-
Especifica el conjunto de variables de entorno disponibles para las acciones con configuración de destino. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o bien por el par nombre=valor, que establece el valor independientemente del entorno de invocación. Esta opción se puede utilizar varias veces; en el caso de las opciones que se brindan para la misma variable, se acumulan las últimas ganancias, las 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
,loses_incremental_state
--[no]android_databinding_use_androidx
predeterminado: "true"-
Genera archivos de vinculación de datos compatibles con AndroidX. Esto solo se usa con la vinculación de datos v2. Esta marca no realiza ninguna acción.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]android_databinding_use_v3_4_args
predeterminado: "true"-
Usa Android Databinding v2 con el argumento 3.4.0. Esta marca es una no-op.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Configuración predeterminada de
--android_dynamic_mode=<off, default or fully>
: "desactivada" - determina si las dependencias de C++ de las reglas de Android se vincularán de forma dinámica cuando un cc_binary no cree una biblioteca compartida de forma explícita. "default" significa que bazel elegirá si vincular de forma dinámica. "Completamente" significa que todas las bibliotecas se vincularán de forma dinámica. "Desactivado" significa que todas las bibliotecas se vincularán en modo principalmente estático.
Etiquetas:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
predeterminado: "alphabetical"-
Establece el orden de los manifiestos que se pasan a la combinación de manifiestos para los objetos binarios de Android. ALPHABETICAL significa que los manifiestos se ordenan por ruta de acceso en relación con el execroot. ALPHABETICAL_BY_CONFIGURATION significa que los manifiestos se ordenan por rutas de acceso relativas al directorio de configuración dentro del directorio de salida. DEPENDENCY significa que los manifiestos se ordenan de modo que el manifiesto de cada biblioteca aparezca antes que los manifiestos de sus dependencias.
Etiquetas:action_command_lines
,execution
--[no]android_resource_shrinking
predeterminado: “false”-
Habilita la reducción de recursos para los APKs de android_binary que usan ProGuard.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]build_python_zip
predeterminado: “auto”-
Compila el archivo ZIP ejecutable de Python; activado en Windows, desactivado en otras plataformas.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--catalyst_cpus=<comma-separated list of options>
-
Es una lista de arquitecturas separadas por comas para las que se compilarán objetos binarios de Apple Catalyst.
Etiquetas:loses_incremental_state
,loading_and_analysis
--[no]collect_code_coverage
predeterminado: “false”-
Si se especifica, Bazel instrumentará el código (con instrumentación sin conexión siempre que sea posible) y recopilará información de cobertura durante las pruebas. Solo se verán afectadas las orientaciones que coincidan con --instrumentation_filter. Por lo general, esta opción no debe especificarse directamente; en su lugar, se debe usar el comando “bazel connection”.
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
,action_command_lines
- Se acumulan varios usos de
--conlyopt=<a string>
. -
Opción adicional para pasar a gcc cuando se compilan archivos de origen C.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--copt=<a string>
-
Opciones adicionales para pasar a gcc.
Etiquetas:action_command_lines
,affects_outputs
--cpu=<a string>
predeterminado: ""-
La CPU objetivo.
Etiquetas:changes_inputs
,affects_outputs
- Valor predeterminado de
--cs_fdo_absolute_path=<a string>
: ver descripción -
Usa la información del perfil de CSFDO para optimizar la compilación. Especifica el nombre de la ruta de acceso absoluta del archivo ZIP que contiene el archivo de perfil, un archivo de perfil LLVM sin procesar o indexado.
Etiquetas:affects_outputs
--cs_fdo_instrument=<a string>
predeterminado: Consulta la descripción-
Genera ejecutables con instrumentación de FDO sensible al contexto. Con el compilador Clang/LLVM, también acepta el nombre del directorio en el que se volcarán los archivos de perfil sin procesar durante el tiempo de ejecución.
Etiquetas:affects_outputs
--cs_fdo_profile=<a build target label>
predeterminado: Consulta la descripción-
El cs_fdo_profile que representa el perfil sensible al contexto que se usará para la optimización.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--cxxopt=<a string>
-
Opción adicional para pasar a gcc cuando se compilan archivos de origen C++.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--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
,affects_outputs
- Valor predeterminado de
--dynamic_mode=<off, default or fully>
: “predeterminado” - determina si los objetos binarios de C++ se vincularán de forma dinámica. "default" significa que Bazel elegirá si vincular de forma dinámica. "completamente" significa que todas las bibliotecas se vincularán de forma dinámica. "Desactivado" significa que todas las bibliotecas se vincularán en modo principalmente estático.
Etiquetas:loading_and_analysis
,affects_outputs
- Valor predeterminado de
--[no]enable_fdo_profile_absolute_path
: "true" -
Si se establece, el uso de fdo_absolute_profile_path generará un error.
Etiquetas:affects_outputs
--[no]enable_runfiles
predeterminado: “auto”-
Habilita el árbol de symlinks de runfiles. De forma predeterminada, está desactivado en Windows y en otras plataformas.
Etiquetas:affects_outputs
- Se acumulan
--experimental_action_listener=<a build target label>
usos múltiples - dejó de estar disponible y se reemplazó por aspectos. Usa action_listener para adjuntar una extra_action a las acciones de compilación existentes.
Etiquetas:execution
,experimental
--[no]experimental_android_compress_java_resources
predeterminado: “false”-
Comprime los recursos de Java en los APKs.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_android_databinding_v2
predeterminado: "true"-
Usa Android Databinding v2. Esta marca no realiza ninguna acción.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_android_resource_shrinking
predeterminado: “false”-
Habilita la reducción de recursos para los APK android_binary que usan ProGuard.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_android_rewrite_dexes_with_rex
predeterminado: “false”-
Usa la herramienta rex para volver a escribir archivos dex.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_collect_code_coverage_for_generated_files
predeterminado: “false”-
Si se especifica, Bazel también generará información de cobertura recopilada para los archivos generados.
Etiquetas:affects_outputs
--experimental_objc_fastbuild_options=<comma-separated list of options>
predeterminado: "-O0,-DDEBUG=1"-
Usa estas cadenas como opciones del compilador de objc fastbuild.
Etiquetas:action_command_lines
--[no]experimental_omitfp
predeterminado: “false”-
Si es verdadero, usa libunwind para el desenredo de pila y compila con -fomit-frame-pointer y -fasynchronous-unwind-tables.
Etiquetas:action_command_lines
,affects_outputs
,experimental
- Configuración predeterminada de
--experimental_output_paths=<off, content or strip>
: "desactivada" -
Qué modelo usar para determinar en qué parte del árbol de salida las reglas escriben sus resultados, en particular para compilaciones multiplataforma o multiconfiguración. Esto es altamente experimental. Consulta https://github.com/bazelbuild/bazel/issues/6526 para obtener más información. Las acciones de Starlark pueden habilitar la asignación de rutas de acceso agregando la clave "supports-path-mapping" al diccionario "execution_requirements".
Etiquetas:loses_incremental_state
,bazel_internal_configuration
,affects_outputs
,execution
- Se acumulan varios usos de
--experimental_override_name_platform_in_output_dir=<a 'label=value' assignment>
-
Cada entrada debe tener el formato etiqueta=valor, en el que etiqueta hace referencia a una plataforma y valor es el nombre abreviado que se desea usar en la ruta de salida. Solo se usa cuando --experimental_platform_in_output_dir es verdadero. Tiene la prioridad de nombres más alta.
Etiquetas:affects_outputs
,experimental
--[no]experimental_platform_in_output_dir
predeterminado: “false”-
Si es verdadero, se usa un nombre corto para la plataforma de destino en el nombre del directorio de salida en lugar de la CPU. El esquema exacto es experimental y está sujeto a cambios: primero, en el caso poco frecuente de que la opción --platforms no tenga exactamente un valor, se usa un hash de la opción platforms. A continuación, si --experimental_override_name_platform_in_output_dir registró algún nombre corto para la plataforma actual, se usará 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
,experimental
--[no]experimental_use_llvm_covmap
predeterminado: “false”-
Si se especifica, Bazel generará información del mapa de cobertura de llvm-cov en lugar de gcov cuando se habilite collect_code_coverage.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
- Valor predeterminado de
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic
: "true" -
Usa esta marca solo como parte de una estrategia de migración o prueba 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
,experimental
--fat_apk_cpu=<comma-separated set of options>
predeterminado: "armeabi-v7a"-
Si configuras esta opción, se habilitan los APKs multiarquitectura, que contienen objetos binarios nativos para todas las arquitecturas de destino especificadas, p.ej., --fat_apk_cpu=x86,armeabi-v7a. Si se especifica esta marca, se ignora --android_cpu para las dependencias de las reglas android_binary.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]fat_apk_hwasan
predeterminado: “false”-
Indica si se deben crear divisiones HWASAN.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--fdo_instrument=<a string>
predeterminado: Consulta la descripción-
Genera ejecutables con la instrumentación de FDO. Con el compilador Clang/LLVM, también acepta el nombre del directorio en el que se volcarán los archivos de perfil sin procesar durante el tiempo de ejecución.
Etiquetas:affects_outputs
- Valor predeterminado de
--fdo_optimize=<a string>
: ver descripción -
Usa la información del perfil de FDO para optimizar la compilación. Especifica el nombre de un archivo ZIP que contenga un árbol de archivos .gcda, un archivo afdo que contenga un perfil automático o un archivo de perfil de LLVM. Esta marca también acepta archivos especificados como etiquetas (p.ej., "//foo/bar:file.afdo"; es posible que debas agregar una directiva "exports_files" al paquete correspondiente) y etiquetas que apuntan a destinos "fdo_profile". La regla "fdo_profile" reemplazará esta marca.
Etiquetas:affects_outputs
- Valor predeterminado de
--fdo_prefetch_hints=<a build target label>
: ver descripción -
Usa sugerencias de almacenamiento en caché para la carga previa.
Etiquetas:affects_outputs
--fdo_profile=<a build target label>
predeterminado: Consulta la descripción-
Es el fdo_profile que representa el perfil que se usará para la optimización.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--features=<a string>
-
Las funciones determinadas se habilitarán o inhabilitarán de forma predeterminada para los destinos compilados en la configuración de destino. Si especificas -<feature>, se inhabilitará la función. Los atributos negativos siempre anulan los positivos. Consulta también --host_features
Etiquetas:changes_inputs
,affects_outputs
--[no]force_pic
predeterminado: “false”-
Si está habilitada, todas las compilaciones de C++ producen código independiente de la posición ("-fPIC"), las vinculaciones prefieren las bibliotecas compiladas previamente de PIC en lugar de las bibliotecas que no son de PIC, y las vinculaciones producen ejecutables independientes de la posición ("-pie").
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan varios usos de
--host_action_env=<a 'name=value' assignment with an optional value part>
-
Especifica el conjunto de variables de entorno disponibles para las acciones con configuraciones de ejecución. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o por el par nombre=valor que establece el valor de forma independiente del entorno de invocación. Esta opción se puede utilizar varias veces; en el caso de las opciones que se brindan para la misma variable, se acumulan las últimas ganancias, las opciones para diferentes variables.
Etiquetas:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
predeterminado: "opt"-
Especifica el modo en el que se compilarán las herramientas que se usan durante la compilación. Valores: "fastbuild", "dbg", "opt".
Etiquetas:affects_outputs
,action_command_lines
- Se acumulan varios usos de
--host_conlyopt=<a string>
-
Opción adicional para pasar al compilador de C cuando se compilan archivos de origen C (pero no C++) en las configuraciones de ejecución.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--host_copt=<a string>
-
Opciones adicionales para pasar al compilador C para herramientas compiladas en las configuraciones de ejecución.
Etiquetas:action_command_lines
,affects_outputs
--host_cpu=<a string>
predeterminado: ""-
La CPU del host.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan varios usos de
--host_cxxopt=<a string>
-
Opciones adicionales para pasar al compilador de C++ para herramientas compiladas en las configuraciones de ejecución.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--host_features=<a string>
usos múltiples -
Las funciones determinadas se habilitarán o inhabilitarán de forma predeterminada para los destinos compilados en la configuración de ejecución. Si especificas -<feature>, se inhabilitará la función. Los atributos negativos siempre anulan los positivos.
Etiquetas:changes_inputs
,affects_outputs
--host_force_python=<PY2 or PY3>
predeterminado: Consulta la descripción-
Anula la versión de Python para la configuración de ejecución. Puede ser “PY2” o “PY3”.
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan
--host_linkopt=<a string>
usos múltiples -
Opción adicional para pasar al vinculador cuando se vinculan herramientas en las configuraciones de ejecución.
Etiquetas:action_command_lines
,affects_outputs
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Versión mínima de macOS compatible para los destinos de host. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan varios usos de
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
. -
Opciones adicionales para pasar de forma selectiva al compilador C/C++ cuando se compilan ciertos archivos en las configuraciones de ejecución. Esta opción se puede aprobar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. En la que regex_filter representa una lista de patrones de expresiones regulares para incluir y excluir (consulta también --instrumentation_filter). option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe estar entre comillas con una barra diagonal inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos de gcc de todos los archivos cc en //foo/, excepto bar.cc.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--host_swiftcopt=<a string>
-
Opciones adicionales para pasar a swiftc para herramientas de ejecución.
Etiquetas:action_command_lines
,affects_outputs
--[no]incompatible_auto_exec_groups
predeterminado: “false”-
Cuando se habilita, se crea automáticamente un grupo de ejecución para cada cadena de herramientas que usa una regla. Para que 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
,incompatible_change
--[no]incompatible_merge_genfiles_directory
predeterminado: "true"-
Si es verdadero, el directorio genfiles se une al directorio bin.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_use_host_features
predeterminado: "true"-
Si es verdadero, usa --features solo para la configuración de destino y --host_features para la configuración de ejecución.
Etiquetas:changes_inputs
,affects_outputs
,incompatible_change
--[no]instrument_test_targets
predeterminado: “false”-
Cuando se habilita la cobertura, especifica si se deben considerar reglas de prueba. Cuando se establece, se instrumentan las reglas de prueba que incluye --instrumentation_filter. De lo contrario, las reglas de prueba siempre se excluyen de la instrumentación de cobertura.
Etiquetas:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
predeterminado: "-/javatests[/:],-/test/java[/:]"-
Cuando la cobertura esté habilitada, solo se instrumentarán las reglas con nombres incluidos en el filtro basado en regex especificado. En su lugar, se excluyen las reglas con el prefijo “-”. Ten en cuenta que solo se instrumentan las reglas que no son de prueba, a menos que se habilite --instrument_test_targets.
Etiquetas:affects_outputs
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Versión mínima de iOS compatible con dispositivos y simuladores de destino. Si no se especifica, usa "ios_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan
--ios_multi_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para compilar una aplicación ios_application. El resultado es un binario universal que contiene todas las arquitecturas especificadas.
Etiquetas:loses_incremental_state
,loading_and_analysis
--[no]legacy_whole_archive
predeterminado: "true"-
Deja de estar disponible y se reemplaza por --incompatible_remove_legacy_whole_archive (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener más información). Cuando está activado, usa --whole-archive para las reglas cc_binary que tienen linkshared=True y linkstatic=True o “-static” en linkopts. Esto es solo para la retrocompatibilidad. Una mejor alternativa es usar alwayslink=1 cuando sea necesario.
Etiquetas:action_command_lines
,affects_outputs
,deprecated
- Se acumulan varios usos de
--linkopt=<a string>
- : Opción adicional para pasar a gcc cuando se realiza la vinculación.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--ltobackendopt=<a string>
usos múltiples -
Es una opción adicional para pasar al paso de backend de LTO (en --features=thin_lto).
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--ltoindexopt=<a string>
usos múltiples -
Opción adicional para pasar al paso de indexación de LTO (en --features=thin_lto).
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--macos_cpus=<comma-separated list of options>
. -
Es una lista separada por comas de las arquitecturas para las que se compilarán los objetos binarios de Apple macOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Versión mínima de macOS compatible para los destinos. Si no se especifica, usa "macos_sdk_version".
Etiquetas:loses_incremental_state
--memprof_profile=<a build target label>
predeterminado: Consulta la descripción-
Usa el perfil de memprof.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]objc_debug_with_GLIBCXX
: "falso" -
Si se establece y el modo de compilación se establece en "dbg", define GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC y GLIBCPP_CONCEPT_CHECKS.
Etiquetas:action_command_lines
--[no]objc_enable_binary_stripping
predeterminado: “false”-
Indica si se deben quitar los símbolos y el código muerto en los objetos binarios vinculados. Se realizarán eliminaciones de objetos binarios si se especifican esta marca y --compilation_mode=opt.
Etiquetas:action_command_lines
- Se acumulan varios usos de
--objccopt=<a string>
-
Opciones adicionales para pasar a gcc cuando se compilan archivos de origen Objective-C/C++.
Etiquetas:action_command_lines
- Se acumulan varios usos de
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
-
Opciones adicionales para pasar a gcc de forma selectiva cuando se compilan ciertos archivos. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,…,option_n. En la que regex_filter representa una lista de patrones de expresiones regulares para incluir y excluir (consulta también --instrumentation_filter). option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe estar entre comillas con una barra diagonal inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos de gcc de todos los archivos cc en //foo/, excepto bar.cc.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
. -
Opciones adicionales para pasar de forma selectiva al backend de LTO (en --features=thin_lto) cuando se compilan ciertos objetos de backend. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. En la que regex_filter representa una lista de patrones de expresión regular para incluir y excluir. option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, 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 de LTO de todos los archivos .o en //foo/, excepto bar.o.
Etiquetas:action_command_lines
,affects_outputs
- Valor predeterminado de
--platform_suffix=<a string>
: ver descripción -
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas:loses_incremental_state
,affects_outputs
,loading_and_analysis
--propeller_optimize=<a build target label>
predeterminado: Consulta la descripción-
Usa la información del perfil de Propeller para optimizar el destino de compilación.Un perfil de Propeller debe constar de al menos uno de dos archivos: un perfil de cc y un perfil de ld. Esta marca acepta una etiqueta de compilación que debe hacer referencia a los archivos de entrada del perfil de Propeller. Por ejemplo, el archivo BUILD que define la etiqueta, en a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)Es posible que se deba agregar una directiva exports_files al paquete correspondiente para que Bazel pueda ver estos archivos. La opción se debe usar de la siguiente manera: --propeller_optimize=//a/b:propeller_profile
Etiquetas:action_command_lines
,affects_outputs
- Valor predeterminado de
--propeller_optimize_absolute_cc_profile=<a string>
: ver descripción -
Nombre de ruta de acceso absoluta del archivo cc_profile para compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
predeterminado: Consulta la descripción-
Es el nombre de ruta de acceso absoluto del archivo ld_profile para las compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
--run_under=<a prefix in front of command>
predeterminado: Consulta la descripción-
Es el prefijo que se inserta antes de los ejecutables para los comandos "test" y "run". Si el valor es "foo -bar" y la línea de comandos de ejecución es "test_binary -baz", la línea de comandos final es "foo -bar test_binary -baz".Esto también puede ser una etiqueta para un destino ejecutable. Algunos ejemplos son: "valgrind", "strace", "strace -c", "valgrind --quiet --num-callers=20", "//package:target", "//package:target --options".
Etiquetas:action_command_lines
-
Si es verdadera, las bibliotecas nativas que contengan una funcionalidad idéntica se compartirán entre diferentes destinos
Etiquetas:loading_and_analysis
,affects_outputs
--[no]stamp
predeterminado: “false”-
Marca los objetos binarios con la fecha, el nombre de usuario, el nombre de host, la información del espacio de trabajo, etcétera.
Etiquetas:affects_outputs
- Valor predeterminado de
--strip=<always, sometimes or never>
: “sometimes” - especifica si se deben quitar los objetos binarios y las bibliotecas compartidas (con "-Wl,--strip-debug"). El valor predeterminado de “algunas veces” significa quitar iff --compilation_mode=fastbuild.
Etiquetas:affects_outputs
- Se acumulan
--stripopt=<a string>
usos múltiples -
Opciones adicionales para pasar a la eliminación cuando se genera un objeto binario "<name>.stripped".
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--swiftcopt=<a string>
. -
Opciones adicionales para pasar a la compilación con Swift.
Etiquetas:action_command_lines
- Se acumulan varios usos de
--tvos_cpus=<comma-separated list of options>
-
Es una lista separada por comas de las arquitecturas para las que se compilarán los objetos binarios de Apple tvOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Versión mínima compatible de tvOS para los simuladores y dispositivos de destino. Si no se especifica, se usa "tvos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan
--visionos_cpus=<comma-separated list of options>
usos múltiples -
Es una lista separada por comas de las arquitecturas para las que se compilarán los objetos binarios de Apple visionOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Se acumulan varios usos de
--watchos_cpus=<comma-separated list of options>
-
Es una lista separada por comas de las arquitecturas para las que se compilarán los objetos binarios de Apple watchOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Versión mínima compatible de watchOS para los simuladores y dispositivos de destino. Si no se especifica, se usa "watchos_sdk_version".
Etiquetas:loses_incremental_state
--xbinary_fdo=<a build target label>
predeterminado: Consulta la descripción-
Usa la información del perfil de XbinaryFDO para optimizar la compilación. Especifica el nombre del perfil 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 exactitud con la que Bazel aplica de manera forzosa las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
--auto_cpu_environment_group=<a build target label>
predeterminado: ""-
Declara el environment_group que se usará para asignar automáticamente los valores de CPU a los valores de target_environment.
Etiquetas:changes_inputs
,loading_and_analysis
,experimental
--[no]check_licenses
predeterminado: “false”-
Verifica que las restricciones de licencias que imponen los paquetes dependientes no entren en conflicto con los modos de distribución de los destinos que se compilan. De forma predeterminada, no se verifican las licencias.
Etiquetas:build_file_semantics
--[no]check_visibility
predeterminado: "true"-
Si se inhabilita, los errores de visibilidad en las dependencias de destino se degradan a advertencias.
Etiquetas:build_file_semantics
- Valor predeterminado de
--[no]desugar_for_android
: "true" -
Indica si se debe expandir el código de bytes de Java 8 antes de dexificarlo.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]desugar_java8_libs
predeterminado: “false”-
Indica si se deben incluir bibliotecas Java 8 compatibles en apps para dispositivos heredados.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]enforce_constraints
predeterminado: "true"-
Verifica los entornos con los que cada destino es compatible y, además, informa los errores si algún destino tiene dependencias que no admiten los mismos entornos.
Etiquetas:build_file_semantics
- Valor predeterminado de
--[no]experimental_check_desugar_deps
: "true" -
Determina si se debe volver a verificar la expansión correcta a nivel binario de Android.
Etiquetas:eagerness_to_exit
,loading_and_analysis
,experimental
--experimental_import_deps_checking=<off, warning or error>
predeterminado: “OFF”-
Cuando está habilitada, verifica si las dependencias de una aar_import están completas. Esta aplicación forzosa puede interrumpir la compilación o generar advertencias.
Etiquetas:loading_and_analysis
--experimental_one_version_enforcement=<off, warning or error>
predeterminado: “OFF”-
Cuando está habilitada, se aplica la regla de que una regla java_binary no puede contener más de una versión del mismo archivo de clase en la ruta de acceso a clases. Esta aplicación puede romper la compilación o generar advertencias.
Etiquetas:loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
predeterminado: "predeterminado"-
Si es verdadero, verifica que un destino de Java declare explícitamente todos los destinos utilizados directamente como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files
predeterminado: “false”-
Si está habilitado, busca el atributo testonly de la regla de generación para verificar si hay destinos de requisitos previos que sean archivos de salida. Esto coincide con la verificación de visibilidad.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_check_visibility_for_toolchains
predeterminado: “false”-
Si está habilitada, la verificación de visibilidad también se aplica a las implementaciones de cadenas de herramientas.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_disable_native_android_rules
predeterminado: “false”-
Si se habilita, se inhabilita el uso directo de las reglas nativas de Android. Usa las reglas de Android de Starlark de https://github.com/bazelbuild/rules_android.
Etiquetas:eagerness_to_exit
,incompatible_change
--[no]incompatible_disable_native_apple_binary_rule
predeterminado: “false”-
No realiza ninguna acción. Se mantiene aquí para la retrocompatibilidad.
Etiquetas:eagerness_to_exit
,incompatible_change
--[no]incompatible_python_disable_py2
predeterminado: "true"-
Si es verdadero, el uso de la configuración de Python 2 generará un error. Esto incluye python_version=PY2, srcs_version=PY2 y srcs_version=PY2ONLY. Consulta https://github.com/bazelbuild/bazel/issues/15684 para obtener más información.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_validate_top_level_header_inclusions
predeterminado: "true"-
Si es verdadero, Bazel también validará las inclusiones de encabezados de directorio de nivel superior (consulta https://github.com/bazelbuild/bazel/issues/10047 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]one_version_enforcement_on_java_tests
predeterminado: "true"-
Cuando se habilita, y con experimental_one_version_enforcement configurado en un valor que no es NONE, se aplica una versión en los destinos java_test. Esta marca se puede inhabilitar para mejorar el rendimiento de las pruebas incrementales a costa de perder posibles incumplimientos de una versión.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--python_native_rules_allowlist=<a build target label>
: ver descripción -
Es una lista de entidades permitidas (objetivo de package_group) que se usará cuando se aplique --incompatible_python_disallow_native_rules.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]strict_filesets
: "falso" -
Si esta opción está habilitada, los conjuntos de archivos que cruzan los límites de los paquetes se informan como errores.
Etiquetas:build_file_semantics
,eagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default>
predeterminado: "error"-
A menos que esté desactivado, comprueba que un destino de proto_library declare de forma explícita todos los destinos utilizados directamente como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
--strict_public_imports=<off, warn, error, strict or default>
predeterminado: "off"-
A menos que esté DESACTIVADA, se verifica que un destino proto_library declare explícitamente todos los destinos usados en el campo "import public" como exportado.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
--[no]strict_system_includes
predeterminado: “false”-
Si es verdadero, también se deben declarar los encabezados que se encuentran a través de las rutas de inclusión del sistema (-isystem).
Etiquetas:loading_and_analysis
,eagerness_to_exit
- Se acumulan varios usos de
--target_environment=<a build target label>
. -
Declara el entorno de destino de esta compilación. Debe ser una referencia de etiqueta a una regla de "entorno". Si se 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 que se usará para firmar APKs
Etiquetas:action_command_lines
,affects_outputs
,loading_and_analysis
--[no]device_debug_entitlements
predeterminado: "true"-
Si se establece y el modo de compilación no es "opt", las apps de objc incluirán derechos de depuración cuando se firmen.
Etiquetas:changes_inputs
--ios_signing_cert_name=<a string>
predeterminado: Consulta la descripción-
Es el 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 la substring del nombre común del certificado, según la página de man de codesign (IDENTIDADES DE FIRMA).
Etiquetas:action_command_lines
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.:
--[no]incompatible_disallow_legacy_py_provider
predeterminado: "true"-
No se realizará ninguna acción, se quitará pronto.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_sdk_frameworks_attributes
predeterminado: “false”-
Si el valor es verdadero, no permitir los atributos sdk_frameworks y bad_sdk_frameworks en objc_library y objc_import.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_objc_alwayslink_by_default
predeterminado: “false”-
Si es verdadero, establece como verdadero el valor predeterminado para los atributos Alwayslink en objc_library y objc_import.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_python_disallow_native_rules
predeterminado: “false”-
Cuando es verdadero, se produce un error cuando se usan las reglas py_* integradas. En su lugar, se deben usar las reglas rule_python. Consulta https://github.com/bazelbuild/bazel/issues/17773 para obtener más información y las instrucciones de migración.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones que determinan el comportamiento del entorno de pruebas o del ejecutor de pruebas:
--[no]allow_analysis_failures
predeterminado: “false”-
Si es verdadero, una falla de análisis de un objetivo de regla genera la propagación del objetivo de una instancia de AnalysisFailureInfo que contiene la descripción del error, en lugar de generar una falla de compilación.
Etiquetas:loading_and_analysis
,experimental
--analysis_testing_deps_limit=<an integer>
predeterminado: “2000”-
Establece la cantidad máxima de dependencias transitivas a través de un atributo de regla con una transición de configuración for_analysis_testing. Si se supera este límite, se mostrará un error de regla.
Etiquetas:loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure
predeterminado: “false”-
Si es verdadero, las fallas de la acción de dex2oat causarán que la compilación falle en lugar de ejecutar dex2oat durante el tiempo de ejecución de la prueba.
Etiquetas:loading_and_analysis
,experimental
- Se acumulan varios usos de
--default_test_resources=<a resource name followed by equal and 1 float or 4 float, e.g. memory=10,30,60,100>
. - Anula la cantidad de recursos predeterminada para las pruebas. El formato esperado es <resource>=<value>. Si se especifica un solo número positivo como <value>, se anularán los recursos predeterminados para todos los tamaños de prueba. Si se especifican 4 números separados por comas, estos anularán 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., memory=HOST_RAM*.1,HOST_RAM*.2,HOST_RAM*.3,HOST_RAM*.4). Los recursos de prueba predeterminados que especifica esta marca se anulan con los recursos explícitos que se especifican en las etiquetas.
- Valor predeterminado de
--[no]experimental_android_use_parallel_dex2oat
: "falso" -
Usa dex2oat en paralelo para acelerar android_test.
Etiquetas:loading_and_analysis
,host_machine_resource_optimizations
,experimental
--[no]ios_memleaks
predeterminado: “false”-
Habilita la verificación de fugas de memoria en los destinos de ios_test.
Etiquetas:action_command_lines
--ios_simulator_device=<a string>
predeterminado: Consulta la descripción-
Es el dispositivo que se simula cuando se ejecuta una aplicación para iOS en el simulador, p.ej., "iPhone 6". Para obtener una lista de dispositivos, ejecuta 'xcrun simctl list devicetypes' en la máquina en la que se ejecutará el simulador.
Etiquetas:test_runner
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Es la versión de iOS que se 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 varios usos de
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
- especifica la cantidad de veces que se debe ejecutar cada prueba. Si alguno de esos intentos falla por 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 la que runs_per_test representa un valor entero y regex_filter representa una lista de patrones de expresiones regulares para incluir y excluir (consulta también --instrumentation_filter). Ejemplo: --runs_per_test=//foo/.*,-//foo/bar/.*@3 ejecuta todas las pruebas en //foo/ excepto las que se encuentran en foo/bar tres veces. Esta opción se puede pasar varias veces. El argumento pasado más recientemente que coincida tiene prioridad. Si no hay coincidencias, la prueba solo se ejecuta una vez.
- Se acumulan
--test_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica variables de entorno adicionales que se insertarán en el entorno del ejecutor de pruebas. Las variables 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 varias variables. Solo lo usa el comando "bazel test".
Etiquetas:test_runner
- Valor predeterminado de
--test_timeout=<a single integer or comma-separated list of 4 integers>
: "-1" - Anula los valores predeterminados de tiempo de espera de prueba para los tiempos de espera de prueba (en segundos). Si se especifica un solo valor de número entero positivo, se anularán todas las categorías. Si se especifican 4 números enteros separados por comas, se anularán los tiempos de espera para corto, moderado, largo y eterno (en ese orden). 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 las pruebas no declaradas se archivarán en un archivo ZIP.
Etiquetas:test_runner
- Opciones relacionadas con el resultado de la consulta y la semántica:
--aspect_deps=<off, conservative or precise>
predeterminado: “conservadora”-
Cómo resolver las dependencias de aspecto cuando el formato de salida es uno de {xml,proto,record}. “off” significa que no se resuelven dependencias de aspecto, mientras que “conservative” (configuración predeterminada) significa que se agregan todas las dependencias de aspecto declaradas, independientemente de si se les asigna la clase de regla de dependencias directas. “precise” significa que solo se agregan los aspectos posiblemente activos según la clase de regla de las dependencias directas. Ten en cuenta que el modo preciso requiere la carga de otros paquetes para evaluar un solo objetivo, lo que lo hace más lento que los otros modos. Además, ten en cuenta que incluso el modo preciso no es del todo preciso: la decisión de calcular un aspecto se decide en la fase de análisis, que no se ejecuta durante la “consulta de Bazel”.
Etiquetas:build_file_semantics
--[no]consistent_labels
predeterminado: “false”-
Si está habilitada, cada comando de consulta emite etiquetas como si fuera la función Starlark <code>str</code> aplicada a una instancia de <code>Label</code>. Esto es útil para las herramientas que deben coincidir con el resultado de diferentes comandos de consulta o etiquetas emitidos por reglas. Si no están habilitados, los formateadores de salida pueden emitir nombres de repositorio aparentes (en relación con el repositorio principal) para que el resultado sea más legible.
Etiquetas:terminal_output
--[no]experimental_explicit_aspects
predeterminado: “false”-
aquery, cquery: Indica si se deben incluir acciones generadas por aspectos en el resultado. query: No-op (siempre se siguen los aspectos).
Etiquetas:terminal_output
- Valor predeterminado de
--[no]graph:factored
: "true" -
Si es verdadero, el gráfico se emitirá "factorizado", es decir, los nodos topológicamente equivalentes se combinarán y sus etiquetas se concatenarán. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--graph:node_limit=<an integer>
predeterminado: “512”-
Es la longitud máxima de la string de etiqueta para un nodo del grafo en el resultado. Las etiquetas más largas se truncan. -1 significa que no hay truncamiento. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--[no]implicit_deps
predeterminado: "true"-
Si está habilitada, se incluirán dependencias implícitas en el gráfico de dependencias sobre el que opera la consulta. Una dependencia implícita es 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
--[no]include_artifacts
predeterminado: "true"-
Incluye los nombres de las entradas y salidas de la acción en el resultado (potencialmente grande).
Etiquetas:terminal_output
--[no]include_aspects
predeterminado: "true"-
aquery, cquery: si 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 (potencialmente grande).
Etiquetas:terminal_output
--[no]include_file_write_contents
predeterminado: “false”-
Incluye el contenido del archivo para las acciones FileWrite, SourceSymlinkManifest y RepoMappingManifest (potencialmente grandes).
Etiquetas:terminal_output
--[no]include_param_files
predeterminado: “false”-
Incluye el contenido de los archivos de parámetros que se usan en el comando (potencialmente grande). Nota: Si habilitas esta marca, se habilitará automáticamente la marca --include_commandline.
Etiquetas:terminal_output
--[no]incompatible_package_group_includes_double_slash
predeterminado: "true"-
Si está habilitada, cuando se genere el atributo "packages" de package_group, no se omitirá el "//" inicial.
Etiquetas:terminal_output
,incompatible_change
- 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 el valor de --universe_scope inferido para una expresión de consulta que usa funciones centradas en el universo (p.ej., "allrdeps") puede no ser lo que deseas, por lo que debes usar esta opción solo si sabes lo que estás haciendo. Consulta https://bazel.build/reference/query#sky-query para obtener detalles y ejemplos. Si se establece --universe_scope, se ignora el valor de esta opción. Nota: Esta opción solo se aplica a “query” (es decir, no a “cquery”).
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]line_terminator_null
: "falso" -
Indica si cada formato finaliza con \0 en lugar de una línea nueva.
Etiquetas:terminal_output
--[no]nodep_deps
predeterminado: "true"-
Si está habilitada, las dependencias de los atributos "nodep" se incluirán en el gráfico de dependencias sobre el que opera la consulta. Un ejemplo común de un atributo "nodep" es "visibility". Ejecuta y analiza el resultado de "info build-language" para obtener información sobre todos los atributos "nodep" en el lenguaje de compilación.
Etiquetas:build_file_semantics
--output=<a string>
predeterminado: “text”-
Es el formato en el que se deben imprimir los resultados de la consulta. Los valores permitidos para aquery son: text, textproto, proto, streamed_proto y jsonproto.
Etiquetas:terminal_output
--[no]proto:default_values
predeterminado: "true"-
Si es verdadero, se incluyen los atributos cuyo valor no se especifica de forma explícita en el archivo BUILD; de lo contrario, se omiten. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:definition_stack
: "falso" -
Propaga el campo proto definition_stack, que registra para cada instancia de regla la pila de llamadas de Starlark en el momento en que se definió la clase de la regla.
Etiquetas:terminal_output
--[no]proto:flatten_selects
predeterminado: "true"-
Si está habilitada, los atributos configurables creados por select() se aplanan. En el caso de los tipos de lista, la representación aplanada es una lista que contiene cada valor del mapa de selección exactamente una vez. Los tipos escalares se aplanan a nulos.
Etiquetas:build_file_semantics
--[no]proto:include_attribute_source_aspects
predeterminado: “false”-
Propaga el campo 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
--[no]proto:include_synthetic_attribute_hash
predeterminado: “false”-
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" -
Indica si se debe generar información de ubicación en el resultado de proto.
Etiquetas:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
predeterminado: “all”-
Es una lista de atributos separados por comas que se incluirán en el resultado. La configuración predeterminada es todos los atributos. Establece una cadena vacía para no mostrar ningún atributo. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
--[no]proto:rule_inputs_and_outputs
predeterminado: "true"-
Indica si se propagan o no los campos rule_input y rule_output.
Etiquetas:terminal_output
--query_file=<a string>
predeterminado: ""-
Si se establece, la consulta leerá la consulta del archivo que se nombra aquí, en lugar de la línea de comandos. Especificar un archivo aquí y una consulta de línea de comandos es un error.
Etiquetas:changes_inputs
--[no]relative_locations
predeterminado: “false”-
Si es verdadero, la ubicación de los archivos BUILD en los resultados de xml y proto será relativa. De forma predeterminada, el resultado de la ubicación es una ruta de acceso absoluta y no será coherente en todas las máquinas. Puedes establecer esta opción en verdadero para obtener un resultado coherente en todas las máquinas.
Etiquetas:terminal_output
--[no]skyframe_state
predeterminado: “false”-
Sin realizar un análisis adicional, volca el grafo de acciones actual de Skyframe. Nota: Actualmente, no se admite especificar un destino con --skyframe_state. Esta marca solo está disponible con --output=proto o --output=textproto.
Etiquetas:terminal_output
--[no]tool_deps
predeterminado: "true"-
Consulta: Si se inhabilita, las dependencias de "configuración de ejecución" no se incluirán en el gráfico de dependencias sobre el que opera la consulta. Un perímetro de dependencia de 'configuración de ejecución', como la de cualquier regla de 'proto_library' para el Compilador de protocolos, generalmente apunta a una herramienta ejecutada durante la compilación en lugar de a una parte del mismo programa de '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 objetivo de nivel superior está en la configuración de destino, solo se mostrarán los objetivos configurados también en la configuración de destino. Si el objetivo de nivel superior está en la configuración de exec, solo se mostrarán los objetivos configurados por exec. Esta opción NO excluirá las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
--universe_scope=<comma-separated list of options>
predeterminado: ""-
Un conjunto de patrones de destino separados por comas (aditivos y sustractivos). La consulta se puede realizar en el universo definido por el cierre transitivo de los destinos especificados. Esta opción se usa para los comandos query y cquery.
En el caso de cquery, la entrada de esta opción son los objetivos en los que se compilan todas las respuestas, por lo que esta opción puede afectar las configuraciones y las transiciones. Si no se especifica esta opción, se supone que los objetivos de nivel superior son los objetivos analizados de la expresión de consulta. Nota: En el caso de cquery, si no se especifica esta opción, es posible que la compilación falle si los destinos analizados de la expresión de consulta no se pueden compilar con opciones de nivel superior.
Etiquetas:loading_and_analysis
- Opciones que activan optimizaciones del tiempo de compilación:
--[no]experimental_filter_library_jar_with_program_jar
predeterminado: “false”-
Filtra el ProgramJar de ProGuard para quitar las clases que también estén presentes en el LibraryJar.
Etiquetas:action_command_lines
--[no]experimental_inmemory_dotd_files
predeterminado: "true"-
Si se habilita, los archivos .d de C++ se pasarán en la memoria directamente desde los nodos de compilación remotos en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_inmemory_jdeps_files
predeterminado: "true"-
Si está habilitado, los archivos de dependencia (.jdeps) generados a partir de compilaciones de Java se pasarán en la memoria directamente desde los nodos de compilación remotos en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_objc_include_scanning
predeterminado: “false”-
Indica si se debe incluir el análisis de C/C++ objetivo.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
--[no]experimental_retain_test_configuration_across_testonly
predeterminado: “false”-
Cuando se habilita, --trim_test_configuration no recortará la configuración de prueba de las reglas marcadas como testonly=1. Esto se hace para reducir los problemas de conflicto de acciones cuando las reglas que no son de prueba dependen de las reglas de cc_test. No tiene efecto si --trim_test_configuration es falso.
Etiquetas:loading_and_analysis
,loses_incremental_state
- Valor predeterminado de
--[no]experimental_starlark_cc_import
: "falso" -
Si está habilitada, se puede usar la versión de Starlark de cc_import.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_unsupported_and_brittle_include_scanning
predeterminado: “false”-
Determina si se deben limitar las entradas 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, ya que reduce el tamaño de los árboles de entrada de compilación. Sin embargo, también puede interrumpir las compilaciones porque el escáner de inclusión no implementa por completo la semántica del preprocesador C. En particular, no comprende las directivas #include dinámicas y omite la lógica condicional del preprocesador. Úsala bajo tu propia responsabilidad. Se cerrarán todos los problemas relacionados con esta marca que se hayan presentado.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
--[no]incremental_dexing
predeterminado: "true"-
Realiza la mayor parte del trabajo para la conversión a DEX por separado para cada archivo jar.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]objc_use_dotd_pruning
predeterminado: "true"-
Si se establece, los archivos .d emitidos por clang se usarán para podar el conjunto de entradas que se pasan a las compilaciones de objc.
Etiquetas:changes_inputs
,loading_and_analysis
- Valor predeterminado de
--[no]process_headers_in_dependencies
: "falso" -
Cuando compilas un destino //a:a, procesa los encabezados en todos los destinos de los que depende //a:a (si el procesamiento de encabezados está habilitado para la cadena de herramientas).
Etiquetas:execution
--[no]trim_test_configuration
predeterminado: "true"-
Cuando se habilita 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 las pruebas no harán que se vuelvan a analizar las reglas que no son de prueba.
Etiquetas:loading_and_analysis
,loses_incremental_state
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Valor predeterminado de
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: “-.*”. -
Imprime información de depuración durante la resolución de la cadena de herramientas. La marca toma una regex, que se verifica con los tipos de la cadena de herramientas y los objetivos específicos para ver cuál depurar. Se pueden separar varias regex con comas y, luego, cada una se verifica por separado. Nota: El resultado de esta marca es muy complejo y es probable que solo sea útil para los expertos en la resolución de la cadena de herramientas.
Etiquetas:terminal_output
- Son opciones que especifican o alteran una entrada genérica en un comando de Bazel que no pertenece a otras categorías.:
- Se acumulan varios usos de
--flag_alias=<a 'name=value' flag alias>
-
Establece un nombre abreviado para una marca de Starlark. Toma un solo par clave-valor con el formato "<clave>=<valor>" como argumento.
Etiquetas:changes_inputs
--[no]incompatible_default_to_explicit_init_py
predeterminado: “false”-
Esta marca cambia el comportamiento predeterminado para que los archivos __init__.py ya no se creen automáticamente en los archivos de ejecución de los destinos de Python. Específicamente, cuando un objetivo py_binary o py_test tiene legacy_create_init establecido en "auto" (el valor predeterminado), se considera falso solo si se establece esta marca. Consulta https://github.com/bazelbuild/bazel/issues/10076.
Etiquetas:affects_outputs
,incompatible_change
- 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 incluye el sufijo "-py2", mientras que los destinos compilados para Python 3 aparecerán en una raíz sin sufijo relacionado con Python. Esto significa que el symlink de conveniencia "bazel-bin" apuntará a los 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
,incompatible_change
--[no]incompatible_py3_is_default
predeterminado: "true"-
Si el valor es verdadero, los destinos "py_binary" y "py_test" que no establezcan su atributo "python_version" (o "default_python_version") se establecerá de forma predeterminada en PY3 en lugar de PY2. Si configuras esta marca, también se recomienda establecer `--incompatible_py2_outputs_are_suffixed`.
Etiquetas:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_use_python_toolchains
predeterminado: "true"-
Si se configura como verdadera, las reglas nativas ejecutables de Python usarán el entorno de ejecución de Python especificado por la cadena de herramientas de Python, en lugar del entorno de ejecución proporcionado por marcas heredadas como --python_top.
Etiquetas:loading_and_analysis
,incompatible_change
--python_version=<PY2 or PY3>
predeterminado: Consulta la descripción-
Es el modo de versión principal de Python, ya sea "PY2" o "PY3". Ten en cuenta que esto se anula con los destinos "py_binary" y "py_test" (incluso si no especifican una versión de forma explícita), por lo que, por lo general, no hay muchos motivos para proporcionar esta marca.
Etiquetas:loading_and_analysis
,affects_outputs
- Opciones misceláneas que no se clasificaron de otra manera:
--[no]cache_test_results
[-t
] predeterminado: "auto"- Si se establece en “auto”, Bazel vuelve a ejecutar una prueba solo si se cumplen las siguientes condiciones: (1) Bazel detecta cambios en la prueba o sus dependencias, (2) la prueba está marcada como externa, (3) se solicitaron varias ejecuciones de prueba con --runs_per_test o(4) la prueba falló anteriormente. Si se establece como “sí”, Bazel almacena en caché todos los resultados de las pruebas, excepto las marcadas como externas. Si se establece en "no", Bazel no almacena en caché ningún resultado de la prueba.
--[no]experimental_cancel_concurrent_tests
predeterminado: “false”-
Si esta preferencia se establece como "true", Blaze cancelará las pruebas que se ejecuten de forma simultánea en la primera ejecución correcta. Esto solo es útil en combinación con --runs_per_test_detects_flakes.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_fetch_all_coverage_outputs
predeterminado: “false”-
Si es verdadero, Bazel recupera todo el directorio de datos de cobertura para cada prueba durante una ejecución de cobertura.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_generate_llvm_lcov
predeterminado: “false”-
Si es verdadero, la cobertura de clang generará un informe LCOV.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_j2objc_header_map
predeterminado: "true"- Determina si se debe generar un mapa de encabezados de J2ObjC en paralelo con la transpilación de J2ObjC.
--[no]experimental_j2objc_shorter_header_path
predeterminado: “false”-
Indica si se debe generar con una ruta de encabezado más corta (usa “_ios” en lugar de “_j2objc”).
Etiquetas:affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
predeterminado: "javabuilder"- Habilita classpaths reducidos para compilaciones de Java.
--[no]experimental_limit_android_lint_to_android_constrained_java
predeterminado: “false”-
Limita --experimental_run_android_lint_on_java_rules a bibliotecas compatibles con Android.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]experimental_run_android_lint_on_java_rules
: "falso" -
Determina si se deben validar las fuentes java_*.
Etiquetas:affects_outputs
--[no]explicit_java_test_deps
predeterminado: “false”- Especifica de forma explícita una dependencia a JUnit o Hamcrest en un java_test en lugar de obtenerla accidentalmente de las dependencias de TestRunner. Por el momento, solo funciona para bazel.
--host_java_launcher=<a build target label>
predeterminado: Consulta la descripción- Es el selector de Java que usan las herramientas que se ejecutan durante una compilación.
- Se acumulan varios usos de
--host_javacopt=<a string>
. - Opciones adicionales para pasar a javac cuando se compilan herramientas que se ejecutan durante una compilación.
- Se acumulan
--host_jvmopt=<a string>
usos múltiples - Opciones adicionales para pasar a la VM de Java cuando se compilan herramientas que se ejecutan durante la compilación. Estas opciones se agregarán a las opciones de inicio de la VM de cada destino java_binary.
--[no]incompatible_check_sharding_support
predeterminado: "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 admita la fragmentación hará que todas las pruebas se ejecuten en cada fragmento.
Etiquetas:incompatible_change
--[no]incompatible_exclusive_test_sandboxed
predeterminado: "true"-
Si es verdadero, las pruebas exclusivas se ejecutarán con la estrategia de zona de pruebas. Agrega la etiqueta "local" para forzar que se ejecute una prueba exclusiva de forma local.
Etiquetas:incompatible_change
- 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, de esta manera, se puede evitar la caché entre usuarios si se usa una caché compartida.
Etiquetas:loading_and_analysis
,incompatible_change
- Se acumulan varios usos de
--j2objc_translation_flags=<comma-separated list of options>
. - : Opciones adicionales para pasar a la herramienta J2ObjC.
--java_debug
-
Hace que la máquina virtual Java de una prueba de Java espere una conexión de 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
--[no]java_deps
predeterminado: "true"- Genera información de dependencia (por ahora, el classpath del tiempo de compilación) por destino de Java.
--[no]java_header_compilation
predeterminado: "true"- Compila ijars directamente desde la fuente.
- Valor predeterminado de
--java_language_version=<a string>
: "" - La versión del lenguaje Java
--java_launcher=<a build target label>
predeterminado: Consulta la descripción- Es el selector de Java que se usará cuando se compilen objetos binarios de Java. Si esta marca se establece en la cadena vacía, se usa el selector de JDK. El atributo "launcher" anula esta marca.
--java_runtime_version=<a string>
predeterminado: “local_jdk”- La versión del entorno de ejecución de Java
- Se acumulan varios usos de
--javacopt=<a string>
. - Opciones adicionales para pasar a javac.
- Se acumulan varios usos de
--jvmopt=<a string>
. - Opciones adicionales para pasar a la VM de Java. Estas se agregarán a las opciones de inicio de la VM de cada destino java_binary.
--legacy_main_dex_list_generator=<a build target label>
predeterminado: Consulta la descripción- Especifica un objeto binario que se usará para generar la lista de clases que deben estar en el DEX principal cuando se compila multidex heredado.
--optimizing_dexer=<a build target label>
predeterminado: Consulta la descripción- Especifica un objeto binario para usar y realizar la conversión a Dex sin fragmentación.
- Se acumulan varios usos de
--plugin=<a build target label>
- Complementos para usar en la compilación. Actualmente, funciona con java_plugin.
--proguard_top=<a build target label>
predeterminado: Consulta la descripción- Especifica qué versión de ProGuard se usará para quitar el código cuando se compile un objeto binario de Java.
--proto_compiler=<a build target label>
predeterminado: "@bazel_tools//tools/proto:protoc"-
Es la etiqueta del protocompilador.
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
predeterminado: "@bazel_tools//tools/proto:cc_toolchain"-
Etiqueta de proto_lang_toolchain(), que describe cómo compilar protos de C++
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
predeterminado: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"-
Etiqueta de proto_lang_toolchain() que describe cómo compilar protos j2objc
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
predeterminado: "@bazel_tools//tools/proto:java_toolchain"-
Etiqueta de proto_lang_toolchain() que describe cómo compilar protos de Java
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
predeterminado: "@bazel_tools//tools/proto:javalite_toolchain"-
Etiqueta de proto_lang_toolchain(), que describe cómo compilar protos de JavaLite
Etiquetas:affects_outputs
,loading_and_analysis
- Se acumulan
--protocopt=<a string>
usos múltiples -
Opciones adicionales para pasar al compilador de protobuf.
Etiquetas:affects_outputs
--[no]runs_per_test_detects_flakes
predeterminado: “false”- Si es verdadero, cualquier fragmento en el que se transfiera al menos una ejecución o intento y al menos una ejecución o intento fallido obtendrá el estado FLAKY.
- Valor predeterminado de
--shell_executable=<a path>
: ver descripción -
Es la ruta de acceso absoluta al shell ejecutable para que lo use Bazel. Si no se establece, pero la variable de entorno BAZEL_SH se establece en la primera invocación de Bazel (que inicia un servidor de Bazel), Bazel la usará. Si no se establece ninguno, Bazel usa una ruta de acceso predeterminada fija según el sistema operativo en el que se ejecuta (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, todos los demás: /bin/bash). Ten en cuenta que usar un shell que no sea compatible con bash puede generar fallas de compilación o de tiempo de ejecución de los objetos binarios generados.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--test_arg=<a string>
. - Especifica opciones y argumentos adicionales que se deben pasar al ejecutable de prueba. Se puede usar varias veces para especificar varios argumentos. Si se ejecutan varias pruebas, cada una de ellas recibirá argumentos idénticos. Solo lo usa el comando "bazel test".
- Valor predeterminado de
--test_filter=<a string>
: ver descripción - : Especifica un filtro para reenviar al framework de pruebas. Se usa para limitar las pruebas que se ejecutan. Ten en cuenta que esto no afecta los destinos que se compilan.
- Valor predeterminado de
--test_result_expiration=<an integer>
: "-1" - Esta opción dejó de estar disponible y no tiene efecto.
--[no]test_runner_fail_fast
predeterminado: “false”- Redirecciona la opción de falla rápida al ejecutor de pruebas. El ejecutor de pruebas debe detener la ejecución en la primera falla.
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>
predeterminado: "explicit"- Especifica la estrategia para el fragmentación de prueba: "explicit" para usar solo la fragmentación si está presente el atributo BUILD "shard_count". "disabled" para nunca usar el fragmentación de prueba. "forced=k" para aplicar fragmentos "k" para pruebas, independientemente del atributo BUILD "shard_count".
--tool_java_language_version=<a string>
predeterminado: ""- La versión del lenguaje Java que se usa para ejecutar las herramientas necesarias durante una compilación
--tool_java_runtime_version=<a string>
predeterminado: "remotejdk_11"- La versión del entorno de ejecución de Java que se usa para ejecutar herramientas durante la compilación
--[no]use_ijars
predeterminado: "true"- Si 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.
Build Options
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
-
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto está diseñado para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--experimental_repository_downloader_retries=<an integer>
: "0" -
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Ajusta todos los tiempos de espera en las reglas del repositorio de Starlark con este factor. De esta manera, los repositorios externos pueden funcionar en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--[no]incompatible_disable_native_repo_rules
predeterminado: “false”-
Si es falso, se pueden usar reglas de repositorio nativas en WORKSPACE. De lo contrario, se deben usar reglas de repositorio de Starlark. Las reglas de repositorio nativo incluyen local_repository, new_local_repository, local_config_platform, android_sdk_repository y android_ndk_repository.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación de la caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché. De lo contrario, se usa el valor predeterminado de '<output_user_root>/cache/repos/v1'.
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
predeterminado: “false”-
Si se establece, no se permite la descarga con ctx.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no se inhabilita por completo; ctx.execute aún podría ejecutar un ejecutable arbitrario que acceda a Internet.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de la compilación:
--[no]check_up_to_date
predeterminado: “false”-
No realices la compilación, solo verifica si está actualizada. Si todos los destinos están actualizados, la compilación se completa correctamente. Si se debe ejecutar algún paso, se informa un error y falla la compilación.
Etiquetas:execution
--dynamic_local_execution_delay=<an integer>
predeterminado: “1000”-
¿Cuántos milisegundos se debe retrasar la ejecución local si la ejecución remota fue más rápida durante una compilación al menos una vez?
Etiquetas:execution
,host_machine_resource_optimizations
- Se acumulan
--dynamic_local_strategy=<a '[name=]value1[,..,valueN]' assignment>
usos múltiples -
Las estrategias locales, en orden, que se usarán para la mnemotecnia determinada (se usa la primera estrategia aplicable). Por ejemplo, `worker,sandboxed` ejecuta acciones que admiten trabajadores persistentes usando la estrategia de trabajadores, y todas las demás acciones usando la estrategia de zona de pruebas. Si no se proporciona ninguna mnemotecnia, la lista de estrategias se usa como resguardo para todas las mnemotecnias. La lista de resguardo predeterminada es "worker,sandboxed" o "worker,sandboxed,standalone" si se establece "experimental_local_lockfree_output". Toma [mnemonic=]local_strategy[,local_strategy,…]
Etiquetas:execution
,host_machine_resource_optimizations
- Se acumulan varios usos de
--dynamic_remote_strategy=<a '[name=]value1[,..,valueN]' assignment>
-
Las estrategias remotas, en orden, para usar en la mnemotecnia determinada (se usa la primera estrategia aplicable). Si no se proporciona 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, por lo general, no es necesario configurar esta marca de forma explícita. Toma [mnemonic=]remote_strategy[,remote_strategy,...]
Etiquetas:execution
,host_machine_resource_optimizations
--experimental_docker_image=<a string>
predeterminado: ""-
Especifica un nombre de imagen de Docker (p.ej., “ubuntu:latest”) que se debe usar para ejecutar una acción 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 de forma literal a "docker run", por lo que admite la misma sintaxis y los mismos mecanismos que Docker.
Etiquetas:execution
--[no]experimental_docker_use_customized_images
predeterminado: "true"-
Si está habilitada, inserta el UID y el GID del usuario actual en la imagen de Docker antes de usarla. Esto es obligatorio si tu compilación o pruebas dependen de que el usuario tenga un nombre y un directorio principal dentro del contenedor. Esta opción está activada de forma predeterminada, pero puedes inhabilitarla en caso de que la función de personalización automática de imágenes no funcione en tu caso o sepas que no la necesitas.
Etiquetas:execution
--[no]experimental_dynamic_exclude_tools
predeterminado: "true"-
Cuando se configuran, los destinos que se compilan "para la herramienta" no están sujetos a la ejecución dinámica. Es muy poco probable que estos objetivos se compilen de forma incremental y, por lo tanto, no vale la pena invertir ciclos locales en ellos.
Etiquetas:execution
,host_machine_resource_optimizations
--experimental_dynamic_local_load_factor=<a double>
predeterminado: “0”- Controla la cantidad de carga de la ejecución dinámica que se colocará en la máquina local. Esta marca ajusta la cantidad de acciones de la ejecución dinámica que programaremos de forma simultánea. Se basa en la cantidad de CPUs que Blaze considera que están disponibles, que se puede controlar con la marca --local_cpu_resources.
Si esta marca es 0, todas las acciones se programan de forma local de inmediato. Si es mayor que 0, la cantidad de acciones programadas de forma local se limita por la cantidad de CPUs disponibles. Si es menor que 1, el factor de carga se usa para reducir la cantidad de acciones programadas de forma local cuando la cantidad de acciones que esperan programación es alta. Esto reduce la carga en la máquina local en el caso de la compilación limpia, en el que la máquina local no contribuye mucho.
Etiquetas:execution
,host_machine_resource_optimizations
--experimental_dynamic_slow_remote_time=<An immutable length of time.>
predeterminado: “0”-
Si es mayor que 0, es el tiempo que una acción que se ejecuta de forma dinámica debe ejecutarse solo de forma remota antes de que prioricemos su ejecución local para evitar tiempos de espera remotos. Esto puede ocultar algunos problemas en el sistema de ejecución remota. No actives esta función sin supervisar los problemas de ejecución remota.
Etiquetas:execution
,host_machine_resource_optimizations
--[no]experimental_enable_docker_sandbox
predeterminado: “false”-
Habilita la zona de pruebas basada en Docker. Esta opción no tiene efecto si Docker no está instalado.
Etiquetas:execution
--[no]experimental_inmemory_sandbox_stashes
predeterminado: “false”-
Si se establece como verdadero, se realizará un seguimiento del contenido de las zonas de pruebas almacenadas para reuse_sandbox_directories en la memoria. Esto reduce la cantidad de E/S necesaria durante la reutilización. Según la compilación, esta marca puede mejorar el tiempo de ejecución. Según la compilación, esta marca puede usar una cantidad significativa de memoria adicional.
Etiquetas:host_machine_resource_optimizations
,execution
--experimental_sandbox_async_tree_delete_idle_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
predeterminado: “4”-
Si es 0, borra los árboles de zona de pruebas en cuanto se completa una acción (lo que retrasa la finalización de la acción). Si es mayor que cero, ejecuta la eliminación de esos tres en un grupo de subprocesos asíncrono que tenga el tamaño 1 cuando se ejecute la compilación y que crezca hasta el tamaño especificado por esta marca cuando el servidor esté inactivo.
Etiquetas:host_machine_resource_optimizations
,execution
- Valor predeterminado de
--experimental_sandbox_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
: "0" -
Si es mayor que 0, cada zona de pruebas de Linux se limitará a la cantidad de memoria determinada (en MB). Requiere cgroups v1 o v2 y permisos para que los usuarios accedan a la carpeta de cgroups.
Etiquetas:execution
--[no]experimental_shrink_worker_pool
predeterminado: “false”-
Si está habilitado, podría reducir el grupo de trabajadores si la presión de memoria del trabajador es alta. Esta marca solo funciona cuando está habilitada la marca experimental_total_worker_memory_limit_mb.
Etiquetas:execution
,host_machine_resource_optimizations
--[no]experimental_split_xml_generation
predeterminado: "true"-
Si se establece esta marca y una acción de prueba no genera un archivo test.xml, Bazel usa una acción independiente para generar un archivo test.xml ficticio que contiene el registro de prueba. De lo contrario, Bazel genera un test.xml como parte de la acción de prueba.
Etiquetas:execution
--experimental_total_worker_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
predeterminado: “0”-
Si este límite es mayor que cero, es posible que se eliminen los trabajadores inactivos si el uso total de memoria de todos los trabajadores supera el límite.
Etiquetas:execution
,host_machine_resource_optimizations
- Valor predeterminado de
--[no]experimental_use_hermetic_linux_sandbox
: "falso" -
Si se configura como verdadero, no actives la raíz, solo activa lo que se proporciona con sandbox_add_mount_pair. Los archivos de entrada tendrán un vínculo duro a la zona de pruebas en lugar de un vínculo simbólico desde la zona de pruebas. Si los archivos de entrada de la acción se encuentran en un sistema de archivos diferente al de la zona de pruebas, se copiarán los archivos de entrada.
Etiquetas:execution
--[no]experimental_use_semaphore_for_jobs
predeterminado: "true"-
Si se establece en verdadero, además, usa un semáforo para limitar la cantidad de trabajos simultáneos.
Etiquetas:host_machine_resource_optimizations
,execution
--[no]experimental_use_windows_sandbox
predeterminado: “false”-
Usa la zona de pruebas de Windows para ejecutar acciones. Si es "sí", el binario que proporciona --experimental_windows_sandbox_path debe ser válido y debe corresponder a una versión compatible de sandboxfs. Si es "auto", es posible que falte el objeto binario o que no sea compatible.
Etiquetas:execution
--experimental_windows_sandbox_path=<a string>
predeterminado: "BazelSandbox.exe"-
Es la ruta de acceso al objeto binario de la zona de pruebas de Windows que se usará cuando --experimental_use_windows_sandbox sea verdadero. Si es un nombre sin formato, usa el primer objeto binario de ese nombre que se encuentre en la PATH.
Etiquetas:execution
- 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 determinada.
Etiquetas:execution
,host_machine_resource_optimizations
--[no]experimental_worker_as_resource
predeterminado: "true"-
No-ops; se quitará pronto.
Etiquetas:no_op
--[no]experimental_worker_cancellation
predeterminado: “false”-
Si está habilitado, Bazel puede enviar solicitudes de cancelación a los trabajadores que las admiten.
Etiquetas:execution
--experimental_worker_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
predeterminado: “0”-
Si este límite es mayor que cero, es posible que se cancelen los trabajadores si el uso de memoria del trabajador supera el límite. Si no se usa junto con la ejecución dinámica y `--experimental_dynamic_ignore_local_signals=9`, es posible que tu compilación falle.
Etiquetas:execution
,host_machine_resource_optimizations
- Valor predeterminado de
--experimental_worker_metrics_poll_interval=<An immutable length of time.>
: "5 s" -
Es el intervalo entre la recopilación de métricas de los trabajadores y, posiblemente, el intento de desalojos. Por motivos de rendimiento, no puede ser inferior a 1 s.
Etiquetas:execution
,host_machine_resource_optimizations
--[no]experimental_worker_multiplex_sandboxing
predeterminado: “false”-
Si se habilita, los trabajadores de multiplexación se colocarán en la zona de pruebas, con un directorio de zona de pruebas independiente por solicitud de trabajo. Solo se incluirán en la zona de pruebas los trabajadores que tengan el requisito de ejecución "supports-multiplex-sandboxing".
Etiquetas:execution
--[no]experimental_worker_sandbox_hardening
predeterminado: “false”-
Si está habilitada, los trabajadores se ejecutan en una zona de pruebas endurecida, si la implementación lo permite.
Etiquetas:execution
--[no]experimental_worker_strict_flagfiles
predeterminado: “false”-
Si está habilitado, los argumentos de acciones para los trabajadores que no siguen la especificación del trabajador generarán un error. Los argumentos del trabajador deben tener exactamente un argumento @flagfile como el último de su lista de argumentos.
Etiquetas:execution
- Valor predeterminado de
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Es el porcentaje de espacio ocupado (de 0 a 100) por encima del cual GcThrashingDetector considera los eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, se inhabilita GcThrashingDetector.
Etiquetas:host_machine_resource_optimizations
--genrule_strategy=<comma-separated list of options>
predeterminado: ""-
Especifica cómo ejecutar genrules. Esta marca se eliminará gradualmente. En su lugar, usa --spawn_strategy=<value> para controlar todas las acciones o --strategy=Genrule=<value> para controlar solo las genrules.
Etiquetas:execution
- Se acumulan varios usos de
--high_priority_workers=<a string>
-
No-ops; se quitará pronto.
Etiquetas:execution
- Valor predeterminado de
--[no]incompatible_remote_dangling_symlinks
: "true" -
Si se configura como verdadera, los symlinks subidos a una caché remota o de disco pueden colgar.
Etiquetas:execution
,incompatible_change
- Valor predeterminado de
--[no]incompatible_remote_symlinks
: "true" -
Si se establece como verdadero, Bazel siempre subirá los symlinks como tales a una caché remota o en el disco. De lo contrario, los symlinks relativos no colgantes (y solo esos) se subirán como el archivo o directorio al que apuntan.
Etiquetas:execution
,incompatible_change
--[no]incompatible_sandbox_hermetic_tmp
predeterminado: "true"-
Si se establece como verdadero, cada zona de pruebas de Linux tendrá su propio directorio vacío dedicado activado como /tmp en lugar de compartir /tmp con el sistema de archivos del host. Usa --sandbox_add_mount_pair=/tmp para seguir viendo el /tmp del host en todas las zonas de pruebas.
Etiquetas:execution
- Valor predeterminado de
--[no]internal_spawn_scheduler
: "falso" -
Opción de marcador de posición para que podamos indicar en Blaze si se habilitó el programador de creación.
Etiquetas:execution
,host_machine_resource_optimizations
--jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
[-j
] predeterminado: "auto"-
La cantidad de trabajos simultáneos que se ejecutarán. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5" Los valores deben estar entre 1 y 5,000. Los valores superiores a 2,500 pueden causar problemas de memoria. "auto" calcula un valor predeterminado razonable según los recursos del host.
Etiquetas:host_machine_resource_optimizations
,execution
--[no]keep_going
[-k
] predeterminado: "false"-
Continúa tanto como sea posible después de un error. Si bien 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: “auto”-
Cantidad de subprocesos en paralelo que se usarán para la fase de carga o análisis. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". “auto” establece un valor predeterminado razonable según los recursos del host. Debe ser 1 como mínimo.
Etiquetas:bazel_internal_configuration
--[no]reuse_sandbox_directories
predeterminado: "true"-
Si se establece como verdadera, es posible que se reutilicen los directorios que usa la ejecución de la zona de pruebas que no son trabajadores para evitar costos de configuración innecesarios.
Etiquetas:host_machine_resource_optimizations
,execution
- Valor predeterminado de
--sandbox_base=<a string>
: "" -
Permite que la zona de pruebas cree sus directorios en esta ruta. Especifica una ruta de acceso en tmpfs (como /run/shm) para mejorar mucho el rendimiento cuando tu compilación o pruebas tengan muchos archivos de entrada. Nota: Necesitas suficiente RAM y espacio libre en el tmpfs para contener los archivos de salida y los archivos intermedios que generan las acciones de ejecución.
Etiquetas:host_machine_resource_optimizations
,execution
--[no]sandbox_explicit_pseudoterminal
predeterminado: “false”-
Habilita de forma explícita la creación de pseudoterminales para acciones en zona de pruebas. Algunas distribuciones de Linux requieren que se configure el ID de grupo del proceso en "tty" dentro de la zona de pruebas para que funcionen los pseudoterminales. Si esto causa problemas, se puede inhabilitar esta marca para permitir el uso de otros grupos.
Etiquetas:execution
- Se acumulan varios usos de
--sandbox_tmpfs_path=<an absolute path>
. -
Para las acciones en zona de pruebas, activa un directorio vacío y con permisos de escritura en esta ruta de acceso absoluta (si la implementación de la zona de pruebas lo admite, se ignora de lo contrario).
Etiquetas:host_machine_resource_optimizations
,execution
--[no]skip_incompatible_explicit_targets
predeterminado: “false”-
Omite los destinos incompatibles que se enumeran de forma explícita en la línea de comandos. De forma predeterminada, la compilación de esos destinos genera un error, pero se omiten de forma silenciosa cuando se habilita esta opción. Consulta: https://bazel.build/extending/platforms#skipping-incompatible-targets
Etiquetas:loading_and_analysis
- Valor predeterminado de
--spawn_strategy=<comma-separated list of options>
: "" -
Especifica cómo se ejecutan las acciones de creación de forma predeterminada. Acepta una lista de estrategias separadas por comas de mayor a menor prioridad. Para cada acción, Bazel elige la estrategia con la prioridad más alta que puede ejecutar la acción. El valor predeterminado es “remote,worker,sandboxed,local”. Consulta https://blog.bazel.build/2019/06/19/list-strategy.html para obtener más información.
Etiquetas:execution
- Se acumulan varios usos de
--strategy=<a '[name=]value1[,..,valueN]' assignment>
. -
Especifica cómo distribuir la compilación de otras acciones de 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 mnemónico). Consulta https://blog.bazel.build/2019/06/19/list-strategy.html para obtener más información.
Etiquetas:execution
- Se acumulan varios usos de
--strategy_regexp=<a '<RegexFilter>=value[,value]' assignment>
-
Anula qué estrategia de creación se debe usar para ejecutar acciones de creación que tengan descripciones que coincidan con un cierto regex_filter. Consulta --per_file_copt para obtener detalles sobre la coincidencia de regex_filter. Se usa el último regex_filter que coincida con la descripción. Esta opción anula otras marcas para especificar la estrategia. Ejemplo: --strategy_regexp=//foo.*\.cc,-//foo/bar=local significa ejecutar acciones con la estrategia local si sus descripciones coinciden con //foo.*.cc, pero no con //foo/bar. Ejemplo: --strategy_regexp='Compiling.*/bar=local --strategy_regexp=Compiling=sandboxed ejecutará "Compiling //foo/bar/baz" con la estrategia "local", pero si se invierte el orden, se ejecutará con "sandboxed".
Etiquetas:execution
- Se acumulan varios usos de
--worker_extra_flag=<a 'name=value' assignment>
-
Son marcas de comando adicionales que se pasarán a los procesos de trabajo, además de --persistent_worker, con clave mnemónica (p.ej., --worker_extra_flag=Javac=--debug.
Etiquetas:execution
,host_machine_resource_optimizations
- Se acumulan varios usos de
--worker_max_instances=<[name=]value, where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
. -
Cuántas instancias de cada tipo de trabajador persistente se pueden iniciar si usas la estrategia “trabajador”. Se puede especificar como [name=value] para dar un valor diferente por nombre mnemotécnico. El límite se basa en las claves de trabajador, que se diferencian según el mnemónico, pero también según las marcas de inicio y el entorno, por lo que, en algunos casos, puede haber más trabajadores por mnemónico de los que especifica esta marca. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". "auto" calcula un valor predeterminado razonable en función de la capacidad de la máquina. “=value” establece un valor predeterminado para mnemotecnias no especificadas.
Etiquetas:execution
,host_machine_resource_optimizations
- Se acumulan varios usos de
--worker_max_multiplex_instances=<[name=]value, where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
-
Cuántas WorkRequests puede recibir en paralelo un proceso de trabajador multiplexado si usas la estrategia "worker" con --worker_multiplex. Se puede especificar como [name=value] para dar un valor diferente por mnemotecnia. El límite se basa en las claves de trabajador, que se diferencian según el mnemónico, pero también según las marcas de inicio y el entorno, por lo que, en algunos casos, puede haber más trabajadores por mnemónico de los que especifica esta marca. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". "auto" calcula un valor predeterminado razonable en función de la capacidad de la máquina. “=value” establece un valor predeterminado para mnemotecnias no especificadas.
Etiquetas:execution
,host_machine_resource_optimizations
- Valor predeterminado de
--[no]worker_multiplex
: "true" -
Si está habilitada, los trabajadores usarán la multiplexación si la admiten.
Etiquetas:execution
,host_machine_resource_optimizations
--[no]worker_quit_after_build
predeterminado: “false”-
Si se habilita, todos los trabajadores se quitan después de que se completa una compilación.
Etiquetas:execution
,host_machine_resource_optimizations
--[no]worker_sandboxing
predeterminado: “false”-
Si se habilita, los trabajadores se ejecutarán en un entorno de zona de pruebas.
Etiquetas:execution
--[no]worker_verbose
predeterminado: “false”- Si se habilita, imprime mensajes detallados cuando se inician los trabajadores, se apagan, ...
- 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 está obsoleta y no tiene ningún efecto.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
- Opciones que controlan el resultado del comando:
--[no]build
predeterminado: "true"-
Ejecuta la compilación. Este es el comportamiento habitual. Especificar --nobuild hace que la compilación se detenga antes de ejecutar las acciones de compilación y devuelva cero si las fases de carga y análisis del paquete se completaron correctamente. Este modo es útil para probar esas fases.
Etiquetas:execution
,affects_outputs
--[no]experimental_use_validation_aspect
predeterminado: “false”-
Indica si se deben ejecutar acciones de validación con el aspecto (para el paralelismo con las pruebas).
Etiquetas:execution
,affects_outputs
- Se acumulan varios usos de
--output_groups=<comma-separated list of options>
-
Es una lista de nombres de grupos de salida separados por comas, cada uno de los cuales puede tener un prefijo de + o -. Un grupo con el prefijo + se agrega al conjunto predeterminado de grupos de salida, mientras que un grupo con el prefijo - se quita del conjunto predeterminado. Si no se agrega un prefijo a, al menos, un grupo, se omite el conjunto predeterminado de grupos de salida. Por ejemplo, --output_groups=+foo,+bar compila la unión del conjunto predeterminado, foo y bar, mientras que --output_groups=foo,bar anula el conjunto predeterminado de modo que solo se compilen foo y bar.
Etiquetas:execution
,affects_outputs
--[no]run_validations
predeterminado: "true"-
Indica si se deben ejecutar acciones de validación como parte de la compilación. Consulta https://bazel.build/extending/rules#validation_actions
Etiquetas:execution
,affects_outputs
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
- Se acumulan varios usos de
--aspects=<comma-separated list of options>
. - Es una lista de aspectos separados por comas que se aplicarán a los objetivos de nivel superior. En la lista, si el aspecto some_aspect especifica 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 sus aspectos obligatorios especificados por el atributo requires. Luego, some_aspect tendrá acceso a los valores de los proveedores de esos aspectos. <bzl-file-label>%<aspect_name>, por ejemplo, '//tools:my_def.bzl%my_aspect', donde "my_aspect" es un valor de nivel superior de un archivo tools/my_def.bzl
--bep_maximum_open_remote_upload_files=<an integer>
predeterminado: “-1”-
Cantidad máxima de archivos abiertos permitidos durante la carga del artefacto de BEP.
Etiquetas:affects_outputs
--[no]experimental_convenience_symlinks
predeterminado: "normal"-
Esta marca controla cómo se administrarán los symlinks de conveniencia (los symlinks que aparecen en el lugar de trabajo después de la compilación). Valores posibles:
normal (predeterminado): Se creará o borrará cada tipo de symlink de conveniencia, según lo determine la compilación.
clean: Se borrarán todos los symlinks sin condiciones.
Ignorar: Los vínculos simbólicos se dejarán solos.
log_only: Genera mensajes de registro como si se pasara "normal", pero no realiza ninguna operación del sistema de archivos (útil para herramientas).
Ten en cuenta que solo se pueden ver afectados los symlinks cuyos nombres genera el valor actual de --symlink_prefix. Si cambia el prefijo, no se modificarán los symlinks preexistentes.
Etiquetas:affects_outputs
--[no]experimental_convenience_symlinks_bep_event
predeterminado: “false”-
Esta marca controla si se publicará o no el eventConvenienceSymlinksIdentified de BuildEventProtocol. Si el valor es verdadero, BuildEventProtocol tendrá una entrada para convenienceSymlinksIdentified, en la que se enumerarán todos los symlinks de conveniencia creados en tu lugar de trabajo. Si es falso, la entrada convenienceSymlinksIdentified en BuildEventProtocol estará vacía.
Etiquetas:affects_outputs
--remote_download_all
-
Descarga todas las salidas remotas en la máquina local. Esta marca es un alias para --remote_download_outputs=all.
Se expande a:
--remote_download_outputs=all
Etiquetas:affects_outputs
--remote_download_minimal
-
No descarga ningún resultado de compilación remota a 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: "toplevel"-
Si se configura como “mínimo”, no se descargarán resultados de compilación remota en la máquina local, excepto los que requieren las acciones locales. Si se establece en "toplevel", se comporta como "minimal", excepto que también descarga los resultados de los destinos de nivel superior en la máquina local. Ambas opciones pueden reducir de manera significativa los tiempos de compilación si el ancho de banda de la red es un cuello de botella.
Etiquetas:affects_outputs
--remote_download_symlink_template=<a string>
predeterminado: ""-
En lugar de descargar resultados de compilación remotos en la máquina local, crea vínculos simbólicos. El 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 cargue objetos del CAS a pedido.
Etiquetas:affects_outputs
--remote_download_toplevel
-
Solo descarga las salidas remotas de objetivos de nivel superior en la máquina local. Esta marca es un alias para --remote_download_outputs=toplevel.
Se expande a:
--remote_download_outputs=toplevel
Etiquetas:affects_outputs
- Valor predeterminado de
--symlink_prefix=<a string>
: ver descripción -
Es el prefijo que se agrega a cualquiera de los symlinks de conveniencia que se crean después de una compilación. Si se omite, el valor predeterminado es el nombre de la herramienta de compilación seguido de un guion. Si se pasa “/”, no se crean symlinks ni se emite ninguna advertencia. Advertencia: La funcionalidad especial para "/" pronto dejará de estar disponible. En su lugar, usa --experimental_convenience_symlinks=ignore.
Etiquetas:affects_outputs
- Opciones que afectan la exactitud con la que Bazel aplica de manera forzosa las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
--[no]experimental_docker_privileged
predeterminado: “false”-
Si está habilitada, Bazel pasará la marca --privileged a "docker run" cuando ejecute acciones. Es posible que tu compilación lo requiera, pero también podría reducir la hermeticidad.
Etiquetas:execution
--[no]experimental_sandboxfs_map_symlink_targets
predeterminado: “false”-
Etiquetas
sin operación:host_machine_resource_optimizations
,execution
--[no]incompatible_legacy_local_fallback
predeterminado: “false”-
Si se establece como verdadero, habilita el resguardo implícito heredado de la estrategia de zona de pruebas a la estrategia local. 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 los resguardos.
Etiquetas:execution
,incompatible_change
- Se acumulan varios usos de
--sandbox_add_mount_pair=<a single path or a 'source:target' pair>
-
Agrega un par de rutas de acceso adicionales para activar en la zona de pruebas.
Etiquetas:execution
- Se acumulan varios usos de
--sandbox_block_path=<a string>
-
Para las acciones en zona de pruebas, no permitas el acceso a esta ruta.
Etiquetas:execution
--[no]sandbox_default_allow_network
predeterminado: "true"-
Permite el acceso a la red de forma predeterminada para las acciones. Es posible que esto no funcione con todas las implementaciones de zona de pruebas.
Etiquetas:execution
--[no]sandbox_fake_hostname
predeterminado: “false”-
Cambia el nombre de host actual a “localhost” para las acciones de la zona de pruebas.
Etiquetas:execution
--[no]sandbox_fake_username
predeterminado: “false”-
Cambia el nombre de usuario actual a "nadie" para las acciones en la zona de pruebas.
Etiquetas:execution
- Se acumulan
--sandbox_writable_path=<a string>
usos múltiples -
Para las acciones en la zona de pruebas, crea un directorio existente en el que se pueda escribir en la zona de pruebas (si la implementación de la zona de pruebas lo admite, se ignora de lo contrario).
Etiquetas:execution
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.:
- Valor predeterminado de
--[no]incompatible_config_setting_private_default_visibility
: "falso" -
Si incompatible_enforce_config_setting_visibility=false, esto es una operación no realizada. De lo contrario, si esta marca es falsa, cualquier config_setting sin un atributo de visibilidad explícito es //visibility:public. Si esta marca es verdadera, config_setting sigue la misma lógica de visibilidad que todas las demás reglas. Consulta https://github.com/bazelbuild/bazel/issues/12933.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
predeterminado: "true"-
Si es verdadero, aplica las restricciones de visibilidad config_setting. Si es falso, todos los config_setting son visibles para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones que rigen el comportamiento del entorno de prueba o del ejecutor de pruebas:
- Valor predeterminado de
--[no]check_tests_up_to_date
: "falso" -
No ejecutes pruebas, solo verifica si están actualizadas. Si todos los resultados de las pruebas están actualizados, estas se completarán de forma correcta. Si se debe compilar o ejecutar alguna prueba, se informa un error y la prueba falla. Esta opción implica el comportamiento de --check_up_to_date.
Etiquetas:execution
- Se acumulan varios usos de
--flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once>
-
En caso de que se produzca un error, se volverá a intentar cada prueba hasta la cantidad especificada de veces. Las pruebas que requirieron más de un intento para aprobar se marcan como "FLAKY" en el resumen de la prueba. Por lo general, el valor especificado es solo un número entero o la cadena "default". Si es un número entero, todas las pruebas se ejecutarán hasta N veces. Si es "default", solo se realizará un intento de prueba para las pruebas normales y tres para las pruebas marcadas explícitamente como inestables por su regla (atributo flaky=1). Sintaxis alternativa: regex_filter@flaky_test_attempts. En el que flaky_test_attempts es como se indicó anteriormente y regex_filter representa una lista de patrones de expresiones regulares para incluir y excluir (consulta también --runs_per_test). Ejemplo: --flaky_test_attempts=//foo/.*,-//foo/bar/.*@3 corrige todas las pruebas en //foo/, excepto las de foo/bar, tres veces. Esta opción se puede aprobar varias veces. El argumento que se pasó más recientemente y que coincida tiene prioridad. Si no hay coincidencias, el comportamiento es como el de "default" anterior.
Etiquetas:execution
--local_test_jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
predeterminado: "automático"-
La cantidad máxima de trabajos de prueba locales que se ejecutarán de forma simultánea. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5" 0 significa que los recursos locales limitarán la cantidad de trabajos de prueba locales que se ejecutarán de forma simultánea. Establecer este valor por encima del valor de --jobs no es eficaz.
Etiquetas:execution
--[no]test_keep_going
predeterminado: "true"-
Cuando se inhabilita, cualquier prueba que no se apruebe hará que se detenga toda la compilación. De forma predeterminada, se ejecutan todas las pruebas, incluso si algunas no se aprueban.
Etiquetas:execution
- Valor predeterminado de
--test_strategy=<a string>
: "" -
Especifica qué estrategia usar cuando se ejecutan pruebas.
Etiquetas:execution
--test_tmpdir=<a path>
predeterminado: Consulta la descripción- Especifica el directorio temporal base que usará "bazel test".
- Opciones relacionadas con el resultado de la consulta y la semántica:
--[no]experimental_parallel_aquery_output
predeterminado: "true"- Sin operación.
- Opciones relacionadas con la salida y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
-
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitados en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: “error”-
Comprueba la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "advertencia" -
Verifica si las dependencias directas de "bazel_dep" declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivarla a 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 dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--lockfile_mode=<off, update, refresh or error>
: "actualizar" - especifica cómo usar el archivo de bloqueo y si se debe usar o no. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "refresh" para actualizar periódicamente la información mutable (versiones quitadas y módulos que faltaban anteriormente) de los registros remotos, "error" para usar el archivo de bloqueo, pero mostrar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
- Anula un módulo con una ruta de acceso local con el formato <module name>=<path>. Si la ruta proporcionada es una ruta de acceso absoluta, se usará como es. Si la ruta proporcionada es una ruta de acceso 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 del "espacio de trabajo de información de bazel". Si la ruta dada está vacía, quita las anulaciones anteriores.
- Se acumulan varios usos de
--registry=<a string>
-
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en registros anteriores y solo se recurrirán a los registros posteriores cuando no estén en los registros anteriores.
Etiquetas:changes_inputs
--vendor_dir=<a path>
predeterminado: Consulta la descripción-
Especifica el directorio que debe contener los repositorios externos en modo de proveedor, ya sea para recuperarlos o usarlos durante la compilación. La ruta de acceso se puede especificar como una ruta absoluta o una ruta relativa al directorio del espacio de trabajo.
Etiquetas:loading_and_analysis
- Opciones que activan optimizaciones del tiempo de compilación:
--cache_computed_file_digests=<a long integer>
predeterminado: “50000”- Si 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. Si estableces este valor en 0, se garantiza la exactitud, ya que no todos los cambios de archivo se pueden observar en los metadatos. 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é.
--experimental_dynamic_ignore_local_signals=<a comma-separated list of signal numbers>
predeterminado: Consulta la descripción- Toma una lista de los números de las señales del SO. Si se cancela una rama local de ejecución dinámica con cualquiera de estos indicadores, la rama remota podrá finalizar. En el caso de los trabajadores persistentes, esto solo afecta a los indicadores que cancelan el proceso del trabajador.
Etiquetas:execution
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
predeterminado: "1s:2,20s:3,1m:5"-
Límites que, si se alcanzan, hacen que GcThrashingDetector falle con Bazel con una OOM. Cada límite se especifica como <period>:<count>, donde el período es una duración y el conteo es un número entero positivo. Si más del porcentaje --gc_thrashing_threshold del espacio a perpetuidad (heap de generación anterior) permanece ocupado después de <count> GC completas consecutivas en <period>, se activa un error de OOM. 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 los destine a las acciones de compilación que se ejecutan 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 varios usos de
--local_extra_resources=<a named float, 'name=value'>
-
Establece la cantidad de recursos adicionales disponibles para Bazel. Recibe un par de cadena-número de punto flotante. Se puede usar varias veces para especificar varios tipos de recursos adicionales. Bazel limitará las acciones que se ejecutan de forma simultánea según los recursos adicionales disponibles y los recursos adicionales necesarios. Las pruebas pueden declarar la cantidad de recursos adicionales que necesitan con una etiqueta del formato "resources:<nombre_recurso>:<cantidad>". No se pueden establecer la CPU, la RAM ni los recursos disponibles con esta marca.
Etiquetas:host_machine_resource_optimizations
--local_ram_resources=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
predeterminado: "HOST_RAM*.67"-
Establece de forma explícita la cantidad total de RAM del host local (en MB) disponible para que Bazel la invierta en acciones de compilación que se ejecuten de forma local. Toma un número entero o "HOST_RAM", seguido de forma opcional por [-|*]<número de punto flotante> (p. ej., HOST_RAM*.5 para usar la mitad de la RAM disponible). De forma predeterminada ("HOST_RAM*.67"), Bazel consultará la configuración del sistema para estimar la cantidad de RAM disponible y usará el 67%.
Etiquetas:host_machine_resource_optimizations
- Se acumulan varios usos de
--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">
-
Establece la cantidad de recursos disponibles para Bazel. Recibe una asignación a un número de punto flotante o HOST_RAM/HOST_CPUS, de forma opcional, seguida de [-|*]<número de punto flotante> (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 de forma simultánea según los recursos disponibles y los necesarios. Las pruebas pueden declarar la cantidad de recursos que necesitan con una etiqueta del formato "resources:<resource name>:<amount>". Anula los recursos especificados por --local_{cpu|ram|extra}_resources.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC completo, se descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE, es decir, ilimitado. Cero significa que los eventos de GC completos nunca activarán las bajadas. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC completo y se supere ese umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produce un evento de GC menor, descartará el estado temporal innecesario de Skyframe hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC menores nunca activarán las bajadas. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC menor y se supere ese umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es de al menos este límite, descartará el estado temporal innecesario de Skyframe. Si ajustas este parámetro, es posible que puedas mitigar el impacto del tiempo de ejecución de la fragmentación de GC, cuando esta se produce (i) por el uso de memoria de este estado temporal y (ii) es más costoso que reconstituir el estado cuando sea necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]debug_spawn_scheduler
predeterminado: “false”--[no]experimental_bep_target_summary
predeterminado: “false”- Determina si se deben publicar eventos TargetSummary.
--[no]experimental_build_event_expand_filesets
predeterminado: “false”-
Si es verdadero, expande los conjuntos de archivos en BEP cuando presentes los archivos de salida.
Etiquetas:affects_outputs
--[no]experimental_build_event_fully_resolve_fileset_symlinks
predeterminado: “false”-
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
--experimental_build_event_upload_max_retries=<an integer>
predeterminado: “4”-
Es la cantidad máxima de veces que Bazel debe volver a intentar subir un evento de compilación.
Etiquetas:bazel_internal_configuration
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
predeterminado: "1s"-
Retraso mínimo inicial de los reintentos de retirada exponencial cuando falla la carga de BEP. (exponente: 1.6)
Etiquetas:bazel_internal_configuration
--experimental_build_event_upload_strategy=<a string>
predeterminado: Consulta la descripción-
Selecciona cómo subir los artefactos a los que se hace referencia en el protocolo del evento de compilación.
Etiquetas:affects_outputs
--[no]experimental_collect_local_sandbox_action_metrics
predeterminado: "true"-
No-op obsoleto.
Etiquetas:execution
--experimental_command_profile=<cpu, wall, alloc or lock>
predeterminado: Consulta la descripción- Graba un perfil de Java Flight Recorder durante el tiempo que se ejecuta 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 que lleva el nombre del tipo de evento en el directorio de base de salida. La sintaxis y la semántica de esta marca pueden cambiar en el futuro para admitir tipos de perfiles o formatos de salida adicionales. Úsala bajo tu propio riesgo.
--[no]experimental_docker_verbose
predeterminado: “false”-
Si se habilita, Bazel imprimirá mensajes más detallados sobre la estrategia de zona de pruebas de Docker.
Etiquetas:execution
- 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
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
--experimental_repository_resolved_file=<a string>
predeterminado: ""-
Si no está vacío, escribe un valor de Starlark con la información resuelta de todas las reglas del repositorio de Starlark que se ejecutaron.
Etiquetas:affects_outputs
--[no]experimental_run_bep_event_include_residue
predeterminado: “false”-
Indica si se debe incluir el residuo de la línea de comandos en los eventos de compilación de ejecución que podrían contener el residuo. De forma predeterminada, el residuo no se incluye en los eventos de compilación del comando de ejecución que podrían contenerlo.
Etiquetas:affects_outputs
--[no]experimental_stream_log_file_uploads
predeterminado: “false”-
El archivo de registro de transmisión se sube directamente al almacenamiento remoto en lugar de escribirlo en el disco.
Etiquetas:affects_outputs
--explain=<a path>
predeterminado: Consulta la descripción-
Hace que el sistema de compilación explique cada paso ejecutado de la compilación. La explicación se escribe en el archivo de registro especificado.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]ignore_unsupported_sandboxing
: "falso" -
No imprimas una advertencia cuando la ejecución en zona de pruebas no sea compatible con este sistema.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]legacy_important_outputs
: "true" -
Usa esto para suprimir la generación del campo important_outputs heredado en el evento TargetComplete. important_outputs es obligatorio para la integración de Bazel en ResultStore.
Etiquetas:affects_outputs
- 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 acciones remotas. Es útil cuando se depuran acciones. Esto se infiere de --subcommands y --verbose_failures.
Etiquetas:execution
--max_config_changes_to_show=<an integer>
predeterminado: “3”-
Cuando se descarta la caché de análisis debido a un cambio en las opciones de compilación, se muestra hasta la cantidad determinada de nombres de opciones modificados. Si el número proporcionado es -1, se mostrarán todas las opciones modificadas.
Etiquetas:terminal_output
--max_test_output_bytes=<an integer>
predeterminado: “-1”-
Especifica el tamaño máximo de registro por prueba que se puede emitir cuando --test_output es "errors" o "all". Es útil para evitar que el resultado se vea abrumado por un resultado de prueba con demasiado ruido. El encabezado de la prueba se incluye en el tamaño del registro. Los valores negativos implican que no hay límite. El resultado es todo o nada.
Etiquetas:test_runner
,terminal_output
,execution
--output_filter=<a valid Java regular expression>
predeterminado: Consulta la descripción-
Solo muestra advertencias y resultados de acciones para reglas con un nombre que coincida con la expresión regular proporcionada.
Etiquetas:affects_outputs
- Valor predeterminado de
--progress_report_interval=<an integer in 0-3600 range>
: "0" -
Es la cantidad de segundos que se debe esperar entre los informes de las tareas que aún se están ejecutando. El valor predeterminado 0 significa que el primer informe se imprimirá después de 10 segundos, luego de 30 segundos y, después de ese progreso, se informará una vez por minuto. Cuando se habilita --curses, el progreso se informa cada segundo.
Etiquetas:affects_outputs
- Valor predeterminado de
--remote_print_execution_messages=<failure, success or all>
: “failure” -
Elige cuándo imprimir los mensajes de ejecución remota. Los valores válidos son "failure" para imprimir solo en caso de fallas, "success" para imprimir solo en caso de éxitos y "all" para imprimir siempre.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]sandbox_debug
: "falso" -
Habilita las funciones de depuración para la función de zona de pruebas. Esto incluye dos aspectos: primero, el contenido raíz de la zona de pruebas no se modifica después de una compilación y, segundo, imprime información de depuración adicional durante la ejecución. Esto puede ayudar a los desarrolladores de reglas de Bazel o Starlark con errores de depuración debido a la falta de archivos de entrada, etcétera.
Etiquetas:terminal_output
--show_result=<an integer>
predeterminado: “1”-
Muestra los resultados de la compilación. Para cada objetivo, indica si se actualizó o no y, de ser así, una lista de los archivos de salida que se compilaron. Los archivos impresos son cadenas convenientes para copiar y pegar en la shell y ejecutarlas.
Esta opción requiere un argumento de número entero, que es la cantidad de objetivos de umbral por encima de la cual no se imprime la información de los resultados. Por lo tanto, cero 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 destino, se pueden omitir sus resultados para mantener el resultado por debajo del umbral.
Etiquetas:affects_outputs
--[no]subcommands
[-s
] predeterminado: "false"-
Muestra los subcomandos ejecutados durante una compilación. Marcas relacionadas: --execution_log_json_file, --execution_log_binary_file (para registrar subcomandos en un archivo en un formato compatible con herramientas)
Etiquetas:terminal_output
--test_output=<summary, errors, all or streamed>
predeterminado: “summary”-
Especifica el modo de salida deseado. Los valores válidos son "summary" para mostrar solo el resumen del estado de la prueba, "errors" para imprimir también los registros de prueba de las pruebas fallidas, "all" para imprimir los registros de todas las pruebas y "streamed" para mostrar los registros de todas las pruebas en tiempo real (esto forzará que las pruebas se ejecuten de forma local de a una a la vez, independientemente del valor de --test_strategy).
Etiquetas:test_runner
,terminal_output
,execution
- Valor predeterminado de
--test_summary=<short, terse, detailed, none or testcase>
: “short” - : Especifica el formato deseado del resumen de la prueba. Los valores válidos son "short" para imprimir información solo sobre las pruebas ejecutadas, "terse" para imprimir información solo sobre las pruebas que no se ejecutaron correctamente, "detailed" para imprimir información detallada sobre los casos de prueba fallidos, "testcase" para imprimir el resumen en la resolución de casos de prueba, no imprimir información detallada sobre los casos de prueba fallidos y "none" para omitir el resumen.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]verbose_explanations
: "falso" -
Aumenta el nivel de detalle de las explicaciones emitidas si se habilita --explain. No tiene efecto si no se habilita --explain.
Etiquetas:affects_outputs
--[no]verbose_failures
predeterminado: “false”-
Si un comando falla, imprime la línea de comandos completa.
Etiquetas:terminal_output
- Son opciones que especifican o alteran una entrada genérica en un comando de Bazel que no pertenece a otras categorías.:
- Se acumulan
--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 de parámetro se especifica mediante <param_name>=<param_value>, por ejemplo, "my_param=my_val", en la que "my_param" es un parámetro de algún aspecto en la lista --aspects o que es obligatorio para un aspecto de la lista. Esta opción se puede usar varias veces. Sin embargo, no se permite asignar valores al mismo parámetro más de una vez.
Etiquetas:loading_and_analysis
- 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
--target_pattern_file=<a string>
predeterminado: ""-
Si se establece, la compilación leerá patrones del archivo que se nombra aquí, en lugar de la línea de comandos. Es un error especificar un archivo aquí, así como patrones de línea de comandos.
Etiquetas:changes_inputs
- Opciones de almacenamiento en caché y ejecución remotas:
- Valor predeterminado de
--experimental_circuit_breaker_strategy=<failure>
: ver descripción - especifica la estrategia que debe usar el disyuntor. Las estrategias disponibles son "failure". 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 para configurar el cargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
--[no]experimental_guard_against_concurrent_changes
predeterminado: “false”- Desactiva esta opción para inhabilitar la verificación del ctime de los archivos de entrada de una acción antes de subirla a una caché remota. Puede haber casos en los que el kernel de Linux retrase la escritura de archivos, lo que podría provocar falsos positivos.
--[no]experimental_remote_cache_async
predeterminado: “false”- Si es verdadero, las operaciones de E/S de caché remota se realizarán en segundo plano en lugar de hacerlo como parte de un inicio.
--experimental_remote_cache_compression_threshold=<an integer>
predeterminado: “0”- Es el tamaño mínimo de blob necesario para comprimir o descomprimir con zstd. No es eficaz, a menos que se establezca --remote_cache_compression.
--experimental_remote_cache_eviction_retries=<an integer>
predeterminado: “0”-
La cantidad máxima de intentos para reintentar si la compilación encontró un error transitorio de caché remota que, de lo contrario, la compilación fallaría. Se aplica, por ejemplo, cuando los artefactos se desalojan de la caché remota o en ciertas condiciones de falla de la caché. 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 un ID de invocación y se lo proporcionas a Bazel con --invocation_id, no debes usar esta marca. En su lugar, establece la marca --incompatible_remote_use_new_exit_code_for_lost_inputs y busca el código de salida 39.
Etiquetas:execution
--[no]experimental_remote_cache_lease_extension
predeterminado: “false”- Si se establece como verdadero, Bazel extenderá el arrendamiento de los resultados de las acciones remotas durante la compilación enviando llamadas a "FindMissingBlobs" 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.>
predeterminado: "3h"-
Es el TTL mínimo garantizado de los blobs en la caché remota después de que se hace referencia a sus resúmenes recientemente, p.ej., por un ActionResult o FindMissingBlobs. Bazel realiza varias optimizaciones en función del TTL de los blobs, p.ej., no llama repetidamente a GetActionResult en una compilación incremental. El valor debe establecerse un poco menor que el TTL real, ya que hay un intervalo entre el momento en que el servidor muestra los resúmenes y el momento en que Bazel los recibe.
Etiquetas:execution
--experimental_remote_capture_corrupted_outputs=<a path>
predeterminado: Consulta la descripción- Es una ruta de acceso a un directorio en el que se capturarán los resultados dañados.
--[no]experimental_remote_discard_merkle_trees
predeterminado: “false”- Si se establece en verdadero, se descartan las copias en memoria del árbol de Merkle de la raíz de entrada y las asignaciones de entrada asociadas durante las llamadas a GetActionResult() y Execute(). Esto reduce significativamente el uso de memoria, pero requiere que Bazel vuelva a calcularlas cuando se pierda la caché remota y se realicen reintentos.
- 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 admitidos son grpc, grpcs (grpc con TLS habilitado) y unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel usará grpcs de forma predeterminada. Consulta: https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto
--[no]experimental_remote_downloader_local_fallback
predeterminado: “false”- Indica si se debe recurrir al descargador local si falla el descargador remoto.
--[no]experimental_remote_execution_keepalive
predeterminado: “false”- Indica si se debe usar el mantenimiento de la conexión para las llamadas de ejecución remotas.
--experimental_remote_failure_rate_threshold=<an integer in 0-100 range>
predeterminado: "10"-
Establece la cantidad permitida de porcentaje de tasa de fallas para un período específico después del cual deja de llamar a la caché o al ejecutor remotos. De forma predeterminada, el valor es 10. Si lo estableces en 0, no habrá limitaciones.
Etiquetas:execution
--experimental_remote_failure_window_interval=<An immutable length of time.>
predeterminado: "60s"-
Es el intervalo en el que se calcula la tasa de fallas de las solicitudes remotas. Si el valor es cero o negativo, la duración de la falla se calcula durante toda la ejecución.Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
Etiquetas:execution
--[no]experimental_remote_mark_tool_inputs
predeterminado: “false”- Si se establece como verdadero, Bazel marcará las entradas como entradas de herramientas para el ejecutor remoto. Esto se puede usar para implementar trabajadores persistentes remotos.
--[no]experimental_remote_merkle_tree_cache
predeterminado: “false”- Si se establece como verdadero, los cálculos del árbol de Merkle se almacenarán en caché para mejorar la velocidad de verificación de hits de caché remotos. El espacio en memoria de la caché se controla con --experimental_remote_merkle_tree_cache_size.
--experimental_remote_merkle_tree_cache_size=<a long integer>
predeterminado: "1000"- Es la cantidad de árboles de Merkle que se deben almacenar en caché para mejorar la velocidad de verificación de aciertos de caché remotos. Aunque la caché se reduce automáticamente según el manejo de referencias suaves de Java, se pueden producir errores por falta de memoria si se configura en un valor demasiado alto. Si se establece en 0, el tamaño de la caché es ilimitado. El valor óptimo varía según el tamaño del proyecto. La configuración predeterminada es 1,000.
- Valor predeterminado de
--experimental_remote_output_service=<a string>
: ver descripción - HOST o HOST:PORT de un extremo de servicio de salida remoto. Los esquemas admitidos son grpc, grpcs (grpc con TLS habilitado) y unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel usará grpcs de forma predeterminada. Especifica el esquema grpc:// o unix: para inhabilitar TLS.
--experimental_remote_output_service_output_path_prefix=<a string>
predeterminado: ""- Es la ruta de acceso en la que se coloca el contenido de los directorios de salida que administra el --experimental_remote_output_service. El directorio de salida real que usa una compilación será un descendiente de esta ruta de acceso y lo determinará el servicio de salida.
--[no]experimental_remote_require_cached
predeterminado: “false”- Si se configura como verdadera, exige que todas las acciones que pueden ejecutarse de forma remota se almacenen en caché o que fallen la compilación. Esto es útil para solucionar problemas de no determinismo, ya que permite verificar si las acciones que deberían almacenarse en caché realmente se almacenan en caché sin insertar resultados nuevos de forma falsa en la caché.
--experimental_remote_scrubbing_config=<Converts to a Scrubber>
predeterminado: Consulta la descripción- Habilita la limpieza de claves de caché remotas con el archivo de configuración proporcionado, que debe ser un búfer de protocolo en formato de texto (consulta src/main/protobuf/remote_scrubbing.proto). El objetivo de esta función es facilitar el uso compartido de una caché remota o en el disco entre acciones que se ejecutan en diferentes plataformas, pero que se orientan a la misma plataforma. 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, sino solo la forma en que se calcula su clave de caché remota o en el disco para recuperar o almacenar un resultado de acción. Las acciones limpiadas no son compatibles con la ejecución remota y siempre se ejecutarán de forma local. Modificar la configuración de limpieza no invalida los resultados presentes en el sistema de archivos local o las cachés internas. Se requiere una compilación limpia para volver a ejecutar las acciones afectadas. Para usar esta función correctamente, es probable que desees establecer un --host_platform personalizado junto con --experimental_platform_in_output_dir (para normalizar los prefijos de salida) y --incompatible_strict_action_env (para normalizar las variables de entorno).
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
predeterminado: “auto”- Es el modo de subprocesos que se usará para recuperar el repo. Si se establece en "desactivado", no se usa ningún subproceso de trabajo y la recuperación del repo está sujeta a reinicios. De lo contrario, usa un subproceso de trabajador virtual.
- Valor predeterminado de
--[no]incompatible_remote_build_event_upload_respect_no_cache
: "falso" - Obsoleto. No realiza ninguna acción. En su lugar, usa --remote_build_event_upload=minimal.
--[no]incompatible_remote_downloader_send_all_headers
predeterminado: "true"-
Indica si se deben enviar todos los valores de un encabezado con varios valores al descargador remoto en lugar de solo el primero.
Etiquetas:incompatible_change
--[no]incompatible_remote_output_paths_relative_to_input_root
predeterminado: “false”-
Si se 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" -
Etiquetas
sin acción:incompatible_change
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
predeterminado: "true"-
Si se establece como verdadero, Bazel usará el nuevo código de salida 39 en lugar de 34 si los errores de caché remota, incluidas las expulsiones de caché, hacen que falle la compilación.
Etiquetas:incompatible_change
--[no]remote_accept_cached
predeterminado: "true"- Indica si se aceptan los resultados de las acciones almacenadas en caché de forma remota.
--remote_build_event_upload=<all or minimal>
predeterminado: "minimal"- Si se configura como “all”, todas las salidas locales a las que hace referencia BEP se suben a la caché remota. Si se establece en "minimal", los resultados locales a los que hace referencia BEP no se suben a la caché remota, excepto los archivos que son importantes para los consumidores de BEP (p.ej., registros de prueba y perfil de tiempo). El esquema bytestream:// siempre se usa para el URI de los archivos, incluso si faltan en la caché remota. La configuración predeterminada es "minimal".
--remote_bytestream_uri_prefix=<a string>
predeterminado: Consulta la descripción- Es el nombre de host y el nombre de la instancia que se usarán en los URIs bytestream:// que se escriben en los flujos de eventos de compilación. Esta opción se puede establecer cuando las compilaciones se realizan con un proxy, lo que hace que los valores de --remote_executor y --remote_instance_name ya no correspondan al nombre canónico del servicio de ejecución remota. Si no la estableces, se establecerá la configuración predeterminada como "${hostname}/${instance_name}".
--remote_cache=<a string>
predeterminado: Consulta la descripción- Es un URI de un extremo de almacenamiento en caché. Los esquemas compatibles son http, https, grpc, grpcs (grpc con TLS habilitado) y Unix (sockets UNIX locales), Si no se proporciona un esquema, Bazel usará grpcs de forma predeterminada. Especifica el esquema grpc://, http:// o unix: para inhabilitar TLS. Consulta https://bazel.build/remote/caching
- Valor predeterminado de
--[no]remote_cache_compression
: "falso" - Si está habilitado, comprime o descomprime los blobs de caché con zstd cuando su tamaño sea de 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=Nombre=Valor. Se pueden pasar varios encabezados si especificas la marca varias veces. Los múltiples valores para el mismo nombre se convertirán en una lista separada por comas.
- Se acumulan varios usos de
--remote_default_exec_properties=<a 'name=value' assignment>
-
Establece las propiedades de ejecución predeterminadas que se usarán como la plataforma de ejecución remota si una plataforma de ejecución aún no establece exec_properties.
Etiquetas:affects_outputs
--remote_default_platform_properties=<a string>
predeterminado: ""- Establece las propiedades de plataforma predeterminadas que se establecerán para la API de ejecución remota, si la plataforma de ejecución aún no establece remote_execution_properties. Este valor también se usará si se selecciona la plataforma host como plataforma de ejecución remota.
- Se acumulan
--remote_download_regex=<a valid Java regular expression>
usos múltiples -
Forzar la descarga de los resultados de la compilación remota cuya ruta coincida con este patrón, independientemente de --remote_download_outputs. Se pueden especificar varios patrones repitiendo esta marca.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--remote_downloader_header=<a 'name=value' assignment>
- Especifica un encabezado que se incluirá en las solicitudes de descargas remotas: --remote_downloader_header=Name=Value. Se pueden pasar varios encabezados si especificas la marca varias veces. Los múltiples valores para el mismo nombre se convertirán en una lista separada por comas.
- Se acumulan
--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=Nombre=Valor. Se pueden pasar varios encabezados si especificas 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" - Es la prioridad relativa de las acciones que se ejecutarán de forma remota. La semántica de los valores de prioridad particulares depende del servidor.
--remote_executor=<a string>
predeterminado: Consulta la descripción- HOST o HOST:PORT de un extremo de ejecución remota. Los esquemas admitidos son grpc, grpcs (grpc con TLS habilitado) y unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel usará grpcs de forma predeterminada. Especifica el esquema grpc:// o unix: para inhabilitar TLS.
--remote_grpc_log=<a path>
predeterminado: Consulta la descripción- Si se especifica, es una ruta de acceso a un archivo para registrar los detalles relacionados con las llamadas de gRPC. Este registro consta de una secuencia de protobufs com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry serializados con cada mensaje con el prefijo de un varint que indica 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 si especificas la marca varias veces. Los múltiples valores para el mismo nombre se convertirán en una lista separada por comas.
--remote_instance_name=<a string>
predeterminado: ""- Valor para pasar como instance_name en la API de ejecución remota.
--[no]remote_local_fallback
predeterminado: “false”- Determina si se debe recurrir a la estrategia de ejecución local independiente si falla la ejecución remota.
- Valor predeterminado de
--remote_local_fallback_strategy=<a string>
: “local” - No realiza ninguna acción, está obsoleto. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/7480.
--remote_max_connections=<an integer>
predeterminado: "100"-
Limita la cantidad máxima de conexiones simultáneas a la caché o al ejecutor remotos. De forma predeterminada, el valor es 100. Si lo estableces en 0, no habrá limitaciones.
Para la caché remota HTTP, una conexión TCP podría controlar una solicitud a la vez, por lo que Bazel podría realizar hasta --remote_max_connections solicitudes simultáneas.
En el caso de la caché o el ejecutor remotos de gRPC, un canal de gRPC suele poder controlar más de 100 solicitudes simultáneas, por lo que Bazel podría realizar alrededor de `--remote_max_connections * 100` solicitudes simultáneas.
Etiquetas:host_machine_resource_optimizations
- 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).
--remote_result_cache_priority=<an integer>
predeterminado: “0”- Es la prioridad relativa de las acciones remotas que se almacenarán en la caché remota. La semántica de los valores de prioridad particulares depende del servidor.
--remote_retries=<an integer>
predeterminado: “5”- Es la cantidad máxima de intentos para reintentar un error transitorio. Si se establece en 0, se inhabilitan los reintentos.
--remote_retry_max_delay=<An immutable length of time.>
predeterminado: "5s"- Es la demora máxima de la retirada entre los intentos de reintento remotos. Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
--remote_timeout=<An immutable length of time.>
predeterminado: "60s"- Es la cantidad máxima de tiempo que se espera para la ejecución remota y las llamadas a la caché. Para la caché REST, este es el tiempo de espera de conexión y de lectura. Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
--[no]remote_upload_local_results
predeterminado: "true"- Determina si se deben subir los resultados de las acciones ejecutadas de forma local a la caché remota si esta la admite y el usuario está autorizado para hacerlo.
--[no]remote_verify_downloads
predeterminado: "true"- Si se establece como verdadero, Bazel calculará la suma de hash de todas las descargas remotas y descartará los valores almacenados en caché de forma remota si no coinciden con el valor esperado.
- Otras opciones, sin categorizar:
--[no]allow_analysis_cache_discard
predeterminado: "true"-
Si se descarta la caché de análisis debido a un cambio en el sistema de compilación, configurar esta opción como falsa hará que Bazel se cierre, en lugar de continuar con la compilación. Esta opción no tiene efecto cuando también se establece "discard_analysis_cache".
Etiquetas:eagerness_to_exit
- Valor predeterminado de
--auto_output_filter=<none, all, packages or subpackages>
: “none” - Si no se especifica --output_filter, se usa el valor de esta opción para crear un filtro automáticamente. Los valores permitidos son “ninguno” (filtrar nada / mostrar todo), “todo” (filtrar todo / no mostrar nada), “paquetes” (incluir resultados de las reglas en paquetes mencionados en la línea de comandos de Blaze) y “subpaquetes” (como “paquetes”, pero también incluir subpaquetes). Para los valores "packages" y "subpackages", //java/foo y //javatests/foo se tratan como un solo paquete).
--[no]build_manual_tests
predeterminado: “false”- Forza la compilación de los destinos de prueba etiquetados como "manual". Las pruebas "manuales" se excluyen del procesamiento. Esta opción los obliga a compilarse (pero no a ejecutarse).
--build_tag_filters=<comma-separated list of options>
predeterminado: ""- Especifica una lista de etiquetas separadas por comas. De manera opcional, cada etiqueta puede ir precedida de "-" para especificar las etiquetas excluidas. Solo se 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 que se ejecutan con el comando "test", ya que se rigen por las opciones de filtrado de pruebas, 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 objetivos especificados en la línea de comandos. De forma predeterminada, se compilará todo lo que se solicitó.
- Valor predeterminado de
--combined_report=<none or lcov>
: “none” - Especifica el tipo de informe de cobertura acumulativa deseado. En este punto, solo se admite LCOV.
--[no]compile_one_dependency
predeterminado: “false”- Compila una sola dependencia de los archivos de argumento. Esto es útil para verificar la sintaxis de los archivos de origen en los IDE, por ejemplo, reconstruiendo un único destino que depende del archivo fuente para detectar errores lo antes posible en el ciclo de edición, compilación y prueba. Este argumento afecta la forma en que se interpretan los argumentos que no son de marca. En lugar de usarse como objetivo para la compilación, son nombres de archivos de origen. Para cada nombre de archivo de origen, se compilará un destino arbitrario que depende de él.
- Se acumulan varios usos de
--deleted_packages=<comma-separated list of package names>
- Es una lista separada por comas de nombres de paquetes que el sistema de compilación considerará inexistentes, incluso si son visibles en algún lugar de la ruta de acceso del paquete. Usa esta opción cuando borres un subpaquete "x/y" de un paquete existente "x". Por ejemplo, después de borrar x/y/BUILD en tu cliente, es posible que el sistema de compilación se queje si encuentra una etiqueta "//x:y/z" si otra entrada de package_path aún la proporciona. Especificar --deleted_packages x/y evita este problema.
--[no]discard_analysis_cache
predeterminado: “false”- Descarta la caché de análisis inmediatamente después de que se complete la fase de análisis. Reduce el uso de memoria en un 10% aproximadamente, pero ralentiza las compilaciones incrementales posteriores.
--disk_cache=<a path>
predeterminado: Consulta la descripción- Es una ruta de acceso a un directorio en el que Bazel puede leer y escribir acciones y resultados de acciones. Si el directorio no existe, se creará.
- Valor predeterminado de
--embed_label=<a one-line string>
: "" - Incorpora la revisión del control de código fuente o la etiqueta de lanzamiento en el objeto binario.
--execution_log_binary_file=<a path>
predeterminado: Consulta la descripción- Registra los inicios ejecutados en este archivo como protos de SpawnExec delimitados por longitud, según src/main/protobuf/spawn.proto. Se prefiere --execution_log_compact_file, que es mucho más pequeño y económico de producir. Marcas relacionadas: --execution_log_compact_file (formato compacto; mutuamente excluyente), --execution_log_json_file (formato JSON de texto; mutuamente excluyentes), --execution_log_sort (si se debe ordenar el registro de ejecución), --subcomandos (para mostrar subcomandos en el resultado de la terminal).
--execution_log_compact_file=<a path>
predeterminado: Consulta la descripción- Registra los inicios ejecutados en este archivo como protos de ExecLogEntry delimitados por longitud, según src/main/protobuf/spawn.proto. Todo el archivo está comprimido con zstd. Marcas relacionadas: --execution_log_binary_file (formato protobuf binario; mutuamente excluyente), --execution_log_json_file (formato JSON de texto; mutuamente excluyente), --subcommands (para mostrar subcomandos en el resultado de la terminal).
- Valor predeterminado de
--execution_log_json_file=<a path>
: ver descripción - Registra los inicios ejecutados en este archivo como representaciones JSON delimitadas por saltos de línea de los protos de SpawnExec, según src/main/protobuf/spawn.proto. Prefiere --execution_log_compact_file, que es significativamente más pequeño y económico de producir. Marcas relacionadas: --execution_log_compact_file (formato compacto; mutuamente excluyentes), --execution_log_binary_file (formato de protobuf binario; mutuamente excluyentes), --execution_log_sort (si se debe ordenar el registro de ejecución), --subcomandos (para mostrar subcomandos en el resultado de la terminal).
--[no]execution_log_sort
predeterminado: "true"- Indica si se debe ordenar el registro de ejecución, lo que facilita la comparación de registros entre invocaciones. Se establece en "false" para evitar un uso potencialmente significativo de la CPU y la memoria al final de la invocación, a costa de producir el registro en un orden de ejecución no determinista. Solo se aplica a los formatos binarios y JSON; el formato compacto nunca se ordena.
--[no]expand_test_suites
predeterminado: "true"-
Expande los objetivos de test_suite en sus pruebas constituyentes antes del análisis. Cuando esta marca esté activada (la opción predeterminada), se aplicarán patrones de destino negativos a las pruebas que pertenecen al paquete de pruebas; de lo contrario, no se aplicarán. Desactivar esta marca es útil cuando se aplican aspectos de nivel superior en la línea de comandos: luego, pueden analizar los destinos de test_suite.
Etiquetas:loading_and_analysis
--experimental_disk_cache_gc_idle_delay=<An immutable length of time.>
predeterminado: "5m"- Es la cantidad de tiempo que el servidor debe permanecer inactivo antes de que se produzca una recolección de elementos no utilizados de la caché del disco. Para especificar la política de recolección de elementos no utilizados, establece --experimental_disk_cache_gc_max_size o --experimental_disk_cache_gc_max_age.
--experimental_disk_cache_gc_max_age=<An immutable length of time.>
predeterminado: “0”- Si se establece en un valor positivo, la caché de disco se eliminará periódicamente como elementos no utilizados para quitar las entradas que tengan más antigüedad que esta. Si se establece junto con --experimental_disk_cache_gc_max_size, se aplican ambos criterios. La recolección de basura se produce en segundo plano una vez que el servidor se vuelve inactivo, según lo determine la marca --experimental_disk_cache_gc_idle_delay.
--experimental_disk_cache_gc_max_size=<a size in bytes, optionally followed by a K, M, G or T multiplier>
predeterminado: “0”- Si se establece en un valor positivo, se recolectará periódicamente la caché de disco para mantenerse por debajo de este tamaño. Si se establece junto con --experimental_disk_cache_gc_max_age, se aplican ambos criterios. La recolección de basura se produce en segundo plano una vez que el servidor se vuelve inactivo, según lo determine la marca --experimental_disk_cache_gc_idle_delay.
--experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
predeterminado: ""- Obsoleto para dar lugar a aspectos. Filtra el conjunto de objetivos para los que se programarán acciones extra.
--[no]experimental_extra_action_top_level_only
predeterminado: “false”- dejó de estar disponible y se reemplazó por aspectos. Solo programa extra_actions para los objetivos de nivel superior.
--experimental_spawn_scheduler
-
Ejecuta acciones de forma local y remota en paralelo para habilitar la ejecución dinámica. Bazel genera cada acción de forma local y remota, y elige la que se completa primero. Si una acción admite trabajadores, la acción local se ejecutará en el modo de trabajador persistente. Para habilitar la ejecución dinámica 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
--[no]fetch
predeterminado: "true"- Permite que el comando recupere dependencias externas. Si se establece como falso, el comando usará cualquier versión almacenada en caché de la dependencia y, si no existe ninguna, el comando fallará.
--[no]incompatible_dont_use_javasourceinfoprovider
predeterminado: “false”-
Etiquetas
sin acción:incompatible_change
--local_termination_grace_seconds=<an integer>
predeterminado: “15”- Es el tiempo de espera entre la finalización de un proceso local debido al tiempo de espera y su cierre forzoso.
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
- Anula un repositorio con una ruta de acceso local en el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es una ruta absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta relativa, se relaciona con el directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace". Si la ruta de acceso determinada está vacía, quita las anulaciones anteriores.
--package_path=<colon-separated list of options>
predeterminado: “%workspace%”- Es una lista separada por dos puntos de dónde buscar paquetes. Los elementos que comienzan con "%workspace%" son relativos al lugar de trabajo que los contiene. Si se omite o está vacío, el valor predeterminado es el resultado de "bazel info default-package-path".
- Valor predeterminado de
--[no]show_loading_progress
: "true" - Si está habilitado, hace que Bazel imprima mensajes de "Carga del paquete:".
--test_lang_filters=<comma-separated list of options>
predeterminado: ""- Especifica una lista de idiomas de prueba separados por comas. De manera opcional, cada idioma puede ir precedido de “-” para especificar los idiomas excluidos. Solo se encontrarán los objetivos de prueba que estén escritos en los idiomas especificados. El nombre que se usa para cada idioma debe ser el mismo que el prefijo de idioma en la regla *_test, p.ej., uno de "cc", "java", "py", etc. Esta opción afecta el comportamiento de --build_tests_only y el comando test.
--test_size_filters=<comma-separated list of values: small, medium, large or enormous>
predeterminado: ""- Especifica una lista de tamaños de prueba separados por comas. De manera opcional, cada tamaño puede ir precedido de "-" para especificar los tamaños excluidos. Solo se 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 de --build_tests_only y el comando test.
--test_tag_filters=<comma-separated list of options>
predeterminado: ""- Especifica una lista de etiquetas de prueba separadas por comas. De manera opcional, cada etiqueta puede ir precedida de "-" para especificar las etiquetas excluidas. Solo se encontrarán los objetivos de prueba que contengan al menos una etiqueta incluida y no contengan ninguna etiqueta excluida. Esta opción afecta el comportamiento --build_tests_only y el comando test.
- Valor predeterminado de
--test_timeout_filters=<comma-separated list of values: short, moderate, long or eternal>
: "" - Especifica una lista separada por comas de tiempos de espera de prueba. De manera opcional, cada tiempo de espera puede ir precedido de "-" para especificar los tiempos de espera excluidos. Solo se encontrarán los objetivos de prueba que contengan al menos un tiempo de espera incluido y no contengan tiempos de espera excluidos. Esta opción afecta el comportamiento --build_tests_only y el comando test.
--workspace_status_command=<path>
predeterminado: ""- Es un comando que se invoca al comienzo de la compilación para proporcionar información de estado sobre el espacio de trabajo en forma de pares clave-valor. Consulta el manual del usuario para conocer las especificaciones completas. Consulta también tools/buildstamp/get_workspace_status para ver un ejemplo.
- Opciones que controlan la ejecución de la compilación:
--[no]check_up_to_date
predeterminado: “false”-
No realices la compilación, solo verifica si está actualizada. Si todos los destinos están actualizados, la compilación se completa correctamente. Si se debe ejecutar algún paso, se informa un error y falla la compilación.
Etiquetas:execution
- Valor predeterminado de
--[no]experimental_inprocess_symlink_creation
: "falso" -
Indica si se deben realizar llamadas directas al sistema de archivos para crear árboles de symlinks
Etiquetas:loading_and_analysis
,execution
,experimental
--[no]experimental_persistent_aar_extractor
predeterminado: “false”-
Habilita el extractor de aar persistente con trabajadores.
Etiquetas:execution
--[no]experimental_remotable_source_manifests
predeterminado: “false”-
Determina si las acciones del manifiesto de origen se pueden controlar de forma remota.
Etiquetas:loading_and_analysis
,execution
,experimental
- Valor predeterminado de
--[no]experimental_split_coverage_postprocessing
: "falso" -
Si es verdadero, Bazel ejecutará el procesamiento posterior de la cobertura para la prueba en un nuevo inicio.
Etiquetas:execution
--[no]experimental_split_xml_generation
predeterminado: "true"-
Si se establece esta marca y una acción de prueba no genera un archivo test.xml, Bazel usa una acción independiente para generar un archivo test.xml ficticio que contiene el registro de prueba. De lo contrario, Bazel genera un test.xml como parte de la acción de prueba.
Etiquetas:execution
--[no]experimental_strict_fileset_output
predeterminado: “false”-
Si esta opción está habilitada, los conjuntos de archivos tratarán todos los artefactos de salida como archivos normales. No recorrerán directorios ni serán sensibles a los symlinks.
Etiquetas:execution
--[no]experimental_use_semaphore_for_jobs
predeterminado: "true"-
Si se establece en verdadero, además, usa un semáforo para limitar la cantidad de trabajos simultáneos.
Etiquetas:host_machine_resource_optimizations
,execution
--genrule_strategy=<comma-separated list of options>
predeterminado: ""-
Especifica cómo ejecutar genrules. Esta marca se dará de baja gradualmente. En su lugar, usa --spawn_strategy=<value> para controlar todas las acciones o --strategy=Genrule=<value> para controlar solo las genrules.
Etiquetas:execution
--[no]incompatible_disallow_unsound_directory_outputs
predeterminado: "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
,incompatible_change
--[no]incompatible_modify_execution_info_additive
predeterminado: “false”-
Cuando se habilita, se agregan varias marcas --modify_execution_info. Cuando se inhabilita, solo se tiene en cuenta la última marca.
Etiquetas:execution
,affects_outputs
,loading_and_analysis
,incompatible_change
--jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
[-j
] predeterminado: "auto"-
Es la cantidad de trabajos simultáneos que se ejecutarán. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". Los valores deben estar entre 1 y 5,000. Los valores superiores a 2,500 pueden causar problemas de memoria. "auto" calcula un valor predeterminado razonable según los recursos del host.
Etiquetas:host_machine_resource_optimizations
,execution
--[no]keep_going
[-k
] predeterminado: "false"-
Continúa tanto como sea posible después de un error. Si bien no se pueden analizar el objetivo que falló ni los que dependen de él, sí se pueden analizar otros requisitos previos de estos objetivos.
Etiquetas:eagerness_to_exit
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
predeterminado: "automático"-
Es la cantidad de subprocesos paralelos que se usarán en la fase de carga o análisis. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguido de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". "auto" establece un valor predeterminado razonable según los recursos del host. Debe ser 1 como mínimo.
Etiquetas:bazel_internal_configuration
- Se acumulan varios usos de
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
-
Agrega o quita claves de la información de ejecución de una acción según la mnemotecnia de la acción. Solo se aplica a las acciones que admiten información de ejecución. Muchas acciones comunes admiten información de ejecución, p.ej., Genrule, CppCompile, Javac, StarlarkAction y TestRunner. Cuando especificas varios valores, el orden es importante porque muchas regex pueden aplicarse al mismo mnemónico.
Sintaxis: "regex=[+-]clave,regex=[+-]clave,…".
Ejemplos:
'.*=+x,.*=-y,.*=+z' agrega "x" y "z" a la información de ejecución de todas las acciones y quita "y".
"Genrule=+requires-x" agrega "requires-x" a la información de ejecución de todas las acciones de Genrule.
“(?!Genrule).*=-requires-x” quita “require-x” de la información de ejecución para todas las acciones que no sean de Genrule.
Etiquetas:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Habilita las acciones de expansión de sintaxis y dex persistentes de Android con trabajadores.
Se expande a:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
-
Habilita el procesador de recursos de Android persistente con trabajadores.
Se expande a:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
--strategy=ProcessDatabinding=worker
--strategy=GenerateDataBindingBaseClasses=worker
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_dex_desugar
-
Habilita las acciones de desugar y dex multiplexadas y persistentes de Android con trabajadores.
Se expande a:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
Habilita el procesador de recursos de Android multiplexado persistente con trabajadores.
Se expande a lo siguiente:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
/}{/14/}:--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
: }{/13/}
{/17/} :--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
}} }{/13/}--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
} }{/--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
host_machine_resource_optimizations
execution
--persistent_multiplex_android_tools
-
Habilita las herramientas de Android persistentes y multiplexadas (dexing, expansión de sintaxis, procesamiento de recursos).
Se expande a:
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Etiquetas:host_machine_resource_optimizations
,execution
--[no]skip_incompatible_explicit_targets
predeterminado: “false”-
Omite los destinos incompatibles que se enumeran de forma explícita en la línea de comandos. De forma predeterminada, la compilación de esos destinos genera un error, pero se omiten de forma silenciosa cuando se habilita esta opción. Consulta: https://bazel.build/extending/platforms#skipping-incompatible-targets
Etiquetas:loading_and_analysis
--spawn_strategy=<comma-separated list of options>
predeterminado: ""-
Especifica cómo se ejecutan las acciones de creación de forma predeterminada. Acepta una lista de estrategias separadas por comas de mayor a menor prioridad. Para cada acción, Bazel elige la estrategia con la prioridad más alta que puede ejecutar la acción. El valor predeterminado es "remote,worker,sandboxed,local". Consulta https://blog.bazel.build/2019/06/19/list-strategy.html para obtener más información.
Etiquetas:execution
- Se acumulan
--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 mnemónico). Consulta https://blog.bazel.build/2019/06/19/list-strategy.html para obtener más información.
Etiquetas:execution
- Se acumulan varios usos de
--strategy_regexp=<a '<RegexFilter>=value[,value]' assignment>
-
Anula qué estrategia de creación se debe usar para ejecutar acciones de creación que tengan descripciones que coincidan con un cierto regex_filter. Consulta --per_file_copt para obtener detalles sobre la coincidencia de regex_filter. Se usa el último regex_filter que coincida con la descripción. Esta opción anula otras marcas para especificar la estrategia. Ejemplo: --strategy_regexp=//foo.*\.cc,-//foo/bar=local significa ejecutar acciones con la estrategia local si sus descripciones coinciden con //foo.*.cc, pero no con //foo/bar. Ejemplo: --strategy_regexp='Compiling.*/bar=local --strategy_regexp=Compiling=sandboxed ejecutará "Compiling //foo/bar/baz" con la estrategia "local", pero si se invierte el orden, se ejecutará con "sandboxed".
Etiquetas:execution
- 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
- Son opciones que configuran la cadena de herramientas que se usa para la ejecución de acciones:
--android_compiler=<a string>
predeterminado: Consulta la descripción-
El compilador de destino de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_crosstool_top=<a build target label>
predeterminado: "//external:android/crosstool"-
Es la ubicación del compilador de C++ que se usa para las compilaciones de Android.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_grte_top=<a label>
predeterminado: Consulta la descripción-
El objetivo grte_top de Android.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
predeterminado: "android"-
Selecciona la combinación de manifiestos que se usará para las reglas de android_binary. Marca para ayudar a la transición a la combinación de manifiestos de Android desde la combinación heredada.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Valor predeterminado de
--android_platforms=<a build target label>
: "" -
Establece las plataformas que usan los destinos de android_binary. Si se especifican varias plataformas, el objeto binario es un APK grueso, que contiene objetos binarios nativos para cada plataforma de destino especificada.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_sdk=<a build target label>
predeterminado: "@bazel_tools//tools/android:sdk"-
Especifica el SDK o la plataforma de Android que se usa para compilar aplicaciones para Android.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--apple_crosstool_top=<a build target label>
predeterminado: “@bazel_tools//tools/cpp:toolchain”-
Es la etiqueta del paquete de herramientas cruzadas que se usará en las reglas de Apple y Objc, y sus dependencias.
Etiquetas:loses_incremental_state
,changes_inputs
- Valor predeterminado de
--cc_output_directory_tag=<a string>
: "" -
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas:affects_outputs
--compiler=<a string>
predeterminado: Consulta la descripción-
El compilador de C++ que se usará para compilar el destino.
Etiquetas:loading_and_analysis
,execution
--coverage_output_generator=<a build target label>
predeterminado: "@bazel_tools//tools/test:lcov_merger"-
Ubicación del binario que se usa para postprocesar informes de cobertura sin procesar. Actualmente, debe ser un grupo de archivos que contenga un solo archivo, el binario. El valor predeterminado es “//tools/test:lcov_merger”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
predeterminado: "@bazel_tools//tools/test:coverage_report_generator"-
Ubicación del binario que se usa para generar informes de cobertura. Actualmente, debe ser un grupo de archivos que contenga un solo archivo: el objeto binario. El valor predeterminado es "//tools/test:coverage_report_generator".
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
predeterminado: "@bazel_tools//tools/test:coverage_support"-
Ubicación de los archivos de compatibilidad que se requieren en las entradas de cada acción de prueba que recopila la cobertura de código. La configuración predeterminada es “//tools/test:coverage_support”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--crosstool_top=<a build target label>
predeterminado: “@bazel_tools//tools/cpp:toolchain”-
Es la etiqueta del paquete de herramientas cruzadas que se usará para compilar código C++.
Etiquetas:loading_and_analysis
,changes_inputs
,affects_outputs
--custom_malloc=<a build target label>
predeterminado: Consulta la descripción-
Especifica una implementación de malloc personalizada. Este parámetro de configuración anula los atributos malloc en las reglas de compilación.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
usos múltiples -
Es una lista de expresiones regulares separadas por comas, cada una con el prefijo - (expresión negativa) de forma opcional, asignadas (=) a una lista de objetivos de valores de restricción separados por comas. Si un objetivo no coincide con ninguna expresión negativa y con al menos una expresión positiva, la resolución de la cadena de herramientas se realizará como si hubiera declarado los valores de restricción como restricciones de ejecución. Ejemplo: //demo,-test=@platforms//cpus:x86_64 agregará "x86_64" a cualquier destino de //demo, excepto a aquellos cuyo nombre contenga "test".
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]experimental_include_xcode_execution_requirements
: "falso" -
Si se configura, agrega un requisito de ejecución “requires-xcode:{version}” a cada acción de Xcode. Si la versión de Xcode tiene una etiqueta con guiones, también agrega un requisito de ejecución "requires-xcode-label:{version_label}".
Etiquetas:loses_incremental_state
,loading_and_analysis
,execution
--[no]experimental_prefer_mutual_xcode
predeterminado: "true"-
Si es verdadero, usa la versión más reciente de Xcode que esté disponible de forma local y remota. Si es falso, o si no hay versiones mutuas disponibles, usa la versión de Xcode local seleccionada a través de xcode-select.
Etiquetas:loses_incremental_state
--extra_execution_platforms=<comma-separated list of options>
predeterminado: ""-
Son las plataformas disponibles como plataformas de ejecución para ejecutar acciones. Las plataformas se pueden especificar por destino exacto o como un patrón de destino. Estas plataformas se considerarán antes de las declaradas en el archivo WORKSPACE por register_execution_platforms(). Esta opción solo se puede establecer una vez; las instancias posteriores anularán la configuración de la marca anterior.
Etiquetas:execution
- Se acumulan varios usos de
--extra_toolchains=<comma-separated list of options>
-
Las reglas de la cadena de herramientas que se deben considerar durante su resolución. Las cadenas de herramientas se pueden especificar por destino exacto o como un patrón de destino. Estas cadenas de herramientas se considerarán antes que las declaradas en el archivo WORKSPACE por register_toolchains().
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--grte_top=<a label>
predeterminado: Consulta la descripción-
Es una etiqueta para una biblioteca de libc registrada. La cadena de herramientas de crosstool selecciona el valor predeterminado, y casi nunca es necesario anularlo.
Etiquetas:action_command_lines
,affects_outputs
--host_compiler=<a string>
predeterminado: Consulta la descripción-
Es el compilador de C++ que se usará para la compilación del host. Se ignora si no se establece --host_crosstool_top.
Etiquetas:loading_and_analysis
,execution
--host_crosstool_top=<a build target label>
predeterminado: Consulta la descripción-
De forma predeterminada, las opciones --crosstool_top y --compiler también se usan para la configuración de 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
,affects_outputs
- Valor predeterminado de
--host_grte_top=<a label>
: ver descripción -
Si se especifica, esta configuración anula el directorio de nivel superior de libc (--grte_top) para la configuración de ejecución.
Etiquetas:action_command_lines
,affects_outputs
--host_platform=<a build target label>
predeterminado: “@bazel_tools//tools:host_platform”-
La etiqueta de una regla de plataforma que describe el sistema host.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
- Valor predeterminado de
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
: "true" -
Si es verdadero, Bazel no habilitará las funciones "host" y "nonhost" en la cadena de herramientas de C++ (consulta https://github.com/bazelbuild/bazel/issues/7407 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_android_toolchain_resolution
predeterminado: "true"-
Usa la resolución de la cadena de herramientas para seleccionar el SDK de Android para reglas de Android (Starlark y Native)
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]incompatible_enable_apple_toolchain_resolution
: "falso" -
Usa la resolución de cadena de herramientas para seleccionar el SDK de Apple para las reglas de Apple (Starlark y nativo)
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]incompatible_make_thinlto_command_lines_standalone
: "true" -
Si es verdadero, Bazel no reutilizará las líneas de comandos de acciones de vínculos 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
,incompatible_change
- Valor predeterminado de
--[no]incompatible_remove_legacy_whole_archive
: "true" -
Si es verdadero, Bazel no vinculará las dependencias de la biblioteca como un archivo completo de forma predeterminada (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener instrucciones de migración).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_require_ctx_in_configure_features
predeterminado: "true"-
Si es verdadero, Bazel requerirá el parámetro "ctx" en cc_common.configure_features (consulta https://github.com/bazelbuild/bazel/issues/7793 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
-
Usa objetos compartidos de la interfaz si la cadena de herramientas lo admite. Actualmente, todas las cadenas de herramientas ELF admiten este parámetro de configuración.
Etiquetas:loading_and_analysis
,affects_outputs
,affects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Especifica la versión del SDK de iOS que se usará para compilar aplicaciones para iOS. Si no se especifica, usa la versión predeterminada del SDK de iOS de “xcode_version”.
Etiquetas:loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Especifica la versión del SDK de macOS que se usará para compilar aplicaciones para macOS. Si no se especifica, usa la versión predeterminada del SDK de macOS de "xcode_version".
Etiquetas:loses_incremental_state
--minimum_os_version=<a string>
predeterminado: Consulta la descripción-
Es la versión mínima del SO a la que se orienta tu compilación.
Etiquetas:loading_and_analysis
,affects_outputs
--platform_mappings=<a relative path>
predeterminado: ""-
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 ser relativo a la raíz del espacio de trabajo principal. El valor predeterminado es "platform_mappings" (un archivo directamente debajo de la raíz del espacio de trabajo).
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--platforms=<a build target label>
predeterminado: ""-
Las etiquetas de las reglas de la plataforma que describen las plataformas de destino para el comando actual.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--python2_path=<a string>
predeterminado: Consulta la descripción-
Obsoleto, no realiza ninguna acción. Se inhabilitó con `--incompatible_use_python_toolchains`.
Etiquetas:no_op
,deprecated
--python3_path=<a string>
predeterminado: Consulta la descripción-
Obsoleto, no realiza ninguna acción. Se inhabilitó con `--incompatible_use_python_toolchains`.
Etiquetas:no_op
,deprecated
--python_path=<a string>
predeterminado: Consulta la descripción-
Es la ruta de acceso absoluta del intérprete de Python invocado para ejecutar objetivos de Python en la plataforma de destino. Obsoleto; se inhabilitó con --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
--python_top=<a build target label>
predeterminado: Consulta la descripción-
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; se inhabilitó con --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
- Valor predeterminado de
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Especifica la versión del SDK de tvOS que se usará para compilar aplicaciones de tvOS. Si no se especifica, usa la versión predeterminada del SDK de tvOS de "xcode_version".
Etiquetas:loses_incremental_state
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Especifica la versión del SDK de watchOS que se usará para compilar aplicaciones para watchOS. Si no se especifica, usa la versión predeterminada del SDK de watchOS de "xcode_version".
Etiquetas:loses_incremental_state
--xcode_version=<a string>
predeterminado: Consulta la descripción-
Si se especifica, usa Xcode de la versión determinada para las acciones de compilación relevantes. Si no se especifica, usa la versión predeterminada del ejecutor de Xcode.
Etiquetas:loses_incremental_state
--xcode_version_config=<a build target label>
predeterminado: "@bazel_tools//tools/cpp:host_xcodes"-
Es la etiqueta de la regla xcode_config que se usará para seleccionar la versión de Xcode en la configuración de compilación.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Opciones que controlan el resultado del comando:
--[no]apple_generate_dsym
predeterminado: “false”-
Indica si se deben generar archivos de símbolos de depuración (.dSYM).
Etiquetas:affects_outputs
,action_command_lines
--[no]build
predeterminado: "true"-
Ejecuta la compilación. Este es el comportamiento habitual. Especificar --nobuild hace que la compilación se detenga antes de ejecutar las acciones de compilación y devuelva cero si las fases de carga y análisis del paquete se completaron correctamente. Este modo es útil para probar esas fases.
Etiquetas:execution
,affects_outputs
- Valor predeterminado de
--[no]build_runfile_links
: "true" -
Si es verdadero, compila bosques de symlinks de runfiles para todos los destinos. Si es falso, escríbelos solo cuando lo requiera una acción local, prueba o comando de ejecución.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]build_runfile_manifests
: "true" -
Si es verdadero, escribe manifiestos de archivos runfiles para todos los destinos. Si es falsa, omítelas. Las pruebas locales no se ejecutarán si es falso.
Etiquetas:affects_outputs
--[no]build_test_dwp
predeterminado: “false”-
Si está habilitado, cuando se compilen pruebas de C++ de forma estática y con Fission, el archivo .dwp para el objeto binario de prueba también se compilará automáticamente.
Etiquetas:loading_and_analysis
,affects_outputs
--cc_proto_library_header_suffixes=<comma-separated set of options>
predeterminado: “.pb.h”-
Establece los sufijos de los archivos de encabezado que crea una cc_proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated set of options>
predeterminado: ".pb.cc"-
Configura los sufijos de los archivos de origen que crea una cc_proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info
predeterminado: “false”-
Ejecuta acciones adicionales para versiones alternativas de la API de Java en una proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
- 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
,experimental
--[no]experimental_save_feature_state
predeterminado: “false”-
Guarda el estado de las funciones habilitadas y solicitadas como un resultado de la compilación.
Etiquetas:affects_outputs
,experimental
--[no]experimental_use_validation_aspect
predeterminado: “false”-
Indica si se deben ejecutar acciones de validación con el aspecto (para el paralelismo con las pruebas).
Etiquetas:execution
,affects_outputs
--fission=<a set of compilation modes>
predeterminado: “no”-
Especifica qué modos de compilación usan la fisión para las compilaciones y los vínculos de C++. Puede ser cualquier combinación de {'fastbuild', 'dbg', 'opt'} o los valores especiales "yes" para habilitar todos los modos y "no" para inhabilitarlos.
Etiquetas:loading_and_analysis
,action_command_lines
,affects_outputs
- Valor predeterminado de
--[no]incompatible_always_include_files_in_data
: "true" -
Si es verdadero, las reglas nativas agregan <code>DefaultInfo.files</code> de dependencias de datos a sus archivos de ejecución, lo que coincide con el comportamiento recomendado para las reglas de Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid).
Etiquetas:affects_outputs
,incompatible_change
- Valor predeterminado de
--[no]legacy_external_runfiles
: "true" -
Si es verdadero, compila bosques de symlinks de runfiles para repositorios externos en .runfiles/wsname/external/repo (además de .runfiles/repo).
Etiquetas:affects_outputs
--[no]objc_generate_linkmap
predeterminado: “false”- especifica si se debe generar un archivo de mapa de vínculos.
Etiquetas:affects_outputs
- Se acumulan
--output_groups=<comma-separated list of options>
usos múltiples -
Es una lista de nombres de grupos de salida separados por comas, cada uno de los cuales puede tener un prefijo de + o -. Un grupo con el prefijo + se agrega al conjunto predeterminado de grupos de salida, mientras que un grupo con el prefijo - se quita del conjunto predeterminado. Si al menos un grupo no tiene prefijo, se omite el conjunto predeterminado de grupos de salida. Por ejemplo, --output_groups=+foo,+bar compila la unión del conjunto predeterminado, foo y bar, mientras que --output_groups=foo,bar anula el conjunto predeterminado de modo que solo se compilen foo y bar.
Etiquetas:execution
,affects_outputs
--[no]run_validations
predeterminado: "true"- Determina si se deben ejecutar acciones de validación como parte de la compilación. Consulta https://bazel.build/extending/rules#validation_actions
Etiquetas:execution
,affects_outputs
- Valor predeterminado de
--[no]save_temps
: "falso" -
Si se establece, se guardarán los resultados temporales de gcc. Estos incluyen archivos .s (código de ensamblador), archivos .i (C procesado) y archivos .ii (C++ procesado).
Etiquetas:affects_outputs
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
- Se acumulan
--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 bien por el par nombre=valor, que establece el valor independientemente del entorno de invocación. Esta opción se puede usar varias veces. En el caso de las opciones que se proporcionan para la misma variable, se aplica la más reciente, y se acumulan las opciones para diferentes variables.
Etiquetas:action_command_lines
--android_cpu=<a string>
predeterminado: "armeabi-v7a"-
La CPU de destino de Android
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]android_databinding_use_androidx
predeterminado: "true"-
Genera archivos de vinculación de datos compatibles con AndroidX. Esto solo se usa con la vinculación de datos v2. Esta marca no realiza ninguna acción.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]android_databinding_use_v3_4_args
predeterminado: "true"-
Usa Android Databinding v2 con el argumento 3.4.0. Esta marca no realiza ninguna acción.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--android_dynamic_mode=<off, default or fully>
predeterminado: "off"- determina si las dependencias de C++ de las reglas de Android se vincularán de forma dinámica cuando un cc_binary no cree una biblioteca compartida de forma explícita. "default" significa que bazel elegirá si vincular de forma dinámica. "completamente" significa que todas las bibliotecas se vincularán de forma dinámica. "Desactivado" significa que todas las bibliotecas se vincularán en modo principalmente estático.
Etiquetas:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
predeterminado: "alphabetical"-
Establece el orden de los manifiestos que se pasan a la combinación de manifiestos para los objetos binarios de Android. ALPHABETICAL significa que los manifiestos se ordenan por ruta de acceso en relación con el execroot. ALPHABETICAL_BY_CONFIGURATION significa que los manifiestos se ordenan por rutas de acceso relativas al directorio de configuración dentro del directorio de salida. DEPENDENCY significa que los manifiestos se ordenan de modo que el manifiesto de cada biblioteca aparezca antes que los manifiestos de sus dependencias.
Etiquetas:action_command_lines
,execution
- Valor predeterminado de
--[no]android_resource_shrinking
: "falso" -
Habilita la reducción de recursos para los APKs de android_binary que usan ProGuard.
Etiquetas:affects_outputs
,loading_and_analysis
- Se acumulan varios usos de
--aspects=<comma-separated list of options>
- Es una lista de aspectos separados por comas que se aplicarán a los objetivos de nivel superior. En la lista, si el aspecto some_aspect especifica proveedores de aspectos obligatorios a través de required_aspect_providers, some_aspect se ejecutará después de cada aspecto que se mencionó antes en la lista de aspectos cuyos proveedores anunciados satisfacen los proveedores de aspectos obligatorios de some_aspect. Además, some_aspect se ejecutará después de todos sus aspectos obligatorios especificados por el atributo requires. Luego, some_aspect tendrá acceso a los valores de los proveedores de esos aspectos. <bzl-file-label>%<aspect_name>, por ejemplo, '//tools:my_def.bzl%my_aspect', donde "my_aspect" es un valor de nivel superior de un archivo tools/my_def.bzl
--[no]build_python_zip
predeterminado: "automático"-
Compilar un archivo ZIP ejecutable de Python; en Windows, desactívalo en otras plataformas
Etiquetas:affects_outputs
- Se acumulan varios usos de
--catalyst_cpus=<comma-separated list of options>
-
Es una lista de arquitecturas separadas por comas para las que se compilarán objetos binarios de Apple Catalyst.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Valor predeterminado de
--[no]collect_code_coverage
: "falso" -
Si se especifica, Bazel instrumentará el código (con instrumentación sin conexión siempre que sea posible) y recopilará información de cobertura durante las pruebas. Solo se verán afectadas las orientaciones que coincidan con --instrumentation_filter. Por lo general, esta opción no debe especificarse directamente, sino que se debe usar el comando "bazel coverage".
Etiquetas:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] predeterminado: "fastbuild"-
Especifica el modo en el que se compilará el objeto binario. Valores: "fastbuild", "dbg", "opt".
Etiquetas:affects_outputs
,action_command_lines
- Se acumulan varios usos de
--conlyopt=<a string>
-
Opción adicional para pasar a gcc cuando se compilan archivos de origen C.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--copt=<a string>
- Opciones adicionales para pasar a gcc.
Etiquetas:action_command_lines
,affects_outputs
--cpu=<a string>
predeterminado: ""-
CPU de destino.
Etiquetas:changes_inputs
,affects_outputs
--cs_fdo_absolute_path=<a string>
predeterminado: Consulta la descripción-
Usa la información del perfil de CSFDO para optimizar la compilación. Especifica el nombre de la ruta de acceso absoluta del archivo ZIP que contiene el archivo de perfil, un archivo de perfil LLVM sin procesar o indexado.
Etiquetas:affects_outputs
--cs_fdo_instrument=<a string>
predeterminado: Consulta la descripción-
Genera ejecutables con instrumentación de FDO sensible al contexto. Con el compilador Clang/LLVM, también acepta el nombre del directorio en el que se volcarán los archivos de perfil sin procesar durante el tiempo de ejecución.
Etiquetas:affects_outputs
--cs_fdo_profile=<a build target label>
predeterminado: Consulta la descripción-
El cs_fdo_profile que representa el perfil sensible al contexto que se usará para la optimización.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--cxxopt=<a string>
-
Opción adicional para pasar a gcc cuando se compilan archivos de origen C++.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--define=<a 'name=value' assignment>
-
Cada opción --define especifica una asignación para una variable de compilación.
Etiquetas:changes_inputs
,affects_outputs
--dynamic_mode=<off, default or fully>
predeterminado: "predeterminado"- determina si los objetos binarios de C++ se vincularán de forma dinámica. "default" significa que Bazel elegirá si vincular de forma dinámica. "completamente" significa que todas las bibliotecas se vincularán de forma dinámica. "Desactivado" significa que todas las bibliotecas se vincularán en modo principalmente estático.
Etiquetas:loading_and_analysis
,affects_outputs
- Valor predeterminado de
--[no]enable_fdo_profile_absolute_path
: "true" -
Si se establece, el uso de fdo_absolute_profile_path generará un error.
Etiquetas:affects_outputs
--[no]enable_runfiles
predeterminado: “auto”-
Habilita el árbol de symlinks de runfiles. De forma predeterminada, está desactivado en Windows y en otras plataformas.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--experimental_action_listener=<a build target label>
- dejó de estar disponible y se reemplazó por aspectos. Usa action_listener para adjuntar una extra_action a las acciones de compilación existentes.
Etiquetas:execution
,experimental
--[no]experimental_android_compress_java_resources
predeterminado: “false”-
Comprime los recursos de Java en los APKs
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_android_databinding_v2
predeterminado: "true"-
Usa Android Databinding v2. Esta marca no realiza ninguna acción.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_android_resource_shrinking
predeterminado: “false”-
Habilita la reducción de recursos para los APKs de android_binary que usan ProGuard.
Etiquetas:affects_outputs
,loading_and_analysis
- Valor predeterminado de
--[no]experimental_android_rewrite_dexes_with_rex
: "falso" -
Usa la herramienta rex para volver a escribir archivos dex.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_collect_code_coverage_for_generated_files
predeterminado: “false”-
Si se especifica, Bazel también generará información de cobertura recopilada para los archivos generados.
Etiquetas:affects_outputs
--[no]experimental_convenience_symlinks
predeterminado: "normal"-
Esta marca controla cómo se administrarán los symlinks de conveniencia (los symlinks que aparecen en el lugar de trabajo después de la compilación). Valores posibles: normal (predeterminado): Se creará o borrará cada tipo de symlink de conveniencia, según lo determine la compilación.
limpio: Todos los symlinks se borrarán incondicionalmente.
Ignorar: Los vínculos simbólicos se dejarán solos.
log_only: Genera mensajes de registro como si se pasara "normal", pero no realiza ninguna operación de sistema de archivos (útil para herramientas).
Ten en cuenta que solo se pueden ver afectados los symlinks cuyos nombres genera el valor actual de --symlink_prefix. Si cambia el prefijo, no se modificarán los symlinks preexistentes.
Etiquetas:affects_outputs
--[no]experimental_convenience_symlinks_bep_event
predeterminado: “false”-
Esta marca controla si publicaremos o no el evento de compilación ConvenienceSymlinksIdentified en BuildEventProtocol. Si el valor es verdadero, BuildEventProtocol tendrá una entrada para beneficenciaSymlinksIdentified, que enumerará todos los symlinks convenientes creados en su lugar de trabajo. Si es falso, la entrada convenienceSymlinksIdentified en BuildEventProtocol estará vacía.
Etiquetas:affects_outputs
--experimental_objc_fastbuild_options=<comma-separated list of options>
predeterminado: "-O0,-DDEBUG=1"-
Usa estas cadenas como opciones del compilador de objc fastbuild.
Etiquetas:action_command_lines
--[no]experimental_omitfp
predeterminado: “false”-
Si es verdadero, usa libunwind para el desenredo de pila y compila con -fomit-frame-pointer y -fasynchronous-unwind-tables.
Etiquetas:action_command_lines
,affects_outputs
,experimental
--experimental_output_paths=<off, content or strip>
predeterminado: "off"-
Indica qué modelo usar para el lugar en el que las reglas del árbol de resultados escriben sus resultados, en particular para compilaciones multiplataforma o con varias configuraciones. Esta función es muy experimental. Consulta https://github.com/bazelbuild/bazel/issues/6526 para obtener más información. Las acciones de Starlark pueden habilitar la asignación de rutas de acceso agregando la clave "supports-path-mapping" al diccionario "execution_requirements".
Etiquetas:loses_incremental_state
,bazel_internal_configuration
,affects_outputs
,execution
- Se acumulan varios usos de
--experimental_override_name_platform_in_output_dir=<a 'label=value' assignment>
-
Cada entrada debe tener el formato etiqueta=valor, en el que etiqueta hace referencia a una plataforma y valores es el nombre abreviado que se desea usar en la ruta de salida. Solo se usa cuando --experimental_platform_in_output_dir es verdadero. Tiene la prioridad de nombres más alta.
Etiquetas:affects_outputs
,experimental
--[no]experimental_platform_in_output_dir
predeterminado: “false”-
Si es verdadero, se usa un nombre corto para la plataforma de destino en el nombre del directorio de salida en lugar de la CPU. El esquema exacto es experimental y está sujeto a cambios: primero, en el caso poco frecuente de que la opción --platforms no tenga exactamente un valor, se usa un hash de la opción platforms. A continuación, si --experimental_override_name_platform_in_output_dir registró algún nombre corto para la plataforma actual, se usará ese nombre corto. Luego, si se establece --experimental_use_platforms_in_output_dir_legacy_heuristic, usa un nombre corto basado en la etiqueta de plataforma actual. Por último, se usa un hash de la opción de plataforma como último recurso.
Etiquetas:affects_outputs
,experimental
--[no]experimental_use_llvm_covmap
predeterminado: “false”-
Si se especifica, Bazel generará información del mapa de cobertura llvm-cov en lugar de gcov cuando collect_code_coverage esté habilitado.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic
predeterminado: "true"-
Usa esta marca solo como parte de una estrategia de migración o prueba sugerida. Ten en cuenta que la heurística tiene deficiencias conocidas y se recomienda migrar a depender solo de --experimental_override_name_platform_in_output_dir.
Etiquetas:affects_outputs
,experimental
--fat_apk_cpu=<comma-separated set of options>
predeterminado: "armeabi-v7a"-
Si configuras esta opción, se habilitan los APKs multiarquitectura, que contienen objetos binarios nativos para todas las arquitecturas de destino especificadas, p.ej., --fat_apk_cpu=x86,armeabi-v7a. Si se especifica esta marca, se ignora --android_cpu para las dependencias de las reglas android_binary.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]fat_apk_hwasan
predeterminado: “false”-
Indica si se deben crear divisiones HWASAN.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--fdo_instrument=<a string>
predeterminado: Consulta la descripción- Genera objetos binarios con instrumentación FDO. Con el compilador Clang/LLVM, también acepta el nombre del directorio en el que se volcarán los archivos de perfil sin procesar durante el tiempo de ejecución.
Etiquetas:affects_outputs
- Valor predeterminado de
--fdo_optimize=<a string>
: ver descripción -
Usa la información del perfil de FDO para optimizar la compilación. Especifica el nombre de un archivo ZIP que contenga un árbol de archivos .gcda, un archivo afdo que contenga un perfil automático o un archivo de perfil de LLVM. Esta marca también acepta archivos especificados como etiquetas (p.ej., `//foo/bar:file.afdo`; es posible que debas agregar una directiva `exports_files` al paquete correspondiente) y etiquetas que apunten a destinos de `fdo_profile`. La regla "fdo_profile" reemplazará esta marca.
Etiquetas:affects_outputs
--fdo_prefetch_hints=<a build target label>
predeterminado: Consulta la descripción-
Usa sugerencias de almacenamiento en caché para la carga previa.
Etiquetas:affects_outputs
--fdo_profile=<a build target label>
predeterminado: Consulta la descripción-
Es el fdo_profile que representa el perfil que se usará para la optimización.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--features=<a string>
-
Las funciones determinadas estarán habilitadas o inhabilitadas de forma predeterminada para los destinos compilados en la configuración de destino. Si especificas -<feature>, se inhabilitará la función. Los atributos negativos siempre anulan los positivos. Consulta también --host_features.
Etiquetas:changes_inputs
,affects_outputs
- Valor predeterminado de
--[no]force_pic
: "falso" -
Si está habilitado, todas las compilaciones de C++ producen código independiente de la posición ("-fPIC"), las vinculaciones prefieren las bibliotecas compiladas previamente de PIC en lugar de las bibliotecas que no son de PIC, y las vinculaciones producen ejecutables independientes de la posición ("-pie").
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan varios usos de
--host_action_env=<a 'name=value' assignment with an optional value part>
-
Especifica el conjunto de variables de entorno disponibles para las acciones con configuraciones de ejecución. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o bien por el par nombre=valor, que establece el valor independientemente del entorno de invocación. Esta opción se puede usar varias veces. En el caso de las opciones que se proporcionan para la misma variable, se aplica la más reciente, y se acumulan las opciones para diferentes variables.
Etiquetas:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
predeterminado: "opt"-
Especifica el modo en que se integrarán las herramientas usadas durante la compilación. Valores: "fastbuild", "dbg", "opt".
Etiquetas:affects_outputs
,action_command_lines
- Se acumulan varios usos de
--host_conlyopt=<a string>
-
Opción adicional para pasar al compilador de C cuando se compilan archivos de origen C (pero no C++) en las configuraciones de ejecución.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--host_copt=<a string>
-
Opciones adicionales para pasar al compilador C para herramientas compiladas en las configuraciones de ejecución.
Etiquetas:action_command_lines
,affects_outputs
--host_cpu=<a string>
predeterminado: ""-
La CPU del host.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan varios usos de
--host_cxxopt=<a string>
-
Opciones adicionales para pasar al compilador de C++ para herramientas compiladas en las configuraciones de ejecución.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--host_features=<a string>
-
Las funciones determinadas se habilitarán o inhabilitarán de forma predeterminada para los destinos compilados en la configuración de ejecución. Si especificas -<feature>, se inhabilitará la función. Los atributos negativos siempre anulan los positivos.
Etiquetas:changes_inputs
,affects_outputs
- 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
,affects_outputs
- Se acumulan varios usos de
--host_linkopt=<a string>
-
Opción adicional para pasar al vinculador cuando se vinculan herramientas en las configuraciones de ejecución.
Etiquetas:action_command_lines
,affects_outputs
- 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 compatible de macOS para los destinos de host. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
usos múltiples -
Opciones adicionales para pasar de forma selectiva al compilador C/C++ cuando se compilan ciertos archivos en las configuraciones de ejecución. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. En la que regex_filter representa una lista de patrones de expresiones regulares para incluir y excluir (consulta también --instrumentation_filter). option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe estar entre comillas con una barra diagonal inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos gcc de todos los archivos cc en //foo/, excepto bar.cc.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--host_swiftcopt=<a string>
usos múltiples -
Opciones adicionales para pasar a swiftc para herramientas de ejecución.
Etiquetas:action_command_lines
,affects_outputs
--[no]incompatible_auto_exec_groups
predeterminado: “false”-
Cuando se habilita, se crea automáticamente un grupo de ejecución para cada cadena de herramientas que usa una regla. Para que esto funcione, la regla debe especificar el parámetro "toolchain" en sus acciones. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/17134.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_merge_genfiles_directory
predeterminado: "true"-
Si es verdadero, el directorio genfiles se une al directorio bin.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_use_host_features
predeterminado: "true"-
Si es verdadero, usa --features solo para la configuración de destino y --host_features para la configuración de ejecución.
Etiquetas:changes_inputs
,affects_outputs
,incompatible_change
--[no]instrument_test_targets
predeterminado: “false”-
Cuando la cobertura está habilitada, especifica si se deben considerar las reglas de prueba de instrumentación. Cuando se establece, se instrumentan las reglas de prueba que incluye --instrumentation_filter. De lo contrario, las reglas de prueba siempre se excluyen de la instrumentación de cobertura.
Etiquetas:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
predeterminado: "-/javatests[/:],-/test/java[/:]"-
Cuando la cobertura esté habilitada, solo se instrumentarán las reglas con nombres incluidos en el filtro basado en regex especificado. En su lugar, se excluyen las reglas con el prefijo “-”. Ten en cuenta que solo se instrumentan las reglas que no son de prueba, a menos que se habilite --instrument_test_targets.
Etiquetas:affects_outputs
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Versión mínima de iOS compatible para los simuladores y dispositivos de destino. Si no se especifica, se usa "ios_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan
--ios_multi_cpus=<comma-separated list of options>
usos múltiples -
Es una lista de arquitecturas separadas por comas con las que se compila una ios_application. El resultado es un binario universal que contiene todas las arquitecturas especificadas.
Etiquetas:loses_incremental_state
,loading_and_analysis
--[no]legacy_whole_archive
predeterminado: "true"-
Obsoleto y sustituido por --incompatible_remove_legacy_whole_archive (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener más información). Cuando está activado, usa --whole-archive para las reglas cc_binary que tienen linkshared=True y linkstatic=True o “-static” en linkopts. Esto es solo para la retrocompatibilidad. Una mejor alternativa es usar alwayslink=1 cuando sea necesario.
Etiquetas:action_command_lines
,affects_outputs
,deprecated
- Se acumulan varios usos de
--linkopt=<a string>
- : Opción adicional para pasar a gcc cuando se realiza la vinculación.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--ltobackendopt=<a string>
usos múltiples -
Opción adicional para pasar al paso de backend de LTO (en --features=thin_lto).
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--ltoindexopt=<a string>
-
Opción adicional para pasar al paso de indexación de LTO (en --features=thin_lto).
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--macos_cpus=<comma-separated list of options>
-
Lista de arquitecturas separadas por comas para compilar objetos binarios de Apple macOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Versión mínima compatible de macOS para destinos. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
--memprof_profile=<a build target label>
predeterminado: Consulta la descripción-
Usa el perfil de memprof.
Etiquetas:affects_outputs
--[no]objc_debug_with_GLIBCXX
predeterminado: “false”-
Si se establece y el modo de compilación se establece en "dbg", define GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC y GLIBCPP_CONCEPT_CHECKS.
Etiquetas:action_command_lines
--[no]objc_enable_binary_stripping
predeterminado: “false”-
Determina si se deben borrar símbolos y códigos no entregados 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 varios usos de
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
-
Opciones adicionales para pasar de forma selectiva a gcc cuando se compilan ciertos archivos. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. En la que regex_filter representa una lista de patrones de expresiones regulares para incluir y excluir (consulta también --instrumentation_filter). option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, 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 de gcc de todos los archivos cc en //foo/, excepto bar.cc.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
-
Opciones adicionales para pasar de forma selectiva al backend de LTO (en --features=thin_lto) cuando se compilan ciertos objetos de backend. Esta opción se puede aprobar varias veces. Sintaxis: regex_filter@option_1,option_2,…,option_n. En la que regex_filter representa una lista de patrones de expresión regular para incluir y excluir. option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe estar entre comillas con una barra diagonal inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos del backend LTO de todos los archivos o en //foo/, excepto bar.o.
Etiquetas:action_command_lines
,affects_outputs
--platform_suffix=<a string>
predeterminado: Consulta la descripción-
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas:loses_incremental_state
,affects_outputs
,loading_and_analysis
- Valor predeterminado de
--propeller_optimize=<a build target label>
: ver descripción -
Usa la información del perfil de Propeller para optimizar el destino de compilación.Un perfil de Propeller debe constar de al menos uno de dos archivos: un perfil de cc y un perfil de ld. Esta marca acepta una etiqueta de compilación que debe hacer referencia a los archivos de entrada del perfil del propeler. Por ejemplo, el archivo BUILD que define la etiqueta, en a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)Es posible que se deba agregar una directiva exports_files al paquete correspondiente para que Bazel pueda ver estos archivos. La opción se debe usar de la siguiente manera: --propeller_optimize=//a/b:propeller_profile
Etiquetas:action_command_lines
,affects_outputs
--propeller_optimize_absolute_cc_profile=<a string>
predeterminado: Consulta la descripción-
Nombre de ruta de acceso absoluta del archivo cc_profile para compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
- Valor predeterminado de
--propeller_optimize_absolute_ld_profile=<a string>
: ver descripción -
Es el nombre de ruta de acceso absoluto del archivo ld_profile para las compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
--run_under=<a prefix in front of command>
predeterminado: Consulta la descripción-
Es el prefijo que se inserta antes de los ejecutables para los comandos "test" y "run". Si el valor es "foo -bar" y la línea de comandos de ejecución es "test_binary -baz", la línea de comandos final es "foo -bar test_binary -baz".Esto también puede ser una etiqueta para un destino ejecutable. Algunos ejemplos son: "valgrind", "strace", "strace -c", "valgrind --quiet --num-callers=20", "//package:target", "//package:target --options".
Etiquetas:action_command_lines
-
Si es verdadero, las bibliotecas nativas que contienen funcionalidad idéntica se compartirán entre diferentes destinos.
Etiquetas:loading_and_analysis
,affects_outputs
- Valor predeterminado de
--[no]stamp
: "falso" -
Marca los objetos binarios con la fecha, el nombre de usuario, el nombre de host, la información del espacio de trabajo, etcétera.
Etiquetas:affects_outputs
- Valor predeterminado de
--strip=<always, sometimes or never>
: “sometimes” - especifica si se deben quitar los objetos binarios y las bibliotecas compartidas (con "-Wl,--strip-debug"). El valor predeterminado de "sometimes" significa quitar si --compilation_mode=fastbuild.
Etiquetas:affects_outputs
- Se acumulan
--stripopt=<a string>
usos múltiples -
Opciones adicionales para pasar a la eliminación cuando se genera un objeto binario “<name>.stripped”.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--swiftcopt=<a string>
-
Opciones adicionales para pasar a la compilación de Swift.
Etiquetas:action_command_lines
- Valor predeterminado de
--symlink_prefix=<a string>
: ver descripción -
Es 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 "/" dejará de estar disponible pronto. En su lugar, usa --experimental_convenience_symlinks=ignore.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--tvos_cpus=<comma-separated list of options>
-
Es una lista separada por comas de las arquitecturas para las que se compilarán los objetos binarios de Apple tvOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Valor predeterminado de
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima compatible de tvOS para los simuladores y dispositivos de destino. Si no se especifica, se usa "tvos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan varios usos de
--visionos_cpus=<comma-separated list of options>
-
Lista de arquitecturas separadas por comas para compilar objetos binarios de VisionOS de Apple.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Se acumulan
--watchos_cpus=<comma-separated list of options>
usos múltiples -
Es una lista separada por comas de las arquitecturas para las que se compilarán los objetos binarios de Apple watchOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Valor predeterminado de
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima compatible de watchOS para los simuladores y dispositivos de destino. Si no se especifica, se usa "watchos_sdk_version".
Etiquetas:loses_incremental_state
- Valor predeterminado de
--xbinary_fdo=<a build target label>
: ver descripción -
Usa la información del perfil de XbinaryFDO para optimizar la compilación. Especifica el nombre del perfil 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 rigurosidad 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 environment_group que se usará para asignar automáticamente los valores de CPU a los valores de target_environment.
Etiquetas:changes_inputs
,loading_and_analysis
,experimental
--[no]check_licenses
predeterminado: “false”-
Verifica que las restricciones de licencias que imponen los paquetes dependientes no entren en conflicto con los modos de distribución de los destinos que se compilan. De forma predeterminada, las licencias no están marcadas.
Etiquetas:build_file_semantics
--[no]check_visibility
predeterminado: "true"-
Si se inhabilita, los errores de visibilidad en las dependencias de destino se degradan a advertencias.
Etiquetas:build_file_semantics
--[no]desugar_for_android
predeterminado: "true"-
Determina si se debe expandir la sintaxis del código de bytes de Java 8 antes de la conversión a DEX.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]desugar_java8_libs
predeterminado: “false”-
Indica si se deben incluir bibliotecas Java 8 compatibles en apps para dispositivos heredados.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]enforce_constraints
predeterminado: "true"-
Verifica los entornos con los que es compatible cada objetivo y, luego, informa errores si alguno tiene dependencias que no admiten los mismos entornos.
Etiquetas:build_file_semantics
--[no]experimental_check_desugar_deps
predeterminado: "true"-
Determina si se debe volver a verificar la expansión correcta a nivel binario de Android.
Etiquetas:eagerness_to_exit
,loading_and_analysis
,experimental
--experimental_import_deps_checking=<off, warning or error>
predeterminado: “OFF”-
Cuando esté habilitada, verifica si las dependencias de una aar_import están completas. Esta aplicación forzosa puede interrumpir la compilación o generar advertencias.
Etiquetas:loading_and_analysis
- Configuración predeterminada de
--experimental_one_version_enforcement=<off, warning or error>
: "DESACTIVADA" -
Cuando se habilita, aplica que una regla java_binary no pueda contener más de una versión del mismo archivo de clase en la ruta de clase. Esta aplicación forzosa puede interrumpir 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, verifica que un destino de Java declare de forma explícita todos los destinos utilizados directamente como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files
predeterminado: “false”-
Si se habilita, verifica solo prueba para los destinos de requisitos previos que son archivos de salida. Para ello, busca la regla de generación solo de prueba. Esto coincide con la verificación de visibilidad.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_check_visibility_for_toolchains
predeterminado: “false”-
Si está habilitada, la verificación de visibilidad también se aplica a las implementaciones de la cadena de herramientas.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_disable_native_android_rules
predeterminado: “false”-
Si se habilita, se inhabilita el uso directo de las reglas nativas de Android. Usa las reglas de Android de Starlark de https://github.com/bazelbuild/rules_android.
Etiquetas:eagerness_to_exit
,incompatible_change
--[no]incompatible_disable_native_apple_binary_rule
predeterminado: “false”-
No-op. Se mantiene aquí para brindar retrocompatibilidad.
Etiquetas:eagerness_to_exit
,incompatible_change
--[no]incompatible_python_disable_py2
predeterminado: "true"-
Si es verdadero, usar la configuración de Python 2 provocará un error. Esto incluye python_version=PY2, srcs_version=PY2 y srcs_version=PY2ONLY. Consulta https://github.com/bazelbuild/bazel/issues/15684 para obtener más información.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_validate_top_level_header_inclusions
predeterminado: "true"-
Si es verdadero, Bazel también validará las inclusiones de encabezados de directorio de nivel superior (consulta https://github.com/bazelbuild/bazel/issues/10047 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]one_version_enforcement_on_java_tests
predeterminado: "true"-
Cuando se habilita, y con experimental_one_version_enforcement configurado en un valor que no es NONE, se aplica una versión en los destinos java_test. Esta marca se puede inhabilitar para mejorar el rendimiento de las pruebas incrementales a costa de perder posibles incumplimientos de una versión.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--python_native_rules_allowlist=<a build target label>
: ver descripción -
Es una lista de entidades permitidas (objetivo de package_group) que se usará cuando se aplique --incompatible_python_disallow_native_rules.
Etiquetas:loading_and_analysis
--[no]strict_filesets
predeterminado: “false”-
Si esta opción está habilitada, los conjuntos de archivos que cruzan los límites de los paquetes se informan como errores.
Etiquetas:build_file_semantics
,eagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default>
predeterminado: "error"-
A menos que esté DESACTIVADA, comprueba que un objetivo proto_library declare de forma explícita todos los objetivos usados directamente como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
--strict_public_imports=<off, warn, error, strict or default>
predeterminado: "off"-
A menos que esté desactivado, comprueba que un objetivo de proto_library declare de forma explícita todos los objetivos que se usan en "import public" como exportados.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
--[no]strict_system_includes
predeterminado: “false”-
Si es verdadero, también se deben declarar los encabezados que se encuentran a través de las rutas de inclusión del sistema (-isystem).
Etiquetas:loading_and_analysis
,eagerness_to_exit
- Se acumulan varios usos de
--target_environment=<a build target label>
-
Declara el entorno de destino de esta compilación. Debe ser una referencia de etiqueta a una regla del "entorno". Si se especifican, todos los objetivos de nivel superior deben ser compatibles con este entorno.
Etiquetas:changes_inputs
- Opciones que afectan los resultados de firma de una compilación:
--apk_signing_method=<v1, v2, v1_v2 or v4>
predeterminado: “v1_v2”-
Implementación que se usará para firmar APKs
Etiquetas:action_command_lines
,affects_outputs
,loading_and_analysis
- Valor predeterminado de
--[no]device_debug_entitlements
: "true" -
Si se establece y el modo de compilación no es "opt", las apps de objc incluirán derechos de depuración cuando se firmen.
Etiquetas:changes_inputs
--ios_signing_cert_name=<a string>
predeterminado: Consulta la descripción-
Nombre del certificado que se usará para la firma de iOS. Si no se establece, se usará el perfil de aprovisionamiento. Puede ser la preferencia de identidad del llavero del certificado o la substring del nombre común del certificado, según la página de man de codesign (IDENTIDADES DE FIRMA).
Etiquetas:action_command_lines
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility
predeterminado: “false”-
Si incompatible_enforce_config_setting_visibility=false, esto es una operación no realizada. De lo contrario, si esta marca es falsa, cualquier config_setting sin un atributo de visibilidad explícito es //visibility:public. Si esta marca es verdadera, config_setting sigue la misma lógica de visibilidad que todas las demás reglas. Consulta https://github.com/bazelbuild/bazel/issues/12933.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_legacy_py_provider
predeterminado: "true"-
No-ops; se quitará pronto.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_sdk_frameworks_attributes
predeterminado: “false”-
Si es verdadero, no se permiten los atributos sdk_frameworks y weak_sdk_frameworks en objc_library y objc_import.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
predeterminado: "true"-
Si es verdadero, aplica las restricciones de visibilidad config_setting. Si es falso, todos los config_setting son visibles para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_objc_alwayslink_by_default
predeterminado: “false”-
Si es verdadero, establece el valor predeterminado como verdadero para los atributos alwayslink en objc_library y objc_import.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_python_disallow_native_rules
predeterminado: “false”-
Cuando es verdadero, se produce un error cuando se usan las reglas py_* integradas. En su lugar, se deben usar las reglas rule_python. Consulta https://github.com/bazelbuild/bazel/issues/17773 para obtener más información y las instrucciones de migración.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones que rigen el comportamiento del entorno de prueba o del ejecutor de pruebas:
- Valor predeterminado de
--[no]allow_analysis_failures
: "falso" -
Si es verdadero, una falla de análisis de un objetivo de regla genera la propagación del objetivo de una instancia de AnalysisFailureInfo que contiene la descripción del error, en lugar de generar una falla de compilación.
Etiquetas:loading_and_analysis
,experimental
--analysis_testing_deps_limit=<an integer>
predeterminado: “2000”-
Establece la cantidad máxima de dependencias transitivas mediante un atributo de regla con una transición de configuración for_analysis_testing. Si se supera este límite, se mostrará un error de regla.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]break_build_on_parallel_dex2oat_failure
: "falso" -
Si es verdadero, las fallas de la acción de dex2oat causarán que la compilación falle en lugar de ejecutar dex2oat durante el tiempo de ejecución de la prueba.
Etiquetas:loading_and_analysis
,experimental
--[no]check_tests_up_to_date
predeterminado: “false”-
No ejecutes pruebas, solo verifica que estén actualizadas. Si todos los resultados de las pruebas están actualizados, la prueba se completa correctamente. Si se debe compilar o ejecutar alguna prueba, se informa un error y la prueba falla. Esta opción implica el comportamiento de --check_up_to_date.
Etiquetas:execution
- Se acumulan varios usos de
--default_test_resources=<a resource name followed by equal and 1 float or 4 float, e.g. memory=10,30,60,100>
- Anula la cantidad de recursos predeterminados para las pruebas. El formato esperado es <resource>=<value>. Si se especifica un solo número positivo como <value>, se anularán los recursos predeterminados para todos los tamaños de prueba. Si se especifican 4 números separados por comas, estos anularán 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., memory=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.
--[no]experimental_android_use_parallel_dex2oat
predeterminado: “false”-
Usa dex2oat en paralelo para acelerar la ejecución de android_test.
Etiquetas:loading_and_analysis
,host_machine_resource_optimizations
,experimental
- Se acumulan varios usos de
--flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once>
-
Cada prueba se reintentará hasta la cantidad especificada de veces en caso de que falle. Las pruebas que 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 normales y tres para las pruebas marcadas explícitamente como inestables por su regla (atributo flaky=1). 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 corrige todas las pruebas en //foo/, excepto las que se encuentran en foo/bar, tres veces. Esta opción se puede pasar varias veces. El argumento pasado más recientemente que coincida tiene prioridad. Si no hay coincidencias, el comportamiento es como el de "default" anterior.
Etiquetas:execution
--[no]ios_memleaks
predeterminado: “false”-
Habilita la verificación de fugas de memoria en los destinos de ios_test.
Etiquetas:action_command_lines
- Valor predeterminado de
--ios_simulator_device=<a string>
: ver descripción -
Es el dispositivo que se simula cuando se ejecuta una aplicación para iOS en el simulador, p.ej., "iPhone 6". Para obtener una lista de dispositivos, ejecuta "xcrun simctl list devicetypes" en la máquina en la que se ejecutará el simulador.
Etiquetas:test_runner
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Es la versión de iOS que se ejecutará en el simulador durante la ejecución o las pruebas. Esto se ignora para las reglas ios_test si se especifica un dispositivo de destino en la regla.
Etiquetas:test_runner
--local_test_jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
predeterminado: “auto”-
La cantidad máxima de trabajos de prueba locales que se ejecutarán de forma simultánea. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5" 0 significa que los recursos locales limitarán la cantidad de trabajos de prueba locales que se ejecutarán simultáneamente. Establecer este valor por encima del valor de --jobs no es eficaz.
Etiquetas:execution
- Se acumulan varios usos de
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
- especifica la cantidad de veces que se debe ejecutar cada prueba. Si alguno de esos intentos falla por algún motivo, se considera que toda la prueba falló. Por lo general, el valor especificado es solo un número entero. Ejemplo: --runs_per_test=3 ejecutará todas las pruebas 3 veces. Sintaxis alternativa: regex_filter@runs_per_test. En la que runs_per_test representa un valor entero y regex_filter representa una lista de patrones de expresiones regulares para incluir y excluir (consulta también --instrumentation_filter). Ejemplo: --runs_per_test=//foo/.*,-//foo/bar/.*@3 ejecuta todas las pruebas en //foo/, excepto las que se encuentran en foo/bar, tres veces. Esta opción se puede pasar varias veces. El argumento pasado más recientemente que coincida tiene prioridad. Si no hay coincidencias, la prueba solo se ejecuta una vez.
- Se acumulan varios usos de
--test_env=<a 'name=value' assignment with an optional value part>
-
Especifica variables de entorno adicionales que se insertarán en el entorno del ejecutor de pruebas. Las variables 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 varias variables. Solo lo usa el comando "bazel test".
Etiquetas:test_runner
--[no]test_keep_going
predeterminado: "true"-
Cuando se inhabilita, cualquier prueba que no se apruebe hará que se detenga toda la compilación. De forma predeterminada, se ejecutan todas las pruebas, incluso si algunas no se aprueban.
Etiquetas:execution
--test_strategy=<a string>
predeterminado: ""-
Especifica qué estrategia usar cuando se ejecutan pruebas.
Etiquetas:execution
- Valor predeterminado de
--test_timeout=<a single integer or comma-separated list of 4 integers>
: "-1" - Anula los valores predeterminados de tiempo de espera de prueba para los tiempos de espera de prueba (en segundos). Si se especifica un solo valor de número entero positivo, se anularán todas las categorías. Si se especifican 4 números enteros separados por comas, se anularán los tiempos de espera 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.
--test_tmpdir=<a path>
predeterminado: Consulta la descripción- Especifica el directorio temporal base que usará "bazel test".
--[no]zip_undeclared_test_outputs
predeterminado: "true"-
Si es verdadero, los resultados de las pruebas no declaradas se archivarán en un archivo ZIP.
Etiquetas:test_runner
- Opciones que activan optimizaciones del tiempo de compilación:
--cache_computed_file_digests=<a long integer>
predeterminado: “50000”- Si es mayor que 0, configura Bazel para almacenar en caché los resúmenes de archivos en la memoria según sus metadatos, en lugar de volver a calcular los resúmenes desde el disco cada vez que se necesiten. Si estableces este valor en 0, se garantiza la exactitud, ya que no todos los cambios de archivo se pueden observar en los metadatos. 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é.
--[no]experimental_filter_library_jar_with_program_jar
predeterminado: “false”-
Filtra ProgramJar de ProGuard para quitar las clases que también estén presentes en el LibraryJar.
Etiquetas:action_command_lines
--[no]experimental_inmemory_dotd_files
predeterminado: "true"-
Si se habilita, los archivos .d de C++ se pasarán 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
,experimental
- Valor predeterminado de
--[no]experimental_inmemory_jdeps_files
: "true" -
Si está habilitado, los archivos de dependencia (.jdeps) generados a partir de compilaciones de Java se pasarán en la memoria directamente desde los nodos de compilación remotos en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_objc_include_scanning
predeterminado: “false”-
Indica si se debe realizar un análisis para C/C++ objetivo.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
--[no]experimental_retain_test_configuration_across_testonly
predeterminado: “false”-
Cuando se habilita, --trim_test_configuration no recortará la configuración de prueba de las reglas marcadas como testonly=1. 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
,loses_incremental_state
--[no]experimental_starlark_cc_import
predeterminado: “false”-
Si está habilitada, se puede usar la versión de Starlark de cc_import.
Etiquetas:loading_and_analysis
,experimental
- Valor predeterminado de
--[no]experimental_unsupported_and_brittle_include_scanning
: "falso" -
Determina si se deben reducir las entradas a la compilación de C/C++ a través del análisis de líneas #include de los archivos de entrada. Esto puede mejorar el rendimiento y la incrementalidad, ya que reduce el tamaño de los árboles de entrada de compilación. Sin embargo, también puede interrumpir las compilaciones porque el escáner de inclusión no implementa por completo la semántica del preprocesador C. En particular, no comprende las directivas #include dinámicas y omite la lógica condicional del preprocesador. Úsala bajo tu propia responsabilidad. Se cerrarán todos los problemas relacionados con esta marca que se hayan presentado.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
--[no]incremental_dexing
predeterminado: "true"-
Realiza la mayor parte del trabajo de dexing por separado para cada archivo JAR.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>
predeterminado: "HOST_CPUS"-
Establece de forma explícita la cantidad total de núcleos de CPU locales disponibles para que Bazel los destine a las acciones de compilación que se ejecutan de forma local. Toma un número entero o "HOST_CPUS", 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. Recibe un par de cadena-número de punto flotante. Se puede usar varias veces para especificar varios tipos de recursos adicionales. Bazel limitará las acciones que se ejecutan de forma simultánea según los recursos adicionales disponibles y los recursos adicionales necesarios. Las pruebas pueden declarar la cantidad de recursos adicionales que necesitan con una etiqueta con el formato "resources:<resoucename>:<amount>". La CPU, la RAM y los recursos disponibles no se pueden configurar con esta marca.
Etiquetas:host_machine_resource_optimizations
--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 que Bazel la invierta en acciones de compilación que se ejecuten de forma local. Toma un número entero o "HOST_RAM", opcionalmente seguido de [-|*]<float> (p. ej., HOST_RAM*.5 para usar la mitad de la RAM disponible). De forma predeterminada, ("HOST_RAM*.67"), Bazel consultará la configuración del sistema para estimar la cantidad de RAM disponible y utilizará el 67% de esta.
Etiquetas:host_machine_resource_optimizations
- Se acumulan varios usos de
--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">
-
Establece la cantidad de recursos disponibles para Bazel. Recibe una asignación a un número de punto flotante o HOST_RAM/HOST_CPUS, de forma opcional, seguida de [-|*]<número de punto flotante> (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 una etiqueta con el formato "resources:<resource name>:<amount>". Anula los recursos especificados por --local_{cpu|ram|extra}_resources.
Etiquetas:host_machine_resource_optimizations
--[no]objc_use_dotd_pruning
predeterminado: "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
,loading_and_analysis
- Valor predeterminado de
--[no]process_headers_in_dependencies
: "falso" -
Cuando compilas un destino //a:a, procesa los encabezados en todos los destinos de los que depende //a:a (si el procesamiento de encabezados está habilitado para la cadena de herramientas).
Etiquetas:execution
--[no]trim_test_configuration
predeterminado: "true"-
Cuando se habilita, se borran las opciones relacionadas con las pruebas debajo del nivel superior de la compilación. Cuando esta marca está activa, las pruebas no se pueden compilar como dependencias de reglas que no son de prueba, pero los cambios en las opciones relacionadas con las pruebas no harán que se vuelvan a analizar las reglas que no son de prueba.
Etiquetas:loading_and_analysis
,loses_incremental_state
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_bep_target_summary
predeterminado: “false”- Determina si se deben publicar eventos TargetSummary.
--[no]experimental_build_event_expand_filesets
predeterminado: “false”-
Si es verdadero, expande los conjuntos de archivos en el BEP cuando se presenten los archivos de salida.
Etiquetas:affects_outputs
--[no]experimental_build_event_fully_resolve_fileset_symlinks
predeterminado: “false”-
Si es verdadero, resuelve completamente los symlinks de conjuntos de archivos relativos en el BEP cuando se presentan archivos de salida. Requiere --experimental_build_event_expand_filesets.
Etiquetas:affects_outputs
--experimental_build_event_upload_max_retries=<an integer>
predeterminado: “4”-
Es la cantidad máxima de veces que Bazel debe volver a intentar subir un evento de compilación.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
: "1s" -
Retraso inicial mínimo 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 artefactos a los que se hace referencia en el protocolo del evento de compilación.
Etiquetas:affects_outputs
--[no]experimental_materialize_param_files_directly
predeterminado: “false”-
Si materializas archivos de parámetros, hazlo con operaciones de escritura directa en el disco.
Etiquetas:execution
- Valor predeterminado de
--[no]experimental_run_bep_event_include_residue
: "falso" -
Indica si se debe incluir el residuo de la línea de comandos en los eventos de compilación de ejecución que podrían contener el residuo. De forma predeterminada, el 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" -
El archivo de registro de transmisión se sube directamente al almacenamiento remoto en lugar de escribirlo en el disco.
Etiquetas:affects_outputs
--explain=<a path>
predeterminado: Consulta la descripción-
Hace que el sistema de compilación explique cada paso ejecutado de la compilación. La explicación se escribe en el archivo de registro especificado.
Etiquetas:affects_outputs
--[no]legacy_important_outputs
predeterminado: "true"-
Usa esto para suprimir la generación del campo important_outputs heredado en el evento TargetComplete. important_outputs es obligatorio para la integración de Bazel en ResultStore.
Etiquetas:affects_outputs
- 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 acciones remotas. Es útil cuando se depuran acciones. Esto está implícito en --subcomandos y --verbose_failures.
Etiquetas:execution
--max_config_changes_to_show=<an integer>
predeterminado: “3”-
Cuando se descarta la caché de análisis debido a un cambio en las opciones de compilación, se muestra 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 de registro por prueba que se puede emitir cuando --test_output es "errors" o "all". Es útil para evitar que el resultado se vea abrumado por un resultado de prueba con demasiado ruido. El encabezado de prueba se incluye en el tamaño del registro. Los valores negativos implican que no hay límite. El resultado es todo o nada.
Etiquetas:test_runner
,terminal_output
,execution
- Valor predeterminado de
--output_filter=<a valid Java regular expression>
: ver descripción -
Solo muestra advertencias y resultados de acciones para reglas con un nombre que coincida con la expresión regular proporcionada.
Etiquetas:affects_outputs
--progress_report_interval=<an integer in 0-3600 range>
predeterminado: “0”-
Es la cantidad de segundos que se debe esperar entre 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 de 30 segundos y, después de ese progreso, se informará una vez por minuto. Cuando se habilita --curses, el progreso se informa cada segundo.
Etiquetas:affects_outputs
--show_result=<an integer>
predeterminado: “1”-
Muestra los resultados de la compilación. Para cada objetivo, indica si se actualizó o no y, de ser así, una lista de los archivos de salida que se compilaron. Los archivos impresos son cadenas convenientes para copiar y pegar en la shell y ejecutarlas.
Esta opción requiere un argumento de número entero, que es la cantidad de objetivos de umbral por encima de la cual no se imprime la información de los resultados. Por lo tanto, cero causa la supresión del mensaje y MAX_INT hace que la impresión del resultado siempre se produzca. El valor predeterminado es uno.
Si no se compiló nada para un 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 ejecutados durante una compilación. Marcas relacionadas: --execution_log_json_file, --execution_log_binary_file (para registrar subcomandos en un archivo en un formato compatible con herramientas)
Etiquetas:terminal_output
--test_output=<summary, errors, all or streamed>
predeterminado: "summary"-
Especifica el modo de salida deseado. Los valores válidos son "summary" para mostrar solo el resumen del estado de la prueba, "errors" para imprimir también los registros de prueba de las pruebas fallidas, "all" para imprimir los registros de todas las pruebas y "streamed" para mostrar los registros de todas las pruebas en tiempo real (esto forzará que las pruebas se ejecuten de forma local de a una a la vez, independientemente del valor de --test_strategy).
Etiquetas:test_runner
,terminal_output
,execution
- Valor predeterminado de
--test_summary=<short, terse, detailed, none or testcase>
: “short” -
Especifica el formato deseado del resumen de la prueba. Los valores válidos son "short" para imprimir información solo sobre las pruebas ejecutadas, "terse" para imprimir información solo sobre las pruebas que no se ejecutaron correctamente, "detailed" para imprimir información detallada sobre los casos de prueba fallidos, "testcase" para imprimir el resumen en la resolución de casos de prueba, no imprimir información detallada sobre los casos de prueba fallidos y "none" para omitir el resumen.
Etiquetas:terminal_output
- Valor predeterminado de
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: “-.*” -
Imprime información de depuración durante la resolución de la cadena de herramientas. La marca toma una regex, que se compara con los tipos de cadena de herramientas y los objetivos específicos para ver cuál depurar. 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 expertos en la resolución de cadenas de herramientas.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]verbose_explanations
: "falso" -
Aumenta el nivel de detalle de las explicaciones emitidas si se habilita --explain. No tiene efecto si --explain no está habilitada.
Etiquetas:affects_outputs
--[no]verbose_failures
predeterminado: “false”-
Si un comando falla, imprime la línea de comandos completa.
Etiquetas:terminal_output
- Son opciones que especifican o alteran una entrada genérica en un comando de Bazel que no pertenece a otras categorías.:
- Se acumulan varios usos de
--aspects_parameters=<a 'name=value' assignment>
-
Especifica los valores de los parámetros de aspectos de la línea de comandos. Cada valor de parámetro se especifica mediante <param_name>=<param_value>, por ejemplo, "my_param=my_val", en la que "my_param" es un parámetro de algún aspecto en la lista --aspects o que es obligatorio para un aspecto de la lista. Esta opción se puede usar varias veces. Sin embargo, no se permite asignar valores al mismo parámetro más de una vez.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--flag_alias=<a 'name=value' flag alias>
-
Establece un nombre abreviado para una marca de Starlark. Toma un solo par clave-valor en el formato "<clave>=<valor>" como argumento.
Etiquetas:changes_inputs
--[no]incompatible_default_to_explicit_init_py
predeterminado: “false”-
Esta marca cambia el comportamiento predeterminado para que los archivos __init__.py ya no se creen automáticamente en los archivos de ejecución de los destinos de Python. Específicamente, cuando un objetivo py_binary o py_test tiene legacy_create_init establecido en "auto" (el valor predeterminado), se considera falso solo si se establece esta marca. Consulta https://github.com/bazelbuild/bazel/issues/10076.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_py2_outputs_are_suffixed
predeterminado: "true"-
Si es verdadero, los destinos compilados en la configuración de Python 2 aparecerán en una raíz de salida que incluye el sufijo “-py2”, mientras que los destinos compilados para Python 3 aparecerán en una raíz sin sufijo relacionado con Python. Esto significa que el symlink de conveniencia "bazel-bin" apuntará a destinos de Python 3 en lugar de Python 2. Si habilitas esta opción, también se recomienda habilitar “--incompatible_py3_is_default”.
Etiquetas:affects_outputs
,incompatible_change
- Valor predeterminado de
--[no]incompatible_py3_is_default
: "true" -
Si es verdadero, los destinos "py_binary" y "py_test" que no establezcan su atributo "python_version" (o "default_python_version") usarán PY3 de forma predeterminada en lugar de PY2. Si configuras esta marca, también se recomienda establecer `--incompatible_py2_outputs_are_suffixed`.
Etiquetas:loading_and_analysis
,affects_outputs
,incompatible_change
- Valor predeterminado de
--[no]incompatible_use_python_toolchains
: "true" -
Si se establece como verdadero, las reglas ejecutables de Python nativas usarán el entorno de ejecución de Python especificado por la cadena de herramientas de Python, en lugar del entorno de ejecución que proporcionan las marcas heredadas, como --python_top.
Etiquetas:loading_and_analysis
,incompatible_change
--python_version=<PY2 or PY3>
predeterminado: Consulta la descripción-
Es el modo de versión principal de Python, ya sea "PY2" o "PY3". Ten en cuenta que esto se anula con los destinos "py_binary" y "py_test" (incluso si no especifican una versión de forma explícita), por lo que, por lo general, no hay muchos motivos para proporcionar esta marca.
Etiquetas:loading_and_analysis
,affects_outputs
--target_pattern_file=<a string>
predeterminado: ""-
Si se establece, la compilación leerá patrones del archivo que se nombra aquí, en lugar de la línea de comandos. Es un error especificar un archivo aquí, así como patrones de línea de comandos.
Etiquetas:changes_inputs
- Opciones de almacenamiento en caché y ejecución remotas:
--experimental_remote_cache_eviction_retries=<an integer>
predeterminado: “0”-
La cantidad máxima de intentos para reintentar si la compilación encontró un error transitorio de caché remota que, de lo contrario, la compilación fallaría. Se aplica, por ejemplo, cuando los artefactos se desalojan de la caché remota o en ciertas condiciones de falla de la caché. Un valor distinto de cero establecerá implícitamente --incompatible_remote_use_new_exit_code_for_lost_inputs como verdadero. Se generará un nuevo ID de invocación para cada intento. Si generas un ID de invocación y se lo proporcionas a Bazel con --invocation_id, no debes usar esta marca. En su lugar, establece la marca --incompatible_remote_use_new_exit_code_for_lost_inputs y busca el código de salida 39.
Etiquetas:execution
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
predeterminado: "true"-
Si se establece como verdadero, Bazel usará el nuevo código de salida 39 en lugar de 34 si los errores de caché remota, incluidas las expulsiones de caché, hacen que falle la compilación.
Etiquetas:incompatible_change
- Opciones misceláneas que no se clasifican de otra manera:
--[no]allow_analysis_cache_discard
predeterminado: "true"-
Si se descarta la caché de análisis debido a un cambio en el sistema de compilación, configurar esta opción como falsa hará que bazel se cierre, en lugar de continuar con la compilación. Esta opción no tiene efecto cuando también se establece "discard_analysis_cache".
Etiquetas:eagerness_to_exit
--[no]build_manual_tests
predeterminado: “false”- Forza la compilación de los destinos de prueba etiquetados como "manual". Las pruebas "manuales" se excluyen del procesamiento. Esta opción los obliga a compilarse (pero no a ejecutarse).
--build_tag_filters=<comma-separated list of options>
predeterminado: ""- Especifica una lista de etiquetas separadas por comas. De manera opcional, cada etiqueta puede ir precedida por "-" para especificar las etiquetas excluidas. Solo se compilarán los destinos que contengan al menos una etiqueta incluida y no contengan ninguna etiqueta excluida. Esta opción no afecta el conjunto de pruebas que se ejecutan con el comando "test", ya que se rigen por las opciones de filtrado de pruebas, por ejemplo, "--test_tag_filters".
- 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
] predeterminado: "auto"- Si se configura como “auto”, Bazel vuelve a ejecutar una prueba solo si: (1) Bazel detecta cambios en la prueba o en sus dependencias; (2) la prueba se marcó como externa; (3) se solicitaron varias 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 se establece en "no", Bazel no almacena en caché ningún resultado de la 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 fuente en IDEs, por ejemplo, cuando se vuelve a compilar un solo destino que depende del archivo fuente para detectar errores lo antes posible en el ciclo de edición, compilación y prueba. Este argumento afecta la forma en que se interpretan todos los argumentos que no son de marca. En lugar de ser objetivos para compilar, son nombres de archivos de origen. Para cada nombre de archivo de origen, se compilará un destino arbitrario que depende de él.
- Se acumulan varios usos de
--deleted_packages=<comma-separated list of package names>
- 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 existente "x". Por ejemplo, después de borrar x/y/BUILD en tu cliente, es posible que el sistema de compilación se queje si encuentra una etiqueta "//x:y/z" si otra entrada de package_path aún la proporciona. Especificar --deleted_packages x/y evita este problema.
--[no]discard_analysis_cache
predeterminado: “false”- Descartar la caché de análisis inmediatamente después de que se complete la fase de análisis Reduce el uso de memoria en un 10% aproximadamente, pero ralentiza las compilaciones incrementales posteriores.
--execution_log_binary_file=<a path>
predeterminado: Consulta la descripción- Registra los generaciones ejecutadas en este archivo como protos SpawnExec delimitados por longitud, según src/main/protobuf/spawn.proto. Prefiere --execution_log_compact_file, que es significativamente más pequeño y económico de producir. Marcas relacionadas: --execution_log_compact_file (formato compacto; mutuamente excluyente), --execution_log_json_file (formato JSON de texto; mutuamente excluyente), --execution_log_sort (si se debe ordenar el registro de ejecución) y --subcommands (para mostrar subcomandos en el resultado de la terminal).
--execution_log_compact_file=<a path>
predeterminado: Consulta la descripción- Registra los inicios ejecutados en este archivo como protos de ExecLogEntry delimitados por longitud, según src/main/protobuf/spawn.proto. Todo el archivo está comprimido con zstd. Marcas relacionadas: --execution_log_binary_file (formato protobuf binario; mutuamente excluyente), --execution_log_json_file (formato JSON de texto; mutuamente excluyente), --subcommands (para mostrar subcomandos en el resultado de la terminal).
--execution_log_json_file=<a path>
predeterminado: Consulta la descripción- Registra los inicios ejecutados en este archivo como representaciones JSON delimitadas por saltos de línea de los protos de SpawnExec, según src/main/protobuf/spawn.proto. Prefiere --execution_log_compact_file, que es significativamente más pequeño y económico de producir. Marcas relacionadas: --execution_log_compact_file (formato compacto; mutuamente excluyente), --execution_log_binary_file (formato protobuf binario; mutuamente excluyente), --execution_log_sort (si se debe ordenar el registro de ejecución), --subcommands (para mostrar subcomandos en el resultado de la terminal).
--[no]execution_log_sort
predeterminado: "true"- Indica si se debe ordenar el registro de ejecución, lo que facilita la comparación de registros entre invocaciones. Se establece en "false" para evitar un uso potencialmente significativo de la CPU y la memoria al final de la invocación, a costa de producir el registro en un orden de ejecución no determinista. Solo se aplica a los formatos binario y JSON. El formato compacto nunca se ordena.
--[no]expand_test_suites
predeterminado: "true"-
Expande los objetivos de test_suite en sus pruebas constituyentes antes del análisis. Cuando esta marca esté activada (la opción predeterminada), se aplicarán patrones de destino negativos a las pruebas que pertenecen al paquete de pruebas; de lo contrario, no se aplicarán. Desactivar esta marca es útil cuando se aplican aspectos de nivel superior en la línea de comandos: luego, pueden analizar los destinos de test_suite.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]experimental_cancel_concurrent_tests
: "falso" -
Si es verdadero, Blaze cancelará las pruebas que se ejecutan de forma simultánea en la primera ejecución correcta. Esto solo es útil en combinación con --runs_per_test_detects_flakes.
Etiquetas:affects_outputs
,loading_and_analysis
- Valor predeterminado de
--experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "" - dejó de estar disponible y se reemplazó por aspectos. Filtra el conjunto de objetivos para los que se programarán las extra_actions.
--[no]experimental_extra_action_top_level_only
predeterminado: “false”- dejó de estar disponible y se reemplazó por aspectos. Solo programa extra_actions para los objetivos de nivel superior.
--[no]experimental_fetch_all_coverage_outputs
predeterminado: “false”-
Si es verdadero, Bazel recupera todo el directorio de datos de cobertura para cada prueba durante una ejecución de cobertura.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_generate_llvm_lcov
predeterminado: “false”-
Si es verdadero, la cobertura de clang generará un informe LCOV.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_j2objc_header_map
predeterminado: "true"- Determina si se debe generar un mapa de encabezado de J2ObjC en paralelo a la transpilación de J2ObjC.
--[no]experimental_j2objc_shorter_header_path
predeterminado: “false”-
Indica si se debe generar con una ruta de encabezado más corta (usa “_ios” en lugar de “_j2objc”).
Etiquetas:affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
predeterminado: "javabuilder"- Habilita classpaths reducidos para compilaciones de Java.
--[no]experimental_limit_android_lint_to_android_constrained_java
predeterminado: “false”-
Limita --experimental_run_android_lint_on_java_rules a bibliotecas compatibles con Android.
Etiquetas:affects_outputs
--[no]experimental_run_android_lint_on_java_rules
predeterminado: “false”-
Determina si se deben validar las fuentes java_*.
Etiquetas:affects_outputs
- 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 accidente desde las dependencias de TestRunner. Por el momento, solo funciona para bazel.
--[no]fetch
predeterminado: "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á.
--host_java_launcher=<a build target label>
predeterminado: Consulta la descripción- Es el selector de Java que usan las herramientas que se ejecutan durante una compilación.
- Se acumulan
--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 varios usos de
--host_jvmopt=<a string>
- Opciones adicionales para pasar a la VM de Java cuando se compilan herramientas que se ejecutan durante la compilación. Estas 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á en una prueba fragmentada si el ejecutor de pruebas no indica que admite el fragmentación tocando el archivo en la ruta de acceso en TEST_SHARD_STATUS_FILE. Si es falso, un ejecutor de pruebas que no admite la fragmentación dará lugar a que se ejecuten todas las pruebas en cada fragmento.
Etiquetas:incompatible_change
--[no]incompatible_exclusive_test_sandboxed
predeterminado: "true"-
Si es verdadero, las pruebas exclusivas se ejecutarán con la estrategia de zona de pruebas. Agrega la etiqueta "local" para forzar que se ejecute una prueba exclusiva de forma local.
Etiquetas:incompatible_change
--[no]incompatible_strict_action_env
predeterminado: “false”-
Si es verdadero, Bazel usa un entorno con un valor estático para PATH y no hereda LD_LIBRARY_PATH. Usa --action_env=ENV_VARIABLE si deseas heredar variables de entorno específicas del cliente, pero ten en cuenta que, de esta manera, se puede evitar la caché entre usuarios si se usa una caché compartida.
Etiquetas:loading_and_analysis
,incompatible_change
- Se acumulan varios usos de
--j2objc_translation_flags=<comma-separated list of options>
- : Opciones adicionales para pasar a la herramienta J2ObjC.
--java_debug
-
Hace que la máquina virtual de Java de una prueba de Java espere una conexión de un depurador compatible con JDWP (como jdb) antes de iniciar la prueba. Implica -test_output=streamed.
Se expande a:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
--[no]java_deps
predeterminado: "true"- Genera información de dependencia (por ahora, el classpath del tiempo de compilación) por destino de Java.
- Valor predeterminado de
--[no]java_header_compilation
: "true" - Compila ijars directamente desde la fuente.
--java_language_version=<a string>
predeterminado: ""- La versión del lenguaje Java
--java_launcher=<a build target label>
predeterminado: Consulta la descripción- Es el selector de Java que se usará cuando se compilen objetos binarios de Java. Si esta marca se establece en la cadena vacía, se usa el selector de JDK. El atributo "launcher" anula esta marca.
--java_runtime_version=<a string>
predeterminado: "local_jdk"- La versión del entorno de ejecución de Java
- Se acumulan varios usos de
--javacopt=<a string>
- Opciones adicionales para pasar a javac.
- Se acumulan varios usos de
--jvmopt=<a string>
- Opciones adicionales para pasar a la VM de Java. Estas opciones se agregarán a las opciones de inicio de la VM de cada destino java_binary.
- Valor predeterminado de
--legacy_main_dex_list_generator=<a build target label>
: ver descripción - especifica un objeto binario que se usará para generar la lista de clases que deben estar en el DEX principal cuando se compila el multidex heredado.
- Valor predeterminado de
--local_termination_grace_seconds=<an integer>
: "15" - Es el tiempo de espera entre la finalización de un proceso local debido al tiempo de espera y su cierre forzoso.
--optimizing_dexer=<a build target label>
predeterminado: Consulta la descripción- Especifica un objeto binario para usar y realizar la conversión a Dex sin fragmentación.
--package_path=<colon-separated list of options>
predeterminado: "%workspace%"- Una lista separada por dos puntos de dónde buscar paquetes. Los elementos que comienzan con "%workspace%" son relativos al lugar de trabajo que los contiene. Si se omite o está vacío, el valor predeterminado es el resultado de "bazel info default-package-path".
- Se acumulan varios usos de
--plugin=<a build target label>
- Plug-ins para usar en la compilación. Actualmente, funciona con java_plugin.
--proguard_top=<a build target label>
predeterminado: Consulta la descripción- Especifica qué versión de ProGuard se usará para quitar el código cuando se compila un objeto binario de Java.
--proto_compiler=<a build target label>
predeterminado: "@bazel_tools//tools/proto:protoc"-
Es la etiqueta del protocompilador.
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
predeterminado: "@bazel_tools//tools/proto:cc_toolchain"-
Etiqueta de proto_lang_toolchain(), que describe cómo compilar protos de C++
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
predeterminado: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"-
Etiqueta de proto_lang_toolchain(), que describe cómo compilar protos de j2objc
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
predeterminado: "@bazel_tools//tools/proto:java_toolchain"-
Etiqueta de proto_lang_toolchain(), que describe cómo compilar protos de Java
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
predeterminado: "@bazel_tools//tools/proto:javalite_toolchain"-
Etiqueta de proto_lang_toolchain(), que describe cómo compilar protos de JavaLite
Etiquetas:affects_outputs
,loading_and_analysis
- Se acumulan
--protocopt=<a string>
usos múltiples -
Opciones adicionales para pasar al compilador de protobuf.
Etiquetas:affects_outputs
--[no]runs_per_test_detects_flakes
predeterminado: “false”- Si es verdadero, cualquier fragmento en el que se apruebe al menos una ejecución o intento y falle al menos una ejecución o intento obtiene un estado FLAKY.
--shell_executable=<a path>
predeterminado: Consulta la descripción-
Ruta de acceso absoluta al ejecutable de shell que usará Bazel. Si no se establece, pero la variable de entorno BAZEL_SH se establece en la primera invocación de Bazel (que inicia un servidor de Bazel), Bazel la usará. Si no se establece ninguno, Bazel usa una ruta de acceso predeterminada fija según el sistema operativo en el que se ejecuta (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, todos los demás: /bin/bash). Ten en cuenta que usar un shell que no sea compatible con bash puede generar fallas de compilación o de tiempo de ejecución de los objetos binarios generados.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]show_loading_progress
: "true" - Si está habilitado, hace que Bazel imprima mensajes de “Carga del paquete:”.
- Se acumulan varios usos de
--test_arg=<a string>
- Especifica opciones y argumentos adicionales que se deben pasar al ejecutable de prueba. Se puede usar varias veces para especificar varios argumentos. Si se ejecutan varias pruebas, cada una recibirá argumentos idénticos. Solo lo usa el comando "bazel test".
--test_filter=<a string>
predeterminado: Consulta la descripción- Especifica un filtro para reenviar al framework de prueba. Se usa para limitar las pruebas que se ejecutan. Ten en cuenta que esto no afecta los destinos que se compilan.
--test_lang_filters=<comma-separated list of options>
predeterminado: ""- Especifica una lista de idiomas de prueba separados por comas. De manera opcional, cada idioma puede ir precedido de “-” para especificar los idiomas excluidos. Solo se encontrarán los objetivos de prueba que están escritos en los idiomas especificados. El nombre que se usa para cada idioma debe ser el mismo que el prefijo de idioma en la regla *_test, p.ej., uno de "cc", "java", "py", etc. Esta opción afecta el comportamiento de --build_tests_only y el comando de prueba.
--test_result_expiration=<an integer>
predeterminado: “-1”- Esta opción está obsoleta y no tiene ningún efecto.
- Valor predeterminado de
--[no]test_runner_fail_fast
: "falso" - Redirecciona la opción de falla rápida al ejecutor de pruebas. El ejecutor de pruebas debe detener la ejecución en la primera falla.
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>
predeterminado: "explícito"- Especifica la estrategia para el fragmentación de prueba: "explicit" para usar solo la fragmentación si está presente el atributo BUILD "shard_count". "disabled" para nunca usar el fragmentación de prueba. "forced=k" para aplicar fragmentos "k" para pruebas, independientemente del atributo BUILD "shard_count".
- Valor predeterminado de
--test_size_filters=<comma-separated list of values: small, medium, large or enormous>
: "" - Especifica una lista de tamaños de prueba separados por comas. De manera opcional, cada tamaño puede ir precedido de "-" 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 de --build_tests_only y el comando test.
--test_tag_filters=<comma-separated list of options>
predeterminado: ""- Especifica una lista de etiquetas de prueba separadas por comas. De manera opcional, cada etiqueta puede ir precedida de "-" para especificar las etiquetas excluidas. Solo se encontrarán los objetivos de prueba que contengan al menos una etiqueta incluida y no contengan ninguna etiqueta excluida. Esta opción afecta el comportamiento de --build_tests_only y el comando test.
--test_timeout_filters=<comma-separated list of values: short, moderate, long or eternal>
predeterminado: ""- Especifica una lista separada por comas de tiempos de espera de prueba. De manera opcional, cada tiempo de espera puede ir precedido de "-" para especificar los tiempos de espera excluidos. Solo se encontrarán los objetivos de prueba que contengan al menos un tiempo de espera incluido y no contengan tiempos de espera excluidos. Esta opción afecta el comportamiento de --build_tests_only y el comando test.
- Valor predeterminado de
--tool_java_language_version=<a string>
: "" - La versión del lenguaje Java que se usa para ejecutar las herramientas necesarias durante una compilación
--tool_java_runtime_version=<a string>
predeterminado: "remotejdk_11"- La versión del entorno de ejecución de Java que se usa para ejecutar herramientas durante la compilación
--[no]use_ijars
predeterminado: "true"- Si se habilita, esta opción hace que la compilación de Java use archivos jar de la interfaz. Esto generará una compilación incremental más rápida, pero los mensajes de error pueden ser diferentes.
Opciones de canonicalize-flags
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
-
Dónde buscar archivos antes de acceder a la red y descargarlos
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, los repositorios externos pueden funcionar en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--[no]incompatible_disable_native_repo_rules
predeterminado: “false”-
Si es falso, se pueden usar reglas de repositorio nativas en WORKSPACE. De lo contrario, se deben usar reglas de repositorio de Starlark. Estas reglas incluyen local_repository, new_local_repository, local_config_platform, android_sdk_repository y android_ndk_repository.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación en caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché. De lo contrario, se usa el valor predeterminado de '<output_user_root>/cache/repos/v1'.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]repository_disable_download
: "falso" -
Si se configura, no se permite la descarga mediante ctx.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no se inhabilita por completo; ctx.execute aún podría ejecutar un ejecutable arbitrario que acceda a Internet.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de la compilación:
--gc_thrashing_threshold=<an integer in 0-100 range>
predeterminado: "100"-
Es el porcentaje de espacio ocupado (de 0 a 100) por encima del cual GcThrashingDetector considera los eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, se inhabilita GcThrashingDetector.
Etiquetas:host_machine_resource_optimizations
- Opciones que controlan el resultado del comando:
--[no]canonicalize_policy
predeterminado: “false”-
Ejecuta la política canónica después de la expansión y el filtrado. Para mantener el resultado limpio, NO se mostrarán los argumentos de comando canonizados cuando esta opción se establezca como verdadera. Ten en cuenta que el comando especificado por --for_command afecta a la política filtrada y, si no se especifica ninguno, el comando predeterminado es "build".
Etiquetas:affects_outputs
,terminal_output
- 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
,terminal_output
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility
predeterminado: “false”-
Si no es compatible_enforce_config_setting_visibility=false, esta es una noop. De lo contrario, si esta marca es falsa, cualquier config_setting sin un atributo de visibilidad explícito es //visibility:public. Si esta marca es verdadera, config_setting sigue la misma lógica de visibilidad que todas las demás reglas. Consulta https://github.com/bazelbuild/bazel/issues/12933.
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]incompatible_enforce_config_setting_visibility
: "true" -
Si es verdadero, aplica las restricciones de visibilidad de config_setting. Si es falso, todos los config_setting son visibles para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones relacionadas con la salida y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
-
Se especificaron las versiones del módulo con el formato `<module1>@<version1>,<module2>@<version2>` que se permitirán en el gráfico de dependencias resuelto incluso si se declaran como eliminadas en el registro del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
- 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
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
predeterminado: “update”- especifica cómo usar el archivo de bloqueo y si se debe usar o no. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "refresh" para actualizar periódicamente la información mutable (versiones quitadas y módulos que faltaban anteriormente) de los registros remotos, "error" para usar el archivo de bloqueo, pero mostrar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso proporcionada es una ruta de acceso absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta de acceso relativa, se considerará en relación con el directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace". Si la ruta de acceso determinada está vacía, quita las anulaciones anteriores.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los anteriores.
Etiquetas:changes_inputs
--vendor_dir=<a path>
predeterminado: Consulta la descripción-
Especifica el directorio que debe contener los repositorios externos en modo de proveedor, ya sea para recuperarlos o usarlos durante la compilación. La ruta de acceso se puede especificar como una ruta absoluta o una ruta relativa al directorio del espacio 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 falle con Bazel con una OOM. Cada límite se especifica como <period>:<count>, donde period es una duración y count es un número entero positivo. Si hay más de --gc_thrashing_threshold por ciento de espacio permanente (montón de generación anterior) permanece ocupado después de <count> recolecciones de elementos no utilizados consecutivos en <period>, se activará una OOM. Se pueden especificar varios límites separados por comas.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC completo, se descartará el estado temporal innecesario de Skyframe hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE, es decir, ilimitado. Cero significa que los eventos de GC completos nunca activarán las bajadas. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC completo y se supere ese umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produce un evento de GC menor, descartará el estado temporal innecesario de Skyframe hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC menores nunca activarán las bajadas. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC menor y se supere ese umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
- Valor predeterminado de
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
Marca de configuración avanzada del motor interno de Skyframe de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es de al menos este límite, descartará el estado temporal innecesario de Skyframe. Si ajustas este parámetro, es posible que puedas mitigar el impacto del tiempo de ejecución de la fragmentación de GC, cuando esta se produce (i) por el uso de memoria de este estado temporal y (ii) es más costoso que reconstituir el estado cuando sea necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--experimental_command_profile=<cpu, wall, alloc or lock>
predeterminado: Consulta la descripción- Graba un perfil de Java Flight Recorder durante el tiempo que se ejecuta el comando. Se debe proporcionar como argumento uno de los tipos de eventos de generación de perfiles admitidos (cpu, wall, alloc o lock). El perfil se escribe en un archivo que lleva el nombre del tipo de evento en el directorio de base de salida. La sintaxis y la semántica de esta marca pueden cambiar en el futuro para admitir tipos de perfiles o formatos de salida adicionales. Úsala bajo tu propio riesgo.
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
- Opciones que especifican o alteran una entrada genérica a un comando de Bazel que no se incluye en otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE
Etiquetas:changes_inputs
--for_command=<a string>
predeterminado: "build"-
Es el comando para el que se deben canonizar las opciones.
Etiquetas:affects_outputs
,terminal_output
--invocation_policy=<a string>
predeterminado: ""-
Aplica una política de invocación a las opciones que se van a canonicalizar.
Etiquetas:affects_outputs
,terminal_output
- Opciones de almacenamiento en caché y ejecución remotas:
- Valor predeterminado de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo para configurar el cargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
predeterminado: “auto”- El modo de subprocesos que se usará para la recuperación del repositorio. Si se establece en "desactivado", no se usa ningún subproceso de trabajo y la recuperación del repo está sujeta a reinicios. De lo contrario, usa un subproceso de trabajador virtual.
- Otras opciones, sin categorizar:
- Se acumulan varios usos de
--deleted_packages=<comma-separated list of package names>
- Es una lista separada por comas de nombres de paquetes que el sistema de compilación considerará inexistentes, incluso si son visibles en algún lugar de la ruta de acceso del paquete. Usa esta opción cuando borres un subpaquete "x/y" de un paquete existente "x". Por ejemplo, después de borrar x/y/BUILD en tu cliente, el sistema de compilación puede presentar un reclamo si encuentra la etiqueta “//x:y/z” si aún la proporciona otra entrada package_path. Especificar --deleted_packages x/y evita este problema.
--[no]fetch
predeterminado: "true"- Permite que el comando recupere dependencias externas. Si se establece como falso, el comando usará cualquier versión almacenada en caché de la dependencia y, si no existe ninguna, el comando fallará.
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
- Anula un repositorio con una ruta de acceso local con el formato <repository name>=<path>. Si la ruta dada es una ruta absoluta, se usará tal como es. Si la ruta proporcionada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace". Si la ruta de acceso determinada está vacía, quita las anulaciones anteriores.
--package_path=<colon-separated list of options>
predeterminado: "%workspace%"- Una lista separada por dos puntos de dónde buscar paquetes. Los elementos que comienzan con "%workspace%" son relativos al lugar de trabajo que los contiene. Si se omite o está vacío, el valor predeterminado es el resultado de "bazel info default-package-path".
--[no]show_loading_progress
predeterminado: "true"- Si está habilitado, hace que Bazel imprima mensajes de “Carga del paquete:”.
Opciones de limpieza
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
-
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se configura, la caché del repositorio vinculará el archivo en caso de un acierto de caché, en lugar de copiarse. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Ajusta todos los tiempos de espera en las reglas del repositorio de Starlark con este factor. De esta manera, los repositorios externos pueden funcionar en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--[no]incompatible_disable_native_repo_rules
predeterminado: “false”-
Si es falso, se pueden usar reglas de repositorio nativas en WORKSPACE. De lo contrario, se deben usar reglas de repositorio de Starlark. Estas reglas incluyen local_repository, new_local_repository, local_config_platform, android_sdk_repository y android_ndk_repository.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché. De lo contrario, se usa el valor predeterminado de '<output_user_root>/cache/repos/v1'.
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
predeterminado: “false”-
Si se establece, no se permite la descarga con ctx.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no se inhabilita por completo; ctx.execute aún podría ejecutar un ejecutable arbitrario que acceda a Internet.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de la compilación:
--gc_thrashing_threshold=<an integer in 0-100 range>
predeterminado: "100"-
Es el porcentaje de espacio ocupado (de 0 a 100) por encima del cual GcThrashingDetector considera los eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, se inhabilita GcThrashingDetector.
Etiquetas:host_machine_resource_optimizations
- Opciones que controlan el resultado del comando:
--[no]async
predeterminado: “false”-
Si es verdadero, la limpieza de salida es asíncrona. Cuando se complete este comando, será seguro ejecutar comandos nuevos en el mismo cliente, aunque la eliminación pueda continuar en segundo plano.
Etiquetas:host_machine_resource_optimizations
--[no]expunge
predeterminado: “false”-
Si es verdadero, clean quita todo el árbol de trabajo de esta instancia de Bazel, lo que incluye todos los archivos de salida temporales y de compilación creados por Bazel, y detiene el servidor de Bazel si está en ejecución.
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 el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
-
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitados en el registro de donde 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 quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para 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
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "advertencia" -
Verifica si las dependencias directas de "bazel_dep" declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivarla a 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 dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
predeterminado: “update”- especifica cómo usar el archivo de bloqueo y si se debe usar o no. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "refresh" para actualizar adicionalmente la información mutable (versiones eliminadas y módulos anteriores faltantes) de los registros remotos de vez en cuando, "error" para usar el archivo bloqueado, pero arrojar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso proporcionada es una ruta de acceso absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta de acceso relativa, se hará referencia al directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace". Si la ruta de acceso determinada está vacía, quita las anulaciones anteriores.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los anteriores.
Etiquetas:changes_inputs
- Valor predeterminado de
--vendor_dir=<a path>
: ver descripción -
Especifica el directorio que debe contener los repositorios externos en modo de proveedor, ya sea para recuperarlos o usarlos durante la compilación. La ruta de acceso se puede especificar como una ruta absoluta o una ruta relativa al directorio del espacio 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 falle con Bazel con una OOM. Cada límite se especifica como <period>:<count>, en el que period es una duración y count es un número entero positivo. Si hay más de --gc_thrashing_threshold por ciento de espacio permanente (montón de generación anterior) permanece ocupado después de <count> recolecciones de elementos no utilizados consecutivos en <period>, se activará una OOM. Se pueden especificar varios límites separados por comas.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC completo, se descartará el estado temporal innecesario de Skyframe hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE, es decir, ilimitado. Cero significa que los eventos de GC completos nunca activarán las bajadas. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC completo y se supere ese umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produce un evento de GC menor, descartará el estado temporal innecesario de Skyframe hasta esta cantidad de veces por invocación. La configuración predeterminada es Integer.MAX_VALUE; en efecto ilimitado. 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
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es de al menos este límite, descartará el estado temporal innecesario de Skyframe. Si ajustas este parámetro, es posible que puedas mitigar el impacto del tiempo de ejecución de la fragmentación de GC, cuando esta se produce (i) por el uso de memoria de este estado temporal y (ii) es más costoso que reconstituir el estado cuando sea necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--experimental_command_profile=<cpu, wall, alloc or lock>
predeterminado: Consulta la descripción- Graba un perfil de Java Flight Recorder durante el tiempo que se ejecuta el comando. Se debe proporcionar como argumento uno de los tipos de eventos de generación de perfiles admitidos (cpu, wall, alloc o lock). 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 resultados adicionales; úsalas bajo tu responsabilidad.
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemónicos con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
- Opciones que especifican o 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é remotos:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno que debe coincidir y otro para usar como URL sustituta, con referencias inversas a partir de "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URL.
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
predeterminado: "automático"- Es el modo de subprocesos que se usará para recuperar el repo. Si se establece en "desactivado", no se usa ningún subproceso de trabajo y la recuperación del repo está sujeta a reinicios. De lo contrario, usa un subproceso de trabajador virtual.
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
- Anula un repositorio con una ruta de acceso local en el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es una ruta absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta relativa, se relaciona con el directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace". Si la ruta de acceso determinada está vacía, quita las anulaciones anteriores.
Config Options
Opciones de cobertura
Hereda todas las opciones de test.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
-
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
- Valor predeterminado de
--experimental_scale_timeouts=<a double>
: "1.0" -
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, los repositorios externos pueden funcionar en máquinas más lentas de lo esperado por el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--[no]incompatible_disable_native_repo_rules
predeterminado: “false”-
Si es falso, se pueden usar reglas de repositorio nativas en WORKSPACE. De lo contrario, se deben usar reglas de repositorio de Starlark. Estas reglas incluyen local_repository, new_local_repository, local_config_platform, android_sdk_repository y android_ndk_repository.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché; de lo contrario, se usa el valor predeterminado "<output_user_root>/cache/repos/v1"
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
predeterminado: “false”-
Si se configura, no se permite la descarga mediante ctx.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no se inhabilita por completo; ctx.execute aún podría ejecutar un ejecutable arbitrario que acceda a Internet.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de la compilación:
- Valor predeterminado de
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Es el porcentaje de espacio ocupado (de 0 a 100) por encima del cual GcThrashingDetector considera los eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, se inhabilita GcThrashingDetector.
Etiquetas:host_machine_resource_optimizations
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
-
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitados en el registro de donde 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 quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para 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
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "advertencia" -
Verifica si las dependencias directas de "bazel_dep" declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivarla a un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
predeterminado: “update”- especifica cómo usar el archivo de bloqueo y si se debe usar o no. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "refresh" para actualizar periódicamente la información mutable (versiones quitadas y módulos que faltaban anteriormente) de los registros remotos, "error" para usar el archivo de bloqueo, pero mostrar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
- Anula un módulo con una ruta de acceso local con el formato <module name>=<path>. Si la ruta proporcionada es una ruta de acceso absoluta, se usará como es. Si la ruta proporcionada es una ruta de acceso relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace". Si la ruta de acceso determinada está vacía, quita las anulaciones anteriores.
- Se acumulan varios usos de
--registry=<a string>
-
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los anteriores.
Etiquetas:changes_inputs
- Valor predeterminado de
--vendor_dir=<a path>
: ver descripción -
Especifica el directorio que debe contener los repositorios externos en modo de proveedor, ya sea para recuperarlos o usarlos durante la compilación. La ruta de acceso se puede especificar como una ruta absoluta o una ruta relativa al directorio del espacio de trabajo.
Etiquetas:loading_and_analysis
- Opciones que activan optimizaciones del tiempo de compilación:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
predeterminado: "1s:2,20s:3,1m:5"-
Límites que, si se alcanzan, hacen que GcThrashingDetector haga que Bazel falle con un error de OOM. Cada límite se especifica como <period>:<count>, donde el período es una duración y el conteo es un número entero positivo. Si más del porcentaje --gc_thrashing_threshold del espacio a perpetuidad (heap de generación anterior) permanece ocupado después de <count> GC completas consecutivas en <period>, se activa un error de OOM. Se pueden especificar varios límites separados por comas.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: “2147483647”-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de 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; en efecto ilimitado. Cero significa que los eventos de GC completos nunca activarán las bajadas. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC completo y se supere ese umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produce un evento de GC menor, descartará el estado temporal innecesario de Skyframe hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE, es decir, ilimitado. 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
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es de al menos este límite, descartará el estado temporal innecesario de Skyframe. Si ajustas este parámetro, es posible que puedas mitigar el impacto del tiempo de ejecución de la fragmentación de GC, cuando esta se produce (i) por el uso de memoria de este estado temporal y (ii) es más costoso que reconstituir el estado cuando sea necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Valor predeterminado de
--experimental_command_profile=<cpu, wall, alloc or lock>
: ver descripción - Graba un perfil de Java Flight Recorder durante el tiempo que se ejecuta el comando. Se debe proporcionar como argumento uno de los tipos de eventos de generación de perfiles admitidos (cpu, wall, alloc o lock). El perfil se escribe en un archivo que lleva el nombre del tipo de evento en el directorio de base de salida. La sintaxis y la semántica de esta marca pueden cambiar en el futuro para admitir tipos de perfiles o formatos de salida adicionales. Úsala bajo tu propio riesgo.
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
- Opciones que especifican o alteran una entrada genérica a un comando de Bazel que no se incluye en otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno que debe coincidir y otro para usar como URL sustituta, con referencias inversas a partir de "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URL.
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
predeterminado: “auto”- El modo de subprocesos que se usará para la recuperación del repositorio. Si se establece en "desactivado", no se usa ningún subproceso de trabajo y la recuperación del repo está sujeta a reinicios. De lo contrario, usa un subproceso de trabajador virtual.
- Opciones misceláneas que no se clasifican de 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 <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es una ruta absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta relativa, se relaciona con el directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace". Si la ruta de acceso determinada está vacía, quita las anulaciones anteriores.
Opciones de Cquery
Hereda todas las opciones de test.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
-
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, se puede hacer que los repositorios externos funcionen en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--[no]incompatible_disable_native_repo_rules
predeterminado: “false”-
Si es falso, se pueden usar reglas de repositorio nativas en WORKSPACE. De lo contrario, se deben usar reglas de repositorio de Starlark. Las reglas de repositorio nativo incluyen local_repository, new_local_repository, local_config_platform, android_sdk_repository y android_ndk_repository.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché. De lo contrario, se usa el valor predeterminado de '<output_user_root>/cache/repos/v1'.
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
predeterminado: “false”-
Si se establece, no se permite la descarga con ctx.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no se inhabilita por completo; ctx.execute aún podría ejecutar un ejecutable arbitrario que acceda a Internet.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de compilación:
- Valor predeterminado de
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Es el porcentaje de espacio ocupado (de 0 a 100) por encima del cual GcThrashingDetector considera los eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, GcThrashingDetector se inhabilita.
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 las dependencias de aspecto cuando el formato de salida es uno de {xml,proto,record}. "Desactivado" significa que no se resuelven las dependencias de aspecto. "Conservador" (la opción predeterminada) significa que se agregan todas las dependencias de aspecto declaradas, independientemente de si se les asigna la clase de regla de dependencias directas. "Preciso" significa que solo se agregan los aspectos que pueden estar activos según la clase de regla de las dependencias directas. Ten en cuenta que el modo preciso requiere 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 toma 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 está habilitada, cada comando de consulta emite etiquetas como si fuera la función Starlark <code>str</code> aplicada a una instancia de <code>Label</code>. Esto es útil para las herramientas que deben coincidir con el resultado de diferentes comandos de consulta o etiquetas emitidos por reglas. Si no están habilitados, los formateadores de salida pueden emitir nombres de repositorio aparentes (en relación con el repositorio principal) para que el resultado sea más legible.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]experimental_explicit_aspects
: "falso" -
aquery, cquery: Indica si se deben incluir acciones generadas por aspectos en el resultado. query: No-op (siempre se siguen los aspectos).
Etiquetas:terminal_output
--[no]graph:factored
predeterminado: "true"-
Si es verdadero, el gráfico se emitirá "factorizado", es decir, los nodos topológicamente equivalentes se combinarán y sus etiquetas se concatenarán. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--graph:node_limit=<an integer>
predeterminado: “512”-
Es la longitud máxima de la string de etiqueta para un nodo del grafo en el resultado. Las etiquetas más largas se truncarán. -1 significa que no se truncará. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--[no]implicit_deps
predeterminado: "true"-
Si está habilitada, se incluirán dependencias implícitas en el gráfico de dependencias sobre el que opera la consulta. Una dependencia implícita es aquella que no se especifica explícitamente en el archivo BUILD, pero que Bazel agrega. En el caso de cquery, esta opción controla el filtrado de cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
--[no]include_aspects
predeterminado: "true"-
aquery, cquery: Indica si se deben incluir acciones generadas por aspectos en el resultado. query: No-op (siempre se siguen los aspectos).
Etiquetas:terminal_output
--[no]incompatible_package_group_includes_double_slash
predeterminado: "true"-
Si está habilitada, cuando se genere el atributo "packages" de package_group, no se omitirá el "//" inicial.
Etiquetas:terminal_output
,incompatible_change
--[no]infer_universe_scope
predeterminado: “false”-
Si se establece y no se establece --universe_scope, se inferirá un valor de --universe_scope como la lista de patrones de destino únicos en la expresión de consulta. Ten en cuenta que 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 establece --universe_scope, se ignora el valor de esta opción. Nota: Esta opción solo se aplica a "query" (es decir, no a "cquery").
Etiquetas:loading_and_analysis
--[no]line_terminator_null
predeterminado: “false”-
Indica si cada formato finaliza con \0 en lugar de una línea nueva.
Etiquetas:terminal_output
--[no]nodep_deps
predeterminado: "true"-
Si está habilitada, las dependencias de los atributos "nodep" se incluirán en el gráfico de dependencias sobre el que opera la consulta. Un ejemplo común de un atributo "nodep" es "visibility". Ejecuta y analiza el resultado de "info build-language" para obtener información sobre todos los atributos "nodep" en el lenguaje de compilación.
Etiquetas:build_file_semantics
--output=<a string>
predeterminado: "label"-
Es el formato en el que se deben imprimir los resultados de cquery. Los valores permitidos para cquery son: etiqueta, etiqueta_tipo, textoproto, transiciones, proto, proto_transmitido y jsonproto. Si seleccionas "transiciones", también debes especificar la opción --transitions=(lite|full).
Etiquetas:terminal_output
--[no]proto:default_values
predeterminado: "true"-
Si es verdadero, se incluyen los atributos cuyo valor no se especifica de forma explícita en el archivo BUILD; de lo contrario, se omiten. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
--[no]proto:definition_stack
predeterminado: “false”-
Propaga el campo proto definition_stack, que registra para cada instancia de regla la pila de llamadas de Starlark en el momento en que se definió la clase de la regla.
Etiquetas:terminal_output
--[no]proto:flatten_selects
predeterminado: "true"-
Si está habilitada, los atributos configurables creados por select() se aplanan. En el caso de los tipos de lista, la representación aplanada es una lista que contiene cada valor del mapa de selección exactamente una vez. Los tipos escalares se aplanan a nulos.
Etiquetas:build_file_semantics
- Valor predeterminado de
--[no]proto:include_attribute_source_aspects
: "falso" -
Propaga el campo proto source_aspect_name de cada atributo con el aspecto de origen del que proviene el atributo (cadena vacía si no es así).
Etiquetas:terminal_output
--[no]proto:include_configurations
predeterminado: "true"-
Si está habilitado, el resultado de proto incluirá información sobre las configuraciones. Cuando se inhabilita,el formato de salida de cquery proto se asemeja al formato de salida de la consulta.
Etiquetas:affects_outputs
--[no]proto:include_synthetic_attribute_hash
predeterminado: “false”-
Indica si se debe calcular y propagar el atributo $internal_attr_hash.
Etiquetas:terminal_output
--[no]proto:instantiation_stack
predeterminado: “false”-
Propaga la pila de llamadas de creación de instancias de cada regla. Ten en cuenta que esto requiere que la pila esté presente.
Etiquetas:terminal_output
--[no]proto:locations
predeterminado: "true"-
Indica si se debe generar información de ubicación en el resultado de proto.
Etiquetas:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
predeterminado: "todos"-
Lista de atributos separados por comas para incluir en el resultado. La configuración predeterminada es todos los atributos. Se configura como una cadena vacía para no generar ningún atributo. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
--[no]proto:rule_inputs_and_outputs
predeterminado: "true"-
Indica si se propagan o no los campos rule_input y rule_output.
Etiquetas:terminal_output
--query_file=<a string>
predeterminado: ""-
Si se establece, la consulta leerá la consulta del archivo que se nombra aquí, en lugar de la línea de comandos. Especificar un archivo aquí y una consulta de línea de comandos es un error.
Etiquetas:changes_inputs
--[no]relative_locations
predeterminado: “false”-
Si es verdadero, la ubicación de los archivos BUILD en los resultados de xml y proto será relativa. De forma predeterminada, el resultado de la ubicación es una ruta de acceso absoluta y no será coherente en todas las máquinas. Puedes establecer esta opción en verdadero para obtener un resultado coherente en todas las máquinas.
Etiquetas:terminal_output
--show_config_fragments=<off, direct or transitive>
predeterminado: "off"-
Muestra los fragmentos de configuración que requiere una regla y sus dependencias transitivas. Esto puede ser útil para evaluar cuánto se puede recortar un gráfico objetivo configurado.
Etiquetas:affects_outputs
- Valor predeterminado de
--starlark:expr=<a string>
: "" -
Es una expresión Starlark para dar formato a cada destino configurado en el modo --output=starlark de cquery. El objetivo configurado está vinculado a "target". Si no se especifican --starlark:expr ni --starlark:file, esta opción se establecerá de forma predeterminada en "str(target.label)". Especificar --starlark:expr y --starlark:file es un error.
Etiquetas:terminal_output
--starlark:file=<a string>
predeterminado: ""-
Es el nombre de un archivo que define una función de Starlark llamada "format", de un argumento, que se aplica a cada destino configurado para darle formato de cadena. Especificar --starlark:expr y --starlark:file es un error. Consulta la ayuda de --output=starlark para obtener más detalles.
Etiquetas:terminal_output
--[no]tool_deps
predeterminado: "true"-
Consulta: Si se inhabilita, las dependencias de "configuración de ejecución" no se incluirán en el gráfico de dependencias sobre el que opera la consulta. Un borde de dependencia de "configuración de ejecución", como el de cualquier regla "proto_library" al compilador de protocolos, suele apuntar a una herramienta que se ejecuta durante la compilación en lugar de a una parte del mismo programa "objetivo".
Cquery: Si se inhabilita, filtra todos los objetivos configurados que crucen una transición de ejecución desde el objetivo de nivel superior que descubrió este objetivo configurado. Esto significa que, si el objetivo de nivel superior está en la configuración de destino, solo se mostrarán los objetivos configurados también en la configuración de destino. Si el objetivo de nivel superior está en la configuración de exec, solo se mostrarán los objetivos configurados por exec. Esta opción NO excluirá las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
- Valor predeterminado de
--transitions=<full, lite or none>
: “none” -
Es el formato en el que cquery imprimirá la información de transición.
Etiquetas:affects_outputs
- Valor predeterminado de
--universe_scope=<comma-separated list of options>
: "" -
Es un conjunto de patrones de destino (aditivos y sustractivos) separados por comas. La consulta puede realizarse en el universo definido por el cierre transitivo de los objetivos especificados. Esta opción se usa para los comandos query y cquery.
En el caso de cquery, la entrada de esta opción son los objetivos en los que se compilan todas las respuestas, por lo que esta opción puede afectar las configuraciones y las transiciones. Si no se especifica esta opción, se supone que los destinos de nivel superior son los que se analizaron de la expresión de consulta. Nota: En el caso de cquery, si no se especifica esta opción, es posible que la compilación falle si los destinos analizados de la expresión de consulta no se pueden compilar con opciones de nivel superior.
Etiquetas:loading_and_analysis
- Opciones relacionadas con la salida y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
-
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitadas en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones rechazadas harán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave “todo” (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Comprueba la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "advertencia" -
Verifica si las dependencias directas de "bazel_dep" declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivarla a un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
predeterminado: "update"- especifica cómo usar el archivo de bloqueo y si se debe usar o no. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "refresh" para actualizar adicionalmente la información mutable (versiones eliminadas y módulos anteriores faltantes) de los registros remotos de vez en cuando, "error" para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
- Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso proporcionada es una ruta de acceso absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta de acceso relativa, se considerará en relación con el directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace". Si la ruta de acceso determinada está vacía, quita las anulaciones anteriores.
- Se acumulan varios usos de
--registry=<a string>
-
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en registros anteriores y solo se recurrirán a los registros posteriores cuando no estén en los registros anteriores.
Etiquetas:changes_inputs
--vendor_dir=<a path>
predeterminado: Consulta la descripción-
Especifica el directorio que debe contener los repositorios externos en modo de proveedor, ya sea para recuperarlos o usarlos durante la compilación. La ruta de acceso se puede especificar como una ruta absoluta o una ruta relativa al directorio del espacio de trabajo.
Etiquetas:loading_and_analysis
- Opciones que activan optimizaciones del tiempo de compilación:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
predeterminado: "1s:2,20s:3,1m:5"-
Límites que, si se alcanzan, hacen que GcThrashingDetector haga que Bazel falle con un error de OOM. Cada límite se especifica como <period>:<count>, en el que period es una duración y count es un número entero positivo. Si más del porcentaje --gc_thrashing_threshold del espacio a perpetuidad (heap de generación anterior) permanece ocupado después de <count> GC completas consecutivas en <period>, se activa un error de OOM. 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"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de recolección de elementos no utilizados completa, eliminará el estado temporal de Skyframe innecesario, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC completos nunca activarán las bajadas. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC completo y se supere ese umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produce un evento de GC menor, descartará el estado temporal innecesario de Skyframe hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC menores nunca activarán las bajadas. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC menor y se supere ese umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es al menos este umbral, descartará el estado temporal de Skyframe innecesario. Si ajustas este parámetro, es posible que puedas mitigar el impacto del tiempo de ejecución de la fragmentación de GC, cuando esta se produce (i) por el uso de memoria de este estado temporal y (ii) es más costoso que reconstituir el estado cuando sea necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--experimental_command_profile=<cpu, wall, alloc or lock>
predeterminado: Consulta la descripción- Graba un perfil de Java Flight Recorder durante el tiempo que se ejecuta el comando. Se debe proporcionar como argumento uno de los tipos de eventos de generación de perfiles admitidos (cpu, wall, alloc o lock). El perfil se escribe en un archivo que lleva el nombre del tipo de evento en el directorio de 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 resultados adicionales; úsalas bajo tu responsabilidad.
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
- Opciones que especifican o alteran una entrada genérica a un comando de Bazel que no se incluye en otras categorías:
- Valor predeterminado de
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
predeterminado: "automático"- Es el modo de subprocesos que se usará para recuperar el repo. Si se establece en "desactivado", no se usa ningún subproceso de trabajo y la recuperación del repo está sujeta a reinicios. De lo contrario, usa un subproceso de trabajador virtual.
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
- Anula un repositorio con una ruta de acceso local en el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es una ruta de acceso absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta de acceso relativa, se relaciona con el directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace". Si la ruta de acceso determinada está vacía, quita las anulaciones anteriores.
- Opciones que controlan la ejecución de compilación:
--[no]experimental_inprocess_symlink_creation
predeterminado: “false”-
Determina si se deben realizar llamadas directas al sistema de archivos para crear árboles de symlinks.
Etiquetas:loading_and_analysis
,execution
,experimental
--[no]experimental_persistent_aar_extractor
predeterminado: “false”-
Habilita el extractor de aar persistente con trabajadores.
Etiquetas:execution
--[no]experimental_remotable_source_manifests
predeterminado: “false”-
Determina si las acciones del manifiesto de origen se pueden controlar de forma remota.
Etiquetas:loading_and_analysis
,execution
,experimental
- Valor predeterminado de
--[no]experimental_split_coverage_postprocessing
: "falso" -
Si es verdadero, Bazel ejecutará el procesamiento posterior de la cobertura para realizar pruebas en una generación nueva.
Etiquetas:execution
- Valor predeterminado de
--[no]experimental_strict_fileset_output
: "falso" -
Si esta opción está habilitada, los conjuntos de archivos tratarán todos los artefactos de salida como archivos normales. No desviarán directorios ni serán sensibles a los symlinks.
Etiquetas:execution
--[no]incompatible_disallow_unsound_directory_outputs
predeterminado: "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
,incompatible_change
--[no]incompatible_modify_execution_info_additive
predeterminado: “false”-
Cuando está habilitada, pasar varias marcas --modify_execution_info es aditivo. Cuando se inhabilita, solo se tiene en cuenta la última marca.
Etiquetas:execution
,affects_outputs
,loading_and_analysis
,incompatible_change
- Se acumulan varios usos de
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
-
Agrega o quita claves de la información de ejecución de una acción según la mnemotecnia de la acción. Solo se aplica a las acciones que admiten información de ejecución. Muchas acciones comunes admiten información de ejecución, p.ej., Genrule, CppCompile, Javac, StarlarkAction y TestRunner. Cuando especificas varios valores, el orden es importante porque muchas regex pueden aplicarse al mismo mnemónico.
Sintaxis: "regex=[+-]clave,regex=[+-]clave,...".
Ejemplos:
'.*=+x,.*=-y,.*=+z' agrega "x" y "z" a la información de ejecución de todas las acciones y quita "y".
"Genrule=+requires-x" agrega "requires-x" a la información de ejecución de todas las acciones de Genrule.
"(?!Genrule).*=-requires-x" quita "requires-x" de la información de ejecución para todas las acciones que no sean de Genrule.
Etiquetas:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Habilita las acciones de expansión de sintaxis y dex persistentes de Android con trabajadores.
Se expande a:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
-
Habilita el procesador de recursos de Android persistente con trabajadores.
Se expande a:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
--strategy=ProcessDatabinding=worker
--strategy=GenerateDataBindingBaseClasses=worker
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_dex_desugar
-
Habilita 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
,execution
--persistent_multiplex_android_resource_processor
-
Habilita el procesador de recursos de Android multiplexado persistente con trabajadores.
Se expande a:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_tools
-
Habilita las herramientas de Android persistentes y multiplexadas (dexing, expansión de sintaxis, procesamiento de recursos).
Se expande a:
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Etiquetas:host_machine_resource_optimizations
,execution
--[no]use_target_platform_for_tests
predeterminado: “false”-
Si es verdadero, Bazel usará la plataforma de destino para ejecutar pruebas en lugar del grupo de ejecución de pruebas.
Etiquetas:execution
- Opciones que configuran la cadena de herramientas que se usa para ejecutar acciones:
--android_compiler=<a string>
predeterminado: Consulta la descripción-
El compilador de destino de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_crosstool_top=<a build target label>
predeterminado: "//external:android/crosstool"-
Es la ubicación del compilador de C++ que se usa para las compilaciones de Android.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_grte_top=<a label>
predeterminado: Consulta la descripción-
El objetivo grte_top de Android.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
predeterminado: "android"-
Selecciona el combinador de manifiestos que se usará para las reglas android_binary. Marca para ayudar a la transición a la combinación de manifiestos de Android desde la combinación heredada.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Valor predeterminado de
--android_platforms=<a build target label>
: "" -
Establece las plataformas que usan los destinos de android_binary. Si se especifican varias plataformas, el objeto binario es un APK multiarquitectura, que contiene binarios nativos para cada plataforma de destino especificada.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_sdk=<a build target label>
predeterminado: "@bazel_tools//tools/android:sdk"-
Especifica el SDK o la plataforma de Android que se usa para compilar aplicaciones para Android.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--apple_crosstool_top=<a build target label>
predeterminado: "@bazel_tools//tools/cpp:toolchain"-
Es la etiqueta del paquete de herramientas cruzadas que se usará en las reglas de Apple y Objc, y sus dependencias.
Etiquetas:loses_incremental_state
,changes_inputs
--cc_output_directory_tag=<a string>
predeterminado: ""-
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas:affects_outputs
--compiler=<a string>
predeterminado: Consulta la descripción-
Es el compilador de C++ que se usará para compilar el destino.
Etiquetas:loading_and_analysis
,execution
--coverage_output_generator=<a build target label>
predeterminado: "@bazel_tools//tools/test:lcov_merger"-
Ubicación del binario que se usa para postprocesar informes de cobertura sin procesar. Actualmente, debe ser un grupo de archivos que contenga un solo archivo, el binario. El valor predeterminado es “//tools/test:lcov_merger”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
predeterminado: "@bazel_tools//tools/test:coverage_report_generator"-
Ubicación del 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. El valor predeterminado es "//tools/test:coverage_report_generator".
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
predeterminado: "@bazel_tools//tools/test:coverage_support"-
Ubicación de los archivos de compatibilidad que se requieren en las entradas de cada acción de prueba que recopila la cobertura de código El valor predeterminado es “//tools/test:coverage_support”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--crosstool_top=<a build target label>
predeterminado: “@bazel_tools//tools/cpp:toolchain”-
Es la etiqueta del paquete de herramientas cruzadas que se usará para compilar código C++.
Etiquetas:loading_and_analysis
,changes_inputs
,affects_outputs
--custom_malloc=<a build target label>
predeterminado: Consulta la descripción-
Especifica una implementación de malloc personalizada. Este parámetro de configuración anula los atributos malloc en las reglas de compilación.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
usos múltiples -
Es una lista de expresiones regulares separadas por comas, cada una con el prefijo - (expresión negativa) de forma opcional, asignadas (=) a una lista de objetivos de valores de restricción separados por comas. Si un objetivo no coincide con ninguna expresión negativa y con al menos una expresión positiva, la resolución de la cadena de herramientas se realizará como si hubiera declarado los valores de restricción como restricciones de ejecución. Ejemplo: //demo,-test=@platforms//cpus:x86_64 agregará 'x86_64' a cualquier destino en //demo, excepto a aquellos cuyo nombre contenga 'test'.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]experimental_include_xcode_execution_requirements
: "falso" -
Si se establece, agrega un requisito de ejecución "requires-xcode:{version}" a cada acción de Xcode. Si la versión de Xcode tiene una etiqueta con guiones, también agrega un requisito de ejecución "requires-xcode-label:{version_label}".
Etiquetas:loses_incremental_state
,loading_and_analysis
,execution
--[no]experimental_prefer_mutual_xcode
predeterminado: "true"-
Si es verdadero, usa la versión más reciente de Xcode que esté disponible de forma local y remota. Si es falso o si no hay versiones mutuas disponibles, usa la versión local de Xcode seleccionada a través de xcode-select.
Etiquetas:loses_incremental_state
--extra_execution_platforms=<comma-separated list of options>
predeterminado: ""-
Son las plataformas disponibles como plataformas de ejecución para ejecutar acciones. Las plataformas se pueden especificar por 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 establecer una vez; las instancias posteriores anularán la configuración de la marca anterior.
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 que las declaradas en el archivo WORKSPACE por register_toolchains().
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--grte_top=<a label>
predeterminado: Consulta la descripción-
Es una etiqueta para una biblioteca libc verificada. La cadena de herramientas de crosstool selecciona el valor predeterminado, y casi nunca es necesario anularlo.
Etiquetas:action_command_lines
,affects_outputs
--host_compiler=<a string>
predeterminado: Consulta la descripción-
Es el compilador de C++ que se usará para la compilación del host. Se ignora si no se configura --host_crosstool_top.
Etiquetas:loading_and_analysis
,execution
--host_crosstool_top=<a build target label>
predeterminado: Consulta la descripción-
De forma predeterminada, las opciones --crosstool_top y --compiler también se usan para la configuración de exec. Si se proporciona este indicador, Bazel usa la libc y el compilador predeterminados para el crosstool_top específico.
Etiquetas:loading_and_analysis
,changes_inputs
,affects_outputs
- Valor predeterminado de
--host_grte_top=<a label>
: ver descripción -
Si se especifica, este parámetro de configuración anula el directorio de nivel superior de libc (--grte_top) para la configuración de exec.
Etiquetas:action_command_lines
,affects_outputs
--host_platform=<a build target label>
valor predeterminado: "@bazel_tools//tools:host_platform"-
La etiqueta de una regla de plataforma que describe el sistema host.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
predeterminado: "true"-
Si es verdadero, Bazel no habilitará las funciones "host" y "nonhost" en la cadena de herramientas de C++ (consulta https://github.com/bazelbuild/bazel/issues/7407 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_android_toolchain_resolution
predeterminado: "true"-
Usa la resolución de cadena de herramientas para seleccionar el SDK de Android para las reglas de Android (Starlark y nativo)
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_apple_toolchain_resolution
predeterminado: “false”-
Usa la resolución de cadena de herramientas para seleccionar el SDK de Apple para las reglas de Apple (Starlark y nativo)
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone
predeterminado: "true"-
Si es verdadero, Bazel no reutilizará las líneas de comandos de la acción de vinculación de C++ para las líneas de comandos de indexación de lto (consulta https://github.com/bazelbuild/bazel/issues/6791 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_legacy_whole_archive
predeterminado: "true"-
Si es verdadero, Bazel no vinculará las dependencias de la biblioteca como un archivo completo de forma predeterminada (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener instrucciones de migración).
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]incompatible_require_ctx_in_configure_features
: "true" -
Si el valor es verdadero, Bazel requerirá el parámetro "ctx" en cc_common.configure_features (consulta https://github.com/bazelbuild/bazel/issues/7793 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
-
Usa objetos compartidos de interfaz si la cadena de herramientas es compatible. Actualmente, todas las cadenas de herramientas ELF admiten este parámetro de configuración.
Etiquetas:loading_and_analysis
,affects_outputs
,affects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Especifica la versión del SDK de iOS que se usará para compilar aplicaciones para iOS. Si no se especifica, se usa la versión predeterminada del SDK de iOS de "xcode_version".
Etiquetas:loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Especifica la versión del SDK de macOS que se usará para compilar aplicaciones de macOS. Si no se especifica, 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 -
Es la versión mínima del SO a la que se orienta tu compilación.
Etiquetas:loading_and_analysis
,affects_outputs
- Valor predeterminado de
--platform_mappings=<a relative path>
: "" -
Es la ubicación de un archivo de asignación que describe qué plataforma usar si no se establece ninguna o qué marcas establecer cuando ya existe una plataforma. Debe ser relativo a la raíz del espacio de trabajo principal. El valor predeterminado es "platform_mappings" (un archivo directamente debajo de la raíz del espacio de trabajo).
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
- 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
,loading_and_analysis
--python2_path=<a string>
predeterminado: Consulta la descripción-
Obsoleto, no realiza ninguna acción. Se inhabilitó con `--incompatible_use_python_toolchains`.
Etiquetas:no_op
,deprecated
--python3_path=<a string>
predeterminado: Consulta la descripción-
Obsoleto, no-op. Inhabilitado por `--incompatible_use_python_toolchains`.
Etiquetas:no_op
,deprecated
- Valor predeterminado de
--python_path=<a string>
: ver descripción -
Es la ruta de acceso absoluta del intérprete de Python que se invocó para ejecutar destinos de Python en la plataforma de destino. Obsoleto; se inhabilitó con --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
--python_top=<a build target label>
predeterminado: Consulta la descripción-
La etiqueta de un py_runtime que representa el intérprete de Python invocado para ejecutar destinos de Python en la plataforma de destino. Obsoleto; se inhabilitó con --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Especifica la versión del SDK de tvOS que se usará para compilar aplicaciones para tvOS. Si no se especifica, se usa la versión predeterminada del SDK de tvOS de "xcode_version".
Etiquetas:loses_incremental_state
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Especifica la versión del SDK de watchOS que se usará para compilar aplicaciones para watchOS. Si no se especifica, se usa la versión predeterminada del SDK de watchOS de “xcode_version”.
Etiquetas:loses_incremental_state
--xcode_version=<a string>
predeterminado: Consulta la descripción-
Si se especifica, usa Xcode de la versión determinada para las acciones de compilación relevantes. Si no se especifica, usa la versión predeterminada del ejecutor de Xcode.
Etiquetas:loses_incremental_state
--xcode_version_config=<a build target label>
predeterminado: "@bazel_tools//tools/cpp:host_xcodes"-
Es la etiqueta de la regla xcode_config que se usará para seleccionar la versión de Xcode en la configuración de compilación.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Opciones que controlan el resultado del comando:
--[no]apple_generate_dsym
predeterminado: “false”-
Determina si se deben generar archivos de símbolos de depuración (.dSYM).
Etiquetas:affects_outputs
,action_command_lines
--[no]build_runfile_links
predeterminado: "true"-
Si es verdadero, compila bosques de symlinks de runfiles para todos los destinos. Si es falso, escríbelos solo cuando una acción local, una prueba o un comando de ejecución lo requieran.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]build_runfile_manifests
: "true" -
Si es verdadero, escribe manifiestos de runfiles para todos los destinos. Si es falso, omítelos. Las pruebas locales no se ejecutarán si es falso.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]build_test_dwp
: "falso" -
Si está habilitado, cuando se compilen pruebas de C++ de forma estática y con Fission, el archivo .dwp para el objeto binario de prueba también se compilará automáticamente.
Etiquetas:loading_and_analysis
,affects_outputs
--cc_proto_library_header_suffixes=<comma-separated set of options>
predeterminado: ".pb.h"-
Establece los sufijos de los archivos de encabezado que crea una cc_proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated set of options>
predeterminado: “.pb.cc”-
Establece los sufijos de los archivos de origen que crea cc_proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
- Valor predeterminado de
--[no]experimental_proto_descriptor_sets_include_source_info
: "falso" -
Ejecuta acciones adicionales para versiones alternativas de la API de Java en una proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_proto_extra_actions
predeterminado: “false”-
Ejecuta acciones adicionales para versiones alternativas de la API de Java en una proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_save_feature_state
predeterminado: “false”-
Guarda el estado de las funciones habilitadas y solicitadas como un resultado de la compilación.
Etiquetas:affects_outputs
,experimental
--fission=<a set of compilation modes>
predeterminado: “no”-
Especifica qué modos de compilación usan la fisión para las compilaciones y los vínculos de C++. Puede ser cualquier combinación de {'fastbuild', 'dbg', 'opt'} o los valores especiales "yes" para habilitar todos los modos y "no" para inhabilitarlos.
Etiquetas:loading_and_analysis
,action_command_lines
,affects_outputs
--[no]incompatible_always_include_files_in_data
predeterminado: "true"-
Si es verdadero, las reglas nativas agregan <code>DefaultInfo.files</code> de dependencias de datos a sus archivos de ejecución, lo que coincide con el comportamiento recomendado para las reglas de Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid).
Etiquetas:affects_outputs
,incompatible_change
- Valor predeterminado de
--[no]legacy_external_runfiles
: "true" -
Si es verdadero, compila bosques de symlinks de runfiles para repositorios externos en .runfiles/wsname/external/repo (además de .runfiles/repo).
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]objc_generate_linkmap
: "falso" -
Especifica si se genera un archivo de mapa de vínculos.
Etiquetas:affects_outputs
--[no]save_temps
predeterminado: “false”-
Si se establece, se guardarán los resultados temporales de gcc. Estos incluyen archivos .s (código de ensamblador), archivos .i (C++ previamente preprocesado) y .ii (C++ preprocesado).
Etiquetas:affects_outputs
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, a diferencia de su existencia:
- Se acumulan varios usos de
--action_env=<a 'name=value' assignment with an optional value part>
-
Especifica el conjunto de variables de entorno disponibles para las acciones con configuración de destino. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o bien por el par nombre=valor, que establece el valor independientemente del entorno de invocación. Esta opción se puede utilizar varias veces; en el caso de las opciones que se brindan para la misma variable, se acumulan las últimas ganancias, las opciones para diferentes variables.
Etiquetas:action_command_lines
--android_cpu=<a string>
predeterminado: "armeabi-v7a"-
La CPU objetivo de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]android_databinding_use_androidx
predeterminado: "true"-
Genera archivos de vinculación de datos compatibles con AndroidX. Esto solo se usa con la vinculación de datos v2. Esta marca no realiza ninguna acción.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Valor predeterminado de
--[no]android_databinding_use_v3_4_args
: "true" -
Usa Android Databinding v2 con el argumento 3.4.0. Esta marca no realiza ninguna acción.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--android_dynamic_mode=<off, default or fully>
predeterminado: "off"-
Determina si las dependencias de C++ de reglas de Android se vincularán dinámicamente cuando cc_binary no cree explícitamente una biblioteca compartida. "default" significa que bazel elegirá si vincular de forma dinámica. "completamente" significa que todas las bibliotecas se vincularán de forma dinámica. "off" significa que todas las bibliotecas se vincularán en modo principalmente estático.
Etiquetas:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
predeterminado: "alphabetical"-
Establece el orden de los manifiestos que se pasan a la combinación de manifiestos para los objetos binarios de Android. 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
,execution
--[no]android_resource_shrinking
predeterminado: “false”-
Habilita la reducción de recursos para los APK android_binary que usan ProGuard.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]build_python_zip
predeterminado: “auto”-
Compila el archivo ZIP ejecutable de Python; activado en Windows, desactivado en otras plataformas.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--catalyst_cpus=<comma-separated list of options>
-
Es una lista de arquitecturas separadas por comas para las que se compilarán objetos binarios de Apple Catalyst.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Valor predeterminado de
--[no]collect_code_coverage
: "falso" -
Si se especifica, Bazel instrumentará el código (con instrumentación sin conexión siempre que sea posible) y recopilará información de cobertura durante las pruebas. Solo se verán afectados los destinos que coincidan con --instrumentation_filter. Por lo general, esta opción no debe especificarse directamente, sino que se debe usar el comando "bazel coverage".
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
,action_command_lines
- Se acumulan varios usos de
--conlyopt=<a string>
-
Opción adicional para pasar a gcc cuando se compilan archivos de origen C.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--copt=<a string>
- Opciones adicionales para pasar a gcc.
Etiquetas:action_command_lines
,affects_outputs
--cpu=<a string>
predeterminado: ""-
La CPU objetivo.
Etiquetas:changes_inputs
,affects_outputs
--cs_fdo_absolute_path=<a string>
predeterminado: Consulta la descripción- Usa la información del perfil de CSFDO para optimizar la compilación. Especifica el nombre de la ruta de acceso absoluta del archivo ZIP que contiene el archivo de perfil, un archivo de perfil LLVM sin procesar o indexado.
Etiquetas:affects_outputs
--cs_fdo_instrument=<a string>
predeterminado: Consulta la descripción-
Genera ejecutables con instrumentación de FDO sensible al contexto. Con el compilador Clang/LLVM, también acepta el nombre del directorio en el que se volcarán los archivos de perfil sin procesar durante el tiempo de ejecución.
Etiquetas:affects_outputs
--cs_fdo_profile=<a build target label>
predeterminado: Consulta la descripción-
El cs_fdo_profile que representa el perfil sensible al contexto que se usará para la optimización.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--cxxopt=<a string>
-
Es una opción adicional para pasar a gcc cuando se compilan archivos de origen C++.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--define=<a 'name=value' assignment>
-
Cada opción --define especifica una asignación para una variable de compilación.
Etiquetas:changes_inputs
,affects_outputs
--dynamic_mode=<off, default or fully>
predeterminado: "predeterminado"- determina si los objetos binarios de C++ se vincularán de forma dinámica. "default" significa que Bazel elegirá si vincular de forma dinámica. "Completamente" significa que todas las bibliotecas se vincularán de forma dinámica. "Desactivado" significa que todas las bibliotecas se vincularán en modo principalmente estático.
Etiquetas:loading_and_analysis
,affects_outputs
--[no]enable_fdo_profile_absolute_path
predeterminado: "true"-
Si se establece, el uso de fdo_absolute_profile_path generará un error.
Etiquetas:affects_outputs
--[no]enable_runfiles
predeterminado: "automático"-
Habilita el árbol de symlinks de runfiles. De forma predeterminada, está desactivado en Windows y en otras plataformas.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--experimental_action_listener=<a build target label>
- dejó de estar disponible y se reemplazó por aspectos. Usa action_listener para adjuntar una extra_action a las acciones de compilación existentes.
Etiquetas:execution
,experimental
- Valor predeterminado de
--[no]experimental_android_compress_java_resources
: "falso" -
Comprime recursos de Java en APKs
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_android_databinding_v2
predeterminado: "true"-
Usa Android Databinding v2. Esta marca no realiza ninguna acción.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_android_resource_shrinking
predeterminado: “false”-
Habilita la reducción de recursos para los APKs de android_binary que usan ProGuard.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_android_rewrite_dexes_with_rex
predeterminado: “false”-
Usa la herramienta rex para volver a escribir archivos dex.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Valor predeterminado de
--[no]experimental_collect_code_coverage_for_generated_files
: "falso" -
Si se especifica, Bazel también generará información de cobertura recopilada para los archivos generados.
Etiquetas:affects_outputs
--experimental_objc_fastbuild_options=<comma-separated list of options>
predeterminado: "-O0,-DDEBUG=1"-
Usa estas cadenas como opciones del compilador de objc fastbuild.
Etiquetas:action_command_lines
--[no]experimental_omitfp
predeterminado: “false”-
Si es verdadero, usa libunwind para el desenredo de pila y compila con -fomit-frame-pointer y -fasynchronous-unwind-tables.
Etiquetas:action_command_lines
,affects_outputs
,experimental
- Configuración predeterminada de
--experimental_output_paths=<off, content or strip>
: "desactivada" -
Qué modelo usar para determinar en qué parte del árbol de salida las reglas escriben sus resultados, en particular para compilaciones multiplataforma o multiconfiguración. Esta función es muy experimental. 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 de acceso agregando la clave "supports-path-mapping" al diccionario "execution_requirements".
Etiquetas:loses_incremental_state
,bazel_internal_configuration
,affects_outputs
,execution
- Se acumulan varios usos de
--experimental_override_name_platform_in_output_dir=<a 'label=value' assignment>
-
Cada entrada debe tener el formato etiqueta=valor, en el que etiqueta hace referencia a una plataforma y valor es el nombre abreviado que se desea usar en la ruta de salida. Solo se utiliza cuando --experimental_platform_in_output_dir es verdadero. Tiene la prioridad de nombres más alta.
Etiquetas:affects_outputs
,experimental
- Valor predeterminado de
--[no]experimental_platform_in_output_dir
: "falso" -
Si es verdadero, se usa un nombre corto para la plataforma de destino en el nombre del directorio de salida en lugar de la CPU. El esquema exacto es experimental y está sujeto a cambios: primero, en el caso poco frecuente de que la opción --platforms no tenga exactamente un valor, se usa un hash de la opción platforms. A continuación, si se registró algún nombre corto para la plataforma actual con --experimental_override_name_platform_in_output_dir, se usará ese nombre corto. Luego, si se establece --experimental_use_platforms_in_output_dir_legacy_heuristic, usa un nombre corto basado en la etiqueta de plataforma actual. Por último, se usa un hash de la opción de plataforma como último recurso.
Etiquetas:affects_outputs
,experimental
- Valor predeterminado de
--[no]experimental_use_llvm_covmap
: "falso" -
Si se especifica, Bazel generará información del mapa de cobertura de llvm-cov en lugar de gcov cuando se habilite collect_code_coverage.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic
predeterminado: "true"-
Usa esta marca solo como parte de una estrategia de migración o prueba sugerida. Ten en cuenta que la heurística presenta deficiencias conocidas y se sugiere migrar a solo --experimental_override_name_platform_in_output_dir.
Etiquetas:affects_outputs
,experimental
--fat_apk_cpu=<comma-separated set of options>
predeterminado: "armeabi-v7a"-
Si configuras esta opción, se habilitan los APKs multiarquitectura, que contienen objetos binarios nativos para todas las arquitecturas de destino especificadas, p.ej., --fat_apk_cpu=x86,armeabi-v7a. Si se especifica esta marca, se ignora --android_cpu para las dependencias de las reglas android_binary.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]fat_apk_hwasan
predeterminado: “false”-
Indica si se deben crear divisiones HWASAN.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Valor predeterminado de
--fdo_instrument=<a string>
: ver descripción -
Genera ejecutables con la instrumentación de FDO. Con el compilador Clang/LLVM, también acepta el nombre del directorio en el que se volcarán los archivos de perfil sin procesar durante el tiempo de ejecución.
Etiquetas:affects_outputs
- Valor predeterminado de
--fdo_optimize=<a string>
: ver descripción -
Usa la información del perfil de FDO para optimizar la compilación. Especifica el nombre de un archivo ZIP que contenga un árbol de archivos .gcda, un archivo afdo que contenga un perfil automático o un archivo de perfil LLVM. Esta marca también acepta archivos especificados como etiquetas (p.ej., "//foo/bar:file.afdo"; es posible que debas agregar una directiva "exports_files" al paquete correspondiente) y etiquetas que apuntan a destinos "fdo_profile". Esta marca se reemplazará por la regla `fdo_profile`.
Etiquetas:affects_outputs
--fdo_prefetch_hints=<a build target label>
predeterminado: Consulta la descripción-
Usa sugerencias de almacenamiento en caché para la carga previa.
Etiquetas:affects_outputs
- Valor predeterminado de
--fdo_profile=<a build target label>
: ver descripción -
Es el fdo_profile que representa el perfil que se usará para la optimización.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--features=<a string>
-
Las funciones determinadas estarán habilitadas o inhabilitadas de forma predeterminada para los destinos compilados en la configuración de destino. Si especificas -<feature>, se inhabilitará la función. Los atributos negativos siempre anulan los positivos. Consulta también --host_features
Etiquetas:changes_inputs
,affects_outputs
--[no]force_pic
predeterminado: “false”-
Si está habilitada, todas las compilaciones de C++ producen código independiente de la posición ("-fPIC"), las vinculaciones prefieren las bibliotecas compiladas previamente de PIC en lugar de las bibliotecas que no son de PIC, y las vinculaciones producen ejecutables independientes de la posición ("-pie").
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan varios usos de
--host_action_env=<a 'name=value' assignment with an optional value part>
-
Especifica el conjunto de variables de entorno disponibles para las acciones con configuraciones de ejecución. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o bien por el par nombre=valor, que establece el valor independientemente del entorno de invocación. Esta opción se puede utilizar varias veces; en el caso de las opciones que se brindan para la misma variable, se acumulan las últimas ganancias, las 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
,action_command_lines
- Se acumulan
--host_conlyopt=<a string>
usos múltiples -
Es una opción adicional para pasar al compilador C cuando se compilan archivos de origen C (pero no C++) en las configuraciones de ejecución.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--host_copt=<a string>
-
Opciones adicionales para pasar al compilador C para herramientas compiladas en las configuraciones de ejecución.
Etiquetas:action_command_lines
,affects_outputs
--host_cpu=<a string>
predeterminado: ""-
La CPU del host.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan varios usos de
--host_cxxopt=<a string>
-
Opciones adicionales para pasar al compilador de C++ para herramientas compiladas en las configuraciones de ejecución.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--host_features=<a string>
-
Las funciones determinadas se habilitarán o inhabilitarán de forma predeterminada para los destinos compilados en la configuración de ejecución. Si especificas -<feature>, se inhabilitará la función. Los atributos negativos siempre anulan los positivos.
Etiquetas:changes_inputs
,affects_outputs
--host_force_python=<PY2 or PY3>
predeterminado: Consulta la descripción-
Anula la versión de Python para la configuración de ejecución. Puede ser “PY2” o “PY3”.
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan varios usos de
--host_linkopt=<a string>
-
Opción adicional para pasar al vinculador cuando se vinculan herramientas en las configuraciones de ejecución.
Etiquetas:action_command_lines
,affects_outputs
- 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 compatible de macOS para los destinos de host. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan varios usos de
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
-
Opciones adicionales para pasar de forma selectiva al compilador C/C++ cuando se compilan ciertos archivos en las configuraciones de ejecución. Esta opción se puede aprobar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. En la que regex_filter representa una lista de patrones de expresiones regulares para incluir y excluir (consulta también --instrumentation_filter). option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe estar entre comillas con una barra diagonal inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos de gcc de todos los archivos cc en //foo/, excepto bar.cc.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--host_swiftcopt=<a string>
usos múltiples -
Opciones adicionales para pasar a swiftc para herramientas de ejecución.
Etiquetas:action_command_lines
,affects_outputs
- Valor predeterminado de
--[no]incompatible_auto_exec_groups
: "falso" -
Cuando se habilita, se crea automáticamente un grupo de ejecución para cada cadena de herramientas que usa una regla. Para que esto funcione, la regla debe especificar el parámetro "toolchain" en sus acciones. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/17134.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_merge_genfiles_directory
predeterminado: "true"-
Si es verdadero, el directorio genfiles se une al directorio bin.
Etiquetas:affects_outputs
,incompatible_change
- 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
,incompatible_change
--[no]instrument_test_targets
predeterminado: “false”-
Cuando se habilita la cobertura, 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 la cobertura esté habilitada, solo se instrumentarán las reglas con nombres incluidos en el filtro basado en regex especificado. En su lugar, se excluyen las reglas con el prefijo “-”. Ten en cuenta que solo se instrumentan las reglas que no son de prueba, a menos que se habilite --instrument_test_targets.
Etiquetas:affects_outputs
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Versión mínima de iOS compatible con dispositivos y simuladores de destino. Si no se especifica, se usa "ios_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan varios usos de
--ios_multi_cpus=<comma-separated list of options>
-
Es una lista de arquitecturas separadas por comas con las que se compila una ios_application. El resultado es un binario universal que contiene todas las arquitecturas especificadas.
Etiquetas:loses_incremental_state
,loading_and_analysis
--[no]legacy_whole_archive
predeterminado: "true"-
Deja de estar disponible y se reemplaza por --incompatible_remove_legacy_whole_archive (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener más información). Cuando está activado, usa --whole-archive para las reglas cc_binary que tienen linkshared=True y linkstatic=True o “-static” en linkopts. Esto es solo para la retrocompatibilidad. Una mejor alternativa es usar alwayslink=1 cuando sea necesario.
Etiquetas:action_command_lines
,affects_outputs
,deprecated
- Se acumulan varios usos de
--linkopt=<a string>
- : Opción adicional para pasar a gcc cuando se realiza la vinculación.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--ltobackendopt=<a string>
-
Opción adicional para pasar al paso de backend de LTO (en --features=thin_lto).
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--ltoindexopt=<a string>
usos múltiples -
Opción adicional para pasar al paso de indexación de LTO (en --features=thin_lto).
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--macos_cpus=<comma-separated list of options>
usos múltiples -
Es una lista separada por comas de las arquitecturas para las que se compilarán los objetos binarios de Apple macOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Versión mínima de macOS compatible para los destinos. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
--memprof_profile=<a build target label>
predeterminado: Consulta la descripción-
Usar el perfil de memprof.
Etiquetas:affects_outputs
--[no]objc_debug_with_GLIBCXX
predeterminado: “false”-
Si se establece y el modo de compilación se establece en "dbg", define GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC y GLIBCPP_CONCEPT_CHECKS.
Etiquetas:action_command_lines
--[no]objc_enable_binary_stripping
predeterminado: “false”-
Indica si se deben quitar los símbolos y el código muerto en los objetos binarios vinculados. Se realizarán eliminaciones de objetos binarios si se especifican esta marca y --compilation_mode=opt.
Etiquetas:action_command_lines
- Se acumulan varios usos de
--objccopt=<a string>
-
Opciones adicionales para pasar a gcc cuando se compilan archivos de origen Objective-C/C++.
Etiquetas:action_command_lines
- Se acumulan varios usos de
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
-
Opciones adicionales para pasar a gcc de forma selectiva cuando se compilan ciertos archivos. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. En la que regex_filter representa una lista de patrones de expresiones regulares para incluir y excluir (consulta también --instrumentation_filter). option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe estar entre comillas con una barra diagonal inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos de gcc de todos los archivos cc en //foo/, excepto bar.cc.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
-
Opciones adicionales para pasar de forma selectiva al backend de LTO (en --features=thin_lto) cuando se compilan ciertos objetos de backend. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. En la que regex_filter representa una lista de patrones de expresión regular para incluir y excluir. option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe estar entre comillas con una barra diagonal inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos del backend LTO de todos los archivos o en //foo/, excepto bar.o.
Etiquetas:action_command_lines
,affects_outputs
--platform_suffix=<a string>
predeterminado: Consulta la descripción-
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas:loses_incremental_state
,affects_outputs
,loading_and_analysis
--propeller_optimize=<a build target label>
predeterminado: Consulta la descripción-
Usa la información del perfil de Propeller para optimizar el destino de compilación.Un perfil de Propeller debe constar de al menos uno de dos archivos: un perfil de cc y un perfil de ld. Esta marca acepta una etiqueta de compilación que debe hacer referencia a los archivos de entrada del perfil del propeler. Por ejemplo, el archivo BUILD que define la etiqueta, en a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)Es posible que se deba agregar una directiva exports_files al paquete correspondiente para que Bazel pueda ver estos archivos. La opción debe usarse como: --propeller_optimize=//a/b:propeller_profile
Etiquetas:action_command_lines
,affects_outputs
--propeller_optimize_absolute_cc_profile=<a string>
predeterminado: Consulta la descripción-
Nombre de ruta de acceso absoluta del archivo cc_profile para compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
predeterminado: Consulta la descripción-
Es el nombre de ruta de acceso absoluto del archivo ld_profile para las compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
--run_under=<a prefix in front of command>
predeterminado: Consulta la descripción-
Prefijo para insertar antes de los ejecutables para los comandos “test” y “run”. Si el valor es "foo -bar" y la línea de comandos de ejecución es "test_binary -baz", la línea de comandos final es "foo -bar test_binary -baz".También puede ser una etiqueta para un destino ejecutable. Algunos ejemplos son: "valgrind", "strace", "strace -c", "valgrind --quiet --num-callers=20", "//package:target", "//package:target --options".
Etiquetas:action_command_lines
-
Si es verdadero, las bibliotecas nativas que contienen funcionalidad idéntica se compartirán entre diferentes destinos.
Etiquetas:loading_and_analysis
,affects_outputs
- Valor predeterminado de
--[no]stamp
: "falso" -
Marca los objetos binarios con la fecha, el nombre de usuario, el nombre de host, la información del espacio de trabajo, etcétera.
Etiquetas:affects_outputs
--strip=<always, sometimes or never>
predeterminado: “a veces”- especifica si se deben quitar los objetos binarios y las bibliotecas compartidas (con "-Wl,--strip-debug"). El valor predeterminado de "sometimes" significa quitar si --compilation_mode=fastbuild.
Etiquetas:affects_outputs
- Se acumulan
--stripopt=<a string>
usos múltiples -
Opciones adicionales para pasar a la eliminación cuando se genera un objeto binario "<name>.stripped".
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--swiftcopt=<a string>
usos múltiples -
Opciones adicionales para pasar a la compilación con Swift.
Etiquetas:action_command_lines
- Se acumulan varios usos de
--tvos_cpus=<comma-separated list of options>
-
Lista de arquitecturas separadas por comas para las que se compilarán objetos binarios de tvOS de Apple.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Valor predeterminado de
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima compatible de tvOS para los simuladores y dispositivos de destino. Si no se especifica, se usa "tvos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan
--visionos_cpus=<comma-separated list of options>
usos múltiples -
Es una lista separada por comas de las arquitecturas para las que se compilarán los objetos binarios de Apple visionOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Se acumulan varios usos de
--watchos_cpus=<comma-separated list of options>
-
Es una lista separada por comas de las arquitecturas para las que se compilarán los objetos binarios de Apple watchOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Versión mínima compatible de watchOS para los simuladores y dispositivos de destino. Si no se especifica, se usa "watchos_sdk_version".
Etiquetas:loses_incremental_state
--xbinary_fdo=<a build target label>
predeterminado: Consulta la descripción- Usa la información del perfil de XbinaryFDO para optimizar la compilación. Especifica el nombre del perfil de multibinario predeterminado. Cuando la opción se usa junto con --fdo_instrument/--fdo_optimize/--fdo_profile, esas opciones siempre prevalecerán como si xbinary_fdo nunca se especificara.
Etiquetas:affects_outputs
- Opciones que afectan la exactitud con la que Bazel aplica de manera forzosa las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
- Valor predeterminado de
--auto_cpu_environment_group=<a build target label>
: "" -
Declara el environment_group que se usará para asignar automáticamente los valores de CPU a los valores de target_environment.
Etiquetas:changes_inputs
,loading_and_analysis
,experimental
--[no]check_licenses
predeterminado: “false”-
Verifica que las restricciones de licencias impuestas por los paquetes dependientes no entren en conflicto con los modos de distribución de los destinos que se compilan. De forma predeterminada, 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 de destino se degradan a advertencias.
Etiquetas:build_file_semantics
--[no]desugar_for_android
predeterminado: "true"-
Indica si se debe expandir el código de bytes de Java 8 antes de dexificarlo.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]desugar_java8_libs
predeterminado: “false”-
Indica si se deben incluir bibliotecas Java 8 compatibles en apps para dispositivos heredados.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Valor predeterminado de
--[no]enforce_constraints
: "true" -
Verifica los entornos con los que cada destino es compatible y, además, informa los errores si algún destino tiene dependencias que no admiten los mismos entornos.
Etiquetas:build_file_semantics
--[no]experimental_check_desugar_deps
predeterminado: "true"-
Determina si se debe volver a verificar la expansión correcta a nivel binario de Android.
Etiquetas:eagerness_to_exit
,loading_and_analysis
,experimental
--experimental_import_deps_checking=<off, warning or error>
predeterminado: “OFF”-
Cuando esté habilitada, verifica si las dependencias de una aar_import están completas. Esta aplicación puede romper la compilación o generar advertencias.
Etiquetas:loading_and_analysis
- Configuración predeterminada de
--experimental_one_version_enforcement=<off, warning or error>
: "DESACTIVADA" -
Cuando está habilitada, se aplica la regla de que una regla java_binary no puede contener más de una versión del mismo archivo de clase en la ruta de acceso a clases. Esta aplicación forzosa puede interrumpir la compilación o generar advertencias.
Etiquetas:loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
predeterminado: "predeterminado"-
Si es verdadero, verifica que un destino de Java declare explícitamente todos los destinos utilizados directamente como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files
predeterminado: “false”-
Si se habilita, verifica solo prueba para los destinos de requisitos previos que son archivos de salida. Para ello, busca la regla de generación solo de prueba. Esto coincide con la verificación de visibilidad.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_check_visibility_for_toolchains
predeterminado: “false”-
Si está habilitada, la verificación de visibilidad también se aplica a las implementaciones de la cadena de herramientas.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_disable_native_android_rules
predeterminado: “false”-
Si se habilita, se inhabilita el uso directo de las reglas nativas de Android. Usa las reglas de Android de Starlark de https://github.com/bazelbuild/rules_android.
Etiquetas:eagerness_to_exit
,incompatible_change
--[no]incompatible_disable_native_apple_binary_rule
predeterminado: “false”-
Sin operación. Se mantiene aquí para la retrocompatibilidad.
Etiquetas:eagerness_to_exit
,incompatible_change
--[no]incompatible_python_disable_py2
predeterminado: "true"-
Si es verdadero, el uso de la configuración de Python 2 generará un error. Esto incluye python_version=PY2, srcs_version=PY2 y srcs_version=PY2ONLY. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/15684.
Etiquetas:loading_and_analysis
,incompatible_change
- 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
,incompatible_change
--[no]one_version_enforcement_on_java_tests
predeterminado: "true"-
Cuando se habilita, y con experimental_one_version_enforcement configurado en un valor que no es NONE, se aplica una versión en los destinos java_test. Esta marca se puede inhabilitar para mejorar el rendimiento incremental de las pruebas a expensas de detectar posibles incumplimientos de una versión.
Etiquetas:loading_and_analysis
--python_native_rules_allowlist=<a build target label>
predeterminado: Consulta la descripción-
Es una lista de entidades permitidas (objetivo de package_group) que se usará cuando se aplique --incompatible_python_disallow_native_rules.
Etiquetas:loading_and_analysis
--[no]strict_filesets
predeterminado: “false”-
Si esta opción está habilitada, los conjuntos de archivos que cruzan los límites de los paquetes se informan como errores.
Etiquetas:build_file_semantics
,eagerness_to_exit
- Valor predeterminado de
--strict_proto_deps=<off, warn, error, strict or default>
: "error" -
A menos que esté desactivado, comprueba que un destino de proto_library declare de forma explícita todos los destinos utilizados directamente como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
--strict_public_imports=<off, warn, error, strict or default>
predeterminado: "off"-
A menos que esté desactivado, comprueba que un objetivo de proto_library declare de forma explícita todos los objetivos que se usan en "import public" como exportados.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
--[no]strict_system_includes
predeterminado: “false”-
Si es verdadero, también se deben declarar los encabezados que se encuentran en el sistema incluyen rutas de acceso (-isystem).
Etiquetas:loading_and_analysis
,eagerness_to_exit
- Se acumulan
--target_environment=<a build target label>
usos múltiples -
Declara el entorno de destino de esta compilación. Debe ser una referencia de etiqueta a una regla de "entorno". Si se especifica, todos los objetivos de nivel superior deben ser compatibles con este entorno.
Etiquetas:changes_inputs
- Opciones que afectan los resultados de la firma de una compilación:
--apk_signing_method=<v1, v2, v1_v2 or v4>
predeterminado: “v1_v2”-
Implementación que se usará para firmar APKs
Etiquetas:action_command_lines
,affects_outputs
,loading_and_analysis
--[no]device_debug_entitlements
predeterminado: "true"-
Si se configura y el modo de compilación no es "opt", las apps objc incluirán derechos de depuración cuando firmen.
Etiquetas:changes_inputs
--ios_signing_cert_name=<a string>
predeterminado: Consulta la descripción-
Es el nombre del certificado que se usará para la firma de iOS. Si no se establece, se usará el perfil de aprovisionamiento. Puede ser la preferencia de identidad del llavero del certificado o la substring del nombre común del certificado, según la página de man de codesign (IDENTIDADES DE FIRMA).
Etiquetas:action_command_lines
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.:
--[no]incompatible_disallow_legacy_py_provider
predeterminado: "true"-
No se realizará ninguna acción, se quitará pronto.
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]incompatible_disallow_sdk_frameworks_attributes
: "falso" -
Si el valor es verdadero, no permitir los atributos sdk_frameworks y bad_sdk_frameworks en objc_library y objc_import.
Etiquetas:build_file_semantics
,incompatible_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
,incompatible_change
--[no]incompatible_python_disallow_native_rules
predeterminado: “false”-
Cuando es verdadero, se produce un error cuando se usan las reglas py_* integradas. En su lugar, se deben usar las reglas rule_python. Consulta https://github.com/bazelbuild/bazel/issues/17773 para obtener más información y las instrucciones de migración.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones que rigen el comportamiento del entorno de prueba o del ejecutor de pruebas:
--[no]allow_analysis_failures
predeterminado: “false”-
Si es verdadero, una falla de análisis de un objetivo de regla genera la propagación del objetivo de una instancia de AnalysisFailureInfo que contiene la descripción del error, en lugar de generar una falla de compilación.
Etiquetas:loading_and_analysis
,experimental
--analysis_testing_deps_limit=<an integer>
predeterminado: “2000”-
Establece la cantidad máxima de dependencias transitivas a través de un atributo de regla con una transición de configuración for_analysis_testing. Si superas este límite, se producirá un error de regla.
Etiquetas:loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure
predeterminado: “false”-
Si es verdadero, las fallas de la acción de dex2oat causarán que la compilación falle en lugar de ejecutar dex2oat durante el tiempo de ejecución de la prueba.
Etiquetas:loading_and_analysis
,experimental
- Se acumulan varios usos de
--default_test_resources=<a resource name followed by equal and 1 float or 4 float, e.g. memory=10,30,60,100>
- Anula la cantidad de recursos predeterminados para las pruebas. El formato esperado es <resource>=<value>. Si se especifica un solo número positivo como <value>, se anularán los recursos predeterminados para todos los tamaños de prueba. Si se especifican 4 números separados por comas, estos anularán 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, seguidos de forma opcional por [-|*]<float> (p. ej., memory=HOST_RAM*.1,HOST_RAM*.2,HOST_RAM*.3,HOST_RAM*.4). Los recursos de prueba predeterminados que especifica esta marca se anulan con los recursos explícitos que se especifican en las etiquetas.
- Valor predeterminado de
--[no]experimental_android_use_parallel_dex2oat
: "falso" -
Usa dex2oat en paralelo para acelerar android_test.
Etiquetas:loading_and_analysis
,host_machine_resource_optimizations
,experimental
- Valor predeterminado de
--[no]ios_memleaks
: "falso" -
Habilita la verificación de fugas de memoria en los destinos ios_test.
Etiquetas:action_command_lines
- Valor predeterminado de
--ios_simulator_device=<a string>
: ver descripción -
Es el dispositivo que se simula cuando se ejecuta una aplicación para iOS en el simulador, p.ej., "iPhone 6". Para obtener una lista de dispositivos, ejecuta "xcrun simctl list devicetypes" en la máquina en la que se ejecutará el simulador.
Etiquetas:test_runner
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Es la versión de iOS que se ejecutará en el simulador durante la ejecución o las pruebas. Esto se ignora para las reglas ios_test si se especifica un dispositivo de destino en la regla.
Etiquetas:test_runner
- Se acumulan varios usos de
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
- especifica la cantidad de veces que se debe ejecutar cada prueba. Si alguno de esos intentos falla por algún motivo, se considera que toda la prueba falló. Por lo general, el valor especificado es solo un número entero. Ejemplo: --runs_per_test=3 ejecutará todas las pruebas 3 veces. Sintaxis alternativa: regex_filter@runs_per_test. En 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 pasado más recientemente que coincida tiene prioridad. Si no hay coincidencias, la prueba solo se ejecuta una vez.
- Se acumulan
--test_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica variables de entorno adicionales que se insertarán en el entorno del ejecutor de pruebas. Las variables se pueden especificar por nombre, en cuyo caso su valor se leerá del entorno del cliente de Bazel, o bien por el par nombre=valor. Esta opción se puede usar varias veces para especificar varias variables. Solo lo usa el comando "bazel test".
Etiquetas:test_runner
--test_timeout=<a single integer or comma-separated list of 4 integers>
predeterminado: “-1”- Anula los valores predeterminados de tiempo de espera de prueba para los tiempos de espera de prueba (en segundos). Si se especifica un solo valor de número entero positivo, se anularán todas las categorías. Si se especifican 4 números enteros separados por comas, se anularán los tiempos de espera para corto, moderado, largo y eterno (en ese orden). De cualquier forma, un valor de -1 le indica a blaze que use sus tiempos de espera predeterminados para esa categoría.
--[no]zip_undeclared_test_outputs
predeterminado: "true"-
Si es verdadero, los resultados de 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: "conservative"-
Cómo resolver dependencias de aspecto cuando el formato de salida es {xml,proto,record}. "Desactivado" significa que no se resuelven las dependencias de aspecto. "Conservador" (la opción predeterminada) significa que se agregan todas las dependencias de aspecto declaradas, independientemente de si se les asigna la clase de regla de dependencias directas. "Preciso" significa que solo se agregan los aspectos que pueden estar activos según la clase de regla de las dependencias directas. Ten en cuenta que el modo preciso requiere la carga de otros paquetes para evaluar un solo objetivo, lo que lo hace más lento que los otros modos. Además, ten en cuenta que incluso el modo preciso no es del todo preciso: la decisión de calcular un aspecto se toma en la fase de análisis, que no se ejecuta durante la "consulta de bazel".
Etiquetas:build_file_semantics
--[no]consistent_labels
predeterminado: “false”-
Si está habilitada, cada comando de consulta emite etiquetas como si fuera la función Starlark <code>str</code> aplicada a una instancia de <code>Label</code>. Esto es útil para las herramientas que deben coincidir con el resultado de diferentes comandos de consulta o etiquetas emitidos por reglas. Si no están habilitados, los formateadores de salida pueden emitir nombres de repositorio aparentes (en relación con el repositorio principal) para que el resultado sea más legible.
Etiquetas:terminal_output
--[no]experimental_explicit_aspects
predeterminado: “false”-
aquery, cquery: si 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 gráfico se emitirá "factorizado", es decir, los nodos topológicamente equivalentes se combinarán y sus etiquetas se concatenarán. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--graph:node_limit=<an integer>
predeterminado: "512"-
Es la longitud máxima de la cadena de etiqueta para un nodo de grafo en el resultado. Las etiquetas más largas se truncan. -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 está habilitada, se incluirán dependencias implícitas en el gráfico de dependencias sobre el que opera la consulta. Una dependencia implícita es aquella que no se especifica explícitamente en el archivo BUILD, pero que Bazel agrega. En el caso de cquery, esta opción controla el filtrado de cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
- Valor predeterminado de
--[no]include_aspects
: "true" -
aquery, cquery: Indica si se deben incluir acciones generadas por aspectos en el resultado. query: No-op (siempre se siguen los aspectos).
Etiquetas:terminal_output
--[no]incompatible_package_group_includes_double_slash
predeterminado: "true"-
Si está habilitada, cuando se genere el atributo "packages" de package_group, no se omitirá el "//" inicial.
Etiquetas:terminal_output
,incompatible_change
- 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 el valor de --universe_scope inferido para una expresión de consulta que usa funciones centradas en el universo (p.ej., "allrdeps") puede no ser lo que deseas, por lo que debes usar esta opción solo si sabes lo que estás haciendo. Consulta https://bazel.build/reference/query#sky-query para obtener detalles y ejemplos. Si se establece --universe_scope, se ignora el valor de esta opción. Nota: Esta opción solo se aplica a "query" (es decir, no a "cquery").
Etiquetas:loading_and_analysis
--[no]line_terminator_null
predeterminado: “false”-
Indica si cada formato termina con \0 en lugar de un salto de línea.
Etiquetas:terminal_output
--[no]nodep_deps
predeterminado: "true"-
Si está habilitada, las dependencias de los atributos "nodep" se incluirán en el gráfico de dependencias sobre el que opera la consulta. Un ejemplo común de un atributo "nodep" es "visibility". Ejecuta y analiza el resultado de "info build-language" para obtener información sobre todos los atributos "nodep" en el lenguaje de compilación.
Etiquetas:build_file_semantics
--output=<a string>
predeterminado: "label"-
Es el formato en el que se deben imprimir los resultados de cquery. Los valores permitidos para cquery son: etiqueta, etiqueta_tipo, textoproto, transiciones, proto, proto_transmitido y jsonproto. Si seleccionas "transiciones", también debes especificar la opción --transitions=(lite|full).
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:default_values
: "true" -
Si el valor es "true", se incluirán los atributos cuyo valor no se especifique de forma explícita en el archivo BUILD. De lo contrario, se omitirán. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
--[no]proto:definition_stack
predeterminado: “false”-
Propaga el campo proto definition_stack, que registra para cada instancia de regla la pila de llamadas de Starlark en el momento en que se definió la clase de la regla.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:flatten_selects
: "true" -
Si está habilitada, los atributos configurables creados por select() se aplanan. En el caso de los tipos de lista, la representación aplanada es una lista que contiene cada valor del mapa de selección exactamente una vez. Los tipos escalares se aplanan a nulos.
Etiquetas:build_file_semantics
--[no]proto:include_attribute_source_aspects
predeterminado: “false”-
Propaga el campo proto source_aspect_name de cada atributo con el aspecto de origen del que proviene el atributo (cadena vacía si no es así).
Etiquetas:terminal_output
--[no]proto:include_configurations
predeterminado: "true"-
Si está habilitado, el resultado de proto incluirá información sobre las configuraciones. Cuando se inhabilita,el formato de salida de cquery proto se asemeja al formato de salida de la consulta.
Etiquetas:affects_outputs
--[no]proto:include_synthetic_attribute_hash
predeterminado: “false”-
Indica si se debe calcular y propagar el atributo $internal_attr_hash.
Etiquetas:terminal_output
--[no]proto:instantiation_stack
predeterminado: “false”-
Propaga la pila de llamadas de creación de instancias de cada regla. Ten en cuenta que esto requiere que la pila esté presente
Etiquetas:terminal_output
--[no]proto:locations
predeterminado: "true"-
Indica si se debe generar información de ubicación en el resultado de proto.
Etiquetas:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
predeterminado: “all”-
Es una lista de atributos separados por comas que se deben incluir en el resultado. La configuración predeterminada es todos los atributos. Establece una cadena vacía para no mostrar ningún atributo. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
--[no]proto:rule_inputs_and_outputs
predeterminado: "true"-
Indica si se propagan o no los campos rule_input y rule_output.
Etiquetas:terminal_output
--query_file=<a string>
predeterminado: ""-
Si se establece, la consulta leerá la consulta del archivo que se nombra aquí, en lugar de la línea de comandos. Especificar un archivo aquí y una consulta de línea de comandos es un error.
Etiquetas:changes_inputs
- Valor predeterminado de
--[no]relative_locations
: "falso" -
Si es verdadero, la ubicación de los archivos BUILD en los resultados de xml y proto será relativa. De forma predeterminada, el resultado de la ubicación es una ruta de acceso absoluta y no será coherente en todas las máquinas. Puedes establecer esta opción en verdadero para obtener un resultado coherente en todas las máquinas.
Etiquetas:terminal_output
--show_config_fragments=<off, direct or transitive>
predeterminado: "off"-
Muestra los fragmentos de configuración que requiere una regla y sus dependencias transitivas. Esto puede ser útil para evaluar cuánto se puede recortar un gráfico objetivo configurado.
Etiquetas:affects_outputs
- 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 especifican --starlark:expr ni --starlark:file, esta opción se establecerá de forma predeterminada en "str(target.label)". Especificar --starlark:expr y --starlark:file es un error.
Etiquetas:terminal_output
--starlark:file=<a string>
predeterminado: ""-
Es el nombre de un archivo que define una función Starlark llamada "format", de un argumento, que se aplica a cada destino configurado para darle formato como una cadena. Especificar --starlark:expr y --starlark:file es un error. Consulta la ayuda de --output=starlark para obtener más detalles.
Etiquetas:terminal_output
--[no]tool_deps
predeterminado: "true"-
Consulta: Si se inhabilita, las dependencias de "configuración de ejecución" no se incluirán en el gráfico de dependencias sobre el que opera la consulta. Un borde de dependencia de "configuración de ejecución", como el de cualquier regla "proto_library" al compilador de protocolos, suele apuntar a una herramienta que se ejecuta durante la compilación en lugar de a una parte del mismo programa "objetivo".
Cquery: Si se inhabilita, filtra todos los objetivos configurados que crucen una transición de ejecución desde el objetivo de nivel superior que descubrió este objetivo configurado. Esto significa que, si el objetivo de nivel superior está en la configuración de destino, solo se mostrarán los objetivos configurados también en la configuración de destino. Si el objetivo de nivel superior está en la configuración de exec, solo se mostrarán los objetivos configurados por exec. Esta opción NO excluirá las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
- Valor predeterminado de
--transitions=<full, lite or none>
: “none” -
Es el formato en el que cquery imprimirá la información de transición.
Etiquetas:affects_outputs
--universe_scope=<comma-separated list of options>
predeterminado: ""-
Es un conjunto de patrones de destino (aditivos y sustractivos) separados por comas. La consulta se puede realizar en el universo definido por el cierre transitivo de los destinos especificados. Esta opción se usa para los comandos query y cquery.
En el caso de cquery, la entrada de esta opción son los objetivos en los que se compilan todas las respuestas, por lo que esta opción puede afectar las configuraciones y las transiciones. Si no se especifica esta opción, se supone que los destinos de nivel superior son los que se analizaron de la expresión de consulta. Nota: En el caso de cquery, si no se especifica esta opción, es posible que la compilación falle si los destinos analizados de la expresión de consulta no se pueden compilar con opciones de nivel superior.
Etiquetas:loading_and_analysis
- Opciones que activan optimizaciones del tiempo de compilación:
--[no]experimental_filter_library_jar_with_program_jar
predeterminado: “false”-
Filtra el ProgramJar de ProGuard para quitar las clases que también estén presentes en el LibraryJar.
Etiquetas:action_command_lines
- Valor predeterminado de
--[no]experimental_inmemory_dotd_files
: "true" -
Si se habilita, los archivos .d de C++ se pasarán en la memoria directamente desde los nodos de compilación remotos en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_inmemory_jdeps_files
predeterminado: "true"-
Si está habilitado, los archivos de dependencia (.jdeps) generados a partir de compilaciones de Java se pasarán en la memoria directamente desde los nodos de compilación remotos en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_objc_include_scanning
predeterminado: “false”-
Indica si se debe incluir el análisis de C/C++ objetivo.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
- Valor predeterminado de
--[no]experimental_retain_test_configuration_across_testonly
: "falso" -
Cuando se habilita, --trim_test_configuration no recortará la configuración de prueba de las reglas marcadas como testonly=1. Esto se hace para reducir los problemas de conflicto de acciones cuando las reglas que no son de prueba dependen de las reglas de cc_test. No tiene efecto si --trim_test_configuration es falso.
Etiquetas:loading_and_analysis
,loses_incremental_state
- Valor predeterminado de
--[no]experimental_starlark_cc_import
: "falso" -
Si está habilitada, se puede usar la versión de Starlark de cc_import.
Etiquetas:loading_and_analysis
,experimental
- Valor predeterminado de
--[no]experimental_unsupported_and_brittle_include_scanning
: "falso" -
Determina si se deben reducir las entradas a la compilación de C/C++ a través del análisis de líneas #include de los archivos de entrada. Esto puede mejorar el rendimiento y la incrementalidad, ya que reduce el tamaño de los árboles de entrada de compilación. Sin embargo, también puede interrumpir las compilaciones porque el escáner de inclusión no implementa por completo la semántica del preprocesador C. En particular, no comprende las directivas #include dinámicas y omite la lógica condicional del preprocesador. Úsala bajo tu propia responsabilidad. Se cerrarán todos los problemas relacionados con esta marca que se hayan presentado.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
--[no]incremental_dexing
predeterminado: "true"-
Realiza la mayor parte del trabajo de dexing por separado para cada archivo JAR.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]objc_use_dotd_pruning
predeterminado: "true"-
Si se establece, se usarán los archivos .d emitidos por clang para podar el conjunto de entradas que se pasan a las compilaciones de objc.
Etiquetas:changes_inputs
,loading_and_analysis
--[no]process_headers_in_dependencies
predeterminado: “false”-
Cuando 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, se borran las opciones relacionadas con las pruebas debajo del nivel superior de la compilación. Cuando esta marca está activa, las pruebas no se pueden compilar como dependencias de reglas que no son de prueba, pero los cambios en las opciones relacionadas con pruebas no harán que estas reglas se vuelvan a analizar.
Etiquetas:loading_and_analysis
,loses_incremental_state
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Valor predeterminado de
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: “-.*”. -
Imprime información de depuración durante la resolución de la cadena de herramientas. La marca toma una regex, que se compara con los tipos de cadena de herramientas y los objetivos específicos para ver cuál depurar. Se pueden separar varias regex con comas y, luego, se verifica cada una por separado. Nota: El resultado de esta marca es muy complejo y es probable que solo sea útil para expertos en la resolución de cadenas de herramientas.
Etiquetas:terminal_output
- Son opciones que especifican o alteran una entrada genérica en un comando de Bazel que no pertenece a otras categorías.:
- Se acumulan varios usos de
--flag_alias=<a 'name=value' flag alias>
-
Establece un nombre abreviado para una marca de Starlark. Toma un solo par clave-valor en el formato "<clave>=<valor>" como argumento.
Etiquetas:changes_inputs
--[no]incompatible_default_to_explicit_init_py
predeterminado: “false”-
Esta marca cambia el comportamiento predeterminado para que los archivos __init__.py ya no se creen automáticamente en los runfiles de los objetivos de Python. Específicamente, cuando un objetivo py_binary o py_test tiene legacy_create_init establecido en "auto" (el valor predeterminado), se considera falso solo si se establece esta marca. Consulta https://github.com/bazelbuild/bazel/issues/10076.
Etiquetas:affects_outputs
,incompatible_change
- 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 incluye el sufijo "-py2", mientras que los destinos compilados para Python 3 aparecerán en una raíz sin sufijo relacionado con Python. Esto significa que el symlink de conveniencia "bazel-bin" apuntará a destinos de Python 3 en lugar de Python 2. Si habilitas esta opción, también se recomienda habilitar `--incompatible_py3_is_default`.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_py3_is_default
predeterminado: "true"-
Si es verdadero, los destinos "py_binary" y "py_test" que no establezcan su atributo "python_version" (o "default_python_version") usarán PY3 de forma predeterminada en lugar de PY2. Si configuras esta marca, también se recomienda establecer `--incompatible_py2_outputs_are_suffixed`.
Etiquetas:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_use_python_toolchains
predeterminado: "true"-
Si se configura como verdadera, las reglas nativas ejecutables de Python usarán el entorno de ejecución de Python especificado por la cadena de herramientas de Python, en lugar del entorno de ejecución proporcionado por marcas heredadas como --python_top.
Etiquetas:loading_and_analysis
,incompatible_change
--python_version=<PY2 or PY3>
predeterminado: Consulta la descripción-
Es el modo de versión principal de Python, ya sea "PY2" o "PY3". Ten en cuenta que esto se anula con los destinos "py_binary" y "py_test" (incluso si no especifican una versión de forma explícita), por lo que, por lo general, no hay muchos motivos para proporcionar esta marca.
Etiquetas:loading_and_analysis
,affects_outputs
- Otras opciones, sin clasificar de otra manera:
--[no]cache_test_results
[-t
] predeterminado: "auto"- Si se configura como “auto”, Bazel vuelve a ejecutar una prueba solo si: (1) Bazel detecta cambios en la prueba o en sus dependencias; (2) la prueba se marcó como externa; (3) se solicitaron varias ejecuciones de prueba con --runs_per_test, o(4) la prueba falló anteriormente. Si se establece como "yes", Bazel almacena en caché todos los resultados de las pruebas, excepto las marcadas como externas. Si se establece en "no", Bazel no almacena en caché ningún resultado de la prueba.
- Valor predeterminado de
--[no]experimental_cancel_concurrent_tests
: "falso" -
Si es verdadero, Blaze cancelará las pruebas que se ejecutan de forma simultánea en la primera ejecución correcta. Esto solo es útil en combinación con --runs_per_test_detects_flakes.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_fetch_all_coverage_outputs
predeterminado: “false”-
Si es verdadero, Bazel recuperará todo el directorio de datos de cobertura para cada prueba durante una ejecución de cobertura.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_generate_llvm_lcov
predeterminado: “false”-
Si es verdadera, la cobertura de clang generará un informe de LCOV.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_j2objc_header_map
predeterminado: "true"- Determina si se debe generar un mapa de encabezados de J2ObjC en paralelo con la transpilación de J2ObjC.
--[no]experimental_j2objc_shorter_header_path
predeterminado: “false”-
Indica si se debe generar con una ruta de encabezado más corta (usa “_ios” en lugar de “_j2objc”).
Etiquetas:affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
predeterminado: "javabuilder"- Permite rutas de clase reducidas para compilaciones de Java.
- Valor predeterminado de
--[no]experimental_limit_android_lint_to_android_constrained_java
: "falso" -
Limita --experimental_run_android_lint_on_java_rules a las bibliotecas compatibles con Android.
Etiquetas:affects_outputs
--[no]experimental_run_android_lint_on_java_rules
predeterminado: “false”-
Determina si se deben validar las fuentes java_*.
Etiquetas:affects_outputs
--[no]explicit_java_test_deps
predeterminado: “false”- Especifica de forma explícita una dependencia a JUnit o Hamcrest en un java_test en lugar de obtenerla accidentalmente de las dependencias de TestRunner. Por el momento, solo funciona para Bazel.
--host_java_launcher=<a build target label>
predeterminado: Consulta la descripción- Es el selector de Java que usan las herramientas que se ejecutan durante una compilación.
- Se acumulan
--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 opciones se agregarán a las opciones de inicio de la VM de cada destino java_binary.
--[no]incompatible_check_sharding_support
predeterminado: "true"-
Si es verdadero, Bazel fallará en una prueba fragmentada si el ejecutor de pruebas no indica que admite el fragmentación tocando el archivo en la ruta de acceso en TEST_SHARD_STATUS_FILE. Si es falso, un ejecutor de pruebas que no admite la fragmentación dará lugar a que se ejecuten todas las pruebas en cada fragmento.
Etiquetas:incompatible_change
--[no]incompatible_exclusive_test_sandboxed
predeterminado: "true"-
Si es verdadero, las pruebas exclusivas se ejecutarán con la estrategia de zona de pruebas. Agrega la etiqueta "local" para forzar que se ejecute una prueba exclusiva de forma local.
Etiquetas:incompatible_change
--[no]incompatible_strict_action_env
predeterminado: “false”-
Si es verdadero, Bazel usa un entorno con un valor estático para PATH y no hereda LD_LIBRARY_PATH. Usa --action_env=ENV_VARIABLE si deseas heredar variables de entorno específicas del cliente, pero ten en cuenta que, de esta manera, se puede evitar la caché entre usuarios si se usa una caché compartida.
Etiquetas:loading_and_analysis
,incompatible_change
- Se acumulan
--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 de Java de una prueba de Java espere una conexión de un depurador compatible con JDWP (como jdb) antes de iniciar la prueba. Implica -test_output=streamed.
Se expande a:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
- Valor predeterminado de
--[no]java_deps
: "true" - Genera información de dependencia (por ahora, el classpath del tiempo de compilación) por destino de Java.
- Valor predeterminado de
--[no]java_header_compilation
: "true" - Compila ijars directamente desde la fuente.
--java_language_version=<a string>
predeterminado: ""- La versión del lenguaje Java
--java_launcher=<a build target label>
predeterminado: Consulta la descripción- Es el selector de Java que se usará cuando se compilen objetos binarios de Java. Si esta marca se establece en la cadena vacía, se usa el selector de JDK. El atributo "launcher" anula esta marca.
--java_runtime_version=<a string>
predeterminado: "local_jdk"- La versión del entorno de ejecución de Java
- Se acumulan varios usos de
--javacopt=<a string>
- Opciones adicionales para pasar a javac.
- Se acumulan varios usos de
--jvmopt=<a string>
- Opciones adicionales para pasar a la VM de Java. Estas 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 usará para generar la lista de clases que deben estar en el archivo DEX principal cuando se compila el multidex heredado.
- Valor predeterminado de
--optimizing_dexer=<a build target label>
: ver descripción - Especifica un objeto binario para usar y realizar la conversión a 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 usará para quitar el código cuando se compila un objeto binario de Java.
--proto_compiler=<a build target label>
predeterminado: “@bazel_tools//tools/proto:protoc”-
Etiqueta del proto-compiler.
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
predeterminado: "@bazel_tools//tools/proto:cc_toolchain"-
Etiqueta de proto_lang_toolchain(), que describe cómo compilar protos de C++
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
predeterminado: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"-
Etiqueta de proto_lang_toolchain() que describe cómo compilar protos j2objc
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
predeterminado: "@bazel_tools//tools/proto:java_toolchain"-
Etiqueta de proto_lang_toolchain(), que describe cómo compilar protos de Java
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
predeterminado: "@bazel_tools//tools/proto:javalite_toolchain"-
Etiqueta de proto_lang_toolchain(), que describe cómo compilar protos de JavaLite
Etiquetas:affects_outputs
,loading_and_analysis
- Se acumulan varios usos de
--protocopt=<a string>
-
Opciones adicionales para pasar al compilador de protobuf.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]runs_per_test_detects_flakes
: "falso" - Si es verdadero, cualquier fragmento en el que se apruebe al menos una ejecución o intento y falle al menos una ejecución o intento tendrá el estado FLAKY.
--shell_executable=<a path>
predeterminado: Consulta la descripción-
Es la ruta de acceso absoluta al shell ejecutable para que lo use Bazel. Si no se establece, pero la variable de entorno BAZEL_SH se establece en la primera invocación de Bazel (que inicia un servidor de Bazel), Bazel la usará. Si no se establece ninguno, Bazel usa una ruta de acceso predeterminada fija según el sistema operativo en el que se ejecuta (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, todos los demás: /bin/bash). Ten en cuenta que usar un shell que no 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 varios usos de
--test_arg=<a string>
- Especifica opciones y 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 de ellas recibirá argumentos idénticos. Solo lo usa el comando "bazel test".
--test_filter=<a string>
predeterminado: Consulta la descripción- : Especifica un filtro para reenviar al framework de pruebas. Se usa para limitar las pruebas que se ejecutan. Ten en cuenta que esto no afecta los destinos que se compilan.
--test_result_expiration=<an integer>
predeterminado: “-1”- Esta opción está obsoleta y no tiene ningún efecto.
--[no]test_runner_fail_fast
predeterminado: “false”- Redirecciona la opción de falla rápida al ejecutor de pruebas. El ejecutor de pruebas debe detener la ejecución en la primera falla.
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>
predeterminado: "explicit"- Especifica la estrategia para el fragmentación de prueba: "explicit" para usar solo la fragmentación si está presente el atributo BUILD "shard_count". “Inhabilitado” para no usar nunca la fragmentación de pruebas. "forced=k" para aplicar los fragmentos "k" a las pruebas, independientemente del atributo de COMPILACIÓN "shard_count".
- Valor predeterminado de
--tool_java_language_version=<a string>
: "" - La versión del lenguaje Java que se usa para ejecutar las herramientas necesarias durante una compilación
--tool_java_runtime_version=<a string>
predeterminado: "remotejdk_11"- La versión del entorno de ejecución de Java que se usa para ejecutar herramientas durante la compilación
--[no]use_ijars
predeterminado: "true"- Si está habilitada, esta opción hace que la compilación de Java use archivos JAR de interfaz. Esto generará una compilación incremental más rápida, pero los mensajes de error pueden ser diferentes.
Opciones de volcado
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
-
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto está diseñado para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--experimental_repository_downloader_retries=<an integer>
: "0" -
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
- Valor predeterminado de
--experimental_scale_timeouts=<a double>
: "1.0" -
Ajusta todos los tiempos de espera en las reglas del repositorio de Starlark con este factor. De esta manera, se puede hacer que los repositorios externos funcionen en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--[no]incompatible_disable_native_repo_rules
predeterminado: “false”-
Si es falso, se pueden usar reglas de repositorio nativas en WORKSPACE. De lo contrario, se deben usar reglas de repositorio de Starlark. Las reglas de repositorio nativo incluyen local_repository, new_local_repository, local_config_platform, android_sdk_repository y android_ndk_repository.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché. De lo contrario, se usa el valor predeterminado de '<output_user_root>/cache/repos/v1'.
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
predeterminado: “false”-
Si se establece, no se permite la descarga con ctx.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no 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:
--gc_thrashing_threshold=<an integer in 0-100 range>
predeterminado: "100"-
Es el porcentaje de espacio ocupado (de 0 a 100) por encima del cual GcThrashingDetector considera los eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, se inhabilita GcThrashingDetector.
Etiquetas:host_machine_resource_optimizations
- Opciones que controlan el resultado del comando:
- Valor predeterminado de
--[no]action_cache
: "falso" -
Ejecuta el volcado del contenido de la caché de acciones.
Etiquetas:bazel_monitoring
- Valor predeterminado de
--[no]packages
: "falso" - Volca el contenido de la caché del paquete.
Etiquetas:bazel_monitoring
--[no]rule_classes
predeterminado: “false”-
Ejecuta el volcado de clases de reglas.
Etiquetas:bazel_monitoring
--[no]rules
predeterminado: “false”-
Reglas de volcado, incluidos los recuentos y el uso de memoria (si se realiza un seguimiento de la memoria)
Etiquetas:bazel_monitoring
--skyframe=<off, summary, count, deps or rdeps>
predeterminado: "off"-
Ejecuta el comando para volcar el gráfico de Skyframe: "off", "summary", "count", "deps" o "rdeps".
Etiquetas:bazel_monitoring
- Valor predeterminado de
--skykey_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: “.*”. -
Filtro de regex de nombres de SkyKey para la salida. Solo se usa con --skyframe=deps, rdeps.
Etiquetas:bazel_monitoring
--skylark_memory=<a string>
predeterminado: Consulta la descripción-
Descarga un perfil de memoria compatible con pprof en la ruta especificada. Para obtener más información, consulta https://github.com/google/pprof.
Etiquetas:bazel_monitoring
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
-
Se especificaron las versiones del módulo con el formato `<module1>@<version1>,<module2>@<version2>` que se permitirán en el gráfico de dependencias resuelto 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 quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: “error”-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "advertencia" -
Verifica si las dependencias directas de "bazel_dep" declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivarla a un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
predeterminado: “update”- especifica cómo usar el archivo de bloqueo y si se debe usar o no. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "refresh" para actualizar periódicamente la información mutable (versiones quitadas y módulos que faltaban anteriormente) de los registros remotos, "error" para usar el archivo de bloqueo, pero mostrar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
- Anula un módulo con una ruta de acceso local con el formato <module name>=<path>. Si la ruta proporcionada es una ruta de acceso absoluta, se usará como es. Si la ruta proporcionada es una ruta de acceso relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace". Si la ruta de acceso determinada está vacía, quita las anulaciones anteriores.
- Se acumulan varios usos de
--registry=<a string>
-
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los anteriores.
Etiquetas:changes_inputs
--vendor_dir=<a path>
predeterminado: Consulta la descripción-
Especifica el directorio que debe contener los repositorios externos en modo de proveedor, ya sea para recuperarlos o usarlos durante la compilación. La ruta de acceso se puede especificar como una ruta absoluta o una ruta relativa al directorio del espacio 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 falle con Bazel con una OOM. Cada límite se especifica como <period>:<count>, en el que period es una duración y count es un número entero positivo. Si hay más de --gc_thrashing_threshold por ciento de espacio permanente (montón de generación anterior) permanece ocupado después de <count> recolecciones de elementos no utilizados consecutivos en <period>, se activará una OOM. Se pueden especificar varios límites separados por comas.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC completo, se descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE, es decir, ilimitado. Cero significa que los eventos de GC completos nunca activarán las bajadas. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC completo y se supere ese umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produce un evento de GC menor, descartará el estado temporal innecesario de Skyframe hasta esta cantidad de veces por invocación. La configuración predeterminada es Integer.MAX_VALUE; en efecto ilimitado. Cero significa que los eventos de GC menores nunca activarán las bajadas. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC menor y se supere ese umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es de al menos este límite, descartará el estado temporal innecesario de Skyframe. Si ajustas este parámetro, es posible que puedas mitigar el impacto del tiempo de ejecución de la fragmentación de GC, cuando esta se produce (i) por el uso de memoria de este estado temporal y (ii) es más costoso que reconstituir el estado cuando sea necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--experimental_command_profile=<cpu, wall, alloc or lock>
predeterminado: Consulta la descripción- Graba un perfil de Java Flight Recorder durante el tiempo que se ejecuta el comando. Se debe proporcionar como argumento uno de los tipos de eventos de generación de perfiles admitidos (cpu, wall, alloc o lock). 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 pueden cambiar en el futuro para admitir tipos de perfiles o formatos de salida adicionales. Úsala bajo tu propio riesgo.
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemónicos con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
- Opciones que especifican o modifican una entrada genérica para un comando de Bazel que no se encuentra en otras categorías.
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de almacenamiento en caché y ejecución remotas:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
predeterminado: "automático"- El modo de subprocesos que se usará para la recuperación del repositorio. Si se establece en "desactivado", no se usa ningún subproceso de trabajo y la recuperación del repo está sujeta a reinicios. De lo contrario, usa un subproceso de trabajador virtual.
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
- Anula un repositorio con una ruta de acceso local en el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es una ruta de acceso absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta de acceso relativa, se relaciona con el 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 del "espacio de trabajo de información de bazel". Si la ruta dada está vacía, quita las anulaciones anteriores.
Opciones de recuperación
Hereda todas las opciones de test.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
-
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]experimental_repository_cache_hardlinks
: "falso" -
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Ajusta todos los tiempos de espera en las reglas del repositorio de Starlark con este factor. De esta manera, se puede hacer que los repositorios externos funcionen en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--[no]incompatible_disable_native_repo_rules
predeterminado: “false”-
Si es falso, se pueden usar reglas de repositorio nativas en WORKSPACE. De lo contrario, se deben usar reglas de repositorio de Starlark. Las reglas de repositorio nativo incluyen local_repository, new_local_repository, local_config_platform, android_sdk_repository y android_ndk_repository.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación en caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché. De lo contrario, se usa el valor predeterminado de '<output_user_root>/cache/repos/v1'.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]repository_disable_download
: "falso" -
Si se establece, no se permite la descarga con ctx.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no se inhabilita por completo; ctx.execute aún podría ejecutar un ejecutable arbitrario que acceda a Internet.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de la compilación:
- Valor predeterminado de
--[no]all
: "falso" -
Obtiene todos los repositorios externos necesarios para compilar cualquier destino o repositorio. Esta es la opción predeterminada si no se proporcionan otras marcas y argumentos. Solo funciona cuando --enable_bzlmod está activado.
Etiquetas:changes_inputs
--gc_thrashing_threshold=<an integer in 0-100 range>
predeterminado: "100"-
Es el porcentaje de espacio ocupado (de 0 a 100) por encima del cual GcThrashingDetector considera los eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, se inhabilita GcThrashingDetector.
Etiquetas:host_machine_resource_optimizations
--[no]keep_going
[-k
] predeterminado: "false"-
Continúa tanto como sea posible después de un error. Si bien 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 en paralelo que se usarán para la fase de carga o análisis. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5" "auto" establece un valor predeterminado razonable según los recursos del host. Debe ser 1 como mínimo.
Etiquetas:bazel_internal_configuration
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility
predeterminado: “false”-
Si incompatible_enforce_config_setting_visibility=false, esto es una operación no realizada. De lo contrario, si esta marca es falsa, cualquier config_setting sin un atributo de visibilidad explícito es //visibility:public. Si esta marca es verdadera, config_setting sigue la misma lógica de visibilidad que todas las demás reglas. Consulta https://github.com/bazelbuild/bazel/issues/12933.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
predeterminado: "true"-
Si es verdadero, aplica las restricciones de visibilidad config_setting. Si es falso, todos los config_setting son visibles para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
-
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitados en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
- 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 derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "advertencia" -
Verifica si las dependencias directas de "bazel_dep" declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivarla a un error de resolución.
Etiquetas:loading_and_analysis
--[no]configure
predeterminado: “false”-
Solo recupera repositorios marcados como "configurar" para la configuración del sistema. Solo funciona cuando --enable_bzlmod está activado.
Etiquetas:changes_inputs
--[no]force
predeterminado: “false”-
Ignora el repositorio existente, si lo hay, y fuerza su recuperación nuevamente. Solo funciona cuando --enable_bzlmod está activado.
Etiquetas:changes_inputs
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
predeterminado: “update”-
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, "refresh" para actualizar periódicamente la información mutable (versiones quitadas y módulos que faltaban anteriormente) de los registros remotos, "error" para usar el archivo de bloqueo, pero mostrar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso proporcionada es una ruta de acceso absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta de acceso relativa, se considerará en relación con el directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace". Si la ruta de acceso determinada está vacía, quita las anulaciones anteriores.
- Se acumulan varios usos de
--registry=<a string>
-
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los anteriores.
Etiquetas:changes_inputs
- Se acumulan varios usos de
--repo=<a string>
-
Solo recupera el repositorio especificado, que puede ser {@apparent_repo_name} o {@@canonical_repo_name}. Solo funciona cuando --enable_bzlmod está activado.
Etiquetas:changes_inputs
--vendor_dir=<a path>
predeterminado: Consulta la descripción-
Especifica el directorio que debe contener 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 haga que Bazel falle con un error de OOM. Cada límite se especifica como <period>:<count>, donde period es una duración y count es un número entero positivo. Si más del porcentaje --gc_thrashing_threshold del espacio a perpetuidad (heap de generación anterior) permanece ocupado después de <count> GC completas consecutivas en <period>, se activa un error de OOM. 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"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC completo, se descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. La configuración predeterminada es Integer.MAX_VALUE; en efecto ilimitado. 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 de 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 produce un evento de GC menor, descartará el estado temporal innecesario de Skyframe hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC menores nunca activarán las bajadas. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC menor y se supere ese umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es de al menos este límite, descartará el estado temporal innecesario de Skyframe. Si ajustas este parámetro, es posible que puedas mitigar el impacto del tiempo de ejecución de la fragmentación de GC, cuando esta se produce (i) por el uso de memoria de este estado temporal y (ii) es más costoso que reconstituir el estado cuando sea necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Valor predeterminado de
--experimental_command_profile=<cpu, wall, alloc or lock>
: ver descripción - Graba un perfil de Java Flight Recorder durante el tiempo que se ejecuta el comando. Se debe proporcionar como argumento uno de los tipos de eventos de generación de perfiles admitidos (cpu, wall, alloc o lock). El perfil se escribe en un archivo con el nombre del tipo de evento en el directorio de salida base. La sintaxis y la semántica de esta marca podrían cambiar en el futuro para admitir tipos de perfil o formatos de resultados adicionales; úsalas bajo tu responsabilidad.
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- 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.
--experimental_repository_resolved_file=<a string>
predeterminado: ""-
Si no está vacío, escribe un valor de Starlark con la información resuelta de todas las reglas del repositorio de Starlark que se ejecutaron.
Etiquetas:affects_outputs
- Opciones que especifican o modifican una entrada genérica para un comando de Bazel que no se encuentra en otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
predeterminado: “auto”- El modo de subprocesos que se usará para la recuperación del repositorio. Si se establece en "desactivado", no se usa ningún subproceso de trabajo y la recuperación del repo está sujeta a reinicios. De lo contrario, usa un subproceso de trabajador virtual.
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--deleted_packages=<comma-separated list of package names>
- 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. Utiliza 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 la proporciona otra entrada package_path. Especificar --deleted_packages x/y evita este problema.
--[no]fetch
predeterminado: "true"- Permite que el comando recupere dependencias externas. Si se establece como falso, el comando usará cualquier versión almacenada en caché de la dependencia y, si no existe ninguna, el comando fallará.
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
- Anula un repositorio con una ruta de acceso local en el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es una ruta absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta relativa, se relaciona con el directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace". Si la ruta de acceso determinada está vacía, quita las anulaciones anteriores.
--package_path=<colon-separated list of options>
predeterminado: "%workspace%"- Es una lista separada por dos puntos de dónde buscar paquetes. Los elementos que comienzan con “%workspace%” son relativos al 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 está habilitado, hace que Bazel imprima mensajes de "Carga del paquete:".
- Opciones que controlan la ejecución de la compilación:
- Valor predeterminado de
--[no]all
: "falso" -
Obtiene todos los repositorios externos necesarios para compilar cualquier destino o repositorio. Esta es la opción predeterminada si no se proporcionan otras marcas y argumentos. Solo funciona cuando --enable_bzlmod está activado.
Etiquetas:changes_inputs
- Valor predeterminado de
--[no]experimental_inprocess_symlink_creation
: "falso" -
Indica si se deben realizar llamadas directas al sistema de archivos para crear árboles de symlinks
Etiquetas:loading_and_analysis
,execution
,experimental
--[no]experimental_persistent_aar_extractor
predeterminado: “false”-
Habilita el extractor de aar persistente con trabajadores.
Etiquetas:execution
--[no]experimental_remotable_source_manifests
predeterminado: “false”-
Determina si las acciones del manifiesto de origen se pueden controlar de forma remota.
Etiquetas:loading_and_analysis
,execution
,experimental
- Valor predeterminado de
--[no]experimental_split_coverage_postprocessing
: "falso" -
Si es verdadero, Bazel ejecutará el procesamiento posterior de la cobertura para la prueba en un nuevo inicio.
Etiquetas:execution
--[no]experimental_strict_fileset_output
predeterminado: “false”-
Si esta opción está habilitada, los conjuntos de archivos tratarán todos los artefactos de salida como archivos normales. No recorrerán directorios ni serán sensibles a los symlinks.
Etiquetas:execution
--[no]incompatible_disallow_unsound_directory_outputs
predeterminado: "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
,incompatible_change
- Valor predeterminado de
--[no]incompatible_modify_execution_info_additive
: "falso" -
Cuando está habilitada, pasar varias marcas --modify_execution_info es aditivo. Cuando se inhabilita, solo se tiene en cuenta la última marca.
Etiquetas:execution
,affects_outputs
,loading_and_analysis
,incompatible_change
--[no]keep_going
[-k
] predeterminado: "false"-
Continúa tanto como sea posible después de un error. Si bien no se pueden analizar el objetivo que falló ni los que dependen de él, sí se pueden analizar otros requisitos previos de estos objetivos.
Etiquetas:eagerness_to_exit
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
predeterminado: “auto”-
Cantidad de subprocesos en paralelo que se usarán para la fase de carga o análisis. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". "auto" establece un valor predeterminado razonable según los recursos del host. Debe ser 1 como mínimo.
Etiquetas:bazel_internal_configuration
- Se acumulan varios usos de
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
-
Agrega o quita claves de la información de ejecución de una acción según la mnemotecnia de la acción. Solo se aplica a las acciones que admiten información de ejecución. Muchas acciones comunes admiten información de ejecución, p.ej., Genrule, CppCompile, Javac, StarlarkAction y TestRunner. Cuando especificas varios valores, el orden es importante porque muchas regex pueden aplicarse al mismo mnemónico.
Sintaxis: “regex=[+-]key,regex=[+-]key,...”.
Ejemplos:
'.*=+x,.*=-y,.*=+z' agrega "x" y "z" a la información de ejecución de todas las acciones y quita "y".
"Genrule=+requires-x" agrega "requires-x" a la información de ejecución de todas las acciones de Genrule.
"(?!Genrule).*=-requires-x" quita "requires-x" de la información de ejecución para todas las acciones que no sean de Genrule.
Etiquetas:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Habilita las acciones de expansión de sintaxis y dex persistentes de Android con trabajadores.
Se expande a:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
-
Habilita el procesador de recursos de Android persistente con trabajadores.
Se expande a lo siguiente:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=AndroidResourceCompiler=worker
1}--internal_persistent_busybox_tools
{/14/}}--strategy=AndroidAssetMerger=worker
{/1/}{1//}}:
} } }--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
--strategy=ProcessDatabinding=worker
--strategy=GenerateDataBindingBaseClasses=worker
host_machine_resource_optimizations
execution
--persistent_multiplex_android_dex_desugar
-
Habilita las acciones de desugar y dex multiplexadas y persistentes de Android con trabajadores.
Se expande a:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
Habilita el procesador de recursos de Android multiplexado persistente con trabajadores.
Se expande a:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_tools
-
Habilita las herramientas de Android persistentes y multiplexadas (dexing, expansión de sintaxis, procesamiento de recursos).
Se expande a:
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Etiquetas:host_machine_resource_optimizations
,execution
--[no]use_target_platform_for_tests
predeterminado: “false”-
Si el valor es verdadero, Bazel usará la plataforma de destino para ejecutar pruebas en lugar del grupo de ejecución de pruebas.
Etiquetas:execution
- Son opciones que configuran la cadena de herramientas que se usa para la ejecución de acciones:
--android_compiler=<a string>
predeterminado: Consulta la descripción-
El compilador de destino de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_crosstool_top=<a build target label>
predeterminado: "//external:android/crosstool"-
Es la ubicación del compilador de C++ que se usa para las compilaciones de Android.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_grte_top=<a label>
predeterminado: Consulta la descripción-
El grte_top de destino de Android.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
predeterminado: "android"-
Selecciona el combinador de manifiestos que se usará para las reglas android_binary. Marca para ayudar a la transición a la combinación de manifiestos de Android desde la combinación heredada.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_platforms=<a build target label>
predeterminado: ""-
Establece las plataformas que usan los objetivos de 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
,loses_incremental_state
--android_sdk=<a build target label>
predeterminado: "@bazel_tools//tools/android:sdk"-
Especifica el SDK o la plataforma de Android que se usa para compilar aplicaciones para Android.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--apple_crosstool_top=<a build target label>
predeterminado: "@bazel_tools//tools/cpp:toolchain"-
Es la etiqueta del paquete de herramientas cruzadas que se usará en las reglas de Apple y Objc, y sus dependencias.
Etiquetas:loses_incremental_state
,changes_inputs
--cc_output_directory_tag=<a string>
predeterminado: ""-
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas:affects_outputs
--compiler=<a string>
predeterminado: Consulta la descripción-
Es el compilador de C++ que se usará para compilar el destino.
Etiquetas:loading_and_analysis
,execution
--coverage_output_generator=<a build target label>
predeterminado: "@bazel_tools//tools/test:lcov_merger"-
Ubicación del objeto binario que se usa para procesar posteriormente los informes de cobertura sin procesar. Actualmente, debe ser un grupo de archivos que contenga un solo archivo, el binario. La configuración predeterminada es “//tools/test:lcov_merger”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
predeterminado: "@bazel_tools//tools/test:coverage_report_generator"-
Ubicación del objeto binario que se usa para generar informes de cobertura. Actualmente, debe ser un grupo de archivos que contenga un solo archivo, el binario. El valor predeterminado es "//tools/test:coverage_report_generator".
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
predeterminado: "@bazel_tools//tools/test:coverage_support"-
Ubicación de los archivos de compatibilidad que se requieren en las entradas de cada acción de prueba que recopila la cobertura de código. El valor predeterminado es “//tools/test:coverage_support”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--crosstool_top=<a build target label>
predeterminado: "@bazel_tools//tools/cpp:toolchain"-
Es la etiqueta del paquete de herramientas cruzadas que se usará para compilar código C++.
Etiquetas:loading_and_analysis
,changes_inputs
,affects_outputs
--custom_malloc=<a build target label>
predeterminado: Consulta la descripción- especifica una implementación personalizada de malloc. Este parámetro de configuración anula los atributos malloc en las reglas de compilación.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
usos múltiples -
Es una lista de expresiones regulares separadas por comas, cada una con el prefijo - (expresión negativa) de forma opcional, asignadas (=) a una lista de objetivos de valores de restricción separados por comas. Si un objetivo no coincide con ninguna expresión negativa y con al menos una expresión positiva, la resolución de la cadena de herramientas se realizará como si hubiera declarado los valores de restricción como restricciones de ejecución. Ejemplo: //demo,-test=@platforms//cpus:x86_64 agregará "x86_64" a cualquier destino de //demo, excepto a aquellos cuyo nombre contenga "test".
Etiquetas:loading_and_analysis
--[no]experimental_include_xcode_execution_requirements
predeterminado: “false”-
Si se establece, agrega un requisito de ejecución "requires-xcode:{version}" a cada acción de Xcode. Si la versión de Xcode tiene una etiqueta con guiones, también agrega un requisito de ejecución “requires-xcode-label:{version_label}”.
Etiquetas:loses_incremental_state
,loading_and_analysis
,execution
--[no]experimental_prefer_mutual_xcode
predeterminado: "true"-
Si es verdadero, usa la versión más reciente de Xcode que esté disponible de forma local y remota. Si es falso o si no hay versiones mutuas disponibles, usa la versión local de Xcode seleccionada a través de xcode-select.
Etiquetas:loses_incremental_state
--extra_execution_platforms=<comma-separated list of options>
predeterminado: ""-
Son las plataformas disponibles como plataformas de ejecución para ejecutar acciones. Las plataformas se pueden especificar por destino exacto o como un patrón de destino. Estas plataformas se considerarán antes de las declaradas en el archivo WORKSPACE por register_execution_platforms(). Esta opción solo se puede establecer una vez; las instancias posteriores anularán la configuración de la marca anterior.
Etiquetas:execution
- Se acumulan varios usos de
--extra_toolchains=<comma-separated list of options>
-
Son las reglas de la cadena de herramientas que se deben tener en cuenta durante la resolución de la cadena de herramientas. Las cadenas de herramientas se pueden especificar por destino exacto o como un patrón de destino. Estas cadenas de herramientas se considerarán antes que las declaradas en el archivo WORKSPACE por register_toolchains().
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--grte_top=<a label>
predeterminado: Consulta la descripción-
Es una etiqueta para una biblioteca libc verificada. La cadena de herramientas de crosstool selecciona el valor predeterminado, y casi nunca necesitas anularlo.
Etiquetas:action_command_lines
,affects_outputs
--host_compiler=<a string>
predeterminado: Consulta la descripción-
Es el compilador de C++ que se usará para la compilación del host. Se ignora si no se establece --host_crosstool_top.
Etiquetas:loading_and_analysis
,execution
--host_crosstool_top=<a build target label>
predeterminado: Consulta la descripción-
De forma predeterminada, las opciones --crosstool_top y --compiler también se usan para la configuración de exec. Si se proporciona este indicador, Bazel usa la libc y el compilador predeterminados para el crosstool_top específico.
Etiquetas:loading_and_analysis
,changes_inputs
,affects_outputs
--host_grte_top=<a label>
predeterminado: Consulta la descripción-
Si se especifica, este parámetro de configuración anula el directorio de nivel superior de libc (--grte_top) para la configuración de exec.
Etiquetas:action_command_lines
,affects_outputs
--host_platform=<a build target label>
valor predeterminado: "@bazel_tools//tools:host_platform"-
Etiqueta de una regla de la plataforma que describe el sistema de host.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
predeterminado: "true"-
Si es verdadero, Bazel no habilitará las funciones "host" y "nonhost" en la cadena de herramientas de C++ (consulta https://github.com/bazelbuild/bazel/issues/7407 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_android_toolchain_resolution
predeterminado: "true"-
Usa la resolución de cadena de herramientas para seleccionar el SDK de Android para las reglas de Android (Starlark y nativo)
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_apple_toolchain_resolution
predeterminado: “false”-
Usa la resolución de cadena de herramientas para seleccionar el SDK de Apple para las reglas de Apple (Starlark y nativo)
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone
predeterminado: "true"-
Si es verdadero, Bazel no reutilizará las líneas de comandos de la acción de vinculación de C++ para las líneas de comandos de indexación de lto (consulta https://github.com/bazelbuild/bazel/issues/6791 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_legacy_whole_archive
predeterminado: "true"-
Si es verdadero, Bazel no vinculará las dependencias de la biblioteca como un archivo completo de forma predeterminada (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener instrucciones de migración).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_require_ctx_in_configure_features
predeterminado: "true"-
Si es verdadero, Bazel requerirá el parámetro "ctx" en cc_common.configure_features (consulta https://github.com/bazelbuild/bazel/issues/7793 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
-
Usa objetos compartidos de 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
,affects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Especifica la versión del SDK de iOS que se usará para compilar aplicaciones para iOS. Si no se especifica, se usa la versión predeterminada del SDK de iOS de "xcode_version".
Etiquetas:loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Especifica la versión del SDK de macOS que se usará para compilar aplicaciones para macOS. Si no se especifica, se usa la versión predeterminada del SDK de macOS de “xcode_version”.
Etiquetas:loses_incremental_state
--minimum_os_version=<a string>
predeterminado: Consulta la descripción-
La versión mínima del SO a la que se orienta tu compilación.
Etiquetas:loading_and_analysis
,affects_outputs
--platform_mappings=<a relative path>
predeterminado: ""-
Es la ubicación de un archivo de asignación que describe qué plataforma usar si no se establece ninguna o qué marcas establecer cuando ya existe una plataforma. Debe ser relativo a la raíz del espacio de trabajo principal. El valor predeterminado es "platform_mappings" (un archivo directamente debajo de la raíz del espacio de trabajo).
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--platforms=<a build target label>
predeterminado: ""-
Son las etiquetas de las reglas de la plataforma que describen las plataformas de destino del comando actual.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--python2_path=<a string>
predeterminado: Consulta la descripción-
Obsoleto, no realiza ninguna acción. Se inhabilitó con `--incompatible_use_python_toolchains`.
Etiquetas:no_op
,deprecated
- Valor predeterminado de
--python3_path=<a string>
: ver descripción -
Obsoleto, no realiza ninguna acción. Se inhabilitó con `--incompatible_use_python_toolchains`.
Etiquetas:no_op
,deprecated
- Valor predeterminado de
--python_path=<a string>
: ver descripción -
Es la ruta de acceso absoluta del intérprete de Python que se invocó para ejecutar destinos de Python en la plataforma de destino. Obsoleto; se inhabilitó con --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
--python_top=<a build target label>
predeterminado: Consulta la descripción-
La etiqueta de un py_runtime que representa el intérprete de Python invocado para ejecutar destinos de Python en la plataforma de destino. Obsoleto; se inhabilitó con --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Especifica la versión del SDK de tvOS que se usará para compilar aplicaciones para tvOS. Si no se especifica, se usa la versión predeterminada del SDK de tvOS de "xcode_version".
Etiquetas:loses_incremental_state
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Especifica la versión del SDK de watchOS que se usará para compilar aplicaciones para watchOS. Si no se especifica, se usa la versión predeterminada del SDK de watchOS de “xcode_version”.
Etiquetas:loses_incremental_state
--xcode_version=<a string>
predeterminado: Consulta la descripción-
Si se especifica, usa Xcode de la versión determinada para las acciones de compilación relevantes. Si no se especifica, usa la versión predeterminada del ejecutor de Xcode.
Etiquetas:loses_incremental_state
--xcode_version_config=<a build target label>
predeterminado: “@bazel_tools//tools/cpp:host_xcodes”-
Es la etiqueta de la regla xcode_config que se usará para seleccionar la versión de Xcode en la configuración de compilación.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Opciones que controlan el resultado del comando:
--[no]apple_generate_dsym
predeterminado: “false”-
Indica si se deben generar archivos de símbolos de depuración (.dSYM).
Etiquetas:affects_outputs
,action_command_lines
--[no]build_runfile_links
predeterminado: "true"-
Si es verdadero, compila bosques de symlink de archivos de ejecución para todos los destinos. Si es falso, escríbelos solo cuando una acción local, una prueba o un comando de ejecución lo requieran.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]build_runfile_manifests
: "true" -
Si es verdadero, escribe manifiestos de runfiles para todos los destinos. Si es falso, omítelos. Las pruebas locales no se ejecutarán cuando sea falso.
Etiquetas:affects_outputs
--[no]build_test_dwp
predeterminado: “false”-
Si está habilitado, cuando se compilen pruebas de C++ de forma estática y con Fission, el archivo .dwp para el objeto binario de prueba también se compilará automáticamente.
Etiquetas:loading_and_analysis
,affects_outputs
--cc_proto_library_header_suffixes=<comma-separated set of options>
predeterminado: “.pb.h”-
Establece los sufijos de los archivos de encabezado que crea una cc_proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated set of options>
predeterminado: ".pb.cc"-
Configura los sufijos de los archivos de origen que crea una cc_proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
- 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
,experimental
--[no]experimental_proto_extra_actions
predeterminado: “false”-
Ejecuta acciones adicionales para versiones alternativas de la API de Java en una proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_save_feature_state
predeterminado: “false”-
Guarda el estado de las funciones habilitadas y solicitadas como un resultado de la compilación.
Etiquetas:affects_outputs
,experimental
--fission=<a set of compilation modes>
predeterminado: "no"-
Especifica qué modos de compilación usan fisión para compilaciones y vínculos de C++. Puede ser cualquier combinación de {'fastbuild', 'dbg', 'opt'} o los valores especiales 'yes' para habilitar todos los modos y 'no' para inhabilitar todos los modos.
Etiquetas:loading_and_analysis
,action_command_lines
,affects_outputs
--[no]incompatible_always_include_files_in_data
predeterminado: "true"-
Si es verdadera, las reglas nativas agregan <code>DefaultInfo.files</code> de dependencias de datos a sus archivos de ejecución, lo que coincide con el comportamiento recomendado para las reglas de Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid).
Etiquetas:affects_outputs
,incompatible_change
- 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
--[no]objc_generate_linkmap
predeterminado: “false”- especifica si se debe generar un archivo de mapa de vínculos.
Etiquetas:affects_outputs
--[no]save_temps
predeterminado: “false”-
Si se establece, se guardarán los resultados temporales de gcc. Estos incluyen archivos .s (código de ensamblador), archivos .i (C++ previamente preprocesado) y .ii (C++ preprocesado).
Etiquetas:affects_outputs
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, a diferencia de su existencia:
- Se acumulan varios usos de
--action_env=<a 'name=value' assignment with an optional value part>
-
Especifica el conjunto de variables de entorno disponibles para las acciones con configuración de destino. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o 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 las opciones que se proporcionan para la misma variable, se aplica la más reciente, y se acumulan las opciones para diferentes variables.
Etiquetas:action_command_lines
--android_cpu=<a string>
predeterminado: "armeabi-v7a"-
La CPU objetivo de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]android_databinding_use_androidx
predeterminado: "true"-
Genera archivos de vinculación de datos compatibles con AndroidX. Esto solo se usa con la vinculación de datos v2. Esta marca no realiza ninguna acción.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]android_databinding_use_v3_4_args
predeterminado: "true"-
Usa Android Databinding v2 con el argumento 3.4.0. Esta marca es una no-op.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--android_dynamic_mode=<off, default or fully>
predeterminado: "off"- determina si las dependencias de C++ de las reglas de Android se vincularán de forma dinámica cuando un cc_binary no cree una biblioteca compartida de forma explícita. "default" significa que bazel elegirá si vincular de forma dinámica. "completamente" significa que todas las bibliotecas se vincularán de forma dinámica. "Desactivado" significa que todas las bibliotecas se vincularán en modo principalmente estático.
Etiquetas:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
predeterminado: "alphabetical"-
Establece el orden de los manifiestos que se pasan a la combinación de manifiestos para los objetos binarios de Android. ALPHABETICAL significa que los manifiestos se ordenan por ruta de acceso en relación con el execroot. ALPHABETICAL_BY_CONFIGURATION significa que los manifiestos se ordenan por rutas de acceso relativas al directorio de configuración dentro del directorio de salida. DEPENDENCY significa que los manifiestos se ordenan de modo que el manifiesto de cada biblioteca aparezca antes que los manifiestos de sus dependencias.
Etiquetas:action_command_lines
,execution
--[no]android_resource_shrinking
predeterminado: “false”-
Habilita la reducción de recursos para los APKs de android_binary que usan ProGuard.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]build_python_zip
predeterminado: “auto”-
Compila el archivo ZIP ejecutable de Python; activado en Windows, desactivado en otras plataformas.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--catalyst_cpus=<comma-separated list of options>
-
Lista de arquitecturas separadas por comas para las que se compilarán objetos binarios de Apple Catalyst.
Etiquetas:loses_incremental_state
,loading_and_analysis
--[no]collect_code_coverage
predeterminado: “false”-
Si se especifica, Bazel instrumentará el código (con instrumentación sin conexión siempre que sea posible) y recopilará información de cobertura durante las pruebas. Solo se verán afectados los destinos que coincidan con --instrumentation_filter. Por lo general, esta opción no debe especificarse directamente; en su lugar, se debe usar el comando “bazel connection”.
Etiquetas:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] predeterminado: "fastbuild"-
Especifica el modo en el que se compilará el objeto binario. Valores: “fastbuild”, “dbg”, “opt”.
Etiquetas:affects_outputs
,action_command_lines
- Se acumulan varios usos de
--conlyopt=<a string>
-
Es una opción adicional para pasar a gcc cuando se compilan archivos de origen C.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--copt=<a string>
- Opciones adicionales para pasar a gcc.
Etiquetas:action_command_lines
,affects_outputs
--cpu=<a string>
predeterminado: ""-
La CPU objetivo.
Etiquetas:changes_inputs
,affects_outputs
- Valor predeterminado de
--cs_fdo_absolute_path=<a string>
: ver descripción -
Usa la información del perfil de CSFDO para optimizar la compilación. Especifica el nombre de la ruta de acceso absoluta del archivo ZIP que contiene el archivo de perfil, un archivo de perfil LLVM sin procesar o indexado.
Etiquetas:affects_outputs
--cs_fdo_instrument=<a string>
predeterminado: Consulta la descripción-
Genera ejecutables con instrumentación de FDO sensible al contexto. Con el compilador Clang/LLVM, también acepta el nombre del directorio en el que se volcarán los archivos de perfil sin procesar durante el tiempo de ejecución.
Etiquetas:affects_outputs
--cs_fdo_profile=<a build target label>
predeterminado: Consulta la descripción-
Es el cs_fdo_profile que representa el perfil sensible al contexto que se usará para la optimización.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--cxxopt=<a string>
-
Opción adicional para pasar a gcc cuando se compilan archivos de origen C++.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--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
,affects_outputs
--dynamic_mode=<off, default or fully>
predeterminado: "predeterminado"- determina si los objetos binarios de C++ se vincularán de forma dinámica. "default" significa que Bazel elegirá si vincular de forma dinámica. "completamente" significa que todas las bibliotecas se vincularán de forma dinámica. "off" significa que todas las bibliotecas se vincularán en modo principalmente estático.
Etiquetas:loading_and_analysis
,affects_outputs
- Valor predeterminado de
--[no]enable_fdo_profile_absolute_path
: "true" -
Si se establece, el uso de fdo_logical_profile_path generará un error.
Etiquetas:affects_outputs
--[no]enable_runfiles
predeterminado: “auto”-
Habilita el árbol de symlinks de runfiles. De forma predeterminada, está desactivado en Windows y en otras plataformas.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--experimental_action_listener=<a build target label>
- dejó de estar disponible y se reemplazó por aspectos. Usa action_listener para adjuntar un extra_action a las acciones de compilación existentes.
Etiquetas:execution
,experimental
- Valor predeterminado de
--[no]experimental_android_compress_java_resources
: "falso" -
Comprime los recursos de Java en los APKs.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
- Valor predeterminado de
--[no]experimental_android_databinding_v2
: "true" -
Usa Android Databinding v2. Esta marca no realiza ninguna acción.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_android_resource_shrinking
predeterminado: “false”-
Habilita la reducción de recursos para los APKs de android_binary que usan ProGuard.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_android_rewrite_dexes_with_rex
predeterminado: “false”-
Usa la herramienta rex para volver a escribir archivos dex.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_collect_code_coverage_for_generated_files
predeterminado: “false”-
Si se especifica, Bazel también 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 de fastbuild de objc.
Etiquetas:action_command_lines
--[no]experimental_omitfp
predeterminado: “false”-
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
,experimental
--experimental_output_paths=<off, content or strip>
predeterminado: "off"-
Indica qué modelo usar para el lugar en el que las reglas del árbol de resultados escriben sus resultados, en particular para compilaciones multiplataforma o con varias configuraciones. Esta función es muy experimental. Consulta https://github.com/bazelbuild/bazel/issues/6526 para obtener más información. Las acciones de Starlark pueden habilitar la asignación de rutas de acceso agregando la clave "supports-path-mapping" al diccionario "execution_requirements".
Etiquetas:loses_incremental_state
,bazel_internal_configuration
,affects_outputs
,execution
- Se acumulan varios usos de
--experimental_override_name_platform_in_output_dir=<a 'label=value' assignment>
-
Cada entrada debe tener el formato etiqueta=valor, en el que etiqueta hace referencia a una plataforma y valor es el nombre abreviado que se desea usar en la ruta de salida. Solo se usa cuando --experimental_platform_in_output_dir es verdadero. Tiene la prioridad de nomenclatura más alta.
Etiquetas:affects_outputs
,experimental
--[no]experimental_platform_in_output_dir
predeterminado: “false”-
Si es verdadero, se usa un nombre corto para la plataforma de destino en el nombre del directorio de salida en lugar de la CPU. El esquema exacto es experimental y está sujeto a cambios: primero, en el caso poco frecuente de que la opción --platforms no tenga exactamente un valor, se usa un hash de la opción platforms. A continuación, si --experimental_override_name_platform_in_output_dir registró algún nombre corto para la plataforma actual, entonces se usará 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
,experimental
- Valor predeterminado de
--[no]experimental_use_llvm_covmap
: "falso" -
Si se especifica, Bazel generará información del mapa de cobertura de llvm-cov en lugar de gcov cuando se habilite collect_code_coverage.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
- Valor predeterminado de
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic
: "true" -
Usa esta marca solo como parte de una estrategia de migración o prueba sugerida. Ten en cuenta que la heurística tiene deficiencias conocidas y se recomienda migrar a depender solo de --experimental_override_name_platform_in_output_dir.
Etiquetas:affects_outputs
,experimental
--fat_apk_cpu=<comma-separated set of options>
predeterminado: "armeabi-v7a"-
Si configuras esta opción, se habilitan los APKs multiarquitectura, que contienen objetos binarios nativos para todas las arquitecturas de destino especificadas, p.ej., --fat_apk_cpu=x86,armeabi-v7a. Si se especifica esta marca, se ignora --android_cpu para las dependencias de las reglas android_binary.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Valor predeterminado de
--[no]fat_apk_hwasan
: "falso" -
Indica si se deben crear divisiones HWASAN.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--fdo_instrument=<a string>
predeterminado: Consulta la descripción-
Genera ejecutables con la instrumentación de FDO. Con el compilador Clang/LLVM, también acepta el nombre del directorio en el que se volcarán los archivos de perfil sin procesar durante el tiempo de ejecución.
Etiquetas:affects_outputs
- Valor predeterminado de
--fdo_optimize=<a string>
: ver descripción - Usa la información del perfil de FDO para optimizar la compilación. Especifica el nombre de un archivo ZIP que contenga un árbol de archivos .gcda, un archivo afdo que contenga un perfil automático o un archivo de perfil de LLVM. Esta marca también acepta archivos especificados como etiquetas (p.ej., "//foo/bar:file.afdo"; es posible que debas agregar una directiva "exports_files" al paquete correspondiente) y etiquetas que apuntan a destinos "fdo_profile". La regla "fdo_profile" reemplazará esta marca.
Etiquetas:affects_outputs
--fdo_prefetch_hints=<a build target label>
predeterminado: Consulta la descripción-
Usa sugerencias de carga previa de caché.
Etiquetas:affects_outputs
- Valor predeterminado de
--fdo_profile=<a build target label>
: ver descripción -
Es el fdo_profile que representa el perfil que se usará para la optimización.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--features=<a string>
-
Las funciones determinadas estarán habilitadas o inhabilitadas de forma predeterminada para los destinos compilados en la configuración de destino. Si especificas -<feature>, se inhabilitará la función. Los atributos negativos siempre anulan los positivos. Consulta también --host_features.
Etiquetas:changes_inputs
,affects_outputs
--[no]force_pic
predeterminado: “false”-
Si está habilitada, todas las compilaciones de C++ producen código independiente de la posición ("-fPIC"), las vinculaciones prefieren las bibliotecas compiladas previamente de PIC en lugar de las bibliotecas que no son de PIC, y las vinculaciones producen ejecutables independientes de la posición ("-pie").
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan
--host_action_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica el conjunto de variables de entorno disponibles para las acciones con configuraciones de ejecución. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o bien por el par nombre=valor, que establece el valor independientemente del entorno de invocación. Esta opción se puede usar varias veces. En el caso de las opciones que se proporcionan para la misma variable, se aplica la más reciente, y se acumulan las opciones para diferentes variables.
Etiquetas:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
predeterminado: "opt"-
Especifica el modo en el que se compilarán las herramientas que se usan durante la compilación. Valores: "fastbuild", "dbg", "opt".
Etiquetas:affects_outputs
,action_command_lines
- Se acumulan
--host_conlyopt=<a string>
usos múltiples -
Es una opción adicional para pasar al compilador C cuando se compilan archivos de origen C (pero no C++) en las configuraciones de ejecución.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--host_copt=<a string>
-
Opciones adicionales para pasar al compilador de C para las herramientas compiladas en las configuraciones de ejecución.
Etiquetas:action_command_lines
,affects_outputs
--host_cpu=<a string>
predeterminado: ""-
La CPU del host.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan varios usos de
--host_cxxopt=<a string>
-
Opciones adicionales para pasar al compilador de C++ para herramientas compiladas en las configuraciones de ejecución.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--host_features=<a string>
-
Las funciones determinadas se habilitarán o inhabilitarán de forma predeterminada para los destinos compilados en la configuración de ejecución. Si especificas -<feature>, se inhabilitará la función. Los atributos negativos siempre anulan los positivos.
Etiquetas:changes_inputs
,affects_outputs
--host_force_python=<PY2 or PY3>
predeterminado: Consulta la descripción-
Anula la versión de Python para la configuración de ejecución. Puede ser “PY2” o “PY3”.
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan varios usos de
--host_linkopt=<a string>
-
Opción adicional para pasar al vinculador cuando se vinculan herramientas en las configuraciones de ejecución.
Etiquetas:action_command_lines
,affects_outputs
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Versión mínima compatible de macOS para los destinos de host. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan varios usos de
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
-
Opciones adicionales para pasar de forma selectiva al compilador C/C++ cuando se compilan ciertos archivos en las configuraciones de ejecución. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,…,option_n. En la que regex_filter representa una lista de patrones de expresiones regulares para incluir y excluir (consulta también --instrumentation_filter). option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe estar entre comillas con una barra diagonal inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos de gcc de todos los archivos cc en //foo/, excepto bar.cc.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--host_swiftcopt=<a string>
-
Opciones adicionales para pasar a swiftc para herramientas de ejecución.
Etiquetas:action_command_lines
,affects_outputs
- Valor predeterminado de
--[no]incompatible_auto_exec_groups
: "falso" -
Cuando se habilita, se crea automáticamente un grupo de ejecución para cada cadena de herramientas que usa una regla. Para que esto funcione, la regla debe especificar el parámetro "toolchain" en sus acciones. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/17134.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_merge_genfiles_directory
predeterminado: "true"-
Si es verdadero, el directorio genfiles se une al directorio bin.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_use_host_features
predeterminado: "true"-
Si es verdadero, usa --features solo para la configuración de destino y --host_features para la configuración de ejecución.
Etiquetas:changes_inputs
,affects_outputs
,incompatible_change
--[no]instrument_test_targets
predeterminado: “false”-
Cuando la cobertura está habilitada, especifica si se deben considerar las reglas de prueba de instrumentación. Cuando se 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. En su lugar, se excluyen las reglas con el prefijo “-”. Ten en cuenta que solo se instrumentan las reglas que no son de prueba, a menos que se habilite --instrument_test_targets.
Etiquetas:affects_outputs
- Valor predeterminado de
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima de iOS compatible con dispositivos y simuladores de destino. Si no se especifica, se usa "ios_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan varios usos de
--ios_multi_cpus=<comma-separated list of options>
-
Es una lista de arquitecturas separadas por comas con las que se compila una ios_application. El resultado es un binario universal que contiene todas las arquitecturas especificadas.
Etiquetas:loses_incremental_state
,loading_and_analysis
--[no]legacy_whole_archive
predeterminado: "true"-
Deja de estar disponible y se reemplaza 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
,deprecated
- Se acumulan varios usos de
--linkopt=<a string>
-
Es una opción adicional para pasar a gcc durante la vinculación.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--ltobackendopt=<a string>
-
Opción adicional para pasar al paso de backend de LTO (en --features=thin_lto).
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--ltoindexopt=<a string>
-
Opción adicional para pasar al paso de indexación de LTO (en --features=thin_lto).
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--macos_cpus=<comma-separated list of options>
-
Lista de arquitecturas separadas por comas para compilar objetos binarios de Apple macOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Versión mínima de macOS compatible para los destinos. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
--memprof_profile=<a build target label>
predeterminado: Consulta la descripción-
Usar el perfil de memprof.
Etiquetas:affects_outputs
--[no]objc_debug_with_GLIBCXX
predeterminado: “false”-
Si se establece y el modo de compilación se establece en "dbg", define GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC y GLIBCPP_CONCEPT_CHECKS.
Etiquetas:action_command_lines
--[no]objc_enable_binary_stripping
predeterminado: “false”-
Determina si se deben borrar símbolos y códigos no entregados 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 varios usos de
--objccopt=<a string>
-
Opciones adicionales para pasar a gcc cuando se compilan archivos de origen Objective-C/C++.
Etiquetas:action_command_lines
- Se acumulan
--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 a gcc cuando se compilan ciertos archivos. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. En la que regex_filter representa una lista de patrones de expresiones regulares para incluir y excluir (consulta también --instrumentation_filter). option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe estar entre comillas con una barra diagonal inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos de gcc de todos los archivos cc en //foo/, excepto bar.cc.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
-
Opciones adicionales para pasar de forma selectiva al backend de LTO (en --features=thin_lto) cuando se compilan ciertos objetos de backend. Esta opción se puede aprobar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. En la que regex_filter representa una lista de patrones de expresión regular para incluir y excluir. option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe estar entre comillas con una barra diagonal inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos del backend de LTO de todos los archivos .o en //foo/, excepto bar.o.
Etiquetas:action_command_lines
,affects_outputs
- 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
,loading_and_analysis
--propeller_optimize=<a build target label>
predeterminado: Consulta la descripción-
Usa la información del perfil de Propeller para optimizar el destino de compilación.Un perfil de Propeller debe constar de al menos uno de dos archivos: un perfil de cc y un perfil de ld. Esta marca acepta una etiqueta de compilación que debe hacer referencia a los archivos de entrada del perfil de Propeller. Por ejemplo, el archivo BUILD que define la etiqueta, en a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)Es posible que se deba agregar una directiva exports_files al paquete correspondiente para que Bazel pueda ver estos archivos. La opción se debe usar de la siguiente manera: --propeller_optimize=//a/b:propeller_profile
Etiquetas:action_command_lines
,affects_outputs
--propeller_optimize_absolute_cc_profile=<a string>
predeterminado: Consulta la descripción-
Nombre de la ruta de acceso absoluta del archivo cc_profile para compilaciones de Propeller Optimized.
Etiquetas:affects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
predeterminado: Consulta la descripción-
Es el nombre de ruta de acceso absoluto del archivo ld_profile para las compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
--run_under=<a prefix in front of command>
predeterminado: Consulta la descripción-
Es el prefijo que se inserta antes de los ejecutables para los comandos "test" y "run". Si el valor es "foo -bar" y la línea de comandos de ejecución es "test_binary -baz", la línea de comandos final es "foo -bar test_binary -baz".Esto también puede ser una etiqueta para un destino ejecutable. Algunos ejemplos son: "valgrind", "strace", "strace -c", "valgrind --quiet --num-callers=20", "//package:target", "//package:target --options".
Etiquetas:action_command_lines
-
Si es verdadero, las bibliotecas nativas que contienen funcionalidad idéntica se compartirán entre diferentes destinos.
Etiquetas:loading_and_analysis
,affects_outputs
--[no]stamp
predeterminado: “false”-
Marca los objetos binarios con la fecha, el nombre de usuario, el nombre de host, la información del espacio de trabajo, etcétera.
Etiquetas:affects_outputs
- Valor predeterminado de
--strip=<always, sometimes or never>
: “sometimes” - especifica si se deben quitar los objetos binarios y las bibliotecas compartidas (con "-Wl,--strip-debug"). El valor predeterminado de "sometimes" significa quitar si --compilation_mode=fastbuild.
Etiquetas:affects_outputs
- Se acumulan
--stripopt=<a string>
usos múltiples -
Opciones adicionales para pasar a la eliminación cuando se genera un objeto binario “<name>.stripped”.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--swiftcopt=<a string>
-
Opciones adicionales para pasar a la compilación con Swift.
Etiquetas:action_command_lines
- Se acumulan varios usos de
--tvos_cpus=<comma-separated list of options>
-
Es una lista separada por comas de las arquitecturas para las que se compilarán los objetos binarios de Apple tvOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Versión mínima compatible de tvOS para los simuladores y dispositivos de destino. Si no se especifica, se usa "tvos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan
--visionos_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para compilar objetos binarios de VisionOS de Apple.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Se acumulan
--watchos_cpus=<comma-separated list of options>
usos múltiples -
Es una lista separada por comas de las arquitecturas para las que se compilarán los objetos binarios de Apple watchOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Valor predeterminado de
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima compatible de watchOS para los simuladores y dispositivos de destino. Si no se especifica, se usa "watchos_sdk_version".
Etiquetas:loses_incremental_state
--xbinary_fdo=<a build target label>
predeterminado: Consulta la descripción-
Usa la información del perfil de XbinaryFDO para optimizar la compilación. Especifica el nombre del perfil binario cruzado predeterminado. Cuando la opción se usa junto con --fdo_instrument/--fdo_optimize/--fdo_profile, esas opciones siempre prevalecerán como si xbinary_fdo nunca se especificara.
Etiquetas:affects_outputs
- Opciones que afectan la exactitud con la que Bazel aplica de manera forzosa las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
--auto_cpu_environment_group=<a build target label>
predeterminado: ""-
Declara el environment_group que se usará para asignar automáticamente los valores de CPU a los valores de target_environment.
Etiquetas:changes_inputs
,loading_and_analysis
,experimental
--[no]check_licenses
predeterminado: “false”-
Verifica que las restricciones de licencias impuestas por los paquetes dependientes no entren en conflicto con los modos de distribución de los destinos que se compilan. De forma predeterminada, no se verifican las licencias.
Etiquetas:build_file_semantics
--[no]check_visibility
predeterminado: "true"-
Si se inhabilita, los errores de visibilidad en las dependencias de destino se degradan a advertencias.
Etiquetas:build_file_semantics
--[no]desugar_for_android
predeterminado: "true"-
Determina si se debe expandir la sintaxis del código de bytes de Java 8 antes de la conversión a DEX.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]desugar_java8_libs
predeterminado: “false”-
Indica si se deben incluir bibliotecas Java 8 compatibles en apps para dispositivos heredados.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Valor predeterminado de
--[no]enforce_constraints
: "true" -
Verifica los entornos con los que es compatible cada objetivo y, luego, informa errores si alguno tiene dependencias que no admiten los mismos entornos.
Etiquetas:build_file_semantics
--[no]experimental_check_desugar_deps
predeterminado: "true"-
Indica si se debe volver a verificar la correcta expansión de sintaxis a nivel del objeto binario de Android.
Etiquetas:eagerness_to_exit
,loading_and_analysis
,experimental
- Configuración predeterminada de
--experimental_import_deps_checking=<off, warning or error>
: "DESACTIVADA" -
Cuando está habilitada, verifica si las dependencias de una aar_import están completas. Esta aplicación puede romper la compilación o generar advertencias.
Etiquetas:loading_and_analysis
- Configuración predeterminada de
--experimental_one_version_enforcement=<off, warning or error>
: "DESACTIVADA" -
Cuando está habilitada, se aplica la regla de que una regla java_binary no puede contener más de una versión del mismo archivo de clase en la ruta de acceso a clases. Esta aplicación puede romper la compilación o generar advertencias.
Etiquetas:loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
predeterminado: "predeterminado"-
Si es verdadero, verifica que un destino de Java declare explícitamente todos los destinos utilizados directamente como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
- Valor predeterminado de
--[no]incompatible_check_testonly_for_output_files
: "falso" -
Si está habilitado, busca el atributo testonly de la regla de generación para verificar si hay destinos de requisitos previos que sean archivos de salida. Esto coincide con la verificación de visibilidad.
Etiquetas:build_file_semantics
,incompatible_change
- Valor predeterminado de
--[no]incompatible_check_visibility_for_toolchains
: "falso" -
Si está habilitada, la verificación de visibilidad también se aplica a las implementaciones de la cadena de herramientas.
Etiquetas:build_file_semantics
,incompatible_change
- Valor predeterminado de
--[no]incompatible_disable_native_android_rules
: "falso" -
Si se habilita, se inhabilita el uso directo de las reglas nativas de Android. Usa las reglas de Starlark para Android en https://github.com/bazelbuild/rules_android
Etiquetas:eagerness_to_exit
,incompatible_change
--[no]incompatible_disable_native_apple_binary_rule
predeterminado: “false”-
Sin operación. Se mantiene aquí para la retrocompatibilidad.
Etiquetas:eagerness_to_exit
,incompatible_change
- Valor predeterminado de
--[no]incompatible_python_disable_py2
: "true" -
Si es verdadero, usar la configuración de Python 2 provocará un error. Esto incluye python_version=PY2, srcs_version=PY2 y srcs_version=PY2ONLY. Consulta https://github.com/bazelbuild/bazel/issues/15684 para obtener más información.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_validate_top_level_header_inclusions
predeterminado: "true"-
Si es verdadero, Bazel también validará las inclusiones de encabezados de directorio de nivel superior (consulta https://github.com/bazelbuild/bazel/issues/10047 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]one_version_enforcement_on_java_tests
predeterminado: "true"-
Cuando está habilitado y experimental_one_version_enforcement se establece en un valor que no sea NONE, se aplica una versión en los destinos java_test. Esta marca se puede inhabilitar para mejorar el rendimiento de las pruebas incrementales a costa de perder posibles incumplimientos de una versión.
Etiquetas:loading_and_analysis
--python_native_rules_allowlist=<a build target label>
predeterminado: Consulta la descripción-
Es una lista de entidades permitidas (objetivo de package_group) que se usará cuando se aplique --incompatible_python_disallow_native_rules.
Etiquetas:loading_and_analysis
--[no]strict_filesets
predeterminado: “false”-
Si esta opción está habilitada, los conjuntos de archivos que cruzan los límites de los paquetes se informan como errores.
Etiquetas:build_file_semantics
,eagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default>
predeterminado: "error"-
A menos que esté desactivado, comprueba que un destino de proto_library declare de forma explícita todos los destinos utilizados directamente como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
--strict_public_imports=<off, warn, error, strict or default>
predeterminado: "off"-
A menos que esté desactivado, comprueba que un objetivo de proto_library declare de forma explícita todos los objetivos que se usan en "import public" como exportados.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
--[no]strict_system_includes
predeterminado: “false”-
Si es verdadero, también se deben declarar los encabezados que se encuentran a través de las rutas de inclusión del sistema (-isystem).
Etiquetas:loading_and_analysis
,eagerness_to_exit
- Se acumulan varios usos de
--target_environment=<a build target label>
-
Declara el entorno de destino de esta compilación. Debe ser una referencia de etiqueta a una regla de "entorno". Si se especifican, todos los objetivos de nivel superior deben ser compatibles con este entorno.
Etiquetas:changes_inputs
- Opciones que afectan los resultados de firma de una compilación:
--apk_signing_method=<v1, v2, v1_v2 or v4>
predeterminado: “v1_v2”-
Implementación que se usará para firmar APKs
Etiquetas:action_command_lines
,affects_outputs
,loading_and_analysis
--[no]device_debug_entitlements
predeterminado: "true"-
Si se configura y el modo de compilación no es "opt", las apps objc incluirán derechos de depuración cuando firmen.
Etiquetas:changes_inputs
--ios_signing_cert_name=<a string>
predeterminado: Consulta la descripción-
Es el nombre del certificado que se usará para la firma de iOS. Si no se establece, se usará el perfil de aprovisionamiento. Puede ser la preferencia de identidad del llavero del certificado o (subcadena) del nombre de pila 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 Starlark o la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility
predeterminado: “false”-
Si incompatible_enforce_config_setting_visibility=false, esto es una operación no realizada. De lo contrario, si esta marca es falsa, cualquier config_setting sin un atributo de visibilidad explícito es //visibility:public. Si esta marca es verdadera, config_setting sigue la misma lógica de visibilidad que todas las demás reglas. Consulta https://github.com/bazelbuild/bazel/issues/12933.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_legacy_py_provider
predeterminado: "true"-
No se realizará ninguna acción, se quitará pronto.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_sdk_frameworks_attributes
predeterminado: “false”-
Si el valor es verdadero, no permitir los atributos sdk_frameworks y bad_sdk_frameworks en objc_library y objc_import.
Etiquetas:build_file_semantics
,incompatible_change
- Valor predeterminado de
--[no]incompatible_enforce_config_setting_visibility
: "true" -
Si es verdadero, aplica las restricciones de visibilidad de config_setting. Si es falso, todos los config_setting son visibles para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]incompatible_objc_alwayslink_by_default
: "falso" -
Si es verdadero, establece el valor predeterminado como verdadero para los atributos alwayslink en objc_library y objc_import.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_python_disallow_native_rules
predeterminado: “false”-
Cuando es verdadero, se produce un error cuando se usan las reglas integradas py_*. En su lugar, se deben usar las reglas rule_python. Consulta https://github.com/bazelbuild/bazel/issues/17773 para obtener más información y las instrucciones de migración.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones que determinan el comportamiento del entorno de pruebas o del ejecutor de pruebas:
- Valor predeterminado de
--[no]allow_analysis_failures
: "falso" -
Si es verdadero, una falla de análisis de un objetivo de regla genera la propagación del objetivo de una instancia de AnalysisFailureInfo que contiene la descripción del error, en lugar de generar una falla de compilación.
Etiquetas:loading_and_analysis
,experimental
--analysis_testing_deps_limit=<an integer>
predeterminado: “2000”-
Establece la cantidad máxima de dependencias transitivas a través de un atributo de regla con una transición de configuración for_analysis_testing. Si se supera este límite, se mostrará un error de regla.
Etiquetas:loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure
predeterminado: “false”-
Si es verdadero, las fallas de la acción de dex2oat causarán que la compilación falle en lugar de ejecutar dex2oat durante el tiempo de ejecución de la prueba.
Etiquetas:loading_and_analysis
,experimental
- Se acumulan varios usos de
--default_test_resources=<a resource name followed by equal and 1 float or 4 float, e.g. memory=10,30,60,100>
- Anula la cantidad de recursos predeterminados para las pruebas. El formato esperado es <resource>=<value>. Si se especifica un solo número positivo como <value>, se anularán los recursos predeterminados para todos los tamaños de prueba. Si se especifican 4 números separados por comas, estos anularán 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, seguidos de forma opcional por [-|*]<float> (p. ej., memory=HOST_RAM*.1,HOST_RAM*.2,HOST_RAM*.3,HOST_RAM*.4). Los recursos de prueba predeterminados que especifica esta marca se anulan con los recursos explícitos que se especifican en las etiquetas.
--[no]experimental_android_use_parallel_dex2oat
predeterminado: “false”-
Usa dex2oat en paralelo para acelerar la ejecución de android_test.
Etiquetas:loading_and_analysis
,host_machine_resource_optimizations
,experimental
--[no]ios_memleaks
predeterminado: “false”-
Habilita la verificación de fugas de memoria en los destinos de ios_test.
Etiquetas:action_command_lines
- Valor predeterminado de
--ios_simulator_device=<a string>
: ver descripción -
Es el dispositivo que se simula cuando se ejecuta una aplicación para iOS en el simulador, p.ej., "iPhone 6". Para obtener una lista de dispositivos, ejecuta "xcrun simctl list devicetypes" en la máquina en la que se ejecutará el simulador.
Etiquetas:test_runner
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Es la versión de iOS que se ejecutará en el simulador durante la ejecución o las pruebas. Esto se ignora para las reglas ios_test si se especifica un dispositivo de destino en la regla.
Etiquetas:test_runner
- Se acumulan varios usos de
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
- especifica la cantidad de veces que se debe ejecutar cada prueba. Si alguno de esos intentos falla por 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 la que runs_per_test representa un valor entero y regex_filter representa una lista de patrones de expresiones regulares para incluir y excluir (consulta también --instrumentation_filter). Ejemplo: --runs_per_test=//foo/.*,-//foo/bar/.*@3 ejecuta todas las pruebas en //foo/, excepto las que se encuentran en foo/bar, tres veces. Esta opción se puede aprobar varias veces. El argumento pasado más recientemente que coincida tiene prioridad. Si no hay coincidencias, la prueba solo se ejecuta una vez.
- Se acumulan varios usos de
--test_env=<a 'name=value' assignment with an optional value part>
-
Especifica variables de entorno adicionales que se insertarán en el entorno del ejecutor de pruebas. Las variables se pueden especificar por nombre, en cuyo caso su valor se leerá del entorno del cliente de Bazel, o bien por el par nombre=valor. Esta opción se puede usar varias veces para especificar varias variables. Solo lo usa el comando "bazel test".
Etiquetas:test_runner
--test_timeout=<a single integer or comma-separated list of 4 integers>
predeterminado: “-1”- Anula los valores predeterminados de tiempo de espera de prueba para los tiempos de espera de prueba (en segundos). Si se especifica un 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 para corto, moderado, largo y eterno (en ese orden). De cualquier forma, un valor de -1 le indica a blaze que use sus tiempos de espera predeterminados para esa categoría.
--[no]zip_undeclared_test_outputs
predeterminado: "true"-
Si es verdadero, los resultados de las pruebas no declaradas se archivarán en un archivo ZIP.
Etiquetas:test_runner
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
--[no]configure
predeterminado: “false”-
Solo recupera repositorios marcados como "configurar" para la configuración del sistema. Solo funciona cuando --enable_bzlmod está activado.
Etiquetas:changes_inputs
--[no]force
predeterminado: “false”-
Ignora el repositorio existente, si corresponde, y vuelve a recuperarlo de forma forzosa. Solo funciona cuando --enable_bzlmod está activado.
Etiquetas:changes_inputs
- Se acumulan
--repo=<a string>
usos múltiples -
Solo recupera el repositorio especificado, que puede ser {@apparent_repo_name} o {@@canonical_repo_name}. Solo funciona cuando --enable_bzlmod está activado.
Etiquetas:changes_inputs
- Opciones que activan optimizaciones del tiempo de compilación:
--[no]experimental_filter_library_jar_with_program_jar
predeterminado: “false”-
Filtra el ProgramJar de ProGuard para quitar las clases que también estén presentes en el LibraryJar.
Etiquetas:action_command_lines
--[no]experimental_inmemory_dotd_files
predeterminado: "true"-
Si se habilita, los archivos .d de C++ se pasarán en la memoria directamente desde los nodos de compilación remotos en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_inmemory_jdeps_files
predeterminado: "true"-
Si está habilitado, los archivos de dependencia (.jdeps) generados a partir de compilaciones de Java se pasarán en la memoria directamente desde los nodos de compilación remotos en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_objc_include_scanning
predeterminado: “false”-
Indica si se debe incluir el análisis de C/C++ objetivo.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
--[no]experimental_retain_test_configuration_across_testonly
predeterminado: “false”-
Cuando se habilita, --trim_test_configuration no recortará la configuración de prueba de las reglas marcadas como testonly=1. 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
,loses_incremental_state
--[no]experimental_starlark_cc_import
predeterminado: “false”-
Si se habilita, se puede usar la versión de Starlark de cc_import.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_unsupported_and_brittle_include_scanning
predeterminado: “false”-
Determina si se deben reducir las entradas a la compilación de C/C++ a través del análisis de líneas #include de los archivos de entrada. Esto puede mejorar el rendimiento y la incrementalidad, ya que reduce el tamaño de los árboles de entrada de compilación. Sin embargo, también puede interrumpir las compilaciones porque el escáner de inclusión no implementa por completo la semántica del preprocesador C. En particular, no comprende las directivas #include dinámicas y omite la lógica condicional del preprocesador. Úsala bajo tu propia responsabilidad. Se cerrarán todos los problemas relacionados con esta marca que se hayan presentado.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
- Valor predeterminado de
--[no]incremental_dexing
: "true" -
Realiza la mayor parte del trabajo de dexing por separado para cada archivo JAR.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Valor predeterminado de
--[no]objc_use_dotd_pruning
: "true" -
Si se establece, los archivos .d emitidos por clang se usarán para podar el conjunto de entradas que se pasan a las compilaciones de objc.
Etiquetas:changes_inputs
,loading_and_analysis
--[no]process_headers_in_dependencies
predeterminado: “false”-
Cuando compilas un destino //a:a, procesa los encabezados en todos los destinos de los que depende //a:a (si el procesamiento de encabezados está habilitado para la cadena de herramientas).
Etiquetas:execution
--[no]trim_test_configuration
predeterminado: "true"-
Cuando se habilita, se borran las opciones relacionadas con las pruebas debajo del nivel superior de la compilación. Cuando esta marca está activa, las pruebas no se pueden compilar como dependencias de reglas que no son de prueba, pero los cambios en las opciones relacionadas con las pruebas no harán que se vuelvan a analizar las reglas que no son de prueba.
Etiquetas:loading_and_analysis
,loses_incremental_state
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Valor predeterminado de
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: “-.*”. -
Imprime información de depuración durante la resolución de la cadena de herramientas. La marca toma una regex, que se compara con los tipos de cadena de herramientas y los objetivos específicos para ver cuál depurar. Se pueden separar varias regex con comas y, luego, cada una se verifica por separado. Nota: El resultado de esta marca es muy complejo y es probable que solo sea útil para expertos en la resolución de cadenas de herramientas.
Etiquetas:terminal_output
- Son opciones que especifican o alteran una entrada genérica en un comando de Bazel que no pertenece a otras categorías.:
- Se acumulan varios usos de
--flag_alias=<a 'name=value' flag alias>
-
Establece un nombre abreviado para una marca de Starlark. Toma un solo par clave-valor en el formato "<clave>=<valor>" como argumento.
Etiquetas:changes_inputs
--[no]incompatible_default_to_explicit_init_py
predeterminado: “false”-
Esta marca cambia el comportamiento predeterminado para que los archivos __init__.py ya no se creen automáticamente en los archivos de ejecución de los destinos de Python. Específicamente, cuando un objetivo py_binary o py_test tiene legacy_create_init establecido en "auto" (el valor predeterminado), se considera falso solo si se establece esta marca. Consulta https://github.com/bazelbuild/bazel/issues/10076.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_py2_outputs_are_suffixed
predeterminado: "true"-
Si es verdadero, los destinos compilados en la configuración de Python 2 aparecerán en una raíz de salida que incluye el sufijo "-py2", mientras que los destinos compilados para Python 3 aparecerán en una raíz sin sufijo relacionado con Python. Esto significa que el symlink de conveniencia "bazel-bin" apuntará a 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
,incompatible_change
--[no]incompatible_py3_is_default
predeterminado: "true"-
Si es verdadero, los destinos "py_binary" y "py_test" que no establezcan su atributo "python_version" (o "default_python_version") usarán PY3 de forma predeterminada en lugar de PY2. Si estableces esta marca, también se recomienda establecer `--incompatible_py2_outputs_are_suffixed`.
Etiquetas:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_use_python_toolchains
predeterminado: "true"-
Si se establece como verdadero, las reglas ejecutables de Python nativas usarán el entorno de ejecución de Python especificado por la cadena de herramientas de Python, en lugar del entorno de ejecución que proporcionan las marcas heredadas, como --python_top.
Etiquetas:loading_and_analysis
,incompatible_change
- 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” (incluso si no especifican una versión de forma explícita) lo anulan, por lo que no suele haber muchos motivos para proporcionar esta marca.
Etiquetas:loading_and_analysis
,affects_outputs
- Otras opciones, sin clasificar de otra manera:
--[no]cache_test_results
[-t
] predeterminado: "auto"- Si se establece en “auto”, Bazel vuelve a ejecutar una prueba solo si se cumplen las siguientes condiciones: (1) Bazel detecta cambios en la prueba o sus dependencias, (2) la prueba está marcada como externa, (3) se solicitaron varias ejecuciones de prueba con --runs_per_test o(4) la prueba falló anteriormente. Si se establece como "yes", Bazel almacena en caché todos los resultados de las pruebas, excepto las marcadas como externas. Si se establece en "no", Bazel no almacena en caché ningún resultado de la prueba.
- Se acumulan varios usos de
--deleted_packages=<comma-separated list of package names>
- Es una lista separada por comas de nombres de paquetes que el sistema de compilación considerará inexistentes, incluso si son visibles en algún lugar de la ruta de acceso del paquete. Usa esta opción cuando borres un subpaquete "x/y" de un paquete existente "x". Por ejemplo, después de borrar x/y/BUILD en tu cliente, el sistema de compilación puede presentar un reclamo si encuentra la etiqueta “//x:y/z” si aún la proporciona otra entrada package_path. Especificar --deleted_packages x/y evita este problema.
- Valor predeterminado de
--[no]experimental_cancel_concurrent_tests
: "falso" -
Si es verdadero, Blaze cancelará las pruebas que se ejecutan de forma simultánea en la primera ejecución correcta. Esto solo es útil en combinación con --runs_per_test_detects_flakes.
Etiquetas:affects_outputs
,loading_and_analysis
- 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
,loading_and_analysis
--[no]experimental_generate_llvm_lcov
predeterminado: “false”-
Si es verdadera, la cobertura de clang generará un informe de LCOV.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_j2objc_header_map
predeterminado: "true"- Determina si se debe generar un mapa de encabezados de J2ObjC en paralelo con la transpilación de J2ObjC.
--[no]experimental_j2objc_shorter_header_path
predeterminado: “false”-
Indica si se debe generar con una ruta de encabezado más corta (usa “_ios” en lugar de “_j2objc”).
Etiquetas:affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
predeterminado: "javabuilder"- Habilita classpaths reducidos para compilaciones de Java.
--[no]experimental_limit_android_lint_to_android_constrained_java
predeterminado: “false”-
Limita --experimental_run_android_lint_on_java_rules a las bibliotecas compatibles con Android.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]experimental_run_android_lint_on_java_rules
: "falso" -
Determina si se deben validar las fuentes java_*.
Etiquetas:affects_outputs
--[no]explicit_java_test_deps
predeterminado: “false”- Especifica de forma explícita una dependencia a JUnit o Hamcrest en un java_test en lugar de obtenerla accidentalmente de las dependencias de TestRunner. Por el momento, solo funciona para bazel.
--[no]fetch
predeterminado: "true"- Permite que el comando recupere dependencias externas. Si se establece como falso, el comando usará cualquier versión almacenada en caché de la dependencia y, si no existe ninguna, el comando fallará.
--host_java_launcher=<a build target label>
predeterminado: Consulta la descripción- Es el selector de Java que usan las herramientas que se ejecutan durante una compilación.
- Se acumulan varios usos de
--host_javacopt=<a string>
- Opciones adicionales para pasar a javac cuando se compilan herramientas que se ejecutan durante una compilación.
- Se acumulan
--host_jvmopt=<a string>
usos múltiples - Opciones adicionales para pasar a la VM de Java cuando se compilan herramientas que se ejecutan durante la compilación. Estas opciones se agregarán a las opciones de inicio de la VM de cada destino java_binary.
--[no]incompatible_check_sharding_support
predeterminado: "true"-
Si es verdadero, Bazel fallará en una prueba fragmentada si el ejecutor de pruebas no indica que admite el fragmentación tocando el archivo en la ruta de acceso en TEST_SHARD_STATUS_FILE. Si es falso, un ejecutor de pruebas que no admita la fragmentación hará que todas las pruebas se ejecuten en cada fragmento.
Etiquetas:incompatible_change
- Valor predeterminado de
--[no]incompatible_exclusive_test_sandboxed
: "true" -
Si es verdadero, se ejecutarán pruebas exclusivas con la estrategia de zona de pruebas. Agrega la etiqueta "local" para forzar que se ejecute una prueba exclusiva de forma local.
Etiquetas:incompatible_change
--[no]incompatible_strict_action_env
predeterminado: “false”-
Si es verdadero, Bazel usa un entorno con un valor estático para PATH y no hereda LD_LIBRARY_PATH. Usa --action_env=ENV_VARIABLE si deseas heredar variables de entorno específicas del cliente, pero ten en cuenta que, de esta manera, se puede evitar la caché entre usuarios si se usa una caché compartida.
Etiquetas:loading_and_analysis
,incompatible_change
- Se acumulan varios usos de
--j2objc_translation_flags=<comma-separated list of options>
- Opciones adicionales para pasar a la herramienta J2ObjC.
--java_debug
-
Hace que la máquina virtual Java de una prueba de Java espere una conexión de 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, el classpath del tiempo de compilación) por destino de Java.
--[no]java_header_compilation
predeterminado: "true"- Compila ijars directamente desde la fuente.
--java_language_version=<a string>
predeterminado: ""- La versión del lenguaje Java
--java_launcher=<a build target label>
predeterminado: Consulta la descripción- Es el selector de Java que se usará cuando se compilen objetos binarios de Java. Si esta marca se establece en la cadena vacía, se usa el selector de JDK. El atributo "launcher" anula esta marca.
--java_runtime_version=<a string>
predeterminado: "local_jdk"- La versión del entorno de ejecución de Java
- Se acumulan varios usos de
--javacopt=<a string>
- Opciones adicionales para pasar a javac.
- Se acumulan varios usos de
--jvmopt=<a string>
- Opciones adicionales para pasar a la VM de Java. Estas opciones se agregarán a las opciones de inicio de la VM de cada destino java_binary.
--legacy_main_dex_list_generator=<a build target label>
predeterminado: Consulta la descripción- especifica un objeto binario que se usará para generar la lista de clases que deben estar en el archivo DEX principal cuando se compila el multidex heredado.
--optimizing_dexer=<a build target label>
predeterminado: Consulta la descripción- Especifica un objeto binario para usar y realizar la conversión a Dex sin fragmentación.
--package_path=<colon-separated list of options>
predeterminado: "%workspace%"- Es una lista separada por dos puntos de dónde buscar paquetes. Los elementos que comienzan con "%workspace%" son relativos al lugar de trabajo que los contiene. Si se omite o está vacío, el valor predeterminado es el resultado de "bazel info default-package-path".
- Se acumulan
--plugin=<a build target label>
usos múltiples - Plug-ins 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 usará para quitar el código cuando se compila un objeto binario de Java.
--proto_compiler=<a build target label>
predeterminado: "@bazel_tools//tools/proto:protoc"-
Es la etiqueta del protocompilador.
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
predeterminado: "@bazel_tools//tools/proto:cc_toolchain"-
Etiqueta de proto_lang_toolchain(), que describe cómo compilar protos de C++
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
predeterminado: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"-
Etiqueta de proto_lang_toolchain() que describe cómo compilar protos j2objc
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
predeterminado: "@bazel_tools//tools/proto:java_toolchain"-
Etiqueta de proto_lang_toolchain() que describe cómo compilar protos de Java
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
predeterminado: "@bazel_tools//tools/proto:javalite_toolchain"-
Etiqueta de proto_lang_toolchain(), que describe cómo compilar protos de JavaLite
Etiquetas:affects_outputs
,loading_and_analysis
- Se acumulan varios usos de
--protocopt=<a string>
-
Opciones adicionales para pasar al compilador de protobuf.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]runs_per_test_detects_flakes
: "falso" - Si es verdadero, cualquier fragmento en el que se apruebe al menos una ejecución o intento y falle al menos una ejecución o intento obtiene un estado FLAKY.
--shell_executable=<a path>
predeterminado: Consulta la descripción-
Es la ruta de acceso absoluta al shell ejecutable para que lo use Bazel. Si no se establece, pero la variable de entorno BAZEL_SH se establece en la primera invocación de Bazel (que inicia un servidor de Bazel), Bazel la usará. Si no se establece ninguno, Bazel usa una ruta de acceso predeterminada fija según el sistema operativo en el que se ejecuta (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, todos los demás: /bin/bash). Ten en cuenta que usar un shell que no sea compatible con bash puede generar fallas de compilación o de tiempo de ejecución de los objetos binarios generados.
Etiquetas:loading_and_analysis
--[no]show_loading_progress
predeterminado: "true"- Si está habilitado, hace que Bazel imprima mensajes de “Carga del paquete:”.
- Se acumulan varios usos de
--test_arg=<a string>
- Especifica opciones y argumentos adicionales que se deben pasar al ejecutable de la prueba. Se puede usar varias veces para especificar varios argumentos. Si se ejecutan varias pruebas, cada una de ellas recibirá argumentos idénticos. Solo lo usa el comando “bazel test”.
--test_filter=<a string>
predeterminado: Consulta la descripción- : Especifica un filtro para reenviar al framework de pruebas. Se usa para limitar las pruebas que se ejecutan. Ten en cuenta que esto no afecta los destinos que se compilan.
--test_result_expiration=<an integer>
predeterminado: “-1”- Esta opción dejó de estar disponible y no tiene efecto.
--[no]test_runner_fail_fast
predeterminado: “false”- Redirecciona la opción de falla rápida al ejecutor de pruebas. El ejecutor de pruebas debe detener la ejecución en la primera falla.
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>
predeterminado: "explícito"- Especifica la estrategia para la fragmentación de pruebas. Para ello, usa la opción "explícito" para que solo use la fragmentación si el atributo de COMPILACIÓN "shard_count" está presente. "disabled" para nunca usar el fragmentación de prueba. "forced=k" para aplicar fragmentos "k" para pruebas, independientemente del atributo BUILD "shard_count".
--tool_java_language_version=<a string>
predeterminado: ""- La versión del lenguaje Java que se usa para ejecutar las herramientas necesarias durante una compilación
--tool_java_runtime_version=<a string>
predeterminado: "remotejdk_11"- La versión del entorno de ejecución de Java que se usa para ejecutar herramientas durante la compilación
--[no]use_ijars
predeterminado: "true"- Si está habilitada, esta opción hace que la compilación de Java use archivos JAR de interfaz. Esto generará una compilación incremental más rápida, pero los mensajes de error pueden ser diferentes.
Opciones de ayuda
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
-
Dónde 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 establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto está diseñado para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--experimental_repository_downloader_retries=<an integer>
: "0" -
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Ajusta todos los tiempos de espera en las reglas del repositorio de Starlark con este factor. De esta manera, se puede hacer que los repositorios externos funcionen en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--[no]incompatible_disable_native_repo_rules
predeterminado: “false”-
Si es falso, se pueden usar reglas de repositorio nativas en WORKSPACE. De lo contrario, se deben usar reglas de repositorio de Starlark. Las reglas de repositorio nativo incluyen local_repository, new_local_repository, local_config_platform, android_sdk_repository y android_ndk_repository.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché. De lo contrario, se usa el valor predeterminado de '<output_user_root>/cache/repos/v1'.
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
predeterminado: “false”-
Si se establece, no se permite la descarga con ctx.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no se inhabilita por completo; ctx.execute aún podría ejecutar un ejecutable arbitrario que acceda a Internet.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de compilación:
--gc_thrashing_threshold=<an integer in 0-100 range>
predeterminado: "100"-
Es el porcentaje de espacio ocupado (de 0 a 100) por encima del cual GcThrashingDetector considera los eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, GcThrashingDetector se inhabilita.
Etiquetas:host_machine_resource_optimizations
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitados en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Comprueba la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "advertencia" -
Verifica si las dependencias directas de "bazel_dep" declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivarla a 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 dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
predeterminado: “update”- especifica cómo usar el archivo de bloqueo y si se debe usar o no. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "refresh" para actualizar periódicamente la información mutable (versiones quitadas y módulos que faltaban anteriormente) de los registros remotos, "error" para usar el archivo de bloqueo, pero mostrar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso proporcionada es una ruta de acceso absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta de acceso relativa, se considerará en relación con el directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace". Si la ruta de acceso determinada está vacía, quita las anulaciones anteriores.
- Se acumulan varios usos de
--registry=<a string>
-
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los anteriores.
Etiquetas:changes_inputs
- Valor predeterminado de
--vendor_dir=<a path>
: ver descripción -
Especifica el directorio que debe contener los repositorios externos en modo de proveedor, ya sea para recuperarlos o usarlos durante la compilación. La ruta de acceso se puede especificar como una ruta absoluta o una ruta relativa al directorio del espacio de trabajo.
Etiquetas:loading_and_analysis
- Opciones que activan optimizaciones del tiempo de compilación:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
predeterminado: "1s:2,20s:3,1m:5"-
Límites que, si se alcanzan, hacen que GcThrashingDetector haga que Bazel falle con un error de OOM. Cada límite se especifica como <period>:<count>, en el que period es una duración y count es un número entero positivo. Si más del porcentaje --gc_thrashing_threshold del espacio a perpetuidad (heap de generación anterior) permanece ocupado después de <count> GC completas consecutivas en <period>, se activa un error de OOM. Se pueden especificar varios límites separados por comas.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: “2147483647”-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC completo, se descartará el estado temporal innecesario de Skyframe hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de 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"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produce un evento de GC menor, descartará el estado temporal innecesario de Skyframe hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC menores nunca activarán las bajadas. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC menor y se supere ese umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
- Valor predeterminado de
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
Marca de configuración avanzada del motor interno de Skyframe de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es de al menos este límite, descartará el estado temporal innecesario de Skyframe. 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:
--experimental_command_profile=<cpu, wall, alloc or lock>
predeterminado: Consulta la descripción- Graba un perfil de Java Flight Recorder durante el tiempo que se ejecuta 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 que lleva el nombre del tipo de evento en el directorio de 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 resultados adicionales; úsalas bajo tu responsabilidad.
- Valor predeterminado de
--[no]experimental_record_metrics_for_all_mnemonics
: "falso" - De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
--help_verbosity=<long, medium or short>
predeterminado: “medium”-
Selecciona la verbosidad del comando help.
Etiquetas:affects_outputs
,terminal_output
--long
[-l
]-
Muestra la descripción completa de cada opción, en lugar de solo su nombre.
Se expande a:
--help_verbosity=long
Etiquetas:affects_outputs
,terminal_output
--short
-
Muestra solo los nombres de las opciones, no sus tipos ni significados.
Se expande a:
--help_verbosity=short
Etiquetas:affects_outputs
,terminal_output
- Opciones que especifican o alteran una entrada genérica a un comando de Bazel que no pertenece a otras categorías:
- Valor predeterminado de
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
predeterminado: “auto”- Es el modo de subprocesos que se usará para recuperar el repo. Si se establece en "desactivado", no se usa ningún subproceso de trabajo y la recuperación del repo está sujeta a reinicios. De lo contrario, usa un subproceso de trabajador virtual.
- Otras opciones, sin categorizar:
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
- Anula un repositorio con una ruta de acceso local en el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es una ruta absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta relativa, se relaciona con el directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace". Si la ruta de acceso determinada está vacía, quita las anulaciones anteriores.
Opciones de información
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
-
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--experimental_repository_downloader_retries=<an integer>
: "0" -
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
- Valor predeterminado de
--experimental_scale_timeouts=<a double>
: "1.0" -
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, los repositorios externos pueden funcionar en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
- Valor predeterminado de
--[no]incompatible_disable_native_repo_rules
: "falso" -
Si es falso, se pueden usar reglas de repositorio nativas en WORKSPACE. De lo contrario, se deben usar reglas de repositorio de Starlark. Las reglas de repositorio nativo incluyen local_repository, new_local_repository, local_config_platform, android_sdk_repository y android_ndk_repository.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché. De lo contrario, se usa el valor predeterminado de '<output_user_root>/cache/repos/v1'.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]repository_disable_download
: "falso" -
Si se establece, no se permite la descarga con ctx.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no se inhabilita por completo; ctx.execute aún podría ejecutar un ejecutable arbitrario que acceda a Internet.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de la compilación:
--gc_thrashing_threshold=<an integer in 0-100 range>
predeterminado: "100"-
Es el porcentaje 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 se inhabilita.
Etiquetas:host_machine_resource_optimizations
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
-
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitadas en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
- 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 derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "advertencia" -
Verifica si las dependencias directas de "bazel_dep" declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivarla a un error de resolución.
Etiquetas:loading_and_analysis
- 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 dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
predeterminado: “update”- especifica cómo usar el archivo de bloqueo y si se debe usar o no. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "refresh" para actualizar periódicamente la información mutable (versiones quitadas y módulos que faltaban anteriormente) de los registros remotos, "error" para usar el archivo de bloqueo, pero mostrar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
- Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso proporcionada es una ruta de acceso absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta de acceso relativa, se hará referencia al directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace". Si la ruta de acceso determinada está vacía, quita las anulaciones anteriores.
- Se acumulan varios usos de
--registry=<a string>
-
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los anteriores.
Etiquetas:changes_inputs
--vendor_dir=<a path>
predeterminado: Consulta la descripción-
Especifica el directorio que debe contener los repositorios externos en modo de proveedor, ya sea para recuperarlos o usarlos durante la compilación. La ruta de acceso se puede especificar como una ruta absoluta o una ruta relativa al directorio del espacio 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 falle con Bazel con una OOM. Cada límite se especifica como <period>:<count>, en el que period es una duración y count es un número entero positivo. Si más del porcentaje --gc_thrashing_threshold del espacio a perpetuidad (heap de generación anterior) permanece ocupado después de <count> GC completas consecutivas en <period>, se activa un error de OOM. Se pueden especificar varios límites separados por comas.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC completo, se descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. La configuración predeterminada es Integer.MAX_VALUE; en efecto ilimitado. Cero significa que los eventos de GC completos nunca activarán las bajadas. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC completo y se supere ese umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: “2147483647”-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando 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. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC menores nunca activarán las bajadas. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC menor y se supere ese umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: “85”-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es de al menos este límite, descartará el estado temporal innecesario de Skyframe. Si ajustas este parámetro, es posible que puedas mitigar el impacto del tiempo de ejecución de la fragmentación de GC, cuando esta se produce (i) por el uso de memoria de este estado temporal y (ii) es más costoso que reconstituir el estado cuando sea necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--experimental_command_profile=<cpu, wall, alloc or lock>
predeterminado: Consulta la descripción- Graba un perfil de Java Flight Recorder durante el tiempo que se ejecuta el comando. Se debe proporcionar como argumento uno de los tipos de eventos de generación de perfiles admitidos (cpu, wall, alloc o lock). El perfil se escribe en un archivo que lleva el nombre del tipo de evento en el directorio de base de salida. La sintaxis y la semántica de esta marca pueden cambiar en el futuro para admitir tipos de perfiles o formatos de salida adicionales. Úsala bajo tu propio riesgo.
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
--[no]show_make_env
predeterminado: “false”-
Incluye el entorno "Make" en el resultado.
Etiquetas:affects_outputs
,terminal_output
- Opciones que especifican o modifican una entrada genérica para un comando de Bazel que no se encuentra en otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
- Valor predeterminado de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno que debe coincidir y otro para usar como URL sustituta, con referencias inversas a partir de "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URL.
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
predeterminado: “auto”- Es el modo de subprocesos que se usará para recuperar el repo. 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, usa un subproceso de trabajador virtual.
- Otras opciones, sin categorizar:
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
- Anula un repositorio con una ruta de acceso local en el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es una ruta absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta relativa, se relaciona con el directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace". Si la ruta de acceso determinada está vacía, quita las anulaciones anteriores.
Opciones de licencia
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
-
Dónde buscar archivos antes de acceder a la red y descargarlos
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, se puede hacer que los repositorios externos funcionen en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--[no]incompatible_disable_native_repo_rules
predeterminado: “false”-
Si es falso, se pueden usar reglas de repositorio nativas en WORKSPACE. De lo contrario, se deben usar reglas de repositorio de Starlark. Las reglas de repositorio nativo incluyen local_repository, new_local_repository, local_config_platform, android_sdk_repository y android_ndk_repository.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación de la caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché. De lo contrario, se usa el valor predeterminado de '<output_user_root>/cache/repos/v1'.
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
predeterminado: “false”-
Si se establece, no se permite la descarga con ctx.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no se inhabilita por completo; ctx.execute aún podría ejecutar un ejecutable arbitrario que acceda a Internet.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de la compilación:
--gc_thrashing_threshold=<an integer in 0-100 range>
predeterminado: "100"-
Es el porcentaje de espacio ocupado (de 0 a 100) por encima del cual GcThrashingDetector considera los eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, se inhabilita GcThrashingDetector.
Etiquetas:host_machine_resource_optimizations
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
-
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitadas en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión generada permitida con la variable de entorno `BZLMOD_ALLOW_YANKED_VERSIONS`. Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "advertencia" -
Verifica si las dependencias directas de "bazel_dep" declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivarla a un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
predeterminado: “update”-
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, "refresh" para actualizar periódicamente la información mutable (versiones quitadas y módulos que faltaban anteriormente) de los registros remotos, "error" para usar el archivo de bloqueo, pero mostrar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
- Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso proporcionada es una ruta de acceso absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta de acceso relativa, se considerará en relación con el directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace". Si la ruta de acceso determinada está vacía, quita las anulaciones anteriores.
- Se acumulan varios usos de
--registry=<a string>
-
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los anteriores.
Etiquetas:changes_inputs
- Valor predeterminado de
--vendor_dir=<a path>
: ver descripción -
Especifica el directorio que debe contener los repositorios externos en modo de proveedor, ya sea para recuperarlos o usarlos durante la compilación. La ruta de acceso se puede especificar como una ruta absoluta o una ruta relativa al directorio del espacio de trabajo.
Etiquetas:loading_and_analysis
- Opciones que activan optimizaciones del tiempo de compilación:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
predeterminado: "1s:2,20s:3,1m:5"-
Límites que, si se alcanzan, hacen que GcThrashingDetector haga que Bazel falle con un error de OOM. Cada límite se especifica como <period>:<count>, donde el período es una duración y el conteo es un número entero positivo. Si más del porcentaje --gc_thrashing_threshold del espacio a perpetuidad (heap de generación anterior) permanece ocupado después de <count> GC completas consecutivas en <period>, se activa un error de OOM. Se pueden especificar varios límites separados por comas.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC completo, se descartará el estado temporal innecesario de Skyframe hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de 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"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando 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. El valor predeterminado es Integer.MAX_VALUE, es decir, ilimitado. 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
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Marca de configuración avanzada del motor interno de Skyframe de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es de al menos este límite, descartará el estado temporal innecesario de Skyframe. 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:
--experimental_command_profile=<cpu, wall, alloc or lock>
predeterminado: Consulta la descripción- Graba un perfil de Java Flight Recorder durante el tiempo que se ejecuta el comando. Se debe proporcionar como argumento uno de los tipos de eventos de generación de perfiles admitidos (cpu, wall, alloc o lock). El perfil se escribe en un archivo que lleva el nombre del tipo de evento en el directorio de base de salida. La sintaxis y la semántica de esta marca pueden cambiar en el futuro para admitir tipos de perfiles o formatos de salida adicionales. Úsala bajo tu propio riesgo.
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán las estadísticas de todos los mnemónicos.
- Opciones que especifican o alteran una entrada genérica a un comando de Bazel que no se incluye en otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
predeterminado: “auto”- 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, usa un subproceso de trabajador virtual.
- Otras opciones, sin categorizar:
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
- Anula un repositorio con una ruta de acceso local en el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es una ruta de acceso absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta de acceso relativa, se relaciona con el directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace". Si la ruta de acceso determinada está vacía, quita las anulaciones anteriores.
Opciones de instalación para dispositivos móviles
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]experimental_repository_cache_hardlinks
: "falso" -
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--experimental_repository_downloader_retries=<an integer>
: "0" -
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
- Valor predeterminado de
--experimental_scale_timeouts=<a double>
: "1.0" -
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, se puede hacer que los repositorios externos funcionen en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
- Valor predeterminado de
--[no]incompatible_disable_native_repo_rules
: "falso" -
Si es falso, se pueden usar reglas de repositorio nativas en WORKSPACE. De lo contrario, se deben usar reglas de repositorio de Starlark. Las reglas de repositorio nativo incluyen local_repository, new_local_repository, local_config_platform, android_sdk_repository y android_ndk_repository.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché. De lo contrario, se usa el valor predeterminado de '<output_user_root>/cache/repos/v1'.
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
predeterminado: “false”-
Si se establece, no se permite la descarga con ctx.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no se inhabilita por completo; ctx.execute aún podría ejecutar un ejecutable arbitrario que acceda a Internet.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de la compilación:
--gc_thrashing_threshold=<an integer in 0-100 range>
predeterminado: "100"-
Es el porcentaje de espacio ocupado (de 0 a 100) por encima del cual GcThrashingDetector considera los eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, se inhabilita GcThrashingDetector.
Etiquetas:host_machine_resource_optimizations
--mode=<classic, classic_internal_test_do_not_use or skylark>
predeterminado: “classic”-
Selecciona cómo ejecutar la instalación para dispositivos móviles. "classic" ejecuta la versión actual de mobile-install. "skylark" usa la nueva versión de Starlark, que admite android_test.
Etiquetas:loading_and_analysis
,execution
,incompatible_change
- Opciones que configuran la cadena de herramientas que se usa para la ejecución de acciones:
--adb=<a string>
predeterminado: ""
Objeto binario - adb que se usará para el comando "mobile-install". Si no se especifica, el que se encuentra en el SDK de Android especificado por la opción de línea de comandos --android_sdk (o el SDK predeterminado si no se especifica --android_sdk).
Etiquetas:changes_inputs
- Opciones que controlan el resultado del comando:
--[no]incremental
predeterminado: “false”-
Indica si se debe realizar una instalación incremental. Si es verdadero, intenta evitar el trabajo adicional innecesario leyendo el estado del dispositivo en el que se instalará el código y usa esa información para evitar el trabajo innecesario. Si es falso (la opción predeterminada), siempre realiza una instalación completa.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]split_apks
: "falso" -
Indica si se deben usar APK divididos para instalar y actualizar la aplicación en el dispositivo. Solo funciona con dispositivos con Marshmallow o versiones posteriores.
Etiquetas:loading_and_analysis
,affects_outputs
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
- Se acumulan varios usos de
--adb_arg=<a string>
-
Argumentos adicionales para pasar a adb. Por lo general, se usa para designar un dispositivo en el que se instalará.
Etiquetas:action_command_lines
--debug_app
-
Determina si se debe esperar al depurador antes de iniciar la app.
Se expande a lo siguiente:
--start=DEBUG
Etiquetas:execution
--device=<a string>
predeterminado: ""-
Es el número de serie del dispositivo de ADB. Si no se especifica, se usará el primer dispositivo.
Etiquetas:action_command_lines
- Valor predeterminado de
--start=<no, cold, warm or debug>
: "NO" -
Indica cómo se debe iniciar la app después de instalarla. Establece el valor en WARM para conservar y restablecer el estado de la aplicación en las instalaciones incrementales.
Etiquetas:execution
--start_app
-
Determina si se debe iniciar la app después de instalarla.
Se expande a:
--start=COLD
Etiquetas:execution
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
-
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitadas en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
: "error" -
Comprueba la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
--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 un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
predeterminado: “update”- especifica cómo usar el archivo de bloqueo y si se debe usar o no. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "refresh" para actualizar periódicamente la información mutable (versiones quitadas y módulos que faltaban anteriormente) de los registros remotos, "error" para usar el archivo de bloqueo, pero mostrar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
- Anula un módulo con una ruta de acceso local con el formato <module name>=<path>. Si la ruta proporcionada es una ruta de acceso absoluta, se usará como es. Si la ruta proporcionada es una ruta de acceso relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace". Si la ruta de acceso determinada está vacía, quita las anulaciones anteriores.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los anteriores.
Etiquetas:changes_inputs
--vendor_dir=<a path>
predeterminado: Consulta la descripción-
Especifica el directorio que debe contener 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 haga que Bazel falle con un error de OOM. Cada límite se especifica como <period>:<count>, donde period es una duración y count es un número entero positivo. Si más del porcentaje --gc_thrashing_threshold del espacio a perpetuidad (heap de generación anterior) permanece ocupado después de <count> GC completas consecutivas en <period>, se activa un error de OOM. Se pueden especificar varios límites separados por comas.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Marca de configuración avanzada del motor interno de 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 GC completo, se descartará el estado temporal innecesario de Skyframe hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC completos nunca activarán las bajadas. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC completo y se supere ese umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produce un evento de GC menor, descartará el estado temporal innecesario de Skyframe hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE, es decir, ilimitado. 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
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es de al menos este límite, descartará el estado temporal innecesario de Skyframe. Si ajustas este parámetro, es posible que puedas mitigar el impacto del tiempo de ejecución de la fragmentación de GC, cuando esta se produce (i) por el uso de memoria de este estado temporal y (ii) es más costoso que reconstituir el estado cuando sea necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--experimental_command_profile=<cpu, wall, alloc or lock>
predeterminado: Consulta la descripción- Graba un perfil de Java Flight Recorder durante el tiempo que se ejecuta el comando. Se debe proporcionar como argumento uno de los tipos de eventos de generación de perfiles admitidos (cpu, wall, alloc o lock). 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 pueden cambiar en el futuro para admitir tipos de perfiles o formatos de salida adicionales. Úsala bajo tu propio riesgo.
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán las estadísticas de todos los mnemónicos.
- Valor predeterminado de
--incremental_install_verbosity=<a string>
: "" -
Es la verbosidad para una instalación incremental. Se establece en 1 para el registro de depuración.
Etiquetas:bazel_monitoring
- Son opciones que especifican o alteran una entrada genérica en un comando de Bazel que no pertenece a otras categorías.:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo para configurar el cargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
predeterminado: "automático"- Es el modo de subprocesos que se usará para recuperar el repo. 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, usa un subproceso de trabajador virtual.
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
- Anula un repositorio con una ruta de acceso local con el formato <repository name>=<path>. Si la ruta dada es una ruta absoluta, se usará tal como es. Si la ruta proporcionada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace". Si la ruta de acceso determinada está vacía, quita las anulaciones anteriores.
Opciones de modificación
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
-
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se configura, la caché del repositorio vinculará el archivo en caso de un acierto de caché, en lugar de copiarse. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--experimental_repository_downloader_retries=<an integer>
: "0" -
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, se puede hacer que los repositorios externos funcionen en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--[no]incompatible_disable_native_repo_rules
predeterminado: “false”-
Si es falso, se pueden usar reglas de repositorio nativas en WORKSPACE. De lo contrario, se deben usar reglas de repositorio de Starlark. Estas reglas incluyen local_repository, new_local_repository, local_config_platform, android_sdk_repository y android_ndk_repository.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación en caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché. De lo contrario, se usa el valor predeterminado de '<output_user_root>/cache/repos/v1'.
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
predeterminado: “false”-
Si se establece, no se permite la descarga con ctx.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no se inhabilita por completo; ctx.execute aún podría ejecutar un ejecutable arbitrario que acceda a Internet.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de la compilación:
--gc_thrashing_threshold=<an integer in 0-100 range>
predeterminado: "100"-
Es el porcentaje de espacio ocupado (de 0 a 100) por encima del cual GcThrashingDetector considera los eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, GcThrashingDetector se inhabilita.
Etiquetas:host_machine_resource_optimizations
--[no]keep_going
[-k
] predeterminado: "false"-
Continúa tanto como sea posible después de un error. Si bien no se pueden analizar el objetivo que falló ni los que dependen de él, sí se pueden analizar otros requisitos previos de estos objetivos.
Etiquetas:eagerness_to_exit
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
predeterminado: "automático"-
Cantidad de subprocesos en paralelo que se usarán para la fase de carga o análisis. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". “auto” establece un valor predeterminado razonable según los recursos del host. Debe ser 1 como mínimo.
Etiquetas:bazel_internal_configuration
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.:
- Valor predeterminado de
--[no]incompatible_config_setting_private_default_visibility
: "falso" -
Si incompatible_enforce_config_setting_visibility=false, esto es una operación no realizada. De lo contrario, si esta marca es falsa, cualquier config_setting sin un atributo de visibilidad explícito es //visibility:public. Si esta marca es verdadera, config_setting sigue la misma lógica de visibilidad que todas las demás reglas. Consulta https://github.com/bazelbuild/bazel/issues/12933.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
predeterminado: "true"-
Si es verdadero, aplica las restricciones de visibilidad de config_setting. Si es falso, todos los config_setting son visibles para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones relacionadas con el resultado y la semántica del subcomando "mod":
--base_module=<"<root>" for the root module; <module>@<version> for a specific version of a module; <module> for all versions of a module; @<name> for a repo with the given apparent name; or @@<name> for a repo with the given canonical name>
predeterminado: "<root>"-
Especifica un módulo en relación con el cual se interpretarán los repositorios de destino especificados.
Etiquetas:terminal_output
--charset=<utf8 or ascii>
predeterminado: "utf8"-
Elige el grupo de caracteres que se usará para el árbol. Solo afecta a la salida de texto. Los valores válidos son “utf8” o “ascii”. El valor predeterminado es "utf8".
Etiquetas:terminal_output
--[no]cycles
predeterminado: “false”-
Indica los ciclos de dependencia dentro del árbol que se muestra, que normalmente se ignoran de forma predeterminada.
Etiquetas:terminal_output
- Valor predeterminado de
--depth=<an integer>
: "-1" -
Profundidad de visualización máxima del árbol de dependencias. Por ejemplo, una profundidad de 1 muestra las dependencias directas. Para tree, path y all_paths, el valor predeterminado es Integer.MAX_VALUE, mientras que para deps y explain, el valor predeterminado es 1 (solo muestra las dependencias directas de la raíz además de las hojas de destino y sus elementos superiores).
Etiquetas:terminal_output
--extension_filter=<a comma-separated list of <extension>s>
predeterminado: Consulta la descripción-
Solo muestra los usos de estas extensiones de módulo y los repositorios que generan si se establecen sus respectivas marcas. Si se establece, el gráfico de resultados solo incluirá las rutas de acceso que contengan módulos que usen las extensiones especificadas. Una lista vacía inhabilita el filtro y especifica de manera efectiva todas las extensiones posibles.
Etiquetas:terminal_output
--extension_info=<hidden, usages, repos or all>
predeterminado: "hidden"-
Especifica cuántos detalles sobre los usos de la extensión se deben incluir en el resultado de la consulta. En "Usages", solo se mostrarán los nombres de las extensiones, en "repos" también se incluirán los repositorios importados con use_repo y en "all" también se mostrarán los otros repositorios generados por las extensiones.
Etiquetas:terminal_output
--extension_usages=<a comma-separated list of <module>s>
predeterminado: ""-
Especifica los módulos cuyos usos de extensión se mostrarán en la consulta show_extension.
Etiquetas:terminal_output
--from=<a comma-separated list of <module>s>
predeterminado: "<root>"-
Los módulos a partir de los que se mostrará la consulta del gráfico de dependencia. Verifica la descripción de cada consulta para ver la semántica exacta. El valor predeterminado es <root>.
Etiquetas:terminal_output
--[no]include_builtin
predeterminado: “false”-
Incluye módulos integrados en el gráfico de dependencias. Está inhabilitado de forma predeterminada porque es bastante ruidoso.
Etiquetas:terminal_output
--[no]include_unused
predeterminado: “false”-
Las consultas también tendrán en cuenta y mostrarán los módulos no utilizados, que no están presentes en el gráfico de resolución de módulos después de la selección (debido a la selección de versión mínima o las reglas de anulación). Esto puede tener diferentes efectos para cada uno de los tipos de consulta, es decir, incluir rutas nuevas en el comando all_paths o dependencias adicionales en el comando explain.
Etiquetas:terminal_output
--output=<text, json or graph>
predeterminado: “text”-
Es el formato en el que se deben imprimir los resultados de la consulta. Los valores permitidos para la consulta son: texto, json, gráfico.
Etiquetas:terminal_output
--[no]verbose
predeterminado: “false”-
Las consultas también mostrarán el motivo por el que los módulos se resolvieron en su versión actual (si se cambiaron). El valor predeterminado es verdadero solo para la consulta de explicación.
Etiquetas:terminal_output
- Opciones relacionadas con la salida y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
-
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitadas en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
- 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 derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "advertencia" -
Verifica si las dependencias directas de "bazel_dep" declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivarla a un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--lockfile_mode=<off, update, refresh or error>
: "actualizar" - especifica cómo usar el archivo de bloqueo y si se debe usar o no. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "refresh" para actualizar adicionalmente la información mutable (versiones eliminadas y módulos anteriores faltantes) de los registros remotos de vez en cuando, "error" para usar el archivo bloqueado, pero arrojar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
- Anula un módulo con una ruta de acceso local con el formato <module name>=<path>. Si la ruta proporcionada es una ruta de acceso absoluta, se usará como es. Si la ruta proporcionada es una ruta de acceso 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 del "espacio de trabajo de información de bazel". Si la ruta dada está vacía, quita las anulaciones anteriores.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los anteriores.
Etiquetas:changes_inputs
--vendor_dir=<a path>
predeterminado: Consulta la descripción-
Especifica el directorio que debe contener 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 falle con Bazel con una OOM. Cada límite se especifica como <period>:<count>, en el que period es una duración y count es un número entero positivo. Si más del porcentaje --gc_thrashing_threshold del espacio a perpetuidad (heap de generación anterior) permanece ocupado después de <count> GC completas consecutivas en <period>, se activa un error de OOM. Se pueden especificar varios límites separados por comas.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de 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; en efecto ilimitado. Cero significa que los eventos de GC completos nunca activarán las bajadas. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC completo y se supere ese umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: “2147483647”-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando 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. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC menores nunca activarán las bajadas. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC menor y se supere ese umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Marca de configuración avanzada del motor interno de Skyframe de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es de al menos este límite, descartará el estado temporal innecesario de Skyframe. Si ajustas este parámetro, es posible que puedas mitigar el impacto del tiempo de ejecución de la fragmentación de GC, cuando esta se produce (i) por el uso de memoria de este estado temporal y (ii) es más costoso que reconstituir el estado cuando sea necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--experimental_command_profile=<cpu, wall, alloc or lock>
predeterminado: Consulta la descripción- Graba un perfil de Java Flight Recorder durante el tiempo que se ejecuta el comando. Se debe proporcionar como argumento uno de los tipos de eventos de generación de perfiles admitidos (cpu, wall, alloc o lock). El perfil se escribe en un archivo que lleva el nombre del tipo de evento en el directorio de 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 resultados adicionales; úsalas bajo tu responsabilidad.
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán las estadísticas de todos los mnemónicos.
- Opciones que especifican o alteran una entrada genérica a un comando de Bazel que no se incluye en otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
predeterminado: “auto”- Es el modo de subprocesos que se usará para recuperar el repo. Si se establece en "desactivado", no se usa ningún subproceso de trabajo y la recuperación del repo está sujeta a reinicios. De lo contrario, usa un subproceso de trabajador virtual.
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--deleted_packages=<comma-separated list of package names>
- Es una lista separada por comas de nombres de paquetes que el sistema de compilación considerará inexistentes, incluso si son visibles en algún lugar de la ruta de acceso del paquete. Utiliza 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, es posible que el sistema de compilación se queje si encuentra una etiqueta "//x:y/z" si otra entrada de package_path aún la proporciona. Especificar --deleted_packages x/y evita este problema.
- Valor predeterminado de
--[no]fetch
: "true" - Permite que el comando recupere dependencias externas. Si se establece como falso, el comando usará cualquier versión almacenada en caché de la dependencia y, 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 <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es una ruta de acceso absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta de acceso relativa, se relaciona con el directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace". Si la ruta de acceso determinada está vacía, quita las anulaciones anteriores.
--package_path=<colon-separated list of options>
predeterminado: “%workspace%”- Es una lista separada por dos puntos de dónde buscar paquetes. Los elementos que comienzan con "%workspace%" son relativos al lugar de trabajo que los contiene. Si se omite o está vacío, el valor predeterminado es el resultado de "bazel info default-package-path".
- Valor predeterminado de
--[no]show_loading_progress
: "true" - Si se habilita, hace que Bazel imprima mensajes de “Loading package:”.
Opciones de Print_action
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
-
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Ajusta todos los tiempos de espera en las reglas del repositorio de Starlark con 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
,experimental
--[no]incompatible_disable_native_repo_rules
predeterminado: “false”-
Si es falso, se pueden usar reglas de repositorio nativas en WORKSPACE. De lo contrario, se deben usar reglas de repositorio de Starlark. Las reglas de repositorio nativo incluyen local_repository, new_local_repository, local_config_platform, android_sdk_repository y android_ndk_repository.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché. De lo contrario, se usa el valor predeterminado de '<output_user_root>/cache/repos/v1'.
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
predeterminado: “false”-
Si se establece, no se permite la descarga con ctx.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no se inhabilita por completo; ctx.execute aún podría ejecutar un ejecutable arbitrario que acceda a Internet.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de compilación:
--gc_thrashing_threshold=<an integer in 0-100 range>
predeterminado: "100"-
Es el porcentaje de espacio ocupado (de 0 a 100) por encima del cual GcThrashingDetector considera los eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, GcThrashingDetector se inhabilita.
Etiquetas:host_machine_resource_optimizations
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
-
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitadas en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
- 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 derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
--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
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de 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, refresh or error>
: "actualizar" - especifica cómo usar el archivo de bloqueo y si se debe usar o no. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "refresh" para actualizar adicionalmente la información mutable (versiones eliminadas y módulos anteriores faltantes) de los registros remotos de vez en cuando, "error" para usar el archivo bloqueado, pero arrojar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
- Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso proporcionada es una ruta de acceso absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta de acceso relativa, se considerará en relación con el 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 del "espacio de trabajo de información de bazel". Si la ruta dada está vacía, quita las anulaciones anteriores.
- Se acumulan varios usos de
--registry=<a string>
-
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los anteriores.
Etiquetas:changes_inputs
--vendor_dir=<a path>
predeterminado: Consulta la descripción-
Especifica el directorio que debe contener los repositorios externos en modo de proveedor, ya sea para recuperarlos o usarlos durante la compilación. La ruta de acceso se puede especificar como una ruta absoluta o una ruta relativa al directorio del espacio de trabajo.
Etiquetas:loading_and_analysis
- Opciones que activan optimizaciones del tiempo de compilación:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
predeterminado: "1s:2,20s:3,1m:5"-
Límites que, si se alcanzan, hacen que GcThrashingDetector haga que Bazel falle con un error de OOM. Cada límite se especifica como <period>:<count>, en el que period es una duración y count es un número entero positivo. Si más del porcentaje --gc_thrashing_threshold del espacio a perpetuidad (heap de generación anterior) permanece ocupado después de <count> GC completas consecutivas en <period>, se activa un error de OOM. Se pueden especificar varios límites separados por comas.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC completo, se descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE, es decir, ilimitado. Cero significa que los eventos de GC completos nunca activarán las bajadas. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC completo y se supere ese umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Marca de configuración avanzada del motor interno de 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 produce un evento de GC menor, descartará el estado temporal innecesario de Skyframe hasta esta cantidad de veces por invocación. La configuración predeterminada es Integer.MAX_VALUE; en efecto ilimitado. 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
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Marca de configuración avanzada del motor interno de Skyframe de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es de al menos este límite, descartará el estado temporal innecesario de Skyframe. 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:
--experimental_command_profile=<cpu, wall, alloc or lock>
predeterminado: Consulta la descripción- Registra un perfil de la grabadora de vuelos de Java durante la ejecución del comando. Se debe proporcionar como argumento uno de los tipos de eventos de generación de perfiles admitidos (cpu, wall, alloc o lock). 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 pueden cambiar en el futuro para admitir tipos de perfiles o formatos de salida adicionales. Úsala bajo tu propio riesgo.
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
- Opciones que especifican o alteran una entrada genérica en un comando de Bazel que no se incluye en otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
predeterminado: “auto”- Es el modo de subprocesos que se usará para recuperar el repo. Si se establece en "desactivado", no se usa ningún subproceso de trabajo y la recuperación del repo está sujeta a reinicios. De lo contrario, usa un subproceso de trabajador virtual.
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
- Anula un repositorio con una ruta de acceso local en el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es una ruta de acceso absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta de acceso relativa, se relaciona con el directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace". Si la ruta de acceso determinada está vacía, quita las anulaciones anteriores.
- Se acumulan varios usos de
--print_action_mnemonics=<a string>
- Enumera los mnemónicos por los que se filtrarán los datos de print_action. No se realizará ningún filtrado si se deja vacío.
Opciones de consulta
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
-
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--experimental_repository_downloader_retries=<an integer>
: "0" -
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, se puede hacer que los repositorios externos funcionen en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
- Valor predeterminado de
--[no]incompatible_disable_native_repo_rules
: "falso" -
Si es falso, se pueden usar reglas de repositorio nativas en WORKSPACE. De lo contrario, se deben usar reglas de repositorio de Starlark. Las reglas de repositorio nativo incluyen local_repository, new_local_repository, local_config_platform, android_sdk_repository y android_ndk_repository.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché. De lo contrario, se usa el valor predeterminado de '<output_user_root>/cache/repos/v1'.
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
predeterminado: “false”-
Si se establece, no se permite la descarga con ctx.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no se inhabilita por completo; ctx.execute aún podría ejecutar un ejecutable arbitrario que acceda a Internet.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de la compilación:
--gc_thrashing_threshold=<an integer in 0-100 range>
predeterminado: "100"-
Es el porcentaje de espacio ocupado (de 0 a 100) por encima del cual GcThrashingDetector considera los eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, GcThrashingDetector se inhabilita.
Etiquetas:host_machine_resource_optimizations
--[no]keep_going
[-k
] predeterminado: "false"-
Continúa tanto como sea posible después de un error. Si bien el 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: “auto”-
Es la cantidad de subprocesos paralelos que se usarán en la fase de carga o análisis. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguido de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". “auto” establece un valor predeterminado razonable según los recursos del host. Debe ser 1 como mínimo.
Etiquetas:bazel_internal_configuration
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE:
- Valor predeterminado de
--[no]incompatible_config_setting_private_default_visibility
: "falso" -
Si incompatible_enforce_config_setting_visibility=false, esto es una operación no realizada. De lo contrario, si esta marca es falsa, cualquier config_setting sin un atributo de visibilidad explícito es //visibility:public. Si esta marca es verdadera, config_setting sigue la misma lógica de visibilidad que todas las demás reglas. Consulta https://github.com/bazelbuild/bazel/issues/12933.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
predeterminado: "true"-
Si es verdadero, aplica las restricciones de visibilidad de config_setting. Si es falso, todos los config_setting son visibles para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones relacionadas con el resultado y la semántica de la consulta:
--aspect_deps=<off, conservative or precise>
predeterminado: "conservative"-
Cómo resolver las dependencias de aspecto cuando el formato de salida es uno de {xml,proto,record}. "Desactivado" significa que no se resuelven las dependencias de aspecto. "Conservador" (la opción predeterminada) significa que se agregan todas las dependencias de aspecto declaradas, independientemente de si se les asigna la clase de regla de dependencias directas. "Preciso" significa que solo se agregan los aspectos que pueden estar activos según la clase de regla de las dependencias directas. Ten en cuenta que el modo preciso requiere la carga de otros paquetes para evaluar un solo objetivo, lo que lo hace más lento que los otros modos. Además, ten en cuenta que incluso el modo preciso no es del todo preciso: la decisión de calcular un aspecto se toma en la fase de análisis, que no se ejecuta durante la "consulta de bazel".
Etiquetas:build_file_semantics
--[no]consistent_labels
predeterminado: “false”-
Si está habilitada, cada comando de consulta emite etiquetas como si fuera la función Starlark <code>str</code> aplicada a una instancia de <code>Label</code>. Esto resulta útil para las herramientas que necesitan hacer coincidir el resultado de diferentes comandos de consulta o etiquetas emitidas por las reglas. Si no están habilitados, los formateadores de salida pueden emitir nombres de repositorio aparentes (en relación con el repositorio principal) para que el resultado sea más legible.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]experimental_explicit_aspects
: "falso" -
aquery, cquery: Indica si se deben incluir acciones generadas por aspectos en el resultado. query: No-op (siempre se siguen los aspectos).
Etiquetas:terminal_output
--[no]experimental_graphless_query
predeterminado: “auto”-
Si es verdadero, usa una implementación de consulta que no crea una copia del gráfico. La nueva implementación solo admite --order_output=no, así como solo un subconjunto de formateadores de salida.
Etiquetas:build_file_semantics
,eagerness_to_exit
--graph:conditional_edges_limit=<an integer>
predeterminado: “4”-
Es la cantidad máxima de etiquetas de condición que se mostrarán. -1 significa que no hay truncamiento y 0 significa que no hay anotaciones. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--[no]graph:factored
predeterminado: "true"-
Si es verdadero, el gráfico se emitirá "factorizado", es decir, los nodos topológicamente equivalentes se combinarán y sus etiquetas se concatenarán. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--graph:node_limit=<an integer>
predeterminado: “512”-
Es la longitud máxima de la cadena de etiqueta para un nodo de grafo en el resultado. Las etiquetas más largas se truncarán. -1 significa que no se truncará. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--[no]implicit_deps
predeterminado: "true"-
Si está habilitada, se incluirán dependencias implícitas en el gráfico de dependencias sobre el que opera la consulta. Una dependencia implícita es 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: Indica si se deben incluir acciones generadas por aspectos en el resultado. query: No-op (siempre se siguen los aspectos).
Etiquetas:terminal_output
--[no]incompatible_lexicographical_output
predeterminado: "true"-
Si se establece esta opción, se ordena el resultado de --order_output=auto en orden alfabético.
Etiquetas:terminal_output
,incompatible_change
- Valor predeterminado de
--[no]incompatible_package_group_includes_double_slash
: "true" -
Si está habilitada, cuando se genere el atributo "packages" de package_group, no se omitirá el "//" inicial.
Etiquetas:terminal_output
,incompatible_change
--[no]infer_universe_scope
predeterminado: “false”-
Si se establece y no se establece --universe_scope, se inferirá un valor de --universe_scope como la lista de patrones de destino únicos en la expresión de consulta. Ten en cuenta que el valor de --universe_scope inferido para una expresión de consulta que usa funciones centradas en el universo (p.ej., "allrdeps") puede no ser lo que deseas, por lo que debes usar esta opción solo si sabes lo que estás haciendo. Consulta https://bazel.build/reference/query#sky-query para obtener detalles y ejemplos. Si se establece --universe_scope, se ignora el valor de esta opción. Nota: Esta opción solo se aplica a “query” (es decir, no a “cquery”).
Etiquetas:loading_and_analysis
--[no]line_terminator_null
predeterminado: “false”-
Indica si cada formato finaliza con \0 en lugar de una línea nueva.
Etiquetas:terminal_output
--[no]nodep_deps
predeterminado: "true"-
Si está habilitada, las dependencias de los atributos "nodep" se incluirán en el gráfico de dependencias sobre el que opera la consulta. Un ejemplo común de un atributo “nodep” es la “visibilidad”. Ejecuta y analiza el resultado de `info build-language` para conocer todos los atributos "nodep" en el lenguaje de compilación.
Etiquetas:build_file_semantics
--noorder_results
-
Muestra los resultados en orden de dependencia (predeterminado) o sin orden. El resultado desordenado es más rápido, pero solo se admite cuando --output no es minrank, maxrank ni grafo.
Se expande a:
--order_output=no
Etiquetas:terminal_output
--null
-
Indica si cada formato finaliza con \0 en lugar de una línea nueva.
Se expande a:
--line_terminator_null=true
Etiquetas:terminal_output
--order_output=<no, deps, auto or full>
predeterminado: “auto”-
Muestra los resultados sin ordenar (no), ordenados por dependencia (deps) o completamente ordenados (full). El valor predeterminado es "auto", lo que significa que los resultados son los resultados ordenados por dependencia o por completo, según el formateador de salida (ordenado por dependencias para proto, minrank, maxrank y Graph, ordenados por completo para todos los demás). Cuando el resultado está completamente ordenado, los nodos se imprimen en un orden completamente determinista (total). Primero, todos los nodos se ordenan alfabéticamente. Luego, cada nodo de la lista se usa como el inicio de una búsqueda en profundidad post-orden en la que se recorren los bordes salientes a los nodos no visitados en orden alfabético de los nodos sucesores. Por último, los nodos se imprimen en el orden inverso del orden en que se visitaron.
Etiquetas:terminal_output
--order_results
-
Muestra los resultados en orden de dependencia (predeterminado) o sin orden. La salida no ordenada es más rápida, pero solo se admite cuando --output no es minrank, maxrank ni graph.
Se expande a:
--order_output=auto
Etiquetas:terminal_output
--output=<a string>
predeterminado: "label"-
Es el formato en el que se deben imprimir los resultados de la consulta. Los valores permitidos para la consulta son: build, graph, streamed_jsonproto, label, label_kind, location, maxrank, minrank, package, proto, streamed_proto, textproto, xml.
Etiquetas:terminal_output
--[no]proto:default_values
predeterminado: "true"-
Si es verdadero, se incluyen los atributos cuyo valor no se especifica de forma explícita en el archivo BUILD; de lo contrario, se omiten. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
--[no]proto:definition_stack
predeterminado: “false”-
Propaga el campo proto definition_stack, que registra para cada instancia de regla la pila de llamadas de Starlark en el momento en que se definió la clase de la regla.
Etiquetas:terminal_output
--[no]proto:flatten_selects
predeterminado: "true"-
Si se habilita, se acoplan los atributos configurables creados por select(). En el caso de los tipos de lista, la representación aplanada es una lista que contiene cada valor del mapa de selección exactamente una vez. Los tipos escalares se aplanan a nulos.
Etiquetas:build_file_semantics
--[no]proto:include_attribute_source_aspects
predeterminado: “false”-
Propaga el campo proto source_aspect_name de cada atributo con el aspecto de origen del que proviene el atributo (cadena vacía si no es así).
Etiquetas:terminal_output
--[no]proto:include_synthetic_attribute_hash
predeterminado: “false”-
Indica si se debe calcular y propagar el atributo $internal_attr_hash.
Etiquetas:terminal_output
- 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
--[no]proto:locations
predeterminado: "true"-
Indica si se debe generar información de ubicación en el resultado de proto.
Etiquetas:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
predeterminado: “all”-
Es una lista de atributos separados por comas que se incluirán en el resultado. La configuración predeterminada es todos los atributos. Establece una cadena vacía para no mostrar 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 propagan o no los campos rule_input y rule_output.
Etiquetas:terminal_output
--query_file=<a string>
predeterminado: ""-
Si se establece, la consulta leerá la consulta del archivo que se nombra aquí, en lugar de la línea de comandos. Especificar un archivo aquí y una consulta de línea de comandos es un error.
Etiquetas:changes_inputs
--[no]relative_locations
predeterminado: “false”-
Si es verdadero, la ubicación de los archivos BUILD en los resultados de xml y proto será relativa. De forma predeterminada, el resultado de la ubicación es una ruta de acceso absoluta y no será coherente en todas las máquinas. Puedes configurar esta opción como verdadera para obtener un resultado coherente en todas las máquinas.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]strict_test_suite
: "falso" -
Si es verdadero, la expresión tests() muestra un error si encuentra un test_suite que contiene objetivos que no son de prueba.
Etiquetas:build_file_semantics
,eagerness_to_exit
- Valor predeterminado de
--[no]tool_deps
: "true" -
Consulta: Si se inhabilita, las dependencias de "configuración de ejecución" no se incluirán en el gráfico de dependencias sobre el que opera la consulta. Un perímetro de dependencia de 'configuración de ejecución', como la de cualquier regla de 'proto_library' para el Compilador de protocolos, generalmente apunta a una herramienta ejecutada durante la compilación en lugar de a una parte del mismo programa de 'destino'.
Cquery: Si se inhabilita, filtra todos los objetivos configurados que cruzan una transición de ejecución desde el 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 objetivo de nivel superior está en la configuración de exec, solo se mostrarán los objetivos configurados por exec. Esta opción NO excluirá las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
--universe_scope=<comma-separated list of options>
predeterminado: ""-
Es un conjunto de patrones de destino (aditivos y sustractivos) separados por comas. La consulta se puede realizar en el universo definido por el cierre transitivo de los destinos especificados. Esta opción se usa para los comandos query y cquery.
En el caso de cquery, la entrada de esta opción son los objetivos en los que se compilan todas las respuestas, por lo que esta opción puede afectar las configuraciones y las transiciones. Si no se especifica esta opción, se supone que los destinos de nivel superior son los que se analizaron 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
--[no]xml:default_values
predeterminado: “false”-
Si es verdadero, se imprimen los atributos de regla cuyo valor no se especifica de forma explícita en el archivo BUILD. De lo contrario, se omiten.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]xml:line_numbers
: "true" -
Si es verdadero, el resultado en formato XML contiene números de línea. Si inhabilitas esta opción, es posible que las diferencias sean más fáciles de leer. Esta opción solo se aplica a --output=xml.
Etiquetas:terminal_output
- Opciones relacionadas con la salida y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
-
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitados en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
- 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 derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "advertencia" -
Verifica si las dependencias directas de “bazel_dep” declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivarla a un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--lockfile_mode=<off, update, refresh or error>
: "actualizar" - especifica cómo usar el archivo de bloqueo y si se debe usar o no. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "refresh" para actualizar adicionalmente la información mutable (versiones eliminadas y módulos anteriores faltantes) de los registros remotos de vez en cuando, "error" para usar el archivo bloqueado, pero arrojar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
- Anula un módulo con una ruta de acceso local con el formato <module name>=<path>. Si la ruta proporcionada es una ruta de acceso absoluta, se usará como es. Si la ruta proporcionada es una ruta de acceso relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace". Si la ruta de acceso determinada está vacía, quita las anulaciones anteriores.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los anteriores.
Etiquetas:changes_inputs
--vendor_dir=<a path>
predeterminado: Consulta la descripción-
Especifica el directorio que debe contener 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 haga que Bazel falle con un error de OOM. Cada límite se especifica como <period>:<count>, donde period es una duración y count es un número entero positivo. Si hay más de --gc_thrashing_threshold por ciento de espacio permanente (montón de generación anterior) permanece ocupado después de <count> recolecciones de elementos no utilizados consecutivos en <period>, se activará una OOM. Se pueden especificar varios límites separados por comas.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC completo, se descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC completos nunca activarán las bajadas. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC completo y se supere ese umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produce un evento de GC menor, descartará el estado temporal innecesario de Skyframe hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE, es decir, ilimitado. Cero significa que los eventos de GC menores nunca activarán las bajadas. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC menor y se supere ese umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es al menos este umbral, descartará el estado temporal de Skyframe innecesario. Si ajustas este parámetro, es posible que puedas mitigar el impacto del tiempo de ejecución de la fragmentación de GC, cuando esta se produce (i) por el uso de memoria de este estado temporal y (ii) es más costoso que reconstituir el estado cuando sea necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--experimental_command_profile=<cpu, wall, alloc or lock>
predeterminado: Consulta la descripción- Graba un perfil de Java Flight Recorder durante el tiempo que se ejecuta el comando. Se debe proporcionar como argumento uno de los tipos de eventos de generación de perfiles admitidos (cpu, wall, alloc o lock). El perfil se escribe en un archivo que lleva el nombre del tipo de evento en el directorio de base de salida. La sintaxis y la semántica de esta marca pueden cambiar en el futuro para admitir tipos de perfiles o formatos de salida adicionales. Úsala bajo tu propio riesgo.
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
--experimental_repository_resolved_file=<a string>
predeterminado: ""-
Si no está vacío, escribe un valor de Starlark con la información resuelta de todas las reglas del repositorio de Starlark que se ejecutaron.
Etiquetas:affects_outputs
- 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é remotos:
- Valor predeterminado de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
predeterminado: “auto”- Es el modo de subprocesos que se usará para recuperar el repo. Si se establece en "desactivado", no se usa ningún subproceso de trabajo y la recuperación del repo está sujeta a reinicios. De lo contrario, usa un subproceso de trabajador virtual.
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--deleted_packages=<comma-separated list of package names>
- 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. Utiliza 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, es posible que el sistema de compilación se queje si encuentra una etiqueta "//x:y/z" si otra entrada de package_path aún la proporciona. Especificar --deleted_packages x/y evita este problema.
- Valor predeterminado de
--[no]fetch
: "true" - Permite que el comando recupere dependencias externas. Si se establece como falso, el comando usará cualquier versión almacenada en caché de la dependencia y, si no existe ninguna, el comando fallará.
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
- Anula un repositorio con una ruta de acceso local en el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es una ruta absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta relativa, se relaciona con el directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace". Si la ruta de acceso determinada está vacía, quita las anulaciones anteriores.
--package_path=<colon-separated list of options>
predeterminado: “%workspace%”- Es una lista separada por dos puntos de dónde buscar paquetes. Los elementos que comienzan con “%workspace%” son relativos al espacio de trabajo que los contiene. Si se omite o está vacío, el valor predeterminado es el resultado de "bazel info default-package-path".
--[no]show_loading_progress
predeterminado: "true"- Si está habilitado, hace que Bazel imprima mensajes de “Carga del paquete:”.
Opciones de ejecución
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
-
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]experimental_repository_cache_hardlinks
: "falso" -
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto está diseñado para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--experimental_repository_downloader_retries=<an integer>
: "0" -
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
- Valor predeterminado de
--experimental_scale_timeouts=<a double>
: "1.0" -
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, los repositorios externos pueden funcionar en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
- Valor predeterminado de
--[no]incompatible_disable_native_repo_rules
: "falso" -
Si es falso, se pueden usar reglas de repositorio nativas en WORKSPACE. De lo contrario, se deben usar reglas de repositorio de Starlark. Estas reglas incluyen local_repository, new_local_repository, local_config_platform, android_sdk_repository y android_ndk_repository.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación de la caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché. De lo contrario, se usa el valor predeterminado de '<output_user_root>/cache/repos/v1'.
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
predeterminado: “false”-
Si se establece, no se permite la descarga con ctx.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no se inhabilita por completo; ctx.execute aún podría ejecutar un ejecutable arbitrario que acceda a Internet.
Etiquetas:bazel_internal_configuration
--[no]run
predeterminado: "true"-
Si es falso, omite la ejecución de la línea de comandos construida para el destino compilado.
Etiquetas:affects_outputs
- Opciones que controlan la ejecución de la compilación:
--gc_thrashing_threshold=<an integer in 0-100 range>
predeterminado: "100"-
Es el porcentaje 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, se inhabilita GcThrashingDetector.
Etiquetas:host_machine_resource_optimizations
- Son opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
--script_path=<a path>
predeterminado: Consulta la descripción-
Si se configura, escribe una secuencia de comandos de shell en el archivo dado que invoca el destino. Si se establece esta opción, el destino no se ejecutará desde Bazel. Usa "bazel run --script_path=foo //foo && ./foo" para invocar el objetivo "//foo". Esto difiere de "bazel run //foo" en que se libera el bloqueo de bazel y el ejecutable se conecta al stdin de la terminal.
Etiquetas:affects_outputs
,execution
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
-
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitadas en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "advertencia" -
Verifica si las dependencias directas de "bazel_dep" declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivarla a un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
predeterminado: “update”-
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, "refresh" para actualizar periódicamente la información mutable (versiones quitadas y módulos que faltaban anteriormente) de los registros remotos, "error" para usar el archivo de bloqueo, pero mostrar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
- Anula un módulo con una ruta de acceso local con el formato <module name>=<path>. Si la ruta proporcionada es una ruta de acceso absoluta, se usará como es. Si la ruta proporcionada es una ruta de acceso relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace". Si la ruta de acceso determinada está vacía, quita las anulaciones anteriores.
- Se acumulan varios usos de
--registry=<a string>
-
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los anteriores.
Etiquetas:changes_inputs
--vendor_dir=<a path>
predeterminado: Consulta la descripción-
Especifica el directorio que debe contener los repositorios externos en modo de proveedor, ya sea para recuperarlos o usarlos durante la compilación. La ruta de acceso se puede especificar como una ruta absoluta o una ruta relativa al directorio del espacio de trabajo.
Etiquetas:loading_and_analysis
- Opciones que activan optimizaciones del tiempo de compilación:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
predeterminado: "1s:2,20s:3,1m:5"-
Límites que, si se alcanzan, hacen que GcThrashingDetector haga que Bazel falle con un error de OOM. Cada límite se especifica como <period>:<count>, en el que period es una duración y count es un número entero positivo. Si más del porcentaje --gc_thrashing_threshold del espacio a perpetuidad (heap de generación anterior) permanece ocupado después de <count> GC completas consecutivas en <period>, se activa un error de OOM. Se pueden especificar varios límites separados por comas.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Marca de configuración avanzada del motor interno de 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 GC completo, se descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE, es decir, ilimitado. 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"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produce un evento de GC menor, descartará el estado temporal innecesario de Skyframe hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC menores nunca activarán las bajadas. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC menor y se supere ese umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es de al menos este límite, descartará el estado temporal innecesario de Skyframe. Si ajustas este parámetro, es posible que puedas mitigar el impacto del tiempo de ejecución de la fragmentación de GC, cuando esta se produce (i) por el uso de memoria de este estado temporal y (ii) es más costoso que reconstituir el estado cuando sea necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--experimental_command_profile=<cpu, wall, alloc or lock>
predeterminado: Consulta la descripción- Graba un perfil de Java Flight Recorder durante el tiempo que se ejecuta el comando. Se debe proporcionar como argumento uno de los tipos de eventos de generación de perfiles admitidos (cpu, wall, alloc o lock). 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 resultados adicionales; úsalas bajo tu responsabilidad.
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán las estadísticas de todos los mnemónicos.
- Opciones que especifican o alteran una entrada genérica a un comando de Bazel que no se incluye en otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno que debe coincidir y otro para usar como URL sustituta, con referencias inversas a partir de "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URL.
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
predeterminado: “auto”- El modo de subprocesos que se usará para la recuperación del repositorio. Si se establece en "desactivado", no se usa ningún subproceso de trabajo y la recuperación del repo está sujeta a reinicios. De lo contrario, usa un subproceso de trabajador virtual.
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
- Anula un repositorio con una ruta de acceso local en el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es una ruta absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta relativa, se relaciona con el directorio de trabajo actual. Si la ruta de acceso dada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado del "espacio de trabajo de información de bazel". Si la ruta dada está vacía, quita las anulaciones anteriores.
Opciones de apagado
- 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 para descargarlos.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]experimental_repository_cache_hardlinks
: "falso" -
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, se puede hacer que los repositorios externos funcionen en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--[no]incompatible_disable_native_repo_rules
predeterminado: “false”-
Si es falso, se pueden usar reglas de repositorio nativas en WORKSPACE. De lo contrario, se deben usar reglas de repositorio de Starlark. Las reglas de repositorio nativo incluyen local_repository, new_local_repository, local_config_platform, android_sdk_repository y android_ndk_repository.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché. De lo contrario, se usa el valor predeterminado de '<output_user_root>/cache/repos/v1'.
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
predeterminado: “false”-
Si se configura, no se permite la descarga mediante ctx.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no se inhabilita por completo; ctx.execute aún podría ejecutar un ejecutable arbitrario que acceda a Internet.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de la compilación:
--gc_thrashing_threshold=<an integer in 0-100 range>
predeterminado: "100"-
Es el porcentaje 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, se inhabilita GcThrashingDetector.
Etiquetas:host_machine_resource_optimizations
- Opciones que controlan el resultado del comando:
- Valor predeterminado de
--iff_heap_size_greater_than=<an integer>
: "0" -
Si el valor no es cero, el cierre solo apagará el servidor si la memoria total (en MB) que consume la JVM supera este valor.
Etiquetas:loses_incremental_state
,eagerness_to_exit
- Opciones relacionadas con la salida y la semántica de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitadas en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: “error”-
Comprueba la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "advertencia" -
Verifica si las dependencias directas de "bazel_dep" declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivarla a un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
predeterminado: "update"-
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, "refresh" para actualizar periódicamente la información mutable (versiones quitadas y módulos que faltaban anteriormente) de los registros remotos, "error" para usar el archivo de bloqueo, pero mostrar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso proporcionada es una ruta de acceso absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta de acceso relativa, se considerará en relación con el directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace". Si la ruta de acceso determinada está vacía, quita las anulaciones anteriores.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los anteriores.
Etiquetas:changes_inputs
--vendor_dir=<a path>
predeterminado: Consulta la descripción-
Especifica el directorio que debe contener los repositorios externos en modo de proveedor, ya sea para recuperarlos o usarlos durante la compilación. La ruta de acceso se puede especificar como una ruta absoluta o una ruta relativa al directorio del espacio de trabajo.
Etiquetas:loading_and_analysis
- Opciones que activan optimizaciones del tiempo de compilación:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
predeterminado: "1s:2,20s:3,1m:5"-
Límites que, si se alcanzan, hacen que GcThrashingDetector haga que Bazel falle con un error de OOM. Cada límite se especifica como <period>:<count>, en el que period es una duración y count es un número entero positivo. Si hay más de --gc_thrashing_threshold por ciento de espacio permanente (montón de generación anterior) permanece ocupado después de <count> recolecciones de elementos no utilizados consecutivos en <period>, se activará una OOM. Si hay varios límites, puedes separarlos por comas.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: “2147483647”-
Marca de configuración avanzada del motor interno de 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 GC completo, se descartará el estado temporal innecesario de Skyframe hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC completos nunca activarán las bajadas. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC completo y se supere ese umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produce un evento de GC menor, descartará el estado temporal innecesario de Skyframe hasta esta cantidad de veces por invocación. La configuración predeterminada es Integer.MAX_VALUE; en efecto ilimitado. Cero significa que los eventos de GC menores nunca activarán las bajadas. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC menor y se supere ese umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es al menos este umbral, descartará el estado temporal de Skyframe innecesario. Si ajustas este parámetro, es posible que puedas mitigar el impacto del tiempo de ejecución de la fragmentación de GC, cuando esta se produce (i) por el uso de memoria de este estado temporal y (ii) es más costoso que reconstituir el estado cuando sea necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--experimental_command_profile=<cpu, wall, alloc or lock>
predeterminado: Consulta la descripción- Registra un perfil de la grabadora de vuelos de Java durante la ejecución del comando. Se debe proporcionar como argumento uno de los tipos de eventos de generación de perfiles admitidos (cpu, wall, alloc o lock). 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 pueden cambiar en el futuro para admitir tipos de perfiles o formatos de salida adicionales. Úsala bajo tu propio riesgo.
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si 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.
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
- Valor predeterminado de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
predeterminado: “auto”- Es el modo de subprocesos que se usará para recuperar el repo. Si se establece en "desactivado", no se usa ningún subproceso de trabajo y la recuperación del repo está sujeta a reinicios. De lo contrario, usa un subproceso de trabajador virtual.
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
- Anula un repositorio con una ruta de acceso local en el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es una ruta absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta relativa, se relaciona con el directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace". Si la ruta de acceso determinada está vacía, quita las anulaciones anteriores.
Opciones de sincronización
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
-
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
- Valor predeterminado de
--experimental_scale_timeouts=<a double>
: "1.0" -
Ajusta todos los tiempos de espera en las reglas del repositorio de Starlark con este factor. De esta manera, se puede hacer que los repositorios externos funcionen en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--[no]incompatible_disable_native_repo_rules
predeterminado: “false”-
Si es falso, se pueden usar reglas de repositorio nativas en WORKSPACE. De lo contrario, se deben usar reglas de repositorio de Starlark. Las reglas de repositorio nativo incluyen local_repository, new_local_repository, local_config_platform, android_sdk_repository y android_ndk_repository.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación en caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché. De lo contrario, se usa el valor predeterminado de '<output_user_root>/cache/repos/v1'.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]repository_disable_download
: "falso" -
Si se establece, no se permite la descarga con ctx.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no se inhabilita por completo; ctx.execute aún podría ejecutar un ejecutable arbitrario que acceda a Internet.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de la compilación:
--[no]configure
predeterminado: "False"-
Solo se sincronizan los repositorios marcados como "configurar" para la configuración del sistema.
Etiquetas:changes_inputs
--gc_thrashing_threshold=<an integer in 0-100 range>
predeterminado: "100"-
Es el porcentaje 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, se inhabilita GcThrashingDetector.
Etiquetas:host_machine_resource_optimizations
--[no]keep_going
[-k
] predeterminado: "false"-
Continúa tanto como sea posible después de un error. Si bien no se pueden analizar el objetivo que falló ni los que dependen de él, sí se pueden analizar otros requisitos previos de estos objetivos.
Etiquetas:eagerness_to_exit
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
predeterminado: “auto”-
Cantidad de subprocesos en paralelo que se usarán para la fase de carga o análisis. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". "auto" establece un valor predeterminado razonable según los recursos del host. Debe ser 1 como mínimo.
Etiquetas:bazel_internal_configuration
- Se acumulan varios usos de
--only=<a string>
-
Si se proporciona esta opción, solo se sincronizarán los repositorios especificados con esta opción. De todos modos, considera que todas (o todas las configuraciones de --configure) están desactualizadas.
Etiquetas:changes_inputs
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.:
- Valor predeterminado de
--[no]incompatible_config_setting_private_default_visibility
: "falso" -
Si incompatible_enforce_config_setting_visibility=false, esto es una operación no realizada. De lo contrario, si esta marca es falsa, cualquier config_setting sin un atributo de visibilidad explícito 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
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
predeterminado: "true"-
Si es verdadero, aplica las restricciones de visibilidad de config_setting. Si es falso, todos los config_setting son visibles para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
-
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitadas en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones rechazadas harán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
- 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 derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "advertencia" -
Verifica si las dependencias directas de "bazel_dep" declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
predeterminado: "update"- especifica cómo usar el archivo de bloqueo y si se debe usar o no. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "refresh" para actualizar periódicamente la información mutable (versiones quitadas y módulos que faltaban anteriormente) de los registros remotos, "error" para usar el archivo de bloqueo, pero mostrar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
- Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso proporcionada es una ruta de acceso absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta de acceso relativa, se considerará en relación con el directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace". Si la ruta de acceso determinada está vacía, quita las anulaciones anteriores.
- Se acumulan varios usos de
--registry=<a string>
-
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los anteriores.
Etiquetas:changes_inputs
--vendor_dir=<a path>
predeterminado: Consulta la descripción-
Especifica el directorio que debe contener 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 haga que Bazel falle con un error de OOM. Cada límite se especifica como <period>:<count>, en el que period es una duración y count es un número entero positivo. Si más del porcentaje --gc_thrashing_threshold del espacio a perpetuidad (heap de generación anterior) permanece ocupado después de <count> GC completas consecutivas en <period>, se activa un error de OOM. Se pueden especificar varios límites separados por comas.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: “2147483647”-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC completo, se descartará el estado temporal innecesario de Skyframe hasta esta cantidad de veces por invocación. La configuración predeterminada es Integer.MAX_VALUE; en efecto ilimitado. Cero significa que los eventos de GC completos nunca activarán las bajadas. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC completo y se supere ese umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Marca de configuración avanzada del motor interno de 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 produce un evento de GC menor, descartará el estado temporal innecesario de Skyframe hasta esta cantidad de veces por invocación. La configuración predeterminada es Integer.MAX_VALUE; en efecto ilimitado. Cero significa que los eventos de GC menores nunca activarán las bajadas. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC menor y se supere ese umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
- Valor predeterminado de
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
Marca de configuración avanzada del motor interno de Skyframe de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es de al menos este límite, descartará el estado temporal innecesario de Skyframe. Si ajustas este parámetro, es posible que puedas mitigar el impacto del tiempo de ejecución de la fragmentación de GC, cuando esta se produce (i) por el uso de memoria de este estado temporal y (ii) es más costoso que reconstituir el estado cuando sea necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Valor predeterminado de
--experimental_command_profile=<cpu, wall, alloc or lock>
: ver descripción - Graba un perfil de Java Flight Recorder durante el tiempo que se ejecuta 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 resultados adicionales; úsalas bajo tu responsabilidad.
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
--experimental_repository_resolved_file=<a string>
predeterminado: ""-
Si no está vacío, escribe un valor de Starlark con la información resuelta de todas las reglas del repositorio de Starlark que se ejecutaron.
Etiquetas:affects_outputs
- Son opciones que especifican o alteran una entrada genérica en un comando de Bazel que no pertenece a otras categorías.:
- Valor predeterminado de
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
predeterminado: “auto”- Es el modo de subprocesos que se usará para recuperar el repo. 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, usa un subproceso de trabajador virtual.
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--deleted_packages=<comma-separated list of package names>
- Es una lista separada por comas de nombres de paquetes que el sistema de compilación considerará inexistentes, incluso si son visibles en algún lugar de la ruta de acceso del paquete. Usa esta opción cuando borres un subpaquete "x/y" de un paquete existente "x". Por ejemplo, después de borrar x/y/BUILD en tu cliente, es posible que el sistema de compilación se queje si encuentra una etiqueta "//x:y/z" si otra entrada de package_path aún la proporciona. Especificar --deleted_packages x/y evita este problema.
--[no]fetch
predeterminado: "true"- Permite que el comando recupere dependencias externas. Si se establece como falso, el comando usará cualquier versión almacenada en caché de la dependencia y, 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 <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es una ruta absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta relativa, se relaciona con el directorio de trabajo actual. Si la ruta de acceso dada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado del "espacio de trabajo de información de bazel". Si la ruta dada está vacía, quita las anulaciones anteriores.
--package_path=<colon-separated list of options>
predeterminado: "%workspace%"- Una lista separada por dos puntos de dónde buscar paquetes. Los elementos que comienzan con "%workspace%" son relativos al lugar de trabajo que los contiene. Si se omite o está vacío, el valor predeterminado es el resultado de “bazel info default-package-path”.
--[no]show_loading_progress
predeterminado: "true"- Si está habilitado, hace que Bazel imprima mensajes de “Carga del paquete:”.
Opciones de prueba
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, los repositorios externos pueden funcionar en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--[no]incompatible_disable_native_repo_rules
predeterminado: “false”-
Si es falso, se pueden usar reglas de repositorio nativas en WORKSPACE. De lo contrario, se deben usar reglas de repositorio de Starlark. Estas reglas incluyen local_repository, new_local_repository, local_config_platform, android_sdk_repository y android_ndk_repository.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación de la caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché. De lo contrario, se usa el valor predeterminado de '<output_user_root>/cache/repos/v1'.
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
predeterminado: “false”-
Si se configura, no se permite la descarga mediante ctx.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no se inhabilita por completo; ctx.execute aún podría ejecutar un ejecutable arbitrario que acceda a Internet.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de la compilación:
- Valor predeterminado de
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Es el porcentaje de espacio ocupado (de 0 a 100) por encima del cual GcThrashingDetector considera los eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, se inhabilita GcThrashingDetector.
Etiquetas:host_machine_resource_optimizations
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitadas en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "advertencia" -
Verifica si las dependencias directas de "bazel_dep" declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
predeterminado: “update”- especifica cómo usar el archivo de bloqueo y si se debe usar o no. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "refresh" para actualizar adicionalmente la información mutable (versiones eliminadas y módulos anteriores faltantes) de los registros remotos de vez en cuando, "error" para usar el archivo bloqueado, pero arrojar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso proporcionada es una ruta de acceso absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta de acceso relativa, se considerará en relación con el directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace". Si la ruta de acceso determinada está vacía, quita las anulaciones anteriores.
- Se acumulan varios usos de
--registry=<a string>
-
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los anteriores.
Etiquetas:changes_inputs
- Valor predeterminado de
--vendor_dir=<a path>
: ver descripción -
Especifica el directorio que debe contener 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 haga que Bazel falle con un error de OOM. Cada límite se especifica como <period>:<count>, donde period es una duración y count es un número entero positivo. Si más del porcentaje --gc_thrashing_threshold del espacio a perpetuidad (heap de generación anterior) permanece ocupado después de <count> GC completas consecutivas en <period>, se activa un error de OOM. Se pueden especificar varios límites separados por comas.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de recolección de elementos no utilizados completa, eliminará el estado temporal de Skyframe innecesario, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC completos nunca activarán las bajadas. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC completo y se supere ese umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produce un evento de GC menor, descartará el estado temporal innecesario de Skyframe hasta esta cantidad de veces por invocación. La configuración predeterminada es Integer.MAX_VALUE; en efecto ilimitado. Cero significa que los eventos de GC menores nunca activarán las bajadas. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC menor y se supere ese umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Marca de configuración avanzada del motor interno de 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. Si ajustas este parámetro, es posible que puedas mitigar el impacto del tiempo de ejecución de la fragmentación de GC, cuando esta se produce (i) por el uso de memoria de este estado temporal y (ii) es más costoso que reconstituir el estado cuando sea necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--experimental_command_profile=<cpu, wall, alloc or lock>
predeterminado: Consulta la descripción- Graba un perfil de Java Flight Recorder durante el tiempo que se ejecuta el comando. Se debe proporcionar como argumento uno de los tipos de eventos de generación de perfiles admitidos (cpu, wall, alloc o lock). El perfil se escribe en un archivo que lleva el nombre del tipo de evento en el directorio de base de salida. La sintaxis y la semántica de esta marca pueden cambiar en el futuro para admitir tipos de perfiles o formatos de salida adicionales. Úsala bajo tu propio riesgo.
- 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.
--[no]print_relative_test_log_paths
predeterminado: “false”-
Si es verdadero, cuando imprimas la ruta de acceso a un registro de prueba, usa la ruta de acceso relativa que usa el symlink de conveniencia "testlogs". Nota: Una invocación posterior de "build", "test", etc., con una configuración diferente puede hacer que cambie el destino de este symlink, por lo que la ruta impresa anteriormente ya no es útil.
Etiquetas:affects_outputs
--[no]test_verbose_timeout_warnings
predeterminado: “false”-
Si es verdadero, imprime advertencias adicionales cuando el tiempo de ejecución real de la prueba no coincida con el tiempo de espera definido por la prueba (ya sea implícito o explícito).
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]verbose_test_summary
: "true" -
Si es verdadero, imprime información adicional (plazo, cantidad de ejecuciones con errores, etc.) en el resumen de la prueba.
Etiquetas:affects_outputs
- Son opciones que especifican o alteran una entrada genérica en un comando de Bazel que no pertenece a otras categorías.:
- Valor predeterminado de
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno que debe coincidir y otro para usar como URL sustituta, con referencias inversas a partir de "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URL.
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
predeterminado: “auto”- Es el modo de subprocesos que se usará para recuperar el repo. Si se establece en "desactivado", no se usa ningún subproceso de trabajo y la recuperación del repo está sujeta a reinicios. De lo contrario, usa un subproceso de trabajador virtual.
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
- Anula un repositorio con una ruta de acceso local en el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es una ruta absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta relativa, se relaciona con el directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace". Si la ruta de acceso determinada está vacía, quita las anulaciones anteriores.
Opciones de proveedores
Hereda todas las opciones de test.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
-
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--experimental_repository_downloader_retries=<an integer>
: "0" -
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
- Valor predeterminado de
--experimental_scale_timeouts=<a double>
: "1.0" -
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, los repositorios externos pueden funcionar en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--[no]incompatible_disable_native_repo_rules
predeterminado: “false”-
Si es falso, se pueden usar reglas de repositorio nativas en WORKSPACE. De lo contrario, se deben usar reglas de repositorio de Starlark. Estas reglas incluyen local_repository, new_local_repository, local_config_platform, android_sdk_repository y android_ndk_repository.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación en caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché; de lo contrario, se usa el valor predeterminado "<output_user_root>/cache/repos/v1"
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
predeterminado: “false”-
Si se establece, no se permite la descarga con ctx.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no se inhabilita por completo; ctx.execute aún podría ejecutar un ejecutable arbitrario que acceda a Internet.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de compilación:
--gc_thrashing_threshold=<an integer in 0-100 range>
predeterminado: "100"-
Es el porcentaje de espacio ocupado (de 0 a 100) por encima del cual GcThrashingDetector considera los eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, se inhabilita GcThrashingDetector.
Etiquetas:host_machine_resource_optimizations
--[no]keep_going
[-k
] predeterminado: "false"-
Continúa tanto como sea posible después de un error. Si bien no se pueden analizar el objetivo que falló ni los que dependen de él, sí se pueden analizar otros requisitos previos de estos objetivos.
Etiquetas:eagerness_to_exit
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
predeterminado: “auto”-
Cantidad de subprocesos en paralelo que se usarán para la fase de carga o análisis. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". "auto" establece un valor predeterminado razonable según los recursos del host. Debe ser 1 como mínimo.
Etiquetas:bazel_internal_configuration
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.:
- Valor predeterminado de
--[no]incompatible_config_setting_private_default_visibility
: "falso" -
Si incompatible_enforce_config_setting_visibility=false, esto es una operación no realizada. De lo contrario, si esta marca es falsa, cualquier config_setting sin un atributo de visibilidad explícito 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
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
predeterminado: "true"-
Si es verdadero, aplica las restricciones de visibilidad de config_setting. Si es falso, todos los config_setting son visibles para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones relacionadas con la salida y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
-
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitados en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave “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 derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "advertencia" -
Verifica si las dependencias directas de “bazel_dep” declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivarla a un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--lockfile_mode=<off, update, refresh or error>
: "actualizar" - especifica cómo usar el archivo de bloqueo y si se debe usar o no. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "refresh" para actualizar periódicamente la información mutable (versiones quitadas y módulos que faltaban anteriormente) de los registros remotos, "error" para usar el archivo de bloqueo, pero mostrar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
- Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso proporcionada es una ruta de acceso absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta de acceso relativa, se hará referencia al directorio de trabajo actual. Si la ruta de acceso dada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado del "espacio de trabajo de información de bazel". Si la ruta dada está vacía, quita las anulaciones anteriores.
- Se acumulan varios usos de
--registry=<a string>
-
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los anteriores.
Etiquetas:changes_inputs
- Se acumulan
--repo=<a string>
usos múltiples -
Solo los proveedores del repositorio especificado, que puede ser "@apparent_repo_name" o "@@canonical_repo_name". Esta opción se puede establecer varias veces
Etiquetas:changes_inputs
--vendor_dir=<a path>
predeterminado: Consulta la descripción-
Especifica el directorio que debe contener los repositorios externos en modo de proveedor, ya sea para recuperarlos o usarlos durante la compilación. La ruta de acceso se puede especificar como una ruta absoluta o una ruta relativa al directorio del espacio de trabajo.
Etiquetas:loading_and_analysis
- Opciones que activan optimizaciones del tiempo de compilación:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
predeterminado: "1s:2,20s:3,1m:5"-
Límites que, si se alcanzan, hacen que GcThrashingDetector haga que Bazel falle con un error de OOM. Cada límite se especifica como <period>:<count>, en el que period es una duración y count es un número entero positivo. Si más del porcentaje --gc_thrashing_threshold del espacio a perpetuidad (heap de generación anterior) permanece ocupado después de <count> GC completas consecutivas en <period>, se activa un error de OOM. 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"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de recolección de elementos no utilizados completa, eliminará el estado temporal de Skyframe innecesario, hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC completos nunca activarán las bajadas. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC completo y se supere ese umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produce un evento de GC menor, descartará el estado temporal innecesario de Skyframe hasta esta cantidad de veces por invocación. La configuración predeterminada es Integer.MAX_VALUE; en efecto ilimitado. Cero significa que los eventos de GC menores nunca activarán las bajadas. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC menor y se supere ese umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es de al menos este límite, descartará el estado temporal innecesario de Skyframe. Si ajustas este parámetro, es posible que puedas mitigar el impacto del tiempo de ejecución de la fragmentación de GC, cuando esta se produce (i) por el uso de memoria de este estado temporal y (ii) es más costoso que reconstituir el estado cuando sea necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--experimental_command_profile=<cpu, wall, alloc or lock>
predeterminado: Consulta la descripción- Registra un perfil de la grabadora de vuelos de Java durante la ejecución del 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 que lleva el nombre del tipo de evento en el directorio de base de salida. La sintaxis y la semántica de esta marca pueden cambiar en el futuro para admitir tipos de perfiles o formatos de salida adicionales. Úsala bajo tu propio riesgo.
- Valor predeterminado de
--[no]experimental_record_metrics_for_all_mnemonics
: "falso" - De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias 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 alteran una entrada genérica a un comando de Bazel que no se incluye en otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
predeterminado: "automático"- Es el modo de subprocesos que se usará para recuperar el repo. 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, usa un subproceso de trabajador virtual.
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--deleted_packages=<comma-separated list of package names>
- 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 existente "x". Por ejemplo, después de borrar x/y/BUILD en tu cliente, es posible que el sistema de compilación se queje si encuentra una etiqueta "//x:y/z" si otra entrada de package_path aún la proporciona. Especificar --deleted_packages x/y evita este problema.
--[no]fetch
predeterminado: "true"- Permite que el comando recupere dependencias externas. Si se establece como falso, el comando usará cualquier versión almacenada en caché de la dependencia y, si no existe ninguna, el comando fallará.
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
- Anula un repositorio con una ruta de acceso local en el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es una ruta absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta relativa, se relaciona con el directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace". Si la ruta de acceso determinada está vacía, quita las anulaciones anteriores.
--package_path=<colon-separated list of options>
predeterminado: "%workspace%"- Una lista separada por dos puntos de dónde buscar paquetes. Los elementos que comienzan con "%workspace%" son relativos al lugar de trabajo que los contiene. Si se omite o está vacío, el valor predeterminado es el resultado de "bazel info default-package-path".
- Valor predeterminado de
--[no]show_loading_progress
: "true" - Si está habilitado, hace que Bazel imprima mensajes de “Carga del paquete:”.
- Opciones que controlan la ejecución de la compilación:
--[no]experimental_inprocess_symlink_creation
predeterminado: “false”-
Determina si se deben realizar llamadas directas al sistema de archivos para crear árboles de symlinks.
Etiquetas:loading_and_analysis
,execution
,experimental
--[no]experimental_persistent_aar_extractor
predeterminado: “false”- Habilita el extractor de aar persistente con trabajadores.
Etiquetas:execution
- Valor predeterminado de
--[no]experimental_remotable_source_manifests
: "falso" -
Determina si las acciones del manifiesto de origen se pueden controlar de forma remota.
Etiquetas:loading_and_analysis
,execution
,experimental
--[no]experimental_split_coverage_postprocessing
predeterminado: “false”-
Si es verdadero, Bazel ejecutará el procesamiento posterior de la cobertura para la prueba en un nuevo inicio.
Etiquetas:execution
- 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 recorrerá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
,incompatible_change
--[no]incompatible_modify_execution_info_additive
predeterminado: “false”-
Cuando está habilitada, pasar varias marcas --modify_execution_info es aditivo. Cuando está inhabilitada, solo se tiene en cuenta la última marca.
Etiquetas:execution
,affects_outputs
,loading_and_analysis
,incompatible_change
--[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: “auto”-
Es la cantidad de subprocesos paralelos que se usarán en la fase de carga o análisis. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguido de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". "auto" establece un valor predeterminado razonable según los recursos del host. Debe ser 1 como mínimo.
Etiquetas:bazel_internal_configuration
- Se acumulan varios usos de
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
-
Agrega o quita claves de la información de ejecución de una acción según la mnemotecnia de la acción. Solo se aplica a las acciones que admiten información de ejecución. Muchas acciones comunes admiten información de ejecución, p.ej., Genrule, CppCompile, Javac, StarlarkAction y TestRunner. Cuando se especifican varios valores, el orden es importante porque muchas regex pueden aplicarse al mismo nombre nemotécnico.
Sintaxis: "regex=[+-]clave,regex=[+-]clave,...".
Ejemplos:
'.*=+x,.*=-y,.*=+z' agrega "x" y "z" a la información de ejecución de todas las acciones y quita "y".
"Genrule=+requires-x" agrega "requires-x" a la información de ejecución de todas las acciones de Genrule.
"(?!Genrule).*=-requires-x" quita "requires-x" de la información de ejecución para todas las acciones que no sean de Genrule.
Etiquetas:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Habilita las acciones de expansión de sintaxis y dex persistentes de Android con trabajadores.
Se expande a:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
-
Habilita el procesador de recursos de Android persistente con trabajadores.
Se expande a:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
--strategy=ProcessDatabinding=worker
--strategy=GenerateDataBindingBaseClasses=worker
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_dex_desugar
-
Habilita 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
,execution
--persistent_multiplex_android_resource_processor
-
Habilita el procesador de recursos de Android multiplexado persistente con trabajadores.
Se expande a:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_tools
-
Habilita las herramientas de Android persistentes y multiplexadas (dexing, expansión de sintaxis, procesamiento de recursos).
Se expande a:
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Etiquetas:host_machine_resource_optimizations
,execution
--[no]use_target_platform_for_tests
predeterminado: “false”-
Si es verdadero, Bazel usará la plataforma de destino para ejecutar pruebas en lugar del grupo de ejecución de pruebas.
Etiquetas:execution
- Son opciones que configuran la cadena de herramientas que se usa para la ejecución de acciones:
--android_compiler=<a string>
predeterminado: Consulta la descripción-
El compilador de destino de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_crosstool_top=<a build target label>
predeterminado: "//external:android/crosstool"-
Es la ubicación del compilador de C++ que se usa para las compilaciones de Android.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_grte_top=<a label>
predeterminado: Consulta la descripción-
El grte_top de destino de Android.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
predeterminado: "android"-
Selecciona la combinación de manifiestos que se usará para las reglas de 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
,loses_incremental_state
- Valor predeterminado de
--android_platforms=<a build target label>
: "" -
Establece las plataformas que usan los objetivos de android_binary. Si se especifican varias plataformas, el objeto binario es un APK grueso, que contiene objetos binarios nativos para cada plataforma de destino especificada.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_sdk=<a build target label>
predeterminado: "@bazel_tools//tools/android:sdk"-
Especifica el SDK o la plataforma de Android que se usa para compilar aplicaciones para Android.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--apple_crosstool_top=<a build target label>
predeterminado: "@bazel_tools//tools/cpp:toolchain"-
Es la etiqueta del paquete de herramientas cruzadas que se usará en las reglas de Apple y Objc, y sus dependencias.
Etiquetas:loses_incremental_state
,changes_inputs
--cc_output_directory_tag=<a string>
predeterminado: ""-
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas:affects_outputs
--compiler=<a string>
predeterminado: Consulta la descripción-
El compilador de C++ que se usará para compilar el destino.
Etiquetas:loading_and_analysis
,execution
--coverage_output_generator=<a build target label>
predeterminado: "@bazel_tools//tools/test:lcov_merger"-
Ubicación del binario que se usa para postprocesar informes de cobertura sin procesar. Actualmente, debe ser un grupo de archivos que contenga un solo archivo: el objeto binario. El valor predeterminado es “//tools/test:lcov_merger”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
predeterminado: “@bazel_tools//tools/test:coverage_report_generator”-
Ubicación del binario que se usa para generar informes de cobertura. Actualmente, debe ser un grupo de archivos que contenga un solo archivo: el objeto binario. El valor predeterminado es "//tools/test:coverage_report_generator".
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
predeterminado: "@bazel_tools//tools/test:coverage_support"-
Ubicación de los archivos de compatibilidad que se requieren en las entradas de cada acción de prueba que recopila la cobertura de código El valor predeterminado es “//tools/test:coverage_support”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--crosstool_top=<a build target label>
predeterminado: “@bazel_tools//tools/cpp:toolchain”-
Es la etiqueta del paquete de herramientas cruzadas que se usará para compilar código C++.
Etiquetas:loading_and_analysis
,changes_inputs
,affects_outputs
--custom_malloc=<a build target label>
predeterminado: Consulta la descripción-
Especifica una implementación de malloc personalizada. Este parámetro de configuración anula los atributos malloc en las reglas de compilación.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan varios usos de
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
-
Lista de expresiones regulares separadas por comas, cada una con el prefijo - (expresión negativa) opcionalmente, asignadas (=) a una lista de destinos de valores de restricción separados por comas. Si un objetivo no coincide con ninguna expresión negativa y con al menos una expresión positiva, la resolución de la cadena de herramientas se realizará como si hubiera declarado los valores de restricción como restricciones de ejecución. Ejemplo: //demo,-test=@platforms//cpus:x86_64 agregará 'x86_64' a cualquier destino en //demo, excepto a aquellos cuyo nombre contenga 'test'.
Etiquetas:loading_and_analysis
--[no]experimental_include_xcode_execution_requirements
predeterminado: “false”-
Si se establece, agrega un requisito de ejecución "requires-xcode:{version}" a cada acción de Xcode. Si la versión de Xcode tiene una etiqueta con guiones, también agrega un requisito de ejecución “requires-xcode-label:{version_label}”.
Etiquetas:loses_incremental_state
,loading_and_analysis
,execution
- Valor predeterminado de
--[no]experimental_prefer_mutual_xcode
: "true" -
Si es verdadero, usa la versión más reciente de Xcode que esté disponible de forma local y remota. Si es falso o si no hay versiones mutuas disponibles, usa la versión local de Xcode seleccionada a través de xcode-select.
Etiquetas:loses_incremental_state
--extra_execution_platforms=<comma-separated list of options>
predeterminado: ""-
Son las plataformas disponibles como plataformas de ejecución para ejecutar acciones. Las plataformas se pueden especificar por destino exacto o como un patrón de destino. Estas plataformas se considerarán antes de las declaradas en el archivo WORKSPACE por register_execution_platforms(). Esta opción solo se puede establecer una vez; las instancias posteriores anularán la configuración de la marca anterior.
Etiquetas:execution
- Se acumulan varios usos de
--extra_toolchains=<comma-separated list of options>
-
Las reglas de la cadena de herramientas que se deben considerar durante su resolución. Las cadenas de herramientas se pueden especificar por destino exacto o como un patrón de destino. Estas cadenas de herramientas se considerarán antes que las declaradas en el archivo WORKSPACE por register_toolchains().
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--grte_top=<a label>
predeterminado: Consulta la descripción-
Es una etiqueta para una biblioteca libc verificada. La cadena de herramientas de crosstool selecciona el valor predeterminado, y casi nunca es necesario anularlo.
Etiquetas:action_command_lines
,affects_outputs
--host_compiler=<a string>
predeterminado: Consulta la descripción-
El compilador C++ que se usará para la compilación del host. Se ignora si no se establece --host_crosstool_top.
Etiquetas:loading_and_analysis
,execution
--host_crosstool_top=<a build target label>
predeterminado: Consulta la descripción-
De forma predeterminada, las opciones --crosstool_top y --compiler también se usan para la configuración de exec. Si se proporciona esta marca, Bazel usa la libc y el compilador predeterminados para el crosstool_top determinado.
Etiquetas:loading_and_analysis
,changes_inputs
,affects_outputs
--host_grte_top=<a label>
predeterminado: Consulta la descripción-
Si se especifica, este parámetro de configuración anula el directorio de nivel superior de libc (--grte_top) para la configuración de exec.
Etiquetas:action_command_lines
,affects_outputs
--host_platform=<a build target label>
valor predeterminado: "@bazel_tools//tools:host_platform"-
La etiqueta de una regla de plataforma que describe el sistema host.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
predeterminado: "true"-
Si es verdadero, Bazel no habilitará las funciones "host" y "nonhost" en la cadena de herramientas de C++ (consulta https://github.com/bazelbuild/bazel/issues/7407 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_android_toolchain_resolution
predeterminado: "true"-
Usa la resolución de cadena de herramientas para seleccionar el SDK de Android para las reglas de Android (Starlark y nativo)
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]incompatible_enable_apple_toolchain_resolution
: "falso" -
Usa la resolución de cadena de herramientas para seleccionar el SDK de Apple para las reglas de Apple (Starlark y nativo)
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone
predeterminado: "true"-
Si es verdadero, Bazel no reutilizará las líneas de comandos de acciones de vínculos 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
,incompatible_change
--[no]incompatible_remove_legacy_whole_archive
predeterminado: "true"-
Si es verdadero, Bazel no vinculará las dependencias de la biblioteca como un archivo completo de forma predeterminada (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener instrucciones de migración).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_require_ctx_in_configure_features
predeterminado: "true"-
Si es verdadero, Bazel requerirá el parámetro "ctx" en cc_common.configure_features (consulta https://github.com/bazelbuild/bazel/issues/7793 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
-
Usa objetos compartidos de la interfaz si la cadena de herramientas lo admite. Actualmente, todas las cadenas de herramientas ELF admiten este parámetro de configuración.
Etiquetas:loading_and_analysis
,affects_outputs
,affects_outputs
- Valor predeterminado de
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Especifica la versión del SDK de iOS que se usará para compilar aplicaciones para iOS. Si no se especifica, se usa la versión predeterminada del SDK de iOS de "xcode_version".
Etiquetas:loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Especifica la versión del SDK de macOS que se usará para compilar aplicaciones para macOS. Si no se especifica, usa la versión predeterminada del SDK de macOS de "xcode_version".
Etiquetas:loses_incremental_state
--minimum_os_version=<a string>
predeterminado: Consulta la descripción-
La versión mínima del SO a la que se orienta tu compilación.
Etiquetas:loading_and_analysis
,affects_outputs
--platform_mappings=<a relative path>
predeterminado: ""-
Es la ubicación de un archivo de asignación que describe qué plataforma usar si no se establece ninguna o qué marcas establecer cuando ya existe una plataforma. Debe ser relativo a la raíz del espacio de trabajo principal. El valor predeterminado es "platform_mappings" (un archivo directamente debajo de la raíz del espacio de trabajo).
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
- Valor predeterminado de
--platforms=<a build target label>
: "" -
Son las etiquetas de las reglas de la plataforma que describen las plataformas de destino del comando actual.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
- Valor predeterminado de
--python2_path=<a string>
: ver descripción -
Obsoleto, no-op. Inhabilitado por `--incompatible_use_python_toolchains`.
Etiquetas:no_op
,deprecated
--python3_path=<a string>
predeterminado: Consulta la descripción-
Obsoleto, no realiza ninguna acción. Se inhabilitó con `--incompatible_use_python_toolchains`.
Etiquetas:no_op
,deprecated
--python_path=<a string>
predeterminado: Consulta la descripción-
Es la ruta de acceso absoluta del intérprete de Python que se invocó para ejecutar destinos de Python en la plataforma de destino. Obsoleto; se inhabilitó con --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
--python_top=<a build target label>
predeterminado: Consulta la descripción-
La etiqueta de un py_runtime que representa el intérprete de Python invocado para ejecutar destinos de Python en la plataforma de destino. Obsoleto; se inhabilitó con --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
- 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 para tvOS. Si no se especifica, se usa la versión predeterminada del SDK de tvOS de "xcode_version".
Etiquetas:loses_incremental_state
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Especifica la versión del SDK de watchOS que se usará para compilar aplicaciones para watchOS. Si no se especifica, usa la versión predeterminada del SDK de watchOS de "xcode_version".
Etiquetas:loses_incremental_state
--xcode_version=<a string>
predeterminado: Consulta la descripción-
Si se especifica, usa Xcode de la versión determinada para las acciones de compilación relevantes. Si no se especifica, usa la versión predeterminada del ejecutor de Xcode.
Etiquetas:loses_incremental_state
--xcode_version_config=<a build target label>
predeterminado: "@bazel_tools//tools/cpp:host_xcodes"-
Es la etiqueta de la regla xcode_config que se usará para seleccionar la versión de Xcode en la configuración de compilación.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Opciones que controlan el resultado del comando:
--[no]apple_generate_dsym
predeterminado: “false”-
Indica si se deben generar archivos de símbolos de depuración (.dSYM).
Etiquetas:affects_outputs
,action_command_lines
--[no]build_runfile_links
predeterminado: "true"-
Si es verdadero, compila bosques de symlinks de runfiles para todos los destinos. Si es falso, escríbelos solo cuando lo requiera una acción local, una prueba o un comando de ejecución.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]build_runfile_manifests
: "true" -
Si es verdadero, escribe manifiestos de archivos runfiles para todos los destinos. Si es falsa, omítelas. Las pruebas locales no se ejecutarán si es falso.
Etiquetas:affects_outputs
--[no]build_test_dwp
predeterminado: “false”-
Si está habilitado, cuando se compilen pruebas de C++ de forma estática y con Fission, el archivo .dwp para el objeto binario de prueba también se compilará automáticamente.
Etiquetas:loading_and_analysis
,affects_outputs
--cc_proto_library_header_suffixes=<comma-separated set of options>
predeterminado: “.pb.h”-
Establece los sufijos de los archivos de encabezado que crea una cc_proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated set of options>
predeterminado: “.pb.cc”-
Configura los sufijos de los archivos de origen que crea una cc_proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info
predeterminado: “false”-
Ejecuta acciones adicionales para versiones alternativas de la API de Java en una proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
- 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
,experimental
--[no]experimental_save_feature_state
predeterminado: “false”-
Guarda el estado de las funciones habilitadas y solicitadas como un resultado de la compilación.
Etiquetas:affects_outputs
,experimental
--fission=<a set of compilation modes>
predeterminado: “no”-
Especifica qué modos de compilación usan la fisión para las compilaciones y los vínculos de C++. Puede ser cualquier combinación de {'fastbuild', 'dbg', 'opt'} o los valores especiales "yes" para habilitar todos los modos y "no" para inhabilitarlos.
Etiquetas:loading_and_analysis
,action_command_lines
,affects_outputs
--[no]incompatible_always_include_files_in_data
predeterminado: "true"-
Si es verdadero, las reglas nativas agregan <code>DefaultInfo.files</code> de dependencias de datos a sus archivos de ejecución, lo que coincide con el comportamiento recomendado para las reglas de Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid).
Etiquetas:affects_outputs
,incompatible_change
--[no]legacy_external_runfiles
predeterminado: "true"-
Si es verdadero, compila bosques de 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 se configura, se guardarán los resultados temporales de GCC. Estos incluyen archivos .s (código de ensamblador), archivos .i (C procesado) y archivos .ii (C++ procesado).
Etiquetas:affects_outputs
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
- Se acumulan varios usos de
--action_env=<a 'name=value' assignment with an optional value part>
-
Especifica el conjunto de variables de entorno disponibles para las acciones con configuración de destino. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o 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 las opciones que se proporcionan para la misma variable, se aplica la más reciente, y se acumulan las opciones para diferentes variables.
Etiquetas:action_command_lines
--android_cpu=<a string>
predeterminado: "armeabi-v7a"-
La CPU objetivo de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- 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
,experimental
--[no]android_databinding_use_v3_4_args
predeterminado: "true"-
Usa Android Databinding v2 con el argumento 3.4.0. Esta marca no realiza ninguna acción.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--android_dynamic_mode=<off, default or fully>
predeterminado: "off"- determina si las dependencias de C++ de las reglas de Android se vincularán de forma dinámica cuando un cc_binary no cree una biblioteca compartida de forma explícita. “default” significa que Bazel elegirá si 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 modo principalmente estático.
Etiquetas:affects_outputs
,loading_and_analysis
- Valor predeterminado de
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
: "alfabético" -
Establece el orden de los manifiestos que se pasan a la combinación de manifiestos para los objetos binarios de Android. ALFABÉTICO significa que los manifiestos se ordenan por ruta de acceso relativa a execroot. ALPHABETICAL_BY_CONFIGURATION significa que los manifiestos se ordenan por rutas de acceso relativas al directorio de configuración dentro del directorio de salida. DEPENDENCY significa que los manifiestos se ordenan de modo que el manifiesto de cada biblioteca aparezca antes que los manifiestos de sus dependencias.
Etiquetas:action_command_lines
,execution
--[no]android_resource_shrinking
predeterminado: “false”-
Habilita la reducción de recursos para los APKs de android_binary que usan ProGuard.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]build_python_zip
predeterminado: “auto”-
Compila el archivo ZIP ejecutable de Python; activado en Windows, desactivado en otras plataformas.
Etiquetas:affects_outputs
- Se acumulan
--catalyst_cpus=<comma-separated list of options>
usos múltiples -
Es una lista de arquitecturas separadas por comas para las que se compilarán objetos binarios de Apple Catalyst.
Etiquetas:loses_incremental_state
,loading_and_analysis
--[no]collect_code_coverage
predeterminado: “false”-
Si se especifica, Bazel instrumentará el código (con instrumentación sin conexión siempre que sea posible) y recopilará información de cobertura durante las pruebas. Solo se verán afectados los destinos que coincidan con --instrumentation_filter. Por lo general, esta opción no debe especificarse directamente, sino que se debe usar el comando "bazel coverage".
Etiquetas:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] predeterminado: "fastbuild"-
Especifica el modo en el que se compilará el objeto binario. Valores: "fastbuild", "dbg", "opt".
Etiquetas:affects_outputs
,action_command_lines
- Se acumulan varios usos de
--conlyopt=<a string>
-
Opción adicional para pasar a gcc cuando se compilan archivos de origen C.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--copt=<a string>
- Opciones adicionales para pasar a gcc.
Etiquetas:action_command_lines
,affects_outputs
--cpu=<a string>
predeterminado: ""-
La CPU objetivo.
Etiquetas:changes_inputs
,affects_outputs
--cs_fdo_absolute_path=<a string>
predeterminado: Consulta la descripción-
Usa la información del perfil de CSFDO para optimizar la compilación. Especifica el nombre de la ruta de acceso absoluta del archivo ZIP que contiene el archivo de perfil, un archivo de perfil LLVM sin procesar o indexado.
Etiquetas:affects_outputs
--cs_fdo_instrument=<a string>
predeterminado: Consulta la descripción- Genera objetos binarios con instrumentación FDO sensible al contexto. Con el compilador Clang/LLVM, también acepta el nombre del directorio en el que se volcarán los archivos de perfil sin procesar durante el tiempo de ejecución.
Etiquetas:affects_outputs
- 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 varios usos de
--cxxopt=<a string>
-
Opción adicional para pasar a gcc cuando se compilan archivos de origen C++.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--define=<a 'name=value' assignment>
-
Cada opción --define especifica una asignación para una variable de compilación.
Etiquetas:changes_inputs
,affects_outputs
- Valor predeterminado de
--dynamic_mode=<off, default or fully>
: “predeterminado” - determina si los objetos binarios de C++ se vincularán de forma dinámica. "default" significa que Bazel elegirá si vincular de forma dinámica. "Completamente" significa que todas las bibliotecas se vincularán de forma dinámica. "Desactivado" significa que todas las bibliotecas se vincularán en modo principalmente estático.
Etiquetas:loading_and_analysis
,affects_outputs
--[no]enable_fdo_profile_absolute_path
predeterminado: "true"-
Si se configura, el uso de fdo_logical_profile_path generará un error.
Etiquetas:affects_outputs
--[no]enable_runfiles
predeterminado: “auto”-
Habilita el árbol de symlinks de runfiles. De forma predeterminada, está desactivado en Windows y en otras plataformas.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--experimental_action_listener=<a build target label>
- dejó de estar disponible y se reemplazó por aspectos. Usa action_listener para adjuntar una extra_action a las acciones de compilación existentes.
Etiquetas:execution
,experimental
- Valor predeterminado de
--[no]experimental_android_compress_java_resources
: "falso" -
Comprime recursos de Java en APKs
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_android_databinding_v2
predeterminado: "true"-
Usa Android Databinding v2. Esta marca no realiza ninguna acción.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_android_resource_shrinking
predeterminado: “false”-
Habilita la reducción de recursos para los APKs de android_binary que usan ProGuard.
Etiquetas:affects_outputs
,loading_and_analysis
- Valor predeterminado de
--[no]experimental_android_rewrite_dexes_with_rex
: "falso" -
Usa la herramienta rex para volver a escribir archivos dex.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_collect_code_coverage_for_generated_files
predeterminado: “false”-
Si se especifica, Bazel también generará información de cobertura recopilada para los archivos generados.
Etiquetas:affects_outputs
--experimental_objc_fastbuild_options=<comma-separated list of options>
predeterminado: "-O0,-DDEBUG=1"-
Usa estas cadenas como opciones del compilador de objc fastbuild.
Etiquetas:action_command_lines
--[no]experimental_omitfp
predeterminado: “false”-
Si es verdadero, usa libunwind para el desenredo de pila y compila con -fomit-frame-pointer y -fasynchronous-unwind-tables.
Etiquetas:action_command_lines
,affects_outputs
,experimental
--experimental_output_paths=<off, content or strip>
predeterminado: "off"-
Indica qué modelo usar para el lugar en el que las reglas del árbol de resultados escriben sus resultados, en particular para compilaciones multiplataforma o con varias configuraciones. Esta función es muy experimental. Consulta https://github.com/bazelbuild/bazel/issues/6526 para obtener más información. Las acciones de Starlark pueden habilitar la asignación de rutas de acceso agregando la clave "supports-path-mapping" al diccionario "execution_requirements".
Etiquetas:loses_incremental_state
,bazel_internal_configuration
,affects_outputs
,execution
- Se acumulan varios usos de
--experimental_override_name_platform_in_output_dir=<a 'label=value' assignment>
-
Cada entrada debe tener el formato etiqueta=valor, en el que etiqueta hace referencia a una plataforma y valores es el nombre abreviado que se desea usar en la ruta de salida. Solo se utiliza cuando --experimental_platform_in_output_dir es verdadero. Tiene la prioridad de nombres más alta.
Etiquetas:affects_outputs
,experimental
--[no]experimental_platform_in_output_dir
predeterminado: “false”-
Si es verdadero, se usa un nombre corto para la plataforma de destino en el nombre del directorio de salida en lugar de la CPU. El esquema exacto es experimental y está sujeto a cambios. 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 usará 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
,experimental
--[no]experimental_use_llvm_covmap
predeterminado: “false”-
Si se especifica, Bazel generará información del mapa de cobertura de llvm-cov en lugar de gcov cuando se habilite collect_code_coverage.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
- Valor predeterminado de
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic
: "true" -
Usa esta marca solo como parte de una estrategia de migración o prueba sugerida. Ten en cuenta que la heurística tiene deficiencias conocidas y se recomienda migrar a depender solo de --experimental_override_name_platform_in_output_dir.
Etiquetas:affects_outputs
,experimental
--fat_apk_cpu=<comma-separated set of options>
predeterminado: "armeabi-v7a"-
Si configuras esta opción, se habilitan los APKs multiarquitectura, que contienen objetos binarios nativos para todas las arquitecturas de destino especificadas, p.ej., --fat_apk_cpu=x86,armeabi-v7a. Si se especifica esta marca, se ignora --android_cpu para las dependencias de las reglas android_binary.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Valor predeterminado de
--[no]fat_apk_hwasan
: "falso" -
Indica si se deben crear divisiones HWASAN.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Valor predeterminado de
--fdo_instrument=<a string>
: ver descripción -
Genera ejecutables con la instrumentación de FDO. Con el compilador Clang/LLVM, también acepta el nombre del directorio en el que se volcarán los archivos de perfil sin procesar durante el tiempo de ejecución.
Etiquetas:affects_outputs
--fdo_optimize=<a string>
predeterminado: Consulta la descripción-
Usa la información del perfil de FDO para optimizar la compilación. Especifica el nombre de un archivo ZIP que contenga un árbol de archivos .gcda, un archivo afdo que contenga un perfil automático o un archivo de perfil LLVM. Esta marca también acepta archivos especificados como etiquetas (p.ej., "//foo/bar:file.afdo"; es posible que debas agregar una directiva "exports_files" al paquete correspondiente) y etiquetas que apuntan a destinos "fdo_profile". Esta marca se reemplazará por la regla `fdo_profile`.
Etiquetas:affects_outputs
--fdo_prefetch_hints=<a build target label>
predeterminado: Consulta la descripción-
Usa sugerencias de carga previa de caché.
Etiquetas:affects_outputs
- Valor predeterminado de
--fdo_profile=<a build target label>
: ver descripción -
Es el fdo_profile que representa el perfil que se usará para la optimización.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--features=<a string>
-
Las funciones determinadas se habilitarán o inhabilitarán de forma predeterminada para los destinos compilados en la configuración de destino. Si especificas -<feature>, se inhabilitará la función. Los atributos negativos siempre anulan los positivos. Consulta también --host_features.
Etiquetas:changes_inputs
,affects_outputs
--[no]force_pic
predeterminado: “false”-
Si está habilitada, todas las compilaciones de C++ producen código independiente de la posición ("-fPIC"), las vinculaciones prefieren las bibliotecas compiladas previamente de PIC en lugar de las bibliotecas que no son de PIC, y las vinculaciones producen ejecutables independientes de la posición ("-pie").
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan varios usos de
--host_action_env=<a 'name=value' assignment with an optional value part>
-
Especifica el conjunto de variables de entorno disponibles para las acciones con configuraciones de ejecución. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o bien por el par nombre=valor, que establece el valor independientemente del entorno de invocación. Esta opción se puede utilizar varias veces; en el caso de las opciones que se brindan para la misma variable, se acumulan las últimas ganancias, las opciones para diferentes variables.
Etiquetas:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
predeterminado: "opt"-
Especifica el modo en el que se compilarán las herramientas que se usan durante la compilación. Valores: “fastbuild”, “dbg”, “opt”.
Etiquetas:affects_outputs
,action_command_lines
- Se acumulan varios usos de
--host_conlyopt=<a string>
-
Es una opción adicional para pasar al compilador C cuando se compilan archivos de origen C (pero no C++) en las configuraciones de ejecución.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--host_copt=<a string>
-
Opciones adicionales para pasar al compilador C para herramientas compiladas en las configuraciones de ejecución.
Etiquetas:action_command_lines
,affects_outputs
--host_cpu=<a string>
predeterminado: ""-
La CPU del host.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan
--host_cxxopt=<a string>
usos múltiples -
Opciones adicionales para pasar al compilador de C++ para herramientas compiladas en las configuraciones de ejecución.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--host_features=<a string>
-
Las funciones determinadas se habilitarán o inhabilitarán de forma predeterminada para los destinos compilados en la configuración de ejecución. Si especificas -<feature>, se inhabilitará la función. Los atributos negativos siempre anulan los positivos.
Etiquetas:changes_inputs
,affects_outputs
--host_force_python=<PY2 or PY3>
predeterminado: Consulta la descripción-
Anula la versión de Python para la configuración de ejecución. Puede ser “PY2” o “PY3”.
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan varios usos de
--host_linkopt=<a string>
-
Es una opción adicional para pasar al vinculador cuando se vinculen herramientas en las configuraciones de ejecución.
Etiquetas:action_command_lines
,affects_outputs
- Valor predeterminado de
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima compatible de macOS para los destinos de host. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan varios usos de
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
-
Opciones adicionales para pasar de forma selectiva al compilador C/C++ cuando se compilan ciertos archivos en las configuraciones de ejecución. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. En el ejemplo anterior, regex_filter significa una lista de patrones de inclusión y exclusión de expresiones regulares (consulta también --instrumentation_filter). option_1 a option_n significa opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe estar entre comillas con una barra diagonal inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos de gcc de todos los archivos cc en //foo/, excepto bar.cc.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--host_swiftcopt=<a string>
-
Opciones adicionales para pasar a swiftc para herramientas de ejecución.
Etiquetas:action_command_lines
,affects_outputs
- Valor predeterminado de
--[no]incompatible_auto_exec_groups
: "falso" -
Cuando se habilita, se crea automáticamente un grupo de ejecución para cada cadena de herramientas que usa una regla. Para que esto funcione, la regla debe especificar el parámetro "toolchain" en sus acciones. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/17134.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_merge_genfiles_directory
predeterminado: "true"-
Si el valor es verdadero, el directorio genfiles se pliega en el directorio bin.
Etiquetas:affects_outputs
,incompatible_change
- Valor predeterminado de
--[no]incompatible_use_host_features
: "true" -
Si es verdadero, usa --features solo para la configuración de destino y --host_features para la configuración de ejecución.
Etiquetas:changes_inputs
,affects_outputs
,incompatible_change
--[no]instrument_test_targets
predeterminado: “false”-
Cuando la cobertura está habilitada, especifica si se deben considerar las reglas de prueba de instrumentación. Cuando se establece, se instrumentan las reglas de prueba que incluye --instrumentation_filter. De lo contrario, las reglas de prueba siempre se excluyen de la instrumentación de cobertura.
Etiquetas:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
predeterminado: "-/javatests[/:],-/test/java[/:]"-
Cuando la cobertura esté habilitada, solo se instrumentarán las reglas con nombres incluidos en el filtro basado en regex especificado. En su lugar, se excluyen las reglas con el prefijo “-”. Ten en cuenta que solo se instrumentan las reglas que no son de prueba, a menos que se habilite --instrument_test_targets.
Etiquetas:affects_outputs
- Valor predeterminado de
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima de iOS compatible con dispositivos y simuladores de destino. Si no se especifica, usa "ios_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan varios usos de
--ios_multi_cpus=<comma-separated list of options>
-
Es una lista de arquitecturas separadas por comas con las que se compila una ios_application. El resultado es un binario universal que contiene todas las arquitecturas especificadas.
Etiquetas:loses_incremental_state
,loading_and_analysis
--[no]legacy_whole_archive
predeterminado: "true"-
Deja de estar disponible y se reemplaza por --incompatible_remove_legacy_whole_archive (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener más información). Cuando está activado, usa --whole-archive para las reglas cc_binary que tienen linkshared=True y linkstatic=True o “-static” en linkopts. Esto es solo para la retrocompatibilidad. Una mejor alternativa es usar alwayslink=1 cuando sea necesario.
Etiquetas:action_command_lines
,affects_outputs
,deprecated
- Se acumulan varios usos de
--linkopt=<a string>
-
Es una opción adicional para pasar a gcc durante la vinculación.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--ltobackendopt=<a string>
-
Opción adicional para pasar al paso de backend de LTO (en --features=thin_lto).
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--ltoindexopt=<a string>
-
Opción adicional para pasar al paso de indexación de LTO (en --features=thin_lto).
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--macos_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para compilar objetos binarios de Apple macOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Versión mínima compatible de macOS para destinos. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
--memprof_profile=<a build target label>
predeterminado: Consulta la descripción-
Usar el perfil de memprof.
Etiquetas:affects_outputs
--[no]objc_debug_with_GLIBCXX
predeterminado: “false”-
Si se configura y el modo de compilación está establecido en "dbg", define GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC y GLIBCPP_CONCEPT_CHECKS.
Etiquetas:action_command_lines
--[no]objc_enable_binary_stripping
predeterminado: “false”-
Determina si se deben borrar símbolos y códigos no entregados 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 varios usos de
--objccopt=<a string>
-
Opciones adicionales para pasar a gcc cuando se compilan archivos de origen Objective-C/C++.
Etiquetas:action_command_lines
- Se acumulan
--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 a gcc cuando se compilan ciertos archivos. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. En la que regex_filter representa una lista de patrones de expresiones regulares para incluir y excluir (consulta también --instrumentation_filter). option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe estar entre comillas con una barra diagonal inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos de gcc de todos los archivos cc en //foo/, excepto bar.cc.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
-
Opciones adicionales para pasar de forma selectiva al backend de LTO (en --features=thin_lto) cuando se compilan ciertos objetos de backend. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. En el ejemplo anterior, regex_filter significa una lista de patrones de inclusión y exclusión de expresiones regulares. De opción_1 a option_n significa opciones de línea de comandos arbitrarias. 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
,affects_outputs
- Valor predeterminado de
--platform_suffix=<a string>
: ver descripción -
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas:loses_incremental_state
,affects_outputs
,loading_and_analysis
--propeller_optimize=<a build target label>
predeterminado: Consulta la descripción-
Usa la información del perfil de Propeller para optimizar el destino de compilación.Un perfil de Propeller debe constar de al menos uno de dos archivos: un perfil de cc y un perfil de ld. Esta marca acepta una etiqueta de compilación que debe hacer referencia a los archivos de entrada del perfil de Propeller. Por ejemplo, el archivo BUILD que define la etiqueta, en a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)Es posible que se deba agregar una directiva exports_files al paquete correspondiente para que Bazel pueda ver estos archivos. La opción se debe usar de la siguiente manera: --propeller_optimize=//a/b:propeller_profile
Etiquetas:action_command_lines
,affects_outputs
--propeller_optimize_absolute_cc_profile=<a string>
predeterminado: Consulta la descripción-
Nombre de ruta de acceso absoluta del archivo cc_profile para compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
predeterminado: Consulta la descripción-
Es el nombre de ruta de acceso absoluto del archivo ld_profile para las compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
--run_under=<a prefix in front of command>
predeterminado: Consulta la descripción-
Prefijo para insertar antes de los ejecutables de los comandos "test" y "run". Si el valor es "foo -bar" y la línea de comandos de ejecución es "test_binary -baz", la línea de comandos final es "foo -bar test_binary -baz".Esto también puede ser una etiqueta para un destino ejecutable. Algunos ejemplos son: "valgrind", "strace", "strace -c", "valgrind --quiet --num-callers=20", "//package:target", "//package:target --options".
Etiquetas:action_command_lines
-
Si es verdadero, las bibliotecas nativas que contienen funcionalidad idéntica se compartirán entre diferentes destinos.
Etiquetas:loading_and_analysis
,affects_outputs
--[no]stamp
predeterminado: “false”-
Marca los objetos binarios con la fecha, el nombre de usuario, el nombre de host, la información del espacio de trabajo, etcétera.
Etiquetas:affects_outputs
- Valor predeterminado de
--strip=<always, sometimes or never>
: “sometimes” - especifica si se deben quitar los objetos binarios y las bibliotecas compartidas (con "-Wl,--strip-debug"). El valor predeterminado de "sometimes" significa quitar si --compilation_mode=fastbuild.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--stripopt=<a string>
-
Opciones adicionales para pasar a la eliminación cuando se genera un objeto binario "<name>.stripped".
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--swiftcopt=<a string>
-
Opciones adicionales para pasar a la compilación con 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
,loading_and_analysis
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Versión mínima de tvOS compatible para dispositivos y simuladores de destino. Si no se especifica, se usa "tvos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan varios usos de
--visionos_cpus=<comma-separated list of options>
-
Es una lista separada por comas de las arquitecturas para las que se compilarán los objetos binarios de Apple visionOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Se acumulan varios usos de
--watchos_cpus=<comma-separated list of options>
-
Es una lista separada por comas de las arquitecturas para las que se compilarán los objetos binarios de Apple watchOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Versión mínima compatible de watchOS para los simuladores y dispositivos de destino. Si no se especifica, se usa "watchos_sdk_version".
Etiquetas:loses_incremental_state
--xbinary_fdo=<a build target label>
predeterminado: Consulta la descripción-
Usa la información del perfil de XbinaryFDO para optimizar la compilación. Especifica el nombre del perfil de multibinario predeterminado. Cuando la opción se usa junto con --fdo_instrument/--fdo_optimize/--fdo_profile, esas opciones siempre prevalecerán como si xbinary_fdo nunca se especificara.
Etiquetas:affects_outputs
- Opciones que afectan la rigurosidad con la que Bazel aplica entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
--auto_cpu_environment_group=<a build target label>
predeterminado: ""-
Declara el environment_group que se usará para asignar automáticamente los valores de CPU a los valores de target_environment.
Etiquetas:changes_inputs
,loading_and_analysis
,experimental
- Valor predeterminado de
--[no]check_licenses
: "falso" -
Verifica que las restricciones de licencias que imponen los paquetes dependientes no entren en conflicto con los modos de distribución de los destinos que se compilan. De forma predeterminada, las licencias no están marcadas.
Etiquetas:build_file_semantics
--[no]check_visibility
predeterminado: "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" -
Determina si se debe expandir la sintaxis del código de bytes de Java 8 antes de la conversión a DEX.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]desugar_java8_libs
predeterminado: “false”-
Indica si se deben incluir bibliotecas Java 8 compatibles en apps para dispositivos heredados.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Valor predeterminado de
--[no]enforce_constraints
: "true" -
Verifica los entornos con los que es compatible cada objetivo y, luego, informa errores si alguno tiene dependencias que no admiten los mismos entornos.
Etiquetas:build_file_semantics
- Valor predeterminado de
--[no]experimental_check_desugar_deps
: "true" -
Determina si se debe volver a verificar la expansión correcta a nivel binario de Android.
Etiquetas:eagerness_to_exit
,loading_and_analysis
,experimental
--experimental_import_deps_checking=<off, warning or error>
predeterminado: “OFF”-
Cuando está habilitada, verifica si las dependencias de una aar_import están completas. Esta aplicación forzosa puede interrumpir la compilación o generar advertencias.
Etiquetas:loading_and_analysis
--experimental_one_version_enforcement=<off, warning or error>
predeterminado: “OFF”-
Cuando está habilitada, se aplica la regla de que una regla java_binary no puede contener más de una versión del mismo archivo de clase en la ruta de acceso a clases. Esta aplicación forzosa puede interrumpir la compilación o generar advertencias.
Etiquetas:loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
predeterminado: "predeterminado"-
Si es verdadero, verifica que un destino de Java declare explícitamente todos los destinos utilizados directamente como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files
predeterminado: “false”-
Si se habilita, verifica solo prueba para los destinos de requisitos previos que son archivos de salida. Para ello, busca la regla de generación solo de prueba. Esto coincide con la verificación de visibilidad.
Etiquetas:build_file_semantics
,incompatible_change
- Valor predeterminado de
--[no]incompatible_check_visibility_for_toolchains
: "falso" -
Si está habilitada, la verificación de visibilidad también se aplica a las implementaciones de la cadena de herramientas.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_disable_native_android_rules
predeterminado: “false”-
Si se habilita, se inhabilita el uso directo de las reglas nativas de Android. Usa las reglas de Starlark para Android en https://github.com/bazelbuild/rules_android
Etiquetas:eagerness_to_exit
,incompatible_change
- Valor predeterminado de
--[no]incompatible_disable_native_apple_binary_rule
: "falso" -
Sin operación. Se mantiene aquí para la retrocompatibilidad.
Etiquetas:eagerness_to_exit
,incompatible_change
- Valor predeterminado de
--[no]incompatible_python_disable_py2
: "true" -
Si es verdadero, usar la configuración de Python 2 provocará un error. Esto incluye python_version=PY2, srcs_version=PY2 y srcs_version=PY2ONLY. Consulta https://github.com/bazelbuild/bazel/issues/15684 para obtener más información.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_validate_top_level_header_inclusions
predeterminado: "true"-
Si es verdadero, Bazel también validará las inclusiones de encabezados de directorio de nivel superior (consulta https://github.com/bazelbuild/bazel/issues/10047 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]one_version_enforcement_on_java_tests
predeterminado: "true"-
Cuando está habilitado y experimental_one_version_enforcement se establece en un valor que no sea NONE, se aplica una versión en los destinos java_test. Esta marca se puede inhabilitar para mejorar el rendimiento de las pruebas incrementales a costa de perder posibles incumplimientos de una versión.
Etiquetas:loading_and_analysis
--python_native_rules_allowlist=<a build target label>
predeterminado: Consulta la descripción-
Es una lista de entidades permitidas (objetivo de package_group) que se usará cuando se aplique --incompatible_python_disallow_native_rules.
Etiquetas:loading_and_analysis
--[no]strict_filesets
predeterminado: “false”-
Si esta opción está habilitada, los conjuntos de archivos que cruzan los límites de los paquetes se informan como errores.
Etiquetas:build_file_semantics
,eagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default>
predeterminado: "error"-
A menos que esté DESACTIVADA, comprueba que un objetivo proto_library declare de forma explícita todos los objetivos usados directamente como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
--strict_public_imports=<off, warn, error, strict or default>
predeterminado: "off"-
A menos que esté desactivado, comprueba que un objetivo de proto_library declare de forma explícita todos los objetivos que se usan en "import public" como exportados.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
--[no]strict_system_includes
predeterminado: “false”-
Si es verdadero, también se deben declarar los encabezados que se encuentran en el sistema incluyen rutas de acceso (-isystem).
Etiquetas:loading_and_analysis
,eagerness_to_exit
- Se acumulan varios usos de
--target_environment=<a build target label>
-
Declara el entorno de destino de esta compilación. Debe ser una referencia de etiqueta a una regla de "entorno". Si se especifican, todos los objetivos de nivel superior deben ser compatibles con este entorno.
Etiquetas:changes_inputs
- Opciones que afectan los resultados de la firma de una compilación:
--apk_signing_method=<v1, v2, v1_v2 or v4>
predeterminado: “v1_v2”-
Implementación que se usará para firmar APKs
Etiquetas:action_command_lines
,affects_outputs
,loading_and_analysis
--[no]device_debug_entitlements
predeterminado: "true"-
Si se establece y el modo de compilación no es "opt", las apps de objc incluirán derechos de depuración cuando se firmen.
Etiquetas:changes_inputs
--ios_signing_cert_name=<a string>
predeterminado: Consulta la descripción- : Es el nombre del certificado que se usará para la firma de iOS. Si no se establece, se usará el perfil de aprovisionamiento. Puede ser la preferencia de identidad del llavero del certificado o (subcadena) del nombre de pila 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 Starlark o la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility
predeterminado: “false”-
Si incompatible_enforce_config_setting_visibility=false, esto es una operación no realizada. De lo contrario, si esta marca es falsa, cualquier config_setting sin un atributo de visibilidad explícito es //visibility:public. Si esta marca es verdadera, config_setting sigue la misma lógica de visibilidad que todas las demás reglas. Consulta https://github.com/bazelbuild/bazel/issues/12933.
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]incompatible_disallow_legacy_py_provider
: "true" -
No se realizará ninguna acción, se quitará pronto.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_sdk_frameworks_attributes
predeterminado: “false”-
Si es verdadero, no se permiten los atributos sdk_frameworks y weak_sdk_frameworks en objc_library y objc_import.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
predeterminado: "true"-
Si es verdadero, aplica las restricciones de visibilidad de config_setting. Si es falso, todos los config_setting son visibles para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_objc_alwayslink_by_default
predeterminado: “false”-
Si es verdadero, establece el valor predeterminado como verdadero para los atributos alwayslink en objc_library y objc_import.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_python_disallow_native_rules
predeterminado: “false”-
Cuando es verdadero, se produce un error cuando se usan las reglas py_* integradas. En su lugar, se deben usar las reglas rule_python. Consulta https://github.com/bazelbuild/bazel/issues/17773 para obtener más información y las instrucciones de migración.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones que rigen el comportamiento del entorno de prueba o del ejecutor de pruebas:
- Valor predeterminado de
--[no]allow_analysis_failures
: "falso" -
Si es verdadero, una falla de análisis de un objetivo de regla genera la propagación del objetivo de una instancia de AnalysisFailureInfo que contiene la descripción del error, en lugar de generar una falla de compilación.
Etiquetas:loading_and_analysis
,experimental
- Valor predeterminado de
--analysis_testing_deps_limit=<an integer>
: "2000" -
Establece la cantidad máxima de dependencias transitivas a través de un atributo de regla con una transición de configuración for_analysis_testing. Si se supera este límite, se mostrará un error de regla.
Etiquetas:loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure
predeterminado: “false”-
Si es verdadero, las fallas de la acción de dex2oat causarán que la compilación falle en lugar de ejecutar dex2oat durante el tiempo de ejecución de la prueba.
Etiquetas:loading_and_analysis
,experimental
- 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 predeterminados para las pruebas. El formato esperado es <resource>=<value>. Si se especifica un único número positivo como <value>, se anularán los recursos predeterminados para todos los tamaños de prueba. Si se especifican 4 números separados por comas, estos anularán 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, seguidos de forma opcional por [-|*]<float> (p. ej., memory=HOST_RAM*.1,HOST_RAM*.2,HOST_RAM*.3,HOST_RAM*.4). Los recursos de prueba predeterminados que especifica esta marca se anulan con los recursos explícitos que se especifican en las etiquetas.
- 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
,experimental
- Valor predeterminado de
--[no]ios_memleaks
: "falso" -
Habilita la verificación de fugas de memoria en los destinos de ios_test.
Etiquetas:action_command_lines
--ios_simulator_device=<a string>
predeterminado: Consulta la descripción-
Es el dispositivo que se simula cuando se ejecuta una aplicación para iOS en el simulador, p.ej., "iPhone 6". Para obtener una lista de dispositivos, ejecuta 'xcrun simctl list devicetypes' en la máquina en la que se ejecutará el simulador.
Etiquetas:test_runner
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Es la versión de iOS que se ejecutará en el simulador durante la ejecución o las pruebas. Esto se ignora para las reglas ios_test si se especifica un dispositivo de destino en la regla.
Etiquetas:test_runner
- Se acumulan varios usos de
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
- Especifica la cantidad de veces que se ejecutará cada prueba. Si alguno de esos intentos falla por algún motivo, se considera que toda la prueba falló. Por lo general, el valor especificado es solo un número entero. Ejemplo: --runs_per_test=3 ejecutará todas las pruebas 3 veces. Sintaxis alternativa: regex_filter@runs_per_test. En la que runs_per_test representa un valor entero y regex_filter representa una lista de patrones de expresiones regulares para incluir y excluir (consulta también --instrumentation_filter). Ejemplo: --runs_per_test=//foo/.*,-//foo/bar/.*@3 ejecuta todas las pruebas en //foo/ excepto las que se encuentran en foo/bar tres veces. Esta opción se puede aprobar varias veces. El argumento pasado más recientemente que coincida tiene prioridad. Si no hay coincidencias, la prueba solo se ejecuta una vez.
- Se acumulan varios usos de
--test_env=<a 'name=value' assignment with an optional value part>
-
Especifica variables de entorno adicionales que se insertarán en el entorno del ejecutor de pruebas. Las variables se pueden especificar por nombre, en cuyo caso su valor se leerá del entorno del cliente de Bazel, o bien por el par nombre=valor. Esta opción se puede usar varias veces para especificar varias variables. Solo lo usa el comando “bazel test”.
Etiquetas:test_runner
- Valor predeterminado de
--test_timeout=<a single integer or comma-separated list of 4 integers>
: "-1" - Anula los valores predeterminados de tiempo de espera de prueba para los tiempos de espera de 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 las pruebas no declaradas se archivarán en un archivo ZIP.
Etiquetas:test_runner
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--repo=<a string>
-
Solo vende el repositorio especificado, que puede ser "@apparent_repo_name" o "@@canonical_repo_name". Esta opción se puede establecer varias veces.
Etiquetas:changes_inputs
- Opciones que activan optimizaciones del tiempo de compilación:
- Valor predeterminado de
--[no]experimental_filter_library_jar_with_program_jar
: "falso" -
Filtra el ProgramJar de ProGuard para quitar las clases que también estén presentes en el LibraryJar.
Etiquetas:action_command_lines
--[no]experimental_inmemory_dotd_files
predeterminado: "true"-
Si se habilita esta opción, 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
,experimental
- Valor predeterminado de
--[no]experimental_inmemory_jdeps_files
: "true" -
Si está habilitado, los archivos de dependencia (.jdeps) generados a partir de compilaciones de Java se pasarán en la memoria directamente desde los nodos de compilación remotos en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_objc_include_scanning
predeterminado: “false”-
Indica si se debe incluir el análisis de C/C++ objetivo.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
- Valor predeterminado de
--[no]experimental_retain_test_configuration_across_testonly
: "falso" -
Cuando se habilita, --trim_test_configuration no recortará la configuración de prueba de las reglas marcadas como testonly=1. Esto se hace para reducir los problemas de conflicto de acciones cuando las reglas que no son de prueba dependen de las reglas de cc_test. No tiene efecto si --trim_test_configuration es falso.
Etiquetas:loading_and_analysis
,loses_incremental_state
--[no]experimental_starlark_cc_import
predeterminado: “false”-
Si está habilitada, se puede usar la versión de Starlark de cc_import.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_unsupported_and_brittle_include_scanning
predeterminado: “false”-
Determina si se deben limitar las entradas 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 interrumpir las compilaciones porque el escáner de inclusión no implementa por completo la semántica del preprocesador C. En particular, no comprende las directivas #include dinámicas y omite la lógica condicional del preprocesador. Úsala bajo tu propia responsabilidad. Se cerrarán todos los problemas relacionados con esta marca que se hayan presentado.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
--[no]incremental_dexing
predeterminado: "true"-
Realiza la mayor parte del trabajo de dexing por separado para cada archivo JAR.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]objc_use_dotd_pruning
predeterminado: "true"-
Si se establece, los archivos .d emitidos por clang se usarán para podar el conjunto de entradas que se pasan a las compilaciones de objc.
Etiquetas:changes_inputs
,loading_and_analysis
--[no]process_headers_in_dependencies
predeterminado: “false”-
Cuando compilas un destino //a:a, procesa los encabezados en todos los destinos de los que depende //a:a (si el procesamiento de encabezados está habilitado para la cadena de herramientas).
Etiquetas:execution
--[no]trim_test_configuration
predeterminado: "true"-
Cuando se habilita, se borran las opciones relacionadas con las pruebas debajo del nivel superior de la compilación. Cuando esta marca está activa, las pruebas no se pueden compilar como dependencias de reglas que no son de prueba, pero los cambios en las opciones relacionadas con pruebas no harán que estas reglas se vuelvan a analizar.
Etiquetas:loading_and_analysis
,loses_incremental_state
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Valor predeterminado de
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: “-.*”. -
Imprime información de depuración durante la resolución de la cadena de herramientas. La marca toma una regex, que se compara con los tipos de cadena de herramientas y los objetivos específicos para ver cuál depurar. Se pueden separar varias regex con comas y, luego, cada una se verifica por separado. Nota: El resultado de esta marca es muy complejo y es probable que solo sea útil para expertos en la resolución de cadenas de herramientas.
Etiquetas:terminal_output
- Son opciones que especifican o alteran una entrada genérica en un comando de Bazel que no pertenece a otras categorías.:
- Se acumulan
--flag_alias=<a 'name=value' flag alias>
usos múltiples -
Establece un nombre abreviado para una marca de Starlark. Toma un solo par clave-valor en el formato "<clave>=<valor>" como argumento.
Etiquetas:changes_inputs
--[no]incompatible_default_to_explicit_init_py
predeterminado: “false”-
Esta marca cambia el comportamiento predeterminado para que los archivos __init__.py ya no se creen automáticamente en los archivos de ejecución de los destinos de Python. Específicamente, cuando un objetivo py_binary o py_test tiene legacy_create_init establecido en "auto" (el valor predeterminado), se considera falso solo si se establece esta marca. Consulta https://github.com/bazelbuild/bazel/issues/10076.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_py2_outputs_are_suffixed
predeterminado: "true"-
Si es verdadero, los destinos compilados en la configuración de Python 2 aparecerán en una raíz de salida que 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 destinos de Python 3 en lugar de Python 2. Si habilitas esta opción, también se recomienda habilitar `--incompatible_py3_is_default`.
Etiquetas:affects_outputs
,incompatible_change
- Valor predeterminado de
--[no]incompatible_py3_is_default
: "true" -
Si es verdadero, los destinos "py_binary" y "py_test" que no establezcan su atributo "python_version" (o "default_python_version") usarán PY3 de forma predeterminada en lugar de PY2. Si configuras esta marca, también se recomienda establecer `--incompatible_py2_outputs_are_suffixed`.
Etiquetas:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_use_python_toolchains
predeterminado: "true"-
Si se establece como verdadero, las reglas ejecutables de Python nativas usarán el entorno de ejecución de Python especificado por la cadena de herramientas de Python, en lugar del entorno de ejecución que proporcionan las marcas heredadas, como --python_top.
Etiquetas:loading_and_analysis
,incompatible_change
--python_version=<PY2 or PY3>
predeterminado: Consulta la descripción-
Es el modo de versión principal de Python, ya sea "PY2" o "PY3". Ten en cuenta que esto se anula con los destinos "py_binary" y "py_test" (incluso si no especifican una versión de forma explícita), por lo que, por lo general, no hay muchos motivos para proporcionar esta marca.
Etiquetas:loading_and_analysis
,affects_outputs
- Opciones misceláneas que no se clasifican de otra manera:
--[no]cache_test_results
[-t
] predeterminada: "automática"- Si se establece en “auto”, Bazel vuelve a ejecutar una prueba solo si se cumplen las siguientes condiciones: (1) Bazel detecta cambios en la prueba o sus dependencias, (2) la prueba está marcada como externa, (3) se solicitaron varias ejecuciones de prueba con --runs_per_test o(4) la prueba falló anteriormente. Si se establece como "yes", Bazel almacena 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.
- Se acumulan
--deleted_packages=<comma-separated list of package names>
usos múltiples - Es una lista separada por comas de nombres de paquetes que el sistema de compilación considerará inexistentes, incluso si son visibles en algún lugar de la ruta de acceso del paquete. Usa esta opción cuando borres un subpaquete "x/y" de un paquete existente "x". Por ejemplo, después de borrar x/y/BUILD en tu cliente, es posible que el sistema de compilación se queje si encuentra una etiqueta "//x:y/z" si otra entrada de package_path aún la proporciona. Especificar --deleted_packages x/y evita este problema.
--[no]experimental_cancel_concurrent_tests
predeterminado: “false”-
Si es verdadero, Blaze cancelará las pruebas que se ejecutan de forma simultánea en la primera ejecución correcta. Esto solo es útil en combinación con --runs_per_test_detects_flakes.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_fetch_all_coverage_outputs
predeterminado: “false”-
Si es verdadero, Bazel recuperará todo el directorio de datos de cobertura para cada prueba durante una ejecución de cobertura.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_generate_llvm_lcov
predeterminado: “false”-
Si es verdadero, la cobertura de clang generará un informe LCOV.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_j2objc_header_map
predeterminado: "true"- Determina si se debe generar un mapa de encabezados de J2ObjC en paralelo con la transpilación de J2ObjC.
- 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"- Permite rutas de clase reducidas para compilaciones de Java.
--[no]experimental_limit_android_lint_to_android_constrained_java
predeterminado: “false”-
Limita --experimental_run_android_lint_on_java_rules a las bibliotecas compatibles con Android.
Etiquetas:affects_outputs
--[no]experimental_run_android_lint_on_java_rules
predeterminado: “false”-
Determina si se deben validar las fuentes java_*.
Etiquetas:affects_outputs
--[no]explicit_java_test_deps
predeterminado: “false”- Especifica de forma explícita una dependencia a JUnit o Hamcrest en un java_test en lugar de obtenerla accidentalmente de las dependencias de TestRunner. Por el momento, solo funciona para Bazel.
- Valor predeterminado de
--[no]fetch
: "true" - Permite que el comando recupere dependencias externas. Si se establece como falso, el comando usará cualquier versión almacenada en caché de la dependencia y, si no existe ninguna, el comando fallará.
--host_java_launcher=<a build target label>
predeterminado: Consulta la descripción- Es el selector de Java que usan las herramientas que se ejecutan durante una compilación.
- Se acumulan varios usos de
--host_javacopt=<a string>
- Opciones adicionales para pasar a javac cuando se compilan herramientas que se ejecutan durante una compilación.
- Se acumulan varios usos de
--host_jvmopt=<a string>
- Opciones adicionales para pasar a la VM de Java cuando se compilan herramientas que se ejecutan durante la compilación. Estas se agregarán a las opciones de inicio de la VM de cada destino java_binary.
--[no]incompatible_check_sharding_support
predeterminado: "true"-
Si es verdadero, Bazel fallará en una prueba fragmentada si el ejecutor de pruebas no indica que admite el fragmentación tocando el archivo en la ruta de acceso en TEST_SHARD_STATUS_FILE. Si es falso, un ejecutor de pruebas que no admita la fragmentación hará que todas las pruebas se ejecuten en cada fragmento.
Etiquetas:incompatible_change
--[no]incompatible_exclusive_test_sandboxed
predeterminado: "true"-
Si es verdadero, las pruebas exclusivas se ejecutarán con la estrategia de zona de pruebas. Agrega la etiqueta "local" para forzar que se ejecute una prueba exclusiva de forma local.
Etiquetas:incompatible_change
- 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, de esta manera, se puede evitar la caché entre usuarios si se usa una caché compartida.
Etiquetas:loading_and_analysis
,incompatible_change
- Se acumulan
--j2objc_translation_flags=<comma-separated list of options>
usos múltiples - : Opciones adicionales para pasar a la herramienta J2ObjC.
--java_debug
-
Hace que la máquina virtual de Java de una prueba de Java espere una conexión de un depurador compatible con JDWP (como jdb) antes de iniciar la prueba. Implica -test_output=streamed.
Se expande a:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
--[no]java_deps
predeterminado: "true"- Genera información de dependencia (por ahora, el classpath del tiempo de compilación) por destino de Java.
--[no]java_header_compilation
predeterminado: "true"- Compila ijars directamente desde la fuente.
--java_language_version=<a string>
predeterminado: ""- La versión del lenguaje Java
--java_launcher=<a build target label>
predeterminado: Consulta la descripción- Es el selector de Java que se usará cuando se compilen objetos binarios de Java. Si esta marca se establece en la cadena vacía, se usa el selector de JDK. El atributo "launcher" anula esta marca.
--java_runtime_version=<a string>
predeterminado: "local_jdk"- La versión del entorno de ejecución de Java
- Se acumulan varios usos de
--javacopt=<a string>
- Opciones adicionales para pasar a javac.
- Se acumulan
--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.
--legacy_main_dex_list_generator=<a build target label>
predeterminado: Consulta la descripción- especifica un objeto binario que se usará para generar la lista de clases que deben estar en el archivo DEX principal cuando se compila el multidex heredado.
--optimizing_dexer=<a build target label>
predeterminado: Consulta la descripción- Especifica un objeto binario para usar y realizar la conversión a Dex sin fragmentación.
--package_path=<colon-separated list of options>
predeterminado: “%workspace%”- Una lista separada por dos puntos de dónde buscar paquetes. Los elementos que comienzan con "%workspace%" son relativos al lugar de trabajo que los contiene. Si se omite o está vacío, el valor predeterminado es el resultado de “bazel info default-package-path”.
- Se acumulan
--plugin=<a build target label>
usos múltiples - Plug-ins 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 usará para quitar el código cuando se compila un objeto binario de Java.
--proto_compiler=<a build target label>
predeterminado: “@bazel_tools//tools/proto:protoc”-
Etiqueta del proto-compiler.
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
predeterminado: "@bazel_tools//tools/proto:cc_toolchain"-
Etiqueta de proto_lang_toolchain(), que describe cómo compilar protos de C++
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
predeterminado: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"-
Etiqueta de proto_lang_toolchain() que describe cómo compilar protos j2objc
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
predeterminado: "@bazel_tools//tools/proto:java_toolchain"-
Etiqueta de proto_lang_toolchain(), que describe cómo compilar protos de Java
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
valor predeterminado: "@bazel_tools//tools/proto:javalite_toolchain"-
Etiqueta de proto_lang_toolchain(), que describe cómo compilar protos de JavaLite
Etiquetas:affects_outputs
,loading_and_analysis
- Se acumulan
--protocopt=<a string>
usos múltiples -
Opciones adicionales para pasar al compilador de protobuf.
Etiquetas:affects_outputs
--[no]runs_per_test_detects_flakes
predeterminado: “false”- Si es verdadero, cualquier fragmento en el que se transfiera al menos una ejecución o intento y al menos una ejecución o intento fallido obtendrá el estado FLAKY.
--shell_executable=<a path>
predeterminado: Consulta la descripción-
Es la ruta de acceso absoluta al shell ejecutable para que lo use Bazel. Si no se establece, pero la variable de entorno BAZEL_SH se establece en la primera invocación de Bazel (que inicia un servidor de Bazel), Bazel la usará. Si no se establece ninguno, Bazel usa una ruta de acceso predeterminada fija según el sistema operativo en el que se ejecuta (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, todos los demás: /bin/bash). Ten en cuenta que usar un shell que no sea compatible con bash puede generar fallas de compilación o de tiempo de ejecución de los objetos binarios generados.
Etiquetas:loading_and_analysis
--[no]show_loading_progress
predeterminado: "true"- Si está habilitado, hace que Bazel imprima mensajes de “Carga del paquete:”.
- Se acumulan varios usos de
--test_arg=<a string>
- Especifica opciones y argumentos adicionales que se deben pasar al ejecutable de prueba. Se puede usar varias veces para especificar varios argumentos. Si se ejecutan varias pruebas, cada una recibirá argumentos idénticos. Solo lo usa el comando “bazel test”.
--test_filter=<a string>
predeterminado: Consulta la descripción- : Especifica un filtro para reenviar al framework de pruebas. Se usa para limitar las pruebas que se ejecutan. Ten en cuenta que esto no afecta los destinos que se compilan.
--test_result_expiration=<an integer>
predeterminado: “-1”- Esta opción dejó de estar disponible y no tiene efecto.
--[no]test_runner_fail_fast
predeterminado: “false”- Reenvía la opción de falla rápida al ejecutor de pruebas. El ejecutor de pruebas debe detener la ejecución en la primera falla.
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>
predeterminado: "explicit"- Especifica la estrategia para la fragmentación de pruebas. Para ello, usa la opción "explícito" para que solo use la fragmentación si el atributo de COMPILACIÓN "shard_count" está presente. "disabled" para nunca usar el fragmentación de prueba. "forced=k" para aplicar fragmentos "k" para pruebas, independientemente del atributo BUILD "shard_count".
- Valor predeterminado de
--tool_java_language_version=<a string>
: "" - La versión del lenguaje Java que se usa para ejecutar las herramientas necesarias durante una compilación
--tool_java_runtime_version=<a string>
predeterminado: "remotejdk_11"- La versión del entorno de ejecución de Java que se usa para ejecutar herramientas durante la compilación
--[no]use_ijars
predeterminado: "true"- Si está habilitada, esta opción hace que la compilación de Java use archivos JAR de interfaz. Esto generará una compilación incremental más rápida, pero los mensajes de error pueden ser diferentes.
Opciones de versión
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
-
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]experimental_repository_cache_hardlinks
: "falso" -
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, los repositorios externos pueden funcionar en máquinas más lentas de lo esperado por el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
- Valor predeterminado de
--[no]incompatible_disable_native_repo_rules
: "falso" -
Si es falso, se pueden usar reglas de repositorio nativas en WORKSPACE. De lo contrario, se deben usar reglas de repositorio de Starlark. Las reglas de repositorio nativo incluyen local_repository, new_local_repository, local_config_platform, android_sdk_repository y android_ndk_repository.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché. De lo contrario, se usa el valor predeterminado de '<output_user_root>/cache/repos/v1'.
Etiquetas:bazel_internal_configuration
--[no]repository_disable_download
predeterminado: “false”-
Si se establece, no se permite la descarga con ctx.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no 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 la compilación:
--gc_thrashing_threshold=<an integer in 0-100 range>
predeterminado: "100"-
Es el porcentaje de espacio ocupado (de 0 a 100) por encima del cual GcThrashingDetector considera los eventos de presión de memoria en función de sus límites (--gc_thrashing_limits). Si se establece en 100, se inhabilita GcThrashingDetector.
Etiquetas:host_machine_resource_optimizations
- Son opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
- Valor predeterminado de
--[no]gnu_format
: "falso" -
Si se establece, escribe la versión en stdout con las convenciones que se describen en los estándares de GNU.
Etiquetas:affects_outputs
,execution
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Se especificaron las versiones del módulo con el formato `<module1>@<version1>,<module2>@<version2>` que se permitirán en el gráfico de dependencias resuelto incluso si se declaran como eliminadas en el registro del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Comprueba la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "advertencia" -
Verifica si las dependencias directas de "bazel_dep" declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivarla a un error de resolución.
Etiquetas:loading_and_analysis
- 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 dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
predeterminado: “update”- especifica cómo usar el archivo de bloqueo y si se debe usar o no. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "refresh" para actualizar adicionalmente la información mutable (versiones eliminadas y módulos anteriores faltantes) de los registros remotos de vez en cuando, "error" para usar el archivo bloqueado, pero arrojar un error si no está actualizado, o "off" para no leer ni escribir en el archivo de bloqueo.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
- Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso proporcionada es una ruta de acceso absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta de acceso relativa, se hará referencia al directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace". Si la ruta de acceso determinada está vacía, quita las anulaciones anteriores.
- Se acumulan varios usos de
--registry=<a string>
-
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los anteriores.
Etiquetas:changes_inputs
--vendor_dir=<a path>
predeterminado: Consulta la descripción-
Especifica el directorio que debe contener 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 haga que Bazel falle con un error de OOM. Cada límite se especifica como <period>:<count>, en el que period es una duración y count es un número entero positivo. Si más del porcentaje --gc_thrashing_threshold del espacio a perpetuidad (heap de generación anterior) permanece ocupado después de <count> GC completas consecutivas en <period>, se activa un error de OOM. Se pueden especificar varios límites separados por comas.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de 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; en efecto ilimitado. Cero significa que los eventos de GC completos nunca activarán las bajadas. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC completo y se supere ese umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "2147483647"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produce un evento de GC menor, descartará el estado temporal innecesario de Skyframe hasta esta cantidad de veces por invocación. El valor predeterminado es Integer.MAX_VALUE; es ilimitado. Cero significa que los eventos de GC menores nunca activarán las bajadas. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando se produzca un evento de GC menor y se supere ese umbral de porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: “85”-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es de al menos este límite, descartará el estado temporal innecesario de Skyframe. Si ajustas este parámetro, es posible que puedas mitigar el impacto del tiempo de ejecución de la fragmentación de GC, cuando esta se produce (i) por el uso de memoria de este estado temporal y (ii) es más costoso que reconstituir el estado cuando sea necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--experimental_command_profile=<cpu, wall, alloc or lock>
predeterminado: Consulta la descripción- Registra un perfil de la grabadora de vuelos de Java durante la ejecución del comando. Se debe proporcionar como argumento uno de los tipos de eventos de generación de perfiles admitidos (cpu, wall, alloc o lock). El perfil se escribe en un archivo que lleva el nombre del tipo de evento en el directorio de base de salida. La sintaxis y la semántica de esta marca pueden cambiar en el futuro para admitir tipos de perfiles o formatos de salida adicionales. Úsala bajo tu propio riesgo.
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
- Opciones que especifican o alteran una entrada genérica a un comando de Bazel que no se incluye en otras categorías:
- Valor predeterminado de
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno que debe coincidir y otro para usar como URL sustituta, con referencias inversas a partir de "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URL.
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
predeterminado: “auto”- El modo de subprocesos que se usará para la recuperación del repositorio. Si se establece en "desactivado", no se usa ningún subproceso de trabajo y la recuperación del repo está sujeta a reinicios. De lo contrario, usa un subproceso de trabajador virtual.
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
- Anula un repositorio con una ruta de acceso local en el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es una ruta de acceso absoluta, se usará tal como está. Si la ruta de acceso proporcionada es una ruta de acceso relativa, se relaciona con el directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace". Si la ruta de acceso determinada está vacía, quita las anulaciones anteriores.
Etiquetas de efecto de opción
unknown |
Esta opción tiene un efecto desconocido o no documentado. |
no_op |
Esta opción no tiene efecto literalmente. |
loses_incremental_state |
Cambiar el valor de esta opción puede provocar una pérdida significativa del estado incremental, lo que ralentiza las compilaciones. Es posible que se pierda el estado debido a un reinicio del servidor o a la invalidación de una gran parte del gráfico de dependencias. |
changes_inputs |
Esta opción cambia de forma activa las entradas que bazel considera para la compilación, como las restricciones del sistema de archivos, las versiones del repositorio y otras opciones. |
affects_outputs |
Esta opción afecta los resultados de bazel. Esta etiqueta es amplia de forma intencional, puede incluir efectos transitivos y no especifica el tipo de resultado que afecta. |
build_file_semantics |
Esta opción afecta la semántica de los archivos BUILD o .bzl. |
bazel_internal_configuration |
Esta opción afecta la configuración de la maquinaria interna de Bazel. Esta etiqueta, por sí sola, no significa que los artefactos de compilación se vean afectados. |
loading_and_analysis |
Esta opción afecta la carga y el análisis de dependencias, y la compilación del gráfico de dependencias. |
execution |
Esta opción afecta la fase de ejecución, como las opciones relacionadas con la zona de pruebas o la ejecución remota. |
host_machine_resource_optimizations |
Esta opción activa una optimización que puede ser específica de la máquina y no se garantiza que funcione en todas las máquinas. La optimización podría incluir una compensación con otros aspectos del rendimiento, como el costo de la memoria o la CPU. |
eagerness_to_exit |
Esta opción cambia la rapidez con la que bazel saldrá de una falla, en la que existe una opción entre continuar a pesar de la falla y finalizar la invocación. |
bazel_monitoring |
Esta opción se usa para supervisar el comportamiento y el rendimiento de bazel. |
terminal_output |
Esta opción afecta el resultado de la terminal de bazel. |
action_command_lines |
Esta opción cambia los argumentos de línea de comandos de una o más acciones de compilación. |
test_runner |
Esta opción cambia el entorno de testrunner de la compilación. |
Etiquetas de metadatos de opciones
experimental |
Esta opción activa una función experimental sin garantías de funcionalidad. |
incompatible_change |
Esta opción activa un cambio rotundo. Usa esta opción para probar tu nivel de preparación para la migración o obtener acceso anticipado a la nueva función. |
deprecated |
Esta opción está obsoleta. Es posible que la función a la que afecta quede obsoleta o que se prefiera otro método para proporcionar la información. |