bazel [<startup options>] <command> [<args>]o
bazel [<startup options>] <command> [<args>] -- [<target patterns>]Consulta la Guía del usuario para conocer la sintaxis de los patrones de 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 formato 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 se pueden inhabilitar de la siguiente manera:
--no<option> --<option>=[false|no|0]
Por lo general, las opciones de triestado se configuran de forma predeterminada y se pueden habilitar de manera forzada de la siguiente manera:
--<option>=[true|yes|1]o forzar su inhabilitación de la siguiente manera:
--no<option> --<option>=[false|no|0]
Comandos
analyze-profile |
Analiza los datos de perfil de compilación. |
aquery |
Analiza los objetivos proporcionados y consulta el gráfico de acción. |
build |
Compila los destinos especificados. |
canonicalize-flags |
Canonicaliza una lista de opciones de bazel. |
clean |
Quita los archivos de salida y, de manera opcional, detiene el servidor. |
coverage |
Genera un informe de cobertura de código para objetivos de prueba especificados. |
cquery |
Carga, analiza y consulta los destinos especificados con las configuraciones. |
dump |
Vuelca el estado interno del proceso del servidor de Bazel. |
fetch |
Recupera repositorios externos previos a los destinos. |
help |
Imprime ayuda sobre los comandos o sobre 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 objetivos en dispositivos móviles. |
modquery |
Consulta el gráfico de dependencias externas 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 de Bazel. |
sync |
Sincroniza todos los repositorios especificados en el archivo del lugar de trabajo |
test |
Compila y ejecuta los destinos de prueba especificados. |
version |
Imprime la información de la versión para Bazel. |
Opciones de inicio
- Opciones que aparecen antes del comando y que el cliente analiza:
- Valor predeterminado de
--[no]autodetect_server_javabase
: “verdadero” -
Cuando se pasa --noautodetect_server_javabase, Bazel no recurre al JDK local para ejecutar el servidor de Bazel y, en su lugar, sale.
Etiquetas:affects_outputs
,loses_incremental_state
- Valor predeterminado
--[no]batch
: “falso” -
Si se configura, Bazel se ejecutará como un proceso de cliente sin un servidor, en lugar del modo cliente/servidor estándar. Esta acción dejó de estar disponible y se quitará. Le recomendamos que apague el servidor de manera explícita si desea evitar servidores persistentes.
Etiquetas:loses_incremental_state
,bazel_internal_configuration
,deprecated
- Valor predeterminado
--[no]batch_cpu_scheduling
: “falso” -
Solo en Linux. Usa la programación de CPU “por lotes” para Blaze. Esta política es útil para las cargas de trabajo no interactivas, pero que no desean disminuir su valor. Consulta "man 2 sched_setscheduler". Si es falso, Bazel no realizará una llamada al sistema.
Etiquetas:host_machine_resource_optimizations
--bazelrc=<path>
predeterminado: ver la descripción-
Ubicación del archivo .bazelrc del usuario que contiene valores predeterminados de las opciones de Bazel. /dev/null indica que todos los demás "--bazelrc" se ignorarán, lo cual es útil para inhabilitar la búsqueda de un archivo RC de usuario, p.ej., en compilaciones de lanzamiento.
Esta opción también se puede especificar varias veces.
P. ej., se lee “--bazelrc=x.rc --bazelrc=y.rc --bazelrc=/dev/null --bazelrc=z.rc”, 1) y .rc.
2) Se ignora z.rc debido al parámetro /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 la línea de comandos siempre sustituirán a cualquier opción en bazelrc.
Etiquetas:changes_inputs
- Valor predeterminado de
--[no]block_for_lock
: “verdadero” -
Cuando se pasa --noblock_for_lock, Bazel no espera a que se complete un comando en ejecución, sino que se cierra de inmediato.
Etiquetas:eagerness_to_exit
- Valor predeterminado
--[no]client_debug
: “falso” -
Si es verdadero, registre 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
- Configuración predeterminada de
--connect_timeout_secs=<an integer>
: “30” -
La cantidad de tiempo que el cliente espera para cada intento de conectarse al servidor.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]expand_configs_in_place
: “verdadero” -
Se cambió la expansión de las marcas --config para que se implementen en el lugar, 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 la descripción-
Si se establece, especifica una ubicación para escribir un mensaje de protobuf de failure_detail si el servidor experimenta una falla y no puede informarlo a través de gRPC, como siempre. De lo contrario, la ubicación será ${OUTPUT_BASE}/failure_detail.rawproto.
Etiquetas:affects_outputs
,loses_incremental_state
- Valor predeterminado de
--[no]home_rc
: “verdadero” -
Busca o no el archivo bazelrc principal en $HOME/.bazelrc
Etiquetas:changes_inputs
- Valor predeterminado de
--[no]idle_server_tasks
: “verdadero” -
Ejecuta System.gc() cuando el servidor esté inactivo
Etiquetas:loses_incremental_state
,host_machine_resource_optimizations
- Valor predeterminado
--[no]ignore_all_rc_files
: “falso” -
Inhabilita todos los archivos RC, independientemente de los valores de otras marcas que modifiquen rc, incluso si aparecen después en la lista de opciones de inicio.
Etiquetas:changes_inputs
- Valor predeterminado de
--io_nice_level={-1,0,1,2,3,4,5,6,7}
: "-1" -
Solo en Linux. Establece un nivel de 0 a 7 para la programación de IO con el mejor esfuerzo mediante la llamada del sistema sys_ioprio_set. 0 es la prioridad más alta y 7 es la menor. El programador anticipado solo puede respetar la prioridad 4. Si se configura con un valor negativo, Bazel no realizará una llamada al sistema.
Etiquetas:host_machine_resource_optimizations
- Configuración predeterminada 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: “default”-
Configura la clase de servicio QoS del servidor de Bazel cuando se ejecuta en macOS. Esta marca no tiene efecto en todas las otras plataformas, pero es compatible para garantizar que los archivos rc se puedan compartir entre ellas sin cambios. Los valores posibles son los siguientes: interactivo por el usuario, iniciado por el usuario, predeterminado, utilidad y en segundo plano.
Etiquetas:host_machine_resource_optimizations
- Configuración predeterminada de
--max_idle_secs=<integer>
: “10800” -
Es la cantidad de segundos que el servidor de compilación esperará inactivo antes de apagarse. Cero significa que el servidor nunca se apagará. Esto solo se lee al iniciar el servidor; si cambias esta opción, el servidor no se reiniciará.
Etiquetas:eagerness_to_exit
,loses_incremental_state
--output_base=<path>
predeterminado: ver la descripción-
Si se establece, 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 servidor adicional de Bazel adicional. Bazel inicia exactamente un servidor por cada 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 manera simultánea. Consulta “Cierre de la ayuda de Bazel” para obtener información sobre cómo apagar un servidor de Bazel.
Etiquetas:affects_outputs
,loses_incremental_state
--output_user_root=<path>
predeterminado: ver la descripción-
Es el directorio específico del usuario debajo del cual se escriben todos los resultados de la compilación. De forma predeterminada, esta es una función de $USER, pero si se especifica una constante, los resultados de la compilación se pueden compartir entre los usuarios que colaboran.
Etiquetas:affects_outputs
,loses_incremental_state
- Valor predeterminado
--[no]preemptible
: “falso” -
Si es verdadero, el comando se puede interrumpir si se inicia otro.
Etiquetas:eagerness_to_exit
--server_jvm_out=<path>
predeterminado: ver la descripción-
La ubicación para escribir la salida del JVM del servidor. Si no se establece, la configuración predeterminada es una ubicación en output_base.
Etiquetas:affects_outputs
,loses_incremental_state
- Valor predeterminado
--[no]shutdown_on_low_sys_mem
: “falso” -
Si se establece max_idle_secs y el servidor de compilación ha estado inactivo durante un tiempo, apague el servidor cuando haya poca memoria libre en el sistema. Solo en Linux.
Etiquetas:eagerness_to_exit
,loses_incremental_state
- Valor predeterminado de
--[no]system_rc
: “verdadero” -
Indica si se debe buscar o no el bazelrc en todo el sistema.
Etiquetas:changes_inputs
- Valor predeterminado
--[no]unlimit_coredumps
: “falso” -
Aumenta el límite de núcleo flexible al límite estricto para que los dupliques del servidor (incluida la JVM) y el cliente sean posibles en condiciones comunes. Pega esta bandera en tu bazelrc una vez y olvídate de ella para que se muestren los núcleos cuando se encuentre con una condición que los active.
Etiquetas:bazel_internal_configuration
- Valor predeterminado
--[no]watchfs
: “falso” -
Si es verdadero, Bazel intenta usar el servicio de observación de archivos del sistema operativo para realizar cambios locales en lugar de analizar cada archivo en busca de un cambio.
Etiquetas:deprecated
- Valor predeterminado
--[no]windows_enable_symlinks
: “falso” -
Si es verdadero, se crearán vínculos simbólicos reales en Windows en lugar de copiar archivos. Se requiere que esté habilitado el modo de desarrollador de Windows y la versión 1703 o posterior de Windows 10.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--[no]workspace_rc
: “verdadero” -
Ya sea que busques o no el archivo bazelrc de lugar de trabajo en $workspace/.bazelrc
Etiquetas:changes_inputs
- Opciones misceláneas:
- Se acumulan
--host_jvm_args=<jvm_arg>
usos múltiples - Marcas para pasar a la JVM que ejecuta Blaze.
--host_jvm_debug
-
Opción de conveniencia para agregar algunas marcas de inicio adicionales de JVM, que hacen que la JVM espere durante el inicio hasta que te conectes desde un depurador compatible con JDWP (como Eclipse) al puerto 5005.
Se expande a:
--host_jvm_args=-Xdebug
--host_jvm_args=-Xrunjdwp:transport=dt_socket,server=y,address=5005
- Configuración predeterminada de
--host_jvm_profile=<profiler_name>
: "" - Es una opción conveniente para agregar algunas marcas de inicio de JVM específicas del generador de perfiles o del depurador. Bazel tiene una lista de valores conocidos que asigna a marcas de inicio de JVM hard-coded, que posiblemente busquen algunas rutas codificadas para ciertos archivos.
- Configuración predeterminada de
--server_javabase=<jvm path>
: "" - Ruta de acceso a la JVM que se usa para ejecutar Bazel.
Opciones comunes a todos los comandos
- Opciones que controlan la ejecución de la compilación:
- Configuración predeterminada 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 implica que no hay límite.
Etiquetas:execution
- Valor predeterminado de
--[no]incompatible_remote_dangling_symlinks
: “verdadero” -
Si se establece en verdadero y --incompatible_remote_symlinks también se establece como verdadero, se permite que los symlinks en los resultados de acción se coloquen.
Etiquetas:execution
,incompatible_change
- Valor predeterminado de
--[no]incompatible_remote_symlinks
: “verdadero” -
Si se establece como verdadero, Bazel representará symlinks en los resultados de acción del protocolo de ejecución/almacenamiento en caché remoto como tal. 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
- Opciones que permiten al usuario configurar la salida deseada y afectar su valor, a diferencia de su existencia:
- Valor predeterminado de
--bep_maximum_open_remote_upload_files=<an integer>
: "-1" -
Se permite la cantidad máxima de archivos abiertos durante la carga de artefactos de BEP.
Etiquetas:affects_outputs
--remote_download_minimal
-
No descarga los resultados de compilación remota en la máquina local. Esta marca es un acceso directo para las marcas: --action_cache_store_output_metadata, --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files y --remote_download_outputs=minimal.
Se expande a:
--nobuild_runfile_links
--action_cache_store_output_metadata
--remote_download_outputs=minimal
Etiquetas:affects_outputs
--remote_download_outputs=<all, minimal or toplevel>
predeterminado: “todos”-
Si se establece como “minimal”, no se descargan salidas de compilación remota en la máquina local, excepto las que requieren las acciones locales. Si se establece como “toplevel”, se comporta como “minimal”, con la excepción de que también descarga salidas de destinos de nivel superior en la máquina local. Ambas opciones pueden reducir de manera significativa los tiempos de compilación si el ancho de banda de la red genera un cuello de botella.
Etiquetas:affects_outputs
- Configuración predeterminada de
--remote_download_symlink_template=<a string>
: "" -
En lugar de descargar los 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 las salidas remotas de los objetivos de nivel superior en la máquina local. Esta marca es un acceso directo para las marcas: --action_cache_store_output_metadata, --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files y --remote_download_outputs=toplevel.
Se expande a:
--action_cache_store_output_metadata
--remote_download_outputs=toplevel
Etiquetas:affects_outputs
- Se acumulan
--repo_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica variables de entorno adicionales que solo estarán disponibles para las reglas del repositorio. Ten en cuenta que las reglas del repositorio ven el entorno completo de todos modos, pero, de esta manera, la información de configuración se puede pasar a los repositorios a través de las opciones sin invalidar el gráfico de acción.
Etiquetas:action_command_lines
- Opciones que afectan cómo se aplica estrictamente Bazel a las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etc.):
- Valor predeterminado de
--[no]check_bzl_visibility
: “verdadero” -
Si está inhabilitada, los errores de visibilidad de la carga de .bzl descienden a advertencias.
Etiquetas:build_file_semantics
- Esta opción afecta la semántica del lenguaje de Starlark o de la API de compilación accesible para los archivos BUILD, los archivos .bzl o los archivos WORKSPACE:
- Valor predeterminado
--[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/docs/bzlmod para obtener más información.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]experimental_action_resource_set
: “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, el valor predeterminado será de 250 MB para la memoria y 1 CPU.
Etiquetas:execution
,build_file_semantics
,experimental
-
Si se establece como verdadero, las etiquetas se propagarán de un objetivo a los requisitos de ejecución de las acciones. De lo contrario, las etiquetas no se propagarán. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/8830.
Etiquetas:build_file_semantics
,experimental
- Valor predeterminado de
--[no]experimental_analysis_test_call
: “verdadero” -
Si se establece como verdadera, está disponible la llamada nativa Analysis_test.
Etiquetas:loading_and_analysis
,build_file_semantics
,experimental
- Valor predeterminado de
--[no]experimental_bzl_visibility
: “verdadero” -
Si se habilita, agrega una función "visibilidad()" que los archivos .bzl pueden llamar durante la evaluación de nivel superior para establecer su visibilidad a los efectos de las declaraciones load().
Etiquetas:loading_and_analysis
,experimental
-
Si se establece como verdadera, estarán disponibles los atributos de la regla y los métodos de la API de Starlark necesarios para la regla cc_shared_library
Etiquetas:build_file_semantics
,loading_and_analysis
,experimental
- Valor predeterminado
--[no]experimental_disable_external_package
: “falso” -
Si se establece como verdadera, el paquete externo //generado automáticamente ya no estará disponible. Bazel aún no podrá analizar el archivo “external/BUILD”, pero los globs que se dirijan a external/ desde el paquete sin nombre funcionarán.
Etiquetas:loading_and_analysis
,loses_incremental_state
,experimental
- Valor predeterminado
--[no]experimental_enable_android_migration_apis
: “falso” -
Si se establece como verdadera, habilita las APIs necesarias para admitir la migración de Android Starlark.
Etiquetas:build_file_semantics
- Valor predeterminado
--[no]experimental_enable_scl_dialect
: “falso” -
Si se establece como verdadera, se pueden usar archivos .scl en las instrucciones load().
Etiquetas:build_file_semantics
- Valor predeterminado
--[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 los atributos.
Etiquetas:loading_and_analysis
,experimental
- Valor predeterminado
--[no]experimental_google_legacy_api
: “falso” -
Si se establece como verdadera, se exponen varias piezas experimentales de la API de compilación de Starlark que pertenecen al código heredado de Google.
Etiquetas:loading_and_analysis
,experimental
- Valor predeterminado
--[no]experimental_java_library_export
: “falso” -
Si está habilitado, está disponible el módulo experimental_java_library_export_do_not_use.
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]experimental_lazy_template_expansion
: “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
--[no]experimental_platforms_api
: “falso” -
Si se establece como verdadera, habilita varias APIs de Starlark relacionadas con la plataforma que son útiles para la depuración.
Etiquetas:loading_and_analysis
,experimental
- Valor predeterminado
--[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
--[no]experimental_sibling_repository_layout
: “falso” -
Si se configura como verdadero, los repositorios que no son principales se plantan como symlinks al repositorio principal en la raíz de ejecución. Es decir, todos los repositorios son elementos secundarios directos del directorio $output_base/execution_root. Esto tiene el efecto secundario de liberar $output_base/execution_root/__main__/external para el directorio real "external" de nivel superior.
Etiquetas:action_command_lines
,bazel_internal_configuration
,loading_and_analysis
,loses_incremental_state
,experimental
- Valor predeterminado de
--[no]incompatible_always_check_depset_elements
: “verdadero” -
Verifica la validez de los elementos agregados a depsets en todos los constructores. Los elementos deben ser inmutables, pero históricamente el constructor depset(direct=...) se olvidó de verificar. Usa tuplas en lugar de listas en los elementos depset. Consulta https://github.com/bazelbuild/bazel/issues/10313 para obtener más detalles.
Etiquetas:build_file_semantics
,incompatible_change
- Valor predeterminado de
--[no]incompatible_depset_for_libraries_to_link_getter
: “verdadero” -
Cuando es verdadero, Bazel ya no muestra una lista de linked_context.library_to_link, sino que muestra un elemento depset.
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado
--[no]incompatible_disable_starlark_host_transitions
: “falso” -
Si se establece como verdadera, los atributos de las reglas no pueden establecer “cfg = “host””. En su lugar, las reglas deben establecer “cfg = “exec”.
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado
--[no]incompatible_disable_target_provider_fields
: “falso” -
Si se establece como verdadera, inhabilita la capacidad de acceder a proveedores en objetos “objetivo” mediante la sintaxis de campo. 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
--[no]incompatible_disallow_empty_glob
: “falso” -
Si se establece como verdadera, el valor predeterminado del argumento “allow_empty” de glob() se establece como False.
Etiquetas:build_file_semantics
,incompatible_change
- Valor predeterminado de
--[no]incompatible_disallow_legacy_javainfo
: “verdadero” -
Obsoleto. No-op.
Etiquetas:build_file_semantics
,incompatible_change
- Valor predeterminado
--[no]incompatible_disallow_struct_provider_syntax
: “falso” -
Si se establece como verdadera, es posible que las funciones de implementación de reglas no muestren un struct. En su lugar, deben mostrar una lista de instancias de proveedores.
Etiquetas:build_file_semantics
,incompatible_change
- Valor predeterminado de
--[no]incompatible_existing_rules_immutable_view
: “verdadero” -
Si se establece como verdadera, native.existing_rule y native.existing_rules muestra objetos de vista inmutables ligeros en lugar de diccionarios mutables.
Etiquetas:build_file_semantics
,loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]incompatible_fix_package_group_reporoot_syntax
: “verdadero” -
Cambia el significado del valor “//...” del paquete package_group de “paquetes” 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
- Valor predeterminado de
--[no]incompatible_java_common_parameters
: “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
- Valor predeterminado de
--[no]incompatible_new_actions_api
: “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
- Valor predeterminado de
--[no]incompatible_no_attr_license
: “verdadero” -
Si se establece como verdadera, inhabilita la función “attr.license”.
Etiquetas:build_file_semantics
,incompatible_change
- Valor predeterminado
--[no]incompatible_no_implicit_file_export
: “falso” -
Si se configuran, los archivos de origen (usados) son privados y no se exportaron 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
--[no]incompatible_no_rule_outputs_param
: “falso” -
Si se establece como verdadera, inhabilita el parámetro "outputs" de la función "rule()` Starlark.
Etiquetas:build_file_semantics
,incompatible_change
- Valor predeterminado de
--[no]incompatible_package_group_has_public_syntax
: “verdadero” -
En el atributo "packages" de package_group, se puede escribir "public" o "private" para hacer referencia a todos los paquetes, o bien a ninguno, respectivamente.
Etiquetas:build_file_semantics
,incompatible_change
- Valor predeterminado de
--[no]incompatible_require_linker_input_cc_api
: “verdadero” -
Si se establece como verdadera, la regla create_linked_context requerirá linker_inputs en lugar de library_to_link. También se inhabilitarán los métodos get anteriores de linked_context y solo linker_inputs estará disponible.
Etiquetas:build_file_semantics
,loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]incompatible_run_shell_command_string
: “verdadero” -
Si se establece como verdadero, el parámetro de comando de actions.run_shell solo aceptará
Etiquetas:build_file_semantics
,incompatible_change
- Valor predeterminado
--[no]incompatible_stop_exporting_language_modules
: “falso” -
Si se habilita, algunos módulos específicos de un 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
--[no]incompatible_struct_has_no_methods
: “falso” -
Inhabilita los métodos de struct to_json y to_proto, que contaminan el espacio de nombres del campo struct. En su lugar, usa json.encode o json.encode_indent para JSON, o proto.encode_text para textproto.
Etiquetas:build_file_semantics
,incompatible_change
- Valor predeterminado
--[no]incompatible_top_level_aspects_require_providers
: “falso” -
Si se establece como verdadera, el aspecto de nivel superior cumplirá con los proveedores necesarios y solo se ejecutará en objetivos de nivel superior cuyos proveedores anunciados cumplan con los requisitos del proveedor.
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]incompatible_unambiguous_label_stringification
: “verdadero” -
Cuando sea verdadero, Bazel string la etiqueta @//foo:bar en @//foo:bar, en lugar de //foo:bar. Esto solo afecta el comportamiento de str(), el operador de %, 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
--[no]incompatible_use_cc_configure_from_rules_cc
: “falso” -
Cuando sea verdadero, Bazel ya no permitirá el uso de cc_configure desde @bazel_tools. Consulta https://github.com/bazelbuild/bazel/issues/10134 para obtener instrucciones de migración y detalles.
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado
--[no]incompatible_visibility_private_attributes_at_definition
: “falso” -
Si se establece como verdadera, se verifica la visibilidad de los atributos de la regla privada en relación con su definición y no en su uso.
Etiquetas:build_file_semantics
,incompatible_change
--max_computation_steps=<a long integer>
predeterminado: “0”-
Es la cantidad máxima de pasos de procesamiento de Starlark que puede ejecutar un archivo BUILD (cero significa sin límite).
Etiquetas:build_file_semantics
- Configuración predeterminada de
--nested_set_depth_limit=<an integer>
: “3500” -
La profundidad máxima del gráfico interno a un elemento depset (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
--[no]heuristically_drop_nodes
: “falso” -
Si es verdadero, Blaze quitará los nodos FileState y DirectoryListingState después de que se hagan los nodos relacionados File y DirectoryListing para ahorrar memoria. Esperamos que sea menos probable que estos nodos vuelvan a ser necesarios. Si es así, el programa volverá a evaluarlos.
Etiquetas:loses_incremental_state
- Valor predeterminado de
--[no]incompatible_do_not_split_linking_cmdline
: “verdadero” -
Cuando es verdadero, Bazel ya no modifica las marcas de línea de comandos que se usan para la vinculación y tampoco decide de forma selectiva qué marcas se envían 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
- Valor predeterminado de
--[no]keep_state_after_build
: “verdadero” -
Si es falso, Blaze descartará el estado de la memoria cuando esta finalice. Las compilaciones posteriores no tendrán incrementalidad con respecto a esta.
Etiquetas:loses_incremental_state
- Valor predeterminado de
--[no]track_incremental_state
: “verdadero” -
Si es falso, Blaze no conservará los datos que permitan la invalidación y reevaluación en compilaciones incrementales para ahorrar memoria en esta compilación. Las compilaciones posteriores no tendrán incrementalidad con respecto a esta. Por lo general, querrá especificar --batch cuando establezcas esto como falso.
Etiquetas:loses_incremental_state
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Valor predeterminado
--[no]announce_rc
: “falso” -
Indica si debes anunciar opciones de RC.
Etiquetas:affects_outputs
- Valor predeterminado
--[no]attempt_to_print_relative_paths
: “falso” -
Cuando imprimas la parte de la ubicación de los mensajes, intenta usar una ruta de acceso relativa al directorio de espacio de trabajo o a uno de los directorios especificados por --package_path.
Etiquetas:terminal_output
- Configuración predeterminada de
--bes_backend=<a string>
: "" -
Especifica el extremo de backend del servicio de eventos de compilación (BES) en el formato [SCHEME://]HOST[:PORT]. La opción predeterminada es inhabilitar las cargas de BES. Los esquemas admitidos son grpc y grpcs (grpc con TLS habilitado). Si no se proporciona ningún esquema, Bazel supone grpcs.
Etiquetas:affects_outputs
- Valor predeterminado
--[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ó eventos InvocationIntentStarted y BuildEnqueued que coincidían con el evento de la herramienta actual.
Etiquetas:affects_outputs
- Se acumulan
--bes_header=<a 'name=value' assignment>
usos múltiples -
Especifica un encabezado en formato NAME=VALUE que se incluirá en las solicitudes de BES. Se pueden pasar varios encabezados especificando la marca varias veces. Varios valores para el mismo nombre se convertirán en una lista separada por comas.
Etiquetas:affects_outputs
--bes_instance_name=<a string>
predeterminado: ver la descripción-
Especifica el nombre de la instancia en la que el BES conservará el BEP que se subió. El valor predeterminado es nulo.
Etiquetas:affects_outputs
- Se acumulan
--bes_keywords=<comma-separated list of options>
usos múltiples -
Especifica una lista de palabras clave de notificación para agregar al conjunto predeterminado de palabras clave publicadas en BES ("command_name=<command_name> " o "protocol_name=BEP"). La configuración predeterminada es ninguno.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]bes_lifecycle_events
: “verdadero” -
Especifica si se deben publicar eventos de ciclo de vida de BES. (el valor predeterminado es “verdadero”).
Etiquetas:affects_outputs
- Configuración predeterminada de
--bes_oom_finish_upload_timeout=<An immutable length of time.>
: "10 m" -
Especifica cuánto tiempo debe esperar el bazel para que se complete la carga de BES/BEP durante el proceso de OOMing. Esta marca garantiza la finalización cuando la JVM presenta una hiperpaginación excesiva de GC y no puede progresar en ningún subproceso de usuario.
Etiquetas:bazel_monitoring
- Configuración predeterminada de
--bes_outerr_buffer_size=<an integer>
: “10240” -
Especifica el tamaño máximo de stdout o stderr que se almacenará en búfer en BEP, antes de que se registre como evento de progreso. Las escrituras individuales se informan en un solo evento, incluso si son más grandes que el valor especificado hasta --bes_outerr_chunk_size.
Etiquetas:affects_outputs
- Configuración predeterminada 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 la descripción- Conéctate al servicio de eventos de compilación a través de un proxy. Actualmente, esta marca solo se puede usar para configurar un socket de dominio Unix (unix:/path/to/socket).
- Configuración predeterminada de
--bes_results_url=<a string>
: "" -
Especifica la URL base en la que un usuario puede ver la información que se transmite al backend de BES. Bazel enviará a la terminal la URL adjuntada por el ID de invocación.
Etiquetas:terminal_output
- Se acumulan
--bes_system_keywords=<comma-separated list of options>
usos múltiples -
Especifica una lista de palabras clave de notificación que se incluirán directamente, sin el prefijo "user_keyword=", para las palabras clave proporcionadas mediante --bes_keyword. Se diseñó para los operadores de servicios de compilación que establecen --bes_lifecycle_events=false y que incluyen palabras clave cuando se llama a PublishLifecycleEvent. Los operadores de servicios de compilación que usan esta marca deben evitar que los usuarios anulen el valor de la marca.
Etiquetas:affects_outputs
- Valor predeterminado de
--bes_timeout=<An immutable length of time.>
: “0 s” -
Especifica cuánto tiempo debe esperar el bazel para que se complete la carga de BES/BEP después de que se complete 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
- Configuración predeterminada de
--bes_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>
: "wait_for_upload_complete" -
Especifica si la carga del Service de evento de compilación debe bloquear la finalización de la compilación o debe finalizar la invocación de inmediato y finalizar la carga en segundo plano. "wait_for_upload_complete" (predeterminado), "nowait_for_upload_complete" o "fully_async".
Etiquetas:eagerness_to_exit
- Configuración predeterminada de
--build_event_binary_file=<a string>
: "" -
Si no está vacío, escribe una representación binaria delimitada por una variable de representación del protocolo del evento de compilación en ese archivo. Esta opción implica --bes_upload_mode=wait_for_upload_complete.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]build_event_binary_file_path_conversion
: “verdadero” -
Convierte las rutas de acceso en la representación del archivo binario del protocolo de eventos de compilación en URI más válidas a nivel global siempre que sea posible. Si se inhabilita, siempre se usará el esquema file:// uri.
Etiquetas:affects_outputs
- Configuración predeterminada de
--build_event_json_file=<a string>
: "" -
Si no está vacío, escriba una serialización JSON del protocolo de evento de compilación en ese archivo.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]build_event_json_file_path_conversion
: “verdadero” -
Convierte las rutas de acceso en la representación del archivo json del protocolo de eventos de compilación en 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
--build_event_max_named_set_of_file_entries=<an integer>
: "-1" -
Es 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 eventos en el protocolo de eventos de compilación, aunque no controla directamente el tamaño del evento. El tamaño total del evento depende de la estructura del conjunto, así como de las longitudes del archivo y el URI, que, a su vez, pueden depender de la función hash.
Etiquetas:affects_outputs
- Valor predeterminado
--[no]build_event_publish_all_actions
: “falso” -
Indica si todas las acciones deben publicarse.
Etiquetas:affects_outputs
- Configuración predeterminada de
--build_event_text_file=<a string>
: "" -
Si no está vacío, escribe una representación textual del protocolo de eventos de compilación en ese archivo:
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]build_event_text_file_path_conversion
: “verdadero” -
Convierte las rutas de acceso en la representación del archivo de texto del protocolo de eventos de compilación en URI más válidas a nivel global siempre que sea posible. Si se inhabilita, siempre se usará el esquema file:// uri.
Etiquetas:affects_outputs
- Valor predeterminado
--[no]experimental_announce_profile_path
: “falso” -
Si está habilitada, agrega la ruta de acceso del perfil JSON al registro.
Etiquetas:bazel_monitoring
- Valor predeterminado
--[no]experimental_bep_target_summary
: “falso” - Indica si se deben publicar eventos TargetSummary.
- Valor predeterminado
--[no]experimental_build_event_expand_filesets
: “falso” -
Si es verdadero, expande los conjuntos de archivos en el BEP cuando se presentan los archivos de salida.
Etiquetas:affects_outputs
- Valor predeterminado
--[no]experimental_build_event_fully_resolve_fileset_symlinks
: “falso” -
Si es verdadero, resuelve por completo los symlinks relativos del conjunto de archivos en la BEP cuando se presentan los archivos de salida. Requiere --experimental_build_event_expand_filesets.
Etiquetas:affects_outputs
- Configuración predeterminada de
--experimental_build_event_upload_max_retries=<an integer>
: "4" -
Es la cantidad máxima de veces que Bazel debe intentar subir un evento de compilación.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
: "1 s" -
Es el retraso mínimo para los reintentos de retirada exponencial cuando falla la carga del BEP. (exponente: 1.6)
Etiquetas:bazel_internal_configuration
--experimental_build_event_upload_strategy=<a string>
predeterminado: ver la 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_collect_load_average_in_profiler
: “verdadero” -
Si está habilitado, el generador de perfiles recopila el promedio general de carga del sistema.
Etiquetas:bazel_monitoring
- Valor predeterminado
--[no]experimental_collect_pressure_stall_indicators
: “falso” -
Si está habilitado, el generador de perfiles recopila los datos de PSI de Linux.
Etiquetas:bazel_monitoring
- Valor predeterminado
--[no]experimental_collect_resource_estimation
: “falso” -
Si está habilitado, el generador de perfiles recopila la estimación del uso de CPU y memoria para las acciones locales.
Etiquetas:bazel_monitoring
- Valor predeterminado
--[no]experimental_collect_system_network_usage
: “falso” - Si está habilitado, el generador de perfiles recopila el uso de red del sistema.
Etiquetas:bazel_monitoring
- Valor predeterminado
--[no]experimental_collect_worker_data_in_profiler
: “falso” -
Si está habilitado, el generador de perfiles recopila los datos de recursos agregados del trabajador.
Etiquetas:bazel_monitoring
- Se acumulan
--experimental_profile_additional_tasks=<phase, action, action_check, action_lock, action_release, action_update, action_complete, 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, action_cache_counts, local_cpu_usage, system_cpu_usage, cpu_usage_estimation, local_memory_usage, system_memory_usage, memory_usage_estimation, system_network_up_usage, system_network_down_usage, workers_memory_usage, system_load_average, starlark_parser, starlark_user_fn, starlark_builtin_fn, starlark_user_compiled_fn, starlark_repository_fn, action_fs_staging, remote_cache_check, remote_download, remote_network, filesystem_traversal, worker_execution, worker_setup, worker_borrow, worker_working, worker_copying_outputs, credential_helper, pressure_stall_io, pressure_stall_memory, dynamic_lock or unknown>
usos múltiples -
Especifica las tareas de perfil adicionales que se incluirán en el perfil.
Etiquetas:bazel_monitoring
- Valor predeterminado
--[no]experimental_profile_include_primary_output
: “falso” -
Incluye el atributo adicional "out" en los eventos que contienen la ruta de acceso de ejecución para la salida principal de la acción.
Etiquetas:bazel_monitoring
- Valor predeterminado
--[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:bazel_monitoring
- Valor predeterminado
--[no]experimental_stream_log_file_uploads
: “falso” -
Transmite los archivos de registro directamente al almacenamiento remoto en lugar de escribirlos en el disco.
Etiquetas:affects_outputs
--experimental_workspace_rules_log_file=<a path>
predeterminado: ver la descripción- Registra ciertos eventos de reglas de Workspace en este archivo como protos delimitados por WorkspaceEvent.
--[no]generate_json_trace_profile
predeterminado: “automático”-
Si se habilita, Bazel genera un perfil de la compilación y escribe un perfil en formato JSON en un archivo de la base de resultados. Ver perfil cargando en chrome://tracing. De forma predeterminada, Bazel escribe el perfil para todos los comandos y la consulta similares a la compilación.
Etiquetas:bazel_monitoring
- Valor predeterminado
--[no]heap_dump_on_oom
: “falso” -
Indica si se debe generar manualmente un volcado de montón si se arroja una OOM (incluidas las OOM debido a --experimental_oom_more_eagerly_Threshold). El volcado se escribirá en <output_base>/<invocation_id>.heapdump.hprof. Esta opción reemplaza efectivamente el error -XX:+HeapDumpOnOutOfMemoryError, que no tiene efecto porque los OOM se detectan y se redireccionan a Runtime#halt.
Etiquetas:bazel_monitoring
- Valor predeterminado de
--[no]legacy_important_outputs
: “verdadero” -
Úsalo para suprimir la generación del campo legacy_outputs heredado en el evento TargetComplete. Se requieren importantes_resultados para la integración de Bazel con ResultStore.
Etiquetas:affects_outputs
- Configuración predeterminada de
--logging=<0 <= an integer <= 6>
: "3" -
Es el nivel de registro.
Etiquetas:affects_outputs
--memory_profile=<a path>
predeterminado: ver la descripción-
Si se configura, escribe datos de uso de memoria en el archivo especificado en los extremos de la fase y el montón estable en el registro principal al final de la compilación.
Etiquetas:bazel_monitoring
- Valor predeterminado de
--memory_profile_stable_heap_parameters=<integers, separated by a comma expected in pairs>
: "1,0" - Ajusta el cálculo del perfil estable del montón estable al final de la compilación. Debe ser una cantidad par o entero de números enteros separados por comas. En cada par, el primer número entero es la cantidad de recolecciones de elementos no utilizados. El segundo número entero de cada par es la cantidad de segundos que se debe esperar entre las recolecciones de elementos no utilizados. P. ej., 2, 4, 4, 0 sería 2 GC con una pausa de 4 s, seguidas de 4 GC con una pausa de cero segundos.
Etiquetas:bazel_monitoring
--profile=<a path>
predeterminado: ver la descripción-
Si se configura, perfila Bazel y escribe datos en el archivo especificado. Usa el perfil de análisis de Bazel para analizar el perfil.
Etiquetas:bazel_monitoring
- Valor predeterminado
--[no]record_full_profiler_data
: “falso” -
De forma predeterminada, el generador de perfiles de Bazel solo registrará datos agregados para eventos rápidos, pero numerosos (como los archivos del archivo). Si esta opción está habilitada, el generador de perfiles registrará cada evento, lo que generará datos de generación de perfiles más precisos, pero un GRAN rendimiento. La opción solo tiene efecto si también se usa --profile.
Etiquetas:bazel_monitoring
- Valor predeterminado de
--remote_print_execution_messages=<failure, success or all>
: “error” -
Elige cuándo imprimir mensajes de ejecución remota. Los valores válidos son "failure", para imprimir solo con fallas y "success" para imprimir solo cuando se ejecuta correctamente, y "all" para imprimir siempre.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]slim_profile
: “verdadero” -
Reduce el tamaño del perfil de JSON fusionando eventos si el perfil se vuelve demasiado grande.
Etiquetas:bazel_monitoring
- Configuración predeterminada de
--starlark_cpu_profile=<a string>
: "" -
Escribe en el archivo especificado un perfil pprof del uso de la CPU de todos los subprocesos de Starlark.
Etiquetas:bazel_monitoring
- Configuración predeterminada de
--tool_tag=<a string>
: "" -
Es un nombre de herramienta al que se le 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 los eventos que se mostrarán en la IU. Es posible agregar o quitar eventos a los eventos predeterminados con el símbolo +/-, o anular completamente el conjunto predeterminado con la asignación directa. El conjunto de tipos de eventos compatibles incluye INFO, DEBUG, ERROR y otros.
Etiquetas:terminal_output
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_circuit_breaker_strategy=<failure>
predeterminado: ver la descripción-
Especifica la estrategia que debe usar el disyuntor. Las estrategias disponibles son “fallas”. Cuando el valor no es válido para la opción, el comportamiento es el mismo que el de la opción no configurada.
Etiquetas:execution
- Valor predeterminado
--[no]experimental_guard_against_concurrent_changes
: “falso” - Desactiva esta opción para inhabilitar la verificación del tiempo de archivo 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.
- Valor predeterminado
--[no]experimental_remote_cache_async
: “falso” - Si es verdadero, la E/S de la caché remota ocurrirá en segundo plano, en lugar de tener lugar como parte de una generación.
- Configuración predeterminada de
--experimental_remote_cache_ttl=<An immutable length of time.>
: "3 h" -
Es el TTL mínimo garantizado de BLOB en la caché remota después de que a sus resúmenes se les hizo referencia recientemente, p.ej., por un ActionResult o FindMissingBlobs. Bazel realiza varias optimizaciones basadas en el TTL de los BLOB, p.ej., no llama de manera repetida a GetActionResult en una compilación incremental. El valor debe establecerse un poco menos que el TTL real, ya que hay un intervalo entre el momento en que el servidor muestra los resúmenes y el momento en que Bazel los recibe.
Etiquetas:execution
--experimental_remote_capture_corrupted_outputs=<a path>
predeterminado: ver la descripción- Es una ruta de acceso a un directorio en el que se capturarán los resultados dañados.
- Valor predeterminado
--[no]experimental_remote_discard_merkle_trees
: “falso” - Si se establece como verdadero, descarta copias en la memoria del árbol Merkle de la raíz de entrada y las asignaciones de entrada asociadas durante las llamadas a GetActionResult() y Execute(). Esto reduce el uso de memoria de forma significativa, pero requiere que Bazel los vuelva a procesar cuando se produzcan errores de caché remota y los reintentos.
--experimental_remote_downloader=<a string>
predeterminado: ver la descripción- Un URI de extremo de la API de Remote Asset que se usará como proxy de descarga remota. Los esquemas admitidos son grpc, grpcs (grpc con TLS habilitado) y Unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel 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
--[no]experimental_remote_downloader_local_fallback
: “falso” - Indica si se volverá a la herramienta de descarga local si falla la descarga remota.
- Valor predeterminado
--[no]experimental_remote_execution_keepalive
: “falso” - Indica si se debe usar keepalive para las llamadas de ejecución remota.
- Configuración predeterminada de
--experimental_remote_failure_rate_threshold=<an integer in 0-100 range>
: “10” -
Establece la cantidad permitida de porcentaje de fallas en un período específico después de lo cual deja de llamar a la caché o al ejecutor remoto. De forma predeterminada, el valor es 10. Establecerlo en 0 significa que no hay limitación.
Etiquetas:execution
- Configuración predeterminada de
--experimental_remote_failure_window_interval=<An immutable length of time.>
: "60 s" -
El intervalo en el que se calcula la tasa de fallas de las solicitudes remotas. En un valor de cero o negativo, la duración de la falla se calcula en toda la ejecución.Las siguientes unidades se pueden usar: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
Etiquetas:execution
- Valor predeterminado
--[no]experimental_remote_mark_tool_inputs
: “falso” - Si se establece como verdadera, Bazel marcará las entradas como entradas de herramienta para el ejecutor remoto. Esto se puede usar para implementar trabajadores remotos remotos.
- Valor predeterminado
--[no]experimental_remote_merkle_tree_cache
: “falso” - Si se establece como verdadera, se calculan los cálculos del árbol de Merkle para mejorar la velocidad de comprobación de aciertos de caché remota. La impresión del pie de la memoria de la caché está controlada por --experimental_remote_merkle_tree_cache_size.
- Valor predeterminado de
--experimental_remote_merkle_tree_cache_size=<a long integer>
: "1000" - Es la cantidad de árboles Mermel que se deben memorizar para mejorar la velocidad de comprobación de aciertos de caché remota. A pesar de que la caché se reduce automáticamente según el manejo de Java de las referencias flexibles, los errores de memoria insuficiente se pueden producir si se configura demasiado alto. Si se establece en 0, el tamaño de la caché es ilimitado. El valor óptimo varía según el tamaño del proyecto. La configuración predeterminada es 1,000.
- Valor predeterminado
--[no]incompatible_remote_build_event_upload_respect_no_cache
: “falso” - Obsoleto. No-op. En su lugar, usa --remote_build_event_upload=minimal.
- Valor predeterminado de
--[no]incompatible_remote_disallow_symlink_in_tree_artifact
: “verdadero” -
Si se establece como verdadera, una acción ejecutada de forma remota no puede producir un artefacto de árbol que contenga un symlink relativo. No se permiten symlinks absolutos independientemente de esta marca.
Etiquetas:execution
,incompatible_change
- Valor predeterminado de
--[no]incompatible_remote_downloader_send_all_headers
: “verdadero” -
Indica si se deben enviar todos los valores de un encabezado de varios valores a la descarga remota, en lugar de solo al primero.
Etiquetas:incompatible_change
- Valor predeterminado
--[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
- Valor predeterminado de
--[no]incompatible_remote_results_ignore_disk
: “verdadero” -
Si se establece como verdadero, no se aplicarán --noremote_upload_local_results y --noremote_accept_cached a la caché de disco. Si se configuran tanto --disk_cache como --remote_cache (caché combinado):
--noremote_upload_local_results hará que se escriban los resultados en la caché de disco, pero no se subirán a la caché remota.
--noremote_accept_cached hará que Bazel revise los resultados en la caché de disco, pero no en la caché remota.
Las acciones no-remote-exec pueden alcanzar la caché del disco.
Consulta #8216 para obtener más detalles.
Etiquetas:incompatible_change
- Valor predeterminado de
--[no]remote_accept_cached
: “verdadero” - Indica si se deben aceptar los resultados de la acción almacenados en caché de forma remota.
- Configuración predeterminada de
--remote_build_event_upload=<all or minimal>
: “mínima” - Si se configura en "todos", todos los resultados locales a los que hace referencia 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 bytestream:// siempre se usa para el URI de los archivos, incluso si faltan en la caché remota. La configuración predeterminada es “minimal”.
--remote_bytestream_uri_prefix=<a string>
predeterminado: ver la descripción- Es el nombre de host y el nombre de instancia que se usarán en los URI de bytestream:// que se escribirán en las transmisiones de eventos de compilación. Esta opción se puede establecer cuando se realizan compilaciones mediante un proxy, lo que hace que los valores de --remote_executor y --remote_instance_name ya no correspondan al nombre canónico del servicio de ejecución remota. Si no se configura, el valor predeterminado será "${hostname}/${instance_name}".
--remote_cache=<a string>
predeterminado: ver la descripción- Un URI de un extremo de almacenamiento en caché. Los esquemas admitidos son http, https, grpc, grpcs (grpc con TLS habilitado) y Unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel se establecerá de forma predeterminada en grpcs. Especifica grpc://, http:// o unix: schema para inhabilitar TLS. Consulta https://bazel.build/remote/caching
- Valor predeterminado
--[no]remote_cache_compression
: “falso” - Si está habilitado, comprime o descomprime los BLOB de caché con zstd.
- 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 especificando la marca varias veces. Varios valores para el mismo nombre se convertirán en una lista separada por comas.
- Se acumulan
--remote_default_exec_properties=<a 'name=value' assignment>
usos múltiples -
Configura las propiedades Exec predeterminadas que se usarán como plataforma de ejecución remota si una plataforma de ejecución aún no establece exec_properties.
Etiquetas:affects_outputs
- Configuración predeterminada de
--remote_default_platform_properties=<a string>
: "" - Configura las propiedades de la plataforma predeterminadas que se establecerán para la API de ejecución remota si la plataforma de ejecución aún no configuró remota_execution_properties. Este valor también se usará si se selecciona la plataforma host como plataforma de ejecución para la ejecución remota.
- Se acumulan
--remote_downloader_header=<a 'name=value' assignment>
usos múltiples - Especifica un encabezado que se incluirá en las solicitudes de descarga remota: --remote_downloader_header=Name=Value. Se pueden pasar varios encabezados especificando la marca varias veces. Varios valores para el mismo nombre se convertirán en una lista separada por comas.
- Se acumulan
--remote_exec_header=<a 'name=value' assignment>
usos múltiples - Especifica un encabezado que se incluirá en las solicitudes de ejecución: --remote_exec_header=Name=Value. Se pueden pasar varios encabezados especificando la marca varias veces. Varios valores para el mismo nombre se convertirán en una lista separada por comas.
--remote_execution_priority=<an integer>
predeterminado: “0”- La prioridad relativa de las acciones que se ejecutarán de forma remota. La semántica de los valores de prioridad particulares depende del servidor.
--remote_executor=<a string>
predeterminado: ver la descripción- HOST o HOST:PORT de un extremo de ejecución remota. Los esquemas admitidos son grpc, grpcs (grpc con TLS habilitado) y Unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel se establecerá de forma predeterminada en grpcs. Especifica el esquema grpc:// o unix: para inhabilitar TLS.
--remote_grpc_log=<a path>
predeterminado: ver la descripción- Si se especifica, una ruta de acceso a un archivo para registrar los detalles relacionados con la llamada de gRPC. Este registro consiste en una secuencia de com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry protobufs serializados con cada prefijo precedido por un varino que denota el tamaño del siguiente mensaje protobuf serializado, como lo realiza el método LogEntry.writeDelimitedTo(OutputStream).
- Se acumulan
--remote_header=<a 'name=value' assignment>
usos múltiples - Especifica un encabezado que se incluirá en las solicitudes: --remote_header=Name=Value. Se pueden pasar varios encabezados especificando la marca varias veces. Varios valores para el mismo nombre se convertirán en una lista separada por comas.
- Configuración predeterminada de
--remote_instance_name=<a string>
: "" - Valor para pasar como instance_name en la API de ejecución remota.
- Valor predeterminado
--[no]remote_local_fallback
: “falso” - Indica si se debe recurrir a la estrategia de ejecución local independiente si falla la ejecución remota.
- Configuración predeterminada de
--remote_local_fallback_strategy=<a string>
: “local” - No-op, dejó de estar disponible. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/7480.
- Valor predeterminado de
--remote_max_connections=<an integer>
: "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 limitación.
Para la caché remota de 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 el ejecutor/caché 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 la descripción- Conéctate a la caché remota mediante 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.
- Configuración predeterminada de
--remote_retries=<an integer>
: “5” - Es la cantidad máxima de intentos para reintentar un error transitorio. Si se establece en 0, los reintentos están inhabilitados.
- Valor predeterminado de
--remote_retry_max_delay=<An immutable length of time.>
: “5 s” - Es el retraso máximo de retirada entre intentos de reintento remoto. 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.
- Configuración predeterminada de
--remote_timeout=<An immutable length of time.>
: "60 s" - La cantidad máxima de tiempo que se espera la ejecución remota y las llamadas en caché. Para la caché de REST, este es el tiempo de espera de la conexión y el 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.
- Valor predeterminado de
--[no]remote_upload_local_results
: “verdadero” - Indica si se deben subir los resultados de acciones ejecutadas de forma local a la caché remota si esta la admite y el usuario está autorizado para hacerlo.
- Valor predeterminado de
--[no]remote_verify_downloads
: “verdadero” - Si se establece 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.
- Opciones misceláneas, pero que no estén categorizadas de otra manera:
- Se acumulan
--build_metadata=<a 'name=value' assignment>
usos múltiples -
Son pares de clave-valor personalizados que se deben 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 en los archivos rc. Para cada <command>, también obtiene 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 equivalen se encuentran en los archivos de configuración tools/*.blazerc.
--curses=<yes, no or auto>
predeterminado: “automático”- Usa los controles del cursor de la terminal para minimizar el resultado del desplazamiento.
--disk_cache=<a path>
predeterminado: ver la descripción- Ruta de acceso a un directorio en el que Bazel puede leer y escribir acciones y resultados de acciones. Si el directorio no existe, se creará.
- Valor predeterminado
--[no]enable_platform_specific_config
: “falso” - Si es verdadero, Bazel capta las líneas de configuración específicas del SO del host de los archivos de bazelrc. Por ejemplo, si el SO del host es Linux y ejecutas una compilación de Bazel, Bazel toma líneas que comienzan con build:linux. Los identificadores de SO compatibles son linux, macos, windows, freebsd y openbsd. Habilitar esta marca equivale a usar --config=linux en Linux, --config=windows en Windows, etcétera.
- Se acumulan
--experimental_credential_helper=<Path to a credential helper. It may be absolute, relative to the PATH environment variable, or %workspace%-relative. The path be optionally prefixed by a scope followed by an '='. The scope is a domain name, optionally with a single leading '*' wildcard component. A helper applies to URIs matching its scope, with more specific scopes preferred. If a helper has no scope, it applies to every URI.>
usos múltiples - Configura un asistente de credenciales a fin de usarlo para recuperar credenciales de autorización a fin de recuperar repositorios, almacenar en caché y ejecutar de forma remota, y el servicio de eventos de compilación. Las credenciales proporcionadas por un asistente tienen prioridad sobre las que proporcionan --google_default_credentials, --google_credentials, un archivo .netrc o el parámetro auth a repository_ctx.download y repository_ctx.download_and_extract. Se puede especificar varias veces para configurar varios asistentes. Para obtener más información, consulta https://github.com/bazelbuild/proposals/blob/main/designs/2022-06-07-bazel-credential-helpers.md.
- Configuración predeterminada de
--experimental_credential_helper_cache_duration=<An immutable length of time.>
: "30 m" - Es el tiempo durante el cual se almacenan en caché las credenciales que proporciona un auxiliar de credenciales. La invocación con un valor diferente ajustará la vida útil de las entradas preexistentes; pasa cero para borrar la caché. Independientemente de esta marca, un comando limpio siempre borra la caché.
- Valor predeterminado de
--experimental_credential_helper_timeout=<An immutable length of time.>
: “10 s” - Configura el tiempo de espera para un auxiliar de credenciales. Los auxiliares de credenciales que no respondan dentro de este tiempo de espera fallarán la invocación.
- Valor predeterminado
--[no]experimental_skymeld_ui
: “falso” -
Muestra el progreso de la fase de análisis y ejecución cuando ambos se ejecutan de forma simultánea.
Etiquetas:terminal_output
- Valor predeterminado
--[no]experimental_windows_watchfs
: “falso” - Si es verdadero, la compatibilidad experimental de Windows con --watchfs está habilitada. De lo contrario, --watchfsis es una no-op en Windows. Asegúrate de habilitar también --watchfs.
- Configuración predeterminada de
--google_auth_scopes=<comma-separated list of options>
: “https://www.googleapis.com/auth/cloud-platform” - Es una lista separada por comas de los permisos de autenticación de Google Cloud.
--google_credentials=<a string>
predeterminado: ver la 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
--[no]google_default_credentials
: “falso” - Indica si se deben usar “credenciales predeterminadas de la aplicación de Google” para la autenticación. Consulta https://cloud.google.com/docs/authentication para obtener más detalles. Inhabilitada de forma predeterminada.
--grpc_keepalive_time=<An immutable length of time.>
predeterminado: ver la descripción- Configura pings keep-alive para las conexiones salientes de gRPC. Si se configura, Bazel envía pings después de este tiempo sin operaciones de lectura en la conexión, pero solo si hay al menos una llamada de gRPC pendiente. Los tiempos se tratan como segundo nivel de detalle; es un error establecer un valor inferior a un segundo. De forma predeterminada, los pings de keep-alive están inhabilitados. Antes de habilitar este parámetro de configuración, debes coordinar con el propietario del servicio. Por ejemplo, para configurar un valor de 30 segundos en esta marca, se debe hacer de la siguiente manera: grpc_keepalive_time=30s.
- Configuración predeterminada 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 de keep-alive están habilitados con --grpc_keepalive_time, Bazel agota el tiempo de espera de una conexión si no recibe una respuesta de ping después de tanto tiempo. Los tiempos se tratan como segundo nivel de detalle; es un error establecer un valor inferior a un segundo. Si los pings de keep-alive están inhabilitados, se ignora esta configuración.
- Valor predeterminado de
--[no]incompatible_disallow_symlink_file_to_dir
: “verdadero” -
Si se establece como verdadera, "ctx.actions.symlink" no permitirá la vinculación de archivos simbólicos a un directorio.
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]incompatible_remove_rule_name_parameter
: “verdadero” -
Si se establece como verdadera, no se puede llamar a `rule` con el parámetro `name`.
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado
--[no]progress_in_terminal_title
: “falso” - Muestra el progreso del comando en el título de la terminal. Es útil para ver lo que realiza Bazel cuando tienes varias pestañas de terminal.
- Valor predeterminado de
--[no]show_progress
: “verdadero” - Muestra mensajes de progreso durante una compilación.
- Configuración predeterminada de
--show_progress_rate_limit=<a double>
: “0.2” - Cantidad mínima de segundos entre los mensajes de progreso en el resultado.
- Valor predeterminado
--[no]show_timestamps
: “falso” - Incluir marcas de tiempo en los mensajes
--tls_certificate=<a string>
predeterminado: ver la descripción- Especifica una ruta de acceso a un certificado TLS en el que se confíe para firmar los certificados del servidor.
--tls_client_certificate=<a string>
predeterminado: ver la descripción- Especifica el certificado de cliente de TLS que usarás. También debes proporcionar una clave de cliente para habilitar la autenticación de clientes.
--tls_client_key=<a string>
predeterminado: ver la descripción- Especifica la clave de cliente TLS para su uso; también debes proporcionar un certificado de cliente a fin de habilitar la autenticación del cliente.
- Configuración predeterminada de
--ui_actions_shown=<an integer>
: "8" -
Es la 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 inferiores a 1 se asignan a 1.
Etiquetas:terminal_output
- Valor predeterminado
--[no]watchfs
: “falso” - En Linux o macOS, si es verdadero, Bazel intenta usar el servicio de observación de archivos del sistema operativo para detectar cambios locales, en lugar de analizar cada archivo en busca de un cambio. En Windows: por el momento, esta marca no es operativa, pero se puede habilitar junto con --experimental_windows_watchfs. En cualquier SO: El comportamiento no está definido si tu lugar de trabajo está en un sistema de archivos de red y los archivos se editan en una máquina remota.
Opciones de perfil de análisis
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Lugares adicionales en los que buscar archivos antes de acceder a la red para descargarlos
Etiquetas:bazel_internal_configuration
- Valor predeterminado
--[no]experimental_repository_cache_hardlinks
: “falso” -
Si se establece, la caché del repositorio vinculará el archivo mediante un acierto de caché, en lugar de copiarlo. El objetivo es ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
- Valor predeterminado
--[no]experimental_repository_cache_urls_as_default_canonical_id
: “falso” -
Si es verdadero, usa una string derivada de las URLs de descargas del repositorio como canonical_id si no se especifica. Esto provoca que los cambios en las URL generen una nueva descarga incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no hagan que la caché oculte los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, los reintentos están inhabilitados.
Etiquetas:experimental
- Configuración predeterminada de
--experimental_scale_timeouts=<a double>
: “1.0” -
Escala este tiempo en todos los tiempos de espera de las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que son más lentas que lo que espera el autor de la regla, sin cambiar el código fuente
Etiquetas:bazel_internal_configuration
,experimental
- Configuración predeterminada de
--http_connector_attempts=<an integer>
: "8" -
Es la cantidad máxima de intentos de descarga de HTTP.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--http_connector_retry_max_timeout=<An immutable length of time.>
: “0 s” -
Es el tiempo de espera máximo para los reintentos de descarga de HTTP. Si el valor es 0, no se define ningún tiempo de espera máximo.
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--http_timeout_scaling=<a double>
: “1.0” -
Escalar todos los tiempos de espera relacionados con las descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: ver la 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é; de lo contrario, se usará el valor predeterminado “<output_user_root>/cache/repos/v1”
Etiquetas:bazel_internal_configuration
- Valor predeterminado
--[no]repository_disable_download
: “falso” -
Si se configura, no se permite la descarga mediante ctx.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no está completamente inhabilitado. ctx.execute puede ejecutar un ejecutable arbitrario que accede a Internet.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de la compilación:
- Valor predeterminado de
--experimental_oom_more_eagerly_threshold=<an integer in 0-100 range>
: "100" -
Si esta marca se establece en un valor inferior a 100, Bazel se encontrará OOM si después de dos recolecciones completas, se ocupa más de este porcentaje del montón (generación anterior).
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan cómo se aplica estrictamente Bazel a las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etc.):
- Configuración predeterminada de
--experimental_repository_hash_file=<a string>
: "" -
Si no está vacío, especifica un archivo que contiene un valor resuelto, con 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 se trata de una lista de reglas de repositorio para las que se debe verificar el hash del directorio de salida, se debe proporcionar un archivo mediante --experimental_repository_hash_file.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje de Starlark o de la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE:
- Valor predeterminado de
--[no]experimental_allow_top_level_aspects_parameters
: “verdadero” -
No-op
Etiquetas:no_op
,deprecated
,experimental
- 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 dependencia resuelto, incluso si se declaran con hilos en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones con errores harán que la resolución falle. También puedes definir una versión con un permiso permitido con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puede inhabilitar esta comprobación con la palabra clave "todos" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: “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 de `bazel_dep` directas declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencia resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para mostrar una advertencia cuando se detecta una discrepancia o "error" para derivarlo a una falla de resolución.
Etiquetas:loading_and_analysis
- Valor predeterminado
--[no]ignore_dev_dependency
: “falso” -
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en el MODULE.bazel del módulo raíz. Tenga en cuenta que esas dependencias para desarrolladores siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- Configuración predeterminada de
--lockfile_mode=<off, update or error>
: "desactivado" -
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "error" para usar el archivo de bloqueo, pero arroja un error si no está actualizado o "off" para evitar leer el archivo o escribir en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local con el formato <module name>=<path>. Si la ruta específica es absoluta, se usará tal como está. Si la ruta específica es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso determinada comienza con “%workspace%”, se relaciona con la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo recurrirán a los registros posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que activan optimizaciones del tiempo de compilación:
- Configuración predeterminada de
--experimental_gc_thrashing_limits=<comma separated pairs of <period>:<count>>
: "" -
Limita qué, si se alcanza, hace que GcThrashingDetector falle Bazel con un OOM. Cada límite se especifica como <período>:<count>, donde el período es una duración y el recuento es un número entero positivo. Si se supera el <count> GC total consecutivo de <period> consecutivos, se activará una cantidad superior al --experimental_oom_more_eagerly_Threshold por ciento del espacio titular (heap de generación anterior). Se pueden especificar varios límites separados por comas.
Etiquetas:host_machine_resource_optimizations
- Valor predeterminado de
--[no]gc_thrashing_limits_retained_heap_limiter_mutually_exclusive
: “verdadero” -
Si es verdadero, la especificación de --experimental_gc_thrashing_limits no vacía desactiva el RetainedHeapLimiter para que sea mutuamente excluyente con GcThrashingDetector. Si se establece como falsa, ambas pueden estar activas para el mismo comando.
Etiquetas:host_machine_resource_optimizations
- Configuración predeterminada de
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
: “2147483647” -
Marca que indica la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que su porcentaje de uso de montón retenido supera el umbral establecido por --skyframe_high_water_mark_Threshold, cuando se produzca un evento de recolección de elementos no utilizados total, se eliminará el estado temporal de Skyframe innecesario, hasta muchas veces por invocación. La configuración predeterminada es un número entero.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos de recolección de elementos no utilizados nunca activarán disminuciones. Si se alcanza el límite, ya no se eliminará el estado de Skyframe cuando se produzca un evento de recolección de elementos no utilizados completo y se supere el umbral del porcentaje del montón retenido.
Etiquetas:host_machine_resource_optimizations
- Configuración predeterminada de
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
: “2147483647” -
Marca que indica la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que su porcentaje de uso de montón retenido supera el umbral que establece --skyframe_high_water_mark_Threshold, cuando se produzca un evento de recolección de elementos no utilizados menor, se eliminará el estado temporal de Skyframe innecesario, hasta muchas veces por invocación. La configuración predeterminada es un número entero.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos de recolección de elementos no utilizados menores nunca activarán disminuciones. Si se alcanza el límite, ya no se eliminará el estado de Skyframe cuando se produzca un evento de recolección de elementos no utilizados menor y se supere el umbral del porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
- Configuración predeterminada de
--skyframe_high_water_mark_threshold=<an integer>
: “85” -
Marca que indica la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que su uso del montón retenido es al menos este umbral, dejará de ser necesario el estado temporal de Skyframe. Ajustar esto le permite mitigar el impacto de la hiperpaginación en la recolección de elementos no utilizados, cuando la hiperpaginación de GC es (i) causada por el uso de memoria de este estado temporal y (ii) más costosa que reconstituir el estado cuando es necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
--dump=<text or raw>
[-d
] predeterminado: ver la descripción-
vacía el volcado de los datos de perfil completo, ya sea en formato de texto legible o en formato "sin procesar" compatible con secuencias de comandos.
Etiquetas:affects_outputs
- Valor predeterminado
--[no]experimental_command_profile
: “falso” - Registra un perfil de CPU de Grabadora de vuelo en Java en un archivo profile.jfr en el directorio base de salida. La sintaxis y la semántica de esta marca puede cambiar en el futuro para admitir diferentes tipos de perfiles o formatos de salida; úsala bajo tu propia responsabilidad.
- Valor predeterminado
--[no]experimental_record_metrics_for_all_mnemonics
: “falso” - De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 nombres mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si eliges esta opción, se escribirán estadísticas para todos los nombres mnemotécnicos.
- Opciones para especificar o alterar una entrada genérica en un comando de Bazel que no pertenece a otras categorías:
- Configuración predeterminada de
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Si no está vacío, lea el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remota:
--experimental_downloader_config=<a string>
predeterminado: ver la descripción- Especifica un archivo para configurar el software de descarga remota. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para que coincida y otro para usar como URL sustituta, con referencias inversas a partir de "$1". Es posible proporcionar varias directivas "rewrite" para la misma URL, y en este caso se mostrarán varias.
- Configuración predeterminada de
--experimental_worker_for_repo_fetching=<off, platform or virtual>
: "desactivado" - Es el modo de subprocesos para usar en la recuperación de repositorios. Si se configura como "desactivada", no se usa ningún subproceso de trabajo, y la recuperación del repositorio está sujeta a reinicios. De lo contrario, usa un subproceso de plataforma (es decir, subproceso de SO) si se configura como “plataforma” o un subproceso virtual si se configura como “virtual”.
- Opciones misceláneas, pero que no estén categorizadas de otra manera:
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local con el formato <nombre del repositorio>=<ruta>. Si la ruta específica es absoluta, se usará tal como está. Si la ruta dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso determinada comienza con “%workspace%”, se relaciona con la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
Opciones de consulta
Hereda todas las opciones de la compilación.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Lugares adicionales en los que buscar archivos antes de acceder a la red para descargarlos
Etiquetas:bazel_internal_configuration
- Valor predeterminado
--[no]experimental_repository_cache_hardlinks
: “falso” -
Si se establece, la caché del repositorio vinculará el archivo mediante un acierto de caché, en lugar de copiarlo. El objetivo es ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
- Valor predeterminado
--[no]experimental_repository_cache_urls_as_default_canonical_id
: “falso” -
Si es verdadero, usa una string derivada de las URLs de descargas del repositorio como canonical_id si no se especifica. Esto provoca que los cambios en las URL generen una nueva descarga incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no hagan que la caché oculte los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, los reintentos están inhabilitados.
Etiquetas:experimental
- Configuración predeterminada de
--experimental_scale_timeouts=<a double>
: “1.0” -
Escala este tiempo en todos los tiempos de espera de las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que son más lentas que lo que espera el autor de la regla, sin cambiar el código fuente
Etiquetas:bazel_internal_configuration
,experimental
- Configuración predeterminada de
--http_connector_attempts=<an integer>
: "8" -
Es la cantidad máxima de intentos de descarga de HTTP.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--http_connector_retry_max_timeout=<An immutable length of time.>
: “0 s” -
Es el tiempo de espera máximo para los reintentos de descarga de HTTP. Si el valor es 0, no se define ningún tiempo de espera máximo.
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--http_timeout_scaling=<a double>
: “1.0” -
Escalar todos los tiempos de espera relacionados con las descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: ver la 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é; de lo contrario, se usará el valor predeterminado “<output_user_root>/cache/repos/v1”
Etiquetas:bazel_internal_configuration
- Valor predeterminado
--[no]repository_disable_download
: “falso” -
Si se configura, no se permite la descarga mediante ctx.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no está completamente inhabilitado. ctx.execute puede ejecutar un ejecutable arbitrario que accede a Internet.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de la compilación:
- Valor predeterminado de
--experimental_oom_more_eagerly_threshold=<an integer in 0-100 range>
: "100" -
Si esta marca se establece en un valor inferior a 100, Bazel se encontrará OOM si después de dos recolecciones completas, se ocupa más de este porcentaje del montón (generación anterior).
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan cómo se aplica estrictamente Bazel a las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etc.):
- Configuración predeterminada de
--experimental_repository_hash_file=<a string>
: "" -
Si no está vacío, especifica un archivo que contiene un valor resuelto, con 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 se trata de una lista de reglas de repositorio para las que se debe verificar el hash del directorio de salida, se debe proporcionar un archivo mediante --experimental_repository_hash_file.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje de Starlark o de la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE:
- Valor predeterminado de
--[no]experimental_allow_top_level_aspects_parameters
: “verdadero” -
No-op
Etiquetas:no_op
,deprecated
,experimental
- Opciones relacionadas con la semántica y el resultado de la consulta:
--aspect_deps=<off, conservative or precise>
predeterminado: “conservador”-
Cómo resolver dependencias de aspectos cuando el formato de salida es uno de {xml,proto,record}. "off" significa que no se resuelven dependencias de aspecto, "conservative" (la configuración predeterminada) significa que se agregan todas las dependencias de aspecto declaradas, independientemente de si tienen la clase de regla de dependencias directas. "Precise" 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 solo destino y, por lo tanto, que sea más lento que los otros modos. Además, tenga en cuenta que ni el modo exacto es completamente preciso: la decisión de calcular un aspecto se decide en la fase de análisis, que no se ejecuta durante la "consulta de Bazel".
Etiquetas:build_file_semantics
- Valor predeterminado de
--[no]deduplicate_depsets
: “verdadero” -
Anula el duplicado de los elementos secundarios que no sean 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 una superior superior. Esto no afecta la lista efectiva final de los artefactos de entrada de las acciones.
Etiquetas:terminal_output
- Valor predeterminado
--[no]experimental_parallel_aquery_output
: “falso” - Indica si la salida de proto/textproto de la consulta debe escribirse en paralelo. No-op para los otros formatos de salida.
- Valor predeterminado de
--[no]graph:factored
: “verdadero” -
Si es verdadero, el grafo se emitirá como “factorizado”, es decir, los nodos topológicamente equivalentes se combinarán y sus etiquetas se concatenarán. Esta opción solo se aplica a --output=gráfico.
Etiquetas:terminal_output
- Configuración predeterminada de
--graph:node_limit=<an integer>
: “512” -
Es la longitud máxima de la string de etiqueta para un nodo del gráfico en el resultado. Las etiquetas más largas se truncarán. -1 significa que no hay truncamientos. Esta opción solo se aplica a --output=gráfico.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]implicit_deps
: “verdadero” -
Si se habilita, 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 BigQuery, esta opción controla el filtrado de las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
- Valor predeterminado de
--[no]include_artifacts
: “verdadero” -
Incluye los nombres de las entradas y salidas de la acción en la salida (posiblemente grande).
Etiquetas:terminal_output
- Valor predeterminado de
--[no]include_aspects
: “verdadero” -
query, cquery: si se deben incluir acciones generadas por aspectos en el resultado. query: no-op (se siguen siempre los aspectos).
Etiquetas:terminal_output
- Valor predeterminado de
--[no]include_commandline
: “verdadero” -
Incluye el contenido de las líneas de comando de acción en el resultado (es posible que sea grande).
Etiquetas:terminal_output
- Valor predeterminado
--[no]include_file_write_contents
: “falso” -
Incluye el contenido del archivo para las acciones FileWrite y SourceSymlinkManifest (potencialmente grandes).
Etiquetas:terminal_output
- Valor predeterminado
--[no]include_param_files
: “falso” -
Incluye el contenido de los archivos de parámetros que se usan en el comando (posiblemente grande). Nota: Si habilitas esta marca, se habilitará automáticamente la marca --include_commandline.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]incompatible_display_source_file_location
: “verdadero” -
Verdadero o 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
- Valor predeterminado de
--[no]incompatible_package_group_includes_double_slash
: “verdadero” -
Si se habilita, no se omitirá el “//” inicial al generar el atributo “packages” del paquete package_group.
Etiquetas:terminal_output
,incompatible_change
- Valor predeterminado
--[no]infer_universe_scope
: “falso” - Si no se establece y --universe_scope, se inferirá el 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 centradas en el universo (p.ej., “allrdeps”) no es lo que deseas, por lo que debes usar esta opción solo si sabes lo que estás haciendo. Consulta https://bazel.build/reference/query#sky-query para obtener detalles y ejemplos. Si se establece --universe_scope, se ignora el valor de esta opción. Nota: Esta opción solo se aplica a `query` (es decir, no "cquery").
Etiquetas:loading_and_analysis
- Valor predeterminado
--[no]line_terminator_null
: “falso” -
Indica si cada formato termina con \0 en lugar de de nueva línea.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]nodep_deps
: “verdadero” -
Si se habilita, las dependencias de los atributos “nodep” se incluirán en el gráfico de dependencias con el que opera la consulta. Un ejemplo común de un atributo "nodep" es "visibilidad". Ejecuta y analiza el resultado de “info build-language” para conocer todos los atributos de “nodep” en el lenguaje de compilación.
Etiquetas:build_file_semantics
- Configuración predeterminada de
--output=<a string>
: "texto" - El formato en el que se deben imprimir los resultados de la consulta. Los valores permitidos para una consulta son: text, textproto, proto, stream_proto y jsonproto.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:default_values
: “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
--[no]proto:definition_stack
: “falso” -
Propaga el campo proto Definition_stack, que registra para cada instancia de la regla la pila de llamadas de Starlark en el momento en que se definió la clase de la regla.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:flatten_selects
: “verdadero” -
Si se habilita, se aplanan los atributos configurables creados por select(). Para los tipos acoplados, la representación plana es una lista que contiene cada valor del mapa seleccionado solo una vez. Los tipos de escalar se acoplan a un valor nulo.
Etiquetas:build_file_semantics
- Valor predeterminado
--[no]proto:include_attribute_source_aspects
: “falso” -
Propaga el campo proto source_aspect_name de cada atributo con el aspecto de origen del que proviene (string vacía si no lo tenía).
Etiquetas:terminal_output
- Valor predeterminado
--[no]proto:include_synthetic_attribute_hash
: “falso” -
Indica si el atributo $internal_attr_hash se calcula y se propaga.
Etiquetas:terminal_output
- Valor predeterminado
--[no]proto:instantiation_stack
: “falso” -
Propaga la pila de llamadas de creación de instancias de cada regla. Ten en cuenta que esto requiere que la pila esté presente.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:locations
: “verdadero” -
Indica si se debe generar información de la 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 para incluir en la salida. La configuración predeterminada es todos los atributos. Configúrala como string vacía para no mostrar ningún atributo. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:rule_inputs_and_outputs
: “verdadero” -
Indica si se propagarán los campos rule_input y rule_output.
Etiquetas:terminal_output
- Configuración predeterminada de
--query_file=<a string>
: "" -
Si se establece, la consulta leerá la consulta del archivo que se nombra aquí, en lugar de hacerlo en la línea de comandos. Es un error especificar un archivo aquí y una consulta de la línea de comandos.
Etiquetas:changes_inputs
- Valor predeterminado
--[no]relative_locations
: “falso” -
Si es verdadero, la ubicación de los archivos BUILD en los resultados de XML y proto será relativa. De forma predeterminada, el resultado de ubicación es una ruta absoluta y no será coherente entre las máquinas. Puedes configurar esta opción como verdadera para obtener un resultado coherente en todas las máquinas.
Etiquetas:terminal_output
- Valor predeterminado
--[no]skyframe_state
: “falso” -
Sin realizar análisis adicionales, vuelque el gráfico de acción actual de Skyframe. Nota: Actualmente, no se puede especificar un destino con --skyframe_state. Esta marca solo está disponible con --output=proto o --output=textproto.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]tool_deps
: “verdadero” -
Consulta: Si está inhabilitada, las dependencias de la "configuración exec" no se incluirán en el gráfico de dependencias sobre el que opera la consulta. Una arista de dependencia de “configuración de exec”, como la de cualquier regla de “proto_library” al Compilador de protocolos, generalmente apunta a una herramienta ejecutada durante la compilación en lugar de a una parte del mismo programa de “destino”.
Consulta: Si se inhabilita, filtra todos los destinos configurados que cruzan una transición de ejecución del objetivo de nivel superior que descubrió este destino configurado. Esto significa que si el objetivo de nivel superior está en la configuración de destino, solo se mostrarán los objetivos configurados también en la configuración de destino. Si el destino de nivel superior está en la configuración de ejecución, solo se mostrarán los objetivos configurados. Esta opción NO excluirá las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
- Configuración predeterminada de
--universe_scope=<comma-separated list of options>
: "" -
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 objetivos especificados. Esta opción se usa para los comandos de consulta y cquery.
Para BigQuery, la entrada a esta opción son los objetivos en los que se crean 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: Si usas cquery, no especificar esta opción puede hacer que la compilación falle 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 dependencia resuelto, incluso si se declaran con hilos en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones con errores harán que la resolución falle. También puedes definir una versión con un permiso permitido con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puede inhabilitar esta comprobación con la palabra clave "todos" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: “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 de `bazel_dep` directas declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencia resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para mostrar una advertencia cuando se detecta una discrepancia o "error" para derivarlo a una falla de resolución.
Etiquetas:loading_and_analysis
- Valor predeterminado
--[no]ignore_dev_dependency
: “falso” -
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en el MODULE.bazel del módulo raíz. Tenga en cuenta que esas dependencias para desarrolladores siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- Configuración predeterminada de
--lockfile_mode=<off, update or error>
: "desactivado" -
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "error" para usar el archivo de bloqueo, pero arroja un error si no está actualizado o "off" para evitar leer el archivo o escribir en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local con el formato <module name>=<path>. Si la ruta específica es absoluta, se usará tal como está. Si la ruta específica es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso determinada comienza con “%workspace%”, se relaciona con la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo recurrirán a los registros posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que activan optimizaciones del tiempo de compilación:
- Configuración predeterminada de
--experimental_gc_thrashing_limits=<comma separated pairs of <period>:<count>>
: "" -
Limita qué, si se alcanza, hace que GcThrashingDetector falle Bazel con un OOM. Cada límite se especifica como <período>:<count>, donde el período es una duración y el recuento es un número entero positivo. Si se supera el <count> GC total consecutivo de <period> consecutivos, se activará una cantidad superior al --experimental_oom_more_eagerly_Threshold por ciento del espacio titular (heap de generación anterior). Se pueden especificar varios límites separados por comas.
Etiquetas:host_machine_resource_optimizations
- Valor predeterminado de
--[no]gc_thrashing_limits_retained_heap_limiter_mutually_exclusive
: “verdadero” -
Si es verdadero, la especificación de --experimental_gc_thrashing_limits no vacía desactiva el RetainedHeapLimiter para que sea mutuamente excluyente con GcThrashingDetector. Si se establece como falsa, ambas pueden estar activas para el mismo comando.
Etiquetas:host_machine_resource_optimizations
- Configuración predeterminada de
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
: “2147483647” -
Marca que indica la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que su porcentaje de uso de montón retenido supera el umbral establecido por --skyframe_high_water_mark_Threshold, cuando se produzca un evento de recolección de elementos no utilizados total, se eliminará el estado temporal de Skyframe innecesario, hasta muchas veces por invocación. La configuración predeterminada es un número entero.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos de recolección de elementos no utilizados nunca activarán disminuciones. Si se alcanza el límite, ya no se eliminará el estado de Skyframe cuando se produzca un evento de recolección de elementos no utilizados completo y se supere el umbral del porcentaje del montón retenido.
Etiquetas:host_machine_resource_optimizations
- Configuración predeterminada de
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
: “2147483647” -
Marca que indica la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que su porcentaje de uso de montón retenido supera el umbral que establece --skyframe_high_water_mark_Threshold, cuando se produzca un evento de recolección de elementos no utilizados menor, se eliminará el estado temporal de Skyframe innecesario, hasta muchas veces por invocación. La configuración predeterminada es un número entero.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos de recolección de elementos no utilizados menores nunca activarán disminuciones. Si se alcanza el límite, ya no se eliminará el estado de Skyframe cuando se produzca un evento de recolección de elementos no utilizados menor y se supere el umbral del porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
- Configuración predeterminada de
--skyframe_high_water_mark_threshold=<an integer>
: “85” -
Marca que indica la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que su uso del montón retenido es al menos este umbral, dejará de ser necesario el estado temporal de Skyframe. Ajustar esto le permite mitigar el impacto de la hiperpaginación en la recolección de elementos no utilizados, cuando la hiperpaginación de GC es (i) causada por el uso de memoria de este estado temporal y (ii) más costosa que reconstituir el estado cuando es necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Valor predeterminado
--[no]experimental_command_profile
: “falso” - Registra un perfil de CPU de Grabadora de vuelo en Java en un archivo profile.jfr en el directorio base de salida. La sintaxis y la semántica de esta marca puede cambiar en el futuro para admitir diferentes tipos de perfiles o formatos de salida; úsala bajo tu propia responsabilidad.
- Valor predeterminado
--[no]experimental_record_metrics_for_all_mnemonics
: “falso” - De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 nombres mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si eliges esta opción, se escribirán estadísticas para todos los nombres mnemotécnicos.
- Opciones para especificar o alterar una entrada genérica en un comando de Bazel que no pertenece a otras categorías:
- Configuración predeterminada de
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Si no está vacío, lea el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remota:
--experimental_downloader_config=<a string>
predeterminado: ver la descripción- Especifica un archivo para configurar el software de descarga remota. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para que coincida y otro para usar como URL sustituta, con referencias inversas a partir de "$1". Es posible proporcionar varias directivas "rewrite" para la misma URL, y en este caso se mostrarán varias.
- Configuración predeterminada de
--experimental_worker_for_repo_fetching=<off, platform or virtual>
: "desactivado" - Es el modo de subprocesos para usar en la recuperación de repositorios. Si se configura como "desactivada", no se usa ningún subproceso de trabajo, y la recuperación del repositorio está sujeta a reinicios. De lo contrario, usa un subproceso de plataforma (es decir, subproceso de SO) si se configura como “plataforma” o un subproceso virtual si se configura como “virtual”.
- Opciones misceláneas, pero que no estén categorizadas de otra manera:
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local con el formato <nombre del repositorio>=<ruta>. Si la ruta específica es absoluta, se usará tal como está. Si la ruta dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso determinada comienza con “%workspace%”, es relativo en la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Opciones que controlan la ejecución de la compilación:
- Valor predeterminado
--[no]experimental_inprocess_symlink_creation
: “falso” -
Hacer llamadas directas al sistema de archivos para crear árboles de symlink
Etiquetas:loading_and_analysis
,execution
,experimental
- Valor predeterminado
--[no]experimental_remotable_source_manifests
: “falso” -
Determina si se deben hacer acciones de manifiesto de manera remota.
Etiquetas:loading_and_analysis
,execution
,experimental
- Valor predeterminado
--[no]experimental_split_coverage_postprocessing
: “falso” -
Si es verdadero, Bazel ejecutará el procesamiento posterior de la cobertura para la prueba en una generación nueva.
Etiquetas:execution
- Valor predeterminado
--[no]experimental_strict_fileset_output
: “falso” -
Si se habilita esta opción, los conjuntos de archivos tratarán todos los artefactos de salida como archivos normales. No recorrerán directorios ni serán sensibles a los symlinks.
Etiquetas:execution
- Configuración predeterminada de
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
: "" -
Agrega o quita claves de la información de ejecución de una acción según los términos nemotécnicos de la acción. Solo se aplica a las acciones que admiten información de ejecución. Muchas acciones comunes admiten información de ejecución, p.ej., Genrule, CppCompile, Javac, StarlarkAction, TestRunner. Cuando se especifican varios valores, el orden es importante porque muchas regex se pueden aplicar al mismo valor mnemotécnico.
Sintaxis: "regex=[+-]key,regex=[+-]key,...".
Ejemplos: “.*=+x,.*=-y,.*=+z” agrega “x” y “z” y quita “y” de la información de ejecución para todas las acciones.
“Genrule=+requiere-x” agrega “requiere-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 sean de Genenrule.
Etiquetas:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Habilita acciones persistentes de expansión de sintaxis y Android dex mediante el uso de trabajadores.
Se expande a:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
- Habilita el procesador de recursos persistente de Android mediante trabajadores.
Se expande a las siguientes ubicaciones:
--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
{12/1}2{2/1/2} {14/1} {14/1}--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
host_machine_resource_optimizations
execution
--persistent_multiplex_android_dex_desugar
-
Habilita acciones multiplexadas y desugar de Android multiplexadas persistentes con trabajadores.
Se expande a:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
Habilita el procesador de recursos multiplexados persistentes de Android con trabajadores.
Se expande a las siguientes ubicaciones:
--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
{12/1}2{2/1/2} {14/1} {14/1}--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
host_machine_resource_optimizations
execution
--persistent_multiplex_android_tools
- Habilita herramientas para Android persistentes y multiplexadas (dexing, expansión de sintaxis, procesamiento de recursos).
Se expande a:
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Etiquetas:host_machine_resource_optimizations
,execution
- Valor predeterminado
--[no]use_target_platform_for_tests
: “falso” -
Si es verdadero, Bazel usará la plataforma de destino para ejecutar pruebas en lugar del grupo de ejecución de pruebas.
Etiquetas:execution
- Opciones que configuran la cadena de herramientas que se usa para la ejecución de la acción:
--android_compiler=<a string>
predeterminado: ver la descripción-
Es el compilador de destino de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Configuración predeterminada de
--android_crosstool_top=<a build target label>
: "//external:android/crosstool" -
Es la ubicación del compilador de C++ que se usa para las compilaciones de Android.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_grte_top=<a label>
predeterminado: ver la descripción-
El objetivo de Android: grte_top
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
- Configuración predeterminada de
--android_manifest_merger=<legacy, android or force_android>
: "android" -
Selecciona la combinación de manifiestos que se usará para las reglas android_binary. Marca para ayudar a realizar la transición a la combinación de manifiestos de Android desde la combinación heredada.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Configuración predeterminada de
--android_platforms=<a build target label>
: "" -
Establece las plataformas que usan los objetivos 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
- Configuración predeterminada de
--android_sdk=<a build target label>
: "@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 la descripción-
Es 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
- Configuración predeterminada de
--apple_crosstool_top=<a build target label>
: "@bazel_tools//tools/cpp:toolchain" -
Es la etiqueta del paquete crosstool que se usará en las reglas de Apple y Objc, así como sus dependencias.
Etiquetas:loses_incremental_state
,changes_inputs
--apple_grte_top=<a build target label>
predeterminado: ver la descripción-
El objetivo grte_top de Apple.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
- Configuración predeterminada de
--cc_output_directory_tag=<a string>
: "" -
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas:affects_outputs
,explicit_in_output_path
--compiler=<a string>
predeterminado: ver la descripción-
Es el compilador de C++ que se usará para compilar el destino.
Etiquetas:loading_and_analysis
,execution
- Configuración predeterminada de
--coverage_output_generator=<a build target label>
: "@bazel_tools//tools/test:lcov_merger" - Ubicación del objeto binario que se usa para procesar con posterioridad los informes de cobertura sin procesar. Actualmente, debe ser un grupo de archivos que contiene un solo archivo binario. La configuración predeterminada es “//tools/test:lcov_merger”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
- Configuración predeterminada de
--coverage_report_generator=<a build target label>
: "@bazel_tools//tools/test:coverage_report_generator" - Ubicación del objeto binario que se usa para generar informes de cobertura. Actualmente, debe ser un grupo de archivos que contiene un solo archivo binario. La configuración predeterminada es “//tools/test:coverage_report_generator”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
- Configuración predeterminada 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 de código. La configuración predeterminada es “//tools/test:coverage_support”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
- Configuración predeterminada de
--crosstool_top=<a build target label>
: "@bazel_tools//tools/cpp:toolchain" -
Es la etiqueta del paquete crosstool que se usará para compilar código C++.
Etiquetas:loading_and_analysis
,changes_inputs
,affects_outputs
--custom_malloc=<a build target label>
predeterminado: ver la 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 objetivos de valores con restricción separados por comas. Si un objetivo no coincide con ninguna expresión negativa y al menos una expresión positiva, la resolución de 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
- Valor predeterminado de
--[no]experimental_enable_objc_cc_deps
: “verdadero” -
Permite que las reglas objc_* dependan de cc_library, y cualquier dependencia de objc se compile con --cpu configurada en "ios_<--ios_cpu>" para cualquier valor en --ios_multi_cpu.
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado
--[no]experimental_include_xcode_execution_requirements
: “falso” -
Si está configurado, agrega un requisito de ejecución de “required-xcode:{version}” a cada acción de Xcode. Si la versión Xcode tiene una etiqueta con guion, también agrega un requisito de ejecución “required-xcode-label:{version_label}”.
Etiquetas:loses_incremental_state
,loading_and_analysis
,execution
- Valor predeterminado de
--[no]experimental_prefer_mutual_xcode
: “verdadero” -
Si es verdadero, usa la versión más reciente de Xcode que está disponible de forma local y remota. Si es falso o si no hay versiones mutuamente disponibles, usa la versión local de Xcode seleccionada mediante xcode-select.
Etiquetas:loses_incremental_state
- Configuración predeterminada de
--extra_execution_platforms=<comma-separated list of options>
: "" -
Son las plataformas disponibles como plataformas de ejecución para ejecutar acciones. Las plataformas se pueden especificar por objetivo exacto o como patrón de destino. Consideremos estas plataformas antes de las que se declare en el archivo WORKSPACE a través de registration_execution_platforms(). Esta opción solo se puede configurar una vez; las instancias posteriores anularán la configuración de marcas anterior.
Etiquetas:execution
- Se acumulan
--extra_toolchains=<comma-separated list of options>
usos múltiples -
Son las reglas que se deben considerar durante la resolución de la cadena de herramientas. Las cadenas de herramientas se pueden especificar por objetivo exacto o como patrón de destino. Las cadenas de herramientas se considerarán antes de las que se declaren en el archivo WORKSPACE a través deregister_toolchains().
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--grte_top=<a label>
predeterminado: ver la descripción-
Es una etiqueta para una biblioteca de libc registrada. La cadena de herramientas de Crosstool selecciona el valor predeterminado y casi nunca necesitas anularlo.
Etiquetas:action_command_lines
,affects_outputs
--host_compiler=<a string>
predeterminado: ver la descripción-
Es el compilador de C++ para usar en la compilación de hosts. Se ignora si no se configura --host_crosstool_top.
Etiquetas:loading_and_analysis
,execution
--host_crosstool_top=<a build target label>
predeterminado: ver la descripción-
De forma predeterminada, las opciones --crosstool_top y --compiler también se usan para la configuración de ejecución. Si se proporciona esta marca, Bazel usa el compilador y libc predeterminado para la crosstool_top determinada.
Etiquetas:loading_and_analysis
,changes_inputs
,affects_outputs
--host_grte_top=<a label>
predeterminado: ver la descripción-
Si se especifica, este parámetro de configuración anula el directorio de nivel superior de libc (--grte_top) para la configuración de ejecución.
Etiquetas:action_command_lines
,affects_outputs
- Configuración predeterminada de
--host_platform=<a build target label>
: “@local_config_platform//:host” -
Es la etiqueta de una regla de plataforma que describe el sistema host.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
- Valor predeterminado de
--[no]incompatible_disable_expand_if_all_available_in_flag_set
: “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
- Valor predeterminado de
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
: “verdadero” -
Si es verdadero, Bazel no habilitará las funciones de “host” y “no host” en la cadena de herramientas de c++ (consulta https://github.com/bazelbuild/bazel/issues/7407 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado
--[no]incompatible_enable_android_toolchain_resolution
: “falso” -
Usa la resolución de la cadena de herramientas con el fin de seleccionar el SDK de Android para las reglas de Android (Starlark y nativo)
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado
--[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
- Valor predeterminado de
--[no]incompatible_make_thinlto_command_lines_standalone
: “verdadero” -
Si es verdadero, Bazel no volverá a usar las líneas de comandos de acción de vínculo de C++ para indexar líneas de comandos 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
: “verdadero” -
Si es verdadero, las reglas integradas de ObjC obtendrán la información de vinculación de CcInfo en lugar de ObjcProvider. Consulta https://github.com/bazelbuild/bazel/issues/16939 para obtener más información y detalles sobre la migración.
Etiquetas:loading_and_analysis
,changes_inputs
,incompatible_change
- Valor predeterminado de
--[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain
: “verdadero” -
Si es verdadero, Bazel se quejará cuando se establezcan los atributos cc_toolchain.cpu y cc_toolchain.compiler (consulte las instrucciones de migración para https://github.com/bazelbuild/bazel/issues/7075).
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]incompatible_remove_legacy_whole_archive
: “verdadero” -
Si es verdadero, Bazel no vinculará las dependencias de la biblioteca como archivo completo de forma predeterminada (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener instrucciones de migración).
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]incompatible_require_ctx_in_configure_features
: “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 la cadena de herramientas lo admite. 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 la descripción-
Especifica la versión del SDK de iOS que se usará para compilar aplicaciones para iOS. Si no se especifica, se usará la versión predeterminada del SDK de iOS de "xcode_version".
Etiquetas:loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: ver la descripción-
Especifica la versión del SDK de macOS que se usará para compilar aplicaciones de ese sistema operativo. 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 la descripción-
Es la versión mínima del SO a la que se orienta tu compilación.
Etiquetas:loading_and_analysis
,affects_outputs
- Configuración predeterminada de
--platform_mappings=<a relative path>
: "" -
Es la ubicación de un archivo de asignación que describe qué plataforma usar si no se estableció ninguna o qué marcas configurar cuando ya existe una plataforma. Debe estar relacionado con la raíz del lugar de trabajo principal. La configuración predeterminada es “platform_mappings” (un archivo directamente debajo de la raíz del lugar de trabajo).
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
- Configuración predeterminada de
--platforms=<a build target label>
: "" -
Las etiquetas de las reglas de la plataforma que describen las plataformas de destino para el comando actual.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--python2_path=<a string>
predeterminado: ver la descripción-
Obsoleto, no-op. Inhabilitado por "--incompatible_use_python_toolchains".
Etiquetas:no_op
,deprecated
--python3_path=<a string>
predeterminado: ver la descripción-
Obsoleto, no-op. Inhabilitado por "--incompatible_use_python_toolchains".
Etiquetas:no_op
,deprecated
--python_path=<a string>
predeterminado: ver la descripción-
Es la ruta de acceso absoluta del intérprete de Python que se invoca 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 la descripción-
Es la etiqueta de un py_runtime que representa al intérprete de Python invocado para ejecutar los objetivos de Python en la plataforma de destino. Obsoleto; inhabilitado por --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: ver la descripción-
Especifica la versión del SDK de tvOS que se usará para compilar aplicaciones 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 la descripción-
Especifica la versión del SDK de watchOS para compilar aplicaciones de watchOS. Si no se especifica, se usará la versión predeterminada del SDK de watchOS desde "xcode_version".
Etiquetas:loses_incremental_state
--xcode_version=<a string>
predeterminado: ver la descripción-
Si se especifica, usa Xcode de la versión determinada para acciones de compilación relevantes. Si no se especifica, se usa la versión predeterminada del ejecutor de Xcode.
Etiquetas:loses_incremental_state
- Configuración predeterminada 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
--[no]apple_enable_auto_dsym_dbg
: “falso” -
Determina si deseas forzar la generación de archivos de símbolos de depuración (.dSYM) para las compilaciones de base de datos.
Etiquetas:affects_outputs
,action_command_lines
- Valor predeterminado
--[no]apple_generate_dsym
: “falso” -
Indica si se deben generar archivos de símbolos de depuración (.dSYM).
Etiquetas:affects_outputs
,action_command_lines
- Valor predeterminado de
--[no]build_runfile_links
: “verdadero” -
Si es verdadero, compile bosques de symlink de archivos de ejecución para todos los destinos. Si es falso, escribe solo manifiestos cuando sea posible.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]build_runfile_manifests
: “verdadero” -
Si es verdadero, escribe los manifiestos de archivos run para todos los destinos. Si es falso, omítela. No se ejecutarán las pruebas locales cuando sean falsas.
Etiquetas:affects_outputs
- Valor predeterminado
--[no]build_test_dwp
: “falso” -
Si se habilita, cuando se compilen pruebas de C++ de forma estática y con fisiones, también se compilará automáticamente el archivo .dwp para el objeto binario de prueba.
Etiquetas:loading_and_analysis
,affects_outputs
- Configuración predeterminada de
--cc_proto_library_header_suffixes=<comma-separated set of options>
: “.pb.h” -
Establece los prefijos de los archivos de encabezado que crea una cc_proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
- Configuración predeterminada de
--cc_proto_library_source_suffixes=<comma-separated set 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
--[no]experimental_proto_descriptor_sets_include_source_info
: “falso” - Ejecuta acciones adicionales para versiones alternativas de la API de Java en una biblioteca proto_.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
- Valor predeterminado
--[no]experimental_proto_extra_actions
: “falso” - Ejecuta acciones adicionales para versiones alternativas de la API de Java en una biblioteca proto_.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
- Valor predeterminado
--[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
--fission=<a set of compilation modes>
: "no" -
Especifica los modos de compilación que usan fisión para las compilaciones y vínculos de C++. Puede ser cualquier combinación de {'fastbuild', 'dbg', 'opt'} o los valores especiales 'yes' para habilitar todos los modos y 'no' para inhabilitar todos los modos.
Etiquetas:loading_and_analysis
,action_command_lines
,affects_outputs
- Valor predeterminado de
--[no]incompatible_always_include_files_in_data
: “verdadero” -
Si es verdadero, las reglas nativas agregan <code>DefaultInfo.files</code> de dependencias de datos a sus runfiles, lo que coincide con el comportamiento recomendado para las reglas de Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid).
Etiquetas:affects_outputs
,incompatible_change
- Valor predeterminado de
--[no]legacy_external_runfiles
: “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
--[no]objc_generate_linkmap
: “falso” -
Especifica si se debe generar un archivo de mapa de vínculo.
Etiquetas:affects_outputs
- Valor predeterminado
--[no]save_temps
: “falso” -
Si se establece, se guardarán los resultados temporales de gcc. Esto incluye archivos .s (código ensamblador), archivos .i (C procesados previamente) y archivos .ii (C++ procesados previamente).
Etiquetas:affects_outputs
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
- Se acumulan
--action_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica el conjunto de variables de entorno disponibles para las acciones con la configuración de destino. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación o por el par nombre=valor que establece el valor independientemente del entorno de invocación. Esta opción se puede usar varias veces. Para las opciones proporcionadas para la misma variable, se acumulan las últimas victorias y las opciones de variables diferentes.
Etiquetas:action_command_lines
- Configuración predeterminada de
--android_cpu=<a string>
: “armeabi-v7a” -
La CPU de destino de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Valor predeterminado
--[no]android_databinding_use_androidx
: “falso” -
Genera archivos de vinculación de datos compatibles con AndroidX. Esto solo se usa con la vinculación de datos v2.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Valor predeterminado
--[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
- Configuración predeterminada de
--android_dynamic_mode=<off, default or fully>
: "desactivado" -
Determina si las dependencias de C++ de las reglas de Android se vincularán de forma dinámica cuando un cc_binary no cree una biblioteca compartida de manera explícita. “default” significa que Bazel elegirá si se vinculará de forma dinámica. "completamente" significa que todas las bibliotecas se vincularán de manera dinámica. "off" significa que todas las bibliotecas se vincularán en su mayoría en modo estático.
Etiquetas:affects_outputs
,loading_and_analysis
- 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. ALPHABETICAL significa que los manifiestos se ordenan por ruta de acceso en relación con la ejecución de Execroot. ALPHABETICAL_BY_CONFIGURATION significa que los manifiestos se ordenan por rutas de acceso relativas al directorio de configuración dentro del directorio de salida. DEPENDENCY significa que los manifiestos se ordenan de acuerdo con el manifiesto de cada biblioteca que aparece antes de los manifiestos de sus dependencias.
Etiquetas:action_command_lines
,execution
- Valor predeterminado
--[no]android_resource_shrinking
: “falso” -
Habilita la reducción de recursos para los APK android_binary que usan ProGuard.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]build_python_zip
predeterminado: “automático”-
Crear un archivo ZIP ejecutable de Python; activado en Windows, desactivado en otras plataformas
Etiquetas:affects_outputs
- Se acumulan
--catalyst_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se pueden crear objetos binarios de Apple Catalyst.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Valor predeterminado
--[no]collect_code_coverage
: “falso” -
Si se especifica, Bazel instrumentará el código (mediante la instrumentación sin conexión cuando sea posible) y recopilará información de cobertura durante las pruebas. Solo se verán afectados los objetivos que coincidan con --instrumentation_filter. Por lo general, esta opción no se debe especificar directamente. En su lugar, se debe usar el comando "bazel cobertura".
Etiquetas:affects_outputs
- Configuración predeterminada de
--compilation_mode=<fastbuild, dbg or opt>
[-c
]: "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 fuente de 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
- Configuración predeterminada de
--cpu=<a string>
: "" -
La CPU de destino.
Etiquetas:changes_inputs
,affects_outputs
,explicit_in_output_path
--cs_fdo_absolute_path=<a string>
predeterminado: ver la descripción- Usa la información de perfil de CSFDO para optimizar la compilación. Especifica el nombre absoluto de ruta de acceso 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 la descripción-
Genera objetos binarios con instrumentación de FDO sensible al contexto. Con el compilador Clang/LLVM, también acepta el nombre del directorio bajo el cual se vuelcan los archivos de perfil sin procesar en el tiempo de ejecución.
Etiquetas:affects_outputs
--cs_fdo_profile=<a build target label>
predeterminado: ver la descripción-
Es el cs_fdo_profile que representa el perfil sensible al contexto que se usará para la optimización.
Etiquetas:affects_outputs
- Se acumulan
--cxxopt=<a string>
usos múltiples -
Opción adicional de pasar a GCC cuando se compilan archivos fuente C++.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--define=<a 'name=value' assignment>
usos múltiples -
Cada opción de definición define una asignación para una variable de compilación.
Etiquetas:changes_inputs
,affects_outputs
--dynamic_mode=<off, default or fully>
predeterminado: “default”-
Determina si los objetos binarios de C++ se vincularán de manera dinámica. “default” significa que Bazel elegirá si se vinculará de forma dinámica. "completamente" significa que todas las bibliotecas se vincularán de manera dinámica. "off" significa que todas las bibliotecas se vincularán en su mayoría en modo estático.
Etiquetas:loading_and_analysis
,affects_outputs
- Valor predeterminado de
--[no]enable_fdo_profile_absolute_path
: “verdadero” -
Si se establece, el uso de fdo_Absolute_profile_path generará un error.
Etiquetas:affects_outputs
--[no]enable_runfiles
predeterminado: “automático”-
Habilita el árbol de 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 -
Dejó de estar disponible y se reemplazó por otro. Usa action_listener para adjuntar una extra_action a las acciones de compilación existentes.
Etiquetas:execution
,experimental
- Valor predeterminado
--[no]experimental_android_compress_java_resources
: “falso” -
Comprime los recursos Java en APK
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
- Valor predeterminado
--[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
--[no]experimental_android_resource_shrinking
: “falso” -
Habilita la reducción de recursos para los APK android_binary que usan ProGuard.
Etiquetas:affects_outputs
,loading_and_analysis
- Valor predeterminado
--[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
- Valor predeterminado de
--experimental_objc_fastbuild_options=<comma-separated list of options>
: "-O0,-DDEBUG=1" -
Usa estas strings como opciones del compilador objc fastbuild.
Etiquetas:action_command_lines
- Valor predeterminado
--[no]experimental_omitfp
: “falso” -
Si es verdadero, usa libunwind para desenrollar la pila y compila con -fomit-frame-pointer y -faasync-unwind-tables.
Etiquetas:action_command_lines
,affects_outputs
,experimental
- Valor predeterminado
--[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 la CPU.
Etiquetas:affects_outputs
,experimental
- Valor predeterminado
--[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
- Configuración predeterminada de
--fat_apk_cpu=<comma-separated set of options>
: “armeabi-v7a” -
Esta opción habilita 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 las reglas android_binary.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Valor predeterminado
--[no]fat_apk_hwasan
: “falso” -
Indica si se deben crear divisiones de HWASAN.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--fdo_instrument=<a string>
predeterminado: ver la descripción-
Genera objetos binarios con instrumentación de FDO. Con el compilador Clang/LLVM, también acepta el nombre del directorio bajo el cual se vuelcan los archivos de perfil sin procesar en el tiempo de ejecución.
Etiquetas:affects_outputs
--fdo_optimize=<a string>
predeterminado: ver la 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 la descripción-
Usa sugerencias de carga previa de la caché.
Etiquetas:affects_outputs
--fdo_profile=<a build target label>
predeterminado: ver la 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 determinadas se habilitarán o inhabilitarán de forma predeterminada para los destinos compilados en la configuración de destino. Si especificas -<feature>, se inhabilitará la función. Los atributos negativos siempre anulan los positivos. Consulta también --host_features
Etiquetas:changes_inputs
,affects_outputs
- Valor predeterminado
--[no]force_pic
: “falso” -
Si se habilita, todas las compilaciones de C++ producen código independiente de posición ("-fPIC"), los vínculos prefieren bibliotecas compiladas previamente de PIC en lugar de bibliotecas que no son de PIC, y los vínculos producen ejecutables independientes de la posición ("-pie").
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan
--host_action_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica el conjunto de variables de entorno disponibles para las acciones con configuraciones de ejecución. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación o por el par nombre=valor que establece el valor independientemente del entorno de invocación. Esta opción se puede usar varias veces. Para las opciones proporcionadas para la misma variable, se acumulan las últimas victorias y las opciones de variables diferentes.
Etiquetas:action_command_lines
- Configuración predeterminada de
--host_compilation_mode=<fastbuild, dbg or opt>
: "opt" -
Especifica el modo en que se integrará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 de C cuando se compilan archivos de origen C (pero no de C++) en las configuraciones de ejecución.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--host_copt=<a string>
usos múltiples -
Opciones adicionales que se deben pasar al compilador C para las herramientas compiladas en las configuraciones de ejecución.
Etiquetas:action_command_lines
,affects_outputs
- Configuración predeterminada de
--host_cpu=<a string>
: "" -
Es la CPU del host.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan
--host_cxxopt=<a string>
usos múltiples -
Opciones adicionales que puedes pasar al compilador de C++ para herramientas compiladas en las configuraciones exec.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--host_features=<a string>
usos múltiples -
Las funciones determinadas estarán habilitadas o inhabilitadas de forma predeterminada para los destinos compilados en la configuración de ejecución. Si especificas -<feature>, se inhabilitará la función. Los atributos negativos siempre anulan los positivos.
Etiquetas:changes_inputs
,affects_outputs
--host_force_python=<PY2 or PY3>
predeterminado: ver la descripción-
Anula la versión de Python para la configuración de ejecución. Puede ser "PY2" o "PY3".
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan
--host_linkopt=<a string>
usos múltiples -
Opción adicional de pasar al vinculador cuando se vinculan herramientas en las configuraciones de ejecución.
Etiquetas:action_command_lines
,affects_outputs
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: ver la descripción-
Versión mínima compatible de macOS para los destinos de host. Si no se especifica, se usa “macos_sdk_version”.
Etiquetas:loses_incremental_state
- Se acumulan
--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 compilas ciertos archivos en las configuraciones de ejecución. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter representa una lista de patrones de expresión de inclusión y exclusión (también consulta --instrumentation_filter). Opción_1 a opción_n representa opciones de línea de comandos arbitrarias. Si una opción contiene una coma, se debe colocar una barra inversa. Las opciones pueden contener @. Solo se usa el primer @ 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 que puedes usar en swiftc para herramientas de ejecución.
Etiquetas:action_command_lines
,affects_outputs
- Valor predeterminado
--[no]incompatible_auto_exec_groups
: “falso” -
Cuando se habilita, se crea un grupo de ejecución automática para cada cadena de herramientas que usa una regla. Para que esto funcione, la regla debe especificar el parámetro “cadena” en sus acciones. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/17134.
Etiquetas:affects_outputs
,incompatible_change
- Valor predeterminado de
--[no]incompatible_avoid_conflict_dlls
: “verdadero” -
Si está habilitada, todas las bibliotecas dinámicas vinculadas a C++ (DLL) generadas por cc_library en Windows se renombrarán como name_{hash}.dll, en donde el hash se calcula en función del RepositoryName y la ruta del paquete de 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
- Valor predeterminado de
--[no]incompatible_merge_genfiles_directory
: “verdadero” -
Si es verdadero, el directorio genfiles se pliega en el directorio bin.
Etiquetas:affects_outputs
,incompatible_change
- Valor predeterminado
--[no]incompatible_use_host_features
: “falso” -
Si es verdadero, usa --features solo para la configuración de destino y --host_features para la configuración de ejecución.
Etiquetas:changes_inputs
,affects_outputs
,incompatible_change
- Valor predeterminado
--[no]instrument_test_targets
: “falso” - Cuando se habilita la cobertura, especifica si se deben considerar las reglas de prueba de instrumentación. Cuando se establece, se instrumentan las reglas de prueba incluidas por --instrumentation_filter. De lo contrario, las reglas de prueba siempre se excluyen de la instrumentación de cobertura.
Etiquetas:affects_outputs
- Configuración predeterminada de
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "-/javatests[/:],-/test/java[/:]" -
Cuando está habilitada la cobertura, solo se instrumentarán reglas con nombres incluidos en el filtro basado en regex especificado. En su lugar, se excluyen las reglas con el prefijo '-'. Ten en cuenta que solo se instrumentan reglas que no son de prueba, a menos que se habilite --instrument_test_targets.
Etiquetas:affects_outputs
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: ver la 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 ios_application. El resultado es un objeto binario universal que contiene todas las arquitecturas especificadas.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Valor predeterminado de
--[no]legacy_whole_archive
: “verdadero” -
Obsoleto y reemplazado por --incompatible_remove_legacy_whole_archive (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener más detalles). Cuando esté activado, use --whole-archive para las reglas cc_binary que tengan linkshared=True y linkstatic=True o --static en linkopt. 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 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 la descripción- Versión mínima compatible de macOS para los destinos. Si no se especifica, se usa “macos_sdk_version”.
Etiquetas:loses_incremental_state
- Valor predeterminado
--[no]objc_debug_with_GLIBCXX
: “falso” -
Si se establece y el modo de compilación se establece en "dbg", definirá GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC y GLIBCPP_CONCEPT_CHECKS.
Etiquetas:action_command_lines
- Valor predeterminado
--[no]objc_enable_binary_stripping
: “falso” -
Indica si se deben eliminar los símbolos y los códigos muertos en los objetos binarios vinculados. Se realizará la eliminación de objetos binarios si se especifican esta marca y --compilation_mode=opt.
Etiquetas:action_command_lines
- Se acumulan
--objccopt=<a string>
usos múltiples -
Opciones adicionales para pasar a gcc cuando se compilan archivos fuente 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 al compilar ciertos archivos. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter representa una lista de patrones de expresión de inclusión y exclusión (también consulta --instrumentation_filter). Opción_1 a opción_n representa opciones de línea de comandos arbitrarias. Si una opción contiene una coma, se debe colocar una barra inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la string. Ejemplo: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción -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 a backend de LTO (en --features=thin_lto) cuando se compilan ciertos objetos de backend. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter representa una lista de incluir y excluir patrones de expresión regular. option_1 a option_n significan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, se debe colocar una barra inversa. Las opciones pueden contener @. Solo se usa el primer @ 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 la descripción-
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas:loses_incremental_state
,affects_outputs
,loading_and_analysis
--propeller_optimize=<a build target label>
predeterminado: ver la descripción-
Usa la información del perfil de propulsor para optimizar el destino de compilación.Un perfil de propulsor debe tener al menos uno de dos archivos, un perfil de Cc y un perfil de ld. Esta marca acepta una etiqueta de compilación que debe hacer referencia a los archivos de entrada del perfil de 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 debe usarse como: --propeller_optimize=//a/b:propeller_profile
Etiquetas:action_command_lines
,affects_outputs
--propeller_optimize_absolute_cc_profile=<a string>
predeterminado: ver la descripción-
Es el nombre de ruta absoluta del archivo cc_profile para las compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
predeterminado: ver la descripción-
Nombre de ruta de acceso absoluto del archivo ld_profile para las compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
--run_under=<a prefix in front of command>
predeterminado: ver la descripción-
Es el prefijo que se insertará antes de los ejecutables para los comandos "test" y "run". Si el valor es "foo -bar" y la línea de comandos de ejecución es "test_binary -baz", la línea de comandos final es "foo -bar test_binary -baz".También puede ser una etiqueta para un destino ejecutable. Estos son algunos ejemplos: "valgrind", "strace", "strace -c", "valgrind --quiet --num-callers=20", "//package:target", "//package:target --options".
Etiquetas:action_command_lines
-
Si es verdadero, las bibliotecas nativas con funciones idénticas se compartirán entre diferentes destinos.
Etiquetas:loading_and_analysis
,affects_outputs
- Valor predeterminado
--[no]stamp
: “falso” -
Marca los objetos binarios con la fecha, el nombre de usuario, el nombre de host, la información del lugar de trabajo, etcétera.
Etiquetas:affects_outputs
- Predeterminado de
--strip=<always, sometimes or never>
: "A veces" -
Especifica si se deben quitar los objetos binarios y las bibliotecas compartidas (con "-Wl,--strip-debug"). El valor predeterminado de “a veces” significa quitar iff - --compilation_mode=fastbuild.
Etiquetas:affects_outputs
- Se acumulan
--stripopt=<a string>
usos múltiples -
Opciones adicionales para pasar a la eliminación cuando se genera un objeto binario "<name>.stripped".
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--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 deben 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 la descripción-
Versión de tvOS mínima compatible para 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 las que se pueden 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 la descripción-
Versión mínima compatible de watchOS para los simuladores y dispositivos de destino Si no se especifica, se usa “watchos_sdk_version”.
Etiquetas:loses_incremental_state
--xbinary_fdo=<a build target label>
predeterminado: ver la descripción-
Usa la información de perfil XbinaryFDO para optimizar la compilación. Especifica el nombre del perfil binario cruzado predeterminado. Cuando se use la opción junto con --fdo_instrument/--fdo_optimize/--fdo_profile, estas siempre prevalecerán como si xbinary_fdo nunca se especifique.
Etiquetas:affects_outputs
- Opciones que afectan cómo se aplica estrictamente Bazel a las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etc.):
- Configuración predeterminada de
--auto_cpu_environment_group=<a build target label>
: "" - Declara el entorno de grupo para usarlo en la asignación automática de valores de CPU a los valores de target_environment.
Etiquetas:changes_inputs
,loading_and_analysis
,experimental
- Valor predeterminado
--[no]check_licenses
: “falso” -
Verifica que las restricciones de licencias impuestas por los paquetes dependientes no entren en conflicto con los modos de distribución de los destinos que se compilan. De forma predeterminada, no se verifican las licencias.
Etiquetas:build_file_semantics
- Valor predeterminado de
--[no]check_visibility
: “verdadero” -
Si está inhabilitada, los errores de visibilidad en las dependencias de destino descienden a advertencias.
Etiquetas:build_file_semantics
- Valor predeterminado de
--[no]desugar_for_android
: “verdadero” -
Determina si es necesario desugar Java 8 de código de bytes antes de la conversión a DEX.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Valor predeterminado
--[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
- Valor predeterminado de
--[no]enforce_constraints
: “verdadero” -
Verifica los entornos con los que es compatible 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
--[no]experimental_allow_android_library_deps_without_srcs
: “falso” -
Marca para facilitar la transición de permitir la inhabilitación de reglas de android_library de srcs-less con dependencias. El depósito se debe limpiar para lanzarlo de forma predeterminada.
Etiquetas:eagerness_to_exit
,loading_and_analysis
- Valor predeterminado de
--[no]experimental_check_desugar_deps
: “verdadero” -
Indica si debes verificar correctamente la expansión de sintaxis correcta a nivel del objeto binario de Android.
Etiquetas:eagerness_to_exit
,loading_and_analysis
,experimental
- Configuración predeterminada de
--experimental_import_deps_checking=<off, warning or error>
: "DESACTIVADA" -
Cuando esté habilitado, verifique si se completaron las dependencias de aar_import. Esta aplicación puede dañar la compilación o solo generar advertencias.
Etiquetas:loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
predeterminado: “default”-
Si es verdadero, comprueba que un destino Java declare de manera explícita todos los destinos utilizados directamente como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
- Valor predeterminado
--[no]incompatible_check_testonly_for_output_files
: “falso” -
Si la opción está habilitada, busque solo la prueba de la regla de generación para los objetivos de los requisitos previos que son archivos de salida. Esto coincide con la verificación de visibilidad.
Etiquetas:build_file_semantics
,incompatible_change
- Valor predeterminado
--[no]incompatible_check_visibility_for_toolchains
: “falso” -
Si se habilita, la verificación de visibilidad también se aplica a las implementaciones de la cadena de herramientas.
Etiquetas:build_file_semantics
,incompatible_change
- Valor predeterminado
--[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 desde https://github.com/bazelbuild/rules_android
Etiquetas:eagerness_to_exit
,incompatible_change
- Valor predeterminado
--[no]incompatible_disable_native_apple_binary_rule
: “falso” -
No-op. Se mantiene aquí para ofrecer retrocompatibilidad.
Etiquetas:eagerness_to_exit
,incompatible_change
- Valor predeterminado de
--[no]incompatible_force_strict_header_check_from_starlark
: “verdadero” -
Si está habilitada, establezca una verificación de encabezado estricta en la API de Starlark
Etiquetas:loading_and_analysis
,changes_inputs
,incompatible_change
- Valor predeterminado de
--[no]incompatible_python_disable_py2
: “verdadero” -
Si es verdadero, usar la configuración de Python 2 generará un error. Esto incluye python_version=PY2, srcs_version=PY2 y srcs_version=PY2ONLY. Consulta https://github.com/bazelbuild/bazel/issues/15684 para obtener más información.
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]incompatible_validate_top_level_header_inclusions
: “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
--python_native_rules_allowlist=<a build target label>
predeterminado: ver la descripción-
Una lista de entidades permitidas (destino de package_group) que se usará al aplicar --incompatible_python_allowed_native_rules.
Etiquetas:loading_and_analysis
- Valor predeterminado
--[no]strict_filesets
: “falso” -
Si esta opción está habilitada, los conjuntos de archivos que cruzan los límites del paquete se informan como errores. No funciona cuando se inhabilita check_fileset_Dependencies_recursively.
Etiquetas:build_file_semantics
,eagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default>
predeterminado: “error”-
A menos que esté DESACTIVADA, verifica que un destino de proto_library declare de manera explícita todos los destinos usados directamente como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
- Configuración predeterminada de
--strict_public_imports=<off, warn, error, strict or default>
: "desactivado" -
A menos que esté DESACTIVADA, verifica que un destino de proto_library declare de manera explícita todos los destinos usados en "import public" como exportado.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
- Valor predeterminado
--[no]strict_system_includes
: “falso” -
Si es verdadero, también se deben declarar los encabezados que se encuentran a través del sistema que incluyen rutas (-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:
- Predeterminado de
--apk_signing_method=<v1, v2, v1_v2 or v4>
: “v1_v2”. -
Implementación para usar la firma de APK
Etiquetas:action_command_lines
,affects_outputs
,loading_and_analysis
- Valor predeterminado de
--[no]device_debug_entitlements
: “verdadero” -
Si se configura y el modo de compilación no es "opt", las apps de objc incluirán derechos de depuración al momento de firmar.
Etiquetas:changes_inputs
--ios_signing_cert_name=<a string>
predeterminado: ver la descripción-
Es el nombre del certificado que se usará para la firma de iOS. Si no la estableces, se recurrirá al perfil de aprovisionamiento. Puede ser la preferencia de identidad del llavero del certificado o (substring) del nombre común del certificado, según la página de manual del código (Firma IDENTITIES).
Etiquetas:action_command_lines
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación accesible para los archivos BUILD, los archivos .bzl o los archivos WORKSPACE:
- Valor predeterminado de
--[no]incompatible_disallow_legacy_py_provider
: “verdadero” -
No-op, pronto se quitará.
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado
--[no]incompatible_disallow_sdk_frameworks_attributes
: “falso” -
Si es verdadero, inhabilite los atributos sdk_frameworks y weak_sdk_frameworks en objc_library yobjc_import.
Etiquetas:build_file_semantics
,incompatible_change
- Valor predeterminado
--[no]incompatible_objc_alwayslink_by_default
: “falso” -
Si es verdadero, establezca el valor predeterminado para los atributos Alwayslink en objc_library y objc_import.
Etiquetas:build_file_semantics
,incompatible_change
- Valor predeterminado
--[no]incompatible_python_disallow_native_rules
: “falso” -
Cuando es verdadero, se produce un error cuando se usan las reglas py_* integradas. En su lugar, se deben usar las reglas rule_python. Consulta https://github.com/bazelbuild/bazel/issues/17773 para obtener más información e instrucciones de migración.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones que rigen el comportamiento del entorno o del ejecutor de pruebas:
- Valor predeterminado
--[no]allow_analysis_failures
: “falso” -
Si es verdadero, un error de análisis del destino de una regla da como resultado la propagación del destino de una instancia de AnalysisFailureInfo que contiene la descripción del error, en lugar de una falla de compilación.
Etiquetas:loading_and_analysis
,experimental
- Configuración predeterminada 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 for_analysis_testing. Si se supera ese límite, se producirá un error en la regla.
Etiquetas:loading_and_analysis
- Valor predeterminado
--[no]break_build_on_parallel_dex2oat_failure
: “falso” -
Si la verdadera falla de dex2oat hace que la compilación falle, en lugar de ejecutar dex2oat durante el tiempo de ejecución de prueba.
Etiquetas:loading_and_analysis
,experimental
- Valor predeterminado
--[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
--[no]ios_memleaks
: “falso” -
Habilita la verificación de fugas de memoria en destinos ios_test.
Etiquetas:action_command_lines
--ios_simulator_device=<a string>
predeterminado: ver la descripción-
Es el dispositivo que se 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 la descripción-
Es la versión de iOS que se ejecuta en el simulador cuando se ejecuta o realiza una prueba. 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 ejecuta cada prueba. Si alguno de esos intentos falla por cualquier motivo, se considerará que falló toda la prueba. Normalmente, el valor especificado es solo un número entero. Ejemplo: --runs_per_test=3 ejecutará todas las pruebas 3 veces. Sintaxis alternativa: regex_filter@runs_per_test. Donde, run_per_test significa un valor de número entero y regex_filter significa una lista de patrones de expresión de inclusión y exclusión (también consulta --instrumentation_filter). Ejemplo: --runs_per_test=//foo/.*,-//foo/bar/.*@3 ejecuta todas las pruebas en //foo/, excepto las de foo/bar tres veces. Esta opción se puede pasar varias veces. Tiene prioridad el argumento que se pasó más recientemente y que coincide. De lo contrario, la prueba solo se ejecutará una vez.
- Se acumulan
--test_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica variables de entorno adicionales que se insertarán en el entorno del ejecutor de pruebas. Las variables se pueden especificar por nombre, en cuyo caso se leerá su valor del entorno del cliente de Bazel, o bien por el par nombre=valor. Esta opción se puede usar varias veces para especificar varias variables. Solo se usa con el comando “bazel test”.
Etiquetas:test_runner
- Valor predeterminado de
--test_timeout=<a single integer or comma-separated list of 4 integers>
: "-1" - Anula los valores predeterminados de tiempo de espera de la prueba para los tiempos de espera de la prueba (en segundos). Si se especifica un solo valor entero positivo, se anularán todas las categorías. Si se especifican 4 números enteros separados por comas, se anularán los tiempos de espera para el corto, el moderado, el largo y el eterno (en ese orden). En cualquier forma, el valor -1 le indica al blaze que use los tiempos de espera predeterminados para esa categoría.
--tvos_simulator_device=<a string>
predeterminado: ver la descripción-
Es el dispositivo que se simulará cuando se ejecuta 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 la descripción-
Es la versión de tvOS que se ejecutará en el simulador cuando se ejecute o realice pruebas.
Etiquetas:test_runner
--watchos_simulator_device=<a string>
predeterminado: ver la descripción-
Es el dispositivo que se 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 la descripción-
Es la versión de watchOS que se ejecutará en el simulador cuando se ejecute o realice pruebas.
Etiquetas:test_runner
- Valor predeterminado de
--[no]zip_undeclared_test_outputs
: “verdadero” -
Si es verdadero, los resultados de la prueba no declarados se archivarán en un archivo ZIP.
Etiquetas:test_runner
- Opciones relacionadas con el resultado de la consulta y la semántica:
--aspect_deps=<off, conservative or precise>
predeterminado: “conservador”-
Cómo resolver dependencias de aspectos cuando el formato de salida es uno de {xml,proto,record}. "off" significa que no se resuelven dependencias de aspecto, "conservative" (la configuración predeterminada) significa que se agregan todas las dependencias de aspecto declaradas, independientemente de si tienen la clase de regla de dependencias directas. "Precise" 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 solo destino y, por lo tanto, que sea más lento que los otros modos. Además, tenga en cuenta que ni el modo exacto es completamente preciso: la decisión de calcular un aspecto se decide en la fase de análisis, que no se ejecuta durante la "consulta de Bazel".
Etiquetas:build_file_semantics
- Valor predeterminado de
--[no]deduplicate_depsets
: “verdadero” -
Anula el duplicado de los elementos secundarios que no sean 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 una superior superior. Esto no afecta la lista efectiva final de los artefactos de entrada de las acciones.
Etiquetas:terminal_output
- Valor predeterminado
--[no]experimental_parallel_aquery_output
: “falso” - Indica si la salida de proto/textproto de la consulta debe escribirse en paralelo. No-op para los otros formatos de salida.
- Valor predeterminado de
--[no]graph:factored
: “verdadero” -
Si es verdadero, el grafo se emitirá como “factorizado”, es decir, los nodos topológicamente equivalentes se combinarán y sus etiquetas se concatenarán. Esta opción solo se aplica a --output=gráfico.
Etiquetas:terminal_output
- Configuración predeterminada de
--graph:node_limit=<an integer>
: “512” -
Es la longitud máxima de la string de etiqueta para un nodo del gráfico en el resultado. Las etiquetas más largas se truncarán. -1 significa que no hay truncamientos. Esta opción solo se aplica a --output=gráfico.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]implicit_deps
: “verdadero” -
Si se habilita, 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 BigQuery, esta opción controla el filtrado de las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
- Valor predeterminado de
--[no]include_artifacts
: “verdadero” -
Incluye los nombres de las entradas y salidas de la acción en la salida (posiblemente grande).
Etiquetas:terminal_output
- Valor predeterminado de
--[no]include_aspects
: “verdadero” -
query, cquery: si se deben incluir acciones generadas por aspectos en el resultado. query: no-op (se siguen siempre los aspectos).
Etiquetas:terminal_output
- Valor predeterminado de
--[no]include_commandline
: “verdadero” -
Incluye el contenido de las líneas de comando de acción en el resultado (es posible que sea grande).
Etiquetas:terminal_output
- Valor predeterminado
--[no]include_file_write_contents
: “falso” -
Incluye el contenido del archivo para las acciones FileWrite y SourceSymlinkManifest (potencialmente grandes).
Etiquetas:terminal_output
- Valor predeterminado
--[no]include_param_files
: “falso” -
Incluye el contenido de los archivos de parámetros que se usan en el comando (posiblemente grande). Nota: Si habilitas esta marca, se habilitará automáticamente la marca --include_commandline.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]incompatible_display_source_file_location
: “verdadero” -
Verdadero o 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
- Valor predeterminado de
--[no]incompatible_package_group_includes_double_slash
: “verdadero” -
Si se habilita, no se omitirá el “//” inicial al generar el atributo “packages” del paquete package_group.
Etiquetas:terminal_output
,incompatible_change
- Valor predeterminado
--[no]infer_universe_scope
: “falso” - Si no se establece y --universe_scope, se inferirá el 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 centradas en el universo (p.ej., “allrdeps”) no es lo que deseas, por lo que debes usar esta opción solo si sabes lo que estás haciendo. Consulta https://bazel.build/reference/query#sky-query para obtener detalles y ejemplos. Si se establece --universe_scope, se ignora el valor de esta opción. Nota: Esta opción solo se aplica a `query` (es decir, no "cquery").
Etiquetas:loading_and_analysis
- Valor predeterminado
--[no]line_terminator_null
: “falso” -
Indica si cada formato termina con \0 en lugar de de nueva línea.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]nodep_deps
: “verdadero” -
Si se habilita, las dependencias de los atributos “nodep” se incluirán en el gráfico de dependencias con el que opera la consulta. Un ejemplo común de un atributo "nodep" es "visibilidad". Ejecuta y analiza el resultado de “info build-language” para conocer todos los atributos de “nodep” en el lenguaje de compilación.
Etiquetas:build_file_semantics
- Configuración predeterminada de
--output=<a string>
: "texto" - El formato en el que se deben imprimir los resultados de la consulta. Los valores permitidos para una consulta son: text, textproto, proto, stream_proto y jsonproto.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:default_values
: “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
--[no]proto:definition_stack
: “falso” -
Propaga el campo proto Definition_stack, que registra para cada instancia de la regla la pila de llamadas de Starlark en el momento en que se definió la clase de la regla.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:flatten_selects
: “verdadero” -
Si se habilita, se aplanan los atributos configurables creados por select(). Para los tipos acoplados, la representación plana es una lista que contiene cada valor del mapa seleccionado solo una vez. Los tipos de escalar se acoplan a un valor nulo.
Etiquetas:build_file_semantics
- Valor predeterminado
--[no]proto:include_attribute_source_aspects
: “falso” -
Propaga el campo proto source_aspect_name de cada atributo con el aspecto de origen del que proviene (string vacía si no lo tenía).
Etiquetas:terminal_output
- Valor predeterminado
--[no]proto:include_synthetic_attribute_hash
: “falso” -
Indica si el atributo $internal_attr_hash se calcula y se propaga.
Etiquetas:terminal_output
- Valor predeterminado
--[no]proto:instantiation_stack
: “falso” -
Propaga la pila de llamadas de creación de instancias de cada regla. Ten en cuenta que esto requiere que la pila esté presente.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:locations
: “verdadero” -
Indica si se debe generar información de la 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 para incluir en la salida. La configuración predeterminada es todos los atributos. Configúrala como string vacía para no mostrar ningún atributo. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:rule_inputs_and_outputs
: “verdadero” -
Indica si se propagarán los campos rule_input y rule_output.
Etiquetas:terminal_output
- Configuración predeterminada de
--query_file=<a string>
: "" -
Si se establece, la consulta leerá la consulta del archivo que se nombra aquí, en lugar de hacerlo en la línea de comandos. Es un error especificar un archivo aquí y una consulta de la línea de comandos.
Etiquetas:changes_inputs
- Valor predeterminado
--[no]relative_locations
: “falso” -
Si es verdadero, la ubicación de los archivos BUILD en los resultados de XML y proto será relativa. De forma predeterminada, el resultado de ubicación es una ruta absoluta y no será coherente entre las máquinas. Puedes configurar esta opción como verdadera para obtener un resultado coherente en todas las máquinas.
Etiquetas:terminal_output
- Valor predeterminado
--[no]skyframe_state
: “falso” -
Sin realizar análisis adicionales, vuelque el gráfico de acción actual de Skyframe. Nota: Actualmente, no se puede especificar un destino con --skyframe_state. Esta marca solo está disponible con --output=proto o --output=textproto.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]tool_deps
: “verdadero” -
Consulta: Si está inhabilitada, las dependencias de la "configuración exec" no se incluirán en el gráfico de dependencias sobre el que opera la consulta. Una arista de dependencia de “configuración de exec”, como la de cualquier regla de “proto_library” al Compilador de protocolos, generalmente apunta a una herramienta ejecutada durante la compilación en lugar de a una parte del mismo programa de “destino”.
Consulta: Si se inhabilita, filtra todos los destinos configurados que cruzan una transición de ejecución del objetivo de nivel superior que descubrió este destino configurado. Esto significa que si el objetivo de nivel superior está en la configuración de destino, solo se mostrarán los objetivos configurados también en la configuración de destino. Si el destino de nivel superior está en la configuración de ejecución, solo se mostrarán los objetivos configurados. Esta opción NO excluirá las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
- Configuración predeterminada de
--universe_scope=<comma-separated list of options>
: "" -
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 objetivos especificados. Esta opción se usa para los comandos de consulta y cquery.
Para BigQuery, la entrada a esta opción son los objetivos en los que se crean 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: Si usas cquery, no especificar esta opción puede hacer que la compilación falle 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:
- Valor predeterminado de
--[no]collapse_duplicate_defines
: “verdadero” -
Cuando esté habilitada, se quitará --defines redundante 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
--[no]experimental_filter_library_jar_with_program_jar
: “falso” -
Filtra el ProgramJar de ProGuard para quitar las clases que también están en LibraryJar.
Etiquetas:action_command_lines
- Valor predeterminado de
--[no]experimental_inmemory_dotd_files
: “verdadero” -
Si se habilita, los archivos .d de C++ se pasarán por 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_inmemory_jdeps_files
: “verdadero” -
Si se habilita, los archivos de dependencia (.jdeps) generados a partir de compilaciones de Java se pasarán en la memoria directamente desde los nodos de compilación remota, en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
,experimental
- Valor predeterminado
--[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
--[no]experimental_retain_test_configuration_across_testonly
: “falso” -
Cuando se habilita, --trim_test_configuration no recortará la configuración de prueba para las reglas marcadas como testonly=1. Esto sirve para reducir los problemas de conflicto de acciones cuando las reglas que no son de prueba dependen de las reglas de cc_test. Sin efecto si --trim_test_configuration es falso.
Etiquetas:loading_and_analysis
,loses_incremental_state
- Valor predeterminado
--[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
--[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 Lines de los archivos de entrada. Esto puede mejorar el rendimiento y la incrementalidad mediante la disminución del tamaño de los árboles de entrada de compilación. Sin embargo, también puede interrumpir compilaciones porque el escáner de inclusión no implementa semántica de C. En particular, no comprende las directivas dinámicas #include e ignora la lógica condicional del preprocesador. Úsala bajo tu propia responsabilidad. Se cerrarán todos los problemas relacionados con esta marca.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
- Valor predeterminado de
--[no]incremental_dexing
: “verdadero” -
La mayor parte del trabajo de dex se realiza para cada archivo .jar.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Valor predeterminado de
--[no]objc_use_dotd_pruning
: “verdadero” -
Si se configura, se usarán los archivos .d emitidos por clang para reducir el conjunto de entradas que se pasan a compilaciones objc.
Etiquetas:changes_inputs
,loading_and_analysis
- Valor predeterminado
--[no]process_headers_in_dependencies
: “falso” -
Cuando compiles un destino //a:a, procesa los encabezados en todos los destinos de los que depende //a:a (si el procesamiento del encabezado está habilitado para la cadena de herramientas).
Etiquetas:execution
- Valor predeterminado de
--[no]trim_test_configuration
: “verdadero” -
Cuando esté habilitada, las opciones relacionadas con la prueba se borrarán por debajo del nivel superior de la compilación. Cuando esta marca está activa, las pruebas no se pueden crear 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
- Valor predeterminado de
--[no]use_singlejar_apkbuilder
: “verdadero” -
Esta opción dejó de estar disponible. 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:
- Configuración predeterminada 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 tipos de cadenas de herramientas y destinos específicos para ver cuál depurar. Si hay varias regex, estas se pueden separar con comas y, luego, cada una se verifica por separado. Nota: El resultado de esta marca es muy complejo y probablemente solo sea útil para los expertos en la resolución de cadenas de herramientas.
Etiquetas:terminal_output
- Opciones que especifican o alteran una entrada genérica en un comando de Bazel que no entra en otras categorías:
- Se acumulan
--flag_alias=<a 'name=value' flag alias>
usos múltiples -
Establece un nombre abreviado para una bandera de Starlark. Toma un solo par clave-valor con el formato "<key>=<value>" como argumento.
Etiquetas:changes_inputs
- Valor predeterminado
--[no]incompatible_default_to_explicit_init_py
: “falso” -
Este marcador cambia el comportamiento predeterminado para que los archivos __init__.py ya no se creen automáticamente en los runfiles de los destinos de Python. Precisamente, cuando un objetivo py_binary o py_test tiene heredado_create_init configurado como “auto” (el valor predeterminado), se trata como falso solo si se establece esta marca. Consulta https://github.com/bazelbuild/bazel/issues/10076.
Etiquetas:affects_outputs
,incompatible_change
- Valor predeterminado de
--[no]incompatible_py2_outputs_are_suffixed
: “verdadero” -
Si es verdadero, los destinos compilados en la configuración de Python 2 aparecerán en una raíz de salida que incluye el sufijo “-py2”, mientras que los objetivos compilados para Python 3 aparecerán en una raíz sin sufijo relacionado con Python. Esto significa que el symlink de conveniencia de "bazel-bin" apuntará a los objetivos de Python 3 en lugar de a Python 2. Si habilitas esta opción, también se recomienda habilitar `--incompatible_py3_is_default`.
Etiquetas:affects_outputs
,incompatible_change
- Valor predeterminado de
--[no]incompatible_py3_is_default
: “verdadero” -
Si el valor es verdadero, los objetivos "py_binary" y "py_test" que no establezcan el atributo "python_version" (o "default_python_version") se establecerán de forma predeterminada en PY3 en lugar de PY2. Si configuras esta marca, también se recomienda configurar “--incompatible_py2_outputs_are_subtitleed”.
Etiquetas:loading_and_analysis
,affects_outputs
,incompatible_change
- Valor predeterminado de
--[no]incompatible_use_python_toolchains
: “verdadero” -
Si se establece como verdadera, las reglas nativas ejecutables de Python usarán el entorno de ejecución de Python que especifica la cadena de herramientas de Python, en lugar del entorno de ejecución que proporcionan las marcas heredadas, como --python_top.
Etiquetas:loading_and_analysis
,incompatible_change
--python_version=<PY2 or PY3>
predeterminado: ver la descripción-
Es el modo de versión principal de Python, ya sea "PY2" o "PY3". Ten en cuenta que los destinos "py_binary" y "py_test" anulan (incluso si no especifican una versión de forma explícita), por lo que, por lo general, no hay muchos motivos para proporcionar esta marca.
Etiquetas:loading_and_analysis
,affects_outputs
,explicit_in_output_path
- Varias opciones, pero no categorizadas de otra manera:
--[no]cache_test_results
[-t
] predeterminado: “auto”- Si se establece 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 de pruebas con --runs_per_test o(4) la prueba falló. Si se configura en "sí", Bazel almacena en caché todos los resultados de la prueba, excepto las pruebas marcadas como externas. Si se configura en "no", Bazel no almacena en caché ningún resultado de prueba.
- Valor predeterminado
--[no]experimental_cancel_concurrent_tests
: “falso” -
Si es verdadero, Blaze cancelará las pruebas que se estén ejecutando en simultáneo en la primera ejecución correcta. Esto solo es útil si se combina con --runs_per_test_detects_flakes.
Etiquetas:affects_outputs
,loading_and_analysis
- Valor predeterminado
--[no]experimental_fetch_all_coverage_outputs
: “falso” -
Si es verdadero, Bazel recupera el directorio de datos de cobertura completo para cada prueba durante la ejecución de una cobertura.
Etiquetas:affects_outputs
,loading_and_analysis
- Valor predeterminado
--[no]experimental_generate_llvm_lcov
: “falso” -
Si es verdadero, la cobertura de Clang generará un informe de LCOV.
Etiquetas:affects_outputs
,loading_and_analysis
- Valor predeterminado de
--[no]experimental_j2objc_header_map
: “verdadero” - Indica si se debe generar un mapa de encabezado J2ObjC en paralelo a la transpilación J2ObjC.
- Valor predeterminado
--[no]experimental_j2objc_shorter_header_path
: “falso” -
Indica si se desea generar con una ruta de encabezado más corta (usa "_ios" en lugar de "_j2objc").
Etiquetas:affects_outputs
- Configuración predeterminada de
--experimental_java_classpath=<off, javabuilder or bazel>
: “javabuilder” - Habilita rutas de clase reducidas para las compilaciones de Java.
- Valor predeterminado
--[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
--[no]experimental_run_android_lint_on_java_rules
: “falso” -
Indica si se deben validar las fuentes java_*.
Etiquetas:affects_outputs
- Valor predeterminado
--[no]explicit_java_test_deps
: “falso” - Especifica explícitamente una dependencia a JUnit o Hamcrest en una java_test en lugar de obtener accidentalmente de las dependencias de TestRunner. Por el momento, solo funciona para bazel.
--host_java_launcher=<a build target label>
predeterminado: ver la 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 la VM de cada destino java_binary.
- Valor predeterminado de
--[no]incompatible_check_sharding_support
: “verdadero” -
Si el valor es verdadero, Bazel fallará una prueba fragmentada si el ejecutor de pruebas no indica que admite la fragmentación cuando se toca el archivo en la ruta de acceso TEST_SHARD_STATUS_FILE. Si es falso, un ejecutor de pruebas que no admita la fragmentación generará todas las pruebas que se ejecuten en cada fragmento.
Etiquetas:incompatible_change
- Valor predeterminado de
--[no]incompatible_exclusive_test_sandboxed
: “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
--[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 esto puede evitar el almacenamiento en caché de varios 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 iniciar la prueba. Implica -test_output=streamed.
Se expande a:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
- Valor predeterminado de
--[no]java_deps
: “verdadero” - Genera información de dependencia (por ahora, la ruta de clase de tiempo de compilación) por destino de Java.
- Valor predeterminado de
--[no]java_header_compilation
: “verdadero” - Compila ijar directamente desde la fuente.
- Configuración predeterminada de
--java_language_version=<a string>
: "" - Versión de lenguaje Java
--java_launcher=<a build target label>
predeterminado: ver la descripción- El selector de Java que se usará cuando se compilen objetos binarios de Java. Si esta marca se establece en la string vacía, se usa el selector de JDK. El atributo "launcher" anula esta marca.
- Configuración predeterminada 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 la VM de cada destino java_binary.
--legacy_main_dex_list_generator=<a build target label>
predeterminado: ver la descripción- Especifica un objeto binario para generar la lista de clases que deben estar en el DEX principal cuando se compila multidex heredado.
--optimizing_dexer=<a build target label>
predeterminado: ver la descripción- Especifica un objeto binario para usar en la conversión a dex sin fragmentación.
- Se acumulan
--plugin=<a build target label>
usos múltiples - Complementos para usar en la compilación. Actualmente funciona con java_plugin.
--proguard_top=<a build target label>
predeterminado: ver la descripción- Especifica qué versión de ProGuard usar para la eliminación de código cuando se compila un objeto binario de Java.
- Configuración predeterminada de
--proto_compiler=<a build target label>
: "@bazel_tools//tools/proto:protoc" - Es la etiqueta del proto compilador.
Etiquetas:affects_outputs
,loading_and_analysis
- Configuración predeterminada de
--proto_toolchain_for_cc=<a build target label>
: "@bazel_tools//tools/proto:cc_toolchain" -
Etiqueta de proto_lang_toolchain() que describe cómo compilar protocolos de C++
Etiquetas:affects_outputs
,loading_and_analysis
- Configuración predeterminada de
--proto_toolchain_for_j2objc=<a build target label>
: "@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
- Configuración predeterminada de
--proto_toolchain_for_java=<a build target label>
: "@bazel_tools//tools/proto:java_toolchain" -
Etiqueta de proto_lang_toolchain() que describe cómo compilar protocolos de Java
Etiquetas:affects_outputs
,loading_and_analysis
- Configuración predeterminada de
--proto_toolchain_for_javalite=<a build target label>
: "@bazel_tools//tools/proto:javalite_toolchain" -
Etiqueta de proto_lang_toolchain() que describe cómo compilar 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
--[no]runs_per_test_detects_flakes
: “falso” - Si es verdadero, cualquier fragmento en el que al menos una ejecución o un intento falle y un intento de ejecución o intento falle, obtendrá un estado FLAKY.
--shell_executable=<a path>
predeterminado: ver la descripción-
Ruta de acceso absoluta al ejecutable de shell que usa 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 usará. Si no se establece ninguno, Bazel usa una ruta de acceso predeterminada hard-coded según el sistema operativo en el que se ejecute (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, all other: /bin/bash). Ten en cuenta que usar una shell que no es compatible con Bash puede provocar fallas de compilación o de tiempo de ejecución de los objetos binarios generados.
Etiquetas:loading_and_analysis
- Se acumulan
--test_arg=<a string>
usos múltiples - Especifica las opciones y los argumentos adicionales que se deben pasar al ejecutable de la prueba. Se puede usar varias veces para especificar varios argumentos. Si se ejecutan varias pruebas, cada una recibirá argumentos idénticos. Solo se usa con el comando “bazel test”.
--test_filter=<a string>
predeterminado: ver la 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 los destinos que se crean.
- Valor predeterminado de
--test_result_expiration=<an integer>
: "-1" - Esta opción dejó de estar disponible y no tiene efecto.
- Valor predeterminado
--[no]test_runner_fail_fast
: “falso” - La opción de reenvío rápido falla al ejecutor de pruebas. El ejecutor de pruebas debe detener la ejecución en la primera falla.
- Configuración predeterminada de
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>
: "explícita" - Especificar la estrategia para la fragmentación de pruebas: “explícita” para usar la fragmentación solo si está presente el atributo “shard_count” “inhabilitado” para no usar nunca la fragmentación de pruebas. “forced=k” aplica de manera forzosa “k” fragmentos para pruebas, sin importar el atributo “shard_count” de BUILD.
- Configuración predeterminada de
--tool_java_language_version=<a string>
: "" - Versión de lenguaje Java que se usa para ejecutar las herramientas necesarias durante una compilación
- Configuración predeterminada de
--tool_java_runtime_version=<a string>
: "remotejdk_11" - Versión de entorno de ejecución de Java que se usa para ejecutar herramientas durante la compilación
- Valor predeterminado de
--[no]use_ijars
: “verdadero” - Si se habilita, esta opción hace que la compilación de Java use archivos jar de la interfaz. Como resultado, se realizará una compilación incremental más rápida, pero los mensajes de error pueden ser diferentes.
Opciones de compilación
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Lugares adicionales en los que buscar archivos antes de acceder a la red para descargarlos
Etiquetas:bazel_internal_configuration
- Valor predeterminado
--[no]experimental_repository_cache_hardlinks
: “falso” -
Si se establece, la caché del repositorio vinculará el archivo mediante un acierto de caché, en lugar de copiarlo. El objetivo es ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
- Valor predeterminado
--[no]experimental_repository_cache_urls_as_default_canonical_id
: “falso” -
Si es verdadero, usa una string derivada de las URLs de descargas del repositorio como canonical_id si no se especifica. Esto provoca que los cambios en las URL generen una nueva descarga incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no hagan que la caché oculte los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, los reintentos están inhabilitados.
Etiquetas:experimental
- Configuración predeterminada de
--experimental_scale_timeouts=<a double>
: “1.0” -
Escala este tiempo en todos los tiempos de espera de las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que son más lentas que lo que espera el autor de la regla, sin cambiar el código fuente
Etiquetas:bazel_internal_configuration
,experimental
- Configuración predeterminada de
--http_connector_attempts=<an integer>
: "8" -
Es la cantidad máxima de intentos de descarga de HTTP.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--http_connector_retry_max_timeout=<An immutable length of time.>
: “0 s” -
Es el tiempo de espera máximo para los reintentos de descarga de HTTP. Si el valor es 0, no se define ningún tiempo de espera máximo.
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--http_timeout_scaling=<a double>
: “1.0” -
Escalar todos los tiempos de espera relacionados con las descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: ver la 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é; de lo contrario, se usará el valor predeterminado “<output_user_root>/cache/repos/v1”
Etiquetas:bazel_internal_configuration
- Valor predeterminado
--[no]repository_disable_download
: “falso” -
Si se configura, no se permite la descarga mediante ctx.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no está completamente inhabilitado. ctx.execute puede ejecutar un ejecutable arbitrario que accede a Internet.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de la compilación:
- Valor predeterminado
--[no]check_up_to_date
: “falso” -
No realices la compilación. Verifica si está actualizada. Si todos los destinos están actualizados, la compilación se completa correctamente. Si se debe ejecutar algún paso, se informa un error y la compilación falla.
Etiquetas:execution
- Valor predeterminado de
--dynamic_local_execution_delay=<an integer>
: "1000" -
¿Cuántos milisegundos debería retrasarse la ejecución local si la ejecución remota fue más rápida durante una compilación, al menos, una vez?
Etiquetas:execution
,host_machine_resource_optimizations
- Se acumulan
--dynamic_local_strategy=<a '[name=]value1[,..,valueN]' assignment>
usos múltiples -
Se usarán las estrategias locales para la estrategia mnemotécnica determinada; se utiliza la primera estrategia aplicable. Por ejemplo, “worker,sandboxed” ejecuta acciones que admiten trabajadores persistentes que usan la estrategia de trabajador, y todos los demás que usan la estrategia de zona de pruebas. Si no se proporciona ningún valor mnemotécnico, se utiliza la lista de estrategias como resguardo para todos los mnemónicos. La lista de resguardo predeterminada es “worker,sandboxed” o “worker,sandboxed,standalone” si se configura “experimental_local_lockfree_output”. Toma [mnemonic=]estrategia_local[,estrategia_local,...]
Etiquetas:execution
,host_machine_resource_optimizations
- Se acumulan
--dynamic_remote_strategy=<a '[name=]value1[,..,valueN]' assignment>
usos múltiples -
Se utilizarán las estrategias remotas, en orden, la primera estrategia mnemotécnica determinada. Si no se proporciona ningún valor mnemotécnico, se utiliza la lista de estrategias como resguardo para todos los mnemónicos. La lista de resguardo predeterminada es “remote”, por lo que no es necesario configurar explícitamente esta marca. Requiere [mnemonic=]estrategia_remota[,estrategia_remoto,...]
Etiquetas:execution
,host_machine_resource_optimizations
- Configuración predeterminada de
--experimental_docker_image=<a string>
: "" -
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í no tiene un atributo de imagen de contenedor en su Remote_execution_properties en la descripción de la plataforma. El valor de esta marca se pasa textualmente a “docker run”, por lo que admite la misma sintaxis y los mismos mecanismos que Docker.
Etiquetas:execution
- Valor predeterminado de
--[no]experimental_docker_use_customized_images
: “verdadero” -
Si se habilita, inserta 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 automática de personalización de imágenes no funcione en su caso o sepa que no la necesita.
Etiquetas:execution
- Valor predeterminado de
--[no]experimental_dynamic_exclude_tools
: “verdadero” -
Cuando se configura, los objetivos que se compilan "para herramientas" no están sujetos a la ejecución dinámica. Es poco probable que estos objetivos se creen de forma incremental y, por lo tanto, no vale la pena invertir en ciclos locales.
Etiquetas:execution
,host_machine_resource_optimizations
--experimental_dynamic_local_load_factor=<a double>
predeterminado: “0”-
Controla la cantidad de carga de la ejecución dinámica para colocar en la máquina local. Esta marca ajusta la cantidad de acciones en ejecución dinámica que programaremos en simultáneo. 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 localmente cuando es alta la cantidad de acciones que esperan a la programación. Esto disminuye la carga en la máquina local en el caso de compilación limpia, en la que la máquina local no contribuye mucho.
Etiquetas:execution
,host_machine_resource_optimizations
--experimental_dynamic_slow_remote_time=<An immutable length of time.>
predeterminado: “0”-
Si es mayor que 0, la hora de una acción que se ejecuta dinámicamente debe ejecutarse solo de forma remota antes de que prioricemos su ejecución local. 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
--[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
- Valor predeterminado de
--experimental_oom_more_eagerly_threshold=<an integer in 0-100 range>
: "100" -
Si esta marca se establece en un valor inferior a 100, Bazel se encontrará OOM si después de dos recolecciones completas, se ocupa más de este porcentaje del montón (generación anterior).
Etiquetas:host_machine_resource_optimizations
--experimental_sandbox_async_tree_delete_idle_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
predeterminado: “0”-
Si el valor es 0, borre los árboles de la zona de pruebas en cuanto se complete una acción (lo que hará que se complete la acción). Si es mayor que cero, ejecuta la eliminación de esos tres en un grupo de subprocesos asíncrono que tenga el tamaño 1 cuando la compilación esté en ejecución y crezca hasta alcanzar el tamaño que especifica esta marca cuando el servidor esté inactivo.
Etiquetas:host_machine_resource_optimizations
,execution
--experimental_sandbox_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
predeterminado: “0”- Si es mayor que 0, cada zona de pruebas de Linux se limitará a la cantidad determinada de memoria (en MB). Requiere cgroups v1 o v2 y permisos para los usuarios al cgroups dir.
Etiquetas:execution
- Predeterminado de
--experimental_sandboxfs_path=<a string>
: “sandboxfs”. -
Ruta al objeto binario sandboxfs para usar cuando --experimental_use_sandboxfs es verdadero Si es un nombre simple, usa el primer objeto binario de ese nombre que se encuentra en PATH.
Etiquetas:host_machine_resource_optimizations
,execution
- Valor predeterminado
--[no]experimental_shrink_worker_pool
: “falso” -
Si se habilita, puede reducir el grupo de trabajadores si la presión de memoria del trabajador es alta. Esta marca solo funciona cuando la marca experimental_total_worker_memory_limit_mb está habilitada.
Etiquetas:execution
,host_machine_resource_optimizations
- Valor predeterminado de
--[no]experimental_split_xml_generation
: “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 de prueba que contiene el registro de prueba. De lo contrario, Bazel genera un archivo test.xml como parte de la acción de prueba.
Etiquetas:execution
--experimental_total_worker_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
predeterminado: “0”-
Si este límite es mayor que cero trabajadores inactivos, es posible que se cierren si el uso total de memoria de todos los trabajadores excede el límite.
Etiquetas:execution
,host_machine_resource_optimizations
- Valor predeterminado
--[no]experimental_use_hermetic_linux_sandbox
: “falso” -
Si se establece como verdadera, no montar la raíz, solo activar lo que se proporciona con sandbox_add_mount_pair Se vincularán los archivos de entrada a la zona de pruebas en lugar de hacerlo por symlink desde la zona de pruebas. Si los archivos de entrada de acciones se encuentran en un sistema de archivos diferente de la zona de pruebas, en su lugar, se copiarán los archivos de entrada.
Etiquetas:execution
- Valor predeterminado
--[no]experimental_use_sandboxfs
: “falso” - Usa la zona de pruebas para crear los directorios execroot de las acciones en lugar de crear un árbol de symlinks. Si la respuesta es "sí", el objeto binario proporcionado por --experimental_sandboxfs_path debe ser válido y corresponder a una versión compatible de sandboxfs. Si es "automático", es posible que falte el objeto binario o que no sea compatible.
Etiquetas:host_machine_resource_optimizations
,execution
- Valor predeterminado
--[no]experimental_use_semaphore_for_jobs
: “falso” - Si se establece como verdadera, además usa semaphore para limitar la cantidad de trabajos simultáneos.
Etiquetas:host_machine_resource_optimizations
,execution
- Valor predeterminado
--[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 proporciona --experimental_windows_sandbox_path debe ser válido y corresponde a una versión compatible de sandboxfs. Si es "automático", es posible que falte el objeto binario o que no sea compatible.
- Configuración predeterminada de
--experimental_windows_sandbox_path=<a string>
: “BazelSandbox.exe” - Ruta al objeto binario de la zona de pruebas de Windows para usar cuando --experimental_use_windows_sandbox sea verdadero. Si es un nombre simple, usa el primer objeto binario de ese nombre que se encuentra en PATH.
--experimental_worker_allowlist=<comma-separated set of options>
predeterminado: ver la descripción-
Si no está vacío, solo permita el uso de trabajadores persistentes con la clave mnemotécnica determinada.
Etiquetas:execution
,host_machine_resource_optimizations
- Valor predeterminado de
--[no]experimental_worker_as_resource
: “verdadero” -
No-op, pronto se quitará.
Etiquetas:no_op
- Valor predeterminado
--[no]experimental_worker_cancellation
: “falso” -
Si se habilita, es posible que Bazel envíe solicitudes de cancelación a los trabajadores que las admiten.
Etiquetas:execution
--experimental_worker_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
predeterminado: “0”-
Si este límite es mayor que cero, los trabajadores podrían cerrarse si el uso de memoria del trabajador supera el límite. Si no se usa junto con la ejecución dinámica y `--experimental_dynamic_ignore_local_signals=9`, es posible que tu compilación se bloquee.
Etiquetas:execution
,host_machine_resource_optimizations
- Valor predeterminado de
--experimental_worker_metrics_poll_interval=<An immutable length of time.>
: “5 s” -
Es el intervalo entre la recopilación de métricas del trabajador y la posible expulsión. No puede ser inferior a 1 s por razones de rendimiento.
Etiquetas:execution
,host_machine_resource_optimizations
- Valor predeterminado
--[no]experimental_worker_multiplex_sandboxing
: “falso” -
Si está habilitado, 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” tendrán zonas de pruebas.
Etiquetas:execution
- Valor predeterminado
--[no]experimental_worker_strict_flagfiles
: “falso” -
Si se habilita, los argumentos de acción de los trabajadores que no sigan la especificación del trabajador generarán un error. Los argumentos de los trabajadores deben tener exactamente un argumento @flagfile como el último de su lista de argumentos.
Etiquetas:execution
- Configuración predeterminada de
--genrule_strategy=<comma-separated list of options>
: "" -
Especifica cómo ejecutar genrules. Esta marca se eliminará gradualmente. En su lugar, usa --spawn_strategy=<value> para controlar todas las acciones o --Strategy=Genrule=<value> a fin de controlar solo las reglas generales.
Etiquetas:execution
- Se acumulan
--high_priority_workers=<a string>
usos múltiples -
No-op, pronto se quitará.
Etiquetas:execution
- Valor predeterminado de
--[no]incompatible_remote_dangling_symlinks
: “verdadero” -
Si se establece en verdadero y --incompatible_remote_symlinks también se establece como verdadero, se permite que los symlinks en los resultados de acción se coloquen.
Etiquetas:execution
,incompatible_change
- Valor predeterminado de
--[no]incompatible_remote_symlinks
: “verdadero” -
Si se establece como verdadero, Bazel representará symlinks en los resultados de acción del protocolo de ejecución/almacenamiento en caché remoto como tal. 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
--[no]incompatible_sandbox_hermetic_tmp
: “falso” -
Si se establece 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
--[no]internal_spawn_scheduler
: “falso” -
Opción de marcador de posición para que podamos saber en 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 (“automático”, “HOST_CPUS”, “HOST_RAM”), opcionalmente seguido de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". Los valores deben estar entre 1 y 5,000. Los valores superiores a 2,500 pueden causar problemas de memoria. "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 tanto como sea posible después de un error. Si bien el objetivo que falló 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”-
Es la cantidad de subprocesos paralelos que se usarán en la fase de carga o análisis. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), seguido de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". "auto" establece un valor predeterminado razonable según los recursos del host. Debe ser 1 como mínimo.
Etiquetas:bazel_internal_configuration
- Valor predeterminado
--[no]reuse_sandbox_directories
: “falso” -
Si se establece como verdadera, los directorios que usa la ejecución de zona de pruebas no trabajadores se pueden volver a usar para evitar costos de configuración innecesarios.
Etiquetas:host_machine_resource_optimizations
,execution
- Configuración predeterminada de
--sandbox_base=<a string>
: "" -
Permite que la zona de pruebas cree sus directorios de zona de pruebas en la ruta. Especifica una ruta de acceso en tmpfs (como /run/shm) para mejorar mucho el rendimiento cuando tus compilaciones o pruebas tengan muchos archivos de entrada. Nota: Necesitas suficiente RAM y espacio libre en el tmpfs para almacenar los archivos intermedios y de salida generados por las acciones en ejecución.
Etiquetas:host_machine_resource_optimizations
,execution
- Valor predeterminado
--[no]sandbox_explicit_pseudoterminal
: “falso” - Habilita explícitamente la creación de seudoterminales para acciones de zona de pruebas. Algunas distribuciones de Linux requieren establecer el ID de grupo del proceso en "tty" dentro de la zona de pruebas para que funcionen los seudoterminales. Si esta acción causa problemas, se puede inhabilitar la marca para habilitar el uso de otros grupos.
Etiquetas:execution
- Se acumulan
--sandbox_tmpfs_path=<an absolute path>
usos múltiples -
Para acciones de zona de pruebas, activa un directorio vacío que admita escritura en esta ruta de acceso absoluta (de lo contrario, si se admite la implementación de zona de pruebas, se ignora).
Etiquetas:host_machine_resource_optimizations
,execution
- Valor predeterminado
--[no]skip_incompatible_explicit_targets
: “falso” -
Evita las orientaciones incompatibles que se indiquen explícitamente en la línea de comandos. De forma predeterminada, la compilación de estos destinos genera un error, pero se omiten de manera silenciosa cuando esta opción está habilitada. Consulta https://bazel.build/extending/platforms#skipping-incompatible-targets
Etiquetas:loading_and_analysis
- Configuración predeterminada de
--spawn_strategy=<comma-separated list of options>
: "" -
Especifica cómo se ejecutan las acciones de generación de forma predeterminada. Acepta una lista de estrategias separadas por comas de mayor a menor prioridad. Para cada acción, Bazel elige la estrategia que tiene la prioridad más alta que puede ejecutar la acción. El valor predeterminado es "remote,worker,sandboxed,local". Para obtener más información, consulta https://blog.bazel.build/2019/06/19/list-Strategy.html.
Etiquetas:execution
- Se acumulan
--strategy=<a '[name=]value1[,..,valueN]' assignment>
usos múltiples -
Especifica cómo distribuir la compilación de otras acciones de generación. Acepta una lista de estrategias separadas por comas de mayor a menor prioridad. Para cada acción, Bazel elige la estrategia que tiene 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 Genmnonic Genrule). Para obtener más información, consulta https://blog.bazel.build/2019/06/19/list-Strategy.html.
Etiquetas:execution
- Se acumulan
--strategy_regexp=<a '<RegexFilter>=value[,value]' assignment>
usos múltiples -
Anula la estrategia de generación que se debe usar para ejecutar acciones de generación que tengan descripciones que coincidan con un determinado filtro de regex_. Consulta --per_file_copt para obtener detalles sobre la coincidencia de regex_filter. Se usa el último regex_filter que coincide con la descripción. Esta opción anula otras marcas para especificar la estrategia. Ejemplo: --Strategy_regexp=//foo.*\.cc,-//foo/bar=local significa ejecutar acciones con la estrategia local si sus descripciones coinciden con //foo.*.cc, pero no con //foo/bar. Ejemplo: --Strategy_regexp='Compiling.*/bar=local --strategy_regexp=Compiling=sandboxed ejecutará "Compilando //foo/bar/baz" con la estrategia de "local", pero revertir el orden lo ejecutaría con "sandboxed".
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 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 cada tipo de trabajador persistente podrían iniciarse si usas la estrategia de “trabajador”. Se puede especificar como [name=value] para proporcionar un valor diferente por valor nemotécnico. El límite se basa en las claves de trabajador, que se diferencian por las nemotécnicas, pero también por las marcas y el entorno de inicio, por lo que, en algunos casos, puede haber más trabajadores por cantidad nemotécnica de lo que especifica esta marca. 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". “automático” calcula un valor predeterminado razonable según la capacidad de la máquina. "=value" establece un valor predeterminado para valores mnemotécnicos no especificados.
Etiquetas:execution
,host_machine_resource_optimizations
- Se acumulan
--worker_max_multiplex_instances=<[name=]value, where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
usos múltiples -
Cuántas WorkRequests puede recibir un proceso de trabajador multiplex en paralelo si usas la estrategia de “trabajador” con --experimental_worker_multiplex. Se puede especificar como [name=value] para proporcionar un valor diferente por valor nemotécnico. El límite se basa en las claves de trabajador, que se diferencian por las nemotécnicas, pero también por las marcas y el entorno de inicio, por lo que, en algunos casos, puede haber más trabajadores por cantidad nemotécnica de lo que especifica esta marca. 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". “automático” calcula un valor predeterminado razonable según la capacidad de la máquina. "=value" establece un valor predeterminado para valores mnemotécnicos no especificados.
Etiquetas:execution
,host_machine_resource_optimizations
- Valor predeterminado de
--[no]worker_multiplex
: “verdadero” -
Si está habilitada, los trabajadores usarán la multiplexación si la admiten.
Etiquetas:execution
,host_machine_resource_optimizations
- Valor predeterminado
--[no]worker_quit_after_build
: “falso” -
Si se habilita, todos los trabajadores cierran su sitio después de que se completa una compilación.
Etiquetas:execution
,host_machine_resource_optimizations
- Valor predeterminado
--[no]worker_sandboxing
: “falso” -
Si se habilita, los trabajadores se ejecutarán en un entorno de zona de pruebas.
Etiquetas:execution
- Valor predeterminado
--[no]worker_verbose
: “falso” - Si está habilitada, imprime mensajes detallados cuando se inician, cierran, ...
- Opciones que configuran la cadena de herramientas usada para la ejecución de la acción:
- Valor predeterminado
--[no]incompatible_disable_runtimes_filegroups
: “falso” -
No-op obsoleto.
Etiquetas:action_command_lines
,loading_and_analysis
,deprecated
,incompatible_change
- Valor predeterminado de
--[no]incompatible_dont_emit_static_libgcc
: “verdadero” -
No-op obsoleto.
Etiquetas:action_command_lines
,loading_and_analysis
,deprecated
,incompatible_change
- Valor predeterminado de
--[no]incompatible_linkopts_in_user_link_flags
: “verdadero” -
No-op obsoleto.
Etiquetas:action_command_lines
,loading_and_analysis
,deprecated
,incompatible_change
- Configuración predeterminada de
--target_platform_fallback=<a string>
: "" -
Esta opción dejó de estar disponible y no tiene efecto.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
- Opciones que controlan el resultado del comando:
- Valor predeterminado de
--[no]build
: “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 muestra cero si las fases de carga y análisis del paquete se completaron correctamente. Este modo es útil para probar esas fases.
Etiquetas:execution
,affects_outputs
- Valor predeterminado de
--[no]experimental_run_validations
: “verdadero” - Usa --run_validates en su lugar.
Etiquetas:execution
,affects_outputs
- Valor predeterminado
--[no]experimental_use_validation_aspect
: “falso” - Determina si se deben ejecutar acciones de validación mediante el aspecto (paralelismo con pruebas).
Etiquetas:execution
,affects_outputs
- Se acumulan
--output_groups=<comma-separated list of options>
usos múltiples -
Es una lista de nombres de grupos de salida separados por comas, cada uno de los cuales puede tener el prefijo + o -. Los grupos con el prefijo + se agregan al conjunto predeterminado, 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 bar, mientras que --output_groups=foo,bar anula el conjunto predeterminado de modo que solo se compilen foo y bar.
Etiquetas:execution
,affects_outputs
- Valor predeterminado de
--[no]run_validations
: “verdadero” -
Indica si se deben ejecutar acciones de validación como parte de la compilación. Consulta https://bazel.build/extending/rules#validation_actions.
Etiquetas:execution
,affects_outputs
- Opciones que permiten al usuario configurar la salida deseada y afectar su valor en lugar 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 aspecto_aspecto especifica proveedores de aspecto necesarios mediante el tipo obligatorio_aspect_providers, algunos_aspectos se ejecutarán después de cada aspecto que se mencionó antes de él en la lista de aspectos, cuyos proveedores anunciados satisfacen algunos proveedores de aspecto obligatorios. Además, algunos_aspectos se ejecutarán luego de que todos los aspectos obligatorios que se especifican en él requieren un atributo. De esta manera, algunos tendrán acceso a los valores de los proveedores de dichos aspectos. <bzl-file-label>%<aspect_name>, por ejemplo, "//tools:my_def.bzl%my_aspect", en el que "my_aspect" es un valor de nivel superior de una herramienta de archivo/my_def.bzl.
- Valor predeterminado de
--bep_maximum_open_remote_upload_files=<an integer>
: "-1" -
Se permite la cantidad máxima de archivos abiertos durante la carga de artefactos de BEP.
Etiquetas:affects_outputs
- Valor predeterminado
--[no]experimental_convenience_symlinks
: "normal" -
Esta marca controla cómo se administrarán los symlinks de conveniencia (los symlinks que aparecen en el lugar de trabajo después de la compilación). Valores posibles: normal (predeterminado): Se creará o borrará cada tipo de symlink de conveniencia según lo determine la compilación.
limpio: Todos los symlinks se borrarán de forma incondicional.
Ignorar: Los vínculos simbólicos quedarán solos.
log_only: Genera mensajes de registro como si se pasara "normal", pero en realidad no realices ninguna operación del sistema de archivos (útil para las herramientas).
Ten en cuenta que solo se pueden ver afectados los symlinks cuyos nombres se generan con el valor actual de --symlink_prefix; si cambia el prefijo, los symlinks preexistentes quedarán solos.
Etiquetas:affects_outputs
- Valor predeterminado
--[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, BuildEventProtocolo tendrá una entrada para convenienciaSymlinksIdentified, que enumera todos los symlinks de conveniencia creados en su lugar de trabajo. Si es falso, la entrada convenienteSymlinksIdentified 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
- Valor predeterminado de
--[no]incompatible_use_platforms_repo_for_constraints
: “verdadero” -
No-op obsoleto.
Etiquetas:affects_outputs
,incompatible_change
--remote_download_minimal
-
No descarga los resultados de compilación remota en la máquina local. Esta marca es un acceso directo para las marcas: --action_cache_store_output_metadata, --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files y --remote_download_outputs=minimal.
Se expande a:
--nobuild_runfile_links
--action_cache_store_output_metadata
--remote_download_outputs=minimal
Etiquetas:affects_outputs
--remote_download_outputs=<all, minimal or toplevel>
predeterminado: “todos”-
Si se establece como “minimal”, no se descargan salidas de compilación remota en la máquina local, excepto las que requieren las acciones locales. Si se establece como “toplevel”, se comporta como “minimal”, con la excepción de que también descarga salidas de destinos de nivel superior en la máquina local. Ambas opciones pueden reducir de manera significativa los tiempos de compilación si el ancho de banda de la red genera un cuello de botella.
Etiquetas:affects_outputs
- Configuración predeterminada de
--remote_download_symlink_template=<a string>
: "" -
En lugar de descargar los 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 las salidas remotas de los objetivos de nivel superior en la máquina local. Esta marca es un acceso directo para las marcas: --action_cache_store_output_metadata, --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files y --remote_download_outputs=toplevel.
Se expande a:
--action_cache_store_output_metadata
--remote_download_outputs=toplevel
Etiquetas:affects_outputs
--symlink_prefix=<a string>
predeterminado: ver la descripción-
Es el prefijo que se antepone a cualquiera de los symlinks de conveniencia que se crean después de una compilación. Si se omite, el valor predeterminado es el nombre de la herramienta de compilación seguido de un guion. Si se pasa "/", no se crean symlinks ni se emite ninguna advertencia. Advertencia: La funcionalidad especial para “/” pronto dejará de estar disponible; en su lugar, usa --experimental_convenience_symlinks=ignore.
Etiquetas:affects_outputs
- Opciones que afectan cómo se aplica estrictamente Bazel a las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etc.):
- Valor predeterminado
--[no]experimental_docker_privileged
: “falso” -
Si está habilitado, Bazel pasará la marca --privileged a "docker run" cuando ejecute acciones. Esto puede ser un requisito de tu compilación, pero también puede reducir la hermética.
Etiquetas:execution
- Configuración predeterminada de
--experimental_repository_hash_file=<a string>
: "" -
Si no está vacío, especifica un archivo que contiene un valor resuelto, con el que se deben verificar los hash del directorio del repositorio.
Etiquetas:affects_outputs
,experimental
- Valor predeterminado
--[no]experimental_sandboxfs_map_symlink_targets
: “falso” -
Si es verdadero, asigna los objetivos de los vínculos simbólicos especificados como entradas de acción en la zona de pruebas. Esta función existe solo para solucionar reglas con errores que no lo hacen por sí solas y se debe 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 se trata de una lista de reglas de repositorio para las que se debe verificar el hash del directorio de salida, se debe proporcionar un archivo mediante --experimental_repository_hash_file.
Etiquetas:affects_outputs
,experimental
- Valor predeterminado
--[no]incompatible_legacy_local_fallback
: “falso” -
Si se establece como verdadera, habilita el resguardo implícito heredado de la zona de pruebas a la estrategia local. Con el tiempo, esta marca se establecerá de forma predeterminada como falsa y, luego, se convertirá en una no-op. En su lugar, usa --Strategy, --spawn_strategy o --dynamic_local_Strategy.
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 ruta adicional para activar en la zona de pruebas.
Etiquetas:execution
- Se acumulan
--sandbox_block_path=<a string>
usos múltiples -
Para las acciones en la zona de pruebas, inhabilita el acceso a esta ruta de acceso.
Etiquetas:execution
- Valor predeterminado de
--[no]sandbox_default_allow_network
: “verdadero” - Permite el acceso a la red de forma predeterminada para las acciones. Es posible que no funcione con todas las implementaciones de la zona de pruebas.
- Valor predeterminado
--[no]sandbox_fake_hostname
: “falso” -
Cambia el nombre de host actual a “localhost” para las acciones de la zona de pruebas.
Etiquetas:execution
- Valor predeterminado
--[no]sandbox_fake_username
: “falso” -
Cambia el nombre de usuario actual a "nadie" para las acciones de la zona de pruebas.
Etiquetas:execution
- Se acumulan
--sandbox_writable_path=<a string>
usos múltiples -
Para las acciones en la zona de pruebas, haga que un directorio existente admita escritura en la zona de pruebas (si se admite en la implementación de la zona de pruebas, se debe ignorar).
Etiquetas:execution
- Esta opción afecta la semántica del lenguaje de Starlark o de la API de compilación accesible para los archivos BUILD, los archivos .bzl o los archivos WORKSPACE:
- Valor predeterminado de
--[no]experimental_allow_top_level_aspects_parameters
: “verdadero” -
Etiquetas no-ops
:no_op
,deprecated
,experimental
- Valor predeterminado
--[no]incompatible_config_setting_private_default_visibility
: “falso” -
Si incompatible_enforce_config_setting_visibility=false es, esto es noop. De lo contrario, si la marca es falsa, cualquier config_setting sin un atributo explícito de visibilidad será //visibility:public. Si esta marca es verdadera, config_setting sigue la misma lógica de visibilidad que todas las demás reglas. Consulta https://github.com/bazelbuild/bazel/issues/12933.
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]incompatible_enforce_config_setting_visibility
: “verdadero” -
Si es verdadero, aplique restricciones de visibilidad de config_setting. Si es falso, cada destino es visible para cada config_setting. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones que rigen el comportamiento del entorno o del ejecutor de pruebas:
- Valor predeterminado
--[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 completarán de forma correcta. Si se debe 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 reintentará hasta la cantidad especificada de veces en caso de que falle. Las pruebas que requirieron más de un intento se marcan como “FLAKY” en el resumen de la prueba. Por lo general, 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 el valor es "predeterminado", solo se realizará un único intento de prueba para pruebas regulares y tres para las que la regla haya marcado explícitamente como inestable (atributo "flaky=1"). Sintaxis alternativa: regex_filter@flaky_test_intents. Donde flaky_test_intents es el anterior y regex_filter significa una lista de patrones de expresión de inclusión y exclusión (consultar también --runs_per_test). Ejemplo: --flaky_test_intents=//foo/.*,-//foo/bar/.*@3 desaprueba todas las pruebas en //foo/, excepto las de foo/bar tres veces. Esta opción se puede pasar varias veces. Tiene prioridad el argumento que se pasó más recientemente y que coincide. Si no hay una coincidencia, el comportamiento es como si se hubiera establecido en la opción "predeterminada" mencionada 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”-
Es la cantidad máxima de trabajos de prueba locales que se deben ejecutar de forma simultánea. 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". 0 significa que los recursos locales limitarán la cantidad de trabajos de prueba locales que se deben ejecutar de forma simultánea. Establecer este valor mayor que el de --jobs es ineficaz.
Etiquetas:execution
- Valor predeterminado de
--[no]test_keep_going
: “verdadero” -
Cuando 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
- Configuración predeterminada de
--test_strategy=<a string>
: "" -
Especifica la estrategia que se usará para ejecutar pruebas.
Etiquetas:execution
--test_tmpdir=<a path>
predeterminado: ver la descripción- Especifica el directorio temporal base que debe usar “prueba de Bazel”.
- 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 dependencia resuelto, incluso si se declaran con hilos en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones con errores harán que la resolución falle. También puedes definir una versión con un permiso permitido con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puede inhabilitar esta comprobación con la palabra clave "todos" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: “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 de `bazel_dep` directas declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencia resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para mostrar una advertencia cuando se detecta una discrepancia o "error" para derivarlo a una falla de resolución.
Etiquetas:loading_and_analysis
- Valor predeterminado
--[no]ignore_dev_dependency
: “falso” -
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en el MODULE.bazel del módulo raíz. Tenga en cuenta que esas dependencias para desarrolladores siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- Configuración predeterminada de
--lockfile_mode=<off, update or error>
: "desactivado" -
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "error" para usar el archivo de bloqueo, pero arroja un error si no está actualizado o "off" para evitar leer el archivo o escribir en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local con el formato <module name>=<path>. Si la ruta específica es absoluta, se usará tal como está. Si la ruta específica es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso determinada comienza con “%workspace%”, se relaciona con la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo recurrirán a los registros posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que activan optimizaciones del tiempo de compilación:
- Configuración predeterminada de
--experimental_gc_thrashing_limits=<comma separated pairs of <period>:<count>>
: "" -
Limita qué, si se alcanza, hace que GcThrashingDetector falle Bazel con un OOM. Cada límite se especifica como <período>:<count>, donde el período es una duración y el recuento es un número entero positivo. Si se supera el <count> GC total consecutivo de <period> consecutivos, se activará una cantidad superior al --experimental_oom_more_eagerly_Threshold por ciento del espacio titular (heap de generación anterior). Se pueden especificar varios límites separados por comas.
Etiquetas:host_machine_resource_optimizations
- Valor predeterminado de
--[no]gc_thrashing_limits_retained_heap_limiter_mutually_exclusive
: “verdadero” -
Si es verdadero, la especificación de --experimental_gc_thrashing_limits no vacía desactiva el RetainedHeapLimiter para que sea mutuamente excluyente con GcThrashingDetector. Si se establece como falsa, ambas pueden estar activas para el mismo comando.
Etiquetas:host_machine_resource_optimizations
- Configuración predeterminada de
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
: “2147483647” -
Marca que indica la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que su porcentaje de uso de montón retenido supera el umbral establecido por --skyframe_high_water_mark_Threshold, cuando se produzca un evento de recolección de elementos no utilizados total, se eliminará el estado temporal de Skyframe innecesario, hasta muchas veces por invocación. La configuración predeterminada es un número entero.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos de recolección de elementos no utilizados nunca activarán disminuciones. Si se alcanza el límite, ya no se eliminará el estado de Skyframe cuando se produzca un evento de recolección de elementos no utilizados completo y se supere el umbral del porcentaje del montón retenido.
Etiquetas:host_machine_resource_optimizations
- Configuración predeterminada de
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
: “2147483647” -
Marca que indica la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que su porcentaje de uso de montón retenido supera el umbral que establece --skyframe_high_water_mark_Threshold, cuando se produzca un evento de recolección de elementos no utilizados menor, se eliminará el estado temporal de Skyframe innecesario, hasta muchas veces por invocación. La configuración predeterminada es un número entero.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos de recolección de elementos no utilizados menores nunca activarán disminuciones. Si se alcanza el límite, ya no se eliminará el estado de Skyframe cuando se produzca un evento de recolección de elementos no utilizados menor y se supere el umbral del porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
- Configuración predeterminada de
--skyframe_high_water_mark_threshold=<an integer>
: “85” -
Marca que indica la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que su uso del montón retenido es al menos este umbral, dejará de ser necesario el estado temporal de Skyframe. Ajustar esto le permite mitigar el impacto de la hiperpaginación en la recolección de elementos no utilizados, cuando la hiperpaginación de GC es (i) causada por el uso de memoria de este estado temporal y (ii) más costosa que reconstituir el estado cuando es necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Valor predeterminado
--[no]announce
: “falso” -
Obsoleto. No-op.
Etiquetas:affects_outputs
- Valor predeterminado
--[no]debug_spawn_scheduler
: “falso” - Valor predeterminado
--[no]experimental_bep_target_summary
: “falso” - Indica si se deben publicar eventos TargetSummary.
- Valor predeterminado
--[no]experimental_build_event_expand_filesets
: “falso” -
Si es verdadero, expande los conjuntos de archivos en el BEP cuando se presentan los archivos de salida.
Etiquetas:affects_outputs
- Valor predeterminado
--[no]experimental_build_event_fully_resolve_fileset_symlinks
: “falso” -
Si es verdadero, resuelve por completo los symlinks relativos del conjunto de archivos en la BEP cuando se presentan los archivos de salida. Requiere --experimental_build_event_expand_filesets.
Etiquetas:affects_outputs
- Configuración predeterminada de
--experimental_build_event_upload_max_retries=<an integer>
: "4" -
Es la cantidad máxima de veces que Bazel debe intentar subir un evento de compilación.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
: "1 s" -
Es el retraso mínimo para los reintentos de retirada exponencial cuando falla la carga del BEP. (exponente: 1.6)
Etiquetas:bazel_internal_configuration
--experimental_build_event_upload_strategy=<a string>
predeterminado: ver la 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_collect_local_sandbox_action_metrics
: “verdadero” -
Cuando se habilita, se registran estadísticas de ejecución (como el usuario y la hora del sistema) para las acciones ejecutadas de forma local que usan zonas de pruebas.
Etiquetas:execution
- Valor predeterminado
--[no]experimental_command_profile
: “falso” - Registra un perfil de CPU de Grabadora de vuelo en Java en un archivo profile.jfr en el directorio base de salida. La sintaxis y la semántica de esta marca puede cambiar en el futuro para admitir diferentes tipos de perfiles o formatos de salida; úsala bajo tu propia responsabilidad.
- Valor predeterminado
--[no]experimental_docker_verbose
: “falso” -
Si se habilita, Bazel imprimirá mensajes más detallados sobre la estrategia de zona de pruebas de Docker.
Etiquetas:execution
- Valor predeterminado
--[no]experimental_materialize_param_files_directly
: “falso” -
Si materializas archivos de parámetros, hazlo con escrituras directas en el disco.
Etiquetas:execution
- Valor predeterminado
--[no]experimental_record_metrics_for_all_mnemonics
: “falso” - De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 nombres mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si eliges esta opción, se escribirán estadísticas para todos los nombres mnemotécnicos.
- Configuración predeterminada de
--experimental_repository_resolved_file=<a string>
: "" -
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
--[no]experimental_stream_log_file_uploads
: “falso” -
Transmite los archivos de registro directamente al almacenamiento remoto en lugar de escribirlos en el disco.
Etiquetas:affects_outputs
--explain=<a path>
predeterminado: ver la descripción-
Hace que el sistema de compilación explique cada paso ejecutado de la compilación. La explicación se escribe en el archivo de registro especificado.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]legacy_important_outputs
: “verdadero” -
Úsalo para suprimir la generación del campo legacy_outputs heredado en el evento TargetComplete. Se requieren importantes_resultados para la integración de Bazel con ResultStore.
Etiquetas:affects_outputs
- Valor predeterminado
--[no]materialize_param_files
: “falso” -
Escribe archivos de parámetros intermedios en el árbol de resultados incluso cuando se usa la ejecución de acciones remotas. Es útil para depurar acciones. Esto está implícito por --subcommands y --verbose_failures.
Etiquetas:execution
- Configuración predeterminada 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 modificados. Si el número proporcionado es -1, se mostrarán todas las opciones modificadas.
Etiquetas:terminal_output
- Valor predeterminado de
--max_test_output_bytes=<an integer>
: "-1" -
Especifica el tamaño máximo de registro por prueba que se puede emitir cuando --test_output es "errores" o "todos". Es útil para evitar abrumar los resultados con resultados de pruebas demasiado ruidosos. El encabezado de la prueba se incluye en el tamaño del registro. Los valores negativos no implican ningún límite. El resultado es todo o nada.
Etiquetas:test_runner
,terminal_output
,execution
--output_filter=<a valid Java regular expression>
predeterminado: ver la descripción-
Solo muestra advertencias para las reglas con un nombre que coincide con la expresión regular proporcionada.
Etiquetas:affects_outputs
--progress_report_interval=<an integer in 0-3600 range>
predeterminado: “0”-
Es la cantidad de segundos entre los informes sobre los trabajos que aún se están ejecutando. El valor predeterminado 0 significa que el primer informe se imprimirá después de 10 segundos, luego de 30 segundos y, luego, ese progreso se informa 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 con fallas y "success" para imprimir solo cuando se ejecuta correctamente, y "all" para imprimir siempre.
Etiquetas:terminal_output
- Valor predeterminado
--[no]sandbox_debug
: “falso” -
Habilita funciones de depuración para la función de zona de pruebas. Esto incluye dos cosas: en primer lugar, el contenido raíz de la zona de pruebas no se modifica después de una compilación (y si la zona de pruebas está en uso, el sistema de archivos se activa) y el segundo, imprime información de depuración adicional en la ejecución. Esto puede ayudar a los desarrolladores de reglas de Bazel o Starlark con fallas de depuración debido a archivos de entrada faltantes, etcétera.
Etiquetas:terminal_output
- Configuración predeterminada de
--show_result=<an integer>
: “1” -
Muestra los resultados de la compilación. Para cada destino, indica si se actualizó o no y, si es así, una lista de los archivos de salida que se compilaron. Los archivos impresos son strings convenientes para copiar y pegar en el shell, a fin de ejecutarlos.
Esta opción requiere un argumento de número entero, que es la cantidad límite de destinos sobre los que no se imprime la información del resultado. Por lo tanto, cero causa la supresión del mensaje y MAX_INT hace que la impresión del resultado se produzca siempre. El valor predeterminado es uno.
Si no se creó nada para un destino, se pueden omitir los resultados a fin de mantener el resultado por debajo del umbral.
Etiquetas:affects_outputs
--[no]subcommands
[-s
] predeterminado: “false”-
Muestra los subcomandos que se ejecutaron durante una compilación. Marcas relacionadas: --execution_log_json_file, --execution_log_binary_file (para registrar subcomandos en un archivo en un formato compatible con la herramienta).
Etiquetas:terminal_output
--test_output=<summary, errors, all or streamed>
predeterminado: “resumen”-
Especifica el modo de salida deseado. Los valores válidos son “summary” para mostrar solo el resumen de estado de prueba, “errors” para imprimir también registros de prueba de pruebas fallidas, “all” para imprimir registros de todas las pruebas y “streamed” para generar registros de todas las pruebas en tiempo real (esto forzará que las pruebas se ejecuten a la vez de forma local, independientemente del valor de --test_Strategy).
Etiquetas:test_runner
,terminal_output
,execution
- Predeterminado de
--test_summary=<short, terse, detailed, none or testcase>
: “short” -
Especifica el formato deseado del resumen de la prueba. Los valores válidos son "short" para imprimir información solo sobre las pruebas ejecutadas, "terse" para imprimir información solo sobre las pruebas fallidas que se ejecutaron, "detailed" para imprimir información detallada de casos de prueba con errores, "testcase" para imprimir el resumen en la resolución del caso de prueba, no se imprime información detallada sobre los casos de prueba con errores y "none" para omitir el resumen.
Etiquetas:terminal_output
- Valor predeterminado
--[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
--[no]verbose_failures
: “falso” -
Si un comando falla, imprime la línea de comandos completa.
Etiquetas:terminal_output
- Opciones que especifican o alteran una entrada genérica en un comando de Bazel que no entra 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 requerido por un aspecto de la lista. Esta opción se puede usar varias veces. Sin embargo, no se pueden asignar valores al mismo parámetro más de una vez.
Etiquetas:loading_and_analysis
- Configuración predeterminada de
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Si no está vacío, lea el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Configuración predeterminada de
--target_pattern_file=<a string>
: "" -
Si se establece, la compilación leerá patrones del archivo que se nombra aquí, en lugar de la línea de comandos. Es un error especificar aquí un archivo y los patrones de la línea de comandos.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remoto:
--experimental_circuit_breaker_strategy=<failure>
predeterminado: ver la descripción-
Especifica la estrategia que debe usar el disyuntor. Las estrategias disponibles son “fallas”. Cuando el valor no es válido para la opción, el comportamiento es el mismo que el de la opción no configurada.
Etiquetas:execution
--experimental_downloader_config=<a string>
predeterminado: ver la descripción- Especifica un archivo para configurar el software de descarga remota. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para que coincida y otro para usar como URL sustituta, con referencias inversas a partir de "$1". Es posible proporcionar varias directivas "rewrite" para la misma URL, y en este caso se mostrarán varias.
- Valor predeterminado
--[no]experimental_guard_against_concurrent_changes
: “falso” - Desactiva esta opción para inhabilitar la verificación del tiempo de archivo 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.
- Valor predeterminado
--[no]experimental_remote_cache_async
: “falso” - Si es verdadero, la E/S de la caché remota ocurrirá en segundo plano, en lugar de tener lugar como parte de una generación.
--experimental_remote_cache_eviction_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar si la compilación encontró un error de expulsión de la caché remota. Un valor distinto de cero establecerá implícitamente --incompatible_remote_use_new_exit_code_for_lost_inputs como verdadero.
Etiquetas:execution
- Configuración predeterminada de
--experimental_remote_cache_ttl=<An immutable length of time.>
: "3 h" -
Es el TTL mínimo garantizado de BLOB en la caché remota después de que a sus resúmenes se les hizo referencia recientemente, p.ej., por un ActionResult o FindMissingBlobs. Bazel realiza varias optimizaciones basadas en el TTL de los BLOB, p.ej., no llama de manera repetida a GetActionResult en una compilación incremental. El valor debe establecerse un poco menos que el TTL real, ya que hay un intervalo entre el momento en que el servidor muestra los resúmenes y el momento en que Bazel los recibe.
Etiquetas:execution
--experimental_remote_capture_corrupted_outputs=<a path>
predeterminado: ver la descripción- Es una ruta de acceso a un directorio en el que se capturarán los resultados dañados.
- Valor predeterminado
--[no]experimental_remote_discard_merkle_trees
: “falso” - Si se establece como verdadero, descarta copias en la memoria del árbol Merkle de la raíz de entrada y las asignaciones de entrada asociadas durante las llamadas a GetActionResult() y Execute(). Esto reduce el uso de memoria de forma significativa, pero requiere que Bazel los vuelva a procesar cuando se produzcan errores de caché remota y los reintentos.
--experimental_remote_downloader=<a string>
predeterminado: ver la descripción- Un URI de extremo de la API de Remote Asset que se usará como proxy de descarga remota. Los esquemas admitidos son grpc, grpcs (grpc con TLS habilitado) y Unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel 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
--[no]experimental_remote_downloader_local_fallback
: “falso” - Indica si se volverá a la herramienta de descarga local si falla la descarga remota.
- Valor predeterminado
--[no]experimental_remote_execution_keepalive
: “falso” - Indica si se debe usar keepalive para las llamadas de ejecución remota.
- Configuración predeterminada de
--experimental_remote_failure_rate_threshold=<an integer in 0-100 range>
: “10” -
Establece la cantidad permitida de porcentaje de fallas en un período específico después de lo cual deja de llamar a la caché o al ejecutor remoto. De forma predeterminada, el valor es 10. Establecerlo en 0 significa que no hay limitación.
Etiquetas:execution
- Configuración predeterminada de
--experimental_remote_failure_window_interval=<An immutable length of time.>
: "60 s" -
El intervalo en el que se calcula la tasa de fallas de las solicitudes remotas. En un valor de cero o negativo, la duración de la falla se calcula en toda la ejecución.Las siguientes unidades se pueden usar: días (d), horas (h), minutos (m), segundos (s) y milisegundos (ms). Si se omite la unidad, el valor se interpreta como segundos.
Etiquetas:execution
- Valor predeterminado
--[no]experimental_remote_mark_tool_inputs
: “falso” - Si se establece como verdadera, Bazel marcará las entradas como entradas de herramienta para el ejecutor remoto. Esto se puede usar para implementar trabajadores remotos remotos.
- Valor predeterminado
--[no]experimental_remote_merkle_tree_cache
: “falso” - Si se establece como verdadera, se calculan los cálculos del árbol de Merkle para mejorar la velocidad de comprobación de aciertos de caché remota. La impresión del pie de la memoria de la caché está controlada por --experimental_remote_merkle_tree_cache_size.
- Valor predeterminado de
--experimental_remote_merkle_tree_cache_size=<a long integer>
: "1000" - Es la cantidad de árboles Mermel que se deben memorizar para mejorar la velocidad de comprobación de aciertos de caché remota. A pesar de que la caché se reduce automáticamente según el manejo de Java de las referencias flexibles, los errores de memoria insuficiente se pueden producir si se configura demasiado alto. Si se establece en 0, el tamaño de la caché es ilimitado. El valor óptimo varía según el tamaño del proyecto. La configuración predeterminada es 1,000.
- Configuración predeterminada de
--experimental_worker_for_repo_fetching=<off, platform or virtual>
: "desactivado" - Es el modo de subprocesos para usar en la recuperación de repositorios. Si se configura como "desactivada", no se usa ningún subproceso de trabajo, y la recuperación del repositorio está sujeta a reinicios. De lo contrario, usa un subproceso de plataforma (es decir, subproceso de SO) si se configura como “plataforma” o un subproceso virtual si se configura como “virtual”.
- Valor predeterminado
--[no]incompatible_remote_build_event_upload_respect_no_cache
: “falso” - Obsoleto. No-op. En su lugar, usa --remote_build_event_upload=minimal.
- Valor predeterminado de
--[no]incompatible_remote_disallow_symlink_in_tree_artifact
: “verdadero” -
Si se establece como verdadera, una acción ejecutada de forma remota no puede producir un artefacto de árbol que contenga un symlink relativo. No se permiten symlinks absolutos independientemente de esta marca.
Etiquetas:execution
,incompatible_change
- Valor predeterminado de
--[no]incompatible_remote_downloader_send_all_headers
: “verdadero” -
Indica si se deben enviar todos los valores de un encabezado de varios valores a la descarga remota, en lugar de solo al primero.
Etiquetas:incompatible_change
- Valor predeterminado
--[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
- Valor predeterminado de
--[no]incompatible_remote_results_ignore_disk
: “verdadero” -
Si se establece como verdadero, no se aplicarán --noremote_upload_local_results y --noremote_accept_cached a la caché de disco. Si se configuran tanto --disk_cache como --remote_cache (caché combinado):
--noremote_upload_local_results hará que se escriban los resultados en la caché de disco, pero no se subirán a la caché remota.
--noremote_accept_cached hará que Bazel revise los resultados en la caché de disco, pero no en la caché remota.
Las acciones no-remote-exec pueden alcanzar la caché del disco.
Consulta #8216 para obtener más detalles.
Etiquetas:incompatible_change
- Valor predeterminado de
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
: “verdadero” -
Si se establece como verdadera, Bazel usará el nuevo código de salida 39 en lugar de 34 si la caché remota desaloja BLOB durante la compilación.
Etiquetas:incompatible_change
- Valor predeterminado de
--[no]remote_accept_cached
: “verdadero” - Indica si se deben aceptar los resultados de la acción almacenados en caché de forma remota.
- Configuración predeterminada de
--remote_build_event_upload=<all or minimal>
: “mínima” - Si se configura en "todos", todos los resultados locales a los que hace referencia 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 bytestream:// siempre se usa para el URI de los archivos, incluso si faltan en la caché remota. La configuración predeterminada es “minimal”.
--remote_bytestream_uri_prefix=<a string>
predeterminado: ver la descripción- Es el nombre de host y el nombre de instancia que se usarán en los URI de bytestream:// que se escribirán en las transmisiones de eventos de compilación. Esta opción se puede establecer cuando se realizan compilaciones mediante un proxy, lo que hace que los valores de --remote_executor y --remote_instance_name ya no correspondan al nombre canónico del servicio de ejecución remota. Si no se configura, el valor predeterminado será "${hostname}/${instance_name}".
--remote_cache=<a string>
predeterminado: ver la descripción- Un URI de un extremo de almacenamiento en caché. Los esquemas admitidos son http, https, grpc, grpcs (grpc con TLS habilitado) y Unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel se establecerá de forma predeterminada en grpcs. Especifica grpc://, http:// o unix: schema para inhabilitar TLS. Consulta https://bazel.build/remote/caching
- Valor predeterminado
--[no]remote_cache_compression
: “falso” - Si está habilitado, comprime o descomprime los BLOB de caché con zstd.
- 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 especificando la marca varias veces. Varios valores para el mismo nombre se convertirán en una lista separada por comas.
- Se acumulan
--remote_default_exec_properties=<a 'name=value' assignment>
usos múltiples -
Configura las propiedades Exec predeterminadas que se usarán como plataforma de ejecución remota si una plataforma de ejecución aún no establece exec_properties.
Etiquetas:affects_outputs
- Configuración predeterminada de
--remote_default_platform_properties=<a string>
: "" - Configura las propiedades de la plataforma predeterminadas que se establecerán para la API de ejecución remota si la plataforma de ejecución aún no configuró remota_execution_properties. Este valor también se usará si se selecciona la plataforma host como plataforma de ejecución para la ejecución remota.
- Se acumulan
--remote_downloader_header=<a 'name=value' assignment>
usos múltiples - Especifica un encabezado que se incluirá en las solicitudes de descarga remota: --remote_downloader_header=Name=Value. Se pueden pasar varios encabezados especificando la marca varias veces. Varios valores para el mismo nombre se convertirán en una lista separada por comas.
- Se acumulan
--remote_exec_header=<a 'name=value' assignment>
usos múltiples - Especifica un encabezado que se incluirá en las solicitudes de ejecución: --remote_exec_header=Name=Value. Se pueden pasar varios encabezados especificando la marca varias veces. Varios valores para el mismo nombre se convertirán en una lista separada por comas.
--remote_execution_priority=<an integer>
predeterminado: “0”- La prioridad relativa de las acciones que se ejecutarán de forma remota. La semántica de los valores de prioridad particulares depende del servidor.
--remote_executor=<a string>
predeterminado: ver la descripción- HOST o HOST:PORT de un extremo de ejecución remota. Los esquemas admitidos son grpc, grpcs (grpc con TLS habilitado) y Unix (sockets UNIX locales). Si no se proporciona un esquema, Bazel se establecerá de forma predeterminada en grpcs. Especifica el esquema grpc:// o unix: para inhabilitar TLS.
--remote_grpc_log=<a path>
predeterminado: ver la descripción- Si se especifica, una ruta de acceso a un archivo para registrar los detalles relacionados con la llamada de gRPC. Este registro consiste en una secuencia de com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry protobufs serializados con cada prefijo precedido por un varino que denota el tamaño del siguiente mensaje protobuf serializado, como lo realiza el método LogEntry.writeDelimitedTo(OutputStream).
- Se acumulan
--remote_header=<a 'name=value' assignment>
usos múltiples - Especifica un encabezado que se incluirá en las solicitudes: --remote_header=Name=Value. Se pueden pasar varios encabezados especificando la marca varias veces. Varios valores para el mismo nombre se convertirán en una lista separada por comas.
- Configuración predeterminada de
--remote_instance_name=<a string>
: "" - Valor para pasar como instance_name en la API de ejecución remota.
- Valor predeterminado
--[no]remote_local_fallback
: “falso” - Indica si se debe recurrir a la estrategia de ejecución local independiente si falla la ejecución remota.
- Configuración predeterminada de
--remote_local_fallback_strategy=<a string>
: “local” - No-op, dejó de estar disponible. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/7480.
- Valor predeterminado de
--remote_max_connections=<an integer>
: "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 limitación.
Para la caché remota de 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 el ejecutor/caché 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 la descripción- Conéctate a la caché remota mediante 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.
- Configuración predeterminada de
--remote_retries=<an integer>
: “5” - Es la cantidad máxima de intentos para reintentar un error transitorio. Si se establece en 0, los reintentos están inhabilitados.
- Valor predeterminado de
--remote_retry_max_delay=<An immutable length of time.>
: “5 s” - Es el retraso máximo de retirada entre intentos de reintento remoto. 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.
- Configuración predeterminada de
--remote_timeout=<An immutable length of time.>
: "60 s" - La cantidad máxima de tiempo que se espera la ejecución remota y las llamadas en caché. Para la caché de REST, este es el tiempo de espera de la conexión y el 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.
- Valor predeterminado de
--[no]remote_upload_local_results
: “verdadero” - Indica si se deben subir los resultados de acciones ejecutadas de forma local a la caché remota si esta la admite y el usuario está autorizado para hacerlo.
- Valor predeterminado de
--[no]remote_verify_downloads
: “verdadero” - Si se establece 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.
- Opciones misceláneas, pero que no estén categorizadas de otra manera:
- Configuración predeterminada de
--auto_output_filter=<none, all, packages or subpackages>
: “ninguno” - Si no se especifica --output_filter, el valor de esta opción se usará para crear un filtro automáticamente. Los valores permitidos son “none”, “no filtrar / mostrar todo”, “todos” (filtrar todo / no mostrar nada), “paquetes” (con resultados de las reglas en paquetes mencionados en la línea de comandos Blaze) y “subpaquetes” (como “paquetes”, pero también incluyen subpaquetes). Para los valores “paquetes” y “subpaquetes”, //java/foo y //javatests/foo se tratan como un paquete).
- Valor predeterminado
--[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 los obliga a compilar (pero no ejecutarlos).
- Configuración predeterminada de
--build_tag_filters=<comma-separated list of options>
: "" - 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 etiquetas excluidas. Esta opción no afecta el conjunto de pruebas ejecutadas con el comando “test” (estas están regidas por las opciones de filtrado de pruebas, por ejemplo “--test_tag_filters”).
- Valor predeterminado
--[no]build_tests_only
: “falso” - Si se especifica, solo se compilarán las reglas *_test y test_suite, y se ignorarán los demás destinos especificados en la línea de comandos. De forma predeterminada, se compilarán todos los datos solicitados.
- Configuración predeterminada de
--combined_report=<none or lcov>
: “ninguno” - Especifica el tipo de informe de cobertura acumulativa deseado. Por el momento, solo se admite el LCOV.
- Valor predeterminado
--[no]compile_one_dependency
: “falso” - Compila una sola dependencia de los archivos de argumentos. Esto resulta útil para verificar archivos de origen en IDE, por ejemplo, mediante la compilación de un solo destino que depende del archivo de origen para detectar errores lo antes posible en el ciclo de edición, compilación y prueba. Este argumento afecta la forma en que se interpretan todos los argumentos que no son de marca. 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 depende 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” existente. Por ejemplo, después de borrar x/y/BUILD en tu cliente, el sistema de compilación puede reclamar si encuentra una etiqueta "//x:y/z" si aún lo proporciona otra entrada package_path. Si se especifica --DELETED_packages x/y, se evita este problema.
- Valor predeterminado
--[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 adicionales.
--disk_cache=<a path>
predeterminado: ver la descripción- 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á.
- Configuración predeterminada de
--embed_label=<a one-line string>
: "" - Incorpora la revisión del control fuente o la etiqueta de la versión en el objeto binario
--execution_log_binary_file=<a path>
predeterminado: ver la descripción- Registra las generaciones ejecutadas en este archivo como 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 manera estable (puede requerir una gran cantidad de CPU y memoria). Marcas relacionadas: --execution_log_json_file (formato JSON de texto ordenado), --experimental_execution_log_file (formato binario protobuf), --subcomandos (para mostrar subcomandos en el resultado de la terminal).
--execution_log_json_file=<a path>
predeterminado: ver la descripción- Registra las generaciones ejecutadas en este archivo como representación JSON de los protos 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 manera estable (puede requerir una gran cantidad 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 la salida de la terminal).
- Valor predeterminado de
--[no]execution_log_sort
: “verdadero” - Indica si se debe ordenar el registro de ejecución. Se configura como falso para mejorar el rendimiento de la memoria, a costa de producir el registro en orden no determinista.
- Valor predeterminado de
--[no]expand_test_suites
: “verdadero” -
Expande los objetivos test_suite en sus pruebas constituyentes antes del análisis. Cuando esta marca está activada (predeterminada), se aplican los patrones de destino negativos a las pruebas que pertenecen al conjunto de pruebas. De lo contrario, no se aplicarán. Desactivar esta marca es útil cuando se aplican aspectos de nivel superior en la línea de comandos, ya que pueden analizar los objetivos de test_suite.
Etiquetas:loading_and_analysis
--experimental_dynamic_ignore_local_signals=<a comma-separated list of signal numbers>
predeterminado: ver la 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 estos indicadores, se podrá finalizar la rama remota. En el caso de los trabajadores persistentes, esto solo afecta a los indicadores que finalizan el proceso del trabajador.
Etiquetas:execution
--experimental_execution_log_file=<a path>
predeterminado: ver la descripción- Registra las generaciones ejecutadas en este archivo como protos de Spawn delimitados, según src/main/protobuf/spawn.proto. Este archivo está escrito en el orden de ejecución de los spagens. Marcas relacionadas: --execution_log_binary_file (formato binario protobuf), --execution_log_json_file (formato JSON de texto ordenado) y subcomandos (para mostrar subcomandos en el resultado de la terminal).
- Valor predeterminado
--[no]experimental_execution_log_spawn_metrics
: “falso” - Incluye las métricas de generación en el registro de generación ejecutado.
- Configuración predeterminada de
--experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "" - Dejó de estar disponible y se reemplazó por otro. Filtra un conjunto de objetivos para el que se programan acciones_adicionales.
- Valor predeterminado
--[no]experimental_extra_action_top_level_only
: “falso” - Dejó de estar disponible y se reemplazó por otro. Solo programa acciones extra_actions para objetivos de nivel superior.
- Valor predeterminado de
--[no]experimental_prioritize_local_actions
: “verdadero” -
Si se configuran, las acciones que solo se pueden ejecutar de forma local tienen la primera oportunidad de adquirir recursos, los trabajadores que se ejecutan de forma dinámica tienen una segunda oportunidad y las acciones independientes ejecutadas de forma dinámica van al final.
Etiquetas:execution
--experimental_spawn_scheduler
-
Habilita la ejecución dinámica ejecutando acciones de manera local y remota. Bazel genera cada acción de forma local y remota y elige la que se complete primero. Si una acción admite trabajadores, la acción local se ejecutará en modo de trabajador persistente. Si deseas habilitar la ejecución dinámica para una acción mnemónica individual, usa las marcas "--internal_spawn_scheduler" y "--Strategy=<mnemonic>=dynamic".
Se expande a:
--internal_spawn_scheduler
--spawn_strategy=dynamic
- Valor predeterminado
--[no]experimental_worker_sandbox_hardening
: “falso” -
Si está habilitada, los trabajadores se ejecutan en una zona de pruebas endurecida si la implementación lo permite.
Etiquetas:execution
- Valor predeterminado
--[no]ignore_unsupported_sandboxing
: “falso” - No muestres una advertencia cuando el sistema no admita la ejecución de la zona de pruebas.
- Valor predeterminado
--[no]incompatible_dont_use_javasourceinfoprovider
: “falso” -
No-op
Etiquetas:incompatible_change
- Configuración predeterminada de
--local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>
: "HOST_CPUS" - Establece explícitamente la cantidad total de núcleos de CPU locales disponibles en Bazel para que se inviertan en acciones de compilación ejecutadas de forma local. Toma un número entero, o “HOST_CPUS”, opcionalmente seguido de [-|*]<float> (p. ej., HOST_CPUS*.5 para usar la mitad de los núcleos de CPU disponibles. De forma predeterminada, ("HOST_CPUS"), Bazel consultará la configuración del sistema para calcular la cantidad de núcleos de CPU disponibles.
- Se acumulan
--local_extra_resources=<a named float, 'name=value'>
usos múltiples - Establece la cantidad de recursos adicionales disponibles en Bazel. Toma un par de número de punto flotante de string. Se puede usar varias veces para especificar varios tipos de recursos adicionales. Bazel limitará las acciones que se ejecutan en simultáneo en función de los recursos adicionales disponibles y los necesarios. Las pruebas pueden declarar la cantidad de recursos adicionales que necesitan mediante una etiqueta del formato “resources:<resoucename>:<amount>”. La CPU, la RAM y los recursos disponibles no se pueden configurar con esta marca.
- Configuración predeterminada de
--local_ram_resources=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
: "HOST_RAM*.67" - Establece explícitamente la cantidad total de RAM del host local (en MB) disponible para Bazel y destinarla a acciones de compilación ejecutadas de forma local. Toma un número entero, o “HOST_RAM”, 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 usará el 67% de este.
- Configuración predeterminada 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 una ruta de acceso local con el formato <nombre del repositorio>=<ruta>. Si la ruta específica es absoluta, se usará tal como está. Si la ruta dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso determinada comienza con “%workspace%”, se relaciona con la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Configuración predeterminada de
--package_path=<colon-separated list of options>
: "%workspace%" - Una lista separada por dos puntos en la que se buscan los paquetes. Los elementos que comienzan con "%workspace%" se relacionan con el lugar de trabajo que lo rodea. Si se omite o se deja vacío, el valor predeterminado es el resultado de "bazel info default-package-path".
- Valor predeterminado de
--[no]show_loading_progress
: “verdadero” - Si se habilita, Bazel imprime mensajes del tipo "Cargando paquete:".
- Configuración predeterminada de
--test_lang_filters=<comma-separated list of options>
: "" - 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 esos destinos de prueba escritos en los idiomas especificados. El nombre que se usa para cada idioma debe ser el mismo que el prefijo de la regla *_test, p.ej., “cc”, “java”, “py”, etc. Esta opción afecta el comportamiento --build_tests_only y el comando de prueba.
- Configuración predeterminada de
--test_size_filters=<comma-separated list of values: small, medium, large or enormous>
: "" - 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 tamaños excluidos. Esta opción afecta el comportamiento de --build_tests_only y el comando de prueba.
- Configuración predeterminada de
--test_tag_filters=<comma-separated list of options>
: "" - 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 destinos de prueba que contengan, al menos, una etiqueta incluida y que no contengan etiquetas excluidas. Esta opción afecta el comportamiento de --build_tests_only y el comando de prueba.
- Configuración predeterminada de
--test_timeout_filters=<comma-separated list of values: short, moderate, long or eternal>
: "" - Especifica una lista separada por comas de tiempos de espera de prueba. De manera opcional, cada tiempo de espera puede ir precedido de "-" a los tiempos de espera excluidos. Solo se encontrarán los objetivos de prueba que contengan al menos un tiempo de espera incluido y no contengan tiempos de espera excluidos. Esta opción afecta el comportamiento de --build_tests_only y el comando de prueba.
- Configuración predeterminada de
--workspace_status_command=<path>
: "" - Es un comando que se invoca al comienzo de la compilación para proporcionar información de estado sobre el lugar de trabajo en el formato de pares clave-valor. Consulte el manual de instrucciones 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
--[no]check_up_to_date
: “falso” -
No realices la compilación. Verifica si está actualizada. Si todos los destinos están actualizados, la compilación se completa correctamente. Si se debe ejecutar algún paso, se informa un error y la compilación falla.
Etiquetas:execution
- Valor predeterminado
--[no]experimental_inprocess_symlink_creation
: “falso” -
Hacer llamadas directas al sistema de archivos para crear árboles de symlink
Etiquetas:loading_and_analysis
,execution
,experimental
- Valor predeterminado
--[no]experimental_remotable_source_manifests
: “falso” -
Determina si se deben hacer acciones de manifiesto de manera remota.
Etiquetas:loading_and_analysis
,execution
,experimental
- Valor predeterminado
--[no]experimental_split_coverage_postprocessing
: “falso” -
Si es verdadero, Bazel ejecutará el procesamiento posterior de la cobertura para la prueba en una generación nueva.
Etiquetas:execution
- Valor predeterminado de
--[no]experimental_split_xml_generation
: “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 de prueba que contiene el registro de prueba. De lo contrario, Bazel genera un archivo test.xml como parte de la acción de prueba.
Etiquetas:execution
- Valor predeterminado
--[no]experimental_strict_fileset_output
: “falso” -
Si se habilita esta opción, los conjuntos de archivos tratarán todos los artefactos de salida como archivos normales. No recorrerán directorios ni serán sensibles a los symlinks.
Etiquetas:execution
- Valor predeterminado
--[no]experimental_use_semaphore_for_jobs
: “falso” - Si se establece como verdadera, además usa semaphore para limitar la cantidad de trabajos simultáneos.
Etiquetas:host_machine_resource_optimizations
,execution
- Configuración predeterminada de
--genrule_strategy=<comma-separated list of options>
: "" -
Especifica cómo ejecutar genrules. Esta marca se eliminará gradualmente. En su lugar, usa --spawn_strategy=<value> para controlar todas las acciones o --Strategy=Genrule=<value> a fin de controlar solo las reglas generales.
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 (“automático”, “HOST_CPUS”, “HOST_RAM”), opcionalmente seguido de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". Los valores deben estar entre 1 y 5,000. Los valores superiores a 2,500 pueden causar problemas de memoria. "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 tanto como sea posible después de un error. Si bien el objetivo que falló 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”-
Es la cantidad de subprocesos paralelos que se usarán en la fase de carga o análisis. Toma un número entero o una palabra clave ("auto", "HOST_CPUS", "HOST_RAM"), seguido de una operación ([-|*]<float>), p. ej., "auto", "HOST_CPUS*.5". "auto" establece un valor predeterminado razonable según los recursos del host. Debe ser 1 como mínimo.
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
: "" -
Agrega o quita claves de la información de ejecución de una acción según los términos nemotécnicos de la acción. Solo se aplica a las acciones que admiten información de ejecución. Muchas acciones comunes admiten información de ejecución, p.ej., Genrule, CppCompile, Javac, StarlarkAction, TestRunner. Cuando se especifican varios valores, el orden es importante porque muchas regex se pueden aplicar al mismo valor mnemotécnico.
Sintaxis: "regex=[+-]key,regex=[+-]key,...".
Ejemplos: “.*=+x,.*=-y,.*=+z” agrega “x” y “z” y quita “y” de la información de ejecución para todas las acciones.
“Genrule=+requiere-x” agrega “requiere-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 sean de Genenrule.
Etiquetas:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Habilita acciones persistentes de expansión de sintaxis y Android dex mediante el uso de trabajadores.
Se expande a:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
- Habilita el procesador de recursos persistente de Android mediante trabajadores.
Se expande a las siguientes ubicaciones:
--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
{12/1}2{2/1/2} {14/1} {14/1}--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
host_machine_resource_optimizations
execution
--persistent_multiplex_android_dex_desugar
-
Habilita acciones multiplexadas y desugar de Android multiplexadas persistentes con trabajadores.
Se expande a:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
Habilita el procesador de recursos multiplexados persistentes de Android con trabajadores.
Se expande a:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
{12/1}2 {14/1} {14/1/2}--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
host_machine_resource_optimizations
execution
--persistent_multiplex_android_tools
- Habilita herramientas para Android persistentes y multiplexadas (dexing, expansión de sintaxis, procesamiento de recursos).
Se expande a:
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Etiquetas:host_machine_resource_optimizations
,execution
- Valor predeterminado
--[no]skip_incompatible_explicit_targets
: “falso” -
Evita las orientaciones incompatibles que se indiquen explícitamente en la línea de comandos. De forma predeterminada, la compilación de estos destinos genera un error, pero se omiten de manera silenciosa cuando esta opción está habilitada. Consulta https://bazel.build/extending/platforms#skipping-incompatible-targets
Etiquetas:loading_and_analysis
- Configuración predeterminada de
--spawn_strategy=<comma-separated list of options>
: "" -
Especifica cómo se ejecutan las acciones de generación de forma predeterminada. Acepta una lista de estrategias separadas por comas de mayor a menor prioridad. Para cada acción, Bazel elige la estrategia que tiene la prioridad más alta que puede ejecutar la acción. El valor predeterminado es "remote,worker,sandboxed,local". Para obtener más información, consulta https://blog.bazel.build/2019/06/19/list-Strategy.html.
Etiquetas:execution
- Se acumulan
--strategy=<a '[name=]value1[,..,valueN]' assignment>
usos múltiples -
Especifica cómo distribuir la compilación de otras acciones de generación. Acepta una lista de estrategias separadas por comas de mayor a menor prioridad. Para cada acción, Bazel elige la estrategia que tiene 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 Genmnonic Genrule). Para obtener más información, consulta https://blog.bazel.build/2019/06/19/list-Strategy.html.
Etiquetas:execution
- Se acumulan
--strategy_regexp=<a '<RegexFilter>=value[,value]' assignment>
usos múltiples -
Anula la estrategia de generación que se debe usar para ejecutar acciones de generación que tengan descripciones que coincidan con un determinado filtro de regex_. Consulta --per_file_copt para obtener detalles sobre la coincidencia de regex_filter. Se usa el último regex_filter que coincide con la descripción. Esta opción anula otras marcas para especificar la estrategia. Ejemplo: --Strategy_regexp=//foo.*\.cc,-//foo/bar=local significa ejecutar acciones con la estrategia local si sus descripciones coinciden con //foo.*.cc, pero no con //foo/bar. Ejemplo: --Strategy_regexp='Compiling.*/bar=local --strategy_regexp=Compiling=sandboxed ejecutará "Compilando //foo/bar/baz" con la estrategia de "local", pero revertir el orden lo ejecutaría con "sandboxed".
Etiquetas:execution
- Valor predeterminado
--[no]use_target_platform_for_tests
: “falso” -
Si es verdadero, Bazel usará la plataforma de destino para ejecutar pruebas en lugar del grupo de ejecución de pruebas.
Etiquetas:execution
- Opciones que configuran la cadena de herramientas que se usa para la ejecución de la acción:
--android_compiler=<a string>
predeterminado: ver la descripción-
Es el compilador de destino de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Configuración predeterminada de
--android_crosstool_top=<a build target label>
: "//external:android/crosstool" -
Es la ubicación del compilador de C++ que se usa para las compilaciones de Android.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_grte_top=<a label>
predeterminado: ver la descripción-
El objetivo de Android: grte_top
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
- Configuración predeterminada de
--android_manifest_merger=<legacy, android or force_android>
: "android" -
Selecciona la combinación de manifiestos que se usará para las reglas android_binary. Marca para ayudar a realizar la transición a la combinación de manifiestos de Android desde la combinación heredada.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Configuración predeterminada de
--android_platforms=<a build target label>
: "" -
Establece las plataformas que usan los objetivos 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
- Configuración predeterminada de
--android_sdk=<a build target label>
: "@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 la descripción-
Es 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
- Configuración predeterminada de
--apple_crosstool_top=<a build target label>
: "@bazel_tools//tools/cpp:toolchain" -
Es la etiqueta del paquete crosstool que se usará en las reglas de Apple y Objc, así como sus dependencias.
Etiquetas:loses_incremental_state
,changes_inputs
--apple_grte_top=<a build target label>
predeterminado: ver la descripción-
El objetivo grte_top de Apple.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
- Configuración predeterminada de
--cc_output_directory_tag=<a string>
: "" -
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas:affects_outputs
,explicit_in_output_path
--compiler=<a string>
predeterminado: ver la descripción-
Es el compilador de C++ que se usará para compilar el destino.
Etiquetas:loading_and_analysis
,execution
- Configuración predeterminada de
--coverage_output_generator=<a build target label>
: "@bazel_tools//tools/test:lcov_merger" - Ubicación del objeto binario que se usa para procesar con posterioridad los informes de cobertura sin procesar. Actualmente, debe ser un grupo de archivos que contiene un solo archivo binario. La configuración predeterminada es “//tools/test:lcov_merger”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
- Configuración predeterminada de
--coverage_report_generator=<a build target label>
: "@bazel_tools//tools/test:coverage_report_generator" - Ubicación del objeto binario que se usa para generar informes de cobertura. Actualmente, debe ser un grupo de archivos que contiene un solo archivo binario. La configuración predeterminada es “//tools/test:coverage_report_generator”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
- Configuración predeterminada 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 de código. La configuración predeterminada es “//tools/test:coverage_support”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
- Configuración predeterminada de
--crosstool_top=<a build target label>
: "@bazel_tools//tools/cpp:toolchain" -
Es la etiqueta del paquete crosstool que se usará para compilar código C++.
Etiquetas:loading_and_analysis
,changes_inputs
,affects_outputs
--custom_malloc=<a build target label>
predeterminado: ver la 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 objetivos de valores con restricción separados por comas. Si un objetivo no coincide con ninguna expresión negativa y al menos una expresión positiva, la resolución de 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
- Valor predeterminado de
--[no]experimental_enable_objc_cc_deps
: “verdadero” -
Permite que las reglas objc_* dependan de cc_library, y cualquier dependencia de objc se compile con --cpu configurada en "ios_<--ios_cpu>" para cualquier valor en --ios_multi_cpu.
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado
--[no]experimental_include_xcode_execution_requirements
: “falso” -
Si está configurado, agrega un requisito de ejecución de “required-xcode:{version}” a cada acción de Xcode. Si la versión Xcode tiene una etiqueta con guion, también agrega un requisito de ejecución “required-xcode-label:{version_label}”.
Etiquetas:loses_incremental_state
,loading_and_analysis
,execution
- Valor predeterminado de
--[no]experimental_prefer_mutual_xcode
: “verdadero” -
Si es verdadero, usa la versión más reciente de Xcode que está disponible de forma local y remota. Si es falso o si no hay versiones mutuamente disponibles, usa la versión local de Xcode seleccionada mediante xcode-select.
Etiquetas:loses_incremental_state
- Configuración predeterminada de
--extra_execution_platforms=<comma-separated list of options>
: "" -
Son las plataformas disponibles como plataformas de ejecución para ejecutar acciones. Las plataformas se pueden especificar por objetivo exacto o como patrón de destino. Consideremos estas plataformas antes de las que se declare en el archivo WORKSPACE a través de registration_execution_platforms(). Esta opción solo se puede configurar una vez; las instancias posteriores anularán la configuración de marcas anterior.
Etiquetas:execution
- Se acumulan
--extra_toolchains=<comma-separated list of options>
usos múltiples -
Son las reglas que se deben considerar durante la resolución de la cadena de herramientas. Las cadenas de herramientas se pueden especificar por objetivo exacto o como patrón de destino. Las cadenas de herramientas se considerarán antes de las que se declaren en el archivo WORKSPACE a través deregister_toolchains().
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--grte_top=<a label>
predeterminado: ver la descripción-
Es una etiqueta para una biblioteca de libc registrada. La cadena de herramientas de Crosstool selecciona el valor predeterminado y casi nunca necesitas anularlo.
Etiquetas:action_command_lines
,affects_outputs
--host_compiler=<a string>
predeterminado: ver la descripción-
Es el compilador de C++ para usar en la compilación de hosts. Se ignora si no se configura --host_crosstool_top.
Etiquetas:loading_and_analysis
,execution
--host_crosstool_top=<a build target label>
predeterminado: ver la descripción-
De forma predeterminada, las opciones --crosstool_top y --compiler también se usan para la configuración de ejecución. Si se proporciona esta marca, Bazel usa el compilador y libc predeterminado para la crosstool_top determinada.
Etiquetas:loading_and_analysis
,changes_inputs
,affects_outputs
--host_grte_top=<a label>
predeterminado: ver la descripción-
Si se especifica, este parámetro de configuración anula el directorio de nivel superior de libc (--grte_top) para la configuración de ejecución.
Etiquetas:action_command_lines
,affects_outputs
- Configuración predeterminada de
--host_platform=<a build target label>
: “@local_config_platform//:host” -
Es la etiqueta de una regla de plataforma que describe el sistema host.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
- Valor predeterminado de
--[no]incompatible_disable_expand_if_all_available_in_flag_set
: “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
- Valor predeterminado de
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
: “verdadero” -
Si es verdadero, Bazel no habilitará las funciones de “host” y “no host” en la cadena de herramientas de c++ (consulta https://github.com/bazelbuild/bazel/issues/7407 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado
--[no]incompatible_enable_android_toolchain_resolution
: “falso” -
Usa la resolución de la cadena de herramientas con el fin de seleccionar el SDK de Android para las reglas de Android (Starlark y nativo)
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado
--[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
- Valor predeterminado de
--[no]incompatible_make_thinlto_command_lines_standalone
: “verdadero” -
Si es verdadero, Bazel no volverá a usar las líneas de comandos de acción de vínculo de C++ para indexar líneas de comandos 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
: “verdadero” -
Si es verdadero, las reglas integradas de ObjC obtendrán la información de vinculación de CcInfo en lugar de ObjcProvider. Consulta https://github.com/bazelbuild/bazel/issues/16939 para obtener más información y detalles sobre la migración.
Etiquetas:loading_and_analysis
,changes_inputs
,incompatible_change
- Valor predeterminado de
--[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain
: “verdadero” -
Si es verdadero, Bazel se quejará cuando se establezcan los atributos cc_toolchain.cpu y cc_toolchain.compiler (consulte las instrucciones de migración para https://github.com/bazelbuild/bazel/issues/7075).
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]incompatible_remove_legacy_whole_archive
: “verdadero” -
Si es verdadero, Bazel no vinculará las dependencias de la biblioteca como archivo completo de forma predeterminada (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener instrucciones de migración).
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]incompatible_require_ctx_in_configure_features
: “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 la cadena de herramientas lo admite. 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 la descripción-
Especifica la versión del SDK de iOS que se usará para compilar aplicaciones para iOS. Si no se especifica, se usará la versión predeterminada del SDK de iOS de "xcode_version".
Etiquetas:loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: ver la descripción-
Especifica la versión del SDK de macOS que se usará para compilar aplicaciones de ese sistema operativo. 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 la descripción-
Es la versión mínima del SO a la que se orienta tu compilación.
Etiquetas:loading_and_analysis
,affects_outputs
- Configuración predeterminada de
--platform_mappings=<a relative path>
: "" -
Es la ubicación de un archivo de asignación que describe qué plataforma usar si no se estableció ninguna o qué marcas configurar cuando ya existe una plataforma. Debe estar relacionado con la raíz del lugar de trabajo principal. La configuración predeterminada es “platform_mappings” (un archivo directamente debajo de la raíz del lugar de trabajo).
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
- Configuración predeterminada de
--platforms=<a build target label>
: "" -
Las etiquetas de las reglas de la plataforma que describen las plataformas de destino para el comando actual.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--python2_path=<a string>
predeterminado: ver la descripción-
Obsoleto, no-op. Inhabilitado por "--incompatible_use_python_toolchains".
Etiquetas:no_op
,deprecated
--python3_path=<a string>
predeterminado: ver la descripción-
Obsoleto, no-op. Inhabilitado por "--incompatible_use_python_toolchains".
Etiquetas:no_op
,deprecated
--python_path=<a string>
predeterminado: ver la descripción-
Es la ruta de acceso absoluta del intérprete de Python que se invoca 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 la descripción-
Es la etiqueta de un py_runtime que representa al intérprete de Python invocado para ejecutar los objetivos de Python en la plataforma de destino. Obsoleto; inhabilitado por --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: ver la descripción-
Especifica la versión del SDK de tvOS que se usará para compilar aplicaciones 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 la descripción-
Especifica la versión del SDK de watchOS para compilar aplicaciones de watchOS. Si no se especifica, se usará la versión predeterminada del SDK de watchOS desde "xcode_version".
Etiquetas:loses_incremental_state
--xcode_version=<a string>
predeterminado: ver la descripción-
Si se especifica, usa Xcode de la versión determinada para acciones de compilación relevantes. Si no se especifica, se usa la versión predeterminada del ejecutor de Xcode.
Etiquetas:loses_incremental_state
- Configuración predeterminada 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
--[no]apple_enable_auto_dsym_dbg
: “falso” -
Determina si deseas forzar la generación de archivos de símbolos de depuración (.dSYM) para las compilaciones de base de datos.
Etiquetas:affects_outputs
,action_command_lines
- Valor predeterminado
--[no]apple_generate_dsym
: “falso” -
Indica si se deben generar archivos de símbolos de depuración (.dSYM).
Etiquetas:affects_outputs
,action_command_lines
- Valor predeterminado de
--[no]build
: “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 muestra cero si las fases de carga y análisis del paquete se completaron correctamente. Este modo es útil para probar esas fases.
Etiquetas:execution
,affects_outputs
- Valor predeterminado de
--[no]build_runfile_links
: “verdadero” -
Si es verdadero, compile bosques de symlink de archivos de ejecución para todos los destinos. Si es falso, escribe solo manifiestos cuando sea posible.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]build_runfile_manifests
: “verdadero” -
Si es verdadero, escribe los manifiestos de archivos run para todos los destinos. Si es falso, omítela. No se ejecutarán las pruebas locales cuando sean falsas.
Etiquetas:affects_outputs
- Valor predeterminado
--[no]build_test_dwp
: “falso” -
Si se habilita, cuando se compilen pruebas de C++ de forma estática y con fisiones, también se compilará automáticamente el archivo .dwp para el objeto binario de prueba.
Etiquetas:loading_and_analysis
,affects_outputs
- Configuración predeterminada de
--cc_proto_library_header_suffixes=<comma-separated set of options>
: “.pb.h” -
Establece los prefijos de los archivos de encabezado que crea una cc_proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
- Configuración predeterminada de
--cc_proto_library_source_suffixes=<comma-separated set 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
--[no]experimental_proto_descriptor_sets_include_source_info
: “falso” - Ejecuta acciones adicionales para versiones alternativas de la API de Java en una biblioteca proto_.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
- Valor predeterminado
--[no]experimental_proto_extra_actions
: “falso” - Ejecuta acciones adicionales para versiones alternativas de la API de Java en una biblioteca proto_.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
- Valor predeterminado de
--[no]experimental_run_validations
: “verdadero” - Usa --run_validates en su lugar.
Etiquetas:execution
,affects_outputs
- Valor predeterminado
--[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
--[no]experimental_use_validation_aspect
: “falso” - Determina si se deben ejecutar acciones de validación mediante el aspecto (paralelismo con pruebas).
Etiquetas:execution
,affects_outputs
- Valor predeterminado de
--fission=<a set of compilation modes>
: "no" -
Especifica los modos de compilación que usan fisión para las compilaciones y vínculos de C++. Puede ser cualquier combinación de {'fastbuild', 'dbg', 'opt'} o los valores especiales 'yes' para habilitar todos los modos y 'no' para inhabilitar todos los modos.
Etiquetas:loading_and_analysis
,action_command_lines
,affects_outputs
- Valor predeterminado de
--[no]incompatible_always_include_files_in_data
: “verdadero” -
Si es verdadero, las reglas nativas agregan <code>DefaultInfo.files</code> de dependencias de datos a sus runfiles, lo que coincide con el comportamiento recomendado para las reglas de Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid).
Etiquetas:affects_outputs
,incompatible_change
- Valor predeterminado de
--[no]legacy_external_runfiles
: “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
--[no]objc_generate_linkmap
: “falso” -
Especifica si se debe generar un archivo de mapa de vínculo.
Etiquetas:affects_outputs
- Se acumulan
--output_groups=<comma-separated list of options>
usos múltiples -
Es una lista de nombres de grupos de salida separados por comas, cada uno de los cuales puede tener el prefijo + o -. Los grupos con el prefijo + se agregan al conjunto predeterminado, 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 bar, mientras que --output_groups=foo,bar anula el conjunto predeterminado de modo que solo se compilen foo y bar.
Etiquetas:execution
,affects_outputs
- Valor predeterminado de
--[no]run_validations
: “verdadero” -
Indica si se deben ejecutar acciones de validación como parte de la compilación. Consulta https://bazel.build/extending/rules#validation_actions
Etiquetas:execution
yaffects_outputs
- Valor predeterminado
--[no]save_temps
: “falso” -
Si se establece, se guardarán los resultados temporales de gcc. Esto incluye archivos .s (código ensamblador), archivos .i (C procesados previamente) y archivos .ii (C++ procesados previamente).
Etiquetas:affects_outputs
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
- Se acumulan
--action_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica el conjunto de variables de entorno disponibles para las acciones con la configuración de destino. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación o por el par nombre=valor que establece el valor independientemente del entorno de invocación. Esta opción se puede usar varias veces. Para las opciones proporcionadas para la misma variable, se acumulan las últimas victorias y las opciones de variables diferentes.
Etiquetas:action_command_lines
- Configuración predeterminada de
--android_cpu=<a string>
: “armeabi-v7a” -
La CPU de destino de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Valor predeterminado
--[no]android_databinding_use_androidx
: “falso” -
Genera archivos de vinculación de datos compatibles con AndroidX. Esto solo se usa con la vinculación de datos v2.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Valor predeterminado
--[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
- Configuración predeterminada de
--android_dynamic_mode=<off, default or fully>
: "desactivado" -
Determina si las dependencias de C++ de las reglas de Android se vincularán de forma dinámica cuando un cc_binary no cree una biblioteca compartida de manera explícita. “default” significa que Bazel elegirá si se vinculará de forma dinámica. "completamente" significa que todas las bibliotecas se vincularán de manera dinámica. "off" significa que todas las bibliotecas se vincularán en su mayoría en modo estático.
Etiquetas:affects_outputs
,loading_and_analysis
- 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. ALPHABETICAL significa que los manifiestos se ordenan por ruta de acceso en relación con la ejecución de Execroot. ALPHABETICAL_BY_CONFIGURATION significa que los manifiestos se ordenan por rutas de acceso relativas al directorio de configuración dentro del directorio de salida. DEPENDENCY significa que los manifiestos se ordenan de acuerdo con el manifiesto de cada biblioteca que aparece antes de los manifiestos de sus dependencias.
Etiquetas:action_command_lines
,execution
- Valor predeterminado
--[no]android_resource_shrinking
: “falso” -
Habilita la reducción de recursos para los APK android_binary que usan ProGuard.
Etiquetas:affects_outputs
,loading_and_analysis
- 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 aspecto_aspecto especifica proveedores de aspecto necesarios mediante el tipo obligatorio_aspect_providers, algunos_aspectos se ejecutarán después de cada aspecto que se mencionó antes de él en la lista de aspectos, cuyos proveedores anunciados satisfacen algunos proveedores de aspecto obligatorios. Además, algunos_aspectos se ejecutarán luego de que todos los aspectos obligatorios que se especifican en él requieren un atributo. De esta manera, algunos tendrán acceso a los valores de los proveedores de dichos aspectos. <bzl-file-label>%<aspect_name>, por ejemplo, "//tools:my_def.bzl%my_aspect", en el que "my_aspect" es un valor de nivel superior de una herramienta de archivo/my_def.bzl.
--[no]build_python_zip
predeterminado: “automático”-
Crear un archivo ZIP ejecutable de Python; activado en Windows, desactivado en otras plataformas
Etiquetas:affects_outputs
- Se acumulan
--catalyst_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se pueden crear objetos binarios de Apple Catalyst.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Valor predeterminado
--[no]collect_code_coverage
: “falso” -
Si se especifica, Bazel instrumentará el código (mediante la instrumentación sin conexión cuando sea posible) y recopilará información de cobertura durante las pruebas. Solo se verán afectados los objetivos que coincidan con --instrumentation_filter. Por lo general, esta opción no se debe especificar directamente. En su lugar, se debe usar el comando "bazel cobertura".
Etiquetas:affects_outputs
- Configuración predeterminada de
--compilation_mode=<fastbuild, dbg or opt>
[-c
]: "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 fuente de 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
- Configuración predeterminada de
--cpu=<a string>
: "" -
La CPU de destino.
Etiquetas:changes_inputs
,affects_outputs
,explicit_in_output_path
--cs_fdo_absolute_path=<a string>
predeterminado: ver la descripción- Usa la información de perfil de CSFDO para optimizar la compilación. Especifica el nombre absoluto de ruta de acceso 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 la descripción-
Genera objetos binarios con instrumentación de FDO sensible al contexto. Con el compilador Clang/LLVM, también acepta el nombre del directorio bajo el cual se vuelcan los archivos de perfil sin procesar en el tiempo de ejecución.
Etiquetas:affects_outputs
--cs_fdo_profile=<a build target label>
predeterminado: ver la descripción-
Es el cs_fdo_profile que representa el perfil sensible al contexto que se usará para la optimización.
Etiquetas:affects_outputs
- Se acumulan
--cxxopt=<a string>
usos múltiples -
Opción adicional de pasar a GCC cuando se compilan archivos fuente C++.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--define=<a 'name=value' assignment>
usos múltiples -
Cada opción de definición define una asignación para una variable de compilación.
Etiquetas:changes_inputs
,affects_outputs
--dynamic_mode=<off, default or fully>
predeterminado: “default”-
Determina si los objetos binarios de C++ se vincularán de manera dinámica. “default” significa que Bazel elegirá si se vinculará de forma dinámica. "completamente" significa que todas las bibliotecas se vincularán de manera dinámica. "off" significa que todas las bibliotecas se vincularán en su mayoría en modo estático.
Etiquetas:loading_and_analysis
,affects_outputs
- Valor predeterminado de
--[no]enable_fdo_profile_absolute_path
: “verdadero” -
Si se establece, el uso de fdo_Absolute_profile_path generará un error.
Etiquetas:affects_outputs
--[no]enable_runfiles
predeterminado: “automático”-
Habilita el árbol de 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 -
Dejó de estar disponible y se reemplazó por otro. Usa action_listener para adjuntar una extra_action a las acciones de compilación existentes.
Etiquetas:execution
,experimental
- Valor predeterminado
--[no]experimental_android_compress_java_resources
: “falso” -
Comprime los recursos Java en APK
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
- Valor predeterminado
--[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
--[no]experimental_android_resource_shrinking
: “falso” -
Habilita la reducción de recursos para los APK android_binary que usan ProGuard.
Etiquetas:affects_outputs
,loading_and_analysis
- Valor predeterminado
--[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
- Valor predeterminado
--[no]experimental_convenience_symlinks
: "normal" -
Esta marca controla cómo se administrarán los symlinks de conveniencia (los symlinks que aparecen en el lugar de trabajo después de la compilación). Valores posibles: normal (predeterminado): Se creará o borrará cada tipo de symlink de conveniencia según lo determine la compilación.
limpio: Todos los symlinks se borrarán de forma incondicional.
Ignorar: Los vínculos simbólicos quedarán solos.
log_only: Genera mensajes de registro como si se pasara "normal", pero en realidad no realices ninguna operación del sistema de archivos (útil para las herramientas).
Ten en cuenta que solo se pueden ver afectados los symlinks cuyos nombres se generan con el valor actual de --symlink_prefix; si cambia el prefijo, los symlinks preexistentes quedarán solos.
Etiquetas:affects_outputs
- Valor predeterminado
--[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, BuildEventProtocolo tendrá una entrada para convenienciaSymlinksIdentified, que enumera todos los symlinks de conveniencia creados en su lugar de trabajo. Si es falso, la entrada convenienteSymlinksIdentified 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
- Valor predeterminado de
--experimental_objc_fastbuild_options=<comma-separated list of options>
: "-O0,-DDEBUG=1" -
Usa estas strings como opciones del compilador objc fastbuild.
Etiquetas:action_command_lines
- Valor predeterminado
--[no]experimental_omitfp
: “falso” -
Si es verdadero, usa libunwind para desenrollar la pila y compila con -fomit-frame-pointer y -faasync-unwind-tables.
Etiquetas:action_command_lines
,affects_outputs
,experimental
- Valor predeterminado
--[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 la CPU.
Etiquetas:affects_outputs
,experimental
- Valor predeterminado
--[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
- Configuración predeterminada de
--fat_apk_cpu=<comma-separated set of options>
: “armeabi-v7a” -
Esta opción habilita 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 las reglas android_binary.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Valor predeterminado
--[no]fat_apk_hwasan
: “falso” -
Indica si se deben crear divisiones de HWASAN.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--fdo_instrument=<a string>
predeterminado: ver la descripción-
Genera objetos binarios con instrumentación de FDO. Con el compilador Clang/LLVM, también acepta el nombre del directorio bajo el cual se vuelcan los archivos de perfil sin procesar en el tiempo de ejecución.
Etiquetas:affects_outputs
--fdo_optimize=<a string>
predeterminado: ver la 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 la descripción-
Usa sugerencias de carga previa de la caché.
Etiquetas:affects_outputs
--fdo_profile=<a build target label>
predeterminado: ver la 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 determinadas se habilitarán o inhabilitarán de forma predeterminada para los destinos compilados en la configuración de destino. Si especificas -<feature>, se inhabilitará la función. Los atributos negativos siempre anulan los positivos. Consulta también --host_features
Etiquetas:changes_inputs
,affects_outputs
- Valor predeterminado
--[no]force_pic
: “falso” -
Si se habilita, todas las compilaciones de C++ producen código independiente de posición ("-fPIC"), los vínculos prefieren bibliotecas compiladas previamente de PIC en lugar de bibliotecas que no son de PIC, y los vínculos producen ejecutables independientes de la posición ("-pie").
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan
--host_action_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica el conjunto de variables de entorno disponibles para las acciones con configuraciones de ejecución. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación o por el par nombre=valor que establece el valor independientemente del entorno de invocación. Esta opción se puede usar varias veces. Para las opciones proporcionadas para la misma variable, se acumulan las últimas victorias y las opciones de variables diferentes.
Etiquetas:action_command_lines
- Configuración predeterminada de
--host_compilation_mode=<fastbuild, dbg or opt>
: "opt" -
Especifica el modo en que se integrará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 de C cuando se compilan archivos de origen C (pero no de C++) en las configuraciones de ejecución.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--host_copt=<a string>
usos múltiples -
Opciones adicionales que se deben pasar al compilador C para las herramientas compiladas en las configuraciones de ejecución.
Etiquetas:action_command_lines
,affects_outputs
- Configuración predeterminada de
--host_cpu=<a string>
: "" -
Es la CPU del host.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan
--host_cxxopt=<a string>
usos múltiples -
Opciones adicionales que puedes pasar al compilador de C++ para herramientas compiladas en las configuraciones exec.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--host_features=<a string>
usos múltiples -
Las funciones determinadas estarán habilitadas o inhabilitadas de forma predeterminada para los destinos compilados en la configuración de ejecución. Si especificas -<feature>, se inhabilitará la función. Los atributos negativos siempre anulan los positivos.
Etiquetas:changes_inputs
,affects_outputs
--host_force_python=<PY2 or PY3>
predeterminado: ver la descripción-
Anula la versión de Python para la configuración de ejecución. Puede ser "PY2" o "PY3".
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan
--host_linkopt=<a string>
usos múltiples -
Opción adicional de pasar al vinculador cuando se vinculan herramientas en las configuraciones de ejecución.
Etiquetas:action_command_lines
,affects_outputs
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: ver la descripción-
Versión mínima compatible de macOS para los destinos de host. Si no se especifica, se usa “macos_sdk_version”.
Etiquetas:loses_incremental_state
- Se acumulan
--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 compilas ciertos archivos en las configuraciones de ejecución. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter representa una lista de patrones de expresión de inclusión y exclusión (también consulta --instrumentation_filter). Opción_1 a opción_n representa opciones de línea de comandos arbitrarias. Si una opción contiene una coma, se debe colocar una barra inversa. Las opciones pueden contener @. Solo se usa el primer @ 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 que puedes usar en swiftc para herramientas de ejecución.
Etiquetas:action_command_lines
,affects_outputs
- Valor predeterminado
--[no]incompatible_auto_exec_groups
: “falso” -
Cuando se habilita, se crea un grupo de ejecución automática para cada cadena de herramientas que usa una regla. Para que esto funcione, la regla debe especificar el parámetro “cadena” en sus acciones. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/17134.
Etiquetas:affects_outputs
,incompatible_change
- Valor predeterminado de
--[no]incompatible_avoid_conflict_dlls
: “verdadero” -
Si está habilitada, todas las bibliotecas dinámicas vinculadas a C++ (DLL) generadas por cc_library en Windows se renombrarán como name_{hash}.dll, en donde el hash se calcula en función del RepositoryName y la ruta del paquete de 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
- Valor predeterminado de
--[no]incompatible_merge_genfiles_directory
: “verdadero” -
Si es verdadero, el directorio genfiles se pliega en el directorio bin.
Etiquetas:affects_outputs
,incompatible_change
- Valor predeterminado
--[no]incompatible_use_host_features
: “falso” -
Si es verdadero, usa --features solo para la configuración de destino y --host_features para la configuración de ejecución.
Etiquetas:changes_inputs
,affects_outputs
,incompatible_change
- Valor predeterminado
--[no]instrument_test_targets
: “falso” - Cuando se habilita la cobertura, especifica si se deben considerar las reglas de prueba de instrumentación. Cuando se establece, se instrumentan las reglas de prueba incluidas por --instrumentation_filter. De lo contrario, las reglas de prueba siempre se excluyen de la instrumentación de cobertura.
Etiquetas:affects_outputs
- Configuración predeterminada de
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "-/javatests[/:],-/test/java[/:]" -
Cuando está habilitada la cobertura, solo se instrumentarán reglas con nombres incluidos en el filtro basado en regex especificado. En su lugar, se excluyen las reglas con el prefijo '-'. Ten en cuenta que solo se instrumentan reglas que no son de prueba, a menos que se habilite --instrument_test_targets.
Etiquetas:affects_outputs
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: ver la 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 ios_application. El resultado es un objeto binario universal que contiene todas las arquitecturas especificadas.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Valor predeterminado de
--[no]legacy_whole_archive
: “verdadero” -
Obsoleto y reemplazado por --incompatible_remove_legacy_whole_archive (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener más detalles). Cuando esté activado, use --whole-archive para las reglas cc_binary que tengan linkshared=True y linkstatic=True o --static en linkopt. 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 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 la descripción- Versión mínima compatible de macOS para los destinos. Si no se especifica, se usa “macos_sdk_version”.
Etiquetas:loses_incremental_state
- Valor predeterminado
--[no]objc_debug_with_GLIBCXX
: “falso” -
Si se establece y el modo de compilación se establece en "dbg", definirá GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC y GLIBCPP_CONCEPT_CHECKS.
Etiquetas:action_command_lines
- Valor predeterminado
--[no]objc_enable_binary_stripping
: “falso” -
Indica si se deben eliminar los símbolos y los códigos muertos en los objetos binarios vinculados. Se realizará la eliminación de objetos binarios si se especifican esta marca y --compilation_mode=opt.
Etiquetas:action_command_lines
- Se acumulan
--objccopt=<a string>
usos múltiples -
Opciones adicionales para pasar a gcc cuando se compilan archivos fuente 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 al compilar ciertos archivos. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter representa una lista de patrones de expresión de inclusión y exclusión (también consulta --instrumentation_filter). Opción_1 a opción_n representa opciones de línea de comandos arbitrarias. Si una opción contiene una coma, se debe colocar una barra inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la string. Ejemplo: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción -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 a backend de LTO (en --features=thin_lto) cuando se compilan ciertos objetos de backend. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter representa una lista de incluir y excluir patrones de expresión regular. option_1 a option_n significan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, se debe colocar una barra inversa. Las opciones pueden contener @. Solo se usa el primer @ 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 la descripción-
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas:loses_incremental_state
,affects_outputs
,loading_and_analysis
--propeller_optimize=<a build target label>
predeterminado: ver la descripción-
Usa la información del perfil de propulsor para optimizar el destino de compilación.Un perfil de propulsor debe tener al menos uno de dos archivos, un perfil de Cc y un perfil de ld. Esta marca acepta una etiqueta de compilación que debe hacer referencia a los archivos de entrada del perfil de 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 debe usarse como: --propeller_optimize=//a/b:propeller_profile
Etiquetas:action_command_lines
,affects_outputs
--propeller_optimize_absolute_cc_profile=<a string>
predeterminado: ver la descripción-
Es el nombre de ruta absoluta del archivo cc_profile para las compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
predeterminado: ver la descripción-
Nombre de ruta de acceso absoluto del archivo ld_profile para las compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
--run_under=<a prefix in front of command>
predeterminado: ver la descripción-
Es el prefijo que se insertará antes de los ejecutables para los comandos "test" y "run". Si el valor es "foo -bar" y la línea de comandos de ejecución es "test_binary -baz", la línea de comandos final es "foo -bar test_binary -baz".También puede ser una etiqueta para un destino ejecutable. Estos son algunos ejemplos: "valgrind", "strace", "strace -c", "valgrind --quiet --num-callers=20", "//package:target", "//package:target --options".
Etiquetas:action_command_lines
-
Si es verdadero, las bibliotecas nativas con funciones idénticas se compartirán entre diferentes destinos.
Etiquetas:loading_and_analysis
,affects_outputs
- Valor predeterminado
--[no]stamp
: “falso” -
Marca los objetos binarios con la fecha, el nombre de usuario, el nombre de host, la información del lugar de trabajo, etcétera.
Etiquetas:affects_outputs
- Predeterminado de
--strip=<always, sometimes or never>
: "A veces" -
Especifica si se deben quitar los objetos binarios y las bibliotecas compartidas (con "-Wl,--strip-debug"). El valor predeterminado de “a veces” significa quitar iff - --compilation_mode=fastbuild.
Etiquetas:affects_outputs
- Se acumulan
--stripopt=<a string>
usos múltiples -
Opciones adicionales para pasar a la eliminación cuando se genera un objeto binario "<name>.stripped".
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--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 la descripción-
Es el prefijo que se antepone a cualquiera de los symlinks de conveniencia que se crean después de una compilación. Si se omite, el valor predeterminado es el nombre de la herramienta de compilación seguido de un guion. Si se pasa "/", no se crean symlinks ni se emite ninguna advertencia. Advertencia: La funcionalidad especial para “/” pronto dejará de estar disponible; en su lugar, usa --experimental_convenience_symlinks=ignore.
Etiquetas:affects_outputs
- Se acumulan
--tvos_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se deben 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 la descripción-
Versión de tvOS mínima compatible para 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 las que se pueden 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 la descripción-
Versión mínima compatible de watchOS para los simuladores y dispositivos de destino Si no se especifica, se usa “watchos_sdk_version”.
Etiquetas:loses_incremental_state
--xbinary_fdo=<a build target label>
predeterminado: ver la descripción-
Usa la información de perfil XbinaryFDO para optimizar la compilación. Especifica el nombre del perfil binario cruzado predeterminado. Cuando se use la opción junto con --fdo_instrument/--fdo_optimize/--fdo_profile, estas siempre prevalecerán como si xbinary_fdo nunca se especifique.
Etiquetas:affects_outputs
- Opciones que afectan cómo se aplica estrictamente Bazel a las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etc.):
- Configuración predeterminada de
--auto_cpu_environment_group=<a build target label>
: "" - Declara el entorno de grupo para usarlo en la asignación automática de valores de CPU a los valores de target_environment.
Etiquetas:changes_inputs
,loading_and_analysis
,experimental
- Valor predeterminado
--[no]check_licenses
: “falso” -
Verifica que las restricciones de licencias impuestas por los paquetes dependientes no entren en conflicto con los modos de distribución de los destinos que se compilan. De forma predeterminada, no se verifican las licencias.
Etiquetas:build_file_semantics
- Valor predeterminado de
--[no]check_visibility
: “verdadero” -
Si está inhabilitada, los errores de visibilidad en las dependencias de destino descienden a advertencias.
Etiquetas:build_file_semantics
- Valor predeterminado de
--[no]desugar_for_android
: “verdadero” -
Determina si es necesario desugar Java 8 de código de bytes antes de la conversión a DEX.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Valor predeterminado
--[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
- Valor predeterminado de
--[no]enforce_constraints
: “verdadero” -
Verifica los entornos con los que es compatible 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
--[no]experimental_allow_android_library_deps_without_srcs
: “falso” -
Marca para facilitar la transición de permitir la inhabilitación de reglas de android_library de srcs-less con dependencias. El depósito se debe limpiar para lanzarlo de forma predeterminada.
Etiquetas:eagerness_to_exit
,loading_and_analysis
- Valor predeterminado de
--[no]experimental_check_desugar_deps
: “verdadero” -
Indica si debes verificar correctamente la expansión de sintaxis correcta a nivel del objeto binario de Android.
Etiquetas:eagerness_to_exit
,loading_and_analysis
,experimental
- Configuración predeterminada de
--experimental_import_deps_checking=<off, warning or error>
: "DESACTIVADA" -
Cuando esté habilitado, verifique si se completaron las dependencias de aar_import. Esta aplicación puede dañar la compilación o solo generar advertencias.
Etiquetas:loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
predeterminado: “default”-
Si es verdadero, comprueba que un destino Java declare de manera explícita todos los destinos utilizados directamente como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
- Valor predeterminado
--[no]incompatible_check_testonly_for_output_files
: “falso” -
Si la opción está habilitada, busque solo la prueba de la regla de generación para los objetivos de los requisitos previos que son archivos de salida. Esto coincide con la verificación de visibilidad.
Etiquetas:build_file_semantics
,incompatible_change
- Valor predeterminado
--[no]incompatible_check_visibility_for_toolchains
: “falso” -
Si se habilita, la verificación de visibilidad también se aplica a las implementaciones de la cadena de herramientas.
Etiquetas:build_file_semantics
,incompatible_change
- Valor predeterminado
--[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 desde https://github.com/bazelbuild/rules_android
Etiquetas:eagerness_to_exit
,incompatible_change
- Valor predeterminado
--[no]incompatible_disable_native_apple_binary_rule
: “falso” -
No-op. Se mantiene aquí para ofrecer retrocompatibilidad.
Etiquetas:eagerness_to_exit
,incompatible_change
- Valor predeterminado de
--[no]incompatible_force_strict_header_check_from_starlark
: “verdadero” -
Si está habilitada, establezca una verificación de encabezado estricta en la API de Starlark
Etiquetas:loading_and_analysis
,changes_inputs
,incompatible_change
- Valor predeterminado de
--[no]incompatible_python_disable_py2
: “verdadero” -
Si es verdadero, usar la configuración de Python 2 generará un error. Esto incluye python_version=PY2, srcs_version=PY2 y srcs_version=PY2ONLY. Consulta https://github.com/bazelbuild/bazel/issues/15684 para obtener más información.
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]incompatible_validate_top_level_header_inclusions
: “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
--python_native_rules_allowlist=<a build target label>
predeterminado: ver la descripción-
Una lista de entidades permitidas (destino de package_group) que se usará al aplicar --incompatible_python_allowed_native_rules.
Etiquetas:loading_and_analysis
- Valor predeterminado
--[no]strict_filesets
: “falso” -
Si esta opción está habilitada, los conjuntos de archivos que cruzan los límites del paquete se informan como errores. No funciona cuando se inhabilita check_fileset_Dependencies_recursively.
Etiquetas:build_file_semantics
,eagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default>
predeterminado: “error”-
A menos que esté DESACTIVADA, verifica que un destino de proto_library declare de manera explícita todos los destinos usados directamente como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
- Configuración predeterminada de
--strict_public_imports=<off, warn, error, strict or default>
: "desactivado" -
A menos que esté DESACTIVADA, verifica que un destino de proto_library declare de manera explícita todos los destinos usados en "import public" como exportado.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
- Valor predeterminado
--[no]strict_system_includes
: “falso” -
Si es verdadero, también se deben declarar los encabezados que se encuentran a través del sistema que incluyen rutas (-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:
- Predeterminado de
--apk_signing_method=<v1, v2, v1_v2 or v4>
: “v1_v2”. -
Implementación para usar la firma de APK
Etiquetas:action_command_lines
,affects_outputs
,loading_and_analysis
- Valor predeterminado de
--[no]device_debug_entitlements
: “verdadero” -
Si se configura y el modo de compilación no es "opt", las apps de objc incluirán derechos de depuración al momento de firmar.
Etiquetas:changes_inputs
--ios_signing_cert_name=<a string>
predeterminado: ver la descripción-
Es el nombre del certificado que se usará para la firma de iOS. Si no la estableces, se recurrirá al perfil de aprovisionamiento. Puede ser la preferencia de identidad del llavero del certificado o (substring) del nombre común del certificado, según la página de manual del código (Firma IDENTITIES).
Etiquetas:action_command_lines
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación accesible para los archivos BUILD, los archivos .bzl o los archivos WORKSPACE:
- Valor predeterminado
--[no]incompatible_config_setting_private_default_visibility
: “falso” -
Si incompatible_enforce_config_setting_visibility=false es, esto es noop. De lo contrario, si la marca es falsa, cualquier config_setting sin un atributo explícito de visibilidad será //visibility:public. Si esta marca es verdadera, config_setting sigue la misma lógica de visibilidad que todas las demás reglas. Consulta https://github.com/bazelbuild/bazel/issues/12933.
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]incompatible_disallow_legacy_py_provider
: “verdadero” -
No-op, pronto se quitará.
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado
--[no]incompatible_disallow_sdk_frameworks_attributes
: “falso” -
Si es verdadero, inhabilite los atributos sdk_frameworks y weak_sdk_frameworks en objc_library yobjc_import.
Etiquetas:build_file_semantics
,incompatible_change
- Valor predeterminado de
--[no]incompatible_enforce_config_setting_visibility
: “verdadero” -
Si es verdadero, aplique restricciones de visibilidad de config_setting. Si es falso, cada destino es visible para cada config_setting. Consulta https://github.com/bazelbuild/bazel/issues/12932.
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado
--[no]incompatible_objc_alwayslink_by_default
: “falso” -
Si es verdadero, establezca el valor predeterminado para los atributos Alwayslink en objc_library y objc_import.
Etiquetas:build_file_semantics
,incompatible_change
- Valor predeterminado
--[no]incompatible_python_disallow_native_rules
: “falso” -
Cuando es verdadero, se produce un error cuando se usan las reglas py_* integradas. En su lugar, se deben usar las reglas rule_python. Consulta https://github.com/bazelbuild/bazel/issues/17773 para obtener más información e instrucciones de migración.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones que rigen el comportamiento del entorno o del ejecutor de pruebas:
- Valor predeterminado
--[no]allow_analysis_failures
: “falso” -
Si es verdadero, un error de análisis del destino de una regla da como resultado la propagación del destino de una instancia de AnalysisFailureInfo que contiene la descripción del error, en lugar de una falla de compilación.
Etiquetas:loading_and_analysis
,experimental
- Configuración predeterminada 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 for_analysis_testing. Si se supera ese límite, se producirá un error en la regla.
Etiquetas:loading_and_analysis
- Valor predeterminado
--[no]break_build_on_parallel_dex2oat_failure
: “falso” -
Si la verdadera falla de dex2oat hace que la compilación falle, en lugar de ejecutar dex2oat durante el tiempo de ejecución de prueba.
Etiquetas:loading_and_analysis
,experimental
- Valor predeterminado
--[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 completarán de forma correcta. Si se debe 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
--[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 reintentará hasta la cantidad especificada de veces en caso de que falle. Las pruebas que requirieron más de un intento se marcan como “FLAKY” en el resumen de la prueba. Por lo general, 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 el valor es "predeterminado", solo se realizará un único intento de prueba para pruebas regulares y tres para las que la regla haya marcado explícitamente como inestable (atributo "flaky=1"). Sintaxis alternativa: regex_filter@flaky_test_intents. Donde flaky_test_intents es el anterior y regex_filter significa una lista de patrones de expresión de inclusión y exclusión (consultar también --runs_per_test). Ejemplo: --flaky_test_intents=//foo/.*,-//foo/bar/.*@3 desaprueba todas las pruebas en //foo/, excepto las de foo/bar tres veces. Esta opción se puede pasar varias veces. Tiene prioridad el argumento que se pasó más recientemente y que coincide. Si no hay una coincidencia, el comportamiento es como si se hubiera establecido en la opción "predeterminada" mencionada anteriormente.
Etiquetas:execution
- Valor predeterminado
--[no]ios_memleaks
: “falso” -
Habilita la verificación de fugas de memoria en destinos ios_test.
Etiquetas:action_command_lines
--ios_simulator_device=<a string>
predeterminado: ver la descripción-
Es el dispositivo que se 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 la descripción-
Es la versión de iOS que se ejecuta en el simulador cuando se ejecuta o realiza una prueba. 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”-
Es la cantidad máxima de trabajos de prueba locales que se deben ejecutar de forma simultánea. 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". 0 significa que los recursos locales limitarán la cantidad de trabajos de prueba locales que se deben ejecutar de forma simultánea. Establecer este 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 ejecuta cada prueba. Si alguno de esos intentos falla por cualquier motivo, se considerará que falló toda la prueba. Normalmente, el valor especificado es solo un número entero. Ejemplo: --runs_per_test=3 ejecutará todas las pruebas 3 veces. Sintaxis alternativa: regex_filter@runs_per_test. Donde, run_per_test significa un valor de número entero y regex_filter significa una lista de patrones de expresión de inclusión y exclusión (también consulta --instrumentation_filter). Ejemplo: --runs_per_test=//foo/.*,-//foo/bar/.*@3 ejecuta todas las pruebas en //foo/, excepto las de foo/bar tres veces. Esta opción se puede pasar varias veces. Tiene prioridad el argumento que se pasó más recientemente y que coincide. De lo contrario, la prueba solo se ejecutará una vez.
- Se acumulan
--test_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica variables de entorno adicionales que se insertarán en el entorno del ejecutor de pruebas. Las variables se pueden especificar por nombre, en cuyo caso se leerá su valor del entorno del cliente de Bazel, o bien por el par nombre=valor. Esta opción se puede usar varias veces para especificar varias variables. Solo se usa con el comando “bazel test”.
Etiquetas:test_runner
- Valor predeterminado de
--[no]test_keep_going
: “verdadero” -
Cuando 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
- Configuración predeterminada de
--test_strategy=<a string>
: "" -
Especifica la estrategia que se usará para ejecutar pruebas.
Etiquetas:execution
- Valor predeterminado de
--test_timeout=<a single integer or comma-separated list of 4 integers>
: "-1" - Anula los valores predeterminados de tiempo de espera de la prueba para los tiempos de espera de la prueba (en segundos). Si se especifica un solo valor entero positivo, se anularán todas las categorías. Si se especifican 4 números enteros separados por comas, se anularán los tiempos de espera para el corto, el moderado, el largo y el eterno (en ese orden). En cualquier forma, el valor -1 le indica al blaze que use los tiempos de espera predeterminados para esa categoría.
--test_tmpdir=<a path>
predeterminado: ver la descripción- Especifica el directorio temporal base que debe usar “prueba de Bazel”.
--tvos_simulator_device=<a string>
predeterminado: ver la descripción-
Es el dispositivo que se simulará cuando se ejecuta 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 la descripción-
Es la versión de tvOS que se ejecutará en el simulador cuando se ejecute o realice pruebas.
Etiquetas:test_runner
--watchos_simulator_device=<a string>
predeterminado: ver la descripción-
Es el dispositivo que se 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 la descripción-
Es la versión de watchOS que se ejecutará en el simulador cuando se ejecute o realice pruebas.
Etiquetas:test_runner
- Valor predeterminado de
--[no]zip_undeclared_test_outputs
: “verdadero” -
Si es verdadero, los resultados de la prueba no declarados se archivarán en un archivo ZIP.
Etiquetas:test_runner
- Opciones que activan optimizaciones del tiempo de compilación:
- Valor predeterminado de
--[no]collapse_duplicate_defines
: “verdadero” -
Cuando esté habilitada, se quitará --defines redundante 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
--[no]experimental_filter_library_jar_with_program_jar
: “falso” -
Filtra el ProgramJar de ProGuard para quitar las clases que también están en LibraryJar.
Etiquetas:action_command_lines
- Valor predeterminado de
--[no]experimental_inmemory_dotd_files
: “verdadero” -
Si se habilita, los archivos .d de C++ se pasarán por 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_inmemory_jdeps_files
: “verdadero” -
Si se habilita, los archivos de dependencia (.jdeps) generados a partir de compilaciones de Java se pasarán en la memoria directamente desde los nodos de compilación remota, en lugar de escribirse en el disco.
Etiquetas:loading_and_analysis
,execution
,affects_outputs
,experimental
- Valor predeterminado
--[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
--[no]experimental_retain_test_configuration_across_testonly
: “falso” -
Cuando se habilita, --trim_test_configuration no recortará la configuración de prueba para las reglas marcadas como testonly=1. Esto sirve para reducir los problemas de conflicto de acciones cuando las reglas que no son de prueba dependen de las reglas de cc_test. Sin efecto si --trim_test_configuration es falso.
Etiquetas:loading_and_analysis
,loses_incremental_state
- Valor predeterminado
--[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
--[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 Lines de los archivos de entrada. Esto puede mejorar el rendimiento y la incrementalidad mediante la disminución del tamaño de los árboles de entrada de compilación. Sin embargo, también puede interrumpir compilaciones porque el escáner de inclusión no implementa semántica de C. En particular, no comprende las directivas dinámicas #include e ignora la lógica condicional del preprocesador. Úsala bajo tu propia responsabilidad. Se cerrarán todos los problemas relacionados con esta marca.
Etiquetas:loading_and_analysis
,execution
,changes_inputs
- Valor predeterminado de
--[no]incremental_dexing
: “verdadero” -
La mayor parte del trabajo de dex se realiza para cada archivo .jar.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Valor predeterminado de
--[no]objc_use_dotd_pruning
: “verdadero” -
Si se configura, se usarán los archivos .d emitidos por clang para reducir el conjunto de entradas que se pasan a compilaciones objc.
Etiquetas:changes_inputs
,loading_and_analysis
- Valor predeterminado
--[no]process_headers_in_dependencies
: “falso” -
Cuando compiles un destino //a:a, procesa los encabezados en todos los destinos de los que depende //a:a (si el procesamiento del encabezado está habilitado para la cadena de herramientas).
Etiquetas:execution
- Valor predeterminado de
--[no]trim_test_configuration
: “verdadero” -
Cuando esté habilitada, las opciones relacionadas con la prueba se borrarán por debajo del nivel superior de la compilación. Cuando esta marca está activa, las pruebas no se pueden crear 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
- Valor predeterminado de
--[no]use_singlejar_apkbuilder
: “verdadero” -
Esta opción dejó de estar disponible. 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
--[no]announce
: “falso” -
Obsoleto. No-op.
Etiquetas:affects_outputs
- Valor predeterminado
--[no]experimental_bep_target_summary
: “falso” - Indica si se deben publicar eventos TargetSummary.
- Valor predeterminado
--[no]experimental_build_event_expand_filesets
: “falso” -
Si es verdadero, expande los conjuntos de archivos en el BEP cuando se presentan los archivos de salida.
Etiquetas:affects_outputs
- Valor predeterminado
--[no]experimental_build_event_fully_resolve_fileset_symlinks
: “falso” -
Si es verdadero, resuelve por completo los symlinks relativos del conjunto de archivos en la BEP cuando se presentan los archivos de salida. Requiere --experimental_build_event_expand_filesets.
Etiquetas:affects_outputs
- Configuración predeterminada de
--experimental_build_event_upload_max_retries=<an integer>
: "4" -
Es la cantidad máxima de veces que Bazel debe intentar subir un evento de compilación.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
: "1 s" -
Es el retraso mínimo para los reintentos de retirada exponencial cuando falla la carga del BEP. (exponente: 1.6)
Etiquetas:bazel_internal_configuration
--experimental_build_event_upload_strategy=<a string>
predeterminado: ver la 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
--[no]experimental_materialize_param_files_directly
: “falso” -
Si materializas archivos de parámetros, hazlo con escrituras directas en el disco.
Etiquetas:execution
- Valor predeterminado
--[no]experimental_stream_log_file_uploads
: “falso” -
Transmite los archivos de registro directamente al almacenamiento remoto en lugar de escribirlos en el disco.
Etiquetas:affects_outputs
--explain=<a path>
predeterminado: ver la descripción-
Hace que el sistema de compilación explique cada paso ejecutado de la compilación. La explicación se escribe en el archivo de registro especificado.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]legacy_important_outputs
: “verdadero” -
Úsalo para suprimir la generación del campo legacy_outputs heredado en el evento TargetComplete. Se requieren importantes_resultados para la integración de Bazel con ResultStore.
Etiquetas:affects_outputs
- Valor predeterminado
--[no]materialize_param_files
: “falso” -
Escribe archivos de parámetros intermedios en el árbol de resultados incluso cuando se usa la ejecución de acciones remotas. Es útil para depurar acciones. Esto está implícito por --subcommands y --verbose_failures.
Etiquetas:execution
- Configuración predeterminada 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 modificados. Si el número proporcionado es -1, se mostrarán todas las opciones modificadas.
Etiquetas:terminal_output
- Valor predeterminado de
--max_test_output_bytes=<an integer>
: "-1" -
Especifica el tamaño máximo de registro por prueba que se puede emitir cuando --test_output es "errores" o "todos". Es útil para evitar abrumar los resultados con resultados de pruebas demasiado ruidosos. El encabezado de la prueba se incluye en el tamaño del registro. Los valores negativos no implican ningún límite. El resultado es todo o nada.
Etiquetas:test_runner
,terminal_output
,execution
--output_filter=<a valid Java regular expression>
predeterminado: ver la descripción-
Solo muestra advertencias para las reglas con un nombre que coincide con la expresión regular proporcionada.
Etiquetas:affects_outputs
--progress_report_interval=<an integer in 0-3600 range>
predeterminado: “0”-
Es la cantidad de segundos entre los informes sobre los trabajos que aún se están ejecutando. El valor predeterminado 0 significa que el primer informe se imprimirá después de 10 segundos, luego de 30 segundos y, luego, ese progreso se informa una vez por minuto. Cuando --curses está habilitado, se informa el progreso cada segundo.
Etiquetas:affects_outputs
- Configuración predeterminada de
--show_result=<an integer>
: “1” -
Muestra los resultados de la compilación. Para cada destino, indica si se actualizó o no y, si es así, una lista de los archivos de salida que se compilaron. Los archivos impresos son strings convenientes para copiar y pegar en el shell, a fin de ejecutarlos.
Esta opción requiere un argumento de número entero, que es la cantidad límite de destinos sobre los que no se imprime la información del resultado. Por lo tanto, cero causa la supresión del mensaje y MAX_INT hace que la impresión del resultado se produzca siempre. El valor predeterminado es uno.
Si no se creó nada para un destino, se pueden omitir los resultados a fin de mantener el resultado por debajo del umbral.
Etiquetas:affects_outputs
--[no]subcommands
[-s
] predeterminado: “false”-
Muestra los subcomandos que se ejecutaron durante una compilación. Marcas relacionadas: --execution_log_json_file, --execution_log_binary_file (para registrar subcomandos en un archivo en un formato compatible con la herramienta).
Etiquetas:terminal_output
--test_output=<summary, errors, all or streamed>
predeterminado: “resumen”-
Especifica el modo de salida deseado. Los valores válidos son “summary” para mostrar solo el resumen de estado de prueba, “errors” para imprimir también registros de prueba de pruebas fallidas, “all” para imprimir registros de todas las pruebas y “streamed” para generar registros de todas las pruebas en tiempo real (esto forzará que las pruebas se ejecuten a la vez de forma local, independientemente del valor de --test_Strategy).
Etiquetas:test_runner
,terminal_output
,execution
- Predeterminado de
--test_summary=<short, terse, detailed, none or testcase>
: “short” -
Especifica el formato deseado del resumen de la prueba. Los valores válidos son "short" para imprimir información solo sobre las pruebas ejecutadas, "terse" para imprimir información solo sobre las pruebas fallidas que se ejecutaron, "detailed" para imprimir información detallada de casos de prueba con errores, "testcase" para imprimir el resumen en la resolución del caso de prueba, no se imprime información detallada sobre los casos de prueba con errores y "none" para omitir el resumen.
Etiquetas:terminal_output
- Configuración predeterminada 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 tipos de cadenas de herramientas y destinos específicos para ver cuál depurar. Si hay varias regex, estas se pueden separar con comas y, luego, cada una se verifica por separado. Nota: El resultado de esta marca es muy complejo y probablemente solo sea útil para los expertos en la resolución de cadenas de herramientas.
Etiquetas:terminal_output
- Valor predeterminado
--[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
--[no]verbose_failures
: “falso” -
Si un comando falla, imprime la línea de comandos completa.
Etiquetas:terminal_output
- Opciones que especifican o alteran una entrada genérica en un comando de Bazel que no entra 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 requerido por un aspecto de la lista. Esta opción se puede usar 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 una bandera de Starlark. Toma un solo par clave-valor con el formato "<key>=<value>" como argumento.
Etiquetas:changes_inputs
- Valor predeterminado
--[no]incompatible_default_to_explicit_init_py
: “falso” -
Este marcador cambia el comportamiento predeterminado para que los archivos __init__.py ya no se creen automáticamente en los runfiles de los destinos de Python. Precisamente, cuando un objetivo py_binary o py_test tiene heredado_create_init configurado como “auto” (el valor predeterminado), se trata como falso solo si se establece esta marca. Consulta https://github.com/bazelbuild/bazel/issues/10076.
Etiquetas:affects_outputs
,incompatible_change
- Valor predeterminado de
--[no]incompatible_py2_outputs_are_suffixed
: “verdadero” -
Si es verdadero, los destinos compilados en la configuración de Python 2 aparecerán en una raíz de salida que incluye el sufijo “-py2”, mientras que los objetivos compilados para Python 3 aparecerán en una raíz sin sufijo relacionado con Python. Esto significa que el symlink de conveniencia de "bazel-bin" apuntará a los objetivos de Python 3 en lugar de a Python 2. Si habilitas esta opción, también se recomienda habilitar `--incompatible_py3_is_default`.
Etiquetas:affects_outputs
,incompatible_change
- Valor predeterminado de
--[no]incompatible_py3_is_default
: “verdadero” -
Si el valor es verdadero, los objetivos "py_binary" y "py_test" que no establezcan el atributo "python_version" (o "default_python_version") se establecerán de forma predeterminada en PY3 en lugar de PY2. Si configuras esta marca, también se recomienda configurar “--incompatible_py2_outputs_are_subtitleed”.
Etiquetas:loading_and_analysis
,affects_outputs
,incompatible_change
- Valor predeterminado de
--[no]incompatible_use_python_toolchains
: “verdadero” -
Si se establece como verdadera, las reglas nativas ejecutables de Python usarán el entorno de ejecución de Python que especifica la cadena de herramientas de Python, en lugar del entorno de ejecución que proporcionan las marcas heredadas, como --python_top.
Etiquetas:loading_and_analysis
,incompatible_change
--python_version=<PY2 or PY3>
predeterminado: ver la descripción-
Es el modo de versión principal de Python, ya sea "PY2" o "PY3". Ten en cuenta que los destinos "py_binary" y "py_test" anulan (incluso si no especifican una versión de forma explícita), por lo que, por lo general, no hay muchos motivos para proporcionar esta marca.
Etiquetas:loading_and_analysis
,affects_outputs
,explicit_in_output_path
- Configuración predeterminada de
--target_pattern_file=<a string>
: "" -
Si se establece, la compilación leerá patrones del archivo que se nombra aquí, en lugar de la línea de comandos. Es un error especificar aquí un archivo y los patrones de la línea de comandos.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remoto:
--experimental_remote_cache_eviction_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar si la compilación encontró un error de expulsión de la caché remota. Un valor distinto de cero establecerá implícitamente --incompatible_remote_use_new_exit_code_for_lost_inputs como verdadero.
Etiquetas:execution
- Valor predeterminado de
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
: “verdadero” -
Si se establece como verdadera, Bazel usará el nuevo código de salida 39 en lugar de 34 si la caché remota desaloja BLOB durante la compilación.
Etiquetas:incompatible_change
- Opciones misceláneas, pero que no estén en ninguna otra categoría:
- Valor predeterminado
--[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 los obliga a compilar (pero no ejecutarlos).
- Configuración predeterminada de
--build_tag_filters=<comma-separated list of options>
: "" - 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 etiquetas excluidas. Esta opción no afecta el conjunto de pruebas ejecutadas con el comando “test” (estas están regidas por las opciones de filtrado de pruebas, por ejemplo “--test_tag_filters”).
- Valor predeterminado
--[no]build_tests_only
: “falso” - Si se especifica, solo se compilarán las reglas *_test y test_suite, y se ignorarán los demás destinos especificados en la línea de comandos. De forma predeterminada, se compilarán todos los datos solicitados.
--[no]cache_test_results
[-t
] predeterminado: “auto”- Si se establece 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 de pruebas con --runs_per_test o(4) la prueba falló. Si se configura en "sí", Bazel almacena en caché todos los resultados de la prueba, excepto las pruebas marcadas como externas. Si se configura en "no", Bazel no almacena en caché ningún resultado de prueba.
- Valor predeterminado
--[no]compile_one_dependency
: “falso” - Compila una sola dependencia de los archivos de argumentos. Esto resulta útil para verificar archivos de origen en IDE, por ejemplo, mediante la compilación de un solo destino que depende del archivo de origen para detectar errores lo antes posible en el ciclo de edición, compilación y prueba. Este argumento afecta la forma en que se interpretan todos los argumentos que no son de marca. 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 depende 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” existente. Por ejemplo, después de borrar x/y/BUILD en tu cliente, el sistema de compilación puede reclamar si encuentra una etiqueta "//x:y/z" si aún lo proporciona otra entrada package_path. Si se especifica --DELETED_packages x/y, se evita este problema.
- Valor predeterminado
--[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 adicionales.
--execution_log_binary_file=<a path>
predeterminado: ver la descripción- Registra las generaciones ejecutadas en este archivo como 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 manera estable (puede requerir una gran cantidad de CPU y memoria). Marcas relacionadas: --execution_log_json_file (formato JSON de texto ordenado), --experimental_execution_log_file (formato binario protobuf), --subcomandos (para mostrar subcomandos en el resultado de la terminal).
--execution_log_json_file=<a path>
predeterminado: ver la descripción- Registra las generaciones ejecutadas en este archivo como representación JSON de los protos 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 manera estable (puede requerir una gran cantidad 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 la salida de la terminal).
- Valor predeterminado de
--[no]execution_log_sort
: “verdadero” - Indica si se debe ordenar el registro de ejecución. Se configura como falso para mejorar el rendimiento de la memoria, a costa de producir el registro en orden no determinista.
- Valor predeterminado de
--[no]expand_test_suites
: “verdadero” -
Expande los objetivos test_suite en sus pruebas constituyentes antes del análisis. Cuando esta marca está activada (predeterminada), se aplican los patrones de destino negativos a las pruebas que pertenecen al conjunto de pruebas. De lo contrario, no se aplicarán. Desactivar esta marca es útil cuando se aplican aspectos de nivel superior en la línea de comandos, ya que pueden analizar los objetivos de test_suite.
Etiquetas:loading_and_analysis
- Valor predeterminado
--[no]experimental_cancel_concurrent_tests
: “falso” -
Si es verdadero, Blaze cancelará las pruebas que se estén ejecutando en simultáneo en la primera ejecución correcta. Esto solo es útil si se combina con --runs_per_test_detects_flakes.
Etiquetas:affects_outputs
,loading_and_analysis
--experimental_execution_log_file=<a path>
predeterminado: ver la descripción- Registra las generaciones ejecutadas en este archivo como protos de Spawn delimitados, según src/main/protobuf/spawn.proto. Este archivo está escrito en el orden de ejecución de los spagens. Marcas relacionadas: --execution_log_binary_file (formato binario protobuf), --execution_log_json_file (formato JSON de texto ordenado) y subcomandos (para mostrar subcomandos en el resultado de la terminal).
- Valor predeterminado
--[no]experimental_execution_log_spawn_metrics
: “falso” - Incluye las métricas de generación en el registro de generación ejecutado.
- Configuración predeterminada de
--experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "" - Dejó de estar disponible y se reemplazó por otro. Filtra un conjunto de objetivos para el que se programan acciones_adicionales.
- Valor predeterminado
--[no]experimental_extra_action_top_level_only
: “falso” - Dejó de estar disponible y se reemplazó por otro. Solo programa acciones extra_actions para objetivos de nivel superior.
- Valor predeterminado
--[no]experimental_fetch_all_coverage_outputs
: “falso” -
Si es verdadero, Bazel recupera el directorio de datos de cobertura completo para cada prueba durante la ejecución de una cobertura.
Etiquetas:affects_outputs
,loading_and_analysis
- Valor predeterminado
--[no]experimental_generate_llvm_lcov
: “falso” -
Si es verdadero, la cobertura de Clang generará un informe de LCOV.
Etiquetas:affects_outputs
,loading_and_analysis
- Valor predeterminado de
--[no]experimental_j2objc_header_map
: “verdadero” - Indica si se debe generar un mapa de encabezado J2ObjC en paralelo a la transpilación J2ObjC.
- Valor predeterminado
--[no]experimental_j2objc_shorter_header_path
: “falso” -
Indica si se desea generar con una ruta de encabezado más corta (usa "_ios" en lugar de "_j2objc").
Etiquetas:affects_outputs
- Configuración predeterminada de
--experimental_java_classpath=<off, javabuilder or bazel>
: “javabuilder” - Habilita rutas de clase reducidas para las compilaciones de Java.
- Valor predeterminado
--[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_prioritize_local_actions
: “verdadero” -
Si se configuran, las acciones que solo se pueden ejecutar de forma local tienen la primera oportunidad de adquirir recursos, los trabajadores que se ejecutan de forma dinámica tienen una segunda oportunidad y las acciones independientes ejecutadas de forma dinámica van al final.
Etiquetas:execution
- Valor predeterminado
--[no]experimental_run_android_lint_on_java_rules
: “falso” -
Indica si se deben validar las fuentes java_*.
Etiquetas:affects_outputs
- Valor predeterminado
--[no]explicit_java_test_deps
: “falso” - Especifica explícitamente una dependencia a JUnit o Hamcrest en una java_test en lugar de obtener accidentalmente de las dependencias de TestRunner. Por el momento, solo funciona para bazel.
--host_java_launcher=<a build target label>
predeterminado: ver la 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 la VM de cada destino java_binary.
- Valor predeterminado de
--[no]incompatible_check_sharding_support
: “verdadero” -
Si el valor es verdadero, Bazel fallará una prueba fragmentada si el ejecutor de pruebas no indica que admite la fragmentación cuando se toca el archivo en la ruta de acceso TEST_SHARD_STATUS_FILE. Si es falso, un ejecutor de pruebas que no admita la fragmentación generará todas las pruebas que se ejecuten en cada fragmento.
Etiquetas:incompatible_change
- Valor predeterminado de
--[no]incompatible_exclusive_test_sandboxed
: “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
--[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 esto puede evitar el almacenamiento en caché de varios 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 iniciar la prueba. Implica -test_output=streamed.
Se expande a:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
- Valor predeterminado de
--[no]java_deps
: “verdadero” - Genera información de dependencia (por ahora, la ruta de clase de tiempo de compilación) por destino de Java.
- Valor predeterminado de
--[no]java_header_compilation
: “verdadero” - Compila ijar directamente desde la fuente.
- Configuración predeterminada de
--java_language_version=<a string>
: "" - Versión de lenguaje Java
--java_launcher=<a build target label>
predeterminado: ver la descripción- El selector de Java que se usará cuando se compilen objetos binarios de Java. Si esta marca se establece en la string vacía, se usa el selector de JDK. El atributo "launcher" anula esta marca.
- Configuración predeterminada 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 la VM de cada destino java_binary.
--legacy_main_dex_list_generator=<a build target label>
predeterminado: ver la descripción- Especifica un objeto binario para generar la lista de clases que deben estar en el DEX principal cuando se compila multidex heredado.
- Configuración predeterminada de
--local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>
: "HOST_CPUS" - Establece explícitamente la cantidad total de núcleos de CPU locales disponibles en Bazel para que se inviertan en acciones de compilación ejecutadas de forma local. Toma un número entero, o “HOST_CPUS”, opcionalmente seguido de [-|*]<float> (p. ej., HOST_CPUS*.5 para usar la mitad de los núcleos de CPU disponibles. De forma predeterminada, ("HOST_CPUS"), Bazel consultará la configuración del sistema para calcular la cantidad de núcleos de CPU disponibles.
- Se acumulan
--local_extra_resources=<a named float, 'name=value'>
usos múltiples - Establece la cantidad de recursos adicionales disponibles en Bazel. Toma un par de número de punto flotante de string. Se puede usar varias veces para especificar varios tipos de recursos adicionales. Bazel limitará las acciones que se ejecutan en simultáneo en función de los recursos adicionales disponibles y los necesarios. Las pruebas pueden declarar la cantidad de recursos adicionales que necesitan mediante una etiqueta del formato “resources:<resoucename>:<amount>”. La CPU, la RAM y los recursos disponibles no se pueden configurar con esta marca.
- Configuración predeterminada de
--local_ram_resources=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
: "HOST_RAM*.67" - Establece explícitamente la cantidad total de RAM del host local (en MB) disponible para Bazel y destinarla a acciones de compilación ejecutadas de forma local. Toma un número entero, o “HOST_RAM”, 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 usará el 67% de este.
- Configuración predeterminada 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.
--optimizing_dexer=<a build target label>
predeterminado: ver la descripción- Especifica un objeto binario para usar en la conversión a dex sin fragmentación.
- Configuración predeterminada de
--package_path=<colon-separated list of options>
: "%workspace%" - Una lista separada por dos puntos en la que se buscan los paquetes. Los elementos que comienzan con "%workspace%" se relacionan con el lugar de trabajo que lo rodea. Si se omite o se deja 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 la descripción- Especifica qué versión de ProGuard usar para la eliminación de código cuando se compila un objeto binario de Java.
- Configuración predeterminada de
--proto_compiler=<a build target label>
: "@bazel_tools//tools/proto:protoc" - Es la etiqueta del proto compilador.
Etiquetas:affects_outputs
,loading_and_analysis
- Configuración predeterminada de
--proto_toolchain_for_cc=<a build target label>
: "@bazel_tools//tools/proto:cc_toolchain" -
Etiqueta de proto_lang_toolchain() que describe cómo compilar protocolos de C++
Etiquetas:affects_outputs
,loading_and_analysis
- Configuración predeterminada de
--proto_toolchain_for_j2objc=<a build target label>
: "@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
- Configuración predeterminada de
--proto_toolchain_for_java=<a build target label>
: "@bazel_tools//tools/proto:java_toolchain" -
Etiqueta de proto_lang_toolchain() que describe cómo compilar protocolos de Java
Etiquetas:affects_outputs
,loading_and_analysis
- Configuración predeterminada de
--proto_toolchain_for_javalite=<a build target label>
: "@bazel_tools//tools/proto:javalite_toolchain" -
Etiqueta de proto_lang_toolchain() que describe cómo compilar 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
--[no]runs_per_test_detects_flakes
: “falso” - Si es verdadero, cualquier fragmento en el que al menos una ejecución o un intento falle y un intento de ejecución o intento falle, obtendrá un estado FLAKY.
--shell_executable=<a path>
predeterminado: ver la descripción-
Ruta de acceso absoluta al ejecutable de shell que usa 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 usará. Si no se establece ninguno, Bazel usa una ruta de acceso predeterminada hard-coded según el sistema operativo en el que se ejecute (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, all other: /bin/bash). Ten en cuenta que usar una shell que no es compatible con Bash puede provocar fallas de compilación o de tiempo de ejecución de los objetos binarios generados.
Etiquetas:loading_and_analysis
- Valor predeterminado de
--[no]show_loading_progress
: “verdadero” - Si se habilita, Bazel imprime mensajes del tipo "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 la prueba. Se puede usar varias veces para especificar varios argumentos. Si se ejecutan varias pruebas, cada una recibirá argumentos idénticos. Solo se usa con el comando “bazel test”.
--test_filter=<a string>
predeterminado: ver la 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 los destinos que se crean.
- Configuración predeterminada de
--test_lang_filters=<comma-separated list of options>
: "" - 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 esos destinos de prueba escritos en los idiomas especificados. El nombre que se usa para cada idioma debe ser el mismo que el prefijo de la regla *_test, p.ej., “cc”, “java”, “py”, etc. Esta opción afecta el comportamiento --build_tests_only y el comando de prueba.
- Valor predeterminado de
--test_result_expiration=<an integer>
: "-1" - Esta opción dejó de estar disponible y no tiene efecto.
- Valor predeterminado
--[no]test_runner_fail_fast
: “falso” - La opción de reenvío rápido falla al ejecutor de pruebas. El ejecutor de pruebas debe detener la ejecución en la primera falla.
- Configuración predeterminada de
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>
: "explícita" - Especificar la estrategia para la fragmentación de pruebas: “explícita” para usar la fragmentación solo si está presente el atributo “shard_count” “inhabilitado” para no usar nunca la fragmentación de pruebas. “forced=k” aplica de manera forzosa “k” fragmentos para pruebas, sin importar el atributo “shard_count” de BUILD.
- Configuración predeterminada de
--test_size_filters=<comma-separated list of values: small, medium, large or enormous>
: "" - 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 tamaños excluidos. Esta opción afecta el comportamiento de --build_tests_only y el comando de prueba.
- Configuración predeterminada de
--test_tag_filters=<comma-separated list of options>
: "" - 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 destinos de prueba que contengan, al menos, una etiqueta incluida y que no contengan etiquetas excluidas. Esta opción afecta el comportamiento de --build_tests_only y el comando de prueba.
- Configuración predeterminada de
--test_timeout_filters=<comma-separated list of values: short, moderate, long or eternal>
: "" - Especifica una lista separada por comas de tiempos de espera de prueba. De manera opcional, cada tiempo de espera puede ir precedido de "-" a los tiempos de espera excluidos. Solo se encontrarán los objetivos de prueba que contengan al menos un tiempo de espera incluido y no contengan tiempos de espera excluidos. Esta opción afecta el comportamiento de --build_tests_only y el comando de prueba.
- Configuración predeterminada de
--tool_java_language_version=<a string>
: "" - Versión de lenguaje Java que se usa para ejecutar las herramientas necesarias durante una compilación
- Configuración predeterminada de
--tool_java_runtime_version=<a string>
: "remotejdk_11" - Versión de entorno de ejecución de Java que se usa para ejecutar herramientas durante la compilación
- Valor predeterminado de
--[no]use_ijars
: “verdadero” - Si se habilita, esta opción hace que la compilación de Java use archivos jar de la interfaz. Como resultado, se realizará una compilación incremental más rápida, pero los mensajes de error pueden ser diferentes.
Opciones de marcas de canonicalización
Hereda todas las opciones de la compilación.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Lugares adicionales en los que buscar archivos antes de acceder a la red para descargarlos
Etiquetas:bazel_internal_configuration
- Valor predeterminado
--[no]experimental_repository_cache_hardlinks
: “falso” -
Si se establece, la caché del repositorio vinculará el archivo mediante un acierto de caché, en lugar de copiarlo. El objetivo es ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
- Valor predeterminado
--[no]experimental_repository_cache_urls_as_default_canonical_id
: “falso” -
Si es verdadero, usa una string derivada de las URLs de descargas del repositorio como canonical_id si no se especifica. Esto provoca que los cambios en las URL generen una nueva descarga incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no hagan que la caché oculte los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, los reintentos están inhabilitados.
Etiquetas:experimental
- Configuración predeterminada de
--experimental_scale_timeouts=<a double>
: “1.0” -
Escala este tiempo en todos los tiempos de espera de las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que son más lentas que lo que espera el autor de la regla, sin cambiar el código fuente
Etiquetas:bazel_internal_configuration
,experimental
- Configuración predeterminada de
--http_connector_attempts=<an integer>
: "8" -
Es la cantidad máxima de intentos de descarga de HTTP.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--http_connector_retry_max_timeout=<An immutable length of time.>
: “0 s” -
Es el tiempo de espera máximo para los reintentos de descarga de HTTP. Si el valor es 0, no se define ningún tiempo de espera máximo.
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--http_timeout_scaling=<a double>
: “1.0” -
Escalar todos los tiempos de espera relacionados con las descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: ver la 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é; de lo contrario, se usará el valor predeterminado “<output_user_root>/cache/repos/v1”
Etiquetas:bazel_internal_configuration
- Valor predeterminado
--[no]repository_disable_download
: “falso” -
Si se configura, no se permite la descarga mediante ctx.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no está completamente inhabilitado. ctx.execute puede ejecutar un ejecutable arbitrario que accede a Internet.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de la compilación:
- Valor predeterminado de
--experimental_oom_more_eagerly_threshold=<an integer in 0-100 range>
: "100" -
Si esta marca se establece en un valor inferior a 100, Bazel se encontrará OOM si después de dos recolecciones completas, se ocupa más de este porcentaje del montón (generación anterior).
Etiquetas:host_machine_resource_optimizations
- Opciones que controlan el resultado del comando:
- Valor predeterminado
--[no]canonicalize_policy
: “falso” -
Genera la política canónica después de la expansión y el filtrado. Para mantener limpio el resultado, NO se mostrarán los argumentos del comando canonicalizado cuando esta opción se establezca como verdadera. Tenga en cuenta que el comando especificado por --for_command afecta la política filtrada y, si no se especifica, el comando predeterminado es “build”.
Etiquetas:affects_outputs
,terminal_output
- Valor predeterminado
--[no]show_warnings
: “falso” -
Enviar advertencias sobre el analizador a errores estándar (p. ej., para opciones de marcas en conflicto)
Etiquetas:affects_outputs
,terminal_output
- Opciones que afectan la forma en que Bazel aplica entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etc.):
- Configuración predeterminada de
--experimental_repository_hash_file=<a string>
: "" -
Si no está vacío, especifica un archivo que contiene un valor resuelto, con 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 se trata de una lista de reglas de repositorio para las que se debe verificar el hash del directorio de salida, se debe proporcionar un archivo mediante --experimental_repository_hash_file.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje de Starlark o de la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE:
- Valor predeterminado de
--[no]experimental_allow_top_level_aspects_parameters
: “verdadero” -
Etiquetas no-ops
:no_op
,deprecated
,experimental
- Valor predeterminado
--[no]incompatible_config_setting_private_default_visibility
: “falso” -
Si incompatible_enforce_config_setting_visibility=false es, esto es noop. De lo contrario, si la marca es falsa, cualquier config_setting sin un atributo explícito de visibilidad será //visibility:public. Si esta marca es verdadera, config_setting sigue la misma lógica de visibilidad que todas las demás reglas. Consulta https://github.com/bazelbuild/bazel/issues/12933.
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]incompatible_enforce_config_setting_visibility
: “verdadero” -
Si es verdadero, aplique restricciones de visibilidad de config_setting. Si es falso, cada destino es visible para cada config_setting. 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 dependencia resuelto, incluso si se declaran con hilos en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones con errores harán que la resolución falle. También puedes definir una versión con un permiso permitido con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puede inhabilitar esta comprobación con la palabra clave "todos" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: “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 de `bazel_dep` directas declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencia resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para mostrar una advertencia cuando se detecta una discrepancia o "error" para derivarlo a una falla de resolución.
Etiquetas:loading_and_analysis
- Valor predeterminado
--[no]ignore_dev_dependency
: “falso” -
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en el MODULE.bazel del módulo raíz. Tenga en cuenta que esas dependencias para desarrolladores siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- Configuración predeterminada de
--lockfile_mode=<off, update or error>
: "desactivado" -
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "error" para usar el archivo de bloqueo, pero arroja un error si no está actualizado o "off" para evitar leer el archivo o escribir en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local con el formato <module name>=<path>. Si la ruta específica es absoluta, se usará tal como está. Si la ruta específica es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso determinada comienza con “%workspace%”, se relaciona con la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo recurrirán a los registros posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que activan optimizaciones del tiempo de compilación:
- Configuración predeterminada de
--experimental_gc_thrashing_limits=<comma separated pairs of <period>:<count>>
: "" -
Limita qué, si se alcanza, hace que GcThrashingDetector falle Bazel con un OOM. Cada límite se especifica como <período>:<count>, donde el período es una duración y el recuento es un número entero positivo. Si se supera el <count> GC total consecutivo de <period> consecutivos, se activará una cantidad superior al --experimental_oom_more_eagerly_Threshold por ciento del espacio titular (heap de generación anterior). Se pueden especificar varios límites separados por comas.
Etiquetas:host_machine_resource_optimizations
- Valor predeterminado de
--[no]gc_thrashing_limits_retained_heap_limiter_mutually_exclusive
: “verdadero” -
Si es verdadero, la especificación de --experimental_gc_thrashing_limits no vacía desactiva el RetainedHeapLimiter para que sea mutuamente excluyente con GcThrashingDetector. Si se establece como falsa, ambas pueden estar activas para el mismo comando.
Etiquetas:host_machine_resource_optimizations
- Configuración predeterminada de
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
: “2147483647” -
Marca que indica la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que su porcentaje de uso de montón retenido supera el umbral establecido por --skyframe_high_water_mark_Threshold, cuando se produzca un evento de recolección de elementos no utilizados total, se eliminará el estado temporal de Skyframe innecesario, hasta muchas veces por invocación. La configuración predeterminada es un número entero.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos de recolección de elementos no utilizados nunca activarán disminuciones. Si se alcanza el límite, ya no se eliminará el estado de Skyframe cuando se produzca un evento de recolección de elementos no utilizados completo y se supere el umbral del porcentaje del montón retenido.
Etiquetas:host_machine_resource_optimizations
- Configuración predeterminada de
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
: “2147483647” -
Marca que indica la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que su porcentaje de uso de montón retenido supera el umbral que establece --skyframe_high_water_mark_Threshold, cuando se produzca un evento de recolección de elementos no utilizados menor, se eliminará el estado temporal de Skyframe innecesario, hasta muchas veces por invocación. La configuración predeterminada es un número entero.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos de recolección de elementos no utilizados menores nunca activarán disminuciones. Si se alcanza el límite, ya no se eliminará el estado de Skyframe cuando se produzca un evento de recolección de elementos no utilizados menor y se supere el umbral del porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
- Configuración predeterminada de
--skyframe_high_water_mark_threshold=<an integer>
: “85” -
Marca que indica la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que su uso del montón retenido es al menos este umbral, dejará de ser necesario el estado temporal de Skyframe. Ajustar esto le permite mitigar el impacto de la hiperpaginación en la recolección de elementos no utilizados, cuando la hiperpaginación de GC es (i) causada por el uso de memoria de este estado temporal y (ii) más costosa que reconstituir el estado cuando es necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Valor predeterminado
--[no]experimental_command_profile
: “falso” - Registra un perfil de CPU de Grabadora de vuelo en Java en un archivo profile.jfr en el directorio base de salida. La sintaxis y la semántica de esta marca puede cambiar en el futuro para admitir diferentes tipos de perfiles o formatos de salida; úsala bajo tu propia responsabilidad.
- Valor predeterminado
--[no]experimental_record_metrics_for_all_mnemonics
: “falso” - De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 nombres mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si eliges esta opción, se escribirán estadísticas para todos los nombres mnemotécnicos.
- Opciones para especificar o alterar una entrada genérica en un comando de Bazel que no pertenece a otras categorías:
- Configuración predeterminada de
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Si no está vacío, lea el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Configuración predeterminada de
--for_command=<a string>
: “compilación” - El comando para el que se deben canonicalizar las opciones.
Etiquetas:affects_outputs
,terminal_output
- Configuración predeterminada de
--invocation_policy=<a string>
: "" -
Aplica una política de invocación a las opciones que se deben canonicalizar.
Etiquetas:affects_outputs
,terminal_output
- Opciones de ejecución y almacenamiento en caché remotos:
--experimental_downloader_config=<a string>
predeterminado: ver la descripción- Especifica un archivo para configurar el software de descarga remota. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para que coincida y otro para usar como URL sustituta, con referencias inversas a partir de "$1". Es posible proporcionar varias directivas "rewrite" para la misma URL, y en este caso se mostrarán varias.
- Configuración predeterminada de
--experimental_worker_for_repo_fetching=<off, platform or virtual>
: "desactivado" - Es el modo de subprocesos para usar en la recuperación de repositorios. Si se configura como "desactivada", no se usa ningún subproceso de trabajo, y la recuperación del repositorio está sujeta a reinicios. De lo contrario, usa un subproceso de plataforma (es decir, subproceso de SO) si se configura como “plataforma” o un subproceso virtual si se configura como “virtual”.
- Opciones misceláneas, pero que no estén categorizadas de otra manera:
- 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” existente. Por ejemplo, después de borrar x/y/BUILD en tu cliente, el sistema de compilación puede reclamar si encuentra una etiqueta "//x:y/z" si aún lo 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 una ruta de acceso local con el formato <nombre del repositorio>=<ruta>. Si la ruta específica es absoluta, se usará tal como está. Si la ruta dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso determinada comienza con “%workspace%”, se relaciona con la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Configuración predeterminada de
--package_path=<colon-separated list of options>
: "%workspace%" - Una lista separada por dos puntos en la que se buscan los paquetes. Los elementos que comienzan con "%workspace%" se relacionan con el lugar de trabajo que lo rodea. Si se omite o se deja vacío, el valor predeterminado es el resultado de "bazel info default-package-path".
- Valor predeterminado de
--[no]show_loading_progress
: “verdadero” - Si se habilita, Bazel imprime mensajes del tipo "Cargando paquete:".
Opciones de limpieza
Hereda todas las opciones de la compilación.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Lugares adicionales en los que buscar archivos antes de acceder a la red para descargarlos
Etiquetas:bazel_internal_configuration
- Valor predeterminado
--[no]experimental_repository_cache_hardlinks
: “falso” -
Si se establece, la caché del repositorio vinculará el archivo mediante un acierto de caché, en lugar de copiarlo. El objetivo es ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
- Valor predeterminado
--[no]experimental_repository_cache_urls_as_default_canonical_id
: “falso” -
Si es verdadero, usa una string derivada de las URLs de descargas del repositorio como canonical_id si no se especifica. Esto provoca que los cambios en las URL generen una nueva descarga incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no hagan que la caché oculte los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, los reintentos están inhabilitados.
Etiquetas:experimental
- Configuración predeterminada de
--experimental_scale_timeouts=<a double>
: “1.0” -
Escala este tiempo en todos los tiempos de espera de las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que son más lentas que lo que espera el autor de la regla, sin cambiar el código fuente
Etiquetas:bazel_internal_configuration
,experimental
- Configuración predeterminada de
--http_connector_attempts=<an integer>
: "8" -
Es la cantidad máxima de intentos de descarga de HTTP.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--http_connector_retry_max_timeout=<An immutable length of time.>
: “0 s” -
Es el tiempo de espera máximo para los reintentos de descarga de HTTP. Si el valor es 0, no se define ningún tiempo de espera máximo.
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--http_timeout_scaling=<a double>
: “1.0” -
Escalar todos los tiempos de espera relacionados con las descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: ver la 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é; de lo contrario, se usará el valor predeterminado “<output_user_root>/cache/repos/v1”
Etiquetas:bazel_internal_configuration
- Valor predeterminado
--[no]repository_disable_download
: “falso” -
Si se configura, no se permite la descarga mediante ctx.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no está completamente inhabilitado. ctx.execute puede ejecutar un ejecutable arbitrario que accede a Internet.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de la compilación:
- Valor predeterminado de
--experimental_oom_more_eagerly_threshold=<an integer in 0-100 range>
: "100" -
Si esta marca se establece en un valor inferior a 100, Bazel se encontrará OOM si después de dos recolecciones completas, se ocupa más de este porcentaje del montón (generación anterior).
Etiquetas:host_machine_resource_optimizations
- Opciones que controlan el resultado del comando:
- Valor predeterminado
--[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 pueda continuar en segundo plano.
Etiquetas:host_machine_resource_optimizations
- Valor predeterminado
--[no]expunge
: “falso” -
Si es verdadero, limpiar quita todo el árbol de trabajo de esta instancia de Bazel, que incluye todos los archivos temporales y compilados de salida de Bazel, y detiene el servidor de Bazel si está en ejecución.
Etiquetas:host_machine_resource_optimizations
--expunge_async
-
Si se especifica, limpiar de forma asíncrona quita todo el árbol de trabajo de esta instancia de Bazel, que incluye todos los archivos temporales y compilados de Bazel creados por Bazel, y detiene el servidor de Bazel si está en ejecución. Cuando se complete este comando, será seguro ejecutar comandos nuevos en el mismo cliente, aunque la eliminación pueda continuar en segundo plano.
Se expande a:
--expunge
--async
Etiquetas:host_machine_resource_optimizations
- Valor predeterminado
--[no]remove_all_convenience_symlinks
: “falso” -
Si es verdadero, se borrarán todos los symlinks del lugar de trabajo con el prefijo symlink_prefix. Sin esta marca, solo se borran los symlinks con los sufijos predefinidos.
Etiquetas:affects_outputs
- Opciones que afectan cómo se aplica estrictamente Bazel a las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etc.):
- Configuración predeterminada de
--experimental_repository_hash_file=<a string>
: "" -
Si no está vacío, especifica un archivo que contiene un valor resuelto, con 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 se trata de una lista de reglas de repositorio para las que se debe verificar el hash del directorio de salida, se debe proporcionar un archivo mediante --experimental_repository_hash_file.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje de Starlark o de la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE:
- Valor predeterminado de
--[no]experimental_allow_top_level_aspects_parameters
: “verdadero” -
No-op
Etiquetas:no_op
,deprecated
,experimental
- 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 dependencia resuelto, incluso si se declaran con hilos en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones con errores harán que la resolución falle. También puedes definir una versión con un permiso permitido con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puede inhabilitar esta comprobación con la palabra clave "todos" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: “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 de `bazel_dep` directas declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencia resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para mostrar una advertencia cuando se detecta una discrepancia o "error" para derivarlo a una falla de resolución.
Etiquetas:loading_and_analysis
- Valor predeterminado
--[no]ignore_dev_dependency
: “falso” -
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en el MODULE.bazel del módulo raíz. Tenga en cuenta que esas dependencias para desarrolladores siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- Configuración predeterminada de
--lockfile_mode=<off, update or error>
: "desactivado" -
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "error" para usar el archivo de bloqueo, pero arroja un error si no está actualizado o "off" para evitar leer el archivo o escribir en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local con el formato <module name>=<path>. Si la ruta específica es absoluta, se usará tal como está. Si la ruta específica es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso determinada comienza con “%workspace%”, se relaciona con la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo recurrirán a los registros posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que activan optimizaciones del tiempo de compilación:
- Configuración predeterminada de
--experimental_gc_thrashing_limits=<comma separated pairs of <period>:<count>>
: "" -
Limita qué, si se alcanza, hace que GcThrashingDetector falle Bazel con un OOM. Cada límite se especifica como <período>:<count>, donde el período es una duración y el recuento es un número entero positivo. Si se supera el <count> GC total consecutivo de <period> consecutivos, se activará una cantidad superior al --experimental_oom_more_eagerly_Threshold por ciento del espacio titular (heap de generación anterior). Se pueden especificar varios límites separados por comas.
Etiquetas:host_machine_resource_optimizations
- Valor predeterminado de
--[no]gc_thrashing_limits_retained_heap_limiter_mutually_exclusive
: “verdadero” -
Si es verdadero, la especificación de --experimental_gc_thrashing_limits no vacía desactiva el RetainedHeapLimiter para que sea mutuamente excluyente con GcThrashingDetector. Si se establece como falsa, ambas pueden estar activas para el mismo comando.
Etiquetas:host_machine_resource_optimizations
- Configuración predeterminada de
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
: “2147483647” -
Marca que indica la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que su porcentaje de uso de montón retenido supera el umbral establecido por --skyframe_high_water_mark_Threshold, cuando se produzca un evento de recolección de elementos no utilizados total, se eliminará el estado temporal de Skyframe innecesario, hasta muchas veces por invocación. La configuración predeterminada es un número entero.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos de recolección de elementos no utilizados nunca activarán disminuciones. Si se alcanza el límite, ya no se eliminará el estado de Skyframe cuando se produzca un evento de recolección de elementos no utilizados completo y se supere el umbral del porcentaje del montón retenido.
Etiquetas:host_machine_resource_optimizations
- Configuración predeterminada de
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
: “2147483647” -
Marca que indica la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que su porcentaje de uso de montón retenido supera el umbral que establece --skyframe_high_water_mark_Threshold, cuando se produzca un evento de recolección de elementos no utilizados menor, se eliminará el estado temporal de Skyframe innecesario, hasta muchas veces por invocación. La configuración predeterminada es un número entero.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos de recolección de elementos no utilizados menores nunca activarán disminuciones. Si se alcanza el límite, ya no se eliminará el estado de Skyframe cuando se produzca un evento de recolección de elementos no utilizados menor y se supere el umbral del porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
- Configuración predeterminada de
--skyframe_high_water_mark_threshold=<an integer>
: “85” -
Marca que indica la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que su uso del montón retenido es al menos este umbral, dejará de ser necesario el estado temporal de Skyframe. Ajustar esto le permite mitigar el impacto de la hiperpaginación en la recolección de elementos no utilizados, cuando la hiperpaginación de GC es (i) causada por el uso de memoria de este estado temporal y (ii) más costosa que reconstituir el estado cuando es necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Valor predeterminado
--[no]experimental_command_profile
: “falso” - Registra un perfil de CPU de Grabadora de vuelo en Java en un archivo profile.jfr en el directorio base de salida. La sintaxis y la semántica de esta marca puede cambiar en el futuro para admitir diferentes tipos de perfiles o formatos de salida; úsala bajo tu propia responsabilidad.
- Valor predeterminado
--[no]experimental_record_metrics_for_all_mnemonics
: “falso” - De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 nombres mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si eliges esta opción, se escribirán estadísticas para todos los nombres mnemotécnicos.
- Opciones para especificar o alterar una entrada genérica en un comando de Bazel que no pertenece a otras categorías:
- Configuración predeterminada de
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Si no está vacío, lea el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remota:
--experimental_downloader_config=<a string>
predeterminado: ver la descripción- Especifica un archivo para configurar el software de descarga remota. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para que coincida y otro para usar como URL sustituta, con referencias inversas a partir de "$1". Es posible proporcionar varias directivas "rewrite" para la misma URL, y en este caso se mostrarán varias.
- Configuración predeterminada de
--experimental_worker_for_repo_fetching=<off, platform or virtual>
: "desactivado" - Es el modo de subprocesos para usar en la recuperación de repositorios. Si se configura como "desactivada", no se usa ningún subproceso de trabajo, y la recuperación del repositorio está sujeta a reinicios. De lo contrario, usa un subproceso de plataforma (es decir, subproceso de SO) si se configura como “plataforma” o un subproceso virtual si se configura como “virtual”.
- Opciones misceláneas, pero que no estén categorizadas de otra manera:
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local con el formato <nombre del repositorio>=<ruta>. Si la ruta específica es absoluta, se usará tal como está. Si la ruta dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso determinada comienza con “%workspace%”, se relaciona con la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
Opciones de configuración
Opciones de cobertura
Hereda todas las opciones de test.
- Opciones que aparecen antes del comando y que el cliente analiza:
- Se acumulan
--distdir=<a path>
usos múltiples -
Lugares adicionales en los que buscar archivos antes de acceder a la red para descargarlos
Etiquetas:bazel_internal_configuration
- Valor predeterminado
--[no]experimental_repository_cache_hardlinks
: “falso” -
Si se establece, la caché del repositorio vinculará el archivo mediante un acierto de caché, en lugar de copiarlo. El objetivo es ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
- Valor predeterminado
--[no]experimental_repository_cache_urls_as_default_canonical_id
: “falso” -
Si es verdadero, usa una string derivada de las URLs de descargas del repositorio como canonical_id si no se especifica. Esto provoca que los cambios en las URL generen una nueva descarga incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no hagan que la caché oculte los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, los reintentos están inhabilitados.
Etiquetas:experimental
- Configuración predeterminada de
--experimental_scale_timeouts=<a double>
: “1.0” -
Escala este tiempo en todos los tiempos de espera de las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que son más lentas que lo que espera el autor de la regla, sin cambiar el código fuente
Etiquetas:bazel_internal_configuration
,experimental
- Configuración predeterminada de
--http_connector_attempts=<an integer>
: "8" -
Es la cantidad máxima de intentos de descarga de HTTP.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--http_connector_retry_max_timeout=<An immutable length of time.>
: “0 s” -
Es el tiempo de espera máximo para los reintentos de descarga de HTTP. Si el valor es 0, no se define ningún tiempo de espera máximo.
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--http_timeout_scaling=<a double>
: “1.0” -
Escalar todos los tiempos de espera relacionados con las descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: ver la 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é; de lo contrario, se usará el valor predeterminado “<output_user_root>/cache/repos/v1”
Etiquetas:bazel_internal_configuration
- Valor predeterminado
--[no]repository_disable_download
: “falso” -
Si se configura, no se permite la descarga mediante ctx.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no está completamente inhabilitado. ctx.execute puede ejecutar un ejecutable arbitrario que accede a Internet.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de la compilación:
- Valor predeterminado de
--experimental_oom_more_eagerly_threshold=<an integer in 0-100 range>
: "100" -
Si esta marca se establece en un valor inferior a 100, Bazel se encontrará OOM si después de dos recolecciones completas, se ocupa más de este porcentaje del montón (generación anterior).
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan cómo se aplica estrictamente Bazel a las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etc.):
- Configuración predeterminada de
--experimental_repository_hash_file=<a string>
: "" -
Si no está vacío, especifica un archivo que contiene un valor resuelto, con 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 se trata de una lista de reglas de repositorio para las que se debe verificar el hash del directorio de salida, se debe proporcionar un archivo mediante --experimental_repository_hash_file.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje de Starlark o de la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE:
- Valor predeterminado de
--[no]experimental_allow_top_level_aspects_parameters
: “verdadero” -
No-op
Etiquetas:no_op
,deprecated
,experimental
- 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 dependencia resuelto, incluso si se declaran con hilos en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones con errores harán que la resolución falle. También puedes definir una versión con un permiso permitido con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puede inhabilitar esta comprobación con la palabra clave "todos" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: “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 de `bazel_dep` directas declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencia resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para mostrar una advertencia cuando se detecta una discrepancia o "error" para derivarlo a una falla de resolución.
Etiquetas:loading_and_analysis
- Valor predeterminado
--[no]ignore_dev_dependency
: “falso” -
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en el MODULE.bazel del módulo raíz. Tenga en cuenta que esas dependencias para desarrolladores siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- Configuración predeterminada de
--lockfile_mode=<off, update or error>
: "desactivado" -
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "error" para usar el archivo de bloqueo, pero arroja un error si no está actualizado o "off" para evitar leer el archivo o escribir en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local con el formato <module name>=<path>. Si la ruta específica es absoluta, se usará tal como está. Si la ruta específica es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso determinada comienza con “%workspace%”, se relaciona con la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo recurrirán a los registros posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que activan optimizaciones del tiempo de compilación:
- Configuración predeterminada de
--experimental_gc_thrashing_limits=<comma separated pairs of <period>:<count>>
: "" -
Limita qué, si se alcanza, hace que GcThrashingDetector falle Bazel con un OOM. Cada límite se especifica como <período>:<count>, donde el período es una duración y el recuento es un número entero positivo. Si se supera el <count> GC total consecutivo de <period> consecutivos, se activará una cantidad superior al --experimental_oom_more_eagerly_Threshold por ciento del espacio titular (heap de generación anterior). Se pueden especificar varios límites separados por comas.
Etiquetas:host_machine_resource_optimizations
- Valor predeterminado de
--[no]gc_thrashing_limits_retained_heap_limiter_mutually_exclusive
: “verdadero” -
Si es verdadero, la especificación de --experimental_gc_thrashing_limits no vacía desactiva el RetainedHeapLimiter para que sea mutuamente excluyente con GcThrashingDetector. Si se establece como falsa, ambas pueden estar activas para el mismo comando.
Etiquetas:host_machine_resource_optimizations
- Configuración predeterminada de
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
: “2147483647” -
Marca que indica la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que su porcentaje de uso de montón retenido supera el umbral establecido por --skyframe_high_water_mark_Threshold, cuando se produzca un evento de recolección de elementos no utilizados total, se eliminará el estado temporal de Skyframe innecesario, hasta muchas veces por invocación. La configuración predeterminada es un número entero.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos de recolección de elementos no utilizados nunca activarán disminuciones. Si se alcanza el límite, ya no se eliminará el estado de Skyframe cuando se produzca un evento de recolección de elementos no utilizados completo y se supere el umbral del porcentaje del montón retenido.
Etiquetas:host_machine_resource_optimizations
- Configuración predeterminada de
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
: “2147483647” -
Marca que indica la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que su porcentaje de uso de montón retenido supera el umbral que establece --skyframe_high_water_mark_Threshold, cuando se produzca un evento de recolección de elementos no utilizados menor, se eliminará el estado temporal de Skyframe innecesario, hasta muchas veces por invocación. La configuración predeterminada es un número entero.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos de recolección de elementos no utilizados menores nunca activarán disminuciones. Si se alcanza el límite, ya no se eliminará el estado de Skyframe cuando se produzca un evento de recolección de elementos no utilizados menor y se supere el umbral del porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
- Configuración predeterminada de
--skyframe_high_water_mark_threshold=<an integer>
: “85” -
Marca que indica la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que su uso del montón retenido es al menos este umbral, dejará de ser necesario el estado temporal de Skyframe. Ajustar esto le permite mitigar el impacto de la hiperpaginación en la recolección de elementos no utilizados, cuando la hiperpaginación de GC es (i) causada por el uso de memoria de este estado temporal y (ii) más costosa que reconstituir el estado cuando es necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Valor predeterminado
--[no]experimental_command_profile
: “falso” - Registra un perfil de CPU de Grabadora de vuelo en Java en un archivo profile.jfr en el directorio base de salida. La sintaxis y la semántica de esta marca puede cambiar en el futuro para admitir diferentes tipos de perfiles o formatos de salida; úsala bajo tu propia responsabilidad.
- Valor predeterminado
--[no]experimental_record_metrics_for_all_mnemonics
: “falso” - De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 nombres mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si eliges esta opción, se escribirán estadísticas para todos los nombres mnemotécnicos.
- Opciones para especificar o alterar una entrada genérica en un comando de Bazel que no pertenece a otras categorías:
- Configuración predeterminada de
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Si no está vacío, lea el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remota:
--experimental_downloader_config=<a string>
predeterminado: ver la descripción- Especifica un archivo para configurar el software de descarga remota. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para que coincida y otro para usar como URL sustituta, con referencias inversas a partir de "$1". Es posible proporcionar varias directivas "rewrite" para la misma URL, y en este caso se mostrarán varias.
- Configuración predeterminada de
--experimental_worker_for_repo_fetching=<off, platform or virtual>
: "desactivado" - Es el modo de subprocesos para usar en la recuperación de repositorios. Si se configura como "desactivada", no se usa ningún subproceso de trabajo, y la recuperación del repositorio está sujeta a reinicios. De lo contrario, usa un subproceso de plataforma (es decir, subproceso de SO) si se configura como “plataforma” o un subproceso virtual si se configura como “virtual”.
- Opciones misceláneas, pero que no estén categorizadas de otra manera:
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local con el formato <nombre del repositorio>=<ruta>. Si la ruta específica es absoluta, se usará tal como está. Si la ruta dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso determinada comienza con “%workspace%”, se relaciona con la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
Opciones de BigQuery
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 -
Lugares adicionales en los que buscar archivos antes de acceder a la red para descargarlos
Etiquetas:bazel_internal_configuration
- Valor predeterminado
--[no]experimental_repository_cache_hardlinks
: “falso” -
Si se establece, la caché del repositorio vinculará el archivo mediante un acierto de caché, en lugar de copiarlo. El objetivo es ahorrar espacio en el disco.
Etiquetas:bazel_internal_configuration
- Valor predeterminado
--[no]experimental_repository_cache_urls_as_default_canonical_id
: “falso” -
Si es verdadero, usa una string derivada de las URLs de descargas del repositorio como canonical_id si no se especifica. Esto provoca que los cambios en las URL generen una nueva descarga incluso si la caché contiene una descarga con el mismo hash. Esto se puede usar para verificar que los cambios en la URL no hagan que la caché oculte los repositorios dañados.
Etiquetas:loading_and_analysis
,experimental
--experimental_repository_downloader_retries=<an integer>
predeterminado: “0”-
Es la cantidad máxima de intentos para reintentar un error de descarga. Si se establece en 0, los reintentos están inhabilitados.
Etiquetas:experimental
- Configuración predeterminada de
--experimental_scale_timeouts=<a double>
: “1.0” -
Escala este tiempo en todos los tiempos de espera de las reglas del repositorio de Starlark. De esta manera, los repositorios externos pueden funcionar en máquinas que son más lentas que lo que espera el autor de la regla, sin cambiar el código fuente
Etiquetas:bazel_internal_configuration
,experimental
- Configuración predeterminada de
--http_connector_attempts=<an integer>
: "8" -
Es la cantidad máxima de intentos de descarga de HTTP.
Etiquetas:bazel_internal_configuration
- Valor predeterminado de
--http_connector_retry_max_timeout=<An immutable length of time.>
: “0 s” -
Es el tiempo de espera máximo para los reintentos de descarga de HTTP. Si el valor es 0, no se define ningún tiempo de espera máximo.
Etiquetas:bazel_internal_configuration
- Configuración predeterminada de
--http_timeout_scaling=<a double>
: “1.0” -
Escalar todos los tiempos de espera relacionados con las descargas HTTP según el factor determinado
Etiquetas:bazel_internal_configuration
--repository_cache=<a path>
predeterminado: ver la 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é; de lo contrario, se usará el valor predeterminado “<output_user_root>/cache/repos/v1”
Etiquetas:bazel_internal_configuration
- Valor predeterminado
--[no]repository_disable_download
: “falso” -
Si se configura, no se permite la descarga mediante ctx.download{,_and_extract} durante la recuperación del repositorio. Ten en cuenta que el acceso a la red no está completamente inhabilitado. ctx.execute puede ejecutar un ejecutable arbitrario que accede a Internet.
Etiquetas:bazel_internal_configuration
- Opciones que controlan la ejecución de la compilación:
- Valor predeterminado de
--experimental_oom_more_eagerly_threshold=<an integer in 0-100 range>
: "100" -
Si esta marca se establece en un valor inferior a 100, Bazel se encontrará OOM si después de dos recolecciones completas, se ocupa más de este porcentaje del montón (generación anterior).
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan cómo se aplica estrictamente Bazel a las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etc.):
- Configuración predeterminada de
--experimental_repository_hash_file=<a string>
: "" -
Si no está vacío, especifica un archivo que contiene un valor resuelto, con 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 se trata de una lista de reglas de repositorio para las que se debe verificar el hash del directorio de salida, se debe proporcionar un archivo mediante --experimental_repository_hash_file.
Etiquetas:affects_outputs
,experimental
- Esta opción afecta la semántica del lenguaje de Starlark o de la API de compilación accesible para los archivos BUILD, .bzl o WORKSPACE:
- Valor predeterminado de
--[no]experimental_allow_top_level_aspects_parameters
: “verdadero” -
No-op
Etiquetas:no_op
,deprecated
,experimental
- Opciones relacionadas con la semántica y el resultado de la consulta:
--aspect_deps=<off, conservative or precise>
predeterminado: “conservador”-
Cómo resolver dependencias de aspectos cuando el formato de salida es uno de {xml,proto,record}. "off" significa que no se resuelven dependencias de aspecto, "conservative" (la configuración predeterminada) significa que se agregan todas las dependencias de aspecto declaradas, independientemente de si tienen la clase de regla de dependencias directas. "Precise" 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 solo destino y, por lo tanto, que sea más lento que los otros modos. Además, tenga en cuenta que ni el modo exacto es completamente preciso: la decisión de calcular un aspecto se decide en la fase de análisis, que no se ejecuta durante la "consulta de Bazel".
Etiquetas:build_file_semantics
- Valor predeterminado de
--[no]graph:factored
: “verdadero” -
Si es verdadero, el grafo se emitirá como “factorizado”, es decir, los nodos topológicamente equivalentes se combinarán y sus etiquetas se concatenarán. Esta opción solo se aplica a --output=gráfico.
Etiquetas:terminal_output
- Configuración predeterminada de
--graph:node_limit=<an integer>
: “512” -
Es la longitud máxima de la string de etiqueta para un nodo del gráfico en el resultado. Las etiquetas más largas se truncarán. -1 significa que no hay truncamientos. Esta opción solo se aplica a --output=gráfico.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]implicit_deps
: “verdadero” -
Si se habilita, 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 BigQuery, esta opción controla el filtrado de las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
- Valor predeterminado de
--[no]include_aspects
: “verdadero” -
query, cquery: si se deben incluir acciones generadas por aspectos en el resultado. query: no-op (se siguen siempre los aspectos).
Etiquetas:terminal_output
- Valor predeterminado de
--[no]incompatible_display_source_file_location
: “verdadero” -
Verdadero o 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
- Valor predeterminado de
--[no]incompatible_package_group_includes_double_slash
: “verdadero” -
Si se habilita, no se omitirá el “//” inicial al generar el atributo “packages” del paquete package_group.
Etiquetas:terminal_output
,incompatible_change
- Valor predeterminado
--[no]infer_universe_scope
: “falso” - Si no se establece y --universe_scope, se inferirá el 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 centradas en el universo (p.ej., “allrdeps”) no es lo que deseas, por lo que debes usar esta opción solo si sabes lo que estás haciendo. Consulta https://bazel.build/reference/query#sky-query para obtener detalles y ejemplos. Si se establece --universe_scope, se ignora el valor de esta opción. Nota: Esta opción solo se aplica a `query` (es decir, no "cquery").
Etiquetas:loading_and_analysis
- Valor predeterminado
--[no]line_terminator_null
: “falso” -
Indica si cada formato termina con \0 en lugar de de nueva línea.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]nodep_deps
: “verdadero” -
Si se habilita, las dependencias de los atributos “nodep” se incluirán en el gráfico de dependencias con el que opera la consulta. Un ejemplo común de un atributo "nodep" es "visibilidad". Ejecuta y analiza el resultado de “info build-language” para conocer todos los atributos de “nodep” en el lenguaje de compilación.
Etiquetas:build_file_semantics
- Valor predeterminado de
--output=<a string>
: “etiqueta” - El formato en el que se deben imprimir los resultados de la consulta. Los valores permitidos para cquery son: label, label_kind, textproto, transition, proto, jsonproto. Si seleccionas "transiciones", también debes especificar la opción --transitions=(lite|full).
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:default_values
: “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
--[no]proto:definition_stack
: “falso” -
Propaga el campo proto Definition_stack, que registra para cada instancia de la regla la pila de llamadas de Starlark en el momento en que se definió la clase de la regla.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:flatten_selects
: “verdadero” -
Si se habilita, se aplanan los atributos configurables creados por select(). Para los tipos acoplados, la representación plana es una lista que contiene cada valor del mapa seleccionado solo una vez. Los tipos de escalar se acoplan a un valor nulo.
Etiquetas:build_file_semantics
- Valor predeterminado
--[no]proto:include_attribute_source_aspects
: “falso” -
Propaga el campo proto source_aspect_name de cada atributo con el aspecto de origen del que proviene (string vacía si no lo tenía).
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:include_configurations
: “verdadero” - , si está habilitado, el resultado del proto incluirá información sobre las configuraciones. Cuando está inhabilitado,el formato de salida de proto de consulta se parece al formato de salida de consulta.
Etiquetas:affects_outputs
- Valor predeterminado
--[no]proto:include_synthetic_attribute_hash
: “falso” -
Indica si el atributo $internal_attr_hash se calcula y se propaga.
Etiquetas:terminal_output
- Valor predeterminado
--[no]proto:instantiation_stack
: “falso” -
Propaga la pila de llamadas de creación de instancias de cada regla. Ten en cuenta que esto requiere que la pila esté presente.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:locations
: “verdadero” -
Indica si se debe generar información de la 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 para incluir en la salida. La configuración predeterminada es todos los atributos. Configúrala como string vacía para no mostrar ningún atributo. Esta opción se aplica a --output=proto.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:rule_inputs_and_outputs
: “verdadero” -
Indica si se propagarán los campos rule_input y rule_output.
Etiquetas:terminal_output
- Configuración predeterminada de
--query_file=<a string>
: "" -
Si se establece, la consulta leerá la consulta del archivo que se nombra aquí, en lugar de hacerlo en la línea de comandos. Es un error especificar un archivo aquí y una consulta de la línea de comandos.
Etiquetas:changes_inputs
- Valor predeterminado
--[no]relative_locations
: “falso” -
Si es verdadero, la ubicación de los archivos BUILD en los resultados de XML y proto será relativa. De forma predeterminada, el resultado de ubicación es una ruta absoluta y no será coherente entre las máquinas. Puedes configurar esta opción como verdadera para obtener un resultado coherente en todas las máquinas.
Etiquetas:terminal_output
- Configuración predeterminada de
--show_config_fragments=<off, direct or transitive>
: "desactivado" -
Muestra los fragmentos de configuración que requiere una regla y sus dependencias transitivas. Esto puede ser útil para evaluar cuánto se puede recortar un gráfico objetivo configurado.
Etiquetas:affects_outputs
- Configuración predeterminada de
--starlark:expr=<a string>
: "" -
Una expresión de Starlark para dar formato a cada destino configurado en el modo --output=starlark de BigQuery. El objetivo configurado está vinculado a "target". Si no se especifica --starlark:expr ni --starlark:file, el valor predeterminado de esta opción será "str(target.label)". Es un error especificar tanto --starlark:expr como --starlark:file.
Etiquetas:terminal_output
- Configuración predeterminada de
--starlark:file=<a string>
: "" -
Es el nombre de un archivo que define una función de Starlark, denominada “formato”, de un argumento que se aplica a cada destino configurado para darle formato como una string. Es un error especificar tanto --starlark:expr como --starlark:file. Para obtener información adicional, consulta la ayuda de --output=starlark.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]tool_deps
: “verdadero” -
Consulta: Si está inhabilitada, las dependencias de la "configuración exec" no se incluirán en el gráfico de dependencias sobre el que opera la consulta. Una arista de dependencia de “configuración de exec”, como la de cualquier regla de “proto_library” al Compilador de protocolos, generalmente apunta a una herramienta ejecutada durante la compilación en lugar de a una parte del mismo programa de “destino”.
Consulta: Si se inhabilita, filtra todos los destinos configurados que cruzan una transición de ejecución del objetivo de nivel superior que descubrió este destino configurado. Esto significa que si el objetivo de nivel superior está en la configuración de destino, solo se mostrarán los objetivos configurados también en la configuración de destino. Si el destino de nivel superior está en la configuración de ejecución, solo se mostrarán los objetivos configurados. Esta opción NO excluirá las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
- Configuración predeterminada de
--transitions=<full, lite or none>
: “ninguno” -
Es el formato en el que se imprime la información de transición.
Etiquetas:affects_outputs
- Configuración predeterminada de
--universe_scope=<comma-separated list of options>
: "" -
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 objetivos especificados. Esta opción se usa para los comandos de consulta y cquery.
Para BigQuery, la entrada a esta opción son los objetivos en los que se crean 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: Si usas cquery, no especificar esta opción puede hacer que la compilación falle 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 dependencia resuelto, incluso si se declaran con hilos en el registro de donde provienen (si no provienen de un NonRegistryOverride). De lo contrario, las versiones con errores harán que la resolución falle. También puedes definir una versión con un permiso permitido con la variable de entorno "BZLMOD_ALLOW_YANKED_VERSIONS". Puede inhabilitar esta comprobación con la palabra clave "todos" (no se recomienda).
Etiquetas:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
predeterminado: “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 de `bazel_dep` directas declaradas en el módulo raíz son las mismas versiones que obtienes en el gráfico de dependencia resuelto. Los valores válidos son "off" para inhabilitar la verificación, "warning" para mostrar una advertencia cuando se detecta una discrepancia o "error" para derivarlo a una falla de resolución.
Etiquetas:loading_and_analysis
- Valor predeterminado
--[no]ignore_dev_dependency
: “falso” -
Si es verdadero, Bazel ignora "bazel_dep" y "use_extension" declarados como "dev_dependency" en el MODULE.bazel del módulo raíz. Tenga en cuenta que esas dependencias para desarrolladores siempre se ignoran en MODULE.bazel si no es el módulo raíz, independientemente del valor de esta marca.
Etiquetas:loading_and_analysis
- Configuración predeterminada de
--lockfile_mode=<off, update or error>
: "desactivado" -
Especifica cómo y si se debe usar o no el archivo de bloqueo. Los valores válidos son "update" para usar el archivo de bloqueo y actualizarlo si hay cambios, "error" para usar el archivo de bloqueo, pero arroja un error si no está actualizado o "off" para evitar leer el archivo o escribir en él.
Etiquetas:loading_and_analysis
- Se acumulan
--override_module=<an equals-separated mapping of module name to path>
usos múltiples - Anula un módulo con una ruta de acceso local con el formato <module name>=<path>. Si la ruta específica es absoluta, se usará tal como está. Si la ruta específica es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso determinada comienza con “%workspace%”, se relaciona con la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Se acumulan
--registry=<a string>
usos múltiples -
Especifica los registros que se usarán para ubicar las dependencias del módulo de Bazel. El orden es importante: los módulos se buscarán primero en los registros anteriores y solo recurrirán a los registros posteriores cuando falten en los anteriores.
Etiquetas:changes_inputs
- Opciones que activan optimizaciones del tiempo de compilación:
- Configuración predeterminada de
--experimental_gc_thrashing_limits=<comma separated pairs of <period>:<count>>
: "" -
Limita qué, si se alcanza, hace que GcThrashingDetector falle Bazel con un OOM. Cada límite se especifica como <período>:<count>, donde el período es una duración y el recuento es un número entero positivo. Si se supera el <count> GC total consecutivo de <period> consecutivos, se activará una cantidad superior al --experimental_oom_more_eagerly_Threshold por ciento del espacio titular (heap de generación anterior). Se pueden especificar varios límites separados por comas.
Etiquetas:host_machine_resource_optimizations
- Valor predeterminado de
--[no]gc_thrashing_limits_retained_heap_limiter_mutually_exclusive
: “verdadero” -
Si es verdadero, la especificación de --experimental_gc_thrashing_limits no vacía desactiva el RetainedHeapLimiter para que sea mutuamente excluyente con GcThrashingDetector. Si se establece como falsa, ambas pueden estar activas para el mismo comando.
Etiquetas:host_machine_resource_optimizations
- Configuración predeterminada de
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
: “2147483647” -
Marca que indica la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que su porcentaje de uso de montón retenido supera el umbral establecido por --skyframe_high_water_mark_Threshold, cuando se produzca un evento de recolección de elementos no utilizados total, se eliminará el estado temporal de Skyframe innecesario, hasta muchas veces por invocación. La configuración predeterminada es un número entero.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos de recolección de elementos no utilizados nunca activarán disminuciones. Si se alcanza el límite, ya no se eliminará el estado de Skyframe cuando se produzca un evento de recolección de elementos no utilizados completo y se supere el umbral del porcentaje del montón retenido.
Etiquetas:host_machine_resource_optimizations
- Configuración predeterminada de
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
: “2147483647” -
Marca que indica la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que su porcentaje de uso de montón retenido supera el umbral que establece --skyframe_high_water_mark_Threshold, cuando se produzca un evento de recolección de elementos no utilizados menor, se eliminará el estado temporal de Skyframe innecesario, hasta muchas veces por invocación. La configuración predeterminada es un número entero.MAX_VALUE; efectivamente ilimitado. Cero significa que los eventos de recolección de elementos no utilizados menores nunca activarán disminuciones. Si se alcanza el límite, ya no se eliminará el estado de Skyframe cuando se produzca un evento de recolección de elementos no utilizados menor y se supere el umbral del porcentaje de montón retenido.
Etiquetas:host_machine_resource_optimizations
- Configuración predeterminada de
--skyframe_high_water_mark_threshold=<an integer>
: “85” -
Marca que indica la configuración avanzada del motor de Skyframe interno de Bazel. Si Bazel detecta que su uso del montón retenido es al menos este umbral, dejará de ser necesario el estado temporal de Skyframe. Ajustar esto le permite mitigar el impacto de la hiperpaginación en la recolección de elementos no utilizados, cuando la hiperpaginación de GC es (i) causada por el uso de memoria de este estado temporal y (ii) más costosa que reconstituir el estado cuando es necesario.
Etiquetas:host_machine_resource_optimizations
- Opciones que afectan la verbosidad, el formato o la ubicación del registro:
- Valor predeterminado
--[no]experimental_command_profile
: “falso” - Registra un perfil de CPU de Grabadora de vuelo en Java en un archivo profile.jfr en el directorio base de salida. La sintaxis y la semántica de esta marca puede cambiar en el futuro para admitir diferentes tipos de perfiles o formatos de salida; úsala bajo tu propia responsabilidad.
- Valor predeterminado
--[no]experimental_record_metrics_for_all_mnemonics
: “falso” - De forma predeterminada, la cantidad de tipos de acciones se limita a los 20 nombres mnemotécnicos con la mayor cantidad de acciones ejecutadas. Si eliges esta opción, se escribirán estadísticas para todos los nombres mnemotécnicos.
- Opciones para especificar o alterar una entrada genérica en un comando de Bazel que no pertenece a otras categorías:
- Configuración predeterminada de
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Si no está vacío, lea el archivo resuelto especificado en lugar del archivo WORKSPACE.
Etiquetas:changes_inputs
- Opciones de ejecución y almacenamiento en caché remota:
--experimental_downloader_config=<a string>
predeterminado: ver la descripción- Especifica un archivo para configurar el software de descarga remota. Este archivo consta de líneas, cada una de las cuales comienza con una directiva ("allow", "block" o "rewrite") seguida de un nombre de host (para "allow" y "block") o dos patrones, uno para que coincida y otro para usar como URL sustituta, con referencias inversas a partir de "$1". Es posible proporcionar varias directivas "rewrite" para la misma URL, y en este caso se mostrarán varias.
- Configuración predeterminada de
--experimental_worker_for_repo_fetching=<off, platform or virtual>
: "desactivado" - Es el modo de subprocesos para usar en la recuperación de repositorios. Si se configura como "desactivada", no se usa ningún subproceso de trabajo, y la recuperación del repositorio está sujeta a reinicios. De lo contrario, usa un subproceso de plataforma (es decir, subproceso de SO) si se configura como “plataforma” o un subproceso virtual si se configura como “virtual”.
- Opciones misceláneas, pero que no estén categorizadas de otra manera:
- Se acumulan
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiples - Anula un repositorio con una ruta de acceso local con el formato <nombre del repositorio>=<ruta>. Si la ruta específica es absoluta, se usará tal como está. Si la ruta dada es relativa, es relativa al directorio de trabajo actual. Si la ruta de acceso determinada comienza con “%workspace%”, es relativo en la raíz del lugar de trabajo, que es el resultado de “bazel info workspace”.
- Opciones que controlan la ejecución de la compilación:
- Valor predeterminado
--[no]experimental_inprocess_symlink_creation
: “falso” -
Hacer llamadas directas al sistema de archivos para crear árboles de symlink
Etiquetas:loading_and_analysis
,execution
,experimental
- Valor predeterminado
--[no]experimental_remotable_source_manifests
: “falso” -
Determina si se deben hacer acciones de manifiesto de manera remota.
Etiquetas:loading_and_analysis
,execution
,experimental
- Valor predeterminado
--[no]experimental_split_coverage_postprocessing
: “falso” -
Si es verdadero, Bazel ejecutará el procesamiento posterior de la cobertura para la prueba en una generación nueva.
Etiquetas:execution
- Valor predeterminado
--[no]experimental_strict_fileset_output
: “falso” -
Si se habilita esta opción, los conjuntos de archivos tratarán todos los artefactos de salida como archivos normales. No recorrerán directorios ni serán sensibles a los symlinks.
Etiquetas:execution
- Configuración predeterminada de
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
: "" -
Agrega o quita claves de la información de ejecución de una acción según los términos nemotécnicos de la acción. Solo se aplica a las acciones que admiten información de ejecución. Muchas acciones comunes admiten información de ejecución, p.ej., Genrule, CppCompile, Javac, StarlarkAction, TestRunner. Cuando se especifican varios valores, el orden es importante porque muchas regex se pueden aplicar al mismo valor mnemotécnico.
Sintaxis: "regex=[+-]key,regex=[+-]key,...".
Ejemplos: “.*=+x,.*=-y,.*=+z” agrega “x” y “z” y quita “y” de la información de ejecución para todas las acciones.
“Genrule=+requiere-x” agrega “requiere-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 sean de Genenrule.
Etiquetas:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Habilita acciones persistentes de expansión de sintaxis y Android dex mediante el uso de trabajadores.
Se expande a:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
- Habilita el procesador de recursos persistente de Android mediante trabajadores.
Se expande a las siguientes ubicaciones:
--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
{12/1}2{2/1/2} {14/1} {14/1}--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
host_machine_resource_optimizations
execution
--persistent_multiplex_android_dex_desugar
-
Habilita acciones multiplexadas y desugar de Android multiplexadas persistentes con trabajadores.
Se expande a:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
Etiquetas:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
Habilita el procesador de recursos multiplexados persistentes de Android con trabajadores.
Se expande a las siguientes ubicaciones:
--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
{12/1}2{2/1/2} {14/1} {14/1}--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
host_machine_resource_optimizations
execution
--persistent_multiplex_android_tools
- Habilita herramientas para Android persistentes y multiplexadas (dexing, expansión de sintaxis, procesamiento de recursos).
Se expande a:
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Etiquetas:host_machine_resource_optimizations
,execution
- Valor predeterminado
--[no]use_target_platform_for_tests
: “falso” -
Si es verdadero, Bazel usará la plataforma de destino para ejecutar pruebas en lugar del grupo de ejecución de pruebas.
Etiquetas:execution
- Opciones que configuran la cadena de herramientas que se usa para la ejecución de la acción:
--android_compiler=<a string>
predeterminado: ver la descripción-
Es el compilador de destino de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Configuración predeterminada de
--android_crosstool_top=<a build target label>
: "//external:android/crosstool" -
Es la ubicación del compilador de C++ que se usa para las compilaciones de Android.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_grte_top=<a label>
predeterminado: ver la descripción-
El objetivo de Android: grte_top
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
- Configuración predeterminada de
--android_manifest_merger=<legacy, android or force_android>
: "android" -
Selecciona la combinación de manifiestos que se usará para las reglas android_binary. Marca para ayudar a realizar la transición a la combinación de manifiestos de Android desde la combinación heredada.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Configuración predeterminada de
--android_platforms=<a build target label>
: "" -
Establece las plataformas que usan los objetivos 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
- Configuración predeterminada de
--android_sdk=<a build target label>
: "@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 la descripción-
Es 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
- Configuración predeterminada de
--apple_crosstool_top=<a build target label>
: "@bazel_tools//tools/cpp:toolchain" -
Es la etiqueta del paquete crosstool que se usará en las reglas de Apple y Objc, así como sus dependencias.
Etiquetas:loses_incremental_state
,changes_inputs
--apple_grte_top=<a build target label>
predeterminado: ver la descripción-
El objetivo grte_top de Apple.
Etiquetas:changes_inputs
,loading_and_analysis
,loses_incremental_state
- Configuración predeterminada de
--cc_output_directory_tag=<a string>
: "" -
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas:affects_outputs
,explicit_in_output_path
--compiler=<a string>
predeterminado: ver la descripción-
Es el compilador de C++ que se usará para compilar el destino.
Etiquetas:loading_and_analysis
,execution
- Configuración predeterminada de
--coverage_output_generator=<a build target label>
: "@bazel_tools//tools/test:lcov_merger" - Ubicación del objeto binario que se usa para procesar con posterioridad los informes de cobertura sin procesar. Actualmente, debe ser un grupo de archivos que contiene un solo archivo binario. La configuración predeterminada es “//tools/test:lcov_merger”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
- Configuración predeterminada de
--coverage_report_generator=<a build target label>
: "@bazel_tools//tools/test:coverage_report_generator" - Ubicación del objeto binario que se usa para generar informes de cobertura. Actualmente, debe ser un grupo de archivos que contiene un solo archivo binario. La configuración predeterminada es “//tools/test:coverage_report_generator”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
- Configuración predeterminada 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 de código. La configuración predeterminada es “//tools/test:coverage_support”.
Etiquetas:changes_inputs
,affects_outputs
,loading_and_analysis
- Configuración predeterminada de
--crosstool_top=<a build target label>
: "@bazel_tools//tools/cpp:toolchain" -
Es la etiqueta del paquete crosstool que se usará para compilar código C++.
Etiquetas:loading_and_analysis
,changes_inputs
,affects_outputs
--custom_malloc=<a build target label>
predeterminado: ver la 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 objetivos de valores con restricción separados por comas. Si un objetivo no coincide con ninguna expresión negativa y al menos una expresión positiva, la resolución de 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
- Valor predeterminado de
--[no]experimental_enable_objc_cc_deps
: “verdadero” -
Permite que las reglas objc_* dependan de cc_library, y cualquier dependencia de objc se compile con --cpu configurada en "ios_<--ios_cpu>" para cualquier valor en --ios_multi_cpu.
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado
--[no]experimental_include_xcode_execution_requirements
: “falso” -
Si está configurado, agrega un requisito de ejecución de “required-xcode:{version}” a cada acción de Xcode. Si la versión Xcode tiene una etiqueta con guion, también agrega un requisito de ejecución “required-xcode-label:{version_label}”.
Etiquetas:loses_incremental_state
,loading_and_analysis
,execution
- Valor predeterminado de
--[no]experimental_prefer_mutual_xcode
: “verdadero” -
Si es verdadero, usa la versión más reciente de Xcode que está disponible de forma local y remota. Si es falso o si no hay versiones mutuamente disponibles, usa la versión local de Xcode seleccionada mediante xcode-select.
Etiquetas:loses_incremental_state
- Configuración predeterminada de
--extra_execution_platforms=<comma-separated list of options>
: "" -
Son las plataformas disponibles como plataformas de ejecución para ejecutar acciones. Las plataformas se pueden especificar por objetivo exacto o como patrón de destino. Consideremos estas plataformas antes de las que se declare en el archivo WORKSPACE a través de registration_execution_platforms(). Esta opción solo se puede configurar una vez; las instancias posteriores anularán la configuración de marcas anterior.
Etiquetas:execution
- Se acumulan
--extra_toolchains=<comma-separated list of options>
usos múltiples -
Son las reglas que se deben considerar durante la resolución de la cadena de herramientas. Las cadenas de herramientas se pueden especificar por objetivo exacto o como patrón de destino. Las cadenas de herramientas se considerarán antes de las que se declaren en el archivo WORKSPACE a través deregister_toolchains().
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--grte_top=<a label>
predeterminado: ver la descripción-
Es una etiqueta para una biblioteca de libc registrada. La cadena de herramientas de Crosstool selecciona el valor predeterminado y casi nunca necesitas anularlo.
Etiquetas:action_command_lines
,affects_outputs
--host_compiler=<a string>
predeterminado: ver la descripción-
Es el compilador de C++ para usar en la compilación de hosts. Se ignora si no se configura --host_crosstool_top.
Etiquetas:loading_and_analysis
,execution
--host_crosstool_top=<a build target label>
predeterminado: ver la descripción-
De forma predeterminada, las opciones --crosstool_top y --compiler también se usan para la configuración de ejecución. Si se proporciona esta marca, Bazel usa el compilador y libc predeterminado para la crosstool_top determinada.
Etiquetas:loading_and_analysis
,changes_inputs
,affects_outputs
--host_grte_top=<a label>
predeterminado: ver la descripción-
Si se especifica, este parámetro de configuración anula el directorio de nivel superior de libc (--grte_top) para la configuración de ejecución.
Etiquetas:action_command_lines
,affects_outputs
- Configuración predeterminada de
--host_platform=<a build target label>
: “@local_config_platform//:host” -
Es la etiqueta de una regla de plataforma que describe el sistema host.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
- Valor predeterminado de
--[no]incompatible_disable_expand_if_all_available_in_flag_set
: “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
- Valor predeterminado de
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
: “verdadero” -
Si es verdadero, Bazel no habilitará las funciones de “host” y “no host” en la cadena de herramientas de c++ (consulta https://github.com/bazelbuild/bazel/issues/7407 para obtener más información).
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado
--[no]incompatible_enable_android_toolchain_resolution
: “falso” -
Usa la resolución de la cadena de herramientas con el fin de seleccionar el SDK de Android para las reglas de Android (Starlark y nativo)
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado
--[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
- Valor predeterminado de
--[no]incompatible_make_thinlto_command_lines_standalone
: “verdadero” -
Si es verdadero, Bazel no volverá a usar las líneas de comandos de acción de vínculo de C++ para indexar líneas de comandos 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
: “verdadero” -
Si es verdadero, las reglas integradas de ObjC obtendrán la información de vinculación de CcInfo en lugar de ObjcProvider. Consulta https://github.com/bazelbuild/bazel/issues/16939 para obtener más información y detalles sobre la migración.
Etiquetas:loading_and_analysis
,changes_inputs
,incompatible_change
- Valor predeterminado de
--[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain
: “verdadero” -
Si es verdadero, Bazel se quejará cuando se establezcan los atributos cc_toolchain.cpu y cc_toolchain.compiler (consulte las instrucciones de migración para https://github.com/bazelbuild/bazel/issues/7075).
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]incompatible_remove_legacy_whole_archive
: “verdadero” -
Si es verdadero, Bazel no vinculará las dependencias de la biblioteca como archivo completo de forma predeterminada (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener instrucciones de migración).
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]incompatible_require_ctx_in_configure_features
: “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 la cadena de herramientas lo admite. 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 la descripción-
Especifica la versión del SDK de iOS que se usará para compilar aplicaciones para iOS. Si no se especifica, se usará la versión predeterminada del SDK de iOS de "xcode_version".
Etiquetas:loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: ver la descripción-
Especifica la versión del SDK de macOS que se usará para compilar aplicaciones de ese sistema operativo. 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 la descripción-
Es la versión mínima del SO a la que se orienta tu compilación.
Etiquetas:loading_and_analysis
,affects_outputs
- Configuración predeterminada de
--platform_mappings=<a relative path>
: "" -
Es la ubicación de un archivo de asignación que describe qué plataforma usar si no se estableció ninguna o qué marcas configurar cuando ya existe una plataforma. Debe estar relacionado con la raíz del lugar de trabajo principal. La configuración predeterminada es “platform_mappings” (un archivo directamente debajo de la raíz del lugar de trabajo).
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
- Configuración predeterminada de
--platforms=<a build target label>
: "" -
Las etiquetas de las reglas de la plataforma que describen las plataformas de destino para el comando actual.
Etiquetas:affects_outputs
,changes_inputs
,loading_and_analysis
--python2_path=<a string>
predeterminado: ver la descripción-
Obsoleto, no-op. Inhabilitado por "--incompatible_use_python_toolchains".
Etiquetas:no_op
,deprecated
--python3_path=<a string>
predeterminado: ver la descripción-
Obsoleto, no-op. Inhabilitado por "--incompatible_use_python_toolchains".
Etiquetas:no_op
,deprecated
--python_path=<a string>
predeterminado: ver la descripción-
Es la ruta de acceso absoluta del intérprete de Python que se invoca 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 la descripción-
Es la etiqueta de un py_runtime que representa al intérprete de Python invocado para ejecutar los objetivos de Python en la plataforma de destino. Obsoleto; inhabilitado por --incompatible_use_python_toolchains.
Etiquetas:loading_and_analysis
,affects_outputs
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: ver la descripción-
Especifica la versión del SDK de tvOS que se usará para compilar aplicaciones 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 la descripción-
Especifica la versión del SDK de watchOS para compilar aplicaciones de watchOS. Si no se especifica, se usará la versión predeterminada del SDK de watchOS desde "xcode_version".
Etiquetas:loses_incremental_state
--xcode_version=<a string>
predeterminado: ver la descripción-
Si se especifica, usa Xcode de la versión determinada para acciones de compilación relevantes. Si no se especifica, se usa la versión predeterminada del ejecutor de Xcode.
Etiquetas:loses_incremental_state
- Configuración predeterminada 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
--[no]apple_enable_auto_dsym_dbg
: “falso” -
Determina si deseas forzar la generación de archivos de símbolos de depuración (.dSYM) para las compilaciones de base de datos.
Etiquetas:affects_outputs
,action_command_lines
- Valor predeterminado
--[no]apple_generate_dsym
: “falso” -
Indica si se deben generar archivos de símbolos de depuración (.dSYM).
Etiquetas:affects_outputs
,action_command_lines
- Valor predeterminado de
--[no]build_runfile_links
: “verdadero” -
Si es verdadero, compile bosques de symlink de archivos de ejecución para todos los destinos. Si es falso, escribe solo manifiestos cuando sea posible.
Etiquetas:affects_outputs
- Valor predeterminado de
--[no]build_runfile_manifests
: “verdadero” -
Si es verdadero, escribe los manifiestos de archivos run para todos los destinos. Si es falso, omítela. No se ejecutarán las pruebas locales cuando sean falsas.
Etiquetas:affects_outputs
- Valor predeterminado
--[no]build_test_dwp
: “falso” -
Si se habilita, cuando se compilen pruebas de C++ de forma estática y con fisiones, también se compilará automáticamente el archivo .dwp para el objeto binario de prueba.
Etiquetas:loading_and_analysis
,affects_outputs
- Configuración predeterminada de
--cc_proto_library_header_suffixes=<comma-separated set of options>
: “.pb.h” -
Establece los prefijos de los archivos de encabezado que crea una cc_proto_library.
Etiquetas:affects_outputs
,loading_and_analysis
- Configuración predeterminada de
--cc_proto_library_source_suffixes=<comma-separated set 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
--[no]experimental_proto_descriptor_sets_include_source_info
: “falso” - Ejecuta acciones adicionales para versiones alternativas de la API de Java en una biblioteca proto_.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
- Valor predeterminado
--[no]experimental_proto_extra_actions
: “falso” - Ejecuta acciones adicionales para versiones alternativas de la API de Java en una biblioteca proto_.
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
- Valor predeterminado
--[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
--fission=<a set of compilation modes>
: "no" -
Especifica los modos de compilación que usan fisión para las compilaciones y vínculos de C++. Puede ser cualquier combinación de {'fastbuild', 'dbg', 'opt'} o los valores especiales 'yes' para habilitar todos los modos y 'no' para inhabilitar todos los modos.
Etiquetas:loading_and_analysis
,action_command_lines
,affects_outputs
- Valor predeterminado de
--[no]incompatible_always_include_files_in_data
: “verdadero” -
Si es verdadero, las reglas nativas agregan <code>DefaultInfo.files</code> de dependencias de datos a sus runfiles, lo que coincide con el comportamiento recomendado para las reglas de Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid).
Etiquetas:affects_outputs
,incompatible_change
- Valor predeterminado de
--[no]legacy_external_runfiles
: “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
--[no]objc_generate_linkmap
: “falso” -
Especifica si se debe generar un archivo de mapa de vínculo.
Etiquetas:affects_outputs
- Valor predeterminado
--[no]save_temps
: “falso” -
Si se establece, se guardarán los resultados temporales de gcc. Esto incluye archivos .s (código ensamblador), archivos .i (C procesados previamente) y archivos .ii (C++ procesados previamente).
Etiquetas:affects_outputs
- Opciones que permiten al usuario configurar el resultado deseado, lo que afecta su valor, en lugar de su existencia:
- Se acumulan
--action_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica el conjunto de variables de entorno disponibles para las acciones con la configuración de destino. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación o por el par nombre=valor que establece el valor independientemente del entorno de invocación. Esta opción se puede usar varias veces. Para las opciones proporcionadas para la misma variable, se acumulan las últimas victorias y las opciones de variables diferentes.
Etiquetas:action_command_lines
- Configuración predeterminada de
--android_cpu=<a string>
: “armeabi-v7a” -
La CPU de destino de Android.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Valor predeterminado
--[no]android_databinding_use_androidx
: “falso” -
Genera archivos de vinculación de datos compatibles con AndroidX. Esto solo se usa con la vinculación de datos v2.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Valor predeterminado
--[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
- Configuración predeterminada de
--android_dynamic_mode=<off, default or fully>
: "desactivado" -
Determina si las dependencias de C++ de las reglas de Android se vincularán de forma dinámica cuando un cc_binary no cree una biblioteca compartida de manera explícita. “default” significa que Bazel elegirá si se vinculará de forma dinámica. "completamente" significa que todas las bibliotecas se vincularán de manera dinámica. "off" significa que todas las bibliotecas se vincularán en su mayoría en modo estático.
Etiquetas:affects_outputs
,loading_and_analysis
- 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. ALPHABETICAL significa que los manifiestos se ordenan por ruta de acceso en relación con la ejecución de Execroot. ALPHABETICAL_BY_CONFIGURATION significa que los manifiestos se ordenan por rutas de acceso relativas al directorio de configuración dentro del directorio de salida. DEPENDENCY significa que los manifiestos se ordenan de acuerdo con el manifiesto de cada biblioteca que aparece antes de los manifiestos de sus dependencias.
Etiquetas:action_command_lines
,execution
- Valor predeterminado
--[no]android_resource_shrinking
: “falso” -
Habilita la reducción de recursos para los APK android_binary que usan ProGuard.
Etiquetas:affects_outputs
,loading_and_analysis
--[no]build_python_zip
predeterminado: “automático”-
Crear un archivo ZIP ejecutable de Python; activado en Windows, desactivado en otras plataformas
Etiquetas:affects_outputs
- Se acumulan
--catalyst_cpus=<comma-separated list of options>
usos múltiples -
Lista de arquitecturas separadas por comas para las que se pueden crear objetos binarios de Apple Catalyst.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Valor predeterminado
--[no]collect_code_coverage
: “falso” -
Si se especifica, Bazel instrumentará el código (mediante la instrumentación sin conexión cuando sea posible) y recopilará información de cobertura durante las pruebas. Solo se verán afectados los objetivos que coincidan con --instrumentation_filter. Por lo general, esta opción no se debe especificar directamente. En su lugar, se debe usar el comando "bazel cobertura".
Etiquetas:affects_outputs
- Configuración predeterminada de
--compilation_mode=<fastbuild, dbg or opt>
[-c
]: "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 fuente de 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
- Configuración predeterminada de
--cpu=<a string>
: "" -
La CPU de destino.
Etiquetas:changes_inputs
,affects_outputs
,explicit_in_output_path
--cs_fdo_absolute_path=<a string>
predeterminado: ver la descripción- Usa la información de perfil de CSFDO para optimizar la compilación. Especifica el nombre absoluto de ruta de acceso 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 la descripción-
Genera objetos binarios con instrumentación de FDO sensible al contexto. Con el compilador Clang/LLVM, también acepta el nombre del directorio bajo el cual se vuelcan los archivos de perfil sin procesar en el tiempo de ejecución.
Etiquetas:affects_outputs
--cs_fdo_profile=<a build target label>
predeterminado: ver la descripción-
Es el cs_fdo_profile que representa el perfil sensible al contexto que se usará para la optimización.
Etiquetas:affects_outputs
- Se acumulan
--cxxopt=<a string>
usos múltiples -
Opción adicional de pasar a GCC cuando se compilan archivos fuente C++.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--define=<a 'name=value' assignment>
usos múltiples -
Cada opción de definición define una asignación para una variable de compilación.
Etiquetas:changes_inputs
,affects_outputs
--dynamic_mode=<off, default or fully>
predeterminado: “default”-
Determina si los objetos binarios de C++ se vincularán de manera dinámica. “default” significa que Bazel elegirá si se vinculará de forma dinámica. "completamente" significa que todas las bibliotecas se vincularán de manera dinámica. "off" significa que todas las bibliotecas se vincularán en su mayoría en modo estático.
Etiquetas:loading_and_analysis
,affects_outputs
- Valor predeterminado de
--[no]enable_fdo_profile_absolute_path
: “verdadero” -
Si se establece, el uso de fdo_Absolute_profile_path generará un error.
Etiquetas:affects_outputs
--[no]enable_runfiles
predeterminado: “automático”-
Habilita el árbol de 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 -
Dejó de estar disponible y se reemplazó por otro. Usa action_listener para adjuntar una extra_action a las acciones de compilación existentes.
Etiquetas:execution
,experimental
- Valor predeterminado
--[no]experimental_android_compress_java_resources
: “falso” -
Comprime los recursos Java en APK
Etiquetas:affects_outputs
,loading_and_analysis
,experimental
- Valor predeterminado
--[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
--[no]experimental_android_resource_shrinking
: “falso” -
Habilita la reducción de recursos para los APK android_binary que usan ProGuard.
Etiquetas:affects_outputs
,loading_and_analysis
- Valor predeterminado
--[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
- Valor predeterminado de
--experimental_objc_fastbuild_options=<comma-separated list of options>
: "-O0,-DDEBUG=1" -
Usa estas strings como opciones del compilador objc fastbuild.
Etiquetas:action_command_lines
- Valor predeterminado
--[no]experimental_omitfp
: “falso” -
Si es verdadero, usa libunwind para desenrollar la pila y compila con -fomit-frame-pointer y -faasync-unwind-tables.
Etiquetas:action_command_lines
,affects_outputs
,experimental
- Valor predeterminado
--[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 la CPU.
Etiquetas:affects_outputs
,experimental
- Valor predeterminado
--[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
- Configuración predeterminada de
--fat_apk_cpu=<comma-separated set of options>
: “armeabi-v7a” -
Esta opción habilita 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 las reglas android_binary.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Valor predeterminado
--[no]fat_apk_hwasan
: “falso” -
Indica si se deben crear divisiones de HWASAN.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
--fdo_instrument=<a string>
predeterminado: ver la descripción-
Genera objetos binarios con instrumentación de FDO. Con el compilador Clang/LLVM, también acepta el nombre del directorio bajo el cual se vuelcan los archivos de perfil sin procesar en el tiempo de ejecución.
Etiquetas:affects_outputs
--fdo_optimize=<a string>
predeterminado: ver la 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 la descripción-
Usa sugerencias de carga previa de la caché.
Etiquetas:affects_outputs
--fdo_profile=<a build target label>
predeterminado: ver la 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 determinadas se habilitarán o inhabilitarán de forma predeterminada para los destinos compilados en la configuración de destino. Si especificas -<feature>, se inhabilitará la función. Los atributos negativos siempre anulan los positivos. Consulta también --host_features
Etiquetas:changes_inputs
,affects_outputs
- Valor predeterminado
--[no]force_pic
: “falso” -
Si se habilita, todas las compilaciones de C++ producen código independiente de posición ("-fPIC"), los vínculos prefieren bibliotecas compiladas previamente de PIC en lugar de bibliotecas que no son de PIC, y los vínculos producen ejecutables independientes de la posición ("-pie").
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan
--host_action_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica el conjunto de variables de entorno disponibles para las acciones con configuraciones de ejecución. Las variables se pueden especificar por nombre, en cuyo caso el valor se tomará del entorno de invocación o por el par nombre=valor que establece el valor independientemente del entorno de invocación. Esta opción se puede usar varias veces. Para las opciones proporcionadas para la misma variable, se acumulan las últimas victorias y las opciones de variables diferentes.
Etiquetas:action_command_lines
- Configuración predeterminada de
--host_compilation_mode=<fastbuild, dbg or opt>
: "opt" -
Especifica el modo en que se integrará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 de C cuando se compilan archivos de origen C (pero no de C++) en las configuraciones de ejecución.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--host_copt=<a string>
usos múltiples -
Opciones adicionales que se deben pasar al compilador C para las herramientas compiladas en las configuraciones de ejecución.
Etiquetas:action_command_lines
,affects_outputs
- Configuración predeterminada de
--host_cpu=<a string>
: "" -
Es la CPU del host.
Etiquetas:changes_inputs
,affects_outputs
- Se acumulan
--host_cxxopt=<a string>
usos múltiples -
Opciones adicionales que puedes pasar al compilador de C++ para herramientas compiladas en las configuraciones exec.
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--host_features=<a string>
usos múltiples -
Las funciones determinadas estarán habilitadas o inhabilitadas de forma predeterminada para los destinos compilados en la configuración de ejecución. Si especificas -<feature>, se inhabilitará la función. Los atributos negativos siempre anulan los positivos.
Etiquetas:changes_inputs
,affects_outputs
--host_force_python=<PY2 or PY3>
predeterminado: ver la descripción-
Anula la versión de Python para la configuración de ejecución. Puede ser "PY2" o "PY3".
Etiquetas:loading_and_analysis
,affects_outputs
- Se acumulan
--host_linkopt=<a string>
usos múltiples -
Opción adicional de pasar al vinculador cuando se vinculan herramientas en las configuraciones de ejecución.
Etiquetas:action_command_lines
,affects_outputs
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: ver la descripción-
Versión mínima compatible de macOS para los destinos de host. Si no se especifica, se usa “macos_sdk_version”.
Etiquetas:loses_incremental_state
- Se acumulan
--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 compilas ciertos archivos en las configuraciones de ejecución. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter representa una lista de patrones de expresión de inclusión y exclusión (también consulta --instrumentation_filter). Opción_1 a opción_n representa opciones de línea de comandos arbitrarias. Si una opción contiene una coma, se debe colocar una barra inversa. Las opciones pueden contener @. Solo se usa el primer @ 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 que puedes usar en swiftc para herramientas de ejecución.
Etiquetas:action_command_lines
,affects_outputs
- Valor predeterminado
--[no]incompatible_auto_exec_groups
: “falso” -
Cuando se habilita, se crea un grupo de ejecución automática para cada cadena de herramientas que usa una regla. Para que esto funcione, la regla debe especificar el parámetro “cadena” en sus acciones. Para obtener más información, consulta https://github.com/bazelbuild/bazel/issues/17134.
Etiquetas:affects_outputs
,incompatible_change
- Valor predeterminado de
--[no]incompatible_avoid_conflict_dlls
: “verdadero” -
Si está habilitada, todas las bibliotecas dinámicas vinculadas a C++ (DLL) generadas por cc_library en Windows se renombrarán como name_{hash}.dll, en donde el hash se calcula en función del RepositoryName y la ruta del paquete de 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
- Valor predeterminado de
--[no]incompatible_merge_genfiles_directory
: “verdadero” -
Si es verdadero, el directorio genfiles se pliega en el directorio bin.
Etiquetas:affects_outputs
,incompatible_change
- Valor predeterminado
--[no]incompatible_use_host_features
: “falso” -
Si es verdadero, usa --features solo para la configuración de destino y --host_features para la configuración de ejecución.
Etiquetas:changes_inputs
,affects_outputs
,incompatible_change
- Valor predeterminado
--[no]instrument_test_targets
: “falso” - Cuando se habilita la cobertura, especifica si se deben considerar las reglas de prueba de instrumentación. Cuando se establece, se instrumentan las reglas de prueba incluidas por --instrumentation_filter. De lo contrario, las reglas de prueba siempre se excluyen de la instrumentación de cobertura.
Etiquetas:affects_outputs
- Configuración predeterminada de
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "-/javatests[/:],-/test/java[/:]" -
Cuando está habilitada la cobertura, solo se instrumentarán reglas con nombres incluidos en el filtro basado en regex especificado. En su lugar, se excluyen las reglas con el prefijo '-'. Ten en cuenta que solo se instrumentan reglas que no son de prueba, a menos que se habilite --instrument_test_targets.
Etiquetas:affects_outputs
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
predeterminado: ver la 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 ios_application. El resultado es un objeto binario universal que contiene todas las arquitecturas especificadas.
Etiquetas:loses_incremental_state
,loading_and_analysis
- Valor predeterminado de
--[no]legacy_whole_archive
: “verdadero” -
Obsoleto y reemplazado por --incompatible_remove_legacy_whole_archive (consulta https://github.com/bazelbuild/bazel/issues/7362 para obtener más detalles). Cuando esté activado, use --whole-archive para las reglas cc_binary que tengan linkshared=True y linkstatic=True o --static en linkopt. 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 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 la descripción- Versión mínima compatible de macOS para los destinos. Si no se especifica, se usa “macos_sdk_version”.
Etiquetas:loses_incremental_state
- Valor predeterminado
--[no]objc_debug_with_GLIBCXX
: “falso” -
Si se establece y el modo de compilación se establece en "dbg", definirá GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC y GLIBCPP_CONCEPT_CHECKS.
Etiquetas:action_command_lines
- Valor predeterminado
--[no]objc_enable_binary_stripping
: “falso” -
Indica si se deben eliminar los símbolos y los códigos muertos en los objetos binarios vinculados. Se realizará la eliminación de objetos binarios si se especifican esta marca y --compilation_mode=opt.
Etiquetas:action_command_lines
- Se acumulan
--objccopt=<a string>
usos múltiples -
Opciones adicionales para pasar a gcc cuando se compilan archivos fuente 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 al compilar ciertos archivos. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter representa una lista de patrones de expresión de inclusión y exclusión (también consulta --instrumentation_filter). Opción_1 a opción_n representa opciones de línea de comandos arbitrarias. Si una opción contiene una coma, se debe colocar una barra inversa. Las opciones pueden contener @. Solo se usa el primer @ para dividir la string. Ejemplo: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 agrega la opción -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 a backend de LTO (en --features=thin_lto) cuando se compilan ciertos objetos de backend. Esta opción se puede pasar varias veces. Sintaxis: regex_filter@option_1,option_2,...,option_n. Donde regex_filter representa una lista de incluir y excluir patrones de expresión regular. option_1 a option_n significan opciones de línea de comandos arbitrarias. Si una opción contiene una coma, se debe colocar una barra inversa. Las opciones pueden contener @. Solo se usa el primer @ 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 la descripción-
Especifica un sufijo que se agregará al directorio de configuración.
Etiquetas:loses_incremental_state
,affects_outputs
,loading_and_analysis
--propeller_optimize=<a build target label>
predeterminado: ver la descripción-
Usa la información del perfil de propulsor para optimizar el destino de compilación.Un perfil de propulsor debe tener al menos uno de dos archivos, un perfil de Cc y un perfil de ld. Esta marca acepta una etiqueta de compilación que debe hacer referencia a los archivos de entrada del perfil de 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 debe usarse como: --propeller_optimize=//a/b:propeller_profile
Etiquetas:action_command_lines
,affects_outputs
--propeller_optimize_absolute_cc_profile=<a string>
predeterminado: ver la descripción-
Es el nombre de ruta absoluta del archivo cc_profile para las compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
predeterminado: ver la descripción-
Nombre de ruta de acceso absoluto del archivo ld_profile para las compilaciones optimizadas de Propeller.
Etiquetas:affects_outputs
--run_under=<a prefix in front of command>
predeterminado: ver la descripción-
Es el prefijo que se insertará antes de los ejecutables para los comandos "test" y "run". Si el valor es "foo -bar" y la línea de comandos de ejecución es "test_binary -baz", la línea de comandos final es "foo -bar test_binary -baz".También puede ser una etiqueta para un destino ejecutable. Estos son algunos ejemplos: "valgrind", "strace", "strace -c", "valgrind --quiet --num-callers=20", "//package:target", "//package:target --options".
Etiquetas:action_command_lines
-
Si es verdadero, las bibliotecas nativas con funciones idénticas se compartirán entre diferentes destinos.
Etiquetas:loading_and_analysis
,affects_outputs
- Valor predeterminado
--[no]stamp
: “falso” -
Marca los objetos binarios con la fecha, el nombre de usuario, el nombre de host, la información del lugar de trabajo, etcétera.
Etiquetas:affects_outputs
- Predeterminado de
--strip=<always, sometimes or never>
: "A veces" -
Especifica si se deben quitar los objetos binarios y las bibliotecas compartidas (con "-Wl,--strip-debug"). El valor predeterminado de “a veces” significa quitar iff - --compilation_mode=fastbuild.
Etiquetas:affects_outputs
- Se acumulan
--stripopt=<a string>
usos múltiples -
Opciones adicionales para pasar a la eliminación cuando se genera un objeto binario "<name>.stripped".
Etiquetas:action_command_lines
,affects_outputs
- Se acumulan
--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 deben 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 la descripción-
Versión de tvOS mínima compatible para 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 las que se pueden 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 la descripción-
Versión mínima compatible de watchOS para los simuladores y dispositivos de destino Si no se especifica, se usa “watchos_sdk_version”.
Etiquetas:loses_incremental_state
--xbinary_fdo=<a build target label>
predeterminado: ver la descripción-
Usa la información de perfil XbinaryFDO para optimizar la compilación. Especifica el nombre del perfil binario cruzado predeterminado. Cuando se use la opción junto con --fdo_instrument/--fdo_optimize/--fdo_profile, estas siempre prevalecerán como si xbinary_fdo nunca se especifique.
Etiquetas:affects_outputs
- Opciones que afectan cómo se aplica estrictamente Bazel a las entradas de compilación válidas (definiciones de reglas, combinaciones de marcas, etc.):
- Configuración predeterminada de
--auto_cpu_environment_group=<a build target label>
: "" - Declara el entorno de grupo para usarlo en la asignación automática de valores de CPU a los valores de target_environment.
Etiquetas:changes_inputs
,loading_and_analysis
,experimental
- Valor predeterminado
--[no]check_licenses
: “falso” -
Verifica que las restricciones de licencias impuestas por los paquetes dependientes no entren en conflicto con los modos de distribución de los destinos que se compilan. De forma predeterminada, no se verifican las licencias.
Etiquetas:build_file_semantics
- Valor predeterminado de
--[no]check_visibility
: “verdadero” -
Si está inhabilitada, los errores de visibilidad en las dependencias de destino descienden a advertencias.
Etiquetas:build_file_semantics
- Valor predeterminado de
--[no]desugar_for_android
: “verdadero” -
Determina si es necesario desugar Java 8 de código de bytes antes de la conversión a DEX.
Etiquetas:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Valor predeterminado
--[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
- Valor predeterminado de
--[no]enforce_constraints
: “verdadero” -
Verifica los entornos con los que es compatible 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
--[no]experimental_allow_android_library_deps_without_srcs
: “falso” -
Marca para facilitar la transición de permitir la inhabilitación de reglas de android_library de srcs-less con dependencias. El depósito se debe limpiar para lanzarlo de forma predeterminada.
Etiquetas:eagerness_to_exit
,loading_and_analysis
- Valor predeterminado de
--[no]experimental_check_desugar_deps
: “verdadero” -
Indica si debes verificar correctamente la expansión de sintaxis correcta a nivel del objeto binario de Android.
Etiquetas:eagerness_to_exit
,loading_and_analysis
,experimental
- Configuración predeterminada de
--experimental_import_deps_checking=<off, warning or error>
: "DESACTIVADA" -
Cuando esté habilitado, verifique si se completaron las dependencias de aar_import. Esta aplicación puede dañar la compilación o solo generar advertencias.
Etiquetas:loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
predeterminado: “default”-
Si es verdadero, comprueba que un destino Java declare de manera explícita todos los destinos utilizados directamente como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
- Valor predeterminado
--[no]incompatible_check_testonly_for_output_files
: “falso” -
Si la opción está habilitada, busque solo la prueba de la regla de generación para los objetivos de los requisitos previos que son archivos de salida. Esto coincide con la verificación de visibilidad.
Etiquetas:build_file_semantics
,incompatible_change
- Valor predeterminado
--[no]incompatible_check_visibility_for_toolchains
: “falso” -
Si se habilita, la verificación de visibilidad también se aplica a las implementaciones de la cadena de herramientas.
Etiquetas:build_file_semantics
,incompatible_change
- Valor predeterminado
--[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 desde https://github.com/bazelbuild/rules_android
Etiquetas:eagerness_to_exit
,incompatible_change
- Valor predeterminado
--[no]incompatible_disable_native_apple_binary_rule
: “falso” -
No-op. Se mantiene aquí para ofrecer retrocompatibilidad.
Etiquetas:eagerness_to_exit
,incompatible_change
- Valor predeterminado de
--[no]incompatible_force_strict_header_check_from_starlark
: “verdadero” -
Si está habilitada, establezca una verificación de encabezado estricta en la API de Starlark
Etiquetas:loading_and_analysis
,changes_inputs
,incompatible_change
- Valor predeterminado de
--[no]incompatible_python_disable_py2
: “verdadero” -
Si es verdadero, usar la configuración de Python 2 generará un error. Esto incluye python_version=PY2, srcs_version=PY2 y srcs_version=PY2ONLY. Consulta https://github.com/bazelbuild/bazel/issues/15684 para obtener más información.
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado de
--[no]incompatible_validate_top_level_header_inclusions
: “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
--python_native_rules_allowlist=<a build target label>
predeterminado: ver la descripción-
Una lista de entidades permitidas (destino de package_group) que se usará al aplicar --incompatible_python_allowed_native_rules.
Etiquetas:loading_and_analysis
- Valor predeterminado
--[no]strict_filesets
: “falso” -
Si esta opción está habilitada, los conjuntos de archivos que cruzan los límites del paquete se informan como errores. No funciona cuando se inhabilita check_fileset_Dependencies_recursively.
Etiquetas:build_file_semantics
,eagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default>
predeterminado: “error”-
A menos que esté DESACTIVADA, verifica que un destino de proto_library declare de manera explícita todos los destinos usados directamente como dependencias.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
- Configuración predeterminada de
--strict_public_imports=<off, warn, error, strict or default>
: "desactivado" -
A menos que esté DESACTIVADA, verifica que un destino de proto_library declare de manera explícita todos los destinos usados en "import public" como exportado.
Etiquetas:build_file_semantics
,eagerness_to_exit
,incompatible_change
- Valor predeterminado
--[no]strict_system_includes
: “falso” -
Si es verdadero, también se deben declarar los encabezados que se encuentran a través del sistema que incluyen rutas (-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:
- Predeterminado de
--apk_signing_method=<v1, v2, v1_v2 or v4>
: “v1_v2”. -
Implementación para usar la firma de APK
Etiquetas:action_command_lines
,affects_outputs
,loading_and_analysis
- Valor predeterminado de
--[no]device_debug_entitlements
: “verdadero” -
Si se configura y el modo de compilación no es "opt", las apps de objc incluirán derechos de depuración al momento de firmar.
Etiquetas:changes_inputs
--ios_signing_cert_name=<a string>
predeterminado: ver la descripción-
Es el nombre del certificado que se usará para la firma de iOS. Si no la estableces, se recurrirá al perfil de aprovisionamiento. Puede ser la preferencia de identidad del llavero del certificado o (substring) del nombre común del certificado, según la página de manual del código (Firma IDENTITIES).
Etiquetas:action_command_lines
- Esta opción afecta la semántica del lenguaje de Starlark o la API de compilación accesible para los archivos BUILD, los archivos .bzl o los archivos WORKSPACE:
- Valor predeterminado de
--[no]incompatible_disallow_legacy_py_provider
: “verdadero” -
No-op, pronto se quitará.
Etiquetas:loading_and_analysis
,incompatible_change
- Valor predeterminado
--[no]incompatible_disallow_sdk_frameworks_attributes
: “falso” -
Si es verdadero, inhabilite los atributos sdk_frameworks y weak_sdk_frameworks en objc_library yobjc_import.
Etiquetas:build_file_semantics
,incompatible_change
- Valor predeterminado
--[no]incompatible_objc_alwayslink_by_default
: “falso” -
Si es verdadero, establezca el valor predeterminado para los atributos Alwayslink en objc_library y objc_import.
Etiquetas:build_file_semantics
,incompatible_change
- Valor predeterminado
--[no]incompatible_python_disallow_native_rules
: “falso” -
Cuando es verdadero, se produce un error cuando se usan las reglas py_* integradas. En su lugar, se deben usar las reglas rule_python. Consulta https://github.com/bazelbuild/bazel/issues/17773 para obtener más información e instrucciones de migración.
Etiquetas:loading_and_analysis
,incompatible_change
- Opciones que rigen el comportamiento del entorno o del ejecutor de pruebas:
- Valor predeterminado
--[no]allow_analysis_failures
: “falso” -
Si es verdadero, un error de análisis del destino de una regla da como resultado la propagación del destino de una instancia de AnalysisFailureInfo que contiene la descripción del error, en lugar de una falla de compilación.
Etiquetas:loading_and_analysis
,experimental
- Configuración predeterminada 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 for_analysis_testing. Si se supera ese límite, se producirá un error en la regla.
Etiquetas:loading_and_analysis
- Valor predeterminado
--[no]break_build_on_parallel_dex2oat_failure
: “falso” -
Si la verdadera falla de dex2oat hace que la compilación falle, en lugar de ejecutar dex2oat durante el tiempo de ejecución de prueba.
Etiquetas:loading_and_analysis
,experimental
- Valor predeterminado
--[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
--[no]ios_memleaks
: “falso” -
Habilita la verificación de fugas de memoria en destinos ios_test.
Etiquetas:action_command_lines
--ios_simulator_device=<a string>
predeterminado: ver la descripción-
Es el dispositivo que se 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 la descripción-
Es la versión de iOS que se ejecuta en el simulador cuando se ejecuta o realiza una prueba. 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 ejecuta cada prueba. Si alguno de esos intentos falla por cualquier motivo, se considerará que falló toda la prueba. Normalmente, el valor especificado es solo un número entero. Ejemplo: --runs_per_test=3 ejecutará todas las pruebas 3 veces. Sintaxis alternativa: regex_filter@runs_per_test. Donde, run_per_test significa un valor de número entero y regex_filter significa una lista de patrones de expresión de inclusión y exclusión (también consulta --instrumentation_filter). Ejemplo: --runs_per_test=//foo/.*,-//foo/bar/.*@3 ejecuta todas las pruebas en //foo/, excepto las de foo/bar tres veces. Esta opción se puede pasar varias veces. Tiene prioridad el argumento que se pasó más recientemente y que coincide. De lo contrario, la prueba solo se ejecutará una vez.
- Se acumulan
--test_env=<a 'name=value' assignment with an optional value part>
usos múltiples -
Especifica variables de entorno adicionales que se insertarán en el entorno del ejecutor de pruebas. Las variables se pueden especificar por nombre, en cuyo caso se leerá su valor del entorno del cliente de Bazel, o bien por el par nombre=valor. Esta opción se puede usar varias veces para especificar varias variables. Solo se usa con el comando “bazel test”.
Etiquetas:test_runner
- Valor predeterminado de
--test_timeout=<a single integer or comma-separated list of 4 integers>
: "-1" - Anula los valores predeterminados de tiempo de espera de la prueba para los tiempos de espera de la prueba (en segundos). Si se especifica un solo valor entero positivo, se anularán todas las categorías. Si se especifican 4 números enteros separados por comas, se anularán los tiempos de espera para el corto, el moderado, el largo y el eterno (en ese orden). En cualquier forma, el valor -1 le indica al blaze que use los tiempos de espera predeterminados para esa categoría.
--tvos_simulator_device=<a string>
predeterminado: ver la descripción-
Es el dispositivo que se simulará cuando se ejecuta 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 la descripción-
Es la versión de tvOS que se ejecutará en el simulador cuando se ejecute o realice pruebas.
Etiquetas:test_runner
--watchos_simulator_device=<a string>
predeterminado: ver la descripción-
Es el dispositivo que se 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 la descripción-
Es la versión de watchOS que se ejecutará en el simulador cuando se ejecute o realice pruebas.
Etiquetas:test_runner
- Valor predeterminado de
--[no]zip_undeclared_test_outputs
: “verdadero” -
Si es verdadero, los resultados de la prueba no declarados se archivarán en un archivo ZIP.
Etiquetas:test_runner
- Opciones relacionadas con el resultado de la consulta y la semántica:
--aspect_deps=<off, conservative or precise>
predeterminado: “conservador”-
Cómo resolver dependencias de aspectos cuando el formato de salida es uno de {xml,proto,record}. "off" significa que no se resuelven dependencias de aspecto, "conservative" (la configuración predeterminada) significa que se agregan todas las dependencias de aspecto declaradas, independientemente de si tienen la clase de regla de dependencias directas. "Precise" 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 solo destino y, por lo tanto, que sea más lento que los otros modos. Además, tenga en cuenta que ni el modo exacto es completamente preciso: la decisión de calcular un aspecto se decide en la fase de análisis, que no se ejecuta durante la "consulta de Bazel".
Etiquetas:build_file_semantics
- Valor predeterminado de
--[no]graph:factored
: “verdadero” -
Si es verdadero, el grafo se emitirá como “factorizado”, es decir, los nodos topológicamente equivalentes se combinarán y sus etiquetas se concatenarán. Esta opción solo se aplica a --output=gráfico.
Etiquetas:terminal_output
- Configuración predeterminada de
--graph:node_limit=<an integer>
: “512” -
Es la longitud máxima de la string de etiqueta para un nodo del gráfico en el resultado. Las etiquetas más largas se truncarán. -1 significa que no hay truncamientos. Esta opción solo se aplica a --output=gráfico.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]implicit_deps
: “verdadero” -
Si se habilita, 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 BigQuery, esta opción controla el filtrado de las cadenas de herramientas resueltas.
Etiquetas:build_file_semantics
- Valor predeterminado de
--[no]include_aspects
: “verdadero” -
query, cquery: si se deben incluir acciones generadas por aspectos en el resultado. query: no-op (se siguen siempre los aspectos).
Etiquetas:terminal_output
- Valor predeterminado de
--[no]incompatible_display_source_file_location
: “verdadero” -
Verdadero o 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
- Valor predeterminado de
--[no]incompatible_package_group_includes_double_slash
: “verdadero” -
Si se habilita, no se omitirá el “//” inicial al generar el atributo “packages” del paquete package_group.
Etiquetas:terminal_output
,incompatible_change
- Valor predeterminado
--[no]infer_universe_scope
: “falso” - Si no se establece y --universe_scope, se inferirá el 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 centradas en el universo (p.ej., “allrdeps”) no es lo que deseas, por lo que debes usar esta opción solo si sabes lo que estás haciendo. Consulta https://bazel.build/reference/query#sky-query para obtener detalles y ejemplos. Si se establece --universe_scope, se ignora el valor de esta opción. Nota: Esta opción solo se aplica a `query` (es decir, no "cquery").
Etiquetas:loading_and_analysis
- Valor predeterminado
--[no]line_terminator_null
: “falso” -
Indica si cada formato termina con \0 en lugar de de nueva línea.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]nodep_deps
: “verdadero” -
Si se habilita, las dependencias de los atributos “nodep” se incluirán en el gráfico de dependencias con el que opera la consulta. Un ejemplo común de un atributo "nodep" es "visibilidad". Ejecuta y analiza el resultado de “info build-language” para conocer todos los atributos de “nodep” en el lenguaje de compilación.
Etiquetas:build_file_semantics
- Valor predeterminado de
--output=<a string>
: “etiqueta” - El formato en el que se deben imprimir los resultados de la consulta. Los valores permitidos para cquery son: label, label_kind, textproto, transition, proto, jsonproto. Si seleccionas "transiciones", también debes especificar la opción --transitions=(lite|full).
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:default_values
: “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
--[no]proto:definition_stack
: “falso” -
Propaga el campo proto Definition_stack, que registra para cada instancia de la regla la pila de llamadas de Starlark en el momento en que se definió la clase de la regla.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:flatten_selects
: “verdadero” -
Si se habilita, se aplanan los atributos configurables creados por select(). Para los tipos acoplados, la representación plana es una lista que contiene cada valor del mapa seleccionado solo una vez. Los tipos de escalar se acoplan a un valor nulo.
Etiquetas:build_file_semantics
- Valor predeterminado
--[no]proto:include_attribute_source_aspects
: “falso” -
Propaga el campo proto source_aspect_name de cada atributo con el aspecto de origen del que proviene (string vacía si no lo tenía).
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:include_configurations
: “verdadero” - , si está habilitado, el resultado del proto incluirá información sobre las configuraciones. Cuando está inhabilitado,el formato de salida de proto de consulta se parece al formato de salida de consulta.
Etiquetas:affects_outputs
- Valor predeterminado
--[no]proto:include_synthetic_attribute_hash
: “falso” -
Indica si el atributo $internal_attr_hash se calcula y se propaga.
Etiquetas:terminal_output
- Valor predeterminado
--[no]proto:instantiation_stack
: “falso” -
Propaga la pila de llamadas de creación de instancias de cada regla. Ten en cuenta que esto requiere que la pila esté presente.
Etiquetas:terminal_output
- Valor predeterminado de
--[no]proto:locations
: “verdadero” -
Indica si se debe generar información de la 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 para incluir en l