bazel [<startup options>] <command> [<args>]o
bazel [<startup options>] <command> [<args>] -- [<target patterns>]Consulta la Guía del usuario para conocer la sintaxis de los patrones de segmentación.
Sintaxis de la opción
Las opciones se pueden pasar a Bazel de diferentes maneras. Las opciones que requieren un valor se pueden pasar con un signo igual o un espacio:
--<option>=<value> --<option> <value>Algunas opciones tienen una forma corta de un solo carácter; en ese caso, la forma corta se debe pasar con un solo guion y espacio.
-<short_form> <value>
Las opciones booleanas se pueden habilitar de la siguiente manera:
--<option> --<option>=[true|yes|1]y, luego, inhabilitarse de la siguiente manera:
--no<option> --<option>=[false|no|0]
Las opciones de triestado suelen estar configuradas como automáticas de forma predeterminada y se pueden habilitar de manera forzosa de la siguiente manera:
--<option>=[true|yes|1]o forzar la inhabilitación de la siguiente manera:
--no<option> --<option>=[false|no|0]
Comandos
analyze-profile |
Analiza los datos de perfil de compilación. |
aquery |
Analiza los objetivos dados y consulta el gráfico de acción. |
build |
Compila los destinos especificados. |
canonicalize-flags |
Canonicaliza una lista de opciones de bazel. |
clean |
Quita los archivos de salida y, de manera opcional, detiene el servidor. |
coverage |
Genera un informe de cobertura de código para objetivos de prueba especificados. |
cquery |
Carga, analiza y consulta los objetivos especificados con configuraciones. |
dump |
Vuelca el estado interno del proceso del servidor de Bazel. |
fetch |
Recupera repositorios externos que son requisitos previos para los destinos. |
help |
Imprime la ayuda para los comandos o el índice. |
info |
Muestra información del entorno de ejecución sobre el servidor de Bazel. |
license |
Imprime la licencia de este software. |
mobile-install |
Instala destinos en dispositivos móviles. |
mod |
Consulta el gráfico de dependencia externa de Bzlmod |
print_action |
Imprime los argumentos de la línea de comandos para compilar un archivo. |
query |
Ejecuta una consulta de gráfico de dependencias. |
run |
Ejecuta el objetivo especificado. |
shutdown |
Detiene el servidor de Bazel. |
sync |
Sincroniza todos los repositorios especificados en el archivo del lugar de trabajo |
test |
Compila y ejecuta los destinos de prueba especificados. |
version |
Imprime la información de la versión de Bazel. |
Opciones de inicio
- Opciones que aparecen antes del comando y que el cliente analiza:
- El valor predeterminado de
--[no]autodetect_server_javabase
es "true" (verdadero). -
Cuando se pasa --noautodetect_server_javabase, Bazel no recurre al JDK local para ejecutar el servidor de Bazel y, en su lugar, se cierra.
Etiquetas:affects_outputs
,loses_incremental_state
--[no]batch
valor predeterminado: "false"-
Si se configura, Bazel se ejecutará como un proceso de cliente sin un servidor, en lugar de en el modo estándar de cliente/servidor. Esta función dejó de estar disponible y se quitará. Si quieres evitar que los servidores permanezcan activos, es preferible que apagues el servidor de forma explícita.
Etiquetas:loses_incremental_state
,bazel_internal_configuration
,deprecated
--[no]batch_cpu_scheduling
valor predeterminado: "false"-
Solo en Linux; usa la programación de CPU "por lotes" para Blaze. Esta política es útil para las cargas de trabajo que no son interactivas, pero que no desean reducir su valor adecuado. Consulta "man 2 sched_setscheduler". Si es falso, Bazel no realiza una llamada al sistema.
Etiquetas:host_machine_resource_optimizations
- Configuración predeterminada de
--bazelrc=<path>
: ver descripción -
La ubicación del archivo .bazelrc del usuario que contiene los valores predeterminados de las opciones de Bazel. /dev/null indica que se ignorarán todos los demás `--bazelrc`, lo que es útil para inhabilitar la búsqueda de un archivo RC del usuario, p.ej., en compilaciones de lanzamiento.
Esta opción también se puede especificar varias veces.
P.ej., con `--bazelrc=x.rc --bazelrc=y.rc --bazelrc=/dev/null --bazelrc=z.rc`,
1) se leen x.rc y y.rc.
2) z.rc se ignora debido a la existencia anterior de /dev/null.
Si no se especifica, Bazel usa el primer archivo .bazelrc que encuentra en las siguientes dos ubicaciones: el directorio del lugar de trabajo y, luego, el directorio principal del usuario.
Nota: Las opciones de la línea de comandos siempre sustituirán a cualquier opción en Bazelrc.
Etiquetas:changes_inputs
- El valor predeterminado de
--[no]block_for_lock
es "true" (verdadero). -
Cuando se pasa --noblock_for_lock, Bazel no espera a que se complete un comando en ejecución, sino que se cierra de inmediato.
Etiquetas:eagerness_to_exit
--[no]client_debug
valor predeterminado: "false"-
Si es verdadero, registra la información de depuración del cliente en stderr. El cambio de esta opción no provocará que el servidor se reinicie.
Etiquetas:affects_outputs
,bazel_monitoring
--connect_timeout_secs=<an integer>
predeterminado: "30"-
La cantidad de tiempo que el cliente espera cada intento de conectarse al servidor
Etiquetas:bazel_internal_configuration
- El valor predeterminado de
--[no]expand_configs_in_place
es "true" (verdadero). -
Se cambió la expansión de las marcas --config para que se realice de forma local, en lugar de en una expansión de puntos fijos entre las opciones de RC normales y las opciones especificadas de la línea de comandos.
Etiquetas:no_op
,deprecated
- Configuración predeterminada de
--failure_detail_out=<path>
: ver descripción -
Si se configura, especifica una ubicación para escribir un mensaje protobuf de failed_detail si el servidor experimenta una falla y no puede informarla a través de gRPC, como es habitual. De lo contrario, la ubicación será ${OUTPUT_BASE}/failure_detail.rawproto.
Etiquetas:affects_outputs
,loses_incremental_state
- El valor predeterminado de
--[no]home_rc
es "true" (verdadero). -
Si se debe buscar o no el archivo de bazelrc doméstico en $HOME/.bazelrc
Etiquetas:changes_inputs
- El valor predeterminado de
--[no]idle_server_tasks
es "true" (verdadero). -
Ejecuta System.gc() cuando el servidor esté inactivo
Etiquetas:loses_incremental_state
,host_machine_resource_optimizations
--[no]ignore_all_rc_files
valor predeterminado: "false"-
Inhabilita todos los archivos RC, sin importar los valores de otras marcas de modificación de RC, incluso si estas marcas aparecen más adelante en la lista de opciones de inicio.
Etiquetas:changes_inputs
--io_nice_level={-1,0,1,2,3,4,5,6,7}
valor predeterminado: "-1"-
Solo en Linux. Establece un nivel del 0 al 7 para la mejor programación de E/S de esfuerzo con la llamada del sistema sys_ioprio_set. 0 es la prioridad más alta, 7 es la menor. El programador anticipativo solo puede respetar hasta la prioridad 4. Si se establece en un valor negativo, Bazel no realiza una llamada al sistema.
Etiquetas:host_machine_resource_optimizations
--local_startup_timeout_secs=<an integer>
predeterminado: "120"-
La cantidad máxima de tiempo que el cliente espera para conectarse al servidor
Etiquetas:bazel_internal_configuration
--macos_qos_class=<a string>
valor predeterminado: "default"-
Establece la clase de servicio QoS del servidor de Bazel cuando se ejecuta en macOS. Esta marca no tiene efecto en todas las demás plataformas, pero es compatible para garantizar que los archivos RC se puedan compartir entre ellas sin cambios. Los valores posibles son: interactivo por el usuario, iniciado por el usuario, predeterminado, utilidad y segundo plano.
Etiquetas:host_machine_resource_optimizations
--max_idle_secs=<integer>
predeterminado: "10800"-
Es la cantidad de segundos que el servidor de compilación esperará inactivo antes de apagarse. Cero significa que el servidor nunca se apagará. Esto solo se lee cuando se inicia el servidor; cambiar esta opción no hará que el servidor se reinicie.
Etiquetas:eagerness_to_exit
,loses_incremental_state
- Configuración predeterminada de
--output_base=<path>
: ver descripción -
Si se configura, especifica la ubicación de salida en la que se escribirán todos los resultados de la compilación. De lo contrario, la ubicación será ${OUTPUT_ROOT}/_blaze_${USER}/${MD5_OF_WORKSPACE_ROOT}. Nota: Si especificas una opción diferente a la siguiente invocación de Bazel para este valor, es probable que inicies un nuevo servidor de Bazel adicional. Bazel inicia exactamente un servidor por base de salida especificada. Por lo general, hay una base de salida por lugar de trabajo. Sin embargo, con esta opción, puedes tener varias bases de salida por lugar de trabajo y, por lo tanto, ejecutar varias compilaciones para el mismo cliente en la misma máquina de forma simultánea. Consulta “Ayuda de Bazel para apagar” las instrucciones para apagar un servidor de Bazel.
Etiquetas:affects_outputs
,loses_incremental_state
- Configuración predeterminada de
--output_user_root=<path>
: ver descripción -
El directorio específico del usuario debajo del cual se escriben todos los resultados de compilación. De forma predeterminada, esta es una función de $USER. Sin embargo, si se especifica una constante, los resultados de compilación se pueden compartir entre los usuarios colaboradores.
Etiquetas:affects_outputs
,loses_incremental_state
--[no]preemptible
valor predeterminado: "false"-
Si es verdadero, el comando puede interrumpirse si se inicia otro.
Etiquetas:eagerness_to_exit
- Configuración predeterminada de
--server_jvm_out=<path>
: ver descripción -
Es la ubicación en la que se escribirá la salida de JVM del servidor. Si no se establece, se establece de forma predeterminada en una ubicación en output_base.
Etiquetas:affects_outputs
,loses_incremental_state
--[no]shutdown_on_low_sys_mem
valor predeterminado: "false"-
Si se establece max_idle_secs y el servidor de compilación ha estado inactivo durante un tiempo, apágalo cuando el sistema tenga poca memoria RAM libre. Solo en Linux.
Etiquetas:eagerness_to_exit
,loses_incremental_state
- El valor predeterminado de
--[no]system_rc
es "true" (verdadero). -
Indica si se debe buscar o no el Bazelrc en todo el sistema.
Etiquetas:changes_inputs
--[no]unlimit_coredumps
valor predeterminado: "false"-
Aumenta el límite de softdump de softdump al límite estricto para que, en condiciones comunes, sean posibles los coredump del servidor (incluida la JVM) y del cliente. Pega esta marca en tu Bazelrc una vez y olvídate de ella para obtener coredumps cuando encuentres una condición que los active.
Etiquetas:bazel_internal_configuration
--[no]watchfs
valor predeterminado: "false"-
Si es verdadero, Bazel intenta usar el servicio de supervisión de archivos del sistema operativo para realizar cambios locales en lugar de analizar todos los archivos en busca de cambios.
Etiquetas:deprecated
--[no]windows_enable_symlinks
valor predeterminado: "false"-
Si es verdadero, se crearán vínculos simbólicos reales en Windows en lugar de la copia de archivos. Requiere que esté habilitado el modo de desarrollador de Windows y Windows 10 versión 1703 o posterior.
Etiquetas:bazel_internal_configuration
- El valor predeterminado de
--[no]workspace_rc
es "true" (verdadero). -
Busca o no el archivo de bazelrc de Workspace en $workspace/.bazelrc
Etiquetas:changes_inputs
- Opciones varias, que no están categorizadas:
- Se acumulan
--host_jvm_args=<jvm_arg>
usos múltiples - Marcas para pasar a la JVM que ejecuta Blaze.
--host_jvm_debug
-
Es una opción conveniente para agregar algunas marcas de inicio de JVM adicionales, que hacen que la JVM espere durante el inicio hasta que te conectes desde un depurador compatible con JDWP (como Eclipse) al puerto 5005.
Se expande a:
--host_jvm_args=-Xdebug
--host_jvm_args=-Xrunjdwp:transport=dt_socket,server=y,address=5005
--host_jvm_profile=<profiler_name>
predeterminado: ""- Es una opción conveniente para agregar algunas marcas de inicio de JVM específicas del generador de perfiles o del depurador. Bazel tiene una lista de valores conocidos que asigna a marcas de inicio de JVM codificados, posiblemente, buscando algunas rutas codificadas para ciertos archivos.
--server_javabase=<jvm path>
predeterminado: ""- Ruta de acceso a la JVM que se usó para ejecutar Bazel.
Opciones comunes para todos los comandos
- Opciones que controlan la ejecución de la compilación:
--experimental_oom_more_eagerly_threshold=<an integer>
predeterminado: "100"-
Si esta marca se establece en un valor inferior a 100, Bazel quedará OOM 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 y stderr que se imprimirán en la consola. -1 implica que no hay límite.
Etiquetas:execution
- Opciones que configuran la cadena de herramientas usada para ejecutar la acción:
--[no]incompatible_enable_proto_toolchain_resolution
valor predeterminado: "false"-
Si es verdadero, las reglas de proto lang definen cadenas de herramientas a partir de repositorios de rules_proto, rules_java, rules_cc.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
- Se acumulan
--repo_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica variables de entorno adicionales que estarán disponibles solo para las reglas del repositorio. Ten en cuenta que las reglas del repositorio ven el entorno completo de todas formas, pero, de esta manera, la información de configuración se puede pasar a los repositorios a través de opciones sin invalidar el gráfico de acción.
Etiquetas:action_command_lines
- Opciones que afectan la medida en la que Bazel aplica de manera estricta entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
- El valor predeterminado de
--[no]check_bzl_visibility
es "true" (verdadero). - Si se inhabilita, los errores de visibilidad de carga .bzl descienden a advertencias.
Etiquetas:build_file_semantics
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE.:
--[no]enable_bzlmod
valor predeterminado: "false"-
Si es verdadero, se habilita el sistema de administración de dependencias Bzlmod, y tiene prioridad sobre WORKSPACE. Para obtener más información, consulta https://bazel.build/docs/bzlmod.
Etiquetas:loading_and_analysis
- El valor predeterminado de
--[no]experimental_action_resource_set
es "true" (verdadero). -
Si se configura como verdadera, ="{.actions.run() y ="{.actions.run_shell() aceptan un parámetro resource_set para la ejecución local. De lo contrario, el valor predeterminado será de 250 MB para la memoria y 1 CPU.
Etiquetas:execution
,build_file_semantics
,experimental
-
Si se configura como verdadera, las etiquetas se propagarán desde un destino a los requisitos de ejecución de las acciones; de lo contrario, las etiquetas no se propagarán. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/8830.
Etiquetas:build_file_semantics
,experimental
- El valor predeterminado de
--[no]experimental_analysis_test_call
es "true" (verdadero). -
Si se configura como verdadera, la llamada nativa analysis_test estará disponible.
Etiquetas:loading_and_analysis
,build_file_semantics
,experimental
- El valor predeterminado de
--[no]experimental_bzl_visibility
es "true" (verdadero). -
Si se habilita, se agrega una función `visibility()` a la que los archivos .bzl pueden llamar durante la evaluación de nivel superior para configurar su visibilidad con el fin de sentencias load().
Etiquetas:loading_and_analysis
,experimental
-
Si se configura como verdadera, los atributos de la regla y los métodos de la API de Starlark necesarios para la regla cc_shared_library estarán disponibles
Etiquetas:build_file_semantics
,loading_and_analysis
,experimental
--[no]experimental_disable_external_package
valor predeterminado: "false"-
Si se configura como verdadera, el paquete externo //generado automáticamente ya no estará disponible. Bazel aún no podrá analizar el archivo “external/BUILD”, pero los globs que lleguen a external/ desde el paquete sin nombre funcionarán.
Etiquetas:loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_enable_android_migration_apis
valor predeterminado: "false"-
Si se configura como verdadera, habilita las APIs necesarias para admitir la migración de Android Starlark.
Etiquetas:build_file_semantics
--[no]experimental_get_fixed_configured_action_env
valor predeterminado: "false"-
Si se habilita, action.env también mostrará variables de entorno fijas que se especifican a través de la configuración de funciones.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_google_legacy_api
valor predeterminado: "false"-
Si se establece como verdadera, se exponen algunas piezas experimentales de la API de compilación de Starlark relacionadas con el código heredado de Google.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_isolated_extension_usages
valor predeterminado: "false"-
Si es verdadero, habilita el parámetro <code>isolate</code> en la función <a href="https://bazel.build/rules/lib/globals/module#use_extension"><code>use_extension</code></a>.
Etiquetas:loading_and_analysis
- El valor predeterminado de
--[no]experimental_lazy_template_expansion
es "true" (verdadero). -
Si se configura como verdadero, ="{.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
valor predeterminado: "false"-
Si se configura como verdadera, se habilitan varias APIs de Starlark relacionadas con la plataforma que son útiles para la depuración.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repo_remote_exec
valor predeterminado: "false"-
Si se configura como true, Repositories_rule obtiene algunas capacidades de ejecución remota.
Etiquetas:build_file_semantics
,loading_and_analysis
,experimental
--[no]experimental_sibling_repository_layout
valor predeterminado: "false"-
Si se configura como true, los repositorios que no sean principales se plantan como symlinks al repositorio principal en la raíz de ejecución. Es decir, todos los repositorios son elementos secundarios directos del directorio $output_base/execution_root. Esto tiene el efecto secundario de liberar $output_base/execution_root/__main__/external para el directorio “external” de nivel superior real.
Etiquetas:action_command_lines
,bazel_internal_configuration
,loading_and_analysis
,loses_incremental_state
yexperimental
- El valor predeterminado de
--[no]incompatible_always_check_depset_elements
es "true" (verdadero). -
Verifica la validez de los elementos agregados a depsets, en todos los constructores. Los elementos deben ser inmutables, pero históricamente el constructor depset(direct=...) olvidó verificarlos. Usa tuplas en lugar de listas en los elementos depset. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/10313.
Etiquetas:build_file_semantics
,incompatible_change
- El valor predeterminado de
--[no]incompatible_depset_for_libraries_to_link_getter
es "true" (verdadero). -
Cuando el valor es verdadero, Bazel ya no muestra una lista de links_context.libraries_to_link y, en su lugar, muestra un depset.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_disable_objc_library_transition
valor predeterminado: "false"-
Inhabilitar la transición personalizada de objc_library y heredar contenido del objetivo de nivel superior
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_disable_starlark_host_transitions
valor predeterminado: "false"-
Si se establece como verdadera, los atributos de la regla no pueden establecer “cfg = “host”. En su lugar, se debe establecer “cfg = “exec”' en las reglas.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_disable_target_provider_fields
valor predeterminado: "false"-
Si se establece como verdadera, se inhabilita la capacidad de acceder a los proveedores en los objetos "de destino" mediante la sintaxis de campos. En su lugar, usa la sintaxis de clave de proveedor. Por ejemplo, en lugar de usar `="{.attr.dep.my_info` para acceder a `my_info` desde una función de implementación de reglas, usa `="{.attr.dep[MyInfo]`. Visita https://github.com/bazelbuild/bazel/issues/9014 para obtener más detalles.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_disallow_empty_glob
valor predeterminado: "false"-
Si se configura como true, el valor predeterminado del argumento `allow_empty` de glob() es False.
Etiquetas:build_file_semantics
,incompatible_change
- El valor predeterminado de
--[no]incompatible_disallow_legacy_javainfo
es "true" (verdadero). -
Obsoleto. No-ops
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_disallow_struct_provider_syntax
valor predeterminado: "false"-
Si se establece como verdadera, es posible que las funciones de implementación de reglas no muestren un struct. En su lugar, debe mostrar una lista de instancias del proveedor.
Etiquetas:build_file_semantics
,incompatible_change
- El valor predeterminado de
--[no]incompatible_enable_deprecated_label_apis
es "true" (verdadero). -
Si se habilita, se pueden usar ciertas APIs obsoletas (native.repository_name, Label.workspace_name, Label.relative).
Etiquetas:loading_and_analysis
- El valor predeterminado de
--[no]incompatible_existing_rules_immutable_view
es "true" (verdadero). -
Si se configura como true, native.existing_rule y native.existing_rules, se muestran objetos de vista inmutables ligeros en lugar de diccionarios mutables.
Etiquetas:build_file_semantics
,loading_and_analysis
,incompatible_change
--[no]incompatible_fail_on_unknown_attributes
valor predeterminado: "false"-
Si se habilita, fallan los destinos con atributos desconocidos configurados como "None".
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_fix_package_group_reporoot_syntax
es "true" (verdadero). -
En el atributo `packages` de package_group, cambia el significado del valor "//..." para hacer referencia a todos los paquetes en el repositorio actual en lugar de a todos los paquetes en cualquier repositorio. Puedes usar el valor especial "public" en lugar de "//..." para obtener el comportamiento anterior. Esta marca requiere que también se habilite la sintaxis --incompatible_package_group_has_public_syntax.
Etiquetas:build_file_semantics
,incompatible_change
- El valor predeterminado de
--[no]incompatible_java_common_parameters
es "true" (verdadero). -
Si se establece como verdadera, se quitarán los parámetros output_jar y host_javabase en pack_sources y host_javabase de compilación.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_merge_fixed_and_default_shell_env
valor predeterminado: "false"-
Si se habilita esta opción, las acciones registradas con ="{.actions.run y ="{.actions.run_shell con los valores 'env' y 'use_default_shell_env = True' especificados usarán un entorno obtenido del entorno de shell predeterminado anulando con los valores pasados a 'env'. Si está inhabilitada, el valor de “env” se ignora por completo en este caso.
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_new_actions_api
es "true" (verdadero). -
Si se configura como verdadera, la API para crear acciones solo está disponible en `="{.actions`, no en `="{`.
Etiquetas:build_file_semantics
,incompatible_change
- El valor predeterminado de
--[no]incompatible_no_attr_license
es "true" (verdadero). -
Si se configura como verdadera, se inhabilita la función `attr.license`.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_no_implicit_file_export
valor predeterminado: "false"-
Si se configura, los archivos de origen (usados) son privados en paquetes, a menos que se exporten de forma explícita. Consulta https://github.com/bazelbuild/proposals/blob/master/designs/2019-10-24-file-visibility.md
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_no_rule_outputs_param
valor predeterminado: "false"-
Si se configura como true, se inhabilita el parámetro `outputs` de la función `rule()`.
Etiquetas:build_file_semantics
,incompatible_change
- El valor predeterminado de
--[no]incompatible_package_group_has_public_syntax
es "true" (verdadero). -
En el atributo `packages` de package_group, permite escribir "public" o "private" para hacer referencia a todos los paquetes o a ninguno, respectivamente.
Etiquetas:build_file_semantics
,incompatible_change
- El valor predeterminado de
--[no]incompatible_require_linker_input_cc_api
es "true" (verdadero). -
Si se establece como verdadera, la regla create_linking_context requerirá linker_inputs en lugar de library_to_link. También se inhabilitarán los métodos get anteriores de links_context y solo estarán disponibles los linker_inputs.
Etiquetas:build_file_semantics
,loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_run_shell_command_string
es "true" (verdadero). -
Si se configura como true, el parámetro de comando de actions.run_shell solo aceptará la cadena
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_stop_exporting_language_modules
valor predeterminado: "false"-
Si se habilita, ciertos módulos específicos de lenguaje (como "cc_common") no están disponibles en los archivos .bzl del usuario y solo se los puede llamar desde sus respectivos repositorios de reglas.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_struct_has_no_methods
valor predeterminado: "false"-
Inhabilita los métodos to_json y to_proto de struct, que contaminan el espacio de nombres del campo de struct. En su lugar, usa json.encode o json.encode_indent para JSON, o proto.encode_text para textproto.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_top_level_aspects_require_providers
valor predeterminado: "false"-
Si se configura como verdadera, el aspecto de nivel superior respetará sus proveedores requeridos y solo se ejecutará en destinos de nivel superior cuyos proveedores promocionados de reglas satisfagan los proveedores requeridos del aspecto.
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_unambiguous_label_stringification
es "true" (verdadero). -
Cuando sea verdadero, Bazel vinculará la etiqueta @//foo:bar a @//foo:bar, en lugar de //foo:bar. Esto solo afecta el comportamiento de str(), el operador %, etc.; el comportamiento de repr() no se modifica. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/15916.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_use_cc_configure_from_rules_cc
valor predeterminado: "false"-
Cuando sea verdadero, Bazel ya no permitirá el uso de cc_configure desde @bazel_tools. Consulta https://github.com/bazelbuild/bazel/issues/10134 para obtener detalles y las instrucciones de migración.
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_visibility_private_attributes_at_definition
es "true" (verdadero). -
Si se configura como verdadera, se verifica la visibilidad de los atributos de la regla privada con respecto a la definición de la regla, y se recurre al uso de la regla si no es visible.
Etiquetas:build_file_semantics
,incompatible_change
--max_computation_steps=<a long integer>
predeterminado: "0"-
Es la cantidad máxima de pasos de cálculo de Starlark que puede ejecutar un archivo BUILD (cero significa que no hay límite).
Etiquetas:build_file_semantics
--nested_set_depth_limit=<an integer>
predeterminado: "3500"-
Es la profundidad máxima del gráfico interno de un depset (también conocido como NestedSet), por encima de la cual fallará el constructor depset().
Etiquetas:loading_and_analysis
- Opciones que activan optimizaciones del tiempo de compilación:
- El valor predeterminado de
--[no]incompatible_do_not_split_linking_cmdline
es "true" (verdadero). -
Cuando es verdadero, Bazel ya no modifica las marcas de línea de comandos que se usan para la vinculación y tampoco decide qué marcas van al archivo de parámetros y cuáles no. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/7670.
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]keep_state_after_build
es "true" (verdadero). -
Si es falso, Blaze descartará el estado de memoria de esta compilación cuando finalice. Las compilaciones posteriores no tendrán ninguna incrementalidad con respecto a esta.
Etiquetas:loses_incremental_state
--skyframe_high_water_mark_threshold=<an integer>
predeterminado: "85"-
Marca para la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que el uso del porcentaje retenido de montón está al menos en este umbral, descartará el estado temporal innecesario de Skyframe. Un ajuste puede permitirte mitigar el impacto de la hiperpaginación de la GC en el tiempo, cuando esta (i) causa el uso de memoria de este estado temporal y (ii) es más costosa que reconstruir el estado cuando es necesario.
Etiquetas:host_machine_resource_optimizations
- El valor predeterminado de
--[no]track_incremental_state
es "true" (verdadero). -
Si es falso, Blaze no conservará datos que permitan la invalidación y la reevaluación en compilaciones incrementales para ahorrar memoria en esta compilación. Las compilaciones posteriores no tendrán ninguna incrementalidad con respecto a esta. Por lo general, es posible que desees especificar --batch cuando configuras esto como falso.
Etiquetas:loses_incremental_state
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]announce_rc
valor predeterminado: "false"-
Indica si se deben anunciar las opciones de RCS.
Etiquetas:affects_outputs
--[no]attempt_to_print_relative_paths
valor predeterminado: "false"-
Cuando imprimas la parte de la ubicación de los mensajes, intenta usar una ruta de acceso relativa al directorio del lugar de trabajo o a uno de los directorios especificados por --package_path.
Etiquetas:terminal_output
--bes_backend=<a string>
predeterminado: ""-
Especifica el extremo de backend del servicio de eventos de compilación (BES) en el formato [SCHEME://]HOST[:PORT]. La opción predeterminada es inhabilitar las cargas de BES. Los esquemas admitidos son grpc y grpcs (grpc con TLS habilitada). Si no se proporciona un esquema, Bazel asume que es grpcs.
Etiquetas:affects_outputs
--[no]bes_check_preceding_lifecycle_events
valor predeterminado: "false"-
Establece el campo check_preceding_lifecycle_events_present en PublishBuildToolEventStreamRequest, que le indica a BES que verifique si anteriormente recibió eventos InvocationRetryStarted y BuildEnqueue que coinciden con el evento actual de la herramienta.
Etiquetas:affects_outputs
- Se acumulan
--bes_header=<a 'name=value' assignment>
usos múltiples -
Especifica un encabezado en el formulario NAME=VALUE que se incluirá en las solicitudes de BES. Se pueden pasar varios encabezados si se especifica la marca varias veces. Si hay varios valores con el mismo nombre, se convertirán en una lista separada por comas.
Etiquetas:affects_outputs
- Configuración predeterminada de
--bes_instance_name=<a string>
: ver descripción -
Especifica el nombre de la instancia en la que el BES conservará el BEP subido. El valor predeterminado es nulo.
Etiquetas:affects_outputs
- Se acumulan
--bes_keywords=<comma-separated list of options>
usos múltiples -
Especifica una lista de palabras clave de notificación que deben agregarse al conjunto predeterminado de palabras clave publicadas en BES ("command_name=<command_name> ", "protocol_name=BEP"). La configuración predeterminada es Ninguna.
Etiquetas:affects_outputs
- El valor predeterminado de
--[no]bes_lifecycle_events
es "true" (verdadero). -
Especifica si se publican eventos de ciclo de vida de BES. (el valor predeterminado es "true").
Etiquetas:affects_outputs
--bes_oom_finish_upload_timeout=<An immutable length of time.>
predeterminado: "10m"-
Especifica cuánto tiempo debe esperar Bazel para que se complete la carga de BES/BEP mientras se realiza la OOM. Esta marca garantiza la finalización cuando la JVM tiene una hiperpaginación excesiva de GC y no puede progresar en ningún subproceso del usuario.
Etiquetas:bazel_monitoring
--bes_outerr_buffer_size=<an integer>
predeterminado: "10240"-
Especifica el tamaño máximo de stdout o stderr que se almacenará en búfer en BEP antes de que se informe como un evento de progreso. Las escrituras individuales se informan en un solo evento, incluso si son mayores que el valor especificado hasta (--bes_outerr_chunk_size).
Etiquetas:affects_outputs
--bes_outerr_chunk_size=<an integer>
predeterminado: "1048576"-
Especifica el tamaño máximo de stdout o stderr que se enviará a BEP en un solo mensaje.
Etiquetas:affects_outputs
- Configuración predeterminada de
--bes_proxy=<a string>
: ver descripción - Conéctate al servicio de eventos de compilación a través de un proxy. Actualmente, esta marca solo se puede usar para configurar un socket de dominio Unix (unix:/path/to/socket).
--bes_results_url=<a string>
predeterminado: ""-
Especifica la URL base en la que un usuario puede ver la información que se transmite al backend de BES. Bazel enviará a la terminal la URL que agregó el ID de invocación.
Etiquetas:terminal_output
- Valor predeterminado de
--bes_timeout=<An immutable length of time.>
: "0 s" -
Especifica cuánto tiempo debe esperar Bazel para que se complete la carga de BES/BEP después de que finalicen la compilación y las pruebas. Un tiempo de espera válido es un número natural seguido de una unidad: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). El valor predeterminado es “0”, lo que significa que no hay tiempo de espera.
Etiquetas:affects_outputs
--build_event_binary_file=<a string>
predeterminado: ""-
Si no está vacío, escribe una representación binaria delimitada por varint de representación del protocolo de eventos de compilación en ese archivo. Esta opción implica --bes_upload_mode=wait_for_upload_complete.
Etiquetas:affects_outputs
- El valor predeterminado de
--[no]build_event_binary_file_path_conversion
es "true" (verdadero). -
Convierte las rutas de acceso de la representación de archivo binario del protocolo de eventos de compilación en URIs más válidos a nivel global siempre que sea posible. Si se inhabilita, siempre se usará el esquema file:// uri
Tags:affects_outputs
--build_event_json_file=<a string>
predeterminado: ""-
Si no está vacío, escribe una serialización JSON del protocolo de eventos de compilación en ese archivo.
Etiquetas:affects_outputs
- El valor predeterminado de
--[no]build_event_json_file_path_conversion
es "true" (verdadero). -
Convierte las rutas de acceso de la representación del archivo JSON del protocolo de eventos de compilación en URIs más válidos a nivel global siempre que sea posible. Si se inhabilita, siempre se usará el esquema file:// uri
Tags:affects_outputs
--build_event_max_named_set_of_file_entries=<an integer>
valor predeterminado: "-1"-
Es la cantidad máxima de entradas para un solo evento names_set_of_files. Se ignoran los valores menores que 2 y no se realiza ninguna división de eventos. Está diseñado para limitar el tamaño máximo del evento en el protocolo de eventos de compilación, aunque no controla el tamaño del evento de forma directa. El tamaño total del evento es una función de la estructura del conjunto, así como las longitudes del archivo y del URI, que, a su vez, pueden depender de la función hash.
Etiquetas:affects_outputs
--[no]build_event_publish_all_actions
valor predeterminado: "false"-
Determina si se deben publicar todas las acciones.
Etiquetas:affects_outputs
--build_event_text_file=<a string>
predeterminado: ""-
Si no está vacío, escribe una representación textual del protocolo de eventos de compilación en ese archivo
Etiquetas:affects_outputs
- El valor predeterminado de
--[no]build_event_text_file_path_conversion
es "true" (verdadero). -
Convierte las rutas de acceso de la representación de archivo de texto del protocolo de eventos de compilación en URIs más válidos a nivel global siempre que sea posible. Si se inhabilita, siempre se usará el esquema file:// uri
Tags:affects_outputs
--[no]experimental_announce_profile_path
valor predeterminado: "false"-
Si se habilita, agrega la ruta de acceso del perfil JSON al registro.
Etiquetas:affects_outputs
,bazel_monitoring
--[no]experimental_bep_target_summary
valor predeterminado: "false"- Determina si se publican eventos de TargetSummary.
--[no]experimental_build_event_expand_filesets
valor predeterminado: "false"-
Si es verdadero, expande los conjuntos de archivos en el BEP cuando presentes los archivos de salida.
Etiquetas:affects_outputs
--[no]experimental_build_event_fully_resolve_fileset_symlinks
valor predeterminado: "false"-
Si es verdadero, resuelve por completo los symlinks del conjunto de archivos relativos en el BEP cuando se presentan los archivos de salida. Requiere --experimental_build_event_expand_filesets.
Etiquetas:affects_outputs
--experimental_build_event_upload_max_retries=<an integer>
predeterminado: "4"-
Es la cantidad máxima de veces que Bazel debe reintentar subir un evento de compilación.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
: "1 s" -
Retraso inicial y mínimo para los reintentos de retirada exponencial cuando falla la carga de BEP (exponente: 1.6)
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--experimental_build_event_upload_strategy=<a string>
: ver descripción -
Selecciona cómo subir los artefactos a los que se hace referencia en el protocolo de eventos de compilación.
Etiquetas:affects_outputs
- Se acumulan
--experimental_profile_additional_tasks=<phase, action, action_check, action_lock, action_release, action_update, action_complete, bzlmod, info, create_package, remote_execution, local_execution, scanner, local_parse, upload_time, 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>
usos múltiples -
Especifica las tareas adicionales que se incluirán en el perfil.
Etiquetas:affects_outputs
,bazel_monitoring
--[no]experimental_profile_include_primary_output
valor predeterminado: "false"-
Incluye el atributo "out" adicional en los eventos de acción que contiene la ruta de ejecución al resultado principal de la acción.
Etiquetas:affects_outputs
,bazel_monitoring
--[no]experimental_profile_include_target_label
valor predeterminado: "false"-
Incluye la etiqueta de destino en los datos de perfil JSON de los eventos de acción.
Etiquetas:affects_outputs
,bazel_monitoring
--[no]experimental_stream_log_file_uploads
valor predeterminado: "false"-
Transmite las cargas de archivos de registro directamente al almacenamiento remoto en lugar de escribirlos en el disco.
Etiquetas:affects_outputs
- Configuración predeterminada de
--experimental_workspace_rules_log_file=<a path>
: ver descripción - Registra ciertos eventos de reglas de Workspace en este archivo como protos WorkspaceEvent delimitados.
- Valor predeterminado de
--[no]generate_json_trace_profile
: "auto" -
Si se habilita, Bazel genera perfiles de la compilación y escribe un perfil en formato JSON en un archivo en la base de salida. Para ver el perfil, carga el archivo en chrome://tracing. De forma predeterminada, Bazel escribe el perfil para todos los comandos y las consultas similares a las de compilación.
Etiquetas:affects_outputs
,bazel_monitoring
--[no]heap_dump_on_oom
valor predeterminado: "false"-
Determina si se debe generar manualmente un volcado de montón si se arroja 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 forma efectiva -XX:+HeapDumpOnOutOfMemoryError, que no tiene ningún efecto porque las OOM se capturan y redireccionan a Runtime#halt.
Etiquetas:bazel_monitoring
- El valor predeterminado de
--[no]legacy_important_outputs
es "true" (verdadero). -
Usa esta opción para suprimir la generación del campo relevant_outputs heredado en el evento TargetComplete. Para la integración de Bazel a ResultStore, se requiere relevant_outputs.
Etiquetas:affects_outputs
--logging=<0 <= an integer <= 6>
predeterminado: "3"- El nivel de registro
Etiquetas:affects_outputs
- Configuración predeterminada de
--memory_profile=<a path>
: ver descripción -
Si se establece esta opción, escribe los datos de uso de memoria en el archivo especificado al finalizar la fase y el montón estable en el registro principal al final de la compilación.
Etiquetas:affects_outputs
,bazel_monitoring
--memory_profile_stable_heap_parameters=<integers, separated by a comma expected in pairs>
predeterminado: "1,0"- Ajusta el cálculo del perfil de memoria del montón estable al final de la compilación. Deben ser números pares y deben estar separados por comas. En cada par, el primer número entero es la cantidad de GC que se realizarán. El segundo número entero de cada par es la cantidad de segundos que se debe esperar entre las GC. P. ej.: 2,4,4,0 usaría 2 GC con una pausa de 4 segundos, seguidas de 4 GC con pausa de cero segundos.
Etiquetas:bazel_monitoring
- Configuración predeterminada de
--profile=<a path>
: ver descripción -
Si se configura, genera perfiles de Bazel y escribe datos en el archivo especificado. Usa el analizador de perfiles de Bazel para analizarlo.
Etiquetas:affects_outputs
,bazel_monitoring
- El valor predeterminado de
--[no]slim_profile
es "true" (verdadero). -
Reduce el tamaño del perfil JSON combinando eventos si el perfil se vuelve demasiado grande.
Etiquetas:affects_outputs
,bazel_monitoring
--starlark_cpu_profile=<a string>
predeterminado: ""-
Escribe en el archivo especificado un perfil de pprof del uso de CPU de todos los subprocesos de Starlark.
Etiquetas:bazel_monitoring
--tool_tag=<a string>
predeterminado: ""-
Es un nombre de herramienta al que se atribuirá esta invocación de Bazel.
Etiquetas:affects_outputs
,bazel_monitoring
- Se acumulan
--ui_event_filters=<Convert list of comma separated event kind to list of filters>
usos múltiples -
Especifica qué eventos se mostrarán en la IU. Puedes agregar o quitar eventos a los predeterminados usando el signo +/- inicial, o bien anular el valor predeterminado por completo con la asignación directa. El conjunto de tipos de eventos admitidos incluye INFO, DEBUG, ERROR y muchos más.
Etiquetas:terminal_output
- Opciones varias, que no están categorizadas:
- Se acumulan
--build_metadata=<a 'name=value' assignment>
usos múltiples -
Pares de cadenas clave-valor personalizados para proporcionar en un evento de compilación
Etiquetas:terminal_output
- Valor predeterminado de
--color=<yes, no or auto>
: "auto" - Usa los controles de la terminal para colorear el resultado.
- Se acumulan
--config=<a string>
usos múltiples - Selecciona secciones de configuración adicionales de los archivos rc; para cada <command>, también extrae las opciones de <command>:<config> si existe esa sección; si esta sección no existe en ningún archivo .rc, Blaze falla con un error. Las secciones de configuración y las combinaciones de marcas a las que son equivalentes se encuentran en los archivos de configuración de tools/*.blazerc.
- Se acumulan
--credential_helper=<Path to a credential helper. It may be absolute, relative to the PATH environment variable, or %workspace%-relative. The path be optionally prefixed by a scope followed by an '='. The scope is a domain name, optionally with a single leading '*' wildcard component. A helper applies to URIs matching its scope, with more specific scopes preferred. If a helper has no scope, it applies to every URI.>
usos múltiples - Configura un auxiliar de credenciales que se usará para recuperar credenciales de autorización de recuperación de repositorios, almacenamiento en caché y ejecución remotos, y el servicio de eventos de compilación. Las credenciales que proporciona un asistente tienen prioridad sobre las que suministran --google_default_credentials, --google_credentials, un archivo .netrc o el parámetro auth a inicio_cat. Se puede especificar varias veces para configurar varios asistentes. Para obtener más información, consulta https://github.com/bazelbuild/proposals/blob/main/designs/2022-06-07-bazel-credential-helpers.md.
--credential_helper_cache_duration=<An immutable length of time.>
predeterminado: "30m"- Es el tiempo durante el cual se almacenan en caché las credenciales que proporciona un auxiliar de credenciales. Si 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.
- Valor predeterminado de
--credential_helper_timeout=<An immutable length of time.>
: "10 s" - Configura el tiempo de espera para un auxiliar de credenciales. Los auxiliares de credenciales que no respondan dentro de este tiempo de espera fallarán la invocación.
- Valor predeterminado de
--curses=<yes, no or auto>
: "auto" - Usa los controles del cursor de la terminal para minimizar el resultado del desplazamiento.
--[no]enable_platform_specific_config
valor predeterminado: "false"- Si es verdadero, Bazel recoge líneas de configuración específicas del SO del host de los archivos de bazelrc. Por ejemplo, si el SO del host es Linux y ejecutas la compilación de Bazel, Bazel detecta las líneas que comienzan con build:linux. Los identificadores de SO compatibles son linux, macos, windows, freebsd y openbsd. Habilitar esta marca equivale a usar --config=linux en Linux, --config=windows en Windows, etcétera.
--[no]experimental_skymeld_ui
valor predeterminado: "false"-
Muestra el progreso de la fase de análisis y de ejecución cuando ambas se ejecutan al mismo tiempo.
Etiquetas:terminal_output
--[no]experimental_windows_watchfs
valor predeterminado: "false"- Si es verdadero, se habilitará la compatibilidad experimental de Windows con --watchfs. De lo contrario, --watchfsis no funciona en Windows. Asegúrate de habilitar también --watchfs.
- El valor predeterminado de
--google_auth_scopes=<comma-separated list of options>
es "https://www.googleapis.com/auth/cloud-platform" - Una lista separada por comas de los permisos de autenticación de Google Cloud.
- Configuración predeterminada de
--google_credentials=<a string>
: ver descripción - Especifica el archivo del que se obtendrán credenciales de autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más detalles.
--[no]google_default_credentials
valor predeterminado: "false"- Indica si se deben usar las “Credenciales predeterminadas de la aplicación de Google” para la autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más detalles. Están inhabilitados de forma predeterminada.
- Configuración predeterminada de
--grpc_keepalive_time=<An immutable length of time.>
: ver descripción - Configura pings de keep-alive para las conexiones de gRPC salientes. Si se establece, Bazel envía pings después de este período sin operaciones de lectura en la conexión, pero solo si hay al menos una llamada de gRPC pendiente. Los horarios se consideran de segundo nivel de detalle; es un error establecer un valor inferior a un segundo. De forma predeterminada, los pings de keep-alive están inhabilitados. Debes coordinar con el propietario del servicio antes de habilitar este parámetro de configuración. Por ejemplo, para establecer un valor de 30 segundos para esta marca, debe hacerse de esta manera: --grpc_keepalive_time=30s.
- Valor predeterminado de
--grpc_keepalive_timeout=<An immutable length of time.>
: "20 s" - Configura un tiempo de espera de keep-alive para las conexiones de gRPC salientes. Si los pings keep-alive están habilitados con --grpc_keepalive_time, Bazel agota el tiempo de espera de una conexión si no recibe una respuesta de ping después de este tiempo. Los horarios se consideran de segundo nivel de detalle; es un error establecer un valor inferior a un segundo. Si los pings de keep-alive están inhabilitados, se ignora esta configuración.
- El valor predeterminado de
--[no]incompatible_disallow_symlink_file_to_dir
es "true" (verdadero). -
Si se configura como verdadera, `="{.actions.symlink` no permitirá la symlink de un archivo a un directorio.
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_remove_rule_name_parameter
es "true" (verdadero). -
Si se configura como verdadera, no se puede llamar a la “regla” con el parámetro “nombre”.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]progress_in_terminal_title
valor predeterminado: "false"- Muestra el progreso del comando en el título de la terminal. Es útil para ver qué hace Bazel cuando hay varias pestañas de terminal.
- El valor predeterminado de
--[no]show_progress
es "true" (verdadero). - Muestra mensajes de progreso durante una compilación.
--show_progress_rate_limit=<a double>
predeterminado: "0.2"- Cantidad mínima de segundos entre los mensajes de progreso del resultado.
--[no]show_timestamps
valor predeterminado: "false"- Incluir marcas de tiempo en los mensajes
- Configuración predeterminada de
--tls_certificate=<a string>
: ver descripción - Especifica una ruta de acceso a un certificado TLS que sea confiable para firmar certificados de servidor.
- Configuración predeterminada de
--tls_client_certificate=<a string>
: ver descripción - Especifica el certificado de cliente TLS que se usará; también debes proporcionar una clave de cliente para habilitar la autenticación de cliente.
- Configuración predeterminada de
--tls_client_key=<a string>
: ver descripción - Especifica la clave de cliente TLS que se usará; también debes proporcionar un certificado de cliente para habilitar la autenticación de cliente.
--ui_actions_shown=<an integer>
predeterminado: "8"-
Cantidad de acciones simultáneas que se muestran en la barra de progreso detallada; cada acción se muestra en una línea separada. La barra de progreso siempre muestra al menos uno, y todos los números menores que 1 se asignan a 1.
Etiquetas:terminal_output
--[no]watchfs
valor predeterminado: "false"- En Linux o macOS: Si es verdadero, Bazel intenta usar el servicio de supervisión de archivos del sistema operativo para realizar cambios locales en lugar de analizar todos los archivos en busca de un cambio. En Windows: esta marca actualmente no es operativa, pero se puede habilitar junto con --experimental_windows_watchfs. En cualquier SO: El comportamiento no está definido si tu lugar de trabajo está en un sistema de archivos de red y los archivos se editan en una máquina remota.
Opciones del perfil de análisis
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Más lugares donde buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
valor predeterminado: "false"-
Si se configura, la caché del repositorio vinculará el archivo de forma fija en caso de un acierto de caché, en lugar de copiar. Esto sirve para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
valor predeterminado: "false"-
Si es verdadero, usa una string derivada de las URLs de descargas del repositorio como canonical_id si no se especifica. Esto provoca que un cambio en las URLs genere una nueva descarga incluso si la caché contiene una descarga con el mismo hash. Se puede usar para verificar que los cambios en la URL no den como resultado que la caché oculte los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
valor predeterminado: "false"-
Si se configura, no se permite la descarga de repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Usa este factor para escalar todos los tiempos de espera en las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que sean más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación en caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una string vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que afectan la medida en la que Bazel aplica de manera estricta las 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 hashes del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan
--experimental_verify_repository_rules=<a string>
usos múltiples -
Si es una lista de reglas de repositorio para las que se debe verificar el hash del directorio de salida, siempre que un archivo se especifique mediante --experimental_repository_hash_file.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE.:
- El valor predeterminado de
--[no]experimental_allow_top_level_aspects_parameters
es "true" (verdadero). -
No-op
Etiquetas:no_op
,deprecated
,experimental
- Opciones relacionadas con la semántica y el resultado de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Especificaste las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirá en el gráfico de dependencias resueltas incluso si se declararon de forma privada en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones anteriores harán que la resolución falle. También puedes definir la versión transferida permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
- El valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
es "error" -
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son “error” para derivarlo a una falla de resolución, “off” para inhabilitar la verificación o “warning” para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas `bazel_dep` declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son “off” para inhabilitar la verificación, “warning” para imprimir una advertencia cuando se detecte una discrepancia o “error” para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
valor predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- El valor predeterminado de
--lockfile_mode=<off, update or error>
es "desactivado" -
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son “update” para usar el archivo de bloqueo y actualizarlo si hay cambios; “error” para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o “off” para no leerlo ni escribirlo en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y se recurrirá únicamente a los posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--dump=<text or raw>
[-d
] (valor predeterminado): ver descripción- genera el volcado de datos del perfil completo en formato de “texto” legible o en formato “sin procesar” compatible con secuencias de comandos.
Etiquetas:affects_outputs
--[no]experimental_record_metrics_for_all_mnemonics
valor predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán estadísticas para todos los mnemotécnicos.
- Opciones que especifican o alteran una entrada genérica a un comando de Bazel que no pertenece a otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remoto:
- Configuración predeterminada de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo para configurar el cargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno con el que debe coincidir y otro para usar como URL sustitutiva, con referencias inversas que comienzan con "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL, y se mostrarán varias URL.
- Opciones varias, que no están categorizadas:
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
Opciones de Aquery
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Más lugares donde buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
valor predeterminado: "false"-
Si se configura, la caché del repositorio vinculará el archivo de forma fija en caso de un acierto de caché, en lugar de copiar. Esto sirve para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
valor predeterminado: "false"-
Si es verdadero, usa una string derivada de las URLs de descargas del repositorio como canonical_id si no se especifica. Esto provoca que un cambio en las URLs genere una nueva descarga incluso si la caché contiene una descarga con el mismo hash. Se puede usar para verificar que los cambios en la URL no den como resultado que la caché oculte los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
valor predeterminado: "false"-
Si se configura, no se permite la descarga de repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Usa este factor para escalar todos los tiempos de espera en las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que sean más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación en caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una string vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que afectan la medida en la que Bazel aplica de manera estricta las 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 hashes del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan
--experimental_verify_repository_rules=<a string>
usos múltiples -
Si es una lista de reglas de repositorio para las que se debe verificar el hash del directorio de salida, siempre que un archivo se especifique mediante --experimental_repository_hash_file.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE.:
- El valor predeterminado de
--[no]experimental_allow_top_level_aspects_parameters
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,deprecated
,experimental
- Opciones relacionadas con el resultado y la semántica de la consulta:
- El valor predeterminado de
--aspect_deps=<off, conservative or precise>
es "conservador". -
Cómo resolver dependencias de aspecto cuando el formato de salida es {xml,proto,record}. “desactivado” significa que no se resuelven las dependencias de aspecto, “conservadora” (el valor predeterminado) significa que se agregan todas las dependencias de aspecto declaradas sin importar si se les otorga la clase de regla de las dependencias directas. “preciso” significa que solo se agregan esos aspectos que posiblemente estén activos dada la clase de regla de las dependencias directas. Ten en cuenta que el modo preciso requiere cargar otros paquetes para evaluar un solo objetivo, por lo que es más lento que los otros modos. Además, ten en cuenta que incluso el modo preciso no es del todo preciso: la decisión de calcular un aspecto se decide en la fase de análisis, que no se ejecuta durante la “consulta de Bazel”.
Etiquetas:build_file_semantics
--[no]consistent_labels
valor predeterminado: "false"-
Si se habilita, cada comando de consulta emite etiquetas como si lo hiciera la función <code>str</code> de Starlark aplicada a una instancia de <code>etiqueta</code>. Esto es útil para las herramientas que necesitan hacer coincidir el resultado de diferentes comandos de consulta o etiquetas emitidas por reglas. Si no están habilitados, los formateadores de salida tienen la libertad de emitir nombres de repositorio aparentes (en relación con el repositorio principal) para que los resultados sean más legibles.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]deduplicate_depsets
es "true" (verdadero). -
Anula el duplicado de los elementos secundarios que no sean de hoja de un dep_set_of_files en el resultado final de proto/textproto/json. De esta manera, no se anulan las configuraciones duplicadas que no comparten un elemento superior inmediato. Esto no afecta la lista final efectiva de artefactos de entrada de las acciones.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]graph:factored
es "true" (verdadero). -
Si es "true", el gráfico se emitirá "factorizado", es decir, los nodos equivalentes topológicamente se combinarán y sus etiquetas se concatenarán. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--graph:node_limit=<an integer>
predeterminado: "512"-
La longitud máxima de la string de etiqueta para un nodo del gráfico en el resultado. Las etiquetas más largas se truncarán; -1 significa que no hay truncamiento. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]implicit_deps
es "true" (verdadero). -
Si se habilita, las dependencias implícitas se incluirán en el gráfico de dependencias en el que opera la consulta. Una dependencia implícita es aquella que no se especifica de forma explícita en el archivo BUILD, sino que Bazel la agrega. En el caso de cquery, esta opción controla el filtrado de cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
- El valor predeterminado de
--[no]include_artifacts
es "true" (verdadero). -
Incluye los nombres de las entradas y salidas de acción en la salida (posiblemente grande).
Etiquetas:terminal_output
- El valor predeterminado de
--[no]include_aspects
es "true" (verdadero). -
aquery, cquery: si se deben incluir acciones generadas por el aspecto en el resultado. query: no-op (siempre se siguen los aspectos).
Etiquetas:terminal_output
- El valor predeterminado de
--[no]include_commandline
es "true" (verdadero). -
Incluye el contenido de las líneas de comandos de acción en el resultado (posiblemente grande).
Etiquetas:terminal_output
--[no]include_file_write_contents
valor predeterminado: "false"-
Incluye el contenido del archivo para las acciones FileWrite y SourceSymlinkManifest (posiblemente grandes).
Etiquetas:terminal_output
--[no]include_param_files
valor predeterminado: "false"-
Incluye el contenido de los archivos de parámetros que se usaron en el comando (posiblemente grandes). Nota: Habilitar esta marca habilitará automáticamente la marca --include_commandline.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]incompatible_display_source_file_location
es "true" (verdadero). -
De forma predeterminada, 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 fines de migración.
Etiquetas:terminal_output
,incompatible_change
- El valor predeterminado de
--[no]incompatible_package_group_includes_double_slash
es "true" (verdadero). -
Si se habilita, cuando se genere el atributo `packages` de package_group, no se omitirá el signo `//` inicial.
Etiquetas:terminal_output
,incompatible_change
--[no]infer_universe_scope
valor predeterminado: "false"-
Si se configura y --universe_scope no se establece, se inferirá un valor de --universe_scope como la lista de patrones de objetivo únicos en la expresión de consulta. Ten en cuenta que el valor de --universe_scope que se infiere para una expresión de consulta que utiliza funciones con alcance universal (p.ej., `allrdeps`) puede no ser lo que quieres, por lo que solo debes usar esta opción si sabes lo que estás haciendo. Consulta https://bazel.build/reference/query#sky-query para obtener detalles y ejemplos. Si se configura --universe_scope, se ignora el valor de esta opción. Nota: Esta opción solo se aplica a “consulta” (es decir, no a “cquery”).
Etiquetas:loading_and_analysis
--[no]line_terminator_null
valor predeterminado: "false"-
Indica si cada formato termina con \0 en lugar de una línea nueva.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]nodep_deps
es "true" (verdadero). -
Si se habilita, las dependencias de los atributos “nodep” se incluirán en el gráfico de dependencias en el que opera la consulta. Un ejemplo común de un atributo “nodep” es la “visibilidad”. Ejecuta y analiza el resultado de `info build-language` para conocer todos los atributos “nodep” en el lenguaje de compilación.
Etiquetas:build_file_semantics
--output=<a string>
predeterminado: "text"-
Formato en el que se deben imprimir los resultados de una consulta. Los valores permitidos para una consulta son los siguientes: text, textproto, proto, jsonproto.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]proto:default_values
es "true" (verdadero). -
Si el valor es "true", se incluyen los atributos cuyo valor no se especifica de forma explícita en el archivo BUILD. De lo contrario, se omiten. Esta opción se aplica a --output=proto
Etiquetas:terminal_output
--[no]proto:definition_stack
valor predeterminado: "false"-
Propaga el campo proto define_stack que registra, para cada instancia de regla, la pila de llamadas de Starlark en el momento en que se definió la clase de la regla.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]proto:flatten_selects
es "true" (verdadero). -
Si se habilita, se compactan los atributos configurables creados por select(). Para los tipos de lista, la representación plana es una lista que contiene cada valor del mapa de selección exactamente una vez. Los tipos escalares se acoplan a nulos.
Etiquetas:build_file_semantics
--[no]proto:include_synthetic_attribute_hash
valor predeterminado: "false"-
Indica si se debe calcular y propagar el atributo $internal_attr_hash o no.
Etiquetas:terminal_output
--[no]proto:instantiation_stack
valor predeterminado: "false"-
Propaga la pila de llamadas de creación de instancias de cada regla. Ten en cuenta que esto requiere que la pila esté presente
Etiquetas:terminal_output
- El valor predeterminado de
--[no]proto:locations
es "true" (verdadero). - Indica si se debe generar información de ubicación en el resultado de proto.
Etiquetas:terminal_output
- La configuración predeterminada de
--proto:output_rule_attrs=<comma-separated list of options>
es "todos" -
Lista de atributos separados por comas para incluir en el resultado. La configuración predeterminada es todos los atributos. Se establece como una cadena vacía para no generar ningún atributo. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]proto:rule_inputs_and_outputs
es "true" (verdadero). -
Indica si se deben propagar los campos rule_input y rule_output o no.
Etiquetas:terminal_output
--query_file=<a string>
predeterminado: ""-
Si se configura, la consulta leerá la consulta desde el archivo que se menciona aquí, en lugar de hacerlo desde la línea de comandos. Es un error especificar un archivo aquí, así como una consulta de línea de comandos.
Etiquetas:changes_inputs
--[no]relative_locations
valor predeterminado: "false"-
Si es "true", la ubicación de los archivos BUILD en los resultados xml y proto será relativa. De forma predeterminada, el resultado de la ubicación es una ruta de acceso absoluta y no será coherente en todas las máquinas. Puedes configurar esta opción como verdadera para obtener un resultado coherente en todas las máquinas.
Etiquetas:terminal_output
--[no]skyframe_state
valor predeterminado: "false"-
Sin realizar un análisis adicional, vuelca el Action Graph actual de Skyframe. Nota: Actualmente, no se admite especificar un destino con --skyframe_state. Esta marca solo está disponible con --output=proto o --output=textproto.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]tool_deps
es "true" (verdadero). -
Consulta: Si se inhabilita, las dependencias de los objetivos de “configuración del host” o “ejecución” no se incluirán en el gráfico de dependencias en el que opera la consulta. Un perímetro de dependencia de 'host configuration', como el de cualquier regla 'proto_library' al compilador de protocolos, generalmente apunta a una herramienta ejecutada durante la compilación en lugar de a una parte del mismo programa 'target'.
Cquery: Si se inhabilita, filtra todos los destinos configurados que cruzan un host o una transición de ejecución del objetivo de nivel superior que descubrió este objetivo configurado. Esto significa que si el objetivo de nivel superior está en la configuración de destino, solo se mostrarán los objetivos configurados también en esa configuración. Si el objetivo de nivel superior se encuentra en la configuración del host, solo se mostrarán los destinos configurados de host. Esta opción NO excluirá las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
--universe_scope=<comma-separated list of options>
predeterminado: ""-
Un conjunto de patrones de objetivo separados por comas (aditivos y sustractivos). La consulta se puede realizar en el universo definido por el cierre transitivo de los destinos especificados. Esta opción se usa para los comandos query y cquery.
Para cquery, la entrada a esta opción son los destinos en los que se compilan todas las respuestas, por lo que esta opción puede afectar las configuraciones y las transiciones. Si no se especifica esta opción, se supone que los destinos de nivel superior son los destinos analizados a partir de la expresión de consulta. Nota: En el caso de cquery, no especificar esta opción puede provocar que la compilación falle si los objetivos analizados a partir de la expresión de consulta no se pueden compilar con opciones de nivel superior.
Etiquetas:loading_and_analysis
- Opciones relacionadas con la semántica y el resultado de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Especificaste las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirá en el gráfico de dependencias resueltas incluso si se declararon de forma privada en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones anteriores harán que la resolución falle. También puedes definir la versión transferida permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
- El valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
es "error" -
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son “error” para derivarlo a una falla de resolución, “off” para inhabilitar la verificación o “warning” para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas `bazel_dep` declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son “off” para inhabilitar la verificación, “warning” para imprimir una advertencia cuando se detecte una discrepancia o “error” para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
valor predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- El valor predeterminado de
--lockfile_mode=<off, update or error>
es "desactivado" -
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son “update” para usar el archivo de bloqueo y actualizarlo si hay cambios; “error” para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o “off” para no leerlo ni escribirlo en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y se recurrirá únicamente a los posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
valor predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán estadísticas para todos los mnemotécnicos.
- Opciones que especifican o alteran una entrada genérica a un comando de Bazel que no pertenece a otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remoto:
- Configuración predeterminada de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo para configurar el cargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno con el que debe coincidir y otro para usar como URL sustitutiva, con referencias inversas que comienzan con "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL, y se mostrarán varias URL.
- Opciones varias, que no están categorizadas:
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace"
- Opciones que controlan la ejecución de la compilación:
--[no]experimental_inprocess_symlink_creation
valor predeterminado: "false"-
Indica si se deben realizar llamadas directas al sistema de archivos para crear árboles de symlinks
Etiquetas:loading_and_analysis
,execution
,experimental
--[no]experimental_remotable_source_manifests
valor predeterminado: "false"-
Indica si se pueden hacer que las acciones del manifiesto de origen sean remotas
Etiquetas:loading_and_analysis
,execution
,experimental
--[no]experimental_split_coverage_postprocessing
valor predeterminado: "false"-
Si es verdadero, Bazel ejecutará el procesamiento posterior de la cobertura para probarlo en un nuevo generador.
Etiquetas:execution
--[no]experimental_strict_fileset_output
valor predeterminado: "false"-
Si habilitas esta opción, los conjuntos de archivos tratarán todos los artefactos de salida como archivos normales. No desviarán directorios ni serán sensibles a los symlinks.
Etiquetas:execution
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
predeterminado: ""-
Agrega o quita claves de la información de ejecución de una acción según el valor mnemotécnico de la acción. Solo se aplica a las acciones que admiten información de ejecución. Muchas acciones comunes admiten información de ejecución, p.ej., Genrule, CppCompile, Javac, StarlarkAction y TestRunner. Cuando se especifican varios valores, el orden es importante porque muchas regex pueden aplicarse al mismo valor mnemotécnico.
Sintaxis: "regex=[+-]key,regex=[+-]key,...".
Ejemplos:
“.*=+x,.*=-y,.*=+z” agrega “x” y “z” a la información de ejecución de todas las acciones y quita “y”.
“Genrule=+requires-x” agrega “require-x” a la información de ejecución para todas las acciones de Genrule.
“(?!Genrule).*=-requires-x” quita “require-x” de la información de ejecución para todas las acciones que no son de Genrule.
Etiquetas:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Habilita las acciones persistentes de dex y desugar de Android con trabajadores.
Se expande a:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
-
Habilita el procesador de recursos persistentes de Android usando trabajadores.
Se expande a:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
}
--strategy=Aapt2Optimize=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
host_machine_resource_optimizations
execution
--persistent_multiplex_android_dex_desugar
-
Habilita las acciones de dex y desugar multiplexadas persistentes de Android con trabajadores.
Se expande a:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
Habilita el procesador de recursos multiplexados persistentes de Android usando trabajadores.
Se expande a:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
}
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
host_machine_resource_optimizations
execution
--persistent_multiplex_android_tools
-
Habilita herramientas persistentes y multiplexadas de Android (dexing, expansión de sintaxis, procesamiento de recursos).
Se expande a:
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Etiquetas:host_machine_resource_optimizations
,execution
- Opciones que configuran la cadena de herramientas que se usa para ejecutar la acción:
- Configuración predeterminada de
--android_compiler=<a string>
: ver descripción -
El compilador de destino de Android
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_crosstool_top=<a build target label>
predeterminado: "//external:android/crosstool"-
Es la ubicación del compilador de C++ que se usa para las compilaciones de Android.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
yloses_incremental_state
- Configuración predeterminada de
--android_grte_top=<a label>
: ver descripción -
El objetivo de Android es grte_top.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
predeterminado: "android"-
Selecciona la combinación de manifiestos que se usará para las reglas android_binary. Marca para ayudar en la transición a la combinación de manifiestos de Android desde la combinación heredada.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_platforms=<a build target label>
predeterminado: ""-
Establece las plataformas que usan los objetivos de android_binary. Si se especifican varias plataformas, el objeto binario es un APK multiarquitectura, que incluye objetos binarios nativos para cada plataforma de destino especificada.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_sdk=<a build target label>
predeterminado: "@bazel_tools//tools/android:sdk"-
Especifica el SDK o la plataforma de Android que se utiliza para compilar aplicaciones para Android.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
- Configuración predeterminada de
--apple_compiler=<a string>
: ver 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"-
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
- Configuración predeterminada de
--apple_grte_top=<a build target label>
: ver 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
- Configuración predeterminada de
--compiler=<a string>
: ver descripción -
El compilador de C++ que se usará para compilar el destino.
Etiquetas:loading_and_analysis
,execution
--coverage_output_generator=<a build target label>
predeterminado: "@bazel_tools//tools/test:lcov_merger"-
Ubicación del objeto binario que se usa para procesar posteriormente los informes de cobertura sin procesar. Actualmente, debe ser un grupo de archivos que contenga un solo archivo, el binario. La configuración predeterminada es '//tools/test:lcov_merger'.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
predeterminado: "@bazel_tools//tools/test:coverage_report_generator"-
Ubicación del objeto binario que se usa para generar informes de cobertura. Actualmente, debe ser un grupo de archivos que contenga un solo archivo, el binario. La configuración predeterminada es “//tools/test:coverage_report_generator”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
predeterminado: "@bazel_tools//tools/test:coverage_support"-
Ubicación de los archivos de compatibilidad que se requieren en las entradas de cada acción de prueba que recopila la cobertura de código. La configuración predeterminada es "//tools/test:coverage_support".
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--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 el código de C++.
Etiquetas:loading_and_analysis
,changes_inputs
,affects_outputs
- Configuración predeterminada de
--custom_malloc=<a build target label>
: ver descripción -
Especifica una implementación de malloc personalizada. Este parámetro de configuración anula los atributos malloc en las reglas de compilación.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
usos múltiples -
Lista de expresiones regulares separadas por comas, cada una con el prefijo - (expresión negativa), asignada (=) a una lista de valores de restricción separados por comas. Si un objetivo no coincide con ninguna expresión negativa y al menos una expresión positiva, la resolución de la cadena de herramientas se ejecutará como si hubiera declarado los valores de restricción como restricciones de ejecución. Ejemplo: //demo,-test=@platforms//cpus:x86_64 agregará 'x86_64' a cualquier destino de //demo, excepto aquellos cuyo nombre contenga 'prueba'.
Etiquetas:loading_and_analysis
- El valor predeterminado de
--[no]experimental_enable_objc_cc_deps
es "true" (verdadero). -
Permite que las reglas objc_* dependan de cc_library y hace que cualquier dependencia objc se compile con --cpu set to "ios_<--ios_cpu>" para cualquier valor en --ios_multi_cpu.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]experimental_include_xcode_execution_requirements
valor predeterminado: "false"-
Si se configura, agrega un requisito de ejecución “requires-xcode:{version}” a cada acción de Xcode. Si la versión de Xcode tiene una etiqueta con guion, también agrega un requisito de ejecución “requires-xcode-label:{version_label}”.
Etiquetas:loses_incremental_state
,loading_and_analysis
,execution
- El valor predeterminado de
--[no]experimental_prefer_mutual_xcode
es "true" (verdadero). -
Si es verdadero, usa el Xcode más reciente que esté disponible de forma local y remota. Si es falso, o si no existen versiones mutuas disponibles, usa la versión local de Xcode seleccionada a través de xcode-select.
Etiquetas:loses_incremental_state
- Se acumulan
--extra_execution_platforms=<comma-separated list of options>
usos múltiples -
Son las plataformas disponibles como plataformas de ejecución para ejecutar acciones. Las plataformas se pueden especificar por objetivo exacto o como patrón de objetivo. Estas plataformas se considerarán antes que las declaradas en el archivo WORKSPACE por register_execution_platforms().
Etiquetas:execution
- Se acumulan
--extra_toolchains=<comma-separated list of options>
usos múltiples -
Son las reglas de la cadena de herramientas que se tendrán en cuenta durante su resolución. Las cadenas de herramientas se pueden especificar por objetivo exacto o como patrón de objetivo. Estas cadenas de herramientas se considerarán antes de las declaradas en el archivo WORKSPACE por register_toolchains().
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
- Configuración predeterminada de
--grte_top=<a label>
: ver descripción -
Es una etiqueta de una biblioteca libc registrada. La cadena de herramientas de herramientas cruzadas selecciona el valor predeterminado, y casi nunca necesitas anularlo.
Etiquetas:action_command_lines
,affects_outputs
- Configuración predeterminada de
--host_compiler=<a string>
: ver descripción -
Compilador de C++ que se usará para la compilación del host. Se ignora si no se configura --host_crosstool_top.
Etiquetas:loading_and_analysis
,execution
- Configuración predeterminada de
--host_crosstool_top=<a build target label>
: ver descripción -
De forma predeterminada, las opciones --crosstool_top y --compiler también se usan para la configuración del host. Si se proporciona esta marca, Bazel usa el libc y el compilador predeterminados para la crosstool_top especificada.
Etiquetas:loading_and_analysis
,changes_inputs
,affects_outputs
- Configuración predeterminada de
--host_grte_top=<a label>
: ver descripción -
Si se especifica, este parámetro 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: ""-
Es la etiqueta de una regla de la plataforma que describe el sistema host.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
- El valor predeterminado de
--[no]incompatible_disable_expand_if_all_available_in_flag_set
es "true" (verdadero). -
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
- El valor predeterminado de
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
es "true" (verdadero). -
Si es "true", Bazel no habilitará las funciones "host" y "nonhost" en la cadena de herramientas de c++ (consulta https://github.com/bazelbuild/bazel/issues/7407 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_android_toolchain_resolution
valor predeterminado: "false"-
Usa la resolución de la cadena de herramientas para seleccionar el SDK de Android para reglas de Android (Starlark y nativo)
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_apple_toolchain_resolution
valor predeterminado: "false"-
Usa la resolución de la cadena de herramientas para seleccionar el SDK de Apple para las reglas de Apple (Starlark y nativo)
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_make_thinlto_command_lines_standalone
es "true" (verdadero). -
Si es verdadero, Bazel no reutilizará las líneas de comandos de acción de vínculo de C++ para las líneas de comandos de indexación lto (consulta https://github.com/bazelbuild/bazel/issues/6791 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain
es "true" (verdadero). -
Si es así, Bazel realizará un reclamo cuando se configuren 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
- El valor predeterminado de
--[no]incompatible_remove_legacy_whole_archive
es "true" (verdadero). -
Si es verdadero, Bazel no vinculará las dependencias de la biblioteca como todo el archivo de forma predeterminada (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener instrucciones de migración).
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_require_ctx_in_configure_features
es "true" (verdadero). -
Si es "true", Bazel requerirá el parámetro "="{" 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 lo admite. Todas las cadenas de herramientas de ELF admiten actualmente este parámetro de configuración.
Etiquetas:loading_and_analysis
,affects_outputs
,affects_outputs
- Configuración predeterminada de
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Especifica la versión del SDK de iOS que se usará para compilar aplicaciones para iOS. Si no se especifica, usa la versión predeterminada del SDK para iOS de “xcode_version”.
Etiquetas:loses_incremental_state
- Configuración predeterminada de
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Especifica la versión del SDK de macOS que se usará para compilar aplicaciones de macOS. Si no se especifica, se usa la versión predeterminada del SDK de macOS de “xcode_version”.
Etiquetas:loses_incremental_state
- Configuración predeterminada de
--minimum_os_version=<a string>
: ver descripción -
La versión mínima del SO a la que se orienta tu compilación.
Etiquetas:loading_and_analysis
,affects_outputs
--platform_mappings=<a relative path>
predeterminado: ""-
Es la ubicación de un archivo de asignación en la que se describe qué plataforma usar si no hay ninguna establecida o qué marcas se deben configurar cuando ya existe una plataforma. Debe estar relacionado con la raíz del lugar de trabajo principal. La configuración predeterminada es "platform_mappings", que es un archivo directamente en la raíz del lugar de trabajo.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--platforms=<a build target label>
predeterminado: ""-
Las etiquetas de las reglas de la plataforma que describen las plataformas de destino para el comando actual.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
- Configuración predeterminada de
--python2_path=<a string>
: ver descripción -
Obsoleto, no-op. Inhabilitado por `--incompatible_use_python_toolchains`.
Etiquetas:no_op
,deprecated
- Configuración predeterminada de
--python3_path=<a string>
: ver descripción -
Obsoleto, no-op. Inhabilitado por `--incompatible_use_python_toolchains`.
Etiquetas:no_op
,deprecated
- Configuración predeterminada de
--python_path=<a string>
: ver descripción -
Es la ruta de acceso absoluta del intérprete de Python que se invoca para ejecutar los objetivos de Python en la plataforma de destino. Obsoleto; inhabilitado por --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
- Configuración predeterminada de
--python_top=<a build target label>
: ver descripción -
La etiqueta de un py_runtime que representa el intérprete de Python invocado para ejecutar objetivos de Python en la plataforma de destino. Obsoleto; inhabilitado por --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
--target_platform_fallback=<a build target label>
valor predeterminado: "@local_config_platform//:host"-
Es la etiqueta de una regla de plataforma que se debe usar si no se establece ninguna plataforma de destino y no hay una asignación de plataforma que coincida con el conjunto actual de marcas.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
- Configuración predeterminada de
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Especifica la versión del SDK de tvOS que se usará para compilar aplicaciones de tvOS. Si no se especifica, se usa la versión predeterminada del SDK de tvOS de “xcode_version”.
Etiquetas:loses_incremental_state
- Configuración predeterminada de
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Especifica la versión del SDK de watchOS que se usará para compilar aplicaciones de watchOS. Si no se especifica, se usa la versión predeterminada del SDK de watchOS de “xcode_version”.
Etiquetas:loses_incremental_state
- Configuración predeterminada de
--xcode_version=<a string>
: ver descripción -
Si se especifica, usa Xcode de la versión determinada para las acciones de compilación relevantes. Si no se especifica, usa la versión predeterminada del ejecutor de Xcode.
Etiquetas:loses_incremental_state
--xcode_version_config=<a build target label>
predeterminado: "@bazel_tools//tools/cpp:host_xcodes"-
La etiqueta de la regla xcode_config que se usará para seleccionar la versión de Xcode en la configuración de compilación.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Opciones que controlan el resultado del comando:
--[no]apple_enable_auto_dsym_dbg
valor predeterminado: "false"-
Determina si se debe forzar la habilitación de la generación de archivos de símbolos de depuración (.dSYM) para compilaciones de dbg.
Etiquetas:affects_outputs
,action_command_lines
--[no]apple_generate_dsym
valor predeterminado: "false"-
Indica si se deben generar archivos de símbolos de depuración (.dSYM).
Etiquetas:affects_outputs
,action_command_lines
- El valor predeterminado de
--[no]build_runfile_links
es "true" (verdadero). -
Si esta opción es verdadera, compila bosques de symlinks de archivos de ejecución para todos los destinos. Si es falso, solo escribe manifiestos cuando sea posible.
Etiquetas:affects_outputs
- El valor predeterminado de
--[no]build_runfile_manifests
es "true" (verdadero). -
Si esta opción es verdadera, se escriben manifiestos de archivos de ejecución para todos los destinos. Si es falso, omítelos. Las pruebas locales no se ejecutarán si el valor es falso.
Etiquetas:affects_outputs
--[no]build_test_dwp
valor predeterminado: "false"-
Si se habilita, cuando se compilen pruebas de C++ de forma estática y con fisión, el archivo .dwp para el objeto binario de prueba también se compilará automáticamente.
Etiquetas:loading_and_analysis
,affects_outputs
--cc_proto_library_header_suffixes=<comma-separated 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"-
Establece los prefijos de los archivos fuente que crea una cc_proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info
valor predeterminado: "false"-
Ejecuta acciones adicionales para versiones alternativas de la API de Java en una proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_proto_extra_actions
valor predeterminado: "false"-
Ejecuta acciones adicionales para versiones alternativas de la API de Java en una proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_save_feature_state
valor predeterminado: "false"-
Guarda el estado de las funciones habilitadas y solicitadas como resultado de la compilación.
Etiquetas:affects_outputs
,experimental
- El valor predeterminado de
--fission=<a set of compilation modes>
es "no" -
Especifica qué modos de compilación usan fisión para compilaciones y vínculos de C++. Puede ser cualquier combinación de {'fastbuild', 'dbg', 'opt'} o los valores especiales "yes" para habilitar todos los modos y "no" para inhabilitarlos.
Etiquetas:loading_and_analysis
,action_command_lines
,affects_outputs
- El valor predeterminado de
--[no]incompatible_always_include_files_in_data
es "true" (verdadero). -
Si es verdadero, las reglas nativas agregan <code>DefaultInfo.files</code> de dependencias de datos a sus archivos de ejecución, lo que coincide con el comportamiento recomendado para las reglas de Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid).
Etiquetas:affects_outputs
,incompatible_change
- El valor predeterminado de
--[no]legacy_external_runfiles
es "true" (verdadero). -
Si esta opción es verdadera, compila bosques de symlink de archivos de ejecución para repositorios externos en .runfiles/wsname/external/repo (además de .runfiles/repo).
Etiquetas:affects_outputs
--[no]objc_generate_linkmap
valor predeterminado: "false"-
Especifica si se debe generar un archivo de mapa de vínculos.
Etiquetas:affects_outputs
--[no]save_temps
valor predeterminado: "false"-
Si se establece, se guardarán los resultados temporales de GCC. Estos incluyen archivos .s (código ensamblador), archivos .i (C preprocesado) y archivos .ii (C++ previamente procesados).
Etiquetas:affects_outputs
- Opciones que permiten al usuario configurar el resultado deseado y afectar su valor, en lugar de su existencia:
- Se acumulan
--action_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica el conjunto de variables de entorno disponibles para acciones con configuración de destino. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o mediante el par nombre=valor que establece el valor independientemente del entorno de invocación. Esta opción se puede usar varias veces; para opciones proporcionadas para la misma variable, se acumulan los últimos éxitos, las opciones para diferentes variables se acumulan.
Etiquetas:action_command_lines
--android_cpu=<a string>
predeterminado: "armeabi-v7a"-
Es la CPU de destino de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]android_databinding_use_androidx
valor predeterminado: "false"-
Genera archivos de vinculación de datos compatibles con AndroidX. Esto solo se usa con Databinding v2.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
yexperimental
--[no]android_databinding_use_v3_4_args
valor predeterminado: "false"-
Usar Android Databinding v2 con argumentos 3.4.0
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- El valor predeterminado de
--android_dynamic_mode=<off, default or fully>
es "desactivado" -
Determina si las dependencias de C++ de las reglas de Android se vincularán de forma dinámica cuando un objeto cc_binary no cree explícitamente una biblioteca compartida. “default” significa que Bazel decide si se vincula de forma dinámica. "completamente" significa que todas las bibliotecas se vincularán de forma dinámica. “off” significa que todas las bibliotecas se vincularán en su mayor parte en modo estático.
Etiquetas:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
valor predeterminado: "alphabetical"-
Establece el orden de los manifiestos que se pasan a la combinación de manifiestos para objetos binarios de Android. ALFABÉTICO significa que los manifiestos se ordenan por ruta de acceso relativa a la execroot. ALPHABETICAL_BY_CONFIGURATION significa que los manifiestos se ordenan por rutas de acceso relacionadas con el directorio de configuración dentro del directorio de salida. DEPENDENCY significa que los manifiestos se ordenan con los manifiestos de cada biblioteca antes que los de sus dependencias.
Etiquetas:action_command_lines
,execution
--[no]android_resource_shrinking
valor predeterminado: "false"-
Habilita la reducción de recursos para los APKs de android_binary que usan ProGuard.
Etiquetas:affects_outputs
,loading_and_analysis
- Se acumulan
--apple_bitcode=<'mode' or 'platform=mode', where 'mode' is none, embedded_markers or embedded, and 'platform' is ios, visionos, watchos, tvos, macos or catalyst>
usos múltiples -
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”, en el que la plataforma (que debe ser “ios”, “macos”, “tvos” o “watchos”) es opcional. Si se proporciona, el modo de código de bits se aplica específicamente a esa plataforma. Si se omite, se aplica a todas las plataformas. El modo debe ser "none", "embedded_markers" o "embedded". Esta opción se puede proporcionar varias veces.
Etiquetas:loses_incremental_state
- Valor predeterminado de
--[no]build_python_zip
: "auto" -
Compila el archivo ZIP del comando de Python; en Windows, desactivado en otras plataformas
Etiquetas:affects_outputs
- Se acumulan
--catalyst_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se compilan los objetos binarios de Apple Catalyst.
Etiquetas:loses_incremental_state
,loading_and_analysis
--[no]collect_code_coverage
valor predeterminado: "false"-
Si se especifica, Bazel instrumentará código (con instrumentación sin conexión cuando sea posible) y recopilará información de cobertura durante las pruebas. Solo se verán afectados los objetivos que coincidan con --instrumentation_filter. Por lo general, esta opción no debe especificarse directamente; en su lugar, debes usar el comando "bazel esquema".
Etiquetas:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] predeterminado: "fastbuild"-
Especifica el modo en el que se compilará el objeto binario. Valores: "fastbuild", "dbg", "opt".
Etiquetas:affects_outputs
,action_command_lines
,explicit_in_output_path
- Se acumulan
--conlyopt=<a string>
usos múltiples -
Es una opción adicional para pasar a gcc cuando se compilan archivos de origen C.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--copt=<a string>
usos múltiples -
Opciones adicionales para pasar a gcc.
Etiquetas:action_command_lines
,affects_outputs
--cpu=<a string>
predeterminado: ""-
La CPU de destino.
Etiquetas:changes_inputs
,affects_outputs
,explicit_in_output_path
- Configuración predeterminada de
--cs_fdo_absolute_path=<a string>
: ver descripción - Usa la información del perfil de CSFDO para optimizar la compilación. Especifica el nombre de ruta de acceso absoluto del archivo ZIP que contiene el archivo de perfil, un archivo de perfil de LLVM sin procesar o indexado.
Etiquetas:affects_outputs
- Configuración predeterminada de
--cs_fdo_instrument=<a string>
: ver descripción - Genera objetos binarios con instrumentación de FDO sensible al contexto. Con el compilador Clang/LLVM, también acepta el nombre de directorio bajo el cual se volcarán los archivos de perfil sin procesar durante el tiempo de ejecución.
Etiquetas:affects_outputs
- Configuración predeterminada de
--cs_fdo_profile=<a build target label>
: ver descripción -
El cs_fdo_profile, que representa el perfil sensible al contexto que se usará para la optimización.
Etiquetas:affects_outputs
- Se acumulan
--cxxopt=<a string>
usos múltiples -
Es una opción adicional para pasar a gcc cuando se compilan archivos de origen C++.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--define=<a 'name=value' assignment>
usos múltiples -
Cada opción --define especifica una asignación para una variable de compilación.
Etiquetas:changes_inputs
,affects_outputs
--dynamic_mode=<off, default or fully>
valor predeterminado: "default"-
Determina si los objetos binarios de C++ se vincularán de forma dinámica. “predeterminada” significa que Bazel elegirá si se vinculará de forma dinámica. "completamente" significa que todas las bibliotecas se vincularán de forma dinámica. “off” significa que todas las bibliotecas se vincularán en su mayor parte en modo estático.
Etiquetas:loading_and_analysis
,affects_outputs
- El valor predeterminado de
--[no]enable_fdo_profile_absolute_path
es "true" (verdadero). -
Si se configura, el uso de fdo_absolute_profile_path generará un error.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]enable_runfiles
: "auto" -
Habilita el árbol del symlink de los archivos de ejecución. De forma predeterminada, está desactivado en Windows y en otras plataformas.
Etiquetas:affects_outputs
- Se acumulan
--experimental_action_listener=<a build target label>
usos múltiples -
Se dio de baja a favor de los aspectos. Usa action_listener para adjuntar una extra_action a las acciones de compilación existentes.
Etiquetas:execution
,experimental
--[no]experimental_android_compress_java_resources
valor predeterminado: "false"-
Comprime los recursos de Java en APK
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_android_databinding_v2
valor predeterminado: "false"-
Usar Android Databinding v2
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_android_resource_shrinking
valor predeterminado: "false"-
Habilita la reducción de recursos para los APKs de android_binary que usan ProGuard.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_android_rewrite_dexes_with_rex
valor predeterminado: "false"-
usar la herramienta Rex para reescribir archivos dex
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_collect_code_coverage_for_generated_files
valor predeterminado: "false"-
Si se especifica, Bazel también generará información de cobertura para los archivos generados.
Etiquetas:affects_outputs
--experimental_objc_fastbuild_options=<comma-separated list of options>
predeterminado: "-O0,-DDEBUG=1"-
Usa estas cadenas como opciones del compilador objc fastbuild.
Etiquetas:action_command_lines
--[no]experimental_omitfp
valor predeterminado: "false"-
Si esta opción es "true", usa libunwind para desenrollar la pila y compila con -fomit-frame-pointer y -fasym-unwind-tables.
Etiquetas:action_command_lines
,affects_outputs
,experimental
--[no]experimental_platform_in_output_dir
valor predeterminado: "false"-
Si es verdadero, se usa la plataforma de destino en el nombre del directorio de salida en lugar de la CPU.
Etiquetas:affects_outputs
,experimental
--[no]experimental_use_llvm_covmap
valor predeterminado: "false"-
Si se especifica, Bazel generará información del mapa de cobertura llvm-cov en lugar de gcov cuando collect_code_coverage esté habilitado.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
yexperimental
--fat_apk_cpu=<comma-separated list of options>
predeterminado: "armeabi-v7a"-
Mediante la configuración de esta opción, se habilitan los APK multiarquitecturas, que contienen objetos binarios nativos para todas las arquitecturas de destino especificadas, p.ej., --fat_apk_cpu=x86,armeabi-v7a. Si se especifica esta marca, --android_cpu se ignora para dependencias de reglas android_binary.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]fat_apk_hwasan
valor predeterminado: "false"-
Determina si se deben crear divisiones HWASAN.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Configuración predeterminada de
--fdo_instrument=<a string>
: ver descripción - Genera objetos binarios con instrumentación de FDO. Con el compilador Clang/LLVM, también acepta el nombre de directorio bajo el cual se volcarán los archivos de perfil sin procesar durante el tiempo de ejecución.
Etiquetas:affects_outputs
- Configuración predeterminada de
--fdo_optimize=<a string>
: ver descripción - Usa la información del perfil de FDO para optimizar la compilación. Especifica el nombre de un archivo ZIP que contenga un árbol de archivos .gcda, un archivo afdo que contenga un perfil automático o un archivo de perfil de LLVM. Esta marca también acepta archivos especificados como etiquetas (p.ej., `//foo/bar:file.afdo` (es posible que debas agregar una directiva `exports_files` al paquete correspondiente) y etiquetas que apunten a objetivos de `fdo_profile`. Esta marca será reemplazada por la regla “fdo_profile”.
Etiquetas:affects_outputs
- Configuración predeterminada de
--fdo_prefetch_hints=<a build target label>
: ver descripción -
Usa sugerencias de carga previa de caché.
Etiquetas:affects_outputs
- Configuración predeterminada de
--fdo_profile=<a build target label>
: ver descripción -
El fdo_profile, que representa el perfil que se utilizará para la optimización.
Etiquetas:affects_outputs
- Se acumulan
--features=<a string>
usos múltiples -
Estas funciones estarán habilitadas o inhabilitadas de forma predeterminada para los destinos integrados en la configuración de destino. Si especificas -<feature>, se inhabilitará la función. Los atributos negativos siempre anulan a los positivos. Consulta también --host_features
Etiquetas:changes_inputs
,affects_outputs
--[no]force_pic
valor predeterminado: "false"-
Si se habilita, todas las compilaciones de C++ producen código independiente de la posición ("-fPIC"), los vínculos prefieren bibliotecas PIC compiladas previamente en lugar de bibliotecas que no son PIC, y los vínculos producen ejecutables independientes de la posición ("-pie").
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan
--host_action_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica el conjunto de variables de entorno disponibles para acciones con configuraciones de host o de ejecución. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o mediante el par nombre=valor que establece el valor independientemente del entorno de invocación. Esta opción se puede usar varias veces; para opciones proporcionadas para la misma variable, se acumulan los últimos éxitos, las opciones para diferentes variables se acumulan.
Etiquetas:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
valor predeterminado: "opt"- Especifica el modo en el que se integrarán las herramientas usadas durante la compilación. Valores: "fastbuild", "dbg", "opt".
Etiquetas:affects_outputs
,action_command_lines
- Se acumulan
--host_conlyopt=<a string>
usos múltiples -
Es una opción adicional para pasar a gcc cuando se compilan archivos de origen C para las herramientas de host.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--host_copt=<a string>
usos múltiples -
Opciones adicionales para pasar a gcc para las herramientas del host.
Etiquetas:action_command_lines
,affects_outputs
--host_cpu=<a string>
predeterminado: ""-
Es la CPU del host.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan
--host_cxxopt=<a string>
usos múltiples -
Opciones adicionales para pasar a gcc para las herramientas del host.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--host_features=<a string>
usos múltiples -
Las funciones determinadas estarán habilitadas o inhabilitadas de forma predeterminada para los destinos integrados en la configuración de ejecución. Si especificas -<feature>, se inhabilitará la función. Los atributos negativos siempre anulan a los positivos.
Etiquetas:changes_inputs
,affects_outputs
- Configuración predeterminada de
--host_force_python=<PY2 or PY3>
: ver descripción -
Anula la versión de Python para la configuración del host. Puede ser “PY2” o “PY3”.
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan
--host_linkopt=<a string>
usos múltiples -
Es una opción adicional para pasar a gcc cuando se vinculan las herramientas del host.
Etiquetas:action_command_lines
,affects_outputs
- Configuración predeterminada de
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima de macOS compatible para los destinos de host. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
usos múltiples -
Son opciones adicionales para pasar de forma selectiva al compilador C/C++ cuando se compilan ciertos archivos en las configuraciones de host o de ejecución. Esta opción se puede aprobar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter significa una lista de patrones de expresiones regulares de inclusión y exclusión (consulta también --instrumentation_filter). option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe ir entre comillas con una barra inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos gcc de todos los archivos cc en //foo/, excepto bar.cc.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--host_swiftcopt=<a string>
usos múltiples -
Opciones adicionales para pasar a swiftc para las herramientas del host.
Etiquetas:action_command_lines
,affects_outputs
- El valor predeterminado de
--[no]incompatible_avoid_conflict_dlls
es "true" (verdadero). -
Si se habilita, todas las bibliotecas dinámicas vinculadas (DLL) de C++ generadas por cc_library en Windows cambiarán de nombre por name_{hash}.dll, en el que el hash se calcula en función del RepositoryName y la ruta 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
- El valor predeterminado de
--[no]incompatible_merge_genfiles_directory
es "true" (verdadero). -
Si es verdadero, el directorio genfiles se pliega en el directorio bin.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_use_host_features
valor predeterminado: "false"-
Si es verdadero, usa --features solo para la configuración de destino y --host_features para la configuración de ejecución.
Etiquetas:changes_inputs
,affects_outputs
,incompatible_change
- El valor predeterminado de
--[no]incompatible_use_platforms_repo_for_constraints
es "true" (verdadero). -
Si es verdadero, se quitará la configuración de restricciones de @bazel_tools.
Etiquetas:affects_outputs
,incompatible_change
--[no]instrument_test_targets
valor predeterminado: "false"-
Cuando la cobertura está habilitada, especifica si se debe considerar la instrumentación de reglas de prueba. Cuando se establece, se instrumentan las reglas de prueba incluidas por --instrumentation_filter. De lo contrario, las reglas de prueba siempre se excluyen de la instrumentación de cobertura.
Etiquetas:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
valor predeterminado: "-/javatests[/:],-/test/java[/:]"-
Cuando la cobertura esté habilitada, solo se instrumentarán las reglas con nombres incluidos en el filtro basado en regex especificado. En su lugar, se excluyen las reglas con el prefijo “-”. Ten en cuenta que solo se instrumentan las reglas que no son de prueba, a menos que esté habilitado --instrument_test_targets.
Etiquetas:affects_outputs
- Configuración predeterminada de
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima de iOS compatible con los simuladores y dispositivos de destino. Si no se especifica, usa “ios_sdk_version”.
Etiquetas:loses_incremental_state
- Se acumulan
--ios_multi_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para compilar una ios_application. El resultado es un objeto binario universal que contiene todas las arquitecturas especificadas.
Etiquetas:loses_incremental_state
,loading_and_analysis
- El valor predeterminado de
--[no]legacy_whole_archive
es "true" (verdadero). -
Obsoleto y sustituido por --incompatible_remove_legacy_whole_archive (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener más información). Cuando esta opción está activada, se usa --whole-archive para reglas cc_binary que tengan linkshared=True y linkstatic=True o '-static' en linkopts. Esto es solo para retrocompatibilidad. Una mejor alternativa es usar Alwayslink=1 cuando sea necesario.
Etiquetas:action_command_lines
,affects_outputs
,deprecated
- Se acumulan
--linkopt=<a string>
usos múltiples -
Es una opción adicional para pasar a gcc durante la vinculación.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--ltobackendopt=<a string>
usos múltiples -
Es una opción adicional para pasar al paso de backend de LTO (en --features=thin_lto).
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--ltoindexopt=<a string>
usos múltiples -
Es una opción adicional para pasar al paso de indexación LTO (en --features=thin_lto).
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--macos_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se compilan objetos binarios de Apple macOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Configuración predeterminada de
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima de macOS compatible para los objetivos. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
--[no]objc_debug_with_GLIBCXX
valor predeterminado: "false"-
Si estableces la política y el modo de compilación está configurado como "dbg", define GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC y GLIBCPP_CONCEPT_CHECKS.
Etiquetas:action_command_lines
--[no]objc_enable_binary_stripping
valor predeterminado: "false"-
Determina si se deben quitar símbolos y códigos muertos en objetos binarios vinculados. Si se especifican esta marca y --compilation_mode=opt, se realizarán eliminaciones binarias.
Etiquetas:action_command_lines
- Se acumulan
--objccopt=<a string>
usos múltiples -
Opciones adicionales para pasar a gcc cuando se compilan archivos fuente Objective-C/C++.
Etiquetas:action_command_lines
- Se acumulan
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
usos múltiples -
Opciones adicionales para pasar selectivamente a gcc cuando se compilan ciertos archivos. Esta opción se puede aprobar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter significa una lista de patrones de expresiones regulares de inclusión y exclusión (consulta también --instrumentation_filter). option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe ir entre comillas con una barra inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos gcc de todos los archivos cc en //foo/, excepto bar.cc.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
usos múltiples -
Opciones adicionales para pasar de forma selectiva al backend de LTO (en --features=thin_lto) cuando se compilan ciertos objetos de backend. Esta opción se puede aprobar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter significa una lista de patrones de expresiones regulares de inclusión y exclusión, y option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe ir entre comillas con una barra inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos del backend de LTO de todos los archivos o en //foo/, excepto bar.o.
Etiquetas:action_command_lines
,affects_outputs
- Configuración predeterminada de
--platform_suffix=<a string>
: ver descripción -
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas:loses_incremental_state
,affects_outputs
,loading_and_analysis
- Configuración predeterminada de
--propeller_optimize=<a build target label>
: ver descripción -
Usa la información del perfil de Propeller para optimizar el objetivo de compilación.Un perfil de propulsor debe constar de al menos uno de dos archivos, un perfil cc y un perfil ld. Esta marca acepta una etiqueta de compilación que debe hacer referencia a los archivos de entrada del perfil de propulsor. Por ejemplo, el archivo BUILD que define la etiqueta La opción debe usarse de la siguiente manera: --propeller_optimize=//a/b:propeller_profile
Etiquetas:action_command_lines
,affects_outputs
- Configuración predeterminada de
--propeller_optimize_absolute_cc_profile=<a string>
: ver descripción -
Nombre de ruta de acceso absoluto del archivo cc_profile para compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
- Configuración predeterminada de
--propeller_optimize_absolute_ld_profile=<a string>
: ver descripción -
Nombre de ruta de acceso absoluto del archivo ld_profile para compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
- Configuración predeterminada de
--run_under=<a prefix in front of command>
: ver descripción -
Es el prefijo que se debe insertar antes de los ejecutables para los comandos “test” y “run”. Si el valor es “foo -bar”, y la línea de comandos de ejecución es “test_binary -baz”, la línea de comandos final es “foo -bar test_binary -baz”. También puede ser una etiqueta para un destino ejecutable. Estos son algunos ejemplos: 'valgrind', 'strace', 'strace -c', 'valgrind --quiet --num-callers=20', '//package:target', '//package:target --options'.
Etiquetas:action_command_lines
-
Si es "true", las bibliotecas nativas que contengan la misma funcionalidad se compartirán entre diferentes destinos
Etiquetas:loading_and_analysis
,affects_outputs
--[no]stamp
valor predeterminado: "false"-
Sella los objetos binarios con la fecha, el nombre de usuario, el nombre de host, la información del lugar de trabajo, etcétera.
Etiquetas:affects_outputs
- El valor predeterminado de
--strip=<always, sometimes or never>
es " a veces". -
Especifica si se quitan los objetos binarios y las bibliotecas compartidas (con "-Wl,--strip-debug"). El valor predeterminado de "algunas veces" significa quitar iff --compilation_mode=fastbuild.
Etiquetas:affects_outputs
- Se acumulan
--stripopt=<a string>
usos múltiples -
Opciones adicionales para quitar cuando se genera un objeto binario “<name>.stripped”.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--swiftcopt=<a string>
usos múltiples -
Opciones adicionales para pasar a la compilación de Swift.
Etiquetas:action_command_lines
- Se acumulan
--tvos_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se compilan objetos binarios de Apple tvOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Configuración predeterminada de
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima de tvOS compatible para simuladores de objetivo y dispositivos. Si no se especifica, se usa "tvos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan
--visionos_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se compilan objetos binarios de visionOS de Apple.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Se acumulan
--watchos_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se compilan objetos binarios de watchOS de Apple.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Configuración predeterminada de
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima de watchOS compatible para los simuladores y dispositivos de destino. Si no se especifica, se usa “watchos_sdk_version”.
Etiquetas:loses_incremental_state
- Configuración predeterminada de
--xbinary_fdo=<a build target label>
: ver descripción - Usa la información del perfil de XbinaryFDO para optimizar la compilación. Especifica el nombre del perfil binario cruzado predeterminado. Cuando la opción se usa junto con --fdo_instrument/--fdo_optimize/--fdo_profile, esas opciones siempre prevalecerán como si nunca se especificara xbinary_fdo.
Etiquetas:affects_outputs
- Opciones que afectan la medida en la que Bazel aplica de manera estricta entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
--auto_cpu_environment_group=<a build target label>
predeterminado: ""-
Declara el entorno_group para asignarlo automáticamente a los valores de CPU a los valores target_environment.
Etiquetas:changes_inputs
,loading_and_analysis
,experimental
--[no]check_licenses
valor predeterminado: "false"-
Verifica que las restricciones de licencias impuestas por los paquetes dependientes no entren en conflicto con los modos de distribución de los destinos que se compilan. De forma predeterminada, las licencias no están marcadas.
Etiquetas:build_file_semantics
- El valor predeterminado de
--[no]check_visibility
es "true" (verdadero). - Si se inhabilita, los errores de visibilidad en las dependencias de destino descienden a advertencias.
Etiquetas:build_file_semantics
- El valor predeterminado de
--[no]desugar_for_android
es "true" (verdadero). -
Indica si se debe usar la expansión de sintaxis del código de bytes Java 8 antes de la conversión a DEX.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]desugar_java8_libs
valor predeterminado: "false"-
Determina si se deben incluir bibliotecas de Java 8 compatibles en apps para dispositivos heredados.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
yexperimental
- El valor predeterminado de
--[no]enforce_constraints
es "true" (verdadero). -
Verifica los entornos compatibles con cada destino y, luego, informa errores si algún destino tiene dependencias que no admiten los mismos entornos
Etiquetas:build_file_semantics
--[no]experimental_allow_android_library_deps_without_srcs
valor predeterminado: "false"-
Marca para facilitar la transición de permitir a deshabilitar reglas android_library de srcs-less con dependencias. Se debe limpiar el depósito para lanzarlo de forma predeterminada.
Etiquetas:eagerness_to_exit
,loading_and_analysis
- El valor predeterminado de
--[no]experimental_check_desugar_deps
es "true" (verdadero). -
Indica si se debe verificar la expansión de sintaxis correcta a nivel binario de Android.
Etiquetas:eagerness_to_exit
,loading_and_analysis
,experimental
- Configuración predeterminada de
--experimental_import_deps_checking=<off, warning or error>
: "DESACTIVADA" -
Cuando se habilita, verifica si las dependencias de aar_import están completas. Esta aplicación puede dañar la compilación o simplemente generar advertencias.
Etiquetas:loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
valor predeterminado: "default"-
Si es verdadero, verifica que un destino de Java declare de forma explícita todos los destinos usados de forma directa como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files
valor predeterminado: "false"-
Si se habilita esta opción, verifica los objetivos de solo prueba de los requisitos previos que sean archivos de salida. Para ello, busca el solo de prueba de la regla de generación. Esto coincide con la verificación de visibilidad.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_disable_native_android_rules
valor predeterminado: "false"-
Si se habilita, se inhabilita el uso directo de las reglas nativas de Android. Usa las reglas de Starlark para Android de https://github.com/bazelbuild/rules_android
Etiquetas:eagerness_to_exit
,incompatible_change
--[no]incompatible_disable_native_apple_binary_rule
valor predeterminado: "false"-
No-ops. Se conserva aquí para brindar retrocompatibilidad.
Etiquetas:eagerness_to_exit
,incompatible_change
- El valor predeterminado de
--[no]incompatible_force_strict_header_check_from_starlark
es "true" (verdadero). -
Si está habilitada, establece una verificación de encabezados estricta en la API de Starlark
Etiquetas:loading_and_analysis
,changes_inputs
,incompatible_change
- El valor predeterminado de
--[no]incompatible_validate_top_level_header_inclusions
es "true" (verdadero). -
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
valor predeterminado: "false"- Si se habilita esta opción, los conjuntos de archivos que cruzan los límites de los paquetes se informan como errores. No funciona cuando check_fileset_Dependencies_recursively está inhabilitado.
Etiquetas:build_file_semantics
,eagerness_to_exit
- El valor predeterminado de
--strict_proto_deps=<off, warn, error, strict or default>
es "error" -
A menos que esté DESACTIVADO, verifica que un destino proto_library declare de forma explícita todos los destinos usados de forma directa como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
- El valor predeterminado de
--strict_public_imports=<off, warn, error, strict or default>
es "desactivado" -
A menos que esté DESACTIVADO, verifica que un destino proto_library declare de forma explícita todos los destinos usados en "import public" como exportados.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
--[no]strict_system_includes
valor predeterminado: "false"-
Si es verdadero, también se deben declarar los encabezados que se encuentran a través de las rutas de inclusión del sistema (-isystem).
Etiquetas:loading_and_analysis
,eagerness_to_exit
- Se acumulan
--target_environment=<a build target label>
usos múltiples -
Declara el entorno de destino de esta compilación. Debe ser una referencia de etiqueta a una regla de “entorno”. Si se especifica, todos los destinos de nivel superior deben ser compatibles con este entorno.
Etiquetas:changes_inputs
- Opciones que afectan los resultados de firma de una compilación:
--apk_signing_method=<v1, v2, v1_v2 or v4>
predeterminado: "v1_v2"-
Implementación que se usa para firmar APKs
Etiquetas:action_command_lines
,affects_outputs
,loading_and_analysis
- El valor predeterminado de
--[no]device_debug_entitlements
es "true" (verdadero). -
Si se configura y el modo de compilación no es "opt", las apps de objc incluirán derechos de depuración durante la firma.
Etiquetas:changes_inputs
- Configuración predeterminada de
--ios_signing_cert_name=<a string>
: ver descripción -
Nombre del certificado que se usará para la firma de iOS. Si no la estableces, se recurrirá al perfil de aprovisionamiento. Puede ser la preferencia de identidad del llavero del certificado o (subcadena) del nombre común del certificado, según la página manual de la señal de código (SIGNING IDENTITIES).
Etiquetas:action_command_lines
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE.:
- El valor predeterminado de
--[no]incompatible_disallow_legacy_py_provider
es "true" (verdadero). -
No-ops, se quitará pronto.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones que determinan el comportamiento del entorno de pruebas o del ejecutor de pruebas:
--[no]allow_analysis_failures
valor predeterminado: "false"-
Si es verdadero, una falla de análisis de un destino de regla provocará la propagación del objetivo de una instancia de AnalysisFailureInfo que contiene la descripción del error, en lugar de una falla de compilación.
Etiquetas:loading_and_analysis
,experimental
--analysis_testing_deps_limit=<an integer>
predeterminado: "2000"-
Establece la cantidad máxima de dependencias transitivas mediante un atributo de regla con una transición de configuración for_analysis_testing. Si se supera ese límite, se mostrará un error de regla.
Etiquetas:loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure
valor predeterminado: "false"-
Si se producen errores reales en la acción de dex2oat, la compilación falla en lugar de ejecutar dex2oat durante el tiempo de ejecución de la prueba.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_android_use_parallel_dex2oat
valor predeterminado: "false"-
Usa dex2oat en paralelo para, quizás, acelerar android_test.
Etiquetas:loading_and_analysis
,host_machine_resource_optimizations
,experimental
--[no]ios_memleaks
valor predeterminado: "false"-
Habilita la comprobación de fugas de memoria en los destinos ios_test.
Etiquetas:action_command_lines
- Configuración predeterminada de
--ios_simulator_device=<a string>
: ver descripción -
Es el dispositivo que se simula cuando se ejecuta una aplicación para iOS en el simulador, p.ej., "iPhone 6". Para obtener una lista de dispositivos, ejecuta “xcrun simctl list devicetypes” en la máquina en que se ejecutará el simulador.
Etiquetas:test_runner
- Configuración predeterminada de
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Es la versión de iOS que se ejecutará en el simulador cuando se ejecute o realice pruebas. Esto se ignora para las reglas ios_test si se especifica un dispositivo de destino en la regla.
Etiquetas:test_runner
- Se acumulan
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
usos múltiples - Especifica la cantidad de veces que se debe ejecutar cada prueba. Si alguno de esos intentos falla por algún motivo, toda la prueba se considerará fallida. Normalmente, el valor especificado es solo un número entero. Ejemplo: --runs_per_test=3 ejecutará todas las pruebas 3 veces. Sintaxis alternativa: regex_filter@runs_per_test. Donde run_per_test significa un valor de número entero y regex_filter significa una lista de patrones de expresiones regulares de inclusión y exclusión (también consulta --instrumentation_filter). Ejemplo: --runs_per_test=//foo/.*,-//foo/bar/.*@3 ejecuta todas las pruebas en //foo/ excepto las que se encuentran en foo/bar tres veces. Esta opción se puede aprobar varias veces. El último argumento pasado que coincida tendrá prioridad. Si no hay coincidencia, la prueba se ejecuta solo una vez.
- Se acumulan
--test_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica variables de entorno adicionales que se insertarán en el entorno del ejecutor de pruebas. Las variables se pueden especificar por nombre, en cuyo caso su valor se leerá desde el entorno del cliente de Bazel o mediante el par nombre=valor. Esta opción se puede usar varias veces para especificar distintas variables. Solo lo usa el comando “bazel test”.
Etiquetas:test_runner
--test_timeout=<a single integer or comma-separated list of 4 integers>
valor predeterminado: "-1"- Anula los valores predeterminados de tiempo de espera de la prueba (en segundos). Si se especifica un solo valor entero positivo, se anularán todas las categorías. Si se especifican 4 números enteros separados por comas, estos anularán los tiempos de espera: corto, moderado, largo y eterno (en ese orden). En cualquier forma, un valor de -1 le indica a blaze que use sus tiempos de espera predeterminados para esa categoría.
- Configuración predeterminada de
--tvos_simulator_device=<a string>
: ver descripción -
Es el dispositivo que se simula cuando se ejecuta una aplicación de 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 que se ejecutará el simulador.
Etiquetas:test_runner
- Configuración predeterminada de
--tvos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Es la versión de tvOS que se ejecutará en el simulador cuando se ejecute o realice pruebas.
Etiquetas:test_runner
- Configuración predeterminada de
--watchos_simulator_device=<a string>
: ver descripción -
Es el dispositivo que se simula cuando se ejecuta una aplicación de 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 que se ejecutará el simulador.
Etiquetas:test_runner
- Configuración predeterminada de
--watchos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Es la versión de watchOS que se ejecutará en el simulador cuando se ejecute o realice pruebas.
Etiquetas:test_runner
- El valor predeterminado de
--[no]zip_undeclared_test_outputs
es "true" (verdadero). -
Si es verdadero, los resultados de pruebas no declarados se archivarán en un archivo ZIP.
Etiquetas:test_runner
- Opciones relacionadas con el resultado y la semántica de la consulta:
- El valor predeterminado de
--aspect_deps=<off, conservative or precise>
es "conservador". -
Cómo resolver dependencias de aspecto cuando el formato de salida es {xml,proto,record}. “desactivado” significa que no se resuelven las dependencias de aspecto, “conservadora” (el valor predeterminado) significa que se agregan todas las dependencias de aspecto declaradas sin importar si se les otorga la clase de regla de las dependencias directas. “preciso” significa que solo se agregan esos aspectos que posiblemente estén activos dada la clase de regla de las dependencias directas. Ten en cuenta que el modo preciso requiere cargar otros paquetes para evaluar un solo objetivo, por lo que es más lento que los otros modos. Además, ten en cuenta que incluso el modo preciso no es del todo preciso: la decisión de calcular un aspecto se decide en la fase de análisis, que no se ejecuta durante la “consulta de Bazel”.
Etiquetas:build_file_semantics
--[no]consistent_labels
valor predeterminado: "false"-
Si se habilita, cada comando de consulta emite etiquetas como si lo hiciera la función <code>str</code> de Starlark aplicada a una instancia de <code>etiqueta</code>. Esto es útil para las herramientas que necesitan hacer coincidir el resultado de diferentes comandos de consulta o etiquetas emitidas por reglas. Si no están habilitados, los formateadores de salida tienen la libertad de emitir nombres de repositorio aparentes (en relación con el repositorio principal) para que los resultados sean más legibles.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]deduplicate_depsets
es "true" (verdadero). -
Anula el duplicado de los elementos secundarios que no sean de hoja de un dep_set_of_files en el resultado final de proto/textproto/json. De esta manera, no se anulan las configuraciones duplicadas que no comparten un elemento superior inmediato. Esto no afecta la lista final efectiva de artefactos de entrada de las acciones.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]graph:factored
es "true" (verdadero). -
Si es "true", el gráfico se emitirá "factorizado", es decir, los nodos equivalentes topológicamente se combinarán y sus etiquetas se concatenarán. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--graph:node_limit=<an integer>
predeterminado: "512"-
La longitud máxima de la string de etiqueta para un nodo del gráfico en el resultado. Las etiquetas más largas se truncarán; -1 significa que no hay truncamiento. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]implicit_deps
es "true" (verdadero). -
Si se habilita, las dependencias implícitas se incluirán en el gráfico de dependencias en el que opera la consulta. Una dependencia implícita es aquella que no se especifica de forma explícita en el archivo BUILD, sino que Bazel la agrega. En el caso de cquery, esta opción controla el filtrado de cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
- El valor predeterminado de
--[no]include_artifacts
es "true" (verdadero). -
Incluye los nombres de las entradas y salidas de acción en la salida (posiblemente grande).
Etiquetas:terminal_output
- El valor predeterminado de
--[no]include_aspects
es "true" (verdadero). -
aquery, cquery: si se deben incluir acciones generadas por el aspecto en el resultado. query: no-op (siempre se siguen los aspectos).
Etiquetas:terminal_output
- El valor predeterminado de
--[no]include_commandline
es "true" (verdadero). -
Incluye el contenido de las líneas de comandos de acción en el resultado (posiblemente grande).
Etiquetas:terminal_output
--[no]include_file_write_contents
valor predeterminado: "false"-
Incluye el contenido del archivo para las acciones FileWrite y SourceSymlinkManifest (posiblemente grandes).
Etiquetas:terminal_output
--[no]include_param_files
valor predeterminado: "false"-
Incluye el contenido de los archivos de parámetros que se usaron en el comando (posiblemente grandes). Nota: Habilitar esta marca habilitará automáticamente la marca --include_commandline.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]incompatible_display_source_file_location
es "true" (verdadero). -
De forma predeterminada, 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 fines de migración.
Etiquetas:terminal_output
,incompatible_change
- El valor predeterminado de
--[no]incompatible_package_group_includes_double_slash
es "true" (verdadero). -
Si se habilita, cuando se genere el atributo `packages` de package_group, no se omitirá el signo `//` inicial.
Etiquetas:terminal_output
,incompatible_change
--[no]infer_universe_scope
valor predeterminado: "false"-
Si se configura y --universe_scope no se establece, se inferirá un valor de --universe_scope como la lista de patrones de objetivo únicos en la expresión de consulta. Ten en cuenta que el valor de --universe_scope que se infiere para una expresión de consulta que utiliza funciones con alcance universal (p.ej., `allrdeps`) puede no ser lo que quieres, por lo que solo debes usar esta opción si sabes lo que estás haciendo. Consulta https://bazel.build/reference/query#sky-query para obtener detalles y ejemplos. Si se configura --universe_scope, se ignora el valor de esta opción. Nota: Esta opción solo se aplica a “consulta” (es decir, no a “cquery”).
Etiquetas:loading_and_analysis
--[no]line_terminator_null
valor predeterminado: "false"-
Indica si cada formato termina con \0 en lugar de una línea nueva.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]nodep_deps
es "true" (verdadero). -
Si se habilita, las dependencias de los atributos “nodep” se incluirán en el gráfico de dependencias en el que opera la consulta. Un ejemplo común de un atributo “nodep” es la “visibilidad”. Ejecuta y analiza el resultado de `info build-language` para conocer todos los atributos “nodep” en el lenguaje de compilación.
Etiquetas:build_file_semantics
--output=<a string>
predeterminado: "text"-
Formato en el que se deben imprimir los resultados de una consulta. Los valores permitidos para una consulta son los siguientes: text, textproto, proto, jsonproto.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]proto:default_values
es "true" (verdadero). -
Si el valor es "true", se incluyen los atributos cuyo valor no se especifica de forma explícita en el archivo BUILD. De lo contrario, se omiten. Esta opción se aplica a --output=proto
Etiquetas:terminal_output
--[no]proto:definition_stack
valor predeterminado: "false"-
Propaga el campo proto define_stack que registra, para cada instancia de regla, la pila de llamadas de Starlark en el momento en que se definió la clase de la regla.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]proto:flatten_selects
es "true" (verdadero). -
Si se habilita, se compactan los atributos configurables creados por select(). Para los tipos de lista, la representación plana es una lista que contiene cada valor del mapa de selección exactamente una vez. Los tipos escalares se acoplan a nulos.
Etiquetas:build_file_semantics
--[no]proto:include_synthetic_attribute_hash
valor predeterminado: "false"-
Indica si se debe calcular y propagar el atributo $internal_attr_hash o no.
Etiquetas:terminal_output
--[no]proto:instantiation_stack
valor predeterminado: "false"-
Propaga la pila de llamadas de creación de instancias de cada regla. Ten en cuenta que esto requiere que la pila esté presente
Etiquetas:terminal_output
- El valor predeterminado de
--[no]proto:locations
es "true" (verdadero). - Indica si se debe generar información de ubicación en el resultado de proto.
Etiquetas:terminal_output
- La configuración predeterminada de
--proto:output_rule_attrs=<comma-separated list of options>
es "todos" -
Lista de atributos separados por comas para incluir en el resultado. La configuración predeterminada es todos los atributos. Se establece como una cadena vacía para no generar ningún atributo. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]proto:rule_inputs_and_outputs
es "true" (verdadero). -
Indica si se deben propagar los campos rule_input y rule_output o no.
Etiquetas:terminal_output
--query_file=<a string>
predeterminado: ""-
Si se configura, la consulta leerá la consulta desde el archivo que se menciona aquí, en lugar de hacerlo desde la línea de comandos. Es un error especificar un archivo aquí, así como una consulta de línea de comandos.
Etiquetas:changes_inputs
--[no]relative_locations
valor predeterminado: "false"-
Si es "true", la ubicación de los archivos BUILD en los resultados xml y proto será relativa. De forma predeterminada, el resultado de la ubicación es una ruta de acceso absoluta y no será coherente en todas las máquinas. Puedes configurar esta opción como verdadera para obtener un resultado coherente en todas las máquinas.
Etiquetas:terminal_output
--[no]skyframe_state
valor predeterminado: "false"-
Sin realizar un análisis adicional, vuelca el Action Graph actual de Skyframe. Nota: Actualmente, no se admite especificar un destino con --skyframe_state. Esta marca solo está disponible con --output=proto o --output=textproto.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]tool_deps
es "true" (verdadero). -
Consulta: Si se inhabilita, las dependencias de los objetivos de “configuración del host” o “ejecución” no se incluirán en el gráfico de dependencias en el que opera la consulta. Un perímetro de dependencia de 'host configuration', como el de cualquier regla 'proto_library' al compilador de protocolos, generalmente apunta a una herramienta ejecutada durante la compilación en lugar de a una parte del mismo programa 'target'.
Cquery: Si se inhabilita, filtra todos los destinos configurados que cruzan un host o una transición de ejecución del objetivo de nivel superior que descubrió este objetivo configurado. Esto significa que si el objetivo de nivel superior está en la configuración de destino, solo se mostrarán los objetivos configurados también en esa configuración. Si el objetivo de nivel superior se encuentra en la configuración del host, solo se mostrarán los destinos configurados de host. Esta opción NO excluirá las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
--universe_scope=<comma-separated list of options>
predeterminado: ""-
Un conjunto de patrones de objetivo separados por comas (aditivos y sustractivos). La consulta se puede realizar en el universo definido por el cierre transitivo de los destinos especificados. Esta opción se usa para los comandos query y cquery.
Para cquery, la entrada a esta opción son los destinos en los que se compilan todas las respuestas, por lo que esta opción puede afectar las configuraciones y las transiciones. Si no se especifica esta opción, se supone que los destinos de nivel superior son los destinos analizados a partir de la expresión de consulta. Nota: En el caso de cquery, no especificar esta opción puede provocar que la compilación falle si los objetivos analizados a partir de la expresión de consulta no se pueden compilar con opciones de nivel superior.
Etiquetas:loading_and_analysis
- Opciones que activan optimizaciones del tiempo de compilación:
--[no]collapse_duplicate_defines
valor predeterminado: "false"-
Cuando se habilita, el atributo redundante --define se quitará 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
valor predeterminado: "false"-
Filtra ProgramJar de ProGuard para quitar cualquier clase que también esté presente en LibraryJar.
Etiquetas:action_command_lines
- El valor predeterminado de
--[no]experimental_inmemory_dotd_files
es "true" (verdadero). -
Si se habilita, los archivos .d de C++ se pasarán directamente en la memoria desde los nodos de compilación remota, en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
yexperimental
- El valor predeterminado de
--[no]experimental_inmemory_jdeps_files
es "true" (verdadero). -
Si se habilita esta opción, los archivos de dependencia (.jdeps) generados a partir de compilaciones de Java se pasarán directamente a la memoria desde los nodos de compilación remota, en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
yexperimental
--[no]experimental_objc_include_scanning
valor predeterminado: "false"-
Indica si se debe realizar o no un análisis para el objetivo C/C++.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
--[no]experimental_parse_headers_skipped_if_corresponding_srcs_found
valor predeterminado: "false"-
Si se habilita, la función analyze_headers no crea una acción de compilación de encabezado independiente si se encuentra una fuente con el mismo nombre base en el mismo destino.
Etiquetas:loading_and_analysis
,affects_outputs
--[no]experimental_retain_test_configuration_across_testonly
valor predeterminado: "false"-
Cuando se habilita, --trim_test_configuration no recortará la configuración de prueba de las reglas marcadas como testonly=1. Esto tiene como objetivo reducir los problemas de conflicto de acciones cuando las reglas que no son de prueba dependen de las reglas cc_test. No tiene efecto si --trim_test_configuration es falso.
Etiquetas:loading_and_analysis
,loses_incremental_state
--[no]experimental_starlark_cc_import
valor predeterminado: "false"-
Si se habilita, se puede usar la versión de cc_import de Starlark.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_unsupported_and_brittle_include_scanning
valor predeterminado: "false"-
Determina si se deben reducir las entradas a la compilación de C/C++ analizando #include líneas de los archivos de entrada. Esto puede mejorar el rendimiento y la incrementalidad disminuyendo el tamaño de los árboles de entrada de la compilación. Sin embargo, también puede romper compilaciones porque el escáner de inclusión no implementa por completo la semántica del preprocesador de C. En particular, no comprende las directivas #include dinámicas e ignora la lógica condicional del preprocesador. Úsala bajo tu propia responsabilidad. Se cerrarán todos los problemas relacionados con esta marca que se presenten.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
- El valor predeterminado de
--[no]incremental_dexing
es "true" (verdadero). -
Realiza la mayor parte del trabajo para la conversión a DEX por separado para cada archivo Jar.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- El valor predeterminado de
--[no]objc_use_dotd_pruning
es "true" (verdadero). -
Si se configura, se usarán los archivos .d emitidos por Clang para reducir el conjunto de entradas que se pasaron a compilaciones de objc.
Etiquetas:changes_inputs
,loading_and_analysis
--[no]process_headers_in_dependencies
valor predeterminado: "false"-
Cuando compilas un destino //a:a, procesa los encabezados en todos los destinos de los que depende //a:a (si el procesamiento de encabezados está habilitado para la cadena de herramientas).
Etiquetas:execution
- El valor predeterminado de
--[no]trim_test_configuration
es "true" (verdadero). -
Cuando se habilita, las opciones relacionadas con pruebas se borrarán en el nivel superior de la compilación. Cuando esta marca está activa, las pruebas no se pueden compilar como dependencias de reglas que no sean de prueba, pero los cambios en las opciones relacionadas con pruebas no provocarán que las reglas que no son de prueba se vuelvan a analizar.
Etiquetas:loading_and_analysis
,loses_incremental_state
- El valor predeterminado de
--[no]use_singlejar_apkbuilder
es "true" (verdadero). -
Esta opción ya no está disponible. Ahora no es una función y se quitará pronto.
Etiquetas:loading_and_analysis
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
predeterminado: "-.*"-
Imprime información de depuración durante la resolución de la cadena de herramientas. La marca toma una regex, que se compara con tipos de cadenas de herramientas y objetivos específicos para ver cuál depurar. Varias regex se pueden separar por comas y, luego, cada regex se verifica por separado. Nota: El resultado de esta marca es muy complejo y probablemente solo sea útil para los expertos en la resolución de la cadena de herramientas.
Etiquetas:terminal_output
- Opciones que especifican o modifican una entrada genérica a un comando de Bazel que no se incluye en otras categorías:
- Se acumulan
--flag_alias=<a 'name=value' flag alias>
usos múltiples - Establece un nombre abreviado para una marca de Starlark. Toma un solo par clave-valor con el formato "<key>=<value>" como argumento.
Etiquetas:changes_inputs
--[no]incompatible_default_to_explicit_init_py
valor predeterminado: "false"-
Esta marca cambia el comportamiento predeterminado para que los archivos __init__.py ya no se creen automáticamente en los archivos de ejecución de los destinos de Python. De manera precisa, cuando un destino py_binary o py_test tiene legacy_create_init configurado como "auto" (predeterminado), se trata como falso si y solo si esta marca está configurada. Consulta https://github.com/bazelbuild/bazel/issues/10076.
Etiquetas:affects_outputs
,incompatible_change
- El valor predeterminado de
--[no]incompatible_py2_outputs_are_suffixed
es "true" (verdadero). -
Si es verdadero, los destinos compilados en la configuración de Python 2 aparecerán bajo una raíz de salida que incluye el sufijo “-py2”, mientras que los destinos compilados para Python 3 aparecerán en una raíz sin sufijo relacionado con Python. Esto significa que el symlink de conveniencia `bazel-bin` apuntará a los destinos de Python 3 en lugar de Python 2. Si habilitas esta opción, también se recomienda habilitar `--incompatible_py3_is_default`.
Etiquetas:affects_outputs
,incompatible_change
- El valor predeterminado de
--[no]incompatible_py3_is_default
es "true" (verdadero). -
Si el valor es true, los destinos `py_binary` y `py_test` que no establecen su atributo `python_version` (o `default_python_version`) se establecerán de forma predeterminada como PY3 en lugar de PY2. Si estableces esta marca, también se recomienda configurar `--incompatible_py2_outputs_are_sufsolution`.
Etiquetas:loading_and_analysis
,affects_outputs
,incompatible_change
- El valor predeterminado de
--[no]incompatible_use_python_toolchains
es "true" (verdadero). -
Si se configura como verdadera, las reglas nativas ejecutables de Python usarán el entorno de ejecución de Python especificado por la cadena de herramientas de Python, en lugar del entorno de ejecución proporcionado por marcas heredadas como --python_top.
Etiquetas:loading_and_analysis
,incompatible_change
- Configuración predeterminada de
--python_version=<PY2 or PY3>
: ver descripción -
Es el modo de versión principal de Python, que puede ser “PY2” o “PY3”. Ten en cuenta que los objetivos “py_binary” y “py_test” anulan esto (incluso si no especifican explícitamente una versión), por lo que, por lo general, no hay muchas razones para proporcionar esta marca.
Etiquetas:loading_and_analysis
,affects_outputs
,explicit_in_output_path
- Opciones varias, que no están categorizadas de otra manera:
--[no]cache_test_results
[-t
] predeterminado: "auto"- Si se configura como "auto", Bazel vuelve a ejecutar una prueba solo si (1) Bazel detecta cambios en la prueba o sus dependencias, (2) la prueba se marca como externa, (3) se solicitaron varias ejecuciones de prueba con --runs_per_test o(4) si la prueba falló anteriormente. Si se configura como “sí”, Bazel almacena en caché todos los resultados de la prueba, excepto las que se marcaron como externas. Si se configura como “no”, Bazel no almacena en caché ningún resultado de prueba.
--[no]experimental_cancel_concurrent_tests
valor predeterminado: "false"-
Si es "true", el Blaze cancelará las pruebas que se ejecutan de forma simultánea en la primera ejecución exitosa. Esto solo es útil en combinación con --runs_per_test_detects_flakes.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_fetch_all_coverage_outputs
valor predeterminado: "false"-
Si es verdadero, Bazel recupera todo el directorio de datos de cobertura para cada prueba durante una ejecución de cobertura.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_generate_llvm_lcov
valor predeterminado: "false"-
Si es "true", la cobertura de Clang generará un informe de LCOV.
Etiquetas:affects_outputs
,loading_and_analysis
- El valor predeterminado de
--[no]experimental_j2objc_header_map
es "true" (verdadero). - Indica si se debe generar el mapa de encabezados de J2ObjC en paralelo de la transpilación de J2ObjC.
--[no]experimental_j2objc_shorter_header_path
valor predeterminado: "false"-
Indica si se debe generar con una ruta de encabezado más corta (usa "_ios" en lugar de "_j2objc").
Etiquetas:affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
predeterminado: "javabuilder"- Habilita rutas de clase reducidas para compilaciones de Java.
--[no]experimental_limit_android_lint_to_android_constrained_java
valor predeterminado: "false"- Limita --experimental_run_android_lint_on_java_rules a bibliotecas compatibles con Android.
Etiquetas:affects_outputs
--[no]experimental_run_android_lint_on_java_rules
valor predeterminado: "false"- Determina si se deben validar las fuentes java_*.
Etiquetas:affects_outputs
--[no]explicit_java_test_deps
valor predeterminado: "false"- Especifica de forma explícita una dependencia a JUnit o Hamcrest en una java_test, en lugar de obtenerla accidentalmente desde las dependencias de TestRunner. Por el momento, solo funciona para Bazel.
- Configuración predeterminada de
--host_java_launcher=<a build target label>
: ver descripción - El Selector de Java utilizado por las herramientas que se ejecutan durante una compilación.
- Se acumulan
--host_javacopt=<a string>
usos múltiples - Son opciones adicionales para pasar a javac cuando se compilan herramientas que se ejecutan durante una compilación.
- Se acumulan
--host_jvmopt=<a string>
usos múltiples - Opciones adicionales para pasar a la VM de Java cuando se compilan herramientas que se ejecutan durante la compilación. Estas opciones se agregarán a las opciones de inicio de la VM de cada destino java_binary.
--[no]incompatible_check_sharding_support
valor predeterminado: "false"-
Si es verdadero, Bazel fallará una prueba fragmentada si el ejecutor de pruebas no indica que admite la fragmentación tocando el archivo en la ruta de acceso en TEST_SHARD_STATUS_FILE. Si es falso, un ejecutor de pruebas que no admita la fragmentación hará que se ejecuten todas las pruebas en cada fragmento.
Etiquetas:incompatible_change
--[no]incompatible_exclusive_test_sandboxed
valor predeterminado: "false"-
Si es verdadero, se ejecutarán pruebas exclusivas con la estrategia de zona de pruebas. Agrega la etiqueta “local” para forzar una ejecución de prueba exclusiva de forma local.
Etiquetas:incompatible_change
--[no]incompatible_strict_action_env
valor predeterminado: "false"-
Si es verdadero, Bazel usa un entorno con un valor estático para PATH y no hereda LD_LIBRARY_PATH. Usa --action_env=ENV_VARIABLE si deseas heredar variables de entorno específicas del cliente, pero ten en cuenta que esto puede evitar el almacenamiento en caché entre usuarios si se usa una caché compartida.
Etiquetas:loading_and_analysis
,incompatible_change
- Se acumulan
--j2objc_translation_flags=<comma-separated list of options>
usos múltiples - Opciones adicionales para pasar a la herramienta J2ObjC.
--java_debug
-
Hace que la máquina virtual Java de una prueba de Java espere una conexión de un depurador compatible con JDWP (como jdb) antes de comenzar la prueba. Insinúa -test_output=streamed.
Se expande a:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
- El valor predeterminado de
--[no]java_deps
es "true" (verdadero). - Genera información de dependencias (por ahora, la ruta de clase en tiempo de compilación) por destino de Java.
- El valor predeterminado de
--[no]java_header_compilation
es "true" (verdadero). - Compila ijars directamente desde la fuente.
--java_language_version=<a string>
predeterminado: "8"- La versión del lenguaje Java
- Configuración predeterminada de
--java_launcher=<a build target label>
: ver descripción - El Selector de Java que se usa cuando se compilan objetos binarios de Java. Si esta marca se establece en una cadena vacía, se usa el selector de JDK. El atributo "launcher" anula esta marca.
--java_runtime_version=<a string>
valor predeterminado: "local_jdk"- La versión del entorno de ejecución de Java
- Se acumulan
--javacopt=<a string>
usos múltiples - Opciones adicionales para pasar a javac.
- Se acumulan
--jvmopt=<a string>
usos múltiples - Opciones adicionales para pasar a la VM de Java. Estas opciones se agregarán a las opciones de inicio de la VM de cada destino java_binary.
- Configuración predeterminada de
--legacy_main_dex_list_generator=<a build target label>
: ver descripción - Especifica un objeto binario que se usará para generar la lista de clases que deben estar en el DEX principal cuando se compila multidex heredado.
- Se acumulan
--plugin=<a build target label>
usos múltiples - Complementos para usar en la compilación. Actualmente, funciona con java_plugin.
- Configuración predeterminada de
--proguard_top=<a build target label>
: ver descripción - Especifica qué versión de ProGuard se usará para quitar código cuando se compile un objeto binario de Java.
--proto_compiler=<a build target label>
predeterminado: "@bazel_tools//tools/proto:protoc"-
Es la etiqueta del compilador de protocolos.
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
predeterminado: "@bazel_tools//tools/proto:cc_toolchain"-
Etiqueta de proto_lang_toolchain(), que describe cómo compilar protos de C++
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
predeterminado: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"-
Etiqueta de proto_lang_toolchain(), que describe cómo compilar protos j2objc
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
valor predeterminado: "@bazel_tools//tools/proto:java_toolchain"-
Etiqueta de proto_lang_toolchain(), que describe cómo compilar protos de Java
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
valor predeterminado: "@bazel_tools//tools/proto:javalite_toolchain"-
Etiqueta de proto_lang_toolchain(), que describe cómo compilar protos de JavaLite
Etiquetas:affects_outputs
,loading_and_analysis
- Se acumulan
--protocopt=<a string>
usos múltiples -
Son opciones adicionales para pasar al compilador de protobuf.
Etiquetas:affects_outputs
--[no]runs_per_test_detects_flakes
valor predeterminado: "false"- Si es verdadero, cualquier fragmento en el que al menos una ejecución o un intento se complete y al menos uno falle tenga un estado FLAKY.
- Configuración predeterminada de
--shell_executable=<a path>
: ver descripción -
Ruta de acceso absoluta al shell ejecutable para que lo use Bazel. Si no se configura, pero la variable de entorno BAZEL_SH está configurada en la primera invocación de Bazel (que inicia un servidor de Bazel), Bazel la usa. Si no se establece ninguno, Bazel usa una ruta de acceso predeterminada hard-coded según el sistema operativo en el que se ejecuta (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, todos los demás: /bin/bash). Ten en cuenta que el uso de una shell que no es compatible con Bash puede provocar fallas de compilación o de tiempo de ejecución de los objetos binarios generados.
Etiquetas:loading_and_analysis
- Se acumulan
--test_arg=<a string>
usos múltiples - Especifica opciones y argumentos adicionales que se deben pasar al ejecutable de prueba. Se puede usar varias veces para especificar varios argumentos. Si se ejecutan varias pruebas, cada una recibirá argumentos idénticos. Solo lo usa el comando “bazel test”.
- Configuración predeterminada de
--test_filter=<a string>
: ver descripción - Especifica un filtro para reenviar al framework de pruebas. Se usa para limitar la ejecución de pruebas. Ten en cuenta que esto no afecta los destinos que se compilan.
--test_result_expiration=<an integer>
valor predeterminado: "-1"- Esta opción dejó de estar disponible y no tiene efecto.
--[no]test_runner_fail_fast
valor predeterminado: "false"- Reenvía la opción de falla rápida al ejecutor de pruebas. El ejecutor de pruebas debe detener la ejecución en la primera falla.
- Valor predeterminado de
--test_sharding_strategy=<explicit or disabled>
: "explícito" - Especifica una estrategia para la fragmentación de pruebas: "explícito" para usar solo la fragmentación si está presente el atributo de COMPILACIÓN "shard_count". “inhabilitado” para no usar nunca la fragmentación de pruebas.
--tool_java_language_version=<a string>
predeterminado: "8"- La versión del lenguaje Java que se usa para ejecutar las herramientas que se necesitan durante una compilación
--tool_java_runtime_version=<a string>
predeterminado: "remotejdk_11"- La versión del entorno de ejecución de Java que se usa para ejecutar herramientas durante la compilación
- El valor predeterminado de
--[no]use_ijars
es "true" (verdadero). - Si se habilita, esta opción hace que la compilación de Java use archivos jar de la interfaz. Esto dará como resultado una compilación incremental más rápida, pero los mensajes de error pueden ser diferentes.
Opciones de compilación
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Más lugares donde buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
valor predeterminado: "false"-
Si se configura, la caché del repositorio vinculará el archivo de forma fija en caso de un acierto de caché, en lugar de copiar. Esto sirve para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
valor predeterminado: "false"-
Si es verdadero, usa una string derivada de las URLs de descargas del repositorio como canonical_id si no se especifica. Esto provoca que un cambio en las URLs genere una nueva descarga incluso si la caché contiene una descarga con el mismo hash. Se puede usar para verificar que los cambios en la URL no den como resultado que la caché oculte los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
valor predeterminado: "false"-
Si se configura, no se permite la descarga de repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Usa este factor para escalar todos los tiempos de espera en las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que sean más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación en caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una string 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
valor predeterminado: "false"-
No realices la compilación, solo verifica si está actualizada. Si todos los destinos están actualizados, la compilación se completa de forma correcta. Si es necesario ejecutar algún paso, se informa un error y la compilación falla.
Etiquetas:execution
--dynamic_local_execution_delay=<an integer>
predeterminado: "1000"-
¿Cuántos milisegundos debe retrasarse la ejecución local si la ejecución remota fue más rápida durante una compilación al menos una vez?
Etiquetas:execution
,host_machine_resource_optimizations
- Se acumulan
--dynamic_local_strategy=<a '[name=]value1[,..,valueN]' assignment>
usos múltiples -
Son las estrategias locales que se deben usar para el uso mnemotécnico específico. Cuando se pasa "local" como valor mnemotécnico, se establece el valor predeterminado para los mnemotécnicos no especificados. Toma [mnemonic=]local_strategy[,local_strategy,...]
Etiquetas:execution
,host_machine_resource_optimizations
- Se acumulan
--dynamic_remote_strategy=<a '[name=]value1[,..,valueN]' assignment>
usos múltiples -
Son las estrategias remotas que se usarán para el valor mnemotécnico específico. Pasar "remote" como el valor mnemotécnico establece la configuración predeterminada para los elementos mnemotécnicos no especificados. Toma [mnemonic=]remote_strategy[,remote_strategy,...]
Etiquetas:execution
,host_machine_resource_optimizations
--experimental_docker_image=<a string>
predeterminado: ""-
Especifica un nombre de imagen de Docker (p. ej., “ubuntu:latest”) que se debería usar para ejecutar una acción de zona de pruebas cuando se use la estrategia de Docker. La acción en sí no tiene un atributo de imagen de contenedor en su remote_execution_properties en la descripción de la plataforma. El valor de esta marca se pasa literalmente a “docker run”, por lo que admite la misma sintaxis y los mismos mecanismos que Docker.
Etiquetas:execution
- El valor predeterminado de
--[no]experimental_docker_use_customized_images
es "true" (verdadero). -
Si está habilitada, inyecta el UID y GID del usuario actual en la imagen de Docker antes de usarla. Esto es obligatorio si tus compilaciones o pruebas dependen de que el usuario tenga un nombre y un directorio principal dentro del contenedor. Esta opción está activada de forma predeterminada, pero puedes inhabilitarla si la función de personalización automática de imágenes no funciona en tu caso o si sabes que no la necesitas.
Etiquetas:execution
- El valor predeterminado de
--[no]experimental_dynamic_exclude_tools
es "true" (verdadero). -
Cuando se configuran, los objetivos que se compilan "para la herramienta" no están sujetos a ejecución dinámica. Es muy poco probable que esos objetivos se creen de forma incremental y, por lo tanto, no vale la pena invertir ciclos locales en ellos.
Etiquetas:execution
,host_machine_resource_optimizations
--experimental_dynamic_local_load_factor=<a double>
predeterminado: "0"-
Controla cuánta carga de la ejecución dinámica se debe colocar en la máquina local. Esta marca ajusta la cantidad de acciones en la ejecución dinámica que programaremos de forma simultánea. Se basa en la cantidad de CPU que Blaze considera que está disponible y se puede controlar con la función experimental --local_cpu_resources.
Si esta marca es 0, todas las acciones se programan de forma local de inmediato. Si es > 0, la cantidad de acciones programadas de forma local está limitada por la cantidad de CPU disponibles. Si es inferior a 1, el factor de carga se usa para reducir la cantidad de acciones programadas localmente cuando la cantidad de acciones en espera para programarse es alta. Esto disminuye la carga en la máquina local en el caso de compilación limpio, en el que la máquina local no contribuye mucho.
Etiquetas:execution
,host_machine_resource_optimizations
--experimental_dynamic_slow_remote_time=<An immutable length of time.>
predeterminado: "0"-
Si es >0, el tiempo en que una acción ejecutada de forma dinámica solo debe ejecutarse de forma remota antes de que prioricemos su ejecución local para evitar tiempos de espera remotos. Es posible que se oculten algunos problemas en el sistema de ejecución remota. No actives esta función sin supervisar los problemas de ejecución remota.
Etiquetas:execution
,host_machine_resource_optimizations
--[no]experimental_enable_docker_sandbox
valor predeterminado: "false"- Habilita la zona de pruebas basada en Docker. Esta opción no tiene efecto si Docker no está instalado.
Etiquetas:execution
--experimental_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 el valor es 0, borra los árboles de la zona de pruebas tan pronto como se complete una acción (y se retrase la finalización de la acción). Si es mayor que cero, ejecuta la eliminación de esos tres en un grupo de subprocesos asíncrono que tenga tamaño 1 cuando la compilación esté en ejecución y aumente al tamaño especificado por esta marca cuando el servidor esté inactivo.
Etiquetas:host_machine_resource_optimizations
,execution
--experimental_sandboxfs_path=<a string>
valor predeterminado: "sandboxfs"-
Ruta de acceso al objeto binario sandboxfs que se usará cuando --experimental_use_sandboxfs sea verdadero. Si es un nombre simple, usa el primer objeto binario con ese nombre que se encuentra en la ruta de acceso (PATH).
Etiquetas:host_machine_resource_optimizations
,execution
- El valor predeterminado de
--[no]experimental_split_xml_generation
es "true" (verdadero). -
Si se configura esta marca y una acción de prueba no genera un archivo test.xml, Bazel usa una acción separada para generar un archivo test.xml ficticio que contenga el registro de prueba. De lo contrario, Bazel generará un archivo test.xml como parte de la acción de prueba.
Etiquetas:execution
--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 trabajadores inactivos, es posible que se cierren si el uso total de memoria de todos los trabajadores supera el límite.
Etiquetas:execution
,host_machine_resource_optimizations
--[no]experimental_use_hermetic_linux_sandbox
valor predeterminado: "false"-
Si se establece como verdadera, no actives la raíz, sino solo lo que se proporciona con sandbox_add_mount_pair. Los archivos de entrada se vincularán directamente a la zona de pruebas en lugar de se vincularán con un symlink desde la zona de pruebas. Si los archivos de entrada de acciones se encuentran en un sistema de archivos diferente del de la zona de pruebas, los archivos de entrada se copiarán en su lugar.
Etiquetas:execution
--[no]experimental_use_sandboxfs
valor predeterminado: "false"-
Usa sandboxfs para crear los directorios execroot de las acciones en lugar de compilar un árbol de symlink. Si la respuesta es “sí”, el objeto binario que proporciona --experimental_sandboxfs_path debe ser válido y corresponder a una versión compatible de sandboxfs. Si es "auto", es posible que el objeto binario falte o no sea compatible.
Etiquetas:host_machine_resource_optimizations
,execution
--[no]experimental_use_windows_sandbox
valor predeterminado: "false"- Usa la zona de pruebas de Windows para ejecutar acciones. Si la respuesta es "sí", el objeto binario que proporciona --experimental_windows_sandbox_path debe ser válido y corresponder a una versión compatible de sandboxfs. Si es "auto", es posible que el objeto binario falte o no sea compatible.
--experimental_windows_sandbox_path=<a string>
predeterminado: "BazelSandbox.exe"- Ruta de acceso al objeto binario de la zona de pruebas de Windows que se usará cuando --experimental_use_windows_sandbox sea verdadero. Si es un nombre simple, usa el primer objeto binario con ese nombre que se encuentra en la ruta de acceso (PATH).
--[no]experimental_worker_as_resource
valor predeterminado: "false"- Si se habilita, los trabajadores se adquieren como recursos de ResourceManager.
Etiquetas:execution
,host_machine_resource_optimizations
--[no]experimental_worker_cancellation
valor predeterminado: "false"-
Si se habilita, Bazel puede enviar solicitudes de cancelación a los trabajadores compatibles.
Etiquetas:execution
- El valor predeterminado de
--[no]experimental_worker_multiplex
es "true" (verdadero). -
Si se habilita, los trabajadores que admitan la función de multiplexación experimental usarán esa función.
Etiquetas:execution
,host_machine_resource_optimizations
--[no]experimental_worker_multiplex_sandboxing
valor predeterminado: "false"-
Si se habilita, los trabajadores multiplex se someterán a una zona de pruebas y se usará un directorio de zona de pruebas independiente para cada solicitud de trabajo. Solo los trabajadores que tengan el requisito de ejecución “supports-multiplex-sandboxing” serán de zona de pruebas.
Etiquetas:execution
--[no]experimental_worker_strict_flagfiles
valor predeterminado: "false"-
Si se habilita, los argumentos de acciones para trabajadores que no sigan la especificación del trabajador causarán un error. Los argumentos de los trabajadores deben tener exactamente un argumento @flagfile como el último de su lista de argumentos.
Etiquetas:execution
--genrule_strategy=<comma-separated list of options>
predeterminado: ""-
Especifica cómo ejecutar genrules. Esta marca se eliminará gradualmente. En su lugar, usa --spawn_strategy=<value> para controlar todas las acciones o --strategy=Genrule=<value> para controlar solo genrules.
Etiquetas:execution
- Se acumulan
--high_priority_workers=<a string>
usos múltiples -
Mnemotécnicas de trabajadores que se deben ejecutar con prioridad alta. Cuando los trabajadores de alta prioridad se ejecutan, todos los demás trabajadores se limitan.
Etiquetas:execution
- El valor predeterminado de
--[no]incompatible_remote_dangling_symlinks
es "true" (verdadero). -
Si se configura como verdadero y --incompatible_remote_symlinks también es verdadero, los symlinks en las salidas de acción pueden colgarse.
Etiquetas:execution
,incompatible_change
- El valor predeterminado de
--[no]incompatible_remote_symlinks
es "true" (verdadero). -
Si se configura como verdadera, Bazel representará symlinks en los resultados de acción en el protocolo de ejecución/almacenamiento en caché remoto como tal. De lo contrario, se seguirán los symlinks y se representarán como archivos o directorios. Consulta #6631 para obtener más información.
Etiquetas:execution
,incompatible_change
--[no]incompatible_sandbox_hermetic_tmp
valor predeterminado: "false"-
Si se configura como verdadera, cada zona de pruebas de Linux tendrá su propio directorio vacío dedicado activado como /tmp en lugar de compartir /tmp con el sistema de archivos del host. Utiliza --sandbox_add_mount_pair=/tmp para seguir viendo el /tmp del host en todas las zonas de pruebas.
Etiquetas:execution
--[no]internal_spawn_scheduler
valor predeterminado: "false"-
Es una opción de marcador de posición para que podamos determinar en el Blaze si el programador de generación está habilitado.
Etiquetas:execution
,host_machine_resource_optimizations
--jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
[-j
] predeterminado: "auto"-
La cantidad de trabajos simultáneos que se ejecutarán. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguido de una operación ([-|*]<float>), p. ej., “auto”, “HOST_CPUS*.5”. Los valores deben estar entre 1 y 5,000. Los valores superiores a 2,500 pueden causar problemas de memoria. “auto” calcula un valor predeterminado razonable en función de los recursos del host.
Etiquetas:host_machine_resource_optimizations
,execution
--[no]keep_going
[-k
] predeterminado: "false"-
Continúa tanto como sea posible después de un error. Si bien el objetivo que falló y aquellos que dependen de él no se pueden analizar, otros requisitos previos de estos objetivos pueden serlo.
Etiquetas:eagerness_to_exit
- Valor predeterminado de
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "auto" -
Cantidad de subprocesos paralelos que se usarán en la fase de carga o análisis. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguido de una operación ([-|*]<float>), p. ej., “auto”, “HOST_CPUS*.5”. “auto” establece un valor predeterminado razonable según los recursos del host. Debe ser 1 como mínimo.
Etiquetas:bazel_internal_configuration
--[no]reuse_sandbox_directories
valor predeterminado: "false"-
Si se establece como verdadera, los directorios que utiliza la ejecución de entorno aislado que no son trabajadores se pueden volver a usar para evitar costos de configuración innecesarios.
Etiquetas:host_machine_resource_optimizations
,execution
--sandbox_base=<a string>
predeterminado: ""-
Permite que la zona de pruebas cree sus directorios de zona de pruebas debajo de esta ruta de acceso. Especifica una ruta de acceso en tmpfs (como /run/shm) para mejorar mucho el rendimiento cuando tus compilaciones y pruebas tengan muchos archivos de entrada. Nota: Necesitas suficiente RAM y espacio libre en los tmpfs para contener los archivos intermedios y de salida generados por la ejecución de acciones.
Etiquetas:host_machine_resource_optimizations
,execution
--[no]sandbox_explicit_pseudoterminal
valor predeterminado: "false"-
Habilita de forma explícita la creación de seudoterminales para acciones de zona de pruebas. Algunas distribuciones de Linux requieren configurar el ID de grupo del proceso en “tty” dentro de la zona de pruebas para que funcionen los pseudoterminales. Si esto está causando problemas, esta marca se puede inhabilitar para permitir que se usen otros grupos.
Etiquetas:execution
- Se acumulan
--sandbox_tmpfs_path=<an absolute path>
usos múltiples -
Para acciones de zona de pruebas, activa un directorio vacío que admita escritura en esta ruta de acceso absoluta (si la implementación de la zona de pruebas lo admite, se ignora de lo contrario).
Etiquetas:host_machine_resource_optimizations
,execution
--spawn_strategy=<comma-separated list of options>
predeterminado: ""- Especifica cómo se ejecutan las acciones de generación de forma predeterminada. Acepta una lista de estrategias separadas por comas de mayor a menor prioridad. Para cada acción, Bazel elige la estrategia con la prioridad más alta que puede ejecutar la acción. El valor predeterminado es “remote,worker,sandboxed,local”. Para obtener más información, consulta https://blog.bazel.build/2019/06/19/list-strategy.html.
Etiquetas:execution
- Se acumulan
--strategy=<a '[name=]value1[,..,valueN]' assignment>
usos múltiples -
Especifica cómo distribuir la compilación de otras acciones de generación. Acepta una lista de estrategias separadas por comas de mayor a menor prioridad. Para cada acción, Bazel elige la estrategia con la prioridad más alta que puede ejecutar la acción. El valor predeterminado es “remote,worker,sandboxed,local”. Esta marca anula los valores establecidos por --spawn_strategy (y --genrule_strategy si se utiliza con Genrule mnemónico). Para obtener más información, consulta https://blog.bazel.build/2019/06/19/list-strategy.html.
Etiquetas:execution
- Se acumulan
--strategy_regexp=<a '<RegexFilter>=value[,value]' assignment>
usos múltiples -
Anula la estrategia de generación que se debe usar para ejecutar acciones de generación que tengan descripciones que coincidan con un regex_filter determinado. Consulta --per_file_copt para obtener detalles sobre la coincidencia deregex_filter. Se usa el 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 que se deben ejecutar acciones con la estrategia local si sus descripciones coinciden con //foo.*.cc, pero no con //foo/bar. Ejemplo: --strategy_regexp='Compiling.*/bar=local --strategy_regexp=Compiling=sandboxed ejecutará "Compila //foo/bar/baz" con la estrategia "local", pero revertir el orden ejecutaría "sandboxed".
Etiquetas:execution
- Se acumulan
--worker_extra_flag=<a 'name=value' assignment>
usos múltiples -
Marcas de comandos adicionales que se pasarán a los procesos trabajadores, además de --persistent_worker, con claves mnemológicas (p.ej., --worker_extra_flag=Javac=--debug.
Etiquetas:execution
,host_machine_resource_optimizations
- Se acumulan
--worker_max_instances=<[name=]value, where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
usos múltiples -
Cuántas instancias de un proceso de trabajador (como el compilador de Java persistente) se pueden iniciar si usas la estrategia "worker". Se puede especificar como [name=value] para asignar un valor diferente por el valor mnemotécnico del trabajador. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguido de una operación ([-|*]<float>), p. ej., “auto”, “HOST_CPUS*.5”. “auto” calcula un valor predeterminado razonable en función de la capacidad de la máquina. "=value" establece un valor predeterminado para los mnemotécnicos no especificados.
Etiquetas:execution
,host_machine_resource_optimizations
- Se acumulan
--worker_max_multiplex_instances=<[name=]value, where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
usos múltiples -
La cantidad de WorkRequests que puede recibir un proceso de trabajador multiplex en paralelo si usas la estrategia "worker" con --experimental_worker_multiplex. Se puede especificar como [name=value] para asignar un valor diferente por el valor mnemotécnico del trabajador. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguido de una operación ([-|*]<float>), p. ej., “auto”, “HOST_CPUS*.5”. “auto” calcula un valor predeterminado razonable en función de la capacidad de la máquina. "=value" establece un valor predeterminado para los mnemotécnicos no especificados.
Etiquetas:execution
,host_machine_resource_optimizations
--[no]worker_quit_after_build
valor predeterminado: "false"-
Si se habilita, todos los trabajadores salen después de que se completa una compilación.
Etiquetas:execution
,host_machine_resource_optimizations
--[no]worker_sandboxing
valor predeterminado: "false"-
Si se habilita, los trabajadores se ejecutarán en un entorno de zona de pruebas.
Etiquetas:execution
--[no]worker_verbose
valor predeterminado: "false"- Si se habilita, muestra mensajes detallados cuando se inician los trabajadores, cierran, ...
- Opciones que configuran la cadena de herramientas usada para ejecutar la acción:
--[no]incompatible_disable_runtimes_filegroups
valor predeterminado: "false"-
No-op obsoleto.
Etiquetas:action_command_lines
,loading_and_analysis
,deprecated
,incompatible_change
- El valor predeterminado de
--[no]incompatible_dont_emit_static_libgcc
es "true" (verdadero). -
No-op obsoleto.
Etiquetas:action_command_lines
,loading_and_analysis
,deprecated
,incompatible_change
- El valor predeterminado de
--[no]incompatible_linkopts_in_user_link_flags
es "true" (verdadero). -
No-op obsoleto.
Etiquetas:action_command_lines
,loading_and_analysis
,deprecated
,incompatible_change
- Opciones que controlan el resultado del comando:
- El valor predeterminado de
--[no]build
es "true" (verdadero). -
Ejecuta la compilación; este es el comportamiento habitual. La especificación de --nobuild hace que la compilación se detenga antes de ejecutar las acciones de compilación y muestra cero si las fases de análisis y carga del paquete se completaron correctamente. Este modo es útil para probar esas fases.
Etiquetas:execution
,affects_outputs
- El valor predeterminado de
--[no]experimental_run_validations
es "true" (verdadero). -
En su lugar, usa --run_validations.
Etiquetas:execution
,affects_outputs
--[no]experimental_use_validation_aspect
valor predeterminado: "false"-
Determina si se deben ejecutar acciones de validación con el aspecto (para el paralelismo con pruebas).
Etiquetas:execution
,affects_outputs
- Se acumulan
--output_groups=<comma-separated list of options>
usos múltiples -
Una lista de nombres de grupos de salida separados por comas, cada uno de los cuales puede ir con el prefijo + o -. Un grupo con prefijo + se agrega al conjunto predeterminado de grupos de salida, mientras que uno con prefijo - se quita del conjunto predeterminado. Si al menos un grupo no tiene prefijo, se omite el conjunto predeterminado de grupos de salida. Por ejemplo, --output_groups=+foo,+bar compila la unión del conjunto predeterminado, foo y bar, mientras que --output_groups=foo,bar anula el conjunto predeterminado de modo que solo se compilen foo y bar.
Etiquetas:execution
,affects_outputs
- El valor predeterminado de
--[no]run_validations
es "true" (verdadero). -
Determina si se deben ejecutar acciones de validación como parte de la compilación. Consulta https://bazel.build/rules/rules#validation_actions
Etiquetas:execution
,affects_outputs
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
- Se acumulan
--aspects=<comma-separated list of options>
usos múltiples - Lista de aspectos separados por coma que se aplicarán a los objetivos de nivel superior. En la lista, si Aspecto some_aspect especifica los proveedores de aspecto requeridos mediante required_aspect_providers, some_aspect se ejecutará después de cada aspecto que se mencionó antes en la lista de aspectos cuyos proveedores anunciados satisfacen a algunos de los proveedores de aspecto requeridos. Además, some_aspect se ejecutará después de todos los aspectos obligatorios especificados por el atributo requirements. Luego, some_aspect tendrá acceso a los valores de los proveedores de esos aspectos. <bzl-file-label>%<aspect_name>, por ejemplo, “//tools:my_def.bzl%my_aspect”, donde “my_aspect” es un valor de nivel superior de un archivo tools/my_def.bzl
--bep_maximum_open_remote_upload_files=<an integer>
valor predeterminado: "-1"-
Cantidad máxima de archivos abiertos permitida durante la carga del artefacto BEP.
Etiquetas:affects_outputs
- El valor predeterminado de
--[no]experimental_convenience_symlinks
es "normal" -
Esta marca controla cómo se administrarán los symlinks de conveniencia (los que aparecen en el lugar de trabajo después de la compilación). Valores posibles: normal (predeterminado): Se creará o borrará cada tipo de symlink de conveniencia, según lo determine la compilación.
clean: Todos los symlinks se borrarán incondicionalmente.
ignorar: Los enlaces simbólicos no se verán afectados.
log_only: Genera mensajes de registro como si se pasaran “normales”, pero no realizas ninguna operación de sistema de archivos (útil para las herramientas).
Ten en cuenta que solo pueden verse afectados los symlinks cuyos nombres se generen por el valor actual de --symlink_prefix. Si el prefijo cambia, cualquier symlink preexistente quedará solo.
Etiquetas:affects_outputs
--[no]experimental_convenience_symlinks_bep_event
valor predeterminado: "false"-
Esta marca controla si publicaremos o no el evento de compilaciónConvenienceSymlinksIdentified en BuildEventProtocol. Si el valor es verdadero, BuildEventProtocol tendrá una entrada para convenienciaSymlinksIdentified y enumerará todos los symlinks de conveniencia creados en tu lugar de trabajo. Si es falso, la entrada convenienciaSymlinksIdentified en BuildEventProtocol estará vacía.
Etiquetas:affects_outputs
- Se acumulan
--experimental_multi_cpu=<comma-separated list of options>
usos múltiples -
Obsoleto. No-ops
Etiquetas:affects_outputs
,experimental
--remote_download_minimal
-
No descarga ningún resultado de compilación remota en la máquina local. Esta marca es un acceso directo 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
- La configuración predeterminada de
--remote_download_outputs=<all, minimal or toplevel>
es "todos" -
Si se configura como “mínima”, no se descarga ningún resultado de compilación remota en la máquina local, excepto los que requieren las acciones locales. Si se configura en “toplevel”, se comporta como “minimal”, excepto que también descarga los resultados de los destinos de nivel superior en la máquina local. Ambas opciones pueden reducir significativamente los tiempos de compilación si el ancho de banda de la red representa un cuello de botella.
Etiquetas:affects_outputs
--remote_download_symlink_template=<a string>
predeterminado: ""-
En lugar de descargar resultados de compilación remotas en la máquina local, crea vínculos simbólicos. El destino de los vínculos simbólicos puede especificarse con la forma de una cadena de plantilla. Esta string de plantilla puede contener {hash} y {size_bytes} que se expanden al hash del objeto y el tamaño en bytes, respectivamente. Estos vínculos simbólicos pueden apuntar, por ejemplo, a un sistema de archivos FUSE que cargue objetos de CAS a pedido.
Etiquetas:affects_outputs
--remote_download_toplevel
- Solo descarga las salidas remotas de los destinos de nivel superior en la máquina local. Esta marca es un acceso directo 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
- Configuración predeterminada de
--symlink_prefix=<a string>
: ver descripción -
Es el prefijo que se antepone a cualquiera de los symlinks de conveniencia que se crean después de una compilación. Si se omite, el valor predeterminado es el nombre de la herramienta de compilación seguido de un guion. Si se pasa “/”, no se crean symlinks ni se emite ninguna advertencia. Advertencia: La funcionalidad especial para “/” dejará de estar disponible pronto; en su lugar, usa --experimental_convenience_symlinks=ignore.
Etiquetas:affects_outputs
- Opciones que afectan la medida en la que Bazel aplica de manera estricta entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
--[no]experimental_docker_privileged
valor predeterminado: "false"-
Si se habilita, Bazel pasará la marca --privileged a “docker run” cuando se ejecuten acciones. Es posible que tu compilación lo requiera, pero también podría reducir la hermeticidad.
Etiquetas:execution
--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 hashes del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
--[no]experimental_sandboxfs_map_symlink_targets
valor predeterminado: "false"-
Si es verdadero, asigna a la zona de pruebas los objetivos de los vínculos simbólicos especificados como entradas de acción. Esta función existe exclusivamente como solución alternativa para reglas con errores 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
--experimental_verify_repository_rules=<a string>
usos múltiples -
Si es una lista de reglas de repositorio para las que se debe verificar el hash del directorio de salida, siempre que un archivo se especifique mediante --experimental_repository_hash_file.
Etiquetas:affects_outputs
,experimental
- El valor predeterminado de
--[no]incompatible_legacy_local_fallback
es "true" (verdadero). -
Si se configura como verdadera, se habilita el resguardo implícito heredado de la zona de pruebas a la estrategia local. Esta marca eventualmente se establecerá como falsa de forma predeterminada y luego se convertirá en una no-op. En su lugar, usa --strategy, --spawn_strategy o --dynamic_local_strategy para configurar resguardos.
Etiquetas:execution
,incompatible_change
- Se acumulan
--sandbox_add_mount_pair=<a single path or a 'source:target' pair>
usos múltiples -
Agrega un par de rutas de acceso adicional para activarlo en la zona de pruebas.
Etiquetas:execution
- Se acumulan
--sandbox_block_path=<a string>
usos múltiples -
En el caso de las acciones de zona de pruebas, inhabilita el acceso a esta ruta de acceso.
Etiquetas:execution
- El valor predeterminado de
--[no]sandbox_default_allow_network
es "true" (verdadero). - Permite el acceso a la red de forma predeterminada para las acciones. Es posible que esto no funcione con todas las implementaciones de zonas de pruebas.
--[no]sandbox_fake_hostname
valor predeterminado: "false"-
Cambia el nombre de host actual a “localhost” para acciones de la zona de pruebas.
Etiquetas:execution
--[no]sandbox_fake_username
valor predeterminado: "false"-
Cambia el nombre de usuario actual a "nadie" para realizar acciones en la zona de pruebas.
Etiquetas:execution
- Se acumulan
--sandbox_writable_path=<a string>
usos múltiples -
Para las acciones de la zona de pruebas, haz que un directorio existente se pueda escribir en ella (si la implementación de la zona de pruebas lo admite; de lo contrario, se debe ignorar).
Etiquetas:execution
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE.:
- El valor predeterminado de
--[no]experimental_allow_top_level_aspects_parameters
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,deprecated
,experimental
--[no]incompatible_config_setting_private_default_visibility
valor predeterminado: "false"-
Si es incompatible_enforce_config_setting_visibility=false, esta es una noop. De lo contrario, si la marca es falsa, cualquier config_setting sin un atributo de visibilidad explícito es //visibility:public. Si esta marca es verdadera, config_setting sigue la misma lógica de visibilidad que todas las demás reglas. Consulta https://github.com/bazelbuild/bazel/issues/12933.
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_enforce_config_setting_visibility
es "true" (verdadero). -
Si es verdadero, aplica restricciones de visibilidad config_setting. Si es falso, cada config_setting es visible para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones que determinan el comportamiento del entorno de pruebas o del ejecutor de pruebas:
--[no]check_tests_up_to_date
valor predeterminado: "false"-
No ejecutes pruebas. Solo tienes que comprobar si están actualizadas. Si todos los resultados están actualizados, las pruebas se completarán de forma correcta. Si es necesario compilar o ejecutar alguna prueba, se informa un error y falla la prueba. Esta opción implica el comportamiento de --check_up_to_date.
Etiquetas:execution
- Se acumulan
--flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once>
usos múltiples -
Cada prueba se volverá a intentar la cantidad especificada de veces, en caso de que falle. Las pruebas que requieren más de un intento para aprobarse se marcan como "FLAKY" en el resumen. Normalmente, el valor especificado es solo un número entero o la cadena "default". Si es un número entero, todas las pruebas se ejecutarán hasta N veces. Si la política es "default", se realizará un solo intento para las pruebas regulares y tres para las pruebas marcadas explícitamente como inestables por su regla (falta=1). Sintaxis alternativa: regex_filter@flaky_test_attempts. Donde flaky_test_attempts es lo anterior y regex_filter significa una lista de patrones de expresiones regulares de inclusión y exclusión (también consulta --runs_per_test). Ejemplo: --flaky_test_attempts=//foo/.*,-//foo/bar/.*@3 disminuye todas las pruebas de //foo/ excepto las que se encuentran en foo/bar tres veces. Esta opción se puede aprobar varias veces. El último argumento pasado que coincida tendrá prioridad. Si no hay coincidencia, el comportamiento es “default” arriba.
Etiquetas:execution
- Valor predeterminado de
--local_test_jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "auto" -
La cantidad máxima de trabajos de prueba locales que se ejecutan de forma simultánea. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguido de una operación ([-|*]<float>), p. ej., “auto”, “HOST_CPUS*.5”. 0 significa que los recursos locales limitarán la cantidad de trabajos de prueba locales para que se ejecuten simultáneamente. Establecer este parámetro como mayor que el valor de --jobs no es eficaz.
Etiquetas:execution
- El valor predeterminado de
--[no]test_keep_going
es "true" (verdadero). -
Cuando se inhabilita, cualquier prueba que no se apruebe hará que se detenga toda la compilación. De forma predeterminada, se ejecutan todas las pruebas, incluso si algunas no son exitosas.
Etiquetas:execution
--test_strategy=<a string>
predeterminado: ""-
Especifica qué estrategia usar cuando se ejecutan pruebas.
Etiquetas:execution
- Configuración predeterminada de
--test_tmpdir=<a path>
: ver descripción - Especifica el directorio temporal base que debe usar "bazel test".
- Opciones relacionadas con la semántica y el resultado de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Especificaste las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirá en el gráfico de dependencias resueltas incluso si se declararon de forma privada en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones anteriores harán que la resolución falle. También puedes definir la versión transferida permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
- El valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
es "error" -
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son “error” para derivarlo a una falla de resolución, “off” para inhabilitar la verificación o “warning” para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas `bazel_dep` declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son “off” para inhabilitar la verificación, “warning” para imprimir una advertencia cuando se detecte una discrepancia o “error” para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
valor predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- El valor predeterminado de
--lockfile_mode=<off, update or error>
es "desactivado" -
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son “update” para usar el archivo de bloqueo y actualizarlo si hay cambios; “error” para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o “off” para no leerlo ni escribirlo en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y se recurrirá únicamente a los posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]announce
valor predeterminado: "false"-
Obsoleto. No-ops
Etiquetas:affects_outputs
--[no]debug_spawn_scheduler
valor predeterminado: "false"--[no]experimental_bep_target_summary
valor predeterminado: "false"- Determina si se publican eventos de TargetSummary.
--[no]experimental_build_event_expand_filesets
valor predeterminado: "false"-
Si es verdadero, expande los conjuntos de archivos en el BEP cuando presentes los archivos de salida.
Etiquetas:affects_outputs
--[no]experimental_build_event_fully_resolve_fileset_symlinks
valor predeterminado: "false"-
Si es verdadero, resuelve por completo los symlinks del conjunto de archivos relativos en el BEP cuando se presentan los archivos de salida. Requiere --experimental_build_event_expand_filesets.
Etiquetas:affects_outputs
--experimental_build_event_upload_max_retries=<an integer>
predeterminado: "4"-
Es la cantidad máxima de veces que Bazel debe reintentar subir un evento de compilación.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
: "1 s" -
Retraso inicial y mínimo para los reintentos de retirada exponencial cuando falla la carga de BEP (exponente: 1.6)
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--experimental_build_event_upload_strategy=<a string>
: ver descripción -
Selecciona cómo subir los artefactos a los que se hace referencia en el protocolo de eventos de compilación.
Etiquetas:affects_outputs
- El valor predeterminado de
--[no]experimental_collect_local_sandbox_action_metrics
es "true" (verdadero). -
Cuando se habilita, se registran estadísticas de ejecución (como la hora del usuario y del sistema) para las acciones ejecutadas de forma local que usan la zona de pruebas
Etiquetas:execution
--[no]experimental_docker_verbose
valor predeterminado: "false"-
Si se habilita, Bazel imprimirá mensajes más detallados sobre la estrategia de zona de pruebas de Docker.
Etiquetas:execution
--[no]experimental_materialize_param_files_directly
valor predeterminado: "false"-
Si materializas archivos de parámetros, hazlo con escrituras directas en el disco.
Etiquetas:execution
--[no]experimental_record_metrics_for_all_mnemonics
valor predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán estadísticas para todos los mnemotécnicos.
--experimental_repository_resolved_file=<a string>
predeterminado: ""-
Si no está vacío, escribe un valor de Starlark con la información resuelta de todas las reglas del repositorio de Starlark que se ejecutaron.
Etiquetas:affects_outputs
--[no]experimental_stream_log_file_uploads
valor predeterminado: "false"-
Transmite las cargas de archivos de registro directamente al almacenamiento remoto en lugar de escribirlos en el disco.
Etiquetas:affects_outputs
- Configuración predeterminada de
--explain=<a path>
: ver descripción -
Hace que el sistema de compilación explique cada paso ejecutado de la compilación. La explicación se escribe en el archivo de registro especificado.
Etiquetas:affects_outputs
- El valor predeterminado de
--[no]legacy_important_outputs
es "true" (verdadero). -
Usa esta opción para suprimir la generación del campo relevant_outputs heredado en el evento TargetComplete. Para la integración de Bazel a ResultStore, se requiere relevant_outputs.
Etiquetas:affects_outputs
--[no]materialize_param_files
valor predeterminado: "false"-
Escribe archivos de parámetros intermedios para generar un árbol incluso cuando se usa la ejecución de acciones remotas. Es útil para depurar acciones. Esto está implícito por --subcommands y --verbose_failures.
Etiquetas:execution
--max_config_changes_to_show=<an integer>
predeterminado: "3"-
Cuando se descarta la caché de análisis debido a un cambio en las opciones de compilación, se muestra hasta la cantidad determinada de nombres de opciones modificados. Si el número asignado es -1, se mostrarán todas las opciones modificadas.
Etiquetas:terminal_output
--max_test_output_bytes=<an integer>
valor predeterminado: "-1"-
Especifica el tamaño máximo por registro de prueba que puede emitirse cuando --test_output es “errores” o “todos”. Es útil para evitar abrumar el resultado con un resultado de prueba demasiado ruidoso. El encabezado de prueba se incluye en el tamaño del registro. Los valores negativos implican que no hay límite. El resultado es todo o nada.
Etiquetas:test_runner
,terminal_output
,execution
- Configuración predeterminada de
--output_filter=<a valid Java regular expression>
: ver descripción -
Solo muestra advertencias para las reglas cuyo nombre coincida con la expresión regular proporcionada.
Etiquetas:affects_outputs
--progress_report_interval=<an integer in 0-3600 range>
predeterminado: "0"-
La cantidad de segundos que transcurren entre los informes de trabajos que aún se están ejecutando. El valor predeterminado 0 significa que el primer informe se imprimirá después de 10 segundos; luego, 30 segundos; después de ese progreso, se informa una vez por minuto. Cuando --curses está habilitado, el progreso se informa cada segundo.
Etiquetas:affects_outputs
- Valor predeterminado de
--remote_print_execution_messages=<failure, success or all>
: “error” -
Elige cuándo imprimir mensajes de ejecución remota. Los valores válidos son “failure”, para imprimir solo en caso de errores, “success” para imprimir solo en casos exitosos y “all” para imprimir siempre.
Etiquetas:terminal_output
--[no]sandbox_debug
valor predeterminado: "false"-
Habilita las funciones de depuración para la función de zona de pruebas. Esto incluye dos cosas: en primer lugar, el contenido raíz de la zona de pruebas no se modifica después de una compilación (y si sandboxfs está en uso, el sistema de archivos queda activado); y segundo, imprime información adicional de depuración durante la ejecución. Esto puede ayudar a los desarrolladores de reglas de Bazel o Starlark con fallas de depuración debido a archivos de entrada faltantes, etcétera.
Etiquetas:terminal_output
--show_result=<an integer>
predeterminado: "1"-
Muestra los resultados de la compilación. Para cada destino, indica si se actualizó o no y, de ser así, una lista de los archivos de salida que se crearon. Los archivos impresos son cadenas convenientes para copiar y pegar en la shell a fin de ejecutarlos.
Esta opción requiere un argumento de número entero, que es el umbral de objetivos por encima del cual no se imprime la información del resultado. Por lo tanto, cero provoca la supresión del mensaje y MAX_INT hace que la impresión del resultado ocurra siempre. El valor predeterminado es uno.
Etiquetas:affects_outputs
--[no]subcommands
[-s
] predeterminado: "false"-
Muestra los subcomandos que se ejecutaron durante una compilación. Marcas relacionadas: --execution_log_json_file, --execution_log_binary_file (para registrar subcomandos en un archivo en un formato compatible con herramientas).
Etiquetas:terminal_output
--test_output=<summary, errors, all or streamed>
valor predeterminado: "summary"-
Especifica el modo de salida deseado. Los valores válidos son “summary” para mostrar solo el resumen del estado de la prueba, “errors” para imprimir también los registros de prueba de las pruebas fallidas, “all” para imprimir los registros de todas las pruebas y “stream” para generar los registros de todas las pruebas en tiempo real (esto forzará a que las pruebas se ejecuten de forma local, una a la vez, sin importar el valor de --test_strategy).
Etiquetas:test_runner
,terminal_output
,execution
--test_summary=<short, terse, detailed, none or testcase>
valor predeterminado: "short"-
Especifica el formato deseado del resumen de la prueba. Los valores válidos son “corto” para imprimir información solo sobre las pruebas ejecutadas; “terse”, para imprimir solo información sobre las pruebas fallidas que se ejecutaron, “detallado” para imprimir información detallada sobre casos de prueba con errores, “caso de prueba” para imprimir el resumen en la resolución del caso de prueba, no imprimir información detallada sobre casos de prueba fallidos y “ninguno” para omitir el resumen.
Etiquetas:terminal_output
--[no]verbose_explanations
valor predeterminado: "false"-
Aumenta la verbosidad de las explicaciones emitidas si --explain está habilitado. No tiene ningún efecto si --explain no está habilitado.
Etiquetas:affects_outputs
--[no]verbose_failures
valor predeterminado: "false"-
Si un comando falla, imprime la línea de comandos completa.
Etiquetas:terminal_output
- Opciones que especifican o modifican una entrada genérica a un comando de Bazel que no se incluye en otras categorías:
- Se acumulan
--aspects_parameters=<a 'name=value' assignment>
usos múltiples -
Especifica los valores de los parámetros de aspectos de la línea de comandos. Cada valor del parámetro se especifica con <param_name>=<param_value>. Por ejemplo, 'my_param=my_val', donde 'my_param' es un parámetro de algún aspecto en la lista --aspects o lo requiere un aspecto de la lista. Esta opción se puede usar varias veces. Sin embargo, no se puede asignar valores al mismo parámetro más de una vez.
Etiquetas:loading_and_analysis
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE
Etiquetas:changes_inputs
--target_pattern_file=<a string>
predeterminado: ""-
Si se configura, la compilación leerá los patrones del archivo que se menciona aquí, en lugar de hacerlo en la línea de comandos. Es un error especificar un archivo aquí, así como patrones de la línea de comandos.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remoto:
- Configuración predeterminada de
--experimental_circuit_breaker_strategy=<failure>
: ver descripción -
Especifica la estrategia que usará el disyuntor. Las estrategias disponibles son el “fracaso”. Si el valor de la opción no es válido, no se establece el comportamiento de la opción.
Etiquetas:execution
- Configuración predeterminada de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo para configurar el cargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno con el que debe coincidir y otro para usar como URL sustitutiva, con referencias inversas que comienzan con "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL, y se mostrarán varias URL.
--[no]experimental_guard_against_concurrent_changes
valor predeterminado: "false"- Desactiva esta opción para inhabilitar la verificación de la hora de los archivos de entrada de una acción antes de subirla a una caché remota. Puede haber casos en los que el kernel de Linux retrasa la escritura de archivos, lo que podría causar falsos positivos.
- La configuración predeterminada de
--experimental_remote_build_event_upload=<all or minimal>
es "todos" - Si se configura como “all”, todas las salidas locales a las que hace referencia BEP se suben a la caché remota. Si se configura como “mínimo”, las salidas locales a las que hace referencia BEP no se suben a la caché remota, excepto los archivos que son importantes para los consumidores de BEP (p.ej., registros de prueba y perfil de sincronización). El esquema bytestream:// siempre se usa para el URI de los archivos, incluso si faltan de la caché remota. La configuración predeterminada es “all”.
--[no]experimental_remote_cache_async
valor predeterminado: "false"- Si es verdadero, la E/S de la caché remota se producirá en segundo plano, en lugar de tener lugar como parte de una generación.
--[no]experimental_remote_cache_compression
valor predeterminado: "false"- Si está habilitada, comprime o descomprime los BLOB de caché con zstd.
--experimental_remote_cache_eviction_retries=<an integer>
predeterminado: "0"-
La cantidad máxima de intentos de reintento si la compilación detectó un error de expulsión de caché remota. Un valor distinto de cero establecerá implícitamente --incompatible_remote_use_new_exit_code_for_lost_inputs como verdadero. Se generará un ID de invocación nuevo para cada intento. Si generas un ID de invocación y se lo proporcionas a Bazel con --invocation_id, no debes usar esta marca. En su lugar, establece la marca --incompatible_remote_use_new_exit_code_for_lost_inputs y verifica el código de salida 39.
Etiquetas:execution
- Configuración predeterminada de
--experimental_remote_capture_corrupted_outputs=<a path>
: ver descripción - Una ruta de acceso a un directorio en el que se capturarán los resultados dañados.
--[no]experimental_remote_discard_merkle_trees
valor predeterminado: "false"- Si se configura como verdadera, descarta las copias en memoria del árbol Merkle de la raíz de entrada y las asignaciones de entradas asociadas durante las llamadas a GetActionResult() y Execute(). Esta acción reduce el uso de memoria de forma significativa, pero requiere que Bazel vuelva a calcularlas ante errores y reintentos de la caché remota.
- Configuración predeterminada de
--experimental_remote_downloader=<a string>
: ver descripción - Un URI de extremo de la API de Remote Asset, que se usará como proxy de descarga remoto. Los esquemas compatibles son grpc, grpcs (grpc con TLS habilitada) y Unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel se establecerá de forma predeterminada en grpcs. Consulta: https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto
--[no]experimental_remote_downloader_local_fallback
valor predeterminado: "false"- Indica si se debe recurrir al cargador local si falla el cargador remoto.
--[no]experimental_remote_execution_keepalive
valor predeterminado: "false"- Indica si se debe usar keepalive para llamadas de ejecución remota.
--experimental_remote_failure_rate_threshold=<an integer in 0-100 range>
predeterminado: "10"-
Establece la cantidad permitida de tasa de fallas en un porcentaje para un período específico después del cual se deja de llamar al ejecutor o la caché remotos. El valor predeterminado es 10. Establecerlo en 0 significa que no existen limitaciones.
Etiquetas:execution
- Valor predeterminado de
--experimental_remote_failure_window_interval=<An immutable length of time.>
: "60s" -
El intervalo en el que se calcula la tasa de fallas de las solicitudes remotas. En un valor negativo o cero, la duración de la falla se calcula la duración total de la ejecución.Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
Etiquetas:execution
--[no]experimental_remote_mark_tool_inputs
valor predeterminado: "false"- Si se configura como verdadera, Bazel marcará las entradas como entradas de herramientas para el ejecutor remoto. Se puede usar para implementar trabajadores persistentes remotos.
--[no]experimental_remote_merkle_tree_cache
valor predeterminado: "false"- Si se establece como verdadera, se memorizarán los cálculos del árbol de Merkle para mejorar la velocidad de comprobación de aciertos de la caché remota. La huella de pie en la memoria de la caché se controla con --experimental_remote_merkle_tree_cache_size.
--experimental_remote_merkle_tree_cache_size=<a long integer>
predeterminado: "1000"- La cantidad de árboles de Merkle que se deben memorizar para mejorar la velocidad de verificación de aciertos de la caché remota. Aunque la caché se reduce automáticamente según el manejo de las referencias de software por parte de Java, pueden producirse errores de memoria insuficiente si la configuración es demasiado alta. Si se establece en 0, el tamaño de la caché es ilimitado. El valor óptimo varía según el tamaño del proyecto. La configuración predeterminada es 1,000.
--[no]experimental_remote_require_cached
valor predeterminado: "false"- Si se configura como verdadera, exige que todas las acciones que se pueden ejecutar de forma remota se almacenen en caché o, de lo contrario, falle la compilación. Esto es útil para solucionar problemas de no determinismo, ya que permite verificar si las acciones que deben almacenarse en caché realmente se almacenan en caché sin inyectar resultados nuevos en la caché de forma falsa.
--[no]incompatible_remote_build_event_upload_respect_no_cache
valor predeterminado: "false"- Si se configura como verdadera, los resultados a los que hace referencia BEP no se subirán a la caché remota si la acción que se genera no se puede almacenar en caché de manera remota.
- El valor predeterminado de
--[no]incompatible_remote_downloader_send_all_headers
es "true" (verdadero). -
Indica si se deben enviar todos los valores de un encabezado con varios valores al cargador remoto en lugar de solo el primero.
Etiquetas:incompatible_change
--[no]incompatible_remote_output_paths_relative_to_input_root
valor predeterminado: "false"-
Si se configura como verdadera, las rutas de salida están relacionadas con la raíz de entrada en lugar del directorio de trabajo.
Etiquetas:incompatible_change
- El valor predeterminado de
--[no]incompatible_remote_results_ignore_disk
es "true" (verdadero). -
Si se configura como verdadera, --noremote_upload_local_results y --noremote_Accept_cached no se aplicarán a la caché de 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_supported_cached hará que Bazel busque resultados en la caché del disco, pero no en la caché remota.
las acciones no-remote-exec pueden acceder a la caché del disco.
Consulta #8216 para obtener más información.
Etiquetas:incompatible_change
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
valor predeterminado: "false"-
Si se configura como verdadera, Bazel usará el nuevo código de salida 39 en lugar del 34 si la caché remota expulsa los BLOB durante la compilación.
Etiquetas:incompatible_change
- El valor predeterminado de
--[no]remote_accept_cached
es "true" (verdadero). - Indica si se aceptan resultados de acciones almacenados en caché de forma remota.
- Configuración predeterminada de
--remote_bytestream_uri_prefix=<a string>
: ver descripción - El nombre de host y el nombre de la instancia que se usarán en los URI bytestream:// que se escriben en transmisiones de eventos de compilación. Esta opción se puede configurar cuando las compilaciones se realizan con un proxy, lo que hace que los valores de --remote_executor y --remote_instance_name ya no correspondan con el nombre canónico del servicio de ejecución remota. Si no se establece, el valor predeterminado será “${hostname}/${instance_name}”.
- Configuración predeterminada de
--remote_cache=<a string>
: ver descripción - Un URI de un extremo de almacenamiento en caché. Los esquemas admitidos son http, https, grpc, grpcs (grpc con TLS habilitada) y Unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel se establecerá de forma predeterminada en grpcs. Especifica el esquema grpc://, http:// o Unix: para inhabilitar TLS. Consulta https://bazel.build/remote/caching
- Se acumulan
--remote_cache_header=<a 'name=value' assignment>
usos múltiples - Especifica un encabezado que se incluirá en las solicitudes de caché: --remote_cache_header=Name=Value. Se pueden pasar varios encabezados si se especifica la marca varias veces. Si hay varios valores con el mismo nombre, se convertirán en una lista separada por comas.
- Se acumulan
--remote_default_exec_properties=<a 'name=value' assignment>
usos múltiples -
Configura las propiedades de ejecución predeterminadas que se usarán como plataforma de ejecución remota si una plataforma de ejecución aún no configuró exec_properties.
Etiquetas:affects_outputs
--remote_default_platform_properties=<a string>
predeterminado: ""- Establece las propiedades de plataforma predeterminadas para la API de ejecución remota si la plataforma de ejecución aún no configuró remote_execution_properties. Este valor también se usará si se selecciona la plataforma host como la plataforma de ejecución para la ejecución remota.
- Se acumulan
--remote_downloader_header=<a 'name=value' assignment>
usos múltiples - Especifica un encabezado que se incluirá en las solicitudes de cargadores remotos: --remote_downloader_header=Name=Value. Se pueden pasar varios encabezados si se especifica la marca varias veces. Si hay varios valores con el mismo nombre, se convertirán en una lista separada por comas.
- Se acumulan
--remote_exec_header=<a 'name=value' assignment>
usos múltiples - Especifica un encabezado que se incluirá en las solicitudes de ejecución: --remote_exec_header=Name=Value. Se pueden pasar varios encabezados si se especifica la marca varias veces. Si hay varios valores con el mismo nombre, se convertirán en una lista separada por comas.
--remote_execution_priority=<an integer>
predeterminado: "0"- La prioridad relativa de las acciones que se ejecutarán de forma remota. La semántica de los valores de prioridad particulares depende del servidor.
- Configuración predeterminada de
--remote_executor=<a string>
: ver descripción - HOST o HOST:PORT de un extremo de ejecución remota. Los esquemas compatibles son grpc, grpcs (grpc con TLS habilitada) y Unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel se establecerá de forma predeterminada en grpcs. Especifica grpc:// o Unix: esquema para inhabilitar TLS.
- Configuración predeterminada de
--remote_grpc_log=<a path>
: ver descripción - Si se especifica, es una ruta a un archivo para registrar los detalles relacionados con las llamadas de gRPC. Este registro consta de una secuencia de protobufs serializados com.google.Dev
- Se acumulan
--remote_header=<a 'name=value' assignment>
usos múltiples - Especifica un encabezado que se incluirá en las solicitudes: --remote_header=Name=Value. Se pueden pasar varios encabezados si se especifica la marca varias veces. Si hay varios valores con el mismo nombre, se convertirán en una lista separada por comas.
--remote_instance_name=<a string>
predeterminado: ""- Valor que se pasará como instance_name en la API de ejecución remota.
--[no]remote_local_fallback
valor predeterminado: "false"- Determina si se debe recurrir a la estrategia de ejecución local independiente si falla la ejecución remota.
- El valor predeterminado de
--remote_local_fallback_strategy=<a string>
es "local" - No-ops, obsoleto. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/7480.
--remote_max_connections=<an integer>
predeterminado: "100"-
Limita la cantidad máxima de conexiones simultáneas a la caché o al ejecutor remoto. De forma predeterminada, el valor es 100. Establecerlo en 0 significa que no existen limitaciones.
Para la caché remota HTTP, una conexión TCP podría manejar una solicitud a la vez, por lo que Bazel podría compensar hasta --remote_max_connections solicitudes simultáneas.
Para la caché o el ejecutor remoto de gRPC, por lo general, un canal de gRPC podría manejar más de 100 solicitudes simultáneas, por lo que Bazel podría hacer alrededor de `--remote_max_connections * 100` solicitudes simultáneas.
Etiquetas:host_machine_resource_optimizations
- Configuración predeterminada de
--remote_proxy=<a string>
: ver descripción - Conéctate a la caché remota a través de un proxy. Actualmente, esta marca solo se puede usar para configurar un socket de dominio Unix (unix:/path/to/socket).
--remote_result_cache_priority=<an integer>
predeterminado: "0"- La prioridad relativa de las acciones remotas que se almacenarán en la caché remota. La semántica de los valores de prioridad particulares depende del servidor.
--remote_retries=<an integer>
predeterminado: "5"- La cantidad máxima de intentos para reintentar un error transitorio. Si se establece en 0, se inhabilitan los reintentos.
- Valor predeterminado de
--remote_retry_max_delay=<An immutable length of time.>
: "5 s" - Es el retraso máximo de retirada entre intentos remotos. Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
- Valor predeterminado de
--remote_timeout=<An immutable length of time.>
: "60s" - La cantidad máxima de tiempo que se debe esperar para la ejecución remota y las llamadas a caché. Para la caché de REST, este es el tiempo de espera de conexión y lectura. Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
- El valor predeterminado de
--[no]remote_upload_local_results
es "true" (verdadero). - Indica si se deben subir los resultados de acciones ejecutadas de forma local a la caché remota si la caché remota lo admite y el usuario está autorizado para hacerlo.
- El valor predeterminado de
--[no]remote_verify_downloads
es "true" (verdadero). - Si se configura como verdadera, Bazel calculará la suma de hash de todas las descargas remotas y descartará los valores almacenados en caché de manera remota si no coinciden con el valor esperado.
- Opciones varias, que no están categorizadas:
- El valor predeterminado de
--[no]allow_analysis_cache_discard
es "true" (verdadero). -
Si se descarta la caché de análisis debido a un cambio en el sistema de compilación, configurar esta opción como falsa provocará que Bazel salga, en lugar de continuar con la compilación. Esta opción no tiene efecto cuando también se establece “discard_analysis_cache”.
Etiquetas:eagerness_to_exit
- La configuración predeterminada de
--auto_output_filter=<none, all, packages or subpackages>
es “ninguna” - Si no se especifica --output_filter, se usa el valor de esta opción para crear un filtro automáticamente. Los valores permitidos son “ninguno” (no filtrar nada / mostrar todo), “todos” (filtrar todo / mostrar nada), “paquetes” (incluye el resultado de las reglas de los paquetes mencionados en la línea de comandos de Blaze) y los “subpaquetes” (como “paquetes”, pero también incluyen subpaquetes). Para los “paquetes” y “subpaquetes”, los valores //java/foo y //javatests/foo se tratan como un solo paquete)'.
--[no]build_manual_tests
valor predeterminado: "false"- Fuerza la compilación de objetivos de prueba etiquetados como “manuales”. Las pruebas “manuales” se excluyen del procesamiento. Esta opción los obliga a compilarse (pero no a ejecutarse).
--build_tag_filters=<comma-separated list of options>
predeterminado: ""- Especifica una lista de etiquetas separadas por comas. Cada etiqueta puede estar precedida opcionalmente por “-” para especificar las etiquetas excluidas. Solo se crearán aquellos destinos que contengan al menos una etiqueta incluida y no contengan ninguna etiqueta excluida. Esta opción no afecta el conjunto de pruebas ejecutadas con el comando “test”, ya que se rigen por las opciones de filtrado de pruebas, por ejemplo, “--test_tag_filters”.
--[no]build_tests_only
valor predeterminado: "false"- Si se especifica, solo se compilarán las reglas *_test y test_suite, y se ignorarán otros destinos especificados en la línea de comandos. De forma predeterminada, se compilará todo lo que se solicitó.
- La configuración predeterminada de
--combined_report=<none or lcov>
es “ninguna” - Especifica el tipo de informe de cobertura acumulativo deseado. En este punto, solo se admite el LCOV.
--[no]compile_one_dependency
valor predeterminado: "false"- Compila una sola dependencia de los archivos de argumentos. Esto es útil para verificar la sintaxis de los archivos de origen en IDE, por ejemplo, cuando vuelves a compilar un solo destino que depende del archivo de origen para detectar errores lo antes posible en el ciclo de edición, compilación y prueba. Este argumento afecta la forma en que se interpretan todos los argumentos que no son marcadores; en lugar de ser objetivos para compilar, son nombres de archivo de origen. Para cada nombre de archivo de origen, se compilará un destino arbitrario que dependa de él.
- Se acumulan
--credential_helper=<Path to a credential helper. It may be absolute, relative to the PATH environment variable, or %workspace%-relative. The path be optionally prefixed by a scope followed by an '='. The scope is a domain name, optionally with a single leading '*' wildcard component. A helper applies to URIs matching its scope, with more specific scopes preferred. If a helper has no scope, it applies to every URI.>
usos múltiples - Configura un auxiliar de credenciales que se usará para recuperar credenciales de autorización de recuperación de repositorios, almacenamiento en caché y ejecución remotos, y el servicio de eventos de compilación. Las credenciales que proporciona un asistente tienen prioridad sobre las que suministran --google_default_credentials, --google_credentials, un archivo .netrc o el parámetro auth a inicio_cat. Se puede especificar varias veces para configurar varios asistentes. Para obtener más información, consulta https://github.com/bazelbuild/proposals/blob/main/designs/2022-06-07-bazel-credential-helpers.md.
--credential_helper_cache_duration=<An immutable length of time.>
predeterminado: "30m"- Es el tiempo durante el cual se almacenan en caché las credenciales que proporciona un auxiliar de credenciales. Si 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.
- Valor predeterminado de
--credential_helper_timeout=<An immutable length of time.>
: "10 s" - Configura el tiempo de espera para un auxiliar de credenciales. Los auxiliares de credenciales que no respondan dentro de este tiempo de espera fallarán la invocación.
--deleted_packages=<comma-separated list of package names>
predeterminado: ""- Una lista separada por comas de los nombres de los paquetes que el sistema de compilación considerará que no existen, incluso si están visibles en algún lugar de la ruta del paquete. Usa esta opción cuando borres un subpaquete 'x/y' de un paquete 'x' existente. Por ejemplo, después de borrar x/y/BUILD en el cliente, el sistema de compilación puede presentar un reclamo si encuentra la etiqueta '//x:y/z' si todavía la proporciona otra entrada package_path. Si especificas --deleted_packages x/y se evita este problema.
--[no]discard_analysis_cache
valor predeterminado: "false"- Descartar la caché de análisis inmediatamente después de que se complete la fase de análisis. Reduce el uso de memoria en aproximadamente un 10%, pero ralentiza las compilaciones incrementales adicionales.
- Configuración predeterminada de
--disk_cache=<a path>
: ver descripción - Una ruta de acceso a un directorio en el que Bazel puede leer y escribir acciones y resultados de acciones. Si el directorio no existe, se creará.
--embed_label=<a one-line string>
predeterminado: ""- Incorporar la etiqueta de la versión o la revisión del control de código fuente en un objeto binario
- Configuración predeterminada de
--execution_log_binary_file=<a path>
: ver descripción - Registra los generadores ejecutados en este archivo como protos de Spawn delimitados, de acuerdo con src/main/protobuf/spawn.proto. Primero, el registro se escribe desordenado y, luego, al final de la invocación, se ordena en un orden estable (puede hacer uso intensivo de CPU y memoria). Marcas relacionadas: --execution_log_json_file (formato json de texto ordenado), --experimental_execution_log_file (formato protobuf binario no ordenado), --subcomandos (para mostrar subcomandos en el resultado de terminal).
- Configuración predeterminada de
--execution_log_json_file=<a path>
: ver descripción - Registra los generadores ejecutados en este archivo como una representación JSON de los protos de Spawn delimitados, de acuerdo con src/main/protobuf/spawn.proto. Primero, el registro se escribe desordenado y, luego, al final de la invocación, se ordena en un orden estable (puede hacer uso intensivo de CPU y memoria). Marcas relacionadas: marcas relacionadas: --execution_log_binary_file (formato protobuf binario ordenado), --experimental_execution_log_file (formato protobuf binario no ordenado), --subcomandos (para mostrar subcomandos en el resultado de terminal).
- El valor predeterminado de
--[no]execution_log_sort
es "true" (verdadero). - Determina si se debe ordenar el registro de ejecución. Se establece como false para mejorar el rendimiento de la memoria, a costa de producir el registro en un orden no determinista.
- El valor predeterminado de
--[no]expand_test_suites
es "true" (verdadero). -
Amplía los objetivos de test_suite en las pruebas constituyentes antes del análisis. Cuando esta marca está activada (configuración predeterminada), se aplicarán patrones de objetivo negativos a las pruebas que pertenezcan al paquete de pruebas; de lo contrario, no. Desactivar esta marca es útil cuando los aspectos de nivel superior se aplican en la línea de comandos: entonces pueden analizar los objetivos de test_suite.
Etiquetas:loading_and_analysis
- Configuración predeterminada de
--experimental_execution_log_file=<a path>
: ver descripción - Registra los generadores ejecutados en este archivo como protos de Spawn delimitados, de acuerdo con src/main/protobuf/spawn.proto. Este archivo está escrito en el orden de ejecución de los Generados. Marcas relacionadas: --execution_log_binary_file (formato protobuf binario ordenado), --execution_log_json_file (formato JSON de texto ordenado), --subcomandos (para mostrar subcomandos en el resultado de terminal).
--[no]experimental_execution_log_spawn_metrics
valor predeterminado: "false"- Incluye las métricas de generación en el registro de generaciones ejecutadas.
--experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
predeterminado: ""- Se dio de baja a favor de los aspectos. Filtra el conjunto de objetivos para los que se programan acciones adicionales.
--[no]experimental_extra_action_top_level_only
valor predeterminado: "false"- Se dio de baja a favor de los aspectos. Solo programa las acciones adicionales para los objetivos de nivel superior.
- El valor predeterminado de
--[no]experimental_prioritize_local_actions
es "true" (verdadero). -
Si se configura, las acciones que solo se pueden ejecutar de forma local tienen una primera oportunidad de adquirir recursos, los trabajadores que se ejecutan de forma dinámica tienen una segunda oportunidad y las acciones independientes ejecutadas de forma dinámica quedan en último lugar.
Etiquetas:execution
--experimental_spawn_scheduler
-
Habilita la ejecución dinámica ejecutando acciones de forma local y remota en paralelo. Bazel genera cada acción de forma local y remota, y elige la que se completa primero. Si una acción admite trabajadores, la acción local se ejecutará en el modo de trabajador persistente. Para habilitar la ejecución dinámica de un valor mnemotécnico de acción individual, usa las marcas `--internal_spawn_scheduler` y `--strategy=<mnemonic>=dynamic`.
Se expande a:
--internal_spawn_scheduler
--spawn_strategy=dynamic
- El valor predeterminado de
--google_auth_scopes=<comma-separated list of options>
es "https://www.googleapis.com/auth/cloud-platform" - Una lista separada por comas de los permisos de autenticación de Google Cloud.
- Configuración predeterminada de
--google_credentials=<a string>
: ver descripción - Especifica el archivo del que se obtendrán credenciales de autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más detalles.
--[no]google_default_credentials
valor predeterminado: "false"- Indica si se deben usar las “Credenciales predeterminadas de la aplicación de Google” para la autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más detalles. Están inhabilitados de forma predeterminada.
- Configuración predeterminada de
--grpc_keepalive_time=<An immutable length of time.>
: ver descripción - Configura pings de keep-alive para las conexiones de gRPC salientes. Si se establece, Bazel envía pings después de este período sin operaciones de lectura en la conexión, pero solo si hay al menos una llamada de gRPC pendiente. Los horarios se consideran de segundo nivel de detalle; es un error establecer un valor inferior a un segundo. De forma predeterminada, los pings de keep-alive están inhabilitados. Debes coordinar con el propietario del servicio antes de habilitar este parámetro de configuración. Por ejemplo, para establecer un valor de 30 segundos para esta marca, debe hacerse de esta manera: --grpc_keepalive_time=30s.
- Valor predeterminado de
--grpc_keepalive_timeout=<An immutable length of time.>
: "20 s" - Configura un tiempo de espera de keep-alive para las conexiones de gRPC salientes. Si los pings keep-alive están habilitados con --grpc_keepalive_time, Bazel agota el tiempo de espera de una conexión si no recibe una respuesta de ping después de este tiempo. Los horarios se consideran de segundo nivel de detalle; es un error establecer un valor inferior a un segundo. Si los pings de keep-alive están inhabilitados, se ignora esta configuración.
--[no]ignore_unsupported_sandboxing
valor predeterminado: "false"- No muestres una advertencia cuando este sistema no admita la ejecución de zona de pruebas.
--[no]incompatible_dont_use_javasourceinfoprovider
valor predeterminado: "false"-
No-ops
Etiquetas:incompatible_change
- Valor predeterminado de
--local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>
: "HOST_CPUS" - Establece de forma explícita la cantidad total de núcleos de CPU locales disponibles para que Bazel invierta en acciones de compilación ejecutadas de forma local. Toma un número entero o "HOST_CPUS", opcionalmente seguido de [-|*]<float> (p. ej., HOST_CPUS*.5 para usar la mitad de los núcleos de CPU disponibles).De forma predeterminada, (“HOST_CPUS”), Bazel consultará la configuración del sistema para estimar la cantidad de núcleos de CPU disponibles.
- Se acumulan
--local_extra_resources=<a named float, 'name=value'>
usos múltiples - Establece la cantidad de recursos adicionales disponibles para Bazel. Toma un par de cadena-flotante. Se puede usar varias veces para especificar varios tipos de recursos adicionales. Bazel limitará las acciones que se ejecutan de forma simultánea según los recursos adicionales disponibles y necesarios. Las pruebas pueden declarar la cantidad de recursos adicionales que necesitan usando una etiqueta con el formato “resources:<resoucename>:<amount>”. La CPU, la RAM y los recursos disponibles no se pueden configurar con esta marca.
- Valor predeterminado de
--local_ram_resources=<an integer, or "HOST_RAM", optionally followed by [-|*]<float>.>
: "HOST_RAM*.67" - Establece de forma explícita la cantidad total de RAM del host local (en MB) disponible para que Bazel invierta en acciones de compilación ejecutadas de forma local. Toma un número entero, o “HOST_RAM”, opcionalmente seguido de [-|*]<float> (p. ej., HOST_RAM*.5 para usar la mitad de la RAM disponible). De forma predeterminada, ("HOST_RAM*.67"), Bazel consultará la configuración del sistema para estimar la cantidad de RAM disponible y usará el 67%.
--local_termination_grace_seconds=<an integer>
predeterminado: "15"- Tiempo de espera entre la finalización de un proceso local debido al tiempo de espera y el cierre forzado.
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
--package_path=<colon-separated list of options>
predeterminado: "%workspace%"- Una lista separada por dos puntos sobre dónde buscar paquetes. Los elementos que comienzan con "%workspace%" son relativos al lugar de trabajo que lo contiene. Si se omite o está vacío, el valor predeterminado es el resultado de “bazel info default-package-path”.
- El valor predeterminado de
--[no]show_loading_progress
es "true" (verdadero). - Si se habilita, hace que Bazel imprima mensajes "Cargando paquete:".
--test_lang_filters=<comma-separated list of options>
predeterminado: ""- Especifica una lista de idiomas de prueba separados por comas. De manera opcional, cada idioma puede ir precedido de “-” para especificar los idiomas excluidos. Solo se encontrarán las ubicaciones de prueba que estén escritas en los idiomas especificados. El nombre que se usa para cada lenguaje debe ser el mismo que el prefijo de idioma en la regla *_test, p.ej., "cc", "java", "py", etc. Esta opción afecta el comportamiento de --build_tests_only y el comando de prueba.
--test_size_filters=<comma-separated list of values: small, medium, large or enormous>
predeterminado: ""- Especifica una lista de tamaños de prueba separados por comas. Cada tamaño puede estar precedido opcionalmente por “-” para especificar los tamaños excluidos. Solo se encontrarán los objetivos de prueba que contengan al menos un tamaño incluido y no contengan ningún tamaño excluido. Esta opción afecta el comportamiento de --build_tests_only y el comando de prueba.
--test_tag_filters=<comma-separated list of options>
predeterminado: ""- Especifica una lista de etiquetas de prueba separadas por comas. Cada etiqueta puede estar precedida opcionalmente por “-” para especificar las etiquetas excluidas. Solo se encontrarán los destinos de prueba que contengan al menos una etiqueta incluida y no contengan ninguna etiqueta excluida. Esta opción afecta el comportamiento de --build_tests_only y el comando de prueba.
--test_timeout_filters=<comma-separated list of values: short, moderate, long or eternal>
predeterminado: ""- Especifica una lista separada por comas de tiempos de espera de pruebas. Cada tiempo de espera puede estar precedido opcionalmente por “-” para especificar los tiempos de espera excluidos. Solo se encontrarán los destinos de prueba que contengan al menos un tiempo de espera incluido y no contengan tiempos de espera excluidos. Esta opción afecta el comportamiento de --build_tests_only y el comando de prueba.
- Configuración predeterminada de
--tls_certificate=<a string>
: ver descripción - Especifica una ruta de acceso a un certificado TLS que sea confiable para firmar certificados de servidor.
- Configuración predeterminada de
--tls_client_certificate=<a string>
: ver descripción - Especifica el certificado de cliente TLS que se usará; también debes proporcionar una clave de cliente para habilitar la autenticación de cliente.
- Configuración predeterminada de
--tls_client_key=<a string>
: ver descripción - Especifica la clave de cliente TLS que se usará; también debes proporcionar un certificado de cliente para habilitar la autenticación de cliente.
--workspace_status_command=<path>
predeterminado: ""- Es un comando invocado al comienzo de la compilación para proporcionar información de estado sobre el lugar de trabajo en forma de pares clave-valor. Consulta el manual del usuario para ver la especificación completa. También consulta tools/buildstamp/get_workspace_status para ver un ejemplo.
- Opciones que controlan la ejecución de la compilación:
--[no]check_up_to_date
valor predeterminado: "false"-
No realices la compilación, solo verifica si está actualizada. Si todos los destinos están actualizados, la compilación se completa de forma correcta. Si es necesario ejecutar algún paso, se informa un error y la compilación falla.
Etiquetas:execution
--[no]experimental_inprocess_symlink_creation
valor predeterminado: "false"-
Indica si se deben realizar llamadas directas al sistema de archivos para crear árboles de symlinks
Etiquetas:loading_and_analysis
,execution
,experimental
--[no]experimental_remotable_source_manifests
valor predeterminado: "false"-
Indica si se pueden hacer que las acciones del manifiesto de origen sean remotas
Etiquetas:loading_and_analysis
,execution
,experimental
--[no]experimental_split_coverage_postprocessing
valor predeterminado: "false"-
Si es verdadero, Bazel ejecutará el procesamiento posterior de la cobertura para probarlo en un nuevo generador.
Etiquetas:execution
- El valor predeterminado de
--[no]experimental_split_xml_generation
es "true" (verdadero). -
Si se configura esta marca y una acción de prueba no genera un archivo test.xml, Bazel usa una acción separada para generar un archivo test.xml ficticio que contenga el registro de prueba. De lo contrario, Bazel generará un archivo test.xml como parte de la acción de prueba.
Etiquetas:execution
--[no]experimental_strict_fileset_output
valor predeterminado: "false"-
Si habilitas esta opción, los conjuntos de archivos tratarán todos los artefactos de salida como archivos normales. No desviarán directorios ni serán sensibles a los symlinks.
Etiquetas:execution
--genrule_strategy=<comma-separated list of options>
predeterminado: ""-
Especifica cómo ejecutar genrules. Esta marca se eliminará gradualmente. En su lugar, usa --spawn_strategy=<value> para controlar todas las acciones o --strategy=Genrule=<value> para controlar solo genrules.
Etiquetas:execution
--jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
[-j
] predeterminado: "auto"-
La cantidad de trabajos simultáneos que se ejecutarán. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguido de una operación ([-|*]<float>), p. ej., “auto”, “HOST_CPUS*.5”. Los valores deben estar entre 1 y 5,000. Los valores superiores a 2,500 pueden causar problemas de memoria. “auto” calcula un valor predeterminado razonable en función de los recursos del host.
Etiquetas:host_machine_resource_optimizations
,execution
--[no]keep_going
[-k
] predeterminado: "false"-
Continúa tanto como sea posible después de un error. Si bien el objetivo que falló y aquellos que dependen de él no se pueden analizar, otros requisitos previos de estos objetivos pueden serlo.
Etiquetas:eagerness_to_exit
- Valor predeterminado de
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "auto" -
Cantidad de subprocesos paralelos que se usarán en la fase de carga o análisis. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguido de una operación ([-|*]<float>), p. ej., “auto”, “HOST_CPUS*.5”. “auto” establece un valor predeterminado razonable según los recursos del host. Debe ser 1 como mínimo.
Etiquetas:bazel_internal_configuration
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
predeterminado: ""-
Agrega o quita claves de la información de ejecución de una acción según el valor mnemotécnico de la acción. Solo se aplica a las acciones que admiten información de ejecución. Muchas acciones comunes admiten información de ejecución, p.ej., Genrule, CppCompile, Javac, StarlarkAction y TestRunner. Cuando se especifican varios valores, el orden es importante porque muchas regex pueden aplicarse al mismo valor mnemotécnico.
Sintaxis: "regex=[+-]key,regex=[+-]key,...".
Ejemplos:
“.*=+x,.*=-y,.*=+z” agrega “x” y “z” a la información de ejecución de todas las acciones y quita “y”.
“Genrule=+requires-x” agrega “require-x” a la información de ejecución para todas las acciones de Genrule.
“(?!Genrule).*=-requires-x” quita “require-x” de la información de ejecución para todas las acciones que no son de Genrule.
Etiquetas:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Habilita las acciones persistentes de dex y desugar de Android con trabajadores.
Se expande a:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
-
Habilita el procesador de recursos persistentes de Android usando trabajadores.
Se expande a:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
}
--strategy=Aapt2Optimize=worker
--strategy=Aapt2Optimize=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
host_machine_resource_optimizations
execution
--persistent_multiplex_android_dex_desugar
-
Habilita las acciones de dex y desugar multiplexadas persistentes de Android con trabajadores.
Se expande a:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
Habilita el procesador de recursos multiplexados persistentes de Android usando trabajadores.
Se expande a:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
}
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
host_machine_resource_optimizations
execution
--persistent_multiplex_android_tools
-
Habilita herramientas persistentes y multiplexadas de Android (dexing, expansión de sintaxis, procesamiento de recursos).
Se expande a:
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Etiquetas:host_machine_resource_optimizations
,execution
--spawn_strategy=<comma-separated list of options>
predeterminado: ""- Especifica cómo se ejecutan las acciones de generación de forma predeterminada. Acepta una lista de estrategias separadas por comas de mayor a menor prioridad. Para cada acción, Bazel elige la estrategia con la prioridad más alta que puede ejecutar la acción. El valor predeterminado es “remote,worker,sandboxed,local”. Para obtener más información, consulta https://blog.bazel.build/2019/06/19/list-strategy.html.
Etiquetas:execution
- Se acumulan
--strategy=<a '[name=]value1[,..,valueN]' assignment>
usos múltiples -
Especifica cómo distribuir la compilación de otras acciones de generación. Acepta una lista de estrategias separadas por comas de mayor a menor prioridad. Para cada acción, Bazel elige la estrategia con la prioridad más alta que puede ejecutar la acción. El valor predeterminado es “remote,worker,sandboxed,local”. Esta marca anula los valores establecidos por --spawn_strategy (y --genrule_strategy si se utiliza con Genrule mnemónico). Para obtener más información, consulta https://blog.bazel.build/2019/06/19/list-strategy.html.
Etiquetas:execution
- Se acumulan
--strategy_regexp=<a '<RegexFilter>=value[,value]' assignment>
usos múltiples -
Anula la estrategia de generación que se debe usar para ejecutar acciones de generación que tengan descripciones que coincidan con un regex_filter determinado. Consulta --per_file_copt para obtener detalles sobre la coincidencia deregex_filter. Se usa el 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 que se deben ejecutar acciones con la estrategia local si sus descripciones coinciden con //foo.*.cc, pero no con //foo/bar. Ejemplo: --strategy_regexp='Compiling.*/bar=local --strategy_regexp=Compiling=sandboxed ejecutará "Compila //foo/bar/baz" con la estrategia "local", pero revertir el orden ejecutaría "sandboxed".
Etiquetas:execution
- Opciones que configuran la cadena de herramientas usada para ejecutar la acción:
- Configuración predeterminada de
--android_compiler=<a string>
: ver descripción -
El compilador de destino de Android
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_crosstool_top=<a build target label>
predeterminado: "//external:android/crosstool"-
Es la ubicación del compilador de C++ que se usa para las compilaciones de Android.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
yloses_incremental_state
- Configuración predeterminada de
--android_grte_top=<a label>
: ver descripción -
El objetivo de Android es grte_top.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
predeterminado: "android"-
Selecciona la combinación de manifiestos que se usará para las reglas android_binary. Marca para ayudar en la transición a la combinación de manifiestos de Android desde la combinación heredada.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_platforms=<a build target label>
predeterminado: ""-
Establece las plataformas que usan los objetivos de android_binary. Si se especifican varias plataformas, el objeto binario es un APK multiarquitectura, que incluye objetos binarios nativos para cada plataforma de destino especificada.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_sdk=<a build target label>
predeterminado: "@bazel_tools//tools/android:sdk"-
Especifica el SDK o la plataforma de Android que se utiliza para compilar aplicaciones para Android.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
- Configuración predeterminada de
--apple_compiler=<a string>
: ver 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"-
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
- Configuración predeterminada de
--apple_grte_top=<a build target label>
: ver 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
- Configuración predeterminada de
--compiler=<a string>
: ver descripción -
El compilador de C++ que se usará para compilar el destino.
Etiquetas:loading_and_analysis
,execution
--coverage_output_generator=<a build target label>
predeterminado: "@bazel_tools//tools/test:lcov_merger"-
Ubicación del objeto binario que se usa para procesar posteriormente los informes de cobertura sin procesar. Actualmente, debe ser un grupo de archivos que contenga un solo archivo, el binario. La configuración predeterminada es '//tools/test:lcov_merger'.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
predeterminado: "@bazel_tools//tools/test:coverage_report_generator"-
Ubicación del objeto binario que se usa para generar informes de cobertura. Actualmente, debe ser un grupo de archivos que contenga un solo archivo, el binario. La configuración predeterminada es “//tools/test:coverage_report_generator”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
predeterminado: "@bazel_tools//tools/test:coverage_support"-
Ubicación de los archivos de compatibilidad que se requieren en las entradas de cada acción de prueba que recopila la cobertura de código. La configuración predeterminada es "//tools/test:coverage_support".
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--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 el código de C++.
Etiquetas:loading_and_analysis
,changes_inputs
,affects_outputs
- Configuración predeterminada de
--custom_malloc=<a build target label>
: ver descripción -
Especifica una implementación de malloc personalizada. Este parámetro de configuración anula los atributos malloc en las reglas de compilación.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
usos múltiples -
Lista de expresiones regulares separadas por comas, cada una con el prefijo - (expresión negativa), asignada (=) a una lista de valores de restricción separados por comas. Si un objetivo no coincide con ninguna expresión negativa y al menos una expresión positiva, la resolución de la cadena de herramientas se ejecutará como si hubiera declarado los valores de restricción como restricciones de ejecución. Ejemplo: //demo,-test=@platforms//cpus:x86_64 agregará 'x86_64' a cualquier destino de //demo, excepto aquellos cuyo nombre contenga 'prueba'.
Etiquetas:loading_and_analysis
- El valor predeterminado de
--[no]experimental_enable_objc_cc_deps
es "true" (verdadero). -
Permite que las reglas objc_* dependan de cc_library y hace que cualquier dependencia objc se compile con --cpu set to "ios_<--ios_cpu>" para cualquier valor en --ios_multi_cpu.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]experimental_include_xcode_execution_requirements
valor predeterminado: "false"-
Si se configura, agrega un requisito de ejecución “requires-xcode:{version}” a cada acción de Xcode. Si la versión de Xcode tiene una etiqueta con guion, también agrega un requisito de ejecución “requires-xcode-label:{version_label}”.
Etiquetas:loses_incremental_state
,loading_and_analysis
,execution
- El valor predeterminado de
--[no]experimental_prefer_mutual_xcode
es "true" (verdadero). -
Si es verdadero, usa el Xcode más reciente que esté disponible de forma local y remota. Si es falso, o si no existen versiones mutuas disponibles, usa la versión local de Xcode seleccionada a través de xcode-select.
Etiquetas:loses_incremental_state
- Se acumulan
--extra_execution_platforms=<comma-separated list of options>
usos múltiples -
Son las plataformas disponibles como plataformas de ejecución para ejecutar acciones. Las plataformas se pueden especificar por objetivo exacto o como patrón de objetivo. Estas plataformas se considerarán antes que las declaradas en el archivo WORKSPACE por register_execution_platforms().
Etiquetas:execution
- Se acumulan
--extra_toolchains=<comma-separated list of options>
usos múltiples -
Son las reglas de la cadena de herramientas que se tendrán en cuenta durante su resolución. Las cadenas de herramientas se pueden especificar por objetivo exacto o como patrón de objetivo. Estas cadenas de herramientas se considerarán antes de las declaradas en el archivo WORKSPACE por register_toolchains().
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
- Configuración predeterminada de
--grte_top=<a label>
: ver descripción -
Es una etiqueta de una biblioteca libc registrada. La cadena de herramientas de herramientas cruzadas selecciona el valor predeterminado, y casi nunca necesitas anularlo.
Etiquetas:action_command_lines
,affects_outputs
- Configuración predeterminada de
--host_compiler=<a string>
: ver descripción -
Compilador de C++ que se usará para la compilación del host. Se ignora si no se configura --host_crosstool_top.
Etiquetas:loading_and_analysis
,execution
- Configuración predeterminada de
--host_crosstool_top=<a build target label>
: ver descripción -
De forma predeterminada, las opciones --crosstool_top y --compiler también se usan para la configuración del host. Si se proporciona esta marca, Bazel usa el libc y el compilador predeterminados para la crosstool_top especificada.
Etiquetas:loading_and_analysis
,changes_inputs
,affects_outputs
- Configuración predeterminada de
--host_grte_top=<a label>
: ver descripción -
Si se especifica, este parámetro 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: ""-
Es la etiqueta de una regla de la plataforma que describe el sistema host.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
- El valor predeterminado de
--[no]incompatible_disable_expand_if_all_available_in_flag_set
es "true" (verdadero). -
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
- El valor predeterminado de
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
es "true" (verdadero). -
Si es "true", Bazel no habilitará las funciones "host" y "nonhost" en la cadena de herramientas de c++ (consulta https://github.com/bazelbuild/bazel/issues/7407 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_android_toolchain_resolution
valor predeterminado: "false"-
Usa la resolución de la cadena de herramientas para seleccionar el SDK de Android para reglas de Android (Starlark y nativo)
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_apple_toolchain_resolution
valor predeterminado: "false"-
Usa la resolución de la cadena de herramientas para seleccionar el SDK de Apple para las reglas de Apple (Starlark y nativo)
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_make_thinlto_command_lines_standalone
es "true" (verdadero). -
Si es verdadero, Bazel no reutilizará las líneas de comandos de acción de vínculo de C++ para las líneas de comandos de indexación lto (consulta https://github.com/bazelbuild/bazel/issues/6791 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain
es "true" (verdadero). -
Si es así, Bazel realizará un reclamo cuando se configuren 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
- El valor predeterminado de
--[no]incompatible_remove_legacy_whole_archive
es "true" (verdadero). -
Si es verdadero, Bazel no vinculará las dependencias de la biblioteca como todo el archivo de forma predeterminada (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener instrucciones de migración).
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_require_ctx_in_configure_features
es "true" (verdadero). -
Si es "true", Bazel requerirá el parámetro "="{" 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 lo admite. Todas las cadenas de herramientas de ELF admiten actualmente este parámetro de configuración.
Etiquetas:loading_and_analysis
,affects_outputs
,affects_outputs
- Configuración predeterminada de
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Especifica la versión del SDK de iOS que se usará para compilar aplicaciones para iOS. Si no se especifica, usa la versión predeterminada del SDK para iOS de “xcode_version”.
Etiquetas:loses_incremental_state
- Configuración predeterminada de
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Especifica la versión del SDK de macOS que se usará para compilar aplicaciones de macOS. Si no se especifica, se usa la versión predeterminada del SDK de macOS de “xcode_version”.
Etiquetas:loses_incremental_state
- Configuración predeterminada de
--minimum_os_version=<a string>
: ver descripción -
La versión mínima del SO a la que se orienta tu compilación.
Etiquetas:loading_and_analysis
,affects_outputs
--platform_mappings=<a relative path>
predeterminado: ""-
Es la ubicación de un archivo de asignación en la que se describe qué plataforma usar si no hay ninguna establecida o qué marcas se deben configurar cuando ya existe una plataforma. Debe estar relacionado con la raíz del lugar de trabajo principal. La configuración predeterminada es "platform_mappings", que es un archivo directamente en la raíz del lugar de trabajo.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--platforms=<a build target label>
predeterminado: ""-
Las etiquetas de las reglas de la plataforma que describen las plataformas de destino para el comando actual.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
- Configuración predeterminada de
--python2_path=<a string>
: ver descripción -
Obsoleto, no-op. Inhabilitado por `--incompatible_use_python_toolchains`.
Etiquetas:no_op
,deprecated
- Configuración predeterminada de
--python3_path=<a string>
: ver descripción -
Obsoleto, no-op. Inhabilitado por `--incompatible_use_python_toolchains`.
Etiquetas:no_op
,deprecated
- Configuración predeterminada de
--python_path=<a string>
: ver descripción -
Es la ruta de acceso absoluta del intérprete de Python que se invoca para ejecutar los objetivos de Python en la plataforma de destino. Obsoleto; inhabilitado por --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
- Configuración predeterminada de
--python_top=<a build target label>
: ver descripción -
La etiqueta de un py_runtime que representa el intérprete de Python invocado para ejecutar objetivos de Python en la plataforma de destino. Obsoleto; inhabilitado por --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
--target_platform_fallback=<a build target label>
valor predeterminado: "@local_config_platform//:host"-
Es la etiqueta de una regla de plataforma que se debe usar si no se establece ninguna plataforma de destino y no hay una asignación de plataforma que coincida con el conjunto actual de marcas.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
- Configuración predeterminada de
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Especifica la versión del SDK de tvOS que se usará para compilar aplicaciones de tvOS. Si no se especifica, se usa la versión predeterminada del SDK de tvOS de “xcode_version”.
Etiquetas:loses_incremental_state
- Configuración predeterminada de
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Especifica la versión del SDK de watchOS que se usará para compilar aplicaciones de watchOS. Si no se especifica, se usa la versión predeterminada del SDK de watchOS de “xcode_version”.
Etiquetas:loses_incremental_state
- Configuración predeterminada de
--xcode_version=<a string>
: ver descripción -
Si se especifica, usa Xcode de la versión determinada para las acciones de compilación relevantes. Si no se especifica, usa la versión predeterminada del ejecutor de Xcode.
Etiquetas:loses_incremental_state
--xcode_version_config=<a build target label>
predeterminado: "@bazel_tools//tools/cpp:host_xcodes"-
La etiqueta de la regla xcode_config que se usará para seleccionar la versión de Xcode en la configuración de compilación.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Opciones que controlan el resultado del comando:
--[no]apple_enable_auto_dsym_dbg
valor predeterminado: "false"-
Determina si se debe forzar la habilitación de la generación de archivos de símbolos de depuración (.dSYM) para compilaciones de dbg.
Etiquetas:affects_outputs
,action_command_lines
--[no]apple_generate_dsym
valor predeterminado: "false"-
Indica si se deben generar archivos de símbolos de depuración (.dSYM).
Etiquetas:affects_outputs
,action_command_lines
- El valor predeterminado de
--[no]build
es "true" (verdadero). -
Ejecuta la compilación; este es el comportamiento habitual. La especificación de --nobuild hace que la compilación se detenga antes de ejecutar las acciones de compilación y muestra cero si las fases de análisis y carga del paquete se completaron correctamente. Este modo es útil para probar esas fases.
Etiquetas:execution
,affects_outputs
- El valor predeterminado de
--[no]build_runfile_links
es "true" (verdadero). -
Si esta opción es verdadera, compila bosques de symlinks de archivos de ejecución para todos los destinos. Si es falso, solo escribe manifiestos cuando sea posible.
Etiquetas:affects_outputs
- El valor predeterminado de
--[no]build_runfile_manifests
es "true" (verdadero). -
Si esta opción es verdadera, se escriben manifiestos de archivos de ejecución para todos los destinos. Si es falso, omítelos. Las pruebas locales no se ejecutarán si el valor es falso.
Etiquetas:affects_outputs
--[no]build_test_dwp
valor predeterminado: "false"-
Si se habilita, cuando se compilen pruebas de C++ de forma estática y con fisión, el archivo .dwp para el objeto binario de prueba también se compilará automáticamente.
Etiquetas:loading_and_analysis
,affects_outputs
--cc_proto_library_header_suffixes=<comma-separated 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"-
Establece los prefijos de los archivos fuente que crea una cc_proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info
valor predeterminado: "false"-
Ejecuta acciones adicionales para versiones alternativas de la API de Java en una proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_proto_extra_actions
valor predeterminado: "false"-
Ejecuta acciones adicionales para versiones alternativas de la API de Java en una proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
- El valor predeterminado de
--[no]experimental_run_validations
es "true" (verdadero). -
En su lugar, usa --run_validations.
Etiquetas:execution
,affects_outputs
--[no]experimental_save_feature_state
valor predeterminado: "false"-
Guarda el estado de las funciones habilitadas y solicitadas como resultado de la compilación.
Etiquetas:affects_outputs
,experimental
--[no]experimental_use_validation_aspect
valor predeterminado: "false"-
Determina si se deben ejecutar acciones de validación con el aspecto (para el paralelismo con pruebas).
Etiquetas:execution
,affects_outputs
- El valor predeterminado de
--fission=<a set of compilation modes>
es "no" -
Especifica qué modos de compilación usan fisión para compilaciones y vínculos de C++. Puede ser cualquier combinación de {'fastbuild', 'dbg', 'opt'} o los valores especiales "yes" para habilitar todos los modos y "no" para inhabilitarlos.
Etiquetas:loading_and_analysis
,action_command_lines
,affects_outputs
- El valor predeterminado de
--[no]incompatible_always_include_files_in_data
es "true" (verdadero). -
Si es verdadero, las reglas nativas agregan <code>DefaultInfo.files</code> de dependencias de datos a sus archivos de ejecución, lo que coincide con el comportamiento recomendado para las reglas de Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid).
Etiquetas:affects_outputs
,incompatible_change
- El valor predeterminado de
--[no]legacy_external_runfiles
es "true" (verdadero). -
Si esta opción es verdadera, compila bosques de symlink de archivos de ejecución para repositorios externos en .runfiles/wsname/external/repo (además de .runfiles/repo).
Etiquetas:affects_outputs
--[no]objc_generate_linkmap
valor predeterminado: "false"-
Especifica si se debe generar un archivo de mapa de vínculos.
Etiquetas:affects_outputs
- Se acumulan
--output_groups=<comma-separated list of options>
usos múltiples -
Una lista de nombres de grupos de salida separados por comas, cada uno de los cuales puede ir con el prefijo + o -. Un grupo con prefijo + se agrega al conjunto predeterminado de grupos de salida, mientras que uno con prefijo - se quita del conjunto predeterminado. Si al menos un grupo no tiene prefijo, se omite el conjunto predeterminado de grupos de salida. Por ejemplo, --output_groups=+foo,+bar compila la unión del conjunto predeterminado, foo y bar, mientras que --output_groups=foo,bar anula el conjunto predeterminado de modo que solo se compilen foo y bar.
Etiquetas:execution
,affects_outputs
- El valor predeterminado de
--[no]run_validations
es "true" (verdadero). -
Determina si se deben ejecutar acciones de validación como parte de la compilación. Consulta https://bazel.build/rules/rules#validation_actions
Etiquetas:execution
,affects_outputs
--[no]save_temps
valor predeterminado: "false"-
Si se establece, se guardarán los resultados temporales de GCC. Estos incluyen archivos .s (código ensamblador), archivos .i (C preprocesado) y archivos .ii (C++ previamente procesados).
Etiquetas:affects_outputs
- Opciones que permiten al usuario configurar el resultado deseado y afectar su valor, en lugar de su existencia:
- Se acumulan
--action_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica el conjunto de variables de entorno disponibles para acciones con configuración de destino. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o mediante el par nombre=valor que establece el valor independientemente del entorno de invocación. Esta opción se puede usar varias veces; para opciones proporcionadas para la misma variable, se acumulan los últimos éxitos, las opciones para diferentes variables se acumulan.
Etiquetas:action_command_lines
--android_cpu=<a string>
predeterminado: "armeabi-v7a"-
Es la CPU de destino de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]android_databinding_use_androidx
valor predeterminado: "false"-
Genera archivos de vinculación de datos compatibles con AndroidX. Esto solo se usa con Databinding v2.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
yexperimental
--[no]android_databinding_use_v3_4_args
valor predeterminado: "false"-
Usar Android Databinding v2 con argumentos 3.4.0
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- El valor predeterminado de
--android_dynamic_mode=<off, default or fully>
es "desactivado" -
Determina si las dependencias de C++ de las reglas de Android se vincularán de forma dinámica cuando un objeto cc_binary no cree explícitamente una biblioteca compartida. “default” significa que Bazel decide si se vincula de forma dinámica. "completamente" significa que todas las bibliotecas se vincularán de forma dinámica. “off” significa que todas las bibliotecas se vincularán en su mayor parte en modo estático.
Etiquetas:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
valor predeterminado: "alphabetical"-
Establece el orden de los manifiestos que se pasan a la combinación de manifiestos para objetos binarios de Android. ALFABÉTICO significa que los manifiestos se ordenan por ruta de acceso relativa a la execroot. ALPHABETICAL_BY_CONFIGURATION significa que los manifiestos se ordenan por rutas de acceso relacionadas con el directorio de configuración dentro del directorio de salida. DEPENDENCY significa que los manifiestos se ordenan con los manifiestos de cada biblioteca antes que los de sus dependencias.
Etiquetas:action_command_lines
,execution
--[no]android_resource_shrinking
valor predeterminado: "false"-
Habilita la reducción de recursos para los APKs de android_binary que usan ProGuard.
Etiquetas:affects_outputs
,loading_and_analysis
- Se acumulan
--apple_bitcode=<'mode' or 'platform=mode', where 'mode' is none, embedded_markers or embedded, and 'platform' is ios, visionos, watchos, tvos, macos or catalyst>
usos múltiples -
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”, en el que la plataforma (que debe ser “ios”, “macos”, “tvos” o “watchos”) es opcional. Si se proporciona, el modo de código de bits se aplica específicamente a esa plataforma. Si se omite, se aplica a 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
--aspects=<comma-separated list of options>
usos múltiples - Lista de aspectos separados por coma que se aplicarán a los objetivos de nivel superior. En la lista, si Aspecto some_aspect especifica los proveedores de aspecto requeridos mediante required_aspect_providers, some_aspect se ejecutará después de cada aspecto que se mencionó antes en la lista de aspectos cuyos proveedores anunciados satisfacen a algunos de los proveedores de aspecto requeridos. Además, some_aspect se ejecutará después de todos los aspectos obligatorios especificados por el atributo requirements. Luego, some_aspect tendrá acceso a los valores de los proveedores de esos aspectos. <bzl-file-label>%<aspect_name>, por ejemplo, “//tools:my_def.bzl%my_aspect”, donde “my_aspect” es un valor de nivel superior de un archivo tools/my_def.bzl
- Valor predeterminado de
--[no]build_python_zip
: "auto" -
Compila el archivo ZIP del comando de Python; en Windows, desactivado en otras plataformas
Etiquetas:affects_outputs
- Se acumulan
--catalyst_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se compilan los objetos binarios de Apple Catalyst.
Etiquetas:loses_incremental_state
,loading_and_analysis
--[no]collect_code_coverage
valor predeterminado: "false"-
Si se especifica, Bazel instrumentará código (con instrumentación sin conexión cuando sea posible) y recopilará información de cobertura durante las pruebas. Solo se verán afectados los objetivos que coincidan con --instrumentation_filter. Por lo general, esta opción no debe especificarse directamente; en su lugar, debes usar el comando "bazel esquema".
Etiquetas:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] predeterminado: "fastbuild"-
Especifica el modo en el que se compilará el objeto binario. Valores: "fastbuild", "dbg", "opt".
Etiquetas:affects_outputs
,action_command_lines
,explicit_in_output_path
- Se acumulan
--conlyopt=<a string>
usos múltiples -
Es una opción adicional para pasar a gcc cuando se compilan archivos de origen C.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--copt=<a string>
usos múltiples -
Opciones adicionales para pasar a gcc.
Etiquetas:action_command_lines
,affects_outputs
--cpu=<a string>
predeterminado: ""-
La CPU de destino.
Etiquetas:changes_inputs
,affects_outputs
,explicit_in_output_path
- Configuración predeterminada de
--cs_fdo_absolute_path=<a string>
: ver descripción - Usa la información del perfil de CSFDO para optimizar la compilación. Especifica el nombre de ruta de acceso absoluto del archivo ZIP que contiene el archivo de perfil, un archivo de perfil de LLVM sin procesar o indexado.
Etiquetas:affects_outputs
- Configuración predeterminada de
--cs_fdo_instrument=<a string>
: ver descripción - Genera objetos binarios con instrumentación de FDO sensible al contexto. Con el compilador Clang/LLVM, también acepta el nombre de directorio bajo el cual se volcarán los archivos de perfil sin procesar durante el tiempo de ejecución.
Etiquetas:affects_outputs
- Configuración predeterminada de
--cs_fdo_profile=<a build target label>
: ver descripción -
El cs_fdo_profile, que representa el perfil sensible al contexto que se usará para la optimización.
Etiquetas:affects_outputs
- Se acumulan
--cxxopt=<a string>
usos múltiples -
Es una opción adicional para pasar a gcc cuando se compilan archivos de origen C++.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--define=<a 'name=value' assignment>
usos múltiples -
Cada opción --define especifica una asignación para una variable de compilación.
Etiquetas:changes_inputs
,affects_outputs
--dynamic_mode=<off, default or fully>
valor predeterminado: "default"-
Determina si los objetos binarios de C++ se vincularán de forma dinámica. “predeterminada” significa que Bazel elegirá si se vinculará de forma dinámica. "completamente" significa que todas las bibliotecas se vincularán de forma dinámica. “off” significa que todas las bibliotecas se vincularán en su mayor parte en modo estático.
Etiquetas:loading_and_analysis
,affects_outputs
- El valor predeterminado de
--[no]enable_fdo_profile_absolute_path
es "true" (verdadero). -
Si se configura, el uso de fdo_absolute_profile_path generará un error.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]enable_runfiles
: "auto" -
Habilita el árbol del symlink de los archivos de ejecución. De forma predeterminada, está desactivado en Windows y en otras plataformas.
Etiquetas:affects_outputs
- Se acumulan
--experimental_action_listener=<a build target label>
usos múltiples -
Se dio de baja a favor de los aspectos. Usa action_listener para adjuntar una extra_action a las acciones de compilación existentes.
Etiquetas:execution
,experimental
--[no]experimental_android_compress_java_resources
valor predeterminado: "false"-
Comprime los recursos de Java en APK
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_android_databinding_v2
valor predeterminado: "false"-
Usar Android Databinding v2
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_android_resource_shrinking
valor predeterminado: "false"-
Habilita la reducción de recursos para los APKs de android_binary que usan ProGuard.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_android_rewrite_dexes_with_rex
valor predeterminado: "false"-
usar la herramienta Rex para reescribir archivos dex
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_collect_code_coverage_for_generated_files
valor predeterminado: "false"-
Si se especifica, Bazel también generará información de cobertura para los archivos generados.
Etiquetas:affects_outputs
- El valor predeterminado de
--[no]experimental_convenience_symlinks
es "normal" -
Esta marca controla cómo se administrarán los symlinks de conveniencia (los que aparecen en el lugar de trabajo después de la compilación). Valores posibles: normal (predeterminado): Se creará o borrará cada tipo de symlink de conveniencia, según lo determine la compilación.
clean: Todos los symlinks se borrarán incondicionalmente.
ignorar: Los enlaces simbólicos no se verán afectados.
log_only: Genera mensajes de registro como si se pasaran “normales”, pero no realizas ninguna operación de sistema de archivos (útil para las herramientas).
Ten en cuenta que solo pueden verse afectados los symlinks cuyos nombres se generen por el valor actual de --symlink_prefix. Si el prefijo cambia, cualquier symlink preexistente quedará solo.
Etiquetas:affects_outputs
--[no]experimental_convenience_symlinks_bep_event
valor predeterminado: "false"-
Esta marca controla si publicaremos o no el evento de compilaciónConvenienceSymlinksIdentified en BuildEventProtocol. Si el valor es verdadero, BuildEventProtocol tendrá una entrada para convenienciaSymlinksIdentified y enumerará todos los symlinks de conveniencia creados en tu lugar de trabajo. Si es falso, la entrada convenienciaSymlinksIdentified en BuildEventProtocol estará vacía.
Etiquetas:affects_outputs
- Se acumulan
--experimental_multi_cpu=<comma-separated list of options>
usos múltiples -
Obsoleto. No-ops
Etiquetas:affects_outputs
,experimental
--experimental_objc_fastbuild_options=<comma-separated list of options>
predeterminado: "-O0,-DDEBUG=1"-
Usa estas cadenas como opciones del compilador objc fastbuild.
Etiquetas:action_command_lines
--[no]experimental_omitfp
valor predeterminado: "false"-
Si esta opción es "true", usa libunwind para desenrollar la pila y compila con -fomit-frame-pointer y -fasym-unwind-tables.
Etiquetas:action_command_lines
,affects_outputs
,experimental
--[no]experimental_platform_in_output_dir
valor predeterminado: "false"-
Si es verdadero, se usa la plataforma de destino en el nombre del directorio de salida en lugar de la CPU.
Etiquetas:affects_outputs
,experimental
--[no]experimental_use_llvm_covmap
valor predeterminado: "false"-
Si se especifica, Bazel generará información del mapa de cobertura llvm-cov en lugar de gcov cuando collect_code_coverage esté habilitado.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
yexperimental
--fat_apk_cpu=<comma-separated list of options>
predeterminado: "armeabi-v7a"-
Mediante la configuración de esta opción, se habilitan los APK multiarquitecturas, que contienen objetos binarios nativos para todas las arquitecturas de destino especificadas, p.ej., --fat_apk_cpu=x86,armeabi-v7a. Si se especifica esta marca, --android_cpu se ignora para dependencias de reglas android_binary.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]fat_apk_hwasan
valor predeterminado: "false"-
Determina si se deben crear divisiones HWASAN.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Configuración predeterminada de
--fdo_instrument=<a string>
: ver descripción - Genera objetos binarios con instrumentación de FDO. Con el compilador Clang/LLVM, también acepta el nombre de directorio bajo el cual se volcarán los archivos de perfil sin procesar durante el tiempo de ejecución.
Etiquetas:affects_outputs
- Configuración predeterminada de
--fdo_optimize=<a string>
: ver descripción - Usa la información del perfil de FDO para optimizar la compilación. Especifica el nombre de un archivo ZIP que contenga un árbol de archivos .gcda, un archivo afdo que contenga un perfil automático o un archivo de perfil de LLVM. Esta marca también acepta archivos especificados como etiquetas (p.ej., `//foo/bar:file.afdo` (es posible que debas agregar una directiva `exports_files` al paquete correspondiente) y etiquetas que apunten a objetivos de `fdo_profile`. Esta marca será reemplazada por la regla “fdo_profile”.
Etiquetas:affects_outputs
- Configuración predeterminada de
--fdo_prefetch_hints=<a build target label>
: ver descripción -
Usa sugerencias de carga previa de caché.
Etiquetas:affects_outputs
- Configuración predeterminada de
--fdo_profile=<a build target label>
: ver descripción -
El fdo_profile, que representa el perfil que se utilizará para la optimización.
Etiquetas:affects_outputs
- Se acumulan
--features=<a string>
usos múltiples -
Estas funciones estarán habilitadas o inhabilitadas de forma predeterminada para los destinos integrados en la configuración de destino. Si especificas -<feature>, se inhabilitará la función. Los atributos negativos siempre anulan a los positivos. Consulta también --host_features
Etiquetas:changes_inputs
,affects_outputs
--[no]force_pic
valor predeterminado: "false"-
Si se habilita, todas las compilaciones de C++ producen código independiente de la posición ("-fPIC"), los vínculos prefieren bibliotecas PIC compiladas previamente en lugar de bibliotecas que no son PIC, y los vínculos producen ejecutables independientes de la posición ("-pie").
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan
--host_action_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica el conjunto de variables de entorno disponibles para acciones con configuraciones de host o de ejecución. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o mediante el par nombre=valor que establece el valor independientemente del entorno de invocación. Esta opción se puede usar varias veces; para opciones proporcionadas para la misma variable, se acumulan los últimos éxitos, las opciones para diferentes variables se acumulan.
Etiquetas:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
valor predeterminado: "opt"- Especifica el modo en el que se integrarán las herramientas usadas durante la compilación. Valores: "fastbuild", "dbg", "opt".
Etiquetas:affects_outputs
,action_command_lines
- Se acumulan
--host_conlyopt=<a string>
usos múltiples -
Es una opción adicional para pasar a gcc cuando se compilan archivos de origen C para las herramientas de host.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--host_copt=<a string>
usos múltiples -
Opciones adicionales para pasar a gcc para las herramientas del host.
Etiquetas:action_command_lines
,affects_outputs
--host_cpu=<a string>
predeterminado: ""-
Es la CPU del host.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan
--host_cxxopt=<a string>
usos múltiples -
Opciones adicionales para pasar a gcc para las herramientas del host.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--host_features=<a string>
usos múltiples -
Las funciones determinadas estarán habilitadas o inhabilitadas de forma predeterminada para los destinos integrados en la configuración de ejecución. Si especificas -<feature>, se inhabilitará la función. Los atributos negativos siempre anulan a los positivos.
Etiquetas:changes_inputs
,affects_outputs
- Configuración predeterminada de
--host_force_python=<PY2 or PY3>
: ver descripción -
Anula la versión de Python para la configuración del host. Puede ser “PY2” o “PY3”.
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan
--host_linkopt=<a string>
usos múltiples -
Es una opción adicional para pasar a gcc cuando se vinculan las herramientas del host.
Etiquetas:action_command_lines
,affects_outputs
- Configuración predeterminada de
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima de macOS compatible para los destinos de host. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
usos múltiples -
Son opciones adicionales para pasar de forma selectiva al compilador C/C++ cuando se compilan ciertos archivos en las configuraciones de host o de ejecución. Esta opción se puede aprobar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter significa una lista de patrones de expresiones regulares de inclusión y exclusión (consulta también --instrumentation_filter). option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe ir entre comillas con una barra inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos gcc de todos los archivos cc en //foo/, excepto bar.cc.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--host_swiftcopt=<a string>
usos múltiples -
Opciones adicionales para pasar a swiftc para las herramientas del host.
Etiquetas:action_command_lines
,affects_outputs
- El valor predeterminado de
--[no]incompatible_avoid_conflict_dlls
es "true" (verdadero). -
Si se habilita, todas las bibliotecas dinámicas vinculadas (DLL) de C++ generadas por cc_library en Windows cambiarán de nombre por name_{hash}.dll, en el que el hash se calcula en función del RepositoryName y la ruta 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
- El valor predeterminado de
--[no]incompatible_merge_genfiles_directory
es "true" (verdadero). -
Si es verdadero, el directorio genfiles se pliega en el directorio bin.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_use_host_features
valor predeterminado: "false"-
Si es verdadero, usa --features solo para la configuración de destino y --host_features para la configuración de ejecución.
Etiquetas:changes_inputs
,affects_outputs
,incompatible_change
- El valor predeterminado de
--[no]incompatible_use_platforms_repo_for_constraints
es "true" (verdadero). -
Si es verdadero, se quitará la configuración de restricciones de @bazel_tools.
Etiquetas:affects_outputs
,incompatible_change
--[no]instrument_test_targets
valor predeterminado: "false"-
Cuando la cobertura está habilitada, especifica si se debe considerar la instrumentación de reglas de prueba. Cuando se establece, se instrumentan las reglas de prueba incluidas por --instrumentation_filter. De lo contrario, las reglas de prueba siempre se excluyen de la instrumentación de cobertura.
Etiquetas:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
valor predeterminado: "-/javatests[/:],-/test/java[/:]"-
Cuando la cobertura esté habilitada, solo se instrumentarán las reglas con nombres incluidos en el filtro basado en regex especificado. En su lugar, se excluyen las reglas con el prefijo “-”. Ten en cuenta que solo se instrumentan las reglas que no son de prueba, a menos que esté habilitado --instrument_test_targets.
Etiquetas:affects_outputs
- Configuración predeterminada de
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima de iOS compatible con los simuladores y dispositivos de destino. Si no se especifica, usa “ios_sdk_version”.
Etiquetas:loses_incremental_state
- Se acumulan
--ios_multi_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para compilar una ios_application. El resultado es un objeto binario universal que contiene todas las arquitecturas especificadas.
Etiquetas:loses_incremental_state
,loading_and_analysis
- El valor predeterminado de
--[no]legacy_whole_archive
es "true" (verdadero). -
Obsoleto y sustituido por --incompatible_remove_legacy_whole_archive (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener más información). Cuando esta opción está activada, se usa --whole-archive para reglas cc_binary que tengan linkshared=True y linkstatic=True o '-static' en linkopts. Esto es solo para retrocompatibilidad. Una mejor alternativa es usar Alwayslink=1 cuando sea necesario.
Etiquetas:action_command_lines
,affects_outputs
,deprecated
- Se acumulan
--linkopt=<a string>
usos múltiples -
Es una opción adicional para pasar a gcc durante la vinculación.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--ltobackendopt=<a string>
usos múltiples -
Es una opción adicional para pasar al paso de backend de LTO (en --features=thin_lto).
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--ltoindexopt=<a string>
usos múltiples -
Es una opción adicional para pasar al paso de indexación LTO (en --features=thin_lto).
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--macos_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se compilan objetos binarios de Apple macOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Configuración predeterminada de
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima de macOS compatible para los objetivos. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
--[no]objc_debug_with_GLIBCXX
valor predeterminado: "false"-
Si estableces la política y el modo de compilación está configurado como "dbg", define GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC y GLIBCPP_CONCEPT_CHECKS.
Etiquetas:action_command_lines
--[no]objc_enable_binary_stripping
valor predeterminado: "false"-
Determina si se deben quitar símbolos y códigos muertos en objetos binarios vinculados. Si se especifican esta marca y --compilation_mode=opt, se realizarán eliminaciones binarias.
Etiquetas:action_command_lines
- Se acumulan
--objccopt=<a string>
usos múltiples -
Opciones adicionales para pasar a gcc cuando se compilan archivos fuente Objective-C/C++.
Etiquetas:action_command_lines
- Se acumulan
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
usos múltiples -
Opciones adicionales para pasar selectivamente a gcc cuando se compilan ciertos archivos. Esta opción se puede aprobar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter significa una lista de patrones de expresiones regulares de inclusión y exclusión (consulta también --instrumentation_filter). option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe ir entre comillas con una barra inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos gcc de todos los archivos cc en //foo/, excepto bar.cc.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
usos múltiples -
Opciones adicionales para pasar de forma selectiva al backend de LTO (en --features=thin_lto) cuando se compilan ciertos objetos de backend. Esta opción se puede aprobar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter significa una lista de patrones de expresiones regulares de inclusión y exclusión, y option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe ir entre comillas con una barra inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos del backend de LTO de todos los archivos o en //foo/, excepto bar.o.
Etiquetas:action_command_lines
,affects_outputs
- Configuración predeterminada de
--platform_suffix=<a string>
: ver descripción -
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas:loses_incremental_state
,affects_outputs
,loading_and_analysis
- Configuración predeterminada de
--propeller_optimize=<a build target label>
: ver descripción -
Usa la información del perfil de Propeller para optimizar el objetivo de compilación.Un perfil de propulsor debe constar de al menos uno de dos archivos, un perfil cc y un perfil ld. Esta marca acepta una etiqueta de compilación que debe hacer referencia a los archivos de entrada del perfil de propulsor. Por ejemplo, el archivo BUILD que define la etiqueta La opción debe usarse de la siguiente manera: --propeller_optimize=//a/b:propeller_profile
Etiquetas:action_command_lines
,affects_outputs
- Configuración predeterminada de
--propeller_optimize_absolute_cc_profile=<a string>
: ver descripción -
Nombre de ruta de acceso absoluto del archivo cc_profile para compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
- Configuración predeterminada de
--propeller_optimize_absolute_ld_profile=<a string>
: ver descripción -
Nombre de ruta de acceso absoluto del archivo ld_profile para compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
- Configuración predeterminada de
--run_under=<a prefix in front of command>
: ver descripción -
Es el prefijo que se debe insertar antes de los ejecutables para los comandos “test” y “run”. Si el valor es “foo -bar”, y la línea de comandos de ejecución es “test_binary -baz”, la línea de comandos final es “foo -bar test_binary -baz”. También puede ser una etiqueta para un destino ejecutable. Estos son algunos ejemplos: 'valgrind', 'strace', 'strace -c', 'valgrind --quiet --num-callers=20', '//package:target', '//package:target --options'.
Etiquetas:action_command_lines
-
Si es "true", las bibliotecas nativas que contengan la misma funcionalidad se compartirán entre diferentes destinos
Etiquetas:loading_and_analysis
,affects_outputs
--[no]stamp
valor predeterminado: "false"-
Sella los objetos binarios con la fecha, el nombre de usuario, el nombre de host, la información del lugar de trabajo, etcétera.
Etiquetas:affects_outputs
- El valor predeterminado de
--strip=<always, sometimes or never>
es " a veces". -
Especifica si se quitan los objetos binarios y las bibliotecas compartidas (con "-Wl,--strip-debug"). El valor predeterminado de "algunas veces" significa quitar iff --compilation_mode=fastbuild.
Etiquetas:affects_outputs
- Se acumulan
--stripopt=<a string>
usos múltiples -
Opciones adicionales para quitar cuando se genera un objeto binario “<name>.stripped”.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--swiftcopt=<a string>
usos múltiples -
Opciones adicionales para pasar a la compilación de Swift.
Etiquetas:action_command_lines
- Configuración predeterminada de
--symlink_prefix=<a string>
: ver descripción -
Es el prefijo que se antepone a cualquiera de los symlinks de conveniencia que se crean después de una compilación. Si se omite, el valor predeterminado es el nombre de la herramienta de compilación seguido de un guion. Si se pasa “/”, no se crean symlinks ni se emite ninguna advertencia. Advertencia: La funcionalidad especial para “/” dejará de estar disponible pronto; en su lugar, usa --experimental_convenience_symlinks=ignore.
Etiquetas:affects_outputs
- Se acumulan
--tvos_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se compilan objetos binarios de Apple tvOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Configuración predeterminada de
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima de tvOS compatible para simuladores de objetivo y dispositivos. Si no se especifica, se usa "tvos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan
--visionos_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se compilan objetos binarios de visionOS de Apple.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Se acumulan
--watchos_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se compilan objetos binarios de watchOS de Apple.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Configuración predeterminada de
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima de watchOS compatible para los simuladores y dispositivos de destino. Si no se especifica, se usa “watchos_sdk_version”.
Etiquetas:loses_incremental_state
- Configuración predeterminada de
--xbinary_fdo=<a build target label>
: ver descripción - Usa la información del perfil de XbinaryFDO para optimizar la compilación. Especifica el nombre del perfil binario cruzado predeterminado. Cuando la opción se usa junto con --fdo_instrument/--fdo_optimize/--fdo_profile, esas opciones siempre prevalecerán como si nunca se especificara xbinary_fdo.
Etiquetas:affects_outputs
- Opciones que afectan la medida en la que Bazel aplica de manera estricta entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
--auto_cpu_environment_group=<a build target label>
predeterminado: ""-
Declara el entorno_group para asignarlo automáticamente a los valores de CPU a los valores target_environment.
Etiquetas:changes_inputs
,loading_and_analysis
,experimental
--[no]check_licenses
valor predeterminado: "false"-
Verifica que las restricciones de licencias impuestas por los paquetes dependientes no entren en conflicto con los modos de distribución de los destinos que se compilan. De forma predeterminada, las licencias no están marcadas.
Etiquetas:build_file_semantics
- El valor predeterminado de
--[no]check_visibility
es "true" (verdadero). - Si se inhabilita, los errores de visibilidad en las dependencias de destino descienden a advertencias.
Etiquetas:build_file_semantics
- El valor predeterminado de
--[no]desugar_for_android
es "true" (verdadero). -
Indica si se debe usar la expansión de sintaxis del código de bytes Java 8 antes de la conversión a DEX.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]desugar_java8_libs
valor predeterminado: "false"-
Determina si se deben incluir bibliotecas de Java 8 compatibles en apps para dispositivos heredados.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
yexperimental
- El valor predeterminado de
--[no]enforce_constraints
es "true" (verdadero). -
Verifica los entornos compatibles con cada destino y, luego, informa errores si algún destino tiene dependencias que no admiten los mismos entornos
Etiquetas:build_file_semantics
--[no]experimental_allow_android_library_deps_without_srcs
valor predeterminado: "false"-
Marca para facilitar la transición de permitir a deshabilitar reglas android_library de srcs-less con dependencias. Se debe limpiar el depósito para lanzarlo de forma predeterminada.
Etiquetas:eagerness_to_exit
,loading_and_analysis
- El valor predeterminado de
--[no]experimental_check_desugar_deps
es "true" (verdadero). -
Indica si se debe verificar la expansión de sintaxis correcta a nivel binario de Android.
Etiquetas:eagerness_to_exit
,loading_and_analysis
,experimental
- Configuración predeterminada de
--experimental_import_deps_checking=<off, warning or error>
: "DESACTIVADA" -
Cuando se habilita, verifica si las dependencias de aar_import están completas. Esta aplicación puede dañar la compilación o simplemente generar advertencias.
Etiquetas:loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
valor predeterminado: "default"-
Si es verdadero, verifica que un destino de Java declare de forma explícita todos los destinos usados de forma directa como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files
valor predeterminado: "false"-
Si se habilita esta opción, verifica los objetivos de solo prueba de los requisitos previos que sean archivos de salida. Para ello, busca el solo de prueba de la regla de generación. Esto coincide con la verificación de visibilidad.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_disable_native_android_rules
valor predeterminado: "false"-
Si se habilita, se inhabilita el uso directo de las reglas nativas de Android. Usa las reglas de Starlark para Android de https://github.com/bazelbuild/rules_android
Etiquetas:eagerness_to_exit
,incompatible_change
--[no]incompatible_disable_native_apple_binary_rule
valor predeterminado: "false"-
No-ops. Se conserva aquí para brindar retrocompatibilidad.
Etiquetas:eagerness_to_exit
,incompatible_change
- El valor predeterminado de
--[no]incompatible_force_strict_header_check_from_starlark
es "true" (verdadero). -
Si está habilitada, establece una verificación de encabezados estricta en la API de Starlark
Etiquetas:loading_and_analysis
,changes_inputs
,incompatible_change
- El valor predeterminado de
--[no]incompatible_validate_top_level_header_inclusions
es "true" (verdadero). -
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
valor predeterminado: "false"- Si se habilita esta opción, los conjuntos de archivos que cruzan los límites de los paquetes se informan como errores. No funciona cuando check_fileset_Dependencies_recursively está inhabilitado.
Etiquetas:build_file_semantics
,eagerness_to_exit
- El valor predeterminado de
--strict_proto_deps=<off, warn, error, strict or default>
es "error" -
A menos que esté DESACTIVADO, verifica que un destino proto_library declare de forma explícita todos los destinos usados de forma directa como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
- El valor predeterminado de
--strict_public_imports=<off, warn, error, strict or default>
es "desactivado" -
A menos que esté DESACTIVADO, verifica que un destino proto_library declare de forma explícita todos los destinos usados en "import public" como exportados.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
--[no]strict_system_includes
valor predeterminado: "false"-
Si es verdadero, también se deben declarar los encabezados que se encuentran a través de las rutas de inclusión del sistema (-isystem).
Etiquetas:loading_and_analysis
,eagerness_to_exit
- Se acumulan
--target_environment=<a build target label>
usos múltiples -
Declara el entorno de destino de esta compilación. Debe ser una referencia de etiqueta a una regla de “entorno”. Si se especifica, todos los destinos de nivel superior deben ser compatibles con este entorno.
Etiquetas:changes_inputs
- Opciones que afectan los resultados de firma de una compilación:
--apk_signing_method=<v1, v2, v1_v2 or v4>
predeterminado: "v1_v2"-
Implementación que se usa para firmar APKs
Etiquetas:action_command_lines
,affects_outputs
,loading_and_analysis
- El valor predeterminado de
--[no]device_debug_entitlements
es "true" (verdadero). -
Si se configura y el modo de compilación no es "opt", las apps de objc incluirán derechos de depuración durante la firma.
Etiquetas:changes_inputs
- Configuración predeterminada de
--ios_signing_cert_name=<a string>
: ver descripción -
Nombre del certificado que se usará para la firma de iOS. Si no la estableces, se recurrirá al perfil de aprovisionamiento. Puede ser la preferencia de identidad del llavero del certificado o (subcadena) del nombre común del certificado, según la página manual de la señal de código (SIGNING IDENTITIES).
Etiquetas:action_command_lines
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility
valor predeterminado: "false"-
Si es incompatible_enforce_config_setting_visibility=false, esta es una noop. De lo contrario, si la marca es falsa, cualquier config_setting sin un atributo de visibilidad explícito es //visibility:public. Si esta marca es verdadera, config_setting sigue la misma lógica de visibilidad que todas las demás reglas. Consulta https://github.com/bazelbuild/bazel/issues/12933.
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_disallow_legacy_py_provider
es "true" (verdadero). -
No-ops, se quitará pronto.
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_enforce_config_setting_visibility
es "true" (verdadero). -
Si es verdadero, aplica restricciones de visibilidad config_setting. Si es falso, cada config_setting es visible para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones que determinan el comportamiento del entorno de pruebas o del ejecutor de pruebas:
--[no]allow_analysis_failures
valor predeterminado: "false"-
Si es verdadero, una falla de análisis de un destino de regla provocará la propagación del objetivo de una instancia de AnalysisFailureInfo que contiene la descripción del error, en lugar de una falla de compilación.
Etiquetas:loading_and_analysis
,experimental
--analysis_testing_deps_limit=<an integer>
predeterminado: "2000"-
Establece la cantidad máxima de dependencias transitivas mediante un atributo de regla con una transición de configuración for_analysis_testing. Si se supera ese límite, se mostrará un error de regla.
Etiquetas:loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure
valor predeterminado: "false"-
Si se producen errores reales en la acción de dex2oat, la compilación falla en lugar de ejecutar dex2oat durante el tiempo de ejecución de la prueba.
Etiquetas:loading_and_analysis
,experimental
--[no]check_tests_up_to_date
valor predeterminado: "false"-
No ejecutes pruebas. Solo tienes que comprobar si están actualizadas. Si todos los resultados están actualizados, las pruebas se completarán de forma correcta. Si es necesario compilar o ejecutar alguna prueba, se informa un error y falla la prueba. Esta opción implica el comportamiento de --check_up_to_date.
Etiquetas:execution
--[no]experimental_android_use_parallel_dex2oat
valor predeterminado: "false"-
Usa dex2oat en paralelo para, quizás, acelerar android_test.
Etiquetas:loading_and_analysis
,host_machine_resource_optimizations
,experimental
- Se acumulan
--flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once>
usos múltiples -
Cada prueba se volverá a intentar la cantidad especificada de veces, en caso de que falle. Las pruebas que requieren más de un intento para aprobarse se marcan como "FLAKY" en el resumen. Normalmente, el valor especificado es solo un número entero o la cadena "default". Si es un número entero, todas las pruebas se ejecutarán hasta N veces. Si la política es "default", se realizará un solo intento para las pruebas regulares y tres para las pruebas marcadas explícitamente como inestables por su regla (falta=1). Sintaxis alternativa: regex_filter@flaky_test_attempts. Donde flaky_test_attempts es lo anterior y regex_filter significa una lista de patrones de expresiones regulares de inclusión y exclusión (también consulta --runs_per_test). Ejemplo: --flaky_test_attempts=//foo/.*,-//foo/bar/.*@3 disminuye todas las pruebas de //foo/ excepto las que se encuentran en foo/bar tres veces. Esta opción se puede aprobar varias veces. El último argumento pasado que coincida tendrá prioridad. Si no hay coincidencia, el comportamiento es “default” arriba.
Etiquetas:execution
--[no]ios_memleaks
valor predeterminado: "false"-
Habilita la comprobación de fugas de memoria en los destinos ios_test.
Etiquetas:action_command_lines
- Configuración predeterminada de
--ios_simulator_device=<a string>
: ver descripción -
Es el dispositivo que se simula cuando se ejecuta una aplicación para iOS en el simulador, p.ej., "iPhone 6". Para obtener una lista de dispositivos, ejecuta “xcrun simctl list devicetypes” en la máquina en que se ejecutará el simulador.
Etiquetas:test_runner
- Configuración predeterminada de
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Es la versión de iOS que se ejecutará en el simulador cuando se ejecute o realice pruebas. Esto se ignora para las reglas ios_test si se especifica un dispositivo de destino en la regla.
Etiquetas:test_runner
- Valor predeterminado de
--local_test_jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "auto" -
La cantidad máxima de trabajos de prueba locales que se ejecutan de forma simultánea. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguido de una operación ([-|*]<float>), p. ej., “auto”, “HOST_CPUS*.5”. 0 significa que los recursos locales limitarán la cantidad de trabajos de prueba locales para que se ejecuten simultáneamente. Establecer este parámetro como mayor que el valor de --jobs no es eficaz.
Etiquetas:execution
- Se acumulan
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
usos múltiples - Especifica la cantidad de veces que se debe ejecutar cada prueba. Si alguno de esos intentos falla por algún motivo, toda la prueba se considerará fallida. Normalmente, el valor especificado es solo un número entero. Ejemplo: --runs_per_test=3 ejecutará todas las pruebas 3 veces. Sintaxis alternativa: regex_filter@runs_per_test. Donde run_per_test significa un valor de número entero y regex_filter significa una lista de patrones de expresiones regulares de inclusión y exclusión (también consulta --instrumentation_filter). Ejemplo: --runs_per_test=//foo/.*,-//foo/bar/.*@3 ejecuta todas las pruebas en //foo/ excepto las que se encuentran en foo/bar tres veces. Esta opción se puede aprobar varias veces. El último argumento pasado que coincida tendrá prioridad. Si no hay coincidencia, la prueba se ejecuta solo una vez.
- Se acumulan
--test_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica variables de entorno adicionales que se insertarán en el entorno del ejecutor de pruebas. Las variables se pueden especificar por nombre, en cuyo caso su valor se leerá desde el entorno del cliente de Bazel o mediante el par nombre=valor. Esta opción se puede usar varias veces para especificar distintas variables. Solo lo usa el comando “bazel test”.
Etiquetas:test_runner
- El valor predeterminado de
--[no]test_keep_going
es "true" (verdadero). -
Cuando se inhabilita, cualquier prueba que no se apruebe hará que se detenga toda la compilación. De forma predeterminada, se ejecutan todas las pruebas, incluso si algunas no son exitosas.
Etiquetas:execution
--test_strategy=<a string>
predeterminado: ""-
Especifica qué estrategia usar cuando se ejecutan pruebas.
Etiquetas:execution
--test_timeout=<a single integer or comma-separated list of 4 integers>
valor predeterminado: "-1"- Anula los valores predeterminados de tiempo de espera de la prueba (en segundos). Si se especifica un solo valor entero positivo, se anularán todas las categorías. Si se especifican 4 números enteros separados por comas, estos anularán los tiempos de espera: corto, moderado, largo y eterno (en ese orden). En cualquier forma, un valor de -1 le indica a blaze que use sus tiempos de espera predeterminados para esa categoría.
- Configuración predeterminada de
--test_tmpdir=<a path>
: ver descripción - Especifica el directorio temporal base que debe usar "bazel test".
- Configuración predeterminada de
--tvos_simulator_device=<a string>
: ver descripción -
Es el dispositivo que se simula cuando se ejecuta una aplicación de 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 que se ejecutará el simulador.
Etiquetas:test_runner
- Configuración predeterminada de
--tvos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Es la versión de tvOS que se ejecutará en el simulador cuando se ejecute o realice pruebas.
Etiquetas:test_runner
- Configuración predeterminada de
--watchos_simulator_device=<a string>
: ver descripción -
Es el dispositivo que se simula cuando se ejecuta una aplicación de 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 que se ejecutará el simulador.
Etiquetas:test_runner
- Configuración predeterminada de
--watchos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Es la versión de watchOS que se ejecutará en el simulador cuando se ejecute o realice pruebas.
Etiquetas:test_runner
- El valor predeterminado de
--[no]zip_undeclared_test_outputs
es "true" (verdadero). -
Si es verdadero, los resultados de pruebas no declarados se archivarán en un archivo ZIP.
Etiquetas:test_runner
- Opciones que activan optimizaciones del tiempo de compilación:
--[no]collapse_duplicate_defines
valor predeterminado: "false"-
Cuando se habilita, el atributo redundante --define se quitará 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
valor predeterminado: "false"-
Filtra ProgramJar de ProGuard para quitar cualquier clase que también esté presente en LibraryJar.
Etiquetas:action_command_lines
- El valor predeterminado de
--[no]experimental_inmemory_dotd_files
es "true" (verdadero). -
Si se habilita, los archivos .d de C++ se pasarán directamente en la memoria desde los nodos de compilación remota, en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
yexperimental
- El valor predeterminado de
--[no]experimental_inmemory_jdeps_files
es "true" (verdadero). -
Si se habilita esta opción, los archivos de dependencia (.jdeps) generados a partir de compilaciones de Java se pasarán directamente a la memoria desde los nodos de compilación remota, en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
yexperimental
--[no]experimental_objc_include_scanning
valor predeterminado: "false"-
Indica si se debe realizar o no un análisis para el objetivo C/C++.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
--[no]experimental_parse_headers_skipped_if_corresponding_srcs_found
valor predeterminado: "false"-
Si se habilita, la función analyze_headers no crea una acción de compilación de encabezado independiente si se encuentra una fuente con el mismo nombre base en el mismo destino.
Etiquetas:loading_and_analysis
,affects_outputs
--[no]experimental_retain_test_configuration_across_testonly
valor predeterminado: "false"-
Cuando se habilita, --trim_test_configuration no recortará la configuración de prueba de las reglas marcadas como testonly=1. Esto tiene como objetivo reducir los problemas de conflicto de acciones cuando las reglas que no son de prueba dependen de las reglas cc_test. No tiene efecto si --trim_test_configuration es falso.
Etiquetas:loading_and_analysis
,loses_incremental_state
--[no]experimental_starlark_cc_import
valor predeterminado: "false"-
Si se habilita, se puede usar la versión de cc_import de Starlark.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_unsupported_and_brittle_include_scanning
valor predeterminado: "false"-
Determina si se deben reducir las entradas a la compilación de C/C++ analizando #include líneas de los archivos de entrada. Esto puede mejorar el rendimiento y la incrementalidad disminuyendo el tamaño de los árboles de entrada de la compilación. Sin embargo, también puede romper compilaciones porque el escáner de inclusión no implementa por completo la semántica del preprocesador de C. En particular, no comprende las directivas #include dinámicas e ignora la lógica condicional del preprocesador. Úsala bajo tu propia responsabilidad. Se cerrarán todos los problemas relacionados con esta marca que se presenten.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
- El valor predeterminado de
--[no]incremental_dexing
es "true" (verdadero). -
Realiza la mayor parte del trabajo para la conversión a DEX por separado para cada archivo Jar.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- El valor predeterminado de
--[no]objc_use_dotd_pruning
es "true" (verdadero). -
Si se configura, se usarán los archivos .d emitidos por Clang para reducir el conjunto de entradas que se pasaron a compilaciones de objc.
Etiquetas:changes_inputs
,loading_and_analysis
--[no]process_headers_in_dependencies
valor predeterminado: "false"-
Cuando compilas un destino //a:a, procesa los encabezados en todos los destinos de los que depende //a:a (si el procesamiento de encabezados está habilitado para la cadena de herramientas).
Etiquetas:execution
- El valor predeterminado de
--[no]trim_test_configuration
es "true" (verdadero). -
Cuando se habilita, las opciones relacionadas con pruebas se borrarán en el nivel superior de la compilación. Cuando esta marca está activa, las pruebas no se pueden compilar como dependencias de reglas que no sean de prueba, pero los cambios en las opciones relacionadas con pruebas no provocarán que las reglas que no son de prueba se vuelvan a analizar.
Etiquetas:loading_and_analysis
,loses_incremental_state
- El valor predeterminado de
--[no]use_singlejar_apkbuilder
es "true" (verdadero). -
Esta opción ya no está disponible. Ahora no es una función y se quitará pronto.
Etiquetas:loading_and_analysis
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]announce
valor predeterminado: "false"-
Obsoleto. No-ops
Etiquetas:affects_outputs
--[no]experimental_bep_target_summary
valor predeterminado: "false"- Determina si se publican eventos de TargetSummary.
--[no]experimental_build_event_expand_filesets
valor predeterminado: "false"-
Si es verdadero, expande los conjuntos de archivos en el BEP cuando presentes los archivos de salida.
Etiquetas:affects_outputs
--[no]experimental_build_event_fully_resolve_fileset_symlinks
valor predeterminado: "false"-
Si es verdadero, resuelve por completo los symlinks del conjunto de archivos relativos en el BEP cuando se presentan los archivos de salida. Requiere --experimental_build_event_expand_filesets.
Etiquetas:affects_outputs
--experimental_build_event_upload_max_retries=<an integer>
predeterminado: "4"-
Es la cantidad máxima de veces que Bazel debe reintentar subir un evento de compilación.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
: "1 s" -
Retraso inicial y mínimo para los reintentos de retirada exponencial cuando falla la carga de BEP (exponente: 1.6)
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--experimental_build_event_upload_strategy=<a string>
: ver descripción -
Selecciona cómo subir los artefactos a los que se hace referencia en el protocolo de eventos de compilación.
Etiquetas:affects_outputs
--[no]experimental_materialize_param_files_directly
valor predeterminado: "false"-
Si materializas archivos de parámetros, hazlo con escrituras directas en el disco.
Etiquetas:execution
--[no]experimental_stream_log_file_uploads
valor predeterminado: "false"-
Transmite las cargas de archivos de registro directamente al almacenamiento remoto en lugar de escribirlos en el disco.
Etiquetas:affects_outputs
- Configuración predeterminada de
--explain=<a path>
: ver descripción -
Hace que el sistema de compilación explique cada paso ejecutado de la compilación. La explicación se escribe en el archivo de registro especificado.
Etiquetas:affects_outputs
- El valor predeterminado de
--[no]legacy_important_outputs
es "true" (verdadero). -
Usa esta opción para suprimir la generación del campo relevant_outputs heredado en el evento TargetComplete. Para la integración de Bazel a ResultStore, se requiere relevant_outputs.
Etiquetas:affects_outputs
--[no]materialize_param_files
valor predeterminado: "false"-
Escribe archivos de parámetros intermedios para generar un árbol incluso cuando se usa la ejecución de acciones remotas. Es útil para depurar acciones. Esto está implícito por --subcommands y --verbose_failures.
Etiquetas:execution
--max_config_changes_to_show=<an integer>
predeterminado: "3"-
Cuando se descarta la caché de análisis debido a un cambio en las opciones de compilación, se muestra hasta la cantidad determinada de nombres de opciones modificados. Si el número asignado es -1, se mostrarán todas las opciones modificadas.
Etiquetas:terminal_output
--max_test_output_bytes=<an integer>
valor predeterminado: "-1"-
Especifica el tamaño máximo por registro de prueba que puede emitirse cuando --test_output es “errores” o “todos”. Es útil para evitar abrumar el resultado con un resultado de prueba demasiado ruidoso. El encabezado de prueba se incluye en el tamaño del registro. Los valores negativos implican que no hay límite. El resultado es todo o nada.
Etiquetas:test_runner
,terminal_output
,execution
- Configuración predeterminada de
--output_filter=<a valid Java regular expression>
: ver descripción -
Solo muestra advertencias para las reglas cuyo nombre coincida con la expresión regular proporcionada.
Etiquetas:affects_outputs
--progress_report_interval=<an integer in 0-3600 range>
predeterminado: "0"-
La cantidad de segundos que transcurren entre los informes de trabajos que aún se están ejecutando. El valor predeterminado 0 significa que el primer informe se imprimirá después de 10 segundos; luego, 30 segundos; después de ese progreso, se informa una vez por minuto. Cuando --curses está habilitado, el progreso se informa cada segundo.
Etiquetas:affects_outputs
--show_result=<an integer>
predeterminado: "1"-
Muestra los resultados de la compilación. Para cada destino, indica si se actualizó o no y, de ser así, una lista de los archivos de salida que se crearon. Los archivos impresos son cadenas convenientes para copiar y pegar en la shell a fin de ejecutarlos.
Esta opción requiere un argumento de número entero, que es el umbral de objetivos por encima del cual no se imprime la información del resultado. Por lo tanto, cero provoca la supresión del mensaje y MAX_INT hace que la impresión del resultado ocurra siempre. El valor predeterminado es uno.
Etiquetas:affects_outputs
--[no]subcommands
[-s
] predeterminado: "false"-
Muestra los subcomandos que se ejecutaron durante una compilación. Marcas relacionadas: --execution_log_json_file, --execution_log_binary_file (para registrar subcomandos en un archivo en un formato compatible con herramientas).
Etiquetas:terminal_output
--test_output=<summary, errors, all or streamed>
valor predeterminado: "summary"-
Especifica el modo de salida deseado. Los valores válidos son “summary” para mostrar solo el resumen del estado de la prueba, “errors” para imprimir también los registros de prueba de las pruebas fallidas, “all” para imprimir los registros de todas las pruebas y “stream” para generar los registros de todas las pruebas en tiempo real (esto forzará a que las pruebas se ejecuten de forma local, una a la vez, sin importar el valor de --test_strategy).
Etiquetas:test_runner
,terminal_output
,execution
--test_summary=<short, terse, detailed, none or testcase>
valor predeterminado: "short"-
Especifica el formato deseado del resumen de la prueba. Los valores válidos son “corto” para imprimir información solo sobre las pruebas ejecutadas; “terse”, para imprimir solo información sobre las pruebas fallidas que se ejecutaron, “detallado” para imprimir información detallada sobre casos de prueba con errores, “caso de prueba” para imprimir el resumen en la resolución del caso de prueba, no imprimir información detallada sobre casos de prueba fallidos y “ninguno” para omitir el resumen.
Etiquetas:terminal_output
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
predeterminado: "-.*"-
Imprime información de depuración durante la resolución de la cadena de herramientas. La marca toma una regex, que se compara con tipos de cadenas de herramientas y objetivos específicos para ver cuál depurar. Varias regex se pueden separar por comas y, luego, cada regex se verifica por separado. Nota: El resultado de esta marca es muy complejo y probablemente solo sea útil para los expertos en la resolución de la cadena de herramientas.
Etiquetas:terminal_output
--[no]verbose_explanations
valor predeterminado: "false"-
Aumenta la verbosidad de las explicaciones emitidas si --explain está habilitado. No tiene ningún efecto si --explain no está habilitado.
Etiquetas:affects_outputs
--[no]verbose_failures
valor predeterminado: "false"-
Si un comando falla, imprime la línea de comandos completa.
Etiquetas:terminal_output
- Opciones que especifican o modifican una entrada genérica a un comando de Bazel que no se incluye en otras categorías:
- Se acumulan
--aspects_parameters=<a 'name=value' assignment>
usos múltiples -
Especifica los valores de los parámetros de aspectos de la línea de comandos. Cada valor del parámetro se especifica con <param_name>=<param_value>. Por ejemplo, 'my_param=my_val', donde 'my_param' es un parámetro de algún aspecto en la lista --aspects o lo requiere un aspecto de la lista. Esta opción se puede usar varias veces. Sin embargo, no se puede asignar valores al mismo parámetro más de una vez.
Etiquetas:loading_and_analysis
- Se acumulan
--flag_alias=<a 'name=value' flag alias>
usos múltiples - Establece un nombre abreviado para una marca de Starlark. Toma un solo par clave-valor con el formato "<key>=<value>" como argumento.
Etiquetas:changes_inputs
--[no]incompatible_default_to_explicit_init_py
valor predeterminado: "false"-
Esta marca cambia el comportamiento predeterminado para que los archivos __init__.py ya no se creen automáticamente en los archivos de ejecución de los destinos de Python. De manera precisa, cuando un destino py_binary o py_test tiene legacy_create_init configurado como "auto" (predeterminado), se trata como falso si y solo si esta marca está configurada. Consulta https://github.com/bazelbuild/bazel/issues/10076.
Etiquetas:affects_outputs
,incompatible_change
- El valor predeterminado de
--[no]incompatible_py2_outputs_are_suffixed
es "true" (verdadero). -
Si es verdadero, los destinos compilados en la configuración de Python 2 aparecerán bajo una raíz de salida que incluye el sufijo “-py2”, mientras que los destinos compilados para Python 3 aparecerán en una raíz sin sufijo relacionado con Python. Esto significa que el symlink de conveniencia `bazel-bin` apuntará a los destinos de Python 3 en lugar de Python 2. Si habilitas esta opción, también se recomienda habilitar `--incompatible_py3_is_default`.
Etiquetas:affects_outputs
,incompatible_change
- El valor predeterminado de
--[no]incompatible_py3_is_default
es "true" (verdadero). -
Si el valor es true, los destinos `py_binary` y `py_test` que no establecen su atributo `python_version` (o `default_python_version`) se establecerán de forma predeterminada como PY3 en lugar de PY2. Si estableces esta marca, también se recomienda configurar `--incompatible_py2_outputs_are_sufsolution`.
Etiquetas:loading_and_analysis
,affects_outputs
,incompatible_change
- El valor predeterminado de
--[no]incompatible_use_python_toolchains
es "true" (verdadero). -
Si se configura como verdadera, las reglas nativas ejecutables de Python usarán el entorno de ejecución de Python especificado por la cadena de herramientas de Python, en lugar del entorno de ejecución proporcionado por marcas heredadas como --python_top.
Etiquetas:loading_and_analysis
,incompatible_change
- Configuración predeterminada de
--python_version=<PY2 or PY3>
: ver descripción -
Es el modo de versión principal de Python, que puede ser “PY2” o “PY3”. Ten en cuenta que los objetivos “py_binary” y “py_test” anulan esto (incluso si no especifican explícitamente una versión), por lo que, por lo general, no hay muchas razones para proporcionar esta marca.
Etiquetas:loading_and_analysis
,affects_outputs
,explicit_in_output_path
--target_pattern_file=<a string>
predeterminado: ""-
Si se configura, la compilación leerá los patrones del archivo que se menciona aquí, en lugar de hacerlo en la línea de comandos. Es un error especificar un archivo aquí, así como patrones de la línea de comandos.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remoto:
--experimental_remote_cache_eviction_retries=<an integer>
predeterminado: "0"-
La cantidad máxima de intentos de reintento si la compilación detectó un error de expulsión de caché remota. Un valor distinto de cero establecerá implícitamente --incompatible_remote_use_new_exit_code_for_lost_inputs como verdadero. Se generará un ID de invocación nuevo para cada intento. Si generas un ID de invocación y se lo proporcionas a Bazel con --invocation_id, no debes usar esta marca. En su lugar, establece la marca --incompatible_remote_use_new_exit_code_for_lost_inputs y verifica el código de salida 39.
Etiquetas:execution
- Opciones varias, que no están categorizadas:
- El valor predeterminado de
--[no]allow_analysis_cache_discard
es "true" (verdadero). -
Si se descarta la caché de análisis debido a un cambio en el sistema de compilación, configurar esta opción como falsa provocará que Bazel salga, en lugar de continuar con la compilación. Esta opción no tiene efecto cuando también se establece “discard_analysis_cache”.
Etiquetas:eagerness_to_exit
--[no]build_manual_tests
valor predeterminado: "false"- Fuerza la compilación de objetivos de prueba etiquetados como “manuales”. Las pruebas “manuales” se excluyen del procesamiento. Esta opción los obliga a compilarse (pero no a ejecutarse).
--build_tag_filters=<comma-separated list of options>
predeterminado: ""- Especifica una lista de etiquetas separadas por comas. Cada etiqueta puede estar precedida opcionalmente por “-” para especificar las etiquetas excluidas. Solo se crearán aquellos destinos que contengan al menos una etiqueta incluida y no contengan ninguna etiqueta excluida. Esta opción no afecta el conjunto de pruebas ejecutadas con el comando “test”, ya que se rigen por las opciones de filtrado de pruebas, por ejemplo, “--test_tag_filters”.
--[no]build_tests_only
valor predeterminado: "false"- Si se especifica, solo se compilarán las reglas *_test y test_suite, y se ignorarán otros destinos especificados en la línea de comandos. De forma predeterminada, se compilará todo lo que se solicitó.
--[no]cache_test_results
[-t
] predeterminado: "auto"- Si se configura como "auto", Bazel vuelve a ejecutar una prueba solo si (1) Bazel detecta cambios en la prueba o sus dependencias, (2) la prueba se marca como externa, (3) se solicitaron varias ejecuciones de prueba con --runs_per_test o(4) si la prueba falló anteriormente. Si se configura como “sí”, Bazel almacena en caché todos los resultados de la prueba, excepto las que se marcaron como externas. Si se configura como “no”, Bazel no almacena en caché ningún resultado de prueba.
--[no]compile_one_dependency
valor predeterminado: "false"- Compila una sola dependencia de los archivos de argumentos. Esto es útil para verificar la sintaxis de los archivos de origen en IDE, por ejemplo, cuando vuelves a compilar un solo destino que depende del archivo de origen para detectar errores lo antes posible en el ciclo de edición, compilación y prueba. Este argumento afecta la forma en que se interpretan todos los argumentos que no son marcadores; en lugar de ser objetivos para compilar, son nombres de archivo de origen. Para cada nombre de archivo de origen, se compilará un destino arbitrario que dependa de él.
--deleted_packages=<comma-separated list of package names>
predeterminado: ""- Una lista separada por comas de los nombres de los paquetes que el sistema de compilación considerará que no existen, incluso si están visibles en algún lugar de la ruta del paquete. Usa esta opción cuando borres un subpaquete 'x/y' de un paquete 'x' existente. Por ejemplo, después de borrar x/y/BUILD en el cliente, el sistema de compilación puede presentar un reclamo si encuentra la etiqueta '//x:y/z' si todavía la proporciona otra entrada package_path. Si especificas --deleted_packages x/y se evita este problema.
--[no]discard_analysis_cache
valor predeterminado: "false"- Descartar la caché de análisis inmediatamente después de que se complete la fase de análisis. Reduce el uso de memoria en aproximadamente un 10%, pero ralentiza las compilaciones incrementales adicionales.
- Configuración predeterminada de
--execution_log_binary_file=<a path>
: ver descripción - Registra los generadores ejecutados en este archivo como protos de Spawn delimitados, de acuerdo con src/main/protobuf/spawn.proto. Primero, el registro se escribe desordenado y, luego, al final de la invocación, se ordena en un orden estable (puede hacer uso intensivo de CPU y memoria). Marcas relacionadas: --execution_log_json_file (formato json de texto ordenado), --experimental_execution_log_file (formato protobuf binario no ordenado), --subcomandos (para mostrar subcomandos en el resultado de terminal).
- Configuración predeterminada de
--execution_log_json_file=<a path>
: ver descripción - Registra los generadores ejecutados en este archivo como una representación JSON de los protos de Spawn delimitados, de acuerdo con src/main/protobuf/spawn.proto. Primero, el registro se escribe desordenado y, luego, al final de la invocación, se ordena en un orden estable (puede hacer uso intensivo de CPU y memoria). Marcas relacionadas: marcas relacionadas: --execution_log_binary_file (formato protobuf binario ordenado), --experimental_execution_log_file (formato protobuf binario no ordenado), --subcomandos (para mostrar subcomandos en el resultado de terminal).
- El valor predeterminado de
--[no]execution_log_sort
es "true" (verdadero). - Determina si se debe ordenar el registro de ejecución. Se establece como false para mejorar el rendimiento de la memoria, a costa de producir el registro en un orden no determinista.
- El valor predeterminado de
--[no]expand_test_suites
es "true" (verdadero). -
Amplía los objetivos de test_suite en las pruebas constituyentes antes del análisis. Cuando esta marca está activada (configuración predeterminada), se aplicarán patrones de objetivo negativos a las pruebas que pertenezcan al paquete de pruebas; de lo contrario, no. Desactivar esta marca es útil cuando los aspectos de nivel superior se aplican en la línea de comandos: entonces pueden analizar los objetivos de test_suite.
Etiquetas:loading_and_analysis
--[no]experimental_cancel_concurrent_tests
valor predeterminado: "false"-
Si es "true", el Blaze cancelará las pruebas que se ejecutan de forma simultánea en la primera ejecución exitosa. Esto solo es útil en combinación con --runs_per_test_detects_flakes.
Etiquetas:affects_outputs
,loading_and_analysis
- Configuración predeterminada de
--experimental_execution_log_file=<a path>
: ver descripción - Registra los generadores ejecutados en este archivo como protos de Spawn delimitados, de acuerdo con src/main/protobuf/spawn.proto. Este archivo está escrito en el orden de ejecución de los Generados. Marcas relacionadas: --execution_log_binary_file (formato protobuf binario ordenado), --execution_log_json_file (formato JSON de texto ordenado), --subcomandos (para mostrar subcomandos en el resultado de terminal).
--[no]experimental_execution_log_spawn_metrics
valor predeterminado: "false"- Incluye las métricas de generación en el registro de generaciones ejecutadas.
--experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
predeterminado: ""- Se dio de baja a favor de los aspectos. Filtra el conjunto de objetivos para los que se programan acciones adicionales.
--[no]experimental_extra_action_top_level_only
valor predeterminado: "false"- Se dio de baja a favor de los aspectos. Solo programa las acciones adicionales para los objetivos de nivel superior.
--[no]experimental_fetch_all_coverage_outputs
valor predeterminado: "false"-
Si es verdadero, Bazel recupera todo el directorio de datos de cobertura para cada prueba durante una ejecución de cobertura.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_generate_llvm_lcov
valor predeterminado: "false"-
Si es "true", la cobertura de Clang generará un informe de LCOV.
Etiquetas:affects_outputs
,loading_and_analysis
- El valor predeterminado de
--[no]experimental_j2objc_header_map
es "true" (verdadero). - Indica si se debe generar el mapa de encabezados de J2ObjC en paralelo de la transpilación de J2ObjC.
--[no]experimental_j2objc_shorter_header_path
valor predeterminado: "false"-
Indica si se debe generar con una ruta de encabezado más corta (usa "_ios" en lugar de "_j2objc").
Etiquetas:affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
predeterminado: "javabuilder"- Habilita rutas de clase reducidas para compilaciones de Java.
--[no]experimental_limit_android_lint_to_android_constrained_java
valor predeterminado: "false"- Limita --experimental_run_android_lint_on_java_rules a bibliotecas compatibles con Android.
Etiquetas:affects_outputs
- El valor predeterminado de
--[no]experimental_prioritize_local_actions
es "true" (verdadero). -
Si se configura, las acciones que solo se pueden ejecutar de forma local tienen una primera oportunidad de adquirir recursos, los trabajadores que se ejecutan de forma dinámica tienen una segunda oportunidad y las acciones independientes ejecutadas de forma dinámica quedan en último lugar.
Etiquetas:execution
--[no]experimental_run_android_lint_on_java_rules
valor predeterminado: "false"- Determina si se deben validar las fuentes java_*.
Etiquetas:affects_outputs
--[no]explicit_java_test_deps
valor predeterminado: "false"- Especifica de forma explícita una dependencia a JUnit o Hamcrest en una java_test, en lugar de obtenerla accidentalmente desde las dependencias de TestRunner. Por el momento, solo funciona para Bazel.
- Configuración predeterminada de
--host_java_launcher=<a build target label>
: ver descripción - El Selector de Java utilizado por las herramientas que se ejecutan durante una compilación.
- Se acumulan
--host_javacopt=<a string>
usos múltiples - Son opciones adicionales para pasar a javac cuando se compilan herramientas que se ejecutan durante una compilación.
- Se acumulan
--host_jvmopt=<a string>
usos múltiples - Opciones adicionales para pasar a la VM de Java cuando se compilan herramientas que se ejecutan durante la compilación. Estas opciones se agregarán a las opciones de inicio de la VM de cada destino java_binary.
--[no]incompatible_check_sharding_support
valor predeterminado: "false"-
Si es verdadero, Bazel fallará una prueba fragmentada si el ejecutor de pruebas no indica que admite la fragmentación tocando el archivo en la ruta de acceso en TEST_SHARD_STATUS_FILE. Si es falso, un ejecutor de pruebas que no admita la fragmentación hará que se ejecuten todas las pruebas en cada fragmento.
Etiquetas:incompatible_change
--[no]incompatible_exclusive_test_sandboxed
valor predeterminado: "false"-
Si es verdadero, se ejecutarán pruebas exclusivas con la estrategia de zona de pruebas. Agrega la etiqueta “local” para forzar una ejecución de prueba exclusiva de forma local.
Etiquetas:incompatible_change
--[no]incompatible_strict_action_env
valor predeterminado: "false"-
Si es verdadero, Bazel usa un entorno con un valor estático para PATH y no hereda LD_LIBRARY_PATH. Usa --action_env=ENV_VARIABLE si deseas heredar variables de entorno específicas del cliente, pero ten en cuenta que esto puede evitar el almacenamiento en caché entre usuarios si se usa una caché compartida.
Etiquetas:loading_and_analysis
,incompatible_change
- Se acumulan
--j2objc_translation_flags=<comma-separated list of options>
usos múltiples - Opciones adicionales para pasar a la herramienta J2ObjC.
--java_debug
-
Hace que la máquina virtual Java de una prueba de Java espere una conexión de un depurador compatible con JDWP (como jdb) antes de comenzar la prueba. Insinúa -test_output=streamed.
Se expande a:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
- El valor predeterminado de
--[no]java_deps
es "true" (verdadero). - Genera información de dependencias (por ahora, la ruta de clase en tiempo de compilación) por destino de Java.
- El valor predeterminado de
--[no]java_header_compilation
es "true" (verdadero). - Compila ijars directamente desde la fuente.
--java_language_version=<a string>
predeterminado: "8"- La versión del lenguaje Java
- Configuración predeterminada de
--java_launcher=<a build target label>
: ver descripción - El Selector de Java que se usa cuando se compilan objetos binarios de Java. Si esta marca se establece en una cadena vacía, se usa el selector de JDK. El atributo "launcher" anula esta marca.
--java_runtime_version=<a string>
valor predeterminado: "local_jdk"- La versión del entorno de ejecución de Java
- Se acumulan
--javacopt=<a string>
usos múltiples - Opciones adicionales para pasar a javac.
- Se acumulan
--jvmopt=<a string>
usos múltiples - Opciones adicionales para pasar a la VM de Java. Estas opciones se agregarán a las opciones de inicio de la VM de cada destino java_binary.
- Configuración predeterminada de
--legacy_main_dex_list_generator=<a build target label>
: ver descripción - Especifica un objeto binario que se usará para generar la lista de clases que deben estar en el DEX principal cuando se compila multidex heredado.
- Valor predeterminado de
--local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>
: "HOST_CPUS" - Establece de forma explícita la cantidad total de núcleos de CPU locales disponibles para que Bazel invierta en acciones de compilación ejecutadas de forma local. Toma un número entero o "HOST_CPUS", opcionalmente seguido de [-|*]<float> (p. ej., HOST_CPUS*.5 para usar la mitad de los núcleos de CPU disponibles).De forma predeterminada, (“HOST_CPUS”), Bazel consultará la configuración del sistema para estimar la cantidad de núcleos de CPU disponibles.
- Se acumulan
--local_extra_resources=<a named float, 'name=value'>
usos múltiples - Establece la cantidad de recursos adicionales disponibles para Bazel. Toma un par de cadena-flotante. Se puede usar varias veces para especificar varios tipos de recursos adicionales. Bazel limitará las acciones que se ejecutan de forma simultánea según los recursos adicionales disponibles y necesarios. Las pruebas pueden declarar la cantidad de recursos adicionales que necesitan usando una etiqueta con el formato “resources:<resoucename>:<amount>”. La CPU, la RAM y los recursos disponibles no se pueden configurar con esta marca.
- Valor predeterminado de
--local_ram_resources=<an integer, or "HOST_RAM", optionally followed by [-|*]<float>.>
: "HOST_RAM*.67" - Establece de forma explícita la cantidad total de RAM del host local (en MB) disponible para que Bazel invierta en acciones de compilación ejecutadas de forma local. Toma un número entero, o “HOST_RAM”, opcionalmente seguido de [-|*]<float> (p. ej., HOST_RAM*.5 para usar la mitad de la RAM disponible). De forma predeterminada, ("HOST_RAM*.67"), Bazel consultará la configuración del sistema para estimar la cantidad de RAM disponible y usará el 67%.
--local_termination_grace_seconds=<an integer>
predeterminado: "15"- Tiempo de espera entre la finalización de un proceso local debido al tiempo de espera y el cierre forzado.
--package_path=<colon-separated list of options>
predeterminado: "%workspace%"- Una lista separada por dos puntos sobre dónde buscar paquetes. Los elementos que comienzan con "%workspace%" son relativos al lugar de trabajo que lo contiene. Si se omite o está vacío, el valor predeterminado es el resultado de “bazel info default-package-path”.
- Se acumulan
--plugin=<a build target label>
usos múltiples - Complementos para usar en la compilación. Actualmente, funciona con java_plugin.
- Configuración predeterminada de
--proguard_top=<a build target label>
: ver descripción - Especifica qué versión de ProGuard se usará para quitar código cuando se compile un objeto binario de Java.
--proto_compiler=<a build target label>
predeterminado: "@bazel_tools//tools/proto:protoc"-
Es la etiqueta del compilador de protocolos.
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
predeterminado: "@bazel_tools//tools/proto:cc_toolchain"-
Etiqueta de proto_lang_toolchain(), que describe cómo compilar protos de C++
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
predeterminado: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"-
Etiqueta de proto_lang_toolchain(), que describe cómo compilar protos j2objc
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
valor predeterminado: "@bazel_tools//tools/proto:java_toolchain"-
Etiqueta de proto_lang_toolchain(), que describe cómo compilar protos de Java
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
valor predeterminado: "@bazel_tools//tools/proto:javalite_toolchain"-
Etiqueta de proto_lang_toolchain(), que describe cómo compilar protos de JavaLite
Etiquetas:affects_outputs
,loading_and_analysis
- Se acumulan
--protocopt=<a string>
usos múltiples -
Son opciones adicionales para pasar al compilador de protobuf.
Etiquetas:affects_outputs
--[no]runs_per_test_detects_flakes
valor predeterminado: "false"- Si es verdadero, cualquier fragmento en el que al menos una ejecución o un intento se complete y al menos uno falle tenga un estado FLAKY.
- Configuración predeterminada de
--shell_executable=<a path>
: ver descripción -
Ruta de acceso absoluta al shell ejecutable para que lo use Bazel. Si no se configura, pero la variable de entorno BAZEL_SH está configurada en la primera invocación de Bazel (que inicia un servidor de Bazel), Bazel la usa. Si no se establece ninguno, Bazel usa una ruta de acceso predeterminada hard-coded según el sistema operativo en el que se ejecuta (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, todos los demás: /bin/bash). Ten en cuenta que el uso de una shell que no es compatible con Bash puede provocar fallas de compilación o de tiempo de ejecución de los objetos binarios generados.
Etiquetas:loading_and_analysis
- El valor predeterminado de
--[no]show_loading_progress
es "true" (verdadero). - Si se habilita, hace que Bazel imprima mensajes "Cargando paquete:".
- Se acumulan
--test_arg=<a string>
usos múltiples - Especifica opciones y argumentos adicionales que se deben pasar al ejecutable de prueba. Se puede usar varias veces para especificar varios argumentos. Si se ejecutan varias pruebas, cada una recibirá argumentos idénticos. Solo lo usa el comando “bazel test”.
- Configuración predeterminada de
--test_filter=<a string>
: ver descripción - Especifica un filtro para reenviar al framework de pruebas. Se usa para limitar la ejecución de pruebas. Ten en cuenta que esto no afecta los destinos que se compilan.
--test_lang_filters=<comma-separated list of options>
predeterminado: ""- Especifica una lista de idiomas de prueba separados por comas. De manera opcional, cada idioma puede ir precedido de “-” para especificar los idiomas excluidos. Solo se encontrarán las ubicaciones de prueba que estén escritas en los idiomas especificados. El nombre que se usa para cada lenguaje debe ser el mismo que el prefijo de idioma en la regla *_test, p.ej., "cc", "java", "py", etc. Esta opción afecta el comportamiento de --build_tests_only y el comando de prueba.
--test_result_expiration=<an integer>
valor predeterminado: "-1"- Esta opción dejó de estar disponible y no tiene efecto.
--[no]test_runner_fail_fast
valor predeterminado: "false"- Reenvía la opción de falla rápida al ejecutor de pruebas. El ejecutor de pruebas debe detener la ejecución en la primera falla.
- Valor predeterminado de
--test_sharding_strategy=<explicit or disabled>
: "explícito" - Especifica una estrategia para la fragmentación de pruebas: "explícito" para usar solo la fragmentación si está presente el atributo de COMPILACIÓN "shard_count". “inhabilitado” para no usar nunca la fragmentación de pruebas.
--test_size_filters=<comma-separated list of values: small, medium, large or enormous>
predeterminado: ""- Especifica una lista de tamaños de prueba separados por comas. Cada tamaño puede estar precedido opcionalmente por “-” para especificar los tamaños excluidos. Solo se encontrarán los objetivos de prueba que contengan al menos un tamaño incluido y no contengan ningún tamaño excluido. Esta opción afecta el comportamiento de --build_tests_only y el comando de prueba.
--test_tag_filters=<comma-separated list of options>
predeterminado: ""- Especifica una lista de etiquetas de prueba separadas por comas. Cada etiqueta puede estar precedida opcionalmente por “-” para especificar las etiquetas excluidas. Solo se encontrarán los destinos de prueba que contengan al menos una etiqueta incluida y no contengan ninguna etiqueta excluida. Esta opción afecta el comportamiento de --build_tests_only y el comando de prueba.
--test_timeout_filters=<comma-separated list of values: short, moderate, long or eternal>
predeterminado: ""- Especifica una lista separada por comas de tiempos de espera de pruebas. Cada tiempo de espera puede estar precedido opcionalmente por “-” para especificar los tiempos de espera excluidos. Solo se encontrarán los destinos de prueba que contengan al menos un tiempo de espera incluido y no contengan tiempos de espera excluidos. Esta opción afecta el comportamiento de --build_tests_only y el comando de prueba.
--tool_java_language_version=<a string>
predeterminado: "8"- La versión del lenguaje Java que se usa para ejecutar las herramientas que se necesitan durante una compilación
--tool_java_runtime_version=<a string>
predeterminado: "remotejdk_11"- La versión del entorno de ejecución de Java que se usa para ejecutar herramientas durante la compilación
- El valor predeterminado de
--[no]use_ijars
es "true" (verdadero). - Si se habilita, esta opción hace que la compilación de Java use archivos jar de la interfaz. Esto dará como resultado una compilación incremental más rápida, pero los mensajes de error pueden ser diferentes.
Opciones de marcas de canonicalización
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Más lugares donde buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
valor predeterminado: "false"-
Si se configura, la caché del repositorio vinculará el archivo de forma fija en caso de un acierto de caché, en lugar de copiar. Esto sirve para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
valor predeterminado: "false"-
Si es verdadero, usa una string derivada de las URLs de descargas del repositorio como canonical_id si no se especifica. Esto provoca que un cambio en las URLs genere una nueva descarga incluso si la caché contiene una descarga con el mismo hash. Se puede usar para verificar que los cambios en la URL no den como resultado que la caché oculte los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
valor predeterminado: "false"-
Si se configura, no se permite la descarga de repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Usa este factor para escalar todos los tiempos de espera en las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que sean más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación en caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una string vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que controlan el resultado del comando:
--[no]canonicalize_policy
valor predeterminado: "false"-
Muestra la política canónica, después de la expansión y el filtrado. Para mantener el resultado limpio, los argumentos del comando canonicalizados NO se mostrarán cuando esta opción se establezca en true. Ten en cuenta que el comando especificado por --for_command afecta la política filtrada y, si no se especifica ninguno, el comando predeterminado es "build".
Etiquetas:affects_outputs
,terminal_output
--[no]show_warnings
valor predeterminado: "false"-
Muestra advertencias del analizador en un error estándar (p.ej., para opciones de marcas en conflicto).
Etiquetas:affects_outputs
,terminal_output
- Opciones que afectan la medida en la que Bazel aplica de manera estricta las 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 hashes del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan
--experimental_verify_repository_rules=<a string>
usos múltiples -
Si es una lista de reglas de repositorio para las que se debe verificar el hash del directorio de salida, siempre que un archivo se especifique mediante --experimental_repository_hash_file.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE.:
- El valor predeterminado de
--[no]experimental_allow_top_level_aspects_parameters
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,deprecated
,experimental
--[no]incompatible_config_setting_private_default_visibility
valor predeterminado: "false"-
Si es incompatible_enforce_config_setting_visibility=false, esta es una noop. De lo contrario, si la marca es falsa, cualquier config_setting sin un atributo de visibilidad explícito es //visibility:public. Si esta marca es verdadera, config_setting sigue la misma lógica de visibilidad que todas las demás reglas. Consulta https://github.com/bazelbuild/bazel/issues/12933.
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_enforce_config_setting_visibility
es "true" (verdadero). -
Si es verdadero, aplica restricciones de visibilidad config_setting. Si es falso, cada config_setting es visible para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones relacionadas con la semántica y el resultado de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Especificaste las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirá en el gráfico de dependencias resueltas incluso si se declararon de forma privada en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones anteriores harán que la resolución falle. También puedes definir la versión transferida permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
- El valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
es "error" -
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son “error” para derivarlo a una falla de resolución, “off” para inhabilitar la verificación o “warning” para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas `bazel_dep` declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son “off” para inhabilitar la verificación, “warning” para imprimir una advertencia cuando se detecte una discrepancia o “error” para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
valor predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- El valor predeterminado de
--lockfile_mode=<off, update or error>
es "desactivado" -
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son “update” para usar el archivo de bloqueo y actualizarlo si hay cambios; “error” para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o “off” para no leerlo ni escribirlo en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y se recurrirá únicamente a los posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
valor predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán estadísticas para todos los mnemotécnicos.
- Opciones que especifican o alteran una entrada genérica a un comando de Bazel que no pertenece a otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE
Etiquetas:changes_inputs
--for_command=<a string>
valor predeterminado: "build"-
Es el comando para el que se deben canonicalizar las opciones.
Etiquetas:affects_outputs
,terminal_output
--invocation_policy=<a string>
predeterminado: ""-
Aplica una política de invocación a las opciones que se canonicalizarán.
Etiquetas:affects_outputs
,terminal_output
- Opciones de ejecución y almacenamiento en caché remoto:
- Configuración predeterminada de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo para configurar el cargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno con el que debe coincidir y otro para usar como URL sustitutiva, con referencias inversas que comienzan con "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL, y se mostrarán varias URL.
- Opciones varias, que no están categorizadas:
--deleted_packages=<comma-separated list of package names>
predeterminado: ""- Una lista separada por comas de los nombres de los paquetes que el sistema de compilación considerará que no existen, incluso si están visibles en algún lugar de la ruta del paquete. Usa esta opción cuando borres un subpaquete 'x/y' de un paquete 'x' existente. Por ejemplo, después de borrar x/y/BUILD en el cliente, el sistema de compilación puede presentar un reclamo si encuentra la etiqueta '//x:y/z' si todavía la proporciona otra entrada package_path. Si especificas --deleted_packages x/y se evita este problema.
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
--package_path=<colon-separated list of options>
predeterminado: "%workspace%"- Una lista separada por dos puntos sobre dónde buscar paquetes. Los elementos que comienzan con "%workspace%" son relativos al lugar de trabajo que lo contiene. Si se omite o está vacío, el valor predeterminado es el resultado de “bazel info default-package-path”.
- El valor predeterminado de
--[no]show_loading_progress
es "true" (verdadero). - Si se habilita, hace que Bazel imprima mensajes "Cargando paquete:".
Opciones de limpieza
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Más lugares donde buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
valor predeterminado: "false"-
Si se configura, la caché del repositorio vinculará el archivo de forma fija en caso de un acierto de caché, en lugar de copiar. Esto sirve para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
valor predeterminado: "false"-
Si es verdadero, usa una string derivada de las URLs de descargas del repositorio como canonical_id si no se especifica. Esto provoca que un cambio en las URLs genere una nueva descarga incluso si la caché contiene una descarga con el mismo hash. Se puede usar para verificar que los cambios en la URL no den como resultado que la caché oculte los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
valor predeterminado: "false"-
Si se configura, no se permite la descarga de repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Usa este factor para escalar todos los tiempos de espera en las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que sean más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación en caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una string vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que controlan el resultado del comando:
--[no]async
valor predeterminado: "false"- Si es verdadero, la limpieza de resultados es asíncrona. Cuando se complete este comando, será seguro ejecutar comandos nuevos en el mismo cliente, aunque la eliminación continúe en segundo plano.
Etiquetas:host_machine_resource_optimizations
--[no]expunge
valor predeterminado: "false"-
Si el valor es verdadero, clean quita todo el árbol de trabajo de esta instancia de Bazel, que incluye todos los archivos temporales y de salida de compilación creados por Bazel, y detiene el servidor de Bazel si está en ejecución.
Etiquetas:host_machine_resource_optimizations
--expunge_async
-
Si se especifica, clean de forma asíncrona quita todo el árbol de trabajo para esta instancia de Bazel, que incluye todos los archivos temporales y de salida de compilación creados por Bazel, y detiene el servidor de Bazel si está en ejecución. Cuando se complete este comando, será seguro ejecutar comandos nuevos en el mismo cliente, aunque la eliminación continúe en segundo plano.
Se expande a:
--expunge
--async
Etiquetas:host_machine_resource_optimizations
--[no]remove_all_convenience_symlinks
valor 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 medida en la que Bazel aplica de manera estricta 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 hashes del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan
--experimental_verify_repository_rules=<a string>
usos múltiples -
Si es una lista de reglas de repositorio para las que se debe verificar el hash del directorio de salida, siempre que un archivo se especifique mediante --experimental_repository_hash_file.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE.:
- El valor predeterminado de
--[no]experimental_allow_top_level_aspects_parameters
es "true" (verdadero). -
No-op
Etiquetas:no_op
,deprecated
,experimental
- Opciones relacionadas con la semántica y el resultado de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Especificaste las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirá en el gráfico de dependencias resueltas incluso si se declararon de forma privada en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones anteriores harán que la resolución falle. También puedes definir la versión transferida permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
- El valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
es "error" -
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son “error” para derivarlo a una falla de resolución, “off” para inhabilitar la verificación o “warning” para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas `bazel_dep` declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son “off” para inhabilitar la verificación, “warning” para imprimir una advertencia cuando se detecte una discrepancia o “error” para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
valor predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- El valor predeterminado de
--lockfile_mode=<off, update or error>
es "desactivado" -
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son “update” para usar el archivo de bloqueo y actualizarlo si hay cambios; “error” para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o “off” para no leerlo ni escribirlo en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y se recurrirá únicamente a los posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
valor predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán estadísticas para todos los mnemotécnicos.
- Opciones que especifican o alteran una entrada genérica a un comando de Bazel que no pertenece a otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remoto:
- Configuración predeterminada de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo para configurar el cargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno con el que debe coincidir y otro para usar como URL sustitutiva, con referencias inversas que comienzan con "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL, y se mostrarán varias URL.
- Opciones varias, que no están categorizadas:
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
Opciones de configuración
Opciones de cobertura
Hereda todas las opciones de test.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Más lugares donde buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
valor predeterminado: "false"-
Si se configura, la caché del repositorio vinculará el archivo de forma fija en caso de un acierto de caché, en lugar de copiar. Esto sirve para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
valor predeterminado: "false"-
Si es verdadero, usa una string derivada de las URLs de descargas del repositorio como canonical_id si no se especifica. Esto provoca que un cambio en las URLs genere una nueva descarga incluso si la caché contiene una descarga con el mismo hash. Se puede usar para verificar que los cambios en la URL no den como resultado que la caché oculte los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
valor predeterminado: "false"-
Si se configura, no se permite la descarga de repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Usa este factor para escalar todos los tiempos de espera en las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que sean más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación en caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una string vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que afectan la medida en la que Bazel aplica de manera estricta las 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 hashes del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan
--experimental_verify_repository_rules=<a string>
usos múltiples -
Si es una lista de reglas de repositorio para las que se debe verificar el hash del directorio de salida, siempre que un archivo se especifique mediante --experimental_repository_hash_file.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE.:
- El valor predeterminado de
--[no]experimental_allow_top_level_aspects_parameters
es "true" (verdadero). -
No-op
Etiquetas:no_op
,deprecated
,experimental
- Opciones relacionadas con la semántica y el resultado de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Especificaste las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirá en el gráfico de dependencias resueltas incluso si se declararon de forma privada en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones anteriores harán que la resolución falle. También puedes definir la versión transferida permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
- El valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
es "error" -
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son “error” para derivarlo a una falla de resolución, “off” para inhabilitar la verificación o “warning” para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas `bazel_dep` declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son “off” para inhabilitar la verificación, “warning” para imprimir una advertencia cuando se detecte una discrepancia o “error” para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
valor predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- El valor predeterminado de
--lockfile_mode=<off, update or error>
es "desactivado" -
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son “update” para usar el archivo de bloqueo y actualizarlo si hay cambios; “error” para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o “off” para no leerlo ni escribirlo en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y se recurrirá únicamente a los posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
valor predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán estadísticas para todos los mnemotécnicos.
- Opciones que especifican o alteran una entrada genérica a un comando de Bazel que no pertenece a otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remoto:
- Configuración predeterminada de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo para configurar el cargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno con el que debe coincidir y otro para usar como URL sustitutiva, con referencias inversas que comienzan con "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL, y se mostrarán varias URL.
- Opciones varias, que no están categorizadas:
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
Opciones de cquery
Hereda todas las opciones de test.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Más lugares donde buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
valor predeterminado: "false"-
Si se configura, la caché del repositorio vinculará el archivo de forma fija en caso de un acierto de caché, en lugar de copiar. Esto sirve para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
valor predeterminado: "false"-
Si es verdadero, usa una string derivada de las URLs de descargas del repositorio como canonical_id si no se especifica. Esto provoca que un cambio en las URLs genere una nueva descarga incluso si la caché contiene una descarga con el mismo hash. Se puede usar para verificar que los cambios en la URL no den como resultado que la caché oculte los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
valor predeterminado: "false"-
Si se configura, no se permite la descarga de repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Usa este factor para escalar todos los tiempos de espera en las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que sean más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación en caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una string vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que afectan la medida en la que Bazel aplica de manera estricta las 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 hashes del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan
--experimental_verify_repository_rules=<a string>
usos múltiples -
Si es una lista de reglas de repositorio para las que se debe verificar el hash del directorio de salida, siempre que un archivo se especifique mediante --experimental_repository_hash_file.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE.:
- El valor predeterminado de
--[no]experimental_allow_top_level_aspects_parameters
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,deprecated
,experimental
- Opciones relacionadas con el resultado y la semántica de la consulta:
- El valor predeterminado de
--aspect_deps=<off, conservative or precise>
es "conservador". -
Cómo resolver dependencias de aspecto cuando el formato de salida es {xml,proto,record}. “desactivado” significa que no se resuelven las dependencias de aspecto, “conservadora” (el valor predeterminado) significa que se agregan todas las dependencias de aspecto declaradas sin importar si se les otorga la clase de regla de las dependencias directas. “preciso” significa que solo se agregan esos aspectos que posiblemente estén activos dada la clase de regla de las dependencias directas. Ten en cuenta que el modo preciso requiere cargar otros paquetes para evaluar un solo objetivo, por lo que es más lento que los otros modos. Además, ten en cuenta que incluso el modo preciso no es del todo preciso: la decisión de calcular un aspecto se decide en la fase de análisis, que no se ejecuta durante la “consulta de Bazel”.
Etiquetas:build_file_semantics
--[no]consistent_labels
valor predeterminado: "false"-
Si se habilita, cada comando de consulta emite etiquetas como si lo hiciera la función <code>str</code> de Starlark aplicada a una instancia de <code>etiqueta</code>. Esto es útil para las herramientas que necesitan hacer coincidir el resultado de diferentes comandos de consulta o etiquetas emitidas por reglas. Si no están habilitados, los formateadores de salida tienen la libertad de emitir nombres de repositorio aparentes (en relación con el repositorio principal) para que los resultados sean más legibles.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]graph:factored
es "true" (verdadero). -
Si es "true", el gráfico se emitirá "factorizado", es decir, los nodos equivalentes topológicamente se combinarán y sus etiquetas se concatenarán. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--graph:node_limit=<an integer>
predeterminado: "512"-
La longitud máxima de la string de etiqueta para un nodo del gráfico en el resultado. Las etiquetas más largas se truncarán; -1 significa que no hay truncamiento. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]implicit_deps
es "true" (verdadero). -
Si se habilita, las dependencias implícitas se incluirán en el gráfico de dependencias en el que opera la consulta. Una dependencia implícita es aquella que no se especifica de forma explícita en el archivo BUILD, sino que Bazel la agrega. En el caso de cquery, esta opción controla el filtrado de cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
- El valor predeterminado de
--[no]include_aspects
es "true" (verdadero). -
aquery, cquery: si se deben incluir acciones generadas por el aspecto en el resultado. query: no-op (siempre se siguen los aspectos).
Etiquetas:terminal_output
- El valor predeterminado de
--[no]incompatible_display_source_file_location
es "true" (verdadero). -
De forma predeterminada, 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 fines de migración.
Etiquetas:terminal_output
,incompatible_change
- El valor predeterminado de
--[no]incompatible_package_group_includes_double_slash
es "true" (verdadero). -
Si se habilita, cuando se genere el atributo `packages` de package_group, no se omitirá el signo `//` inicial.
Etiquetas:terminal_output
,incompatible_change
--[no]infer_universe_scope
valor predeterminado: "false"-
Si se configura y --universe_scope no se establece, se inferirá un valor de --universe_scope como la lista de patrones de objetivo únicos en la expresión de consulta. Ten en cuenta que el valor de --universe_scope que se infiere para una expresión de consulta que utiliza funciones con alcance universal (p.ej., `allrdeps`) puede no ser lo que quieres, por lo que solo debes usar esta opción si sabes lo que estás haciendo. Consulta https://bazel.build/reference/query#sky-query para obtener detalles y ejemplos. Si se configura --universe_scope, se ignora el valor de esta opción. Nota: Esta opción solo se aplica a “consulta” (es decir, no a “cquery”).
Etiquetas:loading_and_analysis
--[no]line_terminator_null
valor predeterminado: "false"-
Indica si cada formato termina con \0 en lugar de una línea nueva.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]nodep_deps
es "true" (verdadero). -
Si se habilita, las dependencias de los atributos “nodep” se incluirán en el gráfico de dependencias en el que opera la consulta. Un ejemplo común de un atributo “nodep” es la “visibilidad”. Ejecuta y analiza el resultado de `info build-language` para conocer todos los atributos “nodep” en el lenguaje de compilación.
Etiquetas:build_file_semantics
--output=<a string>
, valor predeterminado: “label”-
El formato en el que se deben imprimir los resultados de cquery. Los valores permitidos para cquery son los siguientes: label, label_kind, textproto, transiciones, proto y jsonproto. Si seleccionas "transitions", también debes especificar la opción --transitions=(lite|full).
Etiquetas:terminal_output
- El valor predeterminado de
--[no]proto:default_values
es "true" (verdadero). -
Si el valor es "true", se incluyen los atributos cuyo valor no se especifica de forma explícita en el archivo BUILD. De lo contrario, se omiten. Esta opción se aplica a --output=proto
Etiquetas:terminal_output
--[no]proto:definition_stack
valor predeterminado: "false"-
Propaga el campo proto define_stack que registra, para cada instancia de regla, la pila de llamadas de Starlark en el momento en que se definió la clase de la regla.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]proto:flatten_selects
es "true" (verdadero). -
Si se habilita, se compactan los atributos configurables creados por select(). Para los tipos de lista, la representación plana es una lista que contiene cada valor del mapa de selección exactamente una vez. Los tipos escalares se acoplan a nulos.
Etiquetas:build_file_semantics
- El valor predeterminado de
--[no]proto:include_configurations
es "true" (verdadero).
Si se habilita - , el resultado de proto incluirá información sobre los parámetros de configuración. Cuando se inhabilita,el formato de salida de cquery proto se asemeja al formato de resultados de la consulta.
Etiquetas:affects_outputs
--[no]proto:include_synthetic_attribute_hash
valor predeterminado: "false"-
Indica si se debe calcular y propagar el atributo $internal_attr_hash o no.
Etiquetas:terminal_output
--[no]proto:instantiation_stack
valor predeterminado: "false"-
Propaga la pila de llamadas de creación de instancias de cada regla. Ten en cuenta que esto requiere que la pila esté presente
Etiquetas:terminal_output
- El valor predeterminado de
--[no]proto:locations
es "true" (verdadero). - Indica si se debe generar información de ubicación en el resultado de proto.
Etiquetas:terminal_output
- La configuración predeterminada de
--proto:output_rule_attrs=<comma-separated list of options>
es "todos" -
Lista de atributos separados por comas para incluir en el resultado. La configuración predeterminada es todos los atributos. Se establece como una cadena vacía para no generar ningún atributo. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]proto:rule_inputs_and_outputs
es "true" (verdadero). -
Indica si se deben propagar los campos rule_input y rule_output o no.
Etiquetas:terminal_output
--query_file=<a string>
predeterminado: ""-
Si se configura, la consulta leerá la consulta desde el archivo que se menciona aquí, en lugar de hacerlo desde la línea de comandos. Es un error especificar un archivo aquí, así como una consulta de línea de comandos.
Etiquetas:changes_inputs
--[no]relative_locations
valor predeterminado: "false"-
Si es "true", la ubicación de los archivos BUILD en los resultados xml y proto será relativa. De forma predeterminada, el resultado de la ubicación es una ruta de acceso absoluta y no será coherente en todas las máquinas. Puedes configurar esta opción como verdadera para obtener un resultado coherente en todas las máquinas.
Etiquetas:terminal_output
- El valor predeterminado de
--show_config_fragments=<off, direct or transitive>
es "desactivado" -
Muestra los fragmentos de configuración que requiere una regla y sus dependencias transitivas. Esto puede ser útil para evaluar cuánto se puede recortar un gráfico de destino configurado.
Etiquetas:affects_outputs
--starlark:expr=<a string>
predeterminado: ""-
Una expresión de Starlark para dar formato a cada destino configurado en el modo --output=starlark de cquery. El destino configurado está vinculado al “objetivo”. Si no se especifica --starlark:expr ni --starlark:file, esta opción se establecerá de forma predeterminada como “str(target.label)”. Es un error especificar --starlark:expr y --starlark:file.
Etiquetas:terminal_output
--starlark:file=<a string>
predeterminado: ""-
Es el nombre de un archivo que define una función de Starlark llamada "formato" de un argumento que se aplica a cada destino configurado para darle formato como una cadena. Es un error especificar --starlark:expr y --starlark:file. Consulta la ayuda de --output=starlark para obtener más detalles.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]tool_deps
es "true" (verdadero). -
Consulta: Si se inhabilita, las dependencias de los objetivos de “configuración del host” o “ejecución” no se incluirán en el gráfico de dependencias en el que opera la consulta. Un perímetro de dependencia de 'host configuration', como el de cualquier regla 'proto_library' al compilador de protocolos, generalmente apunta a una herramienta ejecutada durante la compilación en lugar de a una parte del mismo programa 'target'.
Cquery: Si se inhabilita, filtra todos los destinos configurados que cruzan un host o una transición de ejecución del objetivo de nivel superior que descubrió este objetivo configurado. Esto significa que si el objetivo de nivel superior está en la configuración de destino, solo se mostrarán los objetivos configurados también en esa configuración. Si el objetivo de nivel superior se encuentra en la configuración del host, solo se mostrarán los destinos configurados de host. Esta opción NO excluirá las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
- La configuración predeterminada de
--transitions=<full, lite or none>
es “ninguna” -
Es el formato en el que cquery imprimirá la información de transición.
Etiquetas:affects_outputs
--universe_scope=<comma-separated list of options>
predeterminado: ""-
Un conjunto de patrones de objetivo separados por comas (aditivos y sustractivos). La consulta se puede realizar en el universo definido por el cierre transitivo de los destinos especificados. Esta opción se usa para los comandos query y cquery.
Para cquery, la entrada a esta opción son los destinos en los que se compilan todas las respuestas, por lo que esta opción puede afectar las configuraciones y las transiciones. Si no se especifica esta opción, se supone que los destinos de nivel superior son los destinos analizados a partir de la expresión de consulta. Nota: En el caso de cquery, no especificar esta opción puede provocar que la compilación falle si los objetivos analizados a partir de la expresión de consulta no se pueden compilar con opciones de nivel superior.
Etiquetas:loading_and_analysis
- Opciones relacionadas con la semántica y el resultado de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Especificaste las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirá en el gráfico de dependencias resueltas incluso si se declararon de forma privada en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones anteriores harán que la resolución falle. También puedes definir la versión transferida permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
- El valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
es "error" -
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son “error” para derivarlo a una falla de resolución, “off” para inhabilitar la verificación o “warning” para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas `bazel_dep` declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son “off” para inhabilitar la verificación, “warning” para imprimir una advertencia cuando se detecte una discrepancia o “error” para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
valor predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- El valor predeterminado de
--lockfile_mode=<off, update or error>
es "desactivado" -
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son “update” para usar el archivo de bloqueo y actualizarlo si hay cambios; “error” para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o “off” para no leerlo ni escribirlo en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y se recurrirá únicamente a los posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
valor predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán estadísticas para todos los mnemotécnicos.
- Opciones que especifican o alteran una entrada genérica a un comando de Bazel que no pertenece a otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remoto:
- Configuración predeterminada de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo para configurar el cargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno con el que debe coincidir y otro para usar como URL sustitutiva, con referencias inversas que comienzan con "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL, y se mostrarán varias URL.
- Opciones varias, que no están categorizadas:
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso determinada comienza con "%workspace%", es relativa a la raíz del lugar de trabajo, que es el resultado de "bazel info workspace"
- Opciones que controlan la ejecución de la compilación:
--[no]experimental_inprocess_symlink_creation
valor predeterminado: "false"-
Indica si se deben realizar llamadas directas al sistema de archivos para crear árboles de symlinks
Etiquetas:loading_and_analysis
,execution
,experimental
--[no]experimental_remotable_source_manifests
valor predeterminado: "false"-
Indica si se pueden hacer que las acciones del manifiesto de origen sean remotas
Etiquetas:loading_and_analysis
,execution
,experimental
--[no]experimental_split_coverage_postprocessing
valor predeterminado: "false"-
Si es verdadero, Bazel ejecutará el procesamiento posterior de la cobertura para probarlo en un nuevo generador.
Etiquetas:execution
--[no]experimental_strict_fileset_output
valor predeterminado: "false"-
Si habilitas esta opción, los conjuntos de archivos tratarán todos los artefactos de salida como archivos normales. No desviarán directorios ni serán sensibles a los symlinks.
Etiquetas:execution
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
predeterminado: ""-
Agrega o quita claves de la información de ejecución de una acción según el valor mnemotécnico de la acción. Solo se aplica a las acciones que admiten información de ejecución. Muchas acciones comunes admiten información de ejecución, p.ej., Genrule, CppCompile, Javac, StarlarkAction y TestRunner. Cuando se especifican varios valores, el orden es importante porque muchas regex pueden aplicarse al mismo valor mnemotécnico.
Sintaxis: "regex=[+-]key,regex=[+-]key,...".
Ejemplos:
“.*=+x,.*=-y,.*=+z” agrega “x” y “z” a la información de ejecución de todas las acciones y quita “y”.
“Genrule=+requires-x” agrega “require-x” a la información de ejecución para todas las acciones de Genrule.
“(?!Genrule).*=-requires-x” quita “require-x” de la información de ejecución para todas las acciones que no son de Genrule.
Etiquetas:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Habilita las acciones persistentes de dex y desugar de Android con trabajadores.
Se expande a:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
-
Habilita el procesador de recursos persistentes de Android usando trabajadores.
Se expande a:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
}
--strategy=Aapt2Optimize=worker
--strategy=Aapt2Optimize=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
host_machine_resource_optimizations
execution
--persistent_multiplex_android_dex_desugar
-
Habilita las acciones de dex y desugar multiplexadas persistentes de Android con trabajadores.
Se expande a:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
Habilita el procesador de recursos multiplexados persistentes de Android usando trabajadores.
Se expande a:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
}
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
host_machine_resource_optimizations
execution
--persistent_multiplex_android_tools
-
Habilita herramientas persistentes y multiplexadas de Android (dexing, expansión de sintaxis, procesamiento de recursos).
Se expande a:
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Etiquetas:host_machine_resource_optimizations
,execution
- Opciones que configuran la cadena de herramientas que se usa para ejecutar la acción:
- Configuración predeterminada de
--android_compiler=<a string>
: ver descripción -
El compilador de destino de Android
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_crosstool_top=<a build target label>
predeterminado: "//external:android/crosstool"-
Es la ubicación del compilador de C++ que se usa para las compilaciones de Android.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
yloses_incremental_state
- Configuración predeterminada de
--android_grte_top=<a label>
: ver descripción -
El objetivo de Android es grte_top.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
predeterminado: "android"-
Selecciona la combinación de manifiestos que se usará para las reglas android_binary. Marca para ayudar en la transición a la combinación de manifiestos de Android desde la combinación heredada.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_platforms=<a build target label>
predeterminado: ""-
Establece las plataformas que usan los objetivos de android_binary. Si se especifican varias plataformas, el objeto binario es un APK multiarquitectura, que incluye objetos binarios nativos para cada plataforma de destino especificada.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_sdk=<a build target label>
predeterminado: "@bazel_tools//tools/android:sdk"-
Especifica el SDK o la plataforma de Android que se utiliza para compilar aplicaciones para Android.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
- Configuración predeterminada de
--apple_compiler=<a string>
: ver 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"-
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
- Configuración predeterminada de
--apple_grte_top=<a build target label>
: ver 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
- Configuración predeterminada de
--compiler=<a string>
: ver descripción -
El compilador de C++ que se usará para compilar el destino.
Etiquetas:loading_and_analysis
,execution
--coverage_output_generator=<a build target label>
predeterminado: "@bazel_tools//tools/test:lcov_merger"-
Ubicación del objeto binario que se usa para procesar posteriormente los informes de cobertura sin procesar. Actualmente, debe ser un grupo de archivos que contenga un solo archivo, el binario. La configuración predeterminada es '//tools/test:lcov_merger'.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
predeterminado: "@bazel_tools//tools/test:coverage_report_generator"-
Ubicación del objeto binario que se usa para generar informes de cobertura. Actualmente, debe ser un grupo de archivos que contenga un solo archivo, el binario. La configuración predeterminada es “//tools/test:coverage_report_generator”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
predeterminado: "@bazel_tools//tools/test:coverage_support"-
Ubicación de los archivos de compatibilidad que se requieren en las entradas de cada acción de prueba que recopila la cobertura de código. La configuración predeterminada es "//tools/test:coverage_support".
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
--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 el código de C++.
Etiquetas:loading_and_analysis
,changes_inputs
,affects_outputs
- Configuración predeterminada de
--custom_malloc=<a build target label>
: ver descripción -
Especifica una implementación de malloc personalizada. Este parámetro de configuración anula los atributos malloc en las reglas de compilación.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
usos múltiples -
Lista de expresiones regulares separadas por comas, cada una con el prefijo - (expresión negativa), asignada (=) a una lista de valores de restricción separados por comas. Si un objetivo no coincide con ninguna expresión negativa y al menos una expresión positiva, la resolución de la cadena de herramientas se ejecutará como si hubiera declarado los valores de restricción como restricciones de ejecución. Ejemplo: //demo,-test=@platforms//cpus:x86_64 agregará 'x86_64' a cualquier destino de //demo, excepto aquellos cuyo nombre contenga 'prueba'.
Etiquetas:loading_and_analysis
- El valor predeterminado de
--[no]experimental_enable_objc_cc_deps
es "true" (verdadero). -
Permite que las reglas objc_* dependan de cc_library y hace que cualquier dependencia objc se compile con --cpu set to "ios_<--ios_cpu>" para cualquier valor en --ios_multi_cpu.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]experimental_include_xcode_execution_requirements
valor predeterminado: "false"-
Si se configura, agrega un requisito de ejecución “requires-xcode:{version}” a cada acción de Xcode. Si la versión de Xcode tiene una etiqueta con guion, también agrega un requisito de ejecución “requires-xcode-label:{version_label}”.
Etiquetas:loses_incremental_state
,loading_and_analysis
,execution
- El valor predeterminado de
--[no]experimental_prefer_mutual_xcode
es "true" (verdadero). -
Si es verdadero, usa el Xcode más reciente que esté disponible de forma local y remota. Si es falso, o si no existen versiones mutuas disponibles, usa la versión local de Xcode seleccionada a través de xcode-select.
Etiquetas:loses_incremental_state
- Se acumulan
--extra_execution_platforms=<comma-separated list of options>
usos múltiples -
Son las plataformas disponibles como plataformas de ejecución para ejecutar acciones. Las plataformas se pueden especificar por objetivo exacto o como patrón de objetivo. Estas plataformas se considerarán antes que las declaradas en el archivo WORKSPACE por register_execution_platforms().
Etiquetas:execution
- Se acumulan
--extra_toolchains=<comma-separated list of options>
usos múltiples -
Son las reglas de la cadena de herramientas que se tendrán en cuenta durante su resolución. Las cadenas de herramientas se pueden especificar por objetivo exacto o como patrón de objetivo. Estas cadenas de herramientas se considerarán antes de las declaradas en el archivo WORKSPACE por register_toolchains().
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
- Configuración predeterminada de
--grte_top=<a label>
: ver descripción -
Es una etiqueta de una biblioteca libc registrada. La cadena de herramientas de herramientas cruzadas selecciona el valor predeterminado, y casi nunca necesitas anularlo.
Etiquetas:action_command_lines
,affects_outputs
- Configuración predeterminada de
--host_compiler=<a string>
: ver descripción -
Compilador de C++ que se usará para la compilación del host. Se ignora si no se configura --host_crosstool_top.
Etiquetas:loading_and_analysis
,execution
- Configuración predeterminada de
--host_crosstool_top=<a build target label>
: ver descripción -
De forma predeterminada, las opciones --crosstool_top y --compiler también se usan para la configuración del host. Si se proporciona esta marca, Bazel usa el libc y el compilador predeterminados para la crosstool_top especificada.
Etiquetas:loading_and_analysis
,changes_inputs
,affects_outputs
- Configuración predeterminada de
--host_grte_top=<a label>
: ver descripción -
Si se especifica, este parámetro 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: ""-
Es la etiqueta de una regla de la plataforma que describe el sistema host.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
- El valor predeterminado de
--[no]incompatible_disable_expand_if_all_available_in_flag_set
es "true" (verdadero). -
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
- El valor predeterminado de
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
es "true" (verdadero). -
Si es "true", Bazel no habilitará las funciones "host" y "nonhost" en la cadena de herramientas de c++ (consulta https://github.com/bazelbuild/bazel/issues/7407 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_android_toolchain_resolution
valor predeterminado: "false"-
Usa la resolución de la cadena de herramientas para seleccionar el SDK de Android para reglas de Android (Starlark y nativo)
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_apple_toolchain_resolution
valor predeterminado: "false"-
Usa la resolución de la cadena de herramientas para seleccionar el SDK de Apple para las reglas de Apple (Starlark y nativo)
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_make_thinlto_command_lines_standalone
es "true" (verdadero). -
Si es verdadero, Bazel no reutilizará las líneas de comandos de acción de vínculo de C++ para las líneas de comandos de indexación lto (consulta https://github.com/bazelbuild/bazel/issues/6791 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain
es "true" (verdadero). -
Si es así, Bazel realizará un reclamo cuando se configuren 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
- El valor predeterminado de
--[no]incompatible_remove_legacy_whole_archive
es "true" (verdadero). -
Si es verdadero, Bazel no vinculará las dependencias de la biblioteca como todo el archivo de forma predeterminada (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener instrucciones de migración).
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_require_ctx_in_configure_features
es "true" (verdadero). -
Si es "true", Bazel requerirá el parámetro "="{" 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 lo admite. Todas las cadenas de herramientas de ELF admiten actualmente este parámetro de configuración.
Etiquetas:loading_and_analysis
,affects_outputs
,affects_outputs
- Configuración predeterminada de
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Especifica la versión del SDK de iOS que se usará para compilar aplicaciones para iOS. Si no se especifica, usa la versión predeterminada del SDK para iOS de “xcode_version”.
Etiquetas:loses_incremental_state
- Configuración predeterminada de
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Especifica la versión del SDK de macOS que se usará para compilar aplicaciones de macOS. Si no se especifica, se usa la versión predeterminada del SDK de macOS de “xcode_version”.
Etiquetas:loses_incremental_state
- Configuración predeterminada de
--minimum_os_version=<a string>
: ver descripción -
La versión mínima del SO a la que se orienta tu compilación.
Etiquetas:loading_and_analysis
,affects_outputs
--platform_mappings=<a relative path>
predeterminado: ""-
Es la ubicación de un archivo de asignación en la que se describe qué plataforma usar si no hay ninguna establecida o qué marcas se deben configurar cuando ya existe una plataforma. Debe estar relacionado con la raíz del lugar de trabajo principal. La configuración predeterminada es "platform_mappings", que es un archivo directamente en la raíz del lugar de trabajo.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--platforms=<a build target label>
predeterminado: ""-
Las etiquetas de las reglas de la plataforma que describen las plataformas de destino para el comando actual.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
- Configuración predeterminada de
--python2_path=<a string>
: ver descripción -
Obsoleto, no-op. Inhabilitado por `--incompatible_use_python_toolchains`.
Etiquetas:no_op
,deprecated
- Configuración predeterminada de
--python3_path=<a string>
: ver descripción -
Obsoleto, no-op. Inhabilitado por `--incompatible_use_python_toolchains`.
Etiquetas:no_op
,deprecated
- Configuración predeterminada de
--python_path=<a string>
: ver descripción -
Es la ruta de acceso absoluta del intérprete de Python que se invoca para ejecutar los objetivos de Python en la plataforma de destino. Obsoleto; inhabilitado por --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
- Configuración predeterminada de
--python_top=<a build target label>
: ver descripción -
La etiqueta de un py_runtime que representa el intérprete de Python invocado para ejecutar objetivos de Python en la plataforma de destino. Obsoleto; inhabilitado por --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
--target_platform_fallback=<a build target label>
valor predeterminado: "@local_config_platform//:host"-
Es la etiqueta de una regla de plataforma que se debe usar si no se establece ninguna plataforma de destino y no hay una asignación de plataforma que coincida con el conjunto actual de marcas.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
- Configuración predeterminada de
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Especifica la versión del SDK de tvOS que se usará para compilar aplicaciones de tvOS. Si no se especifica, se usa la versión predeterminada del SDK de tvOS de “xcode_version”.
Etiquetas:loses_incremental_state
- Configuración predeterminada de
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Especifica la versión del SDK de watchOS que se usará para compilar aplicaciones de watchOS. Si no se especifica, se usa la versión predeterminada del SDK de watchOS de “xcode_version”.
Etiquetas:loses_incremental_state
- Configuración predeterminada de
--xcode_version=<a string>
: ver descripción -
Si se especifica, usa Xcode de la versión determinada para las acciones de compilación relevantes. Si no se especifica, usa la versión predeterminada del ejecutor de Xcode.
Etiquetas:loses_incremental_state
--xcode_version_config=<a build target label>
predeterminado: "@bazel_tools//tools/cpp:host_xcodes"-
La etiqueta de la regla xcode_config que se usará para seleccionar la versión de Xcode en la configuración de compilación.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Opciones que controlan el resultado del comando:
--[no]apple_enable_auto_dsym_dbg
valor predeterminado: "false"-
Determina si se debe forzar la habilitación de la generación de archivos de símbolos de depuración (.dSYM) para compilaciones de dbg.
Etiquetas:affects_outputs
,action_command_lines
--[no]apple_generate_dsym
valor predeterminado: "false"-
Indica si se deben generar archivos de símbolos de depuración (.dSYM).
Etiquetas:affects_outputs
,action_command_lines
- El valor predeterminado de
--[no]build_runfile_links
es "true" (verdadero). -
Si esta opción es verdadera, compila bosques de symlinks de archivos de ejecución para todos los destinos. Si es falso, solo escribe manifiestos cuando sea posible.
Etiquetas:affects_outputs
- El valor predeterminado de
--[no]build_runfile_manifests
es "true" (verdadero). -
Si esta opción es verdadera, se escriben manifiestos de archivos de ejecución para todos los destinos. Si es falso, omítelos. Las pruebas locales no se ejecutarán si el valor es falso.
Etiquetas:affects_outputs
--[no]build_test_dwp
valor predeterminado: "false"-
Si se habilita, cuando se compilen pruebas de C++ de forma estática y con fisión, el archivo .dwp para el objeto binario de prueba también se compilará automáticamente.
Etiquetas:loading_and_analysis
,affects_outputs
--cc_proto_library_header_suffixes=<comma-separated 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"-
Establece los prefijos de los archivos fuente que crea una cc_proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info
valor predeterminado: "false"-
Ejecuta acciones adicionales para versiones alternativas de la API de Java en una proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_proto_extra_actions
valor predeterminado: "false"-
Ejecuta acciones adicionales para versiones alternativas de la API de Java en una proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_save_feature_state
valor predeterminado: "false"-
Guarda el estado de las funciones habilitadas y solicitadas como resultado de la compilación.
Etiquetas:affects_outputs
,experimental
- El valor predeterminado de
--fission=<a set of compilation modes>
es "no" -
Especifica qué modos de compilación usan fisión para compilaciones y vínculos de C++. Puede ser cualquier combinación de {'fastbuild', 'dbg', 'opt'} o los valores especiales "yes" para habilitar todos los modos y "no" para inhabilitarlos.
Etiquetas:loading_and_analysis
,action_command_lines
,affects_outputs
- El valor predeterminado de
--[no]incompatible_always_include_files_in_data
es "true" (verdadero). -
Si es verdadero, las reglas nativas agregan <code>DefaultInfo.files</code> de dependencias de datos a sus archivos de ejecución, lo que coincide con el comportamiento recomendado para las reglas de Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid).
Etiquetas:affects_outputs
,incompatible_change
- El valor predeterminado de
--[no]legacy_external_runfiles
es "true" (verdadero). -
Si esta opción es verdadera, compila bosques de symlink de archivos de ejecución para repositorios externos en .runfiles/wsname/external/repo (además de .runfiles/repo).
Etiquetas:affects_outputs
--[no]objc_generate_linkmap
valor predeterminado: "false"-
Especifica si se debe generar un archivo de mapa de vínculos.
Etiquetas:affects_outputs
--[no]save_temps
valor predeterminado: "false"-
Si se establece, se guardarán los resultados temporales de GCC. Estos incluyen archivos .s (código ensamblador), archivos .i (C preprocesado) y archivos .ii (C++ previamente procesados).
Etiquetas:affects_outputs
- Opciones que permiten al usuario configurar el resultado deseado y afectar su valor, en lugar de su existencia:
- Se acumulan
--action_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica el conjunto de variables de entorno disponibles para acciones con configuración de destino. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o mediante el par nombre=valor que establece el valor independientemente del entorno de invocación. Esta opción se puede usar varias veces; para opciones proporcionadas para la misma variable, se acumulan los últimos éxitos, las opciones para diferentes variables se acumulan.
Etiquetas:action_command_lines
--android_cpu=<a string>
predeterminado: "armeabi-v7a"-
Es la CPU de destino de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]android_databinding_use_androidx
valor predeterminado: "false"-
Genera archivos de vinculación de datos compatibles con AndroidX. Esto solo se usa con Databinding v2.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
yexperimental
--[no]android_databinding_use_v3_4_args
valor predeterminado: "false"-
Usar Android Databinding v2 con argumentos 3.4.0
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- El valor predeterminado de
--android_dynamic_mode=<off, default or fully>
es "desactivado" -
Determina si las dependencias de C++ de las reglas de Android se vincularán de forma dinámica cuando un objeto cc_binary no cree explícitamente una biblioteca compartida. “default” significa que Bazel decide si se vincula de forma dinámica. "completamente" significa que todas las bibliotecas se vincularán de forma dinámica. “off” significa que todas las bibliotecas se vincularán en su mayor parte en modo estático.
Etiquetas:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
valor predeterminado: "alphabetical"-
Establece el orden de los manifiestos que se pasan a la combinación de manifiestos para objetos binarios de Android. ALFABÉTICO significa que los manifiestos se ordenan por ruta de acceso relativa a la execroot. ALPHABETICAL_BY_CONFIGURATION significa que los manifiestos se ordenan por rutas de acceso relacionadas con el directorio de configuración dentro del directorio de salida. DEPENDENCY significa que los manifiestos se ordenan con los manifiestos de cada biblioteca antes que los de sus dependencias.
Etiquetas:action_command_lines
,execution
--[no]android_resource_shrinking
valor predeterminado: "false"-
Habilita la reducción de recursos para los APKs de android_binary que usan ProGuard.
Etiquetas:affects_outputs
,loading_and_analysis
- Se acumulan
--apple_bitcode=<'mode' or 'platform=mode', where 'mode' is none, embedded_markers or embedded, and 'platform' is ios, visionos, watchos, tvos, macos or catalyst>
usos múltiples -
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”, en el que la plataforma (que debe ser “ios”, “macos”, “tvos” o “watchos”) es opcional. Si se proporciona, el modo de código de bits se aplica específicamente a esa plataforma. Si se omite, se aplica a todas las plataformas. El modo debe ser "none", "embedded_markers" o "embedded". Esta opción se puede proporcionar varias veces.
Etiquetas:loses_incremental_state
- Valor predeterminado de
--[no]build_python_zip
: "auto" -
Compila el archivo ZIP del comando de Python; en Windows, desactivado en otras plataformas
Etiquetas:affects_outputs
- Se acumulan
--catalyst_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se compilan los objetos binarios de Apple Catalyst.
Etiquetas:loses_incremental_state
,loading_and_analysis
--[no]collect_code_coverage
valor predeterminado: "false"-
Si se especifica, Bazel instrumentará código (con instrumentación sin conexión cuando sea posible) y recopilará información de cobertura durante las pruebas. Solo se verán afectados los objetivos que coincidan con --instrumentation_filter. Por lo general, esta opción no debe especificarse directamente; en su lugar, debes usar el comando "bazel esquema".
Etiquetas:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] predeterminado: "fastbuild"-
Especifica el modo en el que se compilará el objeto binario. Valores: "fastbuild", "dbg", "opt".
Etiquetas:affects_outputs
,action_command_lines
,explicit_in_output_path
- Se acumulan
--conlyopt=<a string>
usos múltiples -
Es una opción adicional para pasar a gcc cuando se compilan archivos de origen C.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--copt=<a string>
usos múltiples -
Opciones adicionales para pasar a gcc.
Etiquetas:action_command_lines
,affects_outputs
--cpu=<a string>
predeterminado: ""-
La CPU de destino.
Etiquetas:changes_inputs
,affects_outputs
,explicit_in_output_path
- Configuración predeterminada de
--cs_fdo_absolute_path=<a string>
: ver descripción - Usa la información del perfil de CSFDO para optimizar la compilación. Especifica el nombre de ruta de acceso absoluto del archivo ZIP que contiene el archivo de perfil, un archivo de perfil de LLVM sin procesar o indexado.
Etiquetas:affects_outputs
- Configuración predeterminada de
--cs_fdo_instrument=<a string>
: ver descripción - Genera objetos binarios con instrumentación de FDO sensible al contexto. Con el compilador Clang/LLVM, también acepta el nombre de directorio bajo el cual se volcarán los archivos de perfil sin procesar durante el tiempo de ejecución.
Etiquetas:affects_outputs
- Configuración predeterminada de
--cs_fdo_profile=<a build target label>
: ver descripción -
El cs_fdo_profile, que representa el perfil sensible al contexto que se usará para la optimización.
Etiquetas:affects_outputs
- Se acumulan
--cxxopt=<a string>
usos múltiples -
Es una opción adicional para pasar a gcc cuando se compilan archivos de origen C++.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--define=<a 'name=value' assignment>
usos múltiples -
Cada opción --define especifica una asignación para una variable de compilación.
Etiquetas:changes_inputs
,affects_outputs
--dynamic_mode=<off, default or fully>
valor predeterminado: "default"-
Determina si los objetos binarios de C++ se vincularán de forma dinámica. “predeterminada” significa que Bazel elegirá si se vinculará de forma dinámica. "completamente" significa que todas las bibliotecas se vincularán de forma dinámica. “off” significa que todas las bibliotecas se vincularán en su mayor parte en modo estático.
Etiquetas:loading_and_analysis
,affects_outputs
- El valor predeterminado de
--[no]enable_fdo_profile_absolute_path
es "true" (verdadero). -
Si se configura, el uso de fdo_absolute_profile_path generará un error.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]enable_runfiles
: "auto" -
Habilita el árbol del symlink de los archivos de ejecución. De forma predeterminada, está desactivado en Windows y en otras plataformas.
Etiquetas:affects_outputs
- Se acumulan
--experimental_action_listener=<a build target label>
usos múltiples -
Se dio de baja a favor de los aspectos. Usa action_listener para adjuntar una extra_action a las acciones de compilación existentes.
Etiquetas:execution
,experimental
--[no]experimental_android_compress_java_resources
valor predeterminado: "false"-
Comprime los recursos de Java en APK
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_android_databinding_v2
valor predeterminado: "false"-
Usar Android Databinding v2
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_android_resource_shrinking
valor predeterminado: "false"-
Habilita la reducción de recursos para los APKs de android_binary que usan ProGuard.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_android_rewrite_dexes_with_rex
valor predeterminado: "false"-
usar la herramienta Rex para reescribir archivos dex
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_collect_code_coverage_for_generated_files
valor predeterminado: "false"-
Si se especifica, Bazel también generará información de cobertura para los archivos generados.
Etiquetas:affects_outputs
--experimental_objc_fastbuild_options=<comma-separated list of options>
predeterminado: "-O0,-DDEBUG=1"-
Usa estas cadenas como opciones del compilador objc fastbuild.
Etiquetas:action_command_lines
--[no]experimental_omitfp
valor predeterminado: "false"-
Si esta opción es "true", usa libunwind para desenrollar la pila y compila con -fomit-frame-pointer y -fasym-unwind-tables.
Etiquetas:action_command_lines
,affects_outputs
,experimental
--[no]experimental_platform_in_output_dir
valor predeterminado: "false"-
Si es verdadero, se usa la plataforma de destino en el nombre del directorio de salida en lugar de la CPU.
Etiquetas:affects_outputs
,experimental
--[no]experimental_use_llvm_covmap
valor predeterminado: "false"-
Si se especifica, Bazel generará información del mapa de cobertura llvm-cov en lugar de gcov cuando collect_code_coverage esté habilitado.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
yexperimental
--fat_apk_cpu=<comma-separated list of options>
predeterminado: "armeabi-v7a"-
Mediante la configuración de esta opción, se habilitan los APK multiarquitecturas, que contienen objetos binarios nativos para todas las arquitecturas de destino especificadas, p.ej., --fat_apk_cpu=x86,armeabi-v7a. Si se especifica esta marca, --android_cpu se ignora para dependencias de reglas android_binary.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]fat_apk_hwasan
valor predeterminado: "false"-
Determina si se deben crear divisiones HWASAN.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Configuración predeterminada de
--fdo_instrument=<a string>
: ver descripción - Genera objetos binarios con instrumentación de FDO. Con el compilador Clang/LLVM, también acepta el nombre de directorio bajo el cual se volcarán los archivos de perfil sin procesar durante el tiempo de ejecución.
Etiquetas:affects_outputs
- Configuración predeterminada de
--fdo_optimize=<a string>
: ver descripción - Usa la información del perfil de FDO para optimizar la compilación. Especifica el nombre de un archivo ZIP que contenga un árbol de archivos .gcda, un archivo afdo que contenga un perfil automático o un archivo de perfil de LLVM. Esta marca también acepta archivos especificados como etiquetas (p.ej., `//foo/bar:file.afdo` (es posible que debas agregar una directiva `exports_files` al paquete correspondiente) y etiquetas que apunten a objetivos de `fdo_profile`. Esta marca será reemplazada por la regla “fdo_profile”.
Etiquetas:affects_outputs
- Configuración predeterminada de
--fdo_prefetch_hints=<a build target label>
: ver descripción -
Usa sugerencias de carga previa de caché.
Etiquetas:affects_outputs
- Configuración predeterminada de
--fdo_profile=<a build target label>
: ver descripción -
El fdo_profile, que representa el perfil que se utilizará para la optimización.
Etiquetas:affects_outputs
- Se acumulan
--features=<a string>
usos múltiples -
Estas funciones estarán habilitadas o inhabilitadas de forma predeterminada para los destinos integrados en la configuración de destino. Si especificas -<feature>, se inhabilitará la función. Los atributos negativos siempre anulan a los positivos. Consulta también --host_features
Etiquetas:changes_inputs
,affects_outputs
--[no]force_pic
valor predeterminado: "false"-
Si se habilita, todas las compilaciones de C++ producen código independiente de la posición ("-fPIC"), los vínculos prefieren bibliotecas PIC compiladas previamente en lugar de bibliotecas que no son PIC, y los vínculos producen ejecutables independientes de la posición ("-pie").
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan
--host_action_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica el conjunto de variables de entorno disponibles para acciones con configuraciones de host o de ejecución. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación, o mediante el par nombre=valor que establece el valor independientemente del entorno de invocación. Esta opción se puede usar varias veces; para opciones proporcionadas para la misma variable, se acumulan los últimos éxitos, las opciones para diferentes variables se acumulan.
Etiquetas:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
valor predeterminado: "opt"- Especifica el modo en el que se integrarán las herramientas usadas durante la compilación. Valores: "fastbuild", "dbg", "opt".
Etiquetas:affects_outputs
,action_command_lines
- Se acumulan
--host_conlyopt=<a string>
usos múltiples -
Es una opción adicional para pasar a gcc cuando se compilan archivos de origen C para las herramientas de host.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--host_copt=<a string>
usos múltiples -
Opciones adicionales para pasar a gcc para las herramientas del host.
Etiquetas:action_command_lines
,affects_outputs
--host_cpu=<a string>
predeterminado: ""-
Es la CPU del host.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan
--host_cxxopt=<a string>
usos múltiples -
Opciones adicionales para pasar a gcc para las herramientas del host.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--host_features=<a string>
usos múltiples -
Las funciones determinadas estarán habilitadas o inhabilitadas de forma predeterminada para los destinos integrados en la configuración de ejecución. Si especificas -<feature>, se inhabilitará la función. Los atributos negativos siempre anulan a los positivos.
Etiquetas:changes_inputs
,affects_outputs
- Configuración predeterminada de
--host_force_python=<PY2 or PY3>
: ver descripción -
Anula la versión de Python para la configuración del host. Puede ser “PY2” o “PY3”.
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan
--host_linkopt=<a string>
usos múltiples -
Es una opción adicional para pasar a gcc cuando se vinculan las herramientas del host.
Etiquetas:action_command_lines
,affects_outputs
- Configuración predeterminada de
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima de macOS compatible para los destinos de host. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
usos múltiples -
Son opciones adicionales para pasar de forma selectiva al compilador C/C++ cuando se compilan ciertos archivos en las configuraciones de host o de ejecución. Esta opción se puede aprobar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter significa una lista de patrones de expresiones regulares de inclusión y exclusión (consulta también --instrumentation_filter). option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe ir entre comillas con una barra inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos gcc de todos los archivos cc en //foo/, excepto bar.cc.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--host_swiftcopt=<a string>
usos múltiples -
Opciones adicionales para pasar a swiftc para las herramientas del host.
Etiquetas:action_command_lines
,affects_outputs
- El valor predeterminado de
--[no]incompatible_avoid_conflict_dlls
es "true" (verdadero). -
Si se habilita, todas las bibliotecas dinámicas vinculadas (DLL) de C++ generadas por cc_library en Windows cambiarán de nombre por name_{hash}.dll, en el que el hash se calcula en función del RepositoryName y la ruta 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
- El valor predeterminado de
--[no]incompatible_merge_genfiles_directory
es "true" (verdadero). -
Si es verdadero, el directorio genfiles se pliega en el directorio bin.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_use_host_features
valor predeterminado: "false"-
Si es verdadero, usa --features solo para la configuración de destino y --host_features para la configuración de ejecución.
Etiquetas:changes_inputs
,affects_outputs
,incompatible_change
- El valor predeterminado de
--[no]incompatible_use_platforms_repo_for_constraints
es "true" (verdadero). -
Si es verdadero, se quitará la configuración de restricciones de @bazel_tools.
Etiquetas:affects_outputs
,incompatible_change
--[no]instrument_test_targets
valor predeterminado: "false"-
Cuando la cobertura está habilitada, especifica si se debe considerar la instrumentación de reglas de prueba. Cuando se establece, se instrumentan las reglas de prueba incluidas por --instrumentation_filter. De lo contrario, las reglas de prueba siempre se excluyen de la instrumentación de cobertura.
Etiquetas:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
valor predeterminado: "-/javatests[/:],-/test/java[/:]"-
Cuando la cobertura esté habilitada, solo se instrumentarán las reglas con nombres incluidos en el filtro basado en regex especificado. En su lugar, se excluyen las reglas con el prefijo “-”. Ten en cuenta que solo se instrumentan las reglas que no son de prueba, a menos que esté habilitado --instrument_test_targets.
Etiquetas:affects_outputs
- Configuración predeterminada de
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima de iOS compatible con los simuladores y dispositivos de destino. Si no se especifica, usa “ios_sdk_version”.
Etiquetas:loses_incremental_state
- Se acumulan
--ios_multi_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para compilar una ios_application. El resultado es un objeto binario universal que contiene todas las arquitecturas especificadas.
Etiquetas:loses_incremental_state
,loading_and_analysis
- El valor predeterminado de
--[no]legacy_whole_archive
es "true" (verdadero). -
Obsoleto y sustituido por --incompatible_remove_legacy_whole_archive (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener más información). Cuando esta opción está activada, se usa --whole-archive para reglas cc_binary que tengan linkshared=True y linkstatic=True o '-static' en linkopts. Esto es solo para retrocompatibilidad. Una mejor alternativa es usar Alwayslink=1 cuando sea necesario.
Etiquetas:action_command_lines
,affects_outputs
,deprecated
- Se acumulan
--linkopt=<a string>
usos múltiples -
Es una opción adicional para pasar a gcc durante la vinculación.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--ltobackendopt=<a string>
usos múltiples -
Es una opción adicional para pasar al paso de backend de LTO (en --features=thin_lto).
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--ltoindexopt=<a string>
usos múltiples -
Es una opción adicional para pasar al paso de indexación LTO (en --features=thin_lto).
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--macos_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se compilan objetos binarios de Apple macOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Configuración predeterminada de
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima de macOS compatible para los objetivos. Si no se especifica, se usa "macos_sdk_version".
Etiquetas:loses_incremental_state
--[no]objc_debug_with_GLIBCXX
valor predeterminado: "false"-
Si estableces la política y el modo de compilación está configurado como "dbg", define GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC y GLIBCPP_CONCEPT_CHECKS.
Etiquetas:action_command_lines
--[no]objc_enable_binary_stripping
valor predeterminado: "false"-
Determina si se deben quitar símbolos y códigos muertos en objetos binarios vinculados. Si se especifican esta marca y --compilation_mode=opt, se realizarán eliminaciones binarias.
Etiquetas:action_command_lines
- Se acumulan
--objccopt=<a string>
usos múltiples -
Opciones adicionales para pasar a gcc cuando se compilan archivos fuente Objective-C/C++.
Etiquetas:action_command_lines
- Se acumulan
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
usos múltiples -
Opciones adicionales para pasar selectivamente a gcc cuando se compilan ciertos archivos. Esta opción se puede aprobar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter significa una lista de patrones de expresiones regulares de inclusión y exclusión (consulta también --instrumentation_filter). option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe ir entre comillas con una barra inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos gcc de todos los archivos cc en //foo/, excepto bar.cc.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
usos múltiples -
Opciones adicionales para pasar de forma selectiva al backend de LTO (en --features=thin_lto) cuando se compilan ciertos objetos de backend. Esta opción se puede aprobar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter significa una lista de patrones de expresiones regulares de inclusión y exclusión, y option_1 a option_n representan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, debe ir entre comillas con una barra inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la cadena. Ejemplo: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 agrega la opción de línea de comandos -O0 a la línea de comandos del backend de LTO de todos los archivos o en //foo/, excepto bar.o.
Etiquetas:action_command_lines
,affects_outputs
- Configuración predeterminada de
--platform_suffix=<a string>
: ver descripción -
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas:loses_incremental_state
,affects_outputs
,loading_and_analysis
- Configuración predeterminada de
--propeller_optimize=<a build target label>
: ver descripción -
Usa la información del perfil de Propeller para optimizar el objetivo de compilación.Un perfil de propulsor debe constar de al menos uno de dos archivos, un perfil cc y un perfil ld. Esta marca acepta una etiqueta de compilación que debe hacer referencia a los archivos de entrada del perfil de propulsor. Por ejemplo, el archivo BUILD que define la etiqueta La opción debe usarse de la siguiente manera: --propeller_optimize=//a/b:propeller_profile
Etiquetas:action_command_lines
,affects_outputs
- Configuración predeterminada de
--propeller_optimize_absolute_cc_profile=<a string>
: ver descripción -
Nombre de ruta de acceso absoluto del archivo cc_profile para compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
- Configuración predeterminada de
--propeller_optimize_absolute_ld_profile=<a string>
: ver descripción -
Nombre de ruta de acceso absoluto del archivo ld_profile para compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
- Configuración predeterminada de
--run_under=<a prefix in front of command>
: ver descripción -
Es el prefijo que se debe insertar antes de los ejecutables para los comandos “test” y “run”. Si el valor es “foo -bar”, y la línea de comandos de ejecución es “test_binary -baz”, la línea de comandos final es “foo -bar test_binary -baz”. También puede ser una etiqueta para un destino ejecutable. Estos son algunos ejemplos: 'valgrind', 'strace', 'strace -c', 'valgrind --quiet --num-callers=20', '//package:target', '//package:target --options'.
Etiquetas:action_command_lines
-
Si es "true", las bibliotecas nativas que contengan la misma funcionalidad se compartirán entre diferentes destinos
Etiquetas:loading_and_analysis
,affects_outputs
--[no]stamp
valor predeterminado: "false"-
Sella los objetos binarios con la fecha, el nombre de usuario, el nombre de host, la información del lugar de trabajo, etcétera.
Etiquetas:affects_outputs
- El valor predeterminado de
--strip=<always, sometimes or never>
es " a veces". -
Especifica si se quitan los objetos binarios y las bibliotecas compartidas (con "-Wl,--strip-debug"). El valor predeterminado de "algunas veces" significa quitar iff --compilation_mode=fastbuild.
Etiquetas:affects_outputs
- Se acumulan
--stripopt=<a string>
usos múltiples -
Opciones adicionales para quitar cuando se genera un objeto binario “<name>.stripped”.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--swiftcopt=<a string>
usos múltiples -
Opciones adicionales para pasar a la compilación de Swift.
Etiquetas:action_command_lines
- Se acumulan
--tvos_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se compilan objetos binarios de Apple tvOS.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Configuración predeterminada de
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima de tvOS compatible para simuladores de objetivo y dispositivos. Si no se especifica, se usa "tvos_sdk_version".
Etiquetas:loses_incremental_state
- Se acumulan
--visionos_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se compilan objetos binarios de visionOS de Apple.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Se acumulan
--watchos_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se compilan objetos binarios de watchOS de Apple.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Configuración predeterminada de
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Versión mínima de watchOS compatible para los simuladores y dispositivos de destino. Si no se especifica, se usa “watchos_sdk_version”.
Etiquetas:loses_incremental_state
- Configuración predeterminada de
--xbinary_fdo=<a build target label>
: ver descripción - Usa la información del perfil de XbinaryFDO para optimizar la compilación. Especifica el nombre del perfil binario cruzado predeterminado. Cuando la opción se usa junto con --fdo_instrument/--fdo_optimize/--fdo_profile, esas opciones siempre prevalecerán como si nunca se especificara xbinary_fdo.
Etiquetas:affects_outputs
- Opciones que afectan la medida en la que Bazel aplica de manera estricta entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
--auto_cpu_environment_group=<a build target label>
predeterminado: ""-
Declara el entorno_group para asignarlo automáticamente a los valores de CPU a los valores target_environment.
Etiquetas:changes_inputs
,loading_and_analysis
,experimental
--[no]check_licenses
valor predeterminado: "false"-
Verifica que las restricciones de licencias impuestas por los paquetes dependientes no entren en conflicto con los modos de distribución de los destinos que se compilan. De forma predeterminada, las licencias no están marcadas.
Etiquetas:build_file_semantics
- El valor predeterminado de
--[no]check_visibility
es "true" (verdadero). - Si se inhabilita, los errores de visibilidad en las dependencias de destino descienden a advertencias.
Etiquetas:build_file_semantics
- El valor predeterminado de
--[no]desugar_for_android
es "true" (verdadero). -
Indica si se debe usar la expansión de sintaxis del código de bytes Java 8 antes de la conversión a DEX.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]desugar_java8_libs
valor predeterminado: "false"-
Determina si se deben incluir bibliotecas de Java 8 compatibles en apps para dispositivos heredados.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
yexperimental
- El valor predeterminado de
--[no]enforce_constraints
es "true" (verdadero). -
Verifica los entornos compatibles con cada destino y, luego, informa errores si algún destino tiene dependencias que no admiten los mismos entornos
Etiquetas:build_file_semantics
--[no]experimental_allow_android_library_deps_without_srcs
valor predeterminado: "false"-
Marca para facilitar la transición de permitir a deshabilitar reglas android_library de srcs-less con dependencias. Se debe limpiar el depósito para lanzarlo de forma predeterminada.
Etiquetas:eagerness_to_exit
,loading_and_analysis
- El valor predeterminado de
--[no]experimental_check_desugar_deps
es "true" (verdadero). -
Indica si se debe verificar la expansión de sintaxis correcta a nivel binario de Android.
Etiquetas:eagerness_to_exit
,loading_and_analysis
,experimental
- Configuración predeterminada de
--experimental_import_deps_checking=<off, warning or error>
: "DESACTIVADA" -
Cuando se habilita, verifica si las dependencias de aar_import están completas. Esta aplicación puede dañar la compilación o simplemente generar advertencias.
Etiquetas:loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
valor predeterminado: "default"-
Si es verdadero, verifica que un destino de Java declare de forma explícita todos los destinos usados de forma directa como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files
valor predeterminado: "false"-
Si se habilita esta opción, verifica los objetivos de solo prueba de los requisitos previos que sean archivos de salida. Para ello, busca el solo de prueba de la regla de generación. Esto coincide con la verificación de visibilidad.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_disable_native_android_rules
valor predeterminado: "false"-
Si se habilita, se inhabilita el uso directo de las reglas nativas de Android. Usa las reglas de Starlark para Android de https://github.com/bazelbuild/rules_android
Etiquetas:eagerness_to_exit
,incompatible_change
--[no]incompatible_disable_native_apple_binary_rule
valor predeterminado: "false"-
No-ops. Se conserva aquí para brindar retrocompatibilidad.
Etiquetas:eagerness_to_exit
,incompatible_change
- El valor predeterminado de
--[no]incompatible_force_strict_header_check_from_starlark
es "true" (verdadero). -
Si está habilitada, establece una verificación de encabezados estricta en la API de Starlark
Etiquetas:loading_and_analysis
,changes_inputs
,incompatible_change
- El valor predeterminado de
--[no]incompatible_validate_top_level_header_inclusions
es "true" (verdadero). -
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
valor predeterminado: "false"- Si se habilita esta opción, los conjuntos de archivos que cruzan los límites de los paquetes se informan como errores. No funciona cuando check_fileset_Dependencies_recursively está inhabilitado.
Etiquetas:build_file_semantics
,eagerness_to_exit
- El valor predeterminado de
--strict_proto_deps=<off, warn, error, strict or default>
es "error" -
A menos que esté DESACTIVADO, verifica que un destino proto_library declare de forma explícita todos los destinos usados de forma directa como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
- El valor predeterminado de
--strict_public_imports=<off, warn, error, strict or default>
es "desactivado" -
A menos que esté DESACTIVADO, verifica que un destino proto_library declare de forma explícita todos los destinos usados en "import public" como exportados.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
--[no]strict_system_includes
valor predeterminado: "false"-
Si es verdadero, también se deben declarar los encabezados que se encuentran a través de las rutas de inclusión del sistema (-isystem).
Etiquetas:loading_and_analysis
,eagerness_to_exit
- Se acumulan
--target_environment=<a build target label>
usos múltiples -
Declara el entorno de destino de esta compilación. Debe ser una referencia de etiqueta a una regla de “entorno”. Si se especifica, todos los destinos de nivel superior deben ser compatibles con este entorno.
Etiquetas:changes_inputs
- Opciones que afectan los resultados de firma de una compilación:
--apk_signing_method=<v1, v2, v1_v2 or v4>
predeterminado: "v1_v2"-
Implementación que se usa para firmar APKs
Etiquetas:action_command_lines
,affects_outputs
,loading_and_analysis
- El valor predeterminado de
--[no]device_debug_entitlements
es "true" (verdadero). -
Si se configura y el modo de compilación no es "opt", las apps de objc incluirán derechos de depuración durante la firma.
Etiquetas:changes_inputs
- Configuración predeterminada de
--ios_signing_cert_name=<a string>
: ver descripción -
Nombre del certificado que se usará para la firma de iOS. Si no la estableces, se recurrirá al perfil de aprovisionamiento. Puede ser la preferencia de identidad del llavero del certificado o (subcadena) del nombre común del certificado, según la página manual de la señal de código (SIGNING IDENTITIES).
Etiquetas:action_command_lines
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE.:
- El valor predeterminado de
--[no]incompatible_disallow_legacy_py_provider
es "true" (verdadero). -
No-ops, se quitará pronto.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones que determinan el comportamiento del entorno de pruebas o del ejecutor de pruebas:
--[no]allow_analysis_failures
valor predeterminado: "false"-
Si es verdadero, una falla de análisis de un destino de regla provocará la propagación del objetivo de una instancia de AnalysisFailureInfo que contiene la descripción del error, en lugar de una falla de compilación.
Etiquetas:loading_and_analysis
,experimental
--analysis_testing_deps_limit=<an integer>
predeterminado: "2000"-
Establece la cantidad máxima de dependencias transitivas mediante un atributo de regla con una transición de configuración for_analysis_testing. Si se supera ese límite, se mostrará un error de regla.
Etiquetas:loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure
valor predeterminado: "false"-
Si se producen errores reales en la acción de dex2oat, la compilación falla en lugar de ejecutar dex2oat durante el tiempo de ejecución de la prueba.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_android_use_parallel_dex2oat
valor predeterminado: "false"-
Usa dex2oat en paralelo para, quizás, acelerar android_test.
Etiquetas:loading_and_analysis
,host_machine_resource_optimizations
,experimental
--[no]ios_memleaks
valor predeterminado: "false"-
Habilita la comprobación de fugas de memoria en los destinos ios_test.
Etiquetas:action_command_lines
- Configuración predeterminada de
--ios_simulator_device=<a string>
: ver descripción -
Es el dispositivo que se simula cuando se ejecuta una aplicación para iOS en el simulador, p.ej., "iPhone 6". Para obtener una lista de dispositivos, ejecuta “xcrun simctl list devicetypes” en la máquina en que se ejecutará el simulador.
Etiquetas:test_runner
- Configuración predeterminada de
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Es la versión de iOS que se ejecutará en el simulador cuando se ejecute o realice pruebas. Esto se ignora para las reglas ios_test si se especifica un dispositivo de destino en la regla.
Etiquetas:test_runner
- Se acumulan
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
usos múltiples - Especifica la cantidad de veces que se debe ejecutar cada prueba. Si alguno de esos intentos falla por algún motivo, toda la prueba se considerará fallida. Normalmente, el valor especificado es solo un número entero. Ejemplo: --runs_per_test=3 ejecutará todas las pruebas 3 veces. Sintaxis alternativa: regex_filter@runs_per_test. Donde run_per_test significa un valor de número entero y regex_filter significa una lista de patrones de expresiones regulares de inclusión y exclusión (también consulta --instrumentation_filter). Ejemplo: --runs_per_test=//foo/.*,-//foo/bar/.*@3 ejecuta todas las pruebas en //foo/ excepto las que se encuentran en foo/bar tres veces. Esta opción se puede aprobar varias veces. El último argumento pasado que coincida tendrá prioridad. Si no hay coincidencia, la prueba se ejecuta solo una vez.
- Se acumulan
--test_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica variables de entorno adicionales que se insertarán en el entorno del ejecutor de pruebas. Las variables se pueden especificar por nombre, en cuyo caso su valor se leerá desde el entorno del cliente de Bazel o mediante el par nombre=valor. Esta opción se puede usar varias veces para especificar distintas variables. Solo lo usa el comando “bazel test”.
Etiquetas:test_runner
--test_timeout=<a single integer or comma-separated list of 4 integers>
valor predeterminado: "-1"- Anula los valores predeterminados de tiempo de espera de la prueba (en segundos). Si se especifica un solo valor entero positivo, se anularán todas las categorías. Si se especifican 4 números enteros separados por comas, estos anularán los tiempos de espera: corto, moderado, largo y eterno (en ese orden). En cualquier forma, un valor de -1 le indica a blaze que use sus tiempos de espera predeterminados para esa categoría.
- Configuración predeterminada de
--tvos_simulator_device=<a string>
: ver descripción -
Es el dispositivo que se simula cuando se ejecuta una aplicación de 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 que se ejecutará el simulador.
Etiquetas:test_runner
- Configuración predeterminada de
--tvos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Es la versión de tvOS que se ejecutará en el simulador cuando se ejecute o realice pruebas.
Etiquetas:test_runner
- Configuración predeterminada de
--watchos_simulator_device=<a string>
: ver descripción -
Es el dispositivo que se simula cuando se ejecuta una aplicación de 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 que se ejecutará el simulador.
Etiquetas:test_runner
- Configuración predeterminada de
--watchos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descripción -
Es la versión de watchOS que se ejecutará en el simulador cuando se ejecute o realice pruebas.
Etiquetas:test_runner
- El valor predeterminado de
--[no]zip_undeclared_test_outputs
es "true" (verdadero). -
Si es verdadero, los resultados de pruebas no declarados se archivarán en un archivo ZIP.
Etiquetas:test_runner
- Opciones relacionadas con el resultado y la semántica de la consulta:
- El valor predeterminado de
--aspect_deps=<off, conservative or precise>
es "conservador". -
Cómo resolver dependencias de aspecto cuando el formato de salida es {xml,proto,record}. “desactivado” significa que no se resuelven las dependencias de aspecto, “conservadora” (el valor predeterminado) significa que se agregan todas las dependencias de aspecto declaradas sin importar si se les otorga la clase de regla de las dependencias directas. “preciso” significa que solo se agregan esos aspectos que posiblemente estén activos dada la clase de regla de las dependencias directas. Ten en cuenta que el modo preciso requiere cargar otros paquetes para evaluar un solo objetivo, por lo que es más lento que los otros modos. Además, ten en cuenta que incluso el modo preciso no es del todo preciso: la decisión de calcular un aspecto se decide en la fase de análisis, que no se ejecuta durante la “consulta de Bazel”.
Etiquetas:build_file_semantics
--[no]consistent_labels
valor predeterminado: "false"-
Si se habilita, cada comando de consulta emite etiquetas como si lo hiciera la función <code>str</code> de Starlark aplicada a una instancia de <code>etiqueta</code>. Esto es útil para las herramientas que necesitan hacer coincidir el resultado de diferentes comandos de consulta o etiquetas emitidas por reglas. Si no están habilitados, los formateadores de salida tienen la libertad de emitir nombres de repositorio aparentes (en relación con el repositorio principal) para que los resultados sean más legibles.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]graph:factored
es "true" (verdadero). -
Si es "true", el gráfico se emitirá "factorizado", es decir, los nodos equivalentes topológicamente se combinarán y sus etiquetas se concatenarán. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--graph:node_limit=<an integer>
predeterminado: "512"-
La longitud máxima de la string de etiqueta para un nodo del gráfico en el resultado. Las etiquetas más largas se truncarán; -1 significa que no hay truncamiento. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]implicit_deps
es "true" (verdadero). -
Si se habilita, las dependencias implícitas se incluirán en el gráfico de dependencias en el que opera la consulta. Una dependencia implícita es aquella que no se especifica de forma explícita en el archivo BUILD, sino que Bazel la agrega. En el caso de cquery, esta opción controla el filtrado de cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
- El valor predeterminado de
--[no]include_aspects
es "true" (verdadero). -
aquery, cquery: si se deben incluir acciones generadas por el aspecto en el resultado. query: no-op (siempre se siguen los aspectos).
Etiquetas:terminal_output
- El valor predeterminado de
--[no]incompatible_display_source_file_location
es "true" (verdadero). -
De forma predeterminada, 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 fines de migración.
Etiquetas:terminal_output
,incompatible_change
- El valor predeterminado de
--[no]incompatible_package_group_includes_double_slash
es "true" (verdadero). -
Si se habilita, cuando se genere el atributo `packages` de package_group, no se omitirá el signo `//` inicial.
Etiquetas:terminal_output
,incompatible_change
--[no]infer_universe_scope
valor predeterminado: "false"-
Si se configura y --universe_scope no se establece, se inferirá un valor de --universe_scope como la lista de patrones de objetivo únicos en la expresión de consulta. Ten en cuenta que el valor de --universe_scope que se infiere para una expresión de consulta que utiliza funciones con alcance universal (p.ej., `allrdeps`) puede no ser lo que quieres, por lo que solo debes usar esta opción si sabes lo que estás haciendo. Consulta https://bazel.build/reference/query#sky-query para obtener detalles y ejemplos. Si se configura --universe_scope, se ignora el valor de esta opción. Nota: Esta opción solo se aplica a “consulta” (es decir, no a “cquery”).
Etiquetas:loading_and_analysis
--[no]line_terminator_null
valor predeterminado: "false"-
Indica si cada formato termina con \0 en lugar de una línea nueva.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]nodep_deps
es "true" (verdadero). -
Si se habilita, las dependencias de los atributos “nodep” se incluirán en el gráfico de dependencias en el que opera la consulta. Un ejemplo común de un atributo “nodep” es la “visibilidad”. Ejecuta y analiza el resultado de `info build-language` para conocer todos los atributos “nodep” en el lenguaje de compilación.
Etiquetas:build_file_semantics
--output=<a string>
, valor predeterminado: “label”-
El formato en el que se deben imprimir los resultados de cquery. Los valores permitidos para cquery son los siguientes: label, label_kind, textproto, transiciones, proto y jsonproto. Si seleccionas "transitions", también debes especificar la opción --transitions=(lite|full).
Etiquetas:terminal_output
- El valor predeterminado de
--[no]proto:default_values
es "true" (verdadero). -
Si el valor es "true", se incluyen los atributos cuyo valor no se especifica de forma explícita en el archivo BUILD. De lo contrario, se omiten. Esta opción se aplica a --output=proto
Etiquetas:terminal_output
--[no]proto:definition_stack
valor predeterminado: "false"-
Propaga el campo proto define_stack que registra, para cada instancia de regla, la pila de llamadas de Starlark en el momento en que se definió la clase de la regla.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]proto:flatten_selects
es "true" (verdadero). -
Si se habilita, se compactan los atributos configurables creados por select(). Para los tipos de lista, la representación plana es una lista que contiene cada valor del mapa de selección exactamente una vez. Los tipos escalares se acoplan a nulos.
Etiquetas:build_file_semantics
- El valor predeterminado de
--[no]proto:include_configurations
es "true" (verdadero).
Si se habilita - , el resultado de proto incluirá información sobre los parámetros de configuración. Cuando se inhabilita,el formato de salida de cquery proto se asemeja al formato de resultados de la consulta.
Etiquetas:affects_outputs
--[no]proto:include_synthetic_attribute_hash
valor predeterminado: "false"-
Indica si se debe calcular y propagar el atributo $internal_attr_hash o no.
Etiquetas:terminal_output
--[no]proto:instantiation_stack
valor predeterminado: "false"-
Propaga la pila de llamadas de creación de instancias de cada regla. Ten en cuenta que esto requiere que la pila esté presente
Etiquetas:terminal_output
- El valor predeterminado de
--[no]proto:locations
es "true" (verdadero). - Indica si se debe generar información de ubicación en el resultado de proto.
Etiquetas:terminal_output
- La configuración predeterminada de
--proto:output_rule_attrs=<comma-separated list of options>
es "todos" -
Lista de atributos separados por comas para incluir en el resultado. La configuración predeterminada es todos los atributos. Se establece como una cadena vacía para no generar ningún atributo. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]proto:rule_inputs_and_outputs
es "true" (verdadero). -
Indica si se deben propagar los campos rule_input y rule_output o no.
Etiquetas:terminal_output
--query_file=<a string>
predeterminado: ""-
Si se configura, la consulta leerá la consulta desde el archivo que se menciona aquí, en lugar de hacerlo desde la línea de comandos. Es un error especificar un archivo aquí, así como una consulta de línea de comandos.
Etiquetas:changes_inputs
--[no]relative_locations
valor predeterminado: "false"-
Si es "true", la ubicación de los archivos BUILD en los resultados xml y proto será relativa. De forma predeterminada, el resultado de la ubicación es una ruta de acceso absoluta y no será coherente en todas las máquinas. Puedes configurar esta opción como verdadera para obtener un resultado coherente en todas las máquinas.
Etiquetas:terminal_output
- El valor predeterminado de
--show_config_fragments=<off, direct or transitive>
es "desactivado" -
Muestra los fragmentos de configuración que requiere una regla y sus dependencias transitivas. Esto puede ser útil para evaluar cuánto se puede recortar un gráfico de destino configurado.
Etiquetas:affects_outputs
--starlark:expr=<a string>
predeterminado: ""-
Una expresión de Starlark para dar formato a cada destino configurado en el modo --output=starlark de cquery. El destino configurado está vinculado al “objetivo”. Si no se especifica --starlark:expr ni --starlark:file, esta opción se establecerá de forma predeterminada como “str(target.label)”. Es un error especificar --starlark:expr y --starlark:file.
Etiquetas:terminal_output
--starlark:file=<a string>
predeterminado: ""-
Es el nombre de un archivo que define una función de Starlark llamada "formato" de un argumento que se aplica a cada destino configurado para darle formato como una cadena. Es un error especificar --starlark:expr y --starlark:file. Consulta la ayuda de --output=starlark para obtener más detalles.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]tool_deps
es "true" (verdadero). -
Consulta: Si se inhabilita, las dependencias de los objetivos de “configuración del host” o “ejecución” no se incluirán en el gráfico de dependencias en el que opera la consulta. Un perímetro de dependencia de 'host configuration', como el de cualquier regla 'proto_library' al compilador de protocolos, generalmente apunta a una herramienta ejecutada durante la compilación en lugar de a una parte del mismo programa 'target'.
Cquery: Si se inhabilita, filtra todos los destinos configurados que cruzan un host o una transición de ejecución del objetivo de nivel superior que descubrió este objetivo configurado. Esto significa que si el objetivo de nivel superior está en la configuración de destino, solo se mostrarán los objetivos configurados también en esa configuración. Si el objetivo de nivel superior se encuentra en la configuración del host, solo se mostrarán los destinos configurados de host. Esta opción NO excluirá las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
- La configuración predeterminada de
--transitions=<full, lite or none>
es “ninguna” -
Es el formato en el que cquery imprimirá la información de transición.
Etiquetas:affects_outputs
--universe_scope=<comma-separated list of options>
predeterminado: ""-
Un conjunto de patrones de objetivo separados por comas (aditivos y sustractivos). La consulta se puede realizar en el universo definido por el cierre transitivo de los destinos especificados. Esta opción se usa para los comandos query y cquery.
Para cquery, la entrada a esta opción son los destinos en los que se compilan todas las respuestas, por lo que esta opción puede afectar las configuraciones y las transiciones. Si no se especifica esta opción, se supone que los destinos de nivel superior son los destinos analizados a partir de la expresión de consulta. Nota: En el caso de cquery, no especificar esta opción puede provocar que la compilación falle si los objetivos analizados a partir de la expresión de consulta no se pueden compilar con opciones de nivel superior.
Etiquetas:loading_and_analysis
- Opciones que activan optimizaciones del tiempo de compilación:
--[no]collapse_duplicate_defines
valor predeterminado: "false"-
Cuando se habilita, el atributo redundante --define se quitará 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
valor predeterminado: "false"-
Filtra ProgramJar de ProGuard para quitar cualquier clase que también esté presente en LibraryJar.
Etiquetas:action_command_lines
- El valor predeterminado de
--[no]experimental_inmemory_dotd_files
es "true" (verdadero). -
Si se habilita, los archivos .d de C++ se pasarán directamente en la memoria desde los nodos de compilación remota, en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
yexperimental
- El valor predeterminado de
--[no]experimental_inmemory_jdeps_files
es "true" (verdadero). -
Si se habilita esta opción, los archivos de dependencia (.jdeps) generados a partir de compilaciones de Java se pasarán directamente a la memoria desde los nodos de compilación remota, en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
yexperimental
--[no]experimental_objc_include_scanning
valor predeterminado: "false"-
Indica si se debe realizar o no un análisis para el objetivo C/C++.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
--[no]experimental_parse_headers_skipped_if_corresponding_srcs_found
valor predeterminado: "false"-
Si se habilita, la función analyze_headers no crea una acción de compilación de encabezado independiente si se encuentra una fuente con el mismo nombre base en el mismo destino.
Etiquetas:loading_and_analysis
,affects_outputs
--[no]experimental_retain_test_configuration_across_testonly
valor predeterminado: "false"-
Cuando se habilita, --trim_test_configuration no recortará la configuración de prueba de las reglas marcadas como testonly=1. Esto tiene como objetivo reducir los problemas de conflicto de acciones cuando las reglas que no son de prueba dependen de las reglas cc_test. No tiene efecto si --trim_test_configuration es falso.
Etiquetas:loading_and_analysis
,loses_incremental_state
--[no]experimental_starlark_cc_import
valor predeterminado: "false"-
Si se habilita, se puede usar la versión de cc_import de Starlark.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_unsupported_and_brittle_include_scanning
valor predeterminado: "false"-
Determina si se deben reducir las entradas a la compilación de C/C++ analizando #include líneas de los archivos de entrada. Esto puede mejorar el rendimiento y la incrementalidad disminuyendo el tamaño de los árboles de entrada de la compilación. Sin embargo, también puede romper compilaciones porque el escáner de inclusión no implementa por completo la semántica del preprocesador de C. En particular, no comprende las directivas #include dinámicas e ignora la lógica condicional del preprocesador. Úsala bajo tu propia responsabilidad. Se cerrarán todos los problemas relacionados con esta marca que se presenten.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
- El valor predeterminado de
--[no]incremental_dexing
es "true" (verdadero). -
Realiza la mayor parte del trabajo para la conversión a DEX por separado para cada archivo Jar.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- El valor predeterminado de
--[no]objc_use_dotd_pruning
es "true" (verdadero). -
Si se configura, se usarán los archivos .d emitidos por Clang para reducir el conjunto de entradas que se pasaron a compilaciones de objc.
Etiquetas:changes_inputs
,loading_and_analysis
--[no]process_headers_in_dependencies
valor predeterminado: "false"-
Cuando compilas un destino //a:a, procesa los encabezados en todos los destinos de los que depende //a:a (si el procesamiento de encabezados está habilitado para la cadena de herramientas).
Etiquetas:execution
- El valor predeterminado de
--[no]trim_test_configuration
es "true" (verdadero). -
Cuando se habilita, las opciones relacionadas con pruebas se borrarán en el nivel superior de la compilación. Cuando esta marca está activa, las pruebas no se pueden compilar como dependencias de reglas que no sean de prueba, pero los cambios en las opciones relacionadas con pruebas no provocarán que las reglas que no son de prueba se vuelvan a analizar.
Etiquetas:loading_and_analysis
,loses_incremental_state
- El valor predeterminado de
--[no]use_singlejar_apkbuilder
es "true" (verdadero). -
Esta opción ya no está disponible. Ahora no es una función y se quitará pronto.
Etiquetas:loading_and_analysis
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
predeterminado: "-.*"-
Imprime información de depuración durante la resolución de la cadena de herramientas. La marca toma una regex, que se compara con tipos de cadenas de herramientas y objetivos específicos para ver cuál depurar. Varias regex se pueden separar por comas y, luego, cada regex se verifica por separado. Nota: El resultado de esta marca es muy complejo y probablemente solo sea útil para los expertos en la resolución de la cadena de herramientas.
Etiquetas:terminal_output
- Opciones que especifican o modifican una entrada genérica a un comando de Bazel que no se incluye en otras categorías:
- Se acumulan
--flag_alias=<a 'name=value' flag alias>
usos múltiples - Establece un nombre abreviado para una marca de Starlark. Toma un solo par clave-valor con el formato "<key>=<value>" como argumento.
Etiquetas:changes_inputs
--[no]incompatible_default_to_explicit_init_py
valor predeterminado: "false"-
Esta marca cambia el comportamiento predeterminado para que los archivos __init__.py ya no se creen automáticamente en los archivos de ejecución de los destinos de Python. De manera precisa, cuando un destino py_binary o py_test tiene legacy_create_init configurado como "auto" (predeterminado), se trata como falso si y solo si esta marca está configurada. Consulta https://github.com/bazelbuild/bazel/issues/10076.
Etiquetas:affects_outputs
,incompatible_change
- El valor predeterminado de
--[no]incompatible_py2_outputs_are_suffixed
es "true" (verdadero). -
Si es verdadero, los destinos compilados en la configuración de Python 2 aparecerán bajo una raíz de salida que incluye el sufijo “-py2”, mientras que los destinos compilados para Python 3 aparecerán en una raíz sin sufijo relacionado con Python. Esto significa que el symlink de conveniencia `bazel-bin` apuntará a los destinos de Python 3 en lugar de Python 2. Si habilitas esta opción, también se recomienda habilitar `--incompatible_py3_is_default`.
Etiquetas:affects_outputs
,incompatible_change
- El valor predeterminado de
--[no]incompatible_py3_is_default
es "true" (verdadero). -
Si el valor es true, los destinos `py_binary` y `py_test` que no establecen su atributo `python_version` (o `default_python_version`) se establecerán de forma predeterminada como PY3 en lugar de PY2. Si estableces esta marca, también se recomienda configurar `--incompatible_py2_outputs_are_sufsolution`.
Etiquetas:loading_and_analysis
,affects_outputs
,incompatible_change
- El valor predeterminado de
--[no]incompatible_use_python_toolchains
es "true" (verdadero). -
Si se configura como verdadera, las reglas nativas ejecutables de Python usarán el entorno de ejecución de Python especificado por la cadena de herramientas de Python, en lugar del entorno de ejecución proporcionado por marcas heredadas como --python_top.
Etiquetas:loading_and_analysis
,incompatible_change
- Configuración predeterminada de
--python_version=<PY2 or PY3>
: ver descripción -
Es el modo de versión principal de Python, que puede ser “PY2” o “PY3”. Ten en cuenta que los objetivos “py_binary” y “py_test” anulan esto (incluso si no especifican explícitamente una versión), por lo que, por lo general, no hay muchas razones para proporcionar esta marca.
Etiquetas:loading_and_analysis
,affects_outputs
,explicit_in_output_path
- Opciones varias, que no están categorizadas de otra manera:
--[no]cache_test_results
[-t
] predeterminado: "auto"- Si se configura como "auto", Bazel vuelve a ejecutar una prueba solo si (1) Bazel detecta cambios en la prueba o sus dependencias, (2) la prueba se marca como externa, (3) se solicitaron varias ejecuciones de prueba con --runs_per_test o(4) si la prueba falló anteriormente. Si se configura como “sí”, Bazel almacena en caché todos los resultados de la prueba, excepto las que se marcaron como externas. Si se configura como “no”, Bazel no almacena en caché ningún resultado de prueba.
--[no]experimental_cancel_concurrent_tests
valor predeterminado: "false"-
Si es "true", el Blaze cancelará las pruebas que se ejecutan de forma simultánea en la primera ejecución exitosa. Esto solo es útil en combinación con --runs_per_test_detects_flakes.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_fetch_all_coverage_outputs
valor predeterminado: "false"-
Si es verdadero, Bazel recupera todo el directorio de datos de cobertura para cada prueba durante una ejecución de cobertura.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_generate_llvm_lcov
valor predeterminado: "false"-
Si es "true", la cobertura de Clang generará un informe de LCOV.
Etiquetas:affects_outputs
,loading_and_analysis
- El valor predeterminado de
--[no]experimental_j2objc_header_map
es "true" (verdadero). - Indica si se debe generar el mapa de encabezados de J2ObjC en paralelo de la transpilación de J2ObjC.
--[no]experimental_j2objc_shorter_header_path
valor predeterminado: "false"-
Indica si se debe generar con una ruta de encabezado más corta (usa "_ios" en lugar de "_j2objc").
Etiquetas:affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
predeterminado: "javabuilder"- Habilita rutas de clase reducidas para compilaciones de Java.
--[no]experimental_limit_android_lint_to_android_constrained_java
valor predeterminado: "false"- Limita --experimental_run_android_lint_on_java_rules a bibliotecas compatibles con Android.
Etiquetas:affects_outputs
--[no]experimental_run_android_lint_on_java_rules
valor predeterminado: "false"- Determina si se deben validar las fuentes java_*.
Etiquetas:affects_outputs
--[no]explicit_java_test_deps
valor predeterminado: "false"- Especifica de forma explícita una dependencia a JUnit o Hamcrest en una java_test, en lugar de obtenerla accidentalmente desde las dependencias de TestRunner. Por el momento, solo funciona para Bazel.
- Configuración predeterminada de
--host_java_launcher=<a build target label>
: ver descripción - El Selector de Java utilizado por las herramientas que se ejecutan durante una compilación.
- Se acumulan
--host_javacopt=<a string>
usos múltiples - Son opciones adicionales para pasar a javac cuando se compilan herramientas que se ejecutan durante una compilación.
- Se acumulan
--host_jvmopt=<a string>
usos múltiples - Opciones adicionales para pasar a la VM de Java cuando se compilan herramientas que se ejecutan durante la compilación. Estas opciones se agregarán a las opciones de inicio de la VM de cada destino java_binary.
--[no]incompatible_check_sharding_support
valor predeterminado: "false"-
Si es verdadero, Bazel fallará una prueba fragmentada si el ejecutor de pruebas no indica que admite la fragmentación tocando el archivo en la ruta de acceso en TEST_SHARD_STATUS_FILE. Si es falso, un ejecutor de pruebas que no admita la fragmentación hará que se ejecuten todas las pruebas en cada fragmento.
Etiquetas:incompatible_change
--[no]incompatible_exclusive_test_sandboxed
valor predeterminado: "false"-
Si es verdadero, se ejecutarán pruebas exclusivas con la estrategia de zona de pruebas. Agrega la etiqueta “local” para forzar una ejecución de prueba exclusiva de forma local.
Etiquetas:incompatible_change
--[no]incompatible_strict_action_env
valor predeterminado: "false"-
Si es verdadero, Bazel usa un entorno con un valor estático para PATH y no hereda LD_LIBRARY_PATH. Usa --action_env=ENV_VARIABLE si deseas heredar variables de entorno específicas del cliente, pero ten en cuenta que esto puede evitar el almacenamiento en caché entre usuarios si se usa una caché compartida.
Etiquetas:loading_and_analysis
,incompatible_change
- Se acumulan
--j2objc_translation_flags=<comma-separated list of options>
usos múltiples - Opciones adicionales para pasar a la herramienta J2ObjC.
--java_debug
-
Hace que la máquina virtual Java de una prueba de Java espere una conexión de un depurador compatible con JDWP (como jdb) antes de comenzar la prueba. Insinúa -test_output=streamed.
Se expande a:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
- El valor predeterminado de
--[no]java_deps
es "true" (verdadero). - Genera información de dependencias (por ahora, la ruta de clase en tiempo de compilación) por destino de Java.
- El valor predeterminado de
--[no]java_header_compilation
es "true" (verdadero). - Compila ijars directamente desde la fuente.
--java_language_version=<a string>
predeterminado: "8"- La versión del lenguaje Java
- Configuración predeterminada de
--java_launcher=<a build target label>
: ver descripción - El Selector de Java que se usa cuando se compilan objetos binarios de Java. Si esta marca se establece en una cadena vacía, se usa el selector de JDK. El atributo "launcher" anula esta marca.
--java_runtime_version=<a string>
valor predeterminado: "local_jdk"- La versión del entorno de ejecución de Java
- Se acumulan
--javacopt=<a string>
usos múltiples - Opciones adicionales para pasar a javac.
- Se acumulan
--jvmopt=<a string>
usos múltiples - Opciones adicionales para pasar a la VM de Java. Estas opciones se agregarán a las opciones de inicio de la VM de cada destino java_binary.
- Configuración predeterminada de
--legacy_main_dex_list_generator=<a build target label>
: ver descripción - Especifica un objeto binario que se usará para generar la lista de clases que deben estar en el DEX principal cuando se compila multidex heredado.
- Se acumulan
--plugin=<a build target label>
usos múltiples - Complementos para usar en la compilación. Actualmente, funciona con java_plugin.
- Configuración predeterminada de
--proguard_top=<a build target label>
: ver descripción - Especifica qué versión de ProGuard se usará para quitar código cuando se compile un objeto binario de Java.
--proto_compiler=<a build target label>
predeterminado: "@bazel_tools//tools/proto:protoc"-
Es la etiqueta del compilador de protocolos.
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
predeterminado: "@bazel_tools//tools/proto:cc_toolchain"-
Etiqueta de proto_lang_toolchain(), que describe cómo compilar protos de C++
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
predeterminado: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"-
Etiqueta de proto_lang_toolchain(), que describe cómo compilar protos j2objc
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
valor predeterminado: "@bazel_tools//tools/proto:java_toolchain"-
Etiqueta de proto_lang_toolchain(), que describe cómo compilar protos de Java
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
valor predeterminado: "@bazel_tools//tools/proto:javalite_toolchain"-
Etiqueta de proto_lang_toolchain(), que describe cómo compilar protos de JavaLite
Etiquetas:affects_outputs
,loading_and_analysis
- Se acumulan
--protocopt=<a string>
usos múltiples -
Son opciones adicionales para pasar al compilador de protobuf.
Etiquetas:affects_outputs
--[no]runs_per_test_detects_flakes
valor predeterminado: "false"- Si es verdadero, cualquier fragmento en el que al menos una ejecución o un intento se complete y al menos uno falle tenga un estado FLAKY.
- Configuración predeterminada de
--shell_executable=<a path>
: ver descripción -
Ruta de acceso absoluta al shell ejecutable para que lo use Bazel. Si no se configura, pero la variable de entorno BAZEL_SH está configurada en la primera invocación de Bazel (que inicia un servidor de Bazel), Bazel la usa. Si no se establece ninguno, Bazel usa una ruta de acceso predeterminada hard-coded según el sistema operativo en el que se ejecuta (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, todos los demás: /bin/bash). Ten en cuenta que el uso de una shell que no es compatible con Bash puede provocar fallas de compilación o de tiempo de ejecución de los objetos binarios generados.
Etiquetas:loading_and_analysis
- Se acumulan
--test_arg=<a string>
usos múltiples - Especifica opciones y argumentos adicionales que se deben pasar al ejecutable de prueba. Se puede usar varias veces para especificar varios argumentos. Si se ejecutan varias pruebas, cada una recibirá argumentos idénticos. Solo lo usa el comando “bazel test”.
- Configuración predeterminada de
--test_filter=<a string>
: ver descripción - Especifica un filtro para reenviar al framework de pruebas. Se usa para limitar la ejecución de pruebas. Ten en cuenta que esto no afecta los destinos que se compilan.
--test_result_expiration=<an integer>
valor predeterminado: "-1"- Esta opción dejó de estar disponible y no tiene efecto.
--[no]test_runner_fail_fast
valor predeterminado: "false"- Reenvía la opción de falla rápida al ejecutor de pruebas. El ejecutor de pruebas debe detener la ejecución en la primera falla.
- Valor predeterminado de
--test_sharding_strategy=<explicit or disabled>
: "explícito" - Especifica una estrategia para la fragmentación de pruebas: "explícito" para usar solo la fragmentación si está presente el atributo de COMPILACIÓN "shard_count". “inhabilitado” para no usar nunca la fragmentación de pruebas.
--tool_java_language_version=<a string>
predeterminado: "8"- La versión del lenguaje Java que se usa para ejecutar las herramientas que se necesitan durante una compilación
--tool_java_runtime_version=<a string>
predeterminado: "remotejdk_11"- La versión del entorno de ejecución de Java que se usa para ejecutar herramientas durante la compilación
- El valor predeterminado de
--[no]use_ijars
es "true" (verdadero). - Si se habilita, esta opción hace que la compilación de Java use archivos jar de la interfaz. Esto dará como resultado una compilación incremental más rápida, pero los mensajes de error pueden ser diferentes.
Opciones de volcado
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Más lugares donde buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
valor predeterminado: "false"-
Si se configura, la caché del repositorio vinculará el archivo de forma fija en caso de un acierto de caché, en lugar de copiar. Esto sirve para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
valor predeterminado: "false"-
Si es verdadero, usa una string derivada de las URLs de descargas del repositorio como canonical_id si no se especifica. Esto provoca que un cambio en las URLs genere una nueva descarga incluso si la caché contiene una descarga con el mismo hash. Se puede usar para verificar que los cambios en la URL no den como resultado que la caché oculte los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
valor predeterminado: "false"-
Si se configura, no se permite la descarga de repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Usa este factor para escalar todos los tiempos de espera en las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que sean más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación en caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una string vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que controlan el resultado del comando:
--[no]action_cache
valor predeterminado: "false"-
Volcar el contenido de la caché de la acción.
Etiquetas:bazel_monitoring
--[no]packages
valor predeterminado: "false"- Vacía el contenido de la caché del paquete.
Etiquetas:bazel_monitoring
--[no]rule_classes
valor predeterminado: "false"-
Clases de reglas de volcado
Etiquetas:bazel_monitoring
--[no]rules
valor predeterminado: "false"-
Reglas de volcado, incluidos los recuentos y el uso de memoria (si se hace un seguimiento de la memoria).
Etiquetas:bazel_monitoring
- El valor predeterminado de
--skyframe=<off, summary, count, deps or rdeps>
es "desactivado" -
Gráfico de volcado de Skyframe: "off", "summary", "count", "deps" o "rdeps".
Etiquetas:bazel_monitoring
--skykey_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
predeterminado: ".*"-
Filtro de regex de los nombres de SkyKey que se deben generar. Solo se usa con --skyframe=deps, rdeps.
Etiquetas:bazel_monitoring
- Configuración predeterminada de
--skylark_memory=<a string>
: ver descripción -
Vuelca un perfil de memoria compatible con pprof en la ruta de acceso especificada. Para obtener más información, consulta https://github.com/google/pprof.
Etiquetas:bazel_monitoring
- Opciones que afectan la medida en la que Bazel aplica de manera estricta entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
--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 hashes del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan
--experimental_verify_repository_rules=<a string>
usos múltiples -
Si es una lista de reglas de repositorio para las que se debe verificar el hash del directorio de salida, siempre que un archivo se especifique mediante --experimental_repository_hash_file.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE.:
- El valor predeterminado de
--[no]experimental_allow_top_level_aspects_parameters
es "true" (verdadero). -
No-op
Etiquetas:no_op
,deprecated
,experimental
- Opciones relacionadas con la semántica y el resultado de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Especificaste las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirá en el gráfico de dependencias resueltas incluso si se declararon de forma privada en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones anteriores harán que la resolución falle. También puedes definir la versión transferida permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
- El valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
es "error" -
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son “error” para derivarlo a una falla de resolución, “off” para inhabilitar la verificación o “warning” para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas `bazel_dep` declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son “off” para inhabilitar la verificación, “warning” para imprimir una advertencia cuando se detecte una discrepancia o “error” para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
valor predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- El valor predeterminado de
--lockfile_mode=<off, update or error>
es "desactivado" -
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son “update” para usar el archivo de bloqueo y actualizarlo si hay cambios; “error” para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o “off” para no leerlo ni escribirlo en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y se recurrirá únicamente a los posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
valor predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán estadísticas para todos los mnemotécnicos.
- Opciones que especifican o alteran una entrada genérica a un comando de Bazel que no pertenece a otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remoto:
- Configuración predeterminada de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo para configurar el cargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno con el que debe coincidir y otro para usar como URL sustitutiva, con referencias inversas que comienzan con "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL, y se mostrarán varias URL.
- Opciones varias, que no están categorizadas:
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
Opciones de recuperación
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Más lugares donde buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
valor predeterminado: "false"-
Si se configura, la caché del repositorio vinculará el archivo de forma fija en caso de un acierto de caché, en lugar de copiar. Esto sirve para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
valor predeterminado: "false"-
Si es verdadero, usa una string derivada de las URLs de descargas del repositorio como canonical_id si no se especifica. Esto provoca que un cambio en las URLs genere una nueva descarga incluso si la caché contiene una descarga con el mismo hash. Se puede usar para verificar que los cambios en la URL no den como resultado que la caché oculte los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
valor predeterminado: "false"-
Si se configura, no se permite la descarga de repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Usa este factor para escalar todos los tiempos de espera en las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que sean más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación en caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una string vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de la compilación:
- El valor predeterminado de
--[no]incompatible_remote_dangling_symlinks
es "true" (verdadero). -
Si se configura como verdadero y --incompatible_remote_symlinks también es verdadero, los symlinks en las salidas de acción pueden colgarse.
Etiquetas:execution
,incompatible_change
- El valor predeterminado de
--[no]incompatible_remote_symlinks
es "true" (verdadero). -
Si se configura como verdadera, Bazel representará symlinks en los resultados de acción en el protocolo de ejecución/almacenamiento en caché remoto como tal. De lo contrario, se seguirán los symlinks y se representarán como archivos o directorios. Consulta #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 el objetivo que falló y aquellos que dependen de él no se pueden analizar, otros requisitos previos de estos objetivos pueden serlo.
Etiquetas:eagerness_to_exit
- Valor predeterminado de
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "auto" -
Cantidad de subprocesos paralelos que se usarán en la fase de carga o análisis. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguido de una operación ([-|*]<float>), p. ej., “auto”, “HOST_CPUS*.5”. “auto” establece un valor predeterminado razonable según los recursos del host. Debe ser 1 como mínimo.
Etiquetas:bazel_internal_configuration
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
--bep_maximum_open_remote_upload_files=<an integer>
valor predeterminado: "-1"-
Cantidad máxima de archivos abiertos permitida durante la carga del artefacto BEP.
Etiquetas:affects_outputs
--remote_download_minimal
-
No descarga ningún resultado de compilación remota en la máquina local. Esta marca es un acceso directo 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
- La configuración predeterminada de
--remote_download_outputs=<all, minimal or toplevel>
es "todos" -
Si se configura como “mínima”, no se descarga ningún resultado de compilación remota en la máquina local, excepto los que requieren las acciones locales. Si se configura en “toplevel”, se comporta como “minimal”, excepto que también descarga los resultados de los destinos de nivel superior en la máquina local. Ambas opciones pueden reducir significativamente los tiempos de compilación si el ancho de banda de la red representa un cuello de botella.
Etiquetas:affects_outputs
--remote_download_symlink_template=<a string>
predeterminado: ""-
En lugar de descargar resultados de compilación remotas en la máquina local, crea vínculos simbólicos. El destino de los vínculos simbólicos puede especificarse con la forma de una cadena de plantilla. Esta string de plantilla puede contener {hash} y {size_bytes} que se expanden al hash del objeto y el tamaño en bytes, respectivamente. Estos vínculos simbólicos pueden apuntar, por ejemplo, a un sistema de archivos FUSE que cargue objetos de CAS a pedido.
Etiquetas:affects_outputs
--remote_download_toplevel
- Solo descarga las salidas remotas de los destinos de nivel superior en la máquina local. Esta marca es un acceso directo 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 el grado de rigurosidad de Bazel de las 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 hashes del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan
--experimental_verify_repository_rules=<a string>
usos múltiples -
Si es una lista de reglas de repositorio para las que se debe verificar el hash del directorio de salida, siempre que un archivo se especifique mediante --experimental_repository_hash_file.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE.:
- El valor predeterminado de
--[no]experimental_allow_top_level_aspects_parameters
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,deprecated
,experimental
--[no]incompatible_config_setting_private_default_visibility
valor predeterminado: "false"-
Si es incompatible_enforce_config_setting_visibility=false, esta es una noop. De lo contrario, si la marca es falsa, cualquier config_setting sin un atributo de visibilidad explícito es //visibility:public. Si esta marca es verdadera, config_setting sigue la misma lógica de visibilidad que todas las demás reglas. Consulta https://github.com/bazelbuild/bazel/issues/12933.
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_enforce_config_setting_visibility
es "true" (verdadero). -
Si es verdadero, aplica restricciones de visibilidad config_setting. Si es falso, cada config_setting es visible para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones relacionadas con la semántica y el resultado de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Especificaste las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirá en el gráfico de dependencias resueltas incluso si se declararon de forma privada en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones anteriores harán que la resolución falle. También puedes definir la versión transferida permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
- El valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
es "error" -
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son “error” para derivarlo a una falla de resolución, “off” para inhabilitar la verificación o “warning” para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas `bazel_dep` declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son “off” para inhabilitar la verificación, “warning” para imprimir una advertencia cuando se detecte una discrepancia o “error” para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
valor predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- El valor predeterminado de
--lockfile_mode=<off, update or error>
es "desactivado" -
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son “update” para usar el archivo de bloqueo y actualizarlo si hay cambios; “error” para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o “off” para no leerlo ni escribirlo en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y se recurrirá únicamente a los posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
valor predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán estadísticas para todos los mnemotécnicos.
--experimental_repository_resolved_file=<a string>
predeterminado: ""-
Si no está vacío, escribe un valor de Starlark con la información resuelta de todas las reglas del repositorio de Starlark que se ejecutaron.
Etiquetas:affects_outputs
- Valor predeterminado de
--remote_print_execution_messages=<failure, success or all>
: “error” -
Elige cuándo imprimir mensajes de ejecución remota. Los valores válidos son “failure”, para imprimir solo en caso de errores, “success” para imprimir solo en casos exitosos y “all” para imprimir siempre.
Etiquetas:terminal_output
- Opciones que especifican o modifican una entrada genérica a un comando de Bazel que no se incluye en otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remoto:
- Configuración predeterminada de
--experimental_circuit_breaker_strategy=<failure>
: ver descripción -
Especifica la estrategia que usará el disyuntor. Las estrategias disponibles son el “fracaso”. Si el valor de la opción no es válido, no se establece el comportamiento de la opción.
Etiquetas:execution
- Configuración predeterminada de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo para configurar el cargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno con el que debe coincidir y otro para usar como URL sustitutiva, con referencias inversas que comienzan con "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL, y se mostrarán varias URL.
--[no]experimental_guard_against_concurrent_changes
valor predeterminado: "false"- Desactiva esta opción para inhabilitar la verificación de la hora de los archivos de entrada de una acción antes de subirla a una caché remota. Puede haber casos en los que el kernel de Linux retrasa la escritura de archivos, lo que podría causar falsos positivos.
- La configuración predeterminada de
--experimental_remote_build_event_upload=<all or minimal>
es "todos" - Si se configura como “all”, todas las salidas locales a las que hace referencia BEP se suben a la caché remota. Si se configura como “mínimo”, las salidas locales a las que hace referencia BEP no se suben a la caché remota, excepto los archivos que son importantes para los consumidores de BEP (p.ej., registros de prueba y perfil de sincronización). El esquema bytestream:// siempre se usa para el URI de los archivos, incluso si faltan de la caché remota. La configuración predeterminada es “all”.
--[no]experimental_remote_cache_async
valor predeterminado: "false"- Si es verdadero, la E/S de la caché remota se producirá en segundo plano, en lugar de tener lugar como parte de una generación.
--[no]experimental_remote_cache_compression
valor predeterminado: "false"- Si está habilitada, comprime o descomprime los BLOB de caché con zstd.
- Configuración predeterminada de
--experimental_remote_capture_corrupted_outputs=<a path>
: ver descripción - Una ruta de acceso a un directorio en el que se capturarán los resultados dañados.
--[no]experimental_remote_discard_merkle_trees
valor predeterminado: "false"- Si se configura como verdadera, descarta las copias en memoria del árbol Merkle de la raíz de entrada y las asignaciones de entradas asociadas durante las llamadas a GetActionResult() y Execute(). Esta acción reduce el uso de memoria de forma significativa, pero requiere que Bazel vuelva a calcularlas ante errores y reintentos de la caché remota.
- Configuración predeterminada de
--experimental_remote_downloader=<a string>
: ver descripción - Un URI de extremo de la API de Remote Asset, que se usará como proxy de descarga remoto. Los esquemas compatibles son grpc, grpcs (grpc con TLS habilitada) y Unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel se establecerá de forma predeterminada en grpcs. Consulta: https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto
--[no]experimental_remote_downloader_local_fallback
valor predeterminado: "false"- Indica si se debe recurrir al cargador local si falla el cargador remoto.
--[no]experimental_remote_execution_keepalive
valor predeterminado: "false"- Indica si se debe usar keepalive para llamadas de ejecución remota.
--experimental_remote_failure_rate_threshold=<an integer in 0-100 range>
predeterminado: "10"-
Establece la cantidad permitida de tasa de fallas en un porcentaje para un período específico después del cual se deja de llamar al ejecutor o la caché remotos. El valor predeterminado es 10. Establecerlo en 0 significa que no existen limitaciones.
Etiquetas:execution
- Valor predeterminado de
--experimental_remote_failure_window_interval=<An immutable length of time.>
: "60s" -
El intervalo en el que se calcula la tasa de fallas de las solicitudes remotas. En un valor negativo o cero, la duración de la falla se calcula la duración total de la ejecución.Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
Etiquetas:execution
--[no]experimental_remote_mark_tool_inputs
valor predeterminado: "false"- Si se configura como verdadera, Bazel marcará las entradas como entradas de herramientas para el ejecutor remoto. Se puede usar para implementar trabajadores persistentes remotos.
--[no]experimental_remote_merkle_tree_cache
valor predeterminado: "false"- Si se establece como verdadera, se memorizarán los cálculos del árbol de Merkle para mejorar la velocidad de comprobación de aciertos de la caché remota. La huella de pie en la memoria de la caché se controla con --experimental_remote_merkle_tree_cache_size.
--experimental_remote_merkle_tree_cache_size=<a long integer>
predeterminado: "1000"- La cantidad de árboles de Merkle que se deben memorizar para mejorar la velocidad de verificación de aciertos de la caché remota. Aunque la caché se reduce automáticamente según el manejo de las referencias de software por parte de Java, pueden producirse errores de memoria insuficiente si la configuración es demasiado alta. Si se establece en 0, el tamaño de la caché es ilimitado. El valor óptimo varía según el tamaño del proyecto. La configuración predeterminada es 1,000.
--[no]experimental_remote_require_cached
valor predeterminado: "false"- Si se configura como verdadera, exige que todas las acciones que se pueden ejecutar de forma remota se almacenen en caché o, de lo contrario, falle la compilación. Esto es útil para solucionar problemas de no determinismo, ya que permite verificar si las acciones que deben almacenarse en caché realmente se almacenan en caché sin inyectar resultados nuevos en la caché de forma falsa.
--[no]incompatible_remote_build_event_upload_respect_no_cache
valor predeterminado: "false"- Si se configura como verdadera, los resultados a los que hace referencia BEP no se subirán a la caché remota si la acción que se genera no se puede almacenar en caché de manera remota.
- El valor predeterminado de
--[no]incompatible_remote_downloader_send_all_headers
es "true" (verdadero). -
Indica si se deben enviar todos los valores de un encabezado con varios valores al cargador remoto en lugar de solo el primero.
Etiquetas:incompatible_change
--[no]incompatible_remote_output_paths_relative_to_input_root
valor predeterminado: "false"-
Si se configura como verdadera, las rutas de salida están relacionadas con la raíz de entrada en lugar del directorio de trabajo.
Etiquetas:incompatible_change
- El valor predeterminado de
--[no]incompatible_remote_results_ignore_disk
es "true" (verdadero). -
Si se configura como verdadera, --noremote_upload_local_results y --noremote_Accept_cached no se aplicarán a la caché de 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_supported_cached hará que Bazel busque resultados en la caché del disco, pero no en la caché remota.
las acciones no-remote-exec pueden acceder a la caché del disco.
Consulta #8216 para obtener más información.
Etiquetas:incompatible_change
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
valor predeterminado: "false"-
Si se configura como verdadera, Bazel usará el nuevo código de salida 39 en lugar del 34 si la caché remota expulsa los BLOB durante la compilación.
Etiquetas:incompatible_change
- El valor predeterminado de
--[no]remote_accept_cached
es "true" (verdadero). - Indica si se aceptan resultados de acciones almacenados en caché de forma remota.
- Configuración predeterminada de
--remote_bytestream_uri_prefix=<a string>
: ver descripción - El nombre de host y el nombre de la instancia que se usarán en los URI bytestream:// que se escriben en transmisiones de eventos de compilación. Esta opción se puede configurar cuando las compilaciones se realizan con un proxy, lo que hace que los valores de --remote_executor y --remote_instance_name ya no correspondan con el nombre canónico del servicio de ejecución remota. Si no se establece, el valor predeterminado será “${hostname}/${instance_name}”.
- Configuración predeterminada de
--remote_cache=<a string>
: ver descripción - Un URI de un extremo de almacenamiento en caché. Los esquemas admitidos son http, https, grpc, grpcs (grpc con TLS habilitada) y Unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel se establecerá de forma predeterminada en grpcs. Especifica el esquema grpc://, http:// o Unix: para inhabilitar TLS. Consulta https://bazel.build/remote/caching
- Se acumulan
--remote_cache_header=<a 'name=value' assignment>
usos múltiples - Especifica un encabezado que se incluirá en las solicitudes de caché: --remote_cache_header=Name=Value. Se pueden pasar varios encabezados si se especifica la marca varias veces. Si hay varios valores con el mismo nombre, se convertirán en una lista separada por comas.
- Se acumulan
--remote_default_exec_properties=<a 'name=value' assignment>
usos múltiples -
Configura las propiedades de ejecución predeterminadas que se usarán como plataforma de ejecución remota si una plataforma de ejecución aún no configuró exec_properties.
Etiquetas:affects_outputs
--remote_default_platform_properties=<a string>
predeterminado: ""- Establece las propiedades de plataforma predeterminadas para la API de ejecución remota si la plataforma de ejecución aún no configuró remote_execution_properties. Este valor también se usará si se selecciona la plataforma host como la plataforma de ejecución para la ejecución remota.
- Se acumulan
--remote_downloader_header=<a 'name=value' assignment>
usos múltiples - Especifica un encabezado que se incluirá en las solicitudes de cargadores remotos: --remote_downloader_header=Name=Value. Se pueden pasar varios encabezados si se especifica la marca varias veces. Si hay varios valores con el mismo nombre, se convertirán en una lista separada por comas.
- Se acumulan
--remote_exec_header=<a 'name=value' assignment>
usos múltiples - Especifica un encabezado que se incluirá en las solicitudes de ejecución: --remote_exec_header=Name=Value. Se pueden pasar varios encabezados si se especifica la marca varias veces. Si hay varios valores con el mismo nombre, se convertirán en una lista separada por comas.
--remote_execution_priority=<an integer>
predeterminado: "0"- La prioridad relativa de las acciones que se ejecutarán de forma remota. La semántica de los valores de prioridad particulares depende del servidor.
- Configuración predeterminada de
--remote_executor=<a string>
: ver descripción - HOST o HOST:PORT de un extremo de ejecución remota. Los esquemas compatibles son grpc, grpcs (grpc con TLS habilitada) y Unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel se establecerá de forma predeterminada en grpcs. Especifica grpc:// o Unix: esquema para inhabilitar TLS.
- Configuración predeterminada de
--remote_grpc_log=<a path>
: ver descripción - Si se especifica, es una ruta a un archivo para registrar los detalles relacionados con las llamadas de gRPC. Este registro consta de una secuencia de protobufs serializados com.google.Dev
- Se acumulan
--remote_header=<a 'name=value' assignment>
usos múltiples - Especifica un encabezado que se incluirá en las solicitudes: --remote_header=Name=Value. Se pueden pasar varios encabezados si se especifica la marca varias veces. Si hay varios valores con el mismo nombre, se convertirán en una lista separada por comas.
--remote_instance_name=<a string>
predeterminado: ""- Valor que se pasará como instance_name en la API de ejecución remota.
--[no]remote_local_fallback
valor predeterminado: "false"- Determina si se debe recurrir a la estrategia de ejecución local independiente si falla la ejecución remota.
- El valor predeterminado de
--remote_local_fallback_strategy=<a string>
es "local" - No-ops, obsoleto. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/7480.
--remote_max_connections=<an integer>
predeterminado: "100"-
Limita la cantidad máxima de conexiones simultáneas a la caché o al ejecutor remoto. De forma predeterminada, el valor es 100. Establecerlo en 0 significa que no existen limitaciones.
Para la caché remota HTTP, una conexión TCP podría manejar una solicitud a la vez, por lo que Bazel podría compensar hasta --remote_max_connections solicitudes simultáneas.
Para la caché o el ejecutor remoto de gRPC, por lo general, un canal de gRPC podría manejar más de 100 solicitudes simultáneas, por lo que Bazel podría hacer alrededor de `--remote_max_connections * 100` solicitudes simultáneas.
Etiquetas:host_machine_resource_optimizations
- Configuración predeterminada de
--remote_proxy=<a string>
: ver descripción - Conéctate a la caché remota a través de un proxy. Actualmente, esta marca solo se puede usar para configurar un socket de dominio Unix (unix:/path/to/socket).
--remote_result_cache_priority=<an integer>
predeterminado: "0"- La prioridad relativa de las acciones remotas que se almacenarán en la caché remota. La semántica de los valores de prioridad particulares depende del servidor.
--remote_retries=<an integer>
predeterminado: "5"- La cantidad máxima de intentos para reintentar un error transitorio. Si se establece en 0, se inhabilitan los reintentos.
- Valor predeterminado de
--remote_retry_max_delay=<An immutable length of time.>
: "5 s" - Es el retraso máximo de retirada entre intentos remotos. Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
- Valor predeterminado de
--remote_timeout=<An immutable length of time.>
: "60s" - La cantidad máxima de tiempo que se debe esperar para la ejecución remota y las llamadas a caché. Para la caché de REST, este es el tiempo de espera de conexión y lectura. Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
- El valor predeterminado de
--[no]remote_upload_local_results
es "true" (verdadero). - Indica si se deben subir los resultados de acciones ejecutadas de forma local a la caché remota si la caché remota lo admite y el usuario está autorizado para hacerlo.
- El valor predeterminado de
--[no]remote_verify_downloads
es "true" (verdadero). - Si se configura como verdadera, Bazel calculará la suma de hash de todas las descargas remotas y descartará los valores almacenados en caché de manera remota si no coinciden con el valor esperado.
- Opciones varias, que no están categorizadas:
- Se acumulan
--credential_helper=<Path to a credential helper. It may be absolute, relative to the PATH environment variable, or %workspace%-relative. The path be optionally prefixed by a scope followed by an '='. The scope is a domain name, optionally with a single leading '*' wildcard component. A helper applies to URIs matching its scope, with more specific scopes preferred. If a helper has no scope, it applies to every URI.>
usos múltiples - Configura un auxiliar de credenciales que se usará para recuperar credenciales de autorización de recuperación de repositorios, almacenamiento en caché y ejecución remotos, y el servicio de eventos de compilación. Las credenciales que proporciona un asistente tienen prioridad sobre las que suministran --google_default_credentials, --google_credentials, un archivo .netrc o el parámetro auth a inicio_cat. Se puede especificar varias veces para configurar varios asistentes. Para obtener más información, consulta https://github.com/bazelbuild/proposals/blob/main/designs/2022-06-07-bazel-credential-helpers.md.
--credential_helper_cache_duration=<An immutable length of time.>
predeterminado: "30m"- Es el tiempo durante el cual se almacenan en caché las credenciales que proporciona un auxiliar de credenciales. Si 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.
- Valor predeterminado de
--credential_helper_timeout=<An immutable length of time.>
: "10 s" - Configura el tiempo de espera para un auxiliar de credenciales. Los auxiliares de credenciales que no respondan dentro de este tiempo de espera fallarán la invocación.
--deleted_packages=<comma-separated list of package names>
predeterminado: ""- Una lista separada por comas de los nombres de los paquetes que el sistema de compilación considerará que no existen, incluso si están visibles en algún lugar de la ruta del paquete. Usa esta opción cuando borres un subpaquete 'x/y' de un paquete 'x' existente. Por ejemplo, después de borrar x/y/BUILD en el cliente, el sistema de compilación puede presentar un reclamo si encuentra la etiqueta '//x:y/z' si todavía la proporciona otra entrada package_path. Si especificas --deleted_packages x/y se evita este problema.
- Configuración predeterminada de
--disk_cache=<a path>
: ver descripción - Una ruta de acceso a un directorio en el que Bazel puede leer y escribir acciones y resultados de acciones. Si el directorio no existe, se creará.
- El valor predeterminado de
--google_auth_scopes=<comma-separated list of options>
es "https://www.googleapis.com/auth/cloud-platform" - Una lista separada por comas de los permisos de autenticación de Google Cloud.
- Configuración predeterminada de
--google_credentials=<a string>
: ver descripción - Especifica el archivo del que se obtendrán credenciales de autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más detalles.
--[no]google_default_credentials
valor predeterminado: "false"- Indica si se deben usar las “Credenciales predeterminadas de la aplicación de Google” para la autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más detalles. Están inhabilitados de forma predeterminada.
- Configuración predeterminada de
--grpc_keepalive_time=<An immutable length of time.>
: ver descripción - Configura pings de keep-alive para las conexiones de gRPC salientes. Si se establece, Bazel envía pings después de este período sin operaciones de lectura en la conexión, pero solo si hay al menos una llamada de gRPC pendiente. Los horarios se consideran de segundo nivel de detalle; es un error establecer un valor inferior a un segundo. De forma predeterminada, los pings de keep-alive están inhabilitados. Debes coordinar con el propietario del servicio antes de habilitar este parámetro de configuración. Por ejemplo, para establecer un valor de 30 segundos para esta marca, debe hacerse de esta manera: --grpc_keepalive_time=30s.
- Valor predeterminado de
--grpc_keepalive_timeout=<An immutable length of time.>
: "20 s" - Configura un tiempo de espera de keep-alive para las conexiones de gRPC salientes. Si los pings keep-alive están habilitados con --grpc_keepalive_time, Bazel agota el tiempo de espera de una conexión si no recibe una respuesta de ping después de este tiempo. Los horarios se consideran de segundo nivel de detalle; es un error establecer un valor inferior a un segundo. Si los pings de keep-alive están inhabilitados, se ignora esta configuración.
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
--package_path=<colon-separated list of options>
predeterminado: "%workspace%"- Una lista separada por dos puntos sobre dónde buscar paquetes. Los elementos que comienzan con "%workspace%" son relativos al lugar de trabajo que lo contiene. Si se omite o está vacío, el valor predeterminado es el resultado de “bazel info default-package-path”.
- El valor predeterminado de
--[no]show_loading_progress
es "true" (verdadero). - Si se habilita, hace que Bazel imprima mensajes "Cargando paquete:".
- Configuración predeterminada de
--tls_certificate=<a string>
: ver descripción - Especifica una ruta de acceso a un certificado TLS que sea confiable para firmar certificados de servidor.
- Configuración predeterminada de
--tls_client_certificate=<a string>
: ver descripción - Especifica el certificado de cliente TLS que se usará; también debes proporcionar una clave de cliente para habilitar la autenticación de cliente.
- Configuración predeterminada de
--tls_client_key=<a string>
: ver descripción - Especifica la clave de cliente TLS que se usará; también debes proporcionar un certificado de cliente para habilitar la autenticación de cliente.
Opciones de ayuda
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Más lugares donde buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
valor predeterminado: "false"-
Si se configura, la caché del repositorio vinculará el archivo de forma fija en caso de un acierto de caché, en lugar de copiar. Esto sirve para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
valor predeterminado: "false"-
Si es verdadero, usa una string derivada de las URLs de descargas del repositorio como canonical_id si no se especifica. Esto provoca que un cambio en las URLs genere una nueva descarga incluso si la caché contiene una descarga con el mismo hash. Se puede usar para verificar que los cambios en la URL no den como resultado que la caché oculte los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
valor predeterminado: "false"-
Si se configura, no se permite la descarga de repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Usa este factor para escalar todos los tiempos de espera en las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que sean más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación en caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una string vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que afectan la medida en la que Bazel aplica de manera estricta las 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 hashes del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan
--experimental_verify_repository_rules=<a string>
usos múltiples -
Si es una lista de reglas de repositorio para las que se debe verificar el hash del directorio de salida, siempre que un archivo se especifique mediante --experimental_repository_hash_file.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE.:
- El valor predeterminado de
--[no]experimental_allow_top_level_aspects_parameters
es "true" (verdadero). -
No-op
Etiquetas:no_op
,deprecated
,experimental
- Opciones relacionadas con la semántica y el resultado de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Especificaste las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirá en el gráfico de dependencias resueltas incluso si se declararon de forma privada en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones anteriores harán que la resolución falle. También puedes definir la versión transferida permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
- El valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
es "error" -
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son “error” para derivarlo a una falla de resolución, “off” para inhabilitar la verificación o “warning” para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas `bazel_dep` declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son “off” para inhabilitar la verificación, “warning” para imprimir una advertencia cuando se detecte una discrepancia o “error” para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
valor predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- El valor predeterminado de
--lockfile_mode=<off, update or error>
es "desactivado" -
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son “update” para usar el archivo de bloqueo y actualizarlo si hay cambios; “error” para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o “off” para no leerlo ni escribirlo en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y se recurrirá únicamente a los posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
valor predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán estadísticas para todos los mnemotécnicos.
- Valor predeterminado de
--help_verbosity=<long, medium or short>
: "media" -
Selecciona el nivel de verbosidad del comando de ayuda.
Etiquetas:affects_outputs
,terminal_output
--long
[-l
]-
Muestra la descripción completa de cada opción, en lugar de solo el nombre.
Se expande a:
--help_verbosity=long
Etiquetas:affects_outputs
,terminal_output
--short
-
Muestra solo los nombres de las opciones, no sus tipos o significados.
Se expande a:
--help_verbosity=short
Etiquetas:affects_outputs
,terminal_output
- Opciones que especifican o modifican una entrada genérica a un comando de Bazel que no pertenece a otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remoto:
- Configuración predeterminada de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo para configurar el cargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno con el que debe coincidir y otro para usar como URL sustitutiva, con referencias inversas que comienzan con "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL, y se mostrarán varias URL.
- Opciones varias, que no están categorizadas:
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
Opciones de información
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Más lugares donde buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
valor predeterminado: "false"-
Si se configura, la caché del repositorio vinculará el archivo de forma fija en caso de un acierto de caché, en lugar de copiar. Esto sirve para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
valor predeterminado: "false"-
Si es verdadero, usa una string derivada de las URLs de descargas del repositorio como canonical_id si no se especifica. Esto provoca que un cambio en las URLs genere una nueva descarga incluso si la caché contiene una descarga con el mismo hash. Se puede usar para verificar que los cambios en la URL no den como resultado que la caché oculte los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
valor predeterminado: "false"-
Si se configura, no se permite la descarga de repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Usa este factor para escalar todos los tiempos de espera en las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que sean más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación en caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una string vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que afectan la medida en la que Bazel aplica de manera estricta las 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 hashes del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan
--experimental_verify_repository_rules=<a string>
usos múltiples -
Si es una lista de reglas de repositorio para las que se debe verificar el hash del directorio de salida, siempre que un archivo se especifique mediante --experimental_repository_hash_file.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE.:
- El valor predeterminado de
--[no]experimental_allow_top_level_aspects_parameters
es "true" (verdadero). -
No-op
Etiquetas:no_op
,deprecated
,experimental
- Opciones relacionadas con la semántica y el resultado de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Especificaste las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirá en el gráfico de dependencias resueltas incluso si se declararon de forma privada en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones anteriores harán que la resolución falle. También puedes definir la versión transferida permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
- El valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
es "error" -
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son “error” para derivarlo a una falla de resolución, “off” para inhabilitar la verificación o “warning” para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas `bazel_dep` declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son “off” para inhabilitar la verificación, “warning” para imprimir una advertencia cuando se detecte una discrepancia o “error” para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
valor predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- El valor predeterminado de
--lockfile_mode=<off, update or error>
es "desactivado" -
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son “update” para usar el archivo de bloqueo y actualizarlo si hay cambios; “error” para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o “off” para no leerlo ni escribirlo en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y se recurrirá únicamente a los posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
valor predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán estadísticas para todos los mnemotécnicos.
--[no]show_make_env
valor predeterminado: "false"-
Incluye el entorno “Make” en el resultado.
Etiquetas:affects_outputs
,terminal_output
- Opciones que especifican o modifican una entrada genérica para un comando de Bazel que no se incluye en otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remoto:
- Configuración predeterminada de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo para configurar el cargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno con el que debe coincidir y otro para usar como URL sustitutiva, con referencias inversas que comienzan con "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL, y se mostrarán varias URL.
- Opciones varias, que no están categorizadas:
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
Opciones de licencia
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Más lugares donde buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
valor predeterminado: "false"-
Si se configura, la caché del repositorio vinculará el archivo de forma fija en caso de un acierto de caché, en lugar de copiar. Esto sirve para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
valor predeterminado: "false"-
Si es verdadero, usa una string derivada de las URLs de descargas del repositorio como canonical_id si no se especifica. Esto provoca que un cambio en las URLs genere una nueva descarga incluso si la caché contiene una descarga con el mismo hash. Se puede usar para verificar que los cambios en la URL no den como resultado que la caché oculte los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
valor predeterminado: "false"-
Si se configura, no se permite la descarga de repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Usa este factor para escalar todos los tiempos de espera en las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que sean más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación en caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una string vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que afectan la medida en la que Bazel aplica de manera estricta las 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 hashes del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan
--experimental_verify_repository_rules=<a string>
usos múltiples -
Si es una lista de reglas de repositorio para las que se debe verificar el hash del directorio de salida, siempre que un archivo se especifique mediante --experimental_repository_hash_file.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE.:
- El valor predeterminado de
--[no]experimental_allow_top_level_aspects_parameters
es "true" (verdadero). -
No-op
Etiquetas:no_op
,deprecated
,experimental
- Opciones relacionadas con la semántica y el resultado de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Especificaste las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirá en el gráfico de dependencias resueltas incluso si se declararon de forma privada en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones anteriores harán que la resolución falle. También puedes definir la versión transferida permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
- El valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
es "error" -
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son “error” para derivarlo a una falla de resolución, “off” para inhabilitar la verificación o “warning” para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas `bazel_dep` declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son “off” para inhabilitar la verificación, “warning” para imprimir una advertencia cuando se detecte una discrepancia o “error” para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
valor predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- El valor predeterminado de
--lockfile_mode=<off, update or error>
es "desactivado" -
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son “update” para usar el archivo de bloqueo y actualizarlo si hay cambios; “error” para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o “off” para no leerlo ni escribirlo en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y se recurrirá únicamente a los posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
valor predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán estadísticas para todos los mnemotécnicos.
- Opciones que especifican o alteran una entrada genérica a un comando de Bazel que no pertenece a otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remoto:
- Configuración predeterminada de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo para configurar el cargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno con el que debe coincidir y otro para usar como URL sustitutiva, con referencias inversas que comienzan con "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL, y se mostrarán varias URL.
- Opciones varias, que no están categorizadas:
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
Opciones de instalación desde dispositivos móviles
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Más lugares donde buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
valor predeterminado: "false"-
Si se configura, la caché del repositorio vinculará el archivo de forma fija en caso de un acierto de caché, en lugar de copiar. Esto sirve para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
valor predeterminado: "false"-
Si es verdadero, usa una string derivada de las URLs de descargas del repositorio como canonical_id si no se especifica. Esto provoca que un cambio en las URLs genere una nueva descarga incluso si la caché contiene una descarga con el mismo hash. Se puede usar para verificar que los cambios en la URL no den como resultado que la caché oculte los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
valor predeterminado: "false"-
Si se configura, no se permite la descarga de repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Usa este factor para escalar todos los tiempos de espera en las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que sean más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación en caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una string 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 la instalación para dispositivos móviles. "classic" ejecuta la versión actual de mobile-install. "skylark" usa la nueva versión de Starlark, que es compatible con android_test.
Etiquetas:loading_and_analysis
,execution
,incompatible_change
- Opciones que configuran la cadena de herramientas que se usa para ejecutar la acción:
--adb=<a string>
predeterminado: ""
Es el objeto binario de adb - que se usará para el comando "mobile-install". Si no se especifica, se usa el SDK de Android especificado por la opción de línea de comandos --android_sdk (o el SDK predeterminado si no se especifica --android_sdk).
Etiquetas:changes_inputs
- Opciones que controlan el resultado del comando:
--[no]incremental
valor predeterminado: "false"-
Indica si se debe realizar una instalación incremental. Si es verdadero, intenta evitar trabajos adicionales innecesarios. Para ello, lee el estado del dispositivo en el que se instalará el código y usa esa información para evitar trabajos innecesarios. Si es falso (la opción predeterminada), siempre realiza una instalación completa.
Etiquetas:loading_and_analysis
--[no]split_apks
valor predeterminado: "false"-
Determina si se deben usar APK divididos para instalar y actualizar la aplicación en el dispositivo. Solo funciona con dispositivos con Marshmallow o versiones posteriores
Etiquetas:loading_and_analysis
,affects_outputs
- Opciones que permiten al usuario configurar el resultado deseado y afectar su valor, en lugar de su existencia:
- Se acumulan
--adb_arg=<a string>
usos múltiples -
Argumentos adicionales para pasar a adb. Por lo general, se usa para designar un dispositivo en el que se instalará la app.
Etiquetas:action_command_lines
--debug_app
-
Indica si se debe esperar al depurador antes de iniciar la app.
Se expande a:
--start=DEBUG
Etiquetas:execution
--device=<a string>
predeterminado: ""-
Es el número de serie del dispositivo adb. Si no se especifica, se usará el primer dispositivo.
Etiquetas:action_command_lines
- Valor predeterminado de
--start=<no, cold, warm or debug>
: "NO" -
Cómo se debe iniciar la app después de instalarla. Configúralo como WARM para preservar y restablecer el estado de la app en las instalaciones incrementales.
Etiquetas:execution
--start_app
-
Determina si se debe iniciar la app después de instalarla.
Se expande a:
--start=COLD
Etiquetas:execution
- Opciones que afectan la medida en la que Bazel aplica de manera estricta las 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 hashes del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan
--experimental_verify_repository_rules=<a string>
usos múltiples -
Si es una lista de reglas de repositorio para las que se debe verificar el hash del directorio de salida, siempre que un archivo se especifique mediante --experimental_repository_hash_file.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE.:
- El valor predeterminado de
--[no]experimental_allow_top_level_aspects_parameters
es "true" (verdadero). -
No-op
Etiquetas:no_op
,deprecated
,experimental
- Opciones relacionadas con la semántica y el resultado de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Especificaste las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirá en el gráfico de dependencias resueltas incluso si se declararon de forma privada en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones anteriores harán que la resolución falle. También puedes definir la versión transferida permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
- El valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
es "error" -
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son “error” para derivarlo a una falla de resolución, “off” para inhabilitar la verificación o “warning” para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas `bazel_dep` declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son “off” para inhabilitar la verificación, “warning” para imprimir una advertencia cuando se detecte una discrepancia o “error” para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
valor predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- El valor predeterminado de
--lockfile_mode=<off, update or error>
es "desactivado" -
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son “update” para usar el archivo de bloqueo y actualizarlo si hay cambios; “error” para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o “off” para no leerlo ni escribirlo en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y se recurrirá únicamente a los posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
valor predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán estadísticas para todos los mnemotécnicos.
--incremental_install_verbosity=<a string>
predeterminado: ""-
La verbosidad para una instalación incremental. Configúralo en 1 para el registro de depuración.
Etiquetas:bazel_monitoring
- Opciones que especifican o modifican una entrada genérica a un comando de Bazel que no se incluye en otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remoto:
- Configuración predeterminada de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo para configurar el cargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno con el que debe coincidir y otro para usar como URL sustitutiva, con referencias inversas que comienzan con "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL, y se mostrarán varias URL.
- Opciones varias, que no están categorizadas:
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
Opciones de moderación
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Más lugares donde buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
valor predeterminado: "false"-
Si se configura, la caché del repositorio vinculará el archivo de forma fija en caso de un acierto de caché, en lugar de copiar. Esto sirve para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
valor predeterminado: "false"-
Si es verdadero, usa una string derivada de las URLs de descargas del repositorio como canonical_id si no se especifica. Esto provoca que un cambio en las URLs genere una nueva descarga incluso si la caché contiene una descarga con el mismo hash. Se puede usar para verificar que los cambios en la URL no den como resultado que la caché oculte los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
valor predeterminado: "false"-
Si se configura, no se permite la descarga de repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Usa este factor para escalar todos los tiempos de espera en las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que sean más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación en caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una string 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 el objetivo que falló y aquellos que dependen de él no se pueden analizar, otros requisitos previos de estos objetivos pueden serlo.
Etiquetas:eagerness_to_exit
- Valor predeterminado de
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "auto" -
Cantidad de subprocesos paralelos que se usarán en la fase de carga o análisis. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguido de una operación ([-|*]<float>), p. ej., “auto”, “HOST_CPUS*.5”. “auto” establece un valor predeterminado razonable según los recursos del host. Debe ser 1 como mínimo.
Etiquetas:bazel_internal_configuration
- Opciones que afectan la medida en la que Bazel aplica de manera estricta las 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 hashes del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan
--experimental_verify_repository_rules=<a string>
usos múltiples -
Si es una lista de reglas de repositorio para las que se debe verificar el hash del directorio de salida, siempre que un archivo se especifique mediante --experimental_repository_hash_file.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE.:
- El valor predeterminado de
--[no]experimental_allow_top_level_aspects_parameters
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,deprecated
,experimental
--[no]incompatible_config_setting_private_default_visibility
valor predeterminado: "false"-
Si es incompatible_enforce_config_setting_visibility=false, esta es una noop. De lo contrario, si la marca es falsa, cualquier config_setting sin un atributo de visibilidad explícito es //visibility:public. Si esta marca es verdadera, config_setting sigue la misma lógica de visibilidad que todas las demás reglas. Consulta https://github.com/bazelbuild/bazel/issues/12933.
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_enforce_config_setting_visibility
es "true" (verdadero). -
Si es verdadero, aplica restricciones de visibilidad config_setting. Si es falso, cada config_setting es visible para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones relacionadas con el resultado y la semántica del subcomando “mod”:
--base_module=<"<root>" for the root module; <module>@<version> for a specific version of a module; <module> for all versions of a module; @<name> for a repo with the given apparent name; or @@<name> for a repo with the given canonical name>
valor predeterminado: "<root>"-
Especifica un módulo relacionado con el que se interpretarán los repositorios de destino especificados.
Etiquetas:terminal_output
--charset=<utf8 or ascii>
predeterminado: "utf8"-
Elige el grupo de caracteres que se usará para el árbol. Solo afecta la salida de texto. Los valores válidos son “utf8” o “ascii”. El valor predeterminado es “utf8”.
Etiquetas:terminal_output
--[no]cycles
valor predeterminado: "false"-
Señala los ciclos de dependencia dentro del árbol que se muestra, que suelen ignorarse de forma predeterminada.
Etiquetas:terminal_output
--depth=<an integer>
valor predeterminado: "-1"-
Profundidad de visualización máxima del árbol de dependencias. Por ejemplo, una profundidad de 1 muestra las dependencias directas. Para las dependencias de árbol, path y all_paths, la configuración predeterminada es Integer.MAX_VALUE, mientras que para las dependencias y explica que, de forma predeterminada, es 1 (solo muestra las dependencias directas de la raíz además de las hojas de destino y sus elementos superiores).
Etiquetas:terminal_output
- Configuración predeterminada de
--extension_filter=<a comma-separated list of <extension>s>
: ver descripción -
Solo muestra los usos de estas extensiones de módulo y los repositorios que generaron si se configuraron sus respectivas marcas. Si se establece, el gráfico de resultados solo incluirá rutas de acceso que contengan módulos con las extensiones especificadas. Una lista vacía inhabilita el filtro y especifica de forma efectiva todas las extensiones posibles.
Etiquetas:terminal_output
- La configuración predeterminada de
--extension_info=<hidden, usages, repos or all>
es "oculta" -
Especifica cuántos detalles sobre los usos de extensiones se deben incluir en el resultado de la consulta. "Usos" solo mostrará los nombres de las extensiones, "repos" también incluirá los repositorios importados con use_repo, y "todos" también mostrará los otros repositorios generados por extensiones.
Etiquetas:terminal_output
--extension_usages=<a comma-separated list of <module>s>
predeterminado: ""-
Especifica los módulos cuyos usos de extensiones se mostrarán en la consulta show_extension.
Etiquetas:terminal_output
--from=<a comma-separated list of <module>s>
valor predeterminado: "<root>"-
Los módulos a partir de los cuales se mostrará la consulta del gráfico de dependencias. Revisa la descripción de cada consulta para conocer la semántica exacta. La configuración predeterminada es <root>.
Etiquetas:terminal_output
--[no]include_builtin
valor predeterminado: "false"-
Incluye módulos integrados en el gráfico de dependencia. Está inhabilitado de forma predeterminada porque es bastante ruidoso.
Etiquetas:terminal_output
--[no]include_unused
valor predeterminado: "false"-
Las consultas también considerarán y mostrarán los módulos sin usar, que no están presentes en el gráfico de resolución del módulo después de la selección (debido a las reglas de selección de versión mínima o anulación). Esto puede tener diferentes efectos para cada uno de los tipos de consulta, p.ej., incluir rutas nuevas en el comando all_paths o dependencias adicionales en el comando explain.
Etiquetas:terminal_output
--output=<text, json or graph>
predeterminado: "text"-
El formato en el que se deben imprimir los resultados de la consulta. Los valores permitidos para la consulta son los siguientes: texto, JSON, gráfico
Etiquetas:terminal_output
--[no]verbose
valor predeterminado: "false"-
Las consultas también mostrarán el motivo por el que los módulos se resolvieron en su versión actual (si se modificó). El valor predeterminado es verdadero solo para la consulta de explicación.
Etiquetas:terminal_output
- Opciones relacionadas con la semántica y el resultado de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Especificaste las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirá en el gráfico de dependencias resueltas incluso si se declararon de forma privada en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones anteriores harán que la resolución falle. También puedes definir la versión transferida permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
- El valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
es "error" -
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son “error” para derivarlo a una falla de resolución, “off” para inhabilitar la verificación o “warning” para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas `bazel_dep` declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son “off” para inhabilitar la verificación, “warning” para imprimir una advertencia cuando se detecte una discrepancia o “error” para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
valor predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- El valor predeterminado de
--lockfile_mode=<off, update or error>
es "desactivado" -
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son “update” para usar el archivo de bloqueo y actualizarlo si hay cambios; “error” para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o “off” para no leerlo ni escribirlo en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y se recurrirá únicamente a los posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
valor predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán estadísticas para todos los mnemotécnicos.
- Opciones que especifican o alteran una entrada genérica a un comando de Bazel que no pertenece a otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remoto:
- Configuración predeterminada de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo para configurar el cargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno con el que debe coincidir y otro para usar como URL sustitutiva, con referencias inversas que comienzan con "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL, y se mostrarán varias URL.
- Opciones varias, que no están categorizadas:
--deleted_packages=<comma-separated list of package names>
predeterminado: ""- Una lista separada por comas de los nombres de los paquetes que el sistema de compilación considerará que no existen, incluso si están visibles en algún lugar de la ruta del paquete. Usa esta opción cuando borres un subpaquete 'x/y' de un paquete 'x' existente. Por ejemplo, después de borrar x/y/BUILD en el cliente, el sistema de compilación puede presentar un reclamo si encuentra la etiqueta '//x:y/z' si todavía la proporciona otra entrada package_path. Si especificas --deleted_packages x/y se evita este problema.
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
--package_path=<colon-separated list of options>
predeterminado: "%workspace%"- Una lista separada por dos puntos sobre dónde buscar paquetes. Los elementos que comienzan con "%workspace%" son relativos al lugar de trabajo que lo contiene. Si se omite o está vacío, el valor predeterminado es el resultado de “bazel info default-package-path”.
- El valor predeterminado de
--[no]show_loading_progress
es "true" (verdadero). - Si se habilita, hace que Bazel imprima mensajes "Cargando paquete:".
Opciones de Print_action
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Más lugares donde buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
valor predeterminado: "false"-
Si se configura, la caché del repositorio vinculará el archivo de forma fija en caso de un acierto de caché, en lugar de copiar. Esto sirve para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
valor predeterminado: "false"-
Si es verdadero, usa una string derivada de las URLs de descargas del repositorio como canonical_id si no se especifica. Esto provoca que un cambio en las URLs genere una nueva descarga incluso si la caché contiene una descarga con el mismo hash. Se puede usar para verificar que los cambios en la URL no den como resultado que la caché oculte los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
valor predeterminado: "false"-
Si se configura, no se permite la descarga de repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Usa este factor para escalar todos los tiempos de espera en las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que sean más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación en caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una string vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que afectan la medida en la que Bazel aplica de manera estricta las 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 hashes del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan
--experimental_verify_repository_rules=<a string>
usos múltiples -
Si es una lista de reglas de repositorio para las que se debe verificar el hash del directorio de salida, siempre que un archivo se especifique mediante --experimental_repository_hash_file.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE.:
- El valor predeterminado de
--[no]experimental_allow_top_level_aspects_parameters
es "true" (verdadero). -
No-op
Etiquetas:no_op
,deprecated
,experimental
- Opciones relacionadas con la semántica y el resultado de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Especificaste las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirá en el gráfico de dependencias resueltas incluso si se declararon de forma privada en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones anteriores harán que la resolución falle. También puedes definir la versión transferida permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
- El valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
es "error" -
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son “error” para derivarlo a una falla de resolución, “off” para inhabilitar la verificación o “warning” para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas `bazel_dep` declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son “off” para inhabilitar la verificación, “warning” para imprimir una advertencia cuando se detecte una discrepancia o “error” para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
valor predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- El valor predeterminado de
--lockfile_mode=<off, update or error>
es "desactivado" -
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son “update” para usar el archivo de bloqueo y actualizarlo si hay cambios; “error” para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o “off” para no leerlo ni escribirlo en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y se recurrirá únicamente a los posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
valor predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán estadísticas para todos los mnemotécnicos.
- Opciones que especifican o alteran una entrada genérica a un comando de Bazel que no pertenece a otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remoto:
- Configuración predeterminada de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo para configurar el cargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno con el que debe coincidir y otro para usar como URL sustitutiva, con referencias inversas que comienzan con "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL, y se mostrarán varias URL.
- Opciones varias, que no están categorizadas:
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--print_action_mnemonics=<a string>
usos múltiples - Enumera los mnemotécnicos según los cuales se filtran los datos print_action. No se realizan filtros cuando se deja vacío.
Opciones de consulta
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Más lugares donde buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
valor predeterminado: "false"-
Si se configura, la caché del repositorio vinculará el archivo de forma fija en caso de un acierto de caché, en lugar de copiar. Esto sirve para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
valor predeterminado: "false"-
Si es verdadero, usa una string derivada de las URLs de descargas del repositorio como canonical_id si no se especifica. Esto provoca que un cambio en las URLs genere una nueva descarga incluso si la caché contiene una descarga con el mismo hash. Se puede usar para verificar que los cambios en la URL no den como resultado que la caché oculte los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
valor predeterminado: "false"-
Si se configura, no se permite la descarga de repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Usa este factor para escalar todos los tiempos de espera en las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que sean más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación en caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una string vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de la compilación:
- El valor predeterminado de
--[no]incompatible_remote_dangling_symlinks
es "true" (verdadero). -
Si se configura como verdadero y --incompatible_remote_symlinks también es verdadero, los symlinks en las salidas de acción pueden colgarse.
Etiquetas:execution
,incompatible_change
- El valor predeterminado de
--[no]incompatible_remote_symlinks
es "true" (verdadero). -
Si se configura como verdadera, Bazel representará symlinks en los resultados de acción en el protocolo de ejecución/almacenamiento en caché remoto como tal. De lo contrario, se seguirán los symlinks y se representarán como archivos o directorios. Consulta #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 el objetivo que falló y aquellos que dependen de él no se pueden analizar, otros requisitos previos de estos objetivos pueden serlo.
Etiquetas:eagerness_to_exit
- Valor predeterminado de
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "auto" -
Cantidad de subprocesos paralelos que se usarán en la fase de carga o análisis. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguido de una operación ([-|*]<float>), p. ej., “auto”, “HOST_CPUS*.5”. “auto” establece un valor predeterminado razonable según los recursos del host. Debe ser 1 como mínimo.
Etiquetas:bazel_internal_configuration
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
--bep_maximum_open_remote_upload_files=<an integer>
valor predeterminado: "-1"-
Cantidad máxima de archivos abiertos permitida durante la carga del artefacto BEP.
Etiquetas:affects_outputs
--remote_download_minimal
-
No descarga ningún resultado de compilación remota en la máquina local. Esta marca es un acceso directo 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
- La configuración predeterminada de
--remote_download_outputs=<all, minimal or toplevel>
es "todos" -
Si se configura como “mínima”, no se descarga ningún resultado de compilación remota en la máquina local, excepto los que requieren las acciones locales. Si se configura en “toplevel”, se comporta como “minimal”, excepto que también descarga los resultados de los destinos de nivel superior en la máquina local. Ambas opciones pueden reducir significativamente los tiempos de compilación si el ancho de banda de la red representa un cuello de botella.
Etiquetas:affects_outputs
--remote_download_symlink_template=<a string>
predeterminado: ""-
En lugar de descargar resultados de compilación remotas en la máquina local, crea vínculos simbólicos. El destino de los vínculos simbólicos puede especificarse con la forma de una cadena de plantilla. Esta string de plantilla puede contener {hash} y {size_bytes} que se expanden al hash del objeto y el tamaño en bytes, respectivamente. Estos vínculos simbólicos pueden apuntar, por ejemplo, a un sistema de archivos FUSE que cargue objetos de CAS a pedido.
Etiquetas:affects_outputs
--remote_download_toplevel
- Solo descarga las salidas remotas de los destinos de nivel superior en la máquina local. Esta marca es un acceso directo 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 el grado de rigurosidad de Bazel de las 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 hashes del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan
--experimental_verify_repository_rules=<a string>
usos múltiples -
Si es una lista de reglas de repositorio para las que se debe verificar el hash del directorio de salida, siempre que un archivo se especifique mediante --experimental_repository_hash_file.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE.:
- El valor predeterminado de
--[no]experimental_allow_top_level_aspects_parameters
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,deprecated
,experimental
--[no]incompatible_config_setting_private_default_visibility
valor predeterminado: "false"-
Si es incompatible_enforce_config_setting_visibility=false, esta es una noop. De lo contrario, si la marca es falsa, cualquier config_setting sin un atributo de visibilidad explícito es //visibility:public. Si esta marca es verdadera, config_setting sigue la misma lógica de visibilidad que todas las demás reglas. Consulta https://github.com/bazelbuild/bazel/issues/12933.
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_enforce_config_setting_visibility
es "true" (verdadero). -
Si es verdadero, aplica restricciones de visibilidad config_setting. Si es falso, cada config_setting es visible para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones relacionadas con el resultado y la semántica de la consulta:
- El valor predeterminado de
--aspect_deps=<off, conservative or precise>
es "conservador". -
Cómo resolver dependencias de aspecto cuando el formato de salida es {xml,proto,record}. “desactivado” significa que no se resuelven las dependencias de aspecto, “conservadora” (el valor predeterminado) significa que se agregan todas las dependencias de aspecto declaradas sin importar si se les otorga la clase de regla de las dependencias directas. “preciso” significa que solo se agregan esos aspectos que posiblemente estén activos dada la clase de regla de las dependencias directas. Ten en cuenta que el modo preciso requiere cargar otros paquetes para evaluar un solo objetivo, por lo que es más lento que los otros modos. Además, ten en cuenta que incluso el modo preciso no es del todo preciso: la decisión de calcular un aspecto se decide en la fase de análisis, que no se ejecuta durante la “consulta de Bazel”.
Etiquetas:build_file_semantics
--[no]consistent_labels
valor predeterminado: "false"-
Si se habilita, cada comando de consulta emite etiquetas como si lo hiciera la función <code>str</code> de Starlark aplicada a una instancia de <code>etiqueta</code>. Esto es útil para las herramientas que necesitan hacer coincidir el resultado de diferentes comandos de consulta o etiquetas emitidas por reglas. Si no están habilitados, los formateadores de salida tienen la libertad de emitir nombres de repositorio aparentes (en relación con el repositorio principal) para que los resultados sean más legibles.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]experimental_graphless_query
: "auto" -
Si es verdadero, usa una implementación de consulta que no crea una copia del gráfico. La nueva implementación solo admite --order_output=no, y también un subconjunto de formateadores de salida.
Etiquetas:build_file_semantics
,eagerness_to_exit
--graph:conditional_edges_limit=<an integer>
predeterminado: "4"-
La cantidad máxima de etiquetas de condición que se mostrarán. -1 significa que no hay truncamiento y 0 significa que no hay ninguna anotación. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]graph:factored
es "true" (verdadero). -
Si es "true", el gráfico se emitirá "factorizado", es decir, los nodos equivalentes topológicamente se combinarán y sus etiquetas se concatenarán. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--graph:node_limit=<an integer>
predeterminado: "512"-
La longitud máxima de la string de etiqueta para un nodo del gráfico en el resultado. Las etiquetas más largas se truncarán; -1 significa que no hay truncamiento. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]implicit_deps
es "true" (verdadero). -
Si se habilita, las dependencias implícitas se incluirán en el gráfico de dependencias en el que opera la consulta. Una dependencia implícita es aquella que no se especifica de forma explícita en el archivo BUILD, sino que Bazel la agrega. En el caso de cquery, esta opción controla el filtrado de cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
- El valor predeterminado de
--[no]include_aspects
es "true" (verdadero). -
aquery, cquery: si se deben incluir acciones generadas por el aspecto en el resultado. query: no-op (siempre se siguen los aspectos).
Etiquetas:terminal_output
- El valor predeterminado de
--[no]incompatible_display_source_file_location
es "true" (verdadero). -
De forma predeterminada, 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 fines de migración.
Etiquetas:terminal_output
,incompatible_change
- El valor predeterminado de
--[no]incompatible_lexicographical_output
es "true" (verdadero). -
Si se configura esta opción, ordena --order_output=auto salida en orden lexicográfico.
Etiquetas:terminal_output
,incompatible_change
- El valor predeterminado de
--[no]incompatible_package_group_includes_double_slash
es "true" (verdadero). -
Si se habilita, cuando se genere el atributo `packages` de package_group, no se omitirá el signo `//` inicial.
Etiquetas:terminal_output
,incompatible_change
--[no]infer_universe_scope
valor predeterminado: "false"-
Si se configura y --universe_scope no se establece, se inferirá un valor de --universe_scope como la lista de patrones de objetivo únicos en la expresión de consulta. Ten en cuenta que el valor de --universe_scope que se infiere para una expresión de consulta que utiliza funciones con alcance universal (p.ej., `allrdeps`) puede no ser lo que quieres, por lo que solo debes usar esta opción si sabes lo que estás haciendo. Consulta https://bazel.build/reference/query#sky-query para obtener detalles y ejemplos. Si se configura --universe_scope, se ignora el valor de esta opción. Nota: Esta opción solo se aplica a “consulta” (es decir, no a “cquery”).
Etiquetas:loading_and_analysis
--[no]line_terminator_null
valor predeterminado: "false"-
Indica si cada formato termina con \0 en lugar de una línea nueva.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]nodep_deps
es "true" (verdadero). -
Si se habilita, las dependencias de los atributos “nodep” se incluirán en el gráfico de dependencias en el que opera la consulta. Un ejemplo común de un atributo “nodep” es la “visibilidad”. Ejecuta y analiza el resultado de `info build-language` para conocer todos los atributos “nodep” en el lenguaje de compilación.
Etiquetas:build_file_semantics
--noorder_results
-
Muestra los resultados en orden de dependencia (predeterminado) o desordenado. El resultado desordenado es más rápido, pero solo se admite cuando --output no es el rango mínimo, el rango máximo ni el gráfico.
Se expande a:
--order_output=no
Etiquetas:terminal_output
--null
-
Indica si cada formato termina con \0 en lugar de una línea nueva.
Se expande a:
--line_terminator_null=true
Etiquetas:terminal_output
- Valor predeterminado de
--order_output=<no, deps, auto or full>
: "auto" -
Muestra los resultados sin orden (no), ordenados por dependencia (dependencias) o completamente ordenados (completo). El valor predeterminado es 'auto', lo que significa que los resultados se muestran en orden de dependencia o completamente ordenados, según el formateador de salida (dependencia ordenada para proto, minrank, maxrank y grafo, completamente ordenado para todos los demás). Cuando la salida está completamente ordenada, los nodos se imprimen en un orden totalmente determinista (total). Primero, todos los nodos se ordenan alfabéticamente. Luego, cada nodo de la lista se utiliza como el inicio de una búsqueda de profundidad primero posterior al orden, en la que las aristas salientes a los nodos no visitados se recorren en orden alfabético de los nodos sucesores. Por último, los nodos se imprimen en orden inverso al orden en que se visitaron.
Etiquetas:terminal_output
--order_results
-
Muestra los resultados en orden de dependencia (predeterminado) o desordenado. El resultado desordenado es más rápido, pero solo se admite cuando --output no es el rango mínimo, el rango máximo ni el gráfico.
Se expande a:
--order_output=auto
Etiquetas:terminal_output
--output=<a string>
, valor predeterminado: “label”-
El formato en el que se deben imprimir los resultados de la consulta. Los valores permitidos para la consulta son los siguientes: build, chart, stream_jsonproto, label, label_kind, location, maxrank, minrank, package, proto y xml.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]proto:default_values
es "true" (verdadero). -
Si el valor es "true", se incluyen los atributos cuyo valor no se especifica de forma explícita en el archivo BUILD. De lo contrario, se omiten. Esta opción se aplica a --output=proto
Etiquetas:terminal_output
--[no]proto:definition_stack
valor predeterminado: "false"-
Propaga el campo proto define_stack que registra, para cada instancia de regla, la pila de llamadas de Starlark en el momento en que se definió la clase de la regla.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]proto:flatten_selects
es "true" (verdadero). -
Si se habilita, se compactan los atributos configurables creados por select(). Para los tipos de lista, la representación plana es una lista que contiene cada valor del mapa de selección exactamente una vez. Los tipos escalares se acoplan a nulos.
Etiquetas:build_file_semantics
--[no]proto:include_synthetic_attribute_hash
valor predeterminado: "false"-
Indica si se debe calcular y propagar el atributo $internal_attr_hash o no.
Etiquetas:terminal_output
--[no]proto:instantiation_stack
valor predeterminado: "false"-
Propaga la pila de llamadas de creación de instancias de cada regla. Ten en cuenta que esto requiere que la pila esté presente
Etiquetas:terminal_output
- El valor predeterminado de
--[no]proto:locations
es "true" (verdadero). - Indica si se debe generar información de ubicación en el resultado de proto.
Etiquetas:terminal_output
- La configuración predeterminada de
--proto:output_rule_attrs=<comma-separated list of options>
es "todos" -
Lista de atributos separados por comas para incluir en el resultado. La configuración predeterminada es todos los atributos. Se establece como una cadena vacía para no generar ningún atributo. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]proto:rule_inputs_and_outputs
es "true" (verdadero). -
Indica si se deben propagar los campos rule_input y rule_output o no.
Etiquetas:terminal_output
--query_file=<a string>
predeterminado: ""-
Si se configura, la consulta leerá la consulta desde el archivo que se menciona aquí, en lugar de hacerlo desde la línea de comandos. Es un error especificar un archivo aquí, así como una consulta de línea de comandos.
Etiquetas:changes_inputs
--[no]relative_locations
valor predeterminado: "false"-
Si es "true", la ubicación de los archivos BUILD en los resultados xml y proto será relativa. De forma predeterminada, el resultado de la ubicación es una ruta de acceso absoluta y no será coherente en todas las máquinas. Puedes configurar esta opción como verdadera para obtener un resultado coherente en todas las máquinas.
Etiquetas:terminal_output
--[no]strict_test_suite
valor predeterminado: "false"-
Si es verdadero, la expresión tests() muestra un error si encuentra un paquete test_suite que contiene objetivos que no son de prueba.
Etiquetas:build_file_semantics
,eagerness_to_exit
- El valor predeterminado de
--[no]tool_deps
es "true" (verdadero). -
Consulta: Si se inhabilita, las dependencias de los objetivos de “configuración del host” o “ejecución” no se incluirán en el gráfico de dependencias en el que opera la consulta. Un perímetro de dependencia de 'host configuration', como el de cualquier regla 'proto_library' al compilador de protocolos, generalmente apunta a una herramienta ejecutada durante la compilación en lugar de a una parte del mismo programa 'target'.
Cquery: Si se inhabilita, filtra todos los destinos configurados que cruzan un host o una transición de ejecución del objetivo de nivel superior que descubrió este objetivo configurado. Esto significa que si el objetivo de nivel superior está en la configuración de destino, solo se mostrarán los objetivos configurados también en esa configuración. Si el objetivo de nivel superior se encuentra en la configuración del host, solo se mostrarán los destinos configurados de host. Esta opción NO excluirá las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
--universe_scope=<comma-separated list of options>
predeterminado: ""-
Un conjunto de patrones de objetivo separados por comas (aditivos y sustractivos). La consulta se puede realizar en el universo definido por el cierre transitivo de los destinos especificados. Esta opción se usa para los comandos query y cquery.
Para cquery, la entrada a esta opción son los destinos en los que se compilan todas las respuestas, por lo que esta opción puede afectar las configuraciones y las transiciones. Si no se especifica esta opción, se supone que los destinos de nivel superior son los destinos analizados a partir de la expresión de consulta. Nota: En el caso de cquery, no especificar esta opción puede provocar que la compilación falle si los objetivos analizados a partir de la expresión de consulta no se pueden compilar con opciones de nivel superior.
Etiquetas:loading_and_analysis
--[no]xml:default_values
valor predeterminado: "false"-
Si el valor es "true", se imprimen los atributos de la regla cuyo valor no se especifica explícitamente en el archivo BUILD. De lo contrario, se omiten.
Etiquetas:terminal_output
- El valor predeterminado de
--[no]xml:line_numbers
es "true" (verdadero). -
Si es verdadero, el resultado en formato XML contiene números de línea. Si inhabilitas esta opción, es posible que las diferencias sean más fáciles de leer. Esta opción solo se aplica a --output=xml.
Etiquetas:terminal_output
- Opciones relacionadas con la semántica y el resultado de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Especificaste las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirá en el gráfico de dependencias resueltas incluso si se declararon de forma privada en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones anteriores harán que la resolución falle. También puedes definir la versión transferida permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
- El valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
es "error" -
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son “error” para derivarlo a una falla de resolución, “off” para inhabilitar la verificación o “warning” para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas `bazel_dep` declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son “off” para inhabilitar la verificación, “warning” para imprimir una advertencia cuando se detecte una discrepancia o “error” para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
valor predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- El valor predeterminado de
--lockfile_mode=<off, update or error>
es "desactivado" -
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son “update” para usar el archivo de bloqueo y actualizarlo si hay cambios; “error” para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o “off” para no leerlo ni escribirlo en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y se recurrirá únicamente a los posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
valor predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán estadísticas para todos los mnemotécnicos.
--experimental_repository_resolved_file=<a string>
predeterminado: ""-
Si no está vacío, escribe un valor de Starlark con la información resuelta de todas las reglas del repositorio de Starlark que se ejecutaron.
Etiquetas:affects_outputs
- Valor predeterminado de
--remote_print_execution_messages=<failure, success or all>
: “error” -
Elige cuándo imprimir mensajes de ejecución remota. Los valores válidos son “failure”, para imprimir solo en caso de errores, “success” para imprimir solo en casos exitosos y “all” para imprimir siempre.
Etiquetas:terminal_output
- Opciones que especifican o modifican una entrada genérica a un comando de Bazel que no se incluye en otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remoto:
- Configuración predeterminada de
--experimental_circuit_breaker_strategy=<failure>
: ver descripción -
Especifica la estrategia que usará el disyuntor. Las estrategias disponibles son el “fracaso”. Si el valor de la opción no es válido, no se establece el comportamiento de la opción.
Etiquetas:execution
- Configuración predeterminada de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo para configurar el cargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno con el que debe coincidir y otro para usar como URL sustitutiva, con referencias inversas que comienzan con "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL, y se mostrarán varias URL.
--[no]experimental_guard_against_concurrent_changes
valor predeterminado: "false"- Desactiva esta opción para inhabilitar la verificación de la hora de los archivos de entrada de una acción antes de subirla a una caché remota. Puede haber casos en los que el kernel de Linux retrasa la escritura de archivos, lo que podría causar falsos positivos.
- La configuración predeterminada de
--experimental_remote_build_event_upload=<all or minimal>
es "todos" - Si se configura como “all”, todas las salidas locales a las que hace referencia BEP se suben a la caché remota. Si se configura como “mínimo”, las salidas locales a las que hace referencia BEP no se suben a la caché remota, excepto los archivos que son importantes para los consumidores de BEP (p.ej., registros de prueba y perfil de sincronización). El esquema bytestream:// siempre se usa para el URI de los archivos, incluso si faltan de la caché remota. La configuración predeterminada es “all”.
--[no]experimental_remote_cache_async
valor predeterminado: "false"- Si es verdadero, la E/S de la caché remota se producirá en segundo plano, en lugar de tener lugar como parte de una generación.
--[no]experimental_remote_cache_compression
valor predeterminado: "false"- Si está habilitada, comprime o descomprime los BLOB de caché con zstd.
- Configuración predeterminada de
--experimental_remote_capture_corrupted_outputs=<a path>
: ver descripción - Una ruta de acceso a un directorio en el que se capturarán los resultados dañados.
--[no]experimental_remote_discard_merkle_trees
valor predeterminado: "false"- Si se configura como verdadera, descarta las copias en memoria del árbol Merkle de la raíz de entrada y las asignaciones de entradas asociadas durante las llamadas a GetActionResult() y Execute(). Esta acción reduce el uso de memoria de forma significativa, pero requiere que Bazel vuelva a calcularlas ante errores y reintentos de la caché remota.
- Configuración predeterminada de
--experimental_remote_downloader=<a string>
: ver descripción - Un URI de extremo de la API de Remote Asset, que se usará como proxy de descarga remoto. Los esquemas compatibles son grpc, grpcs (grpc con TLS habilitada) y Unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel se establecerá de forma predeterminada en grpcs. Consulta: https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto
--[no]experimental_remote_downloader_local_fallback
valor predeterminado: "false"- Indica si se debe recurrir al cargador local si falla el cargador remoto.
--[no]experimental_remote_execution_keepalive
valor predeterminado: "false"- Indica si se debe usar keepalive para llamadas de ejecución remota.
--experimental_remote_failure_rate_threshold=<an integer in 0-100 range>
predeterminado: "10"-
Establece la cantidad permitida de tasa de fallas en un porcentaje para un período específico después del cual se deja de llamar al ejecutor o la caché remotos. El valor predeterminado es 10. Establecerlo en 0 significa que no existen limitaciones.
Etiquetas:execution
- Valor predeterminado de
--experimental_remote_failure_window_interval=<An immutable length of time.>
: "60s" -
El intervalo en el que se calcula la tasa de fallas de las solicitudes remotas. En un valor negativo o cero, la duración de la falla se calcula la duración total de la ejecución.Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
Etiquetas:execution
--[no]experimental_remote_mark_tool_inputs
valor predeterminado: "false"- Si se configura como verdadera, Bazel marcará las entradas como entradas de herramientas para el ejecutor remoto. Se puede usar para implementar trabajadores persistentes remotos.
--[no]experimental_remote_merkle_tree_cache
valor predeterminado: "false"- Si se establece como verdadera, se memorizarán los cálculos del árbol de Merkle para mejorar la velocidad de comprobación de aciertos de la caché remota. La huella de pie en la memoria de la caché se controla con --experimental_remote_merkle_tree_cache_size.
--experimental_remote_merkle_tree_cache_size=<a long integer>
predeterminado: "1000"- La cantidad de árboles de Merkle que se deben memorizar para mejorar la velocidad de verificación de aciertos de la caché remota. Aunque la caché se reduce automáticamente según el manejo de las referencias de software por parte de Java, pueden producirse errores de memoria insuficiente si la configuración es demasiado alta. Si se establece en 0, el tamaño de la caché es ilimitado. El valor óptimo varía según el tamaño del proyecto. La configuración predeterminada es 1,000.
--[no]experimental_remote_require_cached
valor predeterminado: "false"- Si se configura como verdadera, exige que todas las acciones que se pueden ejecutar de forma remota se almacenen en caché o, de lo contrario, falle la compilación. Esto es útil para solucionar problemas de no determinismo, ya que permite verificar si las acciones que deben almacenarse en caché realmente se almacenan en caché sin inyectar resultados nuevos en la caché de forma falsa.
--[no]incompatible_remote_build_event_upload_respect_no_cache
valor predeterminado: "false"- Si se configura como verdadera, los resultados a los que hace referencia BEP no se subirán a la caché remota si la acción que se genera no se puede almacenar en caché de manera remota.
- El valor predeterminado de
--[no]incompatible_remote_downloader_send_all_headers
es "true" (verdadero). -
Indica si se deben enviar todos los valores de un encabezado con varios valores al cargador remoto en lugar de solo el primero.
Etiquetas:incompatible_change
--[no]incompatible_remote_output_paths_relative_to_input_root
valor predeterminado: "false"-
Si se configura como verdadera, las rutas de salida están relacionadas con la raíz de entrada en lugar del directorio de trabajo.
Etiquetas:incompatible_change
- El valor predeterminado de
--[no]incompatible_remote_results_ignore_disk
es "true" (verdadero). -
Si se configura como verdadera, --noremote_upload_local_results y --noremote_Accept_cached no se aplicarán a la caché de 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_supported_cached hará que Bazel busque resultados en la caché del disco, pero no en la caché remota.
las acciones no-remote-exec pueden acceder a la caché del disco.
Consulta #8216 para obtener más información.
Etiquetas:incompatible_change
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
valor predeterminado: "false"-
Si se configura como verdadera, Bazel usará el nuevo código de salida 39 en lugar del 34 si la caché remota expulsa los BLOB durante la compilación.
Etiquetas:incompatible_change
- El valor predeterminado de
--[no]remote_accept_cached
es "true" (verdadero). - Indica si se aceptan resultados de acciones almacenados en caché de forma remota.
- Configuración predeterminada de
--remote_bytestream_uri_prefix=<a string>
: ver descripción - El nombre de host y el nombre de la instancia que se usarán en los URI bytestream:// que se escriben en transmisiones de eventos de compilación. Esta opción se puede configurar cuando las compilaciones se realizan con un proxy, lo que hace que los valores de --remote_executor y --remote_instance_name ya no correspondan con el nombre canónico del servicio de ejecución remota. Si no se establece, el valor predeterminado será “${hostname}/${instance_name}”.
- Configuración predeterminada de
--remote_cache=<a string>
: ver descripción - Un URI de un extremo de almacenamiento en caché. Los esquemas admitidos son http, https, grpc, grpcs (grpc con TLS habilitada) y Unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel se establecerá de forma predeterminada en grpcs. Especifica el esquema grpc://, http:// o Unix: para inhabilitar TLS. Consulta https://bazel.build/remote/caching
- Se acumulan
--remote_cache_header=<a 'name=value' assignment>
usos múltiples - Especifica un encabezado que se incluirá en las solicitudes de caché: --remote_cache_header=Name=Value. Se pueden pasar varios encabezados si se especifica la marca varias veces. Si hay varios valores con el mismo nombre, se convertirán en una lista separada por comas.
- Se acumulan
--remote_default_exec_properties=<a 'name=value' assignment>
usos múltiples -
Configura las propiedades de ejecución predeterminadas que se usarán como plataforma de ejecución remota si una plataforma de ejecución aún no configuró exec_properties.
Etiquetas:affects_outputs
--remote_default_platform_properties=<a string>
predeterminado: ""- Establece las propiedades de plataforma predeterminadas para la API de ejecución remota si la plataforma de ejecución aún no configuró remote_execution_properties. Este valor también se usará si se selecciona la plataforma host como la plataforma de ejecución para la ejecución remota.
- Se acumulan
--remote_downloader_header=<a 'name=value' assignment>
usos múltiples - Especifica un encabezado que se incluirá en las solicitudes de cargadores remotos: --remote_downloader_header=Name=Value. Se pueden pasar varios encabezados si se especifica la marca varias veces. Si hay varios valores con el mismo nombre, se convertirán en una lista separada por comas.
- Se acumulan
--remote_exec_header=<a 'name=value' assignment>
usos múltiples - Especifica un encabezado que se incluirá en las solicitudes de ejecución: --remote_exec_header=Name=Value. Se pueden pasar varios encabezados si se especifica la marca varias veces. Si hay varios valores con el mismo nombre, se convertirán en una lista separada por comas.
--remote_execution_priority=<an integer>
predeterminado: "0"- La prioridad relativa de las acciones que se ejecutarán de forma remota. La semántica de los valores de prioridad particulares depende del servidor.
- Configuración predeterminada de
--remote_executor=<a string>
: ver descripción - HOST o HOST:PORT de un extremo de ejecución remota. Los esquemas compatibles son grpc, grpcs (grpc con TLS habilitada) y Unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel se establecerá de forma predeterminada en grpcs. Especifica grpc:// o Unix: esquema para inhabilitar TLS.
- Configuración predeterminada de
--remote_grpc_log=<a path>
: ver descripción - Si se especifica, es una ruta a un archivo para registrar los detalles relacionados con las llamadas de gRPC. Este registro consta de una secuencia de protobufs serializados com.google.Dev
- Se acumulan
--remote_header=<a 'name=value' assignment>
usos múltiples - Especifica un encabezado que se incluirá en las solicitudes: --remote_header=Name=Value. Se pueden pasar varios encabezados si se especifica la marca varias veces. Si hay varios valores con el mismo nombre, se convertirán en una lista separada por comas.
--remote_instance_name=<a string>
predeterminado: ""- Valor que se pasará como instance_name en la API de ejecución remota.
--[no]remote_local_fallback
valor predeterminado: "false"- Determina si se debe recurrir a la estrategia de ejecución local independiente si falla la ejecución remota.
- El valor predeterminado de
--remote_local_fallback_strategy=<a string>
es "local" - No-ops, obsoleto. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/7480.
--remote_max_connections=<an integer>
predeterminado: "100"-
Limita la cantidad máxima de conexiones simultáneas a la caché o al ejecutor remoto. De forma predeterminada, el valor es 100. Establecerlo en 0 significa que no existen limitaciones.
Para la caché remota HTTP, una conexión TCP podría manejar una solicitud a la vez, por lo que Bazel podría compensar hasta --remote_max_connections solicitudes simultáneas.
Para la caché o el ejecutor remoto de gRPC, por lo general, un canal de gRPC podría manejar más de 100 solicitudes simultáneas, por lo que Bazel podría hacer alrededor de `--remote_max_connections * 100` solicitudes simultáneas.
Etiquetas:host_machine_resource_optimizations
- Configuración predeterminada de
--remote_proxy=<a string>
: ver descripción - Conéctate a la caché remota a través de un proxy. Actualmente, esta marca solo se puede usar para configurar un socket de dominio Unix (unix:/path/to/socket).
--remote_result_cache_priority=<an integer>
predeterminado: "0"- La prioridad relativa de las acciones remotas que se almacenarán en la caché remota. La semántica de los valores de prioridad particulares depende del servidor.
--remote_retries=<an integer>
predeterminado: "5"- La cantidad máxima de intentos para reintentar un error transitorio. Si se establece en 0, se inhabilitan los reintentos.
- Valor predeterminado de
--remote_retry_max_delay=<An immutable length of time.>
: "5 s" - Es el retraso máximo de retirada entre intentos remotos. Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
- Valor predeterminado de
--remote_timeout=<An immutable length of time.>
: "60s" - La cantidad máxima de tiempo que se debe esperar para la ejecución remota y las llamadas a caché. Para la caché de REST, este es el tiempo de espera de conexión y lectura. Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
- El valor predeterminado de
--[no]remote_upload_local_results
es "true" (verdadero). - Indica si se deben subir los resultados de acciones ejecutadas de forma local a la caché remota si la caché remota lo admite y el usuario está autorizado para hacerlo.
- El valor predeterminado de
--[no]remote_verify_downloads
es "true" (verdadero). - Si se configura como verdadera, Bazel calculará la suma de hash de todas las descargas remotas y descartará los valores almacenados en caché de manera remota si no coinciden con el valor esperado.
- Opciones varias, que no están categorizadas:
- Se acumulan
--credential_helper=<Path to a credential helper. It may be absolute, relative to the PATH environment variable, or %workspace%-relative. The path be optionally prefixed by a scope followed by an '='. The scope is a domain name, optionally with a single leading '*' wildcard component. A helper applies to URIs matching its scope, with more specific scopes preferred. If a helper has no scope, it applies to every URI.>
usos múltiples - Configura un auxiliar de credenciales que se usará para recuperar credenciales de autorización de recuperación de repositorios, almacenamiento en caché y ejecución remotos, y el servicio de eventos de compilación. Las credenciales que proporciona un asistente tienen prioridad sobre las que suministran --google_default_credentials, --google_credentials, un archivo .netrc o el parámetro auth a inicio_cat. Se puede especificar varias veces para configurar varios asistentes. Para obtener más información, consulta https://github.com/bazelbuild/proposals/blob/main/designs/2022-06-07-bazel-credential-helpers.md.
--credential_helper_cache_duration=<An immutable length of time.>
predeterminado: "30m"- Es el tiempo durante el cual se almacenan en caché las credenciales que proporciona un auxiliar de credenciales. Si 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.
- Valor predeterminado de
--credential_helper_timeout=<An immutable length of time.>
: "10 s" - Configura el tiempo de espera para un auxiliar de credenciales. Los auxiliares de credenciales que no respondan dentro de este tiempo de espera fallarán la invocación.
--deleted_packages=<comma-separated list of package names>
predeterminado: ""- Una lista separada por comas de los nombres de los paquetes que el sistema de compilación considerará que no existen, incluso si están visibles en algún lugar de la ruta del paquete. Usa esta opción cuando borres un subpaquete 'x/y' de un paquete 'x' existente. Por ejemplo, después de borrar x/y/BUILD en el cliente, el sistema de compilación puede presentar un reclamo si encuentra la etiqueta '//x:y/z' si todavía la proporciona otra entrada package_path. Si especificas --deleted_packages x/y se evita este problema.
- Configuración predeterminada de
--disk_cache=<a path>
: ver descripción - Una ruta de acceso a un directorio en el que Bazel puede leer y escribir acciones y resultados de acciones. Si el directorio no existe, se creará.
- El valor predeterminado de
--google_auth_scopes=<comma-separated list of options>
es "https://www.googleapis.com/auth/cloud-platform" - Una lista separada por comas de los permisos de autenticación de Google Cloud.
- Configuración predeterminada de
--google_credentials=<a string>
: ver descripción - Especifica el archivo del que se obtendrán credenciales de autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más detalles.
--[no]google_default_credentials
valor predeterminado: "false"- Indica si se deben usar las “Credenciales predeterminadas de la aplicación de Google” para la autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más detalles. Están inhabilitados de forma predeterminada.
- Configuración predeterminada de
--grpc_keepalive_time=<An immutable length of time.>
: ver descripción - Configura pings de keep-alive para las conexiones de gRPC salientes. Si se establece, Bazel envía pings después de este período sin operaciones de lectura en la conexión, pero solo si hay al menos una llamada de gRPC pendiente. Los horarios se consideran de segundo nivel de detalle; es un error establecer un valor inferior a un segundo. De forma predeterminada, los pings de keep-alive están inhabilitados. Debes coordinar con el propietario del servicio antes de habilitar este parámetro de configuración. Por ejemplo, para establecer un valor de 30 segundos para esta marca, debe hacerse de esta manera: --grpc_keepalive_time=30s.
- Valor predeterminado de
--grpc_keepalive_timeout=<An immutable length of time.>
: "20 s" - Configura un tiempo de espera de keep-alive para las conexiones de gRPC salientes. Si los pings keep-alive están habilitados con --grpc_keepalive_time, Bazel agota el tiempo de espera de una conexión si no recibe una respuesta de ping después de este tiempo. Los horarios se consideran de segundo nivel de detalle; es un error establecer un valor inferior a un segundo. Si los pings de keep-alive están inhabilitados, se ignora esta configuración.
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
--package_path=<colon-separated list of options>
predeterminado: "%workspace%"- Una lista separada por dos puntos sobre dónde buscar paquetes. Los elementos que comienzan con "%workspace%" son relativos al lugar de trabajo que lo contiene. Si se omite o está vacío, el valor predeterminado es el resultado de “bazel info default-package-path”.
- El valor predeterminado de
--[no]show_loading_progress
es "true" (verdadero). - Si se habilita, hace que Bazel imprima mensajes "Cargando paquete:".
- Configuración predeterminada de
--tls_certificate=<a string>
: ver descripción - Especifica una ruta de acceso a un certificado TLS que sea confiable para firmar certificados de servidor.
- Configuración predeterminada de
--tls_client_certificate=<a string>
: ver descripción - Especifica el certificado de cliente TLS que se usará; también debes proporcionar una clave de cliente para habilitar la autenticación de cliente.
- Configuración predeterminada de
--tls_client_key=<a string>
: ver descripción - Especifica la clave de cliente TLS que se usará; también debes proporcionar un certificado de cliente para habilitar la autenticación de cliente.
Opciones de ejecución
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Más lugares donde buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
valor predeterminado: "false"-
Si se configura, la caché del repositorio vinculará el archivo de forma fija en caso de un acierto de caché, en lugar de copiar. Esto sirve para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
valor predeterminado: "false"-
Si es verdadero, usa una string derivada de las URLs de descargas del repositorio como canonical_id si no se especifica. Esto provoca que un cambio en las URLs genere una nueva descarga incluso si la caché contiene una descarga con el mismo hash. Se puede usar para verificar que los cambios en la URL no den como resultado que la caché oculte los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
valor predeterminado: "false"-
Si se configura, no se permite la descarga de repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Usa este factor para escalar todos los tiempos de espera en las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que sean más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación en caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una string 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:
- Configuración predeterminada de
--script_path=<a path>
: ver descripción -
Si se configura, escribe una secuencia de comandos de shell en el archivo determinado que invoque el destino. Si se configura esta opción, el destino no se ejecuta desde Bazel. Usa “bazel run --script_path=foo //foo && ./foo” para invocar el destino “//foo”. La diferencia de “bazel run //foo” es que el bloqueo de Bazel se libera y el ejecutable está conectado al stdin de la terminal.
Etiquetas:affects_outputs
,execution
- Opciones que afectan la medida en la que Bazel aplica de manera estricta entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
--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 hashes del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan
--experimental_verify_repository_rules=<a string>
usos múltiples -
Si es una lista de reglas de repositorio para las que se debe verificar el hash del directorio de salida, siempre que un archivo se especifique mediante --experimental_repository_hash_file.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE.:
- El valor predeterminado de
--[no]experimental_allow_top_level_aspects_parameters
es "true" (verdadero). -
No-op
Etiquetas:no_op
,deprecated
,experimental
- Opciones relacionadas con la semántica y el resultado de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Especificaste las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirá en el gráfico de dependencias resueltas incluso si se declararon de forma privada en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones anteriores harán que la resolución falle. También puedes definir la versión transferida permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
- El valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
es "error" -
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son “error” para derivarlo a una falla de resolución, “off” para inhabilitar la verificación o “warning” para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas `bazel_dep` declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son “off” para inhabilitar la verificación, “warning” para imprimir una advertencia cuando se detecte una discrepancia o “error” para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
valor predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- El valor predeterminado de
--lockfile_mode=<off, update or error>
es "desactivado" -
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son “update” para usar el archivo de bloqueo y actualizarlo si hay cambios; “error” para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o “off” para no leerlo ni escribirlo en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y se recurrirá únicamente a los posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
valor predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán estadísticas para todos los mnemotécnicos.
- Opciones que especifican o alteran una entrada genérica a un comando de Bazel que no pertenece a otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remoto:
- Configuración predeterminada de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo para configurar el cargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno con el que debe coincidir y otro para usar como URL sustitutiva, con referencias inversas que comienzan con "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL, y se mostrarán varias URL.
- Opciones varias, que no están categorizadas:
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
Opciones de apagado
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Más lugares donde buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
valor predeterminado: "false"-
Si se configura, la caché del repositorio vinculará el archivo de forma fija en caso de un acierto de caché, en lugar de copiar. Esto sirve para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
valor predeterminado: "false"-
Si es verdadero, usa una string derivada de las URLs de descargas del repositorio como canonical_id si no se especifica. Esto provoca que un cambio en las URLs genere una nueva descarga incluso si la caché contiene una descarga con el mismo hash. Se puede usar para verificar que los cambios en la URL no den como resultado que la caché oculte los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
valor predeterminado: "false"-
Si se configura, no se permite la descarga de repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Usa este factor para escalar todos los tiempos de espera en las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que sean más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación en caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una string 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 no es cero, el apagado solo apagará el servidor si la memoria total (en MB) que consume la JVM supera este valor.
Etiquetas:loses_incremental_state
,eagerness_to_exit
- Opciones que afectan la medida en la que Bazel aplica de manera estricta las 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 hashes del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan
--experimental_verify_repository_rules=<a string>
usos múltiples -
Si es una lista de reglas de repositorio para las que se debe verificar el hash del directorio de salida, siempre que un archivo se especifique mediante --experimental_repository_hash_file.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE.:
- El valor predeterminado de
--[no]experimental_allow_top_level_aspects_parameters
es "true" (verdadero). -
No-op
Etiquetas:no_op
,deprecated
,experimental
- Opciones relacionadas con la semántica y el resultado de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Especificaste las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirá en el gráfico de dependencias resueltas incluso si se declararon de forma privada en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones anteriores harán que la resolución falle. También puedes definir la versión transferida permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
- El valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
es "error" -
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son “error” para derivarlo a una falla de resolución, “off” para inhabilitar la verificación o “warning” para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas `bazel_dep` declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son “off” para inhabilitar la verificación, “warning” para imprimir una advertencia cuando se detecte una discrepancia o “error” para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
valor predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- El valor predeterminado de
--lockfile_mode=<off, update or error>
es "desactivado" -
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son “update” para usar el archivo de bloqueo y actualizarlo si hay cambios; “error” para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o “off” para no leerlo ni escribirlo en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y se recurrirá únicamente a los posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
valor predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán estadísticas para todos los mnemotécnicos.
- Opciones que especifican o alteran una entrada genérica a un comando de Bazel que no pertenece a otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remoto:
- Configuración predeterminada de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo para configurar el cargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno con el que debe coincidir y otro para usar como URL sustitutiva, con referencias inversas que comienzan con "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL, y se mostrarán varias URL.
- Opciones varias, que no están categorizadas:
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
Opciones de sincronización
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Más lugares donde buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
valor predeterminado: "false"-
Si se configura, la caché del repositorio vinculará el archivo de forma fija en caso de un acierto de caché, en lugar de copiar. Esto sirve para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
valor predeterminado: "false"-
Si es verdadero, usa una string derivada de las URLs de descargas del repositorio como canonical_id si no se especifica. Esto provoca que un cambio en las URLs genere una nueva descarga incluso si la caché contiene una descarga con el mismo hash. Se puede usar para verificar que los cambios en la URL no den como resultado que la caché oculte los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
valor predeterminado: "false"-
Si se configura, no se permite la descarga de repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Usa este factor para escalar todos los tiempos de espera en las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que sean más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación en caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una string vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de la compilación:
- El valor predeterminado de
--[no]configure
es "Falso". -
Solo sincroniza los repositorios marcados como "configurar" para fines de configuración del sistema.
Etiquetas:changes_inputs
- El valor predeterminado de
--[no]incompatible_remote_dangling_symlinks
es "true" (verdadero). -
Si se configura como verdadero y --incompatible_remote_symlinks también es verdadero, los symlinks en las salidas de acción pueden colgarse.
Etiquetas:execution
,incompatible_change
- El valor predeterminado de
--[no]incompatible_remote_symlinks
es "true" (verdadero). -
Si se configura como verdadera, Bazel representará symlinks en los resultados de acción en el protocolo de ejecución/almacenamiento en caché remoto como tal. De lo contrario, se seguirán los symlinks y se representarán como archivos o directorios. Consulta #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 el objetivo que falló y aquellos que dependen de él no se pueden analizar, otros requisitos previos de estos objetivos pueden serlo.
Etiquetas:eagerness_to_exit
- Valor predeterminado de
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "auto" -
Cantidad de subprocesos paralelos que se usarán en la fase de carga o análisis. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguido de una operación ([-|*]<float>), p. ej., “auto”, “HOST_CPUS*.5”. “auto” establece un valor predeterminado razonable según los recursos del host. Debe ser 1 como mínimo.
Etiquetas:bazel_internal_configuration
- Se acumulan
--only=<a string>
usos múltiples -
Si se te brinda esta opción, solo sincroniza los repositorios especificados con esta opción. Considera que todos los parámetros de configuración de --configure (o todos ellos) están desactualizados.
Etiquetas:changes_inputs
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
--bep_maximum_open_remote_upload_files=<an integer>
valor predeterminado: "-1"-
Cantidad máxima de archivos abiertos permitida durante la carga del artefacto BEP.
Etiquetas:affects_outputs
--remote_download_minimal
-
No descarga ningún resultado de compilación remota en la máquina local. Esta marca es un acceso directo 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
- La configuración predeterminada de
--remote_download_outputs=<all, minimal or toplevel>
es "todos" -
Si se configura como “mínima”, no se descarga ningún resultado de compilación remota en la máquina local, excepto los que requieren las acciones locales. Si se configura en “toplevel”, se comporta como “minimal”, excepto que también descarga los resultados de los destinos de nivel superior en la máquina local. Ambas opciones pueden reducir significativamente los tiempos de compilación si el ancho de banda de la red representa un cuello de botella.
Etiquetas:affects_outputs
--remote_download_symlink_template=<a string>
predeterminado: ""-
En lugar de descargar resultados de compilación remotas en la máquina local, crea vínculos simbólicos. El destino de los vínculos simbólicos puede especificarse con la forma de una cadena de plantilla. Esta string de plantilla puede contener {hash} y {size_bytes} que se expanden al hash del objeto y el tamaño en bytes, respectivamente. Estos vínculos simbólicos pueden apuntar, por ejemplo, a un sistema de archivos FUSE que cargue objetos de CAS a pedido.
Etiquetas:affects_outputs
--remote_download_toplevel
- Solo descarga las salidas remotas de los destinos de nivel superior en la máquina local. Esta marca es un acceso directo 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 el grado de rigurosidad de Bazel de las 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 hashes del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan
--experimental_verify_repository_rules=<a string>
usos múltiples -
Si es una lista de reglas de repositorio para las que se debe verificar el hash del directorio de salida, siempre que un archivo se especifique mediante --experimental_repository_hash_file.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE.:
- El valor predeterminado de
--[no]experimental_allow_top_level_aspects_parameters
es "true" (verdadero). -
No-ops
Etiquetas:no_op
,deprecated
,experimental
--[no]incompatible_config_setting_private_default_visibility
valor predeterminado: "false"-
Si es incompatible_enforce_config_setting_visibility=false, esta es una noop. De lo contrario, si la marca es falsa, cualquier config_setting sin un atributo de visibilidad explícito es //visibility:public. Si esta marca es verdadera, config_setting sigue la misma lógica de visibilidad que todas las demás reglas. Consulta https://github.com/bazelbuild/bazel/issues/12933.
Etiquetas:loading_and_analysis
,incompatible_change
- El valor predeterminado de
--[no]incompatible_enforce_config_setting_visibility
es "true" (verdadero). -
Si es verdadero, aplica restricciones de visibilidad config_setting. Si es falso, cada config_setting es visible para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones relacionadas con la semántica y el resultado de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Especificaste las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirá en el gráfico de dependencias resueltas incluso si se declararon de forma privada en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones anteriores harán que la resolución falle. También puedes definir la versión transferida permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
- El valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
es "error" -
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son “error” para derivarlo a una falla de resolución, “off” para inhabilitar la verificación o “warning” para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas `bazel_dep` declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son “off” para inhabilitar la verificación, “warning” para imprimir una advertencia cuando se detecte una discrepancia o “error” para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
valor predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- El valor predeterminado de
--lockfile_mode=<off, update or error>
es "desactivado" -
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son “update” para usar el archivo de bloqueo y actualizarlo si hay cambios; “error” para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o “off” para no leerlo ni escribirlo en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y se recurrirá únicamente a los posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
valor predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán estadísticas para todos los mnemotécnicos.
--experimental_repository_resolved_file=<a string>
predeterminado: ""-
Si no está vacío, escribe un valor de Starlark con la información resuelta de todas las reglas del repositorio de Starlark que se ejecutaron.
Etiquetas:affects_outputs
- Valor predeterminado de
--remote_print_execution_messages=<failure, success or all>
: “error” -
Elige cuándo imprimir mensajes de ejecución remota. Los valores válidos son “failure”, para imprimir solo en caso de errores, “success” para imprimir solo en casos exitosos y “all” para imprimir siempre.
Etiquetas:terminal_output
- Opciones que especifican o modifican una entrada genérica a un comando de Bazel que no se incluye en otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remoto:
- Configuración predeterminada de
--experimental_circuit_breaker_strategy=<failure>
: ver descripción -
Especifica la estrategia que usará el disyuntor. Las estrategias disponibles son el “fracaso”. Si el valor de la opción no es válido, no se establece el comportamiento de la opción.
Etiquetas:execution
- Configuración predeterminada de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo para configurar el cargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno con el que debe coincidir y otro para usar como URL sustitutiva, con referencias inversas que comienzan con "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL, y se mostrarán varias URL.
--[no]experimental_guard_against_concurrent_changes
valor predeterminado: "false"- Desactiva esta opción para inhabilitar la verificación de la hora de los archivos de entrada de una acción antes de subirla a una caché remota. Puede haber casos en los que el kernel de Linux retrasa la escritura de archivos, lo que podría causar falsos positivos.
- La configuración predeterminada de
--experimental_remote_build_event_upload=<all or minimal>
es "todos" - Si se configura como “all”, todas las salidas locales a las que hace referencia BEP se suben a la caché remota. Si se configura como “mínimo”, las salidas locales a las que hace referencia BEP no se suben a la caché remota, excepto los archivos que son importantes para los consumidores de BEP (p.ej., registros de prueba y perfil de sincronización). El esquema bytestream:// siempre se usa para el URI de los archivos, incluso si faltan de la caché remota. La configuración predeterminada es “all”.
--[no]experimental_remote_cache_async
valor predeterminado: "false"- Si es verdadero, la E/S de la caché remota se producirá en segundo plano, en lugar de tener lugar como parte de una generación.
--[no]experimental_remote_cache_compression
valor predeterminado: "false"- Si está habilitada, comprime o descomprime los BLOB de caché con zstd.
- Configuración predeterminada de
--experimental_remote_capture_corrupted_outputs=<a path>
: ver descripción - Una ruta de acceso a un directorio en el que se capturarán los resultados dañados.
--[no]experimental_remote_discard_merkle_trees
valor predeterminado: "false"- Si se configura como verdadera, descarta las copias en memoria del árbol Merkle de la raíz de entrada y las asignaciones de entradas asociadas durante las llamadas a GetActionResult() y Execute(). Esta acción reduce el uso de memoria de forma significativa, pero requiere que Bazel vuelva a calcularlas ante errores y reintentos de la caché remota.
- Configuración predeterminada de
--experimental_remote_downloader=<a string>
: ver descripción - Un URI de extremo de la API de Remote Asset, que se usará como proxy de descarga remoto. Los esquemas compatibles son grpc, grpcs (grpc con TLS habilitada) y Unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel se establecerá de forma predeterminada en grpcs. Consulta: https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto
--[no]experimental_remote_downloader_local_fallback
valor predeterminado: "false"- Indica si se debe recurrir al cargador local si falla el cargador remoto.
--[no]experimental_remote_execution_keepalive
valor predeterminado: "false"- Indica si se debe usar keepalive para llamadas de ejecución remota.
--experimental_remote_failure_rate_threshold=<an integer in 0-100 range>
predeterminado: "10"-
Establece la cantidad permitida de tasa de fallas en un porcentaje para un período específico después del cual se deja de llamar al ejecutor o la caché remotos. El valor predeterminado es 10. Establecerlo en 0 significa que no existen limitaciones.
Etiquetas:execution
- Valor predeterminado de
--experimental_remote_failure_window_interval=<An immutable length of time.>
: "60s" -
El intervalo en el que se calcula la tasa de fallas de las solicitudes remotas. En un valor negativo o cero, la duración de la falla se calcula la duración total de la ejecución.Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
Etiquetas:execution
--[no]experimental_remote_mark_tool_inputs
valor predeterminado: "false"- Si se configura como verdadera, Bazel marcará las entradas como entradas de herramientas para el ejecutor remoto. Se puede usar para implementar trabajadores persistentes remotos.
--[no]experimental_remote_merkle_tree_cache
valor predeterminado: "false"- Si se establece como verdadera, se memorizarán los cálculos del árbol de Merkle para mejorar la velocidad de comprobación de aciertos de la caché remota. La huella de pie en la memoria de la caché se controla con --experimental_remote_merkle_tree_cache_size.
--experimental_remote_merkle_tree_cache_size=<a long integer>
predeterminado: "1000"- La cantidad de árboles de Merkle que se deben memorizar para mejorar la velocidad de verificación de aciertos de la caché remota. Aunque la caché se reduce automáticamente según el manejo de las referencias de software por parte de Java, pueden producirse errores de memoria insuficiente si la configuración es demasiado alta. Si se establece en 0, el tamaño de la caché es ilimitado. El valor óptimo varía según el tamaño del proyecto. La configuración predeterminada es 1,000.
--[no]experimental_remote_require_cached
valor predeterminado: "false"- Si se configura como verdadera, exige que todas las acciones que se pueden ejecutar de forma remota se almacenen en caché o, de lo contrario, falle la compilación. Esto es útil para solucionar problemas de no determinismo, ya que permite verificar si las acciones que deben almacenarse en caché realmente se almacenan en caché sin inyectar resultados nuevos en la caché de forma falsa.
--[no]incompatible_remote_build_event_upload_respect_no_cache
valor predeterminado: "false"- Si se configura como verdadera, los resultados a los que hace referencia BEP no se subirán a la caché remota si la acción que se genera no se puede almacenar en caché de manera remota.
- El valor predeterminado de
--[no]incompatible_remote_downloader_send_all_headers
es "true" (verdadero). -
Indica si se deben enviar todos los valores de un encabezado con varios valores al cargador remoto en lugar de solo el primero.
Etiquetas:incompatible_change
--[no]incompatible_remote_output_paths_relative_to_input_root
valor predeterminado: "false"-
Si se configura como verdadera, las rutas de salida están relacionadas con la raíz de entrada en lugar del directorio de trabajo.
Etiquetas:incompatible_change
- El valor predeterminado de
--[no]incompatible_remote_results_ignore_disk
es "true" (verdadero). -
Si se configura como verdadera, --noremote_upload_local_results y --noremote_Accept_cached no se aplicarán a la caché de 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_supported_cached hará que Bazel busque resultados en la caché del disco, pero no en la caché remota.
las acciones no-remote-exec pueden acceder a la caché del disco.
Consulta #8216 para obtener más información.
Etiquetas:incompatible_change
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
valor predeterminado: "false"-
Si se configura como verdadera, Bazel usará el nuevo código de salida 39 en lugar del 34 si la caché remota expulsa los BLOB durante la compilación.
Etiquetas:incompatible_change
- El valor predeterminado de
--[no]remote_accept_cached
es "true" (verdadero). - Indica si se aceptan resultados de acciones almacenados en caché de forma remota.
- Configuración predeterminada de
--remote_bytestream_uri_prefix=<a string>
: ver descripción - El nombre de host y el nombre de la instancia que se usarán en los URI bytestream:// que se escriben en transmisiones de eventos de compilación. Esta opción se puede configurar cuando las compilaciones se realizan con un proxy, lo que hace que los valores de --remote_executor y --remote_instance_name ya no correspondan con el nombre canónico del servicio de ejecución remota. Si no se establece, el valor predeterminado será “${hostname}/${instance_name}”.
- Configuración predeterminada de
--remote_cache=<a string>
: ver descripción - Un URI de un extremo de almacenamiento en caché. Los esquemas admitidos son http, https, grpc, grpcs (grpc con TLS habilitada) y Unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel se establecerá de forma predeterminada en grpcs. Especifica el esquema grpc://, http:// o Unix: para inhabilitar TLS. Consulta https://bazel.build/remote/caching
- Se acumulan
--remote_cache_header=<a 'name=value' assignment>
usos múltiples - Especifica un encabezado que se incluirá en las solicitudes de caché: --remote_cache_header=Name=Value. Se pueden pasar varios encabezados si se especifica la marca varias veces. Si hay varios valores con el mismo nombre, se convertirán en una lista separada por comas.
- Se acumulan
--remote_default_exec_properties=<a 'name=value' assignment>
usos múltiples -
Configura las propiedades de ejecución predeterminadas que se usarán como plataforma de ejecución remota si una plataforma de ejecución aún no configuró exec_properties.
Etiquetas:affects_outputs
--remote_default_platform_properties=<a string>
predeterminado: ""- Establece las propiedades de plataforma predeterminadas para la API de ejecución remota si la plataforma de ejecución aún no configuró remote_execution_properties. Este valor también se usará si se selecciona la plataforma host como la plataforma de ejecución para la ejecución remota.
- Se acumulan
--remote_downloader_header=<a 'name=value' assignment>
usos múltiples - Especifica un encabezado que se incluirá en las solicitudes de cargadores remotos: --remote_downloader_header=Name=Value. Se pueden pasar varios encabezados si se especifica la marca varias veces. Si hay varios valores con el mismo nombre, se convertirán en una lista separada por comas.
- Se acumulan
--remote_exec_header=<a 'name=value' assignment>
usos múltiples - Especifica un encabezado que se incluirá en las solicitudes de ejecución: --remote_exec_header=Name=Value. Se pueden pasar varios encabezados si se especifica la marca varias veces. Si hay varios valores con el mismo nombre, se convertirán en una lista separada por comas.
--remote_execution_priority=<an integer>
predeterminado: "0"- La prioridad relativa de las acciones que se ejecutarán de forma remota. La semántica de los valores de prioridad particulares depende del servidor.
- Configuración predeterminada de
--remote_executor=<a string>
: ver descripción - HOST o HOST:PORT de un extremo de ejecución remota. Los esquemas compatibles son grpc, grpcs (grpc con TLS habilitada) y Unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel se establecerá de forma predeterminada en grpcs. Especifica grpc:// o Unix: esquema para inhabilitar TLS.
- Configuración predeterminada de
--remote_grpc_log=<a path>
: ver descripción - Si se especifica, es una ruta a un archivo para registrar los detalles relacionados con las llamadas de gRPC. Este registro consta de una secuencia de protobufs serializados com.google.Dev
- Se acumulan
--remote_header=<a 'name=value' assignment>
usos múltiples - Especifica un encabezado que se incluirá en las solicitudes: --remote_header=Name=Value. Se pueden pasar varios encabezados si se especifica la marca varias veces. Si hay varios valores con el mismo nombre, se convertirán en una lista separada por comas.
--remote_instance_name=<a string>
predeterminado: ""- Valor que se pasará como instance_name en la API de ejecución remota.
--[no]remote_local_fallback
valor predeterminado: "false"- Determina si se debe recurrir a la estrategia de ejecución local independiente si falla la ejecución remota.
- El valor predeterminado de
--remote_local_fallback_strategy=<a string>
es "local" - No-ops, obsoleto. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/7480.
--remote_max_connections=<an integer>
predeterminado: "100"-
Limita la cantidad máxima de conexiones simultáneas a la caché o al ejecutor remoto. De forma predeterminada, el valor es 100. Establecerlo en 0 significa que no existen limitaciones.
Para la caché remota HTTP, una conexión TCP podría manejar una solicitud a la vez, por lo que Bazel podría compensar hasta --remote_max_connections solicitudes simultáneas.
Para la caché o el ejecutor remoto de gRPC, por lo general, un canal de gRPC podría manejar más de 100 solicitudes simultáneas, por lo que Bazel podría hacer alrededor de `--remote_max_connections * 100` solicitudes simultáneas.
Etiquetas:host_machine_resource_optimizations
- Configuración predeterminada de
--remote_proxy=<a string>
: ver descripción - Conéctate a la caché remota a través de un proxy. Actualmente, esta marca solo se puede usar para configurar un socket de dominio Unix (unix:/path/to/socket).
--remote_result_cache_priority=<an integer>
predeterminado: "0"- La prioridad relativa de las acciones remotas que se almacenarán en la caché remota. La semántica de los valores de prioridad particulares depende del servidor.
--remote_retries=<an integer>
predeterminado: "5"- La cantidad máxima de intentos para reintentar un error transitorio. Si se establece en 0, se inhabilitan los reintentos.
- Valor predeterminado de
--remote_retry_max_delay=<An immutable length of time.>
: "5 s" - Es el retraso máximo de retirada entre intentos remotos. Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
- Valor predeterminado de
--remote_timeout=<An immutable length of time.>
: "60s" - La cantidad máxima de tiempo que se debe esperar para la ejecución remota y las llamadas a caché. Para la caché de REST, este es el tiempo de espera de conexión y lectura. Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
- El valor predeterminado de
--[no]remote_upload_local_results
es "true" (verdadero). - Indica si se deben subir los resultados de acciones ejecutadas de forma local a la caché remota si la caché remota lo admite y el usuario está autorizado para hacerlo.
- El valor predeterminado de
--[no]remote_verify_downloads
es "true" (verdadero). - Si se configura como verdadera, Bazel calculará la suma de hash de todas las descargas remotas y descartará los valores almacenados en caché de manera remota si no coinciden con el valor esperado.
- Opciones varias, que no están categorizadas:
- Se acumulan
--credential_helper=<Path to a credential helper. It may be absolute, relative to the PATH environment variable, or %workspace%-relative. The path be optionally prefixed by a scope followed by an '='. The scope is a domain name, optionally with a single leading '*' wildcard component. A helper applies to URIs matching its scope, with more specific scopes preferred. If a helper has no scope, it applies to every URI.>
usos múltiples - Configura un auxiliar de credenciales que se usará para recuperar credenciales de autorización de recuperación de repositorios, almacenamiento en caché y ejecución remotos, y el servicio de eventos de compilación. Las credenciales que proporciona un asistente tienen prioridad sobre las que suministran --google_default_credentials, --google_credentials, un archivo .netrc o el parámetro auth a inicio_cat. Se puede especificar varias veces para configurar varios asistentes. Para obtener más información, consulta https://github.com/bazelbuild/proposals/blob/main/designs/2022-06-07-bazel-credential-helpers.md.
--credential_helper_cache_duration=<An immutable length of time.>
predeterminado: "30m"- Es el tiempo durante el cual se almacenan en caché las credenciales que proporciona un auxiliar de credenciales. Si 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.
- Valor predeterminado de
--credential_helper_timeout=<An immutable length of time.>
: "10 s" - Configura el tiempo de espera para un auxiliar de credenciales. Los auxiliares de credenciales que no respondan dentro de este tiempo de espera fallarán la invocación.
--deleted_packages=<comma-separated list of package names>
predeterminado: ""- Una lista separada por comas de los nombres de los paquetes que el sistema de compilación considerará que no existen, incluso si están visibles en algún lugar de la ruta del paquete. Usa esta opción cuando borres un subpaquete 'x/y' de un paquete 'x' existente. Por ejemplo, después de borrar x/y/BUILD en el cliente, el sistema de compilación puede presentar un reclamo si encuentra la etiqueta '//x:y/z' si todavía la proporciona otra entrada package_path. Si especificas --deleted_packages x/y se evita este problema.
- Configuración predeterminada de
--disk_cache=<a path>
: ver descripción - Una ruta de acceso a un directorio en el que Bazel puede leer y escribir acciones y resultados de acciones. Si el directorio no existe, se creará.
- El valor predeterminado de
--google_auth_scopes=<comma-separated list of options>
es "https://www.googleapis.com/auth/cloud-platform" - Una lista separada por comas de los permisos de autenticación de Google Cloud.
- Configuración predeterminada de
--google_credentials=<a string>
: ver descripción - Especifica el archivo del que se obtendrán credenciales de autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más detalles.
--[no]google_default_credentials
valor predeterminado: "false"- Indica si se deben usar las “Credenciales predeterminadas de la aplicación de Google” para la autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más detalles. Están inhabilitados de forma predeterminada.
- Configuración predeterminada de
--grpc_keepalive_time=<An immutable length of time.>
: ver descripción - Configura pings de keep-alive para las conexiones de gRPC salientes. Si se establece, Bazel envía pings después de este período sin operaciones de lectura en la conexión, pero solo si hay al menos una llamada de gRPC pendiente. Los horarios se consideran de segundo nivel de detalle; es un error establecer un valor inferior a un segundo. De forma predeterminada, los pings de keep-alive están inhabilitados. Debes coordinar con el propietario del servicio antes de habilitar este parámetro de configuración. Por ejemplo, para establecer un valor de 30 segundos para esta marca, debe hacerse de esta manera: --grpc_keepalive_time=30s.
- Valor predeterminado de
--grpc_keepalive_timeout=<An immutable length of time.>
: "20 s" - Configura un tiempo de espera de keep-alive para las conexiones de gRPC salientes. Si los pings keep-alive están habilitados con --grpc_keepalive_time, Bazel agota el tiempo de espera de una conexión si no recibe una respuesta de ping después de este tiempo. Los horarios se consideran de segundo nivel de detalle; es un error establecer un valor inferior a un segundo. Si los pings de keep-alive están inhabilitados, se ignora esta configuración.
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
--package_path=<colon-separated list of options>
predeterminado: "%workspace%"- Una lista separada por dos puntos sobre dónde buscar paquetes. Los elementos que comienzan con "%workspace%" son relativos al lugar de trabajo que lo contiene. Si se omite o está vacío, el valor predeterminado es el resultado de “bazel info default-package-path”.
- El valor predeterminado de
--[no]show_loading_progress
es "true" (verdadero). - Si se habilita, hace que Bazel imprima mensajes "Cargando paquete:".
- Configuración predeterminada de
--tls_certificate=<a string>
: ver descripción - Especifica una ruta de acceso a un certificado TLS que sea confiable para firmar certificados de servidor.
- Configuración predeterminada de
--tls_client_certificate=<a string>
: ver descripción - Especifica el certificado de cliente TLS que se usará; también debes proporcionar una clave de cliente para habilitar la autenticación de cliente.
- Configuración predeterminada de
--tls_client_key=<a string>
: ver descripción - Especifica la clave de cliente TLS que se usará; también debes proporcionar un certificado de cliente para habilitar la autenticación de cliente.
Opciones de pruebas
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Más lugares donde buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
valor predeterminado: "false"-
Si se configura, la caché del repositorio vinculará el archivo de forma fija en caso de un acierto de caché, en lugar de copiar. Esto sirve para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
valor predeterminado: "false"-
Si es verdadero, usa una string derivada de las URLs de descargas del repositorio como canonical_id si no se especifica. Esto provoca que un cambio en las URLs genere una nueva descarga incluso si la caché contiene una descarga con el mismo hash. Se puede usar para verificar que los cambios en la URL no den como resultado que la caché oculte los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
valor predeterminado: "false"-
Si se configura, no se permite la descarga de repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Usa este factor para escalar todos los tiempos de espera en las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que sean más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación en caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una string vacía como argumento solicita que se inhabilite la caché.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de la compilación:
- El valor predeterminado de
--[no]incompatible_remote_dangling_symlinks
es "true" (verdadero). -
Si se configura como verdadero y --incompatible_remote_symlinks también es verdadero, los symlinks en las salidas de acción pueden colgarse.
Etiquetas:execution
,incompatible_change
- El valor predeterminado de
--[no]incompatible_remote_symlinks
es "true" (verdadero). -
Si se configura como verdadera, Bazel representará symlinks en los resultados de acción en el protocolo de ejecución/almacenamiento en caché remoto como tal. De lo contrario, se seguirán los symlinks y se representarán como archivos o directorios. Consulta #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>
valor predeterminado: "-1"-
Cantidad máxima de archivos abiertos permitida durante la carga del artefacto BEP.
Etiquetas:affects_outputs
--remote_download_minimal
-
No descarga ningún resultado de compilación remota en la máquina local. Esta marca es un acceso directo 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
- La configuración predeterminada de
--remote_download_outputs=<all, minimal or toplevel>
es "todos" -
Si se configura como “mínima”, no se descarga ningún resultado de compilación remota en la máquina local, excepto los que requieren las acciones locales. Si se configura en “toplevel”, se comporta como “minimal”, excepto que también descarga los resultados de los destinos de nivel superior en la máquina local. Ambas opciones pueden reducir significativamente los tiempos de compilación si el ancho de banda de la red representa un cuello de botella.
Etiquetas:affects_outputs
--remote_download_symlink_template=<a string>
predeterminado: ""-
En lugar de descargar resultados de compilación remotas en la máquina local, crea vínculos simbólicos. El destino de los vínculos simbólicos puede especificarse con la forma de una cadena de plantilla. Esta string de plantilla puede contener {hash} y {size_bytes} que se expanden al hash del objeto y el tamaño en bytes, respectivamente. Estos vínculos simbólicos pueden apuntar, por ejemplo, a un sistema de archivos FUSE que cargue objetos de CAS a pedido.
Etiquetas:affects_outputs
--remote_download_toplevel
- Solo descarga las salidas remotas de los destinos de nivel superior en la máquina local. Esta marca es un acceso directo 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 el grado de rigurosidad de Bazel de las 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 hashes del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan
--experimental_verify_repository_rules=<a string>
usos múltiples -
Si es una lista de reglas de repositorio para las que se debe verificar el hash del directorio de salida, siempre que un archivo se especifique mediante --experimental_repository_hash_file.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE.:
- El valor predeterminado de
--[no]experimental_allow_top_level_aspects_parameters
es "true" (verdadero). -
No-op
Etiquetas:no_op
,deprecated
,experimental
- Opciones relacionadas con la semántica y el resultado de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Especificaste las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirá en el gráfico de dependencias resueltas incluso si se declararon de forma privada en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones anteriores harán que la resolución falle. También puedes definir la versión transferida permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
- El valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
es "error" -
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son “error” para derivarlo a una falla de resolución, “off” para inhabilitar la verificación o “warning” para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas `bazel_dep` declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son “off” para inhabilitar la verificación, “warning” para imprimir una advertencia cuando se detecte una discrepancia o “error” para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
valor predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- El valor predeterminado de
--lockfile_mode=<off, update or error>
es "desactivado" -
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son “update” para usar el archivo de bloqueo y actualizarlo si hay cambios; “error” para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o “off” para no leerlo ni escribirlo en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y se recurrirá únicamente a los posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
valor predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán estadísticas para todos los mnemotécnicos.
--[no]print_relative_test_log_paths
valor predeterminado: "false"-
Si es verdadero, cuando imprimas la ruta de acceso a un registro de pruebas, usa una ruta de acceso relativa que use el symlink de conveniencia “testlogs”. Nota importante: Una invocación de “build'/'test'/etc. con una configuración diferente puede hacer que cambie el destino de este symlink, lo que hace que la ruta de acceso impresa antes ya no sea útil.
Etiquetas:affects_outputs
- Valor predeterminado de
--remote_print_execution_messages=<failure, success or all>
: “error” -
Elige cuándo imprimir mensajes de ejecución remota. Los valores válidos son “failure”, para imprimir solo en caso de errores, “success” para imprimir solo en casos exitosos y “all” para imprimir siempre.
Etiquetas:terminal_output
--[no]test_verbose_timeout_warnings
valor predeterminado: "false"-
Si es "true", imprimir advertencias adicionales cuando el tiempo de ejecución de la prueba real no coincida con el tiempo de espera definido por la prueba (ya sea implícito o explícito).
Etiquetas:affects_outputs
- El valor predeterminado de
--[no]verbose_test_summary
es "true" (verdadero). -
Si es "true", imprime información adicional (tiempo, cantidad de ejecuciones con errores, etc.) en el resumen de la prueba.
Etiquetas:affects_outputs
- Opciones que especifican o modifican una entrada genérica a un comando de Bazel que no se incluye en otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remoto:
- Configuración predeterminada de
--experimental_circuit_breaker_strategy=<failure>
: ver descripción -
Especifica la estrategia que usará el disyuntor. Las estrategias disponibles son el “fracaso”. Si el valor de la opción no es válido, no se establece el comportamiento de la opción.
Etiquetas:execution
- Configuración predeterminada de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo para configurar el cargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno con el que debe coincidir y otro para usar como URL sustitutiva, con referencias inversas que comienzan con "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL, y se mostrarán varias URL.
--[no]experimental_guard_against_concurrent_changes
valor predeterminado: "false"- Desactiva esta opción para inhabilitar la verificación de la hora de los archivos de entrada de una acción antes de subirla a una caché remota. Puede haber casos en los que el kernel de Linux retrasa la escritura de archivos, lo que podría causar falsos positivos.
- La configuración predeterminada de
--experimental_remote_build_event_upload=<all or minimal>
es "todos" - Si se configura como “all”, todas las salidas locales a las que hace referencia BEP se suben a la caché remota. Si se configura como “mínimo”, las salidas locales a las que hace referencia BEP no se suben a la caché remota, excepto los archivos que son importantes para los consumidores de BEP (p.ej., registros de prueba y perfil de sincronización). El esquema bytestream:// siempre se usa para el URI de los archivos, incluso si faltan de la caché remota. La configuración predeterminada es “all”.
--[no]experimental_remote_cache_async
valor predeterminado: "false"- Si es verdadero, la E/S de la caché remota se producirá en segundo plano, en lugar de tener lugar como parte de una generación.
--[no]experimental_remote_cache_compression
valor predeterminado: "false"- Si está habilitada, comprime o descomprime los BLOB de caché con zstd.
- Configuración predeterminada de
--experimental_remote_capture_corrupted_outputs=<a path>
: ver descripción - Una ruta de acceso a un directorio en el que se capturarán los resultados dañados.
--[no]experimental_remote_discard_merkle_trees
valor predeterminado: "false"- Si se configura como verdadera, descarta las copias en memoria del árbol Merkle de la raíz de entrada y las asignaciones de entradas asociadas durante las llamadas a GetActionResult() y Execute(). Esta acción reduce el uso de memoria de forma significativa, pero requiere que Bazel vuelva a calcularlas ante errores y reintentos de la caché remota.
- Configuración predeterminada de
--experimental_remote_downloader=<a string>
: ver descripción - Un URI de extremo de la API de Remote Asset, que se usará como proxy de descarga remoto. Los esquemas compatibles son grpc, grpcs (grpc con TLS habilitada) y Unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel se establecerá de forma predeterminada en grpcs. Consulta: https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto
--[no]experimental_remote_downloader_local_fallback
valor predeterminado: "false"- Indica si se debe recurrir al cargador local si falla el cargador remoto.
--[no]experimental_remote_execution_keepalive
valor predeterminado: "false"- Indica si se debe usar keepalive para llamadas de ejecución remota.
--experimental_remote_failure_rate_threshold=<an integer in 0-100 range>
predeterminado: "10"-
Establece la cantidad permitida de tasa de fallas en un porcentaje para un período específico después del cual se deja de llamar al ejecutor o la caché remotos. El valor predeterminado es 10. Establecerlo en 0 significa que no existen limitaciones.
Etiquetas:execution
- Valor predeterminado de
--experimental_remote_failure_window_interval=<An immutable length of time.>
: "60s" -
El intervalo en el que se calcula la tasa de fallas de las solicitudes remotas. En un valor negativo o cero, la duración de la falla se calcula la duración total de la ejecución.Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
Etiquetas:execution
--[no]experimental_remote_mark_tool_inputs
valor predeterminado: "false"- Si se configura como verdadera, Bazel marcará las entradas como entradas de herramientas para el ejecutor remoto. Se puede usar para implementar trabajadores persistentes remotos.
--[no]experimental_remote_merkle_tree_cache
valor predeterminado: "false"- Si se establece como verdadera, se memorizarán los cálculos del árbol de Merkle para mejorar la velocidad de comprobación de aciertos de la caché remota. La huella de pie en la memoria de la caché se controla con --experimental_remote_merkle_tree_cache_size.
--experimental_remote_merkle_tree_cache_size=<a long integer>
predeterminado: "1000"- La cantidad de árboles de Merkle que se deben memorizar para mejorar la velocidad de verificación de aciertos de la caché remota. Aunque la caché se reduce automáticamente según el manejo de las referencias de software por parte de Java, pueden producirse errores de memoria insuficiente si la configuración es demasiado alta. Si se establece en 0, el tamaño de la caché es ilimitado. El valor óptimo varía según el tamaño del proyecto. La configuración predeterminada es 1,000.
--[no]experimental_remote_require_cached
valor predeterminado: "false"- Si se configura como verdadera, exige que todas las acciones que se pueden ejecutar de forma remota se almacenen en caché o, de lo contrario, falle la compilación. Esto es útil para solucionar problemas de no determinismo, ya que permite verificar si las acciones que deben almacenarse en caché realmente se almacenan en caché sin inyectar resultados nuevos en la caché de forma falsa.
--[no]incompatible_remote_build_event_upload_respect_no_cache
valor predeterminado: "false"- Si se configura como verdadera, los resultados a los que hace referencia BEP no se subirán a la caché remota si la acción que se genera no se puede almacenar en caché de manera remota.
- El valor predeterminado de
--[no]incompatible_remote_downloader_send_all_headers
es "true" (verdadero). -
Indica si se deben enviar todos los valores de un encabezado con varios valores al cargador remoto en lugar de solo el primero.
Etiquetas:incompatible_change
--[no]incompatible_remote_output_paths_relative_to_input_root
valor predeterminado: "false"-
Si se configura como verdadera, las rutas de salida están relacionadas con la raíz de entrada en lugar del directorio de trabajo.
Etiquetas:incompatible_change
- El valor predeterminado de
--[no]incompatible_remote_results_ignore_disk
es "true" (verdadero). -
Si se configura como verdadera, --noremote_upload_local_results y --noremote_Accept_cached no se aplicarán a la caché de 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_supported_cached hará que Bazel busque resultados en la caché del disco, pero no en la caché remota.
las acciones no-remote-exec pueden acceder a la caché del disco.
Consulta #8216 para obtener más información.
Etiquetas:incompatible_change
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
valor predeterminado: "false"-
Si se configura como verdadera, Bazel usará el nuevo código de salida 39 en lugar del 34 si la caché remota expulsa los BLOB durante la compilación.
Etiquetas:incompatible_change
- El valor predeterminado de
--[no]remote_accept_cached
es "true" (verdadero). - Indica si se aceptan resultados de acciones almacenados en caché de forma remota.
- Configuración predeterminada de
--remote_bytestream_uri_prefix=<a string>
: ver descripción - El nombre de host y el nombre de la instancia que se usarán en los URI bytestream:// que se escriben en transmisiones de eventos de compilación. Esta opción se puede configurar cuando las compilaciones se realizan con un proxy, lo que hace que los valores de --remote_executor y --remote_instance_name ya no correspondan con el nombre canónico del servicio de ejecución remota. Si no se establece, el valor predeterminado será “${hostname}/${instance_name}”.
- Configuración predeterminada de
--remote_cache=<a string>
: ver descripción - Un URI de un extremo de almacenamiento en caché. Los esquemas admitidos son http, https, grpc, grpcs (grpc con TLS habilitada) y Unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel se establecerá de forma predeterminada en grpcs. Especifica el esquema grpc://, http:// o Unix: para inhabilitar TLS. Consulta https://bazel.build/remote/caching
- Se acumulan
--remote_cache_header=<a 'name=value' assignment>
usos múltiples - Especifica un encabezado que se incluirá en las solicitudes de caché: --remote_cache_header=Name=Value. Se pueden pasar varios encabezados si se especifica la marca varias veces. Si hay varios valores con el mismo nombre, se convertirán en una lista separada por comas.
- Se acumulan
--remote_default_exec_properties=<a 'name=value' assignment>
usos múltiples -
Configura las propiedades de ejecución predeterminadas que se usarán como plataforma de ejecución remota si una plataforma de ejecución aún no configuró exec_properties.
Etiquetas:affects_outputs
--remote_default_platform_properties=<a string>
predeterminado: ""- Establece las propiedades de plataforma predeterminadas para la API de ejecución remota si la plataforma de ejecución aún no configuró remote_execution_properties. Este valor también se usará si se selecciona la plataforma host como la plataforma de ejecución para la ejecución remota.
- Se acumulan
--remote_downloader_header=<a 'name=value' assignment>
usos múltiples - Especifica un encabezado que se incluirá en las solicitudes de cargadores remotos: --remote_downloader_header=Name=Value. Se pueden pasar varios encabezados si se especifica la marca varias veces. Si hay varios valores con el mismo nombre, se convertirán en una lista separada por comas.
- Se acumulan
--remote_exec_header=<a 'name=value' assignment>
usos múltiples - Especifica un encabezado que se incluirá en las solicitudes de ejecución: --remote_exec_header=Name=Value. Se pueden pasar varios encabezados si se especifica la marca varias veces. Si hay varios valores con el mismo nombre, se convertirán en una lista separada por comas.
--remote_execution_priority=<an integer>
predeterminado: "0"- La prioridad relativa de las acciones que se ejecutarán de forma remota. La semántica de los valores de prioridad particulares depende del servidor.
- Configuración predeterminada de
--remote_executor=<a string>
: ver descripción - HOST o HOST:PORT de un extremo de ejecución remota. Los esquemas compatibles son grpc, grpcs (grpc con TLS habilitada) y Unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel se establecerá de forma predeterminada en grpcs. Especifica grpc:// o Unix: esquema para inhabilitar TLS.
- Configuración predeterminada de
--remote_grpc_log=<a path>
: ver descripción - Si se especifica, es una ruta a un archivo para registrar los detalles relacionados con las llamadas de gRPC. Este registro consta de una secuencia de protobufs serializados com.google.Dev
- Se acumulan
--remote_header=<a 'name=value' assignment>
usos múltiples - Especifica un encabezado que se incluirá en las solicitudes: --remote_header=Name=Value. Se pueden pasar varios encabezados si se especifica la marca varias veces. Si hay varios valores con el mismo nombre, se convertirán en una lista separada por comas.
--remote_instance_name=<a string>
predeterminado: ""- Valor que se pasará como instance_name en la API de ejecución remota.
--[no]remote_local_fallback
valor predeterminado: "false"- Determina si se debe recurrir a la estrategia de ejecución local independiente si falla la ejecución remota.
- El valor predeterminado de
--remote_local_fallback_strategy=<a string>
es "local" - No-ops, obsoleto. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/7480.
--remote_max_connections=<an integer>
predeterminado: "100"-
Limita la cantidad máxima de conexiones simultáneas a la caché o al ejecutor remoto. De forma predeterminada, el valor es 100. Establecerlo en 0 significa que no existen limitaciones.
Para la caché remota HTTP, una conexión TCP podría manejar una solicitud a la vez, por lo que Bazel podría compensar hasta --remote_max_connections solicitudes simultáneas.
Para la caché o el ejecutor remoto de gRPC, por lo general, un canal de gRPC podría manejar más de 100 solicitudes simultáneas, por lo que Bazel podría hacer alrededor de `--remote_max_connections * 100` solicitudes simultáneas.
Etiquetas:host_machine_resource_optimizations
- Configuración predeterminada de
--remote_proxy=<a string>
: ver descripción - Conéctate a la caché remota a través de un proxy. Actualmente, esta marca solo se puede usar para configurar un socket de dominio Unix (unix:/path/to/socket).
--remote_result_cache_priority=<an integer>
predeterminado: "0"- La prioridad relativa de las acciones remotas que se almacenarán en la caché remota. La semántica de los valores de prioridad particulares depende del servidor.
--remote_retries=<an integer>
predeterminado: "5"- La cantidad máxima de intentos para reintentar un error transitorio. Si se establece en 0, se inhabilitan los reintentos.
- Valor predeterminado de
--remote_retry_max_delay=<An immutable length of time.>
: "5 s" - Es el retraso máximo de retirada entre intentos remotos. Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
- Valor predeterminado de
--remote_timeout=<An immutable length of time.>
: "60s" - La cantidad máxima de tiempo que se debe esperar para la ejecución remota y las llamadas a caché. Para la caché de REST, este es el tiempo de espera de conexión y lectura. Se pueden usar las siguientes unidades: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
- El valor predeterminado de
--[no]remote_upload_local_results
es "true" (verdadero). - Indica si se deben subir los resultados de acciones ejecutadas de forma local a la caché remota si la caché remota lo admite y el usuario está autorizado para hacerlo.
- El valor predeterminado de
--[no]remote_verify_downloads
es "true" (verdadero). - Si se configura como verdadera, Bazel calculará la suma de hash de todas las descargas remotas y descartará los valores almacenados en caché de manera remota si no coinciden con el valor esperado.
- Opciones varias, que no están categorizadas:
- Se acumulan
--credential_helper=<Path to a credential helper. It may be absolute, relative to the PATH environment variable, or %workspace%-relative. The path be optionally prefixed by a scope followed by an '='. The scope is a domain name, optionally with a single leading '*' wildcard component. A helper applies to URIs matching its scope, with more specific scopes preferred. If a helper has no scope, it applies to every URI.>
usos múltiples - Configura un auxiliar de credenciales que se usará para recuperar credenciales de autorización de recuperación de repositorios, almacenamiento en caché y ejecución remotos, y el servicio de eventos de compilación. Las credenciales que proporciona un asistente tienen prioridad sobre las que suministran --google_default_credentials, --google_credentials, un archivo .netrc o el parámetro auth a inicio_cat. Se puede especificar varias veces para configurar varios asistentes. Para obtener más información, consulta https://github.com/bazelbuild/proposals/blob/main/designs/2022-06-07-bazel-credential-helpers.md.
--credential_helper_cache_duration=<An immutable length of time.>
predeterminado: "30m"- Es el tiempo durante el cual se almacenan en caché las credenciales que proporciona un auxiliar de credenciales. Si 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.
- Valor predeterminado de
--credential_helper_timeout=<An immutable length of time.>
: "10 s" - Configura el tiempo de espera para un auxiliar de credenciales. Los auxiliares de credenciales que no respondan dentro de este tiempo de espera fallarán la invocación.
- Configuración predeterminada de
--disk_cache=<a path>
: ver descripción - Una ruta de acceso a un directorio en el que Bazel puede leer y escribir acciones y resultados de acciones. Si el directorio no existe, se creará.
- El valor predeterminado de
--google_auth_scopes=<comma-separated list of options>
es "https://www.googleapis.com/auth/cloud-platform" - Una lista separada por comas de los permisos de autenticación de Google Cloud.
- Configuración predeterminada de
--google_credentials=<a string>
: ver descripción - Especifica el archivo del que se obtendrán credenciales de autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más detalles.
--[no]google_default_credentials
valor predeterminado: "false"- Indica si se deben usar las “Credenciales predeterminadas de la aplicación de Google” para la autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más detalles. Están inhabilitados de forma predeterminada.
- Configuración predeterminada de
--grpc_keepalive_time=<An immutable length of time.>
: ver descripción - Configura pings de keep-alive para las conexiones de gRPC salientes. Si se establece, Bazel envía pings después de este período sin operaciones de lectura en la conexión, pero solo si hay al menos una llamada de gRPC pendiente. Los horarios se consideran de segundo nivel de detalle; es un error establecer un valor inferior a un segundo. De forma predeterminada, los pings de keep-alive están inhabilitados. Debes coordinar con el propietario del servicio antes de habilitar este parámetro de configuración. Por ejemplo, para establecer un valor de 30 segundos para esta marca, debe hacerse de esta manera: --grpc_keepalive_time=30s.
- Valor predeterminado de
--grpc_keepalive_timeout=<An immutable length of time.>
: "20 s" - Configura un tiempo de espera de keep-alive para las conexiones de gRPC salientes. Si los pings keep-alive están habilitados con --grpc_keepalive_time, Bazel agota el tiempo de espera de una conexión si no recibe una respuesta de ping después de este tiempo. Los horarios se consideran de segundo nivel de detalle; es un error establecer un valor inferior a un segundo. Si los pings de keep-alive están inhabilitados, se ignora esta configuración.
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Configuración predeterminada de
--tls_certificate=<a string>
: ver descripción - Especifica una ruta de acceso a un certificado TLS que sea confiable para firmar certificados de servidor.
- Configuración predeterminada de
--tls_client_certificate=<a string>
: ver descripción - Especifica el certificado de cliente TLS que se usará; también debes proporcionar una clave de cliente para habilitar la autenticación de cliente.
- Configuración predeterminada de
--tls_client_key=<a string>
: ver descripción - Especifica la clave de cliente TLS que se usará; también debes proporcionar un certificado de cliente para habilitar la autenticación de cliente.
Opciones de versión
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Más lugares donde buscar archivos antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
valor predeterminado: "false"-
Si se configura, la caché del repositorio vinculará el archivo de forma fija en caso de un acierto de caché, en lugar de copiar. Esto sirve para ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
valor predeterminado: "false"-
Si es verdadero, usa una string derivada de las URLs de descargas del repositorio como canonical_id si no se especifica. Esto provoca que un cambio en las URLs genere una nueva descarga incluso si la caché contiene una descarga con el mismo hash. Se puede usar para verificar que los cambios en la URL no den como resultado que la caché oculte los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
valor predeterminado: "false"-
Si se configura, no se permite la descarga de repositorios externos.
Etiquetas:experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: "0"-
La cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, se inhabilitan los reintentos.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Usa este factor para escalar todos los tiempos de espera en las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que sean más lentas de lo que esperaba el autor de la regla, sin cambiar el código fuente.
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--repository_cache=<a path>
: ver descripción -
Especifica la ubicación en caché de los valores descargados que se obtuvieron durante la recuperación de repositorios externos. Una string 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
valor predeterminado: "false"-
Si se configura, escribe la versión en stdout usando las convenciones descritas en los estándares de GNU.
Etiquetas:affects_outputs
,execution
- Opciones que afectan la medida en la que Bazel aplica de manera estricta entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etcétera):
--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 hashes del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan
--experimental_verify_repository_rules=<a string>
usos múltiples -
Si es una lista de reglas de repositorio para las que se debe verificar el hash del directorio de salida, siempre que un archivo se especifique mediante --experimental_repository_hash_file.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE.:
- El valor predeterminado de
--[no]experimental_allow_top_level_aspects_parameters
es "true" (verdadero). -
No-op
Etiquetas:no_op
,deprecated
,experimental
- Opciones relacionadas con la semántica y el resultado de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Especificaste las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirá en el gráfico de dependencias resueltas incluso si se declararon de forma privada en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones anteriores harán que la resolución falle. También puedes definir la versión transferida permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puedes inhabilitar esta verificación con la palabra clave "all" (no se recomienda).
Etiquetas:loading_and_analysis
- El valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
es "error" -
Verifica la compatibilidad de la versión de Bazel de los módulos de Bazel. Los valores válidos son “error” para derivarlo a una falla de resolución, “off” para inhabilitar la verificación o “warning” para imprimir una advertencia cuando se detecte una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "advertencia"-
Verifica si las dependencias directas `bazel_dep` declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencias resuelto. Los valores válidos son “off” para inhabilitar la verificación, “warning” para imprimir una advertencia cuando se detecte una discrepancia o “error” para derivarla a una falla de resolución.
Etiquetas:loading_and_analysis
--[no]ignore_dev_dependency
valor predeterminado: "false"-
Si es verdadero, Bazel ignora `bazel_dep` y `use_extension` declarados como `dev_dependency` en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de desarrollo siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- El valor predeterminado de
--lockfile_mode=<off, update or error>
es "desactivado" -
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son “update” para usar el archivo de bloqueo y actualizarlo si hay cambios; “error” para usar el archivo de bloqueo, pero arrojar un error si no está actualizado, o “off” para no leerlo ni escribirlo en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local en el formato <nombre del módulo>=<ruta>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y se recurrirá únicamente a los posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--[no]experimental_record_metrics_for_all_mnemonics
valor predeterminado: "false"- De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si estableces esta opción, se escribirán estadísticas para todos los mnemotécnicos.
- Opciones que especifican o alteran una entrada genérica a un comando de Bazel que no pertenece a otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si no está vacío, lee el archivo resuelto especificado en lugar del archivo WORKSPACE
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remoto:
- Configuración predeterminada de
--experimental_downloader_config=<a string>
: ver descripción - Especifica un archivo para configurar el cargador remoto. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno con el que debe coincidir y otro para usar como URL sustitutiva, con referencias inversas que comienzan con "$1". Es posible que se proporcionen varias directivas "rewrite" para la misma URL, y se mostrarán varias URL.
- Opciones varias, que no están categorizadas:
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local en el formato <repository name>=<path>. Si la ruta de acceso determinada es una ruta absoluta, se usará tal como es. Si la ruta de acceso dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso indicada comienza con “%workspace%”, es relativa a la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
Etiquetas de efecto de la opción
unknown |
Esta opción tiene un efecto desconocido o no documentado. |
no_op |
Esta opción literalmente no tiene efecto. |
loses_incremental_state |
Cambiar el valor de esta opción puede causar una pérdida significativa del estado incremental, lo que ralentiza las compilaciones. El estado podría perderse debido a un reinicio del servidor o a la invalidación de una gran parte del gráfico de dependencias. |
changes_inputs |
Esta opción cambia de forma activa las entradas que Bazel considera para la compilación, como restricciones del sistema de archivos, versiones del repositorio y otras opciones. |
affects_outputs |
Esta opción afecta las salidas de Bazel. Esta etiqueta es intencionalmente amplia, puede incluir efectos transitivos y no especifica el tipo de salida que afecta. |
build_file_semantics |
Esta opción afecta la semántica de los archivos BUILD o .bzl. |
bazel_internal_configuration |
Esta opción afecta la configuración de la maquinaria interna de Bazel. Por sí sola, esta etiqueta no significa que los artefactos de compilación se vean afectados. |
loading_and_analysis |
Esta opción afecta la carga y el análisis de dependencias, y la compilación del gráfico de dependencias. |
execution |
Esta opción afecta la fase de ejecución, como las opciones relacionadas con la zona de pruebas o la ejecución remota. |
host_machine_resource_optimizations |
Esta opción activa una optimización que puede ser específica de una máquina y no garantiza su funcionamiento en todas ellas. La optimización puede incluir una compensación con otros aspectos del rendimiento, como el costo de CPU o memoria. |
eagerness_to_exit |
Esta opción cambia la anticipación con la que Bazel sale de una falla, en la que existe la opción de continuar a pesar de la falla y finalizar la invocación. |
bazel_monitoring |
Esta opción se usa para supervisar el comportamiento y el rendimiento de Bazel. |
terminal_output |
Esta opción afecta el resultado de la terminal de Bazel. |
action_command_lines |
Esta opción cambia los argumentos de la línea de comandos de una o más acciones de compilación. |
test_runner |
Esta opción cambia el entorno del ejecutor de pruebas de la compilación. |
Etiquetas de metadatos de opción
experimental |
Esta opción activa una función experimental sin garantías de funcionalidad. |
incompatible_change |
Esta opción activa un cambio rotundo. Usa esta opción para probar tu preparación para la migración o para obtener acceso anticipado a la función nueva |
deprecated |
Esta opción está obsoleta. Es posible que la función a la que afecta esté obsoleta o que se prefiera otro método para proporcionar la información. |
explicit_in_output_path |
Esta opción se menciona explícitamente en el directorio de salida. |