bazel [<startup options>] <command> [<args>]ou
bazel [<startup options>] <command> [<args>] -- [<target patterns>]Consulte o Guia do usuário para conferir a sintaxe dos padrões de destino.
Sintaxe de opções
As opções podem ser transmitidas ao Bazel de maneiras diferentes. As opções que exigem um valor podem ser transmitidas com um sinal de igual ou um espaço:
--<option>=<value> --<option> <value>Algumas opções têm uma forma curta de um único caractere. Nesse caso, a forma curta precisa ser transmitida com um único traço e um espaço.
-<short_form> <value>
As opções booleanas podem ser ativadas da seguinte maneira:
--<option> --<option>=[true|yes|1]e desativadas da seguinte maneira:
--no<option> --<option>=[false|no|0]
As opções tristate geralmente são definidas como automáticas por padrão e podem ser ativadas forçosamente da seguinte maneira:
--<option>=[true|yes|1]ou desativadas forçosamente da seguinte maneira:
--no<option> --<option>=[false|no|0]
Comandos
analyze-profile |
Analisa dados de perfil de build. |
aquery |
Analisa as metas fornecidas e consulta o gráfico de ações. |
build |
Cria os destinos especificados. |
canonicalize-flags |
Canônica uma lista de opções do Bazel. |
clean |
Remove arquivos de saída e, opcionalmente, interrompe o servidor. |
coverage |
Gera um relatório de cobertura de código para destinos de teste especificados. |
cquery |
Carrega, analisa e consulta os destinos especificados com configurações. |
dump |
Faz o despejo do estado interno do processo do servidor do Bazel. |
fetch |
Busca repositórios externos que são pré-requisitos para os destinos. |
help |
Imprime a ajuda para comandos ou o índice. |
info |
Mostra informações de execução sobre o servidor do Bazel. |
license |
Imprime a licença do software. |
mobile-install |
Instala os destinos em dispositivos móveis. |
mod |
Consulta o gráfico de dependência externa do Bzlmod |
print_action |
Mostra os argumentos da linha de comando para compilar um arquivo. |
query |
Executa uma consulta de gráfico de dependência. |
run |
Executa o destino especificado. |
shutdown |
Interrompe o servidor do Bazel. |
sync |
Sincroniza todos os repositórios especificados no arquivo do espaço de trabalho |
test |
Cria e executa os destinos de teste especificados. |
vendor |
Busca repositórios externos em uma pasta especificada pela flag --vendor_dir. |
version |
Mostra informações de versão do Bazel. |
Opções de startup
- Opções que aparecem antes do comando e são analisadas pelo cliente:
--[no]autodetect_server_javabase
padrão: "true"-
Quando --noautodetect_server_javabase é transmitido, o Bazel não volta para o JDK local para executar o servidor do Bazel e sai.
Tags:affects_outputs
,loses_incremental_state
--[no]batch
padrão: "false"-
Se definido, o Bazel será executado como um processo de cliente sem um servidor, em vez do modo cliente/servidor padrão. Esse recurso foi descontinuado e será removido. Desligue o servidor explicitamente se quiser evitar que ele permaneça em execução.
Tags:loses_incremental_state
,bazel_internal_configuration
,deprecated
--[no]batch_cpu_scheduling
padrão: "false"-
Somente no Linux: use a programação de CPU "batch" para o Blaze. Essa política é útil para cargas de trabalho não interativas, mas que não querem diminuir o valor de "bom". Consulte "man 2 sched_setscheduler". Se for falso, o Bazel não vai realizar uma chamada de sistema.
Tags:host_machine_resource_optimizations
--bazelrc=<path>
padrão: consulte a descrição-
O local do arquivo .bazelrc do usuário que contém valores padrão das opções do Bazel. /dev/null indica que todos os outros `--bazelrc`s serão ignorados, o que é útil para desativar a pesquisa de um arquivo rc do usuário, por exemplo, em builds de lançamento.
Essa opção também pode ser especificada várias vezes.
Por exemplo, com `--bazelrc=x.rc --bazelrc=y.rc --bazelrc=/dev/null --bazelrc=z.rc`,
1) x.rc e y.rc são lidos.
2) z.rc é ignorado devido ao /dev/null anterior.
Se não for especificado, o Bazel vai usar o primeiro arquivo .bazelrc encontrado nos dois locais a seguir: o diretório do espaço de trabalho e o diretório principal do usuário.
Observação: as opções de linha de comando sempre substituem qualquer opção no bazelrc.
Tags:changes_inputs
--[no]block_for_lock
padrão: "true"-
Quando --noblock_for_lock é transmitido, o Bazel não aguarda a conclusão de um comando em execução, mas sai imediatamente.
Tags:eagerness_to_exit
--[no]client_debug
padrão: "false"-
Se verdadeiro, registra informações de depuração do cliente no stderr. Mudar essa opção não faz com que o servidor seja reiniciado.
Tags:affects_outputs
,bazel_monitoring
--connect_timeout_secs=<an integer>
padrão: "30"-
O tempo que o cliente aguarda para cada tentativa de conexão com o servidor
Tags:bazel_internal_configuration
--digest_function=<hash function>
padrão: consulte a descrição-
A função hash a ser usada ao calcular resumos de arquivos.
Tags:loses_incremental_state
,bazel_internal_configuration
--experimental_cgroup_parent=<path>
padrão: consulte a descrição-
O cgroup em que o servidor do Bazel será iniciado como um caminho absoluto. O processo do servidor será iniciado no cgroup especificado para cada controle compatível. Por exemplo, se o valor dessa flag for /build/bazel e os controladores de CPU e memória forem montados respectivamente em /sys/fs/cgroup/cpu e /sys/fs/cgroup/memory, o servidor será iniciado nos cgroups /sys/fs/cgroup/cpu/build/bazel e /sys/fs/cgroup/memory/build/bazel.Não é um erro se o cgroup especificado não for gravável para um ou mais controladores. Essa opção não tem efeito em plataformas que não oferecem suporte a cgroups.
Tags:bazel_monitoring
,execution
--failure_detail_out=<path>
padrão: consulte a descrição-
Se definido, especifica um local para gravar uma mensagem protobuf failure_detail se o servidor apresentar uma falha e não puder informar isso por gRPC, como de costume. Caso contrário, o local será ${OUTPUT_BASE}/failure_detail.rawproto.
Tags:affects_outputs
,loses_incremental_state
--[no]home_rc
padrão: "true"-
Se procurar ou não o arquivo home bazelrc em $HOME/.bazelrc
Tags:changes_inputs
--[no]idle_server_tasks
padrão: "true"-
Executar System.gc() quando o servidor estiver ocioso
Tags:loses_incremental_state
,host_machine_resource_optimizations
--[no]ignore_all_rc_files
padrão: "false"-
Desativa todos os arquivos rc, independentemente dos valores de outras flags modificadoras de rc, mesmo que essas flags apareçam mais tarde na lista de opções de inicialização.
Tags:changes_inputs
--io_nice_level={-1,0,1,2,3,4,5,6,7}
padrão: "-1"-
Somente no Linux: defina um nível de 0 a 7 para a programação de E/S de melhor esforço usando a chamada de sistema sys_ioprio_set. 0 é a prioridade mais alta, 7 é a mais baixa. O programador antecipado só pode atender até a prioridade 4. Se definido como um valor negativo, o Bazel não realiza uma chamada de sistema.
Tags:host_machine_resource_optimizations
--local_startup_timeout_secs=<an integer>
padrão: "120"-
O tempo máximo que o cliente espera para se conectar ao servidor
Tags:bazel_internal_configuration
--macos_qos_class=<a string>
padrão: "default"-
Define a classe de serviço de QoS do servidor Bazel quando executado no macOS. Essa flag não tem efeito em todas as outras plataformas, mas é compatível para garantir que os arquivos rc possam ser compartilhados entre elas sem alterações. Os valores possíveis são: interativo, iniciado pelo usuário, padrão, utilitário e em segundo plano.
Tags:host_machine_resource_optimizations
--max_idle_secs=<integer>
padrão: "10800"-
O número de segundos que o servidor de build vai aguardar em modo inativo antes de ser desligado. Zero significa que o servidor nunca será encerrado. Isso é lido apenas na inicialização do servidor. Mudar essa opção não faz com que o servidor seja reiniciado.
Tags:eagerness_to_exit
,loses_incremental_state
--output_base=<path>
padrão: consulte a descrição-
Se definido, especifica o local de saída em que toda a saída do build será gravada. Caso contrário, o local será ${OUTPUT_ROOT}/_blaze_${USER}/${MD5_OF_WORKSPACE_ROOT}. Observação: se você especificar uma opção diferente da invocação do Bazel para esse valor, provavelmente vai iniciar um novo servidor do Bazel. O Bazel inicia exatamente um servidor por base de saída especificada. Normalmente, há uma base de saída por espaço de trabalho. No entanto, com essa opção, você pode ter várias bases de saída por espaço de trabalho e, assim, executar vários builds para o mesmo cliente na mesma máquina simultaneamente. Consulte "bazel help shutdown" para saber como encerrar um servidor do Bazel.
Tags:affects_outputs
,loses_incremental_state
--output_user_root=<path>
padrão: consulte a descrição-
O diretório específico do usuário em que todas as saídas de build são gravadas. Por padrão, essa é uma função de $USER, mas, ao especificar uma constante, as saídas de build podem ser compartilhadas entre os usuários que colaboram.
Tags:affects_outputs
,loses_incremental_state
--[no]preemptible
padrão: "false"-
Se verdadeiro, o comando pode ser interrompido se outro comando for iniciado.
Tags:eagerness_to_exit
--[no]quiet
padrão: "false"-
Se verdadeiro, nenhuma mensagem informativa é emitida no console, apenas erros. Mudar essa opção não faz com que o servidor seja reiniciado.
Tags:affects_outputs
,bazel_monitoring
--server_jvm_out=<path>
padrão: consulte a descrição-
O local para gravar a saída da JVM do servidor. Se não for definido, o padrão será um local em output_base.
Tags:affects_outputs
,loses_incremental_state
--[no]shutdown_on_low_sys_mem
padrão: "false"-
Se max_idle_secs estiver definido e o servidor de build estiver ocioso por um tempo, desligue o servidor quando o sistema estiver com pouca RAM livre. Somente no Linux.
Tags:eagerness_to_exit
,loses_incremental_state
--[no]system_rc
padrão: "true"-
Define se o bazelrc do sistema será procurado ou não.
Tags:changes_inputs
--[no]unlimit_coredumps
padrão: "false"-
Aumenta o limite de coredump flexível para o limite rígido para tornar os coredumps do servidor (incluindo a JVM) e do cliente possíveis em condições comuns. Coloque essa flag no bazelrc uma vez e esqueça dela para receber coredumps quando encontrar uma condição que os aciona.
Tags:bazel_internal_configuration
--[no]windows_enable_symlinks
padrão: "false"-
Se verdadeiro, links simbólicos reais serão criados no Windows em vez de cópia de arquivos. Requer que o modo de desenvolvedor do Windows esteja ativado e que o Windows 10 seja a versão 1703 ou mais recente.
Tags:bazel_internal_configuration
--[no]workspace_rc
padrão: "true"-
Se procurar ou não o arquivo bazelrc do espaço de trabalho em $workspace/.bazelrc
Tags:changes_inputs
- Opções diversas, não categorizadas de outra forma.:
- Vários usos de
--host_jvm_args=<jvm_arg>
são acumulados - Flags para transmitir à JVM que executa o Blaze.
--host_jvm_debug
-
Opção de conveniência para adicionar outras flags de inicialização da JVM, que fazem com que a JVM aguarde durante a inicialização até que você se conecte de um depurador compatível com JDWP (como o Eclipse) à porta 5005.
É expandido para:
--host_jvm_args=-Xdebug
--host_jvm_args=-Xrunjdwp:transport=dt_socket,server=y,address=5005
--server_javabase=<jvm path>
padrão: ""- Caminho para a JVM usada para executar o Bazel.
Opções comuns a todos os comandos
- Opções que aparecem antes do comando e são analisadas pelo cliente:
- Vários usos de
--distdir=<a path>
são acumulados -
Outros lugares para pesquisar arquivos antes de acessar a rede para fazer o download deles.
Tags:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
padrão: "false"-
Se definido, o cache do repositório vai criar um link físico para o arquivo em caso de acerto do cache, em vez de copiar. Isso serve para economizar espaço em disco.
Tags:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
padrão: "5"-
O número máximo de tentativas de repetição de um erro de download. Se definido como 0, as novas tentativas são desativadas.
Tags:experimental
--experimental_scale_timeouts=<a double>
padrão: "1.0"-
Escala todos os tempos limite nas regras do repositório Starlark por esse fator. Dessa forma, os repositórios externos podem funcionar em máquinas mais lentas do que o autor da regra esperava, sem alterar o código-fonte.
Tags:bazel_internal_configuration
,experimental
--http_connector_attempts=<an integer>
padrão: "8"-
O número máximo de tentativas de downloads HTTP.
Tags:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
padrão: "0s"-
O tempo limite máximo para novas tentativas de download HTTP. Com um valor de 0, nenhum tempo limite máximo é definido.
Tags:bazel_internal_configuration
--http_max_parallel_downloads=<an integer>
padrão: "8"-
O número máximo de downloads HTTP paralelos.
Tags:bazel_internal_configuration
--http_timeout_scaling=<a double>
padrão: "1.0"-
Escala todos os tempos limite relacionados a downloads http pelo fator especificado
Tags:bazel_internal_configuration
--[no]incompatible_disable_native_repo_rules
padrão: "false"-
Se for falso, as regras de repositório nativo poderão ser usadas no WORKSPACE. Caso contrário, as regras de repositório do Starlark precisarão ser usadas. As regras de repositório nativo incluem local_repository, new_local_repository, local_config_platform e android_sdk_repository.
Tags:bazel_internal_configuration
--repository_cache=<a path>
padrão: consulte a descrição-
Especifica o local do cache dos valores transferidos por download obtidos durante a busca de repositórios externos. Uma string vazia como argumento solicita que o cache seja desativado. Caso contrário, o padrão "'<output_user_root>/cache/repos/v1" será usado.
Tags:bazel_internal_configuration
--[no]repository_disable_download
padrão: "false"-
Se definido, o download usando ctx.download{,_and_extract} não é permitido durante a busca do repositório. O acesso à rede não é desativado completamente. O ctx.execute ainda pode executar um executável arbitrário que acesse a Internet.
Tags
:bazel_internal_configuration
- Opções que controlam a execução do build:
--experimental_ui_max_stdouterr_bytes=<an integer in (-1)-1073741819 range>
padrão: "1048576"-
O tamanho máximo dos arquivos stdout / stderr que serão impressos no console. -1 significa que não há limite.
Tags:execution
--gc_thrashing_threshold=<an integer in 0-100 range>
padrão: "100"-
A porcentagem de espaço de tenured ocupado (0 a 100) acima da qual o GcThrashingDetector considera eventos de pressão de memória em relação aos limites (--gc_thrashing_limits). Se definido como 100, o GcThrashingDetector é desativado.
Tags
:host_machine_resource_optimizations
- Opções que configuram a cadeia de ferramentas usada para a execução de ações:
--[no]incompatible_enable_proto_toolchain_resolution
padrão: "false"-
Se verdadeiro, as regras de proto lang definem as cadeias de ferramentas do repositório protobuf.
Tags
:loading_and_analysis
,incompatible_change
- Opções que permitem ao usuário configurar a saída pretendida, afetando o valor, em vez da existência:
--bep_maximum_open_remote_upload_files=<an integer>
padrão: "-1"-
Número máximo de arquivos abertos permitidos durante o upload de artefatos do BEP.
Tags:affects_outputs
--remote_download_all
-
Faz o download de todas as saídas remotas para a máquina local. Essa flag é um alias de --remote_download_outputs=all.
É expandido para:
--remote_download_outputs=all
Tags:affects_outputs
--remote_download_minimal
-
Não faz o download de nenhuma saída de build remoto para a máquina local. Essa flag é um alias para --remote_download_outputs=minimal.
É expandido para:
--remote_download_outputs=minimal
Tags:affects_outputs
--remote_download_outputs=<all, minimal or toplevel>
padrão: "toplevel"-
Se definido como "minimal", não faz o download de nenhuma saída de build remoto para a máquina local, exceto as exigidas por ações locais. Se definido como "toplevel", ele se comporta como "minimal", exceto por fazer o download das saídas de destinos de nível superior para a máquina local. Ambas as opções podem reduzir significativamente os tempos de build se a largura de banda da rede for um gargalo.
Tags:affects_outputs
--remote_download_symlink_template=<a string>
padrão: ""-
Em vez de fazer o download de saídas de build remoto para a máquina local, crie links simbólicos. O destino dos links simbólicos pode ser especificado na forma de uma string de modelo. Essa string de modelo pode conter {hash} e {size_bytes}, que se expandem para o hash do objeto e o tamanho em bytes, respectivamente. Por exemplo, esses links simbólicos podem apontar para um sistema de arquivos FUSE que carrega objetos do CAS sob demanda.
Tags:affects_outputs
--remote_download_toplevel
-
Somente faz o download de saídas remotas de segmentações de nível superior para a máquina local. Essa flag é um alias de --remote_download_outputs=toplevel.
É expandido para:
--remote_download_outputs=toplevel
Tags:affects_outputs
- Vários usos de
--repo_env=<a 'name=value' assignment with an optional value part>
são acumulados -
Especifica variáveis de ambiente adicionais para serem disponibilizadas apenas para regras de repositório. As regras do repositório veem o ambiente completo de qualquer maneira, mas, dessa forma, as informações de configuração podem ser transmitidas aos repositórios por opções sem invalidar o gráfico de ações.
Tags:action_command_lines
- Opções que afetam a forma como o Bazel aplica estritamente as entradas de build válidas (definições de regras, combinações de sinalizações etc.):
--[no]check_bzl_visibility
padrão: "true"-
Se desativado, os erros de visibilidade de carregamento de .bzl são rebaixados para avisos.
Tags:build_file_semantics
- Essa opção afeta a semântica da linguagem Starlark ou a API de build acessível a arquivos BUILD, .bzl ou WORKSPACE.:
--[no]enable_bzlmod
padrão: "true"-
Se verdadeiro, ativa o sistema de gerenciamento de dependências do Bzlmod, tendo precedência sobre o WORKSPACE. Consulte https://bazel.build/docs/bzlmod para mais informações.
Tags:loading_and_analysis
--[no]enable_workspace
padrão: "false"-
Se verdadeiro, ativa o sistema WORKSPACE legado para dependências externas. Consulte https://bazel.build/external/overview para mais informações.
Tags:loading_and_analysis
--[no]experimental_action_resource_set
padrão: "true"-
Se definido como "true", ctx.actions.run() e ctx.actions.run_shell() aceitam um parâmetro resource_set para execução local. Caso contrário, o padrão será de 250 MB para memória e 1 CPU.
Tags:execution
,build_file_semantics
,experimental
--[no]experimental_bzl_visibility
padrão: "true"-
Se ativado, adiciona uma função "visibility()" que os arquivos .bzl podem chamar durante a avaliação de nível superior para definir a visibilidade para fins de instruções load().
Tags:loading_and_analysis
,experimental
-
Se definido como "true", os atributos de regra e os métodos da API Starlark necessários para a regra cc_shared_library vão estar disponíveis.
Tags:build_file_semantics
,loading_and_analysis
,experimental
--[no]experimental_cc_static_library
padrão: "false"-
Se definido como "true", os atributos de regra e os métodos da API Starlark necessários para a regra cc_static_library estarão disponíveis.
Tags:build_file_semantics
,loading_and_analysis
,experimental
--[no]experimental_disable_external_package
padrão: "false"-
Se definido como "true", o pacote //external gerado automaticamente não estará mais disponível. O Bazel ainda não poderá analisar o arquivo "external/BUILD", mas os globs que acessam external/ do pacote sem nome vão funcionar.
Tags:loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_dormant_deps
padrão: "false"-
Se definido como "true", os atributos attr.label(materializer=), attr(for_dependency_resolution=), attr.dormant_label(), attr.dormant_label_list() e rule(for_dependency_resolution=) são permitidos.
Tags:build_file_semantics
,experimental
--[no]experimental_enable_android_migration_apis
padrão: "false"-
Se definido como verdadeiro, ativa as APIs necessárias para oferecer suporte à migração do Android Starlark.
Tags:build_file_semantics
--[no]experimental_enable_first_class_macros
padrão: "true"-
Se definido como verdadeiro, ativa a construção "macro(") para definir macros simbólicas.
Tags:build_file_semantics
--[no]experimental_enable_scl_dialect
padrão: "true"-
Se definido como verdadeiro, os arquivos .scl poderão ser usados em instruções load().
Tags:build_file_semantics
--[no]experimental_enable_starlark_set
padrão: "false"-
Se verdadeiro, ativa o tipo de dados "set" e o construtor "set()" no Starlark.
Tags:build_file_semantics
,experimental
--[no]experimental_google_legacy_api
padrão: "false"-
Se definido como "true", expõe vários elementos experimentais da API de build do Starlark relacionados ao código legado do Google.
Tags:loading_and_analysis
,experimental
--[no]experimental_isolated_extension_usages
padrão: "false"-
Se verdadeiro, ativa o parâmetro <code>isolate</code> na função <a href="https://bazel.build/rules/lib/globals/module#use_extension"><code>use_extension</code></a>.
Tags:loading_and_analysis
--[no]experimental_java_library_export
padrão: "false"-
Se ativado, o módulo experimental_java_library_export_do_not_use estará disponível.
Tags:loading_and_analysis
,incompatible_change
--[no]experimental_platforms_api
padrão: "false"-
Se definido como "true", ativa várias APIs do Starlark relacionadas à plataforma que são úteis para depuração.
Tags:loading_and_analysis
,experimental
--[no]experimental_repo_remote_exec
padrão: "false"-
Se definido como "true", o repository_rule ganha alguns recursos de execução remota.
Tags:build_file_semantics
,loading_and_analysis
,experimental
--[no]experimental_sibling_repository_layout
padrão: "false"-
Se definido como verdadeiro, os repositórios não principais são plantados como links simbólicos para o repositório principal na raiz de execução. Ou seja, todos os repositórios são filhos diretos do diretório $output_base/execution_root. Isso tem o efeito colateral de liberar $output_base/execution_root/__main__/external para o diretório "external" de nível superior real.
Tags:action_command_lines
,bazel_internal_configuration
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_single_package_toolchain_binding
padrão: "false"-
Se ativada, a função register_toolchain pode não incluir padrões de destino que se refiram a mais de um pacote.
Tags:loading_and_analysis
,incompatible_change
-
Se definido como "true", as tags serão propagadas de um destino para os requisitos de execução das ações. Caso contrário, elas não serão propagadas. Consulte https://github.com/bazelbuild/bazel/issues/8830 para saber mais.
Tags:build_file_semantics
,experimental
--[no]incompatible_always_check_depset_elements
padrão: "true"-
Verifique a validade dos elementos adicionados aos depsets em todos os construtores. Os elementos precisam ser imutáveis, mas historicamente o construtor depset(direct=...) esqueceu de verificar. Use tuplas em vez de listas em elementos depset. Consulte https://github.com/bazelbuild/bazel/issues/10313 para mais detalhes.
Tags:build_file_semantics
,incompatible_change
--incompatible_autoload_externally=<comma-separated set of options>
padrão: "+@rules_python,+java_common,+JavaInfo,+JavaPluginInfo,ProguardSpecProvider,java_binary,java_import,java_library,java_plugin,java_test,java_runtime,java_toolchain,java_package_configuration,@com_google_protobuf,@rules_shell,+@rules_android"-
Uma lista de regras (ou outros símbolos) separada por vírgulas que antes fazia parte do Bazel e que agora precisa ser recuperada dos respectivos repositórios externos. Essa flag tem como objetivo facilitar a migração de regras do Bazel. Consulte também https://github.com/bazelbuild/bazel/issues/23043.
Um símbolo carregado automaticamente em um arquivo se comporta como se a definição integrada do Bazel fosse substituída pela nova definição canônica em um repositório externo. Para um arquivo BUILD, isso significa adicionar implicitamente uma instrução load(). Em um arquivo .bzl, é uma instrução load() ou uma mudança em um campo do objeto "native", dependendo se o símbolo carregado automaticamente é uma regra.
O Bazel mantém uma lista codificada de todos os símbolos que podem ser carregados automaticamente. Somente esses símbolos podem aparecer nessa flag. Para cada símbolo, o Bazel conhece o novo local de definição em um repositório externo, bem como um conjunto de repositórios especiais que não precisam ser carregados automaticamente para evitar a criação de ciclos.
Um item de lista de "+foo" nessa flag faz com que o símbolo foo seja carregado automaticamente, exceto nos repositórios isentos de foo, em que a versão definida pelo Bazel de foo ainda está disponível.
Um item de lista "foo" aciona o carregamento automático conforme mostrado acima, mas a versão de foo definida pelo Bazel não é disponibilizada para os repositórios excluídos. Isso garante que o repositório externo de foo não dependa da antiga implementação do Bazel de foo.
Um item de lista de "-foo" não aciona nenhum carregamento automático, mas torna a versão definida pelo Bazel de foo inacessível em todo o espaço de trabalho. Isso é usado para validar se o espaço de trabalho está pronto para que a definição de foo seja excluída do Bazel.
Se um símbolo não for nomeado nessa flag, ele continuará funcionando normalmente. Nenhum carregamento automático será feito nem a versão definida pelo Bazel será suprimida. Para saber como configurar, consulte https://github.com/bazelbuild/bazel/blob/master/src/main/java/com/google/devtools/build/lib/packages/AutoloadSymbols.java. Como atalho, também é possível usar o repositório inteiro. Por exemplo, +@rules_python vai carregar automaticamente todas as regras do Python.
Tags:loses_incremental_state
,build_file_semantics
,incompatible_change
--[no]incompatible_depset_for_libraries_to_link_getter
padrão: "true"-
Quando verdadeiro, o Bazel não retorna mais uma lista de linking_context.libraries_to_link, mas retorna um depset.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_disable_objc_library_transition
padrão: "true"-
Desativar a transição personalizada de objc_library e herdar do destino de nível superior (No-op no Bazel)
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_disable_starlark_host_transitions
padrão: "false"-
Se definido como verdadeiro, os atributos de regra não podem definir "cfg = "host"'. As regras precisam definir "cfg = "exec"'".
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_disable_target_default_provider_fields
padrão: "false"-
Se definido como "true", desativa a capacidade de acessar provedores em objetos "target" pela sintaxe de campo. Use a sintaxe de chave do provedor. Por exemplo, em vez de usar "ctx.attr.dep.my_info" para acessar "my_info" dentro de uma função de implementação de regra, use "ctx.attr.dep[MyInfo]". Consulte https://github.com/bazelbuild/bazel/issues/9014 para mais detalhes.
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_disable_target_provider_fields
padrão: "false"-
Se definido como "true", desativa a capacidade de usar o provedor padrão pela sintaxe de campo. Use a sintaxe de chave do provedor. Por exemplo, em vez de usar "ctx.attr.dep.files" para acessar "files", use "ctx.attr.dep[DefaultInfo].files". Consulte https://github.com/bazelbuild/bazel/issues/9014 para mais detalhes.
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_disallow_ctx_resolve_tools
padrão: "true"-
Se definido como verdadeiro, a chamada da API ctx.resolve_tools, que foi descontinuada, sempre falha. Os usos dessa API precisam ser substituídos por um argumento executável ou de ferramentas para ctx.actions.run ou ctx.actions.run_shell.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_empty_glob
padrão: "true"-
Se definido como verdadeiro, o valor padrão do argumento "allow_empty" de glob() será falso.
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_disallow_struct_provider_syntax
padrão: "true"-
Se definido como verdadeiro, as funções de implementação de regras podem não retornar uma struct. Em vez disso, eles precisam retornar uma lista de instâncias do provedor.
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_enable_deprecated_label_apis
padrão: "true"-
Se ativada, é possível usar algumas APIs descontinuadas (native.repository_name, Label.workspace_name, Label.relative).
Tags:loading_and_analysis
--[no]incompatible_fail_on_unknown_attributes
padrão: "true"-
Se ativado, os destinos com atributos desconhecidos definidos como "Nenhum" vão falhar.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_fix_package_group_reporoot_syntax
padrão: "true"-
No atributo "packages" de package_group, muda o significado do valor "//..." para se referir a todos os pacotes no repositório atual, em vez de todos os pacotes em qualquer repositório. Você pode usar o valor especial "public" no lugar de "//..." para ter o comportamento antigo. Essa flag exige que --incompatible_package_group_has_public_syntax também seja ativada.
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_merge_fixed_and_default_shell_env
padrão: "true"-
Se ativado, as ações registradas com ctx.actions.run e ctx.actions.run_shell com "env" e "use_default_shell_env = True" especificados vão usar um ambiente obtido do ambiente de shell padrão substituindo os valores transmitidos para "env". Se desativado, o valor de "env" será completamente ignorado.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_no_attr_license
padrão: "true"-
Se definido como "true", desativa a função "attr.license".
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_no_implicit_file_export
padrão: "false"-
Se definido, os arquivos-fonte (usados) são privados do pacote, a menos que sejam exportados explicitamente. Consulte https://github.com/bazelbuild/proposals/blob/master/designs/2019-10-24-file-visibility.md
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_no_implicit_watch_label
padrão: "true"-
Se verdadeiro, os métodos em <code>repository_ctx</code> que recebem um rótulo não monitorarão mais automaticamente o arquivo sob esse rótulo em busca de mudanças, mesmo que <code>watch = "no"</code> e <code>repository_ctx.path</code> não causem mais o monitoramento do caminho retornado. Use <code>repository_ctx.watch</code>.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_no_rule_outputs_param
padrão: "false"-
Se definido como verdadeiro, desativa o parâmetro "outputs" da função Starlark "rule()".
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_package_group_has_public_syntax
padrão: "true"-
No atributo "packages" de package_group, permite gravar "public" ou "private" para se referir a todos os pacotes ou a nenhum deles, respectivamente.
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_require_linker_input_cc_api
padrão: "true"-
Se definido como verdadeiro, a regra create_linking_context vai exigir linker_inputs em vez de libraries_to_link. Os getters antigos de linking_context também serão desativados, e apenas linker_inputs estará disponível.
Tags:build_file_semantics
,loading_and_analysis
,incompatible_change
--[no]incompatible_run_shell_command_string
padrão: "true"-
Se definido como "true", o parâmetro de comando de actions.run_shell só vai aceitar tags
de string:build_file_semantics
,incompatible_change
--[no]incompatible_simplify_unconditional_selects_in_rule_attrs
padrão: "true"-
Se verdadeiro, simplifica os atributos de regras configuráveis que contêm apenas seleções incondicionais. Por exemplo, se ["a"] + select("//conditions:default", ["b"]) for atribuído a um atributo de regra, ele será armazenado como ["a", "b"]. Essa opção não afeta os atributos de macros simbólicas nem os valores padrão dos atributos.
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_stop_exporting_build_file_path
padrão: "false"-
Se definido como "verdadeiro", o ctx.build_file_path descontinuado não estará disponível. O ctx.label.package + '/BUILD' pode ser usado.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_stop_exporting_language_modules
padrão: "false"-
Se ativado, alguns módulos específicos da linguagem (como "cc_common") não estarão disponíveis nos arquivos .bzl do usuário e só poderão ser chamados nos respectivos repositórios de regras.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_top_level_aspects_require_providers
padrão: "true"-
Se definido como "true", o aspecto de nível superior vai respeitar os provedores obrigatórios e ser executado apenas em destinos de nível superior cujos provedores anunciados nas regras atendem aos provedores obrigatórios do aspecto.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_unambiguous_label_stringification
padrão: "true"-
Quando verdadeiro, o Bazel transforma o rótulo @//foo:bar em @//foo:bar, em vez de //foo:bar. Isso afeta apenas o comportamento de str(), o operador % e assim por diante. O comportamento de repr() não muda. Consulte https://github.com/bazelbuild/bazel/issues/15916 para mais informações.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_use_cc_configure_from_rules_cc
padrão: "false"-
Quando verdadeiro, o Bazel não vai mais permitir o uso de cc_configure do @bazel_tools. Consulte https://github.com/bazelbuild/bazel/issues/10134 para detalhes e instruções de migração.
Tags:loading_and_analysis
,incompatible_change
--max_computation_steps=<a long integer>
padrão: "0"-
O número máximo de etapas de computação do Starlark que podem ser executadas por um arquivo BUILD (zero significa sem limite).
Tags:build_file_semantics
--nested_set_depth_limit=<an integer>
padrão: "3500"-
A profundidade máxima do gráfico interno de um depset (também conhecido como NestedSet), acima da qual o construtor depset() falha.
Tags:loading_and_analysis
--repositories_without_autoloads=<comma-separated set of options>
padrão: ""-
Uma lista de repositórios adicionais (além dos codificados em disco conhecidos pelo Bazel) em que não é necessário adicionar carregamentos automáticos. Normalmente, ele contém repositórios que dependem transitivamente de um repositório que pode ser carregado automaticamente (e, portanto, pode criar um ciclo).
Tags:loses_incremental_state
,build_file_semantics
,incompatible_change
- Opções relacionadas à saída e semântica do Bzlmod:
- Vários usos de
--allow_yanked_versions=<a string>
são acumulados -
Especificou as versões do módulo no formato<module1>@<version1>,<module2>@<version2>, que serão permitidos no gráfico de dependências resolvido, mesmo que sejam declaradas como retiradas no registro de origem (se não forem de uma NonRegistryOverride). Caso contrário, as versões retiradas vão causar a falha da resolução. Também é possível definir a versão de retirada permitida com a variável de ambiente "BZLMOD_ALLOW_YANKED_VERSIONS". É possível desativar essa verificação usando a palavra-chave "all" (não recomendada).
Tags:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
padrão: "error"-
Verifique a compatibilidade da versão do Bazel com os módulos do Bazel. Os valores válidos são "error" para encaminhar a uma falha de resolução, "off" para desativar a verificação ou "warning" para mostrar um aviso quando houver uma incompatibilidade detectada.
Tags:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
padrão: "warning"-
Verifique se as dependências diretas de `bazel_dep` declaradas no módulo raiz são as mesmas versões que você recebe no gráfico de dependências resolvido. Os valores válidos são "off" para desativar a verificação, "warning" para mostrar um aviso quando houver uma incompatibilidade detectada ou "error" para elevar o nível para uma falha de resolução.
Tags:loading_and_analysis
--[no]ignore_dev_dependency
padrão: "false"-
Se verdadeiro, o Bazel ignora "bazel_dep" e "use_extension" declarados como "dev_dependency" no MODULE.bazel do módulo raiz. Essas dependências de desenvolvimento são sempre ignoradas no MODULE.bazel se não forem o módulo raiz, independente do valor dessa flag.
Tags:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
padrão: "update"-
Especifica como e se é possível usar o arquivo de bloqueio. Os valores válidos são "update" para usar o arquivo de bloqueio e atualizá-lo se houver mudanças, "refresh" para atualizar também as informações mutáveis (versões retiradas e módulos ausentes) dos registros remotos de tempos em tempos, "error" para usar o arquivo de bloqueio, mas gerar um erro se ele não estiver atualizado ou "off" para não ler nem gravar no arquivo de bloqueio.
Tags:loading_and_analysis
- Vários usos de
--override_module=<an equals-separated mapping of module name to path>
são acumulados - Substitua um módulo por um caminho local no formato <nome do módulo>=<caminho>. Se o caminho fornecido for absoluto, ele será usado como está. Se o caminho fornecido for relativo, ele será relativo ao diretório de trabalho atual. Se o caminho fornecido começar com "%workspace%", ele será relativo à raiz do espaço de trabalho, que é a saída de "bazel info workspace". Se o caminho fornecido estiver vazio, remova todas as substituições anteriores.
- Vários usos de
--registry=<a string>
são acumulados -
Especifica os registros a serem usados para localizar dependências de módulo do Bazel. A ordem é importante: os módulos serão procurados primeiro nos registros anteriores e só serão substituídos por registros posteriores quando não estiverem nos registros anteriores.
Tags:changes_inputs
--vendor_dir=<a path>
padrão: consulte a descrição-
Especifica o diretório que precisa conter os repositórios externos no modo de fornecedor, seja para buscá-los ou usá-los durante o build. O caminho pode ser especificado como absoluto ou relativo ao diretório do espaço de trabalho.
Tags:loading_and_analysis
- Opções que acionam otimizações do tempo de build:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
padrão: "1s:2,20s:3,1m:5"-
Limites que, se alcançados, fazem com que o GcThrashingDetector cause uma falha no Bazel com um OOM. Cada limite é especificado como <period>:<count>, em que "period" é uma duração e "count" é um número inteiro positivo. Se mais de --gc_thrashing_threshold por cento do espaço de tenured (heap de geração antiga) permanecer ocupado após <count> GCs completos consecutivos em <period>, um OOM será acionado. É possível especificar vários limites separados por vírgulas.
Tags:host_machine_resource_optimizations
--[no]heuristically_drop_nodes
padrão: "false"-
Se verdadeiro, o Blaze vai remover os nós FileState e DirectoryListingState depois que o nó File e DirectoryListing relacionado for concluído para economizar memória. Esperamos que esses nós não sejam necessários novamente. Nesse caso, o programa vai reavaliá-los.
Tags:loses_incremental_state
--[no]incompatible_do_not_split_linking_cmdline
padrão: "true"-
Quando verdadeiro, o Bazel não modifica mais as flags de linha de comando usadas para vinculação e também não decide seletivamente quais flags vão para o arquivo de parâmetro e quais não vão. Consulte https://github.com/bazelbuild/bazel/issues/7670 para saber mais.
Tags:loading_and_analysis
,incompatible_change
--[no]keep_state_after_build
padrão: "true"-
Se for falso, o Blaze vai descartar o estado em memória dessa build quando ela terminar. Os builds subsequentes não terão nenhuma incrementalidade em relação a esse.
Tags:loses_incremental_state
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
padrão: "10"-
Flag para configuração avançada do mecanismo Skyframe interno do Bazel. Se o Bazel detectar que o uso da porcentagem de heap retido excede o limite definido por --skyframe_high_water_mark_threshold, quando um evento GC completo ocorrer, ele vai descartar o estado temporário desnecessário do Skyframe, até esse número de vezes por invocação. O valor padrão é 10. Zero significa que os eventos de GC completos nunca vão acionar quedas. Se o limite for atingido, o estado do Skyframe não será descartado quando um evento de GC completo ocorrer e o limite de porcentagem de heap retido for excedido.
Tags:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
padrão: "10"-
Flag para configuração avançada do mecanismo Skyframe interno do Bazel. Se o Bazel detectar que o uso da porcentagem de heap retido excede o limite definido por --skyframe_high_water_mark_threshold, quando um evento de GC menor ocorrer, ele vai descartar o estado temporário desnecessário do Skyframe, até esse número de vezes por invocação. O valor padrão é 10. Zero significa que eventos GC menores nunca vão acionar quedas. Se o limite for atingido, o estado do Skyframe não será descartado quando um evento de GC menor ocorrer e o limite de porcentagem de heap retido for excedido.
Tags:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
padrão: "85"-
Flag para configuração avançada do mecanismo Skyframe interno do Bazel. Se o Bazel detectar que a porcentagem de uso da pilha retida é pelo menos esse limite, ele vai descartar o estado temporário desnecessário do Skyframe. Aprimorar isso pode permitir que você mitigue o impacto do tempo de parede do GC thrashing, quando o GC thrashing é (i) causado pelo uso de memória desse estado temporário e (ii) mais caro do que reconstituir o estado quando necessário.
Tags:host_machine_resource_optimizations
--[no]track_incremental_state
padrão: "true"-
Se for falso, o Blaze não vai persistir dados que permitem a invalidação e a reavaliação em builds incrementais para economizar memória no build. Os builds subsequentes não terão nenhuma incrementalidade em relação a esse. Normalmente, é necessário especificar --batch ao definir esse valor como falso.
Tags:loses_incremental_state
- Opções que afetam a verbosidade, o formato ou o local de registro:
--[no]announce_rc
padrão: "false"-
Define se as opções de rc serão anunciadas.
Tags:affects_outputs
--[no]attempt_to_print_relative_paths
padrão: "false"-
Ao imprimir a parte de localização das mensagens, tente usar um caminho relativo ao diretório do espaço de trabalho ou a um dos diretórios especificados por --package_path.
Tags:terminal_output
--bes_backend=<a string>
padrão: ""-
Especifica o endpoint de back-end do serviço de eventos de build (BES) no formulário [SCHEME://]HOST[:PORT]. O padrão é desativar os uploads do BES. Os esquemas compatíveis são grpc e grpcs (grpc com TLS ativado). Se nenhum esquema for fornecido, o Bazel vai presumir grpcs.
Tags:affects_outputs
--[no]bes_check_preceding_lifecycle_events
padrão: "false"-
Define o campo check_preceding_lifecycle_events_present em PublishBuildToolEventStreamRequest, que informa ao BES se ele recebeu anteriormente eventos InvocationAttemptStarted e BuildEnqueued correspondentes ao evento de ferramenta atual.
Tags:affects_outputs
- Vários usos de
--bes_header=<a 'name=value' assignment>
são acumulados -
Especifica um cabeçalho no formato NAME=VALUE que será incluído nas solicitações do BES. Vários cabeçalhos podem ser transmitidos especificando a flag várias vezes. Vários valores com o mesmo nome serão convertidos em uma lista separada por vírgulas.
Tags:affects_outputs
--bes_instance_name=<a string>
padrão: consulte a descrição-
Especifica o nome da instância em que o BES vai manter o BEP enviado. O padrão é nulo.
Tags:affects_outputs
- Vários usos de
--bes_keywords=<comma-separated list of options>
são acumulados -
Especifica uma lista de palavras-chave de notificação a serem adicionadas ao conjunto padrão de palavras-chave publicadas no BES ("command_name=<command_name> ", "protocol_name=BEP"). O padrão é nenhum.
Tags:affects_outputs
--[no]bes_lifecycle_events
padrão: "true"-
Especifica se os eventos de ciclo de vida do BES serão publicados. O padrão é "true".
Tags:affects_outputs
--bes_oom_finish_upload_timeout=<An immutable length of time.>
padrão: "10m"-
Especifica quanto tempo o Bazel precisa esperar para que o upload do BES/BEP seja concluído durante o OOM. Essa flag garante a interrupção quando a JVM está com um uso excessivo de GC e não pode progredir em nenhuma linha de execução do usuário.
Tags:bazel_monitoring
--bes_outerr_buffer_size=<an integer>
padrão: "10240"-
Especifica o tamanho máximo de stdout ou stderr a ser armazenado em buffer no BEP antes de ser informado como um evento de progresso. As gravações individuais ainda são informadas em um único evento, mesmo que sejam maiores do que o valor especificado até --bes_outerr_chunk_size.
Tags:affects_outputs
--bes_outerr_chunk_size=<an integer>
padrão: "1048576"-
Especifica o tamanho máximo de stdout ou stderr a ser enviado para o BEP em uma única mensagem.
Tags:affects_outputs
--bes_proxy=<a string>
padrão: consulte a descrição- Conecte-se ao serviço de eventos de build por um proxy. No momento, essa flag só pode ser usada para configurar um soquete de domínio Unix (unix:/path/to/socket).
--bes_results_url=<a string>
padrão: ""-
Especifica o URL base em que um usuário pode acessar as informações transmitidas para o back-end do BES. O Bazel vai gerar o URL anexado pelo ID de invocação ao terminal.
Tags:terminal_output
- Vários usos de
--bes_system_keywords=<comma-separated list of options>
são acumulados -
Especifica uma lista de palavras-chave de notificação a serem incluídas diretamente, sem o prefixo "user_keyword=" incluído para palavras-chave fornecidas por --bes_keywords. Destinado a operadores de serviço de build que definem --bes_lifecycle_events=false e incluem palavras-chave ao chamar PublishLifecycleEvent. Os operadores de serviço de build que usam essa flag precisam impedir que os usuários substituam o valor dela.
Tags:affects_outputs
--bes_timeout=<An immutable length of time.>
padrão: "0s"-
Especifica por quanto tempo o Bazel deve esperar a conclusão do upload do BES/BEP após a conclusão do build e dos testes. Um tempo limite válido é um número natural seguido de uma unidade: dias (d), horas (h), minutos (m), segundos (s) e milissegundos (ms). O valor padrão é "0", o que significa que não há tempo limite.
Tags:affects_outputs
--bes_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>
padrão: "wait_for_upload_complete"-
Especifica se o upload do serviço de evento de build precisa bloquear a conclusão do build ou encerrar a invocação imediatamente e concluir o upload em segundo plano. "wait_for_upload_complete" (padrão), "nowait_for_upload_complete" ou "fully_async".
Tags:eagerness_to_exit
--build_event_binary_file=<a string>
padrão: ""-
Se não estiver vazio, grave uma representação binária delimitada por varint do protocolo de evento de build nesse arquivo. Essa opção implica --bes_upload_mode=wait_for_upload_complete.
Tags:affects_outputs
--[no]build_event_binary_file_path_conversion
padrão: "true"-
Converte caminhos na representação de arquivo binário do protocolo de evento de build em URIs mais válidos globalmente sempre que possível. Se desativado, o esquema de URI file:// será sempre usado
Tags:affects_outputs
--build_event_binary_file_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>
padrão: "wait_for_upload_complete"-
Especifica se o upload do serviço de evento de build para --build_event_binary_file deve bloquear a conclusão do build ou encerrar a invocação imediatamente e concluir o upload em segundo plano. "wait_for_upload_complete" (padrão), "nowait_for_upload_complete" ou "fully_async".
Tags:eagerness_to_exit
--build_event_json_file=<a string>
padrão: ""-
Se não estiver vazio, grave uma serialização JSON do protocolo do evento de build nesse arquivo. Essa opção implica --bes_upload_mode=wait_for_upload_complete.
Tags:affects_outputs
--[no]build_event_json_file_path_conversion
padrão: "true"-
Converta caminhos na representação do arquivo JSON do protocolo de evento de build em URIs mais válidos globalmente sempre que possível. Se desativado, o esquema de URI file:// será sempre usado
Tags:affects_outputs
--build_event_json_file_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>
padrão: "wait_for_upload_complete"-
Especifica se o upload do serviço de evento de build para --build_event_json_file deve bloquear a conclusão do build ou encerrar a invocação imediatamente e concluir o upload em segundo plano. "wait_for_upload_complete" (padrão), "nowait_for_upload_complete" ou "fully_async".
Tags:eagerness_to_exit
--build_event_max_named_set_of_file_entries=<an integer>
padrão: "5000"-
O número máximo de entradas para um único evento named_set_of_files. Valores menores que 2 são ignorados, e nenhuma divisão de eventos é realizada. O objetivo é limitar o tamanho máximo de eventos no protocolo de eventos de build, embora ele não controle diretamente o tamanho do evento. O tamanho total do evento é uma função da estrutura do conjunto, bem como dos comprimentos de arquivo e URI, que podem depender da função hash.
Tags:affects_outputs
--[no]build_event_publish_all_actions
padrão: "false"-
Define se todas as ações precisam ser publicadas.
Tags:affects_outputs
--build_event_text_file=<a string>
padrão: ""-
Se não estiver vazio, grave uma representação textual do protocolo do evento de build nesse arquivo
Tags:affects_outputs
--[no]build_event_text_file_path_conversion
padrão: "true"-
Converte caminhos na representação do arquivo de texto do protocolo do evento de build em URIs mais válidos globalmente sempre que possível. Se desativado, o esquema de URI file:// será sempre usado
Tags:affects_outputs
--build_event_text_file_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>
padrão: "wait_for_upload_complete"-
Especifica se o upload do serviço de evento de build para --build_event_text_file deve bloquear a conclusão do build ou encerrar a invocação imediatamente e concluir o upload em segundo plano. "wait_for_upload_complete" (padrão), "nowait_for_upload_complete" ou "fully_async".
Tags:eagerness_to_exit
--build_event_upload_max_retries=<an integer>
padrão: "4"-
O número máximo de vezes que o Bazel precisa tentar fazer o upload de um evento de build.
Tags:bazel_internal_configuration
--[no]experimental_bep_target_summary
padrão: "false"- Define se os eventos de TargetSummary serão publicados.
--[no]experimental_build_event_expand_filesets
padrão: "false"-
Se verdadeiro, expande os conjuntos de arquivos no BEP ao apresentar arquivos de saída.
Tags:affects_outputs
--[no]experimental_build_event_fully_resolve_fileset_symlinks
padrão: "false"-
Se verdadeiro, resolve totalmente os links simbólicos relativos do conjunto de arquivos no BEP ao apresentar arquivos de saída. Requer --experimental_build_event_expand_filesets.
Tags:affects_outputs
- Vários usos de
--experimental_build_event_output_group_mode=<an output group name followed by an OutputGroupFileMode, e.g. default=both>
são acumulados -
Especifica como os arquivos de um grupo de saída serão representados nos eventos de BEP TargetComplete/AspectComplete. Os valores são uma atribuição de um nome de grupo de saída a um dos seguintes: 'NAMED_SET_OF_FILES_ONLY', 'INLINE_ONLY' ou 'BOTH'. O valor padrão é 'NAMED_SET_OF_FILES_ONLY'. Se um grupo de saída for repetido, o valor final a ser mostrado será usado. O valor padrão define o modo dos artefatos de cobertura como AMBOS: --experimental_build_event_output_group_mode=baseline.lcov=both
Tags:affects_outputs
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
padrão: "1s"-
Delay mínimo inicial para as tentativas de espera exponencial quando o upload do BEP falha. (expoente: 1,6)
Tags:bazel_internal_configuration
--experimental_build_event_upload_strategy=<a string>
padrão: consulte a descrição-
Seleciona como fazer upload de artefatos referenciados no protocolo de evento de build. No Bazel, as opções válidas incluem "local" e "remote". O valor padrão é "local".
Tags:affects_outputs
--[no]experimental_collect_load_average_in_profiler
padrão: "true"-
Se ativado, o criador de perfil coleta a média de carga geral do sistema.
Tags:bazel_monitoring
--[no]experimental_collect_pressure_stall_indicators
padrão: "false"-
Se ativado, o criador de perfil coleta os dados de PSI do Linux.
Tags:bazel_monitoring
--[no]experimental_collect_resource_estimation
padrão: "false"-
Se ativado, o perfilador coleta a estimativa de uso de CPU e memória para ações locais.
Tags:bazel_monitoring
--[no]experimental_collect_skyframe_counts_in_profiler
padrão: "false"-
Se ativado, o criador de perfis coleta contagens de SkyFunction no gráfico do Skyframe ao longo do tempo para os principais tipos de função, como destinos configurados e execuções de ação. Pode ter um impacto na performance, já que ele visita o gráfico INTEIRO do Skyframe em cada unidade de tempo de perfil. Não use essa flag com medições de desempenho crítico.
Tags:bazel_monitoring
--[no]experimental_collect_system_network_usage
padrão: "true"-
Se ativado, o perfilador coleta o uso de rede do sistema.
Tags:bazel_monitoring
--[no]experimental_collect_worker_data_in_profiler
padrão: "false"-
Se ativado, o criador de perfil coleta os dados de recursos agregados do worker.
Tags:bazel_monitoring
--experimental_command_profile=<cpu, wall, alloc or lock>
padrão: consulte a descrição- Grava um perfil do Flight Recorder Java durante a execução do comando. Um dos tipos de evento de criação de perfil aceitos (cpu, wall, alloc ou lock) precisa ser fornecido como um argumento. O perfil é gravado em um arquivo com o nome do tipo de evento no diretório de saída. A sintaxe e a semântica dessa flag podem mudar no futuro para oferecer suporte a outros tipos de perfil ou formatos de saída. Use por sua conta e risco.
- Vários usos de
--experimental_profile_additional_tasks=<phase, action, discover_inputs, action_check, action_lock, action_update, action_complete, action_rewinding, bzlmod, info, create_package, remote_execution, local_execution, scanner, local_parse, upload_time, remote_process_time, remote_queue, remote_setup, fetch, local_process_time, vfs_stat, vfs_dir, vfs_readlink, vfs_md5, vfs_xattr, vfs_delete, vfs_open, vfs_read, vfs_write, vfs_glob, vfs_vmfs_stat, vfs_vmfs_dir, vfs_vmfs_read, wait, thread_name, thread_sort_index, skyframe_eval, skyfunction, critical_path, critical_path_component, handle_gc_notification, local_action_counts, starlark_parser, starlark_user_fn, starlark_builtin_fn, starlark_user_compiled_fn, starlark_repository_fn, action_fs_staging, remote_cache_check, remote_download, remote_network, filesystem_traversal, worker_execution, worker_setup, worker_borrow, worker_working, worker_copying_outputs, credential_helper, conflict_check, dynamic_lock, repository_fetch, repository_vendor or unknown>
são acumulados -
Especifica outras tarefas do perfil a serem incluídas.
Tags:bazel_monitoring
--[no]experimental_profile_include_primary_output
padrão: "false"-
Inclui o atributo "out" extra em eventos de ação que contém o caminho de execução para a saída principal da ação.
Tags:bazel_monitoring
--[no]experimental_profile_include_target_configuration
padrão: "false"-
Inclui o hash de configuração de destino nos dados do perfil JSON dos eventos de ação.
Tags:bazel_monitoring
--[no]experimental_profile_include_target_label
padrão: "false"-
Inclui o rótulo de destino nos dados do perfil JSON dos eventos de ação.
Tags:bazel_monitoring
--[no]experimental_record_metrics_for_all_mnemonics
padrão: "false"- Controla a saída do ActionSummary e do BuildGraphMetrics do BEP, limitando o número de mnemônicos em ActionData e o número de entradas relatadas em BuildGraphMetrics.AspectCount/RuleClassCount. Por padrão, o número de tipos é limitado aos 20 principais, pelo número de ações executadas para ActionData e instâncias para RuleClass e Asepcts. A configuração dessa opção vai gravar estatísticas para todos os mnemônicos, classes de regras e aspectos.
--[no]experimental_record_skyframe_metrics
padrão: "false"- Controla a saída do BuildGraphMetrics do BEP, incluindo métricas de skyframe caras para computação sobre Skykeys, RuleClasses e Aspectos.Com essa flag definida como falsa, BuildGraphMetrics.rule_count e aspectfields não serão preenchidos no BEP.
--[no]experimental_run_bep_event_include_residue
padrão: "false"-
Define se o resíduo da linha de comando será incluído nos eventos de execução do build que podem conter o resíduo. Por padrão, o resíduo não é incluído nos eventos de build de execução de comando que podem conter o resíduo.
Tags:affects_outputs
--[no]experimental_stream_log_file_uploads
padrão: "false"-
O arquivo de registro de streaming é enviado diretamente para o armazenamento remoto em vez de ser gravado no disco.
Tags:affects_outputs
--experimental_workspace_rules_log_file=<a path>
padrão: consulte a descrição- Registre determinados eventos de regras do Workspace neste arquivo como protos de WorkspaceEvent delimitados.
--[no]generate_json_trace_profile
padrão: "auto"-
Se ativado, o Bazel cria perfis do build e grava um perfil no formato JSON em um arquivo na base de saída. Abra o perfil em chrome://tracing. Por padrão, o Bazel grava o perfil para todos os comandos e consultas semelhantes a build.
Tags:bazel_monitoring
--[no]heap_dump_on_oom
padrão: "false"-
Define se um despejo de heap será gerado manualmente quando uma OOM for gerada (incluindo OOMs manuais devido ao alcance de --gc_thrashing_limits). O despejo será gravado em <output_base>/<invocation_id>.heapdump.hprof. Essa opção substitui efetivamente -XX:+HeapDumpOnOutOfMemoryError, que não tem efeito para OOMs manuais.
Tags:bazel_monitoring
--jvm_heap_histogram_internal_object_pattern=<a valid Java regular expression>
padrão: "jdk\.internal\.vm\.Filler.+"- Expressão regular para substituir a lógica de correspondência para a coleta de memória de heap do JDK21+. Estamos usando detalhes de implementação de GC G1 internos voláteis para ter uma métrica de memória limpa. Essa opção nos permite nos adaptar a mudanças nessa implementação interna sem precisar esperar por uma versão binária. Transmitido para JDK Matcher.find()
--[no]legacy_important_outputs
padrão: "false"-
Use isso para suprimir a geração do campo important_outputs legada no evento TargetComplete. important_outputs é necessário para a integração do Bazel com o ResultStore/BTX.
Tags:affects_outputs
--logging=<0 <= an integer <= 6>
padrão: "3"-
O nível de registro.
Tags:affects_outputs
--memory_profile=<a path>
padrão: consulte a descrição-
Se definido, grava dados de uso de memória no arquivo especificado no final da fase e heap estável no registro mestre no final do build.
Tags:bazel_monitoring
--memory_profile_stable_heap_parameters=<integers, separated by a comma expected in pairs>
padrão: "1,0"-
Ajuste a computação do perfil de memória do heap estável no final do build. Precisa ser um número par de números inteiros separados por vírgulas. Em cada par, o primeiro número inteiro é o número de GCs a serem realizadas. O segundo número inteiro em cada par é o número de segundos para aguardar entre as GCs. Por exemplo, 2,4,4,0 seria 2 GCs com uma pausa de 4 segundos, seguidas por 4 GCs com uma pausa de 0 segundo
Tags:bazel_monitoring
--profile=<a path>
padrão: consulte a descrição-
Se definido, cria um perfil do Bazel e grava dados no arquivo especificado. Use o bazel analyze-profile para analisar o perfil.
Tags:bazel_monitoring
--profiles_to_retain=<an integer>
padrão: "5"-
Número de perfis a serem mantidos na base de saída. Se houver mais perfis do que esse número na base de saída, os mais antigos serão excluídos até que o total fique abaixo do limite.
Tags:bazel_monitoring
--[no]record_full_profiler_data
padrão: "false"-
Por padrão, o perfilador do Bazel registra apenas dados agregados para eventos rápidos, mas numerosos (como a estatística do arquivo). Se essa opção estiver ativada, o criador de perfil vai registrar cada evento, resultando em dados de criação de perfil mais precisos, mas com GRANDE impacto na performance. A opção só tem efeito se o --profile também for usado.
Tags:bazel_monitoring
--[no]redirect_local_instrumentation_output_writes
padrão: "false"-
Se verdadeiro e compatível, a saída de instrumentação será redirecionada para ser gravada localmente em uma máquina diferente daquela em que o Bazel está sendo executado.
Tags:bazel_monitoring
--remote_print_execution_messages=<failure, success or all>
padrão: "failure"-
Escolha quando imprimir mensagens de execução remota. Os valores válidos são "failure" para imprimir apenas em falhas, "success" para imprimir apenas em sucessos e "all" para imprimir sempre.
Tags:terminal_output
--[no]slim_profile
padrão: "true"-
Reduz o tamanho do perfil JSON mesclando eventos se ele ficar muito grande.
Tags:bazel_monitoring
--starlark_cpu_profile=<a string>
padrão: ""-
Grava no arquivo especificado um perfil pprof de uso da CPU por todas as linhas de execução do Starlark.
Tags:bazel_monitoring
--tool_tag=<a string>
padrão: ""-
O nome de uma ferramenta para atribuir essa invocação do Bazel.
Tags:affects_outputs
,bazel_monitoring
- Vários usos de
--ui_event_filters=<Convert list of comma separated event kind to list of filters>
são acumulados -
Especifica quais eventos serão mostrados na interface. É possível adicionar ou remover eventos dos padrões usando +/- inicial ou substituir o conjunto padrão completamente com atribuição direta. O conjunto de tipos de eventos aceitos inclui INFO, DEBUG, ERROR e muito mais.
Tags:terminal_output
- Opções que especificam ou alteram uma entrada genérica para um comando do Bazel que não se enquadra em outras categorias.:
--experimental_resolved_file_instead_of_workspace=<a string>
padrão: ""-
Se não estiver vazio, leia o arquivo resolvido especificado em vez do arquivo WORKSPACE
Tags:changes_inputs
- Opções de execução e armazenamento em cache remoto:
--experimental_circuit_breaker_strategy=<failure>
padrão: consulte a descrição-
Especifica a estratégia a ser usada pelo disjuntor. As estratégias disponíveis são "falha". Em um valor inválido para a opção, o comportamento é o mesmo que quando a opção não está definida.
Tags:execution
--experimental_downloader_config=<a string>
padrão: consulte a descrição- Especifique um arquivo para configurar o download remoto. Esse arquivo consiste em linhas, cada uma começando com uma diretiva ("allow", "block" ou "rewrite") seguida por um nome de host (para "allow" e "block") ou dois padrões, um para corresponder e outro para usar como um URL substituto, com referências anteriores começando em "$1". É possível que várias diretivas "rewrite" para o mesmo URL sejam fornecidas e, nesse caso, vários URLs serão retornados.
--[no]experimental_guard_against_concurrent_changes
padrão: "false"- Desative essa opção para desativar a verificação do ctime dos arquivos de entrada de uma ação antes de fazer o upload para um cache remoto. Pode haver casos em que o kernel do Linux atrasa a gravação de arquivos, o que pode causar falsos positivos.
--experimental_remote_cache_compression_threshold=<an integer>
padrão: "100"- O tamanho mínimo do blob necessário para compactar/descompactar com zstd. Ineficaz, a menos que --remote_cache_compression esteja definido.
--[no]experimental_remote_cache_lease_extension
padrão: "false"- Se definido como verdadeiro, o Bazel vai estender o arrendamento para saídas de ações remotas durante o build enviando chamadas FindMissingBlobs periodicamente para o cache remoto. A frequência é baseada no valor de `--experimental_remote_cache_ttl`.
--experimental_remote_cache_ttl=<An immutable length of time.>
padrão: "3h"-
O TTL mínimo garantido de blobs no cache remoto depois que os resumos forem referenciados recentemente, por exemplo, por um ActionResult ou FindMissingBlobs. O Bazel faz várias otimizações com base no TTL dos blobs, por exemplo, não chama GetActionResult repetidamente em um build incremental. O valor precisa ser definido um pouco menor que o TTL real, já que há uma lacuna entre o momento em que o servidor retorna os resumos e o momento em que o Bazel os recebe.
Tags:execution
--experimental_remote_capture_corrupted_outputs=<a path>
padrão: consulte a descrição- Um caminho para um diretório em que as saídas corrompidas serão capturadas.
--[no]experimental_remote_discard_merkle_trees
padrão: "true"- Se definido como verdadeiro, descarta cópias na memória da árvore Merkle da raiz de entrada e mapeamentos de entrada associados durante as chamadas para GetActionResult() e Execute(). Isso reduz significativamente o uso da memória, mas exige que o Bazel as recalcule após falhas e novas tentativas de acesso ao cache remoto.
--experimental_remote_downloader=<a string>
padrão: consulte a descrição- Um URI de endpoint da API de recursos remotos, para ser usado como um proxy de download remoto. Os esquemas compatíveis são grpc, grpcs (grpc com TLS ativado) e unix (sockets locais do UNIX). Se nenhum esquema for fornecido, o Bazel vai usar o padrão GRPC. Consulte: https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto
--[no]experimental_remote_downloader_local_fallback
padrão: "false"- Define se o download local será usado se o download remoto falhar.
--[no]experimental_remote_downloader_propagate_credentials
padrão: "false"- Define se as credenciais do netrc e do auxiliar de credenciais serão propagadas para o servidor do download remoto. A implementação do servidor precisa oferecer suporte ao novo qualificador `http_header_url:<url-index>:<header-key>`, em que "<url-index>" é uma posição baseada em 0 do URL dentro do campo "uris" do FetchBlobRequest. Os cabeçalhos específicos do URL têm precedência sobre os cabeçalhos globais.
--[no]experimental_remote_execution_keepalive
padrão: "false"- Define se o keepalive será usado para chamadas de execução remota.
--experimental_remote_failure_rate_threshold=<an integer in 0-100 range>
padrão: "10"-
Define o número permitido de taxa de falha em porcentagem para um período específico, após o qual ele para de chamar o cache/executor remoto. Por padrão, o valor é 10. Definir esse valor como 0 significa que não há limitação.
Tags:execution
--experimental_remote_failure_window_interval=<An immutable length of time.>
padrão: "60s"-
O intervalo em que a taxa de falha das solicitações remotas é calculada. Em um valor zero ou negativo, a duração da falha é computada durante toda a execução.As unidades a seguir podem ser usadas: dias (d), horas (h), minutos (m), segundos (s) e milissegundos (ms). Se a unidade for omitida, o valor será interpretado como segundos.
Tags:execution
--[no]experimental_remote_mark_tool_inputs
padrão: "false"- Se definido como verdadeiro, o Bazel marcará as entradas como entradas de ferramenta para o executor remoto. Isso pode ser usado para implementar workers persistentes remotos.
--[no]experimental_remote_merkle_tree_cache
padrão: "false"- Se definido como verdadeiro, os cálculos da árvore de Merkle serão armazenados em cache para melhorar a velocidade de verificação de acertos de cache remoto. O volume de memória do cache é controlado por --experimental_remote_merkle_tree_cache_size.
--experimental_remote_merkle_tree_cache_size=<a long integer>
padrão: "1000"- O número de árvores de Merkle a serem memorizadas para melhorar a velocidade de verificação de ocorrências de cache remoto. Embora o cache seja podado automaticamente de acordo com o tratamento de referências flexíveis do Java, erros de falta de memória podem ocorrer se a configuração for muito alta. Se definido como 0, o tamanho do cache será ilimitado. O valor ideal varia de acordo com o tamanho do projeto. O padrão é 1.000.
--experimental_remote_output_service=<a string>
padrão: consulte a descrição- HOST ou HOST:PORT de um endpoint de serviço de saída remoto. Os esquemas compatíveis são grpc, grpcs (grpc com TLS ativado) e unix (sockets locais do UNIX). Se nenhum esquema for fornecido, o Bazel vai usar o padrão GRPC. Especifique o esquema grpc:// ou unix: para desativar o TLS.
--experimental_remote_output_service_output_path_prefix=<a string>
padrão: ""- O caminho em que o conteúdo dos diretórios de saída gerenciados pelo --experimental_remote_output_service é colocado. O diretório de saída real usado por um build será um descendente desse caminho e determinado pelo serviço de saída.
--[no]experimental_remote_require_cached
padrão: "false"- Se definido como verdadeiro, vai forçar que todas as ações que podem ser executadas remotamente sejam armazenadas em cache ou que o build falhe. Isso é útil para resolver problemas de não determinismo, porque permite verificar se as ações que precisam ser armazenadas em cache são realmente armazenadas sem injetar novos resultados no cache.
--experimental_remote_scrubbing_config=<Converts to a Scrubber>
padrão: consulte a descrição- Habilita o apagamento de chaves de cache remoto com o arquivo de configuração fornecido, que precisa ser um buffer de protocolo no formato de texto (consulte src/main/protobuf/remote_scrubbing.proto). O objetivo desse recurso é facilitar o compartilhamento de um cache remoto/de disco entre ações executadas em plataformas diferentes, mas com segmentação para a mesma plataforma. Ele deve ser usado com muito cuidado, porque configurações inadequadas podem causar o compartilhamento acidental de entradas de cache e resultar em builds incorretos. A limpeza não afeta a execução de uma ação, apenas como a chave de cache remoto/disco é calculada para recuperar ou armazenar um resultado de ação. As ações apagadas são incompatíveis com a execução remota e sempre serão executadas localmente. Modificar a configuração de limpeza não invalida as saídas presentes no sistema de arquivos local ou nos caches internos. É necessário um build limpo para reexecutar as ações afetadas. Para usar esse recurso, é recomendável definir um --host_platform personalizado com --experimental_platform_in_output_dir (para normalizar os prefixos de saída) e --incompatible_strict_action_env (para normalizar as variáveis de ambiente).
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
padrão: "auto"- O modo de linha de execução a ser usado para buscar repositórios. Se definido como "off", nenhuma linha de execução de worker é usada, e a busca do repositório está sujeita a reinicializações. Caso contrário, usa uma linha de execução de worker virtual.
--[no]remote_accept_cached
padrão: "true"- Define se os resultados da ação armazenados em cache remotamente serão aceitos.
--remote_build_event_upload=<all or minimal>
padrão: "minimal"- Se definido como "all", todas as saídas locais referenciadas pelo BEP são enviadas por upload para o cache remoto. Se definido como "minimal", as saídas locais referenciadas pelo BEP não são enviadas para o cache remoto, exceto arquivos importantes para os consumidores do BEP (por exemplo, logs de teste e perfil de tempo). O esquema bytestream:// é sempre usado para o uri de arquivos, mesmo que eles não estejam no cache remoto. O padrão é "minimal".
--remote_bytestream_uri_prefix=<a string>
padrão: consulte a descrição- O nome do host e da instância a ser usado em URIs bytestream:// gravados em streams de eventos de build. Essa opção pode ser definida quando os builds são realizados usando um proxy, o que faz com que os valores de --remote_executor e --remote_instance_name não correspondam mais ao nome canônico do serviço de execução remota. Quando não definido, o padrão é "${hostname}/${instance_name}".
--remote_cache=<a string>
padrão: consulte a descrição- Um URI de um endpoint de armazenamento em cache. Os esquemas compatíveis são http, https, grpc, grpcs (grpc com TLS ativado) e unix (sockets locais do UNIX). Se nenhum esquema for fornecido, o Bazel vai usar o padrão GRPC. Especifique o esquema grpc://, http:// ou unix: para desativar o TLS. Consulte https://bazel.build/remote/caching
--[no]remote_cache_async
padrão: "true"- Se verdadeiro, o upload dos resultados da ação para um disco ou cache remoto vai acontecer em segundo plano, em vez de bloquear a conclusão de uma ação. Algumas ações são incompatíveis com uploads em segundo plano e podem ser bloqueadas mesmo quando essa flag está definida.
--[no]remote_cache_compression
padrão: "false"- Se ativado, compacte/descompacte blobs de cache com zstd quando o tamanho deles for pelo menos --experimental_remote_cache_compression_threshold.
- Vários usos de
--remote_cache_header=<a 'name=value' assignment>
são acumulados - Especifique um cabeçalho que será incluído nas solicitações de cache: --remote_cache_header=Nome=Valor. Vários cabeçalhos podem ser transmitidos especificando a flag várias vezes. Vários valores com o mesmo nome serão convertidos em uma lista separada por vírgulas.
- Vários usos de
--remote_default_exec_properties=<a 'name=value' assignment>
são acumulados -
Defina as propriedades de execução padrão para serem usadas como a plataforma de execução remota se uma plataforma de execução ainda não tiver definido exec_properties.
Tags:affects_outputs
--remote_default_platform_properties=<a string>
padrão: ""- Defina as propriedades padrão da plataforma para serem definidas para a API de execução remota, se a plataforma de execução ainda não tiver definido remote_execution_properties. Esse valor também será usado se a plataforma host for selecionada como a plataforma de execução para execução remota.
- Vários usos de
--remote_download_regex=<a valid Java regular expression>
são acumulados -
Força o download de saídas de build remoto cujo caminho corresponde a esse padrão, independentemente de --remote_download_outputs. Vários padrões podem ser especificados repetindo essa flag.
Tags:affects_outputs
- Vários usos de
--remote_downloader_header=<a 'name=value' assignment>
são acumulados - Especifica um cabeçalho que será incluído nas solicitações do downloader remoto: --remote_downloader_header=Nome=Valor. Vários cabeçalhos podem ser transmitidos especificando a flag várias vezes. Vários valores com o mesmo nome serão convertidos em uma lista separada por vírgulas.
- Vários usos de
--remote_exec_header=<a 'name=value' assignment>
são acumulados - Especifica um cabeçalho que será incluído nas solicitações de execução: --remote_exec_header=Nome=Valor. Vários cabeçalhos podem ser transmitidos especificando a flag várias vezes. Vários valores com o mesmo nome serão convertidos em uma lista separada por vírgulas.
--remote_execution_priority=<an integer>
padrão: "0"- A prioridade relativa das ações a serem executadas remotamente. A semântica dos valores de prioridade específicos depende do servidor.
--remote_executor=<a string>
padrão: consulte a descrição- HOST ou HOST:PORT de um endpoint de execução remota. Os esquemas compatíveis são grpc, grpcs (grpc com TLS ativado) e unix (sockets locais do UNIX). Se nenhum esquema for fornecido, o Bazel vai usar o padrão GRPC. Especifique o esquema grpc:// ou unix: para desativar o TLS.
--remote_grpc_log=<a path>
padrão: consulte a descrição- Se especificado, um caminho para um arquivo para registrar detalhes relacionados à chamada gRPC. Esse registro consiste em uma sequência de protobufs com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry serializados, com cada mensagem prefixada por um varint que indica o tamanho da mensagem protobuf serializada a seguir, conforme executado pelo método LogEntry.writeDelimitedTo(OutputStream).
- Vários usos de
--remote_header=<a 'name=value' assignment>
são acumulados - Especifica um cabeçalho que será incluído nas solicitações: --remote_header=Nome=Valor. Vários cabeçalhos podem ser transmitidos especificando a flag várias vezes. Vários valores com o mesmo nome serão convertidos em uma lista separada por vírgulas.
--remote_instance_name=<a string>
padrão: ""- Valor a ser transmitido como instance_name na API de execução remota.
--[no]remote_local_fallback
padrão: "false"- Define se a estratégia de execução local independente será usada como alternativa se a execução remota falhar.
--remote_local_fallback_strategy=<a string>
padrão: "local"- Descontinuado. Consulte https://github.com/bazelbuild/bazel/issues/7480 para saber mais.
--remote_max_connections=<an integer>
padrão: "100"-
Limite o número máximo de conexões simultâneas para o cache/executor remoto. Por padrão, o valor é 100. Definir esse valor como 0 significa que não há limitação.
Para o cache remoto HTTP, uma conexão TCP pode processar uma solicitação por vez. Assim, o Bazel pode criar até --remote_max_connections solicitações simultâneas.
Para o cache/executor remoto do gRPC, um canal do gRPC geralmente pode processar mais de 100 solicitações simultâneas. Portanto, o Bazel pode fazer cerca de `--remote_max_connections * 100` solicitações simultâneas.
Tags:host_machine_resource_optimizations
--remote_proxy=<a string>
padrão: consulte a descrição- Conecte-se ao cache remoto por um proxy. No momento, essa flag só pode ser usada para configurar um soquete de domínio Unix (unix:/path/to/socket).
--remote_result_cache_priority=<an integer>
padrão: "0"- A prioridade relativa das ações remotas que serão armazenadas no cache remoto. A semântica dos valores de prioridade específicos depende do servidor.
--remote_retries=<an integer>
padrão: "5"- O número máximo de tentativas de repetição de um erro temporário. Se definido como 0, as novas tentativas são desativadas.
--remote_retry_max_delay=<An immutable length of time.>
padrão: "5s"- O atraso máximo de espera entre as tentativas de nova tentativa remota. As unidades a seguir podem ser usadas: dias (d), horas (h), minutos (m), segundos (s) e milissegundos (ms). Se a unidade for omitida, o valor será interpretado como segundos.
--remote_timeout=<An immutable length of time.>
padrão: "60s"- O tempo máximo de espera para a execução remota e as chamadas de cache. Para o cache REST, isso é o tempo limite de conexão e de leitura. As unidades a seguir podem ser usadas: dias (d), horas (h), minutos (m), segundos (s) e milissegundos (ms). Se a unidade for omitida, o valor será interpretado como segundos.
--[no]remote_upload_local_results
padrão: "true"- Define se os resultados de ações executadas localmente serão enviados por upload ao cache remoto, se o cache remoto oferecer suporte a isso e se o usuário tiver autorização para fazer isso.
--[no]remote_verify_downloads
padrão: "true"- Se definido como verdadeiro, o Bazel vai calcular a soma de hash de todos os downloads remotos e descartar os valores armazenados em cache remotamente se eles não corresponderem ao valor esperado.
- Opções diversas, não categorizadas de outra forma.
- Vários usos de
--build_metadata=<a 'name=value' assignment>
são acumulados -
Pares de string de chave-valor personalizados para fornecer em um evento de build.
Tags:terminal_output
--color=<yes, no or auto>
padrão: "auto"- Use os controles do terminal para colorir a saída.
- Vários usos de
--config=<a string>
são acumulados - Seleciona outras seções de configuração dos arquivos rc. Para cada <command>, também extrai as opções de <command>:<config>, se essa seção existir. Se essa seção não existir em nenhum arquivo .rc, o Blaze vai falhar com um erro. As seções de configuração e as combinações de sinalizadores equivalentes estão localizadas nos arquivos de configuração tools/*.blazerc.
- Vários usos de
--credential_helper=<Path to a credential helper. It may be absolute, relative to the PATH environment variable, or %workspace%-relative. The path be optionally prefixed by a scope followed by an '='. The scope is a domain name, optionally with a single leading '*' wildcard component. A helper applies to URIs matching its scope, with more specific scopes preferred. If a helper has no scope, it applies to every URI.>
são acumulados - Configura um auxiliar de credencial conforme a <a href="https://github.com/EngFlow/credential-helper-spec">especificação do auxiliar de credencial</a> para usar na recuperação de credenciais de autorização para busca de repositório, armazenamento em cache remoto e execução e o serviço de evento de build. As credenciais fornecidas por um assistente têm precedência sobre as fornecidas por `--google_default_credentials`, `--google_credentials`, um arquivo.netrc ou o parâmetro de autenticação para repository_ctx.download() e repository_ctx.download_and_extract(). Pode ser especificado várias vezes para configurar vários assistentes. Consulte https://blog.engflow.com/2023/10/09/configuring-bazels-credential-helper/ para ver instruções.
--credential_helper_cache_duration=<An immutable length of time.>
padrão: "30m"- A duração padrão em que as credenciais fornecidas por um auxiliar de credenciais são armazenadas em cache se o auxiliar não informar quando as credenciais expiram.
--credential_helper_timeout=<An immutable length of time.>
padrão: "10s"- Configura o tempo limite de um assistente de credenciais. Se os ajudantes de credenciais não responderem dentro desse tempo limite, a invocação vai falhar.
--curses=<yes, no or auto>
padrão: "auto"- Use os controles do cursor do terminal para minimizar a saída de rolagem.
--disk_cache=<a path>
padrão: consulte a descrição- Um caminho para um diretório em que o Bazel pode ler e gravar ações e saídas de ação. Se o diretório não existir, ele será criado.
--[no]enable_platform_specific_config
padrão: "false"- Se verdadeiro, o Bazel seleciona linhas de configuração específicas do SO do host dos arquivos bazelrc. Por exemplo, se o SO host for Linux e você executar o Bazel build, o Bazel vai selecionar linhas que começam com build:linux. Os identificadores de SO compatíveis são linux, macos, windows, freebsd e openbsd. Ativar essa flag é equivalente a usar --config=linux no Linux, --config=windows no Windows etc.
--experimental_disk_cache_gc_idle_delay=<An immutable length of time.>
padrão: "5m"- Por quanto tempo o servidor precisa permanecer ocioso antes que ocorra uma coleta de lixo do cache do disco. Para especificar a política de coleta de lixo, defina --experimental_disk_cache_gc_max_size e/ou --experimental_disk_cache_gc_max_age.
--experimental_disk_cache_gc_max_age=<An immutable length of time.>
padrão: "0"- Se definido como um valor positivo, o cache do disco será coletado como lixo periodicamente para remover entradas mais antigas que essa idade. Se definido em conjunto com --experimental_disk_cache_gc_max_size, ambos os critérios serão aplicados. A coleta de lixo ocorre em segundo plano quando o servidor fica ocioso, conforme determinado pela flag --experimental_disk_cache_gc_idle_delay.
--experimental_disk_cache_gc_max_size=<a size in bytes, optionally followed by a K, M, G or T multiplier>
padrão: "0"- Se definido como um valor positivo, o cache do disco será coletado periodicamente para permanecer abaixo desse tamanho. Se definido em conjunto com --experimental_disk_cache_gc_max_age, ambos os critérios são aplicados. A coleta de lixo ocorre em segundo plano quando o servidor fica ocioso, conforme determinado pela flag --experimental_disk_cache_gc_idle_delay.
--[no]experimental_rule_extension_api
padrão: "true"-
Ativar a API experimental de extensão de regras e as APIs de subregra
Tags:loading_and_analysis
,experimental
--[no]experimental_windows_watchfs
padrão: "false"- Se verdadeiro, o suporte experimental do Windows para --watchfs será ativado. Caso contrário, --watchfs não será executado no Windows. Ative também o --watchfs.
--google_auth_scopes=<comma-separated list of options>
padrão: "https://www.googleapis.com/auth/cloud-platform"- Uma lista separada por vírgulas de escopos de autenticação do Google Cloud.
--google_credentials=<a string>
padrão: consulte a descrição- Especifica o arquivo de onde as credenciais de autenticação serão extraídas. Consulte https://cloud.google.com/docs/authentication para mais detalhes.
--[no]google_default_credentials
padrão: "false"- Define se as "Application Default Credentials" do Google serão usadas para autenticação. Consulte https://cloud.google.com/docs/authentication para mais detalhes. Essa configuração está desativada por padrão.
--grpc_keepalive_time=<An immutable length of time.>
padrão: consulte a descrição- Configura pings de keep-alive para conexões gRPC de saída. Se esse valor for definido, o Bazel vai enviar pings após esse período sem operações de leitura na conexão, mas somente se houver pelo menos uma chamada gRPC pendente. Os tempos são tratados como granularidade de segundo. É um erro definir um valor menor que um segundo. Por padrão, os pings de keep-alive ficam desativados. Entre em contato com o proprietário do serviço antes de ativar essa configuração. Por exemplo, para definir um valor de 30 segundos para essa flag, faça o seguinte: --grpc_keepalive_time=30s
--grpc_keepalive_timeout=<An immutable length of time.>
padrão: "20s"- Configura um tempo limite de keep-alive para conexões gRPC de saída. Se os pings de keep-alive estiverem ativados com --grpc_keepalive_time, o Bazel vai encerrar uma conexão se não receber uma resposta de ping após esse período. Os tempos são tratados como granularidade de segundo. É um erro definir um valor menor que um segundo. Se os pings de keep-alive estiverem desativados, essa configuração será ignorada.
--[no]incompatible_disable_non_executable_java_binary
padrão: "false"-
Se verdadeiro, java_binary é sempre executável. O atributo create_executable é removido.
Tags:loading_and_analysis
,incompatible_change
- Vários usos de
--inject_repository=<an equals-separated mapping of repository name to path>
são acumulados - Adiciona um novo repositório com um caminho local no formato <nome do repositório>=<caminho>. Isso só entra em vigor com --enable_bzlmod e é equivalente a adicionar um "local_repository" correspondente ao arquivo MODULE.bazel do módulo raiz usando "use_repo_rule". Se o caminho fornecido for absoluto, ele será usado como está. Se o caminho fornecido for relativo, ele será relativo ao diretório de trabalho atual. Se o caminho fornecido começar com "%workspace%", ele será relativo à raiz do espaço de trabalho, que é a saída de "bazel info workspace". Se o caminho fornecido estiver vazio, remova todas as injeções anteriores.
--invocation_id=<a UUID>
padrão: ""-
Identificador exclusivo, no formato UUID, do comando em execução. Se especificado explicitamente, a exclusividade precisa ser garantida pelo autor da chamada. O UUID é impresso no stderr, o BEP e o protocolo de execução remota.
Tags:bazel_monitoring
,bazel_internal_configuration
- Vários usos de
--override_repository=<an equals-separated mapping of repository name to path>
são acumulados - Substitua um repositório por um caminho local no formato <nome do repositório>=<caminho>. Se o caminho fornecido for absoluto, ele será usado como está. Se o caminho fornecido for relativo, ele será relativo ao diretório de trabalho atual. Se o caminho fornecido começar com "%workspace%", ele será relativo à raiz do espaço de trabalho, que é a saída de "bazel info workspace". Se o caminho fornecido estiver vazio, remova todas as substituições anteriores.
--[no]progress_in_terminal_title
padrão: "false"- Mostra o progresso do comando no título do terminal. Útil para saber o que o Bazel está fazendo quando há várias guias do terminal.
--[no]show_progress
padrão: "true"- Mostrar mensagens de progresso durante um build.
--show_progress_rate_limit=<a double>
padrão: "0.2"- Número mínimo de segundos entre as mensagens de progresso na saída.
--[no]show_timestamps
padrão: "false"- Incluir carimbos de data/hora nas mensagens
--tls_certificate=<a string>
padrão: consulte a descrição- Especifica um caminho para um certificado TLS confiável para assinar certificados do servidor.
--tls_client_certificate=<a string>
padrão: consulte a descrição- Especifique o certificado do cliente TLS a ser usado. Você também precisa fornecer uma chave de cliente para ativar a autenticação do cliente.
--tls_client_key=<a string>
padrão: consulte a descrição- Especifique a chave de cliente TLS a ser usada. Você também precisa fornecer um certificado de cliente para ativar a autenticação do cliente.
--ui_actions_shown=<an integer>
padrão: "8"-
Número de ações simultâneas mostradas na barra de progresso detalhada. Cada ação é mostrada em uma linha separada. A barra de progresso sempre mostra pelo menos um número, e todos os números menores que 1 são mapeados para 1.
Tags:terminal_output
--[no]watchfs
padrão: "false"- No Linux/macOS: se verdadeiro, o Bazel tenta usar o serviço de monitoramento de arquivos do sistema operacional para mudanças locais em vez de verificar cada arquivo para uma mudança. No Windows: essa flag atualmente não tem operação, mas pode ser ativada com --experimental_windows_watchfs. Em qualquer SO: o comportamento é indefinido se o espaço de trabalho estiver em um sistema de arquivos de rede e os arquivos forem editados em uma máquina remota.
Opções de análise de perfil
- Essa opção afeta a semântica da linguagem Starlark ou a API de build acessível a arquivos BUILD, .bzl ou WORKSPACE.:
--[no]incompatible_use_plus_in_repo_names
padrão: "true"-
Sem operação.
Tags:loading_and_analysis
- Opções que afetam a quantidade de detalhes, o formato ou o local do registro:
--dump=<text or raw>
[-d
] padrão: consulte a descrição-
exibe o despejo de dados do perfil completo em um formato legível por humanos ou bruto compatível com scripts.
Tags:bazel_monitoring
Opções de consulta
Herda todas as opções de build.
- Essa opção afeta a semântica da linguagem Starlark ou a API de build acessível a arquivos BUILD, .bzl ou WORKSPACE.:
--[no]incompatible_use_plus_in_repo_names
padrão: "true"-
No-op.
Tags:loading_and_analysis
- Opções relacionadas à saída da consulta e à semântica:
--aspect_deps=<off, conservative or precise>
padrão: "conservador"-
Como resolver dependências de aspecto quando o formato de saída é um dos valores {xml,proto,record}. "Desativado" significa que nenhuma dependência de aspecto é resolvida. "Conservador" (padrão) significa que todas as dependências de aspecto declaradas são adicionadas, independentemente de receberem a classe de regras de dependências diretas. "Precisa" significa que apenas os aspectos que estão possivelmente ativos são adicionados, considerando a classe de regras das dependências diretas. O modo preciso exige o carregamento de outros pacotes para avaliar um único destino, o que o torna mais lento do que os outros modos. Além disso, nem mesmo o modo preciso é totalmente preciso: a decisão de calcular um aspecto é tomada na fase de análise, que não é executada durante a "consulta do bazel".
Tags:build_file_semantics
--[no]consistent_labels
padrão: "false"-
Se ativado, cada comando de consulta emite rótulos como se fosse pela função <code>str</code> do Starlark aplicada a uma instância de <code>Label</code>. Isso é útil para ferramentas que precisam corresponder à saída de diferentes comandos de consulta e/ou rótulos emitidos por regras. Se não estiver ativado, os formatadores de saída poderão emitir nomes de repositório aparentes (relativos ao repositório principal) para tornar a saída mais legível.
Tags:terminal_output
--[no]experimental_explicit_aspects
padrão: "false"-
aquery, cquery: se as ações geradas pelo aspecto serão incluídas na saída. query: no-op (os aspectos são sempre seguidos).
Tags:terminal_output
--[no]graph:factored
padrão: "true"-
Se verdadeiro, o gráfico será emitido "fatorado", ou seja, os nós topologicamente equivalentes serão mesclados e os rótulos serão concatenados. Essa opção é válida apenas para --output=graph.
Tags:terminal_output
--graph:node_limit=<an integer>
padrão: "512"-
O comprimento máximo da string de rótulo de um nó de gráfico na saída. Rótulos mais longos serão truncados. O valor -1 significa que não há truncamento. Essa opção é válida apenas para --output=graph.
Tags:terminal_output
--[no]implicit_deps
padrão: "true"-
Se ativada, as dependências implícitas serão incluídas no gráfico de dependências em que a consulta opera. Uma dependência implícita não é especificada explicitamente no arquivo BUILD, mas é adicionada pelo Bazel. Para cquery, essa opção controla a filtragem de toolchains resolvidas.
Tags:build_file_semantics
--[no]include_artifacts
padrão: "true"-
Inclui nomes das entradas e saídas de ação na saída (potencialmente grande).
Tags:terminal_output
--[no]include_aspects
padrão: "true"-
aquery, cquery: se as ações geradas pelo aspecto serão incluídas na saída. query: no-op (os aspectos são sempre seguidos).
Tags:terminal_output
--[no]include_commandline
padrão: "true"-
Inclui o conteúdo das linhas de comando de ação na saída (potencialmente grande).
Tags:terminal_output
--[no]include_file_write_contents
padrão: "false"-
Inclua o conteúdo do arquivo para as ações FileWrite, SourceSymlinkManifest e RepoMappingManifest (potencialmente grandes).
Tags:terminal_output
--[no]include_param_files
padrão: "false"-
Inclui o conteúdo dos arquivos de parâmetro usados no comando (potencialmente grande). Observação: ativar essa flag ativa automaticamente a flag --include_commandline.
Tags:terminal_output
--[no]include_pruned_inputs
padrão: "true"-
Inclui entradas de ação que foram podadas durante a execução da ação. Só afeta ações que descobrem entradas e foram executadas em uma invocação anterior. Só entra em vigor se --include_artifacts também estiver definido.
Tags:terminal_output
--[no]incompatible_package_group_includes_double_slash
padrão: "true"-
Se ativado, ao gerar o atributo "packages" de package_group, o "//" inicial não será omitido.
Tags:terminal_output
,incompatible_change
--[no]infer_universe_scope
padrão: "false"-
Se definido e --universe_scope não for definido, um valor de --universe_scope será inferido como a lista de padrões de destino exclusivos na expressão da consulta. O valor --universe_scope inferido para uma expressão de consulta que usa funções com escopo de universo (por exemplo, "allrdeps") pode não ser o que você quer. Portanto, use essa opção somente se você souber o que está fazendo. Consulte https://bazel.build/reference/query#sky-query para conferir detalhes e exemplos. Se --universe_scope estiver definido, o valor dessa opção será ignorado. Observação: essa opção se aplica apenas a "query" (não a "cquery").
Tags:loading_and_analysis
--[no]line_terminator_null
padrão: "false"-
Define se cada formato é encerrado com \0 em vez de nova linha.
Tags:terminal_output
--[no]nodep_deps
padrão: "true"-
Se ativado, as dependências dos atributos "nodep" serão incluídas no gráfico de dependências em que a consulta opera. Um exemplo comum de um atributo "nodep" é "visibilidade". Execute e analise a saída de "info build-language" para saber mais sobre todos os atributos "nodep" na linguagem de build.
Tags:build_file_semantics
--output=<a string>
padrão: "text"-
O formato em que os resultados da consulta devem ser impressos. Os valores permitidos para aquery são: text, textproto, proto, streamed_proto, jsonproto.
Tags:terminal_output
--output_file=<a string>
padrão: ""-
Quando especificado, os resultados da consulta serão gravados diretamente nesse arquivo, e nada será impresso no stream de saída padrão (stdout) do Bazel. Em comparativos de mercado, isso geralmente é mais rápido do que <code>bazel query > file</code>.
Tags:terminal_output
--[no]proto:default_values
padrão: "true"-
Se verdadeiro, os atributos cujo valor não for especificado explicitamente no arquivo BUILD serão incluídos. Caso contrário, eles serão omitidos. Esta opção é aplicável a --output=proto
Tags:terminal_output
--[no]proto:definition_stack
padrão: "false"-
Preencha o campo proto definition_stack, que registra para cada instância de regra a pilha de chamadas do Starlark no momento em que a classe da regra foi definida.
Tags:terminal_output
--[no]proto:flatten_selects
padrão: "true"-
Se ativado, os atributos configuráveis criados por select() são achatados. Para tipos de lista, a representação simplificada é uma lista que contém cada valor do mapa selecionado exatamente uma vez. Os tipos escalares são achatados para nulos.
Tags:build_file_semantics
--[no]proto:include_attribute_source_aspects
padrão: "false"-
Preencha o campo proto de source_aspect_name de cada atributo com o aspecto de origem de onde o atributo veio (string vazia se não houver).
Tags:terminal_output
--[no]proto:include_starlark_rule_env
padrão: "true"-
Use o ambiente starlark no valor do atributo $internal_attr_hash gerado. Isso garante que a definição da regra do Starlark (e as importações transitivas dela) façam parte desse identificador.
Tags:terminal_output
--[no]proto:include_synthetic_attribute_hash
padrão: "false"-
Define se o atributo $internal_attr_hash será calculado e preenchido.
Tags:terminal_output
--[no]proto:instantiation_stack
padrão: "false"-
Preencha a pilha de chamadas de instanciação de cada regra. Isso requer que a pilha esteja presente
Tags:terminal_output
--[no]proto:locations
padrão: "true"-
Define se as informações de local serão enviadas na saída do proto.
Tags:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
padrão: "all"-
Lista separada por vírgulas de atributos a serem incluídos na saída. O padrão é todos os atributos. Defina como uma string vazia para não gerar nenhum atributo. Essa opção é válida para --output=proto.
Tags:terminal_output
--[no]proto:rule_classes
padrão: "false"-
Preencha o campo rule_class_key de cada regra. Para a primeira regra com uma rule_class_key específica, preencha também o campo rule_class_info proto. O campo rule_class_key identifica exclusivamente uma classe de regras, e o campo rule_class_info é uma definição de API da classe de regras no formato Stardoc.
Tags:terminal_output
--[no]proto:rule_inputs_and_outputs
padrão: "true"-
Define se os campos rule_input e rule_output são preenchidos ou não.
Tags:terminal_output
--query_file=<a string>
padrão: ""-
Se definido, a consulta vai ler a consulta do arquivo nomeado aqui, em vez da linha de comando. É um erro especificar um arquivo aqui e uma consulta de linha de comando.
Tags:changes_inputs
--[no]relative_locations
padrão: "false"-
Se verdadeiro, o local dos arquivos BUILD nas saídas XML e proto será relativo. Por padrão, a saída de localização é um caminho absoluto e não é consistente entre as máquinas. Defina essa opção como "true" para ter um resultado consistente em todas as máquinas.
Tags:terminal_output
--[no]skyframe_state
padrão: "false"-
Sem realizar análises extras, faça o descarte do Action Graph atual do Skyframe. Observação: no momento, não é possível especificar um destino com --skyframe_state. Essa flag só está disponível com --output=proto ou --output=textproto.
Tags:terminal_output
--[no]tool_deps
padrão: "true"
Consulta - : se desativado, as dependências de "exec configuration" não serão incluídas no gráfico de dependências em que a consulta opera. Uma aresta de dependência de "exec configuration", como a de qualquer regra "proto_library" para o compilador de protocolo, geralmente aponta para uma ferramenta executada durante o build em vez de uma parte do mesmo programa "target".
Cquery: se desativado, filtra todas as metas configuradas que cruzam uma transição de execução do destino de nível superior que descobriu essa meta configurada. Isso significa que, se o destino de nível superior estiver na configuração de destino, apenas os destinos configurados também na configuração de destino serão retornados. Se o destino de nível superior estiver na configuração de execução, apenas os destinos configurados de execução serão retornados. Essa opção NÃO exclui as cadeias de ferramentas resolvidas.
Tags:build_file_semantics
--universe_scope=<comma-separated list of options>
padrão: ""-
Um conjunto de padrões de destino (aditivos e subtrativos) separados por vírgulas. A consulta pode ser realizada no universo definido pela interseção transitiva das metas especificadas. Essa opção é usada para os comandos query e cquery.
Para a cquery, a entrada para essa opção é o alvo em que todas as respostas são criadas. Portanto, essa opção pode afetar as configurações e transições. Se essa opção não for especificada, os destinos de nível superior serão considerados os destinos analisados pela expressão de consulta. Observação: para cquery, não especificar essa opção pode causar a interrupção do build se os destinos analisados pela expressão de consulta não puderem ser criados com opções de nível superior.
Tags
:loading_and_analysis
- Opções que controlam a execução do build:
--[no]experimental_inprocess_symlink_creation
padrão: "true"-
Define se é possível fazer chamadas diretas do sistema de arquivos para criar árvores de links simbólicos em vez de delegar a um processo auxiliar.
Tags:loading_and_analysis
,execution
,experimental
--[no]experimental_persistent_aar_extractor
padrão: "false"-
Ative o extrator de aar persistente usando workers.
Tags:execution
,experimental
--[no]experimental_remotable_source_manifests
padrão: "false"-
Define se as ações de manifesto de origem podem ser remotas
Tags:loading_and_analysis
,execution
,experimental
--[no]experimental_split_coverage_postprocessing
padrão: "false"-
Se verdadeiro, o Bazel vai executar o pós-processamento de cobertura para teste em uma nova geração.
Tags:execution
,experimental
--[no]experimental_strict_fileset_output
padrão: "false"-
Se essa opção estiver ativada, os conjuntos de arquivos vão tratar todos os artefatos de saída como arquivos comuns. Eles não atravessam diretórios nem são sensíveis a links simbólicos.
Tags:execution
,experimental
--[no]incompatible_modify_execution_info_additive
padrão: "false"-
Quando ativada, a transmissão de várias flags --modify_execution_info é aditiva. Quando desativado, apenas a última flag é considerada.
Tags:execution
,affects_outputs
,loading_and_analysis
,incompatible_change
- Vários usos de
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
são acumulados -
Adiciona ou remove chaves das informações de execução de uma ação com base na mnemônica da ação. Aplicável apenas a ações que oferecem suporte a informações de execução. Muitas ações comuns oferecem suporte a informações de execução, por exemplo, Genrule, CppCompile, Javac, StarlarkAction e TestRunner. Ao especificar vários valores, a ordem é importante, porque muitas expressões regulares podem ser aplicadas ao mesmo mnemônico.
Sintaxe: "regex=[+-]chave,regex=[+-]chave,...".
Exemplos:
'.*=+x,.*=-y,.*=+z' adiciona "x" e "z" e remove "y" das informações de execução de todas as ações.
"Genrule=+requires-x" adiciona "requires-x" às informações de execução de todas as ações de Genrule.
'(?!Genrule).*=-requires-x' remove 'requires-x' das informações de execução de todas as ações que não são Genrule.
Tags:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Ative ações persistentes de dex e desugar do Android usando workers.
É expandido para:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Tags:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
-
Ative o processador de recursos Android persistente usando workers.
Expande para:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
--strategy=ProcessDatabinding=worker
--strategy=GenerateDataBindingBaseClasses=worker
Tags:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_dex_desugar
-
Ative ações persistentes de dex e desugar Android multiplexadas usando workers.
Expande para:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
Tags:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
Ative o processador de recursos Android multiplexado permanente usando workers.
Expande para:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
Tags:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_tools
-
Ative ferramentas Android persistentes e multiplexadas (dexing, desugaring, processamento de recursos).
É expandido para:
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Tags:host_machine_resource_optimizations
,execution
--[no]use_target_platform_for_tests
padrão: "false"-
Se verdadeiro, o Bazel vai usar a plataforma de destino para executar testes em vez do grupo de execução de teste.
Tags
:execution
- Opções que configuram a cadeia de ferramentas usada para a execução de ações:
--android_compiler=<a string>
padrão: consulte a descrição-
O compilador de destino do Android.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
padrão: "android"-
Seleciona a combinação de manifesto a ser usada para regras android_binary. Flag para ajudar na transição para a combinação de manifestos do Android da combinação legada.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_platforms=<a build target label>
padrão: ""-
Define as plataformas que os destinos android_binary usam. Se várias plataformas forem especificadas, o binário será um APK grande, que contém binários nativos para cada plataforma de destino especificada.
Tags:changes_inputs
,loading_and_analysis
,loses_incremental_state
--apple_crosstool_top=<a build target label>
padrão: "@bazel_tools//tools/cpp:toolchain"-
O rótulo do pacote de ferramentas cruzadas a ser usado nas regras da Apple e do Objc e nas dependências deles.
Tags:loses_incremental_state
,changes_inputs
--cc_output_directory_tag=<a string>
padrão: ""-
Especifica um sufixo a ser adicionado ao diretório de configuração.
Tags:affects_outputs
--compiler=<a string>
padrão: consulte a descrição-
O compilador C++ a ser usado para compilar o destino.
Tags:loading_and_analysis
,execution
--coverage_output_generator=<a build target label>
padrão: "@bazel_tools//tools/test:lcov_merger"-
Local do binário usado para pós-processar relatórios de cobertura brutos. No momento, ele precisa ser um grupo de arquivos que contém um único arquivo, o binário. O padrão é "//tools/test:lcov_merger".
Tags:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
padrão: "@bazel_tools//tools/test:coverage_report_generator"-
Local do binário usado para gerar relatórios de cobertura. No momento, ele precisa ser um grupo de arquivos que contém um único arquivo, o binário. O padrão é "//tools/test:coverage_report_generator".
Tags:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
padrão: "@bazel_tools//tools/test:coverage_support"-
Local dos arquivos de suporte necessários nas entradas de cada ação de teste que coleta a cobertura do código. O padrão é "//tools/test:coverage_support".
Tags:changes_inputs
,affects_outputs
,loading_and_analysis
--custom_malloc=<a build target label>
padrão: consulte a descrição-
Especifica uma implementação personalizada de malloc. Essa configuração substitui os atributos malloc nas regras de build.
Tags:changes_inputs
,affects_outputs
- Vários usos de
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
são acumulados -
Lista de expressões regulares separadas por vírgulas, cada uma opcionalmente prefixada por - (expressão negativa), atribuída a (=) a uma lista de destinos de valor de restrição separados por vírgulas. Se um destino corresponder a nenhuma expressão negativa e a pelo menos uma expressão positiva, a resolução da cadeia de ferramentas será realizada como se tivesse declarado os valores de restrição como restrições de execução. Exemplo: //demo,-test=@platforms//cpus:x86_64 vai adicionar "x86_64" a qualquer destino em //demo, exceto aqueles cujo nome contém "test".
Tags:loading_and_analysis
--[no]experimental_include_xcode_execution_requirements
padrão: "false"-
Se definido, adicione um requisito de execução "requires-xcode:{version}" a cada ação do Xcode. Se a versão do Xcode tiver um rótulo com hífen, adicione também um requisito de execução "requires-xcode-label:{version_label}".
Tags:loses_incremental_state
,loading_and_analysis
,execution
,experimental
--[no]experimental_prefer_mutual_xcode
padrão: "true"-
Se verdadeiro, use o Xcode mais recente disponível local e remotamente. Se for falso ou se não houver versões disponíveis em comum, use a versão local do Xcode selecionada pelo xcode-select.
Tags:loses_incremental_state
,experimental
--extra_execution_platforms=<comma-separated list of options>
padrão: ""-
As plataformas de execução disponíveis para executar ações. As plataformas podem ser especificadas por destino exato ou como um padrão de destino. Essas plataformas serão consideradas antes daquelas declaradas no arquivo WORKSPACE por register_execution_platforms(). Essa opção só pode ser definida uma vez. As instâncias posteriores vão substituir as configurações de sinalizações anteriores.
Tags:execution
- Vários usos de
--extra_toolchains=<comma-separated list of options>
são acumulados -
As regras do conjunto de ferramentas que serão consideradas durante a resolução do conjunto de ferramentas. As cadeias de ferramentas podem ser especificadas por destino exato ou como um padrão de destino. Esses conjuntos de ferramentas serão considerados antes dos declarados no arquivo WORKSPACE por register_toolchains().
Tags:affects_outputs
,changes_inputs
,loading_and_analysis
--grte_top=<a label>
padrão: consulte a descrição-
Um rótulo para uma biblioteca libc registrada. O valor padrão é selecionado pela cadeia de ferramentas de crosstool, e você quase nunca precisa substituí-lo.
Tags:action_command_lines
,affects_outputs
--host_compiler=<a string>
padrão: consulte a descrição-
Flag de no-op. Será removido em uma versão futura.
Tags:loading_and_analysis
,execution
--host_grte_top=<a label>
padrão: consulte a descrição-
Se especificado, essa configuração substitui o diretório de nível superior libc (--grte_top) para a configuração de execução.
Tags:action_command_lines
,affects_outputs
--host_platform=<a build target label>
padrão: "@bazel_tools//tools:host_platform"-
O rótulo de uma regra de plataforma que descreve o sistema de host.
Tags:affects_outputs
,changes_inputs
,loading_and_analysis
--[no]incompatible_bazel_test_exec_run_under
padrão: "false"-
Se ativado, "bazel test --run_under=//:runner" cria "//:runner" na configuração de execução. Se desativado, ele cria "//:runner" na configuração de destino. O Bazel executa testes em máquinas de execução, portanto, o primeiro é mais correto. Isso não afeta o "bazel run", que sempre gera "`--run_under=//foo" na configuração de destino.
Tags:affects_outputs
,incompatible_change
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
padrão: "true"-
Se verdadeiro, o Bazel não vai ativar os recursos "host" e "nonhost" na cadeia de ferramentas C++. Consulte https://github.com/bazelbuild/bazel/issues/7407 para mais informações.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_apple_toolchain_resolution
padrão: "false"-
Use a resolução do toolchain para selecionar o SDK da Apple para regras da Apple (Starlark e nativa)
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_legacy_whole_archive
padrão: "true"-
Se verdadeiro, o Bazel não vai vincular as dependências de biblioteca como um arquivo completo por padrão (consulte https://github.com/bazelbuild/bazel/issues/7362 para instruções de migração).
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_strip_executable_safely
padrão: "false"-
Se verdadeiro, a ação de remoção para executáveis vai usar a flag -x, que não interrompe a resolução de símbolos dinâmicos.
Tags:action_command_lines
,incompatible_change
-
Use objetos compartilhados de interface se o conjunto de ferramentas oferecer suporte a eles. Todas as cadeias de ferramentas ELF atualmente oferecem suporte a essa configuração.
Tags:loading_and_analysis
,affects_outputs
,affects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
Especifica a versão do SDK para iOS a ser usada para criar aplicativos iOS. Se não for especificado, vai usar a versão padrão do SDK para iOS de "xcode_version".
Tags:loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
Especifica a versão do SDK do macOS a ser usada para criar aplicativos do macOS. Se não for especificado, vai usar a versão padrão do SDK do macOS de "xcode_version".
Tags:loses_incremental_state
--minimum_os_version=<a string>
padrão: consulte a descrição-
A versão mínima do SO para a qual a compilação é direcionada.
Tags:loading_and_analysis
,affects_outputs
--platform_mappings=<a main workspace-relative path>
padrão: ""-
O local de um arquivo de mapeamento que descreve qual plataforma usar se nenhuma estiver definida ou quais flags definir quando uma plataforma já existir. Precisa ser relativo à raiz do espaço de trabalho principal. O padrão é "platform_mappings" (um arquivo diretamente na raiz do espaço de trabalho).
Tags:affects_outputs
,changes_inputs
,loading_and_analysis
,immutable
--platforms=<a build target label>
padrão: ""-
Os rótulos das regras da plataforma que descrevem as plataformas de destino do comando atual.
Tags:affects_outputs
,changes_inputs
,loading_and_analysis
--python_path=<a string>
padrão: consulte a descrição-
O caminho absoluto do interpretador de Python invocado para executar destinos do Python na plataforma de destino. Obsoleto. Desativado por --incompatible_use_python_toolchains.
Tags:loading_and_analysis
,affects_outputs
--python_top=<a build target label>
padrão: consulte a descrição-
O identificador de um py_runtime que representa o interpretador de Python invocado para executar destinos do Python na plataforma de destino. Obsoleto. Desativado por --incompatible_use_python_toolchains.
Tags:loading_and_analysis
,affects_outputs
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
Especifica a versão do SDK do tvOS a ser usada para criar aplicativos para tvOS. Se não for especificado, vai usar a versão padrão do SDK para tvOS de "xcode_version".
Tags:loses_incremental_state
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
Especifica a versão do SDK do watchOS a ser usada para criar aplicativos do watchOS. Se não for especificado, vai usar a versão padrão do SDK do watchOS de "xcode_version".
Tags:loses_incremental_state
--xcode_version=<a string>
padrão: consulte a descrição-
Se especificado, usa o Xcode da versão especificada para ações de build relevantes. Se não for especificado, vai usar a versão padrão do executor do Xcode.
Tags:loses_incremental_state
--xcode_version_config=<a build target label>
padrão: "@bazel_tools//tools/cpp:host_xcodes"-
O rótulo da regra xcode_config a ser usado para selecionar a versão do Xcode na configuração do build.
Tags
:loses_incremental_state
,loading_and_analysis
- Opções que controlam a saída do comando:
--[no]apple_generate_dsym
padrão: "false"-
Define se é necessário gerar arquivos de símbolo de depuração (.dSYM).
Tags:affects_outputs
,action_command_lines
--[no]build_runfile_links
padrão: "true"-
Se verdadeiro, cria florestas de links simbólicos de arquivos de execução para todos os destinos. Se for falso, grave-os somente quando for necessário por uma ação local, um comando de teste ou de execução.
Tags:affects_outputs
--[no]build_runfile_manifests
padrão: "true"-
Se verdadeiro, grava manifestos de runfiles para todos os destinos. Se for falso, omita-os. Os testes locais não serão executados quando for falso.
Tags:affects_outputs
--[no]build_test_dwp
padrão: "false"-
Se ativado, ao criar testes C++ de forma estática e com fissão, o arquivo .dwp do binário de teste também será criado automaticamente.
Tags:loading_and_analysis
,affects_outputs
--cc_proto_library_header_suffixes=<comma-separated set of options>
padrão: ".pb.h"-
Define os sufixos dos arquivos de cabeçalho que uma cc_proto_library cria.
Tags:affects_outputs
,loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated set of options>
padrão: ".pb.cc"-
Define os sufixos dos arquivos de origem que uma cc_proto_library cria.
Tags:affects_outputs
,loading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info
padrão: "false"-
Execute ações extras para versões alternativas de API Java em uma proto_library.
Tags:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_save_feature_state
padrão: "false"-
Salve o estado dos recursos ativados e solicitados como uma saída da compilação.
Tags:affects_outputs
,experimental
--fission=<a set of compilation modes>
padrão: "no"-
Especifica quais modos de compilação usam a divisão para compilações e links em C++. Pode ser qualquer combinação de {'fastbuild', 'dbg', 'opt'} ou os valores especiais 'yes' para ativar todos os modos e 'no' para desativar todos os modos.
Tags:loading_and_analysis
,action_command_lines
,affects_outputs
--[no]incompatible_always_include_files_in_data
padrão: "true"-
Se verdadeiro, as regras nativas adicionam <code>DefaultInfo.files</code> de dependências de dados aos runfiles, o que corresponde ao comportamento recomendado para regras do Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid).
Tags:affects_outputs
,incompatible_change
--[no]legacy_external_runfiles
padrão: "false"-
Se verdadeiro, crie florestas de links simbólicos de arquivos de execução para repositórios externos em .runfiles/wsname/external/repo (além de .runfiles/repo).
Tags:affects_outputs
--[no]objc_generate_linkmap
padrão: "false"-
Especifica se um arquivo de linkmap será gerado.
Tags:affects_outputs
--[no]save_temps
padrão: "false"-
Se definido, as saídas temporárias do gcc serão salvas. Isso inclui arquivos .s (código do assembler), .i (C pré-processado) e .ii (C++ pré-processado).
Tags
:affects_outputs
- Opções que permitem ao usuário configurar a saída pretendida, afetando o valor, em vez de sua existência:
- Vários usos de
--action_env=<a 'name=value' assignment with an optional value part>
são acumulados -
Especifica o conjunto de variáveis de ambiente disponível para ações com configuração de destino. As variáveis podem ser especificadas por nome, caso em que o valor será retirado do ambiente de invocação, ou pelo par name=value, que define o valor independente do ambiente de invocação. Essa opção pode ser usada várias vezes. Para opções fornecidas para a mesma variável, as mais recentes vencem, e as opções para variáveis diferentes são acumuladas.
Tags:action_command_lines
--allowed_cpu_values=<comma-separated set of options>
padrão: ""-
Valores permitidos para a flag --cpu.
Tags:changes_inputs
,affects_outputs
--[no]android_databinding_use_androidx
padrão: "true"-
Gera arquivos de vinculação de dados compatíveis com o AndroidX. É usado apenas com a vinculação de dados v2. Essa flag não tem efeito.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]android_databinding_use_v3_4_args
padrão: "true"-
Use o Databinding v2 do Android com o argumento 3.4.0. Essa flag não tem efeito.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--android_dynamic_mode=<off, default or fully>
padrão: "desativado"-
Determina se as dependências C++ das regras do Android serão vinculadas dinamicamente quando um cc_binary não criar explicitamente uma biblioteca compartilhada. "default" significa que o Bazel vai escolher se vai vincular dinamicamente. "totalmente" significa que todas as bibliotecas serão vinculadas dinamicamente. "off" significa que todas as bibliotecas serão vinculadas no modo quase estático.
Tags:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
padrão: "alphabetical"-
Define a ordem dos manifestos transmitidos para a combinação de manifestos para binários do Android. ALPHABETICAL significa que os manifestos são classificados por caminho em relação ao execroot. ALPHABETICAL_BY_CONFIGURATION significa que os manifestos são classificados por caminhos relativos ao diretório de configuração no diretório de saída. DEPENDENCY significa que os manifestos são ordenados com o manifesto de cada biblioteca antes dos manifestos das dependências.
Tags:action_command_lines
,execution
--[no]android_resource_shrinking
padrão: "false"-
Ativa a redução de recursos para APKs android_binary que usam o ProGuard.
Tags:affects_outputs
,loading_and_analysis
--[no]build_python_zip
padrão: "auto"-
Criar um zip executável do Python; ativado no Windows, desativado em outras plataformas
Tags:affects_outputs
- Vários usos de
--catalyst_cpus=<comma-separated list of options>
são acumulados -
Lista separada por vírgulas de arquiteturas para as quais criar binários do Apple Catalyst.
Tags:loses_incremental_state
,loading_and_analysis
--[no]collect_code_coverage
padrão: "false"-
Se especificado, o Bazel vai instrumentar o código (usando a instrumentação off-line sempre que possível) e coletar informações de cobertura durante os testes. Somente os destinos que correspondem a --instrumentation_filter serão afetados. Normalmente, essa opção não precisa ser especificada diretamente. Em vez disso, use o comando "bazel coverage".
Tags:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] padrão: "fastbuild"-
Especifica o modo em que o binário será criado. Valores: "fastbuild", "dbg", "opt".
Tags:affects_outputs
,action_command_lines
- Vários usos de
--conlyopt=<a string>
são acumulados -
Opção adicional para transmitir ao gcc ao compilar arquivos de origem C.
Tags:action_command_lines
,affects_outputs
- Vários usos de
--copt=<a string>
são acumulados -
Opções adicionais para transmitir ao gcc.
Tags:action_command_lines
,affects_outputs
--cpu=<a string>
padrão: ""-
A CPU de destino.
Tags:changes_inputs
,affects_outputs
--cs_fdo_absolute_path=<a string>
padrão: consulte a descrição-
Use as informações do perfil do CSFDO para otimizar a compilação. Especifique o nome do caminho absoluto do arquivo ZIP que contém o arquivo de perfil, um arquivo de perfil LLVM bruto ou indexado.
Tags:affects_outputs
--cs_fdo_instrument=<a string>
padrão: consulte a descrição-
Gera binários com instrumentação FDO sensível ao contexto. Com o compilador Clang/LLVM, ele também aceita o nome do diretório em que os arquivos de perfil brutos serão armazenados em disco no momento da execução.
Tags:affects_outputs
--cs_fdo_profile=<a build target label>
padrão: consulte a descrição-
O cs_fdo_profile representa o perfil sensível ao contexto a ser usado para otimização.
Tags:affects_outputs
- Vários usos de
--cxxopt=<a string>
são acumulados -
Opção extra para transmitir ao gcc ao compilar arquivos-fonte C++.
Tags:action_command_lines
,affects_outputs
- Vários usos de
--define=<a 'name=value' assignment>
são acumulados -
Cada opção --define especifica uma atribuição para uma variável de build. No caso de vários valores para uma variável, o último é o vencedor.
Tags:changes_inputs
,affects_outputs
--dynamic_mode=<off, default or fully>
padrão: "default"-
Determina se os binários C++ serão vinculados de forma dinâmica. "default" significa que o Bazel vai escolher se vai vincular dinamicamente. "totalmente" significa que todas as bibliotecas serão vinculadas dinamicamente. "off" significa que todas as bibliotecas serão vinculadas no modo quase estático.
Tags:loading_and_analysis
,affects_outputs
--[no]enable_propeller_optimize_absolute_paths
padrão: "true"-
Se definido, qualquer uso de caminhos absolutos para o propeller optimize vai gerar um erro.
Tags:affects_outputs
--[no]enable_remaining_fdo_absolute_paths
padrão: "true"-
Se definido, qualquer uso de caminhos absolutos para FDO vai gerar um erro.
Tags:affects_outputs
--[no]enable_runfiles
padrão: "auto"-
Ative a árvore de links simbólicos de runfiles. Por padrão, ela fica desativada no Windows e ativada em outras plataformas.
Tags:affects_outputs
- Vários usos de
--experimental_action_listener=<a build target label>
são acumulados -
foi descontinuado em favor de aspectos. Use action_listener para anexar uma extra_action às ações de build atuais.
Tags:execution
,experimental
--[no]experimental_android_compress_java_resources
padrão: "false"-
Compactar recursos Java em APKs
Tags:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_android_databinding_v2
padrão: "true"-
Use o Databinding v2 do Android. Essa flag não tem efeito.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_android_resource_shrinking
padrão: "false"-
Ativa a redução de recursos para APKs android_binary que usam o ProGuard.
Tags:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_android_rewrite_dexes_with_rex
padrão: "false"-
use a ferramenta rex para reescrever arquivos dex
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_collect_code_coverage_for_generated_files
padrão: "false"-
Se especificado, o Bazel também vai gerar informações de cobertura de coleta para arquivos gerados.
Tags:affects_outputs
,experimental
--experimental_objc_fastbuild_options=<comma-separated list of options>
padrão: "-O0,-DDEBUG=1"-
Usa essas strings como opções de compilador de build rápido do objc.
Tags:action_command_lines
--[no]experimental_omitfp
padrão: "false"-
Se verdadeiro, use libunwind para desfazer a pilha e compile com -fomit-frame-pointer e -fasynchronous-unwind-tables.
Tags:action_command_lines
,affects_outputs
,experimental
--experimental_output_paths=<off, content or strip>
padrão: "desativado"-
Qual modelo usar para onde as regras da árvore de saídas gravam as saídas, principalmente para builds multiplataforma / multiconfiguração. Esse recurso é altamente experimental. Consulte https://github.com/bazelbuild/bazel/issues/6526 para saber mais. As ações do Starlark podem optar pelo mapeamento de caminho adicionando a chave "supports-path-mapping" ao dicionário "execution_requirements".
Tags:loses_incremental_state
,bazel_internal_configuration
,affects_outputs
,execution
- Vários usos de
--experimental_override_name_platform_in_output_dir=<a 'label=value' assignment>
são acumulados -
Cada entrada precisa estar no formato rótulo=valor, em que "rótulo" se refere a uma plataforma e "valor" é o nome abreviado desejado para usar no caminho de saída. Só é usado quando --experimental_platform_in_output_dir é verdadeiro. Tem a maior prioridade de nomenclatura.
Tags:affects_outputs
,experimental
--[no]experimental_platform_in_output_dir
padrão: "false"-
Se verdadeiro, um nome abreviado para a plataforma de destino é usado no nome do diretório de saída em vez da CPU. O esquema exato é experimental e sujeito a mudanças: primeiro, no caso raro em que a opção --platforms não tem exatamente um valor, um hash da opção platforms é usado. Em seguida, se algum nome abreviado para a plataforma atual tiver sido registrado por --experimental_override_name_platform_in_output_dir, esse nome abreviado será usado. Em seguida, se --experimental_use_platforms_in_output_dir_legacy_heuristic estiver definido, use um nome abreviado com base no rótulo da plataforma atual. Por fim, um hash da opção de plataforma é usado como último recurso.
Tags:affects_outputs
,experimental
--[no]experimental_py_binaries_include_label
padrão: "false"-
Os destinos py_binary incluem o rótulo mesmo quando a marcação está desativada.
Tags:affects_outputs
,experimental
--[no]experimental_use_llvm_covmap
padrão: "false"-
Se especificado, o Bazel vai gerar informações do mapa de cobertura llvm-cov em vez de gcov quando o collect_code_coverage estiver ativado.
Tags:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic
padrão: "true"-
Use essa flag apenas como parte de uma estratégia de migração ou teste sugerida. A heurística tem deficiências conhecidas, e é recomendável migrar para usar apenas --experimental_override_name_platform_in_output_dir.
Tags:affects_outputs
,experimental
--fdo_instrument=<a string>
padrão: consulte a descrição-
Gera binários com instrumentação FDO. Com o compilador Clang/LLVM, ele também aceita o nome do diretório em que os arquivos de perfil brutos serão armazenados em disco no momento da execução.
Tags:affects_outputs
--fdo_optimize=<a string>
padrão: consulte a descrição-
Use informações do perfil de FDO para otimizar a compilação. Especifique o nome de um arquivo ZIP que contém uma árvore de arquivos .gcda, um arquivo afdo com um perfil automático ou um arquivo de perfil LLVM. Essa flag também aceita arquivos especificados como rótulos (por exemplo, "//foo/bar:file.afdo". Talvez seja necessário adicionar uma diretiva "exports_files" ao pacote correspondente) e rótulos que apontam para destinos "fdo_profile". Essa flag será substituída pela regra "fdo_profile".
Tags:affects_outputs
--fdo_prefetch_hints=<a build target label>
padrão: consulte a descrição-
Use dicas de pré-busca de cache.
Tags:affects_outputs
--fdo_profile=<a build target label>
padrão: consulte a descrição-
O fdo_profile que representa o perfil a ser usado para otimização.
Tags:affects_outputs
- Vários usos de
--features=<a string>
são acumulados -
Os recursos serão ativados ou desativados por padrão para destinos criados na configuração de destino. Especificar -<feature> desativa o recurso. Os recursos negativos sempre substituem os positivos. Consulte também as tags --host_features
:changes_inputs
,affects_outputs
--[no]force_pic
padrão: "false"-
Se ativado, todas as compilações C++ vão produzir código independente de posição ("-fPIC"), os links vão preferir bibliotecas pré-criadas PIC em vez de bibliotecas não-PIC, e os links vão produzir executáveis independentes de posição ("-pie").
Tags:loading_and_analysis
,affects_outputs
- Vários usos de
--host_action_env=<a 'name=value' assignment with an optional value part>
são acumulados -
Especifica o conjunto de variáveis de ambiente disponível para ações com configurações de execução. As variáveis podem ser especificadas por nome, caso em que o valor será retirado do ambiente de invocação, ou pelo par name=value, que define o valor independente do ambiente de invocação. Essa opção pode ser usada várias vezes. Para opções fornecidas para a mesma variável, as mais recentes vencem, e as opções para variáveis diferentes são acumuladas.
Tags:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
padrão: "opt"-
Especifica o modo em que as ferramentas usadas durante o build serão integradas. Valores: "fastbuild", "dbg", "opt".
Tags:affects_outputs
,action_command_lines
- Vários usos de
--host_conlyopt=<a string>
são acumulados -
Opção adicional para transmitir ao compilador C ao compilar arquivos-fonte C (mas não C++) nas configurações de execução.
Tags:action_command_lines
,affects_outputs
- Vários usos de
--host_copt=<a string>
são acumulados -
Opções adicionais para transmitir ao compilador C para ferramentas criadas nas configurações de execução.
Tags:action_command_lines
,affects_outputs
--host_cpu=<a string>
padrão: ""-
A CPU host.
Tags:changes_inputs
,affects_outputs
- Vários usos de
--host_cxxopt=<a string>
são acumulados -
Opções adicionais para transmitir ao compilador C++ para ferramentas criadas nas configurações de execução.
Tags:action_command_lines
,affects_outputs
- Vários usos de
--host_features=<a string>
são acumulados -
Os recursos especificados serão ativados ou desativados por padrão para os destinos criados na configuração de execução. Especificar -<feature> desativa o recurso. Os recursos negativos sempre substituem os positivos.
Tags:changes_inputs
,affects_outputs
--host_force_python=<PY2 or PY3>
padrão: consulte a descrição-
Substitui a versão do Python para a configuração de execução. Pode ser "PY2" ou "PY3".
Tags:loading_and_analysis
,affects_outputs
- Vários usos de
--host_linkopt=<a string>
são acumulados -
Opção adicional para transmitir ao vinculador ao vincular ferramentas nas configurações de execução.
Tags:action_command_lines
,affects_outputs
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
Versão mínima compatível do macOS para destinos do host. Se não for especificado, vai usar "macos_sdk_version".
Tags:loses_incremental_state
- Vários usos de
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
são acumulados -
Opções adicionais para transmitir seletivamente ao compilador C/C++ ao compilar determinados arquivos nas execuções de configuração. Essa opção pode ser transmitida várias vezes. Sintaxe: regex_filter@option_1,option_2,...,option_n. Em que regex_filter representa uma lista de padrões de expressão regular de inclusão e exclusão (consulte também --instrumentation_filter). option_1 a option_n representam opções arbitrárias de linha de comando. Se uma opção tiver uma vírgula, ela precisa ser colocada entre aspas com uma barra invertida. As opções podem conter @. Apenas o primeiro @ é usado para dividir a string. Exemplo: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 adiciona a opção de linha de comando -O0 à linha de comando do gcc de todos os arquivos cc em //foo/, exceto bar.cc.
Tags:action_command_lines
,affects_outputs
--[no]incompatible_auto_exec_groups
padrão: "false"-
Quando ativado, um grupo de execução é criado automaticamente para cada toolchain usado por uma regra. Para que isso funcione, a regra precisa especificar o parâmetro "toolchain" nas ações. Para mais informações, consulte https://github.com/bazelbuild/bazel/issues/17134.
Tags:affects_outputs
,incompatible_change
--[no]incompatible_merge_genfiles_directory
padrão: "true"-
Se verdadeiro, o diretório genfiles é dobrado no diretório bin.
Tags:affects_outputs
,incompatible_change
--[no]instrument_test_targets
padrão: "false"-
Quando a cobertura está ativada, especifica se é necessário considerar a instrumentação de regras de teste. Quando definido, as regras de teste incluídas por --instrumentation_filter são inspecionadas. Caso contrário, as regras de teste são sempre excluídas da instrumentação de cobertura.
Tags:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
padrão: "-/javatests[/:],-/test/java[/:]"-
Quando a cobertura está ativada, apenas as regras com nomes incluídos pelo filtro baseado em regex especificado são instrumentadas. As regras com o prefixo "-" são excluídas. Somente as regras que não são de teste são instrumentadas, a menos que --instrument_test_targets esteja ativado.
Tags:affects_outputs
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
Versão mínima compatível do iOS para simuladores e dispositivos de destino. Se não for especificado, vai usar "ios_sdk_version".
Tags:loses_incremental_state
- Vários usos de
--ios_multi_cpus=<comma-separated list of options>
são acumulados -
Lista separada por vírgulas de arquiteturas para criar um ios_application. O resultado é um binário universal que contém todas as arquiteturas especificadas.
Tags:loses_incremental_state
,loading_and_analysis
--[no]legacy_whole_archive
padrão: "true"-
Descontinuado, substituído por --incompatible_remove_legacy_whole_archive (consulte https://github.com/bazelbuild/bazel/issues/7362 para saber mais). Quando ativado, use --whole-archive para regras cc_binary que tenham linkshared=True e linkstatic=True ou '-static' em linkopts. Isso é apenas para compatibilidade com versões anteriores. Uma alternativa melhor é usar alwayslink=1 quando necessário.
Tags:action_command_lines
,affects_outputs
,deprecated
- Vários usos de
--linkopt=<a string>
são acumulados -
Opção adicional para transmitir ao gcc ao vincular.
Tags:action_command_lines
,affects_outputs
- Vários usos de
--ltobackendopt=<a string>
são acumulados -
Opção extra para passar para a etapa de back-end de LTO (em --features=thin_lto).
Tags:action_command_lines
,affects_outputs
- Vários usos de
--ltoindexopt=<a string>
são acumulados -
Opção extra para passar para a etapa de indexação de LTO (em --features=thin_lto).
Tags:action_command_lines
,affects_outputs
- Vários usos de
--macos_cpus=<comma-separated list of options>
são acumulados -
Lista separada por vírgulas de arquiteturas para as quais criar binários do Apple macOS.
Tags:loses_incremental_state
,loading_and_analysis
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
Versão mínima do macOS compatível para destinos. Se não for especificado, vai usar "macos_sdk_version".
Tags:loses_incremental_state
--memprof_profile=<a build target label>
padrão: consulte a descrição-
Use o perfil do memprof.
Tags:affects_outputs
--[no]objc_debug_with_GLIBCXX
padrão: "false"-
Se definido e o modo de compilação estiver definido como "dbg", defina GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC e GLIBCPP_CONCEPT_CHECKS.
Tags:action_command_lines
--[no]objc_enable_binary_stripping
padrão: "false"-
Define se o símbolo e o código morto serão removidos em binários vinculados. A remoção de binários será realizada se essa flag e --compilation_mode=opt forem especificados.
Tags:action_command_lines
- Vários usos de
--objccopt=<a string>
são acumulados -
Opções adicionais para transmitir ao gcc ao compilar arquivos de origem Objective-C/C++.
Tags:action_command_lines
- Vários usos de
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
são acumulados -
Opções adicionais para transmitir seletivamente ao gcc ao compilar determinados arquivos. Essa opção pode ser transmitida várias vezes. Sintaxe: regex_filter@option_1,option_2,...,option_n. Em que regex_filter representa uma lista de padrões de expressão regular de inclusão e exclusão (consulte também --instrumentation_filter). option_1 a option_n representam opções arbitrárias de linha de comando. Se uma opção tiver uma vírgula, ela precisa ser colocada entre aspas com uma barra invertida. As opções podem conter @. Apenas o primeiro @ é usado para dividir a string. Exemplo: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 adiciona a opção de linha de comando -O0 à linha de comando do gcc de todos os arquivos cc em //foo/, exceto bar.cc.
Tags:action_command_lines
,affects_outputs
- Vários usos de
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
são acumulados -
Opções adicionais para transmitir seletivamente para o back-end LTO (em --features=thin_lto) ao compilar determinados objetos de back-end. Essa opção pode ser transmitida várias vezes. Sintaxe: regex_filter@option_1,option_2,...,option_n. Em que regex_filter representa uma lista de padrões de expressão regular de inclusão e exclusão. option_1 a option_n representam opções arbitrárias de linha de comando. Se uma opção tiver uma vírgula, ela precisa ser colocada entre aspas com uma barra invertida. As opções podem conter @. Apenas o primeiro @ é usado para dividir a string. Exemplo: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 adiciona a opção de linha de comando -O0 à linha de comando do back-end de LTO de todos os arquivos em //foo/, exceto bar.o.
Tags:action_command_lines
,affects_outputs
--platform_suffix=<a string>
padrão: consulte a descrição-
Especifica um sufixo a ser adicionado ao diretório de configuração.
Tags:loses_incremental_state
,affects_outputs
,loading_and_analysis
--propeller_optimize=<a build target label>
padrão: consulte a descrição-
Use as informações do perfil do Propeller para otimizar o destino do build.Um perfil do Propeller precisa consistir em pelo menos um dos dois arquivos, um perfil cc e um perfil ld. Essa flag aceita um rótulo de build que precisa se referir aos arquivos de entrada do perfil do Propeller. Por exemplo, o arquivo BUILD que define o rótulo, em a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)Uma diretiva exports_files pode precisar ser adicionada ao pacote correspondente para que esses arquivos fiquem visíveis para o Bazel. A opção precisa ser usada como: --propeller_optimize=//a/b:propeller_profile
Tags:action_command_lines
,affects_outputs
--propeller_optimize_absolute_cc_profile=<a string>
padrão: consulte a descrição-
Nome do caminho absoluto do arquivo cc_profile para builds otimizados do Propeller.
Tags:affects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
padrão: consulte a descrição-
Nome de caminho absoluto do arquivo ld_profile para builds otimizados do Propeller.
Tags:affects_outputs
--run_under=<a prefix in front of command>
padrão: consulte a descrição-
Prefixo a ser inserido antes dos executáveis para os comandos "test" e "run". Se o valor for "foo -bar" e a linha de comando de execução for "test_binary -baz", a linha de comando final será "foo -bar test_binary -baz".Isso também pode ser um rótulo para um destino executável. Alguns exemplos são: "valgrind", "strace", "strace -c", "valgrind --quiet --num-callers=20", "//package:target", "//package:target --options".
Tags:action_command_lines
-
Se verdadeiro, as bibliotecas nativas que contêm funcionalidades idênticas serão compartilhadas entre diferentes destinos
Tags:loading_and_analysis
,affects_outputs
--[no]stamp
padrão: "false"-
Carimbo de dados binários com a data, o nome de usuário, o nome do host, as informações do espaço de trabalho etc.
Tags:affects_outputs
--strip=<always, sometimes or never>
padrão: "às vezes"-
Especifica se os binários e as bibliotecas compartilhadas serão removidos (usando "-Wl,--strip-debug"). O valor padrão de 'sometimes' significa remover iff --compilation_mode=fastbuild.
Tags:affects_outputs
- Vários usos de
--stripopt=<a string>
são acumulados -
Opções adicionais para transmitir a remoção ao gerar um binário '<name>.stripped'.
Tags:action_command_lines
,affects_outputs
- Vários usos de
--tvos_cpus=<comma-separated list of options>
são acumulados -
Lista separada por vírgulas de arquiteturas para as quais criar binários do Apple tvOS.
Tags:loses_incremental_state
,loading_and_analysis
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
Versão mínima compatível do tvOS para simuladores e dispositivos de destino. Se não for especificado, vai usar "tvos_sdk_version".
Tags:loses_incremental_state
- Vários usos de
--visionos_cpus=<comma-separated list of options>
são acumulados -
Lista separada por vírgulas de arquiteturas para as quais criar binários do Apple VisionOS.
Tags:loses_incremental_state
,loading_and_analysis
- Vários usos de
--watchos_cpus=<comma-separated list of options>
são acumulados -
Lista separada por vírgulas de arquiteturas para as quais criar binários do Apple watchOS.
Tags:loses_incremental_state
,loading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
Versão mínima do watchOS compatível para simuladores e dispositivos de destino. Se não for especificado, será usado "watchos_sdk_version".
Tags:loses_incremental_state
--xbinary_fdo=<a build target label>
padrão: consulte a descrição-
Use informações de perfil XbinaryFDO para otimizar a compilação. Especifica o nome do perfil de binário cruzado padrão. Quando a opção é usada com --fdo_instrument/--fdo_optimize/--fdo_profile, essas opções sempre prevalecem como se xbinary_fdo nunca fosse especificado.
Tags:affects_outputs
- Opções que afetam a forma como o Bazel aplica estritamente as entradas de build válidas (definições de regras, combinações de sinalizações etc.):
--[no]check_licenses
padrão: "false"-
Verifique se as restrições de licenciamento impostas por pacotes dependentes não entram em conflito com os modos de distribuição das metas que estão sendo criadas. Por padrão, as licenças não são verificadas.
Tags:build_file_semantics
--[no]check_visibility
padrão: "true"-
Se desativado, os erros de visibilidade em dependências de destino são rebaixados para avisos.
Tags:build_file_semantics
--[no]desugar_for_android
padrão: "true"-
Define se o bytecode Java 8 será simplificado antes da desindexação.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]desugar_java8_libs
padrão: "false"-
Define se as bibliotecas Java 8 com suporte vão ser incluídas em apps para dispositivos legados.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]enforce_constraints
padrão: "true"-
Verifica os ambientes com que cada destino é compatível e informa erros se algum destino tiver dependências que não oferecem suporte aos mesmos ambientes
Tags:build_file_semantics
--[no]experimental_check_desugar_deps
padrão: "true"-
Define se a dessugarização correta precisa ser verificada novamente no nível binário do Android.
Tags:eagerness_to_exit
,loading_and_analysis
,experimental
--experimental_import_deps_checking=<a string>
padrão: consulte a descrição-
Não tem operação, mantido apenas para compatibilidade com versões anteriores
Tags:loading_and_analysis
--experimental_one_version_enforcement=<off, warning or error>
padrão: "OFF"-
Quando ativada, essa regra garante que uma regra java_binary não possa conter mais de uma versão do mesmo arquivo de classe no classpath. Essa aplicação pode interromper o build ou apenas resultar em avisos.
Tags:loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
padrão: "default"-
Se verdadeiro, verifica se um destino Java declara explicitamente todos os destinos usados diretamente como dependências.
Tags:build_file_semantics
,eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files
padrão: "false"-
Se ativado, verifique se há destinos de pré-requisito que são arquivos de saída procurando o testonly da regra de geração. Isso corresponde à verificação de visibilidade.
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_check_visibility_for_toolchains
padrão: "false"-
Se ativada, a verificação de visibilidade também se aplica às implementações de cadeia de ferramentas.
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_disable_native_android_rules
padrão: "false"-
Se ativado, o uso direto das regras nativas do Android será desativado. Use as regras do Android do Starlark em https://github.com/bazelbuild/rules_android
Tags:eagerness_to_exit
,incompatible_change
--[no]incompatible_disable_native_apple_binary_rule
padrão: "false"-
Não há operação. Mantido aqui para compatibilidade com versões anteriores.
Tags:eagerness_to_exit
,incompatible_change
--[no]incompatible_python_disable_py2
padrão: "true"-
Se verdadeiro, o uso das configurações do Python 2 vai causar um erro. Isso inclui python_version=PY2, srcs_version=PY2 e srcs_version=PY2ONLY. Consulte https://github.com/bazelbuild/bazel/issues/15684 para mais informações.
Tags:loading_and_analysis
,incompatible_change
--[no]one_version_enforcement_on_java_tests
padrão: "true"-
Quando ativado e com experimental_one_version_enforcement definido como um valor diferente de NONE, aplique uma versão aos destinos de java_test. Essa flag pode ser desativada para melhorar o desempenho do teste incremental em detrimento de possíveis violações de uma versão.
Tags:loading_and_analysis
--python_native_rules_allowlist=<a build target label>
padrão: consulte a descrição-
Uma lista de permissões (alvo package_group) a ser usada ao aplicar --incompatible_python_disallow_native_rules.
Tags:loading_and_analysis
--[no]strict_filesets
padrão: "false"-
Se essa opção estiver ativada, os conjuntos de arquivos que cruzarem os limites do pacote serão informados como erros.
Tags:build_file_semantics
,eagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default>
padrão: "error"-
A menos que esteja DESLIGADO, verifica se um destino proto_library declara explicitamente todos os destinos usados diretamente como dependências.
Tags:build_file_semantics
,eagerness_to_exit
,incompatible_change
--strict_public_imports=<off, warn, error, strict or default>
padrão: "desativado"-
A menos que esteja DESATIVADO, verifica se um destino proto_library declara explicitamente todos os destinos usados em "import public" como exportados.
Tags:build_file_semantics
,eagerness_to_exit
,incompatible_change
--[no]strict_system_includes
padrão: "false"-
Se verdadeiro, os cabeçalhos encontrados nos caminhos de inclusão do sistema (-isystem) também precisam ser declarados.
Tags:loading_and_analysis
,eagerness_to_exit
- Vários usos de
--target_environment=<a build target label>
são acumulados -
Declara o ambiente de destino desse build. Precisa ser uma referência de rótulo para uma regra de "ambiente". Se especificado, todos os destinos de nível superior precisam ser compatíveis com esse ambiente.
Tags:changes_inputs
- Opções que afetam as saídas de assinatura de um build:
--apk_signing_method=<v1, v2, v1_v2 or v4>
padrão: "v1_v2"-
Implementação a ser usada para assinar APKs
Tags:action_command_lines
,affects_outputs
,loading_and_analysis
--[no]device_debug_entitlements
padrão: "true"-
Se definido e o modo de compilação não for "opt", os apps objc vão incluir direitos de depuração ao assinar.
Tags:changes_inputs
--ios_signing_cert_name=<a string>
padrão: consulte a descrição-
Nome do certificado a ser usado para assinatura do iOS. Se não for definido, o perfil de provisionamento será usado. Pode ser a preferência de identidade do chaveiro do certificado ou (substring) do nome comum do certificado, conforme a página de manual de codesign (IDENTIDADES DE ASSINATURA).
Tags:action_command_lines
- Essa opção afeta a semântica da linguagem Starlark ou a API de build acessível a arquivos BUILD, .bzl ou WORKSPACE.:
--[no]incompatible_disallow_legacy_py_provider
padrão: "true"-
Não é uma operação, será removido em breve.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_sdk_frameworks_attributes
padrão: "false"-
Se verdadeiro, não permita os atributos sdk_frameworks e weak_sdk_frameworks em objc_library e objc_import.
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_objc_alwayslink_by_default
padrão: "false"-
Se verdadeiro, defina o valor padrão como verdadeiro para os atributos alwayslink em objc_library e objc_import.
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_python_disallow_native_rules
padrão: "false"-
Quando verdadeiro, um erro ocorre ao usar as regras py_* integradas. Em vez disso, as regras rule_python precisam ser usadas. Consulte https://github.com/bazelbuild/bazel/issues/17773 para mais informações e instruções de migração.
Tags:loading_and_analysis
,incompatible_change
- Opções que governam o comportamento do ambiente de teste ou do executor de teste:
--[no]allow_analysis_failures
padrão: "false"-
Se verdadeiro, uma falha de análise de um destino de regra resulta na propagação do destino de uma instância de AnalysisFailureInfo contendo a descrição do erro, em vez de resultar em uma falha de build.
Tags:loading_and_analysis
,experimental
--analysis_testing_deps_limit=<an integer>
padrão: "2000"-
Define o número máximo de dependências transitivas usando um atributo de regra com uma transição de configuração for_analysis_testing. Exceder esse limite vai resultar em um erro de regra.
Tags:loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure
padrão: "false"-
Se verdadeiro, as falhas de ação dex2oat vão causar a interrupção do build em vez de executar dex2oat durante o tempo de execução do teste.
Tags:loading_and_analysis
,experimental
- Vários usos de
--default_test_resources=<a resource name followed by equal and 1 float or 4 float, e.g memory=10,30,60,100>
são acumulados - Substitua a quantidade de recursos padrão para testes. O formato esperado é <resource>=<value>. Se um único número positivo for especificado como <value>, ele vai substituir os recursos padrão para todos os tamanhos de teste. Se quatro números separados por vírgula forem especificados, eles vão substituir a quantidade de recursos para os tamanhos de teste pequeno, médio, grande e enorme, respectivamente. Os valores também podem ser HOST_RAM/HOST_CPU, seguidos opcionalmente por [-|*]<float> (por exemplo, memory=HOST_RAM*.1,HOST_RAM*.2,HOST_RAM*.3,HOST_RAM*.4). Os recursos de teste padrão especificados por essa flag são substituídos por recursos explícitos especificados em tags.
--[no]experimental_android_use_parallel_dex2oat
padrão: "false"-
Use dex2oat em paralelo para acelerar o android_test.
Tags:loading_and_analysis
,host_machine_resource_optimizations
,experimental
--[no]ios_memleaks
padrão: "false"-
Ativa a verificação de vazamentos de memória em destinos ios_test.
Tags:action_command_lines
--ios_simulator_device=<a string>
padrão: consulte a descrição-
O dispositivo a ser simulado ao executar um aplicativo iOS no simulador, por exemplo, "iPhone 6". Para conferir uma lista de dispositivos, execute "xcrun simctl list devicetypes" na máquina em que o simulador será executado.
Tags:test_runner
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
A versão do iOS a ser executada no simulador durante a execução ou o teste. Isso será ignorado para regras ios_test se um dispositivo de destino for especificado na regra.
Tags:test_runner
- Vários usos de
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
são acumulados - Especifica o número de vezes que cada teste será executado. Se uma dessas tentativas falhar por qualquer motivo, o teste inteiro será considerado reprovado. Normalmente, o valor especificado é apenas um número inteiro. Exemplo: --runs_per_test=3 vai executar todos os testes três vezes. Sintaxe alternativa: regex_filter@runs_per_test. Em que runs_per_test representa um valor inteiro e regex_filter representa uma lista de padrões de expressão regular de inclusão e exclusão. Consulte também --instrumentation_filter. Exemplo: --runs_per_test=//foo/.*,-//foo/bar/.*@3 executa todos os testes em //foo/, exceto aqueles em foo/bar três vezes. Essa opção pode ser transmitida várias vezes. O argumento mais recente transmitido que corresponde tem precedência. Se nada corresponder, o teste será executado apenas uma vez.
- Vários usos de
--test_env=<a 'name=value' assignment with an optional value part>
são acumulados -
Especifica variáveis de ambiente adicionais a serem injetadas no ambiente do executor de testes. As variáveis podem ser especificadas por nome, e nesse caso o valor delas será lido do ambiente do cliente do Bazel, ou pelo par nome=valor. Essa opção pode ser usada várias vezes para especificar várias variáveis. Usado apenas pelo comando "bazel test".
Tags:test_runner
--test_timeout=<a single integer or comma-separated list of 4 integers>
padrão: "-1"- Substitua os valores padrão de tempo limite de teste (em segundos). Se um único valor inteiro positivo for especificado, ele vai substituir todas as categorias. Se quatro números inteiros separados por vírgulas forem especificados, eles vão substituir os tempos limite para curto, moderado, longo e eterno (nessa ordem). Em qualquer forma, um valor de -1 instrui o Blaze a usar os tempos limite padrão para essa categoria.
--[no]zip_undeclared_test_outputs
padrão: "false"-
Se verdadeiro, as saídas de teste não declaradas serão arquivadas em um arquivo ZIP.
Tags:test_runner
- Opções que acionam otimizações do tempo de build:
--[no]experimental_filter_library_jar_with_program_jar
padrão: "false"-
Filtre o ProgramJar do ProGuard para remover todas as classes também presentes no LibraryJar.
Tags:action_command_lines
,experimental
--[no]experimental_inmemory_dotd_files
padrão: "true"-
Se ativada, os arquivos .d do C++ serão transmitidos na memória diretamente dos nós de build remotos em vez de serem gravados no disco.
Tags:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_inmemory_jdeps_files
padrão: "true"-
Se ativado, os arquivos de dependência (.jdeps) gerados a partir de compilações Java serão transmitidos na memória diretamente dos nós de build remotos em vez de serem gravados no disco.
Tags:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_retain_test_configuration_across_testonly
padrão: "false"-
Quando ativado, o --trim_test_configuration não vai cortar a configuração de teste para regras marcadas como testonly=1. Isso reduz os problemas de conflito de ação quando regras que não são de teste dependem de regras cc_test. Não tem efeito se --trim_test_configuration for falso.
Tags:loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_starlark_cc_import
padrão: "false"-
Se ativada, a versão do Starlark de cc_import poderá ser usada.
Tags:loading_and_analysis
,experimental
--[no]experimental_unsupported_and_brittle_include_scanning
padrão: "false"-
Define se as entradas serão restritas à compilação em C/C++ com a análise de linhas #include dos arquivos de entrada. Isso pode melhorar a performance e a incrementalidade, diminuindo o tamanho das árvores de entrada de compilação. No entanto, ele também pode interromper builds porque o scanner de inclusão não implementa totalmente a semântica do pré-processador C. Especificamente, ele não entende diretivas #include dinâmicas e ignora a lógica condicional do pré-processador. Use por sua conta e risco. Todos os problemas relacionados a essa sinalização serão encerrados.
Tags:loading_and_analysis
,execution
,changes_inputs
,experimental
--[no]incremental_dexing
padrão: "true"-
Realiza a maior parte do trabalho de desindexação separadamente para cada arquivo JAR.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]objc_use_dotd_pruning
padrão: "true"-
Se definido, os arquivos .d emitidos pelo clang serão usados para podar o conjunto de entradas transmitidas para as compilações objc.
Tags:changes_inputs
,loading_and_analysis
--[no]process_headers_in_dependencies
padrão: "false"-
Ao criar um destino //a:a, processe os cabeçalhos em todos os destinos de que //a:a depende (se o processamento de cabeçalhos estiver ativado para o conjunto de ferramentas).
Tags:execution
--[no]trim_test_configuration
padrão: "true"-
Quando ativada, as opções relacionadas ao teste são limpas abaixo do nível superior do build. Quando essa flag está ativa, os testes não podem ser criados como dependências de regras que não são de teste, mas as mudanças nas opções relacionadas ao teste não fazem com que as regras que não são de teste sejam analisadas novamente.
Tags
:loading_and_analysis
,loses_incremental_state
- Opções que afetam o nível de detalhamento, o formato ou o local de geração de registros:
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
padrão: "-.*"-
Mostra informações de depuração durante a resolução da cadeia de ferramentas. A flag usa uma regex, que é verificada em relação aos tipos de conjunto de ferramentas e destinos específicos para saber quais depurar. Vários regexes podem ser separados por vírgulas, e cada regex é verificado separadamente. Observação: a saída dessa flag é muito complexa e provavelmente só será útil para especialistas em resolução de cadeias de ferramentas.
Tags:terminal_output
- Opções que especificam ou alteram uma entrada genérica para um comando do Bazel que não se enquadra em outras categorias.:
- Vários usos de
--flag_alias=<a 'name=value' flag alias>
são acumulados -
Define um nome abreviado para uma flag do Starlark. Ele usa um único par de chave-valor no formato "<chave>=<valor>" como argumento.
Tags:changes_inputs
--[no]incompatible_default_to_explicit_init_py
padrão: "false"-
Essa flag muda o comportamento padrão para que os arquivos __init__.py não sejam mais criados automaticamente nos runfiles de destinos do Python. Mais precisamente, quando um destino py_binary ou py_test tem legacy_create_init definido como "auto" (padrão), ele é tratado como falso se e somente se essa flag estiver definida. Consulte https://github.com/bazelbuild/bazel/issues/10076.
Tags:affects_outputs
,incompatible_change
--[no]incompatible_py2_outputs_are_suffixed
padrão: "true"-
Se verdadeiro, os destinos criados na configuração do Python 2 vão aparecer em uma raiz de saída que inclui o sufixo "-py2", enquanto os destinos criados para o Python 3 vão aparecer em uma raiz sem sufixo relacionado ao Python. Isso significa que o link simbólico de conveniência "bazel-bin" vai apontar para destinos do Python 3 em vez do Python 2. Se você ativar essa opção, também será recomendável ativar `--incompatible_py3_is_default`.
Tags:affects_outputs
,incompatible_change
--[no]incompatible_py3_is_default
padrão: "true"-
Se verdadeiro, os destinos "py_binary" e "py_test" que não definem o atributo "python_version" (ou "default_python_version") vão assumir o valor padrão PY3 em vez de PY2. Se você definir essa flag, também será recomendável definir `--incompatible_py2_outputs_are_suffixed`.
Tags
:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_use_python_toolchains
padrão: "true"-
Se definido como "true", as regras executáveis nativas do Python vão usar o ambiente de execução especificado pelo conjunto de ferramentas do Python, em vez do ambiente de execução fornecido por flags legadas, como --python_top.
Tags:loading_and_analysis
,incompatible_change
--python_version=<PY2 or PY3>
padrão: consulte a descrição-
O modo de versão principal do Python, "PY2" ou "PY3". Essa flag é substituída por "py_binary" e "py_test" (mesmo que não especifiquem explicitamente uma versão). Portanto, geralmente não há motivos para fornecer essa flag.
Tags:loading_and_analysis
,affects_outputs
- Opções diversas, não categorizadas.:
--[no]cache_test_results
[-t
] padrão: "auto"- Se definido como "auto", o Bazel vai executar novamente um teste somente se: (1) o Bazel detectar mudanças no teste ou nas dependências dele, (2) o teste estiver marcado como externo, (3) várias execuções de teste tiverem sido solicitadas com --runs_per_test ou(4) o teste tiver falhado anteriormente. Se definido como "sim", o Bazel armazena em cache todos os resultados de teste, exceto os marcados como externos. Se definido como "no", o Bazel não armazena em cache nenhum resultado de teste.
--[no]experimental_cancel_concurrent_tests
padrão: "false"-
Se verdadeiro, o Blaze vai cancelar os testes em execução simultaneamente na primeira execução bem-sucedida. Isso só é útil em combinação com --runs_per_test_detects_flakes.
Tags:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_fetch_all_coverage_outputs
padrão: "false"-
Se verdadeiro, o Bazel busca o diretório de dados de cobertura inteiro para cada teste durante uma execução de cobertura.
Tags:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_generate_llvm_lcov
padrão: "false"-
Se verdadeiro, a cobertura do clang vai gerar um relatório LCOV.
Tags:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_j2objc_header_map
padrão: "true"-
Define se o mapa de cabeçalho J2ObjC será gerado em paralelo à transpilação J2ObjC.
Tags:experimental
--[no]experimental_j2objc_shorter_header_path
padrão: "false"-
Define se o caminho do cabeçalho será gerado com um caminho mais curto (usa "_ios" em vez de "_j2objc").
Tags:affects_outputs
,experimental
--experimental_java_classpath=<off, javabuilder or bazel>
padrão: "javabuilder"- Habilita caminhos de classe reduzidos para compilações Java.
--[no]experimental_limit_android_lint_to_android_constrained_java
padrão: "false"-
Não tem operação, mantido apenas para compatibilidade com versões anteriores
Tags:affects_outputs
,experimental
--[no]experimental_run_android_lint_on_java_rules
padrão: "false"-
Define se as fontes java_* precisam ser validadas.
Tags:affects_outputs
,experimental
--[no]explicit_java_test_deps
padrão: "false"- Especifique explicitamente uma dependência do JUnit ou do Hamcrest em um java_test em vez de acidentalmente extrair das dependências do TestRunner. No momento, só funciona com o Bazel.
--host_java_launcher=<a build target label>
padrão: consulte a descrição- O iniciador Java usado por ferramentas executadas durante um build.
- Vários usos de
--host_javacopt=<a string>
são acumulados - Opções adicionais para transmitir ao javac ao criar ferramentas que são executadas durante um build.
- Vários usos de
--host_jvmopt=<a string>
são acumulados - Opções adicionais para transmitir à VM Java ao criar ferramentas que são executadas durante o build. Essas opções serão adicionadas às opções de inicialização da VM de cada destino java_binary.
--[no]incompatible_check_sharding_support
padrão: "true"-
Se verdadeiro, o Bazel vai falhar em um teste fragmentado se o executor de teste não indicar que ele oferece suporte ao fragmentação tocando no arquivo no caminho em TEST_SHARD_STATUS_FILE. Se for falso, um executor de teste que não oferece suporte ao fragmentação vai fazer com que todos os testes sejam executados em cada fragmento.
Tags:incompatible_change
--[no]incompatible_exclusive_test_sandboxed
padrão: "true"-
Se verdadeiro, os testes exclusivos serão executados com a estratégia de sandbox. Adicionar a tag "local" para forçar a execução de um teste exclusivo localmente
Tags:incompatible_change
--[no]incompatible_strict_action_env
padrão: "false"-
Se verdadeiro, o Bazel usa um ambiente com um valor estático para PATH e não herda LD_LIBRARY_PATH. Use --action_env=ENV_VARIABLE se quiser herdar variáveis de ambiente específicas do cliente. No entanto, isso pode impedir o armazenamento em cache entre usuários se um cache compartilhado for usado.
Tags:loading_and_analysis
,incompatible_change
- Vários usos de
--j2objc_translation_flags=<comma-separated list of options>
são acumulados - Opções adicionais para transmitir à ferramenta J2ObjC.
--java_debug
-
Faz com que a máquina virtual Java de um teste Java aguarde uma conexão de um depurador compatível com JDWP (como o jdb) antes de iniciar o teste. Implica em -test_output=streamed.
É expandido para:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
--[no]java_deps
padrão: "true"- Gera informações de dependência (por enquanto, o classpath do tempo de compilação) por destino Java.
--[no]java_header_compilation
padrão: "true"- Compile ijars diretamente da fonte.
--java_language_version=<a string>
padrão: ""- A versão da linguagem Java
--java_launcher=<a build target label>
padrão: consulte a descrição- O iniciador Java a ser usado ao criar binários Java. Se essa flag for definida como a string vazia, o iniciador do JDK será usado. O atributo "launcher" substitui essa flag.
--java_runtime_version=<a string>
padrão: "local_jdk"- A versão do ambiente de execução Java
- Vários usos de
--javacopt=<a string>
são acumulados - Outras opções para transmitir ao javac.
- Vários usos de
--jvmopt=<a string>
são acumulados - Outras opções para transmitir à VM Java. Essas opções serão adicionadas às opções de inicialização da VM de cada destino java_binary.
--legacy_main_dex_list_generator=<a build target label>
padrão: consulte a descrição- Especifica um binário a ser usado para gerar a lista de classes que precisam estar no dex principal ao compilar o multidex legado.
--optimizing_dexer=<a build target label>
padrão: consulte a descrição- Especifica um binário a ser usado para fazer a dexação sem fragmentação.
- Vários usos de
--plugin=<a build target label>
são acumulados - Plug-ins para usar no build. Atualmente funciona com java_plugin.
--proguard_top=<a build target label>
padrão: consulte a descrição- Especifica qual versão do ProGuard usar para a remoção de código ao criar um binário Java.
--proto_compiler=<a build target label>
padrão: "@bazel_tools//tools/proto:protoc"-
O rótulo do protocompilador.
Tags:affects_outputs
,loading_and_analysis
--[no]proto_profile
padrão: "true"-
Define se o profile_path será transmitido para o compilador proto.
Tags:affects_outputs
,loading_and_analysis
--proto_profile_path=<a build target label>
padrão: consulte a descrição-
O perfil a ser transmitido ao compilador proto como profile_path. Se não for definido, mas --proto_profile for verdadeiro (padrão), o caminho será inferido de --fdo_optimize.
Tags:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
padrão: "@bazel_tools//tools/proto:cc_toolchain"-
Rótulo de proto_lang_toolchain() que descreve como compilar protos C++
Tags:affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
padrão: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"-
Rótulo de proto_lang_toolchain() que descreve como compilar protos j2objc
Tags:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
padrão: "@bazel_tools//tools/proto:java_toolchain"-
Rótulo de proto_lang_toolchain() que descreve como compilar protos Java
Tags:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
padrão: "@bazel_tools//tools/proto:javalite_toolchain"-
Rótulo de proto_lang_toolchain() que descreve como compilar protos JavaLite
Tags:affects_outputs
,loading_and_analysis
- Vários usos de
--protocopt=<a string>
são acumulados -
Opções adicionais para transmitir ao compilador protobuf.
Tags:affects_outputs
--[no]runs_per_test_detects_flakes
padrão: "false"- Se verdadeiro, qualquer fragmento em que pelo menos uma execução/tentativa é bem-sucedida e pelo menos uma falha recebe o status FLAKY.
--shell_executable=<a path>
padrão: consulte a descrição-
Caminho absoluto para o executável do shell que o Bazel vai usar. Se ela não estiver definida, mas a variável de ambiente BAZEL_SH estiver definida na primeira invocação do Bazel (que inicia um servidor do Bazel), o Bazel vai usar essa variável. Se nenhum deles estiver definido, o Bazel vai usar um caminho padrão codificado por hard-code dependendo do sistema operacional em que ele é executado (Windows: c:/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, todos os outros: /bin/bash). O uso de um shell que não é compatível com o bash pode levar a falhas de build ou de execução dos binários gerados.
Tags:loading_and_analysis
- Vários usos de
--test_arg=<a string>
são acumulados - Especifica opções e argumentos adicionais que precisam ser transmitidos para o executável de teste. Pode ser usado várias vezes para especificar vários argumentos. Se vários testes forem executados, cada um deles vai receber argumentos idênticos. Usado apenas pelo comando "bazel test".
--test_filter=<a string>
padrão: consulte a descrição- Especifica um filtro para encaminhar ao framework de teste. Usado para limitar a execução dos testes. Isso não afeta quais metas são criadas.
--test_result_expiration=<an integer>
padrão: "-1"- Esta opção foi descontinuada e não tem efeito.
--[no]test_runner_fail_fast
padrão: "false"- Encaminha a opção de falha rápida para o executor de teste. O executor de teste precisa interromper a execução na primeira falha.
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>
padrão: "explicit"- Especifique a estratégia para o fragmentação de teste: "explicit" para usar a fragmentação apenas se o atributo BUILD "shard_count" estiver presente. "desativado" para nunca usar a fragmentação de testes. "forced=k" para aplicar os fragmentos "k" para testes, independentemente do atributo BUILD "shard_count".
--tool_java_language_version=<a string>
padrão: ""- A versão da linguagem Java usada para executar as ferramentas necessárias durante um build
--tool_java_runtime_version=<a string>
padrão: "remotejdk_11"- A versão do ambiente de execução do Java usada para executar ferramentas durante o build
--[no]use_ijars
padrão: "true"- Se ativada, essa opção faz com que a compilação Java use jars de interface. Isso vai resultar em uma compilação incremental mais rápida, mas as mensagens de erro podem ser diferentes.
Opções de build
- Opções que controlam a execução do build:
--[no]check_up_to_date
padrão: "false"-
Não execute o build, apenas verifique se ele está atualizado. Se todos os destinos estiverem atualizados, o build será concluído. Se alguma etapa precisar ser executada, um erro será relatado e o build falhará.
Tags:execution
--dynamic_local_execution_delay=<an integer>
padrão: "1000"-
Quantos milissegundos a execução local precisa ser atrasada se a execução remota foi mais rápida durante um build pelo menos uma vez?
Tags:execution
,host_machine_resource_optimizations
- Vários usos de
--dynamic_local_strategy=<a '[name=]value1[,..,valueN]' assignment>
são acumulados -
As estratégias locais, em ordem, a serem usadas para a mnemônica especificada. A primeira estratégia aplicável é usada. Por exemplo, "worker,sandboxed" executa ações que oferecem suporte a workers persistentes usando a estratégia de worker e todos os outros usando a estratégia sandbox. Se nenhum mnemônico for fornecido, a lista de estratégias será usada como substituto para todos os mnemônicos. A lista de substituição padrão é "worker,sandboxed" ou "worker,sandboxed,standalone" se "experimental_local_lockfree_output" estiver definida. Recebe [mnemonic=]local_strategy[,local_strategy,...]
Tags:execution
,host_machine_resource_optimizations
- Vários usos de
--dynamic_remote_strategy=<a '[name=]value1[,..,valueN]' assignment>
são acumulados -
As estratégias remotas, em ordem, a serem usadas para a mnemônica especificada. A primeira estratégia aplicável é usada. Se nenhum mnemônico for fornecido, a lista de estratégias será usada como substituto para todos os mnemônicos. A lista de substituição padrão é "remote", então essa flag geralmente não precisa ser definida explicitamente. Recebe [mnemonic=]remote_strategy[,remote_strategy,...]
Tags:execution
,host_machine_resource_optimizations
--experimental_docker_image=<a string>
padrão: ""-
Especifique um nome de imagem do Docker (por exemplo, "ubuntu:latest") que será usado para executar uma ação em sandbox ao usar a estratégia do Docker e a ação não tiver um atributo de imagem de contêiner nas propriedades de execução remota na descrição da plataforma. O valor dessa flag é transmitido literalmente para "docker run", então ele oferece suporte à mesma sintaxe e mecanismos do Docker.
Tags:execution
--[no]experimental_docker_use_customized_images
padrão: "true"-
Se ativado, injeta o uid e o gid do usuário atual na imagem do Docker antes de usá-la. Isso é necessário se o build / testes dependerem de um nome e diretório inicial do usuário dentro do contêiner. Essa opção fica ativada por padrão, mas pode ser desativada caso o recurso de personalização automática de imagens não funcione no seu caso ou se você souber que não precisa dele.
Tags:execution
--[no]experimental_dynamic_exclude_tools
padrão: "true"-
Quando definido, os destinos criados "para ferramenta" não estão sujeitos à execução dinâmica. É muito improvável que esses destinos sejam criados de forma incremental e, portanto, não vale a pena gastar ciclos locais neles.
Tags:execution
,host_machine_resource_optimizations
--experimental_dynamic_local_load_factor=<a double>
padrão: "0"-
Controla a quantidade de carga da execução dinâmica a ser colocada na máquina local. Essa flag ajusta quantas ações em execução dinâmica serão programadas simultaneamente. Ele é baseado no número de CPUs que o Blaze considera disponíveis, que podem ser controlados com a flag --local_cpu_resources.
Se essa flag for 0, todas as ações serão programadas localmente imediatamente. Se for maior que 0, a quantidade de ações programadas localmente será limitada pelo número de CPUs disponíveis. Se for < 1, o fator de carga será usado para reduzir o número de ações programadas localmente quando o número de ações aguardando programação for alto. Isso diminui a carga na máquina local no caso de build limpo, em que a máquina local não contribui muito.
Tags:execution
,host_machine_resource_optimizations
--experimental_dynamic_slow_remote_time=<An immutable length of time.>
padrão: "0"-
Se for >0, o tempo que uma ação executada dinamicamente precisa ser executada apenas remotamente antes de priorizar a execução local para evitar timeouts remotos. Isso pode ocultar alguns problemas no sistema de execução remota. Não ative essa opção sem monitorar problemas de execução remota.
Tags:execution
,host_machine_resource_optimizations
--[no]experimental_enable_docker_sandbox
padrão: "false"-
Ative o sandboxing baseado em Docker. Essa opção não tem efeito se o Docker não estiver instalado.
Tags:execution
--[no]experimental_inmemory_sandbox_stashes
padrão: "false"-
Se definido como verdadeiro, o conteúdo das sandboxes armazenadas para reuse_sandbox_directories será rastreado na memória. Isso reduz a quantidade de E/S necessária durante a reutilização. Dependendo do build, essa flag pode melhorar o tempo de parede. Dependendo do build, essa flag pode usar uma quantidade significativa de memória adicional.
Tags:host_machine_resource_optimizations
,execution
--experimental_sandbox_async_tree_delete_idle_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
padrão: "4"-
Se 0, as árvores de sandbox são excluídas assim que uma ação é concluída, causando o atraso da conclusão da ação. Se for maior que zero, execute a exclusão desses três em um pool de linhas de execução assíncrono que tenha o tamanho 1 quando o build estiver em execução e cresça para o tamanho especificado por essa flag quando o servidor estiver ocioso.
Tags:host_machine_resource_optimizations
,execution
--experimental_sandbox_enforce_resources_regexp=<a valid Java regular expression>
padrão: ""-
Se verdadeiro, as ações com mnemônico que correspondem à regex de entrada terão a solicitação de recursos aplicada como limites, substituindo o valor de --experimental_sandbox_limits, se o tipo de recurso permitir. Por exemplo, um teste que declara cpu:3 e resources:memory:10 será executado com no máximo 3 CPUs e 10 megabytes de memória.
Tags:execution
- Vários usos de
--experimental_sandbox_limits=<a named double, 'name=value', where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
são acumulados -
Se for > 0, cada sandbox do Linux será limitado à quantidade indicada para o recurso especificado. Requer --incompatible_use_new_cgroup_implementation e substitui --experimental_sandbox_memory_limit_mb. Requer cgroups v1 ou v2 e permissões para os usuários no diretório cgroups.
Tags:execution
--experimental_sandbox_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
padrão: "0"-
Se for > 0, cada sandbox do Linux será limitado à quantidade de memória especificada (em MB). Requer cgroups v1 ou v2 e permissões para os usuários no diretório cgroups.
Tags:execution
--[no]experimental_shrink_worker_pool
padrão: "false"-
Se ativado, pode reduzir o pool de workers se a pressão da memória do worker for alta. Essa flag só funciona quando a flag experimental_total_worker_memory_limit_mb está ativada.
Tags:execution
,host_machine_resource_optimizations
--[no]experimental_split_xml_generation
padrão: "true"-
Se essa flag estiver definida e uma ação de teste não gerar um arquivo test.xml, o Bazel usará uma ação separada para gerar um arquivo test.xml fictício contendo o registro de teste. Caso contrário, o Bazel gera um test.xml como parte da ação de teste.
Tags:execution
--experimental_total_worker_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
padrão: "0"-
Se esse limite for maior que zero, os workers ociosos poderão ser encerrados se o uso total de memória de todos os workers exceder o limite.
Tags:execution
,host_machine_resource_optimizations
--[no]experimental_use_hermetic_linux_sandbox
padrão: "false"-
Se definido como verdadeiro, não monte a raiz, apenas monte o que é fornecido com sandbox_add_mount_pair. Os arquivos de entrada vão ser vinculados ao sandbox em vez de vinculados por link simbólico. Se os arquivos de entrada de ação estiverem em um sistema de arquivos diferente do sandbox, eles serão copiados.
Tags:execution
--[no]experimental_use_semaphore_for_jobs
padrão: "true"-
Se definido como "true", use também o semáforo para limitar o número de jobs simultâneos.
Tags:host_machine_resource_optimizations
,execution
--[no]experimental_use_windows_sandbox
padrão: "false"-
Use o sandbox do Windows para executar ações. Se a resposta for "sim", o binário fornecido por --experimental_windows_sandbox_path precisa ser válido e corresponder a uma versão com suporte do sandboxfs. Se for "auto", o binário pode estar ausente ou não ser compatível.
Tags:execution
--experimental_windows_sandbox_path=<a string>
padrão: "BazelSandbox.exe"-
Caminho para o binário do sandbox do Windows a ser usado quando --experimental_use_windows_sandbox for verdadeiro. Se for um nome simples, use o primeiro binário desse nome encontrado no PATH.
Tags:execution
--experimental_worker_allowlist=<comma-separated set of options>
padrão: consulte a descrição-
Se não estiver vazio, permita apenas o uso de workers persistentes com a mnemônica da chave do worker fornecida.
Tags:execution
,host_machine_resource_optimizations
--[no]experimental_worker_cancellation
padrão: "false"-
Se ativada, o Bazel poderá enviar solicitações de cancelamento para os trabalhadores que oferecem suporte a ela.
Tags:execution
--experimental_worker_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
padrão: "0"-
Se esse limite for maior que zero, os workers poderão ser encerrados se o uso de memória do worker exceder o limite. Se não for usado com a execução dinâmica e `--experimental_dynamic_ignore_local_signals=9`, isso poderá causar falhas no build.
Tags:execution
,host_machine_resource_optimizations
--experimental_worker_metrics_poll_interval=<An immutable length of time.>
padrão: "5s"-
O intervalo entre a coleta de métricas do worker e a tentativa de expulsão. Não pode ser menor que 1 segundo por motivos de desempenho.
Tags:execution
,host_machine_resource_optimizations
--[no]experimental_worker_multiplex_sandboxing
padrão: "false"-
Se ativado, os workers multiplexados com um requisito de execução "supports-multiplex-sandboxing" serão executados em um ambiente de sandbox, usando um diretório de sandbox separado por solicitação de trabalho. Os workers multiplexados com o requisito de execução são sempre colocados em sandbox quando executados com a estratégia de execução dinâmica, independentemente dessa flag.
Tags:execution
--[no]experimental_worker_sandbox_hardening
padrão: "false"-
Se ativado, os workers são executados em um sandbox reforçado, se a implementação permitir. Se o aumento de proteção estiver ativado, os diretórios tmp serão distintos para workers diferentes.
Tags:execution
- Vários usos de
--experimental_worker_sandbox_inmemory_tracking=<a string>
são acumulados -
Uma mnemônica de chave de worker para a qual o conteúdo do diretório do sandbox é rastreado na memória. Isso pode melhorar o desempenho do build ao custo de mais uso de memória. Afetará apenas workers em sandbox. Pode ser especificado várias vezes para mnemônicos diferentes.
Tags:execution
--[no]experimental_worker_strict_flagfiles
padrão: "false"-
Se ativado, os argumentos de ações para workers que não seguem a especificação do worker vão causar um erro. Os argumentos do worker precisam ter exatamente um argumento @flagfile como o último da lista de argumentos.
Tags:execution
--genrule_strategy=<comma-separated list of options>
padrão: ""-
Especifica como executar o genrules. Essa flag será descontinuada. Em vez disso, use --spawn_strategy=<value> para controlar todas as ações ou --strategy=Genrule=<value> para controlar apenas as regras de geração.
Tags:execution
--[no]incompatible_sandbox_hermetic_tmp
padrão: "true"-
Se definido como "true", cada sandbox do Linux terá o próprio diretório vazio dedicado montado como /tmp em vez de compartilhar /tmp com o sistema de arquivos do host. Use --sandbox_add_mount_pair=/tmp para continuar vendo o /tmp do host em todos os sandboxes.
Tags:execution
--[no]incompatible_use_new_cgroup_implementation
padrão: "false"-
Se verdadeiro, use a nova implementação para cgroups. A implementação antiga só oferece suporte ao controlador de memória e ignora o valor de --experimental_sandbox_limits.
Tags:execution
--[no]internal_spawn_scheduler
padrão: "true"-
Opção de marcador de posição para que possamos informar no Blaze se o programador de criação foi ativado.
Tags: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
] padrão: "auto"-
O número de jobs simultâneos a serem executados. Recebe um número inteiro ou uma palavra-chave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida por uma operação ([-|*]<float>), por exemplo. "auto", "HOST_CPUS*.5". Os valores precisam estar entre 1 e 5.000. Valores acima de 2.500 podem causar problemas de memória. "auto" calcula um padrão razoável com base nos recursos do host.
Tags:host_machine_resource_optimizations
,execution
--[no]keep_going
[-k
] padrão: "false"-
Continue o máximo possível após um erro. Embora a meta que falhou e as que dependem dela não possam ser analisadas, outros pré-requisitos dessas metas podem ser.
Tags: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">
padrão: "auto"-
Número de linhas de execução paralelas a serem usadas na fase de carregamento/análise.Recebe um número inteiro ou uma palavra-chave ("auto", "HOST_CPUS", "HOST_RAM"), seguida opcionalmente por uma operação ([-|*]<float>), por exemplo. "auto", "HOST_CPUS*.5". "auto" define um padrão razoável com base nos recursos do host. Precisa ser pelo menos 1.
Tags:bazel_internal_configuration
--[no]reuse_sandbox_directories
padrão: "true"-
Se definido como "true", os diretórios usados pela execução não do worker em sandbox podem ser reutilizados para evitar custos de configuração desnecessários.
Tags:host_machine_resource_optimizations
,execution
--sandbox_base=<a string>
padrão: ""-
Permite que o sandbox crie os diretórios dele abaixo desse caminho. Especifique um caminho em tmpfs (como /run/shm) para melhorar bastante o desempenho quando o build / testes tiver muitos arquivos de entrada. Observação: é necessário ter RAM e espaço livre suficientes no tmpfs para armazenar arquivos de saída e intermediários gerados por ações em execução.
Tags:host_machine_resource_optimizations
,execution
--[no]sandbox_explicit_pseudoterminal
padrão: "false"-
Ative explicitamente a criação de pseudoterminais para ações em sandbox. Algumas distribuições do Linux exigem que o ID do grupo do processo seja definido como "tty" dentro do sandbox para que os pseudoterminais funcionem. Se isso estiver causando problemas, essa flag pode ser desativada para permitir que outros grupos sejam usados.
Tags:execution
- Vários usos de
--sandbox_tmpfs_path=<an absolute path>
são acumulados -
Para ações em sandbox, monte um diretório vazio e gravável neste caminho absoluto (se for aceito pela implementação do sandbox, será ignorado).
Tags:host_machine_resource_optimizations
,execution
--[no]skip_incompatible_explicit_targets
padrão: "false"-
Ignora destinos incompatíveis listados explicitamente na linha de comando. Por padrão, a criação de tais destinos resulta em um erro, mas eles são ignorados silenciosamente quando essa opção está ativada. Consulte: https://bazel.build/extending/platforms#skipping-incompatible-targets
Tags:loading_and_analysis
--spawn_strategy=<comma-separated list of options>
padrão: ""-
Especifique como as ações de geração são executadas por padrão. Aceita uma lista separada por vírgulas de estratégias da prioridade mais alta para a mais baixa. Para cada ação, o Bazel escolhe a estratégia com a maior prioridade que pode executar a ação. O valor padrão é "remote,worker,sandboxed,local". Consulte https://blog.bazel.build/2019/06/19/list-strategy.html para mais detalhes.
Tags:execution
- Vários usos de
--strategy=<a '[name=]value1[,..,valueN]' assignment>
são acumulados -
Especifica como distribuir a compilação de outras ações de criação. Aceita uma lista separada por vírgulas de estratégias da prioridade mais alta para a mais baixa. Para cada ação, o Bazel escolhe a estratégia com a maior prioridade que pode executar a ação. O valor padrão é "remote,worker,sandboxed,local". Essa flag substitui os valores definidos por --spawn_strategy (e --genrule_strategy se usado com o mnemônico Genrule). Consulte https://blog.bazel.build/2019/06/19/list-strategy.html para mais detalhes.
Tags:execution
- Vários usos de
--strategy_regexp=<a '<RegexFilter>=value[,value]' assignment>
são acumulados -
Substitua qual estratégia de geração precisa ser usada para executar ações de geração com descrições que correspondem a um determinado regex_filter. Consulte --per_file_copt para saber mais sobre a correspondência de regex_filter. O último regex_filter que corresponde à descrição é usado. Essa opção substitui outras flags para especificar a estratégia. Exemplo: --strategy_regexp=//foo.*\.cc,-//foo/bar=local significa executar ações usando a estratégia local se as descrições corresponderem a //foo.*.cc, mas não a //foo/bar. Exemplo: --strategy_regexp='Compiling.*/bar=local --strategy_regexp=Compiling=sandboxed vai executar 'Compiling //foo/bar/baz' com a estratégia 'local', mas reverter a ordem a executaria com 'sandboxed'.
Tags:execution
- Vários usos de
--worker_extra_flag=<a 'name=value' assignment>
são acumulados -
Flags de comando extras que serão transmitidas para os processos de worker, além de --persistent_worker, com chave mnemônica (por exemplo, --worker_extra_flag=Javac=--debug.
Tags:execution
,host_machine_resource_optimizations
- Vários usos de
--worker_max_instances=<[name=]value, where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
são acumulados -
Quantas instâncias de cada tipo de worker persistente podem ser iniciadas se você usar a estratégia "worker". Pode ser especificado como [name=value] para fornecer um valor diferente por mnemônico. O limite é baseado em chaves de worker, que são diferenciadas com base no mnemônico, mas também em flags de inicialização e ambiente. Portanto, em alguns casos, pode haver mais workers por mnemônico do que a flag especifica. Recebe um número inteiro ou uma palavra-chave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida por uma operação ([-|*]<float>), por exemplo. "auto", "HOST_CPUS*.5". "auto" calcula um padrão razoável com base na capacidade da máquina. "=value" define um padrão para mnemônicos não especificados.
Tags:execution
,host_machine_resource_optimizations
- Vários usos de
--worker_max_multiplex_instances=<[name=]value, where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
são acumulados -
Quantas solicitações de trabalho um processo de worker multiplexado pode receber em paralelo se você usar a estratégia "worker" com --worker_multiplex. Pode ser especificado como [name=value] para fornecer um valor diferente por mnemônico. O limite é baseado em chaves de worker, que são diferenciadas com base no mnemônico, mas também em flags de inicialização e ambiente. Portanto, em alguns casos, pode haver mais workers por mnemônico do que a flag especifica. Recebe um número inteiro ou uma palavra-chave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida por uma operação ([-|*]<float>), por exemplo. "auto", "HOST_CPUS*.5". "auto" calcula um padrão razoável com base na capacidade da máquina. "=value" define um padrão para mnemônicos não especificados.
Tags:execution
,host_machine_resource_optimizations
--[no]worker_multiplex
padrão: "true"-
Se ativada, os workers vão usar a multiplexação, caso ofereçam suporte a ela.
Tags:execution
,host_machine_resource_optimizations
--[no]worker_quit_after_build
padrão: "false"-
Se ativado, todos os workers são encerrados após a conclusão de um build.
Tags:execution
,host_machine_resource_optimizations
--[no]worker_sandboxing
padrão: "false"-
Se ativado, os workers singleplex vão ser executados em um ambiente de sandbox. Os workers singleplex são sempre colocados em sandbox quando executados com a estratégia de execução dinâmica, independentemente dessa flag.
Tags:execution
--[no]worker_verbose
padrão: "false"- Se ativada, mostra mensagens detalhadas quando os workers são iniciados, encerrados etc.
- Opções que controlam a saída do comando:
--[no]build
padrão: "true"-
Execute o build. Esse é o comportamento normal. Especificar --nobuild faz com que o build seja interrompido antes da execução das ações, retornando zero se as fases de carregamento e análise do pacote forem concluídas. Esse modo é útil para testar essas fases.
Tags:execution
,affects_outputs
--[no]experimental_use_validation_aspect
padrão: "false"-
Define se as ações de validação serão executadas usando o aspecto (para paralelismo com testes).
Tags:execution
,affects_outputs
- Vários usos de
--output_groups=<comma-separated list of options>
são acumulados -
Uma lista de nomes de grupos de saída separados por vírgulas, cada um com um prefixo opcional de + ou -. Um grupo com prefixo de + é adicionado ao conjunto padrão de grupos de saída, enquanto um grupo com prefixo de - é removido do conjunto padrão. Se pelo menos um grupo não tiver um prefixo, o conjunto padrão de grupos de saída será omitido. Por exemplo, --output_groups=+foo,+bar cria a união do conjunto padrão, foo e bar, enquanto --output_groups=foo,bar substitui o conjunto padrão para que apenas foo e bar sejam criados.
Tags:execution
,affects_outputs
--[no]run_validations
padrão: "true"-
Define se as ações de validação serão executadas como parte do build. Consulte https://bazel.build/extending/rules#validation_actions
Tags:execution
,affects_outputs
--serialized_frontier_profile=<a string>
padrão: ""-
Despeja um perfil de bytes de fronteira serializados. Especifica o caminho de saída.
Tags:bazel_monitoring
- Opções que permitem ao usuário configurar a saída pretendida, afetando o valor, em vez da existência:
- Vários usos de
--aspects=<comma-separated list of options>
são acumulados - Lista separada por vírgulas de aspectos a serem aplicados a destinos de nível superior. Na lista, se o aspecto some_aspect especificar provedores de aspecto necessários usando required_aspect_providers, some_aspect será executado após todos os aspectos mencionados antes dele na lista de aspectos, cujos provedores anunciados satisfazem os provedores de aspecto necessários de some_aspect. Além disso, some_aspect será executado depois de todos os aspectos obrigatórios especificados pelo atributo "requires". some_aspect terá acesso aos valores dos provedores desses aspectos. <bzl-file-label>%<aspect_name>, por exemplo, '//tools:my_def.bzl%my_aspect', em que 'my_aspect' é um valor de nível superior de um arquivo tools/my_def.bzl
--bep_maximum_open_remote_upload_files=<an integer>
padrão: "-1"-
Número máximo de arquivos abertos permitidos durante o upload de artefatos do BEP.
Tags:affects_outputs
--[no]experimental_convenience_symlinks
padrão: "normal"-
Essa flag controla como os links simbólicos de conveniência (os links simbólicos que aparecem no espaço de trabalho após o build) serão gerenciados. Valores possíveis:
normal (padrão): cada tipo de link simbólico de conveniência será criado ou excluído, conforme determinado pelo build.
clean: todos os links simbólicos serão excluídos incondicionalmente.
ignore: os links simbólicos não serão criados nem limpos.
log_only: gera mensagens de registro como se "normal" tivesse sido transmitido, mas não realiza operações do sistema de arquivos (útil para ferramentas).
Somente os links simbólicos cujos nomes são gerados pelo valor atual de --symlink_prefix podem ser afetados. Se o prefixo mudar, os links simbólicos que já existem não serão afetados.
Tags:affects_outputs
--[no]experimental_convenience_symlinks_bep_event
padrão: "true"-
Essa flag controla se vamos postar ou não o eventConvenienceSymlinksIdentified do build no BuildEventProtocol. Se o valor for verdadeiro, o BuildEventProtocol terá uma entrada para convenienceSymlinksIdentified, listando todos os links simbólicos de conveniência criados no seu espaço de trabalho. Se for falso, a entrada convenienceSymlinksIdentified no BuildEventProtocol vai estar vazia.
Tags:affects_outputs
--remote_download_all
-
Faz o download de todas as saídas remotas para a máquina local. Essa flag é um alias de --remote_download_outputs=all.
É expandido para:
--remote_download_outputs=all
Tags:affects_outputs
--remote_download_minimal
-
Não faz o download de nenhuma saída de build remoto para a máquina local. Essa flag é um alias para --remote_download_outputs=minimal.
É expandido para:
--remote_download_outputs=minimal
Tags:affects_outputs
--remote_download_outputs=<all, minimal or toplevel>
padrão: "toplevel"-
Se definido como "minimal", não faz o download de nenhuma saída de build remoto para a máquina local, exceto as exigidas por ações locais. Se definido como "toplevel", ele se comporta como "minimal", exceto por fazer o download das saídas de destinos de nível superior para a máquina local. Ambas as opções podem reduzir significativamente os tempos de build se a largura de banda da rede for um gargalo.
Tags:affects_outputs
--remote_download_symlink_template=<a string>
padrão: ""-
Em vez de fazer o download de saídas de build remoto para a máquina local, crie links simbólicos. O destino dos links simbólicos pode ser especificado na forma de uma string de modelo. Essa string de modelo pode conter {hash} e {size_bytes}, que se expandem para o hash do objeto e o tamanho em bytes, respectivamente. Por exemplo, esses links simbólicos podem apontar para um sistema de arquivos FUSE que carrega objetos do CAS sob demanda.
Tags:affects_outputs
--remote_download_toplevel
-
Somente faz o download de saídas remotas de segmentações de nível superior para a máquina local. Essa flag é um alias de --remote_download_outputs=toplevel.
É expandido para:
--remote_download_outputs=toplevel
Tags:affects_outputs
--symlink_prefix=<a string>
padrão: consulte a descrição-
O prefixo que é adicionado a qualquer um dos links simbólicos de conveniência criados após um build. Se omitido, o valor padrão é o nome da ferramenta de build seguido de um hífen. Se "/" for transmitido, nenhum link simbólico será criado e nenhum aviso será emitido. Aviso: a funcionalidade especial para '/' será descontinuada em breve. Use --experimental_convenience_symlinks=ignore.
Tags:affects_outputs
- Opções que afetam a forma como o Bazel aplica estritamente as entradas de build válidas (definições de regras, combinações de sinalizações etc.):
--[no]experimental_docker_privileged
padrão: "false"-
Se ativada, o Bazel vai transmitir a flag --privileged para "docker run" ao executar ações. Isso pode ser necessário para o build, mas também pode resultar em uma redução da hermeticidade.
Tags:execution
--[no]experimental_sandboxfs_map_symlink_targets
padrão: "false"-
Tags
:host_machine_resource_optimizations
,execution
--[no]incompatible_legacy_local_fallback
padrão: "false"-
Se definido como "true", ativa o fallback implícito legada da estratégia local para a sandbox. Essa flag vai passar a ser falsa por padrão e, em seguida, vai se tornar uma operação nula. Use --strategy, --spawn_strategy ou --dynamic_local_strategy para configurar substitutos.
Tags:execution
,incompatible_change
- Vários usos de
--sandbox_add_mount_pair=<a single path or a 'source:target' pair>
são acumulados -
Adicione um par de caminho adicional para montagem no sandbox.
Tags:execution
- Vários usos de
--sandbox_block_path=<a string>
são acumulados -
Para ações em modo sandbox, não permita o acesso a este caminho.
Tags:execution
--[no]sandbox_default_allow_network
padrão: "true"-
Permitir o acesso à rede por padrão para ações. Isso pode não funcionar com todas as implementações de sandbox.
Tags:execution
--[no]sandbox_fake_hostname
padrão: "false"-
Mude o nome do host atual para "localhost" em ações em ambiente controlado.
Tags:execution
--[no]sandbox_fake_username
padrão: "false"-
Mude o nome de usuário atual para "ninguém" em ações em ambiente controlado.
Tags:execution
- Vários usos de
--sandbox_writable_path=<a string>
são acumulados -
Para ações em sandbox, torne um diretório existente gravável no sandbox (se for compatível com a implementação do sandbox, será ignorado).
Tags:execution
- Essa opção afeta a semântica da linguagem Starlark ou a API de build acessível a arquivos BUILD, .bzl ou WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility
padrão: "false"-
Se incompatible_enforce_config_setting_visibility=false, isso é um noop. Caso contrário, se essa flag for falsa, qualquer config_setting sem um atributo de visibilidade explícito será //visibility:public. Se essa flag for verdadeira, a config_setting vai seguir a mesma lógica de visibilidade de todas as outras regras. Consulte https://github.com/bazelbuild/bazel/issues/12933.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
padrão: "true"-
Se verdadeiro, aplique as restrições de visibilidade de config_setting. Se for falso, cada config_setting será visível para cada destino. Consulte https://github.com/bazelbuild/bazel/issues/12932.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_use_plus_in_repo_names
padrão: "true"-
No-op.
Tags:loading_and_analysis
- Opções que governam o comportamento do ambiente de teste ou do executor de teste:
--[no]check_tests_up_to_date
padrão: "false"-
Não execute testes, apenas verifique se eles estão atualizados. Se todos os resultados dos testes estiverem atualizados, o teste será concluído. Se algum teste precisar ser criado ou executado, um erro será informado e o teste falhará. Essa opção implica o comportamento --check_up_to_date.
Tags:execution
- Vários usos de
--flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once>
são acumulados -
Cada teste será repetido até o número especificado de vezes em caso de falha. Os testes que exigem mais de uma tentativa para serem aprovados são marcados como "FLAKY" no resumo do teste. Normalmente, o valor especificado é apenas um número inteiro ou a string "default". Se for um número inteiro, todos os testes serão executados até N vezes. Se for "padrão", apenas uma tentativa de teste será feita para testes regulares e três para testes marcados explicitamente como instáveis pela regra (atributo "flaky"=1). Sintaxe alternativa: regex_filter@flaky_test_attempts. Em que flaky_test_attempts é como acima e regex_filter representa uma lista de padrões de expressão regular de inclusão e exclusão. Consulte também --runs_per_test. Exemplo: --flaky_test_attempts=//foo/.*,-//foo/bar/.*@3 desfaz todos os testes em //foo/, exceto aqueles em foo/bar três vezes. Essa opção pode ser transmitida várias vezes. O argumento mais recente transmitido que corresponde tem precedência. Se nada corresponder, o comportamento será como se fosse "padrão" acima.
Tags: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">
padrão: "auto"-
O número máximo de jobs de teste locais a serem executados simultaneamente. Recebe um número inteiro ou uma palavra-chave ("auto", "HOST_CPUS", "HOST_RAM"), opcionalmente seguida por uma operação ([-|*]<float>), por exemplo. "auto", "HOST_CPUS*.5". 0 significa que os recursos locais vão limitar o número de jobs de teste locais executados simultaneamente. Definir esse valor como maior que o valor de --jobs não tem efeito.
Tags:execution
--[no]test_keep_going
padrão: "true"-
Quando desativado, qualquer teste que não seja aprovado faz com que todo o build seja interrompido. Por padrão, todos os testes são executados, mesmo que alguns não sejam aprovados.
Tags:execution
--test_strategy=<a string>
padrão: ""-
Especifica qual estratégia usar ao executar testes.
Tags:execution
--test_tmpdir=<a path>
padrão: consulte a descrição- Especifica o diretório temporário de base para uso de "bazel test".
- Opções que acionam otimizações do tempo de build:
--cache_computed_file_digests=<a long integer>
padrão: "50000"- Se for maior que 0, configura o Bazel para armazenar em cache os resumos de arquivos na memória com base nos metadados em vez de recalcular os resumos do disco sempre que eles forem necessários. A definição desse valor como 0 garante a correção, porque nem todas as mudanças de arquivo podem ser notadas nos metadados. Quando não é 0, o número indica o tamanho do cache como o número de resumos de arquivos a serem armazenados em cache.
--[no]experimental_cpu_load_scheduling
padrão: "false"-
Ativa a programação de execução local experimental com base na carga da CPU, não na estimativa de ações uma por uma. A programação experimental mostrou o grande benefício de builds locais em máquinas potentes com um grande número de cores. Recomendado para uso com --local_resources=cpu=HOST_CPUS
Tags:execution
--experimental_dynamic_ignore_local_signals=<a comma-separated list of signal numbers>
padrão: consulte a descrição-
Recebe uma lista de números de indicadores do SO. Se uma ramificação local de execução dinâmica for encerrada com qualquer um desses sinais, a ramificação remota poderá ser concluída. Para workers persistentes, isso afeta apenas os sinais que encerram o processo do worker.
Tags:execution
--[no]experimental_enable_skyfocus
padrão: "false"-
Se verdadeiro, permite o uso de --experimental_working_set para reduzir a pegada de memória do Bazel em builds incrementais. Esse recurso é conhecido como Skyfocus.
Tags:host_machine_resource_optimizations
--experimental_working_set=<comma-separated list of options>
padrão: ""-
O conjunto de trabalho para o Skyfocus. Especifique como caminhos relativos à raiz do espaço de trabalho separados por vírgulas. Essa é uma flag com estado. A definição de um conjunto de trabalho persiste para invocações subsequentes até ser redefinida com um novo conjunto.
Tags:host_machine_resource_optimizations
--local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>
padrão: "HOST_CPUS"-
Define explicitamente o número total de núcleos de CPU locais disponíveis para o Bazel usar em ações de build executadas localmente. Recebe um número inteiro ou "HOST_CPUS", seguido opcionalmente por [-|*]<float> (por exemplo, HOST_CPUS*.5 para usar metade dos núcleos de CPU disponíveis. Por padrão ("HOST_CPUS"), o Bazel consulta a configuração do sistema para estimar o número de núcleos de CPU disponíveis.
Tags:host_machine_resource_optimizations
- Vários usos de
--local_extra_resources=<a named float, 'name=value'>
são acumulados -
Defina o número de recursos extras disponíveis para o Bazel. Recebe um par de string-flutuante. Pode ser usado várias vezes para especificar vários tipos de recursos extras. O Bazel vai limitar as ações em execução simultaneamente com base nos recursos extras disponíveis e nos recursos extras necessários. Os testes podem declarar a quantidade de recursos extras de que precisam usando uma tag no formato "resources:<resoucename>:<amount>". Não é possível definir CPU, RAM e recursos disponíveis com essa flag.
Tags:host_machine_resource_optimizations
--local_ram_resources=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
padrão: "HOST_RAM*.67"-
Defina explicitamente a quantidade total de RAM do host local (em MB) disponível para o Bazel usar em ações de build executadas localmente. Recebe um número inteiro ou "HOST_RAM", seguido opcionalmente por [-|*]<float> (por exemplo, HOST_RAM*.5 para usar metade da RAM disponível). Por padrão ("HOST_RAM*.67"), o Bazel consulta a configuração do sistema para estimar a quantidade de RAM disponível e usa 67% dela.
Tags:host_machine_resource_optimizations
- Vários usos de
--local_resources=<a named double, 'name=value', where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
são acumulados -
Define o número de recursos disponíveis para o Bazel. Recebe uma atribuição para um float ou HOST_RAM/HOST_CPUS, opcionalmente seguido por [-|*]<float> (por exemplo, memory=HOST_RAM*.5 para usar metade da RAM disponível). Pode ser usado várias vezes para especificar vários tipos de recursos. O Bazel vai limitar as ações em execução simultaneamente com base nos recursos disponíveis e nos recursos necessários. Os testes podem declarar a quantidade de recursos de que precisam usando uma tag no formato "resources:<resource name>:<amount>". Substitui os recursos especificados por --local_{cpu|ram|extra}_resources.
Tags:host_machine_resource_optimizations
- Opções que afetam a verbosidade, o formato ou o local de registro:
--build_event_upload_max_retries=<an integer>
padrão: "4"-
O número máximo de vezes que o Bazel precisa tentar fazer o upload de um evento de build.
Tags:bazel_internal_configuration
--[no]debug_spawn_scheduler
padrão: "false"--[no]experimental_bep_target_summary
padrão: "false"- Define se os eventos de TargetSummary serão publicados.
--[no]experimental_build_event_expand_filesets
padrão: "false"-
Se verdadeiro, expande os conjuntos de arquivos no BEP ao apresentar arquivos de saída.
Tags:affects_outputs
--[no]experimental_build_event_fully_resolve_fileset_symlinks
padrão: "false"-
Se verdadeiro, resolve totalmente os links simbólicos de conjuntos de arquivos relativos no BEP ao apresentar arquivos de saída. Requer --experimental_build_event_expand_filesets.
Tags:affects_outputs
- Vários usos de
--experimental_build_event_output_group_mode=<an output group name followed by an OutputGroupFileMode, e.g. default=both>
são acumulados -
Especifica como os arquivos de um grupo de saída serão representados nos eventos de BEP TargetComplete/AspectComplete. Os valores são uma atribuição de um nome de grupo de saída a um dos seguintes: 'NAMED_SET_OF_FILES_ONLY', 'INLINE_ONLY' ou 'BOTH'. O valor padrão é 'NAMED_SET_OF_FILES_ONLY'. Se um grupo de saída for repetido, o valor final a ser mostrado será usado. O valor padrão define o modo dos artefatos de cobertura como AMBOS: --experimental_build_event_output_group_mode=baseline.lcov=both
Tags:affects_outputs
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
padrão: "1s"-
Delay mínimo inicial para as tentativas de espera exponencial quando o upload do BEP falha. (expoente: 1,6)
Tags:bazel_internal_configuration
--experimental_build_event_upload_strategy=<a string>
padrão: consulte a descrição-
Seleciona como fazer upload de artefatos referenciados no protocolo de evento de build. No Bazel, as opções válidas incluem "local" e "remote". O valor padrão é "local".
Tags:affects_outputs
--[no]experimental_docker_verbose
padrão: "false"-
Se ativado, o Bazel vai mostrar mensagens mais detalhadas sobre a estratégia de sandbox do Docker.
Tags:execution
--experimental_frontier_violation_check=<strict, warn or disabled_for_testing>
padrão: "strict"-
Estratégias para lidar com possíveis incorreções de mudanças além da fronteira (ou seja, fora do conjunto de trabalho)
Tags:eagerness_to_exit
--[no]experimental_materialize_param_files_directly
padrão: "false"-
Se você estiver materializando arquivos de parâmetro, faça isso com gravações diretas no disco.
Tags:execution
--experimental_repository_resolved_file=<a string>
padrão: ""-
Se não estiver vazio, grave um valor do Starlark com as informações resolvidas de todas as regras do repositório do Starlark que foram executadas.
Tags:affects_outputs
--[no]experimental_run_bep_event_include_residue
padrão: "false"-
Define se o resíduo da linha de comando será incluído nos eventos de execução do build que podem conter o resíduo. Por padrão, o resíduo não é incluído nos eventos de build de execução de comando que podem conter o resíduo.
Tags:affects_outputs
--experimental_skyfocus_dump_keys=<none, count or verbose>
padrão: "none"-
Para depurar o Skyfocus. Descarregue as SkyKeys focadas (raízes, folhas, dependências focadas, dependências focadas).
Tags:terminal_output
--[no]experimental_skyfocus_dump_post_gc_stats
padrão: "false"-
Para depurar o Skyfocus. Se ativado, acione o GC manual antes/depois do foco para informar reduções de tamanho de heap. Isso vai aumentar a latência do Skyfocus.
Tags:terminal_output
--[no]experimental_stream_log_file_uploads
padrão: "false"-
O arquivo de registro de streaming é enviado diretamente para o armazenamento remoto em vez de ser gravado no disco.
Tags:affects_outputs
--explain=<a path>
padrão: consulte a descrição-
Faz com que o sistema de build explique cada etapa executada do build. A explicação é gravada no arquivo de registro especificado.
Tags:affects_outputs
--[no]ignore_unsupported_sandboxing
padrão: "false"-
Não mostra um aviso quando a execução em sandbox não é compatível com o sistema.
Tags:terminal_output
--[no]legacy_important_outputs
padrão: "false"-
Use isso para suprimir a geração do campo important_outputs legada no evento TargetComplete. important_outputs é necessário para a integração do Bazel com o ResultStore/BTX.
Tags:affects_outputs
--[no]materialize_param_files
padrão: "false"-
Grava arquivos de parâmetro intermediários na árvore de saída mesmo quando a execução de ação remota é usada. Útil ao depurar ações. Isso é implícito em --subcommands e --verbose_failures.
Tags:execution
--max_config_changes_to_show=<an integer>
padrão: "3"-
Quando o cache de análise é descartado devido a uma mudança nas opções de build, ele exibe até o número especificado de nomes de opções alteradas. Se o número informado for -1, todas as opções alteradas serão exibidas.
Tags:terminal_output
--max_test_output_bytes=<an integer>
padrão: "-1"-
Especifica o tamanho máximo por registro de teste que pode ser emitido quando --test_output é "errors" ou "all". Útil para evitar que a saída seja sobrecarregada com saída de teste excessivamente ruidosa. O cabeçalho de teste é incluído no tamanho do registro. Valores negativos não têm limite. A saída é tudo ou nada.
Tags:test_runner
,terminal_output
,execution
--output_filter=<a valid Java regular expression>
padrão: consulte a descrição-
Só mostra avisos e saídas de ação para regras com um nome que corresponda à expressão regular fornecida.
Tags:affects_outputs
--progress_report_interval=<an integer in 0-3600 range>
padrão: "0"-
O número de segundos para aguardar entre relatórios sobre trabalhos ainda em execução. O valor padrão 0 significa que o primeiro relatório será impresso após 10 segundos, depois 30 segundos e, depois disso, o progresso será informado uma vez a cada minuto. Quando --curses está ativado, o progresso é informado a cada segundo.
Tags:affects_outputs
--remote_print_execution_messages=<failure, success or all>
padrão: "failure"-
Escolha quando imprimir mensagens de execução remota. Os valores válidos são "failure" para imprimir apenas em falhas, "success" para imprimir apenas em sucessos e "all" para imprimir sempre.
Tags:terminal_output
--[no]sandbox_debug
padrão: "false"-
Ativa os recursos de depuração para o recurso de sandbox. Isso inclui duas coisas: primeiro, o conteúdo raiz do sandbox é deixado intocado após um build; e, segundo, mostra informações de depuração extras na execução. Isso pode ajudar os desenvolvedores de regras do Bazel ou do Starlark com falhas de depuração devido à ausência de arquivos de entrada etc.
Tags:terminal_output
--show_result=<an integer>
padrão: "1"-
Mostre os resultados do build. Para cada destino, indique se ele foi atualizado ou não e, se sim, uma lista de arquivos de saída que foram criados. Os arquivos impressos são strings convenientes para copiar e colar no shell para executá-los.
Essa opção requer um argumento inteiro, que é o número de destino limite acima do qual as informações de resultado não são impressas. Assim, zero causa a supressão da mensagem, e MAX_INT faz com que a impressão do resultado ocorra sempre. O padrão é um.
Se nada foi criado para um destino, os resultados dele podem ser omitidos para manter a saída abaixo do limite.
Tags:affects_outputs
--[no]subcommands
[-s
] padrão: "false"-
Mostra os subcomandos executados durante um build. Flags relacionadas: --execution_log_json_file, --execution_log_binary_file (para registrar subcomandos em um arquivo em um formato compatível com ferramentas).
Tags:terminal_output
--test_output=<summary, errors, all or streamed>
padrão: "summary"-
Especifica o modo de saída desejado. Os valores válidos são "summary" para gerar apenas o resumo do status do teste, "errors" para imprimir também os registros de testes com falha, "all" para imprimir os registros de todos os testes e "streamed" para gerar os registros de todos os testes em tempo real. Isso força a execução local dos testes um por vez, independentemente do valor de --test_strategy.
Tags:test_runner
,terminal_output
,execution
--test_summary=<short, terse, detailed, none or testcase>
padrão: "short"-
Especifica o formato desejado do resumo do teste. Os valores válidos são "short" para imprimir informações apenas sobre os testes executados, "terse", para imprimir informações apenas sobre os testes sem sucesso que foram executados, "detailed" para imprimir informações detalhadas sobre os casos de teste com falha, "testcase" para imprimir o resumo na resolução do caso de teste, não imprimir informações detalhadas sobre os casos de teste com falha e "none" para omitir o resumo.
Tags:terminal_output
--[no]verbose_explanations
padrão: "false"-
Aumenta o nível de detalhamento das explicações emitidas se a opção --explain estiver ativada. Não tem efeito se --explain não estiver ativado.
Tags:affects_outputs
--[no]verbose_failures
padrão: "false"-
Se um comando falhar, imprima a linha de comando completa.
Tags:terminal_output
- Opções que especificam ou alteram uma entrada genérica para um comando do Bazel que não se enquadra em outras categorias.:
- Vários usos de
--aspects_parameters=<a 'name=value' assignment>
são acumulados -
Especifica os valores dos parâmetros de aspectos da linha de comando. Cada valor de parâmetro é especificado por <param_name>=<param_value>, por exemplo, "my_param=my_val", em que "my_param" é um parâmetro de algum aspecto na lista --aspects ou exigido por um aspecto na lista. Essa opção pode ser usada várias vezes. No entanto, não é permitido atribuir valores ao mesmo parâmetro mais de uma vez.
Tags:loading_and_analysis
--target_pattern_file=<a string>
padrão: ""-
Se definido, o build vai ler padrões do arquivo nomeado aqui, em vez da linha de comando. É um erro especificar um arquivo aqui, bem como padrões de linha de comando.
Tags:changes_inputs
- Opções de execução e armazenamento em cache remoto:
--experimental_circuit_breaker_strategy=<failure>
padrão: consulte a descrição-
Especifica a estratégia a ser usada pelo disjuntor. As estratégias disponíveis são "falha". Em um valor inválido para a opção, o comportamento é o mesmo que quando a opção não está definida.
Tags:execution
--[no]experimental_guard_against_concurrent_changes
padrão: "false"- Desative essa opção para desativar a verificação do ctime dos arquivos de entrada de uma ação antes de fazer o upload para um cache remoto. Pode haver casos em que o kernel do Linux atrasa a gravação de arquivos, o que pode causar falsos positivos.
--experimental_remote_cache_compression_threshold=<an integer>
padrão: "100"- O tamanho mínimo do blob necessário para compactar/descompactar com zstd. Ineficaz, a menos que --remote_cache_compression esteja definido.
--experimental_remote_cache_eviction_retries=<an integer>
padrão: "5"-
O número máximo de tentativas de repetição se o build encontrar um erro de cache remoto temporário que falharia o build. Isso se aplica, por exemplo, quando os artefatos são removidos do cache remoto ou em determinadas condições de falha do cache. Um valor diferente de zero define implicitamente --incompatible_remote_use_new_exit_code_for_lost_inputs como "true". Um novo ID de invocação será gerado para cada tentativa. Se você gerar o ID de invocação e fornecer ao Bazel com --invocation_id, não use essa flag. Em vez disso, defina a flag --incompatible_remote_use_new_exit_code_for_lost_inputs e verifique o código de saída 39.
Tags:execution
--[no]experimental_remote_cache_lease_extension
padrão: "false"- Se definido como verdadeiro, o Bazel vai estender o arrendamento para saídas de ações remotas durante o build enviando chamadas FindMissingBlobs periodicamente para o cache remoto. A frequência é baseada no valor de `--experimental_remote_cache_ttl`.
--experimental_remote_cache_ttl=<An immutable length of time.>
padrão: "3h"-
O TTL mínimo garantido de blobs no cache remoto depois que os resumos forem referenciados recentemente, por exemplo, por um ActionResult ou FindMissingBlobs. O Bazel faz várias otimizações com base no TTL dos blobs, por exemplo, não chama GetActionResult repetidamente em um build incremental. O valor precisa ser definido um pouco menor que o TTL real, já que há uma lacuna entre o momento em que o servidor retorna os resumos e o momento em que o Bazel os recebe.
Tags:execution
--experimental_remote_capture_corrupted_outputs=<a path>
padrão: consulte a descrição- Um caminho para um diretório em que as saídas corrompidas serão capturadas.
--[no]experimental_remote_discard_merkle_trees
padrão: "true"- Se definido como verdadeiro, descarta cópias na memória da árvore Merkle da raiz de entrada e mapeamentos de entrada associados durante as chamadas para GetActionResult() e Execute(). Isso reduz significativamente o uso da memória, mas exige que o Bazel as recalcule após falhas e novas tentativas de acesso ao cache remoto.
--experimental_remote_downloader=<a string>
padrão: consulte a descrição- Um URI de endpoint da API de recursos remotos, para ser usado como um proxy de download remoto. Os esquemas compatíveis são grpc, grpcs (grpc com TLS ativado) e unix (sockets locais do UNIX). Se nenhum esquema for fornecido, o Bazel vai usar o padrão GRPC. Consulte: https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto
--[no]experimental_remote_downloader_local_fallback
padrão: "false"- Define se o download local será usado se o download remoto falhar.
--[no]experimental_remote_downloader_propagate_credentials
padrão: "false"- Define se as credenciais do netrc e do auxiliar de credenciais serão propagadas para o servidor do download remoto. A implementação do servidor precisa oferecer suporte ao novo qualificador `http_header_url:<url-index>:<header-key>`, em que "<url-index>" é uma posição baseada em 0 do URL dentro do campo "uris" do FetchBlobRequest. Os cabeçalhos específicos do URL têm precedência sobre os cabeçalhos globais.
--[no]experimental_remote_execution_keepalive
padrão: "false"- Define se o keepalive será usado para chamadas de execução remota.
--experimental_remote_failure_rate_threshold=<an integer in 0-100 range>
padrão: "10"-
Define o número permitido de taxa de falha em porcentagem para um período específico, após o qual ele para de chamar o cache/executor remoto. Por padrão, o valor é 10. Definir esse valor como 0 significa que não há limitação.
Tags:execution
--experimental_remote_failure_window_interval=<An immutable length of time.>
padrão: "60s"-
O intervalo em que a taxa de falha das solicitações remotas é calculada. Em um valor zero ou negativo, a duração da falha é computada durante toda a execução.As unidades a seguir podem ser usadas: dias (d), horas (h), minutos (m), segundos (s) e milissegundos (ms). Se a unidade for omitida, o valor será interpretado como segundos.
Tags:execution
--[no]experimental_remote_mark_tool_inputs
padrão: "false"- Se definido como verdadeiro, o Bazel marcará as entradas como entradas de ferramenta para o executor remoto. Isso pode ser usado para implementar workers persistentes remotos.
--[no]experimental_remote_merkle_tree_cache
padrão: "false"- Se definido como verdadeiro, os cálculos da árvore de Merkle serão armazenados em cache para melhorar a velocidade de verificação de acertos de cache remoto. O volume de memória do cache é controlado por --experimental_remote_merkle_tree_cache_size.
--experimental_remote_merkle_tree_cache_size=<a long integer>
padrão: "1000"- O número de árvores de Merkle a serem memorizadas para melhorar a velocidade de verificação de ocorrências de cache remoto. Embora o cache seja podado automaticamente de acordo com o tratamento de referências flexíveis do Java, erros de falta de memória podem ocorrer se a configuração for muito alta. Se definido como 0, o tamanho do cache será ilimitado. O valor ideal varia de acordo com o tamanho do projeto. O padrão é 1.000.
--experimental_remote_output_service=<a string>
padrão: consulte a descrição- HOST ou HOST:PORT de um endpoint de serviço de saída remoto. Os esquemas compatíveis são grpc, grpcs (grpc com TLS ativado) e unix (sockets locais do UNIX). Se nenhum esquema for fornecido, o Bazel vai usar o padrão GRPC. Especifique o esquema grpc:// ou unix: para desativar o TLS.
--experimental_remote_output_service_output_path_prefix=<a string>
padrão: ""- O caminho em que o conteúdo dos diretórios de saída gerenciados pelo --experimental_remote_output_service é colocado. O diretório de saída real usado por um build será um descendente desse caminho e determinado pelo serviço de saída.
--[no]experimental_remote_require_cached
padrão: "false"- Se definido como verdadeiro, vai forçar que todas as ações que podem ser executadas remotamente sejam armazenadas em cache ou que o build falhe. Isso é útil para resolver problemas de não determinismo, porque permite verificar se as ações que precisam ser armazenadas em cache são realmente armazenadas sem injetar novos resultados no cache.
--experimental_remote_scrubbing_config=<Converts to a Scrubber>
padrão: consulte a descrição- Habilita o apagamento de chaves de cache remoto com o arquivo de configuração fornecido, que precisa ser um buffer de protocolo no formato de texto (consulte src/main/protobuf/remote_scrubbing.proto). O objetivo desse recurso é facilitar o compartilhamento de um cache remoto/de disco entre ações executadas em plataformas diferentes, mas com segmentação para a mesma plataforma. Ele deve ser usado com muito cuidado, porque configurações inadequadas podem causar o compartilhamento acidental de entradas de cache e resultar em builds incorretos. A limpeza não afeta a execução de uma ação, apenas como a chave de cache remoto/disco é calculada para recuperar ou armazenar um resultado de ação. As ações apagadas são incompatíveis com a execução remota e sempre serão executadas localmente. Modificar a configuração de limpeza não invalida as saídas presentes no sistema de arquivos local ou nos caches internos. É necessário um build limpo para reexecutar as ações afetadas. Para usar esse recurso, é recomendável definir um --host_platform personalizado com --experimental_platform_in_output_dir (para normalizar os prefixos de saída) e --incompatible_strict_action_env (para normalizar as variáveis de ambiente).
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
padrão: "true"-
Se definido como verdadeiro, o Bazel vai usar o novo código de saída 39 em vez de 34 se erros de cache remoto, incluindo exclusões de cache, causarem a falha do build.
Tags:incompatible_change
--[no]remote_accept_cached
padrão: "true"- Define se os resultados da ação armazenados em cache remotamente serão aceitos.
--remote_build_event_upload=<all or minimal>
padrão: "minimal"- Se definido como "all", todas as saídas locais referenciadas pelo BEP são enviadas por upload para o cache remoto. Se definido como "minimal", as saídas locais referenciadas pelo BEP não são enviadas para o cache remoto, exceto arquivos importantes para os consumidores do BEP (por exemplo, logs de teste e perfil de tempo). O esquema bytestream:// é sempre usado para o uri de arquivos, mesmo que eles não estejam no cache remoto. O padrão é "minimal".
--remote_bytestream_uri_prefix=<a string>
padrão: consulte a descrição- O nome do host e da instância a ser usado em URIs bytestream:// gravados em streams de eventos de build. Essa opção pode ser definida quando os builds são realizados usando um proxy, o que faz com que os valores de --remote_executor e --remote_instance_name não correspondam mais ao nome canônico do serviço de execução remota. Quando não definido, o padrão é "${hostname}/${instance_name}".
--remote_cache=<a string>
padrão: consulte a descrição- Um URI de um endpoint de armazenamento em cache. Os esquemas compatíveis são http, https, grpc, grpcs (grpc com TLS ativado) e unix (sockets locais do UNIX). Se nenhum esquema for fornecido, o Bazel vai usar o padrão GRPC. Especifique o esquema grpc://, http:// ou unix: para desativar o TLS. Consulte https://bazel.build/remote/caching
--[no]remote_cache_async
padrão: "true"- Se verdadeiro, o upload dos resultados da ação para um disco ou cache remoto vai acontecer em segundo plano, em vez de bloquear a conclusão de uma ação. Algumas ações são incompatíveis com uploads em segundo plano e podem ser bloqueadas mesmo quando essa flag está definida.
--[no]remote_cache_compression
padrão: "false"- Se ativado, compacte/descompacte blobs de cache com zstd quando o tamanho deles for pelo menos --experimental_remote_cache_compression_threshold.
- Vários usos de
--remote_cache_header=<a 'name=value' assignment>
são acumulados - Especifique um cabeçalho que será incluído nas solicitações de cache: --remote_cache_header=Nome=Valor. Vários cabeçalhos podem ser transmitidos especificando a flag várias vezes. Vários valores com o mesmo nome serão convertidos em uma lista separada por vírgulas.
- Vários usos de
--remote_default_exec_properties=<a 'name=value' assignment>
são acumulados -
Defina as propriedades de execução padrão para serem usadas como a plataforma de execução remota se uma plataforma de execução ainda não tiver definido exec_properties.
Tags:affects_outputs
--remote_default_platform_properties=<a string>
padrão: ""- Defina as propriedades padrão da plataforma para serem definidas para a API de execução remota, se a plataforma de execução ainda não tiver definido remote_execution_properties. Esse valor também será usado se a plataforma host for selecionada como a plataforma de execução para execução remota.
- Vários usos de
--remote_download_regex=<a valid Java regular expression>
são acumulados -
Força o download de saídas de build remoto cujo caminho corresponde a esse padrão, independentemente de --remote_download_outputs. Vários padrões podem ser especificados repetindo essa flag.
Tags:affects_outputs
- Vários usos de
--remote_downloader_header=<a 'name=value' assignment>
são acumulados - Especifica um cabeçalho que será incluído nas solicitações do downloader remoto: --remote_downloader_header=Nome=Valor. Vários cabeçalhos podem ser transmitidos especificando a flag várias vezes. Vários valores com o mesmo nome serão convertidos em uma lista separada por vírgulas.
- Vários usos de
--remote_exec_header=<a 'name=value' assignment>
são acumulados - Especifica um cabeçalho que será incluído nas solicitações de execução: --remote_exec_header=Nome=Valor. Vários cabeçalhos podem ser transmitidos especificando a flag várias vezes. Vários valores com o mesmo nome serão convertidos em uma lista separada por vírgulas.
--remote_execution_priority=<an integer>
padrão: "0"- A prioridade relativa das ações a serem executadas remotamente. A semântica dos valores de prioridade específicos depende do servidor.
--remote_executor=<a string>
padrão: consulte a descrição- HOST ou HOST:PORT de um endpoint de execução remota. Os esquemas compatíveis são grpc, grpcs (grpc com TLS ativado) e unix (sockets locais do UNIX). Se nenhum esquema for fornecido, o Bazel vai usar o padrão GRPC. Especifique o esquema grpc:// ou unix: para desativar o TLS.
--remote_grpc_log=<a path>
padrão: consulte a descrição- Se especificado, um caminho para um arquivo para registrar detalhes relacionados à chamada gRPC. Esse registro consiste em uma sequência de protobufs com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry serializados, com cada mensagem prefixada por um varint que indica o tamanho da mensagem protobuf serializada a seguir, conforme executado pelo método LogEntry.writeDelimitedTo(OutputStream).
- Vários usos de
--remote_header=<a 'name=value' assignment>
são acumulados - Especifica um cabeçalho que será incluído nas solicitações: --remote_header=Nome=Valor. Vários cabeçalhos podem ser transmitidos especificando a flag várias vezes. Vários valores com o mesmo nome serão convertidos em uma lista separada por vírgulas.
--remote_instance_name=<a string>
padrão: ""- Valor a ser transmitido como instance_name na API de execução remota.
--[no]remote_local_fallback
padrão: "false"- Define se a estratégia de execução local independente será usada como alternativa se a execução remota falhar.
--remote_local_fallback_strategy=<a string>
padrão: "local"- Descontinuado. Consulte https://github.com/bazelbuild/bazel/issues/7480 para saber mais.
--remote_max_connections=<an integer>
padrão: "100"-
Limite o número máximo de conexões simultâneas para o cache/executor remoto. Por padrão, o valor é 100. Definir esse valor como 0 significa que não há limitação.
Para o cache remoto HTTP, uma conexão TCP pode processar uma solicitação por vez. Assim, o Bazel pode criar até --remote_max_connections solicitações simultâneas.
Para o cache/executor remoto do gRPC, um canal do gRPC geralmente pode processar mais de 100 solicitações simultâneas. Portanto, o Bazel pode fazer cerca de `--remote_max_connections * 100` solicitações simultâneas.
Tags:host_machine_resource_optimizations
--remote_proxy=<a string>
padrão: consulte a descrição- Conecte-se ao cache remoto por um proxy. No momento, essa flag só pode ser usada para configurar um soquete de domínio Unix (unix:/path/to/socket).
--remote_result_cache_priority=<an integer>
padrão: "0"- A prioridade relativa das ações remotas que serão armazenadas no cache remoto. A semântica dos valores de prioridade específicos depende do servidor.
--remote_retries=<an integer>
padrão: "5"- O número máximo de tentativas de repetição de um erro temporário. Se definido como 0, as novas tentativas são desativadas.
--remote_retry_max_delay=<An immutable length of time.>
padrão: "5s"- O atraso máximo de espera entre as tentativas de nova tentativa remota. As unidades a seguir podem ser usadas: dias (d), horas (h), minutos (m), segundos (s) e milissegundos (ms). Se a unidade for omitida, o valor será interpretado como segundos.
--remote_timeout=<An immutable length of time.>
padrão: "60s"- O tempo máximo de espera para a execução remota e as chamadas de cache. Para o cache REST, isso é o tempo limite de conexão e de leitura. As unidades a seguir podem ser usadas: dias (d), horas (h), minutos (m), segundos (s) e milissegundos (ms). Se a unidade for omitida, o valor será interpretado como segundos.
--[no]remote_upload_local_results
padrão: "true"- Define se os resultados de ações executadas localmente serão enviados por upload ao cache remoto, se o cache remoto oferecer suporte a isso e se o usuário tiver autorização para fazer isso.
--[no]remote_verify_downloads
padrão: "true"- Se definido como verdadeiro, o Bazel vai calcular a soma de hash de todos os downloads remotos e descartar os valores armazenados em cache remotamente se eles não corresponderem ao valor esperado.
- Opções diversas, não categorizadas de outra forma.
--[no]allow_analysis_cache_discard
padrão: "true"-
Se o cache de análise for descartado devido a uma mudança no sistema de build, definir essa opção como falsa fará com que o Bazel saia, em vez de continuar com o build. Essa opção não tem efeito quando "discard_analysis_cache" também está definido.
Tags:eagerness_to_exit
--auto_output_filter=<none, all, packages or subpackages>
padrão: "none"- Se --output_filter não for especificado, o valor dessa opção será usado para criar um filtro automaticamente. Os valores permitidos são "none" (não filtrar nada / mostrar tudo), "all" (filtrar tudo / mostrar nada), "packages" (incluir a saída de regras em pacotes mencionados na linha de comando do Blaze) e "subpackages" (como "packages", mas também inclui subpacotes). Para os valores de "packages" e "subpackages", //java/foo e //javatests/foo são tratados como um pacote).
--[no]build_manual_tests
padrão: "false"- Força que os destinos de teste marcados como "manual" sejam criados. Os testes "manuais" são excluídos do processamento. Essa opção força a criação deles, mas não a execução.
--build_tag_filters=<comma-separated list of options>
padrão: ""- Especifica uma lista de tags separadas por vírgulas. Cada tag pode ser precedida por "-" para especificar tags excluídas. Somente os segmentos que contêm pelo menos uma tag incluída e nenhuma tag excluída serão criados. Essa opção não afeta o conjunto de testes executados com o comando "test", que são regidos pelas opções de filtragem de teste, por exemplo, "--test_tag_filters".
--[no]build_tests_only
padrão: "false"- Se especificado, apenas as regras *_test e test_suite serão criadas, e as outras metas especificadas na linha de comando serão ignoradas. Por padrão, tudo o que foi solicitado será criado.
--combined_report=<none or lcov>
padrão: "none"- Especifica o tipo de relatório de cobertura cumulativa desejado. No momento, apenas o LCOV é aceito.
--[no]compile_one_dependency
padrão: "false"- Compile uma única dependência dos arquivos de argumento. Isso é útil para verificar a sintaxe de arquivos de origem em IDEs, por exemplo, ao recriar um único destino que depende do arquivo de origem para detectar erros o mais cedo possível no ciclo de edição/build/teste. Esse argumento afeta a maneira como todos os argumentos sem sinalizações são interpretados. Em vez de serem destinos para build, eles são nomes de arquivo de origem. Para cada nome de arquivo de origem, um destino arbitrário que depende dele será criado.
- Vários usos de
--deleted_packages=<comma-separated list of package names>
são acumulados - Uma lista separada por vírgulas de nomes de pacotes que o sistema de build vai considerar inexistentes, mesmo que estejam visíveis em algum lugar no caminho do pacote. Use essa opção ao excluir um subpacote "x/y" de um pacote "x" existente. Por exemplo, depois de excluir x/y/BUILD no cliente, o sistema de build pode reclamar se encontrar um rótulo '//x:y/z', caso ele ainda seja fornecido por outra entrada de package_path. Especificar --deleted_packages x/y evita esse problema.
--[no]discard_analysis_cache
padrão: "false"- Descarte o cache de análise imediatamente após a conclusão da fase de análise. Reduz o uso de memória em cerca de 10%, mas torna os builds incrementais mais lentos.
--disk_cache=<a path>
padrão: consulte a descrição- Um caminho para um diretório em que o Bazel pode ler e gravar ações e saídas de ação. Se o diretório não existir, ele será criado.
--embed_label=<a one-line string>
padrão: ""- Incorporar rótulo de lançamento ou revisão de controle de origem em binário
--execution_log_binary_file=<a path>
padrão: consulte a descrição- Registre as execuções executadas neste arquivo como protos SpawnExec delimitados por comprimento, de acordo com src/main/protobuf/spawn.proto. Use --execution_log_compact_file, que é significativamente menor e mais barato de produzir. Flags relacionadas: --execution_log_compact_file (formato compacto; mutuamente exclusivo), --execution_log_json_file (formato JSON de texto; mutuamente exclusivo), --execution_log_sort (se quer classificar o registro de execução), --subcommands (para mostrar subcomandos na saída do terminal).
--execution_log_compact_file=<a path>
padrão: consulte a descrição- Registre as execuções executadas neste arquivo como protos ExecLogEntry delimitados por comprimento, de acordo com src/main/protobuf/spawn.proto. O arquivo inteiro é compactado com zstd. Flags relacionadas: --execution_log_binary_file (formato protobuf binário; mutuamente exclusivo), --execution_log_json_file (formato JSON de texto; mutuamente exclusivo) e --subcommands (para mostrar subcomandos na saída do terminal).
--execution_log_json_file=<a path>
padrão: consulte a descrição- Registre as execuções executadas neste arquivo como representações JSON de delimitadores de nova linha de protos SpawnExec, de acordo com src/main/protobuf/spawn.proto. Use --execution_log_compact_file, que é significativamente menor e mais barato de produzir. Flags relacionadas: --execution_log_compact_file (formato compacto; mutuamente exclusivo), --execution_log_binary_file (formato protobuf binário; mutuamente exclusivo), --execution_log_sort (se o registro de execução será classificado), --subcommands (para mostrar subcomandos na saída do terminal).
--[no]execution_log_sort
padrão: "true"- Define se o registro de execução será classificado, facilitando a comparação dos registros entre as invocações. Defina como "false" para evitar o uso potencialmente significativo de CPU e memória no final da invocação, ao custo de produzir o registro em ordem de execução não determinística. Aplica-se apenas aos formatos binário e JSON. O formato compacto nunca é classificado.
--[no]expand_test_suites
padrão: "true"-
Expande os destinos de test_suite nos testes constituintes antes da análise. Quando essa flag está ativada (padrão), os padrões de destino negativos são aplicados aos testes pertencentes ao conjunto de testes. Caso contrário, eles não são aplicados. Desabilitar essa flag é útil quando aspectos de nível superior são aplicados na linha de comando. Assim, eles podem analisar os destinos de test_suite.
Tags:loading_and_analysis
--experimental_disk_cache_gc_idle_delay=<An immutable length of time.>
padrão: "5m"- Por quanto tempo o servidor precisa permanecer ocioso antes que ocorra uma coleta de lixo do cache do disco. Para especificar a política de coleta de lixo, defina --experimental_disk_cache_gc_max_size e/ou --experimental_disk_cache_gc_max_age.
--experimental_disk_cache_gc_max_age=<An immutable length of time.>
padrão: "0"- Se definido como um valor positivo, o cache do disco será coletado como lixo periodicamente para remover entradas mais antigas que essa idade. Se definido em conjunto com --experimental_disk_cache_gc_max_size, ambos os critérios serão aplicados. A coleta de lixo ocorre em segundo plano quando o servidor fica ocioso, conforme determinado pela flag --experimental_disk_cache_gc_idle_delay.
--experimental_disk_cache_gc_max_size=<a size in bytes, optionally followed by a K, M, G or T multiplier>
padrão: "0"- Se definido como um valor positivo, o cache do disco será coletado periodicamente para permanecer abaixo desse tamanho. Se definido em conjunto com --experimental_disk_cache_gc_max_age, ambos os critérios são aplicados. A coleta de lixo ocorre em segundo plano quando o servidor fica ocioso, conforme determinado pela flag --experimental_disk_cache_gc_idle_delay.
--experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
padrão: ""- foi descontinuado em favor de aspectos. Filtra o conjunto de metas para programar extra_actions.
--[no]experimental_extra_action_top_level_only
padrão: "false"- foi descontinuado em favor de aspectos. Só programa extra_actions para destinos de nível superior.
--experimental_spawn_scheduler
-
Ative a execução dinâmica executando ações localmente e remotamente em paralelo. O Bazel gera cada ação local e remotamente e escolhe a que for concluída primeiro. Se uma ação oferecer suporte a workers, a ação local será executada no modo de worker permanente. Para ativar a execução dinâmica de uma mnemônica de ação individual, use as flags `--internal_spawn_scheduler` e `--strategy=<mnemonic>=dynamic`.
É expandido para:
--internal_spawn_scheduler
--spawn_strategy=dynamic
--[no]fetch
padrão: "true"- Permite que o comando busque dependências externas. Se definido como "false", o comando vai usar qualquer versão em cache da dependência. Se nenhuma existir, o comando vai resultar em falha.
--local_termination_grace_seconds=<an integer>
padrão: "15"- Tempo de espera entre o encerramento de um processo local devido ao tempo limite e o encerramento forçado.
--package_path=<colon-separated list of options>
padrão: "%workspace%"- Uma lista separada por dois-pontos de onde procurar pacotes. Os elementos que começam com "%workspace%" são relativos ao espaço de trabalho que os contém. Se omitido ou vazio, o padrão é a saída de "bazel info default-package-path".
--[no]show_loading_progress
padrão: "true"- Se ativado, faz com que o Bazel imprima mensagens "Carregando pacote:".
--test_lang_filters=<comma-separated list of options>
padrão: ""- Especifica uma lista separada por vírgulas de idiomas de teste. Cada idioma pode ser precedido por "-" para especificar os idiomas excluídos. Somente os destinos de teste escritos nos idiomas especificados serão encontrados. O nome usado para cada idioma precisa ser igual ao prefixo do idioma na regra *_test, por exemplo, 'cc', 'java', 'py' etc. Essa opção afeta o comportamento de --build_tests_only e o comando de teste.
--test_size_filters=<comma-separated list of values: small, medium, large, or enormous>
padrão: ""- Especifica uma lista separada por vírgulas de tamanhos de teste. Cada tamanho pode ser precedido por "-" para especificar os tamanhos excluídos. Somente as áreas de teste que contêm pelo menos um tamanho incluído e nenhum tamanho excluído serão encontradas. Essa opção afeta o comportamento de --build_tests_only e o comando de teste.
--test_tag_filters=<comma-separated list of options>
padrão: ""- Especifica uma lista separada por vírgulas de tags de teste. Cada tag pode ser precedida por "-" para especificar tags excluídas. Somente os destinos de teste que contêm pelo menos uma tag incluída e nenhuma tag excluída serão encontrados. Essa opção afeta o comportamento de --build_tests_only e o comando de teste.
--test_timeout_filters=<comma-separated list of values: short, moderate, long, or eternal>
padrão: ""- Especifica uma lista separada por vírgulas de tempos limite de teste. Cada tempo limite pode ser precedido por "-" para especificar os tempos limite excluídos. Somente os destinos de teste que contêm pelo menos um tempo limite incluído e nenhum tempo limite excluído serão encontrados. Essa opção afeta o comportamento de --build_tests_only e o comando de teste.
--workspace_status_command=<path>
padrão: ""- Um comando invocado no início do build para fornecer informações de status sobre o espaço de trabalho na forma de pares de chave-valor. Consulte o manual do usuário para conferir a especificação completa. Consulte também tools/buildstamp/get_workspace_status para conferir um exemplo.
- Opções que controlam a execução do build:
--[no]experimental_inprocess_symlink_creation
padrão: "true"-
Define se é possível fazer chamadas diretas do sistema de arquivos para criar árvores de links simbólicos em vez de delegar a um processo auxiliar.
Tags:loading_and_analysis
,execution
,experimental
--[no]experimental_persistent_aar_extractor
padrão: "false"-
Ative o extrator de aar persistente usando workers.
Tags:execution
,experimental
--[no]experimental_remotable_source_manifests
padrão: "false"-
Define se as ações de manifesto de origem podem ser remotas
Tags:loading_and_analysis
,execution
,experimental
--[no]experimental_split_coverage_postprocessing
padrão: "false"-
Se verdadeiro, o Bazel vai executar o pós-processamento de cobertura para teste em uma nova geração.
Tags:execution
,experimental
--[no]experimental_strict_fileset_output
padrão: "false"-
Se essa opção estiver ativada, os conjuntos de arquivos vão tratar todos os artefatos de saída como arquivos comuns. Eles não atravessam diretórios nem são sensíveis a links simbólicos.
Tags:execution
,experimental
--[no]incompatible_modify_execution_info_additive
padrão: "false"-
Quando ativada, a transmissão de várias flags --modify_execution_info é aditiva. Quando desativado, apenas a última flag é considerada.
Tags:execution
,affects_outputs
,loading_and_analysis
,incompatible_change
- Vários usos de
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
são acumulados -
Adiciona ou remove chaves das informações de execução de uma ação com base na mnemônica da ação. Aplicável apenas a ações que oferecem suporte a informações de execução. Muitas ações comuns oferecem suporte a informações de execução, por exemplo, Genrule, CppCompile, Javac, StarlarkAction e TestRunner. Ao especificar vários valores, a ordem é importante, porque muitas expressões regulares podem ser aplicadas ao mesmo mnemônico.
Sintaxe: "regex=[+-]chave,regex=[+-]chave,...".
Exemplos:
'.*=+x,.*=-y,.*=+z' adiciona "x" e "z" e remove "y" das informações de execução de todas as ações.
"Genrule=+requires-x" adiciona "requires-x" às informações de execução de todas as ações de Genrule.
'(?!Genrule).*=-requires-x' remove 'requires-x' das informações de execução de todas as ações que não são Genrule.
Tags:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Ative ações persistentes de dex e desugar do Android usando workers.
É expandido para:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Tags:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
-
Ative o processador de recursos Android persistente usando workers.
Expande para:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
--strategy=ProcessDatabinding=worker
--strategy=GenerateDataBindingBaseClasses=worker
Tags:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_dex_desugar
-
Ative ações persistentes de dex e desugar Android multiplexadas usando workers.
Expande para:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
Tags:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
Ative o processador de recursos Android multiplexado permanente usando workers.
Expande para:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
Tags:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_tools
-
Ative ferramentas Android persistentes e multiplexadas (dexing, desugaring, processamento de recursos).
É expandido para:
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Tags:host_machine_resource_optimizations
,execution
--[no]use_target_platform_for_tests
padrão: "false"-
Se verdadeiro, o Bazel vai usar a plataforma de destino para executar testes em vez do grupo de execução de teste.
Tags
:execution
- Opções que configuram a cadeia de ferramentas usada para a execução de ações:
--android_compiler=<a string>
padrão: consulte a descrição-
O compilador de destino do Android.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
padrão: "android"-
Seleciona a combinação de manifesto a ser usada para regras android_binary. Flag para ajudar na transição para a combinação de manifestos do Android da combinação legada.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_platforms=<a build target label>
padrão: ""-
Define as plataformas que os destinos android_binary usam. Se várias plataformas forem especificadas, o binário será um APK grande, que contém binários nativos para cada plataforma de destino especificada.
Tags:changes_inputs
,loading_and_analysis
,loses_incremental_state
--apple_crosstool_top=<a build target label>
padrão: "@bazel_tools//tools/cpp:toolchain"-
O rótulo do pacote de ferramentas cruzadas a ser usado nas regras da Apple e do Objc e nas dependências deles.
Tags:loses_incremental_state
,changes_inputs
--cc_output_directory_tag=<a string>
padrão: ""-
Especifica um sufixo a ser adicionado ao diretório de configuração.
Tags:affects_outputs
--compiler=<a string>
padrão: consulte a descrição-
O compilador C++ a ser usado para compilar o destino.
Tags:loading_and_analysis
,execution
--coverage_output_generator=<a build target label>
padrão: "@bazel_tools//tools/test:lcov_merger"-
Local do binário usado para pós-processar relatórios de cobertura brutos. No momento, ele precisa ser um grupo de arquivos que contém um único arquivo, o binário. O padrão é "//tools/test:lcov_merger".
Tags:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
padrão: "@bazel_tools//tools/test:coverage_report_generator"-
Local do binário usado para gerar relatórios de cobertura. No momento, ele precisa ser um grupo de arquivos que contém um único arquivo, o binário. O padrão é "//tools/test:coverage_report_generator".
Tags:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
padrão: "@bazel_tools//tools/test:coverage_support"-
Local dos arquivos de suporte necessários nas entradas de cada ação de teste que coleta a cobertura do código. O padrão é "//tools/test:coverage_support".
Tags:changes_inputs
,affects_outputs
,loading_and_analysis
--custom_malloc=<a build target label>
padrão: consulte a descrição-
Especifica uma implementação personalizada de malloc. Essa configuração substitui os atributos malloc nas regras de build.
Tags:changes_inputs
,affects_outputs
- Vários usos de
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
são acumulados -
Lista de expressões regulares separadas por vírgulas, cada uma opcionalmente prefixada por - (expressão negativa), atribuída a (=) a uma lista de destinos de valor de restrição separados por vírgulas. Se um destino corresponder a nenhuma expressão negativa e a pelo menos uma expressão positiva, a resolução da cadeia de ferramentas será realizada como se tivesse declarado os valores de restrição como restrições de execução. Exemplo: //demo,-test=@platforms//cpus:x86_64 vai adicionar "x86_64" a qualquer destino em //demo, exceto aqueles cujo nome contém "test".
Tags:loading_and_analysis
--[no]experimental_include_xcode_execution_requirements
padrão: "false"-
Se definido, adicione um requisito de execução "requires-xcode:{version}" a cada ação do Xcode. Se a versão do Xcode tiver um rótulo com hífen, adicione também um requisito de execução "requires-xcode-label:{version_label}".
Tags:loses_incremental_state
,loading_and_analysis
,execution
,experimental
--[no]experimental_prefer_mutual_xcode
padrão: "true"-
Se verdadeiro, use o Xcode mais recente disponível local e remotamente. Se for falso ou se não houver versões disponíveis em comum, use a versão local do Xcode selecionada pelo xcode-select.
Tags:loses_incremental_state
,experimental
--extra_execution_platforms=<comma-separated list of options>
padrão: ""-
As plataformas de execução disponíveis para executar ações. As plataformas podem ser especificadas por destino exato ou como um padrão de destino. Essas plataformas serão consideradas antes daquelas declaradas no arquivo WORKSPACE por register_execution_platforms(). Essa opção só pode ser definida uma vez. As instâncias posteriores vão substituir as configurações de sinalizações anteriores.
Tags:execution
- Vários usos de
--extra_toolchains=<comma-separated list of options>
são acumulados -
As regras do conjunto de ferramentas que serão consideradas durante a resolução do conjunto de ferramentas. As cadeias de ferramentas podem ser especificadas por destino exato ou como um padrão de destino. Esses conjuntos de ferramentas serão considerados antes dos declarados no arquivo WORKSPACE por register_toolchains().
Tags:affects_outputs
,changes_inputs
,loading_and_analysis
--grte_top=<a label>
padrão: consulte a descrição-
Um rótulo para uma biblioteca libc registrada. O valor padrão é selecionado pela cadeia de ferramentas de crosstool, e você quase nunca precisa substituí-lo.
Tags:action_command_lines
,affects_outputs
--host_compiler=<a string>
padrão: consulte a descrição-
Flag de no-op. Será removido em uma versão futura.
Tags:loading_and_analysis
,execution
--host_grte_top=<a label>
padrão: consulte a descrição-
Se especificado, essa configuração substitui o diretório de nível superior libc (--grte_top) para a configuração de execução.
Tags:action_command_lines
,affects_outputs
--host_platform=<a build target label>
padrão: "@bazel_tools//tools:host_platform"-
O rótulo de uma regra de plataforma que descreve o sistema de host.
Tags:affects_outputs
,changes_inputs
,loading_and_analysis
--[no]incompatible_bazel_test_exec_run_under
padrão: "false"-
Se ativado, "bazel test --run_under=//:runner" cria "//:runner" na configuração de execução. Se desativado, ele cria "//:runner" na configuração de destino. O Bazel executa testes em máquinas de execução, portanto, o primeiro é mais correto. Isso não afeta o "bazel run", que sempre gera "`--run_under=//foo" na configuração de destino.
Tags:affects_outputs
,incompatible_change
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
padrão: "true"-
Se verdadeiro, o Bazel não vai ativar os recursos "host" e "nonhost" na cadeia de ferramentas C++. Consulte https://github.com/bazelbuild/bazel/issues/7407 para mais informações.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_apple_toolchain_resolution
padrão: "false"-
Use a resolução do toolchain para selecionar o SDK da Apple para regras da Apple (Starlark e nativa)
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_legacy_whole_archive
padrão: "true"-
Se verdadeiro, o Bazel não vai vincular as dependências de biblioteca como um arquivo completo por padrão (consulte https://github.com/bazelbuild/bazel/issues/7362 para instruções de migração).
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_strip_executable_safely
padrão: "false"-
Se verdadeiro, a ação de remoção para executáveis vai usar a flag -x, que não interrompe a resolução de símbolos dinâmicos.
Tags:action_command_lines
,incompatible_change
-
Use objetos compartilhados de interface se o conjunto de ferramentas oferecer suporte a eles. Todas as cadeias de ferramentas ELF atualmente oferecem suporte a essa configuração.
Tags:loading_and_analysis
,affects_outputs
,affects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
Especifica a versão do SDK para iOS a ser usada para criar aplicativos iOS. Se não for especificado, vai usar a versão padrão do SDK para iOS de "xcode_version".
Tags:loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
Especifica a versão do SDK do macOS a ser usada para criar aplicativos do macOS. Se não for especificado, vai usar a versão padrão do SDK do macOS de "xcode_version".
Tags:loses_incremental_state
--minimum_os_version=<a string>
padrão: consulte a descrição-
A versão mínima do SO para a qual a compilação é direcionada.
Tags:loading_and_analysis
,affects_outputs
--platform_mappings=<a main workspace-relative path>
padrão: ""-
O local de um arquivo de mapeamento que descreve qual plataforma usar se nenhuma estiver definida ou quais flags definir quando uma plataforma já existir. Precisa ser relativo à raiz do espaço de trabalho principal. O padrão é "platform_mappings" (um arquivo diretamente na raiz do espaço de trabalho).
Tags:affects_outputs
,changes_inputs
,loading_and_analysis
,immutable
--platforms=<a build target label>
padrão: ""-
Os rótulos das regras da plataforma que descrevem as plataformas de destino do comando atual.
Tags:affects_outputs
,changes_inputs
,loading_and_analysis
--python_path=<a string>
padrão: consulte a descrição-
O caminho absoluto do interpretador de Python invocado para executar destinos do Python na plataforma de destino. Obsoleto. Desativado por --incompatible_use_python_toolchains.
Tags:loading_and_analysis
,affects_outputs
--python_top=<a build target label>
padrão: consulte a descrição-
O identificador de um py_runtime que representa o interpretador de Python invocado para executar destinos do Python na plataforma de destino. Obsoleto. Desativado por --incompatible_use_python_toolchains.
Tags:loading_and_analysis
,affects_outputs
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
Especifica a versão do SDK do tvOS a ser usada para criar aplicativos para tvOS. Se não for especificado, vai usar a versão padrão do SDK para tvOS de "xcode_version".
Tags:loses_incremental_state
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
Especifica a versão do SDK do watchOS a ser usada para criar aplicativos do watchOS. Se não for especificado, vai usar a versão padrão do SDK do watchOS de "xcode_version".
Tags:loses_incremental_state
--xcode_version=<a string>
padrão: consulte a descrição-
Se especificado, usa o Xcode da versão especificada para ações de build relevantes. Se não for especificado, vai usar a versão padrão do executor do Xcode.
Tags:loses_incremental_state
--xcode_version_config=<a build target label>
padrão: "@bazel_tools//tools/cpp:host_xcodes"-
O rótulo da regra xcode_config a ser usado para selecionar a versão do Xcode na configuração do build.
Tags
:loses_incremental_state
,loading_and_analysis
- Opções que controlam a saída do comando:
--[no]apple_generate_dsym
padrão: "false"-
Define se é necessário gerar arquivos de símbolo de depuração (.dSYM).
Tags:affects_outputs
,action_command_lines
--[no]build_runfile_links
padrão: "true"-
Se verdadeiro, cria florestas de links simbólicos de arquivos de execução para todos os destinos. Se for falso, grave-os somente quando for necessário por uma ação local, um comando de teste ou de execução.
Tags:affects_outputs
--[no]build_runfile_manifests
padrão: "true"-
Se verdadeiro, grava manifestos de runfiles para todos os destinos. Se for falso, omita-os. Os testes locais não serão executados quando for falso.
Tags:affects_outputs
--[no]build_test_dwp
padrão: "false"-
Se ativado, ao criar testes C++ de forma estática e com fissão, o arquivo .dwp do binário de teste também será criado automaticamente.
Tags:loading_and_analysis
,affects_outputs
--cc_proto_library_header_suffixes=<comma-separated set of options>
padrão: ".pb.h"-
Define os sufixos dos arquivos de cabeçalho que uma cc_proto_library cria.
Tags:affects_outputs
,loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated set of options>
padrão: ".pb.cc"-
Define os sufixos dos arquivos de origem que uma cc_proto_library cria.
Tags:affects_outputs
,loading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info
padrão: "false"-
Execute ações extras para versões alternativas de API Java em uma proto_library.
Tags:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_save_feature_state
padrão: "false"-
Salve o estado dos recursos ativados e solicitados como uma saída da compilação.
Tags:affects_outputs
,experimental
--fission=<a set of compilation modes>
padrão: "no"-
Especifica quais modos de compilação usam a divisão para compilações e links em C++. Pode ser qualquer combinação de {'fastbuild', 'dbg', 'opt'} ou os valores especiais 'yes' para ativar todos os modos e 'no' para desativar todos os modos.
Tags:loading_and_analysis
,action_command_lines
,affects_outputs
--[no]incompatible_always_include_files_in_data
padrão: "true"-
Se verdadeiro, as regras nativas adicionam <code>DefaultInfo.files</code> de dependências de dados aos runfiles, o que corresponde ao comportamento recomendado para regras do Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid).
Tags:affects_outputs
,incompatible_change
--[no]legacy_external_runfiles
padrão: "false"-
Se verdadeiro, crie florestas de links simbólicos de arquivos de execução para repositórios externos em .runfiles/wsname/external/repo (além de .runfiles/repo).
Tags:affects_outputs
--[no]objc_generate_linkmap
padrão: "false"-
Especifica se um arquivo de linkmap será gerado.
Tags:affects_outputs
--[no]save_temps
padrão: "false"-
Se definido, as saídas temporárias do gcc serão salvas. Isso inclui arquivos .s (código do assembler), .i (C pré-processado) e .ii (C++ pré-processado).
Tags
:affects_outputs
- Opções que permitem ao usuário configurar a saída pretendida, afetando o valor, em vez de sua existência:
- Vários usos de
--action_env=<a 'name=value' assignment with an optional value part>
são acumulados -
Especifica o conjunto de variáveis de ambiente disponível para ações com configuração de destino. As variáveis podem ser especificadas por nome, e nesse caso o valor é retirado do ambiente de invocação, ou pelo par name=value, que define o valor independente do ambiente de invocação. Essa opção pode ser usada várias vezes. Para opções fornecidas para a mesma variável, as mais recentes vencem, e as opções para variáveis diferentes são acumuladas.
Tags:action_command_lines
--allowed_cpu_values=<comma-separated set of options>
padrão: ""-
Valores permitidos para a flag --cpu.
Tags:changes_inputs
,affects_outputs
--[no]android_databinding_use_androidx
padrão: "true"-
Gera arquivos de vinculação de dados compatíveis com o AndroidX. É usado apenas com a vinculação de dados v2. Essa flag não tem efeito.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]android_databinding_use_v3_4_args
padrão: "true"-
Use o Databinding v2 do Android com o argumento 3.4.0. Essa flag não tem efeito.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--android_dynamic_mode=<off, default or fully>
padrão: "desativado"-
Determina se as dependências C++ das regras do Android serão vinculadas dinamicamente quando um cc_binary não criar explicitamente uma biblioteca compartilhada. "default" significa que o Bazel vai escolher se vai vincular dinamicamente. "totalmente" significa que todas as bibliotecas serão vinculadas dinamicamente. "off" significa que todas as bibliotecas serão vinculadas no modo quase estático.
Tags:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
padrão: "alphabetical"-
Define a ordem dos manifestos transmitidos para a combinação de manifestos para binários do Android. ALPHABETICAL significa que os manifestos são classificados por caminho em relação ao execroot. ALPHABETICAL_BY_CONFIGURATION significa que os manifestos são classificados por caminhos relativos ao diretório de configuração no diretório de saída. DEPENDENCY significa que os manifestos são ordenados com o manifesto de cada biblioteca antes dos manifestos das dependências.
Tags:action_command_lines
,execution
--[no]android_resource_shrinking
padrão: "false"-
Ativa a redução de recursos para APKs android_binary que usam o ProGuard.
Tags:affects_outputs
,loading_and_analysis
--[no]build_python_zip
padrão: "auto"-
Criar um zip de executável do Python; ativado no Windows, desativado em outras plataformas
Tags:affects_outputs
- Vários usos de
--catalyst_cpus=<comma-separated list of options>
são acumulados -
Lista separada por vírgulas de arquiteturas para as quais criar binários do Apple Catalyst.
Tags:loses_incremental_state
,loading_and_analysis
--[no]collect_code_coverage
padrão: "false"-
Se especificado, o Bazel vai instrumentar o código (usando a instrumentação off-line sempre que possível) e coletar informações de cobertura durante os testes. Somente os destinos que correspondem a --instrumentation_filter serão afetados. Normalmente, essa opção não precisa ser especificada diretamente. Em vez disso, use o comando "bazel coverage".
Tags:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] padrão: "fastbuild"-
Especifica o modo em que o binário será criado. Valores: "fastbuild", "dbg", "opt".
Tags:affects_outputs
,action_command_lines
- Vários usos de
--conlyopt=<a string>
são acumulados -
Opção adicional para transmitir ao gcc ao compilar arquivos de origem C.
Tags:action_command_lines
,affects_outputs
- Vários usos de
--copt=<a string>
são acumulados -
Opções adicionais para transmitir ao gcc.
Tags:action_command_lines
,affects_outputs
--cpu=<a string>
padrão: ""-
A CPU de destino.
Tags:changes_inputs
,affects_outputs
--cs_fdo_absolute_path=<a string>
padrão: consulte a descrição-
Use as informações do perfil do CSFDO para otimizar a compilação. Especifique o nome do caminho absoluto do arquivo ZIP que contém o arquivo de perfil, um arquivo de perfil LLVM bruto ou indexado.
Tags:affects_outputs
--cs_fdo_instrument=<a string>
padrão: consulte a descrição-
Gera binários com instrumentação FDO sensível ao contexto. Com o compilador Clang/LLVM, ele também aceita o nome do diretório em que os arquivos de perfil brutos serão armazenados em disco no momento da execução.
Tags:affects_outputs
--cs_fdo_profile=<a build target label>
padrão: consulte a descrição-
O cs_fdo_profile representa o perfil sensível ao contexto a ser usado para otimização.
Tags:affects_outputs
- Vários usos de
--cxxopt=<a string>
são acumulados -
Opção extra para transmitir ao gcc ao compilar arquivos-fonte C++.
Tags:action_command_lines
,affects_outputs
- Vários usos de
--define=<a 'name=value' assignment>
são acumulados -
Cada opção --define especifica uma atribuição para uma variável de build. No caso de vários valores para uma variável, o último é o vencedor.
Tags:changes_inputs
,affects_outputs
--dynamic_mode=<off, default or fully>
padrão: "default"-
Determina se os binários C++ serão vinculados de forma dinâmica. "default" significa que o Bazel vai escolher se vai vincular dinamicamente. "totalmente" significa que todas as bibliotecas serão vinculadas dinamicamente. "off" significa que todas as bibliotecas serão vinculadas no modo quase estático.
Tags:loading_and_analysis
,affects_outputs
--[no]enable_propeller_optimize_absolute_paths
padrão: "true"-
Se definido, qualquer uso de caminhos absolutos para o propeller optimize vai gerar um erro.
Tags:affects_outputs
--[no]enable_remaining_fdo_absolute_paths
padrão: "true"-
Se definido, qualquer uso de caminhos absolutos para FDO vai gerar um erro.
Tags:affects_outputs
--[no]enable_runfiles
padrão: "auto"-
Ative a árvore de links simbólicos de runfiles. Por padrão, ela fica desativada no Windows e ativada em outras plataformas.
Tags:affects_outputs
- Vários usos de
--experimental_action_listener=<a build target label>
são acumulados -
foi descontinuado em favor de aspectos. Use action_listener para anexar uma extra_action às ações de build atuais.
Tags:execution
,experimental
--[no]experimental_android_compress_java_resources
padrão: "false"-
Compactar recursos Java em APKs
Tags:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_android_databinding_v2
padrão: "true"-
Use o Databinding v2 do Android. Essa flag não tem efeito.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_android_resource_shrinking
padrão: "false"-
Ativa a redução de recursos para APKs android_binary que usam o ProGuard.
Tags:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_android_rewrite_dexes_with_rex
padrão: "false"-
use a ferramenta rex para reescrever arquivos dex
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_collect_code_coverage_for_generated_files
padrão: "false"-
Se especificado, o Bazel também vai gerar informações de cobertura de coleta para arquivos gerados.
Tags:affects_outputs
,experimental
--experimental_objc_fastbuild_options=<comma-separated list of options>
padrão: "-O0,-DDEBUG=1"-
Usa essas strings como opções de compilador de build rápido do objc.
Tags:action_command_lines
--[no]experimental_omitfp
padrão: "false"-
Se verdadeiro, use libunwind para desfazer a pilha e compile com -fomit-frame-pointer e -fasynchronous-unwind-tables.
Tags:action_command_lines
,affects_outputs
,experimental
--experimental_output_paths=<off, content or strip>
padrão: "desativado"-
Qual modelo usar para onde as regras da árvore de saídas gravam as saídas, principalmente para builds multiplataforma / multiconfiguração. Esse recurso é altamente experimental. Consulte https://github.com/bazelbuild/bazel/issues/6526 para saber mais. As ações do Starlark podem optar pelo mapeamento de caminho adicionando a chave "supports-path-mapping" ao dicionário "execution_requirements".
Tags:loses_incremental_state
,bazel_internal_configuration
,affects_outputs
,execution
- Vários usos de
--experimental_override_name_platform_in_output_dir=<a 'label=value' assignment>
são acumulados -
Cada entrada precisa estar no formato rótulo=valor, em que "rótulo" se refere a uma plataforma e "valor" é o nome abreviado desejado para usar no caminho de saída. Só é usado quando --experimental_platform_in_output_dir é verdadeiro. Tem a maior prioridade de nomenclatura.
Tags:affects_outputs
,experimental
--[no]experimental_platform_in_output_dir
padrão: "false"-
Se verdadeiro, um nome abreviado para a plataforma de destino é usado no nome do diretório de saída em vez da CPU. O esquema exato é experimental e sujeito a mudanças: primeiro, no caso raro em que a opção --platforms não tem exatamente um valor, um hash da opção platforms é usado. Em seguida, se algum nome abreviado para a plataforma atual tiver sido registrado por --experimental_override_name_platform_in_output_dir, esse nome abreviado será usado. Em seguida, se --experimental_use_platforms_in_output_dir_legacy_heuristic estiver definido, use um nome abreviado com base no rótulo da plataforma atual. Por fim, um hash da opção de plataforma é usado como último recurso.
Tags:affects_outputs
,experimental
--[no]experimental_py_binaries_include_label
padrão: "false"-
Os destinos py_binary incluem o rótulo mesmo quando a marcação está desativada.
Tags:affects_outputs
,experimental
--[no]experimental_use_llvm_covmap
padrão: "false"-
Se especificado, o Bazel vai gerar informações do mapa de cobertura llvm-cov em vez de gcov quando o collect_code_coverage estiver ativado.
Tags:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic
padrão: "true"-
Use essa flag apenas como parte de uma estratégia de migração ou teste sugerida. A heurística tem deficiências conhecidas, e é recomendável migrar para usar apenas --experimental_override_name_platform_in_output_dir.
Tags:affects_outputs
,experimental
--fdo_instrument=<a string>
padrão: consulte a descrição-
Gera binários com instrumentação FDO. Com o compilador Clang/LLVM, ele também aceita o nome do diretório em que os arquivos de perfil brutos serão armazenados em disco no momento da execução.
Tags:affects_outputs
--fdo_optimize=<a string>
padrão: consulte a descrição-
Use informações do perfil de FDO para otimizar a compilação. Especifique o nome de um arquivo ZIP que contém uma árvore de arquivos .gcda, um arquivo afdo com um perfil automático ou um arquivo de perfil LLVM. Essa flag também aceita arquivos especificados como rótulos (por exemplo, "//foo/bar:file.afdo". Talvez seja necessário adicionar uma diretiva "exports_files" ao pacote correspondente) e rótulos que apontam para destinos "fdo_profile". Essa flag será substituída pela regra "fdo_profile".
Tags:affects_outputs
--fdo_prefetch_hints=<a build target label>
padrão: consulte a descrição-
Use dicas de pré-busca de cache.
Tags:affects_outputs
--fdo_profile=<a build target label>
padrão: consulte a descrição-
O fdo_profile que representa o perfil a ser usado para otimização.
Tags de
:affects_outputs
- Vários usos de
--features=<a string>
são acumulados -
Os recursos serão ativados ou desativados por padrão para destinos criados na configuração de destino. Especificar -<feature> desativa o recurso. Os recursos negativos sempre substituem os positivos. Consulte também as tags --host_features
:changes_inputs
,affects_outputs
--[no]force_pic
padrão: "false"-
Se ativado, todas as compilações C++ vão produzir código independente de posição ("-fPIC"), os links vão preferir bibliotecas pré-criadas PIC em vez de bibliotecas não-PIC, e os links vão produzir executáveis independentes de posição ("-pie").
Tags:loading_and_analysis
,affects_outputs
- Vários usos de
--host_action_env=<a 'name=value' assignment with an optional value part>
são acumulados -
Especifica o conjunto de variáveis de ambiente disponível para ações com configurações de execução. As variáveis podem ser especificadas por nome, caso em que o valor será retirado do ambiente de invocação, ou pelo par name=value, que define o valor independente do ambiente de invocação. Essa opção pode ser usada várias vezes. Para opções fornecidas para a mesma variável, as mais recentes vencem, e as opções para variáveis diferentes são acumuladas.
Tags:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
padrão: "opt"-
Especifica o modo em que as ferramentas usadas durante o build serão integradas. Valores: "fastbuild", "dbg", "opt".
Tags:affects_outputs
,action_command_lines
- Vários usos de
--host_conlyopt=<a string>
são acumulados -
Opção adicional para transmitir ao compilador C ao compilar arquivos-fonte C (mas não C++) nas configurações de execução.
Tags:action_command_lines
,affects_outputs
- Vários usos de
--host_copt=<a string>
são acumulados -
Opções adicionais para transmitir ao compilador C para ferramentas criadas nas configurações de execução.
Tags:action_command_lines
,affects_outputs
--host_cpu=<a string>
padrão: ""-
A CPU host.
Tags:changes_inputs
,affects_outputs
- Vários usos de
--host_cxxopt=<a string>
são acumulados -
Opções adicionais para transmitir ao compilador C++ para ferramentas criadas nas configurações de execução.
Tags:action_command_lines
,affects_outputs
- Vários usos de
--host_features=<a string>
são acumulados -
Os recursos especificados serão ativados ou desativados por padrão para os destinos criados na configuração de execução. Especificar -<feature> desativa o recurso. Os recursos negativos sempre substituem os positivos.
Tags:changes_inputs
,affects_outputs
--host_force_python=<PY2 or PY3>
padrão: consulte a descrição-
Substitui a versão do Python para a configuração de execução. Pode ser "PY2" ou "PY3".
Tags:loading_and_analysis
,affects_outputs
- Vários usos de
--host_linkopt=<a string>
são acumulados -
Opção adicional para transmitir ao vinculador ao vincular ferramentas nas configurações de execução.
Tags:action_command_lines
,affects_outputs
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
Versão mínima compatível do macOS para destinos do host. Se não for especificado, vai usar "macos_sdk_version".
Tags:loses_incremental_state
- Vários usos de
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
são acumulados -
Opções adicionais para transmitir seletivamente ao compilador C/C++ ao compilar determinados arquivos nas execuções de configuração. Essa opção pode ser transmitida várias vezes. Sintaxe: regex_filter@option_1,option_2,...,option_n. Em que regex_filter representa uma lista de padrões de expressão regular de inclusão e exclusão (consulte também --instrumentation_filter). option_1 a option_n representam opções arbitrárias de linha de comando. Se uma opção tiver uma vírgula, ela precisa ser colocada entre aspas com uma barra invertida. As opções podem conter @. Apenas o primeiro @ é usado para dividir a string. Exemplo: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 adiciona a opção de linha de comando -O0 à linha de comando do gcc de todos os arquivos cc em //foo/, exceto bar.cc.
Tags:action_command_lines
,affects_outputs
--[no]incompatible_auto_exec_groups
padrão: "false"-
Quando ativado, um grupo de execução é criado automaticamente para cada toolchain usado por uma regra. Para que isso funcione, a regra precisa especificar o parâmetro "toolchain" nas ações. Para mais informações, consulte https://github.com/bazelbuild/bazel/issues/17134.
Tags:affects_outputs
,incompatible_change
--[no]incompatible_merge_genfiles_directory
padrão: "true"-
Se verdadeiro, o diretório genfiles é dobrado no diretório bin.
Tags:affects_outputs
,incompatible_change
--[no]instrument_test_targets
padrão: "false"-
Quando a cobertura está ativada, especifica se é necessário considerar a instrumentação de regras de teste. Quando definido, as regras de teste incluídas por --instrumentation_filter são inspecionadas. Caso contrário, as regras de teste são sempre excluídas da instrumentação de cobertura.
Tags:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
padrão: "-/javatests[/:],-/test/java[/:]"-
Quando a cobertura está ativada, apenas as regras com nomes incluídos pelo filtro baseado em regex especificado são instrumentadas. As regras com o prefixo "-" são excluídas. Somente as regras que não são de teste são instrumentadas, a menos que --instrument_test_targets esteja ativado.
Tags:affects_outputs
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
Versão mínima compatível do iOS para simuladores e dispositivos de destino. Se não for especificado, vai usar "ios_sdk_version".
Tags:loses_incremental_state
- Vários usos de
--ios_multi_cpus=<comma-separated list of options>
são acumulados -
Lista separada por vírgulas de arquiteturas para criar um ios_application. O resultado é um binário universal que contém todas as arquiteturas especificadas.
Tags:loses_incremental_state
,loading_and_analysis
--[no]legacy_whole_archive
padrão: "true"-
Descontinuado, substituído por --incompatible_remove_legacy_whole_archive (consulte https://github.com/bazelbuild/bazel/issues/7362 para saber mais). Quando ativado, use --whole-archive para regras cc_binary que tenham linkshared=True e linkstatic=True ou '-static' em linkopts. Isso é apenas para compatibilidade com versões anteriores. Uma alternativa melhor é usar alwayslink=1 quando necessário.
Tags:action_command_lines
,affects_outputs
,deprecated
- Vários usos de
--linkopt=<a string>
são acumulados -
Opção adicional para transmitir ao gcc ao vincular.
Tags:action_command_lines
,affects_outputs
- Vários usos de
--ltobackendopt=<a string>
são acumulados -
Opção extra para passar para a etapa de back-end de LTO (em --features=thin_lto).
Tags:action_command_lines
,affects_outputs
- Vários usos de
--ltoindexopt=<a string>
são acumulados -
Opção extra para passar para a etapa de indexação de LTO (em --features=thin_lto).
Tags:action_command_lines
,affects_outputs
- Vários usos de
--macos_cpus=<comma-separated list of options>
são acumulados -
Lista separada por vírgulas de arquiteturas para as quais criar binários do Apple macOS.
Tags:loses_incremental_state
,loading_and_analysis
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
Versão mínima do macOS compatível para destinos. Se não for especificado, vai usar "macos_sdk_version".
Tags:loses_incremental_state
--memprof_profile=<a build target label>
padrão: consulte a descrição-
Use o perfil do memprof.
Tags:affects_outputs
--[no]objc_debug_with_GLIBCXX
padrão: "false"-
Se definido e o modo de compilação estiver definido como "dbg", defina GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC e GLIBCPP_CONCEPT_CHECKS.
Tags:action_command_lines
--[no]objc_enable_binary_stripping
padrão: "false"-
Define se o símbolo e o código morto serão removidos em binários vinculados. A remoção de binários será realizada se essa flag e --compilation_mode=opt forem especificados.
Tags:action_command_lines
- Vários usos de
--objccopt=<a string>
são acumulados -
Opções adicionais para transmitir ao gcc ao compilar arquivos de origem Objective-C/C++.
Tags:action_command_lines
- Vários usos de
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
são acumulados -
Opções adicionais para transmitir seletivamente ao gcc ao compilar determinados arquivos. Essa opção pode ser transmitida várias vezes. Sintaxe: regex_filter@option_1,option_2,...,option_n. Em que regex_filter representa uma lista de padrões de expressão regular de inclusão e exclusão (consulte também --instrumentation_filter). option_1 a option_n representam opções arbitrárias de linha de comando. Se uma opção tiver uma vírgula, ela precisa ser colocada entre aspas com uma barra invertida. As opções podem conter @. Apenas o primeiro @ é usado para dividir a string. Exemplo: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 adiciona a opção de linha de comando -O0 à linha de comando do gcc de todos os arquivos cc em //foo/, exceto bar.cc.
Tags:action_command_lines
,affects_outputs
- Vários usos de
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
são acumulados -
Opções adicionais para transmitir seletivamente para o back-end LTO (em --features=thin_lto) ao compilar determinados objetos de back-end. Essa opção pode ser transmitida várias vezes. Sintaxe: regex_filter@option_1,option_2,...,option_n. Em que regex_filter representa uma lista de padrões de expressão regular de inclusão e exclusão. option_1 a option_n representam opções arbitrárias de linha de comando. Se uma opção tiver uma vírgula, ela precisa ser colocada entre aspas com uma barra invertida. As opções podem conter @. Apenas o primeiro @ é usado para dividir a string. Exemplo: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 adiciona a opção de linha de comando -O0 à linha de comando do back-end de LTO de todos os arquivos em //foo/, exceto bar.o.
Tags:action_command_lines
,affects_outputs
--platform_suffix=<a string>
padrão: consulte a descrição-
Especifica um sufixo a ser adicionado ao diretório de configuração.
Tags:loses_incremental_state
,affects_outputs
,loading_and_analysis
--propeller_optimize=<a build target label>
padrão: consulte a descrição-
Use as informações do perfil do Propeller para otimizar o destino do build.Um perfil do Propeller precisa consistir em pelo menos um dos dois arquivos, um perfil cc e um perfil ld. Essa flag aceita um rótulo de build que precisa se referir aos arquivos de entrada do perfil do Propeller. Por exemplo, o arquivo BUILD que define o rótulo, em a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)Uma diretiva exports_files pode precisar ser adicionada ao pacote correspondente para que esses arquivos fiquem visíveis para o Bazel. A opção precisa ser usada como: --propeller_optimize=//a/b:propeller_profile
Tags:action_command_lines
,affects_outputs
--propeller_optimize_absolute_cc_profile=<a string>
padrão: consulte a descrição-
Nome do caminho absoluto do arquivo cc_profile para builds otimizados do Propeller.
Tags:affects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
padrão: consulte a descrição-
Nome de caminho absoluto do arquivo ld_profile para builds otimizados do Propeller.
Tags:affects_outputs
--run_under=<a prefix in front of command>
padrão: consulte a descrição-
Prefixo a ser inserido antes dos executáveis para os comandos "test" e "run". Se o valor for "foo -bar" e a linha de comando de execução for "test_binary -baz", a linha de comando final será "foo -bar test_binary -baz".Isso também pode ser um rótulo para um destino executável. Alguns exemplos são: "valgrind", "strace", "strace -c", "valgrind --quiet --num-callers=20", "//package:target", "//package:target --options".
Tags:action_command_lines
-
Se verdadeiro, as bibliotecas nativas que contêm funcionalidades idênticas serão compartilhadas entre diferentes destinos
Tags:loading_and_analysis
,affects_outputs
--[no]stamp
padrão: "false"-
Carimbo de dados binários com a data, o nome de usuário, o nome do host, as informações do espaço de trabalho etc.
Tags:affects_outputs
--strip=<always, sometimes or never>
padrão: "às vezes"-
Especifica se os binários e as bibliotecas compartilhadas serão removidos (usando "-Wl,--strip-debug"). O valor padrão de 'sometimes' significa remover iff --compilation_mode=fastbuild.
Tags:affects_outputs
- Vários usos de
--stripopt=<a string>
são acumulados -
Opções adicionais para transmitir a remoção ao gerar um binário '<name>.stripped'.
Tags:action_command_lines
,affects_outputs
- Vários usos de
--tvos_cpus=<comma-separated list of options>
são acumulados -
Lista separada por vírgulas de arquiteturas para as quais criar binários do Apple tvOS.
Tags:loses_incremental_state
,loading_and_analysis
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
Versão mínima compatível do tvOS para simuladores e dispositivos de destino. Se não for especificado, vai usar "tvos_sdk_version".
Tags:loses_incremental_state
- Vários usos de
--visionos_cpus=<comma-separated list of options>
são acumulados -
Lista separada por vírgulas de arquiteturas para as quais criar binários do Apple VisionOS.
Tags:loses_incremental_state
,loading_and_analysis
- Vários usos de
--watchos_cpus=<comma-separated list of options>
são acumulados -
Lista separada por vírgulas de arquiteturas para as quais criar binários do Apple watchOS.
Tags:loses_incremental_state
,loading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
Versão mínima do watchOS compatível para simuladores e dispositivos de destino. Se não for especificado, será usado "watchos_sdk_version".
Tags:loses_incremental_state
--xbinary_fdo=<a build target label>
padrão: consulte a descrição-
Use informações de perfil XbinaryFDO para otimizar a compilação. Especifica o nome do perfil de binário cruzado padrão. Quando a opção é usada com --fdo_instrument/--fdo_optimize/--fdo_profile, essas opções sempre prevalecem como se xbinary_fdo nunca fosse especificado.
Tags:affects_outputs
- Opções que afetam a forma como o Bazel aplica estritamente as entradas de build válidas (definições de regras, combinações de sinalizações etc.):
--[no]check_licenses
padrão: "false"-
Verifique se as restrições de licenciamento impostas por pacotes dependentes não entram em conflito com os modos de distribuição das metas que estão sendo criadas. Por padrão, as licenças não são verificadas.
Tags:build_file_semantics
--[no]check_visibility
padrão: "true"-
Se desativado, os erros de visibilidade em dependências de destino são rebaixados para avisos.
Tags:build_file_semantics
--[no]desugar_for_android
padrão: "true"-
Define se o bytecode Java 8 será simplificado antes da desindexação.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]desugar_java8_libs
padrão: "false"-
Define se as bibliotecas Java 8 com suporte vão ser incluídas em apps para dispositivos legados.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]enforce_constraints
padrão: "true"-
Verifica os ambientes com que cada destino é compatível e informa erros se algum destino tiver dependências que não oferecem suporte aos mesmos ambientes
Tags:build_file_semantics
--[no]experimental_check_desugar_deps
padrão: "true"-
Define se a dessugarização correta precisa ser verificada novamente no nível binário do Android.
Tags:eagerness_to_exit
,loading_and_analysis
,experimental
--experimental_import_deps_checking=<a string>
padrão: consulte a descrição-
Não tem operação, mantido apenas para compatibilidade com versões anteriores
Tags:loading_and_analysis
--experimental_one_version_enforcement=<off, warning or error>
padrão: "OFF"-
Quando ativada, essa regra garante que uma regra java_binary não possa conter mais de uma versão do mesmo arquivo de classe no classpath. Essa aplicação pode interromper o build ou apenas resultar em avisos.
Tags:loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
padrão: "default"-
Se verdadeiro, verifica se um destino Java declara explicitamente todos os destinos usados diretamente como dependências.
Tags:build_file_semantics
,eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files
padrão: "false"-
Se ativado, verifique se há destinos de pré-requisito que são arquivos de saída procurando o testonly da regra de geração. Isso corresponde à verificação de visibilidade.
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_check_visibility_for_toolchains
padrão: "false"-
Se ativada, a verificação de visibilidade também se aplica às implementações de cadeia de ferramentas.
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_disable_native_android_rules
padrão: "false"-
Se ativado, o uso direto das regras nativas do Android será desativado. Use as regras do Starlark Android em https://github.com/bazelbuild/rules_android
Tags:eagerness_to_exit
,incompatible_change
--[no]incompatible_disable_native_apple_binary_rule
padrão: "false"-
Não há operação. Mantido aqui para compatibilidade com versões anteriores.
Tags:eagerness_to_exit
,incompatible_change
--[no]incompatible_python_disable_py2
padrão: "true"-
Se verdadeiro, o uso das configurações do Python 2 vai causar um erro. Isso inclui python_version=PY2, srcs_version=PY2 e srcs_version=PY2ONLY. Consulte https://github.com/bazelbuild/bazel/issues/15684 para mais informações.
Tags:loading_and_analysis
,incompatible_change
--[no]one_version_enforcement_on_java_tests
padrão: "true"-
Quando ativado e com experimental_one_version_enforcement definido como um valor diferente de NONE, aplique uma versão aos destinos de java_test. Essa flag pode ser desativada para melhorar o desempenho do teste incremental em detrimento de possíveis violações de uma versão.
Tags:loading_and_analysis
--python_native_rules_allowlist=<a build target label>
padrão: consulte a descrição-
Uma lista de permissões (alvo package_group) a ser usada ao aplicar --incompatible_python_disallow_native_rules.
Tags:loading_and_analysis
--[no]strict_filesets
padrão: "false"-
Se essa opção estiver ativada, os conjuntos de arquivos que cruzarem os limites do pacote serão informados como erros.
Tags:build_file_semantics
,eagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default>
padrão: "error"-
A menos que esteja DESLIGADO, verifica se um destino proto_library declara explicitamente todos os destinos usados diretamente como dependências.
Tags:build_file_semantics
,eagerness_to_exit
,incompatible_change
--strict_public_imports=<off, warn, error, strict or default>
padrão: "desativado"-
A menos que esteja DESATIVADO, verifica se um destino proto_library declara explicitamente todos os destinos usados em "import public" como exportados.
Tags:build_file_semantics
,eagerness_to_exit
,incompatible_change
--[no]strict_system_includes
padrão: "false"-
Se verdadeiro, os cabeçalhos encontrados nos caminhos de inclusão do sistema (-isystem) também precisam ser declarados.
Tags:loading_and_analysis
,eagerness_to_exit
- Vários usos de
--target_environment=<a build target label>
são acumulados -
Declara o ambiente de destino desse build. Precisa ser uma referência de rótulo para uma regra de "ambiente". Se especificado, todos os destinos de nível superior precisam ser compatíveis com esse ambiente.
Tags:changes_inputs
- Opções que afetam as saídas de assinatura de um build:
--apk_signing_method=<v1, v2, v1_v2 or v4>
padrão: "v1_v2"-
Implementação a ser usada para assinar APKs
Tags:action_command_lines
,affects_outputs
,loading_and_analysis
--[no]device_debug_entitlements
padrão: "true"-
Se definido e o modo de compilação não for "opt", os apps objc vão incluir direitos de depuração ao assinar.
Tags:changes_inputs
--ios_signing_cert_name=<a string>
padrão: consulte a descrição-
Nome do certificado a ser usado para assinatura do iOS. Se não for definido, o perfil de provisionamento será usado. Pode ser a preferência de identidade do chaveiro do certificado ou (substring) do nome comum do certificado, conforme a página de manual de codesign (IDENTIDADES DE ASSINATURA).
Tags:action_command_lines
- Essa opção afeta a semântica da linguagem Starlark ou a API de build acessível a arquivos BUILD, .bzl ou WORKSPACE.:
--[no]incompatible_disallow_legacy_py_provider
padrão: "true"-
Não é uma operação, será removido em breve.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_sdk_frameworks_attributes
padrão: "false"-
Se verdadeiro, não permita os atributos sdk_frameworks e weak_sdk_frameworks em objc_library e objc_import.
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_objc_alwayslink_by_default
padrão: "false"-
Se verdadeiro, defina o valor padrão como verdadeiro para os atributos alwayslink em objc_library e objc_import.
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_python_disallow_native_rules
padrão: "false"-
Quando verdadeiro, um erro ocorre ao usar as regras py_* integradas. Em vez disso, as regras rule_python precisam ser usadas. Consulte https://github.com/bazelbuild/bazel/issues/17773 para mais informações e instruções de migração.
Tags:loading_and_analysis
,incompatible_change
- Opções que governam o comportamento do ambiente de teste ou do executor de teste:
--[no]allow_analysis_failures
padrão: "false"-
Se verdadeiro, uma falha de análise de um destino de regra resulta na propagação do destino de uma instância de AnalysisFailureInfo contendo a descrição do erro, em vez de resultar em uma falha de build.
Tags:loading_and_analysis
,experimental
--analysis_testing_deps_limit=<an integer>
padrão: "2000"-
Define o número máximo de dependências transitivas usando um atributo de regra com uma transição de configuração for_analysis_testing. Exceder esse limite vai resultar em um erro de regra.
Tags:loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure
padrão: "false"-
Se verdadeiro, as falhas de ação dex2oat vão causar a interrupção do build em vez de executar dex2oat durante o tempo de execução do teste.
Tags:loading_and_analysis
,experimental
- Vários usos de
--default_test_resources=<a resource name followed by equal and 1 float or 4 float, e.g memory=10,30,60,100>
são acumulados - Substitua a quantidade de recursos padrão para testes. O formato esperado é <resource>=<value>. Se um único número positivo for especificado como <value>, ele vai substituir os recursos padrão para todos os tamanhos de teste. Se quatro números separados por vírgula forem especificados, eles vão substituir a quantidade de recursos para os tamanhos de teste pequeno, médio, grande e enorme, respectivamente. Os valores também podem ser HOST_RAM/HOST_CPU, seguidos opcionalmente por [-|*]<float> (por exemplo, memory=HOST_RAM*.1,HOST_RAM*.2,HOST_RAM*.3,HOST_RAM*.4). Os recursos de teste padrão especificados por essa flag são substituídos por recursos explícitos especificados em tags.
--[no]experimental_android_use_parallel_dex2oat
padrão: "false"-
Use dex2oat em paralelo para acelerar o android_test.
Tags:loading_and_analysis
,host_machine_resource_optimizations
,experimental
--[no]ios_memleaks
padrão: "false"-
Ativa a verificação de vazamentos de memória em destinos ios_test.
Tags:action_command_lines
--ios_simulator_device=<a string>
padrão: consulte a descrição-
O dispositivo a ser simulado ao executar um aplicativo iOS no simulador, por exemplo, "iPhone 6". Para conferir uma lista de dispositivos, execute "xcrun simctl list devicetypes" na máquina em que o simulador será executado.
Tags:test_runner
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
A versão do iOS a ser executada no simulador durante a execução ou o teste. Isso será ignorado para regras ios_test se um dispositivo de destino for especificado na regra.
Tags:test_runner
- Vários usos de
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
são acumulados - Especifica o número de vezes que cada teste será executado. Se uma dessas tentativas falhar por qualquer motivo, o teste inteiro será considerado reprovado. Normalmente, o valor especificado é apenas um número inteiro. Exemplo: --runs_per_test=3 vai executar todos os testes três vezes. Sintaxe alternativa: regex_filter@runs_per_test. Em que runs_per_test representa um valor inteiro e regex_filter representa uma lista de padrões de expressão regular de inclusão e exclusão. Consulte também --instrumentation_filter. Exemplo: --runs_per_test=//foo/.*,-//foo/bar/.*@3 executa todos os testes em //foo/, exceto aqueles em foo/bar três vezes. Essa opção pode ser transmitida várias vezes. O argumento mais recente transmitido que corresponde tem precedência. Se nada corresponder, o teste será executado apenas uma vez.
- Vários usos de
--test_env=<a 'name=value' assignment with an optional value part>
são acumulados -
Especifica variáveis de ambiente adicionais a serem injetadas no ambiente do executor de testes. As variáveis podem ser especificadas por nome, e nesse caso o valor delas será lido no ambiente do cliente do Bazel, ou pelo par nome=valor. Essa opção pode ser usada várias vezes para especificar várias variáveis. Usado apenas pelo comando "bazel test".
Tags:test_runner
--test_timeout=<a single integer or comma-separated list of 4 integers>
padrão: "-1"- Substitua os valores padrão de tempo limite de teste (em segundos). Se um único valor inteiro positivo for especificado, ele vai substituir todas as categorias. Se quatro números inteiros separados por vírgulas forem especificados, eles vão substituir os tempos limite para curto, moderado, longo e eterno (nessa ordem). Em qualquer forma, um valor de -1 instrui o Blaze a usar os tempos limite padrão para essa categoria.
--[no]zip_undeclared_test_outputs
padrão: "false"-
Se verdadeiro, as saídas de teste não declaradas serão arquivadas em um arquivo ZIP.
Tags:test_runner
- Opções que acionam otimizações do tempo de build:
--[no]experimental_filter_library_jar_with_program_jar
padrão: "false"-
Filtre o ProgramJar do ProGuard para remover todas as classes também presentes no LibraryJar.
Tags:action_command_lines
,experimental
--[no]experimental_inmemory_dotd_files
padrão: "true"-
Se ativada, os arquivos .d do C++ serão transmitidos na memória diretamente dos nós de build remotos em vez de serem gravados no disco.
Tags:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_inmemory_jdeps_files
padrão: "true"-
Se ativado, os arquivos de dependência (.jdeps) gerados a partir de compilações Java serão transmitidos na memória diretamente dos nós de build remotos em vez de serem gravados no disco.
Tags:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_retain_test_configuration_across_testonly
padrão: "false"-
Quando ativado, o --trim_test_configuration não vai cortar a configuração de teste para regras marcadas como testonly=1. Isso reduz os problemas de conflito de ação quando regras que não são de teste dependem de regras cc_test. Não tem efeito se --trim_test_configuration for falso.
Tags:loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_starlark_cc_import
padrão: "false"-
Se ativada, a versão do Starlark de cc_import poderá ser usada.
Tags:loading_and_analysis
,experimental
--[no]experimental_unsupported_and_brittle_include_scanning
padrão: "false"-
Define se as entradas serão restritas à compilação em C/C++ com a análise de linhas #include dos arquivos de entrada. Isso pode melhorar a performance e a incrementalidade, diminuindo o tamanho das árvores de entrada de compilação. No entanto, ele também pode interromper builds porque o scanner de inclusão não implementa totalmente a semântica do pré-processador C. Especificamente, ele não entende diretivas #include dinâmicas e ignora a lógica condicional do pré-processador. Use por sua conta e risco. Todos os problemas relacionados a essa sinalização serão encerrados.
Tags:loading_and_analysis
,execution
,changes_inputs
,experimental
--[no]incremental_dexing
padrão: "true"-
Realiza a maior parte do trabalho de desindexação separadamente para cada arquivo JAR.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]objc_use_dotd_pruning
padrão: "true"-
Se definido, os arquivos .d emitidos pelo clang serão usados para podar o conjunto de entradas transmitidas para as compilações objc.
Tags:changes_inputs
,loading_and_analysis
--[no]process_headers_in_dependencies
padrão: "false"-
Ao criar um destino //a:a, processe os cabeçalhos em todos os destinos de que //a:a depende (se o processamento de cabeçalhos estiver ativado para o conjunto de ferramentas).
Tags:execution
--[no]trim_test_configuration
padrão: "true"-
Quando ativada, as opções relacionadas ao teste são limpas abaixo do nível superior do build. Quando essa flag está ativa, os testes não podem ser criados como dependências de regras que não são de teste, mas as mudanças nas opções relacionadas ao teste não fazem com que as regras que não são de teste sejam analisadas novamente.
Tags
:loading_and_analysis
,loses_incremental_state
- Opções que afetam o nível de detalhamento, o formato ou o local de geração de registros:
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
padrão: "-.*"-
Mostra informações de depuração durante a resolução da cadeia de ferramentas. A flag usa uma regex, que é verificada em relação aos tipos de conjunto de ferramentas e destinos específicos para saber quais depurar. Vários regexes podem ser separados por vírgulas, e cada regex é verificado separadamente. Observação: a saída dessa flag é muito complexa e provavelmente só será útil para especialistas em resolução de cadeias de ferramentas.
Tags:terminal_output
- Opções que especificam ou alteram uma entrada genérica para um comando do Bazel que não se enquadra em outras categorias.:
- Vários usos de
--flag_alias=<a 'name=value' flag alias>
são acumulados -
Define um nome abreviado para uma flag do Starlark. Ele usa um único par de chave-valor no formato "<chave>=<valor>" como argumento.
Tags:changes_inputs
--[no]incompatible_default_to_explicit_init_py
padrão: "false"-
Essa flag muda o comportamento padrão para que os arquivos __init__.py não sejam mais criados automaticamente nos runfiles de destinos do Python. Mais precisamente, quando um destino py_binary ou py_test tem legacy_create_init definido como "auto" (padrão), ele é tratado como falso se e somente se essa flag estiver definida. Consulte https://github.com/bazelbuild/bazel/issues/10076.
Tags:affects_outputs
,incompatible_change
--[no]incompatible_py2_outputs_are_suffixed
padrão: "true"-
Se verdadeiro, os destinos criados na configuração do Python 2 vão aparecer em uma raiz de saída que inclui o sufixo "-py2", enquanto os destinos criados para o Python 3 vão aparecer em uma raiz sem sufixo relacionado ao Python. Isso significa que o link simbólico de conveniência "bazel-bin" vai apontar para destinos do Python 3 em vez do Python 2. Se você ativar essa opção, também será recomendável ativar `--incompatible_py3_is_default`.
Tags:affects_outputs
,incompatible_change
--[no]incompatible_py3_is_default
padrão: "true"-
Se verdadeiro, os destinos "py_binary" e "py_test" que não definem o atributo "python_version" (ou "default_python_version") vão assumir o valor padrão PY3 em vez de PY2. Se você definir essa flag, também será recomendável definir `--incompatible_py2_outputs_are_suffixed`.
Tags
:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_use_python_toolchains
padrão: "true"-
Se definido como "true", as regras executáveis nativas do Python vão usar o ambiente de execução especificado pelo conjunto de ferramentas do Python, em vez do ambiente de execução fornecido por flags legadas, como --python_top.
Tags:loading_and_analysis
,incompatible_change
--python_version=<PY2 or PY3>
padrão: consulte a descrição-
O modo de versão principal do Python, "PY2" ou "PY3". Essa flag é substituída por "py_binary" e "py_test" (mesmo que não especifiquem explicitamente uma versão). Portanto, geralmente não há motivos para fornecer essa flag.
Tags:loading_and_analysis
,affects_outputs
- Opções diversas, não categorizadas.:
--[no]cache_test_results
[-t
] padrão: "auto"- Se definido como "auto", o Bazel vai executar novamente um teste somente se: (1) o Bazel detectar mudanças no teste ou nas dependências dele, (2) o teste estiver marcado como externo, (3) várias execuções de teste tiverem sido solicitadas com --runs_per_test ou(4) o teste tiver falhado anteriormente. Se definido como "sim", o Bazel armazena em cache todos os resultados de teste, exceto os marcados como externos. Se definido como "no", o Bazel não armazena em cache nenhum resultado de teste.
--[no]experimental_cancel_concurrent_tests
padrão: "false"-
Se verdadeiro, o Blaze vai cancelar os testes em execução simultaneamente na primeira execução bem-sucedida. Isso só é útil em combinação com --runs_per_test_detects_flakes.
Tags:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_fetch_all_coverage_outputs
padrão: "false"-
Se verdadeiro, o Bazel busca o diretório de dados de cobertura inteiro para cada teste durante uma execução de cobertura.
Tags:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_generate_llvm_lcov
padrão: "false"-
Se verdadeiro, a cobertura do clang vai gerar um relatório LCOV.
Tags:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_j2objc_header_map
padrão: "true"-
Define se o mapa de cabeçalho J2ObjC será gerado em paralelo à transpilação J2ObjC.
Tags:experimental
--[no]experimental_j2objc_shorter_header_path
padrão: "false"-
Define se o caminho do cabeçalho será gerado com um caminho mais curto (usa "_ios" em vez de "_j2objc").
Tags:affects_outputs
,experimental
--experimental_java_classpath=<off, javabuilder or bazel>
padrão: "javabuilder"- Habilita caminhos de classe reduzidos para compilações Java.
--[no]experimental_limit_android_lint_to_android_constrained_java
padrão: "false"-
Não tem operação, mantido apenas para compatibilidade com versões anteriores
Tags:affects_outputs
,experimental
--[no]experimental_run_android_lint_on_java_rules
padrão: "false"-
Define se as fontes java_* precisam ser validadas.
Tags:affects_outputs
,experimental
--[no]explicit_java_test_deps
padrão: "false"- Especifique explicitamente uma dependência do JUnit ou do Hamcrest em um java_test em vez de acidentalmente extrair das dependências do TestRunner. No momento, só funciona com o Bazel.
--host_java_launcher=<a build target label>
padrão: consulte a descrição- O iniciador Java usado por ferramentas executadas durante um build.
- Vários usos de
--host_javacopt=<a string>
são acumulados - Opções adicionais para transmitir ao javac ao criar ferramentas que são executadas durante um build.
- Vários usos de
--host_jvmopt=<a string>
são acumulados - Opções adicionais para transmitir à VM Java ao criar ferramentas que são executadas durante o build. Essas opções serão adicionadas às opções de inicialização da VM de cada destino java_binary.
--[no]incompatible_check_sharding_support
padrão: "true"-
Se verdadeiro, o Bazel vai falhar em um teste fragmentado se o executor de teste não indicar que ele oferece suporte ao fragmentação tocando no arquivo no caminho em TEST_SHARD_STATUS_FILE. Se for falso, um executor de teste que não oferece suporte ao fragmentação vai fazer com que todos os testes sejam executados em cada fragmento.
Tags:incompatible_change
--[no]incompatible_exclusive_test_sandboxed
padrão: "true"-
Se verdadeiro, os testes exclusivos serão executados com a estratégia de sandbox. Adicione a tag "local" para forçar a execução de um teste exclusivo localmente
Tags:incompatible_change
--[no]incompatible_strict_action_env
padrão: "false"-
Se verdadeiro, o Bazel usa um ambiente com um valor estático para PATH e não herda LD_LIBRARY_PATH. Use --action_env=ENV_VARIABLE se quiser herdar variáveis de ambiente específicas do cliente. No entanto, isso pode impedir o armazenamento em cache entre usuários se um cache compartilhado for usado.
Tags:loading_and_analysis
,incompatible_change
--j2objc_translation_flags=<comma-separated list of options>
vários usos são acumulados- Opções adicionais para transmitir à ferramenta J2ObjC.
--java_debug
-
Faz com que a máquina virtual Java de um teste Java aguarde uma conexão de um depurador compatível com JDWP (como o jdb) antes de iniciar o teste. Implica em -test_output=streamed.
É expandido para:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
--[no]java_deps
padrão: "true"- Gera informações de dependência (por enquanto, o classpath do tempo de compilação) por destino Java.
--[no]java_header_compilation
padrão: "true"- Compile ijars diretamente da fonte.
--java_language_version=<a string>
padrão: ""- A versão da linguagem Java
--java_launcher=<a build target label>
padrão: consulte a descrição- O iniciador Java a ser usado ao criar binários Java. Se essa flag for definida como uma string vazia, o iniciador do JDK será usado. O atributo "launcher" substitui essa flag.
--java_runtime_version=<a string>
padrão: "local_jdk"- A versão do ambiente de execução Java
- Vários usos de
--javacopt=<a string>
são acumulados - Outras opções para transmitir ao javac.
- Vários usos de
--jvmopt=<a string>
são acumulados - Outras opções para transmitir à VM Java. Essas opções serão adicionadas às opções de inicialização da VM de cada destino java_binary.
--legacy_main_dex_list_generator=<a build target label>
padrão: consulte a descrição- Especifica um binário a ser usado para gerar a lista de classes que precisam estar no dex principal ao compilar o multidex legado.
--optimizing_dexer=<a build target label>
padrão: consulte a descrição- Especifica um binário a ser usado para fazer a dexação sem fragmentação.
- Vários usos de
--plugin=<a build target label>
são acumulados - Plug-ins para usar no build. Atualmente funciona com java_plugin.
--proguard_top=<a build target label>
padrão: consulte a descrição- Especifica qual versão do ProGuard usar para a remoção de código ao criar um binário Java.
--proto_compiler=<a build target label>
padrão: "@bazel_tools//tools/proto:protoc"-
O rótulo do protocompilador.
Tags:affects_outputs
,loading_and_analysis
--[no]proto_profile
padrão: "true"-
Define se o profile_path será transmitido para o compilador proto.
Tags:affects_outputs
,loading_and_analysis
--proto_profile_path=<a build target label>
padrão: consulte a descrição-
O perfil a ser transmitido ao compilador proto como profile_path. Se não for definido, mas --proto_profile for verdadeiro (padrão), o caminho será inferido de --fdo_optimize.
Tags:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
padrão: "@bazel_tools//tools/proto:cc_toolchain"-
Rótulo de proto_lang_toolchain() que descreve como compilar protos C++
Tags:affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
padrão: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"-
Rótulo de proto_lang_toolchain() que descreve como compilar protos j2objc
Tags:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
padrão: "@bazel_tools//tools/proto:java_toolchain"-
Rótulo de proto_lang_toolchain() que descreve como compilar protos Java
Tags:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
padrão: "@bazel_tools//tools/proto:javalite_toolchain"-
Rótulo de proto_lang_toolchain() que descreve como compilar protos JavaLite
Tags:affects_outputs
,loading_and_analysis
- Vários usos de
--protocopt=<a string>
são acumulados -
Opções adicionais para transmitir ao compilador protobuf.
Tags:affects_outputs
--[no]runs_per_test_detects_flakes
padrão: "false"- Se verdadeiro, qualquer fragmento em que pelo menos uma execução/tentativa é bem-sucedida e pelo menos uma falha recebe o status FLAKY.
--shell_executable=<a path>
padrão: consulte a descrição-
Caminho absoluto para o executável do shell que o Bazel vai usar. Se ela não estiver definida, mas a variável de ambiente BAZEL_SH estiver definida na primeira invocação do Bazel (que inicia um servidor do Bazel), o Bazel vai usar essa variável. Se nenhum deles estiver definido, o Bazel vai usar um caminho padrão codificado por hard-code dependendo do sistema operacional em que ele é executado (Windows: c:/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, todos os outros: /bin/bash). O uso de um shell que não é compatível com o bash pode levar a falhas de build ou de execução dos binários gerados.
Tags:loading_and_analysis
- Vários usos de
--test_arg=<a string>
são acumulados - Especifica opções e argumentos adicionais que precisam ser transmitidos para o executável de teste. Pode ser usado várias vezes para especificar vários argumentos. Se vários testes forem executados, cada um deles vai receber argumentos idênticos. Usado apenas pelo comando "bazel test".
--test_filter=<a string>
padrão: consulte a descrição- Especifica um filtro para encaminhar ao framework de teste. Usado para limitar a execução dos testes. Isso não afeta quais metas são criadas.
--test_result_expiration=<an integer>
padrão: "-1"- Essa opção foi descontinuada e não tem efeito.
--[no]test_runner_fail_fast
padrão: "false"- Encaminha a opção de falha rápida para o executor de teste. O executor de teste precisa interromper a execução na primeira falha.
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>
padrão: "explicit"- Especifique a estratégia para o fragmentação de teste: "explicit" para usar a fragmentação apenas se o atributo BUILD "shard_count" estiver presente. "desativado" para nunca usar a fragmentação de testes. "forced=k" para aplicar os fragmentos "k" para testes, independentemente do atributo BUILD "shard_count".
--tool_java_language_version=<a string>
padrão: ""- A versão da linguagem Java usada para executar as ferramentas necessárias durante um build
--tool_java_runtime_version=<a string>
padrão: "remotejdk_11"- A versão do ambiente de execução do Java usada para executar ferramentas durante o build
--[no]use_ijars
padrão: "true"- Se ativada, essa opção faz com que a compilação Java use jars de interface. Isso vai resultar em uma compilação incremental mais rápida, mas as mensagens de erro podem ser diferentes.
Opções de canonicalize-flags
Herda todas as opções de build.
- Opções que controlam a saída do comando:
--[no]canonicalize_policy
padrão: "false"-
Exibe a política canônica após a expansão e a filtragem. Para manter a saída limpa, os argumentos de comando canônicos NÃO serão mostrados quando essa opção estiver definida como verdadeira. O comando especificado por --for_command afeta a política filtrada. Se nenhum for especificado, o comando padrão será "build".
Tags:affects_outputs
,terminal_output
--[no]experimental_include_default_values
padrão: "true"-
Indica se as opções do Starlark definidas com os valores padrão são incluídas na saída.
Tags:affects_outputs
,terminal_output
- Essa opção afeta a semântica do idioma Starlark ou a API de build acessível a arquivos BUILD, .bzl ou WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility
padrão: "false"-
Se incompatible_enforce_config_setting_visibility=false, isso é um noop. Caso contrário, se essa flag for falsa, qualquer config_setting sem um atributo de visibilidade explícito será //visibility:public. Se essa flag for verdadeira, a config_setting vai seguir a mesma lógica de visibilidade de todas as outras regras. Consulte https://github.com/bazelbuild/bazel/issues/12933.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
padrão: "true"-
Se verdadeiro, aplique as restrições de visibilidade de config_setting. Se for falso, cada config_setting será visível para cada destino. Consulte https://github.com/bazelbuild/bazel/issues/12932.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_use_plus_in_repo_names
padrão: "true"-
No-op.
Tags:loading_and_analysis
- Opções que especificam ou alteram uma entrada genérica para um comando do Bazel que não se enquadra em outras categorias:
--for_command=<a string>
padrão: "build"-
O comando para o qual as opções precisam ser canonizadas.
Tags:affects_outputs
,terminal_output
--invocation_policy=<a string>
padrão: ""-
Aplica uma política de invocação às opções a serem canonizadas.
Tags:affects_outputs
,terminal_output
- Opções diversas, não categorizadas.:
- Vários usos de
--deleted_packages=<comma-separated list of package names>
são acumulados - Uma lista separada por vírgulas de nomes de pacotes que o sistema de build vai considerar inexistentes, mesmo que estejam visíveis em algum lugar no caminho do pacote. Use essa opção ao excluir um subpacote "x/y" de um pacote "x" existente. Por exemplo, depois de excluir x/y/BUILD no cliente, o sistema de build pode reclamar se encontrar um rótulo '//x:y/z', caso ele ainda seja fornecido por outra entrada de package_path. Especificar --deleted_packages x/y evita esse problema.
--[no]fetch
padrão: "true"- Permite que o comando busque dependências externas. Se definido como "false", o comando vai usar qualquer versão em cache da dependência. Se nenhuma existir, o comando vai resultar em falha.
--package_path=<colon-separated list of options>
padrão: "%workspace%"- Uma lista separada por dois-pontos de onde procurar pacotes. Os elementos que começam com "%workspace%" são relativos ao espaço de trabalho que os contém. Se omitido ou vazio, o padrão é a saída de "bazel info default-package-path".
--[no]show_loading_progress
padrão: "true"- Se ativado, faz com que o Bazel imprima mensagens "Carregando pacote:".
Opções de limpeza
Herda todas as opções de build.
- Opções que controlam a saída do comando:
--[no]async
padrão: "false"-
Se verdadeiro, a limpeza de saída é assíncrona. Quando esse comando for concluído, será possível executar novos comandos no mesmo cliente, mesmo que a exclusão continue em segundo plano.
Tags:host_machine_resource_optimizations
--[no]expunge
padrão: "false"-
Se verdadeiro, o comando "clean" remove toda a árvore de trabalho para essa instância do Bazel, o que inclui todos os arquivos de saída temporários e de build criados pelo Bazel, e interrompe o servidor do Bazel, se ele estiver em execução.
Tags:host_machine_resource_optimizations
--expunge_async
-
Se especificado, o comando clean remove de forma assíncrona toda a árvore de trabalho para essa instância do Bazel, que inclui todos os arquivos temporários e de saída de build criados pelo Bazel, e interrompe o servidor do Bazel, se ele estiver em execução. Quando esse comando for concluído, será seguro executar novos comandos no mesmo cliente, mesmo que a exclusão continue em segundo plano.
Expande para:
--expunge
--async
Tags:host_machine_resource_optimizations
- Essa opção afeta a semântica do idioma Starlark ou a API de build acessível a arquivos BUILD, .bzl ou WORKSPACE.:
--[no]incompatible_use_plus_in_repo_names
padrão: "true"-
No-op.
Tags:loading_and_analysis
Opções de configuração
Opções de cobertura
Herda todas as opções de test.
- Essa opção afeta a semântica da linguagem Starlark ou a API de build acessível a arquivos BUILD, .bzl ou WORKSPACE.:
--[no]incompatible_use_plus_in_repo_names
padrão: "true"-
No-op.
Tags:loading_and_analysis
Opções de cquery
Herda todas as opções de test.
- Essa opção afeta a semântica da linguagem Starlark ou a API de build acessível a arquivos BUILD, .bzl ou WORKSPACE.:
--[no]incompatible_use_plus_in_repo_names
padrão: "true"-
No-op.
Tags:loading_and_analysis
- Opções relacionadas à saída da consulta e à semântica:
--aspect_deps=<off, conservative or precise>
padrão: "conservador"-
Como resolver dependências de aspecto quando o formato de saída é um dos valores {xml,proto,record}. "Desativado" significa que nenhuma dependência de aspecto é resolvida. "Conservador" (padrão) significa que todas as dependências de aspecto declaradas são adicionadas, independentemente de receberem a classe de regras de dependências diretas. "Precisa" significa que apenas os aspectos que estão possivelmente ativos são adicionados, considerando a classe de regras das dependências diretas. O modo preciso exige o carregamento de outros pacotes para avaliar um único destino, o que o torna mais lento do que os outros modos. Além disso, nem mesmo o modo preciso é totalmente preciso: a decisão de calcular um aspecto é tomada na fase de análise, que não é executada durante a "consulta do bazel".
Tags:build_file_semantics
--[no]consistent_labels
padrão: "false"-
Se ativado, cada comando de consulta emite rótulos como se fosse pela função <code>str</code> do Starlark aplicada a uma instância de <code>Label</code>. Isso é útil para ferramentas que precisam corresponder à saída de diferentes comandos de consulta e/ou rótulos emitidos por regras. Se não estiver ativado, os formatadores de saída poderão emitir nomes de repositório aparentes (relativos ao repositório principal) para tornar a saída mais legível.
Tags:terminal_output
--[no]experimental_explicit_aspects
padrão: "false"-
aquery, cquery: se as ações geradas pelo aspecto serão incluídas na saída. query: no-op (os aspectos são sempre seguidos).
Tags:terminal_output
--[no]graph:factored
padrão: "true"-
Se verdadeiro, o gráfico será emitido "fatorado", ou seja, os nós topologicamente equivalentes serão mesclados e os rótulos serão concatenados. Essa opção é válida apenas para --output=graph.
Tags:terminal_output
--graph:node_limit=<an integer>
padrão: "512"-
O comprimento máximo da string de rótulo de um nó de gráfico na saída. Rótulos mais longos serão truncados. O valor -1 significa que não há truncamento. Essa opção é válida apenas para --output=graph.
Tags:terminal_output
--[no]implicit_deps
padrão: "true"-
Se ativada, as dependências implícitas serão incluídas no gráfico de dependências em que a consulta opera. Uma dependência implícita não é especificada explicitamente no arquivo BUILD, mas é adicionada pelo Bazel. Para cquery, essa opção controla a filtragem de toolchains resolvidas.
Tags:build_file_semantics
--[no]include_aspects
padrão: "true"-
aquery, cquery: se as ações geradas pelo aspecto serão incluídas na saída. query: no-op (os aspectos são sempre seguidos).
Tags:terminal_output
--[no]incompatible_package_group_includes_double_slash
padrão: "true"-
Se ativado, ao gerar o atributo "packages" de package_group, o "//" inicial não será omitido.
Tags:terminal_output
,incompatible_change
--[no]infer_universe_scope
padrão: "false"-
Se definido e --universe_scope não for definido, um valor de --universe_scope será inferido como a lista de padrões de destino exclusivos na expressão da consulta. O valor --universe_scope inferido para uma expressão de consulta que usa funções com escopo de universo (por exemplo, "allrdeps") pode não ser o que você quer. Portanto, use essa opção somente se você souber o que está fazendo. Consulte https://bazel.build/reference/query#sky-query para conferir detalhes e exemplos. Se --universe_scope estiver definido, o valor dessa opção será ignorado. Observação: essa opção se aplica apenas a "query" (não a "cquery").
Tags:loading_and_analysis
--[no]line_terminator_null
padrão: "false"-
Define se cada formato é encerrado com \0 em vez de nova linha.
Tags:terminal_output
--[no]nodep_deps
padrão: "true"-
Se ativado, as dependências dos atributos "nodep" serão incluídas no gráfico de dependências em que a consulta opera. Um exemplo comum de um atributo "nodep" é "visibilidade". Execute e analise a saída de "info build-language" para saber mais sobre todos os atributos "nodep" na linguagem de build.
Tags:build_file_semantics
--output=<a string>
padrão: "label"-
O formato em que os resultados da cquery precisam ser impressos. Os valores permitidos para cquery são: label, label_kind, textproto, transitions, proto, streamed_proto, jsonproto. Se você selecionar "transições", também precisará especificar a opção --transitions=(lite|full).
Tags:terminal_output
--output_file=<a string>
padrão: ""-
Quando especificado, os resultados da consulta serão gravados diretamente nesse arquivo, e nada será impresso no stream de saída padrão (stdout) do Bazel. Em comparativos de mercado, isso geralmente é mais rápido do que <code>bazel query > file</code>.
Tags:terminal_output
--[no]proto:default_values
padrão: "true"-
Se verdadeiro, os atributos cujo valor não for especificado explicitamente no arquivo BUILD serão incluídos. Caso contrário, eles serão omitidos. Esta opção é aplicável a --output=proto
Tags:terminal_output
--[no]proto:definition_stack
padrão: "false"-
Preencha o campo proto definition_stack, que registra para cada instância de regra a pilha de chamadas do Starlark no momento em que a classe da regra foi definida.
Tags:terminal_output
--[no]proto:flatten_selects
padrão: "true"-
Se ativado, os atributos configuráveis criados por select() são achatados. Para tipos de lista, a representação simplificada é uma lista que contém cada valor do mapa selecionado exatamente uma vez. Os tipos escalares são achatados para nulos.
Tags:build_file_semantics
--[no]proto:include_attribute_source_aspects
padrão: "false"-
Preencha o campo proto de source_aspect_name de cada atributo com o aspecto de origem de onde o atributo veio (string vazia se não houver).
Tags:terminal_output
--[no]proto:include_configurations
padrão: "true"-
Se ativada, a saída do proto vai incluir informações sobre as configurações. Quando desativado,o formato de saída do proto de consulta se parece com o formato de saída da consulta.
Tags:affects_outputs
--[no]proto:include_starlark_rule_env
padrão: "true"-
Use o ambiente starlark no valor do atributo $internal_attr_hash gerado. Isso garante que a definição da regra do Starlark (e as importações transitivas dela) façam parte desse identificador.
Tags:terminal_output
--[no]proto:include_synthetic_attribute_hash
padrão: "false"-
Define se o atributo $internal_attr_hash será calculado e preenchido.
Tags:terminal_output
--[no]proto:instantiation_stack
padrão: "false"-
Preencha a pilha de chamadas de instanciação de cada regra. Isso requer que a pilha esteja presente
Tags:terminal_output
--[no]proto:locations
padrão: "true"-
Define se as informações de local serão enviadas na saída do proto.
Tags:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
padrão: "all"-
Lista separada por vírgulas de atributos a serem incluídos na saída. O padrão é todos os atributos. Defina como uma string vazia para não gerar nenhum atributo. Essa opção é válida para --output=proto.
Tags:terminal_output
--[no]proto:rule_classes
padrão: "false"-
Preencha o campo rule_class_key de cada regra. Para a primeira regra com uma rule_class_key específica, preencha também o campo rule_class_info proto. O campo rule_class_key identifica exclusivamente uma classe de regras, e o campo rule_class_info é uma definição de API da classe de regras no formato Stardoc.
Tags:terminal_output
--[no]proto:rule_inputs_and_outputs
padrão: "true"-
Define se os campos rule_input e rule_output são preenchidos ou não.
Tags:terminal_output
--query_file=<a string>
padrão: ""-
Se definido, a consulta vai ler a consulta do arquivo nomeado aqui, em vez da linha de comando. É um erro especificar um arquivo aqui e uma consulta de linha de comando.
Tags:changes_inputs
--[no]relative_locations
padrão: "false"-
Se verdadeiro, o local dos arquivos BUILD nas saídas XML e proto será relativo. Por padrão, a saída de localização é um caminho absoluto e não é consistente entre as máquinas. Defina essa opção como "true" para ter um resultado consistente em todas as máquinas.
Tags:terminal_output
--show_config_fragments=<off, direct or transitive>
padrão: "desativado"-
Mostra os fragmentos de configuração exigidos por uma regra e as dependências transitivas dela. Isso pode ser útil para avaliar o quanto um gráfico de destino configurado pode ser reduzido.
Tags:affects_outputs
--starlark:expr=<a string>
padrão: ""-
Uma expressão Starlark para formatar cada destino configurado no modo --output=starlark do cquery. O destino configurado está vinculado a "target". Se nenhum dos parâmetros --starlark:expr ou --starlark:file for especificado, o padrão será "str(target.label)". É um erro especificar --starlark:expr e --starlark:file.
Tags:terminal_output
--starlark:file=<a string>
padrão: ""-
O nome de um arquivo que define uma função Starlark chamada "format", de um argumento, que é aplicado a cada destino configurado para formatá-lo como uma string. É um erro especificar --starlark:expr e --starlark:file. Consulte a ajuda de --output=starlark para mais detalhes.
Tags:terminal_output
--[no]tool_deps
padrão: "true"
Consulta - : se desativado, as dependências de "exec configuration" não serão incluídas no gráfico de dependências em que a consulta opera. Uma aresta de dependência de "exec configuration", como a de qualquer regra "proto_library" para o compilador de protocolo, geralmente aponta para uma ferramenta executada durante o build em vez de uma parte do mesmo programa "target".
Cquery: se desativado, filtra todas as metas configuradas que cruzam uma transição de execução do destino de nível superior que descobriu essa meta configurada. Isso significa que, se o destino de nível superior estiver na configuração de destino, apenas os destinos configurados também na configuração de destino serão retornados. Se o destino de nível superior estiver na configuração de execução, apenas os destinos configurados de execução serão retornados. Essa opção NÃO exclui as cadeias de ferramentas resolvidas.
Tags:build_file_semantics
--transitions=<full, lite or none>
padrão: "none"-
O formato em que a cquery vai mostrar informações de transição.
Tags:affects_outputs
--universe_scope=<comma-separated list of options>
padrão: ""-
Um conjunto de padrões de destino (aditivos e subtrativos) separados por vírgulas. A consulta pode ser realizada no universo definido pela interseção transitiva das metas especificadas. Essa opção é usada para os comandos query e cquery.
Para a cquery, a entrada para essa opção é o alvo em que todas as respostas são criadas. Portanto, essa opção pode afetar as configurações e transições. Se essa opção não for especificada, os destinos de nível superior serão considerados os destinos analisados pela expressão de consulta. Observação: para cquery, não especificar essa opção pode causar a interrupção do build se os destinos analisados pela expressão de consulta não puderem ser criados com opções de nível superior.
Tags
:loading_and_analysis
- Opções que controlam a execução do build:
--[no]experimental_inprocess_symlink_creation
padrão: "true"-
Define se é possível fazer chamadas diretas do sistema de arquivos para criar árvores de links simbólicos em vez de delegar a um processo auxiliar.
Tags:loading_and_analysis
,execution
,experimental
--[no]experimental_persistent_aar_extractor
padrão: "false"-
Ative o extrator de aar persistente usando workers.
Tags:execution
,experimental
--[no]experimental_remotable_source_manifests
padrão: "false"-
Define se as ações de manifesto de origem podem ser remotas
Tags:loading_and_analysis
,execution
,experimental
--[no]experimental_split_coverage_postprocessing
padrão: "false"-
Se verdadeiro, o Bazel vai executar o pós-processamento de cobertura para teste em uma nova geração.
Tags:execution
,experimental
--[no]experimental_strict_fileset_output
padrão: "false"-
Se essa opção estiver ativada, os conjuntos de arquivos vão tratar todos os artefatos de saída como arquivos comuns. Eles não atravessam diretórios nem são sensíveis a links simbólicos.
Tags:execution
,experimental
--[no]incompatible_modify_execution_info_additive
padrão: "false"-
Quando ativada, a transmissão de várias flags --modify_execution_info é aditiva. Quando desativado, apenas a última flag é considerada.
Tags:execution
,affects_outputs
,loading_and_analysis
,incompatible_change
- Vários usos de
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
são acumulados -
Adiciona ou remove chaves das informações de execução de uma ação com base na mnemônica da ação. Aplicável apenas a ações que oferecem suporte a informações de execução. Muitas ações comuns oferecem suporte a informações de execução, por exemplo, Genrule, CppCompile, Javac, StarlarkAction e TestRunner. Ao especificar vários valores, a ordem é importante, porque muitas expressões regulares podem ser aplicadas ao mesmo mnemônico.
Sintaxe: "regex=[+-]chave,regex=[+-]chave,...".
Exemplos:
'.*=+x,.*=-y,.*=+z' adiciona "x" e "z" e remove "y" das informações de execução de todas as ações.
"Genrule=+requires-x" adiciona "requires-x" às informações de execução de todas as ações de Genrule.
'(?!Genrule).*=-requires-x' remove 'requires-x' das informações de execução de todas as ações que não são Genrule.
Tags:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Ative ações persistentes de dex e desugar do Android usando workers.
É expandido para:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Tags:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
-
Ative o processador de recursos Android persistente usando workers.
Expande para:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
--strategy=ProcessDatabinding=worker
--strategy=GenerateDataBindingBaseClasses=worker
Tags:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_dex_desugar
-
Ative ações persistentes de dex e desugar Android multiplexadas usando workers.
Expande para:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
Tags:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
Ative o processador de recursos Android multiplexado permanente usando workers.
Expande para:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
Tags:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_tools
-
Ative ferramentas Android persistentes e multiplexadas (dexing, desugaring, processamento de recursos).
É expandido para:
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Tags:host_machine_resource_optimizations
,execution
--[no]use_target_platform_for_tests
padrão: "false"-
Se verdadeiro, o Bazel vai usar a plataforma de destino para executar testes em vez do grupo de execução de teste.
Tags
:execution
- Opções que configuram a cadeia de ferramentas usada para a execução de ações:
--android_compiler=<a string>
padrão: consulte a descrição-
O compilador de destino do Android.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
padrão: "android"-
Seleciona a combinação de manifesto a ser usada para regras android_binary. Flag para ajudar na transição para a combinação de manifestos do Android da combinação legada.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_platforms=<a build target label>
padrão: ""-
Define as plataformas que os destinos android_binary usam. Se várias plataformas forem especificadas, o binário será um APK grande, que contém binários nativos para cada plataforma de destino especificada.
Tags:changes_inputs
,loading_and_analysis
,loses_incremental_state
--apple_crosstool_top=<a build target label>
padrão: "@bazel_tools//tools/cpp:toolchain"-
O rótulo do pacote de ferramentas cruzadas a ser usado nas regras da Apple e do Objc e nas dependências deles.
Tags:loses_incremental_state
,changes_inputs
--cc_output_directory_tag=<a string>
padrão: ""-
Especifica um sufixo a ser adicionado ao diretório de configuração.
Tags:affects_outputs
--compiler=<a string>
padrão: consulte a descrição-
O compilador C++ a ser usado para compilar o destino.
Tags:loading_and_analysis
,execution
--coverage_output_generator=<a build target label>
padrão: "@bazel_tools//tools/test:lcov_merger"-
Local do binário usado para pós-processar relatórios de cobertura brutos. No momento, ele precisa ser um grupo de arquivos que contém um único arquivo, o binário. O padrão é "//tools/test:lcov_merger".
Tags:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
padrão: "@bazel_tools//tools/test:coverage_report_generator"-
Local do binário usado para gerar relatórios de cobertura. No momento, ele precisa ser um grupo de arquivos que contém um único arquivo, o binário. O padrão é "//tools/test:coverage_report_generator".
Tags:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
padrão: "@bazel_tools//tools/test:coverage_support"-
Local dos arquivos de suporte necessários nas entradas de cada ação de teste que coleta a cobertura do código. O padrão é "//tools/test:coverage_support".
Tags:changes_inputs
,affects_outputs
,loading_and_analysis
--custom_malloc=<a build target label>
padrão: consulte a descrição-
Especifica uma implementação personalizada de malloc. Essa configuração substitui os atributos malloc nas regras de build.
Tags:changes_inputs
,affects_outputs
- Vários usos de
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
são acumulados -
Lista de expressões regulares separadas por vírgulas, cada uma opcionalmente prefixada por - (expressão negativa), atribuída a (=) a uma lista de destinos de valor de restrição separados por vírgulas. Se um destino corresponder a nenhuma expressão negativa e a pelo menos uma expressão positiva, a resolução da cadeia de ferramentas será realizada como se tivesse declarado os valores de restrição como restrições de execução. Exemplo: //demo,-test=@platforms//cpus:x86_64 vai adicionar "x86_64" a qualquer destino em //demo, exceto aqueles cujo nome contém "test".
Tags:loading_and_analysis
--[no]experimental_include_xcode_execution_requirements
padrão: "false"-
Se definido, adicione um requisito de execução "requires-xcode:{version}" a cada ação do Xcode. Se a versão do Xcode tiver um rótulo com hífen, adicione também um requisito de execução "requires-xcode-label:{version_label}".
Tags:loses_incremental_state
,loading_and_analysis
,execution
,experimental
--[no]experimental_prefer_mutual_xcode
padrão: "true"-
Se verdadeiro, use o Xcode mais recente disponível local e remotamente. Se for falso ou se não houver versões disponíveis em comum, use a versão local do Xcode selecionada pelo xcode-select.
Tags:loses_incremental_state
,experimental
--extra_execution_platforms=<comma-separated list of options>
padrão: ""-
As plataformas de execução disponíveis para executar ações. As plataformas podem ser especificadas por destino exato ou como um padrão de destino. Essas plataformas serão consideradas antes daquelas declaradas no arquivo WORKSPACE por register_execution_platforms(). Essa opção só pode ser definida uma vez. As instâncias posteriores vão substituir as configurações de sinalizações anteriores.
Tags:execution
- Vários usos de
--extra_toolchains=<comma-separated list of options>
são acumulados -
As regras do conjunto de ferramentas que serão consideradas durante a resolução do conjunto de ferramentas. As cadeias de ferramentas podem ser especificadas por destino exato ou como um padrão de destino. Esses conjuntos de ferramentas serão considerados antes dos declarados no arquivo WORKSPACE por register_toolchains().
Tags:affects_outputs
,changes_inputs
,loading_and_analysis
--grte_top=<a label>
padrão: consulte a descrição-
Um rótulo para uma biblioteca libc registrada. O valor padrão é selecionado pela cadeia de ferramentas de crosstool, e você quase nunca precisa substituí-lo.
Tags:action_command_lines
,affects_outputs
--host_compiler=<a string>
padrão: consulte a descrição-
Flag de no-op. Será removido em uma versão futura.
Tags:loading_and_analysis
,execution
--host_grte_top=<a label>
padrão: consulte a descrição-
Se especificado, essa configuração substitui o diretório de nível superior libc (--grte_top) para a configuração de execução.
Tags:action_command_lines
,affects_outputs
--host_platform=<a build target label>
padrão: "@bazel_tools//tools:host_platform"-
O rótulo de uma regra de plataforma que descreve o sistema de host.
Tags:affects_outputs
,changes_inputs
,loading_and_analysis
--[no]incompatible_bazel_test_exec_run_under
padrão: "false"-
Se ativado, "bazel test --run_under=//:runner" cria "//:runner" na configuração de execução. Se desativado, ele cria "//:runner" na configuração de destino. O Bazel executa testes em máquinas de execução, portanto, o primeiro é mais correto. Isso não afeta o "bazel run", que sempre gera "`--run_under=//foo" na configuração de destino.
Tags:affects_outputs
,incompatible_change
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
padrão: "true"-
Se verdadeiro, o Bazel não vai ativar os recursos "host" e "nonhost" na cadeia de ferramentas C++. Consulte https://github.com/bazelbuild/bazel/issues/7407 para mais informações.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_apple_toolchain_resolution
padrão: "false"-
Use a resolução do toolchain para selecionar o SDK da Apple para regras da Apple (Starlark e nativa)
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_legacy_whole_archive
padrão: "true"-
Se verdadeiro, o Bazel não vai vincular as dependências de biblioteca como um arquivo completo por padrão (consulte https://github.com/bazelbuild/bazel/issues/7362 para instruções de migração).
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_strip_executable_safely
padrão: "false"-
Se verdadeiro, a ação de remoção para executáveis vai usar a flag -x, que não interrompe a resolução de símbolos dinâmicos.
Tags:action_command_lines
,incompatible_change
-
Use objetos compartilhados de interface se o conjunto de ferramentas oferecer suporte a eles. Todas as cadeias de ferramentas ELF atualmente oferecem suporte a essa configuração.
Tags:loading_and_analysis
,affects_outputs
,affects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
Especifica a versão do SDK para iOS a ser usada para criar aplicativos iOS. Se não for especificado, vai usar a versão padrão do SDK para iOS de "xcode_version".
Tags:loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
Especifica a versão do SDK do macOS a ser usada para criar aplicativos do macOS. Se não for especificado, vai usar a versão padrão do SDK do macOS de "xcode_version".
Tags:loses_incremental_state
--minimum_os_version=<a string>
padrão: consulte a descrição-
A versão mínima do SO para a qual a compilação é direcionada.
Tags:loading_and_analysis
,affects_outputs
--platform_mappings=<a main workspace-relative path>
padrão: ""-
O local de um arquivo de mapeamento que descreve qual plataforma usar se nenhuma estiver definida ou quais flags definir quando uma plataforma já existir. Precisa ser relativo à raiz do espaço de trabalho principal. O padrão é "platform_mappings" (um arquivo diretamente na raiz do espaço de trabalho).
Tags:affects_outputs
,changes_inputs
,loading_and_analysis
,immutable
--platforms=<a build target label>
padrão: ""-
Os rótulos das regras da plataforma que descrevem as plataformas de destino do comando atual.
Tags:affects_outputs
,changes_inputs
,loading_and_analysis
--python_path=<a string>
padrão: consulte a descrição-
O caminho absoluto do interpretador de Python invocado para executar destinos do Python na plataforma de destino. Obsoleto. Desativado por --incompatible_use_python_toolchains.
Tags:loading_and_analysis
,affects_outputs
--python_top=<a build target label>
padrão: consulte a descrição-
O identificador de um py_runtime que representa o interpretador de Python invocado para executar destinos do Python na plataforma de destino. Obsoleto. Desativado por --incompatible_use_python_toolchains.
Tags:loading_and_analysis
,affects_outputs
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
Especifica a versão do SDK do tvOS a ser usada para criar aplicativos para tvOS. Se não for especificado, vai usar a versão padrão do SDK para tvOS de "xcode_version".
Tags:loses_incremental_state
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
Especifica a versão do SDK do watchOS a ser usada para criar aplicativos do watchOS. Se não for especificado, vai usar a versão padrão do SDK do watchOS de "xcode_version".
Tags:loses_incremental_state
--xcode_version=<a string>
padrão: consulte a descrição-
Se especificado, usa o Xcode da versão especificada para ações de build relevantes. Se não for especificado, vai usar a versão padrão do executor do Xcode.
Tags:loses_incremental_state
--xcode_version_config=<a build target label>
padrão: "@bazel_tools//tools/cpp:host_xcodes"-
O rótulo da regra xcode_config a ser usado para selecionar a versão do Xcode na configuração do build.
Tags
:loses_incremental_state
,loading_and_analysis
- Opções que controlam a saída do comando:
--[no]apple_generate_dsym
padrão: "false"-
Define se é necessário gerar arquivos de símbolo de depuração (.dSYM).
Tags:affects_outputs
,action_command_lines
--[no]build_runfile_links
padrão: "true"-
Se verdadeiro, cria florestas de links simbólicos de arquivos de execução para todos os destinos. Se for falso, grave-os somente quando for necessário por uma ação local, um comando de teste ou de execução.
Tags:affects_outputs
--[no]build_runfile_manifests
padrão: "true"-
Se verdadeiro, grava manifestos de runfiles para todos os destinos. Se for falso, omita-os. Os testes locais não serão executados quando for falso.
Tags:affects_outputs
--[no]build_test_dwp
padrão: "false"-
Se ativado, ao criar testes C++ de forma estática e com fissão, o arquivo .dwp do binário de teste também será criado automaticamente.
Tags:loading_and_analysis
,affects_outputs
--cc_proto_library_header_suffixes=<comma-separated set of options>
padrão: ".pb.h"-
Define os sufixos dos arquivos de cabeçalho que uma cc_proto_library cria.
Tags:affects_outputs
,loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated set of options>
padrão: ".pb.cc"-
Define os sufixos dos arquivos de origem que uma cc_proto_library cria.
Tags:affects_outputs
,loading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info
padrão: "false"-
Execute ações extras para versões alternativas de API Java em uma proto_library.
Tags:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_save_feature_state
padrão: "false"-
Salve o estado dos recursos ativados e solicitados como uma saída da compilação.
Tags:affects_outputs
,experimental
--fission=<a set of compilation modes>
padrão: "no"-
Especifica quais modos de compilação usam a divisão para compilações e links em C++. Pode ser qualquer combinação de {'fastbuild', 'dbg', 'opt'} ou os valores especiais 'yes' para ativar todos os modos e 'no' para desativar todos os modos.
Tags:loading_and_analysis
,action_command_lines
,affects_outputs
--[no]incompatible_always_include_files_in_data
padrão: "true"-
Se verdadeiro, as regras nativas adicionam <code>DefaultInfo.files</code> de dependências de dados aos runfiles, o que corresponde ao comportamento recomendado para regras do Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid).
Tags:affects_outputs
,incompatible_change
--[no]legacy_external_runfiles
padrão: "false"-
Se verdadeiro, crie florestas de links simbólicos de arquivos de execução para repositórios externos em .runfiles/wsname/external/repo (além de .runfiles/repo).
Tags:affects_outputs
--[no]objc_generate_linkmap
padrão: "false"-
Especifica se um arquivo de linkmap será gerado.
Tags:affects_outputs
--[no]save_temps
padrão: "false"-
Se definido, as saídas temporárias do gcc serão salvas. Isso inclui arquivos .s (código do assembler), .i (C pré-processado) e .ii (C++ pré-processado).
Tags
:affects_outputs
- Opções que permitem ao usuário configurar a saída pretendida, afetando o valor, em vez de sua existência:
- Vários usos de
--action_env=<a 'name=value' assignment with an optional value part>
são acumulados -
Especifica o conjunto de variáveis de ambiente disponível para ações com configuração de destino. As variáveis podem ser especificadas por nome, caso em que o valor será retirado do ambiente de invocação, ou pelo par name=value, que define o valor independente do ambiente de invocação. Essa opção pode ser usada várias vezes. Para opções fornecidas para a mesma variável, as mais recentes vencem, e as opções para variáveis diferentes são acumuladas.
Tags:action_command_lines
--allowed_cpu_values=<comma-separated set of options>
padrão: ""-
Valores permitidos para a flag --cpu.
Tags:changes_inputs
,affects_outputs
--[no]android_databinding_use_androidx
padrão: "true"-
Gera arquivos de vinculação de dados compatíveis com o AndroidX. É usado apenas com a vinculação de dados v2. Essa flag não tem efeito.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]android_databinding_use_v3_4_args
padrão: "true"-
Use o Databinding v2 do Android com o argumento 3.4.0. Essa flag não tem efeito.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--android_dynamic_mode=<off, default or fully>
padrão: "desativado"-
Determina se as dependências C++ das regras do Android serão vinculadas dinamicamente quando um cc_binary não criar explicitamente uma biblioteca compartilhada. "default" significa que o Bazel vai escolher se vai vincular dinamicamente. "totalmente" significa que todas as bibliotecas serão vinculadas dinamicamente. "off" significa que todas as bibliotecas serão vinculadas no modo quase estático.
Tags:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
padrão: "alphabetical"-
Define a ordem dos manifestos transmitidos para a combinação de manifestos para binários do Android. ALPHABETICAL significa que os manifestos são classificados por caminho em relação ao execroot. ALPHABETICAL_BY_CONFIGURATION significa que os manifestos são classificados por caminhos relativos ao diretório de configuração no diretório de saída. DEPENDENCY significa que os manifestos são ordenados com o manifesto de cada biblioteca antes dos manifestos das dependências.
Tags:action_command_lines
,execution
--[no]android_resource_shrinking
padrão: "false"-
Ativa a redução de recursos para APKs android_binary que usam o ProGuard.
Tags:affects_outputs
,loading_and_analysis
--[no]build_python_zip
padrão: "auto"-
Criar um zip executável do Python; ativado no Windows, desativado em outras plataformas
Tags:affects_outputs
- Vários usos de
--catalyst_cpus=<comma-separated list of options>
são acumulados -
Lista separada por vírgulas de arquiteturas para as quais criar binários do Apple Catalyst.
Tags:loses_incremental_state
,loading_and_analysis
--[no]collect_code_coverage
padrão: "false"-
Se especificado, o Bazel vai instrumentar o código (usando a instrumentação off-line sempre que possível) e coletar informações de cobertura durante os testes. Somente os destinos que correspondem a --instrumentation_filter serão afetados. Normalmente, essa opção não precisa ser especificada diretamente. Em vez disso, use o comando "bazel coverage".
Tags:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] padrão: "fastbuild"-
Especifica o modo em que o binário será criado. Valores: "fastbuild", "dbg", "opt".
Tags:affects_outputs
,action_command_lines
- Vários usos de
--conlyopt=<a string>
são acumulados -
Opção adicional para transmitir ao gcc ao compilar arquivos de origem C.
Tags:action_command_lines
,affects_outputs
- Vários usos de
--copt=<a string>
são acumulados -
Opções adicionais para transmitir ao gcc.
Tags:action_command_lines
,affects_outputs
--cpu=<a string>
padrão: ""-
A CPU de destino.
Tags:changes_inputs
,affects_outputs
--cs_fdo_absolute_path=<a string>
padrão: consulte a descrição-
Use as informações do perfil do CSFDO para otimizar a compilação. Especifique o nome do caminho absoluto do arquivo ZIP que contém o arquivo de perfil, um arquivo de perfil LLVM bruto ou indexado.
Tags:affects_outputs
--cs_fdo_instrument=<a string>
padrão: consulte a descrição-
Gera binários com instrumentação FDO sensível ao contexto. Com o compilador Clang/LLVM, ele também aceita o nome do diretório em que os arquivos de perfil brutos serão armazenados em disco no momento da execução.
Tags:affects_outputs
--cs_fdo_profile=<a build target label>
padrão: consulte a descrição-
O cs_fdo_profile representa o perfil sensível ao contexto a ser usado para otimização.
Tags:affects_outputs
- Vários usos de
--cxxopt=<a string>
são acumulados -
Opção extra para transmitir ao gcc ao compilar arquivos-fonte C++.
Tags:action_command_lines
,affects_outputs
- Vários usos de
--define=<a 'name=value' assignment>
são acumulados -
Cada opção --define especifica uma atribuição para uma variável de build. No caso de vários valores para uma variável, o último é o vencedor.
Tags:changes_inputs
,affects_outputs
--dynamic_mode=<off, default or fully>
padrão: "default"-
Determina se os binários C++ serão vinculados de forma dinâmica. "default" significa que o Bazel vai escolher se vai vincular dinamicamente. "totalmente" significa que todas as bibliotecas serão vinculadas dinamicamente. "off" significa que todas as bibliotecas serão vinculadas no modo quase estático.
Tags:loading_and_analysis
,affects_outputs
--[no]enable_propeller_optimize_absolute_paths
padrão: "true"-
Se definido, qualquer uso de caminhos absolutos para o propeller optimize vai gerar um erro.
Tags:affects_outputs
--[no]enable_remaining_fdo_absolute_paths
padrão: "true"-
Se definido, qualquer uso de caminhos absolutos para FDO vai gerar um erro.
Tags:affects_outputs
--[no]enable_runfiles
padrão: "auto"-
Ative a árvore de links simbólicos de runfiles. Por padrão, ela fica desativada no Windows e ativada em outras plataformas.
Tags:affects_outputs
- Vários usos de
--experimental_action_listener=<a build target label>
são acumulados -
foi descontinuado em favor de aspectos. Use action_listener para anexar uma extra_action às ações de build atuais.
Tags:execution
,experimental
--[no]experimental_android_compress_java_resources
padrão: "false"-
Compactar recursos Java em APKs
Tags:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_android_databinding_v2
padrão: "true"-
Use o Databinding v2 do Android. Essa flag não tem efeito.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_android_resource_shrinking
padrão: "false"-
Ativa a redução de recursos para APKs android_binary que usam o ProGuard.
Tags:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_android_rewrite_dexes_with_rex
padrão: "false"-
use a ferramenta rex para reescrever arquivos dex
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_collect_code_coverage_for_generated_files
padrão: "false"-
Se especificado, o Bazel também vai gerar informações de cobertura de coleta para arquivos gerados.
Tags:affects_outputs
,experimental
--experimental_objc_fastbuild_options=<comma-separated list of options>
padrão: "-O0,-DDEBUG=1"-
Usa essas strings como opções de compilador de build rápido do objc.
Tags:action_command_lines
--[no]experimental_omitfp
padrão: "false"-
Se verdadeiro, use libunwind para desfazer a pilha e compile com -fomit-frame-pointer e -fasynchronous-unwind-tables.
Tags:action_command_lines
,affects_outputs
,experimental
--experimental_output_paths=<off, content or strip>
padrão: "desativado"-
Qual modelo usar para onde as regras da árvore de saídas gravam as saídas, principalmente para builds multiplataforma / multiconfiguração. Esse recurso é altamente experimental. Consulte https://github.com/bazelbuild/bazel/issues/6526 para saber mais. As ações do Starlark podem optar pelo mapeamento de caminho adicionando a chave "supports-path-mapping" ao dicionário "execution_requirements".
Tags:loses_incremental_state
,bazel_internal_configuration
,affects_outputs
,execution
- Vários usos de
--experimental_override_name_platform_in_output_dir=<a 'label=value' assignment>
são acumulados -
Cada entrada precisa estar no formato rótulo=valor, em que "rótulo" se refere a uma plataforma e "valor" é o nome abreviado desejado para usar no caminho de saída. Só é usado quando --experimental_platform_in_output_dir é verdadeiro. Tem a maior prioridade de nomenclatura.
Tags:affects_outputs
,experimental
--[no]experimental_platform_in_output_dir
padrão: "false"-
Se verdadeiro, um nome abreviado para a plataforma de destino é usado no nome do diretório de saída em vez da CPU. O esquema exato é experimental e sujeito a mudanças: primeiro, no caso raro em que a opção --platforms não tem exatamente um valor, um hash da opção platforms é usado. Em seguida, se algum nome abreviado para a plataforma atual tiver sido registrado por --experimental_override_name_platform_in_output_dir, esse nome abreviado será usado. Em seguida, se --experimental_use_platforms_in_output_dir_legacy_heuristic estiver definido, use um nome abreviado com base no rótulo da plataforma atual. Por fim, um hash da opção de plataforma é usado como último recurso.
Tags:affects_outputs
,experimental
--[no]experimental_py_binaries_include_label
padrão: "false"-
Os destinos py_binary incluem o rótulo mesmo quando a marcação está desativada.
Tags:affects_outputs
,experimental
--[no]experimental_use_llvm_covmap
padrão: "false"-
Se especificado, o Bazel vai gerar informações do mapa de cobertura llvm-cov em vez de gcov quando o collect_code_coverage estiver ativado.
Tags:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic
padrão: "true"-
Use essa flag apenas como parte de uma estratégia de migração ou teste sugerida. A heurística tem deficiências conhecidas, e é recomendável migrar para usar apenas --experimental_override_name_platform_in_output_dir.
Tags:affects_outputs
,experimental
--fdo_instrument=<a string>
padrão: consulte a descrição-
Gera binários com instrumentação FDO. Com o compilador Clang/LLVM, ele também aceita o nome do diretório em que os arquivos de perfil brutos serão armazenados em disco no momento da execução.
Tags:affects_outputs
--fdo_optimize=<a string>
padrão: consulte a descrição-
Use informações do perfil de FDO para otimizar a compilação. Especifique o nome de um arquivo ZIP que contém uma árvore de arquivos .gcda, um arquivo afdo com um perfil automático ou um arquivo de perfil LLVM. Essa flag também aceita arquivos especificados como rótulos (por exemplo, "//foo/bar:file.afdo". Talvez seja necessário adicionar uma diretiva "exports_files" ao pacote correspondente) e rótulos que apontam para destinos "fdo_profile". Essa flag será substituída pela regra "fdo_profile".
Tags:affects_outputs
--fdo_prefetch_hints=<a build target label>
padrão: consulte a descrição-
Use dicas de pré-busca de cache.
Tags:affects_outputs
--fdo_profile=<a build target label>
padrão: consulte a descrição-
O fdo_profile que representa o perfil a ser usado para otimização.
Tags:affects_outputs
- Vários usos de
--features=<a string>
são acumulados -
Os recursos serão ativados ou desativados por padrão para destinos criados na configuração de destino. Especificar -<feature> desativa o recurso. Os recursos negativos sempre substituem os positivos. Consulte também as tags --host_features
:changes_inputs
,affects_outputs
--[no]force_pic
padrão: "false"-
Se ativado, todas as compilações C++ vão produzir código independente de posição ("-fPIC"), os links vão preferir bibliotecas pré-criadas PIC em vez de bibliotecas não-PIC, e os links vão produzir executáveis independentes de posição ("-pie").
Tags:loading_and_analysis
,affects_outputs
- Vários usos de
--host_action_env=<a 'name=value' assignment with an optional value part>
são acumulados -
Especifica o conjunto de variáveis de ambiente disponível para ações com configurações de execução. As variáveis podem ser especificadas por nome, e nesse caso o valor é retirado do ambiente de invocação, ou pelo par name=value, que define o valor independente do ambiente de invocação. Essa opção pode ser usada várias vezes. Para opções fornecidas para a mesma variável, as mais recentes vencem, e as opções para variáveis diferentes são acumuladas.
Tags:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
padrão: "opt"-
Especifica o modo em que as ferramentas usadas durante o build serão integradas. Valores: "fastbuild", "dbg", "opt".
Tags:affects_outputs
,action_command_lines
- Vários usos de
--host_conlyopt=<a string>
são acumulados -
Opção adicional para transmitir ao compilador C ao compilar arquivos-fonte C (mas não C++) nas configurações de execução.
Tags:action_command_lines
,affects_outputs
- Vários usos de
--host_copt=<a string>
são acumulados -
Opções adicionais para transmitir ao compilador C para ferramentas criadas nas configurações de execução.
Tags:action_command_lines
,affects_outputs
--host_cpu=<a string>
padrão: ""-
A CPU host.
Tags:changes_inputs
,affects_outputs
- Vários usos de
--host_cxxopt=<a string>
são acumulados -
Opções adicionais para transmitir ao compilador C++ para ferramentas criadas nas configurações de execução.
Tags:action_command_lines
,affects_outputs
- Vários usos de
--host_features=<a string>
são acumulados -
Os recursos especificados serão ativados ou desativados por padrão para os destinos criados na configuração de execução. Especificar -<feature> desativa o recurso. Os recursos negativos sempre substituem os positivos.
Tags:changes_inputs
,affects_outputs
--host_force_python=<PY2 or PY3>
padrão: consulte a descrição-
Substitui a versão do Python para a configuração de execução. Pode ser "PY2" ou "PY3".
Tags:loading_and_analysis
,affects_outputs
- Vários usos de
--host_linkopt=<a string>
são acumulados -
Opção adicional para transmitir ao vinculador ao vincular ferramentas nas configurações de execução.
Tags:action_command_lines
,affects_outputs
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
Versão mínima compatível do macOS para destinos do host. Se não for especificado, vai usar "macos_sdk_version".
Tags:loses_incremental_state
- Vários usos de
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
são acumulados -
Opções adicionais para transmitir seletivamente ao compilador C/C++ ao compilar determinados arquivos nas execuções de configuração. Essa opção pode ser transmitida várias vezes. Sintaxe: regex_filter@option_1,option_2,...,option_n. Em que regex_filter representa uma lista de padrões de expressão regular de inclusão e exclusão (consulte também --instrumentation_filter). option_1 a option_n representam opções arbitrárias de linha de comando. Se uma opção tiver uma vírgula, ela precisa ser colocada entre aspas com uma barra invertida. As opções podem conter @. Apenas o primeiro @ é usado para dividir a string. Exemplo: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 adiciona a opção de linha de comando -O0 à linha de comando do gcc de todos os arquivos cc em //foo/, exceto bar.cc.
Tags:action_command_lines
,affects_outputs
--[no]incompatible_auto_exec_groups
padrão: "false"-
Quando ativado, um grupo de execução é criado automaticamente para cada toolchain usado por uma regra. Para que isso funcione, a regra precisa especificar o parâmetro "toolchain" nas ações. Para mais informações, consulte https://github.com/bazelbuild/bazel/issues/17134.
Tags:affects_outputs
,incompatible_change
--[no]incompatible_merge_genfiles_directory
padrão: "true"-
Se verdadeiro, o diretório genfiles é dobrado no diretório bin.
Tags:affects_outputs
,incompatible_change
--[no]instrument_test_targets
padrão: "false"-
Quando a cobertura está ativada, especifica se é necessário considerar a instrumentação de regras de teste. Quando definido, as regras de teste incluídas por --instrumentation_filter são inspecionadas. Caso contrário, as regras de teste são sempre excluídas da instrumentação de cobertura.
Tags:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
padrão: "-/javatests[/:],-/test/java[/:]"-
Quando a cobertura está ativada, apenas as regras com nomes incluídos pelo filtro baseado em regex especificado são instrumentadas. As regras com o prefixo "-" são excluídas. Somente as regras que não são de teste são instrumentadas, a menos que --instrument_test_targets esteja ativado.
Tags:affects_outputs
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
Versão mínima compatível do iOS para simuladores e dispositivos de destino. Se não for especificado, vai usar "ios_sdk_version".
Tags:loses_incremental_state
- Vários usos de
--ios_multi_cpus=<comma-separated list of options>
são acumulados -
Lista separada por vírgulas de arquiteturas para criar um ios_application. O resultado é um binário universal que contém todas as arquiteturas especificadas.
Tags:loses_incremental_state
,loading_and_analysis
--[no]legacy_whole_archive
padrão: "true"-
Descontinuado, substituído por --incompatible_remove_legacy_whole_archive (consulte https://github.com/bazelbuild/bazel/issues/7362 para saber mais). Quando ativado, use --whole-archive para regras cc_binary que tenham linkshared=True e linkstatic=True ou '-static' em linkopts. Isso é apenas para compatibilidade com versões anteriores. Uma alternativa melhor é usar alwayslink=1 quando necessário.
Tags:action_command_lines
,affects_outputs
,deprecated
- Vários usos de
--linkopt=<a string>
são acumulados -
Opção adicional para transmitir ao gcc ao vincular.
Tags:action_command_lines
,affects_outputs
- Vários usos de
--ltobackendopt=<a string>
são acumulados -
Opção extra para passar para a etapa de back-end de LTO (em --features=thin_lto).
Tags:action_command_lines
,affects_outputs
- Vários usos de
--ltoindexopt=<a string>
são acumulados -
Opção extra para passar para a etapa de indexação de LTO (em --features=thin_lto).
Tags:action_command_lines
,affects_outputs
- Vários usos de
--macos_cpus=<comma-separated list of options>
são acumulados -
Lista separada por vírgulas de arquiteturas para as quais criar binários do Apple macOS.
Tags:loses_incremental_state
,loading_and_analysis
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
Versão mínima do macOS compatível para destinos. Se não for especificado, vai usar "macos_sdk_version".
Tags:loses_incremental_state
--memprof_profile=<a build target label>
padrão: consulte a descrição-
Use o perfil do memprof.
Tags:affects_outputs
--[no]objc_debug_with_GLIBCXX
padrão: "false"-
Se definido e o modo de compilação estiver definido como "dbg", defina GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC e GLIBCPP_CONCEPT_CHECKS.
Tags:action_command_lines
--[no]objc_enable_binary_stripping
padrão: "false"-
Define se o símbolo e o código morto serão removidos em binários vinculados. A remoção de binários será realizada se essa flag e --compilation_mode=opt forem especificados.
Tags:action_command_lines
- Vários usos de
--objccopt=<a string>
são acumulados -
Opções adicionais para transmitir ao gcc ao compilar arquivos de origem Objective-C/C++.
Tags:action_command_lines
- Vários usos de
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
são acumulados -
Opções adicionais para transmitir seletivamente ao gcc ao compilar determinados arquivos. Essa opção pode ser transmitida várias vezes. Sintaxe: regex_filter@option_1,option_2,...,option_n. Em que regex_filter representa uma lista de padrões de expressão regular de inclusão e exclusão (consulte também --instrumentation_filter). option_1 a option_n representam opções arbitrárias de linha de comando. Se uma opção tiver uma vírgula, ela precisa ser colocada entre aspas com uma barra invertida. As opções podem conter @. Apenas o primeiro @ é usado para dividir a string. Exemplo: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 adiciona a opção de linha de comando -O0 à linha de comando do gcc de todos os arquivos cc em //foo/, exceto bar.cc.
Tags:action_command_lines
,affects_outputs
- Vários usos de
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
são acumulados -
Opções adicionais para transmitir seletivamente para o back-end LTO (em --features=thin_lto) ao compilar determinados objetos de back-end. Essa opção pode ser transmitida várias vezes. Sintaxe: regex_filter@option_1,option_2,...,option_n. Em que regex_filter representa uma lista de padrões de expressão regular de inclusão e exclusão. option_1 a option_n representam opções arbitrárias de linha de comando. Se uma opção tiver uma vírgula, ela precisa ser colocada entre aspas com uma barra invertida. As opções podem conter @. Apenas o primeiro @ é usado para dividir a string. Exemplo: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 adiciona a opção de linha de comando -O0 à linha de comando do back-end de LTO de todos os arquivos em //foo/, exceto bar.o.
Tags:action_command_lines
,affects_outputs
--platform_suffix=<a string>
padrão: consulte a descrição-
Especifica um sufixo a ser adicionado ao diretório de configuração.
Tags:loses_incremental_state
,affects_outputs
,loading_and_analysis
--propeller_optimize=<a build target label>
padrão: consulte a descrição-
Use as informações do perfil do Propeller para otimizar o destino do build.Um perfil do Propeller precisa consistir em pelo menos um dos dois arquivos, um perfil cc e um perfil ld. Essa flag aceita um rótulo de build que precisa se referir aos arquivos de entrada do perfil do Propeller. Por exemplo, o arquivo BUILD que define o rótulo, em a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)Uma diretiva exports_files pode precisar ser adicionada ao pacote correspondente para que esses arquivos fiquem visíveis para o Bazel. A opção precisa ser usada como: --propeller_optimize=//a/b:propeller_profile
Tags:action_command_lines
,affects_outputs
--propeller_optimize_absolute_cc_profile=<a string>
padrão: consulte a descrição-
Nome do caminho absoluto do arquivo cc_profile para builds otimizados do Propeller.
Tags:affects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
padrão: consulte a descrição-
Nome de caminho absoluto do arquivo ld_profile para builds otimizados do Propeller.
Tags:affects_outputs
--run_under=<a prefix in front of command>
padrão: consulte a descrição-
Prefixo a ser inserido antes dos executáveis para os comandos "test" e "run". Se o valor for "foo -bar" e a linha de comando de execução for "test_binary -baz", a linha de comando final será "foo -bar test_binary -baz".Isso também pode ser um rótulo para um destino executável. Alguns exemplos são: "valgrind", "strace", "strace -c", "valgrind --quiet --num-callers=20", "//package:target", "//package:target --options".
Tags:action_command_lines
-
Se verdadeiro, as bibliotecas nativas que contêm funcionalidades idênticas serão compartilhadas entre diferentes destinos
Tags:loading_and_analysis
,affects_outputs
--[no]stamp
padrão: "false"-
Carimbo de dados binários com a data, o nome de usuário, o nome do host, as informações do espaço de trabalho etc.
Tags:affects_outputs
--strip=<always, sometimes or never>
padrão: "às vezes"-
Especifica se os binários e as bibliotecas compartilhadas serão removidos (usando "-Wl,--strip-debug"). O valor padrão de 'sometimes' significa remover iff --compilation_mode=fastbuild.
Tags:affects_outputs
- Vários usos de
--stripopt=<a string>
são acumulados -
Opções adicionais para transmitir a remoção ao gerar um binário '<name>.stripped'.
Tags:action_command_lines
,affects_outputs
- Vários usos de
--tvos_cpus=<comma-separated list of options>
são acumulados -
Lista separada por vírgulas de arquiteturas para as quais criar binários do Apple tvOS.
Tags:loses_incremental_state
,loading_and_analysis
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
Versão mínima compatível do tvOS para simuladores e dispositivos de destino. Se não for especificado, vai usar "tvos_sdk_version".
Tags:loses_incremental_state
- Vários usos de
--visionos_cpus=<comma-separated list of options>
são acumulados -
Lista separada por vírgulas de arquiteturas para as quais criar binários do Apple VisionOS.
Tags:loses_incremental_state
,loading_and_analysis
- Vários usos de
--watchos_cpus=<comma-separated list of options>
são acumulados -
Lista separada por vírgulas de arquiteturas para as quais criar binários do Apple watchOS.
Tags:loses_incremental_state
,loading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
Versão mínima do watchOS compatível para simuladores e dispositivos de destino. Se não for especificado, será usado "watchos_sdk_version".
Tags:loses_incremental_state
--xbinary_fdo=<a build target label>
padrão: consulte a descrição-
Use informações de perfil XbinaryFDO para otimizar a compilação. Especifica o nome do perfil de binário cruzado padrão. Quando a opção é usada com --fdo_instrument/--fdo_optimize/--fdo_profile, essas opções sempre prevalecem como se xbinary_fdo nunca fosse especificado.
Tags:affects_outputs
- Opções que afetam a forma como o Bazel aplica estritamente as entradas de build válidas (definições de regras, combinações de sinalizações etc.):
--[no]check_licenses
padrão: "false"-
Verifique se as restrições de licenciamento impostas por pacotes dependentes não entram em conflito com os modos de distribuição das metas que estão sendo criadas. Por padrão, as licenças não são verificadas.
Tags:build_file_semantics
--[no]check_visibility
padrão: "true"-
Se desativado, os erros de visibilidade em dependências de destino são rebaixados para avisos.
Tags:build_file_semantics
--[no]desugar_for_android
padrão: "true"-
Define se o bytecode Java 8 será simplificado antes da desindexação.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]desugar_java8_libs
padrão: "false"-
Define se as bibliotecas Java 8 com suporte vão ser incluídas em apps para dispositivos legados.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]enforce_constraints
padrão: "true"-
Verifica os ambientes com que cada destino é compatível e informa erros se algum destino tiver dependências que não oferecem suporte aos mesmos ambientes
Tags:build_file_semantics
--[no]experimental_check_desugar_deps
padrão: "true"-
Define se a dessugarização correta precisa ser verificada novamente no nível binário do Android.
Tags:eagerness_to_exit
,loading_and_analysis
,experimental
--experimental_import_deps_checking=<a string>
padrão: consulte a descrição-
Não tem operação, mantido apenas para compatibilidade com versões anteriores
Tags:loading_and_analysis
--experimental_one_version_enforcement=<off, warning or error>
padrão: "OFF"-
Quando ativada, essa regra garante que uma regra java_binary não possa conter mais de uma versão do mesmo arquivo de classe no classpath. Essa aplicação pode interromper o build ou apenas resultar em avisos.
Tags:loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
padrão: "default"-
Se verdadeiro, verifica se um destino Java declara explicitamente todos os destinos usados diretamente como dependências.
Tags:build_file_semantics
,eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files
padrão: "false"-
Se ativado, verifique se há destinos de pré-requisito que são arquivos de saída procurando o testonly da regra de geração. Isso corresponde à verificação de visibilidade.
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_check_visibility_for_toolchains
padrão: "false"-
Se ativada, a verificação de visibilidade também se aplica às implementações de cadeia de ferramentas.
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_disable_native_android_rules
padrão: "false"-
Se ativado, o uso direto das regras nativas do Android será desativado. Use as regras do Starlark Android em https://github.com/bazelbuild/rules_android
Tags:eagerness_to_exit
,incompatible_change
--[no]incompatible_disable_native_apple_binary_rule
padrão: "false"-
Não há operação. Mantido aqui para compatibilidade com versões anteriores.
Tags:eagerness_to_exit
,incompatible_change
--[no]incompatible_python_disable_py2
padrão: "true"-
Se verdadeiro, o uso das configurações do Python 2 vai causar um erro. Isso inclui python_version=PY2, srcs_version=PY2 e srcs_version=PY2ONLY. Consulte https://github.com/bazelbuild/bazel/issues/15684 para mais informações.
Tags:loading_and_analysis
,incompatible_change
--[no]one_version_enforcement_on_java_tests
padrão: "true"-
Quando ativado e com experimental_one_version_enforcement definido como um valor diferente de NONE, aplique uma versão aos destinos de java_test. Essa flag pode ser desativada para melhorar o desempenho do teste incremental em detrimento de possíveis violações de uma versão.
Tags:loading_and_analysis
--python_native_rules_allowlist=<a build target label>
padrão: consulte a descrição-
Uma lista de permissões (alvo package_group) a ser usada ao aplicar --incompatible_python_disallow_native_rules.
Tags:loading_and_analysis
--[no]strict_filesets
padrão: "false"-
Se essa opção estiver ativada, os conjuntos de arquivos que cruzarem os limites do pacote serão informados como erros.
Tags:build_file_semantics
,eagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default>
padrão: "error"-
A menos que esteja DESLIGADO, verifica se um destino proto_library declara explicitamente todos os destinos usados diretamente como dependências.
Tags:build_file_semantics
,eagerness_to_exit
,incompatible_change
--strict_public_imports=<off, warn, error, strict or default>
padrão: "desativado"-
A menos que esteja DESATIVADO, verifica se um destino proto_library declara explicitamente todos os destinos usados em "import public" como exportados.
Tags:build_file_semantics
,eagerness_to_exit
,incompatible_change
--[no]strict_system_includes
padrão: "false"-
Se verdadeiro, os cabeçalhos encontrados nos caminhos de inclusão do sistema (-isystem) também precisam ser declarados.
Tags:loading_and_analysis
,eagerness_to_exit
- Vários usos de
--target_environment=<a build target label>
são acumulados -
Declara o ambiente de destino desse build. Precisa ser uma referência de rótulo para uma regra de "ambiente". Se especificado, todos os destinos de nível superior precisam ser compatíveis com esse ambiente.
Tags:changes_inputs
- Opções que afetam as saídas de assinatura de um build:
--apk_signing_method=<v1, v2, v1_v2 or v4>
padrão: "v1_v2"-
Implementação a ser usada para assinar APKs
Tags:action_command_lines
,affects_outputs
,loading_and_analysis
--[no]device_debug_entitlements
padrão: "true"-
Se definido e o modo de compilação não for "opt", os apps objc vão incluir direitos de depuração ao assinar.
Tags:changes_inputs
--ios_signing_cert_name=<a string>
padrão: consulte a descrição-
Nome do certificado a ser usado para assinatura do iOS. Se não for definido, o perfil de provisionamento será usado. Pode ser a preferência de identidade do chaveiro do certificado ou (substring) do nome comum do certificado, conforme a página de manual de codesign (IDENTIDADES DE ASSINATURA).
Tags:action_command_lines
- Essa opção afeta a semântica da linguagem Starlark ou a API de build acessível a arquivos BUILD, .bzl ou WORKSPACE.:
--[no]incompatible_disallow_legacy_py_provider
padrão: "true"-
Não é uma operação, será removido em breve.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_sdk_frameworks_attributes
padrão: "false"-
Se verdadeiro, não permita os atributos sdk_frameworks e weak_sdk_frameworks em objc_library e objc_import.
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_objc_alwayslink_by_default
padrão: "false"-
Se verdadeiro, defina o valor padrão como verdadeiro para os atributos alwayslink em objc_library e objc_import.
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_python_disallow_native_rules
padrão: "false"-
Quando verdadeiro, um erro ocorre ao usar as regras py_* integradas. Em vez disso, as regras rule_python precisam ser usadas. Consulte https://github.com/bazelbuild/bazel/issues/17773 para mais informações e instruções de migração.
Tags:loading_and_analysis
,incompatible_change
- Opções que governam o comportamento do ambiente de teste ou do executor de teste:
--[no]allow_analysis_failures
padrão: "false"-
Se verdadeiro, uma falha de análise de um destino de regra resulta na propagação do destino de uma instância de AnalysisFailureInfo contendo a descrição do erro, em vez de resultar em uma falha de build.
Tags:loading_and_analysis
,experimental
--analysis_testing_deps_limit=<an integer>
padrão: "2000"-
Define o número máximo de dependências transitivas usando um atributo de regra com uma transição de configuração for_analysis_testing. Exceder esse limite vai resultar em um erro de regra.
Tags:loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure
padrão: "false"-
Se verdadeiro, as falhas de ação dex2oat vão causar a interrupção do build em vez de executar dex2oat durante o tempo de execução do teste.
Tags:loading_and_analysis
,experimental
- Vários usos de
--default_test_resources=<a resource name followed by equal and 1 float or 4 float, e.g memory=10,30,60,100>
são acumulados - Substitua a quantidade de recursos padrão para testes. O formato esperado é <resource>=<value>. Se um único número positivo for especificado como <value>, ele vai substituir os recursos padrão para todos os tamanhos de teste. Se quatro números separados por vírgula forem especificados, eles vão substituir a quantidade de recursos para os tamanhos de teste pequeno, médio, grande e enorme, respectivamente. Os valores também podem ser HOST_RAM/HOST_CPU, seguidos opcionalmente por [-|*]<float> (por exemplo, memory=HOST_RAM*.1,HOST_RAM*.2,HOST_RAM*.3,HOST_RAM*.4). Os recursos de teste padrão especificados por essa flag são substituídos por recursos explícitos especificados em tags.
--[no]experimental_android_use_parallel_dex2oat
padrão: "false"-
Use dex2oat em paralelo para acelerar o android_test.
Tags:loading_and_analysis
,host_machine_resource_optimizations
,experimental
--[no]ios_memleaks
padrão: "false"-
Ativa a verificação de vazamentos de memória em destinos ios_test.
Tags:action_command_lines
--ios_simulator_device=<a string>
padrão: consulte a descrição-
O dispositivo a ser simulado ao executar um aplicativo iOS no simulador, por exemplo, "iPhone 6". Para conferir uma lista de dispositivos, execute "xcrun simctl list devicetypes" na máquina em que o simulador será executado.
Tags:test_runner
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
A versão do iOS a ser executada no simulador durante a execução ou o teste. Isso será ignorado para regras ios_test se um dispositivo de destino for especificado na regra.
Tags:test_runner
- Vários usos de
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
são acumulados - Especifica o número de vezes que cada teste será executado. Se uma dessas tentativas falhar por qualquer motivo, o teste inteiro será considerado reprovado. Normalmente, o valor especificado é apenas um número inteiro. Exemplo: --runs_per_test=3 vai executar todos os testes três vezes. Sintaxe alternativa: regex_filter@runs_per_test. Em que runs_per_test representa um valor inteiro e regex_filter representa uma lista de padrões de expressão regular de inclusão e exclusão. Consulte também --instrumentation_filter. Exemplo: --runs_per_test=//foo/.*,-//foo/bar/.*@3 executa todos os testes em //foo/, exceto aqueles em foo/bar três vezes. Essa opção pode ser transmitida várias vezes. O argumento mais recente transmitido que corresponde tem precedência. Se nada corresponder, o teste será executado apenas uma vez.
- Vários usos de
--test_env=<a 'name=value' assignment with an optional value part>
são acumulados -
Especifica variáveis de ambiente adicionais a serem injetadas no ambiente do executor de testes. As variáveis podem ser especificadas por nome, e nesse caso o valor delas será lido no ambiente do cliente do Bazel, ou pelo par nome=valor. Essa opção pode ser usada várias vezes para especificar várias variáveis. Usado apenas pelo comando "bazel test".
Tags:test_runner
--test_timeout=<a single integer or comma-separated list of 4 integers>
padrão: "-1"- Substitua os valores padrão de tempo limite de teste (em segundos). Se um único valor inteiro positivo for especificado, ele vai substituir todas as categorias. Se quatro números inteiros separados por vírgulas forem especificados, eles vão substituir os tempos limite para curto, moderado, longo e eterno (nessa ordem). Em qualquer forma, um valor de -1 instrui o Blaze a usar os tempos limite padrão para essa categoria.
--[no]zip_undeclared_test_outputs
padrão: "false"-
Se verdadeiro, as saídas de teste não declaradas serão arquivadas em um arquivo ZIP.
Tags:test_runner
- Opções que acionam otimizações do tempo de build:
--[no]experimental_filter_library_jar_with_program_jar
padrão: "false"-
Filtre o ProgramJar do ProGuard para remover todas as classes também presentes no LibraryJar.
Tags:action_command_lines
,experimental
--[no]experimental_inmemory_dotd_files
padrão: "true"-
Se ativada, os arquivos .d do C++ serão transmitidos na memória diretamente dos nós de build remotos em vez de serem gravados no disco.
Tags:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_inmemory_jdeps_files
padrão: "true"-
Se ativado, os arquivos de dependência (.jdeps) gerados a partir de compilações Java serão transmitidos na memória diretamente dos nós de build remotos em vez de serem gravados no disco.
Tags:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_retain_test_configuration_across_testonly
padrão: "false"-
Quando ativado, o --trim_test_configuration não vai cortar a configuração de teste para regras marcadas como testonly=1. Isso reduz os problemas de conflito de ação quando regras que não são de teste dependem de regras cc_test. Não tem efeito se --trim_test_configuration for falso.
Tags:loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_starlark_cc_import
padrão: "false"-
Se ativada, a versão do Starlark de cc_import poderá ser usada.
Tags:loading_and_analysis
,experimental
--[no]experimental_unsupported_and_brittle_include_scanning
padrão: "false"-
Define se as entradas serão restritas à compilação em C/C++ com a análise de linhas #include dos arquivos de entrada. Isso pode melhorar a performance e a incrementalidade, diminuindo o tamanho das árvores de entrada de compilação. No entanto, ele também pode interromper builds porque o scanner de inclusão não implementa totalmente a semântica do pré-processador C. Especificamente, ele não entende diretivas #include dinâmicas e ignora a lógica condicional do pré-processador. Use por sua conta e risco. Todos os problemas relacionados a essa sinalização serão encerrados.
Tags:loading_and_analysis
,execution
,changes_inputs
,experimental
--[no]incremental_dexing
padrão: "true"-
Realiza a maior parte do trabalho de desindexação separadamente para cada arquivo JAR.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]objc_use_dotd_pruning
padrão: "true"-
Se definido, os arquivos .d emitidos pelo clang serão usados para podar o conjunto de entradas transmitidas para as compilações objc.
Tags:changes_inputs
,loading_and_analysis
--[no]process_headers_in_dependencies
padrão: "false"-
Ao criar um destino //a:a, processe os cabeçalhos em todos os destinos de que //a:a depende (se o processamento de cabeçalhos estiver ativado para o conjunto de ferramentas).
Tags:execution
--[no]trim_test_configuration
padrão: "true"-
Quando ativada, as opções relacionadas ao teste são limpas abaixo do nível superior do build. Quando essa flag está ativa, os testes não podem ser criados como dependências de regras que não são de teste, mas as mudanças nas opções relacionadas ao teste não fazem com que as regras que não são de teste sejam analisadas novamente.
Tags
:loading_and_analysis
,loses_incremental_state
- Opções que afetam o nível de detalhamento, o formato ou o local de geração de registros:
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
padrão: "-.*"-
Mostra informações de depuração durante a resolução da cadeia de ferramentas. A flag usa uma regex, que é verificada em relação aos tipos de conjunto de ferramentas e destinos específicos para saber quais depurar. Vários regexes podem ser separados por vírgulas, e cada regex é verificado separadamente. Observação: a saída dessa flag é muito complexa e provavelmente só será útil para especialistas em resolução de cadeias de ferramentas.
Tags:terminal_output
- Opções que especificam ou alteram uma entrada genérica para um comando do Bazel que não se enquadra em outras categorias.:
- Vários usos de
--flag_alias=<a 'name=value' flag alias>
são acumulados -
Define um nome abreviado para uma flag do Starlark. Ele usa um único par de chave-valor no formato "<chave>=<valor>" como argumento.
Tags:changes_inputs
--[no]incompatible_default_to_explicit_init_py
padrão: "false"-
Essa flag muda o comportamento padrão para que os arquivos __init__.py não sejam mais criados automaticamente nos runfiles de destinos do Python. Mais precisamente, quando um destino py_binary ou py_test tem legacy_create_init definido como "auto" (padrão), ele é tratado como falso se e somente se essa flag estiver definida. Consulte https://github.com/bazelbuild/bazel/issues/10076.
Tags:affects_outputs
,incompatible_change
--[no]incompatible_py2_outputs_are_suffixed
padrão: "true"-
Se verdadeiro, os destinos criados na configuração do Python 2 vão aparecer em uma raiz de saída que inclui o sufixo "-py2", enquanto os destinos criados para o Python 3 vão aparecer em uma raiz sem sufixo relacionado ao Python. Isso significa que o link simbólico de conveniência "bazel-bin" vai apontar para destinos do Python 3 em vez do Python 2. Se você ativar essa opção, também será recomendável ativar `--incompatible_py3_is_default`.
Tags:affects_outputs
,incompatible_change
--[no]incompatible_py3_is_default
padrão: "true"-
Se verdadeiro, os destinos "py_binary" e "py_test" que não definem o atributo "python_version" (ou "default_python_version") vão assumir o valor padrão PY3 em vez de PY2. Se você definir essa flag, também será recomendável definir `--incompatible_py2_outputs_are_suffixed`.
Tags
:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_use_python_toolchains
padrão: "true"-
Se definido como "true", as regras executáveis nativas do Python vão usar o ambiente de execução especificado pelo conjunto de ferramentas do Python, em vez do ambiente de execução fornecido por flags legadas, como --python_top.
Tags:loading_and_analysis
,incompatible_change
--python_version=<PY2 or PY3>
padrão: consulte a descrição-
O modo de versão principal do Python, "PY2" ou "PY3". Essa flag é substituída por "py_binary" e "py_test" (mesmo que não especifiquem explicitamente uma versão). Portanto, geralmente não há motivos para fornecer essa flag.
Tags:loading_and_analysis
,affects_outputs
- Opções diversas, não categorizadas.:
--[no]cache_test_results
[-t
] padrão: "auto"- Se definido como "auto", o Bazel vai executar novamente um teste somente se: (1) o Bazel detectar mudanças no teste ou nas dependências dele, (2) o teste estiver marcado como externo, (3) várias execuções de teste tiverem sido solicitadas com --runs_per_test ou(4) o teste tiver falhado anteriormente. Se definido como "sim", o Bazel armazena em cache todos os resultados de teste, exceto os marcados como externos. Se definido como "no", o Bazel não armazena em cache nenhum resultado de teste.
--[no]experimental_cancel_concurrent_tests
padrão: "false"-
Se verdadeiro, o Blaze vai cancelar os testes em execução simultaneamente na primeira execução bem-sucedida. Isso só é útil em combinação com --runs_per_test_detects_flakes.
Tags:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_fetch_all_coverage_outputs
padrão: "false"-
Se verdadeiro, o Bazel busca o diretório de dados de cobertura inteiro para cada teste durante uma execução de cobertura.
Tags:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_generate_llvm_lcov
padrão: "false"-
Se verdadeiro, a cobertura do clang vai gerar um relatório LCOV.
Tags:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_j2objc_header_map
padrão: "true"-
Define se o mapa de cabeçalho J2ObjC será gerado em paralelo à transpilação J2ObjC.
Tags:experimental
--[no]experimental_j2objc_shorter_header_path
padrão: "false"-
Define se o caminho do cabeçalho será gerado com um caminho mais curto (usa "_ios" em vez de "_j2objc").
Tags:affects_outputs
,experimental
--experimental_java_classpath=<off, javabuilder or bazel>
padrão: "javabuilder"- Habilita caminhos de classe reduzidos para compilações Java.
--[no]experimental_limit_android_lint_to_android_constrained_java
padrão: "false"-
Não tem operação, mantido apenas para compatibilidade com versões anteriores
Tags:affects_outputs
,experimental
--[no]experimental_run_android_lint_on_java_rules
padrão: "false"-
Define se as fontes java_* precisam ser validadas.
Tags:affects_outputs
,experimental
--[no]explicit_java_test_deps
padrão: "false"- Especifique explicitamente uma dependência do JUnit ou do Hamcrest em um java_test em vez de acidentalmente extrair das dependências do TestRunner. No momento, só funciona com o Bazel.
--host_java_launcher=<a build target label>
padrão: consulte a descrição- O iniciador Java usado por ferramentas executadas durante um build.
- Vários usos de
--host_javacopt=<a string>
são acumulados - Opções adicionais para transmitir ao javac ao criar ferramentas que são executadas durante um build.
- Vários usos de
--host_jvmopt=<a string>
são acumulados - Opções adicionais para transmitir à VM Java ao criar ferramentas que são executadas durante o build. Essas opções serão adicionadas às opções de inicialização da VM de cada destino java_binary.
--[no]incompatible_check_sharding_support
padrão: "true"-
Se verdadeiro, o Bazel vai falhar em um teste fragmentado se o executor de teste não indicar que ele oferece suporte ao fragmentação tocando no arquivo no caminho em TEST_SHARD_STATUS_FILE. Se for falso, um executor de teste que não oferece suporte ao fragmentação vai fazer com que todos os testes sejam executados em cada fragmento.
Tags:incompatible_change
--[no]incompatible_exclusive_test_sandboxed
padrão: "true"-
Se verdadeiro, os testes exclusivos serão executados com a estratégia de sandbox. Adicionar a tag "local" para forçar a execução de um teste exclusivo localmente
Tags:incompatible_change
--[no]incompatible_strict_action_env
padrão: "false"-
Se verdadeiro, o Bazel usa um ambiente com um valor estático para PATH e não herda LD_LIBRARY_PATH. Use --action_env=ENV_VARIABLE se quiser herdar variáveis de ambiente específicas do cliente. No entanto, isso pode impedir o armazenamento em cache entre usuários se um cache compartilhado for usado.
Tags:loading_and_analysis
,incompatible_change
- Vários usos de
--j2objc_translation_flags=<comma-separated list of options>
são acumulados - Opções adicionais para transmitir à ferramenta J2ObjC.
--java_debug
-
Faz com que a máquina virtual Java de um teste Java aguarde uma conexão de um depurador compatível com JDWP (como o jdb) antes de iniciar o teste. Implica em -test_output=streamed.
É expandido para:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
--[no]java_deps
padrão: "true"- Gera informações de dependência (por enquanto, o classpath do tempo de compilação) por destino Java.
--[no]java_header_compilation
padrão: "true"- Compile ijars diretamente da fonte.
--java_language_version=<a string>
padrão: ""- A versão da linguagem Java
--java_launcher=<a build target label>
padrão: consulte a descrição- O iniciador Java a ser usado ao criar binários Java. Se essa flag for definida como uma string vazia, o iniciador do JDK será usado. O atributo "launcher" substitui essa flag.
--java_runtime_version=<a string>
padrão: "local_jdk"- A versão do ambiente de execução Java
--javacopt=<a string>
vários usos são acumulados- Outras opções para transmitir ao javac.
- Vários usos de
--jvmopt=<a string>
são acumulados - Outras opções para transmitir à VM Java. Essas opções serão adicionadas às opções de inicialização da VM de cada destino java_binary.
--legacy_main_dex_list_generator=<a build target label>
padrão: consulte a descrição- Especifica um binário a ser usado para gerar a lista de classes que precisam estar no dex principal ao compilar o multidex legado.
--optimizing_dexer=<a build target label>
padrão: consulte a descrição- Especifica um binário a ser usado para fazer a dexação sem fragmentação.
- Vários usos de
--plugin=<a build target label>
são acumulados - Plug-ins para usar no build. Atualmente funciona com java_plugin.
--proguard_top=<a build target label>
padrão: consulte a descrição- Especifica qual versão do ProGuard usar para a remoção de código ao criar um binário Java.
--proto_compiler=<a build target label>
padrão: "@bazel_tools//tools/proto:protoc"-
O rótulo do protocompilador.
Tags:affects_outputs
,loading_and_analysis
--[no]proto_profile
padrão: "true"-
Define se o profile_path será transmitido para o compilador proto.
Tags:affects_outputs
,loading_and_analysis
--proto_profile_path=<a build target label>
padrão: consulte a descrição-
O perfil a ser transmitido ao compilador proto como profile_path. Se não for definido, mas --proto_profile for verdadeiro (padrão), o caminho será inferido de --fdo_optimize.
Tags:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
padrão: "@bazel_tools//tools/proto:cc_toolchain"-
Rótulo de proto_lang_toolchain() que descreve como compilar protos C++
Tags:affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
padrão: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"-
Rótulo de proto_lang_toolchain() que descreve como compilar protos j2objc
Tags:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
padrão: "@bazel_tools//tools/proto:java_toolchain"-
Rótulo de proto_lang_toolchain() que descreve como compilar protos Java
Tags:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
padrão: "@bazel_tools//tools/proto:javalite_toolchain"-
Rótulo de proto_lang_toolchain() que descreve como compilar protos JavaLite
Tags:affects_outputs
,loading_and_analysis
- Vários usos de
--protocopt=<a string>
são acumulados -
Opções adicionais para transmitir ao compilador protobuf.
Tags:affects_outputs
--[no]runs_per_test_detects_flakes
padrão: "false"- Se verdadeiro, qualquer fragmento em que pelo menos uma execução/tentativa é bem-sucedida e pelo menos uma falha recebe o status FLAKY.
--shell_executable=<a path>
padrão: consulte a descrição-
Caminho absoluto para o executável do shell que o Bazel vai usar. Se ela não estiver definida, mas a variável de ambiente BAZEL_SH estiver definida na primeira invocação do Bazel (que inicia um servidor do Bazel), o Bazel vai usar essa variável. Se nenhum deles estiver definido, o Bazel vai usar um caminho padrão codificado por hard-code dependendo do sistema operacional em que ele é executado (Windows: c:/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, todos os outros: /bin/bash). O uso de um shell que não é compatível com o bash pode levar a falhas de build ou de execução dos binários gerados.
Tags:loading_and_analysis
- Vários usos de
--test_arg=<a string>
são acumulados - Especifica opções e argumentos adicionais que precisam ser transmitidos para o executável de teste. Pode ser usado várias vezes para especificar vários argumentos. Se vários testes forem executados, cada um deles vai receber argumentos idênticos. Usado apenas pelo comando "bazel test".
--test_filter=<a string>
padrão: consulte a descrição- Especifica um filtro para encaminhar ao framework de teste. Usado para limitar a execução dos testes. Isso não afeta quais metas são criadas.
--test_result_expiration=<an integer>
padrão: "-1"- Essa opção foi descontinuada e não tem efeito.
--[no]test_runner_fail_fast
padrão: "false"- Encaminha a opção de falha rápida para o executor de teste. O executor de teste precisa interromper a execução na primeira falha.
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>
padrão: "explicit"- Especifique a estratégia para o fragmentação de teste: "explicit" para usar a fragmentação apenas se o atributo BUILD "shard_count" estiver presente. "desativado" para nunca usar a fragmentação de testes. "forced=k" para aplicar os fragmentos "k" para testes, independentemente do atributo BUILD "shard_count".
--tool_java_language_version=<a string>
padrão: ""- A versão da linguagem Java usada para executar as ferramentas necessárias durante um build
--tool_java_runtime_version=<a string>
padrão: "remotejdk_11"- A versão do ambiente de execução do Java usada para executar ferramentas durante o build
--[no]use_ijars
padrão: "true"- Se ativada, essa opção faz com que a compilação Java use jars de interface. Isso vai resultar em uma compilação incremental mais rápida, mas as mensagens de erro podem ser diferentes.
Opções de despejo
- Opções que controlam a saída do comando:
--[no]action_cache
padrão: "false"-
Exibe o conteúdo do cache da ação.
Tags:bazel_monitoring
--memory=<memory mode>
padrão: consulte a descrição-
Salva o uso de memória do nó Skyframe especificado.
Tags:bazel_monitoring
--[no]packages
padrão: "false"-
Despejar o conteúdo do cache do pacote.
Tags:bazel_monitoring
--[no]rule_classes
padrão: "false"-
Salva as classes de regras.
Tags:bazel_monitoring
--[no]rules
padrão: "false"-
Regras de despejo, incluindo contagens e uso de memória (se a memória for rastreada).
Tags:bazel_monitoring
--skyframe=<off, summary, count, value, deps, rdeps, function_graph, working_set or working_set_frontier_deps>
padrão: "desativado"-
Descarrega o gráfico do Skyframe.
Tags:bazel_monitoring
--skykey_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
padrão: ".*"-
Filtro de regex dos nomes da SkyKey para saída. Usado apenas com --skyframe=deps, rdeps, function_graph.
Tags:bazel_monitoring
--skylark_memory=<a string>
padrão: consulte a descrição-
Salva um perfil de memória compatível com pprof no caminho especificado. Para saber mais, consulte https://github.com/google/pprof.
Tags:bazel_monitoring
- Essa opção afeta a semântica da linguagem Starlark ou a API de build acessível a arquivos BUILD, .bzl ou WORKSPACE.:
--[no]incompatible_use_plus_in_repo_names
padrão: "true"-
No-op.
Tags:loading_and_analysis
Opções de busca
Herda todas as opções de test.
- Opções que controlam a execução do build:
--[no]all
padrão: "false"-
Busca todos os repositórios externos necessários para criar qualquer destino ou repositório. Esse é o padrão se nenhuma outra flag e nenhum outro argumento forem fornecidos. Só funciona quando o --enable_bzlmod está ativado.
Tags:changes_inputs
--[no]keep_going
[-k
] padrão: "false"-
Continue o máximo possível após um erro. Embora a meta que falhou e as que dependem dela não possam ser analisadas, outros pré-requisitos dessas metas podem ser.
Tags: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">
padrão: "auto"-
Número de linhas de execução paralelas a serem usadas na fase de carregamento/análise.Recebe um número inteiro ou uma palavra-chave ("auto", "HOST_CPUS", "HOST_RAM"), seguida opcionalmente por uma operação ([-|*]<float>), por exemplo. "auto", "HOST_CPUS*.5". "auto" define um padrão razoável com base nos recursos do host. Precisa ser pelo menos 1.
Tags:bazel_internal_configuration
- Essa opção afeta a semântica da linguagem Starlark ou a API de build acessível a arquivos BUILD, .bzl ou WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility
padrão: "false"-
Se incompatible_enforce_config_setting_visibility=false, isso é um noop. Caso contrário, se essa flag for falsa, qualquer config_setting sem um atributo de visibilidade explícito será //visibility:public. Se essa flag for verdadeira, a config_setting vai seguir a mesma lógica de visibilidade de todas as outras regras. Consulte https://github.com/bazelbuild/bazel/issues/12933.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
padrão: "true"-
Se verdadeiro, aplique as restrições de visibilidade de config_setting. Se for falso, cada config_setting será visível para cada destino. Consulte https://github.com/bazelbuild/bazel/issues/12932.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_use_plus_in_repo_names
padrão: "true"-
No-op.
Tags:loading_and_analysis
- Opções relacionadas à saída e semântica do Bzlmod:
--[no]configure
padrão: "false"-
Busca apenas repositórios marcados como "configure" para fins de configuração do sistema. Só funciona quando o --enable_bzlmod está ativado.
Tags:changes_inputs
--[no]force
padrão: "false"-
Ignora o repositório atual, se houver, e força a busca dele novamente. Só funciona quando o --enable_bzlmod está ativado.
Tags:changes_inputs
- Vários usos de
--repo=<a string>
são acumulados -
Busca apenas o repositório especificado, que pode ser {@apparent_repo_name} ou {@@canonical_repo_name}. Só funciona quando o --enable_bzlmod está ativado.
Tags:changes_inputs
- Opções que afetam a verbosidade, o formato ou o local de registro:
--experimental_repository_resolved_file=<a string>
padrão: ""-
Se não estiver vazio, grave um valor do Starlark com as informações resolvidas de todas as regras do repositório do Starlark que foram executadas.
Tags:affects_outputs
- Opções diversas, não categorizadas.:
- Vários usos de
--deleted_packages=<comma-separated list of package names>
são acumulados - Uma lista separada por vírgulas de nomes de pacotes que o sistema de build vai considerar inexistentes, mesmo que estejam visíveis em algum lugar no caminho do pacote. Use essa opção ao excluir um subpacote "x/y" de um pacote "x" existente. Por exemplo, depois de excluir x/y/BUILD no cliente, o sistema de build pode reclamar se encontrar um rótulo '//x:y/z', caso ele ainda seja fornecido por outra entrada de package_path. Especificar --deleted_packages x/y evita esse problema.
--[no]fetch
padrão: "true"- Permite que o comando busque dependências externas. Se definido como "false", o comando vai usar qualquer versão em cache da dependência. Se nenhuma existir, o comando vai resultar em falha.
--package_path=<colon-separated list of options>
padrão: "%workspace%"- Uma lista separada por dois-pontos de onde procurar pacotes. Os elementos que começam com "%workspace%" são relativos ao espaço de trabalho que os contém. Se omitido ou vazio, o padrão é a saída de "bazel info default-package-path".
--[no]show_loading_progress
padrão: "true"- Se ativado, faz com que o Bazel imprima mensagens "Carregando pacote:".
- Opções que controlam a execução do build:
--[no]experimental_inprocess_symlink_creation
padrão: "true"-
Define se é possível fazer chamadas diretas do sistema de arquivos para criar árvores de links simbólicos em vez de delegar a um processo auxiliar.
Tags:loading_and_analysis
,execution
,experimental
--[no]experimental_persistent_aar_extractor
padrão: "false"-
Ative o extrator de aar persistente usando workers.
Tags:execution
,experimental
--[no]experimental_remotable_source_manifests
padrão: "false"-
Define se as ações de manifesto de origem podem ser remotas
Tags:loading_and_analysis
,execution
,experimental
--[no]experimental_split_coverage_postprocessing
padrão: "false"-
Se verdadeiro, o Bazel vai executar o pós-processamento de cobertura para teste em uma nova geração.
Tags:execution
,experimental
--[no]experimental_strict_fileset_output
padrão: "false"-
Se essa opção estiver ativada, os conjuntos de arquivos vão tratar todos os artefatos de saída como arquivos comuns. Eles não atravessam diretórios nem são sensíveis a links simbólicos.
Tags:execution
,experimental
--[no]incompatible_modify_execution_info_additive
padrão: "false"-
Quando ativada, a transmissão de várias flags --modify_execution_info é aditiva. Quando desativado, apenas a última flag é considerada.
Tags:execution
,affects_outputs
,loading_and_analysis
,incompatible_change
- Vários usos de
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
são acumulados -
Adiciona ou remove chaves das informações de execução de uma ação com base na mnemônica da ação. Aplicável apenas a ações que oferecem suporte a informações de execução. Muitas ações comuns oferecem suporte a informações de execução, por exemplo, Genrule, CppCompile, Javac, StarlarkAction e TestRunner. Ao especificar vários valores, a ordem é importante, porque muitas expressões regulares podem ser aplicadas ao mesmo mnemônico.
Sintaxe: "regex=[+-]chave,regex=[+-]chave,...".
Exemplos:
'.*=+x,.*=-y,.*=+z' adiciona "x" e "z" e remove "y" das informações de execução de todas as ações.
"Genrule=+requires-x" adiciona "requires-x" às informações de execução de todas as ações de Genrule.
'(?!Genrule).*=-requires-x' remove 'requires-x' das informações de execução de todas as ações que não são Genrule.
Tags:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Ative ações persistentes de dex e desugar do Android usando workers.
É expandido para:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Tags:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
-
Ative o processador de recursos Android persistente usando workers.
Expande para:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
--strategy=ProcessDatabinding=worker
--strategy=GenerateDataBindingBaseClasses=worker
Tags:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_dex_desugar
-
Ative ações persistentes de dex e desugar Android multiplexadas usando workers.
Expande para:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
Tags:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
Ative o processador de recursos Android multiplexado permanente usando workers.
Expande para:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
Tags:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_tools
-
Ative ferramentas Android persistentes e multiplexadas (dexing, desugaring, processamento de recursos).
É expandido para:
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Tags:host_machine_resource_optimizations
,execution
--[no]use_target_platform_for_tests
padrão: "false"-
Se verdadeiro, o Bazel vai usar a plataforma de destino para executar testes em vez do grupo de execução de teste.
Tags
:execution
- Opções que configuram a cadeia de ferramentas usada para a execução de ações:
--android_compiler=<a string>
padrão: consulte a descrição-
O compilador de destino do Android.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
padrão: "android"-
Seleciona a combinação de manifesto a ser usada para regras android_binary. Flag para ajudar na transição para a combinação de manifestos do Android da combinação legada.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_platforms=<a build target label>
padrão: ""-
Define as plataformas que os destinos android_binary usam. Se várias plataformas forem especificadas, o binário será um APK grande, que contém binários nativos para cada plataforma de destino especificada.
Tags:changes_inputs
,loading_and_analysis
,loses_incremental_state
--apple_crosstool_top=<a build target label>
padrão: "@bazel_tools//tools/cpp:toolchain"-
O rótulo do pacote de ferramentas cruzadas a ser usado nas regras da Apple e do Objc e nas dependências deles.
Tags:loses_incremental_state
,changes_inputs
--cc_output_directory_tag=<a string>
padrão: ""-
Especifica um sufixo a ser adicionado ao diretório de configuração.
Tags:affects_outputs
--compiler=<a string>
padrão: consulte a descrição-
O compilador C++ a ser usado para compilar o destino.
Tags:loading_and_analysis
,execution
--coverage_output_generator=<a build target label>
padrão: "@bazel_tools//tools/test:lcov_merger"-
Local do binário usado para pós-processar relatórios de cobertura brutos. No momento, ele precisa ser um grupo de arquivos que contém um único arquivo, o binário. O padrão é "//tools/test:lcov_merger".
Tags:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
padrão: "@bazel_tools//tools/test:coverage_report_generator"-
Local do binário usado para gerar relatórios de cobertura. No momento, ele precisa ser um grupo de arquivos que contém um único arquivo, o binário. O padrão é "//tools/test:coverage_report_generator".
Tags:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
padrão: "@bazel_tools//tools/test:coverage_support"-
Local dos arquivos de suporte necessários nas entradas de cada ação de teste que coleta a cobertura do código. O padrão é "//tools/test:coverage_support".
Tags:changes_inputs
,affects_outputs
,loading_and_analysis
--custom_malloc=<a build target label>
padrão: consulte a descrição-
Especifica uma implementação personalizada de malloc. Essa configuração substitui os atributos malloc nas regras de build.
Tags:changes_inputs
,affects_outputs
- Vários usos de
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
são acumulados -
Lista de expressões regulares separadas por vírgulas, cada uma opcionalmente prefixada por - (expressão negativa), atribuída a (=) a uma lista de destinos de valor de restrição separados por vírgulas. Se um destino corresponder a nenhuma expressão negativa e a pelo menos uma expressão positiva, a resolução da cadeia de ferramentas será realizada como se tivesse declarado os valores de restrição como restrições de execução. Exemplo: //demo,-test=@platforms//cpus:x86_64 vai adicionar "x86_64" a qualquer destino em //demo, exceto aqueles cujo nome contém "test".
Tags:loading_and_analysis
--[no]experimental_include_xcode_execution_requirements
padrão: "false"-
Se definido, adicione um requisito de execução "requires-xcode:{version}" a cada ação do Xcode. Se a versão do Xcode tiver um rótulo com hífen, adicione também um requisito de execução "requires-xcode-label:{version_label}".
Tags:loses_incremental_state
,loading_and_analysis
,execution
,experimental
--[no]experimental_prefer_mutual_xcode
padrão: "true"-
Se verdadeiro, use o Xcode mais recente disponível local e remotamente. Se for falso ou se não houver versões disponíveis em comum, use a versão local do Xcode selecionada pelo xcode-select.
Tags:loses_incremental_state
,experimental
--extra_execution_platforms=<comma-separated list of options>
padrão: ""-
As plataformas de execução disponíveis para executar ações. As plataformas podem ser especificadas por destino exato ou como um padrão de destino. Essas plataformas serão consideradas antes daquelas declaradas no arquivo WORKSPACE por register_execution_platforms(). Essa opção só pode ser definida uma vez. As instâncias posteriores vão substituir as configurações de sinalizações anteriores.
Tags:execution
- Vários usos de
--extra_toolchains=<comma-separated list of options>
são acumulados -
As regras do conjunto de ferramentas que serão consideradas durante a resolução do conjunto de ferramentas. As cadeias de ferramentas podem ser especificadas por destino exato ou como um padrão de destino. Esses conjuntos de ferramentas serão considerados antes dos declarados no arquivo WORKSPACE por register_toolchains().
Tags:affects_outputs
,changes_inputs
,loading_and_analysis
--grte_top=<a label>
padrão: consulte a descrição-
Um rótulo para uma biblioteca libc registrada. O valor padrão é selecionado pela cadeia de ferramentas de crosstool, e você quase nunca precisa substituí-lo.
Tags:action_command_lines
,affects_outputs
--host_compiler=<a string>
padrão: consulte a descrição-
Flag de no-op. Será removido em uma versão futura.
Tags:loading_and_analysis
,execution
--host_grte_top=<a label>
padrão: consulte a descrição-
Se especificado, essa configuração substitui o diretório de nível superior libc (--grte_top) para a configuração de execução.
Tags:action_command_lines
,affects_outputs
--host_platform=<a build target label>
padrão: "@bazel_tools//tools:host_platform"-
O rótulo de uma regra de plataforma que descreve o sistema de host.
Tags:affects_outputs
,changes_inputs
,loading_and_analysis
--[no]incompatible_bazel_test_exec_run_under
padrão: "false"-
Se ativado, "bazel test --run_under=//:runner" cria "//:runner" na configuração de execução. Se desativado, ele cria "//:runner" na configuração de destino. O Bazel executa testes em máquinas de execução, portanto, o primeiro é mais correto. Isso não afeta o "bazel run", que sempre gera "`--run_under=//foo" na configuração de destino.
Tags:affects_outputs
,incompatible_change
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
padrão: "true"-
Se verdadeiro, o Bazel não vai ativar os recursos "host" e "nonhost" na cadeia de ferramentas C++. Consulte https://github.com/bazelbuild/bazel/issues/7407 para mais informações.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_apple_toolchain_resolution
padrão: "false"-
Use a resolução do toolchain para selecionar o SDK da Apple para regras da Apple (Starlark e nativa)
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_legacy_whole_archive
padrão: "true"-
Se verdadeiro, o Bazel não vai vincular as dependências de biblioteca como um arquivo completo por padrão (consulte https://github.com/bazelbuild/bazel/issues/7362 para instruções de migração).
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_strip_executable_safely
padrão: "false"-
Se verdadeiro, a ação de remoção para executáveis vai usar a flag -x, que não interrompe a resolução de símbolos dinâmicos.
Tags:action_command_lines
,incompatible_change
-
Use objetos compartilhados de interface se o conjunto de ferramentas oferecer suporte a eles. Todas as cadeias de ferramentas ELF atualmente oferecem suporte a essa configuração.
Tags:loading_and_analysis
,affects_outputs
,affects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
Especifica a versão do SDK para iOS a ser usada para criar aplicativos iOS. Se não for especificado, vai usar a versão padrão do SDK para iOS de "xcode_version".
Tags:loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
Especifica a versão do SDK do macOS a ser usada para criar aplicativos do macOS. Se não for especificado, vai usar a versão padrão do SDK do macOS de "xcode_version".
Tags:loses_incremental_state
--minimum_os_version=<a string>
padrão: consulte a descrição-
A versão mínima do SO para a qual a compilação é direcionada.
Tags:loading_and_analysis
,affects_outputs
--platform_mappings=<a main workspace-relative path>
padrão: ""-
O local de um arquivo de mapeamento que descreve qual plataforma usar se nenhuma estiver definida ou quais flags definir quando uma plataforma já existir. Precisa ser relativo à raiz do espaço de trabalho principal. O padrão é "platform_mappings" (um arquivo diretamente na raiz do espaço de trabalho).
Tags:affects_outputs
,changes_inputs
,loading_and_analysis
,immutable
--platforms=<a build target label>
padrão: ""-
Os rótulos das regras da plataforma que descrevem as plataformas de destino do comando atual.
Tags:affects_outputs
,changes_inputs
,loading_and_analysis
--python_path=<a string>
padrão: consulte a descrição-
O caminho absoluto do interpretador de Python invocado para executar destinos do Python na plataforma de destino. Obsoleto. Desativado por --incompatible_use_python_toolchains.
Tags:loading_and_analysis
,affects_outputs
--python_top=<a build target label>
padrão: consulte a descrição-
O identificador de um py_runtime que representa o interpretador Python invocado para executar destinos do Python na plataforma de destino. Obsoleto. Desativado por --incompatible_use_python_toolchains.
Tags:loading_and_analysis
,affects_outputs
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
Especifica a versão do SDK do tvOS a ser usada para criar aplicativos para tvOS. Se não for especificado, vai usar a versão padrão do SDK para tvOS de "xcode_version".
Tags:loses_incremental_state
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
Especifica a versão do SDK do watchOS a ser usada para criar aplicativos do watchOS. Se não for especificado, vai usar a versão padrão do SDK do watchOS de "xcode_version".
Tags:loses_incremental_state
--xcode_version=<a string>
padrão: consulte a descrição-
Se especificado, usa o Xcode da versão especificada para ações de build relevantes. Se não for especificado, vai usar a versão padrão do executor do Xcode.
Tags:loses_incremental_state
--xcode_version_config=<a build target label>
padrão: "@bazel_tools//tools/cpp:host_xcodes"-
O rótulo da regra xcode_config a ser usado para selecionar a versão do Xcode na configuração do build.
Tags
:loses_incremental_state
,loading_and_analysis
- Opções que controlam a saída do comando:
--[no]apple_generate_dsym
padrão: "false"-
Define se é necessário gerar arquivos de símbolo de depuração (.dSYM).
Tags:affects_outputs
,action_command_lines
--[no]build_runfile_links
padrão: "true"-
Se verdadeiro, cria florestas de links simbólicos de arquivos de execução para todos os destinos. Se for falso, grave-os somente quando for necessário por uma ação local, um comando de teste ou de execução.
Tags:affects_outputs
--[no]build_runfile_manifests
padrão: "true"-
Se verdadeiro, grava manifestos de runfiles para todos os destinos. Se for falso, omita-os. Os testes locais não serão executados quando for falso.
Tags:affects_outputs
--[no]build_test_dwp
padrão: "false"-
Se ativado, ao criar testes C++ de forma estática e com fissão, o arquivo .dwp do binário de teste também será criado automaticamente.
Tags:loading_and_analysis
,affects_outputs
--cc_proto_library_header_suffixes=<comma-separated set of options>
padrão: ".pb.h"-
Define os sufixos dos arquivos de cabeçalho que uma cc_proto_library cria.
Tags:affects_outputs
,loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated set of options>
padrão: ".pb.cc"-
Define os sufixos dos arquivos de origem que uma cc_proto_library cria.
Tags:affects_outputs
,loading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info
padrão: "false"-
Execute ações extras para versões alternativas de API Java em uma proto_library.
Tags:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_save_feature_state
padrão: "false"-
Salve o estado dos recursos ativados e solicitados como uma saída da compilação.
Tags:affects_outputs
,experimental
--fission=<a set of compilation modes>
padrão: "no"-
Especifica quais modos de compilação usam a divisão para compilações e links em C++. Pode ser qualquer combinação de {'fastbuild', 'dbg', 'opt'} ou os valores especiais 'yes' para ativar todos os modos e 'no' para desativar todos os modos.
Tags:loading_and_analysis
,action_command_lines
,affects_outputs
--[no]incompatible_always_include_files_in_data
padrão: "true"-
Se verdadeiro, as regras nativas adicionam <code>DefaultInfo.files</code> de dependências de dados aos runfiles, o que corresponde ao comportamento recomendado para regras do Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid).
Tags:affects_outputs
,incompatible_change
--[no]legacy_external_runfiles
padrão: "false"-
Se verdadeiro, crie florestas de links simbólicos de arquivos de execução para repositórios externos em .runfiles/wsname/external/repo (além de .runfiles/repo).
Tags:affects_outputs
--[no]objc_generate_linkmap
padrão: "false"-
Especifica se um arquivo de linkmap será gerado.
Tags:affects_outputs
--[no]save_temps
padrão: "false"-
Se definido, as saídas temporárias do gcc serão salvas. Isso inclui arquivos .s (código do assembler), .i (C pré-processado) e .ii (C++ pré-processado).
Tags
:affects_outputs
- Opções que permitem ao usuário configurar a saída pretendida, afetando o valor, em vez de sua existência:
- Vários usos de
--action_env=<a 'name=value' assignment with an optional value part>
são acumulados -
Especifica o conjunto de variáveis de ambiente disponível para ações com configuração de destino. As variáveis podem ser especificadas por nome, caso em que o valor será retirado do ambiente de invocação, ou pelo par name=value, que define o valor independente do ambiente de invocação. Essa opção pode ser usada várias vezes. Para opções fornecidas para a mesma variável, as mais recentes vencem, e as opções para variáveis diferentes são acumuladas.
Tags:action_command_lines
--allowed_cpu_values=<comma-separated set of options>
padrão: ""-
Valores permitidos para a flag --cpu.
Tags:changes_inputs
,affects_outputs
--[no]android_databinding_use_androidx
padrão: "true"-
Gera arquivos de vinculação de dados compatíveis com o AndroidX. É usado apenas com a vinculação de dados v2. Essa flag não tem efeito.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]android_databinding_use_v3_4_args
padrão: "true"-
Use o Databinding v2 do Android com o argumento 3.4.0. Essa flag não tem efeito.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--android_dynamic_mode=<off, default or fully>
padrão: "desativado"-
Determina se as dependências C++ das regras do Android serão vinculadas dinamicamente quando um cc_binary não criar explicitamente uma biblioteca compartilhada. "default" significa que o Bazel vai escolher se vai vincular dinamicamente. "totalmente" significa que todas as bibliotecas serão vinculadas dinamicamente. "off" significa que todas as bibliotecas serão vinculadas no modo quase estático.
Tags:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
padrão: "alphabetical"-
Define a ordem dos manifestos transmitidos para a combinação de manifestos para binários do Android. ALPHABETICAL significa que os manifestos são classificados por caminho em relação ao execroot. ALPHABETICAL_BY_CONFIGURATION significa que os manifestos são classificados por caminhos relativos ao diretório de configuração no diretório de saída. DEPENDENCY significa que os manifestos são ordenados com o manifesto de cada biblioteca antes dos manifestos das dependências.
Tags:action_command_lines
,execution
--[no]android_resource_shrinking
padrão: "false"-
Ativa a redução de recursos para APKs android_binary que usam o ProGuard.
Tags:affects_outputs
,loading_and_analysis
--[no]build_python_zip
padrão: "auto"-
Criar um zip executável do Python; ativado no Windows, desativado em outras plataformas
Tags:affects_outputs
- Vários usos de
--catalyst_cpus=<comma-separated list of options>
são acumulados -
Lista separada por vírgulas de arquiteturas para as quais criar binários do Apple Catalyst.
Tags:loses_incremental_state
,loading_and_analysis
--[no]collect_code_coverage
padrão: "false"-
Se especificado, o Bazel vai instrumentar o código (usando a instrumentação off-line sempre que possível) e coletar informações de cobertura durante os testes. Somente os destinos que correspondem a --instrumentation_filter serão afetados. Normalmente, essa opção não precisa ser especificada diretamente. Em vez disso, use o comando "bazel coverage".
Tags:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] padrão: "fastbuild"-
Especifica o modo em que o binário será criado. Valores: "fastbuild", "dbg", "opt".
Tags:affects_outputs
,action_command_lines
- Vários usos de
--conlyopt=<a string>
são acumulados -
Opção adicional para transmitir ao gcc ao compilar arquivos de origem C.
Tags:action_command_lines
,affects_outputs
- Vários usos de
--copt=<a string>
são acumulados -
Opções adicionais para transmitir ao gcc.
Tags:action_command_lines
,affects_outputs
--cpu=<a string>
padrão: ""-
A CPU de destino.
Tags:changes_inputs
,affects_outputs
--cs_fdo_absolute_path=<a string>
padrão: consulte a descrição-
Use as informações do perfil do CSFDO para otimizar a compilação. Especifique o nome do caminho absoluto do arquivo ZIP que contém o arquivo de perfil, um arquivo de perfil LLVM bruto ou indexado.
Tags:affects_outputs
--cs_fdo_instrument=<a string>
padrão: consulte a descrição-
Gera binários com instrumentação FDO sensível ao contexto. Com o compilador Clang/LLVM, ele também aceita o nome do diretório em que os arquivos de perfil brutos serão armazenados em disco no momento da execução.
Tags:affects_outputs
--cs_fdo_profile=<a build target label>
padrão: consulte a descrição-
O cs_fdo_profile representa o perfil sensível ao contexto a ser usado para otimização.
Tags:affects_outputs
- Vários usos de
--cxxopt=<a string>
são acumulados -
Opção extra para transmitir ao gcc ao compilar arquivos-fonte C++.
Tags:action_command_lines
,affects_outputs
- Vários usos de
--define=<a 'name=value' assignment>
são acumulados -
Cada opção --define especifica uma atribuição para uma variável de build. No caso de vários valores para uma variável, o último é o vencedor.
Tags:changes_inputs
,affects_outputs
--dynamic_mode=<off, default or fully>
padrão: "default"-
Determina se os binários C++ serão vinculados de forma dinâmica. "default" significa que o Bazel vai escolher se vai vincular dinamicamente. "totalmente" significa que todas as bibliotecas serão vinculadas dinamicamente. "off" significa que todas as bibliotecas serão vinculadas no modo quase estático.
Tags:loading_and_analysis
,affects_outputs
--[no]enable_propeller_optimize_absolute_paths
padrão: "true"-
Se definido, qualquer uso de caminhos absolutos para o propeller optimize vai gerar um erro.
Tags:affects_outputs
--[no]enable_remaining_fdo_absolute_paths
padrão: "true"-
Se definido, qualquer uso de caminhos absolutos para FDO vai gerar um erro.
Tags:affects_outputs
--[no]enable_runfiles
padrão: "auto"-
Ative a árvore de links simbólicos de runfiles. Por padrão, ela fica desativada no Windows e ativada em outras plataformas.
Tags:affects_outputs
- Vários usos de
--experimental_action_listener=<a build target label>
são acumulados -
foi descontinuado em favor de aspectos. Use action_listener para anexar uma extra_action às ações de build atuais.
Tags:execution
,experimental
--[no]experimental_android_compress_java_resources
padrão: "false"-
Compactar recursos Java em APKs
Tags:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_android_databinding_v2
padrão: "true"-
Use o Databinding v2 do Android. Essa flag não tem efeito.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_android_resource_shrinking
padrão: "false"-
Ativa a redução de recursos para APKs android_binary que usam o ProGuard.
Tags:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_android_rewrite_dexes_with_rex
padrão: "false"-
use a ferramenta rex para reescrever arquivos dex
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_collect_code_coverage_for_generated_files
padrão: "false"-
Se especificado, o Bazel também vai gerar informações de cobertura de coleta para arquivos gerados.
Tags:affects_outputs
,experimental
--experimental_objc_fastbuild_options=<comma-separated list of options>
padrão: "-O0,-DDEBUG=1"-
Usa essas strings como opções de compilador de build rápido do objc.
Tags:action_command_lines
--[no]experimental_omitfp
padrão: "false"-
Se verdadeiro, use libunwind para desfazer a pilha e compile com -fomit-frame-pointer e -fasynchronous-unwind-tables.
Tags:action_command_lines
,affects_outputs
,experimental
--experimental_output_paths=<off, content or strip>
padrão: "desativado"-
Qual modelo usar para onde as regras da árvore de saídas gravam as saídas, principalmente para builds multiplataforma / multiconfiguração. Esse recurso é altamente experimental. Consulte https://github.com/bazelbuild/bazel/issues/6526 para saber mais. As ações do Starlark podem optar pelo mapeamento de caminho adicionando a chave "supports-path-mapping" ao dicionário "execution_requirements".
Tags:loses_incremental_state
,bazel_internal_configuration
,affects_outputs
,execution
- Vários usos de
--experimental_override_name_platform_in_output_dir=<a 'label=value' assignment>
são acumulados -
Cada entrada precisa estar no formato rótulo=valor, em que "rótulo" se refere a uma plataforma e "valor" é o nome abreviado desejado para usar no caminho de saída. Só é usado quando --experimental_platform_in_output_dir é verdadeiro. Tem a maior prioridade de nomenclatura.
Tags:affects_outputs
,experimental
--[no]experimental_platform_in_output_dir
padrão: "false"-
Se verdadeiro, um nome abreviado para a plataforma de destino é usado no nome do diretório de saída em vez da CPU. O esquema exato é experimental e sujeito a mudanças: primeiro, no caso raro em que a opção --platforms não tem exatamente um valor, um hash da opção platforms é usado. Em seguida, se algum nome abreviado para a plataforma atual tiver sido registrado por --experimental_override_name_platform_in_output_dir, esse nome abreviado será usado. Em seguida, se --experimental_use_platforms_in_output_dir_legacy_heuristic estiver definido, use um nome abreviado com base no rótulo da plataforma atual. Por fim, um hash da opção de plataforma é usado como último recurso.
Tags:affects_outputs
,experimental
--[no]experimental_py_binaries_include_label
padrão: "false"-
Os destinos py_binary incluem o rótulo mesmo quando a marcação está desativada.
Tags:affects_outputs
,experimental
--[no]experimental_use_llvm_covmap
padrão: "false"-
Se especificado, o Bazel vai gerar informações do mapa de cobertura llvm-cov em vez de gcov quando o collect_code_coverage estiver ativado.
Tags:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic
padrão: "true"-
Use essa flag apenas como parte de uma estratégia de migração ou teste sugerida. A heurística tem deficiências conhecidas, e é recomendável migrar para usar apenas --experimental_override_name_platform_in_output_dir.
Tags:affects_outputs
,experimental
--fdo_instrument=<a string>
padrão: consulte a descrição-
Gera binários com instrumentação FDO. Com o compilador Clang/LLVM, ele também aceita o nome do diretório em que os arquivos de perfil brutos serão armazenados em disco no momento da execução.
Tags:affects_outputs
--fdo_optimize=<a string>
padrão: consulte a descrição-
Use informações do perfil de FDO para otimizar a compilação. Especifique o nome de um arquivo ZIP que contém uma árvore de arquivos .gcda, um arquivo afdo com um perfil automático ou um arquivo de perfil LLVM. Essa flag também aceita arquivos especificados como rótulos (por exemplo, "//foo/bar:file.afdo". Talvez seja necessário adicionar uma diretiva "exports_files" ao pacote correspondente) e rótulos que apontam para destinos "fdo_profile". Essa flag será substituída pela regra "fdo_profile".
Tags:affects_outputs
--fdo_prefetch_hints=<a build target label>
padrão: consulte a descrição-
Use dicas de pré-busca de cache.
Tags:affects_outputs
--fdo_profile=<a build target label>
padrão: consulte a descrição-
O fdo_profile que representa o perfil a ser usado para otimização.
Tags:affects_outputs
- Vários usos de
--features=<a string>
são acumulados -
Os recursos serão ativados ou desativados por padrão para destinos criados na configuração de destino. Especificar -<feature> desativa o recurso. Os recursos negativos sempre substituem os positivos. Consulte também as tags --host_features
:changes_inputs
,affects_outputs
--[no]force_pic
padrão: "false"-
Se ativado, todas as compilações C++ vão produzir código independente de posição ("-fPIC"), os links vão preferir bibliotecas pré-criadas PIC em vez de bibliotecas não-PIC, e os links vão produzir executáveis independentes de posição ("-pie").
Tags:loading_and_analysis
,affects_outputs
- Vários usos de
--host_action_env=<a 'name=value' assignment with an optional value part>
são acumulados -
Especifica o conjunto de variáveis de ambiente disponível para ações com configurações de execução. As variáveis podem ser especificadas por nome, e nesse caso o valor é retirado do ambiente de invocação, ou pelo par name=value, que define o valor independente do ambiente de invocação. Essa opção pode ser usada várias vezes. Para opções fornecidas para a mesma variável, as mais recentes vencem, e as opções para variáveis diferentes são acumuladas.
Tags:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
padrão: "opt"-
Especifica o modo em que as ferramentas usadas durante o build serão integradas. Valores: "fastbuild", "dbg", "opt".
Tags:affects_outputs
,action_command_lines
- Vários usos de
--host_conlyopt=<a string>
são acumulados -
Opção adicional para transmitir ao compilador C ao compilar arquivos-fonte C (mas não C++) nas configurações de execução.
Tags:action_command_lines
,affects_outputs
- Vários usos de
--host_copt=<a string>
são acumulados -
Opções adicionais para transmitir ao compilador C para ferramentas criadas nas configurações de execução.
Tags:action_command_lines
,affects_outputs
--host_cpu=<a string>
padrão: ""-
A CPU host.
Tags:changes_inputs
,affects_outputs
- Vários usos de
--host_cxxopt=<a string>
são acumulados -
Opções adicionais para transmitir ao compilador C++ para ferramentas criadas nas configurações de execução.
Tags:action_command_lines
,affects_outputs
- Vários usos de
--host_features=<a string>
são acumulados -
Os recursos especificados serão ativados ou desativados por padrão para os destinos criados na configuração de execução. Especificar -<feature> desativa o recurso. Os recursos negativos sempre substituem os positivos.
Tags:changes_inputs
,affects_outputs
--host_force_python=<PY2 or PY3>
padrão: consulte a descrição-
Substitui a versão do Python para a configuração de execução. Pode ser "PY2" ou "PY3".
Tags:loading_and_analysis
,affects_outputs
- Vários usos de
--host_linkopt=<a string>
são acumulados -
Opção adicional para transmitir ao vinculador ao vincular ferramentas nas configurações de execução.
Tags:action_command_lines
,affects_outputs
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
Versão mínima compatível do macOS para destinos do host. Se não for especificado, vai usar "macos_sdk_version".
Tags:loses_incremental_state
- Vários usos de
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
são acumulados -
Opções adicionais para transmitir seletivamente ao compilador C/C++ ao compilar determinados arquivos nas execuções de configuração. Essa opção pode ser transmitida várias vezes. Sintaxe: regex_filter@option_1,option_2,...,option_n. Em que regex_filter representa uma lista de padrões de expressão regular de inclusão e exclusão (consulte também --instrumentation_filter). option_1 a option_n representam opções arbitrárias de linha de comando. Se uma opção tiver uma vírgula, ela precisa ser colocada entre aspas com uma barra invertida. As opções podem conter @. Apenas o primeiro @ é usado para dividir a string. Exemplo: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 adiciona a opção de linha de comando -O0 à linha de comando do gcc de todos os arquivos cc em //foo/, exceto bar.cc.
Tags:action_command_lines
,affects_outputs
--[no]incompatible_auto_exec_groups
padrão: "false"-
Quando ativado, um grupo de execução é criado automaticamente para cada toolchain usado por uma regra. Para que isso funcione, a regra precisa especificar o parâmetro "toolchain" nas ações. Para mais informações, consulte https://github.com/bazelbuild/bazel/issues/17134.
Tags:affects_outputs
,incompatible_change
--[no]incompatible_merge_genfiles_directory
padrão: "true"-
Se verdadeiro, o diretório genfiles é dobrado no diretório bin.
Tags:affects_outputs
,incompatible_change
--[no]instrument_test_targets
padrão: "false"-
Quando a cobertura está ativada, especifica se é necessário considerar a instrumentação de regras de teste. Quando definido, as regras de teste incluídas por --instrumentation_filter são inspecionadas. Caso contrário, as regras de teste são sempre excluídas da instrumentação de cobertura.
Tags:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
padrão: "-/javatests[/:],-/test/java[/:]"-
Quando a cobertura está ativada, apenas as regras com nomes incluídos pelo filtro baseado em regex especificado são instrumentadas. As regras com o prefixo "-" são excluídas. Somente as regras que não são de teste são instrumentadas, a menos que --instrument_test_targets esteja ativado.
Tags:affects_outputs
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
Versão mínima compatível do iOS para simuladores e dispositivos de destino. Se não for especificado, vai usar "ios_sdk_version".
Tags:loses_incremental_state
- Vários usos de
--ios_multi_cpus=<comma-separated list of options>
são acumulados -
Lista separada por vírgulas de arquiteturas para criar um ios_application. O resultado é um binário universal que contém todas as arquiteturas especificadas.
Tags:loses_incremental_state
,loading_and_analysis
--[no]legacy_whole_archive
padrão: "true"-
Descontinuado, substituído por --incompatible_remove_legacy_whole_archive (consulte https://github.com/bazelbuild/bazel/issues/7362 para saber mais). Quando ativado, use --whole-archive para regras cc_binary que tenham linkshared=True e linkstatic=True ou '-static' em linkopts. Isso é apenas para compatibilidade com versões anteriores. Uma alternativa melhor é usar alwayslink=1 quando necessário.
Tags:action_command_lines
,affects_outputs
,deprecated
- Vários usos de
--linkopt=<a string>
são acumulados -
Opção adicional para transmitir ao gcc ao vincular.
Tags:action_command_lines
,affects_outputs
- Vários usos de
--ltobackendopt=<a string>
são acumulados -
Opção extra para passar para a etapa de back-end de LTO (em --features=thin_lto).
Tags:action_command_lines
,affects_outputs
- Vários usos de
--ltoindexopt=<a string>
são acumulados -
Opção extra para passar para a etapa de indexação de LTO (em --features=thin_lto).
Tags:action_command_lines
,affects_outputs
- Vários usos de
--macos_cpus=<comma-separated list of options>
são acumulados -
Lista separada por vírgulas de arquiteturas para as quais criar binários do Apple macOS.
Tags:loses_incremental_state
,loading_and_analysis
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
Versão mínima do macOS compatível para destinos. Se não for especificado, vai usar "macos_sdk_version".
Tags:loses_incremental_state
--memprof_profile=<a build target label>
padrão: consulte a descrição-
Use o perfil do memprof.
Tags:affects_outputs
--[no]objc_debug_with_GLIBCXX
padrão: "false"-
Se definido e o modo de compilação estiver definido como "dbg", defina GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC e GLIBCPP_CONCEPT_CHECKS.
Tags:action_command_lines
--[no]objc_enable_binary_stripping
padrão: "false"-
Define se o símbolo e o código morto serão removidos em binários vinculados. A remoção de binários será realizada se essa flag e --compilation_mode=opt forem especificados.
Tags:action_command_lines
- Vários usos de
--objccopt=<a string>
são acumulados -
Opções adicionais para transmitir ao gcc ao compilar arquivos de origem Objective-C/C++.
Tags:action_command_lines
- Vários usos de
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
são acumulados -
Opções adicionais para transmitir seletivamente ao gcc ao compilar determinados arquivos. Essa opção pode ser transmitida várias vezes. Sintaxe: regex_filter@option_1,option_2,...,option_n. Em que regex_filter representa uma lista de padrões de expressão regular de inclusão e exclusão (consulte também --instrumentation_filter). option_1 a option_n representam opções arbitrárias de linha de comando. Se uma opção tiver uma vírgula, ela precisa ser colocada entre aspas com uma barra invertida. As opções podem conter @. Apenas o primeiro @ é usado para dividir a string. Exemplo: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 adiciona a opção de linha de comando -O0 à linha de comando do gcc de todos os arquivos cc em //foo/, exceto bar.cc.
Tags:action_command_lines
,affects_outputs
- Vários usos de
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
são acumulados -
Opções adicionais para transmitir seletivamente para o back-end LTO (em --features=thin_lto) ao compilar determinados objetos de back-end. Essa opção pode ser transmitida várias vezes. Sintaxe: regex_filter@option_1,option_2,...,option_n. Em que regex_filter representa uma lista de padrões de expressão regular de inclusão e exclusão. option_1 a option_n representam opções arbitrárias de linha de comando. Se uma opção tiver uma vírgula, ela precisa ser colocada entre aspas com uma barra invertida. As opções podem conter @. Apenas o primeiro @ é usado para dividir a string. Exemplo: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 adiciona a opção de linha de comando -O0 à linha de comando do back-end de LTO de todos os arquivos em //foo/, exceto bar.o.
Tags:action_command_lines
,affects_outputs
--platform_suffix=<a string>
padrão: consulte a descrição-
Especifica um sufixo a ser adicionado ao diretório de configuração.
Tags:loses_incremental_state
,affects_outputs
,loading_and_analysis
--propeller_optimize=<a build target label>
padrão: consulte a descrição-
Use as informações do perfil do Propeller para otimizar o destino do build.Um perfil do Propeller precisa consistir em pelo menos um dos dois arquivos, um perfil cc e um perfil ld. Essa flag aceita um rótulo de build que precisa se referir aos arquivos de entrada do perfil do Propeller. Por exemplo, o arquivo BUILD que define o rótulo, em a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)Uma diretiva exports_files pode precisar ser adicionada ao pacote correspondente para que esses arquivos fiquem visíveis para o Bazel. A opção precisa ser usada como: --propeller_optimize=//a/b:propeller_profile
Tags:action_command_lines
,affects_outputs
--propeller_optimize_absolute_cc_profile=<a string>
padrão: consulte a descrição-
Nome do caminho absoluto do arquivo cc_profile para builds otimizados do Propeller.
Tags:affects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
padrão: consulte a descrição-
Nome de caminho absoluto do arquivo ld_profile para builds otimizados do Propeller.
Tags:affects_outputs
--run_under=<a prefix in front of command>
padrão: consulte a descrição-
Prefixo a ser inserido antes dos executáveis para os comandos "test" e "run". Se o valor for "foo -bar" e a linha de comando de execução for "test_binary -baz", a linha de comando final será "foo -bar test_binary -baz".Isso também pode ser um rótulo para um destino executável. Alguns exemplos são: "valgrind", "strace", "strace -c", "valgrind --quiet --num-callers=20", "//package:target", "//package:target --options".
Tags:action_command_lines
-
Se verdadeiro, as bibliotecas nativas que contêm funcionalidades idênticas serão compartilhadas entre diferentes destinos
Tags:loading_and_analysis
,affects_outputs
--[no]stamp
padrão: "false"-
Carimbo de dados binários com a data, o nome de usuário, o nome do host, as informações do espaço de trabalho etc.
Tags:affects_outputs
--strip=<always, sometimes or never>
padrão: "às vezes"-
Especifica se os binários e as bibliotecas compartilhadas serão removidos (usando "-Wl,--strip-debug"). O valor padrão de 'sometimes' significa remover iff --compilation_mode=fastbuild.
Tags:affects_outputs
- Vários usos de
--stripopt=<a string>
são acumulados -
Opções adicionais para transmitir a remoção ao gerar um binário '<name>.stripped'.
Tags:action_command_lines
,affects_outputs
- Vários usos de
--tvos_cpus=<comma-separated list of options>
são acumulados -
Lista separada por vírgulas de arquiteturas para as quais criar binários do Apple tvOS.
Tags:loses_incremental_state
,loading_and_analysis
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
Versão mínima compatível do tvOS para simuladores e dispositivos de destino. Se não for especificado, vai usar "tvos_sdk_version".
Tags:loses_incremental_state
- Vários usos de
--visionos_cpus=<comma-separated list of options>
são acumulados -
Lista separada por vírgulas de arquiteturas para as quais criar binários do Apple VisionOS.
Tags:loses_incremental_state
,loading_and_analysis
- Vários usos de
--watchos_cpus=<comma-separated list of options>
são acumulados -
Lista separada por vírgulas de arquiteturas para as quais criar binários do Apple watchOS.
Tags:loses_incremental_state
,loading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
Versão mínima do watchOS compatível para simuladores e dispositivos de destino. Se não for especificado, será usado "watchos_sdk_version".
Tags:loses_incremental_state
--xbinary_fdo=<a build target label>
padrão: consulte a descrição-
Use informações de perfil XbinaryFDO para otimizar a compilação. Especifica o nome do perfil de binário cruzado padrão. Quando a opção é usada com --fdo_instrument/--fdo_optimize/--fdo_profile, essas opções sempre prevalecem como se xbinary_fdo nunca fosse especificado.
Tags:affects_outputs
- Opções que afetam a forma como o Bazel aplica estritamente as entradas de build válidas (definições de regras, combinações de sinalizações etc.):
--[no]check_licenses
padrão: "false"-
Verifique se as restrições de licenciamento impostas por pacotes dependentes não entram em conflito com os modos de distribuição das metas que estão sendo criadas. Por padrão, as licenças não são verificadas.
Tags:build_file_semantics
--[no]check_visibility
padrão: "true"-
Se desativado, os erros de visibilidade em dependências de destino são rebaixados para avisos.
Tags:build_file_semantics
--[no]desugar_for_android
padrão: "true"-
Define se o bytecode Java 8 será simplificado antes da desindexação.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]desugar_java8_libs
padrão: "false"-
Define se as bibliotecas Java 8 com suporte vão ser incluídas em apps para dispositivos legados.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]enforce_constraints
padrão: "true"-
Verifica os ambientes com que cada destino é compatível e informa erros se algum destino tiver dependências que não oferecem suporte aos mesmos ambientes
Tags:build_file_semantics
--[no]experimental_check_desugar_deps
padrão: "true"-
Define se a dessugarização correta precisa ser verificada novamente no nível binário do Android.
Tags:eagerness_to_exit
,loading_and_analysis
,experimental
--experimental_import_deps_checking=<a string>
padrão: consulte a descrição-
Não tem operação, mantido apenas para compatibilidade com versões anteriores
Tags:loading_and_analysis
--experimental_one_version_enforcement=<off, warning or error>
padrão: "OFF"-
Quando ativada, essa regra garante que uma regra java_binary não possa conter mais de uma versão do mesmo arquivo de classe no classpath. Essa aplicação pode interromper o build ou apenas resultar em avisos.
Tags:loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
padrão: "default"-
Se verdadeiro, verifica se um destino Java declara explicitamente todos os destinos usados diretamente como dependências.
Tags:build_file_semantics
,eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files
padrão: "false"-
Se ativado, verifique se há destinos de pré-requisito que são arquivos de saída procurando o testonly da regra de geração. Isso corresponde à verificação de visibilidade.
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_check_visibility_for_toolchains
padrão: "false"-
Se ativada, a verificação de visibilidade também se aplica às implementações de cadeia de ferramentas.
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_disable_native_android_rules
padrão: "false"-
Se ativado, o uso direto das regras nativas do Android será desativado. Use as regras do Starlark Android em https://github.com/bazelbuild/rules_android
Tags:eagerness_to_exit
,incompatible_change
--[no]incompatible_disable_native_apple_binary_rule
padrão: "false"-
Não há operação. Mantido aqui para compatibilidade com versões anteriores.
Tags:eagerness_to_exit
,incompatible_change
--[no]incompatible_python_disable_py2
padrão: "true"-
Se verdadeiro, o uso das configurações do Python 2 vai causar um erro. Isso inclui python_version=PY2, srcs_version=PY2 e srcs_version=PY2ONLY. Consulte https://github.com/bazelbuild/bazel/issues/15684 para mais informações.
Tags:loading_and_analysis
,incompatible_change
--[no]one_version_enforcement_on_java_tests
padrão: "true"-
Quando ativado e com experimental_one_version_enforcement definido como um valor diferente de NONE, aplique uma versão aos destinos de java_test. Essa flag pode ser desativada para melhorar o desempenho do teste incremental em detrimento de possíveis violações de uma versão.
Tags:loading_and_analysis
--python_native_rules_allowlist=<a build target label>
padrão: consulte a descrição-
Uma lista de permissões (alvo package_group) a ser usada ao aplicar --incompatible_python_disallow_native_rules.
Tags:loading_and_analysis
--[no]strict_filesets
padrão: "false"-
Se essa opção estiver ativada, os conjuntos de arquivos que cruzarem os limites do pacote serão informados como erros.
Tags:build_file_semantics
,eagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default>
padrão: "error"-
A menos que esteja DESLIGADO, verifica se um destino proto_library declara explicitamente todos os destinos usados diretamente como dependências.
Tags:build_file_semantics
,eagerness_to_exit
,incompatible_change
--strict_public_imports=<off, warn, error, strict or default>
padrão: "desativado"-
A menos que esteja DESATIVADO, verifica se um destino proto_library declara explicitamente todos os destinos usados em "import public" como exportados.
Tags:build_file_semantics
,eagerness_to_exit
,incompatible_change
--[no]strict_system_includes
padrão: "false"-
Se verdadeiro, os cabeçalhos encontrados nos caminhos de inclusão do sistema (-isystem) também precisam ser declarados.
Tags:loading_and_analysis
,eagerness_to_exit
- Vários usos de
--target_environment=<a build target label>
são acumulados -
Declara o ambiente de destino desse build. Precisa ser uma referência de rótulo para uma regra de "ambiente". Se especificado, todos os destinos de nível superior precisam ser compatíveis com esse ambiente.
Tags:changes_inputs
- Opções que afetam as saídas de assinatura de um build:
--apk_signing_method=<v1, v2, v1_v2 or v4>
padrão: "v1_v2"-
Implementação a ser usada para assinar APKs
Tags:action_command_lines
,affects_outputs
,loading_and_analysis
--[no]device_debug_entitlements
padrão: "true"-
Se definido e o modo de compilação não for "opt", os apps objc vão incluir direitos de depuração ao assinar.
Tags:changes_inputs
--ios_signing_cert_name=<a string>
padrão: consulte a descrição-
Nome do certificado a ser usado para assinatura do iOS. Se não for definido, o perfil de provisionamento será usado. Pode ser a preferência de identidade do chaveiro do certificado ou (substring) do nome comum do certificado, conforme a página de manual de codesign (IDENTIDADES DE ASSINATURA).
Tags:action_command_lines
- Essa opção afeta a semântica da linguagem Starlark ou a API de build acessível a arquivos BUILD, .bzl ou WORKSPACE.:
--[no]incompatible_disallow_legacy_py_provider
padrão: "true"-
Não é uma operação, será removido em breve.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_sdk_frameworks_attributes
padrão: "false"-
Se verdadeiro, não permita os atributos sdk_frameworks e weak_sdk_frameworks em objc_library e objc_import.
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_objc_alwayslink_by_default
padrão: "false"-
Se verdadeiro, defina o valor padrão como verdadeiro para os atributos alwayslink em objc_library e objc_import.
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_python_disallow_native_rules
padrão: "false"-
Quando verdadeiro, um erro ocorre ao usar as regras py_* integradas. Em vez disso, as regras rule_python precisam ser usadas. Consulte https://github.com/bazelbuild/bazel/issues/17773 para mais informações e instruções de migração.
Tags:loading_and_analysis
,incompatible_change
- Opções que governam o comportamento do ambiente de teste ou do executor de teste:
--[no]allow_analysis_failures
padrão: "false"-
Se verdadeiro, uma falha de análise de um destino de regra resulta na propagação do destino de uma instância de AnalysisFailureInfo contendo a descrição do erro, em vez de resultar em uma falha de build.
Tags:loading_and_analysis
,experimental
--analysis_testing_deps_limit=<an integer>
padrão: "2000"-
Define o número máximo de dependências transitivas usando um atributo de regra com uma transição de configuração for_analysis_testing. Exceder esse limite vai resultar em um erro de regra.
Tags:loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure
padrão: "false"-
Se verdadeiro, as falhas de ação dex2oat vão causar a interrupção do build em vez de executar dex2oat durante o tempo de execução do teste.
Tags:loading_and_analysis
,experimental
- Vários usos de
--default_test_resources=<a resource name followed by equal and 1 float or 4 float, e.g memory=10,30,60,100>
são acumulados - Substitua a quantidade de recursos padrão para testes. O formato esperado é <resource>=<value>. Se um único número positivo for especificado como <value>, ele vai substituir os recursos padrão para todos os tamanhos de teste. Se quatro números separados por vírgula forem especificados, eles vão substituir a quantidade de recursos para os tamanhos de teste pequeno, médio, grande e enorme, respectivamente. Os valores também podem ser HOST_RAM/HOST_CPU, seguidos opcionalmente por [-|*]<float> (por exemplo, memory=HOST_RAM*.1,HOST_RAM*.2,HOST_RAM*.3,HOST_RAM*.4). Os recursos de teste padrão especificados por essa flag são substituídos por recursos explícitos especificados em tags.
--[no]experimental_android_use_parallel_dex2oat
padrão: "false"-
Use dex2oat em paralelo para acelerar o android_test.
Tags:loading_and_analysis
,host_machine_resource_optimizations
,experimental
--[no]ios_memleaks
padrão: "false"-
Ativa a verificação de vazamentos de memória em destinos ios_test.
Tags:action_command_lines
--ios_simulator_device=<a string>
padrão: consulte a descrição-
O dispositivo a ser simulado ao executar um aplicativo iOS no simulador, por exemplo, "iPhone 6". Para conferir uma lista de dispositivos, execute "xcrun simctl list devicetypes" na máquina em que o simulador será executado.
Tags:test_runner
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
A versão do iOS a ser executada no simulador durante a execução ou o teste. Isso será ignorado para regras ios_test se um dispositivo de destino for especificado na regra.
Tags:test_runner
- Vários usos de
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
são acumulados - Especifica o número de vezes que cada teste será executado. Se uma dessas tentativas falhar por qualquer motivo, o teste inteiro será considerado reprovado. Normalmente, o valor especificado é apenas um número inteiro. Exemplo: --runs_per_test=3 vai executar todos os testes três vezes. Sintaxe alternativa: regex_filter@runs_per_test. Em que runs_per_test representa um valor inteiro e regex_filter representa uma lista de padrões de expressão regular de inclusão e exclusão. Consulte também --instrumentation_filter. Exemplo: --runs_per_test=//foo/.*,-//foo/bar/.*@3 executa todos os testes em //foo/, exceto aqueles em foo/bar três vezes. Essa opção pode ser transmitida várias vezes. O argumento mais recente transmitido que corresponde tem precedência. Se nada corresponder, o teste será executado apenas uma vez.
- Vários usos de
--test_env=<a 'name=value' assignment with an optional value part>
são acumulados -
Especifica variáveis de ambiente adicionais a serem injetadas no ambiente do executor de testes. As variáveis podem ser especificadas por nome, e nesse caso o valor delas será lido no ambiente do cliente do Bazel, ou pelo par nome=valor. Essa opção pode ser usada várias vezes para especificar várias variáveis. Usado apenas pelo comando "bazel test".
Tags:test_runner
--test_timeout=<a single integer or comma-separated list of 4 integers>
padrão: "-1"- Substitua os valores padrão de tempo limite de teste (em segundos). Se um único valor inteiro positivo for especificado, ele vai substituir todas as categorias. Se quatro números inteiros separados por vírgulas forem especificados, eles vão substituir os tempos limite para curto, moderado, longo e eterno (nessa ordem). Em qualquer forma, um valor de -1 instrui o Blaze a usar os tempos limite padrão para essa categoria.
--[no]zip_undeclared_test_outputs
padrão: "false"-
Se verdadeiro, as saídas de teste não declaradas serão arquivadas em um arquivo ZIP.
Tags:test_runner
- Opções que acionam otimizações do tempo de build:
--[no]experimental_filter_library_jar_with_program_jar
padrão: "false"-
Filtre o ProgramJar do ProGuard para remover todas as classes também presentes no LibraryJar.
Tags:action_command_lines
,experimental
--[no]experimental_inmemory_dotd_files
padrão: "true"-
Se ativada, os arquivos .d do C++ serão transmitidos na memória diretamente dos nós de build remotos em vez de serem gravados no disco.
Tags:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_inmemory_jdeps_files
padrão: "true"-
Se ativado, os arquivos de dependência (.jdeps) gerados a partir de compilações Java serão transmitidos na memória diretamente dos nós de build remotos em vez de serem gravados no disco.
Tags:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_retain_test_configuration_across_testonly
padrão: "false"-
Quando ativado, o --trim_test_configuration não vai cortar a configuração de teste para regras marcadas como testonly=1. Isso reduz os problemas de conflito de ação quando regras que não são de teste dependem de regras cc_test. Não tem efeito se --trim_test_configuration for falso.
Tags:loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_starlark_cc_import
padrão: "false"-
Se ativada, a versão do Starlark de cc_import poderá ser usada.
Tags:loading_and_analysis
,experimental
--[no]experimental_unsupported_and_brittle_include_scanning
padrão: "false"-
Define se as entradas serão restritas à compilação em C/C++ com a análise de linhas #include dos arquivos de entrada. Isso pode melhorar a performance e a incrementalidade, diminuindo o tamanho das árvores de entrada de compilação. No entanto, ele também pode interromper builds porque o scanner de inclusão não implementa totalmente a semântica do pré-processador C. Especificamente, ele não entende diretivas #include dinâmicas e ignora a lógica condicional do pré-processador. Use por sua conta e risco. Todos os problemas relacionados a essa sinalização serão encerrados.
Tags:loading_and_analysis
,execution
,changes_inputs
,experimental
--[no]incremental_dexing
padrão: "true"-
Realiza a maior parte do trabalho de desindexação separadamente para cada arquivo JAR.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]objc_use_dotd_pruning
padrão: "true"-
Se definido, os arquivos .d emitidos pelo clang serão usados para podar o conjunto de entradas transmitidas para as compilações objc.
Tags:changes_inputs
,loading_and_analysis
--[no]process_headers_in_dependencies
padrão: "false"-
Ao criar um destino //a:a, processe os cabeçalhos em todos os destinos de que //a:a depende (se o processamento de cabeçalhos estiver ativado para o conjunto de ferramentas).
Tags:execution
--[no]trim_test_configuration
padrão: "true"-
Quando ativada, as opções relacionadas ao teste são limpas abaixo do nível superior do build. Quando essa flag está ativa, os testes não podem ser criados como dependências de regras que não são de teste, mas as mudanças nas opções relacionadas ao teste não fazem com que as regras que não são de teste sejam analisadas novamente.
Tags
:loading_and_analysis
,loses_incremental_state
- Opções que afetam o nível de detalhamento, o formato ou o local de geração de registros:
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
padrão: "-.*"-
Mostra informações de depuração durante a resolução da cadeia de ferramentas. A flag usa uma regex, que é verificada em relação aos tipos de conjunto de ferramentas e destinos específicos para saber quais depurar. Vários regexes podem ser separados por vírgulas, e cada regex é verificado separadamente. Observação: a saída dessa flag é muito complexa e provavelmente só será útil para especialistas em resolução de cadeias de ferramentas.
Tags:terminal_output
- Opções que especificam ou alteram uma entrada genérica para um comando do Bazel que não se enquadra em outras categorias.:
- Vários usos de
--flag_alias=<a 'name=value' flag alias>
são acumulados -
Define um nome abreviado para uma flag do Starlark. Ele usa um único par de chave-valor no formato "<chave>=<valor>" como argumento.
Tags:changes_inputs
--[no]incompatible_default_to_explicit_init_py
padrão: "false"-
Essa flag muda o comportamento padrão para que os arquivos __init__.py não sejam mais criados automaticamente nos runfiles de destinos do Python. Mais precisamente, quando um destino py_binary ou py_test tem legacy_create_init definido como "auto" (padrão), ele é tratado como falso se e somente se essa flag estiver definida. Consulte https://github.com/bazelbuild/bazel/issues/10076.
Tags:affects_outputs
,incompatible_change
--[no]incompatible_py2_outputs_are_suffixed
padrão: "true"-
Se verdadeiro, os destinos criados na configuração do Python 2 vão aparecer em uma raiz de saída que inclui o sufixo "-py2", enquanto os destinos criados para o Python 3 vão aparecer em uma raiz sem sufixo relacionado ao Python. Isso significa que o link simbólico de conveniência "bazel-bin" vai apontar para destinos do Python 3 em vez do Python 2. Se você ativar essa opção, também será recomendável ativar `--incompatible_py3_is_default`.
Tags:affects_outputs
,incompatible_change
--[no]incompatible_py3_is_default
padrão: "true"-
Se verdadeiro, os destinos "py_binary" e "py_test" que não definem o atributo "python_version" (ou "default_python_version") vão assumir o valor padrão PY3 em vez de PY2. Se você definir essa flag, também será recomendável definir `--incompatible_py2_outputs_are_suffixed`.
Tags
:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_use_python_toolchains
padrão: "true"-
Se definido como "true", as regras executáveis nativas do Python vão usar o ambiente de execução especificado pelo conjunto de ferramentas do Python, em vez do ambiente de execução fornecido por flags legadas, como --python_top.
Tags:loading_and_analysis
,incompatible_change
--python_version=<PY2 or PY3>
padrão: consulte a descrição-
O modo de versão principal do Python, "PY2" ou "PY3". Essa flag é substituída por "py_binary" e "py_test" (mesmo que não especifiquem explicitamente uma versão). Portanto, geralmente não há motivos para fornecer essa flag.
Tags:loading_and_analysis
,affects_outputs
- Opções diversas, não categorizadas.:
--[no]cache_test_results
[-t
] padrão: "auto"- Se definido como "auto", o Bazel vai executar novamente um teste somente se: (1) o Bazel detectar mudanças no teste ou nas dependências dele, (2) o teste estiver marcado como externo, (3) várias execuções de teste tiverem sido solicitadas com --runs_per_test ou(4) o teste tiver falhado anteriormente. Se definido como "sim", o Bazel armazena em cache todos os resultados de teste, exceto os marcados como externos. Se definido como "no", o Bazel não armazena em cache nenhum resultado de teste.
--[no]experimental_cancel_concurrent_tests
padrão: "false"-
Se verdadeiro, o Blaze vai cancelar os testes em execução simultaneamente na primeira execução bem-sucedida. Isso só é útil em combinação com --runs_per_test_detects_flakes.
Tags:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_fetch_all_coverage_outputs
padrão: "false"-
Se verdadeiro, o Bazel busca o diretório de dados de cobertura inteiro para cada teste durante uma execução de cobertura.
Tags:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_generate_llvm_lcov
padrão: "false"-
Se verdadeiro, a cobertura do clang vai gerar um relatório LCOV.
Tags:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_j2objc_header_map
padrão: "true"-
Define se o mapa de cabeçalho J2ObjC será gerado em paralelo à transpilação J2ObjC.
Tags:experimental
--[no]experimental_j2objc_shorter_header_path
padrão: "false"-
Define se o caminho do cabeçalho será gerado com um caminho mais curto (usa "_ios" em vez de "_j2objc").
Tags:affects_outputs
,experimental
--experimental_java_classpath=<off, javabuilder or bazel>
padrão: "javabuilder"- Habilita caminhos de classe reduzidos para compilações Java.
--[no]experimental_limit_android_lint_to_android_constrained_java
padrão: "false"-
Não tem operação, mantido apenas para compatibilidade com versões anteriores
Tags:affects_outputs
,experimental
--[no]experimental_run_android_lint_on_java_rules
padrão: "false"-
Define se as fontes java_* precisam ser validadas.
Tags:affects_outputs
,experimental
--[no]explicit_java_test_deps
padrão: "false"- Especifique explicitamente uma dependência do JUnit ou do Hamcrest em um java_test em vez de acidentalmente extrair das dependências do TestRunner. No momento, só funciona com o Bazel.
--host_java_launcher=<a build target label>
padrão: consulte a descrição- O iniciador Java usado por ferramentas executadas durante um build.
- Vários usos de
--host_javacopt=<a string>
são acumulados - Opções adicionais para transmitir ao javac ao criar ferramentas que são executadas durante um build.
- Vários usos de
--host_jvmopt=<a string>
são acumulados - Opções adicionais para transmitir à VM Java ao criar ferramentas que são executadas durante o build. Essas opções serão adicionadas às opções de inicialização da VM de cada destino java_binary.
--[no]incompatible_check_sharding_support
padrão: "true"-
Se verdadeiro, o Bazel vai falhar em um teste fragmentado se o executor de teste não indicar que ele oferece suporte ao fragmentação tocando no arquivo no caminho em TEST_SHARD_STATUS_FILE. Se for falso, um executor de teste que não oferece suporte ao fragmentação vai fazer com que todos os testes sejam executados em cada fragmento.
Tags:incompatible_change
--[no]incompatible_exclusive_test_sandboxed
padrão: "true"-
Se verdadeiro, os testes exclusivos serão executados com a estratégia de sandbox. Adicionar a tag "local" para forçar a execução de um teste exclusivo localmente
Tags:incompatible_change
--[no]incompatible_strict_action_env
padrão: "false"-
Se verdadeiro, o Bazel usa um ambiente com um valor estático para PATH e não herda LD_LIBRARY_PATH. Use --action_env=ENV_VARIABLE se quiser herdar variáveis de ambiente específicas do cliente. No entanto, isso pode impedir o armazenamento em cache entre usuários se um cache compartilhado for usado.
Tags:loading_and_analysis
,incompatible_change
- Vários usos de
--j2objc_translation_flags=<comma-separated list of options>
são acumulados - Opções adicionais para transmitir à ferramenta J2ObjC.
--java_debug
-
Faz com que a máquina virtual Java de um teste Java aguarde uma conexão de um depurador compatível com JDWP (como o jdb) antes de iniciar o teste. Implica em -test_output=streamed.
É expandido para:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
--[no]java_deps
padrão: "true"- Gera informações de dependência (por enquanto, o classpath do tempo de compilação) por destino Java.
--[no]java_header_compilation
padrão: "true"- Compile ijars diretamente da fonte.
--java_language_version=<a string>
padrão: ""- A versão da linguagem Java
--java_launcher=<a build target label>
padrão: consulte a descrição- O iniciador Java a ser usado ao criar binários Java. Se essa flag for definida como uma string vazia, o iniciador do JDK será usado. O atributo "launcher" substitui essa flag.
--java_runtime_version=<a string>
padrão: "local_jdk"- A versão do ambiente de execução Java
- Vários usos de
--javacopt=<a string>
são acumulados - Outras opções para transmitir ao javac.
- Vários usos de
--jvmopt=<a string>
são acumulados - Outras opções para transmitir à VM Java. Essas opções serão adicionadas às opções de inicialização da VM de cada destino java_binary.
--legacy_main_dex_list_generator=<a build target label>
padrão: consulte a descrição- Especifica um binário a ser usado para gerar a lista de classes que precisam estar no dex principal ao compilar o multidex legado.
--optimizing_dexer=<a build target label>
padrão: consulte a descrição- Especifica um binário a ser usado para fazer a dexação sem fragmentação.
- Vários usos de
--plugin=<a build target label>
são acumulados - Plug-ins para usar no build. Atualmente funciona com java_plugin.
--proguard_top=<a build target label>
padrão: consulte a descrição- Especifica qual versão do ProGuard usar para a remoção de código ao criar um binário Java.
--proto_compiler=<a build target label>
padrão: "@bazel_tools//tools/proto:protoc"-
O rótulo do protocompilador.
Tags:affects_outputs
,loading_and_analysis
--[no]proto_profile
padrão: "true"-
Define se o profile_path será transmitido para o compilador proto.
Tags:affects_outputs
,loading_and_analysis
--proto_profile_path=<a build target label>
padrão: consulte a descrição-
O perfil a ser transmitido ao compilador proto como profile_path. Se não for definido, mas --proto_profile for verdadeiro (padrão), o caminho será inferido de --fdo_optimize.
Tags:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
padrão: "@bazel_tools//tools/proto:cc_toolchain"-
Rótulo de proto_lang_toolchain() que descreve como compilar protos C++
Tags:affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
padrão: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"-
Rótulo de proto_lang_toolchain() que descreve como compilar protos j2objc
Tags:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
padrão: "@bazel_tools//tools/proto:java_toolchain"-
Rótulo de proto_lang_toolchain() que descreve como compilar protos Java
Tags:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
padrão: "@bazel_tools//tools/proto:javalite_toolchain"-
Rótulo de proto_lang_toolchain() que descreve como compilar protos JavaLite
Tags:affects_outputs
,loading_and_analysis
- Vários usos de
--protocopt=<a string>
são acumulados -
Opções adicionais para transmitir ao compilador protobuf.
Tags:affects_outputs
--[no]runs_per_test_detects_flakes
padrão: "false"- Se verdadeiro, qualquer fragmento em que pelo menos uma execução/tentativa é bem-sucedida e pelo menos uma falha recebe o status FLAKY.
--shell_executable=<a path>
padrão: consulte a descrição-
Caminho absoluto para o executável do shell que o Bazel vai usar. Se ela não estiver definida, mas a variável de ambiente BAZEL_SH estiver definida na primeira invocação do Bazel (que inicia um servidor do Bazel), o Bazel vai usar essa variável. Se nenhum deles estiver definido, o Bazel vai usar um caminho padrão codificado por hard-code dependendo do sistema operacional em que ele é executado (Windows: c:/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, todos os outros: /bin/bash). O uso de um shell que não é compatível com o bash pode levar a falhas de build ou de execução dos binários gerados.
Tags:loading_and_analysis
- Vários usos de
--test_arg=<a string>
são acumulados - Especifica opções e argumentos adicionais que precisam ser transmitidos para o executável de teste. Pode ser usado várias vezes para especificar vários argumentos. Se vários testes forem executados, cada um deles vai receber argumentos idênticos. Usado apenas pelo comando "bazel test".
--test_filter=<a string>
padrão: consulte a descrição- Especifica um filtro para encaminhar ao framework de teste. Usado para limitar a execução dos testes. Isso não afeta quais metas são criadas.
--test_result_expiration=<an integer>
padrão: "-1"- Essa opção foi descontinuada e não tem efeito.
--[no]test_runner_fail_fast
padrão: "false"- Encaminha a opção de falha rápida para o executor de teste. O executor de teste precisa interromper a execução na primeira falha.
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>
padrão: "explicit"- Especifique a estratégia para o fragmentação de teste: "explicit" para usar a fragmentação apenas se o atributo BUILD "shard_count" estiver presente. "desativado" para nunca usar a fragmentação de testes. "forced=k" para aplicar os fragmentos "k" para testes, independentemente do atributo BUILD "shard_count".
--tool_java_language_version=<a string>
padrão: ""- A versão da linguagem Java usada para executar as ferramentas necessárias durante um build
--tool_java_runtime_version=<a string>
padrão: "remotejdk_11"- A versão do ambiente de execução do Java usada para executar ferramentas durante o build
--[no]use_ijars
padrão: "true"- Se ativada, essa opção faz com que a compilação Java use jars de interface. Isso vai resultar em uma compilação incremental mais rápida, mas as mensagens de erro podem ser diferentes.
Opções de ajuda
- Essa opção afeta a semântica da linguagem Starlark ou a API de build acessível a arquivos BUILD, .bzl ou WORKSPACE.:
--[no]incompatible_use_plus_in_repo_names
padrão: "true"-
Sem operação.
Tags:loading_and_analysis
- Opções que afetam a quantidade de detalhes, o formato ou o local do registro:
--help_verbosity=<long, medium or short>
padrão: "medium"-
Seleciona o nível de detalhamento do comando "help".
Tags:terminal_output
--long
[-l
]-
Mostre a descrição completa de cada opção, em vez de apenas o nome.
É expandido para:
--help_verbosity=long
Tags:terminal_output
--short
-
Mostre apenas os nomes das opções, não os tipos ou significados delas.
É expandido para:
--help_verbosity=short
Tags:terminal_output
Opções de informações
Herda todas as opções de build.
- Essa opção afeta a semântica da linguagem Starlark ou a API de build acessível a arquivos BUILD, .bzl ou WORKSPACE.:
--[no]incompatible_use_plus_in_repo_names
padrão: "true"-
Sem operação.
Tags:loading_and_analysis
- Opções que afetam a quantidade de detalhes, o formato ou o local do registro:
--[no]show_make_env
padrão: "false"-
Inclua o ambiente "Make" na saída.
Tags:affects_outputs
,terminal_output
Opções de licença
- Essa opção afeta a semântica da linguagem Starlark ou a API de build acessível a arquivos BUILD, .bzl ou WORKSPACE.:
--[no]incompatible_use_plus_in_repo_names
padrão: "true"-
No-op.
Tags:loading_and_analysis
Opções de instalação em dispositivos móveis
Herda todas as opções de build.
- Opções que controlam a execução do build:
--mode=<classic, classic_internal_test_do_not_use or skylark>
padrão: "skylark"-
Flag sem efeito descontinuada. Somente o modo Skylark ainda é aceito.
Tags
:loading_and_analysis
,execution
,incompatible_change
- Opções que configuram o conjunto de ferramentas usado para a execução de ações:
--adb=<a string>
padrão: ""-
Binário adb a ser usado para o comando "mobile-install". Se não for especificado, será usado o SDK do Android especificado pela opção de linha de comando --android_sdk_channel ou o SDK padrão se --android_sdk_channel não for especificado.
Tags
:changes_inputs
- Opções que controlam a saída do comando:
--[no]incremental
padrão: "false"-
Define se uma instalação incremental será feita. Se for verdadeiro, tente evitar trabalhos adicionais desnecessários lendo o estado do dispositivo em que o código será instalado e usando essas informações para evitar trabalhos desnecessários. Se for falso (padrão), sempre faça uma instalação completa.
Tags:loading_and_analysis
--[no]split_apks
padrão: "false"-
Define se os apks divididos serão usados para instalar e atualizar o aplicativo no dispositivo. Funciona apenas com dispositivos com o Marshmallow ou versões mais recentes
Tags:loading_and_analysis
,affects_outputs
- Opções que permitem ao usuário configurar a saída pretendida, afetando o valor, em vez de sua existência:
- Vários usos de
--adb_arg=<a string>
são acumulados -
Argumentos extras a serem transmitidos para o adb. Geralmente usado para designar um dispositivo para instalação.
Tags:action_command_lines
--debug_app
-
Define se o depurador deve ser aguardando antes de iniciar o app.
Abre para:
--start=DEBUG
Tags:execution
--device=<a string>
padrão: ""-
O número de série do dispositivo adb. Se não for especificado, o primeiro dispositivo será usado.
Tags:action_command_lines
--start=<no, cold, warm or debug>
padrão: "NÃO"-
Como o app precisa ser iniciado após a instalação. Defina como WARM para preservar e restaurar o estado do aplicativo em instalações incrementais.
Tags:execution
--start_app
-
Define se o app será iniciado após a instalação.
Expande para:
--start=COLD
Tags:execution
- Essa opção afeta a semântica da linguagem Starlark ou a API de build acessível a arquivos BUILD, .bzl ou WORKSPACE.:
--[no]incompatible_use_plus_in_repo_names
padrão: "true"-
Sem operação.
Tags:loading_and_analysis
- Opções que afetam a quantidade de detalhes, o formato ou o local do registro:
--incremental_install_verbosity=<a string>
padrão: ""-
O nível de detalhamento da instalação incremental. Defina como 1 para a geração de registros de depuração.
Tags:bazel_monitoring
Opções de mod
- Opções que controlam a execução do build:
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
padrão: "auto"-
Número de linhas de execução paralelas a serem usadas na fase de carregamento/análise.Recebe um número inteiro ou uma palavra-chave ("auto", "HOST_CPUS", "HOST_RAM"), seguida opcionalmente por uma operação ([-|*]<float>), por exemplo. "auto", "HOST_CPUS*.5". "auto" define um padrão razoável com base nos recursos do host. Precisa ser pelo menos 1.
Tags:bazel_internal_configuration
- Essa opção afeta a semântica da linguagem Starlark ou a API de build acessível a arquivos BUILD, .bzl ou WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility
padrão: "false"-
Se incompatible_enforce_config_setting_visibility=false, isso é um noop. Caso contrário, se essa flag for falsa, qualquer config_setting sem um atributo de visibilidade explícito será //visibility:public. Se essa flag for verdadeira, a config_setting vai seguir a mesma lógica de visibilidade de todas as outras regras. Consulte https://github.com/bazelbuild/bazel/issues/12933.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
padrão: "true"-
Se verdadeiro, aplique as restrições de visibilidade de config_setting. Se for falso, cada config_setting será visível para cada destino. Consulte https://github.com/bazelbuild/bazel/issues/12932.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_use_plus_in_repo_names
padrão: "true"-
No-op.
Tags:loading_and_analysis
- Opções relacionadas à saída e à semântica do subcomando "mod":
--base_module=<"<root>" for the root module; <module>@<version> for a specific version of a module; <module> for all versions of a module; @<name> for a repo with the given apparent name; or @@<name> for a repo with the given canonical name>
padrão: "<root>"-
Especifica um módulo em relação ao qual os repositórios de destino especificados serão interpretados.
Tags:terminal_output
--charset=<utf8 or ascii>
padrão: "utf8"-
Escolhe o conjunto de caracteres a ser usado para a árvore. Afetam apenas a saída de texto. Os valores válidos são "utf8" ou "ascii". O padrão é "utf8"
Tags:terminal_output
--[no]cycles
padrão: "false"-
Pontua ciclos de dependência dentro da árvore exibida, que normalmente são ignorados por padrão.
Tags:terminal_output
--depth=<an integer>
padrão: "-1"-
Profundidade máxima de exibição da árvore de dependências. Uma profundidade de 1 mostra as dependências diretas, por exemplo. Para tree, path e all_paths, o padrão é Integer.MAX_VALUE, enquanto para deps e explain é 1 (só mostra dependências diretas da raiz, além das folhas de destino e seus pais).
Tags:terminal_output
--extension_filter=<a comma-separated list of <extension>s>
padrão: consulte a descrição-
Mostra apenas os usos dessas extensões de módulo e os repositórios gerados por elas se as respectivas flags estiverem definidas. Se definido, o gráfico de resultados vai incluir apenas caminhos que contêm módulos usando as extensões especificadas. Uma lista vazia desativa o filtro, especificando todas as extensões possíveis.
Tags:terminal_output
--extension_info=<hidden, usages, repos or all>
padrão: "hidden"-
Especifica quantos detalhes sobre os usos da extensão devem ser incluídos no resultado da consulta. "Usages" mostra apenas os nomes das extensões, "repos" também inclui repositórios importados com use_repo e "all" também mostra os outros repositórios gerados por extensões.
Tags:terminal_output
--extension_usages=<a comma-separated list of <module>s>
padrão: ""-
Especifica os módulos cujos usos de extensão serão mostrados na consulta show_extension.
Tags:terminal_output
--from=<a comma-separated list of <module>s>
padrão: "<root>"-
Os módulos a partir dos quais a consulta do gráfico de dependência será mostrada. Verifique a semântica exata da descrição de cada consulta. O padrão é <root>.
Tags:terminal_output
--[no]include_builtin
padrão: "false"-
Inclua módulos integrados no gráfico de dependências. Desativado por padrão porque é bastante barulhento.
Tags:terminal_output
--[no]include_unused
padrão: "false"-
As consultas também consideram e mostram os módulos não usados, que não estão presentes no gráfico de resolução do módulo após a seleção (devido à seleção de versão mínima ou regras de substituição). Isso pode ter efeitos diferentes para cada um dos tipos de consulta, ou seja, incluir novos caminhos no comando all_paths ou dependentes extras no comando explain.
Tags:terminal_output
--output=<text, json or graph>
padrão: "text"-
O formato em que os resultados da consulta precisam ser impressos. Os valores permitidos para a consulta são: text, json, graph
Tags:terminal_output
--[no]verbose
padrão: "false"-
As consultas também mostram o motivo pelo qual os módulos foram resolvidos na versão atual (se alterados). O padrão é "true" apenas para a consulta "explain".
Tags:terminal_output
- Opções diversas, não categorizadas.:
- Vários usos de
--deleted_packages=<comma-separated list of package names>
são acumulados - Uma lista separada por vírgulas de nomes de pacotes que o sistema de build vai considerar inexistentes, mesmo que estejam visíveis em algum lugar no caminho do pacote. Use essa opção ao excluir um subpacote "x/y" de um pacote "x" existente. Por exemplo, depois de excluir x/y/BUILD no cliente, o sistema de build pode reclamar se encontrar um rótulo '//x:y/z', caso ele ainda seja fornecido por outra entrada de package_path. Especificar --deleted_packages x/y evita esse problema.
--[no]fetch
padrão: "true"- Permite que o comando busque dependências externas. Se definido como "false", o comando vai usar qualquer versão em cache da dependência. Se nenhuma existir, o comando vai resultar em falha.
--package_path=<colon-separated list of options>
padrão: "%workspace%"- Uma lista separada por dois-pontos de onde procurar pacotes. Os elementos que começam com "%workspace%" são relativos ao espaço de trabalho que os contém. Se omitido ou vazio, o padrão é a saída de "bazel info default-package-path".
--[no]show_loading_progress
padrão: "true"- Se ativado, faz com que o Bazel imprima mensagens "Carregando pacote:".
Opções de Print_action
Herda todas as opções de build.
- Essa opção afeta a semântica da linguagem Starlark ou a API de build acessível a arquivos BUILD, .bzl ou WORKSPACE.:
--[no]incompatible_use_plus_in_repo_names
padrão: "true"-
Sem operação.
Tags:loading_and_analysis
- Opções diversas, não categorizadas.:
- Vários usos de
--print_action_mnemonics=<a string>
são acumulados - Lista quais mnemônicos filtrar para os dados de print_action. Nenhuma filtragem é realizada quando o campo está vazio.
Opções de consulta
- Opções que controlam a execução do build:
--[no]keep_going
[-k
] padrão: "false"-
Continue o máximo possível após um erro. Embora a meta que falhou e as que dependem dela não possam ser analisadas, outros pré-requisitos dessas metas podem ser.
Tags: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">
padrão: "auto"-
Número de linhas de execução paralelas a serem usadas na fase de carregamento/análise.Recebe um número inteiro ou uma palavra-chave ("auto", "HOST_CPUS", "HOST_RAM"), seguida opcionalmente por uma operação ([-|*]<float>), por exemplo. "auto", "HOST_CPUS*.5". "auto" define um padrão razoável com base nos recursos do host. Precisa ser pelo menos 1.
Tags:bazel_internal_configuration
- Essa opção afeta a semântica da linguagem Starlark ou a API de build acessível a arquivos BUILD, .bzl ou WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility
padrão: "false"-
Se incompatible_enforce_config_setting_visibility=false, isso é um noop. Caso contrário, se essa flag for falsa, qualquer config_setting sem um atributo de visibilidade explícito será //visibility:public. Se essa flag for verdadeira, a config_setting vai seguir a mesma lógica de visibilidade de todas as outras regras. Consulte https://github.com/bazelbuild/bazel/issues/12933.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
padrão: "true"-
Se verdadeiro, aplique as restrições de visibilidade de config_setting. Se for falso, cada config_setting será visível para cada destino. Consulte https://github.com/bazelbuild/bazel/issues/12932.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_use_plus_in_repo_names
padrão: "true"-
No-op.
Tags:loading_and_analysis
- Opções relacionadas à saída da consulta e à semântica:
--aspect_deps=<off, conservative or precise>
padrão: "conservador"-
Como resolver dependências de aspecto quando o formato de saída é um dos valores {xml,proto,record}. "Desativado" significa que nenhuma dependência de aspecto é resolvida. "Conservador" (padrão) significa que todas as dependências de aspecto declaradas são adicionadas, independentemente de receberem a classe de regras de dependências diretas. "Precisa" significa que apenas os aspectos que estão possivelmente ativos são adicionados, considerando a classe de regras das dependências diretas. O modo preciso exige o carregamento de outros pacotes para avaliar um único destino, o que o torna mais lento do que os outros modos. Além disso, nem mesmo o modo preciso é totalmente preciso: a decisão de calcular um aspecto é tomada na fase de análise, que não é executada durante a "consulta do bazel".
Tags:build_file_semantics
--[no]consistent_labels
padrão: "false"-
Se ativado, cada comando de consulta emite rótulos como se fosse pela função <code>str</code> do Starlark aplicada a uma instância de <code>Label</code>. Isso é útil para ferramentas que precisam corresponder à saída de diferentes comandos de consulta e/ou rótulos emitidos por regras. Se não estiver ativado, os formatadores de saída poderão emitir nomes de repositório aparentes (relativos ao repositório principal) para tornar a saída mais legível.
Tags:terminal_output
--[no]experimental_explicit_aspects
padrão: "false"-
aquery, cquery: se as ações geradas pelo aspecto serão incluídas na saída. query: no-op (os aspectos são sempre seguidos).
Tags:terminal_output
--[no]experimental_graphless_query
padrão: "auto"-
Se verdadeiro, usa uma implementação de consulta que não faz uma cópia do gráfico. A nova implementação só oferece suporte a --order_output=no e a um subconjunto de formatadores de saída.
Tags:build_file_semantics
,eagerness_to_exit
--graph:conditional_edges_limit=<an integer>
padrão: "4"-
O número máximo de rótulos de condição a serem mostrados. -1 significa que não há truncamento e 0 significa que não há anotação. Essa opção é válida apenas para --output=graph.
Tags:terminal_output
--[no]graph:factored
padrão: "true"-
Se verdadeiro, o gráfico será emitido "fatorado", ou seja, os nós topologicamente equivalentes serão mesclados e os rótulos serão concatenados. Essa opção é válida apenas para --output=graph.
Tags:terminal_output
--graph:node_limit=<an integer>
padrão: "512"-
O comprimento máximo da string de rótulo de um nó de gráfico na saída. Rótulos mais longos serão truncados. O valor -1 significa que não há truncamento. Essa opção é válida apenas para --output=graph.
Tags:terminal_output
--[no]implicit_deps
padrão: "true"-
Se ativada, as dependências implícitas serão incluídas no gráfico de dependências em que a consulta opera. Uma dependência implícita não é especificada explicitamente no arquivo BUILD, mas é adicionada pelo Bazel. Para cquery, essa opção controla a filtragem de toolchains resolvidas.
Tags:build_file_semantics
--[no]include_aspects
padrão: "true"-
aquery, cquery: se as ações geradas pelo aspecto serão incluídas na saída. query: no-op (os aspectos são sempre seguidos).
Tags:terminal_output
--[no]incompatible_lexicographical_output
padrão: "true"-
Se essa opção for definida, a saída de --order_output=auto será classificada em ordem alfabética.
Tags:terminal_output
,incompatible_change
--[no]incompatible_package_group_includes_double_slash
padrão: "true"-
Se ativado, ao gerar o atributo "packages" de package_group, o "//" inicial não será omitido.
Tags:terminal_output
,incompatible_change
--[no]infer_universe_scope
padrão: "false"-
Se definido e --universe_scope não for definido, um valor de --universe_scope será inferido como a lista de padrões de destino exclusivos na expressão da consulta. O valor --universe_scope inferido para uma expressão de consulta que usa funções com escopo de universo (por exemplo, "allrdeps") pode não ser o que você quer. Portanto, use essa opção somente se você souber o que está fazendo. Consulte https://bazel.build/reference/query#sky-query para conferir detalhes e exemplos. Se --universe_scope estiver definido, o valor dessa opção será ignorado. Observação: essa opção se aplica apenas a "query" (não a "cquery").
Tags:loading_and_analysis
--[no]line_terminator_null
padrão: "false"-
Define se cada formato é encerrado com \0 em vez de nova linha.
Tags:terminal_output
--[no]nodep_deps
padrão: "true"-
Se ativado, as dependências dos atributos "nodep" serão incluídas no gráfico de dependências em que a consulta opera. Um exemplo comum de um atributo "nodep" é "visibilidade". Execute e analise a saída de "info build-language" para saber mais sobre todos os atributos "nodep" na linguagem de build.
Tags:build_file_semantics
--noorder_results
-
Exibe os resultados em ordem de dependência (padrão) ou não ordenada. A saída não ordenada é mais rápida, mas só é compatível quando --output não é minrank, maxrank ou graph.
É expandido para:
--order_output=no
Tags:terminal_output
--null
-
Define se cada formato é encerrado com \0 em vez de nova linha.
É expandido para:
--line_terminator_null=true
Tags:terminal_output
--order_output=<no, deps, auto or full>
padrão: "auto"-
Exibe os resultados não ordenados (no), ordenados por dependência (deps) ou totalmente ordenados (full). O padrão é "auto", o que significa que os resultados são gerados em ordem de dependência ou totalmente ordenados, dependendo do formatador de saída (em ordem de dependência para proto, minrank, maxrank e gráfico, totalmente ordenado para todos os outros). Quando a saída é totalmente ordenada, os nós são impressos em uma ordem totalmente determinística (total). Primeiro, todos os nós são classificados em ordem alfabética. Em seguida, cada nó na lista é usado como o início de uma pesquisa em profundidade pós-ordem em que as arestas de saída para nós não visitados são percorridas em ordem alfabética dos nós sucessores. Por fim, os nós são impressos na ordem inversa em que foram visitados.
Tags:terminal_output
--order_results
-
Exibe os resultados em ordem de dependência (padrão) ou não ordenada. A saída não ordenada é mais rápida, mas só é compatível quando --output não é minrank, maxrank ou graph.
É expandido para:
--order_output=auto
Tags:terminal_output
--output=<a string>
padrão: "label"-
O formato em que os resultados da consulta precisam ser impressos. Os valores permitidos para a consulta são: build, graph, streamed_jsonproto, label, label_kind, location, maxrank, minrank, package, proto, streamed_proto, xml.
Tags:terminal_output
--output_file=<a string>
padrão: ""-
Quando especificado, os resultados da consulta serão gravados diretamente nesse arquivo, e nada será impresso no stream de saída padrão (stdout) do Bazel. Em comparativos de mercado, isso geralmente é mais rápido do que <code>bazel query > file</code>.
Tags:terminal_output
--[no]proto:default_values
padrão: "true"-
Se verdadeiro, os atributos cujo valor não for especificado explicitamente no arquivo BUILD serão incluídos. Caso contrário, eles serão omitidos. Esta opção é aplicável a --output=proto
Tags:terminal_output
--[no]proto:definition_stack
padrão: "false"-
Preencha o campo proto definition_stack, que registra para cada instância de regra a pilha de chamadas do Starlark no momento em que a classe da regra foi definida.
Tags:terminal_output
--[no]proto:flatten_selects
padrão: "true"-
Se ativado, os atributos configuráveis criados por select() são achatados. Para tipos de lista, a representação simplificada é uma lista que contém cada valor do mapa selecionado exatamente uma vez. Os tipos escalares são achatados para nulos.
Tags:build_file_semantics
--[no]proto:include_attribute_source_aspects
padrão: "false"-
Preencha o campo proto de source_aspect_name de cada atributo com o aspecto de origem de onde o atributo veio (string vazia se não houver).
Tags:terminal_output
--[no]proto:include_starlark_rule_env
padrão: "true"-
Use o ambiente starlark no valor do atributo $internal_attr_hash gerado. Isso garante que a definição da regra do Starlark (e as importações transitivas dela) façam parte desse identificador.
Tags:terminal_output
--[no]proto:include_synthetic_attribute_hash
padrão: "false"-
Define se o atributo $internal_attr_hash será calculado e preenchido.
Tags:terminal_output
--[no]proto:instantiation_stack
padrão: "false"-
Preencha a pilha de chamadas de instanciação de cada regra. Isso requer que a pilha esteja presente
Tags:terminal_output
--[no]proto:locations
padrão: "true"-
Define se as informações de local serão enviadas na saída do proto.
Tags:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
padrão: "all"-
Lista separada por vírgulas de atributos a serem incluídos na saída. O padrão é todos os atributos. Defina como uma string vazia para não gerar nenhum atributo. Essa opção é válida para --output=proto.
Tags:terminal_output
--[no]proto:rule_classes
padrão: "false"-
Preencha o campo rule_class_key de cada regra. Para a primeira regra com uma rule_class_key específica, preencha também o campo rule_class_info proto. O campo rule_class_key identifica exclusivamente uma classe de regras, e o campo rule_class_info é uma definição de API da classe de regras no formato Stardoc.
Tags:terminal_output
--[no]proto:rule_inputs_and_outputs
padrão: "true"-
Define se os campos rule_input e rule_output são preenchidos ou não.
Tags:terminal_output
--query_file=<a string>
padrão: ""-
Se definido, a consulta vai ler a consulta do arquivo nomeado aqui, em vez da linha de comando. É um erro especificar um arquivo aqui e uma consulta de linha de comando.
Tags:changes_inputs
--[no]relative_locations
padrão: "false"-
Se verdadeiro, o local dos arquivos BUILD nas saídas XML e proto será relativo. Por padrão, a saída de localização é um caminho absoluto e não é consistente entre as máquinas. Defina essa opção como "true" para ter um resultado consistente em todas as máquinas.
Tags:terminal_output
--[no]strict_test_suite
padrão: "false"-
Se verdadeiro, a expressão tests() gera um erro se encontrar um test_suite que contém destinos que não são de teste.
Tags:build_file_semantics
,eagerness_to_exit
--[no]tool_deps
padrão: "true"
Consulta - : se desativado, as dependências de "exec configuration" não serão incluídas no gráfico de dependências em que a consulta opera. Uma aresta de dependência de "exec configuration", como a de qualquer regra "proto_library" para o compilador de protocolo, geralmente aponta para uma ferramenta executada durante o build em vez de uma parte do mesmo programa "target".
Cquery: se desativado, filtra todas as metas configuradas que cruzam uma transição de execução do destino de nível superior que descobriu essa meta configurada. Isso significa que, se o destino de nível superior estiver na configuração de destino, apenas os destinos configurados também na configuração de destino serão retornados. Se o destino de nível superior estiver na configuração de execução, apenas os destinos configurados de execução serão retornados. Essa opção NÃO exclui as cadeias de ferramentas resolvidas.
Tags:build_file_semantics
--universe_scope=<comma-separated list of options>
padrão: ""-
Um conjunto de padrões de destino (aditivos e subtrativos) separados por vírgulas. A consulta pode ser realizada no universo definido pela interseção transitiva das metas especificadas. Essa opção é usada para os comandos query e cquery.
Para a cquery, a entrada para essa opção é o alvo em que todas as respostas são criadas. Portanto, essa opção pode afetar as configurações e transições. Se essa opção não for especificada, os destinos de nível superior serão considerados os destinos analisados pela expressão de consulta. Observação: para cquery, não especificar essa opção pode causar a interrupção do build se os destinos analisados pela expressão de consulta não puderem ser criados com opções de nível superior.
Tags:loading_and_analysis
--[no]xml:default_values
padrão: "false"-
Se verdadeiro, os atributos de regra cujo valor não for especificado explicitamente no arquivo BUILD serão impressos. Caso contrário, eles serão omitidos.
Tags:terminal_output
--[no]xml:line_numbers
padrão: "true"-
Se verdadeiro, a saída em XML contém números de linha. Desativar essa opção pode facilitar a leitura das diferenças. Essa opção é válida apenas para --output=xml.
Tags:terminal_output
- Opções que afetam a verbosidade, o formato ou o local de registro:
--experimental_repository_resolved_file=<a string>
padrão: ""-
Se não estiver vazio, grave um valor do Starlark com as informações resolvidas de todas as regras do repositório do Starlark que foram executadas.
Tags:affects_outputs
- Opções diversas, não categorizadas.:
- Vários usos de
--deleted_packages=<comma-separated list of package names>
são acumulados - Uma lista separada por vírgulas de nomes de pacotes que o sistema de build vai considerar inexistentes, mesmo que estejam visíveis em algum lugar no caminho do pacote. Use essa opção ao excluir um subpacote "x/y" de um pacote "x" existente. Por exemplo, depois de excluir x/y/BUILD no cliente, o sistema de build pode reclamar se encontrar um rótulo '//x:y/z', caso ele ainda seja fornecido por outra entrada de package_path. Especificar --deleted_packages x/y evita esse problema.
--[no]fetch
padrão: "true"- Permite que o comando busque dependências externas. Se definido como "false", o comando vai usar qualquer versão em cache da dependência. Se nenhuma existir, o comando vai resultar em falha.
--package_path=<colon-separated list of options>
padrão: "%workspace%"- Uma lista separada por dois-pontos de onde procurar pacotes. Os elementos que começam com "%workspace%" são relativos ao espaço de trabalho que os contém. Se omitido ou vazio, o padrão é a saída de "bazel info default-package-path".
--[no]show_loading_progress
padrão: "true"- Se ativado, faz com que o Bazel imprima mensagens "Carregando pacote:".
Opções de execução
Herda todas as opções de build.
- Opções que aparecem antes do comando e são analisadas pelo cliente:
--[no]portable_paths
padrão: "false"-
Se verdadeiro, inclui caminhos para substituir em ExecRequest para tornar os caminhos resultantes portáteis.
Tags:affects_outputs
--[no]run
padrão: "true"-
Se for falso, pule a execução da linha de comando construída para o destino criado. Essa flag é ignorada para todos os builds --script_path.
Tags:affects_outputs
- Vários usos de
--run_env=<a 'name=value' assignment with an optional value part>
são acumulados -
Especifica o conjunto de variáveis de ambiente disponível para ações com configuração de destino. As variáveis podem ser especificadas por nome, caso em que o valor será retirado do ambiente de invocação, ou pelo par name=value, que define o valor independente do ambiente de invocação. Essa opção pode ser usada várias vezes. Para opções fornecidas para a mesma variável, as mais recentes vencem, e as opções para variáveis diferentes são acumuladas.
Tags:affects_outputs
- Opções que permitem ao usuário configurar a saída pretendida, afetando o valor, em vez da existência:
--script_path=<a path>
padrão: consulte a descrição-
Se definido, grava um script de shell no arquivo especificado que invoca o destino. Se essa opção estiver definida, o destino não será executado pelo bazel. Use "bazel run --script_path=foo //foo && ./foo" para invocar o destino "//foo". Isso é diferente de "bazel run //foo", porque o bloqueio do Bazel é liberado e o executável é conectado ao stdin do terminal.
Tags:affects_outputs
,execution
- Essa opção afeta a semântica do idioma Starlark ou a API de build acessível a arquivos BUILD, .bzl ou WORKSPACE.:
--[no]incompatible_use_plus_in_repo_names
padrão: "true"-
No-op.
Tags:loading_and_analysis
Opções de desligamento
- Opções que controlam a saída do comando:
--iff_heap_size_greater_than=<an integer>
padrão: "0"-
Se não for igual a zero, o encerramento só será feito se a memória total (em MB) consumida pela JVM exceder esse valor.
Tags:loses_incremental_state
,eagerness_to_exit
- Essa opção afeta a semântica do idioma Starlark ou a API de build acessível a arquivos BUILD, .bzl ou WORKSPACE.:
--[no]incompatible_use_plus_in_repo_names
padrão: "true"-
No-op.
Tags:loading_and_analysis
Opções de sincronização
- Opções que controlam a execução do build:
--[no]configure
padrão: "False"-
Apenas repositórios de sincronização marcados como "configurar" para fins de configuração do sistema.
Tags:changes_inputs
--[no]keep_going
[-k
] padrão: "false"-
Continue o máximo possível após um erro. Embora a meta que falhou e as que dependem dela não possam ser analisadas, outros pré-requisitos dessas metas podem ser.
Tags: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">
padrão: "auto"-
Número de linhas de execução paralelas a serem usadas na fase de carregamento/análise.Recebe um número inteiro ou uma palavra-chave ("auto", "HOST_CPUS", "HOST_RAM"), seguida opcionalmente por uma operação ([-|*]<float>), por exemplo. "auto", "HOST_CPUS*.5". "auto" define um padrão razoável com base nos recursos do host. Precisa ser pelo menos 1.
Tags:bazel_internal_configuration
- Vários usos de
--only=<a string>
são acumulados -
Se essa opção for fornecida, apenas os repositórios especificados com ela serão sincronizados. Ainda considera todos (ou todos os semelhantes a configure, de --configure) desatualizados.
Tags:changes_inputs
- Essa opção afeta a semântica da linguagem Starlark ou a API de build acessível a arquivos BUILD, .bzl ou WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility
padrão: "false"-
Se incompatible_enforce_config_setting_visibility=false, isso é um noop. Caso contrário, se essa flag for falsa, qualquer config_setting sem um atributo de visibilidade explícito será //visibility:public. Se essa flag for verdadeira, a config_setting vai seguir a mesma lógica de visibilidade de todas as outras regras. Consulte https://github.com/bazelbuild/bazel/issues/12933.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
padrão: "true"-
Se verdadeiro, aplique as restrições de visibilidade de config_setting. Se for falso, cada config_setting será visível para cada destino. Consulte https://github.com/bazelbuild/bazel/issues/12932.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_use_plus_in_repo_names
padrão: "true"-
Sem operação.
Tags:loading_and_analysis
- Opções que afetam a quantidade de detalhes, o formato ou o local do registro:
--experimental_repository_resolved_file=<a string>
padrão: ""-
Se não estiver vazio, grave um valor do Starlark com as informações resolvidas de todas as regras do repositório do Starlark que foram executadas.
Tags:affects_outputs
- Opções diversas, não categorizadas.:
- Vários usos de
--deleted_packages=<comma-separated list of package names>
são acumulados - Uma lista separada por vírgulas de nomes de pacotes que o sistema de build vai considerar inexistentes, mesmo que estejam visíveis em algum lugar no caminho do pacote. Use essa opção ao excluir um subpacote "x/y" de um pacote "x" existente. Por exemplo, depois de excluir x/y/BUILD no cliente, o sistema de build pode reclamar se encontrar um rótulo '//x:y/z', caso ele ainda seja fornecido por outra entrada de package_path. Especificar --deleted_packages x/y evita esse problema.
--[no]fetch
padrão: "true"- Permite que o comando busque dependências externas. Se definido como "false", o comando vai usar qualquer versão em cache da dependência. Se nenhuma existir, o comando vai resultar em falha.
--package_path=<colon-separated list of options>
padrão: "%workspace%"- Uma lista separada por dois-pontos de onde procurar pacotes. Os elementos que começam com "%workspace%" são relativos ao espaço de trabalho que os contém. Se omitido ou vazio, o padrão é a saída de "bazel info default-package-path".
--[no]show_loading_progress
padrão: "true"- Se ativado, faz com que o Bazel imprima mensagens "Carregando pacote:".
Opções de teste
Herda todas as opções de build.
- Essa opção afeta a semântica da linguagem Starlark ou a API de build acessível a arquivos BUILD, .bzl ou WORKSPACE.:
--[no]incompatible_use_plus_in_repo_names
padrão: "true"-
Sem operação.
Tags:loading_and_analysis
- Opções que afetam a quantidade de detalhes, o formato ou o local do registro:
--[no]print_relative_test_log_paths
padrão: "false"-
Se verdadeiro, ao imprimir o caminho para um registro de teste, use o caminho relativo que usa o link simbólico de conveniência "testlogs". Observação: uma invocação subsequente de "build"/"test"/etc com uma configuração diferente pode fazer com que o destino desse link simbólico mude, fazendo com que o caminho impresso anteriormente não seja mais útil.
Tags:affects_outputs
--[no]test_verbose_timeout_warnings
padrão: "false"-
Se verdadeiro, mostra avisos adicionais quando o tempo de execução real do teste não corresponde ao tempo limite definido pelo teste (implícito ou explícito).
Tags:affects_outputs
--[no]verbose_test_summary
padrão: "true"-
Se verdadeiro, mostra informações adicionais (tempo, número de execuções com falha etc.) no resumo do teste.
Tags:affects_outputs
Opções do fornecedor
Herda todas as opções de test.
- Opções que controlam a execução do build:
--[no]keep_going
[-k
] padrão: "false"-
Continue o máximo possível após um erro. Embora a meta que falhou e as que dependem dela não possam ser analisadas, outros pré-requisitos dessas metas podem ser.
Tags: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">
padrão: "auto"-
Número de linhas de execução paralelas a serem usadas na fase de carregamento/análise.Recebe um número inteiro ou uma palavra-chave ("auto", "HOST_CPUS", "HOST_RAM"), seguida opcionalmente por uma operação ([-|*]<float>), por exemplo. "auto", "HOST_CPUS*.5". "auto" define um padrão razoável com base nos recursos do host. Precisa ser pelo menos 1.
Tags:bazel_internal_configuration
- Essa opção afeta a semântica da linguagem Starlark ou a API de build acessível a arquivos BUILD, .bzl ou WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility
padrão: "false"-
Se incompatible_enforce_config_setting_visibility=false, isso é um noop. Caso contrário, se essa flag for falsa, qualquer config_setting sem um atributo de visibilidade explícito será //visibility:public. Se essa flag for verdadeira, a config_setting vai seguir a mesma lógica de visibilidade de todas as outras regras. Consulte https://github.com/bazelbuild/bazel/issues/12933.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
padrão: "true"-
Se verdadeiro, aplique as restrições de visibilidade de config_setting. Se for falso, cada config_setting será visível para cada destino. Consulte https://github.com/bazelbuild/bazel/issues/12932.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_use_plus_in_repo_names
padrão: "true"-
No-op.
Tags:loading_and_analysis
- Opções relacionadas à saída e semântica do Bzlmod:
- Vários usos de
--repo=<a string>
são acumulados -
Somente fornecedores do repositório especificado, que pode ser "@apparent_repo_name" ou "@@canonical_repo_name". Essa opção pode ser definida várias vezes
Tags:changes_inputs
- Opções diversas, não categorizadas de outra forma.:
- Vários usos de
--deleted_packages=<comma-separated list of package names>
são acumulados - Uma lista separada por vírgulas de nomes de pacotes que o sistema de build vai considerar inexistentes, mesmo que estejam visíveis em algum lugar no caminho do pacote. Use essa opção ao excluir um subpacote "x/y" de um pacote "x" existente. Por exemplo, depois de excluir x/y/BUILD no cliente, o sistema de build pode reclamar se encontrar um rótulo '//x:y/z', caso ele ainda seja fornecido por outra entrada de package_path. Especificar --deleted_packages x/y evita esse problema.
--[no]fetch
padrão: "true"- Permite que o comando busque dependências externas. Se definido como "false", o comando vai usar qualquer versão em cache da dependência. Se nenhuma existir, o comando vai resultar em falha.
--package_path=<colon-separated list of options>
padrão: "%workspace%"- Uma lista separada por dois-pontos de onde procurar pacotes. Os elementos que começam com "%workspace%" são relativos ao espaço de trabalho que os contém. Se omitido ou vazio, o padrão é a saída de "bazel info default-package-path".
--[no]show_loading_progress
padrão: "true"- Se ativado, faz com que o Bazel imprima mensagens "Carregando pacote:".
- Opções que controlam a execução do build:
--[no]experimental_inprocess_symlink_creation
padrão: "true"-
Define se é possível fazer chamadas diretas do sistema de arquivos para criar árvores de links simbólicos em vez de delegar a um processo auxiliar.
Tags:loading_and_analysis
,execution
,experimental
--[no]experimental_persistent_aar_extractor
padrão: "false"-
Ative o extrator de aar persistente usando workers.
Tags:execution
,experimental
--[no]experimental_remotable_source_manifests
padrão: "false"-
Define se as ações de manifesto de origem podem ser remotas
Tags:loading_and_analysis
,execution
,experimental
--[no]experimental_split_coverage_postprocessing
padrão: "false"-
Se verdadeiro, o Bazel vai executar o pós-processamento de cobertura para teste em uma nova geração.
Tags:execution
,experimental
--[no]experimental_strict_fileset_output
padrão: "false"-
Se essa opção estiver ativada, os conjuntos de arquivos vão tratar todos os artefatos de saída como arquivos comuns. Eles não atravessam diretórios nem são sensíveis a links simbólicos.
Tags:execution
,experimental
--[no]incompatible_modify_execution_info_additive
padrão: "false"-
Quando ativada, a transmissão de várias flags --modify_execution_info é aditiva. Quando desativado, apenas a última flag é considerada.
Tags:execution
,affects_outputs
,loading_and_analysis
,incompatible_change
- Vários usos de
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
são acumulados -
Adiciona ou remove chaves das informações de execução de uma ação com base na mnemônica da ação. Aplicável apenas a ações que oferecem suporte a informações de execução. Muitas ações comuns oferecem suporte a informações de execução, por exemplo, Genrule, CppCompile, Javac, StarlarkAction e TestRunner. Ao especificar vários valores, a ordem é importante, porque muitas expressões regulares podem ser aplicadas ao mesmo mnemônico.
Sintaxe: "regex=[+-]chave,regex=[+-]chave,...".
Exemplos:
'.*=+x,.*=-y,.*=+z' adiciona "x" e "z" e remove "y" das informações de execução de todas as ações.
"Genrule=+requires-x" adiciona "requires-x" às informações de execução de todas as ações de Genrule.
'(?!Genrule).*=-requires-x' remove 'requires-x' das informações de execução de todas as ações que não são Genrule.
Tags:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Ative ações persistentes de dex e desugar do Android usando workers.
É expandido para:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Tags:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
-
Ative o processador de recursos Android persistente usando workers.
Expande para:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
--strategy=ProcessDatabinding=worker
--strategy=GenerateDataBindingBaseClasses=worker
Tags:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_dex_desugar
-
Ative ações persistentes de dex e desugar Android multiplexadas usando workers.
Expande para:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
Tags:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
Ative o processador de recursos Android multiplexado permanente usando workers.
Expande para:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
Tags:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_tools
-
Ative ferramentas Android persistentes e multiplexadas (dexing, desugaring, processamento de recursos).
É expandido para:
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Tags:host_machine_resource_optimizations
,execution
--[no]use_target_platform_for_tests
padrão: "false"-
Se verdadeiro, o Bazel vai usar a plataforma de destino para executar testes em vez do grupo de execução de teste.
Tags
:execution
- Opções que configuram a cadeia de ferramentas usada para a execução de ações:
--android_compiler=<a string>
padrão: consulte a descrição-
O compilador de destino do Android.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
padrão: "android"-
Seleciona a combinação de manifesto a ser usada para regras android_binary. Flag para ajudar na transição para a combinação de manifestos do Android da combinação legada.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_platforms=<a build target label>
padrão: ""-
Define as plataformas que os destinos android_binary usam. Se várias plataformas forem especificadas, o binário será um APK grande, que contém binários nativos para cada plataforma de destino especificada.
Tags:changes_inputs
,loading_and_analysis
,loses_incremental_state
--apple_crosstool_top=<a build target label>
padrão: "@bazel_tools//tools/cpp:toolchain"-
O rótulo do pacote de ferramentas cruzadas a ser usado nas regras da Apple e do Objc e nas dependências deles.
Tags:loses_incremental_state
,changes_inputs
--cc_output_directory_tag=<a string>
padrão: ""-
Especifica um sufixo a ser adicionado ao diretório de configuração.
Tags:affects_outputs
--compiler=<a string>
padrão: consulte a descrição-
O compilador C++ a ser usado para compilar o destino.
Tags:loading_and_analysis
,execution
--coverage_output_generator=<a build target label>
padrão: "@bazel_tools//tools/test:lcov_merger"-
Local do binário usado para pós-processar relatórios de cobertura brutos. No momento, ele precisa ser um grupo de arquivos que contém um único arquivo, o binário. O padrão é "//tools/test:lcov_merger".
Tags:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
padrão: "@bazel_tools//tools/test:coverage_report_generator"-
Local do binário usado para gerar relatórios de cobertura. No momento, ele precisa ser um grupo de arquivos que contém um único arquivo, o binário. O padrão é "//tools/test:coverage_report_generator".
Tags:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
padrão: "@bazel_tools//tools/test:coverage_support"-
Local dos arquivos de suporte necessários nas entradas de cada ação de teste que coleta a cobertura do código. O padrão é "//tools/test:coverage_support".
Tags:changes_inputs
,affects_outputs
,loading_and_analysis
--custom_malloc=<a build target label>
padrão: consulte a descrição-
Especifica uma implementação personalizada de malloc. Essa configuração substitui os atributos malloc nas regras de build.
Tags:changes_inputs
,affects_outputs
- Vários usos de
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
são acumulados -
Lista de expressões regulares separadas por vírgulas, cada uma opcionalmente prefixada por - (expressão negativa), atribuída a (=) a uma lista de destinos de valor de restrição separados por vírgulas. Se um destino corresponder a nenhuma expressão negativa e a pelo menos uma expressão positiva, a resolução da cadeia de ferramentas será realizada como se tivesse declarado os valores de restrição como restrições de execução. Exemplo: //demo,-test=@platforms//cpus:x86_64 vai adicionar "x86_64" a qualquer destino em //demo, exceto aqueles cujo nome contém "test".
Tags:loading_and_analysis
--[no]experimental_include_xcode_execution_requirements
padrão: "false"-
Se definido, adicione um requisito de execução "requires-xcode:{version}" a cada ação do Xcode. Se a versão do Xcode tiver um rótulo com hífen, adicione também um requisito de execução "requires-xcode-label:{version_label}".
Tags:loses_incremental_state
,loading_and_analysis
,execution
,experimental
--[no]experimental_prefer_mutual_xcode
padrão: "true"-
Se verdadeiro, use o Xcode mais recente disponível local e remotamente. Se for falso ou se não houver versões disponíveis em comum, use a versão local do Xcode selecionada pelo xcode-select.
Tags:loses_incremental_state
,experimental
--extra_execution_platforms=<comma-separated list of options>
padrão: ""-
As plataformas de execução disponíveis para executar ações. As plataformas podem ser especificadas por destino exato ou como um padrão de destino. Essas plataformas serão consideradas antes daquelas declaradas no arquivo WORKSPACE por register_execution_platforms(). Essa opção só pode ser definida uma vez. As instâncias posteriores vão substituir as configurações de sinalizações anteriores.
Tags:execution
- Vários usos de
--extra_toolchains=<comma-separated list of options>
são acumulados -
As regras do conjunto de ferramentas que serão consideradas durante a resolução do conjunto de ferramentas. As cadeias de ferramentas podem ser especificadas por destino exato ou como um padrão de destino. Esses conjuntos de ferramentas serão considerados antes dos declarados no arquivo WORKSPACE por register_toolchains().
Tags:affects_outputs
,changes_inputs
,loading_and_analysis
--grte_top=<a label>
padrão: consulte a descrição-
Um rótulo para uma biblioteca libc registrada. O valor padrão é selecionado pela cadeia de ferramentas de crosstool, e você quase nunca precisa substituí-lo.
Tags:action_command_lines
,affects_outputs
--host_compiler=<a string>
padrão: consulte a descrição-
Flag de no-op. Será removido em uma versão futura.
Tags:loading_and_analysis
,execution
--host_grte_top=<a label>
padrão: consulte a descrição-
Se especificado, essa configuração substitui o diretório de nível superior libc (--grte_top) para a configuração de execução.
Tags:action_command_lines
,affects_outputs
--host_platform=<a build target label>
padrão: "@bazel_tools//tools:host_platform"-
O rótulo de uma regra de plataforma que descreve o sistema de host.
Tags:affects_outputs
,changes_inputs
,loading_and_analysis
--[no]incompatible_bazel_test_exec_run_under
padrão: "false"-
Se ativado, "bazel test --run_under=//:runner" cria "//:runner" na configuração de execução. Se desativado, ele cria "//:runner" na configuração de destino. O Bazel executa testes em máquinas de execução, portanto, o primeiro é mais correto. Isso não afeta o "bazel run", que sempre gera "`--run_under=//foo" na configuração de destino.
Tags:affects_outputs
,incompatible_change
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
padrão: "true"-
Se verdadeiro, o Bazel não vai ativar os recursos "host" e "nonhost" na cadeia de ferramentas C++. Consulte https://github.com/bazelbuild/bazel/issues/7407 para mais informações.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_apple_toolchain_resolution
padrão: "false"-
Use a resolução do toolchain para selecionar o SDK da Apple para regras da Apple (Starlark e nativa)
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_legacy_whole_archive
padrão: "true"-
Se verdadeiro, o Bazel não vai vincular as dependências de biblioteca como um arquivo completo por padrão (consulte https://github.com/bazelbuild/bazel/issues/7362 para instruções de migração).
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_strip_executable_safely
padrão: "false"-
Se verdadeiro, a ação de remoção para executáveis vai usar a flag -x, que não interrompe a resolução de símbolos dinâmicos.
Tags:action_command_lines
,incompatible_change
-
Use objetos compartilhados de interface se o conjunto de ferramentas oferecer suporte a eles. Todas as cadeias de ferramentas ELF atualmente oferecem suporte a essa configuração.
Tags:loading_and_analysis
,affects_outputs
,affects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
Especifica a versão do SDK para iOS a ser usada para criar aplicativos iOS. Se não for especificado, vai usar a versão padrão do SDK para iOS de "xcode_version".
Tags:loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
Especifica a versão do SDK do macOS a ser usada para criar aplicativos do macOS. Se não for especificado, vai usar a versão padrão do SDK do macOS de "xcode_version".
Tags:loses_incremental_state
--minimum_os_version=<a string>
padrão: consulte a descrição-
A versão mínima do SO para a qual a compilação é direcionada.
Tags:loading_and_analysis
,affects_outputs
--platform_mappings=<a main workspace-relative path>
padrão: ""-
O local de um arquivo de mapeamento que descreve qual plataforma usar se nenhuma estiver definida ou quais flags definir quando uma plataforma já existir. Precisa ser relativo à raiz do espaço de trabalho principal. O padrão é "platform_mappings" (um arquivo diretamente na raiz do espaço de trabalho).
Tags:affects_outputs
,changes_inputs
,loading_and_analysis
,immutable
--platforms=<a build target label>
padrão: ""-
Os rótulos das regras da plataforma que descrevem as plataformas de destino do comando atual.
Tags:affects_outputs
,changes_inputs
,loading_and_analysis
--python_path=<a string>
padrão: consulte a descrição-
O caminho absoluto do interpretador de Python invocado para executar destinos do Python na plataforma de destino. Obsoleto. Desativado por --incompatible_use_python_toolchains.
Tags:loading_and_analysis
,affects_outputs
--python_top=<a build target label>
padrão: consulte a descrição-
O identificador de um py_runtime que representa o interpretador de Python invocado para executar destinos do Python na plataforma de destino. Obsoleto. Desativado por --incompatible_use_python_toolchains.
Tags:loading_and_analysis
,affects_outputs
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
Especifica a versão do SDK do tvOS a ser usada para criar aplicativos para tvOS. Se não for especificado, vai usar a versão padrão do SDK para tvOS de "xcode_version".
Tags:loses_incremental_state
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
Especifica a versão do SDK do watchOS a ser usada para criar aplicativos do watchOS. Se não for especificado, vai usar a versão padrão do SDK do watchOS de "xcode_version".
Tags:loses_incremental_state
--xcode_version=<a string>
padrão: consulte a descrição-
Se especificado, usa o Xcode da versão especificada para ações de build relevantes. Se não for especificado, vai usar a versão padrão do executor do Xcode.
Tags:loses_incremental_state
--xcode_version_config=<a build target label>
padrão: "@bazel_tools//tools/cpp:host_xcodes"-
O rótulo da regra xcode_config a ser usado para selecionar a versão do Xcode na configuração do build.
Tags
:loses_incremental_state
,loading_and_analysis
- Opções que controlam a saída do comando:
--[no]apple_generate_dsym
padrão: "false"-
Define se é necessário gerar arquivos de símbolo de depuração (.dSYM).
Tags:affects_outputs
,action_command_lines
--[no]build_runfile_links
padrão: "true"-
Se verdadeiro, cria florestas de links simbólicos de arquivos de execução para todos os destinos. Se for falso, grave-os somente quando for necessário por uma ação local, um comando de teste ou de execução.
Tags:affects_outputs
--[no]build_runfile_manifests
padrão: "true"-
Se verdadeiro, grava manifestos de runfiles para todos os destinos. Se for falso, omita-os. Os testes locais não serão executados quando for falso.
Tags:affects_outputs
--[no]build_test_dwp
padrão: "false"-
Se ativado, ao criar testes C++ de forma estática e com fissão, o arquivo .dwp do binário de teste também será criado automaticamente.
Tags:loading_and_analysis
,affects_outputs
--cc_proto_library_header_suffixes=<comma-separated set of options>
padrão: ".pb.h"-
Define os sufixos dos arquivos de cabeçalho que uma cc_proto_library cria.
Tags:affects_outputs
,loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated set of options>
padrão: ".pb.cc"-
Define os sufixos dos arquivos de origem que uma cc_proto_library cria.
Tags:affects_outputs
,loading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info
padrão: "false"-
Execute ações extras para versões alternativas de API Java em uma proto_library.
Tags:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_save_feature_state
padrão: "false"-
Salve o estado dos recursos ativados e solicitados como uma saída da compilação.
Tags:affects_outputs
,experimental
--fission=<a set of compilation modes>
padrão: "no"-
Especifica quais modos de compilação usam a divisão para compilações e links em C++. Pode ser qualquer combinação de {'fastbuild', 'dbg', 'opt'} ou os valores especiais 'yes' para ativar todos os modos e 'no' para desativar todos os modos.
Tags:loading_and_analysis
,action_command_lines
,affects_outputs
--[no]incompatible_always_include_files_in_data
padrão: "true"-
Se verdadeiro, as regras nativas adicionam <code>DefaultInfo.files</code> de dependências de dados aos runfiles, o que corresponde ao comportamento recomendado para regras do Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid).
Tags:affects_outputs
,incompatible_change
--[no]legacy_external_runfiles
padrão: "false"-
Se verdadeiro, crie florestas de links simbólicos de arquivos de execução para repositórios externos em .runfiles/wsname/external/repo (além de .runfiles/repo).
Tags:affects_outputs
--[no]objc_generate_linkmap
padrão: "false"-
Especifica se um arquivo de linkmap será gerado.
Tags:affects_outputs
--[no]save_temps
padrão: "false"-
Se definido, as saídas temporárias do gcc serão salvas. Isso inclui arquivos .s (código do assembler), .i (C pré-processado) e .ii (C++ pré-processado).
Tags
:affects_outputs
- Opções que permitem ao usuário configurar a saída pretendida, afetando o valor, em vez de sua existência:
- Vários usos de
--action_env=<a 'name=value' assignment with an optional value part>
são acumulados -
Especifica o conjunto de variáveis de ambiente disponível para ações com configuração de destino. As variáveis podem ser especificadas por nome, e nesse caso o valor é retirado do ambiente de invocação, ou pelo par name=value, que define o valor independente do ambiente de invocação. Essa opção pode ser usada várias vezes. Para opções fornecidas para a mesma variável, as mais recentes vencem, e as opções para variáveis diferentes são acumuladas.
Tags:action_command_lines
--allowed_cpu_values=<comma-separated set of options>
padrão: ""-
Valores permitidos para a flag --cpu.
Tags:changes_inputs
,affects_outputs
--[no]android_databinding_use_androidx
padrão: "true"-
Gera arquivos de vinculação de dados compatíveis com o AndroidX. É usado apenas com a vinculação de dados v2. Essa flag não tem efeito.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]android_databinding_use_v3_4_args
padrão: "true"-
Use o Databinding v2 do Android com o argumento 3.4.0. Essa flag não tem efeito.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--android_dynamic_mode=<off, default or fully>
padrão: "desativado"-
Determina se as dependências C++ das regras do Android serão vinculadas dinamicamente quando um cc_binary não criar explicitamente uma biblioteca compartilhada. "default" significa que o Bazel vai escolher se vai vincular dinamicamente. "totalmente" significa que todas as bibliotecas serão vinculadas dinamicamente. "off" significa que todas as bibliotecas serão vinculadas no modo quase estático.
Tags:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
padrão: "alphabetical"-
Define a ordem dos manifestos transmitidos para a combinação de manifestos para binários do Android. ALPHABETICAL significa que os manifestos são classificados por caminho em relação ao execroot. ALPHABETICAL_BY_CONFIGURATION significa que os manifestos são classificados por caminhos relativos ao diretório de configuração no diretório de saída. DEPENDENCY significa que os manifestos são ordenados com o manifesto de cada biblioteca antes dos manifestos das dependências.
Tags:action_command_lines
,execution
--[no]android_resource_shrinking
padrão: "false"-
Ativa a redução de recursos para APKs android_binary que usam o ProGuard.
Tags:affects_outputs
,loading_and_analysis
--[no]build_python_zip
padrão: "auto"-
Criar um zip executável do Python; ativado no Windows, desativado em outras plataformas
Tags:affects_outputs
- Vários usos de
--catalyst_cpus=<comma-separated list of options>
são acumulados -
Lista separada por vírgulas de arquiteturas para as quais criar binários do Apple Catalyst.
Tags:loses_incremental_state
,loading_and_analysis
--[no]collect_code_coverage
padrão: "false"-
Se especificado, o Bazel vai instrumentar o código (usando a instrumentação off-line sempre que possível) e coletar informações de cobertura durante os testes. Somente os destinos que correspondem a --instrumentation_filter serão afetados. Normalmente, essa opção não precisa ser especificada diretamente. Em vez disso, use o comando "bazel coverage".
Tags:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] padrão: "fastbuild"-
Especifica o modo em que o binário será criado. Valores: "fastbuild", "dbg", "opt".
Tags:affects_outputs
,action_command_lines
- Vários usos de
--conlyopt=<a string>
são acumulados -
Opção adicional para transmitir ao gcc ao compilar arquivos de origem C.
Tags:action_command_lines
,affects_outputs
- Vários usos de
--copt=<a string>
são acumulados -
Opções adicionais para transmitir ao gcc.
Tags:action_command_lines
,affects_outputs
--cpu=<a string>
padrão: ""-
A CPU de destino.
Tags:changes_inputs
,affects_outputs
--cs_fdo_absolute_path=<a string>
padrão: consulte a descrição-
Use as informações do perfil do CSFDO para otimizar a compilação. Especifique o nome do caminho absoluto do arquivo ZIP que contém o arquivo de perfil, um arquivo de perfil LLVM bruto ou indexado.
Tags:affects_outputs
--cs_fdo_instrument=<a string>
padrão: consulte a descrição-
Gera binários com instrumentação FDO sensível ao contexto. Com o compilador Clang/LLVM, ele também aceita o nome do diretório em que os arquivos de perfil brutos serão armazenados em disco no momento da execução.
Tags:affects_outputs
--cs_fdo_profile=<a build target label>
padrão: consulte a descrição-
O cs_fdo_profile representa o perfil sensível ao contexto a ser usado para otimização.
Tags:affects_outputs
- Vários usos de
--cxxopt=<a string>
são acumulados -
Opção extra para transmitir ao gcc ao compilar arquivos-fonte C++.
Tags:action_command_lines
,affects_outputs
- Vários usos de
--define=<a 'name=value' assignment>
são acumulados -
Cada opção --define especifica uma atribuição para uma variável de build. No caso de vários valores para uma variável, o último é o vencedor.
Tags:changes_inputs
,affects_outputs
--dynamic_mode=<off, default or fully>
padrão: "default"-
Determina se os binários C++ serão vinculados de forma dinâmica. "default" significa que o Bazel vai escolher se vai vincular dinamicamente. "totalmente" significa que todas as bibliotecas serão vinculadas dinamicamente. "off" significa que todas as bibliotecas serão vinculadas no modo quase estático.
Tags:loading_and_analysis
,affects_outputs
--[no]enable_propeller_optimize_absolute_paths
padrão: "true"-
Se definido, qualquer uso de caminhos absolutos para o propeller optimize vai gerar um erro.
Tags:affects_outputs
--[no]enable_remaining_fdo_absolute_paths
padrão: "true"-
Se definido, qualquer uso de caminhos absolutos para FDO vai gerar um erro.
Tags:affects_outputs
--[no]enable_runfiles
padrão: "auto"-
Ative a árvore de links simbólicos de runfiles. Por padrão, ela fica desativada no Windows e ativada em outras plataformas.
Tags de
:affects_outputs
- Vários usos de
--experimental_action_listener=<a build target label>
são acumulados -
foi descontinuado em favor de aspectos. Use action_listener para anexar uma extra_action às ações de build atuais.
Tags:execution
,experimental
--[no]experimental_android_compress_java_resources
padrão: "false"-
Compactar recursos Java em APKs
Tags:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_android_databinding_v2
padrão: "true"-
Use o Databinding v2 do Android. Essa flag não tem efeito.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_android_resource_shrinking
padrão: "false"-
Ativa a redução de recursos para APKs android_binary que usam o ProGuard.
Tags:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_android_rewrite_dexes_with_rex
padrão: "false"-
use a ferramenta rex para reescrever arquivos dex
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_collect_code_coverage_for_generated_files
padrão: "false"-
Se especificado, o Bazel também vai gerar informações de cobertura de coleta para arquivos gerados.
Tags:affects_outputs
,experimental
--experimental_objc_fastbuild_options=<comma-separated list of options>
padrão: "-O0,-DDEBUG=1"-
Usa essas strings como opções de compilador de build rápido do objc.
Tags:action_command_lines
--[no]experimental_omitfp
padrão: "false"-
Se verdadeiro, use libunwind para desfazer a pilha e compile com -fomit-frame-pointer e -fasynchronous-unwind-tables.
Tags:action_command_lines
,affects_outputs
,experimental
--experimental_output_paths=<off, content or strip>
padrão: "desativado"-
Qual modelo usar para onde as regras da árvore de saídas gravam as saídas, principalmente para builds multiplataforma / multiconfiguração. Esse recurso é altamente experimental. Consulte https://github.com/bazelbuild/bazel/issues/6526 para saber mais. As ações do Starlark podem optar pelo mapeamento de caminho adicionando a chave "supports-path-mapping" ao dicionário "execution_requirements".
Tags:loses_incremental_state
,bazel_internal_configuration
,affects_outputs
,execution
- Vários usos de
--experimental_override_name_platform_in_output_dir=<a 'label=value' assignment>
são acumulados -
Cada entrada precisa estar no formato rótulo=valor, em que "rótulo" se refere a uma plataforma e "valor" é o nome abreviado desejado para usar no caminho de saída. Só é usado quando --experimental_platform_in_output_dir é verdadeiro. Tem a maior prioridade de nomenclatura.
Tags:affects_outputs
,experimental
--[no]experimental_platform_in_output_dir
padrão: "false"-
Se verdadeiro, um nome abreviado para a plataforma de destino é usado no nome do diretório de saída em vez da CPU. O esquema exato é experimental e sujeito a mudanças: primeiro, no caso raro em que a opção --platforms não tem exatamente um valor, um hash da opção platforms é usado. Em seguida, se algum nome abreviado para a plataforma atual tiver sido registrado por --experimental_override_name_platform_in_output_dir, esse nome abreviado será usado. Em seguida, se --experimental_use_platforms_in_output_dir_legacy_heuristic estiver definido, use um nome abreviado com base no rótulo da plataforma atual. Por fim, um hash da opção de plataforma é usado como último recurso.
Tags:affects_outputs
,experimental
--[no]experimental_py_binaries_include_label
padrão: "false"-
Os destinos py_binary incluem o rótulo mesmo quando a marcação está desativada.
Tags:affects_outputs
,experimental
--[no]experimental_use_llvm_covmap
padrão: "false"-
Se especificado, o Bazel vai gerar informações do mapa de cobertura llvm-cov em vez de gcov quando o collect_code_coverage estiver ativado.
Tags:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic
padrão: "true"-
Use essa flag apenas como parte de uma estratégia de migração ou teste sugerida. A heurística tem deficiências conhecidas, e é recomendável migrar para usar apenas --experimental_override_name_platform_in_output_dir.
Tags:affects_outputs
,experimental
--fdo_instrument=<a string>
padrão: consulte a descrição-
Gera binários com instrumentação FDO. Com o compilador Clang/LLVM, ele também aceita o nome do diretório em que os arquivos de perfil brutos serão armazenados em disco no momento da execução.
Tags:affects_outputs
--fdo_optimize=<a string>
padrão: consulte a descrição-
Use informações do perfil de FDO para otimizar a compilação. Especifique o nome de um arquivo ZIP que contém uma árvore de arquivos .gcda, um arquivo afdo com um perfil automático ou um arquivo de perfil LLVM. Essa flag também aceita arquivos especificados como rótulos (por exemplo, "//foo/bar:file.afdo". Talvez seja necessário adicionar uma diretiva "exports_files" ao pacote correspondente) e rótulos que apontam para destinos "fdo_profile". Essa flag será substituída pela regra "fdo_profile".
Tags:affects_outputs
--fdo_prefetch_hints=<a build target label>
padrão: consulte a descrição-
Use dicas de pré-busca de cache.
Tags:affects_outputs
--fdo_profile=<a build target label>
padrão: consulte a descrição-
O fdo_profile que representa o perfil a ser usado para otimização.
Tags:affects_outputs
- Vários usos de
--features=<a string>
são acumulados -
Os recursos serão ativados ou desativados por padrão para destinos criados na configuração de destino. Especificar -<feature> desativa o recurso. Os recursos negativos sempre substituem os positivos. Consulte também as tags --host_features
:changes_inputs
,affects_outputs
--[no]force_pic
padrão: "false"-
Se ativado, todas as compilações C++ vão produzir código independente de posição ("-fPIC"), os links vão preferir bibliotecas pré-criadas PIC em vez de bibliotecas não-PIC, e os links vão produzir executáveis independentes de posição ("-pie").
Tags:loading_and_analysis
,affects_outputs
- Vários usos de
--host_action_env=<a 'name=value' assignment with an optional value part>
são acumulados -
Especifica o conjunto de variáveis de ambiente disponível para ações com configurações de execução. As variáveis podem ser especificadas por nome, caso em que o valor será retirado do ambiente de invocação, ou pelo par name=value, que define o valor independente do ambiente de invocação. Essa opção pode ser usada várias vezes. Para opções fornecidas para a mesma variável, as mais recentes vencem, e as opções para variáveis diferentes são acumuladas.
Tags:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
padrão: "opt"-
Especifica o modo em que as ferramentas usadas durante o build serão integradas. Valores: "fastbuild", "dbg", "opt".
Tags:affects_outputs
,action_command_lines
- Vários usos de
--host_conlyopt=<a string>
são acumulados -
Opção adicional para transmitir ao compilador C ao compilar arquivos-fonte C (mas não C++) nas configurações de execução.
Tags:action_command_lines
,affects_outputs
- Vários usos de
--host_copt=<a string>
são acumulados -
Opções adicionais para transmitir ao compilador C para ferramentas criadas nas configurações de execução.
Tags:action_command_lines
,affects_outputs
--host_cpu=<a string>
padrão: ""-
A CPU host.
Tags:changes_inputs
,affects_outputs
- Vários usos de
--host_cxxopt=<a string>
são acumulados -
Opções adicionais para transmitir ao compilador C++ para ferramentas criadas nas configurações de execução.
Tags:action_command_lines
,affects_outputs
- Vários usos de
--host_features=<a string>
são acumulados -
Os recursos especificados serão ativados ou desativados por padrão para os destinos criados na configuração de execução. Especificar -<feature> desativa o recurso. Os recursos negativos sempre substituem os positivos.
Tags:changes_inputs
,affects_outputs
--host_force_python=<PY2 or PY3>
padrão: consulte a descrição-
Substitui a versão do Python para a configuração de execução. Pode ser "PY2" ou "PY3".
Tags:loading_and_analysis
,affects_outputs
- Vários usos de
--host_linkopt=<a string>
são acumulados -
Opção adicional para transmitir ao vinculador ao vincular ferramentas nas configurações de execução.
Tags:action_command_lines
,affects_outputs
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
Versão mínima compatível do macOS para destinos do host. Se não for especificado, vai usar "macos_sdk_version".
Tags:loses_incremental_state
- Vários usos de
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
são acumulados -
Opções adicionais para transmitir seletivamente ao compilador C/C++ ao compilar determinados arquivos nas execuções de configuração. Essa opção pode ser transmitida várias vezes. Sintaxe: regex_filter@option_1,option_2,...,option_n. Em que regex_filter representa uma lista de padrões de expressão regular de inclusão e exclusão (consulte também --instrumentation_filter). option_1 a option_n representam opções arbitrárias de linha de comando. Se uma opção tiver uma vírgula, ela precisa ser colocada entre aspas com uma barra invertida. As opções podem conter @. Apenas o primeiro @ é usado para dividir a string. Exemplo: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 adiciona a opção de linha de comando -O0 à linha de comando do gcc de todos os arquivos cc em //foo/, exceto bar.cc.
Tags:action_command_lines
,affects_outputs
--[no]incompatible_auto_exec_groups
padrão: "false"-
Quando ativado, um grupo de execução é criado automaticamente para cada toolchain usado por uma regra. Para que isso funcione, a regra precisa especificar o parâmetro "toolchain" nas ações. Para mais informações, consulte https://github.com/bazelbuild/bazel/issues/17134.
Tags:affects_outputs
,incompatible_change
--[no]incompatible_merge_genfiles_directory
padrão: "true"-
Se verdadeiro, o diretório genfiles é dobrado no diretório bin.
Tags:affects_outputs
,incompatible_change
--[no]instrument_test_targets
padrão: "false"-
Quando a cobertura está ativada, especifica se é necessário considerar a instrumentação de regras de teste. Quando definido, as regras de teste incluídas por --instrumentation_filter são inspecionadas. Caso contrário, as regras de teste são sempre excluídas da instrumentação de cobertura.
Tags:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
padrão: "-/javatests[/:],-/test/java[/:]"-
Quando a cobertura está ativada, apenas as regras com nomes incluídos pelo filtro baseado em regex especificado são instrumentadas. As regras com o prefixo "-" são excluídas. Somente as regras que não são de teste são instrumentadas, a menos que --instrument_test_targets esteja ativado.
Tags:affects_outputs
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
Versão mínima compatível do iOS para simuladores e dispositivos de destino. Se não for especificado, vai usar "ios_sdk_version".
Tags:loses_incremental_state
- Vários usos de
--ios_multi_cpus=<comma-separated list of options>
são acumulados -
Lista separada por vírgulas de arquiteturas para criar um ios_application. O resultado é um binário universal que contém todas as arquiteturas especificadas.
Tags:loses_incremental_state
,loading_and_analysis
--[no]legacy_whole_archive
padrão: "true"-
Descontinuado, substituído por --incompatible_remove_legacy_whole_archive (consulte https://github.com/bazelbuild/bazel/issues/7362 para saber mais). Quando ativado, use --whole-archive para regras cc_binary que tenham linkshared=True e linkstatic=True ou '-static' em linkopts. Isso é apenas para compatibilidade com versões anteriores. Uma alternativa melhor é usar alwayslink=1 quando necessário.
Tags:action_command_lines
,affects_outputs
,deprecated
- Vários usos de
--linkopt=<a string>
são acumulados -
Opção adicional para transmitir ao gcc ao vincular.
Tags:action_command_lines
,affects_outputs
- Vários usos de
--ltobackendopt=<a string>
são acumulados -
Opção extra para passar para a etapa de back-end de LTO (em --features=thin_lto).
Tags:action_command_lines
,affects_outputs
- Vários usos de
--ltoindexopt=<a string>
são acumulados -
Opção extra para passar para a etapa de indexação de LTO (em --features=thin_lto).
Tags:action_command_lines
,affects_outputs
- Vários usos de
--macos_cpus=<comma-separated list of options>
são acumulados -
Lista separada por vírgulas de arquiteturas para as quais criar binários do Apple macOS.
Tags:loses_incremental_state
,loading_and_analysis
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
Versão mínima do macOS compatível para destinos. Se não for especificado, vai usar "macos_sdk_version".
Tags:loses_incremental_state
--memprof_profile=<a build target label>
padrão: consulte a descrição-
Use o perfil do memprof.
Tags:affects_outputs
--[no]objc_debug_with_GLIBCXX
padrão: "false"-
Se definido e o modo de compilação estiver definido como "dbg", defina GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC e GLIBCPP_CONCEPT_CHECKS.
Tags de
:action_command_lines
--[no]objc_enable_binary_stripping
padrão: "false"-
Define se o símbolo e o código morto serão removidos em binários vinculados. A remoção de binários será realizada se essa flag e --compilation_mode=opt forem especificados.
Tags:action_command_lines
- Vários usos de
--objccopt=<a string>
são acumulados -
Opções adicionais para transmitir ao gcc ao compilar arquivos de origem Objective-C/C++.
Tags:action_command_lines
- Vários usos de
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
são acumulados -
Opções adicionais para transmitir seletivamente ao gcc ao compilar determinados arquivos. Essa opção pode ser transmitida várias vezes. Sintaxe: regex_filter@option_1,option_2,...,option_n. Em que regex_filter representa uma lista de padrões de expressão regular de inclusão e exclusão (consulte também --instrumentation_filter). option_1 a option_n representam opções arbitrárias de linha de comando. Se uma opção tiver uma vírgula, ela precisa ser colocada entre aspas com uma barra invertida. As opções podem conter @. Apenas o primeiro @ é usado para dividir a string. Exemplo: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 adiciona a opção de linha de comando -O0 à linha de comando do gcc de todos os arquivos cc em //foo/, exceto bar.cc.
Tags:action_command_lines
,affects_outputs
- Vários usos de
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
são acumulados -
Opções adicionais para transmitir seletivamente para o back-end LTO (em --features=thin_lto) ao compilar determinados objetos de back-end. Essa opção pode ser transmitida várias vezes. Sintaxe: regex_filter@option_1,option_2,...,option_n. Em que regex_filter representa uma lista de padrões de expressão regular de inclusão e exclusão. option_1 a option_n representam opções arbitrárias de linha de comando. Se uma opção tiver uma vírgula, ela precisa ser colocada entre aspas com uma barra invertida. As opções podem conter @. Apenas o primeiro @ é usado para dividir a string. Exemplo: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 adiciona a opção de linha de comando -O0 à linha de comando do back-end de LTO de todos os arquivos em //foo/, exceto bar.o.
Tags:action_command_lines
,affects_outputs
--platform_suffix=<a string>
padrão: consulte a descrição-
Especifica um sufixo a ser adicionado ao diretório de configuração.
Tags:loses_incremental_state
,affects_outputs
,loading_and_analysis
--propeller_optimize=<a build target label>
padrão: consulte a descrição-
Use as informações do perfil do Propeller para otimizar o destino do build.Um perfil do Propeller precisa consistir em pelo menos um dos dois arquivos, um perfil cc e um perfil ld. Essa flag aceita um rótulo de build que precisa se referir aos arquivos de entrada do perfil do Propeller. Por exemplo, o arquivo BUILD que define o rótulo, em a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)Uma diretiva exports_files pode precisar ser adicionada ao pacote correspondente para que esses arquivos fiquem visíveis para o Bazel. A opção precisa ser usada como: --propeller_optimize=//a/b:propeller_profile
Tags:action_command_lines
,affects_outputs
--propeller_optimize_absolute_cc_profile=<a string>
padrão: consulte a descrição-
Nome do caminho absoluto do arquivo cc_profile para builds otimizados do Propeller.
Tags:affects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
padrão: consulte a descrição-
Nome de caminho absoluto do arquivo ld_profile para builds otimizados do Propeller.
Tags:affects_outputs
--run_under=<a prefix in front of command>
padrão: consulte a descrição-
Prefixo a ser inserido antes dos executáveis para os comandos "test" e "run". Se o valor for "foo -bar" e a linha de comando de execução for "test_binary -baz", a linha de comando final será "foo -bar test_binary -baz".Isso também pode ser um rótulo para um destino executável. Alguns exemplos são: "valgrind", "strace", "strace -c", "valgrind --quiet --num-callers=20", "//package:target", "//package:target --options".
Tags:action_command_lines
-
Se verdadeiro, as bibliotecas nativas que contêm funcionalidades idênticas serão compartilhadas entre diferentes destinos
Tags:loading_and_analysis
,affects_outputs
--[no]stamp
padrão: "false"-
Carimbo de dados binários com a data, o nome de usuário, o nome do host, as informações do espaço de trabalho etc.
Tags:affects_outputs
--strip=<always, sometimes or never>
padrão: "às vezes"-
Especifica se os binários e as bibliotecas compartilhadas serão removidos (usando "-Wl,--strip-debug"). O valor padrão de 'sometimes' significa remover iff --compilation_mode=fastbuild.
Tags:affects_outputs
- Vários usos de
--stripopt=<a string>
são acumulados -
Opções adicionais para transmitir a remoção ao gerar um binário '<name>.stripped'.
Tags:action_command_lines
,affects_outputs
- Vários usos de
--tvos_cpus=<comma-separated list of options>
são acumulados -
Lista separada por vírgulas de arquiteturas para as quais criar binários do Apple tvOS.
Tags:loses_incremental_state
,loading_and_analysis
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
Versão mínima compatível do tvOS para simuladores e dispositivos de destino. Se não for especificado, vai usar "tvos_sdk_version".
Tags:loses_incremental_state
- Vários usos de
--visionos_cpus=<comma-separated list of options>
são acumulados -
Lista separada por vírgulas de arquiteturas para as quais criar binários do Apple VisionOS.
Tags:loses_incremental_state
,loading_and_analysis
- Vários usos de
--watchos_cpus=<comma-separated list of options>
são acumulados -
Lista separada por vírgulas de arquiteturas para as quais criar binários do Apple watchOS.
Tags:loses_incremental_state
,loading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
Versão mínima do watchOS compatível para simuladores e dispositivos de destino. Se não for especificado, será usado "watchos_sdk_version".
Tags:loses_incremental_state
--xbinary_fdo=<a build target label>
padrão: consulte a descrição-
Use informações de perfil XbinaryFDO para otimizar a compilação. Especifica o nome do perfil de binário cruzado padrão. Quando a opção é usada com --fdo_instrument/--fdo_optimize/--fdo_profile, essas opções sempre prevalecem como se xbinary_fdo nunca fosse especificado.
Tags:affects_outputs
- Opções que afetam a forma como o Bazel aplica estritamente as entradas de build válidas (definições de regras, combinações de sinalizações etc.):
--[no]check_licenses
padrão: "false"-
Verifique se as restrições de licenciamento impostas por pacotes dependentes não entram em conflito com os modos de distribuição das metas que estão sendo criadas. Por padrão, as licenças não são verificadas.
Tags:build_file_semantics
--[no]check_visibility
padrão: "true"-
Se desativado, os erros de visibilidade em dependências de destino são rebaixados para avisos.
Tags:build_file_semantics
--[no]desugar_for_android
padrão: "true"-
Define se o bytecode Java 8 será simplificado antes da desindexação.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]desugar_java8_libs
padrão: "false"-
Define se as bibliotecas Java 8 com suporte vão ser incluídas em apps para dispositivos legados.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]enforce_constraints
padrão: "true"-
Verifica os ambientes com que cada destino é compatível e informa erros se algum destino tiver dependências que não oferecem suporte aos mesmos ambientes
Tags:build_file_semantics
--[no]experimental_check_desugar_deps
padrão: "true"-
Define se a dessugarização correta precisa ser verificada novamente no nível binário do Android.
Tags:eagerness_to_exit
,loading_and_analysis
,experimental
--experimental_import_deps_checking=<a string>
padrão: consulte a descrição-
Não tem operação, mantido apenas para compatibilidade com versões anteriores
Tags:loading_and_analysis
--experimental_one_version_enforcement=<off, warning or error>
padrão: "OFF"-
Quando ativada, essa regra garante que uma regra java_binary não possa conter mais de uma versão do mesmo arquivo de classe no classpath. Essa aplicação pode interromper o build ou apenas resultar em avisos.
Tags:loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
padrão: "default"-
Se verdadeiro, verifica se um destino Java declara explicitamente todos os destinos usados diretamente como dependências.
Tags:build_file_semantics
,eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files
padrão: "false"-
Se ativado, verifique se há destinos de pré-requisito que são arquivos de saída procurando o testonly da regra de geração. Isso corresponde à verificação de visibilidade.
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_check_visibility_for_toolchains
padrão: "false"-
Se ativada, a verificação de visibilidade também se aplica às implementações de cadeia de ferramentas.
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_disable_native_android_rules
padrão: "false"-
Se ativado, o uso direto das regras nativas do Android será desativado. Use as regras do Starlark Android em https://github.com/bazelbuild/rules_android
Tags:eagerness_to_exit
,incompatible_change
--[no]incompatible_disable_native_apple_binary_rule
padrão: "false"-
Não há operação. Mantido aqui para compatibilidade com versões anteriores.
Tags:eagerness_to_exit
,incompatible_change
--[no]incompatible_python_disable_py2
padrão: "true"-
Se verdadeiro, o uso das configurações do Python 2 vai causar um erro. Isso inclui python_version=PY2, srcs_version=PY2 e srcs_version=PY2ONLY. Consulte https://github.com/bazelbuild/bazel/issues/15684 para mais informações.
Tags:loading_and_analysis
,incompatible_change
--[no]one_version_enforcement_on_java_tests
padrão: "true"-
Quando ativado e com experimental_one_version_enforcement definido como um valor diferente de NONE, aplique uma versão aos destinos de java_test. Essa flag pode ser desativada para melhorar o desempenho do teste incremental em detrimento de possíveis violações de uma versão.
Tags:loading_and_analysis
--python_native_rules_allowlist=<a build target label>
padrão: consulte a descrição-
Uma lista de permissões (alvo package_group) a ser usada ao aplicar --incompatible_python_disallow_native_rules.
Tags:loading_and_analysis
--[no]strict_filesets
padrão: "false"-
Se essa opção estiver ativada, os conjuntos de arquivos que cruzarem os limites do pacote serão informados como erros.
Tags:build_file_semantics
,eagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default>
padrão: "error"-
A menos que esteja DESLIGADO, verifica se um destino proto_library declara explicitamente todos os destinos usados diretamente como dependências.
Tags:build_file_semantics
,eagerness_to_exit
,incompatible_change
--strict_public_imports=<off, warn, error, strict or default>
padrão: "desativado"-
A menos que esteja DESATIVADO, verifica se um destino proto_library declara explicitamente todos os destinos usados em "import public" como exportados.
Tags:build_file_semantics
,eagerness_to_exit
,incompatible_change
--[no]strict_system_includes
padrão: "false"-
Se verdadeiro, os cabeçalhos encontrados nos caminhos de inclusão do sistema (-isystem) também precisam ser declarados.
Tags:loading_and_analysis
,eagerness_to_exit
- Vários usos de
--target_environment=<a build target label>
são acumulados -
Declara o ambiente de destino desse build. Precisa ser uma referência de rótulo para uma regra de "ambiente". Se especificado, todos os destinos de nível superior precisam ser compatíveis com esse ambiente.
Tags:changes_inputs
- Opções que afetam as saídas de assinatura de um build:
--apk_signing_method=<v1, v2, v1_v2 or v4>
padrão: "v1_v2"-
Implementação a ser usada para assinar APKs
Tags:action_command_lines
,affects_outputs
,loading_and_analysis
--[no]device_debug_entitlements
padrão: "true"-
Se definido e o modo de compilação não for "opt", os apps objc vão incluir direitos de depuração ao assinar.
Tags:changes_inputs
--ios_signing_cert_name=<a string>
padrão: consulte a descrição-
Nome do certificado a ser usado para assinatura do iOS. Se não for definido, o perfil de provisionamento será usado. Pode ser a preferência de identidade do chaveiro do certificado ou (substring) do nome comum do certificado, conforme a página de manual de codesign (IDENTIDADES DE ASSINATURA).
Tags:action_command_lines
- Essa opção afeta a semântica da linguagem Starlark ou a API de build acessível a arquivos BUILD, .bzl ou WORKSPACE.:
--[no]incompatible_disallow_legacy_py_provider
padrão: "true"-
Não é uma operação, será removido em breve.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_sdk_frameworks_attributes
padrão: "false"-
Se verdadeiro, não permita os atributos sdk_frameworks e weak_sdk_frameworks em objc_library e objc_import.
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_objc_alwayslink_by_default
padrão: "false"-
Se verdadeiro, defina o valor padrão como verdadeiro para os atributos alwayslink em objc_library e objc_import.
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_python_disallow_native_rules
padrão: "false"-
Quando verdadeiro, um erro ocorre ao usar as regras py_* integradas. Em vez disso, as regras rule_python precisam ser usadas. Consulte https://github.com/bazelbuild/bazel/issues/17773 para mais informações e instruções de migração.
Tags:loading_and_analysis
,incompatible_change
- Opções que governam o comportamento do ambiente de teste ou do executor de teste:
--[no]allow_analysis_failures
padrão: "false"-
Se verdadeiro, uma falha de análise de um destino de regra resulta na propagação do destino de uma instância de AnalysisFailureInfo contendo a descrição do erro, em vez de resultar em uma falha de build.
Tags:loading_and_analysis
,experimental
--analysis_testing_deps_limit=<an integer>
padrão: "2000"-
Define o número máximo de dependências transitivas usando um atributo de regra com uma transição de configuração for_analysis_testing. Exceder esse limite vai resultar em um erro de regra.
Tags:loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure
padrão: "false"-
Se verdadeiro, as falhas de ação dex2oat vão causar a interrupção do build em vez de executar dex2oat durante o tempo de execução do teste.
Tags:loading_and_analysis
,experimental
- Vários usos de
--default_test_resources=<a resource name followed by equal and 1 float or 4 float, e.g memory=10,30,60,100>
são acumulados - Substitua a quantidade de recursos padrão para testes. O formato esperado é <resource>=<value>. Se um único número positivo for especificado como <value>, ele vai substituir os recursos padrão para todos os tamanhos de teste. Se quatro números separados por vírgula forem especificados, eles vão substituir a quantidade de recursos para os tamanhos de teste pequeno, médio, grande e enorme, respectivamente. Os valores também podem ser HOST_RAM/HOST_CPU, seguidos opcionalmente por [-|*]<float> (por exemplo, memory=HOST_RAM*.1,HOST_RAM*.2,HOST_RAM*.3,HOST_RAM*.4). Os recursos de teste padrão especificados por essa flag são substituídos por recursos explícitos especificados em tags.
--[no]experimental_android_use_parallel_dex2oat
padrão: "false"-
Use dex2oat em paralelo para acelerar o android_test.
Tags:loading_and_analysis
,host_machine_resource_optimizations
,experimental
--[no]ios_memleaks
padrão: "false"-
Ativa a verificação de vazamentos de memória em destinos ios_test.
Tags:action_command_lines
--ios_simulator_device=<a string>
padrão: consulte a descrição-
O dispositivo a ser simulado ao executar um aplicativo iOS no simulador, por exemplo, "iPhone 6". Para conferir uma lista de dispositivos, execute "xcrun simctl list devicetypes" na máquina em que o simulador será executado.
Tags:test_runner
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
padrão: consulte a descrição-
A versão do iOS a ser executada no simulador durante a execução ou o teste. Isso será ignorado para regras ios_test se um dispositivo de destino for especificado na regra.
Tags:test_runner
- Vários usos de
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
são acumulados - Especifica o número de vezes que cada teste será executado. Se uma dessas tentativas falhar por qualquer motivo, o teste inteiro será considerado reprovado. Normalmente, o valor especificado é apenas um número inteiro. Exemplo: --runs_per_test=3 vai executar todos os testes três vezes. Sintaxe alternativa: regex_filter@runs_per_test. Em que runs_per_test representa um valor inteiro e regex_filter representa uma lista de padrões de expressão regular de inclusão e exclusão. Consulte também --instrumentation_filter. Exemplo: --runs_per_test=//foo/.*,-//foo/bar/.*@3 executa todos os testes em //foo/, exceto aqueles em foo/bar três vezes. Essa opção pode ser transmitida várias vezes. O argumento mais recente transmitido que corresponde tem precedência. Se nada corresponder, o teste será executado apenas uma vez.
- Vários usos de
--test_env=<a 'name=value' assignment with an optional value part>
são acumulados -
Especifica variáveis de ambiente adicionais a serem injetadas no ambiente do executor de testes. As variáveis podem ser especificadas por nome, e nesse caso o valor delas será lido no ambiente do cliente do Bazel, ou pelo par nome=valor. Essa opção pode ser usada várias vezes para especificar várias variáveis. Usado apenas pelo comando "bazel test".
Tags:test_runner
--test_timeout=<a single integer or comma-separated list of 4 integers>
padrão: "-1"- Substitua os valores padrão de tempo limite de teste (em segundos). Se um único valor inteiro positivo for especificado, ele vai substituir todas as categorias. Se quatro números inteiros separados por vírgulas forem especificados, eles vão substituir os tempos limite para curto, moderado, longo e eterno (nessa ordem). Em qualquer forma, um valor de -1 instrui o Blaze a usar os tempos limite padrão para essa categoria.
--[no]zip_undeclared_test_outputs
padrão: "false"-
Se verdadeiro, as saídas de teste não declaradas serão arquivadas em um arquivo ZIP.
Tags:test_runner
- Opções que acionam otimizações do tempo de build:
--[no]experimental_filter_library_jar_with_program_jar
padrão: "false"-
Filtre o ProgramJar do ProGuard para remover todas as classes também presentes no LibraryJar.
Tags:action_command_lines
,experimental
--[no]experimental_inmemory_dotd_files
padrão: "true"-
Se ativada, os arquivos .d do C++ serão transmitidos na memória diretamente dos nós de build remotos em vez de serem gravados no disco.
Tags:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_inmemory_jdeps_files
padrão: "true"-
Se ativado, os arquivos de dependência (.jdeps) gerados a partir de compilações Java serão transmitidos na memória diretamente dos nós de build remotos em vez de serem gravados no disco.
Tags:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_retain_test_configuration_across_testonly
padrão: "false"-
Quando ativado, o --trim_test_configuration não vai cortar a configuração de teste para regras marcadas como testonly=1. Isso reduz os problemas de conflito de ação quando regras que não são de teste dependem de regras cc_test. Não tem efeito se --trim_test_configuration for falso.
Tags:loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_starlark_cc_import
padrão: "false"-
Se ativada, a versão do Starlark de cc_import poderá ser usada.
Tags:loading_and_analysis
,experimental
--[no]experimental_unsupported_and_brittle_include_scanning
padrão: "false"-
Define se as entradas serão restritas à compilação em C/C++ com a análise de linhas #include dos arquivos de entrada. Isso pode melhorar a performance e a incrementalidade, diminuindo o tamanho das árvores de entrada de compilação. No entanto, ele também pode interromper builds porque o scanner de inclusão não implementa totalmente a semântica do pré-processador C. Especificamente, ele não entende diretivas #include dinâmicas e ignora a lógica condicional do pré-processador. Use por sua conta e risco. Todos os problemas relacionados a essa sinalização serão encerrados.
Tags:loading_and_analysis
,execution
,changes_inputs
,experimental
--[no]incremental_dexing
padrão: "true"-
Realiza a maior parte do trabalho de desindexação separadamente para cada arquivo JAR.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]objc_use_dotd_pruning
padrão: "true"-
Se definido, os arquivos .d emitidos pelo clang serão usados para podar o conjunto de entradas transmitidas para as compilações objc.
Tags:changes_inputs
,loading_and_analysis
--[no]process_headers_in_dependencies
padrão: "false"-
Ao criar um destino //a:a, processe os cabeçalhos em todos os destinos de que //a:a depende (se o processamento de cabeçalhos estiver ativado para o conjunto de ferramentas).
Tags:execution
--[no]trim_test_configuration
padrão: "true"-
Quando ativada, as opções relacionadas ao teste são limpas abaixo do nível superior do build. Quando essa flag está ativa, os testes não podem ser criados como dependências de regras que não são de teste, mas as mudanças nas opções relacionadas ao teste não fazem com que as regras que não são de teste sejam analisadas novamente.
Tags
:loading_and_analysis
,loses_incremental_state
- Opções que afetam o nível de detalhamento, o formato ou o local de geração de registros:
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
padrão: "-.*"-
Mostra informações de depuração durante a resolução da cadeia de ferramentas. A flag usa uma regex, que é verificada em relação aos tipos de conjunto de ferramentas e destinos específicos para saber quais depurar. Vários regexes podem ser separados por vírgulas, e cada regex é verificado separadamente. Observação: a saída dessa flag é muito complexa e provavelmente só será útil para especialistas em resolução de cadeias de ferramentas.
Tags:terminal_output
- Opções que especificam ou alteram uma entrada genérica para um comando do Bazel que não se enquadra em outras categorias.:
- Vários usos de
--flag_alias=<a 'name=value' flag alias>
são acumulados -
Define um nome abreviado para uma flag do Starlark. Ele usa um único par de chave-valor no formato "<chave>=<valor>" como argumento.
Tags:changes_inputs
--[no]incompatible_default_to_explicit_init_py
padrão: "false"-
Essa flag muda o comportamento padrão para que os arquivos __init__.py não sejam mais criados automaticamente nos runfiles de destinos do Python. Mais precisamente, quando um destino py_binary ou py_test tem legacy_create_init definido como "auto" (padrão), ele é tratado como falso se e somente se essa flag estiver definida. Consulte https://github.com/bazelbuild/bazel/issues/10076.
Tags:affects_outputs
,incompatible_change
--[no]incompatible_py2_outputs_are_suffixed
padrão: "true"-
Se verdadeiro, os destinos criados na configuração do Python 2 vão aparecer em uma raiz de saída que inclui o sufixo "-py2", enquanto os destinos criados para o Python 3 vão aparecer em uma raiz sem sufixo relacionado ao Python. Isso significa que o link simbólico de conveniência "bazel-bin" vai apontar para destinos do Python 3 em vez do Python 2. Se você ativar essa opção, também será recomendável ativar `--incompatible_py3_is_default`.
Tags:affects_outputs
,incompatible_change
--[no]incompatible_py3_is_default
padrão: "true"-
Se verdadeiro, os destinos "py_binary" e "py_test" que não definem o atributo "python_version" (ou "default_python_version") vão assumir o valor padrão PY3 em vez de PY2. Se você definir essa flag, também será recomendável definir `--incompatible_py2_outputs_are_suffixed`.
Tags
:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_use_python_toolchains
padrão: "true"-
Se definido como "true", as regras executáveis nativas do Python vão usar o ambiente de execução especificado pelo conjunto de ferramentas do Python, em vez do ambiente de execução fornecido por flags legadas, como --python_top.
Tags:loading_and_analysis
,incompatible_change
--python_version=<PY2 or PY3>
padrão: consulte a descrição-
O modo de versão principal do Python, "PY2" ou "PY3". Essa flag é substituída por "py_binary" e "py_test" (mesmo que não especifiquem explicitamente uma versão). Portanto, geralmente não há motivos para fornecer essa flag.
Tags:loading_and_analysis
,affects_outputs
- Opções diversas, não categorizadas.:
--[no]cache_test_results
[-t
] padrão: "auto"- Se definido como "auto", o Bazel vai executar novamente um teste somente se: (1) o Bazel detectar mudanças no teste ou nas dependências dele, (2) o teste estiver marcado como externo, (3) várias execuções de teste tiverem sido solicitadas com --runs_per_test ou(4) o teste tiver falhado anteriormente. Se definido como "sim", o Bazel armazena em cache todos os resultados de teste, exceto os marcados como externos. Se definido como "no", o Bazel não armazena em cache nenhum resultado de teste.
--[no]experimental_cancel_concurrent_tests
padrão: "false"-
Se verdadeiro, o Blaze vai cancelar os testes em execução simultaneamente na primeira execução bem-sucedida. Isso só é útil em combinação com --runs_per_test_detects_flakes.
Tags:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_fetch_all_coverage_outputs
padrão: "false"-
Se verdadeiro, o Bazel busca o diretório de dados de cobertura inteiro para cada teste durante uma execução de cobertura.
Tags:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_generate_llvm_lcov
padrão: "false"-
Se verdadeiro, a cobertura do clang vai gerar um relatório LCOV.
Tags:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_j2objc_header_map
padrão: "true"-
Define se o mapa de cabeçalho J2ObjC será gerado em paralelo à transpilação J2ObjC.
Tags:experimental
--[no]experimental_j2objc_shorter_header_path
padrão: "false"-
Define se o caminho do cabeçalho será gerado com um caminho mais curto (usa "_ios" em vez de "_j2objc").
Tags:affects_outputs
,experimental
--experimental_java_classpath=<off, javabuilder or bazel>
padrão: "javabuilder"- Habilita caminhos de classe reduzidos para compilações Java.
--[no]experimental_limit_android_lint_to_android_constrained_java
padrão: "false"-
Não tem operação, mantido apenas para compatibilidade com versões anteriores
Tags:affects_outputs
,experimental
--[no]experimental_run_android_lint_on_java_rules
padrão: "false"-
Define se as fontes java_* precisam ser validadas.
Tags:affects_outputs
,experimental
--[no]explicit_java_test_deps
padrão: "false"- Especifique explicitamente uma dependência do JUnit ou do Hamcrest em um java_test em vez de acidentalmente extrair das dependências do TestRunner. No momento, só funciona com o Bazel.
--host_java_launcher=<a build target label>
padrão: consulte a descrição- O iniciador Java usado por ferramentas executadas durante um build.
- Vários usos de
--host_javacopt=<a string>
são acumulados - Opções adicionais para transmitir ao javac ao criar ferramentas que são executadas durante um build.
- Vários usos de
--host_jvmopt=<a string>
são acumulados - Opções adicionais para transmitir à VM Java ao criar ferramentas que são executadas durante o build. Essas opções serão adicionadas às opções de inicialização da VM de cada destino java_binary.
--[no]incompatible_check_sharding_support
padrão: "true"-
Se verdadeiro, o Bazel vai falhar em um teste fragmentado se o executor de teste não indicar que ele oferece suporte ao fragmentação tocando no arquivo no caminho em TEST_SHARD_STATUS_FILE. Se for falso, um executor de teste que não oferece suporte ao fragmentação vai fazer com que todos os testes sejam executados em cada fragmento.
Tags:incompatible_change
--[no]incompatible_exclusive_test_sandboxed
padrão: "true"-
Se verdadeiro, os testes exclusivos serão executados com a estratégia de sandbox. Adicionar a tag "local" para forçar a execução de um teste exclusivo localmente
Tags:incompatible_change
--[no]incompatible_strict_action_env
padrão: "false"-
Se verdadeiro, o Bazel usa um ambiente com um valor estático para PATH e não herda LD_LIBRARY_PATH. Use --action_env=ENV_VARIABLE se quiser herdar variáveis de ambiente específicas do cliente. No entanto, isso pode impedir o armazenamento em cache entre usuários se um cache compartilhado for usado.
Tags:loading_and_analysis
,incompatible_change
- Vários usos de
--j2objc_translation_flags=<comma-separated list of options>
são acumulados - Opções adicionais para transmitir à ferramenta J2ObjC.
--java_debug
-
Faz com que a máquina virtual Java de um teste Java aguarde uma conexão de um depurador compatível com JDWP (como o jdb) antes de iniciar o teste. Implica em -test_output=streamed.
É expandido para:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
--[no]java_deps
padrão: "true"- Gera informações de dependência (por enquanto, o classpath do tempo de compilação) por destino Java.
--[no]java_header_compilation
padrão: "true"- Compile ijars diretamente da fonte.
--java_language_version=<a string>
padrão: ""- A versão da linguagem Java
--java_launcher=<a build target label>
padrão: consulte a descrição- O iniciador Java a ser usado ao criar binários Java. Se essa flag for definida como a string vazia, o iniciador do JDK será usado. O atributo "launcher" substitui essa flag.
--java_runtime_version=<a string>
padrão: "local_jdk"- A versão do ambiente de execução Java
- Vários usos de
--javacopt=<a string>
são acumulados - Outras opções para transmitir ao javac.
- Vários usos de
--jvmopt=<a string>
são acumulados - Outras opções para transmitir à VM Java. Essas opções serão adicionadas às opções de inicialização da VM de cada destino java_binary.
--legacy_main_dex_list_generator=<a build target label>
padrão: consulte a descrição- Especifica um binário a ser usado para gerar a lista de classes que precisam estar no dex principal ao compilar o multidex legado.
--optimizing_dexer=<a build target label>
padrão: consulte a descrição- Especifica um binário a ser usado para fazer a dexação sem fragmentação.
- Vários usos de
--plugin=<a build target label>
são acumulados - Plug-ins para usar no build. Atualmente funciona com java_plugin.
--proguard_top=<a build target label>
padrão: consulte a descrição- Especifica qual versão do ProGuard usar para a remoção de código ao criar um binário Java.
--proto_compiler=<a build target label>
padrão: "@bazel_tools//tools/proto:protoc"-
O rótulo do protocompilador.
Tags:affects_outputs
,loading_and_analysis
--[no]proto_profile
padrão: "true"-
Define se o profile_path será transmitido para o compilador proto.
Tags:affects_outputs
,loading_and_analysis
--proto_profile_path=<a build target label>
padrão: consulte a descrição-
O perfil a ser transmitido ao compilador proto como profile_path. Se não for definido, mas --proto_profile for verdadeiro (padrão), o caminho será inferido de --fdo_optimize.
Tags:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
padrão: "@bazel_tools//tools/proto:cc_toolchain"-
Rótulo de proto_lang_toolchain() que descreve como compilar protos C++
Tags:affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
padrão: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"-
Rótulo de proto_lang_toolchain() que descreve como compilar protos j2objc
Tags:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
padrão: "@bazel_tools//tools/proto:java_toolchain"-
Rótulo de proto_lang_toolchain() que descreve como compilar protos Java
Tags:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
padrão: "@bazel_tools//tools/proto:javalite_toolchain"-
Rótulo de proto_lang_toolchain() que descreve como compilar protos JavaLite
Tags:affects_outputs
,loading_and_analysis
- Vários usos de
--protocopt=<a string>
são acumulados -
Opções adicionais para transmitir ao compilador protobuf.
Tags de
:affects_outputs
--[no]runs_per_test_detects_flakes
padrão: "false"- Se verdadeiro, qualquer fragmento em que pelo menos uma execução/tentativa é bem-sucedida e pelo menos uma falha recebe o status FLAKY.
--shell_executable=<a path>
padrão: consulte a descrição-
Caminho absoluto para o executável do shell que o Bazel vai usar. Se ela não estiver definida, mas a variável de ambiente BAZEL_SH estiver definida na primeira invocação do Bazel (que inicia um servidor do Bazel), o Bazel vai usar essa variável. Se nenhum deles estiver definido, o Bazel vai usar um caminho padrão codificado por hard-code dependendo do sistema operacional em que ele é executado (Windows: c:/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, todos os outros: /bin/bash). O uso de um shell que não é compatível com o bash pode levar a falhas de build ou de execução dos binários gerados.
Tags:loading_and_analysis
- Vários usos de
--test_arg=<a string>
são acumulados - Especifica opções e argumentos adicionais que precisam ser transmitidos para o executável de teste. Pode ser usado várias vezes para especificar vários argumentos. Se vários testes forem executados, cada um deles vai receber argumentos idênticos. Usado apenas pelo comando "bazel test".
--test_filter=<a string>
padrão: consulte a descrição- Especifica um filtro para encaminhar ao framework de teste. Usado para limitar a execução dos testes. Isso não afeta quais metas são criadas.
--test_result_expiration=<an integer>
padrão: "-1"- Esta opção foi descontinuada e não tem efeito.
--[no]test_runner_fail_fast
padrão: "false"- Encaminha a opção de falha rápida para o executor de teste. O executor de teste precisa interromper a execução na primeira falha.
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>
padrão: "explicit"- Especifique a estratégia para o fragmentação de teste: "explicit" para usar a fragmentação apenas se o atributo BUILD "shard_count" estiver presente. "desativado" para nunca usar a fragmentação de testes. "forced=k" para aplicar os fragmentos "k" para testes, independentemente do atributo BUILD "shard_count".
--tool_java_language_version=<a string>
padrão: ""- A versão da linguagem Java usada para executar as ferramentas necessárias durante um build
--tool_java_runtime_version=<a string>
padrão: "remotejdk_11"- A versão do ambiente de execução do Java usada para executar ferramentas durante o build
--[no]use_ijars
padrão: "true"- Se ativada, essa opção faz com que a compilação Java use jars de interface. Isso vai resultar em uma compilação incremental mais rápida, mas as mensagens de erro podem ser diferentes.
Opções de versão
- Opções que permitem ao usuário configurar a saída pretendida, afetando o valor, em vez de sua existência:
--[no]gnu_format
padrão: "false"-
Se definido, grava a versão no stdout usando as convenções descritas nos padrões GNU.
Tags:affects_outputs
,execution
- Essa opção afeta a semântica do idioma Starlark ou a API de build acessível a arquivos BUILD, .bzl ou WORKSPACE.:
--[no]incompatible_use_plus_in_repo_names
padrão: "true"-
No-op.
Tags:loading_and_analysis
Tags de efeito de opção
unknown |
Essa opção tem um efeito desconhecido ou não documentado. |
no_op |
Essa opção não tem efeito. |
loses_incremental_state |
Mudar o valor dessa opção pode causar uma perda significativa do estado incremental, o que retarda os builds. O estado pode ser perdido devido a uma reinicialização do servidor ou à invalidação de uma grande parte do gráfico de dependências. |
changes_inputs |
Essa opção muda ativamente as entradas que o Bazel considera para o build, como restrições do sistema de arquivos, versões do repositório ou outras opções. |
affects_outputs |
Essa opção afeta as saídas do Bazel. Essa tag é intencionalmente ampla, pode incluir efeitos transitivos e não especifica o tipo de saída que afeta. |
build_file_semantics |
Essa opção afeta a semântica dos arquivos BUILD ou .bzl. |
bazel_internal_configuration |
Essa opção afeta as configurações da maquinaria interna do Bazel. Essa tag não significa, por si só, que os artefatos de build são afetados. |
loading_and_analysis |
Essa opção afeta o carregamento e a análise de dependências e a criação do gráfico de dependências. |
execution |
Essa opção afeta a fase de execução, como opções relacionadas a sandbox ou execução remota. |
host_machine_resource_optimizations |
Essa opção aciona uma otimização que pode ser específica da máquina e não tem garantia de funcionar em todas as máquinas. A otimização pode incluir uma compensação com outros aspectos de desempenho, como custo de memória ou CPU. |
eagerness_to_exit |
Essa opção muda a rapidez com que o Bazel sai de uma falha, em que existe uma escolha entre continuar apesar da falha e encerrar a invocação. |
bazel_monitoring |
Essa opção é usada para monitorar o comportamento e o desempenho do Bazel. |
terminal_output |
Essa opção afeta a saída do terminal do Bazel. |
action_command_lines |
Essa opção muda os argumentos de linha de comando de uma ou mais ações de build. |
test_runner |
Essa opção muda o ambiente do test runner do build. |
Tags de metadados de opção
experimental |
Essa opção aciona um recurso experimental sem garantias de funcionalidade. |
incompatible_change |
Essa opção aciona uma mudança interruptiva. Use essa opção para testar se a migração está pronta ou para ter acesso antecipado ao novo recurso. |
deprecated |
O uso dessa opção foi suspenso. Talvez o recurso afetado tenha sido descontinuado ou talvez outro método de fornecimento de informações seja preferido. |
immutable |
Essa opção não pode ser alterada em uma transição. |