bazel [<startup options>] <command> [<args>]
bazel [<startup options>] <command> [<args>] -- [<target patterns>]
Sintaxis de las 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]
Las opciones de tres estados suelen establecerse en automático de forma predeterminada y se pueden habilitar de forma forzada 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 proporcionados y consulta el gráfico de acción. |
build |
Compila los destinos especificados. |
canonicalize-flags |
Normaliza 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 las configuraciones. |
dump |
Volca el estado interno del proceso del servidor de Bazel. |
fetch |
Recupera los repositorios externos que son requisitos previos para los destinos. |
help |
Imprime ayuda para los comandos o el índice. |
info |
Muestra información del tiempo 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 espacio de trabajo |
test |
Compila y ejecuta los destinos 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 cambio, sale.
Etiquetas:affects_outputs
,loses_incremental_state
--[no]batch
predeterminado: "false"-
Si se configura, Bazel se ejecutará solo como un proceso cliente sin un servidor, en lugar de en el modo cliente/servidor estándar. Este método está en desuso y se quitará. Si deseas evitar que queden servidores inactivos, te recomendamos que apagues el servidor de forma explícita.
Etiquetas:loses_incremental_state
,bazel_internal_configuration
,deprecated
--[no]batch_cpu_scheduling
predeterminado: "false"-
Solo en Linux; usa la programación de CPU por lotes para Blaze. Esta política es útil para cargas de trabajo no interactivas, pero que no desean reducir su valor de nice. Consulta “man 2 sched_setscheduler”. Si es falso, Bazel no realiza una llamada al sistema.
Etiquetas:host_machine_resource_optimizations
--bazelrc=<path>
valor predeterminado: consulta la descripción-
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 resulta útil para inhabilitar la búsqueda de un archivo rc del usuario, p.ej., en compilaciones de lanzamiento.
Esta opción también se puede especificar varias veces.
p.ej., con `--bazelrc=x.rc --bazelrc=y.rc --bazelrc=/dev/null --bazelrc=z.rc`, 1) se leen x.rc e y.rc.
2) Se ignora z.rc debido a la prioridad de /dev/null.
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 la línea de comandos siempre reemplazarán cualquier opción en bazelrc.
Etiquetas:changes_inputs
--[no]block_for_lock
predeterminado: "true"-
Cuando se pasa --noblock_for_lock, Bazel no espera a que se complete un comando en ejecución, sino que sale de inmediato.
Etiquetas:eagerness_to_exit
--[no]client_debug
predeterminado: "false"-
Si es verdadero, se registra la información de depuración del cliente en stderr. Cambiar esta opción no reiniciará el servidor.
Etiquetas:affects_outputs
,bazel_monitoring
--connect_timeout_secs=<an integer>
predeterminado: "30"-
Cantidad de tiempo que espera el cliente en cada intento de conexión al servidor
Etiquetas:bazel_internal_configuration
--digest_function=<hash function>
valor predeterminado: consulta la descripción-
Función hash que se usará cuando se calculen resúmenes de archivos.
Etiquetas:loses_incremental_state
,bazel_internal_configuration
--experimental_cgroup_parent=<path>
valor predeterminado: consulta la descripción-
Es el cgroup en el que se iniciará el servidor de Bazel como una ruta de acceso absoluta. El proceso del servidor se iniciará en el cgroup especificado para cada controlador compatible. Por ejemplo, si el valor de esta marca es /build/bazel y los controladores de CPU y memoria están montados, respectivamente, en /sys/fs/cgroup/cpu y /sys/fs/cgroup/memory, el servidor se iniciará en los cgroups /sys/fs/cgroup/cpu/build/bazel y /sys/fs/cgroup/memory/build/bazel.No se producirá un error si el cgroup especificado no se puede escribir para uno o más de los controladores. Esta opción no tiene ningún efecto en las plataformas que no admiten cgroups.
Etiquetas:bazel_monitoring
,execution
--failure_detail_out=<path>
valor predeterminado: consulta la descripción-
Si se configura, especifica una ubicación para escribir un mensaje failure_detail de protobuf si el servidor experimenta una falla y no puede informarla a través de gRPC, como es normal. De lo contrario, la ubicación será ${OUTPUT_BASE}/failure_detail.rawproto.
Etiquetas:affects_outputs
,loses_incremental_state
--[no]home_rc
predeterminado: "true"-
Indica si se debe buscar el archivo .bazelrc principal en $HOME/.bazelrc
Etiquetas:changes_inputs
--[no]idle_server_tasks
predeterminado: "true"-
Ejecuta System.gc() cuando el servidor esté inactivo
Etiquetas:loses_incremental_state
,host_machine_resource_optimizations
--[no]ignore_all_rc_files
predeterminado: "false"-
Inhabilita todos los archivos .rc, independientemente de los valores de otras marcas que modifican el archivo .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 con el mejor esfuerzo posible a través de la llamada al sistema sys_ioprio_set. El 0 es la prioridad más alta y el 7, la más baja. El programador anticipatorio solo puede cumplir con prioridades de hasta 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>
valor 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: "default"-
Establece la clase de servicio de QoS del servidor de Bazel cuando se ejecuta en macOS. Esta marca no tiene efecto en las demás plataformas, pero se admite para garantizar que los archivos rc se puedan compartir entre ellas sin cambios. Los valores posibles son: user-interactive, user-initiated, default, utility y background.
Etiquetas:host_machine_resource_optimizations
--max_idle_secs=<integer>
predeterminado: "10800"-
Cantidad de segundos que el servidor de compilación esperará en estado de inactividad antes de apagarse. El valor cero significa que el servidor nunca se apagará. Esta opción solo se lee al iniciar el servidor, por lo que cambiarla no hará que se reinicie.
Etiquetas:eagerness_to_exit
,loses_incremental_state
--output_base=<path>
valor predeterminado: consulta la descripción-
Si se configura, especifica la ubicación de salida en la que se escribirá toda la salida 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 invocación a la siguiente de Bazel para este valor, es probable que inicies un servidor de Bazel nuevo y adicional. Bazel inicia exactamente un servidor por cada 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 este modo, ejecutar varias compilaciones para el mismo cliente en la misma máquina de forma simultánea. Consulta "bazel help shutdown" para saber cómo detener un servidor de Bazel.
Etiquetas:affects_outputs
,loses_incremental_state
--output_user_root=<path>
valor predeterminado: consulta la descripción-
Es el directorio específico del usuario en el que se escriben todos los resultados de la compilación. De forma predeterminada, es una función de $USER, pero, si se especifica una constante, los resultados de la compilación se pueden compartir entre los usuarios que colaboran.
Etiquetas:affects_outputs
,loses_incremental_state
--[no]preemptible
predeterminado: "false"-
Si es verdadero, el comando se puede interrumpir si se inicia otro comando.
Etiquetas:eagerness_to_exit
--[no]quiet
predeterminado: "false"-
Si es verdadero, no se emiten mensajes informativos en la consola, solo errores. Cambiar esta opción no reiniciará el servidor.
Etiquetas:affects_outputs
,bazel_monitoring
--server_jvm_out=<path>
valor predeterminado: consulta la descripción-
Ubicación en la que se escribirá el resultado de la JVM del servidor. Si no se configura, 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 establece max_idle_secs y el servidor de compilación ha estado inactivo durante un tiempo, apaga el servidor cuando el sistema tenga poca RAM libre. Solo en Linux.
Etiquetas:eagerness_to_exit
,loses_incremental_state
--[no]system_rc
predeterminado: "true"-
Indica si se debe buscar el archivo bazelrc de todo el sistema.
Etiquetas:changes_inputs
--[no]unlimit_coredumps
predeterminado: "false"-
Aumenta el límite flexible de volcado de memoria al límite fijo para que los volcados de memoria del servidor (incluida la JVM) y del cliente sean posibles en condiciones comunes. Agrega esta marca a tu archivo bazelrc una vez y olvídate de ella para que obtengas volcados de memoria cuando realmente 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 detectar cambios locales en lugar de analizar cada archivo en busca de cambios.
Etiquetas:deprecated
--[no]windows_enable_symlinks
predeterminado: "false"-
Si es verdadero, se crearán vínculos simbólicos reales en Windows en lugar de copiar archivos. Requiere que se habilite el modo de desarrollador de Windows y Windows 10, versión 1703 o posterior.
Etiquetas:bazel_internal_configuration
--[no]workspace_rc
predeterminado: "true"-
Indica si se debe buscar el archivo bazelrc del espacio de trabajo en $workspace/.bazelrc
Etiquetas:changes_inputs
- Opciones varias, no clasificadas de otra manera.:
- Se acumulan los usos múltiples de
--host_jvm_args=<jvm_arg>
- Son marcas para pasar a la JVM que ejecuta Blaze.
--host_jvm_debug
-
Opción conveniente para agregar algunas marcas de inicio de JVM adicionales, que hacen que la JVM espere durante el inicio hasta que te conectes desde un depurador compatible con JDWP (como Eclipse) al puerto 5005.
Se expande a:
--host_jvm_args=-Xdebug
--host_jvm_args=-Xrunjdwp:transport=dt_socket,server=y,address=5005
- Valor predeterminado de
--server_javabase=<jvm path>
: "" - 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:
- Se acumulan los usos múltiples 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 creará un vínculo físico al archivo en caso de acierto de caché, en lugar de copiarlo. Esto tiene como objetivo ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
predeterminado: "5"-
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 según este factor. De esta manera, los repositorios externos pueden funcionar en máquinas más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_connector_attempts=<an integer>
predeterminado: "8"-
Es la cantidad máxima de intentos para las descargas por HTTP.
Etiquetas:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
predeterminado: "0s"-
Es el tiempo de espera máximo para los reintentos de descarga por 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 http paralelas.
Etiquetas:bazel_internal_configuration
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Ajusta todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--[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 repositorios nativos incluyen local_repository, new_local_repository, local_config_platform y android_sdk_repository.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
valor predeterminado: consulta la descripción-
Especifica la ubicación de la caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Si se usa una cadena vacía como argumento, se 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 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 archivo ejecutable arbitrario que acceda a Internet.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de la compilación:
--experimental_ui_max_stdouterr_bytes=<an integer in (-1)-1073741819 range>
predeterminado: "1048576"-
Es el tamaño máximo de los archivos stdout / stderr que se imprimirán en la consola. El valor -1 implica que no hay límite.
Etiquetas:execution
--gc_thrashing_threshold=<an integer in 0-100 range>
valor predeterminado: "100"-
Porcentaje de espacio consolidado ocupado (0 a 100) por encima del cual GcThrashingDetector considera los eventos de presión de memoria en relación con sus límites (--gc_thrashing_limits). Si se establece en 100, se inhabilita GcThrashingDetector.
Tags:host_machine_resource_optimizations
- Opciones que configuran la cadena de herramientas que se usa para la ejecución de acciones:
--[no]incompatible_enable_proto_toolchain_resolution
predeterminado: "false"-
Si es verdadero, las reglas de lenguaje proto definen cadenas de herramientas desde el repositorio de protobuf.
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:
- Valor predeterminado de
--bep_maximum_open_remote_upload_files=<an integer>
: "-1" -
Es la cantidad máxima de archivos abiertos permitidos durante la carga de artefactos del BEP.
Etiquetas:affects_outputs
--remote_download_all
-
Descarga todos los resultados remotos en la máquina local. Esta marca es un alias de --remote_download_outputs=all.
Se expande a:
--remote_download_outputs=all
Etiquetas:affects_outputs
--remote_download_minimal
-
No descarga ningún resultado de compilación remota en la máquina local. Esta marca es un alias de --remote_download_outputs=minimal.
Se expande a:
--remote_download_outputs=minimal
Etiquetas:affects_outputs
--remote_download_outputs=<all, minimal or toplevel>
predeterminado: "toplevel"-
Si se configura como "mínimo", no se descargan los resultados de compilación remotos en la máquina local, excepto los que requieren las acciones locales. Si se configura como "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
- Valor predeterminado de
--remote_download_symlink_template=<a string>
: "" -
En lugar de descargar los resultados de compilación remota 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. Por ejemplo, estos vínculos simbólicos pueden apuntar a un sistema de archivos FUSE que carga objetos del CAS a pedido.
Etiquetas:affects_outputs
--remote_download_toplevel
-
Solo descarga los resultados remotos de los 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 los usos múltiples de
--repo_env=<a 'name=value' assignment with an optional value part>
-
Especifica variables de entorno adicionales que solo estarán disponibles para las reglas del repositorio. Ten en cuenta que las reglas del repositorio ven el entorno completo de todos modos, pero, de esta manera, la información de configuración 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 rigidez con la que Bazel aplica las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
--[no]check_bzl_visibility
predeterminado: "true"-
Si se inhabilita, los errores de visibilidad de carga de .bzl se degradan a advertencias.
Etiquetas:build_file_semantics
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]enable_bzlmod
predeterminado: "true"-
Si es verdadero, habilita el sistema de administración de dependencias de Bzlmod, que tiene prioridad sobre WORKSPACE. Consulta https://bazel.build/docs/bzlmod para obtener más información.
Etiquetas:loading_and_analysis
--[no]enable_workspace
predeterminado: "false"-
Si es verdadero, habilita el sistema WORKSPACE heredado para las dependencias externas. Consulta https://bazel.build/external/overview para obtener más información.
Etiquetas:loading_and_analysis
--[no]experimental_action_resource_set
predeterminado: "true"-
Si se establece en 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 de memoria y 1 CPU.
Etiquetas:execution
,build_file_semantics
,experimental
--[no]experimental_bzl_visibility
predeterminado: "true"-
Si está habilitado, agrega una función `visibility()` a la que los archivos .bzl pueden llamar durante la evaluación de nivel superior para establecer su visibilidad a los efectos de las instrucciones load().
Etiquetas:loading_and_analysis
,experimental
-
Si se establece como verdadero, los atributos de regla y los métodos de la API de Starlark necesarios para la regla cc_shared_library estarán disponibles.
Etiquetas:build_file_semantics
,loading_and_analysis
,experimental
--[no]experimental_cc_static_library
predeterminado: "false"-
Si se configura como verdadero, estarán disponibles los atributos de 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
--[no]experimental_disable_external_package
predeterminado: "false"-
Si se establece en verdadero, el paquete //external generado automáticamente ya no estará disponible. Bazel no podrá analizar el archivo "external/BUILD", pero los globs que lleguen a external/ desde el paquete sin nombre funcionarán.
Etiquetas:loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_dormant_deps
predeterminado: "false"-
Si se establece como verdadero, se permiten attr.label(materializer=), attr(for_dependency_resolution=), attr.dormant_label(), attr.dormant_label_list() y rule(for_dependency_resolution=).
Etiquetas:build_file_semantics
,experimental
--[no]experimental_enable_android_migration_apis
predeterminado: "false"-
Si se configura como verdadero, se habilitan las APIs necesarias para admitir la migración de Starlark de Android.
Etiquetas:build_file_semantics
--[no]experimental_enable_first_class_macros
predeterminado: "true"-
Si se establece en verdadero, se habilita la construcción de "macro()" para definir macros simbólicas.
Etiquetas:build_file_semantics
--[no]experimental_enable_scl_dialect
predeterminado: "true"-
Si se configura como verdadero, se pueden usar archivos .scl en las sentencias load().
Etiquetas:build_file_semantics
--[no]experimental_google_legacy_api
predeterminado: "false"-
Si se configura como verdadero, expone una serie de elementos experimentales de la API de compilación de Starlark relacionados con el código heredado de Google.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_isolated_extension_usages
predeterminado: "false"-
Si es verdadero, habilita el parámetro <code>isolate</code> en la función <a href="https://bazel.build/rules/lib/globals/module#use_extension"><code>use_extension</code></a>.
Etiquetas:loading_and_analysis
--[no]experimental_java_library_export
predeterminado: "false"-
Si está habilitado, el módulo experimental_java_library_export_do_not_use está disponible.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]experimental_platforms_api
predeterminado: "false"-
Si se establece como verdadero, habilita varias APIs de Starlark relacionadas con la plataforma que son útiles para la depuración.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repo_remote_exec
predeterminado: "false"-
Si se establece como verdadero, repository_rule adquiere 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 vínculos simbólicos al repositorio principal en la raíz de ejecución. Es decir, todos los repositorios son elementos secundarios directos del directorio $output_base/execution_root. Esto tiene el efecto secundario de liberar $output_base/execution_root/__main__/external para el directorio "external" real de nivel superior.
Etiquetas:action_command_lines
,bazel_internal_configuration
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_single_package_toolchain_binding
predeterminado: "false"-
Si está habilitada, es posible que la función register_toolchain no incluya patrones de destino que puedan hacer referencia a más de un paquete.
Etiquetas:loading_and_analysis
,incompatible_change
-
Si se establece como verdadero, las etiquetas se propagarán desde un destino a los requisitos de ejecución de las acciones; de lo contrario, no se propagarán. Consulta https://github.com/bazelbuild/bazel/issues/8830 para obtener más información.
Etiquetas:build_file_semantics
,experimental
--[no]incompatible_always_check_depset_elements
predeterminado: "true"-
Verifica la validez de los elementos agregados a los depsets en todos los constructores. Los elementos deben ser inmutables, pero, históricamente, el constructor depset(direct=…) olvidó realizar la verificación. Usa tuplas en lugar de listas en los elementos de depset. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/10313.
Etiquetas:build_file_semantics
,incompatible_change
--incompatible_autoload_externally=<comma-separated set of options>
default: "+@rules_python,+java_common,+JavaInfo,+JavaPluginInfo,ProguardSpecProvider,java_binary,java_import,java_library,java_plugin,java_test,java_runtime,java_toolchain,java_package_configuration,@com_google_protobuf,@rules_shell,+@rules_android"-
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. Esta marca está diseñada para 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 nueva definición canónica en un repositorio externo. Para un archivo BUILD, esto significa agregar implícitamente una sentencia load(). En el caso de un archivo .bzl, es una instrucción 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 forma rígida 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 la definición en un repositorio externo, así como un conjunto de repositorios con casos especiales que no se deben cargar automáticamente para evitar la creación de 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 sigue estando disponible.
Un elemento de lista de "foo" activa la carga automática como se indicó anteriormente, 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 sea inaccesible 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 un símbolo no se nombra en esta marca, seguirá funcionando con normalidad: no se realizará ninguna 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_libraries_to_link_getter
predeterminado: "true"-
Cuando es verdadero, Bazel ya no devuelve una lista de linking_context.libraries_to_link, sino que devuelve un depset.
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 (no se realiza ninguna operación en Bazel)
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_disable_starlark_host_transitions
predeterminado: "false"-
Si se establece como verdadero, los atributos de regla no pueden establecer "cfg = "host"". En su lugar, las reglas deben establecer "cfg = "exec"".
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_disable_target_default_provider_fields
predeterminado: "false"-
Si se configura como verdadero, se inhabilita la capacidad de acceder a los proveedores en objetos "target" a través de la sintaxis de campos. En su lugar, usa la sintaxis de clave del 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 detalles.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_disable_target_provider_fields
predeterminado: "false"-
Si se establece como verdadero, se inhabilita la capacidad de utilizar el proveedor predeterminado a través de la sintaxis de campo. En su lugar, usa la sintaxis de clave del proveedor. Por ejemplo, en lugar de usar `ctx.attr.dep.files` para acceder a `files`, utiliza `ctx.attr.dep[DefaultInfo].files`. Consulta https://github.com/bazelbuild/bazel/issues/9014 para obtener más detalles.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_disallow_ctx_resolve_tools
predeterminado: "true"-
Si se establece como verdadero, la llamada a la API de ctx.resolve_tools obsoleta siempre falla. Los usos de esta API se deben reemplazar por un argumento ejecutable o de herramientas para ctx.actions.run o ctx.actions.run_shell.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_empty_glob
predeterminado: "true"-
Si se establece como verdadero, el valor predeterminado del argumento "allow_empty" de glob() es False.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_disallow_struct_provider_syntax
predeterminado: "true"-
Si se establece como verdadero, es posible que las funciones de implementación de reglas no devuelvan una struct. En su lugar, deben devolver una lista de instancias del proveedor.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_enable_deprecated_label_apis
predeterminado: "true"-
Si se habilita, se pueden usar ciertas APIs obsoletas (native.repository_name, Label.workspace_name, Label.relative).
Etiquetas:loading_and_analysis
--[no]incompatible_fail_on_unknown_attributes
predeterminado: "true"-
Si está habilitado, fallarán los objetivos que tengan atributos desconocidos establecidos en None.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_fix_package_group_reporoot_syntax
predeterminado: "true"-
En el atributo "packages" de package_group, cambia el significado del valor "//…" para que haga referencia a todos los paquetes del repositorio actual en lugar de a todos los paquetes de cualquier repositorio. Puedes usar el valor especial "public" en lugar de "//…" para obtener el comportamiento anterior. Esta marca requiere que también se habilite --incompatible_package_group_has_public_syntax.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_java_common_parameters
predeterminado: "true"-
Si se configura como verdadero, se quitarán 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á habilitado, las acciones registradas con ctx.actions.run y ctx.actions.run_shell con "env" y "use_default_shell_env = True" especificados usarán un entorno obtenido del entorno de shell predeterminado anulando con los valores pasados a "env". Si está inhabilitado, el valor de "env" se ignora por completo en este caso.
Etiquetas:loading_and_analysis
,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 configura, los archivos fuente (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: "true"-
Si es verdadero, los métodos en <code>repository_ctx</code> que reciben una etiqueta ya no supervisarán automáticamente el archivo bajo esa etiqueta para detectar cambios, incluso si <code>watch = "no"</code>, y <code>repository_ctx.path</code> ya no hace que se supervise la ruta devuelta. En su lugar, usa <code>repository_ctx.watch</code>.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_no_rule_outputs_param
predeterminado: "false"-
Si se configura como verdadero, inhabilita el parámetro "outputs" de la función "rule()" de Starlark.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_package_group_has_public_syntax
predeterminado: "true"-
En el atributo "packages" de package_group, permite escribir "public" o "private" para hacer referencia a todos los paquetes o a ninguno, respectivamente.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_require_linker_input_cc_api
predeterminado: "true"-
Si se configura como verdadero, la regla create_linking_context requerirá linker_inputs en lugar de libraries_to_link. Los métodos get antiguos de linking_context también se inhabilitarán y solo estarán disponibles los linker_inputs.
Etiquetas:build_file_semantics
,loading_and_analysis
,incompatible_change
--[no]incompatible_run_shell_command_string
predeterminado: "true"-
Si se establece como verdadero, el parámetro de comando de actions.run_shell solo aceptará cadenas.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_simplify_unconditional_selects_in_rule_attrs
predeterminado: "true"-
Si es verdadero, simplifica los atributos de regla configurables que solo contienen selecciones incondicionales. Por ejemplo, si ["a"] + select("//conditions:default", ["b"]) se asigna a un atributo de regla, se almacena como ["a", "b"]. Esta opción no afecta los atributos de las macros simbólicas ni los valores predeterminados de los atributos.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_stop_exporting_build_file_path
predeterminado: "false"-
Si se establece como verdadero, ctx.build_file_path dejará de estar disponible. En su lugar, se puede usar ctx.label.package + "/BUILD".
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_stop_exporting_language_modules
predeterminado: "false"-
Si está habilitado, ciertos módulos específicos del idioma (como `cc_common`) no están disponibles en los archivos .bzl del usuario y solo se pueden llamar desde sus respectivos repositorios de reglas.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_top_level_aspects_require_providers
predeterminado: "true"-
Si se configura como verdadero, el aspecto de nivel superior respetará sus proveedores obligatorios y solo se ejecutará en los objetivos 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 es verdadero, Bazel convertirá la etiqueta @//foo:bar en @//foo:bar, en lugar de //foo:bar. Esto solo afecta el comportamiento de str(), el operador % y demás; 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 es verdadero, Bazel ya no permitirá usar cc_configure desde @bazel_tools. Consulta https://github.com/bazelbuild/bazel/issues/10134 para obtener detalles e instrucciones de migración.
Etiquetas:loading_and_analysis
,incompatible_change
--max_computation_steps=<a long integer>
predeterminado: "0"-
Es la cantidad máxima de pasos de cálculo de Starlark que puede ejecutar un archivo BUILD (cero significa que no hay límite).
Etiquetas:build_file_semantics
--nested_set_depth_limit=<an integer>
valor predeterminado: "3500"-
Es la profundidad máxima del gráfico interno de un depset (también conocido como NestedSet), por encima de la cual fallará el constructor de depset().
Etiquetas:loading_and_analysis
- Valor predeterminado de
--repositories_without_autoloads=<comma-separated set of options>
: "" -
Es una lista de repositorios adicionales (más allá de los codificados que conoce Bazel) en los que no se deben agregar cargas automáticas. Por lo general, debería contener repositorios de los que depende de forma transitiva un repositorio que se puede cargar automáticamente (y que, por lo tanto, puede crear un ciclo).
Etiquetas:loses_incremental_state
,build_file_semantics
,incompatible_change
- Opciones relacionadas con la salida y la semántica de Bzlmod:
- Se acumulan los usos múltiples de
--allow_yanked_versions=<a string>
-
Se especificaron las versiones del módulo en el formato "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran como retiradas en el registro del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones retiradas harán que falle la resolución. También puedes definir la versión anulada 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 problema 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: "warning"-
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 derivar el problema como 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 el archivo 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 el archivo de bloqueo. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "refresh" para actualizar también la información mutable (versiones retiradas y módulos que faltaban anteriormente) 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 los usos múltiples de
--override_module=<an equals-separated mapping of module name to path>
- Anula un módulo con una ruta local con el formato <nombre del módulo>=<ruta>. Si la ruta proporcionada es absoluta, se usará tal cual. Si la ruta proporcionada es relativa, será relativa al directorio de trabajo actual. Si la ruta de acceso proporcionada comienza con "%workspace%", es relativa a la raíz del espacio de trabajo, que es el resultado de "bazel info workspace". Si la ruta de acceso proporcionada está vacía, se quitarán los reemplazos anteriores.
- Se acumulan los usos múltiples 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: primero se buscarán los módulos en los registros anteriores y solo se recurrirá a los registros posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
--vendor_dir=<a path>
valor predeterminado: consulta la descripción-
Especifica el directorio que debe contener los repositorios externos en el 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>>
valor predeterminado: "1s:2,20s:3,1m:5"-
Límites que, si se alcanzan, hacen que GcThrashingDetector falle Bazel con un error de OOM. Cada límite se especifica como <período>:<recuento>, donde período es una duración y recuento es un número entero positivo. Si más del porcentaje de --gc_thrashing_threshold del espacio permanente (heap de generación anterior) permanece ocupado después de <count> GC completas consecutivas dentro de <period>, se activa un error de OOM. Se pueden especificar varios límites separados por comas.
Etiquetas:host_machine_resource_optimizations
--[no]heuristically_drop_nodes
predeterminado: "false"-
Si es verdadero, Blaze quitará los nodos FileState y DirectoryListingState después de que se completen los nodos File y DirectoryListing relacionados para ahorrar memoria. Esperamos que sea menos probable que se necesiten estos nodos nuevamente. Si es así, el programa los reevaluará.
Etiquetas:loses_incremental_state
--[no]incompatible_do_not_split_linking_cmdline
predeterminado: "true"-
Cuando es verdadero, Bazel ya no modifica las marcas de la 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
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
predeterminado: "10"-
Es una marca para la configuración avanzada del motor interno Skyframe de Bazel. Si Bazel detecta que el uso del porcentaje de memoria dinámica retenida supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC completo, descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. La configuración predeterminada es 10. El valor cero significa que los eventos de GC completa nunca activarán descartes. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando ocurra 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: "10"-
Es una marca para la configuración avanzada del motor interno Skyframe de Bazel. Si Bazel detecta que el uso del porcentaje de montón retenido supera el umbral establecido por --skyframe_high_water_mark_threshold, cuando se produzca un evento de GC menor, descartará el estado temporal innecesario de Skyframe, hasta esta cantidad de veces por invocación. La configuración predeterminada es 10. El valor cero significa que los eventos de GC menores nunca activarán las interrupciones. Si se alcanza el límite, el estado de Skyframe ya no se descartará cuando ocurra un evento de GC secundario 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 interno Skyframe de Bazel. Si Bazel detecta que el uso del porcentaje de montón retenido es al menos este umbral, descartará el estado temporal innecesario de Skyframe. Ajustar este parámetro puede permitirte mitigar el impacto del tiempo real de la fluctuación del GC, cuando esta se debe (i) al uso de memoria de este estado temporal y (ii) es más costosa que reconstituir el estado cuando se necesita.
Etiquetas:host_machine_resource_optimizations
--[no]track_incremental_state
predeterminado: "true"-
Si es falso, Blaze no conservará los datos que permitan la invalidación y la reevaluación en 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 como falso.
Etiquetas:loses_incremental_state
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]announce_rc
predeterminado: "false"-
Indica si se deben anunciar las opciones de rc.
Etiquetas:affects_outputs
--[no]attempt_to_print_relative_paths
predeterminado: "false"-
Cuando se imprime la parte de la ubicación de los mensajes, se intenta usar una ruta de acceso relativa al directorio del espacio de trabajo o a uno de los directorios especificados por --package_path.
Etiquetas:terminal_output
- Valor predeterminado de
--bes_backend=<a string>
: "" -
Especifica el extremo de backend del servicio de eventos de compilación (BES) en el formato [SCHEME://]HOST[:PORT]. La opción predeterminada es inhabilitar las cargas de BES. Los esquemas admitidos son grpc y grpcs (grpc con TLS habilitado). Si no se proporciona ningún esquema, Bazel supone que es grpcs.
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 anteriormente recibió eventos InvocationAttemptStarted y BuildEnqueued que coincidan con el evento de herramienta actual.
Etiquetas:affects_outputs
- Se acumulan los usos múltiples de
--bes_header=<a 'name=value' assignment>
-
Especifica un encabezado en formato NOMBRE=VALOR que se incluirá en las solicitudes de BES. Se pueden pasar varios encabezados especificando la marca varias veces. Los valores múltiples para el mismo nombre se convertirán en una lista separada por comas.
Etiquetas:affects_outputs
--bes_instance_name=<a string>
valor predeterminado: consulta la descripción-
Especifica el nombre de la instancia con la que el BES conservará el BEP subido. El valor predeterminado es nulo.
Etiquetas:affects_outputs
- Se acumulan los usos múltiples 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 none.
Etiquetas:affects_outputs
--[no]bes_lifecycle_events
predeterminado: "true"-
Especifica si se publicarán eventos de ciclo de vida de BES. (el valor predeterminado es "true").
Etiquetas:affects_outputs
--bes_oom_finish_upload_timeout=<An immutable length of time.>
predeterminado: "10 m"-
Especifica cuánto tiempo debe esperar Bazel a que se complete la carga de BES/BEP mientras se produce un error por falta de memoria. Esta marca garantiza la finalización cuando la JVM está realizando una recolección de basura excesiva y no puede avanzar en ningún subproceso del usuario.
Etiquetas:bazel_monitoring
--bes_outerr_buffer_size=<an integer>
predeterminado: "10240"-
Especifica el tamaño máximo de stdout o stderr que se almacenará en el búfer de BEP antes de que se informe como un evento de progreso. Las escrituras individuales se siguen registrando en un solo evento, incluso si son más grandes que el valor especificado hasta --bes_outerr_chunk_size.
Etiquetas:affects_outputs
--bes_outerr_chunk_size=<an integer>
predeterminado: "1048576"-
Especifica el tamaño máximo de stdout o stderr que se enviará a BEP en un solo mensaje.
Etiquetas:affects_outputs
--bes_proxy=<a string>
valor 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:/ruta/al/socket).
- Valor predeterminado de
--bes_results_url=<a string>
: "" -
Especifica la URL base en la que un usuario puede ver la información transmitida al backend del BES. Bazel enviará a la terminal la URL a la que se adjuntó el ID de invocación.
Etiquetas:terminal_output
- Se acumulan los usos múltiples 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_keywords. Está diseñado para los operadores del servicio de compilación que configuran --bes_lifecycle_events=false y que incluyen palabras clave cuando llaman a PublishLifecycleEvent. Los operadores de servicios de compilación que usan esta marca deben impedir 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 a que se complete la carga de BES/BEP después de que finalicen la compilación y las pruebas. Un tiempo de espera válido es un número natural seguido de una unidad: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). El valor predeterminado es "0", lo que significa que no hay tiempo de espera.
Etiquetas:affects_outputs
--bes_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>
predeterminado: "wait_for_upload_complete"-
Especifica si la carga del servicio de eventos de compilación debe bloquear la finalización de la compilación o finalizar la invocación de inmediato y completar la carga en segundo plano. Puede ser "wait_for_upload_complete" (predeterminado), "nowait_for_upload_complete" o "fully_async".
Etiquetas:eagerness_to_exit
- Valor predeterminado de
--build_event_binary_file=<a string>
: "" -
Si no está vacío, escribe una representación binaria delimitada por varint de la representación del protocolo de eventos de compilación en ese archivo. Esta opción implica --bes_upload_mode=wait_for_upload_complete.
Etiquetas:affects_outputs
--[no]build_event_binary_file_path_conversion
predeterminado: "true"-
Convierte las rutas de la representación del archivo binario del protocolo de eventos de compilación en URIs más válidos a nivel global siempre que sea posible. Si se inhabilita, siempre se usará el esquema de URI file://.
Etiquetas:affects_outputs
--build_event_binary_file_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>
predeterminado: "wait_for_upload_complete"-
Especifica si la carga del servicio de eventos de compilación para --build_event_binary_file debe bloquear la finalización de la compilación o finalizar la invocación de inmediato y completar la carga en segundo plano. Puede ser "wait_for_upload_complete" (predeterminado), "nowait_for_upload_complete" o "fully_async".
Etiquetas:eagerness_to_exit
- Valor predeterminado de
--build_event_json_file=<a string>
: "" -
Si no está vacío, escribe una serialización JSON del protocolo de eventos de compilación en ese archivo. Esta opción implica --bes_upload_mode=wait_for_upload_complete.
Etiquetas:affects_outputs
--[no]build_event_json_file_path_conversion
predeterminado: "true"-
Convierte las rutas de acceso en la representación del archivo JSON del protocolo de eventos de compilación en URIs más válidos a nivel global siempre que sea posible. Si esta opción está inhabilitada, 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 completar la carga en segundo plano. Puede ser "wait_for_upload_complete" (predeterminado), "nowait_for_upload_complete" o "fully_async".
Etiquetas:eagerness_to_exit
--build_event_max_named_set_of_file_entries=<an integer>
predeterminado: "5000"-
Es la cantidad máxima de entradas para un solo evento named_set_of_files. Se ignoran los valores inferiores a 2 y no se realiza ninguna división de eventos. Esto tiene como objetivo 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 el 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
- Valor predeterminado de
--build_event_text_file=<a string>
: "" -
Si no está vacío, escribe una representación textual del protocolo de eventos de compilación en ese archivo.
Etiquetas:affects_outputs
--[no]build_event_text_file_path_conversion
predeterminado: "true"-
Convierte las rutas de acceso en la representación de archivo de texto del protocolo de eventos de compilación en URIs más válidos a nivel global siempre que sea posible. Si esta opción está inhabilitada, siempre se usará el esquema de URI file://.
Etiquetas:affects_outputs
--build_event_text_file_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>
predeterminado: "wait_for_upload_complete"-
Especifica si la carga del servicio de eventos de compilación para --build_event_text_file debe bloquear la finalización de la compilación o finalizar la invocación de inmediato y completar la carga en segundo plano. Puede ser "wait_for_upload_complete" (predeterminado), "nowait_for_upload_complete" o "fully_async".
Etiquetas:eagerness_to_exit
- Valor predeterminado de
--build_event_upload_max_retries=<an integer>
: "4" -
Es la cantidad máxima de veces que Bazel debe reintentar subir un evento de compilación.
Etiquetas:bazel_internal_configuration
--[no]experimental_bep_target_summary
predeterminado: "false"- Indica si se publicarán eventos de TargetSummary.
--[no]experimental_build_event_expand_filesets
predeterminado: "false"-
Si es verdadero, expande los archivos Filesets 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 por completo los vínculos simbólicos relativos de Fileset en el BEP cuando se presentan los archivos de salida. Requiere --experimental_build_event_expand_filesets.
Etiquetas:affects_outputs
- Se acumulan los usos múltiples de
--experimental_build_event_output_group_mode=<an output group name followed by an OutputGroupFileMode, e.g. default=both>
-
Especifica cómo se representarán los archivos de un grupo de salida en los eventos BEP de TargetComplete/AspectComplete. Los valores son una asignación de un nombre de grupo de salida a uno de los siguientes: "NAMED_SET_OF_FILES_ONLY", "INLINE_ONLY" o "BOTH". El valor predeterminado es "NAMED_SET_OF_FILES_ONLY". Si se repite un grupo de salida, se usa el valor final que aparece. El valor predeterminado establece el modo de los artefactos de cobertura en BOTH: --experimental_build_event_output_group_mode=baseline.lcov=both
Etiquetas:affects_outputs
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
predeterminado: "1s"-
Es la demora inicial y mínima para los reintentos de retirada exponencial cuando falla la carga del BEP. (exponente: 1.6)
Etiquetas:bazel_internal_configuration
--experimental_build_event_upload_strategy=<a string>
valor 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 está habilitado, el generador de perfiles recopila el promedio de carga general del sistema.
Etiquetas:bazel_monitoring
--[no]experimental_collect_pressure_stall_indicators
predeterminado: "false"-
Si está habilitado, el profiler recopila los datos del PSI de Linux.
Etiquetas:bazel_monitoring
--[no]experimental_collect_resource_estimation
predeterminado: "false"-
Si está habilitado, el generador de perfiles recopila la estimación del uso de CPU y memoria para las acciones locales.
Etiquetas:bazel_monitoring
--[no]experimental_collect_skyframe_counts_in_profiler
predeterminado: "false"-
Si está habilitado, el generador de perfiles recopila los recuentos de SkyFunction en el gráfico de Skyframe a lo largo del tiempo para los tipos de funciones clave, como los destinos configurados y las ejecuciones de acciones. Es posible que se produzca una reducción del rendimiento, ya que se visita TODO el gráfico de Skyframe en cada unidad de tiempo de generación de perfiles. No uses esta marca con mediciones de rendimiento crítico.
Etiquetas:bazel_monitoring
--[no]experimental_collect_system_network_usage
predeterminado: "true"-
Si está habilitado, el generador de perfiles recopila el uso de la 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
--experimental_command_profile=<cpu, wall, alloc or lock>
valor predeterminado: consulta la descripción- Registra un perfil de Java Flight Recorder 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.
- Se acumulan los usos múltiples de
--experimental_profile_additional_tasks=<phase, action, discover_inputs, action_check, action_lock, action_update, action_complete, action_rewinding, 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, local_action_counts, 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, conflict_check, dynamic_lock, repository_fetch, repository_vendor or unknown>
-
Especifica tareas de perfil adicionales que se incluirán en el perfil.
Etiquetas:bazel_monitoring
--[no]experimental_profile_include_primary_output
predeterminado: "false"-
Incluye el atributo "out" adicional en los eventos de acción que contienen la ruta de ejecución a la salida principal de la acción.
Etiquetas:bazel_monitoring
--[no]experimental_profile_include_target_configuration
predeterminado: "false"-
Incluye el hash de configuración del objetivo en los datos del perfil JSON de los eventos de acción.
Etiquetas:bazel_monitoring
--[no]experimental_profile_include_target_label
predeterminado: "false"-
Incluye la etiqueta de destino en los datos del perfil JSON de los eventos de acción.
Etiquetas:bazel_monitoring
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: "false"- Controla el resultado de BEP ActionSummary y BuildGraphMetrics, lo que limita la cantidad de mnemónicos en ActionData y la cantidad de entradas que se informan en BuildGraphMetrics.AspectCount/RuleClassCount. De forma predeterminada, la cantidad de tipos se limita a los 20 principales, según la cantidad de acciones ejecutadas para ActionData y las instancias para RuleClass y Aspects. Si configuras esta opción, se escribirán estadísticas para todos los mnemónicos, las clases de reglas y los aspectos.
--[no]experimental_record_skyframe_metrics
predeterminado: "false"- Controla el resultado de BEP BuildGraphMetrics, incluidas las métricas de Skyframe costosas de calcular sobre Skykeys, RuleClasses y Aspects.Si esta marca se establece en falso, BuildGraphMetrics.rule_count y aspectfields no se propagarán en BEP.
--[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"-
Transmite las cargas de archivos de registro directamente al almacenamiento remoto en lugar de escribirlas en el disco.
Etiquetas:affects_outputs
--experimental_workspace_rules_log_file=<a path>
valor predeterminado: consulta la descripción- Registra ciertos eventos de las reglas de Workspace en este archivo como protos de WorkspaceEvent delimitados.
--[no]generate_json_trace_profile
predeterminado: "auto"-
Si está habilitado, Bazel genera un perfil de la compilación y escribe un perfil en formato JSON en un archivo de la base de salida. Carga el perfil en chrome://tracing para verlo. De forma predeterminada, Bazel escribe el perfil para todos los comandos y consultas similares a la compilación.
Etiquetas:bazel_monitoring
--[no]heap_dump_on_oom
predeterminado: "false"-
Indica si se debe generar manualmente un volcado de montón si se genera un error de memoria insuficiente (incluidos los errores de memoria insuficiente manuales debido a que se alcanzaron los límites de --gc_thrashing_limits). El volcado se escribirá en <output_base>/<invocation_id>.heapdump.hprof. Esta opción reemplaza de manera efectiva a -XX:+HeapDumpOnOutOfMemoryError, que no tiene efecto para los errores de OOM manuales.
Etiquetas:bazel_monitoring
--jvm_heap_histogram_internal_object_pattern=<a valid Java regular expression>
predeterminado: "jdk\.internal\.vm\.Filler.+"- Es una expresión regular para anular la lógica de coincidencia para la recopilación de memoria del montón de JVM de JDK21 y versiones posteriores. Dependemos de detalles volátiles de la implementación interna de GC de G1 para obtener una métrica de memoria limpia. Esta opción nos permite adaptarnos a los cambios en esa implementación interna sin tener que esperar una versión binaria. Se pasa a JDK Matcher.find().
--[no]legacy_important_outputs
predeterminado: "false"-
Úsalo para suprimir la generación del campo legacy important_outputs en el evento TargetComplete. Los important_outputs son necesarios para la integración de Bazel en ResultStore/BTX.
Etiquetas:affects_outputs
--logging=<0 <= an integer <= 6>
valor predeterminado: "3"-
Es el nivel de registro.
Etiquetas:affects_outputs
--memory_profile=<a path>
valor predeterminado: consulta la descripción-
Si se configura, escribe los datos de uso de memoria en el archivo especificado al final de las fases y el montón estable en el registro principal al final de la compilación.
Etiquetas:bazel_monitoring
--memory_profile_stable_heap_parameters=<integers, separated by a comma expected in pairs>
predeterminado: "1,0"-
Ajusta el cálculo del montón estable del perfil de memoria al final de la compilación. Debe ser una cantidad par de números enteros separados por comas. En cada par, el primer número entero es la cantidad de CG que se deben realizar. El segundo número entero de cada par es la cantidad de segundos que se deben esperar entre las CG. P. ej., 2,4,4,0 significaría 2 GC con una pausa de 4 s, seguidas de 4 GC con una pausa de cero segundos.
Etiquetas:bazel_monitoring
--profile=<a path>
valor predeterminado: consulta la descripción-
Si se configura, genera un perfil de Bazel y escribe datos en el archivo especificado. Usa bazel analyze-profile para analizar el perfil.
Etiquetas:bazel_monitoring
--profiles_to_retain=<an integer>
predeterminado: "5"-
Cantidad de perfiles que se conservarán en la base de salida. Si hay más perfiles que este número en la base de salida, se borran los más antiguos hasta que el total esté por debajo del límite.
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 la obtención de estadísticas del archivo). Si se habilita esta opción, el generador de perfiles registrará cada evento, lo que generará datos de generación de perfiles más precisos, pero un GRAN impacto en el rendimiento. La opción solo tiene efecto si también se usa --profile.
Etiquetas:bazel_monitoring
--[no]redirect_local_instrumentation_output_writes
predeterminado: "false"-
Si es verdadero y se admite, la salida de la instrumentación se redirecciona para que se escriba de forma local en una máquina diferente de la que ejecuta Bazel.
Etiquetas:bazel_monitoring
--remote_print_execution_messages=<failure, success or all>
predeterminado: "failure"-
Elige cuándo imprimir los mensajes de ejecución remota. Los valores válidos son "failure" para imprimir solo en caso de errores, "success" para imprimir solo en caso de éxito 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
- Valor predeterminado de
--starlark_cpu_profile=<a string>
: "" -
Escribe en el archivo especificado un perfil de pprof del uso de CPU de todos los subprocesos de Starlark.
Etiquetas:bazel_monitoring
- Valor predeterminado de
--tool_tag=<a string>
: "" -
Es el nombre de una herramienta para atribuir esta invocación de Bazel.
Etiquetas:affects_outputs
,bazel_monitoring
- Se acumulan los usos múltiples 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 de los predeterminados con los signos + o - al principio, o bien anular el conjunto predeterminado por completo con una asignación directa. El conjunto de tipos de eventos admitidos incluye INFO, DEBUG, ERROR y muchos más.
Etiquetas:terminal_output
- Opciones que especifican o alteran una entrada genérica para 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_circuit_breaker_strategy=<failure>
valor predeterminado: consulta la descripción-
Especifica la estrategia que usará el disyuntor. Las estrategias disponibles son "failure". Si el valor de la opción no es válido, el comportamiento es el mismo que si la opción no estuviera configurada.
Etiquetas:execution
--experimental_downloader_config=<a string>
valor predeterminado: consulta la descripción- Especifica un archivo para 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 la coincidencia y otro para usar como URL sustituta, con referencias inversas que comienzan con `$1`. Es posible que se proporcionen varias directivas `rewrite` para la misma URL y, en este caso, se devolverán varias URLs.
--[no]experimental_guard_against_concurrent_changes
predeterminado: "false"- Desactiva esta opción para inhabilitar la verificación de la hora de creación de los archivos de entrada de una acción antes de subirlos 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.
--experimental_remote_cache_compression_threshold=<an integer>
valor predeterminado: "100"- Es el tamaño mínimo de BLOB requerido para comprimir o descomprimir con zstd. No tiene efecto a menos que se establezca --remote_cache_compression.
--[no]experimental_remote_cache_lease_extension
predeterminado: "false"- Si se configura como verdadero, Bazel extenderá el arrendamiento de los resultados de las acciones remotas durante la compilación enviando llamadas a `FindMissingBlobs` periódicamente a la caché remota. La frecuencia se basa en el valor de `--experimental_remote_cache_ttl`.
--experimental_remote_cache_ttl=<An immutable length of time.>
predeterminado: "3h"-
Es el TTL mínimo garantizado de los BLOBs en la caché remota después de que se hace referencia a sus resúmenes recientemente, p.ej., por un ActionResult o FindMissingBlobs. Bazel realiza varias optimizaciones basadas en el TTL de los BLOB, p.ej., no llama a GetActionResult de forma repetida en una compilación incremental. El valor debe establecerse un poco menos que el TTL real, ya que hay una brecha entre el momento en que el servidor devuelve los resúmenes y el momento en que Bazel los recibe.
Etiquetas:execution
--experimental_remote_capture_corrupted_outputs=<a path>
valor predeterminado: consulta la descripción- Es la ruta de acceso a un directorio en el que se capturarán los resultados dañados.
--[no]experimental_remote_discard_merkle_trees
predeterminado: "true"- Si se configura como 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 calcularlos en caso de errores de caché remota y reintentos.
--experimental_remote_downloader=<a string>
valor predeterminado: consulta la descripción- Es el URI de un 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 ningún 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_downloader_propagate_credentials
predeterminado: "false"- Indica si se propagarán las credenciales de netrc y del auxiliar de credenciales al servidor de descarga remota. La implementación del servidor debe admitir el nuevo calificador `http_header_url:<url-index>:<header-key>`, en el que `<url-index>` es una posición basada en 0 de la URL dentro del campo `uris` de FetchBlobRequest. Los encabezados específicos de la URL deben tener prioridad sobre los encabezados globales.
--[no]experimental_remote_execution_keepalive
predeterminado: "false"- Indica si se debe usar keepalive para las llamadas de ejecución remota.
--experimental_remote_failure_rate_threshold=<an integer in 0-100 range>
predeterminado: "10"-
Establece la cantidad permitida de tasa de errores en porcentaje 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 se establece en 0, significa que no hay limitación.
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 del error 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 aciertos de la caché remota. La huella de 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 memoizar para mejorar la velocidad de verificación de aciertos de caché remota. Aunque la caché se reduce automáticamente según el control de referencias débiles de Java, pueden producirse errores de memoria insuficiente si se establece 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. El valor predeterminado es 1,000.
--experimental_remote_output_service=<a string>
valor predeterminado: consulta la 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 ningún esquema, Bazel usará grpcs de forma predeterminada. Especifica el esquema grpc:// o unix: para inhabilitar TLS.
- Valor predeterminado de
--experimental_remote_output_service_output_path_prefix=<a string>
: "" - Es la ruta de acceso en la que se coloca el contenido de los directorios de salida administrados por --experimental_remote_output_service. El directorio de salida real que usa una compilación será un elemento secundario de esta ruta y lo determinará el servicio de salida.
--[no]experimental_remote_require_cached
predeterminado: "false"- Si se establece en verdadero, se exige que todas las acciones que se pueden ejecutar de forma remota se almacenen en caché; de lo contrario, la compilación fallará. 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 sin insertar de forma espuria resultados nuevos en la caché.
--experimental_remote_scrubbing_config=<Converts to a Scrubber>
valor predeterminado: consulta la descripción- Habilita la limpieza remota de claves de caché con el archivo de configuración proporcionado, que debe ser un búfer de protocolo en formato de texto (consulta src/main/protobuf/remote_scrubbing.proto). Esta función tiene como objetivo facilitar el uso compartido de una caché remota o de disco entre acciones que se ejecutan en diferentes plataformas, pero que tienen como objetivo la misma plataforma. Se debe usar con mucho cuidado, ya que los parámetros de configuración incorrectos pueden provocar el uso compartido accidental de entradas de caché y generar compilaciones incorrectas. El scrubbing 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 de disco para recuperar o almacenar el resultado de una acción. Las acciones depuradas no son compatibles con la ejecución remota y siempre se ejecutarán de forma local. La modificación de la configuración de limpieza no invalida los resultados presentes en el sistema de archivos local ni en las memorias caché 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 configura como "off", no se usa ningún subproceso de trabajador y la recuperación del repo está sujeta a reinicios. De lo contrario, usa un subproceso de trabajo virtual.
--[no]remote_accept_cached
predeterminado: "true"- Indica si se deben aceptar los resultados de acciones almacenados en caché de forma remota.
--remote_build_event_upload=<all or minimal>
predeterminado: "minimal"- Si se configura como "all", todos los resultados locales a los que hace referencia el BEP se suben a la caché remota. Si se establece en "mínimo", los resultados locales a los que se hace referencia en BEP no se suben a la caché remota, excepto los archivos que son importantes para los consumidores de BEP (p.ej., registros de pruebas y perfil de sincronización). El esquema bytestream:// siempre se usa para la URI de los archivos, incluso si faltan en la caché remota. El valor predeterminado es "minimal".
--remote_bytestream_uri_prefix=<a string>
valor 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 configurar cuando las compilaciones se realizan con un proxy, lo que hace que los valores de --remote_executor y --remote_instance_name ya no correspondan al nombre canónico del servicio de ejecución remota. Si no se configura, el valor predeterminado será “${hostname}/${instance_name}”.
--remote_cache=<a string>
valor predeterminado: consulta la descripción- Es el URI de un extremo de almacenamiento en caché. Los esquemas admitidos son http, https, grpc, grpcs (grpc con TLS habilitado) y unix (sockets locales de UNIX). Si no se proporciona ningún 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_async
predeterminado: "true"- Si es verdadero, la carga de los resultados de la acción en un disco o en una caché remota se realizará en segundo plano en lugar de bloquear la finalización de una acción. Algunas acciones son incompatibles con las cargas en segundo plano y es posible que se bloqueen incluso cuando se establece esta marca.
--[no]remote_cache_compression
predeterminado: "false"- Si está habilitado, comprime o descomprime los BLOB de caché con zstd cuando su tamaño sea al menos --experimental_remote_cache_compression_threshold.
- Se acumulan los usos múltiples de
--remote_cache_header=<a 'name=value' assignment>
- Especifica un encabezado que se incluirá en las solicitudes de caché: --remote_cache_header=Name=Value. Se pueden pasar varios encabezados especificando la marca varias veces. Los valores múltiples para el mismo nombre se convertirán en una lista separada por comas.
- Se acumulan los usos múltiples 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
- Valor predeterminado de
--remote_default_platform_properties=<a string>
: "" - Establece las propiedades de la plataforma predeterminada que se configurará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 la plataforma host se selecciona como la plataforma de ejecución para la ejecución remota.
- Se acumulan los usos múltiples de
--remote_download_regex=<a valid Java regular expression>
-
Fuerza la descarga de los resultados de 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 los usos múltiples de
--remote_downloader_header=<a 'name=value' assignment>
- Especifica un encabezado que se incluirá en las solicitudes del descargador remoto: --remote_downloader_header=Name=Value. Se pueden pasar varios encabezados especificando la marca varias veces. Los valores múltiples para el mismo nombre se convertirán en una lista separada por comas.
- Se acumulan los usos múltiples de
--remote_exec_header=<a 'name=value' assignment>
- Especifica un encabezado que se incluirá en las solicitudes de ejecución: --remote_exec_header=Name=Value. Se pueden pasar varios encabezados especificando la marca varias veces. Los valores múltiples para el mismo nombre se convertirán en una lista separada por comas.
--remote_execution_priority=<an integer>
predeterminado: "0"- Es la prioridad relativa de las acciones que se ejecutarán de forma remota. La semántica de los valores de prioridad particulares depende del servidor.
--remote_executor=<a string>
valor 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 ningún esquema, Bazel usará grpcs de forma predeterminada. Especifica el esquema grpc:// o unix: para inhabilitar TLS.
--remote_grpc_log=<a path>
valor predeterminado: consulta la descripción- Si se especifica, es la ruta de acceso a un archivo para registrar detalles relacionados con las llamadas a gRPC. Este registro consta de una secuencia de mensajes .proto serializados com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry, en la que cada mensaje tiene como prefijo un varint que denota el tamaño del siguiente mensaje .proto serializado, como lo realiza el método LogEntry.writeDelimitedTo(OutputStream).
- Se acumulan los usos múltiples de
--remote_header=<a 'name=value' assignment>
- Especifica un encabezado que se incluirá en las solicitudes: --remote_header=Name=Value. Se pueden pasar varios encabezados especificando la marca varias veces. Los valores múltiples para el mismo nombre se convertirán en una lista separada por comas.
- Valor predeterminado de
--remote_instance_name=<a string>
: "" - Es el valor que se pasará como instance_name en la API de ejecución remota.
--[no]remote_local_fallback
predeterminado: "false"- Indica 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"- Obsoleto. Consulta https://github.com/bazelbuild/bazel/issues/7480 para obtener más información.
--remote_max_connections=<an integer>
valor 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, significa que no hay limitación.
En el caso de la caché remota HTTP, una conexión TCP puede controlar una solicitud a la vez, por lo que Bazel puede realizar hasta --remote_max_connections solicitudes simultáneas.
En el caso del ejecutor y la caché remotos de gRPC, un canal de gRPC suele controlar más de 100 solicitudes simultáneas, por lo que Bazel podría realizar alrededor de `--remote_max_connections * 100` solicitudes simultáneas.
Etiquetas:host_machine_resource_optimizations
--remote_proxy=<a string>
valor 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:/ruta/al/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 retirada entre los reintentos remotos. Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
--remote_timeout=<An immutable length of time.>
predeterminado: "60s"- Es la cantidad máxima de tiempo que se espera para las llamadas de ejecución remota y de caché. Para la caché de REST, este es el tiempo de espera de conexión y de lectura. Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
--[no]remote_upload_local_results
predeterminado: "true"- Indica si se deben subir los resultados de las acciones ejecutadas de forma local a la caché remota si esta lo admite y el usuario está autorizado para hacerlo.
--[no]remote_verify_downloads
predeterminado: "true"- Si se configura 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 varias, no clasificadas de otra manera:
- Se acumulan los usos múltiples de
--build_metadata=<a 'name=value' assignment>
-
Pares de cadenas clave-valor personalizados que se proporcionarán en un evento de compilación.
Etiquetas:terminal_output
--color=<yes, no or auto>
predeterminado: "auto"- Usa los controles de la terminal para colorear el resultado.
- Se acumulan los usos múltiples de
--config=<a string>
- Selecciona secciones de configuración adicionales de los archivos .rc. Para cada <command>, también extrae las opciones de <command>:<config> si existe tal sección. Si esta sección no existe en ningún archivo .rc, Blaze falla con un error. Las combinaciones de marcas y secciones de configuración a las que equivalen se encuentran en los archivos de configuración tools/*.blazerc.
- Se acumulan los usos múltiples de
--credential_helper=<Path to a credential helper. It may be absolute, relative to the PATH environment variable, or %workspace%-relative. The path be optionally prefixed by a scope followed by an '='. The scope is a domain name, optionally with a single leading '*' wildcard component. A helper applies to URIs matching its scope, with more specific scopes preferred. If a helper has no scope, it applies to every URI.>
- Configura un auxiliar de credenciales que cumpla con la <a href="https://github.com/EngFlow/credential-helper-spec">Especificación del auxiliar de credenciales</a> para recuperar las credenciales de autorización para la recuperación del repositorio, el almacenamiento en caché y la ejecución remotos, y el servicio de eventos de compilación. Las credenciales proporcionadas por un asistente tienen prioridad sobre las credenciales proporcionadas por `--google_default_credentials`, `--google_credentials`, un archivo `.netrc` o el parámetro de autenticación para `repository_ctx.download()` y `repository_ctx.download_and_extract()`. Se puede especificar varias veces para configurar varios asistentes. Consulta https://blog.engflow.com/2023/10/09/configuring-bazels-credential-helper/ para obtener instrucciones.
--credential_helper_cache_duration=<An immutable length of time.>
predeterminado: "30 min"- Es la duración predeterminada durante la cual se almacenan en caché las credenciales proporcionadas por un auxiliar de credenciales si el auxiliar no indica cuándo vencen las credenciales.
--credential_helper_timeout=<An immutable length of time.>
predeterminado: "10s"- Configura el tiempo de espera para un auxiliar de credenciales. Los auxiliares de credenciales que no respondan dentro de este tiempo de espera fallarán en la invocación.
--curses=<yes, no or auto>
predeterminado: "auto"- Usa los controles del cursor de la terminal para minimizar el desplazamiento del resultado.
--disk_cache=<a path>
valor predeterminado: consulta la descripción- Es la ruta de acceso a un directorio en el que Bazel puede leer y escribir acciones y resultados de acciones. Si el directorio no existe, se creará.
--[no]enable_platform_specific_config
predeterminado: "false"- Si es verdadero, Bazel toma las líneas de configuración específicas del SO host de los archivos bazelrc. Por ejemplo, si el SO host es Linux y ejecutas bazel build, Bazel selecciona las 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: "5 min"- Cuánto tiempo debe permanecer inactivo el servidor antes de que se realice una recolección de elementos no utilizados de la caché de disco. Para especificar la política de recolección de elementos no utilizados, configura --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 recolectará periódicamente como elementos no utilizados para quitar las entradas más antiguas que esta edad. Si se configura 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 está inactivo, según lo determina 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 realizará una recolección de elementos no utilizados periódica en la caché de disco para que no supere este tamaño. Si se configura 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 está inactivo, según lo determina la marca --experimental_disk_cache_gc_idle_delay.
--[no]experimental_rule_extension_api
predeterminado: "true"-
Habilita la API experimental de extensión de reglas y las APIs de subreglas
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_windows_watchfs
predeterminado: "false"- Si es verdadero, se habilita la compatibilidad experimental con Windows para --watchfs. De lo contrario, --watchfs no tiene efecto en Windows. Asegúrate de habilitar también --watchfs.
--google_auth_scopes=<comma-separated list of options>
valor predeterminado: "https://www.googleapis.com/auth/cloud-platform"- Lista separada por comas de los permisos de autenticación de Google Cloud.
--google_credentials=<a string>
valor predeterminado: consulta la descripción- Especifica el archivo desde el que se obtienen las credenciales de autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más detalles.
--[no]google_default_credentials
predeterminado: "false"- Indica si se deben usar las "credenciales predeterminadas de la aplicación de Google" para la autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más detalles. Está inhabilitado de forma predeterminada.
--grpc_keepalive_time=<An immutable length of time.>
valor predeterminado: consulta la descripción- Configura los pings de keep-alive para las conexiones gRPC salientes. Si se configura, 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 de gRPC pendiente. Los tiempos se tratan con una granularidad de segundos; es un error establecer un valor inferior a un segundo. De forma predeterminada, los pings de Keep-Alive están inhabilitados. Antes de habilitar este parámetro de configuración, debes coordinarte con el propietario del servicio. Por ejemplo, para establecer un valor de 30 segundos en esta marca, se debe hacer de la siguiente manera: --grpc_keepalive_time=30s
--grpc_keepalive_timeout=<An immutable length of time.>
predeterminado: "20s"- Configura un tiempo de espera de keep-alive para las conexiones gRPC salientes. Si los pings de 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 con una granularidad de segundos; es un error establecer un valor inferior a un segundo. Si los pings de conexión activa están inhabilitados, se ignorará 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
- Se acumulan los usos múltiples de
--inject_repository=<an equals-separated mapping of repository name to path>
- Agrega un repositorio nuevo con una ruta de acceso local con el formato <nombre del repositorio>=<ruta de acceso>. Esto solo tiene efecto con --enable_bzlmod y equivale a agregar un `local_repository` correspondiente al archivo MODULE.bazel del módulo raíz a través de `use_repo_rule`. Si la ruta de acceso proporcionada es absoluta, se usará tal cual. Si la ruta de acceso proporcionada es relativa, será relativa al directorio de trabajo actual. Si la ruta de acceso proporcionada comienza con "%workspace%", es relativa a la raíz del espacio de trabajo, que es el resultado de "bazel info workspace". Si la ruta de acceso proporcionada está vacía, quita las inserciones anteriores.
- Valor predeterminado de
--invocation_id=<a UUID>
: "" -
Identificador único, en formato UUID, para el comando que se está ejecutando. 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
- Se acumulan los usos múltiples de
--override_repository=<an equals-separated mapping of repository name to path>
- Anula un repositorio con una ruta de acceso local con el formato <nombre del repositorio>=<ruta de acceso>. Si la ruta de acceso proporcionada es absoluta, se usará tal cual. Si la ruta de acceso proporcionada es relativa, se relacionará con el directorio de trabajo actual. Si la ruta de acceso proporcionada comienza con "%workspace%", es relativa a la raíz del espacio de trabajo, que es el resultado de "bazel info workspace". Si la ruta de acceso proporcionada está vacía, se quitarán los reemplazos anteriores.
--[no]progress_in_terminal_title
predeterminado: "false"- Muestra el progreso del comando en el título de la terminal. Es útil para ver lo que hace Bazel cuando hay varias pestañas de terminal.
--[no]show_progress
predeterminado: "true"- Mostrar mensajes de progreso durante una compilación
--show_progress_rate_limit=<a double>
predeterminado: "0.2"- Cantidad mínima de segundos entre los mensajes de progreso en el resultado.
--[no]show_timestamps
predeterminado: "false"- Incluye marcas de tiempo en los mensajes
--tls_certificate=<a string>
valor predeterminado: consulta la descripción- Especifica una ruta de acceso a un certificado TLS que se considera de confianza para firmar certificados de servidor.
--tls_client_certificate=<a string>
valor 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>
valor predeterminado: consulta la descripción- Especifica la clave del cliente TLS que se usará. También debes proporcionar un certificado de cliente para habilitar la autenticación del cliente.
--ui_actions_shown=<an integer>
predeterminado: "8"-
Cantidad de acciones simultáneas que se muestran en la barra de progreso detallada. Cada acción se muestra en una línea separada. La barra de progreso siempre muestra al menos un 1, ya que todos los números inferiores a 1 se asignan a 1.
Etiquetas:terminal_output
--[no]watchfs
predeterminado: "false"- En Linux o macOS: Si es verdadero, Bazel intenta usar el servicio de supervisión de archivos del sistema operativo para los cambios locales en lugar de analizar cada archivo en busca de un cambio. En Windows, esta marca actualmente no realiza ninguna operación, pero se puede habilitar junto con --experimental_windows_watchfs. En cualquier SO: El comportamiento no está definido si tu espacio de trabajo se encuentra en un sistema de archivos de red y los archivos se editan en una máquina remota.
Opciones de Analyze-profile
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]incompatible_use_plus_in_repo_names
predeterminado: "true"-
No-op.
Etiquetas:loading_and_analysis
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--dump=<text or raw>
[-d
] predeterminado: consulta la descripción-
Genera un volcado completo de los datos del perfil en formato "texto" legible por humanos o en formato "sin procesar" apto para secuencias de comandos.
Etiquetas:bazel_monitoring
Opciones de Aquery
Hereda todas las opciones de build.
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]incompatible_use_plus_in_repo_names
predeterminado: "true"-
No se realiza ninguna operación.
Etiquetas:loading_and_analysis
- Opciones relacionadas con la salida y la semántica de la búsqueda:
--aspect_deps=<off, conservative or precise>
valor predeterminado: "conservative"-
Cómo resolver las dependencias de aspectos cuando el formato de salida es uno de {xml,proto,record}. "off" significa que no se resuelve ninguna dependencia de aspectos; "conservative" (el valor predeterminado) significa que se agregan todas las dependencias de aspectos declaradas, independientemente de si se les asigna la clase de regla de dependencias directas; "precise" significa que solo se agregan aquellos aspectos que posiblemente estén activos dada la clase de regla de las dependencias directas. Ten en cuenta que el modo preciso requiere cargar otros paquetes para evaluar un solo objetivo, lo que lo hace más lento que los otros modos. También ten en cuenta que incluso el modo preciso no es completamente preciso: la decisión de calcular un aspecto se toma en la fase de análisis, que no se ejecuta durante "bazel query".
Etiquetas:build_file_semantics
--[no]consistent_labels
predeterminado: "false"-
Si está habilitado, cada comando de consulta emite etiquetas como si se aplicara la función <code>str</code> de Starlark a una instancia de <code>Label</code>. Esto es útil para las herramientas que necesitan coincidir con el resultado de diferentes comandos de consulta o etiquetas emitidas por reglas. Si no está habilitado, los formateadores de salida pueden emitir nombres de repositorio aparentes (relativos al repositorio principal) para que la salida sea más legible.
Etiquetas:terminal_output
--[no]experimental_explicit_aspects
predeterminado: "false"-
aquery, cquery: Indica si se deben incluir las acciones generadas por aspectos en el resultado. query: No es una operación (los aspectos siempre se siguen).
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>
valor predeterminado: "512"-
Es la longitud máxima de la cadena de etiqueta para un nodo de gráfico en el resultado. Las etiquetas más largas se truncarán. El valor -1 significa que no se truncarán. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--[no]implicit_deps
predeterminado: "true"-
Si está habilitado, las dependencias implícitas se incluirán en el gráfico de dependencias sobre el que opera la consulta. Una dependencia implícita es aquella que no se especifica de forma explícita en el archivo BUILD, pero que Bazel agrega. En el caso de cquery, esta opción controla el filtrado de las 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 las acciones generadas por aspectos en el resultado. query: No es una operación (los aspectos siempre se siguen).
Etiquetas:terminal_output
--[no]include_commandline
predeterminado: "true"-
Incluye el contenido de las líneas de comandos de acción en el resultado (puede ser grande).
Etiquetas:terminal_output
--[no]include_file_write_contents
predeterminado: "false"-
Incluye el contenido del archivo para las acciones FileWrite, SourceSymlinkManifest y RepoMappingManifest (potencialmente grande).
Etiquetas:terminal_output
--[no]include_param_files
predeterminado: "false"-
Incluye el contenido de los archivos de parámetros que se usan en el comando (podría ser grande). Nota: Si habilitas esta marca, se habilitará automáticamente la marca --include_commandline.
Etiquetas:terminal_output
--[no]include_pruned_inputs
predeterminado: "true"-
Incluye las entradas de acción que se descartaron durante la ejecución de la acción. Solo afecta a las acciones que descubren entradas y se ejecutaron en una invocación anterior. Solo tiene efecto si también se configura --include_artifacts.
Etiquetas:terminal_output
--[no]incompatible_package_group_includes_double_slash
predeterminado: "true"-
Si está habilitado, 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 configura y no se configura --universe_scope, se inferirá un valor de --universe_scope como la lista de patrones de destino únicos en la expresión de búsqueda. Ten en cuenta que el valor de --universe_scope que se infiere para una expresión de búsqueda que usa funciones con alcance del universo (p.ej., "allrdeps") podría no ser el que deseas, por lo que debes usar esta opción solo si sabes lo que haces. 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á habilitado, 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 "visibilidad". 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 aquery. Los valores permitidos para aquery son: text, textproto, proto, streamed_proto y jsonproto.
Etiquetas:terminal_output
--[no]proto:default_values
predeterminado: "true"-
Si es verdadero, se incluyen los atributos cuyo valor no se especifica de forma explícita en el archivo BUILD; de lo contrario, se omiten. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
--[no]proto:definition_stack
predeterminado: "false"-
Propaga el campo proto definition_stack, que registra para cada instancia de regla la pila de llamadas de Starlark en el momento en que se definió la clase de la regla.
Etiquetas:terminal_output
--[no]proto:flatten_selects
predeterminado: "true"-
Si está habilitado, 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"-
Completa el campo proto source_aspect_name de cada atributo con el aspecto fuente del que proviene el atributo (cadena vacía si no proviene de ninguno).
Etiquetas:terminal_output
--[no]proto:include_synthetic_attribute_hash
predeterminado: "false"-
Indica si se debe calcular y completar el atributo $internal_attr_hash.
Etiquetas:terminal_output
--[no]proto:instantiation_stack
predeterminado: "false"-
Propaga la pila de llamadas de instanciación 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 la salida de proto.
Etiquetas:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
predeterminado: "all"-
Lista de atributos separados por comas que se incluirán en el resultado. La configuración predeterminada incluye todos los atributos. Se establece en una cadena vacía para no generar ningún atributo. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
--[no]proto:rule_classes
predeterminado: "false"-
Completa el campo rule_class_key de cada regla y, para la primera regla con un rule_class_key determinado, también completa su campo rule_class_info proto. El campo rule_class_key identifica de forma única una clase de regla, y el campo rule_class_info es una definición de API de clase de regla en formato Stardoc.
Etiquetas:terminal_output
--[no]proto:rule_inputs_and_outputs
predeterminado: "true"-
Indica si se deben propagar los campos rule_input y rule_output.
Etiquetas:terminal_output
- Valor predeterminado de
--query_file=<a string>
: "" -
Si se configura, la consulta leerá la consulta del archivo que se nombra aquí, en lugar de hacerlo desde la línea de comandos. Es un error especificar un archivo aquí y una consulta de línea de comandos.
Etiquetas:changes_inputs
--[no]relative_locations
predeterminado: "false"-
Si es verdadero, la ubicación de los archivos BUILD en las salidas de XML y proto será relativa. De forma predeterminada, la salida de ubicación es una ruta de acceso absoluta y no será coherente en todas las máquinas. Puedes establecer esta opción como verdadera para obtener un resultado coherente en todas las máquinas.
Etiquetas:terminal_output
--[no]skyframe_state
predeterminado: "false"-
Sin realizar análisis adicionales, vuelca el Action Graph actual de Skyframe. Nota: Por el momento, no se admite la especificación de 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 está inhabilitada, las dependencias de la "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 que va 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 "target".
Cquery: Si está inhabilitado, filtra todos los destinos configurados que cruzan una transición de ejecución desde el destino de nivel superior que descubrió este destino configurado. Esto significa que, si el destino de nivel superior está en la configuración de destino, solo se devolverán los destinos configurados que también estén en la configuración de destino. Si el destino de nivel superior está en la configuración de ejecución, solo se devolverán los destinos configurados para la ejecución. Esta opción NO excluirá las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
- Valor predeterminado de
--universe_scope=<comma-separated list of options>
: "" -
Es un conjunto de patrones de segmentación (aditivos y sustractivos) separados por comas. La consulta se puede realizar en el universo definido por el cierre transitivo de los destinos especificados. Esta opción se usa para los comandos query y cquery.
En el caso de cquery, la entrada de esta opción son los destinos en los que se compilan todas las respuestas, por lo que esta opción puede afectar las configuraciones y las transiciones. Si no se especifica esta opción, se supone que los destinos de nivel superior son los que se analizan a partir de la expresión de búsqueda. Nota: En el caso de cquery, no especificar esta opción puede provocar que se interrumpa la compilación si los destinos analizados a partir de la expresión de la consulta no se pueden compilar con las opciones de nivel superior.
Etiquetas:loading_and_analysis
- Opciones que controlan la ejecución de la compilación:
--[no]experimental_inprocess_symlink_creation
predeterminado: "true"-
Indica si se deben realizar llamadas directas al sistema de archivos para crear árboles de vínculos simbólicos en lugar de delegar en un proceso auxiliar.
Etiquetas:loading_and_analysis
,execution
,experimental
--[no]experimental_persistent_aar_extractor
predeterminado: "false"-
Habilita el extractor de aar persistente con trabajadores.
Etiquetas:execution
,experimental
--[no]experimental_remotable_source_manifests
predeterminado: "false"-
Indica si las acciones del manifiesto fuente se pueden realizar 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 una nueva generación.
Etiquetas:execution
,experimental
--[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 vínculos simbólicos.
Etiquetas:execution
,experimental
--[no]incompatible_modify_execution_info_additive
predeterminado: "false"-
Cuando se habilita, 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 los usos múltiples 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 mnemónica 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 expresiones regulares pueden aplicarse a la misma mnemónica.
La sintaxis es "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" de ella.
"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 Genrule.
Etiquetas:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Habilita acciones persistentes de dex y desugar de Android con trabajadores.
Se expande a:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
-
Habilita el procesador de recursos 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 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=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_tools
-
Habilita herramientas de Android persistentes y multiplexadas (dexing, desugaring, 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.
Tags:execution
- Opciones que configuran la cadena de herramientas que se usa para la ejecución de acciones:
--android_compiler=<a string>
valor predeterminado: consulta la descripción-
Compilador de destino de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
valor predeterminado: "android"-
Selecciona el combinador de manifiestos que se usará para las reglas de android_binary. Es una marca para ayudar en la transición de la herramienta de combinación heredada a la herramienta de combinación de manifiestos de Android.
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 archivo binario es un APK grueso, que contiene archivos binarios nativos para cada plataforma de destino especificada.
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>
valor 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 archivo binario que se usa para el procesamiento posterior de los informes de cobertura sin procesar. Actualmente, debe ser un filegroup 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 archivo binario que se usa para generar informes de cobertura. Actualmente, debe ser un filegroup 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 asistencia que se requieren en las entradas de cada acción de prueba que recopila la cobertura del código. El valor predeterminado es “//tools/test:coverage_support”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--custom_malloc=<a build target label>
valor predeterminado: consulta la descripción-
Especifica una implementación de malloc personalizada. Este parámetro de configuración anula los atributos de malloc en las reglas de compilación.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan los usos múltiples de
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
-
Lista de expresiones regulares separadas por comas, cada una con el prefijo opcional - (expresión negativa), asignadas (=) a una lista de destinos de valores de restricción separados por comas. Si un destino no coincide con ninguna expresión negativa y coincide con al menos una expresión positiva, la resolución de su 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 configura, agrega un requisito de ejecución "requires-xcode:{version}" a cada acción de Xcode. Si la versión de Xcode tiene una etiqueta con guion, también agrega un requisito de ejecución "requires-xcode-label:{version_label}".
Etiquetas:loses_incremental_state
,loading_and_analysis
,execution
,experimental
--[no]experimental_prefer_mutual_xcode
predeterminado: "true"-
Si es verdadero, usa el Xcode más reciente que esté disponible de forma local y remota. Si es falso o si no hay versiones disponibles mutuas, usa la versión local de Xcode seleccionada a través de xcode-select.
Etiquetas:loses_incremental_state
,experimental
- 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 objetivo exacto o como un patrón de objetivo. Estas plataformas se considerarán antes de las que se declaren en el archivo WORKSPACE con register_execution_platforms(). Esta opción solo se puede configurar una vez; las instancias posteriores anularán la configuración anterior de la marca.
Etiquetas:execution
- Se acumulan los usos múltiples 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 de las que se declaran en el archivo WORKSPACE con register_toolchains().
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--grte_top=<a label>
valor predeterminado: consulta la descripción-
Es una etiqueta para una biblioteca de libc registrada. El valor predeterminado se selecciona con la cadena de herramientas de compilación cruzada y casi nunca es necesario anularlo.
Etiquetas:action_command_lines
,affects_outputs
--host_compiler=<a string>
valor predeterminado: consulta la descripción-
Es una marca que no realiza ninguna operación. Se quitará en una versión futura.
Etiquetas:loading_and_analysis
,execution
--host_grte_top=<a label>
valor 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 ejecución.
Etiquetas:action_command_lines
,affects_outputs
--host_platform=<a build target label>
valor predeterminado: "@bazel_tools//tools:host_platform"-
Etiqueta de una regla de plataforma que describe el sistema host.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--[no]incompatible_bazel_test_exec_run_under
predeterminado: "false"-
Si está habilitado, "bazel test --run_under=//:runner" compila "//:runner" en la configuración de ejecución. Si está inhabilitado, compila "//:runner" en la configuración de destino. Bazel ejecuta pruebas en máquinas de ejecución, por lo que la primera opción es más correcta. Esto no afecta a "bazel run", que siempre compila "`--run_under=//foo" en la configuración de destino.
Etiquetas:affects_outputs
,incompatible_change
--[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_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 nativas)
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_strip_executable_safely
predeterminado: "false"-
Si es verdadero, la acción de despojo para los ejecutables usará la marca -x, que no interrumpe la resolución de símbolos dinámicos.
Etiquetas:action_command_lines
,incompatible_change
-
Usa objetos compartidos de interfaz si la cadena de herramientas los admite. Actualmente, todas las cadenas de herramientas de 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')>
valor 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')>
valor 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>
valor predeterminado: consulta la descripción-
Es la versión mínima del SO para la que se compila tu app.
Etiquetas:loading_and_analysis
,affects_outputs
- Valor predeterminado de
--platform_mappings=<a main workspace-relative path>
: "" -
Ubicación de un archivo de asignación que describe qué plataforma usar si no se configuró ninguna o qué marcas establecer cuando ya existe una plataforma. Debe ser relativa a la raíz del espacio de trabajo principal. El valor predeterminado es "platform_mappings" (un archivo directamente en la raíz del espacio de trabajo).
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
,immutable
- Valor predeterminado de
--platforms=<a build target label>
: "" -
Son 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
--python_path=<a string>
valor predeterminado: consulta la descripción-
Es la ruta de acceso absoluta del intérprete de Python invocado para ejecutar destinos de Python en la plataforma de destino. Obsoleto; se inhabilita con --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
--python_top=<a build target label>
valor predeterminado: consulta la descripción-
Es 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 inhabilita 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')>
valor 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')>
valor 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>
valor predeterminado: consulta la descripción-
Si se especifica, usa Xcode de la versión indicada para las acciones de compilación pertinentes. Si no se especifica, se usa la versión predeterminada del ejecutor de Xcode.
Etiquetas:loses_incremental_state
--xcode_version_config=<a build target label>
valor 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 vínculos simbólicos de archivos ejecutables para todos los destinos. Si es falso, se escriben solo cuando lo requiere una acción, prueba o comando de ejecución local.
Etiquetas:affects_outputs
--[no]build_runfile_manifests
predeterminado: "true"-
Si es verdadero, escribe manifiestos de archivos ejecutables 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, también se compilará automáticamente el archivo .dwp para el archivo binario de prueba.
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 un cc_proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated set of options>
predeterminado: ".pb.cc"-
Establece los sufijos de los archivos fuente que crea un 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 un 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 resultado de la compilación.
Etiquetas:affects_outputs
,experimental
--fission=<a set of compilation modes>
predeterminado: "no"-
Especifica qué modos de compilación usan fission para las compilaciones y las vinculaciones 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 verdadero, las reglas nativas agregan <code>DefaultInfo.files</code> de las dependencias de datos a sus archivos ejecutables, 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: "false"-
Si es verdadero, compila bosques de vínculos simbólicos 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 configura, se guardarán los resultados temporales de gcc. Estos incluyen archivos .s (código de ensamblador), archivos .i (C preprocesado) y archivos .ii (C++ preprocesado).
Etiquetas:affects_outputs
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
- Se acumulan los usos múltiples de
--action_env=<a 'name=value' assignment with an optional value part>
-
Especifica el conjunto de variables de entorno disponibles para las acciones con configuración de destino. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o bien por el par nombre=valor que establece el valor independientemente del entorno de invocación. Esta opción se puede usar varias veces. En el caso de las opciones proporcionadas para la misma variable, se aplica la más reciente. Las opciones para diferentes variables se acumulan.
Etiquetas:action_command_lines
- Valor predeterminado de
--allowed_cpu_values=<comma-separated set of options>
: "" -
Valores permitidos para la marca --cpu.
Etiquetas:changes_inputs
,affects_outputs
--[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 operación.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]android_databinding_use_v3_4_args
predeterminado: "true"-
Usa la vinculación de datos de Android v2 con el argumento 3.4.0. Esta marca no realiza ninguna operació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 de forma explícita una biblioteca compartida. "default" significa que Bazel elegirá si se vincula de forma dinámica. "fully" significa que todas las bibliotecas se vincularán de forma dinámica. "off" significa que todas las bibliotecas se vincularán principalmente en modo estático.
Etiquetas:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
predeterminado: "alfabético"-
Establece el orden de los manifiestos que se pasan al combinador de manifiestos para los archivos binarios de Android. ALPHABETICAL 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 de 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 los usos múltiples de
--catalyst_cpus=<comma-separated list of options>
-
Lista separada por comas de las arquitecturas para las que se compilarán los archivos 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 cuando 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 se debe especificar directamente. En su lugar, se debe usar el comando "bazel coverage".
Etiquetas:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] valor 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 los usos múltiples 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 los usos múltiples de
--copt=<a string>
-
Opciones adicionales para pasar a gcc.
Etiquetas:action_command_lines
,affects_outputs
- Valor predeterminado de
--cpu=<a string>
: "" -
CPU objetivo.
Etiquetas:changes_inputs
,affects_outputs
--cs_fdo_absolute_path=<a string>
valor 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 de LLVM sin procesar o indexado.
Etiquetas:affects_outputs
--cs_fdo_instrument=<a string>
valor predeterminado: consulta la descripción-
Genera archivos binarios con la 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 en el tiempo de ejecución.
Etiquetas:affects_outputs
--cs_fdo_profile=<a build target label>
valor 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 los usos múltiples 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 los usos múltiples de
--define=<a 'name=value' assignment>
-
Cada opción --define especifica una asignación para una variable de compilación. En caso de que haya varios valores para una variable, se usará el último.
Etiquetas:changes_inputs
,affects_outputs
--dynamic_mode=<off, default or fully>
predeterminado: "default"-
Determina si los archivos binarios de C++ se vincularán de forma dinámica. "default" significa que Bazel elegirá si se vincula de forma dinámica. "fully" significa que todas las bibliotecas se vincularán de forma dinámica. "off" significa que todas las bibliotecas se vincularán principalmente en modo estático.
Etiquetas:loading_and_analysis
,affects_outputs
--[no]enable_propeller_optimize_absolute_paths
predeterminado: "true"-
Si se configura, cualquier uso de rutas absolutas para la optimización de la hélice generará un error.
Etiquetas:affects_outputs
--[no]enable_remaining_fdo_absolute_paths
predeterminado: "true"-
Si se configura, cualquier uso de rutas absolutas para FDO generará un error.
Etiquetas:affects_outputs
--[no]enable_runfiles
predeterminado: "auto"-
Habilita el árbol de vínculos simbólicos de runfiles. De forma predeterminada, está desactivado en Windows y activado en otras plataformas.
Etiquetas:affects_outputs
- Se acumulan los usos múltiples 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
--[no]experimental_android_compress_java_resources
predeterminado: "false"-
Comprimir recursos de Java en APKs
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_android_databinding_v2
predeterminado: "true"-
Usa la vinculación de datos de Android v2. Esta marca no realiza ninguna operació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
,experimental
--[no]experimental_android_rewrite_dexes_with_rex
predeterminado: "false"-
use rex tool to rewrite dex files
Tags: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 recopilación de cobertura para los archivos generados.
Etiquetas:affects_outputs
,experimental
--experimental_objc_fastbuild_options=<comma-separated list of options>
predeterminado: "-O0,-DDEBUG=1"-
Usa estas cadenas como opciones del compilador de compilación rápida de objc.
Etiquetas:action_command_lines
--[no]experimental_omitfp
predeterminado: "false"-
Si es verdadero, usa libunwind para el desenrollado de la pila y compila con -fomit-frame-pointer y -fasynchronous-unwind-tables.
Etiquetas:action_command_lines
,affects_outputs
,experimental
--experimental_output_paths=<off, content or strip>
predeterminado: "off"-
Qué modelo se debe usar para determinar dónde escriben sus resultados las reglas en el árbol de salida, en particular para las compilaciones multiplataforma o con múltiples configuraciones. Esta función 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 agregando la clave "supports-path-mapping" al diccionario "execution_requirements".
Etiquetas:loses_incremental_state
,bazel_internal_configuration
,affects_outputs
,execution
- Se acumulan los usos múltiples 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 corto deseado para usar en la ruta de acceso 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 de plataformas. 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 la plataforma actual. Por último, se usa un hash de la opción de la plataforma como último recurso.
Etiquetas:affects_outputs
,experimental
--[no]experimental_py_binaries_include_label
predeterminado: "false"-
Los destinos py_binary incluyen su etiqueta incluso cuando el sellado está inhabilitado.
Etiquetas:affects_outputs
,experimental
--[no]experimental_use_llvm_covmap
predeterminado: "false"-
Si se especifica, Bazel generará información del mapa de cobertura de llvm-cov en lugar de gcov cuando se habilite collect_code_coverage.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic
predeterminado: "true"-
Usa esta marca solo como parte de una estrategia de prueba o migración sugerida. Ten en cuenta que la heurística tiene deficiencias conocidas y se sugiere migrar para depender solo de --experimental_override_name_platform_in_output_dir.
Etiquetas:affects_outputs
,experimental
--fdo_instrument=<a string>
valor predeterminado: consulta la descripción-
Genera archivos binarios con la instrumentación de FDO. Con el compilador Clang/LLVM, también acepta el nombre del directorio en el que se volcarán los archivos de perfil sin procesar en el tiempo de ejecución.
Etiquetas:affects_outputs
--fdo_optimize=<a string>
valor predeterminado: consulta la descripción-
Usa la información del perfil de FDO para optimizar la compilación. Especifica el nombre de un archivo ZIP que contenga un árbol de archivos .gcda, un archivo AFDO que contenga un perfil automático o un archivo de perfil de LLVM. Esta marca también acepta archivos especificados como etiquetas (p.ej., `//foo/bar:file.afdo`; es posible que debas agregar una directiva `exports_files` al paquete correspondiente) y etiquetas que apuntan a destinos `fdo_profile`. Esta marca se reemplazará por la regla "fdo_profile".
Etiquetas:affects_outputs
--fdo_prefetch_hints=<a build target label>
valor predeterminado: consulta la descripción-
Usa sugerencias de recuperación previa de caché.
Etiquetas:affects_outputs
--fdo_profile=<a build target label>
valor predeterminado: consulta la descripción-
Es el objeto fdo_profile que representa el perfil que se usará para la optimización.
Etiquetas:affects_outputs
- Se acumulan los usos múltiples de
--features=<a string>
-
Las funciones proporcionadas 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. Las funciones negativas siempre anulan las positivas. Consulta también --host_features.
Etiquetas:changes_inputs
,affects_outputs
--[no]force_pic
predeterminado: "false"-
Si está habilitado, todas las compilaciones de C++ producen código independiente de la posición (“-fPIC”), las vinculaciones prefieren las bibliotecas prediseñadas PIC a las bibliotecas no PIC y las vinculaciones producen ejecutables independientes de la posición (“-pie”).
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan los usos múltiples 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 proporcionadas para la misma variable, se aplica la más reciente. Las opciones para diferentes variables se acumulan.
Etiquetas:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
valor predeterminado: "opt"-
Especifica el modo en el que se compilarán las herramientas que se usan durante la compilación. Valores: "fastbuild", "dbg", "opt".
Etiquetas:affects_outputs
,action_command_lines
- Se acumulan los usos múltiples 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 los usos múltiples 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
- Valor predeterminado de
--host_cpu=<a string>
: "" -
Es la CPU del host.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan los usos múltiples de
--host_cxxopt=<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
- Se acumulan los usos múltiples de
--host_features=<a string>
-
Las funciones proporcionadas 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. Las funciones negativas siempre anulan las positivas.
Etiquetas:changes_inputs
,affects_outputs
--host_force_python=<PY2 or PY3>
valor 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 los usos múltiples 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')>
valor predeterminado: consulta la descripción-
Versión mínima de macOS compatible con los destinos de host. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan los usos múltiples 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 de 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. Aquí, regex_filter representa una lista de patrones de expresiones regulares de inclusión y exclusión (consulta también --instrumentation_filter), y option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe incluirse 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
--[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 pliega en el directorio bin.
Etiquetas: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 configura, se instrumentan las reglas de prueba incluidas por --instrumentation_filter. De lo contrario, las reglas de prueba siempre se excluyen de la instrumentación de cobertura.
Etiquetas:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
valor predeterminado: "-/javatests[/:],-/test/java[/:]"-
Cuando la cobertura está habilitada, solo se instrumentarán las reglas con nombres incluidos en el filtro basado en regex especificado. En su lugar, se excluyen las reglas que tienen 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')>
valor predeterminado: consulta la descripción-
Versión mínima compatible de iOS para los simuladores y dispositivos de destino. Si no se especifica, se usa "ios_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan los usos múltiples de
--ios_multi_cpus=<comma-separated list of options>
-
Lista separada por comas de las arquitecturas con las que se compilará un 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. Se reemplazó por --incompatible_remove_legacy_whole_archive (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener más detalles). 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 los usos múltiples de
--linkopt=<a string>
-
Opción adicional para pasar a gcc durante la vinculación.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan los usos múltiples 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 los usos múltiples 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 los usos múltiples de
--macos_cpus=<comma-separated list of options>
-
Lista separada por comas de las arquitecturas para las que se compilarán los archivos 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')>
valor predeterminado: consulta la descripción-
Versión mínima de macOS compatible con los destinos. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
--memprof_profile=<a build target label>
valor predeterminado: consulta la descripción-
Usa el perfil de memprof.
Etiquetas:affects_outputs
--[no]objc_debug_with_GLIBCXX
predeterminado: "false"-
Si se configura 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 no utilizado de los archivos binarios vinculados. Se realizará el despojo de binarios si se especifican esta marca y --compilation_mode=opt.
Etiquetas:action_command_lines
- Se acumulan los usos múltiples 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 los usos múltiples 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. Aquí, regex_filter representa una lista de patrones de expresiones regulares de inclusión y exclusión (consulta también --instrumentation_filter), y option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe incluirse 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 los usos múltiples 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 del backend. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,…,option_n. Aquí regex_filter representa una lista de patrones de expresiones regulares de inclusión y exclusión, y option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe incluirse 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
--platform_suffix=<a string>
valor 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>
valor 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 los 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>
valor predeterminado: consulta la descripción-
Nombre de ruta de acceso absoluta del archivo cc_profile para las compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
valor predeterminado: consulta la descripción-
Nombre de ruta de acceso absoluta del archivo ld_profile para las compilaciones optimizadas con Propeller.
Etiquetas:affects_outputs
--run_under=<a prefix in front of command>
valor predeterminado: consulta la descripción-
Prefijo que se 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" y "//package:target --options".
Etiquetas:action_command_lines
-
Si es verdadero, las bibliotecas nativas que contienen la misma funcionalidad se compartirán entre diferentes destinos.
Etiquetas:loading_and_analysis
,affects_outputs
--[no]stamp
predeterminado: "false"-
Sella los archivos 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 archivos binarios y las bibliotecas compartidas (con "-Wl,--strip-debug"). El valor predeterminado "sometimes" significa que se quita solo si --compilation_mode=fastbuild.
Etiquetas:affects_outputs
- Se acumulan los usos múltiples de
--stripopt=<a string>
-
Opciones adicionales para pasar a strip cuando se genera un objeto binario "<name>.stripped".
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan los usos múltiples de
--tvos_cpus=<comma-separated list of options>
-
Lista separada por comas de las arquitecturas para las que se compilarán los archivos 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')>
valor 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 los usos múltiples de
--visionos_cpus=<comma-separated list of options>
-
Lista separada por comas de las arquitecturas para las que se compilarán los archivos binarios de Apple visionOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Se acumulan los usos múltiples de
--watchos_cpus=<comma-separated list of options>
-
Lista separada por comas de las arquitecturas para las que se compilarán los archivos binarios de watchOS de Apple.
Etiquetas:loses_incremental_state
,loading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
valor 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>
valor predeterminado: consulta la descripción-
Usa la información del perfil de XbinaryFDO para optimizar la compilación. Especifica el nombre del perfil predeterminado de varias plataformas. 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 hubiera especificado.
Etiquetas:affects_outputs
- Opciones que afectan la rigidez con la que Bazel aplica las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
--[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"-
Indica si se debe aplicar desugar al código de bytes de Java 8 antes de convertirlo en dex.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]desugar_java8_libs
predeterminado: "false"-
Indica si se deben incluir las bibliotecas de Java 8 compatibles en las 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 destino y genera errores si algún destino tiene dependencias que no admiten los mismos entornos.
Etiquetas:build_file_semantics
--[no]experimental_check_desugar_deps
predeterminado: "true"-
Indica si se debe verificar la desazucaración correcta a nivel binario de Android.
Etiquetas:eagerness_to_exit
,loading_and_analysis
,experimental
--experimental_import_deps_checking=<a string>
valor predeterminado: consulta la descripción-
No se realiza ninguna operación; se mantiene solo para la retrocompatibilidad
Etiquetas:loading_and_analysis
--experimental_one_version_enforcement=<off, warning or error>
predeterminado: "OFF"-
Cuando se habilita, se aplica 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 la clase. Esta aplicación de la política puede interrumpir la compilación o simplemente generar advertencias.
Etiquetas:loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
predeterminado: "default"-
Si es verdadero, verifica que un destino de Java declare explícitamente todos los destinos que se usan directamente como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files
predeterminado: "false"-
Si está habilitado, verifica testonly para los destinos de requisitos previos que son archivos de salida buscando el testonly de la regla de generación. Esto coincide con la verificación de visibilidad.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_check_visibility_for_toolchains
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 Starlark para Android 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 operación. Se mantiene aquí para la retrocompatibilidad.
Etiquetas:eagerness_to_exit
,incompatible_change
--[no]incompatible_python_disable_py2
predeterminado: "true"-
Si es verdadero, usar la configuración de Python 2 causará 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]one_version_enforcement_on_java_tests
predeterminado: "true"-
Cuando se habilita y experimental_one_version_enforcement se establece en un valor que no sea NONE, se aplica una versión en los destinos de java_test. Esta marca se puede inhabilitar para mejorar el rendimiento de las pruebas incrementales a costa de no detectar posibles incumplimientos de una versión.
Etiquetas:loading_and_analysis
--python_native_rules_allowlist=<a build target label>
valor predeterminado: consulta la descripción-
Lista de entidades permitidas (destino 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 del paquete 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, verifica que un destino proto_library declare explícitamente 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, verifica que un destino proto_library declare de forma explícita todos los destinos 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 los usos múltiples 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 "environment". 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 en Objective-C incluirán derechos de depuración cuando se firmen.
Etiquetas:changes_inputs
--ios_signing_cert_name=<a string>
valor predeterminado: consulta la descripción-
Nombre del certificado que se usará para la firma de iOS. Si no se configura, se volverá al perfil de aprovisionamiento. Puede ser la preferencia de identidad del llavero del certificado o una subcadena del nombre común del certificado, según la página de manual 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 se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]incompatible_disallow_legacy_py_provider
predeterminado: "true"-
No-op, se quitará pronto.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_sdk_frameworks_attributes
predeterminado: "false"-
Si es verdadero, no permite los atributos sdk_frameworks y weak_sdk_frameworks en objc_library y objc_import.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_objc_alwayslink_by_default
predeterminado: "false"-
Si es verdadero, establece el valor predeterminado como verdadero para los atributos alwayslink en objc_library y objc_import.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_python_disallow_native_rules
predeterminado: "false"-
Cuando es verdadero, se produce un error cuando se usan las reglas py_* integradas; en su lugar, se deben usar las reglas rule_python. Consulta https://github.com/bazelbuild/bazel/issues/17773 para obtener más información y las instrucciones de migración.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones que rigen el comportamiento del entorno de prueba o del ejecutor de pruebas:
--[no]allow_analysis_failures
predeterminado: "false"-
Si es verdadero, un error de análisis de un destino de regla hace que el destino propague una instancia de AnalysisFailureInfo que contiene la descripción del error, en lugar de generar un error 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 generará un error de regla.
Etiquetas:loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure
predeterminado: "false"-
Si es verdadero, los errores de la acción dex2oat harán que se interrumpa la compilación en lugar de ejecutar dex2oat durante el tiempo de ejecución de la prueba.
Etiquetas:loading_and_analysis
,experimental
- Se acumulan los usos múltiples 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 predeterminada de recursos para las pruebas. El formato esperado es <recurso>=<valor>. Si se especifica un solo número positivo como <valor>, se anularán los recursos predeterminados para todos los tamaños de prueba. Si se especifican 4 números separados por comas, se anulará la cantidad de recursos para los tamaños de prueba pequeño, mediano, grande y enorme, 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 especificados por esta marca se anulan con los recursos explícitos especificados en las etiquetas.
--[no]experimental_android_use_parallel_dex2oat
predeterminado: "false"-
Usa dex2oat en paralelo para acelerar android_test.
Etiquetas:loading_and_analysis
,host_machine_resource_optimizations
,experimental
--[no]ios_memleaks
predeterminado: "false"-
Habilita la verificación de pérdidas de memoria en los destinos de ios_test.
Etiquetas:action_command_lines
--ios_simulator_device=<a string>
valor predeterminado: consulta la descripción-
Es el dispositivo que se simulará cuando se ejecute una aplicación para iOS en el simulador, p.ej., "iPhone 6". Puedes obtener una lista de dispositivos ejecutando "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')>
valor predeterminado: consulta la descripción-
Versión de iOS que se ejecutará en el simulador cuando se ejecute o pruebe. Se ignora para las reglas de ios_test si se especifica un dispositivo objetivo en la regla.
Etiquetas:test_runner
- Se acumulan los usos múltiples 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ó. Normalmente, el valor especificado es solo un número entero. Ejemplo: --runs_per_test=3 ejecutará todas las pruebas 3 veces. Sintaxis alternativa: regex_filter@runs_per_test. Aquí runs_per_test representa 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 pasar varias veces. Tiene prioridad el argumento que se pasó más recientemente y que coincide. Si no hay coincidencias, la prueba solo se ejecuta una vez.
- Se acumulan los usos múltiples de
--test_env=<a 'name=value' assignment with an optional value part>
-
Especifica variables de entorno adicionales que se insertarán en el entorno del ejecutor de pruebas. Las variables se pueden especificar por nombre, en cuyo caso su valor se leerá del entorno del cliente de Bazel, o por el par nombre=valor. Esta opción se puede usar varias veces para especificar varias variables. Solo se usa con 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 la 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 cualquiera de las dos formas, 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: "false"-
Si es verdadero, los resultados de las pruebas no declarados se archivarán en un archivo ZIP.
Etiquetas:test_runner
- Opciones que activan optimizaciones del tiempo de compilación:
--[no]experimental_filter_library_jar_with_program_jar
predeterminado: "false"-
Filtra el ProgramJar de ProGuard para quitar las clases que también estén presentes en el LibraryJar.
Etiquetas:action_command_lines
,experimental
--[no]experimental_inmemory_dotd_files
predeterminado: "true"-
Si está habilitado, los archivos .d de C++ se pasarán por 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 las compilaciones de Java se pasarán a través de 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_retain_test_configuration_across_testonly
predeterminado: "false"-
Cuando está habilitado, --trim_test_configuration no recortará la configuración de prueba para las reglas marcadas como testonly=1. Esto tiene como objetivo reducir los problemas de conflicto de acciones cuando las reglas que no son de prueba dependen de las reglas cc_test. No tiene efecto si --trim_test_configuration es falso.
Etiquetas:loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_starlark_cc_import
predeterminado: "false"-
Si está habilitado, 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"-
Indica si se deben reducir las entradas a la compilación de C/C++ analizando las líneas #include de los archivos de entrada. Esto puede mejorar el rendimiento y la incrementalidad, ya que disminuye el tamaño de los árboles de entrada de compilación. Sin embargo, también puede interrumpir las compilaciones porque el analizador de inclusión no implementa por completo la semántica del preprocesador de 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 este parámetro que se registren.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
,experimental
--[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 configura, los archivos .d que emite clang se usarán para reducir 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 destino //a:a, se procesan 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, las opciones relacionadas con las pruebas se borrarán 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 el nivel de detalle, 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 cadenas de herramientas y los objetivos específicos para ver cuáles depurar. Se pueden separar varias expresiones regulares 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 los expertos en la resolución de cadenas de herramientas.
Etiquetas:terminal_output
- Opciones que especifican o alteran una entrada genérica para un comando de Bazel que no se incluye en otras categorías.:
- Se acumulan los usos múltiples 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 ejecutables de los destinos de Python. Específicamente, cuando un destino py_binary o py_test tiene legacy_create_init establecido en "auto" (el valor predeterminado), se trata como falso si y 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 vínculo simbólico 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 configuren su atributo `python_version` (o `default_python_version`) se establecerán de forma predeterminada en PY3 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 nativo 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>
valor predeterminado: consulta la descripción-
Modo de versión principal de Python, ya sea "PY2" o "PY3". Ten en cuenta que los objetivos "py_binary" y "py_test" anulan este parámetro (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 varias, no clasificadas de otra manera.:
--[no]cache_test_results
[-t
] default: "auto"- Si se configura como "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 se marca como externa, (3) se solicitaron varias ejecuciones de prueba con --runs_per_test o(4) la prueba falló anteriormente. Si se configura como “sí”, Bazel almacena en caché todos los resultados de las pruebas, excepto las que se marcan como externas. Si se configura como "no", Bazel no almacena en caché ningún resultado de la prueba.
--[no]experimental_cancel_concurrent_tests
predeterminado: "false"-
Si es verdadero, Blaze cancelará las pruebas que se ejecuten de forma simultánea en la primera ejecución exitosa. Esto solo es útil en combinación con --runs_per_test_detects_flakes.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_fetch_all_coverage_outputs
predeterminado: "false"-
Si es verdadero, Bazel recupera el directorio completo de datos de cobertura para cada prueba durante una ejecución de cobertura.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_generate_llvm_lcov
predeterminado: "false"-
Si es verdadero, la cobertura de clang generará un informe de LCOV.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_j2objc_header_map
predeterminado: "true"-
Indica si se debe generar el mapa de encabezado de J2ObjC en paralelo con la transpilación de J2ObjC.
Etiquetas:experimental
--[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
--experimental_java_classpath=<off, javabuilder or bazel>
predeterminado: "javabuilder"- Habilita rutas de acceso de clase reducidas para las compilaciones de Java.
--[no]experimental_limit_android_lint_to_android_constrained_java
predeterminado: "false"-
No-op, kept only for backwards compatibility
Etiquetas:affects_outputs
,experimental
--[no]experimental_run_android_lint_on_java_rules
predeterminado: "false"-
Indica si se deben validar las fuentes java_*.
Etiquetas:affects_outputs
,experimental
--[no]explicit_java_test_deps
predeterminado: "false"- Especifica de forma explícita una dependencia de 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>
valor predeterminado: consulta la descripción- Es el launcher de Java que usan las herramientas que se ejecutan durante una compilación.
- Se acumulan los usos múltiples de
--host_javacopt=<a string>
- Opciones adicionales para pasar a javac cuando se compilan herramientas que se ejecutan durante una compilación.
- Se acumulan los usos múltiples de
--host_jvmopt=<a string>
- Opciones adicionales para pasar a la VM de Java cuando se compilan herramientas que se ejecutan durante la compilación. Estas opciones se agregarán a las opciones de inicio de la VM de cada destino java_binary.
--[no]incompatible_check_sharding_support
predeterminado: "true"-
Si es verdadero, Bazel fallará una prueba fragmentada si el ejecutor de pruebas no indica que admite el fragmentado tocando el archivo en la ruta de TEST_SHARD_STATUS_FILE. Si es falso, un ejecutor de pruebas que no admite 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 una ejecución de 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 esto puede impedir el almacenamiento en caché entre usuarios si se usa una caché compartida.
Etiquetas:loading_and_analysis
,incompatible_change
- Se acumulan los usos múltiples 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, classpath de tiempo de compilación) por destino de Java.
--[no]java_header_compilation
predeterminado: "true"- Compila archivos .ijar directamente desde la fuente.
- Valor predeterminado de
--java_language_version=<a string>
: "" - La versión del lenguaje Java
--java_launcher=<a build target label>
valor predeterminado: consulta la descripción- Es el lanzador de Java que se usará cuando se compilen archivos binarios de Java. Si esta marca se establece en la cadena vacía, se usa el iniciador del JDK. El atributo "launcher" anula esta marca.
--java_runtime_version=<a string>
valor predeterminado: "local_jdk"- La versión del entorno de ejecución de Java
- Se acumulan los usos múltiples de
--javacopt=<a string>
- Opciones adicionales para pasar a javac.
- Se acumulan los usos múltiples de
--jvmopt=<a string>
- Opciones adicionales para pasar a la JVM 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>
valor predeterminado: consulta la descripción- Especifica un archivo binario que se usará para generar la lista de clases que deben estar en el archivo dex principal cuando se compile multidex heredado.
--optimizing_dexer=<a build target label>
valor predeterminado: consulta la descripción- Especifica un objeto binario que se usará para realizar la conversión a dex sin fragmentación.
- Se acumulan los usos múltiples de
--plugin=<a build target label>
- Son los complementos que se usarán en la compilación. Actualmente, funciona con java_plugin.
--proguard_top=<a build target label>
valor predeterminado: consulta la descripción- Especifica qué versión de ProGuard se usará para quitar código cuando se compile un archivo binario de Java.
--proto_compiler=<a build target label>
default: "@bazel_tools//tools/proto:protoc"-
Es la etiqueta del compilador de .proto.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]proto_profile
predeterminado: "true"-
Indica si se debe pasar profile_path al compilador de proto.
Etiquetas:affects_outputs
,loading_and_analysis
--proto_profile_path=<a build target label>
valor predeterminado: consulta la descripción-
Es el perfil que se pasará al compilador de .proto como profile_path. Si no se configura, pero --proto_profile es verdadero (el valor predeterminado), se infiere la ruta de --fdo_optimize.
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
default: "@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>
valor 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>
default: "@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>
default: "@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 los usos múltiples de
--protocopt=<a string>
-
Opciones adicionales para pasar al compilador de protobuf.
Etiquetas:affects_outputs
--[no]runs_per_test_detects_flakes
predeterminado: "false"- Si es verdadero, cualquier fragmento en el que se apruebe al menos una ejecución o intento y falle al menos una ejecución o intento obtendrá el estado FLAKY.
--shell_executable=<a path>
valor predeterminado: consulta la descripción-
Ruta de acceso absoluta al ejecutable del shell que Bazel debe usar. Si no se configura, pero la variable de entorno BAZEL_SH se establece en la primera invocación de Bazel (que inicia un servidor de Bazel), Bazel la usa. Si no se establece ninguno, Bazel usa una ruta de acceso predeterminada codificada de forma rígida según el sistema operativo en el que se ejecuta (Windows: c:/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 provocar fallas en la compilación o en el tiempo de ejecución de los archivos binarios generados.
Etiquetas:loading_and_analysis
- Se acumulan los usos múltiples de
--test_arg=<a string>
- Especifica argumentos y opciones 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 se usa con el comando "bazel test".
--test_filter=<a string>
valor 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.
- Valor predeterminado de
--test_result_expiration=<an integer>
: "-1" - Esta opción está obsoleta y no tiene ningún 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 ante el primer error.
--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 división de pruebas: "explícita" para usar la división solo si el atributo de compilación "shard_count" está presente. "disabled" para no usar nunca la división de pruebas. "forced=k" para forzar "k" fragmentos para las pruebas, independientemente del atributo de compilación "shard_count".
- Valor predeterminado de
--tool_java_language_version=<a string>
: "" - Versión del lenguaje Java que se usa para ejecutar las herramientas necesarias durante una compilación
--tool_java_runtime_version=<a string>
valor predeterminado: "remotejdk_11"- 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 interfaz. Esto generará una compilación incremental más rápida, pero los mensajes de error pueden ser diferentes.
Opciones de compilación
- 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 los usos múltiples de
--dynamic_local_strategy=<a '[name=]value1[,..,valueN]' assignment>
-
Son las estrategias locales, en orden, que se deben usar para la mnemónica determinada. Se usa la primera estrategia aplicable. Por ejemplo, "worker,sandboxed" ejecuta acciones que admiten trabajadores persistentes con la estrategia de trabajador y todas las demás con la estrategia de zona de pruebas. Si no se proporciona ninguna mnemónica, la lista de estrategias se usa como alternativa para todas las mnemónicas. La lista de resguardo predeterminada es "worker,sandboxed" o "worker,sandboxed,standalone" si se configura "experimental_local_lockfree_output". Toma [mnemonic=]local_strategy[,local_strategy,...]
Etiquetas:execution
,host_machine_resource_optimizations
- Se acumulan los usos múltiples de
--dynamic_remote_strategy=<a '[name=]value1[,..,valueN]' assignment>
-
Las estrategias remotas, en orden, para usar con la mnemónica determinada. Se usa la primera estrategia aplicable. Si no se proporciona ninguna mnemónica, la lista de estrategias se usa como alternativa para todas las mnemónicas. La lista de resguardo predeterminada es "remota", por lo que, por lo general, no es necesario establecer esta marca de forma explícita. Toma [mnemonic=]remote_strategy[,remote_strategy,...]
Etiquetas:execution
,host_machine_resource_optimizations
- Valor predeterminado de
--experimental_docker_image=<a string>
: "" -
Especifica un nombre de imagen de Docker (p.ej., "ubuntu:latest") que se debe usar para ejecutar una acción en zona de pruebas cuando se usa la estrategia de Docker y la acción en sí aún no tiene un atributo container-image en sus remote_execution_properties en la descripción de la plataforma. El valor de esta marca se pasa literalmente a "docker run", por lo que admite la misma sintaxis y los mismos mecanismos que Docker.
Etiquetas:execution
--[no]experimental_docker_use_customized_images
predeterminado: "true"-
Si está habilitado, inyecta el UID y el GID del usuario actual en la imagen de Docker antes de usarla. Esto es obligatorio si tu compilación o tus 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 configura, los objetivos que se compilan "para la herramienta" no están sujetos a la ejecución dinámica. Es muy poco probable que estos destinos se compilen de forma incremental, por lo que no vale la pena dedicarles ciclos locales.
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 debe colocar en la máquina local. Esta marca ajusta la cantidad de acciones en la ejecución dinámica que programaremos de forma simultánea. Se basa en la cantidad de CPUs que Blaze cree que están disponibles, lo que se puede controlar con la marca --local_cpu_resources.
Si esta marca es 0, todas las acciones se programan de inmediato a nivel local. Si es > 0, la cantidad de acciones programadas de forma local está limitada por la cantidad de CPU 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 en espera de programación es alta. Esto reduce la carga en la máquina local en el caso de una compilación limpia, en la que la máquina local no contribuye mucho.
Etiquetas:execution
,host_machine_resource_optimizations
--experimental_dynamic_slow_remote_time=<An immutable length of time.>
predeterminado: "0"-
Si es >0, es el tiempo que una acción ejecutada de forma dinámica debe ejecutarse solo de forma remota antes de que prioricemos su ejecución local para evitar tiempos de espera remotos. Esto puede ocultar algunos problemas en el sistema de ejecución remota. No actives esta opción sin supervisar los problemas de ejecución remota.
Etiquetas:execution
,host_machine_resource_optimizations
--[no]experimental_enable_docker_sandbox
predeterminado: "false"-
Habilita la zona de pruebas basada en Docker. Esta opción no tiene efecto si Docker no está instalado.
Etiquetas:execution
--[no]experimental_inmemory_sandbox_stashes
predeterminado: "false"-
Si se establece como verdadero, el contenido de los entornos de pruebas almacenados para reuse_sandbox_directories se hará un seguimiento en la memoria. Esto reduce la cantidad de E/S necesarias durante la reutilización. Según la compilación, esta marca puede mejorar el tiempo real. Según la compilación, esta marca también puede usar una cantidad significativa de memoria adicional.
Etiquetas:host_machine_resource_optimizations
,execution
- Valor predeterminado de
--experimental_sandbox_async_tree_delete_idle_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "4" -
Si es 0, borra los árboles de zona de pruebas en cuanto se completa una acción (lo que provoca que se retrase la finalización de la acción). Si es mayor que cero, ejecuta el borrado de esos tres en un grupo de subprocesos asíncronos que tiene un tamaño de 1 cuando se ejecuta la compilación y aumenta al tamaño especificado por esta marca cuando el servidor está inactivo.
Etiquetas:host_machine_resource_optimizations
,execution
- Valor predeterminado de
--experimental_sandbox_enforce_resources_regexp=<a valid Java regular expression>
: "" -
Si es verdadero, las acciones cuyo mnemónico coincida con la regex de entrada tendrán su solicitud de recursos aplicada como límites, lo que anulará el valor de --experimental_sandbox_limits, si el tipo de recurso lo admite. Por ejemplo, una prueba que declara cpu:3 y resources:memory:10 se ejecutará con un máximo de 3 CPUs y 10 megabytes de memoria.
Etiquetas:execution
- Se acumulan los usos múltiples de
--experimental_sandbox_limits=<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">
-
Si es > 0, cada zona de pruebas de Linux se limitará a la cantidad indicada para el recurso especificado. Requiere --incompatible_use_new_cgroup_implementation y anula --experimental_sandbox_memory_limit_mb. Requiere cgroups v1 o v2 y permisos para que los usuarios accedan al directorio de cgroups.
Etiquetas:execution
--experimental_sandbox_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
predeterminado: "0"-
Si es > 0, cada zona de pruebas de Linux se limitará a la cantidad de memoria indicada (en MB). Requiere cgroups v1 o v2 y permisos para que los usuarios accedan al directorio de cgroups.
Etiquetas:execution
--[no]experimental_shrink_worker_pool
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 se habilita la marca experimental_total_worker_memory_limit_mb.
Etiquetas:execution
,host_machine_resource_optimizations
--[no]experimental_split_xml_generation
predeterminado: "true"-
Si se configura esta marca y una acción de prueba no genera un archivo test.xml, Bazel usa una acción separada para generar un archivo test.xml ficticio que contiene el registro de la prueba. De lo contrario, Bazel genera un archivo test.xml como parte de la acción de prueba.
Etiquetas:execution
--experimental_total_worker_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
predeterminado: "0"-
Si este límite es mayor que cero, es posible que se eliminen los trabajadores inactivos si el uso total de memoria de todos los trabajadores supera el límite.
Etiquetas:execution
,host_machine_resource_optimizations
--[no]experimental_use_hermetic_linux_sandbox
predeterminado: "false"-
Si se establece como verdadero, no se activará la raíz, solo se activará lo que se proporcione con sandbox_add_mount_pair. Los archivos de entrada se vincularán de forma rígida a la zona de pruebas en lugar de vincularse de forma simbólica desde la zona de pruebas. Si los archivos de entrada de la acción se encuentran en un sistema de archivos diferente del 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, también se usa el semáforo para limitar la cantidad de trabajos simultáneos.
Etiquetas:host_machine_resource_optimizations
,execution
--[no]experimental_use_windows_sandbox
predeterminado: "false"-
Usa el espacio aislado de Windows para ejecutar acciones. Si la respuesta es "sí", el archivo binario proporcionado por --experimental_windows_sandbox_path debe ser válido y corresponder a una versión compatible de sandboxfs. Si es "auto", es posible que falte el objeto binario o que no sea compatible.
Etiquetas:execution
--experimental_windows_sandbox_path=<a string>
default: "BazelSandbox.exe"-
Ruta de acceso al objeto binario de la zona de pruebas de Windows que se usará cuando --experimental_use_windows_sandbox sea verdadero. Si es un nombre simple, usa el primer binario de ese nombre que se encuentre en PATH.
Etiquetas:execution
--experimental_worker_allowlist=<comma-separated set of options>
valor predeterminado: consulta la descripción-
Si no está vacío, solo permite usar trabajadores persistentes con la mnemónica de clave de trabajador determinada.
Etiquetas:execution
,host_machine_resource_optimizations
--[no]experimental_worker_cancellation
predeterminado: "false"-
Si se habilita, Bazel puede enviar solicitudes de cancelación a los trabajadores que las admitan.
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 detengan 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 se bloquee tu compilación.
Etiquetas:execution
,host_machine_resource_optimizations
--experimental_worker_metrics_poll_interval=<An immutable length of time.>
predeterminado: "5s"-
Es el intervalo entre la recopilación de métricas de los trabajadores y el posible intento de desalojo. Por motivos de rendimiento, no puede ser inferior a 1 s de manera efectiva.
Etiquetas:execution
,host_machine_resource_optimizations
--[no]experimental_worker_multiplex_sandboxing
predeterminado: "false"-
Si está habilitado, los trabajadores de multiplexación con un requisito de ejecución "supports-multiplex-sandboxing" se ejecutarán en un entorno de zona de pruebas, con un directorio de zona de pruebas independiente por solicitud de trabajo. Los trabajadores de multiplexación con el requisito de ejecución siempre se ejecutan en un entorno de pruebas cuando se ejecutan con la estrategia de ejecución dinámica, independientemente de esta marca.
Etiquetas:execution
--[no]experimental_worker_sandbox_hardening
predeterminado: "false"-
Si está habilitado, los trabajadores se ejecutan en una zona de pruebas reforzada, si la implementación lo permite. Si el refuerzo está habilitado, los directorios tmp son distintos para los diferentes trabajadores.
Etiquetas:execution
- Se acumulan los usos múltiples de
--experimental_worker_sandbox_inmemory_tracking=<a string>
-
Es una mnemónica de clave de trabajador para la que se hace un seguimiento del contenido del directorio de zona de pruebas en la memoria. Esto puede mejorar el rendimiento de la compilación a costa de un mayor uso de memoria. Solo afecta a los trabajadores en zona de pruebas. Se puede especificar varias veces para diferentes mnemónicos.
Etiquetas:execution
--[no]experimental_worker_strict_flagfiles
predeterminado: "false"-
Si está habilitado, los argumentos de acciones para los trabajadores que no sigan 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
--genrule_strategy=<comma-separated list of options>
: "" -
Especifica cómo ejecutar genrules. Esta marca se dará de baja. 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_sandbox_hermetic_tmp
predeterminado: "true"-
Si se configura 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 directorio /tmp del host en todos los espacios de pruebas.
Etiquetas:execution
--[no]incompatible_use_new_cgroup_implementation
predeterminado: "false"-
Si es verdadero, usa la nueva implementación para cgroups. La implementación anterior solo admite el controlador de memoria y no tiene en cuenta el valor de --experimental_sandbox_limits.
Etiquetas:execution
--[no]internal_spawn_scheduler
predeterminado: "true"-
Opción de marcador de posición para que podamos saber en Blaze si se habilitó el programador de spawn.
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
] default: "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"), seguido de forma opcional por 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 lo más posible después de un error. Si bien no se pueden analizar el destino que falló ni los que dependen de él, sí se pueden analizar otros requisitos previos de estos destinos.
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 paralelos 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”), seguida opcionalmente 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 verdadero, los directorios que usa la ejecución no de trabajador en zona de pruebas se pueden reutilizar 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 debajo de esta ruta. Especifica una ruta de acceso en tmpfs (como /run/shm) para posiblemente mejorar mucho el rendimiento cuando tu compilación o tus pruebas tengan muchos archivos de entrada. Nota: Necesitas suficiente RAM y espacio libre en tmpfs para almacenar los archivos intermedios y de salida que se generan cuando se ejecutan las acciones.
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 establezca 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 que se usen otros grupos.
Etiquetas:execution
- Se acumulan los usos múltiples de
--sandbox_tmpfs_path=<an absolute path>
-
Para las acciones en zona de pruebas, activa un directorio vacío y con permisos de escritura en esta ruta de acceso absoluta (si la implementación de zona de pruebas lo admite; de lo contrario, se ignora).
Etiquetas:host_machine_resource_optimizations
,execution
--[no]skip_incompatible_explicit_targets
predeterminado: "false"-
Omite los destinos incompatibles que se indican de forma explícita en la línea de comandos. De forma predeterminada, la compilación de estos 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 generación de forma predeterminada. Acepta una lista de estrategias separadas por comas, de mayor a menor prioridad. Para cada acción, Bazel elige la estrategia con la prioridad más alta que puede ejecutarla. 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 los usos múltiples de
--strategy=<a '[name=]value1[,..,valueN]' assignment>
-
Especifica cómo distribuir la compilación de otras acciones de spawn. 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 ejecutarla. El valor predeterminado es "remote,worker,sandboxed,local". Esta marca anula los valores establecidos por --spawn_strategy (y --genrule_strategy si se usa con el mnemónico Genrule). Consulta https://blog.bazel.build/2019/06/19/list-strategy.html para obtener más información.
Etiquetas:execution
- Se acumulan los usos múltiples de
--strategy_regexp=<a '<RegexFilter>=value[,value]' assignment>
-
Anula qué estrategia de generación se debe usar para ejecutar acciones de generación que tengan descripciones que coincidan con un regex_filter determinado. Consulta --per_file_copt para obtener detalles sobre la coincidencia de regex_filter. Se usa el último regex_filter que coincide con la descripción. Esta opción anula otras marcas para especificar la estrategia. Ejemplo: --strategy_regexp=//foo.*\.cc,-//foo/bar=local significa que se ejecutarán 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 los usos múltiples de
--worker_extra_flag=<a 'name=value' assignment>
-
Marcas de comandos adicionales que se pasarán a los procesos de trabajadores además de --persistent_worker, con clave por mnemónico (p.ej., --worker_extra_flag=Javac=--debug).
Etiquetas:execution
,host_machine_resource_optimizations
- Se acumulan los usos múltiples 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">
-
Cantidad de instancias de cada tipo de trabajador persistente que se pueden iniciar si usas la estrategia "worker". Se puede especificar como [name=value] para asignar un valor diferente por mnemónico. El límite se basa en las claves de trabajador, que se diferencian según la mnemónica, 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ónica de lo que especifica esta marca. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), seguido de forma opcional por 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 las mnemónicas no especificadas.
Etiquetas:execution
,host_machine_resource_optimizations
- Se acumulan los usos múltiples 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">
-
Cantidad de WorkRequests que un proceso de trabajador de multiplexación puede recibir en paralelo si usas la estrategia "worker" con --worker_multiplex. Se puede especificar como [name=value] para asignar un valor diferente por mnemónico. El límite se basa en las claves de trabajador, que se diferencian según la mnemónica, 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ónica de lo que especifica esta marca. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), seguido de forma opcional por 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 las mnemónicas no especificadas.
Etiquetas:execution
,host_machine_resource_optimizations
--[no]worker_multiplex
predeterminado: "true"-
Si está habilitada, los trabajadores usarán la multiplexación si la admiten.
Etiquetas:execution
,host_machine_resource_optimizations
--[no]worker_quit_after_build
predeterminado: "false"-
Si está habilitado, todos los trabajadores se detienen 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 de singleplex se ejecutarán en un entorno de zona de pruebas. Los trabajadores de Singleplex siempre se ejecutan en un espacio aislado cuando se ejecutan con la estrategia de ejecución dinámica, independientemente de esta marca.
Etiquetas:execution
--[no]worker_verbose
predeterminado: "false"- Si está habilitado, imprime mensajes detallados cuando se inician, detienen, etc., los trabajadores.
- Opciones que controlan el resultado del comando:
--[no]build
predeterminado: "true"-
Ejecuta la compilación. Este es el comportamiento habitual. Si se especifica --nobuild, la compilación se detiene antes de ejecutar las acciones de compilación y devuelve 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 paralelismo con las pruebas).
Etiquetas:execution
,affects_outputs
- Se acumulan los usos múltiples 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 + o -. Los grupos con el prefijo + se agregan al conjunto predeterminado de grupos de salida, mientras que los grupos con el prefijo - se quitan 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"-
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
- Valor predeterminado de
--serialized_frontier_profile=<a string>
: "" -
Volca un perfil de bytes de frontera serializados. Especifica la ruta de acceso de salida.
Etiquetas:bazel_monitoring
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, a diferencia de su existencia:
- Se acumulan los usos múltiples de
--aspects=<comma-separated list of options>
- Lista separada por comas de los aspectos 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 satisfagan los proveedores de aspectos obligatorios de some_aspect. Además, some_aspect se ejecutará después de todos los aspectos requeridos 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
- Valor predeterminado de
--bep_maximum_open_remote_upload_files=<an integer>
: "-1" -
Es la cantidad máxima de archivos abiertos permitidos durante la carga de artefactos del BEP.
Etiquetas:affects_outputs
--[no]experimental_convenience_symlinks
predeterminado: "normal"-
Esta marca controla cómo se administrarán los vínculos simbólicos de conveniencia (los vínculos simbólicos que aparecen en el espacio de trabajo después de la compilación). Valores posibles:
normal (predeterminado): Se creará o borrará cada tipo de vínculo simbólico de conveniencia, según lo determine la compilación.
clean: Se borrarán todos los vínculos simbólicos de forma incondicional.
ignore: No se crearán ni limpiarán symlinks.
log_only: Genera mensajes de registro como si se hubiera pasado "normal", pero no realiza ninguna operación del sistema de archivos (útil para las herramientas).
Ten en cuenta que solo se pueden afectar los vínculos simbólicos cuyos nombres se generen con el valor actual de --symlink_prefix. Si cambia el prefijo, los vínculos simbólicos preexistentes no se modificarán.
Etiquetas:affects_outputs
--[no]experimental_convenience_symlinks_bep_event
predeterminado: "true"-
Esta marca controla si publicaremos el evento ConvenienceSymlinksIdentified de compilación en BuildEventProtocol. Si el valor es verdadero, BuildEventProtocol tendrá una entrada para convenienceSymlinksIdentified, en la que se enumerarán todos los vínculos simbólicos de conveniencia creados en tu espacio de trabajo. Si es falso, la entrada convenienceSymlinksIdentified en BuildEventProtocol estará vacía.
Etiquetas:affects_outputs
--remote_download_all
-
Descarga todos los resultados remotos en la máquina local. Esta marca es un alias de --remote_download_outputs=all.
Se expande a:
--remote_download_outputs=all
Etiquetas:affects_outputs
--remote_download_minimal
-
No descarga ningún resultado de compilación remota en la máquina local. Esta marca es un alias de --remote_download_outputs=minimal.
Se expande a:
--remote_download_outputs=minimal
Etiquetas:affects_outputs
--remote_download_outputs=<all, minimal or toplevel>
predeterminado: "toplevel"-
Si se configura como "mínimo", no se descargan los resultados de compilación remotos en la máquina local, excepto los que requieren las acciones locales. Si se configura como "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
- Valor predeterminado de
--remote_download_symlink_template=<a string>
: "" -
En lugar de descargar los resultados de compilación remota 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. Por ejemplo, estos vínculos simbólicos pueden apuntar a un sistema de archivos FUSE que carga objetos del CAS a pedido.
Etiquetas:affects_outputs
--remote_download_toplevel
-
Solo descarga los resultados remotos de los 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
--symlink_prefix=<a string>
valor predeterminado: consulta la descripción-
Es el prefijo que se antepone a cualquiera de los vínculos simbólicos 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 vínculos simbólicos y no se emite ninguna advertencia. Advertencia: La funcionalidad especial para "/" dejará de estar disponible pronto. En su lugar, usa --experimental_convenience_symlinks=ignore.
Etiquetas:affects_outputs
- Opciones que afectan la rigidez con la que Bazel aplica las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
--[no]experimental_docker_privileged
predeterminado: "false"-
Si está habilitado, Bazel pasará la marca --privileged a "docker run" cuando ejecute acciones. Tu compilación podría requerir esto, pero también podría reducir la hermeticidad.
Etiquetas:execution
--[no]experimental_sandboxfs_map_symlink_targets
predeterminado: "false"-
No-op
Etiquetas:host_machine_resource_optimizations
,execution
--[no]incompatible_legacy_local_fallback
predeterminado: "false"-
Si se configura como verdadero, se habilita la estrategia de resguardo implícito heredada de la estrategia local a la de zona de pruebas. Con el tiempo, esta marca se establecerá de forma predeterminada como falsa y, luego, se convertirá en una operación sin efecto. En su lugar, usa --strategy, --spawn_strategy o --dynamic_local_strategy para configurar las reversiones.
Etiquetas:execution
,incompatible_change
- Se acumulan los usos múltiples 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 los usos múltiples de
--sandbox_block_path=<a string>
-
En el caso de las acciones en zona de pruebas, no permitas el acceso a esta ruta.
Etiquetas:execution
--[no]sandbox_default_allow_network
predeterminado: "true"-
Permite el acceso a la red de forma predeterminada para las acciones. Es posible que esto no funcione con todas las implementaciones de zona de pruebas.
Etiquetas:execution
--[no]sandbox_fake_hostname
predeterminado: "false"-
Cambia el nombre de host actual a "localhost" para las acciones en zona de pruebas.
Etiquetas:execution
--[no]sandbox_fake_username
predeterminado: "false"-
Cambia el nombre de usuario actual a "nobody" para las acciones en zona de pruebas.
Etiquetas:execution
- Se acumulan los usos múltiples de
--sandbox_writable_path=<a string>
-
En el caso de las acciones en zona de pruebas, haz que un directorio existente se pueda escribir en la zona de pruebas (si la implementación de la zona de pruebas lo admite; de lo contrario, se ignora).
Etiquetas:execution
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility
predeterminado: "false"-
Si incompatible_enforce_config_setting_visibility=false, esta es una operación nula. 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, se aplican 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_use_plus_in_repo_names
predeterminado: "true"-
No-op.
Etiquetas:loading_and_analysis
- Opciones que rigen el comportamiento del entorno de prueba o del ejecutor de pruebas:
--[no]check_tests_up_to_date
predeterminado: "false"-
No ejecuta pruebas, solo verifica si están actualizadas. Si todos los resultados de las pruebas están actualizados, la prueba se completa correctamente. Si se debe compilar o ejecutar alguna prueba, se informa un error y falla la prueba. Esta opción implica el comportamiento de --check_up_to_date.
Etiquetas:execution
- Se acumulan los usos múltiples de
--flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once>
-
Cada prueba se reintentará hasta la cantidad especificada de veces en caso de que falle. Las pruebas que requirieron más de un intento para aprobarse se marcan como "INESTABLES" 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 se establece en "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. Aquí flaky_test_attempts es como se explicó anteriormente y regex_filter representa una lista de patrones de expresiones regulares de inclusión y exclusión (consulta también --runs_per_test). Ejemplo: --flaky_test_attempts=//foo/.*,-//foo/bar/.*@3 elimina la inestabilidad de todas las pruebas en //foo/ excepto las que se encuentran en foo/bar tres veces. Esta opción se puede pasar varias veces. Tiene prioridad el argumento que se pasó más recientemente y que coincide. Si no hay coincidencias, el comportamiento es como el de "predeterminado" anterior.
Etiquetas:execution
--local_test_jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
predeterminado: "auto"-
Es la cantidad máxima de trabajos de prueba locales que se pueden ejecutar de forma simultánea. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), seguido de forma opcional por una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". El valor 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 en un número mayor que el valor de --jobs no tiene ningún efecto.
Etiquetas:execution
--[no]test_keep_going
predeterminado: "true"-
Cuando se inhabilita, cualquier prueba que no pase 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 se debe usar cuando se ejecutan pruebas.
Etiquetas:execution
--test_tmpdir=<a path>
valor predeterminado: consulta la descripción- Especifica el directorio temporal base que usará "bazel test".
- 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 se establece en 0, se garantiza la corrección, ya que no todos los cambios en los archivos se pueden observar a partir de los metadatos de los archivos. 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 la caché.
--[no]experimental_cpu_load_scheduling
predeterminado: "false"-
Habilita la programación experimental de la ejecución local basada en la carga de la CPU, no en la estimación de acciones una por una. La programación experimental demostró el gran beneficio en compilaciones locales grandes en máquinas potentes con una gran cantidad de núcleos. Se recomienda usar con --local_resources=cpu=HOST_CPUS
Etiquetas:execution
--experimental_dynamic_ignore_local_signals=<a comma-separated list of signal numbers>
valor predeterminado: consulta la descripción-
Toma una lista de números de indicadores del SO. Si una rama local de la ejecución dinámica se interrumpe con cualquiera de estos indicadores, se permitirá que la rama remota finalice. En el caso de los trabajadores persistentes, esto solo afecta a los indicadores que detienen el proceso del trabajador.
Etiquetas:execution
--[no]experimental_enable_skyfocus
predeterminado: "false"-
Si es verdadero, habilita el uso de --experimental_working_set para reducir el uso de memoria de Bazel en las compilaciones incrementales. Esta función se conoce como Enfoque en el cielo.
Etiquetas:host_machine_resource_optimizations
- Valor predeterminado de
--experimental_working_set=<comma-separated list of options>
: "" -
Es el conjunto de trabajo de Skyfocus. Especifica las rutas de acceso relativas a la raíz del espacio de trabajo separadas por comas. Esta es una marca con estado. Definir un conjunto de trabajo lo conserva para invocaciones posteriores, hasta que se redefine con un conjunto nuevo.
Etiquetas:host_machine_resource_optimizations
--local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>
predeterminado: "HOST_CPUS"-
Establece de forma explícita la cantidad total de núcleos de CPU locales disponibles para que Bazel los use en las acciones de compilación que se ejecutan de forma local. Toma un número entero o "HOST_CPUS", seguido de forma opcional por [-|*]<float> (p. ej., HOST_CPUS*.5 para usar la mitad de los núcleos de CPU disponibles). De forma predeterminada, ("HOST_CPUS"), Bazel consultará la configuración del sistema para estimar la cantidad de núcleos de CPU disponibles.
Etiquetas:host_machine_resource_optimizations
- Se acumulan los usos múltiples de
--local_extra_resources=<a named float, 'name=value'>
-
Establece la cantidad de recursos adicionales disponibles para Bazel. Toma un par de cadena y 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:<resoucename>:<amount>". Con esta marca, no se pueden establecer la CPU, la RAM ni los recursos disponibles.
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 use en las acciones de compilación que se ejecutan de forma local. Toma un número entero o "HOST_RAM", seguido de forma opcional por [-|*]<float> (p. ej., HOST_RAM*.5 para usar la mitad de la RAM disponible). De forma predeterminada, ("HOST_RAM*.67"), Bazel consultará la configuración del sistema para estimar la cantidad de RAM disponible y usará el 67% de ella.
Etiquetas:host_machine_resource_optimizations
- Se acumulan los usos múltiples 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. Toma una asignación a un valor de coma flotante o HOST_RAM/HOST_CPUS, seguido opcionalmente por [-|*]<float> (p. ej., memory=HOST_RAM*.5 para usar la mitad de la RAM disponible). Se puede usar varias veces para especificar varios tipos de recursos. Bazel limitará las acciones que se ejecutan de forma simultánea según los recursos disponibles y los recursos 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
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Valor predeterminado de
--build_event_upload_max_retries=<an integer>
: "4" -
Es la cantidad máxima de veces que Bazel debe reintentar subir un evento de compilación.
Etiquetas:bazel_internal_configuration
--[no]debug_spawn_scheduler
predeterminado: "false"--[no]experimental_bep_target_summary
predeterminado: "false"- Indica si se publicarán eventos de TargetSummary.
--[no]experimental_build_event_expand_filesets
predeterminado: "false"-
Si es verdadero, expande los archivos Filesets 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 por completo los vínculos simbólicos relativos de Fileset en el BEP cuando se presentan los archivos de salida. Requiere --experimental_build_event_expand_filesets.
Etiquetas:affects_outputs
- Se acumulan los usos múltiples de
--experimental_build_event_output_group_mode=<an output group name followed by an OutputGroupFileMode, e.g. default=both>
-
Especifica cómo se representarán los archivos de un grupo de salida en los eventos BEP de TargetComplete/AspectComplete. Los valores son una asignación de un nombre de grupo de salida a uno de los siguientes: "NAMED_SET_OF_FILES_ONLY", "INLINE_ONLY" o "BOTH". El valor predeterminado es "NAMED_SET_OF_FILES_ONLY". Si se repite un grupo de salida, se usa el valor final que aparece. El valor predeterminado establece el modo de los artefactos de cobertura en BOTH: --experimental_build_event_output_group_mode=baseline.lcov=both
Etiquetas:affects_outputs
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
predeterminado: "1s"-
Es la demora inicial y mínima para los reintentos de retirada exponencial cuando falla la carga del BEP. (exponente: 1.6)
Etiquetas:bazel_internal_configuration
--experimental_build_event_upload_strategy=<a string>
valor 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_docker_verbose
predeterminado: "false"-
Si se habilita, Bazel imprimirá mensajes más detallados sobre la estrategia de zona de pruebas de Docker.
Etiquetas:execution
--[no]experimental_materialize_param_files_directly
predeterminado: "false"-
Si materializas archivos de parámetros, hazlo con escrituras directas en el disco.
Etiquetas:execution
- Valor predeterminado de
--experimental_repository_resolved_file=<a string>
: "" -
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
--experimental_skyfocus_dump_keys=<none, count or verbose>
predeterminado: "none"-
Para depurar Skyfocus. Volca las SkyKeys enfocadas (raíces, hojas, dependencias enfocadas, dependencias inversas enfocadas).
Etiquetas:terminal_output
--[no]experimental_skyfocus_dump_post_gc_stats
predeterminado: "false"-
Para depurar Skyfocus. Si está habilitado, activa la GC manual antes o después de enfocar para informar las reducciones en los tamaños del montón. Esto aumentará la latencia de Skyfocus.
Etiquetas:terminal_output
--experimental_skyfocus_handling_strategy=<strict or warn>
predeterminado: "strict"-
Estrategias para que Skyfocus maneje los cambios fuera del conjunto de trabajo.
Etiquetas:eagerness_to_exit
--[no]experimental_stream_log_file_uploads
predeterminado: "false"-
Transmite las cargas de archivos de registro directamente al almacenamiento remoto en lugar de escribirlas en el disco.
Etiquetas:affects_outputs
--explain=<a path>
valor predeterminado: consulta la descripción-
Hace que el sistema de compilación explique cada paso ejecutado de la compilación. La explicación se escribe en el archivo de registro especificado.
Etiquetas:affects_outputs
--[no]ignore_unsupported_sandboxing
predeterminado: "false"-
No se imprime una advertencia cuando la ejecución en zona de pruebas no es compatible con este sistema.
Etiquetas:terminal_output
--[no]legacy_important_outputs
predeterminado: "false"-
Úsalo para suprimir la generación del campo legacy important_outputs en el evento TargetComplete. Los important_outputs son necesarios para la integración de Bazel en ResultStore/BTX.
Etiquetas:affects_outputs
--[no]materialize_param_files
predeterminado: "false"-
Escribe archivos de parámetros intermedios en el árbol de salida, incluso cuando se usa la ejecución de acciones remotas. Es útil cuando se depuran acciones. Esto se infiere de --subcommands y --verbose_failures.
Etiquetas:execution
--max_config_changes_to_show=<an integer>
valor predeterminado: "3"-
Cuando se descarta la caché de análisis debido a un cambio en las opciones de compilación, se muestran hasta la cantidad determinada de nombres de opciones modificadas. Si el número proporcionado es -1, se mostrarán todas las opciones modificadas.
Etiquetas:terminal_output
- Valor predeterminado de
--max_test_output_bytes=<an integer>
: "-1" -
Especifica el tamaño máximo por registro de prueba que 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 demasiado ruidoso. 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>
valor predeterminado: consulta la descripción-
Solo muestra advertencias y resultados de acciones para las 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"-
Cantidad de segundos que se debe esperar entre los informes sobre los trabajos que aún se están ejecutando. El valor predeterminado 0 significa que el primer informe se imprimirá después de 10 segundos, luego de 30 segundos y, después de eso, el progreso se informará una vez por minuto. Cuando se habilita --curses, el progreso se informa cada segundo.
Etiquetas:affects_outputs
--remote_print_execution_messages=<failure, success or all>
predeterminado: "failure"-
Elige cuándo imprimir los mensajes de ejecución remota. Los valores válidos son "failure" para imprimir solo en caso de errores, "success" para imprimir solo en caso de éxito y "all" para imprimir siempre.
Etiquetas:terminal_output
--[no]sandbox_debug
predeterminado: "false"-
Habilita las funciones de depuración para la función de zona de pruebas. Esto incluye dos aspectos: primero, el contenido raíz de la zona de pruebas no se modifica después de una compilación y, segundo, se imprime información de depuración adicional durante la ejecución. Esto puede ayudar a los desarrolladores de reglas de Bazel o Starlark a depurar errores debido a la falta de archivos de entrada, etc.
Etiquetas:terminal_output
--show_result=<an integer>
valor predeterminado: "1"-
Muestra los resultados de la compilación. Para cada destino, indica si se actualizó o no y, si es así, proporciona una lista de los archivos de salida que se compilaron. Los archivos impresos son cadenas convenientes para copiar y pegar en el shell y ejecutarlos.
Esta opción requiere un argumento de número entero, que es la cantidad límite de objetivos por encima de la cual no se imprime la información de los resultados. Por lo tanto, el cero hace que se suprima el mensaje y MAX_INT hace que siempre se imprima el resultado. El valor predeterminado es uno.
Si no se compiló nada para un destino, es posible que se omitan sus resultados para mantener el resultado por debajo del umbral.
Etiquetas:affects_outputs
--[no]subcommands
[-s
] predeterminado: "false"-
Muestra los subcomandos que se ejecutaron durante una compilación. Marcas relacionadas: --execution_log_json_file, --execution_log_binary_file (para registrar subcomandos en un archivo con 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 generar solo el resumen del estado de la prueba, "errors" para imprimir también los registros de las pruebas fallidas, "all" para imprimir los registros de todas las pruebas y "streamed" para generar los registros de todas las pruebas en tiempo real (esto forzará la ejecución de las pruebas de forma local 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 fallidas que se ejecutaron, "detailed" para imprimir información detallada sobre los casos de prueba fallidos, "testcase" para imprimir un resumen en la resolución del caso de prueba, no imprimir información detallada sobre los casos de prueba fallidos y "none" para omitir el resumen.
Etiquetas:terminal_output
--[no]verbose_explanations
predeterminado: "false"-
Aumenta el nivel de detalle de las explicaciones emitidas si se habilita --explain. No tiene efecto si no se habilita --explain.
Etiquetas:affects_outputs
--[no]verbose_failures
predeterminado: "false"-
Si falla un comando, imprime la línea de comandos completa.
Etiquetas:terminal_output
- Opciones que especifican o alteran una entrada genérica para un comando de Bazel que no se incluye en otras categorías.:
- Se acumulan los usos múltiples 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 a través de <param_name>=<param_value>, por ejemplo, "my_param=my_val", donde "my_param" es un parámetro de algún aspecto en la lista --aspects o es requerido por un aspecto en 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
--target_pattern_file=<a string>
: "" -
Si se configura, la compilación leerá los patrones del archivo que se menciona aquí, en lugar de hacerlo desde la línea de comandos. Es un error especificar un archivo aquí y patrones de línea de comandos.
Etiquetas:changes_inputs
- Opciones de almacenamiento en caché y ejecución remotos:
--experimental_circuit_breaker_strategy=<failure>
valor predeterminado: consulta la descripción-
Especifica la estrategia que usará el disyuntor. Las estrategias disponibles son "failure". Si el valor de la opción no es válido, el comportamiento es el mismo que si la opción no estuviera configurada.
Etiquetas:execution
--[no]experimental_guard_against_concurrent_changes
predeterminado: "false"- Desactiva esta opción para inhabilitar la verificación de la hora de creación de los archivos de entrada de una acción antes de subirlos 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.
--experimental_remote_cache_compression_threshold=<an integer>
valor predeterminado: "100"- Es el tamaño mínimo de BLOB requerido para comprimir o descomprimir con zstd. No tiene efecto a menos que se establezca --remote_cache_compression.
--experimental_remote_cache_eviction_retries=<an integer>
predeterminado: "5"-
Es la cantidad máxima de reintentos si la compilación encontró un error transitorio de caché remota que, de lo contrario, haría que fallara la compilación. Se aplica, por ejemplo, cuando los artefactos se expulsan 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 verifica el código de salida 39.
Etiquetas:execution
--[no]experimental_remote_cache_lease_extension
predeterminado: "false"- Si se configura como verdadero, Bazel extenderá el arrendamiento de los resultados de las acciones remotas durante la compilación enviando llamadas a `FindMissingBlobs` periódicamente a la caché remota. La frecuencia se basa en el valor de `--experimental_remote_cache_ttl`.
--experimental_remote_cache_ttl=<An immutable length of time.>
predeterminado: "3h"-
Es el TTL mínimo garantizado de los BLOBs en la caché remota después de que se hace referencia a sus resúmenes recientemente, p.ej., por un ActionResult o FindMissingBlobs. Bazel realiza varias optimizaciones basadas en el TTL de los BLOB, p.ej., no llama a GetActionResult de forma repetida en una compilación incremental. El valor debe establecerse un poco menos que el TTL real, ya que hay una brecha entre el momento en que el servidor devuelve los resúmenes y el momento en que Bazel los recibe.
Etiquetas:execution
--experimental_remote_capture_corrupted_outputs=<a path>
valor predeterminado: consulta la descripción- Es la ruta de acceso a un directorio en el que se capturarán los resultados dañados.
--[no]experimental_remote_discard_merkle_trees
predeterminado: "true"- Si se configura como 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 calcularlos en caso de errores de caché remota y reintentos.
--experimental_remote_downloader=<a string>
valor predeterminado: consulta la descripción- Es el URI de un 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 ningún 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_downloader_propagate_credentials
predeterminado: "false"- Indica si se propagarán las credenciales de netrc y del auxiliar de credenciales al servidor de descarga remota. La implementación del servidor debe admitir el nuevo calificador `http_header_url:<url-index>:<header-key>`, en el que `<url-index>` es una posición basada en 0 de la URL dentro del campo `uris` de FetchBlobRequest. Los encabezados específicos de la URL deben tener prioridad sobre los encabezados globales.
--[no]experimental_remote_execution_keepalive
predeterminado: "false"- Indica si se debe usar keepalive para las llamadas de ejecución remota.
--experimental_remote_failure_rate_threshold=<an integer in 0-100 range>
predeterminado: "10"-
Establece la cantidad permitida de tasa de errores en porcentaje 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 se establece en 0, significa que no hay limitación.
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 del error 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 aciertos de la caché remota. La huella de 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 memoizar para mejorar la velocidad de verificación de aciertos de caché remota. Aunque la caché se reduce automáticamente según el control de referencias débiles de Java, pueden producirse errores de memoria insuficiente si se establece 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. El valor predeterminado es 1,000.
--experimental_remote_output_service=<a string>
valor predeterminado: consulta la 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 ningún esquema, Bazel usará grpcs de forma predeterminada. Especifica el esquema grpc:// o unix: para inhabilitar TLS.
- Valor predeterminado de
--experimental_remote_output_service_output_path_prefix=<a string>
: "" - Es la ruta de acceso en la que se coloca el contenido de los directorios de salida administrados por --experimental_remote_output_service. El directorio de salida real que usa una compilación será un elemento secundario de esta ruta y lo determinará el servicio de salida.
--[no]experimental_remote_require_cached
predeterminado: "false"- Si se establece en verdadero, se exige que todas las acciones que se pueden ejecutar de forma remota se almacenen en caché; de lo contrario, la compilación fallará. 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 sin insertar de forma espuria resultados nuevos en la caché.
--experimental_remote_scrubbing_config=<Converts to a Scrubber>
valor predeterminado: consulta la descripción- Habilita la limpieza remota de claves de caché con el archivo de configuración proporcionado, que debe ser un búfer de protocolo en formato de texto (consulta src/main/protobuf/remote_scrubbing.proto). Esta función tiene como objetivo facilitar el uso compartido de una caché remota o de disco entre acciones que se ejecutan en diferentes plataformas, pero que tienen como objetivo la misma plataforma. Se debe usar con mucho cuidado, ya que los parámetros de configuración incorrectos pueden provocar el uso compartido accidental de entradas de caché y generar compilaciones incorrectas. El scrubbing 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 de disco para recuperar o almacenar el resultado de una acción. Las acciones depuradas no son compatibles con la ejecución remota y siempre se ejecutarán de forma local. La modificación de la configuración de limpieza no invalida los resultados presentes en el sistema de archivos local ni en las memorias caché 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_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 del 34 si los errores de caché remota, incluidas las expulsiones de caché, provocan que falle la compilación.
Etiquetas:incompatible_change
--[no]remote_accept_cached
predeterminado: "true"- Indica si se deben aceptar los resultados de acciones almacenados en caché de forma remota.
--remote_build_event_upload=<all or minimal>
predeterminado: "minimal"- Si se configura como "all", todos los resultados locales a los que hace referencia el BEP se suben a la caché remota. Si se establece en "mínimo", los resultados locales a los que se hace referencia en BEP no se suben a la caché remota, excepto los archivos que son importantes para los consumidores de BEP (p.ej., registros de pruebas y perfil de sincronización). El esquema bytestream:// siempre se usa para la URI de los archivos, incluso si faltan en la caché remota. El valor predeterminado es "minimal".
--remote_bytestream_uri_prefix=<a string>
valor 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 configurar cuando las compilaciones se realizan con un proxy, lo que hace que los valores de --remote_executor y --remote_instance_name ya no correspondan al nombre canónico del servicio de ejecución remota. Si no se configura, el valor predeterminado será “${hostname}/${instance_name}”.
--remote_cache=<a string>
valor predeterminado: consulta la descripción- Es el URI de un extremo de almacenamiento en caché. Los esquemas admitidos son http, https, grpc, grpcs (grpc con TLS habilitado) y unix (sockets locales de UNIX). Si no se proporciona ningún 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_async
predeterminado: "true"- Si es verdadero, la carga de los resultados de la acción en un disco o en una caché remota se realizará en segundo plano en lugar de bloquear la finalización de una acción. Algunas acciones son incompatibles con las cargas en segundo plano y es posible que se bloqueen incluso cuando se establece esta marca.
--[no]remote_cache_compression
predeterminado: "false"- Si está habilitado, comprime o descomprime los BLOB de caché con zstd cuando su tamaño sea al menos --experimental_remote_cache_compression_threshold.
- Se acumulan los usos múltiples de
--remote_cache_header=<a 'name=value' assignment>
- Especifica un encabezado que se incluirá en las solicitudes de caché: --remote_cache_header=Name=Value. Se pueden pasar varios encabezados especificando la marca varias veces. Los valores múltiples para el mismo nombre se convertirán en una lista separada por comas.
- Se acumulan los usos múltiples 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
- Valor predeterminado de
--remote_default_platform_properties=<a string>
: "" - Establece las propiedades de la plataforma predeterminada que se configurará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 la plataforma host se selecciona como la plataforma de ejecución para la ejecución remota.
- Se acumulan los usos múltiples de
--remote_download_regex=<a valid Java regular expression>
-
Fuerza la descarga de los resultados de 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 los usos múltiples de
--remote_downloader_header=<a 'name=value' assignment>
- Especifica un encabezado que se incluirá en las solicitudes del descargador remoto: --remote_downloader_header=Name=Value. Se pueden pasar varios encabezados especificando la marca varias veces. Los valores múltiples para el mismo nombre se convertirán en una lista separada por comas.
- Se acumulan los usos múltiples de
--remote_exec_header=<a 'name=value' assignment>
- Especifica un encabezado que se incluirá en las solicitudes de ejecución: --remote_exec_header=Name=Value. Se pueden pasar varios encabezados especificando la marca varias veces. Los valores múltiples para el mismo nombre se convertirán en una lista separada por comas.
--remote_execution_priority=<an integer>
predeterminado: "0"- Es la prioridad relativa de las acciones que se ejecutarán de forma remota. La semántica de los valores de prioridad particulares depende del servidor.
--remote_executor=<a string>
valor 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 ningún esquema, Bazel usará grpcs de forma predeterminada. Especifica el esquema grpc:// o unix: para inhabilitar TLS.
--remote_grpc_log=<a path>
valor predeterminado: consulta la descripción- Si se especifica, es la ruta de acceso a un archivo para registrar detalles relacionados con las llamadas a gRPC. Este registro consta de una secuencia de mensajes .proto serializados com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry, en la que cada mensaje tiene como prefijo un varint que denota el tamaño del siguiente mensaje .proto serializado, como lo realiza el método LogEntry.writeDelimitedTo(OutputStream).
- Se acumulan los usos múltiples de
--remote_header=<a 'name=value' assignment>
- Especifica un encabezado que se incluirá en las solicitudes: --remote_header=Name=Value. Se pueden pasar varios encabezados especificando la marca varias veces. Los valores múltiples para el mismo nombre se convertirán en una lista separada por comas.
- Valor predeterminado de
--remote_instance_name=<a string>
: "" - Es el valor que se pasará como instance_name en la API de ejecución remota.
--[no]remote_local_fallback
predeterminado: "false"- Indica 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"- Obsoleto. Consulta https://github.com/bazelbuild/bazel/issues/7480 para obtener más información.
--remote_max_connections=<an integer>
valor 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, significa que no hay limitación.
En el caso de la caché remota HTTP, una conexión TCP puede controlar una solicitud a la vez, por lo que Bazel puede realizar hasta --remote_max_connections solicitudes simultáneas.
En el caso del ejecutor y la caché remotos de gRPC, un canal de gRPC suele controlar más de 100 solicitudes simultáneas, por lo que Bazel podría realizar alrededor de `--remote_max_connections * 100` solicitudes simultáneas.
Etiquetas:host_machine_resource_optimizations
--remote_proxy=<a string>
valor 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:/ruta/al/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 retirada entre los reintentos remotos. Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
--remote_timeout=<An immutable length of time.>
predeterminado: "60s"- Es la cantidad máxima de tiempo que se espera para las llamadas de ejecución remota y de caché. Para la caché de REST, este es el tiempo de espera de conexión y de lectura. Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
--[no]remote_upload_local_results
predeterminado: "true"- Indica si se deben subir los resultados de las acciones ejecutadas de forma local a la caché remota si esta lo admite y el usuario está autorizado para hacerlo.
--[no]remote_verify_downloads
predeterminado: "true"- Si se configura 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 varias, no clasificadas 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 salga en lugar de continuar con la compilación. Esta opción no tiene ningún efecto cuando también se establece "discard_analysis_cache".
Etiquetas:eagerness_to_exit
--auto_output_filter=<none, all, packages or subpackages>
predeterminado: "none"- Si no se especifica --output_filter, se usa el valor de esta opción para crear un filtro automáticamente. Los valores permitidos son "none" (no filtrar nada / mostrar todo), "all" (filtrar todo / no mostrar nada), "packages" (incluir el resultado de las reglas en los paquetes mencionados en la línea de comandos de Blaze) y "subpackages" (como "packages", pero también incluye subpaquetes). Para los valores "packages" y "subpackages" (//java/foo y //javatests/foo se tratan como un solo paquete).
--[no]build_manual_tests
predeterminado: "false"- Obliga a compilar los destinos de prueba etiquetados como "manuales". Las pruebas "manuales" se excluyen del procesamiento. Esta opción obliga a que se compilen (pero no se ejecuten).
- Valor predeterminado de
--build_tag_filters=<comma-separated list of options>
: "" - Especifica una lista de etiquetas separadas por comas. Cada etiqueta puede ir precedida de un signo "-" 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"; esas pruebas se rigen por las opciones de filtrado de pruebas, por ejemplo, "--test_tag_filters".
--[no]build_tests_only
predeterminado: "false"- Si se especifica, solo se compilarán las reglas *_test y test_suite, y se ignorarán otros destinos especificados en la línea de comandos. De forma predeterminada, se compilará todo lo que se solicitó.
--combined_report=<none or lcov>
predeterminado: "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 argumentos. Esto es útil para verificar la sintaxis de los archivos fuente en los IDE, por ejemplo, recompilando 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 marcas. En lugar de ser destinos para compilar, son nombres de archivos fuente. Para cada nombre de archivo fuente, se compilará un destino arbitrario que dependa de él.
- Se acumulan los usos múltiples de
--deleted_packages=<comma-separated list of package names>
- Es una lista separada por comas de los nombres de los 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 muestre un error si encuentra la etiqueta "//x:y/z" si otra entrada de package_path aún la proporciona. Si especificas --deleted_packages x/y, se evita este problema.
--[no]discard_analysis_cache
predeterminado: "false"- Descarta la caché de análisis inmediatamente después de que finalice la fase de análisis. Reduce el uso de memoria en un 10%, pero hace que las compilaciones incrementales posteriores sean más lentas.
--disk_cache=<a path>
valor predeterminado: consulta la descripción- Es la 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 versión en el archivo binario
--execution_log_binary_file=<a path>
valor predeterminado: consulta la descripción- Registra los comandos spawn 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 significativamente más pequeño y más 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), --subcommands (para mostrar subcomandos en el resultado de la terminal).
--execution_log_compact_file=<a path>
valor predeterminado: consulta la descripción- Registra los comandos spawn 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 binario de protobuf; 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>
valor predeterminado: consulta la descripción- Registra los elementos spawn ejecutados en este archivo como representaciones JSON delimitadas por saltos de línea de protos de SpawnExec, según src/main/protobuf/spawn.proto. Se prefiere --execution_log_compact_file, que es significativamente más pequeño y más económico de producir. Marcas relacionadas: --execution_log_compact_file (formato compacto; mutuamente excluyente), --execution_log_binary_file (formato binario de protobuf; mutuamente excluyente), --execution_log_sort (si se debe ordenar el registro de ejecución), --subcommands (para mostrar subcomandos en la salida 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 diferentes invocaciones. Se establece en falso para evitar un uso potencialmente significativo de la CPU y la memoria al final de la invocación, a costa de generar el registro en un orden de ejecución no determinístico. Solo se aplica a los formatos binario y JSON; el formato compacto nunca se ordena.
--[no]expand_test_suites
predeterminado: "true"-
Expande los destinos de test_suite en sus pruebas constituyentes antes del análisis. Cuando esta marca está activada (opción predeterminada), los patrones de segmentación negativos se aplicarán a las pruebas que pertenecen al conjunto 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, ya que, de esta manera, se pueden analizar los destinos de test_suite.
Etiquetas:loading_and_analysis
--experimental_disk_cache_gc_idle_delay=<An immutable length of time.>
predeterminado: "5 min"- Cuánto tiempo debe permanecer inactivo el servidor antes de que se realice una recolección de elementos no utilizados de la caché de disco. Para especificar la política de recolección de elementos no utilizados, configura --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 recolectará periódicamente como elementos no utilizados para quitar las entradas más antiguas que esta edad. Si se configura 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 está inactivo, según lo determina 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 realizará una recolección de elementos no utilizados periódica en la caché de disco para que no supere este tamaño. Si se configura 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 está inactivo, según lo determina la marca --experimental_disk_cache_gc_idle_delay.
- 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. Es el conjunto de filtros de los objetivos para los que se programarán 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 destinos de nivel superior.
--experimental_spawn_scheduler
-
Habilita la ejecución dinámica ejecutando acciones de forma local y remota en paralelo. Bazel genera cada acción de forma local y remota, y elige la que se completa primero. Si una acción admite trabajadores, la acción local se ejecutará en el modo de trabajador persistente. Para habilitar la ejecución dinámica de un mnemónico de acción individual, usa las marcas `--internal_spawn_scheduler` y `--strategy=<mnemonic>=dynamic` en su lugar.
Se expande a:
--internal_spawn_scheduler
--spawn_strategy=dynamic
--[no]fetch
predeterminado: "true"- Permite que el comando recupere dependencias externas. Si se establece en falso, el comando utilizará cualquier versión almacenada en caché de la dependencia y, si no existe ninguna, el comando fallará.
--local_termination_grace_seconds=<an integer>
predeterminado: "15"- Tiempo de espera entre la finalización de un proceso local debido a un tiempo de espera agotado y el cierre forzado.
--package_path=<colon-separated list of options>
valor predeterminado: "%workspace%"- Es una lista separada por dos puntos de las ubicaciones en las que se buscarán 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 "Loading package:".
- Valor predeterminado de
--test_lang_filters=<comma-separated list of options>
: "" - Especifica una lista de idiomas de prueba separados por comas. Cada idioma puede ir precedido de un guion (“-”) 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étera. Esta opción afecta el comportamiento de --build_tests_only y el comando de prueba.
- Valor predeterminado de
--test_size_filters=<comma-separated list of values: small, medium, large, or enormous>
: "" - Especifica una lista de tamaños de prueba separados por comas. Cada tamaño puede ir precedido de un guion "-" para especificar los tamaños excluidos. Solo se encontrarán aquellos objetivos de prueba que contengan al menos un tamaño incluido y no contengan ningún tamaño excluido. Esta opción afecta el comportamiento de --build_tests_only y el comando de prueba.
- Valor predeterminado de
--test_tag_filters=<comma-separated list of options>
: "" - Especifica una lista de etiquetas de prueba separadas por comas. Cada etiqueta puede ir precedida de un signo "-" para especificar las etiquetas excluidas. Solo se encontrarán aquellos destinos de prueba que contengan al menos una etiqueta incluida y no contengan ninguna etiqueta excluida. Esta opción afecta el comportamiento de --build_tests_only y el comando de prueba.
- Valor predeterminado de
--test_timeout_filters=<comma-separated list of values: short, moderate, long, or eternal>
: "" - Especifica una lista de tiempos de espera de prueba separados por comas. Cada tiempo de espera puede ir precedido de un signo "-" para especificar los tiempos de espera excluidos. Solo se encontrarán aquellos destinos de prueba que contengan al menos un tiempo de espera incluido y no contengan ningún tiempo de espera excluido. Esta opción afecta el comportamiento de --build_tests_only y el comando de prueba.
- Valor predeterminado de
--workspace_status_command=<path>
: "" - Es un comando que se invoca al comienzo de la compilación para proporcionar información de estado sobre el espacio de trabajo en forma de pares clave-valor. Consulta el Manual del usuario para ver la especificación completa. Consulta también tools/buildstamp/get_workspace_status para ver un ejemplo.
- Opciones que controlan la ejecución de la compilación:
--[no]experimental_inprocess_symlink_creation
predeterminado: "true"-
Indica si se deben realizar llamadas directas al sistema de archivos para crear árboles de vínculos simbólicos en lugar de delegar en un proceso auxiliar.
Etiquetas:loading_and_analysis
,execution
,experimental
--[no]experimental_persistent_aar_extractor
predeterminado: "false"-
Habilita el extractor de aar persistente con trabajadores.
Etiquetas:execution
,experimental
--[no]experimental_remotable_source_manifests
predeterminado: "false"-
Indica si las acciones del manifiesto fuente se pueden realizar 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 una nueva generación.
Etiquetas:execution
,experimental
--[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 vínculos simbólicos.
Etiquetas:execution
,experimental
--[no]incompatible_modify_execution_info_additive
predeterminado: "false"-
Cuando se habilita, 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 los usos múltiples 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 mnemónica 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 expresiones regulares pueden aplicarse a la misma mnemónica.
La sintaxis es "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" de ella.
"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 Genrule.
Etiquetas:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Habilita acciones persistentes de dex y desugar de Android con trabajadores.
Se expande a:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
-
Habilita el procesador de recursos 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 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=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_tools
-
Habilita herramientas de Android persistentes y multiplexadas (dexing, desugaring, 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.
Tags:execution
- Opciones que configuran la cadena de herramientas que se usa para la ejecución de acciones:
--android_compiler=<a string>
valor predeterminado: consulta la descripción-
Compilador de destino de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
valor predeterminado: "android"-
Selecciona el combinador de manifiestos que se usará para las reglas de android_binary. Es una marca para ayudar en la transición de la herramienta de combinación heredada a la herramienta de combinación de manifiestos de Android.
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 archivo binario es un APK grueso, que contiene archivos binarios nativos para cada plataforma de destino especificada.
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>
valor 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 archivo binario que se usa para el procesamiento posterior de los informes de cobertura sin procesar. Actualmente, debe ser un filegroup 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 archivo binario que se usa para generar informes de cobertura. Actualmente, debe ser un filegroup 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 asistencia que se requieren en las entradas de cada acción de prueba que recopila la cobertura del código. El valor predeterminado es “//tools/test:coverage_support”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--custom_malloc=<a build target label>
valor predeterminado: consulta la descripción-
Especifica una implementación de malloc personalizada. Este parámetro de configuración anula los atributos de malloc en las reglas de compilación.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan los usos múltiples de
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
-
Lista de expresiones regulares separadas por comas, cada una con el prefijo opcional - (expresión negativa), asignadas (=) a una lista de destinos de valores de restricción separados por comas. Si un destino no coincide con ninguna expresión negativa y coincide con al menos una expresión positiva, la resolución de su 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 configura, agrega un requisito de ejecución "requires-xcode:{version}" a cada acción de Xcode. Si la versión de Xcode tiene una etiqueta con guion, también agrega un requisito de ejecución "requires-xcode-label:{version_label}".
Etiquetas:loses_incremental_state
,loading_and_analysis
,execution
,experimental
--[no]experimental_prefer_mutual_xcode
predeterminado: "true"-
Si es verdadero, usa el Xcode más reciente que esté disponible de forma local y remota. Si es falso o si no hay versiones disponibles mutuas, usa la versión local de Xcode seleccionada a través de xcode-select.
Etiquetas:loses_incremental_state
,experimental
- 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 objetivo exacto o como un patrón de objetivo. Estas plataformas se considerarán antes de las que se declaren en el archivo WORKSPACE con register_execution_platforms(). Esta opción solo se puede configurar una vez; las instancias posteriores anularán la configuración anterior de la marca.
Etiquetas:execution
- Se acumulan los usos múltiples 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 de las que se declaran en el archivo WORKSPACE con register_toolchains().
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--grte_top=<a label>
valor predeterminado: consulta la descripción-
Es una etiqueta para una biblioteca de libc registrada. El valor predeterminado se selecciona con la cadena de herramientas de compilación cruzada y casi nunca es necesario anularlo.
Etiquetas:action_command_lines
,affects_outputs
--host_compiler=<a string>
valor predeterminado: consulta la descripción-
Es una marca que no realiza ninguna operación. Se quitará en una versión futura.
Etiquetas:loading_and_analysis
,execution
--host_grte_top=<a label>
valor 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 ejecución.
Etiquetas:action_command_lines
,affects_outputs
--host_platform=<a build target label>
valor predeterminado: "@bazel_tools//tools:host_platform"-
Etiqueta de una regla de plataforma que describe el sistema host.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--[no]incompatible_bazel_test_exec_run_under
predeterminado: "false"-
Si está habilitado, "bazel test --run_under=//:runner" compila "//:runner" en la configuración de ejecución. Si está inhabilitado, compila "//:runner" en la configuración de destino. Bazel ejecuta pruebas en máquinas de ejecución, por lo que la primera opción es más correcta. Esto no afecta a "bazel run", que siempre compila "`--run_under=//foo" en la configuración de destino.
Etiquetas:affects_outputs
,incompatible_change
--[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_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 nativas)
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_strip_executable_safely
predeterminado: "false"-
Si es verdadero, la acción de despojo para los ejecutables usará la marca -x, que no interrumpe la resolución de símbolos dinámicos.
Etiquetas:action_command_lines
,incompatible_change
-
Usa objetos compartidos de interfaz si la cadena de herramientas los admite. Actualmente, todas las cadenas de herramientas de 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')>
valor 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')>
valor 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>
valor predeterminado: consulta la descripción-
Es la versión mínima del SO para la que se compila tu app.
Etiquetas:loading_and_analysis
,affects_outputs
- Valor predeterminado de
--platform_mappings=<a main workspace-relative path>
: "" -
Ubicación de un archivo de asignación que describe qué plataforma usar si no se configuró ninguna o qué marcas establecer cuando ya existe una plataforma. Debe ser relativa a la raíz del espacio de trabajo principal. El valor predeterminado es "platform_mappings" (un archivo directamente en la raíz del espacio de trabajo).
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
,immutable
- Valor predeterminado de
--platforms=<a build target label>
: "" -
Son 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
--python_path=<a string>
valor predeterminado: consulta la descripción-
Es la ruta de acceso absoluta del intérprete de Python invocado para ejecutar destinos de Python en la plataforma de destino. Obsoleto; se inhabilita con --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
--python_top=<a build target label>
valor predeterminado: consulta la descripción-
Es 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 inhabilita 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')>
valor 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')>
valor 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>
valor predeterminado: consulta la descripción-
Si se especifica, usa Xcode de la versión indicada para las acciones de compilación pertinentes. Si no se especifica, se usa la versión predeterminada del ejecutor de Xcode.
Etiquetas:loses_incremental_state
--xcode_version_config=<a build target label>
valor 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 vínculos simbólicos de archivos ejecutables para todos los destinos. Si es falso, se escriben solo cuando lo requiere una acción, prueba o comando de ejecución local.
Etiquetas:affects_outputs
--[no]build_runfile_manifests
predeterminado: "true"-
Si es verdadero, escribe manifiestos de archivos ejecutables 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, también se compilará automáticamente el archivo .dwp para el archivo binario de prueba.
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 un cc_proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated set of options>
predeterminado: ".pb.cc"-
Establece los sufijos de los archivos fuente que crea un 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 un 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 resultado de la compilación.
Etiquetas:affects_outputs
,experimental
--fission=<a set of compilation modes>
predeterminado: "no"-
Especifica qué modos de compilación usan fission para las compilaciones y las vinculaciones 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 verdadero, las reglas nativas agregan <code>DefaultInfo.files</code> de las dependencias de datos a sus archivos ejecutables, 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: "false"-
Si es verdadero, compila bosques de vínculos simbólicos 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 configura, se guardarán los resultados temporales de gcc. Estos incluyen archivos .s (código de ensamblador), archivos .i (C preprocesado) y archivos .ii (C++ preprocesado).
Etiquetas:affects_outputs
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
- Se acumulan los usos múltiples de
--action_env=<a 'name=value' assignment with an optional value part>
-
Especifica el conjunto de variables de entorno disponibles para las acciones con configuración de destino. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o bien por el par nombre=valor que establece el valor independientemente del entorno de invocación. Esta opción se puede usar varias veces. En el caso de las opciones proporcionadas para la misma variable, se aplica la más reciente. Las opciones para diferentes variables se acumulan.
Etiquetas:action_command_lines
- Valor predeterminado de
--allowed_cpu_values=<comma-separated set of options>
: "" -
Valores permitidos para la marca --cpu.
Etiquetas:changes_inputs
,affects_outputs
--[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 operación.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]android_databinding_use_v3_4_args
predeterminado: "true"-
Usa la vinculación de datos de Android v2 con el argumento 3.4.0. Esta marca no realiza ninguna operació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 de forma explícita una biblioteca compartida. "default" significa que Bazel elegirá si se vincula de forma dinámica. "fully" significa que todas las bibliotecas se vincularán de forma dinámica. "off" significa que todas las bibliotecas se vincularán principalmente en modo estático.
Etiquetas:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
predeterminado: "alfabético"-
Establece el orden de los manifiestos que se pasan al combinador de manifiestos para los archivos binarios de Android. ALPHABETICAL 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 de 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 los usos múltiples de
--catalyst_cpus=<comma-separated list of options>
-
Lista separada por comas de las arquitecturas para las que se compilarán los archivos 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 cuando 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 se debe especificar directamente. En su lugar, se debe usar el comando "bazel coverage".
Etiquetas:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] valor 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 los usos múltiples 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 los usos múltiples de
--copt=<a string>
-
Opciones adicionales para pasar a gcc.
Etiquetas:action_command_lines
,affects_outputs
- Valor predeterminado de
--cpu=<a string>
: "" -
CPU objetivo.
Etiquetas:changes_inputs
,affects_outputs
--cs_fdo_absolute_path=<a string>
valor 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 de LLVM sin procesar o indexado.
Etiquetas:affects_outputs
--cs_fdo_instrument=<a string>
valor predeterminado: consulta la descripción-
Genera archivos binarios con la 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 en el tiempo de ejecución.
Etiquetas:affects_outputs
--cs_fdo_profile=<a build target label>
valor 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 los usos múltiples 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 los usos múltiples de
--define=<a 'name=value' assignment>
-
Cada opción --define especifica una asignación para una variable de compilación. En caso de que haya varios valores para una variable, se usará el último.
Etiquetas:changes_inputs
,affects_outputs
--dynamic_mode=<off, default or fully>
predeterminado: "default"-
Determina si los archivos binarios de C++ se vincularán de forma dinámica. "default" significa que Bazel elegirá si se vincula de forma dinámica. "fully" significa que todas las bibliotecas se vincularán de forma dinámica. "off" significa que todas las bibliotecas se vincularán principalmente en modo estático.
Etiquetas:loading_and_analysis
,affects_outputs
--[no]enable_propeller_optimize_absolute_paths
predeterminado: "true"-
Si se configura, cualquier uso de rutas absolutas para la optimización de la hélice generará un error.
Etiquetas:affects_outputs
--[no]enable_remaining_fdo_absolute_paths
predeterminado: "true"-
Si se configura, cualquier uso de rutas absolutas para FDO generará un error.
Etiquetas:affects_outputs
--[no]enable_runfiles
predeterminado: "auto"-
Habilita el árbol de vínculos simbólicos de runfiles. De forma predeterminada, está desactivado en Windows y activado en otras plataformas.
Etiquetas:affects_outputs
- Se acumulan los usos múltiples 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
--[no]experimental_android_compress_java_resources
predeterminado: "false"-
Comprimir recursos de Java en APKs
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_android_databinding_v2
predeterminado: "true"-
Usa la vinculación de datos de Android v2. Esta marca no realiza ninguna operació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
,experimental
--[no]experimental_android_rewrite_dexes_with_rex
predeterminado: "false"-
use rex tool to rewrite dex files
Tags: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 recopilación de cobertura para los archivos generados.
Etiquetas:affects_outputs
,experimental
--experimental_objc_fastbuild_options=<comma-separated list of options>
predeterminado: "-O0,-DDEBUG=1"-
Usa estas cadenas como opciones del compilador de compilación rápida de objc.
Etiquetas:action_command_lines
--[no]experimental_omitfp
predeterminado: "false"-
Si es verdadero, usa libunwind para el desenrollado de la pila y compila con -fomit-frame-pointer y -fasynchronous-unwind-tables.
Etiquetas:action_command_lines
,affects_outputs
,experimental
--experimental_output_paths=<off, content or strip>
predeterminado: "off"-
Qué modelo se debe usar para determinar dónde escriben sus resultados las reglas en el árbol de salida, en particular para las compilaciones multiplataforma o con múltiples configuraciones. Esta función 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 agregando la clave "supports-path-mapping" al diccionario "execution_requirements".
Etiquetas:loses_incremental_state
,bazel_internal_configuration
,affects_outputs
,execution
- Se acumulan los usos múltiples 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 corto deseado para usar en la ruta de acceso 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 de plataformas. 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 la plataforma actual. Por último, se usa un hash de la opción de la plataforma como último recurso.
Etiquetas:affects_outputs
,experimental
--[no]experimental_py_binaries_include_label
predeterminado: "false"-
Los destinos py_binary incluyen su etiqueta incluso cuando el sellado está inhabilitado.
Etiquetas:affects_outputs
,experimental
--[no]experimental_use_llvm_covmap
predeterminado: "false"-
Si se especifica, Bazel generará información del mapa de cobertura de llvm-cov en lugar de gcov cuando se habilite collect_code_coverage.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic
predeterminado: "true"-
Usa esta marca solo como parte de una estrategia de prueba o migración sugerida. Ten en cuenta que la heurística tiene deficiencias conocidas y se sugiere migrar para depender solo de --experimental_override_name_platform_in_output_dir.
Etiquetas:affects_outputs
,experimental
--fdo_instrument=<a string>
valor predeterminado: consulta la descripción-
Genera archivos binarios con la instrumentación de FDO. Con el compilador Clang/LLVM, también acepta el nombre del directorio en el que se volcarán los archivos de perfil sin procesar en el tiempo de ejecución.
Etiquetas:affects_outputs
--fdo_optimize=<a string>
valor predeterminado: consulta la descripción-
Usa la información del perfil de FDO para optimizar la compilación. Especifica el nombre de un archivo ZIP que contenga un árbol de archivos .gcda, un archivo AFDO que contenga un perfil automático o un archivo de perfil de LLVM. Esta marca también acepta archivos especificados como etiquetas (p.ej., `//foo/bar:file.afdo`; es posible que debas agregar una directiva `exports_files` al paquete correspondiente) y etiquetas que apuntan a destinos `fdo_profile`. Esta marca se reemplazará por la regla "fdo_profile".
Etiquetas:affects_outputs
--fdo_prefetch_hints=<a build target label>
valor predeterminado: consulta la descripción-
Usa sugerencias de recuperación previa de caché.
Etiquetas:affects_outputs
--fdo_profile=<a build target label>
valor predeterminado: consulta la descripción-
Es el objeto fdo_profile que representa el perfil que se usará para la optimización.
Etiquetas:affects_outputs
- Se acumulan los usos múltiples de
--features=<a string>
-
Las funciones proporcionadas 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. Las funciones negativas siempre anulan las positivas. Consulta también --host_features.
Etiquetas:changes_inputs
,affects_outputs
--[no]force_pic
predeterminado: "false"-
Si está habilitado, todas las compilaciones de C++ producen código independiente de la posición (“-fPIC”), las vinculaciones prefieren las bibliotecas prediseñadas PIC a las bibliotecas no PIC y las vinculaciones producen ejecutables independientes de la posición (“-pie”).
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan los usos múltiples 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 proporcionadas para la misma variable, se aplica la más reciente. Las opciones para diferentes variables se acumulan.
Etiquetas:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
valor predeterminado: "opt"-
Especifica el modo en el que se compilarán las herramientas que se usan durante la compilación. Valores: "fastbuild", "dbg", "opt".
Etiquetas:affects_outputs
,action_command_lines
- Se acumulan los usos múltiples 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 los usos múltiples 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
- Valor predeterminado de
--host_cpu=<a string>
: "" -
Es la CPU del host.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan los usos múltiples de
--host_cxxopt=<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
- Se acumulan los usos múltiples de
--host_features=<a string>
-
Las funciones proporcionadas 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. Las funciones negativas siempre anulan las positivas.
Etiquetas:changes_inputs
,affects_outputs
--host_force_python=<PY2 or PY3>
valor 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 los usos múltiples 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')>
valor predeterminado: consulta la descripción-
Versión mínima de macOS compatible con los destinos de host. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan los usos múltiples 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 de 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. Aquí, regex_filter representa una lista de patrones de expresiones regulares de inclusión y exclusión (consulta también --instrumentation_filter), y option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe incluirse 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
--[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 pliega en el directorio bin.
Etiquetas: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 configura, se instrumentan las reglas de prueba incluidas por --instrumentation_filter. De lo contrario, las reglas de prueba siempre se excluyen de la instrumentación de cobertura.
Etiquetas:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
valor predeterminado: "-/javatests[/:],-/test/java[/:]"-
Cuando la cobertura está habilitada, solo se instrumentarán las reglas con nombres incluidos en el filtro basado en regex especificado. En su lugar, se excluyen las reglas que tienen 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')>
valor predeterminado: consulta la descripción-
Versión mínima compatible de iOS para los simuladores y dispositivos de destino. Si no se especifica, se usa "ios_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan los usos múltiples de
--ios_multi_cpus=<comma-separated list of options>
-
Lista separada por comas de las arquitecturas con las que se compilará un 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. Se reemplazó por --incompatible_remove_legacy_whole_archive (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener más detalles). 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 los usos múltiples de
--linkopt=<a string>
-
Opción adicional para pasar a gcc durante la vinculación.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan los usos múltiples 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 los usos múltiples 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 los usos múltiples de
--macos_cpus=<comma-separated list of options>
-
Lista separada por comas de las arquitecturas para las que se compilarán los archivos 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')>
valor predeterminado: consulta la descripción-
Versión mínima de macOS compatible con los destinos. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
--memprof_profile=<a build target label>
valor predeterminado: consulta la descripción-
Usa el perfil de memprof.
Etiquetas:affects_outputs
--[no]objc_debug_with_GLIBCXX
predeterminado: "false"-
Si se configura 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 no utilizado de los archivos binarios vinculados. Se realizará el despojo de binarios si se especifican esta marca y --compilation_mode=opt.
Etiquetas:action_command_lines
- Se acumulan los usos múltiples 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 los usos múltiples 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. Aquí, regex_filter representa una lista de patrones de expresiones regulares de inclusión y exclusión (consulta también --instrumentation_filter), y option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe incluirse 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 los usos múltiples 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 del backend. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,…,option_n. Aquí regex_filter representa una lista de patrones de expresiones regulares de inclusión y exclusión, y option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe incluirse 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
--platform_suffix=<a string>
valor 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>
valor 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 los 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>
valor predeterminado: consulta la descripción-
Nombre de ruta de acceso absoluta del archivo cc_profile para las compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
valor predeterminado: consulta la descripción-
Nombre de ruta de acceso absoluta del archivo ld_profile para las compilaciones optimizadas con Propeller.
Etiquetas:affects_outputs
--run_under=<a prefix in front of command>
valor predeterminado: consulta la descripción-
Prefijo que se 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" y "//package:target --options".
Etiquetas:action_command_lines
-
Si es verdadero, las bibliotecas nativas que contienen la misma funcionalidad se compartirán entre diferentes destinos.
Etiquetas:loading_and_analysis
,affects_outputs
--[no]stamp
predeterminado: "false"-
Sella los archivos 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 archivos binarios y las bibliotecas compartidas (con "-Wl,--strip-debug"). El valor predeterminado "sometimes" significa que se quita solo si --compilation_mode=fastbuild.
Etiquetas:affects_outputs
- Se acumulan los usos múltiples de
--stripopt=<a string>
-
Opciones adicionales para pasar a strip cuando se genera un objeto binario "<name>.stripped".
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan los usos múltiples de
--tvos_cpus=<comma-separated list of options>
-
Lista separada por comas de las arquitecturas para las que se compilarán los archivos 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')>
valor 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 los usos múltiples de
--visionos_cpus=<comma-separated list of options>
-
Lista separada por comas de las arquitecturas para las que se compilarán los archivos binarios de Apple visionOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Se acumulan los usos múltiples de
--watchos_cpus=<comma-separated list of options>
-
Lista separada por comas de las arquitecturas para las que se compilarán los archivos binarios de watchOS de Apple.
Etiquetas:loses_incremental_state
,loading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
valor 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>
valor predeterminado: consulta la descripción-
Usa la información del perfil de XbinaryFDO para optimizar la compilación. Especifica el nombre del perfil predeterminado de varias plataformas. 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 hubiera especificado.
Etiquetas:affects_outputs
- Opciones que afectan la rigidez con la que Bazel aplica las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
--[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"-
Indica si se debe aplicar desugar al código de bytes de Java 8 antes de convertirlo en dex.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]desugar_java8_libs
predeterminado: "false"-
Indica si se deben incluir las bibliotecas de Java 8 compatibles en las 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 destino y genera errores si algún destino tiene dependencias que no admiten los mismos entornos.
Etiquetas:build_file_semantics
--[no]experimental_check_desugar_deps
predeterminado: "true"-
Indica si se debe verificar la desazucaración correcta a nivel binario de Android.
Etiquetas:eagerness_to_exit
,loading_and_analysis
,experimental
--experimental_import_deps_checking=<a string>
valor predeterminado: consulta la descripción-
No se realiza ninguna operación; se mantiene solo para la retrocompatibilidad
Etiquetas:loading_and_analysis
--experimental_one_version_enforcement=<off, warning or error>
predeterminado: "OFF"-
Cuando se habilita, se aplica 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 la clase. Esta aplicación de la política puede interrumpir la compilación o simplemente generar advertencias.
Etiquetas:loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
predeterminado: "default"-
Si es verdadero, verifica que un destino de Java declare explícitamente todos los destinos que se usan directamente como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files
predeterminado: "false"-
Si está habilitado, verifica testonly para los destinos de requisitos previos que son archivos de salida buscando el testonly de la regla de generación. Esto coincide con la verificación de visibilidad.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_check_visibility_for_toolchains
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 Starlark para Android 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 operación. Se mantiene aquí para la retrocompatibilidad.
Etiquetas:eagerness_to_exit
,incompatible_change
--[no]incompatible_python_disable_py2
predeterminado: "true"-
Si es verdadero, usar la configuración de Python 2 causará 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]one_version_enforcement_on_java_tests
predeterminado: "true"-
Cuando se habilita y experimental_one_version_enforcement se establece en un valor que no sea NONE, se aplica una versión en los destinos de java_test. Esta marca se puede inhabilitar para mejorar el rendimiento de las pruebas incrementales a costa de no detectar posibles incumplimientos de una versión.
Etiquetas:loading_and_analysis
--python_native_rules_allowlist=<a build target label>
valor predeterminado: consulta la descripción-
Lista de entidades permitidas (destino 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 del paquete 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, verifica que un destino proto_library declare explícitamente 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, verifica que un destino proto_library declare de forma explícita todos los destinos 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 los usos múltiples 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 "environment". 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 en Objective-C incluirán derechos de depuración cuando se firmen.
Etiquetas:changes_inputs
--ios_signing_cert_name=<a string>
valor predeterminado: consulta la descripción-
Nombre del certificado que se usará para la firma de iOS. Si no se configura, se volverá al perfil de aprovisionamiento. Puede ser la preferencia de identidad del llavero del certificado o una subcadena del nombre común del certificado, según la página de manual 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 se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]incompatible_disallow_legacy_py_provider
predeterminado: "true"-
No-op, se quitará pronto.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_sdk_frameworks_attributes
predeterminado: "false"-
Si es verdadero, no permite los atributos sdk_frameworks y weak_sdk_frameworks en objc_library y objc_import.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_objc_alwayslink_by_default
predeterminado: "false"-
Si es verdadero, establece el valor predeterminado como verdadero para los atributos alwayslink en objc_library y objc_import.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_python_disallow_native_rules
predeterminado: "false"-
Cuando es verdadero, se produce un error cuando se usan las reglas py_* integradas; en su lugar, se deben usar las reglas rule_python. Consulta https://github.com/bazelbuild/bazel/issues/17773 para obtener más información y las instrucciones de migración.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones que rigen el comportamiento del entorno de prueba o del ejecutor de pruebas:
--[no]allow_analysis_failures
predeterminado: "false"-
Si es verdadero, un error de análisis de un destino de regla hace que el destino propague una instancia de AnalysisFailureInfo que contiene la descripción del error, en lugar de generar un error 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 generará un error de regla.
Etiquetas:loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure
predeterminado: "false"-
Si es verdadero, los errores de la acción dex2oat harán que se interrumpa la compilación en lugar de ejecutar dex2oat durante el tiempo de ejecución de la prueba.
Etiquetas:loading_and_analysis
,experimental
- Se acumulan los usos múltiples 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 predeterminada de recursos para las pruebas. El formato esperado es <recurso>=<valor>. Si se especifica un solo número positivo como <valor>, se anularán los recursos predeterminados para todos los tamaños de prueba. Si se especifican 4 números separados por comas, se anulará la cantidad de recursos para los tamaños de prueba pequeño, mediano, grande y enorme, 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 especificados por esta marca se anulan con los recursos explícitos especificados en las etiquetas.
--[no]experimental_android_use_parallel_dex2oat
predeterminado: "false"-
Usa dex2oat en paralelo para acelerar android_test.
Etiquetas:loading_and_analysis
,host_machine_resource_optimizations
,experimental
--[no]ios_memleaks
predeterminado: "false"-
Habilita la verificación de pérdidas de memoria en los destinos de ios_test.
Etiquetas:action_command_lines
--ios_simulator_device=<a string>
valor predeterminado: consulta la descripción-
Es el dispositivo que se simulará cuando se ejecute una aplicación para iOS en el simulador, p.ej., "iPhone 6". Puedes obtener una lista de dispositivos ejecutando "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')>
valor predeterminado: consulta la descripción-
Versión de iOS que se ejecutará en el simulador cuando se ejecute o pruebe. Se ignora para las reglas de ios_test si se especifica un dispositivo objetivo en la regla.
Etiquetas:test_runner
- Se acumulan los usos múltiples 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ó. Normalmente, el valor especificado es solo un número entero. Ejemplo: --runs_per_test=3 ejecutará todas las pruebas 3 veces. Sintaxis alternativa: regex_filter@runs_per_test. Aquí runs_per_test representa 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 pasar varias veces. Tiene prioridad el argumento que se pasó más recientemente y que coincide. Si no hay coincidencias, la prueba solo se ejecuta una vez.
- Se acumulan los usos múltiples de
--test_env=<a 'name=value' assignment with an optional value part>
-
Especifica variables de entorno adicionales que se insertarán en el entorno del ejecutor de pruebas. Las variables se pueden especificar por nombre, en cuyo caso su valor se leerá del entorno del cliente de Bazel, o por el par nombre=valor. Esta opción se puede usar varias veces para especificar varias variables. Solo se usa con 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 la 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 cualquiera de las dos formas, 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: "false"-
Si es verdadero, los resultados de las pruebas no declarados se archivarán en un archivo ZIP.
Etiquetas:test_runner
- Opciones que activan optimizaciones del tiempo de compilación:
--[no]experimental_filter_library_jar_with_program_jar
predeterminado: "false"-
Filtra el ProgramJar de ProGuard para quitar las clases que también estén presentes en el LibraryJar.
Etiquetas:action_command_lines
,experimental
--[no]experimental_inmemory_dotd_files
predeterminado: "true"-
Si está habilitado, los archivos .d de C++ se pasarán por 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 las compilaciones de Java se pasarán a través de 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_retain_test_configuration_across_testonly
predeterminado: "false"-
Cuando está habilitado, --trim_test_configuration no recortará la configuración de prueba para las reglas marcadas como testonly=1. Esto tiene como objetivo reducir los problemas de conflicto de acciones cuando las reglas que no son de prueba dependen de las reglas cc_test. No tiene efecto si --trim_test_configuration es falso.
Etiquetas:loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_starlark_cc_import
predeterminado: "false"-
Si está habilitado, 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"-
Indica si se deben reducir las entradas a la compilación de C/C++ analizando las líneas #include de los archivos de entrada. Esto puede mejorar el rendimiento y la incrementalidad, ya que disminuye el tamaño de los árboles de entrada de compilación. Sin embargo, también puede interrumpir las compilaciones porque el analizador de inclusión no implementa por completo la semántica del preprocesador de 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 este parámetro que se registren.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
,experimental
--[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 configura, los archivos .d que emite clang se usarán para reducir 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 destino //a:a, se procesan 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, las opciones relacionadas con las pruebas se borrarán 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 el nivel de detalle, 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 cadenas de herramientas y los objetivos específicos para ver cuáles depurar. Se pueden separar varias expresiones regulares 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 los expertos en la resolución de cadenas de herramientas.
Etiquetas:terminal_output
- Opciones que especifican o alteran una entrada genérica para un comando de Bazel que no se incluye en otras categorías.:
- Se acumulan los usos múltiples 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 ejecutables de los destinos de Python. Específicamente, cuando un destino py_binary o py_test tiene legacy_create_init establecido en "auto" (el valor predeterminado), se trata como falso si y 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 vínculo simbólico 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 configuren su atributo `python_version` (o `default_python_version`) se establecerán de forma predeterminada en PY3 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 nativo 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>
valor predeterminado: consulta la descripción-
Modo de versión principal de Python, ya sea "PY2" o "PY3". Ten en cuenta que los objetivos "py_binary" y "py_test" anulan este parámetro (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 varias, no clasificadas de otra manera.:
--[no]cache_test_results
[-t
] default: "auto"- Si se configura como "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 se marca como externa, (3) se solicitaron varias ejecuciones de prueba con --runs_per_test o(4) la prueba falló anteriormente. Si se configura como “sí”, Bazel almacena en caché todos los resultados de las pruebas, excepto las que se marcan como externas. Si se configura como "no", Bazel no almacena en caché ningún resultado de la prueba.
--[no]experimental_cancel_concurrent_tests
predeterminado: "false"-
Si es verdadero, Blaze cancelará las pruebas que se ejecuten de forma simultánea en la primera ejecución exitosa. Esto solo es útil en combinación con --runs_per_test_detects_flakes.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_fetch_all_coverage_outputs
predeterminado: "false"-
Si es verdadero, Bazel recupera el directorio completo de datos de cobertura para cada prueba durante una ejecución de cobertura.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_generate_llvm_lcov
predeterminado: "false"-
Si es verdadero, la cobertura de clang generará un informe de LCOV.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_j2objc_header_map
predeterminado: "true"-
Indica si se debe generar el mapa de encabezado de J2ObjC en paralelo con la transpilación de J2ObjC.
Etiquetas:experimental
--[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
--experimental_java_classpath=<off, javabuilder or bazel>
predeterminado: "javabuilder"- Habilita rutas de acceso de clase reducidas para las compilaciones de Java.
--[no]experimental_limit_android_lint_to_android_constrained_java
predeterminado: "false"-
No-op, kept only for backwards compatibility
Etiquetas:affects_outputs
,experimental
--[no]experimental_run_android_lint_on_java_rules
predeterminado: "false"-
Indica si se deben validar las fuentes java_*.
Etiquetas:affects_outputs
,experimental
--[no]explicit_java_test_deps
predeterminado: "false"- Especifica de forma explícita una dependencia de 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>
valor predeterminado: consulta la descripción- Es el launcher de Java que usan las herramientas que se ejecutan durante una compilación.
- Se acumulan los usos múltiples de
--host_javacopt=<a string>
- Opciones adicionales para pasar a javac cuando se compilan herramientas que se ejecutan durante una compilación.
- Se acumulan los usos múltiples de
--host_jvmopt=<a string>
- Opciones adicionales para pasar a la VM de Java cuando se compilan herramientas que se ejecutan durante la compilación. Estas opciones se agregarán a las opciones de inicio de la VM de cada destino java_binary.
--[no]incompatible_check_sharding_support
predeterminado: "true"-
Si es verdadero, Bazel fallará una prueba fragmentada si el ejecutor de pruebas no indica que admite el fragmentado tocando el archivo en la ruta de TEST_SHARD_STATUS_FILE. Si es falso, un ejecutor de pruebas que no admite 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 una ejecución de 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 esto puede impedir el almacenamiento en caché entre usuarios si se usa una caché compartida.
Etiquetas:loading_and_analysis
,incompatible_change
- Se acumulan los usos múltiples 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, classpath de tiempo de compilación) por destino de Java.
--[no]java_header_compilation
predeterminado: "true"- Compila archivos .ijar directamente desde la fuente.
- Valor predeterminado de
--java_language_version=<a string>
: "" - La versión del lenguaje Java
--java_launcher=<a build target label>
valor predeterminado: consulta la descripción- Es el lanzador de Java que se usará cuando se compilen archivos binarios de Java. Si esta marca se establece en la cadena vacía, se usa el iniciador del JDK. El atributo "launcher" anula esta marca.
--java_runtime_version=<a string>
valor predeterminado: "local_jdk"- La versión del entorno de ejecución de Java
- Se acumulan los usos múltiples de
--javacopt=<a string>
- Opciones adicionales para pasar a javac.
- Se acumulan los usos múltiples de
--jvmopt=<a string>
- Opciones adicionales para pasar a la JVM 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>
valor predeterminado: consulta la descripción- Especifica un archivo binario que se usará para generar la lista de clases que deben estar en el archivo dex principal cuando se compile multidex heredado.
--optimizing_dexer=<a build target label>
valor predeterminado: consulta la descripción- Especifica un objeto binario que se usará para realizar la conversión a dex sin fragmentación.
- Se acumulan los usos múltiples de
--plugin=<a build target label>
- Son los complementos que se usarán en la compilación. Actualmente, funciona con java_plugin.
--proguard_top=<a build target label>
valor predeterminado: consulta la descripción- Especifica qué versión de ProGuard se usará para quitar código cuando se compile un archivo binario de Java.
--proto_compiler=<a build target label>
default: "@bazel_tools//tools/proto:protoc"-
Es la etiqueta del compilador de .proto.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]proto_profile
predeterminado: "true"-
Indica si se debe pasar profile_path al compilador de proto.
Etiquetas:affects_outputs
,loading_and_analysis
--proto_profile_path=<a build target label>
valor predeterminado: consulta la descripción-
Es el perfil que se pasará al compilador de .proto como profile_path. Si no se configura, pero --proto_profile es verdadero (el valor predeterminado), se infiere la ruta de --fdo_optimize.
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
default: "@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>
valor 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>
default: "@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>
default: "@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 los usos múltiples de
--protocopt=<a string>
-
Opciones adicionales para pasar al compilador de protobuf.
Etiquetas:affects_outputs
--[no]runs_per_test_detects_flakes
predeterminado: "false"- Si es verdadero, cualquier fragmento en el que se apruebe al menos una ejecución o intento y falle al menos una ejecución o intento obtendrá el estado FLAKY.
--shell_executable=<a path>
valor predeterminado: consulta la descripción-
Ruta de acceso absoluta al ejecutable del shell que Bazel debe usar. Si no se configura, pero la variable de entorno BAZEL_SH se establece en la primera invocación de Bazel (que inicia un servidor de Bazel), Bazel la usa. Si no se establece ninguno, Bazel usa una ruta de acceso predeterminada codificada de forma rígida según el sistema operativo en el que se ejecuta (Windows: c:/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 provocar fallas en la compilación o en el tiempo de ejecución de los archivos binarios generados.
Etiquetas:loading_and_analysis
- Se acumulan los usos múltiples de
--test_arg=<a string>
- Especifica argumentos y opciones 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 se usa con el comando "bazel test".
--test_filter=<a string>
valor 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.
- Valor predeterminado de
--test_result_expiration=<an integer>
: "-1" - Esta opción está obsoleta y no tiene ningún 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 ante el primer error.
--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 división de pruebas: "explícita" para usar la división solo si el atributo de compilación "shard_count" está presente. "disabled" para no usar nunca la división de pruebas. "forced=k" para forzar "k" fragmentos para las pruebas, independientemente del atributo de compilación "shard_count".
- Valor predeterminado de
--tool_java_language_version=<a string>
: "" - Versión del lenguaje Java que se usa para ejecutar las herramientas necesarias durante una compilación
--tool_java_runtime_version=<a string>
valor predeterminado: "remotejdk_11"- 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 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 controlan el resultado del comando:
--[no]canonicalize_policy
predeterminado: "false"-
Genera la política canónica después de la expansión y el filtrado. Para mantener la salida limpia, los argumentos de comando canonizados NO se mostrarán cuando esta opción se establezca como verdadera. Ten en cuenta que el comando especificado por --for_command afecta la política filtrada y, si no se especifica ninguno, el comando predeterminado es "build".
Etiquetas:affects_outputs
,terminal_output
--[no]experimental_include_default_values
predeterminado: "true"-
Indica si las opciones de Starlark establecidas 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 se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility
predeterminado: "false"-
Si incompatible_enforce_config_setting_visibility=false, esta es una operación nula. 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, se aplican 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_use_plus_in_repo_names
predeterminado: "true"-
No hace nada.
Etiquetas:loading_and_analysis
- Opciones que especifican o alteran una entrada genérica para un comando de Bazel que no se incluye en otras categorías:
--for_command=<a string>
predeterminado: "build"-
Comando para el que se deben canonizar las opciones.
Etiquetas:affects_outputs
,terminal_output
- Valor predeterminado de
--invocation_policy=<a string>
: "" -
Aplica una política de invocación a las opciones que se deben canonizar.
Etiquetas:affects_outputs
,terminal_output
- Opciones varias, no clasificadas de otra manera.:
- Se acumulan los usos múltiples de
--deleted_packages=<comma-separated list of package names>
- Es una lista separada por comas de los nombres de los 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 muestre un error si encuentra la etiqueta "//x:y/z" si otra entrada de package_path aún la proporciona. Si especificas --deleted_packages x/y, se evita este problema.
--[no]fetch
predeterminado: "true"- Permite que el comando recupere dependencias externas. Si se establece en falso, el comando utilizará cualquier versión almacenada en caché de la dependencia y, si no existe ninguna, el comando fallará.
--package_path=<colon-separated list of options>
valor predeterminado: "%workspace%"- Es una lista separada por dos puntos de las ubicaciones en las que se buscarán 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 "Loading package:".
Opciones de limpieza
Hereda todas las opciones de build.
- Opciones que controlan el resultado del comando:
--[no]async
predeterminado: "false"-
Si es verdadero, la limpieza del resultado es asíncrona. Cuando se complete este comando, será seguro ejecutar comandos nuevos en el mismo cliente, aunque la eliminación continúe en segundo plano.
Etiquetas:host_machine_resource_optimizations
--[no]expunge
predeterminado: "false"-
Si es verdadero, clean quita todo el árbol de trabajo de esta instancia de Bazel, lo que incluye todos los archivos temporales y de salida de compilación creados por Bazel, y detiene el servidor de Bazel si se está ejecutando.
Etiquetas:host_machine_resource_optimizations
--expunge_async
-
Si se especifica, clean quita de forma asíncrona todo el árbol de trabajo de esta instancia de Bazel, lo que incluye todos los archivos temporales y de salida 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 continúe en segundo plano.
Se expande a:
--expunge
--async
Etiquetas:host_machine_resource_optimizations
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]incompatible_use_plus_in_repo_names
predeterminado: "true"-
No-op.
Etiquetas:loading_and_analysis
Opciones de configuración
Opciones de cobertura
Hereda todas las opciones de test.
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]incompatible_use_plus_in_repo_names
predeterminado: "true"-
No-op.
Etiquetas:loading_and_analysis
Opciones de Cquery
Hereda todas las opciones de test.
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]incompatible_use_plus_in_repo_names
predeterminado: "true"-
No se realiza ninguna operación.
Etiquetas:loading_and_analysis
- Opciones relacionadas con la salida y la semántica de la búsqueda:
--aspect_deps=<off, conservative or precise>
valor predeterminado: "conservative"-
Cómo resolver las dependencias de aspectos cuando el formato de salida es uno de {xml,proto,record}. "off" significa que no se resuelve ninguna dependencia de aspectos; "conservative" (el valor predeterminado) significa que se agregan todas las dependencias de aspectos declaradas, independientemente de si se les asigna la clase de regla de dependencias directas; "precise" significa que solo se agregan aquellos aspectos que posiblemente estén activos dada la clase de regla de las dependencias directas. Ten en cuenta que el modo preciso requiere cargar otros paquetes para evaluar un solo objetivo, lo que lo hace más lento que los otros modos. También ten en cuenta que incluso el modo preciso no es completamente preciso: la decisión de calcular un aspecto se toma en la fase de análisis, que no se ejecuta durante "bazel query".
Etiquetas:build_file_semantics
--[no]consistent_labels
predeterminado: "false"-
Si está habilitado, cada comando de consulta emite etiquetas como si se aplicara la función <code>str</code> de Starlark a una instancia de <code>Label</code>. Esto es útil para las herramientas que necesitan coincidir con el resultado de diferentes comandos de consulta o etiquetas emitidas por reglas. Si no está habilitado, los formateadores de salida pueden emitir nombres de repositorio aparentes (relativos al repositorio principal) para que la salida sea más legible.
Etiquetas:terminal_output
--[no]experimental_explicit_aspects
predeterminado: "false"-
aquery, cquery: Indica si se deben incluir las acciones generadas por aspectos en el resultado. query: No es una operación (los aspectos siempre se siguen).
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>
valor predeterminado: "512"-
Es la longitud máxima de la cadena de etiqueta para un nodo de gráfico en el resultado. Las etiquetas más largas se truncarán. El valor -1 significa que no se truncarán. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--[no]implicit_deps
predeterminado: "true"-
Si está habilitado, las dependencias implícitas se incluirán en el gráfico de dependencias sobre el que opera la consulta. Una dependencia implícita es aquella que no se especifica de forma explícita en el archivo BUILD, pero que Bazel agrega. En el caso de cquery, esta opción controla el filtrado de las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
--[no]include_aspects
predeterminado: "true"-
aquery, cquery: Indica si se deben incluir las acciones generadas por aspectos en el resultado. query: No es una operación (los aspectos siempre se siguen).
Etiquetas:terminal_output
--[no]incompatible_package_group_includes_double_slash
predeterminado: "true"-
Si está habilitado, 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 configura y no se configura --universe_scope, se inferirá un valor de --universe_scope como la lista de patrones de destino únicos en la expresión de búsqueda. Ten en cuenta que el valor de --universe_scope que se infiere para una expresión de búsqueda que usa funciones con alcance del universo (p.ej., "allrdeps") podría no ser el que deseas, por lo que debes usar esta opción solo si sabes lo que haces. 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á habilitado, 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 "visibilidad". 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: label, label_kind, textproto, transitions, proto, streamed_proto 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á habilitado, 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"-
Completa el campo proto source_aspect_name de cada atributo con el aspecto fuente del que proviene el atributo (cadena vacía si no proviene de ninguno).
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 del arvo de .proto de cquery se parece al formato de salida de la consulta.
Etiquetas:affects_outputs
--[no]proto:include_synthetic_attribute_hash
predeterminado: "false"-
Indica si se debe calcular y completar el atributo $internal_attr_hash.
Etiquetas:terminal_output
--[no]proto:instantiation_stack
predeterminado: "false"-
Propaga la pila de llamadas de instanciación 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 la salida de proto.
Etiquetas:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
predeterminado: "all"-
Lista de atributos separados por comas que se incluirán en el resultado. La configuración predeterminada incluye todos los atributos. Se establece en una cadena vacía para no generar ningún atributo. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
--[no]proto:rule_classes
predeterminado: "false"-
Completa el campo rule_class_key de cada regla y, para la primera regla con un rule_class_key determinado, también completa su campo rule_class_info proto. El campo rule_class_key identifica de forma única una clase de regla, y el campo rule_class_info es una definición de API de clase de regla en formato Stardoc.
Etiquetas:terminal_output
--[no]proto:rule_inputs_and_outputs
predeterminado: "true"-
Indica si se deben propagar los campos rule_input y rule_output.
Etiquetas:terminal_output
- Valor predeterminado de
--query_file=<a string>
: "" -
Si se configura, la consulta leerá la consulta del archivo que se nombra aquí, en lugar de hacerlo desde la línea de comandos. Es un error especificar un archivo aquí y una consulta de línea de comandos.
Etiquetas:changes_inputs
--[no]relative_locations
predeterminado: "false"-
Si es verdadero, la ubicación de los archivos BUILD en las salidas de XML y proto será relativa. De forma predeterminada, la salida de ubicación es una ruta de acceso absoluta y no será coherente en todas las máquinas. Puedes establecer esta opción como verdadera 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 reducir un gráfico de destino configurado.
Etiquetas:affects_outputs
- Valor predeterminado de
--starlark:expr=<a string>
: "" -
Es 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 "destino". Si no se especifican --starlark:expr ni --starlark:file, esta opción se establecerá de forma predeterminada en "str(target.label)". Es un error especificar tanto --starlark:expr como --starlark:file.
Etiquetas:terminal_output
- Valor predeterminado de
--starlark:file=<a string>
: "" -
Nombre de un archivo que define una función de Starlark llamada "format", de un argumento, que se aplica a cada destino configurado para darle formato como una cadena. Es un error especificar tanto --starlark:expr como --starlark:file. Consulta la ayuda de --output=starlark para obtener más detalles.
Etiquetas:terminal_output
--[no]tool_deps
predeterminado: "true"-
Consulta: Si está inhabilitada, las dependencias de la "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 que va 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 "target".
Cquery: Si está inhabilitado, filtra todos los destinos configurados que cruzan una transición de ejecución desde el destino de nivel superior que descubrió este destino configurado. Esto significa que, si el destino de nivel superior está en la configuración de destino, solo se devolverán los destinos configurados que también estén en la configuración de destino. Si el destino de nivel superior está en la configuración de ejecución, solo se devolverán los destinos configurados para la ejecución. Esta opción NO excluirá las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
--transitions=<full, lite or none>
predeterminado: "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 segmentación (aditivos y sustractivos) separados por comas. La consulta se puede realizar en el universo definido por el cierre transitivo de los destinos especificados. Esta opción se usa para los comandos query y cquery.
En el caso de cquery, la entrada de esta opción son los destinos en los que se compilan todas las respuestas, por lo que esta opción puede afectar las configuraciones y las transiciones. Si no se especifica esta opción, se supone que los destinos de nivel superior son los que se analizan a partir de la expresión de búsqueda. Nota: En el caso de cquery, no especificar esta opción puede provocar que se interrumpa la compilación si los destinos analizados a partir de la expresión de la consulta no se pueden compilar con las opciones de nivel superior.
Etiquetas:loading_and_analysis
- Opciones que controlan la ejecución de la compilación:
--[no]experimental_inprocess_symlink_creation
predeterminado: "true"-
Indica si se deben realizar llamadas directas al sistema de archivos para crear árboles de vínculos simbólicos en lugar de delegar en un proceso auxiliar.
Etiquetas:loading_and_analysis
,execution
,experimental
--[no]experimental_persistent_aar_extractor
predeterminado: "false"-
Habilita el extractor de aar persistente con trabajadores.
Etiquetas:execution
,experimental
--[no]experimental_remotable_source_manifests
predeterminado: "false"-
Indica si las acciones del manifiesto fuente se pueden realizar 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 una nueva generación.
Etiquetas:execution
,experimental
--[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 vínculos simbólicos.
Etiquetas:execution
,experimental
--[no]incompatible_modify_execution_info_additive
predeterminado: "false"-
Cuando se habilita, 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 los usos múltiples 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 mnemónica 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 expresiones regulares pueden aplicarse a la misma mnemónica.
La sintaxis es "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" de ella.
"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 Genrule.
Etiquetas:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Habilita acciones persistentes de dex y desugar de Android con trabajadores.
Se expande a:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
-
Habilita el procesador de recursos 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 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=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_tools
-
Habilita herramientas de Android persistentes y multiplexadas (dexing, desugaring, 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.
Tags:execution
- Opciones que configuran la cadena de herramientas que se usa para la ejecución de acciones:
--android_compiler=<a string>
valor predeterminado: consulta la descripción-
Compilador de destino de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
valor predeterminado: "android"-
Selecciona el combinador de manifiestos que se usará para las reglas de android_binary. Es una marca para ayudar en la transición de la herramienta de combinación heredada a la herramienta de combinación de manifiestos de Android.
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 archivo binario es un APK grueso, que contiene archivos binarios nativos para cada plataforma de destino especificada.
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>
valor 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 archivo binario que se usa para el procesamiento posterior de los informes de cobertura sin procesar. Actualmente, debe ser un filegroup 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 archivo binario que se usa para generar informes de cobertura. Actualmente, debe ser un filegroup 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 asistencia que se requieren en las entradas de cada acción de prueba que recopila la cobertura del código. El valor predeterminado es “//tools/test:coverage_support”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--custom_malloc=<a build target label>
valor predeterminado: consulta la descripción-
Especifica una implementación de malloc personalizada. Este parámetro de configuración anula los atributos de malloc en las reglas de compilación.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan los usos múltiples de
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
-
Lista de expresiones regulares separadas por comas, cada una con el prefijo opcional - (expresión negativa), asignadas (=) a una lista de destinos de valores de restricción separados por comas. Si un destino no coincide con ninguna expresión negativa y coincide con al menos una expresión positiva, la resolución de su 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 configura, agrega un requisito de ejecución "requires-xcode:{version}" a cada acción de Xcode. Si la versión de Xcode tiene una etiqueta con guion, también agrega un requisito de ejecución "requires-xcode-label:{version_label}".
Etiquetas:loses_incremental_state
,loading_and_analysis
,execution
,experimental
--[no]experimental_prefer_mutual_xcode
predeterminado: "true"-
Si es verdadero, usa el Xcode más reciente que esté disponible de forma local y remota. Si es falso o si no hay versiones disponibles mutuas, usa la versión local de Xcode seleccionada a través de xcode-select.
Etiquetas:loses_incremental_state
,experimental
- 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 objetivo exacto o como un patrón de objetivo. Estas plataformas se considerarán antes de las que se declaren en el archivo WORKSPACE con register_execution_platforms(). Esta opción solo se puede configurar una vez; las instancias posteriores anularán la configuración anterior de la marca.
Etiquetas:execution
- Se acumulan los usos múltiples 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 de las que se declaran en el archivo WORKSPACE con register_toolchains().
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--grte_top=<a label>
valor predeterminado: consulta la descripción-
Es una etiqueta para una biblioteca de libc registrada. El valor predeterminado se selecciona con la cadena de herramientas de compilación cruzada y casi nunca es necesario anularlo.
Etiquetas:action_command_lines
,affects_outputs
--host_compiler=<a string>
valor predeterminado: consulta la descripción-
Es una marca que no realiza ninguna operación. Se quitará en una versión futura.
Etiquetas:loading_and_analysis
,execution
--host_grte_top=<a label>
valor 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 ejecución.
Etiquetas:action_command_lines
,affects_outputs
--host_platform=<a build target label>
valor predeterminado: "@bazel_tools//tools:host_platform"-
Etiqueta de una regla de plataforma que describe el sistema host.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--[no]incompatible_bazel_test_exec_run_under
predeterminado: "false"-
Si está habilitado, "bazel test --run_under=//:runner" compila "//:runner" en la configuración de ejecución. Si está inhabilitado, compila "//:runner" en la configuración de destino. Bazel ejecuta pruebas en máquinas de ejecución, por lo que la primera opción es más correcta. Esto no afecta a "bazel run", que siempre compila "`--run_under=//foo" en la configuración de destino.
Etiquetas:affects_outputs
,incompatible_change
--[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_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 nativas)
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_strip_executable_safely
predeterminado: "false"-
Si es verdadero, la acción de despojo para los ejecutables usará la marca -x, que no interrumpe la resolución de símbolos dinámicos.
Etiquetas:action_command_lines
,incompatible_change
-
Usa objetos compartidos de interfaz si la cadena de herramientas los admite. Actualmente, todas las cadenas de herramientas de 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')>
valor 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')>
valor 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>
valor predeterminado: consulta la descripción-
Es la versión mínima del SO para la que se compila tu app.
Etiquetas:loading_and_analysis
,affects_outputs
- Valor predeterminado de
--platform_mappings=<a main workspace-relative path>
: "" -
Ubicación de un archivo de asignación que describe qué plataforma usar si no se configuró ninguna o qué marcas establecer cuando ya existe una plataforma. Debe ser relativa a la raíz del espacio de trabajo principal. El valor predeterminado es "platform_mappings" (un archivo directamente en la raíz del espacio de trabajo).
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
,immutable
- Valor predeterminado de
--platforms=<a build target label>
: "" -
Son 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
--python_path=<a string>
valor predeterminado: consulta la descripción-
Es la ruta de acceso absoluta del intérprete de Python invocado para ejecutar destinos de Python en la plataforma de destino. Obsoleto; se inhabilita con --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
--python_top=<a build target label>
valor predeterminado: consulta la descripción-
Es 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 inhabilita 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')>
valor 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')>
valor 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>
valor predeterminado: consulta la descripción-
Si se especifica, usa Xcode de la versión indicada para las acciones de compilación pertinentes. Si no se especifica, se usa la versión predeterminada del ejecutor de Xcode.
Etiquetas:loses_incremental_state
--xcode_version_config=<a build target label>
valor 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 vínculos simbólicos de archivos ejecutables para todos los destinos. Si es falso, se escriben solo cuando lo requiere una acción, prueba o comando de ejecución local.
Etiquetas:affects_outputs
--[no]build_runfile_manifests
predeterminado: "true"-
Si es verdadero, escribe manifiestos de archivos ejecutables 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, también se compilará automáticamente el archivo .dwp para el archivo binario de prueba.
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 un cc_proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated set of options>
predeterminado: ".pb.cc"-
Establece los sufijos de los archivos fuente que crea un 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 un 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 resultado de la compilación.
Etiquetas:affects_outputs
,experimental
--fission=<a set of compilation modes>
predeterminado: "no"-
Especifica qué modos de compilación usan fission para las compilaciones y las vinculaciones 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 verdadero, las reglas nativas agregan <code>DefaultInfo.files</code> de las dependencias de datos a sus archivos ejecutables, 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: "false"-
Si es verdadero, compila bosques de vínculos simbólicos 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 configura, se guardarán los resultados temporales de gcc. Estos incluyen archivos .s (código de ensamblador), archivos .i (C preprocesado) y archivos .ii (C++ preprocesado).
Etiquetas:affects_outputs
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
- Se acumulan los usos múltiples de
--action_env=<a 'name=value' assignment with an optional value part>
-
Especifica el conjunto de variables de entorno disponibles para las acciones con configuración de destino. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o bien por el par nombre=valor que establece el valor independientemente del entorno de invocación. Esta opción se puede usar varias veces. En el caso de las opciones proporcionadas para la misma variable, se aplica la más reciente. Las opciones para diferentes variables se acumulan.
Etiquetas:action_command_lines
- Valor predeterminado de
--allowed_cpu_values=<comma-separated set of options>
: "" -
Valores permitidos para la marca --cpu.
Etiquetas:changes_inputs
,affects_outputs
--[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 operación.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]android_databinding_use_v3_4_args
predeterminado: "true"-
Usa la vinculación de datos de Android v2 con el argumento 3.4.0. Esta marca no realiza ninguna operació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 de forma explícita una biblioteca compartida. "default" significa que Bazel elegirá si se vincula de forma dinámica. "fully" significa que todas las bibliotecas se vincularán de forma dinámica. "off" significa que todas las bibliotecas se vincularán principalmente en modo estático.
Etiquetas:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
predeterminado: "alfabético"-
Establece el orden de los manifiestos que se pasan al combinador de manifiestos para los archivos binarios de Android. ALPHABETICAL 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 de 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 los usos múltiples de
--catalyst_cpus=<comma-separated list of options>
-
Lista separada por comas de las arquitecturas para las que se compilarán los archivos 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 cuando 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 se debe especificar directamente. En su lugar, se debe usar el comando "bazel coverage".
Etiquetas:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] valor 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 los usos múltiples 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 los usos múltiples de
--copt=<a string>
-
Opciones adicionales para pasar a gcc.
Etiquetas:action_command_lines
,affects_outputs
- Valor predeterminado de
--cpu=<a string>
: "" -
CPU objetivo.
Etiquetas:changes_inputs
,affects_outputs
--cs_fdo_absolute_path=<a string>
valor 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 de LLVM sin procesar o indexado.
Etiquetas:affects_outputs
--cs_fdo_instrument=<a string>
valor predeterminado: consulta la descripción-
Genera archivos binarios con la 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 en el tiempo de ejecución.
Etiquetas:affects_outputs
--cs_fdo_profile=<a build target label>
valor 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 los usos múltiples 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 los usos múltiples de
--define=<a 'name=value' assignment>
-
Cada opción --define especifica una asignación para una variable de compilación. En caso de que haya varios valores para una variable, se usará el último.
Etiquetas:changes_inputs
,affects_outputs
--dynamic_mode=<off, default or fully>
predeterminado: "default"-
Determina si los archivos binarios de C++ se vincularán de forma dinámica. "default" significa que Bazel elegirá si se vincula de forma dinámica. "fully" significa que todas las bibliotecas se vincularán de forma dinámica. "off" significa que todas las bibliotecas se vincularán principalmente en modo estático.
Etiquetas:loading_and_analysis
,affects_outputs
--[no]enable_propeller_optimize_absolute_paths
predeterminado: "true"-
Si se configura, cualquier uso de rutas absolutas para la optimización de la hélice generará un error.
Etiquetas:affects_outputs
--[no]enable_remaining_fdo_absolute_paths
predeterminado: "true"-
Si se configura, cualquier uso de rutas absolutas para FDO generará un error.
Etiquetas:affects_outputs
--[no]enable_runfiles
predeterminado: "auto"-
Habilita el árbol de vínculos simbólicos de runfiles. De forma predeterminada, está desactivado en Windows y activado en otras plataformas.
Etiquetas:affects_outputs
- Se acumulan los usos múltiples 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
--[no]experimental_android_compress_java_resources
predeterminado: "false"-
Comprimir recursos de Java en APKs
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_android_databinding_v2
predeterminado: "true"-
Usa la vinculación de datos de Android v2. Esta marca no realiza ninguna operació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
,experimental
--[no]experimental_android_rewrite_dexes_with_rex
predeterminado: "false"-
use rex tool to rewrite dex files
Tags: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 recopilación de cobertura para los archivos generados.
Etiquetas:affects_outputs
,experimental
--experimental_objc_fastbuild_options=<comma-separated list of options>
predeterminado: "-O0,-DDEBUG=1"-
Usa estas cadenas como opciones del compilador de compilación rápida de objc.
Etiquetas:action_command_lines
--[no]experimental_omitfp
predeterminado: "false"-
Si es verdadero, usa libunwind para el desenrollado de la pila y compila con -fomit-frame-pointer y -fasynchronous-unwind-tables.
Etiquetas:action_command_lines
,affects_outputs
,experimental
--experimental_output_paths=<off, content or strip>
predeterminado: "off"-
Qué modelo se debe usar para determinar dónde escriben sus resultados las reglas en el árbol de salida, en particular para las compilaciones multiplataforma o con múltiples configuraciones. Esta función 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 agregando la clave "supports-path-mapping" al diccionario "execution_requirements".
Etiquetas:loses_incremental_state
,bazel_internal_configuration
,affects_outputs
,execution
- Se acumulan los usos múltiples 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 corto deseado para usar en la ruta de acceso 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 de plataformas. 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 la plataforma actual. Por último, se usa un hash de la opción de la plataforma como último recurso.
Etiquetas:affects_outputs
,experimental
--[no]experimental_py_binaries_include_label
predeterminado: "false"-
Los destinos py_binary incluyen su etiqueta incluso cuando el sellado está inhabilitado.
Etiquetas:affects_outputs
,experimental
--[no]experimental_use_llvm_covmap
predeterminado: "false"-
Si se especifica, Bazel generará información del mapa de cobertura de llvm-cov en lugar de gcov cuando se habilite collect_code_coverage.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic
predeterminado: "true"-
Usa esta marca solo como parte de una estrategia de prueba o migración sugerida. Ten en cuenta que la heurística tiene deficiencias conocidas y se sugiere migrar para depender solo de --experimental_override_name_platform_in_output_dir.
Etiquetas:affects_outputs
,experimental
--fdo_instrument=<a string>
valor predeterminado: consulta la descripción-
Genera archivos binarios con la instrumentación de FDO. Con el compilador Clang/LLVM, también acepta el nombre del directorio en el que se volcarán los archivos de perfil sin procesar en el tiempo de ejecución.
Etiquetas:affects_outputs
--fdo_optimize=<a string>
valor predeterminado: consulta la descripción-
Usa la información del perfil de FDO para optimizar la compilación. Especifica el nombre de un archivo ZIP que contenga un árbol de archivos .gcda, un archivo AFDO que contenga un perfil automático o un archivo de perfil de LLVM. Esta marca también acepta archivos especificados como etiquetas (p.ej., `//foo/bar:file.afdo`; es posible que debas agregar una directiva `exports_files` al paquete correspondiente) y etiquetas que apuntan a destinos `fdo_profile`. Esta marca se reemplazará por la regla "fdo_profile".
Etiquetas:affects_outputs
--fdo_prefetch_hints=<a build target label>
valor predeterminado: consulta la descripción-
Usa sugerencias de recuperación previa de caché.
Etiquetas:affects_outputs
--fdo_profile=<a build target label>
valor predeterminado: consulta la descripción-
Es el objeto fdo_profile que representa el perfil que se usará para la optimización.
Etiquetas:affects_outputs
- Se acumulan los usos múltiples de
--features=<a string>
-
Las funciones proporcionadas 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. Las funciones negativas siempre anulan las positivas. Consulta también --host_features.
Etiquetas:changes_inputs
,affects_outputs
--[no]force_pic
predeterminado: "false"-
Si está habilitado, todas las compilaciones de C++ producen código independiente de la posición (“-fPIC”), las vinculaciones prefieren las bibliotecas prediseñadas PIC a las bibliotecas no PIC y las vinculaciones producen ejecutables independientes de la posición (“-pie”).
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan los usos múltiples 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 proporcionadas para la misma variable, se aplica la más reciente. Las opciones para diferentes variables se acumulan.
Etiquetas:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
valor predeterminado: "opt"-
Especifica el modo en el que se compilarán las herramientas que se usan durante la compilación. Valores: "fastbuild", "dbg", "opt".
Etiquetas:affects_outputs
,action_command_lines
- Se acumulan los usos múltiples 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 los usos múltiples 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
- Valor predeterminado de
--host_cpu=<a string>
: "" -
Es la CPU del host.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan los usos múltiples de
--host_cxxopt=<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
- Se acumulan los usos múltiples de
--host_features=<a string>
-
Las funciones proporcionadas 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. Las funciones negativas siempre anulan las positivas.
Etiquetas:changes_inputs
,affects_outputs
--host_force_python=<PY2 or PY3>
valor 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 los usos múltiples 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')>
valor predeterminado: consulta la descripción-
Versión mínima de macOS compatible con los destinos de host. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan los usos múltiples 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 de 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. Aquí, regex_filter representa una lista de patrones de expresiones regulares de inclusión y exclusión (consulta también --instrumentation_filter), y option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe incluirse 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
--[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 pliega en el directorio bin.
Etiquetas: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 configura, se instrumentan las reglas de prueba incluidas por --instrumentation_filter. De lo contrario, las reglas de prueba siempre se excluyen de la instrumentación de cobertura.
Etiquetas:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
valor predeterminado: "-/javatests[/:],-/test/java[/:]"-
Cuando la cobertura está habilitada, solo se instrumentarán las reglas con nombres incluidos en el filtro basado en regex especificado. En su lugar, se excluyen las reglas que tienen 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')>
valor predeterminado: consulta la descripción-
Versión mínima compatible de iOS para los simuladores y dispositivos de destino. Si no se especifica, se usa "ios_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan los usos múltiples de
--ios_multi_cpus=<comma-separated list of options>
-
Lista separada por comas de las arquitecturas con las que se compilará un 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. Se reemplazó por --incompatible_remove_legacy_whole_archive (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener más detalles). 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 los usos múltiples de
--linkopt=<a string>
-
Opción adicional para pasar a gcc durante la vinculación.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan los usos múltiples 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 los usos múltiples 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 los usos múltiples de
--macos_cpus=<comma-separated list of options>
-
Lista separada por comas de las arquitecturas para las que se compilarán los archivos 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')>
valor predeterminado: consulta la descripción-
Versión mínima de macOS compatible con los destinos. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
--memprof_profile=<a build target label>
valor predeterminado: consulta la descripción-
Usa el perfil de memprof.
Etiquetas:affects_outputs
--[no]objc_debug_with_GLIBCXX
predeterminado: "false"-
Si se configura 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 no utilizado de los archivos binarios vinculados. Se realizará el despojo de binarios si se especifican esta marca y --compilation_mode=opt.
Etiquetas:action_command_lines
- Se acumulan los usos múltiples 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 los usos múltiples 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. Aquí, regex_filter representa una lista de patrones de expresiones regulares de inclusión y exclusión (consulta también --instrumentation_filter), y option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe incluirse 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 los usos múltiples 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 del backend. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,…,option_n. Aquí regex_filter representa una lista de patrones de expresiones regulares de inclusión y exclusión, y option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe incluirse 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
--platform_suffix=<a string>
valor 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>
valor 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 los 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>
valor predeterminado: consulta la descripción-
Nombre de ruta de acceso absoluta del archivo cc_profile para las compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
valor predeterminado: consulta la descripción-
Nombre de ruta de acceso absoluta del archivo ld_profile para las compilaciones optimizadas con Propeller.
Etiquetas:affects_outputs
--run_under=<a prefix in front of command>
valor predeterminado: consulta la descripción-
Prefijo que se 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" y "//package:target --options".
Etiquetas:action_command_lines
-
Si es verdadero, las bibliotecas nativas que contienen la misma funcionalidad se compartirán entre diferentes destinos.
Etiquetas:loading_and_analysis
,affects_outputs
--[no]stamp
predeterminado: "false"-
Sella los archivos 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 archivos binarios y las bibliotecas compartidas (con "-Wl,--strip-debug"). El valor predeterminado "sometimes" significa que se quita solo si --compilation_mode=fastbuild.
Etiquetas:affects_outputs
- Se acumulan los usos múltiples de
--stripopt=<a string>
-
Opciones adicionales para pasar a strip cuando se genera un objeto binario "<name>.stripped".
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan los usos múltiples de
--tvos_cpus=<comma-separated list of options>
-
Lista separada por comas de las arquitecturas para las que se compilarán los archivos 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')>
valor 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 los usos múltiples de
--visionos_cpus=<comma-separated list of options>
-
Lista separada por comas de las arquitecturas para las que se compilarán los archivos binarios de Apple visionOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Se acumulan los usos múltiples de
--watchos_cpus=<comma-separated list of options>
-
Lista separada por comas de las arquitecturas para las que se compilarán los archivos binarios de watchOS de Apple.
Etiquetas:loses_incremental_state
,loading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
valor 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>
valor predeterminado: consulta la descripción-
Usa la información del perfil de XbinaryFDO para optimizar la compilación. Especifica el nombre del perfil predeterminado de varias plataformas. 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 hubiera especificado.
Etiquetas:affects_outputs
- Opciones que afectan la rigidez con la que Bazel aplica las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
--[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"-
Indica si se debe aplicar desugar al código de bytes de Java 8 antes de convertirlo en dex.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]desugar_java8_libs
predeterminado: "false"-
Indica si se deben incluir las bibliotecas de Java 8 compatibles en las 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 destino y genera errores si algún destino tiene dependencias que no admiten los mismos entornos.
Etiquetas:build_file_semantics
--[no]experimental_check_desugar_deps
predeterminado: "true"-
Indica si se debe verificar la desazucaración correcta a nivel binario de Android.
Etiquetas:eagerness_to_exit
,loading_and_analysis
,experimental
--experimental_import_deps_checking=<a string>
valor predeterminado: consulta la descripción-
No se realiza ninguna operación; se mantiene solo para la retrocompatibilidad
Etiquetas:loading_and_analysis
--experimental_one_version_enforcement=<off, warning or error>
predeterminado: "OFF"-
Cuando se habilita, se aplica 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 la clase. Esta aplicación de la política puede interrumpir la compilación o simplemente generar advertencias.
Etiquetas:loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
predeterminado: "default"-
Si es verdadero, verifica que un destino de Java declare explícitamente todos los destinos que se usan directamente como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files
predeterminado: "false"-
Si está habilitado, verifica testonly para los destinos de requisitos previos que son archivos de salida buscando el testonly de la regla de generación. Esto coincide con la verificación de visibilidad.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_check_visibility_for_toolchains
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 Starlark para Android 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 operación. Se mantiene aquí para la retrocompatibilidad.
Etiquetas:eagerness_to_exit
,incompatible_change
--[no]incompatible_python_disable_py2
predeterminado: "true"-
Si es verdadero, usar la configuración de Python 2 causará 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]one_version_enforcement_on_java_tests
predeterminado: "true"-
Cuando se habilita y experimental_one_version_enforcement se establece en un valor que no sea NONE, se aplica una versión en los destinos de java_test. Esta marca se puede inhabilitar para mejorar el rendimiento de las pruebas incrementales a costa de no detectar posibles incumplimientos de una versión.
Etiquetas:loading_and_analysis
--python_native_rules_allowlist=<a build target label>
valor predeterminado: consulta la descripción-
Lista de entidades permitidas (destino 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 del paquete 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, verifica que un destino proto_library declare explícitamente 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, verifica que un destino proto_library declare de forma explícita todos los destinos 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 los usos múltiples 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 "environment". 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 en Objective-C incluirán derechos de depuración cuando se firmen.
Etiquetas:changes_inputs
--ios_signing_cert_name=<a string>
valor predeterminado: consulta la descripción-
Nombre del certificado que se usará para la firma de iOS. Si no se configura, se volverá al perfil de aprovisionamiento. Puede ser la preferencia de identidad del llavero del certificado o una subcadena del nombre común del certificado, según la página de manual 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 se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]incompatible_disallow_legacy_py_provider
predeterminado: "true"-
No-op, se quitará pronto.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_sdk_frameworks_attributes
predeterminado: "false"-
Si es verdadero, no permite los atributos sdk_frameworks y weak_sdk_frameworks en objc_library y objc_import.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_objc_alwayslink_by_default
predeterminado: "false"-
Si es verdadero, establece el valor predeterminado como verdadero para los atributos alwayslink en objc_library y objc_import.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_python_disallow_native_rules
predeterminado: "false"-
Cuando es verdadero, se produce un error cuando se usan las reglas py_* integradas; en su lugar, se deben usar las reglas rule_python. Consulta https://github.com/bazelbuild/bazel/issues/17773 para obtener más información y las instrucciones de migración.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones que rigen el comportamiento del entorno de prueba o del ejecutor de pruebas:
--[no]allow_analysis_failures
predeterminado: "false"-
Si es verdadero, un error de análisis de un destino de regla hace que el destino propague una instancia de AnalysisFailureInfo que contiene la descripción del error, en lugar de generar un error 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 generará un error de regla.
Etiquetas:loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure
predeterminado: "false"-
Si es verdadero, los errores de la acción dex2oat harán que se interrumpa la compilación en lugar de ejecutar dex2oat durante el tiempo de ejecución de la prueba.
Etiquetas:loading_and_analysis
,experimental
- Se acumulan los usos múltiples 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 predeterminada de recursos para las pruebas. El formato esperado es <recurso>=<valor>. Si se especifica un solo número positivo como <valor>, se anularán los recursos predeterminados para todos los tamaños de prueba. Si se especifican 4 números separados por comas, se anulará la cantidad de recursos para los tamaños de prueba pequeño, mediano, grande y enorme, 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 especificados por esta marca se anulan con los recursos explícitos especificados en las etiquetas.
--[no]experimental_android_use_parallel_dex2oat
predeterminado: "false"-
Usa dex2oat en paralelo para acelerar android_test.
Etiquetas:loading_and_analysis
,host_machine_resource_optimizations
,experimental
--[no]ios_memleaks
predeterminado: "false"-
Habilita la verificación de pérdidas de memoria en los destinos de ios_test.
Etiquetas:action_command_lines
--ios_simulator_device=<a string>
valor predeterminado: consulta la descripción-
Es el dispositivo que se simulará cuando se ejecute una aplicación para iOS en el simulador, p.ej., "iPhone 6". Puedes obtener una lista de dispositivos ejecutando "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')>
valor predeterminado: consulta la descripción-
Versión de iOS que se ejecutará en el simulador cuando se ejecute o pruebe. Se ignora para las reglas de ios_test si se especifica un dispositivo objetivo en la regla.
Etiquetas:test_runner
- Se acumulan los usos múltiples 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ó. Normalmente, el valor especificado es solo un número entero. Ejemplo: --runs_per_test=3 ejecutará todas las pruebas 3 veces. Sintaxis alternativa: regex_filter@runs_per_test. Aquí runs_per_test representa 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 pasar varias veces. Tiene prioridad el argumento que se pasó más recientemente y que coincide. Si no hay coincidencias, la prueba solo se ejecuta una vez.
- Se acumulan los usos múltiples de
--test_env=<a 'name=value' assignment with an optional value part>
-
Especifica variables de entorno adicionales que se insertarán en el entorno del ejecutor de pruebas. Las variables se pueden especificar por nombre, en cuyo caso su valor se leerá del entorno del cliente de Bazel, o por el par nombre=valor. Esta opción se puede usar varias veces para especificar varias variables. Solo se usa con 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 la 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 cualquiera de las dos formas, 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: "false"-
Si es verdadero, los resultados de las pruebas no declarados se archivarán en un archivo ZIP.
Etiquetas:test_runner
- Opciones que activan optimizaciones del tiempo de compilación:
--[no]experimental_filter_library_jar_with_program_jar
predeterminado: "false"-
Filtra el ProgramJar de ProGuard para quitar las clases que también estén presentes en el LibraryJar.
Etiquetas:action_command_lines
,experimental
--[no]experimental_inmemory_dotd_files
predeterminado: "true"-
Si está habilitado, los archivos .d de C++ se pasarán por 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 las compilaciones de Java se pasarán a través de 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_retain_test_configuration_across_testonly
predeterminado: "false"-
Cuando está habilitado, --trim_test_configuration no recortará la configuración de prueba para las reglas marcadas como testonly=1. Esto tiene como objetivo reducir los problemas de conflicto de acciones cuando las reglas que no son de prueba dependen de las reglas cc_test. No tiene efecto si --trim_test_configuration es falso.
Etiquetas:loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_starlark_cc_import
predeterminado: "false"-
Si está habilitado, 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"-
Indica si se deben reducir las entradas a la compilación de C/C++ analizando las líneas #include de los archivos de entrada. Esto puede mejorar el rendimiento y la incrementalidad, ya que disminuye el tamaño de los árboles de entrada de compilación. Sin embargo, también puede interrumpir las compilaciones porque el analizador de inclusión no implementa por completo la semántica del preprocesador de 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 este parámetro que se registren.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
,experimental
--[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 configura, los archivos .d que emite clang se usarán para reducir 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 destino //a:a, se procesan 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, las opciones relacionadas con las pruebas se borrarán 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 el nivel de detalle, 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 cadenas de herramientas y los objetivos específicos para ver cuáles depurar. Se pueden separar varias expresiones regulares 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 los expertos en la resolución de cadenas de herramientas.
Etiquetas:terminal_output
- Opciones que especifican o alteran una entrada genérica para un comando de Bazel que no se incluye en otras categorías.:
- Se acumulan los usos múltiples 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 ejecutables de los destinos de Python. Específicamente, cuando un destino py_binary o py_test tiene legacy_create_init establecido en "auto" (el valor predeterminado), se trata como falso si y 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 vínculo simbólico 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 configuren su atributo `python_version` (o `default_python_version`) se establecerán de forma predeterminada en PY3 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 nativo 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>
valor predeterminado: consulta la descripción-
Modo de versión principal de Python, ya sea "PY2" o "PY3". Ten en cuenta que los objetivos "py_binary" y "py_test" anulan este parámetro (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 varias, no clasificadas de otra manera.:
--[no]cache_test_results
[-t
] default: "auto"- Si se configura como "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 se marca como externa, (3) se solicitaron varias ejecuciones de prueba con --runs_per_test o(4) la prueba falló anteriormente. Si se configura como “sí”, Bazel almacena en caché todos los resultados de las pruebas, excepto las que se marcan como externas. Si se configura como "no", Bazel no almacena en caché ningún resultado de la prueba.
--[no]experimental_cancel_concurrent_tests
predeterminado: "false"-
Si es verdadero, Blaze cancelará las pruebas que se ejecuten de forma simultánea en la primera ejecución exitosa. Esto solo es útil en combinación con --runs_per_test_detects_flakes.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_fetch_all_coverage_outputs
predeterminado: "false"-
Si es verdadero, Bazel recupera el directorio completo de datos de cobertura para cada prueba durante una ejecución de cobertura.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_generate_llvm_lcov
predeterminado: "false"-
Si es verdadero, la cobertura de clang generará un informe de LCOV.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_j2objc_header_map
predeterminado: "true"-
Indica si se debe generar el mapa de encabezado de J2ObjC en paralelo con la transpilación de J2ObjC.
Etiquetas:experimental
--[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
--experimental_java_classpath=<off, javabuilder or bazel>
predeterminado: "javabuilder"- Habilita rutas de acceso de clase reducidas para las compilaciones de Java.
--[no]experimental_limit_android_lint_to_android_constrained_java
predeterminado: "false"-
No-op, kept only for backwards compatibility
Etiquetas:affects_outputs
,experimental
--[no]experimental_run_android_lint_on_java_rules
predeterminado: "false"-
Indica si se deben validar las fuentes java_*.
Etiquetas:affects_outputs
,experimental
--[no]explicit_java_test_deps
predeterminado: "false"- Especifica de forma explícita una dependencia de 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>
valor predeterminado: consulta la descripción- Es el launcher de Java que usan las herramientas que se ejecutan durante una compilación.
- Se acumulan los usos múltiples de
--host_javacopt=<a string>
- Opciones adicionales para pasar a javac cuando se compilan herramientas que se ejecutan durante una compilación.
- Se acumulan los usos múltiples de
--host_jvmopt=<a string>
- Opciones adicionales para pasar a la VM de Java cuando se compilan herramientas que se ejecutan durante la compilación. Estas opciones se agregarán a las opciones de inicio de la VM de cada destino java_binary.
--[no]incompatible_check_sharding_support
predeterminado: "true"-
Si es verdadero, Bazel fallará una prueba fragmentada si el ejecutor de pruebas no indica que admite el fragmentado tocando el archivo en la ruta de TEST_SHARD_STATUS_FILE. Si es falso, un ejecutor de pruebas que no admite 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 una ejecución de 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 esto puede impedir el almacenamiento en caché entre usuarios si se usa una caché compartida.
Etiquetas:loading_and_analysis
,incompatible_change
- Se acumulan los usos múltiples 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, classpath de tiempo de compilación) por destino de Java.
--[no]java_header_compilation
predeterminado: "true"- Compila archivos .ijar directamente desde la fuente.
- Valor predeterminado de
--java_language_version=<a string>
: "" - La versión del lenguaje Java
--java_launcher=<a build target label>
valor predeterminado: consulta la descripción- Es el lanzador de Java que se usará cuando se compilen archivos binarios de Java. Si esta marca se establece en la cadena vacía, se usa el iniciador del JDK. El atributo "launcher" anula esta marca.
--java_runtime_version=<a string>
valor predeterminado: "local_jdk"- La versión del entorno de ejecución de Java
- Se acumulan los usos múltiples de
--javacopt=<a string>
- Opciones adicionales para pasar a javac.
- Se acumulan los usos múltiples de
--jvmopt=<a string>
- Opciones adicionales para pasar a la JVM 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>
valor predeterminado: consulta la descripción- Especifica un archivo binario que se usará para generar la lista de clases que deben estar en el archivo dex principal cuando se compile multidex heredado.
--optimizing_dexer=<a build target label>
valor predeterminado: consulta la descripción- Especifica un objeto binario que se usará para realizar la conversión a dex sin fragmentación.
- Se acumulan los usos múltiples de
--plugin=<a build target label>
- Son los complementos que se usarán en la compilación. Actualmente, funciona con java_plugin.
--proguard_top=<a build target label>
valor predeterminado: consulta la descripción- Especifica qué versión de ProGuard se usará para quitar código cuando se compile un archivo binario de Java.
--proto_compiler=<a build target label>
default: "@bazel_tools//tools/proto:protoc"-
Es la etiqueta del compilador de .proto.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]proto_profile
predeterminado: "true"-
Indica si se debe pasar profile_path al compilador de proto.
Etiquetas:affects_outputs
,loading_and_analysis
--proto_profile_path=<a build target label>
valor predeterminado: consulta la descripción-
Es el perfil que se pasará al compilador de .proto como profile_path. Si no se configura, pero --proto_profile es verdadero (el valor predeterminado), se infiere la ruta de --fdo_optimize.
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
default: "@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>
valor 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>
default: "@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>
default: "@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 los usos múltiples de
--protocopt=<a string>
-
Opciones adicionales para pasar al compilador de protobuf.
Etiquetas:affects_outputs
--[no]runs_per_test_detects_flakes
predeterminado: "false"- Si es verdadero, cualquier fragmento en el que se apruebe al menos una ejecución o intento y falle al menos una ejecución o intento obtendrá el estado FLAKY.
--shell_executable=<a path>
valor predeterminado: consulta la descripción-
Ruta de acceso absoluta al ejecutable del shell que Bazel debe usar. Si no se configura, pero la variable de entorno BAZEL_SH se establece en la primera invocación de Bazel (que inicia un servidor de Bazel), Bazel la usa. Si no se establece ninguno, Bazel usa una ruta de acceso predeterminada codificada de forma rígida según el sistema operativo en el que se ejecuta (Windows: c:/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 provocar fallas en la compilación o en el tiempo de ejecución de los archivos binarios generados.
Etiquetas:loading_and_analysis
- Se acumulan los usos múltiples de
--test_arg=<a string>
- Especifica argumentos y opciones 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 se usa con el comando "bazel test".
--test_filter=<a string>
valor 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.
- Valor predeterminado de
--test_result_expiration=<an integer>
: "-1" - Esta opción está obsoleta y no tiene ningún 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 ante el primer error.
--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 división de pruebas: "explícita" para usar la división solo si el atributo de compilación "shard_count" está presente. "disabled" para no usar nunca la división de pruebas. "forced=k" para forzar "k" fragmentos para las pruebas, independientemente del atributo de compilación "shard_count".
- Valor predeterminado de
--tool_java_language_version=<a string>
: "" - Versión del lenguaje Java que se usa para ejecutar las herramientas necesarias durante una compilación
--tool_java_runtime_version=<a string>
valor predeterminado: "remotejdk_11"- 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 interfaz. Esto generará una compilación incremental más rápida, pero los mensajes de error pueden ser diferentes.
Opciones de volcado
- Opciones que controlan el resultado del comando:
--[no]action_cache
predeterminado: "false"-
Volca el contenido de la caché de acciones.
Etiquetas:bazel_monitoring
--memory=<memory mode>
valor predeterminado: consulta la descripción-
Volca el uso de memoria del nodo de Skyframe determinado.
Etiquetas:bazel_monitoring
--[no]packages
predeterminado: "false"-
Volca el contenido de la caché de paquetes.
Etiquetas:bazel_monitoring
--[no]rule_classes
predeterminado: "false"-
Volca las clases de reglas.
Etiquetas:bazel_monitoring
--[no]rules
predeterminado: "false"-
Reglas de volcado, incluidos los recuentos y el uso de memoria (si se hace un seguimiento de la memoria).
Etiquetas:bazel_monitoring
--skyframe=<off, summary, count, value, deps, rdeps, function_graph, working_set or working_set_frontier_deps>
predeterminado: "off"-
Volca el gráfico de Skyframe.
Etiquetas:bazel_monitoring
- Valor predeterminado de
--skykey_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: ".*" -
Filtro de regex de los nombres de SkyKey que se generarán. Solo se usa con --skyframe=deps, rdeps, function_graph.
Etiquetas:bazel_monitoring
--skylark_memory=<a string>
valor predeterminado: consulta la descripción-
Volca un perfil de memoria compatible con pprof en la ruta de acceso especificada. Para obtener más información, consulta https://github.com/google/pprof.
Etiquetas:bazel_monitoring
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]incompatible_use_plus_in_repo_names
predeterminado: "true"-
No-op.
Etiquetas:loading_and_analysis
Opciones de recuperación
Hereda todas las opciones de test.
- Opciones que controlan la ejecución de la compilación:
--[no]all
predeterminado: "false"-
Recupera todos los repositorios externos necesarios para compilar cualquier destino o repositorio. Este es el valor predeterminado si no se proporcionan otras marcas ni argumentos. Solo funciona cuando --enable_bzlmod está activado.
Etiquetas:changes_inputs
--[no]keep_going
[-k
] predeterminado: "false"-
Continúa lo más posible después de un error. Si bien no se pueden analizar el destino que falló ni los que dependen de él, sí se pueden analizar otros requisitos previos de estos destinos.
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 paralelos 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”), seguida opcionalmente 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 se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility
predeterminado: "false"-
Si incompatible_enforce_config_setting_visibility=false, esta es una operación nula. 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, se aplican 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_use_plus_in_repo_names
predeterminado: "true"-
No-op.
Etiquetas:loading_and_analysis
- Opciones relacionadas con la salida y la semántica de Bzlmod:
--[no]configure
predeterminado: "false"-
Solo recupera los repositorios marcados como "configure" para fines de configuración del sistema. Solo funciona cuando --enable_bzlmod está activado.
Etiquetas:changes_inputs
--[no]force
predeterminado: "false"-
Ignora el repositorio existente (si hay alguno) y fuerza la recuperación del repositorio. Solo funciona cuando --enable_bzlmod está activado.
Etiquetas:changes_inputs
- Se acumulan los usos múltiples 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
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Valor predeterminado de
--experimental_repository_resolved_file=<a string>
: "" -
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 varias, no clasificadas de otra manera.:
- Se acumulan los usos múltiples de
--deleted_packages=<comma-separated list of package names>
- Es una lista separada por comas de los nombres de los 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 muestre un error si encuentra la etiqueta "//x:y/z" si otra entrada de package_path aún la proporciona. Si especificas --deleted_packages x/y, se evita este problema.
--[no]fetch
predeterminado: "true"- Permite que el comando recupere dependencias externas. Si se establece en falso, el comando utilizará cualquier versión almacenada en caché de la dependencia y, si no existe ninguna, el comando fallará.
--package_path=<colon-separated list of options>
valor predeterminado: "%workspace%"- Es una lista separada por dos puntos de las ubicaciones en las que se buscarán 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 "Loading package:".
- Opciones que controlan la ejecución de la compilación:
--[no]experimental_inprocess_symlink_creation
predeterminado: "true"-
Indica si se deben realizar llamadas directas al sistema de archivos para crear árboles de vínculos simbólicos en lugar de delegar en un proceso auxiliar.
Etiquetas:loading_and_analysis
,execution
,experimental
--[no]experimental_persistent_aar_extractor
predeterminado: "false"-
Habilita el extractor de aar persistente con trabajadores.
Etiquetas:execution
,experimental
--[no]experimental_remotable_source_manifests
predeterminado: "false"-
Indica si las acciones del manifiesto fuente se pueden realizar 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 una nueva generación.
Etiquetas:execution
,experimental
--[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 vínculos simbólicos.
Etiquetas:execution
,experimental
--[no]incompatible_modify_execution_info_additive
predeterminado: "false"-
Cuando se habilita, 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 los usos múltiples 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 mnemónica 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 expresiones regulares pueden aplicarse a la misma mnemónica.
La sintaxis es "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" de ella.
"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 Genrule.
Etiquetas:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Habilita acciones persistentes de dex y desugar de Android con trabajadores.
Se expande a:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
-
Habilita el procesador de recursos 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 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=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_tools
-
Habilita herramientas de Android persistentes y multiplexadas (dexing, desugaring, 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.
Tags:execution
- Opciones que configuran la cadena de herramientas que se usa para la ejecución de acciones:
--android_compiler=<a string>
valor predeterminado: consulta la descripción-
Compilador de destino de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
valor predeterminado: "android"-
Selecciona el combinador de manifiestos que se usará para las reglas de android_binary. Es una marca para ayudar en la transición de la herramienta de combinación heredada a la herramienta de combinación de manifiestos de Android.
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 archivo binario es un APK grueso, que contiene archivos binarios nativos para cada plataforma de destino especificada.
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>
valor 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 archivo binario que se usa para el procesamiento posterior de los informes de cobertura sin procesar. Actualmente, debe ser un filegroup 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 archivo binario que se usa para generar informes de cobertura. Actualmente, debe ser un filegroup 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 asistencia que se requieren en las entradas de cada acción de prueba que recopila la cobertura del código. El valor predeterminado es “//tools/test:coverage_support”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--custom_malloc=<a build target label>
valor predeterminado: consulta la descripción-
Especifica una implementación de malloc personalizada. Este parámetro de configuración anula los atributos de malloc en las reglas de compilación.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan los usos múltiples de
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
-
Lista de expresiones regulares separadas por comas, cada una con el prefijo opcional - (expresión negativa), asignadas (=) a una lista de destinos de valores de restricción separados por comas. Si un destino no coincide con ninguna expresión negativa y coincide con al menos una expresión positiva, la resolución de su 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 configura, agrega un requisito de ejecución "requires-xcode:{version}" a cada acción de Xcode. Si la versión de Xcode tiene una etiqueta con guion, también agrega un requisito de ejecución "requires-xcode-label:{version_label}".
Etiquetas:loses_incremental_state
,loading_and_analysis
,execution
,experimental
--[no]experimental_prefer_mutual_xcode
predeterminado: "true"-
Si es verdadero, usa el Xcode más reciente que esté disponible de forma local y remota. Si es falso o si no hay versiones disponibles mutuas, usa la versión local de Xcode seleccionada a través de xcode-select.
Etiquetas:loses_incremental_state
,experimental
- 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 objetivo exacto o como un patrón de objetivo. Estas plataformas se considerarán antes de las que se declaren en el archivo WORKSPACE con register_execution_platforms(). Esta opción solo se puede configurar una vez; las instancias posteriores anularán la configuración anterior de la marca.
Etiquetas:execution
- Se acumulan los usos múltiples 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 de las que se declaran en el archivo WORKSPACE con register_toolchains().
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--grte_top=<a label>
valor predeterminado: consulta la descripción-
Es una etiqueta para una biblioteca de libc registrada. El valor predeterminado se selecciona con la cadena de herramientas de compilación cruzada y casi nunca es necesario anularlo.
Etiquetas:action_command_lines
,affects_outputs
--host_compiler=<a string>
valor predeterminado: consulta la descripción-
Es una marca que no realiza ninguna operación. Se quitará en una versión futura.
Etiquetas:loading_and_analysis
,execution
--host_grte_top=<a label>
valor 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 ejecución.
Etiquetas:action_command_lines
,affects_outputs
--host_platform=<a build target label>
valor predeterminado: "@bazel_tools//tools:host_platform"-
Etiqueta de una regla de plataforma que describe el sistema host.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--[no]incompatible_bazel_test_exec_run_under
predeterminado: "false"-
Si está habilitado, "bazel test --run_under=//:runner" compila "//:runner" en la configuración de ejecución. Si está inhabilitado, compila "//:runner" en la configuración de destino. Bazel ejecuta pruebas en máquinas de ejecución, por lo que la primera opción es más correcta. Esto no afecta a "bazel run", que siempre compila "`--run_under=//foo" en la configuración de destino.
Etiquetas:affects_outputs
,incompatible_change
--[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_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 nativas)
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_strip_executable_safely
predeterminado: "false"-
Si es verdadero, la acción de despojo para los ejecutables usará la marca -x, que no interrumpe la resolución de símbolos dinámicos.
Etiquetas:action_command_lines
,incompatible_change
-
Usa objetos compartidos de interfaz si la cadena de herramientas los admite. Actualmente, todas las cadenas de herramientas de 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')>
valor 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')>
valor 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>
valor predeterminado: consulta la descripción-
Es la versión mínima del SO para la que se compila tu app.
Etiquetas:loading_and_analysis
,affects_outputs
- Valor predeterminado de
--platform_mappings=<a main workspace-relative path>
: "" -
Ubicación de un archivo de asignación que describe qué plataforma usar si no se configuró ninguna o qué marcas establecer cuando ya existe una plataforma. Debe ser relativa a la raíz del espacio de trabajo principal. El valor predeterminado es "platform_mappings" (un archivo directamente en la raíz del espacio de trabajo).
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
,immutable
- Valor predeterminado de
--platforms=<a build target label>
: "" -
Son 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
--python_path=<a string>
valor predeterminado: consulta la descripción-
Es la ruta de acceso absoluta del intérprete de Python invocado para ejecutar destinos de Python en la plataforma de destino. Obsoleto; se inhabilita con --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
--python_top=<a build target label>
valor predeterminado: consulta la descripción-
Es 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 inhabilita 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')>
valor 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')>
valor 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>
valor predeterminado: consulta la descripción-
Si se especifica, usa Xcode de la versión indicada para las acciones de compilación pertinentes. Si no se especifica, se usa la versión predeterminada del ejecutor de Xcode.
Etiquetas:loses_incremental_state
--xcode_version_config=<a build target label>
valor 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 vínculos simbólicos de archivos ejecutables para todos los destinos. Si es falso, se escriben solo cuando lo requiere una acción, prueba o comando de ejecución local.
Etiquetas:affects_outputs
--[no]build_runfile_manifests
predeterminado: "true"-
Si es verdadero, escribe manifiestos de archivos ejecutables 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, también se compilará automáticamente el archivo .dwp para el archivo binario de prueba.
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 un cc_proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated set of options>
predeterminado: ".pb.cc"-
Establece los sufijos de los archivos fuente que crea un 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 un 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 resultado de la compilación.
Etiquetas:affects_outputs
,experimental
--fission=<a set of compilation modes>
predeterminado: "no"-
Especifica qué modos de compilación usan fission para las compilaciones y las vinculaciones 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 verdadero, las reglas nativas agregan <code>DefaultInfo.files</code> de las dependencias de datos a sus archivos ejecutables, 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: "false"-
Si es verdadero, compila bosques de vínculos simbólicos 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 configura, se guardarán los resultados temporales de gcc. Estos incluyen archivos .s (código de ensamblador), archivos .i (C preprocesado) y archivos .ii (C++ preprocesado).
Etiquetas:affects_outputs
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
- Se acumulan los usos múltiples de
--action_env=<a 'name=value' assignment with an optional value part>
-
Especifica el conjunto de variables de entorno disponibles para las acciones con configuración de destino. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o bien por el par nombre=valor que establece el valor independientemente del entorno de invocación. Esta opción se puede usar varias veces. En el caso de las opciones proporcionadas para la misma variable, se aplica la más reciente. Las opciones para diferentes variables se acumulan.
Etiquetas:action_command_lines
- Valor predeterminado de
--allowed_cpu_values=<comma-separated set of options>
: "" -
Valores permitidos para la marca --cpu.
Etiquetas:changes_inputs
,affects_outputs
--[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 operación.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]android_databinding_use_v3_4_args
predeterminado: "true"-
Usa la vinculación de datos de Android v2 con el argumento 3.4.0. Esta marca no realiza ninguna operació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 de forma explícita una biblioteca compartida. "default" significa que Bazel elegirá si se vincula de forma dinámica. "fully" significa que todas las bibliotecas se vincularán de forma dinámica. "off" significa que todas las bibliotecas se vincularán principalmente en modo estático.
Etiquetas:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
predeterminado: "alfabético"-
Establece el orden de los manifiestos que se pasan al combinador de manifiestos para los archivos binarios de Android. ALPHABETICAL 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 de 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 los usos múltiples de
--catalyst_cpus=<comma-separated list of options>
-
Lista separada por comas de las arquitecturas para las que se compilarán los archivos 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 cuando 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 se debe especificar directamente. En su lugar, se debe usar el comando "bazel coverage".
Etiquetas:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] valor 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 los usos múltiples 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 los usos múltiples de
--copt=<a string>
-
Opciones adicionales para pasar a gcc.
Etiquetas:action_command_lines
,affects_outputs
- Valor predeterminado de
--cpu=<a string>
: "" -
CPU objetivo.
Etiquetas:changes_inputs
,affects_outputs
--cs_fdo_absolute_path=<a string>
valor 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 de LLVM sin procesar o indexado.
Etiquetas:affects_outputs
--cs_fdo_instrument=<a string>
valor predeterminado: consulta la descripción-
Genera archivos binarios con la 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 en el tiempo de ejecución.
Etiquetas:affects_outputs
--cs_fdo_profile=<a build target label>
valor 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 los usos múltiples 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 los usos múltiples de
--define=<a 'name=value' assignment>
-
Cada opción --define especifica una asignación para una variable de compilación. En caso de que haya varios valores para una variable, se usará el último.
Etiquetas:changes_inputs
,affects_outputs
--dynamic_mode=<off, default or fully>
predeterminado: "default"-
Determina si los archivos binarios de C++ se vincularán de forma dinámica. "default" significa que Bazel elegirá si se vincula de forma dinámica. "fully" significa que todas las bibliotecas se vincularán de forma dinámica. "off" significa que todas las bibliotecas se vincularán principalmente en modo estático.
Etiquetas:loading_and_analysis
,affects_outputs
--[no]enable_propeller_optimize_absolute_paths
predeterminado: "true"-
Si se configura, cualquier uso de rutas absolutas para la optimización de la hélice generará un error.
Etiquetas:affects_outputs
--[no]enable_remaining_fdo_absolute_paths
predeterminado: "true"-
Si se configura, cualquier uso de rutas absolutas para FDO generará un error.
Etiquetas:affects_outputs
--[no]enable_runfiles
predeterminado: "auto"-
Habilita el árbol de vínculos simbólicos de runfiles. De forma predeterminada, está desactivado en Windows y activado en otras plataformas.
Etiquetas:affects_outputs
- Se acumulan los usos múltiples 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
--[no]experimental_android_compress_java_resources
predeterminado: "false"-
Comprimir recursos de Java en APKs
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_android_databinding_v2
predeterminado: "true"-
Usa la vinculación de datos de Android v2. Esta marca no realiza ninguna operació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
,experimental
--[no]experimental_android_rewrite_dexes_with_rex
predeterminado: "false"-
use rex tool to rewrite dex files
Tags: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 recopilación de cobertura para los archivos generados.
Etiquetas:affects_outputs
,experimental
--experimental_objc_fastbuild_options=<comma-separated list of options>
predeterminado: "-O0,-DDEBUG=1"-
Usa estas cadenas como opciones del compilador de compilación rápida de objc.
Etiquetas:action_command_lines
--[no]experimental_omitfp
predeterminado: "false"-
Si es verdadero, usa libunwind para el desenrollado de la pila y compila con -fomit-frame-pointer y -fasynchronous-unwind-tables.
Etiquetas:action_command_lines
,affects_outputs
,experimental
--experimental_output_paths=<off, content or strip>
predeterminado: "off"-
Qué modelo se debe usar para determinar dónde escriben sus resultados las reglas en el árbol de salida, en particular para las compilaciones multiplataforma o con múltiples configuraciones. Esta función 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 agregando la clave "supports-path-mapping" al diccionario "execution_requirements".
Etiquetas:loses_incremental_state
,bazel_internal_configuration
,affects_outputs
,execution
- Se acumulan los usos múltiples 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 corto deseado para usar en la ruta de acceso 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 de plataformas. 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 la plataforma actual. Por último, se usa un hash de la opción de la plataforma como último recurso.
Etiquetas:affects_outputs
,experimental
--[no]experimental_py_binaries_include_label
predeterminado: "false"-
Los destinos py_binary incluyen su etiqueta incluso cuando el sellado está inhabilitado.
Etiquetas:affects_outputs
,experimental
--[no]experimental_use_llvm_covmap
predeterminado: "false"-
Si se especifica, Bazel generará información del mapa de cobertura de llvm-cov en lugar de gcov cuando se habilite collect_code_coverage.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic
predeterminado: "true"-
Usa esta marca solo como parte de una estrategia de prueba o migración sugerida. Ten en cuenta que la heurística tiene deficiencias conocidas y se sugiere migrar para depender solo de --experimental_override_name_platform_in_output_dir.
Etiquetas:affects_outputs
,experimental
--fdo_instrument=<a string>
valor predeterminado: consulta la descripción-
Genera archivos binarios con la instrumentación de FDO. Con el compilador Clang/LLVM, también acepta el nombre del directorio en el que se volcarán los archivos de perfil sin procesar en el tiempo de ejecución.
Etiquetas:affects_outputs
--fdo_optimize=<a string>
valor predeterminado: consulta la descripción-
Usa la información del perfil de FDO para optimizar la compilación. Especifica el nombre de un archivo ZIP que contenga un árbol de archivos .gcda, un archivo AFDO que contenga un perfil automático o un archivo de perfil de LLVM. Esta marca también acepta archivos especificados como etiquetas (p.ej., `//foo/bar:file.afdo`; es posible que debas agregar una directiva `exports_files` al paquete correspondiente) y etiquetas que apuntan a destinos `fdo_profile`. Esta marca se reemplazará por la regla "fdo_profile".
Etiquetas:affects_outputs
--fdo_prefetch_hints=<a build target label>
valor predeterminado: consulta la descripción-
Usa sugerencias de recuperación previa de caché.
Etiquetas:affects_outputs
--fdo_profile=<a build target label>
valor predeterminado: consulta la descripción-
Es el objeto fdo_profile que representa el perfil que se usará para la optimización.
Etiquetas:affects_outputs
- Se acumulan los usos múltiples de
--features=<a string>
-
Las funciones proporcionadas 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. Las funciones negativas siempre anulan las positivas. Consulta también --host_features.
Etiquetas:changes_inputs
,affects_outputs
--[no]force_pic
predeterminado: "false"-
Si está habilitado, todas las compilaciones de C++ producen código independiente de la posición (“-fPIC”), las vinculaciones prefieren las bibliotecas prediseñadas PIC a las bibliotecas no PIC y las vinculaciones producen ejecutables independientes de la posición (“-pie”).
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan los usos múltiples 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 proporcionadas para la misma variable, se aplica la más reciente. Las opciones para diferentes variables se acumulan.
Etiquetas:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
valor predeterminado: "opt"-
Especifica el modo en el que se compilarán las herramientas que se usan durante la compilación. Valores: "fastbuild", "dbg", "opt".
Etiquetas:affects_outputs
,action_command_lines
- Se acumulan los usos múltiples 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 los usos múltiples 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
- Valor predeterminado de
--host_cpu=<a string>
: "" -
Es la CPU del host.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan los usos múltiples de
--host_cxxopt=<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
- Se acumulan los usos múltiples de
--host_features=<a string>
-
Las funciones proporcionadas 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. Las funciones negativas siempre anulan las positivas.
Etiquetas:changes_inputs
,affects_outputs
--host_force_python=<PY2 or PY3>
valor 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 los usos múltiples 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')>
valor predeterminado: consulta la descripción-
Versión mínima de macOS compatible con los destinos de host. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan los usos múltiples 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 de 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. Aquí, regex_filter representa una lista de patrones de expresiones regulares de inclusión y exclusión (consulta también --instrumentation_filter), y option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe incluirse 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
--[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 pliega en el directorio bin.
Etiquetas: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 configura, se instrumentan las reglas de prueba incluidas por --instrumentation_filter. De lo contrario, las reglas de prueba siempre se excluyen de la instrumentación de cobertura.
Etiquetas:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
valor predeterminado: "-/javatests[/:],-/test/java[/:]"-
Cuando la cobertura está habilitada, solo se instrumentarán las reglas con nombres incluidos en el filtro basado en regex especificado. En su lugar, se excluyen las reglas que tienen 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')>
valor predeterminado: consulta la descripción-
Versión mínima compatible de iOS para los simuladores y dispositivos de destino. Si no se especifica, se usa "ios_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan los usos múltiples de
--ios_multi_cpus=<comma-separated list of options>
-
Lista separada por comas de las arquitecturas con las que se compilará un 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. Se reemplazó por --incompatible_remove_legacy_whole_archive (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener más detalles). 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 los usos múltiples de
--linkopt=<a string>
-
Opción adicional para pasar a gcc durante la vinculación.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan los usos múltiples 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 los usos múltiples 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 los usos múltiples de
--macos_cpus=<comma-separated list of options>
-
Lista separada por comas de las arquitecturas para las que se compilarán los archivos 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')>
valor predeterminado: consulta la descripción-
Versión mínima de macOS compatible con los destinos. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
--memprof_profile=<a build target label>
valor predeterminado: consulta la descripción-
Usa el perfil de memprof.
Etiquetas:affects_outputs
--[no]objc_debug_with_GLIBCXX
predeterminado: "false"-
Si se configura 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 no utilizado de los archivos binarios vinculados. Se realizará el despojo de binarios si se especifican esta marca y --compilation_mode=opt.
Etiquetas:action_command_lines
- Se acumulan los usos múltiples 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 los usos múltiples 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. Aquí, regex_filter representa una lista de patrones de expresiones regulares de inclusión y exclusión (consulta también --instrumentation_filter), y option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe incluirse 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 los usos múltiples 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 del backend. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,…,option_n. Aquí regex_filter representa una lista de patrones de expresiones regulares de inclusión y exclusión, y option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe incluirse 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
--platform_suffix=<a string>
valor 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>
valor 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 los 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>
valor predeterminado: consulta la descripción-
Nombre de ruta de acceso absoluta del archivo cc_profile para las compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
valor predeterminado: consulta la descripción-
Nombre de ruta de acceso absoluta del archivo ld_profile para las compilaciones optimizadas con Propeller.
Etiquetas:affects_outputs
--run_under=<a prefix in front of command>
valor predeterminado: consulta la descripción-
Prefijo que se 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" y "//package:target --options".
Etiquetas:action_command_lines
-
Si es verdadero, las bibliotecas nativas que contienen la misma funcionalidad se compartirán entre diferentes destinos.
Etiquetas:loading_and_analysis
,affects_outputs
--[no]stamp
predeterminado: "false"-
Sella los archivos 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 archivos binarios y las bibliotecas compartidas (con "-Wl,--strip-debug"). El valor predeterminado "sometimes" significa que se quita solo si --compilation_mode=fastbuild.
Etiquetas:affects_outputs
- Se acumulan los usos múltiples de
--stripopt=<a string>
-
Opciones adicionales para pasar a strip cuando se genera un objeto binario "<name>.stripped".
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan los usos múltiples de
--tvos_cpus=<comma-separated list of options>
-
Lista separada por comas de las arquitecturas para las que se compilarán los archivos 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')>
valor 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 los usos múltiples de
--visionos_cpus=<comma-separated list of options>
-
Lista separada por comas de las arquitecturas para las que se compilarán los archivos binarios de Apple visionOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Se acumulan los usos múltiples de
--watchos_cpus=<comma-separated list of options>
-
Lista separada por comas de las arquitecturas para las que se compilarán los archivos binarios de watchOS de Apple.
Etiquetas:loses_incremental_state
,loading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
valor 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>
valor predeterminado: consulta la descripción-
Usa la información del perfil de XbinaryFDO para optimizar la compilación. Especifica el nombre del perfil predeterminado de varias plataformas. 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 hubiera especificado.
Etiquetas:affects_outputs
- Opciones que afectan la rigidez con la que Bazel aplica las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
--[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"-
Indica si se debe aplicar desugar al código de bytes de Java 8 antes de convertirlo en dex.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]desugar_java8_libs
predeterminado: "false"-
Indica si se deben incluir las bibliotecas de Java 8 compatibles en las 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 destino y genera errores si algún destino tiene dependencias que no admiten los mismos entornos.
Etiquetas:build_file_semantics
--[no]experimental_check_desugar_deps
predeterminado: "true"-
Indica si se debe verificar la desazucaración correcta a nivel binario de Android.
Etiquetas:eagerness_to_exit
,loading_and_analysis
,experimental
--experimental_import_deps_checking=<a string>
valor predeterminado: consulta la descripción-
No se realiza ninguna operación; se mantiene solo para la retrocompatibilidad
Etiquetas:loading_and_analysis
--experimental_one_version_enforcement=<off, warning or error>
predeterminado: "OFF"-
Cuando se habilita, se aplica 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 la clase. Esta aplicación de la política puede interrumpir la compilación o simplemente generar advertencias.
Etiquetas:loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
predeterminado: "default"-
Si es verdadero, verifica que un destino de Java declare explícitamente todos los destinos que se usan directamente como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files
predeterminado: "false"-
Si está habilitado, verifica testonly para los destinos de requisitos previos que son archivos de salida buscando el testonly de la regla de generación. Esto coincide con la verificación de visibilidad.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_check_visibility_for_toolchains
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 Starlark para Android 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 operación. Se mantiene aquí para la retrocompatibilidad.
Etiquetas:eagerness_to_exit
,incompatible_change
--[no]incompatible_python_disable_py2
predeterminado: "true"-
Si es verdadero, usar la configuración de Python 2 causará 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]one_version_enforcement_on_java_tests
predeterminado: "true"-
Cuando se habilita y experimental_one_version_enforcement se establece en un valor que no sea NONE, se aplica una versión en los destinos de java_test. Esta marca se puede inhabilitar para mejorar el rendimiento de las pruebas incrementales a costa de no detectar posibles incumplimientos de una versión.
Etiquetas:loading_and_analysis
--python_native_rules_allowlist=<a build target label>
valor predeterminado: consulta la descripción-
Lista de entidades permitidas (destino 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 del paquete 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, verifica que un destino proto_library declare explícitamente 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, verifica que un destino proto_library declare de forma explícita todos los destinos 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 los usos múltiples 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 "environment". 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 en Objective-C incluirán derechos de depuración cuando se firmen.
Etiquetas:changes_inputs
--ios_signing_cert_name=<a string>
valor predeterminado: consulta la descripción-
Nombre del certificado que se usará para la firma de iOS. Si no se configura, se volverá al perfil de aprovisionamiento. Puede ser la preferencia de identidad del llavero del certificado o una subcadena del nombre común del certificado, según la página de manual 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 se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]incompatible_disallow_legacy_py_provider
predeterminado: "true"-
No-op, se quitará pronto.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_sdk_frameworks_attributes
predeterminado: "false"-
Si es verdadero, no permite los atributos sdk_frameworks y weak_sdk_frameworks en objc_library y objc_import.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_objc_alwayslink_by_default
predeterminado: "false"-
Si es verdadero, establece el valor predeterminado como verdadero para los atributos alwayslink en objc_library y objc_import.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_python_disallow_native_rules
predeterminado: "false"-
Cuando es verdadero, se produce un error cuando se usan las reglas py_* integradas; en su lugar, se deben usar las reglas rule_python. Consulta https://github.com/bazelbuild/bazel/issues/17773 para obtener más información y las instrucciones de migración.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones que rigen el comportamiento del entorno de prueba o del ejecutor de pruebas:
--[no]allow_analysis_failures
predeterminado: "false"-
Si es verdadero, un error de análisis de un destino de regla hace que el destino propague una instancia de AnalysisFailureInfo que contiene la descripción del error, en lugar de generar un error 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 generará un error de regla.
Etiquetas:loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure
predeterminado: "false"-
Si es verdadero, los errores de la acción dex2oat harán que se interrumpa la compilación en lugar de ejecutar dex2oat durante el tiempo de ejecución de la prueba.
Etiquetas:loading_and_analysis
,experimental
- Se acumulan los usos múltiples 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 predeterminada de recursos para las pruebas. El formato esperado es <recurso>=<valor>. Si se especifica un solo número positivo como <valor>, se anularán los recursos predeterminados para todos los tamaños de prueba. Si se especifican 4 números separados por comas, se anulará la cantidad de recursos para los tamaños de prueba pequeño, mediano, grande y enorme, 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 especificados por esta marca se anulan con los recursos explícitos especificados en las etiquetas.
--[no]experimental_android_use_parallel_dex2oat
predeterminado: "false"-
Usa dex2oat en paralelo para acelerar android_test.
Etiquetas:loading_and_analysis
,host_machine_resource_optimizations
,experimental
--[no]ios_memleaks
predeterminado: "false"-
Habilita la verificación de pérdidas de memoria en los destinos de ios_test.
Etiquetas:action_command_lines
--ios_simulator_device=<a string>
valor predeterminado: consulta la descripción-
Es el dispositivo que se simulará cuando se ejecute una aplicación para iOS en el simulador, p.ej., "iPhone 6". Puedes obtener una lista de dispositivos ejecutando "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')>
valor predeterminado: consulta la descripción-
Versión de iOS que se ejecutará en el simulador cuando se ejecute o pruebe. Se ignora para las reglas de ios_test si se especifica un dispositivo objetivo en la regla.
Etiquetas:test_runner
- Se acumulan los usos múltiples 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ó. Normalmente, el valor especificado es solo un número entero. Ejemplo: --runs_per_test=3 ejecutará todas las pruebas 3 veces. Sintaxis alternativa: regex_filter@runs_per_test. Aquí runs_per_test representa 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 pasar varias veces. Tiene prioridad el argumento que se pasó más recientemente y que coincide. Si no hay coincidencias, la prueba solo se ejecuta una vez.
- Se acumulan los usos múltiples de
--test_env=<a 'name=value' assignment with an optional value part>
-
Especifica variables de entorno adicionales que se insertarán en el entorno del ejecutor de pruebas. Las variables se pueden especificar por nombre, en cuyo caso su valor se leerá del entorno del cliente de Bazel, o por el par nombre=valor. Esta opción se puede usar varias veces para especificar varias variables. Solo se usa con 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 la 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 cualquiera de las dos formas, 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: "false"-
Si es verdadero, los resultados de las pruebas no declarados se archivarán en un archivo ZIP.
Etiquetas:test_runner
- Opciones que activan optimizaciones del tiempo de compilación:
--[no]experimental_filter_library_jar_with_program_jar
predeterminado: "false"-
Filtra el ProgramJar de ProGuard para quitar las clases que también estén presentes en el LibraryJar.
Etiquetas:action_command_lines
,experimental
--[no]experimental_inmemory_dotd_files
predeterminado: "true"-
Si está habilitado, los archivos .d de C++ se pasarán por 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 las compilaciones de Java se pasarán a través de 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_retain_test_configuration_across_testonly
predeterminado: "false"-
Cuando está habilitado, --trim_test_configuration no recortará la configuración de prueba para las reglas marcadas como testonly=1. Esto tiene como objetivo reducir los problemas de conflicto de acciones cuando las reglas que no son de prueba dependen de las reglas cc_test. No tiene efecto si --trim_test_configuration es falso.
Etiquetas:loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_starlark_cc_import
predeterminado: "false"-
Si está habilitado, 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"-
Indica si se deben reducir las entradas a la compilación de C/C++ analizando las líneas #include de los archivos de entrada. Esto puede mejorar el rendimiento y la incrementalidad, ya que disminuye el tamaño de los árboles de entrada de compilación. Sin embargo, también puede interrumpir las compilaciones porque el analizador de inclusión no implementa por completo la semántica del preprocesador de 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 este parámetro que se registren.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
,experimental
--[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 configura, los archivos .d que emite clang se usarán para reducir 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 destino //a:a, se procesan 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, las opciones relacionadas con las pruebas se borrarán 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 el nivel de detalle, 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 cadenas de herramientas y los objetivos específicos para ver cuáles depurar. Se pueden separar varias expresiones regulares 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 los expertos en la resolución de cadenas de herramientas.
Etiquetas:terminal_output
- Opciones que especifican o alteran una entrada genérica para un comando de Bazel que no se incluye en otras categorías.:
- Se acumulan los usos múltiples 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 ejecutables de los destinos de Python. Específicamente, cuando un destino py_binary o py_test tiene legacy_create_init establecido en "auto" (el valor predeterminado), se trata como falso si y 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 vínculo simbólico 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 configuren su atributo `python_version` (o `default_python_version`) se establecerán de forma predeterminada en PY3 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 nativo 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>
valor predeterminado: consulta la descripción-
Modo de versión principal de Python, ya sea "PY2" o "PY3". Ten en cuenta que los objetivos "py_binary" y "py_test" anulan este parámetro (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 varias, no clasificadas de otra manera.:
--[no]cache_test_results
[-t
] default: "auto"- Si se configura como "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 se marca como externa, (3) se solicitaron varias ejecuciones de prueba con --runs_per_test o(4) la prueba falló anteriormente. Si se configura como “sí”, Bazel almacena en caché todos los resultados de las pruebas, excepto las que se marcan como externas. Si se configura como "no", Bazel no almacena en caché ningún resultado de la prueba.
--[no]experimental_cancel_concurrent_tests
predeterminado: "false"-
Si es verdadero, Blaze cancelará las pruebas que se ejecuten de forma simultánea en la primera ejecución exitosa. Esto solo es útil en combinación con --runs_per_test_detects_flakes.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_fetch_all_coverage_outputs
predeterminado: "false"-
Si es verdadero, Bazel recupera el directorio completo de datos de cobertura para cada prueba durante una ejecución de cobertura.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_generate_llvm_lcov
predeterminado: "false"-
Si es verdadero, la cobertura de clang generará un informe de LCOV.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_j2objc_header_map
predeterminado: "true"-
Indica si se debe generar el mapa de encabezado de J2ObjC en paralelo con la transpilación de J2ObjC.
Etiquetas:experimental
--[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
--experimental_java_classpath=<off, javabuilder or bazel>
predeterminado: "javabuilder"- Habilita rutas de acceso de clase reducidas para las compilaciones de Java.
--[no]experimental_limit_android_lint_to_android_constrained_java
predeterminado: "false"-
No-op, kept only for backwards compatibility
Etiquetas:affects_outputs
,experimental
--[no]experimental_run_android_lint_on_java_rules
predeterminado: "false"-
Indica si se deben validar las fuentes java_*.
Etiquetas:affects_outputs
,experimental
--[no]explicit_java_test_deps
predeterminado: "false"- Especifica de forma explícita una dependencia de 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>
valor predeterminado: consulta la descripción- Es el launcher de Java que usan las herramientas que se ejecutan durante una compilación.
- Se acumulan los usos múltiples de
--host_javacopt=<a string>
- Opciones adicionales para pasar a javac cuando se compilan herramientas que se ejecutan durante una compilación.
- Se acumulan los usos múltiples de
--host_jvmopt=<a string>
- Opciones adicionales para pasar a la VM de Java cuando se compilan herramientas que se ejecutan durante la compilación. Estas opciones se agregarán a las opciones de inicio de la VM de cada destino java_binary.
--[no]incompatible_check_sharding_support
predeterminado: "true"-
Si es verdadero, Bazel fallará una prueba fragmentada si el ejecutor de pruebas no indica que admite el fragmentado tocando el archivo en la ruta de TEST_SHARD_STATUS_FILE. Si es falso, un ejecutor de pruebas que no admite 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 una ejecución de 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 esto puede impedir el almacenamiento en caché entre usuarios si se usa una caché compartida.
Etiquetas:loading_and_analysis
,incompatible_change
- Se acumulan los usos múltiples 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, classpath de tiempo de compilación) por destino de Java.
--[no]java_header_compilation
predeterminado: "true"- Compila archivos .ijar directamente desde la fuente.
- Valor predeterminado de
--java_language_version=<a string>
: "" - La versión del lenguaje Java
--java_launcher=<a build target label>
valor predeterminado: consulta la descripción- Es el lanzador de Java que se usará cuando se compilen archivos binarios de Java. Si esta marca se establece en la cadena vacía, se usa el iniciador del JDK. El atributo "launcher" anula esta marca.
--java_runtime_version=<a string>
valor predeterminado: "local_jdk"- La versión del entorno de ejecución de Java
- Se acumulan los usos múltiples de
--javacopt=<a string>
- Opciones adicionales para pasar a javac.
- Se acumulan los usos múltiples de
--jvmopt=<a string>
- Opciones adicionales para pasar a la JVM 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>
valor predeterminado: consulta la descripción- Especifica un archivo binario que se usará para generar la lista de clases que deben estar en el archivo dex principal cuando se compile multidex heredado.
--optimizing_dexer=<a build target label>
valor predeterminado: consulta la descripción- Especifica un objeto binario que se usará para realizar la conversión a dex sin fragmentación.
- Se acumulan los usos múltiples de
--plugin=<a build target label>
- Son los complementos que se usarán en la compilación. Actualmente, funciona con java_plugin.
--proguard_top=<a build target label>
valor predeterminado: consulta la descripción- Especifica qué versión de ProGuard se usará para quitar código cuando se compile un archivo binario de Java.
--proto_compiler=<a build target label>
default: "@bazel_tools//tools/proto:protoc"-
Es la etiqueta del compilador de .proto.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]proto_profile
predeterminado: "true"-
Indica si se debe pasar profile_path al compilador de proto.
Etiquetas:affects_outputs
,loading_and_analysis
--proto_profile_path=<a build target label>
valor predeterminado: consulta la descripción-
Es el perfil que se pasará al compilador de .proto como profile_path. Si no se configura, pero --proto_profile es verdadero (el valor predeterminado), se infiere la ruta de --fdo_optimize.
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
default: "@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>
valor 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>
default: "@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>
default: "@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 los usos múltiples de
--protocopt=<a string>
-
Opciones adicionales para pasar al compilador de protobuf.
Etiquetas:affects_outputs
--[no]runs_per_test_detects_flakes
predeterminado: "false"- Si es verdadero, cualquier fragmento en el que se apruebe al menos una ejecución o intento y falle al menos una ejecución o intento obtendrá el estado FLAKY.
--shell_executable=<a path>
valor predeterminado: consulta la descripción-
Ruta de acceso absoluta al ejecutable del shell que Bazel debe usar. Si no se configura, pero la variable de entorno BAZEL_SH se establece en la primera invocación de Bazel (que inicia un servidor de Bazel), Bazel la usa. Si no se establece ninguno, Bazel usa una ruta de acceso predeterminada codificada de forma rígida según el sistema operativo en el que se ejecuta (Windows: c:/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 provocar fallas en la compilación o en el tiempo de ejecución de los archivos binarios generados.
Etiquetas:loading_and_analysis
- Se acumulan los usos múltiples de
--test_arg=<a string>
- Especifica argumentos y opciones 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 se usa con el comando "bazel test".
--test_filter=<a string>
valor 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.
- Valor predeterminado de
--test_result_expiration=<an integer>
: "-1" - Esta opción está obsoleta y no tiene ningún 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 ante el primer error.
--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 división de pruebas: "explícita" para usar la división solo si el atributo de compilación "shard_count" está presente. "disabled" para no usar nunca la división de pruebas. "forced=k" para forzar "k" fragmentos para las pruebas, independientemente del atributo de compilación "shard_count".
- Valor predeterminado de
--tool_java_language_version=<a string>
: "" - Versión del lenguaje Java que se usa para ejecutar las herramientas necesarias durante una compilación
--tool_java_runtime_version=<a string>
valor predeterminado: "remotejdk_11"- 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 interfaz. Esto generará una compilación incremental más rápida, pero los mensajes de error pueden ser diferentes.
Opciones de ayuda
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]incompatible_use_plus_in_repo_names
predeterminado: "true"-
No-op.
Etiquetas:loading_and_analysis
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--help_verbosity=<long, medium or short>
predeterminado: "medium"-
Selecciona el nivel de detalle del comando de ayuda.
Etiquetas: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:terminal_output
--short
-
Muestra solo los nombres de las opciones, no sus tipos ni significados.
Se expande a:
--help_verbosity=short
Etiquetas:terminal_output
Opciones de información
Hereda todas las opciones de build.
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]incompatible_use_plus_in_repo_names
predeterminado: "true"-
No-op.
Etiquetas:loading_and_analysis
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]show_make_env
predeterminado: "false"-
Incluye el entorno "Make" en el resultado.
Etiquetas:affects_outputs
,terminal_output
Opciones de licencia
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]incompatible_use_plus_in_repo_names
predeterminado: "true"-
No-op.
Etiquetas:loading_and_analysis
Opciones de instalación en dispositivos móviles
Hereda todas las opciones de build.
- Opciones que controlan la ejecución de la compilación:
--mode=<classic, classic_internal_test_do_not_use or skylark>
predeterminado: "skylark"-
Marca obsoleta sin efecto. Solo se sigue admitiendo el modo Skylark.
Etiquetas:loading_and_analysis
,execution
,incompatible_change
- Opciones que configuran la cadena de herramientas que se usa para la ejecución de acciones:
- Valor predeterminado de
--adb=<a string>
: "" -
Objeto binario de adb que se usará para el comando "mobile-install". Si no se especifica, se usa el que se encuentra en el SDK de Android especificado por la opción de línea de comandos --android_sdk_channel (o el SDK predeterminado si no se especifica --android_sdk_channel).
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 trabajo adicional innecesario leyendo el estado del dispositivo en el que se instalará el código y usando esa información para evitar trabajo innecesario. Si es falso (valor predeterminado), siempre se realiza una instalación completa.
Etiquetas:loading_and_analysis
--[no]split_apks
predeterminado: "false"-
Indica si se deben usar APKs divididos para instalar y actualizar la aplicación en el dispositivo. Solo funciona con dispositivos con Marshmallow o versiones posteriores
Etiquetas:loading_and_analysis
,affects_outputs
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, a diferencia de su existencia:
- Se acumulan los usos múltiples de
--adb_arg=<a string>
-
Argumentos adicionales que se pasarán a adb. Se suele usar para designar un dispositivo en el que se instalará.
Etiquetas:action_command_lines
--debug_app
-
Indica si se debe esperar al depurador antes de iniciar la app.
Se expande a:
--start=DEBUG
Etiquetas:execution
- Valor predeterminado de
--device=<a string>
: "" -
Es el número de serie del dispositivo de adb. Si no se especifica, se usará el primer dispositivo.
Etiquetas:action_command_lines
--start=<no, cold, warm or debug>
valor predeterminado: "NO"-
Cómo se debe iniciar la app después de instalarla. Se establece en WARM para conservar y restablecer el estado de la aplicación en las instalaciones incrementales.
Etiquetas:execution
--start_app
-
Indica si se debe iniciar la app después de instalarla.
Se expande a:
--start=COLD
Etiquetas:execution
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]incompatible_use_plus_in_repo_names
predeterminado: "true"-
No-op.
Etiquetas:loading_and_analysis
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Valor predeterminado de
--incremental_install_verbosity=<a string>
: "" -
Es el nivel de detalle de la instalación incremental. Se establece en 1 para el registro de depuración.
Etiquetas:bazel_monitoring
Opciones de modificación
- Opciones que controlan la ejecución de la compilación:
--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 paralelos 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”), seguida opcionalmente 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 se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility
predeterminado: "false"-
Si incompatible_enforce_config_setting_visibility=false, esta es una operación nula. 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, se aplican 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_use_plus_in_repo_names
predeterminado: "true"-
No-op.
Etiquetas:loading_and_analysis
- Opciones relacionadas con la salida y la semántica del subcomando "mod":
--base_module=<"<root>" for the root module; <module>@<version> for a specific version of a module; <module> for all versions of a module; @<name> for a repo with the given apparent name; or @@<name> for a repo with the given canonical name>
valor predeterminado: "<root>"-
Especifica un módulo en relación con el cual se interpretarán los repositorios de destino especificados.
Etiquetas:terminal_output
--charset=<utf8 or ascii>
predeterminado: "utf8"-
Elige el conjunto de caracteres que se usará para el árbol. Solo afecta la salida de texto. Los valores válidos son “utf8” o “ascii”. El valor predeterminado es "utf8".
Etiquetas:terminal_output
--[no]cycles
predeterminado: "false"-
Señala 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 máxima de visualización del árbol de dependencias. Por ejemplo, una profundidad de 1 muestra las dependencias directas. Para tree, path y all_paths, el valor predeterminado es Integer.MAX_VALUE, mientras que para deps y explain, el valor predeterminado es 1 (solo se muestran 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>
valor predeterminado: consulta la descripción-
Solo se muestran los usos de estas extensiones de módulos y los repositorios que generan si se configuran sus respectivas marcas. Si se configura, el gráfico de resultados solo incluirá rutas que contengan módulos que usen las extensiones especificadas. Una lista vacía inhabilita el filtro y especifica 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 búsqueda. "Usages" solo mostrará los nombres de las extensiones, "repos" también incluirá los repositorios importados con use_repo y "all" también mostrará los otros repositorios generados por las extensiones.
Etiquetas:terminal_output
- Valor predeterminado de
--extension_usages=<a comma-separated list of <module>s>
: "" -
Especifica los módulos cuyos usos de extensiones se mostrarán en la búsqueda show_extension.
Etiquetas:terminal_output
--from=<a comma-separated list of <module>s>
valor predeterminado: "<root>"-
Son los módulos a partir de los cuales se mostrará la consulta del gráfico de dependencias. Consulta la descripción de cada búsqueda para conocer la semántica exacta. El valor predeterminado es <root>.
Etiquetas:terminal_output
--[no]include_builtin
predeterminado: "false"-
Incluye módulos integrados en el gráfico de dependencias. Está inhabilitado de forma predeterminada porque genera mucho ruido.
Etiquetas:terminal_output
--[no]include_unused
predeterminado: "false"-
Las búsquedas 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 a las reglas de anulación). Esto puede tener diferentes efectos para cada uno de los tipos de consultas, es decir, incluir nuevas rutas 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 búsqueda. Los valores permitidos para la búsqueda son: text, json, graph.
Etiquetas:terminal_output
--[no]verbose
predeterminado: "false"-
Las búsquedas también mostrarán el motivo por el que los módulos se resolvieron en su versión actual (si se cambió). El valor predeterminado es verdadero solo para la consulta de explicación.
Etiquetas:terminal_output
- Opciones varias, no clasificadas de otra manera.:
- Se acumulan los usos múltiples de
--deleted_packages=<comma-separated list of package names>
- Es una lista separada por comas de los nombres de los 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 muestre un error si encuentra la etiqueta "//x:y/z" si otra entrada de package_path aún la proporciona. Si especificas --deleted_packages x/y, se evita este problema.
--[no]fetch
predeterminado: "true"- Permite que el comando recupere dependencias externas. Si se establece en falso, el comando utilizará cualquier versión almacenada en caché de la dependencia y, si no existe ninguna, el comando fallará.
--package_path=<colon-separated list of options>
valor predeterminado: "%workspace%"- Es una lista separada por dos puntos de las ubicaciones en las que se buscarán 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 "Loading package:".
Opciones de Print_action
Hereda todas las opciones de build.
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]incompatible_use_plus_in_repo_names
predeterminado: "true"-
No-op.
Etiquetas:loading_and_analysis
- Opciones varias, no clasificadas de otra manera.:
- Se acumulan los usos múltiples de
--print_action_mnemonics=<a string>
- Enumera los mnemónicos por los que se filtrarán los datos de print_action. Si se deja vacío, no se realizará ningún filtrado.
Opciones de consulta
- Opciones que controlan la ejecución de la compilación:
--[no]keep_going
[-k
] predeterminado: "false"-
Continúa lo más posible después de un error. Si bien no se pueden analizar el destino que falló ni los que dependen de él, sí se pueden analizar otros requisitos previos de estos destinos.
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 paralelos 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”), seguida opcionalmente 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 se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility
predeterminado: "false"-
Si incompatible_enforce_config_setting_visibility=false, esta es una operación nula. 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, se aplican 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_use_plus_in_repo_names
predeterminado: "true"-
No se realiza ninguna operación.
Etiquetas:loading_and_analysis
- Opciones relacionadas con la salida y la semántica de la búsqueda:
--aspect_deps=<off, conservative or precise>
valor predeterminado: "conservative"-
Cómo resolver las dependencias de aspectos cuando el formato de salida es uno de {xml,proto,record}. "off" significa que no se resuelve ninguna dependencia de aspectos; "conservative" (el valor predeterminado) significa que se agregan todas las dependencias de aspectos declaradas, independientemente de si se les asigna la clase de regla de dependencias directas; "precise" significa que solo se agregan aquellos aspectos que posiblemente estén activos dada la clase de regla de las dependencias directas. Ten en cuenta que el modo preciso requiere cargar otros paquetes para evaluar un solo objetivo, lo que lo hace más lento que los otros modos. También ten en cuenta que incluso el modo preciso no es completamente preciso: la decisión de calcular un aspecto se toma en la fase de análisis, que no se ejecuta durante "bazel query".
Etiquetas:build_file_semantics
--[no]consistent_labels
predeterminado: "false"-
Si está habilitado, cada comando de consulta emite etiquetas como si se aplicara la función <code>str</code> de Starlark a una instancia de <code>Label</code>. Esto es útil para las herramientas que necesitan coincidir con el resultado de diferentes comandos de consulta o etiquetas emitidas por reglas. Si no está habilitado, los formateadores de salida pueden emitir nombres de repositorio aparentes (relativos al repositorio principal) para que la salida sea más legible.
Etiquetas:terminal_output
--[no]experimental_explicit_aspects
predeterminado: "false"-
aquery, cquery: Indica si se deben incluir las acciones generadas por aspectos en el resultado. query: No es una operación (los aspectos siempre se siguen).
Etiquetas:terminal_output
--[no]experimental_graphless_query
predeterminado: "auto"-
Si es verdadero, usa una implementación de Query que no hace una copia del gráfico. La nueva implementación solo admite --order_output=no, así como un subconjunto de los formateadores de salida.
Etiquetas:build_file_semantics
,eagerness_to_exit
- Valor predeterminado de
--graph:conditional_edges_limit=<an integer>
: "4" -
Es la cantidad máxima de etiquetas de condición que se pueden mostrar. -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>
valor predeterminado: "512"-
Es la longitud máxima de la cadena de etiqueta para un nodo de gráfico en el resultado. Las etiquetas más largas se truncarán. El valor -1 significa que no se truncarán. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--[no]implicit_deps
predeterminado: "true"-
Si está habilitado, las dependencias implícitas se incluirán en el gráfico de dependencias sobre el que opera la consulta. Una dependencia implícita es aquella que no se especifica de forma explícita en el archivo BUILD, pero que Bazel agrega. En el caso de cquery, esta opción controla el filtrado de las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
--[no]include_aspects
predeterminado: "true"-
aquery, cquery: Indica si se deben incluir las acciones generadas por aspectos en el resultado. query: No es una operación (los aspectos siempre se siguen).
Etiquetas:terminal_output
--[no]incompatible_lexicographical_output
predeterminado: "true"-
Si se establece esta opción, se ordena la salida de --order_output=auto en orden lexicográfico.
Etiquetas:terminal_output
,incompatible_change
--[no]incompatible_package_group_includes_double_slash
predeterminado: "true"-
Si está habilitado, 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 configura y no se configura --universe_scope, se inferirá un valor de --universe_scope como la lista de patrones de destino únicos en la expresión de búsqueda. Ten en cuenta que el valor de --universe_scope que se infiere para una expresión de búsqueda que usa funciones con alcance del universo (p.ej., "allrdeps") podría no ser el que deseas, por lo que debes usar esta opción solo si sabes lo que haces. 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á habilitado, 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 "visibilidad". Ejecuta y analiza el resultado de `info build-language` para obtener información sobre todos los atributos "nodep" en el lenguaje de compilación.
Etiquetas:build_file_semantics
--noorder_results
-
Genera los resultados en orden de dependencia (predeterminado) o sin ordenar. La salida no ordenada es más rápida, pero solo se admite cuando --output no es minrank, maxrank o graph.
Se expande a:
--order_output=no
Etiquetas:terminal_output
--null
-
Indica si cada formato termina con \0 en lugar de un salto de línea.
Se expande a:
--line_terminator_null=true
Etiquetas:terminal_output
--order_output=<no, deps, auto or full>
predeterminado: "auto"-
Genera los resultados sin ordenar (no), ordenados según la dependencia (deps) o completamente ordenados (full). El valor predeterminado es "auto", lo que significa que los resultados se generan ordenados por dependencia o completamente ordenados, según el formateador de salida (ordenados por dependencia para proto, minrank, maxrank y graph, y completamente ordenados para todos los demás). Cuando la salida está completamente ordenada, los nodos se imprimen en un orden totalmente determinístico (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 posterior al pedido en la que los bordes salientes a los nodos no visitados se atraviesan en orden alfabético de los nodos sucesores. Por último, los nodos se imprimen en el orden inverso al que se visitaron.
Etiquetas:terminal_output
--order_results
-
Genera los resultados en orden de dependencia (predeterminado) o sin ordenar. La salida no ordenada es más rápida, pero solo se admite cuando --output no es minrank, maxrank o 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 búsqueda. Los valores permitidos para la búsqueda son: build, graph, streamed_jsonproto, label, label_kind, location, maxrank, minrank, package, proto, streamed_proto, xml.
Etiquetas:terminal_output
--[no]proto:default_values
predeterminado: "true"-
Si es verdadero, se incluyen los atributos cuyo valor no se especifica de forma explícita en el archivo BUILD; de lo contrario, se omiten. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
--[no]proto:definition_stack
predeterminado: "false"-
Propaga el campo proto definition_stack, que registra para cada instancia de regla la pila de llamadas de Starlark en el momento en que se definió la clase de la regla.
Etiquetas:terminal_output
--[no]proto:flatten_selects
predeterminado: "true"-
Si está habilitado, 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"-
Completa el campo proto source_aspect_name de cada atributo con el aspecto fuente del que proviene el atributo (cadena vacía si no proviene de ninguno).
Etiquetas:terminal_output
--[no]proto:include_synthetic_attribute_hash
predeterminado: "false"-
Indica si se debe calcular y completar el atributo $internal_attr_hash.
Etiquetas:terminal_output
--[no]proto:instantiation_stack
predeterminado: "false"-
Propaga la pila de llamadas de instanciación 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 la salida de proto.
Etiquetas:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
predeterminado: "all"-
Lista de atributos separados por comas que se incluirán en el resultado. La configuración predeterminada incluye todos los atributos. Se establece en una cadena vacía para no generar ningún atributo. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
--[no]proto:rule_classes
predeterminado: "false"-
Completa el campo rule_class_key de cada regla y, para la primera regla con un rule_class_key determinado, también completa su campo rule_class_info proto. El campo rule_class_key identifica de forma única una clase de regla, y el campo rule_class_info es una definición de API de clase de regla en formato Stardoc.
Etiquetas:terminal_output
--[no]proto:rule_inputs_and_outputs
predeterminado: "true"-
Indica si se deben propagar los campos rule_input y rule_output.
Etiquetas:terminal_output
- Valor predeterminado de
--query_file=<a string>
: "" -
Si se configura, la consulta leerá la consulta del archivo que se nombra aquí, en lugar de hacerlo desde la línea de comandos. Es un error especificar un archivo aquí y una consulta de línea de comandos.
Etiquetas:changes_inputs
--[no]relative_locations
predeterminado: "false"-
Si es verdadero, la ubicación de los archivos BUILD en las salidas de XML y proto será relativa. De forma predeterminada, la salida de ubicación es una ruta de acceso absoluta y no será coherente en todas las máquinas. Puedes establecer esta opción como verdadera para obtener un resultado coherente en todas las máquinas.
Etiquetas:terminal_output
--[no]strict_test_suite
predeterminado: "false"-
Si es verdadero, la expresión tests() arroja un error si encuentra un test_suite que contiene destinos que no son de prueba.
Etiquetas:build_file_semantics
,eagerness_to_exit
--[no]tool_deps
predeterminado: "true"-
Consulta: Si está inhabilitada, las dependencias de la "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 que va 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 "target".
Cquery: Si está inhabilitado, filtra todos los destinos configurados que cruzan una transición de ejecución desde el destino de nivel superior que descubrió este destino configurado. Esto significa que, si el destino de nivel superior está en la configuración de destino, solo se devolverán los destinos configurados que también estén en la configuración de destino. Si el destino de nivel superior está en la configuración de ejecución, solo se devolverán los destinos configurados para la ejecución. Esta opción NO excluirá las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
- Valor predeterminado de
--universe_scope=<comma-separated list of options>
: "" -
Es un conjunto de patrones de segmentación (aditivos y sustractivos) separados por comas. La consulta se puede realizar en el universo definido por el cierre transitivo de los destinos especificados. Esta opción se usa para los comandos query y cquery.
En el caso de cquery, la entrada de esta opción son los destinos en los que se compilan todas las respuestas, por lo que esta opción puede afectar las configuraciones y las transiciones. Si no se especifica esta opción, se supone que los destinos de nivel superior son los que se analizan a partir de la expresión de búsqueda. Nota: En el caso de cquery, no especificar esta opción puede provocar que se interrumpa la compilación si los destinos analizados a partir de la expresión de la 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
--[no]xml:line_numbers
predeterminado: "true"-
Si es verdadero, el resultado XML contiene números de línea. Si inhabilitas esta opción, es posible que las comparaciones sean más fáciles de leer. Esta opción solo se aplica a --output=xml.
Etiquetas:terminal_output
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Valor predeterminado de
--experimental_repository_resolved_file=<a string>
: "" -
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 varias, no clasificadas de otra manera.:
- Se acumulan los usos múltiples de
--deleted_packages=<comma-separated list of package names>
- Es una lista separada por comas de los nombres de los 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 muestre un error si encuentra la etiqueta "//x:y/z" si otra entrada de package_path aún la proporciona. Si especificas --deleted_packages x/y, se evita este problema.
--[no]fetch
predeterminado: "true"- Permite que el comando recupere dependencias externas. Si se establece en falso, el comando utilizará cualquier versión almacenada en caché de la dependencia y, si no existe ninguna, el comando fallará.
--package_path=<colon-separated list of options>
valor predeterminado: "%workspace%"- Es una lista separada por dos puntos de las ubicaciones en las que se buscarán 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 "Loading package:".
Opciones de ejecución
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
--[no]portable_paths
predeterminado: "false"-
Si es verdadero, incluye las rutas de acceso que se reemplazarán en ExecRequest para que las rutas resultantes sean portátiles.
Etiquetas:affects_outputs
--[no]run
predeterminado: "true"-
Si es falso, se omite la ejecución de la línea de comandos construida para el destino compilado. Ten en cuenta que esta marca se ignora para todas las compilaciones de --script_path.
Etiquetas:affects_outputs
- Se acumulan los usos múltiples de
--run_env=<a 'name=value' assignment with an optional value part>
-
Especifica el conjunto de variables de entorno disponibles para las acciones con configuración de destino. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o bien por el par nombre=valor que establece el valor independientemente del entorno de invocación. Esta opción se puede usar varias veces. En el caso de las opciones proporcionadas para la misma variable, se aplica la más reciente. Las opciones para diferentes variables se acumulan.
Etiquetas:affects_outputs
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, a diferencia de su existencia:
--script_path=<a path>
valor predeterminado: consulta la descripción-
Si se configura, escribe una secuencia de comandos de shell en el archivo determinado que invoca el destino. Si se establece esta opción, el destino no se ejecuta desde Bazel. Usa "bazel run --script_path=foo //foo && ./foo" para invocar el destino "//foo". Esto difiere de "bazel run //foo" en que se libera el bloqueo de bazel y el ejecutable se conecta a stdin de la terminal.
Etiquetas:affects_outputs
,execution
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]incompatible_use_plus_in_repo_names
predeterminado: "true"-
No-op.
Etiquetas:loading_and_analysis
Opciones de apagado
- Opciones que controlan el resultado del comando:
--iff_heap_size_greater_than=<an integer>
predeterminado: "0"-
Si es distinto de cero, el cierre solo se realizará si la memoria total (en MB) que consume la JVM supera este valor.
Etiquetas:loses_incremental_state
,eagerness_to_exit
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]incompatible_use_plus_in_repo_names
predeterminado: "true"-
No-op.
Etiquetas:loading_and_analysis
Opciones de sincronización
- Opciones que controlan la ejecución de la compilación:
--[no]configure
predeterminado: "False"-
Solo se sincronizan los repositorios marcados como "configure" para fines de configuración del sistema.
Etiquetas:changes_inputs
--[no]keep_going
[-k
] predeterminado: "false"-
Continúa lo más posible después de un error. Si bien no se pueden analizar el destino que falló ni los que dependen de él, sí se pueden analizar otros requisitos previos de estos destinos.
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 paralelos 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”), seguida opcionalmente 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 los usos múltiples de
--only=<a string>
-
Si se proporciona esta opción, solo se sincronizarán los repositorios especificados con ella. Aún se consideran obsoletos todos los paquetes (o todos los que se pueden configurar, si se proporciona --configure).
Etiquetas:changes_inputs
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility
predeterminado: "false"-
Si incompatible_enforce_config_setting_visibility=false, esta es una operación nula. 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, se aplican 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_use_plus_in_repo_names
predeterminado: "true"-
No-op.
Etiquetas:loading_and_analysis
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Valor predeterminado de
--experimental_repository_resolved_file=<a string>
: "" -
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 varias, no clasificadas de otra manera.:
- Se acumulan los usos múltiples de
--deleted_packages=<comma-separated list of package names>
- Es una lista separada por comas de los nombres de los 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 muestre un error si encuentra la etiqueta "//x:y/z" si otra entrada de package_path aún la proporciona. Si especificas --deleted_packages x/y, se evita este problema.
--[no]fetch
predeterminado: "true"- Permite que el comando recupere dependencias externas. Si se establece en falso, el comando utilizará cualquier versión almacenada en caché de la dependencia y, si no existe ninguna, el comando fallará.
--package_path=<colon-separated list of options>
valor predeterminado: "%workspace%"- Es una lista separada por dos puntos de las ubicaciones en las que se buscarán 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 "Loading package:".
Opciones de prueba
Hereda todas las opciones de build.
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]incompatible_use_plus_in_repo_names
predeterminado: "true"-
No-op.
Etiquetas:loading_and_analysis
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]print_relative_test_log_paths
predeterminado: "false"-
Si es verdadero, cuando se imprima la ruta de acceso a un registro de prueba, se usará la ruta de acceso relativa que utiliza el vínculo simbólico de conveniencia "testlogs". Nota: Una invocación posterior de "compilación", "prueba", etcétera, con una configuración diferente puede hacer que cambie el destino de este vínculo simbólico, lo que hace que la ruta impresa anteriormente ya no sea ú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 coincide con el tiempo de espera definido por la prueba (ya sea implícito o explícito).
Etiquetas:affects_outputs
--[no]verbose_test_summary
predeterminado: "true"-
Si es verdadero, imprime información adicional (sincronización, cantidad de ejecuciones fallidas, etc.) en el resumen de la prueba.
Etiquetas:affects_outputs
Opciones del proveedor
Hereda todas las opciones de test.
- Opciones que controlan la ejecución de la compilación:
--[no]keep_going
[-k
] predeterminado: "false"-
Continúa lo más posible después de un error. Si bien no se pueden analizar el destino que falló ni los que dependen de él, sí se pueden analizar otros requisitos previos de estos destinos.
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 paralelos 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”), seguida opcionalmente 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 se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility
predeterminado: "false"-
Si incompatible_enforce_config_setting_visibility=false, esta es una operación nula. 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, se aplican 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_use_plus_in_repo_names
predeterminado: "true"-
No-op.
Etiquetas:loading_and_analysis
- Opciones relacionadas con la salida y la semántica de Bzlmod:
- Se acumulan los usos múltiples de
--repo=<a string>
-
Solo los proveedores del repositorio especificado, que puede ser `@apparent_repo_name` o `@@canonical_repo_name`. Esta opción se puede configurar varias veces.
Etiquetas:changes_inputs
- Opciones varias, no clasificadas de otro modo.:
- Se acumulan los usos múltiples de
--deleted_packages=<comma-separated list of package names>
- Es una lista separada por comas de los nombres de los 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 muestre un error si encuentra la etiqueta "//x:y/z" si otra entrada de package_path aún la proporciona. Si especificas --deleted_packages x/y, se evita este problema.
--[no]fetch
predeterminado: "true"- Permite que el comando recupere dependencias externas. Si se establece en falso, el comando utilizará cualquier versión almacenada en caché de la dependencia y, si no existe ninguna, el comando fallará.
--package_path=<colon-separated list of options>
valor predeterminado: "%workspace%"- Es una lista separada por dos puntos de las ubicaciones en las que se buscarán 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 "Loading package:".
- Opciones que controlan la ejecución de la compilación:
--[no]experimental_inprocess_symlink_creation
predeterminado: "true"-
Indica si se deben realizar llamadas directas al sistema de archivos para crear árboles de vínculos simbólicos en lugar de delegar en un proceso auxiliar.
Etiquetas:loading_and_analysis
,execution
,experimental
--[no]experimental_persistent_aar_extractor
predeterminado: "false"-
Habilita el extractor de aar persistente con trabajadores.
Etiquetas:execution
,experimental
--[no]experimental_remotable_source_manifests
predeterminado: "false"-
Indica si las acciones del manifiesto fuente se pueden realizar 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 una nueva generación.
Etiquetas:execution
,experimental
--[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 vínculos simbólicos.
Etiquetas:execution
,experimental
--[no]incompatible_modify_execution_info_additive
predeterminado: "false"-
Cuando se habilita, 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 los usos múltiples 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 mnemónica 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 expresiones regulares pueden aplicarse a la misma mnemónica.
La sintaxis es "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" de ella.
"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 Genrule.
Etiquetas:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Habilita acciones persistentes de dex y desugar de Android con trabajadores.
Se expande a:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
-
Habilita el procesador de recursos 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 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=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_tools
-
Habilita herramientas de Android persistentes y multiplexadas (dexing, desugaring, 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.
Tags:execution
- Opciones que configuran la cadena de herramientas que se usa para la ejecución de acciones:
--android_compiler=<a string>
valor predeterminado: consulta la descripción-
Compilador de destino de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
valor predeterminado: "android"-
Selecciona el combinador de manifiestos que se usará para las reglas de android_binary. Es una marca para ayudar en la transición de la herramienta de combinación heredada a la herramienta de combinación de manifiestos de Android.
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 archivo binario es un APK grueso, que contiene archivos binarios nativos para cada plataforma de destino especificada.
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>
valor 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 archivo binario que se usa para el procesamiento posterior de los informes de cobertura sin procesar. Actualmente, debe ser un filegroup 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 archivo binario que se usa para generar informes de cobertura. Actualmente, debe ser un filegroup 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 asistencia que se requieren en las entradas de cada acción de prueba que recopila la cobertura del código. El valor predeterminado es “//tools/test:coverage_support”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--custom_malloc=<a build target label>
valor predeterminado: consulta la descripción-
Especifica una implementación de malloc personalizada. Este parámetro de configuración anula los atributos de malloc en las reglas de compilación.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan los usos múltiples de
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
-
Lista de expresiones regulares separadas por comas, cada una con el prefijo opcional - (expresión negativa), asignadas (=) a una lista de destinos de valores de restricción separados por comas. Si un destino no coincide con ninguna expresión negativa y coincide con al menos una expresión positiva, la resolución de su 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 configura, agrega un requisito de ejecución "requires-xcode:{version}" a cada acción de Xcode. Si la versión de Xcode tiene una etiqueta con guion, también agrega un requisito de ejecución "requires-xcode-label:{version_label}".
Etiquetas:loses_incremental_state
,loading_and_analysis
,execution
,experimental
--[no]experimental_prefer_mutual_xcode
predeterminado: "true"-
Si es verdadero, usa el Xcode más reciente que esté disponible de forma local y remota. Si es falso o si no hay versiones disponibles mutuas, usa la versión local de Xcode seleccionada a través de xcode-select.
Etiquetas:loses_incremental_state
,experimental
- 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 objetivo exacto o como un patrón de objetivo. Estas plataformas se considerarán antes de las que se declaren en el archivo WORKSPACE con register_execution_platforms(). Esta opción solo se puede configurar una vez; las instancias posteriores anularán la configuración anterior de la marca.
Etiquetas:execution
- Se acumulan los usos múltiples 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 de las que se declaran en el archivo WORKSPACE con register_toolchains().
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--grte_top=<a label>
valor predeterminado: consulta la descripción-
Es una etiqueta para una biblioteca de libc registrada. El valor predeterminado se selecciona con la cadena de herramientas de compilación cruzada y casi nunca es necesario anularlo.
Etiquetas:action_command_lines
,affects_outputs
--host_compiler=<a string>
valor predeterminado: consulta la descripción-
Es una marca que no realiza ninguna operación. Se quitará en una versión futura.
Etiquetas:loading_and_analysis
,execution
--host_grte_top=<a label>
valor 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 ejecución.
Etiquetas:action_command_lines
,affects_outputs
--host_platform=<a build target label>
valor predeterminado: "@bazel_tools//tools:host_platform"-
Etiqueta de una regla de plataforma que describe el sistema host.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--[no]incompatible_bazel_test_exec_run_under
predeterminado: "false"-
Si está habilitado, "bazel test --run_under=//:runner" compila "//:runner" en la configuración de ejecución. Si está inhabilitado, compila "//:runner" en la configuración de destino. Bazel ejecuta pruebas en máquinas de ejecución, por lo que la primera opción es más correcta. Esto no afecta a "bazel run", que siempre compila "`--run_under=//foo" en la configuración de destino.
Etiquetas:affects_outputs
,incompatible_change
--[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_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 nativas)
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_strip_executable_safely
predeterminado: "false"-
Si es verdadero, la acción de despojo para los ejecutables usará la marca -x, que no interrumpe la resolución de símbolos dinámicos.
Etiquetas:action_command_lines
,incompatible_change
-
Usa objetos compartidos de interfaz si la cadena de herramientas los admite. Actualmente, todas las cadenas de herramientas de 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')>
valor 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')>
valor 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>
valor predeterminado: consulta la descripción-
Es la versión mínima del SO para la que se compila tu app.
Etiquetas:loading_and_analysis
,affects_outputs
- Valor predeterminado de
--platform_mappings=<a main workspace-relative path>
: "" -
Ubicación de un archivo de asignación que describe qué plataforma usar si no se configuró ninguna o qué marcas establecer cuando ya existe una plataforma. Debe ser relativa a la raíz del espacio de trabajo principal. El valor predeterminado es "platform_mappings" (un archivo directamente en la raíz del espacio de trabajo).
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
,immutable
- Valor predeterminado de
--platforms=<a build target label>
: "" -
Son 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
--python_path=<a string>
valor predeterminado: consulta la descripción-
Es la ruta de acceso absoluta del intérprete de Python invocado para ejecutar destinos de Python en la plataforma de destino. Obsoleto; se inhabilita con --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
--python_top=<a build target label>
valor predeterminado: consulta la descripción-
Es 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 inhabilita 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')>
valor 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')>
valor 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>
valor predeterminado: consulta la descripción-
Si se especifica, usa Xcode de la versión indicada para las acciones de compilación pertinentes. Si no se especifica, se usa la versión predeterminada del ejecutor de Xcode.
Etiquetas:loses_incremental_state
--xcode_version_config=<a build target label>
valor 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 vínculos simbólicos de archivos ejecutables para todos los destinos. Si es falso, se escriben solo cuando lo requiere una acción, prueba o comando de ejecución local.
Etiquetas:affects_outputs
--[no]build_runfile_manifests
predeterminado: "true"-
Si es verdadero, escribe manifiestos de archivos ejecutables 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, también se compilará automáticamente el archivo .dwp para el archivo binario de prueba.
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 un cc_proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated set of options>
predeterminado: ".pb.cc"-
Establece los sufijos de los archivos fuente que crea un 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 un 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 resultado de la compilación.
Etiquetas:affects_outputs
,experimental
--fission=<a set of compilation modes>
predeterminado: "no"-
Especifica qué modos de compilación usan fission para las compilaciones y las vinculaciones 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 verdadero, las reglas nativas agregan <code>DefaultInfo.files</code> de las dependencias de datos a sus archivos ejecutables, 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: "false"-
Si es verdadero, compila bosques de vínculos simbólicos 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 configura, se guardarán los resultados temporales de gcc. Estos incluyen archivos .s (código de ensamblador), archivos .i (C preprocesado) y archivos .ii (C++ preprocesado).
Etiquetas:affects_outputs
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
- Se acumulan los usos múltiples de
--action_env=<a 'name=value' assignment with an optional value part>
-
Especifica el conjunto de variables de entorno disponibles para las acciones con configuración de destino. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o bien por el par nombre=valor que establece el valor independientemente del entorno de invocación. Esta opción se puede usar varias veces. En el caso de las opciones proporcionadas para la misma variable, se aplica la más reciente. Las opciones para diferentes variables se acumulan.
Etiquetas:action_command_lines
- Valor predeterminado de
--allowed_cpu_values=<comma-separated set of options>
: "" -
Valores permitidos para la marca --cpu.
Etiquetas:changes_inputs
,affects_outputs
--[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 operación.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]android_databinding_use_v3_4_args
predeterminado: "true"-
Usa la vinculación de datos de Android v2 con el argumento 3.4.0. Esta marca no realiza ninguna operació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 de forma explícita una biblioteca compartida. "default" significa que Bazel elegirá si se vincula de forma dinámica. "fully" significa que todas las bibliotecas se vincularán de forma dinámica. "off" significa que todas las bibliotecas se vincularán principalmente en modo estático.
Etiquetas:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
predeterminado: "alfabético"-
Establece el orden de los manifiestos que se pasan al combinador de manifiestos para los archivos binarios de Android. ALPHABETICAL 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 de 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 los usos múltiples de
--catalyst_cpus=<comma-separated list of options>
-
Lista separada por comas de las arquitecturas para las que se compilarán los archivos 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 cuando 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 se debe especificar directamente. En su lugar, se debe usar el comando "bazel coverage".
Etiquetas:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] valor 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 los usos múltiples 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 los usos múltiples de
--copt=<a string>
-
Opciones adicionales para pasar a gcc.
Etiquetas:action_command_lines
,affects_outputs
- Valor predeterminado de
--cpu=<a string>
: "" -
CPU objetivo.
Etiquetas:changes_inputs
,affects_outputs
--cs_fdo_absolute_path=<a string>
valor 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 de LLVM sin procesar o indexado.
Etiquetas:affects_outputs
--cs_fdo_instrument=<a string>
valor predeterminado: consulta la descripción-
Genera archivos binarios con la 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 en el tiempo de ejecución.
Etiquetas:affects_outputs
--cs_fdo_profile=<a build target label>
valor 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 los usos múltiples 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 los usos múltiples de
--define=<a 'name=value' assignment>
-
Cada opción --define especifica una asignación para una variable de compilación. En caso de que haya varios valores para una variable, se usará el último.
Etiquetas:changes_inputs
,affects_outputs
--dynamic_mode=<off, default or fully>
predeterminado: "default"-
Determina si los archivos binarios de C++ se vincularán de forma dinámica. "default" significa que Bazel elegirá si se vincula de forma dinámica. "fully" significa que todas las bibliotecas se vincularán de forma dinámica. "off" significa que todas las bibliotecas se vincularán principalmente en modo estático.
Etiquetas:loading_and_analysis
,affects_outputs
--[no]enable_propeller_optimize_absolute_paths
predeterminado: "true"-
Si se configura, cualquier uso de rutas absolutas para la optimización de la hélice generará un error.
Etiquetas:affects_outputs
--[no]enable_remaining_fdo_absolute_paths
predeterminado: "true"-
Si se configura, cualquier uso de rutas absolutas para FDO generará un error.
Etiquetas:affects_outputs
--[no]enable_runfiles
predeterminado: "auto"-
Habilita el árbol de vínculos simbólicos de runfiles. De forma predeterminada, está desactivado en Windows y activado en otras plataformas.
Etiquetas:affects_outputs
- Se acumulan los usos múltiples 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
--[no]experimental_android_compress_java_resources
predeterminado: "false"-
Comprimir recursos de Java en APKs
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_android_databinding_v2
predeterminado: "true"-
Usa la vinculación de datos de Android v2. Esta marca no realiza ninguna operació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
,experimental
--[no]experimental_android_rewrite_dexes_with_rex
predeterminado: "false"-
use rex tool to rewrite dex files
Tags: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 recopilación de cobertura para los archivos generados.
Etiquetas:affects_outputs
,experimental
--experimental_objc_fastbuild_options=<comma-separated list of options>
predeterminado: "-O0,-DDEBUG=1"-
Usa estas cadenas como opciones del compilador de compilación rápida de objc.
Etiquetas:action_command_lines
--[no]experimental_omitfp
predeterminado: "false"-
Si es verdadero, usa libunwind para el desenrollado de la pila y compila con -fomit-frame-pointer y -fasynchronous-unwind-tables.
Etiquetas:action_command_lines
,affects_outputs
,experimental
--experimental_output_paths=<off, content or strip>
predeterminado: "off"-
Qué modelo se debe usar para determinar dónde escriben sus resultados las reglas en el árbol de salida, en particular para las compilaciones multiplataforma o con múltiples configuraciones. Esta función 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 agregando la clave "supports-path-mapping" al diccionario "execution_requirements".
Etiquetas:loses_incremental_state
,bazel_internal_configuration
,affects_outputs
,execution
- Se acumulan los usos múltiples 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 corto deseado para usar en la ruta de acceso 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 de plataformas. 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 la plataforma actual. Por último, se usa un hash de la opción de la plataforma como último recurso.
Etiquetas:affects_outputs
,experimental
--[no]experimental_py_binaries_include_label
predeterminado: "false"-
Los destinos py_binary incluyen su etiqueta incluso cuando el sellado está inhabilitado.
Etiquetas:affects_outputs
,experimental
--[no]experimental_use_llvm_covmap
predeterminado: "false"-
Si se especifica, Bazel generará información del mapa de cobertura de llvm-cov en lugar de gcov cuando se habilite collect_code_coverage.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic
predeterminado: "true"-
Usa esta marca solo como parte de una estrategia de prueba o migración sugerida. Ten en cuenta que la heurística tiene deficiencias conocidas y se sugiere migrar para depender solo de --experimental_override_name_platform_in_output_dir.
Etiquetas:affects_outputs
,experimental
--fdo_instrument=<a string>
valor predeterminado: consulta la descripción-
Genera archivos binarios con la instrumentación de FDO. Con el compilador Clang/LLVM, también acepta el nombre del directorio en el que se volcarán los archivos de perfil sin procesar en el tiempo de ejecución.
Etiquetas:affects_outputs
--fdo_optimize=<a string>
valor predeterminado: consulta la descripción-
Usa la información del perfil de FDO para optimizar la compilación. Especifica el nombre de un archivo ZIP que contenga un árbol de archivos .gcda, un archivo AFDO que contenga un perfil automático o un archivo de perfil de LLVM. Esta marca también acepta archivos especificados como etiquetas (p.ej., `//foo/bar:file.afdo`; es posible que debas agregar una directiva `exports_files` al paquete correspondiente) y etiquetas que apuntan a destinos `fdo_profile`. Esta marca se reemplazará por la regla "fdo_profile".
Etiquetas:affects_outputs
--fdo_prefetch_hints=<a build target label>
valor predeterminado: consulta la descripción-
Usa sugerencias de recuperación previa de caché.
Etiquetas:affects_outputs
--fdo_profile=<a build target label>
valor predeterminado: consulta la descripción-
Es el objeto fdo_profile que representa el perfil que se usará para la optimización.
Etiquetas:affects_outputs
- Se acumulan los usos múltiples de
--features=<a string>
-
Las funciones proporcionadas 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. Las funciones negativas siempre anulan las positivas. Consulta también --host_features.
Etiquetas:changes_inputs
,affects_outputs
--[no]force_pic
predeterminado: "false"-
Si está habilitado, todas las compilaciones de C++ producen código independiente de la posición (“-fPIC”), las vinculaciones prefieren las bibliotecas prediseñadas PIC a las bibliotecas no PIC y las vinculaciones producen ejecutables independientes de la posición (“-pie”).
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan los usos múltiples 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 proporcionadas para la misma variable, se aplica la más reciente. Las opciones para diferentes variables se acumulan.
Etiquetas:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
valor predeterminado: "opt"-
Especifica el modo en el que se compilarán las herramientas que se usan durante la compilación. Valores: "fastbuild", "dbg", "opt".
Etiquetas:affects_outputs
,action_command_lines
- Se acumulan los usos múltiples 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 los usos múltiples 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
- Valor predeterminado de
--host_cpu=<a string>
: "" -
Es la CPU del host.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan los usos múltiples de
--host_cxxopt=<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
- Se acumulan los usos múltiples de
--host_features=<a string>
-
Las funciones proporcionadas 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. Las funciones negativas siempre anulan las positivas.
Etiquetas:changes_inputs
,affects_outputs
--host_force_python=<PY2 or PY3>
valor 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 los usos múltiples 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')>
valor predeterminado: consulta la descripción-
Versión mínima de macOS compatible con los destinos de host. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan los usos múltiples 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 de 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. Aquí, regex_filter representa una lista de patrones de expresiones regulares de inclusión y exclusión (consulta también --instrumentation_filter), y option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe incluirse 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
--[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 pliega en el directorio bin.
Etiquetas: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 configura, se instrumentan las reglas de prueba incluidas por --instrumentation_filter. De lo contrario, las reglas de prueba siempre se excluyen de la instrumentación de cobertura.
Etiquetas:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
valor predeterminado: "-/javatests[/:],-/test/java[/:]"-
Cuando la cobertura está habilitada, solo se instrumentarán las reglas con nombres incluidos en el filtro basado en regex especificado. En su lugar, se excluyen las reglas que tienen 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')>
valor predeterminado: consulta la descripción-
Versión mínima compatible de iOS para los simuladores y dispositivos de destino. Si no se especifica, se usa "ios_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan los usos múltiples de
--ios_multi_cpus=<comma-separated list of options>
-
Lista separada por comas de las arquitecturas con las que se compilará un 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. Se reemplazó por --incompatible_remove_legacy_whole_archive (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener más detalles). 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 los usos múltiples de
--linkopt=<a string>
-
Opción adicional para pasar a gcc durante la vinculación.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan los usos múltiples 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 los usos múltiples 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 los usos múltiples de
--macos_cpus=<comma-separated list of options>
-
Lista separada por comas de las arquitecturas para las que se compilarán los archivos 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')>
valor predeterminado: consulta la descripción-
Versión mínima de macOS compatible con los destinos. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
--memprof_profile=<a build target label>
valor predeterminado: consulta la descripción-
Usa el perfil de memprof.
Etiquetas:affects_outputs
--[no]objc_debug_with_GLIBCXX
predeterminado: "false"-
Si se configura 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 no utilizado de los archivos binarios vinculados. Se realizará el despojo de binarios si se especifican esta marca y --compilation_mode=opt.
Etiquetas:action_command_lines
- Se acumulan los usos múltiples 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 los usos múltiples 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. Aquí, regex_filter representa una lista de patrones de expresiones regulares de inclusión y exclusión (consulta también --instrumentation_filter), y option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe incluirse 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 los usos múltiples 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 del backend. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,…,option_n. Aquí regex_filter representa una lista de patrones de expresiones regulares de inclusión y exclusión, y option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe incluirse 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
--platform_suffix=<a string>
valor 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>
valor 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 los 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>
valor predeterminado: consulta la descripción-
Nombre de ruta de acceso absoluta del archivo cc_profile para las compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
valor predeterminado: consulta la descripción-
Nombre de ruta de acceso absoluta del archivo ld_profile para las compilaciones optimizadas con Propeller.
Etiquetas:affects_outputs
--run_under=<a prefix in front of command>
valor predeterminado: consulta la descripción-
Prefijo que se 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" y "//package:target --options".
Etiquetas:action_command_lines
-
Si es verdadero, las bibliotecas nativas que contienen la misma funcionalidad se compartirán entre diferentes destinos.
Etiquetas:loading_and_analysis
,affects_outputs
--[no]stamp
predeterminado: "false"-
Sella los archivos 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 archivos binarios y las bibliotecas compartidas (con "-Wl,--strip-debug"). El valor predeterminado "sometimes" significa que se quita solo si --compilation_mode=fastbuild.
Etiquetas:affects_outputs
- Se acumulan los usos múltiples de
--stripopt=<a string>
-
Opciones adicionales para pasar a strip cuando se genera un objeto binario "<name>.stripped".
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan los usos múltiples de
--tvos_cpus=<comma-separated list of options>
-
Lista separada por comas de las arquitecturas para las que se compilarán los archivos 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')>
valor 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 los usos múltiples de
--visionos_cpus=<comma-separated list of options>
-
Lista separada por comas de las arquitecturas para las que se compilarán los archivos binarios de Apple visionOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Se acumulan los usos múltiples de
--watchos_cpus=<comma-separated list of options>
-
Lista separada por comas de las arquitecturas para las que se compilarán los archivos binarios de watchOS de Apple.
Etiquetas:loses_incremental_state
,loading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
valor 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>
valor predeterminado: consulta la descripción-
Usa la información del perfil de XbinaryFDO para optimizar la compilación. Especifica el nombre del perfil predeterminado de varias plataformas. 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 hubiera especificado.
Etiquetas:affects_outputs
- Opciones que afectan la rigidez con la que Bazel aplica las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
--[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"-
Indica si se debe aplicar desugar al código de bytes de Java 8 antes de convertirlo en dex.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]desugar_java8_libs
predeterminado: "false"-
Indica si se deben incluir las bibliotecas de Java 8 compatibles en las 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 destino y genera errores si algún destino tiene dependencias que no admiten los mismos entornos.
Etiquetas:build_file_semantics
--[no]experimental_check_desugar_deps
predeterminado: "true"-
Indica si se debe verificar la desazucaración correcta a nivel binario de Android.
Etiquetas:eagerness_to_exit
,loading_and_analysis
,experimental
--experimental_import_deps_checking=<a string>
valor predeterminado: consulta la descripción-
No se realiza ninguna operación; se mantiene solo para la retrocompatibilidad
Etiquetas:loading_and_analysis
--experimental_one_version_enforcement=<off, warning or error>
predeterminado: "OFF"-
Cuando se habilita, se aplica 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 la clase. Esta aplicación de la política puede interrumpir la compilación o simplemente generar advertencias.
Etiquetas:loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
predeterminado: "default"-
Si es verdadero, verifica que un destino de Java declare explícitamente todos los destinos que se usan directamente como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files
predeterminado: "false"-
Si está habilitado, verifica testonly para los destinos de requisitos previos que son archivos de salida buscando el testonly de la regla de generación. Esto coincide con la verificación de visibilidad.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_check_visibility_for_toolchains
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 Starlark para Android 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 operación. Se mantiene aquí para la retrocompatibilidad.
Etiquetas:eagerness_to_exit
,incompatible_change
--[no]incompatible_python_disable_py2
predeterminado: "true"-
Si es verdadero, usar la configuración de Python 2 causará 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]one_version_enforcement_on_java_tests
predeterminado: "true"-
Cuando se habilita y experimental_one_version_enforcement se establece en un valor que no sea NONE, se aplica una versión en los destinos de java_test. Esta marca se puede inhabilitar para mejorar el rendimiento de las pruebas incrementales a costa de no detectar posibles incumplimientos de una versión.
Etiquetas:loading_and_analysis
--python_native_rules_allowlist=<a build target label>
valor predeterminado: consulta la descripción-
Lista de entidades permitidas (destino 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 del paquete 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, verifica que un destino proto_library declare explícitamente 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, verifica que un destino proto_library declare de forma explícita todos los destinos 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 los usos múltiples 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 "environment". 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 en Objective-C incluirán derechos de depuración cuando se firmen.
Etiquetas:changes_inputs
--ios_signing_cert_name=<a string>
valor predeterminado: consulta la descripción-
Nombre del certificado que se usará para la firma de iOS. Si no se configura, se volverá al perfil de aprovisionamiento. Puede ser la preferencia de identidad del llavero del certificado o una subcadena del nombre común del certificado, según la página de manual 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 se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]incompatible_disallow_legacy_py_provider
predeterminado: "true"-
No-op, se quitará pronto.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_sdk_frameworks_attributes
predeterminado: "false"-
Si es verdadero, no permite los atributos sdk_frameworks y weak_sdk_frameworks en objc_library y objc_import.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_objc_alwayslink_by_default
predeterminado: "false"-
Si es verdadero, establece el valor predeterminado como verdadero para los atributos alwayslink en objc_library y objc_import.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_python_disallow_native_rules
predeterminado: "false"-
Cuando es verdadero, se produce un error cuando se usan las reglas py_* integradas; en su lugar, se deben usar las reglas rule_python. Consulta https://github.com/bazelbuild/bazel/issues/17773 para obtener más información y las instrucciones de migración.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones que rigen el comportamiento del entorno de prueba o del ejecutor de pruebas:
--[no]allow_analysis_failures
predeterminado: "false"-
Si es verdadero, un error de análisis de un destino de regla hace que el destino propague una instancia de AnalysisFailureInfo que contiene la descripción del error, en lugar de generar un error 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 generará un error de regla.
Etiquetas:loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure
predeterminado: "false"-
Si es verdadero, los errores de la acción dex2oat harán que se interrumpa la compilación en lugar de ejecutar dex2oat durante el tiempo de ejecución de la prueba.
Etiquetas:loading_and_analysis
,experimental
- Se acumulan los usos múltiples 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 predeterminada de recursos para las pruebas. El formato esperado es <recurso>=<valor>. Si se especifica un solo número positivo como <valor>, se anularán los recursos predeterminados para todos los tamaños de prueba. Si se especifican 4 números separados por comas, se anulará la cantidad de recursos para los tamaños de prueba pequeño, mediano, grande y enorme, 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 especificados por esta marca se anulan con los recursos explícitos especificados en las etiquetas.
--[no]experimental_android_use_parallel_dex2oat
predeterminado: "false"-
Usa dex2oat en paralelo para acelerar android_test.
Etiquetas:loading_and_analysis
,host_machine_resource_optimizations
,experimental
--[no]ios_memleaks
predeterminado: "false"-
Habilita la verificación de pérdidas de memoria en los destinos de ios_test.
Etiquetas:action_command_lines
--ios_simulator_device=<a string>
valor predeterminado: consulta la descripción-
Es el dispositivo que se simulará cuando se ejecute una aplicación para iOS en el simulador, p.ej., "iPhone 6". Puedes obtener una lista de dispositivos ejecutando "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')>
valor predeterminado: consulta la descripción-
Versión de iOS que se ejecutará en el simulador cuando se ejecute o pruebe. Se ignora para las reglas de ios_test si se especifica un dispositivo objetivo en la regla.
Etiquetas:test_runner
- Se acumulan los usos múltiples 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ó. Normalmente, el valor especificado es solo un número entero. Ejemplo: --runs_per_test=3 ejecutará todas las pruebas 3 veces. Sintaxis alternativa: regex_filter@runs_per_test. Aquí runs_per_test representa 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 pasar varias veces. Tiene prioridad el argumento que se pasó más recientemente y que coincide. Si no hay coincidencias, la prueba solo se ejecuta una vez.
- Se acumulan los usos múltiples de
--test_env=<a 'name=value' assignment with an optional value part>
-
Especifica variables de entorno adicionales que se insertarán en el entorno del ejecutor de pruebas. Las variables se pueden especificar por nombre, en cuyo caso su valor se leerá del entorno del cliente de Bazel, o por el par nombre=valor. Esta opción se puede usar varias veces para especificar varias variables. Solo se usa con 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 la 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 cualquiera de las dos formas, 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: "false"-
Si es verdadero, los resultados de las pruebas no declarados se archivarán en un archivo ZIP.
Etiquetas:test_runner
- Opciones que activan optimizaciones del tiempo de compilación:
--[no]experimental_filter_library_jar_with_program_jar
predeterminado: "false"-
Filtra el ProgramJar de ProGuard para quitar las clases que también estén presentes en el LibraryJar.
Etiquetas:action_command_lines
,experimental
--[no]experimental_inmemory_dotd_files
predeterminado: "true"-
Si está habilitado, los archivos .d de C++ se pasarán por 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 las compilaciones de Java se pasarán a través de 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_retain_test_configuration_across_testonly
predeterminado: "false"-
Cuando está habilitado, --trim_test_configuration no recortará la configuración de prueba para las reglas marcadas como testonly=1. Esto tiene como objetivo reducir los problemas de conflicto de acciones cuando las reglas que no son de prueba dependen de las reglas cc_test. No tiene efecto si --trim_test_configuration es falso.
Etiquetas:loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_starlark_cc_import
predeterminado: "false"-
Si está habilitado, 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"-
Indica si se deben reducir las entradas a la compilación de C/C++ analizando las líneas #include de los archivos de entrada. Esto puede mejorar el rendimiento y la incrementalidad, ya que disminuye el tamaño de los árboles de entrada de compilación. Sin embargo, también puede interrumpir las compilaciones porque el analizador de inclusión no implementa por completo la semántica del preprocesador de 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 este parámetro que se registren.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
,experimental
--[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 configura, los archivos .d que emite clang se usarán para reducir 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 destino //a:a, se procesan 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, las opciones relacionadas con las pruebas se borrarán 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 el nivel de detalle, 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 cadenas de herramientas y los objetivos específicos para ver cuáles depurar. Se pueden separar varias expresiones regulares 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 los expertos en la resolución de cadenas de herramientas.
Etiquetas:terminal_output
- Opciones que especifican o alteran una entrada genérica para un comando de Bazel que no se incluye en otras categorías.:
- Se acumulan los usos múltiples 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 ejecutables de los destinos de Python. Específicamente, cuando un destino py_binary o py_test tiene legacy_create_init establecido en "auto" (el valor predeterminado), se trata como falso si y 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 vínculo simbólico 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 configuren su atributo `python_version` (o `default_python_version`) se establecerán de forma predeterminada en PY3 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 nativo 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>
valor predeterminado: consulta la descripción-
Modo de versión principal de Python, ya sea "PY2" o "PY3". Ten en cuenta que los objetivos "py_binary" y "py_test" anulan este parámetro (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 varias, no clasificadas de otra manera.:
--[no]cache_test_results
[-t
] default: "auto"- Si se configura como "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 se marca como externa, (3) se solicitaron varias ejecuciones de prueba con --runs_per_test o(4) la prueba falló anteriormente. Si se configura como “sí”, Bazel almacena en caché todos los resultados de las pruebas, excepto las que se marcan como externas. Si se configura como "no", Bazel no almacena en caché ningún resultado de la prueba.
--[no]experimental_cancel_concurrent_tests
predeterminado: "false"-
Si es verdadero, Blaze cancelará las pruebas que se ejecuten de forma simultánea en la primera ejecución exitosa. Esto solo es útil en combinación con --runs_per_test_detects_flakes.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_fetch_all_coverage_outputs
predeterminado: "false"-
Si es verdadero, Bazel recupera el directorio completo de datos de cobertura para cada prueba durante una ejecución de cobertura.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_generate_llvm_lcov
predeterminado: "false"-
Si es verdadero, la cobertura de clang generará un informe de LCOV.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_j2objc_header_map
predeterminado: "true"-
Indica si se debe generar el mapa de encabezado de J2ObjC en paralelo con la transpilación de J2ObjC.
Etiquetas:experimental
--[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
--experimental_java_classpath=<off, javabuilder or bazel>
predeterminado: "javabuilder"- Habilita rutas de acceso de clase reducidas para las compilaciones de Java.
--[no]experimental_limit_android_lint_to_android_constrained_java
predeterminado: "false"-
No-op, kept only for backwards compatibility
Etiquetas:affects_outputs
,experimental
--[no]experimental_run_android_lint_on_java_rules
predeterminado: "false"-
Indica si se deben validar las fuentes java_*.
Etiquetas:affects_outputs
,experimental
--[no]explicit_java_test_deps
predeterminado: "false"- Especifica de forma explícita una dependencia de 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>
valor predeterminado: consulta la descripción- Es el launcher de Java que usan las herramientas que se ejecutan durante una compilación.
- Se acumulan los usos múltiples de
--host_javacopt=<a string>
- Opciones adicionales para pasar a javac cuando se compilan herramientas que se ejecutan durante una compilación.
- Se acumulan los usos múltiples de
--host_jvmopt=<a string>
- Opciones adicionales para pasar a la VM de Java cuando se compilan herramientas que se ejecutan durante la compilación. Estas opciones se agregarán a las opciones de inicio de la VM de cada destino java_binary.
--[no]incompatible_check_sharding_support
predeterminado: "true"-
Si es verdadero, Bazel fallará una prueba fragmentada si el ejecutor de pruebas no indica que admite el fragmentado tocando el archivo en la ruta de TEST_SHARD_STATUS_FILE. Si es falso, un ejecutor de pruebas que no admite 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 una ejecución de 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 esto puede impedir el almacenamiento en caché entre usuarios si se usa una caché compartida.
Etiquetas:loading_and_analysis
,incompatible_change
- Se acumulan los usos múltiples 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, classpath de tiempo de compilación) por destino de Java.
--[no]java_header_compilation
predeterminado: "true"- Compila archivos .ijar directamente desde la fuente.
- Valor predeterminado de
--java_language_version=<a string>
: "" - La versión del lenguaje Java
--java_launcher=<a build target label>
valor predeterminado: consulta la descripción- Es el lanzador de Java que se usará cuando se compilen archivos binarios de Java. Si esta marca se establece en la cadena vacía, se usa el iniciador del JDK. El atributo "launcher" anula esta marca.
--java_runtime_version=<a string>
valor predeterminado: "local_jdk"- La versión del entorno de ejecución de Java
- Se acumulan los usos múltiples de
--javacopt=<a string>
- Opciones adicionales para pasar a javac.
- Se acumulan los usos múltiples de
--jvmopt=<a string>
- Opciones adicionales para pasar a la JVM 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>
valor predeterminado: consulta la descripción- Especifica un archivo binario que se usará para generar la lista de clases que deben estar en el archivo dex principal cuando se compile multidex heredado.
--optimizing_dexer=<a build target label>
valor predeterminado: consulta la descripción- Especifica un objeto binario que se usará para realizar la conversión a dex sin fragmentación.
- Se acumulan los usos múltiples de
--plugin=<a build target label>
- Son los complementos que se usarán en la compilación. Actualmente, funciona con java_plugin.
--proguard_top=<a build target label>
valor predeterminado: consulta la descripción- Especifica qué versión de ProGuard se usará para quitar código cuando se compile un archivo binario de Java.
--proto_compiler=<a build target label>
default: "@bazel_tools//tools/proto:protoc"-
Es la etiqueta del compilador de .proto.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]proto_profile
predeterminado: "true"-
Indica si se debe pasar profile_path al compilador de proto.
Etiquetas:affects_outputs
,loading_and_analysis
--proto_profile_path=<a build target label>
valor predeterminado: consulta la descripción-
Es el perfil que se pasará al compilador de .proto como profile_path. Si no se configura, pero --proto_profile es verdadero (el valor predeterminado), se infiere la ruta de --fdo_optimize.
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
default: "@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>
valor 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>
default: "@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>
default: "@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 los usos múltiples de
--protocopt=<a string>
-
Opciones adicionales para pasar al compilador de protobuf.
Etiquetas:affects_outputs
--[no]runs_per_test_detects_flakes
predeterminado: "false"- Si es verdadero, cualquier fragmento en el que se apruebe al menos una ejecución o intento y falle al menos una ejecución o intento obtendrá el estado FLAKY.
--shell_executable=<a path>
valor predeterminado: consulta la descripción-
Ruta de acceso absoluta al ejecutable del shell que Bazel debe usar. Si no se configura, pero la variable de entorno BAZEL_SH se establece en la primera invocación de Bazel (que inicia un servidor de Bazel), Bazel la usa. Si no se establece ninguno, Bazel usa una ruta de acceso predeterminada codificada de forma rígida según el sistema operativo en el que se ejecuta (Windows: c:/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 provocar fallas en la compilación o en el tiempo de ejecución de los archivos binarios generados.
Etiquetas:loading_and_analysis
- Se acumulan los usos múltiples de
--test_arg=<a string>
- Especifica argumentos y opciones 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 se usa con el comando "bazel test".
--test_filter=<a string>
valor 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.
- Valor predeterminado de
--test_result_expiration=<an integer>
: "-1" - Esta opción está obsoleta y no tiene ningún 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 ante el primer error.
--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 división de pruebas: "explícita" para usar la división solo si el atributo de compilación "shard_count" está presente. "disabled" para no usar nunca la división de pruebas. "forced=k" para forzar "k" fragmentos para las pruebas, independientemente del atributo de compilación "shard_count".
- Valor predeterminado de
--tool_java_language_version=<a string>
: "" - Versión del lenguaje Java que se usa para ejecutar las herramientas necesarias durante una compilación
--tool_java_runtime_version=<a string>
valor predeterminado: "remotejdk_11"- 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 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 permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
--[no]gnu_format
predeterminado: "false"-
Si se configura, escribe la versión en stdout con las convenciones que se describen en los estándares de GNU.
Etiquetas:affects_outputs
,execution
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que se puede acceder desde los archivos BUILD, los archivos .bzl o los archivos WORKSPACE.:
--[no]incompatible_use_plus_in_repo_names
predeterminado: "true"-
No-op.
Etiquetas:loading_and_analysis
Etiquetas de efecto de opción
unknown |
Esta opción tiene un efecto desconocido o no documentado. |
no_op |
Esta opción no tiene ningún efecto. |
loses_incremental_state |
Cambiar el valor de esta opción puede causar una pérdida significativa del estado incremental, lo que ralentiza las compilaciones. El estado podría perderse debido a un reinicio del servidor o a la invalidación de una gran parte del gráfico de dependencias. |
changes_inputs |
Esta opción cambia de forma activa las entradas que Bazel considera para la compilación, como las restricciones del sistema de archivos, las versiones del repositorio o cualquier otra opción. |
affects_outputs |
Esta opción afecta los resultados de Bazel. Esta etiqueta es intencionalmente amplia, 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. Por sí sola, esta etiqueta no significa que los artefactos de compilación se vean afectados. |
loading_and_analysis |
Esta opción afecta la carga y el análisis de las 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 el aislamiento 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 un error, en los casos en que exista la opción de continuar a pesar del error o 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 la salida de la terminal de Bazel. |
action_command_lines |
Esta opción cambia los argumentos de la línea de comandos de una o más acciones de compilación. |
test_runner |
Esta opción cambia el entorno del ejecutor de pruebas de la compilación. |
Etiquetas de metadatos de opciones
experimental |
Esta opción activa una función experimental sin garantías de funcionalidad. |
incompatible_change |
Esta opción activa un cambio rotundo. Usa esta opción para probar si tu migración está lista o para obtener acceso anticipado a la nueva función |
deprecated |
Esta opción está obsoleta. Es posible que la función que afecta esté obsoleta o que se prefiera otro método para proporcionar la información. |
immutable |
Esta opción no se puede cambiar en una transición. |