bazel [<startup options>] <command> [<args>]
bazel [<startup options>] <command> [<args>] -- [<target patterns>]Consulta la Guía del usuario para conocer la sintaxis de los patrones de destino.
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 un solo formato corto de caracteres; en ese caso, el formulario corto debe pasarse con un solo guion y un espacio.
-<short_form> <value>
Las opciones booleanas se pueden habilitar de la siguiente manera:
--<option> --<option>=[true|yes|1]y, luego, inhabilitarse de la siguiente manera:
--no<option> --<option>=[false|no|0]
Por lo general, las opciones de triestado se configuran como automáticas de forma predeterminada y se pueden habilitar de manera forzosa de la siguiente manera:
--<option>=[true|yes|1]o forzarlas 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 y consulta el grafo de acción. |
build |
Compila los destinos especificados. |
canonicalize-flags |
Canonicaliza una lista de opciones de bazel. |
clean |
Quita los archivos de salida y detiene el servidor de manera opcional. |
coverage |
Genera un informe de cobertura de código para los destinos de prueba especificados. |
cquery |
Carga, analiza y consulta los objetivos especificados con los parámetros de configuración. |
dump |
Vuelca el estado interno del proceso del servidor de Bazel. |
fetch |
Recupera repositorios externos que son requisitos previos para los destinos. |
help |
Imprime 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 orientaciones en los dispositivos móviles. |
modquery |
Consulta el gráfico de dependencia externa de Bzlmod |
print_action |
Imprime los argumentos de línea de comandos para compilar un archivo. |
query |
Ejecuta una consulta de gráfico de dependencia. |
run |
Ejecuta el destino especificado. |
shutdown |
Detiene el servidor Bazel. |
sync |
Sincroniza todos los repositorios especificados en el archivo del espacio de trabajo |
test |
Compila y ejecuta los destinos de prueba especificados. |
version |
Imprime la información de la versión de Bazel. |
Opciones de inicio
- Opciones que aparecen antes del comando y que el cliente analiza:
--[no]autodetect_server_javabase
predeterminado: “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
- Valor predeterminado de
--[no]batch
: “falso” -
Si se configura, Bazel se ejecutará como un proceso de cliente sin servidor, en lugar de hacerlo en el modo cliente/servidor estándar. Esta acción es obsoleta y se eliminará. Si no quieres conservar servidores, ciérralos de forma explícita.
Etiquetas:loses_incremental_state
,bazel_internal_configuration
,deprecated
- Valor predeterminado de
--[no]batch_cpu_scheduling
: “falso” -
Solo en Linux. Usa la programación de CPU “por lotes” para Blaze. Esta política es útil para cargas de trabajo que no son interactivas, pero que no desean disminuir su valor adecuado. Consulta 'hombre 2 sched_setscheduler'. Si es falso, Bazel no realizará una llamada del sistema.
Etiquetas:host_machine_resource_optimizations
--bazelrc=<path>
predeterminado: 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 más `--bazelrc`, lo cual es útil para inhabilitar la búsqueda de un archivo rc de usuario, por ejemplo, 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 leyeron x.rc y.rc.
2) Se ignora z.rc debido a la /dev/null anterior.
Si no se especifica, Bazel usa el primer archivo .bazelrc que encuentra en las siguientes dos ubicaciones: el directorio del lugar de trabajo y, luego, el directorio principal del usuario.
Nota: Las opciones de línea de comandos siempre reemplazarán a cualquier opción en bazelrc.
Etiquetas:changes_inputs
--[no]block_for_lock
predeterminado: “verdadero”-
Cuando se pasa --noblock_for_lock, Bazel no espera a que se complete un comando en ejecución, sino que sale de inmediato.
Etiquetas:eagerness_to_exit
- Valor predeterminado de
--[no]client_debug
: “falso” - Si es verdadero, registra la información de depuración del cliente a stderr. Si cambias esta opción, el servidor no se reiniciará.
Etiquetas:affects_outputs
,bazel_monitoring
- Valor predeterminado de
--connect_timeout_secs=<an integer>
: "30" -
La cantidad de tiempo que el cliente espera cada vez que se intenta establecer una conexión con el servidor.
Etiquetas:bazel_internal_configuration
--[no]expand_configs_in_place
predeterminado: “verdadero”-
Se cambió la expansión de las marcas --config para que se lleven a cabo de forma local, en lugar de en una expansión de punto fijo entre las opciones normales de rc y las opciones especificadas de la línea de comandos.
Etiquetas:no_op
,deprecated
--failure_detail_out=<path>
predeterminado: ver descripción-
Si se configura, especifica una ubicación para escribir un mensaje protobuf. De lo contrario, la ubicación será ${OUTPUT_BASE}/failure_detail.rawproto.
Etiquetas:affects_outputs
,loses_incremental_state
--[no]home_rc
predeterminado: “verdadero”-
Busca o no el archivo bazelrc principal en $HOME/.bazelrc
Etiquetas:changes_inputs
--[no]idle_server_tasks
predeterminado: “verdadero”-
Ejecuta System.gc() cuando el servidor esté inactivo.
Etiquetas:loses_incremental_state
,host_machine_resource_optimizations
- Valor predeterminado de
--[no]ignore_all_rc_files
: “falso” -
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}
predeterminado: "-1"-
Solo en Linux. Establece un nivel de 0 a 7 para la mejor programación de IO del mejor esfuerzo con la llamada al sistema sys_ioprio_set. 0 es la prioridad más alta, 7 es la más baja. El programador anticipado solo puede respetar la prioridad 4. Si se establece en un valor negativo, Bazel no realizará una llamada del sistema.
Etiquetas:host_machine_resource_optimizations
- Valor predeterminado de
--local_startup_timeout_secs=<an integer>
: “120” -
La cantidad máxima de tiempo que el cliente espera para conectarse al servidor.
Etiquetas:bazel_internal_configuration
--macos_qos_class=<a string>
predeterminado: “predeterminado”-
Configura la clase de servicio QoS del servidor de Bazel cuando se ejecuta en macOS. Esta marca no tiene ningún efecto en las demás plataformas, pero es compatible para garantizar que los archivos RC se puedan compartir entre ellas sin cambios. Los valores posibles son los siguientes: interactivo para el usuario, iniciado por el usuario, predeterminado, utilidad y en segundo plano.
Etiquetas:host_machine_resource_optimizations
- Valor predeterminado de
--max_idle_secs=<integer>
: “10800” -
La cantidad de segundos que el servidor de compilación esperará por inactividad antes de apagarse. Cero significa que el servidor nunca se cerrará. Esto solo se lee cuando se inicia el servidor. Si cambias esta opción, el servidor no se reiniciará.
Etiquetas:eagerness_to_exit
,loses_incremental_state
--output_base=<path>
predeterminado: ver descripción-
Si se configura, especifica la ubicación de salida en la que se escribirán todos los resultados de la compilación. De lo contrario, la ubicación será ${OUTPUT_ROOT}/_blaze_${USER}/${MD5_OF_WORKSPACE_ROOT}. Nota: Si especificas una opción diferente de una a la siguiente invocación de Bazel para este valor, es probable que inicies un nuevo servidor de Bazel adicional. Bazel inicia exactamente un servidor por base de salida especificada. Por lo general, hay una base de salida por lugar de trabajo. Sin embargo, con esta opción, puede 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 “Cierre de la ayuda de Bazel” para obtener información sobre cómo cerrar un servidor de Bazel.
Etiquetas:affects_outputs
,loses_incremental_state
--output_user_root=<path>
predeterminado: ver descripción- El directorio específico del usuario debajo del cual se escriben todas las salidas de compilación; de forma predeterminada, esta es una función de $USER, pero si especificas una constante, los resultados de compilación se pueden compartir entre los usuarios que colaboran.
Etiquetas:affects_outputs
,loses_incremental_state
- Valor predeterminado de
--[no]preemptible
: “falso” - Si es verdadero, el comando se puede interrumpir si se inicia otro comando.
Etiquetas:eagerness_to_exit
--server_jvm_out=<path>
predeterminado: ver descripción-
La ubicación en la que se escribirá la salida de JVM del servidor. Si no está configurado, se establece de forma predeterminada en una ubicación en output_base.
Etiquetas:affects_outputs
,loses_incremental_state
- Valor predeterminado de
--[no]shutdown_on_low_sys_mem
: “falso” -
Si se establece max_idle_secs y el servidor de compilación estuvo inactivo durante un tiempo, ciérrelo cuando el sistema tenga poca RAM libre. Solo en Linux.
Etiquetas:eagerness_to_exit
,loses_incremental_state
--[no]system_rc
predeterminado: “verdadero”-
Indica si se debe buscar o no el bazelrc para todo el sistema.
Etiquetas:changes_inputs
- Valor predeterminado de
--[no]unlimit_coredumps
: “falso” - Aumenta el límite de softcore de volcado al límite estricto para hacer que los dumpers del servidor (incluida la JVM) y el cliente sean posibles en condiciones comunes. 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
- Valor predeterminado de
--[no]watchfs
: “falso” -
Si el valor es verdadero, Bazel intenta usar el servicio de observación de archivos del sistema operativo para los cambios locales en lugar de analizar cada archivo en busca de un cambio.
Etiquetas:deprecated
- Valor predeterminado de
--[no]windows_enable_symlinks
: “falso” -
Si es verdadero, se crearán vínculos simbólicos reales en Windows en lugar de copiar archivos. Requiere que se habilite el modo de desarrollador de Windows y Windows 10, versión 1703 o posterior.
Etiquetas:bazel_internal_configuration
--[no]workspace_rc
predeterminado: “verdadero”-
Busca o no el archivo workspace bazelrc en $workspace/.bazelrc
Etiquetas:changes_inputs
- Otras opciones (no categorizadas).
- Se acumulan
--host_jvm_args=<jvm_arg>
usos múltiples - Marcas para pasar a la JVM que ejecuta Blaze.
--host_jvm_debug
-
Es conveniente agregar marcas de inicio adicionales de JVM, que hacen que la JVM espere durante el inicio hasta que te conectes desde un depurador compatible con JDWP (como Eclipse) al puerto 5005.
Se expande a:
--host_jvm_args=-Xdebug
--host_jvm_args=-Xrunjdwp:transport=dt_socket,server=y,address=5005
--host_jvm_profile=<profiler_name>
predeterminado: ""- Es la opción conveniente para agregar marcas de inicio de JVM específicas del generador de perfiles o del generador de perfiles. Bazel tiene una lista de valores conocidos que se asigna a marcas de inicio de JVM codificadas, en las que se pueden buscar algunas rutas de acceso codificadas para ciertos archivos.
--server_javabase=<jvm path>
predeterminado: ""- Ruta de acceso a la JVM que se usa para ejecutar Bazel.
Opciones comunes para todos los comandos
- Opciones que controlan la ejecución de la compilación:
--experimental_oom_more_eagerly_threshold=<an integer>
predeterminado: "100"-
Si se establece esta marca en un valor inferior a 100, Bazel mostrará una OOM si, después de dos GC completas, aún ocupa más de este porcentaje del montón (antigüedad anterior).
Etiquetas:host_machine_resource_optimizations
- Valor predeterminado de
--experimental_ui_max_stdouterr_bytes=<an integer in (-1)-1073741819 range>
: “1048576” -
El tamaño máximo de los archivos stdout o stderr que se imprimirán en la consola. -1 significa que no hay límite.
Etiquetas:execution
- Opciones que permiten que el usuario configure 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 las variables de entorno adicionales que estarán disponibles solo para las reglas de 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 acciones.
Etiquetas:action_command_lines
- Opciones que afectan la forma estricta en que Bazel aplica las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etc.):
--[no]check_bzl_visibility
predeterminado: “verdadero”- Si se inhabilita, los errores de visibilidad de carga de .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 a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.
- Valor predeterminado de
--[no]enable_bzlmod
: “falso” -
Si es verdadero, habilita el sistema de administración de dependencias de Bzlmod, que tiene prioridad sobre WORKSPACE. Consulta https://bazel.build/build/bzlmod para obtener más información.
Etiquetas:loading_and_analysis
--[no]experimental_action_resource_set
predeterminado: “verdadero”-
Si se configura como verdadera, ctx.actions.run() y ctx.actions.run_shell() aceptan un parámetro resource_set para la ejecución local. De lo contrario, la memoria predeterminada será de 250 MB para la memoria y 1 CPU.
Etiquetas:execution
,build_file_semantics
,experimental
-
Si se establece como verdadera, las etiquetas se propagarán de un objetivo a los requisitos de ejecución de las acciones. De lo contrario, las etiquetas no se propagarán. Consulta https://github.com/bazelbuild/bazel/issues/8830 para obtener más detalles.
Etiquetas:build_file_semantics
,experimental
--[no]experimental_analysis_test_call
predeterminado: “verdadero”-
Si se configura como verdadera, la llamada nativa Analysis_test está disponible.
Etiquetas:loading_and_analysis
,build_file_semantics
,experimental
--[no]experimental_bzl_visibility
predeterminado: “verdadero”-
Si se habilita, agrega una función de "visibility()`" a la que pueden llamar los archivos .bzl durante la evaluación de nivel superior para establecer su visibilidad con el propósito de declaraciones load().
Etiquetas:loading_and_analysis
,experimental
-
Si se establece 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
- Valor predeterminado de
--[no]experimental_disable_external_package
: “falso” -
Si se configura como verdadera, el paquete //external generado automáticamente ya no estará disponible. Bazel todavía 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
- Valor predeterminado de
--[no]experimental_enable_android_migration_apis
: “falso” -
Si se configura como verdadera, habilita las API necesarias para admitir la migración de Android Starlark.
Etiquetas:build_file_semantics
- Valor predeterminado de
--[no]experimental_get_fixed_configured_action_env
: “falso” -
Si está habilitado, action.env también mostrará variables de entorno fijas que se especificaron mediante la configuración de funciones.
Etiquetas:loading_and_analysis
,experimental
- Valor predeterminado de
--[no]experimental_google_legacy_api
: “falso” -
Si se establece como verdadera, se exponen varias partes experimentales de la API de compilación de Starlark que pertenecen al código heredado de Google.
Etiquetas:loading_and_analysis
,experimental
--[no]experimental_lazy_template_expansion
predeterminado: “verdadero”- Si se establece como verdadera, ctx.actions.expand_template() acepta un parámetro TemplateDict para la evaluación diferida de los valores de sustitución.
Etiquetas:execution
,build_file_semantics
,experimental
- Valor predeterminado de
--[no]experimental_platforms_api
: “falso” -
Si se configura como verdadera, habilita una serie de API de Starlark relacionadas con la plataforma que son útiles para la depuración.
Etiquetas:loading_and_analysis
,experimental
- Valor predeterminado de
--[no]experimental_repo_remote_exec
: “falso” -
Si se configura como verdadero, repositorio_rule obtiene algunas capacidades de ejecución remota.
Etiquetas:build_file_semantics
,loading_and_analysis
,experimental
- Valor predeterminado de
--[no]experimental_sibling_repository_layout
: “falso” -
Si se configura como verdadera, los repositorios no 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 real "external".
Etiquetas:action_command_lines
,bazel_internal_configuration
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]incompatible_always_check_depset_elements
predeterminado: “verdadero”-
Verifica la validez de los elementos agregados a los depsets, en todos los constructores. Los elementos deben ser inmutables, pero, históricamente, el constructor depset(direct=...) se olvidó de verificar. Usa tuplas en lugar de listas en elementos depset. Consulta https://github.com/bazelbuild/bazel/issues/10313 para obtener más detalles.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_depset_for_libraries_to_link_getter
predeterminado: “verdadero”-
Cuando es verdadero, Bazel ya no muestra una lista de Linking_context.libraries_to_link, sino que muestra un Depset.
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]incompatible_disable_starlark_host_transitions
: “falso” -
Si se establece como verdadera, los atributos de las reglas no pueden establecer “cfg = “host”'. En cambio, debe establecer "cfg = "exec"'.
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]incompatible_disable_target_provider_fields
: “falso” - Si se configura como verdadera, inhabilita la capacidad de acceder a proveedores en objetos de destino mediante la sintaxis de campos. En su lugar, usa la sintaxis de la clave del proveedor. Por ejemplo, en lugar de usar “ctx.attr.dep.my_info” para acceder a “my_info” desde una función de implementación de reglas, usa “ctx.attr.dep[MyInfo]”. Consulta https://github.com/bazelbuild/bazel/issues/9014 para obtener más detalles.
Etiquetas:build_file_semantics
,incompatible_change
- Valor predeterminado de
--[no]incompatible_disallow_empty_glob
: “falso” -
Si se configura como verdadera, el valor predeterminado del argumento “allow_empty” de glob() es falso.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_disallow_legacy_javainfo
predeterminado: “verdadero”-
Obsoleto. No-op.
Etiquetas:build_file_semantics
,incompatible_change
- Valor predeterminado de
--[no]incompatible_disallow_struct_provider_syntax
: “falso” - Si se configura como verdadera, es posible que las funciones de implementación de reglas no muestren una estructura. En su lugar, deben mostrar una lista de instancias de proveedores.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_existing_rules_immutable_view
predeterminado: “verdadero”- Si se configura como verdadero, native.existing_rule y native.existing_rules muestran objetos de vista inmutables en lugar de diccionarios mutables.
Etiquetas:build_file_semantics
,loading_and_analysis
,incompatible_change
--[no]incompatible_fix_package_group_reporoot_syntax
predeterminado: “verdadero”-
En el atributo package [paquete], cambia el significado del valor “//...” para hacer referencia a todos los paquetes del repositorio actual en lugar de a todos los paquetes de cualquier repositorio. Puedes usar el valor especial "public" en lugar de "//..." para obtener el comportamiento anterior. Esta marca requiere que también se habilite --incompatible_package_group_has_public_syntax.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_java_common_parameters
predeterminado: “verdadero”-
Si se establece como verdadera, se quitarán los parámetros output_jar y host_javabase de pack_sources y host_javabase de la compilación.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_new_actions_api
predeterminado: “verdadero”-
Si se establece como verdadera, la API para crear acciones solo está disponible en `ctx.actions`, no en `ctx`.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_no_attr_license
predeterminado: “verdadero”- Si se establece como verdadera, se inhabilita la función "attr.license".
Etiquetas:build_file_semantics
,incompatible_change
- Valor predeterminado de
--[no]incompatible_no_implicit_file_export
: “falso” -
Si se configuran, los archivos de origen (usados) son privados para los 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
- Valor predeterminado de
--[no]incompatible_no_rule_outputs_param
: “falso” -
Si se establece como verdadera, inhabilita el parámetro "outputs" de la función "rule()` de Starlark".
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_package_group_has_public_syntax
predeterminado: “verdadero”-
En el atributo “packages” (paquetes) de package_group, se permite que se escriba “public” o “private” para referirse a todos los paquetes, o bien a ninguno, respectivamente.
Etiquetas:build_file_semantics
,incompatible_change
--[no]incompatible_require_linker_input_cc_api
predeterminado: “verdadero”-
Si se establece como verdadera, la regla create_linking_context requerirá linker_inputs en lugar de bibliotecas_to_link. También se inhabilitarán los métodos get anteriores de links_context y solo estará disponible linker_inputs.
Etiquetas:build_file_semantics
,loading_and_analysis
,incompatible_change
--[no]incompatible_run_shell_command_string
predeterminado: “verdadero”-
Si se establece como verdadera, el parámetro de comando de actions.run_shell solo aceptará la string
Etiquetas:build_file_semantics
,incompatible_change
- Valor predeterminado de
--[no]incompatible_stop_exporting_language_modules
: “falso” -
Si está habilitado, algunos módulos específicos para cada lenguaje (como "cc_common") no están disponibles en los archivos .bzl del usuario y solo se pueden llamar desde sus respectivos repositorios de reglas.
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]incompatible_struct_has_no_methods
: “falso” - Inhabilita los métodos struct to_json y to_proto, 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
- Valor predeterminado de
--[no]incompatible_top_level_aspects_require_providers
: “falso” -
Si se establece como verdadera, el aspecto de nivel superior respetará a sus proveedores necesarios y solo se ejecutará en objetivos de nivel superior cuyos proveedores anunciados cumplan con los proveedores obligatorios del aspecto.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_unambiguous_label_stringification
predeterminado: “verdadero”-
Cuando es verdadero, Bazel convierte la etiqueta @//foo:bar en @//foo:bar, en lugar de //foo:bar. Esto solo afecta el comportamiento de str(), el operador de porcentaje, etc. El comportamiento de repr() no se modifica. Consulta https://github.com/bazelbuild/bazel/issues/15916 para obtener más información.
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]incompatible_use_cc_configure_from_rules_cc
: “falso” -
Cuando es verdadero, Bazel ya no permitirá usar cc_configure desde @bazel_tools. Consulta https://github.com/bazelbuild/bazel/issues/10134 para obtener detalles y, además, instrucciones de migración.
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]incompatible_visibility_private_attributes_at_definition
: “falso” -
Si se establece como verdadera, se verifica la visibilidad de los atributos de las reglas privadas con respecto a la definición de la regla, en lugar del uso de la regla.
Etiquetas:build_file_semantics
,incompatible_change
--max_computation_steps=<a long integer>
predeterminado: "0"-
La cantidad máxima de pasos de cálculo de Starlark que puede ejecutar un archivo BUILD (cero significa sin límite).
Etiquetas:build_file_semantics
--nested_set_depth_limit=<an integer>
predeterminado: "3500"-
La profundidad máxima del gráfico interno de un repositorio (también conocido como NestedSet), por encima del cual el constructor depset() fallará.
Etiquetas:loading_and_analysis
- Opciones que activan optimizaciones del tiempo de compilación:
- Valor predeterminado de
--[no]experimental_heuristically_drop_nodes
: “falso” -
Si esta preferencia se establece como verdadera, Blaze quitará los nodos FileState y DirectoryListingState después de que se hayan realizado los nodos relacionados File y DirectoryListing para ahorrar memoria. Esperamos que sea menos probable que estos nodos se vuelvan a necesitar. Si es así, el programa volverá a evaluarlos.
Etiquetas:loses_incremental_state
--[no]incompatible_do_not_split_linking_cmdline
predeterminado: “verdadero”-
Cuando es verdadero, Bazel ya no modifica las marcas de línea de comandos que se usan para las vinculaciones ni decide de forma selectiva qué marcas se dirigen al archivo de parámetros y cuáles no. Consulta https://github.com/bazelbuild/bazel/issues/7670 para obtener más detalles.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]keep_state_after_build
predeterminado: “verdadero”-
Si es falso, Blaze descartará el estado de memoria en esta compilación cuando esta termine. Las compilaciones posteriores no tendrán una 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 su porcentaje de uso de montón retenido es al menos este umbral, quitará el estado temporal de Skyframe innecesario. Realizar ajustes en ella puede ayudarte a mitigar el impacto del tiempo de pared mediante la hiperpaginación de GC. Cuando esto ocurre, (i) se debe al uso de memoria de este estado temporal y (ii) más costoso que reconstituir el estado cuando es necesario.
Etiquetas:host_machine_resource_optimizations
--[no]track_incremental_state
predeterminado: “verdadero”-
Si es falso, Blaze no conservará los datos que permitan la invalidación y la reevaluación en compilaciones incrementales a fin de ahorrar memoria en esta compilación. Las compilaciones posteriores no tendrán una incrementalidad con respecto a esta. Por lo general, se debe especificar --batch cuando se configura como falso.
Etiquetas:loses_incremental_state
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Valor predeterminado de
--[no]announce_rc
: “falso” -
Indica si se deben anunciar opciones rc.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]attempt_to_print_relative_paths
: “falso” -
Cuando imprima la parte de la ubicación de los mensajes, intente usar una ruta de acceso relativa al directorio del lugar de trabajo o uno de los directorios especificados por --package_path.
Etiquetas:terminal_output
--bes_backend=<a string>
predeterminado: ""- Especifica el extremo del backend del servicio de evento de compilación (BES) con el formato [SCHEME://]HOST[:PORT]. La opción predeterminada es inhabilitar las cargas de BES. Los esquemas admitidos son grpc y grpcs (grpc with TLS enabled). Si no se proporciona ningún esquema, Bazel supone grpcs.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]bes_check_preceding_lifecycle_events
: “falso” -
Establece el campo check_preceding_lifecycle_events_present en PublishBuildToolEventStreamRequest que le indica a BES que verifique si recibió anteriormente los eventos InvocationIntentStarted y BuildEnqueued que coinciden con el evento de la herramienta actual.
Etiquetas:affects_outputs
- Se acumulan
--bes_header=<a 'name=value' assignment>
usos múltiples -
Especifica un encabezado con el formato NAME=VALUE que se incluirá en las solicitudes de BES. Se pueden pasar varios encabezados si se especifica la marca varias veces. Se convertirán varios valores para el mismo nombre en una lista separada por comas.
Etiquetas:affects_outputs
--bes_instance_name=<a string>
predeterminado: ver descripción-
Especifica el nombre de la instancia en la que el BES conservará el BEP subido. La configuración predeterminada es un valor 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 para agregar al conjunto predeterminado de palabras clave publicadas en BES ("command_name=<command_name> ", "protocol_name=BEP"). La configuración predeterminada es "none".
Etiquetas:affects_outputs
--[no]bes_lifecycle_events
predeterminado: “verdadero”-
Especifica si se publican eventos de ciclo de vida de BES. (el valor predeterminado es “true”).
Etiquetas:affects_outputs
- Valor predeterminado de
--bes_oom_finish_upload_timeout=<An immutable length of time.>
: "10 min" -
Especifica cuánto tiempo debe esperar un bazel para que se complete la carga de BES/BEP durante la operación OOMING. Esta marca garantiza la terminación cuando la JVM provoca una hiperpaginación intensa y no puede progresar en ningún subproceso de usuario.
Etiquetas:bazel_monitoring
- Valor predeterminado de
--bes_outerr_buffer_size=<an integer>
: “10240” - Especifica el tamaño máximo de stdout o stderr para 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 es mayor que el valor especificado hasta --bes_outerr_chunk_size.
Etiquetas:affects_outputs
- Valor predeterminado de
--bes_outerr_chunk_size=<an integer>
: “1048576” -
Especifica el tamaño máximo de stdout o stderr que se enviará a BEP en un solo mensaje.
Etiquetas:affects_outputs
--bes_proxy=<a string>
predeterminado: ver descripción- Conéctate al servicio de evento 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 generará la URL que agrega el ID de invocación a la terminal.
Etiquetas:terminal_output
- Valor predeterminado de
--bes_timeout=<An immutable length of time.>
: "0 s" -
Especifica el tiempo que el bazel debería esperar a que se complete la carga de BES/BEP después de que finalicen la compilación y las pruebas. Un tiempo de espera válido es un número natural seguido de una unidad: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). El valor predeterminado es "0", lo que significa que no hay tiempo de espera.
Etiquetas:affects_outputs
--build_event_binary_file=<a string>
predeterminado: ""- Si no está vacío, escribe una representación binaria delimitada por Vaint 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
--[no]build_event_binary_file_path_conversion
predeterminado: “verdadero”-
Convierte las rutas de acceso en la representación del archivo binario del protocolo de eventos de compilación a URI más válidos a nivel global siempre que sea posible. Si se inhabilita, se usará siempre el esquema file:// uri.
Etiquetas:affects_outputs
--build_event_json_file=<a string>
predeterminado: ""-
Si no está vacío, escriba una serialización JSON del protocolo de evento de compilación en ese archivo.
Etiquetas:affects_outputs
--[no]build_event_json_file_path_conversion
predeterminado: “verdadero”-
Convierte las rutas de acceso en la representación del archivo JSON del protocolo de eventos de compilación a URI más válidos a nivel global siempre que sea posible. Si está inhabilitada, el esquema file:// uri siempre se usará
Etiquetas:affects_outputs
--build_event_max_named_set_of_file_entries=<an integer>
predeterminado: "-1"-
La cantidad máxima de entradas para un solo evento name_set_of_files. Se ignoran los valores inferiores a 2 y no se realiza ninguna división de eventos. Esto está diseñado para limitar el tamaño máximo de evento en el protocolo de evento de compilación, aunque no controla directamente el tamaño del evento. El tamaño total del evento es una función de la estructura del conjunto, así como la longitud del archivo y el URI, que, a su vez, pueden depender de la función hash.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]build_event_publish_all_actions
: “falso” -
Indica si se deben publicar todas las acciones.
Etiquetas:affects_outputs
--build_event_text_file=<a string>
predeterminado: ""-
Si no está vacío, escriba una representación textual del protocolo de evento de compilación en ese archivo.
Etiquetas:affects_outputs
--[no]build_event_text_file_path_conversion
predeterminado: “verdadero”-
Convierte las rutas en la representación del archivo de texto del protocolo de eventos de compilación a URI más válidos a nivel global siempre que sea posible. Si se inhabilita, siempre se usará el esquema file:// uri.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]experimental_announce_profile_path
: “falso” - Si se habilita, agrega la ruta de acceso del perfil JSON al registro.
Etiquetas:affects_outputs
,bazel_monitoring
- Valor predeterminado de
--[no]experimental_bep_target_summary
: “falso” - Indica si se deben publicar eventos de TargetSummary.
- Valor predeterminado de
--[no]experimental_build_event_expand_filesets
: “falso” - Si es verdadero, expande los conjuntos de archivos en el BEP cuando se presentan archivos de salida.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]experimental_build_event_fully_resolve_fileset_symlinks
: “falso” -
Si es verdadero, resuelve por completo los symlinks relativos del conjunto de archivos en el BEP cuando 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"-
La cantidad máxima de veces que Bazel debería reintentar subir un evento de compilación.
Etiquetas:bazel_internal_configuration
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
predeterminado: "1 s"-
Es el retraso mínimo inicial para los reintentos de retirada exponencial cuando falla la carga de BEP. (exponente: 1.6)
Etiquetas:bazel_internal_configuration
--experimental_build_event_upload_strategy=<a string>
predeterminado: ver descripción- Selecciona cómo subir los artefactos a los que se hace referencia en el protocolo de evento de compilación.
Etiquetas:affects_outputs
- Se acumulan
--experimental_profile_additional_tasks=<phase, action, action_check, action_lock, action_release, action_update, action_complete, info, create_package, remote_execution, local_execution, scanner, local_parse, upload_time, process_time, remote_queue, remote_setup, fetch, vfs_stat, vfs_dir, vfs_readlink, vfs_md5, vfs_xattr, vfs_delete, vfs_open, vfs_read, vfs_write, vfs_glob, vfs_vmfs_stat, vfs_vmfs_dir, vfs_vmfs_read, wait, thread_name, thread_sort_index, skyframe_eval, skyfunction, critical_path, critical_path_component, handle_gc_notification, action_counts, local_cpu_usage, system_cpu_usage, cpu_usage_estimation, local_memory_usage, system_memory_usage, memory_usage_estimation, system_network_up_usage, system_network_down_usage, workers_memory_usage, system_load_average, starlark_parser, starlark_user_fn, starlark_builtin_fn, starlark_user_compiled_fn, starlark_repository_fn, action_fs_staging, remote_cache_check, remote_download, remote_network, filesystem_traversal, worker_execution, worker_setup, worker_borrow, worker_working, worker_copying_outputs, credential_helper or unknown>
usos múltiples -
Especifica las tareas de perfil adicionales que se incluirán en el perfil.
Etiquetas:affects_outputs
,bazel_monitoring
- Valor predeterminado de
--[no]experimental_profile_include_primary_output
: “falso” -
Incluye el atributo adicional "out" 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
- Valor predeterminado de
--[no]experimental_profile_include_target_label
: “falso” -
Incluye la etiqueta de destino en los datos del perfil JSON de los eventos de acción.
Etiquetas:affects_outputs
,bazel_monitoring
- Valor predeterminado de
--[no]experimental_stream_log_file_uploads
: “falso” - Transmite directamente los archivos de registro al almacenamiento remoto en lugar de escribirlos en el disco.
Etiquetas:affects_outputs
--experimental_workspace_rules_log_file=<a path>
predeterminado: ver descripción- Registrar ciertos eventos de reglas de Workspace en este archivo como protocolos delimitados por WorkspaceEvent.
--[no]generate_json_trace_profile
predeterminado: "automático"-
Si está habilitado, Bazel genera un perfil de la compilación y escribe un perfil en formato JSON en un archivo en la base de salida. Para ver el perfil, cárgalo en chrome://tracing. De forma predeterminada, Bazel escribe el perfil para todos los comandos y la consulta similares a las compilaciones.
Etiquetas:affects_outputs
,bazel_monitoring
- Valor predeterminado de
--[no]heap_dump_on_oom
: “falso” -
Indica si se debe generar manualmente un volcado de montón si se genera una OOM (incluidas las OOM debido a --experimental_oom_more_eagerly_threshold). El volcado se escribirá en <output_base>/<invocation_id>.heapdump.hprof. Esta opción reemplaza efectivamente -XX:+HeapDumpOnOutOfMemoryError, que no tiene efecto porque los OOM se detectan y se redireccionan a Runtime#halt.
Etiquetas:bazel_monitoring
--[no]legacy_important_outputs
predeterminado: “verdadero”-
Úsalo a fin de suprimir la generación del campo heredado_outputs heredado del evento TargetComplete. Son importantes para la integración de Bazel con ResultStore.
Etiquetas:affects_outputs
- Valor predeterminado de
--logging=<0 <= an integer <= 6>
: "3" - El nivel de registro.
Etiquetas:affects_outputs
--memory_profile=<a path>
predeterminado: ver descripción-
Si se configura, escribe datos de uso de memoria en el archivo especificado en los extremos de la fase y un montón estable en el registro principal al final de la compilación.
Etiquetas:affects_outputs
,bazel_monitoring
- Valor predeterminado de
--memory_profile_stable_heap_parameters=<integers, separated by a comma expected in pairs>
: “1,0” - Ajusta el procesamiento del perfil de memoria del montón estable al final de la compilación. Debe ser el número par o entero, separado por comas. En cada par, el primer número entero es la cantidad de GC que se debe realizar. El segundo número entero de cada par es la cantidad de segundos que se espera entre las recolecciones. P. ej., 2,4,4,0 sería 2 GC con una pausa de 4 segundos, seguida de 4 GC con una pausa de cero segundos.
Etiquetas:bazel_monitoring
--profile=<a path>
predeterminado: ver descripción-
Si se configura, genera un perfil de Bazel y escribe datos en el archivo especificado. Usa el perfil de análisis de Bazel para analizar el perfil.
Etiquetas:affects_outputs
,bazel_monitoring
--[no]slim_profile
predeterminado: “verdadero”-
Reduce los tamaños del perfil JSON. Para ello, fusiona eventos si el perfil se vuelve demasiado grande.
Etiquetas:affects_outputs
,bazel_monitoring
--starlark_cpu_profile=<a string>
predeterminado: ""-
Escribe en el archivo especificado un perfil pprof del uso de CPU por parte de todos los subprocesos de Starlark.
Etiquetas:bazel_monitoring
--tool_tag=<a string>
predeterminado: ""-
Un nombre de herramienta para 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 mostrar en la IU. Es posible agregar o quitar eventos a los eventos predeterminados con los símbolos +/-, o anular completamente el conjunto predeterminado con la asignación directa. El conjunto de tipos de eventos compatibles incluye INFO, DEBUG, ERROR y más.
Etiquetas:terminal_output
- Varias opciones, sin otra categoría.
- Se acumulan
--build_metadata=<a 'name=value' assignment>
usos múltiples - Pares de strings de clave-valor personalizadas para proporcionar en un evento de compilación.
Etiquetas:terminal_output
--color=<yes, no or auto>
predeterminado: "automático"- Usa los controles de la terminal para colorear el resultado.
- Se acumulan
--config=<a string>
usos múltiples - Selecciona secciones de configuración adicionales de los archivos rc: para cada <command>, también extrae las opciones de <command>:<config> si esa sección existe; 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 corresponden se ubican en los archivos de configuración tools/*.blazerc.
--curses=<yes, no or auto>
predeterminado: "automático"- Usa los controles del cursor del terminal para minimizar el resultado del desplazamiento.
- Valor predeterminado de
--[no]enable_platform_specific_config
: “falso” - Si es verdadero, Bazel selecciona las líneas de configuración específicas del host del SO de los archivos de Bazelrc. Por ejemplo, si el SO host es Linux y ejecutas compilación de Bazel, Bazel recoge las líneas que comienzan con build.linux. Los identificadores de SO admitidos son linux, macos, windows, freebsd y openbsd. Habilitar esta marca equivale a usar --config=linux en Linux, --config=windows en Windows, etc.
- Se acumulan
--experimental_credential_helper=<An (unresolved) path to a credential helper for a scope.>
usos múltiples - Configura el auxiliar de credenciales que se usará a fin de recuperar credenciales para el permiso proporcionado (dominio). Las credenciales de los auxiliares de credenciales tienen prioridad sobre las de <code>--google_default_credentials</code>, `--google_credentials` o <code>.netrc</code>. Consulta https://github.com/bazelbuild/proposals/blob/main/designs/2022-06-07-bazel-credential-helpers.md para obtener más detalles.
- Valor predeterminado de
--experimental_credential_helper_cache_duration=<An immutable length of time.>
: "30 m" - Configura la duración de las credenciales que se almacenan en caché las credenciales de los auxiliares de credenciales. La invocación con un valor diferente ajustará la vida útil de las entradas preexistentes; pasa cero para borrar la caché. Un comando limpio siempre borra la caché, sin importar esta marca.
--experimental_credential_helper_timeout=<An immutable length of time.>
predeterminado: "5 s"- Configura el tiempo de espera para el auxiliar de credenciales. Los auxiliares de credenciales que no respondan en este tiempo de espera fallarán la invocación.
- Valor predeterminado de
--[no]experimental_skymeld_ui
: “falso” -
Muestra el progreso de la fase de análisis y ejecución cuando ambos se ejecutan en simultáneo.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]experimental_windows_watchfs
: “falso” - Si es verdadero, está habilitada la compatibilidad experimental de Windows con --watchfs. De lo contrario, --watchfsis es una no-op en Windows. Asegúrate de habilitar también --watchfs.
--google_auth_scopes=<comma-separated list of options>
predeterminado: “https://www.googleapis.com/auth/cloud-platform”- Una lista separada por comas de los permisos de autenticación de Google Cloud.
--google_credentials=<a string>
predeterminado: ver descripción- Especifica el archivo del que se obtendrán las credenciales de autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más detalles.
- Valor predeterminado de
--[no]google_default_credentials
: “falso” - Determina si se deben usar las “credenciales predeterminadas de la aplicación de Google” en la autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más detalles. Inhabilitada de forma predeterminada.
--grpc_keepalive_time=<An immutable length of time.>
predeterminado: ver descripción- Configura pings keep-alive para conexiones de gRPC salientes. Si se configura, Bazel envía pings después de este tiempo sin operaciones de lectura en la conexión, pero solo si hay al menos una llamada de gRPC pendiente. Los horarios se tratan como segundo nivel de detalle; es un error establecer un valor inferior a un segundo. De forma predeterminada, los pings keep-alive están inhabilitados. Debes coordinar con el propietario del servicio antes de habilitar esta configuración. Por ejemplo, para establecer un valor de 30 segundos en esta marca, se debe hacer de la siguiente manera: grpc_keepalive_time=30s
- Valor predeterminado de
--grpc_keepalive_timeout=<An immutable length of time.>
: "20 s" - Configura un tiempo de espera de keep-alive para las conexiones salientes de gRPC. 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 tratan como segundo nivel de detalle; es un error establecer un valor inferior a un segundo. Si los pings keep-alive están inhabilitados, se ignora esta configuración.
--[no]incompatible_disallow_symlink_file_to_dir
predeterminado: “verdadero”-
Si se establece como verdadera, `ctx.actions.symlink` no permitirá la vinculación simbólica de un archivo a un directorio.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_rule_name_parameter
predeterminado: “verdadero”-
Si se configura como verdadero, no se puede llamar a `rule` con el parámetro `name`.
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]progress_in_terminal_title
: “falso” - Muestra el progreso del comando en el título de la terminal. Es útil para ver lo que hace Bazel cuando tiene varias pestañas de terminal.
--[no]show_progress
predeterminado: “verdadero”- Muestra mensajes de progreso durante una compilación.
- Valor predeterminado de
--show_progress_rate_limit=<a double>
: “0.2” - Es la cantidad mínima de segundos entre los mensajes de progreso en el resultado.
- Valor predeterminado de
--[no]show_timestamps
: “falso” - Incluir marcas de tiempo en los mensajes
--tls_certificate=<a string>
predeterminado: ver descripción- Especifica una ruta de acceso a un certificado TLS que sea de confianza para firmar los certificados de servidor.
--tls_client_certificate=<a string>
predeterminado: ver descripción- Especifica el certificado de cliente de TLS que se usará. También debes proporcionar una clave de cliente para habilitar la autenticación del cliente.
--tls_client_key=<a string>
predeterminado: ver descripción- Especifica la clave de cliente de TLS que se usará. También debes proporcionar un certificado de cliente para habilitar la autenticación del cliente.
--ui_actions_shown=<an integer>
predeterminado: "8"-
Cantidad de acciones simultáneas que se muestran en la barra de progreso detallada; cada acción se muestra en una línea separada. La barra de progreso siempre muestra al menos uno, y todos los números menores que 1 se asignan a 1.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]watchfs
: “falso” - En Linux/macOS, si es verdadero, Bazel intenta usar el servicio de observación de archivos del sistema operativo para los cambios locales en lugar de analizar cada archivo en busca de un cambio. En Windows: actualmente, esta marca no es operativa, pero se puede habilitar junto con --experimental_windows_watchfs. En cualquier SO: El comportamiento no está definido si su lugar de trabajo está en un sistema de archivos de red y los archivos se editan en una máquina remota.
Opciones de análisis del perfil
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Puedes buscar archivos adicionales antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]experimental_repository_cache_hardlinks
: “falso” -
Si se configura, la caché del repositorio vinculará el archivo en caso de un acierto de caché, en lugar de copiarlo. Esto está destinado a ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]experimental_repository_cache_urls_as_default_canonical_id
: “falso” -
Si es verdadero, usa una string derivada de las URL de las descargas del repositorio como el canonical_id si no se especifica. Esto hace que un cambio en las URL provoque una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no generen la máscara de caché de los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
- Valor predeterminado de
--[no]experimental_repository_disable_download
: “falso” - 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 configura en 0, los reintentos están inhabilitados.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark según este factor. De esta manera, los repositorios externos pueden funcionar en máquinas que son más lentas de lo que espera el autor de la regla, sin cambiar el código fuente
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas HTTP mediante el factor determinado
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: ver descripción-
Especifica la ubicación de la 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 forma estricta en que Bazel aplica las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etc.):
--experimental_repository_hash_file=<a string>
predeterminado: ""-
Si el campo no está vacío, especifica un archivo que contiene un valor resuelto, en el que se deben verificar los hash del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan
--experimental_verify_repository_rules=<a string>
usos múltiples - Si la lista de reglas del repositorio para la que se debe verificar el hash del directorio de salida, siempre que --experimental_repository_hash_file proporcione un archivo
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o de la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: “verdadero”-
No-op
Etiquetas:no_op
,deprecated
,experimental
- Opciones relacionadas con los resultados y la semántica de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Se especificaron las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran en un registro del origen del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones con bloqueos harán que falle la resolución. También puedes definir una versión ya permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puede inhabilitar esta comprobación con la palabra clave "todo" (no se recomienda).
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
: "Error" -
Comprueba la compatibilidad de los módulos de Bazel con la versión 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 detecta una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "warning"-
Comprueba si las dependencias directas de "bazel_dep" declaradas en el módulo raíz son las mismas que se muestran en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la comprobación, "warning" para mostrar una advertencia cuando se detecta una discrepancia o "error" para escalarla a una falla de resolución.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]ignore_dev_dependency
: “falso” -
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declaradas como "dev_dependency" en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev se ignoran siempre en MODULE.bazel si no es el módulo raíz independientemente del valor de esta marca.
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 un directorio local.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en registros anteriores y solo volverán a los registros 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
] predeterminado: ver la descripción- : Vuelca los datos del perfil completo en formato de "texto" legible o mediante el formato "sin procesar" apto para secuencias de comandos.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]experimental_record_metrics_for_all_mnemonics
: “falso” - De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 nombres con la mayor cantidad de acciones ejecutadas. Si se establece esta opción, se escribirán estadísticas para todos los mnemónicos.
- Opciones para especificar o alterar una entrada genérica en un comando de Bazel que no se encuentre en otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si el archivo resuelto 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é remotas:
--experimental_downloader_config=<a string>
predeterminado: ver descripción- Especifica un archivo para configurar la descarga remota. Este archivo consta de líneas y cada una comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para coincidir y uno para usar como URL sustituta. Las referencias inversas comienzan desde "$1". Es posible que se muestren varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias.
- Varias opciones, sin otra categoría
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con un directorio local.
Opciones de consulta
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Puedes buscar archivos adicionales antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]experimental_repository_cache_hardlinks
: “falso” -
Si se configura, la caché del repositorio vinculará el archivo en caso de un acierto de caché, en lugar de copiarlo. Esto está destinado a ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]experimental_repository_cache_urls_as_default_canonical_id
: “falso” -
Si es verdadero, usa una string derivada de las URL de las descargas del repositorio como el canonical_id si no se especifica. Esto hace que un cambio en las URL provoque una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no generen la máscara de caché de los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
- Valor predeterminado de
--[no]experimental_repository_disable_download
: “falso” - 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 configura en 0, los reintentos están inhabilitados.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark según este factor. De esta manera, los repositorios externos pueden funcionar en máquinas que son más lentas de lo que espera el autor de la regla, sin cambiar el código fuente
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas HTTP mediante el factor determinado
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: ver descripción-
Especifica la ubicación de la 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 forma estricta en que Bazel aplica las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etc.):
--experimental_repository_hash_file=<a string>
predeterminado: ""-
Si el campo no está vacío, especifica un archivo que contiene un valor resuelto, en el que se deben verificar los hash del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan
--experimental_verify_repository_rules=<a string>
usos múltiples - Si la lista de reglas del repositorio para la que se debe verificar el hash del directorio de salida, siempre que --experimental_repository_hash_file proporcione un archivo
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o de la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: “verdadero”-
No-Tags:no_op
,deprecated
,experimental
- Opciones relacionadas con el resultado de la consulta y la semántica:
- Valor predeterminado de
--aspect_deps=<off, conservative or precise>
: “conservadora” - Cómo resolver dependencias de aspecto cuando el formato de salida es {xml,proto,record}. "Apagado" significa que no se resuelven dependencias de aspecto, "conservadora" (predeterminada) significa que se agregan todas las dependencias de aspecto declaradas, independientemente de si se le otorga la clase de regla de dependencias directas. "Precisa" significa que solo se agregan esos aspectos que posiblemente estén activos según la clase de regla de las dependencias directas. Ten en cuenta que el modo preciso requiere que se carguen otros paquetes para evaluar un único destino, lo que lo hace más lento que los otros modos. También ten en cuenta que el modo incluso 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 'consulta de Bazel'.
Etiquetas:build_file_semantics
--[no]deduplicate_depsets
predeterminado: “verdadero”- Anula el duplicado de los elementos secundarios que no son de hoja de un archivo dep_set_of_files en el resultado final de proto/textproto/json. Esto no anula los duplicados que no comparten un superior inmediato. Esto no afecta la lista efectiva final de artefactos de entrada de las acciones.
Etiquetas:terminal_output
--[no]graph:factored
predeterminado: “verdadero”-
Si es verdadero, el grafo se emitirá como “factorizado”, es decir, los nodos con una equivalencia topológica equivalente se combinarán y sus etiquetas se concatenarán. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
- Valor predeterminado de
--graph:node_limit=<an integer>
: “512” - La longitud máxima de la string de la etiqueta para un nodo del grafo en el resultado. Las etiquetas más largas se truncarán. Si el valor es -1, no se truncará. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--[no]implicit_deps
predeterminado: “verdadero”- Si se habilita esta opción, se incluirán las dependencias implícitas en el gráfico de dependencias sobre el que opera la consulta. Una dependencia implícita no se especifica de forma explícita en el archivo BUILD, pero se agrega mediante Bazel. Para cquery, esta opción controla el filtrado de las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
--[no]include_artifacts
predeterminado: “verdadero”-
Incluye nombres de las entradas y salidas de acción en la salida (posiblemente grande).
Etiquetas:terminal_output
--[no]include_aspects
predeterminado: “verdadero”-
query, cquery: si se deben incluir acciones generadas por aspectos en el resultado. query: no-op (los aspectos siempre se siguen).
Etiquetas:terminal_output
--[no]include_commandline
predeterminado: “verdadero”-
Incluye el contenido de las líneas de comandos de la acción en el resultado (posiblemente grande).
Etiquetas:terminal_output
- Valor predeterminado de
--[no]include_file_write_contents
: “falso” -
Incluye el contenido del archivo para las acciones FileWrite y SourceSymlinkManifest (posiblemente grandes).
Etiquetas:terminal_output
- Valor predeterminado de
--[no]include_param_files
: “falso” - Incluye el contenido de los archivos de parámetros que se usan en el comando (posiblemente grande). Nota: Si habilita esta marca, se habilitará automáticamente la marca --include_commandline.
Etiquetas:terminal_output
--[no]incompatible_display_source_file_location
predeterminado: “verdadero”- Verdadero y predeterminado, 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
--[no]incompatible_package_group_includes_double_slash
predeterminado: “verdadero”-
Si se habilita, no se omitirá el "//" inicial del resultado del atributo `packages` del paquete package_group.
Etiquetas:terminal_output
,incompatible_change
- Valor predeterminado de
--[no]infer_universe_scope
: “falso” - Si no se configura y --universe_scope, se deducirá un valor de --universe_scope como la lista de patrones de destino únicos en la expresión de consulta. Ten en cuenta que el valor --universe_scope inferido para una expresión de consulta que usa funciones con alcance universal (p.ej., "allrdeps") puede no ser lo que deseas, por lo que debes usar esta opción solo si sabes lo que estás haciendo. Consulta https://bazel.build/query/language#sky-query para conocer los detalles y ejemplos. Si --universe_scope se establece, se ignora el valor de esta opción. Nota: Esta opción solo se aplica a `query` (es decir, no `cquery`).
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]line_terminator_null
: “falso” -
Indica si cada formato termina con \0 en lugar de saltos de línea.
Etiquetas:terminal_output
--[no]nodep_deps
predeterminado: “verdadero”- Si está habilitada, las dependencias de los atributos “nodep” se incluirán en el gráfico de dependencia sobre el que opera la consulta. Un ejemplo común de atributo “nodep” es la “visibilidad”. Ejecuta y analiza el resultado de "info build-language" para conocer todos los atributos "nodep" del lenguaje de compilación.
Etiquetas:build_file_semantics
--output=<a string>
predeterminado: "texto"- El formato en el que se deben imprimir los resultados de la consulta. Los valores permitidos para una consulta son texto, textoproto, proto y jsonproto.
Etiquetas:terminal_output
--[no]proto:default_values
predeterminado: “verdadero”-
Si es verdadero, se incluyen los atributos cuyo valor no se especifica de forma explícita en el archivo BUILD. De lo contrario, se omiten. Esta opción se aplica a --output=proto
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:definition_stack
: “falso” -
Propaga el campo de protocolo de definiciones_stack, que registra cada instancia de las reglas, la pila de llamadas de Starlark en el momento en que se definió la clase de la regla.
Etiquetas:terminal_output
--[no]proto:flatten_selects
predeterminado: “verdadero”-
Si están habilitados, los atributos configurables creados por select() se acoplan. Para los tipos de lista, la representación plana es una lista que contiene cada valor del mapa seleccionado exactamente una vez. Los tipos de escalar se aplanan en un valor nulo.
Etiquetas:build_file_semantics
- Valor predeterminado de
--[no]proto:include_synthetic_attribute_hash
: “falso” -
Indica si se debe calcular y propagar el atributo $internal_attr_hash.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:instantiation_stack
: “falso” -
Propaga la pila de llamadas de creación de instancias de cada regla. Ten en cuenta que esto requiere que la pila esté presente.
Etiquetas:terminal_output
--[no]proto:locations
predeterminado: “verdadero”-
Indica si se debe generar información de ubicación en el resultado del protocolo.
Etiquetas:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
predeterminado: "todos"-
Lista de atributos separados por comas que se incluirán en el resultado. La configuración predeterminada es todos los atributos. Configúralo como una string vacía para no generar ningún atributo. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
--[no]proto:rule_inputs_and_outputs
predeterminado: “verdadero”-
Indica si se deben propagar o no los campos rule_input y rule_output.
Etiquetas:terminal_output
--query_file=<a string>
predeterminado: ""- Si se establece, la consulta leerá la consulta del archivo nombrado aquí, en lugar de hacerlo en la línea de comandos. Es un error especificar aquí un archivo, así como una consulta de línea de comandos.
Etiquetas:changes_inputs
- Valor predeterminado de
--[no]relative_locations
: “falso” -
Si es verdadero, la ubicación de los archivos BUILD en los resultados XML y proto será relativa. De forma predeterminada, el resultado de ubicación es una ruta absoluta y no será coherente entre las máquinas. Puedes establecer esta opción como verdadera para obtener un resultado coherente en todas las máquinas.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]skyframe_state
: “falso” -
Sin realizar análisis adicionales, vuelca el gráfico de acciones actual de Skyframe. Nota: Actualmente, no se admite la especificación de un destino con --skyframe_state. Esta marca solo está disponible con --output=proto o --output=textproto.
Etiquetas:terminal_output
--[no]tool_deps
predeterminado: “verdadero”- Consulta: Si está inhabilitada, las dependencias de los objetivos de “configuración del host” o “ejecución” no se incluirán en el gráfico de dependencias sobre el que opera la consulta. Una arista de dependencia de “configuración de host”, como la de cualquier regla de “proto_library” al compilador de protocolo, suele apuntar a una herramienta ejecutada durante la compilación en lugar de ser parte del mismo programa de “destino”.
Consulta: Si se inhabilita, se filtran 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 en la configuración de destino. Si el destino de nivel superior está en la configuración del host, solo se mostrarán los objetivos configurados por el host. Esta opción NO excluirá los conjuntos de herramientas resueltos.
Etiquetas:build_file_semantics
--universe_scope=<comma-separated list of options>
predeterminado: ""- Un conjunto de patrones de destino separados por comas (aditivos y sustractivos). La consulta se puede realizar en el universo definido por el cierre transitivo de los destinos especificados. Esta opción se usa para los comandos query y cquery.
Para cquery, la entrada a esta opción es el destino en el que se compilan todas las respuestas, por lo que esta opción puede afectar la configuración y las transiciones. Si no se especifica esta opción, se supone que los objetivos de nivel superior son los objetivos analizados desde la expresión de consulta. Nota: En el caso de cquery, si no se especifica esta opción, la compilación puede fallar si los objetivos analizados de la expresión de consulta no se pueden compilar con opciones de nivel superior.
Etiquetas:loading_and_analysis
- Opciones relacionadas con la salida y la semántica de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Se especificaron las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran en un registro del origen del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones con bloqueos harán que falle la resolución. También puedes definir una versión ya permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puede inhabilitar esta comprobación con la palabra clave "todo" (no se recomienda).
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
: "Error" -
Comprueba la compatibilidad de los módulos de Bazel con la versión 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 detecta una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "warning"-
Comprueba si las dependencias directas de "bazel_dep" declaradas en el módulo raíz son las mismas que se muestran en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la comprobación, "warning" para mostrar una advertencia cuando se detecta una discrepancia o "error" para escalarla a una falla de resolución.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]ignore_dev_dependency
: “falso” -
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declaradas como "dev_dependency" en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev se ignoran siempre en MODULE.bazel si no es el módulo raíz independientemente del valor de esta marca.
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 un directorio local.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en registros anteriores y solo volverán a los registros posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Valor predeterminado de
--[no]experimental_record_metrics_for_all_mnemonics
: “falso” - De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 nombres con la mayor cantidad de acciones ejecutadas. Si se establece esta opción, se escribirán estadísticas para todos los mnemónicos.
- Opciones para especificar o alterar una entrada genérica en un comando de Bazel que no se encuentre en otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si el archivo resuelto 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é remotas:
--experimental_downloader_config=<a string>
predeterminado: ver descripción- Especifica un archivo para configurar la descarga remota. Este archivo consta de líneas y cada una comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para coincidir y uno para usar como URL sustituta. Las referencias inversas comienzan desde "$1". Es posible que se muestren varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias.
- Varias opciones, sin otra categoría
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con un directorio local.
- Opciones para controlar la ejecución de la compilación:
- Valor predeterminado de
--[no]experimental_inprocess_symlink_creation
: “falso” -
Determina si se deben realizar llamadas directas al sistema de archivos para crear árboles de enlaces simbólicos.
Etiquetas:loading_and_analysis
,execution
,experimental
- Valor predeterminado de
--[no]experimental_remotable_source_manifests
: “falso” -
Determina si se deben realizar acciones remotas en el manifiesto de origen.
Etiquetas:loading_and_analysis
,execution
,experimental
- Valor predeterminado de
--[no]experimental_split_coverage_postprocessing
: “falso” -
Si es verdadero, Bazel ejecutará el procesamiento posterior de la cobertura para pruebas en un nuevo campo de generación.
Etiquetas:execution
- Valor predeterminado de
--[no]experimental_strict_fileset_output
: “falso” - Si esta opción está habilitada, los conjuntos de archivos tratarán todos los artefactos de salida como archivos normales. No desvían directorios ni son sensibles a los symlinks.
Etiquetas:execution
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
predeterminado: ""- Agrega o quita claves de la información de ejecución de una acción según la actividad nemotécnica. 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 se pueden aplicar muchas regex a la misma mnemónica.
Sintaxis: "regex=[+-]clave,regex=[+-]clave,...".
Ejemplos: ".*=+x,.*=-y,.*=+z" agrega "x" y "z" a la información de ejecución de todas las acciones, y la quita "y".
"Genrule=+require-x" agrega "require-x" a la información de ejecución para todas las acciones de Genrule.
“(?!Genrule).*=-require-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 acciones persistentes de dex y desugaring con trabajadores.
Se expande a:
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
- Habilita el procesador de recursos persistentes de Android mediante el uso de 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
{1/2}{1/2} --persistent_multiplex_android_dex_desugar
- Habilita las acciones de dex multiplexas persistentes y las acciones de expansión de sintaxis mediante el uso de trabajadores.
Se expande a:
--persistent_android_dex_desugar
--modify_execution_info=Desugar=+supports-multiplex-workers
--modify_execution_info=DexBuilder=+supports-multiplex-workers
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
- Habilita el procesador de recursos multiplexado persistente de Android mediante el uso de 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
{1/2}{1/2} --persistent_multiplex_android_tools
- Habilita herramientas de Android persistentes y multiplexadas (dexing, expansión de sintaxis y procesamiento de recursos).
Se expande a:
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Etiquetas:host_machine_resource_optimizations
,execution
- Opciones que configuran la cadena de herramientas que se usa para ejecutar la acción:
--android_compiler=<a string>
predeterminado: ver descripción-
El compilador de destino de Android
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Valor predeterminado de
--android_crosstool_top=<a build target label>
: "//external:android/crosstool" -
La ubicación del compilador C++ que se usó para las compilaciones de Android.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_grte_top=<a label>
predeterminado: ver descripción- El destino androidte: grte_top
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
- Valor predeterminado de
--android_manifest_merger=<legacy, android or force_android>
: "android" -
Selecciona la combinación de manifiestos que se usará para las reglas de android_binary. Marca para ayudar a la transición a la fusión de manifiesto de Android desde la fusión heredada.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_platforms=<a build target label>
predeterminado: ""-
Configura las plataformas que usan los objetivos de android_binary. Si se especifican varias plataformas, el objeto binario es un APK multiarquitectura, que contiene objetos binarios nativos para cada plataforma de destino especificada.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_sdk=<a build target label>
predeterminado: "@bazel_tools//tools/android:sdk"-
Especifica la plataforma o el SDK de Android que se usa a fin de compilar aplicaciones para Android.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--apple_compiler=<a string>
predeterminado: 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”-
Es la etiqueta del paquete crosstool que se usará en las reglas de Apple y Objc, y sus dependencias.
Etiquetas:loses_incremental_state
,changes_inputs
--apple_grte_top=<a build target label>
predeterminado: ver descripción-
El objetivo de grte_top de Apple.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--cc_output_directory_tag=<a string>
predeterminado: ""-
Especifica un sufijo para agregarlo al directorio de configuración.
Etiquetas:affects_outputs
,explicit_in_output_path
--compiler=<a string>
predeterminado: ver descripción- El compilador 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"-
Es la ubicación del objeto binario que se usa para procesar con anterioridad los informes de cobertura sin procesar. Actualmente, debe ser un grupo de archivos que contenga un solo archivo (el objeto binario). La configuración predeterminada es “//tools/test:lcov_merger”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
- Valor predeterminado de
--coverage_report_generator=<a build target label>
: “@bazel_tools//tools/test:coverage_report_generator” -
Es la ubicación del objeto binario que se usa para generar los informes de cobertura. Actualmente, debe ser un grupo de archivos que contenga un solo archivo (el objeto binario). La configuración predeterminada es “//tools/test:coverage_report_generator”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
- Valor predeterminado de
--coverage_support=<a build target label>
: "@bazel_tools//tools/test:coverage_support" -
Ubicación de los archivos de asistencia obligatorios en las entradas de cada acción de prueba que recopila la cobertura del 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 crosstool que se usará para compilar el código C++.
Etiquetas:loading_and_analysis
,changes_inputs
,affects_outputs
--custom_malloc=<a build target label>
predeterminado: ver descripción-
Especifica una implementación personalizada de malloc. Esta 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 destino no coincide con ninguna expresión negativa y al menos una expresión positiva, la resolución de su cadena de herramientas se realizará como si hubiera declarado los valores de restricción como restricciones de ejecución. Ejemplo: //demo,-test=@platforms//cpus:x86_64 agregará 'x86_64' a cualquier destino en //demo, excepto aquellos cuyo nombre contenga 'test'.
Etiquetas:loading_and_analysis
--[no]experimental_enable_objc_cc_deps
predeterminado: “verdadero”-
Permite que las reglas objc_* dependan de cc_library y haga que las dependencias objc se compilen con --cpu establecido en "ios_<--ios_cpu>" para cualquier valor en --ios_multi_cpu.
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]experimental_include_xcode_execution_requirements
: “falso” -
Si se configura, agrega un requisito de ejecución "require-xcode:{version}" a cada acción de Xcode. Si la versión xcode tiene una etiqueta con guion, agrega también un requisito de ejecución “require-xcode-label:{version_label}.
Etiquetas:loses_incremental_state
,loading_and_analysis
,execution
--[no]experimental_prefer_mutual_xcode
predeterminado: “verdadero”-
Si es verdadero, usa el Xcode más reciente que esté disponible de forma local y remota. Si es falso, o si no hay versiones mutuas disponibles, utiliza 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 - Las plataformas que están disponibles como plataformas de ejecución para ejecutar acciones. Las plataformas pueden especificarse por objetivo exacto o como un patrón de destino. Se considerarán estas plataformas antes de las que se declaran en el archivo WORKSPACE mediante register_execution_platforms().
Etiquetas:execution
- Se acumulan
--extra_toolchains=<comma-separated list of options>
usos múltiples - Las reglas de la cadena de herramientas se deben tener en cuenta durante su resolución. Las cadenas de herramientas se pueden especificar mediante un objetivo exacto o como un patrón de destino. Estas cadenas de herramientas se tendrán en cuenta antes de las que se registraron en el archivo WORKSPACE.
--grte_top=<a label>
predeterminado: ver descripción-
Etiqueta a una biblioteca libc registrada. El conjunto de herramientas Crosstool selecciona el valor predeterminado, y casi nunca es necesario anularlo.
Etiquetas:action_command_lines
,affects_outputs
--host_compiler=<a string>
predeterminado: ver descripción-
El compilador C++ que se usará en la compilación del host. Se ignora si no se establece --host_crosstool_top.
Etiquetas:loading_and_analysis
,execution
--host_crosstool_top=<a build target label>
predeterminado: 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 determinada.
Etiquetas:loading_and_analysis
,changes_inputs
,affects_outputs
--host_grte_top=<a label>
predeterminado: ver descripción- Si se especifica, esta configuración anula el directorio de nivel superior de libc (--grte_top) para la configuración del host.
Etiquetas:action_command_lines
,affects_outputs
--host_platform=<a build target label>
predeterminado: ""- Es la etiqueta de una regla de plataforma que describe el sistema host.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--[no]incompatible_disable_expand_if_all_available_in_flag_set
predeterminado: “verdadero”-
Si es verdadero, Bazel no permitirá especificar expand_if_all_available en flag_sets(consulte https://github.com/bazelbuild/bazel/issues/7008 para obtener instrucciones de migración).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
predeterminado: “verdadero”-
Si es verdadero, Bazel no habilitará las funciones "host" y "nonhost" en la cadena de herramientas de c++ (consulte https://github.com/bazelbuild/bazel/issues/7407 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]incompatible_enable_android_toolchain_resolution
: “falso” -
Usa la resolución de la cadena de herramientas a fin de seleccionar el SDK de Android para las reglas de Android (Starlark y nativo)
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]incompatible_enable_apple_toolchain_resolution
: “falso” -
Usa la resolución de la cadena de herramientas con el fin de seleccionar el SDK de Apple para las reglas de Apple (nativo y Starlark)
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone
predeterminado: “verdadero”-
Si es verdadero, Bazel no volverá a usar las líneas de comandos de la acción de vínculo de C++ para las líneas de comandos de indexación de lto (consulte https://github.com/bazelbuild/bazel/issues/6791 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]incompatible_objc_linking_info_migration
: “falso” -
Si es verdadero, las reglas integradas de ObjC obtendrán su información de vinculación desde CcInfo en lugar de ObjcProvider. Consulta https://github.com/bazelbuild/bazel/issues/16939 para obtener más detalles y detalles sobre la migración.
Etiquetas:loading_and_analysis
,changes_inputs
,incompatible_change
--[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain
predeterminado: “verdadero”-
Si es verdadero, Bazel se quejará cuando se establezcan los atributos cc_toolchain.cpu y cc_toolchain.compiler (consulte https://github.com/bazelbuild/bazel/issues/7075 para obtener instrucciones de migración).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_legacy_whole_archive
predeterminado: “verdadero”-
Si es verdadero, Bazel no vinculará las dependencias de la biblioteca como archivo completo de forma predeterminada (consulte https://github.com/bazelbuild/bazel/issues/7362 para obtener instrucciones de migración).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_require_ctx_in_configure_features
predeterminado: “verdadero”-
Si es verdadero, Bazel requerirá el parámetro “ctx” en cc_common.configure_features (consulte 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 son compatibles con la cadena de herramientas. Todas las cadenas de herramientas de ELF actualmente admiten esta configuración.
Etiquetas:loading_and_analysis
,affects_outputs
,affects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: ver descripción-
Especifica la versión del SDK de iOS que se usará para compilar aplicaciones para iOS. Si no se especifica, se usa la versión predeterminada del SDK de iOS a partir de "xcode_version".
Etiquetas:loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: ver descripción-
Especifica la versión del SDK de macOS que se usará para compilar las aplicaciones para macOS. Si no se especifica, se usa la versión predeterminada del SDK de macOS de 'xcode_version'.
Etiquetas:loses_incremental_state
--minimum_os_version=<a string>
predeterminado: ver descripción-
Es la versión mínima del SO a la que se orienta tu compilación.
Etiquetas:loading_and_analysis
,affects_outputs
--platform_mappings=<a relative path>
predeterminado: ""-
La ubicación de un archivo de asignación que describe qué plataforma usar si no se configuró ninguna o qué marcas establecer cuando ya existe una plataforma. Debe estar relacionado con la raíz del espacio de trabajo principal. La configuración predeterminada es “platform_mappings” (un archivo ubicado directamente en la raíz del espacio de trabajo).
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--platforms=<a build target label>
predeterminado: ""-
Las etiquetas de las reglas de la plataforma que describen las plataformas de destino del comando actual.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--python2_path=<a string>
predeterminado: ver descripción-
Obsoleto, no-op. Inhabilitado por `--incompatible_use_python_toolchains`.
Etiquetas:no_op
,deprecated
--python3_path=<a string>
predeterminado: ver descripción-
Obsoleto, no-op. Inhabilitado por `--incompatible_use_python_toolchains`.
Etiquetas:no_op
,deprecated
--python_path=<a string>
predeterminado: ver descripción- La ruta de acceso absoluta del intérprete de Python invocada para ejecutar destinos de Python en la plataforma de destino. Obsoleto; inhabilitado por --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
--python_top=<a build target label>
predeterminado: ver descripción-
Es la etiqueta de un py_runtime que representa al 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
- Valor predeterminado de
--target_platform_fallback=<a build target label>
: “@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 se asigna el conjunto actual de marcas.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: 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
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: 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 desde 'xcode_version'.
Etiquetas:loses_incremental_state
--xcode_version=<a string>
predeterminado: ver descripción-
Si se especifica, usa Xcode de la versión determinada para las acciones de compilación relevantes. Si no se especifica, se usa la versión predeterminada de Xcode para ejecutar.
Etiquetas:loses_incremental_state
- Valor predeterminado de
--xcode_version_config=<a build target label>
: "@bazel_tools//tools/cpp:host_xcodes" -
Es la etiqueta de la regla xcode_config que se usará para seleccionar la versión de Xcode en la configuración de compilación.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Opciones que controlan el resultado del comando:
- Valor predeterminado de
--[no]apple_enable_auto_dsym_dbg
: “falso” -
Determina si se fuerza la habilitación de la generación de archivos de símbolos de depuración (.dSYM) para las compilaciones dbg.
Etiquetas:affects_outputs
,action_command_lines
- Valor predeterminado de
--[no]apple_generate_dsym
: “falso” -
Indica si se deben generar archivos de símbolos de depuración (.dSYM).
Etiquetas:affects_outputs
,action_command_lines
--[no]build_runfile_links
predeterminado: “verdadero”-
Si es verdadero, compila bosques de archivos de symlink de runfiles para todos los destinos. Si es falso, escriba solo los manifiestos cuando sea posible.
Etiquetas:affects_outputs
--[no]build_runfile_manifests
predeterminado: “verdadero”-
Si es verdadero, escribe manifiestos de archivos de ejecución para todos los destinos. Si es falso, omítelo. Las pruebas locales no se ejecutarán cuando sean falsas.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]build_test_dwp
: “falso” -
Si se habilita, cuando se compilen pruebas de C++ de manera estática y con fisiones, también se compilará automáticamente el archivo .dwp para los objetos binarios de las pruebas.
Etiquetas:loading_and_analysis
,affects_outputs
- Valor predeterminado de
--cc_proto_library_header_suffixes=<comma-separated list of options>
: “.pb.h” -
Establece los prefijos de los archivos de encabezado que crea una cc_proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
- Valor predeterminado de
--cc_proto_library_source_suffixes=<comma-separated list of options>
: “.pb.cc” -
Establece los prefijos de los archivos de origen que crea una cc_proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
- Valor predeterminado de
--[no]experimental_proto_descriptor_sets_include_source_info
: “falso” - Ejecuta acciones adicionales para versiones de API alternativas de Java en una proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
- Valor predeterminado de
--[no]experimental_proto_extra_actions
: “falso” - Ejecuta acciones adicionales para versiones de API alternativas de Java en una proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
- Valor predeterminado de
--[no]experimental_save_feature_state
: “falso” - Guarda el estado de las funciones habilitadas y solicitadas como resultado de una compilación.
Etiquetas:affects_outputs
,experimental
--fission=<a set of compilation modes>
predeterminado: "no".-
Especifica los modos de compilación que usan fisión para las compilaciones y los vínculos de C++. Puede ser cualquier combinación de {'fastbuild', 'dbg', 'opt'} o los valores especiales 'yes' para habilitar todos los modos y 'no' para inhabilitar todos los modos.
Etiquetas:loading_and_analysis
,action_command_lines
,affects_outputs
--[no]incompatible_always_include_files_in_data
predeterminado: “verdadero”-
Si es verdadero, las reglas nativas agregan <code>DefaultInfo.files</code> de las dependencias de datos a sus archivos runfile, lo que coincide con el comportamiento recomendado para las reglas de Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid).
Etiquetas:affects_outputs
,incompatible_change
--[no]legacy_external_runfiles
predeterminado: “verdadero”-
Si es verdadero, compile bosques de symlink de runfiles para repositorios externos en .runfiles/wsname/external/repo (además de .runfiles/repo).
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]objc_generate_linkmap
: “falso” -
Especifica si se debe generar un archivo de mapa de vínculos.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]save_temps
: “falso” -
Si se configura, se guardarán los resultados temporales de gcc. Entre estos archivos, se incluyen los archivos .s (código ensamblador), los archivos .i (C preprocesados) y los archivos .ii (C++ procesados).
Etiquetas:affects_outputs
- Opciones que permiten que el usuario configure el resultado deseado y afecte su valor, a diferencia de su existencia:
- Se acumulan
--action_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica el conjunto de variables de entorno disponibles para las acciones con la configuración objetivo. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación o por el par nombre=valor que establece el valor independientemente del entorno de invocación. Esta opción se puede utilizar varias veces. En el caso de las opciones proporcionadas para la misma variable, las últimas victorias se acumulan, las opciones para las diferentes variables se acumulan.
Etiquetas:action_command_lines
- Valor predeterminado de
--android_cpu=<a string>
: “armeabi-v7a” -
La CPU de destino de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Valor predeterminado de
--[no]android_databinding_use_androidx
: “falso” -
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
,experimental
- Valor predeterminado de
--[no]android_databinding_use_v3_4_args
: “falso” -
Usa la vinculación de datos de Android v2 con el argumento 3.4.0
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--android_dynamic_mode=<off, default or fully>
predeterminado: "desactivado"-
Determina si los dependencias de C++ de las reglas de Android se vincularán de forma dinámica cuando un cc_binary no cree explícitamente una biblioteca compartida. "default" significa que Bazel elegirá si se vincula de forma dinámica. "completamente" significa que todas las bibliotecas se vincularán de forma dinámica. "Desactivada" significa que todas las bibliotecas estarán vinculadas en su mayoría en modo estático.
Etiquetas:affects_outputs
,loading_and_analysis
- Valor predeterminado de
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
: "alfabético". -
Establece el orden de los manifiestos que se pasan a la combinación de manifiestos para los objetos binarios de Android. ALFABÉTICO significa que los manifiestos se ordenan según la ruta de acceso en relación con la ejecución de reglas. ALPHABETICAL_BY_CONFIGURATION significa que los manifiestos se ordenan según las rutas de acceso relativas al directorio de configuración dentro del directorio de salida. DEPENDENCY significa que los manifiestos se ordenan con cada manifiesto de la biblioteca antes que los manifiestos de sus dependencias.
Etiquetas:action_command_lines
,execution
- Valor predeterminado de
--[no]android_resource_shrinking
: “falso” -
Habilita la reducción de recursos para APK 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, 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 la forma “[platform=]mode”, en la 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 para 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
--[no]build_python_zip
predeterminado: "automático"-
Compila el ZIP ejecutable 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 cuales crear objetos binarios de Catalyst de Apple.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Valor predeterminado de
--[no]collect_code_coverage
: “falso” -
Si se especifica, Bazel instrumentará el código (mediante la instrumentación sin conexión) 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 se debe especificar directamente; en su lugar, se debe usar el comando “bazelcover”.
Etiquetas:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] predeterminado: "fastbuild"-
Especifica el modo en que se compilará el objeto binario. Valores: “fastbuild”, “dbg”, “opt”.
Etiquetas:affects_outputs
,action_command_lines
,explicit_in_output_path
- Se acumulan
--conlyopt=<a string>
usos múltiples -
Opción adicional de 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
--cs_fdo_absolute_path=<a string>
predeterminado: ver descripción-
Usa la información del perfil de CSFDO para optimizar la compilación. Especifica el nombre de ruta de acceso absoluta del archivo ZIP que contiene el archivo de perfil, un archivo de perfil de LLVM sin procesar o indexado.
Etiquetas:affects_outputs
--cs_fdo_instrument=<a string>
predeterminado: ver descripción-
Genera objetos binarios con instrumentación de FDO contextual. Con el compilador de Clang/LLVM, también acepta el nombre del directorio bajo el cual se volcarán los archivos del perfil sin procesar en el tiempo de ejecución.
Etiquetas:affects_outputs
--cs_fdo_profile=<a build target label>
predeterminado: 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 -
Opción adicional de 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 de definición especifica una asignación para una variable de compilación.
Etiquetas:changes_inputs
,affects_outputs
--dynamic_mode=<off, default or fully>
predeterminado: “predeterminado”-
Determina si los objetos binarios de C++ se vincularán de forma dinámica. "predeterminado" significa que Bazel elegirá si desea vincular de forma dinámica. "completamente" significa que todas las bibliotecas se vincularán de forma dinámica. "Desactivada" significa que todas las bibliotecas estarán vinculadas en su mayoría en modo estático.
Etiquetas:loading_and_analysis
,affects_outputs
--[no]enable_fdo_profile_absolute_path
predeterminado: “verdadero”-
Si se establece, el uso de fdo_absolute_profile_path generará un error.
Etiquetas:affects_outputs
--[no]enable_runfiles
predeterminado: "automático"- Habilitar el árbol de symlink de runfiles; de forma predeterminada, está desactivado en Windows y en otras plataformas.
Etiquetas:affects_outputs
- Se acumulan
--experimental_action_listener=<a build target label>
usos múltiples - Obsoleto y reemplaza los aspectos. Usa action_listener para adjuntar una acción adicional a las acciones de compilación existentes.
Etiquetas:execution
,experimental
- Valor predeterminado de
--[no]experimental_android_compress_java_resources
: “falso” -
Comprime los recursos de Java en los APK
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
- Valor predeterminado de
--[no]experimental_android_databinding_v2
: “falso” -
Usa la vinculación de datos de Android v2
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Valor predeterminado de
--[no]experimental_android_resource_shrinking
: “falso” -
Habilita la reducción de recursos para APK de android_binary que usan ProGuard.
Etiquetas:affects_outputs
,loading_and_analysis
- Valor predeterminado de
--[no]experimental_android_rewrite_dexes_with_rex
: “falso” -
Usa la herramienta rex para reescribir archivos dex.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--experimental_objc_fastbuild_options=<comma-separated list of options>
predeterminado: "-O0,-DDEBUG=1"- Usa estas strings como opciones de compilador de objc fastbuild.
Etiquetas:action_command_lines
- Valor predeterminado de
--[no]experimental_omitfp
: “falso” - Si es verdadero, usa libunwind para desenrollar la pila y compila con -fomit-frame-pointer y -fasíncrona-unwind-tables.
Etiquetas:action_command_lines
,affects_outputs
,experimental
- Valor predeterminado de
--[no]experimental_platform_in_output_dir
: “falso” - Si es verdadero, la plataforma de destino se usa en el nombre del directorio de salida, en lugar de en la CPU.
Etiquetas:affects_outputs
,experimental
- Valor predeterminado de
--[no]experimental_use_llvm_covmap
: “falso” -
Si se especifica, Bazel generará información de mapa de cobertura llvm-cov en lugar de gcov cuando se habilite collect_code_coverage.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
- Valor predeterminado de
--fat_apk_cpu=<comma-separated list of options>
: “armeabi-v7a” -
Si configuras esta opción, se habilitan los APK multiarquitectura, que contienen objetos binarios nativos para todas las arquitecturas de destino especificadas, p.ej., --fat_apk_cpu=x86,armeabi-v7a. Si se especifica esta marca, se ignora --android_cpu para las dependencias de reglas de android_binary.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Valor predeterminado de
--[no]fat_apk_hwasan
: “falso” - Determina si se deben crear divisiones de HWASAN.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--fdo_instrument=<a string>
predeterminado: ver descripción- Genera objetos binarios con instrumentación de FDO. Con el compilador de Clang/LLVM, también acepta el nombre del directorio bajo el cual se volcarán los archivos del perfil sin procesar en el tiempo de ejecución.
Etiquetas:affects_outputs
--fdo_optimize=<a string>
predeterminado: ver descripción-
Usa la información de perfil de FDO para optimizar la compilación. Especifica el nombre de un archivo ZIP que contenga un árbol de archivos .gcda, un archivo Afdo que contenga un perfil automático o un archivo de perfil LLVM. Esta marca también acepta archivos especificados como etiquetas (p.ej., "//foo/bar:file.afdo"), es posible que debas agregar una directiva "exports_files" al paquete correspondiente) y etiquetas que apunten a objetivos "fdo_profile". Esta marca se reemplazará por la regla "fdo_profile".
Etiquetas:affects_outputs
--fdo_prefetch_hints=<a build target label>
predeterminado: ver descripción-
Usa sugerencias de precarga de caché.
Etiquetas:affects_outputs
--fdo_profile=<a build target label>
predeterminado: ver descripción- El fdo_profile que representa el perfil que se usará para la optimización.
Etiquetas:affects_outputs
- Se acumulan
--features=<a string>
usos múltiples -
Las funciones proporcionadas se habilitarán o inhabilitarán de forma predeterminada para todos los paquetes. Si especificas -<feature>, se inhabilitará la función globalmente. Los elementos negativos siempre anulan a los positivos. Esta marca se usa para habilitar la implementación de cambios de funciones predeterminadas sin una versión de Bazel.
Etiquetas:changes_inputs
,affects_outputs
- Valor predeterminado de
--[no]force_pic
: “falso” -
Si se habilita, todas las compilaciones de C++ producen código independiente de posición ("-fPIC"), los vínculos prefieren las bibliotecas compiladas previamente de PIC en lugar de las bibliotecas que no son de PIC, y los vínculos producen ejecutables independientes de posición ("-pie").
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan
--host_action_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica el conjunto de variables de entorno disponibles para las acciones con configuraciones de host o ejecución. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación o por el par nombre=valor que establece el valor independientemente del entorno de invocación. Esta opción se puede utilizar varias veces. En el caso de las opciones proporcionadas para la misma variable, las últimas victorias se acumulan, las opciones para las diferentes variables se acumulan.
Etiquetas:action_command_lines
- Valor predeterminado de
--host_compilation_mode=<fastbuild, dbg or opt>
: "optar" - Especifica el modo en que se incorporarán las herramientas que se usarán durante la compilación. Valores: “fastbuild”, “dbg”, “opt”.
Etiquetas:affects_outputs
,action_command_lines
- Se acumulan
--host_conlyopt=<a string>
usos múltiples -
Opción adicional para pasar al compilador C cuando compilas archivos de origen C (pero no de C++) en las configuraciones de host o ejecución.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--host_copt=<a string>
usos múltiples -
Opciones adicionales que se pasan al compilador C para las herramientas compiladas en la configuración del host o la ejecución.
Etiquetas:action_command_lines
,affects_outputs
--host_cpu=<a string>
predeterminado: ""-
La CPU host.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan
--host_cxxopt=<a string>
usos múltiples -
Opciones adicionales que se pasan al compilador C++ para herramientas compiladas en las configuraciones de host o ejecución.
Etiquetas:action_command_lines
,affects_outputs
--host_force_python=<PY2 or PY3>
predeterminado: 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 -
Opción adicional de pasar al vinculador cuando se vinculan herramientas en la configuración del host o la ejecución.
Etiquetas:action_command_lines
,affects_outputs
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: ver descripción-
Versión mínima compatible de macOS para las orientaciones del host. Si no se especifica, se usa “macos_sdk_version”.
Etiquetas:loses_incremental_state
- Se acumulan
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
usos múltiples -
Opciones adicionales para pasar de forma selectiva al compilador C/C++ cuando se compilan determinados archivos en la configuración del host o la ejecución. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Cuando regex_filter representa una lista de incluir y excluir patrones de expresión regular (también consulta --instrumentation_filter). option_1 a option_n significa opciones de línea de comandos arbitrarias. Si una opción contiene una coma, se debe incluir una barra invertida. Las opciones pueden contener el símbolo @. Solo se usa el primer símbolo @ para dividir la string. 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 de las herramientas del host
Etiquetas:action_command_lines
,affects_outputs
--[no]incompatible_avoid_conflict_dlls
predeterminado: “verdadero”-
Si está habilitada, se cambiará el nombre de todas las bibliotecas dinámicas vinculadas a C++ (DLL) generadas por cc_library en Windows a name_{hash}.dll, en las que el hash se calcula en función del repositorio RepositoryName y la ruta de acceso del paquete de la DLL. Esta opción es útil cuando tienes un paquete que depende de varias cc_library con el mismo nombre (p. ej., //foo/bar1:utils y //foo/bar2:utils).
Etiquetas:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_merge_genfiles_directory
predeterminado: “verdadero”-
Si es verdadero, el directorio genfiles se pliega en el directorio bin.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_use_platforms_repo_for_constraints
predeterminado: “verdadero”-
Si es verdadero, se quita la configuración de restricciones de @bazel_tools.
Etiquetas:affects_outputs
,incompatible_change
- Valor predeterminado de
--[no]instrument_test_targets
: “falso” - Cuando la cobertura está habilitada, especifica si se deben considerar instrumentar reglas de prueba. Cuando se configura, se instrumentan las reglas de prueba incluidas por --instrumentation_filter. De lo contrario, las reglas de prueba siempre se excluyen de la instrumentación de cobertura.
Etiquetas:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
predeterminado: "-/javatests[/:],-/test/java[/:]"- Cuando la cobertura está habilitada, solo se instrumentarán las reglas con nombres incluidos por el filtro basado en regex especificado. En su lugar, se excluyen las reglas con el prefijo “-”. Ten en cuenta que solo se instrumentan las reglas que no son de prueba, a menos que esté habilitada la herramienta --instrument_test_targets.
Etiquetas:affects_outputs
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: ver descripción-
Versión mínima compatible de iOS para simuladores y dispositivos de destino. Si no se especifica, se usa “ios_sdk_version”.
Etiquetas:loses_incremental_state
- Se acumulan
--ios_multi_cpus=<comma-separated list of options>
usos múltiples - Lista de arquitecturas separadas por comas para crear una aplicación de ios_application. El resultado es un objeto binario universal que contiene todas las arquitecturas especificadas.
Etiquetas:loses_incremental_state
,loading_and_analysis
--[no]legacy_whole_archive
predeterminado: “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 esté activada, use --all-archive para las reglas de cc_binary que tengan linkshared=True y linklink=True o '-static' en linkopts. Esto es solo para retrocompatibilidad. Una mejor alternativa es usar siemprelink=1 cuando sea necesario.
Etiquetas:action_command_lines
,affects_outputs
,deprecated
- Se acumulan
--linkopt=<a string>
usos múltiples -
Opción adicional de pasar a gcc durante la vinculación.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--ltobackendopt=<a string>
usos múltiples -
Opción adicional para pasar al paso de backend de LTO (en --features=thin_lto).
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--ltoindexopt=<a string>
usos múltiples -
Opción adicional para pasar al paso de indexación de LTO (en --features=thin_lto).
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--macos_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se pueden compilar los objetos binarios de macOS de Apple.
Etiquetas:loses_incremental_state
,loading_and_analysis
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: ver descripción-
Versión de macOS mínima compatible para los objetivos. Si no se especifica, se usa “macos_sdk_version”.
Etiquetas:loses_incremental_state
- Valor predeterminado de
--[no]objc_debug_with_GLIBCXX
: “falso” -
Si se configura, y el modo de compilación se configura en "dbg", defina GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC y GLIBCPP_CONCEPT_CHECKS.
Etiquetas:action_command_lines
- Valor predeterminado de
--[no]objc_enable_binary_stripping
: “falso” -
Determina si se deben quitar los símbolos y códigos no entregados de los objetos binarios vinculados. Se realizará la eliminación de objetos binarios si se especifican tanto esta marca como --compilation_mode=opt.
Etiquetas:action_command_lines
- Se acumulan
--objccopt=<a string>
usos múltiples -
Opciones adicionales para pasar a GCC cuando se compilan archivos de origen de Objective-C/C++.
Etiquetas:action_command_lines
- Se acumulan
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
usos múltiples -
Opciones adicionales para pasar de forma selectiva a gcc cuando se compilan determinados archivos Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Cuando regex_filter representa una lista de incluir y excluir patrones de expresión regular (también consulta --instrumentation_filter). option_1 a option_n significa opciones de línea de comandos arbitrarias. Si una opción contiene una coma, se debe incluir una barra invertida. Las opciones pueden contener el símbolo @. Solo se usa el primer símbolo @ para dividir la string. Ejemplo: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de la 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 determinados objetos de backend. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter representa una lista de incluir y excluir patrones de expresión regular. option_1 a option_n significa opciones de línea de comandos arbitrarias. Si una opción contiene una coma, se debe incluir una barra invertida. Las opciones pueden contener el símbolo @. Solo se usa el primer símbolo @ para dividir la string. Ejemplo: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 agrega la opción de la línea de comandos -O0 a la línea de comandos del backend de LTO de todos los archivos o en //foo/, excepto bar.o.
Etiquetas:action_command_lines
,affects_outputs
--platform_suffix=<a string>
predeterminado: ver descripción-
Especifica un sufijo para agregarlo al directorio de configuración.
Etiquetas:loses_incremental_state
,affects_outputs
,loading_and_analysis
--propeller_optimize=<a build target label>
predeterminado: ver descripción- Usa la información del perfil de propulsor para optimizar el destino de la compilación.Un perfil de propulsor debe tener al menos uno de dos archivos, uno de Cc y uno de ld. Este indicador 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 en a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)Es posible que se deba agregar una directiva export_files al paquete correspondiente para que Bazel pueda ver estos archivos. La opción se debe usar como: --propeller_optimize=//a/b:propeller_profile
Etiquetas:action_command_lines
,affects_outputs
--propeller_optimize_absolute_cc_profile=<a string>
predeterminado: ver descripción-
Nombre de ruta de acceso absoluta del archivo cc_profile para las compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
predeterminado: ver descripción-
Nombre de ruta de acceso absoluta del archivo ld_profile para las compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
--run_under=<a prefix in front of command>
predeterminado: ver descripción-
Prefijo que se debe insertar antes de los archivos ejecutables para los comandos "test" y "run". Si el valor es "foo -bar" y la línea de comandos de ejecución es "test_binary -baz", la línea de comandos final es "foo -bar test_binary -baz". También puede ser una etiqueta para un destino ejecutable. Algunos ejemplos son: 'valgrind', 'strace', 'strace -c', 'valgrind --quiet --num-callers=20', '//package:target', '//package:target --options'.
Etiquetas:action_command_lines
-
Si el valor es verdadero, las bibliotecas nativas que contienen una funcionalidad idéntica se compartirán entre diferentes destinos
Etiquetas:loading_and_analysis
,affects_outputs
- Valor predeterminado de
--[no]stamp
: “falso” -
Sella los objetos binarios con la fecha, el nombre de usuario, el nombre de host, la información del lugar de trabajo, etc.
Etiquetas:affects_outputs
- Valor predeterminado de
--strip=<always, sometimes or never>
: "A veces" -
Especifica si se quitarán los objetos binarios y las bibliotecas compartidas (mediante "-Wl,--strip-debug"). El valor predeterminado de “a veces” significa quitar el valor de iff --compilation_mode=fastbuild.
Etiquetas:affects_outputs
- Se acumulan
--stripopt=<a string>
usos múltiples -
Opciones adicionales para pasar a la eliminación cuando se genera un objeto binario “<name>.stripped”.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--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 pueden compilar objetos binarios de tvOS de Apple.
Etiquetas:loses_incremental_state
,loading_and_analysis
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: ver descripción-
Versión mínima compatible de tvOS con los simuladores y dispositivos de destino. Si no se especifica, se usa “tvos_sdk_version”.
Etiquetas:loses_incremental_state
- Se acumulan
--watchos_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para crear objetos binarios de watchOS de Apple.
Etiquetas:loses_incremental_state
,loading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: ver descripción-
Versión de watchOS mínima compatible para dispositivos y simuladores de destino. Si no se especifica, se usa “watchos_sdk_version”.
Etiquetas:loses_incremental_state
--xbinary_fdo=<a build target label>
predeterminado: ver descripción-
Usa la información de perfil de XbinaryFDO para optimizar la compilación. Especifica el nombre del perfil binario cruzado predeterminado. Cuando la opción se usa junto con --fdo_instrument/--fdo_optimize/--fdo_profile, esas opciones siempre prevalecerán como si xbinary_fdo nunca se especifique.
Etiquetas:affects_outputs
- Opciones que afectan la forma estricta en que Bazel aplica las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etc.):
--auto_cpu_environment_group=<a build target label>
predeterminado: ""- Declara el entorno para que los valores de CPU se asignen automáticamente a los valores de target_environment.
Etiquetas:changes_inputs
,loading_and_analysis
,experimental
- Valor predeterminado de
--[no]check_licenses
: “falso” -
Verifica que las restricciones de licencias que imponen los paquetes dependientes no entren en conflicto con los modos de distribución de los destinos que se están compilando. De forma predeterminada, las licencias no están verificadas.
Etiquetas:build_file_semantics
--[no]check_visibility
predeterminado: “verdadero”-
Si se inhabilita, los errores de visibilidad en las dependencias de destino descienden a advertencias.
Etiquetas:build_file_semantics
--[no]desugar_for_android
predeterminado: “verdadero”-
Determina si el código de bytes Java 8 debe expandirse de sintaxis antes de la conversión a dex.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Valor predeterminado de
--[no]desugar_java8_libs
: “falso” -
Indica si se deben incluir bibliotecas de Java 8 compatibles en apps para dispositivos heredados.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]enforce_constraints
predeterminado: “verdadero”-
Verifica los entornos compatibles con cada destino y, luego, informa los errores si algún destino tiene dependencias que no admiten los mismos entornos.
Etiquetas:build_file_semantics
- Valor predeterminado de
--[no]experimental_allow_android_library_deps_without_srcs
: “falso” -
Marca para ayudar a hacer la transición para permitir que se inhabiliten las reglas android_library de srcs-less con deps. El depósito debe limpiarse para que se implemente de forma predeterminada.
Etiquetas:eagerness_to_exit
,loading_and_analysis
--[no]experimental_check_desugar_deps
predeterminado: “verdadero”-
Determina si se debe volver a comprobar la expansión de sintaxis correcta en el nivel binario de Android.
Etiquetas:eagerness_to_exit
,loading_and_analysis
,experimental
- Valor predeterminado de
--experimental_import_deps_checking=<off, warning or error>
: "DESACTIVADO" -
Cuando está habilitada, comprueba si las dependencias de aar_import están completas. Esta aplicación puede romper la compilación o puede simplemente generar advertencias.
Etiquetas:loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
predeterminado: “predeterminado”-
Si es verdadero, comprueba que un destino de Java declare explícitamente todos los destinos usados directamente como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
- Valor predeterminado de
--[no]incompatible_check_testonly_for_output_files
: “falso” -
Si está habilitada, verifica solo los objetivos de requisitos previos que son archivos de salida mediante la búsqueda de la regla de generación de prueba. Esto coincide con la verificación de visibilidad.
Etiquetas:build_file_semantics
,incompatible_change
- Valor predeterminado de
--[no]incompatible_disable_native_android_rules
: “falso” -
Si se habilita, se inhabilita el uso directo de las reglas nativas de Android. Usa las reglas de Starlark para Android en https://github.com/bazelbuild/rules_android
Etiquetas:eagerness_to_exit
,incompatible_change
- Valor predeterminado de
--[no]incompatible_disable_native_apple_binary_rule
: “falso” -
No hay relación. Se mantiene aquí para garantizar la retrocompatibilidad.
Etiquetas:eagerness_to_exit
,incompatible_change
--[no]incompatible_force_strict_header_check_from_starlark
predeterminado: “verdadero”-
Si está habilitada, establezca una verificación de encabezados estricta en la API de Starlark
Etiquetas:loading_and_analysis
,changes_inputs
,incompatible_change
--[no]incompatible_validate_top_level_header_inclusions
predeterminado: “verdadero”-
Si es verdadero, Bazel también validará las inclusiones de encabezados de directorio de nivel superior (consulte https://github.com/bazelbuild/bazel/issues/10047 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]strict_filesets
: “falso” - Si se habilita esta opción, los conjuntos de archivos que crucen los límites del paquete se informarán como errores. No funciona cuando se inhabilita check_fileset_dependencies_recursively.
Etiquetas:build_file_semantics
,eagerness_to_exit
- Valor predeterminado de
--strict_proto_deps=<off, warn, error, strict or default>
: "Error" - A menos que esté DESACTIVADA, se verifica que un destino proto_library declare explícitamente todos los destinos usados directamente como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
--strict_public_imports=<off, warn, error, strict or default>
predeterminado: "desactivado"- A menos que esté DESACTIVADA, verifica que un destino proto_library declare explícitamente todos los destinos que se usan en "import public" como exportados.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
- Valor predeterminado de
--[no]strict_system_includes
: “falso” - 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:
- Valor predeterminado de
--apk_signing_method=<v1, v2, v1_v2 or v4>
: “v1_v2” -
Implementación para usar en la firma de APK
Etiquetas:action_command_lines
,affects_outputs
,loading_and_analysis
--[no]device_debug_entitlements
predeterminado: “verdadero”-
Si se configura y el modo de compilación no es “opt”, las apps de objc incluirán derechos de depuración al firmar.
Etiquetas:changes_inputs
--ios_signing_cert_name=<a string>
predeterminado: ver descripción-
Es el nombre del certificado que se usará para la firma de iOS. Si no se configura, se recurrirá al perfil de aprovisionamiento. Puede ser la preferencia de identidad del llavero del certificado o (substring) del nombre común del certificado, según la página de manual del 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 a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.
--[no]incompatible_disallow_legacy_py_provider
predeterminado: “verdadero”-
No-op se quitará en breve.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones que rigen el comportamiento del entorno de pruebas o del ejecutor de pruebas:
- Valor predeterminado de
--[no]allow_analysis_failures
: “falso” -
Si es verdadero, un error de análisis de un objetivo de regla da como resultado la propagación del destino de una instancia de AnalysisFailureInfo que contiene la descripción del error, en lugar de un error de compilación.
Etiquetas:loading_and_analysis
,experimental
- Valor predeterminado de
--analysis_testing_deps_limit=<an integer>
: “2,000” -
Establece la cantidad máxima de dependencias transitivas a través de un atributo de regla con una transición de configuración de for_analysis_testing. Si superas este límite, se producirá un error de la regla.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]break_build_on_parallel_dex2oat_failure
: “falso” -
Si las fallas de acción dex2oat son verdaderas, la compilación fallará en lugar de ejecutar dex2oat durante el tiempo de ejecución de la prueba.
Etiquetas:loading_and_analysis
,experimental
- Valor predeterminado de
--[no]experimental_android_use_parallel_dex2oat
: “falso” -
Usa dex2oat en paralelo para acelerar android_test.
Etiquetas:loading_and_analysis
,host_machine_resource_optimizations
,experimental
- Valor predeterminado de
--[no]ios_memleaks
: “falso” - Habilita la comprobación de fugas de memoria en objetivos de ios_test.
Etiquetas:action_command_lines
--ios_simulator_device=<a string>
predeterminado: ver descripción-
Es el dispositivo que se va a simular cuando se ejecuta una aplicación para iOS en el simulador, p.ej., “iPhone 6”. Para obtener una lista de los dispositivos, ejecute "xcrun simctl list devicetypes" en la máquina en la que se ejecutará el simulador.
Etiquetas:test_runner
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: ver descripción-
Es la versión de iOS que se ejecutará en el simulador al ejecutar o realizar pruebas. Esto se ignora para las reglas de ios_test si se especifica un dispositivo de destino en la regla.
Etiquetas:test_runner
- Se acumulan
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
usos múltiples - Especifica la cantidad de veces que se debe ejecutar cada prueba. Si alguno de esos intentos falla por cualquier motivo, la prueba completa se considera errónea. Por lo general, el valor especificado es solo un número entero. Ejemplo: --runs_per_test=3 ejecutará todas las pruebas 3 veces. Sintaxis alternativa: regex_filter@runs_per_test. En el que se ejecuta run_per_test, un valor entero y regex_filter representa una lista de patrones de expresión incluidos y excluidos. También consulta --instrumentation_filter. Ejemplo: --runs_per_test=//foo/.*,-//foo/bar/.*@3 ejecuta todas las pruebas en //foo/ excepto las de foo/bar tres veces. Esta opción se puede pasar varias veces. El argumento pasado más reciente que coincide tiene prioridad. Si no hay coincidencias, la prueba solo se ejecuta una vez.
- Se acumulan
--test_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica las 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 se leerá su valor desde el entorno de cliente de Bazel o por el par nombre=valor. Esta opción se puede utilizar varias veces para especificar varias variables. Solo se usa en el comando “bazel test”.
Etiquetas:test_runner
--test_timeout=<a single integer or comma-separated list of 4 integers>
predeterminado: "-1"- Anula los valores de tiempo de espera de prueba predeterminados para los tiempos de espera de prueba (en segundos). Si se especifica un solo número entero positivo, se anularán todas las categorías. Si se especifican 4 números enteros separados por comas, anularán los tiempos de espera para valores cortos, moderados, largos y eternos (en ese orden). En cualquier forma, un valor de -1 le indica a blaze que use los tiempos de espera predeterminados para esa categoría.
--tvos_simulator_device=<a string>
predeterminado: ver descripción-
Es el dispositivo que se simulará cuando se ejecute una aplicación tvOS en el simulador, p.ej., “Apple TV 1080p”. Para obtener una lista de los dispositivos, ejecute "xcrun simctl list devicetypes" en la máquina en la que se ejecutará el simulador.
Etiquetas:test_runner
--tvos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: ver descripción-
Es la versión de tvOS que se ejecutará en el simulador cuando se ejecute o se realice una prueba.
Etiquetas:test_runner
--watchos_simulator_device=<a string>
predeterminado: ver descripción-
Es el dispositivo que se debe simular cuando se ejecuta una aplicación watchOS en el simulador, p.ej., “Apple Watch - 38 mm”. Para obtener una lista de los dispositivos, ejecute "xcrun simctl list devicetypes" en la máquina en la que se ejecutará el simulador.
Etiquetas:test_runner
--watchos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: ver descripción-
Es la versión de watchOS que se ejecuta en el simulador cuando se ejecuta o se realiza una prueba.
Etiquetas:test_runner
--[no]zip_undeclared_test_outputs
predeterminado: “verdadero”-
Si es verdadero, los resultados de las pruebas no declaradas se archivarán en un archivo ZIP.
Etiquetas:test_runner
- Opciones relacionadas con el resultado de la consulta y la semántica:
- Valor predeterminado de
--aspect_deps=<off, conservative or precise>
: “conservadora” - Cómo resolver dependencias de aspecto cuando el formato de salida es {xml,proto,record}. "Apagado" significa que no se resuelven dependencias de aspecto, "conservadora" (predeterminada) significa que se agregan todas las dependencias de aspecto declaradas, independientemente de si se le otorga la clase de regla de dependencias directas. "Precisa" significa que solo se agregan esos aspectos que posiblemente estén activos según la clase de regla de las dependencias directas. Ten en cuenta que el modo preciso requiere que se carguen otros paquetes para evaluar un único destino, lo que lo hace más lento que los otros modos. También ten en cuenta que el modo incluso 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 'consulta de Bazel'.
Etiquetas:build_file_semantics
--[no]deduplicate_depsets
predeterminado: “verdadero”- Anula el duplicado de los elementos secundarios que no son de hoja de un archivo dep_set_of_files en el resultado final de proto/textproto/json. Esto no anula los duplicados que no comparten un superior inmediato. Esto no afecta la lista efectiva final de artefactos de entrada de las acciones.
Etiquetas:terminal_output
--[no]graph:factored
predeterminado: “verdadero”-
Si es verdadero, el grafo se emitirá como “factorizado”, es decir, los nodos con una equivalencia topológica equivalente se combinarán y sus etiquetas se concatenarán. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
- Valor predeterminado de
--graph:node_limit=<an integer>
: “512” - La longitud máxima de la string de la etiqueta para un nodo del grafo en el resultado. Las etiquetas más largas se truncarán. Si el valor es -1, no se truncará. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--[no]implicit_deps
predeterminado: “verdadero”- Si se habilita esta opción, se incluirán las dependencias implícitas en el gráfico de dependencias sobre el que opera la consulta. Una dependencia implícita no se especifica de forma explícita en el archivo BUILD, pero se agrega mediante Bazel. Para cquery, esta opción controla el filtrado de las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
--[no]include_artifacts
predeterminado: “verdadero”-
Incluye nombres de las entradas y salidas de acción en la salida (posiblemente grande).
Etiquetas:terminal_output
--[no]include_aspects
predeterminado: “verdadero”-
query, cquery: si se deben incluir acciones generadas por aspectos en el resultado. query: no-op (los aspectos siempre se siguen).
Etiquetas:terminal_output
--[no]include_commandline
predeterminado: “verdadero”-
Incluye el contenido de las líneas de comandos de la acción en el resultado (posiblemente grande).
Etiquetas:terminal_output
- Valor predeterminado de
--[no]include_file_write_contents
: “falso” -
Incluye el contenido del archivo para las acciones FileWrite y SourceSymlinkManifest (posiblemente grandes).
Etiquetas:terminal_output
- Valor predeterminado de
--[no]include_param_files
: “falso” - Incluye el contenido de los archivos de parámetros que se usan en el comando (posiblemente grande). Nota: Si habilita esta marca, se habilitará automáticamente la marca --include_commandline.
Etiquetas:terminal_output
--[no]incompatible_display_source_file_location
predeterminado: “verdadero”- Verdadero y predeterminado, 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
--[no]incompatible_package_group_includes_double_slash
predeterminado: “verdadero”-
Si se habilita, no se omitirá el "//" inicial del resultado del atributo `packages` del paquete package_group.
Etiquetas:terminal_output
,incompatible_change
- Valor predeterminado de
--[no]infer_universe_scope
: “falso” - Si no se configura y --universe_scope, se deducirá un valor de --universe_scope como la lista de patrones de destino únicos en la expresión de consulta. Ten en cuenta que el valor --universe_scope inferido para una expresión de consulta que usa funciones con alcance universal (p.ej., "allrdeps") puede no ser lo que deseas, por lo que debes usar esta opción solo si sabes lo que estás haciendo. Consulta https://bazel.build/query/language#sky-query para conocer los detalles y ejemplos. Si --universe_scope se establece, se ignora el valor de esta opción. Nota: Esta opción solo se aplica a `query` (es decir, no `cquery`).
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]line_terminator_null
: “falso” -
Indica si cada formato termina con \0 en lugar de saltos de línea.
Etiquetas:terminal_output
--[no]nodep_deps
predeterminado: “verdadero”- Si está habilitada, las dependencias de los atributos “nodep” se incluirán en el gráfico de dependencia sobre el que opera la consulta. Un ejemplo común de atributo “nodep” es la “visibilidad”. Ejecuta y analiza el resultado de "info build-language" para conocer todos los atributos "nodep" del lenguaje de compilación.
Etiquetas:build_file_semantics
--output=<a string>
predeterminado: "texto"- El formato en el que se deben imprimir los resultados de la consulta. Los valores permitidos para una consulta son texto, textoproto, proto y jsonproto.
Etiquetas:terminal_output
--[no]proto:default_values
predeterminado: “verdadero”-
Si es verdadero, se incluyen los atributos cuyo valor no se especifica de forma explícita en el archivo BUILD. De lo contrario, se omiten. Esta opción se aplica a --output=proto
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:definition_stack
: “falso” -
Propaga el campo de protocolo de definiciones_stack, que registra cada instancia de las reglas, la pila de llamadas de Starlark en el momento en que se definió la clase de la regla.
Etiquetas:terminal_output
--[no]proto:flatten_selects
predeterminado: “verdadero”-
Si están habilitados, los atributos configurables creados por select() se acoplan. Para los tipos de lista, la representación plana es una lista que contiene cada valor del mapa seleccionado exactamente una vez. Los tipos de escalar se aplanan en un valor nulo.
Etiquetas:build_file_semantics
- Valor predeterminado de
--[no]proto:include_synthetic_attribute_hash
: “falso” -
Indica si se debe calcular y propagar el atributo $internal_attr_hash.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:instantiation_stack
: “falso” -
Propaga la pila de llamadas de creación de instancias de cada regla. Ten en cuenta que esto requiere que la pila esté presente.
Etiquetas:terminal_output
--[no]proto:locations
predeterminado: “verdadero”-
Indica si se debe generar información de ubicación en el resultado del protocolo.
Etiquetas:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
predeterminado: "todos"-
Lista de atributos separados por comas que se incluirán en el resultado. La configuración predeterminada es todos los atributos. Configúralo como una string vacía para no generar ningún atributo. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
--[no]proto:rule_inputs_and_outputs
predeterminado: “verdadero”-
Indica si se deben propagar o no los campos rule_input y rule_output.
Etiquetas:terminal_output
--query_file=<a string>
predeterminado: ""- Si se establece, la consulta leerá la consulta del archivo nombrado aquí, en lugar de hacerlo en la línea de comandos. Es un error especificar aquí un archivo, así como una consulta de línea de comandos.
Etiquetas:changes_inputs
- Valor predeterminado de
--[no]relative_locations
: “falso” -
Si es verdadero, la ubicación de los archivos BUILD en los resultados XML y proto será relativa. De forma predeterminada, el resultado de ubicación es una ruta absoluta y no será coherente entre las máquinas. Puedes establecer esta opción como verdadera para obtener un resultado coherente en todas las máquinas.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]skyframe_state
: “falso” -
Sin realizar análisis adicionales, vuelca el gráfico de acciones actual de Skyframe. Nota: Actualmente, no se admite la especificación de un destino con --skyframe_state. Esta marca solo está disponible con --output=proto o --output=textproto.
Etiquetas:terminal_output
--[no]tool_deps
predeterminado: “verdadero”- Consulta: Si está inhabilitada, las dependencias de los objetivos de “configuración del host” o “ejecución” no se incluirán en el gráfico de dependencias sobre el que opera la consulta. Una arista de dependencia de “configuración de host”, como la de cualquier regla de “proto_library” al compilador de protocolo, suele apuntar a una herramienta ejecutada durante la compilación en lugar de ser parte del mismo programa de “destino”.
Consulta: Si se inhabilita, se filtran 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 en la configuración de destino. Si el destino de nivel superior está en la configuración del host, solo se mostrarán los objetivos configurados por el host. Esta opción NO excluirá los conjuntos de herramientas resueltos.
Etiquetas:build_file_semantics
--universe_scope=<comma-separated list of options>
predeterminado: ""- Un conjunto de patrones de destino separados por comas (aditivos y sustractivos). La consulta se puede realizar en el universo definido por el cierre transitivo de los destinos especificados. Esta opción se usa para los comandos query y cquery.
Para cquery, la entrada a esta opción es el destino en el que se compilan todas las respuestas, por lo que esta opción puede afectar la configuración y las transiciones. Si no se especifica esta opción, se supone que los objetivos de nivel superior son los objetivos analizados desde la expresión de consulta. Nota: En el caso de cquery, si no se especifica esta opción, la compilación puede fallar si los objetivos analizados de la expresión de consulta no se pueden compilar con opciones de nivel superior.
Etiquetas:loading_and_analysis
- Opciones que activan optimizaciones del tiempo de compilación:
--[no]collapse_duplicate_defines
predeterminado: “verdadero”-
Cuando se habilita, la opción redundante --defines se quita al comienzo 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
- Valor predeterminado de
--[no]experimental_filter_library_jar_with_program_jar
: “falso” -
Filtra el ProgramPro de ProGuard para quitar cualquier clase que también esté presente en LibraryJar.
Etiquetas:action_command_lines
--[no]experimental_inmemory_dotd_files
predeterminado: “verdadero”- Si se habilita esta opción, los archivos C .D se pasarán a la memoria directamente desde los nodos de compilación remota, en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_inmemory_jdeps_files
predeterminado: “verdadero”-
Si se habilita, los archivos de dependencia (.jdeps) generados a partir de compilaciones de Java se pasarán a través de la memoria directamente desde los nodos de compilación remota, en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
,experimental
- Valor predeterminado de
--[no]experimental_objc_include_scanning
: “falso” -
Determina si se debe realizar una búsqueda para C/C++ objetivo.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
- Valor predeterminado de
--[no]experimental_parse_headers_skipped_if_corresponding_srcs_found
: “falso” -
Si está habilitada, la función parse_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
- Valor predeterminado de
--[no]experimental_retain_test_configuration_across_testonly
: “falso” -
Cuando se habilita, --trim_test_configuration no recortará la configuración de prueba de las reglas marcadas como testonly=1. Esto tiene como objetivo reducir los problemas de conflicto de acciones cuando las reglas que no son de prueba dependen de las reglas de cc_test. No tiene efecto si --trim_test_configuration es falsa.
Etiquetas:loading_and_analysis
,loses_incremental_state
- Valor predeterminado de
--[no]experimental_starlark_cc_import
: “falso” -
Si está habilitada, se puede usar la versión Starlark de cc_import.
Etiquetas:loading_and_analysis
,experimental
- Valor predeterminado de
--[no]experimental_unsupported_and_brittle_include_scanning
: “falso” -
Determina si se deben limitar las entradas a la compilación de C/C++ mediante el análisis de #include las líneas de los archivos de entrada. Esto puede mejorar el rendimiento y la incrementalidad, ya que disminuye el tamaño de los árboles de entrada de compilación. Sin embargo, también puede romper compilaciones porque el escáner de inclusión no implementa completamente la semántica del preprocesador de C. En particular, no comprende las directivas dinámicas de #include e ignora la lógica condicional del preprocesador. Úsalos bajo tu responsabilidad. Se cerrarán todos los problemas relacionados con esta marca que se presenten.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
--[no]incremental_dexing
predeterminado: “verdadero”-
Realiza la mayor parte del trabajo en la conversión a archivos dex por separado para cada archivo jar.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]objc_use_dotd_pruning
predeterminado: “verdadero”- Si se configura, los archivos .d emitidos por clang se usarán para reducir el conjunto de entradas que se pasan a las compilaciones objc.
Etiquetas:changes_inputs
,loading_and_analysis
- Valor predeterminado de
--[no]process_headers_in_dependencies
: “falso” -
Cuando se compila un destino //a:a, se deben procesar los encabezados en todos los destinos del que depende //a:a (si el procesamiento de encabezados está habilitado para la cadena de herramientas).
Etiquetas:execution
--[no]trim_test_configuration
predeterminado: “verdadero”-
Cuando se habilita, las opciones relacionadas con la prueba se borran debajo del nivel superior de la compilación. Cuando esta marca está activa, las pruebas no se pueden compilar como dependencias de reglas que no son de prueba, pero los cambios en las opciones relacionadas con la prueba no harán que se vuelvan a analizar las reglas que no son de prueba.
Etiquetas:loading_and_analysis
,loses_incremental_state
--[no]use_singlejar_apkbuilder
predeterminado: “verdadero”- Esta opción es obsoleta. Ahora es no-op y se quitará pronto.
Etiquetas:loading_and_analysis
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Valor predeterminado de
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "-.*" -
Imprime información de depuración durante la resolución de la cadena de herramientas. La marca toma una regex, que se verifica con los tipos de la cadena de herramientas y objetivos específicos para ver cuál depurar. Si hay varias regex, estas pueden separarse con comas y, luego, cada una se revisa por separado. Nota: El resultado de esta marca es muy complejo y es probable que solo sea útil para los expertos en la resolución de la cadena de herramientas.
Etiquetas:terminal_output
- Opciones para especificar o alterar una entrada genérica en un comando de Bazel que no se encuentre en otras categorías:
- Se acumulan
--flag_alias=<a 'name=value' flag alias>
usos múltiples -
Establece un nombre abreviado para las marcas de Starlark. Toma un solo par clave-valor con el formato "<key>=<value>" como argumento.
Etiquetas:changes_inputs
- Valor predeterminado de
--[no]incompatible_default_to_explicit_init_py
: “falso” -
Esta marca cambia el comportamiento predeterminado para que los archivos __init__.py ya no se creen automáticamente en los runfiles de los objetivos de Python. Precisamente, cuando un destino py_binary o py_test tiene la configuración heredada_create_init establecida en "automático" (la opción predeterminada), se considera falsa si solo se establece esta marca. Consulta https://github.com/bazelbuild/bazel/issues/10076.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_py2_outputs_are_suffixed
predeterminado: “verdadero”-
Si es verdadero, los destinos compilados en la configuración de Python 2 aparecerán en una raíz de salida que incluya el sufijo “-py2”, mientras que los objetivos 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 objetivos de Python 3 en lugar de a Python 2. Si habilitas esta opción, también se recomienda habilitar `--incompatible_py3_is_default`.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_py3_is_default
predeterminado: “verdadero”-
Si es verdadero, los objetivos “py_binary” y “py_test” que no definen el atributo “python_version” (o “default_python_version”) se establecerán de forma predeterminada como PY3 en lugar de PY2. Si configuras esta marca, también se recomienda establecer `--incompatible_py2_outputs_are_suffixed`.
Etiquetas:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_use_python_toolchains
predeterminado: “verdadero”-
Si se configura como verdadera, las reglas nativas ejecutables de Python usarán el entorno de ejecución de Python especificado en la cadena de herramientas de Python, en lugar del entorno de ejecución proporcionado por marcas heredadas como --python_top.
Etiquetas:loading_and_analysis
,incompatible_change
--python_version=<PY2 or PY3>
predeterminado: ver descripción-
Es el modo de la versión principal de Python, ya sea "PY2" o "PY3". Ten en cuenta que los destinos "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
- Otras opciones, sin otra categoría:
--[no]cache_test_results
[-t
] predeterminado: "auto"- Si se configura como “automática”, Bazel vuelve a ejecutar una prueba solo si: (1) Bazel detecta cambios en la prueba o sus dependencias, (2) la prueba se marcó como externa, (3) se solicitaron varias ejecuciones con --runs_per_test o(4) la prueba falló anteriormente. Si se configura como “sí”, Bazel almacena en caché todos los resultados, excepto las pruebas marcadas como externas. Si se configura como “no”, Bazel no almacena en caché ningún resultado de prueba.
- Valor predeterminado de
--[no]experimental_cancel_concurrent_tests
: “falso” -
Si es verdadero, Blaze cancelará las pruebas que se estén ejecutando de forma simultánea en la primera ejecución correcta. Esto solo es útil en combinación con --runs_per_test_detects_flakes.
Etiquetas:affects_outputs
,loading_and_analysis
- Valor predeterminado de
--[no]experimental_fetch_all_coverage_outputs
: “falso” -
Si es verdadero, Bazel recupera todo el directorio de datos de cobertura de cada prueba durante una ejecución de cobertura.
Etiquetas:affects_outputs
,loading_and_analysis
- Valor predeterminado de
--[no]experimental_generate_llvm_lcov
: “falso” -
Si es verdadero, la cobertura de jerga generará un informe de LCOV.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_j2objc_header_map
predeterminado: “verdadero”- Indica si se debe generar el mapa de encabezado de J2ObjC en paralelo a la transpilación de J2ObjC.
- Valor predeterminado de
--[no]experimental_j2objc_shorter_header_path
: “falso” -
Se debe generar con una ruta de encabezado más corta (usa "_ios" en lugar de "_j2objc").
Etiquetas:affects_outputs
- Valor predeterminado de
--experimental_java_classpath=<off, javabuilder or bazel>
: “javabuilder”. - Habilita rutas de clase reducidas para las compilaciones de Java.
- Valor predeterminado de
--[no]experimental_limit_android_lint_to_android_constrained_java
: “falso” -
Limita --experimental_run_android_lint_on_java_rules a las bibliotecas compatibles con Android.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]experimental_run_android_lint_on_java_rules
: “falso” - Determina si se deben validar las fuentes java_*.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]explicit_java_test_deps
: “falso” - Especifica explícitamente una dependencia a JUnit o Hamcrest en una java_test, en lugar de obtenerla accidentalmente de las dependencias de TestRunner. En este momento, solo funciona para bazel.
--host_java_launcher=<a build target label>
predeterminado: ver descripción- El selector de Java que usan las herramientas que se ejecutan durante una compilación.
- Se acumulan
--host_javacopt=<a string>
usos múltiples - Opciones adicionales para pasar a javac cuando se compilan herramientas que se ejecutan durante una compilación
- Se acumulan
--host_jvmopt=<a string>
usos múltiples - Opciones adicionales para pasar a la VM de Java cuando se compilan herramientas que se ejecutan durante la compilación. Estas opciones se agregarán a las opciones de inicio de VM de cada destino java_binary.
--[no]incompatible_exclusive_test_sandboxed
predeterminado: “verdadero”-
Si es verdadero, se ejecutarán pruebas exclusivas con una estrategia de zona de pruebas. Agrega la etiqueta “local” para forzar una ejecución de prueba exclusiva a nivel local
Etiquetas:incompatible_change
- Valor predeterminado de
--[no]incompatible_strict_action_env
: “falso” -
Si es verdadero, Bazel usa un entorno con un valor estático para PATH y no hereda LD_LIBRARY_PATH. Use --action_env=ENV_VARIABLE si desea heredar variables de entorno específicas del cliente, pero tenga en cuenta que, si lo hace, puede evitar el almacenamiento en caché entre usuarios si se utiliza 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. Implica -test_output=stream.
Se expande a:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
--[no]java_deps
predeterminado: “verdadero”- Genera información de dependencia (por ahora, ruta de clase de tiempo de compilación) por destino de Java.
--[no]java_header_compilation
predeterminado: “verdadero”- Compila los archivos JAR directamente desde la fuente.
--java_language_version=<a string>
predeterminado: ""- Versión de Java
--java_launcher=<a build target label>
predeterminado: ver descripción- El selector de Java que se usará para compilar objetos binarios de Java. Si esta marca se establece en la string vacía, se usa el iniciador de JDK. El atributo "launcher" anula esta marca.
- Valor predeterminado de
--java_runtime_version=<a string>
: “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 VM de cada destino java_binary.
--legacy_main_dex_list_generator=<a build target label>
predeterminado: ver descripción- Especifica un objeto binario para usar a fin de generar la lista de clases que deben estar en el DEX principal cuando se compila el multidex heredado.
- Se acumulan
--plugin=<a build target label>
usos múltiples - Complementos para usar en la compilación. Actualmente funciona con java_plugin.
--proguard_top=<a build target label>
predeterminado: ver descripción- Especifica qué versión de ProGuard usar para la eliminación de código cuando se compila un objeto binario de Java.
--proto_compiler=<a build target label>
predeterminado: “@bazel_tools//tools/proto:protoc”-
Es la etiqueta del proto-compilador.
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 los protocolos 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 los protocolos j2objc
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
predeterminado: “@bazel_tools//tools/proto:java_toolchain”-
Etiqueta de proto_lang_toolchain() que describe cómo compilar los protocolos de Java
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
predeterminado: “@bazel_tools//tools/proto:javalite_toolchain”-
Etiqueta de proto_lang_toolchain() que describe cómo compilar los protocolos de JavaLite
Etiquetas:affects_outputs
,loading_and_analysis
- Se acumulan
--protocopt=<a string>
usos múltiples -
Opciones adicionales para pasar al compilador protobuf.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]runs_per_test_detects_flakes
: “falso” - Si es verdadero, cualquier fragmento en el que pase al menos un intento de ejecución o intento y al menos uno de ellos falle y obtenga el estado FLAKY.
--shell_executable=<a path>
predeterminado: ver descripción-
Ruta de acceso absoluta al ejecutable de shell que puede usar Bazel. Si no está configurado, pero la variable de entorno BAZEL_SH se configura en la primera invocación de Bazel (que inicia un servidor de Bazel), Bazel la usa. Si no se configura ninguna de esas opciones, Bazel usa una ruta de acceso predeterminada codificada según el sistema operativo en el que se ejecute (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash: todos los demás: /bin/bash). Ten en cuenta que usar una shell que no sea compatible con Bash puede generar fallas de compilación o de tiempo de ejecución de los objetos binarios generados.
Etiquetas:loading_and_analysis
- Se acumulan
--test_arg=<a string>
usos múltiples - Especifica las opciones y los 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 se usa en el comando “bazel test”.
--test_filter=<a string>
predeterminado: ver descripción- Especifica un filtro para reenviar al framework de prueba. Se usa para limitar la ejecución de las pruebas. Ten en cuenta que esto no afecta a los destinos que se crean.
--test_result_expiration=<an integer>
predeterminado: "-1"- Esta opción es obsoleta y no tiene efecto.
- Valor predeterminado de
--[no]test_runner_fail_fast
: “falso” - La opción de reenvío falla rápidamente al ejecutor de pruebas. El ejecutor de prueba debe detener la ejecución en la primera falla.
- Valor predeterminado de
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>
: "explícito" - Especifica una estrategia de fragmentación de pruebas: “explícita” para usar la fragmentación solo si el atributo “shard_count” está presente. 'disabled' para inhabilitar la fragmentación de pruebas. "forced=k" impone los fragmentos "k" para pruebas, independientemente del atributo "shard_count" BUILD.
--tool_java_language_version=<a string>
predeterminado: ""- La versión en lenguaje Java que se usa para ejecutar las herramientas necesarias durante una compilación
--tool_java_runtime_version=<a string>
predeterminado: "remotejdk_11"- La versión del entorno de ejecución de Java que se usa para ejecutar herramientas durante la compilación
--[no]use_ijars
predeterminado: “verdadero”- Si se habilita, esta opción hace que la compilación de Java use archivos jar de la interfaz. De esta manera, la compilación incremental será 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 -
Puedes buscar archivos adicionales antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]experimental_repository_cache_hardlinks
: “falso” -
Si se configura, la caché del repositorio vinculará el archivo en caso de un acierto de caché, en lugar de copiarlo. Esto está destinado a ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]experimental_repository_cache_urls_as_default_canonical_id
: “falso” -
Si es verdadero, usa una string derivada de las URL de las descargas del repositorio como el canonical_id si no se especifica. Esto hace que un cambio en las URL provoque una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no generen la máscara de caché de los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
- Valor predeterminado de
--[no]experimental_repository_disable_download
: “falso” - 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 configura en 0, los reintentos están inhabilitados.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark según este factor. De esta manera, los repositorios externos pueden funcionar en máquinas que son más lentas de lo que espera el autor de la regla, sin cambiar el código fuente
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas HTTP mediante el factor determinado
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: ver descripción-
Especifica la ubicación de la 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 para controlar la ejecución de la compilación:
- Valor predeterminado de
--[no]check_up_to_date
: “falso” -
No realices la compilación, solo debes comprobar si está actualizada. Si todos los destinos están actualizados, la compilación se completará de forma correcta. Si algún paso debe ejecutarse, se informa un error y la compilación falla.
Etiquetas:execution
- Valor predeterminado de
--dynamic_local_execution_delay=<an integer>
: “1,000” -
¿Cuántos milisegundos debería retrasar la ejecución local si la ejecución remota fue más rápida durante una compilación, al menos, una vez?
Etiquetas:execution
,host_machine_resource_optimizations
- Se acumulan
--dynamic_local_strategy=<a '[name=]value1[,..,valueN]' assignment>
usos múltiples - Las estrategias locales, a fin de utilizarlas para la actividad mnemotécnica en cuestión Si pasas "local" como valor nemotécnico, se establecerá el valor predeterminado para los mnemónicos 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 -
Las estrategias remotas que se deben usar en la actividad mnemotécnica determinada. Si pasas "remoto" como valor mnemotécnico, se establecerá el valor predeterminado para los mnemónicos no especificados. Toma [mnemonic=]remote_strategy[,remote_strategy,...]
Etiquetas:execution
,host_machine_resource_optimizations
--experimental_docker_image=<a string>
predeterminado: ""-
Especifique un nombre de imagen de Docker (p.ej., "ubuntu:latest") que se debe usar para ejecutar una acción de zona de pruebas cuando se usa la estrategia de Docker, y la acción en sí aún no tenga un atributo container-image en su descripción remota de la plataforma. El valor de esta marca se pasa textualmente a “docker run”, por lo que admite la misma sintaxis y los mismos mecanismos que Docker.
Etiquetas:execution
--[no]experimental_docker_use_customized_images
predeterminado: “verdadero”-
Si se habilita, inyecta el uid y el 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 puede inhabilitarla en caso de que la función de personalización automática de imágenes no funcione en su caso o sepa que no la necesita.
Etiquetas:execution
--[no]experimental_dynamic_exclude_tools
predeterminado: “verdadero”-
Cuando se configura, los objetivos que se compilan “para la herramienta” no están sujetos a ejecución dinámica. Es muy poco probable que se compilen estos objetivos de manera incremental, por lo que no vale la pena invertir en ciclos locales.
Etiquetas:execution
,host_machine_resource_optimizations
--experimental_dynamic_local_load_factor=<a double>
predeterminado: "0"-
Controla cuánta carga de ejecución dinámica se debe colocar en la máquina local. Esta marca ajusta la cantidad de acciones de ejecución dinámica que programaremos simultáneamente. Se basa en la cantidad de CPU que Blaze considera disponible, que se puede controlar con la marca --local_cpu_resources.
Si esta marca es 0, todas las acciones se programan de manera local inmediatamente. Si es mayor que 0, la cantidad de acciones programadas localmente 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 a nivel local cuando la cantidad de acciones en espera para programar es alta. Esto reduce la carga de la máquina local en el caso de la compilación limpia, en la que la máquina local no contribuye mucho.
Etiquetas:execution
,host_machine_resource_optimizations
--experimental_dynamic_slow_remote_time=<An immutable length of time.>
predeterminado: "0"- Si el valor es >0, el tiempo de una acción que se ejecute de manera dinámica debe ejecutarse solo de manera remota antes de priorizar su ejecución local para evitar tiempos de espera remotos. Esto puede ocultar algunos problemas en el sistema de ejecución remota. No active esta función sin supervisar los problemas de ejecución remota.
Etiquetas:execution
,host_machine_resource_optimizations
- Valor predeterminado de
--[no]experimental_enable_docker_sandbox
: “falso” - Habilita la zona de pruebas basada en Docker. Esta opción no tiene efecto si Docker no está instalado.
Etiquetas:execution
--experimental_sandbox_async_tree_delete_idle_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
predeterminado: "0"-
Si el valor es 0, borre los árboles de la zona de pruebas en cuanto se complete una acción (y la demora de la acción en completarse). Si es mayor que cero, ejecuta la eliminación de estos tres en un grupo de subprocesos asíncrono que tenga el tamaño 1 cuando la compilación se esté ejecutando y aumente al tamaño que especifica esta marca cuando el servidor esté inactivo.
Etiquetas:host_machine_resource_optimizations
,execution
--experimental_sandbox_memory_limit=<an integer>
predeterminado: "0"-
Si se establece como verdadera, cada zona de pruebas de Linux se limitará a la cantidad determinada de memoria. Requiere cgroups v2 y permisos para los usuarios al directorio cgroups.
Etiquetas:execution
- Valor predeterminado de
--experimental_sandboxfs_path=<a string>
: “sandboxfs”. -
Es la ruta de acceso al objeto binario sandboxfs para usar cuando --experimental_use_sandboxfs es verdadero. Si se trata de un nombre simple, usa el primer objeto binario de ese nombre que se encuentra en la RUTA DE ACCESO.
Etiquetas:host_machine_resource_optimizations
,execution
--[no]experimental_split_xml_generation
predeterminado: “verdadero”-
Si se establece esta marca y una acción de prueba no genera un archivo test.xml, Bazel usará una acción separada para generar un archivo test.xml ficticio que contenga el registro de prueba. De lo contrario, Bazel genera una prueba.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 superior a cero, los trabajadores inactivos podrían finalizarse si el uso total de memoria de todos los trabajadores excede el límite.
Etiquetas:execution
,host_machine_resource_optimizations
- Valor predeterminado de
--[no]experimental_use_hermetic_linux_sandbox
: “falso” -
Si se establece como verdadera, no se monta la raíz, solo se activa lo que se proporciona con sandbox_add_mount_pair. Los archivos de entrada estarán vinculados directamente a la zona de pruebas en lugar de symlink. Si los archivos de entrada de acciones están ubicados en un sistema de archivos diferente al de la zona de pruebas, los archivos de entrada se copiarán.
Etiquetas:execution
- Valor predeterminado de
--[no]experimental_use_sandboxfs
: “falso” - Usa sandboxfs para crear los directorios execroot de las acciones en lugar de compilar un árbol de symlink. Si el valor es "sí", el objeto binario proporcionado por --experimental_sandboxfs_path debe ser válido y corresponder a una versión compatible de la zona de pruebas. Si el valor es "automático", es posible que falte el objeto binario o que este no sea compatible.
Etiquetas:host_machine_resource_optimizations
,execution
- Valor predeterminado de
--[no]experimental_use_windows_sandbox
: “falso” - Usa la zona de pruebas de Windows para ejecutar acciones. Si el valor es "sí", el objeto binario que proporcione --experimental_windows_sandbox_path debe ser válido y corresponder a una versión compatible de la zona de pruebas. Si el valor es "automático", es posible que falte el objeto binario o que este no sea compatible.
--experimental_windows_sandbox_path=<a string>
predeterminado: “BazelSandbox.exe”- La ruta de acceso al objeto binario de zona de pruebas de Windows que se debe usar cuando --experimental_use_windows_sandbox es verdadero. Si se trata de un nombre simple, usa el primer objeto binario de ese nombre que se encuentra en la RUTA DE ACCESO.
--[no]experimental_worker_as_resource
predeterminado: “verdadero”- Si está habilitado, los trabajadores se adquieren como recursos de ResourceManager.
Etiquetas:execution
,host_machine_resource_optimizations
- Valor predeterminado de
--[no]experimental_worker_cancellation
: “falso” -
Si está habilitada, Bazel puede enviar solicitudes de cancelación a los trabajadores que las admiten.
Etiquetas:execution
--[no]experimental_worker_multiplex
predeterminado: “verdadero”-
Si se habilita, los trabajadores compatibles con la función de multiplexación experimental usarán esa función.
Etiquetas:execution
,host_machine_resource_optimizations
- Valor predeterminado de
--[no]experimental_worker_multiplex_sandboxing
: “falso” -
Si se habilita, los trabajadores multiplex se someterán a una zona de pruebas con un directorio de zona de pruebas independiente por solicitud de trabajo. Solo los trabajadores que tengan el requisito de ejecución “supports-multiplex-sandboxing” se someterán a una zona de pruebas.
Etiquetas:execution
- Valor predeterminado de
--[no]experimental_worker_strict_flagfiles
: “falso” -
Si se habilita, los argumentos de acción para trabajadores que no sigan la especificación de trabajador generarán un error. Los argumentos de trabajador deben tener exactamente un argumento @flagfile como el último de su lista de argumentos.
Etiquetas:execution
--genrule_strategy=<comma-separated list of options>
predeterminado: ""- Especifica cómo ejecutar genrules. Esta marca se eliminará de forma gradual. En cambio, utiliza --spawn_strategy=<value> para controlar todas las acciones o --strategy=Genrule=<value> para controlar solo las reglas de generación.
Etiquetas:execution
- Se acumulan
--high_priority_workers=<a string>
usos múltiples - Menmonías de trabajadores que se ejecutan con prioridad alta. Cuando se ejecutan trabajadores de alta prioridad, se regulan todos los demás trabajadores.
Etiquetas:execution
--[no]incompatible_remote_dangling_symlinks
predeterminado: “verdadero”-
Si se establece como verdadero y --incompatible_remote_symlinks también es verdadero, se permite que los symlinks en los resultados de acción se caigan.
Etiquetas:execution
,incompatible_change
--[no]incompatible_remote_symlinks
predeterminado: “verdadero”-
Si se configura como verdadero, Bazel representará symlinks en resultados de acciones en el protocolo de almacenamiento en caché remoto/ejecución. De lo contrario, los symlinks se seguirán y se representarán como archivos o directorios. Consulta #6631 para obtener más detalles.
Etiquetas:execution
,incompatible_change
- Valor predeterminado de
--[no]incompatible_sandbox_hermetic_tmp
: “falso” -
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. Usa --sandbox_add_mount_pair=/tmp para seguir viendo el /tmp del host en todas las zonas de pruebas.
Etiquetas:execution
- Valor predeterminado de
--[no]internal_spawn_scheduler
: “falso” -
Opción de marcador de posición para que podamos indicarle al Blaze si se habilitó el programador de generación.
Etiquetas:execution
,host_machine_resource_optimizations
--jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
[-j
] predeterminado: "auto"-
La cantidad de trabajos simultáneos que se ejecutarán. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". Los valores deben estar entre 1 y 5,000. Los valores superiores a 2,500 pueden causar problemas de memoria. "automático" 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 después de un error. Si bien el objetivo con errores y los que dependen de él no se pueden analizar, otros requisitos previos pueden serlo.
Etiquetas:eagerness_to_exit
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
predeterminado: "automático"-
Cantidad de subprocesos paralelos que se usarán en la fase de carga o análisis. Toma un número entero o una palabra clave ("automático", "HOST_CPUS", "HOST_RAM"), opcionalmente seguido de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". "auto" establece un valor predeterminado razonable en función de los recursos del host. Debe ser 1 como mínimo.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]reuse_sandbox_directories
: “falso” -
Si se configura como verdadera, los directorios que usa la ejecución en zona de pruebas que no es de trabajador se pueden reutilizar 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 el rendimiento mucho cuando tu compilación o pruebas tienen muchos archivos de entrada. Nota: Necesitas suficiente RAM y espacio libre en los tmpfs para almacenar los archivos intermedios y de salida generados por las acciones en ejecución.
Etiquetas:host_machine_resource_optimizations
,execution
- Valor predeterminado de
--[no]sandbox_explicit_pseudoterminal
: “falso” - Habilita de forma explícita la creación de pseudoterminales para las acciones en la zona de pruebas. Algunas distribuciones de Linux requieren que se configure el ID de grupo del proceso como "tty" dentro de la zona de pruebas para que funcionen las pseudoterminales. Si esto genera problemas, se puede inhabilitar esta marca para permitir que se usen otros grupos.
Etiquetas:execution
- Se acumulan
--sandbox_tmpfs_path=<an absolute path>
usos múltiples -
En el caso de las acciones de zona de pruebas, activa un directorio vacío y que admita escritura en esta ruta de acceso absoluta (si es compatible con la implementación de la zona de pruebas, de lo contrario, se ignora).
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 separada por comas de las estrategias de mayor a menor prioridad. Para cada acción, Bazel elige la estrategia con la prioridad más alta que puede ejecutar la acción. El valor predeterminado es “remote,worker,sandboxed,local”. Consulta https://blog.bazel.build/2019/06/19/list-strategy.html para obtener más información.
Etiquetas:execution
- Se acumulan
--strategy=<a '[name=]value1[,..,valueN]' assignment>
usos múltiples - Especifica cómo distribuir la compilación de otras acciones de generación. Acepta una lista separada por comas de las estrategias 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 mnemonic Genrule). Consulta https://blog.bazel.build/2019/06/19/list-strategy.html para obtener más información.
Etiquetas:execution
- Se acumulan
--strategy_regexp=<a '<RegexFilter>=value[,value]' assignment>
usos múltiples -
Anula la estrategia de generación que debería usarse para ejecutar acciones de generación que tengan descripciones que coincidan con un determinado regex_filter. Consulta --per_file_copt para conocer los detalles de la coincidencia de regex_filter. Se usa el último regex_filter que coincide con la descripción. Esta opción anula otras marcas para especificar la estrategia. Ejemplo: --strategy_regexp=//foo.*\.cc,-//foo/bar=local significa ejecutar acciones con una 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á "Compilación //foo/bar/baz" con la estrategia "local", pero revertir el orden lo ejecutaría con "zona de pruebas".
Etiquetas:execution
- Se acumulan
--worker_extra_flag=<a 'name=value' assignment>
usos múltiples -
Marcas de comando adicionales que se pasarán a los procesos de los trabajadores, además de --persistent_worker, con la clave mnemónica (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 persistente de Java) pueden iniciarse si usas la estrategia “trabajador”. Se puede especificar como [name=value] para indicar un valor diferente por mnemónico del trabajador. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". "auto" calcula un valor predeterminado razonable en función de la capacidad de la máquina. "=value" establece un valor predeterminado para mnemónicos sin especificar.
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 -
Cuántas WorkRequests 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 indicar un valor diferente por mnemónico del trabajador. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". "auto" calcula un valor predeterminado razonable en función de la capacidad de la máquina. "=value" establece un valor predeterminado para mnemónicos sin especificar.
Etiquetas:execution
,host_machine_resource_optimizations
- Valor predeterminado de
--[no]worker_quit_after_build
: “falso” -
Si se habilita, todos los trabajadores se cierran después de que se completa una compilación.
Etiquetas:execution
,host_machine_resource_optimizations
- Valor predeterminado de
--[no]worker_sandboxing
: “falso” - Si se habilita, los trabajadores se ejecutarán en un entorno de zona de pruebas.
Etiquetas:execution
- Valor predeterminado de
--[no]worker_verbose
: “falso” - Si está habilitada, imprime mensajes detallados cuando se inician los trabajadores, se cierran...
- Opciones para configurar la cadena de herramientas que se usa en la ejecución de la acción:
- Valor predeterminado de
--[no]incompatible_disable_runtimes_filegroups
: “falso” -
No disponible.
Etiquetas:action_command_lines
,loading_and_analysis
,deprecated
,incompatible_change
--[no]incompatible_dont_emit_static_libgcc
predeterminado: “verdadero”-
No disponible.
Etiquetas:action_command_lines
,loading_and_analysis
,deprecated
,incompatible_change
--[no]incompatible_linkopts_in_user_link_flags
predeterminado: “verdadero”-
No disponible.
Etiquetas:action_command_lines
,loading_and_analysis
,deprecated
,incompatible_change
- Opciones que controlan el resultado del comando:
--[no]build
predeterminado: “verdadero”- Ejecuta la compilación (este es el comportamiento habitual). Cuando se especifica --nobuild, la compilación se detiene antes de ejecutar las acciones de compilación, y se muestran cero si las fases de carga y análisis del paquete se completaron correctamente. Este modo es útil para probar esas fases.
Etiquetas:execution
,affects_outputs
--[no]experimental_run_validations
predeterminado: “verdadero”- Usa --run_validates en su lugar.
Etiquetas:execution
,affects_outputs
- Valor predeterminado de
--[no]experimental_use_validation_aspect
: “falso” - Determina si se deben ejecutar acciones de validación mediante el aspecto (para 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 con el prefijo + o el signo -. Un grupo con el prefijo + se agrega al conjunto predeterminado de grupos de salida, mientras que el grupo con el prefijo - se quita del conjunto predeterminado. Si al menos un grupo no tiene un 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 barra, mientras que --output_groups=foo,bar anula el conjunto predeterminado de manera que solo se compilan foo y bar.
Etiquetas:execution
,affects_outputs
--[no]run_validations
predeterminado: “verdadero”-
Determina si se deben ejecutar acciones de validación como parte de la compilación. Consulta https://bazel.build/extending/rules#validation_actions
Etiquetas:execution
,affects_outputs
- Opciones que permiten que el usuario configure el resultado deseado y afecte su valor, a diferencia de su existencia:
- Se acumulan
--aspects=<comma-separated list of options>
usos múltiples - Lista de aspectos separados por comas que se aplicarán a los objetivos de nivel superior. En la lista, si el aspecto some_aspect especifica los proveedores de aspecto obligatorios mediante el campo required_aspect_providers, algunos_aspect se ejecutarán después de cada aspecto que se mencionó antes en la lista de aspectos cuyos proveedores publicitados cumplen con algunos proveedores de aspecto obligatorios. Además, some_aspect se ejecutará después de todos los aspectos obligatorios que especifica el atributo required. Luego, el else_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 de herramientas/my_def.bzl.
--bep_maximum_open_remote_upload_files=<an integer>
predeterminado: "-1"-
Cantidad máxima de archivos abiertos que se permiten durante la carga de artefactos BEP.
Etiquetas:affects_outputs
--[no]experimental_convenience_symlinks
predeterminado: "normal"-
Esta marca controla cómo se administrarán los symlinks de conveniencia (los symlinks que aparecen en el lugar de trabajo después de la compilación). Valores posibles: normal (predeterminado): cada tipo de conveniencia del symlink se creará o se borrará, según lo determinado por la compilación.
limpio: Se borrarán todos los symlinks de forma incondicional.
ignorar: Los vínculos simbólicos se dejarán solos.
log_only: Se generan mensajes de registro como si se pasara “normal”, pero en realidad no se realiza ninguna operación del sistema de archivos (útil para herramientas).
Tenga en cuenta que solo pueden verse afectados los symlinks cuyos nombres se generan con el valor actual de --symlink_prefix; si cambia el prefijo, los symlinks preexistentes se dejarán solos.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]experimental_convenience_symlinks_bep_event
: “falso” -
Esta marca controla si publicaremos o no el evento de compilación ConvenienceSymlinksIdentified en BuildEventProtocol. Si el valor es verdadero, BuildEventProtocol tendrá una entrada para convenienciaSymlinksIdentified e incluirá todos los symlinks de conveniencia creados en su 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-op.
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
--remote_download_outputs=<all, minimal or toplevel>
predeterminado: "todos"-
Si se configura como “minimal”, no se descargan los resultados de la compilación remota en la máquina local, excepto los que requieren las acciones locales. Si se configura como “nivel superior”, se comporta como “minimal”, excepto que también descarga resultados de objetivos de nivel superior en la máquina local. Ambas opciones pueden reducir significativamente los tiempos de compilación si el ancho de banda de la red representa un cuello de botella.
Etiquetas:affects_outputs
--remote_download_symlink_template=<a string>
predeterminado: ""-
En lugar de descargar resultados de la compilación remota en la máquina local, cree vínculos simbólicos. El destino de los vínculos simbólicos se puede especificar en la forma de una string de plantilla. Esta string de plantilla puede contener {hash} y {size_bytes} que se expanden al hash del objeto y al tamaño en bytes, respectivamente. Estos vínculos simbólicos pueden, por ejemplo, apuntar a un sistema de archivos FUSE que carga objetos desde el CAS a pedido.
Etiquetas:affects_outputs
--remote_download_toplevel
-
Solo descarga los resultados remotos de los objetivos 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
--symlink_prefix=<a string>
predeterminado: ver descripción-
Es el prefijo que se antepone a cualquiera de los symlinks prácticos 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 y no se emite ninguna advertencia. Advertencia: La funcionalidad especial para el atributo '/' pronto dejará de estar disponible; en su lugar, utilice --experimental_convenience_symlinks=ignore.
Etiquetas:affects_outputs
- Opciones que afectan la forma estricta en que Bazel aplica las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etc.):
- Valor predeterminado de
--[no]experimental_docker_privileged
: “falso” -
Si se habilita, Bazel pasará la marca --privileged a “docker run” cuando ejecute acciones. Esto puede ser necesario para tu compilación, pero también podría reducir la hermetismo.
Etiquetas:execution
--experimental_repository_hash_file=<a string>
predeterminado: ""-
Si el campo no está vacío, especifica un archivo que contiene un valor resuelto, en el que se deben verificar los hash del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Valor predeterminado de
--[no]experimental_sandboxfs_map_symlink_targets
: “falso” -
Si es verdadero, mapea los objetivos de los vínculos simbólicos especificados como entradas de acción en la zona de pruebas. Esta función solo se usa para solucionar problemas de reglas con errores que no lo hacen por sí solas y se deben quitar 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 la lista de reglas del repositorio para la que se debe verificar el hash del directorio de salida, siempre que --experimental_repository_hash_file proporcione un archivo
Etiquetas:affects_outputs
,experimental
- Valor predeterminado de
--[no]incompatible_legacy_local_fallback
: “falso” -
Si se configura como verdadera, habilita el resguardo implícito heredado de la zona de pruebas a la estrategia local. Esta marca finalmente se configurará como falsa de forma predeterminada y, luego, se convertirá en no-op. En su lugar, usa --strategy, --spawn_strategy o --dynamic_local_strategy para configurar los 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 activar en la zona de pruebas.
Etiquetas:execution
- Se acumulan
--sandbox_block_path=<a string>
usos múltiples -
Para acciones en la zona de pruebas, inhabilita el acceso a esta ruta.
Etiquetas:execution
--[no]sandbox_default_allow_network
predeterminado: “verdadero”- Permite el acceso a la red de forma predeterminada para realizar acciones. Es posible que no funcione con todas las implementaciones de las zonas de prueba.
- Valor predeterminado de
--[no]sandbox_fake_hostname
: “falso” -
Cambia el nombre de host actual a “localhost” para las acciones en la zona de pruebas.
Etiquetas:execution
- Valor predeterminado de
--[no]sandbox_fake_username
: “falso” -
Cambia el nombre de usuario actual a “nadie” para las acciones en la zona de pruebas.
Etiquetas:execution
- Se acumulan
--sandbox_writable_path=<a string>
usos múltiples -
En el caso de las acciones en la zona de pruebas, crea un directorio existente que admita escritura en la zona de pruebas (si es compatible con la implementación de la zona de pruebas, de lo contrario, ignora esta opción).
Etiquetas:execution
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: “verdadero”-
No-ops
Etiquetas:no_op
,deprecated
,experimental
- Valor predeterminado de
--[no]incompatible_config_setting_private_default_visibility
: “falso” -
Si este valor es incompatible. De lo contrario, si esta marca es falsa, cualquier configuración de configuración sin un atributo de visibilidad explícito es //visibility:public. Si esta marca es verdadera, config_setting sigue la misma lógica de visibilidad que todas las demás reglas. Consulta https://github.com/bazelbuild/bazel/issues/12933.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
predeterminado: “verdadero”-
Si es verdadero, aplique restricciones de visibilidad de config_setting. Si es falso, todos los archivos config_setting son visibles para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones que rigen el comportamiento del entorno de pruebas o del ejecutor de pruebas:
- Valor predeterminado de
--[no]check_tests_up_to_date
: “falso” -
No ejecutes pruebas. Solo verifica si están actualizadas. Si todos los resultados están actualizados, las pruebas se completan correctamente. Si es necesario compilar o ejecutar una prueba, se informa un error y la prueba falla. Esta opción implica el comportamiento --check_up_to_date.
Etiquetas:execution
- Se acumulan
--flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once>
usos múltiples -
Cada prueba se reintenta hasta la cantidad especificada de veces en caso de que falle. Las pruebas que requieren más de un intento de aprobar se marcan como "FLAKY" en el resumen de la prueba. Normalmente, el valor especificado es solo un número entero o la string "default". Si es un número entero, todas las pruebas se ejecutarán hasta N veces. Si es "default", solo se realizará un único intento de prueba para las pruebas regulares y tres para las pruebas marcadas de manera explícita como inestables por su regla (atributo poco confiable=1). Sintaxis alternativa: regex_filter@flaky_test_attempts. Donde flaky_test_attempts es como el anterior, y regex_filter representa una lista de incluir y excluir patrones de expresión regular (también consulte --runs_per_test). Ejemplo: --flaky_test_attempts=//foo/.*,-//foo/bar/.*@3 desestima todas las pruebas en //foo/, excepto aquellas en foo/bar tres veces. Esta opción se puede pasar varias veces. El argumento pasado más reciente que coincide tiene prioridad. Si no hay coincidencias, el comportamiento es como el valor "predeterminado" mencionado anteriormente.
Etiquetas:execution
--local_test_jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
predeterminado: "automático"-
La cantidad máxima de trabajos de prueba locales que se ejecutan de forma simultánea. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". 0 significa que los recursos locales limitarán la cantidad de trabajos de prueba locales que se ejecutarán en simultáneo. Establecer un valor mayor que el de --jobs es ineficaz.
Etiquetas:execution
--[no]test_keep_going
predeterminado: “verdadero”-
Si se inhabilita, cualquier prueba no aprobada hará que se detenga toda la compilación. De forma predeterminada, se ejecutan todas las pruebas, incluso si algunas no se aprueban.
Etiquetas:execution
--test_strategy=<a string>
predeterminado: ""-
Especifica la estrategia que se usará para ejecutar pruebas.
Etiquetas:execution
--test_tmpdir=<a path>
predeterminado: ver descripción- Especifica el directorio temporal base para que se use “bazel test”.
- Opciones relacionadas con la salida y la semántica de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Se especificaron las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran en un registro del origen del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones con bloqueos harán que falle la resolución. También puedes definir una versión ya permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puede inhabilitar esta comprobación con la palabra clave "todo" (no se recomienda).
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
: "Error" -
Comprueba la compatibilidad de los módulos de Bazel con la versión 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 detecta una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "warning"-
Comprueba si las dependencias directas de "bazel_dep" declaradas en el módulo raíz son las mismas que se muestran en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la comprobación, "warning" para mostrar una advertencia cuando se detecta una discrepancia o "error" para escalarla a una falla de resolución.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]ignore_dev_dependency
: “falso” -
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declaradas como "dev_dependency" en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev se ignoran siempre en MODULE.bazel si no es el módulo raíz independientemente del valor de esta marca.
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 un directorio local.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en registros anteriores y solo volverán a los registros posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Valor predeterminado de
--[no]announce
: “falso” -
Obsoleto. No-op.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]debug_spawn_scheduler
: “falso” - Valor predeterminado de
--[no]experimental_bep_target_summary
: “falso” - Indica si se deben publicar eventos de TargetSummary.
- Valor predeterminado de
--[no]experimental_build_event_expand_filesets
: “falso” - Si es verdadero, expande los conjuntos de archivos en el BEP cuando se presentan archivos de salida.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]experimental_build_event_fully_resolve_fileset_symlinks
: “falso” -
Si es verdadero, resuelve por completo los symlinks relativos del conjunto de archivos en el BEP cuando 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"-
La cantidad máxima de veces que Bazel debería reintentar subir un evento de compilación.
Etiquetas:bazel_internal_configuration
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
predeterminado: "1 s"-
Es el retraso mínimo inicial para los reintentos de retirada exponencial cuando falla la carga de BEP. (exponente: 1.6)
Etiquetas:bazel_internal_configuration
--experimental_build_event_upload_strategy=<a string>
predeterminado: ver descripción- Selecciona cómo subir los artefactos a los que se hace referencia en el protocolo de evento de compilación.
Etiquetas:affects_outputs
--[no]experimental_collect_local_sandbox_action_metrics
predeterminado: “verdadero”-
Cuando se habilita, se registran estadísticas de ejecución (como el tiempo del usuario y del sistema) para las acciones ejecutadas de forma local que usan la zona de pruebas
Etiquetas:execution
- Valor predeterminado de
--[no]experimental_docker_verbose
: “falso” -
Si está habilitado, Bazel imprimirá mensajes más detallados sobre la estrategia de zona de pruebas de Docker.
Etiquetas:execution
- Valor predeterminado de
--[no]experimental_materialize_param_files_directly
: “falso” - Si materializas archivos de parámetros, debes hacerlo con escrituras directas en el disco.
Etiquetas:execution
- Valor predeterminado de
--[no]experimental_record_metrics_for_all_mnemonics
: “falso” - De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 nombres con la mayor cantidad de acciones ejecutadas. Si se establece esta opción, se escribirán estadísticas para todos los mnemónicos.
--experimental_repository_resolved_file=<a string>
predeterminado: ""-
Si no está vacío, escriba un valor de Starlark con la información resuelta de todas las reglas del repositorio de Starlark que se ejecutaron.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]experimental_stream_log_file_uploads
: “falso” - Transmite directamente los archivos de registro al almacenamiento remoto en lugar de escribirlos en el disco.
Etiquetas:affects_outputs
--explain=<a path>
predeterminado: 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
--[no]legacy_important_outputs
predeterminado: “verdadero”-
Úsalo a fin de suprimir la generación del campo heredado_outputs heredado del evento TargetComplete. Son importantes para la integración de Bazel con ResultStore.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]materialize_param_files
: “falso” -
Escribe archivos de parámetros intermedios en el árbol de resultados, incluso cuando se usa la ejecución remota de acciones. Es útil cuando se depuran acciones. Esto está implícito por --subcommands y --verbose_failures.
Etiquetas:execution
- Valor predeterminado de
--max_config_changes_to_show=<an integer>
: "3" - Cuando se descarta la caché de análisis debido a un cambio en las opciones de compilación, se muestra la cantidad determinada de nombres de opciones modificadas. Si el número proporcionado es -1, se mostrarán todas las opciones modificadas.
Etiquetas:terminal_output
--max_test_output_bytes=<an integer>
predeterminado: "-1"-
Especifica el tamaño máximo por registro de prueba que se puede emitir cuando --test_output es "errores" o "all". Es útil para evitar abrumar el resultado con un resultado de prueba demasiado ruidoso. El encabezado de la prueba se incluye en el tamaño de registro. Los valores negativos no tienen límites. El resultado es todo o nada.
Etiquetas:test_runner
,terminal_output
,execution
--output_filter=<a valid Java regular expression>
predeterminado: ver descripción- Solo muestra las advertencias para las reglas con un nombre que coincide con la expresión regular proporcionada.
Etiquetas:affects_outputs
--progress_report_interval=<an integer in 0-3600 range>
predeterminado: "0"-
Es la cantidad de segundos entre los informes en trabajos que se siguen ejecutando. El valor predeterminado 0 significa que el primer informe se imprimirá después de 10 segundos, luego en 30 segundos y después de que ese progreso se informe una vez por minuto. Cuando --curses está habilitado, se informa el progreso 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 fallas, "success" para imprimir solo cuando se realiza correctamente y "all" para imprimir siempre.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]sandbox_debug
: “falso” - Habilita las funciones de depuración para la función de zona de pruebas. Esto incluye dos cosas: primero, el contenido raíz de la zona de pruebas no se modifica después de una compilación (y si sandboxfs está en uso, el sistema de archivos se activa a la izquierda) y, en segundo lugar, imprime información adicional de depuración en la ejecución. Esto puede ayudar a los desarrolladores de reglas de Bazel o Starlark con fallas de depuración debido a la falta de archivos de entrada, etcétera.
Etiquetas:terminal_output
- Valor predeterminado de
--show_result=<an integer>
: "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 compilaron. Los archivos impresos son strings convenientes para copiar y pegar en la shell, para ejecutarlas.
Esta opción requiere un argumento de número entero, que es la cantidad límite de objetivos por encima de la cual no se imprime la información del resultado. Por lo tanto, cero provoca la supresión del mensaje y MAX_INT hace que la impresión del resultado se produzca 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 la herramienta).
Etiquetas:terminal_output
--test_output=<summary, errors, all or streamed>
predeterminado: "summary"-
Especifica el modo de salida deseado. Los valores válidos son "summary" para mostrar solo el resumen de estado de la prueba, "errors" para imprimir también los registros de pruebas de las pruebas fallidas, "all" para imprimir los registros de todas las pruebas y "streamed" para generar los registros de todas las pruebas en tiempo real (esto obligará a las pruebas se ejecuten de forma local, independientemente del valor de --test_strategy).
Etiquetas:test_runner
,terminal_output
,execution
- Valor predeterminado de
--test_summary=<short, terse, detailed, none or testcase>
: "corto" -
Especifica el formato deseado del resumen de la prueba. Los valores válidos son "short" para imprimir información únicamente sobre las pruebas ejecutadas, "terse" para imprimir solo la información de las pruebas fallidas que se ejecutaron, "detail" para imprimir información detallada sobre los casos de prueba con errores, "testcase" para imprimir el resumen en la resolución del caso de prueba, no imprimir información detallada sobre los casos de prueba con errores y "none" para omitir el resumen.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]verbose_explanations
: “falso” -
Aumenta la verbosidad de las explicaciones emitidas si se habilita --explain. No tiene efecto si --explain no está habilitado.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]verbose_failures
: “falso” - Si un comando falla, imprime la línea de comandos completa.
Etiquetas:terminal_output
- Opciones para especificar o alterar una entrada genérica en un comando de Bazel que no se encuentre en otras categorías:
- Se acumulan
--aspects_parameters=<a 'name=value' assignment>
usos múltiples -
Especifica los valores de los parámetros de los aspectos de la línea de comandos. Cada valor de parámetro se especifica mediante <param_name>=<param_value>, por ejemplo, 'my_param=my_val' donde 'my_param' es un parámetro de algún aspecto en --aspecting list o obligatorio por un aspecto en la lista. Esta opción se puede utilizar varias veces. Sin embargo, no se pueden 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 el campo no resuelto, 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 nombra aquí, en lugar de hacerlo en la línea de comandos. Es un error especificar aquí un archivo y patrones de línea de comandos.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remotas:
--experimental_downloader_config=<a string>
predeterminado: ver descripción- Especifica un archivo para configurar la descarga remota. Este archivo consta de líneas y cada una comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para coincidir y uno para usar como URL sustituta. Las referencias inversas comienzan desde "$1". Es posible que se muestren varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias.
- Valor predeterminado de
--[no]experimental_guard_against_concurrent_changes
: “falso” - Desactiva esta opción para inhabilitar la opción de comprobación de tiempo de los archivos de entrada de una acción antes de subirla a una caché remota. Puede haber casos en los que el kernel de Linux retrase la escritura de archivos, lo que podría causar falsos positivos.
--experimental_remote_build_event_upload=<all or minimal>
predeterminado: "todos"- Si se configura como “todos”, todos los resultados locales a los que hace referencia el BEP se suben a la caché remota. Si se configura como "minimal", los resultados locales a los que hace referencia BEP no se suben a la caché remota, excepto los archivos que son importantes para los consumidores de BEP (p.ej., registros de prueba y perfil de sincronización). El esquema file:// se usa para las rutas de archivos locales y el esquema bytestream:// se usa para las rutas de archivos (ya subidos). La configuración predeterminada es "Todas".
- Valor predeterminado de
--[no]experimental_remote_cache_async
: “falso” - Si es verdadero, la E/S de la caché remota sucederá en segundo plano, en lugar de realizarse como parte de un generación.
- Valor predeterminado de
--[no]experimental_remote_cache_compression
: “falso” - Si está habilitada, comprime o descomprime los BLOB de caché con zstd.
--experimental_remote_capture_corrupted_outputs=<a path>
predeterminado: ver descripción- Es una ruta de acceso a un directorio en el que se capturarán los resultados dañados.
--experimental_remote_downloader=<a string>
predeterminado: ver descripción- Un URI de extremo de la API de Remote Asset que se usará como proxy de descarga remota. Los esquemas admitidos son grpc, grpcs (grpc with TLS enabled) y unix (local UNIX sockets). 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
- Valor predeterminado de
--[no]experimental_remote_downloader_local_fallback
: “falso” - Indica si se debe volver a la herramienta de descarga local si falla la descarga remota.
- Valor predeterminado de
--[no]experimental_remote_execution_keepalive
: “falso” - Determina si se debe usar keepalive para las llamadas de ejecución remota.
--experimental_remote_grpc_log=<a path>
predeterminado: ver descripción- Si se especifica, una ruta de acceso a un archivo para registrar los detalles relacionados con las llamadas de gRPC. Este registro consta de una secuencia de protobufs serializados com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry con cada mensaje con el prefijo de un varint que indica el tamaño del siguiente mensaje protobuf serializado, como lo realiza el método LogEntry.writeDelimitedTo(OutputStream).
- Valor predeterminado de
--[no]experimental_remote_mark_tool_inputs
: “falso” - Si se configura como verdadero, Bazel marcará las entradas como entradas de herramientas para el ejecutor remoto. Esto se puede usar para implementar trabajadores persistentes remotos.
- Valor predeterminado de
--[no]experimental_remote_merkle_tree_cache
: “falso” - Si se configura como verdadera, se calcularán los cálculos del árbol de Merkle para mejorar la velocidad de comprobación de aciertos de la caché remota. La impresión del pie de la memoria en caché se controla mediante --experimental_remote_merkle_tree_cache_size.
- Valor predeterminado de
--experimental_remote_merkle_tree_cache_size=<a long integer>
: “1,000” - Es la cantidad de árboles Merkle que se memorizarán para mejorar la velocidad de comprobación de la acierto de caché remota. Aunque la caché se reduce automáticamente según la administración de referencias flexibles de Java, pueden producirse errores de memoria insuficiente si se configuran demasiado altos. Si se establece en 0, el tamaño de la caché es ilimitado. El valor óptimo varía según el tamaño del proyecto. La configuración predeterminada es 1,000.
- Valor predeterminado de
--[no]incompatible_remote_build_event_upload_respect_no_cache
: “falso” - Si se establece como verdadera, los resultados a los que hace referencia BEP no se suben a la caché remota si la acción de generación no se puede almacenar en caché de forma remota.
--[no]incompatible_remote_downloader_send_all_headers
predeterminado: “verdadero”-
Indica si se deben enviar todos los valores de un encabezado con valores múltiples al descargador remoto, en lugar de solo al primero.
Etiquetas:incompatible_change
- Valor predeterminado de
--[no]incompatible_remote_output_paths_relative_to_input_root
: “falso” -
Si se establece como verdadera, las rutas de salida son relativas a la raíz de entrada en lugar del directorio de trabajo.
Etiquetas:incompatible_change
--[no]incompatible_remote_results_ignore_disk
predeterminado: “verdadero”-
Si se establece 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é de disco, pero no se carguen en la caché remota.
--noremote_accept_cached hará que Bazel verifique los resultados en la caché del disco, pero no en la caché remota.
no-remote-exec pueden alcanzar la caché del disco.
Consulta #8216 para obtener más detalles.
Etiquetas:incompatible_change
--[no]remote_accept_cached
predeterminado: “verdadero”- Indica si se deben aceptar los resultados de la acción que se almacenaron en caché de forma remota.
--remote_bytestream_uri_prefix=<a string>
predeterminado: 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 al nombre canónico del servicio de ejecución remota. Si no la estableces, se configurará de forma predeterminada en "${hostname}/${instance_name}".
--remote_cache=<a string>
predeterminado: ver descripción- Un URI de un extremo de almacenamiento en caché. Los esquemas admitidos son http, https, grpc, grpcs (grpc with TLS enabled) y Unix (local UNIX sockets). Si no se proporciona un esquema, Bazel se establecerá de forma predeterminada en grpcs. Especifica grpc://, http:// o unix: esquema 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. Se convertirán varios valores para el mismo nombre en una lista separada por comas.
- Se acumulan
--remote_default_exec_properties=<a 'name=value' assignment>
usos múltiples -
Configura las propiedades ejecutivas predeterminadas que se usarán como la plataforma de ejecución remota si una plataforma de ejecución aún no establece exec_properties.
Etiquetas:affects_outputs
--remote_default_platform_properties=<a string>
predeterminado: ""- Configura las propiedades de plataforma predeterminadas que se establecerán para la API de ejecución remota si la plataforma de ejecución aún no establece remote_execution_properties. Este valor también se usará si se selecciona la plataforma host como plataforma de ejecución remota.
- Se acumulan
--remote_downloader_header=<a 'name=value' assignment>
usos múltiples - Especifica un encabezado que se incluirá en las solicitudes de descarga remota: --remote_downloader_header=Name=Value. Se pueden pasar varios encabezados si se especifica la marca varias veces. Se convertirán varios valores para el mismo nombre 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. Se convertirán varios valores para el mismo nombre 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.
--remote_executor=<a string>
predeterminado: ver descripción- HOST o HOST:PORT de un extremo de ejecución remota. Los esquemas admitidos son grpc, grpcs (grpc with TLS enabled) y unix (local UNIX sockets). Si no se proporciona un esquema, Bazel se establecerá de forma predeterminada en grpcs. Especifica grpc:// o unix: esquema para inhabilitar TLS.
- 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. Se convertirán varios valores para el mismo nombre 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.
- Valor predeterminado de
--[no]remote_local_fallback
: “falso” - Indica si se debe volver a la estrategia de ejecución local independiente si falla la ejecución remota.
--remote_local_fallback_strategy=<a string>
predeterminado: "local"- No-op, dejó de estar disponible. Consulta https://github.com/bazelbuild/bazel/issues/7480 para obtener más detalles.
--remote_max_connections=<an integer>
predeterminado: "100"- Limita la cantidad máxima de conexiones simultáneas a la caché/ejecutor remoto. De forma predeterminada, el valor es 100. Establecerlo en 0 significa que no hay limitaciones.
Para la caché remota HTTP, una conexión TCP podría manejar una solicitud a la vez, por lo que Bazel podría realizar hasta --remote_max_connections solicitudes simultáneas.
Para un caché o un ejecutor remoto de gRPC, un canal de gRPC generalmente podría manejar más de 100 solicitudes simultáneas, por lo que Bazel podría realizar alrededor de “--remote_max_connections * 100” solicitudes simultáneas.
Etiquetas:host_machine_resource_optimizations
--remote_proxy=<a string>
predeterminado: 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 configura en 0, los reintentos están inhabilitados.
--remote_timeout=<An immutable length of time.>
predeterminado: "60 s"- La cantidad máxima de tiempo que se debe esperar para que se ejecuten la llamada remota y las llamadas en caché. Para la caché de REST, este es el tiempo de conexión y el tiempo de espera de lectura. Se pueden utilizar las siguientes unidades: Días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
--[no]remote_upload_local_results
predeterminado: “verdadero”- Indica si se deben cargar los resultados de acciones ejecutadas de forma local en la caché remota si la caché remota lo admite y si el usuario está autorizado para hacerlo.
--[no]remote_verify_downloads
predeterminado: “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 forma remota si no coinciden con el valor esperado.
- Varias opciones, sin otra categoría
--auto_output_filter=<none, all, packages or subpackages>
predeterminado: "ninguno".- Si no se especifica --output_filter, se usa el valor para esta opción de forma automática. Los valores permitidos son 'none' (ninguno) Los valores de "paquetes" y "subpaquetes" //java/foo y //javatests/foo se tratan como un solo paquete).
- Valor predeterminado de
--[no]build_manual_tests
: “falso” - Fuerza la compilación de los destinos etiquetados como "manual". Las pruebas "manuales" no se incluyen en el procesamiento. Esta opción hace que se compilen (pero no se ejecuten).
--build_tag_filters=<comma-separated list of options>
predeterminado: ""- Especifica una lista de etiquetas separadas por comas. De manera opcional, cada etiqueta puede estar precedida por "-" para especificar etiquetas excluidas. Solo se crearán los destinos que contengan al menos una etiqueta incluida y no contengan ninguna etiqueta excluida. Esta opción no afecta el conjunto de pruebas ejecutadas con el comando "test" (prueba), que se rige por las opciones de filtrado de pruebas (por ejemplo, "test_tag_filters").
- Valor predeterminado de
--[no]build_tests_only
: “falso” - Si se especifica, solo se compilarán las reglas *_test y test_suite, y se ignorarán los otros destinos especificados en la línea de comandos. De forma predeterminada, se compilarán todos los datos solicitados.
--combined_report=<none or lcov>
predeterminado: "ninguno".- Especifica el tipo de informe de cobertura acumulativa deseado. En este momento, solo se admite LCOV.
- Valor predeterminado de
--[no]compile_one_dependency
: “falso” - Compila una sola dependencia de los archivos de argumento. Esto es útil para comprobar la sintaxis de los archivos de origen de los IDE, por ejemplo, mediante la compilación de un solo destino que dependa del archivo de origen a fin de 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 sin marcas. En lugar de ser destinos 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
--deleted_packages=<comma-separated list of package names>
usos múltiples - Es una lista de nombres de paquetes separados por comas 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". Por ejemplo, después de borrar x/y/BUILD en tu cliente, el sistema de compilación puede presentar una queja si encuentra una etiqueta "//x:y/z" si aun así la proporciona otra entrada package_path. Si se especifica --deleted_packages x/y, se evita este problema.
- Valor predeterminado de
--[no]discard_analysis_cache
: “falso” - Descarta la caché de análisis inmediatamente después de que se complete la fase de análisis. Reduce el uso de memoria en aproximadamente un 10%, pero ralentiza las compilaciones incrementales.
--disk_cache=<a path>
predeterminado: ver descripción- Es una ruta de acceso a un directorio en el que Bazel puede leer y escribir acciones y resultados de acciones. Si el directorio no existe, se creará.
--embed_label=<a one-line string>
predeterminado: ""- Incorporar revisión de control de origen o etiqueta de lanzamiento en objeto binario
--execution_log_binary_file=<a path>
predeterminado: ver descripción- Registra las generaciones ejecutadas en este archivo como protos de spawn delimitados por src/main/protobuf/spawn.proto. El registro primero se escribe sin orden y, luego, al final de la invocación, se ordena de forma estable (puede consumir muchos recursos de CPU y memoria). Marcas relacionadas: --execution_log_json_file (formato JSON de texto ordenado), --experimental_execution_log_file (formato protobuf binario sin ordenar), subcomandos (para mostrar subcomandos en el resultado de la terminal).
--execution_log_json_file=<a path>
predeterminado: ver descripción- Registra las generaciones ejecutadas en este archivo como representación json de los protos de spawn delimitados, según src/main/protobuf/spawn.proto. El registro primero se escribe sin orden y, luego, al final de la invocación, se ordena de forma estable (puede consumir muchos recursos de CPU y memoria). Marcas relacionadas: marcas relacionadas: --execution_log_binary_file (formato binario protobuf), --experimental_execution_log_file (formato binario protobuf), --subcomandos (para mostrar subcomandos en salida de terminal).
--[no]expand_test_suites
predeterminado: “verdadero”- Expande los objetivos test_suite en sus pruebas constituyentes antes del análisis. Cuando esta marca está activada (predeterminada), se aplicarán los patrones de orientación negativa a las pruebas que pertenezcan al conjunto de pruebas; de lo contrario, no se aplicarán. Desactivar esta marca es útil cuando se aplican aspectos de nivel superior en la línea de comandos, ya que pueden analizar los destinos test_suite.
Etiquetas:loading_and_analysis
- Se acumulan
--experimental_credential_helper=<An (unresolved) path to a credential helper for a scope.>
usos múltiples - Configura el auxiliar de credenciales que se usará a fin de recuperar credenciales para el permiso proporcionado (dominio). Las credenciales de los auxiliares de credenciales tienen prioridad sobre las de <code>--google_default_credentials</code>, `--google_credentials` o <code>.netrc</code>. Consulta https://github.com/bazelbuild/proposals/blob/main/designs/2022-06-07-bazel-credential-helpers.md para obtener más detalles.
- Valor predeterminado de
--experimental_credential_helper_cache_duration=<An immutable length of time.>
: "30 m" - Configura la duración de las credenciales que se almacenan en caché las credenciales de los auxiliares de credenciales. La invocación con un valor diferente ajustará la vida útil de las entradas preexistentes; pasa cero para borrar la caché. Un comando limpio siempre borra la caché, sin importar esta marca.
--experimental_credential_helper_timeout=<An immutable length of time.>
predeterminado: "5 s"- Configura el tiempo de espera para el auxiliar de credenciales. Los auxiliares de credenciales que no respondan en este tiempo de espera fallarán la invocación.
--experimental_dynamic_ignore_local_signals=<a comma-separated list of signal numbers>
predeterminado: ver descripción-
Toma una lista de números de indicadores del SO. Si se finaliza una rama local de ejecución dinámica con cualquiera de estas señales, la rama remota podrá finalizar en su lugar. En el caso de los trabajadores persistentes, esto solo afecta a los indicadores que finalizan el proceso de los trabajadores.
Etiquetas:execution
--experimental_execution_log_file=<a path>
predeterminado: ver descripción- Registra las generaciones ejecutadas en este archivo como protos de spawn delimitados por src/main/protobuf/spawn.proto. Este archivo está escrito en el orden de ejecución de los spawn. Marcas relacionadas: --execution_log_binary_file (formato binario protobuf), --execution_log_json_file (formato JSON de texto ordenado), subcomandos (para mostrar subcomandos en el resultado de la terminal).
- Valor predeterminado de
--[no]experimental_execution_log_spawn_metrics
: “falso” - Incluye las métricas de spawn en el registro de spawn ejecutados.
--experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
predeterminado: ""- Obsoleto y reemplaza los aspectos. Filtra un conjunto de objetivos para los que se deben programar acciones adicionales.
- Valor predeterminado de
--[no]experimental_extra_action_top_level_only
: “falso” - Obsoleto y reemplaza los aspectos. Solo programa acciones adicionales para objetivos de nivel superior.
--[no]experimental_prioritize_local_actions
predeterminado: “verdadero”- Si se configura, las acciones que solo pueden ejecutarse de forma local tienen la primera oportunidad de adquirir recursos, los trabajadores de ejecución dinámica tienen una segunda oportunidad y las acciones independientes ejecutadas de forma dinámica son las últimas.
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 para una acción mnemónica individual, usa los marcadores `--internal_spawn_scheduler` y `--strategy=<mnemonic>=dynamic` en su lugar.
Se expande a:
--internal_spawn_scheduler
--spawn_strategy=dynamic
- Valor predeterminado de
--[no]experimental_worker_sandbox_hardening
: “falso” - Si están habilitados, los trabajadores se ejecutan en una zona de pruebas endurecida, si la implementación lo permite.
Etiquetas:execution
--google_auth_scopes=<comma-separated list of options>
predeterminado: “https://www.googleapis.com/auth/cloud-platform”- Una lista separada por comas de los permisos de autenticación de Google Cloud.
--google_credentials=<a string>
predeterminado: ver descripción- Especifica el archivo del que se obtendrán las credenciales de autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más detalles.
- Valor predeterminado de
--[no]google_default_credentials
: “falso” - Determina si se deben usar las “credenciales predeterminadas de la aplicación de Google” en la autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más detalles. Inhabilitada de forma predeterminada.
--grpc_keepalive_time=<An immutable length of time.>
predeterminado: ver descripción- Configura pings keep-alive para conexiones de gRPC salientes. Si se configura, Bazel envía pings después de este tiempo sin operaciones de lectura en la conexión, pero solo si hay al menos una llamada de gRPC pendiente. Los horarios se tratan como segundo nivel de detalle; es un error establecer un valor inferior a un segundo. De forma predeterminada, los pings keep-alive están inhabilitados. Debes coordinar con el propietario del servicio antes de habilitar esta configuración. Por ejemplo, para establecer un valor de 30 segundos en esta marca, se debe hacer de la siguiente manera: grpc_keepalive_time=30s
- Valor predeterminado de
--grpc_keepalive_timeout=<An immutable length of time.>
: "20 s" - Configura un tiempo de espera de keep-alive para las conexiones salientes de gRPC. 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 tratan como segundo nivel de detalle; es un error establecer un valor inferior a un segundo. Si los pings keep-alive están inhabilitados, se ignora esta configuración.
- Valor predeterminado de
--[no]ignore_unsupported_sandboxing
: “falso” - No muestres una advertencia cuando la ejecución en la zona de pruebas no sea compatible con este sistema.
- Valor predeterminado de
--[no]incompatible_dont_use_javasourceinfoprovider
: “falso” -
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 Bazel a fin de invertir en acciones de compilación ejecutadas de manera 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 calcular la cantidad de núcleos de CPU disponibles.
- Valor predeterminado de
--local_ram_resources=<an integer, or "HOST_RAM", optionally followed by [-|*]<float>.>
: “HOST_RAM*.67” - Configura de forma explícita la cantidad total de RAM del host local (en MB) disponible para Bazel a fin de invertir en acciones de compilación ejecutadas de manera 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 calcular la cantidad de RAM disponible y utilizará el 67% de ella.
- Valor predeterminado de
--local_termination_grace_seconds=<an integer>
: “15” - Es el tiempo de espera entre la finalización de un proceso local debido al tiempo de espera y el cierre forzado.
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con un directorio local.
--package_path=<colon-separated list of options>
predeterminado: "%workspace%"- Es una lista separada por dos puntos sobre dónde buscar paquetes. Los elementos que comienzan con "%workspace%" se relacionan con el espacio de trabajo que lo contiene. Si se omite o está vacío, el valor predeterminado es el resultado de "bazel info default-package-path".
--[no]show_loading_progress
predeterminado: “verdadero”- Si se habilita, hace que Bazel imprima mensajes de "Cargando paquete".
--test_lang_filters=<comma-separated list of options>
predeterminado: ""- Especifica una lista separada por comas de idiomas de prueba. De manera opcional, cada idioma puede estar precedido por "-" para especificar los idiomas excluidos. Solo se encontrarán los objetivos de prueba que estén escritos en los idiomas especificados. El nombre utilizado para cada idioma debe ser el mismo que el prefijo del idioma en la regla *_test, p.ej., "cc", "java", "py", etc. Esta opción afecta el comportamiento --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 separada por comas de tamaños de prueba. De manera opcional, cada tamaño puede estar precedido 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 --build_tests_only y el comando de prueba.
--test_tag_filters=<comma-separated list of options>
predeterminado: ""- Especifica una lista separada por comas de etiquetas de prueba. De manera opcional, cada etiqueta puede estar precedida por "-" para especificar etiquetas excluidas. Solo se encontrarán los objetivos de prueba que contengan al menos una etiqueta incluida y no contengan ninguna etiqueta excluida. Esta opción afecta el comportamiento --build_tests_only y el comando 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 prueba. De manera opcional, cada tiempo de espera puede estar precedido por "-" para especificar los tiempos de espera excluidos. Solo se detectarán los destinos de prueba que contengan al menos un tiempo de espera incluido y que no contengan ningún tiempo de espera excluido. Esta opción afecta el comportamiento --build_tests_only y el comando de prueba.
--tls_certificate=<a string>
predeterminado: ver descripción- Especifica una ruta de acceso a un certificado TLS que sea de confianza para firmar los certificados de servidor.
--tls_client_certificate=<a string>
predeterminado: ver descripción- Especifica el certificado de cliente de TLS que se usará. También debes proporcionar una clave de cliente para habilitar la autenticación del cliente.
--tls_client_key=<a string>
predeterminado: ver descripción- Especifica la clave de cliente de TLS que se usará. También debes proporcionar un certificado de cliente para habilitar la autenticación del cliente.
--workspace_status_command=<path>
predeterminado: ""- Es un comando que se invoca al comienzo de la compilación para proporcionar información de estado sobre el lugar de trabajo en el formato de pares clave-valor. Consulte el manual del usuario para obtener la especificación completa. Consulta también tools/buildstamp/get_workspace_status para ver un ejemplo.
- Opciones para controlar la ejecución de la compilación:
- Valor predeterminado de
--[no]check_up_to_date
: “falso” -
No realices la compilación, solo debes comprobar si está actualizada. Si todos los destinos están actualizados, la compilación se completará de forma correcta. Si algún paso debe ejecutarse, se informa un error y la compilación falla.
Etiquetas:execution
- Valor predeterminado de
--[no]experimental_inprocess_symlink_creation
: “falso” -
Determina si se deben realizar llamadas directas al sistema de archivos para crear árboles de enlaces simbólicos.
Etiquetas:loading_and_analysis
,execution
,experimental
- Valor predeterminado de
--[no]experimental_remotable_source_manifests
: “falso” -
Determina si se deben realizar acciones remotas en el manifiesto de origen.
Etiquetas:loading_and_analysis
,execution
,experimental
- Valor predeterminado de
--[no]experimental_split_coverage_postprocessing
: “falso” -
Si es verdadero, Bazel ejecutará el procesamiento posterior de la cobertura para pruebas en un nuevo campo de generación.
Etiquetas:execution
--[no]experimental_split_xml_generation
predeterminado: “verdadero”-
Si se establece esta marca y una acción de prueba no genera un archivo test.xml, Bazel usará una acción separada para generar un archivo test.xml ficticio que contenga el registro de prueba. De lo contrario, Bazel genera una prueba.xml como parte de la acción de prueba.
Etiquetas:execution
- Valor predeterminado de
--[no]experimental_strict_fileset_output
: “falso” - Si esta opción está habilitada, los conjuntos de archivos tratarán todos los artefactos de salida como archivos normales. No desvían directorios ni son sensibles a los symlinks.
Etiquetas:execution
--genrule_strategy=<comma-separated list of options>
predeterminado: ""- Especifica cómo ejecutar genrules. Esta marca se eliminará de forma gradual. En cambio, utiliza --spawn_strategy=<value> para controlar todas las acciones o --strategy=Genrule=<value> para controlar solo las reglas de generación.
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 seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". Los valores deben estar entre 1 y 5,000. Los valores superiores a 2,500 pueden causar problemas de memoria. "automático" calcula un valor predeterminado razonable en función de los recursos del host.
Etiquetas:host_machine_resource_optimizations
,execution
--[no]keep_going
[-k
] predeterminado: "false"- Continúa después de un error. Si bien el objetivo con errores y los que dependen de él no se pueden analizar, otros requisitos previos pueden serlo.
Etiquetas:eagerness_to_exit
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
predeterminado: "automático"-
Cantidad de subprocesos paralelos que se usarán en la fase de carga o análisis. Toma un número entero o una palabra clave ("automático", "HOST_CPUS", "HOST_RAM"), opcionalmente seguido de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". "auto" establece un valor predeterminado razonable en función de los recursos del host. Debe ser 1 como mínimo.
Etiquetas:bazel_internal_configuration
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
predeterminado: ""- Agrega o quita claves de la información de ejecución de una acción según la actividad nemotécnica. 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 se pueden aplicar muchas regex a la misma mnemónica.
Sintaxis: "regex=[+-]clave,regex=[+-]clave,...".
Ejemplos: ".*=+x,.*=-y,.*=+z" agrega "x" y "z" a la información de ejecución de todas las acciones, y la quita "y".
"Genrule=+require-x" agrega "require-x" a la información de ejecución para todas las acciones de Genrule.
“(?!Genrule).*=-require-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 acciones persistentes de dex y desugaring con trabajadores.
Se expande a:
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
- Habilita el procesador de recursos persistentes de Android mediante el uso de 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
{1/2}{1/2} --persistent_multiplex_android_dex_desugar
- Habilita las acciones de dex multiplexas persistentes y las acciones de expansión de sintaxis mediante el uso de trabajadores.
Se expande a:
--persistent_android_dex_desugar
--modify_execution_info=Desugar=+supports-multiplex-workers
--modify_execution_info=DexBuilder=+supports-multiplex-workers
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
- Habilita el procesador de recursos multiplexado persistente de Android mediante el uso de 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
{1/2}{1/2} --persistent_multiplex_android_tools
- Habilita herramientas de Android persistentes y multiplexadas (dexing, expansión de sintaxis y procesamiento de recursos).
Se expande a:
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Etiquetas:host_machine_resource_optimizations
,execution
--spawn_strategy=<comma-separated list of options>
predeterminado: ""- Especifica cómo se ejecutan las acciones de generación de forma predeterminada. Acepta una lista separada por comas de las estrategias de mayor a menor prioridad. Para cada acción, Bazel elige la estrategia con la prioridad más alta que puede ejecutar la acción. El valor predeterminado es “remote,worker,sandboxed,local”. Consulta https://blog.bazel.build/2019/06/19/list-strategy.html para obtener más información.
Etiquetas:execution
- Se acumulan
--strategy=<a '[name=]value1[,..,valueN]' assignment>
usos múltiples - Especifica cómo distribuir la compilación de otras acciones de generación. Acepta una lista separada por comas de las estrategias 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 mnemonic Genrule). Consulta https://blog.bazel.build/2019/06/19/list-strategy.html para obtener más información.
Etiquetas:execution
- Se acumulan
--strategy_regexp=<a '<RegexFilter>=value[,value]' assignment>
usos múltiples -
Anula la estrategia de generación que debería usarse para ejecutar acciones de generación que tengan descripciones que coincidan con un determinado regex_filter. Consulta --per_file_copt para conocer los detalles de la coincidencia de regex_filter. Se usa el último regex_filter que coincide con la descripción. Esta opción anula otras marcas para especificar la estrategia. Ejemplo: --strategy_regexp=//foo.*\.cc,-//foo/bar=local significa ejecutar acciones con una 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á "Compilación //foo/bar/baz" con la estrategia "local", pero revertir el orden lo ejecutaría con "zona de pruebas".
Etiquetas:execution
- Opciones que configuran la cadena de herramientas que se usa para ejecutar la acción:
--android_compiler=<a string>
predeterminado: ver descripción-
El compilador de destino de Android
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Valor predeterminado de
--android_crosstool_top=<a build target label>
: "//external:android/crosstool" -
La ubicación del compilador C++ que se usó para las compilaciones de Android.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_grte_top=<a label>
predeterminado: ver descripción- El destino androidte: grte_top
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
- Valor predeterminado de
--android_manifest_merger=<legacy, android or force_android>
: "android" -
Selecciona la combinación de manifiestos que se usará para las reglas de android_binary. Marca para ayudar a la transición a la fusión de manifiesto de Android desde la fusión heredada.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_platforms=<a build target label>
predeterminado: ""-
Configura las plataformas que usan los objetivos de android_binary. Si se especifican varias plataformas, el objeto binario es un APK multiarquitectura, que contiene objetos binarios nativos para cada plataforma de destino especificada.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_sdk=<a build target label>
predeterminado: "@bazel_tools//tools/android:sdk"-
Especifica la plataforma o el SDK de Android que se usa a fin de compilar aplicaciones para Android.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--apple_compiler=<a string>
predeterminado: 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”-
Es la etiqueta del paquete crosstool que se usará en las reglas de Apple y Objc, y sus dependencias.
Etiquetas:loses_incremental_state
,changes_inputs
--apple_grte_top=<a build target label>
predeterminado: ver descripción-
El objetivo de grte_top de Apple.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--cc_output_directory_tag=<a string>
predeterminado: ""-
Especifica un sufijo para agregarlo al directorio de configuración.
Etiquetas:affects_outputs
,explicit_in_output_path
--compiler=<a string>
predeterminado: ver descripción- El compilador 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"-
Es la ubicación del objeto binario que se usa para procesar con anterioridad los informes de cobertura sin procesar. Actualmente, debe ser un grupo de archivos que contenga un solo archivo (el objeto binario). La configuración predeterminada es “//tools/test:lcov_merger”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
- Valor predeterminado de
--coverage_report_generator=<a build target label>
: “@bazel_tools//tools/test:coverage_report_generator” -
Es la ubicación del objeto binario que se usa para generar los informes de cobertura. Actualmente, debe ser un grupo de archivos que contenga un solo archivo (el objeto binario). La configuración predeterminada es “//tools/test:coverage_report_generator”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
- Valor predeterminado de
--coverage_support=<a build target label>
: "@bazel_tools//tools/test:coverage_support" -
Ubicación de los archivos de asistencia obligatorios en las entradas de cada acción de prueba que recopila la cobertura del 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 crosstool que se usará para compilar el código C++.
Etiquetas:loading_and_analysis
,changes_inputs
,affects_outputs
--custom_malloc=<a build target label>
predeterminado: ver descripción-
Especifica una implementación personalizada de malloc. Esta 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 destino no coincide con ninguna expresión negativa y al menos una expresión positiva, la resolución de su cadena de herramientas se realizará como si hubiera declarado los valores de restricción como restricciones de ejecución. Ejemplo: //demo,-test=@platforms//cpus:x86_64 agregará 'x86_64' a cualquier destino en //demo, excepto aquellos cuyo nombre contenga 'test'.
Etiquetas:loading_and_analysis
--[no]experimental_enable_objc_cc_deps
predeterminado: “verdadero”-
Permite que las reglas objc_* dependan de cc_library y haga que las dependencias objc se compilen con --cpu establecido en "ios_<--ios_cpu>" para cualquier valor en --ios_multi_cpu.
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]experimental_include_xcode_execution_requirements
: “falso” -
Si se configura, agrega un requisito de ejecución "require-xcode:{version}" a cada acción de Xcode. Si la versión xcode tiene una etiqueta con guion, agrega también un requisito de ejecución “require-xcode-label:{version_label}.
Etiquetas:loses_incremental_state
,loading_and_analysis
,execution
--[no]experimental_prefer_mutual_xcode
predeterminado: “verdadero”-
Si es verdadero, usa el Xcode más reciente que esté disponible de forma local y remota. Si es falso, o si no hay versiones mutuas disponibles, utiliza 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 - Las plataformas que están disponibles como plataformas de ejecución para ejecutar acciones. Las plataformas pueden especificarse por objetivo exacto o como un patrón de destino. Se considerarán estas plataformas antes de las que se declaran en el archivo WORKSPACE mediante register_execution_platforms().
Etiquetas:execution
- Se acumulan
--extra_toolchains=<comma-separated list of options>
usos múltiples - Las reglas de la cadena de herramientas se deben tener en cuenta durante su resolución. Las cadenas de herramientas se pueden especificar mediante un objetivo exacto o como un patrón de destino. Estas cadenas de herramientas se tendrán en cuenta antes de las que se registraron en el archivo WORKSPACE.
--grte_top=<a label>
predeterminado: ver descripción-
Etiqueta a una biblioteca libc registrada. El conjunto de herramientas Crosstool selecciona el valor predeterminado, y casi nunca es necesario anularlo.
Etiquetas:action_command_lines
,affects_outputs
--host_compiler=<a string>
predeterminado: ver descripción-
El compilador C++ que se usará en la compilación del host. Se ignora si no se establece --host_crosstool_top.
Etiquetas:loading_and_analysis
,execution
--host_crosstool_top=<a build target label>
predeterminado: 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 determinada.
Etiquetas:loading_and_analysis
,changes_inputs
,affects_outputs
--host_grte_top=<a label>
predeterminado: ver descripción- Si se especifica, esta configuración anula el directorio de nivel superior de libc (--grte_top) para la configuración del host.
Etiquetas:action_command_lines
,affects_outputs
--host_platform=<a build target label>
predeterminado: ""- Es la etiqueta de una regla de plataforma que describe el sistema host.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--[no]incompatible_disable_expand_if_all_available_in_flag_set
predeterminado: “verdadero”-
Si es verdadero, Bazel no permitirá especificar expand_if_all_available en flag_sets(consulte https://github.com/bazelbuild/bazel/issues/7008 para obtener instrucciones de migración).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
predeterminado: “verdadero”-
Si es verdadero, Bazel no habilitará las funciones "host" y "nonhost" en la cadena de herramientas de c++ (consulte https://github.com/bazelbuild/bazel/issues/7407 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]incompatible_enable_android_toolchain_resolution
: “falso” -
Usa la resolución de la cadena de herramientas a fin de seleccionar el SDK de Android para las reglas de Android (Starlark y nativo)
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]incompatible_enable_apple_toolchain_resolution
: “falso” -
Usa la resolución de la cadena de herramientas con el fin de seleccionar el SDK de Apple para las reglas de Apple (nativo y Starlark)
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone
predeterminado: “verdadero”-
Si es verdadero, Bazel no volverá a usar las líneas de comandos de la acción de vínculo de C++ para las líneas de comandos de indexación de lto (consulte https://github.com/bazelbuild/bazel/issues/6791 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]incompatible_objc_linking_info_migration
: “falso” -
Si es verdadero, las reglas integradas de ObjC obtendrán su información de vinculación desde CcInfo en lugar de ObjcProvider. Consulta https://github.com/bazelbuild/bazel/issues/16939 para obtener más detalles y detalles sobre la migración.
Etiquetas:loading_and_analysis
,changes_inputs
,incompatible_change
--[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain
predeterminado: “verdadero”-
Si es verdadero, Bazel se quejará cuando se establezcan los atributos cc_toolchain.cpu y cc_toolchain.compiler (consulte https://github.com/bazelbuild/bazel/issues/7075 para obtener instrucciones de migración).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_legacy_whole_archive
predeterminado: “verdadero”-
Si es verdadero, Bazel no vinculará las dependencias de la biblioteca como archivo completo de forma predeterminada (consulte https://github.com/bazelbuild/bazel/issues/7362 para obtener instrucciones de migración).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_require_ctx_in_configure_features
predeterminado: “verdadero”-
Si es verdadero, Bazel requerirá el parámetro “ctx” en cc_common.configure_features (consulte 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 son compatibles con la cadena de herramientas. Todas las cadenas de herramientas de ELF actualmente admiten esta configuración.
Etiquetas:loading_and_analysis
,affects_outputs
,affects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: ver descripción-
Especifica la versión del SDK de iOS que se usará para compilar aplicaciones para iOS. Si no se especifica, se usa la versión predeterminada del SDK de iOS a partir de "xcode_version".
Etiquetas:loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: ver descripción-
Especifica la versión del SDK de macOS que se usará para compilar las aplicaciones para macOS. Si no se especifica, se usa la versión predeterminada del SDK de macOS de 'xcode_version'.
Etiquetas:loses_incremental_state
--minimum_os_version=<a string>
predeterminado: ver descripción-
Es la versión mínima del SO a la que se orienta tu compilación.
Etiquetas:loading_and_analysis
,affects_outputs
--platform_mappings=<a relative path>
predeterminado: ""-
La ubicación de un archivo de asignación que describe qué plataforma usar si no se configuró ninguna o qué marcas establecer cuando ya existe una plataforma. Debe estar relacionado con la raíz del espacio de trabajo principal. La configuración predeterminada es “platform_mappings” (un archivo ubicado directamente en la raíz del espacio de trabajo).
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--platforms=<a build target label>
predeterminado: ""-
Las etiquetas de las reglas de la plataforma que describen las plataformas de destino del comando actual.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--python2_path=<a string>
predeterminado: ver descripción-
Obsoleto, no-op. Inhabilitado por `--incompatible_use_python_toolchains`.
Etiquetas:no_op
,deprecated
--python3_path=<a string>
predeterminado: ver descripción-
Obsoleto, no-op. Inhabilitado por `--incompatible_use_python_toolchains`.
Etiquetas:no_op
,deprecated
--python_path=<a string>
predeterminado: ver descripción- La ruta de acceso absoluta del intérprete de Python invocada para ejecutar destinos de Python en la plataforma de destino. Obsoleto; inhabilitado por --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
--python_top=<a build target label>
predeterminado: ver descripción-
Es la etiqueta de un py_runtime que representa al 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
- Valor predeterminado de
--target_platform_fallback=<a build target label>
: “@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 se asigna el conjunto actual de marcas.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: 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
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: 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 desde 'xcode_version'.
Etiquetas:loses_incremental_state
--xcode_version=<a string>
predeterminado: ver descripción-
Si se especifica, usa Xcode de la versión determinada para las acciones de compilación relevantes. Si no se especifica, se usa la versión predeterminada de Xcode para ejecutar.
Etiquetas:loses_incremental_state
- Valor predeterminado de
--xcode_version_config=<a build target label>
: "@bazel_tools//tools/cpp:host_xcodes" -
Es la etiqueta de la regla xcode_config que se usará para seleccionar la versión de Xcode en la configuración de compilación.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Opciones que controlan el resultado del comando:
- Valor predeterminado de
--[no]apple_enable_auto_dsym_dbg
: “falso” -
Determina si se fuerza la habilitación de la generación de archivos de símbolos de depuración (.dSYM) para las compilaciones dbg.
Etiquetas:affects_outputs
,action_command_lines
- Valor predeterminado de
--[no]apple_generate_dsym
: “falso” -
Indica si se deben generar archivos de símbolos de depuración (.dSYM).
Etiquetas:affects_outputs
,action_command_lines
--[no]build
predeterminado: “verdadero”- Ejecuta la compilación (este es el comportamiento habitual). Cuando se especifica --nobuild, la compilación se detiene antes de ejecutar las acciones de compilación, y se muestran cero si las fases de carga y análisis del paquete se completaron correctamente. Este modo es útil para probar esas fases.
Etiquetas:execution
,affects_outputs
--[no]build_runfile_links
predeterminado: “verdadero”-
Si es verdadero, compila bosques de archivos de symlink de runfiles para todos los destinos. Si es falso, escriba solo los manifiestos cuando sea posible.
Etiquetas:affects_outputs
--[no]build_runfile_manifests
predeterminado: “verdadero”-
Si es verdadero, escribe manifiestos de archivos de ejecución para todos los destinos. Si es falso, omítelo. Las pruebas locales no se ejecutarán cuando sean falsas.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]build_test_dwp
: “falso” -
Si se habilita, cuando se compilen pruebas de C++ de manera estática y con fisiones, también se compilará automáticamente el archivo .dwp para los objetos binarios de las pruebas.
Etiquetas:loading_and_analysis
,affects_outputs
- Valor predeterminado de
--cc_proto_library_header_suffixes=<comma-separated list of options>
: “.pb.h” -
Establece los prefijos de los archivos de encabezado que crea una cc_proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
- Valor predeterminado de
--cc_proto_library_source_suffixes=<comma-separated list of options>
: “.pb.cc” -
Establece los prefijos de los archivos de origen que crea una cc_proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
- Valor predeterminado de
--[no]experimental_proto_descriptor_sets_include_source_info
: “falso” - Ejecuta acciones adicionales para versiones de API alternativas de Java en una proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
- Valor predeterminado de
--[no]experimental_proto_extra_actions
: “falso” - Ejecuta acciones adicionales para versiones de API alternativas de Java en una proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_run_validations
predeterminado: “verdadero”- Usa --run_validates en su lugar.
Etiquetas:execution
,affects_outputs
- Valor predeterminado de
--[no]experimental_save_feature_state
: “falso” - Guarda el estado de las funciones habilitadas y solicitadas como resultado de una compilación.
Etiquetas:affects_outputs
,experimental
- Valor predeterminado de
--[no]experimental_use_validation_aspect
: “falso” - Determina si se deben ejecutar acciones de validación mediante el aspecto (para paralelismo con pruebas).
Etiquetas:execution
,affects_outputs
--fission=<a set of compilation modes>
predeterminado: "no".-
Especifica los modos de compilación que usan fisión para las compilaciones y los vínculos de C++. Puede ser cualquier combinación de {'fastbuild', 'dbg', 'opt'} o los valores especiales 'yes' para habilitar todos los modos y 'no' para inhabilitar todos los modos.
Etiquetas:loading_and_analysis
,action_command_lines
,affects_outputs
--[no]incompatible_always_include_files_in_data
predeterminado: “verdadero”-
Si es verdadero, las reglas nativas agregan <code>DefaultInfo.files</code> de las dependencias de datos a sus archivos runfile, lo que coincide con el comportamiento recomendado para las reglas de Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid).
Etiquetas:affects_outputs
,incompatible_change
--[no]legacy_external_runfiles
predeterminado: “verdadero”-
Si es verdadero, compile bosques de symlink de runfiles para repositorios externos en .runfiles/wsname/external/repo (además de .runfiles/repo).
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]objc_generate_linkmap
: “falso” -
Especifica si se 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 con el prefijo + o el signo -. Un grupo con el prefijo + se agrega al conjunto predeterminado de grupos de salida, mientras que el grupo con el prefijo - se quita del conjunto predeterminado. Si al menos un grupo no tiene un 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 barra, mientras que --output_groups=foo,bar anula el conjunto predeterminado de manera que solo se compilan foo y bar.
Etiquetas:execution
,affects_outputs
--[no]run_validations
predeterminado: “verdadero”-
Determina si se deben ejecutar acciones de validación como parte de la compilación. Consulta https://bazel.build/extending/rules#validation_actions
Etiquetas:execution
,affects_outputs
- Valor predeterminado de
--[no]save_temps
: “falso” -
Si se configura, se guardarán los resultados temporales de gcc. Entre estos archivos, se incluyen los archivos .s (código ensamblador), los archivos .i (C preprocesados) y los archivos .ii (C++ procesados).
Etiquetas:affects_outputs
- Opciones que permiten que el usuario configure el resultado deseado y afecte su valor, a diferencia de su existencia:
- Se acumulan
--action_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica el conjunto de variables de entorno disponibles para las acciones con la configuración objetivo. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación o por el par nombre=valor que establece el valor independientemente del entorno de invocación. Esta opción se puede utilizar varias veces. En el caso de las opciones proporcionadas para la misma variable, las últimas victorias se acumulan, las opciones para las diferentes variables se acumulan.
Etiquetas:action_command_lines
- Valor predeterminado de
--android_cpu=<a string>
: “armeabi-v7a” -
La CPU de destino de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Valor predeterminado de
--[no]android_databinding_use_androidx
: “falso” -
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
,experimental
- Valor predeterminado de
--[no]android_databinding_use_v3_4_args
: “falso” -
Usa la vinculación de datos de Android v2 con el argumento 3.4.0
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--android_dynamic_mode=<off, default or fully>
predeterminado: "desactivado"-
Determina si los dependencias de C++ de las reglas de Android se vincularán de forma dinámica cuando un cc_binary no cree explícitamente una biblioteca compartida. "default" significa que Bazel elegirá si se vincula de forma dinámica. "completamente" significa que todas las bibliotecas se vincularán de forma dinámica. "Desactivada" significa que todas las bibliotecas estarán vinculadas en su mayoría en modo estático.
Etiquetas:affects_outputs
,loading_and_analysis
- Valor predeterminado de
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
: "alfabético". -
Establece el orden de los manifiestos que se pasan a la combinación de manifiestos para los objetos binarios de Android. ALFABÉTICO significa que los manifiestos se ordenan según la ruta de acceso en relación con la ejecución de reglas. ALPHABETICAL_BY_CONFIGURATION significa que los manifiestos se ordenan según las rutas de acceso relativas al directorio de configuración dentro del directorio de salida. DEPENDENCY significa que los manifiestos se ordenan con cada manifiesto de la biblioteca antes que los manifiestos de sus dependencias.
Etiquetas:action_command_lines
,execution
- Valor predeterminado de
--[no]android_resource_shrinking
: “falso” -
Habilita la reducción de recursos para APK 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, 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 la forma “[platform=]mode”, en la 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 para 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 comas que se aplicarán a los objetivos de nivel superior. En la lista, si el aspecto some_aspect especifica los proveedores de aspecto obligatorios mediante el campo required_aspect_providers, algunos_aspect se ejecutarán después de cada aspecto que se mencionó antes en la lista de aspectos cuyos proveedores publicitados cumplen con algunos proveedores de aspecto obligatorios. Además, some_aspect se ejecutará después de todos los aspectos obligatorios que especifica el atributo required. Luego, el else_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 de herramientas/my_def.bzl.
--[no]build_python_zip
predeterminado: "automático"-
Compila el ZIP ejecutable 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 cuales crear objetos binarios de Catalyst de Apple.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Valor predeterminado de
--[no]collect_code_coverage
: “falso” -
Si se especifica, Bazel instrumentará el código (mediante la instrumentación sin conexión) 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 se debe especificar directamente; en su lugar, se debe usar el comando “bazelcover”.
Etiquetas:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] predeterminado: "fastbuild"-
Especifica el modo en que se compilará el objeto binario. Valores: “fastbuild”, “dbg”, “opt”.
Etiquetas:affects_outputs
,action_command_lines
,explicit_in_output_path
- Se acumulan
--conlyopt=<a string>
usos múltiples -
Opción adicional de 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
--cs_fdo_absolute_path=<a string>
predeterminado: ver descripción-
Usa la información del perfil de CSFDO para optimizar la compilación. Especifica el nombre de ruta de acceso absoluta del archivo ZIP que contiene el archivo de perfil, un archivo de perfil de LLVM sin procesar o indexado.
Etiquetas:affects_outputs
--cs_fdo_instrument=<a string>
predeterminado: ver descripción-
Genera objetos binarios con instrumentación de FDO contextual. Con el compilador de Clang/LLVM, también acepta el nombre del directorio bajo el cual se volcarán los archivos del perfil sin procesar en el tiempo de ejecución.
Etiquetas:affects_outputs
--cs_fdo_profile=<a build target label>
predeterminado: 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 -
Opción adicional de 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 de definición especifica una asignación para una variable de compilación.
Etiquetas:changes_inputs
,affects_outputs
--dynamic_mode=<off, default or fully>
predeterminado: “predeterminado”-
Determina si los objetos binarios de C++ se vincularán de forma dinámica. "predeterminado" significa que Bazel elegirá si desea vincular de forma dinámica. "completamente" significa que todas las bibliotecas se vincularán de forma dinámica. "Desactivada" significa que todas las bibliotecas estarán vinculadas en su mayoría en modo estático.
Etiquetas:loading_and_analysis
,affects_outputs
--[no]enable_fdo_profile_absolute_path
predeterminado: “verdadero”-
Si se establece, el uso de fdo_absolute_profile_path generará un error.
Etiquetas:affects_outputs
--[no]enable_runfiles
predeterminado: "automático"- Habilitar el árbol de symlink de runfiles; de forma predeterminada, está desactivado en Windows y en otras plataformas.
Etiquetas:affects_outputs
- Se acumulan
--experimental_action_listener=<a build target label>
usos múltiples - Obsoleto y reemplaza los aspectos. Usa action_listener para adjuntar una acción adicional a las acciones de compilación existentes.
Etiquetas:execution
,experimental
- Valor predeterminado de
--[no]experimental_android_compress_java_resources
: “falso” -
Comprime los recursos de Java en los APK
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
- Valor predeterminado de
--[no]experimental_android_databinding_v2
: “falso” -
Usa la vinculación de datos de Android v2
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Valor predeterminado de
--[no]experimental_android_resource_shrinking
: “falso” -
Habilita la reducción de recursos para APK de android_binary que usan ProGuard.
Etiquetas:affects_outputs
,loading_and_analysis
- Valor predeterminado de
--[no]experimental_android_rewrite_dexes_with_rex
: “falso” -
Usa la herramienta rex para reescribir archivos dex.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_convenience_symlinks
predeterminado: "normal"-
Esta marca controla cómo se administrarán los symlinks de conveniencia (los symlinks que aparecen en el lugar de trabajo después de la compilación). Valores posibles: normal (predeterminado): cada tipo de conveniencia del symlink se creará o se borrará, según lo determinado por la compilación.
limpio: Se borrarán todos los symlinks de forma incondicional.
ignorar: Los vínculos simbólicos se dejarán solos.
log_only: Se generan mensajes de registro como si se pasara “normal”, pero en realidad no se realiza ninguna operación del sistema de archivos (útil para herramientas).
Tenga en cuenta que solo pueden verse afectados los symlinks cuyos nombres se generan con el valor actual de --symlink_prefix; si cambia el prefijo, los symlinks preexistentes se dejarán solos.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]experimental_convenience_symlinks_bep_event
: “falso” -
Esta marca controla si publicaremos o no el evento de compilación ConvenienceSymlinksIdentified en BuildEventProtocol. Si el valor es verdadero, BuildEventProtocol tendrá una entrada para convenienciaSymlinksIdentified e incluirá todos los symlinks de conveniencia creados en su 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-op.
Etiquetas:affects_outputs
,experimental
--experimental_objc_fastbuild_options=<comma-separated list of options>
predeterminado: "-O0,-DDEBUG=1"- Usa estas strings como opciones de compilador de objc fastbuild.
Etiquetas:action_command_lines
- Valor predeterminado de
--[no]experimental_omitfp
: “falso” - Si es verdadero, usa libunwind para desenrollar la pila y compila con -fomit-frame-pointer y -fasíncrona-unwind-tables.
Etiquetas:action_command_lines
,affects_outputs
,experimental
- Valor predeterminado de
--[no]experimental_platform_in_output_dir
: “falso” - Si es verdadero, la plataforma de destino se usa en el nombre del directorio de salida, en lugar de en la CPU.
Etiquetas:affects_outputs
,experimental
- Valor predeterminado de
--[no]experimental_use_llvm_covmap
: “falso” -
Si se especifica, Bazel generará información de mapa de cobertura llvm-cov en lugar de gcov cuando se habilite collect_code_coverage.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
- Valor predeterminado de
--fat_apk_cpu=<comma-separated list of options>
: “armeabi-v7a” -
Si configuras esta opción, se habilitan los APK multiarquitectura, que contienen objetos binarios nativos para todas las arquitecturas de destino especificadas, p.ej., --fat_apk_cpu=x86,armeabi-v7a. Si se especifica esta marca, se ignora --android_cpu para las dependencias de reglas de android_binary.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Valor predeterminado de
--[no]fat_apk_hwasan
: “falso” - Determina si se deben crear divisiones de HWASAN.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--fdo_instrument=<a string>
predeterminado: ver descripción- Genera objetos binarios con instrumentación de FDO. Con el compilador de Clang/LLVM, también acepta el nombre del directorio bajo el cual se volcarán los archivos del perfil sin procesar en el tiempo de ejecución.
Etiquetas:affects_outputs
--fdo_optimize=<a string>
predeterminado: ver descripción-
Usa la información de perfil de FDO para optimizar la compilación. Especifica el nombre de un archivo ZIP que contenga un árbol de archivos .gcda, un archivo Afdo que contenga un perfil automático o un archivo de perfil LLVM. Esta marca también acepta archivos especificados como etiquetas (p.ej., "//foo/bar:file.afdo"), es posible que debas agregar una directiva "exports_files" al paquete correspondiente) y etiquetas que apunten a objetivos "fdo_profile". Esta marca se reemplazará por la regla "fdo_profile".
Etiquetas:affects_outputs
--fdo_prefetch_hints=<a build target label>
predeterminado: ver descripción-
Usa sugerencias de precarga de caché.
Etiquetas:affects_outputs
--fdo_profile=<a build target label>
predeterminado: ver descripción- El fdo_profile que representa el perfil que se usará para la optimización.
Etiquetas:affects_outputs
- Se acumulan
--features=<a string>
usos múltiples -
Las funciones proporcionadas se habilitarán o inhabilitarán de forma predeterminada para todos los paquetes. Si especificas -<feature>, se inhabilitará la función globalmente. Los elementos negativos siempre anulan a los positivos. Esta marca se usa para habilitar la implementación de cambios de funciones predeterminadas sin una versión de Bazel.
Etiquetas:changes_inputs
,affects_outputs
- Valor predeterminado de
--[no]force_pic
: “falso” -
Si se habilita, todas las compilaciones de C++ producen código independiente de posición ("-fPIC"), los vínculos prefieren las bibliotecas compiladas previamente de PIC en lugar de las bibliotecas que no son de PIC, y los vínculos producen ejecutables independientes de posición ("-pie").
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan
--host_action_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica el conjunto de variables de entorno disponibles para las acciones con configuraciones de host o ejecución. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación o por el par nombre=valor que establece el valor independientemente del entorno de invocación. Esta opción se puede utilizar varias veces. En el caso de las opciones proporcionadas para la misma variable, las últimas victorias se acumulan, las opciones para las diferentes variables se acumulan.
Etiquetas:action_command_lines
- Valor predeterminado de
--host_compilation_mode=<fastbuild, dbg or opt>
: "optar" - Especifica el modo en que se incorporarán las herramientas que se usarán durante la compilación. Valores: “fastbuild”, “dbg”, “opt”.
Etiquetas:affects_outputs
,action_command_lines
- Se acumulan
--host_conlyopt=<a string>
usos múltiples -
Opción adicional para pasar al compilador C cuando compilas archivos de origen C (pero no de C++) en las configuraciones de host o ejecución.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--host_copt=<a string>
usos múltiples -
Opciones adicionales que se pasan al compilador C para las herramientas compiladas en la configuración del host o la ejecución.
Etiquetas:action_command_lines
,affects_outputs
--host_cpu=<a string>
predeterminado: ""-
La CPU host.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan
--host_cxxopt=<a string>
usos múltiples -
Opciones adicionales que se pasan al compilador C++ para herramientas compiladas en las configuraciones de host o ejecución.
Etiquetas:action_command_lines
,affects_outputs
--host_force_python=<PY2 or PY3>
predeterminado: 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 -
Opción adicional de pasar al vinculador cuando se vinculan herramientas en la configuración del host o la ejecución.
Etiquetas:action_command_lines
,affects_outputs
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: ver descripción-
Versión mínima compatible de macOS para las orientaciones del host. Si no se especifica, se usa “macos_sdk_version”.
Etiquetas:loses_incremental_state
- Se acumulan
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
usos múltiples -
Opciones adicionales para pasar de forma selectiva al compilador C/C++ cuando se compilan determinados archivos en la configuración del host o la ejecución. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Cuando regex_filter representa una lista de incluir y excluir patrones de expresión regular (también consulta --instrumentation_filter). option_1 a option_n significa opciones de línea de comandos arbitrarias. Si una opción contiene una coma, se debe incluir una barra invertida. Las opciones pueden contener el símbolo @. Solo se usa el primer símbolo @ para dividir la string. 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 de las herramientas del host
Etiquetas:action_command_lines
,affects_outputs
--[no]incompatible_avoid_conflict_dlls
predeterminado: “verdadero”-
Si está habilitada, se cambiará el nombre de todas las bibliotecas dinámicas vinculadas a C++ (DLL) generadas por cc_library en Windows a name_{hash}.dll, en las que el hash se calcula en función del repositorio RepositoryName y la ruta de acceso del paquete de la DLL. Esta opción es útil cuando tienes un paquete que depende de varias cc_library con el mismo nombre (p. ej., //foo/bar1:utils y //foo/bar2:utils).
Etiquetas:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_merge_genfiles_directory
predeterminado: “verdadero”-
Si es verdadero, el directorio genfiles se pliega en el directorio bin.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_use_platforms_repo_for_constraints
predeterminado: “verdadero”-
Si es verdadero, se quita la configuración de restricciones de @bazel_tools.
Etiquetas:affects_outputs
,incompatible_change
- Valor predeterminado de
--[no]instrument_test_targets
: “falso” - Cuando la cobertura está habilitada, especifica si se deben considerar instrumentar reglas de prueba. Cuando se configura, se instrumentan las reglas de prueba incluidas por --instrumentation_filter. De lo contrario, las reglas de prueba siempre se excluyen de la instrumentación de cobertura.
Etiquetas:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
predeterminado: "-/javatests[/:],-/test/java[/:]"- Cuando la cobertura está habilitada, solo se instrumentarán las reglas con nombres incluidos por el filtro basado en regex especificado. En su lugar, se excluyen las reglas con el prefijo “-”. Ten en cuenta que solo se instrumentan las reglas que no son de prueba, a menos que esté habilitada la herramienta --instrument_test_targets.
Etiquetas:affects_outputs
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: ver descripción-
Versión mínima compatible de iOS para simuladores y dispositivos de destino. Si no se especifica, se usa “ios_sdk_version”.
Etiquetas:loses_incremental_state
- Se acumulan
--ios_multi_cpus=<comma-separated list of options>
usos múltiples - Lista de arquitecturas separadas por comas para crear una aplicación de ios_application. El resultado es un objeto binario universal que contiene todas las arquitecturas especificadas.
Etiquetas:loses_incremental_state
,loading_and_analysis
--[no]legacy_whole_archive
predeterminado: “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 esté activada, use --all-archive para las reglas de cc_binary que tengan linkshared=True y linklink=True o '-static' en linkopts. Esto es solo para retrocompatibilidad. Una mejor alternativa es usar siemprelink=1 cuando sea necesario.
Etiquetas:action_command_lines
,affects_outputs
,deprecated
- Se acumulan
--linkopt=<a string>
usos múltiples -
Opción adicional de pasar a gcc durante la vinculación.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--ltobackendopt=<a string>
usos múltiples -
Opción adicional para pasar al paso de backend de LTO (en --features=thin_lto).
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--ltoindexopt=<a string>
usos múltiples -
Opción adicional para pasar al paso de indexación de LTO (en --features=thin_lto).
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--macos_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se pueden compilar los objetos binarios de macOS de Apple.
Etiquetas:loses_incremental_state
,loading_and_analysis
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: ver descripción-
Versión de macOS mínima compatible para los objetivos. Si no se especifica, se usa “macos_sdk_version”.
Etiquetas:loses_incremental_state
- Valor predeterminado de
--[no]objc_debug_with_GLIBCXX
: “falso” -
Si se configura, y el modo de compilación se configura en "dbg", defina GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC y GLIBCPP_CONCEPT_CHECKS.
Etiquetas:action_command_lines
- Valor predeterminado de
--[no]objc_enable_binary_stripping
: “falso” -
Determina si se deben quitar los símbolos y códigos no entregados de los objetos binarios vinculados. Se realizará la eliminación de objetos binarios si se especifican tanto esta marca como --compilation_mode=opt.
Etiquetas:action_command_lines
- Se acumulan
--objccopt=<a string>
usos múltiples -
Opciones adicionales para pasar a GCC cuando se compilan archivos de origen de Objective-C/C++.
Etiquetas:action_command_lines
- Se acumulan
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
usos múltiples -
Opciones adicionales para pasar de forma selectiva a gcc cuando se compilan determinados archivos Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Cuando regex_filter representa una lista de incluir y excluir patrones de expresión regular (también consulta --instrumentation_filter). option_1 a option_n significa opciones de línea de comandos arbitrarias. Si una opción contiene una coma, se debe incluir una barra invertida. Las opciones pueden contener el símbolo @. Solo se usa el primer símbolo @ para dividir la string. Ejemplo: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de la 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 determinados objetos de backend. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter representa una lista de incluir y excluir patrones de expresión regular. option_1 a option_n significa opciones de línea de comandos arbitrarias. Si una opción contiene una coma, se debe incluir una barra invertida. Las opciones pueden contener el símbolo @. Solo se usa el primer símbolo @ para dividir la string. Ejemplo: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 agrega la opción de la línea de comandos -O0 a la línea de comandos del backend de LTO de todos los archivos o en //foo/, excepto bar.o.
Etiquetas:action_command_lines
,affects_outputs
--platform_suffix=<a string>
predeterminado: ver descripción-
Especifica un sufijo para agregarlo al directorio de configuración.
Etiquetas:loses_incremental_state
,affects_outputs
,loading_and_analysis
--propeller_optimize=<a build target label>
predeterminado: ver descripción- Usa la información del perfil de propulsor para optimizar el destino de la compilación.Un perfil de propulsor debe tener al menos uno de dos archivos, uno de Cc y uno de ld. Este indicador 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 en a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)Es posible que se deba agregar una directiva export_files al paquete correspondiente para que Bazel pueda ver estos archivos. La opción se debe usar como: --propeller_optimize=//a/b:propeller_profile
Etiquetas:action_command_lines
,affects_outputs
--propeller_optimize_absolute_cc_profile=<a string>
predeterminado: ver descripción-
Nombre de ruta de acceso absoluta del archivo cc_profile para las compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
predeterminado: ver descripción-
Nombre de ruta de acceso absoluta del archivo ld_profile para las compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
--run_under=<a prefix in front of command>
predeterminado: ver descripción-
Prefijo que se debe insertar antes de los archivos ejecutables para los comandos "test" y "run". Si el valor es "foo -bar" y la línea de comandos de ejecución es "test_binary -baz", la línea de comandos final es "foo -bar test_binary -baz". También puede ser una etiqueta para un destino ejecutable. Algunos ejemplos son: 'valgrind', 'strace', 'strace -c', 'valgrind --quiet --num-callers=20', '//package:target', '//package:target --options'.
Etiquetas:action_command_lines
-
Si el valor es verdadero, las bibliotecas nativas que contienen una funcionalidad idéntica se compartirán entre diferentes destinos
Etiquetas:loading_and_analysis
,affects_outputs
- Valor predeterminado de
--[no]stamp
: “falso” -
Sella los objetos binarios con la fecha, el nombre de usuario, el nombre de host, la información del lugar de trabajo, etc.
Etiquetas:affects_outputs
- Valor predeterminado de
--strip=<always, sometimes or never>
: "A veces" -
Especifica si se quitarán los objetos binarios y las bibliotecas compartidas (mediante "-Wl,--strip-debug"). El valor predeterminado de “a veces” significa quitar el valor de iff --compilation_mode=fastbuild.
Etiquetas:affects_outputs
- Se acumulan
--stripopt=<a string>
usos múltiples -
Opciones adicionales para pasar a la eliminación cuando se genera un objeto binario “<name>.stripped”.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--swiftcopt=<a string>
usos múltiples -
Opciones adicionales para pasar a la compilación de Swift.
Etiquetas:action_command_lines
--symlink_prefix=<a string>
predeterminado: ver descripción-
Es el prefijo que se antepone a cualquiera de los symlinks prácticos 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 y no se emite ninguna advertencia. Advertencia: La funcionalidad especial para el atributo '/' pronto dejará de estar disponible; en su lugar, utilice --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 pueden compilar objetos binarios de tvOS de Apple.
Etiquetas:loses_incremental_state
,loading_and_analysis
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: ver descripción-
Versión mínima compatible de tvOS con los simuladores y dispositivos de destino. Si no se especifica, se usa “tvos_sdk_version”.
Etiquetas:loses_incremental_state
- Se acumulan
--watchos_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para crear objetos binarios de watchOS de Apple.
Etiquetas:loses_incremental_state
,loading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: ver descripción-
Versión de watchOS mínima compatible para dispositivos y simuladores de destino. Si no se especifica, se usa “watchos_sdk_version”.
Etiquetas:loses_incremental_state
--xbinary_fdo=<a build target label>
predeterminado: ver descripción-
Usa la información de perfil de XbinaryFDO para optimizar la compilación. Especifica el nombre del perfil binario cruzado predeterminado. Cuando la opción se usa junto con --fdo_instrument/--fdo_optimize/--fdo_profile, esas opciones siempre prevalecerán como si xbinary_fdo nunca se especifique.
Etiquetas:affects_outputs
- Opciones que afectan la forma estricta en que Bazel aplica las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etc.):
--auto_cpu_environment_group=<a build target label>
predeterminado: ""- Declara el entorno para que los valores de CPU se asignen automáticamente a los valores de target_environment.
Etiquetas:changes_inputs
,loading_and_analysis
,experimental
- Valor predeterminado de
--[no]check_licenses
: “falso” -
Verifica que las restricciones de licencias que imponen los paquetes dependientes no entren en conflicto con los modos de distribución de los destinos que se están compilando. De forma predeterminada, las licencias no están verificadas.
Etiquetas:build_file_semantics
--[no]check_visibility
predeterminado: “verdadero”-
Si se inhabilita, los errores de visibilidad en las dependencias de destino descienden a advertencias.
Etiquetas:build_file_semantics
--[no]desugar_for_android
predeterminado: “verdadero”-
Determina si el código de bytes Java 8 debe expandirse de sintaxis antes de la conversión a dex.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Valor predeterminado de
--[no]desugar_java8_libs
: “falso” -
Indica si se deben incluir bibliotecas de Java 8 compatibles en apps para dispositivos heredados.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]enforce_constraints
predeterminado: “verdadero”-
Verifica los entornos compatibles con cada destino y, luego, informa los errores si algún destino tiene dependencias que no admiten los mismos entornos.
Etiquetas:build_file_semantics
- Valor predeterminado de
--[no]experimental_allow_android_library_deps_without_srcs
: “falso” -
Marca para ayudar a hacer la transición para permitir que se inhabiliten las reglas android_library de srcs-less con deps. El depósito debe limpiarse para que se implemente de forma predeterminada.
Etiquetas:eagerness_to_exit
,loading_and_analysis
--[no]experimental_check_desugar_deps
predeterminado: “verdadero”-
Determina si se debe volver a comprobar la expansión de sintaxis correcta en el nivel binario de Android.
Etiquetas:eagerness_to_exit
,loading_and_analysis
,experimental
- Valor predeterminado de
--experimental_import_deps_checking=<off, warning or error>
: "DESACTIVADO" -
Cuando está habilitada, comprueba si las dependencias de aar_import están completas. Esta aplicación puede romper la compilación o puede simplemente generar advertencias.
Etiquetas:loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
predeterminado: “predeterminado”-
Si es verdadero, comprueba que un destino de Java declare explícitamente todos los destinos usados directamente como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
- Valor predeterminado de
--[no]incompatible_check_testonly_for_output_files
: “falso” -
Si está habilitada, verifica solo los objetivos de requisitos previos que son archivos de salida mediante la búsqueda de la regla de generación de prueba. Esto coincide con la verificación de visibilidad.
Etiquetas:build_file_semantics
,incompatible_change
- Valor predeterminado de
--[no]incompatible_disable_native_android_rules
: “falso” -
Si se habilita, se inhabilita el uso directo de las reglas nativas de Android. Usa las reglas de Starlark para Android en https://github.com/bazelbuild/rules_android
Etiquetas:eagerness_to_exit
,incompatible_change
- Valor predeterminado de
--[no]incompatible_disable_native_apple_binary_rule
: “falso” -
No hay relación. Se mantiene aquí para garantizar la retrocompatibilidad.
Etiquetas:eagerness_to_exit
,incompatible_change
--[no]incompatible_force_strict_header_check_from_starlark
predeterminado: “verdadero”-
Si está habilitada, establezca una verificación de encabezados estricta en la API de Starlark
Etiquetas:loading_and_analysis
,changes_inputs
,incompatible_change
--[no]incompatible_validate_top_level_header_inclusions
predeterminado: “verdadero”-
Si es verdadero, Bazel también validará las inclusiones de encabezados de directorio de nivel superior (consulte https://github.com/bazelbuild/bazel/issues/10047 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]strict_filesets
: “falso” - Si se habilita esta opción, los conjuntos de archivos que crucen los límites del paquete se informarán como errores. No funciona cuando se inhabilita check_fileset_dependencies_recursively.
Etiquetas:build_file_semantics
,eagerness_to_exit
- Valor predeterminado de
--strict_proto_deps=<off, warn, error, strict or default>
: "Error" - A menos que esté DESACTIVADA, se verifica que un destino proto_library declare explícitamente todos los destinos usados directamente como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
--strict_public_imports=<off, warn, error, strict or default>
predeterminado: "desactivado"- A menos que esté DESACTIVADA, verifica que un destino proto_library declare explícitamente todos los destinos que se usan en "import public" como exportados.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
- Valor predeterminado de
--[no]strict_system_includes
: “falso” - 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:
- Valor predeterminado de
--apk_signing_method=<v1, v2, v1_v2 or v4>
: “v1_v2” -
Implementación para usar en la firma de APK
Etiquetas:action_command_lines
,affects_outputs
,loading_and_analysis
--[no]device_debug_entitlements
predeterminado: “verdadero”-
Si se configura y el modo de compilación no es “opt”, las apps de objc incluirán derechos de depuración al firmar.
Etiquetas:changes_inputs
--ios_signing_cert_name=<a string>
predeterminado: ver descripción-
Es el nombre del certificado que se usará para la firma de iOS. Si no se configura, se recurrirá al perfil de aprovisionamiento. Puede ser la preferencia de identidad del llavero del certificado o (substring) del nombre común del certificado, según la página de manual del 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 a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.
- Valor predeterminado de
--[no]incompatible_config_setting_private_default_visibility
: “falso” -
Si este valor es incompatible. De lo contrario, si esta marca es falsa, cualquier configuración de configuración sin un atributo de visibilidad explícito es //visibility:public. Si esta marca es verdadera, config_setting sigue la misma lógica de visibilidad que todas las demás reglas. Consulta https://github.com/bazelbuild/bazel/issues/12933.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_legacy_py_provider
predeterminado: “verdadero”-
No-op se quitará en breve.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
predeterminado: “verdadero”-
Si es verdadero, aplique restricciones de visibilidad de config_setting. Si es falso, todos los archivos config_setting son visibles para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones que rigen el comportamiento del entorno de pruebas o del ejecutor de pruebas:
- Valor predeterminado de
--[no]allow_analysis_failures
: “falso” -
Si es verdadero, un error de análisis de un objetivo de regla da como resultado la propagación del destino de una instancia de AnalysisFailureInfo que contiene la descripción del error, en lugar de un error de compilación.
Etiquetas:loading_and_analysis
,experimental
- Valor predeterminado de
--analysis_testing_deps_limit=<an integer>
: “2,000” -
Establece la cantidad máxima de dependencias transitivas a través de un atributo de regla con una transición de configuración de for_analysis_testing. Si superas este límite, se producirá un error de la regla.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]break_build_on_parallel_dex2oat_failure
: “falso” -
Si las fallas de acción dex2oat son verdaderas, la compilación fallará en lugar de ejecutar dex2oat durante el tiempo de ejecución de la prueba.
Etiquetas:loading_and_analysis
,experimental
- Valor predeterminado de
--[no]check_tests_up_to_date
: “falso” -
No ejecutes pruebas. Solo verifica si están actualizadas. Si todos los resultados están actualizados, las pruebas se completan correctamente. Si es necesario compilar o ejecutar una prueba, se informa un error y la prueba falla. Esta opción implica el comportamiento --check_up_to_date.
Etiquetas:execution
- Valor predeterminado de
--[no]experimental_android_use_parallel_dex2oat
: “falso” -
Usa dex2oat en paralelo para acelerar android_test.
Etiquetas:loading_and_analysis
,host_machine_resource_optimizations
,experimental
- 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 reintenta hasta la cantidad especificada de veces en caso de que falle. Las pruebas que requieren más de un intento de aprobar se marcan como "FLAKY" en el resumen de la prueba. Normalmente, el valor especificado es solo un número entero o la string "default". Si es un número entero, todas las pruebas se ejecutarán hasta N veces. Si es "default", solo se realizará un único intento de prueba para las pruebas regulares y tres para las pruebas marcadas de manera explícita como inestables por su regla (atributo poco confiable=1). Sintaxis alternativa: regex_filter@flaky_test_attempts. Donde flaky_test_attempts es como el anterior, y regex_filter representa una lista de incluir y excluir patrones de expresión regular (también consulte --runs_per_test). Ejemplo: --flaky_test_attempts=//foo/.*,-//foo/bar/.*@3 desestima todas las pruebas en //foo/, excepto aquellas en foo/bar tres veces. Esta opción se puede pasar varias veces. El argumento pasado más reciente que coincide tiene prioridad. Si no hay coincidencias, el comportamiento es como el valor "predeterminado" mencionado anteriormente.
Etiquetas:execution
- Valor predeterminado de
--[no]ios_memleaks
: “falso” - Habilita la comprobación de fugas de memoria en objetivos de ios_test.
Etiquetas:action_command_lines
--ios_simulator_device=<a string>
predeterminado: ver descripción-
Es el dispositivo que se va a simular cuando se ejecuta una aplicación para iOS en el simulador, p.ej., “iPhone 6”. Para obtener una lista de los dispositivos, ejecute "xcrun simctl list devicetypes" en la máquina en la que se ejecutará el simulador.
Etiquetas:test_runner
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: ver descripción-
Es la versión de iOS que se ejecutará en el simulador al ejecutar o realizar pruebas. Esto se ignora para las reglas de ios_test si se especifica un dispositivo de destino en la regla.
Etiquetas:test_runner
--local_test_jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
predeterminado: "automático"-
La cantidad máxima de trabajos de prueba locales que se ejecutan de forma simultánea. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". 0 significa que los recursos locales limitarán la cantidad de trabajos de prueba locales que se ejecutarán en simultáneo. Establecer un valor mayor que el de --jobs es ineficaz.
Etiquetas:execution
- Se acumulan
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
usos múltiples - Especifica la cantidad de veces que se debe ejecutar cada prueba. Si alguno de esos intentos falla por cualquier motivo, la prueba completa se considera errónea. Por lo general, el valor especificado es solo un número entero. Ejemplo: --runs_per_test=3 ejecutará todas las pruebas 3 veces. Sintaxis alternativa: regex_filter@runs_per_test. En el que se ejecuta run_per_test, un valor entero y regex_filter representa una lista de patrones de expresión incluidos y excluidos. También consulta --instrumentation_filter. Ejemplo: --runs_per_test=//foo/.*,-//foo/bar/.*@3 ejecuta todas las pruebas en //foo/ excepto las de foo/bar tres veces. Esta opción se puede pasar varias veces. El argumento pasado más reciente que coincide tiene prioridad. Si no hay coincidencias, la prueba solo se ejecuta una vez.
- Se acumulan
--test_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica las 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 se leerá su valor desde el entorno de cliente de Bazel o por el par nombre=valor. Esta opción se puede utilizar varias veces para especificar varias variables. Solo se usa en el comando “bazel test”.
Etiquetas:test_runner
--[no]test_keep_going
predeterminado: “verdadero”-
Si se inhabilita, cualquier prueba no aprobada hará que se detenga toda la compilación. De forma predeterminada, se ejecutan todas las pruebas, incluso si algunas no se aprueban.
Etiquetas:execution
--test_strategy=<a string>
predeterminado: ""-
Especifica la estrategia que se usará para ejecutar pruebas.
Etiquetas:execution
--test_timeout=<a single integer or comma-separated list of 4 integers>
predeterminado: "-1"- Anula los valores de tiempo de espera de prueba predeterminados para los tiempos de espera de prueba (en segundos). Si se especifica un solo número entero positivo, se anularán todas las categorías. Si se especifican 4 números enteros separados por comas, anularán los tiempos de espera para valores cortos, moderados, largos y eternos (en ese orden). En cualquier forma, un valor de -1 le indica a blaze que use los tiempos de espera predeterminados para esa categoría.
--test_tmpdir=<a path>
predeterminado: ver descripción- Especifica el directorio temporal base para que se use “bazel test”.
--tvos_simulator_device=<a string>
predeterminado: ver descripción-
Es el dispositivo que se simulará cuando se ejecute una aplicación tvOS en el simulador, p.ej., “Apple TV 1080p”. Para obtener una lista de los dispositivos, ejecute "xcrun simctl list devicetypes" en la máquina en la que se ejecutará el simulador.
Etiquetas:test_runner
--tvos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: ver descripción-
Es la versión de tvOS que se ejecutará en el simulador cuando se ejecute o se realice una prueba.
Etiquetas:test_runner
--watchos_simulator_device=<a string>
predeterminado: ver descripción-
Es el dispositivo que se debe simular cuando se ejecuta una aplicación watchOS en el simulador, p.ej., “Apple Watch - 38 mm”. Para obtener una lista de los dispositivos, ejecute "xcrun simctl list devicetypes" en la máquina en la que se ejecutará el simulador.
Etiquetas:test_runner
--watchos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: ver descripción-
Es la versión de watchOS que se ejecuta en el simulador cuando se ejecuta o se realiza una prueba.
Etiquetas:test_runner
--[no]zip_undeclared_test_outputs
predeterminado: “verdadero”-
Si es verdadero, los resultados de las pruebas no declaradas se archivarán en un archivo ZIP.
Etiquetas:test_runner
- Opciones que activan optimizaciones del tiempo de compilación:
--[no]collapse_duplicate_defines
predeterminado: “verdadero”-
Cuando se habilita, la opción redundante --defines se quita al comienzo 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
- Valor predeterminado de
--[no]experimental_filter_library_jar_with_program_jar
: “falso” -
Filtra el ProgramPro de ProGuard para quitar cualquier clase que también esté presente en LibraryJar.
Etiquetas:action_command_lines
--[no]experimental_inmemory_dotd_files
predeterminado: “verdadero”- Si se habilita esta opción, los archivos C .D se pasarán a la memoria directamente desde los nodos de compilación remota, en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_inmemory_jdeps_files
predeterminado: “verdadero”-
Si se habilita, los archivos de dependencia (.jdeps) generados a partir de compilaciones de Java se pasarán a través de la memoria directamente desde los nodos de compilación remota, en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
,experimental
- Valor predeterminado de
--[no]experimental_objc_include_scanning
: “falso” -
Determina si se debe realizar una búsqueda para C/C++ objetivo.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
- Valor predeterminado de
--[no]experimental_parse_headers_skipped_if_corresponding_srcs_found
: “falso” -
Si está habilitada, la función parse_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
- Valor predeterminado de
--[no]experimental_retain_test_configuration_across_testonly
: “falso” -
Cuando se habilita, --trim_test_configuration no recortará la configuración de prueba de las reglas marcadas como testonly=1. Esto tiene como objetivo reducir los problemas de conflicto de acciones cuando las reglas que no son de prueba dependen de las reglas de cc_test. No tiene efecto si --trim_test_configuration es falsa.
Etiquetas:loading_and_analysis
,loses_incremental_state
- Valor predeterminado de
--[no]experimental_starlark_cc_import
: “falso” -
Si está habilitada, se puede usar la versión Starlark de cc_import.
Etiquetas:loading_and_analysis
,experimental
- Valor predeterminado de
--[no]experimental_unsupported_and_brittle_include_scanning
: “falso” -
Determina si se deben limitar las entradas a la compilación de C/C++ mediante el análisis de #include las líneas de los archivos de entrada. Esto puede mejorar el rendimiento y la incrementalidad, ya que disminuye el tamaño de los árboles de entrada de compilación. Sin embargo, también puede romper compilaciones porque el escáner de inclusión no implementa completamente la semántica del preprocesador de C. En particular, no comprende las directivas dinámicas de #include e ignora la lógica condicional del preprocesador. Úsalos bajo tu responsabilidad. Se cerrarán todos los problemas relacionados con esta marca que se presenten.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
--[no]incremental_dexing
predeterminado: “verdadero”-
Realiza la mayor parte del trabajo en la conversión a archivos dex por separado para cada archivo jar.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]objc_use_dotd_pruning
predeterminado: “verdadero”- Si se configura, los archivos .d emitidos por clang se usarán para reducir el conjunto de entradas que se pasan a las compilaciones objc.
Etiquetas:changes_inputs
,loading_and_analysis
- Valor predeterminado de
--[no]process_headers_in_dependencies
: “falso” -
Cuando se compila un destino //a:a, se deben procesar los encabezados en todos los destinos del que depende //a:a (si el procesamiento de encabezados está habilitado para la cadena de herramientas).
Etiquetas:execution
--[no]trim_test_configuration
predeterminado: “verdadero”-
Cuando se habilita, las opciones relacionadas con la prueba se borran debajo del nivel superior de la compilación. Cuando esta marca está activa, las pruebas no se pueden compilar como dependencias de reglas que no son de prueba, pero los cambios en las opciones relacionadas con la prueba no harán que se vuelvan a analizar las reglas que no son de prueba.
Etiquetas:loading_and_analysis
,loses_incremental_state
--[no]use_singlejar_apkbuilder
predeterminado: “verdadero”- Esta opción es obsoleta. Ahora es no-op y se quitará pronto.
Etiquetas:loading_and_analysis
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Valor predeterminado de
--[no]announce
: “falso” -
Obsoleto. No-op.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]experimental_bep_target_summary
: “falso” - Indica si se deben publicar eventos de TargetSummary.
- Valor predeterminado de
--[no]experimental_build_event_expand_filesets
: “falso” - Si es verdadero, expande los conjuntos de archivos en el BEP cuando se presentan archivos de salida.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]experimental_build_event_fully_resolve_fileset_symlinks
: “falso” -
Si es verdadero, resuelve por completo los symlinks relativos del conjunto de archivos en el BEP cuando 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"-
La cantidad máxima de veces que Bazel debería reintentar subir un evento de compilación.
Etiquetas:bazel_internal_configuration
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
predeterminado: "1 s"-
Es el retraso mínimo inicial para los reintentos de retirada exponencial cuando falla la carga de BEP. (exponente: 1.6)
Etiquetas:bazel_internal_configuration
--experimental_build_event_upload_strategy=<a string>
predeterminado: ver descripción- Selecciona cómo subir los artefactos a los que se hace referencia en el protocolo de evento de compilación.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]experimental_materialize_param_files_directly
: “falso” - Si materializas archivos de parámetros, debes hacerlo con escrituras directas en el disco.
Etiquetas:execution
- Valor predeterminado de
--[no]experimental_stream_log_file_uploads
: “falso” - Transmite directamente los archivos de registro al almacenamiento remoto en lugar de escribirlos en el disco.
Etiquetas:affects_outputs
--explain=<a path>
predeterminado: 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
--[no]legacy_important_outputs
predeterminado: “verdadero”-
Úsalo a fin de suprimir la generación del campo heredado_outputs heredado del evento TargetComplete. Son importantes para la integración de Bazel con ResultStore.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]materialize_param_files
: “falso” -
Escribe archivos de parámetros intermedios en el árbol de resultados, incluso cuando se usa la ejecución remota de acciones. Es útil cuando se depuran acciones. Esto está implícito por --subcommands y --verbose_failures.
Etiquetas:execution
- Valor predeterminado de
--max_config_changes_to_show=<an integer>
: "3" - Cuando se descarta la caché de análisis debido a un cambio en las opciones de compilación, se muestra la cantidad determinada de nombres de opciones modificadas. Si el número proporcionado es -1, se mostrarán todas las opciones modificadas.
Etiquetas:terminal_output
--max_test_output_bytes=<an integer>
predeterminado: "-1"-
Especifica el tamaño máximo por registro de prueba que se puede emitir cuando --test_output es "errores" o "all". Es útil para evitar abrumar el resultado con un resultado de prueba demasiado ruidoso. El encabezado de la prueba se incluye en el tamaño de registro. Los valores negativos no tienen límites. El resultado es todo o nada.
Etiquetas:test_runner
,terminal_output
,execution
--output_filter=<a valid Java regular expression>
predeterminado: ver descripción- Solo muestra las advertencias para las reglas con un nombre que coincide con la expresión regular proporcionada.
Etiquetas:affects_outputs
--progress_report_interval=<an integer in 0-3600 range>
predeterminado: "0"-
Es la cantidad de segundos entre los informes en trabajos que se siguen ejecutando. El valor predeterminado 0 significa que el primer informe se imprimirá después de 10 segundos, luego en 30 segundos y después de que ese progreso se informe una vez por minuto. Cuando --curses está habilitado, se informa el progreso cada segundo.
Etiquetas:affects_outputs
- Valor predeterminado de
--show_result=<an integer>
: "1" -
Muestra los resultados de la compilación. Para cada destino, indica si se actualizó o no y, de ser así, una lista de los archivos de salida que se compilaron. Los archivos impresos son strings convenientes para copiar y pegar en la shell, para ejecutarlas.
Esta opción requiere un argumento de número entero, que es la cantidad límite de objetivos por encima de la cual no se imprime la información del resultado. Por lo tanto, cero provoca la supresión del mensaje y MAX_INT hace que la impresión del resultado se produzca 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 la herramienta).
Etiquetas:terminal_output
--test_output=<summary, errors, all or streamed>
predeterminado: "summary"-
Especifica el modo de salida deseado. Los valores válidos son "summary" para mostrar solo el resumen de estado de la prueba, "errors" para imprimir también los registros de pruebas de las pruebas fallidas, "all" para imprimir los registros de todas las pruebas y "streamed" para generar los registros de todas las pruebas en tiempo real (esto obligará a las pruebas se ejecuten de forma local, independientemente del valor de --test_strategy).
Etiquetas:test_runner
,terminal_output
,execution
- Valor predeterminado de
--test_summary=<short, terse, detailed, none or testcase>
: "corto" -
Especifica el formato deseado del resumen de la prueba. Los valores válidos son "short" para imprimir información únicamente sobre las pruebas ejecutadas, "terse" para imprimir solo la información de las pruebas fallidas que se ejecutaron, "detail" para imprimir información detallada sobre los casos de prueba con errores, "testcase" para imprimir el resumen en la resolución del caso de prueba, no imprimir información detallada sobre los casos de prueba con errores y "none" para omitir el resumen.
Etiquetas:terminal_output
- Valor predeterminado de
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "-.*" -
Imprime información de depuración durante la resolución de la cadena de herramientas. La marca toma una regex, que se verifica con los tipos de la cadena de herramientas y objetivos específicos para ver cuál depurar. Si hay varias regex, estas pueden separarse con comas y, luego, cada una se revisa por separado. Nota: El resultado de esta marca es muy complejo y es probable que solo sea útil para los expertos en la resolución de la cadena de herramientas.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]verbose_explanations
: “falso” -
Aumenta la verbosidad de las explicaciones emitidas si se habilita --explain. No tiene efecto si --explain no está habilitado.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]verbose_failures
: “falso” - Si un comando falla, imprime la línea de comandos completa.
Etiquetas:terminal_output
- Opciones para especificar o alterar una entrada genérica en un comando de Bazel que no se encuentre en otras categorías:
- Se acumulan
--aspects_parameters=<a 'name=value' assignment>
usos múltiples -
Especifica los valores de los parámetros de los aspectos de la línea de comandos. Cada valor de parámetro se especifica mediante <param_name>=<param_value>, por ejemplo, 'my_param=my_val' donde 'my_param' es un parámetro de algún aspecto en --aspecting list o obligatorio por un aspecto en la lista. Esta opción se puede utilizar varias veces. Sin embargo, no se pueden 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 las marcas de Starlark. Toma un solo par clave-valor con el formato "<key>=<value>" como argumento.
Etiquetas:changes_inputs
- Valor predeterminado de
--[no]incompatible_default_to_explicit_init_py
: “falso” -
Esta marca cambia el comportamiento predeterminado para que los archivos __init__.py ya no se creen automáticamente en los runfiles de los objetivos de Python. Precisamente, cuando un destino py_binary o py_test tiene la configuración heredada_create_init establecida en "automático" (la opción predeterminada), se considera falsa si solo se establece esta marca. Consulta https://github.com/bazelbuild/bazel/issues/10076.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_py2_outputs_are_suffixed
predeterminado: “verdadero”-
Si es verdadero, los destinos compilados en la configuración de Python 2 aparecerán en una raíz de salida que incluya el sufijo “-py2”, mientras que los objetivos 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 objetivos de Python 3 en lugar de a Python 2. Si habilitas esta opción, también se recomienda habilitar `--incompatible_py3_is_default`.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_py3_is_default
predeterminado: “verdadero”-
Si es verdadero, los objetivos “py_binary” y “py_test” que no definen el atributo “python_version” (o “default_python_version”) se establecerán de forma predeterminada como PY3 en lugar de PY2. Si configuras esta marca, también se recomienda establecer `--incompatible_py2_outputs_are_suffixed`.
Etiquetas:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_use_python_toolchains
predeterminado: “verdadero”-
Si se configura como verdadera, las reglas nativas ejecutables de Python usarán el entorno de ejecución de Python especificado en la cadena de herramientas de Python, en lugar del entorno de ejecución proporcionado por marcas heredadas como --python_top.
Etiquetas:loading_and_analysis
,incompatible_change
--python_version=<PY2 or PY3>
predeterminado: ver descripción-
Es el modo de la versión principal de Python, ya sea "PY2" o "PY3". Ten en cuenta que los destinos "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 nombra aquí, en lugar de hacerlo en la línea de comandos. Es un error especificar aquí un archivo y patrones de línea de comandos.
Etiquetas:changes_inputs
- Otras opciones (sin categorizar)
- Valor predeterminado de
--[no]build_manual_tests
: “falso” - Fuerza la compilación de los destinos etiquetados como "manual". Las pruebas "manuales" no se incluyen en el procesamiento. Esta opción hace que se compilen (pero no se ejecuten).
--build_tag_filters=<comma-separated list of options>
predeterminado: ""- Especifica una lista de etiquetas separadas por comas. De manera opcional, cada etiqueta puede estar precedida por "-" para especificar etiquetas excluidas. Solo se crearán los destinos que contengan al menos una etiqueta incluida y no contengan ninguna etiqueta excluida. Esta opción no afecta el conjunto de pruebas ejecutadas con el comando "test" (prueba), que se rige por las opciones de filtrado de pruebas (por ejemplo, "test_tag_filters").
- Valor predeterminado de
--[no]build_tests_only
: “falso” - Si se especifica, solo se compilarán las reglas *_test y test_suite, y se ignorarán los otros destinos especificados en la línea de comandos. De forma predeterminada, se compilarán todos los datos solicitados.
--[no]cache_test_results
[-t
] predeterminado: "auto"- Si se configura como “automática”, Bazel vuelve a ejecutar una prueba solo si: (1) Bazel detecta cambios en la prueba o sus dependencias, (2) la prueba se marcó como externa, (3) se solicitaron varias ejecuciones con --runs_per_test o(4) la prueba falló anteriormente. Si se configura como “sí”, Bazel almacena en caché todos los resultados, excepto las pruebas marcadas como externas. Si se configura como “no”, Bazel no almacena en caché ningún resultado de prueba.
- Valor predeterminado de
--[no]compile_one_dependency
: “falso” - Compila una sola dependencia de los archivos de argumento. Esto es útil para comprobar la sintaxis de los archivos de origen de los IDE, por ejemplo, mediante la compilación de un solo destino que dependa del archivo de origen a fin de 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 sin marcas. En lugar de ser destinos 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
--deleted_packages=<comma-separated list of package names>
usos múltiples - Es una lista de nombres de paquetes separados por comas 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". Por ejemplo, después de borrar x/y/BUILD en tu cliente, el sistema de compilación puede presentar una queja si encuentra una etiqueta "//x:y/z" si aun así la proporciona otra entrada package_path. Si se especifica --deleted_packages x/y, se evita este problema.
- Valor predeterminado de
--[no]discard_analysis_cache
: “falso” - Descarta la caché de análisis inmediatamente después de que se complete la fase de análisis. Reduce el uso de memoria en aproximadamente un 10%, pero ralentiza las compilaciones incrementales.
--execution_log_binary_file=<a path>
predeterminado: ver descripción- Registra las generaciones ejecutadas en este archivo como protos de spawn delimitados por src/main/protobuf/spawn.proto. El registro primero se escribe sin orden y, luego, al final de la invocación, se ordena de forma estable (puede consumir muchos recursos de CPU y memoria). Marcas relacionadas: --execution_log_json_file (formato JSON de texto ordenado), --experimental_execution_log_file (formato protobuf binario sin ordenar), subcomandos (para mostrar subcomandos en el resultado de la terminal).
--execution_log_json_file=<a path>
predeterminado: ver descripción- Registra las generaciones ejecutadas en este archivo como representación json de los protos de spawn delimitados, según src/main/protobuf/spawn.proto. El registro primero se escribe sin orden y, luego, al final de la invocación, se ordena de forma estable (puede consumir muchos recursos de CPU y memoria). Marcas relacionadas: marcas relacionadas: --execution_log_binary_file (formato binario protobuf), --experimental_execution_log_file (formato binario protobuf), --subcomandos (para mostrar subcomandos en salida de terminal).
--[no]expand_test_suites
predeterminado: “verdadero”- Expande los objetivos test_suite en sus pruebas constituyentes antes del análisis. Cuando esta marca está activada (predeterminada), se aplicarán los patrones de orientación negativa a las pruebas que pertenezcan al conjunto de pruebas; de lo contrario, no se aplicarán. Desactivar esta marca es útil cuando se aplican aspectos de nivel superior en la línea de comandos, ya que pueden analizar los destinos test_suite.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]experimental_cancel_concurrent_tests
: “falso” -
Si es verdadero, Blaze cancelará las pruebas que se estén ejecutando de forma simultánea en la primera ejecución correcta. Esto solo es útil en combinación con --runs_per_test_detects_flakes.
Etiquetas:affects_outputs
,loading_and_analysis
--experimental_execution_log_file=<a path>
predeterminado: ver descripción- Registra las generaciones ejecutadas en este archivo como protos de spawn delimitados por src/main/protobuf/spawn.proto. Este archivo está escrito en el orden de ejecución de los spawn. Marcas relacionadas: --execution_log_binary_file (formato binario protobuf), --execution_log_json_file (formato JSON de texto ordenado), subcomandos (para mostrar subcomandos en el resultado de la terminal).
- Valor predeterminado de
--[no]experimental_execution_log_spawn_metrics
: “falso” - Incluye las métricas de spawn en el registro de spawn ejecutados.
--experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
predeterminado: ""- Obsoleto y reemplaza los aspectos. Filtra un conjunto de objetivos para los que se deben programar acciones adicionales.
- Valor predeterminado de
--[no]experimental_extra_action_top_level_only
: “falso” - Obsoleto y reemplaza los aspectos. Solo programa acciones adicionales para objetivos de nivel superior.
- Valor predeterminado de
--[no]experimental_fetch_all_coverage_outputs
: “falso” -
Si es verdadero, Bazel recupera todo el directorio de datos de cobertura de cada prueba durante una ejecución de cobertura.
Etiquetas:affects_outputs
,loading_and_analysis
- Valor predeterminado de
--[no]experimental_generate_llvm_lcov
: “falso” -
Si es verdadero, la cobertura de jerga generará un informe de LCOV.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_j2objc_header_map
predeterminado: “verdadero”- Indica si se debe generar el mapa de encabezado de J2ObjC en paralelo a la transpilación de J2ObjC.
- Valor predeterminado de
--[no]experimental_j2objc_shorter_header_path
: “falso” -
Se debe generar con una ruta de encabezado más corta (usa "_ios" en lugar de "_j2objc").
Etiquetas:affects_outputs
- Valor predeterminado de
--experimental_java_classpath=<off, javabuilder or bazel>
: “javabuilder”. - Habilita rutas de clase reducidas para las compilaciones de Java.
- Valor predeterminado de
--[no]experimental_limit_android_lint_to_android_constrained_java
: “falso” -
Limita --experimental_run_android_lint_on_java_rules a las bibliotecas compatibles con Android.
Etiquetas:affects_outputs
--[no]experimental_prioritize_local_actions
predeterminado: “verdadero”- Si se configura, las acciones que solo pueden ejecutarse de forma local tienen la primera oportunidad de adquirir recursos, los trabajadores de ejecución dinámica tienen una segunda oportunidad y las acciones independientes ejecutadas de forma dinámica son las últimas.
Etiquetas:execution
- Valor predeterminado de
--[no]experimental_run_android_lint_on_java_rules
: “falso” - Determina si se deben validar las fuentes java_*.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]explicit_java_test_deps
: “falso” - Especifica explícitamente una dependencia a JUnit o Hamcrest en una java_test, en lugar de obtenerla accidentalmente de las dependencias de TestRunner. En este momento, solo funciona para bazel.
--host_java_launcher=<a build target label>
predeterminado: ver descripción- El selector de Java que usan las herramientas que se ejecutan durante una compilación.
- Se acumulan
--host_javacopt=<a string>
usos múltiples - Opciones adicionales para pasar a javac cuando se compilan herramientas que se ejecutan durante una compilación
- Se acumulan
--host_jvmopt=<a string>
usos múltiples - Opciones adicionales para pasar a la VM de Java cuando se compilan herramientas que se ejecutan durante la compilación. Estas opciones se agregarán a las opciones de inicio de VM de cada destino java_binary.
--[no]incompatible_exclusive_test_sandboxed
predeterminado: “verdadero”-
Si es verdadero, se ejecutarán pruebas exclusivas con una estrategia de zona de pruebas. Agrega la etiqueta “local” para forzar una ejecución de prueba exclusiva a nivel local
Etiquetas:incompatible_change
- Valor predeterminado de
--[no]incompatible_strict_action_env
: “falso” -
Si es verdadero, Bazel usa un entorno con un valor estático para PATH y no hereda LD_LIBRARY_PATH. Use --action_env=ENV_VARIABLE si desea heredar variables de entorno específicas del cliente, pero tenga en cuenta que, si lo hace, puede evitar el almacenamiento en caché entre usuarios si se utiliza 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. Implica -test_output=stream.
Se expande a:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
--[no]java_deps
predeterminado: “verdadero”- Genera información de dependencia (por ahora, ruta de clase de tiempo de compilación) por destino de Java.
--[no]java_header_compilation
predeterminado: “verdadero”- Compila los archivos JAR directamente desde la fuente.
--java_language_version=<a string>
predeterminado: ""- Versión de Java
--java_launcher=<a build target label>
predeterminado: ver descripción- El selector de Java que se usará para compilar objetos binarios de Java. Si esta marca se establece en la string vacía, se usa el iniciador de JDK. El atributo "launcher" anula esta marca.
- Valor predeterminado de
--java_runtime_version=<a string>
: “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 VM de cada destino java_binary.
--legacy_main_dex_list_generator=<a build target label>
predeterminado: ver descripción- Especifica un objeto binario para usar a fin de generar la lista de clases que deben estar en el DEX principal cuando se compila el 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 Bazel a fin de invertir en acciones de compilación ejecutadas de manera 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 calcular la cantidad de núcleos de CPU disponibles.
- Valor predeterminado de
--local_ram_resources=<an integer, or "HOST_RAM", optionally followed by [-|*]<float>.>
: “HOST_RAM*.67” - Configura de forma explícita la cantidad total de RAM del host local (en MB) disponible para Bazel a fin de invertir en acciones de compilación ejecutadas de manera 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 calcular la cantidad de RAM disponible y utilizará el 67% de ella.
- Valor predeterminado de
--local_termination_grace_seconds=<an integer>
: “15” - Es el tiempo de espera entre la finalización de un proceso local debido al tiempo de espera y el cierre forzado.
--package_path=<colon-separated list of options>
predeterminado: "%workspace%"- Es una lista separada por dos puntos sobre dónde buscar paquetes. Los elementos que comienzan con "%workspace%" se relacionan con el espacio 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.
--proguard_top=<a build target label>
predeterminado: ver descripción- Especifica qué versión de ProGuard usar para la eliminación de código cuando se compila un objeto binario de Java.
--proto_compiler=<a build target label>
predeterminado: “@bazel_tools//tools/proto:protoc”-
Es la etiqueta del proto-compilador.
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 los protocolos 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 los protocolos j2objc
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
predeterminado: “@bazel_tools//tools/proto:java_toolchain”-
Etiqueta de proto_lang_toolchain() que describe cómo compilar los protocolos de Java
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
predeterminado: “@bazel_tools//tools/proto:javalite_toolchain”-
Etiqueta de proto_lang_toolchain() que describe cómo compilar los protocolos de JavaLite
Etiquetas:affects_outputs
,loading_and_analysis
- Se acumulan
--protocopt=<a string>
usos múltiples -
Opciones adicionales para pasar al compilador protobuf.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]runs_per_test_detects_flakes
: “falso” - Si es verdadero, cualquier fragmento en el que pase al menos un intento de ejecución o intento y al menos uno de ellos falle y obtenga el estado FLAKY.
--shell_executable=<a path>
predeterminado: ver descripción-
Ruta de acceso absoluta al ejecutable de shell que puede usar Bazel. Si no está configurado, pero la variable de entorno BAZEL_SH se configura en la primera invocación de Bazel (que inicia un servidor de Bazel), Bazel la usa. Si no se configura ninguna de esas opciones, Bazel usa una ruta de acceso predeterminada codificada según el sistema operativo en el que se ejecute (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash: todos los demás: /bin/bash). Ten en cuenta que usar una shell que no sea compatible con Bash puede generar fallas de compilación o de tiempo de ejecución de los objetos binarios generados.
Etiquetas:loading_and_analysis
--[no]show_loading_progress
predeterminado: “verdadero”- Si se habilita, hace que Bazel imprima mensajes de "Cargando paquete".
- Se acumulan
--test_arg=<a string>
usos múltiples - Especifica las opciones y los 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 se usa en el comando “bazel test”.
--test_filter=<a string>
predeterminado: ver descripción- Especifica un filtro para reenviar al framework de prueba. Se usa para limitar la ejecución de las pruebas. Ten en cuenta que esto no afecta a los destinos que se crean.
--test_lang_filters=<comma-separated list of options>
predeterminado: ""- Especifica una lista separada por comas de idiomas de prueba. De manera opcional, cada idioma puede estar precedido por "-" para especificar los idiomas excluidos. Solo se encontrarán los objetivos de prueba que estén escritos en los idiomas especificados. El nombre utilizado para cada idioma debe ser el mismo que el prefijo del idioma en la regla *_test, p.ej., "cc", "java", "py", etc. Esta opción afecta el comportamiento --build_tests_only y el comando de prueba.
--test_result_expiration=<an integer>
predeterminado: "-1"- Esta opción es obsoleta y no tiene efecto.
- Valor predeterminado de
--[no]test_runner_fail_fast
: “falso” - La opción de reenvío falla rápidamente al ejecutor de pruebas. El ejecutor de prueba debe detener la ejecución en la primera falla.
- Valor predeterminado de
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>
: "explícito" - Especifica una estrategia de fragmentación de pruebas: “explícita” para usar la fragmentación solo si el atributo “shard_count” está presente. 'disabled' para inhabilitar la fragmentación de pruebas. "forced=k" impone los fragmentos "k" para pruebas, independientemente del atributo "shard_count" BUILD.
--test_size_filters=<comma-separated list of values: small, medium, large or enormous>
predeterminado: ""- Especifica una lista separada por comas de tamaños de prueba. De manera opcional, cada tamaño puede estar precedido 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 --build_tests_only y el comando de prueba.
--test_tag_filters=<comma-separated list of options>
predeterminado: ""- Especifica una lista separada por comas de etiquetas de prueba. De manera opcional, cada etiqueta puede estar precedida por "-" para especificar etiquetas excluidas. Solo se encontrarán los objetivos de prueba que contengan al menos una etiqueta incluida y no contengan ninguna etiqueta excluida. Esta opción afecta el comportamiento --build_tests_only y el comando 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 prueba. De manera opcional, cada tiempo de espera puede estar precedido por "-" para especificar los tiempos de espera excluidos. Solo se detectarán los destinos de prueba que contengan al menos un tiempo de espera incluido y que no contengan ningún tiempo de espera excluido. Esta opción afecta el comportamiento --build_tests_only y el comando de prueba.
--tool_java_language_version=<a string>
predeterminado: ""- La versión en lenguaje Java que se usa para ejecutar las herramientas necesarias durante una compilación
--tool_java_runtime_version=<a string>
predeterminado: "remotejdk_11"- La versión del entorno de ejecución de Java que se usa para ejecutar herramientas durante la compilación
--[no]use_ijars
predeterminado: “verdadero”- Si se habilita, esta opción hace que la compilación de Java use archivos jar de la interfaz. De esta manera, la compilación incremental será más rápida, pero los mensajes de error pueden ser diferentes.
Opciones de marcas canónicas
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 -
Puedes buscar archivos adicionales antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]experimental_repository_cache_hardlinks
: “falso” -
Si se configura, la caché del repositorio vinculará el archivo en caso de un acierto de caché, en lugar de copiarlo. Esto está destinado a ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]experimental_repository_cache_urls_as_default_canonical_id
: “falso” -
Si es verdadero, usa una string derivada de las URL de las descargas del repositorio como el canonical_id si no se especifica. Esto hace que un cambio en las URL provoque una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no generen la máscara de caché de los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
- Valor predeterminado de
--[no]experimental_repository_disable_download
: “falso” - 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 configura en 0, los reintentos están inhabilitados.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark según este factor. De esta manera, los repositorios externos pueden funcionar en máquinas que son más lentas de lo que espera el autor de la regla, sin cambiar el código fuente
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas HTTP mediante el factor determinado
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: ver descripción-
Especifica la ubicación de la 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:
- Valor predeterminado de
--[no]canonicalize_policy
: “falso” - Resultados la política canónica, después de la expansión y el filtrado. Para mantener limpio el resultado, los argumentos del comando canónicos NO se mostrarán cuando esta opción se configure como verdadera. Tenga en cuenta que el comando especificado por --for_command afecta a la política filtrada y, si no se especifica ninguno, el comando predeterminado es “build”.
Etiquetas:affects_outputs
,terminal_output
- Valor predeterminado de
--[no]show_warnings
: “falso” -
Advertencias del analizador de resultados a errores estándar (p. ej., para opciones de marcas en conflicto)
Etiquetas:affects_outputs
,terminal_output
- Opciones que afectan la forma estricta en que Bazel aplica entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etc.):
--experimental_repository_hash_file=<a string>
predeterminado: ""-
Si el campo no está vacío, especifica un archivo que contiene un valor resuelto, en el que se deben verificar los hash del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan
--experimental_verify_repository_rules=<a string>
usos múltiples - Si la lista de reglas del repositorio para la que se debe verificar el hash del directorio de salida, siempre que --experimental_repository_hash_file proporcione un archivo
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o de la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: “verdadero”-
No-ops
Etiquetas:no_op
,deprecated
,experimental
- Valor predeterminado de
--[no]incompatible_config_setting_private_default_visibility
: “falso” -
Si este valor es incompatible. De lo contrario, si esta marca es falsa, cualquier configuración de configuración sin un atributo de visibilidad explícito es //visibility:public. Si esta marca es verdadera, config_setting sigue la misma lógica de visibilidad que todas las demás reglas. Consulta https://github.com/bazelbuild/bazel/issues/12933.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
predeterminado: “verdadero”-
Si es verdadero, aplique restricciones de visibilidad de config_setting. Si es falso, todos los archivos config_setting son visibles para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones relacionadas con la salida y la semántica de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Se especificaron las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran en un registro del origen del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones con bloqueos harán que falle la resolución. También puedes definir una versión ya permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puede inhabilitar esta comprobación con la palabra clave "todo" (no se recomienda).
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
: "Error" -
Comprueba la compatibilidad de los módulos de Bazel con la versión 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 detecta una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "warning"-
Comprueba si las dependencias directas de "bazel_dep" declaradas en el módulo raíz son las mismas que se muestran en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la comprobación, "warning" para mostrar una advertencia cuando se detecta una discrepancia o "error" para escalarla a una falla de resolución.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]ignore_dev_dependency
: “falso” -
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declaradas como "dev_dependency" en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev se ignoran siempre en MODULE.bazel si no es el módulo raíz independientemente del valor de esta marca.
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 un directorio local.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en registros anteriores y solo volverán a los registros posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Valor predeterminado de
--[no]experimental_record_metrics_for_all_mnemonics
: “falso” - De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 nombres con la mayor cantidad de acciones ejecutadas. Si se establece esta opción, se escribirán estadísticas para todos los mnemónicos.
- Opciones para especificar o alterar una entrada genérica en un comando de Bazel que no se encuentre en otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si el campo no resuelto, lee el archivo resuelto especificado en lugar del archivo WORKSPACE
Etiquetas:changes_inputs
--for_command=<a string>
predeterminado: “compilación”- 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 canónicarán.
Etiquetas:affects_outputs
,terminal_output
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
predeterminado: ver descripción- Especifica un archivo para configurar la descarga remota. Este archivo consta de líneas y cada una comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para coincidir y uno para usar como URL sustituta. Las referencias inversas comienzan desde "$1". Es posible que se muestren varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias.
- Varias opciones, sin otra categoría
- Se acumulan
--deleted_packages=<comma-separated list of package names>
usos múltiples - Es una lista de nombres de paquetes separados por comas 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". Por ejemplo, después de borrar x/y/BUILD en tu cliente, el sistema de compilación puede presentar una queja si encuentra una etiqueta "//x:y/z" si aun así la proporciona otra entrada package_path. Si se especifica --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 un directorio local.
--package_path=<colon-separated list of options>
predeterminado: "%workspace%"- Es una lista separada por dos puntos sobre dónde buscar paquetes. Los elementos que comienzan con "%workspace%" se relacionan con el espacio de trabajo que lo contiene. Si se omite o está vacío, el valor predeterminado es el resultado de "bazel info default-package-path".
--[no]show_loading_progress
predeterminado: “verdadero”- Si se habilita, hace que Bazel imprima mensajes de "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 -
Puedes buscar archivos adicionales antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]experimental_repository_cache_hardlinks
: “falso” -
Si se configura, la caché del repositorio vinculará el archivo en caso de un acierto de caché, en lugar de copiarlo. Esto está destinado a ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]experimental_repository_cache_urls_as_default_canonical_id
: “falso” -
Si es verdadero, usa una string derivada de las URL de las descargas del repositorio como el canonical_id si no se especifica. Esto hace que un cambio en las URL provoque una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no generen la máscara de caché de los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
- Valor predeterminado de
--[no]experimental_repository_disable_download
: “falso” - 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 configura en 0, los reintentos están inhabilitados.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark según este factor. De esta manera, los repositorios externos pueden funcionar en máquinas que son más lentas de lo que espera el autor de la regla, sin cambiar el código fuente
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas HTTP mediante el factor determinado
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: ver descripción-
Especifica la ubicación de la 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:
- Valor predeterminado de
--[no]async
: “falso” - Si es verdadero, la limpieza de salida es asíncrona. Cuando se complete este comando, será seguro ejecutar comandos nuevos en el mismo cliente, aunque la eliminación continúe en segundo plano.
Etiquetas:host_machine_resource_optimizations
- Valor predeterminado de
--[no]expunge
: “falso” -
Si es verdadero, clean quita todo el árbol de trabajo de esta instancia de Bazel, que incluye todos los archivos temporales de salida y de compilación creados por Bazel, y detiene el servidor de Bazel si está en ejecución.
Etiquetas:host_machine_resource_optimizations
--expunge_async
-
Si se especifica, limpia de forma asíncrona quita todo el árbol de trabajo de esta instancia de Bazel, que incluye todos los archivos temporales de salida y de compilación creados por Bazel, y detiene el servidor de Bazel si está en ejecución. Cuando se complete este comando, será seguro ejecutar comandos nuevos en el mismo cliente, aunque la eliminación continúe en segundo plano.
Se expande a:
--expunge
--async
Etiquetas:host_machine_resource_optimizations
- Valor predeterminado de
--[no]remove_all_convenience_symlinks
: “falso” -
Si es verdadero, se borrarán todos los symlinks del espacio de trabajo con el prefijo symlink_prefix. Sin esta marca, solo se borrarán los symlinks con los sufijos predefinidos.
Etiquetas:affects_outputs
- Opciones que afectan la forma estricta en que Bazel aplica las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etc.):
--experimental_repository_hash_file=<a string>
predeterminado: ""-
Si el campo no está vacío, especifica un archivo que contiene un valor resuelto, en el que se deben verificar los hash del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan
--experimental_verify_repository_rules=<a string>
usos múltiples - Si la lista de reglas del repositorio para la que se debe verificar el hash del directorio de salida, siempre que --experimental_repository_hash_file proporcione un archivo
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o de la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: “verdadero”-
No-op
Etiquetas:no_op
,deprecated
,experimental
- Opciones relacionadas con los resultados y la semántica de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Se especificaron las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran en un registro del origen del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones con bloqueos harán que falle la resolución. También puedes definir una versión ya permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puede inhabilitar esta comprobación con la palabra clave "todo" (no se recomienda).
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
: "Error" -
Comprueba la compatibilidad de los módulos de Bazel con la versión 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 detecta una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "warning"-
Comprueba si las dependencias directas de "bazel_dep" declaradas en el módulo raíz son las mismas que se muestran en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la comprobación, "warning" para mostrar una advertencia cuando se detecta una discrepancia o "error" para escalarla a una falla de resolución.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]ignore_dev_dependency
: “falso” -
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declaradas como "dev_dependency" en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev se ignoran siempre en MODULE.bazel si no es el módulo raíz independientemente del valor de esta marca.
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 un directorio local.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en registros anteriores y solo volverán a los registros posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Valor predeterminado de
--[no]experimental_record_metrics_for_all_mnemonics
: “falso” - De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 nombres con la mayor cantidad de acciones ejecutadas. Si se establece esta opción, se escribirán estadísticas para todos los mnemónicos.
- Opciones para especificar o alterar una entrada genérica en un comando de Bazel que no se encuentre en otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si el archivo resuelto 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é remotas:
--experimental_downloader_config=<a string>
predeterminado: ver descripción- Especifica un archivo para configurar la descarga remota. Este archivo consta de líneas y cada una comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para coincidir y uno para usar como URL sustituta. Las referencias inversas comienzan desde "$1". Es posible que se muestren varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias.
- Varias opciones, sin otra categoría
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con un directorio local.
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 -
Puedes buscar archivos adicionales antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]experimental_repository_cache_hardlinks
: “falso” -
Si se configura, la caché del repositorio vinculará el archivo en caso de un acierto de caché, en lugar de copiarlo. Esto está destinado a ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]experimental_repository_cache_urls_as_default_canonical_id
: “falso” -
Si es verdadero, usa una string derivada de las URL de las descargas del repositorio como el canonical_id si no se especifica. Esto hace que un cambio en las URL provoque una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no generen la máscara de caché de los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
- Valor predeterminado de
--[no]experimental_repository_disable_download
: “falso” - 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 configura en 0, los reintentos están inhabilitados.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark según este factor. De esta manera, los repositorios externos pueden funcionar en máquinas que son más lentas de lo que espera el autor de la regla, sin cambiar el código fuente
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas HTTP mediante el factor determinado
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: ver descripción-
Especifica la ubicación de la 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 forma estricta en que Bazel aplica las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etc.):
--experimental_repository_hash_file=<a string>
predeterminado: ""-
Si el campo no está vacío, especifica un archivo que contiene un valor resuelto, en el que se deben verificar los hash del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan
--experimental_verify_repository_rules=<a string>
usos múltiples - Si la lista de reglas del repositorio para la que se debe verificar el hash del directorio de salida, siempre que --experimental_repository_hash_file proporcione un archivo
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o de la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: “verdadero”-
No-op
Etiquetas:no_op
,deprecated
,experimental
- Opciones relacionadas con los resultados y la semántica de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Se especificaron las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran en un registro del origen del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones con bloqueos harán que falle la resolución. También puedes definir una versión ya permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puede inhabilitar esta comprobación con la palabra clave "todo" (no se recomienda).
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
: "Error" -
Comprueba la compatibilidad de los módulos de Bazel con la versión 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 detecta una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "warning"-
Comprueba si las dependencias directas de "bazel_dep" declaradas en el módulo raíz son las mismas que se muestran en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la comprobación, "warning" para mostrar una advertencia cuando se detecta una discrepancia o "error" para escalarla a una falla de resolución.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]ignore_dev_dependency
: “falso” -
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declaradas como "dev_dependency" en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev se ignoran siempre en MODULE.bazel si no es el módulo raíz independientemente del valor de esta marca.
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 un directorio local.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en registros anteriores y solo volverán a los registros posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Valor predeterminado de
--[no]experimental_record_metrics_for_all_mnemonics
: “falso” - De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 nombres con la mayor cantidad de acciones ejecutadas. Si se establece esta opción, se escribirán estadísticas para todos los mnemónicos.
- Opciones para especificar o alterar una entrada genérica en un comando de Bazel que no se encuentre en otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si el archivo resuelto 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é remotas:
--experimental_downloader_config=<a string>
predeterminado: ver descripción- Especifica un archivo para configurar la descarga remota. Este archivo consta de líneas y cada una comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para coincidir y uno para usar como URL sustituta. Las referencias inversas comienzan desde "$1". Es posible que se muestren varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias.
- Varias opciones, sin otra categoría
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con un directorio local.
Opciones de consulta
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 -
Puedes buscar archivos adicionales antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]experimental_repository_cache_hardlinks
: “falso” -
Si se configura, la caché del repositorio vinculará el archivo en caso de un acierto de caché, en lugar de copiarlo. Esto está destinado a ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]experimental_repository_cache_urls_as_default_canonical_id
: “falso” -
Si es verdadero, usa una string derivada de las URL de las descargas del repositorio como el canonical_id si no se especifica. Esto hace que un cambio en las URL provoque una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no generen la máscara de caché de los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
- Valor predeterminado de
--[no]experimental_repository_disable_download
: “falso” - 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 configura en 0, los reintentos están inhabilitados.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark según este factor. De esta manera, los repositorios externos pueden funcionar en máquinas que son más lentas de lo que espera el autor de la regla, sin cambiar el código fuente
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas HTTP mediante el factor determinado
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: ver descripción-
Especifica la ubicación de la 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 forma estricta en que Bazel aplica las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etc.):
--experimental_repository_hash_file=<a string>
predeterminado: ""-
Si el campo no está vacío, especifica un archivo que contiene un valor resuelto, en el que se deben verificar los hash del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan
--experimental_verify_repository_rules=<a string>
usos múltiples - Si la lista de reglas del repositorio para la que se debe verificar el hash del directorio de salida, siempre que --experimental_repository_hash_file proporcione un archivo
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o de la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: “verdadero”-
No-Tags:no_op
,deprecated
,experimental
- Opciones relacionadas con el resultado de la consulta y la semántica:
- Valor predeterminado de
--aspect_deps=<off, conservative or precise>
: “conservadora” - Cómo resolver dependencias de aspecto cuando el formato de salida es {xml,proto,record}. "Apagado" significa que no se resuelven dependencias de aspecto, "conservadora" (predeterminada) significa que se agregan todas las dependencias de aspecto declaradas, independientemente de si se le otorga la clase de regla de dependencias directas. "Precisa" significa que solo se agregan esos aspectos que posiblemente estén activos según la clase de regla de las dependencias directas. Ten en cuenta que el modo preciso requiere que se carguen otros paquetes para evaluar un único destino, lo que lo hace más lento que los otros modos. También ten en cuenta que el modo incluso 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 'consulta de Bazel'.
Etiquetas:build_file_semantics
--[no]graph:factored
predeterminado: “verdadero”-
Si es verdadero, el grafo se emitirá como “factorizado”, es decir, los nodos con una equivalencia topológica equivalente se combinarán y sus etiquetas se concatenarán. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
- Valor predeterminado de
--graph:node_limit=<an integer>
: “512” - La longitud máxima de la string de la etiqueta para un nodo del grafo en el resultado. Las etiquetas más largas se truncarán. Si el valor es -1, no se truncará. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--[no]implicit_deps
predeterminado: “verdadero”- Si se habilita esta opción, se incluirán las dependencias implícitas en el gráfico de dependencias sobre el que opera la consulta. Una dependencia implícita no se especifica de forma explícita en el archivo BUILD, pero se agrega mediante Bazel. Para cquery, esta opción controla el filtrado de las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
--[no]include_aspects
predeterminado: “verdadero”-
query, cquery: si se deben incluir acciones generadas por aspectos en el resultado. query: no-op (los aspectos siempre se siguen).
Etiquetas:terminal_output
--[no]incompatible_display_source_file_location
predeterminado: “verdadero”- Verdadero y predeterminado, 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
--[no]incompatible_package_group_includes_double_slash
predeterminado: “verdadero”-
Si se habilita, no se omitirá el "//" inicial del resultado del atributo `packages` del paquete package_group.
Etiquetas:terminal_output
,incompatible_change
- Valor predeterminado de
--[no]infer_universe_scope
: “falso” - Si no se configura y --universe_scope, se deducirá un valor de --universe_scope como la lista de patrones de destino únicos en la expresión de consulta. Ten en cuenta que el valor --universe_scope inferido para una expresión de consulta que usa funciones con alcance universal (p.ej., "allrdeps") puede no ser lo que deseas, por lo que debes usar esta opción solo si sabes lo que estás haciendo. Consulta https://bazel.build/query/language#sky-query para conocer los detalles y ejemplos. Si --universe_scope se establece, se ignora el valor de esta opción. Nota: Esta opción solo se aplica a `query` (es decir, no `cquery`).
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]line_terminator_null
: “falso” -
Indica si cada formato termina con \0 en lugar de saltos de línea.
Etiquetas:terminal_output
--[no]nodep_deps
predeterminado: “verdadero”- Si está habilitada, las dependencias de los atributos “nodep” se incluirán en el gráfico de dependencia sobre el que opera la consulta. Un ejemplo común de atributo “nodep” es la “visibilidad”. Ejecuta y analiza el resultado de "info build-language" para conocer todos los atributos "nodep" del lenguaje de compilación.
Etiquetas:build_file_semantics
--output=<a string>
predeterminado: “etiqueta”-
Es el formato en el que se deben imprimir los resultados de la consulta. Los valores permitidos para cquery son: label, label_kind, textproto, transiciones, proto, jsonproto. Si seleccionas "transiciones", también deberás especificar la opción --transitions=(lite|full).
Etiquetas:terminal_output
--[no]proto:default_values
predeterminado: “verdadero”-
Si es verdadero, se incluyen los atributos cuyo valor no se especifica de forma explícita en el archivo BUILD. De lo contrario, se omiten. Esta opción se aplica a --output=proto
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:definition_stack
: “falso” -
Propaga el campo de protocolo de definiciones_stack, que registra cada instancia de las reglas, la pila de llamadas de Starlark en el momento en que se definió la clase de la regla.
Etiquetas:terminal_output
--[no]proto:flatten_selects
predeterminado: “verdadero”-
Si están habilitados, los atributos configurables creados por select() se acoplan. Para los tipos de lista, la representación plana es una lista que contiene cada valor del mapa seleccionado exactamente una vez. Los tipos de escalar se aplanan en un valor nulo.
Etiquetas:build_file_semantics
--[no]proto:include_configurations
predeterminado: “verdadero”- , si está habilitado, el resultado del protocolo incluirá información sobre las configuraciones. Cuando está inhabilitado,el formato de salida de protocolo de consulta se parece al formato de salida de consulta.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]proto:include_synthetic_attribute_hash
: “falso” -
Indica si se debe calcular y propagar el atributo $internal_attr_hash.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:instantiation_stack
: “falso” -
Propaga la pila de llamadas de creación de instancias de cada regla. Ten en cuenta que esto requiere que la pila esté presente.
Etiquetas:terminal_output
--[no]proto:locations
predeterminado: “verdadero”-
Indica si se debe generar información de ubicación en el resultado del protocolo.
Etiquetas:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
predeterminado: "todos"-
Lista de atributos separados por comas que se incluirán en el resultado. La configuración predeterminada es todos los atributos. Configúralo como una string vacía para no generar ningún atributo. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
--[no]proto:rule_inputs_and_outputs
predeterminado: “verdadero”-
Indica si se deben propagar o no los campos rule_input y rule_output.
Etiquetas:terminal_output
--query_file=<a string>
predeterminado: ""- Si se establece, la consulta leerá la consulta del archivo nombrado aquí, en lugar de hacerlo en la línea de comandos. Es un error especificar aquí un archivo, así como una consulta de línea de comandos.
Etiquetas:changes_inputs
- Valor predeterminado de
--[no]relative_locations
: “falso” -
Si es verdadero, la ubicación de los archivos BUILD en los resultados XML y proto será relativa. De forma predeterminada, el resultado de ubicación es una ruta absoluta y no será coherente entre las máquinas. Puedes establecer esta opción como verdadera para obtener un resultado coherente en todas las máquinas.
Etiquetas:terminal_output
--show_config_fragments=<off, direct or transitive>
predeterminado: "desactivado"-
Muestra los fragmentos de configuración que requieren 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 objetivo configurado en el modo --output=starlark de cquery. El destino configurado está vinculado a “target”. Si no se especifica --starlark:expr ni --starlark:file, esta opción se configurará de forma predeterminada como "str(target.label)". Es un error especificar tanto --starlark:expr como --starlark:file.
Etiquetas:terminal_output
--starlark:file=<a string>
predeterminado: ""-
El nombre de un archivo que define una función de Starlark, denominada "format", de un argumento, que se aplica a cada destino configurado para darle el formato de string. Es un error especificar tanto --starlark:expr como --starlark:file. Para obtener más detalles, consulta la ayuda de --output=starlark.
Etiquetas:terminal_output
--[no]tool_deps
predeterminado: “verdadero”- Consulta: Si está inhabilitada, las dependencias de los objetivos de “configuración del host” o “ejecución” no se incluirán en el gráfico de dependencias sobre el que opera la consulta. Una arista de dependencia de “configuración de host”, como la de cualquier regla de “proto_library” al compilador de protocolo, suele apuntar a una herramienta ejecutada durante la compilación en lugar de ser parte del mismo programa de “destino”.
Consulta: Si se inhabilita, se filtran 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 en la configuración de destino. Si el destino de nivel superior está en la configuración del host, solo se mostrarán los objetivos configurados por el host. Esta opción NO excluirá los conjuntos de herramientas resueltos.
Etiquetas:build_file_semantics
--transitions=<full, lite or none>
predeterminado: "ninguno".- 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 destino separados por comas (aditivos y sustractivos). La consulta se puede realizar en el universo definido por el cierre transitivo de los destinos especificados. Esta opción se usa para los comandos query y cquery.
Para cquery, la entrada a esta opción es el destino en el que se compilan todas las respuestas, por lo que esta opción puede afectar la configuración y las transiciones. Si no se especifica esta opción, se supone que los objetivos de nivel superior son los objetivos analizados desde la expresión de consulta. Nota: En el caso de cquery, si no se especifica esta opción, la compilación puede fallar si los objetivos analizados de la expresión de consulta no se pueden compilar con opciones de nivel superior.
Etiquetas:loading_and_analysis
- Opciones relacionadas con la salida y la semántica de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Se especificaron las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran en un registro del origen del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones con bloqueos harán que falle la resolución. También puedes definir una versión ya permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puede inhabilitar esta comprobación con la palabra clave "todo" (no se recomienda).
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
: "Error" -
Comprueba la compatibilidad de los módulos de Bazel con la versión 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 detecta una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "warning"-
Comprueba si las dependencias directas de "bazel_dep" declaradas en el módulo raíz son las mismas que se muestran en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la comprobación, "warning" para mostrar una advertencia cuando se detecta una discrepancia o "error" para escalarla a una falla de resolución.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]ignore_dev_dependency
: “falso” -
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declaradas como "dev_dependency" en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev se ignoran siempre en MODULE.bazel si no es el módulo raíz independientemente del valor de esta marca.
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 un directorio local.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en registros anteriores y solo volverán a los registros posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Valor predeterminado de
--[no]experimental_record_metrics_for_all_mnemonics
: “falso” - De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 nombres con la mayor cantidad de acciones ejecutadas. Si se establece esta opción, se escribirán estadísticas para todos los mnemónicos.
- Opciones para especificar o alterar una entrada genérica en un comando de Bazel que no se encuentre en otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si el archivo resuelto 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é remotas:
--experimental_downloader_config=<a string>
predeterminado: ver descripción- Especifica un archivo para configurar la descarga remota. Este archivo consta de líneas y cada una comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para coincidir y uno para usar como URL sustituta. Las referencias inversas comienzan desde "$1". Es posible que se muestren varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias.
- Varias opciones, sin otra categoría
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con un directorio local.
- Opciones para controlar la ejecución de la compilación:
- Valor predeterminado de
--[no]experimental_inprocess_symlink_creation
: “falso” -
Determina si se deben realizar llamadas directas al sistema de archivos para crear árboles de enlaces simbólicos.
Etiquetas:loading_and_analysis
,execution
,experimental
- Valor predeterminado de
--[no]experimental_remotable_source_manifests
: “falso” -
Determina si se deben realizar acciones remotas en el manifiesto de origen.
Etiquetas:loading_and_analysis
,execution
,experimental
- Valor predeterminado de
--[no]experimental_split_coverage_postprocessing
: “falso” -
Si es verdadero, Bazel ejecutará el procesamiento posterior de la cobertura para pruebas en un nuevo campo de generación.
Etiquetas:execution
- Valor predeterminado de
--[no]experimental_strict_fileset_output
: “falso” - Si esta opción está habilitada, los conjuntos de archivos tratarán todos los artefactos de salida como archivos normales. No desvían directorios ni son sensibles a los symlinks.
Etiquetas:execution
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
predeterminado: ""- Agrega o quita claves de la información de ejecución de una acción según la actividad nemotécnica. 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 se pueden aplicar muchas regex a la misma mnemónica.
Sintaxis: "regex=[+-]clave,regex=[+-]clave,...".
Ejemplos: ".*=+x,.*=-y,.*=+z" agrega "x" y "z" a la información de ejecución de todas las acciones, y la quita "y".
"Genrule=+require-x" agrega "require-x" a la información de ejecución para todas las acciones de Genrule.
“(?!Genrule).*=-require-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 acciones persistentes de dex y desugaring con trabajadores.
Se expande a:
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
- Habilita el procesador de recursos persistentes de Android mediante el uso de 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
{1/2}{1/2} --persistent_multiplex_android_dex_desugar
- Habilita las acciones de dex multiplexas persistentes y las acciones de expansión de sintaxis mediante el uso de trabajadores.
Se expande a:
--persistent_android_dex_desugar
--modify_execution_info=Desugar=+supports-multiplex-workers
--modify_execution_info=DexBuilder=+supports-multiplex-workers
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
- Habilita el procesador de recursos multiplexado persistente de Android mediante el uso de 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
{1/2}{1/2} --persistent_multiplex_android_tools
- Habilita herramientas de Android persistentes y multiplexadas (dexing, expansión de sintaxis y procesamiento de recursos).
Se expande a:
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Etiquetas:host_machine_resource_optimizations
,execution
- Opciones que configuran la cadena de herramientas que se usa para ejecutar la acción:
--android_compiler=<a string>
predeterminado: ver descripción-
El compilador de destino de Android
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Valor predeterminado de
--android_crosstool_top=<a build target label>
: "//external:android/crosstool" -
La ubicación del compilador C++ que se usó para las compilaciones de Android.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_grte_top=<a label>
predeterminado: ver descripción- El destino androidte: grte_top
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
- Valor predeterminado de
--android_manifest_merger=<legacy, android or force_android>
: "android" -
Selecciona la combinación de manifiestos que se usará para las reglas de android_binary. Marca para ayudar a la transición a la fusión de manifiesto de Android desde la fusión heredada.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_platforms=<a build target label>
predeterminado: ""-
Configura las plataformas que usan los objetivos de android_binary. Si se especifican varias plataformas, el objeto binario es un APK multiarquitectura, que contiene objetos binarios nativos para cada plataforma de destino especificada.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_sdk=<a build target label>
predeterminado: "@bazel_tools//tools/android:sdk"-
Especifica la plataforma o el SDK de Android que se usa a fin de compilar aplicaciones para Android.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--apple_compiler=<a string>
predeterminado: 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”-
Es la etiqueta del paquete crosstool que se usará en las reglas de Apple y Objc, y sus dependencias.
Etiquetas:loses_incremental_state
,changes_inputs
--apple_grte_top=<a build target label>
predeterminado: ver descripción-
El objetivo de grte_top de Apple.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
--cc_output_directory_tag=<a string>
predeterminado: ""-
Especifica un sufijo para agregarlo al directorio de configuración.
Etiquetas:affects_outputs
,explicit_in_output_path
--compiler=<a string>
predeterminado: ver descripción- El compilador 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"-
Es la ubicación del objeto binario que se usa para procesar con anterioridad los informes de cobertura sin procesar. Actualmente, debe ser un grupo de archivos que contenga un solo archivo (el objeto binario). La configuración predeterminada es “//tools/test:lcov_merger”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
- Valor predeterminado de
--coverage_report_generator=<a build target label>
: “@bazel_tools//tools/test:coverage_report_generator” -
Es la ubicación del objeto binario que se usa para generar los informes de cobertura. Actualmente, debe ser un grupo de archivos que contenga un solo archivo (el objeto binario). La configuración predeterminada es “//tools/test:coverage_report_generator”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
- Valor predeterminado de
--coverage_support=<a build target label>
: "@bazel_tools//tools/test:coverage_support" -
Ubicación de los archivos de asistencia obligatorios en las entradas de cada acción de prueba que recopila la cobertura del 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 crosstool que se usará para compilar el código C++.
Etiquetas:loading_and_analysis
,changes_inputs
,affects_outputs
--custom_malloc=<a build target label>
predeterminado: ver descripción-
Especifica una implementación personalizada de malloc. Esta 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 destino no coincide con ninguna expresión negativa y al menos una expresión positiva, la resolución de su cadena de herramientas se realizará como si hubiera declarado los valores de restricción como restricciones de ejecución. Ejemplo: //demo,-test=@platforms//cpus:x86_64 agregará 'x86_64' a cualquier destino en //demo, excepto aquellos cuyo nombre contenga 'test'.
Etiquetas:loading_and_analysis
--[no]experimental_enable_objc_cc_deps
predeterminado: “verdadero”-
Permite que las reglas objc_* dependan de cc_library y haga que las dependencias objc se compilen con --cpu establecido en "ios_<--ios_cpu>" para cualquier valor en --ios_multi_cpu.
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]experimental_include_xcode_execution_requirements
: “falso” -
Si se configura, agrega un requisito de ejecución "require-xcode:{version}" a cada acción de Xcode. Si la versión xcode tiene una etiqueta con guion, agrega también un requisito de ejecución “require-xcode-label:{version_label}.
Etiquetas:loses_incremental_state
,loading_and_analysis
,execution
--[no]experimental_prefer_mutual_xcode
predeterminado: “verdadero”-
Si es verdadero, usa el Xcode más reciente que esté disponible de forma local y remota. Si es falso, o si no hay versiones mutuas disponibles, utiliza 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 - Las plataformas que están disponibles como plataformas de ejecución para ejecutar acciones. Las plataformas pueden especificarse por objetivo exacto o como un patrón de destino. Se considerarán estas plataformas antes de las que se declaran en el archivo WORKSPACE mediante register_execution_platforms().
Etiquetas:execution
- Se acumulan
--extra_toolchains=<comma-separated list of options>
usos múltiples - Las reglas de la cadena de herramientas se deben tener en cuenta durante su resolución. Las cadenas de herramientas se pueden especificar mediante un objetivo exacto o como un patrón de destino. Estas cadenas de herramientas se tendrán en cuenta antes de las que se registraron en el archivo WORKSPACE.
--grte_top=<a label>
predeterminado: ver descripción-
Etiqueta a una biblioteca libc registrada. El conjunto de herramientas Crosstool selecciona el valor predeterminado, y casi nunca es necesario anularlo.
Etiquetas:action_command_lines
,affects_outputs
--host_compiler=<a string>
predeterminado: ver descripción-
El compilador C++ que se usará en la compilación del host. Se ignora si no se establece --host_crosstool_top.
Etiquetas:loading_and_analysis
,execution
--host_crosstool_top=<a build target label>
predeterminado: 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 determinada.
Etiquetas:loading_and_analysis
,changes_inputs
,affects_outputs
--host_grte_top=<a label>
predeterminado: ver descripción- Si se especifica, esta configuración anula el directorio de nivel superior de libc (--grte_top) para la configuración del host.
Etiquetas:action_command_lines
,affects_outputs
--host_platform=<a build target label>
predeterminado: ""- Es la etiqueta de una regla de plataforma que describe el sistema host.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--[no]incompatible_disable_expand_if_all_available_in_flag_set
predeterminado: “verdadero”-
Si es verdadero, Bazel no permitirá especificar expand_if_all_available en flag_sets(consulte https://github.com/bazelbuild/bazel/issues/7008 para obtener instrucciones de migración).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
predeterminado: “verdadero”-
Si es verdadero, Bazel no habilitará las funciones "host" y "nonhost" en la cadena de herramientas de c++ (consulte https://github.com/bazelbuild/bazel/issues/7407 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]incompatible_enable_android_toolchain_resolution
: “falso” -
Usa la resolución de la cadena de herramientas a fin de seleccionar el SDK de Android para las reglas de Android (Starlark y nativo)
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]incompatible_enable_apple_toolchain_resolution
: “falso” -
Usa la resolución de la cadena de herramientas con el fin de seleccionar el SDK de Apple para las reglas de Apple (nativo y Starlark)
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone
predeterminado: “verdadero”-
Si es verdadero, Bazel no volverá a usar las líneas de comandos de la acción de vínculo de C++ para las líneas de comandos de indexación de lto (consulte https://github.com/bazelbuild/bazel/issues/6791 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]incompatible_objc_linking_info_migration
: “falso” -
Si es verdadero, las reglas integradas de ObjC obtendrán su información de vinculación desde CcInfo en lugar de ObjcProvider. Consulta https://github.com/bazelbuild/bazel/issues/16939 para obtener más detalles y detalles sobre la migración.
Etiquetas:loading_and_analysis
,changes_inputs
,incompatible_change
--[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain
predeterminado: “verdadero”-
Si es verdadero, Bazel se quejará cuando se establezcan los atributos cc_toolchain.cpu y cc_toolchain.compiler (consulte https://github.com/bazelbuild/bazel/issues/7075 para obtener instrucciones de migración).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_legacy_whole_archive
predeterminado: “verdadero”-
Si es verdadero, Bazel no vinculará las dependencias de la biblioteca como archivo completo de forma predeterminada (consulte https://github.com/bazelbuild/bazel/issues/7362 para obtener instrucciones de migración).
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_require_ctx_in_configure_features
predeterminado: “verdadero”-
Si es verdadero, Bazel requerirá el parámetro “ctx” en cc_common.configure_features (consulte 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 son compatibles con la cadena de herramientas. Todas las cadenas de herramientas de ELF actualmente admiten esta configuración.
Etiquetas:loading_and_analysis
,affects_outputs
,affects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: ver descripción-
Especifica la versión del SDK de iOS que se usará para compilar aplicaciones para iOS. Si no se especifica, se usa la versión predeterminada del SDK de iOS a partir de "xcode_version".
Etiquetas:loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: ver descripción-
Especifica la versión del SDK de macOS que se usará para compilar las aplicaciones para macOS. Si no se especifica, se usa la versión predeterminada del SDK de macOS de 'xcode_version'.
Etiquetas:loses_incremental_state
--minimum_os_version=<a string>
predeterminado: ver descripción-
Es la versión mínima del SO a la que se orienta tu compilación.
Etiquetas:loading_and_analysis
,affects_outputs
--platform_mappings=<a relative path>
predeterminado: ""-
La ubicación de un archivo de asignación que describe qué plataforma usar si no se configuró ninguna o qué marcas establecer cuando ya existe una plataforma. Debe estar relacionado con la raíz del espacio de trabajo principal. La configuración predeterminada es “platform_mappings” (un archivo ubicado directamente en la raíz del espacio de trabajo).
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--platforms=<a build target label>
predeterminado: ""-
Las etiquetas de las reglas de la plataforma que describen las plataformas de destino del comando actual.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--python2_path=<a string>
predeterminado: ver descripción-
Obsoleto, no-op. Inhabilitado por `--incompatible_use_python_toolchains`.
Etiquetas:no_op
,deprecated
--python3_path=<a string>
predeterminado: ver descripción-
Obsoleto, no-op. Inhabilitado por `--incompatible_use_python_toolchains`.
Etiquetas:no_op
,deprecated
--python_path=<a string>
predeterminado: ver descripción- La ruta de acceso absoluta del intérprete de Python invocada para ejecutar destinos de Python en la plataforma de destino. Obsoleto; inhabilitado por --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
--python_top=<a build target label>
predeterminado: ver descripción-
Es la etiqueta de un py_runtime que representa al 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
- Valor predeterminado de
--target_platform_fallback=<a build target label>
: “@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 se asigna el conjunto actual de marcas.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: 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
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: 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 desde 'xcode_version'.
Etiquetas:loses_incremental_state
--xcode_version=<a string>
predeterminado: ver descripción-
Si se especifica, usa Xcode de la versión determinada para las acciones de compilación relevantes. Si no se especifica, se usa la versión predeterminada de Xcode para ejecutar.
Etiquetas:loses_incremental_state
- Valor predeterminado de
--xcode_version_config=<a build target label>
: "@bazel_tools//tools/cpp:host_xcodes" -
Es la etiqueta de la regla xcode_config que se usará para seleccionar la versión de Xcode en la configuración de compilación.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Opciones que controlan el resultado del comando:
- Valor predeterminado de
--[no]apple_enable_auto_dsym_dbg
: “falso” -
Determina si se fuerza la habilitación de la generación de archivos de símbolos de depuración (.dSYM) para las compilaciones dbg.
Etiquetas:affects_outputs
,action_command_lines
- Valor predeterminado de
--[no]apple_generate_dsym
: “falso” -
Indica si se deben generar archivos de símbolos de depuración (.dSYM).
Etiquetas:affects_outputs
,action_command_lines
--[no]build_runfile_links
predeterminado: “verdadero”-
Si es verdadero, compila bosques de archivos de symlink de runfiles para todos los destinos. Si es falso, escriba solo los manifiestos cuando sea posible.
Etiquetas:affects_outputs
--[no]build_runfile_manifests
predeterminado: “verdadero”-
Si es verdadero, escribe manifiestos de archivos de ejecución para todos los destinos. Si es falso, omítelo. Las pruebas locales no se ejecutarán cuando sean falsas.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]build_test_dwp
: “falso” -
Si se habilita, cuando se compilen pruebas de C++ de manera estática y con fisiones, también se compilará automáticamente el archivo .dwp para los objetos binarios de las pruebas.
Etiquetas:loading_and_analysis
,affects_outputs
- Valor predeterminado de
--cc_proto_library_header_suffixes=<comma-separated list of options>
: “.pb.h” -
Establece los prefijos de los archivos de encabezado que crea una cc_proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
- Valor predeterminado de
--cc_proto_library_source_suffixes=<comma-separated list of options>
: “.pb.cc” -
Establece los prefijos de los archivos de origen que crea una cc_proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
- Valor predeterminado de
--[no]experimental_proto_descriptor_sets_include_source_info
: “falso” - Ejecuta acciones adicionales para versiones de API alternativas de Java en una proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
- Valor predeterminado de
--[no]experimental_proto_extra_actions
: “falso” - Ejecuta acciones adicionales para versiones de API alternativas de Java en una proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
- Valor predeterminado de
--[no]experimental_save_feature_state
: “falso” - Guarda el estado de las funciones habilitadas y solicitadas como resultado de una compilación.
Etiquetas:affects_outputs
,experimental
--fission=<a set of compilation modes>
predeterminado: "no".-
Especifica los modos de compilación que usan fisión para las compilaciones y los vínculos de C++. Puede ser cualquier combinación de {'fastbuild', 'dbg', 'opt'} o los valores especiales 'yes' para habilitar todos los modos y 'no' para inhabilitar todos los modos.
Etiquetas:loading_and_analysis
,action_command_lines
,affects_outputs
--[no]incompatible_always_include_files_in_data
predeterminado: “verdadero”-
Si es verdadero, las reglas nativas agregan <code>DefaultInfo.files</code> de las dependencias de datos a sus archivos runfile, lo que coincide con el comportamiento recomendado para las reglas de Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid).
Etiquetas:affects_outputs
,incompatible_change
--[no]legacy_external_runfiles
predeterminado: “verdadero”-
Si es verdadero, compile bosques de symlink de runfiles para repositorios externos en .runfiles/wsname/external/repo (además de .runfiles/repo).
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]objc_generate_linkmap
: “falso” -
Especifica si se debe generar un archivo de mapa de vínculos.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]save_temps
: “falso” -
Si se configura, se guardarán los resultados temporales de gcc. Entre estos archivos, se incluyen los archivos .s (código ensamblador), los archivos .i (C preprocesados) y los archivos .ii (C++ procesados).
Etiquetas:affects_outputs
- Opciones que permiten que el usuario configure el resultado deseado y afecte su valor, a diferencia de su existencia:
- Se acumulan
--action_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica el conjunto de variables de entorno disponibles para las acciones con la configuración objetivo. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación o por el par nombre=valor que establece el valor independientemente del entorno de invocación. Esta opción se puede utilizar varias veces. En el caso de las opciones proporcionadas para la misma variable, las últimas victorias se acumulan, las opciones para las diferentes variables se acumulan.
Etiquetas:action_command_lines
- Valor predeterminado de
--android_cpu=<a string>
: “armeabi-v7a” -
La CPU de destino de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Valor predeterminado de
--[no]android_databinding_use_androidx
: “falso” -
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
,experimental
- Valor predeterminado de
--[no]android_databinding_use_v3_4_args
: “falso” -
Usa la vinculación de datos de Android v2 con el argumento 3.4.0
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--android_dynamic_mode=<off, default or fully>
predeterminado: "desactivado"-
Determina si los dependencias de C++ de las reglas de Android se vincularán de forma dinámica cuando un cc_binary no cree explícitamente una biblioteca compartida. "default" significa que Bazel elegirá si se vincula de forma dinámica. "completamente" significa que todas las bibliotecas se vincularán de forma dinámica. "Desactivada" significa que todas las bibliotecas estarán vinculadas en su mayoría en modo estático.
Etiquetas:affects_outputs
,loading_and_analysis
- Valor predeterminado de
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
: "alfabético". -
Establece el orden de los manifiestos que se pasan a la combinación de manifiestos para los objetos binarios de Android. ALFABÉTICO significa que los manifiestos se ordenan según la ruta de acceso en relación con la ejecución de reglas. ALPHABETICAL_BY_CONFIGURATION significa que los manifiestos se ordenan según las rutas de acceso relativas al directorio de configuración dentro del directorio de salida. DEPENDENCY significa que los manifiestos se ordenan con cada manifiesto de la biblioteca antes que los manifiestos de sus dependencias.
Etiquetas:action_command_lines
,execution
- Valor predeterminado de
--[no]android_resource_shrinking
: “falso” -
Habilita la reducción de recursos para APK 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, 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 la forma “[platform=]mode”, en la 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 para 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
--[no]build_python_zip
predeterminado: "automático"-
Compila el ZIP ejecutable 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 cuales crear objetos binarios de Catalyst de Apple.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Valor predeterminado de
--[no]collect_code_coverage
: “falso” -
Si se especifica, Bazel instrumentará el código (mediante la instrumentación sin conexión) 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 se debe especificar directamente; en su lugar, se debe usar el comando “bazelcover”.
Etiquetas:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] predeterminado: "fastbuild"-
Especifica el modo en que se compilará el objeto binario. Valores: “fastbuild”, “dbg”, “opt”.
Etiquetas:affects_outputs
,action_command_lines
,explicit_in_output_path
- Se acumulan
--conlyopt=<a string>
usos múltiples -
Opción adicional de 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
--cs_fdo_absolute_path=<a string>
predeterminado: ver descripción-
Usa la información del perfil de CSFDO para optimizar la compilación. Especifica el nombre de ruta de acceso absoluta del archivo ZIP que contiene el archivo de perfil, un archivo de perfil de LLVM sin procesar o indexado.
Etiquetas:affects_outputs
--cs_fdo_instrument=<a string>
predeterminado: ver descripción-
Genera objetos binarios con instrumentación de FDO contextual. Con el compilador de Clang/LLVM, también acepta el nombre del directorio bajo el cual se volcarán los archivos del perfil sin procesar en el tiempo de ejecución.
Etiquetas:affects_outputs
--cs_fdo_profile=<a build target label>
predeterminado: 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 -
Opción adicional de 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 de definición especifica una asignación para una variable de compilación.
Etiquetas:changes_inputs
,affects_outputs
--dynamic_mode=<off, default or fully>
predeterminado: “predeterminado”-
Determina si los objetos binarios de C++ se vincularán de forma dinámica. "predeterminado" significa que Bazel elegirá si desea vincular de forma dinámica. "completamente" significa que todas las bibliotecas se vincularán de forma dinámica. "Desactivada" significa que todas las bibliotecas estarán vinculadas en su mayoría en modo estático.
Etiquetas:loading_and_analysis
,affects_outputs
--[no]enable_fdo_profile_absolute_path
predeterminado: “verdadero”-
Si se establece, el uso de fdo_absolute_profile_path generará un error.
Etiquetas:affects_outputs
--[no]enable_runfiles
predeterminado: "automático"- Habilitar el árbol de symlink de runfiles; de forma predeterminada, está desactivado en Windows y en otras plataformas.
Etiquetas:affects_outputs
- Se acumulan
--experimental_action_listener=<a build target label>
usos múltiples - Obsoleto y reemplaza los aspectos. Usa action_listener para adjuntar una acción adicional a las acciones de compilación existentes.
Etiquetas:execution
,experimental
- Valor predeterminado de
--[no]experimental_android_compress_java_resources
: “falso” -
Comprime los recursos de Java en los APK
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
- Valor predeterminado de
--[no]experimental_android_databinding_v2
: “falso” -
Usa la vinculación de datos de Android v2
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Valor predeterminado de
--[no]experimental_android_resource_shrinking
: “falso” -
Habilita la reducción de recursos para APK de android_binary que usan ProGuard.
Etiquetas:affects_outputs
,loading_and_analysis
- Valor predeterminado de
--[no]experimental_android_rewrite_dexes_with_rex
: “falso” -
Usa la herramienta rex para reescribir archivos dex.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--experimental_objc_fastbuild_options=<comma-separated list of options>
predeterminado: "-O0,-DDEBUG=1"- Usa estas strings como opciones de compilador de objc fastbuild.
Etiquetas:action_command_lines
- Valor predeterminado de
--[no]experimental_omitfp
: “falso” - Si es verdadero, usa libunwind para desenrollar la pila y compila con -fomit-frame-pointer y -fasíncrona-unwind-tables.
Etiquetas:action_command_lines
,affects_outputs
,experimental
- Valor predeterminado de
--[no]experimental_platform_in_output_dir
: “falso” - Si es verdadero, la plataforma de destino se usa en el nombre del directorio de salida, en lugar de en la CPU.
Etiquetas:affects_outputs
,experimental
- Valor predeterminado de
--[no]experimental_use_llvm_covmap
: “falso” -
Si se especifica, Bazel generará información de mapa de cobertura llvm-cov en lugar de gcov cuando se habilite collect_code_coverage.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
- Valor predeterminado de
--fat_apk_cpu=<comma-separated list of options>
: “armeabi-v7a” -
Si configuras esta opción, se habilitan los APK multiarquitectura, que contienen objetos binarios nativos para todas las arquitecturas de destino especificadas, p.ej., --fat_apk_cpu=x86,armeabi-v7a. Si se especifica esta marca, se ignora --android_cpu para las dependencias de reglas de android_binary.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Valor predeterminado de
--[no]fat_apk_hwasan
: “falso” - Determina si se deben crear divisiones de HWASAN.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--fdo_instrument=<a string>
predeterminado: ver descripción- Genera objetos binarios con instrumentación de FDO. Con el compilador de Clang/LLVM, también acepta el nombre del directorio bajo el cual se volcarán los archivos del perfil sin procesar en el tiempo de ejecución.
Etiquetas:affects_outputs
--fdo_optimize=<a string>
predeterminado: ver descripción-
Usa la información de perfil de FDO para optimizar la compilación. Especifica el nombre de un archivo ZIP que contenga un árbol de archivos .gcda, un archivo Afdo que contenga un perfil automático o un archivo de perfil LLVM. Esta marca también acepta archivos especificados como etiquetas (p.ej., "//foo/bar:file.afdo"), es posible que debas agregar una directiva "exports_files" al paquete correspondiente) y etiquetas que apunten a objetivos "fdo_profile". Esta marca se reemplazará por la regla "fdo_profile".
Etiquetas:affects_outputs
--fdo_prefetch_hints=<a build target label>
predeterminado: ver descripción-
Usa sugerencias de precarga de caché.
Etiquetas:affects_outputs
--fdo_profile=<a build target label>
predeterminado: ver descripción- El fdo_profile que representa el perfil que se usará para la optimización.
Etiquetas:affects_outputs
- Se acumulan
--features=<a string>
usos múltiples -
Las funciones proporcionadas se habilitarán o inhabilitarán de forma predeterminada para todos los paquetes. Si especificas -<feature>, se inhabilitará la función globalmente. Los elementos negativos siempre anulan a los positivos. Esta marca se usa para habilitar la implementación de cambios de funciones predeterminadas sin una versión de Bazel.
Etiquetas:changes_inputs
,affects_outputs
- Valor predeterminado de
--[no]force_pic
: “falso” -
Si se habilita, todas las compilaciones de C++ producen código independiente de posición ("-fPIC"), los vínculos prefieren las bibliotecas compiladas previamente de PIC en lugar de las bibliotecas que no son de PIC, y los vínculos producen ejecutables independientes de posición ("-pie").
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan
--host_action_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica el conjunto de variables de entorno disponibles para las acciones con configuraciones de host o ejecución. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación o por el par nombre=valor que establece el valor independientemente del entorno de invocación. Esta opción se puede utilizar varias veces. En el caso de las opciones proporcionadas para la misma variable, las últimas victorias se acumulan, las opciones para las diferentes variables se acumulan.
Etiquetas:action_command_lines
- Valor predeterminado de
--host_compilation_mode=<fastbuild, dbg or opt>
: "optar" - Especifica el modo en que se incorporarán las herramientas que se usarán durante la compilación. Valores: “fastbuild”, “dbg”, “opt”.
Etiquetas:affects_outputs
,action_command_lines
- Se acumulan
--host_conlyopt=<a string>
usos múltiples -
Opción adicional para pasar al compilador C cuando compilas archivos de origen C (pero no de C++) en las configuraciones de host o ejecución.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--host_copt=<a string>
usos múltiples -
Opciones adicionales que se pasan al compilador C para las herramientas compiladas en la configuración del host o la ejecución.
Etiquetas:action_command_lines
,affects_outputs
--host_cpu=<a string>
predeterminado: ""-
La CPU host.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan
--host_cxxopt=<a string>
usos múltiples -
Opciones adicionales que se pasan al compilador C++ para herramientas compiladas en las configuraciones de host o ejecución.
Etiquetas:action_command_lines
,affects_outputs
--host_force_python=<PY2 or PY3>
predeterminado: 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 -
Opción adicional de pasar al vinculador cuando se vinculan herramientas en la configuración del host o la ejecución.
Etiquetas:action_command_lines
,affects_outputs
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: ver descripción-
Versión mínima compatible de macOS para las orientaciones del host. Si no se especifica, se usa “macos_sdk_version”.
Etiquetas:loses_incremental_state
- Se acumulan
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
usos múltiples -
Opciones adicionales para pasar de forma selectiva al compilador C/C++ cuando se compilan determinados archivos en la configuración del host o la ejecución. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Cuando regex_filter representa una lista de incluir y excluir patrones de expresión regular (también consulta --instrumentation_filter). option_1 a option_n significa opciones de línea de comandos arbitrarias. Si una opción contiene una coma, se debe incluir una barra invertida. Las opciones pueden contener el símbolo @. Solo se usa el primer símbolo @ para dividir la string. 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 de las herramientas del host
Etiquetas:action_command_lines
,affects_outputs
--[no]incompatible_avoid_conflict_dlls
predeterminado: “verdadero”-
Si está habilitada, se cambiará el nombre de todas las bibliotecas dinámicas vinculadas a C++ (DLL) generadas por cc_library en Windows a name_{hash}.dll, en las que el hash se calcula en función del repositorio RepositoryName y la ruta de acceso del paquete de la DLL. Esta opción es útil cuando tienes un paquete que depende de varias cc_library con el mismo nombre (p. ej., //foo/bar1:utils y //foo/bar2:utils).
Etiquetas:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_merge_genfiles_directory
predeterminado: “verdadero”-
Si es verdadero, el directorio genfiles se pliega en el directorio bin.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_use_platforms_repo_for_constraints
predeterminado: “verdadero”-
Si es verdadero, se quita la configuración de restricciones de @bazel_tools.
Etiquetas:affects_outputs
,incompatible_change
- Valor predeterminado de
--[no]instrument_test_targets
: “falso” - Cuando la cobertura está habilitada, especifica si se deben considerar instrumentar reglas de prueba. Cuando se configura, se instrumentan las reglas de prueba incluidas por --instrumentation_filter. De lo contrario, las reglas de prueba siempre se excluyen de la instrumentación de cobertura.
Etiquetas:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
predeterminado: "-/javatests[/:],-/test/java[/:]"- Cuando la cobertura está habilitada, solo se instrumentarán las reglas con nombres incluidos por el filtro basado en regex especificado. En su lugar, se excluyen las reglas con el prefijo “-”. Ten en cuenta que solo se instrumentan las reglas que no son de prueba, a menos que esté habilitada la herramienta --instrument_test_targets.
Etiquetas:affects_outputs
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: ver descripción-
Versión mínima compatible de iOS para simuladores y dispositivos de destino. Si no se especifica, se usa “ios_sdk_version”.
Etiquetas:loses_incremental_state
- Se acumulan
--ios_multi_cpus=<comma-separated list of options>
usos múltiples - Lista de arquitecturas separadas por comas para crear una aplicación de ios_application. El resultado es un objeto binario universal que contiene todas las arquitecturas especificadas.
Etiquetas:loses_incremental_state
,loading_and_analysis
--[no]legacy_whole_archive
predeterminado: “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 esté activada, use --all-archive para las reglas de cc_binary que tengan linkshared=True y linklink=True o '-static' en linkopts. Esto es solo para retrocompatibilidad. Una mejor alternativa es usar siemprelink=1 cuando sea necesario.
Etiquetas:action_command_lines
,affects_outputs
,deprecated
- Se acumulan
--linkopt=<a string>
usos múltiples -
Opción adicional de pasar a gcc durante la vinculación.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--ltobackendopt=<a string>
usos múltiples -
Opción adicional para pasar al paso de backend de LTO (en --features=thin_lto).
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--ltoindexopt=<a string>
usos múltiples -
Opción adicional para pasar al paso de indexación de LTO (en --features=thin_lto).
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--macos_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se pueden compilar los objetos binarios de macOS de Apple.
Etiquetas:loses_incremental_state
,loading_and_analysis
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: ver descripción-
Versión de macOS mínima compatible para los objetivos. Si no se especifica, se usa “macos_sdk_version”.
Etiquetas:loses_incremental_state
- Valor predeterminado de
--[no]objc_debug_with_GLIBCXX
: “falso” -
Si se configura, y el modo de compilación se configura en "dbg", defina GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC y GLIBCPP_CONCEPT_CHECKS.
Etiquetas:action_command_lines
- Valor predeterminado de
--[no]objc_enable_binary_stripping
: “falso” -
Determina si se deben quitar los símbolos y códigos no entregados de los objetos binarios vinculados. Se realizará la eliminación de objetos binarios si se especifican tanto esta marca como --compilation_mode=opt.
Etiquetas:action_command_lines
- Se acumulan
--objccopt=<a string>
usos múltiples -
Opciones adicionales para pasar a GCC cuando se compilan archivos de origen de Objective-C/C++.
Etiquetas:action_command_lines
- Se acumulan
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
usos múltiples -
Opciones adicionales para pasar de forma selectiva a gcc cuando se compilan determinados archivos Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Cuando regex_filter representa una lista de incluir y excluir patrones de expresión regular (también consulta --instrumentation_filter). option_1 a option_n significa opciones de línea de comandos arbitrarias. Si una opción contiene una coma, se debe incluir una barra invertida. Las opciones pueden contener el símbolo @. Solo se usa el primer símbolo @ para dividir la string. Ejemplo: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción de la 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 determinados objetos de backend. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter representa una lista de incluir y excluir patrones de expresión regular. option_1 a option_n significa opciones de línea de comandos arbitrarias. Si una opción contiene una coma, se debe incluir una barra invertida. Las opciones pueden contener el símbolo @. Solo se usa el primer símbolo @ para dividir la string. Ejemplo: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 agrega la opción de la línea de comandos -O0 a la línea de comandos del backend de LTO de todos los archivos o en //foo/, excepto bar.o.
Etiquetas:action_command_lines
,affects_outputs
--platform_suffix=<a string>
predeterminado: ver descripción-
Especifica un sufijo para agregarlo al directorio de configuración.
Etiquetas:loses_incremental_state
,affects_outputs
,loading_and_analysis
--propeller_optimize=<a build target label>
predeterminado: ver descripción- Usa la información del perfil de propulsor para optimizar el destino de la compilación.Un perfil de propulsor debe tener al menos uno de dos archivos, uno de Cc y uno de ld. Este indicador 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 en a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)Es posible que se deba agregar una directiva export_files al paquete correspondiente para que Bazel pueda ver estos archivos. La opción se debe usar como: --propeller_optimize=//a/b:propeller_profile
Etiquetas:action_command_lines
,affects_outputs
--propeller_optimize_absolute_cc_profile=<a string>
predeterminado: ver descripción-
Nombre de ruta de acceso absoluta del archivo cc_profile para las compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
predeterminado: ver descripción-
Nombre de ruta de acceso absoluta del archivo ld_profile para las compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
--run_under=<a prefix in front of command>
predeterminado: ver descripción-
Prefijo que se debe insertar antes de los archivos ejecutables para los comandos "test" y "run". Si el valor es "foo -bar" y la línea de comandos de ejecución es "test_binary -baz", la línea de comandos final es "foo -bar test_binary -baz". También puede ser una etiqueta para un destino ejecutable. Algunos ejemplos son: 'valgrind', 'strace', 'strace -c', 'valgrind --quiet --num-callers=20', '//package:target', '//package:target --options'.
Etiquetas:action_command_lines
-
Si el valor es verdadero, las bibliotecas nativas que contienen una funcionalidad idéntica se compartirán entre diferentes destinos
Etiquetas:loading_and_analysis
,affects_outputs
- Valor predeterminado de
--[no]stamp
: “falso” -
Sella los objetos binarios con la fecha, el nombre de usuario, el nombre de host, la información del lugar de trabajo, etc.
Etiquetas:affects_outputs
- Valor predeterminado de
--strip=<always, sometimes or never>
: "A veces" -
Especifica si se quitarán los objetos binarios y las bibliotecas compartidas (mediante "-Wl,--strip-debug"). El valor predeterminado de “a veces” significa quitar el valor de iff --compilation_mode=fastbuild.
Etiquetas:affects_outputs
- Se acumulan
--stripopt=<a string>
usos múltiples -
Opciones adicionales para pasar a la eliminación cuando se genera un objeto binario “<name>.stripped”.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--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 pueden compilar objetos binarios de tvOS de Apple.
Etiquetas:loses_incremental_state
,loading_and_analysis
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: ver descripción-
Versión mínima compatible de tvOS con los simuladores y dispositivos de destino. Si no se especifica, se usa “tvos_sdk_version”.
Etiquetas:loses_incremental_state
- Se acumulan
--watchos_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para crear objetos binarios de watchOS de Apple.
Etiquetas:loses_incremental_state
,loading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: ver descripción-
Versión de watchOS mínima compatible para dispositivos y simuladores de destino. Si no se especifica, se usa “watchos_sdk_version”.
Etiquetas:loses_incremental_state
--xbinary_fdo=<a build target label>
predeterminado: ver descripción-
Usa la información de perfil de XbinaryFDO para optimizar la compilación. Especifica el nombre del perfil binario cruzado predeterminado. Cuando la opción se usa junto con --fdo_instrument/--fdo_optimize/--fdo_profile, esas opciones siempre prevalecerán como si xbinary_fdo nunca se especifique.
Etiquetas:affects_outputs
- Opciones que afectan la forma estricta en que Bazel aplica las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etc.):
--auto_cpu_environment_group=<a build target label>
predeterminado: ""- Declara el entorno para que los valores de CPU se asignen automáticamente a los valores de target_environment.
Etiquetas:changes_inputs
,loading_and_analysis
,experimental
- Valor predeterminado de
--[no]check_licenses
: “falso” -
Verifica que las restricciones de licencias que imponen los paquetes dependientes no entren en conflicto con los modos de distribución de los destinos que se están compilando. De forma predeterminada, las licencias no están verificadas.
Etiquetas:build_file_semantics
--[no]check_visibility
predeterminado: “verdadero”-
Si se inhabilita, los errores de visibilidad en las dependencias de destino descienden a advertencias.
Etiquetas:build_file_semantics
--[no]desugar_for_android
predeterminado: “verdadero”-
Determina si el código de bytes Java 8 debe expandirse de sintaxis antes de la conversión a dex.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Valor predeterminado de
--[no]desugar_java8_libs
: “falso” -
Indica si se deben incluir bibliotecas de Java 8 compatibles en apps para dispositivos heredados.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]enforce_constraints
predeterminado: “verdadero”-
Verifica los entornos compatibles con cada destino y, luego, informa los errores si algún destino tiene dependencias que no admiten los mismos entornos.
Etiquetas:build_file_semantics
- Valor predeterminado de
--[no]experimental_allow_android_library_deps_without_srcs
: “falso” -
Marca para ayudar a hacer la transición para permitir que se inhabiliten las reglas android_library de srcs-less con deps. El depósito debe limpiarse para que se implemente de forma predeterminada.
Etiquetas:eagerness_to_exit
,loading_and_analysis
--[no]experimental_check_desugar_deps
predeterminado: “verdadero”-
Determina si se debe volver a comprobar la expansión de sintaxis correcta en el nivel binario de Android.
Etiquetas:eagerness_to_exit
,loading_and_analysis
,experimental
- Valor predeterminado de
--experimental_import_deps_checking=<off, warning or error>
: "DESACTIVADO" -
Cuando está habilitada, comprueba si las dependencias de aar_import están completas. Esta aplicación puede romper la compilación o puede simplemente generar advertencias.
Etiquetas:loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
predeterminado: “predeterminado”-
Si es verdadero, comprueba que un destino de Java declare explícitamente todos los destinos usados directamente como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
- Valor predeterminado de
--[no]incompatible_check_testonly_for_output_files
: “falso” -
Si está habilitada, verifica solo los objetivos de requisitos previos que son archivos de salida mediante la búsqueda de la regla de generación de prueba. Esto coincide con la verificación de visibilidad.
Etiquetas:build_file_semantics
,incompatible_change
- Valor predeterminado de
--[no]incompatible_disable_native_android_rules
: “falso” -
Si se habilita, se inhabilita el uso directo de las reglas nativas de Android. Usa las reglas de Starlark para Android en https://github.com/bazelbuild/rules_android
Etiquetas:eagerness_to_exit
,incompatible_change
- Valor predeterminado de
--[no]incompatible_disable_native_apple_binary_rule
: “falso” -
No hay relación. Se mantiene aquí para garantizar la retrocompatibilidad.
Etiquetas:eagerness_to_exit
,incompatible_change
--[no]incompatible_force_strict_header_check_from_starlark
predeterminado: “verdadero”-
Si está habilitada, establezca una verificación de encabezados estricta en la API de Starlark
Etiquetas:loading_and_analysis
,changes_inputs
,incompatible_change
--[no]incompatible_validate_top_level_header_inclusions
predeterminado: “verdadero”-
Si es verdadero, Bazel también validará las inclusiones de encabezados de directorio de nivel superior (consulte https://github.com/bazelbuild/bazel/issues/10047 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]strict_filesets
: “falso” - Si se habilita esta opción, los conjuntos de archivos que crucen los límites del paquete se informarán como errores. No funciona cuando se inhabilita check_fileset_dependencies_recursively.
Etiquetas:build_file_semantics
,eagerness_to_exit
- Valor predeterminado de
--strict_proto_deps=<off, warn, error, strict or default>
: "Error" - A menos que esté DESACTIVADA, se verifica que un destino proto_library declare explícitamente todos los destinos usados directamente como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
--strict_public_imports=<off, warn, error, strict or default>
predeterminado: "desactivado"- A menos que esté DESACTIVADA, verifica que un destino proto_library declare explícitamente todos los destinos que se usan en "import public" como exportados.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
- Valor predeterminado de
--[no]strict_system_includes
: “falso” - 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:
- Valor predeterminado de
--apk_signing_method=<v1, v2, v1_v2 or v4>
: “v1_v2” -
Implementación para usar en la firma de APK
Etiquetas:action_command_lines
,affects_outputs
,loading_and_analysis
--[no]device_debug_entitlements
predeterminado: “verdadero”-
Si se configura y el modo de compilación no es “opt”, las apps de objc incluirán derechos de depuración al firmar.
Etiquetas:changes_inputs
--ios_signing_cert_name=<a string>
predeterminado: ver descripción-
Es el nombre del certificado que se usará para la firma de iOS. Si no se configura, se recurrirá al perfil de aprovisionamiento. Puede ser la preferencia de identidad del llavero del certificado o (substring) del nombre común del certificado, según la página de manual del 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 a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.
--[no]incompatible_disallow_legacy_py_provider
predeterminado: “verdadero”-
No-op se quitará en breve.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones que rigen el comportamiento del entorno de pruebas o del ejecutor de pruebas:
- Valor predeterminado de
--[no]allow_analysis_failures
: “falso” -
Si es verdadero, un error de análisis de un objetivo de regla da como resultado la propagación del destino de una instancia de AnalysisFailureInfo que contiene la descripción del error, en lugar de un error de compilación.
Etiquetas:loading_and_analysis
,experimental
- Valor predeterminado de
--analysis_testing_deps_limit=<an integer>
: “2,000” -
Establece la cantidad máxima de dependencias transitivas a través de un atributo de regla con una transición de configuración de for_analysis_testing. Si superas este límite, se producirá un error de la regla.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]break_build_on_parallel_dex2oat_failure
: “falso” -
Si las fallas de acción dex2oat son verdaderas, la compilación fallará en lugar de ejecutar dex2oat durante el tiempo de ejecución de la prueba.
Etiquetas:loading_and_analysis
,experimental
- Valor predeterminado de
--[no]experimental_android_use_parallel_dex2oat
: “falso” -
Usa dex2oat en paralelo para acelerar android_test.
Etiquetas:loading_and_analysis
,host_machine_resource_optimizations
,experimental
- Valor predeterminado de
--[no]ios_memleaks
: “falso” - Habilita la comprobación de fugas de memoria en objetivos de ios_test.
Etiquetas:action_command_lines
--ios_simulator_device=<a string>
predeterminado: ver descripción-
Es el dispositivo que se va a simular cuando se ejecuta una aplicación para iOS en el simulador, p.ej., “iPhone 6”. Para obtener una lista de los dispositivos, ejecute "xcrun simctl list devicetypes" en la máquina en la que se ejecutará el simulador.
Etiquetas:test_runner
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: ver descripción-
Es la versión de iOS que se ejecutará en el simulador al ejecutar o realizar pruebas. Esto se ignora para las reglas de ios_test si se especifica un dispositivo de destino en la regla.
Etiquetas:test_runner
- Se acumulan
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
usos múltiples - Especifica la cantidad de veces que se debe ejecutar cada prueba. Si alguno de esos intentos falla por cualquier motivo, la prueba completa se considera errónea. Por lo general, el valor especificado es solo un número entero. Ejemplo: --runs_per_test=3 ejecutará todas las pruebas 3 veces. Sintaxis alternativa: regex_filter@runs_per_test. En el que se ejecuta run_per_test, un valor entero y regex_filter representa una lista de patrones de expresión incluidos y excluidos. También consulta --instrumentation_filter. Ejemplo: --runs_per_test=//foo/.*,-//foo/bar/.*@3 ejecuta todas las pruebas en //foo/ excepto las de foo/bar tres veces. Esta opción se puede pasar varias veces. El argumento pasado más reciente que coincide tiene prioridad. Si no hay coincidencias, la prueba solo se ejecuta una vez.
- Se acumulan
--test_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica las 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 se leerá su valor desde el entorno de cliente de Bazel o por el par nombre=valor. Esta opción se puede utilizar varias veces para especificar varias variables. Solo se usa en el comando “bazel test”.
Etiquetas:test_runner
--test_timeout=<a single integer or comma-separated list of 4 integers>
predeterminado: "-1"- Anula los valores de tiempo de espera de prueba predeterminados para los tiempos de espera de prueba (en segundos). Si se especifica un solo número entero positivo, se anularán todas las categorías. Si se especifican 4 números enteros separados por comas, anularán los tiempos de espera para valores cortos, moderados, largos y eternos (en ese orden). En cualquier forma, un valor de -1 le indica a blaze que use los tiempos de espera predeterminados para esa categoría.
--tvos_simulator_device=<a string>
predeterminado: ver descripción-
Es el dispositivo que se simulará cuando se ejecute una aplicación tvOS en el simulador, p.ej., “Apple TV 1080p”. Para obtener una lista de los dispositivos, ejecute "xcrun simctl list devicetypes" en la máquina en la que se ejecutará el simulador.
Etiquetas:test_runner
--tvos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: ver descripción-
Es la versión de tvOS que se ejecutará en el simulador cuando se ejecute o se realice una prueba.
Etiquetas:test_runner
--watchos_simulator_device=<a string>
predeterminado: ver descripción-
Es el dispositivo que se debe simular cuando se ejecuta una aplicación watchOS en el simulador, p.ej., “Apple Watch - 38 mm”. Para obtener una lista de los dispositivos, ejecute "xcrun simctl list devicetypes" en la máquina en la que se ejecutará el simulador.
Etiquetas:test_runner
--watchos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: ver descripción-
Es la versión de watchOS que se ejecuta en el simulador cuando se ejecuta o se realiza una prueba.
Etiquetas:test_runner
--[no]zip_undeclared_test_outputs
predeterminado: “verdadero”-
Si es verdadero, los resultados de las pruebas no declaradas se archivarán en un archivo ZIP.
Etiquetas:test_runner
- Opciones relacionadas con el resultado de la consulta y la semántica:
- Valor predeterminado de
--aspect_deps=<off, conservative or precise>
: “conservadora” - Cómo resolver dependencias de aspecto cuando el formato de salida es {xml,proto,record}. "Apagado" significa que no se resuelven dependencias de aspecto, "conservadora" (predeterminada) significa que se agregan todas las dependencias de aspecto declaradas, independientemente de si se le otorga la clase de regla de dependencias directas. "Precisa" significa que solo se agregan esos aspectos que posiblemente estén activos según la clase de regla de las dependencias directas. Ten en cuenta que el modo preciso requiere que se carguen otros paquetes para evaluar un único destino, lo que lo hace más lento que los otros modos. También ten en cuenta que el modo incluso 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 'consulta de Bazel'.
Etiquetas:build_file_semantics
--[no]graph:factored
predeterminado: “verdadero”-
Si es verdadero, el grafo se emitirá como “factorizado”, es decir, los nodos con una equivalencia topológica equivalente se combinarán y sus etiquetas se concatenarán. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
- Valor predeterminado de
--graph:node_limit=<an integer>
: “512” - La longitud máxima de la string de la etiqueta para un nodo del grafo en el resultado. Las etiquetas más largas se truncarán. Si el valor es -1, no se truncará. Esta opción solo se aplica a --output=graph.
Etiquetas:terminal_output
--[no]implicit_deps
predeterminado: “verdadero”- Si se habilita esta opción, se incluirán las dependencias implícitas en el gráfico de dependencias sobre el que opera la consulta. Una dependencia implícita no se especifica de forma explícita en el archivo BUILD, pero se agrega mediante Bazel. Para cquery, esta opción controla el filtrado de las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
--[no]include_aspects
predeterminado: “verdadero”-
query, cquery: si se deben incluir acciones generadas por aspectos en el resultado. query: no-op (los aspectos siempre se siguen).
Etiquetas:terminal_output
--[no]incompatible_display_source_file_location
predeterminado: “verdadero”- Verdadero y predeterminado, 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
--[no]incompatible_package_group_includes_double_slash
predeterminado: “verdadero”-
Si se habilita, no se omitirá el "//" inicial del resultado del atributo `packages` del paquete package_group.
Etiquetas:terminal_output
,incompatible_change
- Valor predeterminado de
--[no]infer_universe_scope
: “falso” - Si no se configura y --universe_scope, se deducirá un valor de --universe_scope como la lista de patrones de destino únicos en la expresión de consulta. Ten en cuenta que el valor --universe_scope inferido para una expresión de consulta que usa funciones con alcance universal (p.ej., "allrdeps") puede no ser lo que deseas, por lo que debes usar esta opción solo si sabes lo que estás haciendo. Consulta https://bazel.build/query/language#sky-query para conocer los detalles y ejemplos. Si --universe_scope se establece, se ignora el valor de esta opción. Nota: Esta opción solo se aplica a `query` (es decir, no `cquery`).
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]line_terminator_null
: “falso” -
Indica si cada formato termina con \0 en lugar de saltos de línea.
Etiquetas:terminal_output
--[no]nodep_deps
predeterminado: “verdadero”- Si está habilitada, las dependencias de los atributos “nodep” se incluirán en el gráfico de dependencia sobre el que opera la consulta. Un ejemplo común de atributo “nodep” es la “visibilidad”. Ejecuta y analiza el resultado de "info build-language" para conocer todos los atributos "nodep" del lenguaje de compilación.
Etiquetas:build_file_semantics
--output=<a string>
predeterminado: “etiqueta”-
Es el formato en el que se deben imprimir los resultados de la consulta. Los valores permitidos para cquery son: label, label_kind, textproto, transiciones, proto, jsonproto. Si seleccionas "transiciones", también deberás especificar la opción --transitions=(lite|full).
Etiquetas:terminal_output
--[no]proto:default_values
predeterminado: “verdadero”-
Si es verdadero, se incluyen los atributos cuyo valor no se especifica de forma explícita en el archivo BUILD. De lo contrario, se omiten. Esta opción se aplica a --output=proto
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:definition_stack
: “falso” -
Propaga el campo de protocolo de definiciones_stack, que registra cada instancia de las reglas, la pila de llamadas de Starlark en el momento en que se definió la clase de la regla.
Etiquetas:terminal_output
--[no]proto:flatten_selects
predeterminado: “verdadero”-
Si están habilitados, los atributos configurables creados por select() se acoplan. Para los tipos de lista, la representación plana es una lista que contiene cada valor del mapa seleccionado exactamente una vez. Los tipos de escalar se aplanan en un valor nulo.
Etiquetas:build_file_semantics
--[no]proto:include_configurations
predeterminado: “verdadero”- , si está habilitado, el resultado del protocolo incluirá información sobre las configuraciones. Cuando está inhabilitado,el formato de salida de protocolo de consulta se parece al formato de salida de consulta.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]proto:include_synthetic_attribute_hash
: “falso” -
Indica si se debe calcular y propagar el atributo $internal_attr_hash.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:instantiation_stack
: “falso” -
Propaga la pila de llamadas de creación de instancias de cada regla. Ten en cuenta que esto requiere que la pila esté presente.
Etiquetas:terminal_output
--[no]proto:locations
predeterminado: “verdadero”-
Indica si se debe generar información de ubicación en el resultado del protocolo.
Etiquetas:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
predeterminado: "todos"-
Lista de atributos separados por comas que se incluirán en el resultado. La configuración predeterminada es todos los atributos. Configúralo como una string vacía para no generar ningún atributo. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
--[no]proto:rule_inputs_and_outputs
predeterminado: “verdadero”-
Indica si se deben propagar o no los campos rule_input y rule_output.
Etiquetas:terminal_output
--query_file=<a string>
predeterminado: ""- Si se establece, la consulta leerá la consulta del archivo nombrado aquí, en lugar de hacerlo en la línea de comandos. Es un error especificar aquí un archivo, así como una consulta de línea de comandos.
Etiquetas:changes_inputs
- Valor predeterminado de
--[no]relative_locations
: “falso” -
Si es verdadero, la ubicación de los archivos BUILD en los resultados XML y proto será relativa. De forma predeterminada, el resultado de ubicación es una ruta absoluta y no será coherente entre las máquinas. Puedes establecer esta opción como verdadera para obtener un resultado coherente en todas las máquinas.
Etiquetas:terminal_output
--show_config_fragments=<off, direct or transitive>
predeterminado: "desactivado"-
Muestra los fragmentos de configuración que requieren 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 objetivo configurado en el modo --output=starlark de cquery. El destino configurado está vinculado a “target”. Si no se especifica --starlark:expr ni --starlark:file, esta opción se configurará de forma predeterminada como "str(target.label)". Es un error especificar tanto --starlark:expr como --starlark:file.
Etiquetas:terminal_output
--starlark:file=<a string>
predeterminado: ""-
El nombre de un archivo que define una función de Starlark, denominada "format", de un argumento, que se aplica a cada destino configurado para darle el formato de string. Es un error especificar tanto --starlark:expr como --starlark:file. Para obtener más detalles, consulta la ayuda de --output=starlark.
Etiquetas:terminal_output
--[no]tool_deps
predeterminado: “verdadero”- Consulta: Si está inhabilitada, las dependencias de los objetivos de “configuración del host” o “ejecución” no se incluirán en el gráfico de dependencias sobre el que opera la consulta. Una arista de dependencia de “configuración de host”, como la de cualquier regla de “proto_library” al compilador de protocolo, suele apuntar a una herramienta ejecutada durante la compilación en lugar de ser parte del mismo programa de “destino”.
Consulta: Si se inhabilita, se filtran 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 en la configuración de destino. Si el destino de nivel superior está en la configuración del host, solo se mostrarán los objetivos configurados por el host. Esta opción NO excluirá los conjuntos de herramientas resueltos.
Etiquetas:build_file_semantics
--transitions=<full, lite or none>
predeterminado: "ninguno".- 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 destino separados por comas (aditivos y sustractivos). La consulta se puede realizar en el universo definido por el cierre transitivo de los destinos especificados. Esta opción se usa para los comandos query y cquery.
Para cquery, la entrada a esta opción es el destino en el que se compilan todas las respuestas, por lo que esta opción puede afectar la configuración y las transiciones. Si no se especifica esta opción, se supone que los objetivos de nivel superior son los objetivos analizados desde la expresión de consulta. Nota: En el caso de cquery, si no se especifica esta opción, la compilación puede fallar si los objetivos analizados de la expresión de consulta no se pueden compilar con opciones de nivel superior.
Etiquetas:loading_and_analysis
- Opciones que activan optimizaciones del tiempo de compilación:
--[no]collapse_duplicate_defines
predeterminado: “verdadero”-
Cuando se habilita, la opción redundante --defines se quita al comienzo 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
- Valor predeterminado de
--[no]experimental_filter_library_jar_with_program_jar
: “falso” -
Filtra el ProgramPro de ProGuard para quitar cualquier clase que también esté presente en LibraryJar.
Etiquetas:action_command_lines
--[no]experimental_inmemory_dotd_files
predeterminado: “verdadero”- Si se habilita esta opción, los archivos C .D se pasarán a la memoria directamente desde los nodos de compilación remota, en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_inmemory_jdeps_files
predeterminado: “verdadero”-
Si se habilita, los archivos de dependencia (.jdeps) generados a partir de compilaciones de Java se pasarán a través de la memoria directamente desde los nodos de compilación remota, en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
,experimental
- Valor predeterminado de
--[no]experimental_objc_include_scanning
: “falso” -
Determina si se debe realizar una búsqueda para C/C++ objetivo.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
- Valor predeterminado de
--[no]experimental_parse_headers_skipped_if_corresponding_srcs_found
: “falso” -
Si está habilitada, la función parse_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
- Valor predeterminado de
--[no]experimental_retain_test_configuration_across_testonly
: “falso” -
Cuando se habilita, --trim_test_configuration no recortará la configuración de prueba de las reglas marcadas como testonly=1. Esto tiene como objetivo reducir los problemas de conflicto de acciones cuando las reglas que no son de prueba dependen de las reglas de cc_test. No tiene efecto si --trim_test_configuration es falsa.
Etiquetas:loading_and_analysis
,loses_incremental_state
- Valor predeterminado de
--[no]experimental_starlark_cc_import
: “falso” -
Si está habilitada, se puede usar la versión Starlark de cc_import.
Etiquetas:loading_and_analysis
,experimental
- Valor predeterminado de
--[no]experimental_unsupported_and_brittle_include_scanning
: “falso” -
Determina si se deben limitar las entradas a la compilación de C/C++ mediante el análisis de #include las líneas de los archivos de entrada. Esto puede mejorar el rendimiento y la incrementalidad, ya que disminuye el tamaño de los árboles de entrada de compilación. Sin embargo, también puede romper compilaciones porque el escáner de inclusión no implementa completamente la semántica del preprocesador de C. En particular, no comprende las directivas dinámicas de #include e ignora la lógica condicional del preprocesador. Úsalos bajo tu responsabilidad. Se cerrarán todos los problemas relacionados con esta marca que se presenten.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
--[no]incremental_dexing
predeterminado: “verdadero”-
Realiza la mayor parte del trabajo en la conversión a archivos dex por separado para cada archivo jar.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]objc_use_dotd_pruning
predeterminado: “verdadero”- Si se configura, los archivos .d emitidos por clang se usarán para reducir el conjunto de entradas que se pasan a las compilaciones objc.
Etiquetas:changes_inputs
,loading_and_analysis
- Valor predeterminado de
--[no]process_headers_in_dependencies
: “falso” -
Cuando se compila un destino //a:a, se deben procesar los encabezados en todos los destinos del que depende //a:a (si el procesamiento de encabezados está habilitado para la cadena de herramientas).
Etiquetas:execution
--[no]trim_test_configuration
predeterminado: “verdadero”-
Cuando se habilita, las opciones relacionadas con la prueba se borran debajo del nivel superior de la compilación. Cuando esta marca está activa, las pruebas no se pueden compilar como dependencias de reglas que no son de prueba, pero los cambios en las opciones relacionadas con la prueba no harán que se vuelvan a analizar las reglas que no son de prueba.
Etiquetas:loading_and_analysis
,loses_incremental_state
--[no]use_singlejar_apkbuilder
predeterminado: “verdadero”- Esta opción es obsoleta. Ahora es no-op y se quitará pronto.
Etiquetas:loading_and_analysis
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Valor predeterminado de
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "-.*" -
Imprime información de depuración durante la resolución de la cadena de herramientas. La marca toma una regex, que se verifica con los tipos de la cadena de herramientas y objetivos específicos para ver cuál depurar. Si hay varias regex, estas pueden separarse con comas y, luego, cada una se revisa por separado. Nota: El resultado de esta marca es muy complejo y es probable que solo sea útil para los expertos en la resolución de la cadena de herramientas.
Etiquetas:terminal_output
- Opciones para especificar o alterar una entrada genérica en un comando de Bazel que no se encuentre en otras categorías:
- Se acumulan
--flag_alias=<a 'name=value' flag alias>
usos múltiples -
Establece un nombre abreviado para las marcas de Starlark. Toma un solo par clave-valor con el formato "<key>=<value>" como argumento.
Etiquetas:changes_inputs
- Valor predeterminado de
--[no]incompatible_default_to_explicit_init_py
: “falso” -
Esta marca cambia el comportamiento predeterminado para que los archivos __init__.py ya no se creen automáticamente en los runfiles de los objetivos de Python. Precisamente, cuando un destino py_binary o py_test tiene la configuración heredada_create_init establecida en "automático" (la opción predeterminada), se considera falsa si solo se establece esta marca. Consulta https://github.com/bazelbuild/bazel/issues/10076.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_py2_outputs_are_suffixed
predeterminado: “verdadero”-
Si es verdadero, los destinos compilados en la configuración de Python 2 aparecerán en una raíz de salida que incluya el sufijo “-py2”, mientras que los objetivos 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 objetivos de Python 3 en lugar de a Python 2. Si habilitas esta opción, también se recomienda habilitar `--incompatible_py3_is_default`.
Etiquetas:affects_outputs
,incompatible_change
--[no]incompatible_py3_is_default
predeterminado: “verdadero”-
Si es verdadero, los objetivos “py_binary” y “py_test” que no definen el atributo “python_version” (o “default_python_version”) se establecerán de forma predeterminada como PY3 en lugar de PY2. Si configuras esta marca, también se recomienda establecer `--incompatible_py2_outputs_are_suffixed`.
Etiquetas:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_use_python_toolchains
predeterminado: “verdadero”-
Si se configura como verdadera, las reglas nativas ejecutables de Python usarán el entorno de ejecución de Python especificado en la cadena de herramientas de Python, en lugar del entorno de ejecución proporcionado por marcas heredadas como --python_top.
Etiquetas:loading_and_analysis
,incompatible_change
--python_version=<PY2 or PY3>
predeterminado: ver descripción-
Es el modo de la versión principal de Python, ya sea "PY2" o "PY3". Ten en cuenta que los destinos "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
- Otras opciones, sin otra categoría:
--[no]cache_test_results
[-t
] predeterminado: "auto"- Si se configura como “automática”, Bazel vuelve a ejecutar una prueba solo si: (1) Bazel detecta cambios en la prueba o sus dependencias, (2) la prueba se marcó como externa, (3) se solicitaron varias ejecuciones con --runs_per_test o(4) la prueba falló anteriormente. Si se configura como “sí”, Bazel almacena en caché todos los resultados, excepto las pruebas marcadas como externas. Si se configura como “no”, Bazel no almacena en caché ningún resultado de prueba.
- Valor predeterminado de
--[no]experimental_cancel_concurrent_tests
: “falso” -
Si es verdadero, Blaze cancelará las pruebas que se estén ejecutando de forma simultánea en la primera ejecución correcta. Esto solo es útil en combinación con --runs_per_test_detects_flakes.
Etiquetas:affects_outputs
,loading_and_analysis
- Valor predeterminado de
--[no]experimental_fetch_all_coverage_outputs
: “falso” -
Si es verdadero, Bazel recupera todo el directorio de datos de cobertura de cada prueba durante una ejecución de cobertura.
Etiquetas:affects_outputs
,loading_and_analysis
- Valor predeterminado de
--[no]experimental_generate_llvm_lcov
: “falso” -
Si es verdadero, la cobertura de jerga generará un informe de LCOV.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]experimental_j2objc_header_map
predeterminado: “verdadero”- Indica si se debe generar el mapa de encabezado de J2ObjC en paralelo a la transpilación de J2ObjC.
- Valor predeterminado de
--[no]experimental_j2objc_shorter_header_path
: “falso” -
Se debe generar con una ruta de encabezado más corta (usa "_ios" en lugar de "_j2objc").
Etiquetas:affects_outputs
- Valor predeterminado de
--experimental_java_classpath=<off, javabuilder or bazel>
: “javabuilder”. - Habilita rutas de clase reducidas para las compilaciones de Java.
- Valor predeterminado de
--[no]experimental_limit_android_lint_to_android_constrained_java
: “falso” -
Limita --experimental_run_android_lint_on_java_rules a las bibliotecas compatibles con Android.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]experimental_run_android_lint_on_java_rules
: “falso” - Determina si se deben validar las fuentes java_*.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]explicit_java_test_deps
: “falso” - Especifica explícitamente una dependencia a JUnit o Hamcrest en una java_test, en lugar de obtenerla accidentalmente de las dependencias de TestRunner. En este momento, solo funciona para bazel.
--host_java_launcher=<a build target label>
predeterminado: ver descripción- El selector de Java que usan las herramientas que se ejecutan durante una compilación.
- Se acumulan
--host_javacopt=<a string>
usos múltiples - Opciones adicionales para pasar a javac cuando se compilan herramientas que se ejecutan durante una compilación
- Se acumulan
--host_jvmopt=<a string>
usos múltiples - Opciones adicionales para pasar a la VM de Java cuando se compilan herramientas que se ejecutan durante la compilación. Estas opciones se agregarán a las opciones de inicio de VM de cada destino java_binary.
--[no]incompatible_exclusive_test_sandboxed
predeterminado: “verdadero”-
Si es verdadero, se ejecutarán pruebas exclusivas con una estrategia de zona de pruebas. Agrega la etiqueta “local” para forzar una ejecución de prueba exclusiva a nivel local
Etiquetas:incompatible_change
- Valor predeterminado de
--[no]incompatible_strict_action_env
: “falso” -
Si es verdadero, Bazel usa un entorno con un valor estático para PATH y no hereda LD_LIBRARY_PATH. Use --action_env=ENV_VARIABLE si desea heredar variables de entorno específicas del cliente, pero tenga en cuenta que, si lo hace, puede evitar el almacenamiento en caché entre usuarios si se utiliza 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. Implica -test_output=stream.
Se expande a:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
--[no]java_deps
predeterminado: “verdadero”- Genera información de dependencia (por ahora, ruta de clase de tiempo de compilación) por destino de Java.
--[no]java_header_compilation
predeterminado: “verdadero”- Compila los archivos JAR directamente desde la fuente.
--java_language_version=<a string>
predeterminado: ""- Versión de Java
--java_launcher=<a build target label>
predeterminado: ver descripción- El selector de Java que se usará para compilar objetos binarios de Java. Si esta marca se establece en la string vacía, se usa el iniciador de JDK. El atributo "launcher" anula esta marca.
- Valor predeterminado de
--java_runtime_version=<a string>
: “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 VM de cada destino java_binary.
--legacy_main_dex_list_generator=<a build target label>
predeterminado: ver descripción- Especifica un objeto binario para usar a fin de generar la lista de clases que deben estar en el DEX principal cuando se compila el multidex heredado.
- Se acumulan
--plugin=<a build target label>
usos múltiples - Complementos para usar en la compilación. Actualmente funciona con java_plugin.
--proguard_top=<a build target label>
predeterminado: ver descripción- Especifica qué versión de ProGuard usar para la eliminación de código cuando se compila un objeto binario de Java.
--proto_compiler=<a build target label>
predeterminado: “@bazel_tools//tools/proto:protoc”-
Es la etiqueta del proto-compilador.
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 los protocolos 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 los protocolos j2objc
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
predeterminado: “@bazel_tools//tools/proto:java_toolchain”-
Etiqueta de proto_lang_toolchain() que describe cómo compilar los protocolos de Java
Etiquetas:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
predeterminado: “@bazel_tools//tools/proto:javalite_toolchain”-
Etiqueta de proto_lang_toolchain() que describe cómo compilar los protocolos de JavaLite
Etiquetas:affects_outputs
,loading_and_analysis
- Se acumulan
--protocopt=<a string>
usos múltiples -
Opciones adicionales para pasar al compilador protobuf.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]runs_per_test_detects_flakes
: “falso” - Si es verdadero, cualquier fragmento en el que pase al menos un intento de ejecución o intento y al menos uno de ellos falle y obtenga el estado FLAKY.
--shell_executable=<a path>
predeterminado: ver descripción-
Ruta de acceso absoluta al ejecutable de shell que puede usar Bazel. Si no está configurado, pero la variable de entorno BAZEL_SH se configura en la primera invocación de Bazel (que inicia un servidor de Bazel), Bazel la usa. Si no se configura ninguna de esas opciones, Bazel usa una ruta de acceso predeterminada codificada según el sistema operativo en el que se ejecute (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash: todos los demás: /bin/bash). Ten en cuenta que usar una shell que no sea compatible con Bash puede generar fallas de compilación o de tiempo de ejecución de los objetos binarios generados.
Etiquetas:loading_and_analysis
- Se acumulan
--test_arg=<a string>
usos múltiples - Especifica las opciones y los 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 se usa en el comando “bazel test”.
--test_filter=<a string>
predeterminado: ver descripción- Especifica un filtro para reenviar al framework de prueba. Se usa para limitar la ejecución de las pruebas. Ten en cuenta que esto no afecta a los destinos que se crean.
--test_result_expiration=<an integer>
predeterminado: "-1"- Esta opción es obsoleta y no tiene efecto.
- Valor predeterminado de
--[no]test_runner_fail_fast
: “falso” - La opción de reenvío falla rápidamente al ejecutor de pruebas. El ejecutor de prueba debe detener la ejecución en la primera falla.
- Valor predeterminado de
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>
: "explícito" - Especifica una estrategia de fragmentación de pruebas: “explícita” para usar la fragmentación solo si el atributo “shard_count” está presente. 'disabled' para inhabilitar la fragmentación de pruebas. "forced=k" impone los fragmentos "k" para pruebas, independientemente del atributo "shard_count" BUILD.
--tool_java_language_version=<a string>
predeterminado: ""- La versión en lenguaje Java que se usa para ejecutar las herramientas necesarias durante una compilación
--tool_java_runtime_version=<a string>
predeterminado: "remotejdk_11"- La versión del entorno de ejecución de Java que se usa para ejecutar herramientas durante la compilación
--[no]use_ijars
predeterminado: “verdadero”- Si se habilita, esta opción hace que la compilación de Java use archivos jar de la interfaz. De esta manera, la compilación incremental será 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 -
Puedes buscar archivos adicionales antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]experimental_repository_cache_hardlinks
: “falso” -
Si se configura, la caché del repositorio vinculará el archivo en caso de un acierto de caché, en lugar de copiarlo. Esto está destinado a ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]experimental_repository_cache_urls_as_default_canonical_id
: “falso” -
Si es verdadero, usa una string derivada de las URL de las descargas del repositorio como el canonical_id si no se especifica. Esto hace que un cambio en las URL provoque una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no generen la máscara de caché de los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
- Valor predeterminado de
--[no]experimental_repository_disable_download
: “falso” - 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 configura en 0, los reintentos están inhabilitados.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark según este factor. De esta manera, los repositorios externos pueden funcionar en máquinas que son más lentas de lo que espera el autor de la regla, sin cambiar el código fuente
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas HTTP mediante el factor determinado
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: ver descripción-
Especifica la ubicación de la 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:
- Valor predeterminado de
--[no]action_cache
: “falso” -
Vaciar contenido de caché de acciones.
Etiquetas:bazel_monitoring
- Valor predeterminado de
--[no]packages
: “falso” - Vaciar el contenido de la caché del paquete.
Etiquetas:bazel_monitoring
- Valor predeterminado de
--[no]rule_classes
: “falso” - . Clases de reglas de volcado.
Etiquetas:bazel_monitoring
- Valor predeterminado de
--[no]rules
: “falso” -
Reglas de volcado, incluidos los recuentos y el uso de memoria (si se realiza un seguimiento de la memoria)
Etiquetas:bazel_monitoring
--skyframe=<off, summary, count, deps or rdeps>
predeterminado: "desactivado"-
Gráfico de volcado de Skyframe: “apagado”, “resumen”, “recuento”, “deps” o “rdeps”.
Etiquetas:bazel_monitoring
--skykey_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
predeterminado: ".*"- : Filtro Regex de nombres de SkyKey que se mostrarán. Solo se usa con --skyframe=deps, rdeps.
Etiquetas:bazel_monitoring
--skylark_memory=<a string>
predeterminado: 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 forma estricta en que Bazel aplica las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etc.):
--experimental_repository_hash_file=<a string>
predeterminado: ""-
Si el campo no está vacío, especifica un archivo que contiene un valor resuelto, en el que se deben verificar los hash del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan
--experimental_verify_repository_rules=<a string>
usos múltiples - Si la lista de reglas del repositorio para la que se debe verificar el hash del directorio de salida, siempre que --experimental_repository_hash_file proporcione un archivo
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o de la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: “verdadero”-
No-op
Etiquetas:no_op
,deprecated
,experimental
- Opciones relacionadas con los resultados y la semántica de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Se especificaron las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran en un registro del origen del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones con bloqueos harán que falle la resolución. También puedes definir una versión ya permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puede inhabilitar esta comprobación con la palabra clave "todo" (no se recomienda).
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
: "Error" -
Comprueba la compatibilidad de los módulos de Bazel con la versión 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 detecta una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "warning"-
Comprueba si las dependencias directas de "bazel_dep" declaradas en el módulo raíz son las mismas que se muestran en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la comprobación, "warning" para mostrar una advertencia cuando se detecta una discrepancia o "error" para escalarla a una falla de resolución.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]ignore_dev_dependency
: “falso” -
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declaradas como "dev_dependency" en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev se ignoran siempre en MODULE.bazel si no es el módulo raíz independientemente del valor de esta marca.
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 un directorio local.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en registros anteriores y solo volverán a los registros posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Valor predeterminado de
--[no]experimental_record_metrics_for_all_mnemonics
: “falso” - De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 nombres con la mayor cantidad de acciones ejecutadas. Si se establece esta opción, se escribirán estadísticas para todos los mnemónicos.
- Opciones para especificar o alterar una entrada genérica en un comando de Bazel que no se encuentre en otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si el archivo resuelto 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é remotas:
--experimental_downloader_config=<a string>
predeterminado: ver descripción- Especifica un archivo para configurar la descarga remota. Este archivo consta de líneas y cada una comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para coincidir y uno para usar como URL sustituta. Las referencias inversas comienzan desde "$1". Es posible que se muestren varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias.
- Varias opciones, sin otra categoría
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con un directorio local.
Opciones de recuperación
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Puedes buscar archivos adicionales antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]experimental_repository_cache_hardlinks
: “falso” -
Si se configura, la caché del repositorio vinculará el archivo en caso de un acierto de caché, en lugar de copiarlo. Esto está destinado a ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]experimental_repository_cache_urls_as_default_canonical_id
: “falso” -
Si es verdadero, usa una string derivada de las URL de las descargas del repositorio como el canonical_id si no se especifica. Esto hace que un cambio en las URL provoque una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no generen la máscara de caché de los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
- Valor predeterminado de
--[no]experimental_repository_disable_download
: “falso” - 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 configura en 0, los reintentos están inhabilitados.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark según este factor. De esta manera, los repositorios externos pueden funcionar en máquinas que son más lentas de lo que espera el autor de la regla, sin cambiar el código fuente
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas HTTP mediante el factor determinado
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: ver descripción-
Especifica la ubicación de la 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 para controlar la ejecución de la compilación:
--[no]incompatible_remote_dangling_symlinks
predeterminado: “verdadero”-
Si se establece como verdadero y --incompatible_remote_symlinks también es verdadero, se permite que los symlinks en los resultados de acción se caigan.
Etiquetas:execution
,incompatible_change
--[no]incompatible_remote_symlinks
predeterminado: “verdadero”-
Si se configura como verdadero, Bazel representará symlinks en resultados de acciones en el protocolo de almacenamiento en caché remoto/ejecución. De lo contrario, los symlinks se seguirán y se representarán como archivos o directorios. Consulta #6631 para obtener más detalles.
Etiquetas:execution
,incompatible_change
--[no]keep_going
[-k
] predeterminado: "false"- Continúa después de un error. Si bien el objetivo con errores y los que dependen de él no se pueden analizar, otros requisitos previos pueden serlo.
Etiquetas:eagerness_to_exit
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
predeterminado: "automático"-
Cantidad de subprocesos paralelos que se usarán en la fase de carga o análisis. Toma un número entero o una palabra clave ("automático", "HOST_CPUS", "HOST_RAM"), opcionalmente seguido de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". "auto" establece un valor predeterminado razonable en función de los recursos del host. Debe ser 1 como mínimo.
Etiquetas:bazel_internal_configuration
- Opciones que permiten que el usuario configure el resultado deseado, lo que afecta su valor, en lugar de su existencia:
--bep_maximum_open_remote_upload_files=<an integer>
predeterminado: "-1"-
Cantidad máxima de archivos abiertos que se permiten durante la carga de artefactos 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
--remote_download_outputs=<all, minimal or toplevel>
predeterminado: "todos"-
Si se configura como “minimal”, no se descargan los resultados de la compilación remota en la máquina local, excepto los que requieren las acciones locales. Si se configura como “nivel superior”, se comporta como “minimal”, excepto que también descarga resultados de objetivos de nivel superior en la máquina local. Ambas opciones pueden reducir significativamente los tiempos de compilación si el ancho de banda de la red representa un cuello de botella.
Etiquetas:affects_outputs
--remote_download_symlink_template=<a string>
predeterminado: ""-
En lugar de descargar resultados de la compilación remota en la máquina local, cree vínculos simbólicos. El destino de los vínculos simbólicos se puede especificar en la forma de una string de plantilla. Esta string de plantilla puede contener {hash} y {size_bytes} que se expanden al hash del objeto y al tamaño en bytes, respectivamente. Estos vínculos simbólicos pueden, por ejemplo, apuntar a un sistema de archivos FUSE que carga objetos desde el CAS a pedido.
Etiquetas:affects_outputs
--remote_download_toplevel
-
Solo descarga los resultados remotos de los objetivos 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 la forma estricta en que Bazel aplica las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etc.):
--experimental_repository_hash_file=<a string>
predeterminado: ""-
Si el campo no está vacío, especifica un archivo que contiene un valor resuelto, en el que se deben verificar los hash del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan
--experimental_verify_repository_rules=<a string>
usos múltiples - Si la lista de reglas del repositorio para la que se debe verificar el hash del directorio de salida, siempre que --experimental_repository_hash_file proporcione un archivo
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o de la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: “verdadero”-
No-ops
Etiquetas:no_op
,deprecated
,experimental
- Valor predeterminado de
--[no]incompatible_config_setting_private_default_visibility
: “falso” -
Si este valor es incompatible. De lo contrario, si esta marca es falsa, cualquier configuración de configuración sin un atributo de visibilidad explícito es //visibility:public. Si esta marca es verdadera, config_setting sigue la misma lógica de visibilidad que todas las demás reglas. Consulta https://github.com/bazelbuild/bazel/issues/12933.
Etiquetas:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
predeterminado: “verdadero”-
Si es verdadero, aplique restricciones de visibilidad de config_setting. Si es falso, todos los archivos config_setting son visibles para todos los destinos. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones relacionadas con la salida y la semántica de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Se especificaron las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran en un registro del origen del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones con bloqueos harán que falle la resolución. También puedes definir una versión ya permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puede inhabilitar esta comprobación con la palabra clave "todo" (no se recomienda).
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
: "Error" -
Comprueba la compatibilidad de los módulos de Bazel con la versión 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 detecta una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "warning"-
Comprueba si las dependencias directas de "bazel_dep" declaradas en el módulo raíz son las mismas que se muestran en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la comprobación, "warning" para mostrar una advertencia cuando se detecta una discrepancia o "error" para escalarla a una falla de resolución.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]ignore_dev_dependency
: “falso” -
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declaradas como "dev_dependency" en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev se ignoran siempre en MODULE.bazel si no es el módulo raíz independientemente del valor de esta marca.
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 un directorio local.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en registros anteriores y solo volverán a los registros posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Valor predeterminado de
--[no]experimental_record_metrics_for_all_mnemonics
: “falso” - De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 nombres con la mayor cantidad de acciones ejecutadas. Si se establece esta opción, se escribirán estadísticas para todos los mnemónicos.
--experimental_repository_resolved_file=<a string>
predeterminado: ""-
Si no está vacío, escriba un valor de Starlark con la información resuelta de todas las reglas del repositorio de Starlark que se ejecutaron.
Etiquetas:affects_outputs
- Valor predeterminado de
--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 fallas, "success" para imprimir solo cuando se realiza correctamente y "all" para imprimir siempre.
Etiquetas:terminal_output
- Opciones para especificar o alterar una entrada genérica en un comando de Bazel que no se encuentre en otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si el archivo resuelto 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é remotas:
--experimental_downloader_config=<a string>
predeterminado: ver descripción- Especifica un archivo para configurar la descarga remota. Este archivo consta de líneas y cada una comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para coincidir y uno para usar como URL sustituta. Las referencias inversas comienzan desde "$1". Es posible que se muestren varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias.
- Valor predeterminado de
--[no]experimental_guard_against_concurrent_changes
: “falso” - Desactiva esta opción para inhabilitar la opción de comprobación de tiempo de los archivos de entrada de una acción antes de subirla a una caché remota. Puede haber casos en los que el kernel de Linux retrase la escritura de archivos, lo que podría causar falsos positivos.
--experimental_remote_build_event_upload=<all or minimal>
predeterminado: "todos"- Si se configura como “todos”, todos los resultados locales a los que hace referencia el BEP se suben a la caché remota. Si se configura como "minimal", los resultados locales a los que hace referencia BEP no se suben a la caché remota, excepto los archivos que son importantes para los consumidores de BEP (p.ej., registros de prueba y perfil de sincronización). El esquema file:// se usa para las rutas de archivos locales y el esquema bytestream:// se usa para las rutas de archivos (ya subidos). La configuración predeterminada es "Todas".
- Valor predeterminado de
--[no]experimental_remote_cache_async
: “falso” - Si es verdadero, la E/S de la caché remota sucederá en segundo plano, en lugar de realizarse como parte de un generación.
- Valor predeterminado de
--[no]experimental_remote_cache_compression
: “falso” - Si está habilitada, comprime o descomprime los BLOB de caché con zstd.
--experimental_remote_capture_corrupted_outputs=<a path>
predeterminado: ver descripción- Es una ruta de acceso a un directorio en el que se capturarán los resultados dañados.
--experimental_remote_downloader=<a string>
predeterminado: ver descripción- Un URI de extremo de la API de Remote Asset que se usará como proxy de descarga remota. Los esquemas admitidos son grpc, grpcs (grpc with TLS enabled) y unix (local UNIX sockets). 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
- Valor predeterminado de
--[no]experimental_remote_downloader_local_fallback
: “falso” - Indica si se debe volver a la herramienta de descarga local si falla la descarga remota.
- Valor predeterminado de
--[no]experimental_remote_execution_keepalive
: “falso” - Determina si se debe usar keepalive para las llamadas de ejecución remota.
--experimental_remote_grpc_log=<a path>
predeterminado: ver descripción- Si se especifica, una ruta de acceso a un archivo para registrar los detalles relacionados con las llamadas de gRPC. Este registro consta de una secuencia de protobufs serializados com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry con cada mensaje con el prefijo de un varint que indica el tamaño del siguiente mensaje protobuf serializado, como lo realiza el método LogEntry.writeDelimitedTo(OutputStream).
- Valor predeterminado de
--[no]experimental_remote_mark_tool_inputs
: “falso” - Si se configura como verdadero, Bazel marcará las entradas como entradas de herramientas para el ejecutor remoto. Esto se puede usar para implementar trabajadores persistentes remotos.
- Valor predeterminado de
--[no]experimental_remote_merkle_tree_cache
: “falso” - Si se configura como verdadera, se calcularán los cálculos del árbol de Merkle para mejorar la velocidad de comprobación de aciertos de la caché remota. La impresión del pie de la memoria en caché se controla mediante --experimental_remote_merkle_tree_cache_size.
- Valor predeterminado de
--experimental_remote_merkle_tree_cache_size=<a long integer>
: “1,000” - Es la cantidad de árboles Merkle que se memorizarán para mejorar la velocidad de comprobación de la acierto de caché remota. Aunque la caché se reduce automáticamente según la administración de referencias flexibles de Java, pueden producirse errores de memoria insuficiente si se configuran demasiado altos. Si se establece en 0, el tamaño de la caché es ilimitado. El valor óptimo varía según el tamaño del proyecto. La configuración predeterminada es 1,000.
- Valor predeterminado de
--[no]incompatible_remote_build_event_upload_respect_no_cache
: “falso” - Si se establece como verdadera, los resultados a los que hace referencia BEP no se suben a la caché remota si la acción de generación no se puede almacenar en caché de forma remota.
--[no]incompatible_remote_downloader_send_all_headers
predeterminado: “verdadero”-
Indica si se deben enviar todos los valores de un encabezado con valores múltiples al descargador remoto, en lugar de solo al primero.
Etiquetas:incompatible_change
- Valor predeterminado de
--[no]incompatible_remote_output_paths_relative_to_input_root
: “falso” -
Si se establece como verdadera, las rutas de salida son relativas a la raíz de entrada en lugar del directorio de trabajo.
Etiquetas:incompatible_change
--[no]incompatible_remote_results_ignore_disk
predeterminado: “verdadero”-
Si se establece 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é de disco, pero no se carguen en la caché remota.
--noremote_accept_cached hará que Bazel verifique los resultados en la caché del disco, pero no en la caché remota.
no-remote-exec pueden alcanzar la caché del disco.
Consulta #8216 para obtener más detalles.
Etiquetas:incompatible_change
--[no]remote_accept_cached
predeterminado: “verdadero”- Indica si se deben aceptar los resultados de la acción que se almacenaron en caché de forma remota.
--remote_bytestream_uri_prefix=<a string>
predeterminado: 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 al nombre canónico del servicio de ejecución remota. Si no la estableces, se configurará de forma predeterminada en "${hostname}/${instance_name}".
--remote_cache=<a string>
predeterminado: ver descripción- Un URI de un extremo de almacenamiento en caché. Los esquemas admitidos son http, https, grpc, grpcs (grpc with TLS enabled) y Unix (local UNIX sockets). Si no se proporciona un esquema, Bazel se establecerá de forma predeterminada en grpcs. Especifica grpc://, http:// o unix: esquema 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. Se convertirán varios valores para el mismo nombre en una lista separada por comas.
- Se acumulan
--remote_default_exec_properties=<a 'name=value' assignment>
usos múltiples -
Configura las propiedades ejecutivas predeterminadas que se usarán como la plataforma de ejecución remota si una plataforma de ejecución aún no establece exec_properties.
Etiquetas:affects_outputs
--remote_default_platform_properties=<a string>
predeterminado: ""- Configura las propiedades de plataforma predeterminadas que se establecerán para la API de ejecución remota si la plataforma de ejecución aún no establece remote_execution_properties. Este valor también se usará si se selecciona la plataforma host como plataforma de ejecución remota.
- Se acumulan
--remote_downloader_header=<a 'name=value' assignment>
usos múltiples - Especifica un encabezado que se incluirá en las solicitudes de descarga remota: --remote_downloader_header=Name=Value. Se pueden pasar varios encabezados si se especifica la marca varias veces. Se convertirán varios valores para el mismo nombre 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. Se convertirán varios valores para el mismo nombre 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.
--remote_executor=<a string>
predeterminado: ver descripción- HOST o HOST:PORT de un extremo de ejecución remota. Los esquemas admitidos son grpc, grpcs (grpc with TLS enabled) y unix (local UNIX sockets). Si no se proporciona un esquema, Bazel se establecerá de forma predeterminada en grpcs. Especifica grpc:// o unix: esquema para inhabilitar TLS.
- 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. Se convertirán varios valores para el mismo nombre 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.
- Valor predeterminado de
--[no]remote_local_fallback
: “falso” - Indica si se debe volver a la estrategia de ejecución local independiente si falla la ejecución remota.
--remote_local_fallback_strategy=<a string>
predeterminado: "local"- No-op, dejó de estar disponible. Consulta https://github.com/bazelbuild/bazel/issues/7480 para obtener más detalles.
--remote_max_connections=<an integer>
predeterminado: "100"- Limita la cantidad máxima de conexiones simultáneas a la caché/ejecutor remoto. De forma predeterminada, el valor es 100. Establecerlo en 0 significa que no hay limitaciones.
Para la caché remota HTTP, una conexión TCP podría manejar una solicitud a la vez, por lo que Bazel podría realizar hasta --remote_max_connections solicitudes simultáneas.
Para un caché o un ejecutor remoto de gRPC, un canal de gRPC generalmente podría manejar más de 100 solicitudes simultáneas, por lo que Bazel podría realizar alrededor de “--remote_max_connections * 100” solicitudes simultáneas.
Etiquetas:host_machine_resource_optimizations
--remote_proxy=<a string>
predeterminado: 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 configura en 0, los reintentos están inhabilitados.
--remote_timeout=<An immutable length of time.>
predeterminado: "60 s"- La cantidad máxima de tiempo que se debe esperar para que se ejecuten la llamada remota y las llamadas en caché. Para la caché de REST, este es el tiempo de conexión y el tiempo de espera de lectura. Se pueden utilizar las siguientes unidades: Días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
--[no]remote_upload_local_results
predeterminado: “verdadero”- Indica si se deben cargar los resultados de acciones ejecutadas de forma local en la caché remota si la caché remota lo admite y si el usuario está autorizado para hacerlo.
--[no]remote_verify_downloads
predeterminado: “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 forma remota si no coinciden con el valor esperado.
- Varias opciones, sin otra categoría
- Se acumulan
--deleted_packages=<comma-separated list of package names>
usos múltiples - Es una lista de nombres de paquetes separados por comas 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". Por ejemplo, después de borrar x/y/BUILD en tu cliente, el sistema de compilación puede presentar una queja si encuentra una etiqueta "//x:y/z" si aun así la proporciona otra entrada package_path. Si se especifica --deleted_packages x/y, se evita este problema.
--disk_cache=<a path>
predeterminado: ver descripción- Es una ruta de acceso a un directorio en el que Bazel puede leer y escribir acciones y resultados de acciones. Si el directorio no existe, se creará.
- Se acumulan
--experimental_credential_helper=<An (unresolved) path to a credential helper for a scope.>
usos múltiples - Configura el auxiliar de credenciales que se usará a fin de recuperar credenciales para el permiso proporcionado (dominio). Las credenciales de los auxiliares de credenciales tienen prioridad sobre las de <code>--google_default_credentials</code>, `--google_credentials` o <code>.netrc</code>. Consulta https://github.com/bazelbuild/proposals/blob/main/designs/2022-06-07-bazel-credential-helpers.md para obtener más detalles.
- Valor predeterminado de
--experimental_credential_helper_cache_duration=<An immutable length of time.>
: "30 m" - Configura la duración de las credenciales que se almacenan en caché las credenciales de los auxiliares de credenciales. La invocación con un valor diferente ajustará la vida útil de las entradas preexistentes; pasa cero para borrar la caché. Un comando limpio siempre borra la caché, sin importar esta marca.
--experimental_credential_helper_timeout=<An immutable length of time.>
predeterminado: "5 s"- Configura el tiempo de espera para el auxiliar de credenciales. Los auxiliares de credenciales que no respondan en este tiempo de espera fallarán la invocación.
--google_auth_scopes=<comma-separated list of options>
predeterminado: “https://www.googleapis.com/auth/cloud-platform”- Una lista separada por comas de los permisos de autenticación de Google Cloud.
--google_credentials=<a string>
predeterminado: ver descripción- Especifica el archivo del que se obtendrán las credenciales de autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más detalles.
- Valor predeterminado de
--[no]google_default_credentials
: “falso” - Determina si se deben usar las “credenciales predeterminadas de la aplicación de Google” en la autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más detalles. Inhabilitada de forma predeterminada.
--grpc_keepalive_time=<An immutable length of time.>
predeterminado: ver descripción- Configura pings keep-alive para conexiones de gRPC salientes. Si se configura, Bazel envía pings después de este tiempo sin operaciones de lectura en la conexión, pero solo si hay al menos una llamada de gRPC pendiente. Los horarios se tratan como segundo nivel de detalle; es un error establecer un valor inferior a un segundo. De forma predeterminada, los pings keep-alive están inhabilitados. Debes coordinar con el propietario del servicio antes de habilitar esta configuración. Por ejemplo, para establecer un valor de 30 segundos en esta marca, se debe hacer de la siguiente manera: grpc_keepalive_time=30s
- Valor predeterminado de
--grpc_keepalive_timeout=<An immutable length of time.>
: "20 s" - Configura un tiempo de espera de keep-alive para las conexiones salientes de gRPC. 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 tratan como segundo nivel de detalle; es un error establecer un valor inferior a un segundo. Si los pings keep-alive están inhabilitados, se ignora esta configuración.
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con un directorio local.
--package_path=<colon-separated list of options>
predeterminado: "%workspace%"- Es una lista separada por dos puntos sobre dónde buscar paquetes. Los elementos que comienzan con "%workspace%" se relacionan con el espacio de trabajo que lo contiene. Si se omite o está vacío, el valor predeterminado es el resultado de "bazel info default-package-path".
--[no]show_loading_progress
predeterminado: “verdadero”- Si se habilita, hace que Bazel imprima mensajes de "Cargando paquete".
--tls_certificate=<a string>
predeterminado: ver descripción- Especifica una ruta de acceso a un certificado TLS que sea de confianza para firmar los certificados de servidor.
--tls_client_certificate=<a string>
predeterminado: ver descripción- Especifica el certificado de cliente de TLS que se usará. También debes proporcionar una clave de cliente para habilitar la autenticación del cliente.
--tls_client_key=<a string>
predeterminado: ver descripción- Especifica la clave de cliente de TLS que se usará. También debes proporcionar un certificado de cliente para habilitar la autenticación del cliente.
Opciones de ayuda
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Puedes buscar archivos adicionales antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]experimental_repository_cache_hardlinks
: “falso” -
Si se configura, la caché del repositorio vinculará el archivo en caso de un acierto de caché, en lugar de copiarlo. Esto está destinado a ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]experimental_repository_cache_urls_as_default_canonical_id
: “falso” -
Si es verdadero, usa una string derivada de las URL de las descargas del repositorio como el canonical_id si no se especifica. Esto hace que un cambio en las URL provoque una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no generen la máscara de caché de los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
- Valor predeterminado de
--[no]experimental_repository_disable_download
: “falso” - 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 configura en 0, los reintentos están inhabilitados.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark según este factor. De esta manera, los repositorios externos pueden funcionar en máquinas que son más lentas de lo que espera el autor de la regla, sin cambiar el código fuente
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas HTTP mediante el factor determinado
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: ver descripción-
Especifica la ubicación de la 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 forma estricta en que Bazel aplica las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etc.):
--experimental_repository_hash_file=<a string>
predeterminado: ""-
Si el campo no está vacío, especifica un archivo que contiene un valor resuelto, en el que se deben verificar los hash del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan
--experimental_verify_repository_rules=<a string>
usos múltiples - Si la lista de reglas del repositorio para la que se debe verificar el hash del directorio de salida, siempre que --experimental_repository_hash_file proporcione un archivo
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o de la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: “verdadero”-
No-op
Etiquetas:no_op
,deprecated
,experimental
- Opciones relacionadas con los resultados y la semántica de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Se especificaron las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran en un registro del origen del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones con bloqueos harán que falle la resolución. También puedes definir una versión ya permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puede inhabilitar esta comprobación con la palabra clave "todo" (no se recomienda).
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
: "Error" -
Comprueba la compatibilidad de los módulos de Bazel con la versión 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 detecta una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "warning"-
Comprueba si las dependencias directas de "bazel_dep" declaradas en el módulo raíz son las mismas que se muestran en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la comprobación, "warning" para mostrar una advertencia cuando se detecta una discrepancia o "error" para escalarla a una falla de resolución.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]ignore_dev_dependency
: “falso” -
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declaradas como "dev_dependency" en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev se ignoran siempre en MODULE.bazel si no es el módulo raíz independientemente del valor de esta marca.
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 un directorio local.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en registros anteriores y solo volverán a los registros posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Valor predeterminado de
--[no]experimental_record_metrics_for_all_mnemonics
: “falso” - De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 nombres con la mayor cantidad de acciones ejecutadas. Si se establece esta opción, se escribirán estadísticas para todos los mnemónicos.
- Valor predeterminado de
--help_verbosity=<long, medium or short>
: “medio” -
Seleccione la verbosidad del comando de ayuda.
Etiquetas:affects_outputs
,terminal_output
--long
[-l
]-
Muestra una descripción completa de cada opción, no 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 ni significados.
Se expande a:
--help_verbosity=short
Etiquetas:affects_outputs
,terminal_output
- Opciones que especifican o alteran una entrada genérica de un comando de Bazel que no pertenece a otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si el archivo resuelto 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é remotas:
--experimental_downloader_config=<a string>
predeterminado: ver descripción- Especifica un archivo para configurar la descarga remota. Este archivo consta de líneas y cada una comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para coincidir y uno para usar como URL sustituta. Las referencias inversas comienzan desde "$1". Es posible que se muestren varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias.
- Varias opciones, sin otra categoría
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con un directorio local.
Opciones de información
Hereda todas las opciones de build.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Puedes buscar archivos adicionales antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]experimental_repository_cache_hardlinks
: “falso” -
Si se configura, la caché del repositorio vinculará el archivo en caso de un acierto de caché, en lugar de copiarlo. Esto está destinado a ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]experimental_repository_cache_urls_as_default_canonical_id
: “falso” -
Si es verdadero, usa una string derivada de las URL de las descargas del repositorio como el canonical_id si no se especifica. Esto hace que un cambio en las URL provoque una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no generen la máscara de caché de los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
- Valor predeterminado de
--[no]experimental_repository_disable_download
: “falso” - 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 configura en 0, los reintentos están inhabilitados.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark según este factor. De esta manera, los repositorios externos pueden funcionar en máquinas que son más lentas de lo que espera el autor de la regla, sin cambiar el código fuente
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas HTTP mediante el factor determinado
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: ver descripción-
Especifica la ubicación de la 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 forma estricta en que Bazel aplica las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etc.):
--experimental_repository_hash_file=<a string>
predeterminado: ""-
Si el campo no está vacío, especifica un archivo que contiene un valor resuelto, en el que se deben verificar los hash del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan
--experimental_verify_repository_rules=<a string>
usos múltiples - Si la lista de reglas del repositorio para la que se debe verificar el hash del directorio de salida, siempre que --experimental_repository_hash_file proporcione un archivo
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o de la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: “verdadero”-
No-op
Etiquetas:no_op
,deprecated
,experimental
- Opciones relacionadas con los resultados y la semántica de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Se especificaron las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran en un registro del origen del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones con bloqueos harán que falle la resolución. También puedes definir una versión ya permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puede inhabilitar esta comprobación con la palabra clave "todo" (no se recomienda).
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
: "Error" -
Comprueba la compatibilidad de los módulos de Bazel con la versión 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 detecta una discrepancia.
Etiquetas:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
predeterminado: "warning"-
Comprueba si las dependencias directas de "bazel_dep" declaradas en el módulo raíz son las mismas que se muestran en el gráfico de dependencias resuelto. Los valores válidos son "off" para inhabilitar la comprobación, "warning" para mostrar una advertencia cuando se detecta una discrepancia o "error" para escalarla a una falla de resolución.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]ignore_dev_dependency
: “falso” -
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declaradas como "dev_dependency" en el MODULE.bazel del módulo raíz. Ten en cuenta que esas dependencias de dev se ignoran siempre en MODULE.bazel si no es el módulo raíz independientemente del valor de esta marca.
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 un directorio local.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en registros anteriores y solo volverán a los registros posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Valor predeterminado de
--[no]experimental_record_metrics_for_all_mnemonics
: “falso” - De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 nombres con la mayor cantidad de acciones ejecutadas. Si se establece esta opción, se escribirán estadísticas para todos los mnemónicos.
- Valor predeterminado de
--[no]show_make_env
: “falso” - Incluye el entorno “Make” en la salida.
Etiquetas:affects_outputs
,terminal_output
- Opciones para especificar o alterar una entrada genérica en un comando de Bazel que no pertenezca a otras categorías:
--experimental_resolved_file_instead_of_workspace=<a string>
predeterminado: ""-
Si el archivo resuelto 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é remotas:
--experimental_downloader_config=<a string>
predeterminado: ver descripción- Especifica un archivo para configurar la descarga remota. Este archivo consta de líneas y cada una comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para coincidir y uno para usar como URL sustituta. Las referencias inversas comienzan desde "$1". Es posible que se muestren varias directivas "rewrite" para la misma URL y, en este caso, se mostrarán varias.
- Varias opciones, sin otra categoría
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con un directorio local.
Opciones de licencia
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Puedes buscar archivos adicionales antes de acceder a la red para descargarlos.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]experimental_repository_cache_hardlinks
: “falso” -
Si se configura, la caché del repositorio vinculará el archivo en caso de un acierto de caché, en lugar de copiarlo. Esto está destinado a ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]experimental_repository_cache_urls_as_default_canonical_id
: “falso” -
Si es verdadero, usa una string derivada de las URL de las descargas del repositorio como el canonical_id si no se especifica. Esto hace que un cambio en las URL provoque una nueva descarga, incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no generen la máscara de caché de los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
- Valor predeterminado de
--[no]experimental_repository_disable_download
: “falso” - 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 configura en 0, los reintentos están inhabilitados.
Etiquetas:experimental
--experimental_scale_timeouts=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera en las reglas del repositorio de Starlark según este factor. De esta manera, los repositorios externos pueden funcionar en máquinas que son más lentas de lo que espera el autor de la regla, sin cambiar el código fuente
Etiquetas:bazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
predeterminado: "1.0"-
Escala todos los tiempos de espera relacionados con las descargas HTTP mediante el factor determinado
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: ver descripción-
Especifica la ubicación de la 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 forma estricta en que Bazel aplica las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etc.):
--experimental_repository_hash_file=<a string>
predeterminado: ""-
Si el campo no está vacío, especifica un archivo que contiene un valor resuelto, en el que se deben verificar los hash del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Se acumulan
--experimental_verify_repository_rules=<a string>
usos múltiples - Si la lista de reglas del repositorio para la que se debe verificar el hash del directorio de salida, siempre que --experimental_repository_hash_file proporcione un archivo
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje Starlark o de la API de compilación a la que pueden acceder los archivos BUILD, .bzl o WORKSPACE.
--[no]experimental_allow_top_level_aspects_parameters
predeterminado: “verdadero”-
No-op
Etiquetas:no_op
,deprecated
,experimental
- Opciones relacionadas con los resultados y la semántica de Bzlmod:
- Se acumulan
--allow_yanked_versions=<a string>
usos múltiples -
Se especificaron las versiones del módulo con el formato "<module1>@<version1>,<module2>@<version2>" que se permitirán en el gráfico de dependencias resuelto, incluso si se declaran en un registro del origen del que provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones con bloqueos harán que falle la resolución. También puedes definir una versión ya permitida con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puede inhabilitar esta comprobación con la palabra clave "todo" (no se recomienda).
Etiquetas:loading_and_analysis
- Valor predeterminado de
--check_bazel_compatibility=<error, warning or off>
: "Error" - Comprueba la compatibilidad de los módulos de Bazel con la versión de Bazel. Los valores válidos son "error" para derivarlo a una falla de resolución, "off" para inhab