bazel [<startup options>] <command> [<args>]o
bazel [<startup options>] <command> [<args>] -- [<target patterns>]Consulta la Guía del usuario para obtener la sintaxis de los patrones de destino.
Sintaxis de opciones
Las opciones se pueden pasar a Bazel de diferentes maneras. Las opciones que requieren un valor se pueden pasar con un signo igual o un espacio:
--<option>=<value> --<option> <value>Algunas opciones tienen una forma abreviada de un solo carácter. En ese caso, la forma abreviada se debe pasar con un solo guion y un espacio.
-<short_form> <value>
Las opciones booleanas se pueden habilitar de la siguiente manera:
--<option> --<option>=[true|yes|1]y se pueden inhabilitar de la siguiente manera:
--no<option> --<option>=[false|no|0]
Por lo general, las opciones de tres estados se establecen en automático de forma predeterminada y se pueden habilitar de manera forzosa de la siguiente manera:
--<option>=[true|yes|1]o inhabilitar de manera forzosa de la siguiente manera:
--no<option> --<option>=[false|no|0]
Comandos
analyze-profile |
Analiza los datos del perfil de compilación. |
aquery |
Analiza los objetivos determinados y consulta el gráfico de acciones. |
build |
Compila los destinos especificados. |
canonicalize-flags |
Canoniza una lista de opciones de Bazel. |
clean |
Quita los archivos de salida y, de manera opcional, detiene el servidor. |
coverage |
Genera un informe de cobertura de código para los destinos de prueba especificados. |
cquery |
Carga, analiza y consulta los destinos especificados con configuraciones. |
dump |
Genera un volcado del estado interno del proceso del servidor de Bazel. |
fetch |
Recupera los repositorios externos que son requisitos previos para los destinos. |
help |
Imprime ayuda para los comandos o el índice. |
info |
Muestra información del entorno de ejecución sobre el servidor de Bazel. |
license |
Imprime la licencia de este software. |
mobile-install |
Instala destinos en dispositivos móviles. |
modquery |
Consulta el gráfico de dependencias externas de Bzlmod. |
print_action |
Imprime los argumentos de la línea de comandos para compilar un archivo. |
query |
Ejecuta una consulta de gráfico de dependencias. |
run |
Ejecuta el destino especificado. |
shutdown |
Detiene el servidor de Bazel. |
sync |
Sincroniza todos los repositorios especificados en el archivo del lugar de trabajo. |
test |
Compila y ejecuta los destinos de prueba especificados. |
version |
Imprime la información de la versión de bazel. |
Opciones de inicio
- Opciones que aparecen antes del comando y que el cliente analiza:
--[no]autodetect_server_javabase
predeterminado: "true"-
Cuando se pasa --noautodetect_server_javabase, Bazel no recurre al JDK local para ejecutar el servidor de Bazel y, en su lugar, sale.
Etiquetas:affects_outputs
,loses_incremental_state
--[no]batch
predeterminado: “false”-
Si se establece, Bazel se ejecutará solo como un proceso de cliente sin un servidor, en lugar de en el modo cliente-servidor estándar. Esta función dejó de estar disponible y se quitará. Si quieres evitar que los servidores permanezcan en el sistema, cierra el servidor de forma explícita.
Etiquetas:loses_incremental_state
,bazel_internal_configuration
,deprecated
--[no]batch_cpu_scheduling
predeterminado: “false”-
Solo en Linux. Usa la programación de CPU "por lotes" para Blaze. Esta política es útil para cargas de trabajo que no son interactivas, pero no quieren disminuir su valor de agrado. Consulta "man 2 sched_setscheduler". Si es falso, Bazel no realiza una llamada al sistema.
Etiquetas:host_machine_resource_optimizations
--bazelrc=<path>
predeterminado: Consulta la descripción-
Es la ubicación del archivo .bazelrc del usuario que contiene los valores predeterminados de las opciones de Bazel. /dev/null indica que se ignorarán todos los demás `--bazelrc`, lo que es útil para inhabilitar la búsqueda de un archivo rc de usuario, p.ej., en compilaciones de lanzamiento.
Esta opción también se puede especificar varias veces.
Por ejemplo, con `--bazelrc=x.rc --bazelrc=y.rc --bazelrc=/dev/null --bazelrc=z.rc`,
1) Se leen x.rc y y.rc.
2) Se ignora z.rc debido al /dev/null anterior.
Si no se especifica, Bazel usa el primer archivo .bazelrc que encuentra en las siguientes dos ubicaciones: el directorio del lugar de trabajo y, luego, el directorio principal del usuario.
Nota: Las opciones de línea de comandos siempre reemplazarán cualquier opción en bazelrc.
Etiquetas:changes_inputs
--[no]block_for_lock
predeterminado: "true"-
Cuando se pasa --noblock_for_lock, Bazel no espera a que se complete un comando en ejecución, sino que sale de inmediato.
Etiquetas:eagerness_to_exit
--[no]client_debug
predeterminado: “false”-
Si es verdadero, registra la información de depuración del cliente en stderr. Cambiar esta opción no hará que se reinicie el servidor.
Etiquetas:affects_outputs
,bazel_monitoring
--connect_timeout_secs=<an integer>
predeterminado: “30”-
Es la cantidad de tiempo que el cliente espera por cada intento de conexión al servidor.
Etiquetas:bazel_internal_configuration
--[no]expand_configs_in_place
predeterminado: "true"-
Se cambió la expansión de las marcas --config para que se realice en su lugar, en lugar de una expansión de punto fijo entre las opciones de rc normales y las opciones especificadas en la línea de comandos.
Etiquetas:no_op
,deprecated
--failure_detail_out=<path>
predeterminado: Consulta la descripción-
Si se establece, especifica una ubicación para escribir un mensaje de protobuf failure_detail si el servidor experimenta una falla y no puede informarla a través de gRPC, como de costumbre. De lo contrario, la ubicación será ${OUTPUT_BASE}/failure_detail.rawproto.
Etiquetas:affects_outputs
,loses_incremental_state
--[no]home_rc
predeterminado: "true"-
Determina si se debe buscar o no el archivo bazelrc de inicio en $HOME/.bazelrc.
Etiquetas:changes_inputs
--[no]idle_server_tasks
predeterminado: "true"-
Ejecuta System.gc() cuando el servidor esté inactivo.
Etiquetas:loses_incremental_state
,host_machine_resource_optimizations
--[no]ignore_all_rc_files
predeterminado: “false”-
Inhabilita todos los archivos rc, independientemente de los valores de otras marcas que modifiquen rc, incluso si estas marcas aparecen más adelante en la lista de opciones de inicio.
Etiquetas:changes_inputs
--io_nice_level={-1,0,1,2,3,4,5,6,7}
predeterminado: “-1”-
Solo en Linux. Establece un nivel de 0 a 7 para la programación de E/S del mejor esfuerzo con la llamada al sistema sys_ioprio_set. 0 es la prioridad más alta y 7 es la más baja. El programador anticipado solo puede respetar hasta la prioridad 4. Si se establece en un valor negativo, Bazel no realiza una llamada al sistema.
Etiquetas:host_machine_resource_optimizations
--local_startup_timeout_secs=<an integer>
predeterminado: "120"-
Es la cantidad máxima de tiempo que el cliente espera para conectarse al servidor.
Etiquetas:bazel_internal_configuration
--macos_qos_class=<a string>
predeterminado: "predeterminado"-
Establece la clase de servicio de QoS del servidor bazel cuando se ejecuta en macOS. Esta marca no tiene efecto en ninguna otra plataforma, pero es compatible para garantizar que los archivos rc se puedan compartir entre ellas sin cambios. Los valores posibles son: interactivo con el usuario, iniciado por el usuario, predeterminado, de utilidad y en segundo plano.
Etiquetas:host_machine_resource_optimizations
--max_idle_secs=<integer>
predeterminado: “10800”-
Es la cantidad de segundos que el servidor de compilación esperará inactivo antes de apagarse. Cero significa que el servidor nunca se cerrará. Solo se lee al iniciar el servidor. Cambiar esta opción no hará que el servidor se reinicie.
Etiquetas:eagerness_to_exit
,loses_incremental_state
--output_base=<path>
predeterminado: Consulta la descripción-
Si se establece, especifica la ubicación de salida a la que se escribirá todo el resultado de la compilación. De lo contrario, la ubicación será ${OUTPUT_ROOT}/_blaze_${USER}/${MD5_OF_WORKSPACE_ROOT}. Nota: Si especificas una opción diferente de una a la siguiente invocación de Bazel para este valor, es probable que inicies un nuevo servidor de Bazel adicional. Bazel inicia exactamente un servidor por base de salida especificada. Por lo general, hay una base de salida por espacio de trabajo. Sin embargo, con esta opción, puedes tener varias bases de salida por espacio de trabajo y, de esta manera, ejecutar varias compilaciones para el mismo cliente en la misma máquina de forma simultánea. Consulta "bazel help shutdown" para obtener información sobre cómo cerrar un servidor de Bazel.
Etiquetas:affects_outputs
,loses_incremental_state
--output_user_root=<path>
predeterminado: Consulta la descripción-
Es el directorio específico del usuario debajo del cual se escriben todos los resultados de la compilación. De forma predeterminada, esta es una función de $USER, pero si especificas una constante, los resultados de la compilación se pueden compartir entre los usuarios que colaboran.
Etiquetas:affects_outputs
,loses_incremental_state
--[no]preemptible
predeterminado: “false”-
Si es verdadero, se puede anular el comando si se inicia otro.
Etiquetas:eagerness_to_exit
--server_jvm_out=<path>
predeterminado: Consulta la descripción-
Es la ubicación en la que se escribirá el resultado de la JVM del servidor. Si no se establece, se establece de forma predeterminada en una ubicación en output_base.
Etiquetas:affects_outputs
,loses_incremental_state
--[no]shutdown_on_low_sys_mem
predeterminado: “false”-
Si se configuró max_idle_secs y el servidor de compilación estuvo inactivo durante un tiempo, cierra el servidor cuando el sistema tenga poca RAM libre. Solo en Linux.
Etiquetas:eagerness_to_exit
,loses_incremental_state
--[no]system_rc
predeterminado: "true"-
Indica si se debe buscar o no el bazelrc para todo el sistema.
Etiquetas:changes_inputs
--[no]unlimit_coredumps
predeterminado: “false”-
Aumenta el límite de volcado de núcleo suave al límite duro para que se puedan crear volcados de núcleo del servidor (incluida la JVM) y del cliente en condiciones comunes. Agrega esta marca a tu bazelrc una vez y olvídate de ella para obtener volcados de memoria principal cuando encuentres una condición que los active.
Etiquetas:bazel_internal_configuration
--[no]watchfs
predeterminado: “false”-
Si es verdadero, bazel intenta usar el servicio de supervisión de archivos del sistema operativo para los cambios locales en lugar de analizar cada archivo en busca de cambios.
Etiquetas:deprecated
--[no]windows_enable_symlinks
predeterminado: “false”-
Si es verdadero, se crearán vínculos simbólicos reales en Windows en lugar de copiar archivos. Requiere que se habilite el modo de desarrollador de Windows y Windows 10 versión 1703 o posterior.
Etiquetas:bazel_internal_configuration
--[no]workspace_rc
predeterminado: "true"-
Determina si se debe buscar o no el archivo bazelrc del espacio de trabajo en $workspace/.bazelrc.
Etiquetas:changes_inputs
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--host_jvm_args=<jvm_arg>
- Son marcas para pasar a la JVM que ejecuta Blaze.
--host_jvm_debug
-
Opción de conveniencia para agregar algunas marcas de inicio adicionales de JVM, que hacen que la JVM espere durante el inicio hasta que te conectes desde un depurador compatible con JDWP (como Eclipse) al puerto 5005.
Se expande a:
--host_jvm_args=-Xdebug
--host_jvm_args=-Xrunjdwp:transport=dt_socket,server=y,address=5005
--host_jvm_profile=<profiler_name>
predeterminado: ""- Opción de conveniencia para agregar algunas marcas de inicio de JVM específicas del generador de perfiles o depurador. Bazel tiene una lista de valores conocidos que asigna a marcas de inicio de JVM codificadas, posiblemente buscando algunas rutas de acceso fijas para ciertos archivos.
--server_javabase=<jvm path>
predeterminado: ""- Ruta de acceso a la JVM que se usa para ejecutar Bazel.
Opciones comunes a todos los comandos
- Opciones que controlan la ejecución de la compilación:
--experimental_oom_more_eagerly_threshold=<an integer>
predeterminado: "100"-
Si esta marca se establece en un valor inferior a 100, Bazel se quedará sin espacio en la memoria si, después de dos GC completas, aún se ocupa más de este porcentaje del montón (generación anterior).
Etiquetas:host_machine_resource_optimizations
--experimental_ui_max_stdouterr_bytes=<an integer in (-1)-1073741819 range>
predeterminado: “1048576”-
Es el tamaño máximo de los archivos stdout / stderr que se imprimirán en la consola. -1 implica que no hay límite.
Etiquetas:execution
- Son opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
- Se acumulan varios usos de
--repo_env=<a 'name=value' assignment with an optional value part>
- especifica variables de entorno adicionales que estarán disponibles solo para las reglas del repositorio. Ten en cuenta que, de todos modos, las reglas del repositorio ven el entorno completo, pero de esta manera la información de configuración se puede pasar a los repositorios a través de opciones sin invalidar el gráfico de acciones.
Etiquetas:action_command_lines
- Opciones que afectan la rigurosidad con la que Bazel aplica entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etc.):
--[no]check_bzl_visibility
predeterminado: "true"-
Si se inhabilita, los errores de visibilidad de carga de .bzl se degradan a advertencias.
Etiquetas:build_file_semantics
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.:
--[no]enable_bzlmod
predeterminado: “false”-
Si es verdadero, habilita el sistema de administración de dependencias de Bzlmod, que tiene prioridad sobre WORKSPACE. Consulta https://bazel.build/build/bzlmod para obtener más información.
Etiquetas:loading_and_analysis
--[no]experimental_action_resource_set
predeterminado: "true"-
Si se establece como verdadero, ctx.actions.run() y ctx.actions.run_shell() aceptan un parámetro resource_set para la ejecución local. De lo contrario, se establecerá de forma predeterminada en 250 MB para la memoria y 1 CPU.
Etiquetas:execution
,build_file_semantics
,experimental
-
Si se establece como verdadero, las etiquetas se propagarán de un objetivo a los requisitos de ejecución de las acciones. De lo contrario, no se propagarán. Consulta https://github.com/bazelbuild/bazel/issues/8830 para obtener más información.
Etiquetas:build_file_semantics
,experimental
--[no]experimental_analysis_test_call
predeterminado: "true"-
Si se establece como verdadero, la llamada nativa analysis_test está disponible.
Etiquetas:loading_and_analysis
,build_file_semantics
,experimental
--[no]experimental_bzl_visibility
predeterminado: "true"-
Si está habilitada, agrega una función "visibility()` a la que los archivos .bzl pueden llamar durante la evaluación de nivel superior para establecer su visibilidad con el fin de las sentencias load().
Etiquetas:loading_and_analysis
,experimental
-
Si se establece como verdadero, los atributos de reglas y los métodos de la API de Starlark necesarios para la regla cc_shared_library estarán disponibles.
Etiquetas:build_file_semantics
,loading_and_analysis
,experimental
--[no]experimental_disable_external_package
predeterminado: “false”-
Si se establece en verdadero, el paquete //external generado automáticamente ya no estará disponible. Bazel aún no podrá analizar el archivo "external/BUILD", pero funcionarán los globs que lleguen a external/ desde el paquete sin nombre.
Etiquetas:loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_enable_android_migration_apis
predeterminado: “false”-
Si se establece como verdadero, habilita las APIs necesarias para admitir la migración de Starlark de Android.
Etiquetas:build_file_semantics
--[no]experimental_get_fixed_configured_action_env
predeterminado: “false”-
Si está habilitado, action.env también mostrará las variables de entorno fijas especificadas a través de la configuración de funciones.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_google_legacy_api
predeterminado: “false”-
Si se establece en "true", expone varias partes experimentales de la API de compilación de Starlark relacionadas con el código heredado de Google.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_lazy_template_expansion
predeterminado: "true"-
Si se establece en verdadero, ctx.actions.expand_template() acepta un parámetro TemplateDict para la evaluación diferida de los valores de sustitución.
Etiquetas:execution
,build_file_semantics
,experimental
--[no]experimental_platforms_api
predeterminado: “false”-
Si se establece como verdadero, habilita varias APIs de Starlark relacionadas con la plataforma que son útiles para depurar.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repo_remote_exec
predeterminado: “false”-
Si se establece como verdadero, repository_rule obtiene algunas capacidades de ejecución remota.
Etiquetas:build_file_semantics
,loading_and_analysis
,experimental
--[no]experimental_sibling_repository_layout
predeterminado: “false”-
Si se establece como verdadero, los repositorios que no son principales se plantan como symlinks al repositorio principal en la raíz de ejecución. Es decir, todos los repositorios son elementos secundarios directos del directorio $output_base/execution_root. Esto tiene el efecto secundario de liberar $output_base/execution_root/__main__/external para el directorio "externo" de nivel superior real.
Etiquetas:action_command_lines
,bazel_internal_configuration
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]incompatible_always_check_depset_elements
predeterminado: "true"-
Verifica la validez de los elementos agregados a los conjuntos de dependencias en todos los constructores. Los elementos deben ser inmutables, pero, históricamente, el constructor depset(direct=…) se olvidó de verificarlo. Usa tuplas en lugar de listas en los elementos de depset. Consulta https://github.com/bazelbuild/bazel/issues/10313 para obtener más información.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_depset_for_libraries_to_link_getter
predeterminado: "true"-
Cuando es verdadero, Bazel ya no muestra una lista de linking_context.libraries_to_link, sino un conjunto de dependencias.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_disable_starlark_host_transitions
predeterminado: “false”-
Si se establece como verdadero, los atributos de la regla no pueden establecer "cfg = "host"'. En su lugar, las reglas deben establecer "cfg = "exec"'.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_disable_target_provider_fields
predeterminado: “false”-
Si se establece como verdadero, inhabilita la capacidad de acceder a los proveedores en objetos "objetivo" a través de la sintaxis de campo. En su lugar, usa la sintaxis de clave de proveedor. Por ejemplo, en lugar de usar "ctx.attr.dep.my_info" para acceder a "my_info" desde dentro de una función de implementación de reglas, usa "ctx.attr.dep[MyInfo]". Consulta https://github.com/bazelbuild/bazel/issues/9014 para obtener más información.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_disallow_empty_glob
predeterminado: “false”-
Si se establece en verdadero, el valor predeterminado del argumento "allow_empty" de glob() es falso.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_disallow_legacy_javainfo
predeterminado: "true"-
Obsoleto. No realiza ninguna acción.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_disallow_struct_provider_syntax
predeterminado: “false”-
Si se establece como verdadero, es posible que las funciones de implementación de reglas no devuelvan una struct. En su lugar, deben mostrar una lista de instancias de proveedor.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_existing_rules_immutable_view
predeterminado: "true"-
Si se establece como verdadero, native.existing_rule y native.existing_rules muestran objetos de vista inmutables ligeros en lugar de diccionarios mutables.
Etiquetas:build_file_semantics
,loading_and_analysis
,incompatible_change
--[no]incompatible_fix_package_group_reporoot_syntax
predeterminado: "true"-
En el atributo "packages" de package_group, cambia el significado del valor "//…" para que haga referencia a todos los paquetes del repositorio actual en lugar de a todos los paquetes de cualquier repositorio. Puedes usar el valor especial "public" en lugar de "//…" para obtener el comportamiento anterior. Esta marca requiere que también se habilite --incompatible_package_group_has_public_syntax.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_java_common_parameters
predeterminado: "true"-
Si se establece como verdadero, se quitarán todos los parámetros output_jar y host_javabase en pack_sources y host_javabase en compile.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_new_actions_api
predeterminado: "true"-
Si se establece como verdadero, la API para crear acciones solo está disponible en "ctx.actions", no en "ctx".
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_no_attr_license
predeterminado: "true"-
Si se establece como verdadero, inhabilita la función "attr.license".
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_no_implicit_file_export
predeterminado: “false”-
Si se establece, los archivos de origen (usados) son privados del paquete, a menos que se exporten de forma explícita. Consulta https://github.com/bazelbuild/proposals/blob/master/designs/2019-10-24-file-visibility.md
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_no_rule_outputs_param
predeterminado: “false”-
Si se establece como verdadero, inhabilita el parámetro "outputs" de la función Starlark "rule()`".
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_package_group_has_public_syntax
predeterminado: "true"-
En el atributo "packages" de package_group, permite escribir "public" o "private" para hacer referencia a todos los paquetes o a ninguno, respectivamente.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_require_linker_input_cc_api
predeterminado: "true"-
Si se establece como verdadero, la regla create_linking_context requerirá linker_inputs en lugar de libraries_to_link. Los get anteriores 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_stop_exporting_language_modules
predeterminado: “false”-
Si está habilitado, ciertos módulos específicos de lenguaje (como "cc_common") no están disponibles en los archivos .bzl del usuario y solo se puede llamar desde sus respectivos repositorios de reglas.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_struct_has_no_methods
predeterminado: “false”-
Inhabilita los métodos to_json y to_proto de struct, que contaminan el espacio de nombres del campo struct. En su lugar, usa json.encode o json.encode_indent para JSON, o proto.encode_text para textproto.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_top_level_aspects_require_providers
predeterminado: “false”-
Si se establece como verdadero, el aspecto de nivel superior respetará sus proveedores obligatorios y solo se ejecutará en los destinos de nivel superior cuyos proveedores anunciados de las reglas satisfagan los proveedores obligatorios del aspecto.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_unambiguous_label_stringification
predeterminado: "true"-
Cuando sea verdadero, Bazel convertirá la etiqueta @//foo:bar en @//foo:bar, en lugar de //foo:bar. Esto solo afecta el comportamiento de str(), el operador %, etcétera. El comportamiento de repr() no cambia. Consulta https://github.com/bazelbuild/bazel/issues/15916 para obtener más información.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_use_cc_configure_from_rules_cc
predeterminado: “false”-
Cuando sea verdadero, Bazel ya no permitirá usar cc_configure desde @bazel_tools. Consulta https://github.com/bazelbuild/bazel/issues/10134 para obtener detalles y las instrucciones de migración.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_visibility_private_attributes_at_definition
predeterminado: “false”-
Si se establece como verdadero, la visibilidad de los atributos de reglas privadas se verifica en función de la definición de la regla, en lugar de su uso.
Etiquetas:build_file_semantics
,incompatible_change
--max_computation_steps=<a long integer>
predeterminado: “0”-
Es la cantidad máxima de pasos de procesamiento de Starlark que puede ejecutar un archivo BUILD (cero significa que no hay límite).
Etiquetas:build_file_semantics
--nested_set_depth_limit=<an integer>
predeterminado: “3500”-
Es la profundidad máxima del gráfico interno de un conjunto de dependencias (también conocido como NestedSet), por encima de la cual fallará el constructor de depset().
Etiquetas:loading_and_analysis
- Opciones que activan optimizaciones del tiempo de compilación:
--[no]incompatible_do_not_split_linking_cmdline
predeterminado: "true"-
Cuando es verdadero, Bazel ya no modifica las marcas de línea de comandos que se usan para la vinculación y tampoco decide de forma selectiva qué marcas van al archivo de parámetros y cuáles no. Consulta https://github.com/bazelbuild/bazel/issues/7670 para obtener más información.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]keep_state_after_build
predeterminado: "true"-
Si es falso, Blaze descartará el estado en memoria de esta compilación cuando finalice. Las compilaciones posteriores no tendrán ninguna incrementalidad con respecto a esta.
Etiquetas:loses_incremental_state
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Es una marca para la configuración avanzada del motor Skyframe interno de Bazel. Si Bazel detecta que el uso porcentual del montón retenido es de al menos este límite, descartará el estado temporal innecesario de Skyframe. Si ajustas este parámetro, es posible que puedas mitigar el impacto del tiempo de ejecución de la fragmentación de GC, cuando esta se produce (i) por el uso de memoria de este estado temporal y (ii) es más costoso que reconstituir el estado cuando sea necesario.
Etiquetas:host_machine_resource_optimizations
--[no]track_incremental_state
predeterminado: "true"-
Si es falso, Blaze no conservará los datos que permiten la invalidación y la reevaluación en compilaciones incrementales para ahorrar memoria en esta compilación. Las compilaciones posteriores no tendrán ninguna incrementalidad con respecto a esta. Por lo general, querrás especificar --batch cuando establezcas este valor en falso.
Etiquetas:loses_incremental_state
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]announce_rc
predeterminado: “false”-
Indica si se deben anunciar las opciones de rc.
Etiquetas:affects_outputs
--[no]attempt_to_print_relative_paths
predeterminado: “false”-
Cuando imprimas la parte de ubicación de los mensajes, intenta usar una ruta de acceso relativa al directorio del espacio de trabajo o a uno de los directorios especificados por --package_path.
Etiquetas:terminal_output
--bes_backend=<a string>
predeterminado: ""-
Especifica el extremo de backend del servicio de eventos de compilación (BES) en el formato [SCHEME://]HOST[:PORT]. La opción predeterminada es inhabilitar las cargas de BES. Los esquemas compatibles son grpc y grpcs (grpc con TLS habilitado). Si no se proporciona un esquema, Bazel supone que se trata de GRPC.
Etiquetas:affects_outputs
--[no]bes_check_preceding_lifecycle_events
predeterminado: “false”-
Establece el campo check_preceding_lifecycle_events_present en PublishBuildToolEventStreamRequest, que le indica a BES que verifique si recibió anteriormente eventos InvocationAttemptStarted y BuildEnqueued que coincidan con el evento de herramienta actual.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--bes_header=<a 'name=value' assignment>
-
Especifica un encabezado en el formato NAME=VALUE que se incluirá en las solicitudes de BES. Se pueden pasar varios encabezados si especificas la marca varias veces. Los múltiples valores para el mismo nombre se convertirán en una lista separada por comas.
Etiquetas:affects_outputs
--bes_instance_name=<a string>
predeterminado: Consulta la descripción-
Especifica el nombre de la instancia en la que el BES conservará el BEP subido. La configuración predeterminada es nula.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--bes_keywords=<comma-separated list of options>
-
Especifica una lista de palabras clave de notificación que se agregarán al conjunto predeterminado de palabras clave publicadas en BES ("command_name=<command_name> ", "protocol_name=BEP"). El valor predeterminado es ninguno.
Etiquetas:affects_outputs
--[no]bes_lifecycle_events
predeterminado: "true"-
Especifica si se deben publicar eventos del ciclo de vida de BES. (el valor predeterminado es "true").
Etiquetas:affects_outputs
--bes_oom_finish_upload_timeout=<An immutable length of time.>
predeterminado: "10m"-
Especifica cuánto tiempo debe esperar bazel para que se complete la carga de BES/BEP mientras se produce una falta de memoria. Esta marca garantiza la finalización cuando la JVM tiene una fragmentación grave de GC y no puede avanzar en ningún subproceso de usuario.
Etiquetas:bazel_monitoring
--bes_outerr_buffer_size=<an integer>
predeterminado: “10240”-
Especifica el tamaño máximo de stdout o stderr que se almacenará en búfer en BEP, antes de que se informe como un evento de progreso. Las operaciones de escritura individuales se siguen informando en un solo evento, incluso si son más grandes que el valor especificado hasta --bes_outerr_chunk_size.
Etiquetas:affects_outputs
--bes_outerr_chunk_size=<an integer>
predeterminado: “1048576”-
Especifica el tamaño máximo de stdout o stderr que se enviará a BEP en un solo mensaje.
Etiquetas:affects_outputs
--bes_proxy=<a string>
predeterminado: Consulta la descripción- Conéctate al servicio de eventos de compilación a través de un proxy. Actualmente, esta marca solo se puede usar para configurar un socket de dominio Unix (unix:/path/to/socket).
--bes_results_url=<a string>
predeterminado: ""-
Especifica la URL base en la que un usuario puede ver la información transmitida al backend de BES. Bazel mostrará la URL que el ID de invocación adjuntó a la terminal.
Etiquetas:terminal_output
--bes_timeout=<An immutable length of time.>
predeterminado: “0s”-
Especifica cuánto tiempo debe esperar bazel para que se complete la carga de BES/BEP después de que finalicen la compilación y las pruebas. Un tiempo de espera válido es un número natural seguido de una unidad: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). El valor predeterminado es “0”, lo que significa que no hay tiempo de espera.
Etiquetas:affects_outputs
--build_event_binary_file=<a string>
predeterminado: ""-
Si no está vacío, escribe una representación binaria delimitada por varint del protocolo de eventos de compilación en ese archivo. Esta opción implica --bes_upload_mode=wait_for_upload_complete.
Etiquetas:affects_outputs
--[no]build_event_binary_file_path_conversion
predeterminado: "true"-
Convierte las rutas de acceso en la representación de archivo binario del protocolo de evento de compilación a URIs más válidos a nivel global siempre que sea posible. Si está inhabilitado, siempre se usará el esquema de URI file://.
Etiquetas:affects_outputs
--build_event_json_file=<a string>
predeterminado: ""-
Si no está vacío, escribe una serialización JSON del protocolo del evento de compilación en ese archivo.
Etiquetas:affects_outputs
--[no]build_event_json_file_path_conversion
predeterminado: "true"-
Convierte las rutas de acceso en la representación del archivo JSON del protocolo del evento de compilación a URIs más válidos a nivel global siempre que sea posible. Si se inhabilita, siempre se usará el esquema de URI file://.
Etiquetas:affects_outputs
--build_event_max_named_set_of_file_entries=<an integer>
predeterminado: “-1”-
Es la cantidad máxima de entradas para un solo evento named_set_of_files. Se ignoran los valores menores que 2 y no se realiza ninguna división de eventos. Su objetivo es limitar el tamaño máximo del evento en el protocolo de eventos de compilación, aunque no controla directamente el tamaño del evento. El tamaño total del evento es una función de la estructura del conjunto, así como de las longitudes del archivo y del URI, que a su vez pueden depender de la función hash.
Etiquetas:affects_outputs
--[no]build_event_publish_all_actions
predeterminado: “false”-
Indica si se deben publicar todas las acciones.
Etiquetas:affects_outputs
--build_event_text_file=<a string>
predeterminado: ""-
Si no está vacío, escribe una representación textual del protocolo del evento de compilación en ese archivo.
Etiquetas:affects_outputs
--[no]build_event_text_file_path_conversion
predeterminado: "true"-
Convierte las rutas de acceso en la representación del archivo de texto del protocolo del evento de compilación a URIs más válidos a nivel global siempre que sea posible. Si se inhabilita, siempre se usará el esquema de URI file://.
Etiquetas:affects_outputs
--[no]experimental_announce_profile_path
predeterminado: “false”-
Si está habilitado, agrega la ruta de acceso del perfil JSON al registro.
Etiquetas:affects_outputs
,bazel_monitoring
--[no]experimental_bep_target_summary
predeterminado: “false”- Determina si se deben publicar eventos TargetSummary.
--[no]experimental_build_event_expand_filesets
predeterminado: “false”-
Si es verdadero, expande los conjuntos de archivos en el BEP cuando se presenten los archivos de salida.
Etiquetas:affects_outputs
--[no]experimental_build_event_fully_resolve_fileset_symlinks
predeterminado: “false”-
Si es verdadero, resuelve completamente los symlinks de conjuntos de archivos relativos en el BEP cuando se presentan archivos de salida. Requiere --experimental_build_event_expand_filesets.
Etiquetas:affects_outputs
--experimental_build_event_upload_max_retries=<an integer>
predeterminado: “4”-
Es la cantidad máxima de veces que Bazel debe volver a intentar subir un evento de compilación.
Etiquetas:bazel_internal_configuration
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
predeterminado: "1s"-
Retraso inicial mínimo para los reintentos de retirada exponencial cuando falla la carga de BEP. (exponente: 1.6)
Etiquetas:bazel_internal_configuration
--experimental_build_event_upload_strategy=<a string>
predeterminado: Consulta la descripción-
Selecciona cómo subir artefactos a los que se hace referencia en el protocolo del evento de compilación.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--experimental_profile_additional_tasks=<phase, action, action_check, action_lock, action_release, action_update, action_complete, info, create_package, remote_execution, local_execution, scanner, local_parse, upload_time, process_time, remote_queue, remote_setup, fetch, vfs_stat, vfs_dir, vfs_readlink, vfs_md5, vfs_xattr, vfs_delete, vfs_open, vfs_read, vfs_write, vfs_glob, vfs_vmfs_stat, vfs_vmfs_dir, vfs_vmfs_read, wait, thread_name, thread_sort_index, skyframe_eval, skyfunction, critical_path, critical_path_component, handle_gc_notification, action_counts, local_cpu_usage, system_cpu_usage, local_memory_usage, system_memory_usage, system_network_up_usage, system_network_down_usage, workers_memory_usage, system_load_average, starlark_parser, starlark_user_fn, starlark_builtin_fn, starlark_user_compiled_fn, starlark_repository_fn, action_fs_staging, remote_cache_check, remote_download, remote_network, filesystem_traversal, worker_execution, worker_setup, worker_borrow, worker_working, worker_copying_outputs, credential_helper or unknown>
-
Especifica las tareas de perfil adicionales que se incluirán en el perfil.
Etiquetas:affects_outputs
,bazel_monitoring
--[no]experimental_profile_include_primary_output
predeterminado: “false”-
Incluye el atributo "out" adicional en los eventos de acción que contiene la ruta de ejecución al resultado principal de la acción.
Etiquetas:affects_outputs
,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:affects_outputs
,bazel_monitoring
--[no]experimental_stream_log_file_uploads
predeterminado: “false”-
El archivo de registro de transmisión se sube directamente al almacenamiento remoto en lugar de escribirlo en el disco.
Etiquetas:affects_outputs
--experimental_workspace_rules_log_file=<a path>
predeterminado: Consulta la descripción- Registra ciertos eventos de las reglas de Workspace en este archivo como protos de WorkspaceEvent delimitados.
--[no]generate_json_trace_profile
predeterminado: “auto”-
Si está habilitado, Bazel genera perfiles de la compilación y escribe un perfil en formato JSON en un archivo de la base de salida. Para ver el perfil, carga chrome://tracing. De forma predeterminada, Bazel escribe el perfil para todos los comandos y consultas similares a la compilación.
Etiquetas:affects_outputs
,bazel_monitoring
--[no]heap_dump_on_oom
predeterminado: “false”-
Determina si se debe generar manualmente un volcado de montón si se genera una OOM (incluidas las OOM debido a --experimental_oom_more_eagerly_threshold). El volcado se escribirá en <output_base>/<invocation_id>.heapdump.hprof. Esta opción reemplaza de manera efectiva -XX:+HeapDumpOnOutOfMemoryError, que no tiene efecto porque los errores de OOM se detectan y se redireccionan a Runtime#halt.
Etiquetas:bazel_monitoring
--[no]legacy_important_outputs
predeterminado: "true"-
Usa esto para suprimir la generación del campo important_outputs heredado en el evento TargetComplete. important_outputs es obligatorio para la integración de Bazel en ResultStore.
Etiquetas:affects_outputs
--logging=<0 <= an integer <= 6>
predeterminado: “3”- : Es el nivel de registro.
Etiquetas:affects_outputs
--memory_profile=<a path>
predeterminado: Consulta la descripción-
Si se establece, escribe los datos de uso de la memoria en el archivo especificado al final de la fase y el montón estable en el registro principal al final de la compilación.
Etiquetas:affects_outputs
,bazel_monitoring
--memory_profile_stable_heap_parameters=<two integers, separated by a comma>
predeterminado: “1,0”-
Ajusta el cálculo del montón estable del perfil de memoria al final de la compilación. Deben ser dos números enteros separados por una coma. El primer parámetro es la cantidad de GC que se deben realizar. El segundo parámetro es la cantidad de segundos que se deben esperar entre las GC.
Etiquetas:bazel_monitoring
--profile=<a path>
predeterminado: Consulta la descripción-
Si se establece, se genera un perfil de Bazel y se escriben datos en el archivo especificado. Usa bazel analyze-profile para analizar el perfil.
Etiquetas:affects_outputs
,bazel_monitoring
--[no]slim_profile
predeterminado: "true"-
Reduce el tamaño del perfil JSON combinando eventos si el perfil se vuelve demasiado grande.
Etiquetas:affects_outputs
,bazel_monitoring
--starlark_cpu_profile=<a string>
predeterminado: ""-
Escribe en el archivo especificado un perfil pprof del uso de CPU de todos los subprocesos de Starlark.
Etiquetas:bazel_monitoring
--tool_tag=<a string>
predeterminado: ""-
Es un nombre de herramienta al que se atribuirá esta invocación de Bazel.
Etiquetas:affects_outputs
,bazel_monitoring
- Se acumulan varios usos de
--ui_event_filters=<Convert list of comma separated event kind to list of filters>
-
Especifica qué eventos se mostrarán en la IU. Es posible agregar o quitar eventos a los predeterminados con los signos +/- iniciales, o bien anular el conjunto predeterminado por completo con la asignación directa. El conjunto de tipos de eventos admitidos incluye INFO, DEBUG, ERROR y mucho más.
Etiquetas:terminal_output
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--build_metadata=<a 'name=value' assignment>
-
Son pares de cadenas clave-valor personalizados que se proporcionan en un evento de compilación.
Etiquetas:terminal_output
--color=<yes, no or auto>
predeterminado: “auto”- Usa los controles de la terminal para colorear el resultado.
- Se acumulan varios usos de
--config=<a string>
- Selecciona secciones de configuración adicionales de los archivos rc. Para cada <command>, también extrae las opciones de <command>:<config> si existe esa sección. Si esta sección no existe en ningún archivo .rc, Blaze falla con un error. Las secciones de configuración y las combinaciones de marcas a las que equivalen se encuentran en los archivos de configuración tools/*.blazerc.
--curses=<yes, no or auto>
predeterminado: “auto”- Usa los controles del cursor de la terminal para minimizar el resultado del desplazamiento.
--[no]enable_platform_specific_config
predeterminado: “false”- Si es verdadero, Bazel recupera líneas de configuración específicas del host y el SO de los archivos bazelrc. Por ejemplo, si el SO host es Linux y ejecutas bazel build, Bazel toma 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.
- Se acumulan varios usos de
--experimental_credential_helper=<An (unresolved) path to a credential helper for a scope.>
- Configura los auxiliares de credenciales que se usarán para recuperar credenciales para el alcance (dominio) proporcionado. Las credenciales de los asistentes de credenciales tienen prioridad sobre las credenciales de <code>--google_default_credentials</code>, `--google_credentials` o <code>.netrc</code>. Consulta https://github.com/bazelbuild/proposals/blob/main/designs/2022-06-07-bazel-credential-helpers.md para obtener más información.
--experimental_credential_helper_cache_duration=<An immutable length of time.>
predeterminado: “30m”- Configura la duración durante la cual se almacenan en caché las credenciales de los auxiliares de credenciales. Si lo invocas con un valor diferente, se ajustará la vida útil de las entradas preexistentes. Pasa cero para borrar la caché. Un comando clean siempre borra la caché, independientemente de esta marca.
--experimental_credential_helper_timeout=<An immutable length of time.>
predeterminado: "5s"- Configura el tiempo de espera del Asistente de credenciales. Si los auxiliares de credenciales no responden dentro de este tiempo de espera, la invocación fallará.
--[no]experimental_skymeld_ui
predeterminado: “false”-
Muestra el progreso de la fase de análisis y de ejecución cuando ambas se ejecutan de forma simultánea.
Etiquetas:terminal_output
--[no]experimental_windows_watchfs
predeterminado: “false”- Si es verdadero, se habilita la compatibilidad experimental de Windows con --watchfs. De lo contrario, --watchfs no es una opción en Windows. Asegúrate de habilitar también --watchfs.
--google_auth_scopes=<comma-separated list of options>
predeterminado: "https://www.googleapis.com/auth/cloud-platform"- Es una lista separada por comas de los permisos de autenticación de Google Cloud.
--google_credentials=<a string>
predeterminado: Consulta la descripción- Especifica el archivo del que se deben obtener las credenciales de autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más información.
--[no]google_default_credentials
predeterminado: “false”- Indica si se deben usar "Credenciales predeterminadas de la aplicación de Google" para la autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más información. Está inhabilitado de forma predeterminada.
--grpc_keepalive_time=<An immutable length of time.>
predeterminado: Consulta la descripción- Configura pings de keepalive para las conexiones de gRPC salientes. Si se establece, Bazel envía pings después de este tiempo sin operaciones de lectura en la conexión, pero solo si hay al menos una llamada gRPC pendiente. Los tiempos se tratan como nivel de detalle de segundo. Es un error establecer un valor inferior a un segundo. De forma predeterminada, los pings de mantenimiento de la conexión están inhabilitados. Debes coordinar con el propietario del servicio antes de habilitar este parámetro de configuración. Por ejemplo, para establecer un valor de 30 segundos en esta marca, se debe hacer de la siguiente manera: --grpc_keepalive_time=30s
--grpc_keepalive_timeout=<An immutable length of time.>
predeterminado: "20s"- Configura un tiempo de espera de keepalive para las conexiones gRPC salientes. Si los pings de mantenimiento están habilitados con --grpc_keepalive_time, Bazel agota el tiempo de espera de una conexión si no recibe una respuesta de ping después de este tiempo. Los tiempos se tratan como nivel de detalle de segundo. Es un error establecer un valor inferior a un segundo. Si los pings de mantenimiento de la conexión están inhabilitados, se ignora este parámetro de configuración.
--[no]incompatible_disallow_symlink_file_to_dir
predeterminado: "true"-
Si se establece como verdadero, "ctx.actions.symlink" no permitirá crear un symlink de un archivo en un directorio.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_rule_name_parameter
predeterminado: "true"-
Si se establece como verdadero, no se puede llamar a "rule" con el parámetro "name".
Etiquetas:loading_and_analysis
,incompatible_change
--[no]progress_in_terminal_title
predeterminado: “false”- Muestra el progreso del comando en el título de la terminal. Es útil para ver qué está haciendo bazel cuando tienes varias pestañas de la terminal.
--[no]show_progress
predeterminado: "true"- Muestra mensajes de progreso durante una compilación.
--show_progress_rate_limit=<a double>
predeterminado: “0.2”- Cantidad mínima de segundos entre los mensajes de progreso en la salida.
--[no]show_timestamps
predeterminado: “false”- Incluye marcas de tiempo en los mensajes
--tls_certificate=<a string>
predeterminado: Consulta la descripción- Especifica una ruta de acceso a un certificado TLS de confianza para firmar certificados de servidor.
--tls_client_certificate=<a string>
predeterminado: Consulta la descripción- Especifica el certificado de cliente TLS que se usará. También debes proporcionar una clave de cliente para habilitar la autenticación del cliente.
--tls_client_key=<a string>
predeterminado: Consulta la descripción- Especifica la clave de cliente TLS que se usará. También debes proporcionar un certificado de cliente para habilitar la autenticación del cliente.
--ui_actions_shown=<an integer>
predeterminado: “8”-
Cantidad de acciones simultáneas que se muestran en la barra de progreso detallada. Cada acción se muestra en una línea independiente. La barra de progreso siempre muestra al menos un uno, y todos los números inferiores a 1 se asignan a 1.
Etiquetas:terminal_output
--[no]watchfs
predeterminado: “false”- En Linux o macOS: Si es verdadero, bazel intenta usar el servicio de supervisión de archivos del sistema operativo para los cambios locales en lugar de analizar cada archivo en busca de cambios. En Windows, esta marca actualmente no está disponible, pero se puede habilitar junto con --experimental_windows_watchfs. En cualquier SO: El comportamiento no se define si tu espacio de trabajo está en un sistema de archivos de red y los archivos se editan en una máquina remota.
Opciones de Analyze-profile
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
-
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
predeterminado: “false”-
Si es verdadero, usa una cadena derivada de las URLs de las descargas del repositorio como canonical_id si no se especifica. Esto hace que un cambio en las URLs genere una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no hagan que la caché oculte los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
predeterminado: “false”-
Si se establece, no se permite descargar repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, los repositorios externos pueden funcionar en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que afectan la rigurosidad con la que Bazel aplica entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
--experimental_repository_hash_file=<a string>
predeterminado: ""-
Si no está vacío, especifica un archivo que contiene un valor resuelto, con el que se deben verificar los valores hash del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan varios usos de
--experimental_verify_repository_rules=<a string>
. -
Si es una lista de reglas de repositorio para las que se debe verificar el hash del directorio de salida, siempre que se especifique un archivo con --experimental_repository_hash_file.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: "true"-
Etiquetas
sin operación:no_op
,deprecated
,experimental
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
-
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitados en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "advertencia" -
Verifica si las dependencias directas de "bazel_dep" declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivarla a un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
- Anula un módulo con un directorio local.
- Se acumulan varios usos de
--registry=<a string>
-
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--dump=<text or raw>
[-d
] predeterminado: Consulta la descripción- muestra un volcado completo de datos de perfil, ya sea en formato "text" legible por humanos o en formato "sin procesar" compatible con secuencias de comandos.
Etiquetas:affects_outputs
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
- Opciones que especifican o alteran una entrada genérica en un comando de Bazel que no se incluye en otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de almacenamiento en caché y ejecución remotas:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
- Anula un repositorio con un directorio local.
Opciones de Aquery
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
-
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
predeterminado: “false”-
Si es verdadero, usa una cadena derivada de las URLs de las descargas del repositorio como canonical_id si no se especifica. Esto hace que un cambio en las URLs genere una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no provoquen que la caché oculte los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
predeterminado: “false”-
Si se establece, no se permite descargar repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, los repositorios externos pueden funcionar en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que afectan la rigurosidad con la que Bazel aplica entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etc.):
--experimental_repository_hash_file=<a string>
predeterminado: ""-
Si no está vacío, especifica un archivo que contiene un valor resuelto, con el que se deben verificar los valores hash del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan varios usos de
--experimental_verify_repository_rules=<a string>
-
Si es una lista de reglas de repositorio para las que se debe verificar el hash del directorio de salida, siempre que se especifique un archivo con --experimental_repository_hash_file.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: "true"-
Etiquetas
sin operación:no_op
,deprecated
,experimental
- Opciones relacionadas con el resultado de la consulta y la semántica:
--aspect_deps=<off, conservative or precise>
predeterminado: "conservative"-
Cómo resolver las dependencias de aspecto cuando el formato de salida es uno de {xml,proto,record}. "Desactivado" significa que no se resuelven las dependencias de aspecto. "Conservador" (la opción predeterminada) significa que se agregan todas las dependencias de aspecto declaradas, independientemente de si se les asigna la clase de regla de dependencias directas. "Preciso" significa que solo se agregan los aspectos que pueden estar activos según la clase de regla de las dependencias directas. Ten en cuenta que el modo preciso requiere la carga de otros paquetes para evaluar un solo objetivo, lo que lo hace más lento que los otros modos. Además, ten en cuenta que incluso el modo preciso no es del todo preciso: la decisión de calcular un aspecto se toma en la fase de análisis, que no se ejecuta durante la "consulta de bazel".
Etiquetas:build_file_semantics
--[no]deduplicate_depsets
predeterminado: "true"-
Quita los duplicados de elementos secundarios no hoja de un dep_set_of_files en el resultado final de proto/textproto/json. Esto no anula el duplicado de los conjuntos de dependencias que no comparten un elemento superior inmediato. Esto no afecta la lista final efectiva de artefactos de entrada de las acciones.
Etiquetas:terminal_output
--[no]graph:factored
predeterminado: "true"-
Si es verdadero, el gráfico se emitirá "factorizado", es decir, los nodos topológicamente equivalentes se combinarán y sus etiquetas se concatenarán. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--graph:node_limit=<an integer>
predeterminado: “512”-
Es la longitud máxima de la cadena de etiqueta para un nodo de grafo en el resultado. Las etiquetas más largas se truncarán. -1 significa que no se truncará. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--[no]implicit_deps
predeterminado: "true"-
Si está habilitada, se incluirán dependencias implícitas en el gráfico de dependencias sobre el que opera la consulta. Una dependencia implícita es aquella que no se especifica explícitamente en el archivo BUILD, pero que Bazel agrega. En el caso de cquery, esta opción controla el filtrado de cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
--[no]include_artifacts
predeterminado: "true"-
Incluye los nombres de las entradas y salidas de la acción en el resultado (potencialmente grande).
Etiquetas:terminal_output
--[no]include_aspects
predeterminado: "true"-
aquery, cquery: Indica si se deben incluir acciones generadas por aspectos en el resultado. query: No-op (siempre se siguen los aspectos).
Etiquetas:terminal_output
--[no]include_commandline
predeterminado: "true"-
Incluye el contenido de las líneas de comandos de acción en el resultado (potencialmente grande).
Etiquetas:terminal_output
--[no]include_file_write_contents
predeterminado: “false”-
Incluye el contenido del archivo para las acciones FileWrite y SourceSymlinkManifest (potencialmente grandes).
Etiquetas:terminal_output
--[no]include_param_files
predeterminado: “false”-
Incluye el contenido de los archivos de parámetros que se usan en el comando (potencialmente grande). Nota: Si habilitas esta marca, se habilitará automáticamente la marca --include_commandline.
Etiquetas:terminal_output
--[no]incompatible_display_source_file_location
predeterminado: "true"-
Es verdadero de forma predeterminada y muestra el destino del archivo fuente. Si es verdadero, muestra la ubicación de la línea 1 de los archivos de origen en los resultados de ubicación. Esta marca solo existe para la migración.
Etiquetas:terminal_output
,incompatible_change
--[no]incompatible_package_group_includes_double_slash
predeterminado: "true"-
Si está habilitada, cuando se genere el atributo "packages" de package_group, no se omitirá el "//" inicial.
Etiquetas:terminal_output
,incompatible_change
--[no]infer_universe_scope
predeterminado: “false”-
Si se establece y no se establece --universe_scope, se inferirá un valor de --universe_scope como la lista de patrones de destino únicos en la expresión de consulta. Ten en cuenta que el valor de --universe_scope inferido para una expresión de consulta que usa funciones centradas en el universo (p.ej., "allrdeps") puede no ser lo que deseas, por lo que debes usar esta opción solo si sabes lo que estás haciendo. Consulta https://bazel.build/query/language#sky-query para obtener detalles y ejemplos. Si se establece --universe_scope, se ignora el valor de esta opción. Nota: Esta opción solo se aplica a "query" (es decir, no a "cquery").
Etiquetas:loading_and_analysis
--[no]line_terminator_null
predeterminado: “false”-
Indica si cada formato finaliza con \0 en lugar de una línea nueva.
Etiquetas:terminal_output
--[no]nodep_deps
predeterminado: "true"-
Si está habilitada, las dependencias de los atributos "nodep" se incluirán en el gráfico de dependencias sobre el que opera la consulta. Un ejemplo común de un atributo "nodep" es "visibility". Ejecuta y analiza el resultado de "info build-language" para obtener información sobre todos los atributos "nodep" en el lenguaje de compilación.
Etiquetas:build_file_semantics
--output=<a string>
predeterminado: “text”-
Es el formato en el que se deben imprimir los resultados de la consulta. Los valores permitidos para aquery son: text, textproto, proto y jsonproto.
Etiquetas:terminal_output
--[no]proto:default_values
predeterminado: "true"-
Si es verdadero, se incluyen los atributos cuyo valor no se especifica de forma explícita en el archivo BUILD; de lo contrario, se omiten. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
--[no]proto:definition_stack
predeterminado: “false”-
Propaga el campo proto definition_stack, que registra para cada instancia de regla la pila de llamadas de Starlark en el momento en que se definió la clase de la regla.
Etiquetas:terminal_output
--[no]proto:flatten_selects
predeterminado: "true"-
Si está habilitada, los atributos configurables creados por select() se aplanan. En el caso de los tipos de lista, la representación aplanada es una lista que contiene cada valor del mapa de selección exactamente una vez. Los tipos escalares se aplanan a nulos.
Etiquetas:build_file_semantics
--[no]proto:include_synthetic_attribute_hash
predeterminado: “false”-
Indica si se debe calcular y propagar el atributo $internal_attr_hash.
Etiquetas:terminal_output
--[no]proto:instantiation_stack
predeterminado: “false”-
Propaga la pila de llamadas de creación de instancias de cada regla. Ten en cuenta que esto requiere que la pila esté presente.
Etiquetas:terminal_output
--[no]proto:locations
predeterminado: "true"-
Indica si se debe generar información de ubicación en el resultado de proto.
Etiquetas:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
predeterminado: “all”-
Es una lista de atributos separados por comas que se deben incluir en el resultado. La configuración predeterminada es todos los atributos. Establece una cadena vacía para no mostrar ningún atributo. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
--[no]proto:rule_inputs_and_outputs
predeterminado: "true"-
Indica si se propagan o no los campos rule_input y rule_output.
Etiquetas:terminal_output
--[no]relative_locations
predeterminado: “false”-
Si es verdadero, la ubicación de los archivos BUILD en los resultados de xml y proto será relativa. De forma predeterminada, el resultado de la ubicación es una ruta de acceso absoluta y no será coherente en todas las máquinas. Puedes establecer esta opción en verdadero para obtener un resultado coherente en todas las máquinas.
Etiquetas:terminal_output
--[no]skyframe_state
predeterminado: “false”-
Sin realizar un análisis adicional, volca el grafo de acciones actual de Skyframe. Nota: Por el momento, no se admite especificar un destino con --skyframe_state. Esta marca solo está disponible con --output=proto o --output=textproto.
Etiquetas:terminal_output
--[no]tool_deps
predeterminado: "true"-
Consulta: Si se inhabilita, las dependencias de los destinos de "configuración del host" o "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 del host", como el de cualquier regla "proto_library" al compilador de protocolos, suele apuntar a una herramienta que se ejecuta durante la compilación en lugar de a una parte del mismo programa "objetivo".
Cquery: Si se inhabilita, filtra todos los objetivos configurados que cruzan un host o una transición de ejecución desde el objetivo de nivel superior que descubrió este objetivo configurado. Esto significa que, si el objetivo de nivel superior está en la configuración de destino, solo se mostrarán los objetivos configurados también en la configuración de destino. Si el destino de nivel superior está en la configuración del host, solo se mostrarán los destinos configurados por el host. Esta opción NO excluirá las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
--universe_scope=<comma-separated list of options>
predeterminado: ""-
Es un conjunto de patrones de destino (aditivos y sustractivos) separados por comas. La consulta se puede realizar en el universo definido por el cierre transitivo de los destinos especificados. Esta opción se usa para los comandos query y cquery.
En el caso de cquery, la entrada de esta opción son los objetivos en los que se compilan todas las respuestas, por lo que esta opción puede afectar las configuraciones y las transiciones. Si no se especifica esta opción, se supone que los destinos de nivel superior son los que se analizaron de la expresión de consulta. Nota: En el caso de cquery, si no se especifica esta opción, es posible que la compilación falle si los destinos analizados de la expresión de consulta no se pueden compilar con opciones de nivel superior.
Etiquetas:loading_and_analysis
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
-
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitados en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: “error”-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "advertencia" -
Verifica si las dependencias directas de "bazel_dep" declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivarla a un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
. - Anula un módulo con un directorio local.
- Se acumulan varios usos de
--registry=<a string>
-
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
- Opciones que especifican o alteran una entrada genérica en un comando de Bazel que no se incluye en otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
- Anula un repositorio con un directorio local.
- Opciones que controlan la ejecución de la compilación:
--[no]experimental_inprocess_symlink_creation
predeterminado: “false”-
Determina si se deben realizar llamadas directas al sistema de archivos para crear árboles de symlinks.
Etiquetas:loading_and_analysis
,execution
,experimental
--[no]experimental_remotable_source_manifests
predeterminado: “false”-
Determina si las acciones del manifiesto de origen se pueden controlar de forma remota.
Etiquetas:loading_and_analysis
,execution
,experimental
--[no]experimental_split_coverage_postprocessing
predeterminado: “false”-
Si es verdadero, Bazel ejecutará el procesamiento posterior de la cobertura para la prueba en un nuevo inicio.
Etiquetas:execution
--[no]experimental_strict_fileset_output
predeterminado: “false”-
Si esta opción está habilitada, los conjuntos de archivos tratarán todos los artefactos de salida como archivos normales. No recorrerán directorios ni serán sensibles a los symlinks.
Etiquetas:execution
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
predeterminado: ""-
Agrega o quita claves de la información de ejecución de una acción según la mnemotecnia de la acción. Solo se aplica a las acciones que admiten información de ejecución. Muchas acciones comunes admiten información de ejecución, p.ej., Genrule, CppCompile, Javac, StarlarkAction y TestRunner. Cuando especificas varios valores, el orden es importante porque muchas regex pueden aplicarse al mismo mnemónico.
Sintaxis: "regex=[+-]clave,regex=[+-]clave,...".
Ejemplos:
'.*=+x,.*=-y,.*=+z' agrega "x" y "z" a la información de ejecución de todas las acciones y quita "y".
"Genrule=+requires-x" agrega "requires-x" a la información de ejecución de todas las acciones de Genrule.
"(?!Genrule).*=-requires-x" quita "requires-x" de la información de ejecución para todas las acciones que no sean de Genrule.
Etiquetas:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Habilita las acciones de expansión de sintaxis y dex persistentes de Android con trabajadores.
Se expande a:
--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
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_dex_desugar
-
Habilita las acciones de desugar y dex multiplexadas y persistentes de Android con trabajadores.
Se expande a:
--persistent_android_dex_desugar
--modify_execution_info=Desugar=+supports-multiplex-workers
--modify_execution_info=DexBuilder=+supports-multiplex-workers
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
Habilita el procesador de recursos de Android multiplexado persistente con trabajadores.
Se expande a:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_tools
-
Habilita las herramientas de Android persistentes y multiplexadas (dexing, expansión de sintaxis, procesamiento de recursos).
Se expande a:
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Etiquetas:host_machine_resource_optimizations
,execution
- Opciones que configuran la cadena de herramientas que se usa para la ejecución de acciones:
--android_compiler=<a string>
predeterminado: Consulta la descripción-
El compilador de destino de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_crosstool_top=<a build target label>
predeterminado: "//external:android/crosstool"-
Es la ubicación del compilador de C++ que se usa para las compilaciones de Android.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_grte_top=<a label>
predeterminado: Consulta la descripción-
El objetivo de Android grte_top.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
predeterminado: "android"-
Selecciona el combinador de manifiestos que se usará para las reglas android_binary. Marca para ayudar a la transición a la combinación de manifiestos de Android desde la combinación heredada.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_platforms=<a build target label>
predeterminado: ""-
Establece las plataformas que usan los destinos de android_binary. Si se especifican varias plataformas, el objeto binario es un APK grueso, que contiene objetos binarios nativos para cada plataforma de destino especificada.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_sdk=<a build target label>
predeterminado: "@bazel_tools//tools/android:sdk"-
Especifica el SDK o la plataforma de Android que se usa para compilar aplicaciones para Android.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--apple_compiler=<a string>
predeterminado: Consulta la descripción-
El compilador de destino de Apple. Es útil para seleccionar variantes de una cadena de herramientas (p.ej., xcode-beta).
Etiquetas:affects_outputs
,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
--apple_grte_top=<a build target label>
predeterminado: Consulta la descripción-
El objetivo de Apple grte_top.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--cc_output_directory_tag=<a string>
predeterminado: ""-
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas:affects_outputs
,explicit_in_output_path
--compiler=<a string>
predeterminado: Consulta la descripción-
Es el compilador de C++ que se usará para compilar el destino.
Etiquetas:loading_and_analysis
,execution
--coverage_output_generator=<a build target label>
predeterminado: "@bazel_tools//tools/test:lcov_merger"-
Ubicación del binario que se usa para postprocesar informes de cobertura sin procesar. Actualmente, debe ser un grupo de archivos que contenga un solo archivo, el binario. El valor predeterminado es “//tools/test:lcov_merger”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
predeterminado: "@bazel_tools//tools/test:coverage_report_generator"-
Ubicación del binario que se usa para generar informes de cobertura. Actualmente, debe ser un grupo de archivos que contenga un solo archivo, el binario. El valor predeterminado es "//tools/test:coverage_report_generator".
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
predeterminado: "@bazel_tools//tools/test:coverage_support"-
Ubicación de los archivos de compatibilidad que se requieren en las entradas de cada acción de prueba que recopila la cobertura de código. El valor predeterminado es “//tools/test:coverage_support”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--crosstool_top=<a build target label>
predeterminado: "@bazel_tools//tools/cpp:toolchain"-
Es la etiqueta del paquete de herramientas cruzadas que se usará para compilar código C++.
Etiquetas:loading_and_analysis
,changes_inputs
,affects_outputs
--custom_malloc=<a build target label>
predeterminado: Consulta la descripción- especifica una implementación personalizada de malloc. Este parámetro de configuración anula los atributos malloc en las reglas de compilación.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan varios usos de
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
-
Es una lista de expresiones regulares separadas por comas, cada una con el prefijo - (expresión negativa) de forma opcional, asignada (=) a una lista de objetivos de valores de restricción separados por comas. Si un objetivo no coincide con ninguna expresión negativa y con al menos una expresión positiva, la resolución de la cadena de herramientas se realizará como si hubiera declarado los valores de restricción como restricciones de ejecución. Ejemplo: //demo,-test=@platforms//cpus:x86_64 agregará "x86_64" a cualquier destino de //demo, excepto a aquellos cuyo nombre contenga "test".
Etiquetas:loading_and_analysis
--[no]experimental_enable_objc_cc_deps
predeterminado: "true"- Permite que las reglas objc_* dependan de cc_library y hace que todas las dependencias de objc se compilen con --cpu establecido en "ios_<--ios_cpu>" para cualquier valor en --ios_multi_cpu.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]experimental_include_xcode_execution_requirements
predeterminado: “false”-
Si se establece, agrega un requisito de ejecución "requires-xcode:{version}" a cada acción de Xcode. Si la versión de Xcode tiene una etiqueta con guiones, también agrega un requisito de ejecución "requires-xcode-label:{version_label}".
Etiquetas:loses_incremental_state
,loading_and_analysis
,execution
--[no]experimental_prefer_mutual_xcode
predeterminado: "true"-
Si es verdadero, usa la versión más reciente de Xcode que esté disponible de forma local y remota. Si es falso o si no hay versiones mutuas disponibles, usa la versión local de Xcode seleccionada a través de xcode-select.
Etiquetas:loses_incremental_state
- Se acumulan varios usos de
--extra_execution_platforms=<comma-separated list of options>
-
Son las plataformas disponibles como plataformas de ejecución para ejecutar acciones. Las plataformas se pueden especificar por destino exacto o como un patrón de destino. Estas plataformas se considerarán antes de las declaradas en el archivo WORKSPACE por register_execution_platforms().
Etiquetas:execution
- Se acumulan varios usos de
--extra_toolchains=<comma-separated list of options>
. -
Son las reglas de la cadena de herramientas que se deben tener en cuenta durante la resolución de la cadena de herramientas. Las cadenas de herramientas se pueden especificar por destino exacto o como un patrón de destino. Estas cadenas de herramientas se considerarán antes que las declaradas en el archivo WORKSPACE por register_toolchains().
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--grte_top=<a label>
predeterminado: Consulta la descripción-
Es una etiqueta para una biblioteca libc verificada. La cadena de herramientas de crosstool selecciona el valor predeterminado, y casi nunca es necesario anularlo.
Etiquetas:action_command_lines
,affects_outputs
--host_compiler=<a string>
predeterminado: Consulta la descripción-
Es el compilador de C++ que se usará para la compilación del host. Se ignora si no se establece --host_crosstool_top.
Etiquetas:loading_and_analysis
,execution
--host_crosstool_top=<a build target label>
predeterminado: Consulta la descripción-
De forma predeterminada, las opciones --crosstool_top y --compiler también se usan para la configuración del host. Si se proporciona esta marca, Bazel usa la libc y el compilador predeterminados para el crosstool_top determinado.
Etiquetas:loading_and_analysis
,changes_inputs
,affects_outputs
--host_grte_top=<a label>
predeterminado: Consulta la descripción-
Si se especifica, este parámetro de configuración anula el directorio de nivel superior de libc (--grte_top) para la configuración del host.
Etiquetas:action_command_lines
,affects_outputs
--host_platform=<a build target label>
predeterminado: ""-
La etiqueta de una regla de plataforma que describe el sistema host.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--[no]incompatible_disable_expand_if_all_available_in_flag_set
predeterminado: "true"-
Si es verdadero, Bazel no permitirá especificar expand_if_all_available en flag_sets(consulta https://github.com/bazelbuild/bazel/issues/7008 para obtener instrucciones de migración).
Etiquetas:loading_and_analysis
,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_android_toolchain_resolution
predeterminado: “false”-
Usa la resolución de cadena de herramientas para seleccionar el SDK de Android para las reglas de Android (Starlark y nativo)
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_apple_toolchain_resolution
predeterminado: “false”-
Usa la resolución de cadena de herramientas para seleccionar el SDK de Apple para las reglas de Apple (Starlark y nativo)
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone
predeterminado: "true"-
Si es verdadero, Bazel no reutilizará las líneas de comandos de la acción de vinculación de C++ para las líneas de comandos de indexación de lto (consulta https://github.com/bazelbuild/bazel/issues/6791 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain
predeterminado: "true"-
Si es verdadero, Bazel se quejará cuando se establezcan los atributos cc_toolchain.cpu y cc_toolchain.compiler (consulta https://github.com/bazelbuild/bazel/issues/7075 para obtener instrucciones de migración).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_legacy_whole_archive
predeterminado: "true"-
Si es verdadero, Bazel no vinculará las dependencias de la biblioteca como un archivo completo de forma predeterminada (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener instrucciones de migración).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_require_ctx_in_configure_features
predeterminado: "true"-
Si es verdadero, Bazel requerirá el parámetro "ctx" en cc_common.configure_features (consulta https://github.com/bazelbuild/bazel/issues/7793 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
-
Usa objetos compartidos de interfaz si la cadena de herramientas es compatible. Actualmente, todas las cadenas de herramientas ELF admiten este parámetro de configuración.
Etiquetas:loading_and_analysis
,affects_outputs
,affects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Especifica la versión del SDK de iOS que se usará para compilar aplicaciones para iOS. Si no se especifica, usa la versión predeterminada del SDK de iOS de "xcode_version".
Etiquetas:loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Especifica la versión del SDK de macOS que se usará para compilar aplicaciones para macOS. Si no se especifica, usa la versión predeterminada del SDK de macOS de "xcode_version".
Etiquetas:loses_incremental_state
--minimum_os_version=<a string>
predeterminado: Consulta la descripción-
Es la versión mínima del SO a la que se orienta tu compilación.
Etiquetas:loading_and_analysis
,affects_outputs
--platform_mappings=<a relative path>
predeterminado: ""-
Es la ubicación de un archivo de asignación que describe qué plataforma usar si no se establece ninguna o qué marcas establecer cuando ya existe una plataforma. Debe ser relativo a la raíz del espacio de trabajo principal. El valor predeterminado es "platform_mappings" (un archivo directamente debajo de la raíz del espacio de trabajo).
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--platforms=<a build target label>
predeterminado: ""-
Son las etiquetas de las reglas de la plataforma que describen las plataformas de destino del comando actual.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--python2_path=<a string>
predeterminado: Consulta la descripción-
Obsoleto, no realiza ninguna acción. Se inhabilitó con `--incompatible_use_python_toolchains`.
Etiquetas:no_op
,deprecated
--python3_path=<a string>
predeterminado: Consulta la descripción-
Obsoleto, no realiza ninguna acción. Se inhabilitó con `--incompatible_use_python_toolchains`.
Etiquetas:no_op
,deprecated
--python_path=<a string>
predeterminado: Consulta la descripción-
Es la ruta de acceso absoluta del intérprete de Python que se invocó para ejecutar destinos de Python en la plataforma de destino. Obsoleto; se inhabilitó con --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
--python_top=<a build target label>
predeterminado: Consulta la descripción-
La etiqueta de un py_runtime que representa el intérprete de Python invocado para ejecutar destinos de Python en la plataforma de destino. Obsoleto; se inhabilitó con --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
--target_platform_fallback=<a build target label>
predeterminado: "@local_config_platform//:host"-
Es la etiqueta de una regla de plataforma que se debe usar si no se establece una plataforma de destino y si no hay ninguna asignación de plataforma que coincida con el conjunto actual de marcas.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Especifica la versión del SDK de tvOS que se usará para compilar aplicaciones para tvOS. Si no se especifica, se usa la versión predeterminada del SDK de tvOS de "xcode_version".
Etiquetas:loses_incremental_state
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Especifica la versión del SDK de watchOS que se usará para compilar aplicaciones para watchOS. Si no se especifica, usa la versión predeterminada del SDK de watchOS de "xcode_version".
Etiquetas:loses_incremental_state
--xcode_version=<a string>
predeterminado: Consulta la descripción-
Si se especifica, usa Xcode de la versión determinada para las acciones de compilación relevantes. Si no se especifica, se usa la versión predeterminada del ejecutor de Xcode.
Etiquetas:loses_incremental_state
--xcode_version_config=<a build target label>
predeterminado: "@bazel_tools//tools/cpp:host_xcodes"-
Es la etiqueta de la regla xcode_config que se usará para seleccionar la versión de Xcode en la configuración de compilación.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Opciones que controlan el resultado del comando:
--[no]apple_enable_auto_dsym_dbg
predeterminado: “false”-
Indica si se debe forzar la generación de archivos de símbolos de depuración (.dSYM) para las compilaciones de dbg.
Etiquetas:affects_outputs
,action_command_lines
--[no]apple_generate_dsym
predeterminado: “false”-
Indica si se deben generar archivos de símbolos de depuración (.dSYM).
Etiquetas:affects_outputs
,action_command_lines
--[no]build_runfile_links
predeterminado: "true"-
Si es verdadero, compila bosques de symlinks de runfiles para todos los destinos. Si es falso, escribe solo manifiestos cuando sea posible.
Etiquetas:affects_outputs
--[no]build_runfile_manifests
predeterminado: "true"-
Si es verdadero, escribe manifiestos de runfiles para todos los destinos. Si es falso, omítelos. Las pruebas locales no se ejecutarán si es falso.
Etiquetas:affects_outputs
--[no]build_test_dwp
predeterminado: “false”-
Si está habilitado, cuando se compilen pruebas de C++ de forma estática y con Fission, el archivo .dwp para el objeto binario de prueba también se compilará automáticamente.
Etiquetas:loading_and_analysis
,affects_outputs
--cc_proto_library_header_suffixes=<comma-separated list of options>
predeterminado: “.pb.h”-
Establece los prefijos de los archivos de encabezado que crea una cc_proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated list of options>
predeterminado: “.pb.cc”-
Configura los prefijos de los archivos de origen que crea una cc_proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info
predeterminado: “false”-
Ejecuta acciones adicionales para versiones alternativas de la API de Java en una proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_proto_extra_actions
predeterminado: “false”-
Ejecuta acciones adicionales para versiones alternativas de la API de Java en una proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_save_feature_state
predeterminado: “false”-
Guarda el estado de las funciones habilitadas y solicitadas como un resultado de la compilación.
Etiquetas:affects_outputs
,experimental
--fission=<a set of compilation modes>
predeterminado: “no”-
Especifica qué modos de compilación usan la fisión para las compilaciones y los vínculos de C++. Puede ser cualquier combinación de {'fastbuild', 'dbg', 'opt'} o los valores especiales "yes" para habilitar todos los modos y "no" para inhabilitarlos.
Etiquetas:loading_and_analysis
,action_command_lines
,affects_outputs
--[no]incompatible_always_include_files_in_data
predeterminado: "true"-
Si es verdadero, las reglas nativas agregan <code>DefaultInfo.files</code> de dependencias de datos a sus archivos de ejecución, lo que coincide con el comportamiento recomendado para las reglas de Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid).
Etiquetas:affects_outputs
,incompatible_change
--[no]legacy_external_runfiles
predeterminado: "true"-
Si es verdadero, compila bosques de symlinks de runfiles para repositorios externos en .runfiles/wsname/external/repo (además de .runfiles/repo).
Etiquetas:affects_outputs
--[no]objc_generate_linkmap
predeterminado: “false”- especifica si se debe generar un archivo de mapa de vínculos.
Etiquetas:affects_outputs
--[no]save_temps
predeterminado: “false”-
Si se establece, se guardarán los resultados temporales de gcc. Estos incluyen archivos .s (código de ensamblador), archivos .i (C procesado) y archivos .ii (C++ procesado).
Etiquetas:affects_outputs
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
- Se acumulan varios usos de
--action_env=<a 'name=value' assignment with an optional value part>
-
Especifica el conjunto de variables de entorno disponibles para las acciones con configuración de destino. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o bien por el par nombre=valor, que establece el valor independientemente del entorno de invocación. Esta opción se puede usar varias veces. En el caso de las opciones que se proporcionan para la misma variable, se aplica la más reciente, y se acumulan las opciones para diferentes variables.
Etiquetas:action_command_lines
--android_cpu=<a string>
predeterminado: "armeabi-v7a"-
La CPU objetivo de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]android_databinding_use_androidx
predeterminado: “false”-
Genera archivos de vinculación de datos compatibles con AndroidX. Esto solo se usa con la vinculación de datos v2.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]android_databinding_use_v3_4_args
predeterminado: “false”-
Usa Android Databinding v2 con el argumento 3.4.0.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--android_dynamic_mode=<off, default or fully>
predeterminado: "off"- determina si las dependencias de C++ de las reglas de Android se vincularán de forma dinámica cuando un cc_binary no cree una biblioteca compartida de forma explícita. "default" significa que bazel elegirá si vincular de forma dinámica. "Completamente" significa que todas las bibliotecas se vincularán de forma dinámica. "Desactivado" significa que todas las bibliotecas se vincularán en modo principalmente estático.
Etiquetas:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
predeterminado: "alphabetical"-
Establece el orden de los manifiestos que se pasan a la combinación de manifiestos para los objetos binarios de Android. ALPHABETICAL significa que los manifiestos se ordenan por ruta de acceso en relación con el execroot. ALPHABETICAL_BY_CONFIGURATION significa que los manifiestos se ordenan por rutas de acceso relativas al directorio de configuración dentro del directorio de salida. DEPENDENCY significa que los manifiestos se ordenan de modo que el manifiesto de cada biblioteca aparezca antes que los manifiestos de sus dependencias.
Etiquetas:action_command_lines
,execution
--[no]android_resource_shrinking
predeterminado: “false”-
Habilita la reducción de recursos para los APKs de android_binary que usan ProGuard.
Etiquetas:affects_outputs
,loading_and_analysis
- Se acumulan varios usos de
--apple_bitcode=<'mode' or 'platform=mode', where 'mode' is none, embedded_markers or embedded, and 'platform' is ios, watchos, tvos, macos or catalyst>
-
Especifica el modo de código de bits de Apple para los pasos de compilación orientados a arquitecturas de dispositivos. Los valores tienen el formato "[platform=]mode", donde la plataforma (que debe ser "ios", "macos", "tvos" o "watchos") es opcional. Si se proporciona, el modo de código de bytes se aplica específicamente para esa plataforma. Si se omite, se aplica para todas las plataformas. El modo debe ser "none", "embedded_markers" o "embedded". Esta opción se puede proporcionar varias veces.
Etiquetas:loses_incremental_state
--[no]build_python_zip
predeterminado: “auto”-
Compila el archivo ZIP ejecutable de Python; activado en Windows, desactivado en otras plataformas.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--catalyst_cpus=<comma-separated list of options>
-
Es una lista de arquitecturas separadas por comas para las que se compilarán los objetos binarios de Apple Catalyst.
Etiquetas:loses_incremental_state
,loading_and_analysis
--[no]collect_code_coverage
predeterminado: “false”-
Si se especifica, Bazel instrumentará el código (con instrumentación sin conexión siempre que sea posible) y recopilará información de cobertura durante las pruebas. Solo se verán afectados los destinos que coincidan con --instrumentation_filter. Por lo general, esta opción no debe especificarse directamente, sino que se debe usar el comando "bazel coverage".
Etiquetas:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] predeterminado: "fastbuild"-
Especifica el modo en el que se compilará el objeto binario. Valores: "fastbuild", "dbg", "opt".
Etiquetas:affects_outputs
,action_command_lines
,explicit_in_output_path
- Se acumulan varios usos de
--conlyopt=<a string>
-
Opción adicional para pasar a gcc cuando se compilan archivos de origen C.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--copt=<a string>
- Opciones adicionales para pasar a gcc.
Etiquetas:action_command_lines
,affects_outputs
--cpu=<a string>
predeterminado: ""-
La CPU objetivo.
Etiquetas:changes_inputs
,affects_outputs
,explicit_in_output_path
--cs_fdo_absolute_path=<a string>
predeterminado: Consulta la descripción-
Usa la información del perfil de CSFDO para optimizar la compilación. Especifica el nombre de la ruta de acceso absoluta del archivo ZIP que contiene el archivo de perfil, un archivo de perfil LLVM sin procesar o indexado.
Etiquetas:affects_outputs
--cs_fdo_instrument=<a string>
predeterminado: Consulta la descripción-
Genera ejecutables con instrumentación de FDO sensible al contexto. Con el compilador Clang/LLVM, también acepta el nombre del directorio en el que se volcarán los archivos de perfil sin procesar durante el tiempo de ejecución.
Etiquetas:affects_outputs
--cs_fdo_profile=<a build target label>
predeterminado: Consulta la descripción-
El cs_fdo_profile que representa el perfil sensible al contexto que se usará para la optimización.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--cxxopt=<a string>
-
Opción adicional para pasar a gcc cuando se compilan archivos de origen C++.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--define=<a 'name=value' assignment>
-
Cada opción --define especifica una asignación para una variable de compilación.
Etiquetas:changes_inputs
,affects_outputs
--dynamic_mode=<off, default or fully>
predeterminado: "predeterminado"- determina si los objetos binarios de C++ se vincularán de forma dinámica. "default" significa que Bazel elegirá si vincular de forma dinámica. "Completamente" significa que todas las bibliotecas se vincularán de forma dinámica. "Desactivado" significa que todas las bibliotecas se vincularán en modo principalmente estático.
Etiquetas:loading_and_analysis
,affects_outputs
--[no]enable_fdo_profile_absolute_path
predeterminado: "true"-
Si se establece, el uso de fdo_absolute_profile_path generará un error.
Etiquetas:affects_outputs
--[no]enable_runfiles
predeterminado: “auto”-
Habilita el árbol de symlinks de runfiles. De forma predeterminada, está desactivado en Windows y en otras plataformas.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--experimental_action_listener=<a build target label>
- dejó de estar disponible y se reemplazó por aspectos. Usa action_listener para adjuntar un extra_action a las acciones de compilación existentes.
Etiquetas:execution
,experimental
--[no]experimental_android_compress_java_resources
predeterminado: “false”-
Comprime recursos de Java en APKs
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_android_databinding_v2
predeterminado: “false”-
Usa Android Databinding v2
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_android_resource_shrinking
predeterminado: “false”-
Habilita la reducción de recursos para los APKs de android_binary que usan ProGuard.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_android_rewrite_dexes_with_rex
predeterminado: “false”-
Usa la herramienta rex para volver a escribir archivos dex.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--experimental_objc_fastbuild_options=<comma-separated list of options>
predeterminado: "-O0,-DDEBUG=1"-
Usa estas cadenas como opciones del compilador de objc fastbuild.
Etiquetas:action_command_lines
--[no]experimental_omitfp
predeterminado: “false”-
Si es verdadero, usa libunwind para el desenredo de pila y compila con -fomit-frame-pointer y -fasynchronous-unwind-tables.
Etiquetas:action_command_lines
,affects_outputs
,experimental
--[no]experimental_platform_in_output_dir
predeterminado: “false”-
Si es verdadero, la plataforma de destino se usa en el nombre del directorio de salida en lugar de la CPU.
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
--fat_apk_cpu=<comma-separated list of options>
predeterminado: "armeabi-v7a"-
Si configuras esta opción, se habilitan los APKs multiarquitectura, que contienen objetos binarios nativos para todas las arquitecturas de destino especificadas, p.ej., --fat_apk_cpu=x86,armeabi-v7a. Si se especifica esta marca, se ignora --android_cpu para las dependencias de las reglas android_binary.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]fat_apk_hwasan
predeterminado: “false”-
Indica si se deben crear divisiones HWASAN.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--fdo_instrument=<a string>
predeterminado: Consulta la descripción-
Genera ejecutables con la instrumentación de FDO. Con el compilador Clang/LLVM, también acepta el nombre del directorio en el que se volcarán los archivos de perfil sin procesar durante el tiempo de ejecución.
Etiquetas:affects_outputs
--fdo_optimize=<a string>
predeterminado: Consulta la descripción-
Usa la información del perfil de FDO para optimizar la compilación. Especifica el nombre de un archivo ZIP que contenga un árbol de archivos .gcda, un archivo afdo que contenga un perfil automático o un archivo de perfil de LLVM. Esta marca también acepta archivos especificados como etiquetas (p.ej., "//foo/bar:file.afdo"; es posible que debas agregar una directiva "exports_files" al paquete correspondiente) y etiquetas que apuntan a destinos "fdo_profile". La regla "fdo_profile" reemplazará esta marca.
Etiquetas:affects_outputs
--fdo_prefetch_hints=<a build target label>
predeterminado: Consulta la descripción-
Usa sugerencias de almacenamiento en caché para la carga previa.
Etiquetas:affects_outputs
--fdo_profile=<a build target label>
predeterminado: Consulta la descripción-
Es el fdo_profile que representa el perfil que se usará para la optimización.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--features=<a string>
-
Las funciones determinadas se habilitarán o inhabilitarán de forma predeterminada para todos los paquetes. Si especificas -<feature>, se inhabilitará la función de forma global. Los atributos negativos siempre anulan los positivos. Esta marca se usa para habilitar el lanzamiento de cambios de funciones predeterminados sin una versión de Bazel.
Etiquetas:changes_inputs
,affects_outputs
--[no]force_pic
predeterminado: “false”-
Si está habilitada, todas las compilaciones de C++ producen código independiente de la posición ("-fPIC"), las vinculaciones prefieren las bibliotecas compiladas previamente de PIC en lugar de las bibliotecas que no son de PIC, y las vinculaciones producen ejecutables independientes de la posición ("-pie").
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan varios usos de
--host_action_env=<a 'name=value' assignment with an optional value part>
-
Especifica el conjunto de variables de entorno disponibles para las acciones con configuraciones de host o ejecución. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o bien por el par nombre=valor, que establece el valor independientemente del entorno de invocación. Esta opción se puede usar varias veces. En el caso de las opciones que se proporcionan para la misma variable, se aplica la más reciente, y se acumulan las opciones para diferentes variables.
Etiquetas:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
predeterminado: "opt"-
Especifica el modo en el que se compilarán las herramientas que se usan durante la compilación. Valores: "fastbuild", "dbg", "opt".
Etiquetas:affects_outputs
,action_command_lines
- Se acumulan varios usos de
--host_conlyopt=<a string>
-
Opción adicional para pasar a gcc cuando se compilan archivos de origen C para herramientas de host.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--host_copt=<a string>
-
Opciones adicionales para pasar a gcc para herramientas de host.
Etiquetas:action_command_lines
,affects_outputs
--host_cpu=<a string>
predeterminado: ""-
La CPU del host.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan varios usos de
--host_cxxopt=<a string>
-
Opciones adicionales para pasar a gcc para herramientas de host.
Etiquetas:action_command_lines
,affects_outputs
--host_force_python=<PY2 or PY3>
predeterminado: Consulta la descripción-
Anula la versión de Python para la configuración del host. Puede ser “PY2” o “PY3”.
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan varios usos de
--host_linkopt=<a string>
- : Opción adicional para pasar a gcc cuando se vinculan herramientas de host.
Etiquetas:action_command_lines
,affects_outputs
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Versión mínima compatible de macOS para los destinos de host. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan varios usos de
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
-
Opciones adicionales para pasar de forma selectiva al compilador C/C++ cuando se compilan ciertos archivos en las configuraciones del host o de ejecución. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. En la que regex_filter representa una lista de patrones de expresiones regulares para incluir y excluir (consulta también --instrumentation_filter). option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe estar entre comillas con una barra diagonal inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos de gcc de todos los archivos cc en //foo/, excepto bar.cc.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--host_swiftcopt=<a string>
. -
Opciones adicionales para pasar a swiftc para herramientas de host.
Etiquetas:action_command_lines
,affects_outputs
--[no]incompatible_avoid_conflict_dlls
predeterminado: "true"-
Si se habilita, se cambiará el nombre de todas las bibliotecas de vínculos dinámicos (DLL) de C++ que genera cc_library en Windows a name_{hash}.dll, donde el hash se calcula en función de RepositoryName y la ruta de acceso del paquete de la DLL. Esta opción es útil cuando tienes un paquete que depende de varias cc_library con el mismo nombre (p. ej., //foo/bar1:utils y //foo/bar2:utils).
Etiquetas:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_merge_genfiles_directory
predeterminado: "true"-
Si es verdadero, el directorio genfiles se une al directorio bin.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_use_platforms_repo_for_constraints
predeterminado: "true"-
Si es verdadero, se quita la configuración de restricciones de @bazel_tools.
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 establece, se instrumentan las reglas de prueba que incluye --instrumentation_filter. De lo contrario, las reglas de prueba siempre se excluyen de la instrumentación de cobertura.
Etiquetas:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
predeterminado: "-/javatests[/:],-/test/java[/:]"-
Cuando la cobertura esté habilitada, solo se instrumentarán las reglas con nombres incluidos en el filtro basado en regex especificado. En su lugar, se excluyen las reglas con el prefijo “-”. Ten en cuenta que solo se instrumentan las reglas que no son de prueba, a menos que se habilite --instrument_test_targets.
Etiquetas:affects_outputs
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Versión mínima de iOS compatible para los simuladores y dispositivos de destino. Si no se especifica, se usa "ios_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan varios usos de
--ios_multi_cpus=<comma-separated list of options>
-
Es una lista de arquitecturas separadas por comas con las que se compila una ios_application. El resultado es un binario universal que contiene todas las arquitecturas especificadas.
Etiquetas:loses_incremental_state
,loading_and_analysis
--[no]legacy_whole_archive
predeterminado: "true"-
Deja de estar disponible y se reemplaza por --incompatible_remove_legacy_whole_archive (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener más información). Cuando está activado, usa --whole-archive para las reglas cc_binary que tienen linkshared=True y linkstatic=True o “-static” en linkopts. Esto es solo para la retrocompatibilidad. Una mejor alternativa es usar alwayslink=1 cuando sea necesario.
Etiquetas:action_command_lines
,affects_outputs
,deprecated
- Se acumulan varios usos de
--linkopt=<a string>
- : Opción adicional para pasar a gcc cuando se realiza la vinculación.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--ltobackendopt=<a string>
. -
Opción adicional para pasar al paso de backend de LTO (en --features=thin_lto).
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--ltoindexopt=<a string>
-
Opción adicional para pasar al paso de indexación de LTO (en --features=thin_lto).
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--macos_cpus=<comma-separated list of options>
-
Es una lista separada por comas de las arquitecturas para las que se compilarán los objetos binarios de Apple macOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Versión mínima de macOS compatible para los destinos. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
--[no]objc_debug_with_GLIBCXX
predeterminado: “false”-
Si se establece y el modo de compilación se establece en "dbg", define GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC y GLIBCPP_CONCEPT_CHECKS.
Etiquetas:action_command_lines
--[no]objc_enable_binary_stripping
predeterminado: “false”-
Determina si se deben quitar los símbolos y el código muerto en los objetos binarios vinculados. Se realizarán eliminaciones de objetos binarios si se especifican esta marca y --compilation_mode=opt.
Etiquetas:action_command_lines
- Se acumulan varios usos de
--objccopt=<a string>
-
Opciones adicionales para pasar a gcc cuando se compilan archivos de origen Objective-C/C++.
Etiquetas:action_command_lines
- Se acumulan varios usos de
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
. -
Opciones adicionales para pasar de forma selectiva a gcc cuando se compilan ciertos archivos. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. En la que regex_filter representa una lista de patrones de expresiones regulares para incluir y excluir (consulta también --instrumentation_filter). option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe estar entre comillas con una barra diagonal inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos de gcc de todos los archivos cc en //foo/, excepto bar.cc.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
-
Opciones adicionales para pasar de forma selectiva al backend de LTO (en --features=thin_lto) cuando se compilan ciertos objetos de backend. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. En la que regex_filter representa una lista de patrones de expresión regular para incluir y excluir. option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe estar entre comillas con una barra diagonal inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos del backend de LTO de todos los archivos .o en //foo/, excepto bar.o.
Etiquetas:action_command_lines
,affects_outputs
--platform_suffix=<a string>
predeterminado: Consulta la descripción-
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas:loses_incremental_state
,affects_outputs
,loading_and_analysis
--propeller_optimize=<a build target label>
predeterminado: Consulta la descripción-
Usa la información del perfil de Propeller para optimizar el destino de compilación.Un perfil de Propeller debe constar de al menos uno de dos archivos: un perfil de cc y un perfil de ld. Esta marca acepta una etiqueta de compilación que debe hacer referencia a los archivos de entrada del perfil de Propeller. Por ejemplo, el archivo BUILD que define la etiqueta, en a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)Es posible que se deba agregar una directiva exports_files al paquete correspondiente para que Bazel pueda ver estos archivos. La opción se debe usar de la siguiente manera: --propeller_optimize=//a/b:propeller_profile
Etiquetas:action_command_lines
,affects_outputs
--propeller_optimize_absolute_cc_profile=<a string>
predeterminado: Consulta la descripción-
Nombre de ruta de acceso absoluta del archivo cc_profile para compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
predeterminado: Consulta la descripción-
Es el nombre de ruta de acceso absoluto del archivo ld_profile para las compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
--run_under=<a prefix in front of command>
predeterminado: Consulta la descripción-
Es el prefijo que se inserta antes de los ejecutables para los comandos "test" y "run". Si el valor es "foo -bar" y la línea de comandos de ejecución es "test_binary -baz", la línea de comandos final es "foo -bar test_binary -baz".También puede ser una etiqueta para un destino ejecutable. Algunos ejemplos son: "valgrind", "strace", "strace -c", "valgrind --quiet --num-callers=20", "//package:target", "//package:target --options".
Etiquetas:action_command_lines
-
Si es verdadero, las bibliotecas nativas que contienen funcionalidad idéntica se compartirán entre diferentes destinos.
Etiquetas:loading_and_analysis
,affects_outputs
--[no]stamp
predeterminado: “false”-
Marca los objetos binarios con la fecha, el nombre de usuario, el nombre de host, la información del espacio de trabajo, etcétera.
Etiquetas:affects_outputs
- Valor predeterminado de
--strip=<always, sometimes or never>
: “sometimes” - especifica si se deben quitar los objetos binarios y las bibliotecas compartidas (con "-Wl,--strip-debug"). El valor predeterminado de "sometimes" significa quitar si --compilation_mode=fastbuild.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--stripopt=<a string>
-
Opciones adicionales para pasar a la eliminación cuando se genera un objeto binario "<name>.stripped".
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--swiftcopt=<a string>
-
Opciones adicionales para pasar a la compilación de Swift.
Etiquetas:action_command_lines
- Se acumulan varios usos de
--tvos_cpus=<comma-separated list of options>
-
Es una lista separada por comas de las arquitecturas para las que se compilarán los objetos binarios de Apple tvOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Versión mínima compatible de tvOS para los simuladores y dispositivos de destino. Si no se especifica, se usa "tvos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan varios usos de
--watchos_cpus=<comma-separated list of options>
-
Es una lista separada por comas de las arquitecturas para las que se compilarán los objetos binarios de Apple watchOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Versión mínima compatible de watchOS para los simuladores y dispositivos de destino. Si no se especifica, se usa "watchos_sdk_version".
Etiquetas:loses_incremental_state
--xbinary_fdo=<a build target label>
predeterminado: Consulta la descripción-
Usa la información del perfil de XbinaryFDO para optimizar la compilación. Especifica el nombre del perfil binario cruzado predeterminado. Cuando la opción se usa junto con --fdo_instrument/--fdo_optimize/--fdo_profile, esas opciones siempre prevalecerán como si xbinary_fdo nunca se especificara.
Etiquetas:affects_outputs
- Opciones que afectan la rigurosidad con la que Bazel aplica entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etc.):
--auto_cpu_environment_group=<a build target label>
predeterminado: ""-
Declara el environment_group que se usará para asignar automáticamente los valores de CPU a los valores de target_environment.
Etiquetas:changes_inputs
,loading_and_analysis
,experimental
--[no]check_licenses
predeterminado: “false”-
Verifica que las restricciones de licencias que imponen los paquetes dependientes no entren en conflicto con los modos de distribución de los destinos que se compilan. De forma predeterminada, no se verifican las licencias.
Etiquetas:build_file_semantics
--[no]check_visibility
predeterminado: "true"-
Si se inhabilita, los errores de visibilidad en las dependencias de destino se degradan a advertencias.
Etiquetas:build_file_semantics
--[no]desugar_for_android
predeterminado: "true"-
Indica si se debe expandir el código de bytes de Java 8 antes de dexificarlo.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]desugar_java8_libs
predeterminado: “false”-
Indica si se deben incluir bibliotecas Java 8 compatibles en apps para dispositivos heredados.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]enforce_constraints
predeterminado: "true"-
Verifica los entornos con los que es compatible cada objetivo y, luego, informa errores si alguno tiene dependencias que no admiten los mismos entornos.
Etiquetas:build_file_semantics
--[no]experimental_allow_android_library_deps_without_srcs
predeterminado: “false”-
Es una marca que ayuda a realizar la transición de permitir a no permitir reglas de android_library sin srcs con dependencias. Se debe limpiar el depósito para lanzarlo de forma predeterminada.
Etiquetas:eagerness_to_exit
,loading_and_analysis
--[no]experimental_check_desugar_deps
predeterminado: "true"-
Determina si se debe volver a verificar la expansión correcta a nivel binario de Android.
Etiquetas:eagerness_to_exit
,loading_and_analysis
,experimental
--experimental_import_deps_checking=<off, warning or error>
predeterminado: “OFF”-
Cuando está habilitada, verifica si las dependencias de una aar_import están completas. Esta aplicación forzosa puede interrumpir la compilación o generar advertencias.
Etiquetas:loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
predeterminado: "predeterminado"-
Si es verdadero, verifica que un destino de Java declare explícitamente todos los destinos utilizados directamente como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files
predeterminado: “false”-
Si está habilitado, busca el atributo testonly de la regla de generación para verificar si hay destinos de requisitos previos que sean archivos de salida. Esto coincide con la verificación de visibilidad.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_disable_native_android_rules
predeterminado: “false”-
Si se habilita, se inhabilita el uso directo de las reglas nativas de Android. Usa las reglas de Android de Starlark de https://github.com/bazelbuild/rules_android.
Etiquetas:eagerness_to_exit
,incompatible_change
--[no]incompatible_disable_native_apple_binary_rule
predeterminado: “false”-
No realiza ninguna acción. Se mantiene aquí para la retrocompatibilidad.
Etiquetas:eagerness_to_exit
,incompatible_change
--[no]incompatible_force_strict_header_check_from_starlark
predeterminado: "true"-
Si está habilitada, establece una verificación estricta de encabezados en la API de Starlark.
Etiquetas:loading_and_analysis
,changes_inputs
,incompatible_change
--[no]incompatible_validate_top_level_header_inclusions
predeterminado: "true"-
Si es verdadero, Bazel también validará las inclusiones de encabezados de directorio de nivel superior (consulta https://github.com/bazelbuild/bazel/issues/10047 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]strict_filesets
predeterminado: “false”-
Si esta opción está habilitada, los conjuntos de archivos que cruzan los límites de los paquetes se informan como errores. No funciona cuando check_fileset_dependencies_recursively está inhabilitada.
Etiquetas:build_file_semantics
,eagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default>
predeterminado: "error"-
A menos que esté desactivado, comprueba que un destino de proto_library declare de forma explícita todos los destinos utilizados directamente como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
--strict_public_imports=<off, warn, error, strict or default>
predeterminado: "off"-
A menos que esté desactivado, comprueba que un objetivo de proto_library declare de forma explícita todos los objetivos que se usan en "import public" como exportados.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
--[no]strict_system_includes
predeterminado: “false”-
Si es verdadero, también se deben declarar los encabezados que se encuentran a través de las rutas de inclusión del sistema (-isystem).
Etiquetas:loading_and_analysis
,eagerness_to_exit
- Se acumulan varios usos de
--target_environment=<a build target label>
-
Declara el entorno de destino de esta compilación. Debe ser una referencia de etiqueta a una regla de "entorno". Si se especifican, todos los destinos de nivel superior deben ser compatibles con este entorno.
Etiquetas:changes_inputs
- Opciones que afectan los resultados de firma de una compilación:
--apk_signing_method=<v1, v2, v1_v2 or v4>
predeterminado: “v1_v2”-
Implementación que se usará para firmar APKs
Etiquetas:action_command_lines
,affects_outputs
,loading_and_analysis
--[no]device_debug_entitlements
predeterminado: "true"-
Si se establece y el modo de compilación no es "opt", las apps de objc incluirán derechos de depuración cuando se firmen.
Etiquetas:changes_inputs
--ios_signing_cert_name=<a string>
predeterminado: Consulta la descripción-
Es el nombre del certificado que se usará para la firma de iOS. Si no se establece, se usará el perfil de aprovisionamiento. Puede ser la preferencia de identidad del llavero del certificado o la substring del nombre común del certificado, según la página de man de codesign (IDENTIDADES DE FIRMA).
Etiquetas:action_command_lines
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.:
--[no]incompatible_disallow_legacy_py_provider
predeterminado: "true"-
No se realizará ninguna acción, se quitará pronto.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones que rigen el comportamiento del entorno de prueba o del ejecutor de pruebas:
--[no]allow_analysis_failures
predeterminado: “false”-
Si es verdadero, una falla de análisis de un objetivo de regla genera la propagación del objetivo de una instancia de AnalysisFailureInfo que contiene la descripción del error, en lugar de generar una falla de compilación.
Etiquetas:loading_and_analysis
,experimental
--analysis_testing_deps_limit=<an integer>
predeterminado: “2000”-
Establece la cantidad máxima de dependencias transitivas a través de un atributo de regla con una transición de configuración for_analysis_testing. Si se supera este límite, se mostrará un error de regla.
Etiquetas:loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure
predeterminado: “false”-
Si es verdadero, las fallas de la acción de dex2oat causarán que la compilación falle en lugar de ejecutar dex2oat durante el tiempo de ejecución de la prueba.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_android_use_parallel_dex2oat
predeterminado: “false”-
Usa dex2oat en paralelo para acelerar android_test.
Etiquetas:loading_and_analysis
,host_machine_resource_optimizations
,experimental
--[no]ios_memleaks
predeterminado: “false”-
Habilita la verificación de fugas de memoria en los destinos de ios_test.
Etiquetas:action_command_lines
--ios_simulator_device=<a string>
predeterminado: Consulta la descripción-
Es el dispositivo que se simula cuando se ejecuta una aplicación para iOS en el simulador, p.ej., "iPhone 6". Para obtener una lista de dispositivos, ejecuta "xcrun simctl list devicetypes" en la máquina en la que se ejecutará el simulador.
Etiquetas:test_runner
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Es la versión de iOS que se ejecutará en el simulador durante la ejecución o las pruebas. Esto se ignora para las reglas ios_test si se especifica un dispositivo de destino en la regla.
Etiquetas:test_runner
- Se acumulan varios usos de
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
. - especifica la cantidad de veces que se debe ejecutar cada prueba. Si alguno de esos intentos falla por algún motivo, se considera que toda la prueba falló. Por lo general, el valor especificado es solo un número entero. Ejemplo: --runs_per_test=3 ejecutará todas las pruebas 3 veces. Sintaxis alternativa: regex_filter@runs_per_test. En la que runs_per_test representa un valor entero y regex_filter representa una lista de patrones de expresiones regulares para incluir y excluir (consulta también --instrumentation_filter). Ejemplo: --runs_per_test=//foo/.*,-//foo/bar/.*@3 ejecuta todas las pruebas en //foo/, excepto las que se encuentran en foo/bar, tres veces. Esta opción se puede pasar varias veces. El argumento pasado más recientemente que coincida tiene prioridad. Si no hay coincidencias, la prueba solo se ejecuta una vez.
- Se acumulan varios usos de
--test_env=<a 'name=value' assignment with an optional value part>
-
Especifica variables de entorno adicionales que se insertarán en el entorno del ejecutor de pruebas. Las variables se pueden especificar por nombre, en cuyo caso su valor se leerá del entorno del cliente de Bazel, o bien por el par nombre=valor. Esta opción se puede usar varias veces para especificar varias variables. Solo lo usa el comando "bazel test".
Etiquetas:test_runner
--test_timeout=<a single integer or comma-separated list of 4 integers>
predeterminado: “-1”- Anula los valores predeterminados de tiempo de espera de las pruebas (en segundos). Si se especifica un solo valor de número entero positivo, se anularán todas las categorías. Si se especifican 4 números enteros separados por comas, se anularán los tiempos de espera para corto, moderado, largo y eterno (en ese orden). De cualquier forma, un valor de -1 le indica a blaze que use sus tiempos de espera predeterminados para esa categoría.
--tvos_simulator_device=<a string>
predeterminado: Consulta la descripción-
Es el dispositivo que se simula cuando se ejecuta una aplicación para tvOS en el simulador, p.ej., "Apple TV 1080p". Para obtener una lista de dispositivos, ejecuta "xcrun simctl list devicetypes" en la máquina en la que se ejecutará el simulador.
Etiquetas:test_runner
--tvos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Es la versión de tvOS que se ejecutará en el simulador cuando se ejecute o pruebe.
Etiquetas:test_runner
--watchos_simulator_device=<a string>
predeterminado: Consulta la descripción-
Es el dispositivo que se simula cuando se ejecuta una aplicación para watchOS en el simulador, p.ej., "Apple Watch - 38 mm". Para obtener una lista de dispositivos, ejecuta "xcrun simctl list devicetypes" en la máquina en la que se ejecutará el simulador.
Etiquetas:test_runner
--watchos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
La versión de watchOS que se ejecutará en el simulador cuando se ejecute o pruebe.
Etiquetas:test_runner
--[no]zip_undeclared_test_outputs
predeterminado: "true"-
Si es verdadero, los resultados de las pruebas no declaradas se archivarán en un archivo ZIP.
Etiquetas:test_runner
- Opciones relacionadas con el resultado de la consulta y la semántica:
--aspect_deps=<off, conservative or precise>
predeterminado: "conservative"-
Cómo resolver las dependencias de aspecto cuando el formato de salida es uno de {xml,proto,record}. "Desactivado" significa que no se resuelven las dependencias de aspecto. "Conservador" (la opción predeterminada) significa que se agregan todas las dependencias de aspecto declaradas, independientemente de si se les asigna la clase de regla de dependencias directas. "Preciso" significa que solo se agregan los aspectos que pueden estar activos según la clase de regla de las dependencias directas. Ten en cuenta que el modo preciso requiere la carga de otros paquetes para evaluar un solo objetivo, lo que lo hace más lento que los otros modos. Además, ten en cuenta que incluso el modo preciso no es del todo preciso: la decisión de calcular un aspecto se toma en la fase de análisis, que no se ejecuta durante la "consulta de bazel".
Etiquetas:build_file_semantics
--[no]deduplicate_depsets
predeterminado: "true"-
Quita los duplicados de elementos secundarios no hoja de un dep_set_of_files en el resultado final de proto/textproto/json. Esto no anula el duplicado de los conjuntos de dependencias que no comparten un elemento superior inmediato. Esto no afecta la lista final efectiva de artefactos de entrada de las acciones.
Etiquetas:terminal_output
--[no]graph:factored
predeterminado: "true"-
Si es verdadero, el gráfico se emitirá "factorizado", es decir, los nodos topológicamente equivalentes se combinarán y sus etiquetas se concatenarán. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--graph:node_limit=<an integer>
predeterminado: “512”-
Es la longitud máxima de la cadena de etiqueta para un nodo de grafo en el resultado. Las etiquetas más largas se truncarán. -1 significa que no se truncará. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--[no]implicit_deps
predeterminado: "true"-
Si está habilitada, se incluirán dependencias implícitas en el gráfico de dependencias sobre el que opera la consulta. Una dependencia implícita es aquella que no se especifica explícitamente en el archivo BUILD, pero que Bazel agrega. En el caso de cquery, esta opción controla el filtrado de cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
--[no]include_artifacts
predeterminado: "true"-
Incluye los nombres de las entradas y salidas de la acción en el resultado (potencialmente grande).
Etiquetas:terminal_output
--[no]include_aspects
predeterminado: "true"-
aquery, cquery: Indica si se deben incluir acciones generadas por aspectos en el resultado. query: No-op (siempre se siguen los aspectos).
Etiquetas:terminal_output
--[no]include_commandline
predeterminado: "true"-
Incluye el contenido de las líneas de comandos de acción en el resultado (potencialmente grande).
Etiquetas:terminal_output
--[no]include_file_write_contents
predeterminado: “false”-
Incluye el contenido del archivo para las acciones FileWrite y SourceSymlinkManifest (potencialmente grandes).
Etiquetas:terminal_output
--[no]include_param_files
predeterminado: “false”-
Incluye el contenido de los archivos de parámetros que se usan en el comando (potencialmente grande). Nota: Si habilitas esta marca, se habilitará automáticamente la marca --include_commandline.
Etiquetas:terminal_output
--[no]incompatible_display_source_file_location
predeterminado: "true"-
Es verdadero de forma predeterminada y muestra el destino del archivo fuente. Si es verdadero, muestra la ubicación de la línea 1 de los archivos de origen en los resultados de ubicación. Esta marca solo existe para la migración.
Etiquetas:terminal_output
,incompatible_change
--[no]incompatible_package_group_includes_double_slash
predeterminado: "true"-
Si está habilitada, cuando se genere el atributo "packages" de package_group, no se omitirá el "//" inicial.
Etiquetas:terminal_output
,incompatible_change
--[no]infer_universe_scope
predeterminado: “false”-
Si se establece y no se establece --universe_scope, se inferirá un valor de --universe_scope como la lista de patrones de destino únicos en la expresión de consulta. Ten en cuenta que el valor de --universe_scope inferido para una expresión de consulta que usa funciones centradas en el universo (p.ej., "allrdeps") puede no ser lo que deseas, por lo que debes usar esta opción solo si sabes lo que estás haciendo. Consulta https://bazel.build/query/language#sky-query para obtener detalles y ejemplos. Si se establece --universe_scope, se ignora el valor de esta opción. Nota: Esta opción solo se aplica a "query" (es decir, no a "cquery").
Etiquetas:loading_and_analysis
--[no]line_terminator_null
predeterminado: “false”-
Indica si cada formato finaliza con \0 en lugar de una línea nueva.
Etiquetas:terminal_output
--[no]nodep_deps
predeterminado: "true"-
Si está habilitada, las dependencias de los atributos "nodep" se incluirán en el gráfico de dependencias sobre el que opera la consulta. Un ejemplo común de un atributo "nodep" es "visibility". Ejecuta y analiza el resultado de "info build-language" para obtener información sobre todos los atributos "nodep" en el lenguaje de compilación.
Etiquetas:build_file_semantics
--output=<a string>
predeterminado: “text”-
Es el formato en el que se deben imprimir los resultados de la consulta. Los valores permitidos para aquery son: text, textproto, proto y jsonproto.
Etiquetas:terminal_output
--[no]proto:default_values
predeterminado: "true"-
Si es verdadero, se incluyen los atributos cuyo valor no se especifica de forma explícita en el archivo BUILD; de lo contrario, se omiten. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
--[no]proto:definition_stack
predeterminado: “false”-
Propaga el campo proto definition_stack, que registra para cada instancia de regla la pila de llamadas de Starlark en el momento en que se definió la clase de la regla.
Etiquetas:terminal_output
--[no]proto:flatten_selects
predeterminado: "true"-
Si está habilitada, los atributos configurables creados por select() se aplanan. En el caso de los tipos de lista, la representación aplanada es una lista que contiene cada valor del mapa de selección exactamente una vez. Los tipos escalares se aplanan a nulos.
Etiquetas:build_file_semantics
--[no]proto:include_synthetic_attribute_hash
predeterminado: “false”-
Indica si se debe calcular y propagar el atributo $internal_attr_hash.
Etiquetas:terminal_output
--[no]proto:instantiation_stack
predeterminado: “false”-
Propaga la pila de llamadas de creación de instancias de cada regla. Ten en cuenta que esto requiere que la pila esté presente.
Etiquetas:terminal_output
--[no]proto:locations
predeterminado: "true"-
Indica si se debe generar información de ubicación en el resultado de proto.
Etiquetas:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
predeterminado: “all”-
Es una lista de atributos separados por comas que se deben incluir en el resultado. La configuración predeterminada es todos los atributos. Establece una cadena vacía para no mostrar ningún atributo. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
--[no]proto:rule_inputs_and_outputs
predeterminado: "true"-
Indica si se propagan o no los campos rule_input y rule_output.
Etiquetas:terminal_output
--[no]relative_locations
predeterminado: “false”-
Si es verdadero, la ubicación de los archivos BUILD en los resultados de xml y proto será relativa. De forma predeterminada, el resultado de la ubicación es una ruta de acceso absoluta y no será coherente en todas las máquinas. Puedes establecer esta opción en verdadero para obtener un resultado coherente en todas las máquinas.
Etiquetas:terminal_output
--[no]skyframe_state
predeterminado: “false”-
Sin realizar un análisis adicional, volca el grafo de acciones actual de Skyframe. Nota: Por el momento, no se admite especificar un destino con --skyframe_state. Esta marca solo está disponible con --output=proto o --output=textproto.
Etiquetas:terminal_output
--[no]tool_deps
predeterminado: "true"-
Consulta: Si se inhabilita, las dependencias de los destinos de "configuración del host" o "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 del host", como el de cualquier regla "proto_library" al compilador de protocolos, suele apuntar a una herramienta que se ejecuta durante la compilación en lugar de a una parte del mismo programa "objetivo".
Cquery: Si se inhabilita, filtra todos los objetivos configurados que cruzan un host o una transición de ejecución desde el objetivo de nivel superior que descubrió este objetivo configurado. Esto significa que, si el objetivo de nivel superior está en la configuración de destino, solo se mostrarán los objetivos configurados también en la configuración de destino. Si el destino de nivel superior está en la configuración del host, solo se mostrarán los destinos configurados por el host. Esta opción NO excluirá las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
--universe_scope=<comma-separated list of options>
predeterminado: ""-
Es un conjunto de patrones de destino (aditivos y sustractivos) separados por comas. La consulta se puede realizar en el universo definido por el cierre transitivo de los destinos especificados. Esta opción se usa para los comandos query y cquery.
En el caso de cquery, la entrada de esta opción son los objetivos en los que se compilan todas las respuestas, por lo que esta opción puede afectar las configuraciones y las transiciones. Si no se especifica esta opción, se supone que los destinos de nivel superior son los que se analizaron de la expresión de consulta. Nota: En el caso de cquery, si no se especifica esta opción, es posible que la compilación falle si los destinos analizados de la expresión de consulta no se pueden compilar con opciones de nivel superior.
Etiquetas:loading_and_analysis
- Opciones que activan optimizaciones del tiempo de compilación:
--[no]collapse_duplicate_defines
predeterminado: “false”-
Cuando se habilita, se quitarán los --defines redundantes al principio de la compilación. Esto evita la pérdida innecesaria de la caché de análisis para ciertos tipos de compilaciones equivalentes.
Etiquetas:loading_and_analysis
,loses_incremental_state
--[no]experimental_filter_library_jar_with_program_jar
predeterminado: “false”-
Filtra el ProgramJar de ProGuard para quitar las clases que también estén presentes en el LibraryJar.
Etiquetas:action_command_lines
--[no]experimental_inmemory_dotd_files
predeterminado: "true"-
Si se habilita, los archivos .d de C++ se pasarán en la memoria directamente desde los nodos de compilación remotos en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_inmemory_jdeps_files
predeterminado: "true"-
Si está habilitado, los archivos de dependencia (.jdeps) generados a partir de compilaciones de Java se pasarán en la memoria directamente desde los nodos de compilación remotos en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_objc_include_scanning
predeterminado: “false”-
Indica si se debe incluir el análisis de C/C++ objetivo.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
--[no]experimental_parse_headers_skipped_if_corresponding_srcs_found
predeterminado: “false”-
Si está habilitada, la función parse_headers no crea una acción de compilación de encabezados independiente si se encuentra una fuente con el mismo nombre de base en el mismo destino.
Etiquetas:loading_and_analysis
,affects_outputs
--[no]experimental_retain_test_configuration_across_testonly
predeterminado: “false”-
Cuando se habilita, --trim_test_configuration no recortará la configuración de prueba de las reglas marcadas como testonly=1. Esto se hace para reducir los problemas de conflicto de acciones cuando las reglas que no son de prueba dependen de las reglas de cc_test. No tiene efecto si --trim_test_configuration es falso.
Etiquetas:loading_and_analysis
,loses_incremental_state
--[no]experimental_starlark_cc_import
predeterminado: “false”-
Si está habilitada, se puede usar la versión de Starlark de cc_import.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_unsupported_and_brittle_include_scanning
predeterminado: “false”-
Determina si se deben reducir las entradas a la compilación de C/C++ a través del análisis de líneas #include de los archivos de entrada. Esto puede mejorar el rendimiento y la incrementalidad, ya que reduce el tamaño de los árboles de entrada de compilación. Sin embargo, también puede interrumpir las compilaciones porque el escáner de inclusión no implementa por completo la semántica del preprocesador C. En particular, no comprende las directivas #include dinámicas y omite la lógica condicional del preprocesador. Úsala bajo tu propia responsabilidad. Se cerrarán todos los problemas relacionados con esta marca que se hayan presentado.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
--[no]incremental_dexing
predeterminado: "true"-
Realiza la mayor parte del trabajo de dexing por separado para cada archivo JAR.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]objc_use_dotd_pruning
predeterminado: "true"-
Si se establece, los archivos .d emitidos por clang se usarán para podar el conjunto de entradas que se pasan a las compilaciones de objc.
Etiquetas:changes_inputs
,loading_and_analysis
--[no]process_headers_in_dependencies
predeterminado: “false”-
Cuando compilas un destino //a:a, procesa los encabezados en todos los destinos de los que depende //a:a (si el procesamiento de encabezados está habilitado para la cadena de herramientas).
Etiquetas:execution
--[no]trim_test_configuration
predeterminado: "true"-
Cuando se habilita, se borran las opciones relacionadas con las pruebas debajo del nivel superior de la compilación. Cuando esta marca está activa, las pruebas no se pueden compilar como dependencias de reglas que no son de prueba, pero los cambios en las opciones relacionadas con las pruebas no harán que se vuelvan a analizar las reglas que no son de prueba.
Etiquetas:loading_and_analysis
,loses_incremental_state
--[no]use_singlejar_apkbuilder
predeterminado: "true"-
Esta opción está obsoleta. Ahora no se puede usar y se quitará pronto.
Etiquetas:loading_and_analysis
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Valor predeterminado de
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: “-.*”. -
Imprime información de depuración durante la resolución de la cadena de herramientas. La marca toma una regex, que se compara con los tipos de cadena de herramientas y los objetivos específicos para ver cuál depurar. Se pueden separar varias regex con comas y, luego, cada una se verifica por separado. Nota: El resultado de esta marca es muy complejo y es probable que solo sea útil para expertos en la resolución de cadenas de herramientas.
Etiquetas:terminal_output
- Son opciones que especifican o alteran una entrada genérica en un comando de Bazel que no pertenece a otras categorías.:
- Se acumulan varios usos de
--flag_alias=<a 'name=value' flag alias>
. -
Establece un nombre abreviado para una marca de Starlark. Toma un solo par clave-valor en el formato "<clave>=<valor>" como argumento.
Etiquetas:changes_inputs
--[no]incompatible_default_to_explicit_init_py
predeterminado: “false”-
Esta marca cambia el comportamiento predeterminado para que los archivos __init__.py ya no se creen automáticamente en los archivos de ejecución de los destinos de Python. Específicamente, cuando un objetivo py_binary o py_test tiene legacy_create_init establecido en "auto" (el valor predeterminado), se considera falso solo si se establece esta marca. Consulta https://github.com/bazelbuild/bazel/issues/10076.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_py2_outputs_are_suffixed
predeterminado: "true"-
Si es verdadero, los destinos compilados en la configuración de Python 2 aparecerán en una raíz de salida que incluye el sufijo “-py2”, mientras que los destinos compilados para Python 3 aparecerán en una raíz sin sufijo relacionado con Python. Esto significa que el symlink de conveniencia "bazel-bin" apuntará a destinos de Python 3 en lugar de Python 2. Si habilitas esta opción, también se recomienda habilitar `--incompatible_py3_is_default`.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_py3_is_default
predeterminado: "true"-
Si es verdadero, los destinos "py_binary" y "py_test" que no establezcan su atributo "python_version" (o "default_python_version") usarán PY3 de forma predeterminada en lugar de PY2. Si estableces esta marca, también se recomienda establecer `--incompatible_py2_outputs_are_suffixed`.
Etiquetas:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_use_python_toolchains
predeterminado: "true"-
Si se establece como verdadero, las reglas ejecutables de Python nativas usarán el entorno de ejecución de Python especificado por la cadena de herramientas de Python, en lugar del entorno de ejecución que proporcionan las marcas heredadas, como --python_top.
Etiquetas:loading_and_analysis
,incompatible_change
--python_version=<PY2 or PY3>
predeterminado: Consulta la descripción-
Es el modo de versión principal de Python, ya sea "PY2" o "PY3". Ten en cuenta que esto se anula con los destinos "py_binary" y "py_test" (incluso si no especifican una versión de forma explícita), por lo que, por lo general, no hay muchos motivos para proporcionar esta marca.
Etiquetas:loading_and_analysis
,affects_outputs
,explicit_in_output_path
- Opciones misceláneas que no se clasifican de otra manera:
--[no]cache_test_results
[-t
] predeterminado: "auto"- Si se establece en “auto”, Bazel vuelve a ejecutar una prueba solo si se cumplen las siguientes condiciones: (1) Bazel detecta cambios en la prueba o sus dependencias, (2) la prueba está marcada como externa, (3) se solicitaron varias ejecuciones de prueba con --runs_per_test o(4) la prueba falló anteriormente. Si se establece como "yes", Bazel almacena en caché todos los resultados de las pruebas, excepto las marcadas como externas. Si se establece en "no", Bazel no almacena en caché ningún resultado de la prueba.
--[no]experimental_cancel_concurrent_tests
predeterminado: “false”-
Si es verdadero, Blaze cancelará las pruebas que se ejecutan de forma simultánea en la primera ejecución correcta. Esto solo es útil en combinación con --runs_per_test_detects_flakes.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_fetch_all_coverage_outputs
predeterminado: “false”-
Si es verdadero, Bazel recupera todo el directorio de datos de cobertura para cada prueba durante una ejecución de cobertura.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_generate_llvm_lcov
predeterminado: “false”-
Si es verdadero, la cobertura de clang generará un informe LCOV.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_j2objc_header_map
predeterminado: "true"- Determina si se debe generar un mapa de encabezados de J2ObjC en paralelo con la transpilación de J2ObjC.
--[no]experimental_j2objc_shorter_header_path
predeterminado: “false”-
Indica si se debe generar con una ruta de encabezado más corta (usa “_ios” en lugar de “_j2objc”).
Etiquetas:affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
predeterminado: "javabuilder"- Habilita classpaths reducidos para compilaciones de Java.
--[no]experimental_limit_android_lint_to_android_constrained_java
predeterminado: “false”-
Limita --experimental_run_android_lint_on_java_rules a las bibliotecas compatibles con Android.
Etiquetas:affects_outputs
--[no]experimental_run_android_lint_on_java_rules
predeterminado: “false”-
Determina si se deben validar las fuentes java_*.
Etiquetas:affects_outputs
--[no]explicit_java_test_deps
predeterminado: “false”- Especifica de forma explícita una dependencia a JUnit o Hamcrest en un java_test en lugar de obtenerla accidentalmente de las dependencias de TestRunner. Por el momento, solo funciona para bazel.
--host_java_launcher=<a build target label>
predeterminado: Consulta la descripción- Es el selector de Java que usan las herramientas que se ejecutan durante una compilación.
- Se acumulan varios usos de
--host_javacopt=<a string>
. - Opciones adicionales para pasar a javac cuando se compilan herramientas que se ejecutan durante una compilación.
- Se acumulan varios usos de
--host_jvmopt=<a string>
. - Opciones adicionales para pasar a la VM de Java cuando se compilan herramientas que se ejecutan durante la compilación. Estas opciones se agregarán a las opciones de inicio de la VM de cada destino java_binary.
--[no]incompatible_exclusive_test_sandboxed
predeterminado: “false”-
Si es verdadero, las pruebas exclusivas se ejecutarán con la estrategia de zona de pruebas. Agrega la etiqueta "local" para forzar que se ejecute una prueba exclusiva de forma local.
Etiquetas:incompatible_change
--[no]incompatible_strict_action_env
predeterminado: “false”-
Si es verdadero, Bazel usa un entorno con un valor estático para PATH y no hereda LD_LIBRARY_PATH. Usa --action_env=ENV_VARIABLE si deseas heredar variables de entorno específicas del cliente, pero ten en cuenta que, de esta manera, se puede evitar la caché entre usuarios si se usa una caché compartida.
Etiquetas:loading_and_analysis
,incompatible_change
- Se acumulan varios usos de
--j2objc_translation_flags=<comma-separated list of options>
. - : Opciones adicionales para pasar a la herramienta J2ObjC.
--java_debug
-
Hace que la máquina virtual de Java de una prueba de Java espere una conexión de un depurador compatible con JDWP (como jdb) antes de iniciar la prueba. Implica -test_output=streamed.
Se expande a:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
--[no]java_deps
predeterminado: "true"- Genera información de dependencia (por ahora, el classpath del tiempo de compilación) por destino de Java.
--[no]java_header_compilation
predeterminado: "true"- Compila ijars directamente desde la fuente.
--java_language_version=<a string>
predeterminado: “8”- La versión del lenguaje Java
--java_launcher=<a build target label>
predeterminado: Consulta la descripción- Es el selector de Java que se usará cuando se compilen objetos binarios de Java. Si esta marca se establece en la cadena vacía, se usa el selector de JDK. El atributo "launcher" anula esta marca.
--java_runtime_version=<a string>
predeterminado: "local_jdk"- La versión del entorno de ejecución de Java
- Se acumulan varios usos de
--javacopt=<a string>
- Opciones adicionales para pasar a javac.
- Se acumulan varios usos de
--jvmopt=<a string>
- Opciones adicionales para pasar a la VM de Java. Estas opciones se agregarán a las opciones de inicio de la VM de cada destino java_binary.
--legacy_main_dex_list_generator=<a build target label>
predeterminado: Consulta la descripción- especifica un objeto binario que se usará para generar la lista de clases que deben estar en el archivo DEX principal cuando se compila el multidex heredado.
- Se acumulan varios usos de
--plugin=<a build target label>
. - Plug-ins para usar en la compilación. Actualmente, funciona con java_plugin.
--proguard_top=<a build target label>
predeterminado: Consulta la descripción- Especifica qué versión de ProGuard se usará para quitar el código cuando se compile un objeto binario de Java.
--proto_compiler=<a build target label>
predeterminado: "@bazel_tools//tools/proto:protoc"-
Es la etiqueta del protocompilador.
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
predeterminado: "@bazel_tools//tools/proto:cc_toolchain"-
Etiqueta de proto_lang_toolchain(), que describe cómo compilar protos de C++
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
predeterminado: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"-
Etiqueta de proto_lang_toolchain(), que describe cómo compilar protos de j2objc
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
predeterminado: "@bazel_tools//tools/proto:java_toolchain"-
Etiqueta de proto_lang_toolchain(), que describe cómo compilar protos de Java
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
predeterminado: "@bazel_tools//tools/proto:javalite_toolchain"-
Etiqueta de proto_lang_toolchain(), que describe cómo compilar protos de JavaLite
Etiquetas:affects_outputs
,loading_and_analysis
- Se acumulan varios usos de
--protocopt=<a string>
-
Opciones adicionales para pasar al compilador de protobuf.
Etiquetas:affects_outputs
--[no]runs_per_test_detects_flakes
predeterminado: “false”- Si es verdadero, cualquier fragmento en el que se apruebe al menos una ejecución o intento y falle al menos una ejecución o intento obtiene un estado FLAKY.
--shell_executable=<a path>
predeterminado: Consulta la descripción-
Ruta de acceso absoluta al ejecutable de shell que usará Bazel. Si no se establece, pero la variable de entorno BAZEL_SH se establece en la primera invocación de Bazel (que inicia un servidor de Bazel), Bazel la usará. Si no se establece ninguno, Bazel usa una ruta de acceso predeterminada fija según el sistema operativo en el que se ejecuta (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, todos los demás: /bin/bash). Ten en cuenta que usar un shell que no sea compatible con bash puede generar fallas de compilación o de tiempo de ejecución de los objetos binarios generados.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--test_arg=<a string>
- Especifica opciones y argumentos adicionales que se deben pasar al ejecutable de prueba. Se puede usar varias veces para especificar varios argumentos. Si se ejecutan varias pruebas, cada una de ellas recibirá argumentos idénticos. Solo lo usa el comando "bazel test".
--test_filter=<a string>
predeterminado: Consulta la descripción- : Especifica un filtro para reenviar al framework de pruebas. Se usa para limitar las pruebas que se ejecutan. Ten en cuenta que esto no afecta los destinos que se compilan.
--test_result_expiration=<an integer>
predeterminado: “-1”- Esta opción está obsoleta y no tiene ningún efecto.
--[no]test_runner_fail_fast
predeterminado: “false”- Redirecciona la opción de falla rápida al ejecutor de pruebas. El ejecutor de pruebas debe detener la ejecución en la primera falla.
--test_sharding_strategy=<explicit or disabled>
predeterminado: "explicit"- Especifica la estrategia para el fragmentación de prueba: "explicit" para usar solo la fragmentación si está presente el atributo BUILD "shard_count". "disabled" para nunca usar el fragmentación de prueba.
--tool_java_language_version=<a string>
predeterminado: “8”- La versión del lenguaje Java que se usa para ejecutar las herramientas necesarias durante una compilación
--tool_java_runtime_version=<a string>
predeterminado: "remotejdk_11"- La versión del entorno de ejecución de Java que se usa para ejecutar herramientas durante la compilación
--[no]use_ijars
predeterminado: "true"- Si está habilitada, esta opción hace que la compilación de Java use archivos JAR de interfaz. Esto generará una compilación incremental más rápida, pero los mensajes de error pueden ser diferentes.
Build Options
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
-
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
predeterminado: “false”-
Si es verdadero, usa una cadena derivada de las URLs de las descargas del repositorio como canonical_id si no se especifica. Esto hace que un cambio en las URLs genere una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no provoquen que la caché oculte los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
predeterminado: “false”-
Si se establece, no se permite descargar repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, se puede hacer que los repositorios externos funcionen en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de la compilación:
--[no]check_up_to_date
predeterminado: “false”-
No realices la compilación, solo verifica si está actualizada. Si todos los destinos están actualizados, la compilación se completa correctamente. Si se debe ejecutar algún paso, se informa un error y falla la compilación.
Etiquetas:execution
--dynamic_local_execution_delay=<an integer>
predeterminado: “1000”-
¿Cuántos milisegundos se debe retrasar la ejecución local si la ejecución remota fue más rápida durante una compilación al menos una vez?
Etiquetas:execution
,host_machine_resource_optimizations
- Se acumulan varios usos de
--dynamic_local_strategy=<a '[name=]value1[,..,valueN]' assignment>
-
Las estrategias locales, en orden, que se usarán para la mnemotecnia determinada. Pasar "local" como la mnemotecnia establece el valor predeterminado para las mnemotecnias no especificadas. Toma [mnemonic=]local_strategy[,local_strategy,…]
Etiquetas:execution
,host_machine_resource_optimizations
- Se acumulan varios usos de
--dynamic_remote_strategy=<a '[name=]value1[,..,valueN]' assignment>
. -
Las estrategias remotas que se usarán para la mnemotecnia determinada. Pasar "remote" como la mnemotecnia establece el valor predeterminado para las mnemotecnias no especificadas. Toma [mnemonic=]remote_strategy[,remote_strategy,...]
Etiquetas:execution
,host_machine_resource_optimizations
--experimental_docker_image=<a string>
predeterminado: ""-
Especifica un nombre de imagen de Docker (p.ej., “ubuntu:latest”) que se debe usar para ejecutar una acción en zona de pruebas cuando se usa la estrategia de Docker y la acción en sí no tiene un atributo de imagen de contenedor en sus remote_execution_properties en la descripción de la plataforma. El valor de esta marca se pasa de forma literal a "docker run", por lo que admite la misma sintaxis y los mismos mecanismos que Docker.
Etiquetas:execution
--[no]experimental_docker_use_customized_images
predeterminado: "true"-
Si está habilitada, inserta el UID y el GID del usuario actual en la imagen de Docker antes de usarla. Esto es obligatorio si tu compilación o pruebas dependen de que el usuario tenga un nombre y un directorio principal dentro del contenedor. Esta opción está activada de forma predeterminada, pero puedes inhabilitarla en caso de que la función de personalización automática de imágenes no funcione en tu caso o sepas que no la necesitas.
Etiquetas:execution
--[no]experimental_dynamic_exclude_tools
predeterminado: "true"-
Cuando se configuran, los destinos que se compilan "para la herramienta" no están sujetos a la ejecución dinámica. Es muy poco probable que estos objetivos se compilen de forma incremental y, por lo tanto, no vale la pena invertir ciclos locales en ellos.
Etiquetas:execution
,host_machine_resource_optimizations
--experimental_dynamic_local_load_factor=<a double>
predeterminado: “0”- Controla la cantidad de carga de la ejecución dinámica que se colocará en la máquina local. Esta marca ajusta la cantidad de acciones en la ejecución dinámica que programaremos de forma simultánea. Se basa en la cantidad de CPUs que Blaze considera que están disponibles, que se puede controlar con la marca --local_cpu_resources.
Si esta marca es 0, todas las acciones se programan de forma local de inmediato. Si es mayor que 0, la cantidad de acciones programadas de forma local se limita por la cantidad de CPUs disponibles. Si es menor que 1, el factor de carga se usa para reducir la cantidad de acciones programadas de forma local cuando la cantidad de acciones que esperan programación es alta. Esto reduce la carga en la máquina local en el caso de la compilación limpia, en el que la máquina local no contribuye mucho.
Etiquetas:execution
,host_machine_resource_optimizations
--experimental_dynamic_slow_remote_time=<An immutable length of time.>
predeterminado: “0”-
Si es mayor que 0, es el tiempo que una acción que se ejecuta de forma dinámica debe ejecutarse solo de forma remota antes de que prioricemos su ejecución local para evitar tiempos de espera remotos. Esto puede ocultar algunos problemas en el sistema de ejecución remota. No actives esta opción sin supervisar los problemas de ejecución remota.
Etiquetas:execution
,host_machine_resource_optimizations
--[no]experimental_enable_docker_sandbox
predeterminado: “false”-
Habilita la zona de pruebas basada en Docker. Esta opción no tiene efecto si Docker no está instalado.
Etiquetas:execution
--experimental_persistent_javac
-
Habilita el compilador de Java persistente experimental.
Se expande a:
--strategy=Javac=worker
--strategy=JavaIjar=local
--strategy=JavaDeployJar=local
--strategy=JavaSourceJar=local
--strategy=Turbine=local
Etiquetas:execution
,host_machine_resource_optimizations
--experimental_sandbox_async_tree_delete_idle_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
predeterminado: “0”-
Si es 0, borra los árboles de zona de pruebas en cuanto se completa una acción (lo que retrasa la finalización de la acción). Si es mayor que cero, ejecuta la eliminación de esos tres en un grupo de subprocesos asíncrono que tenga el tamaño 1 cuando se ejecute la compilación y que crezca hasta el tamaño especificado por esta marca cuando el servidor esté inactivo.
Etiquetas:host_machine_resource_optimizations
,execution
--experimental_sandboxfs_path=<a string>
predeterminado: "sandboxfs"-
Es la ruta de acceso al objeto binario de sandboxfs que se usará cuando --experimental_use_sandboxfs sea verdadero. Si es un nombre sin formato, usa el primer binario de ese nombre que se encuentre en la PATH.
Etiquetas:host_machine_resource_optimizations
,execution
--[no]experimental_split_xml_generation
predeterminado: "true"-
Si se establece esta marca y una acción de prueba no genera un archivo test.xml, Bazel usa una acción independiente para generar un archivo test.xml ficticio que contiene el registro de prueba. De lo contrario, Bazel genera un test.xml como parte de la acción de prueba.
Etiquetas:execution
--experimental_total_worker_memory_limit_mb=<an integer, 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 active la raíz, solo activa lo que se proporciona con sandbox_add_mount_pair. Los archivos de entrada tendrán un vínculo duro a la zona de pruebas en lugar de un vínculo simbólico desde la zona de pruebas. Si los archivos de entrada de la acción se encuentran en un sistema de archivos diferente al de la zona de pruebas, se copiarán los archivos de entrada.
Etiquetas:execution
--[no]experimental_use_sandboxfs
predeterminado: “false”-
Usa sandboxfs para crear los directorios execroot de las acciones en lugar de compilar un árbol de symlink. Si es "sí", el binario que proporciona --experimental_sandboxfs_path debe ser válido y debe corresponder a una versión compatible de sandboxfs. Si es "auto", es posible que falte el objeto binario o que no sea compatible.
Etiquetas:host_machine_resource_optimizations
,execution
--[no]experimental_use_windows_sandbox
predeterminado: “false”- Usa la zona de pruebas de Windows para ejecutar acciones. Si es "sí", el binario que proporciona --experimental_windows_sandbox_path debe ser válido y debe corresponder a una versión compatible de sandboxfs. Si es "auto", es posible que falte el objeto binario o que no sea compatible.
--experimental_windows_sandbox_path=<a string>
predeterminado: "BazelSandbox.exe"- Es la ruta de acceso al objeto binario de la zona de pruebas de Windows que se usará cuando --experimental_use_windows_sandbox sea verdadero. Si es un nombre sin formato, usa el primer objeto binario de ese nombre que se encuentre en la PATH.
--[no]experimental_worker_as_resource
predeterminado: “false”-
Si está habilitado, los trabajadores se adquieren como recursos de ResourceManager.
Etiquetas:execution
,host_machine_resource_optimizations
--[no]experimental_worker_cancellation
predeterminado: “false”-
Si está habilitado, Bazel puede enviar solicitudes de cancelación a los trabajadores que las admiten.
Etiquetas:execution
--[no]experimental_worker_multiplex
predeterminado: "true"-
Si está habilitada, los trabajadores que admitan la función de multiplexación experimental la usarán.
Etiquetas:execution
,host_machine_resource_optimizations
--[no]experimental_worker_multiplex_sandboxing
predeterminado: “false”-
Si se habilita, los trabajadores de multiplexación se colocarán en la zona de pruebas, con un directorio de zona de pruebas independiente por solicitud de trabajo. Solo se incluirán en la zona de pruebas los trabajadores que tengan el requisito de ejecución "supports-multiplex-sandboxing".
Etiquetas:execution
--[no]experimental_worker_strict_flagfiles
predeterminado: “false”-
Si está habilitado, los argumentos de acciones para los trabajadores que no siguen la especificación del trabajador generarán un error. Los argumentos del trabajador deben tener exactamente un argumento @flagfile como el último de su lista de argumentos.
Etiquetas:execution
--genrule_strategy=<comma-separated list of options>
predeterminado: ""-
Especifica cómo ejecutar genrules. Esta marca se dará de baja gradualmente. En su lugar, usa --spawn_strategy=<value> para controlar todas las acciones o --strategy=Genrule=<value> para controlar solo las genrules.
Etiquetas:execution
- Se acumulan varios usos de
--high_priority_workers=<a string>
-
Son mnemónicos de los trabajadores que se ejecutarán con alta prioridad. Cuando se ejecutan trabajadores de alta prioridad, se regulan todos los demás.
Etiquetas:execution
--[no]incompatible_remote_dangling_symlinks
predeterminado: "true"-
Si se establece en "true" y --incompatible_remote_symlinks también es "true", los symlinks en los resultados de la acción pueden colgar.
Etiquetas:execution
,incompatible_change
--[no]incompatible_remote_symlinks
predeterminado: "true"-
Si se establece como verdadero, Bazel representará los symlinks en los resultados de la acción en el protocolo de ejecución o almacenamiento en caché remoto como tal. De lo contrario, se seguirán los symlinks y se representarán como archivos o directorios. Consulta el problema #6631 para obtener más información.
Etiquetas:execution
,incompatible_change
--[no]incompatible_sandbox_hermetic_tmp
predeterminado: “false”-
Si se establece como verdadero, cada zona de pruebas de Linux tendrá su propio directorio vacío dedicado activado como /tmp en lugar de compartir /tmp con el sistema de archivos del host. Usa --sandbox_add_mount_pair=/tmp para seguir viendo el /tmp del host en todas las zonas de pruebas.
Etiquetas:execution
--[no]internal_spawn_scheduler
predeterminado: “false”-
Opción de marcador de posición para que podamos indicar en Blaze si se habilitó el programador de creación.
Etiquetas:execution
,host_machine_resource_optimizations
--jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
[-j
] predeterminado: "auto"-
Es la cantidad de trabajos simultáneos que se ejecutarán. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". Los valores deben estar entre 1 y 5,000. Los valores superiores a 2,500 pueden causar problemas de memoria. "auto" calcula un valor predeterminado razonable según los recursos del host.
Etiquetas:host_machine_resource_optimizations
,execution
--[no]keep_going
[-k
] predeterminado: "false"-
Continúa tanto como sea posible después de un error. Si bien no se pueden analizar el objetivo que falló ni los que dependen de él, sí se pueden analizar otros requisitos previos de estos objetivos.
Etiquetas:eagerness_to_exit
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
predeterminado: “auto”-
Cantidad de subprocesos en paralelo que se usarán para la fase de carga o análisis. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". "auto" establece un valor predeterminado razonable según los recursos del host. Debe ser 1 como mínimo.
Etiquetas:bazel_internal_configuration
--[no]reuse_sandbox_directories
predeterminado: “false”-
Si se establece en verdadero, los directorios que usa la ejecución no de trabajador en zona de pruebas se pueden volver a usar para evitar costos de configuración innecesarios.
Etiquetas:host_machine_resource_optimizations
,execution
--sandbox_base=<a string>
predeterminado: ""-
Permite que la zona de pruebas cree sus directorios en esta ruta. Especifica una ruta de acceso en tmpfs (como /run/shm) para mejorar mucho el rendimiento cuando tu compilación o pruebas tengan muchos archivos de entrada. Nota: Necesitas suficiente RAM y espacio libre en el tmpfs para contener los archivos de salida y los archivos intermedios que generan las acciones de ejecución.
Etiquetas:host_machine_resource_optimizations
,execution
--[no]sandbox_explicit_pseudoterminal
predeterminado: “false”-
Habilita de forma explícita la creación de pseudoterminales para acciones en zona de pruebas. Algunas distribuciones de Linux requieren que se configure el ID de grupo del proceso en "tty" dentro de la zona de pruebas para que funcionen los pseudoterminales. Si esto causa problemas, se puede inhabilitar esta marca para permitir el uso de otros grupos.
Etiquetas:execution
- Se acumulan varios usos de
--sandbox_tmpfs_path=<an absolute path>
-
Para las acciones en zona de pruebas, activa un directorio vacío y con permisos de escritura en esta ruta de acceso absoluta (si la implementación de zona de pruebas lo admite, se ignora de lo contrario).
Etiquetas:host_machine_resource_optimizations
,execution
--spawn_strategy=<comma-separated list of options>
predeterminado: ""-
Especifica cómo se ejecutan las acciones de creación de forma predeterminada. Acepta una lista de estrategias separadas por comas de mayor a menor prioridad. Para cada acción, Bazel elige la estrategia con la prioridad más alta que puede ejecutar la acción. El valor predeterminado es "remote,worker,sandboxed,local". Consulta https://blog.bazel.build/2019/06/19/list-strategy.html para obtener más información.
Etiquetas:execution
- Se acumulan varios usos de
--strategy=<a '[name=]value1[,..,valueN]' assignment>
-
Especifica cómo distribuir la compilación de otras acciones de creación. Acepta una lista de estrategias separadas por comas de mayor a menor prioridad. Para cada acción, Bazel elige la estrategia con la prioridad más alta que puede ejecutar la acción. El valor predeterminado es "remote,worker,sandboxed,local". Esta marca anula los valores establecidos por --spawn_strategy (y --genrule_strategy si se usa con Genrule mnemónico). Consulta https://blog.bazel.build/2019/06/19/list-strategy.html para obtener más información.
Etiquetas:execution
- Se acumulan varios usos de
--strategy_regexp=<a '<RegexFilter>=value[,value]' assignment>
-
Anula qué estrategia de creación se debe usar para ejecutar acciones de creación que tengan descripciones que coincidan con un cierto regex_filter. Consulta --per_file_copt para obtener detalles sobre la coincidencia de regex_filter. Se usa el primer regex_filter que coincida con la descripción. Esta opción anula otras marcas para especificar la estrategia. Ejemplo: --strategy_regexp=//foo.*\.cc,-//foo/bar=local significa ejecutar acciones con la estrategia local si sus descripciones coinciden con //foo.*.cc, pero no con //foo/bar. Ejemplo: --strategy_regexp='Compiling.*/bar=local --strategy_regexp=Compiling=sandboxed ejecutará "Compiling //foo/bar/baz" con la estrategia "local", pero si se invierte el orden, se ejecutará con "sandboxed".
Etiquetas:execution
- Se acumulan varios usos de
--worker_extra_flag=<a 'name=value' assignment>
-
Son marcas de comando adicionales que se pasarán a los procesos de trabajo, además de --persistent_worker, con clave mnemónica (p.ej., --worker_extra_flag=Javac=--debug.
Etiquetas:execution
,host_machine_resource_optimizations
- Se acumulan varios usos de
--worker_max_instances=<[name=]value, where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
-
Cuántas instancias de un proceso de trabajo (como el compilador de Java persistente) se pueden iniciar si usas la estrategia "trabajador". Se puede especificar como [name=value] para dar un valor diferente por mnemónica de trabajador. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". "auto" calcula un valor predeterminado razonable en función de la capacidad de la máquina. “=value” establece un valor predeterminado para mnemotecnias no especificadas.
Etiquetas:execution
,host_machine_resource_optimizations
- Se acumulan varios usos de
--worker_max_multiplex_instances=<[name=]value, where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
-
Cuántas WorkRequests puede recibir un proceso de trabajador multiplexado en paralelo si usas la estrategia "trabajador" con --experimental_worker_multiplex. Se puede especificar como [name=value] para dar un valor diferente por mnemónica de trabajador. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". "auto" calcula un valor predeterminado razonable en función de la capacidad de la máquina. “=value” establece un valor predeterminado para mnemotecnias no especificadas.
Etiquetas:execution
,host_machine_resource_optimizations
--[no]worker_quit_after_build
predeterminado: “false”-
Si se habilita, todos los trabajadores se quitan después de que se completa una compilación.
Etiquetas:execution
,host_machine_resource_optimizations
--[no]worker_sandboxing
predeterminado: “false”-
Si se habilita, los trabajadores se ejecutarán en un entorno de zona de pruebas.
Etiquetas:execution
--[no]worker_verbose
predeterminado: “false”- Si está habilitada, imprime mensajes detallados cuando se inician, se cierran, etc. los trabajadores.
- Opciones que configuran la cadena de herramientas que se usa para la ejecución de acciones:
--[no]incompatible_disable_runtimes_filegroups
predeterminado: “false”-
Opción sin efecto obsoleta.
Etiquetas:action_command_lines
,loading_and_analysis
,deprecated
,incompatible_change
--[no]incompatible_dont_emit_static_libgcc
predeterminado: "true"-
Opción sin efecto obsoleta.
Etiquetas:action_command_lines
,loading_and_analysis
,deprecated
,incompatible_change
--[no]incompatible_linkopts_in_user_link_flags
predeterminado: "true"-
Opción sin efecto obsoleta.
Etiquetas:action_command_lines
,loading_and_analysis
,deprecated
,incompatible_change
- Opciones que controlan el resultado del comando:
--[no]build
predeterminado: "true"-
Ejecuta la compilación. Este es el comportamiento habitual. Especificar --nobuild hace que la compilación se detenga antes de ejecutar las acciones de compilación y devuelva cero si las fases de carga y análisis del paquete se completaron correctamente. Este modo es útil para probar esas fases.
Etiquetas:execution
,affects_outputs
--[no]experimental_run_validations
predeterminado: "true"-
En su lugar, usa --run_validations.
Etiquetas:execution
,affects_outputs
--[no]experimental_use_validation_aspect
predeterminado: “false”-
Indica si se deben ejecutar acciones de validación con el aspecto (para el paralelismo con las pruebas).
Etiquetas:execution
,affects_outputs
- Se acumulan varios usos de
--output_groups=<comma-separated list of options>
-
Es una lista de nombres de grupos de salida separados por comas, cada uno de los cuales puede tener un prefijo de + o -. Un grupo con el prefijo + se agrega al conjunto predeterminado de grupos de salida, mientras que un grupo con el prefijo - se quita del conjunto predeterminado. Si no se agrega un prefijo a, al menos, un grupo, se omite el conjunto predeterminado de grupos de salida. Por ejemplo, --output_groups=+foo,+bar compila la unión del conjunto predeterminado, foo y bar, mientras que --output_groups=foo,bar anula el conjunto predeterminado de modo que solo se compilen foo y bar.
Etiquetas:execution
,affects_outputs
--[no]run_validations
predeterminado: "true"-
Indica si se deben ejecutar acciones de validación como parte de la compilación. Consulta https://bazel.build/extending/rules#validation_actions
Etiquetas:execution
,affects_outputs
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
- Se acumulan varios usos de
--aspects=<comma-separated list of options>
- Es una lista de aspectos separados por comas que se aplicarán a los objetivos de nivel superior. En la lista, si el aspecto some_aspect especifica proveedores de aspectos obligatorios a través de required_aspect_providers, some_aspect se ejecutará después de cada aspecto que se mencionó antes en la lista de aspectos cuyos proveedores anunciados satisfacen los proveedores de aspectos obligatorios de some_aspect. Además, some_aspect se ejecutará después de todos sus aspectos obligatorios especificados por el atributo requires. Luego, some_aspect tendrá acceso a los valores de los proveedores de esos aspectos. <bzl-file-label>%<aspect_name>, por ejemplo, '//tools:my_def.bzl%my_aspect', donde "my_aspect" es un valor de nivel superior de un archivo tools/my_def.bzl
--bep_maximum_open_remote_upload_files=<an integer>
predeterminado: “-1”-
Cantidad máxima de archivos abiertos permitidos durante la carga de artefactos de BEP.
Etiquetas:affects_outputs
--[no]experimental_convenience_symlinks
predeterminado: "normal"-
Esta marca controla cómo se administrarán los symlinks de conveniencia (los symlinks que aparecen en el lugar de trabajo después de la compilación). Valores posibles:
normal (predeterminado): Se creará o borrará cada tipo de symlink de conveniencia, según lo determine la compilación.
clean: Se borrarán todos los symlinks sin condiciones.
ignore: Los symlinks no se modificarán.
log_only: Genera mensajes de registro como si se pasara "normal", pero no realiza ninguna operación del sistema de archivos (útil para herramientas).
Ten en cuenta que solo se pueden ver afectados los symlinks cuyos nombres genera el valor actual de --symlink_prefix. Si cambia el prefijo, no se modificarán los symlinks preexistentes.
Etiquetas:affects_outputs
--[no]experimental_convenience_symlinks_bep_event
predeterminado: “false”-
Esta marca controla si publicaremos o no el evento de compilación ConvenienceSymlinksIdentified en BuildEventProtocol. Si el valor es verdadero, BuildEventProtocol tendrá una entrada para convenienceSymlinksIdentified, en la que se enumerarán todos los symlinks de conveniencia creados en tu lugar de trabajo. Si es falso, la entrada convenienceSymlinksIdentified en BuildEventProtocol estará vacía.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--experimental_multi_cpu=<comma-separated list of options>
-
Obsoleto. No realiza ninguna acción.
Etiquetas:affects_outputs
,experimental
--remote_download_minimal
-
No descarga ningún resultado de compilación remota a la máquina local. Esta marca es un atajo para las marcas: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata y --remote_download_outputs=minimal.
Se expande a:
--nobuild_runfile_links
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=minimal
Etiquetas:affects_outputs
--remote_download_outputs=<all, minimal or toplevel>
predeterminado: “all”-
Si se establece en "minimal", no se descargan resultados de compilación remotas en la máquina local, excepto los que requieren las acciones locales. Si se establece en "toplevel", se comporta como "minimal", excepto que también descarga los resultados de los destinos de nivel superior en la máquina local. Ambas opciones pueden reducir significativamente los tiempos de compilación si el ancho de banda de la red es un cuello de botella.
Etiquetas:affects_outputs
--remote_download_symlink_template=<a string>
predeterminado: ""-
En lugar de descargar resultados de compilación remotos en la máquina local, crea vínculos simbólicos. El destino de los vínculos simbólicos se puede especificar en forma de una cadena de plantilla. Esta cadena de plantilla puede contener {hash} y {size_bytes} que se expanden al hash del objeto y al tamaño en bytes, respectivamente. Estos vínculos simbólicos pueden, por ejemplo, apuntar a un sistema de archivos FUSE que cargue objetos del CAS a pedido.
Etiquetas:affects_outputs
--remote_download_toplevel
- Solo descarga resultados remotos de destinos de nivel superior en la máquina local. Esta marca es un atajo para las marcas: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata y --remote_download_outputs=toplevel.
Se expande a:
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=toplevel
Etiquetas:affects_outputs
--symlink_prefix=<a string>
predeterminado: Consulta la descripción-
Es el prefijo que se agrega a cualquiera de los symlinks de conveniencia que se crean después de una compilación. Si se omite, el valor predeterminado es el nombre de la herramienta de compilación seguido de un guion. Si se pasa “/”, no se crean symlinks ni se emite ninguna advertencia. Advertencia: La funcionalidad especial para "/" dejará de estar disponible pronto. En su lugar, usa --experimental_convenience_symlinks=ignore.
Etiquetas:affects_outputs
- Opciones que afectan la rigurosidad con la que Bazel aplica entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etc.):
--[no]experimental_docker_privileged
predeterminado: “false”-
Si está habilitada, Bazel pasará la marca --privileged a "docker run" cuando ejecute acciones. Es posible que tu compilación lo requiera, pero también podría reducir la hermeticidad.
Etiquetas:execution
--experimental_repository_hash_file=<a string>
predeterminado: ""-
Si no está vacío, especifica un archivo que contiene un valor resuelto, con el que se deben verificar los valores hash del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
--[no]experimental_sandboxfs_map_symlink_targets
predeterminado: “false”-
Si es verdadero, asigna los destinos de los vínculos simbólicos especificados como entradas de acción a la zona de pruebas. Esta función existe solo para solucionar problemas con reglas que no lo hacen por sí solas y debe quitarse una vez que se corrijan todas esas reglas.
Etiquetas:host_machine_resource_optimizations
,execution
- Se acumulan varios usos de
--experimental_verify_repository_rules=<a string>
. -
Si es una lista de reglas de repositorio para las que se debe verificar el hash del directorio de salida, siempre que se especifique un archivo con --experimental_repository_hash_file.
Etiquetas:affects_outputs
,experimental
--[no]incompatible_legacy_local_fallback
predeterminado: "true"-
Si se establece como verdadero, habilita el resguardo implícito heredado de la estrategia de zona de pruebas a la estrategia local. Con el tiempo, esta marca se establecerá de forma predeterminada como falsa y, luego, se convertirá en una no operación. En su lugar, usa --strategy, --spawn_strategy o --dynamic_local_strategy para configurar los resguardos.
Etiquetas:execution
,incompatible_change
- Se acumulan varios usos de
--sandbox_add_mount_pair=<a single path or a 'source:target' pair>
. -
Agrega un par de rutas de acceso adicionales para activar en la zona de pruebas.
Etiquetas:execution
- Se acumulan varios usos de
--sandbox_block_path=<a string>
. -
Para las acciones en zona de pruebas, no permitas el acceso a esta ruta.
Etiquetas:execution
--[no]sandbox_default_allow_network
predeterminado: "true"- Permite el acceso a la red de forma predeterminada para las acciones. Es posible que esto no funcione con todas las implementaciones de zona de pruebas.
--[no]sandbox_fake_hostname
predeterminado: “false”-
Cambia el nombre de host actual a "localhost" para las acciones en zona de pruebas.
Etiquetas:execution
--[no]sandbox_fake_username
predeterminado: “false”-
Cambia el nombre de usuario actual a "nadie" para las acciones en zona de pruebas.
Etiquetas:execution
- Se acumulan varios usos de
--sandbox_writable_path=<a string>
. -
Para las acciones en la zona de pruebas, crea un directorio existente en el que se pueda escribir en la zona de pruebas (si la implementación de la zona de pruebas lo admite, se ignora de lo contrario).
Etiquetas:execution
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: "true"-
Etiquetas de
sin operación:no_op
,deprecated
,experimental
--[no]incompatible_config_setting_private_default_visibility
predeterminado: “false”-
Si incompatible_enforce_config_setting_visibility=false, esto es una operación no realizada. De lo contrario, si esta marca es falsa, cualquier config_setting sin un atributo de visibilidad explícito es //visibility:public. Si esta marca es verdadera, config_setting sigue la misma lógica de visibilidad que todas las demás reglas. Consulta https://github.com/bazelbuild/bazel/issues/12933.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
predeterminado: "true"-
Si es verdadero, aplica las restricciones de visibilidad de config_setting. Si es falso, todos los config_setting son visibles para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones que rigen el comportamiento del entorno de prueba o del ejecutor de pruebas:
--[no]check_tests_up_to_date
predeterminado: “false”-
No ejecutes pruebas, solo verifica si están actualizadas. Si todos los resultados de las pruebas están actualizados, la prueba se completa correctamente. Si se debe compilar o ejecutar alguna prueba, se informa un error y la prueba falla. Esta opción implica el comportamiento de --check_up_to_date.
Etiquetas:execution
- Se acumulan varios usos de
--flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once>
. -
Cada prueba se reintentará hasta la cantidad especificada de veces en caso de que falle. Las pruebas que requirieron más de un intento para aprobar se marcan como "FLAKY" en el resumen de la prueba. Por lo general, el valor especificado es solo un número entero o la cadena "default". Si es un número entero, todas las pruebas se ejecutarán hasta N veces. Si es "default", solo se realizará un intento de prueba para las pruebas normales y tres para las pruebas marcadas explícitamente como inestables por su regla (atributo flaky=1). Sintaxis alternativa: regex_filter@flaky_test_attempts. En el que flaky_test_attempts es como se indicó anteriormente y regex_filter representa una lista de patrones de expresiones regulares para incluir y excluir (consulta también --runs_per_test). Ejemplo: --flaky_test_attempts=//foo/.*,-//foo/bar/.*@3 corrige todas las pruebas en //foo/, excepto las que se encuentran en foo/bar, tres veces. Esta opción se puede pasar varias veces. El argumento pasado más recientemente que coincida tiene prioridad. Si no hay coincidencias, el comportamiento es como el de "default" anterior.
Etiquetas:execution
--local_test_jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
predeterminado: “auto”-
Es la cantidad máxima de trabajos de prueba locales que se ejecutarán de forma simultánea. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". 0 significa que los recursos locales limitarán la cantidad de trabajos de prueba locales que se ejecutarán de forma simultánea. Establecer este valor por encima del valor de --jobs no es eficaz.
Etiquetas:execution
--[no]test_keep_going
predeterminado: "true"-
Cuando se inhabilita, cualquier prueba que no se apruebe hará que se detenga toda la compilación. De forma predeterminada, se ejecutan todas las pruebas, incluso si algunas no se aprueban.
Etiquetas:execution
--test_strategy=<a string>
predeterminado: ""-
Especifica qué estrategia usar cuando se ejecutan pruebas.
Etiquetas:execution
--test_tmpdir=<a path>
predeterminado: Consulta la descripción- Especifica el directorio temporal base que usará "bazel test".
- Opciones relacionadas con la salida y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
. -
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitados en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "advertencia" -
Verifica si las dependencias directas de "bazel_dep" declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivarla a un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
- Anula un módulo con un directorio local.
- Se acumulan varios usos de
--registry=<a string>
-
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]announce
predeterminado: “false”-
Obsoleto. No realiza ninguna acción.
Etiquetas:affects_outputs
--[no]debug_spawn_scheduler
predeterminado: “false”--[no]experimental_bep_target_summary
predeterminado: “false”- Determina si se deben publicar eventos TargetSummary.
--[no]experimental_build_event_expand_filesets
predeterminado: “false”-
Si es verdadero, expande los conjuntos de archivos en el BEP cuando se presenten los archivos de salida.
Etiquetas:affects_outputs
--[no]experimental_build_event_fully_resolve_fileset_symlinks
predeterminado: “false”-
Si es verdadero, resuelve completamente los symlinks de conjuntos de archivos relativos en el BEP cuando se presentan archivos de salida. Requiere --experimental_build_event_expand_filesets.
Etiquetas:affects_outputs
--experimental_build_event_upload_max_retries=<an integer>
predeterminado: “4”-
Es la cantidad máxima de veces que Bazel debe volver a intentar subir un evento de compilación.
Etiquetas:bazel_internal_configuration
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
predeterminado: "1s"-
Retraso inicial mínimo para los reintentos de retirada exponencial cuando falla la carga de BEP. (exponente: 1.6)
Etiquetas:bazel_internal_configuration
--experimental_build_event_upload_strategy=<a string>
predeterminado: Consulta la descripción-
Selecciona cómo subir artefactos a los que se hace referencia en el protocolo del evento de compilación.
Etiquetas:affects_outputs
--[no]experimental_collect_local_sandbox_action_metrics
predeterminado: "true"-
Cuando se habilita, se registran las estadísticas de ejecución (como la hora del usuario y del sistema) para las acciones que se ejecutan de forma local y que usan la zona de pruebas.
Etiquetas:execution
--[no]experimental_docker_verbose
predeterminado: “false”-
Si se habilita, Bazel imprimirá mensajes más detallados sobre la estrategia de zona de pruebas de Docker.
Etiquetas:execution
--[no]experimental_materialize_param_files_directly
predeterminado: “false”-
Si materializas archivos de parámetros, hazlo con operaciones de escritura directa en el disco.
Etiquetas:execution
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
--experimental_repository_resolved_file=<a string>
predeterminado: ""-
Si no está vacío, escribe un valor Starlark con la información resuelta de todas las reglas del repositorio Starlark que se ejecutaron.
Etiquetas:affects_outputs
--[no]experimental_stream_log_file_uploads
predeterminado: “false”-
El archivo de registro de transmisión se sube directamente al almacenamiento remoto en lugar de escribirlo en el disco.
Etiquetas:affects_outputs
--explain=<a path>
predeterminado: Consulta la descripción-
Hace que el sistema de compilación explique cada paso ejecutado de la compilación. La explicación se escribe en el archivo de registro especificado.
Etiquetas:affects_outputs
--[no]legacy_important_outputs
predeterminado: "true"-
Usa esto para suprimir la generación del campo important_outputs heredado en el evento TargetComplete. important_outputs es obligatorio para la integración de Bazel en ResultStore.
Etiquetas:affects_outputs
--[no]materialize_param_files
predeterminado: “false”-
Escribe archivos de parámetros intermedios en el árbol de salida, incluso cuando se usa la ejecución de acciones remotas. Es útil cuando se depuran acciones. Esto se infiere de --subcommands y --verbose_failures.
Etiquetas:execution
--max_config_changes_to_show=<an integer>
predeterminado: “3”-
Cuando se descarta la caché de análisis debido a un cambio en las opciones de compilación, se muestra hasta la cantidad determinada de nombres de opciones modificados. Si el número que se proporciona es -1, se mostrarán todas las opciones modificadas.
Etiquetas:terminal_output
--max_test_output_bytes=<an integer>
predeterminado: “-1”-
Especifica el tamaño máximo de registro por prueba que se puede emitir cuando --test_output es "errors" o "all". Es útil para evitar que el resultado se vea abrumado por un resultado de prueba con demasiado ruido. El encabezado de prueba se incluye en el tamaño del registro. Los valores negativos implican que no hay límite. El resultado es todo o nada.
Etiquetas:test_runner
,terminal_output
,execution
--output_filter=<a valid Java regular expression>
predeterminado: Consulta la descripción-
Solo muestra advertencias para las reglas con un nombre que coincide con la expresión regular proporcionada.
Etiquetas:affects_outputs
--progress_report_interval=<an integer in 0-3600 range>
predeterminado: “0”-
Es la cantidad de segundos que se deben esperar entre los informes de los trabajos que aún se están ejecutando. El valor predeterminado 0 significa que el primer informe se imprimirá después de 10 segundos, luego de 30 segundos y, después de ese progreso, se informará una vez por minuto. Cuando se habilita --curses, el progreso se informa cada segundo.
Etiquetas:affects_outputs
- Valor predeterminado de
--remote_print_execution_messages=<failure, success or all>
: “failure” -
Elige cuándo imprimir los mensajes de ejecución remota. Los valores válidos son "failure" para imprimir solo en caso de fallas, "success" para imprimir solo en caso de éxitos y "all" para imprimir siempre.
Etiquetas:terminal_output
--[no]sandbox_debug
predeterminado: “false”-
Habilita las funciones de depuración para la función de zona de pruebas. Esto incluye dos aspectos: primero, el contenido raíz de la zona de pruebas no se modifica después de una compilación (y, si se usa sandboxfs, el sistema de archivos se deja activado); y, segundo, imprime información de depuración adicional durante la ejecución. Esto puede ayudar a los desarrolladores de reglas de Bazel o Starlark con fallas de depuración debido a la falta de archivos de entrada, etcétera.
Etiquetas:terminal_output
--show_result=<an integer>
predeterminado: “1”-
Muestra los resultados de la compilación. Para cada objetivo, indica si se actualizó o no y, de ser así, una lista de los archivos de salida que se compilaron. Los archivos impresos son cadenas convenientes para copiar y pegar en la shell y ejecutarlas.
Esta opción requiere un argumento de número entero, que es la cantidad de objetivos de umbral por encima de la cual no se imprime la información de los resultados. Por lo tanto, cero causa la supresión del mensaje y MAX_INT hace que la impresión del resultado siempre se produzca. El valor predeterminado es uno.
Etiquetas:affects_outputs
--[no]subcommands
[-s
] predeterminado: "false"-
Muestra los subcomandos ejecutados durante una compilación. Marcas relacionadas: --execution_log_json_file, --execution_log_binary_file (para registrar subcomandos en un archivo en un formato compatible con herramientas)
Etiquetas:terminal_output
--test_output=<summary, errors, all or streamed>
predeterminado: “summary”-
Especifica el modo de salida deseado. Los valores válidos son "summary" para mostrar solo el resumen del estado de la prueba, "errors" para imprimir también los registros de prueba de las pruebas fallidas, "all" para imprimir los registros de todas las pruebas y "streamed" para mostrar los registros de todas las pruebas en tiempo real (esto forzará que las pruebas se ejecuten de forma local de a una a la vez, independientemente del valor de --test_strategy).
Etiquetas:test_runner
,terminal_output
,execution
- Valor predeterminado de
--test_summary=<short, terse, detailed, none or testcase>
: “short” - : Especifica el formato deseado del resumen de la prueba. Los valores válidos son "short" para imprimir información solo sobre las pruebas ejecutadas, "terse" para imprimir información solo sobre las pruebas que no se ejecutaron correctamente, "detailed" para imprimir información detallada sobre los casos de prueba fallidos, "testcase" para imprimir el resumen en la resolución de casos de prueba, no imprimir información detallada sobre los casos de prueba fallidos y "none" para omitir el resumen.
Etiquetas:terminal_output
--[no]verbose_explanations
predeterminado: “false”-
Aumenta el nivel de detalle de las explicaciones emitidas si se habilita --explain. No tiene efecto si no se habilita --explain.
Etiquetas:affects_outputs
--[no]verbose_failures
predeterminado: “false”-
Si un comando falla, imprime la línea de comandos completa.
Etiquetas:terminal_output
- Son opciones que especifican o alteran una entrada genérica en un comando de Bazel que no pertenece a otras categorías.:
- Se acumulan varios usos de
--aspects_parameters=<a 'name=value' assignment>
-
Especifica los valores de los parámetros de aspectos de la línea de comandos. Cada valor de parámetro se especifica mediante <param_name>=<param_value>, por ejemplo, "my_param=my_val", en la que "my_param" es un parámetro de algún aspecto en la lista --aspects o que es obligatorio para un aspecto de la lista. Esta opción se puede usar varias veces. Sin embargo, no se permite asignar valores al mismo parámetro más de una vez.
Etiquetas:loading_and_analysis
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
--target_pattern_file=<a string>
predeterminado: ""-
Si se establece, la compilación leerá patrones del archivo que se nombra aquí, en lugar de la línea de comandos. Es un error especificar un archivo aquí, así como patrones de línea de comandos.
Etiquetas:changes_inputs
- Opciones de almacenamiento en caché y ejecución remotas:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
--[no]experimental_guard_against_concurrent_changes
predeterminado: “false”- Desactiva esta opción para inhabilitar la verificación del ctime de los archivos de entrada de una acción antes de subirla a una caché remota. Puede haber casos en los que el kernel de Linux retrase la escritura de archivos, lo que podría generar falsos positivos.
--experimental_remote_build_event_upload=<all or minimal>
predeterminado: “all”- Si se establece en “todos”, todos los resultados locales a los que hace referencia BEP se suben a la caché remota. Si se establece en “minimal”, los resultados locales a los que hace referencia BEP no se suben a la caché remota, excepto los archivos que son importantes para los consumidores de BEP (p.ej., registros de prueba y perfil de tiempo). Se usa el esquema file:// para las rutas de acceso de los archivos locales y el esquema bytestream:// para las rutas de acceso de los archivos (ya) subidos. El valor predeterminado es “all”.
--[no]experimental_remote_cache_async
predeterminado: “false”- Si es verdadero, las operaciones de E/S de caché remota se realizarán en segundo plano en lugar de hacerlo como parte de un inicio.
--[no]experimental_remote_cache_compression
predeterminado: “false”- Si está habilitado, comprime o descomprime los blobs de caché con zstd.
--experimental_remote_capture_corrupted_outputs=<a path>
predeterminado: Consulta la descripción- Es una ruta de acceso a un directorio en el que se capturarán los resultados dañados.
--experimental_remote_downloader=<a string>
predeterminado: Consulta la descripción- Es un URI de extremo de la API de Remote Asset que se usará como proxy de descarga remoto. Los esquemas admitidos son grpc, grpcs (grpc con TLS habilitado) y unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel usará grpcs de forma predeterminada. Consulta: https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto
--[no]experimental_remote_downloader_local_fallback
predeterminado: “false”- Indica si se debe recurrir al descargador local si falla el descargador remoto.
--[no]experimental_remote_execution_keepalive
predeterminado: “false”- Indica si se debe usar el mantenimiento de la conexión para las llamadas de ejecución remotas.
--experimental_remote_grpc_log=<a path>
predeterminado: Consulta la descripción- Si se especifica, es una ruta de acceso a un archivo para registrar los detalles relacionados con las llamadas de gRPC. Este registro consta de una secuencia de protobufs serializados com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry con cada mensaje con un prefijo de varint que indica el tamaño del siguiente mensaje de protobuf serializado, como lo realiza el método LogEntry.writeDelimitedTo(OutputStream).
--[no]experimental_remote_mark_tool_inputs
predeterminado: “false”- Si se establece como verdadero, Bazel marcará las entradas como entradas de herramientas para el ejecutor remoto. Esto se puede usar para implementar trabajadores persistentes remotos.
--[no]experimental_remote_merkle_tree_cache
predeterminado: “false”- Si se establece como verdadero, los cálculos del árbol de Merkle se almacenarán en caché para mejorar la velocidad de verificación de hits de caché remotos. El espacio en memoria de la caché se controla con --experimental_remote_merkle_tree_cache_size.
--experimental_remote_merkle_tree_cache_size=<a long integer>
predeterminado: “1000”- Es la cantidad de árboles de Merkle que se deben almacenar en caché para mejorar la velocidad de verificación de aciertos de caché remotos. Aunque la caché se poda automáticamente según el manejo de referencias suaves de Java, pueden ocurrir errores de falta de memoria si se establece demasiado 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.
--[no]incompatible_remote_build_event_upload_respect_no_cache
predeterminado: “false”- Si se establece como verdadero, los resultados a los que hace referencia BEP no se suben a la caché remota si la acción de generación no se puede almacenar en caché de forma remota.
--[no]incompatible_remote_downloader_send_all_headers
predeterminado: "true"-
Indica si se deben enviar todos los valores de un encabezado con varios valores al descargador remoto en lugar de solo el primero.
Etiquetas:incompatible_change
--[no]incompatible_remote_output_paths_relative_to_input_root
predeterminado: “false”-
Si se establece como verdadero, las rutas de acceso de salida son relativas a la raíz de entrada en lugar del directorio de trabajo.
Etiquetas:incompatible_change
--[no]incompatible_remote_results_ignore_disk
predeterminado: "true"-
Si se establece como verdadero, --noremote_upload_local_results y --noremote_accept_cached no se aplicarán a la caché del disco. Si se usa una caché combinada,
--noremote_upload_local_results hará que los resultados se escriban en la caché del disco, pero no se suban a la caché remota.
--noremote_accept_cached hará que Bazel busque resultados en la caché del disco, pero no en la caché remota.
Las acciones sin ejecución remota pueden afectar la caché del disco.
Consulta #8216 para obtener más información.
Etiquetas:incompatible_change
--[no]remote_accept_cached
predeterminado: "true"- Indica si se aceptan los resultados de las acciones almacenadas en caché de forma remota.
--remote_bytestream_uri_prefix=<a string>
predeterminado: Consulta la descripción- Es el nombre de host y el nombre de la instancia que se usarán en los URIs bytestream:// que se escriben en los flujos de eventos de compilación. Esta opción se puede establecer cuando las compilaciones se realizan con un proxy, lo que hace que los valores de --remote_executor y --remote_instance_name ya no correspondan al nombre canónico del servicio de ejecución remota. Si no se establece, el valor predeterminado será “${hostname}/${instance_name}”.
--remote_cache=<a string>
predeterminado: Consulta la descripción- Es un URI de un extremo de almacenamiento en caché. Los esquemas compatibles son http, https, grpc, grpcs (grpc con TLS habilitado) y unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel usará grpcs de forma predeterminada. Especifica el esquema grpc://, http:// o unix: para inhabilitar TLS. Consulta https://bazel.build/remote/caching
- Se acumulan varios usos de
--remote_cache_header=<a 'name=value' assignment>
- Especifica un encabezado que se incluirá en las solicitudes de caché: --remote_cache_header=Nombre=Valor. Se pueden pasar varios encabezados si especificas la marca varias veces. Los múltiples valores para el mismo nombre se convertirán en una lista separada por comas.
- Se acumulan varios usos de
--remote_default_exec_properties=<a 'name=value' assignment>
-
Establece las propiedades de ejecución predeterminadas que se usarán como la plataforma de ejecución remota si una plataforma de ejecución aún no establece exec_properties.
Etiquetas:affects_outputs
--remote_default_platform_properties=<a string>
predeterminado: ""- Establece las propiedades de plataforma predeterminadas que se establecerán para la API de ejecución remota, si la plataforma de ejecución aún no establece remote_execution_properties. Este valor también se usará si se selecciona la plataforma host como la plataforma de ejecución para la ejecución remota.
- Se acumulan varios usos de
--remote_downloader_header=<a 'name=value' assignment>
- Especifica un encabezado que se incluirá en las solicitudes del descargador remoto: --remote_downloader_header=Nombre=Valor. Se pueden pasar varios encabezados si especificas la marca varias veces. Los múltiples valores para el mismo nombre se convertirán en una lista separada por comas.
- Se acumulan varios usos de
--remote_exec_header=<a 'name=value' assignment>
. - Especifica un encabezado que se incluirá en las solicitudes de ejecución: --remote_exec_header=Nombre=Valor. Se pueden pasar varios encabezados si especificas la marca varias veces. Los múltiples valores para el mismo nombre se convertirán en una lista separada por comas.
--remote_execution_priority=<an integer>
predeterminado: “0”- Es la prioridad relativa de las acciones que se ejecutarán de forma remota. La semántica de los valores de prioridad particulares depende del servidor.
--remote_executor=<a string>
predeterminado: Consulta la descripción- HOST o HOST:PORT de un extremo de ejecución remota. Los esquemas admitidos son grpc, grpcs (grpc con TLS habilitado) y unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel usará grpcs de forma predeterminada. Especifica el esquema grpc:// o unix: para inhabilitar TLS.
- Se acumulan varios usos de
--remote_header=<a 'name=value' assignment>
. - Especifica un encabezado que se incluirá en las solicitudes: --remote_header=Nombre=Valor. Se pueden pasar varios encabezados si especificas la marca varias veces. Los múltiples valores para el mismo nombre se convertirán en una lista separada por comas.
--remote_instance_name=<a string>
predeterminado: ""- Es el valor que se pasa como instance_name en la API de ejecución remota.
--[no]remote_local_fallback
predeterminado: “false”- Determina si se debe recurrir a la estrategia de ejecución local independiente si falla la ejecución remota.
--remote_local_fallback_strategy=<a string>
predeterminado: “local”- No realiza ninguna acción, está obsoleto. Consulta https://github.com/bazelbuild/bazel/issues/7480 para obtener más información.
--remote_max_connections=<an integer>
predeterminado: "100"-
Limita la cantidad máxima de conexiones simultáneas a la caché o al ejecutor remotos. De forma predeterminada, el valor es 100. Si lo estableces en 0, no habrá limitaciones.
Para la caché remota de HTTP, una conexión TCP podría controlar una solicitud a la vez, por lo que Bazel podría realizar hasta --remote_max_connections solicitudes simultáneas.
En el caso de la caché o el ejecutor remotos de gRPC, un canal de gRPC suele poder controlar más de 100 solicitudes simultáneas, por lo que Bazel podría realizar alrededor de `--remote_max_connections * 100` solicitudes simultáneas.
Etiquetas:host_machine_resource_optimizations
--remote_proxy=<a string>
predeterminado: Consulta la descripción- Conéctate a la caché remota a través de un proxy. Actualmente, esta marca solo se puede usar para configurar un socket de dominio Unix (unix:/path/to/socket).
--remote_result_cache_priority=<an integer>
predeterminado: “0”- Es la prioridad relativa de las acciones remotas que se almacenarán en la caché remota. La semántica de los valores de prioridad particulares depende del servidor.
--remote_retries=<an integer>
predeterminado: “5”- Es la cantidad máxima de intentos para reintentar un error transitorio. Si se establece en 0, se inhabilitan los reintentos.
--remote_timeout=<An immutable length of time.>
predeterminado: "60s"- Es la cantidad máxima de tiempo que se espera para la ejecución remota y las llamadas a la caché. Para la caché de REST, este es el tiempo de espera de conexión y lectura. Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
--[no]remote_upload_local_results
predeterminado: "true"- Determina si se deben subir los resultados de las acciones ejecutadas de forma local a la caché remota si esta la admite y el usuario está autorizado para hacerlo.
--[no]remote_verify_downloads
predeterminado: "true"- Si se establece como verdadero, Bazel calculará la suma de hash de todas las descargas remotas y descartará los valores almacenados en caché de forma remota si no coinciden con el valor esperado.
- Opciones misceláneas que no se clasifican de otra manera:
- Valor predeterminado de
--auto_output_filter=<none, all, packages or subpackages>
: “none” - Si no se especifica --output_filter, se usa el valor de esta opción para crear un filtro automáticamente. Los valores permitidos son "none" (no filtrar nada o mostrar todo), "all" (filtrar todo o no mostrar nada), "packages" (incluye el resultado de las reglas en los paquetes mencionados en la línea de comandos de Blaze) y "subpackages" (como "packages", pero también incluye subpaquetes). Para los valores "packages" y "subpackages", //java/foo y //javatests/foo se tratan como un solo paquete).
--[no]build_manual_tests
predeterminado: “false”- Forza la compilación de los destinos de prueba etiquetados como "manual". Las pruebas "manuales" se excluyen del procesamiento. Esta opción los obliga a compilarse (pero no a ejecutarse).
--build_tag_filters=<comma-separated list of options>
predeterminado: ""- Especifica una lista de etiquetas separadas por comas. De manera opcional, cada etiqueta puede ir precedida de "-" para especificar las etiquetas excluidas. Solo se compilarán los destinos que contengan al menos una etiqueta incluida y no contengan ninguna etiqueta excluida. Esta opción no afecta el conjunto de pruebas que se ejecutan con el comando "test", que se rigen por las opciones de filtrado de pruebas, por ejemplo, "--test_tag_filters".
--[no]build_tests_only
predeterminado: “false”- Si se especifica, solo se compilarán las reglas *_test y test_suite, y se ignorarán los otros objetivos especificados en la línea de comandos. De forma predeterminada, se compilará todo lo que se solicitó.
- Valor predeterminado de
--combined_report=<none or lcov>
: “none” - Especifica el tipo de informe de cobertura acumulativa deseado. En este momento, solo se admite LCOV.
--[no]compile_one_dependency
predeterminado: “false”- Compila una sola dependencia de los archivos de argumentos. Esto es útil para verificar la sintaxis de los archivos fuente en los IDE, por ejemplo, cuando se vuelve a compilar un solo destino que depende del archivo fuente para detectar errores lo antes posible en el ciclo de edición, compilación y prueba. Este argumento afecta la forma en que se interpretan todos los argumentos que no son de marca. En lugar de ser objetivos para compilar, son nombres de archivos de origen. Para cada nombre de archivo de origen, se compilará un destino arbitrario que depende de él.
--deleted_packages=<comma-separated list of package names>
predeterminado: ""- Es una lista separada por comas de nombres de paquetes que el sistema de compilación considerará inexistentes, incluso si son visibles en algún lugar de la ruta de acceso del paquete. Usa esta opción cuando borres un subpaquete "x/y" de un paquete existente "x". Por ejemplo, después de borrar x/y/BUILD en tu cliente, es posible que el sistema de compilación se queje si encuentra una etiqueta "//x:y/z" si otra entrada de package_path aún la proporciona. Especificar --deleted_packages x/y evita este problema.
--[no]discard_analysis_cache
predeterminado: “false”- Descarta la caché de análisis inmediatamente después de que se complete la fase de análisis. Reduce el uso de memoria en un 10% aproximadamente, pero ralentiza las compilaciones incrementales posteriores.
--disk_cache=<a path>
predeterminado: Consulta la descripción- Es una ruta de acceso a un directorio en el que Bazel puede leer y escribir acciones y resultados de acciones. Si el directorio no existe, se creará.
--embed_label=<a one-line string>
predeterminado: ""- Incorpora la revisión del control de código fuente o la etiqueta de lanzamiento en el objeto binario.
--execution_log_binary_file=<a path>
predeterminado: Consulta la descripción- Registra los inicios ejecutados en este archivo como protos de inicio delimitados, según src/main/protobuf/spawn.proto. El registro se escribe primero sin orden y, luego, al final de la invocación, se ordena en un orden estable (puede ser intensivo en CPU y memoria). Marcas relacionadas: --execution_log_json_file (formato JSON de texto ordenado), --experimental_execution_log_file (formato protobuf binario no ordenado), --subcommands (para mostrar subcomandos en el resultado de la terminal).
--execution_log_json_file=<a path>
predeterminado: Consulta la descripción- Registra los inicios ejecutados en este archivo como representación JSON de los protos de inicio delimitados, según src/main/protobuf/spawn.proto. El registro se escribe primero sin orden y, luego, al final de la invocación, se ordena en un orden estable (puede ser intensivo en CPU y memoria). Marcas relacionadas: --execution_log_binary_file (formato protobuf binario ordenado), --experimental_execution_log_file (formato protobuf binario no ordenado), --subcommands (para mostrar subcomandos en el resultado de la terminal).
--[no]expand_test_suites
predeterminado: "true"-
Expande los objetivos de test_suite en sus pruebas constituyentes antes del análisis. Cuando esta marca esté activada (la opción predeterminada), se aplicarán patrones de destino negativos a las pruebas que pertenecen al paquete de pruebas; de lo contrario, no se aplicarán. Desactivar esta marca es útil cuando se aplican aspectos de nivel superior en la línea de comandos: luego, pueden analizar los destinos de test_suite.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--experimental_credential_helper=<An (unresolved) path to a credential helper for a scope.>
- Configura los auxiliares de credenciales que se usarán para recuperar credenciales para el alcance (dominio) proporcionado. Las credenciales de los asistentes de credenciales tienen prioridad sobre las credenciales de <code>--google_default_credentials</code>, `--google_credentials` o <code>.netrc</code>. Consulta https://github.com/bazelbuild/proposals/blob/main/designs/2022-06-07-bazel-credential-helpers.md para obtener más información.
--experimental_credential_helper_cache_duration=<An immutable length of time.>
predeterminado: “30m”- Configura la duración durante la cual se almacenan en caché las credenciales de los auxiliares de credenciales. Si lo invocas con un valor diferente, se ajustará la vida útil de las entradas preexistentes. Pasa cero para borrar la caché. Un comando clean siempre borra la caché, independientemente de esta marca.
--experimental_credential_helper_timeout=<An immutable length of time.>
predeterminado: "5s"- Configura el tiempo de espera del Asistente de credenciales. Si los auxiliares de credenciales no responden dentro de este tiempo de espera, la invocación fallará.
--experimental_execution_log_file=<a path>
predeterminado: Consulta la descripción- Registra los inicios ejecutados en este archivo como protos de inicio delimitados, según src/main/protobuf/spawn.proto. Este archivo se escribe en orden de ejecución de los activadores. Marcas relacionadas: --execution_log_binary_file (formato protobuf binario ordenado), --execution_log_json_file (formato JSON de texto ordenado), --subcommands (para mostrar subcomandos en el resultado de la terminal).
--[no]experimental_execution_log_spawn_metrics
predeterminado: “false”- Incluye métricas de aparición en el registro de aparición ejecutada.
--experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
predeterminado: ""- dejó de estar disponible y se reemplazó por aspectos. Filtra el conjunto de objetivos para los que se programarán las extra_actions.
--[no]experimental_extra_action_top_level_only
predeterminado: “false”- dejó de estar disponible y se reemplazó por aspectos. Solo programa extra_actions para los objetivos de nivel superior.
--[no]experimental_prioritize_local_actions
predeterminado: "true"-
Si se establece, las acciones que solo se pueden ejecutar de forma local tienen la primera oportunidad de adquirir recursos, los trabajadores que se ejecutan de forma dinámica tienen la segunda oportunidad y las acciones independientes que se ejecutan de forma dinámica son las últimas.
Etiquetas:execution
--experimental_spawn_scheduler
-
Ejecuta acciones de forma local y remota en paralelo para habilitar la ejecución dinámica. Bazel genera cada acción de forma local y remota, y elige la que se completa primero. Si una acción admite trabajadores, la acción local se ejecutará en el modo de trabajador persistente. Para habilitar la ejecución dinámica de una mnemotecnia de acción individual, usa las marcas `--internal_spawn_scheduler` y `--strategy=<mnemonic>=dynamic`.
Se expande a:
--internal_spawn_scheduler
--spawn_strategy=dynamic
--google_auth_scopes=<comma-separated list of options>
predeterminado: "https://www.googleapis.com/auth/cloud-platform"- Es una lista separada por comas de los permisos de autenticación de Google Cloud.
--google_credentials=<a string>
predeterminado: Consulta la descripción- Especifica el archivo del que se deben obtener las credenciales de autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más información.
--[no]google_default_credentials
predeterminado: “false”- Indica si se deben usar "Credenciales predeterminadas de la aplicación de Google" para la autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más información. Está inhabilitado de forma predeterminada.
--grpc_keepalive_time=<An immutable length of time.>
predeterminado: Consulta la descripción- Configura pings de keepalive para las conexiones de gRPC salientes. Si se establece, Bazel envía pings después de este tiempo sin operaciones de lectura en la conexión, pero solo si hay al menos una llamada gRPC pendiente. Los tiempos se tratan como nivel de detalle de segundo. Es un error establecer un valor inferior a un segundo. De forma predeterminada, los pings de mantenimiento de la conexión están inhabilitados. Debes coordinar con el propietario del servicio antes de habilitar este parámetro de configuración. Por ejemplo, para establecer un valor de 30 segundos en esta marca, se debe hacer de la siguiente manera: --grpc_keepalive_time=30s
--grpc_keepalive_timeout=<An immutable length of time.>
predeterminado: "20s"- Configura un tiempo de espera de keepalive para las conexiones gRPC salientes. Si los pings de mantenimiento están habilitados con --grpc_keepalive_time, Bazel agota el tiempo de espera de una conexión si no recibe una respuesta de ping después de este tiempo. Los tiempos se tratan como nivel de detalle de segundo. Es un error establecer un valor inferior a un segundo. Si los pings de mantenimiento de la conexión están inhabilitados, se ignora este parámetro de configuración.
--[no]ignore_unsupported_sandboxing
predeterminado: “false”- No imprimas una advertencia cuando la ejecución en zona de pruebas no sea compatible con este sistema.
--[no]incompatible_dont_use_javasourceinfoprovider
predeterminado: “false”-
Etiquetas
sin acción:incompatible_change
--local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>
predeterminado: "HOST_CPUS"- Establece de forma explícita la cantidad total de núcleos de CPU locales disponibles para que Bazel los destine a las acciones de compilación que se ejecutan de forma local. Toma un número entero o "HOST_CPUS", opcionalmente seguido de [-|*]<float> (p. ej., HOST_CPUS*.5 para usar la mitad de los núcleos de CPU disponibles).De forma predeterminada ("HOST_CPUS"), Bazel consultará la configuración del sistema para estimar la cantidad de núcleos de CPU disponibles.
--local_ram_resources=<an integer, or "HOST_RAM", optionally followed by [-|*]<float>.>
predeterminado: "HOST_RAM*.67"- Establece de forma explícita la cantidad total de RAM del host local (en MB) disponible para que Bazel la invierta en acciones de compilación que se ejecuten de forma local. Toma un número entero o "HOST_RAM", seguido de forma opcional por [-|*]<float> (p. ej., HOST_RAM*.5 para usar la mitad de la RAM disponible). De forma predeterminada ("HOST_RAM*.67"), Bazel consultará la configuración del sistema para estimar la cantidad de RAM disponible y usará el 67%.
--local_termination_grace_seconds=<an integer>
predeterminado: “15”- Es el tiempo de espera entre la finalización de un proceso local debido al tiempo de espera y su cierre forzoso.
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
. - Anula un repositorio con un directorio local.
--package_path=<colon-separated list of options>
predeterminado: "%workspace%"- Es una lista separada por dos puntos de dónde buscar paquetes. Los elementos que comienzan con "%workspace%" son relativos al lugar de trabajo que los contiene. Si se omite o está vacío, el valor predeterminado es el resultado de "bazel info default-package-path".
--[no]show_loading_progress
predeterminado: "true"- Si está habilitado, hace que Bazel imprima mensajes de "Carga del paquete:".
--test_lang_filters=<comma-separated list of options>
predeterminado: ""- Especifica una lista de idiomas de prueba separados por comas. De manera opcional, cada idioma puede ir precedido de “-” para especificar los idiomas excluidos. Solo se encontrarán los objetivos de prueba que estén escritos en los idiomas especificados. El nombre que se usa para cada idioma debe ser el mismo que el prefijo de idioma en la regla *_test, p.ej., uno de "cc", "java", "py", etc. Esta opción afecta el comportamiento de --build_tests_only y el comando test.
--test_size_filters=<comma-separated list of values: small, medium, large or enormous>
predeterminado: ""- Especifica una lista de tamaños de prueba separados por comas. De manera opcional, cada tamaño puede ir precedido de "-" para especificar los tamaños excluidos. Solo se encontrarán los objetivos de prueba que contengan al menos un tamaño incluido y no contengan ningún tamaño excluido. Esta opción afecta el comportamiento de --build_tests_only y el comando test.
--test_tag_filters=<comma-separated list of options>
predeterminado: ""- Especifica una lista de etiquetas de prueba separadas por comas. De manera opcional, cada etiqueta puede ir precedida de "-" para especificar las etiquetas excluidas. Solo se encontrarán los objetivos de prueba que contengan al menos una etiqueta incluida y no contengan ninguna etiqueta excluida. Esta opción afecta el comportamiento de --build_tests_only y el comando test.
--test_timeout_filters=<comma-separated list of values: short, moderate, long or eternal>
predeterminado: ""- Especifica una lista de tiempos de espera de prueba separados por comas. De manera opcional, cada tiempo de espera puede ir precedido de "-" para especificar los tiempos de espera excluidos. Solo se encontrarán los objetivos de prueba que contengan al menos un tiempo de espera incluido y no contengan tiempos de espera excluidos. Esta opción afecta el comportamiento de --build_tests_only y el comando test.
--tls_certificate=<a string>
predeterminado: Consulta la descripción- Especifica una ruta de acceso a un certificado TLS de confianza para firmar certificados de servidor.
--tls_client_certificate=<a string>
predeterminado: Consulta la descripción- Especifica el certificado de cliente TLS que se usará. También debes proporcionar una clave de cliente para habilitar la autenticación del cliente.
--tls_client_key=<a string>
predeterminado: Consulta la descripción- Especifica la clave de cliente TLS que se usará. También debes proporcionar un certificado de cliente para habilitar la autenticación del cliente.
--workspace_status_command=<path>
predeterminado: ""- Es un comando que se invoca al comienzo de la compilación para proporcionar información de estado sobre el espacio de trabajo en forma de pares clave-valor. Consulta el manual del usuario para conocer las especificaciones completas. Consulta también tools/buildstamp/get_workspace_status para ver un ejemplo.
- Opciones que controlan la ejecución de la compilación:
--[no]check_up_to_date
predeterminado: “false”-
No realices la compilación, solo verifica si está actualizada. Si todos los destinos están actualizados, la compilación se completa correctamente. Si se debe ejecutar algún paso, se informa un error y falla la compilación.
Etiquetas:execution
--[no]experimental_inprocess_symlink_creation
predeterminado: “false”-
Determina si se deben realizar llamadas directas al sistema de archivos para crear árboles de symlinks.
Etiquetas:loading_and_analysis
,execution
,experimental
--[no]experimental_remotable_source_manifests
predeterminado: “false”-
Determina si las acciones del manifiesto de origen se pueden controlar de forma remota.
Etiquetas:loading_and_analysis
,execution
,experimental
--[no]experimental_split_coverage_postprocessing
predeterminado: “false”-
Si es verdadero, Bazel ejecutará el procesamiento posterior de la cobertura para la prueba en un nuevo inicio.
Etiquetas:execution
--[no]experimental_split_xml_generation
predeterminado: "true"-
Si se establece esta marca y una acción de prueba no genera un archivo test.xml, Bazel usa una acción independiente para generar un archivo test.xml ficticio que contiene el registro de prueba. De lo contrario, Bazel genera un test.xml como parte de la acción de prueba.
Etiquetas:execution
--[no]experimental_strict_fileset_output
predeterminado: “false”-
Si esta opción está habilitada, los conjuntos de archivos tratarán todos los artefactos de salida como archivos normales. No recorrerán directorios ni serán sensibles a los symlinks.
Etiquetas:execution
--genrule_strategy=<comma-separated list of options>
predeterminado: ""-
Especifica cómo ejecutar genrules. Esta marca se dará de baja gradualmente. En su lugar, usa --spawn_strategy=<value> para controlar todas las acciones o --strategy=Genrule=<value> para controlar solo las genrules.
Etiquetas:execution
--jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
[-j
] predeterminado: "auto"-
Es la cantidad de trabajos simultáneos que se ejecutarán. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". Los valores deben estar entre 1 y 5,000. Los valores superiores a 2,500 pueden causar problemas de memoria. "auto" calcula un valor predeterminado razonable según los recursos del host.
Etiquetas:host_machine_resource_optimizations
,execution
--[no]keep_going
[-k
] predeterminado: "false"-
Continúa tanto como sea posible después de un error. Si bien no se pueden analizar el objetivo que falló ni los que dependen de él, sí se pueden analizar otros requisitos previos de estos objetivos.
Etiquetas:eagerness_to_exit
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
predeterminado: “auto”-
Cantidad de subprocesos en paralelo que se usarán para la fase de carga o análisis. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". "auto" establece un valor predeterminado razonable según los recursos del host. Debe ser 1 como mínimo.
Etiquetas:bazel_internal_configuration
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
predeterminado: ""-
Agrega o quita claves de la información de ejecución de una acción según la mnemotecnia de la acción. Solo se aplica a las acciones que admiten información de ejecución. Muchas acciones comunes admiten información de ejecución, p.ej., Genrule, CppCompile, Javac, StarlarkAction y TestRunner. Cuando especificas varios valores, el orden es importante porque muchas regex pueden aplicarse al mismo mnemónico.
Sintaxis: "regex=[+-]clave,regex=[+-]clave,...".
Ejemplos:
'.*=+x,.*=-y,.*=+z' agrega "x" y "z" a la información de ejecución de todas las acciones y quita "y".
"Genrule=+requires-x" agrega "requires-x" a la información de ejecución de todas las acciones de Genrule.
"(?!Genrule).*=-requires-x" quita "requires-x" de la información de ejecución para todas las acciones que no sean de Genrule.
Etiquetas:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Habilita las acciones de expansión de sintaxis y dex persistentes de Android con trabajadores.
Se expande a:
--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
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_dex_desugar
-
Habilita las acciones de desugar y dex multiplexadas y persistentes de Android con trabajadores.
Se expande a:
--persistent_android_dex_desugar
--modify_execution_info=Desugar=+supports-multiplex-workers
--modify_execution_info=DexBuilder=+supports-multiplex-workers
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
Habilita el procesador de recursos de Android multiplexado persistente con trabajadores.
Se expande a:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_tools
-
Habilita las herramientas de Android persistentes y multiplexadas (dexing, expansión de sintaxis, procesamiento de recursos).
Se expande a:
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Etiquetas:host_machine_resource_optimizations
,execution
--spawn_strategy=<comma-separated list of options>
predeterminado: ""-
Especifica cómo se ejecutan las acciones de creación de forma predeterminada. Acepta una lista de estrategias separadas por comas de mayor a menor prioridad. Para cada acción, Bazel elige la estrategia con la prioridad más alta que puede ejecutar la acción. El valor predeterminado es "remote,worker,sandboxed,local". Consulta https://blog.bazel.build/2019/06/19/list-strategy.html para obtener más información.
Etiquetas:execution
- Se acumulan varios usos de
--strategy=<a '[name=]value1[,..,valueN]' assignment>
-
Especifica cómo distribuir la compilación de otras acciones de creación. Acepta una lista de estrategias separadas por comas de mayor a menor prioridad. Para cada acción, Bazel elige la estrategia con la prioridad más alta que puede ejecutar la acción. El valor predeterminado es "remote,worker,sandboxed,local". Esta marca anula los valores establecidos por --spawn_strategy (y --genrule_strategy si se usa con Genrule mnemónico). Consulta https://blog.bazel.build/2019/06/19/list-strategy.html para obtener más información.
Etiquetas:execution
- Se acumulan varios usos de
--strategy_regexp=<a '<RegexFilter>=value[,value]' assignment>
-
Anula qué estrategia de creación se debe usar para ejecutar acciones de creación que tengan descripciones que coincidan con un cierto regex_filter. Consulta --per_file_copt para obtener detalles sobre la coincidencia de regex_filter. Se usa el primer regex_filter que coincida con la descripción. Esta opción anula otras marcas para especificar la estrategia. Ejemplo: --strategy_regexp=//foo.*\.cc,-//foo/bar=local significa ejecutar acciones con la estrategia local si sus descripciones coinciden con //foo.*.cc, pero no con //foo/bar. Ejemplo: --strategy_regexp='Compiling.*/bar=local --strategy_regexp=Compiling=sandboxed ejecutará "Compiling //foo/bar/baz" con la estrategia "local", pero si se invierte el orden, se ejecutará con "sandboxed".
Etiquetas:execution
- Son opciones que configuran la cadena de herramientas que se usa para la ejecución de acciones:
--android_compiler=<a string>
predeterminado: Consulta la descripción-
El compilador de destino de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_crosstool_top=<a build target label>
predeterminado: "//external:android/crosstool"-
Es la ubicación del compilador de C++ que se usa para las compilaciones de Android.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_grte_top=<a label>
predeterminado: Consulta la descripción-
El objetivo de Android grte_top.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
predeterminado: "android"-
Selecciona el combinador de manifiestos que se usará para las reglas android_binary. Marca para ayudar a la transición a la combinación de manifiestos de Android desde la combinación heredada.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_platforms=<a build target label>
predeterminado: ""-
Establece las plataformas que usan los destinos de android_binary. Si se especifican varias plataformas, el objeto binario es un APK grueso, que contiene objetos binarios nativos para cada plataforma de destino especificada.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_sdk=<a build target label>
predeterminado: "@bazel_tools//tools/android:sdk"-
Especifica el SDK o la plataforma de Android que se usa para compilar aplicaciones para Android.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--apple_compiler=<a string>
predeterminado: Consulta la descripción-
El compilador de destino de Apple. Es útil para seleccionar variantes de una cadena de herramientas (p.ej., xcode-beta).
Etiquetas:affects_outputs
,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
--apple_grte_top=<a build target label>
predeterminado: Consulta la descripción-
El objetivo de Apple grte_top.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--cc_output_directory_tag=<a string>
predeterminado: ""-
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas:affects_outputs
,explicit_in_output_path
--compiler=<a string>
predeterminado: Consulta la descripción-
Es el compilador de C++ que se usará para compilar el destino.
Etiquetas:loading_and_analysis
,execution
--coverage_output_generator=<a build target label>
predeterminado: "@bazel_tools//tools/test:lcov_merger"-
Ubicación del binario que se usa para postprocesar informes de cobertura sin procesar. Actualmente, debe ser un grupo de archivos que contenga un solo archivo, el binario. El valor predeterminado es “//tools/test:lcov_merger”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
predeterminado: "@bazel_tools//tools/test:coverage_report_generator"-
Ubicación del binario que se usa para generar informes de cobertura. Actualmente, debe ser un grupo de archivos que contenga un solo archivo, el binario. El valor predeterminado es "//tools/test:coverage_report_generator".
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
predeterminado: "@bazel_tools//tools/test:coverage_support"-
Ubicación de los archivos de compatibilidad que se requieren en las entradas de cada acción de prueba que recopila la cobertura de código. El valor predeterminado es “//tools/test:coverage_support”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--crosstool_top=<a build target label>
predeterminado: "@bazel_tools//tools/cpp:toolchain"-
Es la etiqueta del paquete de herramientas cruzadas que se usará para compilar código C++.
Etiquetas:loading_and_analysis
,changes_inputs
,affects_outputs
--custom_malloc=<a build target label>
predeterminado: Consulta la descripción- especifica una implementación personalizada de malloc. Este parámetro de configuración anula los atributos malloc en las reglas de compilación.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan varios usos de
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
-
Es una lista de expresiones regulares separadas por comas, cada una con el prefijo - (expresión negativa) de forma opcional, asignada (=) a una lista de objetivos de valores de restricción separados por comas. Si un objetivo no coincide con ninguna expresión negativa y con al menos una expresión positiva, la resolución de la cadena de herramientas se realizará como si hubiera declarado los valores de restricción como restricciones de ejecución. Ejemplo: //demo,-test=@platforms//cpus:x86_64 agregará "x86_64" a cualquier destino de //demo, excepto a aquellos cuyo nombre contenga "test".
Etiquetas:loading_and_analysis
--[no]experimental_enable_objc_cc_deps
predeterminado: "true"- Permite que las reglas objc_* dependan de cc_library y hace que las dependencias de objc se compilen con --cpu establecido en "ios_<--ios_cpu>" para cualquier valor en --ios_multi_cpu.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]experimental_include_xcode_execution_requirements
predeterminado: “false”-
Si se establece, agrega un requisito de ejecución "requires-xcode:{version}" a cada acción de Xcode. Si la versión de Xcode tiene una etiqueta con guiones, también agrega un requisito de ejecución "requires-xcode-label:{version_label}".
Etiquetas:loses_incremental_state
,loading_and_analysis
,execution
--[no]experimental_prefer_mutual_xcode
predeterminado: "true"-
Si es verdadero, usa la versión más reciente de Xcode que esté disponible de forma local y remota. Si es falso o si no hay versiones mutuas disponibles, usa la versión local de Xcode seleccionada a través de xcode-select.
Etiquetas:loses_incremental_state
- Se acumulan varios usos de
--extra_execution_platforms=<comma-separated list of options>
-
Son las plataformas disponibles como plataformas de ejecución para ejecutar acciones. Las plataformas se pueden especificar por destino exacto o como un patrón de destino. Estas plataformas se considerarán antes de las declaradas en el archivo WORKSPACE por register_execution_platforms().
Etiquetas:execution
- Se acumulan varios usos de
--extra_toolchains=<comma-separated list of options>
-
Son las reglas de la cadena de herramientas que se deben tener en cuenta durante la resolución de la cadena de herramientas. Las cadenas de herramientas se pueden especificar por destino exacto o como un patrón de destino. Estas cadenas de herramientas se considerarán antes que las declaradas en el archivo WORKSPACE por register_toolchains().
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--grte_top=<a label>
predeterminado: Consulta la descripción-
Es una etiqueta para una biblioteca libc verificada. La cadena de herramientas de crosstool selecciona el valor predeterminado, y casi nunca es necesario anularlo.
Etiquetas:action_command_lines
,affects_outputs
--host_compiler=<a string>
predeterminado: Consulta la descripción-
Es el compilador de C++ que se usará para la compilación del host. Se ignora si no se establece --host_crosstool_top.
Etiquetas:loading_and_analysis
,execution
--host_crosstool_top=<a build target label>
predeterminado: Consulta la descripción-
De forma predeterminada, las opciones --crosstool_top y --compiler también se usan para la configuración del host. Si se proporciona esta marca, Bazel usa la libc y el compilador predeterminados para el crosstool_top determinado.
Etiquetas:loading_and_analysis
,changes_inputs
,affects_outputs
--host_grte_top=<a label>
predeterminado: Consulta la descripción-
Si se especifica, este parámetro de configuración anula el directorio de nivel superior de libc (--grte_top) para la configuración del host.
Etiquetas:action_command_lines
,affects_outputs
--host_platform=<a build target label>
predeterminado: ""-
La etiqueta de una regla de plataforma que describe el sistema host.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--[no]incompatible_disable_expand_if_all_available_in_flag_set
predeterminado: "true"-
Si es verdadero, Bazel no permitirá especificar expand_if_all_available en flag_sets(consulta https://github.com/bazelbuild/bazel/issues/7008 para obtener instrucciones de migración).
Etiquetas:loading_and_analysis
,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_android_toolchain_resolution
predeterminado: “false”-
Usa la resolución de cadena de herramientas para seleccionar el SDK de Android para las reglas de Android (Starlark y nativo)
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_apple_toolchain_resolution
predeterminado: “false”-
Usa la resolución de cadena de herramientas para seleccionar el SDK de Apple para las reglas de Apple (Starlark y nativo)
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone
predeterminado: "true"-
Si es verdadero, Bazel no reutilizará las líneas de comandos de la acción de vinculación de C++ para las líneas de comandos de indexación de lto (consulta https://github.com/bazelbuild/bazel/issues/6791 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain
predeterminado: "true"-
Si es verdadero, Bazel se quejará cuando se establezcan los atributos cc_toolchain.cpu y cc_toolchain.compiler (consulta https://github.com/bazelbuild/bazel/issues/7075 para obtener instrucciones de migración).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_legacy_whole_archive
predeterminado: "true"-
Si es verdadero, Bazel no vinculará las dependencias de la biblioteca como un archivo completo de forma predeterminada (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener instrucciones de migración).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_require_ctx_in_configure_features
predeterminado: "true"-
Si es verdadero, Bazel requerirá el parámetro "ctx" en cc_common.configure_features (consulta https://github.com/bazelbuild/bazel/issues/7793 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
-
Usa objetos compartidos de interfaz si la cadena de herramientas es compatible. Actualmente, todas las cadenas de herramientas ELF admiten este parámetro de configuración.
Etiquetas:loading_and_analysis
,affects_outputs
,affects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Especifica la versión del SDK de iOS que se usará para compilar aplicaciones para iOS. Si no se especifica, usa la versión predeterminada del SDK de iOS de "xcode_version".
Etiquetas:loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Especifica la versión del SDK de macOS que se usará para compilar aplicaciones para macOS. Si no se especifica, usa la versión predeterminada del SDK de macOS de "xcode_version".
Etiquetas:loses_incremental_state
--minimum_os_version=<a string>
predeterminado: Consulta la descripción-
Es la versión mínima del SO a la que se orienta tu compilación.
Etiquetas:loading_and_analysis
,affects_outputs
--platform_mappings=<a relative path>
predeterminado: ""-
Es la ubicación de un archivo de asignación que describe qué plataforma usar si no se establece ninguna o qué marcas establecer cuando ya existe una plataforma. Debe ser relativo a la raíz del espacio de trabajo principal. El valor predeterminado es "platform_mappings" (un archivo directamente debajo de la raíz del espacio de trabajo).
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--platforms=<a build target label>
predeterminado: ""-
Son las etiquetas de las reglas de la plataforma que describen las plataformas de destino del comando actual.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--python2_path=<a string>
predeterminado: Consulta la descripción-
Obsoleto, no realiza ninguna acción. Se inhabilitó con `--incompatible_use_python_toolchains`.
Etiquetas:no_op
,deprecated
--python3_path=<a string>
predeterminado: Consulta la descripción-
Obsoleto, no realiza ninguna acción. Se inhabilitó con `--incompatible_use_python_toolchains`.
Etiquetas:no_op
,deprecated
--python_path=<a string>
predeterminado: Consulta la descripción-
Es la ruta de acceso absoluta del intérprete de Python que se invocó para ejecutar destinos de Python en la plataforma de destino. Obsoleto; se inhabilitó con --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
--python_top=<a build target label>
predeterminado: Consulta la descripción-
La etiqueta de un py_runtime que representa el intérprete de Python invocado para ejecutar destinos de Python en la plataforma de destino. Obsoleto; se inhabilitó con --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
--target_platform_fallback=<a build target label>
predeterminado: "@local_config_platform//:host"-
Es la etiqueta de una regla de plataforma que se debe usar si no se establece una plataforma de destino y si no hay ninguna asignación de plataforma que coincida con el conjunto actual de marcas.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Especifica la versión del SDK de tvOS que se usará para compilar aplicaciones para tvOS. Si no se especifica, se usa la versión predeterminada del SDK de tvOS de "xcode_version".
Etiquetas:loses_incremental_state
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Especifica la versión del SDK de watchOS que se usará para compilar aplicaciones para watchOS. Si no se especifica, usa la versión predeterminada del SDK de watchOS de "xcode_version".
Etiquetas:loses_incremental_state
--xcode_version=<a string>
predeterminado: Consulta la descripción-
Si se especifica, usa Xcode de la versión determinada para las acciones de compilación relevantes. Si no se especifica, se usa la versión predeterminada del ejecutor de Xcode.
Etiquetas:loses_incremental_state
--xcode_version_config=<a build target label>
predeterminado: "@bazel_tools//tools/cpp:host_xcodes"-
Es la etiqueta de la regla xcode_config que se usará para seleccionar la versión de Xcode en la configuración de compilación.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Opciones que controlan el resultado del comando:
--[no]apple_enable_auto_dsym_dbg
predeterminado: “false”-
Indica si se debe forzar la generación de archivos de símbolos de depuración (.dSYM) para las compilaciones de dbg.
Etiquetas:affects_outputs
,action_command_lines
--[no]apple_generate_dsym
predeterminado: “false”-
Indica si se deben generar archivos de símbolos de depuración (.dSYM).
Etiquetas:affects_outputs
,action_command_lines
--[no]build
predeterminado: "true"-
Ejecuta la compilación. Este es el comportamiento habitual. Especificar --nobuild hace que la compilación se detenga antes de ejecutar las acciones de compilación y devuelva cero si las fases de carga y análisis del paquete se completaron correctamente. Este modo es útil para probar esas fases.
Etiquetas:execution
,affects_outputs
--[no]build_runfile_links
predeterminado: "true"-
Si es verdadero, compila bosques de symlinks de runfiles para todos los destinos. Si es falso, escribe solo manifiestos cuando sea posible.
Etiquetas:affects_outputs
--[no]build_runfile_manifests
predeterminado: "true"-
Si es verdadero, escribe manifiestos de runfiles para todos los destinos. Si es falso, omítelos. Las pruebas locales no se ejecutarán si es falso.
Etiquetas:affects_outputs
--[no]build_test_dwp
predeterminado: “false”-
Si está habilitado, cuando se compilen pruebas de C++ de forma estática y con Fission, el archivo .dwp para el objeto binario de prueba también se compilará automáticamente.
Etiquetas:loading_and_analysis
,affects_outputs
--cc_proto_library_header_suffixes=<comma-separated list of options>
predeterminado: “.pb.h”-
Establece los prefijos de los archivos de encabezado que crea una cc_proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated list of options>
predeterminado: “.pb.cc”-
Configura los prefijos de los archivos de origen que crea una cc_proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info
predeterminado: “false”-
Ejecuta acciones adicionales para versiones alternativas de la API de Java en una proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_proto_extra_actions
predeterminado: “false”-
Ejecuta acciones adicionales para versiones alternativas de la API de Java en una proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_run_validations
predeterminado: "true"-
En su lugar, usa --run_validations.
Etiquetas:execution
,affects_outputs
--[no]experimental_save_feature_state
predeterminado: “false”-
Guarda el estado de las funciones habilitadas y solicitadas como un resultado de la compilación.
Etiquetas:affects_outputs
,experimental
--[no]experimental_use_validation_aspect
predeterminado: “false”-
Indica si se deben ejecutar acciones de validación con el aspecto (para el paralelismo con las pruebas).
Etiquetas:execution
,affects_outputs
--fission=<a set of compilation modes>
predeterminado: “no”-
Especifica qué modos de compilación usan la fisión para las compilaciones y los vínculos de C++. Puede ser cualquier combinación de {'fastbuild', 'dbg', 'opt'} o los valores especiales "yes" para habilitar todos los modos y "no" para inhabilitarlos.
Etiquetas:loading_and_analysis
,action_command_lines
,affects_outputs
--[no]incompatible_always_include_files_in_data
predeterminado: "true"-
Si es verdadero, las reglas nativas agregan <code>DefaultInfo.files</code> de dependencias de datos a sus archivos de ejecución, lo que coincide con el comportamiento recomendado para las reglas de Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid).
Etiquetas:affects_outputs
,incompatible_change
--[no]legacy_external_runfiles
predeterminado: "true"-
Si es verdadero, compila bosques de symlinks de runfiles para repositorios externos en .runfiles/wsname/external/repo (además de .runfiles/repo).
Etiquetas:affects_outputs
--[no]objc_generate_linkmap
predeterminado: “false”- especifica si se debe generar un archivo de mapa de vínculos.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--output_groups=<comma-separated list of options>
-
Es una lista de nombres de grupos de salida separados por comas, cada uno de los cuales puede tener un prefijo de + o -. Un grupo con el prefijo + se agrega al conjunto predeterminado de grupos de salida, mientras que un grupo con el prefijo - se quita del conjunto predeterminado. Si no se agrega un prefijo a, al menos, un grupo, se omite el conjunto predeterminado de grupos de salida. Por ejemplo, --output_groups=+foo,+bar compila la unión del conjunto predeterminado, foo y bar, mientras que --output_groups=foo,bar anula el conjunto predeterminado de modo que solo se compilen foo y bar.
Etiquetas:execution
,affects_outputs
--[no]run_validations
predeterminado: "true"-
Indica si se deben ejecutar acciones de validación como parte de la compilación. Consulta https://bazel.build/extending/rules#validation_actions.
Etiquetas:execution
,affects_outputs
--[no]save_temps
predeterminado: “false”-
Si se establece, se guardarán los resultados temporales de gcc. Estos incluyen archivos .s (código de ensamblador), archivos .i (C procesado) y archivos .ii (C++ procesado).
Etiquetas:affects_outputs
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
- Se acumulan varios usos de
--action_env=<a 'name=value' assignment with an optional value part>
-
Especifica el conjunto de variables de entorno disponibles para las acciones con configuración de destino. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o bien por el par nombre=valor, que establece el valor independientemente del entorno de invocación. Esta opción se puede usar varias veces. En el caso de las opciones que se proporcionan para la misma variable, se aplica la más reciente, y se acumulan las opciones para diferentes variables.
Etiquetas:action_command_lines
--android_cpu=<a string>
predeterminado: "armeabi-v7a"-
La CPU objetivo de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]android_databinding_use_androidx
predeterminado: “false”-
Genera archivos de vinculación de datos compatibles con AndroidX. Esto solo se usa con la vinculación de datos v2.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]android_databinding_use_v3_4_args
predeterminado: “false”-
Usa Android Databinding v2 con el argumento 3.4.0.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--android_dynamic_mode=<off, default or fully>
predeterminado: "off"- determina si las dependencias de C++ de las reglas de Android se vincularán de forma dinámica cuando un cc_binary no cree una biblioteca compartida de forma explícita. "default" significa que bazel elegirá si vincular de forma dinámica. "Completamente" significa que todas las bibliotecas se vincularán de forma dinámica. "Desactivado" significa que todas las bibliotecas se vincularán en modo principalmente estático.
Etiquetas:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
predeterminado: "alphabetical"-
Establece el orden de los manifiestos que se pasan a la combinación de manifiestos para los objetos binarios de Android. ALPHABETICAL significa que los manifiestos se ordenan por ruta de acceso en relación con el execroot. ALPHABETICAL_BY_CONFIGURATION significa que los manifiestos se ordenan por rutas de acceso relativas al directorio de configuración dentro del directorio de salida. DEPENDENCY significa que los manifiestos se ordenan de modo que el manifiesto de cada biblioteca aparezca antes que los manifiestos de sus dependencias.
Etiquetas:action_command_lines
,execution
--[no]android_resource_shrinking
predeterminado: “false”-
Habilita la reducción de recursos para los APKs de android_binary que usan ProGuard.
Etiquetas:affects_outputs
,loading_and_analysis
- Se acumulan varios usos de
--apple_bitcode=<'mode' or 'platform=mode', where 'mode' is none, embedded_markers or embedded, and 'platform' is ios, watchos, tvos, macos or catalyst>
-
Especifica el modo de código de bits de Apple para los pasos de compilación orientados a arquitecturas de dispositivos. Los valores tienen el formato "[platform=]mode", donde la plataforma (que debe ser "ios", "macos", "tvos" o "watchos") es opcional. Si se proporciona, el modo de código de bytes se aplica específicamente para esa plataforma. Si se omite, se aplica para todas las plataformas. El modo debe ser "none", "embedded_markers" o "embedded". Esta opción se puede proporcionar varias veces.
Etiquetas:loses_incremental_state
- Se acumulan varios usos de
--aspects=<comma-separated list of options>
- Es una lista de aspectos separados por comas que se aplicarán a los objetivos de nivel superior. En la lista, si el aspecto some_aspect especifica proveedores de aspectos obligatorios a través de required_aspect_providers, some_aspect se ejecutará después de cada aspecto que se mencionó antes en la lista de aspectos cuyos proveedores anunciados satisfacen los proveedores de aspectos obligatorios de some_aspect. Además, some_aspect se ejecutará después de todos sus aspectos obligatorios especificados por el atributo requires. Luego, some_aspect tendrá acceso a los valores de los proveedores de esos aspectos. <bzl-file-label>%<aspect_name>, por ejemplo, '//tools:my_def.bzl%my_aspect', donde "my_aspect" es un valor de nivel superior de un archivo tools/my_def.bzl
--[no]build_python_zip
predeterminado: “auto”-
Compila el archivo ZIP ejecutable de Python; activado en Windows, desactivado en otras plataformas.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--catalyst_cpus=<comma-separated list of options>
-
Es una lista de arquitecturas separadas por comas para las que se compilarán los objetos binarios de Apple Catalyst.
Etiquetas:loses_incremental_state
,loading_and_analysis
--[no]collect_code_coverage
predeterminado: “false”-
Si se especifica, Bazel instrumentará el código (con instrumentación sin conexión siempre que sea posible) y recopilará información de cobertura durante las pruebas. Solo se verán afectados los destinos que coincidan con --instrumentation_filter. Por lo general, esta opción no debe especificarse directamente, sino que se debe usar el comando "bazel coverage".
Etiquetas:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] predeterminado: "fastbuild"-
Especifica el modo en el que se compilará el objeto binario. Valores: "fastbuild", "dbg", "opt".
Etiquetas:affects_outputs
,action_command_lines
,explicit_in_output_path
- Se acumulan varios usos de
--conlyopt=<a string>
-
Opción adicional para pasar a gcc cuando se compilan archivos de origen C.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--copt=<a string>
- Opciones adicionales para pasar a gcc.
Etiquetas:action_command_lines
,affects_outputs
--cpu=<a string>
predeterminado: ""-
La CPU objetivo.
Etiquetas:changes_inputs
,affects_outputs
,explicit_in_output_path
--cs_fdo_absolute_path=<a string>
predeterminado: Consulta la descripción-
Usa la información del perfil de CSFDO para optimizar la compilación. Especifica el nombre de la ruta de acceso absoluta del archivo ZIP que contiene el archivo de perfil, un archivo de perfil LLVM sin procesar o indexado.
Etiquetas:affects_outputs
--cs_fdo_instrument=<a string>
predeterminado: Consulta la descripción-
Genera ejecutables con instrumentación de FDO sensible al contexto. Con el compilador Clang/LLVM, también acepta el nombre del directorio en el que se volcarán los archivos de perfil sin procesar durante el tiempo de ejecución.
Etiquetas:affects_outputs
--cs_fdo_profile=<a build target label>
predeterminado: Consulta la descripción-
El cs_fdo_profile que representa el perfil sensible al contexto que se usará para la optimización.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--cxxopt=<a string>
-
Opción adicional para pasar a gcc cuando se compilan archivos de origen C++.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--define=<a 'name=value' assignment>
-
Cada opción --define especifica una asignación para una variable de compilación.
Etiquetas:changes_inputs
,affects_outputs
--dynamic_mode=<off, default or fully>
predeterminado: "predeterminado"- determina si los objetos binarios de C++ se vincularán de forma dinámica. "default" significa que Bazel elegirá si vincular de forma dinámica. "Completamente" significa que todas las bibliotecas se vincularán de forma dinámica. "Desactivado" significa que todas las bibliotecas se vincularán en modo principalmente estático.
Etiquetas:loading_and_analysis
,affects_outputs
--[no]enable_fdo_profile_absolute_path
predeterminado: "true"-
Si se establece, el uso de fdo_absolute_profile_path generará un error.
Etiquetas:affects_outputs
--[no]enable_runfiles
predeterminado: “auto”-
Habilita el árbol de symlinks de runfiles. De forma predeterminada, está desactivado en Windows y en otras plataformas.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--experimental_action_listener=<a build target label>
- dejó de estar disponible y se reemplazó por aspectos. Usa action_listener para adjuntar un extra_action a las acciones de compilación existentes.
Etiquetas:execution
,experimental
--[no]experimental_android_compress_java_resources
predeterminado: “false”-
Comprime recursos de Java en APKs
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_android_databinding_v2
predeterminado: “false”-
Usa Android Databinding v2
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_android_resource_shrinking
predeterminado: “false”-
Habilita la reducción de recursos para los APKs de android_binary que usan ProGuard.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_android_rewrite_dexes_with_rex
predeterminado: “false”-
Usa la herramienta rex para volver a escribir archivos dex.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_convenience_symlinks
predeterminado: "normal"-
Esta marca controla cómo se administrarán los symlinks de conveniencia (los symlinks que aparecen en el lugar de trabajo después de la compilación). Valores posibles:
normal (predeterminado): Se creará o borrará cada tipo de symlink de conveniencia, según lo determine la compilación.
clean: Se borrarán todos los symlinks sin condiciones.
ignore: Los symlinks no se modificarán.
log_only: Genera mensajes de registro como si se pasara "normal", pero no realiza ninguna operación del sistema de archivos (útil para herramientas).
Ten en cuenta que solo se pueden ver afectados los symlinks cuyos nombres genera el valor actual de --symlink_prefix. Si cambia el prefijo, no se modificarán los symlinks preexistentes.
Etiquetas:affects_outputs
--[no]experimental_convenience_symlinks_bep_event
predeterminado: “false”-
Esta marca controla si publicaremos o no el evento de compilación ConvenienceSymlinksIdentified en BuildEventProtocol. Si el valor es verdadero, BuildEventProtocol tendrá una entrada para convenienceSymlinksIdentified, en la que se enumerarán todos los symlinks de conveniencia creados en tu lugar de trabajo. Si es falso, la entrada convenienceSymlinksIdentified en BuildEventProtocol estará vacía.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--experimental_multi_cpu=<comma-separated list of options>
-
Obsoleto. No realiza ninguna acción.
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 objc fastbuild.
Etiquetas:action_command_lines
--[no]experimental_omitfp
predeterminado: “false”-
Si es verdadero, usa libunwind para el desenredo de pila y compila con -fomit-frame-pointer y -fasynchronous-unwind-tables.
Etiquetas:action_command_lines
,affects_outputs
,experimental
--[no]experimental_platform_in_output_dir
predeterminado: “false”-
Si es verdadero, la plataforma de destino se usa en el nombre del directorio de salida en lugar de la CPU.
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
--fat_apk_cpu=<comma-separated list of options>
predeterminado: "armeabi-v7a"-
Si configuras esta opción, se habilitan los APKs multiarquitectura, que contienen objetos binarios nativos para todas las arquitecturas de destino especificadas, p.ej., --fat_apk_cpu=x86,armeabi-v7a. Si se especifica esta marca, se ignora --android_cpu para las dependencias de las reglas android_binary.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]fat_apk_hwasan
predeterminado: “false”-
Indica si se deben crear divisiones HWASAN.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--fdo_instrument=<a string>
predeterminado: Consulta la descripción-
Genera ejecutables con la instrumentación de FDO. Con el compilador Clang/LLVM, también acepta el nombre del directorio en el que se volcarán los archivos de perfil sin procesar durante el tiempo de ejecución.
Etiquetas:affects_outputs
--fdo_optimize=<a string>
predeterminado: Consulta la descripción-
Usa la información del perfil de FDO para optimizar la compilación. Especifica el nombre de un archivo ZIP que contenga un árbol de archivos .gcda, un archivo afdo que contenga un perfil automático o un archivo de perfil de LLVM. Esta marca también acepta archivos especificados como etiquetas (p.ej., "//foo/bar:file.afdo"; es posible que debas agregar una directiva "exports_files" al paquete correspondiente) y etiquetas que apuntan a destinos "fdo_profile". La regla "fdo_profile" reemplazará esta marca.
Etiquetas:affects_outputs
--fdo_prefetch_hints=<a build target label>
predeterminado: Consulta la descripción-
Usa sugerencias de almacenamiento en caché para la carga previa.
Etiquetas:affects_outputs
--fdo_profile=<a build target label>
predeterminado: Consulta la descripción-
Es el fdo_profile que representa el perfil que se usará para la optimización.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--features=<a string>
-
Las funciones determinadas se habilitarán o inhabilitarán de forma predeterminada para todos los paquetes. Si especificas -<feature>, se inhabilitará la función de forma global. Los atributos negativos siempre anulan los positivos. Esta marca se usa para habilitar el lanzamiento de cambios de funciones predeterminados sin una versión de Bazel.
Etiquetas:changes_inputs
,affects_outputs
--[no]force_pic
predeterminado: “false”-
Si está habilitada, todas las compilaciones de C++ producen código independiente de la posición ("-fPIC"), las vinculaciones prefieren las bibliotecas compiladas previamente de PIC en lugar de las bibliotecas que no son de PIC, y las vinculaciones producen ejecutables independientes de la posición ("-pie").
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan varios usos de
--host_action_env=<a 'name=value' assignment with an optional value part>
. -
Especifica el conjunto de variables de entorno disponibles para las acciones con configuraciones de host o ejecución. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o bien por el par nombre=valor, que establece el valor independientemente del entorno de invocación. Esta opción se puede usar varias veces. En el caso de las opciones que se proporcionan para la misma variable, se aplica la más reciente, y se acumulan las opciones para diferentes variables.
Etiquetas:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
predeterminado: "opt"-
Especifica el modo en el que se compilarán las herramientas que se usan durante la compilación. Valores: "fastbuild", "dbg", "opt".
Etiquetas:affects_outputs
,action_command_lines
- Se acumulan varios usos de
--host_conlyopt=<a string>
-
Opción adicional para pasar a gcc cuando se compilan archivos de origen C para herramientas de host.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--host_copt=<a string>
. -
Opciones adicionales para pasar a gcc para herramientas de host.
Etiquetas:action_command_lines
,affects_outputs
--host_cpu=<a string>
predeterminado: ""-
La CPU del host.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan varios usos de
--host_cxxopt=<a string>
-
Opciones adicionales para pasar a gcc para herramientas de host.
Etiquetas:action_command_lines
,affects_outputs
--host_force_python=<PY2 or PY3>
predeterminado: Consulta la descripción-
Anula la versión de Python para la configuración del host. Puede ser “PY2” o “PY3”.
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan varios usos de
--host_linkopt=<a string>
. - : Opción adicional para pasar a gcc cuando se vinculan herramientas de host.
Etiquetas:action_command_lines
,affects_outputs
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Versión mínima compatible de macOS para los destinos de host. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan varios usos de
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
-
Opciones adicionales para pasar de forma selectiva al compilador C/C++ cuando se compilan ciertos archivos en las configuraciones del host o de ejecución. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. En la que regex_filter representa una lista de patrones de expresiones regulares para incluir y excluir (consulta también --instrumentation_filter). option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe estar entre comillas con una barra diagonal inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos de gcc de todos los archivos cc en //foo/, excepto bar.cc.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--host_swiftcopt=<a string>
-
Opciones adicionales para pasar a swiftc para herramientas de host.
Etiquetas:action_command_lines
,affects_outputs
--[no]incompatible_avoid_conflict_dlls
predeterminado: "true"-
Si se habilita, se cambiará el nombre de todas las bibliotecas de vínculos dinámicos (DLL) de C++ que genera cc_library en Windows a name_{hash}.dll, donde el hash se calcula en función de RepositoryName y la ruta de acceso del paquete de la DLL. Esta opción es útil cuando tienes un paquete que depende de varias cc_library con el mismo nombre (p. ej., //foo/bar1:utils y //foo/bar2:utils).
Etiquetas:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_merge_genfiles_directory
predeterminado: "true"-
Si es verdadero, el directorio genfiles se une al directorio bin.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_use_platforms_repo_for_constraints
predeterminado: "true"-
Si es verdadero, se quita la configuración de restricciones de @bazel_tools.
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 establece, se instrumentan las reglas de prueba que incluye --instrumentation_filter. De lo contrario, las reglas de prueba siempre se excluyen de la instrumentación de cobertura.
Etiquetas:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
predeterminado: "-/javatests[/:],-/test/java[/:]"-
Cuando la cobertura esté habilitada, solo se instrumentarán las reglas con nombres incluidos en el filtro basado en regex especificado. En su lugar, se excluyen las reglas con el prefijo “-”. Ten en cuenta que solo se instrumentan las reglas que no son de prueba, a menos que se habilite --instrument_test_targets.
Etiquetas:affects_outputs
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Versión mínima de iOS compatible para los simuladores y dispositivos de destino. Si no se especifica, se usa "ios_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan varios usos de
--ios_multi_cpus=<comma-separated list of options>
-
Es una lista de arquitecturas separadas por comas con las que se compila una ios_application. El resultado es un binario universal que contiene todas las arquitecturas especificadas.
Etiquetas:loses_incremental_state
,loading_and_analysis
--[no]legacy_whole_archive
predeterminado: "true"-
Deja de estar disponible y se reemplaza por --incompatible_remove_legacy_whole_archive (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener más información). Cuando está activado, usa --whole-archive para las reglas cc_binary que tienen linkshared=True y linkstatic=True o “-static” en linkopts. Esto es solo para la retrocompatibilidad. Una mejor alternativa es usar alwayslink=1 cuando sea necesario.
Etiquetas:action_command_lines
,affects_outputs
,deprecated
- Se acumulan varios usos de
--linkopt=<a string>
- : Opción adicional para pasar a gcc cuando se realiza la vinculación.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--ltobackendopt=<a string>
-
Opción adicional para pasar al paso de backend de LTO (en --features=thin_lto).
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--ltoindexopt=<a string>
-
Opción adicional para pasar al paso de indexación de LTO (en --features=thin_lto).
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--macos_cpus=<comma-separated list of options>
-
Es una lista separada por comas de las arquitecturas para las que se compilarán los objetos binarios de Apple macOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Versión mínima de macOS compatible para los destinos. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
--[no]objc_debug_with_GLIBCXX
predeterminado: “false”-
Si se establece y el modo de compilación se establece en "dbg", define GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC y GLIBCPP_CONCEPT_CHECKS.
Etiquetas:action_command_lines
--[no]objc_enable_binary_stripping
predeterminado: “false”-
Indica si se deben quitar símbolos y código inactivo en objetos binarios vinculados. Se realizarán eliminaciones de objetos binarios si se especifican esta marca y --compilation_mode=opt.
Etiquetas:action_command_lines
- Se acumulan varios usos de
--objccopt=<a string>
-
Opciones adicionales para pasar a gcc cuando se compilan archivos de origen Objective-C/C++.
Etiquetas:action_command_lines
- Se acumulan varios usos de
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
-
Opciones adicionales para pasar de forma selectiva a gcc cuando se compilan ciertos archivos. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. En la que regex_filter representa una lista de patrones de expresiones regulares para incluir y excluir (consulta también --instrumentation_filter). option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe estar entre comillas con una barra diagonal inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos de gcc de todos los archivos cc en //foo/, excepto bar.cc.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
-
Opciones adicionales para pasar de forma selectiva al backend de LTO (en --features=thin_lto) cuando se compilan ciertos objetos de backend. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. En la que regex_filter representa una lista de patrones de expresión regular para incluir y excluir. option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe estar entre comillas con una barra diagonal inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos del backend de LTO de todos los archivos o en //foo/, excepto bar.o.
Etiquetas:action_command_lines
,affects_outputs
--platform_suffix=<a string>
predeterminado: Consulta la descripción-
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas:loses_incremental_state
,affects_outputs
,loading_and_analysis
--propeller_optimize=<a build target label>
predeterminado: Consulta la descripción-
Usa la información del perfil de Propeller para optimizar el destino de compilación.Un perfil de Propeller debe constar de al menos uno de dos archivos: un perfil de cc y un perfil de ld. Esta marca acepta una etiqueta de compilación que debe hacer referencia a los archivos de entrada del perfil de Propeller. Por ejemplo, el archivo BUILD que define la etiqueta, en a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)Es posible que se deba agregar una directiva exports_files al paquete correspondiente para que Bazel pueda ver estos archivos. La opción se debe usar de la siguiente manera: --propeller_optimize=//a/b:propeller_profile
Etiquetas:action_command_lines
,affects_outputs
--propeller_optimize_absolute_cc_profile=<a string>
predeterminado: Consulta la descripción-
Nombre de ruta de acceso absoluta del archivo cc_profile para compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
predeterminado: Consulta la descripción-
Es el nombre de ruta de acceso absoluto del archivo ld_profile para las compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
--run_under=<a prefix in front of command>
predeterminado: Consulta la descripción-
Es el prefijo que se inserta antes de los ejecutables para los comandos "test" y "run". Si el valor es "foo -bar" y la línea de comandos de ejecución es "test_binary -baz", la línea de comandos final es "foo -bar test_binary -baz".También puede ser una etiqueta para un destino ejecutable. Algunos ejemplos son: "valgrind", "strace", "strace -c", "valgrind --quiet --num-callers=20", "//package:target", "//package:target --options".
Etiquetas:action_command_lines
-
Si es verdadero, las bibliotecas nativas que contienen funcionalidad idéntica se compartirán entre diferentes destinos.
Etiquetas:loading_and_analysis
,affects_outputs
--[no]stamp
predeterminado: “false”-
Marca los objetos binarios con la fecha, el nombre de usuario, el nombre de host, la información del espacio de trabajo, etcétera.
Etiquetas:affects_outputs
- Valor predeterminado de
--strip=<always, sometimes or never>
: “sometimes” - especifica si se deben quitar los objetos binarios y las bibliotecas compartidas (con "-Wl,--strip-debug"). El valor predeterminado de "sometimes" significa quitar si --compilation_mode=fastbuild.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--stripopt=<a string>
-
Opciones adicionales para pasar a la eliminación cuando se genera un objeto binario "<name>.stripped".
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--swiftcopt=<a string>
. -
Opciones adicionales para pasar a la compilación de Swift.
Etiquetas:action_command_lines
--symlink_prefix=<a string>
predeterminado: Consulta la descripción-
Es el prefijo que se agrega a cualquiera de los symlinks de conveniencia que se crean después de una compilación. Si se omite, el valor predeterminado es el nombre de la herramienta de compilación seguido de un guion. Si se pasa “/”, no se crean symlinks ni se emite ninguna advertencia. Advertencia: La funcionalidad especial para "/" dejará de estar disponible pronto. En su lugar, usa --experimental_convenience_symlinks=ignore.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--tvos_cpus=<comma-separated list of options>
-
Es una lista separada por comas de las arquitecturas para las que se compilarán los objetos binarios de Apple tvOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Versión mínima compatible de tvOS para los simuladores y dispositivos de destino. Si no se especifica, se usa "tvos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan varios usos de
--watchos_cpus=<comma-separated list of options>
. -
Es una lista separada por comas de las arquitecturas para las que se compilarán los objetos binarios de Apple watchOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Versión mínima compatible de watchOS para los simuladores y dispositivos de destino. Si no se especifica, se usa "watchos_sdk_version".
Etiquetas:loses_incremental_state
--xbinary_fdo=<a build target label>
predeterminado: Consulta la descripción-
Usa la información del perfil de XbinaryFDO para optimizar la compilación. Especifica el nombre del perfil binario cruzado predeterminado. Cuando la opción se usa junto con --fdo_instrument/--fdo_optimize/--fdo_profile, esas opciones siempre prevalecerán como si xbinary_fdo nunca se especificara.
Etiquetas:affects_outputs
- Opciones que afectan la rigurosidad con la que Bazel aplica entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etc.):
--auto_cpu_environment_group=<a build target label>
predeterminado: ""-
Declara el environment_group que se usará para asignar automáticamente los valores de CPU a los valores de target_environment.
Etiquetas:changes_inputs
,loading_and_analysis
,experimental
--[no]check_licenses
predeterminado: “false”-
Verifica que las restricciones de licencias que imponen los paquetes dependientes no entren en conflicto con los modos de distribución de los destinos que se compilan. De forma predeterminada, no se verifican las licencias.
Etiquetas:build_file_semantics
--[no]check_visibility
predeterminado: "true"-
Si se inhabilita, los errores de visibilidad en las dependencias de destino se degradan a advertencias.
Etiquetas:build_file_semantics
--[no]desugar_for_android
predeterminado: "true"-
Indica si se debe expandir el código de bytes de Java 8 antes de dexificarlo.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]desugar_java8_libs
predeterminado: “false”-
Indica si se deben incluir bibliotecas Java 8 compatibles en apps para dispositivos heredados.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]enforce_constraints
predeterminado: "true"-
Verifica los entornos con los que es compatible cada objetivo y, luego, informa errores si alguno tiene dependencias que no admiten los mismos entornos.
Etiquetas:build_file_semantics
--[no]experimental_allow_android_library_deps_without_srcs
predeterminado: “false”-
Es una marca que ayuda a realizar la transición de permitir a no permitir reglas de android_library sin srcs con dependencias. Se debe limpiar el depósito para lanzarlo de forma predeterminada.
Etiquetas:eagerness_to_exit
,loading_and_analysis
--[no]experimental_check_desugar_deps
predeterminado: "true"-
Determina si se debe volver a verificar la expansión correcta a nivel binario de Android.
Etiquetas:eagerness_to_exit
,loading_and_analysis
,experimental
--experimental_import_deps_checking=<off, warning or error>
predeterminado: “OFF”-
Cuando está habilitado, verifica si las dependencias de una aar_import están completas. Esta aplicación forzosa puede interrumpir la compilación o generar advertencias.
Etiquetas:loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
predeterminado: "predeterminado"-
Si es verdadero, verifica que un destino de Java declare explícitamente todos los destinos utilizados directamente como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files
predeterminado: “false”-
Si está habilitado, busca el atributo testonly de la regla de generación para verificar si hay destinos de requisitos previos que sean archivos de salida. Esto coincide con la verificación de visibilidad.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_disable_native_android_rules
predeterminado: “false”-
Si se habilita, se inhabilita el uso directo de las reglas nativas de Android. Usa las reglas de Android de Starlark de https://github.com/bazelbuild/rules_android.
Etiquetas:eagerness_to_exit
,incompatible_change
--[no]incompatible_disable_native_apple_binary_rule
predeterminado: “false”-
No realiza ninguna acción. Se mantiene aquí para la retrocompatibilidad.
Etiquetas:eagerness_to_exit
,incompatible_change
--[no]incompatible_force_strict_header_check_from_starlark
predeterminado: "true"-
Si está habilitada, establece una verificación estricta de encabezados en la API de Starlark.
Etiquetas:loading_and_analysis
,changes_inputs
,incompatible_change
--[no]incompatible_validate_top_level_header_inclusions
predeterminado: "true"-
Si es verdadero, Bazel también validará las inclusiones de encabezados de directorio de nivel superior (consulta https://github.com/bazelbuild/bazel/issues/10047 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]strict_filesets
predeterminado: “false”-
Si esta opción está habilitada, los conjuntos de archivos que cruzan los límites de los paquetes se informan como errores. No funciona cuando check_fileset_dependencies_recursively está inhabilitada.
Etiquetas:build_file_semantics
,eagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default>
predeterminado: "error"-
A menos que esté desactivado, comprueba que un destino de proto_library declare de forma explícita todos los destinos utilizados directamente como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
--strict_public_imports=<off, warn, error, strict or default>
predeterminado: "off"-
A menos que esté desactivado, comprueba que un objetivo de proto_library declare de forma explícita todos los objetivos que se usan en "import public" como exportados.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
--[no]strict_system_includes
predeterminado: “false”-
Si es verdadero, también se deben declarar los encabezados que se encuentran a través de las rutas de inclusión del sistema (-isystem).
Etiquetas:loading_and_analysis
,eagerness_to_exit
- Se acumulan varios usos de
--target_environment=<a build target label>
-
Declara el entorno de destino de esta compilación. Debe ser una referencia de etiqueta a una regla de "entorno". Si se especifican, todos los destinos de nivel superior deben ser compatibles con este entorno.
Etiquetas:changes_inputs
- Opciones que afectan los resultados de firma de una compilación:
--apk_signing_method=<v1, v2, v1_v2 or v4>
predeterminado: “v1_v2”-
Implementación que se usará para firmar APKs
Etiquetas:action_command_lines
,affects_outputs
,loading_and_analysis
--[no]device_debug_entitlements
predeterminado: "true"-
Si se establece y el modo de compilación no es "opt", las apps de objc incluirán derechos de depuración cuando se firmen.
Etiquetas:changes_inputs
--ios_signing_cert_name=<a string>
predeterminado: Consulta la descripción-
Es el nombre del certificado que se usará para la firma de iOS. Si no se establece, se usará el perfil de aprovisionamiento. Puede ser la preferencia de identidad del llavero del certificado o la substring del nombre común del certificado, según la página de man de codesign (IDENTIDADES DE FIRMA).
Etiquetas:action_command_lines
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility
predeterminado: “false”-
Si incompatible_enforce_config_setting_visibility=false, esto es una operación no realizada. De lo contrario, si esta marca es falsa, cualquier config_setting sin un atributo de visibilidad explícito es //visibility:public. Si esta marca es verdadera, config_setting sigue la misma lógica de visibilidad que todas las demás reglas. Consulta https://github.com/bazelbuild/bazel/issues/12933.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_legacy_py_provider
predeterminado: "true"-
No se realizará ninguna acción, se quitará pronto.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
predeterminado: "true"-
Si es verdadero, aplica las restricciones de visibilidad de config_setting. Si es falso, todos los config_setting son visibles para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones que rigen el comportamiento del entorno de prueba o del ejecutor de pruebas:
--[no]allow_analysis_failures
predeterminado: “false”-
Si es verdadero, una falla de análisis de un objetivo de regla genera la propagación del objetivo de una instancia de AnalysisFailureInfo que contiene la descripción del error, en lugar de generar una falla de compilación.
Etiquetas:loading_and_analysis
,experimental
--analysis_testing_deps_limit=<an integer>
predeterminado: “2000”-
Establece la cantidad máxima de dependencias transitivas a través de un atributo de regla con una transición de configuración for_analysis_testing. Si se supera este límite, se mostrará un error de regla.
Etiquetas:loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure
predeterminado: “false”-
Si es verdadero, las fallas de la acción de dex2oat causarán que la compilación falle en lugar de ejecutar dex2oat durante el tiempo de ejecución de la prueba.
Etiquetas:loading_and_analysis
,experimental
--[no]check_tests_up_to_date
predeterminado: “false”-
No ejecutes pruebas, solo verifica si están actualizadas. Si todos los resultados de las pruebas están actualizados, la prueba se completa correctamente. Si se debe compilar o ejecutar alguna prueba, se informa un error y la prueba falla. Esta opción implica el comportamiento de --check_up_to_date.
Etiquetas:execution
--[no]experimental_android_use_parallel_dex2oat
predeterminado: “false”-
Usa dex2oat en paralelo para acelerar android_test.
Etiquetas:loading_and_analysis
,host_machine_resource_optimizations
,experimental
- Se acumulan varios usos de
--flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once>
-
Cada prueba se reintentará hasta la cantidad especificada de veces en caso de que falle. Las pruebas que requirieron más de un intento para aprobar se marcan como "FLAKY" en el resumen de la prueba. Por lo general, el valor especificado es solo un número entero o la cadena "default". Si es un número entero, todas las pruebas se ejecutarán hasta N veces. Si es "default", solo se realizará un intento de prueba para las pruebas normales y tres para las pruebas marcadas explícitamente como inestables por su regla (atributo flaky=1). Sintaxis alternativa: regex_filter@flaky_test_attempts. En el que flaky_test_attempts es como se indicó anteriormente y regex_filter representa una lista de patrones de expresiones regulares para incluir y excluir (consulta también --runs_per_test). Ejemplo: --flaky_test_attempts=//foo/.*,-//foo/bar/.*@3 corrige todas las pruebas en //foo/, excepto las que se encuentran en foo/bar, tres veces. Esta opción se puede pasar varias veces. El argumento pasado más recientemente que coincida tiene prioridad. Si no hay coincidencias, el comportamiento es como el de "default" anterior.
Etiquetas:execution
--[no]ios_memleaks
predeterminado: “false”-
Habilita la verificación de fugas de memoria en los destinos de ios_test.
Etiquetas:action_command_lines
--ios_simulator_device=<a string>
predeterminado: Consulta la descripción-
Es el dispositivo que se simula cuando se ejecuta una aplicación para iOS en el simulador, p.ej., "iPhone 6". Para obtener una lista de dispositivos, ejecuta "xcrun simctl list devicetypes" en la máquina en la que se ejecutará el simulador.
Etiquetas:test_runner
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Es la versión de iOS que se ejecutará en el simulador durante la ejecución o las pruebas. Esto se ignora para las reglas ios_test si se especifica un dispositivo de destino en la regla.
Etiquetas:test_runner
--local_test_jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
predeterminado: “auto”-
Es la cantidad máxima de trabajos de prueba locales que se ejecutarán de forma simultánea. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". 0 significa que los recursos locales limitarán la cantidad de trabajos de prueba locales que se ejecutarán de forma simultánea. Establecer este valor por encima del valor de --jobs no es eficaz.
Etiquetas:execution
- Se acumulan varios usos de
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
- especifica la cantidad de veces que se debe ejecutar cada prueba. Si alguno de esos intentos falla por algún motivo, se considera que toda la prueba falló. Por lo general, el valor especificado es solo un número entero. Ejemplo: --runs_per_test=3 ejecutará todas las pruebas 3 veces. Sintaxis alternativa: regex_filter@runs_per_test. En la que runs_per_test representa un valor entero y regex_filter representa una lista de patrones de expresiones regulares para incluir y excluir (consulta también --instrumentation_filter). Ejemplo: --runs_per_test=//foo/.*,-//foo/bar/.*@3 ejecuta todas las pruebas en //foo/, excepto las que se encuentran en foo/bar, tres veces. Esta opción se puede pasar varias veces. El argumento pasado más recientemente que coincida tiene prioridad. Si no hay coincidencias, la prueba solo se ejecuta una vez.
- Se acumulan varios usos de
--test_env=<a 'name=value' assignment with an optional value part>
-
Especifica variables de entorno adicionales que se insertarán en el entorno del ejecutor de pruebas. Las variables se pueden especificar por nombre, en cuyo caso su valor se leerá del entorno del cliente de Bazel, o bien por el par nombre=valor. Esta opción se puede usar varias veces para especificar varias variables. Solo lo usa el comando "bazel test".
Etiquetas:test_runner
--[no]test_keep_going
predeterminado: "true"-
Cuando se inhabilita, cualquier prueba que no se apruebe hará que se detenga toda la compilación. De forma predeterminada, se ejecutan todas las pruebas, incluso si algunas no se aprueban.
Etiquetas:execution
--test_strategy=<a string>
predeterminado: ""-
Especifica qué estrategia usar cuando se ejecutan pruebas.
Etiquetas:execution
--test_timeout=<a single integer or comma-separated list of 4 integers>
predeterminado: “-1”- Anula los valores predeterminados de tiempo de espera de las pruebas (en segundos). Si se especifica un solo valor de número entero positivo, se anularán todas las categorías. Si se especifican 4 números enteros separados por comas, se anularán los tiempos de espera para corto, moderado, largo y eterno (en ese orden). De cualquier forma, un valor de -1 le indica a blaze que use sus tiempos de espera predeterminados para esa categoría.
--test_tmpdir=<a path>
predeterminado: Consulta la descripción- Especifica el directorio temporal base que usará "bazel test".
--tvos_simulator_device=<a string>
predeterminado: Consulta la descripción-
Es el dispositivo que se simula cuando se ejecuta una aplicación para tvOS en el simulador, p.ej., "Apple TV 1080p". Para obtener una lista de dispositivos, ejecuta "xcrun simctl list devicetypes" en la máquina en la que se ejecutará el simulador.
Etiquetas:test_runner
--tvos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Es la versión de tvOS que se ejecutará en el simulador cuando se ejecute o pruebe.
Etiquetas:test_runner
--watchos_simulator_device=<a string>
predeterminado: Consulta la descripción-
Es el dispositivo que se simula cuando se ejecuta una aplicación para watchOS en el simulador, p.ej., "Apple Watch - 38 mm". Para obtener una lista de dispositivos, ejecuta "xcrun simctl list devicetypes" en la máquina en la que se ejecutará el simulador.
Etiquetas:test_runner
--watchos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
La versión de watchOS que se ejecutará en el simulador cuando se ejecute o pruebe.
Etiquetas:test_runner
--[no]zip_undeclared_test_outputs
predeterminado: "true"-
Si es verdadero, los resultados de las pruebas no declaradas se archivarán en un archivo ZIP.
Etiquetas:test_runner
- Opciones que activan optimizaciones del tiempo de compilación:
--[no]collapse_duplicate_defines
predeterminado: “false”-
Cuando se habilita, se quitarán los --defines redundantes al principio de la compilación. Esto evita la pérdida innecesaria de la caché de análisis para ciertos tipos de compilaciones equivalentes.
Etiquetas:loading_and_analysis
,loses_incremental_state
--[no]experimental_filter_library_jar_with_program_jar
predeterminado: “false”-
Filtra el ProgramJar de ProGuard para quitar las clases que también estén presentes en el LibraryJar.
Etiquetas:action_command_lines
--[no]experimental_inmemory_dotd_files
predeterminado: "true"-
Si se habilita, los archivos .d de C++ se pasarán en la memoria directamente desde los nodos de compilación remotos en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_inmemory_jdeps_files
predeterminado: "true"-
Si está habilitado, los archivos de dependencia (.jdeps) generados a partir de compilaciones de Java se pasarán en la memoria directamente desde los nodos de compilación remotos en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_objc_include_scanning
predeterminado: “false”-
Indica si se debe incluir el análisis de C/C++ objetivo.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
--[no]experimental_parse_headers_skipped_if_corresponding_srcs_found
predeterminado: “false”-
Si está habilitada, la función parse_headers no crea una acción de compilación de encabezados independiente si se encuentra una fuente con el mismo nombre de base en el mismo destino.
Etiquetas:loading_and_analysis
,affects_outputs
--[no]experimental_retain_test_configuration_across_testonly
predeterminado: “false”-
Cuando se habilita, --trim_test_configuration no recortará la configuración de prueba de las reglas marcadas como testonly=1. Esto se hace para reducir los problemas de conflicto de acciones cuando las reglas que no son de prueba dependen de las reglas de cc_test. No tiene efecto si --trim_test_configuration es falso.
Etiquetas:loading_and_analysis
,loses_incremental_state
--[no]experimental_starlark_cc_import
predeterminado: “false”-
Si está habilitada, se puede usar la versión de Starlark de cc_import.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_unsupported_and_brittle_include_scanning
predeterminado: “false”-
Determina si se deben reducir las entradas a la compilación de C/C++ a través del análisis de líneas #include de los archivos de entrada. Esto puede mejorar el rendimiento y la incrementalidad, ya que reduce el tamaño de los árboles de entrada de compilación. Sin embargo, también puede interrumpir las compilaciones porque el escáner de inclusión no implementa por completo la semántica del preprocesador C. En particular, no comprende las directivas #include dinámicas y omite la lógica condicional del preprocesador. Úsala bajo tu propia responsabilidad. Se cerrarán todos los problemas relacionados con esta marca que se hayan presentado.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
--[no]incremental_dexing
predeterminado: "true"-
Realiza la mayor parte del trabajo de dexing por separado para cada archivo JAR.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]objc_use_dotd_pruning
predeterminado: "true"-
Si se establece, los archivos .d emitidos por clang se usarán para podar el conjunto de entradas que se pasan a las compilaciones de objc.
Etiquetas:changes_inputs
,loading_and_analysis
--[no]process_headers_in_dependencies
predeterminado: “false”-
Cuando compilas un destino //a:a, procesa los encabezados en todos los destinos de los que depende //a:a (si el procesamiento de encabezados está habilitado para la cadena de herramientas).
Etiquetas:execution
--[no]trim_test_configuration
predeterminado: "true"-
Cuando se habilita, se borran las opciones relacionadas con las pruebas debajo del nivel superior de la compilación. Cuando esta marca está activa, las pruebas no se pueden compilar como dependencias de reglas que no son de prueba, pero los cambios en las opciones relacionadas con las pruebas no harán que se vuelvan a analizar las reglas que no son de prueba.
Etiquetas:loading_and_analysis
,loses_incremental_state
--[no]use_singlejar_apkbuilder
predeterminado: "true"-
Esta opción está obsoleta. Ahora no se puede usar y se quitará pronto.
Etiquetas:loading_and_analysis
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]announce
predeterminado: “false”-
Obsoleto. No realiza ninguna acción.
Etiquetas:affects_outputs
--[no]experimental_bep_target_summary
predeterminado: “false”- Determina si se deben publicar eventos TargetSummary.
--[no]experimental_build_event_expand_filesets
predeterminado: “false”-
Si es verdadero, expande los conjuntos de archivos en el BEP cuando se presenten los archivos de salida.
Etiquetas:affects_outputs
--[no]experimental_build_event_fully_resolve_fileset_symlinks
predeterminado: “false”-
Si es verdadero, resuelve completamente los symlinks de conjuntos de archivos relativos en el BEP cuando se presentan archivos de salida. Requiere --experimental_build_event_expand_filesets.
Etiquetas:affects_outputs
--experimental_build_event_upload_max_retries=<an integer>
predeterminado: “4”-
Es la cantidad máxima de veces que Bazel debe volver a intentar subir un evento de compilación.
Etiquetas:bazel_internal_configuration
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
predeterminado: "1s"-
Retraso inicial mínimo para los reintentos de retirada exponencial cuando falla la carga de BEP. (exponente: 1.6)
Etiquetas:bazel_internal_configuration
--experimental_build_event_upload_strategy=<a string>
predeterminado: Consulta la descripción-
Selecciona cómo subir artefactos a los que se hace referencia en el protocolo del evento de compilación.
Etiquetas:affects_outputs
--[no]experimental_materialize_param_files_directly
predeterminado: “false”-
Si materializas archivos de parámetros, hazlo con operaciones de escritura directa en el disco.
Etiquetas:execution
--[no]experimental_stream_log_file_uploads
predeterminado: “false”-
El archivo de registro de transmisión se sube directamente al almacenamiento remoto en lugar de escribirlo en el disco.
Etiquetas:affects_outputs
--explain=<a path>
predeterminado: Consulta la descripción-
Hace que el sistema de compilación explique cada paso ejecutado de la compilación. La explicación se escribe en el archivo de registro especificado.
Etiquetas:affects_outputs
--[no]legacy_important_outputs
predeterminado: "true"-
Usa esto para suprimir la generación del campo important_outputs heredado en el evento TargetComplete. important_outputs es obligatorio para la integración de Bazel en ResultStore.
Etiquetas:affects_outputs
--[no]materialize_param_files
predeterminado: “false”-
Escribe archivos de parámetros intermedios en el árbol de salida, incluso cuando se usa la ejecución de acciones remotas. Es útil cuando se depuran acciones. Esto se infiere de --subcommands y --verbose_failures.
Etiquetas:execution
--max_config_changes_to_show=<an integer>
predeterminado: “3”-
Cuando se descarta la caché de análisis debido a un cambio en las opciones de compilación, se muestra hasta la cantidad determinada de nombres de opciones modificados. Si el número que se proporciona es -1, se mostrarán todas las opciones modificadas.
Etiquetas:terminal_output
--max_test_output_bytes=<an integer>
predeterminado: “-1”-
Especifica el tamaño máximo de registro por prueba que se puede emitir cuando --test_output es "errors" o "all". Es útil para evitar que el resultado se vea abrumado por un resultado de prueba con demasiado ruido. El encabezado de prueba se incluye en el tamaño del registro. Los valores negativos implican que no hay límite. El resultado es todo o nada.
Etiquetas:test_runner
,terminal_output
,execution
--output_filter=<a valid Java regular expression>
predeterminado: Consulta la descripción-
Solo muestra advertencias para las reglas con un nombre que coincide con la expresión regular proporcionada.
Etiquetas:affects_outputs
--progress_report_interval=<an integer in 0-3600 range>
predeterminado: “0”-
Es la cantidad de segundos que se deben esperar entre los informes de los trabajos que aún se están ejecutando. El valor predeterminado 0 significa que el primer informe se imprimirá después de 10 segundos, luego de 30 segundos y, después de ese progreso, se informará una vez por minuto. Cuando se habilita --curses, el progreso se informa cada segundo.
Etiquetas:affects_outputs
--show_result=<an integer>
predeterminado: “1”-
Muestra los resultados de la compilación. Para cada objetivo, indica si se actualizó o no y, de ser así, una lista de los archivos de salida que se compilaron. Los archivos impresos son cadenas convenientes para copiar y pegar en la shell y ejecutarlas.
Esta opción requiere un argumento de número entero, que es la cantidad de objetivos de umbral por encima de la cual no se imprime la información de los resultados. Por lo tanto, cero causa la supresión del mensaje y MAX_INT hace que la impresión del resultado siempre se produzca. El valor predeterminado es uno.
Etiquetas:affects_outputs
--[no]subcommands
[-s
] predeterminado: "false"-
Muestra los subcomandos ejecutados durante una compilación. Marcas relacionadas: --execution_log_json_file, --execution_log_binary_file (para registrar subcomandos en un archivo en un formato compatible con herramientas)
Etiquetas:terminal_output
--test_output=<summary, errors, all or streamed>
predeterminado: “summary”-
Especifica el modo de salida deseado. Los valores válidos son "summary" para mostrar solo el resumen del estado de la prueba, "errors" para imprimir también los registros de prueba de las pruebas fallidas, "all" para imprimir los registros de todas las pruebas y "streamed" para mostrar los registros de todas las pruebas en tiempo real (esto forzará que las pruebas se ejecuten de forma local de a una a la vez, independientemente del valor de --test_strategy).
Etiquetas:test_runner
,terminal_output
,execution
- Valor predeterminado de
--test_summary=<short, terse, detailed, none or testcase>
: “short” - : Especifica el formato deseado del resumen de la prueba. Los valores válidos son "short" para imprimir información solo sobre las pruebas ejecutadas, "terse" para imprimir información solo sobre las pruebas que no se ejecutaron correctamente, "detailed" para imprimir información detallada sobre los casos de prueba fallidos, "testcase" para imprimir el resumen en la resolución de casos de prueba, no imprimir información detallada sobre los casos de prueba fallidos y "none" para omitir el resumen.
Etiquetas:terminal_output
- Valor predeterminado de
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: “-.*”. -
Imprime información de depuración durante la resolución de la cadena de herramientas. La marca toma una regex, que se compara con los tipos de cadena de herramientas y los objetivos específicos para ver cuál depurar. Se pueden separar varias regex con comas y, luego, cada una se verifica por separado. Nota: El resultado de esta marca es muy complejo y es probable que solo sea útil para expertos en la resolución de cadenas de herramientas.
Etiquetas:terminal_output
--[no]verbose_explanations
predeterminado: “false”-
Aumenta el nivel de detalle de las explicaciones emitidas si se habilita --explain. No tiene efecto si no se habilita --explain.
Etiquetas:affects_outputs
--[no]verbose_failures
predeterminado: “false”-
Si un comando falla, imprime la línea de comandos completa.
Etiquetas:terminal_output
- Son opciones que especifican o alteran una entrada genérica en un comando de Bazel que no pertenece a otras categorías.:
- Se acumulan varios usos de
--aspects_parameters=<a 'name=value' assignment>
. -
Especifica los valores de los parámetros de aspectos de la línea de comandos. Cada valor de parámetro se especifica mediante <param_name>=<param_value>, por ejemplo, "my_param=my_val", en la que "my_param" es un parámetro de algún aspecto en la lista --aspects o que es obligatorio para un aspecto de la lista. Esta opción se puede usar varias veces. Sin embargo, no se permite asignar valores al mismo parámetro más de una vez.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--flag_alias=<a 'name=value' flag alias>
-
Establece un nombre abreviado para una marca de Starlark. Toma un solo par clave-valor en el formato "<clave>=<valor>" como argumento.
Etiquetas:changes_inputs
--[no]incompatible_default_to_explicit_init_py
predeterminado: “false”-
Esta marca cambia el comportamiento predeterminado para que los archivos __init__.py ya no se creen automáticamente en los archivos de ejecución de los destinos de Python. Específicamente, cuando un objetivo py_binary o py_test tiene legacy_create_init establecido en "auto" (el valor predeterminado), se considera falso solo si se establece esta marca. Consulta https://github.com/bazelbuild/bazel/issues/10076.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_py2_outputs_are_suffixed
predeterminado: "true"-
Si es verdadero, los destinos compilados en la configuración de Python 2 aparecerán en una raíz de salida que incluye el sufijo “-py2”, mientras que los destinos compilados para Python 3 aparecerán en una raíz sin sufijo relacionado con Python. Esto significa que el symlink de conveniencia "bazel-bin" apuntará a destinos de Python 3 en lugar de Python 2. Si habilitas esta opción, también se recomienda habilitar `--incompatible_py3_is_default`.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_py3_is_default
predeterminado: "true"-
Si es verdadero, los destinos "py_binary" y "py_test" que no establezcan su atributo "python_version" (o "default_python_version") usarán PY3 de forma predeterminada en lugar de PY2. Si estableces esta marca, también se recomienda establecer `--incompatible_py2_outputs_are_suffixed`.
Etiquetas:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_use_python_toolchains
predeterminado: "true"-
Si se establece como verdadero, las reglas ejecutables de Python nativas usarán el entorno de ejecución de Python especificado por la cadena de herramientas de Python, en lugar del entorno de ejecución que proporcionan las marcas heredadas, como --python_top.
Etiquetas:loading_and_analysis
,incompatible_change
--python_version=<PY2 or PY3>
predeterminado: Consulta la descripción-
Es el modo de versión principal de Python, ya sea "PY2" o "PY3". Ten en cuenta que esto se anula con los destinos "py_binary" y "py_test" (incluso si no especifican una versión de forma explícita), por lo que, por lo general, no hay muchos motivos para proporcionar esta marca.
Etiquetas:loading_and_analysis
,affects_outputs
,explicit_in_output_path
--target_pattern_file=<a string>
predeterminado: ""-
Si se establece, la compilación leerá patrones del archivo que se nombra aquí, en lugar de la línea de comandos. Es un error especificar un archivo aquí, así como patrones de línea de comandos.
Etiquetas:changes_inputs
- Opciones misceláneas que no se clasifican de otra manera:
--[no]build_manual_tests
predeterminado: “false”- Forza la compilación de los destinos de prueba etiquetados como "manual". Las pruebas "manuales" se excluyen del procesamiento. Esta opción los obliga a compilarse (pero no a ejecutarse).
--build_tag_filters=<comma-separated list of options>
predeterminado: ""- Especifica una lista de etiquetas separadas por comas. De manera opcional, cada etiqueta puede ir precedida de "-" para especificar las etiquetas excluidas. Solo se compilarán los destinos que contengan al menos una etiqueta incluida y no contengan ninguna etiqueta excluida. Esta opción no afecta el conjunto de pruebas que se ejecutan con el comando "test", que se rigen por las opciones de filtrado de pruebas, por ejemplo, "--test_tag_filters".
--[no]build_tests_only
predeterminado: “false”- Si se especifica, solo se compilarán las reglas *_test y test_suite, y se ignorarán los otros objetivos especificados en la línea de comandos. De forma predeterminada, se compilará todo lo que se solicitó.
--[no]cache_test_results
[-t
] predeterminado: "auto"- Si se establece en “auto”, Bazel vuelve a ejecutar una prueba solo si se cumplen las siguientes condiciones: (1) Bazel detecta cambios en la prueba o sus dependencias, (2) la prueba está marcada como externa, (3) se solicitaron varias ejecuciones de prueba con --runs_per_test o(4) la prueba falló anteriormente. Si se establece como "yes", Bazel almacena en caché todos los resultados de las pruebas, excepto las marcadas como externas. Si se establece en "no", Bazel no almacena en caché ningún resultado de la prueba.
--[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, cuando se vuelve a compilar un solo destino que depende del archivo fuente para detectar errores lo antes posible en el ciclo de edición, compilación y prueba. Este argumento afecta la forma en que se interpretan todos los argumentos que no son de marca. En lugar de ser objetivos para compilar, son nombres de archivos de origen. Para cada nombre de archivo de origen, se compilará un destino arbitrario que depende de él.
--deleted_packages=<comma-separated list of package names>
predeterminado: ""- Es una lista separada por comas de nombres de paquetes que el sistema de compilación considerará inexistentes, incluso si son visibles en algún lugar de la ruta de acceso del paquete. Usa esta opción cuando borres un subpaquete "x/y" de un paquete existente "x". Por ejemplo, después de borrar x/y/BUILD en tu cliente, es posible que el sistema de compilación se queje si encuentra una etiqueta "//x:y/z" si otra entrada de package_path aún la proporciona. Especificar --deleted_packages x/y evita este problema.
--[no]discard_analysis_cache
predeterminado: “false”- Descarta la caché de análisis inmediatamente después de que se complete la fase de análisis. Reduce el uso de memoria en un 10% aproximadamente, pero ralentiza las compilaciones incrementales posteriores.
--execution_log_binary_file=<a path>
predeterminado: Consulta la descripción- Registra los inicios ejecutados en este archivo como protos de inicio delimitados, según src/main/protobuf/spawn.proto. El registro se escribe primero sin orden y, luego, al final de la invocación, se ordena en un orden estable (puede ser intensivo en CPU y memoria). Marcas relacionadas: --execution_log_json_file (formato JSON de texto ordenado), --experimental_execution_log_file (formato protobuf binario no ordenado), --subcommands (para mostrar subcomandos en el resultado de la terminal).
--execution_log_json_file=<a path>
predeterminado: Consulta la descripción- Registra los inicios ejecutados en este archivo como representación JSON de los protos de inicio delimitados, según src/main/protobuf/spawn.proto. El registro se escribe primero sin orden y, luego, al final de la invocación, se ordena en un orden estable (puede ser intensivo en CPU y memoria). Marcas relacionadas: --execution_log_binary_file (formato protobuf binario ordenado), --experimental_execution_log_file (formato protobuf binario no ordenado), --subcommands (para mostrar subcomandos en el resultado de la terminal).
--[no]expand_test_suites
predeterminado: "true"-
Expande los objetivos de test_suite en sus pruebas constituyentes antes del análisis. Cuando esta marca esté activada (la opción predeterminada), se aplicarán patrones de destino negativos a las pruebas que pertenecen al paquete de pruebas; de lo contrario, no se aplicarán. Desactivar esta marca es útil cuando se aplican aspectos de nivel superior en la línea de comandos: luego, pueden analizar los destinos de test_suite.
Etiquetas:loading_and_analysis
--[no]experimental_cancel_concurrent_tests
predeterminado: “false”-
Si es verdadero, Blaze cancelará las pruebas que se ejecutan de forma simultánea en la primera ejecución correcta. Esto solo es útil en combinación con --runs_per_test_detects_flakes.
Etiquetas:affects_outputs
,loading_and_analysis
--experimental_execution_log_file=<a path>
predeterminado: Consulta la descripción- Registra los inicios ejecutados en este archivo como protos de inicio delimitados, según src/main/protobuf/spawn.proto. Este archivo se escribe en orden de ejecución de los activadores. Marcas relacionadas: --execution_log_binary_file (formato protobuf binario ordenado), --execution_log_json_file (formato JSON de texto ordenado), --subcommands (para mostrar subcomandos en el resultado de la terminal).
--[no]experimental_execution_log_spawn_metrics
predeterminado: “false”- Incluye métricas de aparición en el registro de aparición ejecutada.
--experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
predeterminado: ""- dejó de estar disponible y se reemplazó por aspectos. Filtra el conjunto de objetivos para los que se programarán las extra_actions.
--[no]experimental_extra_action_top_level_only
predeterminado: “false”- dejó de estar disponible y se reemplazó por aspectos. Solo programa extra_actions para los objetivos de nivel superior.
--[no]experimental_fetch_all_coverage_outputs
predeterminado: “false”-
Si es verdadero, Bazel recupera todo el directorio de datos de cobertura para cada prueba durante una ejecución de cobertura.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_generate_llvm_lcov
predeterminado: “false”-
Si es verdadero, la cobertura de clang generará un informe LCOV.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_j2objc_header_map
predeterminado: "true"- Determina si se debe generar un mapa de encabezados de J2ObjC en paralelo con la transpilación de J2ObjC.
--[no]experimental_j2objc_shorter_header_path
predeterminado: “false”-
Indica si se debe generar con una ruta de encabezado más corta (usa “_ios” en lugar de “_j2objc”).
Etiquetas:affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
predeterminado: "javabuilder"- Habilita classpaths reducidos para compilaciones de Java.
--[no]experimental_limit_android_lint_to_android_constrained_java
predeterminado: “false”-
Limita --experimental_run_android_lint_on_java_rules a las bibliotecas compatibles con Android.
Etiquetas:affects_outputs
--[no]experimental_prioritize_local_actions
predeterminado: "true"-
Si se establece, las acciones que solo se pueden ejecutar de forma local tienen la primera oportunidad de adquirir recursos, los trabajadores que se ejecutan de forma dinámica tienen la segunda oportunidad y las acciones independientes que se ejecutan de forma dinámica son las últimas.
Etiquetas:execution
--[no]experimental_run_android_lint_on_java_rules
predeterminado: “false”-
Determina si se deben validar las fuentes java_*.
Etiquetas:affects_outputs
--[no]explicit_java_test_deps
predeterminado: “false”- Especifica de forma explícita una dependencia a JUnit o Hamcrest en un java_test en lugar de obtenerla accidentalmente de las dependencias de TestRunner. Por el momento, solo funciona para bazel.
--host_java_launcher=<a build target label>
predeterminado: Consulta la descripción- Es el selector de Java que usan las herramientas que se ejecutan durante una compilación.
- Se acumulan varios usos de
--host_javacopt=<a string>
- Opciones adicionales para pasar a javac cuando se compilan herramientas que se ejecutan durante una compilación.
- Se acumulan varios usos de
--host_jvmopt=<a string>
- Opciones adicionales para pasar a la VM de Java cuando se compilan herramientas que se ejecutan durante la compilación. Estas opciones se agregarán a las opciones de inicio de la VM de cada destino java_binary.
--[no]incompatible_exclusive_test_sandboxed
predeterminado: “false”-
Si es verdadero, las pruebas exclusivas se ejecutarán con la estrategia de zona de pruebas. Agrega la etiqueta "local" para forzar que se ejecute una prueba exclusiva de forma local.
Etiquetas:incompatible_change
--[no]incompatible_strict_action_env
predeterminado: “false”-
Si es verdadero, Bazel usa un entorno con un valor estático para PATH y no hereda LD_LIBRARY_PATH. Usa --action_env=ENV_VARIABLE si deseas heredar variables de entorno específicas del cliente, pero ten en cuenta que, de esta manera, se puede evitar la caché entre usuarios si se usa una caché compartida.
Etiquetas:loading_and_analysis
,incompatible_change
- Se acumulan varios usos de
--j2objc_translation_flags=<comma-separated list of options>
- : Opciones adicionales para pasar a la herramienta J2ObjC.
--java_debug
-
Hace que la máquina virtual de Java de una prueba de Java espere una conexión de un depurador compatible con JDWP (como jdb) antes de iniciar la prueba. Implica -test_output=streamed.
Se expande a:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
--[no]java_deps
predeterminado: "true"- Genera información de dependencia (por ahora, el classpath del tiempo de compilación) por destino de Java.
--[no]java_header_compilation
predeterminado: "true"- Compila ijars directamente desde la fuente.
--java_language_version=<a string>
predeterminado: “8”- La versión del lenguaje Java
--java_launcher=<a build target label>
predeterminado: Consulta la descripción- Es el selector de Java que se usará cuando se compilen objetos binarios de Java. Si esta marca se establece en la cadena vacía, se usa el selector de JDK. El atributo "launcher" anula esta marca.
--java_runtime_version=<a string>
predeterminado: "local_jdk"- La versión del entorno de ejecución de Java
- Se acumulan varios usos de
--javacopt=<a string>
- Opciones adicionales para pasar a javac.
- Se acumulan varios usos de
--jvmopt=<a string>
- Opciones adicionales para pasar a la VM de Java. Estas opciones se agregarán a las opciones de inicio de la VM de cada destino java_binary.
--legacy_main_dex_list_generator=<a build target label>
predeterminado: Consulta la descripción- especifica un objeto binario que se usará para generar la lista de clases que deben estar en el archivo DEX principal cuando se compila el multidex heredado.
--local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>
predeterminado: "HOST_CPUS"- Establece de forma explícita la cantidad total de núcleos de CPU locales disponibles para que Bazel los destine a las acciones de compilación que se ejecutan de forma local. Toma un número entero o "HOST_CPUS", opcionalmente seguido de [-|*]<float> (p. ej., HOST_CPUS*.5 para usar la mitad de los núcleos de CPU disponibles).De forma predeterminada ("HOST_CPUS"), Bazel consultará la configuración del sistema para estimar la cantidad de núcleos de CPU disponibles.
--local_ram_resources=<an integer, or "HOST_RAM", optionally followed by [-|*]<float>.>
predeterminado: "HOST_RAM*.67"- Establece de forma explícita la cantidad total de RAM del host local (en MB) disponible para que Bazel la invierta en acciones de compilación que se ejecuten de forma local. Toma un número entero o "HOST_RAM", seguido de forma opcional por [-|*]<float> (p. ej., HOST_RAM*.5 para usar la mitad de la RAM disponible). De forma predeterminada ("HOST_RAM*.67"), Bazel consultará la configuración del sistema para estimar la cantidad de RAM disponible y usará el 67%.
--local_termination_grace_seconds=<an integer>
predeterminado: “15”- Es el tiempo de espera entre la finalización de un proceso local debido al tiempo de espera y su cierre forzoso.
--package_path=<colon-separated list of options>
predeterminado: "%workspace%"- Es una lista separada por dos puntos de los lugares donde buscar paquetes. Los elementos que comienzan con "%workspace%" son relativos al lugar de trabajo que los contiene. Si se omite o está vacío, el valor predeterminado es el resultado de "bazel info default-package-path".
- Se acumulan varios usos de
--plugin=<a build target label>
- Plug-ins para usar en la compilación. Actualmente, funciona con java_plugin.
--proguard_top=<a build target label>
predeterminado: Consulta la descripción- Especifica qué versión de ProGuard se usará para quitar el código cuando se compila un objeto binario de Java.
--proto_compiler=<a build target label>
predeterminado: "@bazel_tools//tools/proto:protoc"-
Es la etiqueta del protocompilador.
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
predeterminado: "@bazel_tools//tools/proto:cc_toolchain"-
Etiqueta de proto_lang_toolchain(), que describe cómo compilar protos de C++
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
predeterminado: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"-
Etiqueta de proto_lang_toolchain(), que describe cómo compilar protos de j2objc
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
predeterminado: "@bazel_tools//tools/proto:java_toolchain"-
Etiqueta de proto_lang_toolchain(), que describe cómo compilar protos de Java
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
predeterminado: "@bazel_tools//tools/proto:javalite_toolchain"-
Etiqueta de proto_lang_toolchain(), que describe cómo compilar protos de JavaLite
Etiquetas:affects_outputs
,loading_and_analysis
- Se acumulan varios usos de
--protocopt=<a string>
-
Opciones adicionales para pasar al compilador de protobuf.
Etiquetas:affects_outputs
--[no]runs_per_test_detects_flakes
predeterminado: “false”- Si es verdadero, cualquier fragmento en el que se apruebe al menos una ejecución o intento y falle al menos una ejecución o intento tendrá el estado FLAKY.
--shell_executable=<a path>
predeterminado: Consulta la descripción-
Ruta de acceso absoluta al ejecutable de shell que usará Bazel. Si no se establece, pero la variable de entorno BAZEL_SH se establece en la primera invocación de Bazel (que inicia un servidor de Bazel), Bazel la usará. Si no se establece ninguno, Bazel usa una ruta de acceso predeterminada fija según el sistema operativo en el que se ejecuta (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, todos los demás: /bin/bash). Ten en cuenta que usar un shell que no sea compatible con bash puede generar fallas de compilación o de tiempo de ejecución de los objetos binarios generados.
Etiquetas:loading_and_analysis
--[no]show_loading_progress
predeterminado: "true"- Si está habilitado, hace que Bazel imprima mensajes de “Carga del paquete:”.
- Se acumulan varios usos de
--test_arg=<a string>
. - Especifica opciones y argumentos adicionales que se deben pasar al ejecutable de prueba. Se puede usar varias veces para especificar varios argumentos. Si se ejecutan varias pruebas, cada una de ellas recibirá argumentos idénticos. Solo lo usa el comando "bazel test".
--test_filter=<a string>
predeterminado: Consulta la descripción- : Especifica un filtro para reenviar al framework de pruebas. Se usa para limitar las pruebas que se ejecutan. Ten en cuenta que esto no afecta los destinos que se compilan.
--test_lang_filters=<comma-separated list of options>
predeterminado: ""- Especifica una lista de idiomas de prueba separados por comas. De manera opcional, cada idioma puede ir precedido de “-” para especificar los idiomas excluidos. Solo se encontrarán los objetivos de prueba que estén escritos en los idiomas especificados. El nombre que se usa para cada idioma debe ser el mismo que el prefijo de idioma en la regla *_test, p.ej., uno de "cc", "java", "py", etc. Esta opción afecta el comportamiento de --build_tests_only y el comando test.
--test_result_expiration=<an integer>
predeterminado: “-1”- Esta opción está obsoleta y no tiene ningún efecto.
--[no]test_runner_fail_fast
predeterminado: “false”- Redirecciona la opción de falla rápida al ejecutor de pruebas. El ejecutor de pruebas debe detener la ejecución en la primera falla.
--test_sharding_strategy=<explicit or disabled>
predeterminado: "explicit"- Especifica la estrategia para el fragmentación de prueba: "explicit" para usar solo la fragmentación si está presente el atributo BUILD "shard_count". "disabled" para nunca usar el fragmentación de prueba.
--test_size_filters=<comma-separated list of values: small, medium, large or enormous>
predeterminado: ""- Especifica una lista de tamaños de prueba separados por comas. De manera opcional, cada tamaño puede ir precedido de "-" para especificar los tamaños excluidos. Solo se encontrarán los objetivos de prueba que contengan al menos un tamaño incluido y no contengan ningún tamaño excluido. Esta opción afecta el comportamiento de --build_tests_only y el comando test.
--test_tag_filters=<comma-separated list of options>
predeterminado: ""- Especifica una lista de etiquetas de prueba separadas por comas. De manera opcional, cada etiqueta puede ir precedida de "-" para especificar las etiquetas excluidas. Solo se encontrarán los objetivos de prueba que contengan al menos una etiqueta incluida y no contengan ninguna etiqueta excluida. Esta opción afecta el comportamiento de --build_tests_only y el comando test.
--test_timeout_filters=<comma-separated list of values: short, moderate, long or eternal>
predeterminado: ""- Especifica una lista de tiempos de espera de prueba separados por comas. De manera opcional, cada tiempo de espera puede ir precedido de "-" para especificar los tiempos de espera excluidos. Solo se encontrarán los objetivos de prueba que contengan al menos un tiempo de espera incluido y no contengan tiempos de espera excluidos. Esta opción afecta el comportamiento de --build_tests_only y el comando test.
--tool_java_language_version=<a string>
predeterminado: “8”- La versión del lenguaje Java que se usa para ejecutar las herramientas necesarias durante una compilación
--tool_java_runtime_version=<a string>
predeterminado: "remotejdk_11"- La versión del entorno de ejecución de Java que se usa para ejecutar herramientas durante la compilación
--[no]use_ijars
predeterminado: "true"- Si está habilitada, esta opción hace que la compilación de Java use archivos JAR de interfaz. Esto generará una compilación incremental más rápida, pero los mensajes de error pueden ser diferentes.
Opciones de canonicalize-flags
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
-
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
predeterminado: “false”-
Si es verdadero, usa una cadena derivada de las URLs de las descargas del repositorio como canonical_id si no se especifica. Esto hace que un cambio en las URLs genere una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no provoquen que la caché oculte los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
predeterminado: “false”-
Si se establece, no se permite descargar repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, los repositorios externos pueden funcionar en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que controlan el resultado del comando:
--[no]canonicalize_policy
predeterminado: “false”-
Muestra la política canónica después de la expansión y el filtrado. Para mantener el resultado limpio, NO se mostrarán los argumentos de comando canonizados cuando esta opción se establezca como verdadera. Ten en cuenta que el comando especificado por --for_command afecta a la política filtrada y, si no se especifica ninguno, el comando predeterminado es "build".
Etiquetas:affects_outputs
,terminal_output
--[no]show_warnings
predeterminado: “false”-
Envía advertencias del analizador de salida al error estándar (p.ej., para opciones de marcas en conflicto).
Etiquetas:affects_outputs
,terminal_output
- Opciones que afectan la rigurosidad con la que Bazel aplica entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
--experimental_repository_hash_file=<a string>
predeterminado: ""-
Si no está vacío, especifica un archivo que contiene un valor resuelto, con el que se deben verificar los valores hash del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan varios usos de
--experimental_verify_repository_rules=<a string>
-
Si es una lista de reglas de repositorio para las que se debe verificar el hash del directorio de salida, siempre que se especifique un archivo con --experimental_repository_hash_file.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: "true"-
Etiquetas de
sin operación:no_op
,deprecated
,experimental
--[no]incompatible_config_setting_private_default_visibility
predeterminado: “false”-
Si incompatible_enforce_config_setting_visibility=false, esto es una operación no realizada. De lo contrario, si esta marca es falsa, cualquier config_setting sin un atributo de visibilidad explícito es //visibility:public. Si esta marca es verdadera, config_setting sigue la misma lógica de visibilidad que todas las demás reglas. Consulta https://github.com/bazelbuild/bazel/issues/12933.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
predeterminado: "true"-
Si es verdadero, aplica las restricciones de visibilidad de config_setting. Si es falso, todos los config_setting son visibles para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
-
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitados en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "advertencia" -
Verifica si las dependencias directas de "bazel_dep" declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivarla a un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
- Anula un módulo con un directorio local.
- Se acumulan varios usos de
--registry=<a string>
-
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
- Opciones que especifican o alteran una entrada genérica en un comando de Bazel que no se incluye en otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
--for_command=<a string>
predeterminado: "build"-
Es el comando para el que se deben canonizar las opciones.
Etiquetas:affects_outputs
,terminal_output
--invocation_policy=<a string>
predeterminado: ""-
Aplica una política de invocación a las opciones que se van a canónicar.
Etiquetas:affects_outputs
,terminal_output
- Opciones de almacenamiento en caché y ejecución remotas:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
- Opciones misceláneas que no se clasifican de otra manera:
--deleted_packages=<comma-separated list of package names>
predeterminado: ""- Es una lista separada por comas de nombres de paquetes que el sistema de compilación considerará inexistentes, incluso si son visibles en algún lugar de la ruta de acceso del paquete. Usa esta opción cuando borres un subpaquete "x/y" de un paquete existente "x". Por ejemplo, después de borrar x/y/BUILD en tu cliente, es posible que el sistema de compilación se queje si encuentra una etiqueta "//x:y/z" si otra entrada de package_path aún la proporciona. Especificar --deleted_packages x/y evita este problema.
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
- Anula un repositorio con un directorio local.
--package_path=<colon-separated list of options>
predeterminado: "%workspace%"- Es una lista separada por dos puntos de dónde buscar paquetes. Los elementos que comienzan con "%workspace%" son relativos al lugar de trabajo que los contiene. Si se omite o está vacío, el valor predeterminado es el resultado de "bazel info default-package-path".
--[no]show_loading_progress
predeterminado: "true"- Si está habilitado, hace que Bazel imprima mensajes de “Carga del paquete:”.
Opciones de limpieza
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
-
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
predeterminado: “false”-
Si es verdadero, usa una cadena derivada de las URLs de las descargas del repositorio como canonical_id si no se especifica. Esto hace que un cambio en las URLs genere una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no hagan que la caché oculte los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
predeterminado: “false”-
Si se establece, no se permite descargar repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, se puede hacer que los repositorios externos funcionen en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que controlan el resultado del comando:
--[no]async
predeterminado: “false”-
Si es verdadero, la limpieza de salida es asíncrona. Cuando se complete este comando, será seguro ejecutar comandos nuevos en el mismo cliente, aunque la eliminación pueda continuar en segundo plano.
Etiquetas:host_machine_resource_optimizations
--[no]expunge
predeterminado: “false”-
Si es verdadero, clean quita todo el árbol de trabajo de esta instancia de Bazel, lo que incluye todos los archivos de salida temporales y de compilación creados por Bazel, y detiene el servidor de Bazel si está en ejecución.
Etiquetas:host_machine_resource_optimizations
--expunge_async
-
Si se especifica, clean quita de forma asíncrona todo el árbol de trabajo de esta instancia de Bazel, lo que incluye todos los archivos de salida temporales y de compilación creados por Bazel, y detiene el servidor de Bazel si está en ejecución. Cuando se complete este comando, será seguro ejecutar comandos nuevos en el mismo cliente, aunque la eliminación pueda continuar en segundo plano.
Se expande a:
--expunge
--async
Etiquetas:host_machine_resource_optimizations
--[no]remove_all_convenience_symlinks
predeterminado: “false”-
Si es verdadero, se borrarán todos los symlinks del lugar de trabajo con el prefijo symlink_prefix. Sin esta marca, solo se limpian los symlinks con los sufijos predefinidos.
Etiquetas:affects_outputs
- Opciones que afectan la rigurosidad con la que Bazel aplica entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
--experimental_repository_hash_file=<a string>
predeterminado: ""-
Si no está vacío, especifica un archivo que contiene un valor resuelto, con el que se deben verificar los valores hash del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan varios usos de
--experimental_verify_repository_rules=<a string>
-
Si es una lista de reglas de repositorio para las que se debe verificar el hash del directorio de salida, siempre que se especifique un archivo con --experimental_repository_hash_file.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: "true"-
Etiquetas
sin operación:no_op
,deprecated
,experimental
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
-
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitadas en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "advertencia" -
Verifica si las dependencias directas de "bazel_dep" declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivarla a un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
- Anula un módulo con un directorio local.
- Se acumulan varios usos de
--registry=<a string>
-
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
- Opciones que especifican o alteran una entrada genérica a un comando de Bazel que no se incluye en otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite"), seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
- Anula un repositorio con un directorio local.
Config Options
Opciones de cobertura
Hereda todas las opciones de test.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
-
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
predeterminado: “false”-
Si es verdadero, usa una cadena derivada de las URLs de las descargas del repositorio como canonical_id si no se especifica. Esto hace que un cambio en las URLs genere una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no provoquen que la caché oculte los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
predeterminado: “false”-
Si se establece, no se permite descargar repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: “1.0”-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, los repositorios externos pueden funcionar en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que afectan la rigurosidad con la que Bazel aplica entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etc.):
--experimental_repository_hash_file=<a string>
predeterminado: ""-
Si no está vacío, especifica un archivo que contiene un valor resuelto, con el que se deben verificar los valores hash del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan varios usos de
--experimental_verify_repository_rules=<a string>
-
Si es una lista de reglas de repositorio para las que se debe verificar el hash del directorio de salida, siempre que se especifique un archivo con --experimental_repository_hash_file.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: "true"-
Etiquetas
sin operación:no_op
,deprecated
,experimental
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
-
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitados en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: “error”-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "advertencia" -
Verifica si las dependencias directas de "bazel_dep" declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivarla a un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
- Anula un módulo con un directorio local.
- Se acumulan varios usos de
--registry=<a string>
-
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
- Opciones que especifican o alteran una entrada genérica en un comando de Bazel que no se incluye en otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de almacenamiento en caché y ejecución remotas:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
- Anula un repositorio con un directorio local.
Opciones de Cquery
Hereda todas las opciones de test.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
-
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
predeterminado: “false”-
Si es verdadero, usa una cadena derivada de las URLs de las descargas del repositorio como canonical_id si no se especifica. Esto hace que un cambio en las URLs genere una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no hagan que la caché oculte los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
predeterminado: “false”-
Si se establece, no se permite descargar repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, se puede hacer que los repositorios externos funcionen en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que afectan la rigurosidad con la que Bazel aplica entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etc.):
--experimental_repository_hash_file=<a string>
predeterminado: ""-
Si no está vacío, especifica un archivo que contiene un valor resuelto, con el que se deben verificar los valores hash del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan varios usos de
--experimental_verify_repository_rules=<a string>
-
Si es una lista de reglas de repositorio para las que se debe verificar el hash del directorio de salida, siempre que se especifique un archivo con --experimental_repository_hash_file.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: "true"-
Etiquetas
sin operación:no_op
,deprecated
,experimental
- Opciones relacionadas con el resultado de la consulta y la semántica:
--aspect_deps=<off, conservative or precise>
predeterminado: "conservative"-
Cómo resolver las dependencias de aspecto cuando el formato de salida es uno de {xml,proto,record}. "Desactivado" significa que no se resuelven las dependencias de aspecto. "Conservador" (la opción predeterminada) significa que se agregan todas las dependencias de aspecto declaradas, independientemente de si se les asigna la clase de regla de dependencias directas. "Preciso" significa que solo se agregan los aspectos que pueden estar activos según la clase de regla de las dependencias directas. Ten en cuenta que el modo preciso requiere la carga de otros paquetes para evaluar un solo objetivo, lo que lo hace más lento que los otros modos. Además, ten en cuenta que incluso el modo preciso no es del todo preciso: la decisión de calcular un aspecto se toma en la fase de análisis, que no se ejecuta durante la "consulta de bazel".
Etiquetas:build_file_semantics
--[no]graph:factored
predeterminado: "true"-
Si es verdadero, el gráfico se emitirá "factorizado", es decir, los nodos topológicamente equivalentes se combinarán y sus etiquetas se concatenarán. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--graph:node_limit=<an integer>
predeterminado: “512”-
Es la longitud máxima de la cadena de etiqueta para un nodo de grafo en el resultado. Las etiquetas más largas se truncarán. -1 significa que no se truncará. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--[no]implicit_deps
predeterminado: "true"-
Si está habilitada, se incluirán dependencias implícitas en el gráfico de dependencias sobre el que opera la consulta. Una dependencia implícita es aquella que no se especifica explícitamente en el archivo BUILD, pero que Bazel agrega. En el caso de cquery, esta opción controla el filtrado de cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
--[no]include_aspects
predeterminado: "true"-
aquery, cquery: Indica si se deben incluir acciones generadas por aspectos en el resultado. query: No-op (siempre se siguen los aspectos).
Etiquetas:terminal_output
--[no]incompatible_display_source_file_location
predeterminado: "true"-
Es verdadero de forma predeterminada y muestra el destino del archivo fuente. Si es verdadero, muestra la ubicación de la línea 1 de los archivos de origen en los resultados de ubicación. Esta marca solo existe para la migración.
Etiquetas:terminal_output
,incompatible_change
--[no]incompatible_package_group_includes_double_slash
predeterminado: "true"-
Si está habilitada, cuando se genere el atributo "packages" de package_group, no se omitirá el "//" inicial.
Etiquetas:terminal_output
,incompatible_change
--[no]infer_universe_scope
predeterminado: “false”-
Si se establece y no se establece --universe_scope, se inferirá un valor de --universe_scope como la lista de patrones de destino únicos en la expresión de consulta. Ten en cuenta que el valor de --universe_scope inferido para una expresión de consulta que usa funciones centradas en el universo (p.ej., "allrdeps") puede no ser lo que deseas, por lo que debes usar esta opción solo si sabes lo que estás haciendo. Consulta https://bazel.build/query/language#sky-query para obtener detalles y ejemplos. Si se establece --universe_scope, se ignora el valor de esta opción. Nota: Esta opción solo se aplica a "query" (es decir, no a "cquery").
Etiquetas:loading_and_analysis
--[no]line_terminator_null
predeterminado: “false”-
Indica si cada formato finaliza con \0 en lugar de una línea nueva.
Etiquetas:terminal_output
--[no]nodep_deps
predeterminado: "true"-
Si está habilitada, las dependencias de los atributos "nodep" se incluirán en el gráfico de dependencias sobre el que opera la consulta. Un ejemplo común de un atributo "nodep" es "visibility". Ejecuta y analiza el resultado de "info build-language" para obtener información sobre todos los atributos "nodep" en el lenguaje de compilación.
Etiquetas:build_file_semantics
--output=<a string>
predeterminado: "label"-
Es el formato en el que se deben imprimir los resultados de la cquery. Los valores permitidos para cquery son: etiqueta, etiqueta_tipo, textoproto, transiciones, 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á habilitada, los atributos configurables creados por select() se aplanan. En el caso de los tipos de lista, la representación aplanada es una lista que contiene cada valor del mapa de selección exactamente una vez. Los tipos escalares se aplanan a nulos.
Etiquetas:build_file_semantics
--[no]proto:include_configurations
predeterminado: "true"-
Si está habilitado, el resultado de proto incluirá información sobre las configuraciones. Cuando se inhabilita,el formato de salida de cquery proto se asemeja al formato de salida de la consulta.
Etiquetas:affects_outputs
--[no]proto:include_synthetic_attribute_hash
predeterminado: “false”-
Indica si se debe calcular y propagar el atributo $internal_attr_hash.
Etiquetas:terminal_output
--[no]proto:instantiation_stack
predeterminado: “false”-
Propaga la pila de llamadas de creación de instancias de cada regla. Ten en cuenta que esto requiere que la pila esté presente.
Etiquetas:terminal_output
--[no]proto:locations
predeterminado: "true"-
Indica si se debe generar información de ubicación en el resultado de proto.
Etiquetas:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
predeterminado: “all”-
Es una lista de atributos separados por comas que se incluirán en el resultado. La configuración predeterminada es todos los atributos. Establece una cadena vacía para no mostrar ningún atributo. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
--[no]proto:rule_inputs_and_outputs
predeterminado: "true"-
Indica si se propagan o no los campos rule_input y rule_output.
Etiquetas:terminal_output
--[no]relative_locations
predeterminado: “false”-
Si es verdadero, la ubicación de los archivos BUILD en los resultados de xml y proto será relativa. De forma predeterminada, el resultado de la ubicación es una ruta de acceso absoluta y no será coherente en todas las máquinas. Puedes establecer esta opción en verdadero para obtener un resultado coherente en todas las máquinas.
Etiquetas:terminal_output
--show_config_fragments=<off, direct or transitive>
predeterminado: "off"-
Muestra los fragmentos de configuración que requiere una regla y sus dependencias transitivas. Esto puede ser útil para evaluar cuánto se puede recortar un gráfico objetivo configurado.
Etiquetas:affects_outputs
--starlark:expr=<a string>
predeterminado: ""-
Es una expresión Starlark para dar formato a cada destino configurado en el modo --output=starlark de cquery. El objetivo configurado está vinculado a "target". Si no se especifican --starlark:expr ni --starlark:file, esta opción se establecerá de forma predeterminada en "str(target.label)". Especificar --starlark:expr y --starlark:file es un error.
Etiquetas:terminal_output
--starlark:file=<a string>
predeterminado: ""-
Es el nombre de un archivo que define una función Starlark llamada "format", de un argumento, que se aplica a cada destino configurado para darle formato como una cadena. Especificar --starlark:expr y --starlark:file es un error. Consulta la ayuda de --output=starlark para obtener más detalles.
Etiquetas:terminal_output
--[no]tool_deps
predeterminado: "true"-
Consulta: Si se inhabilita, las dependencias de los destinos de "configuración del host" o "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 del host", como el de cualquier regla "proto_library" al compilador de protocolos, suele apuntar a una herramienta que se ejecuta durante la compilación en lugar de a una parte del mismo programa "objetivo".
Cquery: Si se inhabilita, filtra todos los objetivos configurados que cruzan un host o una transición de ejecución desde el objetivo de nivel superior que descubrió este objetivo configurado. Esto significa que, si el objetivo de nivel superior está en la configuración de destino, solo se mostrarán los objetivos configurados también en la configuración de destino. Si el destino de nivel superior está en la configuración del host, solo se mostrarán los destinos configurados por el host. Esta opción NO excluirá las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
- Valor predeterminado de
--transitions=<full, lite or none>
: “none” -
Es el formato en el que cquery imprimirá la información de transición.
Etiquetas:affects_outputs
--universe_scope=<comma-separated list of options>
predeterminado: ""-
Es un conjunto de patrones de destino (aditivos y sustractivos) separados por comas. La consulta se puede realizar en el universo definido por el cierre transitivo de los destinos especificados. Esta opción se usa para los comandos query y cquery.
En el caso de cquery, la entrada de esta opción son los objetivos en los que se compilan todas las respuestas, por lo que esta opción puede afectar las configuraciones y las transiciones. Si no se especifica esta opción, se supone que los destinos de nivel superior son los que se analizaron de la expresión de consulta. Nota: En el caso de cquery, si no se especifica esta opción, es posible que la compilación falle si los destinos analizados de la expresión de consulta no se pueden compilar con opciones de nivel superior.
Etiquetas:loading_and_analysis
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
-
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitados en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "advertencia" -
Verifica si las dependencias directas de "bazel_dep" declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivarla a un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
- Anula un módulo con un directorio local.
- Se acumulan varios usos de
--registry=<a string>
-
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
- Opciones que especifican o alteran una entrada genérica en un comando de Bazel que no se incluye en otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite"), seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
- Anula un repositorio con un directorio local.
- Opciones que controlan la ejecución de la compilación:
--[no]experimental_inprocess_symlink_creation
predeterminado: “false”-
Determina si se deben realizar llamadas directas al sistema de archivos para crear árboles de symlinks.
Etiquetas:loading_and_analysis
,execution
,experimental
--[no]experimental_remotable_source_manifests
predeterminado: “false”-
Determina si las acciones del manifiesto de origen se pueden controlar de forma remota.
Etiquetas:loading_and_analysis
,execution
,experimental
--[no]experimental_split_coverage_postprocessing
predeterminado: “false”-
Si es verdadero, Bazel ejecutará el procesamiento posterior de la cobertura para la prueba en un nuevo inicio.
Etiquetas:execution
--[no]experimental_strict_fileset_output
predeterminado: “false”-
Si esta opción está habilitada, los conjuntos de archivos tratarán todos los artefactos de salida como archivos normales. No recorrerán directorios ni serán sensibles a los symlinks.
Etiquetas:execution
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
predeterminado: ""-
Agrega o quita claves de la información de ejecución de una acción según la mnemotecnia de la acción. Solo se aplica a las acciones que admiten información de ejecución. Muchas acciones comunes admiten información de ejecución, p.ej., Genrule, CppCompile, Javac, StarlarkAction y TestRunner. Cuando especificas varios valores, el orden es importante porque muchas regex pueden aplicarse al mismo mnemónico.
Sintaxis: "regex=[+-]clave,regex=[+-]clave,...".
Ejemplos:
'.*=+x,.*=-y,.*=+z' agrega "x" y "z" a la información de ejecución de todas las acciones y quita "y".
"Genrule=+requires-x" agrega "requires-x" a la información de ejecución de todas las acciones de Genrule.
"(?!Genrule).*=-requires-x" quita "requires-x" de la información de ejecución para todas las acciones que no sean de Genrule.
Etiquetas:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Habilita las acciones de expansión de sintaxis y dex persistentes de Android con trabajadores.
Se expande a:
--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
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_dex_desugar
-
Habilita las acciones de desugar y dex multiplexadas y persistentes de Android con trabajadores.
Se expande a:
--persistent_android_dex_desugar
--modify_execution_info=Desugar=+supports-multiplex-workers
--modify_execution_info=DexBuilder=+supports-multiplex-workers
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
Habilita el procesador de recursos de Android multiplexado persistente con trabajadores.
Se expande a:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_tools
-
Habilita las herramientas de Android persistentes y multiplexadas (dexing, expansión de sintaxis, procesamiento de recursos).
Se expande a:
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Etiquetas:host_machine_resource_optimizations
,execution
- Opciones que configuran la cadena de herramientas que se usa para la ejecución de acciones:
--android_compiler=<a string>
predeterminado: Consulta la descripción-
El compilador de destino de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_crosstool_top=<a build target label>
predeterminado: "//external:android/crosstool"-
Es la ubicación del compilador de C++ que se usa para las compilaciones de Android.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_grte_top=<a label>
predeterminado: Consulta la descripción-
El objetivo de Android grte_top.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
predeterminado: "android"-
Selecciona el combinador de manifiestos que se usará para las reglas android_binary. Marca para ayudar a la transición a la combinación de manifiestos de Android desde la combinación heredada.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_platforms=<a build target label>
predeterminado: ""-
Establece las plataformas que usan los destinos de android_binary. Si se especifican varias plataformas, el objeto binario es un APK grueso, que contiene objetos binarios nativos para cada plataforma de destino especificada.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_sdk=<a build target label>
predeterminado: "@bazel_tools//tools/android:sdk"-
Especifica el SDK o la plataforma de Android que se usa para compilar aplicaciones para Android.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--apple_compiler=<a string>
predeterminado: Consulta la descripción-
El compilador de destino de Apple. Es útil para seleccionar variantes de una cadena de herramientas (p.ej., xcode-beta).
Etiquetas:affects_outputs
,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
--apple_grte_top=<a build target label>
predeterminado: Consulta la descripción-
El objetivo de Apple grte_top.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--cc_output_directory_tag=<a string>
predeterminado: ""-
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas:affects_outputs
,explicit_in_output_path
--compiler=<a string>
predeterminado: Consulta la descripción-
Es el compilador de C++ que se usará para compilar el destino.
Etiquetas:loading_and_analysis
,execution
--coverage_output_generator=<a build target label>
predeterminado: "@bazel_tools//tools/test:lcov_merger"-
Ubicación del binario que se usa para postprocesar informes de cobertura sin procesar. Actualmente, debe ser un grupo de archivos que contenga un solo archivo, el binario. El valor predeterminado es “//tools/test:lcov_merger”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
predeterminado: "@bazel_tools//tools/test:coverage_report_generator"-
Ubicación del binario que se usa para generar informes de cobertura. Actualmente, debe ser un grupo de archivos que contenga un solo archivo, el binario. El valor predeterminado es "//tools/test:coverage_report_generator".
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
predeterminado: "@bazel_tools//tools/test:coverage_support"-
Ubicación de los archivos de compatibilidad que se requieren en las entradas de cada acción de prueba que recopila la cobertura de código. El valor predeterminado es “//tools/test:coverage_support”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--crosstool_top=<a build target label>
predeterminado: "@bazel_tools//tools/cpp:toolchain"-
Es la etiqueta del paquete de herramientas cruzadas que se usará para compilar código C++.
Etiquetas:loading_and_analysis
,changes_inputs
,affects_outputs
--custom_malloc=<a build target label>
predeterminado: Consulta la descripción- especifica una implementación personalizada de malloc. Este parámetro de configuración anula los atributos malloc en las reglas de compilación.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan varios usos de
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
-
Es una lista de expresiones regulares separadas por comas, cada una con el prefijo - (expresión negativa) de forma opcional, asignada (=) a una lista de objetivos de valores de restricción separados por comas. Si un objetivo no coincide con ninguna expresión negativa y con al menos una expresión positiva, la resolución de la cadena de herramientas se realizará como si hubiera declarado los valores de restricción como restricciones de ejecución. Ejemplo: //demo,-test=@platforms//cpus:x86_64 agregará "x86_64" a cualquier destino de //demo, excepto a aquellos cuyo nombre contenga "test".
Etiquetas:loading_and_analysis
--[no]experimental_enable_objc_cc_deps
predeterminado: "true"- Permite que las reglas objc_* dependan de cc_library y hace que las dependencias de objc se compilen con --cpu establecido en "ios_<--ios_cpu>" para cualquier valor en --ios_multi_cpu.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]experimental_include_xcode_execution_requirements
predeterminado: “false”-
Si se establece, agrega un requisito de ejecución "requires-xcode:{version}" a cada acción de Xcode. Si la versión de Xcode tiene una etiqueta con guiones, también agrega un requisito de ejecución "requires-xcode-label:{version_label}".
Etiquetas:loses_incremental_state
,loading_and_analysis
,execution
--[no]experimental_prefer_mutual_xcode
predeterminado: "true"-
Si es verdadero, usa la versión más reciente de Xcode que esté disponible de forma local y remota. Si es falso o si no hay versiones mutuas disponibles, usa la versión local de Xcode seleccionada a través de xcode-select.
Etiquetas:loses_incremental_state
- Se acumulan varios usos de
--extra_execution_platforms=<comma-separated list of options>
-
Son las plataformas disponibles como plataformas de ejecución para ejecutar acciones. Las plataformas se pueden especificar por destino exacto o como un patrón de destino. Estas plataformas se considerarán antes de las declaradas en el archivo WORKSPACE por register_execution_platforms().
Etiquetas:execution
- Se acumulan varios usos de
--extra_toolchains=<comma-separated list of options>
-
Son las reglas de la cadena de herramientas que se deben tener en cuenta durante la resolución de la cadena de herramientas. Las cadenas de herramientas se pueden especificar por destino exacto o como un patrón de destino. Estas cadenas de herramientas se considerarán antes que las declaradas en el archivo WORKSPACE por register_toolchains().
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--grte_top=<a label>
predeterminado: Consulta la descripción-
Es una etiqueta para una biblioteca libc verificada. La cadena de herramientas de crosstool selecciona el valor predeterminado, y casi nunca es necesario anularlo.
Etiquetas:action_command_lines
,affects_outputs
--host_compiler=<a string>
predeterminado: Consulta la descripción-
Es el compilador de C++ que se usará para la compilación del host. Se ignora si no se establece --host_crosstool_top.
Etiquetas:loading_and_analysis
,execution
--host_crosstool_top=<a build target label>
predeterminado: Consulta la descripción-
De forma predeterminada, las opciones --crosstool_top y --compiler también se usan para la configuración del host. Si se proporciona esta marca, Bazel usa la libc y el compilador predeterminados para el crosstool_top determinado.
Etiquetas:loading_and_analysis
,changes_inputs
,affects_outputs
--host_grte_top=<a label>
predeterminado: Consulta la descripción-
Si se especifica, este parámetro de configuración anula el directorio de nivel superior de libc (--grte_top) para la configuración del host.
Etiquetas:action_command_lines
,affects_outputs
--host_platform=<a build target label>
predeterminado: ""-
La etiqueta de una regla de plataforma que describe el sistema host.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--[no]incompatible_disable_expand_if_all_available_in_flag_set
predeterminado: "true"-
Si es verdadero, Bazel no permitirá especificar expand_if_all_available en flag_sets(consulta https://github.com/bazelbuild/bazel/issues/7008 para obtener instrucciones de migración).
Etiquetas:loading_and_analysis
,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_android_toolchain_resolution
predeterminado: “false”-
Usa la resolución de cadena de herramientas para seleccionar el SDK de Android para las reglas de Android (Starlark y nativo)
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_apple_toolchain_resolution
predeterminado: “false”-
Usa la resolución de cadena de herramientas para seleccionar el SDK de Apple para las reglas de Apple (Starlark y nativo)
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone
predeterminado: "true"-
Si es verdadero, Bazel no reutilizará las líneas de comandos de la acción de vinculación de C++ para las líneas de comandos de indexación de lto (consulta https://github.com/bazelbuild/bazel/issues/6791 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain
predeterminado: "true"-
Si es verdadero, Bazel se quejará cuando se establezcan los atributos cc_toolchain.cpu y cc_toolchain.compiler (consulta https://github.com/bazelbuild/bazel/issues/7075 para obtener instrucciones de migración).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_legacy_whole_archive
predeterminado: "true"-
Si es verdadero, Bazel no vinculará las dependencias de la biblioteca como un archivo completo de forma predeterminada (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener instrucciones de migración).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_require_ctx_in_configure_features
predeterminado: "true"-
Si es verdadero, Bazel requerirá el parámetro "ctx" en cc_common.configure_features (consulta https://github.com/bazelbuild/bazel/issues/7793 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
-
Usa objetos compartidos de interfaz si la cadena de herramientas es compatible. Actualmente, todas las cadenas de herramientas ELF admiten este parámetro de configuración.
Etiquetas:loading_and_analysis
,affects_outputs
,affects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Especifica la versión del SDK de iOS que se usará para compilar aplicaciones para iOS. Si no se especifica, se usa la versión predeterminada del SDK de iOS de "xcode_version".
Etiquetas:loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Especifica la versión del SDK de macOS que se usará para compilar aplicaciones para macOS. Si no se especifica, usa la versión predeterminada del SDK de macOS de "xcode_version".
Etiquetas:loses_incremental_state
--minimum_os_version=<a string>
predeterminado: Consulta la descripción-
Es la versión mínima del SO a la que se orienta tu compilación.
Etiquetas:loading_and_analysis
,affects_outputs
--platform_mappings=<a relative path>
predeterminado: ""-
Es la ubicación de un archivo de asignación que describe qué plataforma usar si no se establece ninguna o qué marcas establecer cuando ya existe una plataforma. Debe ser relativo a la raíz del espacio de trabajo principal. El valor predeterminado es "platform_mappings" (un archivo directamente debajo de la raíz del espacio de trabajo).
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--platforms=<a build target label>
predeterminado: ""-
Son las etiquetas de las reglas de la plataforma que describen las plataformas de destino del comando actual.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--python2_path=<a string>
predeterminado: Consulta la descripción-
Obsoleto, no realiza ninguna acción. Se inhabilitó con `--incompatible_use_python_toolchains`.
Etiquetas:no_op
,deprecated
--python3_path=<a string>
predeterminado: Consulta la descripción-
Obsoleto, no realiza ninguna acción. Se inhabilitó con `--incompatible_use_python_toolchains`.
Etiquetas:no_op
,deprecated
--python_path=<a string>
predeterminado: Consulta la descripción-
Es la ruta de acceso absoluta del intérprete de Python que se invocó para ejecutar destinos de Python en la plataforma de destino. Obsoleto; se inhabilitó con --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
--python_top=<a build target label>
predeterminado: Consulta la descripción-
La etiqueta de un py_runtime que representa el intérprete de Python invocado para ejecutar destinos de Python en la plataforma de destino. Obsoleto; se inhabilitó con --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
--target_platform_fallback=<a build target label>
predeterminado: "@local_config_platform//:host"-
Es la etiqueta de una regla de plataforma que se debe usar si no se establece una plataforma de destino y si no hay ninguna asignación de plataforma que coincida con el conjunto actual de marcas.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Especifica la versión del SDK de tvOS que se usará para compilar aplicaciones para tvOS. Si no se especifica, se usa la versión predeterminada del SDK de tvOS de "xcode_version".
Etiquetas:loses_incremental_state
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Especifica la versión del SDK de watchOS que se usará para compilar aplicaciones para watchOS. Si no se especifica, usa la versión predeterminada del SDK de watchOS de "xcode_version".
Etiquetas:loses_incremental_state
--xcode_version=<a string>
predeterminado: Consulta la descripción-
Si se especifica, usa Xcode de la versión determinada para las acciones de compilación relevantes. Si no se especifica, se usa la versión predeterminada del ejecutor de Xcode.
Etiquetas:loses_incremental_state
--xcode_version_config=<a build target label>
predeterminado: "@bazel_tools//tools/cpp:host_xcodes"-
Es la etiqueta de la regla xcode_config que se usará para seleccionar la versión de Xcode en la configuración de compilación.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Opciones que controlan el resultado del comando:
--[no]apple_enable_auto_dsym_dbg
predeterminado: “false”-
Indica si se debe forzar la generación de archivos de símbolos de depuración (.dSYM) para las compilaciones de dbg.
Etiquetas:affects_outputs
,action_command_lines
--[no]apple_generate_dsym
predeterminado: “false”-
Indica si se deben generar archivos de símbolos de depuración (.dSYM).
Etiquetas:affects_outputs
,action_command_lines
--[no]build_runfile_links
predeterminado: "true"-
Si es verdadero, compila bosques de symlinks de runfiles para todos los destinos. Si es falso, escribe solo manifiestos cuando sea posible.
Etiquetas:affects_outputs
--[no]build_runfile_manifests
predeterminado: "true"-
Si es verdadero, escribe manifiestos de runfiles para todos los destinos. Si es falso, omítelos. Las pruebas locales no se ejecutarán si es falso.
Etiquetas:affects_outputs
--[no]build_test_dwp
predeterminado: “false”-
Si está habilitado, cuando se compilen pruebas de C++ de forma estática y con Fission, el archivo .dwp para el objeto binario de prueba también se compilará automáticamente.
Etiquetas:loading_and_analysis
,affects_outputs
--cc_proto_library_header_suffixes=<comma-separated list of options>
predeterminado: “.pb.h”-
Establece los prefijos de los archivos de encabezado que crea una cc_proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated list of options>
predeterminado: “.pb.cc”-
Configura los prefijos de los archivos de origen que crea una cc_proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info
predeterminado: “false”-
Ejecuta acciones adicionales para versiones alternativas de la API de Java en una proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_proto_extra_actions
predeterminado: “false”-
Ejecuta acciones adicionales para versiones alternativas de la API de Java en una proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_save_feature_state
predeterminado: “false”-
Guarda el estado de las funciones habilitadas y solicitadas como un resultado de la compilación.
Etiquetas:affects_outputs
,experimental
--fission=<a set of compilation modes>
predeterminado: “no”-
Especifica qué modos de compilación usan la fisión para las compilaciones y los vínculos de C++. Puede ser cualquier combinación de {'fastbuild', 'dbg', 'opt'} o los valores especiales "yes" para habilitar todos los modos y "no" para inhabilitarlos.
Etiquetas:loading_and_analysis
,action_command_lines
,affects_outputs
--[no]incompatible_always_include_files_in_data
predeterminado: "true"-
Si es verdadero, las reglas nativas agregan <code>DefaultInfo.files</code> de dependencias de datos a sus archivos de ejecución, lo que coincide con el comportamiento recomendado para las reglas de Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid).
Etiquetas:affects_outputs
,incompatible_change
--[no]legacy_external_runfiles
predeterminado: "true"-
Si es verdadero, compila bosques de symlinks de runfiles para repositorios externos en .runfiles/wsname/external/repo (además de .runfiles/repo).
Etiquetas:affects_outputs
--[no]objc_generate_linkmap
predeterminado: “false”- especifica si se debe generar un archivo de mapa de vínculos.
Etiquetas:affects_outputs
--[no]save_temps
predeterminado: “false”-
Si se establece, se guardarán los resultados temporales de gcc. Estos incluyen archivos .s (código de ensamblador), archivos .i (C procesado) y archivos .ii (C++ procesado).
Etiquetas:affects_outputs
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
- Se acumulan varios usos de
--action_env=<a 'name=value' assignment with an optional value part>
-
Especifica el conjunto de variables de entorno disponibles para las acciones con configuración de destino. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o bien por el par nombre=valor, que establece el valor independientemente del entorno de invocación. Esta opción se puede usar varias veces. En el caso de las opciones que se proporcionan para la misma variable, se aplica la más reciente, y se acumulan las opciones para diferentes variables.
Etiquetas:action_command_lines
--android_cpu=<a string>
predeterminado: "armeabi-v7a"-
La CPU objetivo de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]android_databinding_use_androidx
predeterminado: “false”-
Genera archivos de vinculación de datos compatibles con AndroidX. Esto solo se usa con la vinculación de datos v2.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]android_databinding_use_v3_4_args
predeterminado: “false”-
Usa Android Databinding v2 con el argumento 3.4.0.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--android_dynamic_mode=<off, default or fully>
predeterminado: "off"- determina si las dependencias de C++ de las reglas de Android se vincularán de forma dinámica cuando un cc_binary no cree una biblioteca compartida de forma explícita. "default" significa que bazel elegirá si vincular de forma dinámica. "Completamente" significa que todas las bibliotecas se vincularán de forma dinámica. "Desactivado" significa que todas las bibliotecas se vincularán en modo principalmente estático.
Etiquetas:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
predeterminado: "alphabetical"-
Establece el orden de los manifiestos que se pasan a la combinación de manifiestos para los objetos binarios de Android. ALPHABETICAL significa que los manifiestos se ordenan por ruta de acceso en relación con el execroot. ALPHABETICAL_BY_CONFIGURATION significa que los manifiestos se ordenan por rutas de acceso relativas al directorio de configuración dentro del directorio de salida. DEPENDENCY significa que los manifiestos se ordenan de modo que el manifiesto de cada biblioteca aparezca antes que los manifiestos de sus dependencias.
Etiquetas:action_command_lines
,execution
--[no]android_resource_shrinking
predeterminado: “false”-
Habilita la reducción de recursos para los APKs de android_binary que usan ProGuard.
Etiquetas:affects_outputs
,loading_and_analysis
- Se acumulan varios usos de
--apple_bitcode=<'mode' or 'platform=mode', where 'mode' is none, embedded_markers or embedded, and 'platform' is ios, watchos, tvos, macos or catalyst>
. -
Especifica el modo de código de bits de Apple para los pasos de compilación orientados a arquitecturas de dispositivos. Los valores tienen el formato "[platform=]mode", donde la plataforma (que debe ser "ios", "macos", "tvos" o "watchos") es opcional. Si se proporciona, el modo de código de bytes se aplica específicamente para esa plataforma. Si se omite, se aplica para todas las plataformas. El modo debe ser "none", "embedded_markers" o "embedded". Esta opción se puede proporcionar varias veces.
Etiquetas:loses_incremental_state
--[no]build_python_zip
predeterminado: “auto”-
Compila el archivo ZIP ejecutable de Python; activado en Windows, desactivado en otras plataformas.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--catalyst_cpus=<comma-separated list of options>
. -
Es una lista de arquitecturas separadas por comas para las que se compilarán los objetos binarios de Apple Catalyst.
Etiquetas:loses_incremental_state
,loading_and_analysis
--[no]collect_code_coverage
predeterminado: “false”-
Si se especifica, Bazel instrumentará el código (con instrumentación sin conexión siempre que sea posible) y recopilará información de cobertura durante las pruebas. Solo se verán afectados los destinos que coincidan con --instrumentation_filter. Por lo general, esta opción no debe especificarse directamente, sino que se debe usar el comando "bazel coverage".
Etiquetas:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] predeterminado: "fastbuild"-
Especifica el modo en el que se compilará el objeto binario. Valores: "fastbuild", "dbg", "opt".
Etiquetas:affects_outputs
,action_command_lines
,explicit_in_output_path
- Se acumulan varios usos de
--conlyopt=<a string>
-
Opción adicional para pasar a gcc cuando se compilan archivos de origen C.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--copt=<a string>
. - Opciones adicionales para pasar a gcc.
Etiquetas:action_command_lines
,affects_outputs
--cpu=<a string>
predeterminado: ""-
La CPU objetivo.
Etiquetas:changes_inputs
,affects_outputs
,explicit_in_output_path
--cs_fdo_absolute_path=<a string>
predeterminado: Consulta la descripción-
Usa la información del perfil de CSFDO para optimizar la compilación. Especifica el nombre de la ruta de acceso absoluta del archivo ZIP que contiene el archivo de perfil, un archivo de perfil LLVM sin procesar o indexado.
Etiquetas:affects_outputs
--cs_fdo_instrument=<a string>
predeterminado: Consulta la descripción-
Genera ejecutables con instrumentación de FDO sensible al contexto. Con el compilador Clang/LLVM, también acepta el nombre del directorio en el que se volcarán los archivos de perfil sin procesar durante el tiempo de ejecución.
Etiquetas:affects_outputs
--cs_fdo_profile=<a build target label>
predeterminado: Consulta la descripción-
El cs_fdo_profile que representa el perfil sensible al contexto que se usará para la optimización.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--cxxopt=<a string>
. -
Opción adicional para pasar a gcc cuando se compilan archivos de origen C++.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--define=<a 'name=value' assignment>
-
Cada opción --define especifica una asignación para una variable de compilación.
Etiquetas:changes_inputs
,affects_outputs
--dynamic_mode=<off, default or fully>
predeterminado: "predeterminado"- determina si los objetos binarios de C++ se vincularán de forma dinámica. "default" significa que Bazel elegirá si vincular de forma dinámica. "Completamente" significa que todas las bibliotecas se vincularán de forma dinámica. "Desactivado" significa que todas las bibliotecas se vincularán en modo principalmente estático.
Etiquetas:loading_and_analysis
,affects_outputs
--[no]enable_fdo_profile_absolute_path
predeterminado: "true"-
Si se establece, el uso de fdo_absolute_profile_path generará un error.
Etiquetas:affects_outputs
--[no]enable_runfiles
predeterminado: “auto”-
Habilita el árbol de symlinks de runfiles. De forma predeterminada, está desactivado en Windows y en otras plataformas.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--experimental_action_listener=<a build target label>
- dejó de estar disponible y se reemplazó por aspectos. Usa action_listener para adjuntar un extra_action a las acciones de compilación existentes.
Etiquetas:execution
,experimental
--[no]experimental_android_compress_java_resources
predeterminado: “false”-
Comprime los recursos de Java en los APKs.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_android_databinding_v2
predeterminado: “false”-
Usa Android Databinding v2
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_android_resource_shrinking
predeterminado: “false”-
Habilita la reducción de recursos para los APKs de android_binary que usan ProGuard.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_android_rewrite_dexes_with_rex
predeterminado: “false”-
Usa la herramienta rex para volver a escribir archivos dex.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--experimental_objc_fastbuild_options=<comma-separated list of options>
predeterminado: "-O0,-DDEBUG=1"-
Usa estas cadenas como opciones del compilador de objc fastbuild.
Etiquetas:action_command_lines
--[no]experimental_omitfp
predeterminado: “false”-
Si es verdadero, usa libunwind para el desenredo de pila y compila con -fomit-frame-pointer y -fasynchronous-unwind-tables.
Etiquetas:action_command_lines
,affects_outputs
,experimental
--[no]experimental_platform_in_output_dir
predeterminado: “false”-
Si es verdadero, la plataforma de destino se usa en el nombre del directorio de salida en lugar de la CPU.
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
--fat_apk_cpu=<comma-separated list of options>
predeterminado: "armeabi-v7a"-
Si configuras esta opción, se habilitan los APKs multiarquitectura, que contienen objetos binarios nativos para todas las arquitecturas de destino especificadas, p.ej., --fat_apk_cpu=x86,armeabi-v7a. Si se especifica esta marca, se ignora --android_cpu para las dependencias de las reglas android_binary.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]fat_apk_hwasan
predeterminado: “false”-
Indica si se deben crear divisiones HWASAN.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--fdo_instrument=<a string>
predeterminado: Consulta la descripción-
Genera ejecutables con la instrumentación de FDO. Con el compilador Clang/LLVM, también acepta el nombre del directorio en el que se volcarán los archivos de perfil sin procesar durante el tiempo de ejecución.
Etiquetas:affects_outputs
--fdo_optimize=<a string>
predeterminado: Consulta la descripción-
Usa la información del perfil de FDO para optimizar la compilación. Especifica el nombre de un archivo ZIP que contenga un árbol de archivos .gcda, un archivo afdo que contenga un perfil automático o un archivo de perfil de LLVM. Esta marca también acepta archivos especificados como etiquetas (p.ej., "//foo/bar:file.afdo"; es posible que debas agregar una directiva "exports_files" al paquete correspondiente) y etiquetas que apuntan a destinos "fdo_profile". La regla "fdo_profile" reemplazará esta marca.
Etiquetas:affects_outputs
--fdo_prefetch_hints=<a build target label>
predeterminado: Consulta la descripción-
Usa sugerencias de almacenamiento en caché para la carga previa.
Etiquetas:affects_outputs
--fdo_profile=<a build target label>
predeterminado: Consulta la descripción-
Es el fdo_profile que representa el perfil que se usará para la optimización.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--features=<a string>
-
Las funciones determinadas se habilitarán o inhabilitarán de forma predeterminada para todos los paquetes. Si especificas -<feature>, se inhabilitará la función de forma global. Los atributos negativos siempre anulan los positivos. Esta marca se usa para habilitar el lanzamiento de cambios de funciones predeterminados sin una versión de Bazel.
Etiquetas:changes_inputs
,affects_outputs
--[no]force_pic
predeterminado: “false”-
Si está habilitada, todas las compilaciones de C++ producen código independiente de la posición ("-fPIC"), las vinculaciones prefieren las bibliotecas compiladas previamente de PIC en lugar de las bibliotecas que no son de PIC, y las vinculaciones producen ejecutables independientes de la posición ("-pie").
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan varios usos de
--host_action_env=<a 'name=value' assignment with an optional value part>
-
Especifica el conjunto de variables de entorno disponibles para las acciones con configuraciones de host o ejecución. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o bien por el par nombre=valor, que establece el valor independientemente del entorno de invocación. Esta opción se puede usar varias veces. En el caso de las opciones que se proporcionan para la misma variable, se aplica la más reciente, y se acumulan las opciones para diferentes variables.
Etiquetas:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
predeterminado: "opt"-
Especifica el modo en el que se compilarán las herramientas que se usan durante la compilación. Valores: "fastbuild", "dbg", "opt".
Etiquetas:affects_outputs
,action_command_lines
- Se acumulan varios usos de
--host_conlyopt=<a string>
-
Opción adicional para pasar a gcc cuando se compilan archivos de origen C para herramientas de host.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--host_copt=<a string>
. -
Opciones adicionales para pasar a gcc para herramientas de host.
Etiquetas:action_command_lines
,affects_outputs
--host_cpu=<a string>
predeterminado: ""-
La CPU del host.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan varios usos de
--host_cxxopt=<a string>
-
Opciones adicionales para pasar a gcc para herramientas de host.
Etiquetas:action_command_lines
,affects_outputs
--host_force_python=<PY2 or PY3>
predeterminado: Consulta la descripción-
Anula la versión de Python para la configuración del host. Puede ser “PY2” o “PY3”.
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan varios usos de
--host_linkopt=<a string>
. - : Opción adicional para pasar a gcc cuando se vinculan herramientas de host.
Etiquetas:action_command_lines
,affects_outputs
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Versión mínima compatible de macOS para los destinos de host. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan varios usos de
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
-
Opciones adicionales para pasar de forma selectiva al compilador C/C++ cuando se compilan ciertos archivos en las configuraciones del host o de ejecución. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. En la que regex_filter representa una lista de patrones de expresiones regulares para incluir y excluir (consulta también --instrumentation_filter). option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe estar entre comillas con una barra diagonal inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos de gcc de todos los archivos cc en //foo/, excepto bar.cc.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--host_swiftcopt=<a string>
-
Opciones adicionales para pasar a swiftc para herramientas de host.
Etiquetas:action_command_lines
,affects_outputs
--[no]incompatible_avoid_conflict_dlls
predeterminado: "true"-
Si se habilita, se cambiará el nombre de todas las bibliotecas de vínculos dinámicos (DLL) de C++ que genera cc_library en Windows a name_{hash}.dll, donde el hash se calcula en función de RepositoryName y la ruta de acceso del paquete de la DLL. Esta opción es útil cuando tienes un paquete que depende de varias cc_library con el mismo nombre (p. ej., //foo/bar1:utils y //foo/bar2:utils).
Etiquetas:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_merge_genfiles_directory
predeterminado: "true"-
Si es verdadero, el directorio genfiles se une al directorio bin.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_use_platforms_repo_for_constraints
predeterminado: "true"-
Si es verdadero, se quita la configuración de restricciones de @bazel_tools.
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 establece, se instrumentan las reglas de prueba que incluye --instrumentation_filter. De lo contrario, las reglas de prueba siempre se excluyen de la instrumentación de cobertura.
Etiquetas:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
predeterminado: "-/javatests[/:],-/test/java[/:]"-
Cuando la cobertura esté habilitada, solo se instrumentarán las reglas con nombres incluidos en el filtro basado en regex especificado. En su lugar, se excluyen las reglas con el prefijo “-”. Ten en cuenta que solo se instrumentan las reglas que no son de prueba, a menos que se habilite --instrument_test_targets.
Etiquetas:affects_outputs
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Versión mínima de iOS compatible para los simuladores y dispositivos de destino. Si no se especifica, se usa "ios_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan varios usos de
--ios_multi_cpus=<comma-separated list of options>
-
Es una lista de arquitecturas separadas por comas con las que se compila una ios_application. El resultado es un binario universal que contiene todas las arquitecturas especificadas.
Etiquetas:loses_incremental_state
,loading_and_analysis
--[no]legacy_whole_archive
predeterminado: "true"-
Deja de estar disponible y se reemplaza por --incompatible_remove_legacy_whole_archive (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener más información). Cuando está activado, usa --whole-archive para las reglas cc_binary que tienen linkshared=True y linkstatic=True o “-static” en linkopts. Esto es solo para la retrocompatibilidad. Una mejor alternativa es usar alwayslink=1 cuando sea necesario.
Etiquetas:action_command_lines
,affects_outputs
,deprecated
- Se acumulan varios usos de
--linkopt=<a string>
- : Opción adicional para pasar a gcc cuando se realiza la vinculación.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--ltobackendopt=<a string>
. -
Opción adicional para pasar al paso de backend de LTO (en --features=thin_lto).
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--ltoindexopt=<a string>
-
Opción adicional para pasar al paso de indexación de LTO (en --features=thin_lto).
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--macos_cpus=<comma-separated list of options>
-
Es una lista separada por comas de las arquitecturas para las que se compilarán los objetos binarios de Apple macOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Versión mínima de macOS compatible para los destinos. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
--[no]objc_debug_with_GLIBCXX
predeterminado: “false”-
Si se establece y el modo de compilación se establece en "dbg", define GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC y GLIBCPP_CONCEPT_CHECKS.
Etiquetas:action_command_lines
--[no]objc_enable_binary_stripping
predeterminado: “false”-
Determina si se deben quitar los símbolos y el código muerto en los objetos binarios vinculados. Se realizarán eliminaciones de objetos binarios si se especifican esta marca y --compilation_mode=opt.
Etiquetas:action_command_lines
- Se acumulan varios usos de
--objccopt=<a string>
-
Opciones adicionales para pasar a gcc cuando se compilan archivos de origen Objective-C/C++.
Etiquetas:action_command_lines
- Se acumulan varios usos de
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
-
Opciones adicionales para pasar de forma selectiva a gcc cuando se compilan ciertos archivos. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. En la que regex_filter representa una lista de patrones de expresiones regulares para incluir y excluir (consulta también --instrumentation_filter). option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe estar entre comillas con una barra diagonal inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos de gcc de todos los archivos cc en //foo/, excepto bar.cc.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
-
Opciones adicionales para pasar de forma selectiva al backend de LTO (en --features=thin_lto) cuando se compilan ciertos objetos de backend. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. En la que regex_filter representa una lista de patrones de expresión regular para incluir y excluir. option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe estar entre comillas con una barra diagonal inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos del backend de LTO de todos los archivos o en //foo/, excepto bar.o.
Etiquetas:action_command_lines
,affects_outputs
--platform_suffix=<a string>
predeterminado: Consulta la descripción-
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas:loses_incremental_state
,affects_outputs
,loading_and_analysis
--propeller_optimize=<a build target label>
predeterminado: Consulta la descripción-
Usa la información del perfil de Propeller para optimizar el destino de compilación.Un perfil de Propeller debe constar de al menos uno de dos archivos: un perfil de cc y un perfil de ld. Esta marca acepta una etiqueta de compilación que debe hacer referencia a los archivos de entrada del perfil de Propeller. Por ejemplo, el archivo BUILD que define la etiqueta, en a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)Es posible que se deba agregar una directiva exports_files al paquete correspondiente para que Bazel pueda ver estos archivos. La opción se debe usar de la siguiente manera: --propeller_optimize=//a/b:propeller_profile
Etiquetas:action_command_lines
,affects_outputs
--propeller_optimize_absolute_cc_profile=<a string>
predeterminado: Consulta la descripción-
Nombre de ruta de acceso absoluta del archivo cc_profile para compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
predeterminado: Consulta la descripción-
Es el nombre de ruta de acceso absoluto del archivo ld_profile para las compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
--run_under=<a prefix in front of command>
predeterminado: Consulta la descripción-
Es el prefijo que se inserta antes de los ejecutables para los comandos "test" y "run". Si el valor es "foo -bar" y la línea de comandos de ejecución es "test_binary -baz", la línea de comandos final es "foo -bar test_binary -baz".También puede ser una etiqueta para un destino ejecutable. Algunos ejemplos son: "valgrind", "strace", "strace -c", "valgrind --quiet --num-callers=20", "//package:target", "//package:target --options".
Etiquetas:action_command_lines
-
Si es verdadero, las bibliotecas nativas que contienen funcionalidad idéntica se compartirán entre diferentes destinos.
Etiquetas:loading_and_analysis
,affects_outputs
--[no]stamp
predeterminado: “false”-
Marca los objetos binarios con la fecha, el nombre de usuario, el nombre de host, la información del espacio de trabajo, etcétera.
Etiquetas:affects_outputs
- Valor predeterminado de
--strip=<always, sometimes or never>
: “sometimes” - especifica si se deben quitar los objetos binarios y las bibliotecas compartidas (con "-Wl,--strip-debug"). El valor predeterminado de "sometimes" significa quitar si --compilation_mode=fastbuild.
Etiquetas:affects_outputs
- Se acumulan varios usos de
--stripopt=<a string>
-
Opciones adicionales para pasar a la eliminación cuando se genera un objeto binario "<name>.stripped".
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan varios usos de
--swiftcopt=<a string>
. -
Opciones adicionales para pasar a la compilación de Swift.
Etiquetas:action_command_lines
- Se acumulan varios usos de
--tvos_cpus=<comma-separated list of options>
-
Es una lista separada por comas de las arquitecturas para las que se compilarán los objetos binarios de Apple tvOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Versión mínima compatible de tvOS para los simuladores y dispositivos de destino. Si no se especifica, se usa "tvos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan varios usos de
--watchos_cpus=<comma-separated list of options>
-
Es una lista separada por comas de las arquitecturas para las que se compilarán los objetos binarios de Apple watchOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Versión mínima compatible de watchOS para los simuladores y dispositivos de destino. Si no se especifica, se usa "watchos_sdk_version".
Etiquetas:loses_incremental_state
--xbinary_fdo=<a build target label>
predeterminado: Consulta la descripción-
Usa la información del perfil de XbinaryFDO para optimizar la compilación. Especifica el nombre del perfil binario cruzado predeterminado. Cuando la opción se usa junto con --fdo_instrument/--fdo_optimize/--fdo_profile, esas opciones siempre prevalecerán como si xbinary_fdo nunca se especificara.
Etiquetas:affects_outputs
- Opciones que afectan la rigurosidad con la que Bazel aplica entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etc.):
--auto_cpu_environment_group=<a build target label>
predeterminado: ""-
Declara el environment_group que se usará para asignar automáticamente los valores de CPU a los valores de target_environment.
Etiquetas:changes_inputs
,loading_and_analysis
,experimental
--[no]check_licenses
predeterminado: “false”-
Verifica que las restricciones de licencias que imponen los paquetes dependientes no entren en conflicto con los modos de distribución de los destinos que se compilan. De forma predeterminada, no se verifican las licencias.
Etiquetas:build_file_semantics
--[no]check_visibility
predeterminado: "true"-
Si se inhabilita, los errores de visibilidad en las dependencias de destino se degradan a advertencias.
Etiquetas:build_file_semantics
--[no]desugar_for_android
predeterminado: "true"-
Indica si se debe expandir el código de bytes de Java 8 antes de dexificarlo.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]desugar_java8_libs
predeterminado: “false”-
Indica si se deben incluir bibliotecas Java 8 compatibles en apps para dispositivos heredados.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]enforce_constraints
predeterminado: "true"-
Verifica los entornos con los que es compatible cada objetivo y, luego, informa errores si alguno tiene dependencias que no admiten los mismos entornos.
Etiquetas:build_file_semantics
--[no]experimental_allow_android_library_deps_without_srcs
predeterminado: “false”-
Es una marca que ayuda a realizar la transición de permitir a no permitir reglas de android_library sin srcs con dependencias. Se debe limpiar el depósito para lanzarlo de forma predeterminada.
Etiquetas:eagerness_to_exit
,loading_and_analysis
--[no]experimental_check_desugar_deps
predeterminado: "true"-
Determina si se debe volver a verificar la expansión correcta a nivel binario de Android.
Etiquetas:eagerness_to_exit
,loading_and_analysis
,experimental
--experimental_import_deps_checking=<off, warning or error>
predeterminado: “OFF”-
Cuando está habilitada, verifica si las dependencias de una aar_import están completas. Esta aplicación forzosa puede interrumpir la compilación o generar advertencias.
Etiquetas:loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
predeterminado: "predeterminado"-
Si es verdadero, verifica que un destino de Java declare explícitamente todos los destinos utilizados directamente como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files
predeterminado: “false”-
Si está habilitado, busca el atributo testonly de la regla de generación para verificar si hay destinos de requisitos previos que sean archivos de salida. Esto coincide con la verificación de visibilidad.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_disable_native_android_rules
predeterminado: “false”-
Si se habilita, se inhabilita el uso directo de las reglas nativas de Android. Usa las reglas de Android de Starlark de https://github.com/bazelbuild/rules_android.
Etiquetas:eagerness_to_exit
,incompatible_change
--[no]incompatible_disable_native_apple_binary_rule
predeterminado: “false”-
No realiza ninguna acción. Se mantiene aquí para la retrocompatibilidad.
Etiquetas:eagerness_to_exit
,incompatible_change
--[no]incompatible_force_strict_header_check_from_starlark
predeterminado: "true"-
Si está habilitada, establece una verificación estricta de encabezados en la API de Starlark.
Etiquetas:loading_and_analysis
,changes_inputs
,incompatible_change
--[no]incompatible_validate_top_level_header_inclusions
predeterminado: "true"-
Si es verdadero, Bazel también validará las inclusiones de encabezados de directorio de nivel superior (consulta https://github.com/bazelbuild/bazel/issues/10047 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]strict_filesets
predeterminado: “false”-
Si esta opción está habilitada, los conjuntos de archivos que cruzan los límites de los paquetes se informan como errores. No funciona cuando check_fileset_dependencies_recursively está inhabilitada.
Etiquetas:build_file_semantics
,eagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default>
predeterminado: "error"-
A menos que esté desactivado, comprueba que un destino de proto_library declare de forma explícita todos los destinos utilizados directamente como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
--strict_public_imports=<off, warn, error, strict or default>
predeterminado: "off"-
A menos que esté desactivado, comprueba que un objetivo de proto_library declare de forma explícita todos los objetivos que se usan en "import public" como exportados.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
--[no]strict_system_includes
predeterminado: “false”-
Si es verdadero, también se deben declarar los encabezados que se encuentran a través de las rutas de inclusión del sistema (-isystem).
Etiquetas:loading_and_analysis
,eagerness_to_exit
- Se acumulan varios usos de
--target_environment=<a build target label>
. -
Declara el entorno de destino de esta compilación. Debe ser una referencia de etiqueta a una regla de "entorno". Si se especifican, todos los destinos de nivel superior deben ser compatibles con este entorno.
Etiquetas:changes_inputs
- Opciones que afectan los resultados de firma de una compilación:
--apk_signing_method=<v1, v2, v1_v2 or v4>
predeterminado: “v1_v2”-
Implementación que se usará para firmar APKs
Etiquetas:action_command_lines
,affects_outputs
,loading_and_analysis
--[no]device_debug_entitlements
predeterminado: "true"-
Si se establece y el modo de compilación no es "opt", las apps de objc incluirán derechos de depuración cuando se firmen.
Etiquetas:changes_inputs
--ios_signing_cert_name=<a string>
predeterminado: Consulta la descripción-
Es el nombre del certificado que se usará para la firma de iOS. Si no se establece, se usará el perfil de aprovisionamiento. Puede ser la preferencia de identidad del llavero del certificado o la substring del nombre común del certificado, según la página de man de codesign (IDENTIDADES DE FIRMA).
Etiquetas:action_command_lines
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.:
--[no]incompatible_disallow_legacy_py_provider
predeterminado: "true"-
No se realizará ninguna acción, se quitará pronto.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones que rigen el comportamiento del entorno de prueba o del ejecutor de pruebas:
--[no]allow_analysis_failures
predeterminado: “false”-
Si es verdadero, una falla de análisis de un objetivo de regla genera la propagación del objetivo de una instancia de AnalysisFailureInfo que contiene la descripción del error, en lugar de generar una falla de compilación.
Etiquetas:loading_and_analysis
,experimental
--analysis_testing_deps_limit=<an integer>
predeterminado: “2000”-
Establece la cantidad máxima de dependencias transitivas a través de un atributo de regla con una transición de configuración for_analysis_testing. Si se supera este límite, se mostrará un error de regla.
Etiquetas:loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure
predeterminado: “false”-
Si es verdadero, las fallas de la acción de dex2oat causarán que la compilación falle en lugar de ejecutar dex2oat durante el tiempo de ejecución de la prueba.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_android_use_parallel_dex2oat
predeterminado: “false”-
Usa dex2oat en paralelo para acelerar android_test.
Etiquetas:loading_and_analysis
,host_machine_resource_optimizations
,experimental
--[no]ios_memleaks
predeterminado: “false”-
Habilita la verificación de fugas de memoria en los destinos de ios_test.
Etiquetas:action_command_lines
--ios_simulator_device=<a string>
predeterminado: Consulta la descripción-
Es el dispositivo que se simula cuando se ejecuta una aplicación para iOS en el simulador, p.ej., "iPhone 6". Para obtener una lista de dispositivos, ejecuta "xcrun simctl list devicetypes" en la máquina en la que se ejecutará el simulador.
Etiquetas:test_runner
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Es la versión de iOS que se ejecutará en el simulador durante la ejecución o las pruebas. Esto se ignora para las reglas ios_test si se especifica un dispositivo de destino en la regla.
Etiquetas:test_runner
- Se acumulan varios usos de
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
- especifica la cantidad de veces que se debe ejecutar cada prueba. Si alguno de esos intentos falla por algún motivo, se considera que toda la prueba falló. Por lo general, el valor especificado es solo un número entero. Ejemplo: --runs_per_test=3 ejecutará todas las pruebas 3 veces. Sintaxis alternativa: regex_filter@runs_per_test. En la que runs_per_test representa un valor entero y regex_filter representa una lista de patrones de expresiones regulares para incluir y excluir (consulta también --instrumentation_filter). Ejemplo: --runs_per_test=//foo/.*,-//foo/bar/.*@3 ejecuta todas las pruebas en //foo/, excepto las que se encuentran en foo/bar, tres veces. Esta opción se puede pasar varias veces. El argumento pasado más recientemente que coincida tiene prioridad. Si no hay coincidencias, la prueba solo se ejecuta una vez.
- Se acumulan varios usos de
--test_env=<a 'name=value' assignment with an optional value part>
-
Especifica variables de entorno adicionales que se insertarán en el entorno del ejecutor de pruebas. Las variables se pueden especificar por nombre, en cuyo caso su valor se leerá del entorno del cliente de Bazel, o bien por el par nombre=valor. Esta opción se puede usar varias veces para especificar varias variables. Solo lo usa el comando "bazel test".
Etiquetas:test_runner
--test_timeout=<a single integer or comma-separated list of 4 integers>
predeterminado: “-1”- Anula los valores predeterminados de tiempo de espera de las pruebas (en segundos). Si se especifica un solo valor de número entero positivo, se anularán todas las categorías. Si se especifican 4 números enteros separados por comas, se anularán los tiempos de espera para corto, moderado, largo y eterno (en ese orden). De cualquier forma, un valor de -1 le indica a blaze que use sus tiempos de espera predeterminados para esa categoría.
--tvos_simulator_device=<a string>
predeterminado: Consulta la descripción-
Es el dispositivo que se simula cuando se ejecuta una aplicación para tvOS en el simulador, p.ej., "Apple TV 1080p". Para obtener una lista de dispositivos, ejecuta "xcrun simctl list devicetypes" en la máquina en la que se ejecutará el simulador.
Etiquetas:test_runner
--tvos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
Es la versión de tvOS que se ejecutará en el simulador cuando se ejecute o pruebe.
Etiquetas:test_runner
--watchos_simulator_device=<a string>
predeterminado: Consulta la descripción-
Es el dispositivo que se simula cuando se ejecuta una aplicación para watchOS en el simulador, p.ej., "Apple Watch - 38 mm". Para obtener una lista de dispositivos, ejecuta "xcrun simctl list devicetypes" en la máquina en la que se ejecutará el simulador.
Etiquetas:test_runner
--watchos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: Consulta la descripción-
La versión de watchOS que se ejecutará en el simulador cuando se ejecute o pruebe.
Etiquetas:test_runner
--[no]zip_undeclared_test_outputs
predeterminado: "true"-
Si es verdadero, los resultados de las pruebas no declaradas se archivarán en un archivo ZIP.
Etiquetas:test_runner
- Opciones relacionadas con el resultado de la consulta y la semántica:
--aspect_deps=<off, conservative or precise>
predeterminado: "conservative"-
Cómo resolver las dependencias de aspecto cuando el formato de salida es uno de {xml,proto,record}. "Desactivado" significa que no se resuelven las dependencias de aspecto. "Conservador" (la opción predeterminada) significa que se agregan todas las dependencias de aspecto declaradas, independientemente de si se les asigna la clase de regla de dependencias directas. "Preciso" significa que solo se agregan los aspectos que pueden estar activos según la clase de regla de las dependencias directas. Ten en cuenta que el modo preciso requiere la carga de otros paquetes para evaluar un solo objetivo, lo que lo hace más lento que los otros modos. Además, ten en cuenta que incluso el modo preciso no es del todo preciso: la decisión de calcular un aspecto se toma en la fase de análisis, que no se ejecuta durante la "consulta de bazel".
Etiquetas:build_file_semantics
--[no]graph:factored
predeterminado: "true"-
Si es verdadero, el gráfico se emitirá "factorizado", es decir, los nodos topológicamente equivalentes se combinarán y sus etiquetas se concatenarán. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--graph:node_limit=<an integer>
predeterminado: “512”-
Es la longitud máxima de la cadena de etiqueta para un nodo de grafo en el resultado. Las etiquetas más largas se truncarán. -1 significa que no se truncará. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--[no]implicit_deps
predeterminado: "true"-
Si está habilitada, se incluirán dependencias implícitas en el gráfico de dependencias sobre el que opera la consulta. Una dependencia implícita es aquella que no se especifica explícitamente en el archivo BUILD, pero que Bazel agrega. En el caso de cquery, esta opción controla el filtrado de cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
--[no]include_aspects
predeterminado: "true"-
aquery, cquery: Indica si se deben incluir acciones generadas por aspectos en el resultado. query: No-op (siempre se siguen los aspectos).
Etiquetas:terminal_output
--[no]incompatible_display_source_file_location
predeterminado: "true"-
Es verdadero de forma predeterminada y muestra el destino del archivo fuente. Si es verdadero, muestra la ubicación de la línea 1 de los archivos de origen en los resultados de ubicación. Esta marca solo existe para la migración.
Etiquetas:terminal_output
,incompatible_change
--[no]incompatible_package_group_includes_double_slash
predeterminado: "true"-
Si está habilitada, cuando se genere el atributo "packages" de package_group, no se omitirá el "//" inicial.
Etiquetas:terminal_output
,incompatible_change
--[no]infer_universe_scope
predeterminado: “false”-
Si se establece y no se establece --universe_scope, se inferirá un valor de --universe_scope como la lista de patrones de destino únicos en la expresión de consulta. Ten en cuenta que el valor de --universe_scope inferido para una expresión de consulta que usa funciones centradas en el universo (p.ej., "allrdeps") puede no ser lo que deseas, por lo que debes usar esta opción solo si sabes lo que estás haciendo. Consulta https://bazel.build/query/language#sky-query para obtener detalles y ejemplos. Si se establece --universe_scope, se ignora el valor de esta opción. Nota: Esta opción solo se aplica a "query" (es decir, no a "cquery").
Etiquetas:loading_and_analysis
--[no]line_terminator_null
predeterminado: “false”-
Indica si cada formato finaliza con \0 en lugar de una línea nueva.
Etiquetas:terminal_output
--[no]nodep_deps
predeterminado: "true"-
Si está habilitada, las dependencias de los atributos "nodep" se incluirán en el gráfico de dependencias sobre el que opera la consulta. Un ejemplo común de un atributo "nodep" es "visibility". Ejecuta y analiza el resultado de "info build-language" para obtener información sobre todos los atributos "nodep" en el lenguaje de compilación.
Etiquetas:build_file_semantics
--output=<a string>
predeterminado: "label"-
Es el formato en el que se deben imprimir los resultados de la cquery. Los valores permitidos para cquery son: etiqueta, etiqueta_tipo, textoproto, transiciones, 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á habilitada, los atributos configurables creados por select() se aplanan. En el caso de los tipos de lista, la representación aplanada es una lista que contiene cada valor del mapa de selección exactamente una vez. Los tipos escalares se aplanan a nulos.
Etiquetas:build_file_semantics
--[no]proto:include_configurations
predeterminado: "true"-
Si está habilitado, el resultado de proto incluirá información sobre las configuraciones. Cuando se inhabilita,el formato de salida de cquery proto se asemeja al formato de salida de la consulta.
Etiquetas:affects_outputs
--[no]proto:include_synthetic_attribute_hash
predeterminado: “false”-
Indica si se debe calcular y propagar el atributo $internal_attr_hash.
Etiquetas:terminal_output
--[no]proto:instantiation_stack
predeterminado: “false”-
Propaga la pila de llamadas de creación de instancias de cada regla. Ten en cuenta que esto requiere que la pila esté presente.
Etiquetas:terminal_output
--[no]proto:locations
predeterminado: "true"-
Indica si se debe generar información de ubicación en el resultado de proto.
Etiquetas:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
predeterminado: “all”-
Es una lista de atributos separados por comas que se deben incluir en el resultado. La configuración predeterminada es todos los atributos. Establece una cadena vacía para no mostrar ningún atributo. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
--[no]proto:rule_inputs_and_outputs
predeterminado: "true"-
Indica si se propagan o no los campos rule_input y rule_output.
Etiquetas:terminal_output
--[no]relative_locations
predeterminado: “false”-
Si es verdadero, la ubicación de los archivos BUILD en los resultados de xml y proto será relativa. De forma predeterminada, el resultado de la ubicación es una ruta de acceso absoluta y no será coherente en todas las máquinas. Puedes establecer esta opción en verdadero para obtener un resultado coherente en todas las máquinas.
Etiquetas:terminal_output
--show_config_fragments=<off, direct or transitive>
predeterminado: "off"-
Muestra los fragmentos de configuración que requiere una regla y sus dependencias transitivas. Esto puede ser útil para evaluar cuánto se puede recortar un gráfico objetivo configurado.
Etiquetas:affects_outputs
--starlark:expr=<a string>
predeterminado: ""-
Es una expresión Starlark para dar formato a cada destino configurado en el modo --output=starlark de cquery. El objetivo configurado está vinculado a "target". Si no se especifican --starlark:expr ni --starlark:file, esta opción se establecerá de forma predeterminada en "str(target.label)". Especificar --starlark:expr y --starlark:file es un error.
Etiquetas:terminal_output
--starlark:file=<a string>
predeterminado: ""-
Es el nombre de un archivo que define una función Starlark llamada "format", de un argumento, que se aplica a cada destino configurado para darle formato como una cadena. Especificar --starlark:expr y --starlark:file es un error. Consulta la ayuda de --output=starlark para obtener más detalles.
Etiquetas:terminal_output
--[no]tool_deps
predeterminado: "true"-
Consulta: Si se inhabilita, las dependencias de los destinos de "configuración del host" o "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 del host", como el de cualquier regla "proto_library" al compilador de protocolos, suele apuntar a una herramienta que se ejecuta durante la compilación en lugar de a una parte del mismo programa "objetivo".
Cquery: Si se inhabilita, filtra todos los objetivos configurados que cruzan un host o una transición de ejecución desde el objetivo de nivel superior que descubrió este objetivo configurado. Esto significa que, si el objetivo de nivel superior está en la configuración de destino, solo se mostrarán los objetivos configurados también en la configuración de destino. Si el destino de nivel superior está en la configuración del host, solo se mostrarán los destinos configurados por el host. Esta opción NO excluirá las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
- Valor predeterminado de
--transitions=<full, lite or none>
: “none” -
Es el formato en el que cquery imprimirá la información de transición.
Etiquetas:affects_outputs
--universe_scope=<comma-separated list of options>
predeterminado: ""-
Es un conjunto de patrones de destino (aditivos y sustractivos) separados por comas. La consulta se puede realizar en el universo definido por el cierre transitivo de los destinos especificados. Esta opción se usa para los comandos query y cquery.
En el caso de cquery, la entrada de esta opción son los objetivos en los que se compilan todas las respuestas, por lo que esta opción puede afectar las configuraciones y las transiciones. Si no se especifica esta opción, se supone que los destinos de nivel superior son los que se analizaron de la expresión de consulta. Nota: En el caso de cquery, si no se especifica esta opción, es posible que la compilación falle si los destinos analizados de la expresión de consulta no se pueden compilar con opciones de nivel superior.
Etiquetas:loading_and_analysis
- Opciones que activan optimizaciones del tiempo de compilación:
--[no]collapse_duplicate_defines
predeterminado: “false”-
Cuando se habilita, se quitarán los --defines redundantes al principio de la compilación. Esto evita la pérdida innecesaria de la caché de análisis para ciertos tipos de compilaciones equivalentes.
Etiquetas:loading_and_analysis
,loses_incremental_state
--[no]experimental_filter_library_jar_with_program_jar
predeterminado: “false”-
Filtra el ProgramJar de ProGuard para quitar las clases que también estén presentes en el LibraryJar.
Etiquetas:action_command_lines
--[no]experimental_inmemory_dotd_files
predeterminado: "true"-
Si se habilita, los archivos .d de C++ se pasarán en la memoria directamente desde los nodos de compilación remotos en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_inmemory_jdeps_files
predeterminado: "true"-
Si está habilitado, los archivos de dependencia (.jdeps) generados a partir de compilaciones de Java se pasarán en la memoria directamente desde los nodos de compilación remotos en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_objc_include_scanning
predeterminado: “false”-
Indica si se debe incluir el análisis de C/C++ objetivo.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
--[no]experimental_parse_headers_skipped_if_corresponding_srcs_found
predeterminado: “false”-
Si está habilitada, la función parse_headers no crea una acción de compilación de encabezados independiente si se encuentra una fuente con el mismo nombre de base en el mismo destino.
Etiquetas:loading_and_analysis
,affects_outputs
--[no]experimental_retain_test_configuration_across_testonly
predeterminado: “false”-
Cuando se habilita, --trim_test_configuration no recortará la configuración de prueba de las reglas marcadas como testonly=1. Esto se hace para reducir los problemas de conflicto de acciones cuando las reglas que no son de prueba dependen de las reglas de cc_test. No tiene efecto si --trim_test_configuration es falso.
Etiquetas:loading_and_analysis
,loses_incremental_state
--[no]experimental_starlark_cc_import
predeterminado: “false”-
Si está habilitada, se puede usar la versión de Starlark de cc_import.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_unsupported_and_brittle_include_scanning
predeterminado: “false”-
Determina si se deben reducir las entradas a la compilación de C/C++ a través del análisis de líneas #include de los archivos de entrada. Esto puede mejorar el rendimiento y la incrementalidad, ya que reduce el tamaño de los árboles de entrada de compilación. Sin embargo, también puede interrumpir las compilaciones porque el escáner de inclusión no implementa por completo la semántica del preprocesador C. En particular, no comprende las directivas #include dinámicas y omite la lógica condicional del preprocesador. Úsala bajo tu propia responsabilidad. Se cerrarán todos los problemas relacionados con esta marca que se hayan presentado.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
--[no]incremental_dexing
predeterminado: "true"-
Realiza la mayor parte del trabajo de dexing por separado para cada archivo JAR.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]objc_use_dotd_pruning
predeterminado: "true"-
Si se establece, los archivos .d emitidos por clang se usarán para podar el conjunto de entradas que se pasan a las compilaciones de objc.
Etiquetas:changes_inputs
,loading_and_analysis
--[no]process_headers_in_dependencies
predeterminado: “false”-
Cuando compilas un destino //a:a, procesa los encabezados en todos los destinos de los que depende //a:a (si el procesamiento de encabezados está habilitado para la cadena de herramientas).
Etiquetas:execution
--[no]trim_test_configuration
predeterminado: "true"-
Cuando se habilita, se borran las opciones relacionadas con las pruebas debajo del nivel superior de la compilación. Cuando esta marca está activa, las pruebas no se pueden compilar como dependencias de reglas que no son de prueba, pero los cambios en las opciones relacionadas con las pruebas no harán que se vuelvan a analizar las reglas que no son de prueba.
Etiquetas:loading_and_analysis
,loses_incremental_state
--[no]use_singlejar_apkbuilder
predeterminado: "true"-
Esta opción está obsoleta. Ahora no se puede usar y se quitará pronto.
Etiquetas:loading_and_analysis
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Valor predeterminado de
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: “-.*”. -
Imprime información de depuración durante la resolución de la cadena de herramientas. La marca toma una regex, que se compara con los tipos de cadena de herramientas y los objetivos específicos para ver cuál depurar. Se pueden separar varias regex con comas y, luego, cada una se verifica por separado. Nota: El resultado de esta marca es muy complejo y es probable que solo sea útil para expertos en la resolución de cadenas de herramientas.
Etiquetas:terminal_output
- Son opciones que especifican o alteran una entrada genérica en un comando de Bazel que no pertenece a otras categorías.:
- Se acumulan varios usos de
--flag_alias=<a 'name=value' flag alias>
-
Establece un nombre abreviado para una marca de Starlark. Toma un solo par clave-valor en el formato "<clave>=<valor>" como argumento.
Etiquetas:changes_inputs
--[no]incompatible_default_to_explicit_init_py
predeterminado: “false”-
Esta marca cambia el comportamiento predeterminado para que los archivos __init__.py ya no se creen automáticamente en los archivos de ejecución de los destinos de Python. Específicamente, cuando un objetivo py_binary o py_test tiene legacy_create_init establecido en "auto" (el valor predeterminado), se considera falso solo si se establece esta marca. Consulta https://github.com/bazelbuild/bazel/issues/10076.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_py2_outputs_are_suffixed
predeterminado: "true"-
Si es verdadero, los destinos compilados en la configuración de Python 2 aparecerán en una raíz de salida que incluye el sufijo “-py2”, mientras que los destinos compilados para Python 3 aparecerán en una raíz sin sufijo relacionado con Python. Esto significa que el symlink de conveniencia "bazel-bin" apuntará a destinos de Python 3 en lugar de Python 2. Si habilitas esta opción, también se recomienda habilitar `--incompatible_py3_is_default`.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_py3_is_default
predeterminado: "true"-
Si es verdadero, los destinos "py_binary" y "py_test" que no establezcan su atributo "python_version" (o "default_python_version") usarán PY3 de forma predeterminada en lugar de PY2. Si estableces esta marca, también se recomienda establecer `--incompatible_py2_outputs_are_suffixed`.
Etiquetas:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_use_python_toolchains
predeterminado: "true"-
Si se establece como verdadero, las reglas ejecutables de Python nativas usarán el entorno de ejecución de Python especificado por la cadena de herramientas de Python, en lugar del entorno de ejecución que proporcionan las marcas heredadas, como --python_top.
Etiquetas:loading_and_analysis
,incompatible_change
--python_version=<PY2 or PY3>
predeterminado: Consulta la descripción-
Es el modo de versión principal de Python, ya sea "PY2" o "PY3". Ten en cuenta que esto se anula con los destinos "py_binary" y "py_test" (incluso si no especifican una versión de forma explícita), por lo que, por lo general, no hay muchos motivos para proporcionar esta marca.
Etiquetas:loading_and_analysis
,affects_outputs
,explicit_in_output_path
- Opciones misceláneas que no se clasifican de otra manera:
--[no]cache_test_results
[-t
] predeterminado: "auto"- Si se establece en “auto”, Bazel vuelve a ejecutar una prueba solo si se cumplen las siguientes condiciones: (1) Bazel detecta cambios en la prueba o sus dependencias, (2) la prueba está marcada como externa, (3) se solicitaron varias ejecuciones de prueba con --runs_per_test o(4) la prueba falló anteriormente. Si se establece como "yes", Bazel almacena en caché todos los resultados de las pruebas, excepto las marcadas como externas. Si se establece en "no", Bazel no almacena en caché ningún resultado de la prueba.
--[no]experimental_cancel_concurrent_tests
predeterminado: “false”-
Si es verdadero, Blaze cancelará las pruebas que se ejecutan de forma simultánea en la primera ejecución correcta. Esto solo es útil en combinación con --runs_per_test_detects_flakes.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_fetch_all_coverage_outputs
predeterminado: “false”-
Si es verdadero, Bazel recupera todo el directorio de datos de cobertura para cada prueba durante una ejecución de cobertura.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_generate_llvm_lcov
predeterminado: “false”-
Si es verdadero, la cobertura de clang generará un informe LCOV.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_j2objc_header_map
predeterminado: "true"- Determina si se debe generar un mapa de encabezados de J2ObjC en paralelo con la transpilación de J2ObjC.
--[no]experimental_j2objc_shorter_header_path
predeterminado: “false”-
Indica si se debe generar con una ruta de encabezado más corta (usa “_ios” en lugar de “_j2objc”).
Etiquetas:affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
predeterminado: "javabuilder"- Habilita classpaths reducidos para compilaciones de Java.
--[no]experimental_limit_android_lint_to_android_constrained_java
predeterminado: “false”-
Limita --experimental_run_android_lint_on_java_rules a las bibliotecas compatibles con Android.
Etiquetas:affects_outputs
--[no]experimental_run_android_lint_on_java_rules
predeterminado: “false”-
Determina si se deben validar las fuentes java_*.
Etiquetas:affects_outputs
--[no]explicit_java_test_deps
predeterminado: “false”- Especifica de forma explícita una dependencia a JUnit o Hamcrest en un java_test en lugar de obtenerla accidentalmente de las dependencias de TestRunner. Por el momento, solo funciona para bazel.
--host_java_launcher=<a build target label>
predeterminado: Consulta la descripción- Es el selector de Java que usan las herramientas que se ejecutan durante una compilación.
- Se acumulan varios usos de
--host_javacopt=<a string>
- Opciones adicionales para pasar a javac cuando se compilan herramientas que se ejecutan durante una compilación.
- Se acumulan varios usos de
--host_jvmopt=<a string>
- Opciones adicionales para pasar a la VM de Java cuando se compilan herramientas que se ejecutan durante la compilación. Estas opciones se agregarán a las opciones de inicio de la VM de cada destino java_binary.
--[no]incompatible_exclusive_test_sandboxed
predeterminado: “false”-
Si es verdadero, las pruebas exclusivas se ejecutarán con la estrategia de zona de pruebas. Agrega la etiqueta "local" para forzar que se ejecute una prueba exclusiva de forma local.
Etiquetas:incompatible_change
--[no]incompatible_strict_action_env
predeterminado: “false”-
Si es verdadero, Bazel usa un entorno con un valor estático para PATH y no hereda LD_LIBRARY_PATH. Usa --action_env=ENV_VARIABLE si deseas heredar variables de entorno específicas del cliente, pero ten en cuenta que, de esta manera, se puede evitar la caché entre usuarios si se usa una caché compartida.
Etiquetas:loading_and_analysis
,incompatible_change
- Se acumulan varios usos de
--j2objc_translation_flags=<comma-separated list of options>
- : Opciones adicionales para pasar a la herramienta J2ObjC.
--java_debug
-
Hace que la máquina virtual de Java de una prueba de Java espere una conexión de un depurador compatible con JDWP (como jdb) antes de iniciar la prueba. Implica -test_output=streamed.
Se expande a:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
--[no]java_deps
predeterminado: "true"- Genera información de dependencia (por ahora, el classpath del tiempo de compilación) por destino de Java.
--[no]java_header_compilation
predeterminado: "true"- Compila ijars directamente desde la fuente.
--java_language_version=<a string>
predeterminado: “8”- La versión del lenguaje Java
--java_launcher=<a build target label>
predeterminado: Consulta la descripción- Es el selector de Java que se usará cuando se compilen objetos binarios de Java. Si esta marca se establece en la cadena vacía, se usa el selector de JDK. El atributo "launcher" anula esta marca.
--java_runtime_version=<a string>
predeterminado: "local_jdk"- La versión del entorno de ejecución de Java
- Se acumulan varios usos de
--javacopt=<a string>
. - Opciones adicionales para pasar a javac.
- Se acumulan varios usos de
--jvmopt=<a string>
- Opciones adicionales para pasar a la VM de Java. Estas opciones se agregarán a las opciones de inicio de la VM de cada destino java_binary.
--legacy_main_dex_list_generator=<a build target label>
predeterminado: Consulta la descripción- especifica un objeto binario que se usará para generar la lista de clases que deben estar en el archivo DEX principal cuando se compila el multidex heredado.
- Se acumulan varios usos de
--plugin=<a build target label>
- Plug-ins para usar en la compilación. Actualmente, funciona con java_plugin.
--proguard_top=<a build target label>
predeterminado: Consulta la descripción- Especifica qué versión de ProGuard se usará para quitar el código cuando se compila un objeto binario de Java.
--proto_compiler=<a build target label>
predeterminado: "@bazel_tools//tools/proto:protoc"-
Es la etiqueta del protocompilador.
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
predeterminado: "@bazel_tools//tools/proto:cc_toolchain"-
Etiqueta de proto_lang_toolchain(), que describe cómo compilar protos de C++
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
predeterminado: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"-
Etiqueta de proto_lang_toolchain(), que describe cómo compilar protos de j2objc
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
predeterminado: "@bazel_tools//tools/proto:java_toolchain"-
Etiqueta de proto_lang_toolchain(), que describe cómo compilar protos de Java
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
predeterminado: "@bazel_tools//tools/proto:javalite_toolchain"-
Etiqueta de proto_lang_toolchain(), que describe cómo compilar protos de JavaLite
Etiquetas:affects_outputs
,loading_and_analysis
- Se acumulan varios usos de
--protocopt=<a string>
-
Opciones adicionales para pasar al compilador de protobuf.
Etiquetas:affects_outputs
--[no]runs_per_test_detects_flakes
predeterminado: “false”- Si es verdadero, cualquier fragmento en el que se apruebe al menos una ejecución o intento y falle al menos una ejecución o intento obtiene un estado FLAKY.
--shell_executable=<a path>
predeterminado: Consulta la descripción-
Ruta de acceso absoluta al ejecutable de shell que usará Bazel. Si no se establece, pero la variable de entorno BAZEL_SH se establece en la primera invocación de Bazel (que inicia un servidor de Bazel), Bazel la usará. Si no se establece ninguno, Bazel usa una ruta de acceso predeterminada fija según el sistema operativo en el que se ejecuta (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, todos los demás: /bin/bash). Ten en cuenta que usar un shell que no sea compatible con bash puede generar fallas de compilación o de tiempo de ejecución de los objetos binarios generados.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--test_arg=<a string>
- Especifica opciones y argumentos adicionales que se deben pasar al ejecutable de prueba. Se puede usar varias veces para especificar varios argumentos. Si se ejecutan varias pruebas, cada una de ellas recibirá argumentos idénticos. Solo lo usa el comando "bazel test".
--test_filter=<a string>
predeterminado: Consulta la descripción- : Especifica un filtro para reenviar al framework de pruebas. Se usa para limitar las pruebas que se ejecutan. Ten en cuenta que esto no afecta los destinos que se compilan.
--test_result_expiration=<an integer>
predeterminado: “-1”- Esta opción está obsoleta y no tiene ningún efecto.
--[no]test_runner_fail_fast
predeterminado: “false”- Redirecciona la opción de falla rápida al ejecutor de pruebas. El ejecutor de pruebas debe detener la ejecución en la primera falla.
--test_sharding_strategy=<explicit or disabled>
predeterminado: "explicit"- Especifica la estrategia para el fragmentación de prueba: "explicit" para usar solo la fragmentación si está presente el atributo BUILD "shard_count". "disabled" para nunca usar el fragmentación de prueba.
--tool_java_language_version=<a string>
predeterminado: “8”- La versión del lenguaje Java que se usa para ejecutar las herramientas necesarias durante una compilación
--tool_java_runtime_version=<a string>
predeterminado: "remotejdk_11"- La versión del entorno de ejecución de Java que se usa para ejecutar herramientas durante la compilación
--[no]use_ijars
predeterminado: "true"- Si está habilitada, esta opción hace que la compilación de Java use archivos JAR de interfaz. Esto generará una compilación incremental más rápida, pero los mensajes de error pueden ser diferentes.
Opciones de volcado
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
-
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
predeterminado: “false”-
Si es verdadero, usa una cadena derivada de las URLs de las descargas del repositorio como canonical_id si no se especifica. Esto hace que un cambio en las URLs genere una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no hagan que la caché oculte los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
predeterminado: “false”-
Si se establece, no se permite descargar repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, se puede hacer que los repositorios externos funcionen en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que controlan el resultado del comando:
--[no]action_cache
predeterminado: “false”-
Escribe el contenido de la caché de acciones.
Etiquetas:bazel_monitoring
--[no]packages
predeterminado: “false”-
Ejecuta el volcado del contenido de la caché del paquete.
Etiquetas:bazel_monitoring
--[no]rule_classes
predeterminado: “false”-
Ejecuta el volcado de clases de reglas.
Etiquetas:bazel_monitoring
--[no]rules
predeterminado: “false”-
Reglas de volcado, incluidos los recuentos y el uso de memoria (si se realiza un seguimiento de la memoria)
Etiquetas:bazel_monitoring
--skyframe=<off, summary, count, deps or rdeps>
predeterminado: "off"-
Ejecuta el comando para volcar el gráfico de Skyframe: "off", "summary", "count", "deps" o "rdeps".
Etiquetas:bazel_monitoring
- Valor predeterminado de
--skykey_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: “.*”. -
Filtro de regex de nombres de SkyKey para la salida. Solo se usa con --skyframe=deps, rdeps.
Etiquetas:bazel_monitoring
--skylark_memory=<a string>
predeterminado: Consulta la descripción-
Descarga un perfil de memoria compatible con pprof en la ruta especificada. Para obtener más información, consulta https://github.com/google/pprof.
Etiquetas:bazel_monitoring
- Opciones que afectan la rigurosidad con la que Bazel aplica entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
--experimental_repository_hash_file=<a string>
predeterminado: ""-
Si no está vacío, especifica un archivo que contiene un valor resuelto, con el que se deben verificar los valores hash del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan varios usos de
--experimental_verify_repository_rules=<a string>
-
Si es una lista de reglas de repositorio para las que se debe verificar el hash del directorio de salida, siempre que se especifique un archivo con --experimental_repository_hash_file.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: "true"-
Etiquetas
sin operación:no_op
,deprecated
,experimental
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
-
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitados en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "advertencia" -
Verifica si las dependencias directas de "bazel_dep" declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivarla a un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
- Anula un módulo con un directorio local.
- Se acumulan varios usos de
--registry=<a string>
-
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
- Opciones que especifican o alteran una entrada genérica en un comando de Bazel que no se incluye en otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
- Anula un repositorio con un directorio local.
Opciones de recuperación
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
-
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
predeterminado: “false”-
Si es verdadero, usa una cadena derivada de las URLs de las descargas del repositorio como canonical_id si no se especifica. Esto hace que un cambio en las URLs genere una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no provoquen que la caché oculte los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
predeterminado: “false”-
Si se establece, no se permite descargar repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, se puede hacer que los repositorios externos funcionen en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de la compilación:
--[no]incompatible_remote_dangling_symlinks
predeterminado: "true"-
Si se establece en "true" y --incompatible_remote_symlinks también es "true", los symlinks en los resultados de la acción pueden colgar.
Etiquetas:execution
,incompatible_change
--[no]incompatible_remote_symlinks
predeterminado: "true"-
Si se establece como verdadero, Bazel representará los symlinks en los resultados de la acción en el protocolo de ejecución o almacenamiento en caché remoto como tal. De lo contrario, se seguirán los symlinks y se representarán como archivos o directorios. Consulta el problema #6631 para obtener más información.
Etiquetas:execution
,incompatible_change
--[no]keep_going
[-k
] predeterminado: "false"-
Continúa tanto como sea posible después de un error. Si bien no se pueden analizar el objetivo que falló ni los que dependen de él, sí se pueden analizar otros requisitos previos de estos objetivos.
Etiquetas:eagerness_to_exit
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
predeterminado: “auto”-
Cantidad de subprocesos en paralelo que se usarán para la fase de carga o análisis. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". "auto" establece un valor predeterminado razonable según los recursos del host. Debe ser 1 como mínimo.
Etiquetas:bazel_internal_configuration
- Son opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
--bep_maximum_open_remote_upload_files=<an integer>
predeterminado: “-1”-
Cantidad máxima de archivos abiertos permitidos durante la carga de artefactos de BEP.
Etiquetas:affects_outputs
--remote_download_minimal
-
No descarga ningún resultado de compilación remota a la máquina local. Esta marca es un atajo para las marcas: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata y --remote_download_outputs=minimal.
Se expande a:
--nobuild_runfile_links
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=minimal
Etiquetas:affects_outputs
--remote_download_outputs=<all, minimal or toplevel>
predeterminado: “all”-
Si se establece en "minimal", no se descargan resultados de compilación remotas en la máquina local, excepto los que requieren las acciones locales. Si se establece en "toplevel", se comporta como "minimal", excepto que también descarga los resultados de los destinos de nivel superior en la máquina local. Ambas opciones pueden reducir significativamente los tiempos de compilación si el ancho de banda de la red es un cuello de botella.
Etiquetas:affects_outputs
--remote_download_symlink_template=<a string>
predeterminado: ""-
En lugar de descargar resultados de compilación remotos en la máquina local, crea vínculos simbólicos. El destino de los vínculos simbólicos se puede especificar en forma de una cadena de plantilla. Esta cadena de plantilla puede contener {hash} y {size_bytes} que se expanden al hash del objeto y al tamaño en bytes, respectivamente. Estos vínculos simbólicos pueden, por ejemplo, apuntar a un sistema de archivos FUSE que cargue objetos del CAS a pedido.
Etiquetas:affects_outputs
--remote_download_toplevel
- Solo descarga resultados remotos de destinos de nivel superior en la máquina local. Esta marca es un atajo para las marcas: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata y --remote_download_outputs=toplevel.
Se expande a:
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=toplevel
Etiquetas:affects_outputs
- Opciones que afectan la rigurosidad con la que Bazel aplica entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etc.):
--experimental_repository_hash_file=<a string>
predeterminado: ""-
Si no está vacío, especifica un archivo que contiene un valor resuelto, con el que se deben verificar los valores hash del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan varios usos de
--experimental_verify_repository_rules=<a string>
-
Si es una lista de reglas de repositorio para las que se debe verificar el hash del directorio de salida, siempre que se especifique un archivo con --experimental_repository_hash_file.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: "true"-
Etiquetas
sin operación:no_op
,deprecated
,experimental
--[no]incompatible_config_setting_private_default_visibility
predeterminado: “false”-
Si incompatible_enforce_config_setting_visibility=false, esto es una operación no realizada. De lo contrario, si esta marca es falsa, cualquier config_setting sin un atributo de visibilidad explícito es //visibility:public. Si esta marca es verdadera, config_setting sigue la misma lógica de visibilidad que todas las demás reglas. Consulta https://github.com/bazelbuild/bazel/issues/12933.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
predeterminado: "true"-
Si es verdadero, aplica las restricciones de visibilidad de config_setting. Si es falso, todos los config_setting son visibles para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
-
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitados en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "advertencia" -
Verifica si las dependencias directas de "bazel_dep" declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivarla a un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
. - Anula un módulo con un directorio local.
- Se acumulan varios usos de
--registry=<a string>
-
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
--experimental_repository_resolved_file=<a string>
predeterminado: ""-
Si no está vacío, escribe un valor de Starlark con la información resuelta de todas las reglas del repositorio de Starlark que se ejecutaron.
Etiquetas:affects_outputs
- Valor predeterminado de
--remote_print_execution_messages=<failure, success or all>
: “failure” -
Elige cuándo imprimir los mensajes de ejecución remota. Los valores válidos son "failure" para imprimir solo en caso de fallas, "success" para imprimir solo en caso de éxitos y "all" para imprimir siempre.
Etiquetas:terminal_output
- Son opciones que especifican o alteran una entrada genérica en un comando de Bazel que no pertenece a otras categorías.:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
--[no]experimental_guard_against_concurrent_changes
predeterminado: “false”- Desactiva esta opción para inhabilitar la verificación del ctime de los archivos de entrada de una acción antes de subirla a una caché remota. Puede haber casos en los que el kernel de Linux retrase la escritura de archivos, lo que podría generar falsos positivos.
--experimental_remote_build_event_upload=<all or minimal>
predeterminado: “all”- Si se establece en “todos”, todos los resultados locales a los que hace referencia BEP se suben a la caché remota. Si se establece en “minimal”, los resultados locales a los que hace referencia BEP no se suben a la caché remota, excepto los archivos que son importantes para los consumidores de BEP (p.ej., registros de prueba y perfil de tiempo). Se usa el esquema file:// para las rutas de acceso de los archivos locales y el esquema bytestream:// para las rutas de acceso de los archivos (ya) subidos. El valor predeterminado es “all”.
--[no]experimental_remote_cache_async
predeterminado: “false”- Si es verdadero, las operaciones de E/S de caché remota se realizarán en segundo plano en lugar de hacerlo como parte de un inicio.
--[no]experimental_remote_cache_compression
predeterminado: “false”- Si está habilitado, comprime o descomprime los blobs de caché con zstd.
--experimental_remote_capture_corrupted_outputs=<a path>
predeterminado: Consulta la descripción- Es una ruta de acceso a un directorio en el que se capturarán los resultados dañados.
--experimental_remote_downloader=<a string>
predeterminado: Consulta la descripción- Es un URI de extremo de la API de Remote Asset que se usará como proxy de descarga remoto. Los esquemas admitidos son grpc, grpcs (grpc con TLS habilitado) y unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel usará grpcs de forma predeterminada. Consulta: https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto
--[no]experimental_remote_downloader_local_fallback
predeterminado: “false”- Indica si se debe recurrir al descargador local si falla el descargador remoto.
--[no]experimental_remote_execution_keepalive
predeterminado: “false”- Indica si se debe usar el mantenimiento de la conexión para las llamadas de ejecución remotas.
--experimental_remote_grpc_log=<a path>
predeterminado: Consulta la descripción- Si se especifica, es una ruta de acceso a un archivo para registrar los detalles relacionados con las llamadas de gRPC. Este registro consta de una secuencia de protobufs com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry serializados con cada mensaje con un prefijo de varint que indica el tamaño del siguiente mensaje de protobuf serializado, como lo realiza el método LogEntry.writeDelimitedTo(OutputStream).
--[no]experimental_remote_mark_tool_inputs
predeterminado: “false”- Si se establece como verdadero, Bazel marcará las entradas como entradas de herramientas para el ejecutor remoto. Esto se puede usar para implementar trabajadores persistentes remotos.
--[no]experimental_remote_merkle_tree_cache
predeterminado: “false”- Si se establece como verdadero, los cálculos del árbol de Merkle se almacenarán en caché para mejorar la velocidad de verificación de hits de caché remotos. El espacio en memoria de la caché se controla con --experimental_remote_merkle_tree_cache_size.
--experimental_remote_merkle_tree_cache_size=<a long integer>
predeterminado: “1000”- Es la cantidad de árboles de Merkle que se deben almacenar en caché para mejorar la velocidad de verificación de aciertos de caché remotos. Aunque la caché se poda automáticamente según el manejo de referencias suaves de Java, pueden ocurrir errores de falta de memoria si se establece demasiado alta. Si se establece en 0, el tamaño de la caché es ilimitado. El valor óptimo varía según el tamaño del proyecto. El valor predeterminado es 1,000.
--[no]incompatible_remote_build_event_upload_respect_no_cache
predeterminado: “false”- Si se establece como verdadero, los resultados a los que hace referencia BEP no se suben a la caché remota si la acción de generación no se puede almacenar en caché de forma remota.
--[no]incompatible_remote_downloader_send_all_headers
predeterminado: "true"-
Indica si se deben enviar todos los valores de un encabezado con varios valores al descargador remoto en lugar de solo el primero.
Etiquetas:incompatible_change
--[no]incompatible_remote_output_paths_relative_to_input_root
predeterminado: “false”-
Si se establece como verdadero, las rutas de acceso de salida son relativas a la raíz de entrada en lugar del directorio de trabajo.
Etiquetas:incompatible_change
--[no]incompatible_remote_results_ignore_disk
predeterminado: "true"-
Si se establece como verdadero, --noremote_upload_local_results y --noremote_accept_cached no se aplicarán a la caché del disco. Si se usa una caché combinada,
--noremote_upload_local_results hará que los resultados se escriban en la caché del disco, pero no se suban a la caché remota.
--noremote_accept_cached hará que Bazel busque resultados en la caché del disco, pero no en la caché remota.
Las acciones sin ejecución remota pueden afectar la caché del disco.
Consulta #8216 para obtener más información.
Etiquetas:incompatible_change
--[no]remote_accept_cached
predeterminado: "true"- Indica si se aceptan los resultados de las acciones almacenadas en caché de forma remota.
--remote_bytestream_uri_prefix=<a string>
predeterminado: Consulta la descripción- Es el nombre de host y el nombre de la instancia que se usarán en los URIs bytestream:// que se escriben en los flujos de eventos de compilación. Esta opción se puede establecer cuando las compilaciones se realizan con un proxy, lo que hace que los valores de --remote_executor y --remote_instance_name ya no correspondan al nombre canónico del servicio de ejecución remota. Si no se establece, el valor predeterminado será “${hostname}/${instance_name}”.
--remote_cache=<a string>
predeterminado: Consulta la descripción- Es un URI de un extremo de almacenamiento en caché. Los esquemas compatibles son http, https, grpc, grpcs (grpc con TLS habilitado) y unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel usará grpcs de forma predeterminada. Especifica el esquema grpc://, http:// o unix: para inhabilitar TLS. Consulta https://bazel.build/remote/caching
- Se acumulan varios usos de
--remote_cache_header=<a 'name=value' assignment>
. - Especifica un encabezado que se incluirá en las solicitudes de caché: --remote_cache_header=Nombre=Valor. Se pueden pasar varios encabezados si especificas la marca varias veces. Los múltiples valores para el mismo nombre se convertirán en una lista separada por comas.
- Se acumulan varios usos de
--remote_default_exec_properties=<a 'name=value' assignment>
. -
Establece las propiedades de ejecución predeterminadas que se usarán como la plataforma de ejecución remota si una plataforma de ejecución aún no establece exec_properties.
Etiquetas:affects_outputs
--remote_default_platform_properties=<a string>
predeterminado: ""- Establece las propiedades de plataforma predeterminadas que se establecerán para la API de ejecución remota, si la plataforma de ejecución aún no establece remote_execution_properties. Este valor también se usará si se selecciona la plataforma host como la plataforma de ejecución para la ejecución remota.
- Se acumulan varios usos de
--remote_downloader_header=<a 'name=value' assignment>
. - Especifica un encabezado que se incluirá en las solicitudes del descargador remoto: --remote_downloader_header=Nombre=Valor. Se pueden pasar varios encabezados si especificas la marca varias veces. Los múltiples valores para el mismo nombre se convertirán en una lista separada por comas.
- Se acumulan varios usos de
--remote_exec_header=<a 'name=value' assignment>
. - Especifica un encabezado que se incluirá en las solicitudes de ejecución: --remote_exec_header=Nombre=Valor. Se pueden pasar varios encabezados si especificas la marca varias veces. Los múltiples valores para el mismo nombre se convertirán en una lista separada por comas.
--remote_execution_priority=<an integer>
predeterminado: “0”- Es la prioridad relativa de las acciones que se ejecutarán de forma remota. La semántica de los valores de prioridad particulares depende del servidor.
--remote_executor=<a string>
predeterminado: Consulta la descripción- HOST o HOST:PORT de un extremo de ejecución remota. Los esquemas admitidos son grpc, grpcs (grpc con TLS habilitado) y unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel usará grpcs de forma predeterminada. Especifica el esquema grpc:// o unix: para inhabilitar TLS.
- Se acumulan varios usos de
--remote_header=<a 'name=value' assignment>
. - Especifica un encabezado que se incluirá en las solicitudes: --remote_header=Nombre=Valor. Se pueden pasar varios encabezados si especificas la marca varias veces. Los múltiples valores para el mismo nombre se convertirán en una lista separada por comas.
--remote_instance_name=<a string>
predeterminado: ""- Es el valor que se pasa como instance_name en la API de ejecución remota.
--[no]remote_local_fallback
predeterminado: “false”- Determina si se debe recurrir a la estrategia de ejecución local independiente si falla la ejecución remota.
--remote_local_fallback_strategy=<a string>
predeterminado: “local”- No realiza ninguna acción, está obsoleto. Consulta https://github.com/bazelbuild/bazel/issues/7480 para obtener más información.
--remote_max_connections=<an integer>
predeterminado: "100"-
Limita la cantidad máxima de conexiones simultáneas a la caché o al ejecutor remotos. De forma predeterminada, el valor es 100. Si lo estableces en 0, no habrá limitaciones.
Para la caché remota de HTTP, una conexión TCP podría controlar una solicitud a la vez, por lo que Bazel podría realizar hasta --remote_max_connections solicitudes simultáneas.
En el caso de la caché o el ejecutor remotos de gRPC, un canal de gRPC suele poder controlar más de 100 solicitudes simultáneas, por lo que Bazel podría realizar alrededor de `--remote_max_connections * 100` solicitudes simultáneas.
Etiquetas:host_machine_resource_optimizations
--remote_proxy=<a string>
predeterminado: Consulta la descripción- Conéctate a la caché remota a través de un proxy. Actualmente, esta marca solo se puede usar para configurar un socket de dominio Unix (unix:/path/to/socket).
--remote_result_cache_priority=<an integer>
predeterminado: “0”- Es la prioridad relativa de las acciones remotas que se almacenarán en la caché remota. La semántica de los valores de prioridad particulares depende del servidor.
--remote_retries=<an integer>
predeterminado: “5”- Es la cantidad máxima de intentos para reintentar un error transitorio. Si se establece en 0, se inhabilitan los reintentos.
--remote_timeout=<An immutable length of time.>
predeterminado: "60s"- Es la cantidad máxima de tiempo que se espera para la ejecución remota y las llamadas a la caché. Para la caché de REST, este es el tiempo de espera de conexión y lectura. Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
--[no]remote_upload_local_results
predeterminado: "true"- Determina si se deben subir los resultados de las acciones ejecutadas de forma local a la caché remota si esta la admite y el usuario está autorizado para hacerlo.
--[no]remote_verify_downloads
predeterminado: "true"- Si se establece como verdadero, Bazel calculará la suma de hash de todas las descargas remotas y descartará los valores almacenados en caché de forma remota si no coinciden con el valor esperado.
- Opciones misceláneas que no se clasifican de otra manera:
--deleted_packages=<comma-separated list of package names>
predeterminado: ""- Es una lista separada por comas de nombres de paquetes que el sistema de compilación considerará inexistentes, incluso si son visibles en algún lugar de la ruta de acceso del paquete. Usa esta opción cuando borres un subpaquete "x/y" de un paquete existente "x". Por ejemplo, después de borrar x/y/BUILD en tu cliente, es posible que el sistema de compilación se queje si encuentra una etiqueta "//x:y/z" si otra entrada de package_path aún la proporciona. Especificar --deleted_packages x/y evita este problema.
--disk_cache=<a path>
predeterminado: Consulta la descripción- Es una ruta de acceso a un directorio en el que Bazel puede leer y escribir acciones y resultados de acciones. Si el directorio no existe, se creará.
- Se acumulan varios usos de
--experimental_credential_helper=<An (unresolved) path to a credential helper for a scope.>
. - Configura los auxiliares de credenciales que se usarán para recuperar credenciales para el alcance (dominio) proporcionado. Las credenciales de los asistentes de credenciales tienen prioridad sobre las credenciales de <code>--google_default_credentials</code>, `--google_credentials` o <code>.netrc</code>. Consulta https://github.com/bazelbuild/proposals/blob/main/designs/2022-06-07-bazel-credential-helpers.md para obtener más información.
--experimental_credential_helper_cache_duration=<An immutable length of time.>
predeterminado: “30m”- Configura la duración durante la cual se almacenan en caché las credenciales de los auxiliares de credenciales. Si lo invocas con un valor diferente, se ajustará la vida útil de las entradas preexistentes. Pasa cero para borrar la caché. Un comando clean siempre borra la caché, independientemente de esta marca.
--experimental_credential_helper_timeout=<An immutable length of time.>
predeterminado: "5s"- Configura el tiempo de espera del Asistente de credenciales. Si los auxiliares de credenciales no responden dentro de este tiempo de espera, la invocación fallará.
--google_auth_scopes=<comma-separated list of options>
predeterminado: "https://www.googleapis.com/auth/cloud-platform"- Es una lista separada por comas de los permisos de autenticación de Google Cloud.
--google_credentials=<a string>
predeterminado: Consulta la descripción- Especifica el archivo del que se deben obtener las credenciales de autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más información.
--[no]google_default_credentials
predeterminado: “false”- Indica si se deben usar "Credenciales predeterminadas de la aplicación de Google" para la autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más información. Está inhabilitado de forma predeterminada.
--grpc_keepalive_time=<An immutable length of time.>
predeterminado: Consulta la descripción- Configura pings de keepalive para las conexiones de gRPC salientes. Si se establece, Bazel envía pings después de este tiempo sin operaciones de lectura en la conexión, pero solo si hay al menos una llamada gRPC pendiente. Los tiempos se tratan como nivel de detalle de segundo. Es un error establecer un valor inferior a un segundo. De forma predeterminada, los pings de mantenimiento de la conexión están inhabilitados. Debes coordinar con el propietario del servicio antes de habilitar este parámetro de configuración. Por ejemplo, para establecer un valor de 30 segundos en esta marca, se debe hacer de la siguiente manera: --grpc_keepalive_time=30s
--grpc_keepalive_timeout=<An immutable length of time.>
predeterminado: "20s"- Configura un tiempo de espera de keepalive para las conexiones gRPC salientes. Si los pings de mantenimiento están habilitados con --grpc_keepalive_time, Bazel agota el tiempo de espera de una conexión si no recibe una respuesta de ping después de este tiempo. Los tiempos se tratan como nivel de detalle de segundo. Es un error establecer un valor inferior a un segundo. Si los pings de mantenimiento de la conexión están inhabilitados, se ignora este parámetro de configuración.
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
. - Anula un repositorio con un directorio local.
--package_path=<colon-separated list of options>
predeterminado: "%workspace%"- Es una lista separada por dos puntos de dónde buscar paquetes. Los elementos que comienzan con "%workspace%" son relativos al lugar de trabajo que los contiene. Si se omite o está vacío, el valor predeterminado es el resultado de "bazel info default-package-path".
--[no]show_loading_progress
predeterminado: "true"- Si está habilitado, hace que Bazel imprima mensajes de “Carga del paquete:”.
--tls_certificate=<a string>
predeterminado: Consulta la descripción- Especifica una ruta de acceso a un certificado TLS de confianza para firmar certificados de servidor.
--tls_client_certificate=<a string>
predeterminado: Consulta la descripción- Especifica el certificado de cliente TLS que se usará. También debes proporcionar una clave de cliente para habilitar la autenticación del cliente.
--tls_client_key=<a string>
predeterminado: Consulta la descripción- Especifica la clave de cliente TLS que se usará. También debes proporcionar un certificado de cliente para habilitar la autenticación del cliente.
Opciones de ayuda
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
. -
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
predeterminado: “false”-
Si es verdadero, usa una cadena derivada de las URLs de las descargas del repositorio como canonical_id si no se especifica. Esto hace que un cambio en las URLs genere una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no provoquen que la caché oculte los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
predeterminado: “false”-
Si se establece, no se permite descargar repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, los repositorios externos pueden funcionar en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que afectan la rigurosidad con la que Bazel aplica entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etc.):
--experimental_repository_hash_file=<a string>
predeterminado: ""-
Si no está vacío, especifica un archivo que contiene un valor resuelto, con el que se deben verificar los valores hash del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan varios usos de
--experimental_verify_repository_rules=<a string>
. -
Si es una lista de reglas de repositorio para las que se debe verificar el hash del directorio de salida, siempre que se especifique un archivo con --experimental_repository_hash_file.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: "true"-
Etiquetas
sin operación:no_op
,deprecated
,experimental
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
. -
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitados en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "advertencia" -
Verifica si las dependencias directas de "bazel_dep" declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivarla a un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
. - Anula un módulo con un directorio local.
- Se acumulan varios usos de
--registry=<a string>
. -
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
--help_verbosity=<long, medium or short>
predeterminado: “medium”-
Selecciona la verbosidad del comando help.
Etiquetas:affects_outputs
,terminal_output
--long
[-l
]-
Muestra la descripción completa de cada opción, en lugar de solo su nombre.
Se expande a:
--help_verbosity=long
Etiquetas:affects_outputs
,terminal_output
--short
-
Muestra solo los nombres de las opciones, no sus tipos ni significados.
Se expande a:
--help_verbosity=short
Etiquetas:affects_outputs
,terminal_output
- Opciones que especifican o alteran una entrada genérica en un comando de Bazel que no pertenece a otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
. - Anula un repositorio con un directorio local.
Opciones de información
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
. -
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
predeterminado: “false”-
Si es verdadero, usa una cadena derivada de las URLs de las descargas del repositorio como canonical_id si no se especifica. Esto hace que un cambio en las URLs genere una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no hagan que la caché oculte los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
predeterminado: “false”-
Si se establece, no se permite descargar repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, se puede hacer que los repositorios externos funcionen en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: “1.0”-
Escala todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que afectan la rigurosidad con la que Bazel aplica entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etc.):
--experimental_repository_hash_file=<a string>
predeterminado: ""-
Si no está vacío, especifica un archivo que contiene un valor resuelto, con el que se deben verificar los valores hash del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan varios usos de
--experimental_verify_repository_rules=<a string>
. -
Si es una lista de reglas de repositorio para las que se debe verificar el hash del directorio de salida, siempre que se especifique un archivo con --experimental_repository_hash_file.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: "true"-
Etiquetas
sin operación:no_op
,deprecated
,experimental
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
. -
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitados en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "advertencia" -
Verifica si las dependencias directas de "bazel_dep" declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivarla a un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
. - Anula un módulo con un directorio local.
- Se acumulan varios usos de
--registry=<a string>
. -
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
--[no]show_make_env
predeterminado: “false”-
Incluye el entorno "Make" en el resultado.
Etiquetas:affects_outputs
,terminal_output
- Son opciones que especifican o alteran una entrada genérica en un comando de Bazel que no pertenece a otras categorías.:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de almacenamiento en caché y ejecución remotas:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
. - Anula un repositorio con un directorio local.
Opciones de licencia
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
. -
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
predeterminado: “false”-
Si es verdadero, usa una cadena derivada de las URLs de las descargas del repositorio como canonical_id si no se especifica. Esto hace que un cambio en las URLs genere una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no hagan que la caché oculte los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
predeterminado: “false”-
Si se establece, no se permite descargar repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, se puede hacer que los repositorios externos funcionen en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que afectan la rigurosidad con la que Bazel aplica entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
--experimental_repository_hash_file=<a string>
predeterminado: ""-
Si no está vacío, especifica un archivo que contiene un valor resuelto, con el que se deben verificar los valores hash del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan varios usos de
--experimental_verify_repository_rules=<a string>
. -
Si es una lista de reglas de repositorio para las que se debe verificar el hash del directorio de salida, siempre que se especifique un archivo con --experimental_repository_hash_file.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: "true"-
Etiquetas
sin operación:no_op
,deprecated
,experimental
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
. -
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitados en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "advertencia" -
Verifica si las dependencias directas de "bazel_dep" declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivarla a un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
. - Anula un módulo con un directorio local.
- Se acumulan varios usos de
--registry=<a string>
. -
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
- Opciones que especifican o alteran una entrada genérica en un comando de Bazel que no se incluye en otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
. - Anula un repositorio con un directorio local.
Opciones de instalación para dispositivos móviles
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
. -
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
predeterminado: “false”-
Si es verdadero, usa una cadena derivada de las URLs de las descargas del repositorio como canonical_id si no se especifica. Esto hace que un cambio en las URLs genere una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no hagan que la caché oculte los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
predeterminado: “false”-
Si se establece, no se permite descargar repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, se puede hacer que los repositorios externos funcionen en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: “1.0”-
Escala todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de la compilación:
--mode=<classic, classic_internal_test_do_not_use or skylark>
predeterminado: “classic”-
Selecciona cómo ejecutar mobile-install. "classic" ejecuta la versión actual de mobile-install. "skylark" usa la nueva versión de Starlark, que admite android_test.
Etiquetas:loading_and_analysis
,execution
,incompatible_change
- Opciones que configuran la cadena de herramientas que se usa para la ejecución de acciones:
--adb=<a string>
predeterminado: ""
Objeto binario - adb que se usará para el comando "mobile-install". Si no se especifica, se usa el que se encuentra en el SDK de Android especificado por la opción de línea de comandos --android_sdk (o el SDK predeterminado si no se especifica --android_sdk).
Etiquetas:changes_inputs
- Opciones que controlan el resultado del comando:
--[no]incremental
predeterminado: “false”-
Indica si se debe realizar una instalación incremental. Si es verdadero, intenta evitar el trabajo adicional innecesario leyendo el estado del dispositivo en el que se instalará el código y usa esa información para evitar el trabajo innecesario. Si es falso (la opción predeterminada), siempre realiza una instalación completa.
Etiquetas:loading_and_analysis
--[no]split_apks
predeterminado: “false”-
Indica si se deben usar APKs divididos para instalar y actualizar la aplicación en el dispositivo. Solo funciona con dispositivos con Marshmallow o versiones posteriores.
Etiquetas:loading_and_analysis
,affects_outputs
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
- Se acumulan varios usos de
--adb_arg=<a string>
. -
Argumentos adicionales que se pasan a adb. Por lo general, se usa para designar un dispositivo en el que se instalará.
Etiquetas:action_command_lines
--debug_app
-
Determina si se debe esperar al depurador antes de iniciar la app.
Se expande a lo siguiente:
--start=DEBUG
Etiquetas:execution
--device=<a string>
predeterminado: ""-
Es el número de serie del dispositivo de ADB. Si no se especifica, se usará el primer dispositivo.
Etiquetas:action_command_lines
--start=<no, cold, warm or debug>
predeterminado: “NO”-
Cómo se debe iniciar la app después de instalarla. Establece el valor en WARM para conservar y restablecer el estado de la aplicación en las instalaciones incrementales.
Etiquetas:execution
--start_app
-
Indica si se debe iniciar la app después de instalarla.
Se expande a:
--start=COLD
Etiquetas:execution
- Opciones que afectan la rigurosidad con la que Bazel aplica entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etc.):
--experimental_repository_hash_file=<a string>
predeterminado: ""-
Si no está vacío, especifica un archivo que contiene un valor resuelto, con el que se deben verificar los valores hash del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan varios usos de
--experimental_verify_repository_rules=<a string>
. -
Si es una lista de reglas de repositorio para las que se debe verificar el hash del directorio de salida, siempre que se especifique un archivo con --experimental_repository_hash_file.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: "true"-
Etiquetas
sin operación:no_op
,deprecated
,experimental
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
. -
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitadas en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: “error”-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "advertencia" -
Verifica si las dependencias directas de "bazel_dep" declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivarla a un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
. - Anula un módulo con un directorio local.
- Se acumulan varios usos de
--registry=<a string>
. -
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
--incremental_install_verbosity=<a string>
predeterminado: ""-
Es el nivel de detalle de la instalación incremental. Establece en 1 para el registro de depuración.
Etiquetas:bazel_monitoring
- Son opciones que especifican o alteran una entrada genérica en un comando de Bazel que no pertenece a otras categorías.:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
. - Anula un repositorio con un directorio local.
Opciones de Modquery
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
. -
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
predeterminado: “false”-
Si es verdadero, usa una cadena derivada de las URLs de las descargas del repositorio como canonical_id si no se especifica. Esto hace que un cambio en las URLs genere una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no provoquen que la caché oculte los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
predeterminado: “false”-
Si se establece, no se permite descargar repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, se puede hacer que los repositorios externos funcionen en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de la compilación:
--[no]keep_going
[-k
] predeterminado: "false"-
Continúa tanto como sea posible después de un error. Si bien no se pueden analizar el objetivo que falló ni los que dependen de él, sí se pueden analizar otros requisitos previos de estos objetivos.
Etiquetas:eagerness_to_exit
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
predeterminado: “auto”-
Cantidad de subprocesos en paralelo que se usarán para la fase de carga o análisis. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". "auto" establece un valor predeterminado razonable según los recursos del host. Debe ser 1 como mínimo.
Etiquetas:bazel_internal_configuration
- Opciones que afectan la rigurosidad con la que Bazel aplica entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etc.):
--experimental_repository_hash_file=<a string>
predeterminado: ""-
Si no está vacío, especifica un archivo que contiene un valor resuelto, con el que se deben verificar los valores hash del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan varios usos de
--experimental_verify_repository_rules=<a string>
. -
Si es una lista de reglas de repositorio para las que se debe verificar el hash del directorio de salida, siempre que se especifique un archivo con --experimental_repository_hash_file.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: "true"-
Etiquetas de
sin operación:no_op
,deprecated
,experimental
--[no]incompatible_config_setting_private_default_visibility
predeterminado: “false”-
Si incompatible_enforce_config_setting_visibility=false, esto es una operación no realizada. De lo contrario, si esta marca es falsa, cualquier config_setting sin un atributo de visibilidad explícito es //visibility:public. Si esta marca es verdadera, config_setting sigue la misma lógica de visibilidad que todas las demás reglas. Consulta https://github.com/bazelbuild/bazel/issues/12933.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
predeterminado: "true"-
Si es verdadero, aplica las restricciones de visibilidad de config_setting. Si es falso, todos los config_setting son visibles para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones relacionadas con el resultado y la semántica de modquery:
--charset=<utf8 or ascii>
predeterminado: "utf8"-
Elige el conjunto de caracteres que se usará para el árbol. Solo afecta a la salida de texto. Los valores válidos son “utf8” o “ascii”. El valor predeterminado es "utf8".
Etiquetas:terminal_output
--[no]cycles
predeterminado: “false”-
Indica los ciclos de dependencia dentro del árbol que se muestra, que normalmente se ignoran de forma predeterminada.
Etiquetas:execution
--depth=<an integer>
predeterminado: “-1”-
Profundidad de visualización máxima del árbol de dependencias. Por ejemplo, una profundidad de 1 muestra las dependencias directas. Para tree, path y all_paths, el valor predeterminado es Integer.MAX_VALUE, mientras que para deps y explain, el valor predeterminado es 1 (solo muestra las dependencias directas de la raíz además de las hojas de destino y sus elementos superiores).
Etiquetas:execution
--[no]extra
predeterminado: “false”-
Las consultas también mostrarán el motivo por el que los módulos se resolvieron a su versión actual (si se cambiaron). El valor predeterminado es verdadero solo para la consulta explain.
Etiquetas:execution
--from=<a list of <module>s separated by comma>
predeterminado: “root”-
Son los módulos desde los que se mostrará la consulta del gráfico de dependencias. Verifica la descripción de cada consulta para encontrar la semántica exacta. El valor predeterminado es root.
Etiquetas:execution
--[no]include_unused
predeterminado: “false”-
Las consultas también tendrán en cuenta y mostrarán los módulos no utilizados, que no están presentes en el gráfico de resolución de módulos después de la selección (debido a la selección de versión mínima o las reglas de anulación). Esto puede tener diferentes efectos para cada uno de los tipos de consulta, es decir, incluir rutas nuevas en el comando all_paths o dependencias adicionales en el comando explain.
Etiquetas:execution
--output=<text, json or graph>
predeterminado: “text”-
Es el formato en el que se deben imprimir los resultados de la consulta. Los valores permitidos para la consulta son: texto, json, gráfico.
Etiquetas:terminal_output
- Opciones relacionadas con la salida y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
. -
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitados en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "advertencia" -
Verifica si las dependencias directas de "bazel_dep" declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivarla a un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
. - Anula un módulo con un directorio local.
- Se acumulan varios usos de
--registry=<a string>
. -
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
- Opciones que especifican o alteran una entrada genérica en un comando de Bazel que no se incluye en otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
- Opciones misceláneas que no se clasifican de otra manera:
--deleted_packages=<comma-separated list of package names>
predeterminado: ""- Es una lista separada por comas de nombres de paquetes que el sistema de compilación considerará inexistentes, incluso si son visibles en algún lugar de la ruta de acceso del paquete. Usa esta opción cuando borres un subpaquete "x/y" de un paquete existente "x". Por ejemplo, después de borrar x/y/BUILD en tu cliente, es posible que el sistema de compilación se queje si encuentra una etiqueta "//x:y/z" si otra entrada de package_path aún la proporciona. Especificar --deleted_packages x/y evita este problema.
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
. - Anula un repositorio con un directorio local.
--package_path=<colon-separated list of options>
predeterminado: "%workspace%"- Es una lista separada por dos puntos de dónde buscar paquetes. Los elementos que comienzan con "%workspace%" son relativos al lugar de trabajo que los contiene. Si se omite o está vacío, el valor predeterminado es el resultado de "bazel info default-package-path".
--[no]show_loading_progress
predeterminado: "true"- Si está habilitado, hace que Bazel imprima mensajes de “Carga del paquete:”.
Opciones de Print_action
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
. -
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
predeterminado: “false”-
Si es verdadero, usa una cadena derivada de las URLs de las descargas del repositorio como canonical_id si no se especifica. Esto hace que un cambio en las URLs genere una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no provoquen que la caché oculte los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
predeterminado: “false”-
Si se establece, no se permite descargar repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, los repositorios externos pueden funcionar en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que afectan la rigurosidad con la que Bazel aplica entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etc.):
--experimental_repository_hash_file=<a string>
predeterminado: ""-
Si no está vacío, especifica un archivo que contiene un valor resuelto, con el que se deben verificar los valores hash del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan varios usos de
--experimental_verify_repository_rules=<a string>
. -
Si es una lista de reglas de repositorio para las que se debe verificar el hash del directorio de salida, siempre que se especifique un archivo con --experimental_repository_hash_file.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: "true"-
Etiquetas
sin operación:no_op
,deprecated
,experimental
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
. -
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitados en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "advertencia" -
Verifica si las dependencias directas de "bazel_dep" declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivarla a un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
. - Anula un módulo con un directorio local.
- Se acumulan varios usos de
--registry=<a string>
. -
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
- Opciones que especifican o alteran una entrada genérica en un comando de Bazel que no se incluye en otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de almacenamiento en caché y ejecución remotas:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite"), seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
. - Anula un repositorio con un directorio local.
- Se acumulan varios usos de
--print_action_mnemonics=<a string>
. - Enumera los mnemónicos por los que se deben filtrar los datos de print_action. No se realiza ningún filtrado si se deja vacío.
Opciones de consulta
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
. -
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
predeterminado: “false”-
Si es verdadero, usa una cadena derivada de las URLs de las descargas del repositorio como canonical_id si no se especifica. Esto hace que un cambio en las URLs genere una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no hagan que la caché oculte los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
predeterminado: “false”-
Si se establece, no se permite descargar repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, los repositorios externos pueden funcionar en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de la compilación:
--[no]incompatible_remote_dangling_symlinks
predeterminado: "true"-
Si se establece en "true" y --incompatible_remote_symlinks también es "true", los symlinks en los resultados de la acción pueden colgar.
Etiquetas:execution
,incompatible_change
--[no]incompatible_remote_symlinks
predeterminado: "true"-
Si se establece como verdadero, Bazel representará los symlinks en los resultados de la acción en el protocolo de ejecución o almacenamiento en caché remoto como tal. De lo contrario, se seguirán los symlinks y se representarán como archivos o directorios. Consulta el problema #6631 para obtener más información.
Etiquetas:execution
,incompatible_change
--[no]keep_going
[-k
] predeterminado: "false"-
Continúa tanto como sea posible después de un error. Si bien no se pueden analizar el objetivo que falló ni los que dependen de él, sí se pueden analizar otros requisitos previos de estos objetivos.
Etiquetas:eagerness_to_exit
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
predeterminado: “auto”-
Cantidad de subprocesos en paralelo que se usarán para la fase de carga o análisis. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". "auto" establece un valor predeterminado razonable según los recursos del host. Debe ser 1 como mínimo.
Etiquetas:bazel_internal_configuration
- Son opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
--bep_maximum_open_remote_upload_files=<an integer>
predeterminado: “-1”-
Cantidad máxima de archivos abiertos permitidos durante la carga de artefactos de BEP.
Etiquetas:affects_outputs
--remote_download_minimal
-
No descarga ningún resultado de compilación remota a la máquina local. Esta marca es un atajo para las marcas: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata y --remote_download_outputs=minimal.
Se expande a:
--nobuild_runfile_links
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=minimal
Etiquetas:affects_outputs
--remote_download_outputs=<all, minimal or toplevel>
predeterminado: “all”-
Si se establece en "minimal", no se descargan resultados de compilación remotas en la máquina local, excepto los que requieren las acciones locales. Si se establece en "toplevel", se comporta como "minimal", excepto que también descarga los resultados de los destinos de nivel superior en la máquina local. Ambas opciones pueden reducir significativamente los tiempos de compilación si el ancho de banda de la red es un cuello de botella.
Etiquetas:affects_outputs
--remote_download_symlink_template=<a string>
predeterminado: ""-
En lugar de descargar resultados de compilación remotos en la máquina local, crea vínculos simbólicos. El destino de los vínculos simbólicos se puede especificar en forma de una cadena de plantilla. Esta cadena de plantilla puede contener {hash} y {size_bytes} que se expanden al hash del objeto y al tamaño en bytes, respectivamente. Estos vínculos simbólicos pueden, por ejemplo, apuntar a un sistema de archivos FUSE que cargue objetos del CAS a pedido.
Etiquetas:affects_outputs
--remote_download_toplevel
- Solo descarga resultados remotos de destinos de nivel superior en la máquina local. Esta marca es un atajo para las marcas: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata y --remote_download_outputs=toplevel.
Se expande a:
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=toplevel
Etiquetas:affects_outputs
- Opciones que afectan la rigurosidad con la que Bazel aplica entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etc.):
--experimental_repository_hash_file=<a string>
predeterminado: ""-
Si no está vacío, especifica un archivo que contiene un valor resuelto, con el que se deben verificar los valores hash del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan varios usos de
--experimental_verify_repository_rules=<a string>
. -
Si es una lista de reglas de repositorio para las que se debe verificar el hash del directorio de salida, siempre que se especifique un archivo con --experimental_repository_hash_file.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: "true"-
Etiquetas de
sin operación:no_op
,deprecated
,experimental
--[no]incompatible_config_setting_private_default_visibility
predeterminado: “false”-
Si incompatible_enforce_config_setting_visibility=false, esto es una operación no realizada. De lo contrario, si esta marca es falsa, cualquier config_setting sin un atributo de visibilidad explícito es //visibility:public. Si esta marca es verdadera, config_setting sigue la misma lógica de visibilidad que todas las demás reglas. Consulta https://github.com/bazelbuild/bazel/issues/12933.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
predeterminado: "true"-
Si es verdadero, aplica las restricciones de visibilidad de config_setting. Si es falso, todos los config_setting son visibles para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones relacionadas con el resultado y la semántica de la consulta:
--aspect_deps=<off, conservative or precise>
predeterminado: "conservative"-
Cómo resolver las dependencias de aspecto cuando el formato de salida es uno de {xml,proto,record}. "Desactivado" significa que no se resuelven las dependencias de aspecto. "Conservador" (la opción predeterminada) significa que se agregan todas las dependencias de aspecto declaradas, independientemente de si se les asigna la clase de regla de dependencias directas. "Preciso" significa que solo se agregan los aspectos que pueden estar activos según la clase de regla de las dependencias directas. Ten en cuenta que el modo preciso requiere la carga de otros paquetes para evaluar un solo objetivo, lo que lo hace más lento que los otros modos. Además, ten en cuenta que incluso el modo preciso no es del todo preciso: la decisión de calcular un aspecto se toma en la fase de análisis, que no se ejecuta durante la "consulta de bazel".
Etiquetas:build_file_semantics
--[no]experimental_graphless_query
predeterminado: “auto”-
Si es verdadero, usa una implementación de consulta que no crea una copia del gráfico. La nueva implementación solo admite --order_output=no, así como solo un subconjunto de formateadores de salida.
Etiquetas:build_file_semantics
,eagerness_to_exit
--graph:conditional_edges_limit=<an integer>
predeterminado: “4”-
Es la cantidad máxima de etiquetas de condición que se mostrarán. -1 significa que no hay truncamiento y 0 significa que no hay anotaciones. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--[no]graph:factored
predeterminado: "true"-
Si es verdadero, el gráfico se emitirá "factorizado", es decir, los nodos topológicamente equivalentes se combinarán y sus etiquetas se concatenarán. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--graph:node_limit=<an integer>
predeterminado: “512”-
Es la longitud máxima de la cadena de etiqueta para un nodo de grafo en el resultado. Las etiquetas más largas se truncarán. -1 significa que no se truncará. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--[no]implicit_deps
predeterminado: "true"-
Si está habilitada, se incluirán dependencias implícitas en el gráfico de dependencias sobre el que opera la consulta. Una dependencia implícita es aquella que no se especifica explícitamente en el archivo BUILD, pero que Bazel agrega. En el caso de cquery, esta opción controla el filtrado de cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
--[no]include_aspects
predeterminado: "true"-
aquery, cquery: Indica si se deben incluir acciones generadas por aspectos en el resultado. query: No-op (siempre se siguen los aspectos).
Etiquetas:terminal_output
--[no]incompatible_display_source_file_location
predeterminado: "true"-
Es verdadero de forma predeterminada y muestra el destino del archivo fuente. Si es verdadero, muestra la ubicación de la línea 1 de los archivos de origen en los resultados de ubicación. Esta marca solo existe para la migración.
Etiquetas:terminal_output
,incompatible_change
--[no]incompatible_lexicographical_output
predeterminado: "true"-
Si se establece esta opción, se ordena el resultado de --order_output=auto en orden alfabético.
Etiquetas:terminal_output
,incompatible_change
--[no]incompatible_package_group_includes_double_slash
predeterminado: "true"-
Si está habilitada, cuando se genere el atributo "packages" de package_group, no se omitirá el "//" inicial.
Etiquetas:terminal_output
,incompatible_change
--[no]infer_universe_scope
predeterminado: “false”-
Si se establece y no se establece --universe_scope, se inferirá un valor de --universe_scope como la lista de patrones de destino únicos en la expresión de consulta. Ten en cuenta que el valor de --universe_scope inferido para una expresión de consulta que usa funciones centradas en el universo (p.ej., "allrdeps") puede no ser lo que deseas, por lo que debes usar esta opción solo si sabes lo que estás haciendo. Consulta https://bazel.build/query/language#sky-query para obtener detalles y ejemplos. Si se establece --universe_scope, se ignora el valor de esta opción. Nota: Esta opción solo se aplica a "query" (es decir, no a "cquery").
Etiquetas:loading_and_analysis
--[no]line_terminator_null
predeterminado: “false”-
Indica si cada formato finaliza con \0 en lugar de una línea nueva.
Etiquetas:terminal_output
--[no]nodep_deps
predeterminado: "true"-
Si está habilitada, las dependencias de los atributos "nodep" se incluirán en el gráfico de dependencias sobre el que opera la consulta. Un ejemplo común de un atributo "nodep" es "visibility". Ejecuta y analiza el resultado de "info build-language" para obtener información sobre todos los atributos "nodep" en el lenguaje de compilación.
Etiquetas:build_file_semantics
--noorder_results
-
Muestra los resultados en orden de dependencia (predeterminado) o sin orden. La salida no ordenada es más rápida, pero solo se admite cuando --output no es minrank, maxrank ni graph.
Se expande a:
--order_output=no
Etiquetas:terminal_output
--null
-
Indica si cada formato finaliza con \0 en lugar de una línea nueva.
Se expande a:
--line_terminator_null=true
Etiquetas:terminal_output
--order_output=<no, deps, auto or full>
predeterminado: “auto”-
Muestra los resultados sin ordenar (no), ordenados por dependencia (deps) o completamente ordenados (full). El valor predeterminado es "auto", lo que significa que los resultados se ordenan según la dependencia o se ordenan por completo, según el formato de salida (ordenados por dependencia para proto, minrank, maxrank y gráfico, y ordenados por completo para todos los demás). Cuando el resultado está completamente ordenado, los nodos se imprimen en un orden completamente determinista (total). Primero, todos los nodos se ordenan alfabéticamente. Luego, cada nodo de la lista se usa como el inicio de una búsqueda en profundidad post-orden en la que los bordes salientes a los nodos no visitados se recorren en orden alfabético de los nodos sucesores. Por último, los nodos se imprimen en el orden inverso en el que se visitaron.
Etiquetas:terminal_output
--order_results
-
Muestra los resultados en orden de dependencia (predeterminado) o sin orden. La salida no ordenada es más rápida, pero solo se admite cuando --output no es minrank, maxrank ni graph.
Se expande a:
--order_output=auto
Etiquetas:terminal_output
--output=<a string>
predeterminado: "label"-
Es el formato en el que se deben imprimir los resultados de la consulta. Los valores permitidos para la consulta son: build, graph, label, label_kind, location, maxrank, minrank, package, 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á habilitada, los atributos configurables creados por select() se aplanan. En el caso de los tipos de lista, la representación aplanada es una lista que contiene cada valor del mapa de selección exactamente una vez. Los tipos escalares se aplanan a nulos.
Etiquetas:build_file_semantics
--[no]proto:include_synthetic_attribute_hash
predeterminado: “false”-
Indica si se debe calcular y propagar el atributo $internal_attr_hash.
Etiquetas:terminal_output
--[no]proto:instantiation_stack
predeterminado: “false”-
Propaga la pila de llamadas de creación de instancias de cada regla. Ten en cuenta que esto requiere que la pila esté presente.
Etiquetas:terminal_output
--[no]proto:locations
predeterminado: "true"-
Indica si se debe generar información de ubicación en el resultado de proto.
Etiquetas:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
predeterminado: “all”-
Es una lista de atributos separados por comas que se deben incluir en el resultado. La configuración predeterminada es todos los atributos. Establece una cadena vacía para no mostrar ningún atributo. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
--[no]proto:rule_inputs_and_outputs
predeterminado: "true"-
Indica si se propagan o no los campos rule_input y rule_output.
Etiquetas:terminal_output
--query_file=<a string>
predeterminado: ""-
Si se establece, la consulta leerá la consulta del archivo que se nombra aquí, en lugar de la línea de comandos. Especificar un archivo aquí y una consulta de línea de comandos es un error.
Etiquetas:changes_inputs
--[no]relative_locations
predeterminado: “false”-
Si es verdadero, la ubicación de los archivos BUILD en los resultados de xml y proto será relativa. De forma predeterminada, el resultado de la ubicación es una ruta de acceso absoluta y no será coherente en todas las máquinas. Puedes establecer esta opción en verdadero para obtener un resultado coherente en todas las máquinas.
Etiquetas:terminal_output
--[no]strict_test_suite
predeterminado: “false”-
Si es verdadero, la expresión tests() muestra un error si encuentra un test_suite que contiene destinos que no son de prueba.
Etiquetas:build_file_semantics
,eagerness_to_exit
--[no]tool_deps
predeterminado: "true"-
Consulta: Si se inhabilita, las dependencias de los destinos de "configuración del host" o "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 del host", como el de cualquier regla "proto_library" al compilador de protocolos, suele apuntar a una herramienta que se ejecuta durante la compilación en lugar de a una parte del mismo programa "objetivo".
Cquery: Si se inhabilita, filtra todos los objetivos configurados que cruzan un host o una transición de ejecución desde el objetivo de nivel superior que descubrió este objetivo configurado. Esto significa que, si el objetivo de nivel superior está en la configuración de destino, solo se mostrarán los objetivos configurados también en la configuración de destino. Si el destino de nivel superior está en la configuración del host, solo se mostrarán los destinos configurados por el host. Esta opción NO excluirá las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
--universe_scope=<comma-separated list of options>
predeterminado: ""-
Es un conjunto de patrones de destino (aditivos y sustractivos) separados por comas. La consulta se puede realizar en el universo definido por el cierre transitivo de los destinos especificados. Esta opción se usa para los comandos query y cquery.
En el caso de cquery, la entrada de esta opción son los objetivos en los que se compilan todas las respuestas, por lo que esta opción puede afectar las configuraciones y las transiciones. Si no se especifica esta opción, se supone que los destinos de nivel superior son los que se analizaron de la expresión de consulta. Nota: En el caso de cquery, si no se especifica esta opción, es posible que la compilación falle si los destinos analizados de la expresión de consulta no se pueden compilar con opciones de nivel superior.
Etiquetas:loading_and_analysis
--[no]xml:default_values
predeterminado: “false”-
Si es verdadero, se imprimen los atributos de regla cuyo valor no se especifica de forma explícita en el archivo BUILD. De lo contrario, se omiten.
Etiquetas:terminal_output
--[no]xml:line_numbers
predeterminado: "true"-
Si es verdadero, el resultado en formato XML contiene números de línea. Si inhabilitas esta opción, es posible que las diferencias sean más fáciles de leer. Esta opción solo se aplica a --output=xml.
Etiquetas:terminal_output
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
. -
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitadas en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "advertencia" -
Verifica si las dependencias directas de "bazel_dep" declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivarla a un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
. - Anula un módulo con un directorio local.
- Se acumulan varios usos de
--registry=<a string>
. -
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
--experimental_repository_resolved_file=<a string>
predeterminado: ""-
Si no está vacío, escribe un valor Starlark con la información resuelta de todas las reglas del repositorio Starlark que se ejecutaron.
Etiquetas:affects_outputs
- Valor predeterminado de
--remote_print_execution_messages=<failure, success or all>
: “failure” -
Elige cuándo imprimir los mensajes de ejecución remota. Los valores válidos son "failure" para imprimir solo en caso de fallas, "success" para imprimir solo en caso de éxitos y "all" para imprimir siempre.
Etiquetas:terminal_output
- Son opciones que especifican o alteran una entrada genérica en un comando de Bazel que no pertenece a otras categorías.:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
--[no]experimental_guard_against_concurrent_changes
predeterminado: “false”- Desactiva esta opción para inhabilitar la verificación del ctime de los archivos de entrada de una acción antes de subirla a una caché remota. Puede haber casos en los que el kernel de Linux retrase la escritura de archivos, lo que podría generar falsos positivos.
--experimental_remote_build_event_upload=<all or minimal>
predeterminado: “all”- Si se establece en “todos”, todos los resultados locales a los que hace referencia BEP se suben a la caché remota. Si se establece en “minimal”, los resultados locales a los que hace referencia BEP no se suben a la caché remota, excepto los archivos que son importantes para los consumidores de BEP (p.ej., registros de prueba y perfil de tiempo). Se usa el esquema file:// para las rutas de acceso de los archivos locales y el esquema bytestream:// para las rutas de acceso de los archivos (ya) subidos. El valor predeterminado es “all”.
--[no]experimental_remote_cache_async
predeterminado: “false”- Si es verdadero, las operaciones de E/S de caché remota se realizarán en segundo plano en lugar de hacerlo como parte de un inicio.
--[no]experimental_remote_cache_compression
predeterminado: “false”- Si está habilitado, comprime o descomprime los blobs de caché con zstd.
--experimental_remote_capture_corrupted_outputs=<a path>
predeterminado: Consulta la descripción- Es una ruta de acceso a un directorio en el que se capturarán los resultados dañados.
--experimental_remote_downloader=<a string>
predeterminado: Consulta la descripción- Es un URI de extremo de la API de Remote Asset que se usará como proxy de descarga remoto. Los esquemas admitidos son grpc, grpcs (grpc con TLS habilitado) y unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel usará grpcs de forma predeterminada. Consulta: https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto
--[no]experimental_remote_downloader_local_fallback
predeterminado: “false”- Indica si se debe recurrir al descargador local si falla el descargador remoto.
--[no]experimental_remote_execution_keepalive
predeterminado: “false”- Indica si se debe usar el mantenimiento de la conexión para las llamadas de ejecución remotas.
--experimental_remote_grpc_log=<a path>
predeterminado: Consulta la descripción- Si se especifica, es una ruta de acceso a un archivo para registrar los detalles relacionados con las llamadas de gRPC. Este registro consta de una secuencia de protobufs com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry serializados con cada mensaje con un prefijo de varint que indica el tamaño del siguiente mensaje de protobuf serializado, como lo realiza el método LogEntry.writeDelimitedTo(OutputStream).
--[no]experimental_remote_mark_tool_inputs
predeterminado: “false”- Si se establece como verdadero, Bazel marcará las entradas como entradas de herramientas para el ejecutor remoto. Esto se puede usar para implementar trabajadores persistentes remotos.
--[no]experimental_remote_merkle_tree_cache
predeterminado: “false”- Si se establece como verdadero, los cálculos del árbol de Merkle se almacenarán en caché para mejorar la velocidad de verificación de hits de caché remotos. El espacio en memoria de la caché se controla con --experimental_remote_merkle_tree_cache_size.
--experimental_remote_merkle_tree_cache_size=<a long integer>
predeterminado: “1000”- Es la cantidad de árboles de Merkle que se deben almacenar en caché para mejorar la velocidad de verificación de aciertos de caché remotos. Aunque la caché se poda automáticamente según el manejo de referencias suaves de Java, pueden ocurrir errores de falta de memoria si se establece demasiado 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.
--[no]incompatible_remote_build_event_upload_respect_no_cache
predeterminado: “false”- Si se establece como verdadero, los resultados a los que hace referencia BEP no se suben a la caché remota si la acción de generación no se puede almacenar en caché de forma remota.
--[no]incompatible_remote_downloader_send_all_headers
predeterminado: "true"-
Indica si se deben enviar todos los valores de un encabezado con varios valores al descargador remoto en lugar de solo el primero.
Etiquetas:incompatible_change
--[no]incompatible_remote_output_paths_relative_to_input_root
predeterminado: “false”-
Si se establece como verdadero, las rutas de acceso de salida son relativas a la raíz de entrada en lugar del directorio de trabajo.
Etiquetas:incompatible_change
--[no]incompatible_remote_results_ignore_disk
predeterminado: "true"-
Si se establece como verdadero, --noremote_upload_local_results y --noremote_accept_cached no se aplicarán a la caché del disco. Si se usa una caché combinada,
--noremote_upload_local_results hará que los resultados se escriban en la caché del disco, pero no se suban a la caché remota.
--noremote_accept_cached hará que Bazel busque resultados en la caché del disco, pero no en la caché remota.
Las acciones sin ejecución remota pueden afectar la caché del disco.
Consulta #8216 para obtener más información.
Etiquetas:incompatible_change
--[no]remote_accept_cached
predeterminado: "true"- Indica si se aceptan los resultados de las acciones almacenadas en caché de forma remota.
--remote_bytestream_uri_prefix=<a string>
predeterminado: Consulta la descripción- Es el nombre de host y el nombre de la instancia que se usarán en los URIs bytestream:// que se escriben en los flujos de eventos de compilación. Esta opción se puede establecer cuando las compilaciones se realizan con un proxy, lo que hace que los valores de --remote_executor y --remote_instance_name ya no correspondan al nombre canónico del servicio de ejecución remota. Si no se establece, el valor predeterminado será “${hostname}/${instance_name}”.
--remote_cache=<a string>
predeterminado: Consulta la descripción- Es un URI de un extremo de almacenamiento en caché. Los esquemas compatibles son http, https, grpc, grpcs (grpc con TLS habilitado) y unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel usará grpcs de forma predeterminada. Especifica el esquema grpc://, http:// o unix: para inhabilitar TLS. Consulta https://bazel.build/remote/caching
- Se acumulan varios usos de
--remote_cache_header=<a 'name=value' assignment>
. - Especifica un encabezado que se incluirá en las solicitudes de caché: --remote_cache_header=Nombre=Valor. Se pueden pasar varios encabezados si especificas la marca varias veces. Los múltiples valores para el mismo nombre se convertirán en una lista separada por comas.
- Se acumulan varios usos de
--remote_default_exec_properties=<a 'name=value' assignment>
. -
Establece las propiedades de ejecución predeterminadas que se usarán como la plataforma de ejecución remota si una plataforma de ejecución aún no establece exec_properties.
Etiquetas:affects_outputs
--remote_default_platform_properties=<a string>
predeterminado: ""- Establece las propiedades de plataforma predeterminadas que se establecerán para la API de ejecución remota, si la plataforma de ejecución aún no establece remote_execution_properties. Este valor también se usará si se selecciona la plataforma host como la plataforma de ejecución para la ejecución remota.
- Se acumulan varios usos de
--remote_downloader_header=<a 'name=value' assignment>
. - Especifica un encabezado que se incluirá en las solicitudes del descargador remoto: --remote_downloader_header=Nombre=Valor. Se pueden pasar varios encabezados si especificas la marca varias veces. Los múltiples valores para el mismo nombre se convertirán en una lista separada por comas.
- Se acumulan varios usos de
--remote_exec_header=<a 'name=value' assignment>
. - Especifica un encabezado que se incluirá en las solicitudes de ejecución: --remote_exec_header=Nombre=Valor. Se pueden pasar varios encabezados si especificas la marca varias veces. Los múltiples valores para el mismo nombre se convertirán en una lista separada por comas.
--remote_execution_priority=<an integer>
predeterminado: “0”- Es la prioridad relativa de las acciones que se ejecutarán de forma remota. La semántica de los valores de prioridad particulares depende del servidor.
--remote_executor=<a string>
predeterminado: Consulta la descripción- HOST o HOST:PORT de un extremo de ejecución remota. Los esquemas admitidos son grpc, grpcs (grpc con TLS habilitado) y unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel usará grpcs de forma predeterminada. Especifica el esquema grpc:// o unix: para inhabilitar TLS.
- Se acumulan varios usos de
--remote_header=<a 'name=value' assignment>
. - Especifica un encabezado que se incluirá en las solicitudes: --remote_header=Nombre=Valor. Se pueden pasar varios encabezados si especificas la marca varias veces. Los múltiples valores para el mismo nombre se convertirán en una lista separada por comas.
--remote_instance_name=<a string>
predeterminado: ""- Es el valor que se pasa como instance_name en la API de ejecución remota.
--[no]remote_local_fallback
predeterminado: “false”- Determina si se debe recurrir a la estrategia de ejecución local independiente si falla la ejecución remota.
--remote_local_fallback_strategy=<a string>
predeterminado: “local”- No realiza ninguna acción, está obsoleto. Consulta https://github.com/bazelbuild/bazel/issues/7480 para obtener más información.
--remote_max_connections=<an integer>
predeterminado: "100"-
Limita la cantidad máxima de conexiones simultáneas a la caché o al ejecutor remotos. De forma predeterminada, el valor es 100. Si lo estableces en 0, no habrá limitaciones.
Para la caché remota de HTTP, una conexión TCP podría controlar una solicitud a la vez, por lo que Bazel podría realizar hasta --remote_max_connections solicitudes simultáneas.
En el caso de la caché o el ejecutor remotos de gRPC, un canal de gRPC suele poder controlar más de 100 solicitudes simultáneas, por lo que Bazel podría realizar alrededor de `--remote_max_connections * 100` solicitudes simultáneas.
Etiquetas:host_machine_resource_optimizations
--remote_proxy=<a string>
predeterminado: Consulta la descripción- Conéctate a la caché remota a través de un proxy. Actualmente, esta marca solo se puede usar para configurar un socket de dominio Unix (unix:/path/to/socket).
--remote_result_cache_priority=<an integer>
predeterminado: “0”- Es la prioridad relativa de las acciones remotas que se almacenarán en la caché remota. La semántica de los valores de prioridad particulares depende del servidor.
--remote_retries=<an integer>
predeterminado: “5”- Es la cantidad máxima de intentos para reintentar un error transitorio. Si se establece en 0, se inhabilitan los reintentos.
--remote_timeout=<An immutable length of time.>
predeterminado: "60s"- Es la cantidad máxima de tiempo que se espera para la ejecución remota y las llamadas a la caché. Para la caché de REST, este es el tiempo de espera de conexión y lectura. Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
--[no]remote_upload_local_results
predeterminado: "true"- Determina si se deben subir los resultados de las acciones ejecutadas de forma local a la caché remota si esta la admite y el usuario está autorizado para hacerlo.
--[no]remote_verify_downloads
predeterminado: "true"- Si se establece como verdadero, Bazel calculará la suma de hash de todas las descargas remotas y descartará los valores almacenados en caché de forma remota si no coinciden con el valor esperado.
- Opciones misceláneas que no se clasifican de otra manera:
--deleted_packages=<comma-separated list of package names>
predeterminado: ""- Es una lista separada por comas de nombres de paquetes que el sistema de compilación considerará inexistentes, incluso si son visibles en algún lugar de la ruta de acceso del paquete. Usa esta opción cuando borres un subpaquete "x/y" de un paquete existente "x". Por ejemplo, después de borrar x/y/BUILD en tu cliente, es posible que el sistema de compilación se queje si encuentra una etiqueta "//x:y/z" si otra entrada de package_path aún la proporciona. Especificar --deleted_packages x/y evita este problema.
--disk_cache=<a path>
predeterminado: Consulta la descripción- Es una ruta de acceso a un directorio en el que Bazel puede leer y escribir acciones y resultados de acciones. Si el directorio no existe, se creará.
- Se acumulan varios usos de
--experimental_credential_helper=<An (unresolved) path to a credential helper for a scope.>
- Configura los auxiliares de credenciales que se usarán para recuperar credenciales para el alcance (dominio) proporcionado. Las credenciales de los asistentes de credenciales tienen prioridad sobre las credenciales de <code>--google_default_credentials</code>, `--google_credentials` o <code>.netrc</code>. Consulta https://github.com/bazelbuild/proposals/blob/main/designs/2022-06-07-bazel-credential-helpers.md para obtener más información.
--experimental_credential_helper_cache_duration=<An immutable length of time.>
predeterminado: “30m”- Configura la duración durante la cual se almacenan en caché las credenciales de los auxiliares de credenciales. Si lo invocas con un valor diferente, se ajustará la vida útil de las entradas preexistentes. Pasa cero para borrar la caché. Un comando clean siempre borra la caché, independientemente de esta marca.
--experimental_credential_helper_timeout=<An immutable length of time.>
predeterminado: "5s"- Configura el tiempo de espera del Asistente de credenciales. Si los auxiliares de credenciales no responden dentro de este tiempo de espera, la invocación fallará.
--google_auth_scopes=<comma-separated list of options>
predeterminado: "https://www.googleapis.com/auth/cloud-platform"- Es una lista separada por comas de los permisos de autenticación de Google Cloud.
--google_credentials=<a string>
predeterminado: Consulta la descripción- Especifica el archivo del que se deben obtener las credenciales de autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más información.
--[no]google_default_credentials
predeterminado: “false”- Indica si se deben usar "Credenciales predeterminadas de la aplicación de Google" para la autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más información. Está inhabilitado de forma predeterminada.
--grpc_keepalive_time=<An immutable length of time.>
predeterminado: Consulta la descripción- Configura pings de keepalive para las conexiones de gRPC salientes. Si se establece, Bazel envía pings después de este tiempo sin operaciones de lectura en la conexión, pero solo si hay al menos una llamada gRPC pendiente. Los tiempos se tratan como nivel de detalle de segundo. Es un error establecer un valor inferior a un segundo. De forma predeterminada, los pings de mantenimiento de la conexión están inhabilitados. Debes coordinar con el propietario del servicio antes de habilitar este parámetro de configuración. Por ejemplo, para establecer un valor de 30 segundos en esta marca, se debe hacer de la siguiente manera: --grpc_keepalive_time=30s
--grpc_keepalive_timeout=<An immutable length of time.>
predeterminado: "20s"- Configura un tiempo de espera de keepalive para las conexiones gRPC salientes. Si los pings de mantenimiento están habilitados con --grpc_keepalive_time, Bazel agota el tiempo de espera de una conexión si no recibe una respuesta de ping después de este tiempo. Los tiempos se tratan como nivel de detalle de segundo. Es un error establecer un valor inferior a un segundo. Si los pings de mantenimiento de la conexión están inhabilitados, se ignora este parámetro de configuración.
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
- Anula un repositorio con un directorio local.
--package_path=<colon-separated list of options>
predeterminado: "%workspace%"- Es una lista separada por dos puntos de dónde buscar paquetes. Los elementos que comienzan con "%workspace%" son relativos al lugar de trabajo que los contiene. Si se omite o está vacío, el valor predeterminado es el resultado de "bazel info default-package-path".
--[no]show_loading_progress
predeterminado: "true"- Si está habilitado, hace que Bazel imprima mensajes de “Carga del paquete:”.
--tls_certificate=<a string>
predeterminado: Consulta la descripción- Especifica una ruta de acceso a un certificado TLS de confianza para firmar certificados de servidor.
--tls_client_certificate=<a string>
predeterminado: Consulta la descripción- Especifica el certificado de cliente TLS que se usará. También debes proporcionar una clave de cliente para habilitar la autenticación del cliente.
--tls_client_key=<a string>
predeterminado: Consulta la descripción- Especifica la clave de cliente TLS que se usará. También debes proporcionar un certificado de cliente para habilitar la autenticación del cliente.
Run Options
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
-
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
predeterminado: “false”-
Si es verdadero, usa una cadena derivada de las URLs de las descargas del repositorio como canonical_id si no se especifica. Esto hace que un cambio en las URLs genere una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no provoquen que la caché oculte los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
predeterminado: “false”-
Si se establece, no se permite descargar repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, los repositorios externos pueden funcionar en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
--script_path=<a path>
predeterminado: Consulta la descripción-
Si se establece, escribe una secuencia de comandos de shell en el archivo determinado que invoque el destino. Si se establece esta opción, el destino no se ejecuta desde bazel. Usa "bazel run --script_path=foo //foo && ./foo" para invocar el objetivo "//foo". Esto difiere de "bazel run //foo" en que se libera el bloqueo de Bazel y el ejecutable se conecta al stdin de la terminal.
Etiquetas:affects_outputs
,execution
- Opciones que afectan la rigurosidad con la que Bazel aplica entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
--experimental_repository_hash_file=<a string>
predeterminado: ""-
Si no está vacío, especifica un archivo que contiene un valor resuelto, con el que se deben verificar los valores hash del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan varios usos de
--experimental_verify_repository_rules=<a string>
-
Si es una lista de reglas de repositorio para las que se debe verificar el hash del directorio de salida, siempre que se especifique un archivo con --experimental_repository_hash_file.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: "true"-
Etiquetas
sin operación:no_op
,deprecated
,experimental
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
-
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitadas en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "advertencia" -
Verifica si las dependencias directas de "bazel_dep" declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivarla a un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
- Anula un módulo con un directorio local.
- Se acumulan varios usos de
--registry=<a string>
-
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
- Opciones que especifican o alteran una entrada genérica en un comando de Bazel que no se incluye en otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de almacenamiento en caché y ejecución remotas:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
- Anula un repositorio con un directorio local.
Opciones de apagado
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
-
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
predeterminado: “false”-
Si es verdadero, usa una cadena derivada de las URLs de las descargas del repositorio como canonical_id si no se especifica. Esto hace que un cambio en las URLs genere una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no provoquen que la caché oculte los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
predeterminado: “false”-
Si se establece, no se permite descargar repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, los repositorios externos pueden funcionar en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que controlan el resultado del comando:
--iff_heap_size_greater_than=<an integer>
predeterminado: “0”-
Si es distinto de cero, el cierre solo apagará el servidor si la memoria total (en MB) que consume la JVM supera este valor.
Etiquetas:loses_incremental_state
,eagerness_to_exit
- Opciones que afectan la rigurosidad con la que Bazel aplica entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
--experimental_repository_hash_file=<a string>
predeterminado: ""-
Si no está vacío, especifica un archivo que contiene un valor resuelto, con el que se deben verificar los valores hash del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan varios usos de
--experimental_verify_repository_rules=<a string>
-
Si es una lista de reglas de repositorio para las que se debe verificar el hash del directorio de salida, siempre que se especifique un archivo con --experimental_repository_hash_file.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: "true"-
Etiquetas
sin operación:no_op
,deprecated
,experimental
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
-
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitados en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "advertencia" -
Verifica si las dependencias directas de "bazel_dep" declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivarla a un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
. - Anula un módulo con un directorio local.
- Se acumulan varios usos de
--registry=<a string>
. -
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
- Opciones que especifican o alteran una entrada genérica a un comando de Bazel que no se incluye en otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
. - Anula un repositorio con un directorio local.
Opciones de sincronización
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
. -
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
predeterminado: “false”-
Si es verdadero, usa una cadena derivada de las URLs de las descargas del repositorio como canonical_id si no se especifica. Esto hace que un cambio en las URLs genere una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no provoquen que la caché oculte los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
predeterminado: “false”-
Si se establece, no se permite descargar repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, los repositorios externos pueden funcionar en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de la compilación:
--[no]configure
predeterminado: “False”-
Solo los repositorios de sincronización marcados como "configurar" para la configuración del sistema.
Etiquetas:changes_inputs
--[no]incompatible_remote_dangling_symlinks
predeterminado: "true"-
Si se establece en "true" y --incompatible_remote_symlinks también es "true", los symlinks en los resultados de la acción pueden colgar.
Etiquetas:execution
,incompatible_change
--[no]incompatible_remote_symlinks
predeterminado: "true"-
Si se establece como verdadero, Bazel representará los symlinks en los resultados de la acción en el protocolo de ejecución o almacenamiento en caché remoto como tal. De lo contrario, se seguirán los symlinks y se representarán como archivos o directorios. Consulta el problema #6631 para obtener más información.
Etiquetas:execution
,incompatible_change
--[no]keep_going
[-k
] predeterminado: "false"-
Continúa tanto como sea posible después de un error. Si bien no se pueden analizar el objetivo que falló ni los que dependen de él, sí se pueden analizar otros requisitos previos de estos objetivos.
Etiquetas:eagerness_to_exit
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
predeterminado: “auto”-
Cantidad de subprocesos en paralelo que se usarán para la fase de carga o análisis. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". "auto" establece un valor predeterminado razonable según los recursos del host. Debe ser 1 como mínimo.
Etiquetas:bazel_internal_configuration
- Se acumulan varios usos de
--only=<a string>
. -
Si se proporciona esta opción, solo se sincronizarán los repositorios especificados con esta opción. Aún se consideran obsoletos todos los comandos (o todos los comandos similares a configure, si se proporciona --configure).
Etiquetas:changes_inputs
- Son opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
--bep_maximum_open_remote_upload_files=<an integer>
predeterminado: “-1”-
Es la cantidad máxima de archivos abiertos permitidos durante la carga de artefactos de BEP.
Etiquetas:affects_outputs
--remote_download_minimal
-
No descarga ningún resultado de compilación remota a la máquina local. Esta marca es un atajo para las marcas: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata y --remote_download_outputs=minimal.
Se expande a:
--nobuild_runfile_links
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=minimal
Etiquetas:affects_outputs
--remote_download_outputs=<all, minimal or toplevel>
predeterminado: “all”-
Si se establece en "minimal", no se descargan resultados de compilación remotas en la máquina local, excepto los que requieren las acciones locales. Si se establece en "toplevel", se comporta como "minimal", excepto que también descarga los resultados de los destinos de nivel superior en la máquina local. Ambas opciones pueden reducir significativamente los tiempos de compilación si el ancho de banda de la red es un cuello de botella.
Etiquetas:affects_outputs
--remote_download_symlink_template=<a string>
predeterminado: ""-
En lugar de descargar resultados de compilación remotos en la máquina local, crea vínculos simbólicos. El destino de los vínculos simbólicos se puede especificar en forma de una cadena de plantilla. Esta cadena de plantilla puede contener {hash} y {size_bytes} que se expanden al hash del objeto y al tamaño en bytes, respectivamente. Estos vínculos simbólicos pueden, por ejemplo, apuntar a un sistema de archivos FUSE que cargue objetos del CAS a pedido.
Etiquetas:affects_outputs
--remote_download_toplevel
- Solo descarga resultados remotos de destinos de nivel superior en la máquina local. Esta marca es un atajo para las marcas: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata y --remote_download_outputs=toplevel.
Se expande a:
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=toplevel
Etiquetas:affects_outputs
- Opciones que afectan la rigurosidad con la que Bazel aplica entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etc.):
--experimental_repository_hash_file=<a string>
predeterminado: ""-
Si no está vacío, especifica un archivo que contiene un valor resuelto, con el que se deben verificar los valores hash del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan varios usos de
--experimental_verify_repository_rules=<a string>
. -
Si es una lista de reglas de repositorio para las que se debe verificar el hash del directorio de salida, siempre que se especifique un archivo con --experimental_repository_hash_file.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: "true"-
Etiquetas de
sin operación:no_op
,deprecated
,experimental
--[no]incompatible_config_setting_private_default_visibility
predeterminado: “false”-
Si incompatible_enforce_config_setting_visibility=false, esto es una operación no realizada. De lo contrario, si esta marca es falsa, cualquier config_setting sin un atributo de visibilidad explícito es //visibility:public. Si esta marca es verdadera, config_setting sigue la misma lógica de visibilidad que todas las demás reglas. Consulta https://github.com/bazelbuild/bazel/issues/12933.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
predeterminado: "true"-
Si es verdadero, aplica las restricciones de visibilidad de config_setting. Si es falso, todos los config_setting son visibles para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
. -
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitados en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "advertencia" -
Verifica si las dependencias directas de "bazel_dep" declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivarla a un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
. - Anula un módulo con un directorio local.
- Se acumulan varios usos de
--registry=<a string>
. -
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
--experimental_repository_resolved_file=<a string>
predeterminado: ""-
Si no está vacío, escribe un valor Starlark con la información resuelta de todas las reglas del repositorio Starlark que se ejecutaron.
Etiquetas:affects_outputs
- Valor predeterminado de
--remote_print_execution_messages=<failure, success or all>
: “failure” -
Elige cuándo imprimir los mensajes de ejecución remota. Los valores válidos son "failure" para imprimir solo en caso de fallas, "success" para imprimir solo en caso de éxitos y "all" para imprimir siempre.
Etiquetas:terminal_output
- Son opciones que especifican o alteran una entrada genérica en un comando de Bazel que no pertenece a otras categorías.:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
--[no]experimental_guard_against_concurrent_changes
predeterminado: “false”- Desactiva esta opción para inhabilitar la verificación del ctime de los archivos de entrada de una acción antes de subirla a una caché remota. Puede haber casos en los que el kernel de Linux retrase la escritura de archivos, lo que podría generar falsos positivos.
--experimental_remote_build_event_upload=<all or minimal>
predeterminado: “all”- Si se establece en “todos”, todos los resultados locales a los que hace referencia BEP se suben a la caché remota. Si se establece en “minimal”, los resultados locales a los que hace referencia BEP no se suben a la caché remota, excepto los archivos que son importantes para los consumidores de BEP (p.ej., registros de prueba y perfil de tiempo). Se usa el esquema file:// para las rutas de acceso de los archivos locales y el esquema bytestream:// para las rutas de acceso de los archivos (ya) subidos. El valor predeterminado es “all”.
--[no]experimental_remote_cache_async
predeterminado: “false”- Si es verdadero, las operaciones de E/S de caché remota se realizarán en segundo plano en lugar de hacerlo como parte de un inicio.
--[no]experimental_remote_cache_compression
predeterminado: “false”- Si está habilitado, comprime o descomprime los blobs de caché con zstd.
--experimental_remote_capture_corrupted_outputs=<a path>
predeterminado: Consulta la descripción- Es una ruta de acceso a un directorio en el que se capturarán los resultados dañados.
--experimental_remote_downloader=<a string>
predeterminado: Consulta la descripción- Es un URI de extremo de la API de Remote Asset que se usará como proxy de descarga remoto. Los esquemas admitidos son grpc, grpcs (grpc con TLS habilitado) y unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel usará grpcs de forma predeterminada. Consulta: https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto
--[no]experimental_remote_downloader_local_fallback
predeterminado: “false”- Indica si se debe recurrir al descargador local si falla el descargador remoto.
--[no]experimental_remote_execution_keepalive
predeterminado: “false”- Indica si se debe usar el mantenimiento de la conexión para las llamadas de ejecución remotas.
--experimental_remote_grpc_log=<a path>
predeterminado: Consulta la descripción- Si se especifica, es una ruta de acceso a un archivo para registrar los detalles relacionados con las llamadas de gRPC. Este registro consta de una secuencia de protobufs com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry serializados con cada mensaje con un prefijo de varint que indica el tamaño del siguiente mensaje de protobuf serializado, como lo realiza el método LogEntry.writeDelimitedTo(OutputStream).
--[no]experimental_remote_mark_tool_inputs
predeterminado: “false”- Si se establece como verdadero, Bazel marcará las entradas como entradas de herramientas para el ejecutor remoto. Esto se puede usar para implementar trabajadores persistentes remotos.
--[no]experimental_remote_merkle_tree_cache
predeterminado: “false”- Si se establece como verdadero, los cálculos del árbol de Merkle se almacenarán en caché para mejorar la velocidad de verificación de hits de caché remotos. El espacio en memoria de la caché se controla con --experimental_remote_merkle_tree_cache_size.
--experimental_remote_merkle_tree_cache_size=<a long integer>
predeterminado: "1000"- Es la cantidad de árboles de Merkle que se deben almacenar en caché para mejorar la velocidad de verificación de aciertos de caché remotos. Aunque la caché se poda automáticamente según el manejo de referencias suaves de Java, pueden ocurrir errores de falta de memoria si se establece demasiado 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.
--[no]incompatible_remote_build_event_upload_respect_no_cache
predeterminado: “false”- Si se establece como verdadero, los resultados a los que hace referencia BEP no se suben a la caché remota si la acción de generación no se puede almacenar en caché de forma remota.
--[no]incompatible_remote_downloader_send_all_headers
predeterminado: "true"-
Indica si se deben enviar todos los valores de un encabezado con varios valores al descargador remoto en lugar de solo el primero.
Etiquetas:incompatible_change
--[no]incompatible_remote_output_paths_relative_to_input_root
predeterminado: “false”-
Si se establece como verdadero, las rutas de acceso de salida son relativas a la raíz de entrada en lugar del directorio de trabajo.
Etiquetas:incompatible_change
--[no]incompatible_remote_results_ignore_disk
predeterminado: "true"-
Si se establece como verdadero, --noremote_upload_local_results y --noremote_accept_cached no se aplicarán a la caché del disco. Si se usa una caché combinada,
--noremote_upload_local_results hará que los resultados se escriban en la caché del disco, pero no se suban a la caché remota.
--noremote_accept_cached hará que Bazel busque resultados en la caché del disco, pero no en la caché remota.
Las acciones sin ejecución remota pueden afectar la caché del disco.
Consulta #8216 para obtener más información.
Etiquetas:incompatible_change
--[no]remote_accept_cached
predeterminado: "true"- Indica si se aceptan los resultados de las acciones almacenadas en caché de forma remota.
--remote_bytestream_uri_prefix=<a string>
predeterminado: Consulta la descripción- Es el nombre de host y el nombre de la instancia que se usarán en los URIs bytestream:// que se escriben en los flujos de eventos de compilación. Esta opción se puede establecer cuando las compilaciones se realizan con un proxy, lo que hace que los valores de --remote_executor y --remote_instance_name ya no correspondan al nombre canónico del servicio de ejecución remota. Si no se establece, el valor predeterminado será “${hostname}/${instance_name}”.
--remote_cache=<a string>
predeterminado: Consulta la descripción- Es un URI de un extremo de almacenamiento en caché. Los esquemas compatibles son http, https, grpc, grpcs (grpc con TLS habilitado) y unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel usará grpcs de forma predeterminada. Especifica el esquema grpc://, http:// o unix: para inhabilitar TLS. Consulta https://bazel.build/remote/caching
- Se acumulan varios usos de
--remote_cache_header=<a 'name=value' assignment>
. - Especifica un encabezado que se incluirá en las solicitudes de caché: --remote_cache_header=Nombre=Valor. Se pueden pasar varios encabezados si especificas la marca varias veces. Los múltiples valores para el mismo nombre se convertirán en una lista separada por comas.
- Se acumulan varios usos de
--remote_default_exec_properties=<a 'name=value' assignment>
. -
Establece las propiedades de ejecución predeterminadas que se usarán como la plataforma de ejecución remota si una plataforma de ejecución aún no establece exec_properties.
Etiquetas:affects_outputs
--remote_default_platform_properties=<a string>
predeterminado: ""- Establece las propiedades de plataforma predeterminadas que se establecerán para la API de ejecución remota, si la plataforma de ejecución aún no establece remote_execution_properties. Este valor también se usará si se selecciona la plataforma host como la plataforma de ejecución para la ejecución remota.
- Se acumulan varios usos de
--remote_downloader_header=<a 'name=value' assignment>
. - Especifica un encabezado que se incluirá en las solicitudes del descargador remoto: --remote_downloader_header=Nombre=Valor. Se pueden pasar varios encabezados si especificas la marca varias veces. Los múltiples valores para el mismo nombre se convertirán en una lista separada por comas.
- Se acumulan varios usos de
--remote_exec_header=<a 'name=value' assignment>
. - Especifica un encabezado que se incluirá en las solicitudes de ejecución: --remote_exec_header=Nombre=Valor. Se pueden pasar varios encabezados si especificas la marca varias veces. Los múltiples valores para el mismo nombre se convertirán en una lista separada por comas.
--remote_execution_priority=<an integer>
predeterminado: “0”- Es la prioridad relativa de las acciones que se ejecutarán de forma remota. La semántica de los valores de prioridad particulares depende del servidor.
--remote_executor=<a string>
predeterminado: Consulta la descripción- HOST o HOST:PORT de un extremo de ejecución remota. Los esquemas admitidos son grpc, grpcs (grpc con TLS habilitado) y unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel usará grpcs de forma predeterminada. Especifica el esquema grpc:// o unix: para inhabilitar TLS.
- Se acumulan varios usos de
--remote_header=<a 'name=value' assignment>
. - Especifica un encabezado que se incluirá en las solicitudes: --remote_header=Nombre=Valor. Se pueden pasar varios encabezados si especificas la marca varias veces. Los múltiples valores para el mismo nombre se convertirán en una lista separada por comas.
--remote_instance_name=<a string>
predeterminado: ""- Es el valor que se pasa como instance_name en la API de ejecución remota.
--[no]remote_local_fallback
predeterminado: “false”- Determina si se debe recurrir a la estrategia de ejecución local independiente si falla la ejecución remota.
- Valor predeterminado de
--remote_local_fallback_strategy=<a string>
: “local” - No realiza ninguna acción, está obsoleto. Consulta https://github.com/bazelbuild/bazel/issues/7480 para obtener más información.
--remote_max_connections=<an integer>
predeterminado: "100"-
Limita la cantidad máxima de conexiones simultáneas a la caché o al ejecutor remotos. De forma predeterminada, el valor es 100. Si lo estableces en 0, no habrá limitaciones.
Para la caché remota de HTTP, una conexión TCP podría controlar una solicitud a la vez, por lo que Bazel podría realizar hasta --remote_max_connections solicitudes simultáneas.
En el caso de la caché o el ejecutor remotos de gRPC, un canal de gRPC suele poder controlar más de 100 solicitudes simultáneas, por lo que Bazel podría realizar alrededor de `--remote_max_connections * 100` solicitudes simultáneas.
Etiquetas:host_machine_resource_optimizations
--remote_proxy=<a string>
predeterminado: Consulta la descripción- Conéctate a la caché remota a través de un proxy. Actualmente, esta marca solo se puede usar para configurar un socket de dominio Unix (unix:/path/to/socket).
--remote_result_cache_priority=<an integer>
predeterminado: “0”- Es la prioridad relativa de las acciones remotas que se almacenarán en la caché remota. La semántica de los valores de prioridad particulares depende del servidor.
--remote_retries=<an integer>
predeterminado: “5”- Es la cantidad máxima de intentos para reintentar un error transitorio. Si se establece en 0, se inhabilitan los reintentos.
--remote_timeout=<An immutable length of time.>
predeterminado: "60s"- Es la cantidad máxima de tiempo que se espera para la ejecución remota y las llamadas a la caché. Para la caché de REST, este es el tiempo de espera de conexión y lectura. Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
--[no]remote_upload_local_results
predeterminado: "true"- Determina si se deben subir los resultados de las acciones ejecutadas de forma local a la caché remota si esta la admite y el usuario está autorizado para hacerlo.
--[no]remote_verify_downloads
predeterminado: "true"- Si se establece como verdadero, Bazel calculará la suma de hash de todas las descargas remotas y descartará los valores almacenados en caché de forma remota si no coinciden con el valor esperado.
- Opciones misceláneas que no se clasifican de otra manera:
--deleted_packages=<comma-separated list of package names>
predeterminado: ""- Es una lista separada por comas de nombres de paquetes que el sistema de compilación considerará inexistentes, incluso si son visibles en algún lugar de la ruta de acceso del paquete. Usa esta opción cuando borres un subpaquete "x/y" de un paquete existente "x". Por ejemplo, después de borrar x/y/BUILD en tu cliente, es posible que el sistema de compilación se queje si encuentra una etiqueta "//x:y/z" si otra entrada de package_path aún la proporciona. Especificar --deleted_packages x/y evita este problema.
--disk_cache=<a path>
predeterminado: Consulta la descripción- Es una ruta de acceso a un directorio en el que Bazel puede leer y escribir acciones y resultados de acciones. Si el directorio no existe, se creará.
- Se acumulan varios usos de
--experimental_credential_helper=<An (unresolved) path to a credential helper for a scope.>
. - Configura los auxiliares de credenciales que se usarán para recuperar credenciales para el alcance (dominio) proporcionado. Las credenciales de los asistentes de credenciales tienen prioridad sobre las credenciales de <code>--google_default_credentials</code>, `--google_credentials` o <code>.netrc</code>. Consulta https://github.com/bazelbuild/proposals/blob/main/designs/2022-06-07-bazel-credential-helpers.md para obtener más información.
--experimental_credential_helper_cache_duration=<An immutable length of time.>
predeterminado: “30m”- Configura la duración durante la cual se almacenan en caché las credenciales de los auxiliares de credenciales. Si lo invocas con un valor diferente, se ajustará la vida útil de las entradas preexistentes. Pasa cero para borrar la caché. Un comando clean siempre borra la caché, independientemente de esta marca.
--experimental_credential_helper_timeout=<An immutable length of time.>
predeterminado: "5s"- Configura el tiempo de espera del Asistente de credenciales. Si los auxiliares de credenciales no responden dentro de este tiempo de espera, la invocación fallará.
--google_auth_scopes=<comma-separated list of options>
predeterminado: "https://www.googleapis.com/auth/cloud-platform"- Es una lista separada por comas de los permisos de autenticación de Google Cloud.
--google_credentials=<a string>
predeterminado: Consulta la descripción- Especifica el archivo del que se deben obtener las credenciales de autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más información.
--[no]google_default_credentials
predeterminado: “false”- Indica si se deben usar "Credenciales predeterminadas de la aplicación de Google" para la autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más información. Está inhabilitado de forma predeterminada.
--grpc_keepalive_time=<An immutable length of time.>
predeterminado: Consulta la descripción- Configura pings de keepalive para las conexiones de gRPC salientes. Si se establece, Bazel envía pings después de este tiempo sin operaciones de lectura en la conexión, pero solo si hay al menos una llamada gRPC pendiente. Los tiempos se tratan como nivel de detalle de segundo. Es un error establecer un valor inferior a un segundo. De forma predeterminada, los pings de mantenimiento de la conexión están inhabilitados. Debes coordinar con el propietario del servicio antes de habilitar este parámetro de configuración. Por ejemplo, para establecer un valor de 30 segundos en esta marca, se debe hacer de la siguiente manera: --grpc_keepalive_time=30s
--grpc_keepalive_timeout=<An immutable length of time.>
predeterminado: "20s"- Configura un tiempo de espera de keepalive para las conexiones gRPC salientes. Si los pings de mantenimiento están habilitados con --grpc_keepalive_time, Bazel agota el tiempo de espera de una conexión si no recibe una respuesta de ping después de este tiempo. Los tiempos se tratan como nivel de detalle de segundo. Es un error establecer un valor inferior a un segundo. Si los pings de mantenimiento de la conexión están inhabilitados, se ignora este parámetro de configuración.
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
. - Anula un repositorio con un directorio local.
--package_path=<colon-separated list of options>
predeterminado: "%workspace%"- Es una lista separada por dos puntos de dónde buscar paquetes. Los elementos que comienzan con "%workspace%" son relativos al lugar de trabajo que los contiene. Si se omite o está vacío, el valor predeterminado es el resultado de "bazel info default-package-path".
--[no]show_loading_progress
predeterminado: "true"- Si está habilitado, hace que Bazel imprima mensajes de “Carga del paquete:”.
--tls_certificate=<a string>
predeterminado: Consulta la descripción- Especifica una ruta de acceso a un certificado TLS de confianza para firmar certificados de servidor.
--tls_client_certificate=<a string>
predeterminado: Consulta la descripción- Especifica el certificado de cliente TLS que se usará. También debes proporcionar una clave de cliente para habilitar la autenticación del cliente.
--tls_client_key=<a string>
predeterminado: Consulta la descripción- Especifica la clave de cliente TLS que se usará. También debes proporcionar un certificado de cliente para habilitar la autenticación del cliente.
Opciones de prueba
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
. -
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
predeterminado: “false”-
Si es verdadero, usa una cadena derivada de las URLs de las descargas del repositorio como canonical_id si no se especifica. Esto hace que un cambio en las URLs genere una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no provoquen que la caché oculte los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
predeterminado: “false”-
Si se establece, no se permite descargar repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, los repositorios externos pueden funcionar en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de la compilación:
--[no]incompatible_remote_dangling_symlinks
predeterminado: "true"-
Si se establece en "true" y --incompatible_remote_symlinks también es "true", los symlinks en los resultados de la acción pueden colgar.
Etiquetas:execution
,incompatible_change
--[no]incompatible_remote_symlinks
predeterminado: "true"-
Si se establece como verdadero, Bazel representará los symlinks en los resultados de la acción en el protocolo de ejecución o almacenamiento en caché remoto como tal. De lo contrario, se seguirán los symlinks y se representarán como archivos o directorios. Consulta el problema #6631 para obtener más información.
Etiquetas
:execution
,incompatible_change
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
--bep_maximum_open_remote_upload_files=<an integer>
predeterminado: “-1”-
Cantidad máxima de archivos abiertos permitidos durante la carga de artefactos de BEP.
Etiquetas:affects_outputs
--remote_download_minimal
-
No descarga ningún resultado de compilación remota a la máquina local. Esta marca es un atajo para las marcas: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata y --remote_download_outputs=minimal.
Se expande a:
--nobuild_runfile_links
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=minimal
Etiquetas:affects_outputs
--remote_download_outputs=<all, minimal or toplevel>
predeterminado: “all”-
Si se establece en "minimal", no se descargan resultados de compilación remotas en la máquina local, excepto los que requieren las acciones locales. Si se establece en "toplevel", se comporta como "minimal", excepto que también descarga los resultados de los destinos de nivel superior en la máquina local. Ambas opciones pueden reducir significativamente los tiempos de compilación si el ancho de banda de la red es un cuello de botella.
Etiquetas:affects_outputs
--remote_download_symlink_template=<a string>
predeterminado: ""-
En lugar de descargar resultados de compilación remotos en la máquina local, crea vínculos simbólicos. El destino de los vínculos simbólicos se puede especificar en forma de una cadena de plantilla. Esta cadena de plantilla puede contener {hash} y {size_bytes} que se expanden al hash del objeto y al tamaño en bytes, respectivamente. Estos vínculos simbólicos pueden, por ejemplo, apuntar a un sistema de archivos FUSE que cargue objetos del CAS a pedido.
Etiquetas:affects_outputs
--remote_download_toplevel
- Solo descarga resultados remotos de destinos de nivel superior en la máquina local. Esta marca es un atajo para las marcas: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata y --remote_download_outputs=toplevel.
Se expande a:
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=toplevel
Etiquetas:affects_outputs
- Opciones que afectan la rigurosidad con la que Bazel aplica entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etc.):
--experimental_repository_hash_file=<a string>
predeterminado: ""-
Si no está vacío, especifica un archivo que contiene un valor resuelto, con el que se deben verificar los valores hash del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan varios usos de
--experimental_verify_repository_rules=<a string>
-
Si es una lista de reglas de repositorio para las que se debe verificar el hash del directorio de salida, siempre que se especifique un archivo con --experimental_repository_hash_file.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: "true"-
Etiquetas
sin operación:no_op
,deprecated
,experimental
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
-
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitadas en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "advertencia" -
Verifica si las dependencias directas de "bazel_dep" declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivarla a un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
- Anula un módulo con un directorio local.
- Se acumulan varios usos de
--registry=<a string>
-
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
--[no]print_relative_test_log_paths
predeterminado: “false”-
Si es verdadero, cuando imprimas la ruta de acceso a un registro de prueba, usa la ruta de acceso relativa que usa el symlink de conveniencia "testlogs". Nota: Una invocación posterior de "build", "test", etc., con una configuración diferente puede hacer que cambie el destino de este symlink, por lo que la ruta impresa anteriormente ya no es útil.
Etiquetas:affects_outputs
- Valor predeterminado de
--remote_print_execution_messages=<failure, success or all>
: “failure” -
Elige cuándo imprimir los mensajes de ejecución remota. Los valores válidos son "failure" para imprimir solo en caso de fallas, "success" para imprimir solo en caso de éxitos y "all" para imprimir siempre.
Etiquetas:terminal_output
--[no]test_verbose_timeout_warnings
predeterminado: “false”-
Si es verdadero, imprime advertencias adicionales cuando el tiempo de ejecución real de la prueba no coincida con el tiempo de espera definido por la prueba (ya sea implícito o explícito).
Etiquetas:affects_outputs
--[no]verbose_test_summary
predeterminado: "true"-
Si es verdadero, imprime información adicional (tiempos, cantidad de ejecuciones fallidas, etcétera) en el resumen de la prueba.
Etiquetas:affects_outputs
- Son opciones que especifican o alteran una entrada genérica en un comando de Bazel que no pertenece a otras categorías.:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite"), seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
--[no]experimental_guard_against_concurrent_changes
predeterminado: “false”- Desactiva esta opción para inhabilitar la verificación del ctime de los archivos de entrada de una acción antes de subirla a una caché remota. Puede haber casos en los que el kernel de Linux retrase la escritura de archivos, lo que podría generar falsos positivos.
--experimental_remote_build_event_upload=<all or minimal>
predeterminado: “all”- Si se establece en “todos”, todos los resultados locales a los que hace referencia BEP se suben a la caché remota. Si se establece en “minimal”, los resultados locales a los que hace referencia BEP no se suben a la caché remota, excepto los archivos que son importantes para los consumidores de BEP (p.ej., registros de prueba y perfil de tiempo). Se usa el esquema file:// para las rutas de acceso de los archivos locales y el esquema bytestream:// para las rutas de acceso de los archivos (ya) subidos. El valor predeterminado es “all”.
--[no]experimental_remote_cache_async
predeterminado: “false”- Si es verdadero, las operaciones de E/S de caché remota se realizarán en segundo plano en lugar de hacerlo como parte de un inicio.
--[no]experimental_remote_cache_compression
predeterminado: “false”- Si está habilitado, comprime o descomprime los blobs de caché con zstd.
--experimental_remote_capture_corrupted_outputs=<a path>
predeterminado: Consulta la descripción- Es una ruta de acceso a un directorio en el que se capturarán los resultados dañados.
--experimental_remote_downloader=<a string>
predeterminado: Consulta la descripción- Es un URI de extremo de la API de Remote Asset que se usará como proxy de descarga remoto. Los esquemas admitidos son grpc, grpcs (grpc con TLS habilitado) y unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel usará grpcs de forma predeterminada. Consulta: https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto
--[no]experimental_remote_downloader_local_fallback
predeterminado: “false”- Indica si se debe recurrir al descargador local si falla el descargador remoto.
--[no]experimental_remote_execution_keepalive
predeterminado: “false”- Indica si se debe usar el mantenimiento de la conexión para las llamadas de ejecución remotas.
--experimental_remote_grpc_log=<a path>
predeterminado: Consulta la descripción- Si se especifica, es una ruta de acceso a un archivo para registrar los detalles relacionados con las llamadas de gRPC. Este registro consta de una secuencia de protobufs com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry serializados con cada mensaje con un prefijo de varint que indica el tamaño del siguiente mensaje de protobuf serializado, como lo realiza el método LogEntry.writeDelimitedTo(OutputStream).
--[no]experimental_remote_mark_tool_inputs
predeterminado: “false”- Si se establece como verdadero, Bazel marcará las entradas como entradas de herramientas para el ejecutor remoto. Esto se puede usar para implementar trabajadores persistentes remotos.
--[no]experimental_remote_merkle_tree_cache
predeterminado: “false”- Si se establece como verdadero, los cálculos del árbol de Merkle se almacenarán en caché para mejorar la velocidad de verificación de hits de caché remotos. El espacio en memoria de la caché se controla con --experimental_remote_merkle_tree_cache_size.
--experimental_remote_merkle_tree_cache_size=<a long integer>
predeterminado: “1000”- Es la cantidad de árboles de Merkle que se deben almacenar en caché para mejorar la velocidad de verificación de aciertos de caché remotos. Aunque la caché se poda automáticamente según el manejo de referencias suaves de Java, pueden ocurrir errores de falta de memoria si se establece demasiado alta. Si se establece en 0, el tamaño de la caché es ilimitado. El valor óptimo varía según el tamaño del proyecto. El valor predeterminado es 1,000.
--[no]incompatible_remote_build_event_upload_respect_no_cache
predeterminado: “false”- Si se establece como verdadero, los resultados a los que hace referencia BEP no se suben a la caché remota si la acción de generación no se puede almacenar en caché de forma remota.
--[no]incompatible_remote_downloader_send_all_headers
predeterminado: "true"-
Indica si se deben enviar todos los valores de un encabezado con varios valores al descargador remoto en lugar de solo el primero.
Etiquetas:incompatible_change
--[no]incompatible_remote_output_paths_relative_to_input_root
predeterminado: “false”-
Si se establece como verdadero, las rutas de acceso de salida son relativas a la raíz de entrada en lugar del directorio de trabajo.
Etiquetas:incompatible_change
--[no]incompatible_remote_results_ignore_disk
predeterminado: "true"-
Si se establece como verdadero, --noremote_upload_local_results y --noremote_accept_cached no se aplicarán a la caché del disco. Si se usa una caché combinada,
--noremote_upload_local_results hará que los resultados se escriban en la caché del disco, pero no se suban a la caché remota.
--noremote_accept_cached hará que Bazel busque resultados en la caché del disco, pero no en la caché remota.
Las acciones sin ejecución remota pueden afectar la caché del disco.
Consulta #8216 para obtener más información.
Etiquetas:incompatible_change
--[no]remote_accept_cached
predeterminado: "true"- Indica si se aceptan los resultados de las acciones almacenadas en caché de forma remota.
--remote_bytestream_uri_prefix=<a string>
predeterminado: Consulta la descripción- Es el nombre de host y el nombre de la instancia que se usarán en los URIs bytestream:// que se escriben en los flujos de eventos de compilación. Esta opción se puede establecer cuando las compilaciones se realizan con un proxy, lo que hace que los valores de --remote_executor y --remote_instance_name ya no correspondan al nombre canónico del servicio de ejecución remota. Si no se establece, el valor predeterminado será “${hostname}/${instance_name}”.
--remote_cache=<a string>
predeterminado: Consulta la descripción- Es un URI de un extremo de almacenamiento en caché. Los esquemas compatibles son http, https, grpc, grpcs (grpc con TLS habilitado) y unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel usará grpcs de forma predeterminada. Especifica el esquema grpc://, http:// o unix: para inhabilitar TLS. Consulta https://bazel.build/remote/caching
- Se acumulan varios usos de
--remote_cache_header=<a 'name=value' assignment>
- Especifica un encabezado que se incluirá en las solicitudes de caché: --remote_cache_header=Nombre=Valor. Se pueden pasar varios encabezados si especificas la marca varias veces. Los múltiples valores para el mismo nombre se convertirán en una lista separada por comas.
- Se acumulan varios usos de
--remote_default_exec_properties=<a 'name=value' assignment>
-
Establece las propiedades de ejecución predeterminadas que se usarán como la plataforma de ejecución remota si una plataforma de ejecución aún no establece exec_properties.
Etiquetas:affects_outputs
--remote_default_platform_properties=<a string>
predeterminado: ""- Establece las propiedades de plataforma predeterminadas que se establecerán para la API de ejecución remota, si la plataforma de ejecución aún no establece remote_execution_properties. Este valor también se usará si se selecciona la plataforma host como la plataforma de ejecución para la ejecución remota.
- Se acumulan varios usos de
--remote_downloader_header=<a 'name=value' assignment>
- Especifica un encabezado que se incluirá en las solicitudes del descargador remoto: --remote_downloader_header=Nombre=Valor. Se pueden pasar varios encabezados si especificas la marca varias veces. Los múltiples valores para el mismo nombre se convertirán en una lista separada por comas.
- Se acumulan varios usos de
--remote_exec_header=<a 'name=value' assignment>
- Especifica un encabezado que se incluirá en las solicitudes de ejecución: --remote_exec_header=Nombre=Valor. Se pueden pasar varios encabezados si especificas la marca varias veces. Los múltiples valores para el mismo nombre se convertirán en una lista separada por comas.
--remote_execution_priority=<an integer>
predeterminado: “0”- Es la prioridad relativa de las acciones que se ejecutarán de forma remota. La semántica de los valores de prioridad particulares depende del servidor.
--remote_executor=<a string>
predeterminado: Consulta la descripción- HOST o HOST:PORT de un extremo de ejecución remota. Los esquemas admitidos son grpc, grpcs (grpc con TLS habilitado) y unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel usará grpcs de forma predeterminada. Especifica el esquema grpc:// o unix: para inhabilitar TLS.
- Se acumulan varios usos de
--remote_header=<a 'name=value' assignment>
- Especifica un encabezado que se incluirá en las solicitudes: --remote_header=Nombre=Valor. Se pueden pasar varios encabezados si especificas la marca varias veces. Los múltiples valores para el mismo nombre se convertirán en una lista separada por comas.
--remote_instance_name=<a string>
predeterminado: ""- Es el valor que se pasa como instance_name en la API de ejecución remota.
--[no]remote_local_fallback
predeterminado: “false”- Determina si se debe recurrir a la estrategia de ejecución local independiente si falla la ejecución remota.
- Valor predeterminado de
--remote_local_fallback_strategy=<a string>
: “local” - No realiza ninguna acción, está obsoleto. Consulta https://github.com/bazelbuild/bazel/issues/7480 para obtener más información.
--remote_max_connections=<an integer>
predeterminado: "100"-
Limita la cantidad máxima de conexiones simultáneas a la caché o al ejecutor remotos. De forma predeterminada, el valor es 100. Si lo estableces en 0, no habrá limitaciones.
Para la caché remota de HTTP, una conexión TCP podría controlar una solicitud a la vez, por lo que Bazel podría realizar hasta --remote_max_connections solicitudes simultáneas.
En el caso de la caché o el ejecutor remotos de gRPC, un canal de gRPC suele poder controlar más de 100 solicitudes simultáneas, por lo que Bazel podría realizar alrededor de `--remote_max_connections * 100` solicitudes simultáneas.
Etiquetas:host_machine_resource_optimizations
--remote_proxy=<a string>
predeterminado: Consulta la descripción- Conéctate a la caché remota a través de un proxy. Actualmente, esta marca solo se puede usar para configurar un socket de dominio Unix (unix:/path/to/socket).
--remote_result_cache_priority=<an integer>
predeterminado: “0”- Es la prioridad relativa de las acciones remotas que se almacenarán en la caché remota. La semántica de los valores de prioridad particulares depende del servidor.
--remote_retries=<an integer>
predeterminado: “5”- Es la cantidad máxima de intentos para reintentar un error transitorio. Si se establece en 0, se inhabilitan los reintentos.
--remote_timeout=<An immutable length of time.>
predeterminado: "60s"- Es la cantidad máxima de tiempo que se espera para la ejecución remota y las llamadas a la caché. Para la caché de REST, este es el tiempo de espera de conexión y lectura. Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
--[no]remote_upload_local_results
predeterminado: "true"- Determina si se deben subir los resultados de las acciones ejecutadas de forma local a la caché remota si esta la admite y el usuario está autorizado para hacerlo.
--[no]remote_verify_downloads
predeterminado: "true"- Si se establece como verdadero, Bazel calculará la suma de hash de todas las descargas remotas y descartará los valores almacenados en caché de forma remota si no coinciden con el valor esperado.
- Opciones misceláneas que no se clasifican de otra manera:
--disk_cache=<a path>
predeterminado: Consulta la descripción- Es una ruta de acceso a un directorio en el que Bazel puede leer y escribir acciones y resultados de acciones. Si el directorio no existe, se creará.
- Se acumulan varios usos de
--experimental_credential_helper=<An (unresolved) path to a credential helper for a scope.>
. - Configura los auxiliares de credenciales que se usarán para recuperar credenciales para el alcance (dominio) proporcionado. Las credenciales de los asistentes de credenciales tienen prioridad sobre las credenciales de <code>--google_default_credentials</code>, `--google_credentials` o <code>.netrc</code>. Consulta https://github.com/bazelbuild/proposals/blob/main/designs/2022-06-07-bazel-credential-helpers.md para obtener más información.
- Valor predeterminado de
--experimental_credential_helper_cache_duration=<An immutable length of time.>
: “30m” - Configura la duración durante la cual se almacenan en caché las credenciales de los auxiliares de credenciales. Si lo invocas con un valor diferente, se ajustará la vida útil de las entradas preexistentes. Pasa cero para borrar la caché. Un comando clean siempre borra la caché, independientemente de esta marca.
--experimental_credential_helper_timeout=<An immutable length of time.>
predeterminado: "5s"- Configura el tiempo de espera del Asistente de credenciales. Si los auxiliares de credenciales no responden dentro de este tiempo de espera, la invocación fallará.
--google_auth_scopes=<comma-separated list of options>
predeterminado: "https://www.googleapis.com/auth/cloud-platform"- Es una lista separada por comas de los permisos de autenticación de Google Cloud.
--google_credentials=<a string>
predeterminado: Consulta la descripción- Especifica el archivo del que se deben obtener las credenciales de autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más información.
--[no]google_default_credentials
predeterminado: “false”- Indica si se deben usar "Credenciales predeterminadas de la aplicación de Google" para la autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más información. Está inhabilitado de forma predeterminada.
--grpc_keepalive_time=<An immutable length of time.>
predeterminado: Consulta la descripción- Configura pings de keepalive para las conexiones de gRPC salientes. Si se establece, Bazel envía pings después de este tiempo sin operaciones de lectura en la conexión, pero solo si hay al menos una llamada gRPC pendiente. Los tiempos se tratan como nivel de detalle de segundo. Es un error establecer un valor inferior a un segundo. De forma predeterminada, los pings de mantenimiento de la conexión están inhabilitados. Debes coordinar con el propietario del servicio antes de habilitar este parámetro de configuración. Por ejemplo, para establecer un valor de 30 segundos en esta marca, se debe hacer de la siguiente manera: --grpc_keepalive_time=30s
--grpc_keepalive_timeout=<An immutable length of time.>
predeterminado: "20s"- Configura un tiempo de espera de keepalive para las conexiones gRPC salientes. Si los pings de mantenimiento están habilitados con --grpc_keepalive_time, Bazel agota el tiempo de espera de una conexión si no recibe una respuesta de ping después de este tiempo. Los tiempos se tratan como nivel de detalle de segundo. Es un error establecer un valor inferior a un segundo. Si los pings de mantenimiento de la conexión están inhabilitados, se ignora este parámetro de configuración.
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
. - Anula un repositorio con un directorio local.
--tls_certificate=<a string>
predeterminado: Consulta la descripción- Especifica una ruta de acceso a un certificado TLS de confianza para firmar certificados de servidor.
--tls_client_certificate=<a string>
predeterminado: Consulta la descripción- Especifica el certificado de cliente TLS que se usará. También debes proporcionar una clave de cliente para habilitar la autenticación del cliente.
--tls_client_key=<a string>
predeterminado: Consulta la descripción- Especifica la clave de cliente TLS que se usará. También debes proporcionar un certificado de cliente para habilitar la autenticación del cliente.
Opciones de versión
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan varios usos de
--distdir=<a path>
. -
Lugares adicionales para buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
predeterminado: “false”-
Si se establece, la caché del repositorio creará un vínculo duro al archivo en caso de que se produzca un acierto en la caché, en lugar de copiarlo. Esto se hace para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
predeterminado: “false”-
Si es verdadero, usa una cadena derivada de las URLs de las descargas del repositorio como canonical_id si no se especifica. Esto hace que un cambio en las URLs genere una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no provoquen que la caché oculte los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
predeterminado: “false”-
Si se establece, no se permite descargar repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark por este factor. De esta manera, se puede hacer que los repositorios externos funcionen en máquinas que son más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas de HTTP según el factor determinado.
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: Consulta la descripción-
Especifica la ubicación de la caché de los valores descargados obtenidos durante la recuperación de repositorios externos. Una cadena vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
--[no]gnu_format
predeterminado: “false”-
Si se establece, escribe la versión en stdout con las convenciones que se describen en los estándares de GNU.
Etiquetas:affects_outputs
,execution
- Opciones que afectan la rigurosidad con la que Bazel aplica entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
--experimental_repository_hash_file=<a string>
predeterminado: ""-
Si no está vacío, especifica un archivo que contiene un valor resuelto, con el que se deben verificar los valores hash del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan varios usos de
--experimental_verify_repository_rules=<a string>
. -
Si es una lista de reglas de repositorio para las que se debe verificar el hash del directorio de salida, siempre que se especifique un archivo con --experimental_repository_hash_file.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: "true"-
Etiquetas
sin operación:no_op
,deprecated
,experimental
- Opciones relacionadas con el resultado y la semántica de Bzlmod:
- Se acumulan varios usos de
--allow_yanked_versions=<a string>
. -
Especificó las versiones del módulo en forma de "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran quitadas en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones quitadas provocarán que la resolución falle. También puedes definir la versión quitada permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: "error"-
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son "error" para derivarlo a un error de resolución, "off" para inhabilitar la verificación o "warning" para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_direct_dependencies=<off, warning or error>
: "advertencia" -
Verifica si las dependencias directas de "bazel_dep" declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para imprimir una advertencia cuando se detecta una discrepancia o "error" para derivarla a un error de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
predeterminado: “false”-
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- Se acumulan varios usos de
--override_module=<an equals-separated mapping of module name to path>
. - Anula un módulo con un directorio local.
- Se acumulan varios usos de
--registry=<a string>
. -
Especifica los registros que se usarán para ubicar las dependencias de los módulos de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo se recurrirá a los registros posteriores cuando no estén en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
predeterminado: “false”- De forma predeterminada, la cantidad de tipos de acciones se limita a las 20 mnemotecnias con la mayor cantidad de acciones ejecutadas. Si configuras esta opción, se escribirán estadísticas para todas las mnemotecnias.
- Opciones que especifican o alteran una entrada genérica en un comando de Bazel que no se incluye en otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de almacenamiento en caché y ejecución remotas:
--experimental_downloader_config=<a string>
predeterminado: Consulta la descripción- Especifica un archivo con el que configurar el descargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite"), seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para hacer coincidir y otro para usar como URL de sustitución, con referencias cruzadas que comienzan en "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias URLs.
- Opciones misceláneas que no se clasifican de otra manera:
- Se acumulan varios usos de
--override_repository=<an equals-separated mapping of repository name to path>
. - Anula un repositorio con un directorio local.
Etiquetas de efectos de opciones
unknown |
Esta opción tiene un efecto desconocido o no documentado. |
no_op |
Esta opción literalmente no tiene ningún efecto. |
loses_incremental_state |
Cambiar el valor de esta opción puede provocar una pérdida significativa del estado incremental, lo que ralentiza las compilaciones. Es posible que se pierda el estado debido a un reinicio del servidor o a la invalidación de una gran parte del gráfico de dependencias. |
changes_inputs |
Esta opción cambia de forma activa las entradas que bazel considera para la compilación, como las restricciones del sistema de archivos, las versiones del repositorio y otras opciones. |
affects_outputs |
Esta opción afecta los resultados de bazel. Esta etiqueta es amplia de forma intencional, puede incluir efectos transitivos y no especifica el tipo de resultado que afecta. |
build_file_semantics |
Esta opción afecta la semántica de los archivos BUILD o .bzl. |
bazel_internal_configuration |
Esta opción afecta la configuración de la maquinaria interna de Bazel. Esta etiqueta, por sí sola, no significa que los artefactos de compilación se vean afectados. |
loading_and_analysis |
Esta opción afecta la carga y el análisis de las dependencias, así como la compilación del gráfico de dependencias. |
execution |
Esta opción afecta la fase de ejecución, como las opciones relacionadas con la zona de pruebas o la ejecución remota. |
host_machine_resource_optimizations |
Esta opción activa una optimización que puede ser específica de la máquina y no se garantiza que funcione en todas las máquinas. La optimización podría incluir una compensación con otros aspectos del rendimiento, como el costo de la memoria o la CPU. |
eagerness_to_exit |
Esta opción cambia la rapidez con la que bazel saldrá de una falla, en la que existe una opción entre continuar a pesar de la falla y finalizar la invocación. |
bazel_monitoring |
Esta opción se usa para supervisar el comportamiento y el rendimiento de bazel. |
terminal_output |
Esta opción afecta el resultado de la terminal de bazel. |
action_command_lines |
Esta opción cambia los argumentos de línea de comandos de una o más acciones de compilación. |
test_runner |
Esta opción cambia el entorno de testrunner de la compilación. |
Etiquetas de metadatos de opciones
experimental |
Esta opción activa una función experimental sin garantías de funcionalidad. |
incompatible_change |
Esta opción activa un cambio rotundo. Usa esta opción para probar tu nivel de preparación para la migración o obtener acceso anticipado a la nueva función. |
deprecated |
Esta opción está obsoleta. Es posible que la función a la que afecta esté obsoleta o que se prefiera otro método para proporcionar la información. |
explicit_in_output_path |
Esta opción se menciona explícitamente en el directorio de salida. |